From owner-man-jp-reviewer@jp.freebsd.org  Wed Dec  1 02:19:07 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id CAA65432;
	Wed, 1 Dec 1999 02:19:07 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from mail.yk.rim.or.jp (root@mail.yk.rim.or.jp [202.247.130.37])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id CAA65425
	for <man-jp-reviewer@jp.freebsd.org>; Wed, 1 Dec 1999 02:19:07 +0900 (JST)
	(envelope-from k-horik@yk.rim.or.jp)
Received: from localhost (pppa12.yk.rim.or.jp [202.247.186.12])
	by mail.yk.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id CAA19190
	for <man-jp-reviewer@jp.freebsd.org>; Wed, 1 Dec 1999 02:19:05 +0900 (JST)
To: man-jp-reviewer@jp.freebsd.org
X-Mailer: Mew version 1.93 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Message-Id: <19991201021827T.k-horik@yk.rim.or.jp>
Date: Wed, 01 Dec 1999 02:18:27 +0900
From: Kazuo Horikawa <k-horik@yk.rim.or.jp>
X-Dispatcher: imput version 980905(IM100)
Lines: 248
Reply-To: man-jp-reviewer@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: man-jp-reviewer 1717
Subject: [man-jp-reviewer 1717] pppoed.8
Errors-To: owner-man-jp-reviewer@jp.freebsd.org
Sender: owner-man-jp-reviewer@jp.freebsd.org
X-Originator: k-horik@yk.rim.or.jp

pppoed.8 $B$NK]Lu$G$9!#(B

--- pppoed.8.eng	Wed Dec  1 01:04:35 1999
+++ pppoed.8	Wed Dec  1 01:50:55 1999
@@ -25,13 +25,14 @@
 .\"
 .\" $FreeBSD: src/libexec/pppoed/pppoed.8,v 1.2.4.1 1999/11/28 16:26:51 brian Exp $
 .\"
+.\" jpman %Id: pppoed.8,v 0.0 1999/11/30 13:07:39 horikawa Stab %
 .Dd November 8, 1999
 .Dt PPPOED 8
 .Os FreeBSD
