Import 1.0.3 version

ChangeLog

@@ -1,3 +1,14 @@
+Version 1.0.3 - February 2002</h3>
+
+- NBTscan now returns meaningful exit code (patch by James Troup for Debian Linux)
+- Added /etc/hosts and lmhosts format output (suggested by Anahuac de Paula Gil and Sigmund Baginov)
+- configure script now honours --prefix argument (patch by Petter Reinholdtsen)
+- Error messages now include IP address that caused error
+- NBTscan accepts a file with a list of IP addresses to scan (suggested by Omas Jakobsson)
+- Service number is printed for unknown NetBIOS services in -h mode (suggested by Dan Wright) 
+- Fixed some compile-time warnings on Linux
+- Corrected some typos
+
 Version 1.0.2 - March 30, 2000
 
 - Added retransmits (-m option) (Several people asked)

Makefile

@@ -0,0 +1,32 @@
+INSTALL=/usr/bin/install -c
+CC=gcc
+LIBS=
+CFLAGS = -g -O2
+OBJECTS=nbtscan.o statusq.o range.o list.o
+DEFS=-DSTDC_HEADERS=1 -DHAVE_SYS_TIME_H=1 -DHAVE_SYS_TYPES_H=1 -DHAVE_SYS_STAT_H=1 -DHAVE_STDLIB_H=1 -DHAVE_STRING_H=1 -DHAVE_MEMORY_H=1 -DHAVE_STRINGS_H=1 -DHAVE_INTTYPES_H=1 -DHAVE_UNISTD_H=1 -Dmy_uint8_t=uint8_t -Dmy_uint16_t=uint16_t -Dmy_uint32_t=uint32_t -DTIME_WITH_SYS_TIME=1 -DHAVE_SNPRINTF=1 -DUNIX=1 
+TARGET=nbtscan
+BINDIR=NONE/bin
+
+nbtscan: $(OBJECTS)
+	$(CC) $(CFLAGS) -o nbtscan $(OBJECTS) $(LIBS)
+
+install:
+	$(INSTALL) $(TARGET) $(DESTDIR)$(BINDIR)/$(TARGET)
+
+nbtscan.o: nbtscan.c statusq.h range.h list.h
+	$(CC) $(CFLAGS) $(DEFS) -c nbtscan.c
+
+statusq.o: statusq.c statusq.h
+	$(CC) $(CFLAGS) $(DEFS) -c statusq.c
+
+range.o: range.c range.h
+	$(CC) $(CFLAGS) $(DEFS) -c range.c
+
+list.o: list.c list.h
+	$(CC) $(CFLAGS) $(DEFS) -c list.c
+
+clean:
+	-rm $(OBJECTS) nbtscan
+
+distclean: clean
+	-rm config.cache config.log config.status Makefile

README

@@ -1,4 +1,4 @@
-NBTscan version 1.0.2. Copyright (C) 1999-2000 Alla Bezroutchko
+NBTscan version 1.0.3. Copyright (C) 1999-2002 Alla Bezroutchko
 
 NBTscan is a program for scanning IP networks for NetBIOS name
 information. It sends NetBIOS status query to each address in
@@ -7,7 +7,7 @@ readable form. For each responded host it lists IP address,
 NetBIOS computer name, logged-in user name and MAC address 
 (such as Ethernet).
 
-See http://www.abb.aha.ru/software/nbtscan.html for
+See http://www.inetcat.org/software/nbtscan.html for
 NBTscan homepage.
 
 LICENSE.
@@ -30,41 +30,20 @@ MA 02139, USA.
 INSTALLATION.
 
 NBTscan compiles and runs on Unix and Windows. I have tested it
