docs/manpages/lmhosts.5

   1 .TH "lmhosts " "5" "23 Oct 1998" "Samba" "SAMBA"
   2 .PP
   3 .SH "NAME"
   4 lmhosts \- The Samba NetBIOS hosts file
   5 .PP
   6 .SH "SYNOPSIS"
   7 .PP
   8 lmhosts is the \fBSamba\fP NetBIOS name to IP address mapping file\&.
   9 .PP
  10 .SH "DESCRIPTION"
  11 .PP
  12 This file is part of the \fBSamba\fP suite\&.
  13 .PP
  14 \fBlmhosts\fP is the \fBSamba\fP NetBIOS name to IP address mapping file\&.  It
  15 is very similar to the \fB/etc/hosts\fP file format, except that the
  16 hostname component must correspond to the NetBIOS naming format\&.
  17 .PP
  18 .SH "FILE FORMAT"
  19 .PP
  20 It is an ASCII file containing one line for NetBIOS name\&. The two
  21 fields on each line are separated from each other by white space\&. Any
  22 entry beginning with # is ignored\&. Each line in the lmhosts file
  23 contains the following information :
  24 .PP
  25 .IP
  26 .IP o
  27 \fBIP Address\fP - in dotted decimal format\&.
  28 .IP
  29 .IP o
  30 \fBNetBIOS Name\fP - This name format is a maximum fifteen
  31 character host name, with an optional trailing \f(CW\'#\'\fP character
  32 followed by the NetBIOS name type as two hexadecimal digits\&.
  33 .IP
  34 If the trailing \f(CW\'#\'\fP is omitted then the given IP address will be
  35 returned for all names that match the given name, whatever the NetBIOS
  36 name type in the lookup\&.
  37 .IP
  38 .PP
  39 An example follows :
  40 .PP
  41 #
  42 .br
  43 # Sample Samba lmhosts file\&.
  44 .br
  45 #
  46 .br
  47 192\&.9\&.200\&.1       TESTPC
  48 .br
  49 192\&.9\&.200\&.20      NTSERVER#20
  50 .br
  51 192\&.9\&.200\&.21      SAMBASERVER
  52 .br
  53 .PP
  54 Contains three IP to NetBIOS name mappings\&. The first and third will
  55 be returned for any queries for the names \f(CW"TESTPC"\fP and
  56 \f(CW"SAMBASERVER"\fP respectively, whatever the type component of the
  57 NetBIOS name requested\&.
  58 .PP
  59 The second mapping will be returned only when the \f(CW"0x20"\fP name type
  60 for a name \f(CW"NTSERVER"\fP is queried\&. Any other name type will not be
  61 resolved\&.
  62 .PP
  63 The default location of the \fBlmhosts\fP file is in the same directory
  64 as the \fBsmb\&.conf\fP file\&.
  65 .PP
  66 .SH "VERSION"
  67 .PP
  68 This man page is correct for version 2\&.0 of the Samba suite\&.
  69 .PP
  70 .SH "SEE ALSO"
  71 .PP
  72 \fBsmb\&.conf (5)\fP,
  73 \fBsmbclient (1)\fP,
  74 \fBsmbpasswd (8)\fP, \fBsamba (7)\fP\&.
  75 .PP
  76 .SH "AUTHOR"
  77 .PP
  78 The original Samba software and related utilities were created by
  79 Andrew Tridgell samba@samba\&.org\&. Samba is now developed
  80 by the Samba Team as an Open Source project similar to the way the
  81 Linux kernel is developed\&.
  82 .PP
  83 The original Samba man pages were written by Karl Auer\&. The man page
  84 sources were converted to YODL format (another excellent piece of Open
  85 Source software, available at
  86 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
  87 and updated for the Samba2\&.0 release by Jeremy Allison\&.
  88 samba@samba\&.org\&.
  89 .PP
  90 See \fBsamba (7)\fP to find out how to get a full
  91 list of contributors and details on how to submit bug reports,
  92 comments etc\&.