Changeset 231 for branches/samba-3.2.x/docs/manpages/findsmb.1

Timestamp:

May 27, 2009, 9:08:03 AM (16 years ago)

Author:

Herwig Bauernfeind

Message:

Update 3.2 branch to 3.2.8 docs

File:

• branches/samba-3.2.x/docs/manpages/findsmb.1 (modified) (5 diffs)

branches/samba-3.2.x/docs/manpages/findsmb.1

@@ -1 +1 @@
 .\"     Title: findsmb
-.\"    Author: 
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\"      Date: 12/19/2008
+.\"    Author: [see the "AUTHOR" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
+.\"      Date: 02/03/2009
 .\"    Manual: User Commands
 .\"    Source: Samba 3.2
+.\"  Language: English
 .\"
-.TH "FINDSMB" "1" "12/19/2008" "Samba 3\.2" "User Commands"
+.TH "FINDSMB" "1" "02/03/2009" "Samba 3\&.2" "User Commands"
+.\" -----------------------------------------------------------------
+.\" * (re)Define some macros
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" toupper - uppercase a string (locale-aware)
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de toupper
+.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
+\\$*
+.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH-xref - format a cross-reference to an SH section
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de SH-xref
+.ie n \{\
+.\}
+.toupper \\$*
+.el \{\
+\\$*
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH - level-one heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SH
+.\" put an extra blank line of space above the head in non-TTY output
+.if t \{\
+.sp 1
+.\}
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[an-margin]u
+.ti 0
+.HTML-TAG ".NH \\n[an-level]"
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+\." make the size of the head bigger
+.ps +3
+.ft B
+.ne (2v + 1u)
+.ie n \{\
+.\" if n (TTY output), use uppercase
+.toupper \\$*
+.\}
+.el \{\
+.nr an-break-flag 0
+.\" if not n (not TTY), use normal case (not uppercase)
+\\$1
+.in \\n[an-margin]u
+.ti 0
+.\" if not n (not TTY), put a border/line under subheading
+.sp -.6
+\l'\n(.lu'
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SS - level-two heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SS
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[IN]u
+.ti \\n[SN]u
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.ps \\n[PS-SS]u
+\." make the size of the head bigger
+.ps +2
+.ft B
+.ne (2v + 1u)
+.if \\n[.$] \&\\$*
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BB/BE - put background/screen (filled box) around block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BB
+.if t \{\
+.sp -.5
+.br
+.in +2n
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EB
+.if t \{\
+.if "\\$2"adjust-for-leading-newline" \{\
+.sp -1
+.\}
+.br
+.di
+.in
+.ll
+.gcolor
+.nr BW \\n(.lu-\\n(.i
+.nr BH \\n(dn+.5v
+.ne \\n(BHu+.5v
+.ie "\\$2"adjust-for-leading-newline" \{\
+\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.el \{\
+\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.in 0
+.sp -.5v
+.nf
+.BX
+.in
+.sp .5v
+.fi
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BM/EM - put colored marker in margin next to block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BM
+.if t \{\
+.br
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EM
+.if t \{\
+.br
+.di
+.ll
+.gcolor
+.nr BH \\n(dn
+.ne \\n(BHu
+\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
+.in 0
+.nf
+.BX
+.in
+.fi
+.\}
+..
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
-.SH "NAME"
-findsmb - list info about machines that respond to SMB name queries on a subnet
-.SH "SYNOPSIS"
-.HP 1
-findsmb [subnet\ broadcast\ address]
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "Name"
+findsmb \- list info about machines that respond to SMB name queries on a subnet
+.SH "Synopsis"
+.fam C
+.HP \w'\ 'u
+\FCfindsmb\F[] [subnet\ broadcast\ address]
+.fam
 .SH "DESCRIPTION"
 .PP
 This perl script is part of the
 \fBsamba\fR(7)
-suite\.
-.PP
-findsmb
-is a perl script that prints out several pieces of information about machines on a subnet that respond to SMB name query requests\. It uses
+suite\&.
+.PP
+\FCfindsmb\F[]
+is a perl script that prints out several pieces of information about machines on a subnet that respond to SMB name query requests\&. It uses
 \fBnmblookup\fR(1)
 and
 \fBsmbclient\fR(1)
-to obtain this information\.
+to obtain this information\&.
 .SH "OPTIONS"
 .PP
@@ -33 +191 @@
 .RS 4
 Controls whether
-findsmb
-takes bugs in Windows95 into account when trying to find a Netbios name registered of the remote machine\. This option is disabled by default because it is specific to Windows 95 and Windows 95 machines only\. If set,
+\FCfindsmb\F[]
+takes bugs in Windows95 into account when trying to find a Netbios name registered of the remote machine\&. This option is disabled by default because it is specific to Windows 95 and Windows 95 machines only\&. If set,
 \fBnmblookup\fR(1)
 will be called with
 \fB\-B\fR
-option\.
+option\&.
 .RE
 .PP
@@ -44 +202 @@
 .RS 4
 Without this option,
-findsmb
+\FCfindsmb \F[]
 will probe the subnet of the machine where
 \fBfindsmb\fR(1)
-is run\. This value is passed to
+is run\&. This value is passed to
 \fBnmblookup\fR(1)
 as part of the
 \fB\-B\fR
-option\.
+option\&.
 .RE
 .SH "EXAMPLES"
 .PP
 The output of
-findsmb
+\FCfindsmb\F[]
 lists the following information for all machines that respond to the initial
-nmblookup
-for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version\.
-.PP
-There will be a \'+\' in front of the workgroup name for machines that are local master browsers for that workgroup\. There will be an \'*\' in front of the workgroup name for machines that are the domain master browser for that workgroup\. Machines that are running Windows for Workgroups, Windows 95 or Windows 98 will not show any information about the operating system or server version\.
+\FCnmblookup\F[]
+for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version\&.
+.PP
+There will be a \'+\' in front of the workgroup name for machines that are local master browsers for that workgroup\&. There will be an \'*\' in front of the workgroup name for machines that are the domain master browser for that workgroup\&. Machines that are running Windows for Workgroups, Windows 95 or Windows 98 will not show any information about the operating system or server version\&.
 .PP
 The command with
@@ -67 +225 @@
 option must be run on a system without
 \fBnmbd\fR(8)
-running\. If
-nmbd
-is running on the system, you will only get the IP address and the DNS name of the machine\. To get proper responses from Windows 95 and Windows 98 machines, the command must be run as root and with
+running\&. If
+\FCnmbd\F[]
+is running on the system, you will only get the IP address and the DNS name of the machine\&. To get proper responses from Windows 95 and Windows 98 machines, the command must be run as root and with
 \fB\-r\fR
 option on a machine without
-nmbd
-running\.
+\FCnmbd\F[]
+running\&.
 .PP
 For example, running
-findsmb
+\FCfindsmb\F[]
 without
 \fB\-r\fR
 option set would yield output similar to the following
 .sp
+.if n \{\
 .RS 4
+.\}
+.fam C
+.ps -1
 .nf
+.if t \{\
+.sp -1
+.\}
+.BB lightgray adjust-for-leading-newline
+.sp -1
+
 IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- 
-192\.168\.35\.10   MINESET\-TEST1  [DMVENGR]
-192\.168\.35\.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2\.0\.6]
-192\.168\.35\.56   HERBNT2        [HERB\-NT]
-192\.168\.35\.63   GANDALF        [MVENGR] [Unix] [Samba 2\.0\.5a for IRIX]
-192\.168\.35\.65   SAUNA          [WORKGROUP] [Unix] [Samba 1\.9\.18p10]
-192\.168\.35\.71   FROGSTAR       [ENGR] [Unix] [Samba 2\.0\.0 for IRIX]
-192\.168\.35\.78   HERBDHCP1     +[HERB]
-192\.168\.35\.88   SCNT2         +[MVENGR] [Windows NT 4\.0] [NT LAN Manager 4\.0]
-192\.168\.35\.93   FROGSTAR\-PC    [MVENGR] [Windows 5\.0] [Windows 2000 LAN Manager]
-192\.168\.35\.97   HERBNT1       *[HERB\-NT] [Windows NT 4\.0] [NT LAN Manager 4\.0]
-.fi
+192\&.168\&.35\&.10   MINESET\-TEST1  [DMVENGR]
+192\&.168\&.35\&.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2\&.0\&.6]
+192\&.168\&.35\&.56   HERBNT2        [HERB\-NT]
+192\&.168\&.35\&.63   GANDALF        [MVENGR] [Unix] [Samba 2\&.0\&.5a for IRIX]
+192\&.168\&.35\&.65   SAUNA          [WORKGROUP] [Unix] [Samba 1\&.9\&.18p10]
+192\&.168\&.35\&.71   FROGSTAR       [ENGR] [Unix] [Samba 2\&.0\&.0 for IRIX]
+192\&.168\&.35\&.78   HERBDHCP1     +[HERB]
+192\&.168\&.35\&.88   SCNT2         +[MVENGR] [Windows NT 4\&.0] [NT LAN Manager 4\&.0]
+192\&.168\&.35\&.93   FROGSTAR\-PC    [MVENGR] [Windows 5\&.0] [Windows 2000 LAN Manager]
+192\&.168\&.35\&.97   HERBNT1       *[HERB\-NT] [Windows NT 4\&.0] [NT LAN Manager 4\&.0]
+.EB lightgray adjust-for-leading-newline
+.if t \{\
+.sp 1
+.\}
+.fi
+.fam
+.ps +1
+.if n \{\
 .RE
+.\}
 .SH "VERSION"
 .PP
-This man page is correct for version 3 of the Samba suite\.
+This man page is correct for version 3 of the Samba suite\&.
 .SH "SEE ALSO"
 .PP
@@ -107 +283 @@
 .SH "AUTHOR"
 .PP
-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\.
-.PP
-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, available at
-ftp://ftp\.icce\.rug\.nl/pub/unix/) and updated for the Samba 2\.0 release by Jeremy Allison\. The conversion to DocBook for Samba 2\.2 was done by Gerald Carter\. The conversion to DocBook XML 4\.2 for Samba 3\.0 was done by Alexander Bokovoy\.
+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\&.
+.PP
+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, available at
+ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.