+<!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.57"></HEAD
+CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
ALINK="#0000FF"
><H1
><A
-NAME="NMBD"
->nmbd</A
-></H1
+NAME="NMBD.8"
+></A
+>nmbd</H1
><DIV
CLASS="REFNAMEDIV"
><A
><P
><B
CLASS="COMMAND"
->smbd</B
-> [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log file>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P
+>nmbd</B
+> [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN23"
+NAME="AEN25"
></A
><H2
>DESCRIPTION</H2
><P
->This program is part of the Samba suite.</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 SMBD/CIFS clients such as Windows 95/98/ME,
- Windows NT, Windows 2000, and LanManager clients. It also
+ 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
+ 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
> 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
+ 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 <I
+ but this can be overridden with the <SPAN
+CLASS="emphasis"
+><I
CLASS="EMPHASIS"
>-n</I
+></SPAN
>
option (see OPTIONS below). Thus <B
CLASS="COMMAND"
CLASS="COMMAND"
>nmbd</B
> to respond on can be set
- via parameters in the <A
-HREF="smb.conf.5.html"
-TARGET="_top"
-><TT
-CLASS="FILENAME"
-> smb.conf(5)</TT
-></A
+ via parameters in the <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
> configuration file.</P
><P
><B
>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 WIN
+ not understand how to talk the WINS protocol to a WINS
server.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN40"
+NAME="AEN46"
></A
><H2
>OPTIONS</H2
</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
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
resolution mechanism <A
HREF="smb.conf.5.html#nameresolveorder"
TARGET="_top"
-> name resolve order</A
-> described in <A
-HREF="smb.conf.5.html"
-TARGET="_top"
-> <TT
-CLASS="FILENAME"
->smb.conf(5)</TT
+><TT
+CLASS="PARAMETER"
+><I
+>name resolve
+ order</I
+></TT
></A
->
- to resolve any NetBIOS name queries needed by the server. Note
- that the contents of this file are <I
+> 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 <I
+ from this host <SPAN
+CLASS="emphasis"
+><I
CLASS="EMPHASIS"
>ONLY</I
+></SPAN
>.</P
><P
>The default path to this file is compiled into
> or
<TT
CLASS="FILENAME"
->/etc/lmhosts</TT
->. See the <A
-HREF="lmhosts.5.html"
-TARGET="_top"
-> <TT
-CLASS="FILENAME"
->lmhosts(5)</TT
-></A
-> man page for details on the
- contents of this file.</P
+>/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
the <A
HREF="smb.conf.5.html#loglevel"
TARGET="_top"
->log level</A
->
- parameter in the <A
-HREF="smb.conf.5.html"
-TARGET="_top"
><TT
-CLASS="FILENAME"
-> smb.conf</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 <log file></DT
+>-l <log directory></DT
><DD
><P
->The -l parameter specifies a path
- and base filename into which operational data from
- the running <B
+>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 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
-><P
->The default log file path is compiled into Samba as
- part of the build process. Common defaults are <TT
+>
+ 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
<TT
CLASS="FILENAME"
>/var/log/log.nmb</TT
->.</P
+>. <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 <primary NetBIOS name></DT
to setting the <A
HREF="smb.conf.5.html#netbiosname"
TARGET="_top"
-> NetBIOS name</A
-> parameter in the <A
-HREF="smb.conf.5.html"
-TARGET="_top"
->
- <TT
-CLASS="FILENAME"
->smb.conf</TT
+><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
- <TT
-CLASS="FILENAME"
->smb.conf</TT
+ <SPAN
+CLASS="CITEREFENTRY"
+><SPAN
+CLASS="REFENTRYTITLE"
+>smb.conf</SPAN
+>(5)</SPAN
>.</P
></DD
><DT
><DD
><P
>UDP port number is a positive integer value.
- This option changes the default UDP port number (normally 137)
+ 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
+> 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 <configuration file></DT
><DD
><P
->The default configuration file name
+>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 <A
-HREF="smb.conf.5.html"
-TARGET="_top"
->
- <TT
-CLASS="FILENAME"
->smb.conf(5)</TT
-></A
+>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
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN125"
+NAME="AEN162"
></A
><H2
>FILES</H2
></DT
><DD
><P
->If the server is to be run by the
+>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 section INSTALLATION below.
+> 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
></DT
><DD
><P
->or whatever initialization script your
+>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 section INSTALLATION
- below.</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
></DT
><DD
><P
->If running the server via the
+>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 section INSTALLATION below.</P
+>, 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
></DT
><DD
><P
->This is the default location of the
- <A
-HREF="smb.conf.5.html"
-TARGET="_top"
-><TT
-CLASS="FILENAME"
->smb.conf</TT
-></A
->
- server configuration file. Other common places that systems
+>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/smb.conf</TT
+>/etc/samba/smb.conf</TT
>.</P
><P
->When run as a WINS server (see the
+>When run as a WINS server (see the
<A
-HREF="smb.conf.5.html#winssupport"
-TARGET="_top"
->wins support</A
->
- parameter in the <A
-HREF="smb.conf.5.html"
+HREF="smb.conf.5.html#WINSSUPPORT"
TARGET="_top"
><TT
-CLASS="FILENAME"
-> smb.conf(5)</TT
+CLASS="CONSTANT"
+>wins support</TT
></A
-> man page), <B
+>
+ 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
+> directory configured under
wherever Samba was configured to install itself.</P
><P
>If <B
CLASS="COMMAND"
>nmbd</B
-> is acting as a <I
+> 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"
->local master</A
->
- parameter in the <A
-HREF="smb.conf.5.html"
+HREF="smb.conf.5.html#LOCALMASTER"
TARGET="_top"
><TT
-CLASS="FILENAME"
-> smb.conf(5)</TT
+CLASS="CONSTANT"
+>local master</TT
></A
-> man page), <B
+>
+ 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
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN171"
+NAME="AEN216"
></A
><H2
>SIGNALS</H2
>To shut down an <B
CLASS="COMMAND"
>nmbd</B
-> process it is recommended
- that SIGKILL (-9) <I
+> process it is recommended
+ that SIGKILL (-9) <SPAN
+CLASS="emphasis"
+><I
CLASS="EMPHASIS"
>NOT</I
-> be used, except as a last
- resort, as this may leave the name database in an inconsistent state.
+></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
+> 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 it's namelists into the file <TT
+> 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
+> directory configured
+ under wherever Samba was configured to install itself). This will also
cause <B
CLASS="COMMAND"
>nmbd</B
-> to dump out it's server database in
+> to dump out its server database in
the <TT
CLASS="FILENAME"
>log.nmb</TT
-> file. In addition, the debug log level
- of nmbd may be raised by sending it a SIGUSR1 (<B
-CLASS="COMMAND"
->kill -USR1
- <nmbd-pid></B
->) and lowered by sending it a
- SIGUSR2 (<B
-CLASS="COMMAND"
->kill -USR2 <nmbd-pid></B
->). This is to
- allow transient problems to be diagnosed, whilst still running at a
- normally low log level.</P
+> 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="AEN186"
+NAME="AEN233"
></A
><H2
>VERSION</H2
><P
->This man page is correct for version 2.2 of
+>This man page is correct for version 3.0 of
the Samba suite.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN189"
+NAME="AEN236"
></A
><H2
>SEE ALSO</H2
><P
-><B
-CLASS="COMMAND"
->inetd(8)</B
->, <A
-HREF="smbd.8.html"
-TARGET="_top"
-><B
-CLASS="COMMAND"
->smbd(8)</B
-></A
->,
- <A
-HREF="smb.conf.5.html"
-TARGET="_top"
-><TT
-CLASS="FILENAME"
->smb.conf(5)</TT
->
- </A
->, <A
-HREF="smbclient.1.html"
-TARGET="_top"
-><B
-CLASS="COMMAND"
->smbclient(1)
- </B
-></A
->, <A
-HREF="testparm.1.html"
-TARGET="_top"
-><B
-CLASS="COMMAND"
-> testparm(1)</B
-></A
->, <A
-HREF="testprns.1.html"
-TARGET="_top"
-> <B
-CLASS="COMMAND"
->testprns(1)</B
-></A
->, and the Internet RFC's
- <TT
+> <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
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN206"
+NAME="AEN260"
></A
><H2
>AUTHOR</H2
><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
+ 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</P
+ 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
git.samba.org / ira / wip.git / blobdiff