| 1 | '\" t
|
|---|
| 2 | .\" Title: samba
|
|---|
| 3 | .\" Author: [see the "AUTHOR" section]
|
|---|
| 4 | .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
|
|---|
| 5 | .\" Date: 09/18/2013
|
|---|
| 6 | .\" Manual: Miscellanea
|
|---|
| 7 | .\" Source: Samba 3.6
|
|---|
| 8 | .\" Language: English
|
|---|
| 9 | .\"
|
|---|
| 10 | .TH "SAMBA" "7" "09/18/2013" "Samba 3\&.6" "Miscellanea"
|
|---|
| 11 | .\" -----------------------------------------------------------------
|
|---|
| 12 | .\" * Define some portability stuff
|
|---|
| 13 | .\" -----------------------------------------------------------------
|
|---|
| 14 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 15 | .\" http://bugs.debian.org/507673
|
|---|
| 16 | .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|---|
| 17 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 18 | .ie \n(.g .ds Aq \(aq
|
|---|
| 19 | .el .ds Aq '
|
|---|
| 20 | .\" -----------------------------------------------------------------
|
|---|
| 21 | .\" * set default formatting
|
|---|
| 22 | .\" -----------------------------------------------------------------
|
|---|
| 23 | .\" disable hyphenation
|
|---|
| 24 | .nh
|
|---|
| 25 | .\" disable justification (adjust text to left margin only)
|
|---|
| 26 | .ad l
|
|---|
| 27 | .\" -----------------------------------------------------------------
|
|---|
| 28 | .\" * MAIN CONTENT STARTS HERE *
|
|---|
| 29 | .\" -----------------------------------------------------------------
|
|---|
| 30 | .SH "NAME"
|
|---|
| 31 | samba \- A Windows SMB/CIFS fileserver for UNIX
|
|---|
| 32 | .SH "SYNOPSIS"
|
|---|
| 33 | .HP \w'\ 'u
|
|---|
| 34 | samba
|
|---|
| 35 | .SH "DESCRIPTION"
|
|---|
| 36 | .PP
|
|---|
| 37 | 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
|
|---|
| 38 | http://www\&.ubiqx\&.org/cifs/\&. Samba also implements the NetBIOS protocol in nmbd\&.
|
|---|
| 39 | .PP
|
|---|
| 40 | \fBsmbd\fR(8)
|
|---|
| 41 | .RS 4
|
|---|
| 42 | The
|
|---|
| 43 | smbd
|
|---|
| 44 | 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
|
|---|
| 45 | \fBsmb.conf\fR(5)
|
|---|
| 46 | .RE
|
|---|
| 47 | .PP
|
|---|
| 48 | \fBnmbd\fR(8)
|
|---|
| 49 | .RS 4
|
|---|
| 50 | The
|
|---|
| 51 | nmbd
|
|---|
| 52 | daemon provides NetBIOS nameservice and browsing support\&. The configuration file for this daemon is described in
|
|---|
| 53 | \fBsmb.conf\fR(5)
|
|---|
| 54 | .RE
|
|---|
| 55 | .PP
|
|---|
| 56 | \fBsmbclient\fR(1)
|
|---|
| 57 | .RS 4
|
|---|
| 58 | The
|
|---|
| 59 | smbclient
|
|---|
| 60 | 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)\&.
|
|---|
| 61 | .RE
|
|---|
| 62 | .PP
|
|---|
| 63 | \fBtestparm\fR(1)
|
|---|
| 64 | .RS 4
|
|---|
| 65 | The
|
|---|
| 66 | testparm
|
|---|
| 67 | utility is a simple syntax checker for Samba\*(Aqs
|
|---|
| 68 | \fBsmb.conf\fR(5)
|
|---|
| 69 | configuration file\&.
|
|---|
| 70 | .RE
|
|---|
| 71 | .PP
|
|---|
| 72 | \fBtestprns\fR(1)
|
|---|
| 73 | .RS 4
|
|---|
| 74 | The
|
|---|
| 75 | testprns
|
|---|
| 76 | utility supports testing printer names defined in your
|
|---|
| 77 | printcap
|
|---|
| 78 | file used by Samba\&.
|
|---|
| 79 | .RE
|
|---|
| 80 | .PP
|
|---|
| 81 | \fBsmbstatus\fR(1)
|
|---|
| 82 | .RS 4
|
|---|
| 83 | The
|
|---|
| 84 | smbstatus
|
|---|
| 85 | tool provides access to information about the current connections to
|
|---|
| 86 | smbd\&.
|
|---|
| 87 | .RE
|
|---|
| 88 | .PP
|
|---|
| 89 | \fBnmblookup\fR(1)
|
|---|
| 90 | .RS 4
|
|---|
| 91 | The
|
|---|
| 92 | nmblookup
|
|---|
| 93 | tools allows NetBIOS name queries to be made from a UNIX host\&.
|
|---|
| 94 | .RE
|
|---|
| 95 | .PP
|
|---|
| 96 | \fBsmbpasswd\fR(8)
|
|---|
| 97 | .RS 4
|
|---|
| 98 | The
|
|---|
| 99 | smbpasswd
|
|---|
| 100 | command is a tool for changing LanMan and Windows NT password hashes on Samba and Windows NT servers\&.
|
|---|
| 101 | .RE
|
|---|
| 102 | .PP
|
|---|
| 103 | \fBsmbcacls\fR(1)
|
|---|
| 104 | .RS 4
|
|---|
| 105 | The
|
|---|
| 106 | smbcacls
|
|---|
| 107 | command is a tool to set ACL\*(Aqs on remote CIFS servers\&.
|
|---|
| 108 | .RE
|
|---|
| 109 | .PP
|
|---|
| 110 | \fBsmbsh\fR(1)
|
|---|
| 111 | .RS 4
|
|---|
| 112 | The
|
|---|
| 113 | smbsh
|
|---|
| 114 | command is a program that allows you to run a unix shell with with an overloaded VFS\&.
|
|---|
| 115 | .RE
|
|---|
| 116 | .PP
|
|---|
| 117 | \fBsmbtree\fR(1)
|
|---|
| 118 | .RS 4
|
|---|
| 119 | The
|
|---|
| 120 | smbtree
|
|---|
| 121 | command is a text\-based network neighborhood tool\&.
|
|---|
| 122 | .RE
|
|---|
| 123 | .PP
|
|---|
| 124 | \fBsmbtar\fR(1)
|
|---|
| 125 | .RS 4
|
|---|
| 126 | The
|
|---|
| 127 | smbtar
|
|---|
| 128 | can make backups of data on CIFS/SMB servers\&.
|
|---|
| 129 | .RE
|
|---|
| 130 | .PP
|
|---|
| 131 | \fBsmbspool\fR(8)
|
|---|
| 132 | .RS 4
|
|---|
| 133 | smbspool
|
|---|
| 134 | is a helper utility for printing on printers connected to CIFS servers\&.
|
|---|
| 135 | .RE
|
|---|
| 136 | .PP
|
|---|
| 137 | \fBsmbcontrol\fR(1)
|
|---|
| 138 | .RS 4
|
|---|
| 139 | smbcontrol
|
|---|
| 140 | is a utility that can change the behaviour of running samba daemons\&.
|
|---|
| 141 | .RE
|
|---|
| 142 | .PP
|
|---|
| 143 | \fBrpcclient\fR(1)
|
|---|
| 144 | .RS 4
|
|---|
| 145 | rpcclient
|
|---|
| 146 | is a utility that can be used to execute RPC commands on remote CIFS servers\&.
|
|---|
| 147 | .RE
|
|---|
| 148 | .PP
|
|---|
| 149 | \fBpdbedit\fR(8)
|
|---|
| 150 | .RS 4
|
|---|
| 151 | The
|
|---|
| 152 | pdbedit
|
|---|
| 153 | command can be used to maintain the local user database on a samba server\&.
|
|---|
| 154 | .RE
|
|---|
| 155 | .PP
|
|---|
| 156 | \fBfindsmb\fR(1)
|
|---|
| 157 | .RS 4
|
|---|
| 158 | The
|
|---|
| 159 | findsmb
|
|---|
| 160 | command can be used to find SMB servers on the local network\&.
|
|---|
| 161 | .RE
|
|---|
| 162 | .PP
|
|---|
| 163 | \fBnet\fR(8)
|
|---|
| 164 | .RS 4
|
|---|
| 165 | The
|
|---|
| 166 | net
|
|---|
| 167 | command is supposed to work similar to the DOS/Windows NET\&.EXE command\&.
|
|---|
| 168 | .RE
|
|---|
| 169 | .PP
|
|---|
| 170 | \fBswat\fR(8)
|
|---|
| 171 | .RS 4
|
|---|
| 172 | swat
|
|---|
| 173 | is a web\-based interface to configuring
|
|---|
| 174 | smb\&.conf\&.
|
|---|
| 175 | .RE
|
|---|
| 176 | .PP
|
|---|
| 177 | \fBwinbindd\fR(8)
|
|---|
| 178 | .RS 4
|
|---|
| 179 | winbindd
|
|---|
| 180 | is a daemon that is used for integrating authentication and the user database into unix\&.
|
|---|
| 181 | .RE
|
|---|
| 182 | .PP
|
|---|
| 183 | \fBwbinfo\fR(1)
|
|---|
| 184 | .RS 4
|
|---|
| 185 | wbinfo
|
|---|
| 186 | is a utility that retrieves and stores information related to winbind\&.
|
|---|
| 187 | .RE
|
|---|
| 188 | .PP
|
|---|
| 189 | \fBprofiles\fR(1)
|
|---|
| 190 | .RS 4
|
|---|
| 191 | profiles
|
|---|
| 192 | is a command\-line utility that can be used to replace all occurrences of a certain SID with another SID\&.
|
|---|
| 193 | .RE
|
|---|
| 194 | .PP
|
|---|
| 195 | \fBlog2pcap\fR(1)
|
|---|
| 196 | .RS 4
|
|---|
| 197 | log2pcap
|
|---|
| 198 | is a utility for generating pcap trace files from Samba log files\&.
|
|---|
| 199 | .RE
|
|---|
| 200 | .PP
|
|---|
| 201 | \fBvfstest\fR(1)
|
|---|
| 202 | .RS 4
|
|---|
| 203 | vfstest
|
|---|
| 204 | is a utility that can be used to test vfs modules\&.
|
|---|
| 205 | .RE
|
|---|
| 206 | .PP
|
|---|
| 207 | \fBntlm_auth\fR(1)
|
|---|
| 208 | .RS 4
|
|---|
| 209 | ntlm_auth
|
|---|
| 210 | is a helper\-utility for external programs wanting to do NTLM\-authentication\&.
|
|---|
| 211 | .RE
|
|---|
| 212 | .PP
|
|---|
| 213 | \fBsmbmount\fR(8), \fBsmbumount\fR(8), \fBsmbmnt\fR(8)
|
|---|
| 214 | .RS 4
|
|---|
| 215 | smbmount,smbumount
|
|---|
| 216 | and
|
|---|
| 217 | smbmnt
|
|---|
| 218 | are commands that can be used to mount CIFS/SMB shares on Linux\&.
|
|---|
| 219 | .RE
|
|---|
| 220 | .PP
|
|---|
| 221 | \fBsmbcquotas\fR(1)
|
|---|
| 222 | .RS 4
|
|---|
| 223 | smbcquotas
|
|---|
| 224 | is a tool that can set remote QUOTA\*(Aqs on server with NTFS 5\&.
|
|---|
| 225 | .RE
|
|---|
| 226 | .SH "COMPONENTS"
|
|---|
| 227 | .PP
|
|---|
| 228 | 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\*(Aqt clear enough then please visit
|
|---|
| 229 | http://devel\&.samba\&.org
|
|---|
| 230 | for information on how to file a bug report or submit a patch\&.
|
|---|
| 231 | .PP
|
|---|
| 232 | If you require help, visit the Samba webpage at
|
|---|
| 233 | http://www\&.samba\&.org/
|
|---|
| 234 | and explore the many option available to you\&.
|
|---|
| 235 | .SH "AVAILABILITY"
|
|---|
| 236 | .PP
|
|---|
| 237 | 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\&.
|
|---|
| 238 | .PP
|
|---|
| 239 | 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\&.
|
|---|
| 240 | .PP
|
|---|
| 241 | You may also find useful information about Samba on the newsgroup
|
|---|
| 242 | comp\&.protocol\&.smb
|
|---|
| 243 | and the Samba mailing list\&. Details on how to join the mailing list are given in the README file that comes with Samba\&.
|
|---|
| 244 | .PP
|
|---|
| 245 | If you have access to a WWW viewer (such as Mozilla or Konqueror) then you will also find lots of useful information, including back issues of the Samba mailing list, at
|
|---|
| 246 | http://lists\&.samba\&.org\&.
|
|---|
| 247 | .SH "VERSION"
|
|---|
| 248 | .PP
|
|---|
| 249 | This man page is correct for version 3 of the Samba suite\&.
|
|---|
| 250 | .SH "CONTRIBUTIONS"
|
|---|
| 251 | .PP
|
|---|
| 252 | If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at
|
|---|
| 253 | http://lists\&.samba\&.org\&.
|
|---|
| 254 | .PP
|
|---|
| 255 | If you have patches to submit, visit
|
|---|
| 256 | http://devel\&.samba\&.org/
|
|---|
| 257 | for information on how to do it properly\&. We prefer patches in
|
|---|
| 258 | diff \-u
|
|---|
| 259 | format\&.
|
|---|
| 260 | .SH "CONTRIBUTORS"
|
|---|
| 261 | .PP
|
|---|
| 262 | 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 the
|
|---|
| 263 | change\-log
|
|---|
| 264 | in the source package for the pre\-CVS changes and at
|
|---|
| 265 | http://cvs\&.samba\&.org/
|
|---|
| 266 | 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\&.
|
|---|
| 267 | .SH "AUTHOR"
|
|---|
| 268 | .PP
|
|---|
| 269 | 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\&.
|
|---|
| 270 | .PP
|
|---|
| 271 | 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
|
|---|
| 272 | 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\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
|
|---|
