d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

mdoc(7) police: minor spelling, markup and style fixes.

Browse Source
This commit is contained in:
Ruslan Ermilov 2001-11-22 16:08:45 +00:00
parent 40e294f796
commit aa54a2e830
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=86783
1 changed files with 21 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
libexec/pppoed/pppoed.8
View File

@ -46,8 +46,8 @@ The
program listens to the given program listens to the given
.Ar interface .Ar interface
for PPP over Ethernet (PPPoE) service request packets, and actions them for PPP over Ethernet (PPPoE) service request packets, and actions them
by negotiating a session then envoking a by negotiating a session then invoking a
.Em PPP .Xr ppp 8
program. program.
The negotiation is implemented by the The negotiation is implemented by the
.Dq pppoe .Dq pppoe
@ -61,7 +61,7 @@ will only offer services to clients requesting services from the given
.Ar provider , .Ar provider ,
which is taken as an empty name if not provided. which is taken as an empty name if not provided.
If a provider name of If a provider name of
.Dq \&* .Dq *
is given, any PPPoE requests will be offered service. is given, any PPPoE requests will be offered service.
.Pp .Pp
The supplied The supplied
@ -73,7 +73,7 @@ is given, the current base hostname is used.
.Pp .Pp
After receiving a request (PADI) from the PPPoE netgraph node, After receiving a request (PADI) from the PPPoE netgraph node,
.Nm .Nm
.Xr fork 2 Ns No s .Xr fork 2 Ns s
a child process and returns to service further requests. a child process and returns to service further requests.
The child process offers service The child process offers service
(using (using
@ -81,11 +81,13 @@ The child process offers service
and waits for a and waits for a
.Dv SUCCESS .Dv SUCCESS
indication from the PPPoE node. indication from the PPPoE node.
On receipt of the SUCCESS indication, On receipt of the
.Dv SUCCESS
indication,
.Nm .Nm
will execute will execute
.Pp .Pp
.D1 Ic exec /usr/sbin/ppp -direct Ar label .D1 Ic exec Pa /usr/sbin/ppp Fl direct Ar label
.Pp .Pp
as a shell sub-process. as a shell sub-process.
If If
@ -109,7 +111,7 @@ data socket
when started. when started.
.Pp .Pp
The environment variable The environment variable
.Dv HISMACADDR .Ev HISMACADDR
is made available to the child process and is set to the MAC address of is made available to the child process and is set to the MAC address of
the peer. the peer.
.Pp .Pp
@ -120,7 +122,7 @@ will attach a
netgraph node to the relevant netgraph node to the relevant
.Dq ether .Dq ether
node using node using
.Dq Ar interface Ns No \&: .Dq Ar interface Ns \&:
as the node name, and then connect that as the node name, and then connect that
.Dq pppoe .Dq pppoe
node to a local node to a local
@ -128,24 +130,24 @@ node to a local
node. node.
If the If the
.Fl F .Fl F
flag has not been given, option has not been given,
.Nm .Nm
will then go into the background and disassociate itself from the controlling will then go into the background and disassociate itself from the controlling
terminal. terminal.
When the When the
.Fl F .Fl F
flag is given, option is given,
.Nm .Nm
stays in the foreground. stays in the foreground.
.Pp .Pp
If the If the
.Fl d .Fl d
flag is given, additional diagnostics are provided (see the option is given, additional diagnostics are provided (see the
.Sx DIAGNOSTICS .Sx DIAGNOSTICS
section below). section below).
If the If the
.Fl n .Fl n
flag is given, option is given,
.Fn NgSetDebug .Fn NgSetDebug
is called with an argument of is called with an argument of
.Ar ngdebug . .Ar ngdebug .
@ -165,11 +167,11 @@ uses
to report all incoming connections. to report all incoming connections.
If the If the
.Fl d .Fl d
flag is given, option is given,
.Nm .Nm
will report on the child processes creation of a new netgraph socket, it's will report on the child processes creation of a new netgraph socket, it's
service offer and the invocation of the service offer and the invocation of the
.Em PPP .Xr ppp 8
program. program.
If the If the
.Fl n .Fl n
@ -178,14 +180,15 @@ option is given, netgraph diagnostic messages are also redirected to
.Pp .Pp
It is sometimes useful to add the following to It is sometimes useful to add the following to
.Pa /etc/syslog.conf : .Pa /etc/syslog.conf :
.Pp .Bd -literal -offset indent
.Dl !pppoed !pppoed
.Dl "*.* /var/log/pppoed.log *.* /var/log/pppoed.log
.Ed
.Pp .Pp
and the following to and the following to
.Pa /etc/newsyslog.conf : .Pa /etc/newsyslog.conf :
.Pp .Pp
.Dl "/var/log/pppoed.log 640 3 100 * Z .Dl "/var/log/pppoed.log 640 3 100 * Z"
.Sh SEE ALSO .Sh SEE ALSO
.Xr NgSetDebug 3 , .Xr NgSetDebug 3 ,
.Xr netgraph 4 , .Xr netgraph 4 ,