pppstatus(1M)

pppstatus -- display status of a Point-to-Point Protocol bundle

Synopsis

pppstatus [ -v ] [ -p period ] [ -t timeout ] bundle

Description

pppstatus displays status information for the named PPP bundle. (The bundle must have been previously configured using ppptalk(1M).) In non-verbose mode, information on the state of the bundle, bundle protocols and link protocols is provided. In verbose mode, full information is provided on the standard output.

pppstatus runs until a timeout occurs.

The following options are available:

-p period: Provides status information every period seconds.
-t timeout: Set the timeout value in seconds. A timeout value of 0 (default) means that pppstatus will not exit until killed.
-v: Turn on verbose mode. In non-verbose mode, limited status information is displayed on screen. In verbose mode full information is provided to the standard output.

Multilink considerations

In non-verbose mode, pppstatus displays the state of links on the screen. If the screen is not large enough to accommodate information about all links, the information will be truncated. For systems using high numbers of links within a single bundle, use the verbose option to provide full information about all links.

Exit codes

The following exit codes can be used to diagnose problems:

0: Success.
1: The command syntax is invalid.
2: The bundle name is invalid.
3: A timeout occurred.
4: An unexpected error from pppd occurred.
6: A dialer error occurred.
7: An unspecified error occurred.

References

pppattach(1M), pppdetach(1M), ppplinkadd(1M), ppplinkdrop(1M), ppptalk(1M)