-on Windows NT 4.0, Windows 95, Windows 98, FreeBSD 2.2.7, 
-FreeBSD 3.1, and Solaris 2.6/Intel. Steve Coleman 
+on Windows NT 4.0, Windows 2000, FreeBSD 4.3, OpenBSD 2.8
+and RedHat Linux 7.1. It should also compile and run on Solaris
+and other Linuxes as well.  Steve Coleman 
 <Steve.Coleman@jhuapl.edu> ported NBTscan to Solaris, HP-UX and 
 OSF/1 and fixed several bugs. He reports that NBTscan also runs 
 on IRIX/SGI with minor problems.
 
 Windows:
 
 To compile this under Windows you will need Cygwin. You can
-download it from http://sourceware.cygnus.com/cygwin/download.html
-Install it and start the shell. Make directory named bin in
-root directory of the drive you have installed Cygwin to.
-Suppose you have installed Cygwin into "C:\Program Files\cygnus".
-Then you should create directory c:\bin. Then you will need
-to mount real bin directory to /bin with the command like that:
-
-mount "/program files/cygnus/cygwin-b20/H-i586-cygwin32/bin" /bin
-
-Untar nbtscan with:
-
-tar zxvf nbtscan.tar.gz
-
-Go to nbtscan directory and run a script named 'configure' like
-that:
-
-./configure
-
-Type 'make' at Cygwin command prompt. This will compile and 
-build nbtscan.exe. If make finishes without errors, type
-'make install'. This will copy nbtscan.exe to location specified
-in BINDIR (c: by default).
-
-To run it independently (without Cygwin) find file named 
-cygwin1.dll and copy it to winnt\system32 (or windows\system 
-under Windows 95)
+Download and install Cygwin from 
+http://sources.redhat.com/cygwin/
+Start Cygwin shell and proceed from there as in Unix 
+installation
 
 Unix:
 Do
@@ -79,10 +58,14 @@ That's all.
 
 RUNNING.
 
-Usage: nbtscan [-v] [-d] [-t timeout] [-b bandwidth] [-r] [-q] [-s separator] <scan_range>
+Usage:
+
+nbtscan [-v] [-d] [-e] [-l] [-t timeout] [-b bandwidth] [-r] [-q] [-s separator] [-m retransmits] (-f filename)|(<scan_range>) 
         -v              verbose output. Print all names received
                         from each host
         -d              dump packets. Print whole packet contents.
+        -e              Format output in /etc/hosts format.
+        -l              Format output in lmhosts format.
                         Cannot be used with -v, -s or -h options.
         -t timeout      wait timeout seconds for response.
                         Default 1.
@@ -96,12 +79,14 @@ Usage: nbtscan [-v] [-d] [-t timeout] [-b bandwidth] [-r] [-q] [-s separator] <s
         -q              Suppress banners and error messages,
         -s separator    Script-friendly output. Don't print
                         column and record headers, separate fields with separator.
-        -h              Print human-readble names for services.
+        -h              Print human-readable names for services.
+
                         Can only be used with -v option.
         -m retransmits  Number of retransmits. Default 0.
+        -f filename     Take IP addresses to scan from file filename
         <scan_range>    what to scan. Can either be single IP
                         like 192.168.1.1 or
-                        range of addresses in one of two forms:
+                        range of addresses in one of two forms: 
                         xxx.xxx.xxx.xxx/xx or xxx.xxx.xxx.xxx-xxx.
 Examples:
         nbtscan -r 192.168.1.0/24
@@ -117,6 +102,9 @@ Examples:
                 192.168.0.1:ADMINISTRATOR:03U
                 192.168.0.2:OTHER_BOX:00U
                 ...
+        nbtscan -f iplist
+                Scans IP addresses specified in file iplist.
+
 
 BUGS/LIMITATIONS
 
@@ -125,6 +113,6 @@ hosts with it because Windows 95 always sends responses to name
 queries to port 137, and you cannot bind to port 137 under
 Windows (it is already taken by Windows itself).
 
-Report bugs to alla@sovlink.ru (that's me). I cannot promise to
+Report bugs to alla@inetcat.org (that's me). I cannot promise to
 do anything but I might well want fix it. Remember: no warranty.
 At least it's worth what you payed for it.