Debian Codegraph @

upstream/debian-unstable/man5/lmhosts.5

raw
1 '\" t
2 .\" Title: lmhosts
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: File Formats and Conventions
7 .\" Source: Samba 4.24.3-Debian-4.24.3+dfsg-1
8 .\" Language: English
9 .\"
10 .TH "LMHOSTS" "5" "05/26/2026" "Samba 4\&.24\&.3\-Debian\-4\&.24\&.3+dfs" "File Formats and Conventions"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 lmhosts \- The Samba NetBIOS hosts file
32 .SH "SYNOPSIS"
33 .PP
34 lmhosts
35 is the
36 \fBsamba\fR(7)
37 NetBIOS name to IP address mapping file\&.
38 .SH "DESCRIPTION"
39 .PP
40 This file is part of the
41 \fBsamba\fR(7)
42 suite\&.
43 .PP
44 lmhosts
45 is the
46 \fISamba \fR
47 NetBIOS name to IP address mapping file\&. It is very similar to the
48 /etc/hosts
49 file format, except that the hostname component must correspond to the NetBIOS naming format\&.
50 .SH "FILE FORMAT"
51 .PP
52 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 \*(Aq#\*(Aq is ignored\&. Each line in the lmhosts file contains the following information:
53 .RS
54 .sp
55 .RS 4
56 .ie n \{\
57 \h'-04'\(bu\h'+03'\c
58 .\}
59 .el \{\
60 .sp -1
61 .IP \(bu 2.3
62 .\}
63 IP Address \- in dotted decimal format\&.
64 .RE
65 .sp
66 .RS 4
67 .ie n \{\
68 \h'-04'\(bu\h'+03'\c
69 .\}
70 .el \{\
71 .sp -1
72 .IP \(bu 2.3
73 .\}
74 NetBIOS Name \- This name format is a maximum fifteen character host name, with an optional trailing \*(Aq#\*(Aq character followed by the NetBIOS name type as two hexadecimal digits\&.
75 .sp
76 If the trailing \*(Aq#\*(Aq 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\&.
77 .RE
78 .sp
79 .RE
80 .PP
81 An example follows:
82 .sp
83 .if n \{\
84 .RS 4
85 .\}
86 .nf
87 #
88 # Sample Samba lmhosts file\&.
89 #
90 192\&.9\&.200\&.1 TESTPC
91 192\&.9\&.200\&.20 NTSERVER#20
92 192\&.9\&.200\&.21 SAMBASERVER
93 .fi
94 .if n \{\
95 .RE
96 .\}
97 .PP
98 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\&.
99 .PP
100 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\&.
101 .PP
102 The default location of the
103 lmhosts
104 file is in the same directory as the
105 \fBsmb.conf\fR(5)
106 file\&.
107 .SH "FILES"
108 .PP
109 lmhosts is loaded from the configuration directory\&. This is usually
110 /etc/samba
111 or
112 /usr/local/samba/lib\&.
113 .SH "VERSION"
114 .PP
115 This man page is part of version 4\&.24\&.3\-Debian\-4\&.24\&.3+dfsg\-1 of the Samba suite\&.
116 .SH "SEE ALSO"
117 .PP
118 \fBsmbclient\fR(1),
119 \fBsmb.conf\fR(5), and
120 \fBsmbpasswd\fR(8)
121 .SH "AUTHOR"
122 .PP
123 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\&.