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

       -n <service name>
              Specifies  the  name  of the service for which tracing should be
              enabled.  All PPPoE clients connecting using this  service  will
              be traced.

RADIUS PROTOCOL TRACE OPTIONS
       -a <address>
              Specifies the dotted quad address of the RADIUS server for which
              tracing should be enabled.   All  clients  authenticating  using
              this server will be traced.

L2TP PROTOCOL TRACE OPTIONS
       -a <address>
              Specifies  the  dotted  quad  address  of the L2TP LNS for which
              tracing should be enabled.  All clients connecting to  this  LNS
              will be traced.

       -p <tunnel profile name>
              Specifies  the  prol2tpd  tunnel  profile name for which tracing
              should be  enabled.   All  clients  using  this  tunnel  profile
              (either  specified in the proacd configuration or determined via
              RADIUS lookup) will be traced.

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.5.4                    January 2024                   proac_trace(8)