2006-10-01 jwileman panix.com wrote:
> > In case someone's interested, I wrote a small but
useful network stumbler
> > for Jornada.
> >
> > http://w
ww.chmurka.net/p/tinystumbler.tar.gz
>
> Adam, can you tell us if your stumbler does anything
that wistumbler2 doesn't?
> What are its features?
I didn't really used wistumbler2, but as far as I recall it
didn't worked
for me. It will be best if I simply paste README here.
Tiny NetBSD stumbler v1.1, (C) 2006 Adam Wysocki <gophi
at chmurka.net>
Newest version: http://w
ww.chmurka.net/p/tinystumbler.tar.gz
1. Overview
2. Copyright
3. Brief description
4. Changelog
5. TODO and BUGS
6. Credits
7. Contact
1. Overview
===========
This little piece of software is a tiny, but still useful
wireless network
stumbler. It was intented to run on Jornada 6x0 Series
running the NetBSD
hpcsh port, but should run fine on any BSD system. It was
developed and
tested using the Orinoco Gold PCMCIA card.
2. Copyright
============
This software is released under the public domain
conditions. Feel free to
do whatever you want with it, but if you manage to make some
improvements,
consider sending the patches to me - if they're good, I will
include them
in the next release and credit you in this file.
3. Brief description
====================
Color shows the presence of AP and encryption (WEP).
- White: network was seen, but isn't seen now.
- Red: network is seen and provides WEP encryption.
- Green: network is seen and lacks WEP encryption.
WEP is also shown on Chn field as a letter W. ESS is not
shown simply
because it's useless for me 
Fields are self-explanatory I think, but just in case:
- No: Number of this AP.
- FrstSeen: When this AP was first seen during this session.
- LastSeen: When this AP was last seen.
- BSS: AP identifier (BSSID).
- Chn: Channel, optionally prefixed with W to indicate
WEP.
- Sig: Signal value.
- SNR: Signal to noise ratio.
- SSID: Network name (SSID).
Tinystumbler logs all its activity into file specified in
log.h (currently
it's hardcoded to /home/gophi/tinystumbler.log, feel free to
change )
which is periodically (every 10 messages, to be precise)
flushed and synced
onto the underlying medium (storage card).
Logging can be "disabled" by substituting
/dev/null instead of logfile.
You can quit tinystumbler by pressing Ctrl-C. Don't worry,
it will cause
clean shutdown.
4. Changelog
============
2006-10-01 v1.1
- added red color
- added vertical scrolling
- removed ESS field
- better README
- better Makefile
2006-08-29 v1.0
- initial release
5. TODO and BUGS
================
- better vertical scrolling (now it works, but it's really a
placeholder)
- when ap that had been scrolled out again appears on the
list, it won't
be shown (should be corrected along with vertical
scrolling)
- power control (driver supports it)
- ability to run a custom script with the selected network
ssid as a
parameter (for example to connect to the network and
obtain address
from dhcp)
- properly handle terminal size change (I don't really know
what for)
- properly handle too long ssids
- some command-line options (logfile path and flush/sync
interval, scan
interval, some card configuration options etc.)
- fix "make install" to install into
/usr/local/bin and not / (bsd .mk
syntax is at least confusing)
- map BSSIDs to manufacturer names
- add sound (but finish j6x0 sound driver first )
- more user-friendly (and not programmer-friendly) messages
- move the whole thing onto some kind of version control
system
- provide binary packages
6. Credits
==========
- Pawel Janowski, who made some suggestions (mainly about
the makefile)
that were included in v1.1.
- Sebastian Sosnowski, who suggested adding another color to
distinguish
protected and unprotected (WEP) networks.
7. Contact
==========
If you have any questions, feel free to reach me at
gophi#chmurka.net (in
english or polish). Obviously replace # with .
--
[ Adam Wysocki, www.chmurka.net, QTH: KO02MF, GSM: +48 514
710 213 ]
[ Software Research and Development Department, ArcaBit Sp.
z o.o. ]
[ Ul. Fortuny 9, 01-339 Warszawa, Poland * http://www.arcabit.com/
]
|