Technical article 110195

How can I debug my PPP dynamic or manual outbound dialup connection?

OpenServer 5.0.0OpenServer 5.0.2OpenServer 5.0.4OpenServer 5.0.5

Written · Last revised

Problem

When I try to connect with another PPP endpoint using a modem, I can't tell if my modem is establishing a connection.

Solution

Two convenient methods for debugging outbound PPP modem configuration and login mechanisms with other systems are detailed below:

1. Start the pppd(ADMN) daemon with a debug value of "6" or
greater.  This value will also be passed to the UUCP modem
configuration and dialing mechanisms which are used to establish
PPP endpoints via dialup connections.  (See Devices(F)).
A value of "6" allows the UUCP dialer to output sufficient
debugging information to the SCO console, usually /dev/tty01
(see multiscreen(M)).  The debugging information can only be
displayed on the main console.

To set a debug level for the ppp daemon, you can do one of the following:

- Add a "-d 6" argument to the pppd startup in /etc/S85tcp.

- Increase the debugging level by 1 each time you send the parent pppd process a SIGUSR1 signal (see signal(S)). Send it 6 SUGUSR1s to set the necessary debug level.

- Terminate (kill) the current pppd processes and restart from a privileged command prompt (as the root user) with the command "pppd -d 6", just as you did for /etc/rc2.d/S85tcp (above).

Note: The amount of debugging information produced by pppd at a debug level of 6 is much less than that of a /etc/ppphosts "debug=2" parameter, and contains different types of information. They are not related parameters, and should be used independently of each other as needed.

The remaining information not related to physical modem dialup negotiations is logged by syslogd(ADM) and usually placed into the file /usr/adm/syslog.

2. The other method is to use "/usr/lib/uutry -r -x6 <attach-name>"
(see uutry(ADM)).  <attachname> is the "uucp=" designation in the
/etc/ppphosts file and must also be present in the
/usr/lib/uucp/Systems file (see Systems(F)).
This method allows the UUCP debugging information to be displayed
on the same tty on which uutry was invoked.  It does not allow
the actual PPP interface to be established.  It only verifies the
endpoint-> modem-> connect-> login-> endpoint sequence, and will
not offer a PPP connection if it succeeds.  It allows you to easily
test modem configuration and login sequences (chat-scripts) useful
for initial setup of a new endpoint and periodic testing.
NOTE:     The -d "debug level" is NOT related to the "debug=" value
          in the /etc/ppphosts file (see ppphosts(F)).  The debug value in
          /etc/ppphosts hosts logs information between specific PPP endpoints
          and the data being passed between those connections, but not the
          UUCP modem dialup negotiations and chat-scripts.

Once the debugging level has been increased or set, there is no known way to decrease the debugging level, besides restarting pppd.

See also

ppphosts(SFF)

From the Xinuos technical article database, record 110195. Reproduced with permission. The original is at www.sco.com/ta/110195, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.