docs/manpages/lmhosts.5

   1 .\" This manpage has been automatically generated by docbook2man-spec
   2 .\" from a DocBook document.  docbook2man-spec can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .TH "LMHOSTS" "5" "24 April 2001" "" ""
   7 .SH NAME
   8 lmhosts \- The Samba NetBIOS hosts file
   9 .SH SYNOPSIS
  10 .PP
  11 \fIlmhosts\fR is the  SambaNetBIOS name to IP address mapping file.
  12 .SH "DESCRIPTION"
  13 .PP
  14 This file is part of the < Sambasuite.
  15 .PP
  16 \fIlmhosts\fR is the \fBSamba
  17 \fRNetBIOS name to IP address mapping file. It
  18 is very similar to the \fI/etc/hosts\fR file
  19 format, except that the hostname component must correspond
  20 to the NetBIOS naming format.
  21 .SH "FILE FORMAT"
  22 .PP
  23 It is an ASCII file containing one line for NetBIOS name.
  24 The two fields on each line are separated from each other by
  25 white space. Any entry beginning with '#' is ignored. Each line
  26 in the lmhosts file contains the following information :
  27 .TP 0.2i
  28 \(bu
  29 IP Address - in dotted decimal format.
  30 .TP 0.2i
  31 \(bu
  32 NetBIOS Name - This name format is a
  33 maximum fifteen character host name, with an optional
  34 trailing '#' character followed by the NetBIOS name type
  35 as two hexadecimal digits.
  36
  37 If the trailing '#' is omitted then the given IP
  38 address will be returned for all names that match the given
  39 name, whatever the NetBIOS name type in the lookup.
  40 .PP
  41 An example follows :
  42 .PP
  43 .PP
  44 .sp
  45 .nf
  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 .sp
  54 .fi
  55 .PP
  56 .PP
  57 Contains three IP to NetBIOS name mappings. The first
  58 and third will be returned for any queries for the names "TESTPC"
  59 and "SAMBASERVER" respectively, whatever the type component of
  60 the NetBIOS name requested.
  61 .PP
  62 .PP
  63 The second mapping will be returned only when the "0x20" name
  64 type for a name "NTSERVER" is queried. Any other name type will not
  65 be resolved.
  66 .PP
  67 .PP
  68 The default location of the \fIlmhosts\fR file
  69 is in the same directory as the
  70 smb.conf(5)>file.
  71 .PP
  72 .SH "VERSION"
  73 .PP
  74 This man page is correct for version 2.2 of
  75 the Samba suite.
  76 .SH "SEE ALSO"
  77 .PP
  78 \fBsmbclient(1)
  79 \fR.SH "AUTHOR"
  80 .PP
  81 The original Samba software and related utilities
  82 were created by Andrew Tridgell. Samba is now developed
  83 by the Samba Team as an Open Source project similar
  84 to the way the Linux kernel is developed.
  85 .PP
  86 The original Samba man pages were written by Karl Auer.
  87 The man page sources were converted to YODL format (another
  88 excellent piece of Open Source software, available at
  89 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
  90 release by Jeremy Allison. The conversion to DocBook for
  91 Samba 2.2 was done by Gerald Carter