← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/samba/intrepid-updates

« back to all changes in this revision

Viewing changes to docs/manpages/findsmb.1

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2008-06-02 09:01:46 UTC
  • mfrom: (0.25.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080602090146-92ur4nx39ccg708r
Tags: 2:3.0.30-2ubuntu1
https://launchpad.net/bugs/32067
https://launchpad.net/bugs/201059
https://launchpad.net/bugs/206036
* Merge from debian unstable, remaining changes:
  * debian/patches/VERSION.patch
    - set SAMABA_VERSION_VENDOR_SUFFIX to Ubuntu
  * debian/smb.conf
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] shares, and a comment about
      "value users = %S to show users how to restrict access to 
      \\server\useranem to only username.
    - Add map to guest = Bad user, maps bad username to guest access.
      (LP: #32067)
  * debian/samba-common.postinst:
    - Fix upgrade from a first installation done with feisty, edgy, or dapper.
      (LP: #201059)
    - When populating the new sambashare group, it's not an error if the user
      simply doesn't exist; test for this case and the install continue 
      instead of aborting. (LP: #206036)
  * debian/smba-common.config:
    - do not change priority to HIGH if dhclient3 is installed
    - used priority medium instead of hight for the workgroup question
  * debian/winbind.files
    - insclude additional files
  * debian/patches/fix-documentation.patch:
    - fix typos in net(8) and smb.conf(5) man pages
  * debian/mksambapasswd.awk:
    - Don't add user with UID less than 1000 to smbpasswd.
  * debian/samba.init:
    - add 'status' option for LSB conformance.
  * Updated control version.
  * Dropped Changes:
    - Dropped debian/patches/fix-smbprinting-os2.patch. Accepted upstream.
    - Dropped debian/patches/fix-documentation.patch. Accepted upstream.
     

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manpages/findsmb.1
1
 
.\"Generated by db2man.xsl. Don't modify this, modify the source.
2
 
.de Sh \" Subsection
3
 
.br
4
 
.if t .Sp
5
 
.ne 5
6
 
.PP
7
 
\fB\\$1\fR
8
 
.PP
9
 
..
10
 
.de Sp \" Vertical space (when we can't use .PP)
11
 
.if t .sp .5v
12
 
.if n .sp
13
 
..
14
 
.de Ip \" List item
15
 
.br
16
 
.ie \\n(.$>=3 .ne \\$3
17
 
.el .ne 3
18
 
.IP "\\$1" \\$2
19
 
..
20
 
.TH "FINDSMB" 1 "" "" ""
 
1
.\"     Title: findsmb
 
2
.\"    Author: 
 
3
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
 
4
.\"      Date: 05/28/2008
 
5
.\"    Manual: User Commands
 
6
.\"    Source: Samba 3.0
 
7
.\"
 
8
.TH "FINDSMB" "1" "05/28/2008" "Samba 3\.0" "User Commands"
 
9
.\" disable hyphenation
 
10
.nh
 
11
.\" disable justification (adjust text to left margin only)
 
12
.ad l
21
13
.SH "NAME"
22
14
findsmb - list info about machines that respond to SMB name queries on a subnet
23
15
.SH "SYNOPSIS"
24
16
.HP 1
25
 
findsmb [subnet�broadcast�address]
 
17
findsmb [subnet\ broadcast\ address]
26
18
.SH "DESCRIPTION"
27
19
.PP
28
20
This perl script is part of the
29
21
\fBsamba\fR(7)
30
 
suite.
 
22
suite\.
31
23
.PP
32
24
findsmb
33
 
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
 
25
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
34
26
\fBnmblookup\fR(1)
35
27
and
36
28
\fBsmbclient\fR(1)
37
 
to obtain this information.
 
29
to obtain this information\.
38
30
.SH "OPTIONS"
39
31
.PP
40
 
-r
41
 
.RS 3n
 
32
\-r
 
33
.RS 4
42
34
Controls whether
43
35
findsmb
44
 
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,
 
36
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,
45
37
\fBnmblookup\fR(1)
46
38
will be called with
47
 
\fB-B\fR
48
 
option.
 
39
\fB\-B\fR
 
40
option\.
49
41
.RE
50
42
.PP
51
43
subnet broadcast address
52
 
.RS 3n
 
44
.RS 4
53
45
Without this option,
54
46
findsmb
55
47
will probe the subnet of the machine where
56
48
\fBfindsmb\fR(1)
57
 
is run. This value is passed to
 
49
is run\. This value is passed to
58
50
\fBnmblookup\fR(1)
59
51
as part of the
60
 
\fB-B\fR
61
 
option.
 
52
\fB\-B\fR
 
53
option\.
62
54
.RE
63
55
.SH "EXAMPLES"
64
56
.PP
66
58
findsmb
67
59
lists the following information for all machines that respond to the initial
68
60
nmblookup
69
 
for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version.
 
61
for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version\.
70
62
.PP
71
 
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.
 
63
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\.
72
64
.PP
73
65
The command with
74
 
\fB-r\fR
 
66
\fB\-r\fR
75
67
option must be run on a system without
76
68
\fBnmbd\fR(8)
77
 
running. If
 
69
running\. If
78
70
nmbd
79
 
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
80
 
\fB-r\fR
 
71
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
 
72
\fB\-r\fR
81
73
option on a machine without
82
74
nmbd
83
 
running.
 
75
running\.
84
76
.PP
85
77
For example, running
86
78
findsmb
87
79
without
88
 
\fB-r\fR
 
80
\fB\-r\fR
89
81
option set would yield output similar to the following
90
 
 
 
82
.sp
 
83
.RS 4
91
84
.nf
92
 
 
93
85
IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
94
 
--------------------------------------------------------------------- 
95
 
192.168.35.10   MINESET-TEST1  [DMVENGR]
96
 
192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
97
 
192.168.35.56   HERBNT2        [HERB-NT]
98
 
192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
99
 
192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
100
 
192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
101
 
192.168.35.78   HERBDHCP1     +[HERB]
102
 
192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
103
 
192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
104
 
192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
105
 
 
 
86
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- 
 
87
192\.168\.35\.10   MINESET\-TEST1  [DMVENGR]
 
88
192\.168\.35\.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2\.0\.6]
 
89
192\.168\.35\.56   HERBNT2        [HERB\-NT]
 
90
192\.168\.35\.63   GANDALF        [MVENGR] [Unix] [Samba 2\.0\.5a for IRIX]
 
91
192\.168\.35\.65   SAUNA          [WORKGROUP] [Unix] [Samba 1\.9\.18p10]
 
92
192\.168\.35\.71   FROGSTAR       [ENGR] [Unix] [Samba 2\.0\.0 for IRIX]
 
93
192\.168\.35\.78   HERBDHCP1     +[HERB]
 
94
192\.168\.35\.88   SCNT2         +[MVENGR] [Windows NT 4\.0] [NT LAN Manager 4\.0]
 
95
192\.168\.35\.93   FROGSTAR\-PC    [MVENGR] [Windows 5\.0] [Windows 2000 LAN Manager]
 
96
192\.168\.35\.97   HERBNT1       *[HERB\-NT] [Windows NT 4\.0] [NT LAN Manager 4\.0]
106
97
.fi
 
98
.RE
107
99
.SH "VERSION"
108
100
.PP
109
 
This man page is correct for version 3.0 of the Samba suite.
 
101
This man page is correct for version 3\.0 of the Samba suite\.
110
102
.SH "SEE ALSO"
111
103
.PP
112
104
\fBnmbd\fR(8),
114
106
\fBnmblookup\fR(1)
115
107
.SH "AUTHOR"
116
108
.PP
117
 
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.
 
109
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\.
118
110
.PP
119
 
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
120
 
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.
121
 
 
 
111
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
 
112
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\.