trying to get HEAD building again. If you want the code
[metze/samba/wip.git] / docs / htmldocs / samba.7.html
index a54d3e883f8118391857ba7d0dd0254092f0432d..222bdee9952dbcb6792ae1d51d81214479928232 100644 (file)
@@ -1,68 +1,68 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>samba</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.59.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="samba.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>Samba &#8212; A Windows SMB/CIFS fileserver for UNIX</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt>Samba</tt> </p></div></div><div class="refsect1" lang="en"><h2>DESCRIPTION</h2><p>The Samba software suite is a collection of programs 
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>samba</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="samba.7"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>samba &#8212; A Windows SMB/CIFS fileserver for UNIX</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">Samba</tt> </p></div></div><div class="refsect1" lang="en"><h2>DESCRIPTION</h2><p>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 <a href="http://www.ubiqx.org/cifs/" target="_top">
        http://www.ubiqx.org/cifs/</a>. Samba also implements the NetBIOS
-       protocol in nmbd.</p><div class="variablelist"><dl><dt><span class="term"><a href="smbd.8.html">smbd(8)</a></span></dt><dd><p>The <b>smbd</b> daemon provides the file and print services to 
+       protocol in nmbd.</p><div class="variablelist"><dl><dt><span class="term"><a href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a></span></dt><dd><p>The <b class="command">smbd</b> 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 <a href="smb.conf.5.html">smb.conf(5)</a>
-               </p></dd><dt><span class="term"><a href="nmbd.8.html">nmbd(8)</a></span></dt><dd><p>The <b>nmbd</b>
+               for this daemon is described in <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>
+               </p></dd><dt><span class="term"><a href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a></span></dt><dd><p>The <b class="command">nmbd</b>
                daemon provides NetBIOS nameservice and browsing
                support. The configuration file for this daemon 
-               is described in <a href="smb.conf.5.html">smb.conf(5)</a></p></dd><dt><span class="term"><a href="smbclient.1.html">smbclient(1)</a></span></dt><dd><p>The <b>smbclient</b>
+               is described in <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></p></dd><dt><span class="term"><a href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbclient</b>
                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).</p></dd><dt><span class="term"><a href="testparm.1.html">testparm(1)</a></span></dt><dd><p>The <b>testparm</b>
-               utility is a simple syntax checker for Samba's <a href="smb.conf.5.html">smb.conf(5)</a> configuration file.</p></dd><dt><span class="term"><a href="testprns.1.html">testprns(1)</a></span></dt><dd><p>The <b>testprns</b>
+               any SMB server (such as a PC running Windows NT).</p></dd><dt><span class="term"><a href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a></span></dt><dd><p>The <b class="command">testparm</b>
+               utility is a simple syntax checker for Samba's <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> configuration file.</p></dd><dt><span class="term"><a href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a></span></dt><dd><p>The <b class="command">testprns</b>
                utility supports testing printer names defined 
-               in your <tt>printcap</tt> file used 
-               by Samba.</p></dd><dt><span class="term"><a href="smbstatus.1.html">smbstatus(1)</a></span></dt><dd><p>The <b>smbstatus</b>
+               in your <tt class="filename">printcap</tt> file used 
+               by Samba.</p></dd><dt><span class="term"><a href="smbstatus.1.html"><span class="citerefentry"><span class="refentrytitle">smbstatus</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbstatus</b>
                tool provides access to information about the 
-               current connections to <b>smbd</b>.</p></dd><dt><span class="term"><a href="nmblookup.1.html">nmblookup(1)</a></span></dt><dd><p>The <b>nmblookup</b>
+               current connections to <b class="command">smbd</b>.</p></dd><dt><span class="term"><a href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a></span></dt><dd><p>The <b class="command">nmblookup</b>
                tools allows NetBIOS name queries to be made 
-               from a UNIX host.</p></dd><dt><span class="term"><a href="smbgroupedit.8.html">smbgroupedit(8)</a></span></dt><dd><p>The <b>smbgroupedit</b>
+               from a UNIX host.</p></dd><dt><span class="term"><a href="smbgroupedit.8.html"><span class="citerefentry"><span class="refentrytitle">smbgroupedit</span>(8)</span></a></span></dt><dd><p>The <b class="command">smbgroupedit</b>
                tool allows for mapping unix groups to NT Builtin,
                Domain, or Local groups. Also it allows setting
-               priviledges for that group, such as saAddUser, etc.</p></dd><dt><span class="term"><a href="smbpasswd.8.html">smbpasswd(8)</a></span></dt><dd><p>The <b>smbpasswd</b>
+               priviledges for that group, such as saAddUser, etc.</p></dd><dt><span class="term"><a href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a></span></dt><dd><p>The <b class="command">smbpasswd</b>
                command is a tool for changing LanMan and Windows NT 
