docs/manpages/findsmb.1

   1 .\" This manpage has been automatically generated by docbook2man
   2 .\" from a DocBook document.  This tool can be found at:
   3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
   4 .\" Please send any bug reports, improvements, comments, patches,
   5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6 .TH "FINDSMB" "1" "04 March 2003" "" ""
   7 .SH NAME
   8 findsmb \- list info about machines that respond to SMB  name queries on a subnet
   9 .SH SYNOPSIS
  10
  11 \fBfindsmb\fR [ \fBsubnet broadcast address\fR ]
  12
  13 .SH "DESCRIPTION"
  14 .PP
  15 This perl script is part of the  Samba suite.
  16 .PP
  17 \fBfindsmb\fR is a perl script that
  18 prints out several pieces of information about machines
  19 on a subnet that respond to SMB  name query requests.
  20 It uses \fB nmblookup(1)\fR to obtain this information.
  21 .SH "OPTIONS"
  22 .TP
  23 \fB-r\fR
  24 Controls whether \fBfindsmb\fR takes
  25 bugs in Windows95 into account when trying to find a Netbios name
  26 registered of the remote machine. This option is disabled by default
  27 because it is specific to Windows 95 and Windows 95 machines only.
  28 If set, \fBnmblookup\fR
  29 will be called with -B option.
  30 .TP
  31 \fBsubnet broadcast address\fR
  32 Without this option, \fBfindsmb
  33 \fR will probe the subnet of the machine where
  34 \fBfindsmb\fR is run. This value is passed
  35 to \fBnmblookup\fR as part of the
  36 -B option.
  37 .SH "EXAMPLES"
  38 .PP
  39 The output of \fBfindsmb\fR lists the following
  40 information for all machines that respond to the initial
  41 \fBnmblookup\fR for any name: IP address, NetBIOS name,
  42 Workgroup name, operating system, and SMB server version.
  43 .PP
  44 There will be a '+' in front of the workgroup name for
  45 machines that are local master browsers for that workgroup. There
  46 will be an '*' in front of the workgroup name for
  47 machines that are the domain master browser for that workgroup.
  48 Machines that are running Windows, Windows 95 or Windows 98 will
  49 not show any information about the operating system or server
  50 version.
  51 .PP
  52 The command with -r option
  53 must be run on a system without \fBnmbd\fR running.
  54 If \fBnmbd\fR is running on the system, you will
  55 only  get the IP address and the DNS name of the machine. To
  56 get proper responses  from Windows 95 and Windows 98 machines,
  57 the command must be run as root and with -r
  58 option on a machine without \fBnmbd\fR running.
  59 .PP
  60 For example, running \fBfindsmb\fR without
  61 -r option set would yield output similar
  62 to the following
  63
  64 .nf
  65 IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION
  66 ---------------------------------------------------------------------
  67 192.168.35.10   MINESET-TEST1  [DMVENGR]
  68 192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
  69 192.168.35.56   HERBNT2        [HERB-NT]
  70 192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
  71 192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
  72 192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
  73 192.168.35.78   HERBDHCP1     +[HERB]
  74 192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
  75 192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
  76 192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
  77
  78 .fi
  79 .SH "VERSION"
  80 .PP
  81 This man page is correct for version 3.0 of
  82 the Samba suite.
  83 .SH "SEE ALSO"
  84 .PP
  85 \fBnmbd(8)\fR
  86 \fBsmbclient(1)
  87 \fR and  \fBnmblookup(1)\fR
  88 .SH "AUTHOR"
  89 .PP
  90 The original Samba software and related utilities
  91 were created by Andrew Tridgell. Samba is now developed
  92 by the Samba Team as an Open Source project similar
  93 to the way the Linux kernel is developed.
  94 .PP
  95 The original Samba man pages were written by Karl Auer.
  96 The man page sources were converted to YODL format (another
  97 excellent piece of Open Source software, available at
  98 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
  99 release by Jeremy Allison.  The conversion to DocBook for
 100 Samba 2.2 was done by Gerald Carter