proac_trace(8)                  ProL2TP Manual                  proac_trace(8)



NAME
       proac_trace - ProL2TP Access Concentrator Trace Utility

SYNOPSIS
       proac_trace <on|off|dump> [options]

DESCRIPTION
       proac_trace  is a utility used to dynamically control proacd logging at
       runtime using proacd's tracing functionality.  Traces  may  be  enabled
       selectively on the basis of source, destination, or route name.

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 proacd.

              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 des-
              tination protocols supported by proacd.

              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  re-
              quired  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 hexadeci-
              mal 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,  de-
              pending on the number of clients.

EXAMPLES
       Add a new PPPoE trace for client with MAC address 00:19:D1:07:C3:A7
              proac_trace on -s pppoe -m 00:19:D1:07:C3:A7

       Add a new route trace for the route named 'vpn'
              proac_trace on -r vpn

       Add a new PPPoE trace for all clients connecting on interface eth1
              proac_trace on -s pppoe -i eth1

       Delete the PPPoE trace for client with MAC address 00:19:D1:07:C3:A7
              proac_trace off -s pppoe -m 00:19:D1:07:C3:A7

       Dump a list of all active traces
              proac_trace dump

       Dump all route and PPPoE source traces
              proac_trace dump -r -s pppoe

SEE ALSO
       proacd(8), proacd.conf(5), proac_info(8), proac_manage(8),



ProL2TP 2.1.0                     August 2020                   proac_trace(8)