mwalk - Instructions: upath

Instructions:
mwalk upath

generate | parse | upath | build | animate

The upath action of mwalk runs the upath.pl perl script. Upath.pl acts very similarly to generate.pl. In addition to producing a log of unicast traces, however, the script also produces a file (receievers.upath) which lists the path length for each successfully traced receiver.

The user passes the hostname or IP address of a machine to use as the source of the generated traces and the name of a file with a list of receiver IPs. For each receiver, the script first pings the host to ensure that it is reachable. Then it attempts to perform an traceroute from the source to the receiver. Successful traces are parsed to determine the lebgth of the unicast path.

To run the upath action, use the syntax listed below. If you want to generate logs the traceroutes, you must include the --log option. Otherwise, path lengths and general statistics will be gathered and you have the option of building the trace list in memory (--build) that can then be queried interactively (--interactive). If a source is not specified, then the localhost will be used. The default receiver file is "receivers".

Upath.pl uses traceroute. The configure script does not check for its existence at the time of build/installation. The script assumes that it is in the user's search path.

    mwalk upath [-i|--interactive] [-v|--verbose] [-l|--log]
                [-so|--source=] [-r|--receiver=]
                [-s|--stats=] [-d|--dir=] 
                [-f|--fussy] [-a|--append] [-b|--build] [-h|--help]
    Options:
      -i  --interactive  run in an interactive mode
      -v  --verbose      print verbose messages
      -l  --log          generate processing logs
      -so --source       host to use as source of traceroute [localhost]
      -r  --receiver     list of receivers to trace [receivers]
      -s  --stats        generate statistics log [stats]
      -d  --dir          output directory [.]
      -f  --fussy        use strict parsing
      -a  --append       append to existing log files
      -b  --build        accumulate traces in memory
      -h  --help         print this message

updated 05.01.01