manual/rp-pppoe/draft/man8/pppoe-server.8

   1 .\"
   2 .\" Japanese Version Copyright (c) 2001-2002 Yuichi SATO
   3 .\"         all rights reserved.
   4 .\" Translated Sun Oct 14 03:57:39 JST 2001
   5 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
   6 .\" Updated & Modified Thu May  9 22:00:04 JST 2002 by Yuichi SATO
   7 .\"
   8 .\" $Id: pppoe-server.8,v 1.8 2002/04/09 17:28:38 dfs Exp $
   9 .\" LIC: GPL
  10 .TH PPPOE-SERVER 8 "3 July 2000"
  11 .\""
  12 .UC 4
  13 .\"O .SH NAME
  14 .SH 名前
  15 .\"O pppoe-server \- user-space PPPoE server
  16 pppoe-server \- ユーザー空間 PPPoE サーバー
  17 .\"O .SH SYNOPSIS
  18 .SH 書式
  19 .B pppoe-server \fR[\fIoptions\fR]
  20
  21 .\"O .SH DESCRIPTION
  22 .SH 説明
  23 .\"O \fBpppoe-server\fR is a user-space server for PPPoE (Point-to-Point Protocol
  24 .\"O over Ethernet) for Linux and other UNIX systems.  \fBpppoe-server\fR works in
  25 .\"O concert with the \fBpppoe\fR client to respond to PPPoE discovery packets
  26 .\"O and set up PPPoE sessions.
  27 \fBpppoe-server\fR は PPPoE (Point-to-Point Protocol over Ethernet) の
  28 ユーザー空間サーバーであり、Linux やその他の UNIX 系システムで利用できる。
  29 \fBpppoe-server\fR は \fBpppoe\fR クライアントと関連して動作し、
  30 PPPoE discovery パケットに応答して、PPPoE セッションを設定する。
  31
  32 .\"O .SH OPTIONS
  33 .SH オプション
  34 .TP
  35 .B \-F
  36 .\"O The \fB\-F\fR option causes \fBpppoe-server\fR not to fork and become a
  37 .\"O daemon.  The default is to fork and become a daemon.
  38 \fB\-F\fR オプションを指定すると、
  39 \fBpppoe-server\fR は fork されずデーモンにならない。
  40 デフォルトでは fork されてデーモンになる。
  41
  42 .TP
  43 .B \-I \fIinterface\fR
  44 .\"O The \fB\-I\fR option specifies the Ethernet interface to use.  Under Linux,
  45 .\"O it is typically \fIeth0\fR or \fIeth1\fR.  The interface should be "up"
  46 .\"O before you start \fBpppoe-server\fR, but should \fInot\fR be configured to have
  47 .\"O an IP address.  You can supply multiple \fB\-I\fR options if you want the
  48 .\"O server to respond on more than one interface.
  49 \fB\-I\fR オプションは、使用するイーサーネットインターフェースを指定する。
  50 Linux 上では、\fIeth0\fR や \fIeth1\fR が一般的である。
  51 インターフェースは \fBpppoe-server\fR を開始する前に
  52 「アップ (起動)」しておかなければならないが、
  53 IP アドレスを設定しては\fIならない\fR。
  54 2 つ以上のインターフェースで応答するサーバーを設定するには、
  55 複数の \fB\-I\fR オプションを指定すればよい。
  56
  57 .TP
  58 .B \-T \fItimeout\fR
  59 .\"O This option is passed directly to \fBpppoe\fR; see \fBpppoe\fR(8) for
  60 .\"O details.
  61 このオプションは \fBpppoe\fR に直接渡される。
  62 詳細は \fBpppoe\fR(8) を参照すること。
  63
  64 .TP
  65 .B \-C \fIac_name\fR
  66 .\"O Specifies which name to report as the access concentrator name.  If not
  67 .\"O supplied, the host name is used.
  68 アクセス集信装置の名前として使用したい名前を指定する。
  69 指定しない場合は、ホスト名が使われる。
  70
  71 .TP
  72 .B \-S \fIname\fR
  73 .\"O Offer a service named \fIname\fR.  Multiple \fB\-S\fR options may
  74 .\"O be specified; each one causes the named service to be advertised
  75 .\"O in a Service-Name tag in the PADO frame.  The first \fB\-S\fR option
  76 .\"O specifies the default service, and is used if the PPPoE client
  77 .\"O requests a Service-Name of length zero.
  78 \fIname\fR という名前のサービスを提供する。
  79 \fB\-S\fR オプションは複数個指定できる。
  80 各 \fB\-S\fR オプションごとに、指定した名前のサービスを
  81 PADO フレームの Service-Name タグで広告できる。
  82 最初の \fB\-S\fR オプションはデフォルトのサービスを指定し、
  83 PPPoE クライアントが長さ 0 の Service-Name をリクエストした場合は、
  84 このサービスが使われる。
  85
  86 .TP
  87 .B \-m \fIMSS\fR
  88 .\"O This option is passed directly to \fBpppoe\fR; see \fBpppoe\fR(8) for
  89 .\"O details.
  90 このオプションは \fBpppoe\fR に直接渡される。
  91 詳細は \fBpppoe\fR(8) を参照すること。
  92
  93 .TP
  94 .B \-s
  95 .\"O This option is passed directly to \fBpppoe\fR; see \fBpppoe\fR(8) for
  96 .\"O details.  In addition, it causes \fBpppd\fR to be invoked with the
  97 .\"O \fIsync\fR option.
  98 このオプションは \fBpppoe\fR に直接渡される。
  99 詳細は \fBpppoe\fR(8) を参照すること。
 100 このオプションを指定すると、
 101 \fIsync\fR オプションを付けて \fBpppd\fR が起動される。
 102
 103 .TP
 104 .B \-L \fIip\fR
 105 .\"O Sets the local IP address.  This is passed to spawned \fBpppd\fR processes.
 106 .\"O If not specified, the default is 10.0.0.1.
 107 IP アドレスを設定する。
 108 このアドレスは生成される \fBpppd\fR プロセスに渡される。
 109 指定しない場合のデフォルトは 10.0.0.1 である。
 110
 111 .TP
 112 .B \-R \fIip\fR
 113 .\"O Sets the starting remote IP address.  As sessions are established,
 114 .\"O IP addresses are assigned starting from \fIip\fR.   \fBpppoe-server\fR
 115 .\"O automatically keeps track of the pool of addresses and passes a
 116 .\"O valid remote IP address to \fBpppd\fR.  If not specified, a starting address
 117 .\"O of 10.67.15.1 is used.
 118 リモート側の IP アドレスの開始点を指定する。
 119 セッションを確立すると、\fIip\fR から順に IP アドレスが割り当てられる。
 120 \fBpppoe-server\fR はアドレスのプールを自動的に監視し、
 121 有効な IP アドレスを \fBpppd\fR に渡す。
 122 指定しない場合は、開始アドレスとして 10.67.15.1 が使われる。
 123
 124 .TP
 125 .B \-N \fInum\fR
 126 .\"O Allows at most \fInum\fR concurrent PPPoE sessions.  If not specified,
 127 .\"O the default is 64.
 128 最大 \fInum\fR 個の PPPoE セッションを許可する。
 129 指定しない場合のデフォルトは 64 である。
 130
 131 .TP
 132 .B \-p \fIfname\fR
 133 .\"O Reads the specified file \fIfname\fR which is a text file consisting of
 134 .\"O one IP address per line.  These IP addresses will be assigned to clients.
 135 .\"O The number of sessions allowed will equal the number of addresses found
 136 .\"O in the file.  The \fB\-p\fR option overrides both \fB\-R\fR and \fB\-N\fR.
 137 1 行に 1 つの IP アドレスが書かれたテキストファイル \fIfname\fR を読み込む。
 138 ここに書かれた IP アドレスがクライアントに割り当てられる。
 139 許可されるセッション数は、このファイルにある IP アドレスの数に等しい。
 140 \fB\-p\fR オプションは、\fB\-R\fR と \fB\-N\fR の両方を上書きする。
 141
 142 .\"O In addition to containing IP addresses, the pool file can contain lines
 143 .\"O of the form:
 144 このプールファイルには IP アドレスだけでなく、
 145 以下の形式の行があってもよい。
 146
 147 .nf
 148         a.b.c.d-e
 149 .fi
 150
 151 .\"O which includes all IP addresses from a.b.c.d to a.b.c.e.  For example,
 152 .\"O the line:
 153 これには a.b.c.d 〜 a.b.c.e の IP アドレスが含まれる。
 154 例えば、
 155
 156 .nf
 157         1.2.3.4-7
 158 .fi
 159
 160 .\"O is equivalent to:
 161 という行は
 162
 163 .nf
 164         1.2.3.4
 165         1.2.3.5
 166         1.2.3.6
 167         1.2.3.7
 168 .fi
 169
 170 と同じである。
 171
 172 .TP
 173 .B \-r
 174 .\"O Tells the PPPoE server to randomly permute session numbers.  Instead of
 175 .\"O handing out sessions in order, the session numbers are assigned in an
 176 .\"O unpredictable order.
 177 PPPoE サーバーにセッション番号をランダムに割り当てさせる。
 178 セッションは順番に操作されるのではなく、
 179 予想できない順番で割り当てられる。
 180
 181 .TP
 182 .B \-u
 183 .\"O Tells the server to invoke \fBpppd\fR with the \fIunit\fR option.  Note
 184 .\"O that this option only works for \fBpppd\fR version 2.4.0 or newer.
 185 サーバーに対して、\fBpppd\fR に \fIunit\fR オプションをつけて起動させる。
 186 このオプションはバージョン 2.4.0 以降の \fBpppd\fR でしか
 187 動作しない点に注意すること。
 188
 189 .TP
 190 .B \-o \fIoffset\fR
 191 .\"O Instead of numbering PPPoE sessions starting at 1, they will be numbered
 192 .\"O starting at \fIoffset\fR+1.  This allows you to run multiple servers on
 193 .\"O a given machine; just make sure that their session numbers do not
 194 .\"O overlap.
 195 PPPoE セッションの開始番号を、1 ではなく、\fIoffset\fR+1 にする。
 196 これを使うと、与えられたマシン上で複数のサーバーを稼働することができる。
 197 ただし、セッション番号が重複しないように注意すること。
 198
 199 .TP
 200 .B \-f disc:sess
 201 .\"O The \fB\-f\fR option sets the Ethernet frame types for PPPoE discovery
 202 .\"O and session frames.  The types are specified as hexadecimal numbers
 203 .\"O separated by a colon.  Standard PPPoE uses frame types 8863:8864.
 204 .\"O \fIYou should not use this option\fR unless you are absolutely sure
 205 .\"O the peer you are dealing with uses non-standard frame types.
 206 \fB\-f\fR オプションは、
 207 PPPoE の discovery フレームと session フレームで使う
 208 イーサーネットフレームタイプを設定する。
 209 タイプはコロンで区切られた 16 進数で指定する。
 210 標準的な PPPoE では、フレームタイプ 8863:8864 を使う。
 211 接続先が標準的でないフレームタイプを使っていることが
 212 はっきり解っている場合以外は、
 213 \fIこのオプションを使うべきではない\fR。
 214
 215 .TP
 216 .B \-k
 217 .\"O The \fB\-k\fR option tells the server to use kernel-mode PPPoE on Linux.
 218 .\"O This option is available only on Linux kernels 2.4.0 and later, and
 219 .\"O only if the server was built with kernel-mode support.
 220 Linux で \fB\-k\fR オプションを指定すると、
 221 サーバーはカーネルモード PPPoE を使う。
 222 このオプションは、Linux カーネル 2.4.0 以降で、
 223 かつ PPPoE サーバーがカーネルモードをサポートするように
 224 構築されている場合にのみ使用可能である。
 225
 226 .TP
 227 .B \-h
 228 .\"O The \fB\-h\fR option prints a brief usage message and exits.
 229 \fB\-h\fR オプションを指定すると、
 230 使用法についての簡単なメッセージを表示して終了する。
 231
 232 .\"O .SH OPERATION
 233 .SH 動作
 234
 235 .\"O \fBpppoe-server\fR listens for incoming PPPoE discovery packets.  When
 236 .\"O a session is established, it spawns a \fBpppd\fR process.  The following
 237 .\"O options are passed to \fBpppd\fR:
 238 \fBpppoe-server\fR は入ってくる PPPoE discovery パケットを待ち受ける。
 239 セッションが確立されると、サーバーは \fBpppd\fR プロセスを生成する。
 240 以下のオプションが \fBpppd\fR に渡される:
 241
 242 .nf
 243 nodetach noaccomp nobsdcom nodeflate nopcomp novj novjccomp
 244 default-asyncmap
 245 .fi
 246
 247 .\"O In addition, the local and remote IP address are set based on the
 248 .\"O \fB\-L\fR and \fB\-R\fR options.  The \fBpty\fR option is supplied along
 249 .\"O with a \fBpppoe\fR command to initiate the PPPoE session.  Finally,
 250 .\"O additional \fBpppd\fR options can be placed in the file
 251 .\"O \fB/etc/ppp/pppoe-server-options\fR (which must exist, even if it is just
 252 .\"O empty!)
 253 さらに、\fB\-L\fR と \fB\-R\fR オプションに基づいて
 254 ローカルとリモートの IP アドレスが設定される。
 255 PPPoE セッションを初期化するために、
 256 \fBpppoe\fR コマンドに \fBpty\fR オプションが指定される。
 257 また、その他の \fBpppd\fR オプションは
 258 ファイル \fB/etc/ppp/pppoe-server-options\fR に書いておくことができる
 259 (このファイルは何も書いていなくてもよいが、存在しなければならない)。
 260
 261 .\"O Note that \fBpppoe-server\fR is meant mainly for testing PPPoE clients.
 262 .\"O It is \fInot\fR a high-performance server meant for production use.
 263 \fBpppoe-server\fR は主に PPPoE クライアントの
 264 テスト用のものである点に注意すること。
 265 製品としての使用を意図した高性能のサーバー\fIではない\fR。
 266
 267 .\"O .SH AUTHORS
 268 .SH 著者
 269 .\"O \fBpppoe-server\fR was written by David F. Skoll <dfs@roaringpenguin.com>.
 270 \fBpppoe-server\fR は
 271 David F. Skoll <dfs@roaringpenguin.com> によって作成された。
 272
 273 .\"O The \fBpppoe\fR home page is \fIhttp://www.roaringpenguin.com/pppoe/\fR.
 274 \fBpppoe\fR のホームページは
 275 \fIhttp://www.roaringpenguin.com/pppoe/\fR である。
 276
 277 .\"O .SH SEE ALSO
 278 .SH 関連項目
 279 adsl-start(8), adsl-stop(8), adsl-connect(8), pppd(8), pppoe.conf(5),
 280 pppoe(8), adsl-setup(8), adsl-status(8), pppoe-sniff(8), pppoe-relay(8)