docs/htmldocs/samba.7.html

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