From 73cd96ec90ceecb54402daf5ee199861860296d2 Mon Sep 17 00:00:00 2001 From: Jeremy Allison Date: Wed, 11 Nov 1998 00:10:47 +0000 Subject: Updating changes - now move to yodldocs directory. Jeremy. (This used to be commit 98192a996ae5c77c7bd02d522a76d2dd65a4ceff) --- docs/yodldocs/lmhosts.5.yo | 95 ++++++++++++++++++++++++++++++++++++++++++++ docs/yodldocs/smbclient.1.yo | 8 ++-- 2 files changed, 99 insertions(+), 4 deletions(-) create mode 100644 docs/yodldocs/lmhosts.5.yo diff --git a/docs/yodldocs/lmhosts.5.yo b/docs/yodldocs/lmhosts.5.yo new file mode 100644 index 0000000000..3685f4bddd --- /dev/null +++ b/docs/yodldocs/lmhosts.5.yo @@ -0,0 +1,95 @@ +mailto(samba-bugs@samba.anu.edu.au) + +manpage(lmhosts)(5)(23 Oct 1998)(Samba)(SAMBA) + +label(NAME) +manpagename(lmhosts)(The Samba NetBIOS hosts file) + +label(SYNOPSIS) +manpagesynopsis() + +lmhosts is the bf(Samba) NetBIOS name to IP address mapping file. + +label(DESCRIPTION) +manpagedescription() + +This file is part of the bf(Samba) suite. + +lmhosts is the bf(Samba) NetBIOS name to IP address mapping file. It +is very similar to the bf(/etc/hosts) file format, except that the +hostname component must correspond to the NetBIOS naming format. + +label(FILEFORMAT) +manpagesection(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 : + +startit() + +it() bf(IP Address) - in dotted decimal format. + +it() bf(NetBIOS Name) - This name format is a maximum fifteen +character host name, with an optional trailing tt('#') character +followed by the NetBIOS name type as two hexadecimal digits. + +If the trailing tt('#') 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. + +endit() + +An example follows : + +verb( + +# +# 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 tt("TESTPC") and +tt("SAMBASERVER") respectively, whatever the type component of the +NetBIOS name requested. + +The second mapping will be returned only when the tt("0x20") name type +for a name tt("NTSERVER") is queried. Any other name type will not be +resolved. + +The default location of the bf(lmhosts) file is in the same directory +as the url(bf(smb.conf))(smb.conf.html) file. + +label(VERSION) +manpagesection(VERSION) + +This man page is correct for version 2.0 of the Samba suite. + +label(SEEALSO) +manpageseealso() + +url(bf(smb.conf (5)))(smb.conf.5.html#nameresolveorder), +url(bf(smbclient (1)))(smbclient.1.html#minusR), +url(bf(smbpasswd (8)))(smbpasswd.8.html#minusR), url(bf(samba (7)))(samba.7.html). + +label(AUTHOR) +manpageauthor() + +The original Samba software and related utilities were created by +Andrew Tridgell (samba-bugs@samba.anu.edu.au). 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) and updated for the Samba2.0 release by Jeremy +Allison, email(samba-bugs@samba.anu.edu.au). + +See url(bf(samba (7)))(samba.7.html) to find out how to get a full +list of contributors and details on how to submit bug reports, +comments etc. diff --git a/docs/yodldocs/smbclient.1.yo b/docs/yodldocs/smbclient.1.yo index 5ad6e9bc38..d79248d9d3 100644 --- a/docs/yodldocs/smbclient.1.yo +++ b/docs/yodldocs/smbclient.1.yo @@ -8,7 +8,7 @@ manpagename(smbclient)(ftp-like client to access SMB/CIFS resources on servers) label(SYNOPSIS) manpagesynopsis() -bf(smbclient) link(servicename)(servicename) [link(password)(password)] [link(-s smb.conf)(minuss)] [link(-B IP addr)(minusB)] [link(-O socket options)(minusO)][link(-R name resolve order)(nameresolveorder)] [link(-M NetBIOS name)(minusM)] [link(-i scope)(minusi)] [link(-N)(minusN)] [link(-n NetBIOS name)(minusn)] [link(-d debuglevel)(minusd)] [link(-P)(minusP)] [link(-p port)(minusp)] [link(-l log basename)(minusl)] [link(-h)(minush)] [link(-I dest IP)(minusI)] [link(-E)(minusE)] [link(-U username)(minusU)] [link(-L NetBIOS name)(minusL)] [link(-t terminal code)(minust)] [link(-m max protocol)(minusm)] [link(-W workgroup)(minusW)] [link(-TIXFqgbNan)(minusT)] [link(-D directory)(minusD)] [link(-c command string)(minusc)] +bf(smbclient) link(servicename)(servicename) [link(password)(password)] [link(-s smb.conf)(minuss)] [link(-B IP addr)(minusB)] [link(-O socket options)(minusO)][link(-R name resolve order)(minusR)] [link(-M NetBIOS name)(minusM)] [link(-i scope)(minusi)] [link(-N)(minusN)] [link(-n NetBIOS name)(minusn)] [link(-d debuglevel)(minusd)] [link(-P)(minusP)] [link(-p port)(minusp)] [link(-l log basename)(minusl)] [link(-h)(minush)] [link(-I dest IP)(minusI)] [link(-E)(minusE)] [link(-U username)(minusU)] [link(-L NetBIOS name)(minusL)] [link(-t terminal code)(minust)] [link(-m max protocol)(minusm)] [link(-W workgroup)(minusW)] [link(-TIXFqgbNan)(minusT)] [link(-D directory)(minusD)] [link(-c command string)(minusc)] label(DESCRIPTION) manpagedescription() @@ -42,7 +42,7 @@ which may or may not be the same as the IP hostname of the machine running the server. The server name is looked up according to either the -link(bf(-R))(nameresolveorder) parameter to bf(smbclient) or using the +link(bf(-R))(minusR) parameter to bf(smbclient) or using the url(bf(name resolve order))(smb.conf.5.html#nameresolveorder) parameter in the smb.conf file, allowing an administrator to change the order and methods by which server names are looked up. @@ -80,7 +80,7 @@ socket. See the url(socket options)(smb.conf.5.html#socketoptions) parameter in the url(bf(smb.conf (5)))(smb.conf.5.html) manpage for the list of valid options. -label(nameresolveorder) +label(minusR) dit(bf(-R name resolve order)) This option allows the user of smbclient to determine what name resolution services to use when looking up the NetBIOS name of the host being connected to. @@ -231,7 +231,7 @@ connect to. It should be specified in standard "a.b.c.d" notation. Normally the client would attempt to locate a named SMB/CIFS server by looking it up via the NetBIOS name resolution mechanism described -above in the link(bf(name resolve order))(nameresolveorder) parameter +above in the link(bf(name resolve order))(minusR) parameter above. Using this parameter will force the client to assume that the server is on the machine with the specified IP address and the NetBIOS name component of the resource being connected to will be ignored. -- cgit