Next: , Previous: Programs, Up: Programs


1.1 Invocation

WiPal's programs all use the same invocation scheme:

     wipal-<command> [options] [inputs] [outputs]

The command line may include no options and, depending on the program, there may be no inputs or no outputs. Most programs expect at least one input however. See the specific documentation for each program in order to know how many inputs and outputs each program expects.

Inputs, outputs, and options may be mixed on the command line, e.g.:

     wipal-simple-merge -n -P input1.pcap input2.pcap output.pcap
     wipal-simple-merge input1.pcap input2.pcap output.pcap -P -n
     wipal-simple-merge input1.pcap -n input2.pcap -P output.pcap
     ...

are all equivalent.

WiPal's programs use getopt(3) to parse options, so they only have short options (no long options) composed of a dash followed by a letter (e.g. -a, -t, etc.) Option letters always have the same meaning whatever the program. All options are not available for all programs though (some options do not make sens with some programs). For instance, -P always means the invoked program should consider frames with non-zero Prism fields as invalid. In order to know which options a program accept, use the -h option.

Finally, some options expect an extra argument right after they are provided:

     wipal-test-uniqueness -a hsh_80211 input.pcap
                              ^^^^^^^^^
                              This is not an input