opensolaris man page for lmhosts

LMHOSTS(4)						   File Formats and Conventions 						LMHOSTS(4)

NAME
       lmhosts - The Samba NetBIOS hosts file

SYNOPSIS
       lmhosts is the samba(7) NetBIOS name to IP address mapping file.

DESCRIPTION
       This file is part of the samba(7) suite.

       lmhosts is the Samba NetBIOS name to IP address mapping file. It is very similar to the /etc/hosts file format, except that the hostname
       component must correspond to the NetBIOS naming format.

FILE FORMAT
       It is an ASCII file containing one line for NetBIOS name. The two fields on each line are separated from each other by white space. Any
       entry beginning with '#' is ignored. Each line in the lmhosts file contains the following information:

       o   IP Address - in dotted decimal format.

       o   NetBIOS Name - This name format is a maximum fifteen character host name, with an optional trailing '#' character followed by the
	   NetBIOS name type as two hexadecimal digits.

	   If the trailing '#' is omitted then the given IP address will be returned for all names that match the given name, whatever the NetBIOS
	   name type in the lookup.

       An example follows:

	   #
	   # Sample Samba lmhosts file.
	   #
	   192.9.200.1	  TESTPC
	   192.9.200.20   NTSERVER#20
	   192.9.200.21   SAMBASERVER

       Contains three IP to NetBIOS name mappings. The first and third will be returned for any queries for the names "TESTPC" and "SAMBASERVER"
       respectively, whatever the type component of the NetBIOS name requested.

       The second mapping will be returned only when the "0x20" name type for a name "NTSERVER" is queried. Any other name type will not be
       resolved.

       The default location of the lmhosts file is in the same directory as the smb.conf(4) file.

FILES
       lmhosts is loaded from the configuration directory. This is usually /etc/samba or /usr/local/samba/lib.

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

SEE ALSO
       smbclient(1), smb.conf(4), and smbpasswd(1M)

AUTHOR
       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/) and updated for the Samba 2.0 release by Jeremy Allison. The conversion to
       DocBook for Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 was done by Alexander Bokovoy.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+----------------------+
       |  ATTRIBUTE TYPE    |	ATTRIBUTE VALUE    |
       +--------------------+----------------------+
       |Availability	    | SUNWsmbar, SUNWsmbau |
       +--------------------+----------------------+
       |Interface Stability | External		   |
       +--------------------+----------------------+
NOTES
       Source for Samba is available on http://opensolaris.org.

       Samba(7) delivers the set of four SMF(5) services as can be seen from the following example:

	    $ svcs samba wins winbind swat
	   STATE	  STIME    FMRI
	   disabled	  Apr_21   svc:/network/samba:default
	   disabled	  Apr_21   svc:/network/winbind:default
	   disabled	  Apr_21   svc:/network/wins:default
	   disabled	  Apr_21   svc:/network/swat:default

       where the services are:

	"samba"
	   runs the smbd daemon managing the CIFS sessions

	"wins"
	   runs the nmbd daemon enabling the browsing (WINS)

	"winbind"
	   runs the winbindd daemon making the domain idmap

	"swat"
	   Samba Web Administration Tool is a service providing access to browser-based Samba administration interface and on-line documentation.
	   The service runs on software loopback network interface on port 901/tcp, i.e. opening "http://localhost:901/" in browser will access
	   the SWAT service on local machine.

       Please note: SWAT uses HTTP Basic Authentication scheme where user name and passwords are sent over the network in clear text. In the SWAT
       case the user name is root. Transferring such sensitive data is advisable only on the software loopback network interface or over secure
       networks.

Samba 3.0							    01/19/2009								LMHOSTS(4)