


     NNNNMMMMBBBBDDDD((((8888))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222))))         NNNNMMMMBBBBDDDD((((8888))))



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

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          nnnnmmmmbbbbdddd [ ----DDDD ]  [ ----aaaa ]  [ ----iiii ]  [ ----oooo ]  [ ----PPPP ]  [ ----hhhh ]  [ ----VVVV ]
          [ ----dddd <<<<ddddeeeebbbbuuuugggg lllleeeevvvveeeellll>>>> ]  [ ----HHHH <<<<llllmmmmhhhhoooossssttttssss ffffiiiilllleeee>>>> ]  [ ----llll <<<<lllloooogggg
          ddddiiiirrrreeeeccccttttoooorrrryyyy>>>> ]  [ ----nnnn <<<<pppprrrriiiimmmmaaaarrrryyyy nnnneeeettttbbbbiiiioooossss nnnnaaaammmmeeee>>>> ]  [ ----pppp <<<<ppppoooorrrrtttt
          nnnnuuuummmmbbbbeeeerrrr>>>> ]  [ ----ssss <<<<ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee>>>> ]

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          This program is part of the Samba suite.

          nnnnmmmmbbbbdddd 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 "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, nnnnmmmmbbbbdddd 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 ----nnnn
          option (see OPTIONS below). Thus nnnnmmmmbbbbdddd will reply to
          broadcast queries for its own name(s). Additional names for
          nnnnmmmmbbbbdddd to respond on can be set via parameters in the
          _s_m_b._c_o_n_f(_5) configuration file.

          nnnnmmmmbbbbdddd 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, nnnnmmmmbbbbdddd 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.

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



     Page 1                                          (printed 1/7/103)






     NNNNMMMMBBBBDDDD((((8888))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222))))         NNNNMMMMBBBBDDDD((((8888))))



          ----aaaa   If this parameter is specified, each new connection
               will append log messages to the log file. This is the
               default.

          ----iiii   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 deamon mode
               when run from the command line.

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

          ----hhhh   Prints the help information (usage) for nnnnmmmmbbbbdddd.

          ----HHHH <<<<ffffiiiilllleeeennnnaaaammmmeeee>>>>
               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
               name resolve order described in  _s_m_b._c_o_n_f(_5) to resolve
               any NetBIOS name queries needed by the server. Note
               that the contents of this file are NNNNOOOOTTTT used by nnnnmmmmbbbbdddd to
               answer any name queries. Adding a line to this file
               affects name NetBIOS resolution from this host OOOONNNNLLLLYYYY.

               The default path to this file is compiled into Samba as
               part of the build process. Common defaults are
               /_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_l_i_b/_l_m_h_o_s_t_s, /_u_s_r/_s_a_m_b_a/_l_i_b/_l_m_h_o_s_t_s or
               /_e_t_c/_l_m_h_o_s_t_s. See the  _l_m_h_o_s_t_s(_5) man page for details
               on the contents of this file.

          ----VVVV   Prints the version number for nnnnmmmmbbbbdddd.

          ----dddd <<<<ddddeeeebbbbuuuugggg lllleeeevvvveeeellll>>>>
               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



     Page 2                                          (printed 1/7/103)






     NNNNMMMMBBBBDDDD((((8888))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222))))         NNNNMMMMBBBBDDDD((((8888))))



               the log level parameter in the  _s_m_b._c_o_n_f file.

          ----llll <<<<lllloooogggg ddddiiiirrrreeeeccccttttoooorrrryyyy>>>>
               The -l parameter specifies a directory into which the
               "log.nmbd" log file will be created for operational
               data from the running nnnnmmmmbbbbdddd server. The default log
               directory is compiled into Samba as part of the build
               process. Common defaults are
               /_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_v_a_r/_l_o_g._n_m_b,  /_u_s_r/_s_a_m_b_a/_v_a_r/_l_o_g._n_m_b
               or /_v_a_r/_l_o_g/_l_o_g._n_m_b. BBBBeeeewwwwaaaarrrreeee:::: If the directory specified
               does not exist, nnnnmmmmbbbbdddd will log to the default debug log
               location defined at compile time.

          ----nnnn <<<<pppprrrriiiimmmmaaaarrrryyyy NNNNeeeettttBBBBIIIIOOOOSSSS nnnnaaaammmmeeee>>>>
               This option allows you to override the NetBIOS name
               that Samba uses for itself. This is identical to
               setting the  NetBIOS name parameter in the _s_m_b._c_o_n_f
               file. However, a command line setting will take
               precedence over settings in _s_m_b._c_o_n_f.

          ----pppp <<<<UUUUDDDDPPPP ppppoooorrrrtttt nnnnuuuummmmbbbbeeeerrrr>>>>
               UDP port number is a positive integer value.  This
               option changes the default UDP port number (normally
               137) that nnnnmmmmbbbbdddd responds to name queries on. Don't use
               this option unless you are an expert, in which case you
               won't need help!

          ----ssss <<<<ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee>>>>
               The default configuration file name is set at build
               time, typically as  /_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_l_i_b/_s_m_b._c_o_n_f, but
               this may be changed when Samba is autoconfigured.

               The file specified contains the configuration details
               required by the server. See  _s_m_b._c_o_n_f(_5) for more
               information.

     FFFFIIIILLLLEEEESSSS
          /_e_t_c/_i_n_e_t_d._c_o_n_f
               If the server is to be run by the iiiinnnneeeettttdddd meta-daemon,
               this file must contain suitable startup information for
               the meta-daemon. See the UNIX_INSTALL.html document for
               details.

          /_e_t_c/_r_c
               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 UNIX_INSTALL.html document for
               details.

          /_e_t_c/_s_e_r_v_i_c_e_s



     Page 3                                          (printed 1/7/103)






     NNNNMMMMBBBBDDDD((((8888))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222))))         NNNNMMMMBBBBDDDD((((8888))))



               If running the server via the meta-daemon iiiinnnneeeettttdddd, 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 UNIX_INSTALL.html document
               for details.

          /_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_l_i_b/_s_m_b._c_o_n_f
               This is the default location of the _s_m_b._c_o_n_f server
               configuration file. Other common places that systems
               install this file are /_u_s_r/_s_a_m_b_a/_l_i_b/_s_m_b._c_o_n_f and
               /_e_t_c/_s_m_b._c_o_n_f.

               When run as a WINS server (see the wins support
               parameter in the _s_m_b._c_o_n_f(_5) man page), nnnnmmmmbbbbdddd will store
               the WINS database in the file _w_i_n_s._d_a_t in the _v_a_r/_l_o_c_k_s
               directory configured under wherever Samba was
               configured to install itself.

               If nnnnmmmmbbbbdddd is acting as a  bbbbrrrroooowwwwsssseeee mmmmaaaasssstttteeeerrrr (see the local
               master parameter in the _s_m_b._c_o_n_f(_5) man page, nnnnmmmmbbbbdddd will
               store the browsing database in the file _b_r_o_w_s_e._d_a_t in
               the _v_a_r/_l_o_c_k_s directory configured under wherever Samba
               was configured to install itself.

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

          nnnnmmmmbbbbdddd will accept SIGHUP, which will cause it to dump out its
          namelists into the file _n_a_m_e_l_i_s_t._d_e_b_u_g in the
          /_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_v_a_r/_l_o_c_k_s directory (or the _v_a_r/_l_o_c_k_s
          directory configured under wherever Samba was configured to
          install itself). This will also cause nnnnmmmmbbbbdddd to dump out its
          server database in the _l_o_g._n_m_b file.

          The debug log level of nmbd may be raised or lowered using
          ssssmmmmbbbbccccoooonnnnttttrrrroooollll((((1111))))
           (SIGUSR[1|2] signals are no longer used in Samba 2.2). This
          is to allow transient problems to be diagnosed, whilst still
          running at a normally low log level.

     TTTTRRRROOOOUUUUBBBBLLLLEEEESSSSHHHHOOOOOOOOTTTTIIIINNNNGGGG
          One of the common causes of difficulty when installing Samba
          and SWAT is the existsnece of some type of firewall or port
          filtering software on the Samba server. Make sure that the
          appropriate ports outlined in this man page are available on
          the server and are not currently being blocked by some type
          of security software such as iptables or "port sentry". For
          more troubleshooting information, refer to the additional



     Page 4                                          (printed 1/7/103)






     NNNNMMMMBBBBDDDD((((8888))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222))))         NNNNMMMMBBBBDDDD((((8888))))



          documentation included in the Samba distribution.

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

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          iiiinnnneeeettttdddd((((8888)))), ssssmmmmbbbbdddd((((8888)))) _s_m_b._c_o_n_f(_5)
           ssssmmmmbbbbcccclllliiiieeeennnntttt((((1111))))
           and the Internet RFC's _r_f_c_1_0_0_1._t_x_t, _r_f_c_1_0_0_2._t_x_t. 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/>.

     AAAAUUUUTTTTHHHHOOOORRRR
          The original Samba software and related utilities were
          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, available 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





























     Page 5                                          (printed 1/7/103)



