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 "\fBrpcclient\fP"
  54 .br
  55 .br
  56 The \fBrpcclient\fP
  57 (1) program is a client that can \'talk\' to an
  58 SMB/CIFS MSRPC server\&.  Operations include things like managing a SAM
  59 Database (users, groups and aliases) in the same way as the Windows NT
  60 programs \fBUser Manager for Domains\fP and \fBServer Manager for Domains\fP;
  61 managing a remote registry in the same way as the Windows NT programs
  62 \fBREGEDT32\&.EXE\fP and \fBREGEDIT\&.EXE\fP; viewing a remote event log (same
  63 as \fBEVENTVWR\&.EXE\fP)\&.
  64 .IP
  65 .IP "\fBtestparm\fP"
  66 .br
  67 .br
  68 The \fBtestparm
  69 (1)\fP utility allows you to test your \fBsmb\&.conf
  70 (5)\fP configuration file\&.
  71 .IP
  72 .IP "\fBtestprns\fP"
  73 .br
  74 .br
  75 the \fBtestprns
  76 (1)\fP utility allows you to test the printers defined
  77 in your printcap file\&.
  78 .IP
  79 .IP "\fBsmbstatus\fP"
  80 .br
  81 .br
  82 The \fBsmbstatus\fP
  83 (1) utility allows you list current connections to the
  84 \fBsmbd (8)\fP server\&.
  85 .IP
  86 .IP "\fBnmblookup\fP"
  87 .br
  88 .br
  89 the
  90 \fBnmblookup (1)\fP utility allows NetBIOS name
  91 queries to be made from the UNIX machine\&.
  92 .IP
  93 .IP "\fBmake_smbcodepage\fP"
  94 .br
  95 .br
  96 The
  97 \fBmake_smbcodepage (1)\fP utility allows
  98 you to create SMB code page definition files for your \fBsmbd
  99 (8)\fP server\&.
 100 .IP
 101 .IP "\fBsmbpasswd\fP"
 102 .br
 103 .br
 104 The \fBsmbpasswd
 105 (8)\fP utility allows you to change SMB encrypted
 106 passwords on Samba and Windows NT(tm) servers\&.
 107 .IP
 108 .PP
 109 .SH "AVAILABILITY"
 110 .PP
 111 The Samba software suite is licensed under the GNU Public License
 112 (GPL)\&. A copy of that license should have come with the package in the
 113 file COPYING\&. You are encouraged to distribute copies of the Samba
 114 suite, but please obey the terms of this license\&.
 115 .PP
 116 The latest version of the Samba suite can be obtained via anonymous
 117 ftp from samba\&.org in the directory pub/samba/\&. It is
 118 also available on several mirror sites worldwide\&.
 119 .PP
 120 You may also find useful information about Samba on the newsgroup
 121 comp\&.protocols\&.smb and the Samba mailing list\&. Details on how to join
 122 the mailing list are given in the README file that comes with Samba\&.
 123 .PP
 124 If you have access to a WWW viewer (such as Netscape or Mosaic) then
 125 you will also find lots of useful information, including back issues
 126 of the Samba mailing list, at
 127 http://samba\&.org/samba/\&.
 128 .PP
 129 .SH "VERSION"
 130 .PP
 131 This man page is correct for version 2\&.0 of the Samba suite\&.
 132 .PP
 133 .SH "CONTRIBUTIONS"
 134 .PP
 135 If you wish to contribute to the Samba project, then I suggest you
 136 join the Samba mailing list at \fIsamba@samba\&.org\fP\&. See the
 137 Web page at
 138 http://samba\&.org/listproc
 139 for details on how to do this\&.
 140 .PP
 141 If you have patches to submit or bugs to report then you may mail them
 142 directly to \fIsamba-bugs@samba\&.org\fP\&. Note, however, that due to
 143 the enormous popularity of this package the Samba Team may take some
 144 time to respond to mail\&. We prefer patches in \fIdiff -u\fP format\&.
 145 .PP
 146 .SH "CREDITS"
 147 .PP
 148 Contributors to the project are now too numerous to mention here but
 149 all deserve the thanks of all Samba users\&. To see a full list, look at
 150 ftp://samba\&.org/pub/samba/alpha/change-log
 151 for the pre-CVS changes and at
 152 ftp://samba\&.org/pub/samba/alpha/cvs\&.log
 153 for the contributors to Samba post-CVS\&. CVS is the Open Source source
 154 code control system used by the Samba Team to develop Samba\&. The
 155 project would have been unmanageable without it\&.
 156 .PP
 157 In addition, several commercial organizations now help fund the Samba
 158 Team with money and equipment\&. For details see the Samba Web pages at
 159 http://samba\&.org/samba/samba-thanks\&.html\&.
 160 .PP
 161 .SH "AUTHOR"
 162 .PP
 163 The original Samba software and related utilities were created by
 164 Andrew Tridgell \fIsamba-bugs@samba\&.org\fP\&. Samba is now developed
 165 by the Samba Team as an Open Source project similar to the way the
 166 Linux kernel is developed\&.
 167 .PP
 168 The original Samba man pages were written by Karl Auer\&. The man page
 169 sources were converted to YODL format (another excellent piece of Open
 170 Source software, available at
 171 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
 172 and updated for the Samba2\&.0 release by Jeremy Allison\&.
 173 \fIsamba-bugs@samba\&.org\fP\&.