home *** CD-ROM | disk | FTP | other *** search
/ H4CK3R 16 / hacker16 / 16_HACKER16.ISO / linux / tpm-security-server-1.2.1.iso / readme / nbtscan-README < prev    next >
Encoding:
Text File  |  2004-01-27  |  4.8 KB  |  125 lines
  1. NBTscan version 1.5.1 Copyright (C) 1999-2003 Alla Bezroutchko
  2.  
  3. NBTscan is a program for scanning IP networks for NetBIOS name
  4. information. It sends NetBIOS status query to each address in
  5. supplied range and lists received information in human
  6. readable form. For each responded host it lists IP address,
  7. NetBIOS computer name, logged-in user name and MAC address 
  8. (such as Ethernet).
  9.  
  10. See http://www.inetcat.org/software/nbtscan.html for
  11. NBTscan homepage.
  12.  
  13. LICENSE.
  14.  
  15. This program is free software; you can redistribute it and/or modify
  16. it under the terms of the GNU General Public License as published by
  17. the Free Software Foundation; either version 2 of the License, or
  18. (at your option) any later version.
  19.  
  20. This program is distributed in the hope that it will be useful,
  21. but WITHOUT ANY WARRANTY; without even the implied warranty of
  22. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23. GNU General Public License for more details.
  24.  
  25. You should have received a copy of the GNU General Public License
  26. along with this program (in a file called COPYING); if not, write 
  27. to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
  28. MA 02139, USA.
  29.  
  30. INSTALLATION.
  31.  
  32. NBTscan compiles and runs on Unix and Windows. I have tested it
  33. on Windows NT 4.0, Windows 2000, FreeBSD 4.3, OpenBSD 2.8
  34. and RedHat Linux 7.1. It should also compile and run on Solaris
  35. and other Linuxes as well.  Steve Coleman 
  36. <Steve.Coleman@jhuapl.edu> ported NBTscan to Solaris, HP-UX and 
  37. OSF/1 and fixed several bugs. He reports that NBTscan also runs 
  38. on IRIX/SGI with minor problems. Mohammad A. Haque 
  39. <mhaque@haque.net> ported nbtscan to Darwin.
  40.  
  41. Windows:
  42.  
  43. To compile this under Windows you will need Cygwin. You can
  44. Download and install Cygwin from 
  45. http://sources.redhat.com/cygwin/
  46. Start Cygwin shell and proceed from there as in Unix 
  47. installation
  48.    
  49. Unix:
  50. Do
  51.  
  52. ./configure
  53.  
  54. make
  55.  
  56. make install
  57.  
  58. That's all.
  59.  
  60. RUNNING.
  61.  
  62. Usage:
  63.  
  64. nbtscan [-v] [-d] [-e] [-l] [-t timeout] [-b bandwidth] [-r] [-q] [-s separator] [-m retransmits] (-f filename)|(<scan_range>) 
  65.         -v              verbose output. Print all names received
  66.                         from each host
  67.         -d              dump packets. Print whole packet contents.
  68.         -e              Format output in /etc/hosts format.
  69.         -l              Format output in lmhosts format.
  70.                         Cannot be used with -v, -s or -h options.
  71.         -t timeout      wait timeout imilliseconds for response.
  72.                         Default 1.
  73.         -b bandwidth    Output throttling. Slow down output
  74.                         so that it uses no more that bandwidth bps.
  75.                         Useful on slow links, so that ougoing queries
  76.                         don't get dropped.
  77.         -r              use local port 137 for scans. Win95 boxes
  78.                         respond to this only.
  79.                         You need to be root to use this option on Unix.
  80.         -q              Suppress banners and error messages,
  81.         -s separator    Script-friendly output. Don't print
  82.                         column and record headers, separate fields 
  83.             with separator.
  84.         -h              Print human-readable names for services.
  85.  
  86.                         Can only be used with -v option.
  87.         -m retransmits  Number of retransmits. Default 0.
  88.         -f filename     Take IP addresses to scan from file filename
  89.             -f - makes nbtscan take IP addresses from stdin.
  90.         <scan_range>    what to scan. Can either be single IP
  91.                         like 192.168.1.1 or
  92.                         range of addresses in one of two forms: 
  93.                         xxx.xxx.xxx.xxx/xx or xxx.xxx.xxx.xxx-xxx.
  94. Examples:
  95.         nbtscan -r 192.168.1.0/24
  96.                 Scans the whole C-class network.
  97.         nbtscan 192.168.1.25-137
  98.                 Scans a range from 192.168.1.25 to 192.168.1.137
  99.         nbtscan -v -s : 192.168.1.0/24
  100.                 Scans C-class network. Prints results in script-friendly
  101.                 format using colon as field separator.
  102.                 Produces output like that:
  103.                 192.168.0.1:NT_SERVER:00U
  104.                 192.168.0.1:MY_DOMAIN:00G
  105.                 192.168.0.1:ADMINISTRATOR:03U
  106.                 192.168.0.2:OTHER_BOX:00U
  107.                 ...
  108.         nbtscan -f iplist
  109.                 Scans IP addresses specified in file iplist.
  110.  
  111.  
  112. BUGS/LIMITATIONS
  113.  
  114. Windows version has a certain limitation: you cannot scan Win95 
  115. hosts with it because Windows 95 always sends responses to name 
  116. queries to port 137, and you cannot bind to port 137 under
  117. Windows (it is already taken by Windows itself).
  118.  
  119. When talking to Samba boxes nbtscan always reports the MAC 
  120. address being 00-00-00-00-00-00. This is because Samba sends 
  121. that as MAC address. Nbtscan just displays what it gets.
  122.  
  123. Report bugs to alla@inetcat.org (that's me). I cannot promise to
  124. do anything but I might well want fix it. Remember: no warranty.
  125.