Show linkdump.asc syntax highlighted
Linkdump
========
The EmStar Team <emstar-design at cens.ucla.edu>
$Id: linkdump.asc,v 1.2 2005/08/31 23:52:16 karenyc Exp $
Linkdump is used to display packets received to a selected EmStar device. The usage instructions (as displayed on the command line) are:
Usage: ./bin/linkdump (Mixed_Sources)
[-h] [-o <loglevel>] [-v] [--startdir <dir>] [--daemon] [-G <sim_group>] [-N <node_id>]
-U <link> [-t <type>] [-l] [-f] [-s] [-r] [-d] [-n] [-T] [-m] [-P]
--help: Print this message
-o <loglevel>: set the default stdout loglevel
-v: report version information
--daemon: startup as a daemon (detach)
--startdir: chdir to <dir> before running; useful with --daemon
--group_id <id>: Overrides the SIM_GROUP environment variable
--node_id <id>: Overrides the node ID in /etc/id or SIM_ID
--stop-on-startup: stop in misc_init() and wait for GDB to attach
--enable-remote: make devices available over the network via FUSDNet
--uses <link>: specify the link to use
--type <type>: filter for this type
--loop : enable loopback
--flush : flush IO after each receive
--status : report status changes
--dump-raw : dump raw packet data
--dump-data : attempt to parse packet data
--promisc : enable ACTIVE promiscuous reception
--no-promisc : disable PASSIVE promiscuous reception
--show-errors : open the errors packet device
--timestamps : print packet timestamps
--multihop : interpret packets as multihop packets
Most common args:
linkdump -U mote0 -d -l -P
(listen to /dev/link/mote0 interface, dump-data, loopback, promisc)
Note, in simulation mode, use -G and -N to select group and node to watch.
Note on promiscuous modes. Linkdump defaults to "passive promiscuous mode",
which will show all packets that are available for reception. It will not
actively enable promiscuous reception, but if another client does it will
display all packets that that client would receive. If --no-promisc is set,
it will only dump packets that would be received by a non-promisc recevier.
If --promisc is set, it will actively enable promiscuous mode in the lower
layer and dump all packets.
The most important parts of linkdump to understand:
- The -U option - specify the device to receive packets from. Generally will be mote0 for ESS applications
- The -m option will translate multihop packets and show other useful information like the type of a received packet and its sequence number. NOTE: seem to be some endian issues (maybe?) with the sequence numbers, but it is adequate to check that the sequence numbers are increasing correctly
- The -r option dumps raw packet data
See more files for this project here
EmStar is a software system for developing and deploying wireless sensor networks involving Linux-based platforms. As the wireless sensor network community has attempted to deploy more complex designs---large-scale, long-lived systems that need self-organization and adaptivity---a number of difficult software design issues have arisen. Advances in software design have not kept pace with the capabilities of hardware. This is because designing for an adaptive, efficient, and useful sensor network has turned out to be surprisingly complex and difficult. EmStar is a Linux-based software framework, whose goal is to dramatically reduce this complexity, enabling work to be shared and reused, and simplifying and speeding the design of new sensor network applications.
Project homepage:
http://cvs.cens.ucla.edu/emstar/
Programming language(s): C,Shell Script
License: other
ceiling_install.asc
gdb.asc
index.asc
linkdump.asc
wrapper.asc