PIMCTL(8) System Manager's Manual PIMCTL(8) NAME pimctl -- Control tool for pimd(8) SYNOPSIS pimctl [-mpthv] [-i NAME] [-u FILE] [COMMAND] pimctl help | kill | restart | status | version pimctl debug [? | none | SYSTEM [,SYSTEM]] pimctl log [? | none | LEVEL] pimctl show igmp pimctl show interface pimctl show neighbor pimctl show mrt [detail] pimctl show rp pimctl show crp pimctl show compat [detail] pimctl show pim [detail] DESCRIPTION pimctl is the friendly control tool for pimd(8), pimdd(8), and pim6sd(8). It can be used to query status, debug, restart, and kill a running PIM dae- mon. Commands can be abbreviated to the minimum unambiguous prefix; for example, s in for show interface. OPTIONS This program follows the usual UNIX command line syntax, with long options starting with two dashes (`-'). The options are as follows: -h, --help Show usage instructions and exit. -i, --ident NAME Connect to named PIM daemon instance. Since the same pimctl is ca- pable supporting all the PIM daemon's it comes with heuristics to aid the user, i.e., if only one of the supported daemon's is run- ning this option is not required. -m, --monitor Run [COMMAND] every two seconds, for limited systems that do not have watch(1), which is highly recommended with pimctl. -p, --plain Use plain table headings, no ANSI ctrl characters. When using watch(1), use watch -c option instead, it handles ANSI escape se- quences. -t, --no-heading Skip table headings altogether. Useful for scripting pimctl. -u, --ipc FILE Override UNIX domain socket filename, the default is based on the identity, -i NAME. On most systems this is /var/run/pimd.sock. COMMANDS The pimctl tool from this project can be used with any of the other PIM daemons, so the available commands vary. When a PIM daemon is running the pimctl tool querys it over IPC for available commands. The pimd daemon comes with the following commands: pimctl help Show usage instructions and exit. pimctl kill Kill running daemon, like sending SIGTERM to the PIM daemon. pimctl restart Restart daemon and reload /etc/pimd.conf, like sending SIGHUP to the PIM daemon. pimctl status Show PIM daemon status. pimctl debug [? | none | SYSTEM [,SYSTEM]] Control subystem debugging at runtime. Multiple subsystems can be enabled, separate with comma. E.g. pimctl debug igmp,pim The command returns a list of enabled subsystems. Without any de- bug argument, the command lists the currently enabled subsystems. To list all available subsystems, use pimctl debug ? To disable all subsystems, use pimctl debug none Subsystems: all Enable all subsystems (may trigger log rate lim- iter) asserts PIM assert messages bsr PIM bootstrap router messages crp PIM Candidate Rendez-Vous Point messages detail Detailed PIM debug messages igmp Debug IGMP messages interfaces Show interface (VIF) debug messages jp PIM join-prune messages kernel Kernel debug messages mfc Debug messages for the multicast forwarding cache (kernel) mrt PIM routing messages neighbors Debug hello messages to/from neighbors packets Debug inbound/outbout packets pim All PIM messages prunes Pruning operations, or pruned routes registers PIM register tunnel debug messages rpf PIM revers-path forwarding debug messages rsrr Debug RSRR messages timers Debug timers traceroute Multicast traceroute information pimctl log [? | none | LEVEL] Control, query, or disable the log level of the PIM daemon: none Disable all logging error Error conditions warning Warning conditions notice Normal but significant condition (Default) info Informational debug Debug-level messages pimctl show igmp Show IGMP interface status and group memberships. pimctl show interfaces Show PIM interface table pimctl show neighbor Show PIM neighbor table pimctl show mrt Show PIM multicast routing table. To see the actual multicast for- warding cache (mfc), see your operating system specific command. The MROUTING stack (used in most UNIX systems today) never devel- oped socket options to query the routing table, so every operating system has its own method. On Linux this is ip mroute show on BSD systems it is usually something like netstat -g and on SVR4 systems like Illumos it is netstat -M pimctl show rp Show PIM Rendezvous-Point (RP) set pimctl show crp Show PIM Candidate Rendezvous-Point (CRP) set. pimctl show compat Show PIM status, compat mode. Previously available as pimd -r, as well as sending SIGUSR1 to the daemon to get output in /var/run/pimd/pimd.dump. These methods are no longer available, only this compat command remains. pimctl show pim [detail] Modern variant of the show compat command. FILES /var/run/pimd.sock Unix-domain socket used for communication with pimd(8) Note, the basename used changes when running with a different identity, -i NAME, or when another PIM daemon from the same family is found. SEE ALSO pimd(8), pimdd(8), pim6sd(8), /usr/share/doc/pimd/ AUTHORS pimd was originally written by Ahmed Helmy, George Edmond "Rusty" Eddy, and Pavlin Ivanov Radoslavov. PIM-SSM, including full IGMPv3 support, was added by Markus Veranen. With contributions by many others. pimctl was written by Joachim Wiberg. FreeBSD ports 15.quarterly Sep 12, 2021 PIMCTL(8)
Want to link to this manual page? Use this URL:
<https://man.FreeBSD.org/cgi/man.cgi?query=pimctl&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>