summaryrefslogtreecommitdiff
path: root/docs/htmldocs/nmbd.8.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/nmbd.8.html')
-rw-r--r--docs/htmldocs/nmbd.8.html206
1 files changed, 206 insertions, 0 deletions
diff --git a/docs/htmldocs/nmbd.8.html b/docs/htmldocs/nmbd.8.html
new file mode 100644
index 0000000000..e922434430
--- /dev/null
+++ b/docs/htmldocs/nmbd.8.html
@@ -0,0 +1,206 @@
+
+
+
+
+
+<html><head><title>nmbd</title>
+
+<link rev="made" href="mailto:samba-bugs@samba.anu.edu.au">
+</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#minuso">-o</a>] [<a href="nmbd.8.html#minusa">-a</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>] [<a href="nmbd.8.html#minush">-h</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, this program 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 overriden with the <strong>-n</strong> option (see <em>OPTIONS</em> below). Thus
+nmbd will reply to broadcast queries for its own name(s). Additional
+names for nmbd to respond on can be set via parameters in the
+<strong>smb.conf (5)</strong> configuration file.
+<p><br>nmbd 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, nmbd 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 the server to operate
+as a daemon. That is, it detaches itself and runs in the background,
+fielding requests on the appropriate port. By default, the server 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 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
+<em>name resolve order</em> described in <strong>smbd.conf (5)</strong> to resolve any
+NetBIOS name queries needed by the server. Note that the contents of
+this file are <em>NOT</em> used by nmbd 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 <strong>lmhosts
+(5)</strong> 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 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
+nmbd 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 the server 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><a name="minush"></a>
+<li><strong><strong>-h</strong></strong> Prints the help information (usage) for nmbd.
+<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 initialisation 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 <em>smb.conf</em> 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 nmbd 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 inconsistant state. The correct way to terminate
+nmbd is to send it a SIGTERM (-15) signal and wait for it to die on
+its own.
+<p><br>nmbd will accept SIGHUP, which will cause it to dump out it's
+namelists into the file namelist.debug 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 nmbd to dump out it's server database in
+the log.nmb file. In addition, the 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.anu.edu.au/cifs/">http://samba.anu.edu.au/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 (samba-bugs@samba.anu.edu.au). 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) and updated for the Samba2.0 release by Jeremy
+Allison, <a href="mailto:samba-bugs@samba.anu.edu.au"><em>samba-bugs@samba.anu.edu.au</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>