4c7d599baea4ed0b0fa0314f204650753931a6c5
[kai/samba.git] / docs / yodldocs / samba.7.yo
1 mailto(samba-bugs@samba.anu.edu.au)
2 manpage(Samba)(7)(23 Oct 1998)(Samba)()
3
4 label(NAME)
5 manpagename(Samba)(A Windows SMB/CIFS fileserver for UNIX)
6
7 label(SYNOPSIS)
8 manpagesynopsis()
9 bf(Samba)
10
11
12 label(DESCRIPTION)
13 manpagedescription()
14
15 The Samba software suite is a collection of programs that implements
16 the Server Message Block(commenly abbreviated as SMB) protocol for
17 UNIX systems. This protocol is sometimes also referred to as the
18 Common Internet File System (CIFS), LanManager or NetBIOS protocol.
19
20 label(COMPONENTS)
21 manpagesection(COMPONENTS)
22
23 The Samba suite is made up of several components. Each component is
24 described in a separate manual page. It is strongly recommended that
25 you read the documentation that comes with Samba and the manual pages
26 of those components that you use. If the manual pages aren't clear
27 enough then please send a patch to email(samba-bugs@samba.anu.edu.au).
28
29 startdit() 
30
31 dit(url(bf(smbd))(smbd.8.html)) nl() nl() The url(bf(smbd)
32 (8))(smbd.8.html) daemon provides the file and print services to SMB
33 clients, such as Windows 95/98, Windows NT, Windows for Workgroups or
34 LanManager. The configuration file for this daemon is described in
35 url(bf(smb.conf (5)))(smb.conf.5.html).
36
37 dit(url(bf(nmbd))(nmbd.8.html)) nl() nl() The url(bf(nmbd)
38 (8))(nmbd.8.html) daemon provides NetBIOS nameserving and browsing
39 support. The configuration file for this daemon is described in
40 url(bf(smb.conf (5)))(smb.conf.5.html).
41
42 dit(url(bf(smbclient))(smbclient.1.html)) nl() nl() The url(bf(smbclient)
43 (1))(smbclient.1.html) program implements a simple ftp-like
44 client. This is useful for accessing SMB shares on other compatible
45 servers (such as Windows NT), and can also be used to allow a UNIX box
46 to print to a printer attached to any SMB server (such as a PC running
47 Windows NT).
48
49 dit(url(bf(testparm))(testparm.1.html)) nl() nl() The url(bf(testparm
50 (1)))(testparm.1.html) utility allows you to test your url(bf(smb.conf
51 (5)))(smb.conf.5.html) configuration file.
52
53 dit(url(bf(testprns))(testprns.1.html)) nl() nl() the url(bf(testprns
54 (1)))(testprns.1.html) utility allows you to test the printers defined
55 in your printcap file.
56
57 dit(url(bf(smbstatus))(smbstatus.1.html)) nl() nl() The url(bf(smbstatus)
58 (1))(smbstatus.1.html) utility allows you to tell who is currently
59 using the url(bf(smbd (8)))(smbd.8.html) server.
60
61 dit(url(bf(nmblookup))(nmblookup.1.html)) nl() nl() the
62 url(bf(nmblookup (1)))(nmblookup.1.html) utility allows NetBIOS name
63 queries to be made from the UNIX machine.
64
65 dit(url(bf(make_smbcodepage))(make_smbcodepage.1.html)) nl() nl() The
66 url(bf(make_smbcodepage (1)))(make_smbcodepage.1.html) utility allows
67 you to create SMB code page definition files for your url(bf(smbd
68 (8)))(smbd.8.html) server.
69
70 dit(url(bf(smbpasswd))(smbpasswd.8.html)) nl() nl() The url(bf(smbpasswd
71 (8)))(smbpasswd.8.html) utility allows you to change SMB encrypted
72 passwords on Samba and Windows NT(tm) servers.
73
74 enddit()
75
76 label(AVAILABILITY)
77 manpagesection(AVAILABILITY)
78
79 The Samba software suite is licensed under the GNU Public License
80 (GPL). A copy of that license should have come with the package in the
81 file COPYING. You are encouraged to distribute copies of the Samba
82 suite, but please keep obey the terms of this license.
83
84 The latest version of the Samba suite can be obtained via anonymous
85 ftp from samba.anu.edu.au in the directory pub/samba/. It is
86 also available on several mirror sites worldwide.
87
88 You may also find useful information about Samba on the newsgroup
89 comp.protocols.smb and the Samba mailing list. Details on how to join
90 the mailing list are given in the README file that comes with Samba.
91
92 If you have access to a WWW viewer (such as Netscape or Mosaic) then
93 you will also find lots of useful information, including back issues
94 of the Samba mailing list, at
95 url(http://samba.anu.edu.au/samba/)(http://samba.anu.edu.au/samba/).
96
97 label(VERSION)
98 manpagesection(VERSION)
99
100 This man page is correct for version 2.0 of the Samba suite. 
101
102 label(CONTRIBUTIONS)
103 manpagesection(CONTRIBUTIONS)
104
105 If you wish to contribute to the Samba project, then I suggest you
106 join the Samba mailing list at email(samba@samba.anu.edu.au). See the
107 Web page at
108 url(http://samba.anu.edu.au/listproc)(http://samba.anu.edu.au/listproc)
109 for details on how to do this.
110
111 If you have patches to submit or bugs to report then you may mail them
112 directly to email(samba-bugs@samba.anu.edu.au). Note, however, that due to
113 the enormous popularity of this package the Samba Team may take some
114 time to repond to mail. We prefer patches in em(diff -u) format.
115
116 label(CREDITS)
117 manpagesection(CREDITS)
118
119 Contributors to the project are now too numerous to mention here but
120 all deserve the thanks of all Samba users. To see a full list, look at
121 url(ftp://samba.anu.edu.au/pub/samba/alpha/change-log)(ftp://samba.anu.edu.au/pub/samba/alpha/change-log)
122 for the pre-CVS changes and at
123 url(ftp://samba.anu.edu.au/pub/samba/alpha/cvs.log)(ftp://samba.anu.edu.au/pub/samba/alpha/cvs.log)
124 for the contributors to Samba post-CVS. CVS is the Open Source source
125 code control system used by the Samba Team to develop Samba. The
126 project would have been unmanageable without it.
127
128 In addition, several commercial organisations now help fund the Samba
129 Team with money and equipment. For details see the Samba Web pages at
130 url(http://samba.anu.edu.au/samba/samba-thanks.html)(http://samba.anu.edu.au/samba/samba-thanks.html).
131
132 label(AUTHOR)
133 manpageauthor()
134
135 The original Samba software and related utilities were created by
136 Andrew Tridgell email(samba-bugs@samba.anu.edu.au). Samba is now developed
137 by the Samba Team as an Open Source project similar to the way the
138 Linux kernel is developed.
139
140 The original Samba man pages were written by Karl Auer. The man page
141 sources were converted to YODL format (another excellent piece of Open
142 Source software, available at
143 url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
144 and updated for the Samba2.0 release by Jeremy Allison.
145 email(samba-bugs@samba.anu.edu.au).