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.7"
  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 ><SPAN
  67 CLASS="CITEREFENTRY"
  68 ><SPAN
  69 CLASS="REFENTRYTITLE"
  70 >smbd</SPAN
  71 >(8)</SPAN
  72 ></DT
  73 ><DD
  74 ><P
  75 >The <B
  76 CLASS="COMMAND"
  77 >smbd</B
  78 > daemon provides the file and print services to
  79                 SMB clients, such as Windows 95/98, Windows NT, Windows
  80                 for Workgroups or LanManager. The configuration file
  81                 for this daemon is described in <SPAN
  82 CLASS="CITEREFENTRY"
  83 ><SPAN
  84 CLASS="REFENTRYTITLE"
  85 >smb.conf</SPAN
  86 >(5)</SPAN
  87 >
  88                 </P
  89 ></DD
  90 ><DT
  91 ><SPAN
  92 CLASS="CITEREFENTRY"
  93 ><SPAN
  94 CLASS="REFENTRYTITLE"
  95 >nmbd</SPAN
  96 >(8)</SPAN
  97 ></DT
  98 ><DD
  99 ><P
 100 >The <B
 101 CLASS="COMMAND"
 102 >nmbd</B
 103 >
 104                 daemon provides NetBIOS nameservice and browsing
 105                 support. The configuration file for this daemon
 106                 is described in <SPAN
 107 CLASS="CITEREFENTRY"
 108 ><SPAN
 109 CLASS="REFENTRYTITLE"
 110 >smb.conf</SPAN
 111 >(5)</SPAN
 112 ></P
 113 ></DD
 114 ><DT
 115 ><SPAN
 116 CLASS="CITEREFENTRY"
 117 ><SPAN
 118 CLASS="REFENTRYTITLE"
 119 >smbclient</SPAN
 120 >(1)</SPAN
 121 ></DT
 122 ><DD
 123 ><P
 124 >The <B
 125 CLASS="COMMAND"
 126 >smbclient</B
 127 >
 128                 program implements a simple ftp-like client. This
 129                 is useful for accessing SMB shares on other compatible
 130                 servers (such as Windows NT), and can also be used
 131                 to allow a UNIX box to print to a printer attached to
 132                 any SMB server (such as a PC running Windows NT).</P
 133 ></DD
 134 ><DT
 135 ><SPAN
 136 CLASS="CITEREFENTRY"
 137 ><SPAN
 138 CLASS="REFENTRYTITLE"
 139 >testparm</SPAN
 140 >(1)</SPAN
 141 ></DT
 142 ><DD
 143 ><P
 144 >The <B
 145 CLASS="COMMAND"
 146 >testparm</B
 147 >
 148                 utility is a simple syntax checker for Samba's <SPAN
 149 CLASS="CITEREFENTRY"
 150 ><SPAN
 151 CLASS="REFENTRYTITLE"
 152 >smb.conf</SPAN
 153 >(5)</SPAN
 154 > configuration file.</P
 155 ></DD
 156 ><DT
 157 ><SPAN
 158 CLASS="CITEREFENTRY"
 159 ><SPAN
 160 CLASS="REFENTRYTITLE"
 161 >testprns</SPAN
 162 >(1)</SPAN
 163 ></DT
 164 ><DD
 165 ><P
 166 >The <B
 167 CLASS="COMMAND"
 168 >testprns</B
 169 >
 170                 utility supports testing printer names defined
 171                 in your <TT
 172 CLASS="FILENAME"
 173 >printcap</TT
 174 > file used
 175                 by Samba.</P
 176 ></DD
 177 ><DT
 178 ><SPAN
 179 CLASS="CITEREFENTRY"
 180 ><SPAN
 181 CLASS="REFENTRYTITLE"
 182 >smbstatus</SPAN
 183 >(1)</SPAN
 184 ></DT
 185 ><DD
 186 ><P
 187 >The <B
 188 CLASS="COMMAND"
 189 >smbstatus</B
 190 >
 191                 tool provides access to information about the
 192                 current connections to <B
 193 CLASS="COMMAND"
 194 >smbd</B
 195 >.</P
 196 ></DD
 197 ><DT
 198 ><SPAN
 199 CLASS="CITEREFENTRY"
 200 ><SPAN
 201 CLASS="REFENTRYTITLE"
 202 >nmblookup</SPAN
 203 >(1)</SPAN
 204 ></DT
 205 ><DD
 206 ><P
 207 >The <B
 208 CLASS="COMMAND"
 209 >nmblookup</B
 210 >
 211                 tools allows NetBIOS name queries to be made
 212                 from a UNIX host.</P
 213 ></DD
 214 ><DT
 215 ><SPAN
 216 CLASS="CITEREFENTRY"
 217 ><SPAN
 218 CLASS="REFENTRYTITLE"
 219 >smbgroupedit</SPAN
 220 >(8)</SPAN
 221 ></DT
 222 ><DD
 223 ><P
 224 >The <B
 225 CLASS="COMMAND"
 226 >smbgroupedit</B
 227 >
 228                 tool allows for mapping unix groups to NT Builtin,
 229                 Domain, or Local groups. Also it allows setting
 230                 priviledges for that group, such as saAddUser, etc.</P
 231 ></DD
 232 ><DT
 233 ><SPAN
 234 CLASS="CITEREFENTRY"
 235 ><SPAN
 236 CLASS="REFENTRYTITLE"
 237 >smbpasswd</SPAN
 238 >(8)</SPAN
 239 ></DT
 240 ><DD
 241 ><P
 242 >The <B
 243 CLASS="COMMAND"
 244 >smbpasswd</B
 245 >
 246                 command is a tool for changing LanMan and Windows NT
 247                 password hashes on Samba and Windows NT servers.</P
 248 ></DD
 249 ></DL
 250 ></DIV
 251 ></DIV
 252 ><DIV
 253 CLASS="REFSECT1"
 254 ><A
 255 NAME="AEN99"
 256 ></A
 257 ><H2
 258 >COMPONENTS</H2
 259 ><P
 260 >The Samba suite is made up of several components. Each
 261         component is described in a separate manual page. It is strongly
 262         recommended that you read the documentation that comes with Samba
 263         and the manual pages of those components that you use. If the
 264         manual pages and documents aren't clear enough then please visit
 265         <A
 266 HREF="http://devel.samba.org/"
 267 TARGET="_top"
 268 >http://devel.samba.org</A
 269 >
 270         for information on how to file a bug report or submit a patch.</P
 271 ><P
 272 >If you require help, visit the Samba webpage at
 273         <A
 274 HREF="http://samba.org/"
 275 TARGET="_top"
 276 >http://www.samba.org/</A
 277 > and
 278         explore the many option available to you.
 279         </P
 280 ></DIV
 281 ><DIV
 282 CLASS="REFSECT1"
 283 ><A
 284 NAME="AEN105"
 285 ></A
 286 ><H2
 287 >AVAILABILITY</H2
 288 ><P
 289 >The Samba software suite is licensed under the
 290         GNU Public License(GPL). A copy of that license should
 291         have come with the package in the file COPYING. You are
 292         encouraged to distribute copies of the Samba suite, but
 293         please obey the terms of this license.</P
 294 ><P
 295 >The latest version of the Samba suite can be
 296         obtained via anonymous ftp from samba.org in the
 297         directory pub/samba/. It is also available on several
 298         mirror sites worldwide.</P
 299 ><P
 300 >You may also find useful information about Samba
 301         on the newsgroup <A
 302 HREF="news:comp.protocols.smb"
 303 TARGET="_top"
 304 >       comp.protocol.smb</A
 305 > and the Samba mailing
 306         list. Details on how to join the mailing list are given in
 307         the README file that comes with Samba.</P
 308 ><P
 309 >If you have access to a WWW viewer (such as Mozilla
 310         or Konqueror) then you will also find lots of useful information,
 311         including back issues of the Samba mailing list, at
 312         <A
 313 HREF="http://lists.samba.org/"
 314 TARGET="_top"
 315 >http://lists.samba.org</A
 316 >.</P
 317 ></DIV
 318 ><DIV
 319 CLASS="REFSECT1"
 320 ><A
 321 NAME="AEN113"
 322 ></A
 323 ><H2
 324 >VERSION</H2
 325 ><P
 326 >This man page is correct for version 3.0 of the
 327         Samba suite. </P
 328 ></DIV
 329 ><DIV
 330 CLASS="REFSECT1"
 331 ><A
 332 NAME="AEN116"
 333 ></A
 334 ><H2
 335 >CONTRIBUTIONS</H2
 336 ><P
 337 >If you wish to contribute to the Samba project,
 338         then I suggest you join the Samba mailing list at
 339         <A
 340 HREF="http://lists.samba.org/"
 341 TARGET="_top"
 342 >http://lists.samba.org</A
 343 >.
 344         </P
 345 ><P
 346 >If you have patches to submit, visit
 347         <A
 348 HREF="http://devel.samba.org/"
 349 TARGET="_top"
 350 >http://devel.samba.org/</A
 351 >
 352         for information on how to do it properly. We prefer patches
 353         in <B
 354 CLASS="COMMAND"
 355 >diff -u</B
 356 > format.</P
 357 ></DIV
 358 ><DIV
 359 CLASS="REFSECT1"
 360 ><A
 361 NAME="AEN123"
 362 ></A
 363 ><H2
 364 >CONTRIBUTORS</H2
 365 ><P
 366 >Contributors to the project are now too numerous
 367         to mention here but all deserve the thanks of all Samba
 368         users. To see a full list, look at <A
 369 HREF="ftp://samba.org/pub/samba/alpha/change-log"
 370 TARGET="_top"
 371 >       ftp://samba.org/pub/samba/alpha/change-log</A
 372 >
 373         for the pre-CVS changes and at <A
 374 HREF="ftp://samba.org/pub/samba/alpha/cvs.log"
 375 TARGET="_top"
 376 >       ftp://samba.org/pub/samba/alpha/cvs.log</A
 377 >
 378         for the contributors to Samba post-CVS. CVS is the Open Source
 379         source code control system used by the Samba Team to develop
 380         Samba. The project would have been unmanageable without it.</P
 381 ><P
 382 >In addition, several commercial organizations now help
 383         fund the Samba Team with money and equipment. For details see
 384         the Samba Web pages at <A
 385 HREF="http://samba.org/samba/samba-thanks.html"
 386 TARGET="_top"
 387 >       http://samba.org/samba/samba-thanks.html</A
 388 >.</P
 389 ></DIV
 390 ><DIV
 391 CLASS="REFSECT1"
 392 ><A
 393 NAME="AEN130"
 394 ></A
 395 ><H2
 396 >AUTHOR</H2
 397 ><P
 398 >The original Samba software and related utilities
 399         were created by Andrew Tridgell. Samba is now developed
 400         by the Samba Team as an Open Source project similar
 401         to the way the Linux kernel is developed.</P
 402 ><P
 403 >The original Samba man pages were written by Karl Auer.
 404         The man page sources were converted to YODL format (another
 405         excellent piece of Open Source software, available at <A
 406 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
 407 TARGET="_top"
 408 >       ftp://ftp.icce.rug.nl/pub/unix/</A
 409 >) and updated for the Samba 2.0
 410         release by Jeremy Allison.  The conversion to DocBook for
 411         Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML
 412         4.2 for Samba 3.0 was done by Alexander Bokovoy.</P
 413 ></DIV
 414 ></BODY
 415 ></HTML
 416 >