-               password hashes on Samba and Windows NT servers.</p></dd><dt><span class="term"><a href="smbcacls.1.html">smbcacls(1)</a></span></dt><dd><p>The <b>smbcacls</b> command is 
-               a tool to set ACL's on remote CIFS servers. </p></dd><dt><span class="term"><a href="smbsh.1.html">smbsh(1)</a></span></dt><dd><p>The <b>smbsh</b> command is 
+               password hashes on Samba and Windows NT servers.</p></dd><dt><span class="term"><a href="smbcacls.1.html"><span class="citerefentry"><span class="refentrytitle">smbcacls</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbcacls</b> command is 
+               a tool to set ACL's on remote CIFS servers. </p></dd><dt><span class="term"><a href="smbsh.1.html"><span class="citerefentry"><span class="refentrytitle">smbsh</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbsh</b> command is 
                a program that allows you to run a unix shell with 
-               with an overloaded VFS.</p></dd><dt><span class="term"><a href="smbtree.1.html">smbtree(1)</a></span></dt><dd><p>The <b>smbtree</b> command 
-               is a text-based network neighborhood tool.</p></dd><dt><span class="term"><a href="smbtar.1.html">smbtar(1)</a></span></dt><dd><p>The <b>smbtar</b> can make 
-               backups of data on CIFS/SMB servers.</p></dd><dt><span class="term"><a href="smbspool.8.html">smbspool(8)</a></span></dt><dd><p><b>smbspool</b> is a 
+               with an overloaded VFS.</p></dd><dt><span class="term"><a href="smbtree.1.html"><span class="citerefentry"><span class="refentrytitle">smbtree</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbtree</b> command 
+               is a text-based network neighborhood tool.</p></dd><dt><span class="term"><a href="smbtar.1.html"><span class="citerefentry"><span class="refentrytitle">smbtar</span>(1)</span></a></span></dt><dd><p>The <b class="command">smbtar</b> can make 
+               backups of data on CIFS/SMB servers.</p></dd><dt><span class="term"><a href="smbspool.8.html"><span class="citerefentry"><span class="refentrytitle">smbspool</span>(8)</span></a></span></dt><dd><p><b class="command">smbspool</b> is a 
                helper utility for printing on printers connected 
-               to CIFS servers. </p></dd><dt><span class="term"><a href="smbcontrol.1.html">smbcontrol(1)</a></span></dt><dd><p><b>smbcontrol</b> is a utility
+               to CIFS servers. </p></dd><dt><span class="term"><a href="smbcontrol.1.html"><span class="citerefentry"><span class="refentrytitle">smbcontrol</span>(1)</span></a></span></dt><dd><p><b class="command">smbcontrol</b> is a utility
                that can change the behaviour of running samba daemons.
-               </p></dd><dt><span class="term"><a href="rpcclient.1.html">rpcclient(1)</a></span></dt><dd><p><b>rpcclient</b> is a utility
+               </p></dd><dt><span class="term"><a href="rpcclient.1.html"><span class="citerefentry"><span class="refentrytitle">rpcclient</span>(1)</span></a></span></dt><dd><p><b class="command">rpcclient</b> is a utility
                that can be used to execute RPC commands on remote 
-               CIFS servers.</p></dd><dt><span class="term"><a href="pdbedit.8.html">pdbedit(8)</a></span></dt><dd><p>The <b>pdbedit</b> command 
+               CIFS servers.</p></dd><dt><span class="term"><a href="pdbedit.8.html"><span class="citerefentry"><span class="refentrytitle">pdbedit</span>(8)</span></a></span></dt><dd><p>The <b class="command">pdbedit</b> command 
                can be used to maintain the local user database on 
-               a samba server.</p></dd><dt><span class="term"><a href="findsmb.1.html">findsmb(1)</a></span></dt><dd><p>The <b>findsmb</b> command 
+               a samba server.</p></dd><dt><span class="term"><a href="findsmb.1.html"><span class="citerefentry"><span class="refentrytitle">findsmb</span>(1)</span></a></span></dt><dd><p>The <b class="command">findsmb</b> command 
                can be used to find SMB servers on the local network.
-               </p></dd><dt><span class="term"><a href="net.8.html">net(8)</a></span></dt><dd><p>The <b>net</b> command 
+               </p></dd><dt><span class="term"><a href="net.8.html"><span class="citerefentry"><span class="refentrytitle">net</span>(8)</span></a></span></dt><dd><p>The <b class="command">net</b> command 
                is supposed to work similar to the DOS/Windows
-               NET.EXE command.</p></dd><dt><span class="term"><a href="swat.8.html">swat(8)</a></span></dt><dd><p><b>swat</b> is a web-based
-               interface to configuring <tt>smb.conf</tt>.
-               </p></dd><dt><span class="term"><a href="winbindd.8.html">winbindd(8)</a></span></dt><dd><p><b>winbindd</b> is a daemon 
+               NET.EXE command.</p></dd><dt><span class="term"><a href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a></span></dt><dd><p><b class="command">swat</b> is a web-based
+               interface to configuring <tt class="filename">smb.conf</tt>.
+               </p></dd><dt><span class="term"><a href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a></span></dt><dd><p><b class="command">winbindd</b> is a daemon 
                that is used for integrating authentication and 
-               the user database into unix.</p></dd><dt><span class="term"><a href="wbinfo.1.html">wbinfo(1)</a></span></dt><dd><p><b>wbinfo</b> is a utility 
+               the user database into unix.</p></dd><dt><span class="term"><a href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a></span></dt><dd><p><b class="command">wbinfo</b> is a utility 
                that retrieves and stores information related to winbind.
