man7.org > Linux > man-pages

Linux/UNIX system programming training

rtmon(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE EXAMPLES | SEE ALSO | AUTHOR | COLOPHON 

RTMON(8)                 System Manager's Manual                RTMON(8)

NAME         top

       rtmon - listens to and monitors RTnetlink

SYNOPSIS         top

       rtmon [ OPTIONS ] file FILE [ all | OBJECTS ]

       OPTIONS := { f[amily] { inet | inet6 | link | help } | -4 | -6 |
               -0 | -V[ersion] }

       OBJECTS := [ link ] [ address ] [ route ]

DESCRIPTION         top

       This manual page documents briefly the rtmon command.

       rtmon listens on netlink socket and monitors routing table
       changes.

       rtmon can be started before the first network configuration
       command is issued.  For example if you insert:

       rtmon file /var/log/rtmon.log

       in a startup script, you will be able to view the full history
       later.  Certainly, it is possible to start rtmon at any time. It
       prepends the history with the state snapshot dumped at the moment
       of starting.

OPTIONS         top

       rtmon supports the following options:

       -Version
              Print version and exit.

       help   Show summary of options.

       file FILE [ all | OBJECTS ]
              Log output to FILE. OBJECTS is the list of object types
              that we want to monitor. It may contain 'link', 'address',
              'route' and 'all'. 'link' specifies the network device,
              'address' the protocol (IP or IPv6) address on a device,
              'route' the routing table entry and 'all' does what the
              name says.

       -family [ inet | inet6 | link | help ]
              Specify protocol family. 'inet' is IPv4, 'inet6' is IPv6,
              'link' means that no networking protocol is involved and
              'help' prints usage information.

       -4     Use IPv4. Shortcut for -family inet.

       -6     Use IPv6. Shortcut for -family inet6.

       -0     Use a special family identifier meaning that no networking
              protocol is involved. Shortcut for -family link.

USAGE EXAMPLES         top

       # rtmon file /var/log/rtmon.log
              Log to file /var/log/rtmon.log, then run:

       # ip monitor file /var/log/rtmon.log
              to display logged output from file.

SEE ALSO         top

       ip(8) ip-monitor(8)

AUTHOR         top

       rtmon was written by Alexey Kuznetsov <[email protected]>.

       This manual page was written by Michael Prokop <[email protected]>,
       for the Debian project (but may be used by others).

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling
       TCP/IP networking and traffic) project.  Information about the
       project can be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       [email protected], [email protected].  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-11.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to [email protected]

                                                                RTMON(8)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI