[Scamper-dev] scamper control socket

[Matthew Luckie]

   scamper may start as a daemon and listen for commands on a control
   socket.  the control socket is bound to 127.0.0.1 on a port defined on
   the command line.  the control socket is used to define address lists
   or sources, output files, default settings, and shutting scamper down.
   the commands implemented so far are:

    get [attempts | dport | holdtime | hoplimit | pps | sport | timeout |
         version]

    set [attempts | holdtime | hoplimit | pps | timeout]

    outfile [close | list | open | swap]

      define an output file with open.  close an output file with 'close'.
      scamper will refuse to close a file if a source references it.
      in order to rotate output files, the user opens a new outfile and
      then issues a swap command.  the first file is now able to be closed.

    source [add | cycle | delete | list]

      define an address source with add.  assign the source's name,
      a description and an id that are recorded with the trace's details
      when it is completed and written to disk.  the source's priority is
      specified here.  if an address list is specified, you specify if the
      addresses are to be probed once or continuously.  you can also
      specify if the addresslist should be reloaded at each cycle.

      if scamper is being fed addresses manually, the cycle point is defined
      by sending a cycle command.

      source add [name <name>] [descr <descr>] [id <id>] [file <name>]
                 [priority <priority>] [adhoc <on|off>] [outfile <name>]
                 [cycle <on|off>] [autoreload <on|off>]

    traceroute

      manually feed addresses to individual sources.

    shutdown [done | flush | now]

      done: tell scamper to shutdown when it is finished with the addresses
       currently being probed, and queued to be probed in each source.

      flush: tell scamper to shutdown when it is finished with the addresses
       currently being probed.  flush each source of queued addresses.

      now: tell scamper to abort any traces underway and exit.