-               </p></dd><dt><span class="term"><a href="editreg.1.html">editreg(1)</a></span></dt><dd><p><b>editreg</b> is a command-line
+               </p></dd><dt><span class="term"><a href="editreg.1.html"><span class="citerefentry"><span class="refentrytitle">editreg</span>(1)</span></a></span></dt><dd><p><b class="command">editreg</b> is a command-line
                utility that can edit windows registry files.
-               </p></dd><dt><span class="term"><a href="profiles.1.html">profiles(1)</a></span></dt><dd><p><b>profiles</b> is a command-line
+               </p></dd><dt><span class="term"><a href="profiles.1.html"><span class="citerefentry"><span class="refentrytitle">profiles</span>(1)</span></a></span></dt><dd><p><b class="command">profiles</b> is a command-line
                utility that can be used to replace all occurences of 
                a certain SID with another SID.
-               </p></dd><dt><span class="term"><a href="vfstest.1.html">vfstest(1)</a></span></dt><dd><p><b>vfstest</b> is a utility
-               that can be used to test vfs modules.</p></dd><dt><span class="term"><a href="ntlm_auth.1.html">ntlm_auth(1)</a></span></dt><dd><p><b>ntlm_auth</b> is a helper-utility
+               </p></dd><dt><span class="term"><a href="vfstest.1.html"><span class="citerefentry"><span class="refentrytitle">vfstest</span>(1)</span></a></span></dt><dd><p><b class="command">vfstest</b> is a utility
+               that can be used to test vfs modules.</p></dd><dt><span class="term"><a href="ntlm_auth.1.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(1)</span></a></span></dt><dd><p><b class="command">ntlm_auth</b> is a helper-utility
                for external programs wanting to do NTLM-authentication.
-               </p></dd><dt><span class="term"><a href="smbmount.8.html">smbmount(8)</a>, <a href="smbumount.8.html">smbumount(8)</a>, <a href="smbmount.8.html">smbmount(8)</a></span></dt><dd><p><b>smbmount</b>,<b>smbmnt</b> and <b>smbmnt</b> are commands that can be used to 
+               </p></dd><dt><span class="term"><a href="smbmount.8.html"><span class="citerefentry"><span class="refentrytitle">smbmount</span>(8)</span></a>, <a href="smbumount.8.html"><span class="citerefentry"><span class="refentrytitle">smbumount</span>(8)</span></a>, <a href="smbmount.8.html"><span class="citerefentry"><span class="refentrytitle">smbmount</span>(8)</span></a></span></dt><dd><p><b class="command">smbmount</b>,<b class="command">smbmnt</b> and <b class="command">smbmnt</b> are commands that can be used to 
                mount CIFS/SMB shares on Linux.
-               </p></dd><dt><span class="term"><a href="smbcquotas.1.html">smbcquotas(1)</a></span></dt><dd><p><b>smbcquotas</b> is a tool that 
+               </p></dd><dt><span class="term"><a href="smbcquotas.1.html"><span class="citerefentry"><span class="refentrytitle">smbcquotas</span>(1)</span></a></span></dt><dd><p><b class="command">smbcquotas</b> is a tool that 
                can set remote QUOTA's on server with NTFS 5. </p></dd></dl></div></div><div class="refsect1" lang="en"><h2>COMPONENTS</h2><p>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 
        </p><p>If you have patches to submit, visit
        <a href="http://devel.samba.org/" target="_top">http://devel.samba.org/</a>
        for information on how to do it properly. We prefer patches 
-       in <b>diff -u</b> format.</p></div><div class="refsect1" lang="en"><h2>CONTRIBUTORS</h2><p>Contributors to the project are now too numerous 
+       in <b class="command">diff -u</b> format.</p></div><div class="refsect1" lang="en"><h2>CONTRIBUTORS</h2><p>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 <a href="ftp://samba.org/pub/samba/alpha/change-log" target="_top">
-       ftp://samba.org/pub/samba/alpha/change-log</a>
-       for the pre-CVS changes and at <a href="ftp://samba.org/pub/samba/alpha/cvs.log" target="_top">
-       ftp://samba.org/pub/samba/alpha/cvs.log</a>
+       users. To see a full list, look at the
+       <tt class="filename">change-log</tt> in the source package 
+       for the pre-CVS changes and at <a href="http://cvs.samba.org/" target="_top">
+       http://cvs.samba.org/</a>
        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.</p><p>In addition, several commercial organizations now help 
-       fund the Samba Team with money and equipment. For details see 
-       the Samba Web pages at <a href="http://samba.org/samba/samba-thanks.html" target="_top">
-       http://samba.org/samba/samba-thanks.html</a>.</p></div><div class="refsect1" lang="en"><h2>AUTHOR</h2><p>The original Samba software and related utilities 
+       Samba. The project would have been unmanageable without it.</p></div><div class="refsect1" lang="en"><h2>AUTHOR</h2><p>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.</p><p>The original Samba man pages were written by Karl Auer.