Ignore:
Timestamp:
May 23, 2008, 6:56:41 AM (17 years ago)
Author:
Paul Smedley
Message:

Update source to 3.0.29

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.0/docs/htmldocs/manpages/nmbd.8.html

    r44 r134  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nmbd</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="nmbd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>nmbd &#8212; NetBIOS name server to provide NetBIOS
    2         over IP naming services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmbd</code> [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d &lt;debug level&gt;] [-H &lt;lmhosts file&gt;] [-l &lt;log directory&gt;] [-p &lt;port number&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id259605"></a><h2>DESCRIPTION</h2><p>This program is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">nmbd</code> is a server that understands
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nmbd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="nmbd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>nmbd &#8212; NetBIOS name server to provide NetBIOS
     2        over IP naming services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmbd</code> [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d &lt;debug level&gt;] [-H &lt;lmhosts file&gt;] [-l &lt;log directory&gt;] [-p &lt;port number&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id282811"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">nmbd</code> is a server that understands
    33        and can reply to NetBIOS over IP name service requests, like
    44        those produced by SMB/CIFS clients such as Windows 95/98/ME,
     
    1212        is running on.  Its "own NetBIOS name" is by
    1313        default the primary DNS name of the host it is running on,
    14         but this can be overridden by the <a class="indexterm" name="id259397"></a>netbios name
     14        but this can be overridden by the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a>
    1515        in <code class="filename">smb.conf</code>. Thus <code class="literal">nmbd</code> will
    1616        reply to broadcast queries for its own name(s). Additional
    1717        names for <code class="literal">nmbd</code> to respond on can be set
    18         via parameters in the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> configuration file.</p><p><code class="literal">nmbd</code> can also be used as a WINS
     18        via parameters in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> configuration file.</p><p><code class="literal">nmbd</code> can also be used as a WINS
    1919        (Windows Internet Name Server) server. What this basically means
    2020        is that it will act as a WINS database server, creating a
     
    2323        proxy, relaying broadcast queries from clients that do
    2424        not understand how to talk the WINS protocol to a WINS
    25         server.</p></div><div class="refsect1" lang="en"><a name="id260369"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
     25        server.</p></div><div class="refsect1" lang="en"><a name="id283029"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
    2626                <code class="literal">nmbd</code> to operate as a daemon. That is,
    2727                it detaches itself and runs in the background, fielding
     
    5252                file is a list of NetBIOS names to IP addresses that
    5353                is loaded by the nmbd server and used via the name
    54                 resolution mechanism <a class="indexterm" name="id260151"></a>name resolve order described in <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> to resolve any
     54                resolution mechanism <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER">name resolve order</a> described in <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> to resolve any
    5555                NetBIOS name queries needed by the server. Note
    5656                that the contents of this file are <span class="emphasis"><em>NOT</em></span>
     
    6161                are <code class="filename">/usr/local/samba/lib/lmhosts</code>,
    6262                <code class="filename">/usr/samba/lib/lmhosts</code> or
    63                 <code class="filename">/etc/samba/lmhosts</code>. See the <a href="lmhosts.5.html"><span class="citerefentry"><span class="refentrytitle">lmhosts</span>(5)</span></a> man page for details on the contents of this file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    64 </p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    65 configuration details required by the server.  The
    66 information in this file includes server-specific
    67 information such as what printcap file to use, as well
    68 as descriptions of all the services that the server is
    69 to provide. See <code class="filename">smb.conf</code> for more information.
    70 The default configuration file name is determined at
    71 compile time.</p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
    72 from 0 to 10.  The default value if this parameter is
    73 not specified is zero.</p><p>The higher this value, the more detail will be
     63                <code class="filename">/etc/samba/lmhosts</code>. See the <a class="citerefentry" href="lmhosts.5.html"><span class="citerefentry"><span class="refentrytitle">lmhosts</span>(5)</span></a> man page for details on the contents of this file.</p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
     64from 0 to 10. The default value if this parameter is
     65not specified is 0.</p><p>The higher this value, the more detail will be
    7466logged to the log files about the activities of the
    7567server. At level 0, only critical errors and serious
     
    8173use only by developers and generate HUGE amounts of log
    8274data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    83 override the <a class="indexterm" name="id300494"></a> parameter
    84 in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-l|--logfile=logdirectory</span></dt><dd><p>Base directory name for log/debug files. The extension
     75override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     76in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
     77</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
     78configuration details required by the server.  The
     79information in this file includes server-specific
     80information such as what printcap file to use, as well
     81as descriptions of all the services that the server is
     82to provide. See <code class="filename">smb.conf</code> for more information.
     83The default configuration file name is determined at
     84compile time.</p></dd><dt><span class="term">-l|--log-basename=logdirectory</span></dt><dd><p>Base directory name for log/debug files. The extension
    8585<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    8686log.smbd, etc...). The log file is never removed by the client.
     
    8989                that <code class="literal">nmbd</code> responds to name queries on. Don't
    9090                use this option unless you are an expert, in which case you
    91                 won't need help!</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300546"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
     91                won't need help!</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id324682"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
    9292                <code class="literal">inetd</code> meta-daemon, this file
    9393                must contain suitable startup information for the
     
    101101                to service port (e.g., 139) and protocol type (e.g., tcp).
    102102                </p></dd><dt><span class="term"><code class="filename">/usr/local/samba/lib/smb.conf</code></span></dt><dd><p>This is the default location of
    103                 the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> server
     103                the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> server
    104104                configuration file. Other common places that systems
    105105                install this file are <code class="filename">/usr/samba/lib/smb.conf</code>
    106106                and <code class="filename">/etc/samba/smb.conf</code>.</p><p>When run as a WINS server (see the
    107                         <a class="indexterm" name="id300653"></a>wins support
    108                 parameter in the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page),
     107                        <a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support</a>
     108                parameter in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page),
    109109                <code class="literal">nmbd</code>
    110110                will store the WINS database in the file <code class="filename">wins.dat</code>
    111111                in the <code class="filename">var/locks</code> directory configured under
    112112                wherever Samba was configured to install itself.</p><p>If <code class="literal">nmbd</code> is acting as a <span class="emphasis"><em>
    113                                 browse master</em></span> (see the <a class="indexterm" name="id300700"></a>local master
    114                 parameter in the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page, <code class="literal">nmbd</code>
     113                                browse master</em></span> (see the <a class="link" href="smb.conf.5.html#LOCALMASTER">local master</a>
     114                parameter in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page, <code class="literal">nmbd</code>
    115115                will store the browsing database in the file <code class="filename">browse.dat
    116116                </code> in the <code class="filename">var/locks</code> directory
    117117                configured under wherever Samba was configured to install itself.
    118                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300739"></a><h2>SIGNALS</h2><p>To shut down an <code class="literal">nmbd</code> process it is recommended
     118                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id324858"></a><h2>SIGNALS</h2><p>To shut down an <code class="literal">nmbd</code> process it is recommended
    119119        that SIGKILL (-9) <span class="emphasis"><em>NOT</em></span> be used, except as a last
    120120        resort, as this may leave the name database in an inconsistent state.
     
    127127        cause <code class="literal">nmbd</code> to dump out its server database in
    128128        the <code class="filename">log.nmb</code> file.</p><p>The debug log level of nmbd may be raised or lowered
    129         using <a href="smbcontrol.1.html"><span class="citerefentry"><span class="refentrytitle">smbcontrol</span>(1)</span></a> (SIGUSR[1|2] signals
     129        using <a class="citerefentry" href="smbcontrol.1.html"><span class="citerefentry"><span class="refentrytitle">smbcontrol</span>(1)</span></a> (SIGUSR[1|2] signals
    130130        are no longer used since Samba 2.2). This is to allow
    131131        transient problems to be diagnosed, whilst still running
    132         at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id300819"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    133         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300829"></a><h2>SEE ALSO</h2><p>
    134         <a href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the Internet
     132        at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id324930"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     133        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id324940"></a><h2>SEE ALSO</h2><p>
     134        <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the Internet
    135135        RFC's <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    136136        In addition the CIFS (formerly SMB) specification is available
    137         as a link from the Web page <a href="http://samba.org/cifs/" target="_top">
    138         http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id300907"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     137        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
     138        http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id325013"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    139139        were created by Andrew Tridgell. Samba is now developed
    140140        by the Samba Team as an Open Source project similar
    141141        to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer.
    142142        The man page sources were converted to YODL format (another
    143         excellent piece of Open Source software, available at <a href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
     143        excellent piece of Open Source software, available at <a class="ulink" href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
    144144        ftp://ftp.icce.rug.nl/pub/unix/</a>) and updated for the Samba 2.0
    145145        release by Jeremy Allison.  The conversion to DocBook for
Note: See TracChangeset for help on using the changeset viewer.