Main page | Install | ttyreplay(1) | rpldev(4) | rpl(5) | ttyrpld(7) | rplctl(8) | rpld(8) | Netlogging | Support

Name > rplctl - infod client
 
Synopsis >

rplctl [-A tty] [-D tty] [-L [tty]] [-S tty] [-X tty] [-Z [tty]] [-f socket] [-t]
 
Description >

The rplctl utility is used to query and remote control rpld and infod. It will print info about the requested ttys, or all ttys currently monitored or optionized if no arguments are given.

rplctl will read the INFOD_PORT variable from rpld.conf by default, if not overriden by the -f option.
 
Options >
-A tty Activate logging for the given tty. It can be a filename (which must exist) or a device number using "=MAJOR,MINOR".
-D tty Deactivate logging for the given tty.
-L [tty] Explicitly request a listing of all ttys currently active or have option set. If a tty is given, only display info for that particular one.
-S tty Deactivate logging for the given tty until it is deinitialized.
-X tty Call log_close() for the given tty. rpld will close the logfile, and necessarily open up a new one whenever new activity is detected (and logging this terminal is not deactivated) on that terminal.
-Z [tty] Zero all packet and byte counters, both of rpld and every single tty. If a tty is given, only zeroes the stats of that tty.
-f socket Path to the infod socket to connect to. The default is /var/run/.rplinfo_socket or INFOD_PORT in the rpld.conf configuration file.
-t Generate output suitable for sscanf(), split() or anything that deals best with simple text strings. See below for details on the output format.
 
Example output >

A command like `rplctl` could output this:

A TTY      BYTES IN       OUT FILENAME
==========================================================================
  *             528     45492 ttyrpld 1.31
  IOCD: 0/18/18/0  RW: 415/230  I: 187  B: 0
--------------------------------------------------------------------------
* vc-7          267         0 root/20041220.165259.vc-7
* pts-2         103     22599 root/20041220.165300.pts-2
* pts-3         104     22143 root/20041220.165300.pts-3
* pts-8          54       750 root/20041220.165259.pts-8
--------------------------------------------------------------------------

An asterisk in the A (status) field means "Activated", a dot "Deactivated until session ends" and a blank for "Deactivated".
 
sscanf() format >

On the other hand, `rplctl -t` could produce this:

ttyrpld 1.31
format 2
7 1623 1627 6 276228 277971 8312777 8304424 8358 0
S 4 1 vc-1 67 5883 /var/log/rpl/root/20041110.174144.vc-1
A 4 2 vc-2 13 148 /var/log/rpl/root/20041110.174158.vc-2
D 4 7 vc-7 14809 0 /var/log/rpl/root/20041110.174235.vc-7
D 4 10 vc-10 0 6020 /var/log/rpl/root/20041110.175900.vc-10
A 136 1 pts-1 5981 527066 /var/log/rpl/root/20041110.174237.pts-1
A 136 2 pts-2 7 180 /var/log/rpl/root/20041110.181123.pts-2
A 136 4 pts-4 200 7079510 /var/log/rpl/root/20041110.174143.pts-4
A 136 5 pts-5 5324 461423 /var/log/rpl/root/20041110.174235.pts-5

Where A=Activated, D=Deactivated, S=Deactivated until session ends.

The first line of the "parseable" output (-t) is the program used. It can (and should) be ignored by programs querying infod. The second is the status line about rpld. The sscanf formula is "%zu %zu %zu %zu %llu %llu %zu %zu". The fields are (in that order):

  • EVT_INIT -- tty first opens
  • EVT_OPEN -- number of open() operation on any tty
  • EVT_CLOSE -- number of close() operations on any tty
  • EVT_DEINIT -- tty deallocation
  • EVT_READ -- packets read from rpldev
  • EVT_WRITE -- packets read from rpldev
  • EVT_READ -- payload bytecount
  • EVT_WRITE -- payload bytecount
  • EVT_IOCTL packets received
  • packets considered bad (i.e. bad magic) -- might be more than there are actually damaged, because the algorithm needs to find something that looks good.

All other lines are tty information lines, whose formula is "%c %ld %ld %s %llu %llu %s", and the fields are:

  • status -- 'A' for activated, 'D' is deactivated and 'S' means deactivated until session ends.
  • major number
  • minor number
  • mnemonic string for the major/minor number
  • EVT_READ payload bytecount
  • EVT_WRITE payload bytecount
  • full filename being written to (this is different from the human-readable output which only shows it in part)
 
See also > rpld(8)
 
by Jan Engelhardt *