nmbd man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



NMBD(8)							  NMBD(8)

NAME
       nmbd  -	NetBIOS	 name  server to provide NetBIOS  over IP
       naming services to clients

SYNOPSIS
       smbd [ -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> ]

DESCRIPTION
       This program is part of the Samba suite.

       nmbd is a server that understands and can reply to NetBIOS
       over IP name service  requests,	like  those  produced  by
       SMB/CIFS	 clients  such	as  Windows 95/98/ME, Windows NT,
       Windows 2000, and LanManager clients. It also participates
       in  the browsing protocols which make up the Windows "Net-
       work 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,  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  -n  option  (see OPTIONS 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  smb.conf(5)configuration file.

       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, nmbd can act as a WINS proxy, relaying broad-
       cast  queries  from  clients that do not understand how to
       talk the WINS protocol to a WIN server.

OPTIONS
       -D     If specified, this parameter causes nmbd to operate
	      as  a  daemon. That is, it detaches itself and runs
	      in the background, fielding requests on the  appro-
	      priate  port.  By	 default,  nmbd will operate as a
	      daemon if launched from a command shell.	nmbd  can
	      also   be	 operated  from	 the  inetd  meta-daemon,
	      although this is not recommended.

       -a     If this parameter is specified, each new connection

			   09 July 2001				1

NMBD(8)							  NMBD(8)

	      will  append log messages to the log file.  This is
	      the default.

       -o     If this parameter is specified, the log files  will
	      be  overwritten  when opened. By default, smbd will
	      append entries to the log files.

       -h     Prints the help information (usage) for nmbd.

       -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 mecha-
	      nism   name  resolve  order  to resolve any NetBIOS
	      name queries needed by the server.  Note	that  the
	      contents	of  this  file	are  NOT  used by nmbd to
	      answer any name queries.	Adding	a  line	 to  this
	      file affects name NetBIOS resolution from this host
	      ONLY.

	      The default path to  this	 file  is  compiled  into
	      Samba as part of the build process. Common defaults
	      are		    /usr/local/samba/lib/lmhosts,
	      /usr/samba/lib/lmhosts  or  /etc/lmhosts.	 See  the
	      lmhosts(5)man page for details on the  contents  of
	      this file.

       -V     Prints the version number for nmbd.

       -d <debug level>
	      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  seri-
	      ous  warnings  will be logged. Level 1 is a reason-
	      able level for day to day running - it generates	a
	      small  amount  of information about operations car-
	      ried out.

	      Levels above 1 will generate  considerable  amounts
	      of  log data, and should only be used when investi-
	      gating 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 over-
	      ride  the log level parameter in the  smb.conffile.

       -l <log file>
	      The -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

			   09 July 2001				2

NMBD(8)							  NMBD(8)

	      generated	 by appending the extension ".nmb" to the
	      specified base name. For example, if the name spec-
	      ified 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
	      /usr/local/samba/var/log.nmb,
	      /usr/samba/var/log.nmb or /var/log/log.nmb.

       -n <primary NetBIOS name>
	      This option allows you to override the NetBIOS name
	      that Samba uses for itself. This	is  identical  to
	      setting the  NetBIOS nameparameter in the smb.conf-
	      file. However, a command	line  setting  will  take
	      precedence over settings in smb.conf.

       -p <UDP port number>
	      UDP  port number is a positive integer value.  This
	      option changes the default UDP  port  number  (nor-
	      mally  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!

       -s <configuration file>
	      The default configuration file name is set at build
	      time, typically as   /usr/local/samba/lib/smb.conf,
	      but  this	 may be changed when Samba is autoconfig-
	      ured.

	      The  file	 specified  contains  the   configuration
	      details  required by the server. See smb.conf(5)for
	      more information.

FILES
       /etc/inetd.conf
	      If the server is to be run by the	 inetd	meta-dae-
	      mon, this file must contain suitable startup infor-
	      mation for the meta-daemon. See the section INSTAL-
	      LATION below.

       /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. See the section	INSTALLA-
	      TION below.

       /etc/services
	      If  running  the	server via the meta-daemon inetd,
	      this file must contain a mapping	of  service  name
	      (e.g., netbios-ssn) to service port (e.g., 139) and

			   09 July 2001				3

NMBD(8)							  NMBD(8)

	      protocol type (e.g., tcp).  See the section INSTAL-
	      LATION below.

       /usr/local/samba/lib/smb.conf
	      This is the default location of the smb.conf server
	      configuration file. Other common places  that  sys-
	      tems  install this file are /usr/samba/lib/smb.conf
	      and /etc/smb.conf.

	      When run as a WINS server	 (see  the  wins  support
	      parameter	 in  the  smb.conf(5)man page), nmbd will
	      store the WINS database in the file wins.dat in the
	      var/locks directory configured under wherever Samba
	      was configured to install itself.

	      If nmbd is acting as  a	browse	master	(see  the
	      local   master  parameter	 in  the   smb.conf(5)man
	      page), nmbd will store the browsing database in the
	      file  browse.dat in the var/locks directory config-
	      ured under wherever Samba was configured to install
	      itself.

SIGNALS
       To  shut	 down  an  nmbd	 process  it  is recommended that
       SIGKILL (-9) NOT be used, except as a last resort, as this
       may leave the name database in an inconsistent state.  The
       correct way to terminate nmbd is	 to  send  it  a  SIGTERM
       (-15) signal and wait for it to die on its own.

       nmbd  will  accept SIGHUP, which will cause it to dump out
       its  namelists  into  the  file	namelist.debug	 in   the
       /usr/local/samba/var/locks  directory  (or  the	var/locks
       directory configured under wherever Samba  was  configured
       to  install itself). This will also cause nmbd to dump out
       its server database in the log.nmb file. In addition,  the
       debug  log  level  of  nmbd  may be raised by sending it a
       SIGUSR1 (kill -USR1 <nmbd-pid>) and lowered by sending  it
       a  SIGUSR2 (kill -USR2 <nmbd-pid>). This is to allow tran-
       sient problems to be diagnosed, whilst still running at	a
       normally low log level.

VERSION
       This  man  page	is  correct  for version 2.2 of the Samba
       suite.

SEE ALSO
       inetd(8), smbd(8), smb.conf(5) , smbclient(1)  ,	 and  the
       Internet	 RFC's rfc1001.txt, rfc1002.txt.  In addition the
       CIFS (formerly SMB) specification is available as  a  link
       from	 the	  Web	  page	   http://samba.org/cifs/
       <URL:http://samba.org/cifs/>.

AUTHOR
       The original Samba software  and	 related  utilities  were

			   09 July 2001				4

NMBD(8)							  NMBD(8)

       created	by Andrew Tridgell. 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, avail-
       able	     at		  ftp://ftp.icce.rug.nl/pub/unix/
       <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the
       Samba 2.0 release by Jeremy  Allison.  The  conversion  to
       DocBook for Samba 2.2 was done by Gerald Carter

			   09 July 2001				5

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net