-.Sh NAME
+.Sh $BL>>N(B
 .Nm pppoed
-.Nd handle incoming PPP over Ethernet connections
-.Sh SYNOPSIS
+.Nd PPP $B%*!<%P%$!<%5%M%C%H$NF~NO@\B3$NA`:n(B
+.Sh $B=q<0(B
 .Nm pppoed
 .Op Fl Fd
 .Op Fl P Ar pidfile
@@ -39,138 +40,148 @@
 .Op Fl e Ar exec
 .Op Fl p Ar provider
 .Ar interface
-.Sh DESCRIPTION
-The
+.Sh $B2r@b(B
 .Nm
-program listens to the given
+$B%W%m%0%i%`$O!";XDj$5$l$?(B
 .Ar interface
-for PPP over Ethernet (PPPoE) service request packets, and actions them
-by negotiating a session then envoking a
+$B$KBP$7$F(B PPP $B%*!<%P%$!<%5%M%C%H(B (PPPoE) $B%5!<%S%9MW5a%Q%1%C%H$r(B listen $B$7!"(B
+$B$3$N%Q%1%C%H$X$NBP1~$H$7$F!"%;%C%7%g%s8r>D8e$K(B
 .Em PPP
-program.  The negotiation is implemented by the
+$B%W%m%0%i%`$r5/F0$7$^$9!#(B
+$B8r>D$O(B
 .Dq pppoe
-netgraph node.  See
+netgraph $B%N!<%I$H$7$F<BAu$5$l$F$$$^$9!#(B
+$B>\:Y$O(B
 .Xr ng_pppoe 8
-for details.
+$B$r;2>H$7$F$/$@$5$$!#(B
 .Pp
 .Nm
-will only offer services to clients requesting services from the given
-.Ar provider ,
-which is taken as an empty name if not provided.
-If a provider name of
+$B$O!";XDj$5$l$?(B
+.Ar provider
+$B$+$i%5!<%S%9$rMW5a$7$F$$$k%/%i%$%"%s%H$KBP$7$F$N$_!"%5!<%S%9$rDs6!$7$^$9!#(B
+.Ar provider
+$B$O!";XDj$5$l$J$$>l9g$K$O6u$NL>A0$H$5$l$^$9!#(B
+.Ar provier
+$BL>$H$7$F(B
 .Dq \&*
-is given, any PPPoE requests will be offered service.
+$B$,;XDj$5$l$k$H!"$9$Y$F$N(B PPoE $BMW5a$KBP$7$F%5!<%S%9$,Ds6!$5$l$^$9!#(B
 .Pp
-The supplied
+$B;XDj$7$?(B
 .Ar name
-will be given as the access concentrator name when establishing the
-connection.  If no
+$B$O!"@\B33NN);~$K!"%"%/%;%9=8Cf<T(B (access concentrator) $BL>$H$7$FM?$($i$l$^$9!#(B
 .Ar name
-is given, the current base hostname is used.
+$B$r;XDj$7$J$$$H!"8=:_$N%Y!<%9%[%9%HL>$,;HMQ$5$l$^$9!#(B
 .Pp
-After receiving a request (PADI) from the PPPoE netgraph node,
+PPPoE netgraph $B%N!<%I$+$i$NMW5a(B (PADI) $B<u?.8e$O!"(B
 .Nm
-.Xr fork 2 Ns No s
-a child process and returns to service further requests.  The child process
-offers service
-.Pq using Ar name
-and waits for a
-.Dv SUCCESS
-indication from the PPPoE node.  On receipt of the SUCCESS indication,
+$B$O;R%W%m%;%9$r(B
+.Xr fork 2
+$B$7!"99$J$kMW5a$X%5!<%S%9$9$k$?$a$KLa$j$^$9!#(B
+$B;R%W%m%;%9$O(B
+.Po
+.Ar name
+$B$r;HMQ$7$F(B
+.Pc
+$B%5!<%S%9$rDs6!$7!"(BPPPoE $B%N!<%I$+$i$N(B
+.Dv $B!V@.8y!W(B
+$BI=<($rBT$A$^$9!#(B
+$B!V@.8y!WI=<($r<u$1$k$H!"(B
 .Nm 
-will execute
+$B$O<!$N%3%^%s%I$r%7%'%k$N%5%V%W%m%;%9$H$7$F<B9T$7$^$9!#(B
 .Pp
 .D1 Ic exec /usr/sbin/ppp -direct Ar provider
 .Pp
-as a shell sub-process.  It is possible to specify another command using the
 .Ar exec
-argument.  This is mandatory if
+$B0z?t$r;HMQ$9$k$3$H$K$h$j!"JL$N%3%^%s%I$r;XDj2DG=$G$9!#(B
 .Ar provider
-is not given.  The child process will have standard input and standard output
-attached to the same
+$B$r;XDj$7$J$$>l9g$K$O!"$3$l$OI,?\$G$9!#(B
+$B$3$N;R%W%m%;%9$O3+;O;~$K!"I8=`F~NO$HI8=`=PNO$,!"F1$8(B
 .Xr netgraph 4
-data socket
-.Pq see Xr ng_socket 8
-when started.
+$B%G!<%?%=%1%C%H(B
+.Po
+.Xr ng_socket 8
+$B;2>H(B
+.Pc
+$B$X@\B3$5$l$^$9!#(B
 .Pp
-Upon invocation,
 .Nm
-will attach a
+$B$O5/F0;~$K!"(B
+.Dq Ar interface Ns No \&:
+$B$r%N!<%IL>$H$7$F;HMQ$7!"(B
 .Dq pppoe
-netgraph node to the relevant
+netgraph $B%N!<%I$rE,@Z$J(B
 .Dq ether
-node using
-.Dq Ar interface Ns No \&:
-as the node name, and then connect that
+$B%N!<%I$X@\B3$7$^$9!#$=$N8e$3$N(B
 .Dq pppoe
-node to a local
+$B%N!<%I$r%m!<%+%k$N(B
 .Dq socket
-node.  If the
+$B%N!<%I$X@\B3$7$^$9!#(B
 .Fl F
-flag has not been given,
+$B%U%i%0$r;XDj$7$J$$$H!"(B
 .Nm
-will then go into the background and disassociate itself from the controlling
-terminal.  When the
+$B$O%P%C%/%0%i%&%s%I%b!<%I$X0\9T$7!"@)8fC<Kv$r@Z$jN%$7$^$9!#(B
 .Fl F
-flag is given,
+$B$r;XDj$9$k$H!"(B
 .Nm
-stays in the foreground.
+$B$O%U%)%"%0%i%&%s%I$K$H$I$^$j$^$9!#(B
 .Pp
-If the
 .Fl d
-flag is given, additional diagnostics are provided (see the
-.Sx DIAGNOSTICS
-section below).
+$B%U%i%0$r;XDj$9$k$H!"DI2C$N?GCG5!G=$,Ds6!$5$l$^$9(B ($B8e=R$N(B
+.Sx $B?GCG(B
+$B$r;2>H$7$F$/$@$5$$(B)$B!#(B
 .Pp
-If
 .Ar pidfile
-is given,
+$B$r;XDj$9$k$H!"(B
 .Nm
-will write its process ID to this file on startup.
-.Sh DIAGNOSTICS
-After creating the necessary
+$B$O5/F0;~$K!"<+8J$N%W%m%;%9(B ID $B$r$3$N%U%!%$%k$X=q$-9~$_$^$9!#(B
+.Sh $B?GCG(B
+$BA0=R$N$h$&$KI,MW$J(B
 .Xr netgraph 4
-nodes as described above,
+$B%N!<%I$r:n@.$7$?8e$G$O!"(B
 .Nm
-uses
+$B$O(B
 .Xr syslogd 8
-to report all incoming connections.  If the
+$B$r;HMQ$7!"A4F~NO@\B3$rJs9p$7$^$9!#(B
 .Fl d
-flag is given,
-.Nm
-will report on the child processes creation of a new netgraph socket, it's
-service offer and the invocation of the
+$B$r;XDj$9$k$H!"(B
+$B?75,(B netgraph $B%=%1%C%H$G$N;R%W%m%;%9@8@.$H!"(B
+$B$=$N%5!<%S%9Ds6!$H!"(B
 .Em PPP
-program.
+$B%W%m%0%i%`$N5/F0$K4X$7!"(B
+.Nm
+$B$OJs9p$7$^$9!#(B
 .Pp
-It is sometimes useful to add the following to
-.Pa /etc/syslog.conf :
+.Pa /etc/syslog.conf
+$B$X(B
 .Pp
 .Dl !pppoed
 .Dl *.*				/var/log/pppoed.log
 .Pp
-and the following to
-.Pa /etc/newsyslog.conf :
+$B$rDI2C$7!"(B
+.Pa /etc/newsyslog.conf
+$B$X(B
 .Pp
 .Dl /var/log/pppoed.log			640  3	   100	*     Z
 .Pp
-.Sh SEE ALSO
+$B$rDI2C$9$k$HJXMx$J>l9g$,$"$j$^$9!#(B
+.Sh $B4XO"9`L\(B
 .Xr netgraph 4 ,
 .Xr syslog.conf 5 ,
 .Xr ng_pppoe 8 ,
 .Xr ng_socket 8 ,
 .Xr ppp 8 ,
 .Xr syslogd 8
-.Sh BUGS
-If another netgraph node is using the given interface,
+.Sh $B%P%0(B
+$B;XDj$7$?%$%s%?%U%'!<%9$rB>$N(B netgraph $B%N!<%I$,;HMQ$7$F$$$k>l9g!"(B
 .Nm
-will fail to start.  This is because
+$B$O3+;O$G$-$^$;$s!#8=:_$N(B
 .Xr netgraph 4
-does not currently allow node chaining.  This may change in the future.
-.Sh HISTORY
-The
+$B$O!"%N!<%I$NO":?$r5v$7$F$$$J$$$?$a$G$9!#(B
+$B>-Mh$3$l$OJQ99$5$l$k$+$b$7$l$^$;$s!#(B
+.Sh $BNr;K(B
 .Nm
-program was written by 
+$B%W%m%0%i%`$O(B
 .An Brian Somers Aq brian@Awfulhak.org
-and first appeared in
-.Fx 3.4 .
+$B$,5-=R$7!"(B
+.Fx 3.4
+$B$G=iEP>l$7$^$7$?!#(B
