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 lmhosts 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 .DS
  43
  44
  45
  46 #
  47 # Sample Samba lmhosts file\&.
  48 #
  49 192\&.9\&.200\&.1       TESTPC
  50 192\&.9\&.200\&.20      NTSERVER#20
  51 192\&.9\&.200\&.21      SAMBASERVER
  52
  53 .DE
  54
  55
  56 .PP
  57 Contains three IP to NetBIOS name mappings\&. The first and third will
  58 be returned for any queries for the names \f(CW"TESTPC"\fP and
  59 \f(CW"SAMBASERVER"\fP respectively, whatever the type component of the
  60 NetBIOS name requested\&.
  61 .PP
  62 The second mapping will be returned only when the \f(CW"0x20"\fP name type
  63 for a name \f(CW"NTSERVER"\fP is queried\&. Any other name type will not be
  64 resolved\&.
  65 .PP
  66 The default location of the \fBlmhosts\fP file is in the same directory
  67 as the \fBsmb\&.conf\fP file\&.
  68 .PP
  69 .SH "VERSION"
  70 .PP
  71 This man page is correct for version 2\&.0 of the Samba suite\&.
  72 .PP
  73 .SH "SEE ALSO"
  74 .PP
  75 \fBsmb\&.conf (5)\fP,
  76 \fBsmbclient (1)\fP,
  77 \fBsmbpasswd (8)\fP, \fBsamba (7)\fP\&.
  78 .PP
  79 .SH "AUTHOR"
  80 .PP
  81 The original Samba software and related utilities were created by
  82 Andrew Tridgell (samba-bugs@samba\&.anu\&.edu\&.au)\&. Samba is now developed
  83 by the Samba Team as an Open Source project similar to the way the
  84 Linux kernel is developed\&.
  85 .PP
  86 The original Samba man pages were written by Karl Auer\&. The man page
  87 sources were converted to YODL format (another excellent piece of Open
  88 Source software, available at
  89 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
  90 and updated for the Samba2\&.0 release by Jeremy Allison\&.
  91 \fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&.
  92 .PP
  93 See \fBsamba (7)\fP to find out how to get a full
  94 list of contributors and details on how to submit bug reports,
  95 comments etc\&.