summaryrefslogtreecommitdiff
path: root/docs/yodldocs/nmbd.8.yo
diff options
context:
space:
mode:
Diffstat (limited to 'docs/yodldocs/nmbd.8.yo')
-rw-r--r--docs/yodldocs/nmbd.8.yo232
1 files changed, 0 insertions, 232 deletions
diff --git a/docs/yodldocs/nmbd.8.yo b/docs/yodldocs/nmbd.8.yo
deleted file mode 100644
index c9031c0e6a..0000000000
--- a/docs/yodldocs/nmbd.8.yo
+++ /dev/null
@@ -1,232 +0,0 @@
-mailto(samba@samba.org)
-
-manpage(nmbd)(8)(23 Oct 1998)(Samba)(SAMBA)
-
-label(NAME)
-manpagename(nmbd)(NetBIOS name server to provide NetBIOS over IP
-naming services to clients)
-
-label(SYNOPSIS)
-manpagesynopsis()
-
-bf(nmbd) [link(-D)(minusD)] [link(-a)(minusa)] [link(-o)(minuso)] [link(-h)(minush)] [link(-V)(minusV)] [link(-H lmhosts file)(minusH)] [link(-d debuglevel)(minusd)] [link(-l log file basename)(minusl)] [link(-n primary NetBIOS name)(minusn)] [link(-p port number)(minusp)] [link(-s configuration file)(minuss)]
-
-label(DESCRIPTION)
-manpagedescription()
-
-This program is part of the bf(Samba) suite.
-
-bf(nmbd) 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.
-
-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.
-
-Amongst other services, bf(nmbd) 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 bf(-n) option (see link(OPTIONS)(OPTIONS) below). Thus
-bf(nmbd) will reply to broadcast queries for its own name(s). Additional
-names for bf(nmbd) to respond on can be set via parameters in the
-url(bf(smb.conf(5)))(smb.conf.5.html) configuration file.
-
-bf(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.
-
-In addition, bf(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.
-
-label(OPTIONS)
-manpageoptions()
-
-startdit()
-
-label(minusD)
-dit(bf(-D)) If specified, this parameter causes bf(nmbd) to operate
-as a daemon. That is, it detaches itself and runs in the background,
-fielding requests on the appropriate port. By default, bf(nmbd) will
-NOT operate as a daemon. nmbd can also be operated from the inetd
-meta-daemon, although this is not recommended.
-
-label(minusa)
-dit(bf(-a)) If this parameter is specified, each new connection will
-append log messages to the log file. This is the default.
-
-label(minuso)
-dit(bf(-o)) If this parameter is specified, the log files will be
-overwritten when opened. By default, the log files will be appended
-to.
-
-label(minush)
-dit(bf(-h)) Prints the help information (usage) for bf(nmbd).
-
-label(minusV)
-dit(bf(-V)) Prints the version number for bf(nmbd).
-
-label(minusH)
-dit(bf(-H filename)) 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
-url(bf(name resolve order))(smb.conf.5.html#nameresolveorder) described in
-url(bf(smb.conf (5)))(smb.conf.5.html) to resolve any
-NetBIOS name queries needed by the server. Note that the contents of
-this file are em(NOT) used by bf(nmbd) to answer any name queries. Adding
-a line to this file affects name NetBIOS resolution from this host
-em(ONLY).
-
-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(/usr/samba/lib/lmhosts) or em(/etc/lmhosts). See the
-url(bf(lmhosts (5)))(lmhosts.5.html) man page for details on the contents of this file.
-
-label(minusd)
-dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10.
-
-The default value if this parameter is not specified is zero.
-
-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.
-
-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.
-
-Note that specifying this parameter here will override the url(bf(log
-level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
-(5)))(smb.conf.5.html) file.
-
-label(minusl)
-dit(bf(-l logfile)) The bf(-l) 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.
-
-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(/usr/samba/var/log.nmb) or em(/var/log/log.nmb).
-
-label(minusn)
-dit(bf(-n primary NetBIOS name)) This option allows you to override
-the NetBIOS name that Samba uses for itself. This is identical to
-setting the url(bf(NetBIOS name))(smb.conf.5.html#netbiosname) parameter
-in the url(bf(smb.conf))(smb.conf.5.html) file
-but will override the setting in the url(bf(smb.conf))(smb.conf.5.html) file.
-
-label(minusp)
-dit(bf(-p UDP port number)) UDP port number is a positive integer value.
-
-This option changes the default UDP port number (normally 137) that
-bf(nmbd) responds to name queries on. Don't use this option unless you are
-an expert, in which case you won't need help!
-
-label(minuss)
-dit(bf(-s configuration file)) The default configuration file name is
-set at build time, typically as em(/usr/local/samba/lib/smb.conf), but
-this may be changed when Samba is autoconfigured.
-
-The file specified contains the configuration details required by the
-server. See url(bf(smb.conf (5)))(smb.conf.5.html) for more information.
-
-endit()
-
-label(FILES)
-manpagefiles()
-
-bf(/etc/inetd.conf)
-
-If the server is to be run by the inetd meta-daemon, this file must
-contain suitable startup information for the meta-daemon.
-
-bf(/etc/rc)
-
-(or whatever initialization script your system uses).
-
-If running the server as a daemon at startup, this file will need to
-contain an appropriate startup sequence for the server.
-
-bf(/usr/local/samba/lib/smb.conf)
-
-This is the default location of the
-url(bf(smb.conf))(smb.conf.5.html) server configuration
-file. Other common places that systems install this file are
-em(/usr/samba/lib/smb.conf) and em(/etc/smb.conf).
-
-When run as a bf(WINS) server (see the url(bf(wins support))(smb.conf.5.html#winssupport)
-parameter in the url(bf(smb.conf (5)))(smb.conf.5.html) man page), bf(nmbd) will
-store the WINS database in the file tt(wins.dat) in the tt(var/locks) directory
-configured under wherever Samba was configured to install itself.
-
-If bf(nmbd) is acting as a bf(browse master) (see the url(bf(local master))(smb.conf.5.html#localmaster)
-parameter in the url(bf(smb.conf (5)))(smb.conf.5.html) man page), bf(nmbd) will
-store the browsing database in the file tt(browse.dat) in the tt(var/locks) directory
-configured under wherever Samba was configured to install itself.
-
-label(SIGNALS)
-manpagesection(SIGNALS)
-
-To shut down an bf(nmbd) process it is recommended that SIGKILL (-9)
-em(NOT) be used, except as a last resort, as this may leave the name
-database in an inconsistent state. The correct way to terminate
-bf(nmbd) is to send it a SIGTERM (-15) signal and wait for it to die on
-its own.
-
-bf(nmbd) will accept SIGHUP, which will cause it to dump out it's
-namelists into the file tt(namelist.debug) in the
-em(/usr/local/samba/var/locks) directory (or the em(var/locks)
-directory configured under wherever Samba was configured to install
-itself). This will also cause bf(nmbd) 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 (tt(kill -USR1 <nmbd-pid>)) and lowered by sending it a
-SIGUSR2 (tt(kill -USR2 <nmbd-pid>)). This is to allow transient
-problems to be diagnosed, whilst still running at a normally low log
-level.
-
-label(VERSION)
-manpagesection(VERSION)
-
-This man page is correct for version 2.0 of the Samba suite.
-
-label(SEEALSO)
-manpageseealso()
-
-bf(inetd (8)), url(bf(smbd (8)))(smbd.8.html), url(bf(smb.conf
-(5)))(smb.conf.5.html), url(bf(smbclient (1)))(smbclient.1.html),
-url(bf(testparm (1)))(testparm.1.html), url(bf(testprns
-(1)))(testprns.1.html), and the Internet RFC's bf(rfc1001.txt),
-bf(rfc1002.txt). In addition the CIFS (formerly SMB) specification is
-available as a link from the Web page :
-url(http://samba.org/cifs/)(http://samba.org/cifs/).
-
-label(AUTHOR)
-manpageauthor()
-
-The original Samba software and related utilities were created by
-Andrew Tridgell email(samba@samba.org). Samba is now developed
-by the Samba Team as an Open Source project similar to the way the
-Linux kernel is developed.
-
-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
-url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
-and updated for the Samba2.0 release by Jeremy Allison.
-email(samba@samba.org).
-
-See url(bf(samba (7)))(samba.7.html) to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc.