Regenerate
[ira/wip.git] / docs / htmldocs / nmbd.8.html
index 03fd3588e2654ae988178a9799f3389719fa558b..87a042a912ec0d8c08b7d2e508216af05699afd0 100644 (file)
-
-
-
-
-<html><head><title>nmbd</title>
-
-<link rev="made" href="mailto:samba-bugs@samba.org">
-</head>
-<body>
-
-<hr>
-
-<h1>nmbd</h1>
-<h2>Samba</h2>
-<h2>23 Oct 1998</h2>
-
-    
-
-    
-<p><br><a name="NAME"></a>
-<h2>NAME</h2>
-    nmbd - NetBIOS name server to provide NetBIOS over IP
-naming services to clients
-<p><br><a name="SYNOPSIS"></a>
-<h2>SYNOPSIS</h2>
-    
-<p><br><strong>nmbd</strong> [<a href="nmbd.8.html#minusD">-D</a>] [<a href="nmbd.8.html#minusa">-a</a>] [<a href="nmbd.8.html#minuso">-o</a>] [<a href="nmbd.8.html#minush">-h</a>] [<a href="nmbd.8.html#minusV">-V</a>] [<a href="nmbd.8.html#minusH">-H lmhosts file</a>] [<a href="nmbd.8.html#minusd">-d debuglevel</a>] [<a href="nmbd.8.html#minusl">-l log file basename</a>] [<a href="nmbd.8.html#minusn">-n primary NetBIOS name</a>] [<a href="nmbd.8.html#minusp">-p port number</a>] [<a href="nmbd.8.html#minuss">-s configuration file</a>] [<a href="nmbd.8.html#minusi">-i NetBIOS scope</a>]
-<p><br><a name="DESCRIPTION"></a>
-<h2>DESCRIPTION</h2>
-    
-<p><br>This program is part of the <strong>Samba</strong> suite.
-<p><br><strong>nmbd</strong> is a server that understands and can reply to NetBIOS over IP
-name service requests, like those produced by SMBD/CIFS clients such
-as Windows 95/98, Windows NT and LanManager clients. It also
-participates in the browsing protocols which make up the Windows
-"Network Neighborhood" view.
-<p><br>SMB/CIFS clients, when they start up, may wish to locate an SMB/CIFS
-server. That is, they wish to know what IP number a specified host is
-using.
-<p><br>Amongst other services, <strong>nmbd</strong> will listen for such requests,
-and if its own NetBIOS name is specified it will respond with the IP
-number of the host it is running on.  Its "own NetBIOS name" is by
-default the primary DNS name of the host it is running on, but this
-can be overridden with the <strong>-n</strong> option (see <a href="nmbd.8.html#OPTIONS">OPTIONS</a> below). Thus
-<strong>nmbd</strong> will reply to broadcast queries for its own name(s). Additional
-names for <strong>nmbd</strong> to respond on can be set via parameters in the
-<a href="smb.conf.5.html"><strong>smb.conf(5)</strong></a> configuration file.
-<p><br><strong>nmbd</strong> can also be used as a WINS (Windows Internet Name Server)
-server. What this basically means is that it will act as a WINS
-database server, creating a database from name registration requests
-that it receives and replying to queries from clients for these names.
-<p><br>In addition, <strong>nmbd</strong> can act as a WINS proxy, relaying broadcast queries
-from clients that do not understand how to talk the WINS protocol to a
-WIN server.
-<p><br><a name="OPTIONS"></a>
-<h2>OPTIONS</h2>
-    
-<p><br><ul>
-<p><br><a name="minusD"></a>
-<li><strong><strong>-D</strong></strong> If specified, this parameter causes <strong>nmbd</strong> to operate
-as a daemon. That is, it detaches itself and runs in the background,
-fielding requests on the appropriate port. By default, <strong>nmbd</strong> will
-NOT operate as a daemon. nmbd can also be operated from the inetd
-meta-daemon, although this is not recommended.
-<p><br><a name="minusa"></a>
-<li><strong><strong>-a</strong></strong> If this parameter is specified, each new connection will
-append log messages to the log file.  This is the default.
-<p><br><a name="minuso"></a>
-<li><strong><strong>-o</strong></strong> If this parameter is specified, the log files will be
-overwritten when opened.  By default, the log files will be appended
-to.
-<p><br><a name="minush"></a>
-<li><strong><strong>-h</strong></strong> Prints the help information (usage) for <strong>nmbd</strong>.
-<p><br><a name="minusV"></a>
-<li><strong><strong>-V</strong></strong> Prints the version number for <strong>nmbd</strong>.
-<p><br><a name="minusH"></a>
-<li><strong><strong>-H filename</strong></strong> NetBIOS lmhosts file.
-<p><br>The lmhosts file is a list of NetBIOS names to IP addresses that is
-loaded by the nmbd server and used via the name resolution mechanism
-<a href="smb.conf.5.html#nameresolveorder"><strong>name resolve order</strong></a> described in 
-<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> to resolve any
-NetBIOS name queries needed by the server. Note that the contents of
-this file are <em>NOT</em> used by <strong>nmbd</strong> to answer any name queries. Adding
-a line to this file affects name NetBIOS resolution from this host
-<em>ONLY</em>.
-<p><br>The default path to this file is compiled into Samba as part of the
-build process. Common defaults are <em>/usr/local/samba/lib/lmhosts</em>,
-<em>/usr/samba/lib/lmhosts</em> or <em>/etc/lmhosts</em>. See the 
-<a href="lmhosts.5.html"><strong>lmhosts (5)</strong></a> man page for details on the contents of this file.
-<p><br><a name="minusd"></a>
-<li><strong><strong>-d debuglevel</strong></strong> debuglevel is an integer from 0 to 10.
-<p><br>The default value if this parameter is not specified is zero.
-<p><br>The higher this value, the more detail will be logged to the log files
-about the activities of the server. At level 0, only critical errors
-and serious warnings will be logged. Level 1 is a reasonable level for
-day to day running - it generates a small amount of information about
-operations carried out.
-<p><br>Levels above 1 will generate considerable amounts of log data, and
-should only be used when investigating a problem. Levels above 3 are
-designed for use only by developers and generate HUGE amounts of log
-data, most of which is extremely cryptic.
-<p><br>Note that specifying this parameter here will override the <a href="smb.conf.5.html#loglevel"><strong>log
-level</strong></a> parameter in the <a href="smb.conf.5.html"><strong>smb.conf
-(5)</strong></a> file.
-<p><br><a name="minusl"></a>
-<li><strong><strong>-l logfile</strong></strong> The <strong>-l</strong> parameter specifies a path and base
-filename into which operational data from the running nmbd server will
-be logged.  The actual log file name is generated by appending the
-extension ".nmb" to the specified base name.  For example, if the name
-specified was "log" then the file log.nmb would contain the debugging
-data.
-<p><br>The default log file path is compiled into Samba as part of the
-build process. Common defaults are <em>/usr/local/samba/var/log.nmb</em>,
-<em>/usr/samba/var/log.nmb</em> or <em>/var/log/log.nmb</em>.
-<p><br><a name="minusn"></a>
-<li><strong><strong>-n primary NetBIOS name</strong></strong> This option allows you to override
-the NetBIOS name that Samba uses for itself. This is identical to
-setting the <a href="smb.conf.5.html#netbiosname"><strong>NetBIOS name</strong></a> parameter
-in the <a href="smb.conf.5.html"><strong>smb.conf</strong></a> file
-but will override the setting in the <a href="smb.conf.5.html"><strong>smb.conf</strong></a> file.
-<p><br><a name="minusp"></a>
-<li><strong><strong>-p UDP port number</strong></strong> UDP port number is a positive integer value.
-<p><br>This option changes the default UDP port number (normally 137) that
-<strong>nmbd</strong> responds to name queries on. Don't use this option unless you are
-an expert, in which case you won't need help!
-<p><br><a name="minuss"></a>
-<li><strong><strong>-s configuration file</strong></strong> The default configuration file name is
-set at build time, typically as <em>/usr/local/samba/lib/smb.conf</em>, but
-this may be changed when Samba is autoconfigured.
-<p><br>The file specified contains the configuration details required by the
-server. See <a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> for more information.
-<p><br><a name="minusi"></a>
-<li><strong><strong>-i scope</strong></strong> This specifies a NetBIOS scope that <strong>nmbd</strong> will use
-to communicate with when generating NetBIOS names. For details on the
-use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
-are <em>very</em> rarely used, only set this parameter if you are the
-system administrator in charge of all the NetBIOS systems you
-communicate with.
-<p><br></ul>
-<p><br><a name="FILES"></a>
-<h2>FILES</h2>
-    
-<p><br><strong>/etc/inetd.conf</strong>
-<p><br>If the server is to be run by the inetd meta-daemon, this file must
-contain suitable startup information for the meta-daemon.
-<p><br><strong>/etc/rc</strong>
-<p><br>(or whatever initialization script your system uses).
-<p><br>If running the server as a daemon at startup, this file will need to
-contain an appropriate startup sequence for the server.
-<p><br><strong>/usr/local/samba/lib/smb.conf</strong>
-<p><br>This is the default location of the 
-<a href="smb.conf.5.html"><strong>smb.conf</strong></a> server configuration
-file. Other common places that systems install this file are
-<em>/usr/samba/lib/smb.conf</em> and <em>/etc/smb.conf</em>.
-<p><br>When run as a <strong>WINS</strong> server (see the <a href="smb.conf.5.html#winssupport"><strong>wins support</strong></a>
-parameter in the <a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> man page), <strong>nmbd</strong> will
-store the WINS database in the file <code>wins.dat</code> in the <code>var/locks</code> directory
-configured under wherever Samba was configured to install itself.
-<p><br>If <strong>nmbd</strong> is acting as a <strong>browse master</strong> (see the <a href="smb.conf.5.html#localmaster"><strong>local master</strong></a>
-parameter in the <a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> man page), <strong>nmbd</strong> will
-store the browsing database in the file <code>browse.dat</code> in the <code>var/locks</code> directory
-configured under wherever Samba was configured to install itself.
-<p><br><a name="SIGNALS"></a>
-<h2>SIGNALS</h2>
-    
-<p><br>To shut down an <strong>nmbd</strong> process it is recommended that SIGKILL (-9)
-<em>NOT</em> be used, except as a last resort, as this may leave the name
-database in an inconsistent state. The correct way to terminate
-<strong>nmbd</strong> is to send it a SIGTERM (-15) signal and wait for it to die on
-its own.
-<p><br><strong>nmbd</strong> will accept SIGHUP, which will cause it to dump out it's
-namelists into the file <code>namelist.debug</code> in the
-<em>/usr/local/samba/var/locks</em> directory (or the <em>var/locks</em>
-directory configured under wherever Samba was configured to install
-itself). This will also cause <strong>nmbd</strong> to dump out it's server database in
-the log.nmb file. In addition, the debug log level of nmbd may be raised
-by sending it a SIGUSR1 (<code>kill -USR1 &lt;nmbd-pid&gt;</code>) and lowered by sending it a
-SIGUSR2 (<code>kill -USR2 &lt;nmbd-pid&gt;</code>). This is to allow transient
-problems to be diagnosed, whilst still running at a normally low log
-level.
-<p><br><a name="VERSION"></a>
-<h2>VERSION</h2>
-    
-<p><br>This man page is correct for version 2.0 of the Samba suite.
-<p><br><a name="SEEALSO"></a>
-<h2>SEE ALSO</h2>
-    
-<p><br><strong>inetd (8)</strong>, <a href="smbd.8.html"><strong>smbd (8)</strong></a>, <a href="smb.conf.5.html"><strong>smb.conf
-(5)</strong></a>, <a href="smbclient.1.html"><strong>smbclient (1)</strong></a>,
-<a href="testparm.1.html"><strong>testparm (1)</strong></a>, <a href="testprns.1.html"><strong>testprns
-(1)</strong></a>, and the Internet RFC's <strong>rfc1001.txt</strong>,
-<strong>rfc1002.txt</strong>. In addition the CIFS (formerly SMB) specification is
-available as a link from the Web page :
-<a href="http://samba.org/cifs/">http://samba.org/cifs/</a>.
-<p><br><a name="AUTHOR"></a>
-<h2>AUTHOR</h2>
-    
-<p><br>The original Samba software and related utilities were created by
-Andrew Tridgell <a href="mailto:samba-bugs@samba.org"><em>samba-bugs@samba.org</em></a>. Samba is now developed
-by the Samba Team as an Open Source project similar to the way the
-Linux kernel is developed.
-<p><br>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
-<a href="ftp://ftp.icce.rug.nl/pub/unix/"><strong>ftp://ftp.icce.rug.nl/pub/unix/</strong></a>)
-and updated for the Samba2.0 release by Jeremy Allison.
-<a href="mailto:samba-bugs@samba.org"><em>samba-bugs@samba.org</em></a>.
-<p><br>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc.
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML
+><HEAD
+><TITLE
+>nmbd</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"></HEAD
+><BODY
+CLASS="REFENTRY"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><H1
+><A
+NAME="NMBD.8"
+></A
+>nmbd</H1
+><DIV
+CLASS="REFNAMEDIV"
+><A
+NAME="AEN5"
+></A
+><H2
+>Name</H2
+>nmbd&nbsp;--&nbsp;NetBIOS name server to provide NetBIOS 
+       over IP naming services to clients</DIV
+><DIV
+CLASS="REFSYNOPSISDIV"
+><A
+NAME="AEN8"
+></A
+><H2
+>Synopsis</H2
+><P
+><B
+CLASS="COMMAND"
+>nmbd</B
+>  [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d &lt;debug level&gt;] [-H &lt;lmhosts file&gt;] [-l &lt;log directory&gt;] [-n &lt;primary netbios name&gt;] [-p &lt;port number&gt;] [-s &lt;configuration file&gt;]</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN25"
+></A
+><H2
+>DESCRIPTION</H2
+><P
+>This program is part of the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>Samba</SPAN
+>(7)</SPAN
+> suite.</P
+><P
+><B
+CLASS="COMMAND"
+>nmbd</B
+> is a server that understands 
+       and can reply to NetBIOS over IP name service requests, like 
+       those produced by SMB/CIFS clients such as Windows 95/98/ME, 
+       Windows NT, Windows 2000, Windows XP and LanManager clients. It also
+       participates in the browsing protocols which make up the 
+       Windows "Network Neighborhood" view.</P
+><P
+>SMB/CIFS clients, when they start up, may wish to 
+       locate an SMB/CIFS server. That is, they wish to know what 
+       IP number a specified host is using.</P
+><P
+>Amongst other services, <B
+CLASS="COMMAND"
+>nmbd</B
+> will 
+       listen for such requests, and if its own NetBIOS name is 
+       specified it will respond with the IP number of the host it 
+       is running on.  Its "own NetBIOS name" is by
+       default the primary DNS name of the host it is running on, 
+       but this can be overridden with the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>-n</I
+></SPAN
+> 
+       option (see OPTIONS below). Thus <B
+CLASS="COMMAND"
+>nmbd</B
+> will 
+       reply to broadcast queries for its own name(s). Additional
+       names for <B
+CLASS="COMMAND"
+>nmbd</B
+> to respond on can be set 
+       via parameters in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> configuration file.</P
+><P
+><B
+CLASS="COMMAND"
+>nmbd</B
+> can also be used as a WINS 
+       (Windows Internet Name Server) server. What this basically means 
+       is that it will act as a WINS database server, creating a 
+       database from name registration requests that it receives and 
+       replying to queries from clients for these names.</P
+><P
+>In addition, <B
+CLASS="COMMAND"
+>nmbd</B
+> can act as a WINS 
+       proxy, relaying broadcast queries from clients that do 
+       not understand how to talk the WINS protocol to a WINS 
+       server.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN46"
+></A
+><H2
+>OPTIONS</H2
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>-D</DT
+><DD
+><P
+>If specified, this parameter causes 
+               <B
+CLASS="COMMAND"
+>nmbd</B
+> to operate as a daemon. That is, 
+               it detaches itself and runs in the background, fielding 
+               requests on the appropriate port. By default, <B
+CLASS="COMMAND"
+>nmbd</B
+> 
+               will operate as a daemon if launched from a command shell. 
+               nmbd can also be operated from the <B
+CLASS="COMMAND"
+>inetd</B
+> 
+               meta-daemon, although this is not recommended.
+               </P
+></DD
+><DT
+>-F</DT
+><DD
+><P
+>If specified, this parameter causes
+               the main <B
+CLASS="COMMAND"
+>nmbd</B
+> process to not daemonize,
+               i.e. double-fork and disassociate with the terminal.
+               Child processes are still created as normal to service
+               each connection request, but the main process does not
+               exit. This operation mode is suitable for running
+               <B
+CLASS="COMMAND"
+>nmbd</B
+> under process supervisors such
+               as <B
+CLASS="COMMAND"
+>supervise</B
+> and <B
+CLASS="COMMAND"
+>svscan</B
+>
+               from Daniel J. Bernstein's <B
+CLASS="COMMAND"
+>daemontools</B
+>
+               package, or the AIX process monitor.
+               </P
+></DD
+><DT
+>-S</DT
+><DD
+><P
+>If specified, this parameter causes
+               <B
+CLASS="COMMAND"
+>nmbd</B
+> to log to standard output rather
+               than a file.</P
+></DD
+><DT
+>-a</DT
+><DD
+><P
+>If this parameter is specified, each new 
+               connection will append log messages to the log file.  
+               This is the default.</P
+></DD
+><DT
+>-i</DT
+><DD
+><P
+>If this parameter is specified it causes the
+               server to run "interactively", not as a daemon, even if the
+               server is executed on the command line of a shell. Setting this
+               parameter negates the implicit daemon mode when run from the
+               command line. <B
+CLASS="COMMAND"
+>nmbd</B
+> also logs to standard
+               output, as if the <TT
+CLASS="CONSTANT"
+>-S</TT
+> parameter had been
+               given. </P
+></DD
+><DT
+>-o</DT
+><DD
+><P
+>If this parameter is specified, the 
+               log files will be overwritten when opened.  By default, 
+               <B
+CLASS="COMMAND"
+>smbd</B
+> will append entries to the log 
+               files.</P
+></DD
+><DT
+>-h</DT
+><DD
+><P
+>Prints the help information (usage) 
+               for <B
+CLASS="COMMAND"
+>nmbd</B
+>.</P
+></DD
+><DT
+>-H &lt;filename&gt;</DT
+><DD
+><P
+>NetBIOS lmhosts file.  The lmhosts 
+               file is a list of NetBIOS names to IP addresses that 
+               is loaded by the nmbd server and used via the name 
+               resolution mechanism <A
+HREF="smb.conf.5.html#nameresolveorder"
+TARGET="_top"
+><TT
+CLASS="PARAMETER"
+><I
+>name resolve
+               order</I
+></TT
+></A
+> described in <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> to resolve any 
+               NetBIOS name queries needed by the server. Note 
+               that the contents of this file are <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>NOT</I
+></SPAN
+> 
+               used by <B
+CLASS="COMMAND"
+>nmbd</B
+> to answer any name queries. 
+               Adding a line to this file affects name NetBIOS resolution 
+               from this host <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>ONLY</I
+></SPAN
+>.</P
+><P
+>The default path to this file is compiled into 
+               Samba as part of the build process. Common defaults 
+               are <TT
+CLASS="FILENAME"
+>/usr/local/samba/lib/lmhosts</TT
+>,
+               <TT
+CLASS="FILENAME"
+>/usr/samba/lib/lmhosts</TT
+> or
+               <TT
+CLASS="FILENAME"
+>/etc/samba/lmhosts</TT
+>. See the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>lmhosts</SPAN
+>(5)</SPAN
+> man page for details on the contents of this file.</P
+></DD
+><DT
+>-V</DT
+><DD
+><P
+>Prints the version number for 
+               <B
+CLASS="COMMAND"
+>nmbd</B
+>.</P
+></DD
+><DT
+>-d &lt;debug level&gt;</DT
+><DD
+><P
+>debuglevel is an integer 
+               from 0 to 10.  The default value if this parameter is 
+               not specified is zero.</P
+><P
+>The higher this value, the more detail will 
+               be logged to the log files about the activities of the 
+               server. At level 0, only critical errors and serious 
+               warnings will be logged. Level 1 is a reasonable level for
+               day to day running - it generates a small amount of 
+               information about operations carried out.</P
+><P
+>Levels above 1 will generate considerable amounts 
+               of log data, and should only be used when investigating 
+               a problem. Levels above 3 are designed for use only by developers 
+               and generate HUGE amounts of log data, most of which is extremely 
+               cryptic.</P
+><P
+>Note that specifying this parameter here will override 
+               the <A
+HREF="smb.conf.5.html#loglevel"
+TARGET="_top"
+><TT
+CLASS="PARAMETER"
+><I
+>log level</I
+></TT
+></A
+> 
+               parameter in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> file.</P
+></DD
+><DT
+>-l &lt;log directory&gt;</DT
+><DD
+><P
+>The -l parameter specifies a directory 
+               into which the "log.nmbd" log file will be created
+               for operational data from the running <B
+CLASS="COMMAND"
+>nmbd</B
+>
+               server. The default log directory is compiled into Samba
+               as part of the build process. Common defaults are <TT
+CLASS="FILENAME"
+>              /usr/local/samba/var/log.nmb</TT
+>, <TT
+CLASS="FILENAME"
+>              /usr/samba/var/log.nmb</TT
+> or
+               <TT
+CLASS="FILENAME"
+>/var/log/log.nmb</TT
+>.  <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Beware:</I
+></SPAN
+>
+                If the directory specified does not exist, <B
+CLASS="COMMAND"
+>nmbd</B
+>
+                will log to the default debug log location defined at compile time.
+               </P
+></DD
+><DT
+>-n &lt;primary NetBIOS name&gt;</DT
+><DD
+><P
+>This option allows you to override
+               the NetBIOS name that Samba uses for itself. This is identical 
+               to setting the <A
+HREF="smb.conf.5.html#netbiosname"
+TARGET="_top"
+><TT
+CLASS="PARAMETER"
+><I
+>NetBIOS
+               name</I
+></TT
+></A
+> parameter in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> file.  However, a command
+               line setting will take precedence over settings in 
+               <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+>.</P
+></DD
+><DT
+>-p &lt;UDP port number&gt;</DT
+><DD
+><P
+>UDP port number is a positive integer value.
+               This option changes the default UDP port number (normally 137)
+               that <B
+CLASS="COMMAND"
+>nmbd</B
+> responds to name queries on. Don't
+               use this option unless you are an expert, in which case you
+               won't need help!</P
+></DD
+><DT
+>-s &lt;configuration file&gt;</DT
+><DD
+><P
+>The default configuration file name
+               is set at build time, typically as <TT
+CLASS="FILENAME"
+>              /usr/local/samba/lib/smb.conf</TT
+>, but
+               this may be changed when Samba is autoconfigured.</P
+><P
+>The file specified contains the configuration details
+               required by the server. See <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> for more information.
+               </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN162"
+></A
+><H2
+>FILES</H2
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+><TT
+CLASS="FILENAME"
+>/etc/inetd.conf</TT
+></DT
+><DD
+><P
+>If the server is to be run by the
+               <B
+CLASS="COMMAND"
+>inetd</B
+> meta-daemon, this file
+               must contain suitable startup information for the
+               meta-daemon. See the <A
+HREF="install.html"
+TARGET="_top"
+>install</A
+> document
+               for details.
+               </P
+></DD
+><DT
+><TT
+CLASS="FILENAME"
+>/etc/rc</TT
+></DT
+><DD
+><P
+>or whatever initialization script your
+               system uses).</P
+><P
+>If running the server as a daemon at startup,
+               this file will need to contain an appropriate startup
+               sequence for the server. See the <A
+HREF="install.html"
+TARGET="_top"
+>"How to Install and Test SAMBA"</A
+> document
+               for details.</P
+></DD
+><DT
+><TT
+CLASS="FILENAME"
+>/etc/services</TT
+></DT
+><DD
+><P
+>If running the server via the
+               meta-daemon <B
+CLASS="COMMAND"
+>inetd</B
+>, this file
+               must contain a mapping of service name (e.g., netbios-ssn)
+               to service port (e.g., 139) and protocol type (e.g., tcp).
+               See the <A
+HREF="install.html"
+TARGET="_top"
+>"How to Install and Test SAMBA"</A
+>
+               document for details.</P
+></DD
+><DT
+><TT
+CLASS="FILENAME"
+>/usr/local/samba/lib/smb.conf</TT
+></DT
+><DD
+><P
+>This is the default location of 
+               the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> server
+               configuration file. Other common places that systems
+               install this file are <TT
+CLASS="FILENAME"
+>/usr/samba/lib/smb.conf</TT
+>
+               and <TT
+CLASS="FILENAME"
+>/etc/samba/smb.conf</TT
+>.</P
+><P
+>When run as a WINS server (see the
+               <A
+HREF="smb.conf.5.html#WINSSUPPORT"
+TARGET="_top"
+><TT
+CLASS="CONSTANT"
+>wins support</TT
+></A
+>
+               parameter in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> man page),
+               <B
+CLASS="COMMAND"
+>nmbd</B
+>
+               will store the WINS database in the file <TT
+CLASS="FILENAME"
+>wins.dat</TT
+>
+               in the <TT
+CLASS="FILENAME"
+>var/locks</TT
+> directory configured under
+               wherever Samba was configured to install itself.</P
+><P
+>If <B
+CLASS="COMMAND"
+>nmbd</B
+> is acting as a <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>              browse master</I
+></SPAN
+> (see the <A
+HREF="smb.conf.5.html#LOCALMASTER"
+TARGET="_top"
+><TT
+CLASS="CONSTANT"
+>local master</TT
+></A
+>
+               parameter in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+> man page, <B
+CLASS="COMMAND"
+>nmbd</B
+>
+               will store the browsing database in the file <TT
+CLASS="FILENAME"
+>browse.dat
+               </TT
+> in the <TT
+CLASS="FILENAME"
+>var/locks</TT
+> directory
+               configured under wherever Samba was configured to install itself.
+               </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN216"
+></A
+><H2
+>SIGNALS</H2
+><P
+>To shut down an <B
+CLASS="COMMAND"
+>nmbd</B
+> process it is recommended
+       that SIGKILL (-9) <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>NOT</I
+></SPAN
+> be used, except as a last
+       resort, as this may leave the name database in an inconsistent state.
+       The correct way to terminate <B
+CLASS="COMMAND"
+>nmbd</B
+> is to send it
+       a SIGTERM (-15) signal and wait for it to die on its own.</P
+><P
+><B
+CLASS="COMMAND"
+>nmbd</B
+> will accept SIGHUP, which will cause
+       it to dump out its namelists into the file <TT
+CLASS="FILENAME"
+>namelist.debug
+       </TT
+> in the <TT
+CLASS="FILENAME"
+>/usr/local/samba/var/locks</TT
+>
+       directory (or the <TT
+CLASS="FILENAME"
+>var/locks</TT
+> directory configured
+       under wherever Samba was configured to install itself). This will also
+       cause <B
+CLASS="COMMAND"
+>nmbd</B
+> to dump out its server database in
+       the <TT
+CLASS="FILENAME"
+>log.nmb</TT
+> file.</P
+><P
+>The debug log level of nmbd may be raised or lowered
+       using <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smbcontrol</SPAN
+>(1)</SPAN
+> (SIGUSR[1|2] signals
+       are no longer used since Samba 2.2). This is to allow
+       transient problems to be diagnosed, whilst still running 
+       at a normally low log level.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN233"
+></A
+><H2
+>VERSION</H2
+><P
+>This man page is correct for version 3.0 of 
+       the Samba suite.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN236"
+></A
+><H2
+>SEE ALSO</H2
+><P
+>      <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>inetd</SPAN
+>(8)</SPAN
+>, <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smbd</SPAN
+>(8)</SPAN
+>, <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
+>, <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smbclient</SPAN
+>(1)</SPAN
+>, <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>testparm</SPAN
+>(1)</SPAN
+>, <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>testprns</SPAN
+>(1)</SPAN
+>, and the Internet 
+       RFC's <TT
+CLASS="FILENAME"
+>rfc1001.txt</TT
+>, <TT
+CLASS="FILENAME"
+>rfc1002.txt</TT
+>. 
+       In addition the CIFS (formerly SMB) specification is available 
+       as a link from the Web page <A
+HREF="http://samba.org/cifs/"
+TARGET="_top"
+> 
+       http://samba.org/cifs/</A
+>.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN260"
+></A
+><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. 
+       The man page sources were converted to YODL format (another 
+       excellent piece of Open Source software, available at <A
+HREF="ftp://ftp.icce.rug.nl/pub/unix/"
+TARGET="_top"
+>      ftp://ftp.icce.rug.nl/pub/unix/</A
+>) 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.</P
+></DIV
+></BODY
+></HTML
+>
\ No newline at end of file