ppplinkdrop(1M)

ppplinkdrop -- drop a link from a Point-to-Point Protocol bundle

Synopsis

ppplinkdrop -a bundle [ link ]
ppplinkdrop [ -v ] [ -p period ] [ -t timeout ] bundle [ link ]

Description

ppplinkdrop drops a link from a PPP bundle by passing the specified bundle and optional link to the PPP daemon, pppd(1M). (The bundle and link must have been previously configured using ppptalk(1M).) pppd looks up the bundle and link names, and then removes the link from the bundle. If a link name is not specified, pppd selects a pre-configured link in the bundle.

In default synchronous mode, ppplinkdrop does not return to the shell prompt until either the link has been dropped, or a timeout has occurred.

The following options are available:

-a: Select asynchronous mode. In this mode, pppattach sends a linkdrop 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 dropping the link. The default timeout value is 120 seconds. A timeout value of 0 may cause an indefinite wait if the link is not dropped.
-v: Turn on verbose mode. In this mode, status information for the bundle, bundle protocols and link protocols will be displayed.

Multilink considerations

In verbose mode, the state of links are displayed on screen. If a link has been specified then information on that link only will be displayed along with bundle and link protocol information. If a link is not specified then information on links will be shown up to the point where the information would overflow the screen. For systems using high numbers of links within a single bundle, use pppstatus(1M) to provide full information about all links.

Exit codes

In synchronous mode, the following exit codes can be used to diagnose problems with dropping the link:

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

References

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