kac_trace

 

NAME

kac_trace - Katalix Access Concentrator Trace Utility  

SYNOPSIS

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

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
PPPoE PROTOCOL TRACE OPTIONS
EXAMPLES
REPORTING BUGS
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 12:21:33 GMT, April 05, 2016