System Administration Guide: Network Services

ProcedureHow to Turn on PPP Debugging

The next task shows how to use the pppd command to obtain debugging information.


Note –

You only need to perform step 1 through step 3 once for each host. Thereafter, you can proceed to step 4 to turn on debugging for the host.


  1. Become superuser or assume an equivalent role.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Create a log file to hold output from pppd.


    # touch /var/log/pppdebug
    
  3. Add the following syslog facilities for pppd in /etc/syslog.conf.


    daemon.debug;local2.debug       /var/log/pppdebug
    
  4. Restart syslogd.


    # pkill -HUP -x syslogd
    
  5. Turn on debugging for calls to a particular peer by using the following syntax of pppd.


    # pppd debug call peer-name 
    

    peer-name must be the name of a file in the /etc/ppp/peers directory.

  6. View the contents of the log file.


    # tail -f /var/log/pppdebug
    

    For an example of a log file, see Step 3.