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