| ppp.8.m4 (53125) | ppp.8.m4 (53733) |
|---|---|
| 1.\" $FreeBSD: head/usr.sbin/ppp/ppp.8.m4 53125 1999-11-13 16:18:40Z brian $ | 1.\" $FreeBSD: head/usr.sbin/ppp/ppp.8.m4 53733 1999-11-26 22:44:33Z brian $ |
| 2.Dd 20 September 1995 3.nr XX \w'\fC00' 4.Os FreeBSD 5.Dt PPP 8 6.Sh NAME 7.Nm ppp 8.Nd Point to Point Protocol (a.k.a. user-ppp) 9.Sh SYNOPSIS --- 3583 unchanged lines hidden (view full) --- 3593In client mode, 3594.Nm 3595will attempt to use one of the given numbers (whichever it finds to 3596be agreeable with the peer), or if 3597.Dq \&* 3598is specified, 3599.Nm 3600will expect the peer to specify the number. | 2.Dd 20 September 1995 3.nr XX \w'\fC00' 4.Os FreeBSD 5.Dt PPP 8 6.Sh NAME 7.Nm ppp 8.Nd Point to Point Protocol (a.k.a. user-ppp) 9.Sh SYNOPSIS --- 3583 unchanged lines hidden (view full) --- 3593In client mode, 3594.Nm 3595will attempt to use one of the given numbers (whichever it finds to 3596be agreeable with the peer), or if 3597.Dq \&* 3598is specified, 3599.Nm 3600will expect the peer to specify the number. |
| 3601.It "set cd off|" Ns Ar seconds Ns Op \&! | 3601.It set cd Oo 3602.No off| Ns Ar seconds Ns Op \&! 3603.Oc |
| 3602Normally, 3603.Nm | 3604Normally, 3605.Nm |
| 3604checks for the existence of carrier one second after the login script is 3605complete. If it's not set, | 3606checks for the existence of carrier depending on the type of device 3607that has been opened: 3608.Bl -tag -width XXX -offset XXX 3609.It Terminal Devices 3610Carrier is checked one second after the login script is complete. If it's 3611not set, |
| 3606.Nm 3607assumes that this is because the device doesn't support carrier (which 3608is true for most 3609.Dq laplink 3610NULL-modem cables), logs the fact and stops checking | 3612.Nm 3613assumes that this is because the device doesn't support carrier (which 3614is true for most 3615.Dq laplink 3616NULL-modem cables), logs the fact and stops checking |
| 3611for carrier. However, some modems take some time to assert the carrier 3612signal, resulting in | 3617for carrier. 3618.Pp 3619As ptys don't support the TIOCMGET ioctl, the tty device will switch all 3620carrier detection off when it detects that the device is a pty. 3621.It ISDN (i4b) Devices 3622Carrier is checked once per second for 6 seconds. If it's not set after 3623the sixth second, the connection attempt is considered to have failed and 3624the device is closed. Carrier is always required for i4b devices. 3625.It PPPoE (netgraph) Devices 3626Carrier is checked once per second for 5 seconds. If it's not set after 3627the fifth second, the connection attempt is considered to have failed and 3628the device is closed. Carrier is always required for PPPoE devices. 3629.El 3630.Pp 3631All other device types don't support carrier. Setting a carrier value will 3632result in a warning when the device is opened. 3633.Pp 3634Some modems take more than one second after connecting to assert the carrier 3635signal. If this delay isn't increased, this will result in |
| 3613.Nm ppp Ns No s | 3636.Nm ppp Ns No s |
| 3614inability to detect when the link is dropped. | 3637inability to detect when the link is dropped, as 3638.Nm 3639assumes that the device isn't asserting carrier. 3640.Pp 3641The 3642.Dq set cd 3643command overrides the default carrier behaviour. |
| 3615.Ar seconds | 3644.Ar seconds |
| 3616specifies the number of seconds that | 3645specifies the maximum number of seconds that |
| 3617.Nm 3618should wait after the dial script has finished before deciding if 3619carrier is available or not. 3620.Pp 3621If 3622.Dq off 3623is specified, 3624.Nm 3625will not check for carrier on the device, otherwise 3626.Nm 3627will not proceed to the login script until either carrier is detected 3628or until 3629.Ar seconds | 3646.Nm 3647should wait after the dial script has finished before deciding if 3648carrier is available or not. 3649.Pp 3650If 3651.Dq off 3652is specified, 3653.Nm 3654will not check for carrier on the device, otherwise 3655.Nm 3656will not proceed to the login script until either carrier is detected 3657or until 3658.Ar seconds |
| 3630has elapsed. | 3659has elapsed, at which point 3660.Nm 3661assumes that the device will not set carrier. |
| 3631.Pp | 3662.Pp |
| 3663If no arguments are given, carrier settings will go back to their default 3664values. 3665.Pp |
|
| 3632If 3633.Ar seconds 3634is followed immediately by an exclaimation mark 3635.Pq Dq \&! , 3636.Nm 3637will 3638.Em require 3639carrier. If carrier is not detected after 3640.Ar seconds 3641seconds, the link will be disconnected. | 3666If 3667.Ar seconds 3668is followed immediately by an exclaimation mark 3669.Pq Dq \&! , 3670.Nm 3671will 3672.Em require 3673carrier. If carrier is not detected after 3674.Ar seconds 3675seconds, the link will be disconnected. |
| 3642.Pp 3643For ISDN devices, 3644.Nm 3645will always insist on carrier (the value 3646.Dq off 3647is invalid). Carrier is raised by the i4brbchX device driver only after 3648the call has connected. It is therefore wise to set a reasonable value 3649such as 3650.Ar 6 3651seconds. 3652.Pp 3653Carrier 3654.Em require Ns No ment 3655is ignored for all other device types - as if set to 3656.Dq off . | |
| 3657.It set choked Op Ar timeout 3658This sets the number of seconds that 3659.Nm 3660will keep a choked output queue before dropping all pending output packets. 3661If 3662.Ar timeout 3663is less than or equal to zero or if 3664.Ar timeout --- 1197 unchanged lines hidden --- | 3676.It set choked Op Ar timeout 3677This sets the number of seconds that 3678.Nm 3679will keep a choked output queue before dropping all pending output packets. 3680If 3681.Ar timeout 3682is less than or equal to zero or if 3683.Ar timeout --- 1197 unchanged lines hidden --- |