pppattach(1M)

pppattach -- open a manual outgoing Point-to-Point Protocol bundle

Synopsis

pppattach -a bundle
pppattach [ -v ] [ -p period ] [ -t timeout ] bundle

Description

pppattach starts a manual outgoing PPP bundle by passing the specified bundle name to the PPP daemon, pppd(1M). (You must have previously configured the bundle using ppptalk(1M), the PPP Manager, or the PPP Internet Connection Manager.) pppd looks up the named bundle and connects to the remote host identified by the remotesys entry in the bundle.

In default synchronous mode, pppattach does not return to the shell prompt until either a usable PPP connection has been established with the remote host, or the timeout value expires.

The following options are available:

-a: Select asynchronous mode. In this mode, pppattach sends an attach command to pppd, and then exits without monitoring the state of the bundle.
-p period: The status of the bundle is checked every period seconds to verify if the bundle is usable. In verbose mode, the on-screen status is also updated.
-t timeout: Set the timeout value for the connection. The default timeout value is 120 seconds. A timeout value of 0 will cause an indefinite wait if the connection is not established.
-v: Turn on verbose mode. In this mode, status information for the bundle, bundle protocols and link protocols will be displayed.

Exit codes

In synchronous mode, the following exit codes can be used to diagnose establishment of the connection:

0: Connection establishment successful.
1: Unable to establish connection because the command or its arguments are invalid.
2: Unable to establish connection because the bundle name is invalid.
3: Unable to establish connection within the specified timeout value (note that connection establishment may still be in progress, even though pppattach has timed out and returned to the shell prompt).
4: Unable to establish connection due to an unexpected error from pppd.
6: Unable to establish connection due to a dialer error.
7: An unspecified error occurred.

References

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