man/man8/ip-monitor.8

   1 .TH IP\-MONITOR 8 "20 Dec 2011" "iproute2" "Linux"
   2 .SH "NAME"
   3 ip-monitor and rtmon \- state monitoring
   4 .SH "SYNOPSIS"
   5 .sp
   6 .ad l
   7 .in +8
   8 .ti -8
   9 .BR "ip monitor" " [ " all " |"
  10 .IR LISTofOBJECTS " ]"
  11 .sp
  12
  13 .SH DESCRIPTION
  14 The
  15 .B ip
  16 utility can monitor the state of devices, addresses
  17 and routes continuously.  This option has a slightly different format.
  18 Namely, the
  19 .B monitor
  20 command is the first in the command line and then the object list follows:
  21
  22 .BR "ip monitor" " [ " all " |"
  23 .IR LISTofOBJECTS " ]"
  24
  25 .I OBJECT-LIST
  26 is the list of object types that we want to monitor.
  27 It may contain
  28 .BR link ", " address " and " route "."
  29 If no
  30 .B file
  31 argument is given,
  32 .B ip
  33 opens RTNETLINK, listens on it and dumps state changes in the format
  34 described in previous sections.
  35
  36 .P
  37 If a file name is given, it does not listen on RTNETLINK,
  38 but opens the file containing RTNETLINK messages saved in binary format
  39 and dumps them.  Such a history file can be generated with the
  40 .B rtmon
  41 utility.  This utility has a command line syntax similar to
  42 .BR "ip monitor" .
  43 Ideally,
  44 .B rtmon
  45 should be started before the first network configuration command
  46 is issued. F.e. if you insert:
  47 .sp
  48 .in +8
  49 rtmon file /var/log/rtmon.log
  50 .in -8
  51 .sp
  52 in a startup script, you will be able to view the full history
  53 later.
  54
  55 .P
  56 Certainly, it is possible to start
  57 .B rtmon
  58 at any time.
  59 It prepends the history with the state snapshot dumped at the moment
  60 of starting.
  61
  62 .SH SEE ALSO
  63 .br
  64 .BR ip (8)
  65
  66 .SH AUTHOR
  67 Original Manpage by Michail Litvak <mci@owl.openwall.com>