merge from 2.2
[Samba/gbeck.git] / docs / htmldocs / samba.7.html
blob6fb9eac5784d0ff80e1c0c4bea2fbbc1959be7bb
1 <HTML
2 ><HEAD
3 ><TITLE
4 >samba</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
8 ><BODY
9 CLASS="REFENTRY"
10 BGCOLOR="#FFFFFF"
11 TEXT="#000000"
12 LINK="#0000FF"
13 VLINK="#840084"
14 ALINK="#0000FF"
15 ><H1
16 ><A
17 NAME="SAMBA"
18 >samba</A
19 ></H1
20 ><DIV
21 CLASS="REFNAMEDIV"
22 ><A
23 NAME="AEN5"
24 ></A
25 ><H2
26 >Name</H2
27 >SAMBA&nbsp;--&nbsp;A Windows SMB/CIFS fileserver for UNIX</DIV
28 ><DIV
29 CLASS="REFSYNOPSISDIV"
30 ><A
31 NAME="AEN8"
32 ></A
33 ><H2
34 >Synopsis</H2
35 ><P
36 ><B
37 CLASS="COMMAND"
38 >Samba</B
39 > </P
40 ></DIV
41 ><DIV
42 CLASS="REFSECT1"
43 ><A
44 NAME="AEN11"
45 ></A
46 ><H2
47 >DESCRIPTION</H2
48 ><P
49 >The Samba software suite is a collection of programs
50 that implements the Server Message Block (commonly abbreviated
51 as SMB) protocol for UNIX systems. This protocol is sometimes
52 also referred to as the Common Internet File System (CIFS),
53 LanManager or NetBIOS protocol.</P
54 ><P
55 ></P
56 ><DIV
57 CLASS="VARIABLELIST"
58 ><DL
59 ><DT
60 ><B
61 CLASS="COMMAND"
62 >smbd</B
63 ></DT
64 ><DD
65 ><P
66 >The <B
67 CLASS="COMMAND"
68 >smbd </B
70 daemon provides the file and print services to
71 SMB clients, such as Windows 95/98, Windows NT, Windows
72 for Workgroups or LanManager. The configuration file
73 for this daemon is described in <TT
74 CLASS="FILENAME"
75 >smb.conf</TT
77 </P
78 ></DD
79 ><DT
80 ><B
81 CLASS="COMMAND"
82 >nmbd</B
83 ></DT
84 ><DD
85 ><P
86 >The <B
87 CLASS="COMMAND"
88 >nmbd</B
90 daemon provides NetBIOS nameserving and browsing
91 support. The configuration file for this daemon
92 is described in <TT
93 CLASS="FILENAME"
94 >smb.conf</TT
95 ></P
96 ></DD
97 ><DT
98 ><B
99 CLASS="COMMAND"
100 >smbclient</B
101 ></DT
102 ><DD
104 >The <B
105 CLASS="COMMAND"
106 >smbclient</B
108 program implements a simple ftp-like client. This
109 is useful for accessing SMB shares on other compatible
110 servers (such as Windows NT), and can also be used
111 to allow a UNIX box to print to a printer attached to
112 any SMB server (such as a PC running Windows NT).</P
113 ></DD
114 ><DT
116 CLASS="COMMAND"
117 >testparm</B
118 ></DT
119 ><DD
121 >The <B
122 CLASS="COMMAND"
123 >testparm</B
125 utility is a simple syntax checker for Samba's
127 CLASS="FILENAME"
128 >smb.conf</TT
129 >configuration file.</P
130 ></DD
131 ><DT
133 CLASS="COMMAND"
134 >testprns</B
135 ></DT
136 ><DD
138 >The <B
139 CLASS="COMMAND"
140 >testprns</B
142 utility supports testing printer names defined
143 in your <TT
144 CLASS="FILENAME"
145 >printcap&#62;</TT
146 > file used
147 by Samba.</P
148 ></DD
149 ><DT
151 CLASS="COMMAND"
152 >smbstatus</B
153 ></DT
154 ><DD
156 >The <B
157 CLASS="COMMAND"
158 >smbstatus</B
160 tool provides access to information about the
161 current connections to <B
162 CLASS="COMMAND"
163 >smbd</B
164 >.</P
165 ></DD
166 ><DT
168 CLASS="COMMAND"
169 >nmblookup</B
170 ></DT
171 ><DD
173 >The <B
174 CLASS="COMMAND"
175 >nmblookup</B
177 tools allows NetBIOS name queries to be made
178 from a UNIX host.</P
179 ></DD
180 ><DT
182 CLASS="COMMAND"
183 >make_smbcodepage</B
184 ></DT
185 ><DD
187 >The <B
188 CLASS="COMMAND"
189 >make_smbcodepage</B
191 utility provides a means of creating SMB code page
192 definition files for your <B
193 CLASS="COMMAND"
194 >smbd</B
195 > server.</P
196 ></DD
197 ><DT
199 CLASS="COMMAND"
200 >smbpasswd</B
201 ></DT
202 ><DD
204 >The <B
205 CLASS="COMMAND"
206 >smbpasswd</B
208 command is a tool for changing LanMan and Windows NT
209 password hashes on Samba and Windows NT servers.</P
210 ></DD
211 ></DL
212 ></DIV
213 ></DIV
214 ><DIV
215 CLASS="REFSECT1"
217 NAME="AEN75"
218 ></A
219 ><H2
220 >COMPONENTS</H2
222 >The Samba suite is made up of several components. Each
223 component is described in a separate manual page. It is strongly
224 recommended that you read the documentation that comes with Samba
225 and the manual pages of those components that you use. If the
226 manual pages aren't clear enough then please send a patch or
227 bug report to <A
228 HREF="mailto:samba@samba.org"
229 TARGET="_top"
230 > samba@samba.org</A
231 ></P
232 ></DIV
233 ><DIV
234 CLASS="REFSECT1"
236 NAME="AEN79"
237 ></A
238 ><H2
239 >AVAILABILITY</H2
241 >The Samba software suite is licensed under the
242 GNU Public License(GPL). A copy of that license should
243 have come with the package in the file COPYING. You are
244 encouraged to distribute copies of the Samba suite, but
245 please obey the terms of this license.</P
247 >The latest version of the Samba suite can be
248 obtained via anonymous ftp from samba.org in the
249 directory pub/samba/. It is also available on several
250 mirror sites worldwide.</P
252 >You may also find useful information about Samba
253 on the newsgroup <A
254 HREF="news:comp.protocols.smb"
255 TARGET="_top"
256 > comp.protocol.smb</A
257 > and the Samba mailing
258 list. Details on how to join the mailing list are given in
259 the README file that comes with Samba.</P
261 >If you have access to a WWW viewer (such as Netscape
262 or Mosaic) then you will also find lots of useful information,
263 including back issues of the Samba mailing list, at
265 HREF="http://lists.samba.org/"
266 TARGET="_top"
267 >http://lists.samba.org</A
268 >.</P
269 ></DIV
270 ><DIV
271 CLASS="REFSECT1"
273 NAME="AEN87"
274 ></A
275 ><H2
276 >VERSION</H2
278 >This man page is correct for version 2.2 of the
279 Samba suite. </P
280 ></DIV
281 ><DIV
282 CLASS="REFSECT1"
284 NAME="AEN90"
285 ></A
286 ><H2
287 >CONTRIBUTIONS</H2
289 >If you wish to contribute to the Samba project,
290 then I suggest you join the Samba mailing list at
292 HREF="http://lists.samba.org/"
293 TARGET="_top"
294 >http://lists.samba.org</A
298 >If you have patches to submit or bugs to report
299 then you may mail them directly to samba-patches@samba.org.
300 Note, however, that due to the enormous popularity of this
301 package the Samba Team may take some time to respond to mail. We
302 prefer patches in <B
303 CLASS="COMMAND"
304 >diff -u</B
305 > format.</P
306 ></DIV
307 ><DIV
308 CLASS="REFSECT1"
310 NAME="AEN96"
311 ></A
312 ><H2
313 >CONTRIBUTORS</H2
315 >Contributors to the project are now too numerous
316 to mention here but all deserve the thanks of all Samba
317 users. To see a full list, look at <A
318 HREF="ftp://samba.org/pub/samba/alpha/change-log"
319 TARGET="_top"
320 > ftp://samba.org/pub/samba/alpha/change-log</A
322 for the pre-CVS changes and at <A
323 HREF="ftp://samba.org/pub/samba/alpha/cvs.log"
324 TARGET="_top"
325 > ftp://samba.org/pub/samba/alpha/cvs.log</A
327 for the contributors to Samba post-CVS. CVS is the Open Source
328 source code control system used by the Samba Team to develop
329 Samba. The project would have been unmanageable without it.</P
331 >In addition, several commercial organizations now help
332 fund the Samba Team with money and equipment. For details see
333 the Samba Web pages at <A
334 HREF="http://samba.org/samba/samba-thanks.html"
335 TARGET="_top"
336 > http://samba.org/samba/samba-thanks.html</A
337 >.</P
338 ></DIV
339 ><DIV
340 CLASS="REFSECT1"
342 NAME="AEN103"
343 ></A
344 ><H2
345 >AUTHOR</H2
347 >The original Samba software and related utilities
348 were created by Andrew Tridgell. Samba is now developed
349 by the Samba Team as an Open Source project similar
350 to the way the Linux kernel is developed.</P
352 >The original Samba man pages were written by Karl Auer.
353 The man page sources were converted to YODL format (another
354 excellent piece of Open Source software, available at
356 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
357 TARGET="_top"
358 > ftp://ftp.icce.rug.nl/pub/unix/</A
359 >) and updated for the Samba 2.0
360 release by Jeremy Allison. The conversion to DocBook for
361 Samba 2.2 was done by Gerald Carter</P
362 ></DIV
363 ></BODY
364 ></HTML