1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD
28 >nmbd -- NetBIOS name server to provide NetBIOS
29 over IP naming services to clients</DIV
31 CLASS="REFSYNOPSISDIV"
41 > [-D] [-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
51 >This program is part of the Samba suite.</P
56 > is a server that understands
57 and can reply to NetBIOS over IP name service requests, like
58 those produced by SMB/CIFS clients such as Windows 95/98/ME,
59 Windows NT, Windows 2000, Windows XP and LanManager clients. It also
60 participates in the browsing protocols which make up the
61 Windows "Network Neighborhood" view.</P
63 >SMB/CIFS clients, when they start up, may wish to
64 locate an SMB/CIFS server. That is, they wish to know what
65 IP number a specified host is using.</P
67 >Amongst other services, <B
71 listen for such requests, and if its own NetBIOS name is
72 specified it will respond with the IP number of the host it
73 is running on. Its "own NetBIOS name" is by
74 default the primary DNS name of the host it is running on,
75 but this can be overridden with the <SPAN
82 option (see OPTIONS below). Thus <B
86 reply to broadcast queries for its own name(s). Additional
90 > to respond on can be set
91 via parameters in the <A
92 HREF="smb.conf.5.html"
98 > configuration file.</P
103 > can also be used as a WINS
104 (Windows Internet Name Server) server. What this basically means
105 is that it will act as a WINS database server, creating a
106 database from name registration requests that it receives and
107 replying to queries from clients for these names.</P
113 proxy, relaying broadcast queries from clients that do
114 not understand how to talk the WINS protocol to a WINS
133 >If specified, this parameter causes
137 > to operate as a daemon. That is,
138 it detaches itself and runs in the background, fielding
139 requests on the appropriate port. By default, <B
143 will operate as a daemon if launched from a command shell.
144 nmbd can also be operated from the <B
148 meta-daemon, although this is not recommended.
155 >If this parameter is specified, each new
156 connection will append log messages to the log file.
157 This is the default.</P
163 >If this parameter is specified it causes the
164 server to run "interactively", not as a daemon, even if the
165 server is executed on the command line of a shell. Setting this
166 parameter negates the implicit daemon mode when run from the
174 >If this parameter is specified, the
175 log files will be overwritten when opened. By default,
179 > will append entries to the log
186 >Prints the help information (usage)
193 >-H <filename></DT
196 >NetBIOS lmhosts file. The lmhosts
197 file is a list of NetBIOS names to IP addresses that
198 is loaded by the nmbd server and used via the name
199 resolution mechanism <A
200 HREF="smb.conf.5.html#nameresolveorder"
202 > name resolve order</A
204 HREF="smb.conf.5.html"
211 to resolve any NetBIOS name queries needed by the server. Note
212 that the contents of this file are <SPAN
222 > to answer any name queries.
223 Adding a line to this file affects name NetBIOS resolution
232 >The default path to this file is compiled into
233 Samba as part of the build process. Common defaults
236 >/usr/local/samba/lib/lmhosts</TT
240 >/usr/samba/lib/lmhosts</TT
247 HREF="lmhosts.5.html"
254 man page for details on the contents of this file.</P
260 >Prints the version number for
267 >-d <debug level></DT
270 >debuglevel is an integer
271 from 0 to 10. The default value if this parameter is
272 not specified is zero.</P
274 >The higher this value, the more detail will
275 be logged to the log files about the activities of the
276 server. At level 0, only critical errors and serious
277 warnings will be logged. Level 1 is a reasonable level for
278 day to day running - it generates a small amount of
279 information about operations carried out.</P
281 >Levels above 1 will generate considerable amounts
282 of log data, and should only be used when investigating
283 a problem. Levels above 3 are designed for use only by developers
284 and generate HUGE amounts of log data, most of which is extremely
287 >Note that specifying this parameter here will override
289 HREF="smb.conf.5.html#loglevel"
294 HREF="smb.conf.5.html"
303 >-l <log directory></DT
306 >The -l parameter specifies a directory
307 into which the "log.nmbd" log file will be created
308 for operational data from the running <B
312 server. The default log directory is compiled into Samba
313 as part of the build process. Common defaults are <TT
315 > /usr/local/samba/var/log.nmb</TT
318 > /usr/samba/var/log.nmb</TT
322 >/var/log/log.nmb</TT
330 If the directory specified does not exist, <B
334 will log to the default debug log location defined at compile time.
338 >-n <primary NetBIOS name></DT
341 >This option allows you to override
342 the NetBIOS name that Samba uses for itself. This is identical
344 HREF="smb.conf.5.html#netbiosname"
347 > parameter in the <A
348 HREF="smb.conf.5.html"
355 > file. However, a command
356 line setting will take precedence over settings in
363 >-p <UDP port number></DT
366 >UDP port number is a positive integer value.
367 This option changes the default UDP port number (normally 137)
371 > responds to name queries on. Don't
372 use this option unless you are an expert, in which case you
376 >-s <configuration file></DT
379 >The default configuration file name
380 is set at build time, typically as <TT
382 > /usr/local/samba/lib/smb.conf</TT
384 this may be changed when Samba is autoconfigured.</P
386 >The file specified contains the configuration details
387 required by the server. See <A
388 HREF="smb.conf.5.html"
394 > for more information.
419 >If the server is to be run by the
423 > meta-daemon, this file
424 must contain suitable startup information for the
425 meta-daemon. See the <A
426 HREF="UNIX_INSTALL.html"
428 >UNIX_INSTALL.html</A
440 >or whatever initialization script your
443 >If running the server as a daemon at startup,
444 this file will need to contain an appropriate startup
445 sequence for the server. See the <A
446 HREF="UNIX_INSTALL.html"
448 >UNIX_INSTALL.html</A
459 >If running the server via the
464 must contain a mapping of service name (e.g., netbios-ssn)
465 to service port (e.g., 139) and protocol type (e.g., tcp).
467 HREF="UNIX_INSTALL.html"
469 >UNIX_INSTALL.html</A
471 document for details.</P
476 >/usr/local/samba/lib/smb.conf</TT
480 >This is the default location of the
482 HREF="smb.conf.5.html"
489 server configuration file. Other common places that systems
490 install this file are <TT
492 >/usr/samba/lib/smb.conf</TT
499 >When run as a WINS server (see the
501 HREF="smb.conf.5.html#WINSSUPPORT"
513 will store the WINS database in the file <TT
520 > directory configured under
521 wherever Samba was configured to install itself.</P
526 > is acting as a <SPAN
533 HREF="smb.conf.5.html#LOCALMASTER"
545 will store the browsing database in the file <TT
553 configured under wherever Samba was configured to install itself.
570 > process it is recommended
571 that SIGKILL (-9) <SPAN
577 > be used, except as a last
578 resort, as this may leave the name database in an inconsistent state.
579 The correct way to terminate <B
583 a SIGTERM (-15) signal and wait for it to die on its own.</P
588 > will accept SIGHUP, which will cause
589 it to dump out its namelists into the file <TT
595 >/usr/local/samba/var/locks</TT
597 directory (or the <TT
600 > directory configured
601 under wherever Samba was configured to install itself). This will also
605 > to dump out its server database in
611 >The debug log level of nmbd may be raised or lowered using
613 HREF="smbcontrol.1.html"
620 > (SIGUSR[1|2] signals are no longer used in Samba 2.2). This is
621 to allow transient problems to be diagnosed, whilst still running
622 at a normally low log level.</P
632 >This man page is correct for version 3.0 of
655 HREF="smb.conf.5.html"
663 HREF="smbclient.1.html"
671 HREF="testparm.1.html"
678 HREF="testprns.1.html"
684 >, and the Internet RFC's
692 In addition the CIFS (formerly SMB) specification is available
693 as a link from the Web page <A
694 HREF="http://samba.org/cifs/"
697 http://samba.org/cifs/</A
708 >The original Samba software and related utilities
709 were created by Andrew Tridgell. Samba is now developed
710 by the Samba Team as an Open Source project similar
711 to the way the Linux kernel is developed.</P
713 >The original Samba man pages were written by Karl Auer.
714 The man page sources were converted to YODL format (another
715 excellent piece of Open Source software, available at
717 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
719 > ftp://ftp.icce.rug.nl/pub/unix/</A
720 >) and updated for the Samba 2.0
721 release by Jeremy Allison. The conversion to DocBook for
722 Samba 2.2 was done by Gerald Carter</P