kac_trace
NAME
kac_trace - Katalix Access Concentrator Trace UtilitySYNOPSIS
kac_trace <on|off|dump> [options]DESCRIPTION
kac_trace is a utility used to enable and disable the tracing functionality of kacd. The options specify the type and parameters of the trace to enable or disable. Trace functionality is operated on the basis of source, destination or route tracing. For example, traces may be added for a particular source client, a particular route, or a particular destination.
OPTIONS
- -h
- Prints a brief help message.
- -s <type>
- When given as an option to the on or off commands, specifies the source type of the trace, and type must be one of the source protocols supported by kacd.
- When given as an option to the dump command, type is optional and may be used to request a dump of all traces matchng the source protocol. If no type is specified, all source traces will be dumped.
- -d <type>
- When given as an option to the on or off commands, specifies the destination type of the trace, and type must be one of the destination protocols supported by kacd.
- When given as an option to the dump command, type is optional and may be used to request a dump of all traces matching the destination protocol. If no type is specified, all destination traces will be dumped.
- -r <name>
- When given as an option to the on or off commands, name is mandatory and specifies the name of the route to trace.
- When given as an option to the dump command, name is not required and this option is used to request that route traces be dumped.
PPPoE PROTOCOL TRACE OPTIONS
- -m <address>
- Specifies the ethernet MAC address of the PPPoE client to trace, in the format xx:xx:xx:xx:xx:xx (where each 'xx' is 2 hexadecimal digits)
- -i <interface>
- Specifies the name of the interface on which tracing should be enabled. All PPPoE clients connecting via this interface will be traced. This is potentially a lot of trace information, depending on the number of clients.
EXAMPLES
- Add a new PPPoE trace for client with MAC address 00:19:D1:07:C3:A7
- kac_trace on -s pppoe -m 00:19:D1:07:C3:A7
- Add a new route trace for the route named 'vpn'
- kac_trace on -r vpn
- Add a new PPPoE trace for all clients connecting on interface eth1
- kac_trace on -s pppoe -i eth1
- Delete the PPPoE trace for client with MAC address 00:19:D1:07:C3:A7
- kac_trace off -s pppoe -m 00:19:D1:07:C3:A7
- Dump a list of all active traces
- kac_trace dump
- Dump all route and PPPoE source traces
- kac_trace dump -r -s pppoe
REPORTING BUGS
Please report bugs to <kacd-bugs@katalix.com>.SEE ALSO
kacd(8), kacd.conf(5), kac_info(8), kac_manage(8),
Index
This document was created by man2html, using the manual pages.
Time: 12:21:33 GMT, April 05, 2016