This commit was manufactured by cvs2svn to create branch 'SAMBA_3_0'.(This used to...
[jra/samba/.git] / docs / manpages / samba.7
index c87dd4b856fd800deba4a49497b72202b7020c21..0a64a78718b8b178590166b60aa8250e1fdcfdc4 100644 (file)
-.TH SAMBA 7 "09 Oct 1998" "samba 2.0.0-alpha11"
+.\" This manpage has been automatically generated by docbook2man 
+.\" from a DocBook document.  This tool can be found at:
+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "SAMBA" "7" "04 March 2003" "" ""
 .SH NAME
-Samba \- a LanManager like fileserver for UNIX
+SAMBA \- A Windows SMB/CIFS fileserver for UNIX
 .SH SYNOPSIS
-.B Samba
-.SH DESCRIPTION
-The
-.B Samba
-software suite is a collection of programs that implements the SMB
-protocol for UNIX systems. This protocol is sometimes also referred to
-as the LanManager or Netbios protocol.
-.SH COMPONENTS
-
-The Samba suite is made up of several components. Each component is
-described in a separate manual page. It is strongly recommended that
-you read the documentation that comes with Samba and the manual pages
-of those components that you use. If the manual pages aren't clear
-enough then please send me a patch!
-
-The
-.BR smbd (8)
-daemon provides the file and print services to SMB clients,
-such as Windows for Workgroups, Windows NT or LanManager. The
-configuration file for this daemon is described in
-.BR smb.conf (5).
-
-The
-.BR nmbd (8)
-daemon provides Netbios nameserving and browsing
-support. It can also be run interactively to query other name service
-daemons.
-
-The
-.BR smbclient (1)
-program implements a simple ftp-like client. This is
-useful for accessing SMB shares on other compatible servers (such as
-WfWg), and can also be used to allow a UNIX box to print to a printer
-attached to any SMB server (such as a PC running WfWg).
-
-The
-.BR testparm (1)
-utility allows you to test your
-.BR smb.conf (5)
-configuration file.
-
-The
-.BR smbstatus (1)
-utility allows you to tell who is currently using the
-.BR smbd (8)
-server.
-.SH AVAILABILITY
-
-The Samba software suite is licensed under the Gnu Public License. A
-copy of that license should have come with the package. You are
-encouraged to distribute copies of the Samba suite, but please keep it
-intact.
-
-The latest version of the Samba suite can be obtained via anonymous
-ftp from samba.anu.edu.au in the directory pub/samba/. It is
-also available on several mirror sites worldwide.
-
-You may also find useful information about Samba on the newsgroup
-comp.protocols.smb and the Samba mailing list. Details on how to join
-the mailing list are given in the README file that comes with Samba.
-
-If you have access to a WWW viewer (such as Netscape or Mosaic) then
-you will also find lots of useful information, including back issues
-of the Samba mailing list, at http://samba.anu.edu.au/samba/
-.SH AUTHOR
-
-The main author of the Samba suite is Andrew Tridgell. He may be
-contacted via e-mail at samba-bugs@samba.anu.edu.au.
-
-There have also been an enormous number of contributors to Samba from
-all over the world. A partial list of these contributors is included
-in the CREDITS section below. The list is, however, badly out of
-date. More up to date info may be obtained from the change-log that
-comes with the Samba source code.
-.SH CONTRIBUTIONS
-
-If you wish to contribute to the Samba project, then I suggest you
-join the Samba mailing list.
-
-If you have patches to submit or bugs to report then you may mail them
-directly to samba-bugs@samba.anu.edu.au. Note, however, that due to the
-enormous popularity of this package I may take some time to repond to
-mail. I prefer patches in "diff \-u" format.
-.SH CREDITS
-
-Contributors to the project are (in alphabetical order by email address):
-
-(NOTE: This list is very out of date)
-
- Adams, Graham
-       (gadams@ddrive.demon.co.uk)
- Allison, Jeremy
-       (jeremy@netcom.com)
- Andrus, Ross
-       (ross@augie.insci.com)
- Auer, Karl
-       (Karl.Auer@anu.edu.au)
- Bogstad, Bill
-       (bogstad@cs.jhu.edu)
- Boreham, Bryan
-       (Bryan@alex.com)
- Boreham, David
-       (davidb@ndl.co.uk)
- Butler, Michael
-       (imb@asstdc.scgt.oz.au)
- ???
-       (charlie@edina.demon.co.uk)
- Chua, Michael
-       (lpc@solomon.technet.sg)
- Cochran, Marc
-       (mcochran@wellfleet.com)
- Dey, Martin N
-       (mnd@netmgrs.co.uk)
- Errath, Maximilian
-       (errath@balu.kfunigraz.ac.at)
- Fisher, Lee
-       (leefi@microsoft.com)
- Foderaro, Sean
-       (jkf@frisky.Franz.COM)
- Greer, Brad
-       (brad@cac.washington.edu)
- Griffith, Michael A
-       (grif@cs.ucr.edu)
- Grosen, Mark
-       (MDGrosen@spectron.COM)
- ????
-       (gunjkoa@dep.sa.gov.au)
- Haapanen, Tom
-       (tomh@metrics.com)
- Hench, Mike
-       (hench@cae.uwm.edu)
- Horstman, Mark A
-       (mh2620@sarek.sbc.com)
- Hudson, Tim
-       (tim.hudson@gslmail.mincom.oz.au)
- Hulthen, Erik Magnus
-       (magnus@axiom.se)
- ???
-       (imb@asstdc.scgt.oz.au)
- Iversen, Per Steinar
-       (iversen@dsfys1.fi.uib.no)
- Kaara, Pasi
-       (ppk@atk.tpo.fi)
- Karman, Merik
-       (merik@blackadder.dsh.oz.au)
- Kiff, Martin
-       (mgk@newton.npl.co.uk)
- Kiick, Chris
-       (cjkiick@flinx.b11.ingr.com)
- Kukulies, Christoph
-       (kuku@acds.physik.rwth-aachen.de)
- ???
-       (lance@fox.com)
- Leighton, Luke
-       (lkcl@pires.co.uk)
- Lendecke, Volker
-       (lendecke@namu01.gwdg.de)
- ???
-       (lonnie@itg.ti.com)
- Mahoney, Paul Thomas
-       (ptm@xact1.xact.com)
- Mauelshagen, Heinz
-       (mauelsha@ez.da.telekom.de)
- Merrick, Barry G
-       (bgm@atml.co.uk)
- Mol, Marcel
-       (marcel@fanout.et.tudeflt.nl)
- ???
-       (njw@cpsg.com.au)
- ???
-       (noses@oink.rhein.de)
- Owens, John
-       (john@micros.com)
- Pierson, Jacques
-       (pierson@ketje.enet.dec.com)
- Powell, Mark
-       (mark@scot1.ucsalf.ac.uk)
- Reiz, Steven
-       (sreiz@aie.nl)
- Schlaeger, Joerg
-       (joergs@toppoint.de)
- S{rkel{, Vesa
-       (vesku@rankki.kcl.fi)
- Terpstra, John
-       (jht@aquasoft.com.au)
- Tridgell, Andrew
-       (samba-bugs@samba.anu.edu.au)
- Troyer, Dean
-       (troyer@saifr00.ateng.az.honeywell.com)
- Wakelin, Ross
-       (rossw@march.co.uk)
- Wessels, Stefan
-       (SWESSELS@dos-lan.cs.up.ac.za)
- Young, Ian A
-       (iay@threel.co.uk)
- van der Zwan, Paul
-       (paulzn@olivetti.nl)
 
+\fBSamba\fR
+
+.SH "DESCRIPTION"
+.PP
+The Samba software suite is a collection of programs 
+that implements the Server Message Block (commonly abbreviated 
+as SMB) protocol for UNIX systems. This protocol is sometimes 
+also referred to as the Common Internet File System (CIFS). For a
+more thorough description, see  http://www.ubiqx.org/cifs/ <URL:http://www.ubiqx.org/cifs/>. Samba also implements the NetBIOS
+protocol in nmbd.
+.TP
+\fBsmbd\fR
+The \fBsmbd \fR
+daemon provides the file and print services to 
+SMB clients, such as Windows 95/98, Windows NT, Windows 
+for Workgroups or LanManager. The configuration file 
+for this daemon is described in \fIsmb.conf\fR
+.TP
+\fBnmbd\fR
+The \fBnmbd\fR
+daemon provides NetBIOS nameservice and browsing
+support. The configuration file for this daemon 
+is described in \fIsmb.conf\fR
+.TP
+\fBsmbclient\fR
+The \fBsmbclient\fR
+program implements a simple ftp-like client. This 
+is useful for accessing SMB shares on other compatible
+servers (such as Windows NT), and can also be used 
+to allow a UNIX box to print to a printer attached to 
+any SMB server (such as a PC running Windows NT).
+.TP
+\fBtestparm\fR
+The \fBtestparm\fR
+utility is a simple syntax checker for Samba's
+\fIsmb.conf\fRconfiguration file.
+.TP
+\fBtestprns\fR
+The \fBtestprns\fR
+utility supports testing printer names defined 
+in your \fIprintcap\fR file used 
+by Samba.
+.TP
+\fBsmbstatus\fR
+The \fBsmbstatus\fR
+tool provides access to information about the 
+current connections to \fBsmbd\fR.
+.TP
+\fBnmblookup\fR
+The \fBnmblookup\fR
+tools allows NetBIOS name queries to be made 
+from a UNIX host.
+.TP
+\fBmake_smbcodepage\fR
+The \fBmake_smbcodepage\fR
+utility provides a means of creating SMB code page 
+definition files for your \fBsmbd\fR server.
+.TP
+\fBsmbpasswd\fR
+The \fBsmbpasswd\fR
+command is a tool for changing LanMan and Windows NT 
+password hashes on Samba and Windows NT servers.
+.SH "COMPONENTS"
+.PP
+The Samba suite is made up of several components. Each 
+component is described in a separate manual page. It is strongly 
+recommended that you read the documentation that comes with Samba 
+and the manual pages of those components that you use. If the 
+manual pages and documents aren't clear enough then please visit
+http://devel.samba.org <URL:http://devel.samba.org/>
+for information on how to file a bug report or submit a patch.
+.PP
+If you require help, visit the Samba webpage at
+http://www.samba.org/ <URL:http://samba.org/> and
+explore the many option available to you.
+.SH "AVAILABILITY"
+.PP
+The Samba software suite is licensed under the 
+GNU Public License(GPL). A copy of that license should 
+have come with the package in the file COPYING. You are 
+encouraged to distribute copies of the Samba suite, but 
+please obey the terms of this license.
+.PP
+The latest version of the Samba suite can be 
+obtained via anonymous ftp from samba.org in the
+directory pub/samba/. It is also available on several 
+mirror sites worldwide.
+.PP
+You may also find useful information about Samba 
+on the newsgroup  comp.protocol.smb <URL:news:comp.protocols.smb> and the Samba mailing 
+list. Details on how to join the mailing list are given in 
+the README file that comes with Samba.
+.PP
+If you have access to a WWW viewer (such as Netscape 
+or Mosaic) then you will also find lots of useful information, 
+including back issues of the Samba mailing list, at
+http://lists.samba.org <URL:http://lists.samba.org/>.
+.SH "VERSION"
+.PP
+This man page is correct for version 2.2 of the 
+Samba suite. 
+.SH "CONTRIBUTIONS"
+.PP
+If you wish to contribute to the Samba project, 
+then I suggest you join the Samba mailing list at 
+http://lists.samba.org <URL:http://lists.samba.org/>.
+.PP
+If you have patches to submit, visit
+http://devel.samba.org/ <URL:http://devel.samba.org/>
+for information on how to do it properly. We prefer patches in
+\fBdiff -u\fR format.
+.SH "CONTRIBUTORS"
+.PP
+Contributors to the project are now too numerous 
+to mention here but all deserve the thanks of all Samba 
+users. To see a full list, look at  ftp://samba.org/pub/samba/alpha/change-log <URL:ftp://samba.org/pub/samba/alpha/change-log>
+for the pre-CVS changes and at  ftp://samba.org/pub/samba/alpha/cvs.log <URL:ftp://samba.org/pub/samba/alpha/cvs.log>
+for the contributors to Samba post-CVS. CVS is the Open Source 
+source code control system used by the Samba Team to develop 
+Samba. The project would have been unmanageable without it.
+.PP
+In addition, several commercial organizations now help 
+fund the Samba Team with money and equipment. For details see 
+the Samba Web pages at  http://samba.org/samba/samba-thanks.html
+.SH "AUTHOR"
+.PP
+The original Samba software and related utilities 
+were created by Andrew Tridgell. Samba is now developed
+by the Samba Team as an Open Source project similar 
+to the way the Linux kernel is developed.
+.PP
+The original Samba man pages were written by Karl Auer. 
+The man page sources were converted to YODL format (another 
+excellent piece of Open Source software, available at
+ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0 
+release by Jeremy Allison.  The conversion to DocBook for 
+Samba 2.2 was done by Gerald Carter