From 05b40ac89d10d8cd07891ae4f2bd2eac81d1cb44 Mon Sep 17 00:00:00 2001 From: Hiroyuki Hanai Date: Fri, 27 Feb 1998 01:27:49 +0000 Subject: [PATCH] Now, Japanese manual is for 2.2-980221-SNAP. Reviewed by: The Japanese Manual Project Submitted by: Kazuo Horikawa --- ja/man/man1/Makefile | 8 +- ja/man/man1/bison.1 | 4 +- ja/man/man1/btreeop.1 | 76 +- ja/man/man1/c89.1 | 169 ++ ja/man/man1/cal.1 | 82 - ja/man/man1/catman.1 | 6 +- ja/man/man1/cdcontrol.1 | 62 +- ja/man/man1/chmod.1 | 11 +- ja/man/man1/cksum.1 | 15 +- ja/man/man1/date.1 | 14 +- ja/man/man1/dc.1 | 6 +- ja/man/man1/dd.1 | 9 +- ja/man/man1/df.1 | 2 +- ja/man/man1/ed.1 | 2 +- ja/man/man1/error.1 | 50 +- ja/man/man1/find.1 | 16 +- ja/man/man1/fstat.1 | 23 +- ja/man/man1/ftp.1 | 6 +- ja/man/man1/gctags.1 | 24 +- ja/man/man1/getNAME.1 | 10 +- ja/man/man1/global.1 | 76 +- ja/man/man1/gtags.1 | 53 +- ja/man/man1/gzip.1 | 2 +- ja/man/man1/htags.1 | 19 +- ja/man/man1/indent.1 | 15 +- ja/man/man1/jot.1 | 247 ++- ja/man/man1/killall.1 | 2 +- ja/man/man1/ktrace.1 | 2 +- ja/man/man1/limits.1 | 3 +- ja/man/man1/login.1 | 21 +- ja/man/man1/ls.1 | 2 +- ja/man/man1/mail.1 | 2 +- ja/man/man1/merge.1 | 6 +- ja/man/{man8/rmgroup.8 => man1/minigzip.1} | 69 +- ja/man/man1/mv.1 | 2 +- ja/man/man1/ncal.1 | 118 ++ ja/man/man1/passwd.1 | 1 + ja/man/man1/patch.1 | 16 +- ja/man/man1/ps.1 | 6 +- ja/man/man1/rpcgen.1 | 738 +++---- ja/man/man1/rtld.1 | 2 +- ja/man/man1/sh.1 | 27 +- ja/man/man1/su.1 | 6 +- ja/man/man1/tar.1 | 182 +- ja/man/man1/tcpdump.1 | 2 +- ja/man/man1/tcpslice.1 | 2 +- ja/man/man1/telnet.1 | 17 +- ja/man/man1/tip.1 | 8 +- ja/man/man1/top.1 | 2 +- ja/man/man1/tr.1 | 17 +- ja/man/man1/vidcontrol.1 | 49 +- ja/man/man1/w.1 | 2 +- ja/man/man1/whois.1 | 47 +- ja/man/man1/xten.1 | 44 +- ja/man/man1/ypwhich.1 | 100 + ja/man/man8/Makefile | 3 +- ja/man/man8/adduser.8 | 8 +- ja/man/man8/apm.8 | 41 +- ja/man/man8/arp.8 | 6 +- ja/man/man8/atrun.8 | 20 +- ja/man/man8/boot_i386.8 | 6 +- ja/man/man8/bootpd.8 | 4 +- ja/man/man8/dump.8 | 2 +- ja/man/man8/fingerd.8 | 16 +- ja/man/man8/ftpd.8 | 39 +- ja/man/man8/getty.8 | 19 +- ja/man/man8/ifconfig.8 | 2 +- ja/man/man8/inetd.8 | 8 +- ja/man/man8/ipfw.8 | 41 +- ja/man/man8/ldconfig.8 | 10 +- ja/man/man8/lfs_cleanerd.8 | 6 +- ja/man/man8/mail.local.8 | 6 +- ja/man/man8/mailstats.8 | 6 +- ja/man/man8/makekey.8 | 6 +- ja/man/man8/mknetid.8 | 50 +- ja/man/man8/mount.8 | 3 +- ja/man/man8/mount_cd9660.8 | 2 +- ja/man/man8/mount_nfs.8 | 2 +- ja/man/man8/moused.8 | 498 ++++- ja/man/man8/natd.8 | 27 +- ja/man/man8/newfs.8 | 21 +- ja/man/man8/pccardd.8 | 2 +- ja/man/man8/{addgroup.8 => pnpinfo.8} | 86 +- ja/man/man8/ppp.8 | 2045 ++++++++++++-------- ja/man/man8/pppctl.8 | 240 ++- ja/man/man8/pw.8 | 4 +- ja/man/man8/rbootd.8 | 20 +- ja/man/man8/revnetgroup.8 | 59 +- ja/man/man8/rexecd.8 | 24 +- ja/man/man8/rlogind.8 | 33 +- ja/man/man8/rpc.rquotad.8 | 14 +- ja/man/man8/rpc.rstatd.8 | 15 +- ja/man/man8/rpc.rusersd.8 | 12 +- ja/man/man8/rpc.rwalld.8 | 23 +- ja/man/man8/rpc.sprayd.8 | 12 +- ja/man/man8/rpc.yppasswdd.8 | 56 +- ja/man/man8/rshd.8 | 54 +- ja/man/man8/rstat_svc.8 | 2 +- ja/man/man8/scsi.8 | 62 +- ja/man/man8/shutdown.8 | 26 +- ja/man/man8/slstat.8 | 4 +- ja/man/man8/spkrtest.8 | 6 +- ja/man/man8/spray.8 | 7 +- ja/man/man8/sysctl.8 | 55 +- ja/man/man8/syslogd.8 | 30 +- ja/man/man8/talkd.8 | 8 +- ja/man/man8/telnetd.8 | 109 +- ja/man/man8/tftpd.8 | 24 +- ja/man/man8/timed.8 | 37 +- ja/man/man8/timedc.8 | 16 +- ja/man/man8/traceroute.8 | 2 +- ja/man/man8/trpt.8 | 15 +- ja/man/man8/tzsetup.8 | 19 +- ja/man/man8/uucpd.8 | 10 +- ja/man/man8/vipw.8 | 10 +- ja/man/man8/vnconfig.8 | 43 +- ja/man/man8/watch.8 | 24 +- ja/man/man8/wlconfig.8 | 17 +- ja/man/man8/wormcontrol.8 | 26 +- ja/man/man8/xntpd.8 | 429 ++-- ja/man/man8/xtend.8 | 61 +- ja/man/man8/yp_mkdb.8 | 64 +- ja/man/man8/ypbind.8 | 20 +- ja/man/man8/yppush.8 | 46 +- ja/man/man8/ypserv.8 | 192 +- ja/man/man8/ypset.8 | 4 +- ja/man/man8/ypxfr.8 | 184 +- ja_JP.eucJP/man/man1/Makefile | 8 +- ja_JP.eucJP/man/man1/bison.1 | 4 +- ja_JP.eucJP/man/man1/btreeop.1 | 76 +- ja_JP.eucJP/man/man1/c89.1 | 169 ++ ja_JP.eucJP/man/man1/catman.1 | 6 +- ja_JP.eucJP/man/man1/cdcontrol.1 | 62 +- ja_JP.eucJP/man/man1/chmod.1 | 11 +- ja_JP.eucJP/man/man1/cksum.1 | 15 +- ja_JP.eucJP/man/man1/date.1 | 14 +- ja_JP.eucJP/man/man1/dc.1 | 6 +- ja_JP.eucJP/man/man1/dd.1 | 9 +- ja_JP.eucJP/man/man1/df.1 | 2 +- ja_JP.eucJP/man/man1/ed.1 | 2 +- ja_JP.eucJP/man/man1/error.1 | 50 +- ja_JP.eucJP/man/man1/find.1 | 16 +- ja_JP.eucJP/man/man1/fstat.1 | 23 +- ja_JP.eucJP/man/man1/ftp.1 | 6 +- ja_JP.eucJP/man/man1/gctags.1 | 24 +- ja_JP.eucJP/man/man1/getNAME.1 | 10 +- ja_JP.eucJP/man/man1/global.1 | 76 +- ja_JP.eucJP/man/man1/gtags.1 | 53 +- ja_JP.eucJP/man/man1/gtar.1 | 182 +- ja_JP.eucJP/man/man1/gzip.1 | 2 +- ja_JP.eucJP/man/man1/htags.1 | 19 +- ja_JP.eucJP/man/man1/indent.1 | 15 +- ja_JP.eucJP/man/man1/jot.1 | 247 ++- ja_JP.eucJP/man/man1/killall.1 | 2 +- ja_JP.eucJP/man/man1/ktrace.1 | 2 +- ja_JP.eucJP/man/man1/limits.1 | 3 +- ja_JP.eucJP/man/man1/login.1 | 21 +- ja_JP.eucJP/man/man1/ls.1 | 2 +- ja_JP.eucJP/man/man1/mail.1 | 2 +- ja_JP.eucJP/man/man1/merge.1 | 6 +- ja_JP.eucJP/man/man1/minigzip.1 | 69 + ja_JP.eucJP/man/man1/mv.1 | 2 +- ja_JP.eucJP/man/man1/ncal.1 | 118 ++ ja_JP.eucJP/man/man1/passwd.1 | 1 + ja_JP.eucJP/man/man1/patch.1 | 16 +- ja_JP.eucJP/man/man1/ps.1 | 6 +- ja_JP.eucJP/man/man1/rpcgen.1 | 738 +++---- ja_JP.eucJP/man/man1/sh.1 | 27 +- ja_JP.eucJP/man/man1/su.1 | 6 +- ja_JP.eucJP/man/man1/tar.1 | 182 +- ja_JP.eucJP/man/man1/tcpdump.1 | 2 +- ja_JP.eucJP/man/man1/tcpslice.1 | 2 +- ja_JP.eucJP/man/man1/telnet.1 | 17 +- ja_JP.eucJP/man/man1/tip.1 | 8 +- ja_JP.eucJP/man/man1/top.1 | 2 +- ja_JP.eucJP/man/man1/tr.1 | 17 +- ja_JP.eucJP/man/man1/vidcontrol.1 | 49 +- ja_JP.eucJP/man/man1/w.1 | 2 +- ja_JP.eucJP/man/man1/whois.1 | 47 +- ja_JP.eucJP/man/man1/xten.1 | 44 +- ja_JP.eucJP/man/man1/ypwhich.1 | 100 + ja_JP.eucJP/man/man8/Makefile | 3 +- ja_JP.eucJP/man/man8/adduser.8 | 8 +- ja_JP.eucJP/man/man8/apm.8 | 41 +- ja_JP.eucJP/man/man8/arp.8 | 6 +- ja_JP.eucJP/man/man8/atrun.8 | 20 +- ja_JP.eucJP/man/man8/boot_i386.8 | 6 +- ja_JP.eucJP/man/man8/bootpd.8 | 4 +- ja_JP.eucJP/man/man8/dump.8 | 2 +- ja_JP.eucJP/man/man8/fingerd.8 | 16 +- ja_JP.eucJP/man/man8/ftpd.8 | 39 +- ja_JP.eucJP/man/man8/getty.8 | 19 +- ja_JP.eucJP/man/man8/ifconfig.8 | 2 +- ja_JP.eucJP/man/man8/inetd.8 | 8 +- ja_JP.eucJP/man/man8/ipfw.8 | 41 +- ja_JP.eucJP/man/man8/ldconfig.8 | 10 +- ja_JP.eucJP/man/man8/mail.local.8 | 6 +- ja_JP.eucJP/man/man8/mailstats.8 | 6 +- ja_JP.eucJP/man/man8/makekey.8 | 6 +- ja_JP.eucJP/man/man8/man8.i386/apm.8 | 41 +- ja_JP.eucJP/man/man8/mknetid.8 | 50 +- ja_JP.eucJP/man/man8/mount.8 | 3 +- ja_JP.eucJP/man/man8/mount_cd9660.8 | 2 +- ja_JP.eucJP/man/man8/mount_nfs.8 | 2 +- ja_JP.eucJP/man/man8/moused.8 | 498 ++++- ja_JP.eucJP/man/man8/natd.8 | 27 +- ja_JP.eucJP/man/man8/newfs.8 | 21 +- ja_JP.eucJP/man/man8/pccardd.8 | 2 +- ja_JP.eucJP/man/man8/pnpinfo.8 | 59 + ja_JP.eucJP/man/man8/ppp.8 | 2045 ++++++++++++-------- ja_JP.eucJP/man/man8/pppctl.8 | 240 ++- ja_JP.eucJP/man/man8/pw.8 | 4 +- ja_JP.eucJP/man/man8/rbootd.8 | 20 +- ja_JP.eucJP/man/man8/revnetgroup.8 | 59 +- ja_JP.eucJP/man/man8/rexecd.8 | 24 +- ja_JP.eucJP/man/man8/rlogind.8 | 33 +- ja_JP.eucJP/man/man8/rpc.rquotad.8 | 14 +- ja_JP.eucJP/man/man8/rpc.rstatd.8 | 15 +- ja_JP.eucJP/man/man8/rpc.rusersd.8 | 12 +- ja_JP.eucJP/man/man8/rpc.rwalld.8 | 23 +- ja_JP.eucJP/man/man8/rpc.sprayd.8 | 12 +- ja_JP.eucJP/man/man8/rpc.yppasswdd.8 | 56 +- ja_JP.eucJP/man/man8/rshd.8 | 54 +- ja_JP.eucJP/man/man8/rstat_svc.8 | 2 +- ja_JP.eucJP/man/man8/shutdown.8 | 26 +- ja_JP.eucJP/man/man8/slstat.8 | 4 +- ja_JP.eucJP/man/man8/spkrtest.8 | 6 +- ja_JP.eucJP/man/man8/spray.8 | 7 +- ja_JP.eucJP/man/man8/sysctl.8 | 55 +- ja_JP.eucJP/man/man8/syslogd.8 | 30 +- ja_JP.eucJP/man/man8/talkd.8 | 8 +- ja_JP.eucJP/man/man8/telnetd.8 | 109 +- ja_JP.eucJP/man/man8/tftpd.8 | 24 +- ja_JP.eucJP/man/man8/timed.8 | 37 +- ja_JP.eucJP/man/man8/timedc.8 | 16 +- ja_JP.eucJP/man/man8/traceroute.8 | 2 +- ja_JP.eucJP/man/man8/trpt.8 | 15 +- ja_JP.eucJP/man/man8/tzsetup.8 | 19 +- ja_JP.eucJP/man/man8/uucpd.8 | 10 +- ja_JP.eucJP/man/man8/vipw.8 | 10 +- ja_JP.eucJP/man/man8/vnconfig.8 | 43 +- ja_JP.eucJP/man/man8/watch.8 | 24 +- ja_JP.eucJP/man/man8/wlconfig.8 | 17 +- ja_JP.eucJP/man/man8/wormcontrol.8 | 26 +- ja_JP.eucJP/man/man8/xntpd.8 | 429 ++-- ja_JP.eucJP/man/man8/xtend.8 | 61 +- ja_JP.eucJP/man/man8/yp_mkdb.8 | 64 +- ja_JP.eucJP/man/man8/ypbind.8 | 20 +- ja_JP.eucJP/man/man8/yppush.8 | 46 +- ja_JP.eucJP/man/man8/ypserv.8 | 192 +- ja_JP.eucJP/man/man8/ypset.8 | 4 +- ja_JP.eucJP/man/man8/ypxfr.8 | 184 +- 252 files changed, 9577 insertions(+), 5677 deletions(-) create mode 100644 ja/man/man1/c89.1 delete mode 100644 ja/man/man1/cal.1 rename ja/man/{man8/rmgroup.8 => man1/minigzip.1} (60%) create mode 100644 ja/man/man1/ncal.1 create mode 100644 ja/man/man1/ypwhich.1 rename ja/man/man8/{addgroup.8 => pnpinfo.8} (52%) create mode 100644 ja_JP.eucJP/man/man1/c89.1 create mode 100644 ja_JP.eucJP/man/man1/minigzip.1 create mode 100644 ja_JP.eucJP/man/man1/ncal.1 create mode 100644 ja_JP.eucJP/man/man1/ypwhich.1 create mode 100644 ja_JP.eucJP/man/man8/pnpinfo.8 diff --git a/ja/man/man1/Makefile b/ja/man/man1/Makefile index 57e6863387..3198e3384a 100644 --- a/ja/man/man1/Makefile +++ b/ja/man/man1/Makefile @@ -12,7 +12,7 @@ MAN1 = a2p.1\ bison.1\ brandelf.1\ btreeop.1\ - cal.1\ + c89.1\ calendar.1\ cap_mkdb.1\ cat.1\ @@ -175,6 +175,7 @@ MAN1 = a2p.1\ md5.1\ merge.1\ mesg.1\ + minigzip.1\ mkdep.1\ mkdir.1\ mkdosfs.1\ @@ -186,6 +187,7 @@ MAN1 = a2p.1\ msgs.1\ mt.1\ mv.1\ + ncal.1\ netstat.1\ newaliases.1\ nfsstat.1\ @@ -325,6 +327,7 @@ MAN1 = a2p.1\ yes.1\ ypcat.1\ ypmatch.1\ + ypwhich.1\ yyfix.1\ zdiff.1\ zforce.1\ @@ -359,7 +362,7 @@ MLINKS+= chpass.1 ypchpass.1 chpass.1 ypchfn.1 chpass.1 ypchsh.1 MLINKS+= compress.1 uncompress.1 MLINKS+= ee.1 ree.1 MLINKS+= expand.1 unexpand.1 -MLINKS+= ftp.1 pftp.1 +MLINKS+= ftp.1 pftp.1 ftp.1 gate-ftp.1 MLINKS+= hexdump.1 hd.1 MLINKS+= lex.1 flex.1 MLINKS+= lex.1 flex++.1 @@ -380,5 +383,6 @@ MLINKS+= rtprio.1 idprio.1 MLINKS+= cksum.1 sum.1 MLINKS+= ktrace.1 trace.1 ktrace.1 truss.1 MLINKS+= uuencode.1 uudecode.1 +MLINKS+= ncal.1 cal.1 .include "bsd.prog.mk" diff --git a/ja/man/man1/bison.1 b/ja/man/man1/bison.1 index f5db17dd65..7716ef6dfb 100644 --- a/ja/man/man1/bison.1 +++ b/ja/man/man1/bison.1 @@ -339,9 +339,9 @@ bison \-y $* ただしこれは POSIX.2 標準と非互換であるため、 将来 `+' サポートはなくなるでしょう。 .SH 関連ファイル -/usr/local/lib/bison.simple 単純なパーサ +/usr/share/misc/bison.simple 単純なパーサ .br -/usr/local/lib/bison.hairy 複雑なパーサ +/usr/share/misc/bison.hairy 複雑なパーサ .SH 関連項目 .IR yacc (1) .br diff --git a/ja/man/man1/btreeop.1 b/ja/man/man1/btreeop.1 index 8fc9a8fc35..cc8f76fe0c 100644 --- a/ja/man/man1/btreeop.1 +++ b/ja/man/man1/btreeop.1 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd April 21, 1997 +.Dd Nov 26, 1997 .\" jpman %Id: btreeop.1,v 1.3 1997/06/18 13:41:54 jsakai Stab % .Dt BTREEOP 1 .Os BSD 4 @@ -39,12 +39,10 @@ .Nm btreeop .Op Fl A .Op Fl C -.Op Fl D Ar key -.Op Fl K Ar key -.Op Fl b -.Op Fl c Ar cashesize -.Op Fl l -.Op Fl p Ar psize +.Op Fl D[keyno] Ar key +.Op Fl K[keyno] Ar key +.Op Fl L +.Op Fl k Ar prefix .Op Ar dbname .Sh 解説 .Nm btreeop @@ -55,6 +53,9 @@ は、データベースを作成したり、レコードを記入したり、(シーケンシャルや インデックスで)レコードを読み出したり、レコードを削除したりすることができます。 重複したエントリを持つこともできます。 +複数のキーが利用可能ですが、 +.Xr btree 3 +のインデックスとしてはプライマリキーだけが利用されます。 .Sh オプション 大文字はコマンドを示します。コマンドが指定されなかった場合は、 シーケンシャルな読み出しであると想定します。 @@ -64,23 +65,28 @@ btreeop はそれを作成します。 .It Fl C データベースを作成し、レコードを記入します。 -.It Fl D Ar key +.It Fl D[keyno] Ar key key を用いてレコードを削除します。 -.It Fl K Ar key +デフォルトでは、 keyno は0(すなわちプライマリキー)です。 +.It Fl K[keyno] Ar key key を用いてレコードを検索します。 -.It Fl b -バイトオーダが BIG_ENDIAN であると仮定します。デフォルトでは LITTLE_ENDIAN -です。 -.It Fl c Ar cashesize -キャッシュサイズを指定します。BTREEINFO の -.Nm info.cachesize -と等価です (btree(3) 参照)。 -.It Fl l -バイトオーダが LITTLE_ENDIAN であると仮定します。(デフォルトです) -.It Fl p Ar psize -ページサイズを指定します。BTREEINFO の -.Nm info.psize -と等価です (btree(3) 参照)。 +デフォルトでは、 keyno は0(すなわちプライマリキー)です。 +.It Fl L +全てのプライマリキーを表示します。 +以下の二つのコマンド行は、後者がはるかに速いことを除いて等価です。 + + btreeop | awk '{print $1}' | uniq + + btreeop -L +.It Fl k Ar prefix +プライマリキーとして prefix を持つレコードを検索します。 +このオプションは (-L コマンドもしくはコマンドが与えられていない場合の +ように) シーケンシャルに読み込む操作に対してだけ有効です。 +以下の二つのコマンド行は、後者がはるかに速いことを除いて等価です。 + + btreeop | awk '$1 ~ /^fo/ {print }' + + btreeop -k fo .It Ar dbname データベース名を指定します。デフォルトは 'btree' です。 .Sh データフォーマット @@ -89,8 +95,11 @@ key はデータを標準入力から読み込みます。 データのフォーマットは以下のようになります。 - Key Data\\n - Key Data\\n + プライマリキー 2番目のキー-1 2番目のキー-2 Data + (keyno = 0) (keyno = 1) (keyno = 2) + -------------------------------------------------------------- + main 246 main.c main (){\\n + func 120 library.c func(a1, a2)\\n . . . @@ -99,7 +108,7 @@ key .Bl -enum -offset indent .It -key とデータはブランク ('\\t' あるいは ' ') で区切られます。 +全ての key とデータはブランク('\\t' あるいは ' ') で区切られます。 .It key にブランクを含めることはできません。 .It @@ -132,10 +141,10 @@ key シーケンシャルな読み出し % btreeop + key1 data1 + key2 data2-2 key2 data2 key3 data3 - key2 data2-2 - key1 data1 % インデックスによる読み出し @@ -147,6 +156,14 @@ key __.VERSION 2 % +プライマリキーの一覧 + + % btreeop -L + key1 + key2 + key3 + % + レコードの削除 % btreeop -D ' __.VERSION' @@ -160,11 +177,12 @@ key .El .Sh 診断 .Nm btreeop -は、エラーが発生した場合、値 1 で終了します。その他の場合は、0 で終了します。 +は、エラーが発生した場合、 0 以外の値で終了します。 +その他の場合は、0 で終了します。 .Sh 関連項目 .Xr btree 3 .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは、FreeBSD 2.2 から登場しました。 +コマンドは、FreeBSD 2.2.2 から登場しました。 diff --git a/ja/man/man1/c89.1 b/ja/man/man1/c89.1 new file mode 100644 index 0000000000..6498209396 --- /dev/null +++ b/ja/man/man1/c89.1 @@ -0,0 +1,169 @@ +.\" +.\" Copyright (c) 1997 Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: c89.1,v 1.2.2.2 1998/01/12 06:21:14 obrien Exp % +.\" " +.Dd September 17, 1997 +.Os +.Dt C89 1 +.Sh 名称 +.Nm c89 +.Nd Posix.2 対応 C 言語コンパイラ +.Sh 書式 +.Nm c89 +.Op Fl c +.Op Fl D Ar name Ns Op Ar =value +.Op ... +.Op Fl E +.Op Fl g +.Op Fl I Ar directory ... +.Op Fl L Ar directory ... +.Op Fl o Ar outfile +.Op Fl O +.Op Fl s +.Op Fl U Ar name ... +.Ar operand ... +.Sh 解説 +これは +.St -p1003.2 +標準にて要求されている、C 言語コンパイラの名称です。 +.Pp +.Nm +コンパイラは以下のオプションを受け付けます: +.Bl -tag -offset indent -width "-D name = value" +.It Fl c +コンパイル時にリンクエディットフェーズを実行しません。 +生成されたオブジェクトファイルを一切削除しません。 +.It Fl D Ar name Ns Op Ar =value +C 言語の +.Ql #define +ディレクティブ(前処理指令)で指定したかのように名前を定義します。 +.Ar =value +が与えられない場合、値 1 が使用されます。 +.Fl D +オプションは +.Fl U +オプションより低い優先度を持ちます。 +すなわち +.Ar name +が +.Fl U +と +.Fl D +の両方で使用された場合、オプションの順序によらず、 +.Ar name +は未定義になります。 +.Fl D +オプションは複数回指定可能です。 +.It Fl E +全プリプロセッサディレクティブを展開し、 +C 言語ソースファイルを標準出力へコピーします。 +コンパイルは行いません。 +.It Fl g +オブジェクトや実行ファイル中にシンボル情報を生成します。 +.It Fl I Ar directory +絶対パス名ではないヘッダを検索するアルゴリズムを、 +通常の場所を検索する前に +.Ar directory +で指定されるディレクトリを探すという方法に変更します。 +ダブルクォート (\&"\&") で括られた名前のヘッダは、 +.Ql #include +行を指定したファイルのディレクトリ、 +次に +.Fl I +オプションで指定したディレクトリ、 +最後に通常の場所で探します。 +アングルブラケット (<>) で括られた名前のヘッダは、 +.Fl I +オプションで指定したディレクトリと +通常の場所のみで探します。 +.Fl I +オプションで指定したディレクトリは指定した順番で探します。 +.Fl I +オプションは複数回指定可能です。 +.It Fl L Ar directory +.Fl l +で指定されるライブラリを検索するアルゴリズムを、 +通常の場所を検索する前に +.Ar directory +で指定されるディレクトリを探すという方法に変更します。 +.Fl L +オプションで指定したディレクトリは指定した順番で探します。 +.Fl L +は複数回指定可能です。 +.It Fl o Ar outfile +パス名 +.Ar outfile +をデフォルトの +.Pa a.out +の代りに使用し、実行可能ファイルを生成します。 +.It Fl O +コンパイル時に最適化を行います。 +.It Fl s +オブジェクトや実行ファイルを生成する時、 +実行に不要な、シンボルおよびその他の情報を取り除きます +(ストリップします)。 +.It Fl U Ar name +.Ar name +の初期定義を取り除きます。 +.Fl U +オプションは複数回指定可能です。 +.El +.Pp +オペランドは、パス名、もしくは +.Fl l +ライブラリの形式です。 +パス名オペランドが少くとも一つは指定されなければなりません。 +サポートされているオペランドの形式を以下に示します: +.Bl -tag -offset indent -width "-l library" +.It Pa file Ns \&.c +C 言語ソースファイルであり、コンパイルされます。場合によっては +リンクされます。 +.Fl c +オプション使用時には、オペランドはこの形式でなければなりません。 +.It Pa file Ns \&.a +オブジェクトファイルのライブラリであり、 +.Xr ar 1 +によって生成され、直接リンクエディタに渡されます。 +.It Pa file Ns \&.o +オブジェクトファイルであり、 +.Nm +.Fl c +によって生成され、直接リンクエディタに渡されます。 +.It Fl l Pa library +.Dl lib Ns Em library Ns \&.a +という名前のライブラリを探します。 +ライブラリの名前が出てきた時点でそのライブラリ内部が検索されるので、 +.Fl l +オペランドの位置は重要です。 +.El +.Sh 関連項目 +.Xr ar 1 , +.Xr cc 1 +.Sh 規格 +.Nm +コマンドは +.St -p1003.2 +に準拠していると確信しております。 diff --git a/ja/man/man1/cal.1 b/ja/man/man1/cal.1 deleted file mode 100644 index 7a917ec90f..0000000000 --- a/ja/man/man1/cal.1 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1989, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Kim Letkeman. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)cal.1 8.2 (Berkeley) 4/28/95 -.\" jpman %Id: cal.1,v 1.2 1997/05/17 15:48:43 horikawa Stab % -.\". -.Dd April 28, 1995 -.Dt CAL 1 -.Os -.Sh 名称 -.Nm cal -.Nd カレンダを表示する -.Sh 書式 -.Nm cal -.Op Fl jy -.Op Oo Ar month Oc Ar \ year -.Sh 解説 -.Nm cal -は簡単なカレンダを表示します。 -もし引数が指定されなかった場合は今月のものを表示します。 -オプションには以下のものがあります。 -.Bl -tag -width Ds -.It Fl j -ユリウス日で表示します。(1 月 1 日を第 1 日とする通日です) -(訳注:天文学での定義とは異なります。[Mar.1996]) -.It Fl y -今年のカレンダを表示します。 -.El -.Pp -パラメータが 1 つの時は西暦年 (1 - 9999) を指定したものとして、 -その年のカレンダを表示します。 -年は完全な形で指定して下さい。例えば -.Dq Li cal 89 -では 1989 年のカレンダは表示 -.Em しません -。パラメータが 2 つの時は月 (1 - 12) と年を指定します。 -パラメータを指定しない場合は今月のカレンダを表示します。 -.Pp -一年は 1 月 1 日から始まります。 -.Pp -グレゴリオ暦への切り替えは 1752 年 9 月の 3 日目に行われたものと -しています。 -この時までに、ほとんどの国が切り替えを済ませていました (いくつかの -国は 1900 年代初期まで切り替えませんでした)。 -切り替えにあたり 11 日分の日付が飛ばされたので、この月の暦は少し -変わっています。 -.Sh 歴史 -.Nm -コマンドは -.At v6 -から登場しました。 diff --git a/ja/man/man1/catman.1 b/ja/man/man1/catman.1 index c0a546af3e..ee2d849caa 100644 --- a/ja/man/man1/catman.1 +++ b/ja/man/man1/catman.1 @@ -24,7 +24,7 @@ .\" .\" /usr/bin/catman - preformat man pages .\" -.\" %Id: catman.1,v 1.8.2.1 1996/12/10 17:23:05 joerg Exp % +.\" %Id: catman.1,v 1.8.2.2 1998/02/15 16:05:21 jkh Exp % .\" jpman %Id: catman.1,v 1.3 1997/04/01 14:14:59 horikawa Stab % .Dd Mar 12, 1995 .Dt CATMAN 1 @@ -127,9 +127,9 @@ man マニュアルの必要以上のフォーマットを避けるには ハードリンク、シンボリックリンクを使って下さい。 .Sh 関連項目 +.Xr makewhatis 1 , .Xr man 1 , -.Xr manpath 1 , -.Xr makewhatis 1 . +.Xr manpath 1 .Sh 歴史 このバージョンの .Nm catman diff --git a/ja/man/man1/cdcontrol.1 b/ja/man/man1/cdcontrol.1 index 0a0fec188d..a4e3a6fa85 100644 --- a/ja/man/man1/cdcontrol.1 +++ b/ja/man/man1/cdcontrol.1 @@ -1,4 +1,4 @@ -.\" %Id: cdcontrol.1,v 1.8.2.1 1997/09/15 06:27:47 charnier Exp % +.\" %Id: cdcontrol.1,v 1.8.2.3 1998/02/01 04:55:48 jmz Exp % .\" jpman %Id: cdcontrol.1,v 1.3 1997/07/22 09:20:03 mutoh Stab % .\" .Dd July 3, 1995 @@ -17,7 +17,10 @@ .Nm はオーディオ CD プレイヤーを操作するためのプログラムです。 device には -cd0 や mcd0 などを指定します。 +.Pa cd0 +や +.Pa mcd0 +などを指定します。 .Pp もし、device が指定されなかった場合、環境変数 .Ev DISC @@ -28,14 +31,19 @@ cd0 は対話モードになり、標準入力からコマンドを読み込みます。 .Pp 以下のオプションを使用可能です。 -.Bl -tag -width flag +.Bl -tag -width indent .It Fl s サイレントモード - テーブルヘッダ及び人間が可読なコメントを表示しません。 .It Fl v 冗長モード - 表示できる情報は全て表示します。 .It Fl f Ar discname -/dev/cd0c や mcd0 といったデバイス名を指定します。 -絶対パス及び /dev からの相対パスの指定が可能です。 +.Pa /dev/cd0c +や +.Pa mcd0 +といったデバイス名を指定します。 +絶対パス及び +.Pa /dev +からの相対パスの指定が可能です。 必要ならば最後に `c' を追加します。 .El .Pp @@ -43,38 +51,38 @@ cd0 コマンドをユニークに特定できるために必要な文字だけ指定する 必要があります。 語 -.Nm play +.Em play は省略可能です。 .Bl -tag -width Cm .It Cm play first_track last_track -.Nm first_track +.Ar first_track で指定されたトラックから -.Nm last_track +.Ar last_track で指定されたトラックまで演奏します。最初のトラックが1番になります。 .It Cm play start_m:start_s.start_f Op Ar end_m:end_s.end_f 絶対アドレス (MSF) を元に演奏します。演奏開始する時間は -.Nm start_m +.Ar start_m に演奏開始する分を、 -.Nm start_s +.Ar start_s に秒を、 -.Nm start_f +.Ar start_f にはフレーム番号を指定します。演奏終了の時間は -.Nm end_m +.Ar end_m に演奏終了する分を、 -.Nm end_s, +.Ar end_s, に秒を、 -.Nm end_f +.Ar end_f にフレーム番号を指定することで指定できます。分指定で指定できる数値は 0 から 99 の範囲の値です。秒には 0 から 59 までが指定できます。フレーム 番号は 0 から 74 までの範囲で指定できます。 .It Cm play Op Ar #start_block Op length 論理ブロック -.Nm start_block +.Ar start_block から -.Nm length +.Ar length 論理ブロック分だけ演奏します。 .It Cm pause @@ -82,7 +90,7 @@ cd0 .It Cm resume 演奏を再開します。 -.Nm pause +.Em pause で一時停止した後に使います。 .It Cm stop @@ -96,9 +104,9 @@ cd0 .It Cm setvol left_channel right_channel 左チャンネルのボリュームを -.Nm left_channel +.Ar left_channel にセットし、右チャンネルを -.Nm right_channel +.Ar right_channel にセットします。指定できる値は 0 から 255 の範囲の値です。 .It Cm volume Ar mute @@ -120,9 +128,17 @@ cd0 目次を表示します。 .It Cm status -ディスクに関する以下のような情報を表示します。 +.Op Ar audio | media | volume + +ディスクに関する以下のような情報を表示します: + +.Nm audio 現在の演奏の状態と位置、 + +.Nm media 現在のメディアカタログ状態、 + +.Nm volume 現在の左チャネル及び右チャネルのボリューム値。 .It Cm help @@ -153,9 +169,9 @@ LBA ioctl .It Pa /dev/rwcd0c .El .Sh 作者 -Jean-Marc Zucconi, -Andrey A.\ Chernov, -Serge V.\ Vakulenko +.An Jean-Marc Zucconi , +.An Andrey A.\ Chernov , +.An Serge V.\ Vakulenko .Sh 歴史 .Nm コマンドは diff --git a/ja/man/man1/chmod.1 b/ja/man/man1/chmod.1 index 24bb7bd689..46b84cdb00 100644 --- a/ja/man/man1/chmod.1 +++ b/ja/man/man1/chmod.1 @@ -34,7 +34,7 @@ .\" .\" @(#)chmod.1 8.4 (Berkeley) 3/31/94 .\" jpman %Id: chmod.1,v 1.2 1997/04/01 01:37:14 mutoh Stab % -.\" %Id: chmod.1,v 1.4.2.1 1997/02/28 07:54:25 mpp Exp % +.\" %Id: chmod.1,v 1.4.2.2 1998/02/15 10:51:43 jkh Exp % .\" .Dd March 31, 1994 .Dt CHMOD 1 @@ -104,11 +104,16 @@ .Pp .Bl -tag -width 6n -compact -offset indent .It Li 4000 -setuid (set-user-ID-on-execution) ビット。実行時にユーザ ID をセット。 +setuid (set-user-ID-on-execution) ビット。実行時にユーザ ID をセット +(ディレクトリに関しては +.Xr chmod 2 +参照)。 .It Li 2000 setgid (set-group-ID-on-execution)ビット。実行時にグループ ID をセット。 .It Li 1000 -sitcky (スティッキー) ビット。chmod(2)参照。 +sitcky (スティッキー) ビット。 +.Xr chmod 2 +参照。 .It Li 0400 所有者 (ユーザ) の読み込み許可。 .It Li 0200 diff --git a/ja/man/man1/cksum.1 b/ja/man/man1/cksum.1 index a3ae3ac152..00e2c29558 100644 --- a/ja/man/man1/cksum.1 +++ b/ja/man/man1/cksum.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)cksum.1 8.2 (Berkeley) 4/28/95 -.\" %Id: cksum.1,v 1.1.1.1.8.4 1997/09/14 23:16:54 jkh Exp % +.\" %Id: cksum.1,v 1.1.1.1.8.6 1997/11/09 16:11:13 obrien Exp % .\" jpman %Id: cksum.1,v 1.4 1997/08/10 18:27:42 horikawa Stab % .\" .Dd April 28, 1995 @@ -43,7 +43,14 @@ .Nm cksum .Nd ファイルのチェックサムとブロックカウントを表示する .Sh 書式 -.Op Fl o Ar \&1 No \&| Ar \&2 +.Oo +.Fl o Ar \&1 Xo +.No \&| +.Ar \&2 +.No \&| +.Ar \&3 +.Xc +.Oc .Op Ar file ... .Nm sum .Op Ar file ... @@ -97,6 +104,10 @@ r = s % 2^16 + (s % 2^32) / 2^16; cksum = (r % 2^16) + r / 2^16; .Ed .Pp +アルゴリズム 3 は一般に +.Ql 32bit CRC +アルゴリズムと呼ばれているものです。これは 32-bit チェックサムです。 +.Pp アルゴリズム 1, 2 のいずれも、デフォルトアルゴリズムと同じフィールドを 標準出力に書き出します。 ただし、ファイルサイズはバイト単位ではなくブロック単位となります。 diff --git a/ja/man/man1/date.1 b/ja/man/man1/date.1 index 0956349585..5a00fd11e1 100644 --- a/ja/man/man1/date.1 +++ b/ja/man/man1/date.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)date.1 8.2 (Berkeley) 11/17/93 -.\" %Id: date.1,v 1.8.2.6 1997/10/03 12:54:28 danny Exp % +.\" %Id: date.1,v 1.8.2.7 1998/02/15 11:01:38 jkh Exp % .\" jpman %Id: date.1,v 1.2 1997/03/31 23:25:55 mutoh Stab % .\" .Dd November 17, 1993 @@ -44,14 +44,14 @@ .Nd 日付と時刻の表示、設定 .Sh 書式 .Nm date +.Op Fl nu .Op Fl d Ar dst .Op Fl r Ar seconds .Op Fl t Ar minutes_west -.Op Fl nu -.Op Cm + Ns Ar format -.Op Fl v Ar [+|-]val[ymwdHM] +.Op Fl v Ns Ar [+|-]val Ns Op ymwdHM .Ar ... .Op Fl f Ar fmt Ar date | [[[[yy]mm]dd]HH]MM[\&.ss] +.Op Cm + Ns Ar format .Sh 解説 引数なしで実行すると、 .Nm date @@ -176,12 +176,12 @@ .Sh 使用例 以下のコマンド: .Bd -literal -offset indent -date ``+DATE: %m/%d/%y%nTIME: %H:%M:%S%'' +date "+DATE: 19%y-%m-%d%nTIME: %H:%M:%S" .Ed .Pp は、下のような表示を行ないます。 .Bd -literal -offset indent -DATE: 11/21/87 +DATE: 1987-11-21 TIME: 13:36:16 .Ed .Pp @@ -314,4 +314,4 @@ A .Nm date コマンドは .At v1 -から導入されました。 \ No newline at end of file +から導入されました。 diff --git a/ja/man/man1/dc.1 b/ja/man/man1/dc.1 index 3dfc2367c5..ff057edc36 100644 --- a/ja/man/man1/dc.1 +++ b/ja/man/man1/dc.1 @@ -2,11 +2,9 @@ .\" jpman %Id: dc.1,v 1.4 1997/07/26 21:29:52 horikawa Stab % .ds dc \fIdc\fP .ds Dc \fIDc\fP -.SH -名称 +.SH 名称 dc \- 任意精度の計算機 -.SH -書式 +.SH 書式 dc .SH 解説 diff --git a/ja/man/man1/dd.1 b/ja/man/man1/dd.1 index b47eb68350..d10db00eb3 100644 --- a/ja/man/man1/dd.1 +++ b/ja/man/man1/dd.1 @@ -34,7 +34,7 @@ .\" .\" @(#)dd.1 8.2 (Berkeley) 1/13/94 .\" jpman %Id: dd.1,v 1.3 1997/05/16 00:16:21 h-nokubi Stab % -.\" %Id: dd.1,v 1.2.8.2 1997/08/24 21:45:30 jkh Exp % +.\" %Id: dd.1,v 1.2.8.3 1998/02/15 11:04:28 jkh Exp % .\" .Dd January 13, 1994 .Dt DD 1 @@ -238,6 +238,13 @@ pre-4.3BSD-reno このオプションは .Cm bs= Ns Ar n によるブロックサイズ指定とは両立しません。 +.It Cm sparse +一つ以上の出力ブロックが +.Tn NUL +バイトのみからなる場合、 +.Tn NUL +で埋める代りに、必要な空間だけ出力ファイルのシークを試みます。 +結果として、疎なファイルとなります。 .It Cm swab 入力データを 2 バイトごとのペアとみなし、入れ替えます。入力が奇数 バイトだった場合、最後のデータはそのままになります。 diff --git a/ja/man/man1/df.1 b/ja/man/man1/df.1 index f103a2fe2b..fac0829467 100644 --- a/ja/man/man1/df.1 +++ b/ja/man/man1/df.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)df.1 8.2 (Berkeley) 1/13/94 +.\" %Id: df.1,v 1.4.2.3 1998/02/15 11:06:23 jkh Exp % .\" jpman %Id: df.1,v 1.2 1997/04/07 05:31:08 mutoh Stab % -.\" %Id: df.1,v 1.4.2.2 1997/09/19 06:18:10 charnier Exp % .\" .Dd January 13, 1994 .Dt DF 1 diff --git a/ja/man/man1/ed.1 b/ja/man/man1/ed.1 index fc0d4eb6d5..325013ebd9 100644 --- a/ja/man/man1/ed.1 +++ b/ja/man/man1/ed.1 @@ -1,4 +1,4 @@ -.\" %Id: ed.1,v 1.8.2.1 1997/10/12 08:09:12 jmg Exp % +.\" %Id: ed.1,v 1.8.2.2 1998/01/24 14:07:29 helbig Exp % .\" jpman %Id: ed.1,v 1.2 1997/06/09 15:03:56 jsakai Stab % .TH ED 1 "21 May 1993" .SH 名称 diff --git a/ja/man/man1/error.1 b/ja/man/man1/error.1 index 281e38dc62..bcafbc005b 100644 --- a/ja/man/man1/error.1 +++ b/ja/man/man1/error.1 @@ -48,7 +48,7 @@ .Op Fl I Ar ignorefile .Op name .Sh 解説 -.Nm error +.Nm は、エラーメッセージの解析を行ない、 多くのコンパイラや言語処理系で生成されたエラーメッセージを、 ソースファイル上で実際にエラーが発生した場所に配置させます。 @@ -57,8 +57,8 @@ スクリーンエディタのマルチウィンドウ機能の助けなしで エラーメッセージとソースコードを一緒に眺められるようにします。 .Pp -本コマンドで使用可能なオプションは以下の通りです。 -.Bl -tag -width Ds +本コマンドで使用可能なオプションは以下の通りです: +.Bl -tag -width indent .It Fl n 一切のファイルの書き換え (touch) を .Em しません。 @@ -93,7 +93,7 @@ .Dl ".c.y.foo*.h" .Pp は、 -.Nm error +.Nm コマンドが ``.c'', ``.y'', ``.foo*'', ``.h'' のいずれかのサフィックス で終了するファイル名のファイルを書き換えることを許可していることを意味します。 .It Fl s @@ -104,7 +104,7 @@ の代わりに使うファイル名を指定します。 .El .Pp -.Nm error +.Nm コマンドは、 .Ar name で指定したファイルから読み込まれた、もしくは標準入力から送られたエラー @@ -116,16 +116,16 @@ (少し変更した)エラーメッセージをコメントの形で挿入します。 言語処理系や内容によるカテゴリ分けが出来ないエラーメッセージは、 いかなるファイルにも挿入されずに、標準出力に送られます。 -.Nm error +.Nm は、全ての入力を読み終わった後でしかソースファイルを書き換えません。 .Pp -.Nm error +.Nm コマンドは、標準入力をパイプを経由して、 エラーメッセージを吐き出すプログラムにつないで使うことを想定しています。 言語処理系の中には、エラーメッセージを標準エラーに出すものもあれば、 標準出力に出すものもあります。 したがって、両方のエラーの出力先を、ともにパイプによって -.Nm error +.Nm コマンドに送ったほうがよいでしょう。 例えば、 .Xr csh 1 @@ -139,7 +139,7 @@ どんなプログラムが実行されたとしても、全てのエラーを解析する ことができるでしょう。 .Pp -.Nm error +.Nm は、 .Xr make 1 , .Xr \&cc 1 , @@ -153,29 +153,29 @@ .Xr f77 1 , .Em DEC Western Research Modula\-2 の各処理系で生成されたエラーメッセージを解析することが出来ます。 -.Nm error +.Nm コマンドは、言語プロセッサによって生成されるエラーメッセージの標準形式を 内部に持っているため、その形式の変更には敏感です。 .Em Pascal を除く全ての処理系では、エラーメッセージは1行に制限されています。 また、エラーメッセージの中には、複数のファイルの複数の行を参照する ものがあります。 -.Nm error +.Nm コマンドはエラーメッセージを複製し、そのエラーメッセージの参照する全ての行に 対して情報を付加します。 .Pp -.Nm error +.Nm コマンドは、 それぞれのエラーメッセージに対して以下の6つの動作のうち1つを行ないます。 .Bl -tag -width Em 同期 (synchronize) .It Em 同期 (synchronize) 言語処理系の中には、どのファイルを現在処理しているかについて短い メッセージを生成するものがあります。 -.Nm error +.Nm コマンドは、この情報を用いて、それぞれのエラーメッセージに ファイル名を含めないような言語についてのファイル名を判定します。 これらの同期メッセージは、 -.Nm error +.Nm コマンドによって使われ、出力されることはありません。 .It Em 捨てる (discard) 以下の2つの @@ -189,7 +189,7 @@ からのエラーメッセージは捨てます。 これは、誤ってこれらのライブラリを書き換えることがないようにするためです。 ここでもこれらのエラーメッセージは、 -.Nm error +.Nm コマンドによって使われ、出力されることはありません。 .It Em 無効化 (nullify) 特定の関数に対する @@ -222,10 +222,10 @@ .Pp 確かなエラーメッセージのみファイル挿入の候補とされます。 他のエラーメッセージは、全て -.Nm error +.Nm コマンドによって処理されるか、あるいは標準出力 に対して送られます。 -.Nm error +.Nm コマンドは、エラーメッセージをソースファイル上のエラー 行の直前の行に挿入します。 各エラーメッセージは、各言語の 1 行のコメントの形に変形されます。 @@ -246,7 +246,7 @@ 複数の行からなるコメントとプログラムの実体が同じ行にあるようなプログラムでは、 コメントの前にプログラム言語の文が現れるようにしてください。 .Pp -.Nm error +.Nm コマンドは、インタラプトシグナルおよびターミネートシグナルを受け取ります。 シグナルを受けたのがコメントを挿入する段階だった場合には、 実行中の操作を整然と終了します。 @@ -259,12 +259,12 @@ ユーザの端末 .El .Sh 歴史 -.Nm error +.Nm コマンドは、 .Bx 4.0 にて初めて実装されました。 .Sh 作者 -Robert Henry +.An Robert Henry .Sh バグ .Pp ユーザに問い合わせを行なうために、端末ファイルを直接オープンします。 @@ -274,10 +274,10 @@ Robert Henry 他のリンクファイルにはその結果が反映されません。 .Pp 言語処理系のエラーメッセージの形式が変更された場合、 -.Nm error +.Nm コマンドにはそのエラーメッセージが理解できなくなるかもしれません。 .Pp -.Nm error +.Nm コマンドは 全く機械的に処理を行うため、 1つのつまらない文法上のエラーが原因で引き起こされる @@ -287,13 +287,13 @@ Robert Henry .Pp Pascal のエラーメッセージは、本来はエラー行の後ろに来るべきです。 ( -.Nm error +.Nm コマンドは、エラー行の前にエラーメッセージを置きますが。) また、エラーのある位置を示す `\\' の配置が -.Nm error +.Nm コマンドによって乱れてしまいます。 .Pp -.Nm error +.Nm コマンドは、適度に高速に表示される .Tn CRT を見つつ仕事を行うのに適したように設計されています。 diff --git a/ja/man/man1/find.1 b/ja/man/man1/find.1 index f0aea44807..66e0e35b14 100644 --- a/ja/man/man1/find.1 +++ b/ja/man/man1/find.1 @@ -32,8 +32,8 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)find.1 8.4 (Berkeley) 4/1/94 -.\" %Id: find.1,v 1.4.2.3 1997/05/19 22:14:53 eivind Exp % +.\" @(#)find.1 8.4 (Berkeley) 4/1/94 +.\" %Id: find.1,v 1.4.2.4 1998/02/01 07:36:15 steve Exp % .\" jpman %Id: find.1,v 1.4 1997/09/23 14:13:10 horikawa Stab % .\" .Dd April 1, 1994 @@ -185,14 +185,14 @@ utility なら、真になります。 .It Ic -ls このプライマリは常に真になります。対象となっているファイルの情報を -標準出力に出力されます。出力される内容は i ノード番号、 +標準出力に出力しす。出力する内容は i ノード番号、 512 バイトブロックでのファイルの大きさ、 ファイルのパーミッション、ハードリンクの数、オーナ、グループ、 バイトで表したファイルの大きさ、最後にファイルが修正された時刻、パス名です。 ファイルがブロック型もしくはキャラクタ型のスペシャルファイルならば、 -バイトで表したファイルの大きさの代わりにメジャー番号とマイナー番号が -出力されます。ファイルがシンボリックリンクならば、 -`\`->''の後にリンク先のファイルのパス名が表示されます。 +バイトで表したファイルの大きさの代わりにメジャー番号とマイナー番号を +出力します。ファイルがシンボリックリンクならば、 +`\`->''の後にリンク先のファイルのパス名を表示します。 フォーマットは ``ls -dgils'' の出力結果と同じです。 .It Ic -mtime Ar n @@ -429,9 +429,7 @@ FIFO ユーティリティの文法は .St -p1003.2 の仕様で決められた文法のスーパセットです。 -.Fl s , -.Fl x -のオプションと +全 1 文字オプションと .Ic -inum , .Ic -print0 , .Ic -delete , diff --git a/ja/man/man1/fstat.1 b/ja/man/man1/fstat.1 index 69d173ee9f..bed98994b4 100644 --- a/ja/man/man1/fstat.1 +++ b/ja/man/man1/fstat.1 @@ -49,6 +49,8 @@ .\" となっているが、本質的な差異ではなかろう -- jpman Sakai .\"(訳中)一応，FreeBSD 2.2.1Rのマニュアルにあわせました。 .\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH +.\" uid ではなくユーザ名を指定するので、user が正しい。 +.\" .Op Fl u Ar user .Op Ar filename ... .Pp @@ -104,7 +106,7 @@ 指定されたプロセスIDのプロセスによってオープンされているすべてのファイル の情報を表示します。 .It Fl u Ar user -指定されたユーザID のユーザによってオープンされているすべてのファイル +指定されたユーザによってオープンされているすべてのファイル の情報を表示します。 .It Fl v 詳細報告モード。システムのデータ構造体を見つけるのに失敗した場合などに @@ -135,20 +137,13 @@ プロセスごとのオープンしているファイルのファイル番号、もしくは 以下の特別な名前のどれかです。 .Pp -.Bl -bullet -offset indent -compact -.It -text (実行可能テキストの inode) -.It -wd (現在のワーキングディレクトリ) -.It -root (ルートの inode) -.It -tr (カーネルトレースファイル) -.El +.Bd -literal -ragged -offset indent -compact +text - 実行可能テキストの inode +wd - 現在のワーキングディレクトリ +root - ルートの inode +tr - カーネルトレースファイル +.Ed .Pp -.\"(訳中)原文表記とは異なりますが、こちらの表示の方が読みやすいので -.\" 採用します。 -.\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH ファイル番号のあとにアスタリスク記号 ``*'' がある場合は、ファイルはinode ではなく、ソケットや .Tn FIFO diff --git a/ja/man/man1/ftp.1 b/ja/man/man1/ftp.1 index f56d2a4439..8bfd84bff7 100644 --- a/ja/man/man1/ftp.1 +++ b/ja/man/man1/ftp.1 @@ -696,7 +696,7 @@ get システムにおいては、marker は通常ファイルのバイトオフセットで指定します。 .It Ic restrict データポートの幅を制限するかをオン/オフします。 -パッシブ・モードでない時に、 +パッシブモードでない時に、 .Nm ftp クライアントは別々のデータポート上で、クライアントホストの方に リモートサーバが接続することを要求します。 @@ -1058,7 +1058,9 @@ new-line .Sh 環境変数 .Nm ftp は、以下の環境変数を使用します。 -.Bl -tag -width Fl +.Bl -tag -width "FTP_PASSIVE_MODE" +.It Ev FTP_PASSIVE_MODE +パッシブモードの FTP をデフォルトで使用します。 .It Ev HOME .Pa .netrc ファイルがあるならそのデフォルトの置き場所となります。 diff --git a/ja/man/man1/gctags.1 b/ja/man/man1/gctags.1 index 4632f433f6..57c6f57ed2 100644 --- a/ja/man/man1/gctags.1 +++ b/ja/man/man1/gctags.1 @@ -34,7 +34,7 @@ .\" .\" gctags.1 修正時には ctags.1 も同様に修正して下さい。 .\" Aug 31 1997 -.Dd Apr 21, 1997 +.Dd April 21, 1997 .Dt GCTAGS 1 .Os BSD 4 .Sh 名称 @@ -42,14 +42,14 @@ .Nd タグファイルを作成する (GLOBAL 用の特別なコマンド) .Sh 書式 .Nm gctags -.Op Fl BDFadertuwvx +.Op Fl BDFacderstuvwx .Op Fl f Ar tagsfile .Ar name ... .Sh 解説 .Nm は、指定された C, Pascal, Fortran, .Tn YACC , -lex, lisp のソースから、 +lex, lisp, アセンブリのソースから、 .Xr ex 1 コマンド用のタグファイルを作成します。 タグファイルは、指定されたオブジェクトが一群のファイル中の @@ -82,6 +82,10 @@ subroutine 既存の .Ar tags ファイルに追加します。 +.It Fl c +コンパクトフォーマットで表示します。 +.Fl x +オプション指定時にのみ有効です。 .It Fl d 引数を持たない .Li #define @@ -101,6 +105,8 @@ subroutine 関数定義ではなく関数参照の位置を提供します。 カレントディレクトリに GTAGS ファイルが必要となります ( C 言語のみ ) 。 +.It Fl s +関数以外のシンボルを集めます。 .It Fl t typedef, struct, union, enum 宣言のタグを生成します。 .It Fl u @@ -147,6 +153,10 @@ C で終わる名前のファイルは、最初の空白でない文字が `;' か `(' か `[' で あれば lisp のファイルであるとみなされ、そうでなければ lex のファイルと みなされます。 +.Nm \&.s +か +.Nm \&.S +で終るファイル名のファイルはアセンブリ言語ファイルとみなされます。 その他のファイルは、まず Pascal か Fortran の定義が含まれるか どうかがチェックされ、含まれない場合には C 形式の定義が検索されます。 .Pp @@ -175,7 +185,7 @@ GLOBAL .El .Sh 診断 .Nm -はエラーが発生すると 1 を返し、それ以外では 0 を返します。 +はエラーが発生すると非 0 を返し、それ以外では 0 を返します。 同じ名前のオブジェクトが複数出てきてもエラーとはみなされません。 .Sh 関連項目 .Xr btreeop 1 , @@ -217,6 +227,10 @@ C 複数行にわたる .Li typedef に関しても同様です。 +.Pp +アセンブリ言語サポートは完璧からは程遠く、 +ソースファイルから ENTRY() と ALTENTRY() を取り出すだけです。 +FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。 .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja/man/man1/getNAME.1 b/ja/man/man1/getNAME.1 index 1fdb3bd5f5..8fdf3d2ceb 100644 --- a/ja/man/man1/getNAME.1 +++ b/ja/man/man1/getNAME.1 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: getNAME.1,v 1.3 1996/08/27 20:04:12 wosch Exp % +.\" %Id: getNAME.1,v 1.3.2.2 1998/02/20 17:32:18 jkh Exp % .\" jpman %Id: getNAME.1,v 1.3 1997/07/22 17:20:08 horikawa Stab % .Dd July 8, 1996 @@ -34,7 +34,7 @@ .Sh 書式 .Nm /usr/libexec/getNAME .Op Fl itw -.Ar files ... +.Ar .Sh 解説 .Nm は、マニュアルから名称の章を取り出します。 @@ -45,7 +45,7 @@ データベースのエントリを作成します。 .Pp オプションには、以下のようなものがあります。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl i 導入エントリを作成します。 .It Fl t @@ -55,9 +55,9 @@ .El .\" .Sh バグ .Sh 関連項目 -.Xr man 1 , +.Xr apropos 1 , .Xr makewhatis 1 , -.Xr apropos 1 . +.Xr man 1 .Sh 歴史 .Nm コマンドのためのマニュアルは diff --git a/ja/man/man1/global.1 b/ja/man/man1/global.1 index 4f5dc5c4f6..5c2849ad26 100644 --- a/ja/man/man1/global.1 +++ b/ja/man/man1/global.1 @@ -29,52 +29,90 @@ .\" SUCH DAMAGE. .\" jpman %Id: global.1,v 1.3 1997/07/27 12:54:52 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd Nov 26, 1997 .Dt GLOBAL 1 .Os BSD 4 .Sh 名称 .Nm global -.Nd 指定した関数の位置を表示する +.Nd 指定したオブジェクトの位置を表示する .Sh 書式 .Nm global -.Op Fl acrx -.Ar name +.Op Fl alrvx +.Ar pattern +.Nm global -c +.Op Ar prefix +.Nm global +.Fl f[arx] +.Ar file +.Nm global +.Fl g[alvx] +.Ar pattern +.Nm global +.Fl i[v] +.Nm global +.Fl p +.Nm global +.Fl s[alvx] +.Ar pattern .Sh 解説 .Nm -は C や Yacc のソースファイル中から特定の関数の位置を見つけ出します。 +は C や Yacc のソースファイル中から特定のオブジェクトの位置を見つけ出します。 .Nm は、ソースツリー(サブディレクトリやソースファイルを持つディレクトリ)も 扱うことができます。 ツリー内のどこにあろうと、オブジェクトの相対パスを得ることができます。 - .Nm -は関数定義だけではなく、関数参照の位置も把握し、二重のエントリも -取り扱うことができます。 +は関数定義だけではなく、関数参照と他のシンボルの位置を把握します。 +二重のエントリも取り扱うことができます。 .Pp このコマンドを使う前に、ソースツリーのルートディレクトリで .Xr gtags 1 -を実行しなければなりません。 +を実行し、タグファイルを作成しなければなりません。 +それから、 +.Nm +をソースツリー下のいかなる場所からでも実行可能です。 .Pp 以下のオプションが使用可能です: .Bl -tag -width Ds +.It Ar pattern +オブジェクトパターン。POSIX 1003.2 の正規表現を使用可能です。 .It Fl a 絶対パスで表示します。デフォルトでは相対パス名で表示します。 -.It Fl c -指定された文字列で始まる名前の関数の候補を表示します。 -文字列が指定されない場合、すべての関数の名前を表示します。 +.It Fl c Op Ar prefix +指定された +.Ar prefix +で始まる名前の関数の候補を表示します。 +.Ar prefix +が指定されない場合、すべての関数の名前を表示します。 +.It Fl f Ar file +.Ar file +の全関数定義を表示します。このオプションは -x オプションを暗黙的に指定します。 +.It Fl g +パターンにマッチする全行を表示します。 +.It Fl i +タグファイルをインクリメンタルに再構築します。 +.It Fl l +現在のディレクトリ下に存在するオブジェクトを表示します。 .It Fl r 関数の参照場所を表示します。 デフォルトでは、関数の定義場所を表示します。 +.It Fl p +GTAGS の位置を表示します。 +.It Fl s +関数名ではなく指定したシンボルの位置を表示します。 +GSYMS タグファイルが必要です。 +.Xr gtags 1 +を参照してください。 .It Fl x デフォルトの出力に加えて、行番号と行の内容を表示します。 -.It Ar name -関数の名前です。perl の正規表現を用いることができます。 .Sh 関連ファイル .Bl -tag -width tags -compact .It Pa GTAGS -関数定義に関するタグファイルです。 +関数定義に関するタグファイル。 .It Pa GRTAGS -関数参照に関するタグファイルです。 +関数参照に関するタグファイル。 +.It Pa GSYMS +関数以外のシンボルのタグファイル。 .El .Sh 環境変数 以下の環境変数が global の実行に影響します。 @@ -125,11 +163,11 @@ global はエラーが発生すると 0 以外の値を、そうでなければ 0 を返します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr gtags 1 , -.Xr htags 1 . +.Xr htags 1 , +.Xr vi 1 . .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja/man/man1/gtags.1 b/ja/man/man1/gtags.1 index b256544c04..a65c94ddfd 100644 --- a/ja/man/man1/gtags.1 +++ b/ja/man/man1/gtags.1 @@ -29,23 +29,25 @@ .\" SUCH DAMAGE. .\" jpman %Id: gtags.1,v 1.3 1997/07/27 12:57:00 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd Sep 12, 1997 .Dt GTAGS 1 .Os BSD 4 .Sh 名称 .Nm gtags -.Nd GTAGS や GRTAGS ファイルを作成する +.Nd GTAGS, GRTAGS, GSYMS ファイルを作成する .Sh 書式 .Nm gtags -.Op Fl e -.Op Fl s +.Op Fl i +.Op Fl o ++.Op Fl v .Op Ar dbpath .Sh 解説 .Nm -は global(1) で用いる GTAGS ファイルや GRTAGS ファイルを -作成します。 +は +.Xr global 1 +で用いる GTAGS, GRTAGS, GSYMS ファイルを作成します。 .Nm -はサブディレクトリをたどり、ソースファイルを読み、関数の位置を把握して +はサブディレクトリをたどり、ソースファイルを読み、シンボルの位置を把握して その情報をタグファイルに保存します。 C や yacc やアセンブラのソースファイルがサポートされています。 このコマンドはソースツリーのルートで実行する必要があります。 @@ -56,35 +58,46 @@ C に指定します。 .Pp .Bl -tag -width Ds -.It Fl e -C のソースファイルで、一桁目の '}' を見つけた時点で関数の -終わりとします。 -.It Fl s -アセンブラのソースファイルとして扱います(*.s や *.S)。 +.It Fl i +タグファイルが最後に更新されてから更新されたファイルについてのみ +検査することにより、 +タグファイルをインクリメンタルに更新します +.It Fl o +GSYMS ファイルの作成を抑止します。 +.Xr global 1 +で +.Fl s +オプションを使用しない場合に使用してください。 +.It Fl v +冗長モード。 .Sh 関連ファイル .Bl -tag -width tags -compact .It Pa GTAGS -関数定義に関するタグファイルです。 +関数定義に関するタグファイル。 .It Pa GRTAGS -関数参照に関するタグファイルです。 +関数参照に関するタグファイル。 +.It Pa GSYMS +他のシンボルに関するタグファイル。 .El .Sh 診断 .Nm -はエラーが発生すると 1 を、そうでなければ 0 を返します。 +はエラーが発生すると非 0 を、そうでなければ 0 を返します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr global 1 , -.Xr htags 1 . +.Xr htags 1 , +.Xr vi 1 . .Sh バグ -GTAGS や GRTAGS はとても大きくなります。 +GTAGS, GRTAGS, GSYMS はとても大きくなります。 実行前にディスクの空き容量をチェックしてください。 - +.br アセンブラのサポートは完璧には程遠く、ソースファイルから ENTRY() と ALTENTRY() を抜き出すだけです。 FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。 +.br +タグファイルに関する並行制御はしていません。 .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja/man/man1/gzip.1 b/ja/man/man1/gzip.1 index 1cc00940a6..33b733eef0 100644 --- a/ja/man/man1/gzip.1 +++ b/ja/man/man1/gzip.1 @@ -112,7 +112,7 @@ VMS .I compress は一貫性のチェックをするように設計されていませんでしたが、 .I gunzip -は .Z ファイルが正しくないことを検出できるこもあります。 +は .Z ファイルが正しくないことを検出できることもあります。 もし .Z ファイルを伸長する時にエラーに会う場合には、 標準の .I uncompress がエラーを出さないという理由で .Z ファイルは正しい diff --git a/ja/man/man1/htags.1 b/ja/man/man1/htags.1 index 5db3f2e0cd..3d77a563c5 100644 --- a/ja/man/man1/htags.1 +++ b/ja/man/man1/htags.1 @@ -29,7 +29,7 @@ .\" SUCH DAMAGE. .\" jpman %Id: htags.1,v 1.3 1997/07/27 12:58:52 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd June 28, 1997 .Dt HTAGS 1 .Os BSD 4 .Sh 名称 @@ -38,7 +38,9 @@ .Sh 書式 .Nm htags .Op Fl a +.Op Fl f .Op Fl l +.Op Fl n .Op Fl v .Op Fl w .Op Fl d Ar tagdir @@ -67,12 +69,17 @@ .It Fl a アルファベット順の関数一覧を作成します。 大きなプロジェクトには有効でしょう。 +.It Fl f +CGI プログラムによる入力フォームと動的インデックスをサポートします。 +HTTP サーバの設定を行う必要があります。 .It Fl l 各行に対し名前のタグ()を生成し、他のハイパーテキストから このハイパーテキストの任意の行を指し示すことができるようにします。 デフォルトでは、参照されるオブジェクトがある行にのみタグを生成します。 +.It Fl n +行番号を表示します。デフォルトでは表示しません。 .It Fl v -冗長な表示を行います。 +冗長モード。 .It Fl w 警告メッセージを表示します。 .It Fl d Ar tagdir @@ -87,7 +94,7 @@ GTAGS .Sh 使用例 % cd /usr/src/sys # gtags -se - # htags -vat 'Welcom to FreeBSD kernel source tour!' + # htags -fnvat 'Welcom to FreeBSD kernel source tour!' % lynx HTML/index.html .Sh 関連ファイル .Bl -tag -width tags -compact @@ -109,10 +116,9 @@ htags .Sh 診断 エラーが発生すると .Nm -は 1 を返し、それ以外では 0 を返して終了します。 +は非 0 を返し、それ以外では 0 を返して終了します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr global 1 , .Xr gtags 1 . .Sh バグ @@ -122,5 +128,4 @@ htags Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 - +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja/man/man1/indent.1 b/ja/man/man1/indent.1 index 0152ea26e5..461e5d7fff 100644 --- a/ja/man/man1/indent.1 +++ b/ja/man/man1/indent.1 @@ -134,7 +134,7 @@ を指定すると、宣言の中のコンマの後ごとに改行を入れます。 .Fl nbc はこれを抑止します。デフォルトは -.Fl \&bc +.Fl \&nbc です。 .It Fl \&br , \&bl .Fl \&bl @@ -214,9 +214,9 @@ case です。 .It Fl d Ns Ar n プログラムコードの右側に書かれたものでない独立したコメントに関して、 -その場所を制御します。デフォルトは +その場所を制御します。例えば .Fl \&d\&1 -で、コードの字下げより 1 段左側にします。 +で、コードの字下げより 1 段左側にします。デフォルトの .Fl \&d\&0 を指定すると、プログラムコードの字下げに合わせます。下記「コメントの 字下げ」の節を参照して下さい。 @@ -241,6 +241,8 @@ case に続く .Ic if は、最初の if 文と同じだけ字下げされます。 +.Fl ei +がデフォルトです。 .It Fl fc1 , nfc1 .Fl fc1 で、コメントが 1 桁目から始まっている場合も整形します(しません)。こ @@ -251,14 +253,14 @@ case .Fl fc1 です。 .It Fl i Ns Ar n -1 段の字下げ量を指定します。デフォルトは 4 文字です。 +1 段の字下げ量を指定します。デフォルトは 8 文字です。 .It Fl \&ip , nip パラメータ宣言を左マージンからさらに字下げします(しません)。 デフォルトは .Fl \&ip です。 .It Fl l Ns Ar n -出力行の最大幅を指定します。デフォルトは 75 文字です。 +出力行の最大幅を指定します。デフォルトは 78 文字です。 .It Fl \&lp , nlp 継続行において括弧内のプログラムコードの位置を揃えます。左括弧がその 行で閉じていない時、継続行を前の行の左括弧の 1 文字後ろから始まるよ @@ -310,6 +312,9 @@ p1\ =\ first_procedure(second_procedure(p2, です。 .It Fl \&sc , nsc 全てのコメントの左端に、アスタリスク(`*') を置きます(置きません)。 +デフォルトは +.Fl sc +です。 .It Fl sob , nsob .Fl sob が指定されると、不要な空白行を取除きます。宣言部の後ろの余分な空白行 diff --git a/ja/man/man1/jot.1 b/ja/man/man1/jot.1 index c651779079..7f42bcab2b 100644 --- a/ja/man/man1/jot.1 +++ b/ja/man/man1/jot.1 @@ -32,166 +32,157 @@ .\" @(#)jot.1 8.1 (Berkeley) 6/6/93 .\" jpman %Id: jot.1,v 1.3 1997/07/22 17:41:47 horikawa Stab % .\" -.TH JOT 1 "June 6, 1993" -.UC 4 -.SH 名称 -jot \- 連なったデータか乱数データを出力する -.SH 書式 -.B jot [ -options -.B ] [ -\fRreps \fB[\fP begin \fB[\fP end \fB[\fP s \fB] ] ] ]\fP -.SH 解説 -.I jot -は、普通は数字の増加・減少・乱数・冗長データを一行毎に -出力するために使われます。 -オプションは、以下のように理解できます。 -.IP \fB\-r\fP -デフォルトの並んだデータの代わりに、乱数データを作成します。 -.IP \fB\-b\fP\ word -.I word +.Dd June 6, 1993 +.Dt JOT 1 +.Os +.Sh 名称 +.Nm jot +.Nd 連続ないしは、乱数データを出力する +.Sh 書式 +.Nm jot +.Op Fl cnr +.Op Fl b Ar word +.Op Fl w Ar word +.Op Fl s Ar string +.Op Fl p Ar precision +.Op reps Op begin Op end Op s +.Sh 解説 +.Nm jot +は、増加・減少・ランダム・冗長データを通常は数字で、一行毎に出力します。 +.Pp +以下のようなオプションが利用できます。 +.Bl -tag -width indent +.It Fl r +デフォルトの連続したデータの代わりに、乱数を作成します。 +.It Fl b Ar word +.Ar word を、繰り返し出力するだけです。 -.IP \fB\-w\fP\ word -.IR word +.It Fl w Ar word +.Ar word のあとに、生成されたデータを付け加え、出力します。 -8 進・16 進・指数・ASCII・ゼロで埋めた表示・右詰め表現は、 -適切な -.IR printf (3) +8 進・16 進・指数・ASCII・ゼロで埋めた表示・右詰め表現などは、適切な +.Xr printf 3 記法を -.IR word +.Ar word 中で指定することで、可能です。この場合、データは追加されるというよりも、 挿入されると考えてください。 -.IP \fB\-c\fP -これは、 \fB\-w %c\fP の省略形です。 -.IP \fB\-s\fP\ string -.IR string +.It Fl c +これは、 +.Fl w Ar %c +の省略形です。 +.It Fl s Ar string +.Ar string で分けられたデータを出力します。 普通は、改行文字がデータを分割します。 -.IP \fB\-n\fP -最後の改行 (通常出力に追加される) を出力しません。 -.IP \fB\-p\fP\ precision +.It Fl n +通常追加される、最後の改行を出力しません。 +.It Fl p Ar precision 整数 -.IR precision +.Ar precision で指定されたデータの文字数もしくは桁数だけ表示します。 -.BR \-p +.Fl p がない場合、精度値は -.I begin +.Ar begin と -.IR end +.Ar end の精度の大きい方です。 -.B \-p +.Fl p オプションは、 -.BR \-w +.Fl w に続く -.IR printf (3) +.Xr printf 3 記法が指定されている時には、上書きされます。 -.PP -最後の 4 つの引数はそれぞれデータ数・下界・上界と、 -幅の大きさまたは、乱数データのための種です。 -少なくともそれらの一つが指定されなければなりませんが、 -その他の 3 つは省略できます。 -引数として -.BR \- -を与えると、省略したと考えられます。 -これらの中から 3 つの引数をどのように選んでも、4 つ目は決定されます。 -4 つが指定され、計算された値 -.I reps -が衝突している場合、小さい方の値が使われます。 -指定された数が 3 つより少ない場合、 -.IR s +.El +.Pp +最後の 4 つの引数はそれぞれデータ数・下界・上界と、幅の大きさまたは、乱数のため +の種です。 +少なくともどれか一つが指定されなければなりませんが、その他の 3 つは引数として \ +- を与えると、省略できます。 +これら 3 つの引数を指定すれば、4 つ目が決まります。 +4 つとも指定されて、 +.Ar reps +の与えられた値と、計算された値とが相反する場合、小さい方を用います。 +指定された数が 3 つより少ない場合には、 +.Ar s を除いて、 -デフォルト値が左から右へ割り当てられます。 -.IR s は、 -.I begin +デフォルト値を左から右へ割り当てます。 +.Ar s +は、 +.Ar begin と -.I end -が共に指定される場合を除き、デフォルト値が設定されます。 -.PP -4 つの引数に対するデフォルトは、乱数データが要求された時を除いて、 +.Ar end +が共に指定された場合以外、デフォルト値が設定されます。 +.Pp +4 つの引数に対するデフォルトは、乱数が要求された時を除いて、 それぞれ、100, 1, 100, 1です。 乱数の種 -.I s -のデフォルトは、時間 (the time of day) に依存しています。 -.I reps -は、符号無し整数であることが期待されています。ゼロが与えられた場合は、 -無限回数となります。 -.I begin +.Ar s +のデフォルトは、時間 (the time of day) です。 +.Ar reps +は、符号無し整数であると想定されています。 +ゼロが与えられた場合は、無限回数となります。 +.Ar begin と -.I end -は、実数、もしくは文字の場合は対応する ASCII 値としてあたえられます。 +.Ar end +は、実数、もしくは文字の場合は対応する +.Tn ASCII +値としてあたえられます。 最後の引数は、実数でなければなりません。 -.PP +.Pp 乱数値は、 -.IR random (3) +.Xr random 3 を使って得られます。 名前 -.I jot +.Nm は、 APL 中の関数 -.IR iota +.Nm iota の部分から来ています。 -.SH 使用例 -.de IC -.IP -.ss 36 -.ft B -.. -.de NC -.br -.ss 12 -.PP -.. -.PP +.Sh 使用例 コマンド -.IC -jot 21 \-1 1.00 -.NC +.Dl jot 21 -1 1.00 + は、\-1 から 1 へ増加する等間隔の数字を 21 個出力します。 -ASCII 文字集合は、以下のように入力することで生成されます。 -.IC -jot \-c 128 0 -.NC -xaa から xaz までの文字列は以下のようにして表示できます。 -.IC -jot \-w xa%c 26 a -.NC -20 個のランダムな 8 文字は以下のようにして作成できます。 -.IC -jot \-r \-c 160 a z | rs \-g 0 8 -.NC +.Tn ASCII +文字集合は、以下のようにします。 +.Dl jot -c 128 0 +.Pp +xaa から xaz までの文字列は以下のようにします。 +.Dl jot -w xa%c 26 a +.Pp +20 個のランダムな 8 文字は以下のようにして作成します。 +.Dl "jot -r -c 160 a z | rs -g 0 8" +.Pp 無限に、 -.IR yes +.Em yes を出したい場合は、以下のようにします。 -.IC -jot \-b yes 0 -.NC -30 個の -.IR ed (1) -の置換コマンドを、2, 7, 12 行等のように (5 行毎に ) 適用したい場合は、 -以下の結果を使ってください。 +.Dl jot -b yes 0 +.Pp +.Xr ed 1 +の置換コマンドを、30 回、2, 7, 12 行等のように (5 行毎に ) 適用する場合の +解答例は以下のようになります。 .\"(訳中)(5 行毎に )は訳者が挿入しました。 .\" 2.2.1R 対象(1997/05/06) Takeshi MUTOH -.IC -jot \-w %ds/old/new/ 30 2 \- 5 -.NC +.Dl jot -w %ds/old/new/ 30 2 - 5 +.Pp だぶりのある 9, 9, 8, 8, 7 の様な列は、 -適切に精度とステップの大きさを設定することで、以下のように実現できます。 -.IC -jot 0 9 \- \-.5 -.NC -ファイルが正確に 1024 バイトであるように作成したければ、 -以下を使ってください。 -.IC -jot \-b x 512 > block -.NC +以下のように適切に精度とステップの大きさを設定することで、実現できます。 +.Dl jot 0 9 - -.5 +.Pp +ファイルが正確に 1024 バイトであるように作成するには、 +.Dl jot -b x 512 > block +.Pp 最後に、タブを 4 つのスペースに設定し、10 カラム目からはじまって、 -132 カラム目で終るようにするためには、以下のようにしてください。 -.IC -expand \-\`jot \-s, \- 10 132 4\` -.NC -80 文字以上の全ての行を表示するためには、以下を使ってください。 -.IC -grep \`jot \-s "" \-b . 80\` -.NC -.SH 関連項目 -ed(1), expand(1), rs(1), yes(1), printf(3), random(3), expand(1) +132 カラム目で終るようにするには、以下のようにします。 +.Dl expand -`jot -s, - 10 132 4` +.Pp +80 文字以上の行を全て表示するには、以下を使ってください。 +.Dl grep `jot -s \&"\&" -b \&. 80` +.Pp +.Sh 関連項目 +.Xr ed 1 , +.Xr expand 1 , +.Xr rs 1 , +.Xr yes 1 , +.Xr printf 3 , +.Xr random 3 diff --git a/ja/man/man1/killall.1 b/ja/man/man1/killall.1 index c1d14f30f6..159e54cad3 100644 --- a/ja/man/man1/killall.1 +++ b/ja/man/man1/killall.1 @@ -22,7 +22,7 @@ .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: killall.1,v 1.6 1996/08/27 20:04:19 wosch Exp % +.\" %Id: killall.1,v 1.6.2.1 1997/11/01 15:11:46 wosch Exp % .\" jpman %Id: killall.1,v 1.3 1997/07/22 18:03:26 horikawa Stab % .\" .Dd June 25, 1995 diff --git a/ja/man/man1/ktrace.1 b/ja/man/man1/ktrace.1 index 3694baed14..bdea6b75f1 100644 --- a/ja/man/man1/ktrace.1 +++ b/ja/man/man1/ktrace.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ktrace.1 8.1 (Berkeley) 6/6/93 -.\" %Id: ktrace.1,v 1.4.2.3 1997/09/15 08:32:07 jkh Exp % +.\" %Id: ktrace.1,v 1.4.2.4 1997/12/23 07:25:07 charnier Exp % .\" jpman %Id: ktrace.1,v 1.2 1997/05/16 00:27:14 mutoh Stab % .\" .Dd June 6, 1993 diff --git a/ja/man/man1/limits.1 b/ja/man/man1/limits.1 index c2b15f0db9..50bcfa72e0 100644 --- a/ja/man/man1/limits.1 +++ b/ja/man/man1/limits.1 @@ -17,7 +17,7 @@ .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" -.\" %Id: limits.1,v 1.2.2.2 1997/07/22 07:22:48 charnier Exp % +.\" %Id: limits.1,v 1.2.2.3 1998/02/01 06:21:47 steve Exp % .\" jpman %Id: limits.1,v 1.3 1997/06/23 15:04:52 horikawa Stab % .\" .Dd January 15, 1996 @@ -272,7 +272,6 @@ hard .Xr env 1 , .Xr limit 1 , .Xr sh 1 , -.Xr ulimit 1 , .Xr getrlimit 3 , .Xr setrlimit 3 , .Xr login_cap 3 , diff --git a/ja/man/man1/login.1 b/ja/man/man1/login.1 index 673efa45e4..d820c7f332 100644 --- a/ja/man/man1/login.1 +++ b/ja/man/man1/login.1 @@ -32,7 +32,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)login.1 8.2 (Berkeley) 5/5/94 -.\" %Id: login.1,v 1.4.2.3 1997/07/23 06:43:51 charnier Exp % +.\" %Id: login.1,v 1.4.2.4 1998/01/07 10:44:20 obrien Exp % .\" jpman %Id: login.1,v 1.3 1997/05/19 16:39:53 horikawa Stab % .\" .Dd May 5, 1994 @@ -97,6 +97,15 @@ user はそのファイルに記述された幾つかのデバイスのプロテクトとオーナを変え ます。 .Pp +ファイル +.Pa /etc/skeykeys +が存在する場合、このファイル中にユーザのエントリが存在する時には、 +.Nm +は S/key パスワード認証を行います。 +.Pa /etc/skey.access +により、 +接続元のホストやネットワークに応じて S/key パスワード使用の義務を制御します。 +.Pp 通常、ユーザがログインすると、 .Nm はシステムのコピーライト表示、 @@ -137,14 +146,18 @@ HOME, SHELL, PATH, TERM, LOGNAME, USER .Bl -tag -width /var/mail/userXXX -compact .It Pa /etc/fbtab デバイスのプロテクトの変更 +.It Pa /etc/login.access +ログインアクセス制御表 .It Pa /etc/login.conf ログインクラスケーパビリティデータベース .It Pa /etc/motd ログイン時に最初に表示するメッセージ .It Pa /etc/nologin ログインを拒否する時に表示するメッセージ -.It Pa /etc/login.access -ログインの許可・拒否の設定 +.It Pa /etc/skey.access +skey パスワード制御表 +.It Pa /etc/skeykeys +skey パスワードデータベース .It Pa /var/run/utmp 現在のログイン状況 .It Pa /var/log/lastlog @@ -161,10 +174,12 @@ last login account records .Xr chpass 1 , .Xr passwd 1 , .Xr rlogin 1 , +.Xr skey 1 , .Xr getpass 3 , .Xr fbtab 5 , .Xr login.access 5 , .Xr login.conf 5 , +.Xr skey.access 5 , .Xr utmp 5 , .Xr environ 7 , .Xr nologin 8 diff --git a/ja/man/man1/ls.1 b/ja/man/man1/ls.1 index c8205ca922..c876eb30b3 100644 --- a/ja/man/man1/ls.1 +++ b/ja/man/man1/ls.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ls.1 8.6 (Berkeley) 4/18/94 -.\" %Id: ls.1,v 1.5.2.4 1997/09/19 06:18:11 charnier Exp % +.\" %Id: ls.1,v 1.5.2.5 1997/12/25 09:35:55 hoek Exp % .\" jpman %Id: ls.1,v 1.3 1997/05/19 17:21:06 horikawa Stab % .\" .Dd April 18, 1994 diff --git a/ja/man/man1/mail.1 b/ja/man/man1/mail.1 index e8fc8a7d23..e4f46d5031 100644 --- a/ja/man/man1/mail.1 +++ b/ja/man/man1/mail.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)mail.1 8.2 (Berkeley) 12/30/93 +.\" %Id: mail.1,v 1.8.2.3 1998/01/05 00:02:15 jraynard Exp % .\" jpman %Id: mail.1,v 1.3 1997/10/30 01:42:49 h-nokubi Stab % -.\" %Id: mail.1,v 1.8.2.2 1997/09/15 08:41:46 jkh Exp % .\" .Dd December 30, 1993 .Dt MAIL 1 diff --git a/ja/man/man1/merge.1 b/ja/man/man1/merge.1 index 185e9a777a..3a5c9f1465 100644 --- a/ja/man/man1/merge.1 +++ b/ja/man/man1/merge.1 @@ -3,10 +3,8 @@ .ds Rv \\$3 .ds Dt \\$4 .. -.Id %Id: merge.1,v 1.2 1995/10/28 21:50:04 peter Exp % +.Id %Id: merge.1,v 1.2.2.1 1998/02/16 18:22:13 jkh Exp % .ds r \&\s-1RCS\s0 -.\"(訳注)これを定義しないと -V が正しく表示されない -.\" 2.2.2R 対象(1997/07/21) Kazuo Horikawa .TH MERGE 1 \*(Dt GNU .SH 名称 merge \- 3 つのファイル併合 @@ -124,8 +122,6 @@ merge \- 3 .BI \-q 沈黙モード。衝突に対して警告を出しません。 .TP -.\"(訳注)この.TPは原文にありませんが、追加しました。 -.\" 2.2.1R 対象(1997/05/13) Takeshi MUTOH .BI \-V \*r のバージョン番号を出力します。 .SH 診断 diff --git a/ja/man/man8/rmgroup.8 b/ja/man/man1/minigzip.1 similarity index 60% rename from ja/man/man8/rmgroup.8 rename to ja/man/man1/minigzip.1 index 39752a85ff..7f5de7af4d 100644 --- a/ja/man/man8/rmgroup.8 +++ b/ja/man/man1/minigzip.1 @@ -1,5 +1,5 @@ -.\" Copyright (c) 1996 Wolfram Schneider . Berlin. -.\" All rights reserved. +.\" Copyright (c) 1997 +.\" Michael Smith .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -22,33 +22,48 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rmgroup.8,v 1.1.2.2 1997/03/06 07:59:15 mpp Exp % -.\" jpman %Id: rmgroup.8,v 1.3 1997/07/22 16:56:59 horikawa Stab % - -.Dd Oct, 30, 1996 -.Dt RMGROUP 8 -.Os FreeBSD 2.2 +.\" %Id: minigzip.1,v 1.2.2.2 1998/01/14 14:11:16 tg Exp % +.\" +.Dd December 13, 1997 +.Dt MINIGZIP 1 +.Os .Sh 名称 -.Nm rmgroup -.Nd UNIX のグループを消去する +.Nm minigzip +.Nd 'gzip' 圧縮ツールの最小限度の実装 .Sh 書式 -.Nm -.Ar group +.Nm minigzip +.Op Fl d +.Op Ar file ... .Sh 解説 .Nm -は、UNIX のグループを -.Xr group 5 -データベースから消去します。 -.Nm -は、システムグループである wheel, daemon, kmem, sys, tty, operator, -bin, nogroup, nobody やグループ id (gid) が 0 のグループは消去しません。 -.Sh 関連項目 -.Xr group 5 , -.Xr addgroup 8 , -.Xr adduser 8 , -.Xr rmuser 8 -.Sh 歴史 +は +.Xr gzip 1 +ユーティリティの最小限度の実装です。 +標準入出力を通してのストリーム圧縮・伸長と、 +個々のファイルの圧縮・伸長を提供します。 +.Pp +デフォルトの操作は圧縮で、伸長は +.Fl d +フラグをコマンドラインで与えることで選択されます。 +.Pp +もしも +.Ar file +引数が与えられた場合、この操作は個々のファイルに別々に適用されます。 +圧縮すると、オリジナルファイルを、 +.Pa .gz +サフィックスをつけたファイルと置き換えます。 +伸長は +.Pa .gz +サフィックスが存在すればそれを取り除きます。 +.Pp +.Ar file +引数が与えられなかった場合、 .Nm -コマンドは、 -.Fx 2.2 -から導入されました。 +は標準入力から読み込み、操作の結果を標準出力に書き出します。 +.Sh 関連項目 +.Xr gzip 1 +.Sh 作者 +.Nm +は、 +.An Jean-loup Gailly +によって書かれました。 diff --git a/ja/man/man1/mv.1 b/ja/man/man1/mv.1 index 53c266c29d..c7a742ceb6 100644 --- a/ja/man/man1/mv.1 +++ b/ja/man/man1/mv.1 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mv.1 8.1 (Berkeley) 5/31/93 -.\" %Id: mv.1,v 1.7 1996/08/29 18:06:04 wosch Exp % +.\" %Id: mv.1,v 1.7.2.1 1998/02/15 11:16:27 jkh Exp % .\" jpman %Id: mv.1,v 1.2 1997/03/29 06:23:50 horikawa Stab % .\" .Dd May 31, 1993 diff --git a/ja/man/man1/ncal.1 b/ja/man/man1/ncal.1 new file mode 100644 index 0000000000..85a2fe3058 --- /dev/null +++ b/ja/man/man1/ncal.1 @@ -0,0 +1,118 @@ +.\" Copyright (c) 1997 Wolfgang Helbig +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ncal.1,v 1.5.2.2 1998/01/12 06:21:22 obrien Exp % +.\" jpman %Id: cal.1,v 1.2 1997/05/17 15:48:43 horikawa Stab % +.\". +.Dd December 16, 1997 +.Dt CAL 1 +.Os +.Sh 名称 +.Nm cal , +.Nm ncal +.Nd カレンダおよびイースターの日付を表示する +.Sh 書式 +.Nm cal +.Op Fl jy +.Op Oo Ar month Oc Ar \ year +.Nm ncal +.Op Fl jJpwy +.Op Fl s Ar country_code +.Op Oo Ar month Oc Ar \ year +.Nm ncal +.Op Fl Jeo +.Op Ar year +.Sh 解説 +.Nm cal +は簡単なカレンダを表示します。 +また +.Nm ncal +は別のフォーマット、追加のオプション、イースターの日付も提供します。 +新しいフォーマットは込み入っていますが、 +25x80 文字の端末で一年が表示できます。 +引数が指定されなかった場合は今月のものを表示します。 +.Pp +オプションには以下のものがあります: +.Bl -tag -width indent +.It Fl J +ユリウス暦でカレンダーを表示します。 +.Fl e +オプションと共に使用すると、ユリウス暦でのイースターを表示します。 +.It Fl e +イースターの日付を表示します (西方教会)。 +.It Fl j +ユリウス日で表示します。(1 月 1 日を第 1 日とする通日です) +(訳注:天文学での定義とは異なります。[Mar.1996]) +.It Fl o +東方正教会のイースターの日付を表示します (ギリシャおよびロシアの東方正教会)。 +.It Fl p +カントリーコードと、ユリウス暦からグレゴリオ暦へ移行したと +.Nm ncal +が見なす日付を表示します。 +ローカル環境で定義されるカントリーコードにはアスタリスクが表示されます。 +.It Fl s Ar country_code +ユリウス暦からグレゴリオ暦へ移行した日付を +.Ar country_code +に基づくものとします。 +指定しない場合には、 +.Nm ncal +はローカル環境に基づき推定しますが、 +推定に失敗した場合は、1752 年 9 月 2 日であるとします。 +この日付は、英国およびその植民地がグレゴリオ暦に移行した日付です。 +.It Fl w +週のカラムの下に週の番号を表示します。 +.It Fl y +今年のカレンダを表示します。 +.El +.Pp +パラメータが 1 つの時は西暦年 (1 - 9999) を指定したものとして、 +その年のカレンダを表示します。 +年は完全な形で指定して下さい。例えば +.Dq Li cal 89 +では 1989 年のカレンダを表示 +.Em しません +。パラメータが 2 つの時は月 (1 - 12) と年を指定します。 +.Pp +一年は 1 月 1 日から始まります。 +.Pp +.Sh 関連項目 +.Xr calendar 3 , +.Xr strftime 3 +.Rs +.Sh 歴史 +.Nm cal +コマンドは +.At v6 +から登場しました。 +.Nm ncal +は +.Fx 2.2.5 +の後に登場しました。 +.Sh 作者 +このコマンドとマニュアルは +.An Wolfgang Helbig Aq helbig@FreeBSD.ORG +が作成しました。 +.Sh バグ +ユリウス暦からグレゴリオ暦に移行した日付とカントリーコードの対応は、 +多くの国にについて不適当です。 diff --git a/ja/man/man1/passwd.1 b/ja/man/man1/passwd.1 index 554ac50609..95a81992fa 100644 --- a/ja/man/man1/passwd.1 +++ b/ja/man/man1/passwd.1 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)passwd.1 8.1 (Berkeley) 6/6/93 +.\" %Id: passwd.1,v 1.5.2.2 1998/01/03 19:16:40 steve Exp % .\" jpman %Id: passwd.1,v 1.4 1997/07/21 09:41:51 konuma Stab % .\" .Dd June 6, 1993 diff --git a/ja/man/man1/patch.1 b/ja/man/man1/patch.1 index 2cce0586ce..c2f8875737 100644 --- a/ja/man/man1/patch.1 +++ b/ja/man/man1/patch.1 @@ -1,13 +1,11 @@ .\" -*- nroff -*- .rn '' }` .\" jpman %Id: patch.1,v 1.3 1997/09/10 04:34:14 yugawa Stab % -'\" %Header: /home/ncvs/src/gnu/usr.bin/patch/patch.1,v 1.5 1996/02/07 23:47:55 jdp Exp % +'\" %Header: /home/ncvs/src/gnu/usr.bin/patch/patch.1,v 1.5.2.3 1998/01/22 07:45:53 ache Exp % '\" '\" %Log: patch.1,v % -'\" Revision 1.5 1996/02/07 23:47:55 jdp -'\" Update the manual page to reflect the fact that an "Index" line -'\" now takes precedence over a context diff header for determining -'\" the name of the file to patch. +'\" Revision 1.5.2.1 1998/01/11 20:45:30 ache +'\" Back out rev1.5 change, Index: precedence restored to historycal behaviour '\" '\" Revision 1.4 1994/02/25 21:45:59 phk '\" added the -C/-check again. @@ -222,7 +220,7 @@ context diff もしヘッダに \*(L"Index:\*(R" いう行があったら .I patch はここから得たファイル名を使うことを試みます。 -Index 行は、もしあれば、context diff ヘッダに優先して用いられます。 +context diff ヘッダは Index 行に優先して用いられます。 もしファイル名を見つけることができなかった場合、 パッチすべきファイル名を入力するよう求めます。 .PP @@ -334,6 +332,12 @@ hunk デフォルト値は 2 であり、 context の行数(通常は 3)より大きい値にはしません。 .TP 5 +.B "\-I, \-\-index-first" +.I patch +に、``Index:'' 行を context diff のヘッダより優先して扱わせます。 +.B PATCH_INDEX_FIRST +環境変数を設定すれば同じ効果が得られます。 +.TP 5 .B "\-l, \-\-ignore\-whitespace" パターンマッチの条件を緩くし、タブおよび空白に関する違いは無視します。 パターン中の連続する任意個の空白は、入力ファイル中の連続する任意個の diff --git a/ja/man/man1/ps.1 b/ja/man/man1/ps.1 index 9d2b2a4fb7..3bf8c655ae 100644 --- a/ja/man/man1/ps.1 +++ b/ja/man/man1/ps.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)ps.1 8.3 (Berkeley) 4/18/94 +.\" %Id: ps.1,v 1.11.2.2 1998/02/18 22:54:59 dima Exp % .\" jpman %Id: ps.1,v 1.2 1997/05/20 01:19:55 mutoh Stab % -.\" %Id: ps.1,v 1.11.2.1 1997/08/21 02:54:28 jlemon Exp % .\" .Dd April 18, 1994 .Dt PS 1 @@ -41,7 +41,7 @@ .Nd プロセスの状態の表示 .Sh 書式 .Nm \&ps -.Op Fl aCcehjlmrSTuvwx +.Op Fl aCcefhjlmrSTuvwx .Op Fl M Ar core .Op Fl N Ar system .Op Fl O Ar fmt @@ -90,6 +90,8 @@ cpu cpu 時間を使う方法に変更します(通常これは影響ありません)。 .It Fl e 環境(変数)も同時に表示します。 +.It Fl f +より詳しいプロセス情報を得るように、働きます。 .It Fl h ページ毎に一つヘッダが入るようにします。 .It Fl j diff --git a/ja/man/man1/rpcgen.1 b/ja/man/man1/rpcgen.1 index e1acf57fe6..5aab4e10ee 100644 --- a/ja/man/man1/rpcgen.1 +++ b/ja/man/man1/rpcgen.1 @@ -1,308 +1,326 @@ .\" @(#)rpcgen.1 1.35 93/06/02 SMI -'\"macro stdmacro .\" Copyright 1985-1993 Sun Microsystems, Inc. .\" jpman %Id: rpcgen.1,v 1.2 1997/06/08 13:49:19 jsakai Stab % -.nr X -.TH rpcgen 1 "28 Mar 1993" -.SH 名称 -rpcgen \- RPC プロトコルコンパイラ -.SH 書式 -.BI rpcgen " infile" -.LP -.B rpcgen -[ -.B \-a -] [ -.B \-b -] [ -.B \-C -] [ -.BI \-D name -[ = -.I value -] ] -.if n .ti +5n -[ -.BI \-i " size" -] -[ -.B \-I -[ -.BI \-K " seconds" -] ] -[ -.B \-L -] [ -.B \-M -] -.if n .ti +5n -.if t .ti +5n -[ -.B \-N -] -[ -.B \-T -] [ -.BI \-Y " pathname" -] -.I infile -.LP -.B rpcgen -[ -.B \-c -| -.B \-h -| -.B \-l -| -.B \-m -| -.B \-t -| -.B \-Sc -| -.B \-Ss -| -.B \-Sm -] -.if n .ti +5n -[ -.BI \-o " outfile" -] [ -.I infile -] -.LP -.B rpcgen -[ -.BI \-s " nettype" -] [ -.BI \-o " outfile" -] [ -.I infile -] -.LP -.B rpcgen -[ -.BI \-n " netid" -] [ -.BI \-o " outfile" -] [ -.I infile -] +.Dd March 28, 1993 +.Dt RPCGEN 1 +.Os +.Sh 名称 +.Nm rpcgen +.Nd RPC プロトコルコンパイラ +.Sh 書式 +.Nm rpcgen +.Ar infile +.Nm rpcgen +.Op Fl a +.Op Fl b +.Op Fl C +.Oo +.Fl D Ns Ar name Ns Op Ar =value +.Oc +.Op Fl i Ar size +.Op Fl I Op Fl K Ar seconds +.Op Fl L +.Op Fl M +.Op Fl N +.Op Fl T +.Op Fl Y Ar pathname +.Ar infile +.Nm rpcgen +.Oo +.Fl c | +.Fl h | +.Fl l | +.Fl m | +.Fl t | +.Fl \&Sc | +.Fl \&Ss | +.Fl \&Sm +.Oc +.Op Fl o Ar outfile +.Op Ar infile +.Nm rpcgen +.Op Fl s Ar nettype +.Op Fl o Ar outfile +.Op Ar infile +.Nm rpcgen +.Op Fl n Ar netid +.Op Fl o Ar outfile +.Op Ar infile .\" .SH AVAILABILITY .\" .LP .\" SUNWcsu -.SH 解説 -.IX "rpcgen" "" "\fLrpcgen\fP \(em RPC protocol compiler" -.IX "RPC" "protocol compiler" "" "protocol compiler \(em \fLrpcgen\fP" -.IX "RPC Language" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.IX "compilers" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.IX "programming tools" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.LP -\f3rpcgen\f1 -は、ある RPC プロトコルを実現する C コードを生成するツールです。 -\f3rpcgen\f1 -への入力は、RPC 言語 (リモートプロシージャコール言語) として知られる、 +.Sh 解説 +.Nm rpcgen +は、ある +.Tn RPC +プロトコルを実現する C コードを生成するツールです。 +.Nm +への入力は、 +.Tn RPC +言語 (リモートプロシージャコール言語) として知られる、 C 言語に類似した言語です。 -.LP -\f3rpcgen\f1 +.Pp +.Nm rpcgen は通常第 1 の書式で使用され、 1 つの入力ファイルから 4 つの出力ファイルを生成します。 .\" ↑原文では three output files となっているが、すぐ後ろで 4 つ列挙している。 .\" 原文の誤りと思われる。 97/06/08 J.Sakai 入力ファイル -\f2infile\f1 +.Ar infile が -\f3proto.x\f1 +.Pa proto.x であるとすると、 -\f3rpcgen\f1 +.Nm はヘッダファイル -\f3proto.h\f1、 +.Pa proto.h 、 XDR ルーチンファイル -\f3proto_xdr.c\f1、 -、サーバ側スタブ -\f3proto_svc.c\f1、 +.Pa proto_xdr.c 、 +サーバ側スタブ +.Pa proto_svc.c 、 クライアント側スタブ -\f3proto_clnt.c\f1 +.Pa proto_clnt.c を作成します。 -\f3\-T\f1 +.Fl T オプションを指定すると、上記に加え、 -RPC ディスパッチテーブル -\f3proto_tbl.i\f1 +.Tn RPC +ディスパッチテーブル +.Pa proto_tbl.i も作成します。 -.LP -.B rpcgen +.Pp +.Nm rpcgen はまた、特定アプリケーション向けにカスタマイズ可能な クライアントおよびサーバのサンプルファイルも生成できます。 オプション -\f3\-Sc\f1, -\f3\-Ss\f1, -\f3\-Sm\f1 +.Fl \&Sc , +.Fl \&Ss , +.Fl \&Sm によってそれぞれ、サンプルのクライアント、サーバ、makefile を生成します。 オプション -\f3\-a\f1 +.Fl a を指定するとサンプルを含め全てのファイルを生成します。 -入力ファイルが \f3proto.x\f1 の場合、 -クライアント側サンプルファイルは \f3proto_client.c\f1 に、 -サーバ側サンプルファイルは \f3proto_server.c\f1 に、 -そしてサンプル makefile は \f3makefile.proto\f1 に書き出されます。 -.LP -生成されたサーバは、ポートモニタ (例えば \f3inetd\f1) で起動することも、 +入力ファイル +.Ar infile +が +.Pa proto.x +の場合、 +クライアント側サンプルファイルは +.Pa proto_client.c +に、 +サーバ側サンプルファイルは +.Pa proto_server.c +に、 +そしてサンプル makefile は +.Pa makefile.proto +に書き出されます。 +.Pp +生成されたサーバは、ポートモニタ (例えば +.Xr inetd 8 +) で起動することも、 それ自身で起動することもできます。 ポートモニタから起動される場合、 -ファイルディスクリプタ \f30\fP を引き渡すトランスポートのためだけの +ファイルディスクリプタ +.Em 0 +を引き渡すトランスポートのためだけの サーバを生成します。 -トランスポートの名前は環境変数 \f3PM_TRANSPORT\f1 をセットすることで +トランスポートの名前は環境変数 +.Ev PM_TRANSPORT +をセットすることで 指定しなければなりません。 -\f3rpcgen\f1 で作成されたサーバが実行されると、 -サーバは環境変数 \f3NETPATH\f1 で指定された全トランスポート用に +.Nm +で作成されたサーバが実行されると、 +サーバは環境変数 +.Ev NETPATH +で指定された全トランスポート用に サーバハンドルを作成します。 -\f3NETPATH\f1 が指定されていない場合は、ファイル \f3/etc/netconfig\f1 に -記述されている全ての可視トランスポート用にサーバハンドルを作成します。 +.Ev NETPATH +が指定されていない場合は、ファイル +.Pa /etc/netconfig +に記述されている全ての可視トランスポート用にサーバハンドルを作成します。 注意: トランスポートはコンパイル時ではなく実行時に選択されます。 サーバが自分で開始すると、 デフォルトでは自動的にバックグラウンド実行に移ります。 -\f3RPC_SVC_FG\f1 を定義することで、 +.Em RPC_SVC_FG +を定義することで、 サーバをフォアグラウンドで実行させることもできます。 -.LP -第二の書式は、更に洗練された RPC サーバを生成する特別な機能をもちます。 +.Pp +第二の書式は、更に洗練された +.Tn RPC +サーバを生成する特別な機能をもちます。 その特別な機能として、 -ユーザが定義した \f3#defines\f1 と RPC ディスパッチテーブル +ユーザが定義した +.Em #define +と +.Tn RPC +ディスパッチテーブル のサポートがあります。 -RPC ディスパッチテーブルのエントリには以下のものがあります: -.RS -.PD 0 -.TP 3 -\(bu +.Tn RPC +ディスパッチテーブルのエントリには以下のものがあります: +.Bl -bullet -offset indent -compact +.It そのプロシージャに対応するサービスルーチンへのポインタ -.TP -\(bu +.It 入出力引数へのポインタ -.TP -\(bu +.It これらのルーチンのサイズ -.PD -.RE +.El サーバはディスパッチテーブルを用いて認証チェックを行い、 -それからサービスルーチンを実行します。 +それからサービスルーチンを実行することができます。 クライアントライブラリはそれを用いて、 -記憶領域管理や XDR データ変換の詳細に対処します。 -.LP +記憶領域管理や XDR データ変換の詳細に対処することができます。 +.Pp 上に示した他の 3 つの書式は、出力ファイルの全てではなく、 そのうちの特定のものだけを生成したい場合に用いられます。 -.B rpcgen -の使用例については以下の -.SM EXAMPLES -セクションを参照して下さい。 -\f3\-s\f1 オプション付きで実行されると、 -\f3rpcgen\f1 は特定のトランスポートクラス用のサーバを生成します。 -\f3\-n\f1 オプション付きで実行されると、 -\f3rpcgen\f1 は \f2netid\f1 で指定されたトランスポート用サーバを生成します。 -\f2infile\f1 +.Nm +の使用例については下の +.Sx 使用例 +のセクションを参照して下さい。 +.Fl s +オプション付きで実行されると、 +.Nm +は特定のトランスポートクラス用のサーバを生成します。 +.Fl n +オプション付きで実行されると、 +.Nm +は +.Ar netid +で指定されたトランスポート用サーバを生成します。 +.Ar infile が指定されない場合、 -\f3rpcgen\f1 は標準入力から入力を受け付けます。 -.LP -入力ファイルは、実際に \f3rpcgen\f1 に処理される前に、 -C プリプロセッサ \f3cc \-E\f1 で処理されます。 -\f3rpcgen\f1 は、出力ファイルの各タイプ毎に -\f3rpcgen\f1 プログラマ向けの特別なプリプロセッサシンボルを定義します。 -.LP -.PD 0 -.RS -.TP 12 -\f3RPC_HDR\f1 +.Nm +は標準入力から入力を受け付けます。 +.Pp +入力ファイルは、実際に +.Nm +に処理される前に、 +C プリプロセッサ +.Em cc -E +で処理されます。 +.Nm +は、出力ファイルの各タイプ毎に +.Nm +プログラマ向けの特別なプリプロセッサシンボルを定義します: +.Bl -tag -width indent +.It RPC_HDR ヘッダをコンパイルする際に定義されます -.TP -\f3RPC_XDR\f1 +.It RPC_XDR XDR ルーチンをコンパイルする際に定義されます -.TP -\f3RPC_SVC\f1 +.It RPC_SVC サーバ側スタブをコンパイルする際に定義されます -.TP -\f3RPC_CLNT\f1 +.It RPC_CLNT クライアント側スタブをコンパイルする際に定義されます -.TP -\f3RPC_TBL\f1 +.It RPC_TBL RPC ディスパッチテーブルをコンパイルする際に定義されます -.RE -.PD -.LP -``\f3%\f1'' で始まる行は全て、\f3rpcgen\f1 に解釈されることなく、 +.El +.Pp +.Dq % +で始まる行は全て、 +.Nm +に解釈されることなく、 出力ファイルに直接引き継がれます。 -C プリプロセッサのパス名を指定するには \f3\-Y\f1 フラグを使用して下さい。 -.LP -\f2infile\f1 で参照される全てのデータ方に対し、 -\f3rpcgen\f1 は、そのデータ型名の前に \f3xdr_\f1 を付与した名前の +C プリプロセッサのパス名を指定するには +.Fl Y +フラグを使用して下さい。 +.Pp +.Ar infile +で参照される全てのデータ方に対し、 +.Nm +は、そのデータ型名の前に +.Em xdr_ +を付与した名前の ルーチンが存在することを仮定します。 -このルーチンが RPC/XDR ライブラリ中に存在しない場合は、 +このルーチンが +.Tn RPC/XDR +ライブラリ中に存在しない場合は、 それを提供しなければなりません。 -未定義データ型を提供することで XDR ルーチンをカスタマイズすることが可能です。 -.br -.ne 10 -.SH オプション -.TP 15 -\f3\-a\f1 +未定義データ型を提供することで +.Xr XDR +ルーチンをカスタマイズすることが可能です。 +.Sh オプション +オプションは以下の通りです: +.Bl -tag -width indent +.It Fl a サンプルファイルを含め、全てのファイルを生成します。 -.TP -\f3\-b\f1 +.It Fl b 従来互換モード。 -以前のバージョンの OS のために、トランスポート固有の RPC コードを生成します。 -.IP -注: FreeBSD ではこの互換フラグはデフォルトで有効になっています。 -FreeBSD は以前の ONC RPC ライブラリのみサポートしているからです。 -.TP -\f3\-c\f1 -XDR ルーチンをコンパイル出力します。 -.TP -\f3\-C\f1 -.SM ANSI C -コンパイラで使用できるヘッダおよびスタブファイルを生成します。 -ここで生成したヘッダファイルは C++ プログラムでも使用できます。 -.TP -\f3\-D\f2name\f3[=\f2value\f3]\f1 -シンボル \f2name\f1 を定義します。 -ソース中の \f3#define\f1 指示行と等価です。 -\f2value\f1 が指定されない場合、 -\f2value\f1 は \f31\f1 と定義されます。 +以前のバージョンの OS のために、トランスポート固有の +.Tn RPC +コードを生成します。 +.Pp +注: +.Bx Free +ではこの互換フラグはデフォルトで有効になっています。 +.Bx Free +は以前の +.Tn ONC RPC +ライブラリのみサポートしているからです。 +.It Fl c +.Tn XDR +ルーチンをコンパイル出力します。 +.It Fl C +.Tn ANSI +C コンパイラで使用できるヘッダおよびスタブファイルを生成します。 +このオプションで生成したヘッダファイルは C++ プログラムでも使用できます。 +.It Fl D Ns Ar name +.It Fl D Ns Ar name=value +.\".It Fl D Ns Ar name Ns Op Ar =value +シンボル +.Ar name +を定義します。 +ソース中の +.Em #define +指示行と等価です。 +.Ar value +が指定されない場合、 +.Ar value +は +.Em 1 +と定義されます。 このオプションは複数回の指定が可能です。 -.TP -\f3\-h\f1 -\f3C\f1 のデータ定義 (ヘッダファイル) をコンパイル出力します。 -同時に \f3\-T\f1 オプションを指定することで、 -RPC ディスパッチテーブルをサポートするヘッダファイルを生成できます。 -.TP -\f3\-i \f2size\f1 +.It Fl h +C のデータ定義 (ヘッダファイル) をコンパイル出力します。 +同時に +.Fl T +オプションを指定することで、 +.Tn RPC +ディスパッチテーブルをサポートするヘッダファイルを生成できます。 +.It Fl i Ar size インラインコードを生成し始めるサイズを指定します。 最適化を行う際に用いられます。デフォルト値は 5 です。 -.IP -注: FreeBSD プラットホームでの以前の -.B rpcgen +.Pp +注: +.Bx Free +プラットホームでの以前の +.Nm と互換性を保つため、デフォルト値は実際には 0 (つまり、 デフォルトではインラインコードは生成しない) となっています。 このデフォルト値を上書きするには明示的にゼロ以外の値を 指定しなければなりません。 -.TP -\f3\-I\f1 +.It Fl I サーバ側スタブにおける -.BR inetd (8) +.Xr inetd 8 サポートコードを生成します。 このようにして生成したサーバは、単独で起動することも、 -\f3inetd\f1 から起動することもできます。 +.Nm inetd +から起動することもできます。 単独で起動した場合、デフォルトでは自らバックグラウンド動作に移ります。 -特殊シンボル \f3RPC_SVC_FG\f1 を定義するか、 -単に \f3\-I\f1 オプションなしでコンパイルすると、 +特殊シンボル +.Em RPC_SVC_FG +を定義するか、 +単に +.Fl I +オプションなしでコンパイルすると、 サーバプロセスはフォアグラウンドで動作します。 -.br -.ne 5 -.IP +.Pp クライアントからの未処理リクエストがなければ、 -\f3inetd\f1 サーバは 120 秒 (デフォルト値) 経過の後、終了します。 +.Nm inetd +サーバは 120 秒 (デフォルト値) 経過の後、終了します。 このデフォルト値は -.B \-K +.Fl K オプションにより変更できます。 -\f3inetd\f1 サーバの全エラーメッセージは常に -.BR syslog (3) +.Nm inetd +サーバの全エラーメッセージは常に +.Xr syslog 3 によってログに残されます。 .\" .IP .\" Note: @@ -310,187 +328,179 @@ RPC .\" By default, .\" .B rpcgen .\" generates servers that can be invoked through portmonitors. -.TP -.BI \-K " seconds" -デフォルトでは、\f3rpcgen\fP を用いて作成され、ポートモニタから起動された -サービスは、リクエストを処理した後 \f3120\fP 秒待って終了します。 -この時間は \f3\-K\fP オプションを用いて変更できます。 +.Pp +.It Fl K Ar seconds +デフォルトでは、 +.Nm +を用いて作成され、ポートモニタから起動された +サービスは、リクエストを処理した後 120 秒待って終了します。 +この時間は +.Fl K +オプションを用いて変更できます。 リクエスト処理が済むと直ちに終了するようなサーバを生成するには、 -.BR "\-K\ 0" +.Fl K Ar 0 と指定します。また、決して終了しないサーバを生成するには、 -\f3\-K \-1\fP +.Fl K Ar -1 として下さい。 -.IP +.Pp サーバをモニタする場合、 あるサービスリクエストに対して -.I 常に +.Em 常に 新しいプロセスを生成するようなポートモニタがあります。 そのようなモニタを用いてサーバを使用することがわかっている場合は、 サーバは処理完了後直ちに終了すべきです。 -そのようなサーバを生成するには、\f3rpcgen\fP は \f3\-K 0\fP オプション -とともに使用すべきです。 -.TP -\f3\-l\f1 +そのようなサーバを生成するには、 +.Nm +は +.Fl K Ar 0 +オプションとともに使用すべきです。 +.It Fl l クライアント側スタブをコンパイル出力します。 -.TP -.B \-L +.It Fl L サーバがフォアグラウンドで起動された場合、 サーバのエラーを記録するのに、標準エラー出力に出力する代わりに -.BR syslog (3) +.Xr syslog 3 を使用します。 -.TP -\f3\-m\f1 -サーバ側スタブをコンパイル出力しますが、\(lqmain\(rq ルーチンは生成しません。 +.It Fl m +サーバ側スタブをコンパイル出力しますが、 +.Qq main +ルーチンは生成しません。 コールバックルーチンのみを作成したり、初期化を行うために -独自の \(lqmain\(rq ルーチンを必要とする場合に便利です。 -.TP -\f3\-M\f1 +独自の +.Qq main +ルーチンを必要とする場合に便利です。 +.It Fl M rpcgen が生成したコードとユーザが書いたコードの間で 引数や結果を受渡しするために、 マルチスレッド対応の (MT-safe な) スタブを生成します。 ユーザプログラム中でスレッドを使用する場合に有用です。 しかし関数 -.BR rpc_svc_calls (3N) +.Xr rpc_svc_calls 3 はまだ MT-safe にはなっていません。 つまり rpcgen が生成したサーバ側コードは MT-safe ではありません。 -.TP -.B \-N +.It Fl N プロシージャが複数の引数を持てるようにします。 これはまた、C 言語に大変似たパラメータ渡し方法を用います。 ですからリモートプロシージャにある引数を渡す場合、 その引数へのポインタを渡す必要はなく、引数そのものを渡せます。 この動作は -.B rpcgen +.Nm が生成したコードの以前の振る舞いとは異なっています。 以前との互換性を保つため、このオプションはデフォルトでは有効ではありません。 -.TP -\f3\-n \f2netid\f1 -\f2netid\f1 で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 -netconfig データベースには \f2netid\f1 用エントリが存在しなければなりません。 +.It Fl n Ar netid +.Ar netid +で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 +netconfig データベースには +.Ar netid +用エントリが存在しなければなりません。 このオプションを複数回指定することで、 複数のトランスポートに対してサービスするサーバを作成することができます。 -.TP -\f3\-o \f2outfile\f1 +.It Fl o Ar outfile 出力ファイル名を指定します。 何も指定されなければ標準出力が用いられます -(\f3\-c\f1, -\f3\-h\f1, -\f3\-l\f1, -\f3\-m\f1, -\f3\-n\f1, -\f3\-s\f1, -\f3\-Sc\f1, -\f3\-Sm\f1, -\f3\-Ss\f1, -\f3\-t\f1 +( +.Fl c , +.Fl h , +.Fl l , +.Fl m , +.Fl n , +.Fl s , +.Fl \&Sc , +.Fl \&Sm , +.Fl \&Ss , +.Fl t モード時のみ)。 -.TP -\f3\-s \f2nettype\f1 -クラス \f2nettype\f1 に属する全てのトランスポート用の +.It Fl s Ar nettype +クラス +.Ar nettype +に属する全てのトランスポート用の サーバ側スタブをコンパイル出力します。 -サポートされているクラスは以下のものです: -\f3netpath\f1, -\f3visible\f1, -\f3circuit_n\f1, -\f3circuit_v\f1, -\f3datagram_n\f1, -\f3datagram_v\f1, -\f3tcp\f1, -\f3udp\f1 +サポートされているクラスは以下の通りです: +.Em netpath , +.Em visible , +.Em circuit_n , +.Em circuit_v , +.Em datagram_n , +.Em datagram_v , +.Em tcp , +.Em udp (これらのクラスの意味については -.BR rpc (3N) +.Xr rpc 3 を参照して下さい) このオプションは複数回指定できます。 注: トランスポートはコンパイル時ではなく実行時に選択されます。 -.TP -\f3\-Sc\f1 +.It Fl \&Sc リモートプロシージャ呼び出しを用いるサンプルクライアントコードを生成します。 -.br -.ne 5 -.TP -\f3\-Sm\f1 -アプリケーションをコンパイルする際に用いるサンプル Makefile を生成します。 -.TP -\f3\-Ss\f1 +.It Fl \&Sm +アプリケーションをコンパイルする際に用いるサンプル +.Pa Makefile +を生成します。 +.It Fl \&Ss リモートプロシージャ呼び出しを用いるサンプルサーバコードを生成します。 -.TP -\f3\-t\f1 -RPC ディスパッチテーブルをコンパイル出力します。 -.TP -\f3\-T\f1 -RPC ディスパッチテーブルをサポートするコードを生成します。 -.IP +.It Fl t +.Tn RPC +ディスパッチテーブルをコンパイル出力します。 +.It Fl T +.Tn RPC +ディスパッチテーブルをサポートするコードを生成します。 +.Pp ある特定のタイプのファイルを生成するために、 以下のオプション -\f3\-c\f1, -\f3\-h\f1, -\f3\-l\f1, -\f3\-m\f1, -\f3\-s\f1, -\f3\-Sc\f1, -\f3\-Sm\f1, -\f3\-Ss\f1, -\f3\-t\f1 +.Fl c , +.Fl h , +.Fl l , +.Fl m , +.Fl s , +.Fl \&Sc , +.Fl \&Sm , +.Fl \&Ss , +.Fl t は排他的に使用されます。 他方、オプション -\f3\-D\f1 +.Fl D と -\f3\-T\f1 +.Fl T は大域的であり、他のオプションと組み合わせて使用できます。 -.TP -\f3\-Y\f2 pathname\f1 -.B rpcgen +.It Fl Y Ar pathname +.Nm が C プリプロセッサを探し始めるディレクトリ名を指定します。 -.br -.ne 5 -.SH 使用例 +.El +.Sh 使用例 以下の例: -.LP -.RS -.B example% rpcgen \-T prot.x -.RE -.LP -は 5 種類のファイル -.BR prot.h , -.BR prot_clnt.c , -.BR prot_svc.c , -.B prot_xdr.c , -.BR prot_tbl.i -.LP +.Dl example% rpcgen -T prot.x +.Pp +は 5 種類のファイル: +.Pa prot.h , +.Pa prot_clnt.c , +.Pa prot_svc.c , +.Pa prot_xdr.c , +.Pa prot_tbl.i の全てを生成します。 +.Pp 次の例は C のデータ定義 (ヘッダ) を標準出力に出力します。 -.LP -.RS -.B example% rpcgen \-h prot.x -.RE -.LP -.BR -DTEST +.Dl example% rpcgen -h prot.x +.Pp +.Fl D Ns Ar TEST のテストバージョンを作成するため、 クラス -.B datagram_n -に属する全トランスポート用サーバ側スタブを標準出力に出力するには、 -.LP -.RS -.B example% rpcgen \-s datagram_n \-DTEST prot.x -.RE -.LP -とします。 -\f2netid\f1 -\f3tcp\f1 -で指定されたトランスポート用のサーバ側スタブを作成するには -.LP -.RS -.B example% rpcgen \-n tcp \-o prot_svc.c prot.x -.RE -とします。 -.SH 関連項目 -.BR cc (1), -.BR inetd (8), -.BR syslog (3), -.BR rpc (3), +.Ar datagram_n +に属する全トランスポート用サーバ側スタブを標準出力に出力するには次のよ +うにします: +.Dl example% rpcgen -s datagram_n -DTEST prot.x +.Pp +.Ar netid +tcp +で指定されたトランスポート用のサーバ側スタブを作成するには次のようにし +ます: +.Dl example% rpcgen -n tcp -o prot_svc.c prot.x +.Sh 関連項目 +.Xr cc 1 , +.Xr rpc 3 , +.Xr syslog 3 , +.Xr inetd 8 .\" .BR rpc_svc_calls (3) -.LP -.TZ NETP +.Pp +.Tn NETP マニュアルの -.B rpcgen +.Nm の章。 diff --git a/ja/man/man1/rtld.1 b/ja/man/man1/rtld.1 index cfeffbf2c1..5dc91b4e9a 100644 --- a/ja/man/man1/rtld.1 +++ b/ja/man/man1/rtld.1 @@ -1,4 +1,4 @@ -.\" %Id: rtld.1,v 1.6.2.2 1997/08/08 02:18:13 jdp Exp % +.\" %Id: rtld.1,v 1.6.2.3 1997/12/25 09:35:56 hoek Exp % .\" .\" Copyright (c) 1995 Paul Kranenburg .\" All rights reserved. diff --git a/ja/man/man1/sh.1 b/ja/man/man1/sh.1 index 6e3b27af83..af683ecaee 100644 --- a/ja/man/man1/sh.1 +++ b/ja/man/man1/sh.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95 -.\" %Id: sh.1,v 1.9.2.4 1997/09/14 13:07:41 jkh Exp % +.\" %Id: sh.1,v 1.9.2.8 1998/02/15 11:32:26 jkh Exp % .\" jpman %Id: sh.1,v 1.2 1997/05/31 16:40:31 jsakai Stab % .\" Japanese Translation amended by Norihiro Kumagai, 3/29/96, .\" based on the version of NetBSD Japanese Man Project @@ -426,6 +426,12 @@ here-doc-text 意味します。各コマンドのマニュアルにそれぞれの終了ステータスがどのよう な意味を持つかが記述されているはずです。組込みコマンドと(実行された) 関数も終了ステータスを返します。 +.Pp +コマンドがシグナルにより終了(terminate)させられた場合、 +終了ステータスは 128 にシグナル番号を加えたものになります。 +シグナル番号はヘッダファイル +.Aq Pa sys/signal.h +に定義されています。 .Ss 複合コマンド(Complex Commands) 複合コマンドは、単純コマンドの組み合わせで作ります。 制御演算子または予約語と組み合わせることで、より大きな複合コマンドを生 @@ -590,7 +596,7 @@ pattern あたかも単一プログラムであるかのように、それらの出力をまとめて リダイレクトすることができます。 .Bd -literal -offset indent -{ echo -n "hello"; echo " world" } > greeting +{ echo -n "hello"; echo " world"; } > greeting .Ed .Ss 関数 関数定義の構文は以下のとおりです。 @@ -891,6 +897,15 @@ test(1) .It \&. file 指定されたファイル file に記述されたコマンドがシェルに読み込まれ、 実行されます。 +.Ar file +に +.Ql / +文字を含む場合、その通りに扱われます。 +そうでなければ、シェルは +.Ev PATH +を使用して、ファイルを検索します。 +.Ev PATH +を使用しても見付からない場合、カレントディレクトリを検索します。 .It alias [ name[=string] ... ] name=string が指定されている場合、シェルは名前 ``name'' を持つ値 ``value'' のエイリアスを定義します。単に ``name'' だけが指定された場合、 @@ -1026,7 +1041,7 @@ hash 組込みコマンドの pwd は同名のプログラムとは異なった表示をする場合があります。 このため処理は高速ですが、カレントディレクトリ の名前を変更した場合でも、以前のディレクトリ名を表示し続けます。 -.It read [ -p prompt ] [ -e ] variable ... +.It Li "read [ -p prompt ] [ -e ] variable ... -p オプションが指定され、かつ標準入力が端末の場合、 prompt をプロンプトとして表示します。 そして標準入力から 1 行入力します。行端の改行文字を削除し、行を前述の @@ -1037,6 +1052,12 @@ prompt 分割された単語の数より多くの変数が指定されていたなら、 余った変数には空文字列が設定されます。 .Pp +-t オプションが指定され、かつ入力がなされる前にタイムアウトすると、 +read コマンドは値を割当てずに戻ります。 +タイムアウト値の後にはオプションで 's', 'm', 'h' のいずれかの一文字 +を付けることが出来、それぞれ秒, 分, 時間を陽に指定します。 +どれも指定しない場合には 's' であるものとします。 +.Pp -e オプションを指定すると、入力中のバックスラッシュ文字を特別扱いします。 バックスラッシュ文字が改行文字の直前にある場合、 バックスラッシュ文字と改行文字は削除されます。 diff --git a/ja/man/man1/su.1 b/ja/man/man1/su.1 index 0350eaff15..60582dde87 100644 --- a/ja/man/man1/su.1 +++ b/ja/man/man1/su.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)su.1 8.2 (Berkeley) 4/18/94 -.\" %Id: su.1,v 1.3.2.5 1997/10/12 08:12:40 jmg Exp % +.\" %Id: su.1,v 1.3.2.6 1998/02/18 12:15:58 markm Exp % .\" jpman %Id: su.1,v 1.3 1997/05/19 16:52:17 horikawa Stab % .\" .\" this is for hilit19's braindeadness: " @@ -43,6 +43,7 @@ .Sh 書式 .Nm .Op Fl Kflm +.Op Fl c Ar class .Op Ar login Op Ar args .Sh 解説 .Nm @@ -134,6 +135,9 @@ ID で定義される) であったり、呼出側の実ユーザ ID が 0 でなければ、 .Nm は失敗します。 +.It Fl c Ar class +指定されたログインクラスの設定を使用します。 +スーパユーザのみが使用を許されます。 .El .Pp .Fl l diff --git a/ja/man/man1/tar.1 b/ja/man/man1/tar.1 index 7893d88b10..67849b7e75 100644 --- a/ja/man/man1/tar.1 +++ b/ja/man/man1/tar.1 @@ -2,11 +2,12 @@ .\" See /usr/src/gnu/COPYING for conditions of redistribution .\" .\" Written by John F. Woods +.\" Updated by Robert Eckardt .\" -.\" %Id: tar.1,v 1.6.2.1 1997/06/05 23:13:54 max Exp % +.\" %Id: tar.1,v 1.6.2.3 1998/02/15 17:05:30 steve Exp % .\" jpman %Id: tar.1,v 1.2 1997/06/24 07:09:44 bobson Stab % .\" -.Dd 6 August 1994 +.Dd 25 August 1997 .Os FreeBSD .Dt TAR 1 .Sh 名称 @@ -14,10 +15,9 @@ .Nd テープアーカイバ; "tar" アーカイブファイルの操作 .Sh 書式 -.Nm -.Op Cm Bq - -.Op Cm bundled-options -.Op Ar [gnu-style-flags] +.Nm tar +.Op [-] Ns Ar bundled-options +.Op Ar gnu-style-flags .Op Ar tarfile .Op Ar blocksize .Op Ar exclude-file @@ -35,7 +35,7 @@ .Dq tar フォーマットのアーカイブファイルを作成し、アーカイブにファイルを追加したり、 またアーカイブからファイルを抽出したりします。 -tarfile は通常磁気テープを指しますが、フロッピーディスケットや +tarfile は通常磁気テープを指しますが、フロッピディスケットや 通常のファイルでも構いません。 .Pp 通常、 @@ -55,12 +55,13 @@ tarfile そして抽出 (extract) を意味しています (下記に詳細があります) 。 これらの他に、以下に詳細を述べる機能変更文字を、コマンド単語に 含めることができます。それらのいくつかは、コマンド単語内と同じ順で -コマンドライン引数を要求します (EXAMPLE セクションを参照) 。 +コマンドライン引数を要求します (使用例の節を参照) 。 機能文字と機能変更文字は、GNU 形式の引数で指定することもできます (2 つのダッシュを最初につけ、1 つのコマンド単語ごとに機能文字か 機能変更文字を 1 つだけ指定する) 。 -アーカイブから追加、抽出、またはリスト表示するためにコマンドライン指定する -ファイル名には、シェルのパターンマッチ文字列を使用することができます。 +アーカイブへの追加、アーカイブからの抽出、そしてリスト表示のために +コマンドライン指定するファイル名には、 +シェルのパターンマッチ文字列を使用することができます。 .Sh 機能 以下の機能のいずれか1つだけを必ず指定しなければなりません。 .Pp @@ -75,8 +76,8 @@ tarfile はなく、指定したファイルの中に含まれているファイルを、最初に指定 したアーカイブに追加するという効果を持ちます。 .Em 注: -このオプションは tarfile を再書き込みする必要があるため、1/4 イ -ンチカートリッジテープでは動作しません。 +このオプションは tarfile を再書き込みする必要があるため、1/4 +インチカートリッジテープでは動作しません。 .It Fl c .It Fl -create 新しいアーカイブを作成して (もしくは古い内容を切り捨てて)、指定 @@ -84,19 +85,19 @@ tarfile .It Fl d .It Fl -diff .It Fl -compare -アーカイブの中のファイルと、それに相当するファイルシステム内のファ -イルとの違いを調査します。 +アーカイブの中のファイルと、それに相当するファイルシステム内の +ファイルとの違いを調査します。 .It Fl -delete 指定されたファイルをアーカイブから削除します。(1/4 インチテープ では動作しません。) .It Fl r .It Fl -append -アーカイブの末尾にファイルを追加します。(1/4 インチテープでは動 -作しません。) +アーカイブの末尾にファイルを追加します。(1/4 インチテープでは +動作しません。) .It Fl t .It Fl -list -アーカイブ内容のリスト表示をします。もし引数としてファイル名が指 -定されていれば、そのファイルだけがリスト表示されます。そうでなけ +アーカイブ内容のリスト表示をします。もし引数としてファイル名が +指定されていれば、そのファイルだけがリスト表示されます。そうでなけ れば、アーカイブに含まれるすべてのファイルリストが表示されます。 .It Fl u .It Fl -update @@ -106,17 +107,16 @@ tarfile .It Fl x .It Fl -extract .It Fl -get -アーカイブからファイルを抽出します。可能ならば、オーナー、変更時 -刻、ファイル属性はリストアされます。もし +アーカイブからファイルを抽出します。可能ならば、オーナ、 +変更時刻、ファイル属性はリストアされます。もし .Ar file -引数が指定されていなければ、アーカイブ内の全ファイルが抽出されま -す。もし +引数が指定されていなければ、アーカイブ内の全ファイルが抽出されます。 +もし .Ar filename -引数がテープ上のディレクトリ名にマッチしていれば、そのディレクト -リとディレクトリ内のファイルが抽出されます。(ディレクトリ内のす +引数がテープ上のディレクトリ名にマッチしていれば、そのディレクトリと +ディレクトリ内のファイルが抽出されます。(ディレクトリ内のす べてのディレクトリについても同様に抽出されます。) -もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上 -記の +もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上記の .Fl -append コマンドを参照)、最後に含まれているものが他のすべてのファイルを 上書きする形で抽出されます。 @@ -125,20 +125,23 @@ tarfile の他のオプションは、組み合わせて使用することができます。 1文字オプションは、コマンド単語の中で指定することができます。 引数を与えるべきオプションの場合、オプションに続けて引数を指定し -ます。1文字オプションであれば、したコマンドラインに続けて引数を -指定することになるでしょう (以下の -.Sx EXAMPLES +ます。1文字オプションであれば、これに続くコマンドライン引数を +使用します (以下の +.Sx 使用例 を参照してください。) .Pp .Bl -tag -width "--preserve-permissions" -compact .It Fl -help -tar のすべてのコマンドオプションについて一覧と解説を表示します。 +.Nm +のすべてのコマンドオプションについて一覧と解説を表示します。 .It Fl -atime-preserve テープに書かれている、ファイルのアクセス時刻をリストアします。 (inodeの変更時刻が変更されることに注意してください!) .It Fl b .It Fl -block-size Ar number -読み書きするブロックサイズを512-byte ブロック N 個ぶんに設定します。 +読み書きするブロックサイズを +.Ar number +* 512-byte ブロック に設定します。 .It Fl B .It Fl -read-full-blocks 短い読みだしブロックを、完全なブロックに再組み立てします。 @@ -149,7 +152,7 @@ tar .Ar directory へ移動します。 .It Fl -checkpoint -アーカイブを読むときディレクトリ名を表示します。 +アーカイブを読み書きする間に読み書きしたバッファの数を表示します。 .It Fl f Ar [hostname:]file .It Fl -file Ar [hostname:]file 指定された @@ -165,10 +168,12 @@ tar .Ar file を読み書きします。"-" はファイルネームとして使用されることもありますが、 これは標準入力から読み出したり、標準出力へ書き出したりするために使用されます。 +.It Fl -force-local +コロンがある時でさえ、アーカイブファイルはローカルのものとします。 .It Fl F Ar file .It Fl -info-script Ar file .It Fl -new-volume-script Ar file -それぞれのアーカイブの最後にスクリプトを走らせます (暗黙の +それぞれのアーカイブが終ると、スクリプトを実行します (暗黙の .Fl M 指定が行なわれます。) .It Fl -fast-read @@ -176,16 +181,16 @@ tar アーカイブ内に見つかったら、その時点で終了します。 .It Fl G .It Fl -incremental -古い GNU-format インクリメンタルバックアップファイルを作成/リス -ト/抽出します。 +古い GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl g Ar file .It Fl -listed-incremental Ar file -新しい GNU-format インクリメンタルバックアップファイルを作成/リ -スト/抽出します。 +新しい GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl h .It Fl -dereference -シンボリックリンクをシンボリックのまま書き込みません。シンボリッ -クリンクが指しているデータを書き込みます。 +シンボリックリンクをシンボリックのまま書き込みません。シンボリックリンクが +指しているデータを書き込みます。 .It Fl i .It Fl -ignore-zeros アーカイブの中のゼロブロック(通常、End-Of-File を意味する)を無視します。 @@ -203,26 +208,36 @@ tar .It Fl l .It Fl -one-file-system あるファイルシステム内にあるファイルだけでアーカイブを作成します。 -(他ファイルシステムへのマウントポイントは使われません。) +(他ファイルシステムへのマウントポイントを跨ぎません。) .It Fl L Ar number .It Fl -tape-length Ar number -N*1024 バイトを書き込んだ後テープの交換を要求します。 +.Ar number +* 1024 バイト書き込んだ後でテープの交換を要求します。 .It Fl m .It Fl -modification-time ファイルの変更時刻を抽出しません。 .It Fl M .It Fl -multi-volume マルチボリュームアーカイブを作成/リスト/抽出します。 +.It Fl n +.It Fl -norecurse +作成時に再帰的にサブディレクトリを走査しません。 +.It Fl -volno-file Ar file +ボリューム番号付きのファイル名です。 .It Fl N Ar date .It Fl -after-date Ar date .It Fl -newer Ar date +作成時間が .Ar date より新しいファイルだけを抽出します。 +.It Fl -newer-mtime Ar date +変更時間が + .Ar date +より新しいファイルだけを抽出します。 .It Fl o .It Fl -old-archive .It Fl -portability -POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成し -ます。 +POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成します。 .It Fl O .It Fl -to-stdout ファイルを標準出力に抽出します。 @@ -235,7 +250,7 @@ POSIX の指定と同じ効果を持ちます。 .It Fl P .It Fl -absolute-paths -ファイル名から先頭の`/'をとりません。 +ファイル名から先頭の `/' をとりません。 .It Fl R .It Fl -record-number メッセージ中にアーカイブ内のレコード番号を埋め込み表示します。 @@ -245,6 +260,8 @@ POSIX .It Fl -same-order .It Fl -preserve-order アーカイブ内から抽出するファイルを、指定された順のままにします。 +.It Fl -show-omitted-dirs +アーカイブ作成中に除外されたディレクトリを表示します。 .It Fl S .It Fl -sparse 「少ない」ファイルを効率的に扱うようにします。 @@ -260,19 +277,26 @@ null .Fl C 指定を無効にします。 .It Fl -totals ---create によって書かれたトータルバイト数を表示します。 +.Fl -create +によって書かれたトータルバイト数を表示します。 .It Fl v .It Fl -verbose ---create でアーカイブに書くファイルや --extract でアーカイブから -取り出すファイル名をリスト表示します。ファイルの保護情報をファイ -ル名とともに表示させるには、--list を使います。 +.Fl -create +でアーカイブに書くファイルや +.Fl -extract +でアーカイブから +取り出すファイル名をリスト表示します。 +ファイルの保護情報をファイル名とともに表示させるには、 +.Fl -list +を使います。 .It Fl V Ar volume-name .It Fl -label Ar volume-name 指定された .Ar volume-name を持ったアーカイブを作成します。 .It Fl -version -tar プログラムのバージョン番号を表示します。 +.Nm +プログラムのバージョン番号を表示します。 .It Fl w .It Fl -interactive .It Fl -confirmation @@ -306,45 +330,44 @@ tar でフィルタリングします。 (これは、 .Fl d -が指定されたときは ``decompress'' を意味しなければなりません。) +が指定されたときは ``decompress'' を意味しなければなりません。) .It Fl -block-compress -テープもしくはフロッピーのために、圧縮プログラムの出力をブロック -化します。(そうでないとき奇数長を書き込むと、デバイスドライバは -それを拒絶するでしょう。) +テープもしくはフロッピのために、圧縮プログラムの出力をブロック +化します。(そうしないと、ブロック長がおかしくなり、デバイスドライバは +そのブロックを拒絶するでしょう。) .It Fl [0-7][lmh] テープドライブと密度を指定します。 -.It Fl -norecurse -作成時にサブディレクトリ内の内容を無視します。 .It Fl -unlink ファイルを作成する前に、いったん削除します。 .El .Sh 使用例 -"bert" と "ernie" というファイルを含む、ブロックサイズが 20 ブロッ -クのアーカイブを、テープドライブ /dev/rst0 に作るには、 +"bert" と "ernie" というファイルを含む、 +ブロックサイズが 20 ブロックのアーカイブを、 +テープドライブ /dev/rst0 に作るには、 .Pp .Dl tar cfb /dev/rst0 20 bert ernie .Pp もしくは .Pp -.Dl tar --create --file /dev/rst0 --block-size 20 bert ernie +.Dl tar\ --create\ --file\ /dev/rst0\ --block-size\ 20\ bert\ ernie .Pp と入力します。 .Fl f および .Fl b フラグは両方とも引数を必要としていることに注意してください。 -この引数は、コマンド単語に書かれているのと同じ順序でコマンドライ -ンから取得されます。 +この引数は、コマンド単語に書かれているのと同じ順序でコマンドラインから +取得されます。 .Pp -/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロッ -クサイズですので、上記の例は次のように単純化できます。 +/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロック +サイズですので、上記の例は次のように単純化できます。 .Pp .Dl tar c bert ernie .Pp "backup.tar" というアーカイブから、すべての C ソース及びヘッダを 抽出するには、次のようにタイプします。 .Pp -.Dl tar xf backup.tar "*.[ch]" +.Dl tar xf backup.tar '*.[ch]' .Pp シェルがカレントディレクトリ内のファイル名に展開しないよう、パタ ーンをクォートしなければならないことに注意してください。(当然、 @@ -364,7 +387,8 @@ tar cf - -C srcdir . | tar xpf - -C destdir ことに注意してください。次のようにタイプしなければならないわけで はなく、上記のような書き方で1文字フラグを使うことができます。 .Pp -.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar/ +.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar +/ .Pp 上のようにして作成したディスクの内容は、次のようにすればリスト表 示できます。 @@ -382,12 +406,29 @@ archive1.tar .Pp とタイプしてもうまくいかないことに注意してください。なぜなら、 tar アーカイブの末尾には end-of-file ブロックがあるからです。) +.Pp +srcdir ディレクトリから 1997 年 2 月 9 日 13:00 以降に変更をされた +全てのファイルをアーカイブするためには、以下の形式を使って下さい。 +.Dl tar\ -c\ -f\ backup.tar\ --newer-mtime\ 'Feb\ 9\ 13:15\ 1997'\ srcdir/ +.Pp +他の時間指定形式としては、'02/09/97 13:15', +\&'1997-02-09 13:15', '13:15 9 Feb 1997', '9 Feb 1997 13:15', +\&'Feb. 9, 1997 1:15pm', '09-Feb', '3 weeks ago', 'May first Sunday' +があります。 +正しいタイムゾーンを指定するためには、 +`13:15 CEST' や `13:15+200' を使用して下さい。 + .Sh 環境変数 -tar プログラムは、以下の環境変数を参照します。 +.Nm +プログラムは、以下の環境変数を参照します。 .Bl -tag -width "POSIXLY-CORRECT" .It POSIXLY-CORRECT -通常、tar はファイル指定の中に混ざったフラグを処理します。 -この環境変数を設定すると、tar は最初のフラグ以外の引数を見つける +通常、 +.Nm +はファイル指定の中に混ざったフラグを処理します。 +この環境変数を設定すると、 +.Nm +は最初のフラグ以外の引数を見つける とそれ以降の引数に対してフラグ処理を行なわないという、POSIX 仕様 に合わせた動作を行なうようになります。 .It SHELL @@ -415,9 +456,12 @@ tar .Xr rmt 8 .\" .Sh 規格 .Sh 歴史 -tar フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に +.Nm +フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に 原点があります。 -この tar の実装は GNU 実装であり、John Gilmore によって書かれた +この +.Nm +の実装は GNU 実装であり、John Gilmore によって書かれた パブリックドメイン tar が元になっています。 .Sh 作者 次の人を含む、大変多くの人々。[ソースの中の ChangeLog ファイルに記 diff --git a/ja/man/man1/tcpdump.1 b/ja/man/man1/tcpdump.1 index 6a811b859f..359c70789a 100644 --- a/ja/man/man1/tcpdump.1 +++ b/ja/man/man1/tcpdump.1 @@ -1,4 +1,4 @@ -.\" @(#) $Header: /home/ncvs/doc/ja/man/man1/tcpdump.1,v 1.1.1.1 1998-02-25 04:54:16 hanai Exp $ (LBL) +.\" @(#) $Header: /home/ncvs/doc/ja/man/man1/tcpdump.1,v 1.2 1998-02-27 01:26:59 hanai Exp $ (LBL) .\" jpman %Id: tcpdump.1,v 1.3 1997/05/23 22:18:59 yugawa Stab % .\" .\" Copyright (c) 1987, 1988, 1989, 1990, 1991, 1992, 1994, 1995, 1996 diff --git a/ja/man/man1/tcpslice.1 b/ja/man/man1/tcpslice.1 index 3ddbf53f98..7fd18e49f0 100644 --- a/ja/man/man1/tcpslice.1 +++ b/ja/man/man1/tcpslice.1 @@ -1,4 +1,4 @@ -.\" @(#) $Header: /home/ncvs/doc/ja/man/man1/tcpslice.1,v 1.1.1.1 1998-02-25 04:54:16 hanai Exp $ (LBL) +.\" @(#) $Header: /home/ncvs/doc/ja/man/man1/tcpslice.1,v 1.2 1998-02-27 01:26:59 hanai Exp $ (LBL) .\" jpman %Id: tcpslice.1,v 1.3 1997/09/07 14:12:55 horikawa Stab % .\" .\" Copyright (c) 1988-1990 The Regents of the University of California. diff --git a/ja/man/man1/telnet.1 b/ja/man/man1/telnet.1 index 7b7931da57..d37477ec7f 100644 --- a/ja/man/man1/telnet.1 +++ b/ja/man/man1/telnet.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)telnet.1 8.5 (Berkeley) 3/1/94 +.\" %Id: telnet.1,v 1.3.2.3 1998/02/01 07:30:45 steve Exp % .\" jpman %Id: telnet.1,v 1.2 1997/05/23 00:55:09 mutoh Stab % -.\" %Id: telnet.1,v 1.3.2.2 1997/08/18 07:08:03 charnier Exp % .\" .Dd March 1, 1994 .Dt TELNET 1 @@ -52,7 +52,7 @@ .Op Fl n Ar tracefile .Oo .Ar host -.Op port +.Op Ar port .Oc .Sh 解説 .Nm @@ -238,7 +238,7 @@ rlogin .Ic localchars が .Dv TRUE -になっている場合には(デフォルトでは、\*(Lqold line by line\*(Lq に設定されて +になっている場合には(デフォルトでは、\*(Lqold line by line\*(Rq に設定されて います。以下を参照)、ユーザの .Ic quit , .Ic intr , @@ -462,7 +462,7 @@ logout あるいはリモートホストが .Dv LINEMODE オプションを解釈できない場合に -\*(Lqcharacter at a time\*(Lq +\*(Lqcharacter at a time\*(Rq モードに入ります。 .It Ic line .Dv TELNET LINEMODE @@ -470,7 +470,7 @@ logout あるいはリモートホストが .Dv LINEMODE オプションを解釈できない場合に -\*(Lqold-line-by-line\*(Lq +\*(Lqold-line-by-line\*(Rq モードに入ろうとします。 .It Ic isig Pq Ic \-isig .Dv LINEMODE @@ -713,8 +713,7 @@ processes) シーケンス(前述の .Ic send ayt 参照) -がリモートホストに送られます。 -"Are You There" 文字の初期値は +がリモートホストに送られます。\*(LqAre You There\*(Rq 文字の初期値は ターミナルステータス文字です。 .It Ic echo これは @@ -836,7 +835,7 @@ processes) が .Dv LINEMODE か -\*(Lqold line by line\*(Lq モードで動作している時に、端末の +\*(Lqold line by line\*(Rq モードで動作している時に、端末の .Ic lnext 文字がこの文字として使われます。 初期値として、端末の @@ -943,7 +942,7 @@ processes) が .Dv LINEMODE か -\*(Lqold line by line\*(Lq モードで動作している時に、端末の +\*(Lqold line by line\*(Rq モードで動作している時に、端末の .Ic worderase 文字がこの文字として使われます。 初期値として、端末の diff --git a/ja/man/man1/tip.1 b/ja/man/man1/tip.1 index 1f0ab2f5c5..d1df2d0a63 100644 --- a/ja/man/man1/tip.1 +++ b/ja/man/man1/tip.1 @@ -49,10 +49,10 @@ .Ar phone\-number .Sh 解説 .Nm tip -は、他のマシンとの間に全二重のコネクションを確立します。 -リモートマシンへのログインシーケンスを表示します。 -この時、コネクションを張りたいマシンに対して -ログインアカウント(相当)を持つことが必要であるとは述べません。 +は、他のマシンとの間に全二重のコネクションを確立し、 +リモートマシンへ直接ログインしてみせます。 +言うまでもないことですが、コネクションを張りたいマシンに対しては、 +ログインアカウント (かそれに相当するもの) がなければなりません。 .Pp 以下のオプションが使用可能です: .Bl -tag -width indent diff --git a/ja/man/man1/top.1 b/ja/man/man1/top.1 index c0a344c128..1c7a156823 100644 --- a/ja/man/man1/top.1 +++ b/ja/man/man1/top.1 @@ -294,7 +294,7 @@ TOP .br /etc/passwd uid 値をユーザ名に変換するのに使用 .br -/vmunix システムイメージ +/kernel システムイメージ .SH バグ .B \-I のデフォルト値が もう一度変更されましたが、私を責めないで下さい。 diff --git a/ja/man/man1/tr.1 b/ja/man/man1/tr.1 index ff9f1e26f9..394b3a6948 100644 --- a/ja/man/man1/tr.1 +++ b/ja/man/man1/tr.1 @@ -35,7 +35,7 @@ .\" @(#)tr.1 8.1 (Berkeley) 6/6/93 .\" jpman %Id: tr.1,v 1.4 1997/06/13 00:21:44 jsakai Stab % .\" -.Dd June 6, 1993 +.Dd October 11, 1997 .Dt TR 1 .Os .Sh 名称 @@ -43,21 +43,21 @@ .Nd 文字の置換 .Sh 書式 .Nm tr -.Op Fl cs +.Op Fl csu .Ar string1 string2 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl d .Ar string1 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl s .Ar string1 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl ds .Ar string1 string2 .Sh 解説 @@ -83,6 +83,9 @@ のどちらか) に含まれている同一の文字が、入力の中に連続して現れるとき、 それを 1 つの文字に圧縮します。この圧縮は、全ての削除や変換が終わった 後に行われます。 +.It Fl u +.Fl u +オプションは出力がバッファリングされないことを保証します。 .El .Pp 書式の最初の形式では、 @@ -286,3 +289,7 @@ POSIX 他の POSIX システムへの可搬性のあるシェルスクリプトを 作ろうとするならば、この振る舞いを当てにせずに、``[#*]'' と いう表現を使うべきです。 +.Fl u +オプションは +.St -p1003.2 +標準の拡張です。 diff --git a/ja/man/man1/vidcontrol.1 b/ja/man/man1/vidcontrol.1 index 057886c952..9af85c840e 100644 --- a/ja/man/man1/vidcontrol.1 +++ b/ja/man/man1/vidcontrol.1 @@ -21,21 +21,29 @@ .Nd syscons 画面ドライバの操作ユーティリティ .Sh 書式 .Nm -.Ar options ... +.Op Fl r Ar fg Ar bg +.Op Fl b Ar color +.Op Fl c Ar appearance +.Op Fl d +.Op Fl l Ar scrmap +.Op Fl L +.Op Fl m Ar on|off +.Op Fl f Ar size Ar file +.Op Fl t Ar N|off +.Op Fl x +.Op mode +.Op fgcol Op bgcol +.Op show .Sh 解説 -.Nm vidcontrol +.Nm コマンドを用いて syscons 画面ドライバの様々なオプション、例えば、 画面モード、色、カーソル、画面マップ(scrnmap)、 フォント、スクリーンセーバタイムアウトを設定することができます。 .Pp -新しい画面モードを選択するには、 -.Nm vidcontrol -の引数に画面モードを指定します。 -例えば: -.Bd -literal -vidcontrol VGA_80x25 -.Ed -.Pp +以下のコマンドラインオプションをサポートしています: +.Bl -tag -width indent +.It mode +新しいビデオモードを選択します。 現在サポートしているモードは以下の通りです: .Ar VGA_40x25 , .Ar VGA_80x25 , @@ -49,18 +57,13 @@ vidcontrol VGA_80x25 も使用できます。また、グラフィックモード .Ar VGA_320x200 も選択できます。 -.Pp -テキストを表示する際の色は、 +.It fgcol Op bgcol +テキストを表示する際の色を変更します。 前景色(例: "vidcontrol white")、あるいは 前景色および背景色(例: "vidcontrol yellow blue")を指定することにより 変更できます。 -.Pp -現在のプラットフォーム上でサポートされている色を見るには -"vidcontrol show" -とします。 -.Pp -以下のコマンドラインオプションがサポートされています: -.Bl -tag -width Fl +.It show +指定したプラットフォームでサポートされている色を表示します。 .It Fl r Ar foreground Ar background 反転表示モードで用いる色を前景色 .Ar foreground @@ -85,7 +88,11 @@ vidcontrol VGA_80x25 .It Fl L 画面出力マップをデフォルトに設定します。 .It Fl m Ar on|off -マウスポインタをオン/オフします。 +マウスポインタを +.Ar on +または +.Ar off +します。 テキストモードでのカット&ペースト機能を利用するために moused デーモンと共に 使用します。 .It Fl f Ar size Ar file @@ -118,4 +125,4 @@ vidcontrol VGA_80x25 .Xr keyboard 4 , .Xr screen 4 .Sh 作者 -Sen Schmidt (sos@FreeBSD.org) +.An Sen Schmidt Aq sos@FreeBSD.org diff --git a/ja/man/man1/w.1 b/ja/man/man1/w.1 index a9cc70e68b..98c2b2d694 100644 --- a/ja/man/man1/w.1 +++ b/ja/man/man1/w.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)w.1 8.1 (Berkeley) 6/6/93 -.\" %Id: w.1,v 1.2.8.3 1997/08/26 06:47:43 charnier Exp % +.\" %Id: w.1,v 1.2.8.4 1998/01/12 00:49:26 steve Exp % .\" jpman %Id: w.1,v 1.2 1997/04/16 01:03:05 mitchy Stab % .\" .Dd June 6, 1993 diff --git a/ja/man/man1/whois.1 b/ja/man/man1/whois.1 index 42d6bbd6dc..28195a7d6d 100644 --- a/ja/man/man1/whois.1 +++ b/ja/man/man1/whois.1 @@ -29,31 +29,58 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)whois.1 8.1 (Berkeley) 6/6/93 +.\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93 +.\" %Id: whois.1,v 1.1.1.1.8.3 1998/02/19 19:10:22 wollman Exp % .\" jpman %Id: whois.1,v 1.3 1997/06/14 04:30:33 kubo Stab % .\" -.Dd June 6, 1993 +.Dd February 19, 1998 .Dt WHOIS 1 .Os BSD 4.3 .Sh 名称 .Nm whois -.Nd インターネットのユーザ名簿 (user name directory) サービス +.Nd インターネットのドメイン名とネットワーク番号のディレクトリサービス .Sh 書式 .Nm whois -.Op Fl h Ar hostname +.Op Fl adpr +.Op Fl h Ar host .Ar name ... .Sh 解説 .Nm -はネットワークインフォメーションセンター +はネットワークインフォメーションセンタ .Pq Tn NIC -のデータベースの検索を行ないます。 +のデータベースのレコード検索を行ないます。 .Pp オプションとしては以下のものがあります。 .Bl -tag -width Ds -.It Fl h Ar hostname -NIC に代えて -.Ar hostname -で指定したホスト用います。デフォルトのホストは whois.internic.net です。 +.It Fl a +American Registry for Internet Numbers +.Pq Tn ARIN +データベースを使用します。 +ここには、 +.Tn APNIC +および +.Tn RIPE +以外がカバーする全世界の IP 番号があります。 +.It Fl d +(US Military) Defense Data Network +.Pq Tn DDN +データベースを使用します。 +.Tn \&.MIL +のサブドメインの連絡先があります。 +.It Fl h Ar host +デフォルトの NIC (whois.internic.net) に代えて、指定したホスト用います。 +ホスト名もしくは IP 番号を指定可能です。 +.It Fl p +Asia/Pacific Network Information Center +.Pq Tn APNIC +データベースを使用します。 +ここには、東アジア、オーストラリア、ニュージーランド、太平洋諸島の +IP 番号があります。 +.It Fl r +R\(aaeseaux IP Europ\(aaeens +.Pq Tn RIPE +データベースを使用します。 +ここには、ヨーロッパのドメイン番号とドメインの連絡先情報があります。 .El .Pp .Nm diff --git a/ja/man/man1/xten.1 b/ja/man/man1/xten.1 index 12511045f9..5102a09866 100644 --- a/ja/man/man1/xten.1 +++ b/ja/man/man1/xten.1 @@ -27,20 +27,26 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: xten.1,v 1.2.2.1 1997/03/06 08:00:52 mpp Exp % +.\" %Id: xten.1,v 1.2.2.2 1997/11/18 07:30:08 charnier Exp % .\" jpman %Id: xten.1,v 1.3 1997/06/12 17:21:13 kubo Stab % .\" -.Th XTEN 8 "30 Oct 1993" .Dd Oct 30, 1993 .Dt XTEN 1 -.Os BSD FreeBSD +.Os .Sh 名称 -xten \- X-10 コマンドを転送する +.Nm xten +.Nd X-10 コマンドを転送する .Sh 書式 .Nm xten -[ - ] house key[:cnt] [ [ house ] key[:cnt] .\|.\|. ] +.Op Fl "" +.Ar house Ar key Ns Op Ar :cnt +.Oo +.Op Ar house +.Ar key Ns Op Ar :cnt +.Ar ... +.Oc .Sh 解説 -.Nm xten +.Nm は、 X-10 デーモンへのコマンドラインインタフェースです。 一文字のハウスコード (A-P) と一連のキー/ユニットコードが引数として 与えられて呼び出された時、X-10 デーモンへ対応する一連の X-10 @@ -49,14 +55,20 @@ xten \- X-10 知ることは一般的にできませんが、X-10 デーモンは、パケットがすべて正しく転送されるように、 最大限努力します。 .Pp -一つの引数 \- 付きで呼び出された時は、 -.Nm xten +一つの引数 +.Fl +付きで呼び出された時は、 +.Nm は、インタラクティブモードに入ります。ここでは、標準入力を繰り返し 読み込み、X-10 デーモンに送り、デーモンからの一行の応答が標準出力に表示されます。 .Sh オプション -ハウス引数は、 A-P の範囲の一文字のハウスコードです。 +ハウス( +.Ar house +)引数は、 A-P の範囲の一文字のハウスコードです。 全ての X-10 リクエストは、ハウスコードを参照します。 -各キーは 1-16 の数値コードか、X-10 機能を指定する文字列です。 +各キー( +.Ar key +)は 1-16 の数値コードか、X-10 機能を指定する文字列です。 可能な機能コード文字列は以下の通りです。 .Bl -diag .It AllUnitsOff @@ -77,13 +89,17 @@ xten \- X-10 .It StatusRequest .El .Pp -各キーにはオプションの数字が続きます。この数字は、間隙がないキーコード +各キー( +.Ar key +)にはオプションの数字( +.Ar cnt +)が続きます。この数字は、間隙がないキーコード によっておくられるパケットの数を指定します。 この引数が省略された時、二つのパケットが転送されます。 X-10 の -.I Dim +.Em Dim と -.I Bright +.Em Bright コマンドでは、二つ以外のパケット数を指定して使うことができます。 .Sh 関連項目 .Xr tw 4 , @@ -94,4 +110,4 @@ X-10 TW523 スペシャルファイル .El .Sh 作者 -Eugene W. Stark (stark@cs.sunysb.edu) +.An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja/man/man1/ypwhich.1 b/ja/man/man1/ypwhich.1 new file mode 100644 index 0000000000..b097bf1251 --- /dev/null +++ b/ja/man/man1/ypwhich.1 @@ -0,0 +1,100 @@ +.\" %NetBSD: ypwhich.1,v 1.3 1996/05/13 02:43:46 thorpej Exp % +.\" +.\" Copyright (c) 1994 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ypwhich.1,v 1.1.2.1 1997/11/05 05:45:21 obrien Exp % +.\" +.Dd February 23, 1994 +.Dt YPWHICH 1 +.Os +.Sh 名称 +.Nm ypwhich +.Nd YP サーバのホスト名、もしくはマップのマスタを表示する +.Sh 書式 +.Nm ypwhich +.Op Fl d Ar domain +.Oo +.Op Fl t +.Fl m Op Ar mname +| +.Ar host +.Oc +.Nm ypwhich +.Fl x +.Sh 解説 +.Nm +はどの +.Tn YP +サーバが +.Tn YP +サービスをクライアントに提供しているか、または、どれがマップのマスタ +なのかを、知らせます。 +引数なしで用いられると、ローカルマシンの +.Tn YP +サーバを返します。 +.Ar host +を指定した場合には、どの +.Tn YP +サーバを使っているのか、指定したマシンに問合せます。 +.Pp +オプションには以下のものが有ります: +.Bl -tag -width indent +.It Fl d Ar domain +デフォルトのドメインの代わりに +.Ar domain +を使用します。 +.It Fl t +ニックネームを対応するマップネームに展開するのを抑制します。 +.It Fl m Op Ar mname +指定したマップの +.Tn YP +サーバを探します。 +.Fl m +オプションでは、 +.Ar host +は指定できません。 +.Ar mname +は、マップネームでもニックネームでもかまいません。もし +.Ar mname +が省略されていると、 +.Nm +は、利用できるマップのリストを作成します。 +.It Fl x +マップのニックネームのテーブルを表示します。 +.El +.Sh 関連項目 +.Xr domainname 1 , +.Xr ypcat 1 , +.Xr ypmatch 1 , +.Xr yp 4 , +.Xr ypbind 8 , +.Xr yppoll 8 , +.Xr ypset 8 +.Sh 作者 +Theo De Raadt diff --git a/ja/man/man8/Makefile b/ja/man/man8/Makefile index f41bd818f4..f228f88b9b 100644 --- a/ja/man/man8/Makefile +++ b/ja/man/man8/Makefile @@ -2,7 +2,6 @@ MAN8 = IPXrouted.8\ MAKEDEV.8\ ac.8\ accton.8\ - addgroup.8\ adding_user.8\ adduser.8\ adjkerntz.8\ @@ -127,6 +126,7 @@ MAN8 = IPXrouted.8\ pccardd.8\ pciconf.8\ ping.8\ + pnpinfo.8\ portmap.8\ ppp.8\ pppctl.8\ @@ -151,7 +151,6 @@ MAN8 = IPXrouted.8\ rexecd.8\ rlogind.8\ rmail.8\ - rmgroup.8\ rmt.8\ rmuser.8\ rndcontrol.8\ diff --git a/ja/man/man8/adduser.8 b/ja/man/man8/adduser.8 index 7c18dd79b5..169cc7cd04 100644 --- a/ja/man/man8/adduser.8 +++ b/ja/man/man8/adduser.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: adduser.8,v 1.12.2.5 1997/10/14 17:34:01 wosch Exp % +.\" %Id: adduser.8,v 1.12.2.7 1998/02/14 22:56:25 steve Exp % .\" jpman %Id: adduser.8,v 1.4 1997/08/07 17:53:51 ken Stab % .\" .Dd January 9, 1995 @@ -142,11 +142,15 @@ uid/gid .Bl -tag -width Ds .It Sy -batch username [group[,group]...] [class] [fullname] [password] バッチモードです。 +列挙されるグループは、ユーザがメンバとなる二番目のグループであり、 +デフォルトのログイングループ以外のものを書きます。 +ヌル文字列の引数を埋め草として使用することができ、 +この場合デフォルト値の動作となります。 .It Sy -check_only /etc/passwd, /etc/group, /etc/shells をチェックし、終了します。 .It Sy -class Ar login_class デフォルトのログインクラスを設定します。 -.It Sy -create_config +.It Sy -config_create 新しい設定を設定ファイルに書込み、メッセージファイルを作成して、 終了します。 .It Sy -dotdir Ar directory diff --git a/ja/man/man8/apm.8 b/ja/man/man8/apm.8 index 6a9dfebc69..c691043a89 100644 --- a/ja/man/man8/apm.8 +++ b/ja/man/man8/apm.8 @@ -17,11 +17,8 @@ .Nd APM BIOS の制御を行い、その情報を表示する .Sh 書式 .Nm apm -.Op Fl z -.Op Fl b -.Op Fl a -.Op Fl l -.Op Fl s +.Op Fl ablsz +.Op Fl d Ar 1|0 .Pp .Nm zzz .Sh 解説 @@ -41,11 +38,13 @@ .Nm apm は、現在の APM の状態や情報を冗長モードで表示します。 .Bl -tag -width indent -.It Fl z -システムをサスペンドします。これは、 -.Nm zzz -と等価です。 -.Pp +.It Fl a +現在の AC 電源の状態を整数値で表示します。 +0, 1がそれぞれ +.Dq 外れている (off-line) +状態と +.Dq つながっている (on-line) +状態をあらわします。 .It Fl b 整数値で、現在のバッテリ状態を表示します。 0, 1, 2, 3という値はそれぞれ、 @@ -57,20 +56,17 @@ 状態、 .Dq 充電 (charging) 状態をあらわします。 -.Pp -.It Fl a -現在の AC 電源の状態を整数値で表示します。 -0, 1がそれぞれ -.Dq 外れている (off-line) -状態と -.Dq つながっている (on-line) -状態をあらわします。 -.Pp +.It Fl d +通常のサスペンドとディスプレイのサスペンドを別に扱わない/別に扱うを、 +それぞれ +.Ar 1 +と +.Ar 0 +で制御します。 .It Fl l 現在のバッテリの残り割合を表示します。 もし、あなたのラップトップがこの機能を提供していない時には、 255 が表示されます。 -.Pp .It Fl s APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 .Dq 利用不可 (disabled) @@ -78,6 +74,11 @@ APM .Dq 利用可能 (enabled) 状態 をあらわします。 +.It Fl z +システムをサスペンドします。これは、 +.Nm zzz +と等価です。 +.El .Sh バグ いくつかの APM 実装では、 .Nm apm diff --git a/ja/man/man8/arp.8 b/ja/man/man8/arp.8 index d8b88690cb..a799aeb7ce 100644 --- a/ja/man/man8/arp.8 +++ b/ja/man/man8/arp.8 @@ -47,6 +47,10 @@ .Fl a .Nm arp .Fl d Ar hostname +.Op Ar proxy +.Nm arp +.Fl d +.Fl a .Nm arp .Fl s Ar hostname ether_addr .Op Ar temp @@ -76,7 +80,7 @@ .It Fl a プログラムは現在の .Tn ARP -エントリを全て表示します。 +エントリを全て表示もしくは消去します。 .It Fl d スーパユーザならば .Ar hostname diff --git a/ja/man/man8/atrun.8 b/ja/man/man8/atrun.8 index 74025e990a..985cff6459 100644 --- a/ja/man/man8/atrun.8 +++ b/ja/man/man8/atrun.8 @@ -1,4 +1,4 @@ -.\" %Id: atrun.man,v 1.1 1995/04/12 02:52:21 ache Exp % +.\" %Id: atrun.man,v 1.1.6.1 1997/12/12 07:15:35 charnier Exp % .\" jpman %Id: atrun.8,v 1.2 1997/04/23 02:43:41 yugawa Stab % .Dd April 12, 1995 .Dt ATRUN 8 @@ -11,7 +11,7 @@ .Op Fl l Ar load_avg .Op Fl d .Sh 解説 -.Nm atrun +.Nm コマンドは .Xr at 1 でキューに入れたジョブを実行するコマンドです。 @@ -25,9 +25,9 @@ .fi という設定が含まれていたならば、5分毎に起動される事になります。 .Pp -.Nm atrun +.Nm が起動する度に、小文字のキューの中の実行時間が来た各ジョブがスタートします。 -.Nm atrun +.Nm が起動する度に、(大文字のキューで表される)バッチジョブのうち 優先順位が最も高い物からひとつずつスタートします。 .\" 上記の記述はオリジナルの英語版では、"A maximum of one batch jobs (denoted @@ -51,7 +51,7 @@ を使う代わりに標準エラー出力にエラーメッセージを吐き出す。 .El .Sh 警告 -.Nm atrun +.Nm を動かすためには .Xr cron 8 デーモンを起動しておかねばなりません。 @@ -63,13 +63,13 @@ ジョブファイルを保管しておくディレクトリ .El .Sh 関連項目 -.Xr cron 8 , -.Xr crontab 1 , -.Xr crontab 5 , .Xr at 1 , -.Xr syslog 3 +.Xr crontab 1 , +.Xr syslog 3 , +.Xr crontab 5 , +.Xr cron 8 .Sh バグ -.Nm atrun +.Nm の機能は .Xr cron 8 に統合されるべきです。 diff --git a/ja/man/man8/boot_i386.8 b/ja/man/man8/boot_i386.8 index 6453f92cbb..e39470c91d 100644 --- a/ja/man/man8/boot_i386.8 +++ b/ja/man/man8/boot_i386.8 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 -.\" %Id: boot_i386.8,v 1.4.2.2 1997/07/05 02:04:31 bde Exp % +.\" %Id: boot_i386.8,v 1.4.2.3 1998/02/10 00:18:25 msmith Exp % .\" jpman %Id: boot_i386.8,v 1.5 1997/12/04 18:33:50 ken Exp % .\" .\" @@ -137,6 +137,10 @@ CDROM .It Fl c ロードしたカーネルに対し、ハードウェアのパラメータを変更するため、 UserConfig を実行します。 +カーネルが USERCONFIG_BOOT オプション付きで構築された場合、 +スクリプト中に +.Ic quit +コマンドがあったとしても、UserConfig 中にとどまります。 .It Fl D シングルとデュアルのコンソール設定を切り替えます。シングル設定では、 下記の diff --git a/ja/man/man8/bootpd.8 b/ja/man/man8/bootpd.8 index 924c413969..3fda8784ae 100644 --- a/ja/man/man8/bootpd.8 +++ b/ja/man/man8/bootpd.8 @@ -1,6 +1,6 @@ .\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University .\" -.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.2 1997/08/24 18:22:28 joerg Exp % +.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.5 1998/02/18 05:55:24 jkh Exp % .\" jpman %Id: bootpd.8,v 1.4 1997/10/11 07:39:12 horikawa Stab % .\" .TH BOOTPD 8 "November 06, 1993" "Carnegie Mellon University" @@ -93,7 +93,7 @@ inetd .I bootpd を呼びだすことによって、 スタンドアローンモードで自動的に起動することができます) -.I bootgw +.I bootpgw はコンフィギュレーションファイルを読まないので、 起動時の遅延はかなり小さく、 スタンドアローンモードはあまり役に立ちません。 diff --git a/ja/man/man8/dump.8 b/ja/man/man8/dump.8 index bb84e62935..659e4a980c 100644 --- a/ja/man/man8/dump.8 +++ b/ja/man/man8/dump.8 @@ -31,8 +31,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)dump.8 8.1 (Berkeley) 6/16/93 +.\" %Id: dump.8,v 1.5.2.7 1998/01/03 20:28:13 steve Exp % .\" jpman %Id: dump.8,v 1.2 1997/06/12 05:57:09 yugawa Stab % -.\" %Id: dump.8,v 1.5.2.3 1997/03/03 07:01:19 mpp Exp % .\" .Dd June 16, 1993 .Dt DUMP 8 diff --git a/ja/man/man8/fingerd.8 b/ja/man/man8/fingerd.8 index 9858655dae..bd2ec90c74 100644 --- a/ja/man/man8/fingerd.8 +++ b/ja/man/man8/fingerd.8 @@ -44,7 +44,7 @@ .Op Fl l .Op Fl p Ar filename .Sh 解説 -.Nm fingerd +.Nm は、ネットワークの各サイト上の name と finger プログラムとの インターフェースを提供する、 .%T RFC1196 @@ -54,7 +54,7 @@ 特別なフォーマットは規定されておらず、プロトコルは 1 行ずつ コマンドラインのような形式でやりとりされます。 .Pp -.Nm fingerd +.Nm は、 .Tn TCP の 79 番ポートを見張っている @@ -62,9 +62,9 @@ から開始されます。接続されると、 .Aq Tn CRLF で区切られたコマンドライン 1 行を受け取ります。これは -.Nm finger 1 +.Xr finger 1 に送られ、処理されます。 -.Nm fingerd +.Nm は、出力が終わるとすぐに接続を切ります。 .Pp もし、そのコマンドラインがヌルの (つまり @@ -89,11 +89,11 @@ のどちらでもかまいません。 名前が曖昧な場合は、マッチするものすべてについて表示されます。 .Pp -.Nm fingerd +.Nm に渡す引数として、 .Pa /etc/inetd.conf の中で指定できるオプションは以下のとおりです: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl s secureモードを有効にします。ユーザ名なしの問い合わせと、他の リモートホストへの問い合わせの転送は拒否されます。 @@ -103,7 +103,7 @@ secure を通して LOG_NOTICE の優先度で報告します。 .It Fl p ローカルの情報提供元としてデフォルト以外のプログラムを使います。 -.Nm fingerd +.Nm によって起動されるデフォルトのローカルプログラムは、 .Xr finger 1 です。カスタマイズされたローカルサーバを指定することにより、 @@ -121,7 +121,7 @@ secure ユーザプログラムで直接コネクトすると、 サーバに意味の無いネゴシエーションオプションを送ることになり 不正なコマンドライン解釈を行う可能性があります。 -.Nm fingerd +.Nm は、 .Tn IAC のものをフィルタリングして除くべきであり、おそらく diff --git a/ja/man/man8/ftpd.8 b/ja/man/man8/ftpd.8 index ba1ed0341c..ea1f1eb7f2 100644 --- a/ja/man/man8/ftpd.8 +++ b/ja/man/man8/ftpd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94 +.\" %Id: ftpd.8,v 1.9.2.12 1998/02/19 01:07:49 jkh Exp % .\" jpman %Id: ftpd.8,v 1.3 1997/09/08 07:23:46 kuma Stab % -.\" %Id: ftpd.8,v 1.9.2.8 1997/05/10 19:48:12 davidn Exp % .\" .Dd April 19, 1994 .Dt FTPD 8 @@ -52,7 +52,7 @@ .Op Fl a Ar address .Op Fl p Ar file .Sh 解説 -.Nm ftpd +.Nm は、インターネットファイル転送プロトコルサーバプロセスです。 このサーバは .Tn TCP @@ -65,7 +65,7 @@ を参照して下さい。 .Pp 利用可能なオプションは以下の通りです: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl d syslog の LOG_FTP のファシリティ (facility) を用いてデバッグ情報を出力します。 .It Fl l @@ -83,35 +83,35 @@ make directory, remove directory, rename のコンフィギュレーションファイルでそれを有効にしなければなりません。 .It Fl D このオプションがセットされると、 -.Nm ftpd +.Nm は制御端末を切り離してデーモンとなり、 FTP ポートへの接続要求を待ち、 子プロセスを生成して接続要求に対応します。 この方式は -.Nm ftpd +.Nm を .Xr inetd 8 から起動するよりオーバヘッドが少ないため、 処理量の多いサーバで負荷を低減するのに役立ちます。 .It Fl R このオプションがセットされると、 -.Nm ftpd +.Nm は、ユーザ操作のセキュリティチェックや PORT 要求の制限に関して 古き良き時代の振る舞いに戻ります。 現在では、 -.Nm ftpd +.Nm はリモートユーザのホストの非特権ポートに向けられた PORT コマンド だけを用います (これは FTP プロトコルの仕様に違反していますが、 いくつかのセキュリティホールを閉じることができます)。 .It Fl S このオプションがセットされると、 -.Nm ftpd +.Nm は匿名 (anonymous) による転送の全てについてのログを、ファイル .Pa /var/log/ftpd が存在する場合に限り、このファイルに残します。 .It Fl U 以前のバージョンの -.Nm ftpd +.Nm では、パッシブモードのクライアントがサーバにデータ接続を要求すると、 サーバは 1024 〜 4999 の範囲のデータポートを使用していました。 現在のバージョンでは、サーバはデフォルトでは 40000 〜 44999 の範囲の @@ -161,11 +161,16 @@ FTP ログイン成功後に .Nm はその内容を出力します。 +使用される motd ファイルはログイン環境に対して相対であることに +注意してください。 +つまり、匿名ユーザの場合には、 +.Pa ~ftp/etc +に存在することを意味じます。 .Pp この ftp サーバは、現在、以下の ftp リクエストをサポートしています。 リクエストの文字の大文字小文字の区別は無視されます。 .Bl -column "Request" -offset indent -.It リクエスト Ta "説明" +.It Sy リクエスト Ta Sy "説明" .It ABOR Ta "abort previous command" .It ACCT Ta "specify account (ignored)" .It ALLO Ta "allocate storage (vacuously)" @@ -232,7 +237,7 @@ STAT コマンドを受けとり、その前に Telnet IP や Synch があった場合、転送ステータスが返されます。 .Pp -.Nm ftpd +.Nm は、 .Xr csh 1 で使われているファイル名展開を解釈します。これにより、 @@ -240,7 +245,7 @@ STAT .Dq Li \&*?[]{}~ を利用できます。 .Pp -.Nm ftpd +.Nm は、5 つのルールに従ってユーザの認証を行います。 .Pp .Bl -enum -offset indent @@ -309,7 +314,7 @@ USER .El .Pp 最後のケースの場合、 -.Nm ftpd +.Nm は特別な手段でクライアントのアクセス権を制限します。 サーバは .Dq ftp @@ -358,7 +363,7 @@ list .El .Pp システムに複数の IP アドレスがある場合、 -.Nm ftpd +.Nm は仮想ホストの概念をサポートします。 仮想ホストは、複数の匿名 ftp 領域それぞれを別々のインターネットアドレス に割り当てる機能を提供します。 @@ -404,7 +409,7 @@ list .Pp .Em INTERNAL_LS オプションをつけてコンパイルすると、 -.Nm ftpd +.Nm はリモートからのファイル一覧表示要求に対応するための内部サポートを用意し、 chroot された環境でもそれ以外でも .Pa /bin/ls @@ -417,7 +422,7 @@ chroot このサポートは、 .Pa /etc/make.conf あるいはシェルの環境で -.Em FTP_INTERNAL_LS +.Em INTERNAL_LS 変数を設定して ftpd を作成することで追加されます。 .Sh 関連ファイル .Bl -tag -width /etc/ftpwelcome -compact @@ -425,6 +430,8 @@ chroot 歓迎されない/制限を受けるユーザおよびグループのリスト。 .It Pa /etc/ftpchroot chroot される一般ユーザのリスト。 +.It Pa /etc/ftphosts +仮想ホストのための構成ファイル .It Pa /etc/ftpwelcome welcome メッセージ。 .It Pa /etc/ftpmotd diff --git a/ja/man/man8/getty.8 b/ja/man/man8/getty.8 index 4dec3d58b1..1c200da850 100644 --- a/ja/man/man8/getty.8 +++ b/ja/man/man8/getty.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93 -.\" %Id: getty.8,v 1.4.2.2 1997/08/17 23:44:30 davidn Exp % +.\" %Id: getty.8,v 1.4.2.3 1997/12/15 07:10:52 charnier Exp % .\" jpman %Id: getty.8,v 1.3 1997/05/19 17:00:46 horikawa Stab % .\" " .Dd April 25, 1991 @@ -46,7 +46,7 @@ .Op Ar tty .Oc .Sh 解説 -.Nm getty +.Nm プログラムは、 .Xr init 8 から呼ばれ、tty回線をオープンしたあと初期化 @@ -64,7 +64,7 @@ .Pp .Ar type は、 -.Nm getty +.Nm が端末回線を特別に扱うようにするために使われます。 この .Ar type @@ -78,18 +78,18 @@ .Pa /etc/gettytab ファイルがなければ、システムのデフォルトが使われます。 テーブルにより指示されれば、 -.Nm getty +.Nm は端末画面をクリアし、 バナーヘッダを表示し、 ログインプロンプトを表示します。通常、このプロンプトのなかに システムのホスト名が含まれます。 .Pp -.Nm getty +.Nm のデフォルトの行動は、大抵の場合、適当な .Pa gettytab テーブルを作成することによって、回避したり修正したりすることができます。 .Pp -.Nm getty +.Nm はタイムアウト時間を設定することができます。これによって、 ログイン名がすぐに入力されないような場合に、ダイアル回線を切断 することができます。 @@ -97,7 +97,8 @@ .Bl -diag .It "ttyxx: No such device or address." .It "ttyxx: No such file or address." -.Xr ttys +.Pp +.Pa ttys ファイルのなかで有効にされていたターミナルがオープンできませんでした。 必要な回線がシステムに設定されていなかったか、 関係するデバイスがブート時のシステム設定の際に組み込まれなかったか、 @@ -108,7 +109,7 @@ .Sh 関連ファイル .Bl -tag -width /etc/gettytab -compact .It Pa /etc/gettytab -端末設定データベース +.It Pa /etc/ttys .El .Sh 関連項目 .Xr login 1 , @@ -118,7 +119,7 @@ .Xr ttys 5 , .Xr init 8 .Sh 歴史 -.Nm getty +.Nm は .At v6 から登場しました。 diff --git a/ja/man/man8/ifconfig.8 b/ja/man/man8/ifconfig.8 index 44d578b9b1..08725cb06e 100644 --- a/ja/man/man8/ifconfig.8 +++ b/ja/man/man8/ifconfig.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 -.\" %Id: ifconfig.8,v 1.9.2.2 1997/06/30 11:01:59 peter Exp % +.\" %Id: ifconfig.8,v 1.9.2.3 1998/02/01 07:05:02 steve Exp % .\" jpman %Id: ifconfig.8,v 1.2 1997/03/31 14:09:47 horikawa Stab % .\" .Dd February 13, 1996 diff --git a/ja/man/man8/inetd.8 b/ja/man/man8/inetd.8 index c78e2b0c4b..7b335894f0 100644 --- a/ja/man/man8/inetd.8 +++ b/ja/man/man8/inetd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)inetd.8 8.3 (Berkeley) 4/13/94 +.\" %Id: inetd.8,v 1.9.2.4 1997/11/04 21:49:01 dima Exp % .\" jpman %Id: inetd.8,v 1.2 1997/05/16 07:22:24 yugawa Stab % -.\" %Id: inetd.8,v 1.9.2.3 1997/09/22 06:23:24 charnier Exp % .\" .Dd February 7, 1996 .Dt INETD 8 @@ -100,7 +100,7 @@ サービス名 ソケットタイプ プロトコル -{wait/nowait}[/max-child] +{wait|nowait}[/max-child[/max-connections-per-ip-per-minute]] ユーザ名 サーバプログラム名 サーバプログラム引数 @@ -265,6 +265,10 @@ TCPMUX 一方、最大数に達すると、それ以降の接続要求は、存在する子プロセスが終了するまで 待ち行列に蓄えられます。これは、``wait'' モードでも同様ですが、通常は 1 (デフォルトの値)以外は意味がありません。 +指定した IP アドレスからの 1 分あたりの最大接続数を指定することも可能です。 +この場合、``/'' および最大子プロセス数を指定します。 +最大値に達っした場合、指定した IP アドレスからの接続は、 +この 1 分が経過するまで、落とされます。 .Pp .Em user エントリには、サーバを実行するユーザ名を書きます。 diff --git a/ja/man/man8/ipfw.8 b/ja/man/man8/ipfw.8 index d2379fd7a9..d8907cba31 100644 --- a/ja/man/man8/ipfw.8 +++ b/ja/man/man8/ipfw.8 @@ -27,11 +27,13 @@ delete .Nm ipfw .Op Fl aftN list +.Op Ar number ... .Nm ipfw .Oo .Fl ftN .Oc show +.Op Ar number ... .Nm ipfw .Oo .Fl q @@ -70,19 +72,21 @@ to .Pp delete 操作は .Ar number -で指定された番号を持つ最初のルールを、もし有れば、削除します +で指定された番号を持つ最初のルールを、もし有れば、削除します。 .Pp -list 操作は現在のルール一覧を出力します +list 操作は現在のルール一覧を出力します。 .Pp -show 操作は `ipfw -a list' と同じ結果を出力します +show 操作は `ipfw -a list' と同じ結果を出力します。 .Pp zero 操作は .Ar number -で指定された番号を持つルールのカウンタをクリアします +で指定された番号を持つルールのカウンタをクリアします。 .Pp -flush 操作は全ルールを削除します +flush 操作は全ルールを削除します。 .Pp -どんな場合でも次のルールは存在します +記号 `#' で始まる行および空行は無視されます。 +.Pp +どんな場合でも次のルールは存在します: .Bd -literal -offset center 65535 deny all from any to any .Ed @@ -162,7 +166,7 @@ ICMP .Ar precedence-cutoff 。送信後、終了します。 .It Ar reset - TCP パケットのみに対応。 +TCP パケットのみに対応。 パケットを破棄し、TCP の (RST) を送信し、終了します。 .It Ar count マッチするパケットのカウンタを更新し、引続きマッチングを行ないます。 @@ -268,6 +272,13 @@ port-port .Dv IP_FW_MAX_PORTS として定義されています。 .Pp +断片化されたパケットでオフセットが非 0 のもの +(すなわち、最初の断片ではないもの) は、 +一つ以上のポート仕様を持つルールにはマッチしません。？ +断片化されたパケットへのマッチングに関する詳細は +.Ar frag +オプションを参照してください。 +.Pp マッチングのルールは、入ってくるパケットか、出ていくパケット、もしくはその両方 に対し適応されます。 .Ar in @@ -289,7 +300,7 @@ port-port .Em いずれか のインタフェースを通過するパケットを指定します。 .It Ar via ipno - IP アドレスが +IP アドレスが .Ar ipno のインタフェースを通過するパケットを指定します。 .El @@ -338,6 +349,10 @@ port-port .It frag パケットが断片(フラグメント)化されたデータグラムの一部で、かつデータグラムの 先頭の断片でない場合にマッチします。 +.Ar frag +を、 +.Ar tcpflags +や TCP/UDP ポート仕様と共に使用することはできません。 .It in ネットワークから受信したパケットのみマッチします。 .It out @@ -346,7 +361,7 @@ port-port IP ヘッダが、 .Ar spec に指定されたコンマで区切られたオプションのリストを含む場合にのみマッチします。 - サポートされている IP オプションは +サポートされている IP オプションは .Ar ssrr (strict source route), .Ar lsrr @@ -366,7 +381,7 @@ SYN TCP ヘッダが .Ar spec に指定されたコンマで区切られたフラグのリストを含む場合にのみマッチします。 - サポートされているフラグは、 +サポートされているフラグは、 .Ar fin , .Ar syn , .Ar rst , @@ -375,6 +390,12 @@ TCP .Ar urg です。 ``!''によって、特定のフラグを含めないよう指定できます。 +.Ar tcpflags +仕様を含むルールは非 0 のオフセットを持つ断片化されたパケットに +マッチすることはありません。 +断片化されたパケットに関するマッチについての詳細は +.Ar frag +オプションを参照してください。 .It icmptypes Ar types ICMP タイプが .Ar types diff --git a/ja/man/man8/ldconfig.8 b/ja/man/man8/ldconfig.8 index d8ba383039..8f042d3e81 100644 --- a/ja/man/man8/ldconfig.8 +++ b/ja/man/man8/ldconfig.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: ldconfig.8,v 1.9.2.2 1997/08/08 02:18:07 jdp Exp % +.\" %Id: ldconfig.8,v 1.9.2.3 1997/12/25 07:57:42 jkh Exp % .\" jpman %Id: ldconfig.8,v 1.3 1997/07/22 16:49:42 horikawa Stab % .\" .Dd October 3, 1993 @@ -38,7 +38,7 @@ .Nd 共有ライブラリのキャッシュを設定する .Sh 書式 .Nm ldconfig -.Op Fl mrsv +.Op Fl Rmrsv .Op Fl f Ar hints_file .Op Ar directory | file Ar ... .Sh 解説 @@ -99,6 +99,11 @@ .Nm ldconfig で認識されます。 .Bl -tag -width indent +.It Fl R +以前に設定したディレクトリを再度検索します。 +以前作成したヒントファイルをオープンし、 +ヘッダからディレクトリリストを取り出します。 +コマンドラインに指定したパス名も処理します。 .It Fl f Ar hints_file .Pa /var/run/ld.so.hints の変わりに、 @@ -117,6 +122,7 @@ .It Fl r 現在のヒントファイルの中身について、標準出力に表示します。 ヒントファイルは変更されません。 +ヒントファイル中のディレクトリリストが組込まれます。 .It Fl s 共有ライブラリのために、システムの組み込みディレクトリ .Pq Dq /usr/lib diff --git a/ja/man/man8/lfs_cleanerd.8 b/ja/man/man8/lfs_cleanerd.8 index cc7b28e8f1..5306815f4e 100644 --- a/ja/man/man8/lfs_cleanerd.8 +++ b/ja/man/man8/lfs_cleanerd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)lfs_cleanerd.8 8.2 (Berkeley) 12/11/93 -.\" %Id: lfs_cleanerd.8,v 1.3 1996/09/22 21:53:50 wosch Exp % +.\" %Id: lfs_cleanerd.8,v 1.3.2.1 1997/12/15 07:11:53 charnier Exp % .\" jpman %Id: lfs_cleanerd.8,v 1.2 1997/05/24 05:44:44 mitchy Stab % .\" .Dd "December 11, 1993" @@ -44,7 +44,7 @@ .Op Fl ds .Pa node .Sh 解説 -.Nm lfs_cleanerd +.Nm は、指定した .Ar node にある log-structured ファイルシステム (LFS) のガーベージコレクションを行う @@ -72,7 +72,7 @@ LFS .Sh 関連項目 .Xr mount_lfs 8 .Sh 歴史 -.Nm lfs_cleanerd +.Nm ユーティリティは .Bx 4.4 から登場しました。 diff --git a/ja/man/man8/mail.local.8 b/ja/man/man8/mail.local.8 index 89cdbe3b07..684a2a216b 100644 --- a/ja/man/man8/mail.local.8 +++ b/ja/man/man8/mail.local.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mail.local.8 8.2 (Berkeley) 12/11/93 -.\" %Id: mail.local.8,v 1.4 1996/09/22 21:54:05 wosch Exp % +.\" %Id: mail.local.8,v 1.4.2.1 1998/02/20 17:32:25 jkh Exp % .\" jpman %Id: mail.local.8,v 1.2 1997/03/31 13:35:26 horikawa Stab % .\" .Dd December 11, 1993 @@ -92,8 +92,8 @@ biff タイムスタンプを記録する際に適切なタイムゾーンを設定します。 .El .Sh 関連ファイル -.Bl -tag -width /tmp/local.XXXXXX -compact -.It Pa /tmp/local.XXXXXX +.Bl -tag -width /var/tmp/local.XXXXXX -compact +.It Pa /var/tmp/local.XXXXXX テンポラリファイル .It Pa /var/mail/user ユーザのメールボックスディレクトリ diff --git a/ja/man/man8/mailstats.8 b/ja/man/man8/mailstats.8 index d7faf5b509..92733aec08 100644 --- a/ja/man/man8/mailstats.8 +++ b/ja/man/man8/mailstats.8 @@ -29,7 +29,7 @@ .\" * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" * SUCH DAMAGE. .\" */ -.\" %Id: mailstats.8,v 1.2.2.3 1997/06/28 08:08:11 peter Exp % +.\" %Id: mailstats.8,v 1.2.2.4 1997/11/10 03:00:05 peter Exp % .\" jpman %Id: mailstats.8,v 1.2 1997/05/21 07:42:38 yugawa Stab % .Dd August 13, 1996 .Dt MAILSTATS 8 @@ -78,5 +78,5 @@ sendmail メール統計情報データベース .El .Sh 関連項目 -.Xr sendmail 8 , -.Xr mail.local 8 +.Xr mail.local 8 , +.Xr sendmail 8 diff --git a/ja/man/man8/makekey.8 b/ja/man/man8/makekey.8 index 79a6bd7625..bc4ac02327 100644 --- a/ja/man/man8/makekey.8 +++ b/ja/man/man8/makekey.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)makekey.8 8.2 (Berkeley) 12/11/93 -.\" %Id: makekey.8,v 1.5 1996/09/22 21:54:13 wosch Exp % +.\" %Id: makekey.8,v 1.5.2.1 1997/12/15 07:13:45 charnier Exp % .\" jpman %Id: makekey.8,v 1.2 1997/05/21 07:56:47 yugawa Stab % .\" .Dd December 11, 1993 @@ -43,9 +43,9 @@ .Nm makekey .Sh 解説 .Nm makekey -は標準入力から読み込んだキーと隠しキーを暗号化し、 +は標準入力から読み込んだキーと隠しキー (salt) を暗号化し、 結果を標準出力へ書き込みます。 -キーは10バイト、隠しキーは2バイトであること期待されます。 +キーは 8 バイト、隠しキーは 2 バイトであること期待されます。 キーと隠しキーはどんな文字を含んでよいか、 どうやって暗号化計算が行なわれるか、の詳しい情報は .Xr crypt 3 diff --git a/ja/man/man8/mknetid.8 b/ja/man/man8/mknetid.8 index 9542a3d5bd..a71620b197 100644 --- a/ja/man/man8/mknetid.8 +++ b/ja/man/man8/mknetid.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: mknetid.8,v 1.1.1.1 1996/06/25 20:26:38 wpaul Exp % +.\" %Id: mknetid.8,v 1.1.1.1.2.1 1997/12/15 07:16:14 charnier Exp % .\" jpman %Id: mknetid.8,v 1.3 1997/08/16 13:26:57 horikawa Stab % .\" .Dd June 23, 1996 @@ -52,62 +52,69 @@ .Xr passwd 5 , .Xr hosts 5 , .Xr netid 5 -の内容を処理し、NIS マップ +の内容を処理し、 +.Tn NIS +マップ .Pa netid.byname を生成するのに用いる形式に変換します。 このマップは、OS に依存しない形式でユーザとホスト双方の信用情報を 保持するために用いられます。 .Pp -.Nm mknetid +.Nm コマンドは重複した netid の出現をチェックし、それらを除去します。 .Pp -.Nm mknetid +.Nm コマンドは結果を標準出力に出力します。 -通常は NIS マップを再構築する際に +通常は +.Tn NIS +マップを再構築する際に .Nm /var/yp/Makefile からのみ呼び出されます。 .Pp .Sh オプション -.Nm mknetid +.Nm コマンドには以下のオプションがあります: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl q 通常、 -.Nm mknetid +.Nm は重複した netid を見つけると警告メッセージを表示しますが、 このオプションにより「静粛」モードとなり、警告は抑制されます。 他のエラーメッセージはそのまま表示されます。 -.It Fl g Ar group-file +.It Fl g Ar group_file .Fl g オプションはグループ情報ファイルの場所を指定するのに用いられます。 コンパイル済みのデフォルト値は .Pa /etc/group です。 -.It Fl p Ar passwd-file -.Fl p -オプションはパスワード情報ファイルの場所を指定するのに用いられます。 +.It Fl p Ar passwd_file +パスワード情報ファイルの場所を指定します。 コンパイル済みのデフォルト値は .Pa /etc/passwd です。 -.It Fl h Ar hosts-file +.It Fl h Ar hosts_file .\" ↑原文では .It Fl h Ar group-file となっているが、おそらく .\" cut&paste ミスと思われる。 sakai@jp.freebsd.org (Jun 12, 1997) +.\" 2.2-currentでも .It Fl h Ar group_fileとなっている． +.\" mutoh@info.nara-k.ac.jp (Jan 26,1998) .Fl h オプションはホストデータベースファイルの場所を指定するのに用いられます。 コンパイル済みのデフォルト値は .Pa /etc/hosts です。 -.It Fl n Ar netid-file -.Fl n -オプションは netid 情報ファイルの場所を指定するのに用いられます。 +.It Fl n Ar netid_file +netid 情報ファイルの場所を指定します。 コンパイル済みのデフォルト値は .Pa /etc/netid です。 注: netid データベースが見つからなくてもエラーにはなりません。 -FreeBSD で Secure RPC がサポートされるようになるまでは、 +.Bx Free +で +.Tn Secure RPC +がサポートされるようになるまでは、 ほとんどのシステムでは netid データベースは存在しないことでしょう。 .It Fl d Ar domain -.Nm mknetid +.Nm コマンドが netid レコードを生成する際、デフォルトでは、 システムのドメイン名を用います。 もしシステムのドメイン名が設定されていないなら、 @@ -118,9 +125,10 @@ FreeBSD オプションによってその設定値を上書きすることもできます。 .El .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -NIS データベースを構築するために +.Tn NIS +データベースを構築するために .Nm yp_mkdb および .Nm mknetid @@ -138,4 +146,4 @@ NIS .Xr yp 4 , .Xr yp_mkdb 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/mount.8 b/ja/man/man8/mount.8 index 77513e74cc..5cdb0e0ab4 100644 --- a/ja/man/man8/mount.8 +++ b/ja/man/man8/mount.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mount.8 8.7 (Berkeley) 3/27/94 -.\" %Id: mount.8,v 1.11.2.2 1997/08/24 17:52:01 joerg Exp % +.\" %Id: mount.8,v 1.11.2.3 1997/12/01 00:47:09 steve Exp % .\" jpman %Id: mount.8,v 1.2 1997/05/03 11:26:50 horikawa Stab % .\" .Dd March 27, 1994 @@ -316,6 +316,7 @@ type .Xr vfsload 3 , .Xr fstab 5 , .Xr mount_cd9660 8 , +.Xr mount_devfs 8 , .Xr mount_fdesc 8 , .Xr mount_kernfs 8 , .Xr mount_lfs 8 , diff --git a/ja/man/man8/mount_cd9660.8 b/ja/man/man8/mount_cd9660.8 index 2d48b125bf..bfce7a5503 100644 --- a/ja/man/man8/mount_cd9660.8 +++ b/ja/man/man8/mount_cd9660.8 @@ -45,7 +45,7 @@ .Nm mount_cd9660 .Op Fl egrv .Op Fl o Ar options -.Op Fl s startsector +.Op Fl s Ar startsector .Ar special | node .Sh 解説 .Nm mount_cd9660 diff --git a/ja/man/man8/mount_nfs.8 b/ja/man/man8/mount_nfs.8 index 49b1cb72b3..6b55d13585 100644 --- a/ja/man/man8/mount_nfs.8 +++ b/ja/man/man8/mount_nfs.8 @@ -73,7 +73,7 @@ Appendix I. オプションを以下に示します: .Bl -tag -width indent .It Fl 2 -NFS バージョン 3 プロトコルを使用します +NFS バージョン 2 プロトコルを使用します (デフォルトはバージョン 3 をまず試した後にバージョン 2 を用います)。 .It Fl 3 NFS バージョン 3 プロトコルを使用します。 diff --git a/ja/man/man8/moused.8 b/ja/man/man8/moused.8 index 8f62043067..52a98305de 100644 --- a/ja/man/man8/moused.8 +++ b/ja/man/man8/moused.8 @@ -28,10 +28,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: moused.8,v 1.1.2.2 1997/09/29 06:36:12 charnier Exp % +.\" %Id: moused.8,v 1.1.2.4 1998/01/25 15:49:50 yokota Exp % .\" .\" jpman %Id: moused.8,v 1.3 1997/07/22 16:52:17 horikawa Stab % -.Dd December 16, 1996 +.Dd December 3, 1997 .Dt MOUSED 8 .Os FreeBSD .Sh 名称 @@ -39,72 +39,499 @@ .Nd マウスデータをコンソールドライバに渡す .Sh 書式 .Nm -.Op Fl DRcdfs +.Op Fl 3DPRcdfs +.Op Fl F Ar rate +.Op Fl r Ar resolution .Op Fl S Ar baudrate +.Op Fl C Ar threshold +.Op Fl m Ar N=M +.Op Fl z Ar target +.Op Fl t Ar mousetype .Fl p Ar port -.Fl t Ar mousetype -.Sh 解説 -マウスデーモンは、シリアルポートからマウスデータを受け取り、 -データを解釈し、コンソールドライバに ioctl で渡します。 .Pp -以下のオプションがあります。 +.Nm +.Op Fl Pd +.Fl p Ar port +.Fl i Ar info +.Sh 解説 +マウスデーモン +.Nm +とコンソールドライバは協力し、 +テキストコンソールやユーザプログラムにおけるマウス操作をサポートします。 +マウスの仮想化とユーザプログラムへのマウスデータの提供は標準フォーマット +にて行われます +.Pq Xr sysmouse 4 を御覧ください +。 +.Pp +マウスデーモンはマウスデータの読みとりのために指定されたポートを監視し、 +解釈したデータを ioctl を介してコンソールドライバに渡します。 +マウスデーモンは、移動、ボタンの押し/離しイベント、 +存在するならばローラやホイールの移動も報告します。 +ローラ/ホイールの移動は ``Z'' 軸での移動として報告されます。 +.Pp +マウスポインタが +.Xr vidcontrol 4 +によって有効にされていれば、 +コンソールドライバはマウスポインタをスクリーンに表示し、 +カットとペーストの機能を提供します。 +.Xr sysmouse 4 +をユーザプログラムがオープンすると、コンソールドライバは +マウスデータをこのデバイスに送るので、 +ユーザプログラムはこのデータを使用できます。 +.Pp +マウスデーモンがシグナル +.Dv SIGHUP +を受けとると、マウスポートを再オープンし、自己を再初期化します。 +システムがサスペンドされている間にマウスの挿抜を行なった場合に有用です。 +.Pp +以下のオプションがあります: .Bl -tag -width indent +.It Fl 3 +2 ボタンマウスで 3 番目(中)のボタンをエミュレートします。 +物理的なボタンで左と右のものを同時に押すとエミュレートされます。 +.It Fl C Ar threshold +ダブルクリック速度をボタンクリック間最大インターバルとしてミリ秒で指定します。 +このオプションを指定しないと、デフォルト値は 500 ミリ秒が仮定されます。 +このオプションは、 +テキストモードコンソールのカットとペーストの操作においてのみ有効です。 +.Xr sysmouse 4 +を介してマウスデータを得るユーザプログラムは影響を受けません。 .It Fl D シリアルポートの DTR を下げます。 +このオプションが有効なのは、 +.Ar mousesystems +がマウスプロトコルとして選択されている場合のみです。 +.Ar mousesystems +モードで 3 ボタンマウスを操作するためには、 +DTR ラインを落とすことが必要かもしれません。 +.It Fl F Ar rate +サポートされていれば、デバイスのレポート頻度(秒あたりの回数)を設定します。 +.It Fl P +シリアルマウス識別時に、 +プラグアンドプレイ COM デバイス列挙処理を開始しません。 +.Fl i +オプションと共にこのオプションが指定された場合、 +.Nm +はシリアルマウスに関する有用な情報を表示できません。 .It Fl R シリアルポートの RTS を下げます。 +このオプションが有効なのは +.Ar mousesystems +がプロトコルタイプとして、後述する +.Fl t +オプションで指定されている場合のみです。 +これは前記 +.Fl D +オプションと共によく使用されます。 +.Ar mousesystems +モードで 3 ボタンマウスを操作するためには、 +RTS と DTR のラインを共に下げる必要があるかもしれません。 .It Fl S Ar baudrate -シリアルポートの速度を指定します (1200 ボーから 9600 ボー -が指定できます ) 。 +シリアルポートの速度を指定します (1200 から 9600)。 +全シリアルマウスがこのオプションをサポートするわけではありません。 .It Fl c -ChordMiddle オプションを有効にします。 +マウスによっては、中ボタンを押したイベントを、 +左右ボタンが押されたかのようにレポートするものがあります。 +このオプションはこれを扱うものです。 .It Fl d デバッグ用のメッセージを有効にします。 .It Fl f デーモンにならずに、フォアグラウンドプロセスとして実行します。 +テストやデバッグに有用です。 +.It Fl i Ar info +指定された情報を表示し終了します。指定可能な情報を以下に示します: +.Pp +.Bl -tag -compact -width modelxxx +.It Ar port +ポート(デバイスファイル)名、例えば +.Pa /dev/cuaa0 , +.Pa /dev/mse0 , +.Pa /dev/psm0 +です。 +.It Ar if +インタフェースタイプ: serial, bus, inport, ps/2 です。 +.It Ar type +プロトコルタイプ。 +.Fl t +オプションの説明の後でリストされているものか、 +ドライバが +.Ar sysmouse +データフォーマット標準をサポートする場合には +.Ar sysmouse +です。 +.It Ar model +マウスモデル。 +.Nm +コマンドは常にモデルを識別できるわけではありません。 +.It Ar all +上記全部。ポート、インタフェース、タイプ、モデルをこの順に一行に表示します。 +.El +.Pp +.Nm +は要求された情報を判別できない場合、``unknown'' か ``generic'' を表示します。 +.It Fl m Ar N=M +物理ボタン +.Ar M +に論理ボタン +.Ar N +を割当てます。 +このオプションは任意個数指定可能です。 +複数の物理ボタンを単一の論理ボタンに割り当て可能です。 +この場合、指定された物理ボタンのいずれかが押されている場合、 +論理ボタンが押されていることになります。`=' の周りにスペースを入れてはなりません。 .It Fl p Ar port -マウスと通信するためのシリアルポートとして +マウスと通信するためのポートとして .Ar port を使います。 +.It Fl r Ar resolution +デバイスの解像度を設定します; +インチあたりのドット数または、 +.Ar low , +.Ar medium-low , +.Ar medium-high , +.Ar high +のいずれかです。 +全デバイスにてこのオプションがサポートされているわけではありません。 .It Fl s シリアルラインのために 9600 ボーを選びます。 -.It Fl t Ar mousetype -シリアルポートにつながっているマウスの形式を指定します。 -有効なマウスの形式は、以下のものです。 +全シリアルマウスがこのオプションをサポートしているわけではありません。 +.It Fl t Ar type +ポートに接続されているマウスのプロトコルタイプを指定します。 +以下に列挙されるタイプを陽に指定するか、 +.Ar auto +を指定して +.Nm +コマンドに適切なプロトコルを自動選択させることができます。 +コマンドラインにてこのオプションを指定しないと、 +.Fl t Ar auto +が仮定されます。 +通常では、 +.Nm +コマンドがプロトコルの自動検出ができない場合に必要です +.Po Sx マウスデーモンの構成 +を参照 +.Pc +。 .Pp +また、 +このオプションでプロトコルタイプを指定した場合、 +前記 +.Fl P +オプションが暗示され、プラグアンドプレイ COM デバイス列挙処理が無効になります。 +.Pp +このオプションにおける有効なタイプを以下に列挙します。 +.Pp +シリアルマウス: .Bl -tag -compact -width mousesystemsxxx -.It microsoft -マイクロソフトマウス -.It mousesystems -マウスシステムマウス -.It mmseries -MM Series マウス -.It logitech -ロジテックマウス -.It busmouse -バスマウス -.It mouseman -Logitech MouseMan と TrackMan -.It ps/2 -PS/2 マウス -.It mmhittab -MM HitTablet +.It Ar microsoft +Microsoft シリアルマウスプロトコル。 +大抵の 2 ボタンマウスはこのプロトコルを使用します。 +.It Ar intellimouse +Microsoft IntelliMouse プロトコル。 +Genius NetMouse, ASCII Mie Mouse, Logitech MouseMan+, FirstMouse+ +もこのプロトコルを使用します。 +他のローラ/ホイールを持つマウスもこのプロトコル互換でしょう。 +.It Ar mousesystems +MouseSystems の 5 バイトプロトコル。 +3 ボタンマウスはこのプロトコルを使用するかもしれません。 +.It Ar mmseries +MM Series マウスプロトコル。 +.It Ar logitech +Logitech マウスプロトコル。 +これは古い Logitech モデルであることに注意。 +新しいモデルには +.Ar mouseman +もしくは +.Ar intellimouse +を指定します。 +.It Ar mouseman +Logitech MouseMan と TrackMan のプロトコル。 +3 ボタンマウスによってはこのプロトコル互換かもしれません。 +MouseMan+ と FirstMouse+ は、このプロトコルではなく、 +.Ar intellimouse +プロトコルを使用します +.It Ar glidepoint +ALPS GlidePoint プロトコル。 +.It Ar thinkingmouse +Kensington ThinkingMouse プロトコル。 +.It Ar mmhittab +Hitachi タブレットプロトコル。 .El +.Pp +バスおよび InPort マウス: +.Bl -tag -compact -width mousesystemsxxx +.It Ar busmouse +バスおよび InPort マウスはこのプロトコルのみ使用可能であり、 +バスおよび InPort マウスはブランドに依らずこのオプションを +指定する必要があります。 +.El +.Pp +PS/2 マウス: +.Bl -tag -compact -width mousesystemsxxx +.It Ar ps/2 +PS/2 マウスはこのプロトコルのみ使用可能であり、 +PS/2 マウスはブランドに依らずこのオプションを +指定する必要があります。 +.El +.It Fl z Ar target +Z 軸(ローラ/ホイール)動作を別の軸や仮想ボタンに割り付けます。 +有効な +.Ar target +は以下のいずれかです: +.Bl -tag -compact -width x__ +.It Ar x +.It Ar y +X または Y 軸の移動として、検知した Z 軸移動を報告します。 +.It Ar N +仮想ボタン +.Ar N +および +.Ar N+1 +を押したイベントとして、検知した負/正の Z 軸移動をそれぞれ報告します。 +物理ボタン +.Ar N +と +.Ar N+1 +が存在する必要はありません。 +論理ボタンへの割り付けは Z 軸移動を仮想ボタンへ割り付けた後に行われます。 +.El +.El +.Ss マウスデーモンの構成 +まず、使用予定マウスのインタフェースタイプを知ることが必要です。 +これはマウスのコネクタを見れば分かります。 +シリアルアウスは D-Sub の 9 ピンまたは 25 ピンのメスです。 +バスおよび InPort のマウスは D-Sub 9 ピンのオスか丸い DIN 9 ピンコネクタです。 +PS/2 マウスは小さくて丸い DIN 6 ピンコネクタです。 +マウスによってはコネクタを別の形状に変換可能なコネクタが附属しています。 +このようなアダプタを使用する場合には、 +マウスから一番遠いコネクタの形状を見てください。 +.Pp +次に決めねばならないことは、インタフェースのために使用するポートです。 +バス、InPort、PS/2 マウスでは、選択肢はありません: +バスおよび InPort マウスは常に +.Pa /dev/mse0 +を使用し、 +PS/2 マウスは常に +.Pa /dev/psm0 +を使用します。 +シリアルマウスの場合、接続可能なポートが複数ありえます。 +多くの人が組み込みのシリアルポート +.Pa /dev/cuaa0 +をマウスに割当てます。 +シンボリックリンク +.Pa /dev/mouse +でマウスの実際のポートを指すようにして、 +どのマウスポートか後で簡単に分かるようにするのが良いかもしれません。 +.Pp +次に適切なマウスプロトコルを選択します。 +.Nm +コマンドはマウスタイプを自動決定可能かもしれません。 +.Nm +コマンドを +.Fl i +オプションを付けて実行し、表示を見ます。 +コマンドがプロトコルタイプを識別した場合、あなたは何も調べる必要はありません。 +プロトコルタイプを指定せずにデーモンを起動可能です +.Po Sx 使用例 +を参照 +.Pc +。 +.Pp +コマンドは、マウスドライバが +.Ar sysmouse +プロトコルをサポートする場合、 +.Ar sysmouse +と表示するかもしれません。 +.Pp +表示される +.Dv type +と +.Dv model +は、対象のポインティングデバイスの製品名では必ずしもありませんが、 +互換性のあるデバイスの名前でしょう。 +.Pp +.Fl i +オプションがなにも表示しない場合、 +.Nm +に対して +.Fl t +オプションを使用し、プロトコルタイプを指定する必要があります。 +予測して試行する必要があります。 +以下に経験則を示します: +.Pp +.Bl -tag -compact -width 1.X +.It 1. +バスおよび InPort マウスはブランドに依らず +.Ar busmouse +プロトコルを使用します +.It 2. +PS/2 マウスはブランドに依らず +.Ar ps/2 +プロトコルを使用します +.It 3. +ほとんどの 2 ボタンシリアルマウスは +.Ar microsoft +プロトコルをサポートします。 +.It 4. +3 ボタンシリアルマウスは +.Ar mousesystems +プロトコルで動作するかもしれません。動作しない場合には、 +三番目(中)ボタンが機能せずに +.Ar microsoft +プロトコルで動作するでしょう。 +3 ボタンシリアルマウスは、期待通り三番目のボタンが動作しつつ +.Ar mouseman +プロトコルで動作するかもしれません。 +.It 5. +3 ボタンマウスには小さなスイッチが付いていて、 +``MS'' と ``PC'' または ``2'' と ``3'' とで選択できるできるようになっている +かもしれません。 +``MS'' と ``2'' は通常 +.Ar microsoft +プロトコルを意味します。 +``PC'' と ``3'' は +.Ar mousesystems +プロトコルを選択します。 +.It 6. +マウスにローラやホイールが付いている場合、 +.Ar intellimouse +プロトコル互換でしょう。 +.El +.Pp +マウスのために選択したプロトコルタイプが正しいかどうかテストする目的で、 +現在の仮想コンソールでマウスポインタを有効にします。 +.Pp +.Dl vidcontrol -m on +.Pp +マウスデーモンをフォアグラウンドで開始します。 +.Pp +.Dl moused -f -p Ar _selected_port_ -t Ar _selected_protocol_ +.Pp +マウスポインタがマウスの移動に伴い、 +正しく移動することを確認してください。 +そして、カットとペーストの機能を左、右、中のボタンを使用して確認してください。 +^C をタイプすると、コマンドは停止します。 +.Ss 複数のマウス +システムに接続したマウスと同じ数だけ、マウスデーモンを同時実行可能です; +一つのマウスデーモンが一つのマウスに対応します。 +ラップトップコンピュータ組み込みの PS/2 ポインティングデバイスを移動中使用し、 +オフィスではドッキングステーション接続のシリアルマウスを使用する +場合に有用です。 +マウスデーモンを二つ実行し、アプリケーションプログラム +.Pq 例えば X Window System +に +.Xr sysmouse +を使用させます。 +するとアプリケーションプログラムは常に両マウスからマウスデータを受け取ります。 +シリアルマウスが取り付けられていない場合、 +対応するマウスデーモンは移動やボタン状態の変化を検出しませんので、 +アプリケーションプログラムは PS/2 マウスのデーモンからのマウスデータ +のみを使います。 +一方この構成で両方のマウスを接続し同時に両方を動かした場合、 +マウスの移動をすべて組合せたようにマウスポインタがスクリーン上を移動します。 +.Sh 関連ファイル +.Bl -tag -width /dev/consolectl -compact +.It Pa /dev/consolectl +コンソール制御デバイス +.It Pa /dev/mse%d +バスおよび InPort マウスのドライバ +.It Pa /dev/psm%d +PS/2 マウスドライバ +.It Pa /dev/sysmouse +仮想化されたマウスドライバ +.It Pa /dev/ttyv%d +仮想コンソール .El .Sh 使用例 .Pp -.Dl moused -t microsoft -p /dev/mouse +.Dl moused -p /dev/cuaa0 -i type +.Pp +.Nm +コマンドにシリアルポート +.Pa /dev/cuaa0 +に接続されたマウスのプロトコルタイプを識別させます。 +成功すると、コマンドはタイプを表示しますが、 +失敗すると ``unknown'' が表示されます。 +.Pp +.Dl moused -p /dev/cuaa0 .Dl vidcontrol -m on .Pp -マウスデーモンを、シリアルデバイス +.Nm +が指定されたポートのマウスプロトコルタイプを識別可能な場合、 +.Fl t +オプション無してデーモンを起動可能であり、 +前記のようにマウスポインタをテキストコンソール上で有効にできます。 +.Pp +.Dl moused -p /dev/mouse -t microsoft +.Dl vidcontrol -m on +.Pp +シリアルポート .Pa /dev/mouse -に対し、マイクロソフトマウス、マウスポインタ有効の条件で開始します。 +に対してマウスデーモンを起動します。 +プロトコルタイプは +.Ar microsoft +を +.Fl t +オプションにて陽に指定しています。 +.Pp +.Dl moused -p /dev/mouse -m 1=3 -m 3=1 +.Pp +物理ボタン 3 (右ボタン) を論理ボタン 1 (論理的に左) に、 +物理ボタン 1 (左ボタン) を論理ボタン 3 (論理的に右) に、 +それぞれ割当てます。 +左右のボタンを事実上交換します。 +.Pp +.Dl moused -p /dev/mouse -t intellimouse -z 4 +.Pp +Z 軸(ローラ)における負の移動をボタン 4 が押されたものとし、 +Z 軸における正の移動をボタン 5 が押されたものとします。 +.Sh 警告 +.Nm +コマンドは現在別のコンソールドライバ +.Xr pcvt 4 +では動作しません。 +.Pp +バッドデバイスの多くは、 +ユーザがパッド表面を ``タップ'' した場合に最初の(左) ボタンが +押されたものとします。 +また、ALPS GlidePoint モデルによっては、 +タップ動作を 4 番目のボタンのイベントとして扱います。 +このようなモデルでは、オプション ``-m 1=4'' を使用して、 +他のパッドデバイスと同様の効果を得られます。 +.Pp +仮想コンソールでのカットとペーストの機能は、 +マウスに 3 ボタンあることを仮定しています。 +論理ボタン 1 (論理的に左) は、 +コンソールのテキスト領域を選択してカットバッファにコピーします。 +論理ボタン 3 (論理的に右) は、 +選択された領域を拡張します。 +論理ボタン 2 (論理的に中) は、 +選択されたテキストをテキストカーソル位置にペーストします。 +マウスに 2 つしかボタンが無い場合、中央の `ペースト' ボタン +は使用できません。 +ペースト機能を使用するためには、 +.Fl 3 +オプションを使用して中ボタンをエミュレートするか、 +.Fl m +オプションを ``-m 2=3'' のように使用して +物理右ボタンに論理中ボタンを割当てます。 .Sh 関連項目 +.Xr kill 1 , .Xr vidcontrol 1 , .Xr keyboard 4 , +.Xr mse 4 , .Xr pcvt 4 , +.Xr psm 4 , .Xr screen 4 , .Xr sysmouse 4 +.Sh 規格 +.Nm +コマンドは ``Plag and Play External COM Device Specification'' の一部を +サポートし、PnP シリアルマウスをサポートします。 +しかしながら、シリアルマウスごとに仕様充足の度合が異なりますので、 +標準のバージョン 1.0 に完全に従ってはいません。 +このように厳密さを欠いた方法でも、シリアルマウスの適切なプロトコルタイプ +を常に決定できるわけではありません。 .Sh 作者 .Nm コマンドは、 @@ -113,6 +540,9 @@ MM HitTablet このマニュアルは、 .An Mike Pritchard .Aq mpp@FreeBSD.org によって書かれました。 +コマンドとマニュアルページを、 +.An Kazutaka YOKOTA Aq yokota@FreeBSD.org +が更新しました。 .Sh 歴史 .Nm コマンドは、 diff --git a/ja/man/man8/natd.8 b/ja/man/man8/natd.8 index ed10998370..59322d9e9c 100644 --- a/ja/man/man8/natd.8 +++ b/ja/man/man8/natd.8 @@ -235,7 +235,26 @@ alias オプションか .Fl interface オプションが指定されなければなりません。 - +指定されたアドレスは、 +公開されたネットワークインタフェースに割当てられたアドレスである +必要があります。 +.Pp +このアドレスのインタフェースを通って出る全データのソースアドレスは +.Ar address +に書換えられます。 +外部からこのインタフェースに到着する全データは、 +既に alias された外向け接続にマッチするかどうかチェックされます。 +マッチする場合、パケットはそれぞれ変換されます。 +マッチしない場合、 +.Fl redirect_port +と +.Fl redirect_address +の割り当てをチェックしそれぞれの動作を行います。 +他の動作が行えない場合かつ +.Fl deny_incoming +が指定されていない場合、 +パケットに指定された通りに +パケットはローカルのマシンのポートに配送されます。 .It Fl n | interface Ar interface alias アドレスを決めるのに、 .Ar interface @@ -244,6 +263,10 @@ alias に関連づけられた IP アドレスが変化する可能性がある場合には、 .Fl dynamic フラグも指定されるべきです。 +.Pp +指定された +.Ar interface +は公開されたネットワークインタフェースである必要があります。 .It Fl f | config Ar configfile .Ar configfile @@ -387,8 +410,8 @@ alias .El .Sh 関連項目 -.Xr socket 2 , .Xr getservbyname 2 , +.Xr socket 2 , .Xr divert 4 , .Xr services 5 , .Xr ipfw 8 diff --git a/ja/man/man8/newfs.8 b/ja/man/man8/newfs.8 index 3f05b73902..e41d7d8530 100644 --- a/ja/man/man8/newfs.8 +++ b/ja/man/man8/newfs.8 @@ -29,10 +29,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)newfs.8 8.3 (Berkeley) 3/27/94 +.\" @(#)newfs.8 8.6 (Berkeley) 5/3/95 .\" jpman %Id: newfs.8,v 1.3 1997/07/26 22:02:06 horikawa Stab % .\" -.Dd March 27, 1994 +.Dd May 3, 1995 .Dt NEWFS 8 .Os BSD 4.2 .Sh 名称 @@ -43,6 +43,7 @@ .Nm newfs .Op Fl NO .Op Fl S Ar sector-size +.Op Fl T Ar disktype .Op Fl a Ar maxcontig .Op Fl b Ar block-size .Op Fl c Ar cylinders @@ -53,6 +54,7 @@ .Op Fl k Ar skew .Op Fl l Ar interleave .Op Fl m Ar free space +.Op Fl n Ar rotational positions .Op Fl o Ar optimization .Op Fl p Ar sectors .Op Fl r Ar revolutions @@ -73,6 +75,7 @@ .Op Fl f Ar frag-size .Op Fl i Ar bytes .Op Fl m Ar free space +.Op Fl n Ar rotational positions .Op Fl o Ar options .Op Fl s Ar size .Ar special node @@ -107,7 +110,9 @@ に指定するパラメータは .Nm newfs のものと同じです。 -スペシャルファイルはディスクラベルを読むためにのみ使われ、 +.Fl T +フラグが指定されると(下記参照)、スペシャルファイルを使用しません。 +そうでない場合、スペシャルファイルはディスクラベルを読むためにのみ使われ、 それによってメモリベースファイルシステムへのコンフィギュレーション パラメータが得られます。 このスペシャルファイルは通常、第一スワップ領域を指定します。という @@ -133,6 +138,10 @@ 4.3BSD フォーマットのファイルシステムを作成します。この オプションは、古いブート ROM が理解できるルートファイル システムを使う必要がある場合に使います。 +.It Fl T +指定したディスクのための情報を +.Pa /etc/disktab +から得て、disklabel を使用しません。 .It Fl a Ar maxconting 回転遅延 (rotational delay) を強制する前に 配置される連続ブロックの最大数を指定します ( @@ -153,6 +162,7 @@ 期待値を指定します (ミリ秒単位)。デフォルトは0ミリ秒です。詳細は、 .Xr tunefs 8 を参照してください。 +.ne 1i .It Fl e Ar maxbpg 単一のファイルが他のシリンダグループへまたがることを強制される前に、 1 つのシリンダグループから割り当てることのできる最大のブロック数を指定し @@ -230,6 +240,7 @@ i に含まれません。 .It Fl r Ar revolutions/minute 1 分間あたりのディスク回転速度を指定します。 +.ne 1i .It Fl t Ar #tracks/cylinder ファイルシステムによってデータを割り当てることができるシリンダあたりの トラック数です。デフォルトは 1 です。0 が設定された場合にはディスクラベル @@ -268,11 +279,11 @@ i .El .Sh 使用例 .Pp -.Dl mount_mfs -s=20480 -o nosuid,nodev /dev/sd0b /tmp +.Dl mount_mfs -s=131072 -o nosuid,nodev /dev/sd0b /tmp .Pp .Xr mount 8 の nosuid と nodev のオプションを指定し、 -10240 KB の大きさのメモリファイルシステムを /tmp にマウントします。 +64 MB の大きさのメモリファイルシステムを /tmp にマウントします。 .Sh 関連項目 .Xr fdformat 1 , .Xr disktab 5 , diff --git a/ja/man/man8/pccardd.8 b/ja/man/man8/pccardd.8 index 344191dfea..c017c010bc 100644 --- a/ja/man/man8/pccardd.8 +++ b/ja/man/man8/pccardd.8 @@ -23,7 +23,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: pccardd.8,v 1.4.2.2 1997/10/08 07:33:51 charnier Exp % +.\" %Id: pccardd.8,v 1.4.2.3 1997/12/25 09:35:59 hoek Exp % .\" jpman %Id: pccardd.8,v 1.4 1997/07/26 22:04:06 horikawa Stab % .\" .Dd November 1, 1994 diff --git a/ja/man/man8/addgroup.8 b/ja/man/man8/pnpinfo.8 similarity index 52% rename from ja/man/man8/addgroup.8 rename to ja/man/man8/pnpinfo.8 index 09f236e133..fcea6dca01 100644 --- a/ja/man/man8/addgroup.8 +++ b/ja/man/man8/pnpinfo.8 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1996 Wolfram Schneider . Berlin. +.\" Copyright (c) 1996, Sujal M. Patel .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -9,6 +9,12 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Sujal M. Patel +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE @@ -22,64 +28,32 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: addgroup.8,v 1.1.2.2 1997/03/06 07:59:13 mpp Exp % -.\" jpman %Id: addgroup.8,v 1.3 1997/07/22 16:43:02 horikawa Stab % - -.Dd Oct, 30, 1996 -.Dt ADDGROUP 8 -.Os FreeBSD 2.2 +.\" %Id: pnpinfo.8,v 1.1.1.1 1997/09/19 15:36:00 jmg Exp % +.\" +.Dd January 7, 1996 +.Dt PNPINFO 8 +.Os .Sh 名称 -.Nm addgroup -.Nd グループ追加もしくはユーザをグループへ追加 +.Nm pnpinfo +.Nd "Plug-n-Play ISA デバイスに関する情報の報告" .Sh 書式 -.Nm -.Op Fl g Ar gid -.Ar group -.Op Ar user Ns , Ns Ar user,... +.Nm pnpinfo .Sh 解説 -.Nm -コマンドは -.Xr group 5 -データベースにグループを加えます。 -オプションの -.Ar user -引数が与えられた場合、グループのメンバーリストにそのユーザが -加えられます。 -.Ar user -引数は、コンマ (,) で区切られたユーザ名のリストです。 -もし、 -.Ar group -が既に存在した場合、 -.Ar user -が -.Ar group -に加えられます。 -.Sh オプション -.Bl -tag -width Ds -.It Sy -g gid -グループ id が -.Ar gid -の新しいグループを、作ることが可能であるかそれより大きな id が -空いている場合は、作成されます。デフォルトの gid は 1000 です。 -このオプションは新しいグループを作る時にだけ使えます。 -.El -.Sh 使用例 -.Pp -$ addgroup -g 5000 cracau -.Pp -グループ id 5000 以上の `cracau' というグループを作ります。 -.Pp -$ addgroup foo blech,bar -.Pp -ユーザ `blech' と `bar' をグループ `foo' に加えます。 -もし、グループ `foo' が無い場合は、新たに作ります。 +.Nm +は Plug-n-Play ISA デバイスに関する情報を報告します。 +ベンダ ID、シリアル番号、I/O ポート、IRQ といった情報は、 +ISA PnP デバイス付きでカーネルを構築するときに有用です。 +.Sh バグ +数個のタグが未実装です (99% の PnP カードには十分です)。 .Sh 関連項目 -.Xr group 5 , -.Xr adduser 8 , -.Xr rmgroup 8 , -.Xr rmuser 8 +.Xr pnp 4 .Sh 歴史 .Nm -コマンドは -.Fx 2.2 -から導入されました。 +ユーティリティは +.Tn FreeBSD +2.2 +にて初めて登場しました。 +.Sh 作者 +.Bl -tag +Sujal M. Patel, smpatel@umiacs.umd.edu +.El diff --git a/ja/man/man8/ppp.8 b/ja/man/man8/ppp.8 index 1824a47d12..3832e1216d 100644 --- a/ja/man/man8/ppp.8 +++ b/ja/man/man8/ppp.8 @@ -1,15 +1,21 @@ -.\" %Id: ppp.8,v 1.19.2.32 1997/10/05 14:28:27 brian Exp % +." $Id: ppp.8,v 1.2 1998-02-27 01:27:29 hanai Exp $ .\" jpman %Id: ppp.8,v 1.4 1997/06/08 18:41:58 saeki Stab % .Dd 20 September 1995 .Os FreeBSD .Dt PPP 8 .Sh 名称 .Nm ppp -.Nd -PPP (Point to Point Protocol) (別名 iijppp) +.Nd PPP (Point to Point Protocol) (別名 iijppp) .Sh 書式 .Nm -.Op Fl auto | background | ddial | direct | dedicated +.\" SOMEONE FIX ME ! The .Op macro can't handle enough args ! +[ +.Fl auto | +.Fl background | +.Fl ddial | +.Fl direct | +.Fl dedicated +] .Op Fl alias .Op Ar system .Sh 解説 @@ -17,22 +23,22 @@ PPP (Point to Point Protocol) ( .Em PPP パッケージです。 .Em PPP -は通常、(pppd でそうなっているように) カーネルの一部として実装されますが、 +は通常、( +.Xr pppd 8 +でそうなっているように) カーネルの一部として実装されますが、 そのため、デバッグや動作の変更が少々難しい場合があります。 しかしながら、この実装ではトンネルデバイス (tun) を利用して、ユーザプロセスで .Em PPP を実現しています。 - .Sh 主な特徴 - .Bl -diag -.It 対話的なユーザインターフェースを提供 +.It 対話的なユーザインタフェースを提供 コマンドモードで利用する場合、ユーザがコマンドを -入力することで、簡単にリモートコンピュータとの接続の確立や接続状態の確認、 -接続の解放を行なうことができます。 +入力することで、簡単にリモートコンピュータとの接続の確立、 +接続状態の確認、 +接続の解放を行うことができます。 オプションとして、セキュリティ確保のために すべての機能をパスワードで保護することができます。 - .It 手動と自動でのダイアルをサポート 対話モードでは、直接モデムと通信できるように .Dq term @@ -40,56 +46,71 @@ PPP (Point to Point Protocol) ( モデムがリモートホストと接続されて、 .Em PPP での通信が始まったら、 -.Em PPP +.Nm はそれを検出して自動的にパケットモードに移行します。 ひとたびリモートホストとの接続に必要なコマンドシーケンスがわかったら、 後々の接続を簡単にするため、必要なダイアル手順やログイン手順を定義した チャットスクリプトを書くことができます。 - .It オンデマンドでのダイアルアップをサポート -auto モード (自動モード) では +.Fl auto +モード (自動モード) では .Nm はデーモンとして動作し、 .Em PPP リンクを通して送られるパケットを待ちうけます。 -パケットを検出すると、デーモンが自動的にダイアルを行なって接続を確立します。 - -ddial モード (専用モードまたはデーモンダイアルモード) でも -ほぼ同様に、自動ダイアルと接続の確立を行ないます。 +パケットを検出すると、デーモンが自動的にダイアルを行って接続を確立します。 +.Fl ddial +モード (直接ダイアルモード) でも +ほぼ同様に、自動ダイアルと接続の確立を行います。 しかしながらこのモードは、送るべきパケットが存在しない場合にも、 リンクが切れていることを検出するといつでもリモートへダイアルするという点が auto モードと異なります。 このモードは、電話料金よりも常時接続されていることが重視される場合に有用です。 - +3 番目の +.Fl dedicated +モード (専用モード) も利用可能です。 +このモードは 2 つのマシン間の専用線を対象にしています。 +専用モードでは +.Nm +は自発的に動作を終了することはありません - 終了するには +.Dq quit all +コマンドを診断ソケットを介して送る必要があります。 +.Dv SIGHUP +は LCP の再交渉を強要し、 +.Dv SIGTERM +は終了を強要します。 .It パケットエイリアシングをサポート -一般には IP マスカレードとして知られるパケットエイリアシングにより、 +パケットエイリアシング (別名: IP マスカレード) により、 未登録でプライベートなネットワーク上のコンピュータからも インターネットにアクセスすることが可能です。 .Em PPP ホストはマスカレードゲートウェイとして動作します。 送信パケットの IP アドレスと TCP や UDP のポート番号は どちらもエイリアスされ、返信パケットではエイリアスが元に戻されます。 - .It バックグラウンド PPP 接続をサポート バックグラウンドモードでは、接続を確立するのに成功した場合に .Nm はデーモンになります。 それ以外の場合はエラーで終了します。 - +これにより、 +接続が成功裏に確立した場合のみコマンドを実行するようなスクリプト +をセットアップすることが出来ます。 .It サーバとしての PPP 接続をサポート ダイレクトモードでは、 .Nm は標準入力/標準出力からの .Em PPP 接続を受け入れるサーバとして動作させることができます。 - .It PAP と CHAP による認証をサポート - +PAP もしくは CHAP を用いることにより、Unix スタイルの +.Xr login 1 +手続きをスキップし、 +.Em PPP +プロトコルを代りに認証に使用することが可能です。 .It 代理 arp (Proxy Arp) をサポート .Em PPP -がサーバとして動作している時、その接続について代理 arp を行なうよう +がサーバとして動作している時、その接続について代理 arp を行うよう 設定できます。 - .It パケットのフィルタリングをサポート ユーザは 4 種類のフィルタを定義できます。 .Em ifilter @@ -97,22 +118,19 @@ auto .Em ofilter は送信パケットに対するフィルタです。 .Em dfilter -はダイアルを行なうきっかけとなるパケットを定義するフィルタで、 +はダイアルを行うきっかけとなるパケットを定義するフィルタで、 .Em afilter は接続を保持するためのパケットを定義するフィルタです。 - .It トンネルドライバは bpf (Berkeley Packet Filter) をサポート .Em PPP リンクを流れるパケットを調べるために、 .Xr tcpdump 1 を使うことができます。 - -.It PPP over TCP をサポート - +.It PPP オーバ TCP をサポート .It IETF ドラフトの Predictor-1 圧縮をサポート .Nm は VJ 圧縮の他に Predictor-1 圧縮もサポートしています。 -モデムは通常 (たとえば v42.bis のような) 組み込みの圧縮機能を持っており、 +モデムは通常 (例えば v42.bis のような) 組み込みの圧縮機能を持っており、 その結果システムは .\"(訳注)「転送データレートよりも」をここにいれたいと考えています。 .\" 2.2.1R 対象(1997/04/02) Takeshi MUTOH @@ -124,15 +142,13 @@ auto VJ 圧縮とは異なり、Predictor-1 圧縮はリンクを通る .Em すべての データをあらかじめ圧縮しておくことで、オーバヘッドを最小にします。 - -.It マイクロソフトの IPCP 拡張をサポート -マイクロソフトの +.It Microsoft の IPCP 拡張をサポート +Microsoft の .Em PPP スタックを使用するクライアント (つまり Win95, WinNT) との間で ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを -調停することができます。 +交渉することができます。 .El - .Sh パーミッション .Nm ppp はユーザ @@ -142,27 +158,27 @@ VJ 、パーミッション .Dv 4550 でインストールされます。 +デフォルトでは .Nm ppp -は、起動したユーザ ID が 0 でない場合には、 -クライアントモードでは実行しません。 -.Nm ppp -は、通常ユーザの場合には、 -.Fl direct -モードで実行します。 -しかし実行パーミッションの都合により、 -このユーザはグループ -.Dv network -に属する必要があります。 -通常ユーザとして実行するする場合には、 -システムのルーティングテーブルを変更するために、 +は、起動したユーザ ID が 0 でない場合には実行しません。 +これは +.Dq allow users +コマンドを +.Pa /etc/ppp/ppp.conf +に記載することにより変更することが可能です。 +通常ユーザとして実行する場合には、 .Nm -はユーザ ID 0 に変わります。 +はユーザ ID 0 に変わり、システムのルーティングテーブルを変更するために、 +システムロックファイルを作成し、 +ppp の設定ファイルを読みます。 全ての外部コマンド ("shell" や "!bg" で実行されます) は、 .Nm ppp を起動したユーザ ID で実行されます。 - +ユーザ ID 0 にて正確になにが行われているのかに興味がある場合には、 +ログ機能の +.Sq ID0 +を参照してください。 .Sh 始める前に - 最初に .Nm を実行する時には、いくつかの初期設定を整える必要があります。 @@ -170,29 +186,27 @@ VJ なりません (GENERIC カーネルではデフォルトで 1 つ含まれます)。 もし含まれていない場合や複数の tun インタフェースが必要な場合、 以下の行をカーネル設定ファイルに追加して、 -カーネルを再構築する必要があります。 - +カーネルを再構築する必要があります: +.Pp .Dl pseudo-device tun N - +.Pp ここで .Ar N は .Em PPP -接続を行ないたい最大の数です。 - +接続を行いたい最大の数です。 つぎに、 .Pa /dev ディレクトリにトンネルデバイスのエントリ .Pa /dev/tunN があるかどうかを調べてください。 ここで -.Ar N +.Sq N は、0 から始まる tun デバイスの番号です。 -もし無いようならば、"MAKEDEV tunN" を実行すれば作ることができます。 +もし無いようならば、"sh ./MAKEDEV tunN" を実行すれば作ることができます。 これにより 0 から .Ar N までの tun デバイスが作成されます。 - 最後に、ログファイルを作成します。 .Nm ppp は @@ -203,81 +217,77 @@ VJ このファイルに出力を行うためには、以下の行を .Pa /etc/syslog.conf ファイルに記述してください: - -.Dl !ppp -.Dl *.*/var/log/ppp.log - +.Bd -literal -offset indent +!ppp +*.*/var/log/ppp.log +.Ed +.Pp TAB と書かれている場所には、実際にはタブを入力します。 スペースを使うと、なにも知らされぬままこの行は無視されます。 - -ppp の実行形式にリンクを作成することにより、 -複数の ppp ログファイルを持つことが可能です: - +.Nm +の実行形式にリンクを作成することにより、複数の +.Em PPP +ログファイルを持つことが可能です: +.Pp .Dl # cd /usr/sbin .Dl # ln ppp ppp0 - +.Pp として .Pa /etc/syslog.conf で - -.Dl !ppp0 -.Dl *.* /var/log/ppp0.log - +.Bd -literal -offset indent +!ppp0 +*.* /var/log/ppp0.log +.Ed +.Pp とします。 .Pa /etc/syslog.conf を更新した後に、 -.Nm syslogd +.Xr syslogd 8 に .Dv HUP シグナルを送ることをお忘れなく。 - .Sh 手動ダイアル - 以下の例では、あなたのマシン名が -.Nm awfulhak +.Dv awfulhak であるとして説明します。 - -ホスト名とパスワードを -.Pa /etc/ppp/ppp.secret -に設定している場合、help, passwd, quit コマンドしか実行できないでしょう。 - -.Bd -literal -offset indent -ppp on "your hostname"> help - help : Display this message - passwd : Password for security - quit : Quit the PPP program -ppp on awfulhak> pass -.Ed - -正しいパスワードを入力すると、プロンプトの "on" は "ON" に変わります。 - +.Nm +を引数無しで起動すると (前述の +.Em パーミッション +参照) 次のプロンプトが表示されます: .Bd -literal -offset indent ppp ON awfulhak> .Ed - +.Pp +プロンプトの +.Sq ON +の部分は常に大文字であるべきです。ここが小文字の場合、 +.Dq passwd +コマンドを使用してパスワードを入力しなければならないことを意味します。 +実行中の +.Nm +に接続し、 +まだ正しいパスワードを入力していない場合にのみこのような状態になります。 +.Pp ここで、モデムのデバイス名、スピードやパリティの設定、 CTS/RTS 信号を使うかどうか (デフォルトでは CTS/RTS が使用されます) を -指定できます。もしハードウェアが CTS/RTS 信号を持っていない場合 -(これは ppp 可能な端末サーバに直接つなぐ場合に起こり得ます)、 +指定して、開始可能です。もしハードウェアが CTS/RTS 信号を持っていない場合 +(これは PPP 可能な端末サーバに直接つなぐ場合に起こり得ます)、 .Nm は そのポートを通してどんな出力も送らず、来るはずのない信号を待ち続けます。 したがって、直接接続で通信ができないような場合には、 -ctsrts を off にしてみてください。 - +CTS/RTS を off にしてみてください: .Bd -literal -offset indent ppp ON awfulhak> set line /dev/cuaa0 ppp ON awfulhak> set speed 38400 ppp ON awfulhak> set parity even ppp ON awfulhak> set ctsrts on ppp ON awfulhak> show modem - * モデム関連のパラメータが、ここに示されます * - ppp ON awfulhak> .Ed - -ここでは、直接モデムと通信するために term コマンドを使用可能です。 - +.Pp +ここでは、直接モデムと通信するために term コマンドを使用可能です: .Bd -literal -offset indent ppp ON awfulhak> term at @@ -288,82 +298,84 @@ login: ppp Password: Protocol: ppp .Ed - -相手が PPP で話しはじめると、 +.Pp +相手が +.Em PPP +で話しはじめると、 .Nm はそれを自動的に検出してコマンドモードに戻ります。 - .Bd -literal -offset indent ppp ON awfulhak> PPP ON awfulhak> .Ed - +.Pp これで接続されました! プロンプトの .Sq PPP が大文字に変化して、接続されたことを知らせます。 show コマンドを使用すれば、どのように事態が進行しているのかが分ります: - .Bd -literal -offset indent PPP ON awfulhak> show lcp - * LCP 関連の情報がここに表示されます * - PPP ON awfulhak> show ipcp - * IPCP 関連の情報がここに表示されます * .Ed - +.Pp この時点で、マシンは接続先に対するホスト単位のルート (host route) を持っています。 これはリンクの相手のホストとのみ接続可能であるという意味です。 デフォルトルートのエントリ -(他のルーティングエントリを持たずに、全パケットを ppp リンクの相手に送る +(他のルーティングエントリを持たずに、全パケットを +.Em PPP +リンクの相手に送る ように、あなたのマシンに指示します)を追加したければ、 以下のコマンドを入力してください。 - .Bd -literal -offset indent -PPP ON awfulhak> add 0 0 HISADDR +PPP ON awfulhak> add default HISADDR .Ed - +.Pp .Sq HISADDR という文字列は、相手側の IP アドレスを表します。 -この変数は接続が確立して始めて使用可能となります。 -よくある誤りとして、上記記述を -.Pa ppp.conf -ファイルに指定してしまうということがあります。 -このファイルが読まれる時には、リモート IP アドレスは確立していませんので、 -うまくいきません。 - +.Sq HISADDR +の位置に +.Sq INTERFACE +キーワードを使用可能です。 +これにより tun インタフェース上に直接経路を作成します。 ここで、(ping, telnet, ftp のような) ネットワークアプリケーションを 別のウインドウで使用可能です。 - -使用可能コマンドの詳細は PPP コマンドリストの節を参照してください。 - +使用可能コマンドの詳細は +.Em PPP コマンドリスト +の節を参照してください。 .Sh 自動ダイアル - -自動ダイアルを行なうためには、 Dial と Login のチャットスクリプトを +自動ダイアルを行うためには、 Dial と Login のチャットスクリプトを 用意しなければなりません。定義の例は .Pa /etc/ppp/ppp.conf.sample -を見てください (ppp.conf の書式は非常に簡単です)。 - +を見てください ( +.Pa /etc/ppp/ppp.conf +の書式は非常に簡単です)。 +各行は単一のコメント、インクルード、ラベル、コマンドのいずれかを含みます。 .Bl -bullet -compact - .It -各行には一つのコマンドまたはラベル、コメントのいずれかが書かれます。 - -.It -.Sq # +.Pq Dq # で始まる行は、コメントとして扱われます。 +コメント行と認識した場合、先行する空白は無視されます。 .It -ラベルは行頭から始まり、最後にコロン (:) が続かなければなりません。 - +インクルードは語 +.Sq !include +から始まる行です。 +一つの引数 - インクルードするファイル - を持つ必要があります。 +古いバージョンの +.Dq !include ~/.ppp.conf +を使用したいかもしれません。 +.It +ラベルは行頭から始まり、最後にコロン +.Pq Dq \&: +が続かなければなりません。 .It コマンド行は、空白かタブで始まらなければなりません。 - .El - -.Pa ppp.conf +.Pp +.Pa /etc/ppp/ppp.conf ファイルには少くとも .Dq default セクションが存在する必要があります。 @@ -376,7 +388,6 @@ PPP ON awfulhak> add 0 0 HISADDR は入力の .Nm 構成を表したります。 - .Nm ppp を立ち上げる際に、接続先のラベル名を指定可能です。 .Dq default @@ -386,15 +397,17 @@ PPP ON awfulhak> add 0 0 HISADDR を引数無しで起動した場合、 .Dq default だけは実行されます。load コマンドを使用して、 -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf のセクションを手動でロード可能です: - .Bd -literal -offset indent PPP ON awfulhak> load MyISP .Ed - -ひとたび接続が確立したなら、プロンプトの ppp は PPP に変わります: - +.Pp +ひとたび接続が確立したなら、プロンプトの +.Sq ppp +は +.Sq PPP +に変わります: .Bd -literal -offset indent # ppp MyISP ... @@ -403,7 +416,7 @@ dial OK! login OK! PPP ON awfulhak> .Ed - +.Pp もし .Pa /etc/ppp/ppp.linkup が存在していれば、 @@ -415,18 +428,22 @@ PPP ON awfulhak> の .Dq pmdeman の例を参照してください。 -HISADDR という文字列はリモート側の IP アドレスを表しています。 +.Dv HISADDR , +.Dv MYADDR , +.Dv INTERFACE +という文字列はおのおのの IP アドレスとインタフェース名を表しています。 同様に、接続が閉じられると、 .Pa /etc/ppp/ppp.linkdown ファイルの内容が実行されます。 - +これらのファイルのフォーマットは +.Pa /etc/ppp/ppp.conf +と同じです。 .Sh バックグラウンドダイアル - .Nm ppp -を使って非対話的に接続を確立したい場合 (たとえば -.Xr crontab(5) +を使って非対話的に接続を確立したい場合 (例えば +.Xr crontab 5 エントリや -.Xr at(1) +.Xr at 1 ジョブから使うような場合) には、 .Fl background オプションを使います。この場合にも @@ -438,7 +455,6 @@ HISADDR リモートの接続先の IP アドレスを定義する必要があります。( .Pa /etc/ppp/ppp.conf.sample 参照。) - .Fl background が指定された場合、 .Nm @@ -447,7 +463,6 @@ HISADDR これらに失敗すると、 .Nm は即座に終了し、0 でない終了コードを返します。 - 接続に成功すると .Nm はデーモンになり、呼び出し側に終了コード 0 を返します。 @@ -455,9 +470,7 @@ HISADDR もしくは .Dv TERM シグナルを受け取った場合に、自動的に終了します。 - -.Sh ダイアル・オンデマンド - +.Sh ダイアルオンデマンド デマンドダイアル機能は .Fl auto または @@ -470,13 +483,12 @@ HISADDR コマンドも書かれていなければなりません ( .Pa /etc/ppp/ppp.conf.sample を参照してください)。 - .Bd -literal -offset indent # ppp -auto pmdemand ... # .Ed - +.Pp .Fl auto または .Fl ddial @@ -489,35 +501,37 @@ HISADDR や .Fl direct のモードでも可能です): - .Bd -literal -offset indent # pppctl -v 3000 show ipcp Password: -IPCP [OPEND] +IPCP [Opened] his side: xxxx .... .Ed - +.Pp 現在 .Xr telnet 1 -を使用して対話的に会話できます。 - +を使用して対話的に会話することもできます。 .Pp -それぞれの +これを実現するために、後述のように +.Dq set server +コマンドを使用する必要があります。 +.Pa /etc/ppp/ppp.secret +を設定し +.Dv USR1 +シグナルを送ることにより、 +過去を振り返って診断ポートにて listen するように .Nm -デーモンは "3000 + トンネルデバイス番号" で計算される番号のポートで -参照できます。 - +プログラムを実行することが可能です。 .Fl auto モードにて 送信パケットが検出された時、 .Nm -は (チャットスクリプトにもとづいて) ダイアルを行ない、 +は (チャットスクリプトに基づいて) ダイアルを行い、 通信相手に接続しようとします。 .Fl ddial モードでは回線がダウンしていることが確認された場合にはいつでも -ダイアルが行なわれます。 - +ダイアルが行われます。 接続に失敗したら、デフォルトの動作では 30 秒間待ち、 別の送信パケットが検出された時に接続しようとします。 この動作は @@ -552,10 +566,9 @@ set redial 10.3 4 .Pp は個々の送信パケットに対して 4 回接続を試み、 番号間の待ち時間が 3 秒で、すべての番号を試した後に -10 秒待つことをあらわします。 +10 秒待つことを表します。 複数の電話番号が指定されている場合でも、トータルのダイアル回数は 4 回のままです。 (それぞれの番号を 4 回ダイアルするのではありません)。 - リンクの両端が .Nm のデマンドダイアルモードを利用している場合は、 @@ -563,7 +576,6 @@ set redial 10.3 4 もし、リンクの両端が同じタイムアウト時間に設定されていて、 リンクが切れて両方に送信待ちのパケットがあった場合、 両方が同時に相手を呼び出しあうことになってしまいます。 - 場所によっては、シリアルリンクに信頼性がなく、 切れるべきでない時にキャリアが失われるかもしれません。 セッションの途中で予期せずキャリアが失われた場合、 @@ -572,16 +584,18 @@ set redial 10.3 4 .Bd -literal -offset indent set reconnect timeout ntries .Ed - +.Pp このコマンドは、キャリアが失われた時に .Ar timeout 秒待ってから .Ar ntries -回まで接続を再確立するよう ppp に指示します。たとえば、 +回まで接続を再確立するよう +.Nm +に指示します。例えば、 .Bd -literal -offset indent set reconnect 3 5 .Ed - +.Pp は、予期せぬキャリア喪失の際に .Ar 3 秒待ってから再接続を試みるように @@ -590,43 +604,42 @@ set reconnect 3 5 .Nm があきらめる前に .Ar 5 -回まで行なわれます。 +回まで行われます。 ntries のデフォルト値はゼロ (再接続しない) です。 このオプションを使用する際には注意が必要です。 もしローカル側のタイムアウトがリモート側よりもわずかに長いと、 リモート側がタイムアウトにより回線を切断した場合に、 再接続機能が (指定した回数まで) 起動されてしまいます。 - 注: この文脈においては、多くの LQR を喪失するとキャリア喪失を引き起こし、 ひいては再接続を引き起こします。 - .Fl background -フラグが指定された場合、接続が行なえるまで +フラグが指定された場合、接続が行えるまで すべての電話番号が最大一回ダイアルされます。 .Dq set redial -コマンドにて、リダイアル期間の後には、 +コマンドにて、リダイアル期間の後に、 再接続回数を指定します。 リダイアル値が指定した電話番号数より少ない場合、 指定した電話番号で使用されないものが出来ます。 - プログラムを終了させるには、以下のように入力してください。 - - PPP ON awfulhak> close - ppp ON awfulhak> quit all - +.Bd -literal -offset indent +PPP ON awfulhak> close +ppp ON awfulhak> quit all +.Ed .Pp .Dq quit -コマンドは telnet による接続を終了しますが、 +コマンドは +.Xr pppctl 8 +もしくは +.Xr telnet 1 +による接続を終了しますが、 プログラム自身は終了させません。 -プログラムも終了させたい場合には、 +.Nm +も終了させたい場合には、 .Dq quit all を実行してください。 - .Sh PPP 接続の受け入れ (方法その 1) - .Em PPP 接続要求を受け入れるには、以下の手順にしたがってください。 - .Bl -enum .It モデムと、 (必要であれば) @@ -634,124 +647,170 @@ ntries が正しく設定されていることを確認します。 .Bl -bullet -compact .It -フロー制御にはハードフロー (CTS/RTS) を使います。 +フロー制御にはハードウェアハンドシェイク (CTS/RTS) を使います。 .It -モデムはエコーバックを行なわず (ATE0) 、コマンドの結果も報告しない (ATQ1) +モデムはエコーバックを行わず (ATE0) 、コマンドの結果も報告しない (ATQ1) ように設定されていなければなりません。 .El - +.Pp .It -モデムが接続されているポートで getty が起動されるように +モデムが接続されているポートで +.Xr getty 8 +が起動されるように .Pa /etc/ttys を編集します。 - -たとえば、以下のように設定すれば良いでしょう。 - +例えば、以下のように設定すれば良いでしょう: .Dl ttyd1 "/usr/libexec/getty std.38400" dialup on secure - -getty を起動するために init プロセスに +.Xr getty 8 +を起動するために +.Xr init 8 +プロセスに .Dv HUP シグナルを送るのを 忘れないでください。 - .Dl # kill -HUP 1 - .It 接続するユーザのためのアカウントを用意します。 .Bd -literal ppp:xxxx:66:66:PPP Login User:/home/ppp:/usr/local/bin/ppplogin .Ed - +.Pp .It .Pa /usr/local/bin/ppplogin -ファイルを以下のような内容で作成します。 +ファイルを以下のような内容で作成します: .Bd -literal -offset indent #!/bin/sh -p exec /usr/sbin/ppp -direct .Ed - -(さらに制御を行なうためにラベル名を指定することもできます。) - .Pp -ダイレクトモード ( -.Fl direct ) +(さらに制御を行うためにラベル名を指定することもできます。) +.Pp +ダイレクトモード +.Pq Fl direct では、 .Nm は標準入力と標準出力を使って動作します。クライアント動作の .Nm と同様に、 -.Nm pppctl -を使用するか、3000 番 + 現在のトンネルデバイス番号のポートに -.Nm telnet -することでコマンドモードでの制御が可能です。 - +.Xr pppctl 8 +を使用するか設定済みの診断ポートに +.Xr telnet 8 +することで、コマンドモードでの制御が可能です。 .It -ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを調停する、 -マイクロソフトの IPCP 拡張のサポートを有効にするには、 +オプションでサポートされている +Microsoft の IPCP ネームサーバと NetBIOS ネームサーバの +交渉を有効にすることが可能です。 .Dq enable msext と .Dq set ns pri-addr [sec-addr] および .Dq set nbns pri-addr [sec-addr] -を ppp.conf ファイルに追加します。 - +を +.Pa /etc/ppp/ppp.conf +ファイルに追加します。 .El - +.Pp .Sh PPP 接続の受け入れ (方法その 2) - この方法は、モデムの接続を扱うのに .Em mgetty+sendfax を使用するようにすすめている点が異なります。 -最近のバージョン 0.99 では、 +最近のバージョン (0.99 以降) では、 .Dq AUTO_PPP オプションをつけてコンパイルすることで、クライアントが -ログインプロンプトに向かって PPP を話すのを検出することができます。 - +ログインプロンプトに向かって +.Em PPP +を話すのを検出することができます。 手順は以下の通りです: - .Bl -enum - .It AUTO_PPP オプションが使えるように、バージョン 0.99 か それ以降の mgetty+sendfax を入手、設定、インストールします。 - .It モデムが接続されているポートで mgetty が起動されるように .Pa /etc/ttys を編集します。 例えば、以下のように設定すれば良いでしょう: - .Dl cuaa1 "/usr/local/sbin/mgetty -s 57600" dialup on - .It 接続するユーザのためのアカウントを用意します。 .Bd -literal Pfred:xxxx:66:66:Fred's PPP:/home/ppp:/etc/ppp/ppp-dialup .Ed - +.Pp .It -以下のファイルをよく読んで、要点を理解してください。 -.Pa /etc/ppp/sample.ppp-dialup -.Pa /etc/ppp/sample.ppp-pap-dialup +ファイル +.Pa /etc/ppp/sample.ppp-dialup , +.Pa /etc/ppp/sample.ppp-pap-dialup , .Pa /etc/ppp/ppp.conf.sample -以下のようにすると ppp-pap-dialup が +をよく読んで、要点を理解してください。以下のようにすると +.Pa /etc/ppp/ppp-pap-dialup +が .Pa /usr/local/etc/mgetty+sendfax/login.conf から呼び出されます。 - .Dl /AutoPPP/ - - /etc/ppp/ppp-pap-dialup .El - +.Pp +.Sh 内向き接続の認証 +通常、接続の受信側は相手が相手自身を認証することを要求します。 +これは通常 +.Xr login 1 +にて行われますが、代りに PAP か CHAP を使用可能です。 +2 つのうちで CHAP の方がより安全ですが、 +クライアントによってはサポートしていないものがあります。 +どちらを使いたいか決めたら、 +.Sq enable chap +または +.Sq enable pap +を +.Pa ppp.conf +の適切なセクションに追加してください。 +.Pp +その後、 +.Pa /etc/ppp/ppp.secret +ファイルの設定を行う必要があります。 +このファイルは、クライアントになりうるマシンごとに 1 行を含みます。 +各行は 4 つまでのフィールドからなります: +.Bd -literal -offset indent +name key [hisaddr [label]] +.Ed +.Pp +.Ar name +と +.Ar key +は期待されるクライアントを指定します。 +.Pa ppp.secret +の如何なる +.Ar name No / Ar key +の組み合わせにおいても適切でない返答をクライアントが与える場合、 +認証は失敗します。 +.Pp +認証に成功したならば、 +.Pq 指定時には +.Ar hisaddr +を IP 番号交渉時に使用します。詳細は +.Dq set ifaddr +コマンドを参照してください。 +.Pp +認証に成功し +.Ar label +が指定された場合、現在のシステムラベルは +.Ar label +にマッチするように修正されます。 +このことはファイル +.Pa ppp.linkup +と +.Pa ppp.linkdown +の後続のパーズに影響があります。 .Sh PPP オーバ TCP (別名: トンネリング) - -シリアルリンク上以外の ppp の使用方法として、 +シリアルリンク上以外の +.Nm +の使用方法として、 ホストとポートを指定することにより、 -tcp 接続を使用することが可能です。 - +TCP 接続を使用することが可能です: .Dl set device ui-gate:6669 - シリアルデバイスをオープンする代りに、 .Nm -は指定されたマシンンの指定されたソケットへの tcp 接続をオープンします。 +は指定されたマシンの指定されたソケットへの TCP 接続をオープンします。 .Nm は telnet プロトコルを使用しないこと、 telnet サーバと交渉できないことに注意を払うべきです。 @@ -759,36 +818,32 @@ telnet この ppp 接続を受信するポートを設定する必要があります。まず .Pa /etc/services を更新して、サービスを定義します: - -.Dl ppp-in 6669/tcp # Incoming ppp connections over tcp - +.Dl ppp-in 6669/tcp # Incoming PPP connections over tcp そして .Pa /etc/inetd.conf -を更新して、このポートへの受信接続をどのように扱うかを inetd に指示します: - +を更新して、このポートへの受信接続をどのように扱うかを +.Xr inetd 8 +に指示します: .Dl ppp-in stream tcp nowait root /usr/sbin/ppp ppp -direct ppp-in - .Pa /etc/inetd.conf を更新した後には、 -.Nm inetd +.Xr inetd 8 に .Dv HUP シグナルを送るのをお忘れなく。 - ここではラベル名 .Dq ppp-in を使用します。 ui-gate (受信側) の .Pa /etc/ppp/ppp.conf エントリは以下を含みます: - .Bd -literal -offset indent ppp-in: set timeout 0 set ifaddr 10.0.4.1 10.0.4.2 - add 10.0.1.0 255.255.255.0 10.0.4.1 + add 10.0.1.0 255.255.255.0 10.0.4.2 .Ed - +.Pp セキュリティのために PAP もしくは CHAP の設定をしたいかもしれません。 PAP を有効にするには以下の行を追加します: .Bd -literal -offset indent @@ -805,7 +860,6 @@ MyAuthName MyAuthPasswd awfulhak (起動側) の .Pa /etc/ppp/ppp.conf エントリは以下を含む必要があります: - .Bd -literal -offset indent ui-gate: set escape 0xff @@ -814,7 +868,7 @@ ui-gate: set timeout 30 5 4 set log Phase Chat Connect Carrier hdlc LCP IPCP CCP tun set ifaddr 10.0.4.2 10.0.4.1 - add 10.0.2.0 255.255.255.0 10.0.4.2 + add 10.0.2.0 255.255.255.0 10.0.4.1 .Ed .Pp PAP を有効にしようとしている場合、以下の設定も必要です: @@ -822,76 +876,80 @@ PAP set authname MyAuthName set authkey MyAuthKey .Ed - +.Pp 我々は、 ui-gate に 10.0.4.1 のアドレスを割り当て、 awfulhak に 10.0.4.2 のアドレスを割り当てようとしています。 - 接続をオープンするためには、以下をタイプするだけで良いです。 - .Dl awfulhak # ppp -background ui-gate - 結果として、 awfulhak にはネットワーク 10.0.2.0/24 への新たな「ルート」が、 ui-gate にはネットワーク 10.0.1.0/24 への新たな「ルート」が、 -tcp 接続経由でそれぞれ作成されます。 - +TCP 接続経由でそれぞれ作成されます。 ネットワークは実質的にブリッジされます - -下にある tcp 接続はパブリックなネットワーク (例えばインターネット) を +下にある TCP 接続はパブリックなネットワーク (例えばインターネット) を またがっても良いです。 また 2 つのゲートウェイ間では ppp トラフィックは -概念的に tcp ストリーム中でカプセル化されます +概念的に TCP ストリーム中でカプセル化されます (パケットがパケットに対応するわけではありません)。 - この機構の大きな欠点は、同時に 2 つの「配送保証」機構が存在することです - -この 2 つとは、下の tcp ストリームと ppp リンク上で使用されるプロトコルであり、 -おそらくまた tcp でしょう。 -パケット喪失が起ると、両者はそれぞれの方法で喪失したパケットを再送しようと +この 2 つとは、下の TCP ストリームと +.Em PPP +リンク上で使用されるプロトコルであり、おそらくまた TCP でしょう。 +パケット喪失が起ると、両者はそれぞれの方法で喪失した +パケットを再送しようと するでしょう。 - .Sh パケットエイリアシング - .Fl alias -コマンドラインオプションにより、パケットエイリアシングが有効になります。 -これにより、ppp ホストがローカルエリアネットワークの他のコンピュータに対して +コマンドラインオプションにより、 +パケットエイリアシングが有効になります。 +これにより、 +.Nm +ホストがローカルエリアネットワークの他のコンピュータに対して マスカレードゲートウェイとして動作するようになります。 -送信される IP パケットは、まるで ppp ホストから来たかのようにエイリアスされ、 +送信される IP パケットは、まるで +.Nm +ホストから来たかのようにエイリアスされ、 受信パケットは、それがローカルエリアネットワークの正しいマシンに 送られるようにエイリアスが戻されます。 - パケットエイリアシングにより、 未登録でプライベートなサブネット上のコンピュータを 外部から見えないようにしつつ、 インターネットへアクセス可能とします。 - -一般に、ppp が正しく動作していることの確認は、 -まず最初にパケットエイリアシングを禁止して行ないます。 +一般に、 +.Nm +が正しく動作していることの確認は、 +まず最初にパケットエイリアシングを禁止して行います。 次に .Fl alias -オプションを有効にして、ppp ホストの上で (ウェブブラウザや telnet, ftp, ping, -traceroute などの) ネットワークアプリケーションの動作を確認します。 +オプションを有効にして、 +.Nm +ホストの上で (ウェブブラウザや +.Xr telnet 1 , +.Xr ftp 1 , +.Xr ping 8 , +.Xr traceroute 8 +などの) ネットワークアプリケーションの動作を確認します。 最後に、LAN 上の別のコンピュータの上で同様なアプリケーションの 動作を確認することになります。 - -ppp ホストではネットワークアプリケーションが正しく動作するのに、 +.Nm +ホストではネットワークアプリケーションが正しく動作するのに、 LAN 上の別のコンピュータでは動かないのであれば、マスカレードソフトウェアは 正しく動いているけれども、ホストが IP パケットをフォワーディングしないか、 ひょっとするとパケットが送られて来ていないかのどちらかです。 .Pa /etc/rc.conf で IP フォワーディングが有効にされていることと、 -他のコンピュータで ppp ホストがその LAN のゲートウェイとして +他のコンピュータで +.Nm +ホストがその LAN のゲートウェイとして 指定されていることを確認してください。 - .Sh パケットのフィルタリング - この実装では、パケットのフィルタリングがサポートされています。 -ifilter, ofilter, dfilter の 3 種類のフィルタがあります。 +ifilter, ofilter, dfilter, afilter の 4 種類のフィルタがあります。 ここでは基本的なことについて書くことにします。 - .Bl -bullet -compact .It フィルタ定義は以下のような構文になっています。 - set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] [proto [src [lt|eq|gt] port ]] [dst [lt|eq|gt] port] [estab] .Bl -enum @@ -918,48 +976,40 @@ set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] は数字で指定するか、 .Pa /etc/services のサービス名で指定することができます。 - .El - +.Pp .It 各フィルタは規則 0 から始まり、20 個までの規則をもつことができます。 規則の集合は、規則 0 が定義されていなければ、有効にはなりません。 すなわち、デフォルトでは全てが通されます。 - .It パケットにマッチする規則が無い場合は、パケットは破棄 (ブロック) されます。 - .It すべての規則を消去するには、 .Dq set filter-name -1 を使ってください。 - .El - +.Pp .Pa /etc/ppp/ppp.conf.filter.example を参照してください。 - - .Sh アイドルタイマ、回線品質要求タイマ、リトライタイマの設定 - アイドルタイマを調べたり/設定するためには、それぞれ .Dq show timeout と .Dq set timeout [lqrtimer [retrytimer]] コマンドを使ってください: - .Bd -literal -offset indent ppp ON awfulhak> set timeout 600 .Ed - +.Pp タイムアウト時間は秒数で指定します。デフォルト値は timeout が 180 秒 (3 分)、lprtimer が 30 秒、 retrytimer が 3 秒です。 アイドルタイマ機能を使わないようにするためには、 +次のコマンドを利用してください。 .Bd -literal -offset indent ppp ON awfulhak> set timeout 0 .Ed -コマンドを利用してください。 - +.Pp .Fl auto モードでは、アイドルタイムアウトが発生すると .Nm @@ -967,26 +1017,32 @@ ppp ON awfulhak> set timeout 0 .Em PPP セッションを終了します。別の引金となるパケットがきた時に リンクを再び確立しようとします。 - -.Sh Predictor-1 圧縮 - -このバージョンでは、現在の IETF ドラフトに基づいた CCP および Predictor type 1 -圧縮をサポートしています。 +.Sh Predictor-1 および DEFLATE 圧縮 +このバージョンでは、 +現在の IETF ドラフトに基づき、CCP および Predictor type 1 圧縮 +もしくは deflate 圧縮をサポートしています。 デフォルトの動作として、 .Nm -は、接続相手が同意 (あるいは要求) した場合に、 +は、接続相手が同意 +.Pq あるいは要求 +した場合に、 この機能を使おうと (もしくは受け入れようと) します。 - -完全に CCP/predictor 機能を停止するためには、 -.Dq disable pred1 -と -.Dq deny pred1 -コマンドを使ってください。 - -.Sh IP アドレスの制御 - .Nm -は IP アドレスの調停のために IPCP を使います。接続の両側は、自分が +は deflate プロトコルを優先します。 +これらの機能を使用したくない時には +.Dq disable +と +.Dq deny +のコマンドを参照してください。 +.Pp +.Dq disable deflate +か +.Dq deny deflate +の一方を使用することにより、 +方向ごとに異ったアルゴリズムを使用することができます。 +.Sh IP アドレスの制御 +.Nm +は IP アドレスの交渉のために IPCP を使います。接続の両側は、自分が 使おうとするアドレスを提示し、要求された IP アドレスが受け入れ可能な ものであれば、相手に ACK (肯定応答) を返します。 受け入れることができなければ、別の IP アドレスの使用を促すために @@ -994,16 +1050,14 @@ ppp ON awfulhak> set timeout 0 は相手に NAK (否定応答) を返します。 接続の両側が受け取った要求に同意し (ACK を送っ) た時、 IPCP はオープン状態にセットされ、ネットワーク層での接続が確立されます。 - IPCP の動作を制御するために、この実装はローカルとリモートの IP アドレスを定義するための .Dq set ifaddr コマンドを持っています。 - .Bd -literal -offset indent set ifaddr [src_addr [dst_addr [netmask [trigger_addr]]]] .Ed - +.Pp ここで、 .Sq src_addr はローカル側で使おうと思っている IP アドレスで、 @@ -1021,85 +1075,77 @@ set ifaddr [src_addr [dst_addr [netmask [trigger_addr]]]] に適したマスク値です。 .Sq netmask は小さくすることのみ可能です。便利な値は 255.255.255.255 でしょう。 -誤った ppp の実装には、接続ネゴシエーションのために、 +誤った +.Em PPP +の実装には、接続交渉のために、 .Sq src_addr ではなく特別な IP アドレスを使用しなければならないものがあります。 この場合、 -.Sq trg_addr +.Sq trigger_addr で指定した IP アドレスが使用されます。 相手がこの提案された番号に同意しない限り、 ルーティングテーブルには影響しません。 - .Bd -literal -offset indent set ifaddr 192.244.177.38 192.244.177.2 255.255.255.255 0.0.0.0 .Ed - -上の例は、 +.Pp +上の例の意味は次の通りです: .Bl -bullet -compact .It 自分の IP アドレスとしてまず 0.0.0.0 を提案しますが、 アドレス 192.244.177.38 のみは受け付けます。 - .It 相手側のアドレスとして 192.244.177.2 を使うように要求し， 192.244.177.2 以外のどんなアドレスを使うことも許可しません。 相手側が別の IP アドレスを要求してきた時は、いつでも 192.244.177.2 を提案します。 - .It ルーティングテーブルのネットマスク値は 0xffffffff に設定されます。 .El - +.Pp これは、両側が既に決まった IP アドレスを持っている場合には うまくいきますが、多くの場合、一方がすべての IP アドレスを制御する サーバとして動作しており、もう一方はその方針に従わなくてはなりません。 - より柔軟な動作をさせるために、`ifaddr' 変数の IP アドレス指定を もっと緩やかにすることが可能です: - +.Pp .Dl set ifaddr 192.244.177.38/24 192.244.177.2/20 - +.Pp スラッシュ (/) に続く数字は、この IP アドレスで意味のあるビットの数を 表現しています。上の例は以下のことを示しています。 - .Bl -bullet -compact .It 可能なら自分のアドレスとして 192.244.177.38 を使おうとしますが、 192.244.177.0 から 192.244.177.255 の間の任意の IP アドレスも受け入れます。 - .It 相手のアドレスとして 192.244.177.2 を使うことを希望しますが、 192.244.176.0 から 192.244.191.255 の間の任意の IP アドレスも許可します。 - .It すでにお気づきと思いますが、 192.244.177.2 は 192.244.177.2/32 と書くことと 等価です。 - .It 例外として、0 は 0.0.0.0/0 と等価であり、希望する IP アドレスは 特に無く、リモート接続先の選択に従うことを意味します。 0 を使用した場合は、接続が確立するまで、ルーティングテーブルエントリは まったく設定されません。 - .It 192.244.177.2/0 は、どんな IP アドレスでも受け入れる/許可することを 意味しますが、最初に 192.244.177.2 を使うように提案します。 .El - +.Pp .Sh インターネットサービスプロバイダと接続する - -プロバイダに接続する際には、以下のステップを踏む必要があるでしょう。 - +プロバイダに接続する際には、以下のステップを踏む必要があるでしょう: .Bl -enum .It .Dq set phone コマンドを使って、ダイアルスクリプトにプロバイダの電話番号を記述します。 ダイアルやリダイアルに使用する電話番号は、 パイプ (|) またはコロン (:) で区切って -複数指定することができます。たとえば、以下のようになります。 +複数指定することができます。例えば、以下のようになります。 .Bd -literal -offset indent set phone "111[|222]...[:333[|444]...]... .Ed +.Pp 最初のパイプで区切られたリストの番号は、 直前の番号でダイアルもしくはログインスクリプトが失敗した場合のみ使用されます。 コロンで区切られた番号は、直前の番号の使用によりなにが起ったのかにかかわらず、 @@ -1122,25 +1168,22 @@ set phone "1234567|2345678:3456789|4567890" リストが終了すると、 通常のリダイアル期間だけ待ち、 最初から再開します。 - .Dq set dial コマンドの \\\\T 文字列は選択された番号で置きかえられます。 (以下を参照してください)。 - .It リダイアルに関する設定は、 .Dq set redial -で行ないます。 -たとえば回線の調子が悪かったり、 (最近では +で行います。 +例えば回線の調子が悪かったり、 (最近では それほど多くないでしょうが) プロバイダがいつも話中だったりすると、 -以下のように設定したくなるかもしれません。 +以下のように設定したくなるかもしれません: .Bd -literal -offset indent set redial 10 4 .Ed .Pp -これは最初の番号にリダイアルを行なう前に 10 秒待って、 +これは最初の番号にリダイアルを行う前に 10 秒待って、 4 回までダイアルしてみるという意味になります。 - .It .Dq set dial と @@ -1148,73 +1191,84 @@ set redial 10 4 コマンドを使ってログイン手続きを記述します。 .Dq set dial コマンドはモデムと通信してプロバイダへのリンクを確立するのに使われます。 -たとえば、以下のようになります。 +例えば、以下のようになります: .Bd -literal -offset indent -set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT" +set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" \e + ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT" .Ed .Pp このモデム「チャット」文字列の意味は以下の通りです。 - .Bl -bullet .It "BUSY" または "NO CARRIER" を受信した場合には処理を中止します。 .It タイムアウトを 4 秒にセットします。 .It -文字列の受信待ちは行ないません。 +文字列の受信待ちは行いません。 .It ATZ を送信します。 .It -OK の受信待ちを行ないます。もし受信できなければ、 -もう一度 ATZ を送信し、OK の受信待ちを行ないます。 +OK の受信待ちを行います。もし 4 秒以内に受信できなければ、 +もう一度 ATZ を送信し、OK の受信待ちを行います。 .It ATDTxxxxxxx を送信します。xxxxxxx は 上の電話番号リストの中の、次にダイアルする番号です。 .It タイムアウトを 60 にセットします。 .It -文字列 CONNECT の受信待ちを行ないます。 +文字列 CONNECT の受信待ちを行います。 .El - +.Pp 一旦接続が確立されると、ログインスクリプトが実行されます。 -このスクリプトはダイアルスクリプトと同じスタイルで書かれます。 +このスクリプトはダイアルスクリプトと同じスタイルで書かれますが、 +パスワードがログされないように注意してください: .Bd -literal -offset indent -set login "TIMEOUT 15 login:-\\\\r-login: awfulhak word: xxx ocol: PPP HELLO" +set authkey MySecret +set login "TIMEOUT 15 login:-\\\\r-login: awfulhak \e + word: \\\\P ocol: PPP HELLO" .Ed .Pp このログイン「チャット」文字列の意味は以下の通りです。 - .Bl -bullet .It タイムアウトを 15 秒にセットします。 .It -"login:" の受信待ちを行ないます。もし受信できなければ -改行文字を送信して、再び "login:" の受信待ちを行ないます。 +"login:" の受信待ちを行います。もし受信できなければ +復改文字を送信して、再び "login:" の受信待ちを行います。 .It "awfulhak" を送信します。 .It -"word:" ("Password:" プロンプトの末尾) の受信待ちを行ないます。 +"word:" ("Password:" プロンプトの末尾) の受信待ちを行います。 .It -"xxx" を送信します。 +.Ar authkey +に現在設定されている値を送信します。 .It -"ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行ないます。 +"ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行います。 .It "PPP" を送信します。 .It -"HELLO" の受信待ちを行ないます。 +"HELLO" の受信待ちを行います。 .El .Pp +.Dq set authkey +( +.Ar command +ログ使用時には) コマンドのログは特別な方法でとられ、( +.Sq ******** +とログされますので) 実際のパスワードが危険にさらされることはありません。 +.Ar chat +ログ使用時には、実際のパスワードの代りに '\\P' とログされます。 +.Pp ログインスクリプトはプロバイダによって大きく違うものになるでしょう。 - .It シリアル回線と通信速度を指定するためには .Dq set line と .Dq set speed -を使います。たとえば以下のようになります。 +を使います。例えば以下のようになります。 .Bd -literal -offset indent set line /dev/cuaa0 -set sp 115200 +set speed 115200 .Ed .Pp FreeBSD では cuaa0 が一つめのシリアルポートになります。 @@ -1224,7 +1278,6 @@ OpenBSD あなたのモデムが 28800 かそれ以上のビットレートで通信することが できるなら、シリアルポートの速度には 115200 を指定しておくべきでしょう。 一般に、シリアルポートの速度はモデムの速度の約 4 倍にしておきます。 - .It .Dq set ifaddr コマンドで IP アドレスを定義します。 @@ -1259,18 +1312,18 @@ ISP .Bd -literal -offset indent set ifaddr 10.10.10.10/0 10.10.11.11/0 0.0.0.0 0.0.0.0 .Ed - +.Pp .It ほとんどの場合、プロバイダはデフォルトルータでもあるでしょう。 -この場合、以下の行を -.Pa ppp.conf +この場合で +.Fl auto +モード使用時には、以下の行を +.Pa /etc/ppp/ppp.conf に追加します。 - .Bd -literal -offset indent delete ALL -add 0 0 HISADDR +add default HISADDR .Ed - .Pp これは、 .Nm @@ -1279,37 +1332,44 @@ add 0 0 HISADDR それから 10.10.11.11 をデフォルトルートとして追加するよう .Nm に指示します。 +.Fl auto +モードを使用していない時にはこれは必要ありません。 +なぜなら、 +.Nm +がすぐにダイアルして新しい IP 番号を相手と交渉できるからです。 .Pp -もし動的 IP アドレスを使うのであれば、以下の 2 行を -.Pa ppp.linkup +.Fl auto +モードを使用していないとき、もしくは動的 IP 番号を使用するときには、 +次の 2 行を +.Pa /etc/ppp/ppp.linkup ファイルに追加しておかなければなりません: - .Bd -literal -offset indent delete ALL -add 0 0 HISADDR +add default HISADDR .Ed - +.Pp HISADDR は「相手」の IP 番号を意味するマクロです。 -使用する IP 番号に関して、 -(IPCP を使用して) 合意されて始めて、使用可能です。 +使用する IP 番号に関して (IPCP を使用して) 合意 +もしくは ( +.Dq set ifaddr +を使用して) 設定してはじめて、使用可能です。 一旦接続が確立されると、 .Nm は直接ではないインタフェースのルートを全て削除し、 -デフォルトルートが相手の IP 番号を差すように設定します。 -.Pa ppp.conf +デフォルトルートが相手の IP 番号を指すように設定します。 +.Pa /etc/ppp/ppp.conf で使ったのと同じラベルを使用してください。 .Pp もしコマンドを対話的に入力しているのであれば、接続に成功した後で .Bd -literal -offset indent -add 0 0 HISADDR +add default HISADDR .Ed .Pp とタイプするだけで充分です。 - .It プロバイダが PAP/CHAP による認証を要求している場合は、 -.Pa ppp.conf -ファイルに以下の行を追加してください。 +.Pa /etc/ppp/ppp.conf +ファイルに以下の行を追加してください: .Bd -literal -offset indent set authname MyName set authkey MyPassword @@ -1317,21 +1377,18 @@ set authkey MyPassword .Pp デフォルトではどちらも受け付けられますので、ISP が何を要求しても大丈夫です。 .El - +.Pp 現実の例を見たい場合には、 .Pa /etc/ppp/ppp.conf.sample と .Pa /etc/ppp/ppp.linkup.sample を参照してください。 ラベル pmdemand は、ほとんどのプロバイダで使用できるでしょう。 - .Sh ログ機能 - .Nm -は以下のログ情報を +は以下のログ情報を、 .Xr syslog 3 -経由で出力することができます。 - +経由で、もしくはスクリーンに出力することができます: .Bl -column SMMMMMM -offset indent .It Li Async 非同期レベルパケットの 16 進ダンプ .It Li Carrier 'CARRIER' まで含めたチャットログの生成 @@ -1341,6 +1398,7 @@ set authkey MyPassword .It Li Connect 完全なチャットログの生成 .It Li Debug (非常に長い)デバッグ情報のログ .It Li HDLC HDLC パケットの 16 進ダンプ +.It Li ID0 ユーザ ID 0 で実行された全関数呼び出しを詳細に記録 .It Li IPCP IPCP パケットトレースの生成 .It Li LCP LCP パケットトレースの生成 .It Li Link アドレスの割当およびリンクの確立、解放イベントのログ @@ -1352,35 +1410,48 @@ set authkey MyPassword .It Li Error ターミナルデバイスとログファイルへの出力で、LOG_ERROR を使用します。 .It Li Alert ログファイルへの出力で、LOG_ALERT を使用します。 .El - +.Pp .Dq set log コマンドで、ログの出力レベルを設定することができます。 -また、複数のレベルを指定することも可能です。 +また、複数のレベルを単一コマンドラインにて指定することも可能です。 デフォルトは、 .Dq set log Carrier Link Phase です。 - +.Pp +スクリーンに直接ログを表示することも可能です。 +文法は同じで、語 +.Dq local +が .Dq set log +の直後に付くことだけが違います。 +デフォルトは +.Dq set log local +(つまり、直接スクリーンにログ表示) です。 +.Pp +.Dq set log Op local への最初の引数が '+' か '-' の文字で始まる場合、 現在のログレベルを消去せずに修正します。例えば: - .Bd -literal -offset indent +PPP ON awfulhak> set log carrier link phase PPP ON awfulhak> show log -Log: Carrier Link Phase -PPP ON awfulhak> set log -Link +tcp/ip +Log: Carrier Link Phase Warning Error Alert +Local: Warning Error Alert +PPP ON awfulhak> set log -link +tcp/ip -warning +PPP ON awfulhak> set log local +command PPP ON awfulhak> show log -Log: Carrier Phase TCP/IP +Log: Carrier Phase TCP/IP Warning Error Alert +Local: Command Warning Error Alert .Ed - +.Pp レベル Warning, Error, Alert のメッセージログは -.Dq set log +.Dq set log Op local では制御できません。 - +.Pp +.Ar Warning +レベルは特別で、ローカルに表示可能な場合にはログされません。 .Sh シグナルハンドリング - -.Nm ppp +.Nm は以下のシグナルを扱います: - .Bl -tag -width 20 .It INT このシグナルを受信すると、現在の接続がもしあればそれを終了します。 @@ -1390,27 +1461,32 @@ Log: Carrier Phase TCP/IP のモードではない場合、 .Nm は終了します。 - .It HUP, TERM, QUIT .Nm を終了させます。 - .It USR1 対話モードではない場合、 .Nm にサーバソケットが存在する場合にはそれらをクローズさせ、 -デフォルトのポート番号選択規則で選んだインターネットソケットを -オープンさせます - このポートは 3000 + トンネルデバイス番号です。 - +3000 + トンネルデバイス番号のインターネットソケットを +オープンさせます。 +これは、適切なローカルパスワードが +.Pa /etc/ppp/ppp.secret +に指定されている場合にのみ行われます。 +.It USR2 +.Nm +に全サーバソケットをクローズさせます。 .El - +.Pp .Sh PPP コマンドリスト - この節では利用可能コマンドとその効果をリストします。 -ppp セッションで対話的に使用することも、 -コンフィギュレーションファイルで指定することも、 -telnet セッションで指定することも可能です。 - +.Nm ppp +セッションで対話的に使用することも、 +設定ファイルで指定することも、 +.Xr pppctl 8 +もしくは +.Xr telnet 1 +セッションで指定することも可能です。 .Bl -tag -width 20 .It accept|deny|enable|disable option.... これらのディレクティブは @@ -1418,7 +1494,7 @@ telnet .Nm に指示します。各 .Dq option -には、accept/deny および enable/disable のデフォルトを持ちます。 +は、accept/deny および enable/disable のデフォルトを持ちます。 .Dq accept は相手がこのオプションを要求したら、ACK を送ることを意味します。 .Dq deny @@ -1430,39 +1506,31 @@ telnet .Pp .Dq option は以下のいずれかです: - .Bl -tag -width 20 -.It vjcomp +.It acfcomp デフォルト: enable かつ accept。 -このオプションは Van Jacobson ヘッダ圧縮を使用するかどうかを決定します。 - -.It lqr -デフォルト: disable かつ accept。 -このオプションはリンク品質要求 (Link Quality Request) を送信するかどうかを -決定します。 -LQR は、モデムのキャリア検出を使用せずに、リンクダウンを -.Nm -に決定させるプロトコルです。 - +ACFComp はアドレスおよびコントロールフィールド圧縮 +(Address and Control Field Compression) を意味します。 +LCP パケット以外は非常に良く似たフィールトを持ちますので、 +簡単に圧縮可能です。 .It chap デフォルト: disable かつ accept。 -CHAP はチャレンジ交換承認プロトコル +CHAP はチャレンジ交換認証プロトコル (Challenge Handshake Authentication Protocol) を意味します。 CHAP もしくは PAP (後述) のどちらか一方のみ交渉可能です。 -CHAP では、承認者は「チャレンジ」メッセージを相手に送ります。 +CHAP では、認証者は「チャレンジ」メッセージを相手に送ります。 相手は一方向ハッシュ関数を使用して「チャレンジ」を暗号化し、 結果を送り返します。 -承認者は同じことを行い結果を比較します。 +認証者は同じことを行い結果を比較します。 この機構の利点は、接続を介してパスワードを送らないことです。 - 接続が最初に確立する時にチャレンジが行われます。 更なるチャレンジが行われるかもしれません。 -相手の承認を行いたい場合は、 +相手の認証を行いたい場合は、 .Dq enable chap を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に書き、相手のエントリを -.Pa ppp.secret +.Pa /etc/ppp/ppp.secret に書く必要があります。 .Pp クライアントとして CHAP を使用する場合、 @@ -1470,26 +1538,78 @@ CHAP と .Dq AuthKey を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に指定するだけで良いです。 CHAP はデフォルトで accept されます。 - +.Em PPP +の実装によっては、チャレンジの暗号化に +MD5 ではなく "MS-CHAP" を使用するものがあります。 +詳細については +.Dq set encrypt +コマンドの記述を参照してください。 +.It deflate +デフォルト: enable かつ accept。 +このオプションは圧縮制御プロトコル (Compression Control Protocol; CCP) に +deflate 圧縮を使用するか否かを決定します。 +使用されるアルゴリズムは +.Xr gzip 1 +プログラムが使用するものと同じです。 +注: +.Xr pppd 8 +- 多くのオペレーティングシステムで使用可能な +.Em PPP +の実装 - との +.Ar deflate +能力についてのネゴシエーションには問題があります +.Nm pppd +(バージョン 2.3.1) が +.Ar deflate +圧縮の交渉を行おうとする CCP コンフィギュレーションタイプは、 +.Pa rfc1979 +に規定されたタイプ +.Em 26 +ではなくタイプ +.Em 24 +であり、誤っています。 +タイプ +.Ar 24 +は実際には +.Pa rfc1975 +では +.Dq PPP Magnalink Variable Resource Compression +と指定されています! +.Nm +は +.Nm pppd +と交渉する能力がありますが、 +.Dq pppd-deflate +が +.Ar enable +かつ +.Ar accept +されている場合のみです。 +.It lqr +デフォルト: disable かつ accept。 +このオプションはリンク品質要求 (Link Quality Request) を送信するかどうかを +決定します。 +LQR は、モデムのキャリア検出を使用せずに、リンクダウンを +.Nm +に決定させるプロトコルです。 .It pap デフォルト: disable かつ accept。 -PAP はパスワード承認プロトコル (Password Authentication Protocol) を +PAP はパスワード認証プロトコル (Password Authentication Protocol) を 意味します。 CHAP (前述) もしくは PAP のどちらか一方のみ交渉可能です。 PAP では、ID とパスワードが相手に送られ続け、 -承認されるか接続が終了されるかまでこれが続きます。 +認証されるか接続が終了されるかまでこれが続きます。 これは比較的良くないセキュリティ機構です。 接続が最初に確立した時のみ実行可能です。 - -相手の承認を行いたい場合は、 +相手の認証を行いたい場合は、 .Dq enable pap を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に書き、相手のエントリを -.Pa ppp.secret +.Pa /etc/ppp.secret に書く必要があります (ただし、後述の .Dq passwdauth オプションを参照)。 @@ -1499,81 +1619,278 @@ PAP と .Dq AuthKey を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に指定するだけで良いです。 PAP はデフォルトで accept されます。 - -.It acfcomp +.It pppd-deflate +デフォルト: disable かつ deny。 +.Ar deflate +オプションのバリエーションで、 +.Xr pppd 8 +プログラムとの交渉を許可します。 +詳細は、上述の +.Ar deflate +部分を参照してください。デフォルトでは抑止されますので、 +.Pa rfc1975 +に従っていないことになります。 +.It pred1 デフォルト: enable かつ accept。 -ACFComp はアドレスおよびコントロールフィールド圧縮 -(Address and Control Field Compression) を意味します。 -LCP パケット以外は非常に良く似たフィールトを持ちますので、 -簡単に圧縮可能です。 - +このオプションは圧縮制御プロトコル (Compression Control Protocol; CCP) に +Predictor 1 圧縮を使用するかどうかを決定します。 .It protocomp デフォルト: enable かつ accept。 このオプションは PFC (プロトコルフィールド圧縮) の交渉を行うために使用されます。 この機構により、 プロトコルフィールドが 2 オクテッドから 1 オクテッドに減ります。 - -.It pred1 +.It vjcomp デフォルト: enable かつ accept。 -このオプションは Predictor 1 圧縮を使用するかどうかを決定します。 - -.It msext -デフォルト: disable。 -このオプションは Microsoft の ppp 拡張を使用を許可します。 -これにより、Microsoft PPP DNS と Microsoft NetBIOS NS をサポートします。 -このオプションを有効にすることにより、"set ns" と "set nbns" で -与えられる値を渡せるようになります。 - +このオプションは Van Jacobson ヘッダ圧縮を使用するかどうかを決定します。 .El +.Pp 以下のオプションは、実際には相手と交渉しません。 それゆえ accept および deny は意味を持ちません。 - .Bl -tag -width 20 +.It msext +デフォルト: disable。 +このオプションは Microsoft の +.Em PPP +拡張の使用を許可します。 +これにより、DNS と NetBIOS NS の交渉をサポートします。 +このオプションを有効にすることにより、"set ns" と "set nbns" で +与えられる値を渡せるようになります。 +.It passwdauth +デフォルト: disable。 +このオプションを指定することにより、 +PAP 認証コードが呼び出し側を認証する時に、 +.Pa /etc/ppp/ppp.secret +ファイルではなくパスワードファイル ( +.Xr passwd 5 +参照) を使用させます。 .It proxy デフォルト: disable。 このオプションを指定することにより、 .Nm -に相手へのプロクシ ARP をさせます。 - -.It passwdauth +に相手のためにプロクシ ARP をさせます。 +.It throughput デフォルト: disable。 -このオプションを指定することにより、 -PAP 承認コードが呼び出し側を承認する時に、 -.Pa ppp.secret -ファイルではなく -.Pa passwd -ファイルを使用させます。 - +このオプションを有効にすると、 +.Nm +はスループット統計を収集します。 +ずれ動く 5 秒間のウィンドウにおいて入出力が検査され、 +現在、最良、総計の数値が保持されます。 +このデータは関連する +.Em PPP +層が終了するときに出力され、また +.Dq show +コマンドで表示することで得られます。スループット統計は +.Dq IPCP +と +.Dq modem +のレベルで利用可能です。 .It utmp デフォルト: enable。 -通常ユーザが PAP もしくは CHAP で承認された時で、 +通常ユーザが PAP もしくは CHAP で認証された時で、 .Nm が .Fl direct モードで実行されている時は、このユーザのエントリが utmp ファイルおよび wtmp ファイルに作成されます。 -このオプションを disable すると、utmp および wtmp のエントリは作成されません。 +このオプションを disable すると、 +.Nm +は utmp および wtmp のエントリを作成しません。 通常、 -ユーザがログインしかつ承認することを要求する場合のみ必要です。 - +ユーザがログインしかつ認証することを要求する場合のみ必要です。 .El - -.It add dest mask gateway -.Dq dest +.It add[!] dest mask gateway +.Ar dest は宛先 IP アドレスであり、 -.Dq mask +.Ar mask はそのマスクです。 -.Dq 0 0 +.Ar 0 0 はデフォルトルートを意味します。 -.Dq gateway +.Ar dest +および +.Ar mask +の引数の場所で、シンボル名 +.Sq default +を使用可能です。 +.Ar gateway は、 -.Dq dest +.Ar dest マシン/ネットワークに至る、次のホップのゲートウェイです。 - +宛先にシンボル名 +.Sq MYADDR +と +.Sq HISADDR +を使用可能であり、 +.Ar gateway +には +.Sq HISADDR +もしくは +.Sq INTERFACE +を使用可能です。 +.Sq MYADDR +はインタフェースアドレスに置き換えられ、 +.Sq HISADDR +はインタフェースの宛先アドレスに置き換えられ、 +.Sq INTERFACE +は現在のインタフェース名に置き換えられます。 +インタフェースの宛先アドレスが ( +.Dq set ifaddr +によって) 割当てられていない場合、現在の +.Sq INTERFACE +が +.Sq HISADDR +の代りに使用されます。 +.Pp +このコマンドを +.Pa ppp.conf +ファイルで使用するときの制限についての詳細は、後述の +.Dq set ifaddr +コマンドを参照してください。 +.Pp +.Ar add! +コマンド ( +.Dq \&! +に注意) 使用時には、 +ルートが存在する場合には +.Sq route change +コマンド (詳細は +.Xr route 8 +参照) にてルートを更新します。 +.It allow ..... +このコマンドは +.Nm +と設定ファイルへのアクセスを制御します。 +ユーザレベルでのアクセスは可能であり、 +設定ファイルのラベルと +.Nm +の実行モードに依存します。 +例えば、ユーザ +.Sq fred +のみがラベル +.Sq fredlabel +に +.Fl background +モードでアクセスできるように、 +.Nm +を構成したいかもしれません。 +.Pp +ユーザ ID 0 はこれらのコマンドの対象外です。 +.Bl -tag -width 20 +.It allow user|users logname... +デフォルトでは、ユーザ ID 0 のみがアクセスを許されています。 +このコマンドが指定されると、 +.Dq allow users +が記載されている個所に列挙されているユーザのアクセスが可能となります。 +.Sq default +セクションは +常に最初にチェックされます (スタートアップ時に常にロードされる唯一の +セクションです)。後続する +.Dq allow users +コマンドは、先行するコマンドに優先します。 +あるラベル以外のすべてにアクセスを許すことが可能であり、 +そのためにはデフォルトユーザを +.Sq default +セクションで指定し、新しいユーザリストをこのあるラベルに指定します。 +.Pp +ユーザ +.Sq * +が指定されると、全ユーザにアクセスが許されます。 +.It allow mode|modes modelist... +デフォルトでは全 +.Nm +モードが使用可能です。 +このコマンドが使用されると、 +このコマンドが指定されたラベルのロードに許されるアクセスモードが制限されます。 +.Dq allow users +コマンドと同様、 +各 +.Dq allow modes +コマンドは先行するコマンドに優先し、 +.Sq default +セクションは常に最初にチェックされます。 +.Pp +使用可能なモードは以下の通りです: +.Sq interactive , +.Sq auto , +.Sq direct , +.Sq dedicated , +.Sq ddial , +.Sq background , +.Sq * . +.El +.Pp +.It alias ..... +このコマンドは +.Nm +組込みのエイリアシング (マスカレーディング) 機能を +制御するために使用します。 +このコードが必要となるまで、 +.Nm +はこのコードをロードしません。 +エイリアスライブラリがあなたのシステムにインストールされないことも +大いにありえます +(エイリアスライブラリがセキュリティ的に危険だと認識する管理者もいます)。 +あなたのシステムでエイリアシングが有効になると、 +以下のコマンドが使用可能となります: +.Bl -tag -width 20 +.It alias enable [yes|no] +エイリアシングを有効もしくは無効にします。 +.Fl alias +コマンドラインフラグは +.Dq alias enable yes +と同じ意味です。 +.It alias port [proto targetIP:targetPORT [aliasIP:]aliasPORT] +このコマンドにより、 +マシン [aliasIP] の +.Dq aliasPORT +へ到着する接続を、 +.Dq targetIP +の +.Dq targetPORT +へリダイレクトします。 +proto を指定した場合、指定したプロトコルの接続のみマッチします。 +あなたのゲートウェイの後のマシンでインターネット電話等を実行したい場合に、 +このオプションは有用です。 +.It alias addr [addr_local addr_alias] +このコマンドにより、 +.Dq addr_alias +へのデータを +.Dq addr_local +へリダイレクトします。 +あなたのゲートウェイの後で +少数の実 IP アドレスを持ち、 +これらをあなたのゲートウェイの後の特定のマシンにマップしたい場合に有用です。 +.It alias deny_incoming [yes|no] +yes に設定した場合、ファイアウォールがパケットを落すのと同様に、 +全ての入力の接続を拒否します。 +.It alias log [yes|no] +このオプションを指定することにより、 +種々のエイリアシングの統計と情報を、ファイル +.Pa /var/log/alias.log +にログします。 +.It alias same_ports [yes|no] +有効になると、 +エイリアスライブラリが出力パケットのポート番号を変更しようとすることを +止めさせます。 +RPC や LPD といった、 +ウェルノウンポート (well known port) からの接続を要求する +プロトコルをサポートするのに有用です。 +.It alias use_sockets [yes|no] +有効になると、 +エイリアスライブラリにソケットを作成させ、 +正しい ftp データ入力や IRC 接続を保証できるようになります。 +.It alias unregistered_only [yes|no] +出力パケットを、登録されていない送信元アドレスに変更することだけを行います。 +RFC1918 に依ると、登録されていない送信元アドレスは +10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 です。 +.It alias help|? +このコマンドにより、 +使用可能なエイリアスコマンドのまとめを表示します。 +.El +.Pp .It [!]bg command 指定したコマンドをバックグラウンドで実行します。 擬似引数 @@ -1586,27 +1903,30 @@ utmp を停止させたい場合は、 .Dv shell コマンドを使用してください。 - .It close 現在の接続をクローズします (が終了しません)。 - -.It delete ALL | dest [gateway [mask]] -.Dq ALL +.It delete[!] dest +このコマンドは指定した +.Ar dest +IP アドレスのルートを削除します。 +.Ar dest +に +.Sq ALL が指定された場合、 .Nm が使用中のインタフェースの非直接エントリが全て削除されます。 tunX のエントリで実際のリンク以外を削除することを意味します。 -.Dq ALL -を使用しない場合、宛先 -.Dq dest -、宛先ネットワーク -.Dq mask -.Dq gateway -へのルートが削除されます。 -デフォルトの -.Dq mask -の値は 0.0.0.0 です - +.Ar dest +に +.Sq default +が指定された場合、デフォルトルートが削除されます。 +.Pp +.Ar delete! +コマンドが使用された場合 (最後の +.Dq \&! +に注意)、存在しないルートについて +.Nm +は文句を言わなくなります. .It dial|call [remote] .Dq remote が指定されている場合、 @@ -1617,17 +1937,18 @@ tunX .Dq login スクリプトを使用して確立されます。 そうでない場合、現在の設定が使用されて接続が確立されます。 - .It display 上述 .Dq accept|deny|enable|disable option.... で指定された、交渉可能な値の現在の状態を表示します。 - -.It passwd pass -全ての -.Nm -コマンドセットにアクセスするために要求されるパスワードを指定します。 - +.It down +リンクを切断しますが、 +綺麗な方法ではなく、物理層が使用不能になったように見えます。 +このコマンドを使用することは丁寧ではないとされています。 +.It help|? [command] +利用可能なコマンドをリストします。 +.Dq command +を指定した場合、このコマンドの使用方法を表示します。 .It load [remote] 指定された .Dq remote @@ -1636,22 +1957,54 @@ tunX が指定されない場合、 .Dq default ラベルが仮定されます。 - +.It passwd pass +全ての +.Nm +コマンドセットにアクセスするために要求されるパスワードを指定します。 +このパスワードは診断ポート ( +.Dq set server +コマンド参照) に接続するときに必要です。 +.Ar pass +の指定は、 +.Dq set server +コマンドラインもしくは +ローカルホストの +.Pa /var/log/ppp.secret +エントリにて可能です。 +.Ar command +ログが有効でも、値 +.Ar pass +はログされず、文字列 +.Dq ******** +がログされます。 +.It quit|bye [all] +.Nm +を終了します。 +.Nm +が対話モードであるか +.Dq all +引数が指定された場合、 +.Nm +は終了し、接続をクローズします。 +単に +.Dq quit +を +.Xr pppctl 8 +もしくは +.Xr telnet 1 +のセッションから発行しても、現在の接続をクローズしません。 .It save このオプションは (まだ) 実装されていません。 - .It set[up] var value このオプションは以下の変数の設定のために使用します: - .Bl -tag -width 20 .It set accmap hex-value ACCMap は非同期制御文字マップ (Asyncronous Control Character Map) を 意味します。 これはいつも相手と交渉され、デフォルト値は 0x00000000 です。 このプロトコルが必要なのは、 -特定の文字 (XON/XOFF など) を終点間で受渡すことに依存するハードウェアを +(XON/XOFF などの) 特定の文字を終点間で受渡すことに依存するハードウェアを 使用する場合です。 - .It set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] [proto [src [lt|eq|gt] port ]] [dst [lt|eq|gt] port] [estab] @@ -1668,7 +2021,6 @@ dfilter ifilter はマシンに入力可能なパケットを指定します。 ofilter はマシンから出力可能なパケットを指定します。 デフォルトでは全てのフィルタが全パケットを通過させる値に設定されます。 - ルールは .Dq n に従って順番に処理されます。 @@ -1677,25 +2029,28 @@ ofilter ifilter と ofilter では、パケットをドロップすることを意味します。 afilter では、アイドルタイマをリセットしないことを意味します。 dfilter ではダイアルさせることにはならないことを意味します。 - 上述のパケットのフィルタリングの節を参照してください。 - .It set authkey|key value クライアントモードでの PAP または CHAP の交渉で使用される 認証キー (もしくはパスワード) を、指定した値に設定します。 -ダイアルもしくはログインスクリプトで使用されるパスワードを指定しますが、 +ダイアルもしくはログインスクリプトの '\\P' シーケンス +で使用されるパスワードを指定しますが、 実際のパスワードがログされることを防ぎます。 - +.Ar command +ログが有効な場合、セキュリティの観点から、 +.Ar value +は +.Ar ******** +としてログされます。 .It set authname id クライアントモードでの PAP または CHAP の交渉で使用される 認証 ID を設定します。 - .It set ctsrts ハードウェアフロー制御をセットします。 これがデフォルトです。 - -.It set device|line value -ppp が使用するデバイスを指定する +.It set device|line value[,value...] +.Nm +が使用するデバイスを指定する .Dq value に設定します。 全シリアルデバイス名は @@ -1714,100 +2069,303 @@ ppp の指定された .Dq port と接続しようとします。 -詳細は上述の PPP オーバ TCP の節を参照してください。 - +詳細は上述の +.Em PPP オーバ TCP +の節を参照してください。 +複数の +.Dq value +を指定した場合、 +.Nm +は全デバイスについて実行し終るまで、順番にオープンを試みます。 .It set dial chat-script 相手へダイアルする際に使用されるチャットスクリプトを指定します。 後述の -.Dv set login +.Dq set login コマンドも参照してください。 チャットスクリプトのフォーマットの詳細については、 .Xr chat 8 -とコンフィギュレーションファイルの例を参照してください。 -文字列 \\\\T は現在の電話番号に置換されます (後述の +と設定ファイルの例を参照してください。 +以下の特殊な +.Sq value +をチャットスクリプトに指定可能です: +.Bd -literal -offset indent +.It \\\\\\\\\\\\\\\\c +.Sq 送信 +文字列の最後の文字として使用した場合、 +改行を追加してはならないことを意味します。 +.It \\\\\\\\\\\\\\\\d +チャットスクリプトがこのシーケンスに出会うと、2 秒待ちます。 +.It \\\\\\\\\\\\\\\\p +チャットスクリプトがこのシーケンスに出会うと、1/4 秒待ちます。 +.It \\\\\\\\\\\\\\\\n +改行文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\r +復改文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\s +空白文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\t +タブ文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\T +現在の電話番号と置き換えられます (後述の .Dq set phone -参照) 。 -文字列 \\\\P はパスワードに置換されます (後述の -.Dq set key -参照) 。 - +参照)。 +.It \\\\\\\\\\\\\\\\P +現在の +.Ar authkey +値と置き換えられます (前述の +.Dq set authkey +参照)。 +.It \\\\\\\\\\\\\\\\U +現在の +.Ar authname +値と置き換えられます (前述の +.Dq set authname +参照)。 +.Ed +.Pp +2 つのパーザがこれらのエスケープシーケンスを検査することに注意してください。 +.Sq チャットのパーザ +にエスケープ文字を見せるには、 +.Sq コマンドパーザ +からエスケープする必要があります。 +つまり、2 つのエスケープを使用する必要があります。例えば次のようにします: +.Bd -literal -offset indent +set dial "... ATDT\\\\T CONNECT" +.Ed +.Pp +チャットスクリプトから外部コマンドを実行することもできます。 +そうするためには、最初の文字をエクスクラメーションマーク +.Pq Dq \&! +にします。 +コマンドが実行されると、標準入力と標準出力がモデムデバイス ( +.Dq set device +参照) に向けられ、標準エラー出力が +.Nm +に読まれて受信待ち文字列もしくは送信文字列に置き換えられます。 +.Nm +が対話モードで実行している場合、ファイルデスクリプタは +.Pa /dev/tty +に接続されます。 +.Pp +例えば (読み易さのために折り返しています); +.Bd -literal -offset indent +set login "TIMEOUT 5 \\"\\" \\"\\" login:--login: ppp \e +word: ppp \\"!sh \\\\\\\\-c \\\\\\"echo \\\\\\\\-n label: >&2\\\\\\"\\" \e +\\"!/bin/echo in\\" HELLO" +.Ed +.Pp +は下記のチャットシーケンスになります (ダイヤル前の +.Sq set log local chat +コマンドによる出力): +.Bd -literal -offset indent +Dial attempt 1 of 1 +dial OK! +Chat: Expecting: +Chat: Sending: +Chat: Expecting: login:--login: +Chat: Wait for (5): login: +Chat: Sending: ppp +Chat: Expecting: word: +Chat: Wait for (5): word: +Chat: Sending: ppp +Chat: Expecting: !sh \\-c "echo \\-n label: >&2" +Chat: Exec: sh -c "echo -n label: >&2" +Chat: Wait for (5): !sh \\-c "echo \\-n label: >&2" --> label: +Chat: Exec: /bin/echo in +Chat: Sending: +Chat: Expecting: HELLO +Chat: Wait for (5): HELLO +login OK! +.Ed +.Pp +複数レベルのネストについて、 +エスケープ文字の使用方法に (再度) 注意してください。 +ここでは、4 つのパーザが動作してます。 +1 番目は、オリジナルの行をパーズし、3 つの引数として読みます。 +2 番目は、第 3 引数を 11 個の引数として読みます。 +ここで、 +.Dq \&- +記号がエスケープされていることが重要です。 +そうでなければパーザは、 +受信待ち-送信-受信待ちのシーケンスとして見てしまいます。 +.Dq \&! +文字を見付けると、実行パーザは最初のコマンドを 3 つの引数として読み、 +.Xr sh 1 +自身が +.Fl c +以降の引数を展開します。 +我々は出力をモデムに送り返したいので、 +1 番目の例では出力をファイルデスクリプタ 2 (stderr) にリダイレクトして +.Nm +自身に送信およびログさせ、 +2 番目の例では単に stdout に出力して直接モデムに出力させます。 +.Pp +もちろん全体を、組み込みのものではなく外部の +.Dq chat +コマンドに実行させることが可能です。 +良い代替方法については +.Xr chat 8 +を参照してください。 +.Pp .It set hangup chat-script モデムをクローズする前にこれをリセットする時に使用する、 チャットスクリプトを指定します。 - +.It set encrypt MSChap|MD5 +CHAP チャレンジを発行するときに要求および使用する +暗号化アルゴリズムを指定します。 +MSChap に設定すると、 +.Nm +は CHAP チャレンジ送信時 (CHAP が enable されていると仮定しています) +に Microsoft RAS のように振舞います。 +チャレンジへの応答時には、 +.Nm +チャレンジに基いてどのように暗号化するかを決定しますので、 +この設定は無視されます。 +.Bl -tag -width 注: +.It 注: +Microsoft の暗号化アルゴリズムは MD4 と DES の組み合わせを使用しますので、 +.Nm +構築前にマシンに DES 暗号化ソフトウェアをインストールしていないと、 +このオプションは使用できません - この場合 MD5 のみ使用されます。 +.El +.Pp .It set escape value... このオプションは上述の .Dq set accmap オプションに似ています。 リンクを経由する時に「エスケープ」される文字を指定するために使用します。 - .It set ifaddr [myaddr [hisaddr [netmask [triggeraddr]]]] このコマンドは、IPCP 交渉の間使用される IP アドレスを指定します。 アドレスのフォーマットは以下の通りです。 - .Dl a.b.c.d/n - a.b.c.d は IP アドレスであり、 n はこのうち何ビットが有効であるかを示します。 もし /n ビットが省略された場合、デフォルトの /32 になります。 ただし IP アドレスが 0.0.0.0 である場合には、マスクのデフォルトは /0 です。 - -.Dq triggeraddr +.Pp +.Ar hisaddr +に IP 番号の範囲として +.Dl a.b.c.d[-d.e.f.g][,h.i.j.k[-l,m,n,o]]... +のフォーマットを指定できます。例えば: +.Dl set ifaddr 10.0.0.1 10.0.1.2-10.0.1.10,10.0.1.20 +は +.Ar 10.0.0.1 +のみをローカル IP 番号として交渉しますが、指定された 10 個の IP 番号から +相手に割り当てを行います。 +相手がこれらの番号のうちの一つを要求し、この番号が未使用な場合には、 +.Nm +は相手の要求を認めます。 +相手がリンクを再確立して前回割当てていた IP 番号を使用したい場合に有用です。 +相手が要求した IP 番号が範囲外もしくは使用中の場合、 +.Nm +はまず範囲内の未使用 IP 番号をランダムに指示します。 +相手がこれに賛成しないと、 +番号が選択されるか過多の IPCP 構成要求が送出されるまで、 +.Nm +は次の番号を指示します。 +.Pp +.Ar triggeraddr が指定された場合、この値が -.Dq myaddr +.Ar myaddr の代りに IPCP 交渉で使用されます。 ただし、 -.Dq myaddr +.Ar myaddr の範囲のアドレスのみ受け入れられます。 - +.Pp +.Fl auto +モードでは設定ファイルの +.Dq set ifaddr +行を読んだ直後に +.Nm +がインタフェースを構成することに注意してください。 +他のモードではこれらの値は IPCP 交渉で使用され、 +IPCP 層がアップするまでこれらのインタフェースは構成されません。 +結果として、 +.Fl auto +モードでない限り、 +.Dq add +コマンドを +.Pa ppp.conf +で使用することは不可能 +.Pq か、少くとも賢くない +です (代りに +.Pa ppp.linkup +ファイルが使用されます)。 +.Dq allow mode auto +を使用して、現在のプロファイルを +.Fl auto +モードのみに限定してください。 +.Pp +また、一旦クライアントが自己を認証した後では、 +.Ar hisaddr +引数は +.Pa ppp.secret +ファイルによって優先されることに注意してください。詳細は +.Em 内向き接続の認証 +の節を参照してください。 .It set loopback on|off -.Dq on +.Ar on に設定された場合 (デフォルトです)、 -宛先アドレスが ppp インタフェースのアドレスと同一の送出パケットを、 +宛先アドレスが +.Em PPP +インタフェースのアドレスと同一の送出パケットを、 .Nm は自動的にループバックさせます。 -.Dq off +.Ar off に設定された場合、 .Nm はパケットを送信します。 この場合おそらく相手方で ICMP リダイレクトが発生します。 - -.It set log [+|-]value... +.It set log [local] [+|-]value... このコマンドにより現在のログレベルを修正できます。 詳細はログ機能の節を参照してください。 - .It set login chat-script -このチャットスクリプトはダイアルスクリプトを補います。 +この +.Ar chat-script +はダイアルスクリプトを補います。 もし両方が指定された場合、ダイアルスクリプトの後で、 ログインスクリプトが実行されます。 ダイアルスクリプト中で使用可能なエスケープシーケンスはここでも使用可能です。 - .It set mru value デフォルトの MRU は 1500 です。 この値を増加させた場合、相手は MTU を増加させても *かまいません*。 デフォルトの MRU より減らすことは意味がありません。 -なぜなら、PPP プロトコルでは少なくとも 1500 オクテッドのパケットを +なぜなら、 +.Em PPP +プロトコルでは少なくとも 1500 オクテッドのパケットを 受信できなければ *ならない* からです。 - .It set mtu value デフォルトの MTU は 1500 です。 相手が指定した MRU によって増加させることができます。 MTU はこのオプションによってのみ減らすことが可能です。 この値を増加させることは無効です。 なぜなら、相手は大きくなったパケットを受信できる保証が無いからです。 - -.It set openmode active|passive -デフォルトでは、openmode は常に active です。 +.It set ns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft DNS サーバを設定します。 +.It set nbns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft NetBIOS DNS サーバを設定します。 +.It set openmode active|passive Op delay +デフォルトでは、 +.Ar openmode +は常に、1 秒の +.Ar delay +をもって +.Ar active +となります。 この場合、 .Nm -はいつでも LCP/IPCP/CCP の交渉を開始します。 -相手が交渉開始するのを待ちたい場合は、値 +は回線が設定されてから 1 秒が経過したなら +いつでも LCP/IPCP/CCP の交渉を開始します。 +相手が交渉を開始するのを待ちたい場合は、値 .Dq passive を使用します。 - +直ちにもしくは 1 秒以上待ってから交渉を開始したい場合、 +.Ar delay +を秒単位で指定します。 .It set parity odd|even|none|mark -ラインのパリティを設定できます。デフォルト値は none です。 - +ラインのパリティを設定できます。デフォルト値は +.Ar none +です。 .It set phone telno[|telno]...[:telno[|telno]...]... ダイアルおよびログインのチャットスクリプトで使用される \\\\T 文字列が 置き換えられる電話番号を指定できます。 @@ -1824,39 +2382,36 @@ MTU で指定します。 .Fl background モードでは各番号は最大 1 回試行されます。 - .It set reconnect timeout ntries (CD の喪失もしくは LQR の失敗により) 予想外のライン切断となった場合、 指定した -.Dq timeout +.Ar timeout の後に接続が再確立されます。 ラインは最大 -.Dq ntries +.Ar ntries 回、再接続されます。 -.Dq ntries +.Ar ntries のデフォルトは 0 です。 -.Dq timeout +.Ar timeout に -.Dq random +.Ar random を指定すると、0 から 30 秒の間の任意時間の停止となります。 - .It set redial seconds[.nseconds] [attempts] .Nm ppp に -.Dq attempts +.Ar attempts 回のリダイアルを指示できます。 1 より大きな数を指定した場合 (上述の -.Dq set phone +.Ar set phone 参照)、 各番号にダイアルする前に、 -.Dq nseconds +.Ar nseconds だけ停止します。 最初の番号にダイアル開始する前に -.Dq seconds +.Ar seconds だけ停止します。 .Dq random もここで使用できます。 - .It set stopped [LCPseconds [IPCPseconds [CCPseconds]]] このオプションが指定されると、 指定した有限状態機械が停止状態になってから @@ -1864,66 +2419,104 @@ MTU で指定した秒数だけ停止したのち、 .Nm はタイムアウトします。 -このオプションが便利かもしれないのは、 -ppp が停止状態になったことにより返事をしないといった状態を見る場合です。 +このオプションは、 +.Nm +が停止状態になったことにより返事をしないといった状態を見る場合と、 +.Dq set openmode passive +を使用した場合に相手が指定時間内に Configure Request を送らないことを +タイムアウト検出する場合には、便利かもしれません。 .Dq set log +lcp +ipcp +ccp を使用すると、 .Nm は全状態遷移をログします。 .Pp デフォルト値は 0 であり、 -停止状態による ppp のタイムアウトは発生しません。 - -.It set server|socket TcpPort|LocalName|none [mask] -通常、対話モードでない場合には、 +停止状態による .Nm -はコマンド接続を受け入れるために TCP ソケットを listen します。 -デフォルトのソケット番号は、3000 + -.Nm -がオープンしたトンネルデバイス番号で計算されます。 -例えば、 -.Nm -が tun2 をオープンした場合、ソケット 3002 を使用します。 +のタイムアウトは発生しません。 .Pp -このコマンドを使用すると、 -ポート番号やローカルドメインソケット (絶対ファイル名として指定) を指定可能 -ですし、 +この値は openmode の遅延 (上述の +.Dq set openmode +参照) より小さくなってはなりません。 +.It set server|socket TcpPort|LocalName|none [password] [mask] +このコマンドは .Nm -にコマンド接続を拒否させることも可能です。 -ローカルドメインソケットが指定された場合、 -ソケット作成の前にオクテットマスクを指定可能です。 -.Dv USR1 -シグナルの使用方法も参照してください。 - +に指定したポートもしくは +.Sq 診断ポート +にてコマンド接続の入力を listen するように指示します。 +これは +.Nm +が対話モードの時には出来ません。 +語 +.Ar none +は +.Nm +に既に存在するソケットをクローズさせます。 +UNIX ドメインソケットを指定したい場合、 +.Ar LocalName +に絶対ファイル名を指定します。そうしないと、TCP ポートの名前もしくは番号 +であると解釈されます。 +UNIX ドメインソケットに使用される 8 進 umask を指定可能です。 +.Sq 0 +から始まる 4 桁 8 進数で指定します。 +umask の詳細については +.Xr umask 2 +を参照してください。TCP ポート名がどのように変換されるかについては +.Xr services 5 +を参照してください。 +.Pp +このソケットにクライアントが接続するときに使用されねばならないパスワードも +指定可能です。 +ここにパスワードを指定しないと、 +.Pa /etc/ppp/ppp.secret +からドメインサフィックスを除いたローカルホスト名にてマシン名で検索を行います。 +詳細は +.Xr hostname 1 +を参照してください。 +パスワードに空文字列を指定すると、パスワードは要求されなくなります。 .Pp .Nm をサーバソケットと共に使用する場合、通信機構として .Xr pppctl 8 -コマンドを使用する方が好ましいです。 +コマンドを使用することが好ましいです。 現在 .Xr telnet 1 -も使用可能ですが、将来リンク暗号化が実装されますので、 -.Nm telnet +も使用可能ですが、将来リンク暗号化が実装されるかもしれませんので、 +.Xr telnet 1 に依存しないようにしてください。 - .It set speed value シリアルデバイスの速度を指定します。 - .It set timeout Idle [ lqr [ retry ] ] アイドルタイマ、 -(有効にされているなら )LQR タイマ、 +(有効にされているなら) LQR タイマ、 リトライタイマの値を指定します。 - -.It set ns x.x.x.x y.y.y.y -このオプションは交渉される Microsoft DNS サーバを設定します。 - -.It set nbns x.x.x.x y.y.y.y -このオプションは交渉される Microsoft NetBIOS DNS サーバを設定します。 - +.It set vj slots nslots +このコマンドは最初の +.Ar slots +番号を指定します。 +.Nm +は VJ 圧縮が enable されている時には、 +これを使用して相手と交渉をします (前述の +.Sq enable +コマンドを参照してください)。 +デフォルト値は 16 です。 +.Ar nslots +は +.Ar 4 +から +.Ar 16 +の間で、それぞれの値を含みます。 +.It set vj slotcomp on|off +このコマンドは +.Nm +に VJ スロット圧縮を交渉するか否かを指示します。 +デフォルトではスロット圧縮は +.Ar on +です。 .It set help|? 使用可能なセットコマンドのまとめを表示します。 .El - +.Pp .It shell|! [command] .Dq command が指定されない場合、 @@ -1937,85 +2530,67 @@ ppp は適切な値に置き換えられます。! 文字を使用した場合、 この後のコマンドとの間にスペースが必要です。 このコマンドはフォアグラウンドで実行されることに注意してください - -ppp はプロセスが終了するまでは実行を続けません。 +.Nm +はプロセスが終了するまでは実行を続けません。 バックグラウンドでコマンド処理を行いたい場合には、 .Dv bg コマンドを使用してください。 - .It show var このコマンドを使用して、以下を確認できます: - .Bl -tag -width 20 .It show [adio]filter -指定したフィルタの現在の規則をリストします。 - +指定したフィルタの現在のルールをリストします。 .It show auth -現在の authname と authkey を表示します。 - +現在の authname と暗号値を表示します。 +.Nm +を DES サポート無しで構築した場合、 +.Ar MD5 +が使用されるため、暗号値は表示されません。 .It show ccp 現在の CCP 統計を表示します。 - .It show compress 現在の圧縮統計を表示します。 - .It show escape 現在のエスケープ文字を表示します。 - .It show hdlc 現在の HDLC 統計を表示します。 - .It show ipcp 現在の IPCP 統計を表示します。 - .It show lcp 現在の LCP 統計を表示します。 - .It show loopback 現在のループバック状態を表示します。 - .It show log 現在のログ値を表示します。 - .It show mem 現在のメモリ統計を表示します。 - .It show modem 現在のモデム統計を表示します。 - .It show mru 現在の MRU を表示します。 - .It show mtu 現在の MTU を表示します。 - .It show proto 現在のプロトコルの総計を表示します。 - .It show reconnect 現在の再接続値を表示します。 - .It show redial 現在のリダイアル値を表示します。 - .It show stopped 現在の stopped タイムアウト値を表示します。 - .It show route 現在のルーティングテーブルを表示します。 - .It show timeout 現在のタイムアウト値を表示します。 - .It show msext 現在の Microsoft 拡張値を表示します。 - .It show version -ppp の現在のバージョン番号を表示します。 - +.Nm +の現在のバージョン番号を表示します。 .It show help|? 利用可能な show コマンドのまとめを表示します。 .El - +.Pp .It term ターミナルモードに移行します。 キーボードからタイプした文字はモデムに送られます。 @@ -2025,116 +2600,12 @@ ppp の相手が認識された時には、 .Nm は自動的にパケットモードを有効にし、コマンドモードに戻ります。 - -.It alias ..... -このコマンドは -.Nm ppp -組込みのエイリアシング (マスカレーディング) 機能を -制御するために使用します。 -このコードが必要となるまで、 -.Nm ppp -はこのコードをロードしません。 -エイリアスライブラリがあなたのシステムにインストールされないことも -大いにありえます -(エイリアスライブラリがセキュリティ的に危険だと認識する管理者もいます)。 - -あなたのシステムでエイリアシングが有効になると、 -以下のコマンドが使用可能となります: - -.Bl -tag -width 20 -.It alias enable [yes|no] -エイリアシングを有効もしくは無効にします。 -.Fl alias -コマンドラインフラグは -.Dq alias enable yes -と同じ意味です。 - -.It alias port [proto targetIP:targetPORT [aliasIP:]aliasPORT] -このコマンドにより、 -マシン [aliasIP] の -.Dq aliasPORT -へ到着する接続を、 -.Dq targetIP -の -.Dq targetPORT -へリダイレクトします。 -proto を指定した場合、指定したプロトコルの接続のみマッチします。 -あなたのゲートウェイの後のマシンでインターネット電話等を実行したい場合に、 -このオプションは有用です。 - -.It alias addr [addr_local addr_alias] -このコマンドにより、 -.Dq addr_alias -へのデータを -.Dq addr_local -へリダイレクトします。 -あなたのゲートウェイの後で -少数の実 IP アドレスを持ち、 -これらをあなたのゲートウェイの後の特定のマシンにマップしたい場合に有用です。 - -.It alias deny_incoming [yes|no] -yes に設定した場合、ファイアウォールがパケットを落すのと同様に、 -全ての入力の接続を拒否します。 - -.It alias log [yes|no] -このオプションを指定することにより、 -種々のエイリアシングの統計と情報を、ファイル -.Pa /var/log/alias.log -にログします。 - -.It alias same_ports [yes|no] -有効になると、 -エイリアスライブラリが出力パケットのポート番号を変更しようとすることを -止めさせます。 -RPC や LPD といった、 -ウェルノウンポート (well known port) からの接続を要求する -プロトコルをサポートするのに有用です。 - -.It alias use_sockets [yes|no] -有効になると、 -エイリアスライブラリにソケットを作成させ、 -正しい ftp データ入力と IRC 接続を保証できるようになります。 - -.It alias unregistered_only [yes|no] -出力パケットを、登録されていない送信元アドレスに変更することだけを行います。 -RFC1918 に依ると、登録されていない送信元アドレスは -10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 です。 - -.It alias help|? -このコマンドにより、 -使用可能なエイリアスコマンドのまとめを表示します。 - .El - -.It quit|bye [all] -.Nm ppp -を終了します。 -.Nm -が対話モードであるか -.Dq all -引数が指定された場合、ppp は終了し、接続をクローズします。 -単に -.Dq quit -を telnet セッションから入力するだけでは現在の接続をクローズしません。 - -.It help|? [command] -利用可能なコマンドをリストします。 -.Dq command -を指定した場合、このコマンドの使用方法を表示します。 - -.It down -リンクを切断しますが、綺麗な方法ではありません。 -このコマンドを使用することは丁寧ではないとされています。 - -.El - +.Pp .Sh 更に詳細について - .Bl -bullet -compact - .It 設定ファイルの例を読んでください。良い情報源です。 - また、 .It .Dq help , @@ -2144,79 +2615,85 @@ RFC1918 .Dq set ? コマンドを使ってください。 .El - +.Pp .Sh 関連ファイル .Nm -は、ppp.conf, ppp.linkup, ppp.linkdown, ppp.secret を参照します。 +は、4 つのファイル +.Pa ppp.conf , +.Pa ppp.linkup , +.Pa ppp.linkdown , +.Pa ppp.secret +を参照します。 これらのファイルは .Pa /etc/ppp -に置かれますが、ユーザが自分用のファイルを -.Pa .ppp.conf , -.Pa .ppp.linkup , -.Pa .ppp.linkdown , -.Pa .ppp.secret -として $HOME ディレクトリに作成することもできます。 -いつでも -.Nm -はユーザの個人設定を優先的に参照します。 - +に置かれます。 .Bl -tag -width flag -.Pa $HOME/ppp/.ppp.[conf|linkup|linkdown|secret] -ユーザ個人の設定ファイル。 - -.Pa /etc/ppp/ppp.conf +.It Pa /etc/ppp/ppp.conf システムのデフォルト設定ファイル。 - -.Pa /etc/ppp/ppp.secret +.It Pa /etc/ppp/ppp.secret 各システム用の認証設定ファイル。 - -.Pa /etc/ppp/ppp.linkup +.It Pa /etc/ppp/ppp.linkup .Nm がネットワーク層の接続を確立した時に実行されるファイル。 - -.Pa /etc/ppp/ppp.linkdown +.It Pa /etc/ppp/ppp.linkdown .Nm がネットワークレベルの接続を閉じるときにチェックするファイル。 - -.Pa /var/log/ppp.log -ログとデバッグ情報のファイル。 - -.Pa /var/spool/lock/LCK..* -tty ポートをロックするためのファイル。詳細は -.Xr uucplock 8 +.It Pa /var/log/ppp.log +ログとデバッグ情報のファイル。このファイル名は +.Pa /etc/syslogd.conf +にて指定されます。詳細は +.Xr syslog.conf 5 を参照してください。 - -.Pa /var/run/tunX.pid -tunX デバイスに接続されている ppp プログラムのプロセス id (pid) 。 +.It Pa /var/spool/lock/LCK..* +tty ポートをロックするためのファイル。詳細は +.Xr uucplock 3 +を参照してください。 +.It Pa /var/run/tunX.pid +tunX デバイスに接続されている +.Nm +プログラムのプロセス ID (pid) 。 ここで 'X' はデバイスの番号です。このファイルは .Fl background , .Fl auto , .Fl ddial のいずれかのモードの時のみ作成されます。 - -.Pa /var/run/ttyXX.if -このポートで使われている tun インターフェース。 +.It Pa /var/run/ttyXX.if +このポートで使われている tun インタフェース。 このファイルも .Fl background , .Fl auto , .Fl ddial のいずれかのモードの時のみ作成されます。 - -.Pa /etc/services +.Pa It /etc/services サービス名でポート番号が指定されている場合に、ポート番号を取得します。 .El - +.Pp .Sh 関連項目 +.Xr at 1 , .Xr chat 8 , +.Xr crontab 5 , +.Xr ftp 1 , +.Xr getty 8 , +.Xr gzip 1 , +.Xr hostname 1 , +.Xr inetd 8 , +.Xr init 8 , +.Xr login 1 , +.Xr passwd 5 , +.Xr ping 8 , +.Xr pppctl 8 , .Xr pppd 8 , -.Xr uucplock 3 , +.Xr route 8 , .Xr syslog 3 , .Xr syslog.conf 5 , .Xr syslogd 8 , -.Xr pppctl 8 , -.Xr telnet 1 - +.Xr tcpdump 1 , +.Xr telnet 1 , +.Xr traceroute 8 , +.Xr uucplock 3 .Sh 歴史 元のプログラムは Toshiharu OHNO (tony-o@iij.ad.jp) が作成し、 FreeBSD-2.0.5 に Atsushi Murai (amurai@spec.co.jp) が提出しました。 -多くの面で性能向上が計られたため、見た目がかなり異なります。 +.Pp +それから、本質的に Brian Somers (brian@Awfulhak.org) が修正をし、'97 年 +11 月に OpenBSD に移植されました (2.2-RELEASE の直後です)。 diff --git a/ja/man/man8/pppctl.8 b/ja/man/man8/pppctl.8 index fe20055386..ffc1b2a0d3 100644 --- a/ja/man/man8/pppctl.8 +++ b/ja/man/man8/pppctl.8 @@ -1,164 +1,200 @@ -.\" %Id: pppctl.8,v 1.1.2.3 1997/10/05 14:23:26 brian Exp % +.\" %Id: pppctl.8,v 1.1.2.4 1998/01/26 20:00:49 brian Exp % .Dd 26 June 1997 .Os FreeBSD .Dt PPPCTL 8 -.Sh 名称 +.Sh $BL>>N(B .Nm pppctl .Nd -PPP 制御プログラム -.Sh 書式 +PPP $B@)8f%W%m%0%i%`(B +.Sh $B=q<0(B .Nm .Op Fl v .Op Fl t Ar n .Op Fl p Ar passwd .Ar [host:]Port | LocalSocket -.Ar command -.Op Ar ;command -.Ar ... -.Sh 解説 -このプログラムは -.Nm ppp -デーモンのコマンドラインからの制御手段を提供します。 -基本的な使い方は、実行中のデーモンを制御する単純なスクリプトを -簡単に書けるようにすることです。 - -.Nm -は少なくともふたつの引数を必要とします。ひとつめは -.Nm ppp -デーモンが listen しているソケットを指定します。ソケットが -先頭に '/' を含んでいると、 AF_LOCAL ソケットとして扱われます。 -コロンを含んでいると host:port の組として扱われ、 -それ以外は単にローカルマシン (127.0.0.1) のポートを -指定したものとみなされます。 -DNS 検索を避けたい場合や、 -.Pa /etc/services -内に指定されたポートのエントリがない場合には、 -host と port には数字で指定することができます。 - +.Op command[;command]... +.Sh $B2r@b(B +$B$3$N%W%m%0%i%`$O(B +.Xr ppp 8 +$B%G!<%b%s$N%3%^%s%I%i%$%s$+$i$N@)8f/$J$/$H$b$R$H$D$N0z?t$rI,MW$H$7$^$9!#(B +$B>\:Y$K$D$$$F$O!"(B +.Nm ppp +$B%3%^%s%I$N(B +.Sq set server +$B$r;2>H$7$F2<$5$$!#(B +$B%=%1%C%H$,@hF,$K(B '/' $B$r4^$s$G$$$k$H!"(B +.Dv AF_LOCAL +$B%=%1%C%H$H$7$F07$o$l$^$9!#(B +$B%3%m%s$r4^$s$G$$$k$H(B +.Ar host:port +$B$NAH$H$7$F07$o$l!"(B +$B$=$l0J30$OC1$K%m!<%+%k%^%7%s(B (127.0.0.1) $B$N(B TCP $B%]!<%H$r(B +$B;XDj$7$?$b$N$H$_$J$5$l$^$9!#(B +DNS $B8!:w$rHr$1$?$$>l9g$d!"(B +.Pa /etc/services +$BFb$K;XDj$5$l$?%]!<%H$N%(%s%H%j$,$J$$>l9g$K$O!"(B +.Ar host +$B$H(B +.Ar port +$B$K$O?t;z$G;XDj$9$k$3$H$,$G$-$^$9!#(B +.Pp +$B;D$j$N0z?t$O$9$Y$F!"(B +.Nm ppp +$B%G!<%b%s$KAw$i$l$k(B ($BJ#?t$N(B) +.Ar $B%3%^%s%I(B +$B$r7A@.$9$k$?$a$KO"7k$5$l$^$9!#(B +$B%;%_%3%m%sJ8;z$O%3%^%s%I%G%j%_%?$H$7$F07$o$l!"$R$H$D$N(B +.Sq $B%;%C%7%g%s(B +$B$GJ#?t$N(B +.Ar $B%3%^%s%I(B +$B$r;XDj$9$k$3$H$,2DG=$G$9!#(B +$BNc$($P(B: +.Bd -literal -offset indent +pppctl 3000 set timeout 300\\; show timeout +.Ed +.Pp +$B$[$H$s$I$N%7%'%k$G$O(B ';' $B$OFCl9g!"(B +.Nm +$B$O%$%s%?%i%/%F%#%V%b!<%I$K$J$j$^$9!#(B +$B$3$3$G!"%3%^%s%I$OI8=`F~NO$+$iFI$_9~$^$l$^$9!#(B +$B%3%^%s%I$rFI$s$G$$$k;~$K!"(B +.Xr editline 3 +$B$,;H$o$l$F$$$l$P!"(B( +.Xr editrc 5 +$B$G;XDj$7$??6$kIq$$$G(B) +$B9TJT=8$,2DG=$K$J$j$^$9!#(B $BMzNr$NBg$-$5$O%G%U%)%k%H$G$O(B +.Em 20 $B9T(B +$B$G$9!#(B +.Pp +$B0J2<$N%3%^%s%I%i%$%s%*%W%7%g%s$,MxMQ2DG=$G$9(B: .Bl -tag -width Ds .It Fl v .Nm ppp -デーモンに送られたデータ、 +$B%G!<%b%s$KAw$i$l$?%G!<%?!"(B .Nm ppp -デーモンから受け取ったデータをすべて表示します。 -.Nm pppctl -は通常、受け取った non-prompt 行のみ表示します。 +$B%G!<%b%s$+$io!"e$G%G!<%b%s$r@)8f$7$h$&$H$9$k(B +$B>l9g$KI,MW$+$b$7$l$^$;$s!#(B .It Fl p Ar passwd .Nm ppp -デーモンが必要とするパスワードを指定します。 -このスイッチが指定されないと、 +$B%G!<%b%s$,I,MW$H$9$k%Q%9%o!<%I$r;XDj$7$^$9!#(B +$B$3$N%9%$%C%A$,;XDj$5$l$J$$$H!"(B .Nm -は +$B$O(B .Nm ppp -への接続が成功した時にパスワードの入力を促します。 +$B$X$N@\B3$,@.8y$7$?;~$K%Q%9%o!<%I$NF~NO$rB%$7$^$9!#(B .El - -.Sh 使用例 +.Pp +.Sh $B;HMQNc(B .Nm ppp -を +$B$r(B .Fl auto -モードで実行する場合、 +$B%b!<%I$Gl9g!"(B .Nm -は多くの仕事を自動化するのに利用できます。 +$B$OB?$/$N;E;v$r<+F02=$9$k$N$KMxMQ$G$-$^$9(B +($B$b$A$m$s!"$N?M$KFI$a$J$$$h$&$K$J$C$F$$$?$H$7$F$b(B) +$B$*4+$a$G$-$^$;$s!#(B .Pp -.Nm pppctl -と共に利用可能なソケットを -.Nm ppp -が作るようにするためには、ローカルシステムに -パスワードを設定する必要があります。 -.Bd -literal -offset indent -# touch /etc/ppp/ppp.secret -# chown root.wheel /etc/ppp/ppp.secret -# chmod 400 /etc/ppp/ppp.secret -# echo "`hostname -s` MyPassword" >>/etc/ppp/ppp.secret -.Ed -.Pp -簡単で安全に .Nm -へアクセスできるようにしたり、 -.Nm ppp -をいくつも起動した場合にそれらを識別したりする最も安全な方法は、 +$B$X$N4JC1$G0BA4$J%"%/%;%9$rDs6!$9$k$b$C$H$bNI$$J}K!$O!"(B .Pa /etc/ppp/ppp.conf -(の正しいセクション) にローカルサーバソケットを作成することです: - +($B$N@5$7$$%;%/%7%g%s(B) $B$K0J2<$N$h$&$K%m!<%+%k%5!<%P%=%1%C%H$r:n@.$9$k$3$H$G$9(B: .Bd -literal -offset indent -set server /var/run/internet 0666 +set server /var/run/internet "" 0177 .Ed - -これはデフォルトで作られる tcp ソケットではなく、 -ローカルドメインソケットを作成するように -.Nm ppp -に指示します。より詳しい解説はマニュアルページ -.Xr ppp 8 -を参照してください。 - .Pp -このようにするといくつかのお気楽スクリプトが作成可能になります。 -インターネットに接続するには: - +$B$3$l$O!"(B +.Nm ppp +$B$r\$7$$2r@b$O%^%K%e%"%k%Z!<%8(B +.Xr ppp 8 +$B$r;2>H$7$F$/$@$5$$!#(B +.Pp +$B$3$N$h$&$K$9$k$H$$$/$D$+$N$*5$3Z%9%/%j%W%H$,:n@.2DG=$K$J$j$^$9!#(B +$B%$%s%?!<%M%C%H$K@\B3$9$k$K$O(B: .Bd -literal -offset indent #! /bin/sh test $# -eq 0 && time=300 || time=$1 -exec pppctl -t 60 /var/run/internet set timeout $time\\; dial +exec pppctl /var/run/internet set timeout $time\\; dial .Ed - .Pp -切断するには: +$B@ZCG$9$k$K$O(B: .Bd -literal -offset indent #! /bin/sh exec pppctl /var/run/internet set timeout 300\\; close .Ed - .Pp -接続されているかどうか確かめるには: +$B@\B3$5$l$F$$$k$+$I$&$+3N$+$a$k$K$O(B: .Bd -literal -offset indent #! /bin/sh -pppctl -p '' -v /var/run/internet '' | grep ^PPP >/dev/null +pppctl -p '' -v /var/run/internet quit | grep ^PPP >/dev/null if [ $? -eq 0 ]; then echo Link is up else echo Link is down fi .Ed - .Pp -このような汎用スクリプトも作成可能です: +$B$3$N$h$&$JHFMQ%9%/%j%W%H$b:n@.2DG=$G$9(B: .Bd -literal -offset indent #! /bin/sh exec pppctl /var/run/internet "$@" .Ed - -.Sh 関連項目 +.Pp +.Sh $B4D6-JQ?t(B +$B0J2<$N4D6-JQ?t$,!"%$%s%?%i%/%F%#%V%b!<%ICf$N(B +.Nm +$B$K$h$C$FM}2r$5$l$^$9(B: +.Bl -tag -width XXXXXXXXXX +.It Dv EL_SIZE +$BMzNr9T$N?t$G$9!#%G%U%)%k%H$G$O(B 20 $B$G$9!#(B +.It Dv EL_EDITOR +$BJT=8%b!<%I$G$9!#(B "emacs" $B$b$7$/$O(B "vi" $B$@$1$,$NCM$OL5;k$7$^$9!#$3$N4D6-JQ?t$O(B +.Pa ~/.editrc +$B$N(B +.Ar bind -v +$B$d(B +.Ar bind -e +$B$G>e=q$-$5$l$^$9!#(B +.El +.Pp +.Sh $B4XO"9`L\(B +.Xr editline 3 , +.Xr editrc 5 , .Xr ppp 8 , +.Xr ps 1 , .Xr services 5 -.Sh 歴史 +.Sh $BNr;K(B .Nm -コマンドは FreeBSD 2.2.5 で最初に登場しました。 +$B%3%^%s%I$O(B FreeBSD 2.2.5 $B$G:G=i$KEP>l$7$^$7$?!#(B diff --git a/ja/man/man8/pw.8 b/ja/man/man8/pw.8 index 40566438c3..cd04d2b0a7 100644 --- a/ja/man/man8/pw.8 +++ b/ja/man/man8/pw.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: pw.8,v 1.1.1.1.2.4 1997/10/14 06:38:56 charnier Exp % +.\" %Id: pw.8,v 1.1.1.1.2.5 1997/11/04 07:16:14 charnier Exp % .\" jpman %Id: pw.8,v 1.3 1997/10/28 15:30:48 kuriyama Stab % .\" .Dd December 9, 1996 @@ -788,10 +788,10 @@ pw .Xr chpass 1 , .Xr passwd 1 , .Xr group 5 , +.Xr login.conf 5 , .Xr passwd 5 , .Xr pw.conf 5 , .Xr pwd_mkdb 8 , -.Xr login.conf 5 , .Xr vipw 8 .Sh 歴史 .Nm diff --git a/ja/man/man8/rbootd.8 b/ja/man/man8/rbootd.8 index 323154f924..7b51bc5b55 100644 --- a/ja/man/man8/rbootd.8 +++ b/ja/man/man8/rbootd.8 @@ -38,7 +38,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rbootd.8 8.2 (Berkeley) 12/11/93 -.\" %Id: rbootd.8,v 1.3 1996/09/22 21:54:30 wosch Exp % +.\" %Id: rbootd.8,v 1.3.2.1 1997/12/16 07:17:43 charnier Exp % .\" .\" Utah $Hdr: rbootd.man 3.1 92/07/06$ .\" Author: Jeff Forys, University of Utah CSS @@ -56,29 +56,29 @@ .Op Fl i Ar interface .Op config_file .Sh 解説 -.Nm rbootd +.Nm ユーティリティは、LAN 上の Hewlett-Packard 社製ワークステーションからの ブート要求に対するサービスを行います。 全てのブートファイルはブートファイル用のディレクトリになければならず、 さらに、もしクライアントがブートリクエスト中にパス情報をつけていた場合は、 処理する前にそのパスは取り除かれます。デフォルトでは、 -.Nm rbootd +.Nm は, そのコンフィグレーションファイル中にリストされているマシンからの リクエストにのみ応答します。 .Pp オプションとしては以下のものがあります: -.Bl -tag -width Fl +.Bl -tag -width indent .It Fl a どのようなマシンからのブート要求にも応えます。このオプションが設定された 場合は、コンフィギュレーションファイルは無視されます。 .It Fl d -.Nm rbootd +.Nm をデバッグモードで起動します。受信および送信 されたパケットが端末に表示されるようになります。 .It Fl i Ar interface 指定したインタフェースに対してサービスを行います。 もし指定されていない場合には、 -.Nm rbootd +.Nm はループバック以外のもっとも小さい番号の使用可能なインタフェースを システムインタフェースリストから探します。 早いもの順で選ぶので、組合せはバラバラになります。 @@ -86,7 +86,7 @@ .Pp .Ar config_file を指定すれば、 -.Nm rbootd +.Nm はデフォルトのコンフィギュレーションファイルではなく、こちらのファイルを 使用するようになります。 .Pp @@ -110,12 +110,12 @@ Ethernet .It 8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either) .El .Pp -.Nm rbootd +.Nm のログやエラーメッセージは .Xr syslog 3 を使っています。スタートアップメッセージはつねにログに記録され、 致命的なエラー(もしくは -.Nm rbootd +.Nm を殺すようなシグナル) が起こった場合にはサーバの終了メッセージもログに残します。 一般的には、致命的ではないエラーはそれによってひき起こされる動作を @@ -146,7 +146,7 @@ Ethernet .It /usr/mdec/rbootd ブートファイルを置くディレクトリ .It /var/run/rbootd.pid -.Nm rbootd +.Nm のプロセス ID .El .Sh 関連項目 diff --git a/ja/man/man8/revnetgroup.8 b/ja/man/man8/revnetgroup.8 index 50a1e2a7c9..069f559a00 100644 --- a/ja/man/man8/revnetgroup.8 +++ b/ja/man/man8/revnetgroup.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: revnetgroup.8,v 1.1.1.1 1995/10/26 16:25:29 wpaul Exp % +.\" %Id: revnetgroup.8,v 1.1.1.1.2.1 1997/12/16 07:20:16 charnier Exp % .\" jpman %Id: revnetgroup.8,v 1.2 1997/06/14 16:12:45 horikawa Stab % .\" .Dd October 24, 1995 @@ -40,6 +40,8 @@ .Sh 書式 .Nm revnetgroup .Fl u +.Op Fl f Ar netgroup_file +.Nm revnetgroup .Fl h .Op Fl f Ar netgroup_file .Sh 解説 @@ -54,25 +56,27 @@ 逆ネットグループフォーマットでは、 あるメンバが属するグループを示します。 この情報は -.Nm netgroup.byuser +.Pa netgroup.byuser と -.Nm netgroup.byhosts -の NIS マップを作成するために使用します。 +.Pa netgroup.byhosts +の +.Tn NIS +マップを作成するために使用します。 これらの逆ネットグループマップは、ネットグループの参照、 特に .Fn innetgr ライブラリ関数を高速化するために使用されます。 .Pp 例えば、標準の -.Nm /etc/netgroup +.Pa /etc/netgroup ファイルはネットグループとそのメンバリストを列挙します。 ここで、ネットグループは -.Pa キー +.Em キー であるとし、メンバ名を -.Pa データ +.Em データ であるとします。 これに対し、逆の -.Nm netgroup.byusers +.Pa netgroup.byusers データベースは、ユニークなメンバをキーとし、 メンバが属するネットグループをデータとします。 ユーザとホストに属する情報を保持する別々のデータベースを作成します; @@ -80,56 +84,65 @@ 独立のキー空間にて実行されます。 .Pp あらかじめ逆ネットグループデータベース -(およびこれに対応する NIS マップ)を構築することにより、 +(およびこれに対応する +.Tn NIS +マップ)を構築することにより、 要求ごとに .Xr getnetgrent 3 ライブラリ関数が依存関係を処理しなくても良くなります。 これは、ユーザ数及びホスト数が多いネットワークでは重要です。 なぜなら、巨大なネットグループデータベースの処理は多大な時間を要するからです。 .Pp -.Nm revnetgroup +.Nm コマンドは結果を標準出力に表示します。 通常は -.Nm /var/yp/Makefile +.Pa /var/yp/Makefile から呼ばれるだけであり、 -これは NIS ネットグループマップを構築する時です。 +これは +.Tn NIS +ネットグループマップを構築する時です。 .Pp .Sh オプション -.Nm revnetgroup +.Nm コマンドは以下のオプションをサポートします: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl u -netgroup.byuser を生成します; +.Pa netgroup.byuser +を生成します; 元のネットグループファイルのユーザ名情報のみが処理されます。 .It Fl h -netgroup.byhost を生成します; +.Pa netgroup.byhost +を生成します; 元のネットグループファイルのホスト名情報のみが処理されます。( .Fl u か .Fl h のいずれかを指定する必要が有ります。) .It Op Fl f Ar netgroup_file -.Nm revnetgroup +.Nm コマンドは -.Nm /etc/netgroup +.Pa /etc/netgroup をデフォルトの入力ファイルとします。 .Fl f フラグにて、ユーザは別の入力ファイルを指定できます。``-'' を 入力ファイルとして指定すると、 -.Nm revnetgroup +.Nm は標準入力を読みます。 .El .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -NIS データベースを構築するために +.Tn NIS +データベースを構築するために .Nm yp_mkdb と .Nm revnetgroup を呼び出す Makefile。 .It Pa /etc/netgroup デフォルトのネットグループデータベースファイル。 -ほとんどの場合、NIS マスタサーバにだけ有ります。 +ほとんどの場合、 +.Tn NIS +マスタサーバにだけ有ります。 .El .Sh 関連項目 .Xr yp 4 , @@ -137,4 +150,4 @@ NIS .Xr yp_mkdb 8 , .Xr getnetgrent 3 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/rexecd.8 b/ja/man/man8/rexecd.8 index edcf701df2..7aaf912cf2 100644 --- a/ja/man/man8/rexecd.8 +++ b/ja/man/man8/rexecd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)rexecd.8 8.2 (Berkeley) 12/11/93 +.\" %Id: rexecd.8,v 1.3.2.3 1997/12/16 07:22:06 charnier Exp % .\" jpman %Id: rexecd.8,v 1.2 1997/05/28 07:05:49 yugawa Stab % -.\" %Id: rexecd.8,v 1.3.2.2 1996/11/23 08:25:35 phk Exp % .\" .Dd September 23, 1994 .Dt REXECD 8 @@ -42,14 +42,14 @@ .Sh 書式 .Nm rexecd .Sh 解説 -.Nm rexecd +.Nm は、 .Xr rexec 3 ルーチンのためのサーバです。本サーバは、ユーザ名と パスワードに基づいたユーザ認証による、リモートプロセス実行の環境 を提供します。 .Pp -.Nm rexecd +.Nm は、 .Xr services 5 にて ``exec'' サービスが定義されたポートを @@ -78,7 +78,7 @@ NUL されます。コマンドの長さは、システムの引数リストの制限を越えない長さに 制限されます。 .It -.Nm rexecd +.Nm は、次に、ログイン時と同様にユーザの認証を行い、 ユーザ認証が成功した場合、 カレントディレクトリを当該ユーザのホームディレクトリに変更し、 @@ -87,18 +87,22 @@ NUL .It NUL 文字が最初のソケットに返却され、コマンドラインは当該ユーザの 通常のログインシェルに渡されます。シェルは -.Nm rexecd +.Nm によって確立されたネットワークコネクションを継承します。 .El .Sh 警告 -.Nm rexecd -は root のログイン、/etc/ftpusers にリストされたユーザでのアクセス、 +.Nm +は root のログイン、 +.Pa /etc/ftpusers +にリストされたユーザでのアクセス、 パスワードの無いユーザのアクセスを許可しません。 これらはすべて重大なセキュリティホールでした。 rexec/rexecd のコンセプトは、メジャーなセキュリティホールと、それをさせない ための例です。 -.Nm rexecd -は /etc/inetd.conf ではデフォルトで無効になっています。 +.Nm +は +.Pa /etc/inetd.conf +ではデフォルトで無効になっています。 .Sh 診断 以下のリストの一番最後のものを除き、全ての診断メッセージは、 他のネットワークコネクションが切断された後に、最初の socket を経由して返却 @@ -123,7 +127,7 @@ rexec/rexecd コマンドが失敗しました。 .It Sy Try again. サーバによる -.Xr fork +.Xr fork 2 が失敗しました。 .It Sy : ... ユーザのログインシェルが起動できませんでした。このメッセージは diff --git a/ja/man/man8/rlogind.8 b/ja/man/man8/rlogind.8 index d0149428c0..228f16d921 100644 --- a/ja/man/man8/rlogind.8 +++ b/ja/man/man8/rlogind.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rlogind.8 8.1 (Berkeley) 6/4/93 +.\" %Id: rlogind.8,v 1.4.2.3 1998/02/18 11:48:06 markm Exp % .\" jpman %Id: rlogind.8,v 1.2 1997/05/23 00:50:03 mutoh Stab % -.\" %Id: rlogind.8,v 1.4.2.1 1996/12/22 23:05:33 mpp Exp % .\" .Dd June 4, 1993 .Dt RLOGIND 8 @@ -40,17 +40,17 @@ .Nm rlogind .Nd リモートログインのサーバ .Sh 書式 -.Nm rlogind +.Nm .Op Fl Daln .Sh 解説 -.Nm rlogind +.Nm は、 .Xr rlogin 1 のためのサーバです。サーバは信頼できるホストからの 特権ポート番号に基づいた認証を用いて、リモートログイン機能を提供します。 -.Nm rlogind +.Nm では、以下のオプションが使用可能です。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl D TCP_NODELAY ソケットオプションを設定します。これは、いくつかの ネットワークトラフィックの増大に対して、応答性を向上します。 @@ -66,20 +66,21 @@ TCP_NODELAY .El .Pp Kerberos を使っている時には、以下のようなオプションが利用可能です。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl k Kerberos 認証を利用可能にします。 .It Fl v vacuous モードを利用可能にします。 .It Fl x -.Nm rlogin +.Xr rlogin 1 セッションで流される全てのデータに .Tn DES 暗号化を施します。このオプションを利用すると、応答性や CPU に負荷が かかりますが、機密性は向上します。 .El .Pp -rlogind は、 login サービスの仕様に基づく番号のポートで、要求を受け付けます。 +.Nm +は、``login'' サービスの仕様に基づく番号のポートで、要求を受け付けます。 詳しくは .Xr services 5 を参照してください。 @@ -107,7 +108,7 @@ rlogind .El .Pp 要求元ポートの番号を調べ終えたら、 -.Nm rlogind +.Nm は、 .Xr rshd 8 で説明している認証作業を開始します。 @@ -131,7 +132,7 @@ rlogind .Pp ログインプロセスの親プロセスは、疑似ターミナルのマスター側を操作します。 すなわちログインプロセスと、クライアント側の -.Xr rlogin +.Xr rlogin 1 プログラムを実体化したものとの間で処理を行います。 通常の処理においては、 .Ql ^S/^Q @@ -155,12 +156,16 @@ rlogind 通信不能になってしまった時に、セッションをタイムアウトで 終了することが可能になります。 .Sh 診断 -すべての診断メッセージは、ネットワーク接続が切断された後に、最初に 1 の値が -付加されて通知されます。ログインが起動された後にエラーが発生しない場合、 +すべての診断メッセージは、ネットワーク接続が切断された後に、最初に 1 の値 +のバイトが付加されて通知されます。 +.Xr login 1 +が起動された後にエラーが発生しない場合、 処理成功の通知のために、NULL バイトを返します。 .Bl -tag -width Ds .It Sy Try again. -サーバが fork に失敗したことを表します。 +サーバが +.Xr fork 2 +に失敗したことを表します。 .El .Sh 関連項目 .Xr login 1 , @@ -178,7 +183,7 @@ rlogind .Sh バグ このコマンドが用いている認証手続きは、それぞれのクライアントマシンと 接続媒体が完全であるということを仮定したものです。これはセキュリティホールに -なりやすいのですが、「オープン」な環境においては有用な方針です。 +なりやすいのですが、``オープン'' な環境においては有用な方針です。 .Pp 全てのデータについて暗号化を行なう機能が実装されるべきです。 .Pp diff --git a/ja/man/man8/rpc.rquotad.8 b/ja/man/man8/rpc.rquotad.8 index 4d09183fb7..dce03b7195 100644 --- a/ja/man/man8/rpc.rquotad.8 +++ b/ja/man/man8/rpc.rquotad.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: rpc.rquotad.8,v 1.1.1.1.2.1 1997/03/14 06:10:09 mpp Exp % +.\" %Id: rpc.rquotad.8,v 1.1.1.1.2.2 1997/12/17 07:31:27 charnier Exp % .\" jpman %Id: rpc.rquotad.8,v 1.3 1997/09/04 17:40:03 horikawa Stab % .\" .Dd June 22, 1994 @@ -39,7 +39,7 @@ .Sh 書式 .Nm /usr/libexec/rpc.rquotad .Sh 解説 -.Nm rpc.rquotad +.Nm は、リモートマシンへ NFS マウントされているファイルシステムについて ユーザに対するローカルマシンでの割り当て制限値を返す .Xr rpc 3 @@ -47,18 +47,20 @@ .Xr quota 1 は、リモートファイルシステムの割り 当て制限値を表示するために本サーバを用います。 -.Nm rpc.rquotad +.Nm は通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rquotad +.Nm .Pa /usr/include/rpcsvc/rquota.x -で定義される RPC プロトコルを使用します。 +で定義される +.Tn RPC +プロトコルを使用します。 .Sh バグ .Bx 4.4 と -.Tn FreeBSD +.Bx Free はグループに対する割り当て制限をサポートしていますが、 rqutoa プロトコルはこれをサポートしていません。 .Sh 関連項目 diff --git a/ja/man/man8/rpc.rstatd.8 b/ja/man/man8/rpc.rstatd.8 index f7194242f7..e34c1dd854 100644 --- a/ja/man/man8/rpc.rstatd.8 +++ b/ja/man/man8/rpc.rstatd.8 @@ -31,10 +31,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rstatd.8,v 1.1.1.1 1994/08/28 14:49:04 csgr Exp % +.\" %Id: rpc.rstatd.8,v 1.1.1.1.8.1 1997/12/17 07:33:09 charnier Exp % .\" -.Dd June 7, 1993 .\" jpman %Id: rpc.rstatd.8,v 1.2 1997/05/22 08:05:12 mitchy Stab % +.Dd June 7, 1993 .Dt RPC.RSTATD 8 .Os BSD 4.3 .Sh 名称 @@ -43,21 +43,22 @@ .Sh 書式 .Nm /usr/libexec/rpc.rstatd .Sh 解説 -.Nm rpc.rstatd +.Nm はカーネルから性能統計を取得するサーバーです。 この統計は、 .Xr rup 1 コマンドを使って読むことができます。 -.Nm rpc.rstatd +.Nm デーモンは通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rstatd +.Nm は .Pa /usr/include/rpcsvc/rstat.x -で定義された RPC プロトコルを使用します。 +で定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rup 1 , .Xr inetd 8 - diff --git a/ja/man/man8/rpc.rusersd.8 b/ja/man/man8/rpc.rusersd.8 index 0a52dad0bc..0421c53187 100644 --- a/ja/man/man8/rpc.rusersd.8 +++ b/ja/man/man8/rpc.rusersd.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rusersd.8,v 1.1.1.1 1994/08/28 14:53:44 csgr Exp % +.\" %Id: rpc.rusersd.8,v 1.1.1.1.8.1 1997/12/17 07:34:41 charnier Exp % .\" jpman %Id: rpc.rusersd.8,v 1.2 1997/05/22 08:10:18 mitchy Stab % .\" .Dd June 7, 1993 @@ -43,22 +43,24 @@ .Sh 書式 .Nm /usr/libexec/rpc.rusersd .Sh 解説 -.Nm rpc.rusersd +.Nm は、システムに現在ログインしているユーザに関する情報を 返すサーバです。 .Pp 現在ログインしているユーザについて、 .Xr rusers 1 を用いることで問い合わせることが出来ます。 -.Nm rpc.rusersd +.Nm デーモンは、通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rusersd +.Nm は、 .Pa /usr/include/rpcsvc/rnusers.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rusers 1 , .Xr who 1 , diff --git a/ja/man/man8/rpc.rwalld.8 b/ja/man/man8/rpc.rwalld.8 index 7f63f2f875..26d348165d 100644 --- a/ja/man/man8/rpc.rwalld.8 +++ b/ja/man/man8/rpc.rwalld.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rwalld.8,v 1.1.1.1 1994/08/28 14:58:36 csgr Exp % +.\" %Id: rpc.rwalld.8,v 1.1.1.1.8.1 1997/12/17 07:36:28 charnier Exp % .\" jpman %Id: rpc.rwalld.8,v 1.2 1997/05/22 08:15:10 mitchy Stab % .\" .Dd June 7, 1993 @@ -42,25 +42,38 @@ .Nd ログインしているユーザにメッセージを送るためのサーバ .Sh 書式 .Nm /usr/libexec/rpc.rwalld +.Op Fl n .Sh 解説 -.Nm rpc.rwalld +.Nm は、システムにログインしている全てのユーザに対して メッセージを送るためのサーバです。本サーバは .Xr wall 1 を起動し、メッセージの送信を行ないます。 .Pp +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl n +デーモンになりません。 +.Nm +が +.Xr inetd 8 +から起動された場合のみ、本オプションを使用可能です。 +.El +.Pp メッセージは、 .Xr rwall 1 コマンドを用いて本サーバに送信されます。 -.Nm rpc.walld +.Nm デーモンは、通常は .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rwalld +.Nm は、 .Pa /usr/include/rpcsvc/rwall.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rwall 1 , .Xr wall 1 , diff --git a/ja/man/man8/rpc.sprayd.8 b/ja/man/man8/rpc.sprayd.8 index ba23cbafee..f55f880378 100644 --- a/ja/man/man8/rpc.sprayd.8 +++ b/ja/man/man8/rpc.sprayd.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: rpc.sprayd.8,v 1.2 1996/04/07 00:05:54 mpp Exp % +.\" %Id: rpc.sprayd.8,v 1.2.2.1 1997/12/17 07:38:17 charnier Exp % .\" jpman %Id: rpc.sprayd.8,v 1.3 1997/09/04 17:42:05 horikawa Stab % .\" .Dd June 22, 1994 @@ -39,19 +39,21 @@ .Sh 書式 .Nm /usr/libexec/rpc.sprayd .Sh 解説 -.Nm rpc.sprayd +.Nm は、 .Xr spray 8 コマンドによって送出されたパケットを記録し、パケットの送出者に ネットワークトラフィックの情報を送信するサーバです。 -.Nm rpc.sprayd +.Nm は、通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.sprayd +.Nm は、 .Pa /usr/include/rpcsvc/spray.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr spray 8 diff --git a/ja/man/man8/rpc.yppasswdd.8 b/ja/man/man8/rpc.yppasswdd.8 index 2c0c3f4b66..6e83ed91f9 100644 --- a/ja/man/man8/rpc.yppasswdd.8 +++ b/ja/man/man8/rpc.yppasswdd.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.yppasswdd.8,v 1.4.2.1 1997/03/06 08:00:02 mpp Exp % +.\" %Id: rpc.yppasswdd.8,v 1.4.2.2 1997/11/05 07:37:00 charnier Exp % .\" jpman %Id: rpc.yppasswdd.8,v 1.3 1997/08/31 14:17:34 horikawa Stab % .\" .Dd February 8, 1996 @@ -51,14 +51,14 @@ .Op Fl u .Op Fl h .Sh 解説 -.Nm rpc.yppasswdd +.Nm デーモンは、ユーザが .Xr yppasswd 1 と .Xr ypchpass 1 コマンド使うことで、 NIS パスワードおよび他の情報を変更することを許します。 -.Nm rpc.yppasswdd +.Nm は、パスワードの変更要求を受け入れ、その認証を行い、 .Pa /var/yp/master.passwd ファイル中に更新された情報を配置し、 @@ -68,7 +68,7 @@ NIS .Pa passwd マップを更新する、 RPC を使ったサーバです。 .Pp -.Nm rpc.yppasswdd +.Nm は、普通の NIS ユーザが、自分の NIS パスワード・ ('GECOS'フィールドとして知られている)フルネーム・シェルを変更することを許します。 これらの更新は、典型的には @@ -86,7 +86,7 @@ NIS 規則 (securenets に関する詳細な情報は .Xr ypserv 8 のマニュアルページを参照してください。 -.Nm rpc.yppasswdd +.Nm サーバは、 .Xr ypserv 8 と同じアクセス制御機構を使います。)に照らして、 @@ -106,8 +106,9 @@ NIS .Pa /var/yp/Makefile に渡されます。) .Pp -FreeBSD 版の -.Nm rpc.yppasswdd +.Bx Free +版の +.Nm は、NIS マスタサーバ上のスーパユーザが NIS パスワードマップを更新するための より洗練された方法を提供します。スーパユーザは任意のドメインの 任意のユーザの master.passwd エントリの任意のフィールドを変更できます。 @@ -121,17 +122,15 @@ FreeBSD また、これは、 NIS マスタサーバ上のスーパユーザだけに適用されます。 これらの特別な機能はネットワークを介しては提供されません。 .Pp -.Nm rpc.yppasswdd +.Nm デーモンは、 NIS マスタサーバである機械上でだけ実行することが できます。 .Sh オプション -以下のオプションとフラグが、 -.Nm rpc.yppasswdd -で提供されています。 -.Bl -tag -width flag +以下のオプションが使用可能です: +.Bl -tag -width indent .It Fl t Ar master.passwd template file デフォルトでは、 -.Nm rpc.yppasswdd +.Nm は、デフォルトドメインの .Pa master.passwd と @@ -145,13 +144,13 @@ FreeBSD (注意): このフラグとともに指定されたテンプレートファイルが .Pa /etc/master.passwd である場合、 -.Nm rpc.yppasswdd +.Nm は NIS のマップに加えてローカルのパスワードデータベースを 再構成するために、自動的に .Xr pwd_mkdb 8 を呼び出します。 .It Fl d Ar domain -.Nm rpc.yppasswdd +.Nm サーバは複数のドメインを扱うことができますが、一つのドメインを デフォルトとして選ばなければなりません。 .Xr domainname 1 @@ -178,7 +177,7 @@ NIS .Pa master.passwd マップエントリのどんなフィールドでも、無制限の変更を行うことが 許されています。 -.Nm rpc.yppasswdd +.Nm がこのフラグを付けて実行された場合、 .Xr chpass 1 を使用したローカルパスワードデータベース更新にて可能であるのと同様に、 @@ -187,11 +186,12 @@ NIS マルチドメインモードを有効にします。 .Xr ypserv 8 は同時にいくつかのドメインを扱うことができますが、ほとんどの -.Nm rpc.yppasswdd +.Nm 実装では、一つの NIS ドメインだけしか扱うことができません。 これは、一般に NIS マスタサーバのシステムデフォルトドメインと同じです。 -FreeBSD の -.Nm rpc.yppasswdd +.Bx Free +の +.Nm は、 .Pa yppasswd プロトコルでは @@ -200,7 +200,7 @@ FreeBSD プロトコル固有の制限にもかかわらず、 この問題を解決しようとしています。 マルチドメインモードでは、 -.Nm rpc.yppasswdd +.Nm は .Pa /var/yp 下の全ドメインの全パスワードマップを検索し、 @@ -237,7 +237,7 @@ FreeBSD したがって、偏執的な管理者はマルチドメインモードを利用不可能にしたいと 思うでしょう。 .It Fl i -.Nm rpc.yppasswdd +.Nm がこのフラグ付きで呼び出された場合、マップ更新をその場で行おうとします。 この意味は、 パスワードテンプレートファイルを直接更新してマップ更新する代わりに、 @@ -258,7 +258,7 @@ FreeBSD たくさんの商用の .Xr yppasswd 1 クライアントは、 -.Nm rpc.yppasswdd +.Nm への要求を送る時に予約ポートを使いません。 これは、 .Xr yppasswd 1 @@ -266,27 +266,27 @@ FreeBSD スーパユーザのためにクライアント接続が確立されたとき、 予約ポートを割り当てることをしないようになっているためです。 デフォルトでは、 -.Nm rpc.yppasswdd +.Nm は、クライアントからの結果を予約ポートを使って受け取ることを期待します。 非特権ポートから受け取った要求は、排除されます。不幸にして、この振舞いは 特権ポートを使えないクライアントシステムからのパスワード更新要求を妨げます。 .Fl u フラグを指定することで、 -.Nm rpc.yppasswdd +.Nm は、特権ポートを使えない .Xr yppasswd 1 でも働くように、特権ポートのチェックを無効にします。 これは、少しセキュリティを低下させますが、クライアントの振舞いを 変更できない場合には必要になるでしょう。 .It Fl h -.Nm rpc.yppasswdd +.Nm が理解できるフラグやオプションのリストを表示します。 .El .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /usr/libexec/yppwupdate NIS マップを更新し、その後でプッシュするために、 -.Nm rpc.yppasswdd +.Nm によって呼び出されるスクリプトです。 .It Pa /var/yp/master.passwd デフォルトドメインのためのテンプレートパスワードファイルです。 @@ -306,7 +306,7 @@ yppasswd.x YPPASSWDPROC_UPDATE プロシジャは二つの引数を取ります。 更新するユーザ情報を含む V7 形式のパスワード構造および、 ユーザの暗号化されない (クリアテキスト) パスワードです。 -.Nm rpc.yppasswdd +.Nm はリモートの NIS クライアントマシンからの更新要求を扱うことを 仮定しています。これは、 .Xr yppasswd 1 @@ -323,4 +323,4 @@ YPPASSWDPROC_UPDATE 途中でとらえられ、 そのユーザアカウントに対する不正アクセスに使用されるかも知れません。 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/rshd.8 b/ja/man/man8/rshd.8 index 84130eb419..bd52178f20 100644 --- a/ja/man/man8/rshd.8 +++ b/ja/man/man8/rshd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: rshd.8,v 1.4.2.1 1997/05/10 21:41:51 davidn Exp % +.\" %Id: rshd.8,v 1.4.2.3 1998/02/18 11:52:19 markm Exp % .\" jpman %Id: rshd.8,v 1.4 1997/08/10 18:35:56 horikawa Stab % .\" .Dd June 4, 1993 @@ -43,17 +43,17 @@ .Nm rshd .Op Fl alnL .Sh 解説 -.Nm rshd +.Nm は、 .Xr rcmd 3 ルーチンのためのサーバであり、結果として .Xr rsh 1 の実行のために必要となるサーバです。 -.Nm rshd +.Nm は、信頼できるホストからの特権ポート番号に基づいた 認証を行なうことによって、プログラムのリモート実行機能を提供します。 .Pp -.Nm rshd +.Nm サーバは、``cmd'' サービスに割り当てられたポート ( .Xr services 5 参照) でサービス要求を受け付けます。サービス要求を受信すると、 @@ -64,7 +64,9 @@ 要求元ポート番号 が 512 から 1023 の範囲にない場合、サーバは接続を強制切断します。 .It -サーバは、ソケットからヌルバイト (`\e0') を検出するまで文字を読みます。 +サーバは、ソケットから +.Tn ヌル +バイト (`\e0') を検出するまで文字を読みます。 受信文字列は、 .Tn ASCII コードによる 10 進数の数値に変換します。 @@ -105,7 +107,7 @@ コマンドを取得します。コマンド長の制限は、システムの引数リスト サイズの上限に依存します。 .It -.Nm rshd +.Nm は、 .Pa /etc/hosts.equiv および当該ユーザのホームディレクトリ上に存在する @@ -114,22 +116,29 @@ .Xr ruserok 3 を使用して、ユーザ認証を行います。 .Fl l -オプションは、ユーザがスーパユーザでない限り、``.rhosts'' ファイルに基づいた +オプションは、ユーザがスーパユーザでない限り、 +.Pa .rhosts +ファイルに基づいた .Xr ruserok 3 のすべての認証をおこなわないようにします。 .It .Pa /etc/nologin ファイルが存在し、ユーザがスーパユーザでない場合、接続を 切断します。 -nologin ファイルの名前に関しては、login.conf にて -ローカルユーザのログインクラスに関する nologin= ケーパビリティが優先します。 +nologin ファイルの名前に関しては、 +.Pa login.conf +にて +ローカルユーザのログインクラスに関する nologin ケーパビリティが優先します。 ログインクラスは、ログイン時間(times.allow と times.denny ケーパビリティ) およびリモートホスト(hosts.allow と hosts.denny ケーパビリティ)による -rsh アクセスの制限にも使われます。 +.Xr rsh 1 +アクセスの制限にも使われます。 .It -最初のソケットを用いてヌルバイトを返し、コマンドライン +最初のソケットを用いて +.Tn ヌル +バイトを返し、コマンドライン を、ユーザの通常のログインシェルに渡します。シェルは -.Nm rshd +.Nm によって確立されたネットワーク接続を継承します。 .El .Pp @@ -157,26 +166,28 @@ rsh クライアントマシン上のユーザ名が、16 文字を超えています。 .It Sy Ruser too long. リモートマシン上のユーザ名が、16 文字を超えています。 -.It Sy Command too long . +.It Sy Command too long. 渡されたコマンドラインの長さが、引数リストの大きさを超えています (システムに依存します)。 .It Sy Login incorrect. -当該ユーザに関するエントリが、パスワードファイルに登録されていません。 +当該ユーザに関するエントリが、パスワードファイルに登録されていないか、 +上述の認証手続きに失敗しました。 .It Sy Remote directory. ホームディレクトリへの -.Xr chdir -コマンドが失敗しました。 -.It Sy Permission denied. -前述の認証手続きが失敗しました。 +.Xr chdir 2 +巻数が失敗しました。 .It Sy Logins not available right now. -ローカルユーザのログインクラスに対する login.conf において、 -許された時間以外で rsh が試されました。 +ローカルユーザのログインクラスに対する +.Pa login.conf +において、許された時間以外で +.Xr rsh 1 +が試されました。 .It Sy Can't make pipe. .Em 標準エラー出力 に必要なパイプを作成できませんでした。 .It Sy Can't fork; try again. サーバによる -.Xr fork +.Xr fork 2 が失敗しました。 .It Sy : ... ユーザのログインシェルを起動できませんでした。本メッセージの出力は @@ -201,6 +212,7 @@ rsh .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .It Pa /etc/hosts.equiv +.It Pa /etc/login.conf .It Pa $HOME/.rhosts .It Pa /etc/nologin .El diff --git a/ja/man/man8/rstat_svc.8 b/ja/man/man8/rstat_svc.8 index 3ff2207b9e..63c4caea02 100644 --- a/ja/man/man8/rstat_svc.8 +++ b/ja/man/man8/rstat_svc.8 @@ -10,7 +10,7 @@ rstat_svc \- .B rstat_svc は、 カーネルから得られた性能統計を返すサーバです。 -これらの統計値はサン・マイクロシステムズのプログラム、 +これらの統計値は Sun Microsystems のプログラム、 .BR perfmeter (1) によってグラフで表示されます。 .B rstat_svc diff --git a/ja/man/man8/scsi.8 b/ja/man/man8/scsi.8 index 880001cd6e..95e68e3f25 100644 --- a/ja/man/man8/scsi.8 +++ b/ja/man/man8/scsi.8 @@ -39,7 +39,7 @@ .\" SUCH DAMAGE. .\" .\" -.\" %Id: scsi.8,v 1.6.2.4 1997/09/14 19:48:25 jkh Exp % +.\" %Id: scsi.8,v 1.6.2.6 1998/01/03 10:12:33 brian Exp % .\" jpman %Id: scsi.8,v 1.3 1997/07/22 16:40:11 horikawa Stab % .\" .Dd October 11, 1993 @@ -86,6 +86,19 @@ プログラムはコマンドを scsi 装置に送るのに使われます。 また、ユーザレベル SCSI コマンドの使用例でもあります。 .Pp +.Fl f +オプションを指定し、 +.Ar device +で SCSI デバイス名を指定する必要があります。デバイスがディスクデバイスの場合、 +制御デバイス +.Pq 例えば Pa /dev/rsd0.ctl +である必要があります。 +現在有効なデバイスが接続されていないバスで再プローブを行うために、 +.Sq super scsi +デバイスを +.Fl p +オプションで指定することができます。 +.Pp .Fl d オプションは SCSI カーネルデバッグレベルを設定します。 カーネルは、 @@ -141,11 +154,13 @@ BEL 文 で指定したエディタを使います。 恒久的に変更を格納するためには .Fl P -フラグを使用してページ制御 3 を編集します。 +オプションを使用してページ制御 3 を編集します。 .Pp .Fl p -オプションは "super scsi" 装置 -.Pa /dev/scsi/super +オプションは +.Sq super scsi +装置 +.Pa /dev/ssc に対して 指定した SCSI バスと指定した SCSI lun を持つ全ての装置をプローブするのに 使われます。 @@ -155,23 +170,11 @@ BEL 文 lun は .Fl l オプションで選択でき、デフォルトは 0 です。 -"super scsi" 装置の説明は -.Xr scsi 4 -を参照してください。 .Pp .Fl r -オプションは -.Tn FreeBSD -1.1 で、バス、ターゲット、lun が指定された特定の SCSI 装置を再プローブするのに -使われます。 -.Tn FreeBSD -2.1 では、 -固定 SCSI 装置をオープンすると、その装置を再プローブするという副作用があり、 -また -.Fl p -オプションで、バスのプローブを行なうと新しく発見された装置を -接続するので、 -これは不用です。 +オプションは、 +ブート時に存在した全 SCSI バスから全 SCSI デバイスを再プローブするために +使用できます。 固定 SCSI 装置の説明は .Xr scsi 4 を参照して下さい。 @@ -249,25 +252,29 @@ ioctl .Pa /dev/rsd0c の装置タイプが 0 (ダイレクトアクセス装置) であると確認する: -.Bd -literal -root# scsi -f /dev/rsd0c -c "12 0 0 0 64 0" -i 64 "*b3 b5" -0 +.Bd -literal -offset indent +root# scsi -f /dev/rsd0c -c "12 0 0 0 40 0" -i 64 "*b3 b5" 0 .Ed .Pp .Pa /dev/rsd2c に inquiry を行なう: -.Bd -literal -root# scsi -f /dev/rsd2c -c "12 0 0 0 64 0" 0x40 -i 64 "s8 z8 z16 z4" -FUJITSU M2654S-512 010P +.Bd -literal -offset indent +root# scsi -f /dev/rsd2c -c "12 0 0 0 v 0" 0x40 -i 64 \e +"s8 z8 z16 z4" FUJITSU M2654S-512 010P .Pp .Pa /dev/rsd2c のモードページ 1 (リードライトエラー回復ページ; Read-Write Error Recovery Page) を編集し、装置に永久的に格納する: -.Bd -literal +.Bd -literal -offset indent root# scsi -f /dev/rsd2c -m 1 -e -P 3 .Ed .Pp +最初の SCSI バスで簡単に再プローブを行う: +.Bd -literal -offset indent +root# scsi -f /dev/ssc -p +.Ed +.Pp .Sh 環境変数 .Ev SU_DEBUG_OUTPUT 変数にファイルを設定して、 @@ -288,7 +295,8 @@ root# scsi -f /dev/rsd2c -m 1 -e -P 3 変数はモードエディタで使うエディタを決定します。 .Sh 関連項目 .Xr scsi 3 , -.Xr scsi 4 +.Xr scsi 4 , +.Xr ssc 4 .Sh バグ .Pp いくつかの装置は全部の LUN で inquiry に応答します。 diff --git a/ja/man/man8/shutdown.8 b/ja/man/man8/shutdown.8 index 85c8681fd6..72eb1ce1ec 100644 --- a/ja/man/man8/shutdown.8 +++ b/ja/man/man8/shutdown.8 @@ -37,7 +37,7 @@ .Os BSD 4 .Sh 名称 .Nm shutdown -.Nd 指定時間後にシステムを停止する +.Nd 指定時刻にシステムを停止する .Sh 書式 .Nm shutdown .Op Fl @@ -46,11 +46,12 @@ .Op Ar warning-message ... .Sh 解説 .Nm shutdown -は、ユーザにシステムがシャットダウンされる時にユーザに知らせ、 -システム管理者やハッカーやグルのようなたの人を面倒がらせないように -します。 +は、自動的にシャットダウンするための手順をスーパユーザに提供します。 +システムがシャットダウンされるときユーザに知らせるので、 +こういったお知せを面倒がって行なわない +システム管理者やハッカーやグルといった人々から、ユーザを救います。 .Pp -オプションとしては以下のものがあります。 +以下の親切なオプションがあります: .Bl -tag -width time .It Fl h .Ar time @@ -58,15 +59,16 @@ .Xr halt 8 を実行し、システムを停止します。 .It Fl k +全ユーザを追い出します。 実際にはシステムを停止しませんが、 -スーパーユーザ以外のユーザをログインできなくします。 +マルチユーザシステムのままでスーパユーザ以外のユーザをログインできなくします。 .It Fl n -停止する前に +停止する前に、通常実行される .Xr sync 2 を実行しません。 .It Fl r .Ar time -で指定された時間に +で指定した時刻に .Xr reboot 8 を実行し、システムを再起動します。 .It Ar time @@ -74,11 +76,11 @@ がシステムを停止させる時間を指定します。 .Ar now を指定すると即時にシステムを停止します。 -また、時間を指定する次の二つの書式があります。 +また、時間を指定する次の二つの書式があります: .Ar +number もしくは .Ar yymmddhhmm -の形式で指定します。現在のシステムの年・月・日の値がデフォルトになっています。 +の形式です。現在のシステムの年・月・日の値がデフォルトになっています。 一つめの書式は .Ar number 分経過後をあらわし、二つめの書式は停止する時刻を直接指定します。 @@ -90,8 +92,8 @@ がオプションとして与えられると、警告メッセージを標準入力から読み取ります。 .El .Pp -システム停止の 10 時間前から、ログイン中の全てのユーザーの端末に -警告メッセージが表示されはじめ、停止が近付くにつれ頻繁になってきます。 +システム停止の 10 時間前から、ログイン中の全てのユーザの端末に +警告メッセージが表示されはじめ、終末が近付くにつれ頻繁になってきます。 システム停止の 5 分前、もしくは 5 分以内にシステム停止する場合には、 ただちに警告メッセージをコピーした .Pa /etc/nologin diff --git a/ja/man/man8/slstat.8 b/ja/man/man8/slstat.8 index d4c190a53d..c978b9c8ca 100644 --- a/ja/man/man8/slstat.8 +++ b/ja/man/man8/slstat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)slstat.8 6.8 (Berkeley) 6/20/91 -.\" %Id: slstat.8,v 1.6.2.2 1997/03/06 08:00:20 mpp Exp % +.\" %Id: slstat.8,v 1.6.2.3 1997/11/06 07:40:40 charnier Exp % .\" jpman %Id: slstat.8,v 1.2 1997/05/24 05:28:27 mitchy Stab % .\" .Dd October 11, 1996 @@ -45,7 +45,7 @@ .Op Fl vr .Op Ar unit .Sh 解説 -.Nm slstat +.Nm はシリアル回線インターネットプロトコル (SLIP) のトラフィックに関連する カーネルの統計情報を表示します。 .Pp diff --git a/ja/man/man8/spkrtest.8 b/ja/man/man8/spkrtest.8 index 1db177d3d2..51d5c43c26 100644 --- a/ja/man/man8/spkrtest.8 +++ b/ja/man/man8/spkrtest.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: spkrtest.8,v 1.2.2.1 1997/03/06 08:00:22 mpp Exp % +.\" %Id: spkrtest.8,v 1.2.2.2 1997/11/07 07:19:03 charnier Exp % .\" jpman %Id: spkrtest.8,v 1.3 1997/08/16 13:43:02 horikawa Stab % .Dd May, 1995 @@ -50,4 +50,6 @@ .Sh 歴史 .Nm -スクリプトは FreeBSD 1.0 で登場しました。 +スクリプトは +.Fx 1.0 +で登場しました。 diff --git a/ja/man/man8/spray.8 b/ja/man/man8/spray.8 index 52523137b5..460f1af19d 100644 --- a/ja/man/man8/spray.8 +++ b/ja/man/man8/spray.8 @@ -21,8 +21,8 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd July 10, 1995 .\" jpman %Id: spray.8,v 1.3 1997/07/22 16:59:25 horikawa Stab % +.Dd July 10, 1995 .Dt SPRAY 8 .Os FreeBSD .Sh 名称 @@ -34,8 +34,6 @@ .Op Fl d Ar delay .Op Fl l Ar length .Ar host -\&... -.Ek .Sh 解説 .Nm spray は複数の RPC パケットを @@ -66,8 +64,7 @@ RPC .Nm spray は、ネットワークのテストや計測や管理のための利用を想定しています。 このコマンドは、 -.Bf -emphasis -ネットワークにとても負荷をかけますので、利用には注意してください。 +.Em "ネットワークにとても負荷をかけますので、利用には注意してください。" .Ef .Pp .Sh 関連項目 diff --git a/ja/man/man8/sysctl.8 b/ja/man/man8/sysctl.8 index b8672baacc..976a549cdc 100644 --- a/ja/man/man8/sysctl.8 +++ b/ja/man/man8/sysctl.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 -.\" %Id: sysctl.8,v 1.10.2.1 1997/08/30 14:11:21 kato Exp % +.\" %Id: sysctl.8,v 1.10.2.2 1997/11/07 07:27:11 charnier Exp % .\" jpman %Id: sysctl.8,v 1.2 1997/05/30 00:57:58 yugawa Stab % .\" .Dd September 23, 1994 @@ -51,35 +51,31 @@ .Op Fl bn .Fl aAX .Sh 解説 -.Nm sysctl +.Nm はカーネル状態を取り出し、適切な権限があれば プロセスがカーネル状態を設定することを許します。取り出され たり、設定されたりした状態は、``Management Information Base''(``MIB'') 形式を使って記述されます。この形式では、要素はドット ``.'' で 接続されます。 .Pp -.Fl a -フラグを使うと、現在有効な文字列や整数値 -をすべて表示します。 -.Pp -.Fl A -フラグでは、 -.Nm sysctl -がそのデータ形式を知らないもの(以下、形式不明の変数と称する) を含めて、 +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl a +現在有効な文字列や整数値をすべて表示します。 +.It Fl A +データ形式を知らないもの(以下、形式不明の変数と称する) を含めて、 存在している全ての MIB を表示します。 .Fl a フラグ同様、文字列や整数値も表示されます。 形式不明の変数に関しては、 そのフォーマットおよび長さに関する情報と、その変数の内容の最初の数バイトを 16 進数でダンプします。 -.Pp -.Fl X +.It Fl X フラグは、形式不明の変数の全ての内容が 16 進数でダンプされる以外は .Fl A と同じです。 -.Pp -.Fl n -フラグをつけると、フィールド名の出力は抑制されて、値 +.It Fl n +フィールド名の出力は抑制されて、値 だけが表示されます。これはシェル変数を設定するのに役に 立ちます。たとえば、ページサイズを変数 psize に保存する には、以下のようにします: @@ -87,21 +83,23 @@ set psize=`sysctl -n hw.pagesize` .Ed .Pp -.Fl b -フラグをつけると、変数の値を加工せずに、バイナリ形式で表示します。 +.It Fl b +変数の値を加工せずに、バイナリ形式で表示します。 変数名や、最後の改行文字は出力されません。これは、単一の変数に対して 操作する際に便利でしょう。 -.Pp -MIB 形式の名前だけを指定すると、その名前に対応する -値が得られます。値を設定するには -.Fl w -フラグを用い、MIB 名 -のあとにイコール記号 ``='' をつけて、そのあとに設定する新 -しい値を指定します。 -.Pp -.Nm sysctl +.It Fl w Ar name=value ... +MIB の +.Ar name +を新しい値 +.Ar value +に設定します。 +MIB 形式 +.Ar name +だけが指定された場合、その名前に対応する値が得られます。 +.El +.Nm で得られる情報は、整数、文字列、形式不明の変数です。 -.Nm sysctl +.Nm はいくつかの形式不明の変数の形式を知っているだけで、それ以外のものに 対しては 16 進ダンプに頼ります。 形式不明の変数の情報は、 @@ -180,7 +178,6 @@ changeable .El .Pp .Sh 使用例 -.Pp たとえば、システム中で許されている最大のプロセス数を知りたい ときは、以下のようにします: .Bd -literal -offset indent -compact @@ -231,7 +228,7 @@ sysctl vm.loadavg .Xr sysctl 3 .Sh バグ 現状では -.Nm sysctl +.Nm は、sysctl ツリーの追跡、および、形式と名前の情報を得る際に、 文書化されていないカーネルの sysctl 機能へのインタフェースを使用しています。 この方法に関する正しいインタフェースは、現在検討中です。 diff --git a/ja/man/man8/syslogd.8 b/ja/man/man8/syslogd.8 index 96486e7cee..478b37b740 100644 --- a/ja/man/man8/syslogd.8 +++ b/ja/man/man8/syslogd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 -.\" %Id: syslogd.8,v 1.6.2.4 1997/09/19 22:27:26 brian Exp % +.\" %Id: syslogd.8,v 1.6.2.5 1997/11/07 07:30:40 charnier Exp % .\" jpman %Id: syslogd.8,v 1.3 1997/05/19 17:08:30 horikawa Stab % .\" .Dd October 12, 1995 @@ -47,15 +47,15 @@ .Op Fl m Ar mark_interval .Op Fl p Ar log_socket .Sh 解説 -.Nm syslogd +.Nm はコンフィグレーションファイルに指定された通りに、システムコンソール、 ログファイル、他のマシンやユーザへのメッセージを読み込み、記録します。 オプションには以下のものがあります。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a Ar allowed_peer .Ar allowed_peer がこの -.Nm syslogd +.Nm に UDP データグラムを使用してログすることを許します。複数の .Fl a オプションを指定可能です。 @@ -104,9 +104,9 @@ UDP service 全てのホストから受け付けます。 .El .It Fl d -.Nm syslogd +.Nm をデバッグモードで実行します。これは恐らく、 -.Nm syslogd +.Nm の開発者にのみ役立ちます。 .It Fl f 代りのコンフィグレーションファイルのパス名を指定します。 @@ -126,14 +126,14 @@ UDP service ために listen しません。 .El .Pp -.Nm syslogd +.Nm は起動時とhangupシグナルを受けとった時はいつでもコンフィグレーションファ イルを読み込みます。 コンフィグレーションファイルのフォーマットに関する情報は、 .Xr syslog.conf 5 参照して下さい。 .Pp -.Nm syslogd +.Nm は .Tn UNIX ドメインソケット @@ -144,15 +144,15 @@ UDP service .Pa /dev/klog (カーネルメッセージを読むため）からメッセージを読み込みます。 .Pp -.Nm syslogd +.Nm はファイル .Pa /var/run/syslog.pid を作成し、プロセスIDを記録します。 これは -.Nm syslogd +.Nm のkillやコンフィグレーションファイルを読み込ませるために使えます。 .Pp -.Nm syslogd +.Nm に送られるメッセージは単一の行で構成されます。このメッセージは先頭に優 先順位コードを含んでいます。このコードは .Sq Aq 5 @@ -164,8 +164,8 @@ UDP service .It Pa /etc/syslog.conf コンフィグレーションファイル .It Pa /var/run/syslog.pid -動作している -.Nm syslogd +動作中の +.Nm のプロセスID .It Pa /var/run/log .Tn UNIX @@ -179,7 +179,7 @@ UDP service .Xr services 5 , .Xr syslog.conf 5 .Sh 歴史 -.Nm syslogd +.Nm コマンドは .Bx 4.3 から登場しました。 @@ -194,7 +194,7 @@ UDP service UDPパケットで受けとったメッセージを記録する能力は認証されていないディ スクを溢れさせるリモートサービスと等価であり、恐らくデフォルトで無効に されるべきです。ある種の -.Nm syslogd +.Nm 間の認証メカニズムが用意されるべきでしょう。 最悪の無駄遣いを避けるために、 .Fl a diff --git a/ja/man/man8/talkd.8 b/ja/man/man8/talkd.8 index 41d0ea879d..a176ca0257 100644 --- a/ja/man/man8/talkd.8 +++ b/ja/man/man8/talkd.8 @@ -59,10 +59,14 @@ 構造体のメッセージを送って、 接続の初期化を行います。すると、サーバはすでに呼び出し が行われているかどうか内部テーブルを検索します (相手はメッセージ -のなかで指定されています)。検索に失敗すると、クライアントは +のなかで指定されています)。 +.Pp +検索に失敗すると、クライアントは .Dv ANNOUNCE メッセージを送り、サーバに呼び出す相手のログイン端末に通知を -ブロードキャストさせて接続要求を行います。相手が応答すると、ローカル +ブロードキャストさせて接続要求を行います。 +.Pp +相手が応答すると、ローカル のサーバは内部テーブルの記録を用いて適切なアドレスで 接続を行い、呼び出し側と呼び出された側との間にストリーム型 の接続を確立して、そこで会話が行えるようにします。 diff --git a/ja/man/man8/telnetd.8 b/ja/man/man8/telnetd.8 index 2067c793ba..8af3dcc3bb 100644 --- a/ja/man/man8/telnetd.8 +++ b/ja/man/man8/telnetd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)telnetd.8 8.3 (Berkeley) 3/1/94 -.\" %Id: telnetd.8,v 1.5.2.1 1997/02/05 06:02:38 pst Exp % +.\" %Id: telnetd.8,v 1.5.2.2 1997/12/19 07:33:31 charnier Exp % .\" jpman %Id: telnetd.8,v 1.2 1997/05/12 08:14:57 yugawa Stab % .\" .Dd March 1, 1994 @@ -50,19 +50,19 @@ .Op Fl X Ar authtype .Op Fl a Ar authmode .Op Fl edebug -.Op Fl P Ar loginprog +.Op Fl p Ar loginprog .Op Fl r Ns Ar lowpty-highpty .Op Fl u Ar len .Op Fl debug Op Ar port .Sh 解説 -.Nm telnetd +.Nm コマンドは、 .Tn DARPA 標準 .Tn TELNET 仮想端末プロトコル をサポートするサーバです。 -.Nm telnetd +.Nm は、通常は .Pa /etc/services ファイル( @@ -76,59 +76,59 @@ オプションは、 .Xr inetd 8 の代わりに -.Nm telnetd +.Nm を手動で起動するために用いられます。 このように手動で起動された場合には、 代わりの .Tn TCP ポート番号で -.Nm telnetd +.Nm を動かすために .Ar port を指定する事ができます。 .Pp -.Nm telnetd +.Nm コマンドには以下のオプションがあります: -.Bl -tag -width "-a authmode" +.Bl -tag -width indent .It Fl a Ar authmode このオプションは、どのモードが認証に使われるかを指定するために用いられます。 このオプションは、 -.Nm telnetd +.Nm が .Dv AUTHENTICATION オプションをサポートする設定で構築された場合においてのみ役に立つことに 注意して下さい。 以下に示すようないくつかの .Ar authmode -があります。 +があります: .Bl -tag -width debug -.It debug +.It Cm debug 認証のデバッグコードを有効にします。 -.It user +.It Cm user リモートユーザは、自分自身であること示すための有効な認証情報を 提供した時にのみ接続が許可されます。 この場合、指定されたアカウントに対しては、パスワードの提供なしに接続が 許可されます。 -.It valid +.It Cm valid リモートユーザが自分自身であることを示すための有効な認証情報を 提供した時にのみ接続が許可されます。 リモートユーザが指定されたアカウントに対する自動的な接続が許可されて いなければ .Xr login 1 コマンドは、必要となるユーザ認証を実施します。 -.It other +.It Cm other ある種の認証情報を提供した場合のみ接続を許可します。 現在このオプションはすべての認証方法でサポートされていないため .Fl a .Cm valid オプションを指定した時と同じ動作をします。 -.It none +.It Cm none デフォルトではこの状態です。 認証情報は要求されません。 もし認証情報がなかったり不十分であれば、 .Xr login 1 プログラムによって必要となるユーザ認証を実施します。 -.It off +.It Cm off 認証コードを無効にします。 すべてのユーザ証明が .Xr login 1 @@ -136,7 +136,7 @@ .El .It Fl B bftp サーバモードを指定します。このモードでは -.Nm telnetd +.Nm は、login にユーザの通常のシェルではなく .Xr bftp 1 セッションを開始するように指示します。 @@ -147,13 +147,13 @@ bftp .It Fl D Ar debugmode このモードはデバックのために用いられます。 これによって -.Nm telnetd +.Nm がデバッグ情報を表示し、ユーザは -.Nm telnetd +.Nm が何をしているのかを見ることが許されます。 以下に示すようないくつかの .Ar debugmode -が可能です。 +が可能です: .Bl -tag -width exercise .It Cm options .Tn TELNET @@ -164,7 +164,7 @@ bftp どのような操作が行われているのかという、いくつかの付加的な情報が 表示されます。 .It Cm netdata -.Nm telnetd +.Nm が受け取ったデータストリームを表示します。 .It Cm ptydata pty に書かれたデータを表示します。 @@ -172,7 +172,7 @@ pty まだ実装されていません。 .El .It Fl debug -.Nm telnetd +.Nm によって作られたソケットについてのデバッグを可能にします ( .Xr socket 2 @@ -180,11 +180,11 @@ pty .Dv SO_DEBUG 参照)。 .It Fl edebug -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築されている場合に、 .Fl edebug オプションは、暗号化デバッグコードを可能にするために使われます。 -.It Fl P Ar loginprog +.It Fl p Ar loginprog ログインを完了する際に実行されるコマンドとして .Xr login 1 以外のコマンドを指定します。指定されたコマンドは通常の login と同じ引数を @@ -206,14 +206,14 @@ init です。 .It Fl k このオプションは、 -.Nm telnetd +.Nm が linemode と kludge linemode をサポートする設定で構築されている ときにのみ有効です。 .Fl k オプションが指定されている場合で、もしリモートのクライアントが .Dv LINEMODE オプションをサポートしていなければ、 -.Nm telnetd +.Nm は、 character at a time mode で動きます。 この様な状態でも kludge linemode をサポートしますが、リモートのクライアントが 要求した場合のみ kludge linemode になります @@ -239,7 +239,7 @@ line mode .It Fl n .Dv TCP keep-alives を行いません。通常、 -.Nm telnetd +.Nm は .Tn TCP keep-alive を有効にしています。なぜなら、クラッシュしたり、すでに接続 @@ -248,7 +248,7 @@ keep-alive 調べる必要があるからです。 .It Fl r Ar lowpty-highpty このオプションは、 -.Nm telnetd +.Nm が .Dv UNICOS 用に構築されている場合にのみ有効です。 @@ -267,7 +267,7 @@ keep-alive .Ar lowpty を省略した場合でも文字 - を省略する事は出来ません。 文字 - を省略してしまうと -.Nm telnetd +.Nm はそれが .Ar highpty であることを判断できずに @@ -275,7 +275,7 @@ keep-alive であると判断してしまうからです。 .It Fl s このオプションは、 -.Nm telnetd +.Nm が .Tn SecurID カードをサポートする設定で構築されている時にのみ有効です。 @@ -309,23 +309,23 @@ keep-alive ファイルに書き込まれるようにします。 .It Fl U このオプションは -.Nm telnetd +.Nm が、 .Xr gethostbyaddr 3 ルーチンを通して symbolic name にマップされないようなアドレスからの コネクションを拒絶するようにします。 .It Fl X Ar authtype このオプションは -.Nm telnetd +.Nm が認証オプションをサポートする設定で構築されたときにのみ有効です。 .Ar authtype 認証を使用不能にし、 -.Nm telnetd +.Nm を再コンパイルすることなしに 特定の認証タイプを一時的に使用不能にする事が出来ます。 .El .Pp -.Nm telnetd +.Nm は仮想端末デバイス( .Xr pty 4 参照)をクライアントに割り当てます。 @@ -335,7 +335,7 @@ keep-alive と .Dv stderr として仮想端末のスレーブ側を使用する login プロセスを生成します。 -.Nm telnetd +.Nm は、 .Tn TELNET プロトコルを実装し、 @@ -344,7 +344,7 @@ keep-alive .Pp .Tn TELNET セッションが開始されると -.Nm telnetd +.Nm は以下の .Tn TELNET オプションをクライアント側に送信して、これらの @@ -378,7 +378,7 @@ DO TIMING-MARK .Xr tty 4 参照) が有効な状態で操作するように設定されます。 .Pp -.Nm telnetd +.Nm は、ローカル側で有効な以下に示す .Tn TELNET オプションをサポートしています: @@ -427,19 +427,19 @@ DO TIMING-MARK .Tn TELNET セッションはシャットダウンされます。 .It "WILL ENCRYPT" -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築された場合のみ送信され、 データ列に対して暗号の復号するように指定します。 .El .Pp -.Nm telnetd +.Nm はリモート側で有効な以下に示す .Tn TELNET オプションをサポートしています: .Bl -tag -width "DO AUTHENTICATION" .It "DO BINARY" -.Tn telnetd -が8ビットのデータ列を受信するように指定します。 +.Nm telnetd +が 8 ビットのデータ列を受信するように指定します。 .It "DO LFLOW" クライアントがフロー制御文字をリモート側で処理するように指定します。 .It "DO ECHO" @@ -475,11 +475,11 @@ RFC 1572 RFC 1408 に示されている環境変数に関する情報を 要求できるように指定します。 .It "DO LINEMODE" -.Nm telnetd +.Nm が linemode をサポートする設定で構築された場合のみ送信され、 クライアントに行単位の処理を行う事を要求します。 .It "DO TIMING-MARK" -.Nm telnetd +.Nm が linemode および kludge linemode の両方をサポートする設定で 構築され、クライアントが .Dv WONT LINEMODE @@ -491,25 +491,24 @@ RFC 1408 .Op Fl k オプションによりこの機能を無効にする事ができます。 .It "DO AUTHENTICATION" -.Nm telnetd +.Nm が認証機能をサポートする設定で構築された場合のみ送信され、 自動ログインに使用する認証情報を受信するようにします。 .It "DO ENCRYPT" -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築された場合のみ送信され、 データ列に対して暗号の復号するように指定します。 -.Sh 環境 +.Sh 環境変数 .Sh ファイル -.Pa /etc/services -.br -.Pa /etc/inittab +.Bl -tag -width /usr/ucb/bftp -compact +.It Pa /etc/services +.It Pa /etc/inittab (UNICOS システムのみ) -.br -.Pa /etc/iptos +.It Pa /etc/iptos (サポートされている場合) -.br -.Pa /usr/ucb/bftp +.It Pa /usr/ucb/bftp (サポートされている場合) +.El .Sh "関連項目" .Xr bftp 1 , .Xr login 1 , @@ -568,7 +567,7 @@ Telnet Environment Option オリジナルの 4.2 BSD の .Xr telnet 1 のバグに対処するため、 -.Nm telnetd +.Nm は、ある種のあいまいなプロトコル変換を行うことにより、 リモートクライアントが実際に 4.2 BSD の .Xr telnet 1 @@ -580,7 +579,7 @@ Telnet Environment Option .Pp リモートクライアントから受け取った端末タイプの名前は小文字に変換されます。 .Pp -.Nm telnetd +.Nm は、 .Tn TELNET .Dv IAC GA diff --git a/ja/man/man8/tftpd.8 b/ja/man/man8/tftpd.8 index 6322ec2cfa..540ebf8fce 100644 --- a/ja/man/man8/tftpd.8 +++ b/ja/man/man8/tftpd.8 @@ -40,13 +40,13 @@ .Nd インターネット TFTP (Trivial File Transfer Protocol) サーバ .Sh 書式 -.Nm tftpd +.Nm /usr/libexec/tftpd .Op Fl l .Op Fl n .Op Fl s Ar directory .Op Ar directory ... .Sh 解説 -.Nm tftpd +.Nm は、インターネット TFTP プロトコル ( .Tn RFC 783 ) を提供するサーバです。 @@ -63,7 +63,7 @@ .Xr tftp 1 の利用には、リモートシステムのアカウントやパスワードを必要としません。 認証情報がありませんので、 -.Nm tftpd +.Nm はパブリックに読み込み可能なファイルだけしかアクセスを許可しません。 文字列 ``/\|\fB.\|.\fP\|/'' を含んだファイル、もしくは ``\|\fB.\|.\fP\|/'' から始まるファイルのアクセスは許可されません。 @@ -78,7 +78,7 @@ 持たねばなりません。 .Pp ファイルへのアクセス制限は、 -.Nm tftpd +.Nm 起動時のディレクトリリストを、 .Pa /etc/inetd.conf にサーバプログラムへの引数として 20 までのパス名を指定することにより可能です。 @@ -87,14 +87,18 @@ 与えられたディレクトリは、相対ファイル指定要求に対しての探索パスと しても利用されます。 .Pp -chroot オプションは、 tftpd のアクセスを chroot されたファイルシステム +chroot オプションは、 +.Nm +のアクセスを chroot されたファイルシステム だけに制限することで、セキュリティを追加します。 これは、ブートサーバとして -.Nm -s +.Fl s を提供している OS から実行する時に便利です。 -chroot の実行は root に制限されていますので、tftpd は root で +chroot の実行は root に制限されていますので、 +.Nm +は root で 実行しなければなりません。しかしながら、 chroot した場合、 -.Nm tftpd +.Nm はユーザ id を nobody に設定します。 .Pp 以下のようなオプションがあります。 @@ -106,7 +110,9 @@ chroot .It Fl n 存在しない相対ファイル名に対する要求の否定応答を抑止します。 .It Fl s Ar directory -コマンドを受け取る前に tftpd を +コマンドを受け取る前に +.Nm +を .Pa directory へ chroot させます。更に、ユーザ id を nobody にします。 .Pp diff --git a/ja/man/man8/timed.8 b/ja/man/man8/timed.8 index 1251c4263e..d39a5d7a59 100644 --- a/ja/man/man8/timed.8 +++ b/ja/man/man8/timed.8 @@ -50,7 +50,7 @@ 本コマンドは、タイムサーバデーモンであり、通常はブート時に .Xr rc 8 ファイル内の記述に従って起動されます。本コマンドにより、ホストと、 -.Nm timed +.Nm を実行しているローカルネットワーク上のマシンとの時刻の同期を取ります。 これらのタイムサーバは、 マシン時刻の刻みを遅らせたり進ませたりすることで、それらのマシンの時計を @@ -59,11 +59,11 @@ タイムスタンプリクエストメッセージを用いることで、 マシン間の時刻差分を計測し、ネットワーク平均時間を計算します。 .Pp -.Nm timed +.Nm によって提供されるサービスは、マスタ−スレーブ構造に基づいて構成されています。 -.Nm timed +.Nm がマシン上で動作し始めると、 -.Nm timed +.Nm は、マスタサーバにネットワーク時刻を問い合わせ、自マシンの時刻を設定します。 この後、マスタサーバから送られる同期メッセージを定期的に受け取り、 マシン時間の補正が必要な場合には @@ -83,11 +83,11 @@ や .Fl F オプションを付加しないで動作している -.Nm timed +.Nm は、スレーブのままです。 .Fl t フラグは、 -.Nm timed +.Nm が受信するメッセージを .Pa /var/log/timed.log へ記録するようにします。このトレース機能は、 @@ -95,8 +95,10 @@ を用いてオン/オフを変更できます。 .Fl d フラグは、デーモンのデバッグのためのオプションです。 -本オプションは、プログラムをバックグラウンド実行しないようにします。通常、 -.Nm timed +本オプションは、プログラムをバックグラウンド実行しないようにします。 +.Pp +通常、 +.Nm は、接続されているネットワーク上のマスタタイムサーバをチェックしますが、 以下に記述のあるオプションを指定して動作を変更した場合にはこの限りでは ありません。 @@ -131,7 +133,7 @@ .Fl i は、同時に使用できません。 .Pp -.Nm timed +.Nm は、接続されているネットワーク上のマスタタイムサーバをチェックします。しかし、 .Fl n や @@ -142,7 +144,9 @@ マスタサーバが見つからなくなった場合のために、 定期的に他のネットワークをチェックします。 .Pp -マシン群の同期をとるための 1つの方法として、NTP デーモンを用いてあるマシン +マシン群の同期をとるための 1つの方法として、 +.Tn NTP +デーモンを用いてあるマシン の時刻を遠距離の標準時刻や電波受信機の時刻に同期させ、かつ、信頼できる マシンは自分自身だけであることを timed デーモンに .Fl F Ar hostname @@ -164,21 +168,24 @@ 別のネットワークにおいてスレーブになることを選択したことを示します。 .Sh 警告 もし -.Nm timed +.Nm や -.Xr NTP +.Tn NTP のような 2 つ以上の時刻デーモンが同じ時計を更新しようとした場合に、 一時的に時刻がおかしくなる可能性があります。 .Nm と他のタイムデーモンが同じマシン上で走行している場合には、 .Fl F オプションを使用していることを確認して下さい。これは、 -.Nm timed +.Nm がローカルマシンの時計を更新しないようにするためです。 .Pp なお、このデーモンが使用するネットワークプロトコルは、 -UDP/IP ブロードキャストに基づいています。 -ブロードキャスト範囲内で TSP プロトコルを用いるすべてのマシンは +.Tn UDP/IP +ブロードキャストに基づいています。 +ブロードキャスト範囲内で +.Tn TSP +プロトコルを用いるすべてのマシンは 協調しあわなければなりません。 ブロードキャストパケットが届くマシン間では、 .Fl F diff --git a/ja/man/man8/timedc.8 b/ja/man/man8/timedc.8 index 1b1b4d5a5a..89a8e3fe1e 100644 --- a/ja/man/man8/timedc.8 +++ b/ja/man/man8/timedc.8 @@ -45,7 +45,7 @@ .Op Ar argument ... .Oc .Sh 解説 -.Nm timedc +.Nm は、 .Xr timed 8 を制御するために使用します。具体的には、以下に示す機能を有します。 @@ -61,16 +61,16 @@ 様々なデバッグ動作 .El .Pp -.Nm timedc +.Nm を引数なしで起動した場合、 -.Nm timedc +.Nm はプロンプトを表示し、標準入力からの コマンド入力待ちの状態になります。起動時に引数を指定した場合、 -.Nm timedc +.Nm は、最初の引数をコマンドとして、残りの引数をそのコマンドのパラメータとして 解釈します。 また -.Nm timedc +.Nm は、標準入力の代わりにリダイレクションを使用してファイルからコマンドを 読み込むこともできます。 コマンドは短縮可能です; 使用可能なコマンドは以下の通りです: @@ -83,7 +83,7 @@ 使用可能なコマンドの一覧を表示します。 .Pp .It Ic clockdiff Ar host ... -.Nm timedc +.Nm を実行したマシンの時刻と、引数で指定したマシンの時刻 の比較を行ない、その結果を表示します。 .Pp @@ -99,7 +99,7 @@ へのメッセージの .Pa /var/log/timed.log への記録の有効/無効を指定します。 -.It Ic election Ar host +.It Ic election Ar host1 Op Ar host2 ... .Ar host で指定したホスト上の timed デーモンに対し、"election" タイマをリセットし、 新たにマスタタイムサーバが選択されていることを確実にするよう要求します。 @@ -112,7 +112,7 @@ timedc .Xr timed 8 のテストやデバッグのために実装してあります。 それらのコマンドについては、 -.Nm timedc +.Nm の help コマンドを用いたり、本コマンドのソースを参照するなどして調べて下さい。 .Sh 関連ファイル .Bl -tag -width /var/log/timed.masterlog -compact diff --git a/ja/man/man8/traceroute.8 b/ja/man/man8/traceroute.8 index 5896caa481..2f3feee717 100644 --- a/ja/man/man8/traceroute.8 +++ b/ja/man/man8/traceroute.8 @@ -13,7 +13,7 @@ .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" -.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.2 1996/10/08 02:44:23 sef Exp % +.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.2.2.1 1998/01/09 18:51:35 steve Exp % .\" .\" jpman %Id: traceroute.8,v 1.2 1997/05/13 00:58:05 mutoh Stab % .\" diff --git a/ja/man/man8/trpt.8 b/ja/man/man8/trpt.8 index ef96c9d2e8..d97ce5beea 100644 --- a/ja/man/man8/trpt.8 +++ b/ja/man/man8/trpt.8 @@ -50,7 +50,7 @@ .Ar system Op Ar core .Oc .Sh 解説 -.Nm trpt +.Nm は、socket に .Dq デバッグ情報の記録 を指示した時 ( @@ -59,7 +59,7 @@ .Tn TCP のトレースレコードの内容を表示します。 オプションを指定しない場合には、 -.Nm trpt +.Nm は、システム中のすべてのトレースレコードを、 .Tn TCP コネクションの @@ -67,7 +67,7 @@ (protocol control block) によってグループ化して表示します。 以下のオプションを使ってこの動作を変更することができます。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a 通常の出力に加えて、 記録された各パケットの送信元と宛先のアドレスを表示します。 @@ -88,7 +88,7 @@ 通常の出力に加えて、トレースの各時点でのすべてのタイマの値を表示します。 .El .Pp -.Nm trpt +.Nm は、以下のようにして使ってみて下さい。 問題となっているコネクションを切り分けて、それに関わる socket に対して デバッグ機能を有効にします。 @@ -99,7 +99,7 @@ そして、 .Fl p オプションと PCB アドレスを引数にして -.Nm trpt +.Nm を実行します。 .Fl f オプションを使うと、一度見つけたトレースログを追い続けることができます。 @@ -117,8 +117,9 @@ .El .Sh 関連項目 .Xr netstat 1 , -.Xr setsockopt 2 , -.Xr trsp 8 +.Xr setsockopt 2 +.\" .Xr setsockopt 2 , +.\" .Xr trsp 8 .Sh 診断 .Bl -tag -width Ds .It Sy no namelist diff --git a/ja/man/man8/tzsetup.8 b/ja/man/man8/tzsetup.8 index 97e28b4dcc..8a83c30f10 100644 --- a/ja/man/man8/tzsetup.8 +++ b/ja/man/man8/tzsetup.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: tzsetup.8,v 1.3.2.1 1997/03/06 08:00:38 mpp Exp % +.\" %Id: tzsetup.8,v 1.3.2.2 1997/11/07 07:36:15 charnier Exp % .\" jpman %Id: tzsetup.8,v 1.3 1997/07/22 17:04:38 horikawa Stab % .Dd Jan 1996 @@ -33,13 +33,23 @@ .Nm tzsetup .Nd ローカルタイムゾーンを設定する -.Sh 解説 +.Sh 書式 .Nm tzsetup +.Op Fl n + +.Sh 解説 +.Nm は、メニューによるローカルタイムゾーンの設定を行うためのプログラムです。 もっとも良くあなたの場所を表現している大陸と (例えば、あなたの首都の様な) 都市を選びます。すると -.Nm tzsetup +.Nm が全ての仕事を行ってくれます。 +.Pp +以下のオプションが使用可能です: +.Bl -tag -width indent +.It Fl n +実際には何も行わない。 +.El .Sh バグ 変更が効果を持つためには、機械をリブートする必要があります。 @@ -51,7 +61,8 @@ .It Pa /usr/share/zoneinfo ゾーン情報ファイルのためのディレクトリ .It Pa /etc/wall_cmos_clock -adjkerntz(8) を見てください。 +.Xr adjkerntz 8 +を見てください。 .El .Sh 関連項目 diff --git a/ja/man/man8/uucpd.8 b/ja/man/man8/uucpd.8 index cb663ceecf..3a5a1c22b9 100644 --- a/ja/man/man8/uucpd.8 +++ b/ja/man/man8/uucpd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: uucpd.8,v 1.2 1996/08/23 20:36:11 mpp Exp % +.\" %Id: uucpd.8,v 1.2.2.1 1997/12/18 07:32:41 charnier Exp % .\" .\" jpman %Id: uucpd.8,v 1.3 1997/09/04 16:43:12 horikawa Stab % .Dd Feb 18, 1996 @@ -40,11 +40,11 @@ .Nm uucpd .Nd uucp ネットワークサーバ .Sh 書式 -.Nm uucpd +.Nm /usr/libexec/uucpd .Sh 解説 -.Nm uucpd +.Nm は、ネットワーク経由での uucp 接続をサポートするサーバです。 -.Nm uucpd +.Nm は、``uucp'' サービスとして定められたポート( .Xr services 5 参照)を監視し、リクエストが来るのを待ちます。 @@ -62,7 +62,7 @@ .It Pa /etc/inetd.conf .El .Sh 歴史 -.Nm uucpd +.Nm ユーティリティは、 .Bx 4.3 から登場しました。 diff --git a/ja/man/man8/vipw.8 b/ja/man/man8/vipw.8 index f417060a03..7aa13c6ccf 100644 --- a/ja/man/man8/vipw.8 +++ b/ja/man/man8/vipw.8 @@ -43,23 +43,23 @@ .Sh 書式 .Nm vipw .Sh 解説 -.Nm vipw +.Nm は、適切なロックをしてパスワードファイルの編集を行い、 ロックを解除した後で必要な処理を行います。すでに他のユーザによって パスワードファイルが編集中でロックされていた場合には、 -.Nm vipw +.Nm は後で再度実行するように知らせます。 デフォルトでは、 .Xr vi 1 がエディタとして使用されます。 .Pp -.Nm vipw +.Nm はパスワードファイルエントリの多くの整合性をチェックし、「間違った」エントリを 含むパスワードファイルがインストールされないようにします。 間違っていた場合にはユーザに再編集を要求します。 .Pp パスワードファイルの情報が正しいことが確かめられると、 -.Nm vipw +.Nm は .Xr pwd_mkdb 8 を使ってデータベースを更新します。これはバックグラウンドで行なわれ、 @@ -68,7 +68,7 @@ 新しい情報をプログラムで利用することはできません。 .Sh 環境変数 以下の環境変数が -.Nm vipw +.Nm で参照されます。 .Bl -tag -width EDITOR .It Ev EDITOR diff --git a/ja/man/man8/vnconfig.8 b/ja/man/man8/vnconfig.8 index 88911f0fd6..e3e1a682df 100644 --- a/ja/man/man8/vnconfig.8 +++ b/ja/man/man8/vnconfig.8 @@ -45,15 +45,19 @@ .Nd vnode ディスクを構築して利用できるようする .Sh 書式 .Nm vnconfig -.Op Fl cdeuv +.Op Fl cdeguv +.Op Fl s Ar option +.Op Fl r Ar option .Ar special_file Ar regular_file .Oo Ar feature Oc .Nm vnconfig .Fl a -.Op Fl cdeuv +.Op Fl cdeguv +.Op Fl s Ar option +.Op Fl r Ar option .Op Fl f Ar config_file .Sh 解説 -.Nm vnconfig +.Nm コマンドは、vnode 疑似ディスクデバイスを構築して使用可能にします。 コマンドの最初の書式では、スペシャルファイル .Ar special_file @@ -66,6 +70,9 @@ .Pp オプションは動作を指定します: .Bl -tag -width indent +.It Fl a +コマンドファイルを読み込み、 +各デバイス/ファイルの組に対して指定された動作を実行します。 .It Fl c デバイスを構築します。 成功すると、 @@ -73,6 +80,10 @@ への参照は、 .Ar regular_file の内容へのアクセスとなります。 +.It Fl d +指定した +.Ar feature +を(可能であれば)無効にします。 .It Fl e デバイスを構築し、指定された .Ar feature @@ -83,10 +94,19 @@ は .Fl c と同じ意味になります。 -.It Fl d -(可能なら) 指定した -.Ar feature -を無効にします。 +.It Fl f Ar config_file +.Ar config_file +を構成ファイルの代りに使用します。 +.It Fl g +global オプションを制御します。 +.It Fl r Ar option +.Ar option +をリセットします。 +.Ar option +は labels, follow, debug, io, all, none のいずれかです。 +.It Fl s Ar option +.Ar option +をセットします。 .It Fl u デバイスを無効にし、``無構築状態'' にします。 .It Fl v @@ -122,15 +142,6 @@ ``mountrw='' と同じです。 .El .Pp -第 2 の書式 ( -.Fl a -) では、構成ファイルを読み込んで、 -デバイスとファイルのそれぞれの組について指定された動作を実行します。 -.Fl f -によって、読み込む構成ファイル -.Ar config_file -を指定します。 -この指定がないと、デフォルトの構成ファイルを読みます。 構成ファイルは、1 行にデバイスとファイル名の組を次の形式で持ちます: .Bd -literal special_file regular_file [ feature ] diff --git a/ja/man/man8/watch.8 b/ja/man/man8/watch.8 index 3ab8cb4863..98a315eac9 100644 --- a/ja/man/man8/watch.8 +++ b/ja/man/man8/watch.8 @@ -14,34 +14,34 @@ .Ar tty .\" watch [-ciotnW] [] .Sh 解説 -.Nm watch +.Nm は、特定の tty を通して流れてくる全てのデータをスーパユーザに 提供します。 -.Nm watch +.Nm は、標準出力に出力します。 .Pp 以下のようなオプションがあります。 -.Bl -tag -width "-l nul " +.Bl -tag -width indent .It Fl c 閉じられた時点で再接続を行います。 -.Nm watch +.Nm によって観察されている tty が閉じられたならば、自動的に同じ tty に 再接続します。 このオプションが指定されていない時は、 -.Nm watch +.Nm は対話モードで実行されている時には新しい tty を要求し、 tty 制御を行わずに実行されている場合は終了します。 .It Fl i 対話モードにします。 対話モードは、 -.Nm watch +.Nm が tty から実行された場合のデフォルトです。 出力がファイルにリダイレクションされている時は、 このオプションを指定することで対話モードにできます。 .It Fl o オーバフローによって再接続します。 観察している tty がオーバフローした時の -.Nm watch +.Nm の振舞いは、観察している tty が閉じられた時の振舞いに似ています。 詳しい情報は、 .Xr snp 4 @@ -54,7 +54,7 @@ tty 現在の tty が閉じられたりオーバフローを起こした場合の自動プロンプトともに 無効にします。 プロンプトが表示される全ての場合、 -.Nm watch +.Nm .\"(訳注)実際は文中の語でしたが、ここでは.Nmを使いました。 .\" 2.2.1R 対象(1997/04/28) Takeshi MUTOH は終了します。再接続フラグは、このオプションに影響されません。 @@ -70,7 +70,7 @@ tty .Pp .Bl -tag -width "XXXX" -compact .It Sy "" -.Nm watch +.Nm の終了。 .It Sy "" 画面の消去。 @@ -78,7 +78,7 @@ tty 除き見る tty の変更。 .Sh 制限事項 スーパユーザだけが、 -.Nm watch +.Nm を実行できます。 .Sh 関連項目 .Xr pty 4 , @@ -88,9 +88,9 @@ tty 端末エミュレーション機能はありません。 全てのユーザの出力はそのままの形で再構成されます。 .Sh 作者 -Ugen J.S. Antsilevich +.An Ugen J.S. Antsilevich Aq ugen@NetVision.net.il .Sh 歴史 -.Nm watch +.Nm は、 .Fx 2.1 で、はじめて導入されました。 diff --git a/ja/man/man8/wlconfig.8 b/ja/man/man8/wlconfig.8 index 654dada71d..eda74185ab 100644 --- a/ja/man/man8/wlconfig.8 +++ b/ja/man/man8/wlconfig.8 @@ -9,7 +9,7 @@ .Ar ifname .Op Ar param value ... .Sh 解説 -.Nm wlconfig +.Nm コマンドは、NCR/AT&T Wavelan 無線 LAN カードのパラメータを読んだり、 設定したりするのに使うことができます。 カード内の不揮発性パラメータ格納エリア (Parameter Storage Area; PSA) @@ -36,9 +36,9 @@ .Va value .It irq IRQ の値 (リセット後に有効)。 3, 4, 5, 6, 10, 11, 12, 15 のうちの -どれか一つ +どれか一つ。 .It mac -固有の MAC の値 (イーサネットアドレス) +固有の MAC の値 (イーサネットアドレス)。 .It macsel ( .Sq mac @@ -46,7 +46,7 @@ IRQ .Sq soft か、(工場で設定される) .Sq default -のどちらか +のどちらか。 .It nwid NWID はカードの無線モデムに渡される 2 バイトのパラメータです。 NWID により、同じ空間を共有して複数の論理的に分割された @@ -85,7 +85,7 @@ IP .Pp Wavelan カードの IRQ が間違っている場合には、インタフェースが 設定されたとしても機能しないであろうことに注意して下さい。 -.Nm wlconfig +.Nm プログラムは正しい値にカードを再設定するよう使われるべきです。 .Sh 使用例 NWID を 0x1234 に設定する : @@ -126,6 +126,9 @@ CRC status : OK .Xr wl 4, .Xr sysctl 8 . .Sh 歴史 -.Nm wlconfig +.Nm コマンドのこの実装は完全に新規のもので、Hilink Internet のために -Michael Smith により書かれ、Jim Binkley &c により更新されました。 +.An Michael Smith +により書かれ、 +.An Jim Binkley &c +により更新されました。 diff --git a/ja/man/man8/wormcontrol.8 b/ja/man/man8/wormcontrol.8 index 1aefce1c9c..1b1010bf90 100644 --- a/ja/man/man8/wormcontrol.8 +++ b/ja/man/man8/wormcontrol.8 @@ -32,7 +32,7 @@ .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" -.\" %Id: wormcontrol.8,v 1.3.2.2 1997/03/06 08:00:45 mpp Exp % +.\" %Id: wormcontrol.8,v 1.3.2.3 1997/11/18 07:28:14 charnier Exp % .\" jpman %Id: wormcontrol.8,v 1.3 1997/08/16 13:45:04 horikawa Stab % .\" .\" arrgh, hilit19 needs this" :-( @@ -48,16 +48,6 @@ .Ar command .Op Ar params... .Sh 解説 -.Ss オプション -.Bl -tag -ident -width "XXX" -.It Fl f Ar device -デフォルトの -.Pa /dev/rworm0 -に代えて、デバイス -.Ar device -を使用します。 -.El -.Ss 概略 .Nm は、書き込み可能 CD .Pq CD-R @@ -94,8 +84,14 @@ CD-R させなければなりません。 これは目録とリードアウト情報をディスクに書き込む処理であり、 この処理をしなくてはディスクは利用できません。 -.Ss コマンド -.Bl -tag -indent -width "prepdisk" +以下のオプションを指定可能です: +.Bl -tag -width ident +.It Fl f Ar device +デフォルトの +.Pa /dev/rworm0 +ではなく +.Ar device +を使用します。 .It select Ar vendor-id model-id 残念なことに、各 CD-R ドライブベンダは独自の SCSI コマンドセットを 実装することになってしまいました。従って @@ -186,7 +182,7 @@ CD-R 内部で呼び出される .Xr ioctl 2 コマンドのエラーコードが -.Xr perror 3 +.Xr err 3 機能によって表示されます。 .Sh 使用例 データ CD-R を焼く典型的な手順はこのようになります: @@ -218,7 +214,7 @@ CD-R .Xr dd 1 , .Xr team 1 , .Xr ioctl 2 , -.Xr perror 3 , +.Xr err 3 , .Xr worm 4 .Pp .Pa /usr/share/examples/worm/* diff --git a/ja/man/man8/xntpd.8 b/ja/man/man8/xntpd.8 index 83d1c12104..6c06271233 100644 --- a/ja/man/man8/xntpd.8 +++ b/ja/man/man8/xntpd.8 @@ -96,8 +96,8 @@ xntpd - Network Time Protocol .PP 通常、 .I xntpd -は、起動時にコンフィギュレーションファイルから設定を読込みます。デフォ -ルトのコンフィギュレーションファイル名は、 +は、起動時にコンフィギュレーションファイルから設定を読込みます。 +デフォルトのコンフィギュレーションファイル名は、 .IR /etc/ntp.conf ですが、コマンドラインの指定の方が優先します。また、もっぱらコマンド ラインだけで、その局面に役立つ @@ -113,21 +113,21 @@ xntpd - Network Time Protocol .IR ntpq (8) および .IR xntpdc (8) -を使用することで、デーモンのさまざまな内部変数を表示したり設定オプショ -ンを変更できます。 +を使用することで、デーモンのさまざまな内部変数を表示したり +設定オプションを変更できます。 .PP デーモンはアクティブ/パッシブ, クライアント/サーバ, ブロードキャスト /マルチキャスト等の対称的なモードを含むいずれかのモードで働くことが -できます。ブロードキャストもしくはマルチキャスト・クライアントは、自 -動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 +できます。ブロードキャストもしくはマルチキャスト・クライアントは、 +自動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 に自身に対する設定を行います。これにより、その環境に固有の詳細な設定 -やコンフィギュレーションファイルなしに、一群のワークステーションを配 -置することが可能になります。 +やコンフィギュレーションファイルなしに、一群のワークステーションを +配置することが可能になります。 .PP 以下にあげるコマンドライン引数が .I xntpd -により理解されます。(より完全な機能の説明については、コンフィギュレー -ションファイルの説明を参照のこと): +により理解されます。(より完全な機能の説明については、 +コンフィギュレーションファイルの説明を参照のこと): .Ip -a 8 「認証」 (\*(L"authenticate\*(R") モードで実行します。 @@ -146,15 +146,15 @@ driftfile .Ip -k 8 NTP の認証キーを含むファイルのある場所を指定します。 .Ip -m 8 -マルチキャストメッセージを待受けて、可能ならそれらに同期します (マル -チキャストカーネルが必要になります)。 +マルチキャストメッセージを待受けて、可能ならそれらに同期します ( +マルチキャストカーネルが必要になります)。 .Ip -p 8 デーモンのプロセス ID を記録するためのファイル名を指定します。 .Ip -r 8 -通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバとク -ライアントとの間のネットワーク遅延を自動的に補正します。遅延の測定作 -業が失敗した場合には、ここで指定した (秒の) デフォルトの遅延を使用す -るようになります。 +通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバと +クライアントとの間のネットワーク遅延を自動的に補正します。 +遅延の測定作業が失敗した場合には、ここで指定した (秒の) デフォルトの +遅延を使用するようになります。 .Ip -s 8 統計ファイルを作成するためのディレクトリを指定します。 .Ip "-t trustedkey" 8 @@ -166,16 +166,17 @@ NTP .SH "コンフィギュレーションオプション" .I xntpd -のコンフィギュレーションファイルのフォーマットは、他の Unix コンフィ -ギュレーションファイルのものに似ています。コメントは文字 \*(L"#\*(R" -で始まり、行末まで続きます。空行は無視されます。設定コマンドは、行頭 -のキーワードとそれに続く空白で区切られた引数のリストからなります。引 -数の内いくつかは、省略可能な場合があります。これらのコマンドは複数行 -にわたってはなりません。引数は、ホスト名, ドットで区切られた 4 つ組 -の数からなる (dotted-quad) 形式のホストアドレス, 整数, 浮動少数点数 -(秒で時間を指定する際用います), テキスト文字列などです。以下の説明で -は、省略可能な引数は、\*(L"[]\*(R" で囲み、複数択一の引数は、互いに -\*(L"|\*(R" で区切って表します。 +のコンフィギュレーションファイルのフォーマットは、 +他の Unix コンフィギュレーションファイルのものに似ています。 +コメントは文字 \*(L"#\*(R" で始まり、行末まで続きます。空行は無視されます。 +設定コマンドは、行頭のキーワードとそれに続く空白で区切られた +引数のリストからなります。引数の内いくつかは、省略可能な場合があります。 +これらのコマンドは複数行にわたってはなりません。 +引数は、ホスト名, ドットで区切られた 4 つ組の数からなる (dotted-quad) 形式の +ホストアドレス, 整数, 浮動少数点数 (秒で時間を指定する際用います), +テキスト文字列などです。 +以下の説明では、省略可能な引数は、\*(L"[]\*(R" で囲み、 +複数択一の引数は、互いに \*(L"|\*(R" で区切って表します。 .PP .B peer .I host_address @@ -214,39 +215,39 @@ NTP .I # ] .PP -これらの 3つのコマンドは、利用されるべき時間サーバや与えられるべき時 -間サービスを指定します。 +これらの 3つのコマンドは、利用されるべき時間サーバや与えられるべき +時間サービスを指定します。 .B peer コマンドは、ローカルサーバが、コマンド中の .I host_address で示されるリモートサーバに対し、「対称的アクティブ」 (\*(L"symmetric active\*(R") モードで動作するよう指示します。これは、さまざまな失敗 -の仕方によって、ローカルもしくはリモートのサーバホストのいずれかがよ -り良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ +の仕方によって、ローカルもしくはリモートのサーバホストのいずれかが +より良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ ものです。 .B server -コマンドは、ローカルサーバが、指定したリモートサーバに対して \*(L"ク -ライアント\*(R" モードで動作するよう指示します。このモードでは、ロー -カルサーバはリモートサーバに同期しますが、リモートサーバがローカルサー -バに同期することは決してありません。 +コマンドは、ローカルサーバが、指定したリモートサーバに +対して \*(L"クライアント\*(R" モードで動作するよう指示します。 +このモードでは、ローカルサーバはリモートサーバに同期しますが、 +リモートサーバがローカルサーバに同期することは決してありません。 .B broadcast -コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで動 -作するよう指示します。ローカルサーバは、コマンド中で指定されるブロー -ドキャスト/マルチキャスト/アドレスを持つクライアント集団に、定期的に -ブロードキャストメッセージを送ります。通常、この指示は、送信側 -(transmitter) として動作しているローカルサーバにのみ適用されます。 +コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで +動作するよう指示します。ローカルサーバは、コマンド中で指定される +ブロードキャスト/マルチキャスト/アドレスを持つクライアント集団に、 +定期的にブロードキャストメッセージを送ります。通常、この指示は、 +送信側 (transmitter) として動作しているローカルサーバにのみ適用されます。 ブロードキャストクライアントに対する動作については、以下に説明する .B broadcastclient もしくは .B multicastclient コマンドの項を参照して下さい。このモードでは、 .I host_address -は、通常、そのローカルネットワーク (もしくは複数のローカルネットワー -クの内のひとつ)の上でのブロードキャストアドレスであるか、NTP に割当 -てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が割 -当てられてきました。現在のところは、このアドレスのみを使用すべきです。 +は、通常、そのローカルネットワーク (もしくは複数の +ローカルネットワークの内のひとつ)の上でのブロードキャストアドレスであるか、 +NTP に割当てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が +割当てられてきました。現在のところは、このアドレスのみを使用すべきです。 マルチキャスト機能はマルチキャストカーネルを必要としますが、これは、 -まだ、どのベンダーの製品にでも存在するものではないということに注意し +まだ、どのベンダの製品にでも存在するものではないということに注意し て下さい。 .PP .B key @@ -262,9 +263,9 @@ active\*(R") 全ての点では同等ですが、正常に動作している一群のホストの中から同期を 取る対象として選ばれます。 .B ttl -オプションは、ブロードキャストモードでのみ使用され、マルチキャストパ -ケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 です -が、適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 +オプションは、ブロードキャストモードでのみ使用され、マルチキャスト +パケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 ですが、 +適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 との調整を必要とします。 .PP .B broadcastclient @@ -274,11 +275,10 @@ active\*(R") します。ローカルサーバは、最初のブロードキャストメッセージを受取る際、 リモートサーバとクライアント/サーバ間の短いやりとりを用いて、名目上 の (nominal) ネットワーク遅延を測定してから、後続のブロードキャスト -メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライア -ント\*(R" モードに入ります。このモードでの偶然もしくは故意の分裂状態 +メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライアント\*(R" +モードに入ります。このモードでの偶然もしくは故意の分裂状態 を避けるため、ローカルとリモートのサーバの両方は認証に同一の信頼でき -るキーとキー識別子を使用して動作しなくてはならないことに注意して下さ -い。 +るキーとキー識別子を使用して動作しなくてはならないことに注意して下さい。 .PP .B multicastclient [ @@ -288,8 +288,8 @@ active\*(R") このコマンドは、 .IR broadcastclient コマンドと同じように用いられますが、IP マルチキャストを使用して動作 -します。この機能をサポートするには、マルチキャストカーネルと認証の使 -用が必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ +します。この機能をサポートするには、マルチキャストカーネルと認証の使用が +必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ のマルチキャストグループに加わります。1 つも与えられなければ、NTP に は IP アドレス (224.0.1.1) が割当てられていると想定されます。 .PP @@ -297,40 +297,40 @@ active\*(R") .I filename .PP このコマンドは、ローカルの時計発振子の周波数オフセットを記録するため -のファイル名を指定します。このファイルが存在すると、起動時に初期周波 -数オフセットを指定するのに使用され、その後デーモンにより計算されるカ -レント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 +のファイル名を指定します。このファイルが存在すると、起動時に初期周波数 +オフセットを指定するのに使用され、その後デーモンにより計算される +カレント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 しないか、このコマンドが与えられていない場合、初期周波数オフセットは ゼロと仮定されます。この場合、周波数が安定し、残った時間誤差が収まる -のに数時間かかります。このファイルが、最初にカレント変動値を一時ファ -イルに書込み、 +のに数時間かかります。このファイルが、最初にカレント変動値を一時 +ファイルに書込み、 .IR rename (3) により古いファイルと置換えることで更新されることに注意して下さい。これは、 .I xntpd が、 ドリフトファイルのあるディレクトリに対し書込み権を持っていなけ -ればならず、ファイルは、シンボリックであろうとなかろうと、ファイルシ -ステムリンクであるべきではないだろうことを意味しています。 +ればならず、ファイルは、シンボリックであろうとなかろうと、 +ファイルシステムリンクであるべきではないだろうことを意味しています。 .PP .B enable auth|bclient|pll|monitor|stats [ .I ... ] .PP -さまざまなサーバオプションを有効にします。指定されていないフラグは影 -響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 -できるキーとキー識別子を使用して正しく認証されている場合に限って、サー -バが指定されていない相手に同期するようにします。このフラグのデフォル -トは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード +さまざまなサーバオプションを有効にします。指定されていないフラグは +影響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 +できるキーとキー識別子を使用して正しく認証されている場合に限って、サーバが +指定されていない相手に同期するようにします。このフラグのデフォルトは +無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード キャストもしくはマルチキャストサーバからのメッセージを待受けるように します。これにより、そのサーバに対する連携 (association) が自動的に 成立します。このフラグのデフォルトは無効 (オフ) です。 \*(L"pll\*(R" フラグは、サーバのローカル時計を調整するようにします。デフォルトでは 有効 (オン) です。無効にした場合、ローカル時計は固有の時間と周波数の -まま動きます。このフラグは、ローカル時計が他の何らかのデバイスやプロ -トコルにより制御されており、NTPは他のクライアントと同期をとるためだ -けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、モ -ニタファシリティ (facility) を有効にします(下記参照のこと)。デフォル -トでは有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ +まま動きます。このフラグは、ローカル時計が他の何らかのデバイスや +プロトコルにより制御されており、NTPは他のクライアントと同期をとるためだ +けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、 +モニタファシリティ (facility) を有効にします(下記参照のこと)。デフォルトでは +有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ の filegen (下記説明を参照のこと) を有効にします。デフォルトでは有効 (オン) です。 .PP @@ -339,9 +339,9 @@ active\*(R") .I ... ] .PP -さまざまなサーバオプションを無効にします。指定されていないフラグは影 -響を受けません。現在使用可能なオプションは、enable コマンドの項で説 -明しています。 +さまざまなサーバオプションを無効にします。指定されていないフラグは影響を +受けません。現在使用可能なオプションは、enable コマンドの項で説明 +しています。 .SH "認証オプション" .PP @@ -350,8 +350,8 @@ active\*(R") .PP このコマンドは、認証モードでの操作の際、 .I xntpd -により使用される暗号化キーとキー識別子を含むファイルの名前を指定しま -す。このファイルのフォーマットは以降で説明します。 +により使用される暗号化キーとキー識別子を含むファイルの名前を指定します。 +このファイルのフォーマットは以降で説明します。 .PP .B trustedkey .I # @@ -361,9 +361,9 @@ active\*(R") .PP このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって 信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは -異なるキーを使用できますが、認証手続きにはローカルとリモート両方のサー -バがこの目的のため同一のキーとキー識別子を共有することが必要です。引 -数は、32bitの符合なし整数ですが、 NTP キー 0 は固定されており周知の +異なるキーを使用できますが、認証手続きにはローカルとリモート両方の +サーバがこの目的のため同一のキーとキー識別子を共有することが必要です。 +引数は、32 ビット符合なし整数ですが、 NTP キー 0 は固定されており周知の ものであることに注意してください。意味のある認証が行われるべきならば、 キー 0 は信用すべきではありません。 .PP @@ -376,13 +376,15 @@ active\*(R") .IR xntpdc (8) プログラムにより使用されるキー識別子を指定します。 .I xntpdc -プログラムの動作は、 xntpd のこの固有の実装に特定されており、これお -よび以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル -サーバの状態に影響を与えるリモートの xntpdc プログラムからの要求は、 -認証されねばなりません。そのためには、リモートプログラムとローカルサー -バが共通のキーとキー識別子を共有することが必要です。このコマンドの引 -数は、32bitの符合なし整数です。コンフィギュレーションファイルに -.B requestkey +プログラムの動作は、 xntpd のこの固有の実装に特定されており、これ +および以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル +サーバの状態に影響を与えるリモートの +.I xntpdc +プログラムからの要求は、 +認証されねばなりません。そのためには、リモートプログラムとローカル +サーバが共通のキーとキー識別子を共有することが必要です。このコマンドの引数は、 +32 ビット符合なし整数です。コンフィギュレーションファイルに +.B controlkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 .PP @@ -400,10 +402,10 @@ active\*(R") の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 を与えるリモートの .I ntpq -プログラムからの要求は、認証されねばなりません。そのためには、リモー -トプログラムとローカルサーバが共通のキーとキー識別子を共有することが -必要です。このコマンドの引数は、32bitの符合なし整数です。コンフィギュ -レーションファイルに +プログラムからの要求は、認証されねばなりません。そのためには、リモート +プログラムとローカルサーバが共通のキーとキー識別子を共有することが +必要です。このコマンドの引数は、32 ビット符合なし整数です。 +コンフィギュレーションファイルに .B requestkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 @@ -411,8 +413,8 @@ active\*(R") .B authdelay .I seconds .PP -ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の総 -計を示します。この値は、送出パケットに認証が用いられる際、送信タイム +ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の +総計を示します。この値は、送出パケットに認証が用いられる際、送信タイム スタンプを修正するのに使用されます。通常、この値は 0.0001 秒から 0.003 秒あたりになりますが、これはホスト計算機の CPU 速度に依存して います。通常、この値は、ディストリビューションに含まれている @@ -436,30 +438,30 @@ active\*(R") いるかどうか調べられます。ここで、最後にマッチしたものが受信パケット に関する制限フラグを定義します。受信パケットのソースアドレスは、制限 リストのエントリに関するマスクでアンドをとられた 32 ビットアドレスと -マッチするか調べられ、それからエントリアドレス (これもまたマスクとア -ンドをとられます) と比較され、マッチするものを探します。引数 +マッチするか調べられ、それからエントリアドレス (これもまたマスクと +アンドをとられます) と比較され、マッチするものを探します。引数 \*(L"mask\*(R" のデフォルトは 255.255.255.255 で、\*(L"address\*(R" -が個別のホストのアドレスとして扱われることを意味します。デフォルトエ -ントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の +が個別のホストのアドレスとして扱われることを意味します。デフォルト +エントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の ソートアルゴリズムでは、リストの先頭のエントリとなります。 -\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask オプ -ションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルトエン -トリを示すために使用できることに、注意して下さい。 +\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask +オプションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルト +エントリを示すために使用できることに、注意して下さい。 .PP 現在の実装では、フラグは常にアクセスを制限します。すなわち、フラグを -持たないエントリは、サーバへの自由なアクセスが与えられることを示すこ -とになります。フラグは直交的ではなく、より制限の強いフラグは、より制 -限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 -されます。時間サービスを制限するものと、情報問い合わせやサーバの実 -行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する +持たないエントリは、サーバへの自由なアクセスが与えられることを示す +ことになります。フラグは直交的ではなく、より制限の強いフラグは、より +制限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 +されます。時間サービスを制限するものと、情報問い合わせやサーバの +実行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する ことができます: .Ip ignore 10 -このエントリにマッチするホストからのすべてのパケットを無視します。こ -のフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ +このエントリにマッチするホストからのすべてのパケットを無視します。 +このフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ れなくなります。 .Ip noquery 10 -NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要 -求) を無視します。時間サービスは影響を受けません。 +NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要求) +を無視します。時間サービスは影響を受けません。 .Ip nomodify 10 サーバの状態を変えようとするモード 6 と 7のすべてのパケット (つまり 実行時再設定) を無視します。情報を返す問い合わせは許されます。 @@ -472,9 +474,9 @@ NTP マッチしたホストによるトラップセットを低い優先度として宣言します。1 つのサーバが保持し得るトラップの数は制限されています(現在の制限値は 3 です)。トラップは通常、先入れ先処理ベースで割当てられ、後から来た -トラップ要求はサービスを拒否されます。このフラグは、通常優先度のトラッ -プに対する後からの要求が、低い優先度のトラップより優先されることを許 -すことで、通常の割当てアルゴリズムを変更します。 +トラップ要求はサービスを拒否されます。このフラグは、通常優先度の +トラップに対する後からの要求が、低い優先度のトラップより優先されることを +許すことで、通常の割当てアルゴリズムを変更します。 .Ip noserve 10 モード 6 と 7 以外のすべての NTP パケットを無視します。基本的には、 時間サービスは拒否されますが、それでも問い合わせは許されています。 @@ -490,11 +492,11 @@ NTP ます。ここで言うネットとは、 (class A, class B, class C 等の) ネット の IP 表記のことです。サーバで見えており、過去 \*(L"client_limit_period\*(R" 秒の間アクティブであった、最初の -\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一のネッ -トの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 +\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一の +ネットの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 考慮されます。\*(L"プライベート\*(R"", \*(L"制御\*(R"", \*(L"ブロー -ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、ク -ライアントの数の内には入れられません。クライアントの履歴は、 +ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、 +クライアントの数の内には入れられません。クライアントの履歴は、 .I xntpd のモニタリング機能を使用して維持されます。それゆえ、モニタリングは、 \*(L"limited\*(R" フラグに制限エントリがある限り、アクティブです。 @@ -509,53 +511,52 @@ UDP されます。 .PP デフォルトの制限リストエントリは、フラグ \*(L"ignore, ntpport\*(R" -を持ち、ローカルホストのインターフェイスアドレスの各々に対し、スター -トアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと +を持ち、ローカルホストのインタフェースアドレスの各々に対し、 +スタートアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと しないようにします。また、デフォルトエントリは常に存在しますが、他で は設定されない場合は、どのフラグもデフォルトエントリに関連づけられま -せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になりま -す) 。 +せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になります) 。 .PP -制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在のア -クセスポリシが、 +制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在の +アクセスポリシが、 .I xntpd と同様に実装され得るように、付け加えられたものです。このファシリティ は、あなたのサーバが、望まないか故障したリモート時間サーバの影響を受 -けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証ファ -シリティの代わりになると考えるべきではありません。ソースアドレスに基 -づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 +けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証 +ファシリティの代わりになると考えるべきではありません。ソースアドレスに +基づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 .PP .B clientlimit .I limit .PP -\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント制 -限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される +\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント +制限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される 同一ネットワークからのクライアント数を定義します。 .PP .B clientperiod .I period .PP \*(L"client_limit_period\*(R" をセットし、クライアント制限ポリシの設 -定を可能にします。この変数は、その時間後にクライアントがインアクティ -ブになると考えられ、従って制限されるクライアント数にもはや数えられな +定を可能にします。この変数は、その時間後にクライアントがインアクティブに +なると考えられ、従って制限されるクライアント数にもはや数えられな くなるような秒数を指定します。 .SH "モニタリングオプション" .PP .B statsdir .I /directory path/ .PP -統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参 -照)。このキーワードにより (そうでなければ定数である) filegen ファイ -ル名のプレフィックスを統計ログ処理に対して用いられるファイル生成セッ -トに対して修正することが可能となります (下記 +統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参照)。 +このキーワードにより (そうでなければ定数である) filegen ファイル名の +プレフィックスを統計ログ処理に対して用いられるファイル生成セットに対して +修正することが可能となります (下記 .B filegen 文を参照)。 .PP .B statistics .IR name \.\.\. .PP -統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポー -トされています。 +統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポート +されています。 .Ip loopstats 10 ループフィルタの統計情報の記録を有効にします。ローカル時計の更新を 行う度に、\*(L"loopstats\*(R" と名付けられたファイル生成セットに次の @@ -566,26 +567,26 @@ UDP .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次の 3 つのフィールドは、時計の更新時の、秒 -での時間オフセット, 100 万分の 1 単位の周波数オフセット, +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次の 3 つのフィールドは、時計の更新時の、 +秒での時間オフセット, 100 万分の 1 単位の周波数オフセット, clock-discipline アルゴリズムの時定数です。 .RE .Ip peerstats 10 通信相手に関する統計情報の記録を有効にします。これには、存在し初期化 -された NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコー -ドが含まれます。有効な更新が行われる度に、 \*(L"peerstats\*(R" と名 -付けられたファイル生成セットの現在の要素に次の形式の行を出力します: +された NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコードが +含まれます。有効な更新が行われる度に、 \*(L"peerstats\*(R" と +名付けられたファイル生成セットの現在の要素に次の形式の行を出力します: .PP .RS 5 48773 10847.650 127.127.4.1 9714 -0.001605 0.00000 0.00142 .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ -dotted-quad 記法で表された通信相手のアドレスとステータスです。ステー -タスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ +dotted-quad 記法で表された通信相手のアドレスとステータスです。 +ステータスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ れたフォーマットに従い 16 進数にエンコードされています。最後の 3 つ のフィールドは、オフセット, 遅延, ばらつきで、すべて秒単位です。 .RE @@ -599,10 +600,10 @@ dotted-quad .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された -時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイ -ムコードで、ここでは意味のある ASCII 形式になっています。いくつかの +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された +時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイム +コードで、ここでは意味のある ASCII 形式になっています。いくつかの 時計ドライバでは、たくさんの付加的情報が集められ、同様に表示されます。 より詳しくは、それぞれの時計の仕様情報を参照してください。 .RE @@ -612,8 +613,8 @@ dotted-quad を参照)を用いて管理されます。統計を記録することで得られる情報は、 .I xntpd サーバの一時的なプロパティ (properties) の解析を可能にします。通常は -主要な (primary) サーバで役立つだけで、あるいはキャンパスのメインサー -バーでも役立つかもしれません。 +主要な (primary) サーバで役立つだけで、あるいはキャンパスのメイン +サーバでも役立つかもしれません。 .PP .B filegen .I name @@ -634,9 +635,9 @@ dotted-quad .PP ファイル生成セット (file generation set) .IR name -の設定を行います。ファイル生成セットは、サーバーの活動期間を通じて継 -続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計はこ -のようなファイルの典型例です。ファイル生成セットにより、現状のデータ +の設定を行います。ファイル生成セットは、サーバの活動期間を通じて +継続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計は +このようなファイルの典型例です。ファイル生成セットにより、現状のデータ を格納するのに用いられるファイル集合にアクセスできます。任意の時点で、 集合の高々 1 つの要素への書き込みが行われます。 .I type @@ -651,11 +652,10 @@ dotted-quad .Ip prefix 10 不変なファイル名のパスです。 .B filegen -文による修正の対象にはなりません。サーバによって定義され、通常コンパ -イル時の定数として指定されます。しかし、他のコマンドにより、個別のファ -イル生成セットに対して設定は可能です。たとえば、"loopstats" と -"peerstats" という filegen で用いられるプレフィックスは、すでに説明 -した +文による修正の対象にはなりません。サーバによって定義され、通常コンパイル時の +定数として指定されます。しかし、他のコマンドにより、個別のファイル生成 +セットに対して設定は可能です。たとえば、"loopstats" と +"peerstats" という filegen で用いられるプレフィックスは、すでに説明した .B statsdir 文を使用して設定できます。 .Ip filename 10 @@ -707,19 +707,19 @@ dotted-quad .I 週 という用語は、年の始まりからの日数の 7 の商により定義されます。この ようなファイル生成セットの要素は、ファイル集合のファイル名のベースに -次のようなサフィックスをつけることで区別されます。サフィックスは、ドッ -ト, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 -年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つファ -イルに出力されます。 +次のようなサフィックスをつけることで区別されます。サフィックスは、 +ドット, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 +年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つ +ファイルに出力されます。 .Ip month 10 -1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ -フィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 +1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名の +サフィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 .Ip year 10 -1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ -フィックスは、ドットと 4 桁の西暦年からなります。 +1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名の +サフィックスは、ドットと 4 桁の西暦年からなります。 .Ip age 10 -この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要 -素に変わります。ファイル名のサフィックスは、ドット, 文字 +この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要素に +変わります。ファイル名のサフィックスは、ドット, 文字 \*(L"a\*(R", 8 桁の数からなります。この数は、対応する 24 時間の始め からサーバが実行されている秒数であるようになります。 .PP @@ -730,14 +730,14 @@ dotted-quad .I 現在の 要素に決まった名前でアクセスできると便利です。この機能は、 \*(L"link\*(R" を指定することで有効になり、 \*(L"nolink\*(R" を使っ -て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素からサ -フイックスを持たないファイルへのハードリンクが作成されます。その名前 +て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素から +サフイックスを持たないファイルへのハードリンクが作成されます。その名前 を持つファイルが既に存在し、そのファイルのリンク数が 1 の場合、その ファイル名に、ドット, 文字 \*(L"C\*(R", .I xntpd -サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 以 -上の場合、ファイルはアンリンクされます。これにより現在のファイルを定 -数名でアクセスすることができます。 +サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 +以上の場合、ファイルはアンリンクされます。これにより現在のファイルを +定数名でアクセスすることができます。 .SH "その他のオプション" .PP .B precision @@ -752,10 +752,10 @@ dotted-quad .B broadcastdelay .I seconds .PP -ブロードキャストおよびマルチキャストモードは、ローカルとリモートサー -バ間のネットワーク遅延を決定するため、特別の修正を必要とします。通常、 +ブロードキャストおよびマルチキャストモードは、ローカルとリモートサーバ間の +ネットワーク遅延を決定するため、特別の修正を必要とします。通常、 この修正は、ローカルとリモートサーバ間の最初のプロトコル交換により、 -自動的に行われます。修正手続きは、例えば、ネットワークもしくはサーバー +自動的に行われます。修正手続きは、例えば、ネットワークもしくはサーバ のアクセス制御のために失敗する可能性があります。このコマンドは、これ らの状況下で使用されるデフォルトの遅延を指定します。(イーサネットに 対する)典型としては、0.003 から 0.007 秒が適切です。このコマンドが使 @@ -771,12 +771,12 @@ dotted-quad .I interface_addess ] .PP -このコマンドは、指定されたローカルインターフェイスに送られるメッセー -ジに対する、所与のホストアドレスとポート番号でのトラップレシーバを設 -定します。ポート番号が指定されない場合、 18447 が使用されます。イン -ターフェイスアドレスが指定されない場合、メッセージが送信時に通過する -ローカルインターフェイスのアドレスをソースアドレスとしてメッセージが -送られます。マルチホームのホストでは、使用されるインターフェイスが、 +このコマンドは、指定されたローカルインタフェースに送られる +メッセージに対する、所与のホストアドレスとポート番号でのトラップレシーバを +設定します。ポート番号が指定されない場合、 18447 が使用されます。 +インタフェースアドレスが指定されない場合、メッセージが送信時に通過する +ローカルインタフェースのアドレスをソースアドレスとしてメッセージが +送られます。マルチホームのホストでは、使用されるインタフェースが、 ルーティングの変更にともない変化し得ることに注意してください。 .PP トラップレシーバは、一般には、イベントメッセージやサーバからのその他 @@ -789,8 +789,8 @@ dotted-quad .I variable .I [default] .PP -このコマンドは、付加的なシステム変数を追加します。これらの変数は、ア -クセスポリシなどの付加的な情報を配布するために使用できます。 +このコマンドは、付加的なシステム変数を追加します。これらの変数は、 +アクセスポリシなどの付加的な情報を配布するために使用できます。 = の形式の変数に、キーワード .I default が続いた場合、変数はデフォルトのシステム変数の一部としてリストされる @@ -820,8 +820,8 @@ dotted-quad コマンドに置き換えられました。ここにあげたのは歴史を述べるためです。 .SH "認証キーファイルのフォーマット" .PP -NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケッ -ト内の認証の指示を与えるための拡張を定めています。これは、 +NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケット内の +認証の指示を与えるための拡張を定めています。これは、 .I xntpd においては、デジタル署名, あるいは message-digest を計算するため、 DES もしくは MD5 アルゴリズムを使用して実装されています。この仕様は、 @@ -839,8 +839,8 @@ DES .B keys 文を使用して指定されるファイルからキーを読み込みます。キー番号 0 は、 NTP 標準によって (56 ビットの 0 として) 決定されており、変更できませ -んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任 -意にセットできます。 +んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任意に +セットできます。 .PP キーファイルは、コンフィギュレーションファイルと同様のコメント記述法 を使用しています。キーエントリはの形式の固定されたフォーマットを @@ -897,11 +897,11 @@ NTP 標 コンパイルできます。参照時計は、一般に (常にではなく)、カナダの NRC やアメリカの NIST により提供されるサービスと同様の標準時刻の供給源に 同期している無線時刻コード受信機です。コンピュータと時刻コード受信機 -の間のインターフェイスはデバイス依存で多種にわたりますが、多くはシリ -アルポートです。 +の間のインタフェースはデバイス依存で多種にわたりますが、多くは +シリアルポートです。 .PP -多種類の参照時計ドライバに対するサポートは、他の場所で記述されたコン -パイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 +多種類の参照時計ドライバに対するサポートは、他の場所で記述された +コンパイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 しようとする試みは、特定のサポートが得られないか、ハードウェアポート が適切に設定されていないとき、システムログファイルに警告を残しますが、 そのほかでは障害となりません。 @@ -917,8 +917,8 @@ NTP 標 .I t は、時計の型を示す整数で、 .I u -は、型で特定されるユニット番号を示します。参照時計は、コンフィギュレー -ションファイル中の +は、型で特定されるユニット番号を示します。参照時計は、コンフィギュレーション +ファイル中の .B server 文を使用して設定されます。このときの .I host_address @@ -974,13 +974,12 @@ NTP 標 と .B time2 オプションは、秒単位の固定小数点で指定され、いくつかの時計ドライバで -は、補正定数として使用されます。慣習により、別のやり方で示されない限 -り、 +は、補正定数として使用されます。慣習により、別のやり方で示されない限り、 .B time1 は、特定の時計の名目上の時間オフセットを、高精度の PPS 信号のような、 外部の標準に一致させるように調整するための補正定数として使用されます。 -指定されたオフセットは、内部の DIP スイッチのような他の手段により与 -えられた伝搬遅延に付加されます。 +指定されたオフセットは、内部の DIP スイッチのような他の手段により与えられた +伝搬遅延に付加されます。 .B stratum オプションは 0 から 15 までの数で、時計に対し非標準の operating stratum を割当てるのに使用します。 @@ -1001,12 +1000,12 @@ stratum .B flag4 は、 .I filegen -コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリ -ングデータの記録を有効にするために使用されます。 ppsclock ストリーム -モジュールについてのさらなる情報は、現在の xntp3 プログラムのディス -トリビューション中の ./kernel ディレクトリの README ファイル内にあり -ます。この機能についてのさらなる情報は、同じディストリビューション中 -の ./scripts/stats ディレクトリにあります。 +コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリング +データの記録を有効にするために使用されます。 ppsclock ストリーム +モジュールについてのさらなる情報は、現在の xntp3 プログラムの +ディストリビューション中の ./kernel ディレクトリの README ファイル内にあり +ます。この機能についてのさらなる情報は、 +同じディストリビューション中の ./scripts/stats ディレクトリにあります。 .PP 通常、参照時計の stratum は、デフォルトで 0 です。 .I xntpd @@ -1025,16 +1024,16 @@ discipline 現在、Unix マシン上の .I xntpd は、バックアップとして用いられる、あるいは他の時計供給源が与えられな -いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計ハー -ドウェアをサポートしています。たいていの時計ドライバの場合、xntp3 プ -ログラムのディストリビューション中の ./doc ディレクトリの README ファ -イル内で述べられているように 1-pps 精度のタイミング信号に対するサポー -トが利用可能です。時計ドライバ、およびそれらを設定するのに使用される +いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計 +ハードウェアをサポートしています。たいていの時計ドライバの場合、xntp3 +プログラムのディストリビューション中の ./doc ディレクトリの README +ファイル内で述べられているように 1-pps 精度のタイミング信号に対する +サポートが利用可能です。時計ドライバ、およびそれらを設定するのに使用される アドレスは、現在の xntp3 プログラムのディストリビューション中の doc ディレクトリの README.refclocks で記述されています。 .PP .SH 変数 - NTP protocol により用いられるたいていの変数は、 +NTP protocol により用いられるたいていの変数は、 .I xntpdc (モード 7 メッセージ) と .I ntpq @@ -1059,8 +1058,8 @@ discipline .Ip 01/10 8 リープ秒が、付加/削除されます (オペレータによるリープ秒の強制)。 .Ip 11 8 -同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が与 -えられます) 。 +同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が +与えられます) 。 .PP .SH 関連ファイル .Ip /etc/ntp.conf 20 @@ -1077,13 +1076,13 @@ discipline .SH 歴史 .PP .Nm -コマンドはトロント大学の Dennis Ferguson によって書かれました。テキ -ストはデラウェア大学の David Mills により修正されました。 +コマンドはトロント大学の Dennis Ferguson によって書かれました。 +テキストはデラウェア大学の David Mills により修正されました。 .SH バグ .PP .I xntpd -はかなり大きくなってしまいました。巨大とは言いませんが、ワークステー -ションで実行される可変プライオリティのデーモンとして望ましい大きさを +はかなり大きくなってしまいました。巨大とは言いませんが、ワークステーションで +実行される可変プライオリティのデーモンとして望ましい大きさを 超えてしまいました。それは特に、かさばる凝った特徴の多くが、高い stratum のワークステーションよりは、高負荷の主要 (primary) サーバに あわせて設計されているからです。 diff --git a/ja/man/man8/xtend.8 b/ja/man/man8/xtend.8 index acbb04180c..d56721a474 100644 --- a/ja/man/man8/xtend.8 +++ b/ja/man/man8/xtend.8 @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: xtend.8,v 1.4 1996/09/23 22:23:09 wosch Exp % +.\" %Id: xtend.8,v 1.4.2.1 1997/12/18 07:37:46 charnier Exp % .\" jpman %Id: xtend.8,v 1.2 1997/06/16 08:01:33 yugawa Stab % .\" .Th XTEND 8 "30 Oct 1993" @@ -35,56 +35,61 @@ .Dt XTEND 8 .Os BSD FreeBSD .Sh 名称 -xtend \- X-10 デーモン +.Nm xtend +.Nd X-10 デーモン .Sh 書式 -.Nm xtend +.Nm /usr/libexec/xtend .Sh 解説 -.Nm xtend +.Nm は、ユーザレベルのプログラムと TW523 X-10 コントローラとのインターフェイスを 行います。TW523 から受信した全てのパケットを記録し、全ての X-10 デバイスの 状態を可能な限り追跡し、X-10 デバイスの操作を必要とするユーザレベルの クライアントプログラムからのソケット接続を受け付けます。 .Pp -.Nm xtend +.Nm を起動すると、自分自身をフォークし、制御端末を切り離し、以降発生する 全ての X-10 の活動状況と診断メッセージを記録するログファイルを開きます。 その後、TW523 から受信したパケットの処理を開始し、X-10 のコマンドを発行する -クライアントの接続を 1 度に ひとつだけ受け付けます。通常、 xtend は、 -.Pa /etc/rc.local +クライアントの接続を 1 度にひとつだけ受け付けます。 +.Nm +は、 +.Pa /etc/rc.conf +スクリプトにて有効に設定された場合、 +.Pa /etc/rc.i386 起動スクリプトから実行されます。 .Pp -.Nm xtend +.Nm に SIGHUP を送ると、ログファイルを一旦閉じ、再び開きます。これは、 ログファイルの肥大化を避けるために、シェルスクリプトによりログファイルを 変更する場合に便利でしょう。 -.Nm xtend +.Nm が SIGTERM を受け取ると、素直にシャットダウンし、終了します。 SIGPIPE を送ると、 -.Nm xtend +.Nm は現在のクライアント接続を強制的に切り離します。 .Pp -.Nm xtend +.Nm は、クライアントのプロセスと、単純なプロトコルを用いて通信を行います。 このプロトコルは、クライアントから送られる 1 行のコマンドに対して、 デーモンが 1 行の応答を行うような単純な物です。 .Pp -.Nm xtend -には、4 種類のコマンドがあります。コマンド +.Nm +には、4 種類のコマンドがあります。コマンド: .Bl -tag .It status H U .El .Pp に対して、 -.Nm xtend +.Nm は指定されたデバイスの状態を 1 行で返答します。ここで、H はハウスコードを 示す 1 文字で、U は数字のユニットコードです。 -コマンド +コマンド: .Bl -tag .It send H U N .El .Pp に対して、 -.Nm xtend +.Nm は指定された X-10 の送信を行います。ここで、H はハウスコードを示す 1 文字で、 U は数字のユニットコードまたはリストに対する機能コード( .Pa xtend/packet.c @@ -96,25 +101,27 @@ OK .B ERROR と応答します。 -コマンド +コマンド: .Bl -tag .It dump .El .Pp に対して、 -.Nm xtend -はスプールディレクトリの ASCII ファイルに全てのデバイスの現在の状態を +.Nm +はスプールディレクトリの +.Tn ASCII +ファイルに全てのデバイスの現在の状態を ダンプします。状態のダンプに成功したかどうかに関わらず、 .B OK と応答します。 -コマンド +コマンド: .Bl -tag .It monitor H U .El .Pp に対して、 -.Nm xtend +.Nm は指定された X-10 デバイスに関する活動状況を報告するクライアントのリストに、 現在のクライアントのソケット接続を加えます。 リスト中のクライアント数の最大値 (現状では 5) を超えなければ、 @@ -124,10 +131,10 @@ OK .B ERROR を返答します。その後、 -.Nm xtend +.Nm クライアントからの接続を受け付ける通常モードに戻ります。 しかし、それ以降に指定されたデバイスの状態が変化すると、 -.Nm xtend +.Nm は ( .B status @@ -153,16 +160,18 @@ pid .It Pa /var/spool/xten/Status デバイス状態ファイル(バイナリ) .It Pa /var/spool/xtend/status.out -デバイス情報の ASCII ダンプ +デバイス情報の +.Tn ASCII +ダンプ .El .Sh バグ 現状では、クライアントのソケット接続にタイムアウトはありません。そのため、 ハングしたクライアントプログラムがあると、他のクライアントはデーモンに アクセスする事ができなくなります。 .Pp -.Nm xtend +.Nm はできる限りデバイスの状態を追跡しますが、デバイスが手動で操作された ことを知る方法はありません。これは、ほとんどの X-10 デバイスが状態の 問い合わせに対して応答する事ができないからです。 .Sh 作者 -Eugene W. Stark (stark@cs.sunysb.edu) +.An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja/man/man8/yp_mkdb.8 b/ja/man/man8/yp_mkdb.8 index b0cec06a7f..53bb573aac 100644 --- a/ja/man/man8/yp_mkdb.8 +++ b/ja/man/man8/yp_mkdb.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yp_mkdb.8,v 1.2.2.2 1997/04/15 08:04:48 jmg Exp % +.\" %Id: yp_mkdb.8,v 1.2.2.3 1997/11/18 07:32:58 charnier Exp % .\" jpman %Id: yp_mkdb.8,v 1.3 1997/05/19 17:09:21 horikawa Stab % .\" .Dd March 12, 1996 @@ -48,6 +48,7 @@ .Op Fl s .Op Fl i Ar inputfile .Op Fl o Ar outputfile +.Op Fl d Ar domainname .Op Fl m Ar mastername .Ar inputfile .Ar dbname @@ -58,40 +59,42 @@ スタイルのデータベースを作成します。 .Nm yp_mkdb はデータを -.Nm inputfile +.Ar inputfile から読み取り、 そのデータを -.Nm dbname +.Ar dbname に .Xr db 3 フォーマットで書き込みます (ハッシュテーブル法を使用します)。 入力は 'key data' の形式、 -すなわち空白で区切られた 2 つの ASCII データフィールドである必要があります。 +すなわち空白で区切られた 2 つの +.Tn ASCII +データフィールドである必要があります。 1 番目のフィールドはキーであるとされ、他は全てデータであるとされます。 通常、データベースが格納されるのは -.Nm /var/yp/[domainname] +.Pa /var/yp/[domainname] です。ここで、 -.Nm domainname +.Ar domainname はサーバが対象とする NIS ドメイン名です。 .Nm yp_mkdb が起動されるのは、通常 -.Nm /var/yp/Makefile +.Pa /var/yp/Makefile からです。 -.Nm yp_mkdb +.Nm で NIS データベースファイルをダンプし、内容検査を行えます。 セキュリティのため、 -.Nm yp_mkdb +.Nm が作成した全てのデータベースは、オーナのみ読み書き可能です (通常オーナは root です)。 .Sh オプション .Nm yp_mkdb コマンドは以下のフラグとオプションをサポートしています: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl c YPPROC_CLEAR リクエストをローカルホスト上の .Xr ypserv 8 宛に送ることを -.Nm yp_mkdb +.Nm に指示します。 このシグナルにより、 サーバはオープンしているデータベースデスクリプタをクローズし、 @@ -99,14 +102,14 @@ YPPROC_CLEAR このフラグを単体で使用した場合、 サーバにシグナルを送るだけで他には何もしません。 データベース作成コマンドとともに使用した場合には、 -.Nm yp_mkdb +.Nm は新たなデータベースが成功裏に作成された後にのみシグナルを送ります。 .It Fl b このフラグを指定すると、キーが .Em YP_INTERDOMAIN でありデータフィールドが空である特別のエントリの データベースへの追加を -.Nm yp_mkdb +.Nm に指示します。 このキーがマップ中に存在すると、 .Xr ypserv 8 @@ -124,7 +127,6 @@ YPPROC_CLEAR 他のマップに .Fl b フラグを使用しても効果はありません。 -.Pp .It Fl s このフラグは、キーが .Em YP_SECURE @@ -137,48 +139,48 @@ YPPROC_CLEAR これは主に、特権アクセスのみに制限しなければならない .Em master.passwd マップのために使用します。 -.Pp .It Fl u Ar dbname -.Pp NIS データベースをダンプします('ほどき'ます)。 既に存在する NIS データベースの内容を検査するために使用可能です。 -.It Op Fl i Ar inputfile -.Pp +.It Fl i Ar inputfile NIS マップ作成時に、キーが .Em YP_INPUT_FILE であり -.Nm inputfile +.Ar inputfile がエンコードされた特別なエントリをデータベース中に作成します。 -.It Op Fl o Ar outputfile -.Pp +.It Fl o Ar outputfile NIS マップ作成時に、キーが .Em YP_OUTPUT_FILE で -.Nm outputfile +.Ar outputfile がエンコードされた特別なエントリをデータベース中に作成します。 -.Pp -.It Op Fl m Ar mastername -.Pp +.It Fl d Ar domainname +NIS マップ作成時に、キーが +.Em YP_DOMAIN_NAME +であり +.Ar domainname +がエンコードされた特別なエントリをデータベース中に作成します。 +.It Fl m Ar mastername NIS マップ作成時に、キーが .Em YP_MASTER_NAME であり -.Nm mastername +.Ar mastername がエンコードされた特別なエントリをデータベース中に作成します。 データベース中のこのエントリは、 ドメイン中の NIS マスタサーバの名前を判定するために、 様々な NIS ユーティリティからしばしば使用されます。 デフォルトでは、 -.Nm yp_mkdb +.Nm はローカルホストが NIS マスタであるとします; -.Ar m +.Fl m オプションをすればこのデフォルトを上書きできます。 .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -.Nm yp_mkdb +.Nm を呼び出し NIS データベースを作成する Makefile .Sh 関連項目 .Xr db 3 , .Xr ypserv 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/ypbind.8 b/ja/man/man8/ypbind.8 index 008193a93b..59ad6076c5 100644 --- a/ja/man/man8/ypbind.8 +++ b/ja/man/man8/ypbind.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypbind.8,v 1.5.2.2 1997/04/15 08:09:11 jmg Exp % +.\" %Id: ypbind.8,v 1.5.2.3 1997/11/18 07:37:39 charnier Exp % .\" jpman %Id: ypbind.8,v 1.4 1997/06/18 16:55:44 horikawa Stab % .\" .Dd April 9, 1995 @@ -66,18 +66,17 @@ NIS .Nm はサーバがもう実行していないものとし、 別サーバにバインドされるまでネットワークブロードキャストを再開します。 -.Nm ypbind +.Nm は、サーバが返答しなかったことを検知するたび および新たなサーバにバインドされるたび、 警告メッセージを .Xr syslog 3 の機能を使用して記録します。 -.Pp .Sh オプション 以下のオプションが .Nm にてサポートされています: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl ypset .Xr ypset 8 コマンドを使用し、 @@ -101,17 +100,14 @@ YPBINDPROC_SETDOM フラグに似ていますが、YPBINDPROC_SETDOM リクエストがローカルホスト発の場合のみ 処理を許すという点のみ異なります。 .It Fl s -.Fl s -フラグを指定すると .Nm を安全モードで実行します: root 以外により実行されている NIS サーバ (つまり、特権 TCP ポートを使用していないもの)へのバインドを拒否します。 .It Fl S Ar domainname,server1,server2,server3,... システム管理者は -.Fl S -フラグを指定する事により、 -ypbind を特定のドメインおよび NIS サーバグループへロック出来ます。 +.Nm +を特定のドメインおよび NIS サーバグループへロック出来ます。 10 サーバまで指定できます。 domain/server 指定においては、コンマの間には空白を入れてはなりません。 このオプションを指定する事により、 @@ -151,10 +147,10 @@ domain/server .Nm はデフォルトドメインへのバインドを自動的に保持します。 .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /etc/rc.conf -compact .It Pa /var/yp/binding/[domainname].[version] NIS ドメインに関連したバインド情報を保持するファイル。 -.It Pa /etc/sysconfig +.It Pa /etc/rc.conf システムデフォルトのドメインと ypbind 開始オプションを指定する コンフィギュレーションファイル。 .El @@ -165,4 +161,4 @@ NIS .Xr ypserv 8 , .Xr ypset 8 .Sh 作者 -Theo de Raadt +.An Theo de Raadt Aq deraadt@fsa.ca diff --git a/ja/man/man8/yppush.8 b/ja/man/man8/yppush.8 index 39f2b7fdef..40cc97e6aa 100644 --- a/ja/man/man8/yppush.8 +++ b/ja/man/man8/yppush.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yppush.8,v 1.4 1996/04/03 03:23:59 wpaul Exp % +.\" %Id: yppush.8,v 1.4.2.1 1997/11/18 07:45:16 charnier Exp % .\" jpman %Id: yppush.8,v 1.3 1997/09/09 04:08:40 yugawa Stab % .\" .Dd February 5, 1995 @@ -57,14 +57,16 @@ からのみ起動されます。 .Pa /var/yp/Makefile はデフォルトでは -.Nm yppush +.Nm を起動しない事に注意して下さい: これを変えるにはまず、Makefile 中の .Nm NOPUSH=True エントリをコメントアウトしなければなりません -(デフォルトの FreeBSD の設定は小さなネットワークに +(デフォルトの +.Bx Free +の設定は小さなネットワークに 単一の NIS サーバがある状況を想定しています; この様な設定では -.Nm yppush +.Nm は不要です)。 .Pp デフォルトでは、 @@ -81,48 +83,46 @@ コピーされるマップ名と .Xr ypxfr 8 が -.Nm yppush +.Nm に `コールバック' して転送を完遂するために必要な特別な情報とが、 各リクエストに含まれます。 コールバックにおいて -.Nm yppush +.Nm が .Xr ypxfr 8 から受け取るエラーメッセージは全て標準エラー出力に出力されます。 .Pp .Sh オプション -.Nm yppush -は以下のオプションをサポートしています: -.Bl -tag -width flag +以下のオプションが使用可能です: +.Bl -tag -width indent .It Fl d Ar domain ドメイン名を指定します。 ローカルホストの NIS ドメイン名がデフォルトで使用されます。 ローカルホストのドメイン名が設定されていない場合には、 このフラグでドメイン名を指定しなければなりません。 .It Fl t Ar timeout -.Fl t -フラグにてタイムアウト値を秒単位で指定します。 +タイムアウト値を秒単位で指定します。 このタイムアウトは、 -.Nm yppush +.Nm がリスト中の次のスレーブサーバ宛にマップ転送要求を送る前に 返答をどれくらい待つかを制御します。 .It Fl j Ar #parallel jobs .Nm yppush -は通常、転送を逐次的に行います。これはどういうことかというと、 -マップ転送要求をスレーブサーバに送り、 +は通常、転送を逐次的に行います。すなわち、 +マップ転送要求を一つのスレーブサーバに送り 次のスレーブサーバに取り掛かる前に返答を待つということです。 多くのスレーブがいる環境では、 同時に複数のマップ転送を開始し、転送を並列に行う方が効率が良くなります。 .Fl j フラグにて並列処理するジョブ数を指定します: -.Nm yppush +.Nm は指定された数の転送をすぐに開始し、返答を待ちます。 並列ジョブ数がスレーブ数より少ない場合は、 -.Nm yppush +.Nm は指定されたジョブ数の処理のみを開始し、返答を待ち、 処理が完了してから残りの処理に取り掛かります。 .Pp -.Nm yppush +.Nm はコールバックを非同期に取り扱う事に注意して下さい。 これはどういうことかというと、 全てのマップ転送要求を送信する前であろうとも、 @@ -130,8 +130,6 @@ からコールバック情報を受け取るとすぐに、 この情報を表示する事を意味します。 .It Fl h Ar host -.Fl h -フラグにて、 .Pa ypservers マップ中のサーバのリストの代わりに、 ユーザが指定するマシンもしくはマシンのグループ宛にマップを転送できます。 @@ -140,7 +138,7 @@ フラグを使用します。 .It Fl p Ar path デフォルトでは、 -.Nm yppush +.Nm は全てのローカル NIS マップは .Pa /var/yp 以下に格納してあると期待しています。 @@ -149,10 +147,10 @@ システム管理者が NIS マップを別の場所に格納する状況に対処できます。 .It Fl v 冗長モード: -.Nm yppush +.Nm の実行時にデバッグ情報を表示させます。 このフラグを 2 回指定すると、 -.Nm yppush +.Nm はより冗長に情報を表示します。 .Sh 関連ファイル .Bl -tag -width Pa -compact @@ -166,7 +164,7 @@ .Sh バグ NIS v1 における NIS マップ転送機構は NIS v2 におけるものとは異なります。 このバージョンの -.Nm yppush +.Nm は NIS v2 システム宛のマップ転送のみをサポートしています。 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja/man/man8/ypserv.8 b/ja/man/man8/ypserv.8 index a021d730b7..ad8b3494ad 100644 --- a/ja/man/man8/ypserv.8 +++ b/ja/man/man8/ypserv.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypserv.8,v 1.8.2.2 1997/04/15 08:12:11 jmg Exp % +.\" %Id: ypserv.8,v 1.8.2.3 1997/11/18 07:52:07 charnier Exp % .\" jpman %Id: ypserv.8,v 1.3 1997/05/19 17:11:16 horikawa Stab % .\" .Dd February 4, 1995 @@ -44,26 +44,34 @@ .Op Fl p Ar path .Sh 解説 .Tn NIS -は RPC ベースのサービスであり、多くの UNIX ベースのマシン間で -共通のコンフィギュレーションファイルの集合を共有する事ができます。 -NIS では、 +は複数の UNIX ベースのマシン間で +共通のコンフィギュレーションファイルの集合を共有するための +RPC ベースのサービスです。 +.Tn NIS +では、 .Pa /etc/hosts , .Pa /etc/passwd , .Pa /etc/group といった、ほとんどの環境で頻繁に更新されるファイルの複数のコピーを システム管理者が更新する必要は無く、 -一箇所で更新可能な 1 組のデータを計算機の集合が共有する事を許します。 +計算機のグループで一箇所で更新可能な 1 組のデータを共有することができます。 .Pp .Nm -は NIS +は +.Tn NIS .Em ドメイン -内のクライアントシステムに NIS データベースを配布するサーバです。 -NIS ドメイン内のクライアントは +内のクライアントシステムに +.Tn NIS +データベースを配布するサーバです。 +.Tn NIS +ドメイン内のクライアントは .Xr domainname 1 コマンドを使用し、 .Nm がサービスしているドメイン名を設定しなければなりません。 -単一 NIS ドメイン中に複数のサーバが存在しうるため、 +また、単一 +.Tn NIS +ドメイン中に複数のサーバが存在しうるため、 クライアントは、 .Xr ypbind 8 を実行させ、特定のサーバに接続する必要もあります。 @@ -80,33 +88,42 @@ NIS .Nm デーモンにて全て処理可能です。 .Pp -データベース、(もしくはしばしば +データベース (もしくはしばしば .Pa マップ -と呼ばれます)は、様々なシステムファイルを元に +と呼ばれます)は、様々なシステムファイルをソースとして .Pa /var/yp/Makefile -から作成されます。 +によって作成されます。 データベースファイルは .Xr db 3 フォーマットであり、レコード数が多くとも高速に検索可能です。 -FreeBSD では、セキュリティのため、マップの読み書きは root のみ可能です。 -技術的には、パスワードマップのみこの様な制限が必要です。 +.Bx Free +では、セキュリティのため、マップの読み書きは root のみ可能です。 +技術的には、このような制限はパスワードマップにのみ必要ですが、 他のマップの内容は誰もが読める他のファイルに書いてありますので、 -この様な制約は害ではなく、現実的だと考えられています。 +この様な制約は害ではなく、現実的であると考えられています。 .Pp .Nm は -.Pa /etc/sysconfig +.Pa /etc/rc.conf にて有効にされている場合に -.Pa /etc/rc +.Pa /etc/rc.network から起動されます。 .Sh 特別な仕様 -FreeBSD のパスワードデータベースを NIS にて配布する場合には問題があります: -FreeBSD は通常、暗号化したパスワードを、root のみ読み書き可能な +.Bx Free +のパスワードデータベースを +.Tn NIS +によって配布する場合にいくつかの問題があります。 +.Bx Free +は通常、暗号化したパスワードを、root のみ読み書き可能な .Pa /etc/master.passwd -に格納します。 -このファイルを NIS マップにすると、セキュリティが完全に破れてしまいます。 +にのみ格納します。 +このファイルを +.Tn NIS +マップにすると、セキュリティが完全に破れてしまいます。 .Pp -これに対処するために、FreeBSD の +これに対処するために、 +.Bx Free +の .Nm は .Pa master.passwd.byname @@ -120,14 +137,16 @@ FreeBSD サーバはこれを利用して特権ユーザからの要求か否かを判定できます。 非特権ユーザからの全ての要求は拒否されます。 .Pp -また、FreeBSD の標準 C ライブラリ中の +また、 +.Bx Free +の標準 C ライブラリ中の .Xr getpwent 3 ルーチンは、スーパユーザが使用した場合には .Pa master.passwd.byname と .Pa master.passwd.byuid -のマップからデータを取得します: 通常のユーザが使用した場合には、 -標準の +のマップからデータを取得します。 +通常のユーザがこれらのルーチンをコールした場合には、標準の .Pa passwd.byname と .Pa passwd.byuid @@ -139,12 +158,16 @@ FreeBSD 非特権ユーザに渡しても安全です。 このように .Pa master.passwd -データベースのシャドウパスワード機構は NIS においても守られます。 +データベースのシャドウパスワード機構は +.Tn NIS +においても守られます。 .Pp .Sh 注釈 .Ss 制限 -NIS 環境にてシャドウパスワードを使用する事に起因する問題が 2 つあります。 -ユーザは次の事に気を付けねばなりません: +.Tn NIS +環境にてシャドウパスワードを使用することに起因する問題が 2 つあります。 +ユーザは次のことに気をつけねばなりません。 +.Pp .Bl -enum -offset indent .It .Sq TCP ポートが 1024 より小さい @@ -153,17 +176,25 @@ NIS これを破る事が可能です (UNIX ベースではないオペレーティングシステムを実行するマシンでも可能です)。 .It -FreeBSD システムを、シャドウパスワードをサポートしない非 FreeBSD クライアント -(ほとんどがそうです)に対するサーバにしようとしている場合には、 +.Bx Free +システムを、シャドウパスワードをサポートしない非 +.Bx Free +クライアント +(ほとんどがそうです) に対するサーバにしようとしている場合には、 .Pa /var/yp/Makefile の .Em UNSECURE=True エントリのコメントを外し、 シャドウパスワードを無効にする必要があります。 +これにより、 .Pa passwd.byname と .Pa passwd.byuid -のマップに、非 FreeBSD クライアントが NIS を通じてユーザ認証を +のマップに、非 +.Bx Free +クライアントが +.Tn NIS +を通じてユーザ認証を 行うために必要とする、 有効な暗号化されたパスワードフィールドが含まれるようになります。 .El @@ -171,10 +202,12 @@ FreeBSD .Ss セキュリティ 一般的に、リモートユーザは、ドメイン名を知ってさえいれば、RPC を .Nm -に発行し、NIS マップの内容を取得可能です。 +に発行し、 +.Tn NIS +マップの内容を取得可能です。 このような権限の無いトランザクションを防ぐために、 .Nm -は +には .Pa securenets と呼ばれる、あるホストの集合にのみアクセスを制限する機能があります。 起動時に、 @@ -184,7 +217,7 @@ FreeBSD から読み込みます。 (後述するように、このパスは、 .Fl p -オプションによって指定するパスによって変化する事に注意して下さい。) +オプションによって指定するパスによって変化することに注意して下さい。) このファイルは、空白によって区切られるネットワークとネットワークマスクからなる エントリを複数含みます。 .Dq \&# @@ -215,14 +248,17 @@ securenets .Em tcpwrapper パッケージをサポートしますが、 .Em tcpwrapper -パッケージは FreeBSD とともに配布されていないため、 +パッケージは +.Bx Free +とともに配布されていないため、 デフォルトでは組み込まれていません。 +しかし .Pa libwrap.a と .Pa tcpd.h -を持っているならば、容易に +があれば、容易に .Nm -をリコンパイル出来ます。 +を再コンパイルすることができます。 これにより、アクセス管理のために、 システム管理者は tcpwrapper のコンフィグレーションファイル ( @@ -235,38 +271,49 @@ securenets の代わりに使用できます。 .Pp 注: どちらのアクセス制御もそれなりのセキュリティを提供しますが、 -特権ポートテストと同様、 -.Dq IP 詐称(spoofing) +特権ポートテストと同様に +.Dq IP 詐称 (spoofing) 攻撃には無力であることに 注意して下さい。 .Pp .Ss NIS v1 互換性 このバージョンの .Nm -は NIS v1 クライアントに対してある程度サービス可能です。 -FreeBSD の NIS 実装は NIS v2 プロトコルのみを使用しますが、 -他の実装は古いシステムとのバックワードコンパチビリティのために -v1 プロトコルのサポートを含みます。 -このようなシステムに提供されている +は +.Tn NIS +v1 クライアントに対してある程度サービス可能です。 +.Bx Free +の +.Tn NIS +実装は +.Tn NIS +v2 プロトコルのみを使用しますが、 +他の実装では古いシステムとのバックワードコンパチビリティのために +v1 プロトコルもサポートしています。 +そのようなシステムで提供されている .Xr ypbind 8 -デーモンは、実際にはそうする事が不要であっても、 -NIS v1 サーバにバインドしようとします。 +デーモンは、実際にはおそらく不要なのですが、 +.Tn NIS +v1 サーバにバインドしようとします。 (そして、v2 サーバから返答を受け取ったとしてもサーバを探すために -ブロードキャストし続けます)。 -通常のクライアントの呼び出しがサポートされていますが、 +ブロードキャストし続けます。) このバージョンの .Nm -は v1 マップ転送要求を扱いません; -すなわち、古い NIS サーバとともに、マスタとしてもしくはスレーブとして -使用する事は出来ません。 -好運なことに、今日ではこの様なサーバは存在しない事でしょう。 +では通常のクライアントの呼び出しはサポートされていますが、 +v1 マップ転送要求は扱いません。 +すなわち、古い +.Tn NIS +サーバとともに、マスタもしくはスレーブとして使用することはできません。 +好運なことに、今日ではこの様なサーバは存在しないでしょう。 .Ss NIS クライアントでもある NIS サーバ 複数のサーバが存在するドメインにおいて、 -サーバが NIS クライアントでもある場合には、 +サーバが +.Tn NIS +クライアントでもある場合には、 .Nm の実行に注意を払う必要があります。 バインド要求をブロードキャストさせてサーバ間でバインドさせるのではなく、 -サーバを自分自身にバインドすることは一般的には良い考えです: +サーバを自分自身にバインドすることは一般的には良い考えです。 あるサーバがダウンし、他のサーバがそのサーバに依存していた場合には、 奇妙な障害が生じ得ます。(結果として全てのクライアントがタイムアウトし、 他のサーバにバインドしようとしますが、遅延は無視できず、 @@ -278,7 +325,7 @@ NIS v1 .Sh オプション 以下のオプションが .Nm -にてサポートされています: +にてサポートされています。 .Bl -tag -width flag .It Fl n このオプションは @@ -295,7 +342,7 @@ NIS v1 .Fl n フラグを指定すると、 .Nm -はさらなる処理を行います: +はさらなる処理を行います。 すぐにあきらめずに、ホスト名もしくはアドレスを DNS ネームサーバに問い合わせて 解決しようとします。 問い合わせが成功すると、 @@ -305,15 +352,21 @@ NIS v1 .Pp この仕様は SunOS 4.1.x との互換性のために用意されています。 そのシステムの標準 C ライブラリではリゾルバが腐っており、 -ホスト名とアドレスの解決のために NIS に依存していました。 -FreeBSD のリゾルバは DNS への問い合わせを直接行えますので、 -FreeBSD である NIS クライアントに対してのみサービスする場合は、 +ホスト名とアドレスの解決のために +.Tn NIS +に依存していました。 +.Bx Free +のリゾルバは DNS への問い合わせを直接行えますので、 +.Bx Free +である +.Tn NIS +クライアントに対してのみサービスする場合は、 このオプションを有効にする必要はありません。 .It Fl d サーバをデバッグモードで実行します。 通常 .Nm -は異常時のエラー(アクセス違反、ファイルアクセス失敗)のみを +は異常時のエラー (アクセス違反、ファイルアクセス失敗) のみを .Xr syslog 3 機能を使用して報告します。 デバッグモードでは、サーバは自身をバックグラウンドでは実行せず、 @@ -330,21 +383,26 @@ yp_all .It Fl p Ar path 通常 .Nm -は NIS マップは +は +.Tn NIS +マップは .Pa /var/yp -以下にあるものと期待します。 +以下にあるものと想定します。 .Fl p -フラグを使用し、別の NIS ルートパスを指定できますので、 +フラグを使用し、別の +.Tn NIS +ルートパスを指定できますので、 システム管理者はファイルシステム中の別の場所にマップファイルを移動できます。 .El .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /var/yp/[domainname]/[maps] -NIS マップ。 +.Tn NIS +マップ .It Pa /etc/host.conf -リゾルバ構成ファイル。 +リゾルバ構成ファイル .It Pa /var/yp/securenets -ホストアクセス制御ファイル。 +ホストアクセス制御ファイル .El .Sh 関連項目 .Xr ypcat 1 , @@ -355,7 +413,7 @@ NIS .Xr yppush 8 , .Xr ypxfr 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu .Sh 歴史 このバージョンの .Nm diff --git a/ja/man/man8/ypset.8 b/ja/man/man8/ypset.8 index 5cdbc60a19..25be2a654e 100644 --- a/ja/man/man8/ypset.8 +++ b/ja/man/man8/ypset.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypset.8,v 1.1.2.1 1997/03/06 08:01:10 mpp Exp % +.\" %Id: ypset.8,v 1.1.2.2 1997/11/18 07:54:08 charnier Exp % .\" jpman %Id: ypset.8,v 1.2 1997/04/06 14:59:23 horikawa Stab % .\" .Dd October 25, 1994 @@ -86,4 +86,4 @@ YP .Xr ypmatch 1 , .Xr ypbind 8 , .Sh 作者 -Theo De Raadt +.An Theo De Raadt diff --git a/ja/man/man8/ypxfr.8 b/ja/man/man8/ypxfr.8 index bc0b6c3579..0ff35e8943 100644 --- a/ja/man/man8/ypxfr.8 +++ b/ja/man/man8/ypxfr.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypxfr.8,v 1.3 1996/06/05 05:42:47 wpaul Exp % +.\" %Id: ypxfr.8,v 1.3.2.1 1997/12/19 07:35:33 charnier Exp % .\" jpman %Id: ypxfr.8,v 1.3 1997/09/09 04:09:30 yugawa Stab % .\" .Dd February 5, 1995 @@ -38,7 +38,7 @@ .Nm ypxfr .Nd "リモートのサーバからローカルホストへ NIS データベースを転送する" .Sh 書式 -.Nm ypxfr +.Nm /usr/libexec/ypxfr .Op Fl f .Op Fl c .Op Fl d Ar target domain @@ -49,26 +49,43 @@ .Ar mapname .Sh 解説 .Nm ypxfr -は NIS サービスを使用し、NIS データベース(または +は +.Tn NIS +データベース(または .Pa マップ ) -を NIS サーバから別のホストにコピーします。FreeBSD では一般的に、 +を +.Tn NIS +サービスを使用し、ある +.Tn NIS +サーバから別のサーバにコピーします。 +.Bx Free +では一般に、 +.Nm +は .Xr yppush 8 からマップ転送要求を受け取った .Xr ypserv 8 から -.Nm ypxfr -が起動されます。 -基本的には、 -.Nm ypxfr -が使用されるのは、複数の NIS サーバが単一ドメイン内で使用される環境です。 -あるサーバ(NIS マスタ)は全ての NIS マップの基準となるコピーを管理します。 -その他のサーバ(NIS スレーブ)は、(ユーザが +起動されます。 +基本的に、 +.Nm +を使用するのは、単一ドメイン内で複数の +.Tn NIS +サーバが使用される環境です。 +一台のサーバ( +.Tn NIS +マスタ)は全ての +.Tn NIS +マップの基準となるコピーを管理します。 +その他のサーバ( +.Tn NIS +スレーブ)は、マップに更新があったとき (例えば、ユーザが .Xr yppasswd 1 -を用いてパスワードを更新した時等)マップに更新があった時に、 +を用いてパスワードを更新したとき)に、 新しいバージョンのマップをマスタからコピーします。 .Pp 実行時、 -.Nm ypxfr +.Nm は一時データベースファイルを .Pa /var/yp/[domainmame] に作成し、 @@ -78,26 +95,29 @@ .Ar mapname の内容で埋めます。 マップ全体の転送が完了すると、 -.Nm ypxfr +.Nm は .Ar mapname -のオリジナルのコピーを消去し、一時ファイルを代わりにそこに置きます。 +の古いコピーを消去し、代わりに一時ファイルを置きます。 転送完了時に、 -.Nm ypxfr -は `現在のマップをクリア' する要求を、 -古いマップを参照しているかもしれないのでそれをクリアさせなければならない、 +.Nm +は `現在のマップのクリア' 要求を、 ローカルの .Xr ypserv 8 -プロセス宛に送信しようとします。 +プロセス宛に送信し、 +古いマップを参照している場合にはクリアさせようとします。 .Pp -.Nm ypxfr +.Nm が作成した全てのファイルがオーナのみ読み書き可能なのは、 セキュリティのためである事に注意して下さい。 -NIS マップとそれを格納するディレクトリは通常 root が所有しますので、 +.Tn NIS +マップとそれを格納するディレクトリは通常 root が所有しますので、 非特権ユーザによる権限の無い変更を防ぎます。 .Pp -全ての NIS サーバ間で一貫性を保持するために -.Nm ypxfr +全ての +.Tn NIS +サーバ間で一貫性を保持するために +.Nm を .Xr cron 8 ジョブとして定期的に実行する事が出来ます。 @@ -107,104 +127,138 @@ NIS .Pa passwd.byname や .Pa passwd.byuid ) -はおそらく 1 時間に 1 度変更すべきでしょう。 +はおそらく 1 時間に 1 度更新すべきでしょう。 .Xr cron 8 を使用し NIS マップを自動的に更新する事は厳密には必須ではありません。 -なぜなら、全ての更新は NIS マスタサーバ上で +なぜなら、全ての更新は +.Tn NIS +マスタサーバ上で .Pa /var/yp/Makefile が実行された時に .Xr yppush 8 にて伝搬されているはずだからです。 -ただし、通信不能となって NIS サーバ間で同期が取れなくなる事があるような +ただし、通信不能となって +.Tn NIS +サーバ間で同期が取れなくなる事があるような 大きなネットワークでは、良い実現方式です。 .Pp -.Nm ypxfr +.Nm が制御端末無しで起動された場合、例えば .Xr ypserv 8 内部から起動された場合には、 .Xr syslog 3 機構を使用して、全ての出力のログを取ります。 .Sh 注釈 -FreeBSD の -.Nm ypxfr -は FreeBSD の +.Bx Free +バージョンの +.Nm +は +.Bx Free +の .Xr rpc.ypxfrd 8 サーバと連動する特別なマップ転送プロトコルをサポートします。 このプロトコルは、 -生のマップデータベースファイルを NIS マスタサーバから転送する事を許しますので、 -特に大きな NIS マップの場合は、標準の転送方法よりも数倍高速です。 -.Nm ypxfr -コマンドは NIS マスタサーバ上に +生のマップデータベースファイルを +.Tn NIS +マスタサーバから転送する事を許しますので、 +特に大きな +.Tn NIS +マップの場合は、標準の転送方法よりも数倍高速です。 +.Nm +コマンドは +.Tn NIS +マスタサーバ上に .Xr rpc.ypxfrd 8 が登録されているかをチェックし、存在する場合にはこれを使用しようとします。 存在しない場合には、標準プロトコルを使用し、 .Xr ypserv 8 からマップの内容をコピーし、新たなマップを作成します。 .Pp -概念的には FreeBSD の ypxfrd プロトコルは +概念的には +.Bx Free +の ypxfrd プロトコルは SunOS の ypxfrd プロトコルと同じですが、 -FreeBSD のプロトコルは SunOS のプロトコルとは互換ではないため、 +.Bx Free +のプロトコルは SunOS のプロトコルとは互換ではないため、 Sun の ypxfrd サーバとともに使用する事は出来ない事に注意して下さい。 -FreeBSD のスレーブは 非 FreeBSD の NIS サーバから +FreeBSD のスレーブは +.Bx 非 Free +の +.Tn NIS +サーバから マップを転送する事が出来ますが、 -高速プロトコルを使用できるのは、マスタサーバも FreeBSD の場合だけです。 +高速プロトコルを使用できるのは、マスタサーバも +.Bx Free +の場合だけです。 .Sh オプション -以下のオプションが -.Nm ypxfr -にてサポートされています: -.Bl -tag -width flag +.Nm +がサポートするオプションは以下の通りです: +.Bl -tag -width indent .It Fl f マップ転送を強制します。通常、 -NIS マスタ上のコピーがローカルホスト上にあるコピーよりも新しくない場合には、 -.Nm ypxfr +.Tn NIS +マスタ上のコピーがローカルホスト上にあるコピーよりも新しくない場合には、 +.Nm はマップを転送しません: .Fl f フラグにより、サーバ上のバージョンが新しいか否かにかにかかわらず、 -転送を強制します。 +転送します。 .It Fl c ローカルホスト上で実行されている .Xr ypserv 8 -プロセス宛に `現在のマップをクリア' する要求を送信しません。 +プロセス宛に `現在のマップのクリア' 要求を送信しません。 このフラグは通常 .Xr ypserv 8 を実行していないマシン上で -.Nm ypxfr +.Nm を手動で起動する時に使用します。 -このフラグを指定しないと、ローカルの NIS サーバと通信できないために、 -.Nm ypxfr -が転送を中止してしまいます。 +このフラグを指定しないと、ローカルの +.Tn NIS +サーバと通信できないために、 +.Nm +は転送を中止します。 .It Fl d Ar target domain -現在の NIS ドメインではない別のドメイン名を指定します。 +現在の +.Tn NIS +ドメインではない別のドメイン名を指定します。 .It Fl h Ar source host -NIS マップのコピー元のホスト名を指定します。 +.Tn NIS +マップのコピー元のホスト名を指定します。 このオプションにより -.Nm ypxfr -が NIS マスタサーバからのみマップをコピーする事を保証できます。 +.Nm +が +.Tn NIS +マスタサーバからのみマップをコピーする事を保証できます。 .It Fl s Ar source domain マップの転送元のドメインを指定します。 -これは 2 つの NIS ドメイン間で転送を行う時に有用です。 +これは 2 つの +.Tn NIS +ドメイン間で転送を行う時に有用です。 .It Fl p Ar path -NIS マップを保持する最上位ディレクトリを指定します。 +.Tn NIS +マップを保持する最上位ディレクトリを指定します。 デフォルトではこのパスは .Pa /var/yp です。 .Fl p フラグにより別のパスを指定し、 -NIS マップを別の場所に格納する場合に対処できます。 -NIS サーバ +.Tn NIS +マップを別の場所に格納する場合に対処できます。 +.Tn NIS +サーバ .Xr ypserv 8 が別のパスを使用するように指示された場合にも、このフラグを -.Nm ypxfr +.Nm に渡します。 .It Fl C Ar taskid program-number ipaddr port .Xr yppush 8 によるマップ転送要求への応答として、 -.Nm ypxfr +.Nm が .Xr ypserv 8 から起動された場合にのみ、このオプションは使用されます。 この場合、 -.Nm ypxfr +.Nm は .Xr yppush 8 を `コールバック' して通信する必要がありますので、 @@ -227,11 +281,15 @@ NIS .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /var/yp/[domainname]/[maps] -ある NIS ドメインの NIS マップ。 +ある +.Tn NIS +ドメインの +.Tn NIS +マップ。 .El .Sh 関連項目 .Xr yp 4 , .Xr ypserv 8 , .Xr yppush 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man1/Makefile b/ja_JP.eucJP/man/man1/Makefile index 57e6863387..3198e3384a 100644 --- a/ja_JP.eucJP/man/man1/Makefile +++ b/ja_JP.eucJP/man/man1/Makefile @@ -12,7 +12,7 @@ MAN1 = a2p.1\ bison.1\ brandelf.1\ btreeop.1\ - cal.1\ + c89.1\ calendar.1\ cap_mkdb.1\ cat.1\ @@ -175,6 +175,7 @@ MAN1 = a2p.1\ md5.1\ merge.1\ mesg.1\ + minigzip.1\ mkdep.1\ mkdir.1\ mkdosfs.1\ @@ -186,6 +187,7 @@ MAN1 = a2p.1\ msgs.1\ mt.1\ mv.1\ + ncal.1\ netstat.1\ newaliases.1\ nfsstat.1\ @@ -325,6 +327,7 @@ MAN1 = a2p.1\ yes.1\ ypcat.1\ ypmatch.1\ + ypwhich.1\ yyfix.1\ zdiff.1\ zforce.1\ @@ -359,7 +362,7 @@ MLINKS+= chpass.1 ypchpass.1 chpass.1 ypchfn.1 chpass.1 ypchsh.1 MLINKS+= compress.1 uncompress.1 MLINKS+= ee.1 ree.1 MLINKS+= expand.1 unexpand.1 -MLINKS+= ftp.1 pftp.1 +MLINKS+= ftp.1 pftp.1 ftp.1 gate-ftp.1 MLINKS+= hexdump.1 hd.1 MLINKS+= lex.1 flex.1 MLINKS+= lex.1 flex++.1 @@ -380,5 +383,6 @@ MLINKS+= rtprio.1 idprio.1 MLINKS+= cksum.1 sum.1 MLINKS+= ktrace.1 trace.1 ktrace.1 truss.1 MLINKS+= uuencode.1 uudecode.1 +MLINKS+= ncal.1 cal.1 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man1/bison.1 b/ja_JP.eucJP/man/man1/bison.1 index f5db17dd65..7716ef6dfb 100644 --- a/ja_JP.eucJP/man/man1/bison.1 +++ b/ja_JP.eucJP/man/man1/bison.1 @@ -339,9 +339,9 @@ bison \-y $* ただしこれは POSIX.2 標準と非互換であるため、 将来 `+' サポートはなくなるでしょう。 .SH 関連ファイル -/usr/local/lib/bison.simple 単純なパーサ +/usr/share/misc/bison.simple 単純なパーサ .br -/usr/local/lib/bison.hairy 複雑なパーサ +/usr/share/misc/bison.hairy 複雑なパーサ .SH 関連項目 .IR yacc (1) .br diff --git a/ja_JP.eucJP/man/man1/btreeop.1 b/ja_JP.eucJP/man/man1/btreeop.1 index 8fc9a8fc35..cc8f76fe0c 100644 --- a/ja_JP.eucJP/man/man1/btreeop.1 +++ b/ja_JP.eucJP/man/man1/btreeop.1 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd April 21, 1997 +.Dd Nov 26, 1997 .\" jpman %Id: btreeop.1,v 1.3 1997/06/18 13:41:54 jsakai Stab % .Dt BTREEOP 1 .Os BSD 4 @@ -39,12 +39,10 @@ .Nm btreeop .Op Fl A .Op Fl C -.Op Fl D Ar key -.Op Fl K Ar key -.Op Fl b -.Op Fl c Ar cashesize -.Op Fl l -.Op Fl p Ar psize +.Op Fl D[keyno] Ar key +.Op Fl K[keyno] Ar key +.Op Fl L +.Op Fl k Ar prefix .Op Ar dbname .Sh 解説 .Nm btreeop @@ -55,6 +53,9 @@ は、データベースを作成したり、レコードを記入したり、(シーケンシャルや インデックスで)レコードを読み出したり、レコードを削除したりすることができます。 重複したエントリを持つこともできます。 +複数のキーが利用可能ですが、 +.Xr btree 3 +のインデックスとしてはプライマリキーだけが利用されます。 .Sh オプション 大文字はコマンドを示します。コマンドが指定されなかった場合は、 シーケンシャルな読み出しであると想定します。 @@ -64,23 +65,28 @@ btreeop はそれを作成します。 .It Fl C データベースを作成し、レコードを記入します。 -.It Fl D Ar key +.It Fl D[keyno] Ar key key を用いてレコードを削除します。 -.It Fl K Ar key +デフォルトでは、 keyno は0(すなわちプライマリキー)です。 +.It Fl K[keyno] Ar key key を用いてレコードを検索します。 -.It Fl b -バイトオーダが BIG_ENDIAN であると仮定します。デフォルトでは LITTLE_ENDIAN -です。 -.It Fl c Ar cashesize -キャッシュサイズを指定します。BTREEINFO の -.Nm info.cachesize -と等価です (btree(3) 参照)。 -.It Fl l -バイトオーダが LITTLE_ENDIAN であると仮定します。(デフォルトです) -.It Fl p Ar psize -ページサイズを指定します。BTREEINFO の -.Nm info.psize -と等価です (btree(3) 参照)。 +デフォルトでは、 keyno は0(すなわちプライマリキー)です。 +.It Fl L +全てのプライマリキーを表示します。 +以下の二つのコマンド行は、後者がはるかに速いことを除いて等価です。 + + btreeop | awk '{print $1}' | uniq + + btreeop -L +.It Fl k Ar prefix +プライマリキーとして prefix を持つレコードを検索します。 +このオプションは (-L コマンドもしくはコマンドが与えられていない場合の +ように) シーケンシャルに読み込む操作に対してだけ有効です。 +以下の二つのコマンド行は、後者がはるかに速いことを除いて等価です。 + + btreeop | awk '$1 ~ /^fo/ {print }' + + btreeop -k fo .It Ar dbname データベース名を指定します。デフォルトは 'btree' です。 .Sh データフォーマット @@ -89,8 +95,11 @@ key はデータを標準入力から読み込みます。 データのフォーマットは以下のようになります。 - Key Data\\n - Key Data\\n + プライマリキー 2番目のキー-1 2番目のキー-2 Data + (keyno = 0) (keyno = 1) (keyno = 2) + -------------------------------------------------------------- + main 246 main.c main (){\\n + func 120 library.c func(a1, a2)\\n . . . @@ -99,7 +108,7 @@ key .Bl -enum -offset indent .It -key とデータはブランク ('\\t' あるいは ' ') で区切られます。 +全ての key とデータはブランク('\\t' あるいは ' ') で区切られます。 .It key にブランクを含めることはできません。 .It @@ -132,10 +141,10 @@ key シーケンシャルな読み出し % btreeop + key1 data1 + key2 data2-2 key2 data2 key3 data3 - key2 data2-2 - key1 data1 % インデックスによる読み出し @@ -147,6 +156,14 @@ key __.VERSION 2 % +プライマリキーの一覧 + + % btreeop -L + key1 + key2 + key3 + % + レコードの削除 % btreeop -D ' __.VERSION' @@ -160,11 +177,12 @@ key .El .Sh 診断 .Nm btreeop -は、エラーが発生した場合、値 1 で終了します。その他の場合は、0 で終了します。 +は、エラーが発生した場合、 0 以外の値で終了します。 +その他の場合は、0 で終了します。 .Sh 関連項目 .Xr btree 3 .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは、FreeBSD 2.2 から登場しました。 +コマンドは、FreeBSD 2.2.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/c89.1 b/ja_JP.eucJP/man/man1/c89.1 new file mode 100644 index 0000000000..6498209396 --- /dev/null +++ b/ja_JP.eucJP/man/man1/c89.1 @@ -0,0 +1,169 @@ +.\" +.\" Copyright (c) 1997 Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: c89.1,v 1.2.2.2 1998/01/12 06:21:14 obrien Exp % +.\" " +.Dd September 17, 1997 +.Os +.Dt C89 1 +.Sh 名称 +.Nm c89 +.Nd Posix.2 対応 C 言語コンパイラ +.Sh 書式 +.Nm c89 +.Op Fl c +.Op Fl D Ar name Ns Op Ar =value +.Op ... +.Op Fl E +.Op Fl g +.Op Fl I Ar directory ... +.Op Fl L Ar directory ... +.Op Fl o Ar outfile +.Op Fl O +.Op Fl s +.Op Fl U Ar name ... +.Ar operand ... +.Sh 解説 +これは +.St -p1003.2 +標準にて要求されている、C 言語コンパイラの名称です。 +.Pp +.Nm +コンパイラは以下のオプションを受け付けます: +.Bl -tag -offset indent -width "-D name = value" +.It Fl c +コンパイル時にリンクエディットフェーズを実行しません。 +生成されたオブジェクトファイルを一切削除しません。 +.It Fl D Ar name Ns Op Ar =value +C 言語の +.Ql #define +ディレクティブ(前処理指令)で指定したかのように名前を定義します。 +.Ar =value +が与えられない場合、値 1 が使用されます。 +.Fl D +オプションは +.Fl U +オプションより低い優先度を持ちます。 +すなわち +.Ar name +が +.Fl U +と +.Fl D +の両方で使用された場合、オプションの順序によらず、 +.Ar name +は未定義になります。 +.Fl D +オプションは複数回指定可能です。 +.It Fl E +全プリプロセッサディレクティブを展開し、 +C 言語ソースファイルを標準出力へコピーします。 +コンパイルは行いません。 +.It Fl g +オブジェクトや実行ファイル中にシンボル情報を生成します。 +.It Fl I Ar directory +絶対パス名ではないヘッダを検索するアルゴリズムを、 +通常の場所を検索する前に +.Ar directory +で指定されるディレクトリを探すという方法に変更します。 +ダブルクォート (\&"\&") で括られた名前のヘッダは、 +.Ql #include +行を指定したファイルのディレクトリ、 +次に +.Fl I +オプションで指定したディレクトリ、 +最後に通常の場所で探します。 +アングルブラケット (<>) で括られた名前のヘッダは、 +.Fl I +オプションで指定したディレクトリと +通常の場所のみで探します。 +.Fl I +オプションで指定したディレクトリは指定した順番で探します。 +.Fl I +オプションは複数回指定可能です。 +.It Fl L Ar directory +.Fl l +で指定されるライブラリを検索するアルゴリズムを、 +通常の場所を検索する前に +.Ar directory +で指定されるディレクトリを探すという方法に変更します。 +.Fl L +オプションで指定したディレクトリは指定した順番で探します。 +.Fl L +は複数回指定可能です。 +.It Fl o Ar outfile +パス名 +.Ar outfile +をデフォルトの +.Pa a.out +の代りに使用し、実行可能ファイルを生成します。 +.It Fl O +コンパイル時に最適化を行います。 +.It Fl s +オブジェクトや実行ファイルを生成する時、 +実行に不要な、シンボルおよびその他の情報を取り除きます +(ストリップします)。 +.It Fl U Ar name +.Ar name +の初期定義を取り除きます。 +.Fl U +オプションは複数回指定可能です。 +.El +.Pp +オペランドは、パス名、もしくは +.Fl l +ライブラリの形式です。 +パス名オペランドが少くとも一つは指定されなければなりません。 +サポートされているオペランドの形式を以下に示します: +.Bl -tag -offset indent -width "-l library" +.It Pa file Ns \&.c +C 言語ソースファイルであり、コンパイルされます。場合によっては +リンクされます。 +.Fl c +オプション使用時には、オペランドはこの形式でなければなりません。 +.It Pa file Ns \&.a +オブジェクトファイルのライブラリであり、 +.Xr ar 1 +によって生成され、直接リンクエディタに渡されます。 +.It Pa file Ns \&.o +オブジェクトファイルであり、 +.Nm +.Fl c +によって生成され、直接リンクエディタに渡されます。 +.It Fl l Pa library +.Dl lib Ns Em library Ns \&.a +という名前のライブラリを探します。 +ライブラリの名前が出てきた時点でそのライブラリ内部が検索されるので、 +.Fl l +オペランドの位置は重要です。 +.El +.Sh 関連項目 +.Xr ar 1 , +.Xr cc 1 +.Sh 規格 +.Nm +コマンドは +.St -p1003.2 +に準拠していると確信しております。 diff --git a/ja_JP.eucJP/man/man1/catman.1 b/ja_JP.eucJP/man/man1/catman.1 index c0a546af3e..ee2d849caa 100644 --- a/ja_JP.eucJP/man/man1/catman.1 +++ b/ja_JP.eucJP/man/man1/catman.1 @@ -24,7 +24,7 @@ .\" .\" /usr/bin/catman - preformat man pages .\" -.\" %Id: catman.1,v 1.8.2.1 1996/12/10 17:23:05 joerg Exp % +.\" %Id: catman.1,v 1.8.2.2 1998/02/15 16:05:21 jkh Exp % .\" jpman %Id: catman.1,v 1.3 1997/04/01 14:14:59 horikawa Stab % .Dd Mar 12, 1995 .Dt CATMAN 1 @@ -127,9 +127,9 @@ man マニュアルの必要以上のフォーマットを避けるには ハードリンク、シンボリックリンクを使って下さい。 .Sh 関連項目 +.Xr makewhatis 1 , .Xr man 1 , -.Xr manpath 1 , -.Xr makewhatis 1 . +.Xr manpath 1 .Sh 歴史 このバージョンの .Nm catman diff --git a/ja_JP.eucJP/man/man1/cdcontrol.1 b/ja_JP.eucJP/man/man1/cdcontrol.1 index 0a0fec188d..a4e3a6fa85 100644 --- a/ja_JP.eucJP/man/man1/cdcontrol.1 +++ b/ja_JP.eucJP/man/man1/cdcontrol.1 @@ -1,4 +1,4 @@ -.\" %Id: cdcontrol.1,v 1.8.2.1 1997/09/15 06:27:47 charnier Exp % +.\" %Id: cdcontrol.1,v 1.8.2.3 1998/02/01 04:55:48 jmz Exp % .\" jpman %Id: cdcontrol.1,v 1.3 1997/07/22 09:20:03 mutoh Stab % .\" .Dd July 3, 1995 @@ -17,7 +17,10 @@ .Nm はオーディオ CD プレイヤーを操作するためのプログラムです。 device には -cd0 や mcd0 などを指定します。 +.Pa cd0 +や +.Pa mcd0 +などを指定します。 .Pp もし、device が指定されなかった場合、環境変数 .Ev DISC @@ -28,14 +31,19 @@ cd0 は対話モードになり、標準入力からコマンドを読み込みます。 .Pp 以下のオプションを使用可能です。 -.Bl -tag -width flag +.Bl -tag -width indent .It Fl s サイレントモード - テーブルヘッダ及び人間が可読なコメントを表示しません。 .It Fl v 冗長モード - 表示できる情報は全て表示します。 .It Fl f Ar discname -/dev/cd0c や mcd0 といったデバイス名を指定します。 -絶対パス及び /dev からの相対パスの指定が可能です。 +.Pa /dev/cd0c +や +.Pa mcd0 +といったデバイス名を指定します。 +絶対パス及び +.Pa /dev +からの相対パスの指定が可能です。 必要ならば最後に `c' を追加します。 .El .Pp @@ -43,38 +51,38 @@ cd0 コマンドをユニークに特定できるために必要な文字だけ指定する 必要があります。 語 -.Nm play +.Em play は省略可能です。 .Bl -tag -width Cm .It Cm play first_track last_track -.Nm first_track +.Ar first_track で指定されたトラックから -.Nm last_track +.Ar last_track で指定されたトラックまで演奏します。最初のトラックが1番になります。 .It Cm play start_m:start_s.start_f Op Ar end_m:end_s.end_f 絶対アドレス (MSF) を元に演奏します。演奏開始する時間は -.Nm start_m +.Ar start_m に演奏開始する分を、 -.Nm start_s +.Ar start_s に秒を、 -.Nm start_f +.Ar start_f にはフレーム番号を指定します。演奏終了の時間は -.Nm end_m +.Ar end_m に演奏終了する分を、 -.Nm end_s, +.Ar end_s, に秒を、 -.Nm end_f +.Ar end_f にフレーム番号を指定することで指定できます。分指定で指定できる数値は 0 から 99 の範囲の値です。秒には 0 から 59 までが指定できます。フレーム 番号は 0 から 74 までの範囲で指定できます。 .It Cm play Op Ar #start_block Op length 論理ブロック -.Nm start_block +.Ar start_block から -.Nm length +.Ar length 論理ブロック分だけ演奏します。 .It Cm pause @@ -82,7 +90,7 @@ cd0 .It Cm resume 演奏を再開します。 -.Nm pause +.Em pause で一時停止した後に使います。 .It Cm stop @@ -96,9 +104,9 @@ cd0 .It Cm setvol left_channel right_channel 左チャンネルのボリュームを -.Nm left_channel +.Ar left_channel にセットし、右チャンネルを -.Nm right_channel +.Ar right_channel にセットします。指定できる値は 0 から 255 の範囲の値です。 .It Cm volume Ar mute @@ -120,9 +128,17 @@ cd0 目次を表示します。 .It Cm status -ディスクに関する以下のような情報を表示します。 +.Op Ar audio | media | volume + +ディスクに関する以下のような情報を表示します: + +.Nm audio 現在の演奏の状態と位置、 + +.Nm media 現在のメディアカタログ状態、 + +.Nm volume 現在の左チャネル及び右チャネルのボリューム値。 .It Cm help @@ -153,9 +169,9 @@ LBA ioctl .It Pa /dev/rwcd0c .El .Sh 作者 -Jean-Marc Zucconi, -Andrey A.\ Chernov, -Serge V.\ Vakulenko +.An Jean-Marc Zucconi , +.An Andrey A.\ Chernov , +.An Serge V.\ Vakulenko .Sh 歴史 .Nm コマンドは diff --git a/ja_JP.eucJP/man/man1/chmod.1 b/ja_JP.eucJP/man/man1/chmod.1 index 24bb7bd689..46b84cdb00 100644 --- a/ja_JP.eucJP/man/man1/chmod.1 +++ b/ja_JP.eucJP/man/man1/chmod.1 @@ -34,7 +34,7 @@ .\" .\" @(#)chmod.1 8.4 (Berkeley) 3/31/94 .\" jpman %Id: chmod.1,v 1.2 1997/04/01 01:37:14 mutoh Stab % -.\" %Id: chmod.1,v 1.4.2.1 1997/02/28 07:54:25 mpp Exp % +.\" %Id: chmod.1,v 1.4.2.2 1998/02/15 10:51:43 jkh Exp % .\" .Dd March 31, 1994 .Dt CHMOD 1 @@ -104,11 +104,16 @@ .Pp .Bl -tag -width 6n -compact -offset indent .It Li 4000 -setuid (set-user-ID-on-execution) ビット。実行時にユーザ ID をセット。 +setuid (set-user-ID-on-execution) ビット。実行時にユーザ ID をセット +(ディレクトリに関しては +.Xr chmod 2 +参照)。 .It Li 2000 setgid (set-group-ID-on-execution)ビット。実行時にグループ ID をセット。 .It Li 1000 -sitcky (スティッキー) ビット。chmod(2)参照。 +sitcky (スティッキー) ビット。 +.Xr chmod 2 +参照。 .It Li 0400 所有者 (ユーザ) の読み込み許可。 .It Li 0200 diff --git a/ja_JP.eucJP/man/man1/cksum.1 b/ja_JP.eucJP/man/man1/cksum.1 index a3ae3ac152..00e2c29558 100644 --- a/ja_JP.eucJP/man/man1/cksum.1 +++ b/ja_JP.eucJP/man/man1/cksum.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)cksum.1 8.2 (Berkeley) 4/28/95 -.\" %Id: cksum.1,v 1.1.1.1.8.4 1997/09/14 23:16:54 jkh Exp % +.\" %Id: cksum.1,v 1.1.1.1.8.6 1997/11/09 16:11:13 obrien Exp % .\" jpman %Id: cksum.1,v 1.4 1997/08/10 18:27:42 horikawa Stab % .\" .Dd April 28, 1995 @@ -43,7 +43,14 @@ .Nm cksum .Nd ファイルのチェックサムとブロックカウントを表示する .Sh 書式 -.Op Fl o Ar \&1 No \&| Ar \&2 +.Oo +.Fl o Ar \&1 Xo +.No \&| +.Ar \&2 +.No \&| +.Ar \&3 +.Xc +.Oc .Op Ar file ... .Nm sum .Op Ar file ... @@ -97,6 +104,10 @@ r = s % 2^16 + (s % 2^32) / 2^16; cksum = (r % 2^16) + r / 2^16; .Ed .Pp +アルゴリズム 3 は一般に +.Ql 32bit CRC +アルゴリズムと呼ばれているものです。これは 32-bit チェックサムです。 +.Pp アルゴリズム 1, 2 のいずれも、デフォルトアルゴリズムと同じフィールドを 標準出力に書き出します。 ただし、ファイルサイズはバイト単位ではなくブロック単位となります。 diff --git a/ja_JP.eucJP/man/man1/date.1 b/ja_JP.eucJP/man/man1/date.1 index 0956349585..5a00fd11e1 100644 --- a/ja_JP.eucJP/man/man1/date.1 +++ b/ja_JP.eucJP/man/man1/date.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)date.1 8.2 (Berkeley) 11/17/93 -.\" %Id: date.1,v 1.8.2.6 1997/10/03 12:54:28 danny Exp % +.\" %Id: date.1,v 1.8.2.7 1998/02/15 11:01:38 jkh Exp % .\" jpman %Id: date.1,v 1.2 1997/03/31 23:25:55 mutoh Stab % .\" .Dd November 17, 1993 @@ -44,14 +44,14 @@ .Nd 日付と時刻の表示、設定 .Sh 書式 .Nm date +.Op Fl nu .Op Fl d Ar dst .Op Fl r Ar seconds .Op Fl t Ar minutes_west -.Op Fl nu -.Op Cm + Ns Ar format -.Op Fl v Ar [+|-]val[ymwdHM] +.Op Fl v Ns Ar [+|-]val Ns Op ymwdHM .Ar ... .Op Fl f Ar fmt Ar date | [[[[yy]mm]dd]HH]MM[\&.ss] +.Op Cm + Ns Ar format .Sh 解説 引数なしで実行すると、 .Nm date @@ -176,12 +176,12 @@ .Sh 使用例 以下のコマンド: .Bd -literal -offset indent -date ``+DATE: %m/%d/%y%nTIME: %H:%M:%S%'' +date "+DATE: 19%y-%m-%d%nTIME: %H:%M:%S" .Ed .Pp は、下のような表示を行ないます。 .Bd -literal -offset indent -DATE: 11/21/87 +DATE: 1987-11-21 TIME: 13:36:16 .Ed .Pp @@ -314,4 +314,4 @@ A .Nm date コマンドは .At v1 -から導入されました。 \ No newline at end of file +から導入されました。 diff --git a/ja_JP.eucJP/man/man1/dc.1 b/ja_JP.eucJP/man/man1/dc.1 index 3dfc2367c5..ff057edc36 100644 --- a/ja_JP.eucJP/man/man1/dc.1 +++ b/ja_JP.eucJP/man/man1/dc.1 @@ -2,11 +2,9 @@ .\" jpman %Id: dc.1,v 1.4 1997/07/26 21:29:52 horikawa Stab % .ds dc \fIdc\fP .ds Dc \fIDc\fP -.SH -名称 +.SH 名称 dc \- 任意精度の計算機 -.SH -書式 +.SH 書式 dc .SH 解説 diff --git a/ja_JP.eucJP/man/man1/dd.1 b/ja_JP.eucJP/man/man1/dd.1 index b47eb68350..d10db00eb3 100644 --- a/ja_JP.eucJP/man/man1/dd.1 +++ b/ja_JP.eucJP/man/man1/dd.1 @@ -34,7 +34,7 @@ .\" .\" @(#)dd.1 8.2 (Berkeley) 1/13/94 .\" jpman %Id: dd.1,v 1.3 1997/05/16 00:16:21 h-nokubi Stab % -.\" %Id: dd.1,v 1.2.8.2 1997/08/24 21:45:30 jkh Exp % +.\" %Id: dd.1,v 1.2.8.3 1998/02/15 11:04:28 jkh Exp % .\" .Dd January 13, 1994 .Dt DD 1 @@ -238,6 +238,13 @@ pre-4.3BSD-reno このオプションは .Cm bs= Ns Ar n によるブロックサイズ指定とは両立しません。 +.It Cm sparse +一つ以上の出力ブロックが +.Tn NUL +バイトのみからなる場合、 +.Tn NUL +で埋める代りに、必要な空間だけ出力ファイルのシークを試みます。 +結果として、疎なファイルとなります。 .It Cm swab 入力データを 2 バイトごとのペアとみなし、入れ替えます。入力が奇数 バイトだった場合、最後のデータはそのままになります。 diff --git a/ja_JP.eucJP/man/man1/df.1 b/ja_JP.eucJP/man/man1/df.1 index f103a2fe2b..fac0829467 100644 --- a/ja_JP.eucJP/man/man1/df.1 +++ b/ja_JP.eucJP/man/man1/df.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)df.1 8.2 (Berkeley) 1/13/94 +.\" %Id: df.1,v 1.4.2.3 1998/02/15 11:06:23 jkh Exp % .\" jpman %Id: df.1,v 1.2 1997/04/07 05:31:08 mutoh Stab % -.\" %Id: df.1,v 1.4.2.2 1997/09/19 06:18:10 charnier Exp % .\" .Dd January 13, 1994 .Dt DF 1 diff --git a/ja_JP.eucJP/man/man1/ed.1 b/ja_JP.eucJP/man/man1/ed.1 index fc0d4eb6d5..325013ebd9 100644 --- a/ja_JP.eucJP/man/man1/ed.1 +++ b/ja_JP.eucJP/man/man1/ed.1 @@ -1,4 +1,4 @@ -.\" %Id: ed.1,v 1.8.2.1 1997/10/12 08:09:12 jmg Exp % +.\" %Id: ed.1,v 1.8.2.2 1998/01/24 14:07:29 helbig Exp % .\" jpman %Id: ed.1,v 1.2 1997/06/09 15:03:56 jsakai Stab % .TH ED 1 "21 May 1993" .SH 名称 diff --git a/ja_JP.eucJP/man/man1/error.1 b/ja_JP.eucJP/man/man1/error.1 index 281e38dc62..bcafbc005b 100644 --- a/ja_JP.eucJP/man/man1/error.1 +++ b/ja_JP.eucJP/man/man1/error.1 @@ -48,7 +48,7 @@ .Op Fl I Ar ignorefile .Op name .Sh 解説 -.Nm error +.Nm は、エラーメッセージの解析を行ない、 多くのコンパイラや言語処理系で生成されたエラーメッセージを、 ソースファイル上で実際にエラーが発生した場所に配置させます。 @@ -57,8 +57,8 @@ スクリーンエディタのマルチウィンドウ機能の助けなしで エラーメッセージとソースコードを一緒に眺められるようにします。 .Pp -本コマンドで使用可能なオプションは以下の通りです。 -.Bl -tag -width Ds +本コマンドで使用可能なオプションは以下の通りです: +.Bl -tag -width indent .It Fl n 一切のファイルの書き換え (touch) を .Em しません。 @@ -93,7 +93,7 @@ .Dl ".c.y.foo*.h" .Pp は、 -.Nm error +.Nm コマンドが ``.c'', ``.y'', ``.foo*'', ``.h'' のいずれかのサフィックス で終了するファイル名のファイルを書き換えることを許可していることを意味します。 .It Fl s @@ -104,7 +104,7 @@ の代わりに使うファイル名を指定します。 .El .Pp -.Nm error +.Nm コマンドは、 .Ar name で指定したファイルから読み込まれた、もしくは標準入力から送られたエラー @@ -116,16 +116,16 @@ (少し変更した)エラーメッセージをコメントの形で挿入します。 言語処理系や内容によるカテゴリ分けが出来ないエラーメッセージは、 いかなるファイルにも挿入されずに、標準出力に送られます。 -.Nm error +.Nm は、全ての入力を読み終わった後でしかソースファイルを書き換えません。 .Pp -.Nm error +.Nm コマンドは、標準入力をパイプを経由して、 エラーメッセージを吐き出すプログラムにつないで使うことを想定しています。 言語処理系の中には、エラーメッセージを標準エラーに出すものもあれば、 標準出力に出すものもあります。 したがって、両方のエラーの出力先を、ともにパイプによって -.Nm error +.Nm コマンドに送ったほうがよいでしょう。 例えば、 .Xr csh 1 @@ -139,7 +139,7 @@ どんなプログラムが実行されたとしても、全てのエラーを解析する ことができるでしょう。 .Pp -.Nm error +.Nm は、 .Xr make 1 , .Xr \&cc 1 , @@ -153,29 +153,29 @@ .Xr f77 1 , .Em DEC Western Research Modula\-2 の各処理系で生成されたエラーメッセージを解析することが出来ます。 -.Nm error +.Nm コマンドは、言語プロセッサによって生成されるエラーメッセージの標準形式を 内部に持っているため、その形式の変更には敏感です。 .Em Pascal を除く全ての処理系では、エラーメッセージは1行に制限されています。 また、エラーメッセージの中には、複数のファイルの複数の行を参照する ものがあります。 -.Nm error +.Nm コマンドはエラーメッセージを複製し、そのエラーメッセージの参照する全ての行に 対して情報を付加します。 .Pp -.Nm error +.Nm コマンドは、 それぞれのエラーメッセージに対して以下の6つの動作のうち1つを行ないます。 .Bl -tag -width Em 同期 (synchronize) .It Em 同期 (synchronize) 言語処理系の中には、どのファイルを現在処理しているかについて短い メッセージを生成するものがあります。 -.Nm error +.Nm コマンドは、この情報を用いて、それぞれのエラーメッセージに ファイル名を含めないような言語についてのファイル名を判定します。 これらの同期メッセージは、 -.Nm error +.Nm コマンドによって使われ、出力されることはありません。 .It Em 捨てる (discard) 以下の2つの @@ -189,7 +189,7 @@ からのエラーメッセージは捨てます。 これは、誤ってこれらのライブラリを書き換えることがないようにするためです。 ここでもこれらのエラーメッセージは、 -.Nm error +.Nm コマンドによって使われ、出力されることはありません。 .It Em 無効化 (nullify) 特定の関数に対する @@ -222,10 +222,10 @@ .Pp 確かなエラーメッセージのみファイル挿入の候補とされます。 他のエラーメッセージは、全て -.Nm error +.Nm コマンドによって処理されるか、あるいは標準出力 に対して送られます。 -.Nm error +.Nm コマンドは、エラーメッセージをソースファイル上のエラー 行の直前の行に挿入します。 各エラーメッセージは、各言語の 1 行のコメントの形に変形されます。 @@ -246,7 +246,7 @@ 複数の行からなるコメントとプログラムの実体が同じ行にあるようなプログラムでは、 コメントの前にプログラム言語の文が現れるようにしてください。 .Pp -.Nm error +.Nm コマンドは、インタラプトシグナルおよびターミネートシグナルを受け取ります。 シグナルを受けたのがコメントを挿入する段階だった場合には、 実行中の操作を整然と終了します。 @@ -259,12 +259,12 @@ ユーザの端末 .El .Sh 歴史 -.Nm error +.Nm コマンドは、 .Bx 4.0 にて初めて実装されました。 .Sh 作者 -Robert Henry +.An Robert Henry .Sh バグ .Pp ユーザに問い合わせを行なうために、端末ファイルを直接オープンします。 @@ -274,10 +274,10 @@ Robert Henry 他のリンクファイルにはその結果が反映されません。 .Pp 言語処理系のエラーメッセージの形式が変更された場合、 -.Nm error +.Nm コマンドにはそのエラーメッセージが理解できなくなるかもしれません。 .Pp -.Nm error +.Nm コマンドは 全く機械的に処理を行うため、 1つのつまらない文法上のエラーが原因で引き起こされる @@ -287,13 +287,13 @@ Robert Henry .Pp Pascal のエラーメッセージは、本来はエラー行の後ろに来るべきです。 ( -.Nm error +.Nm コマンドは、エラー行の前にエラーメッセージを置きますが。) また、エラーのある位置を示す `\\' の配置が -.Nm error +.Nm コマンドによって乱れてしまいます。 .Pp -.Nm error +.Nm コマンドは、適度に高速に表示される .Tn CRT を見つつ仕事を行うのに適したように設計されています。 diff --git a/ja_JP.eucJP/man/man1/find.1 b/ja_JP.eucJP/man/man1/find.1 index f0aea44807..66e0e35b14 100644 --- a/ja_JP.eucJP/man/man1/find.1 +++ b/ja_JP.eucJP/man/man1/find.1 @@ -32,8 +32,8 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)find.1 8.4 (Berkeley) 4/1/94 -.\" %Id: find.1,v 1.4.2.3 1997/05/19 22:14:53 eivind Exp % +.\" @(#)find.1 8.4 (Berkeley) 4/1/94 +.\" %Id: find.1,v 1.4.2.4 1998/02/01 07:36:15 steve Exp % .\" jpman %Id: find.1,v 1.4 1997/09/23 14:13:10 horikawa Stab % .\" .Dd April 1, 1994 @@ -185,14 +185,14 @@ utility なら、真になります。 .It Ic -ls このプライマリは常に真になります。対象となっているファイルの情報を -標準出力に出力されます。出力される内容は i ノード番号、 +標準出力に出力しす。出力する内容は i ノード番号、 512 バイトブロックでのファイルの大きさ、 ファイルのパーミッション、ハードリンクの数、オーナ、グループ、 バイトで表したファイルの大きさ、最後にファイルが修正された時刻、パス名です。 ファイルがブロック型もしくはキャラクタ型のスペシャルファイルならば、 -バイトで表したファイルの大きさの代わりにメジャー番号とマイナー番号が -出力されます。ファイルがシンボリックリンクならば、 -`\`->''の後にリンク先のファイルのパス名が表示されます。 +バイトで表したファイルの大きさの代わりにメジャー番号とマイナー番号を +出力します。ファイルがシンボリックリンクならば、 +`\`->''の後にリンク先のファイルのパス名を表示します。 フォーマットは ``ls -dgils'' の出力結果と同じです。 .It Ic -mtime Ar n @@ -429,9 +429,7 @@ FIFO ユーティリティの文法は .St -p1003.2 の仕様で決められた文法のスーパセットです。 -.Fl s , -.Fl x -のオプションと +全 1 文字オプションと .Ic -inum , .Ic -print0 , .Ic -delete , diff --git a/ja_JP.eucJP/man/man1/fstat.1 b/ja_JP.eucJP/man/man1/fstat.1 index 69d173ee9f..bed98994b4 100644 --- a/ja_JP.eucJP/man/man1/fstat.1 +++ b/ja_JP.eucJP/man/man1/fstat.1 @@ -49,6 +49,8 @@ .\" となっているが、本質的な差異ではなかろう -- jpman Sakai .\"(訳中)一応，FreeBSD 2.2.1Rのマニュアルにあわせました。 .\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH +.\" uid ではなくユーザ名を指定するので、user が正しい。 +.\" .Op Fl u Ar user .Op Ar filename ... .Pp @@ -104,7 +106,7 @@ 指定されたプロセスIDのプロセスによってオープンされているすべてのファイル の情報を表示します。 .It Fl u Ar user -指定されたユーザID のユーザによってオープンされているすべてのファイル +指定されたユーザによってオープンされているすべてのファイル の情報を表示します。 .It Fl v 詳細報告モード。システムのデータ構造体を見つけるのに失敗した場合などに @@ -135,20 +137,13 @@ プロセスごとのオープンしているファイルのファイル番号、もしくは 以下の特別な名前のどれかです。 .Pp -.Bl -bullet -offset indent -compact -.It -text (実行可能テキストの inode) -.It -wd (現在のワーキングディレクトリ) -.It -root (ルートの inode) -.It -tr (カーネルトレースファイル) -.El +.Bd -literal -ragged -offset indent -compact +text - 実行可能テキストの inode +wd - 現在のワーキングディレクトリ +root - ルートの inode +tr - カーネルトレースファイル +.Ed .Pp -.\"(訳中)原文表記とは異なりますが、こちらの表示の方が読みやすいので -.\" 採用します。 -.\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH ファイル番号のあとにアスタリスク記号 ``*'' がある場合は、ファイルはinode ではなく、ソケットや .Tn FIFO diff --git a/ja_JP.eucJP/man/man1/ftp.1 b/ja_JP.eucJP/man/man1/ftp.1 index f56d2a4439..8bfd84bff7 100644 --- a/ja_JP.eucJP/man/man1/ftp.1 +++ b/ja_JP.eucJP/man/man1/ftp.1 @@ -696,7 +696,7 @@ get システムにおいては、marker は通常ファイルのバイトオフセットで指定します。 .It Ic restrict データポートの幅を制限するかをオン/オフします。 -パッシブ・モードでない時に、 +パッシブモードでない時に、 .Nm ftp クライアントは別々のデータポート上で、クライアントホストの方に リモートサーバが接続することを要求します。 @@ -1058,7 +1058,9 @@ new-line .Sh 環境変数 .Nm ftp は、以下の環境変数を使用します。 -.Bl -tag -width Fl +.Bl -tag -width "FTP_PASSIVE_MODE" +.It Ev FTP_PASSIVE_MODE +パッシブモードの FTP をデフォルトで使用します。 .It Ev HOME .Pa .netrc ファイルがあるならそのデフォルトの置き場所となります。 diff --git a/ja_JP.eucJP/man/man1/gctags.1 b/ja_JP.eucJP/man/man1/gctags.1 index 4632f433f6..57c6f57ed2 100644 --- a/ja_JP.eucJP/man/man1/gctags.1 +++ b/ja_JP.eucJP/man/man1/gctags.1 @@ -34,7 +34,7 @@ .\" .\" gctags.1 修正時には ctags.1 も同様に修正して下さい。 .\" Aug 31 1997 -.Dd Apr 21, 1997 +.Dd April 21, 1997 .Dt GCTAGS 1 .Os BSD 4 .Sh 名称 @@ -42,14 +42,14 @@ .Nd タグファイルを作成する (GLOBAL 用の特別なコマンド) .Sh 書式 .Nm gctags -.Op Fl BDFadertuwvx +.Op Fl BDFacderstuvwx .Op Fl f Ar tagsfile .Ar name ... .Sh 解説 .Nm は、指定された C, Pascal, Fortran, .Tn YACC , -lex, lisp のソースから、 +lex, lisp, アセンブリのソースから、 .Xr ex 1 コマンド用のタグファイルを作成します。 タグファイルは、指定されたオブジェクトが一群のファイル中の @@ -82,6 +82,10 @@ subroutine 既存の .Ar tags ファイルに追加します。 +.It Fl c +コンパクトフォーマットで表示します。 +.Fl x +オプション指定時にのみ有効です。 .It Fl d 引数を持たない .Li #define @@ -101,6 +105,8 @@ subroutine 関数定義ではなく関数参照の位置を提供します。 カレントディレクトリに GTAGS ファイルが必要となります ( C 言語のみ ) 。 +.It Fl s +関数以外のシンボルを集めます。 .It Fl t typedef, struct, union, enum 宣言のタグを生成します。 .It Fl u @@ -147,6 +153,10 @@ C で終わる名前のファイルは、最初の空白でない文字が `;' か `(' か `[' で あれば lisp のファイルであるとみなされ、そうでなければ lex のファイルと みなされます。 +.Nm \&.s +か +.Nm \&.S +で終るファイル名のファイルはアセンブリ言語ファイルとみなされます。 その他のファイルは、まず Pascal か Fortran の定義が含まれるか どうかがチェックされ、含まれない場合には C 形式の定義が検索されます。 .Pp @@ -175,7 +185,7 @@ GLOBAL .El .Sh 診断 .Nm -はエラーが発生すると 1 を返し、それ以外では 0 を返します。 +はエラーが発生すると非 0 を返し、それ以外では 0 を返します。 同じ名前のオブジェクトが複数出てきてもエラーとはみなされません。 .Sh 関連項目 .Xr btreeop 1 , @@ -217,6 +227,10 @@ C 複数行にわたる .Li typedef に関しても同様です。 +.Pp +アセンブリ言語サポートは完璧からは程遠く、 +ソースファイルから ENTRY() と ALTENTRY() を取り出すだけです。 +FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。 .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/getNAME.1 b/ja_JP.eucJP/man/man1/getNAME.1 index 1fdb3bd5f5..8fdf3d2ceb 100644 --- a/ja_JP.eucJP/man/man1/getNAME.1 +++ b/ja_JP.eucJP/man/man1/getNAME.1 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: getNAME.1,v 1.3 1996/08/27 20:04:12 wosch Exp % +.\" %Id: getNAME.1,v 1.3.2.2 1998/02/20 17:32:18 jkh Exp % .\" jpman %Id: getNAME.1,v 1.3 1997/07/22 17:20:08 horikawa Stab % .Dd July 8, 1996 @@ -34,7 +34,7 @@ .Sh 書式 .Nm /usr/libexec/getNAME .Op Fl itw -.Ar files ... +.Ar .Sh 解説 .Nm は、マニュアルから名称の章を取り出します。 @@ -45,7 +45,7 @@ データベースのエントリを作成します。 .Pp オプションには、以下のようなものがあります。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl i 導入エントリを作成します。 .It Fl t @@ -55,9 +55,9 @@ .El .\" .Sh バグ .Sh 関連項目 -.Xr man 1 , +.Xr apropos 1 , .Xr makewhatis 1 , -.Xr apropos 1 . +.Xr man 1 .Sh 歴史 .Nm コマンドのためのマニュアルは diff --git a/ja_JP.eucJP/man/man1/global.1 b/ja_JP.eucJP/man/man1/global.1 index 4f5dc5c4f6..5c2849ad26 100644 --- a/ja_JP.eucJP/man/man1/global.1 +++ b/ja_JP.eucJP/man/man1/global.1 @@ -29,52 +29,90 @@ .\" SUCH DAMAGE. .\" jpman %Id: global.1,v 1.3 1997/07/27 12:54:52 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd Nov 26, 1997 .Dt GLOBAL 1 .Os BSD 4 .Sh 名称 .Nm global -.Nd 指定した関数の位置を表示する +.Nd 指定したオブジェクトの位置を表示する .Sh 書式 .Nm global -.Op Fl acrx -.Ar name +.Op Fl alrvx +.Ar pattern +.Nm global -c +.Op Ar prefix +.Nm global +.Fl f[arx] +.Ar file +.Nm global +.Fl g[alvx] +.Ar pattern +.Nm global +.Fl i[v] +.Nm global +.Fl p +.Nm global +.Fl s[alvx] +.Ar pattern .Sh 解説 .Nm -は C や Yacc のソースファイル中から特定の関数の位置を見つけ出します。 +は C や Yacc のソースファイル中から特定のオブジェクトの位置を見つけ出します。 .Nm は、ソースツリー(サブディレクトリやソースファイルを持つディレクトリ)も 扱うことができます。 ツリー内のどこにあろうと、オブジェクトの相対パスを得ることができます。 - .Nm -は関数定義だけではなく、関数参照の位置も把握し、二重のエントリも -取り扱うことができます。 +は関数定義だけではなく、関数参照と他のシンボルの位置を把握します。 +二重のエントリも取り扱うことができます。 .Pp このコマンドを使う前に、ソースツリーのルートディレクトリで .Xr gtags 1 -を実行しなければなりません。 +を実行し、タグファイルを作成しなければなりません。 +それから、 +.Nm +をソースツリー下のいかなる場所からでも実行可能です。 .Pp 以下のオプションが使用可能です: .Bl -tag -width Ds +.It Ar pattern +オブジェクトパターン。POSIX 1003.2 の正規表現を使用可能です。 .It Fl a 絶対パスで表示します。デフォルトでは相対パス名で表示します。 -.It Fl c -指定された文字列で始まる名前の関数の候補を表示します。 -文字列が指定されない場合、すべての関数の名前を表示します。 +.It Fl c Op Ar prefix +指定された +.Ar prefix +で始まる名前の関数の候補を表示します。 +.Ar prefix +が指定されない場合、すべての関数の名前を表示します。 +.It Fl f Ar file +.Ar file +の全関数定義を表示します。このオプションは -x オプションを暗黙的に指定します。 +.It Fl g +パターンにマッチする全行を表示します。 +.It Fl i +タグファイルをインクリメンタルに再構築します。 +.It Fl l +現在のディレクトリ下に存在するオブジェクトを表示します。 .It Fl r 関数の参照場所を表示します。 デフォルトでは、関数の定義場所を表示します。 +.It Fl p +GTAGS の位置を表示します。 +.It Fl s +関数名ではなく指定したシンボルの位置を表示します。 +GSYMS タグファイルが必要です。 +.Xr gtags 1 +を参照してください。 .It Fl x デフォルトの出力に加えて、行番号と行の内容を表示します。 -.It Ar name -関数の名前です。perl の正規表現を用いることができます。 .Sh 関連ファイル .Bl -tag -width tags -compact .It Pa GTAGS -関数定義に関するタグファイルです。 +関数定義に関するタグファイル。 .It Pa GRTAGS -関数参照に関するタグファイルです。 +関数参照に関するタグファイル。 +.It Pa GSYMS +関数以外のシンボルのタグファイル。 .El .Sh 環境変数 以下の環境変数が global の実行に影響します。 @@ -125,11 +163,11 @@ global はエラーが発生すると 0 以外の値を、そうでなければ 0 を返します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr gtags 1 , -.Xr htags 1 . +.Xr htags 1 , +.Xr vi 1 . .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/gtags.1 b/ja_JP.eucJP/man/man1/gtags.1 index b256544c04..a65c94ddfd 100644 --- a/ja_JP.eucJP/man/man1/gtags.1 +++ b/ja_JP.eucJP/man/man1/gtags.1 @@ -29,23 +29,25 @@ .\" SUCH DAMAGE. .\" jpman %Id: gtags.1,v 1.3 1997/07/27 12:57:00 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd Sep 12, 1997 .Dt GTAGS 1 .Os BSD 4 .Sh 名称 .Nm gtags -.Nd GTAGS や GRTAGS ファイルを作成する +.Nd GTAGS, GRTAGS, GSYMS ファイルを作成する .Sh 書式 .Nm gtags -.Op Fl e -.Op Fl s +.Op Fl i +.Op Fl o ++.Op Fl v .Op Ar dbpath .Sh 解説 .Nm -は global(1) で用いる GTAGS ファイルや GRTAGS ファイルを -作成します。 +は +.Xr global 1 +で用いる GTAGS, GRTAGS, GSYMS ファイルを作成します。 .Nm -はサブディレクトリをたどり、ソースファイルを読み、関数の位置を把握して +はサブディレクトリをたどり、ソースファイルを読み、シンボルの位置を把握して その情報をタグファイルに保存します。 C や yacc やアセンブラのソースファイルがサポートされています。 このコマンドはソースツリーのルートで実行する必要があります。 @@ -56,35 +58,46 @@ C に指定します。 .Pp .Bl -tag -width Ds -.It Fl e -C のソースファイルで、一桁目の '}' を見つけた時点で関数の -終わりとします。 -.It Fl s -アセンブラのソースファイルとして扱います(*.s や *.S)。 +.It Fl i +タグファイルが最後に更新されてから更新されたファイルについてのみ +検査することにより、 +タグファイルをインクリメンタルに更新します +.It Fl o +GSYMS ファイルの作成を抑止します。 +.Xr global 1 +で +.Fl s +オプションを使用しない場合に使用してください。 +.It Fl v +冗長モード。 .Sh 関連ファイル .Bl -tag -width tags -compact .It Pa GTAGS -関数定義に関するタグファイルです。 +関数定義に関するタグファイル。 .It Pa GRTAGS -関数参照に関するタグファイルです。 +関数参照に関するタグファイル。 +.It Pa GSYMS +他のシンボルに関するタグファイル。 .El .Sh 診断 .Nm -はエラーが発生すると 1 を、そうでなければ 0 を返します。 +はエラーが発生すると非 0 を、そうでなければ 0 を返します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr global 1 , -.Xr htags 1 . +.Xr htags 1 , +.Xr vi 1 . .Sh バグ -GTAGS や GRTAGS はとても大きくなります。 +GTAGS, GRTAGS, GSYMS はとても大きくなります。 実行前にディスクの空き容量をチェックしてください。 - +.br アセンブラのサポートは完璧には程遠く、ソースファイルから ENTRY() と ALTENTRY() を抜き出すだけです。 FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。 +.br +タグファイルに関する並行制御はしていません。 .Sh 作者 Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/gtar.1 b/ja_JP.eucJP/man/man1/gtar.1 index 7893d88b10..67849b7e75 100644 --- a/ja_JP.eucJP/man/man1/gtar.1 +++ b/ja_JP.eucJP/man/man1/gtar.1 @@ -2,11 +2,12 @@ .\" See /usr/src/gnu/COPYING for conditions of redistribution .\" .\" Written by John F. Woods +.\" Updated by Robert Eckardt .\" -.\" %Id: tar.1,v 1.6.2.1 1997/06/05 23:13:54 max Exp % +.\" %Id: tar.1,v 1.6.2.3 1998/02/15 17:05:30 steve Exp % .\" jpman %Id: tar.1,v 1.2 1997/06/24 07:09:44 bobson Stab % .\" -.Dd 6 August 1994 +.Dd 25 August 1997 .Os FreeBSD .Dt TAR 1 .Sh 名称 @@ -14,10 +15,9 @@ .Nd テープアーカイバ; "tar" アーカイブファイルの操作 .Sh 書式 -.Nm -.Op Cm Bq - -.Op Cm bundled-options -.Op Ar [gnu-style-flags] +.Nm tar +.Op [-] Ns Ar bundled-options +.Op Ar gnu-style-flags .Op Ar tarfile .Op Ar blocksize .Op Ar exclude-file @@ -35,7 +35,7 @@ .Dq tar フォーマットのアーカイブファイルを作成し、アーカイブにファイルを追加したり、 またアーカイブからファイルを抽出したりします。 -tarfile は通常磁気テープを指しますが、フロッピーディスケットや +tarfile は通常磁気テープを指しますが、フロッピディスケットや 通常のファイルでも構いません。 .Pp 通常、 @@ -55,12 +55,13 @@ tarfile そして抽出 (extract) を意味しています (下記に詳細があります) 。 これらの他に、以下に詳細を述べる機能変更文字を、コマンド単語に 含めることができます。それらのいくつかは、コマンド単語内と同じ順で -コマンドライン引数を要求します (EXAMPLE セクションを参照) 。 +コマンドライン引数を要求します (使用例の節を参照) 。 機能文字と機能変更文字は、GNU 形式の引数で指定することもできます (2 つのダッシュを最初につけ、1 つのコマンド単語ごとに機能文字か 機能変更文字を 1 つだけ指定する) 。 -アーカイブから追加、抽出、またはリスト表示するためにコマンドライン指定する -ファイル名には、シェルのパターンマッチ文字列を使用することができます。 +アーカイブへの追加、アーカイブからの抽出、そしてリスト表示のために +コマンドライン指定するファイル名には、 +シェルのパターンマッチ文字列を使用することができます。 .Sh 機能 以下の機能のいずれか1つだけを必ず指定しなければなりません。 .Pp @@ -75,8 +76,8 @@ tarfile はなく、指定したファイルの中に含まれているファイルを、最初に指定 したアーカイブに追加するという効果を持ちます。 .Em 注: -このオプションは tarfile を再書き込みする必要があるため、1/4 イ -ンチカートリッジテープでは動作しません。 +このオプションは tarfile を再書き込みする必要があるため、1/4 +インチカートリッジテープでは動作しません。 .It Fl c .It Fl -create 新しいアーカイブを作成して (もしくは古い内容を切り捨てて)、指定 @@ -84,19 +85,19 @@ tarfile .It Fl d .It Fl -diff .It Fl -compare -アーカイブの中のファイルと、それに相当するファイルシステム内のファ -イルとの違いを調査します。 +アーカイブの中のファイルと、それに相当するファイルシステム内の +ファイルとの違いを調査します。 .It Fl -delete 指定されたファイルをアーカイブから削除します。(1/4 インチテープ では動作しません。) .It Fl r .It Fl -append -アーカイブの末尾にファイルを追加します。(1/4 インチテープでは動 -作しません。) +アーカイブの末尾にファイルを追加します。(1/4 インチテープでは +動作しません。) .It Fl t .It Fl -list -アーカイブ内容のリスト表示をします。もし引数としてファイル名が指 -定されていれば、そのファイルだけがリスト表示されます。そうでなけ +アーカイブ内容のリスト表示をします。もし引数としてファイル名が +指定されていれば、そのファイルだけがリスト表示されます。そうでなけ れば、アーカイブに含まれるすべてのファイルリストが表示されます。 .It Fl u .It Fl -update @@ -106,17 +107,16 @@ tarfile .It Fl x .It Fl -extract .It Fl -get -アーカイブからファイルを抽出します。可能ならば、オーナー、変更時 -刻、ファイル属性はリストアされます。もし +アーカイブからファイルを抽出します。可能ならば、オーナ、 +変更時刻、ファイル属性はリストアされます。もし .Ar file -引数が指定されていなければ、アーカイブ内の全ファイルが抽出されま -す。もし +引数が指定されていなければ、アーカイブ内の全ファイルが抽出されます。 +もし .Ar filename -引数がテープ上のディレクトリ名にマッチしていれば、そのディレクト -リとディレクトリ内のファイルが抽出されます。(ディレクトリ内のす +引数がテープ上のディレクトリ名にマッチしていれば、そのディレクトリと +ディレクトリ内のファイルが抽出されます。(ディレクトリ内のす べてのディレクトリについても同様に抽出されます。) -もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上 -記の +もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上記の .Fl -append コマンドを参照)、最後に含まれているものが他のすべてのファイルを 上書きする形で抽出されます。 @@ -125,20 +125,23 @@ tarfile の他のオプションは、組み合わせて使用することができます。 1文字オプションは、コマンド単語の中で指定することができます。 引数を与えるべきオプションの場合、オプションに続けて引数を指定し -ます。1文字オプションであれば、したコマンドラインに続けて引数を -指定することになるでしょう (以下の -.Sx EXAMPLES +ます。1文字オプションであれば、これに続くコマンドライン引数を +使用します (以下の +.Sx 使用例 を参照してください。) .Pp .Bl -tag -width "--preserve-permissions" -compact .It Fl -help -tar のすべてのコマンドオプションについて一覧と解説を表示します。 +.Nm +のすべてのコマンドオプションについて一覧と解説を表示します。 .It Fl -atime-preserve テープに書かれている、ファイルのアクセス時刻をリストアします。 (inodeの変更時刻が変更されることに注意してください!) .It Fl b .It Fl -block-size Ar number -読み書きするブロックサイズを512-byte ブロック N 個ぶんに設定します。 +読み書きするブロックサイズを +.Ar number +* 512-byte ブロック に設定します。 .It Fl B .It Fl -read-full-blocks 短い読みだしブロックを、完全なブロックに再組み立てします。 @@ -149,7 +152,7 @@ tar .Ar directory へ移動します。 .It Fl -checkpoint -アーカイブを読むときディレクトリ名を表示します。 +アーカイブを読み書きする間に読み書きしたバッファの数を表示します。 .It Fl f Ar [hostname:]file .It Fl -file Ar [hostname:]file 指定された @@ -165,10 +168,12 @@ tar .Ar file を読み書きします。"-" はファイルネームとして使用されることもありますが、 これは標準入力から読み出したり、標準出力へ書き出したりするために使用されます。 +.It Fl -force-local +コロンがある時でさえ、アーカイブファイルはローカルのものとします。 .It Fl F Ar file .It Fl -info-script Ar file .It Fl -new-volume-script Ar file -それぞれのアーカイブの最後にスクリプトを走らせます (暗黙の +それぞれのアーカイブが終ると、スクリプトを実行します (暗黙の .Fl M 指定が行なわれます。) .It Fl -fast-read @@ -176,16 +181,16 @@ tar アーカイブ内に見つかったら、その時点で終了します。 .It Fl G .It Fl -incremental -古い GNU-format インクリメンタルバックアップファイルを作成/リス -ト/抽出します。 +古い GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl g Ar file .It Fl -listed-incremental Ar file -新しい GNU-format インクリメンタルバックアップファイルを作成/リ -スト/抽出します。 +新しい GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl h .It Fl -dereference -シンボリックリンクをシンボリックのまま書き込みません。シンボリッ -クリンクが指しているデータを書き込みます。 +シンボリックリンクをシンボリックのまま書き込みません。シンボリックリンクが +指しているデータを書き込みます。 .It Fl i .It Fl -ignore-zeros アーカイブの中のゼロブロック(通常、End-Of-File を意味する)を無視します。 @@ -203,26 +208,36 @@ tar .It Fl l .It Fl -one-file-system あるファイルシステム内にあるファイルだけでアーカイブを作成します。 -(他ファイルシステムへのマウントポイントは使われません。) +(他ファイルシステムへのマウントポイントを跨ぎません。) .It Fl L Ar number .It Fl -tape-length Ar number -N*1024 バイトを書き込んだ後テープの交換を要求します。 +.Ar number +* 1024 バイト書き込んだ後でテープの交換を要求します。 .It Fl m .It Fl -modification-time ファイルの変更時刻を抽出しません。 .It Fl M .It Fl -multi-volume マルチボリュームアーカイブを作成/リスト/抽出します。 +.It Fl n +.It Fl -norecurse +作成時に再帰的にサブディレクトリを走査しません。 +.It Fl -volno-file Ar file +ボリューム番号付きのファイル名です。 .It Fl N Ar date .It Fl -after-date Ar date .It Fl -newer Ar date +作成時間が .Ar date より新しいファイルだけを抽出します。 +.It Fl -newer-mtime Ar date +変更時間が + .Ar date +より新しいファイルだけを抽出します。 .It Fl o .It Fl -old-archive .It Fl -portability -POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成し -ます。 +POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成します。 .It Fl O .It Fl -to-stdout ファイルを標準出力に抽出します。 @@ -235,7 +250,7 @@ POSIX の指定と同じ効果を持ちます。 .It Fl P .It Fl -absolute-paths -ファイル名から先頭の`/'をとりません。 +ファイル名から先頭の `/' をとりません。 .It Fl R .It Fl -record-number メッセージ中にアーカイブ内のレコード番号を埋め込み表示します。 @@ -245,6 +260,8 @@ POSIX .It Fl -same-order .It Fl -preserve-order アーカイブ内から抽出するファイルを、指定された順のままにします。 +.It Fl -show-omitted-dirs +アーカイブ作成中に除外されたディレクトリを表示します。 .It Fl S .It Fl -sparse 「少ない」ファイルを効率的に扱うようにします。 @@ -260,19 +277,26 @@ null .Fl C 指定を無効にします。 .It Fl -totals ---create によって書かれたトータルバイト数を表示します。 +.Fl -create +によって書かれたトータルバイト数を表示します。 .It Fl v .It Fl -verbose ---create でアーカイブに書くファイルや --extract でアーカイブから -取り出すファイル名をリスト表示します。ファイルの保護情報をファイ -ル名とともに表示させるには、--list を使います。 +.Fl -create +でアーカイブに書くファイルや +.Fl -extract +でアーカイブから +取り出すファイル名をリスト表示します。 +ファイルの保護情報をファイル名とともに表示させるには、 +.Fl -list +を使います。 .It Fl V Ar volume-name .It Fl -label Ar volume-name 指定された .Ar volume-name を持ったアーカイブを作成します。 .It Fl -version -tar プログラムのバージョン番号を表示します。 +.Nm +プログラムのバージョン番号を表示します。 .It Fl w .It Fl -interactive .It Fl -confirmation @@ -306,45 +330,44 @@ tar でフィルタリングします。 (これは、 .Fl d -が指定されたときは ``decompress'' を意味しなければなりません。) +が指定されたときは ``decompress'' を意味しなければなりません。) .It Fl -block-compress -テープもしくはフロッピーのために、圧縮プログラムの出力をブロック -化します。(そうでないとき奇数長を書き込むと、デバイスドライバは -それを拒絶するでしょう。) +テープもしくはフロッピのために、圧縮プログラムの出力をブロック +化します。(そうしないと、ブロック長がおかしくなり、デバイスドライバは +そのブロックを拒絶するでしょう。) .It Fl [0-7][lmh] テープドライブと密度を指定します。 -.It Fl -norecurse -作成時にサブディレクトリ内の内容を無視します。 .It Fl -unlink ファイルを作成する前に、いったん削除します。 .El .Sh 使用例 -"bert" と "ernie" というファイルを含む、ブロックサイズが 20 ブロッ -クのアーカイブを、テープドライブ /dev/rst0 に作るには、 +"bert" と "ernie" というファイルを含む、 +ブロックサイズが 20 ブロックのアーカイブを、 +テープドライブ /dev/rst0 に作るには、 .Pp .Dl tar cfb /dev/rst0 20 bert ernie .Pp もしくは .Pp -.Dl tar --create --file /dev/rst0 --block-size 20 bert ernie +.Dl tar\ --create\ --file\ /dev/rst0\ --block-size\ 20\ bert\ ernie .Pp と入力します。 .Fl f および .Fl b フラグは両方とも引数を必要としていることに注意してください。 -この引数は、コマンド単語に書かれているのと同じ順序でコマンドライ -ンから取得されます。 +この引数は、コマンド単語に書かれているのと同じ順序でコマンドラインから +取得されます。 .Pp -/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロッ -クサイズですので、上記の例は次のように単純化できます。 +/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロック +サイズですので、上記の例は次のように単純化できます。 .Pp .Dl tar c bert ernie .Pp "backup.tar" というアーカイブから、すべての C ソース及びヘッダを 抽出するには、次のようにタイプします。 .Pp -.Dl tar xf backup.tar "*.[ch]" +.Dl tar xf backup.tar '*.[ch]' .Pp シェルがカレントディレクトリ内のファイル名に展開しないよう、パタ ーンをクォートしなければならないことに注意してください。(当然、 @@ -364,7 +387,8 @@ tar cf - -C srcdir . | tar xpf - -C destdir ことに注意してください。次のようにタイプしなければならないわけで はなく、上記のような書き方で1文字フラグを使うことができます。 .Pp -.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar/ +.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar +/ .Pp 上のようにして作成したディスクの内容は、次のようにすればリスト表 示できます。 @@ -382,12 +406,29 @@ archive1.tar .Pp とタイプしてもうまくいかないことに注意してください。なぜなら、 tar アーカイブの末尾には end-of-file ブロックがあるからです。) +.Pp +srcdir ディレクトリから 1997 年 2 月 9 日 13:00 以降に変更をされた +全てのファイルをアーカイブするためには、以下の形式を使って下さい。 +.Dl tar\ -c\ -f\ backup.tar\ --newer-mtime\ 'Feb\ 9\ 13:15\ 1997'\ srcdir/ +.Pp +他の時間指定形式としては、'02/09/97 13:15', +\&'1997-02-09 13:15', '13:15 9 Feb 1997', '9 Feb 1997 13:15', +\&'Feb. 9, 1997 1:15pm', '09-Feb', '3 weeks ago', 'May first Sunday' +があります。 +正しいタイムゾーンを指定するためには、 +`13:15 CEST' や `13:15+200' を使用して下さい。 + .Sh 環境変数 -tar プログラムは、以下の環境変数を参照します。 +.Nm +プログラムは、以下の環境変数を参照します。 .Bl -tag -width "POSIXLY-CORRECT" .It POSIXLY-CORRECT -通常、tar はファイル指定の中に混ざったフラグを処理します。 -この環境変数を設定すると、tar は最初のフラグ以外の引数を見つける +通常、 +.Nm +はファイル指定の中に混ざったフラグを処理します。 +この環境変数を設定すると、 +.Nm +は最初のフラグ以外の引数を見つける とそれ以降の引数に対してフラグ処理を行なわないという、POSIX 仕様 に合わせた動作を行なうようになります。 .It SHELL @@ -415,9 +456,12 @@ tar .Xr rmt 8 .\" .Sh 規格 .Sh 歴史 -tar フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に +.Nm +フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に 原点があります。 -この tar の実装は GNU 実装であり、John Gilmore によって書かれた +この +.Nm +の実装は GNU 実装であり、John Gilmore によって書かれた パブリックドメイン tar が元になっています。 .Sh 作者 次の人を含む、大変多くの人々。[ソースの中の ChangeLog ファイルに記 diff --git a/ja_JP.eucJP/man/man1/gzip.1 b/ja_JP.eucJP/man/man1/gzip.1 index 1cc00940a6..33b733eef0 100644 --- a/ja_JP.eucJP/man/man1/gzip.1 +++ b/ja_JP.eucJP/man/man1/gzip.1 @@ -112,7 +112,7 @@ VMS .I compress は一貫性のチェックをするように設計されていませんでしたが、 .I gunzip -は .Z ファイルが正しくないことを検出できるこもあります。 +は .Z ファイルが正しくないことを検出できることもあります。 もし .Z ファイルを伸長する時にエラーに会う場合には、 標準の .I uncompress がエラーを出さないという理由で .Z ファイルは正しい diff --git a/ja_JP.eucJP/man/man1/htags.1 b/ja_JP.eucJP/man/man1/htags.1 index 5db3f2e0cd..3d77a563c5 100644 --- a/ja_JP.eucJP/man/man1/htags.1 +++ b/ja_JP.eucJP/man/man1/htags.1 @@ -29,7 +29,7 @@ .\" SUCH DAMAGE. .\" jpman %Id: htags.1,v 1.3 1997/07/27 12:58:52 horikawa Stab % .\" -.Dd Apr 21, 1997 +.Dd June 28, 1997 .Dt HTAGS 1 .Os BSD 4 .Sh 名称 @@ -38,7 +38,9 @@ .Sh 書式 .Nm htags .Op Fl a +.Op Fl f .Op Fl l +.Op Fl n .Op Fl v .Op Fl w .Op Fl d Ar tagdir @@ -67,12 +69,17 @@ .It Fl a アルファベット順の関数一覧を作成します。 大きなプロジェクトには有効でしょう。 +.It Fl f +CGI プログラムによる入力フォームと動的インデックスをサポートします。 +HTTP サーバの設定を行う必要があります。 .It Fl l 各行に対し名前のタグ()を生成し、他のハイパーテキストから このハイパーテキストの任意の行を指し示すことができるようにします。 デフォルトでは、参照されるオブジェクトがある行にのみタグを生成します。 +.It Fl n +行番号を表示します。デフォルトでは表示しません。 .It Fl v -冗長な表示を行います。 +冗長モード。 .It Fl w 警告メッセージを表示します。 .It Fl d Ar tagdir @@ -87,7 +94,7 @@ GTAGS .Sh 使用例 % cd /usr/src/sys # gtags -se - # htags -vat 'Welcom to FreeBSD kernel source tour!' + # htags -fnvat 'Welcom to FreeBSD kernel source tour!' % lynx HTML/index.html .Sh 関連ファイル .Bl -tag -width tags -compact @@ -109,10 +116,9 @@ htags .Sh 診断 エラーが発生すると .Nm -は 1 を返し、それ以外では 0 を返して終了します。 +は非 0 を返し、それ以外では 0 を返して終了します。 .Sh 関連項目 .Xr btreeop 1 , -.Xr gctags 1 , .Xr global 1 , .Xr gtags 1 . .Sh バグ @@ -122,5 +128,4 @@ htags Shigio Yamaguchi (shigio@wafu.netgate.net) .Sh 歴史 .Nm -コマンドは FreeBSD 2.2 で登場しました。 - +コマンドは FreeBSD 2.2.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/indent.1 b/ja_JP.eucJP/man/man1/indent.1 index 0152ea26e5..461e5d7fff 100644 --- a/ja_JP.eucJP/man/man1/indent.1 +++ b/ja_JP.eucJP/man/man1/indent.1 @@ -134,7 +134,7 @@ を指定すると、宣言の中のコンマの後ごとに改行を入れます。 .Fl nbc はこれを抑止します。デフォルトは -.Fl \&bc +.Fl \&nbc です。 .It Fl \&br , \&bl .Fl \&bl @@ -214,9 +214,9 @@ case です。 .It Fl d Ns Ar n プログラムコードの右側に書かれたものでない独立したコメントに関して、 -その場所を制御します。デフォルトは +その場所を制御します。例えば .Fl \&d\&1 -で、コードの字下げより 1 段左側にします。 +で、コードの字下げより 1 段左側にします。デフォルトの .Fl \&d\&0 を指定すると、プログラムコードの字下げに合わせます。下記「コメントの 字下げ」の節を参照して下さい。 @@ -241,6 +241,8 @@ case に続く .Ic if は、最初の if 文と同じだけ字下げされます。 +.Fl ei +がデフォルトです。 .It Fl fc1 , nfc1 .Fl fc1 で、コメントが 1 桁目から始まっている場合も整形します(しません)。こ @@ -251,14 +253,14 @@ case .Fl fc1 です。 .It Fl i Ns Ar n -1 段の字下げ量を指定します。デフォルトは 4 文字です。 +1 段の字下げ量を指定します。デフォルトは 8 文字です。 .It Fl \&ip , nip パラメータ宣言を左マージンからさらに字下げします(しません)。 デフォルトは .Fl \&ip です。 .It Fl l Ns Ar n -出力行の最大幅を指定します。デフォルトは 75 文字です。 +出力行の最大幅を指定します。デフォルトは 78 文字です。 .It Fl \&lp , nlp 継続行において括弧内のプログラムコードの位置を揃えます。左括弧がその 行で閉じていない時、継続行を前の行の左括弧の 1 文字後ろから始まるよ @@ -310,6 +312,9 @@ p1\ =\ first_procedure(second_procedure(p2, です。 .It Fl \&sc , nsc 全てのコメントの左端に、アスタリスク(`*') を置きます(置きません)。 +デフォルトは +.Fl sc +です。 .It Fl sob , nsob .Fl sob が指定されると、不要な空白行を取除きます。宣言部の後ろの余分な空白行 diff --git a/ja_JP.eucJP/man/man1/jot.1 b/ja_JP.eucJP/man/man1/jot.1 index c651779079..7f42bcab2b 100644 --- a/ja_JP.eucJP/man/man1/jot.1 +++ b/ja_JP.eucJP/man/man1/jot.1 @@ -32,166 +32,157 @@ .\" @(#)jot.1 8.1 (Berkeley) 6/6/93 .\" jpman %Id: jot.1,v 1.3 1997/07/22 17:41:47 horikawa Stab % .\" -.TH JOT 1 "June 6, 1993" -.UC 4 -.SH 名称 -jot \- 連なったデータか乱数データを出力する -.SH 書式 -.B jot [ -options -.B ] [ -\fRreps \fB[\fP begin \fB[\fP end \fB[\fP s \fB] ] ] ]\fP -.SH 解説 -.I jot -は、普通は数字の増加・減少・乱数・冗長データを一行毎に -出力するために使われます。 -オプションは、以下のように理解できます。 -.IP \fB\-r\fP -デフォルトの並んだデータの代わりに、乱数データを作成します。 -.IP \fB\-b\fP\ word -.I word +.Dd June 6, 1993 +.Dt JOT 1 +.Os +.Sh 名称 +.Nm jot +.Nd 連続ないしは、乱数データを出力する +.Sh 書式 +.Nm jot +.Op Fl cnr +.Op Fl b Ar word +.Op Fl w Ar word +.Op Fl s Ar string +.Op Fl p Ar precision +.Op reps Op begin Op end Op s +.Sh 解説 +.Nm jot +は、増加・減少・ランダム・冗長データを通常は数字で、一行毎に出力します。 +.Pp +以下のようなオプションが利用できます。 +.Bl -tag -width indent +.It Fl r +デフォルトの連続したデータの代わりに、乱数を作成します。 +.It Fl b Ar word +.Ar word を、繰り返し出力するだけです。 -.IP \fB\-w\fP\ word -.IR word +.It Fl w Ar word +.Ar word のあとに、生成されたデータを付け加え、出力します。 -8 進・16 進・指数・ASCII・ゼロで埋めた表示・右詰め表現は、 -適切な -.IR printf (3) +8 進・16 進・指数・ASCII・ゼロで埋めた表示・右詰め表現などは、適切な +.Xr printf 3 記法を -.IR word +.Ar word 中で指定することで、可能です。この場合、データは追加されるというよりも、 挿入されると考えてください。 -.IP \fB\-c\fP -これは、 \fB\-w %c\fP の省略形です。 -.IP \fB\-s\fP\ string -.IR string +.It Fl c +これは、 +.Fl w Ar %c +の省略形です。 +.It Fl s Ar string +.Ar string で分けられたデータを出力します。 普通は、改行文字がデータを分割します。 -.IP \fB\-n\fP -最後の改行 (通常出力に追加される) を出力しません。 -.IP \fB\-p\fP\ precision +.It Fl n +通常追加される、最後の改行を出力しません。 +.It Fl p Ar precision 整数 -.IR precision +.Ar precision で指定されたデータの文字数もしくは桁数だけ表示します。 -.BR \-p +.Fl p がない場合、精度値は -.I begin +.Ar begin と -.IR end +.Ar end の精度の大きい方です。 -.B \-p +.Fl p オプションは、 -.BR \-w +.Fl w に続く -.IR printf (3) +.Xr printf 3 記法が指定されている時には、上書きされます。 -.PP -最後の 4 つの引数はそれぞれデータ数・下界・上界と、 -幅の大きさまたは、乱数データのための種です。 -少なくともそれらの一つが指定されなければなりませんが、 -その他の 3 つは省略できます。 -引数として -.BR \- -を与えると、省略したと考えられます。 -これらの中から 3 つの引数をどのように選んでも、4 つ目は決定されます。 -4 つが指定され、計算された値 -.I reps -が衝突している場合、小さい方の値が使われます。 -指定された数が 3 つより少ない場合、 -.IR s +.El +.Pp +最後の 4 つの引数はそれぞれデータ数・下界・上界と、幅の大きさまたは、乱数のため +の種です。 +少なくともどれか一つが指定されなければなりませんが、その他の 3 つは引数として \ +- を与えると、省略できます。 +これら 3 つの引数を指定すれば、4 つ目が決まります。 +4 つとも指定されて、 +.Ar reps +の与えられた値と、計算された値とが相反する場合、小さい方を用います。 +指定された数が 3 つより少ない場合には、 +.Ar s を除いて、 -デフォルト値が左から右へ割り当てられます。 -.IR s は、 -.I begin +デフォルト値を左から右へ割り当てます。 +.Ar s +は、 +.Ar begin と -.I end -が共に指定される場合を除き、デフォルト値が設定されます。 -.PP -4 つの引数に対するデフォルトは、乱数データが要求された時を除いて、 +.Ar end +が共に指定された場合以外、デフォルト値が設定されます。 +.Pp +4 つの引数に対するデフォルトは、乱数が要求された時を除いて、 それぞれ、100, 1, 100, 1です。 乱数の種 -.I s -のデフォルトは、時間 (the time of day) に依存しています。 -.I reps -は、符号無し整数であることが期待されています。ゼロが与えられた場合は、 -無限回数となります。 -.I begin +.Ar s +のデフォルトは、時間 (the time of day) です。 +.Ar reps +は、符号無し整数であると想定されています。 +ゼロが与えられた場合は、無限回数となります。 +.Ar begin と -.I end -は、実数、もしくは文字の場合は対応する ASCII 値としてあたえられます。 +.Ar end +は、実数、もしくは文字の場合は対応する +.Tn ASCII +値としてあたえられます。 最後の引数は、実数でなければなりません。 -.PP +.Pp 乱数値は、 -.IR random (3) +.Xr random 3 を使って得られます。 名前 -.I jot +.Nm は、 APL 中の関数 -.IR iota +.Nm iota の部分から来ています。 -.SH 使用例 -.de IC -.IP -.ss 36 -.ft B -.. -.de NC -.br -.ss 12 -.PP -.. -.PP +.Sh 使用例 コマンド -.IC -jot 21 \-1 1.00 -.NC +.Dl jot 21 -1 1.00 + は、\-1 から 1 へ増加する等間隔の数字を 21 個出力します。 -ASCII 文字集合は、以下のように入力することで生成されます。 -.IC -jot \-c 128 0 -.NC -xaa から xaz までの文字列は以下のようにして表示できます。 -.IC -jot \-w xa%c 26 a -.NC -20 個のランダムな 8 文字は以下のようにして作成できます。 -.IC -jot \-r \-c 160 a z | rs \-g 0 8 -.NC +.Tn ASCII +文字集合は、以下のようにします。 +.Dl jot -c 128 0 +.Pp +xaa から xaz までの文字列は以下のようにします。 +.Dl jot -w xa%c 26 a +.Pp +20 個のランダムな 8 文字は以下のようにして作成します。 +.Dl "jot -r -c 160 a z | rs -g 0 8" +.Pp 無限に、 -.IR yes +.Em yes を出したい場合は、以下のようにします。 -.IC -jot \-b yes 0 -.NC -30 個の -.IR ed (1) -の置換コマンドを、2, 7, 12 行等のように (5 行毎に ) 適用したい場合は、 -以下の結果を使ってください。 +.Dl jot -b yes 0 +.Pp +.Xr ed 1 +の置換コマンドを、30 回、2, 7, 12 行等のように (5 行毎に ) 適用する場合の +解答例は以下のようになります。 .\"(訳中)(5 行毎に )は訳者が挿入しました。 .\" 2.2.1R 対象(1997/05/06) Takeshi MUTOH -.IC -jot \-w %ds/old/new/ 30 2 \- 5 -.NC +.Dl jot -w %ds/old/new/ 30 2 - 5 +.Pp だぶりのある 9, 9, 8, 8, 7 の様な列は、 -適切に精度とステップの大きさを設定することで、以下のように実現できます。 -.IC -jot 0 9 \- \-.5 -.NC -ファイルが正確に 1024 バイトであるように作成したければ、 -以下を使ってください。 -.IC -jot \-b x 512 > block -.NC +以下のように適切に精度とステップの大きさを設定することで、実現できます。 +.Dl jot 0 9 - -.5 +.Pp +ファイルが正確に 1024 バイトであるように作成するには、 +.Dl jot -b x 512 > block +.Pp 最後に、タブを 4 つのスペースに設定し、10 カラム目からはじまって、 -132 カラム目で終るようにするためには、以下のようにしてください。 -.IC -expand \-\`jot \-s, \- 10 132 4\` -.NC -80 文字以上の全ての行を表示するためには、以下を使ってください。 -.IC -grep \`jot \-s "" \-b . 80\` -.NC -.SH 関連項目 -ed(1), expand(1), rs(1), yes(1), printf(3), random(3), expand(1) +132 カラム目で終るようにするには、以下のようにします。 +.Dl expand -`jot -s, - 10 132 4` +.Pp +80 文字以上の行を全て表示するには、以下を使ってください。 +.Dl grep `jot -s \&"\&" -b \&. 80` +.Pp +.Sh 関連項目 +.Xr ed 1 , +.Xr expand 1 , +.Xr rs 1 , +.Xr yes 1 , +.Xr printf 3 , +.Xr random 3 diff --git a/ja_JP.eucJP/man/man1/killall.1 b/ja_JP.eucJP/man/man1/killall.1 index c1d14f30f6..159e54cad3 100644 --- a/ja_JP.eucJP/man/man1/killall.1 +++ b/ja_JP.eucJP/man/man1/killall.1 @@ -22,7 +22,7 @@ .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: killall.1,v 1.6 1996/08/27 20:04:19 wosch Exp % +.\" %Id: killall.1,v 1.6.2.1 1997/11/01 15:11:46 wosch Exp % .\" jpman %Id: killall.1,v 1.3 1997/07/22 18:03:26 horikawa Stab % .\" .Dd June 25, 1995 diff --git a/ja_JP.eucJP/man/man1/ktrace.1 b/ja_JP.eucJP/man/man1/ktrace.1 index 3694baed14..bdea6b75f1 100644 --- a/ja_JP.eucJP/man/man1/ktrace.1 +++ b/ja_JP.eucJP/man/man1/ktrace.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ktrace.1 8.1 (Berkeley) 6/6/93 -.\" %Id: ktrace.1,v 1.4.2.3 1997/09/15 08:32:07 jkh Exp % +.\" %Id: ktrace.1,v 1.4.2.4 1997/12/23 07:25:07 charnier Exp % .\" jpman %Id: ktrace.1,v 1.2 1997/05/16 00:27:14 mutoh Stab % .\" .Dd June 6, 1993 diff --git a/ja_JP.eucJP/man/man1/limits.1 b/ja_JP.eucJP/man/man1/limits.1 index c2b15f0db9..50bcfa72e0 100644 --- a/ja_JP.eucJP/man/man1/limits.1 +++ b/ja_JP.eucJP/man/man1/limits.1 @@ -17,7 +17,7 @@ .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" -.\" %Id: limits.1,v 1.2.2.2 1997/07/22 07:22:48 charnier Exp % +.\" %Id: limits.1,v 1.2.2.3 1998/02/01 06:21:47 steve Exp % .\" jpman %Id: limits.1,v 1.3 1997/06/23 15:04:52 horikawa Stab % .\" .Dd January 15, 1996 @@ -272,7 +272,6 @@ hard .Xr env 1 , .Xr limit 1 , .Xr sh 1 , -.Xr ulimit 1 , .Xr getrlimit 3 , .Xr setrlimit 3 , .Xr login_cap 3 , diff --git a/ja_JP.eucJP/man/man1/login.1 b/ja_JP.eucJP/man/man1/login.1 index 673efa45e4..d820c7f332 100644 --- a/ja_JP.eucJP/man/man1/login.1 +++ b/ja_JP.eucJP/man/man1/login.1 @@ -32,7 +32,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)login.1 8.2 (Berkeley) 5/5/94 -.\" %Id: login.1,v 1.4.2.3 1997/07/23 06:43:51 charnier Exp % +.\" %Id: login.1,v 1.4.2.4 1998/01/07 10:44:20 obrien Exp % .\" jpman %Id: login.1,v 1.3 1997/05/19 16:39:53 horikawa Stab % .\" .Dd May 5, 1994 @@ -97,6 +97,15 @@ user はそのファイルに記述された幾つかのデバイスのプロテクトとオーナを変え ます。 .Pp +ファイル +.Pa /etc/skeykeys +が存在する場合、このファイル中にユーザのエントリが存在する時には、 +.Nm +は S/key パスワード認証を行います。 +.Pa /etc/skey.access +により、 +接続元のホストやネットワークに応じて S/key パスワード使用の義務を制御します。 +.Pp 通常、ユーザがログインすると、 .Nm はシステムのコピーライト表示、 @@ -137,14 +146,18 @@ HOME, SHELL, PATH, TERM, LOGNAME, USER .Bl -tag -width /var/mail/userXXX -compact .It Pa /etc/fbtab デバイスのプロテクトの変更 +.It Pa /etc/login.access +ログインアクセス制御表 .It Pa /etc/login.conf ログインクラスケーパビリティデータベース .It Pa /etc/motd ログイン時に最初に表示するメッセージ .It Pa /etc/nologin ログインを拒否する時に表示するメッセージ -.It Pa /etc/login.access -ログインの許可・拒否の設定 +.It Pa /etc/skey.access +skey パスワード制御表 +.It Pa /etc/skeykeys +skey パスワードデータベース .It Pa /var/run/utmp 現在のログイン状況 .It Pa /var/log/lastlog @@ -161,10 +174,12 @@ last login account records .Xr chpass 1 , .Xr passwd 1 , .Xr rlogin 1 , +.Xr skey 1 , .Xr getpass 3 , .Xr fbtab 5 , .Xr login.access 5 , .Xr login.conf 5 , +.Xr skey.access 5 , .Xr utmp 5 , .Xr environ 7 , .Xr nologin 8 diff --git a/ja_JP.eucJP/man/man1/ls.1 b/ja_JP.eucJP/man/man1/ls.1 index c8205ca922..c876eb30b3 100644 --- a/ja_JP.eucJP/man/man1/ls.1 +++ b/ja_JP.eucJP/man/man1/ls.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)ls.1 8.6 (Berkeley) 4/18/94 -.\" %Id: ls.1,v 1.5.2.4 1997/09/19 06:18:11 charnier Exp % +.\" %Id: ls.1,v 1.5.2.5 1997/12/25 09:35:55 hoek Exp % .\" jpman %Id: ls.1,v 1.3 1997/05/19 17:21:06 horikawa Stab % .\" .Dd April 18, 1994 diff --git a/ja_JP.eucJP/man/man1/mail.1 b/ja_JP.eucJP/man/man1/mail.1 index e8fc8a7d23..e4f46d5031 100644 --- a/ja_JP.eucJP/man/man1/mail.1 +++ b/ja_JP.eucJP/man/man1/mail.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)mail.1 8.2 (Berkeley) 12/30/93 +.\" %Id: mail.1,v 1.8.2.3 1998/01/05 00:02:15 jraynard Exp % .\" jpman %Id: mail.1,v 1.3 1997/10/30 01:42:49 h-nokubi Stab % -.\" %Id: mail.1,v 1.8.2.2 1997/09/15 08:41:46 jkh Exp % .\" .Dd December 30, 1993 .Dt MAIL 1 diff --git a/ja_JP.eucJP/man/man1/merge.1 b/ja_JP.eucJP/man/man1/merge.1 index 185e9a777a..3a5c9f1465 100644 --- a/ja_JP.eucJP/man/man1/merge.1 +++ b/ja_JP.eucJP/man/man1/merge.1 @@ -3,10 +3,8 @@ .ds Rv \\$3 .ds Dt \\$4 .. -.Id %Id: merge.1,v 1.2 1995/10/28 21:50:04 peter Exp % +.Id %Id: merge.1,v 1.2.2.1 1998/02/16 18:22:13 jkh Exp % .ds r \&\s-1RCS\s0 -.\"(訳注)これを定義しないと -V が正しく表示されない -.\" 2.2.2R 対象(1997/07/21) Kazuo Horikawa .TH MERGE 1 \*(Dt GNU .SH 名称 merge \- 3 つのファイル併合 @@ -124,8 +122,6 @@ merge \- 3 .BI \-q 沈黙モード。衝突に対して警告を出しません。 .TP -.\"(訳注)この.TPは原文にありませんが、追加しました。 -.\" 2.2.1R 対象(1997/05/13) Takeshi MUTOH .BI \-V \*r のバージョン番号を出力します。 .SH 診断 diff --git a/ja_JP.eucJP/man/man1/minigzip.1 b/ja_JP.eucJP/man/man1/minigzip.1 new file mode 100644 index 0000000000..7f5de7af4d --- /dev/null +++ b/ja_JP.eucJP/man/man1/minigzip.1 @@ -0,0 +1,69 @@ +.\" Copyright (c) 1997 +.\" Michael Smith +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: minigzip.1,v 1.2.2.2 1998/01/14 14:11:16 tg Exp % +.\" +.Dd December 13, 1997 +.Dt MINIGZIP 1 +.Os +.Sh 名称 +.Nm minigzip +.Nd 'gzip' 圧縮ツールの最小限度の実装 +.Sh 書式 +.Nm minigzip +.Op Fl d +.Op Ar file ... +.Sh 解説 +.Nm +は +.Xr gzip 1 +ユーティリティの最小限度の実装です。 +標準入出力を通してのストリーム圧縮・伸長と、 +個々のファイルの圧縮・伸長を提供します。 +.Pp +デフォルトの操作は圧縮で、伸長は +.Fl d +フラグをコマンドラインで与えることで選択されます。 +.Pp +もしも +.Ar file +引数が与えられた場合、この操作は個々のファイルに別々に適用されます。 +圧縮すると、オリジナルファイルを、 +.Pa .gz +サフィックスをつけたファイルと置き換えます。 +伸長は +.Pa .gz +サフィックスが存在すればそれを取り除きます。 +.Pp +.Ar file +引数が与えられなかった場合、 +.Nm +は標準入力から読み込み、操作の結果を標準出力に書き出します。 +.Sh 関連項目 +.Xr gzip 1 +.Sh 作者 +.Nm +は、 +.An Jean-loup Gailly +によって書かれました。 diff --git a/ja_JP.eucJP/man/man1/mv.1 b/ja_JP.eucJP/man/man1/mv.1 index 53c266c29d..c7a742ceb6 100644 --- a/ja_JP.eucJP/man/man1/mv.1 +++ b/ja_JP.eucJP/man/man1/mv.1 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mv.1 8.1 (Berkeley) 5/31/93 -.\" %Id: mv.1,v 1.7 1996/08/29 18:06:04 wosch Exp % +.\" %Id: mv.1,v 1.7.2.1 1998/02/15 11:16:27 jkh Exp % .\" jpman %Id: mv.1,v 1.2 1997/03/29 06:23:50 horikawa Stab % .\" .Dd May 31, 1993 diff --git a/ja_JP.eucJP/man/man1/ncal.1 b/ja_JP.eucJP/man/man1/ncal.1 new file mode 100644 index 0000000000..85a2fe3058 --- /dev/null +++ b/ja_JP.eucJP/man/man1/ncal.1 @@ -0,0 +1,118 @@ +.\" Copyright (c) 1997 Wolfgang Helbig +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ncal.1,v 1.5.2.2 1998/01/12 06:21:22 obrien Exp % +.\" jpman %Id: cal.1,v 1.2 1997/05/17 15:48:43 horikawa Stab % +.\". +.Dd December 16, 1997 +.Dt CAL 1 +.Os +.Sh 名称 +.Nm cal , +.Nm ncal +.Nd カレンダおよびイースターの日付を表示する +.Sh 書式 +.Nm cal +.Op Fl jy +.Op Oo Ar month Oc Ar \ year +.Nm ncal +.Op Fl jJpwy +.Op Fl s Ar country_code +.Op Oo Ar month Oc Ar \ year +.Nm ncal +.Op Fl Jeo +.Op Ar year +.Sh 解説 +.Nm cal +は簡単なカレンダを表示します。 +また +.Nm ncal +は別のフォーマット、追加のオプション、イースターの日付も提供します。 +新しいフォーマットは込み入っていますが、 +25x80 文字の端末で一年が表示できます。 +引数が指定されなかった場合は今月のものを表示します。 +.Pp +オプションには以下のものがあります: +.Bl -tag -width indent +.It Fl J +ユリウス暦でカレンダーを表示します。 +.Fl e +オプションと共に使用すると、ユリウス暦でのイースターを表示します。 +.It Fl e +イースターの日付を表示します (西方教会)。 +.It Fl j +ユリウス日で表示します。(1 月 1 日を第 1 日とする通日です) +(訳注:天文学での定義とは異なります。[Mar.1996]) +.It Fl o +東方正教会のイースターの日付を表示します (ギリシャおよびロシアの東方正教会)。 +.It Fl p +カントリーコードと、ユリウス暦からグレゴリオ暦へ移行したと +.Nm ncal +が見なす日付を表示します。 +ローカル環境で定義されるカントリーコードにはアスタリスクが表示されます。 +.It Fl s Ar country_code +ユリウス暦からグレゴリオ暦へ移行した日付を +.Ar country_code +に基づくものとします。 +指定しない場合には、 +.Nm ncal +はローカル環境に基づき推定しますが、 +推定に失敗した場合は、1752 年 9 月 2 日であるとします。 +この日付は、英国およびその植民地がグレゴリオ暦に移行した日付です。 +.It Fl w +週のカラムの下に週の番号を表示します。 +.It Fl y +今年のカレンダを表示します。 +.El +.Pp +パラメータが 1 つの時は西暦年 (1 - 9999) を指定したものとして、 +その年のカレンダを表示します。 +年は完全な形で指定して下さい。例えば +.Dq Li cal 89 +では 1989 年のカレンダを表示 +.Em しません +。パラメータが 2 つの時は月 (1 - 12) と年を指定します。 +.Pp +一年は 1 月 1 日から始まります。 +.Pp +.Sh 関連項目 +.Xr calendar 3 , +.Xr strftime 3 +.Rs +.Sh 歴史 +.Nm cal +コマンドは +.At v6 +から登場しました。 +.Nm ncal +は +.Fx 2.2.5 +の後に登場しました。 +.Sh 作者 +このコマンドとマニュアルは +.An Wolfgang Helbig Aq helbig@FreeBSD.ORG +が作成しました。 +.Sh バグ +ユリウス暦からグレゴリオ暦に移行した日付とカントリーコードの対応は、 +多くの国にについて不適当です。 diff --git a/ja_JP.eucJP/man/man1/passwd.1 b/ja_JP.eucJP/man/man1/passwd.1 index 554ac50609..95a81992fa 100644 --- a/ja_JP.eucJP/man/man1/passwd.1 +++ b/ja_JP.eucJP/man/man1/passwd.1 @@ -30,6 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)passwd.1 8.1 (Berkeley) 6/6/93 +.\" %Id: passwd.1,v 1.5.2.2 1998/01/03 19:16:40 steve Exp % .\" jpman %Id: passwd.1,v 1.4 1997/07/21 09:41:51 konuma Stab % .\" .Dd June 6, 1993 diff --git a/ja_JP.eucJP/man/man1/patch.1 b/ja_JP.eucJP/man/man1/patch.1 index 2cce0586ce..c2f8875737 100644 --- a/ja_JP.eucJP/man/man1/patch.1 +++ b/ja_JP.eucJP/man/man1/patch.1 @@ -1,13 +1,11 @@ .\" -*- nroff -*- .rn '' }` .\" jpman %Id: patch.1,v 1.3 1997/09/10 04:34:14 yugawa Stab % -'\" %Header: /home/ncvs/src/gnu/usr.bin/patch/patch.1,v 1.5 1996/02/07 23:47:55 jdp Exp % +'\" %Header: /home/ncvs/src/gnu/usr.bin/patch/patch.1,v 1.5.2.3 1998/01/22 07:45:53 ache Exp % '\" '\" %Log: patch.1,v % -'\" Revision 1.5 1996/02/07 23:47:55 jdp -'\" Update the manual page to reflect the fact that an "Index" line -'\" now takes precedence over a context diff header for determining -'\" the name of the file to patch. +'\" Revision 1.5.2.1 1998/01/11 20:45:30 ache +'\" Back out rev1.5 change, Index: precedence restored to historycal behaviour '\" '\" Revision 1.4 1994/02/25 21:45:59 phk '\" added the -C/-check again. @@ -222,7 +220,7 @@ context diff もしヘッダに \*(L"Index:\*(R" いう行があったら .I patch はここから得たファイル名を使うことを試みます。 -Index 行は、もしあれば、context diff ヘッダに優先して用いられます。 +context diff ヘッダは Index 行に優先して用いられます。 もしファイル名を見つけることができなかった場合、 パッチすべきファイル名を入力するよう求めます。 .PP @@ -334,6 +332,12 @@ hunk デフォルト値は 2 であり、 context の行数(通常は 3)より大きい値にはしません。 .TP 5 +.B "\-I, \-\-index-first" +.I patch +に、``Index:'' 行を context diff のヘッダより優先して扱わせます。 +.B PATCH_INDEX_FIRST +環境変数を設定すれば同じ効果が得られます。 +.TP 5 .B "\-l, \-\-ignore\-whitespace" パターンマッチの条件を緩くし、タブおよび空白に関する違いは無視します。 パターン中の連続する任意個の空白は、入力ファイル中の連続する任意個の diff --git a/ja_JP.eucJP/man/man1/ps.1 b/ja_JP.eucJP/man/man1/ps.1 index 9d2b2a4fb7..3bf8c655ae 100644 --- a/ja_JP.eucJP/man/man1/ps.1 +++ b/ja_JP.eucJP/man/man1/ps.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)ps.1 8.3 (Berkeley) 4/18/94 +.\" %Id: ps.1,v 1.11.2.2 1998/02/18 22:54:59 dima Exp % .\" jpman %Id: ps.1,v 1.2 1997/05/20 01:19:55 mutoh Stab % -.\" %Id: ps.1,v 1.11.2.1 1997/08/21 02:54:28 jlemon Exp % .\" .Dd April 18, 1994 .Dt PS 1 @@ -41,7 +41,7 @@ .Nd プロセスの状態の表示 .Sh 書式 .Nm \&ps -.Op Fl aCcehjlmrSTuvwx +.Op Fl aCcefhjlmrSTuvwx .Op Fl M Ar core .Op Fl N Ar system .Op Fl O Ar fmt @@ -90,6 +90,8 @@ cpu cpu 時間を使う方法に変更します(通常これは影響ありません)。 .It Fl e 環境(変数)も同時に表示します。 +.It Fl f +より詳しいプロセス情報を得るように、働きます。 .It Fl h ページ毎に一つヘッダが入るようにします。 .It Fl j diff --git a/ja_JP.eucJP/man/man1/rpcgen.1 b/ja_JP.eucJP/man/man1/rpcgen.1 index e1acf57fe6..5aab4e10ee 100644 --- a/ja_JP.eucJP/man/man1/rpcgen.1 +++ b/ja_JP.eucJP/man/man1/rpcgen.1 @@ -1,308 +1,326 @@ .\" @(#)rpcgen.1 1.35 93/06/02 SMI -'\"macro stdmacro .\" Copyright 1985-1993 Sun Microsystems, Inc. .\" jpman %Id: rpcgen.1,v 1.2 1997/06/08 13:49:19 jsakai Stab % -.nr X -.TH rpcgen 1 "28 Mar 1993" -.SH 名称 -rpcgen \- RPC プロトコルコンパイラ -.SH 書式 -.BI rpcgen " infile" -.LP -.B rpcgen -[ -.B \-a -] [ -.B \-b -] [ -.B \-C -] [ -.BI \-D name -[ = -.I value -] ] -.if n .ti +5n -[ -.BI \-i " size" -] -[ -.B \-I -[ -.BI \-K " seconds" -] ] -[ -.B \-L -] [ -.B \-M -] -.if n .ti +5n -.if t .ti +5n -[ -.B \-N -] -[ -.B \-T -] [ -.BI \-Y " pathname" -] -.I infile -.LP -.B rpcgen -[ -.B \-c -| -.B \-h -| -.B \-l -| -.B \-m -| -.B \-t -| -.B \-Sc -| -.B \-Ss -| -.B \-Sm -] -.if n .ti +5n -[ -.BI \-o " outfile" -] [ -.I infile -] -.LP -.B rpcgen -[ -.BI \-s " nettype" -] [ -.BI \-o " outfile" -] [ -.I infile -] -.LP -.B rpcgen -[ -.BI \-n " netid" -] [ -.BI \-o " outfile" -] [ -.I infile -] +.Dd March 28, 1993 +.Dt RPCGEN 1 +.Os +.Sh 名称 +.Nm rpcgen +.Nd RPC プロトコルコンパイラ +.Sh 書式 +.Nm rpcgen +.Ar infile +.Nm rpcgen +.Op Fl a +.Op Fl b +.Op Fl C +.Oo +.Fl D Ns Ar name Ns Op Ar =value +.Oc +.Op Fl i Ar size +.Op Fl I Op Fl K Ar seconds +.Op Fl L +.Op Fl M +.Op Fl N +.Op Fl T +.Op Fl Y Ar pathname +.Ar infile +.Nm rpcgen +.Oo +.Fl c | +.Fl h | +.Fl l | +.Fl m | +.Fl t | +.Fl \&Sc | +.Fl \&Ss | +.Fl \&Sm +.Oc +.Op Fl o Ar outfile +.Op Ar infile +.Nm rpcgen +.Op Fl s Ar nettype +.Op Fl o Ar outfile +.Op Ar infile +.Nm rpcgen +.Op Fl n Ar netid +.Op Fl o Ar outfile +.Op Ar infile .\" .SH AVAILABILITY .\" .LP .\" SUNWcsu -.SH 解説 -.IX "rpcgen" "" "\fLrpcgen\fP \(em RPC protocol compiler" -.IX "RPC" "protocol compiler" "" "protocol compiler \(em \fLrpcgen\fP" -.IX "RPC Language" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.IX "compilers" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.IX "programming tools" "RPC protocol compiler" "" "RPC protocol compiler \(em \fLrpcgen\fP" -.LP -\f3rpcgen\f1 -は、ある RPC プロトコルを実現する C コードを生成するツールです。 -\f3rpcgen\f1 -への入力は、RPC 言語 (リモートプロシージャコール言語) として知られる、 +.Sh 解説 +.Nm rpcgen +は、ある +.Tn RPC +プロトコルを実現する C コードを生成するツールです。 +.Nm +への入力は、 +.Tn RPC +言語 (リモートプロシージャコール言語) として知られる、 C 言語に類似した言語です。 -.LP -\f3rpcgen\f1 +.Pp +.Nm rpcgen は通常第 1 の書式で使用され、 1 つの入力ファイルから 4 つの出力ファイルを生成します。 .\" ↑原文では three output files となっているが、すぐ後ろで 4 つ列挙している。 .\" 原文の誤りと思われる。 97/06/08 J.Sakai 入力ファイル -\f2infile\f1 +.Ar infile が -\f3proto.x\f1 +.Pa proto.x であるとすると、 -\f3rpcgen\f1 +.Nm はヘッダファイル -\f3proto.h\f1、 +.Pa proto.h 、 XDR ルーチンファイル -\f3proto_xdr.c\f1、 -、サーバ側スタブ -\f3proto_svc.c\f1、 +.Pa proto_xdr.c 、 +サーバ側スタブ +.Pa proto_svc.c 、 クライアント側スタブ -\f3proto_clnt.c\f1 +.Pa proto_clnt.c を作成します。 -\f3\-T\f1 +.Fl T オプションを指定すると、上記に加え、 -RPC ディスパッチテーブル -\f3proto_tbl.i\f1 +.Tn RPC +ディスパッチテーブル +.Pa proto_tbl.i も作成します。 -.LP -.B rpcgen +.Pp +.Nm rpcgen はまた、特定アプリケーション向けにカスタマイズ可能な クライアントおよびサーバのサンプルファイルも生成できます。 オプション -\f3\-Sc\f1, -\f3\-Ss\f1, -\f3\-Sm\f1 +.Fl \&Sc , +.Fl \&Ss , +.Fl \&Sm によってそれぞれ、サンプルのクライアント、サーバ、makefile を生成します。 オプション -\f3\-a\f1 +.Fl a を指定するとサンプルを含め全てのファイルを生成します。 -入力ファイルが \f3proto.x\f1 の場合、 -クライアント側サンプルファイルは \f3proto_client.c\f1 に、 -サーバ側サンプルファイルは \f3proto_server.c\f1 に、 -そしてサンプル makefile は \f3makefile.proto\f1 に書き出されます。 -.LP -生成されたサーバは、ポートモニタ (例えば \f3inetd\f1) で起動することも、 +入力ファイル +.Ar infile +が +.Pa proto.x +の場合、 +クライアント側サンプルファイルは +.Pa proto_client.c +に、 +サーバ側サンプルファイルは +.Pa proto_server.c +に、 +そしてサンプル makefile は +.Pa makefile.proto +に書き出されます。 +.Pp +生成されたサーバは、ポートモニタ (例えば +.Xr inetd 8 +) で起動することも、 それ自身で起動することもできます。 ポートモニタから起動される場合、 -ファイルディスクリプタ \f30\fP を引き渡すトランスポートのためだけの +ファイルディスクリプタ +.Em 0 +を引き渡すトランスポートのためだけの サーバを生成します。 -トランスポートの名前は環境変数 \f3PM_TRANSPORT\f1 をセットすることで +トランスポートの名前は環境変数 +.Ev PM_TRANSPORT +をセットすることで 指定しなければなりません。 -\f3rpcgen\f1 で作成されたサーバが実行されると、 -サーバは環境変数 \f3NETPATH\f1 で指定された全トランスポート用に +.Nm +で作成されたサーバが実行されると、 +サーバは環境変数 +.Ev NETPATH +で指定された全トランスポート用に サーバハンドルを作成します。 -\f3NETPATH\f1 が指定されていない場合は、ファイル \f3/etc/netconfig\f1 に -記述されている全ての可視トランスポート用にサーバハンドルを作成します。 +.Ev NETPATH +が指定されていない場合は、ファイル +.Pa /etc/netconfig +に記述されている全ての可視トランスポート用にサーバハンドルを作成します。 注意: トランスポートはコンパイル時ではなく実行時に選択されます。 サーバが自分で開始すると、 デフォルトでは自動的にバックグラウンド実行に移ります。 -\f3RPC_SVC_FG\f1 を定義することで、 +.Em RPC_SVC_FG +を定義することで、 サーバをフォアグラウンドで実行させることもできます。 -.LP -第二の書式は、更に洗練された RPC サーバを生成する特別な機能をもちます。 +.Pp +第二の書式は、更に洗練された +.Tn RPC +サーバを生成する特別な機能をもちます。 その特別な機能として、 -ユーザが定義した \f3#defines\f1 と RPC ディスパッチテーブル +ユーザが定義した +.Em #define +と +.Tn RPC +ディスパッチテーブル のサポートがあります。 -RPC ディスパッチテーブルのエントリには以下のものがあります: -.RS -.PD 0 -.TP 3 -\(bu +.Tn RPC +ディスパッチテーブルのエントリには以下のものがあります: +.Bl -bullet -offset indent -compact +.It そのプロシージャに対応するサービスルーチンへのポインタ -.TP -\(bu +.It 入出力引数へのポインタ -.TP -\(bu +.It これらのルーチンのサイズ -.PD -.RE +.El サーバはディスパッチテーブルを用いて認証チェックを行い、 -それからサービスルーチンを実行します。 +それからサービスルーチンを実行することができます。 クライアントライブラリはそれを用いて、 -記憶領域管理や XDR データ変換の詳細に対処します。 -.LP +記憶領域管理や XDR データ変換の詳細に対処することができます。 +.Pp 上に示した他の 3 つの書式は、出力ファイルの全てではなく、 そのうちの特定のものだけを生成したい場合に用いられます。 -.B rpcgen -の使用例については以下の -.SM EXAMPLES -セクションを参照して下さい。 -\f3\-s\f1 オプション付きで実行されると、 -\f3rpcgen\f1 は特定のトランスポートクラス用のサーバを生成します。 -\f3\-n\f1 オプション付きで実行されると、 -\f3rpcgen\f1 は \f2netid\f1 で指定されたトランスポート用サーバを生成します。 -\f2infile\f1 +.Nm +の使用例については下の +.Sx 使用例 +のセクションを参照して下さい。 +.Fl s +オプション付きで実行されると、 +.Nm +は特定のトランスポートクラス用のサーバを生成します。 +.Fl n +オプション付きで実行されると、 +.Nm +は +.Ar netid +で指定されたトランスポート用サーバを生成します。 +.Ar infile が指定されない場合、 -\f3rpcgen\f1 は標準入力から入力を受け付けます。 -.LP -入力ファイルは、実際に \f3rpcgen\f1 に処理される前に、 -C プリプロセッサ \f3cc \-E\f1 で処理されます。 -\f3rpcgen\f1 は、出力ファイルの各タイプ毎に -\f3rpcgen\f1 プログラマ向けの特別なプリプロセッサシンボルを定義します。 -.LP -.PD 0 -.RS -.TP 12 -\f3RPC_HDR\f1 +.Nm +は標準入力から入力を受け付けます。 +.Pp +入力ファイルは、実際に +.Nm +に処理される前に、 +C プリプロセッサ +.Em cc -E +で処理されます。 +.Nm +は、出力ファイルの各タイプ毎に +.Nm +プログラマ向けの特別なプリプロセッサシンボルを定義します: +.Bl -tag -width indent +.It RPC_HDR ヘッダをコンパイルする際に定義されます -.TP -\f3RPC_XDR\f1 +.It RPC_XDR XDR ルーチンをコンパイルする際に定義されます -.TP -\f3RPC_SVC\f1 +.It RPC_SVC サーバ側スタブをコンパイルする際に定義されます -.TP -\f3RPC_CLNT\f1 +.It RPC_CLNT クライアント側スタブをコンパイルする際に定義されます -.TP -\f3RPC_TBL\f1 +.It RPC_TBL RPC ディスパッチテーブルをコンパイルする際に定義されます -.RE -.PD -.LP -``\f3%\f1'' で始まる行は全て、\f3rpcgen\f1 に解釈されることなく、 +.El +.Pp +.Dq % +で始まる行は全て、 +.Nm +に解釈されることなく、 出力ファイルに直接引き継がれます。 -C プリプロセッサのパス名を指定するには \f3\-Y\f1 フラグを使用して下さい。 -.LP -\f2infile\f1 で参照される全てのデータ方に対し、 -\f3rpcgen\f1 は、そのデータ型名の前に \f3xdr_\f1 を付与した名前の +C プリプロセッサのパス名を指定するには +.Fl Y +フラグを使用して下さい。 +.Pp +.Ar infile +で参照される全てのデータ方に対し、 +.Nm +は、そのデータ型名の前に +.Em xdr_ +を付与した名前の ルーチンが存在することを仮定します。 -このルーチンが RPC/XDR ライブラリ中に存在しない場合は、 +このルーチンが +.Tn RPC/XDR +ライブラリ中に存在しない場合は、 それを提供しなければなりません。 -未定義データ型を提供することで XDR ルーチンをカスタマイズすることが可能です。 -.br -.ne 10 -.SH オプション -.TP 15 -\f3\-a\f1 +未定義データ型を提供することで +.Xr XDR +ルーチンをカスタマイズすることが可能です。 +.Sh オプション +オプションは以下の通りです: +.Bl -tag -width indent +.It Fl a サンプルファイルを含め、全てのファイルを生成します。 -.TP -\f3\-b\f1 +.It Fl b 従来互換モード。 -以前のバージョンの OS のために、トランスポート固有の RPC コードを生成します。 -.IP -注: FreeBSD ではこの互換フラグはデフォルトで有効になっています。 -FreeBSD は以前の ONC RPC ライブラリのみサポートしているからです。 -.TP -\f3\-c\f1 -XDR ルーチンをコンパイル出力します。 -.TP -\f3\-C\f1 -.SM ANSI C -コンパイラで使用できるヘッダおよびスタブファイルを生成します。 -ここで生成したヘッダファイルは C++ プログラムでも使用できます。 -.TP -\f3\-D\f2name\f3[=\f2value\f3]\f1 -シンボル \f2name\f1 を定義します。 -ソース中の \f3#define\f1 指示行と等価です。 -\f2value\f1 が指定されない場合、 -\f2value\f1 は \f31\f1 と定義されます。 +以前のバージョンの OS のために、トランスポート固有の +.Tn RPC +コードを生成します。 +.Pp +注: +.Bx Free +ではこの互換フラグはデフォルトで有効になっています。 +.Bx Free +は以前の +.Tn ONC RPC +ライブラリのみサポートしているからです。 +.It Fl c +.Tn XDR +ルーチンをコンパイル出力します。 +.It Fl C +.Tn ANSI +C コンパイラで使用できるヘッダおよびスタブファイルを生成します。 +このオプションで生成したヘッダファイルは C++ プログラムでも使用できます。 +.It Fl D Ns Ar name +.It Fl D Ns Ar name=value +.\".It Fl D Ns Ar name Ns Op Ar =value +シンボル +.Ar name +を定義します。 +ソース中の +.Em #define +指示行と等価です。 +.Ar value +が指定されない場合、 +.Ar value +は +.Em 1 +と定義されます。 このオプションは複数回の指定が可能です。 -.TP -\f3\-h\f1 -\f3C\f1 のデータ定義 (ヘッダファイル) をコンパイル出力します。 -同時に \f3\-T\f1 オプションを指定することで、 -RPC ディスパッチテーブルをサポートするヘッダファイルを生成できます。 -.TP -\f3\-i \f2size\f1 +.It Fl h +C のデータ定義 (ヘッダファイル) をコンパイル出力します。 +同時に +.Fl T +オプションを指定することで、 +.Tn RPC +ディスパッチテーブルをサポートするヘッダファイルを生成できます。 +.It Fl i Ar size インラインコードを生成し始めるサイズを指定します。 最適化を行う際に用いられます。デフォルト値は 5 です。 -.IP -注: FreeBSD プラットホームでの以前の -.B rpcgen +.Pp +注: +.Bx Free +プラットホームでの以前の +.Nm と互換性を保つため、デフォルト値は実際には 0 (つまり、 デフォルトではインラインコードは生成しない) となっています。 このデフォルト値を上書きするには明示的にゼロ以外の値を 指定しなければなりません。 -.TP -\f3\-I\f1 +.It Fl I サーバ側スタブにおける -.BR inetd (8) +.Xr inetd 8 サポートコードを生成します。 このようにして生成したサーバは、単独で起動することも、 -\f3inetd\f1 から起動することもできます。 +.Nm inetd +から起動することもできます。 単独で起動した場合、デフォルトでは自らバックグラウンド動作に移ります。 -特殊シンボル \f3RPC_SVC_FG\f1 を定義するか、 -単に \f3\-I\f1 オプションなしでコンパイルすると、 +特殊シンボル +.Em RPC_SVC_FG +を定義するか、 +単に +.Fl I +オプションなしでコンパイルすると、 サーバプロセスはフォアグラウンドで動作します。 -.br -.ne 5 -.IP +.Pp クライアントからの未処理リクエストがなければ、 -\f3inetd\f1 サーバは 120 秒 (デフォルト値) 経過の後、終了します。 +.Nm inetd +サーバは 120 秒 (デフォルト値) 経過の後、終了します。 このデフォルト値は -.B \-K +.Fl K オプションにより変更できます。 -\f3inetd\f1 サーバの全エラーメッセージは常に -.BR syslog (3) +.Nm inetd +サーバの全エラーメッセージは常に +.Xr syslog 3 によってログに残されます。 .\" .IP .\" Note: @@ -310,187 +328,179 @@ RPC .\" By default, .\" .B rpcgen .\" generates servers that can be invoked through portmonitors. -.TP -.BI \-K " seconds" -デフォルトでは、\f3rpcgen\fP を用いて作成され、ポートモニタから起動された -サービスは、リクエストを処理した後 \f3120\fP 秒待って終了します。 -この時間は \f3\-K\fP オプションを用いて変更できます。 +.Pp +.It Fl K Ar seconds +デフォルトでは、 +.Nm +を用いて作成され、ポートモニタから起動された +サービスは、リクエストを処理した後 120 秒待って終了します。 +この時間は +.Fl K +オプションを用いて変更できます。 リクエスト処理が済むと直ちに終了するようなサーバを生成するには、 -.BR "\-K\ 0" +.Fl K Ar 0 と指定します。また、決して終了しないサーバを生成するには、 -\f3\-K \-1\fP +.Fl K Ar -1 として下さい。 -.IP +.Pp サーバをモニタする場合、 あるサービスリクエストに対して -.I 常に +.Em 常に 新しいプロセスを生成するようなポートモニタがあります。 そのようなモニタを用いてサーバを使用することがわかっている場合は、 サーバは処理完了後直ちに終了すべきです。 -そのようなサーバを生成するには、\f3rpcgen\fP は \f3\-K 0\fP オプション -とともに使用すべきです。 -.TP -\f3\-l\f1 +そのようなサーバを生成するには、 +.Nm +は +.Fl K Ar 0 +オプションとともに使用すべきです。 +.It Fl l クライアント側スタブをコンパイル出力します。 -.TP -.B \-L +.It Fl L サーバがフォアグラウンドで起動された場合、 サーバのエラーを記録するのに、標準エラー出力に出力する代わりに -.BR syslog (3) +.Xr syslog 3 を使用します。 -.TP -\f3\-m\f1 -サーバ側スタブをコンパイル出力しますが、\(lqmain\(rq ルーチンは生成しません。 +.It Fl m +サーバ側スタブをコンパイル出力しますが、 +.Qq main +ルーチンは生成しません。 コールバックルーチンのみを作成したり、初期化を行うために -独自の \(lqmain\(rq ルーチンを必要とする場合に便利です。 -.TP -\f3\-M\f1 +独自の +.Qq main +ルーチンを必要とする場合に便利です。 +.It Fl M rpcgen が生成したコードとユーザが書いたコードの間で 引数や結果を受渡しするために、 マルチスレッド対応の (MT-safe な) スタブを生成します。 ユーザプログラム中でスレッドを使用する場合に有用です。 しかし関数 -.BR rpc_svc_calls (3N) +.Xr rpc_svc_calls 3 はまだ MT-safe にはなっていません。 つまり rpcgen が生成したサーバ側コードは MT-safe ではありません。 -.TP -.B \-N +.It Fl N プロシージャが複数の引数を持てるようにします。 これはまた、C 言語に大変似たパラメータ渡し方法を用います。 ですからリモートプロシージャにある引数を渡す場合、 その引数へのポインタを渡す必要はなく、引数そのものを渡せます。 この動作は -.B rpcgen +.Nm が生成したコードの以前の振る舞いとは異なっています。 以前との互換性を保つため、このオプションはデフォルトでは有効ではありません。 -.TP -\f3\-n \f2netid\f1 -\f2netid\f1 で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 -netconfig データベースには \f2netid\f1 用エントリが存在しなければなりません。 +.It Fl n Ar netid +.Ar netid +で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 +netconfig データベースには +.Ar netid +用エントリが存在しなければなりません。 このオプションを複数回指定することで、 複数のトランスポートに対してサービスするサーバを作成することができます。 -.TP -\f3\-o \f2outfile\f1 +.It Fl o Ar outfile 出力ファイル名を指定します。 何も指定されなければ標準出力が用いられます -(\f3\-c\f1, -\f3\-h\f1, -\f3\-l\f1, -\f3\-m\f1, -\f3\-n\f1, -\f3\-s\f1, -\f3\-Sc\f1, -\f3\-Sm\f1, -\f3\-Ss\f1, -\f3\-t\f1 +( +.Fl c , +.Fl h , +.Fl l , +.Fl m , +.Fl n , +.Fl s , +.Fl \&Sc , +.Fl \&Sm , +.Fl \&Ss , +.Fl t モード時のみ)。 -.TP -\f3\-s \f2nettype\f1 -クラス \f2nettype\f1 に属する全てのトランスポート用の +.It Fl s Ar nettype +クラス +.Ar nettype +に属する全てのトランスポート用の サーバ側スタブをコンパイル出力します。 -サポートされているクラスは以下のものです: -\f3netpath\f1, -\f3visible\f1, -\f3circuit_n\f1, -\f3circuit_v\f1, -\f3datagram_n\f1, -\f3datagram_v\f1, -\f3tcp\f1, -\f3udp\f1 +サポートされているクラスは以下の通りです: +.Em netpath , +.Em visible , +.Em circuit_n , +.Em circuit_v , +.Em datagram_n , +.Em datagram_v , +.Em tcp , +.Em udp (これらのクラスの意味については -.BR rpc (3N) +.Xr rpc 3 を参照して下さい) このオプションは複数回指定できます。 注: トランスポートはコンパイル時ではなく実行時に選択されます。 -.TP -\f3\-Sc\f1 +.It Fl \&Sc リモートプロシージャ呼び出しを用いるサンプルクライアントコードを生成します。 -.br -.ne 5 -.TP -\f3\-Sm\f1 -アプリケーションをコンパイルする際に用いるサンプル Makefile を生成します。 -.TP -\f3\-Ss\f1 +.It Fl \&Sm +アプリケーションをコンパイルする際に用いるサンプル +.Pa Makefile +を生成します。 +.It Fl \&Ss リモートプロシージャ呼び出しを用いるサンプルサーバコードを生成します。 -.TP -\f3\-t\f1 -RPC ディスパッチテーブルをコンパイル出力します。 -.TP -\f3\-T\f1 -RPC ディスパッチテーブルをサポートするコードを生成します。 -.IP +.It Fl t +.Tn RPC +ディスパッチテーブルをコンパイル出力します。 +.It Fl T +.Tn RPC +ディスパッチテーブルをサポートするコードを生成します。 +.Pp ある特定のタイプのファイルを生成するために、 以下のオプション -\f3\-c\f1, -\f3\-h\f1, -\f3\-l\f1, -\f3\-m\f1, -\f3\-s\f1, -\f3\-Sc\f1, -\f3\-Sm\f1, -\f3\-Ss\f1, -\f3\-t\f1 +.Fl c , +.Fl h , +.Fl l , +.Fl m , +.Fl s , +.Fl \&Sc , +.Fl \&Sm , +.Fl \&Ss , +.Fl t は排他的に使用されます。 他方、オプション -\f3\-D\f1 +.Fl D と -\f3\-T\f1 +.Fl T は大域的であり、他のオプションと組み合わせて使用できます。 -.TP -\f3\-Y\f2 pathname\f1 -.B rpcgen +.It Fl Y Ar pathname +.Nm が C プリプロセッサを探し始めるディレクトリ名を指定します。 -.br -.ne 5 -.SH 使用例 +.El +.Sh 使用例 以下の例: -.LP -.RS -.B example% rpcgen \-T prot.x -.RE -.LP -は 5 種類のファイル -.BR prot.h , -.BR prot_clnt.c , -.BR prot_svc.c , -.B prot_xdr.c , -.BR prot_tbl.i -.LP +.Dl example% rpcgen -T prot.x +.Pp +は 5 種類のファイル: +.Pa prot.h , +.Pa prot_clnt.c , +.Pa prot_svc.c , +.Pa prot_xdr.c , +.Pa prot_tbl.i の全てを生成します。 +.Pp 次の例は C のデータ定義 (ヘッダ) を標準出力に出力します。 -.LP -.RS -.B example% rpcgen \-h prot.x -.RE -.LP -.BR -DTEST +.Dl example% rpcgen -h prot.x +.Pp +.Fl D Ns Ar TEST のテストバージョンを作成するため、 クラス -.B datagram_n -に属する全トランスポート用サーバ側スタブを標準出力に出力するには、 -.LP -.RS -.B example% rpcgen \-s datagram_n \-DTEST prot.x -.RE -.LP -とします。 -\f2netid\f1 -\f3tcp\f1 -で指定されたトランスポート用のサーバ側スタブを作成するには -.LP -.RS -.B example% rpcgen \-n tcp \-o prot_svc.c prot.x -.RE -とします。 -.SH 関連項目 -.BR cc (1), -.BR inetd (8), -.BR syslog (3), -.BR rpc (3), +.Ar datagram_n +に属する全トランスポート用サーバ側スタブを標準出力に出力するには次のよ +うにします: +.Dl example% rpcgen -s datagram_n -DTEST prot.x +.Pp +.Ar netid +tcp +で指定されたトランスポート用のサーバ側スタブを作成するには次のようにし +ます: +.Dl example% rpcgen -n tcp -o prot_svc.c prot.x +.Sh 関連項目 +.Xr cc 1 , +.Xr rpc 3 , +.Xr syslog 3 , +.Xr inetd 8 .\" .BR rpc_svc_calls (3) -.LP -.TZ NETP +.Pp +.Tn NETP マニュアルの -.B rpcgen +.Nm の章。 diff --git a/ja_JP.eucJP/man/man1/sh.1 b/ja_JP.eucJP/man/man1/sh.1 index 6e3b27af83..af683ecaee 100644 --- a/ja_JP.eucJP/man/man1/sh.1 +++ b/ja_JP.eucJP/man/man1/sh.1 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95 -.\" %Id: sh.1,v 1.9.2.4 1997/09/14 13:07:41 jkh Exp % +.\" %Id: sh.1,v 1.9.2.8 1998/02/15 11:32:26 jkh Exp % .\" jpman %Id: sh.1,v 1.2 1997/05/31 16:40:31 jsakai Stab % .\" Japanese Translation amended by Norihiro Kumagai, 3/29/96, .\" based on the version of NetBSD Japanese Man Project @@ -426,6 +426,12 @@ here-doc-text 意味します。各コマンドのマニュアルにそれぞれの終了ステータスがどのよう な意味を持つかが記述されているはずです。組込みコマンドと(実行された) 関数も終了ステータスを返します。 +.Pp +コマンドがシグナルにより終了(terminate)させられた場合、 +終了ステータスは 128 にシグナル番号を加えたものになります。 +シグナル番号はヘッダファイル +.Aq Pa sys/signal.h +に定義されています。 .Ss 複合コマンド(Complex Commands) 複合コマンドは、単純コマンドの組み合わせで作ります。 制御演算子または予約語と組み合わせることで、より大きな複合コマンドを生 @@ -590,7 +596,7 @@ pattern あたかも単一プログラムであるかのように、それらの出力をまとめて リダイレクトすることができます。 .Bd -literal -offset indent -{ echo -n "hello"; echo " world" } > greeting +{ echo -n "hello"; echo " world"; } > greeting .Ed .Ss 関数 関数定義の構文は以下のとおりです。 @@ -891,6 +897,15 @@ test(1) .It \&. file 指定されたファイル file に記述されたコマンドがシェルに読み込まれ、 実行されます。 +.Ar file +に +.Ql / +文字を含む場合、その通りに扱われます。 +そうでなければ、シェルは +.Ev PATH +を使用して、ファイルを検索します。 +.Ev PATH +を使用しても見付からない場合、カレントディレクトリを検索します。 .It alias [ name[=string] ... ] name=string が指定されている場合、シェルは名前 ``name'' を持つ値 ``value'' のエイリアスを定義します。単に ``name'' だけが指定された場合、 @@ -1026,7 +1041,7 @@ hash 組込みコマンドの pwd は同名のプログラムとは異なった表示をする場合があります。 このため処理は高速ですが、カレントディレクトリ の名前を変更した場合でも、以前のディレクトリ名を表示し続けます。 -.It read [ -p prompt ] [ -e ] variable ... +.It Li "read [ -p prompt ] [ -e ] variable ... -p オプションが指定され、かつ標準入力が端末の場合、 prompt をプロンプトとして表示します。 そして標準入力から 1 行入力します。行端の改行文字を削除し、行を前述の @@ -1037,6 +1052,12 @@ prompt 分割された単語の数より多くの変数が指定されていたなら、 余った変数には空文字列が設定されます。 .Pp +-t オプションが指定され、かつ入力がなされる前にタイムアウトすると、 +read コマンドは値を割当てずに戻ります。 +タイムアウト値の後にはオプションで 's', 'm', 'h' のいずれかの一文字 +を付けることが出来、それぞれ秒, 分, 時間を陽に指定します。 +どれも指定しない場合には 's' であるものとします。 +.Pp -e オプションを指定すると、入力中のバックスラッシュ文字を特別扱いします。 バックスラッシュ文字が改行文字の直前にある場合、 バックスラッシュ文字と改行文字は削除されます。 diff --git a/ja_JP.eucJP/man/man1/su.1 b/ja_JP.eucJP/man/man1/su.1 index 0350eaff15..60582dde87 100644 --- a/ja_JP.eucJP/man/man1/su.1 +++ b/ja_JP.eucJP/man/man1/su.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)su.1 8.2 (Berkeley) 4/18/94 -.\" %Id: su.1,v 1.3.2.5 1997/10/12 08:12:40 jmg Exp % +.\" %Id: su.1,v 1.3.2.6 1998/02/18 12:15:58 markm Exp % .\" jpman %Id: su.1,v 1.3 1997/05/19 16:52:17 horikawa Stab % .\" .\" this is for hilit19's braindeadness: " @@ -43,6 +43,7 @@ .Sh 書式 .Nm .Op Fl Kflm +.Op Fl c Ar class .Op Ar login Op Ar args .Sh 解説 .Nm @@ -134,6 +135,9 @@ ID で定義される) であったり、呼出側の実ユーザ ID が 0 でなければ、 .Nm は失敗します。 +.It Fl c Ar class +指定されたログインクラスの設定を使用します。 +スーパユーザのみが使用を許されます。 .El .Pp .Fl l diff --git a/ja_JP.eucJP/man/man1/tar.1 b/ja_JP.eucJP/man/man1/tar.1 index 7893d88b10..67849b7e75 100644 --- a/ja_JP.eucJP/man/man1/tar.1 +++ b/ja_JP.eucJP/man/man1/tar.1 @@ -2,11 +2,12 @@ .\" See /usr/src/gnu/COPYING for conditions of redistribution .\" .\" Written by John F. Woods +.\" Updated by Robert Eckardt .\" -.\" %Id: tar.1,v 1.6.2.1 1997/06/05 23:13:54 max Exp % +.\" %Id: tar.1,v 1.6.2.3 1998/02/15 17:05:30 steve Exp % .\" jpman %Id: tar.1,v 1.2 1997/06/24 07:09:44 bobson Stab % .\" -.Dd 6 August 1994 +.Dd 25 August 1997 .Os FreeBSD .Dt TAR 1 .Sh 名称 @@ -14,10 +15,9 @@ .Nd テープアーカイバ; "tar" アーカイブファイルの操作 .Sh 書式 -.Nm -.Op Cm Bq - -.Op Cm bundled-options -.Op Ar [gnu-style-flags] +.Nm tar +.Op [-] Ns Ar bundled-options +.Op Ar gnu-style-flags .Op Ar tarfile .Op Ar blocksize .Op Ar exclude-file @@ -35,7 +35,7 @@ .Dq tar フォーマットのアーカイブファイルを作成し、アーカイブにファイルを追加したり、 またアーカイブからファイルを抽出したりします。 -tarfile は通常磁気テープを指しますが、フロッピーディスケットや +tarfile は通常磁気テープを指しますが、フロッピディスケットや 通常のファイルでも構いません。 .Pp 通常、 @@ -55,12 +55,13 @@ tarfile そして抽出 (extract) を意味しています (下記に詳細があります) 。 これらの他に、以下に詳細を述べる機能変更文字を、コマンド単語に 含めることができます。それらのいくつかは、コマンド単語内と同じ順で -コマンドライン引数を要求します (EXAMPLE セクションを参照) 。 +コマンドライン引数を要求します (使用例の節を参照) 。 機能文字と機能変更文字は、GNU 形式の引数で指定することもできます (2 つのダッシュを最初につけ、1 つのコマンド単語ごとに機能文字か 機能変更文字を 1 つだけ指定する) 。 -アーカイブから追加、抽出、またはリスト表示するためにコマンドライン指定する -ファイル名には、シェルのパターンマッチ文字列を使用することができます。 +アーカイブへの追加、アーカイブからの抽出、そしてリスト表示のために +コマンドライン指定するファイル名には、 +シェルのパターンマッチ文字列を使用することができます。 .Sh 機能 以下の機能のいずれか1つだけを必ず指定しなければなりません。 .Pp @@ -75,8 +76,8 @@ tarfile はなく、指定したファイルの中に含まれているファイルを、最初に指定 したアーカイブに追加するという効果を持ちます。 .Em 注: -このオプションは tarfile を再書き込みする必要があるため、1/4 イ -ンチカートリッジテープでは動作しません。 +このオプションは tarfile を再書き込みする必要があるため、1/4 +インチカートリッジテープでは動作しません。 .It Fl c .It Fl -create 新しいアーカイブを作成して (もしくは古い内容を切り捨てて)、指定 @@ -84,19 +85,19 @@ tarfile .It Fl d .It Fl -diff .It Fl -compare -アーカイブの中のファイルと、それに相当するファイルシステム内のファ -イルとの違いを調査します。 +アーカイブの中のファイルと、それに相当するファイルシステム内の +ファイルとの違いを調査します。 .It Fl -delete 指定されたファイルをアーカイブから削除します。(1/4 インチテープ では動作しません。) .It Fl r .It Fl -append -アーカイブの末尾にファイルを追加します。(1/4 インチテープでは動 -作しません。) +アーカイブの末尾にファイルを追加します。(1/4 インチテープでは +動作しません。) .It Fl t .It Fl -list -アーカイブ内容のリスト表示をします。もし引数としてファイル名が指 -定されていれば、そのファイルだけがリスト表示されます。そうでなけ +アーカイブ内容のリスト表示をします。もし引数としてファイル名が +指定されていれば、そのファイルだけがリスト表示されます。そうでなけ れば、アーカイブに含まれるすべてのファイルリストが表示されます。 .It Fl u .It Fl -update @@ -106,17 +107,16 @@ tarfile .It Fl x .It Fl -extract .It Fl -get -アーカイブからファイルを抽出します。可能ならば、オーナー、変更時 -刻、ファイル属性はリストアされます。もし +アーカイブからファイルを抽出します。可能ならば、オーナ、 +変更時刻、ファイル属性はリストアされます。もし .Ar file -引数が指定されていなければ、アーカイブ内の全ファイルが抽出されま -す。もし +引数が指定されていなければ、アーカイブ内の全ファイルが抽出されます。 +もし .Ar filename -引数がテープ上のディレクトリ名にマッチしていれば、そのディレクト -リとディレクトリ内のファイルが抽出されます。(ディレクトリ内のす +引数がテープ上のディレクトリ名にマッチしていれば、そのディレクトリと +ディレクトリ内のファイルが抽出されます。(ディレクトリ内のす べてのディレクトリについても同様に抽出されます。) -もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上 -記の +もしアーカイブ内に、相当する同じファイルが複数含まれていれば(上記の .Fl -append コマンドを参照)、最後に含まれているものが他のすべてのファイルを 上書きする形で抽出されます。 @@ -125,20 +125,23 @@ tarfile の他のオプションは、組み合わせて使用することができます。 1文字オプションは、コマンド単語の中で指定することができます。 引数を与えるべきオプションの場合、オプションに続けて引数を指定し -ます。1文字オプションであれば、したコマンドラインに続けて引数を -指定することになるでしょう (以下の -.Sx EXAMPLES +ます。1文字オプションであれば、これに続くコマンドライン引数を +使用します (以下の +.Sx 使用例 を参照してください。) .Pp .Bl -tag -width "--preserve-permissions" -compact .It Fl -help -tar のすべてのコマンドオプションについて一覧と解説を表示します。 +.Nm +のすべてのコマンドオプションについて一覧と解説を表示します。 .It Fl -atime-preserve テープに書かれている、ファイルのアクセス時刻をリストアします。 (inodeの変更時刻が変更されることに注意してください!) .It Fl b .It Fl -block-size Ar number -読み書きするブロックサイズを512-byte ブロック N 個ぶんに設定します。 +読み書きするブロックサイズを +.Ar number +* 512-byte ブロック に設定します。 .It Fl B .It Fl -read-full-blocks 短い読みだしブロックを、完全なブロックに再組み立てします。 @@ -149,7 +152,7 @@ tar .Ar directory へ移動します。 .It Fl -checkpoint -アーカイブを読むときディレクトリ名を表示します。 +アーカイブを読み書きする間に読み書きしたバッファの数を表示します。 .It Fl f Ar [hostname:]file .It Fl -file Ar [hostname:]file 指定された @@ -165,10 +168,12 @@ tar .Ar file を読み書きします。"-" はファイルネームとして使用されることもありますが、 これは標準入力から読み出したり、標準出力へ書き出したりするために使用されます。 +.It Fl -force-local +コロンがある時でさえ、アーカイブファイルはローカルのものとします。 .It Fl F Ar file .It Fl -info-script Ar file .It Fl -new-volume-script Ar file -それぞれのアーカイブの最後にスクリプトを走らせます (暗黙の +それぞれのアーカイブが終ると、スクリプトを実行します (暗黙の .Fl M 指定が行なわれます。) .It Fl -fast-read @@ -176,16 +181,16 @@ tar アーカイブ内に見つかったら、その時点で終了します。 .It Fl G .It Fl -incremental -古い GNU-format インクリメンタルバックアップファイルを作成/リス -ト/抽出します。 +古い GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl g Ar file .It Fl -listed-incremental Ar file -新しい GNU-format インクリメンタルバックアップファイルを作成/リ -スト/抽出します。 +新しい GNU-format インクリメンタルバックアップファイルを作成/リスト/ +抽出します。 .It Fl h .It Fl -dereference -シンボリックリンクをシンボリックのまま書き込みません。シンボリッ -クリンクが指しているデータを書き込みます。 +シンボリックリンクをシンボリックのまま書き込みません。シンボリックリンクが +指しているデータを書き込みます。 .It Fl i .It Fl -ignore-zeros アーカイブの中のゼロブロック(通常、End-Of-File を意味する)を無視します。 @@ -203,26 +208,36 @@ tar .It Fl l .It Fl -one-file-system あるファイルシステム内にあるファイルだけでアーカイブを作成します。 -(他ファイルシステムへのマウントポイントは使われません。) +(他ファイルシステムへのマウントポイントを跨ぎません。) .It Fl L Ar number .It Fl -tape-length Ar number -N*1024 バイトを書き込んだ後テープの交換を要求します。 +.Ar number +* 1024 バイト書き込んだ後でテープの交換を要求します。 .It Fl m .It Fl -modification-time ファイルの変更時刻を抽出しません。 .It Fl M .It Fl -multi-volume マルチボリュームアーカイブを作成/リスト/抽出します。 +.It Fl n +.It Fl -norecurse +作成時に再帰的にサブディレクトリを走査しません。 +.It Fl -volno-file Ar file +ボリューム番号付きのファイル名です。 .It Fl N Ar date .It Fl -after-date Ar date .It Fl -newer Ar date +作成時間が .Ar date より新しいファイルだけを抽出します。 +.It Fl -newer-mtime Ar date +変更時間が + .Ar date +より新しいファイルだけを抽出します。 .It Fl o .It Fl -old-archive .It Fl -portability -POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成し -ます。 +POSIX フォーマットではなく、V7 フォーマットのアーカイブを作成します。 .It Fl O .It Fl -to-stdout ファイルを標準出力に抽出します。 @@ -235,7 +250,7 @@ POSIX の指定と同じ効果を持ちます。 .It Fl P .It Fl -absolute-paths -ファイル名から先頭の`/'をとりません。 +ファイル名から先頭の `/' をとりません。 .It Fl R .It Fl -record-number メッセージ中にアーカイブ内のレコード番号を埋め込み表示します。 @@ -245,6 +260,8 @@ POSIX .It Fl -same-order .It Fl -preserve-order アーカイブ内から抽出するファイルを、指定された順のままにします。 +.It Fl -show-omitted-dirs +アーカイブ作成中に除外されたディレクトリを表示します。 .It Fl S .It Fl -sparse 「少ない」ファイルを効率的に扱うようにします。 @@ -260,19 +277,26 @@ null .Fl C 指定を無効にします。 .It Fl -totals ---create によって書かれたトータルバイト数を表示します。 +.Fl -create +によって書かれたトータルバイト数を表示します。 .It Fl v .It Fl -verbose ---create でアーカイブに書くファイルや --extract でアーカイブから -取り出すファイル名をリスト表示します。ファイルの保護情報をファイ -ル名とともに表示させるには、--list を使います。 +.Fl -create +でアーカイブに書くファイルや +.Fl -extract +でアーカイブから +取り出すファイル名をリスト表示します。 +ファイルの保護情報をファイル名とともに表示させるには、 +.Fl -list +を使います。 .It Fl V Ar volume-name .It Fl -label Ar volume-name 指定された .Ar volume-name を持ったアーカイブを作成します。 .It Fl -version -tar プログラムのバージョン番号を表示します。 +.Nm +プログラムのバージョン番号を表示します。 .It Fl w .It Fl -interactive .It Fl -confirmation @@ -306,45 +330,44 @@ tar でフィルタリングします。 (これは、 .Fl d -が指定されたときは ``decompress'' を意味しなければなりません。) +が指定されたときは ``decompress'' を意味しなければなりません。) .It Fl -block-compress -テープもしくはフロッピーのために、圧縮プログラムの出力をブロック -化します。(そうでないとき奇数長を書き込むと、デバイスドライバは -それを拒絶するでしょう。) +テープもしくはフロッピのために、圧縮プログラムの出力をブロック +化します。(そうしないと、ブロック長がおかしくなり、デバイスドライバは +そのブロックを拒絶するでしょう。) .It Fl [0-7][lmh] テープドライブと密度を指定します。 -.It Fl -norecurse -作成時にサブディレクトリ内の内容を無視します。 .It Fl -unlink ファイルを作成する前に、いったん削除します。 .El .Sh 使用例 -"bert" と "ernie" というファイルを含む、ブロックサイズが 20 ブロッ -クのアーカイブを、テープドライブ /dev/rst0 に作るには、 +"bert" と "ernie" というファイルを含む、 +ブロックサイズが 20 ブロックのアーカイブを、 +テープドライブ /dev/rst0 に作るには、 .Pp .Dl tar cfb /dev/rst0 20 bert ernie .Pp もしくは .Pp -.Dl tar --create --file /dev/rst0 --block-size 20 bert ernie +.Dl tar\ --create\ --file\ /dev/rst0\ --block-size\ 20\ bert\ ernie .Pp と入力します。 .Fl f および .Fl b フラグは両方とも引数を必要としていることに注意してください。 -この引数は、コマンド単語に書かれているのと同じ順序でコマンドライ -ンから取得されます。 +この引数は、コマンド単語に書かれているのと同じ順序でコマンドラインから +取得されます。 .Pp -/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロッ -クサイズですので、上記の例は次のように単純化できます。 +/dev/rst0 はデフォルトのデバイスであり、20 はデフォルトのブロック +サイズですので、上記の例は次のように単純化できます。 .Pp .Dl tar c bert ernie .Pp "backup.tar" というアーカイブから、すべての C ソース及びヘッダを 抽出するには、次のようにタイプします。 .Pp -.Dl tar xf backup.tar "*.[ch]" +.Dl tar xf backup.tar '*.[ch]' .Pp シェルがカレントディレクトリ内のファイル名に展開しないよう、パタ ーンをクォートしなければならないことに注意してください。(当然、 @@ -364,7 +387,8 @@ tar cf - -C srcdir . | tar xpf - -C destdir ことに注意してください。次のようにタイプしなければならないわけで はなく、上記のような書き方で1文字フラグを使うことができます。 .Pp -.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar/ +.Dl tar --block-compress --gzip --verbose --file /dev/rfd1a --block-size 20 tar +/ .Pp 上のようにして作成したディスクの内容は、次のようにすればリスト表 示できます。 @@ -382,12 +406,29 @@ archive1.tar .Pp とタイプしてもうまくいかないことに注意してください。なぜなら、 tar アーカイブの末尾には end-of-file ブロックがあるからです。) +.Pp +srcdir ディレクトリから 1997 年 2 月 9 日 13:00 以降に変更をされた +全てのファイルをアーカイブするためには、以下の形式を使って下さい。 +.Dl tar\ -c\ -f\ backup.tar\ --newer-mtime\ 'Feb\ 9\ 13:15\ 1997'\ srcdir/ +.Pp +他の時間指定形式としては、'02/09/97 13:15', +\&'1997-02-09 13:15', '13:15 9 Feb 1997', '9 Feb 1997 13:15', +\&'Feb. 9, 1997 1:15pm', '09-Feb', '3 weeks ago', 'May first Sunday' +があります。 +正しいタイムゾーンを指定するためには、 +`13:15 CEST' や `13:15+200' を使用して下さい。 + .Sh 環境変数 -tar プログラムは、以下の環境変数を参照します。 +.Nm +プログラムは、以下の環境変数を参照します。 .Bl -tag -width "POSIXLY-CORRECT" .It POSIXLY-CORRECT -通常、tar はファイル指定の中に混ざったフラグを処理します。 -この環境変数を設定すると、tar は最初のフラグ以外の引数を見つける +通常、 +.Nm +はファイル指定の中に混ざったフラグを処理します。 +この環境変数を設定すると、 +.Nm +は最初のフラグ以外の引数を見つける とそれ以降の引数に対してフラグ処理を行なわないという、POSIX 仕様 に合わせた動作を行なうようになります。 .It SHELL @@ -415,9 +456,12 @@ tar .Xr rmt 8 .\" .Sh 規格 .Sh 歴史 -tar フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に +.Nm +フォーマットは立派な歴史を持っていて、Sixth Edition UNIX に 原点があります。 -この tar の実装は GNU 実装であり、John Gilmore によって書かれた +この +.Nm +の実装は GNU 実装であり、John Gilmore によって書かれた パブリックドメイン tar が元になっています。 .Sh 作者 次の人を含む、大変多くの人々。[ソースの中の ChangeLog ファイルに記 diff --git a/ja_JP.eucJP/man/man1/tcpdump.1 b/ja_JP.eucJP/man/man1/tcpdump.1 index 4bf3ee2c72..211e16ce81 100644 --- a/ja_JP.eucJP/man/man1/tcpdump.1 +++ b/ja_JP.eucJP/man/man1/tcpdump.1 @@ -1,4 +1,4 @@ -.\" @(#) $Header: /home/ncvs/doc/ja_JP.eucJP/man/man1/tcpdump.1,v 1.1.1.1 1998-02-25 04:54:16 hanai Exp $ (LBL) +.\" @(#) $Header: /home/ncvs/doc/ja_JP.eucJP/man/man1/tcpdump.1,v 1.2 1998-02-27 01:26:59 hanai Exp $ (LBL) .\" jpman %Id: tcpdump.1,v 1.3 1997/05/23 22:18:59 yugawa Stab % .\" .\" Copyright (c) 1987, 1988, 1989, 1990, 1991, 1992, 1994, 1995, 1996 diff --git a/ja_JP.eucJP/man/man1/tcpslice.1 b/ja_JP.eucJP/man/man1/tcpslice.1 index 13501d17d4..65709da229 100644 --- a/ja_JP.eucJP/man/man1/tcpslice.1 +++ b/ja_JP.eucJP/man/man1/tcpslice.1 @@ -1,4 +1,4 @@ -.\" @(#) $Header: /home/ncvs/doc/ja_JP.eucJP/man/man1/tcpslice.1,v 1.1.1.1 1998-02-25 04:54:16 hanai Exp $ (LBL) +.\" @(#) $Header: /home/ncvs/doc/ja_JP.eucJP/man/man1/tcpslice.1,v 1.2 1998-02-27 01:26:59 hanai Exp $ (LBL) .\" jpman %Id: tcpslice.1,v 1.3 1997/09/07 14:12:55 horikawa Stab % .\" .\" Copyright (c) 1988-1990 The Regents of the University of California. diff --git a/ja_JP.eucJP/man/man1/telnet.1 b/ja_JP.eucJP/man/man1/telnet.1 index 7b7931da57..d37477ec7f 100644 --- a/ja_JP.eucJP/man/man1/telnet.1 +++ b/ja_JP.eucJP/man/man1/telnet.1 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)telnet.1 8.5 (Berkeley) 3/1/94 +.\" %Id: telnet.1,v 1.3.2.3 1998/02/01 07:30:45 steve Exp % .\" jpman %Id: telnet.1,v 1.2 1997/05/23 00:55:09 mutoh Stab % -.\" %Id: telnet.1,v 1.3.2.2 1997/08/18 07:08:03 charnier Exp % .\" .Dd March 1, 1994 .Dt TELNET 1 @@ -52,7 +52,7 @@ .Op Fl n Ar tracefile .Oo .Ar host -.Op port +.Op Ar port .Oc .Sh 解説 .Nm @@ -238,7 +238,7 @@ rlogin .Ic localchars が .Dv TRUE -になっている場合には(デフォルトでは、\*(Lqold line by line\*(Lq に設定されて +になっている場合には(デフォルトでは、\*(Lqold line by line\*(Rq に設定されて います。以下を参照)、ユーザの .Ic quit , .Ic intr , @@ -462,7 +462,7 @@ logout あるいはリモートホストが .Dv LINEMODE オプションを解釈できない場合に -\*(Lqcharacter at a time\*(Lq +\*(Lqcharacter at a time\*(Rq モードに入ります。 .It Ic line .Dv TELNET LINEMODE @@ -470,7 +470,7 @@ logout あるいはリモートホストが .Dv LINEMODE オプションを解釈できない場合に -\*(Lqold-line-by-line\*(Lq +\*(Lqold-line-by-line\*(Rq モードに入ろうとします。 .It Ic isig Pq Ic \-isig .Dv LINEMODE @@ -713,8 +713,7 @@ processes) シーケンス(前述の .Ic send ayt 参照) -がリモートホストに送られます。 -"Are You There" 文字の初期値は +がリモートホストに送られます。\*(LqAre You There\*(Rq 文字の初期値は ターミナルステータス文字です。 .It Ic echo これは @@ -836,7 +835,7 @@ processes) が .Dv LINEMODE か -\*(Lqold line by line\*(Lq モードで動作している時に、端末の +\*(Lqold line by line\*(Rq モードで動作している時に、端末の .Ic lnext 文字がこの文字として使われます。 初期値として、端末の @@ -943,7 +942,7 @@ processes) が .Dv LINEMODE か -\*(Lqold line by line\*(Lq モードで動作している時に、端末の +\*(Lqold line by line\*(Rq モードで動作している時に、端末の .Ic worderase 文字がこの文字として使われます。 初期値として、端末の diff --git a/ja_JP.eucJP/man/man1/tip.1 b/ja_JP.eucJP/man/man1/tip.1 index 1f0ab2f5c5..d1df2d0a63 100644 --- a/ja_JP.eucJP/man/man1/tip.1 +++ b/ja_JP.eucJP/man/man1/tip.1 @@ -49,10 +49,10 @@ .Ar phone\-number .Sh 解説 .Nm tip -は、他のマシンとの間に全二重のコネクションを確立します。 -リモートマシンへのログインシーケンスを表示します。 -この時、コネクションを張りたいマシンに対して -ログインアカウント(相当)を持つことが必要であるとは述べません。 +は、他のマシンとの間に全二重のコネクションを確立し、 +リモートマシンへ直接ログインしてみせます。 +言うまでもないことですが、コネクションを張りたいマシンに対しては、 +ログインアカウント (かそれに相当するもの) がなければなりません。 .Pp 以下のオプションが使用可能です: .Bl -tag -width indent diff --git a/ja_JP.eucJP/man/man1/top.1 b/ja_JP.eucJP/man/man1/top.1 index c0a344c128..1c7a156823 100644 --- a/ja_JP.eucJP/man/man1/top.1 +++ b/ja_JP.eucJP/man/man1/top.1 @@ -294,7 +294,7 @@ TOP .br /etc/passwd uid 値をユーザ名に変換するのに使用 .br -/vmunix システムイメージ +/kernel システムイメージ .SH バグ .B \-I のデフォルト値が もう一度変更されましたが、私を責めないで下さい。 diff --git a/ja_JP.eucJP/man/man1/tr.1 b/ja_JP.eucJP/man/man1/tr.1 index ff9f1e26f9..394b3a6948 100644 --- a/ja_JP.eucJP/man/man1/tr.1 +++ b/ja_JP.eucJP/man/man1/tr.1 @@ -35,7 +35,7 @@ .\" @(#)tr.1 8.1 (Berkeley) 6/6/93 .\" jpman %Id: tr.1,v 1.4 1997/06/13 00:21:44 jsakai Stab % .\" -.Dd June 6, 1993 +.Dd October 11, 1997 .Dt TR 1 .Os .Sh 名称 @@ -43,21 +43,21 @@ .Nd 文字の置換 .Sh 書式 .Nm tr -.Op Fl cs +.Op Fl csu .Ar string1 string2 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl d .Ar string1 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl s .Ar string1 .br .Nm tr -.Op Fl c +.Op Fl cu .Fl ds .Ar string1 string2 .Sh 解説 @@ -83,6 +83,9 @@ のどちらか) に含まれている同一の文字が、入力の中に連続して現れるとき、 それを 1 つの文字に圧縮します。この圧縮は、全ての削除や変換が終わった 後に行われます。 +.It Fl u +.Fl u +オプションは出力がバッファリングされないことを保証します。 .El .Pp 書式の最初の形式では、 @@ -286,3 +289,7 @@ POSIX 他の POSIX システムへの可搬性のあるシェルスクリプトを 作ろうとするならば、この振る舞いを当てにせずに、``[#*]'' と いう表現を使うべきです。 +.Fl u +オプションは +.St -p1003.2 +標準の拡張です。 diff --git a/ja_JP.eucJP/man/man1/vidcontrol.1 b/ja_JP.eucJP/man/man1/vidcontrol.1 index 057886c952..9af85c840e 100644 --- a/ja_JP.eucJP/man/man1/vidcontrol.1 +++ b/ja_JP.eucJP/man/man1/vidcontrol.1 @@ -21,21 +21,29 @@ .Nd syscons 画面ドライバの操作ユーティリティ .Sh 書式 .Nm -.Ar options ... +.Op Fl r Ar fg Ar bg +.Op Fl b Ar color +.Op Fl c Ar appearance +.Op Fl d +.Op Fl l Ar scrmap +.Op Fl L +.Op Fl m Ar on|off +.Op Fl f Ar size Ar file +.Op Fl t Ar N|off +.Op Fl x +.Op mode +.Op fgcol Op bgcol +.Op show .Sh 解説 -.Nm vidcontrol +.Nm コマンドを用いて syscons 画面ドライバの様々なオプション、例えば、 画面モード、色、カーソル、画面マップ(scrnmap)、 フォント、スクリーンセーバタイムアウトを設定することができます。 .Pp -新しい画面モードを選択するには、 -.Nm vidcontrol -の引数に画面モードを指定します。 -例えば: -.Bd -literal -vidcontrol VGA_80x25 -.Ed -.Pp +以下のコマンドラインオプションをサポートしています: +.Bl -tag -width indent +.It mode +新しいビデオモードを選択します。 現在サポートしているモードは以下の通りです: .Ar VGA_40x25 , .Ar VGA_80x25 , @@ -49,18 +57,13 @@ vidcontrol VGA_80x25 も使用できます。また、グラフィックモード .Ar VGA_320x200 も選択できます。 -.Pp -テキストを表示する際の色は、 +.It fgcol Op bgcol +テキストを表示する際の色を変更します。 前景色(例: "vidcontrol white")、あるいは 前景色および背景色(例: "vidcontrol yellow blue")を指定することにより 変更できます。 -.Pp -現在のプラットフォーム上でサポートされている色を見るには -"vidcontrol show" -とします。 -.Pp -以下のコマンドラインオプションがサポートされています: -.Bl -tag -width Fl +.It show +指定したプラットフォームでサポートされている色を表示します。 .It Fl r Ar foreground Ar background 反転表示モードで用いる色を前景色 .Ar foreground @@ -85,7 +88,11 @@ vidcontrol VGA_80x25 .It Fl L 画面出力マップをデフォルトに設定します。 .It Fl m Ar on|off -マウスポインタをオン/オフします。 +マウスポインタを +.Ar on +または +.Ar off +します。 テキストモードでのカット&ペースト機能を利用するために moused デーモンと共に 使用します。 .It Fl f Ar size Ar file @@ -118,4 +125,4 @@ vidcontrol VGA_80x25 .Xr keyboard 4 , .Xr screen 4 .Sh 作者 -Sen Schmidt (sos@FreeBSD.org) +.An Sen Schmidt Aq sos@FreeBSD.org diff --git a/ja_JP.eucJP/man/man1/w.1 b/ja_JP.eucJP/man/man1/w.1 index a9cc70e68b..98c2b2d694 100644 --- a/ja_JP.eucJP/man/man1/w.1 +++ b/ja_JP.eucJP/man/man1/w.1 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)w.1 8.1 (Berkeley) 6/6/93 -.\" %Id: w.1,v 1.2.8.3 1997/08/26 06:47:43 charnier Exp % +.\" %Id: w.1,v 1.2.8.4 1998/01/12 00:49:26 steve Exp % .\" jpman %Id: w.1,v 1.2 1997/04/16 01:03:05 mitchy Stab % .\" .Dd June 6, 1993 diff --git a/ja_JP.eucJP/man/man1/whois.1 b/ja_JP.eucJP/man/man1/whois.1 index 42d6bbd6dc..28195a7d6d 100644 --- a/ja_JP.eucJP/man/man1/whois.1 +++ b/ja_JP.eucJP/man/man1/whois.1 @@ -29,31 +29,58 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)whois.1 8.1 (Berkeley) 6/6/93 +.\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93 +.\" %Id: whois.1,v 1.1.1.1.8.3 1998/02/19 19:10:22 wollman Exp % .\" jpman %Id: whois.1,v 1.3 1997/06/14 04:30:33 kubo Stab % .\" -.Dd June 6, 1993 +.Dd February 19, 1998 .Dt WHOIS 1 .Os BSD 4.3 .Sh 名称 .Nm whois -.Nd インターネットのユーザ名簿 (user name directory) サービス +.Nd インターネットのドメイン名とネットワーク番号のディレクトリサービス .Sh 書式 .Nm whois -.Op Fl h Ar hostname +.Op Fl adpr +.Op Fl h Ar host .Ar name ... .Sh 解説 .Nm -はネットワークインフォメーションセンター +はネットワークインフォメーションセンタ .Pq Tn NIC -のデータベースの検索を行ないます。 +のデータベースのレコード検索を行ないます。 .Pp オプションとしては以下のものがあります。 .Bl -tag -width Ds -.It Fl h Ar hostname -NIC に代えて -.Ar hostname -で指定したホスト用います。デフォルトのホストは whois.internic.net です。 +.It Fl a +American Registry for Internet Numbers +.Pq Tn ARIN +データベースを使用します。 +ここには、 +.Tn APNIC +および +.Tn RIPE +以外がカバーする全世界の IP 番号があります。 +.It Fl d +(US Military) Defense Data Network +.Pq Tn DDN +データベースを使用します。 +.Tn \&.MIL +のサブドメインの連絡先があります。 +.It Fl h Ar host +デフォルトの NIC (whois.internic.net) に代えて、指定したホスト用います。 +ホスト名もしくは IP 番号を指定可能です。 +.It Fl p +Asia/Pacific Network Information Center +.Pq Tn APNIC +データベースを使用します。 +ここには、東アジア、オーストラリア、ニュージーランド、太平洋諸島の +IP 番号があります。 +.It Fl r +R\(aaeseaux IP Europ\(aaeens +.Pq Tn RIPE +データベースを使用します。 +ここには、ヨーロッパのドメイン番号とドメインの連絡先情報があります。 .El .Pp .Nm diff --git a/ja_JP.eucJP/man/man1/xten.1 b/ja_JP.eucJP/man/man1/xten.1 index 12511045f9..5102a09866 100644 --- a/ja_JP.eucJP/man/man1/xten.1 +++ b/ja_JP.eucJP/man/man1/xten.1 @@ -27,20 +27,26 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: xten.1,v 1.2.2.1 1997/03/06 08:00:52 mpp Exp % +.\" %Id: xten.1,v 1.2.2.2 1997/11/18 07:30:08 charnier Exp % .\" jpman %Id: xten.1,v 1.3 1997/06/12 17:21:13 kubo Stab % .\" -.Th XTEN 8 "30 Oct 1993" .Dd Oct 30, 1993 .Dt XTEN 1 -.Os BSD FreeBSD +.Os .Sh 名称 -xten \- X-10 コマンドを転送する +.Nm xten +.Nd X-10 コマンドを転送する .Sh 書式 .Nm xten -[ - ] house key[:cnt] [ [ house ] key[:cnt] .\|.\|. ] +.Op Fl "" +.Ar house Ar key Ns Op Ar :cnt +.Oo +.Op Ar house +.Ar key Ns Op Ar :cnt +.Ar ... +.Oc .Sh 解説 -.Nm xten +.Nm は、 X-10 デーモンへのコマンドラインインタフェースです。 一文字のハウスコード (A-P) と一連のキー/ユニットコードが引数として 与えられて呼び出された時、X-10 デーモンへ対応する一連の X-10 @@ -49,14 +55,20 @@ xten \- X-10 知ることは一般的にできませんが、X-10 デーモンは、パケットがすべて正しく転送されるように、 最大限努力します。 .Pp -一つの引数 \- 付きで呼び出された時は、 -.Nm xten +一つの引数 +.Fl +付きで呼び出された時は、 +.Nm は、インタラクティブモードに入ります。ここでは、標準入力を繰り返し 読み込み、X-10 デーモンに送り、デーモンからの一行の応答が標準出力に表示されます。 .Sh オプション -ハウス引数は、 A-P の範囲の一文字のハウスコードです。 +ハウス( +.Ar house +)引数は、 A-P の範囲の一文字のハウスコードです。 全ての X-10 リクエストは、ハウスコードを参照します。 -各キーは 1-16 の数値コードか、X-10 機能を指定する文字列です。 +各キー( +.Ar key +)は 1-16 の数値コードか、X-10 機能を指定する文字列です。 可能な機能コード文字列は以下の通りです。 .Bl -diag .It AllUnitsOff @@ -77,13 +89,17 @@ xten \- X-10 .It StatusRequest .El .Pp -各キーにはオプションの数字が続きます。この数字は、間隙がないキーコード +各キー( +.Ar key +)にはオプションの数字( +.Ar cnt +)が続きます。この数字は、間隙がないキーコード によっておくられるパケットの数を指定します。 この引数が省略された時、二つのパケットが転送されます。 X-10 の -.I Dim +.Em Dim と -.I Bright +.Em Bright コマンドでは、二つ以外のパケット数を指定して使うことができます。 .Sh 関連項目 .Xr tw 4 , @@ -94,4 +110,4 @@ X-10 TW523 スペシャルファイル .El .Sh 作者 -Eugene W. Stark (stark@cs.sunysb.edu) +.An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja_JP.eucJP/man/man1/ypwhich.1 b/ja_JP.eucJP/man/man1/ypwhich.1 new file mode 100644 index 0000000000..b097bf1251 --- /dev/null +++ b/ja_JP.eucJP/man/man1/ypwhich.1 @@ -0,0 +1,100 @@ +.\" %NetBSD: ypwhich.1,v 1.3 1996/05/13 02:43:46 thorpej Exp % +.\" +.\" Copyright (c) 1994 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ypwhich.1,v 1.1.2.1 1997/11/05 05:45:21 obrien Exp % +.\" +.Dd February 23, 1994 +.Dt YPWHICH 1 +.Os +.Sh 名称 +.Nm ypwhich +.Nd YP サーバのホスト名、もしくはマップのマスタを表示する +.Sh 書式 +.Nm ypwhich +.Op Fl d Ar domain +.Oo +.Op Fl t +.Fl m Op Ar mname +| +.Ar host +.Oc +.Nm ypwhich +.Fl x +.Sh 解説 +.Nm +はどの +.Tn YP +サーバが +.Tn YP +サービスをクライアントに提供しているか、または、どれがマップのマスタ +なのかを、知らせます。 +引数なしで用いられると、ローカルマシンの +.Tn YP +サーバを返します。 +.Ar host +を指定した場合には、どの +.Tn YP +サーバを使っているのか、指定したマシンに問合せます。 +.Pp +オプションには以下のものが有ります: +.Bl -tag -width indent +.It Fl d Ar domain +デフォルトのドメインの代わりに +.Ar domain +を使用します。 +.It Fl t +ニックネームを対応するマップネームに展開するのを抑制します。 +.It Fl m Op Ar mname +指定したマップの +.Tn YP +サーバを探します。 +.Fl m +オプションでは、 +.Ar host +は指定できません。 +.Ar mname +は、マップネームでもニックネームでもかまいません。もし +.Ar mname +が省略されていると、 +.Nm +は、利用できるマップのリストを作成します。 +.It Fl x +マップのニックネームのテーブルを表示します。 +.El +.Sh 関連項目 +.Xr domainname 1 , +.Xr ypcat 1 , +.Xr ypmatch 1 , +.Xr yp 4 , +.Xr ypbind 8 , +.Xr yppoll 8 , +.Xr ypset 8 +.Sh 作者 +Theo De Raadt diff --git a/ja_JP.eucJP/man/man8/Makefile b/ja_JP.eucJP/man/man8/Makefile index f41bd818f4..f228f88b9b 100644 --- a/ja_JP.eucJP/man/man8/Makefile +++ b/ja_JP.eucJP/man/man8/Makefile @@ -2,7 +2,6 @@ MAN8 = IPXrouted.8\ MAKEDEV.8\ ac.8\ accton.8\ - addgroup.8\ adding_user.8\ adduser.8\ adjkerntz.8\ @@ -127,6 +126,7 @@ MAN8 = IPXrouted.8\ pccardd.8\ pciconf.8\ ping.8\ + pnpinfo.8\ portmap.8\ ppp.8\ pppctl.8\ @@ -151,7 +151,6 @@ MAN8 = IPXrouted.8\ rexecd.8\ rlogind.8\ rmail.8\ - rmgroup.8\ rmt.8\ rmuser.8\ rndcontrol.8\ diff --git a/ja_JP.eucJP/man/man8/adduser.8 b/ja_JP.eucJP/man/man8/adduser.8 index 7c18dd79b5..169cc7cd04 100644 --- a/ja_JP.eucJP/man/man8/adduser.8 +++ b/ja_JP.eucJP/man/man8/adduser.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: adduser.8,v 1.12.2.5 1997/10/14 17:34:01 wosch Exp % +.\" %Id: adduser.8,v 1.12.2.7 1998/02/14 22:56:25 steve Exp % .\" jpman %Id: adduser.8,v 1.4 1997/08/07 17:53:51 ken Stab % .\" .Dd January 9, 1995 @@ -142,11 +142,15 @@ uid/gid .Bl -tag -width Ds .It Sy -batch username [group[,group]...] [class] [fullname] [password] バッチモードです。 +列挙されるグループは、ユーザがメンバとなる二番目のグループであり、 +デフォルトのログイングループ以外のものを書きます。 +ヌル文字列の引数を埋め草として使用することができ、 +この場合デフォルト値の動作となります。 .It Sy -check_only /etc/passwd, /etc/group, /etc/shells をチェックし、終了します。 .It Sy -class Ar login_class デフォルトのログインクラスを設定します。 -.It Sy -create_config +.It Sy -config_create 新しい設定を設定ファイルに書込み、メッセージファイルを作成して、 終了します。 .It Sy -dotdir Ar directory diff --git a/ja_JP.eucJP/man/man8/apm.8 b/ja_JP.eucJP/man/man8/apm.8 index 6a9dfebc69..c691043a89 100644 --- a/ja_JP.eucJP/man/man8/apm.8 +++ b/ja_JP.eucJP/man/man8/apm.8 @@ -17,11 +17,8 @@ .Nd APM BIOS の制御を行い、その情報を表示する .Sh 書式 .Nm apm -.Op Fl z -.Op Fl b -.Op Fl a -.Op Fl l -.Op Fl s +.Op Fl ablsz +.Op Fl d Ar 1|0 .Pp .Nm zzz .Sh 解説 @@ -41,11 +38,13 @@ .Nm apm は、現在の APM の状態や情報を冗長モードで表示します。 .Bl -tag -width indent -.It Fl z -システムをサスペンドします。これは、 -.Nm zzz -と等価です。 -.Pp +.It Fl a +現在の AC 電源の状態を整数値で表示します。 +0, 1がそれぞれ +.Dq 外れている (off-line) +状態と +.Dq つながっている (on-line) +状態をあらわします。 .It Fl b 整数値で、現在のバッテリ状態を表示します。 0, 1, 2, 3という値はそれぞれ、 @@ -57,20 +56,17 @@ 状態、 .Dq 充電 (charging) 状態をあらわします。 -.Pp -.It Fl a -現在の AC 電源の状態を整数値で表示します。 -0, 1がそれぞれ -.Dq 外れている (off-line) -状態と -.Dq つながっている (on-line) -状態をあらわします。 -.Pp +.It Fl d +通常のサスペンドとディスプレイのサスペンドを別に扱わない/別に扱うを、 +それぞれ +.Ar 1 +と +.Ar 0 +で制御します。 .It Fl l 現在のバッテリの残り割合を表示します。 もし、あなたのラップトップがこの機能を提供していない時には、 255 が表示されます。 -.Pp .It Fl s APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 .Dq 利用不可 (disabled) @@ -78,6 +74,11 @@ APM .Dq 利用可能 (enabled) 状態 をあらわします。 +.It Fl z +システムをサスペンドします。これは、 +.Nm zzz +と等価です。 +.El .Sh バグ いくつかの APM 実装では、 .Nm apm diff --git a/ja_JP.eucJP/man/man8/arp.8 b/ja_JP.eucJP/man/man8/arp.8 index d8b88690cb..a799aeb7ce 100644 --- a/ja_JP.eucJP/man/man8/arp.8 +++ b/ja_JP.eucJP/man/man8/arp.8 @@ -47,6 +47,10 @@ .Fl a .Nm arp .Fl d Ar hostname +.Op Ar proxy +.Nm arp +.Fl d +.Fl a .Nm arp .Fl s Ar hostname ether_addr .Op Ar temp @@ -76,7 +80,7 @@ .It Fl a プログラムは現在の .Tn ARP -エントリを全て表示します。 +エントリを全て表示もしくは消去します。 .It Fl d スーパユーザならば .Ar hostname diff --git a/ja_JP.eucJP/man/man8/atrun.8 b/ja_JP.eucJP/man/man8/atrun.8 index 74025e990a..985cff6459 100644 --- a/ja_JP.eucJP/man/man8/atrun.8 +++ b/ja_JP.eucJP/man/man8/atrun.8 @@ -1,4 +1,4 @@ -.\" %Id: atrun.man,v 1.1 1995/04/12 02:52:21 ache Exp % +.\" %Id: atrun.man,v 1.1.6.1 1997/12/12 07:15:35 charnier Exp % .\" jpman %Id: atrun.8,v 1.2 1997/04/23 02:43:41 yugawa Stab % .Dd April 12, 1995 .Dt ATRUN 8 @@ -11,7 +11,7 @@ .Op Fl l Ar load_avg .Op Fl d .Sh 解説 -.Nm atrun +.Nm コマンドは .Xr at 1 でキューに入れたジョブを実行するコマンドです。 @@ -25,9 +25,9 @@ .fi という設定が含まれていたならば、5分毎に起動される事になります。 .Pp -.Nm atrun +.Nm が起動する度に、小文字のキューの中の実行時間が来た各ジョブがスタートします。 -.Nm atrun +.Nm が起動する度に、(大文字のキューで表される)バッチジョブのうち 優先順位が最も高い物からひとつずつスタートします。 .\" 上記の記述はオリジナルの英語版では、"A maximum of one batch jobs (denoted @@ -51,7 +51,7 @@ を使う代わりに標準エラー出力にエラーメッセージを吐き出す。 .El .Sh 警告 -.Nm atrun +.Nm を動かすためには .Xr cron 8 デーモンを起動しておかねばなりません。 @@ -63,13 +63,13 @@ ジョブファイルを保管しておくディレクトリ .El .Sh 関連項目 -.Xr cron 8 , -.Xr crontab 1 , -.Xr crontab 5 , .Xr at 1 , -.Xr syslog 3 +.Xr crontab 1 , +.Xr syslog 3 , +.Xr crontab 5 , +.Xr cron 8 .Sh バグ -.Nm atrun +.Nm の機能は .Xr cron 8 に統合されるべきです。 diff --git a/ja_JP.eucJP/man/man8/boot_i386.8 b/ja_JP.eucJP/man/man8/boot_i386.8 index 6453f92cbb..e39470c91d 100644 --- a/ja_JP.eucJP/man/man8/boot_i386.8 +++ b/ja_JP.eucJP/man/man8/boot_i386.8 @@ -35,7 +35,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 -.\" %Id: boot_i386.8,v 1.4.2.2 1997/07/05 02:04:31 bde Exp % +.\" %Id: boot_i386.8,v 1.4.2.3 1998/02/10 00:18:25 msmith Exp % .\" jpman %Id: boot_i386.8,v 1.5 1997/12/04 18:33:50 ken Exp % .\" .\" @@ -137,6 +137,10 @@ CDROM .It Fl c ロードしたカーネルに対し、ハードウェアのパラメータを変更するため、 UserConfig を実行します。 +カーネルが USERCONFIG_BOOT オプション付きで構築された場合、 +スクリプト中に +.Ic quit +コマンドがあったとしても、UserConfig 中にとどまります。 .It Fl D シングルとデュアルのコンソール設定を切り替えます。シングル設定では、 下記の diff --git a/ja_JP.eucJP/man/man8/bootpd.8 b/ja_JP.eucJP/man/man8/bootpd.8 index 924c413969..3fda8784ae 100644 --- a/ja_JP.eucJP/man/man8/bootpd.8 +++ b/ja_JP.eucJP/man/man8/bootpd.8 @@ -1,6 +1,6 @@ .\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University .\" -.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.2 1997/08/24 18:22:28 joerg Exp % +.\" %Header: /home/ncvs/src/libexec/bootpd/bootpd.8,v 1.4.2.5 1998/02/18 05:55:24 jkh Exp % .\" jpman %Id: bootpd.8,v 1.4 1997/10/11 07:39:12 horikawa Stab % .\" .TH BOOTPD 8 "November 06, 1993" "Carnegie Mellon University" @@ -93,7 +93,7 @@ inetd .I bootpd を呼びだすことによって、 スタンドアローンモードで自動的に起動することができます) -.I bootgw +.I bootpgw はコンフィギュレーションファイルを読まないので、 起動時の遅延はかなり小さく、 スタンドアローンモードはあまり役に立ちません。 diff --git a/ja_JP.eucJP/man/man8/dump.8 b/ja_JP.eucJP/man/man8/dump.8 index bb84e62935..659e4a980c 100644 --- a/ja_JP.eucJP/man/man8/dump.8 +++ b/ja_JP.eucJP/man/man8/dump.8 @@ -31,8 +31,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)dump.8 8.1 (Berkeley) 6/16/93 +.\" %Id: dump.8,v 1.5.2.7 1998/01/03 20:28:13 steve Exp % .\" jpman %Id: dump.8,v 1.2 1997/06/12 05:57:09 yugawa Stab % -.\" %Id: dump.8,v 1.5.2.3 1997/03/03 07:01:19 mpp Exp % .\" .Dd June 16, 1993 .Dt DUMP 8 diff --git a/ja_JP.eucJP/man/man8/fingerd.8 b/ja_JP.eucJP/man/man8/fingerd.8 index 9858655dae..bd2ec90c74 100644 --- a/ja_JP.eucJP/man/man8/fingerd.8 +++ b/ja_JP.eucJP/man/man8/fingerd.8 @@ -44,7 +44,7 @@ .Op Fl l .Op Fl p Ar filename .Sh 解説 -.Nm fingerd +.Nm は、ネットワークの各サイト上の name と finger プログラムとの インターフェースを提供する、 .%T RFC1196 @@ -54,7 +54,7 @@ 特別なフォーマットは規定されておらず、プロトコルは 1 行ずつ コマンドラインのような形式でやりとりされます。 .Pp -.Nm fingerd +.Nm は、 .Tn TCP の 79 番ポートを見張っている @@ -62,9 +62,9 @@ から開始されます。接続されると、 .Aq Tn CRLF で区切られたコマンドライン 1 行を受け取ります。これは -.Nm finger 1 +.Xr finger 1 に送られ、処理されます。 -.Nm fingerd +.Nm は、出力が終わるとすぐに接続を切ります。 .Pp もし、そのコマンドラインがヌルの (つまり @@ -89,11 +89,11 @@ のどちらでもかまいません。 名前が曖昧な場合は、マッチするものすべてについて表示されます。 .Pp -.Nm fingerd +.Nm に渡す引数として、 .Pa /etc/inetd.conf の中で指定できるオプションは以下のとおりです: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl s secureモードを有効にします。ユーザ名なしの問い合わせと、他の リモートホストへの問い合わせの転送は拒否されます。 @@ -103,7 +103,7 @@ secure を通して LOG_NOTICE の優先度で報告します。 .It Fl p ローカルの情報提供元としてデフォルト以外のプログラムを使います。 -.Nm fingerd +.Nm によって起動されるデフォルトのローカルプログラムは、 .Xr finger 1 です。カスタマイズされたローカルサーバを指定することにより、 @@ -121,7 +121,7 @@ secure ユーザプログラムで直接コネクトすると、 サーバに意味の無いネゴシエーションオプションを送ることになり 不正なコマンドライン解釈を行う可能性があります。 -.Nm fingerd +.Nm は、 .Tn IAC のものをフィルタリングして除くべきであり、おそらく diff --git a/ja_JP.eucJP/man/man8/ftpd.8 b/ja_JP.eucJP/man/man8/ftpd.8 index ba1ed0341c..ea1f1eb7f2 100644 --- a/ja_JP.eucJP/man/man8/ftpd.8 +++ b/ja_JP.eucJP/man/man8/ftpd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94 +.\" %Id: ftpd.8,v 1.9.2.12 1998/02/19 01:07:49 jkh Exp % .\" jpman %Id: ftpd.8,v 1.3 1997/09/08 07:23:46 kuma Stab % -.\" %Id: ftpd.8,v 1.9.2.8 1997/05/10 19:48:12 davidn Exp % .\" .Dd April 19, 1994 .Dt FTPD 8 @@ -52,7 +52,7 @@ .Op Fl a Ar address .Op Fl p Ar file .Sh 解説 -.Nm ftpd +.Nm は、インターネットファイル転送プロトコルサーバプロセスです。 このサーバは .Tn TCP @@ -65,7 +65,7 @@ を参照して下さい。 .Pp 利用可能なオプションは以下の通りです: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl d syslog の LOG_FTP のファシリティ (facility) を用いてデバッグ情報を出力します。 .It Fl l @@ -83,35 +83,35 @@ make directory, remove directory, rename のコンフィギュレーションファイルでそれを有効にしなければなりません。 .It Fl D このオプションがセットされると、 -.Nm ftpd +.Nm は制御端末を切り離してデーモンとなり、 FTP ポートへの接続要求を待ち、 子プロセスを生成して接続要求に対応します。 この方式は -.Nm ftpd +.Nm を .Xr inetd 8 から起動するよりオーバヘッドが少ないため、 処理量の多いサーバで負荷を低減するのに役立ちます。 .It Fl R このオプションがセットされると、 -.Nm ftpd +.Nm は、ユーザ操作のセキュリティチェックや PORT 要求の制限に関して 古き良き時代の振る舞いに戻ります。 現在では、 -.Nm ftpd +.Nm はリモートユーザのホストの非特権ポートに向けられた PORT コマンド だけを用います (これは FTP プロトコルの仕様に違反していますが、 いくつかのセキュリティホールを閉じることができます)。 .It Fl S このオプションがセットされると、 -.Nm ftpd +.Nm は匿名 (anonymous) による転送の全てについてのログを、ファイル .Pa /var/log/ftpd が存在する場合に限り、このファイルに残します。 .It Fl U 以前のバージョンの -.Nm ftpd +.Nm では、パッシブモードのクライアントがサーバにデータ接続を要求すると、 サーバは 1024 〜 4999 の範囲のデータポートを使用していました。 現在のバージョンでは、サーバはデフォルトでは 40000 〜 44999 の範囲の @@ -161,11 +161,16 @@ FTP ログイン成功後に .Nm はその内容を出力します。 +使用される motd ファイルはログイン環境に対して相対であることに +注意してください。 +つまり、匿名ユーザの場合には、 +.Pa ~ftp/etc +に存在することを意味じます。 .Pp この ftp サーバは、現在、以下の ftp リクエストをサポートしています。 リクエストの文字の大文字小文字の区別は無視されます。 .Bl -column "Request" -offset indent -.It リクエスト Ta "説明" +.It Sy リクエスト Ta Sy "説明" .It ABOR Ta "abort previous command" .It ACCT Ta "specify account (ignored)" .It ALLO Ta "allocate storage (vacuously)" @@ -232,7 +237,7 @@ STAT コマンドを受けとり、その前に Telnet IP や Synch があった場合、転送ステータスが返されます。 .Pp -.Nm ftpd +.Nm は、 .Xr csh 1 で使われているファイル名展開を解釈します。これにより、 @@ -240,7 +245,7 @@ STAT .Dq Li \&*?[]{}~ を利用できます。 .Pp -.Nm ftpd +.Nm は、5 つのルールに従ってユーザの認証を行います。 .Pp .Bl -enum -offset indent @@ -309,7 +314,7 @@ USER .El .Pp 最後のケースの場合、 -.Nm ftpd +.Nm は特別な手段でクライアントのアクセス権を制限します。 サーバは .Dq ftp @@ -358,7 +363,7 @@ list .El .Pp システムに複数の IP アドレスがある場合、 -.Nm ftpd +.Nm は仮想ホストの概念をサポートします。 仮想ホストは、複数の匿名 ftp 領域それぞれを別々のインターネットアドレス に割り当てる機能を提供します。 @@ -404,7 +409,7 @@ list .Pp .Em INTERNAL_LS オプションをつけてコンパイルすると、 -.Nm ftpd +.Nm はリモートからのファイル一覧表示要求に対応するための内部サポートを用意し、 chroot された環境でもそれ以外でも .Pa /bin/ls @@ -417,7 +422,7 @@ chroot このサポートは、 .Pa /etc/make.conf あるいはシェルの環境で -.Em FTP_INTERNAL_LS +.Em INTERNAL_LS 変数を設定して ftpd を作成することで追加されます。 .Sh 関連ファイル .Bl -tag -width /etc/ftpwelcome -compact @@ -425,6 +430,8 @@ chroot 歓迎されない/制限を受けるユーザおよびグループのリスト。 .It Pa /etc/ftpchroot chroot される一般ユーザのリスト。 +.It Pa /etc/ftphosts +仮想ホストのための構成ファイル .It Pa /etc/ftpwelcome welcome メッセージ。 .It Pa /etc/ftpmotd diff --git a/ja_JP.eucJP/man/man8/getty.8 b/ja_JP.eucJP/man/man8/getty.8 index 4dec3d58b1..1c200da850 100644 --- a/ja_JP.eucJP/man/man8/getty.8 +++ b/ja_JP.eucJP/man/man8/getty.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93 -.\" %Id: getty.8,v 1.4.2.2 1997/08/17 23:44:30 davidn Exp % +.\" %Id: getty.8,v 1.4.2.3 1997/12/15 07:10:52 charnier Exp % .\" jpman %Id: getty.8,v 1.3 1997/05/19 17:00:46 horikawa Stab % .\" " .Dd April 25, 1991 @@ -46,7 +46,7 @@ .Op Ar tty .Oc .Sh 解説 -.Nm getty +.Nm プログラムは、 .Xr init 8 から呼ばれ、tty回線をオープンしたあと初期化 @@ -64,7 +64,7 @@ .Pp .Ar type は、 -.Nm getty +.Nm が端末回線を特別に扱うようにするために使われます。 この .Ar type @@ -78,18 +78,18 @@ .Pa /etc/gettytab ファイルがなければ、システムのデフォルトが使われます。 テーブルにより指示されれば、 -.Nm getty +.Nm は端末画面をクリアし、 バナーヘッダを表示し、 ログインプロンプトを表示します。通常、このプロンプトのなかに システムのホスト名が含まれます。 .Pp -.Nm getty +.Nm のデフォルトの行動は、大抵の場合、適当な .Pa gettytab テーブルを作成することによって、回避したり修正したりすることができます。 .Pp -.Nm getty +.Nm はタイムアウト時間を設定することができます。これによって、 ログイン名がすぐに入力されないような場合に、ダイアル回線を切断 することができます。 @@ -97,7 +97,8 @@ .Bl -diag .It "ttyxx: No such device or address." .It "ttyxx: No such file or address." -.Xr ttys +.Pp +.Pa ttys ファイルのなかで有効にされていたターミナルがオープンできませんでした。 必要な回線がシステムに設定されていなかったか、 関係するデバイスがブート時のシステム設定の際に組み込まれなかったか、 @@ -108,7 +109,7 @@ .Sh 関連ファイル .Bl -tag -width /etc/gettytab -compact .It Pa /etc/gettytab -端末設定データベース +.It Pa /etc/ttys .El .Sh 関連項目 .Xr login 1 , @@ -118,7 +119,7 @@ .Xr ttys 5 , .Xr init 8 .Sh 歴史 -.Nm getty +.Nm は .At v6 から登場しました。 diff --git a/ja_JP.eucJP/man/man8/ifconfig.8 b/ja_JP.eucJP/man/man8/ifconfig.8 index 44d578b9b1..08725cb06e 100644 --- a/ja_JP.eucJP/man/man8/ifconfig.8 +++ b/ja_JP.eucJP/man/man8/ifconfig.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 -.\" %Id: ifconfig.8,v 1.9.2.2 1997/06/30 11:01:59 peter Exp % +.\" %Id: ifconfig.8,v 1.9.2.3 1998/02/01 07:05:02 steve Exp % .\" jpman %Id: ifconfig.8,v 1.2 1997/03/31 14:09:47 horikawa Stab % .\" .Dd February 13, 1996 diff --git a/ja_JP.eucJP/man/man8/inetd.8 b/ja_JP.eucJP/man/man8/inetd.8 index c78e2b0c4b..7b335894f0 100644 --- a/ja_JP.eucJP/man/man8/inetd.8 +++ b/ja_JP.eucJP/man/man8/inetd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)inetd.8 8.3 (Berkeley) 4/13/94 +.\" %Id: inetd.8,v 1.9.2.4 1997/11/04 21:49:01 dima Exp % .\" jpman %Id: inetd.8,v 1.2 1997/05/16 07:22:24 yugawa Stab % -.\" %Id: inetd.8,v 1.9.2.3 1997/09/22 06:23:24 charnier Exp % .\" .Dd February 7, 1996 .Dt INETD 8 @@ -100,7 +100,7 @@ サービス名 ソケットタイプ プロトコル -{wait/nowait}[/max-child] +{wait|nowait}[/max-child[/max-connections-per-ip-per-minute]] ユーザ名 サーバプログラム名 サーバプログラム引数 @@ -265,6 +265,10 @@ TCPMUX 一方、最大数に達すると、それ以降の接続要求は、存在する子プロセスが終了するまで 待ち行列に蓄えられます。これは、``wait'' モードでも同様ですが、通常は 1 (デフォルトの値)以外は意味がありません。 +指定した IP アドレスからの 1 分あたりの最大接続数を指定することも可能です。 +この場合、``/'' および最大子プロセス数を指定します。 +最大値に達っした場合、指定した IP アドレスからの接続は、 +この 1 分が経過するまで、落とされます。 .Pp .Em user エントリには、サーバを実行するユーザ名を書きます。 diff --git a/ja_JP.eucJP/man/man8/ipfw.8 b/ja_JP.eucJP/man/man8/ipfw.8 index d2379fd7a9..d8907cba31 100644 --- a/ja_JP.eucJP/man/man8/ipfw.8 +++ b/ja_JP.eucJP/man/man8/ipfw.8 @@ -27,11 +27,13 @@ delete .Nm ipfw .Op Fl aftN list +.Op Ar number ... .Nm ipfw .Oo .Fl ftN .Oc show +.Op Ar number ... .Nm ipfw .Oo .Fl q @@ -70,19 +72,21 @@ to .Pp delete 操作は .Ar number -で指定された番号を持つ最初のルールを、もし有れば、削除します +で指定された番号を持つ最初のルールを、もし有れば、削除します。 .Pp -list 操作は現在のルール一覧を出力します +list 操作は現在のルール一覧を出力します。 .Pp -show 操作は `ipfw -a list' と同じ結果を出力します +show 操作は `ipfw -a list' と同じ結果を出力します。 .Pp zero 操作は .Ar number -で指定された番号を持つルールのカウンタをクリアします +で指定された番号を持つルールのカウンタをクリアします。 .Pp -flush 操作は全ルールを削除します +flush 操作は全ルールを削除します。 .Pp -どんな場合でも次のルールは存在します +記号 `#' で始まる行および空行は無視されます。 +.Pp +どんな場合でも次のルールは存在します: .Bd -literal -offset center 65535 deny all from any to any .Ed @@ -162,7 +166,7 @@ ICMP .Ar precedence-cutoff 。送信後、終了します。 .It Ar reset - TCP パケットのみに対応。 +TCP パケットのみに対応。 パケットを破棄し、TCP の (RST) を送信し、終了します。 .It Ar count マッチするパケットのカウンタを更新し、引続きマッチングを行ないます。 @@ -268,6 +272,13 @@ port-port .Dv IP_FW_MAX_PORTS として定義されています。 .Pp +断片化されたパケットでオフセットが非 0 のもの +(すなわち、最初の断片ではないもの) は、 +一つ以上のポート仕様を持つルールにはマッチしません。？ +断片化されたパケットへのマッチングに関する詳細は +.Ar frag +オプションを参照してください。 +.Pp マッチングのルールは、入ってくるパケットか、出ていくパケット、もしくはその両方 に対し適応されます。 .Ar in @@ -289,7 +300,7 @@ port-port .Em いずれか のインタフェースを通過するパケットを指定します。 .It Ar via ipno - IP アドレスが +IP アドレスが .Ar ipno のインタフェースを通過するパケットを指定します。 .El @@ -338,6 +349,10 @@ port-port .It frag パケットが断片(フラグメント)化されたデータグラムの一部で、かつデータグラムの 先頭の断片でない場合にマッチします。 +.Ar frag +を、 +.Ar tcpflags +や TCP/UDP ポート仕様と共に使用することはできません。 .It in ネットワークから受信したパケットのみマッチします。 .It out @@ -346,7 +361,7 @@ port-port IP ヘッダが、 .Ar spec に指定されたコンマで区切られたオプションのリストを含む場合にのみマッチします。 - サポートされている IP オプションは +サポートされている IP オプションは .Ar ssrr (strict source route), .Ar lsrr @@ -366,7 +381,7 @@ SYN TCP ヘッダが .Ar spec に指定されたコンマで区切られたフラグのリストを含む場合にのみマッチします。 - サポートされているフラグは、 +サポートされているフラグは、 .Ar fin , .Ar syn , .Ar rst , @@ -375,6 +390,12 @@ TCP .Ar urg です。 ``!''によって、特定のフラグを含めないよう指定できます。 +.Ar tcpflags +仕様を含むルールは非 0 のオフセットを持つ断片化されたパケットに +マッチすることはありません。 +断片化されたパケットに関するマッチについての詳細は +.Ar frag +オプションを参照してください。 .It icmptypes Ar types ICMP タイプが .Ar types diff --git a/ja_JP.eucJP/man/man8/ldconfig.8 b/ja_JP.eucJP/man/man8/ldconfig.8 index d8ba383039..8f042d3e81 100644 --- a/ja_JP.eucJP/man/man8/ldconfig.8 +++ b/ja_JP.eucJP/man/man8/ldconfig.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: ldconfig.8,v 1.9.2.2 1997/08/08 02:18:07 jdp Exp % +.\" %Id: ldconfig.8,v 1.9.2.3 1997/12/25 07:57:42 jkh Exp % .\" jpman %Id: ldconfig.8,v 1.3 1997/07/22 16:49:42 horikawa Stab % .\" .Dd October 3, 1993 @@ -38,7 +38,7 @@ .Nd 共有ライブラリのキャッシュを設定する .Sh 書式 .Nm ldconfig -.Op Fl mrsv +.Op Fl Rmrsv .Op Fl f Ar hints_file .Op Ar directory | file Ar ... .Sh 解説 @@ -99,6 +99,11 @@ .Nm ldconfig で認識されます。 .Bl -tag -width indent +.It Fl R +以前に設定したディレクトリを再度検索します。 +以前作成したヒントファイルをオープンし、 +ヘッダからディレクトリリストを取り出します。 +コマンドラインに指定したパス名も処理します。 .It Fl f Ar hints_file .Pa /var/run/ld.so.hints の変わりに、 @@ -117,6 +122,7 @@ .It Fl r 現在のヒントファイルの中身について、標準出力に表示します。 ヒントファイルは変更されません。 +ヒントファイル中のディレクトリリストが組込まれます。 .It Fl s 共有ライブラリのために、システムの組み込みディレクトリ .Pq Dq /usr/lib diff --git a/ja_JP.eucJP/man/man8/mail.local.8 b/ja_JP.eucJP/man/man8/mail.local.8 index 89cdbe3b07..684a2a216b 100644 --- a/ja_JP.eucJP/man/man8/mail.local.8 +++ b/ja_JP.eucJP/man/man8/mail.local.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mail.local.8 8.2 (Berkeley) 12/11/93 -.\" %Id: mail.local.8,v 1.4 1996/09/22 21:54:05 wosch Exp % +.\" %Id: mail.local.8,v 1.4.2.1 1998/02/20 17:32:25 jkh Exp % .\" jpman %Id: mail.local.8,v 1.2 1997/03/31 13:35:26 horikawa Stab % .\" .Dd December 11, 1993 @@ -92,8 +92,8 @@ biff タイムスタンプを記録する際に適切なタイムゾーンを設定します。 .El .Sh 関連ファイル -.Bl -tag -width /tmp/local.XXXXXX -compact -.It Pa /tmp/local.XXXXXX +.Bl -tag -width /var/tmp/local.XXXXXX -compact +.It Pa /var/tmp/local.XXXXXX テンポラリファイル .It Pa /var/mail/user ユーザのメールボックスディレクトリ diff --git a/ja_JP.eucJP/man/man8/mailstats.8 b/ja_JP.eucJP/man/man8/mailstats.8 index d7faf5b509..92733aec08 100644 --- a/ja_JP.eucJP/man/man8/mailstats.8 +++ b/ja_JP.eucJP/man/man8/mailstats.8 @@ -29,7 +29,7 @@ .\" * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" * SUCH DAMAGE. .\" */ -.\" %Id: mailstats.8,v 1.2.2.3 1997/06/28 08:08:11 peter Exp % +.\" %Id: mailstats.8,v 1.2.2.4 1997/11/10 03:00:05 peter Exp % .\" jpman %Id: mailstats.8,v 1.2 1997/05/21 07:42:38 yugawa Stab % .Dd August 13, 1996 .Dt MAILSTATS 8 @@ -78,5 +78,5 @@ sendmail メール統計情報データベース .El .Sh 関連項目 -.Xr sendmail 8 , -.Xr mail.local 8 +.Xr mail.local 8 , +.Xr sendmail 8 diff --git a/ja_JP.eucJP/man/man8/makekey.8 b/ja_JP.eucJP/man/man8/makekey.8 index 79a6bd7625..bc4ac02327 100644 --- a/ja_JP.eucJP/man/man8/makekey.8 +++ b/ja_JP.eucJP/man/man8/makekey.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)makekey.8 8.2 (Berkeley) 12/11/93 -.\" %Id: makekey.8,v 1.5 1996/09/22 21:54:13 wosch Exp % +.\" %Id: makekey.8,v 1.5.2.1 1997/12/15 07:13:45 charnier Exp % .\" jpman %Id: makekey.8,v 1.2 1997/05/21 07:56:47 yugawa Stab % .\" .Dd December 11, 1993 @@ -43,9 +43,9 @@ .Nm makekey .Sh 解説 .Nm makekey -は標準入力から読み込んだキーと隠しキーを暗号化し、 +は標準入力から読み込んだキーと隠しキー (salt) を暗号化し、 結果を標準出力へ書き込みます。 -キーは10バイト、隠しキーは2バイトであること期待されます。 +キーは 8 バイト、隠しキーは 2 バイトであること期待されます。 キーと隠しキーはどんな文字を含んでよいか、 どうやって暗号化計算が行なわれるか、の詳しい情報は .Xr crypt 3 diff --git a/ja_JP.eucJP/man/man8/man8.i386/apm.8 b/ja_JP.eucJP/man/man8/man8.i386/apm.8 index 6a9dfebc69..c691043a89 100644 --- a/ja_JP.eucJP/man/man8/man8.i386/apm.8 +++ b/ja_JP.eucJP/man/man8/man8.i386/apm.8 @@ -17,11 +17,8 @@ .Nd APM BIOS の制御を行い、その情報を表示する .Sh 書式 .Nm apm -.Op Fl z -.Op Fl b -.Op Fl a -.Op Fl l -.Op Fl s +.Op Fl ablsz +.Op Fl d Ar 1|0 .Pp .Nm zzz .Sh 解説 @@ -41,11 +38,13 @@ .Nm apm は、現在の APM の状態や情報を冗長モードで表示します。 .Bl -tag -width indent -.It Fl z -システムをサスペンドします。これは、 -.Nm zzz -と等価です。 -.Pp +.It Fl a +現在の AC 電源の状態を整数値で表示します。 +0, 1がそれぞれ +.Dq 外れている (off-line) +状態と +.Dq つながっている (on-line) +状態をあらわします。 .It Fl b 整数値で、現在のバッテリ状態を表示します。 0, 1, 2, 3という値はそれぞれ、 @@ -57,20 +56,17 @@ 状態、 .Dq 充電 (charging) 状態をあらわします。 -.Pp -.It Fl a -現在の AC 電源の状態を整数値で表示します。 -0, 1がそれぞれ -.Dq 外れている (off-line) -状態と -.Dq つながっている (on-line) -状態をあらわします。 -.Pp +.It Fl d +通常のサスペンドとディスプレイのサスペンドを別に扱わない/別に扱うを、 +それぞれ +.Ar 1 +と +.Ar 0 +で制御します。 .It Fl l 現在のバッテリの残り割合を表示します。 もし、あなたのラップトップがこの機能を提供していない時には、 255 が表示されます。 -.Pp .It Fl s APM サポート状態を整数値で表示します。0, 1 という値はそれぞれ、 .Dq 利用不可 (disabled) @@ -78,6 +74,11 @@ APM .Dq 利用可能 (enabled) 状態 をあらわします。 +.It Fl z +システムをサスペンドします。これは、 +.Nm zzz +と等価です。 +.El .Sh バグ いくつかの APM 実装では、 .Nm apm diff --git a/ja_JP.eucJP/man/man8/mknetid.8 b/ja_JP.eucJP/man/man8/mknetid.8 index 9542a3d5bd..a71620b197 100644 --- a/ja_JP.eucJP/man/man8/mknetid.8 +++ b/ja_JP.eucJP/man/man8/mknetid.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: mknetid.8,v 1.1.1.1 1996/06/25 20:26:38 wpaul Exp % +.\" %Id: mknetid.8,v 1.1.1.1.2.1 1997/12/15 07:16:14 charnier Exp % .\" jpman %Id: mknetid.8,v 1.3 1997/08/16 13:26:57 horikawa Stab % .\" .Dd June 23, 1996 @@ -52,62 +52,69 @@ .Xr passwd 5 , .Xr hosts 5 , .Xr netid 5 -の内容を処理し、NIS マップ +の内容を処理し、 +.Tn NIS +マップ .Pa netid.byname を生成するのに用いる形式に変換します。 このマップは、OS に依存しない形式でユーザとホスト双方の信用情報を 保持するために用いられます。 .Pp -.Nm mknetid +.Nm コマンドは重複した netid の出現をチェックし、それらを除去します。 .Pp -.Nm mknetid +.Nm コマンドは結果を標準出力に出力します。 -通常は NIS マップを再構築する際に +通常は +.Tn NIS +マップを再構築する際に .Nm /var/yp/Makefile からのみ呼び出されます。 .Pp .Sh オプション -.Nm mknetid +.Nm コマンドには以下のオプションがあります: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl q 通常、 -.Nm mknetid +.Nm は重複した netid を見つけると警告メッセージを表示しますが、 このオプションにより「静粛」モードとなり、警告は抑制されます。 他のエラーメッセージはそのまま表示されます。 -.It Fl g Ar group-file +.It Fl g Ar group_file .Fl g オプションはグループ情報ファイルの場所を指定するのに用いられます。 コンパイル済みのデフォルト値は .Pa /etc/group です。 -.It Fl p Ar passwd-file -.Fl p -オプションはパスワード情報ファイルの場所を指定するのに用いられます。 +.It Fl p Ar passwd_file +パスワード情報ファイルの場所を指定します。 コンパイル済みのデフォルト値は .Pa /etc/passwd です。 -.It Fl h Ar hosts-file +.It Fl h Ar hosts_file .\" ↑原文では .It Fl h Ar group-file となっているが、おそらく .\" cut&paste ミスと思われる。 sakai@jp.freebsd.org (Jun 12, 1997) +.\" 2.2-currentでも .It Fl h Ar group_fileとなっている． +.\" mutoh@info.nara-k.ac.jp (Jan 26,1998) .Fl h オプションはホストデータベースファイルの場所を指定するのに用いられます。 コンパイル済みのデフォルト値は .Pa /etc/hosts です。 -.It Fl n Ar netid-file -.Fl n -オプションは netid 情報ファイルの場所を指定するのに用いられます。 +.It Fl n Ar netid_file +netid 情報ファイルの場所を指定します。 コンパイル済みのデフォルト値は .Pa /etc/netid です。 注: netid データベースが見つからなくてもエラーにはなりません。 -FreeBSD で Secure RPC がサポートされるようになるまでは、 +.Bx Free +で +.Tn Secure RPC +がサポートされるようになるまでは、 ほとんどのシステムでは netid データベースは存在しないことでしょう。 .It Fl d Ar domain -.Nm mknetid +.Nm コマンドが netid レコードを生成する際、デフォルトでは、 システムのドメイン名を用います。 もしシステムのドメイン名が設定されていないなら、 @@ -118,9 +125,10 @@ FreeBSD オプションによってその設定値を上書きすることもできます。 .El .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -NIS データベースを構築するために +.Tn NIS +データベースを構築するために .Nm yp_mkdb および .Nm mknetid @@ -138,4 +146,4 @@ NIS .Xr yp 4 , .Xr yp_mkdb 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/mount.8 b/ja_JP.eucJP/man/man8/mount.8 index 77513e74cc..5cdb0e0ab4 100644 --- a/ja_JP.eucJP/man/man8/mount.8 +++ b/ja_JP.eucJP/man/man8/mount.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)mount.8 8.7 (Berkeley) 3/27/94 -.\" %Id: mount.8,v 1.11.2.2 1997/08/24 17:52:01 joerg Exp % +.\" %Id: mount.8,v 1.11.2.3 1997/12/01 00:47:09 steve Exp % .\" jpman %Id: mount.8,v 1.2 1997/05/03 11:26:50 horikawa Stab % .\" .Dd March 27, 1994 @@ -316,6 +316,7 @@ type .Xr vfsload 3 , .Xr fstab 5 , .Xr mount_cd9660 8 , +.Xr mount_devfs 8 , .Xr mount_fdesc 8 , .Xr mount_kernfs 8 , .Xr mount_lfs 8 , diff --git a/ja_JP.eucJP/man/man8/mount_cd9660.8 b/ja_JP.eucJP/man/man8/mount_cd9660.8 index 2d48b125bf..bfce7a5503 100644 --- a/ja_JP.eucJP/man/man8/mount_cd9660.8 +++ b/ja_JP.eucJP/man/man8/mount_cd9660.8 @@ -45,7 +45,7 @@ .Nm mount_cd9660 .Op Fl egrv .Op Fl o Ar options -.Op Fl s startsector +.Op Fl s Ar startsector .Ar special | node .Sh 解説 .Nm mount_cd9660 diff --git a/ja_JP.eucJP/man/man8/mount_nfs.8 b/ja_JP.eucJP/man/man8/mount_nfs.8 index 49b1cb72b3..6b55d13585 100644 --- a/ja_JP.eucJP/man/man8/mount_nfs.8 +++ b/ja_JP.eucJP/man/man8/mount_nfs.8 @@ -73,7 +73,7 @@ Appendix I. オプションを以下に示します: .Bl -tag -width indent .It Fl 2 -NFS バージョン 3 プロトコルを使用します +NFS バージョン 2 プロトコルを使用します (デフォルトはバージョン 3 をまず試した後にバージョン 2 を用います)。 .It Fl 3 NFS バージョン 3 プロトコルを使用します。 diff --git a/ja_JP.eucJP/man/man8/moused.8 b/ja_JP.eucJP/man/man8/moused.8 index 8f62043067..52a98305de 100644 --- a/ja_JP.eucJP/man/man8/moused.8 +++ b/ja_JP.eucJP/man/man8/moused.8 @@ -28,10 +28,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: moused.8,v 1.1.2.2 1997/09/29 06:36:12 charnier Exp % +.\" %Id: moused.8,v 1.1.2.4 1998/01/25 15:49:50 yokota Exp % .\" .\" jpman %Id: moused.8,v 1.3 1997/07/22 16:52:17 horikawa Stab % -.Dd December 16, 1996 +.Dd December 3, 1997 .Dt MOUSED 8 .Os FreeBSD .Sh 名称 @@ -39,72 +39,499 @@ .Nd マウスデータをコンソールドライバに渡す .Sh 書式 .Nm -.Op Fl DRcdfs +.Op Fl 3DPRcdfs +.Op Fl F Ar rate +.Op Fl r Ar resolution .Op Fl S Ar baudrate +.Op Fl C Ar threshold +.Op Fl m Ar N=M +.Op Fl z Ar target +.Op Fl t Ar mousetype .Fl p Ar port -.Fl t Ar mousetype -.Sh 解説 -マウスデーモンは、シリアルポートからマウスデータを受け取り、 -データを解釈し、コンソールドライバに ioctl で渡します。 .Pp -以下のオプションがあります。 +.Nm +.Op Fl Pd +.Fl p Ar port +.Fl i Ar info +.Sh 解説 +マウスデーモン +.Nm +とコンソールドライバは協力し、 +テキストコンソールやユーザプログラムにおけるマウス操作をサポートします。 +マウスの仮想化とユーザプログラムへのマウスデータの提供は標準フォーマット +にて行われます +.Pq Xr sysmouse 4 を御覧ください +。 +.Pp +マウスデーモンはマウスデータの読みとりのために指定されたポートを監視し、 +解釈したデータを ioctl を介してコンソールドライバに渡します。 +マウスデーモンは、移動、ボタンの押し/離しイベント、 +存在するならばローラやホイールの移動も報告します。 +ローラ/ホイールの移動は ``Z'' 軸での移動として報告されます。 +.Pp +マウスポインタが +.Xr vidcontrol 4 +によって有効にされていれば、 +コンソールドライバはマウスポインタをスクリーンに表示し、 +カットとペーストの機能を提供します。 +.Xr sysmouse 4 +をユーザプログラムがオープンすると、コンソールドライバは +マウスデータをこのデバイスに送るので、 +ユーザプログラムはこのデータを使用できます。 +.Pp +マウスデーモンがシグナル +.Dv SIGHUP +を受けとると、マウスポートを再オープンし、自己を再初期化します。 +システムがサスペンドされている間にマウスの挿抜を行なった場合に有用です。 +.Pp +以下のオプションがあります: .Bl -tag -width indent +.It Fl 3 +2 ボタンマウスで 3 番目(中)のボタンをエミュレートします。 +物理的なボタンで左と右のものを同時に押すとエミュレートされます。 +.It Fl C Ar threshold +ダブルクリック速度をボタンクリック間最大インターバルとしてミリ秒で指定します。 +このオプションを指定しないと、デフォルト値は 500 ミリ秒が仮定されます。 +このオプションは、 +テキストモードコンソールのカットとペーストの操作においてのみ有効です。 +.Xr sysmouse 4 +を介してマウスデータを得るユーザプログラムは影響を受けません。 .It Fl D シリアルポートの DTR を下げます。 +このオプションが有効なのは、 +.Ar mousesystems +がマウスプロトコルとして選択されている場合のみです。 +.Ar mousesystems +モードで 3 ボタンマウスを操作するためには、 +DTR ラインを落とすことが必要かもしれません。 +.It Fl F Ar rate +サポートされていれば、デバイスのレポート頻度(秒あたりの回数)を設定します。 +.It Fl P +シリアルマウス識別時に、 +プラグアンドプレイ COM デバイス列挙処理を開始しません。 +.Fl i +オプションと共にこのオプションが指定された場合、 +.Nm +はシリアルマウスに関する有用な情報を表示できません。 .It Fl R シリアルポートの RTS を下げます。 +このオプションが有効なのは +.Ar mousesystems +がプロトコルタイプとして、後述する +.Fl t +オプションで指定されている場合のみです。 +これは前記 +.Fl D +オプションと共によく使用されます。 +.Ar mousesystems +モードで 3 ボタンマウスを操作するためには、 +RTS と DTR のラインを共に下げる必要があるかもしれません。 .It Fl S Ar baudrate -シリアルポートの速度を指定します (1200 ボーから 9600 ボー -が指定できます ) 。 +シリアルポートの速度を指定します (1200 から 9600)。 +全シリアルマウスがこのオプションをサポートするわけではありません。 .It Fl c -ChordMiddle オプションを有効にします。 +マウスによっては、中ボタンを押したイベントを、 +左右ボタンが押されたかのようにレポートするものがあります。 +このオプションはこれを扱うものです。 .It Fl d デバッグ用のメッセージを有効にします。 .It Fl f デーモンにならずに、フォアグラウンドプロセスとして実行します。 +テストやデバッグに有用です。 +.It Fl i Ar info +指定された情報を表示し終了します。指定可能な情報を以下に示します: +.Pp +.Bl -tag -compact -width modelxxx +.It Ar port +ポート(デバイスファイル)名、例えば +.Pa /dev/cuaa0 , +.Pa /dev/mse0 , +.Pa /dev/psm0 +です。 +.It Ar if +インタフェースタイプ: serial, bus, inport, ps/2 です。 +.It Ar type +プロトコルタイプ。 +.Fl t +オプションの説明の後でリストされているものか、 +ドライバが +.Ar sysmouse +データフォーマット標準をサポートする場合には +.Ar sysmouse +です。 +.It Ar model +マウスモデル。 +.Nm +コマンドは常にモデルを識別できるわけではありません。 +.It Ar all +上記全部。ポート、インタフェース、タイプ、モデルをこの順に一行に表示します。 +.El +.Pp +.Nm +は要求された情報を判別できない場合、``unknown'' か ``generic'' を表示します。 +.It Fl m Ar N=M +物理ボタン +.Ar M +に論理ボタン +.Ar N +を割当てます。 +このオプションは任意個数指定可能です。 +複数の物理ボタンを単一の論理ボタンに割り当て可能です。 +この場合、指定された物理ボタンのいずれかが押されている場合、 +論理ボタンが押されていることになります。`=' の周りにスペースを入れてはなりません。 .It Fl p Ar port -マウスと通信するためのシリアルポートとして +マウスと通信するためのポートとして .Ar port を使います。 +.It Fl r Ar resolution +デバイスの解像度を設定します; +インチあたりのドット数または、 +.Ar low , +.Ar medium-low , +.Ar medium-high , +.Ar high +のいずれかです。 +全デバイスにてこのオプションがサポートされているわけではありません。 .It Fl s シリアルラインのために 9600 ボーを選びます。 -.It Fl t Ar mousetype -シリアルポートにつながっているマウスの形式を指定します。 -有効なマウスの形式は、以下のものです。 +全シリアルマウスがこのオプションをサポートしているわけではありません。 +.It Fl t Ar type +ポートに接続されているマウスのプロトコルタイプを指定します。 +以下に列挙されるタイプを陽に指定するか、 +.Ar auto +を指定して +.Nm +コマンドに適切なプロトコルを自動選択させることができます。 +コマンドラインにてこのオプションを指定しないと、 +.Fl t Ar auto +が仮定されます。 +通常では、 +.Nm +コマンドがプロトコルの自動検出ができない場合に必要です +.Po Sx マウスデーモンの構成 +を参照 +.Pc +。 .Pp +また、 +このオプションでプロトコルタイプを指定した場合、 +前記 +.Fl P +オプションが暗示され、プラグアンドプレイ COM デバイス列挙処理が無効になります。 +.Pp +このオプションにおける有効なタイプを以下に列挙します。 +.Pp +シリアルマウス: .Bl -tag -compact -width mousesystemsxxx -.It microsoft -マイクロソフトマウス -.It mousesystems -マウスシステムマウス -.It mmseries -MM Series マウス -.It logitech -ロジテックマウス -.It busmouse -バスマウス -.It mouseman -Logitech MouseMan と TrackMan -.It ps/2 -PS/2 マウス -.It mmhittab -MM HitTablet +.It Ar microsoft +Microsoft シリアルマウスプロトコル。 +大抵の 2 ボタンマウスはこのプロトコルを使用します。 +.It Ar intellimouse +Microsoft IntelliMouse プロトコル。 +Genius NetMouse, ASCII Mie Mouse, Logitech MouseMan+, FirstMouse+ +もこのプロトコルを使用します。 +他のローラ/ホイールを持つマウスもこのプロトコル互換でしょう。 +.It Ar mousesystems +MouseSystems の 5 バイトプロトコル。 +3 ボタンマウスはこのプロトコルを使用するかもしれません。 +.It Ar mmseries +MM Series マウスプロトコル。 +.It Ar logitech +Logitech マウスプロトコル。 +これは古い Logitech モデルであることに注意。 +新しいモデルには +.Ar mouseman +もしくは +.Ar intellimouse +を指定します。 +.It Ar mouseman +Logitech MouseMan と TrackMan のプロトコル。 +3 ボタンマウスによってはこのプロトコル互換かもしれません。 +MouseMan+ と FirstMouse+ は、このプロトコルではなく、 +.Ar intellimouse +プロトコルを使用します +.It Ar glidepoint +ALPS GlidePoint プロトコル。 +.It Ar thinkingmouse +Kensington ThinkingMouse プロトコル。 +.It Ar mmhittab +Hitachi タブレットプロトコル。 .El +.Pp +バスおよび InPort マウス: +.Bl -tag -compact -width mousesystemsxxx +.It Ar busmouse +バスおよび InPort マウスはこのプロトコルのみ使用可能であり、 +バスおよび InPort マウスはブランドに依らずこのオプションを +指定する必要があります。 +.El +.Pp +PS/2 マウス: +.Bl -tag -compact -width mousesystemsxxx +.It Ar ps/2 +PS/2 マウスはこのプロトコルのみ使用可能であり、 +PS/2 マウスはブランドに依らずこのオプションを +指定する必要があります。 +.El +.It Fl z Ar target +Z 軸(ローラ/ホイール)動作を別の軸や仮想ボタンに割り付けます。 +有効な +.Ar target +は以下のいずれかです: +.Bl -tag -compact -width x__ +.It Ar x +.It Ar y +X または Y 軸の移動として、検知した Z 軸移動を報告します。 +.It Ar N +仮想ボタン +.Ar N +および +.Ar N+1 +を押したイベントとして、検知した負/正の Z 軸移動をそれぞれ報告します。 +物理ボタン +.Ar N +と +.Ar N+1 +が存在する必要はありません。 +論理ボタンへの割り付けは Z 軸移動を仮想ボタンへ割り付けた後に行われます。 +.El +.El +.Ss マウスデーモンの構成 +まず、使用予定マウスのインタフェースタイプを知ることが必要です。 +これはマウスのコネクタを見れば分かります。 +シリアルアウスは D-Sub の 9 ピンまたは 25 ピンのメスです。 +バスおよび InPort のマウスは D-Sub 9 ピンのオスか丸い DIN 9 ピンコネクタです。 +PS/2 マウスは小さくて丸い DIN 6 ピンコネクタです。 +マウスによってはコネクタを別の形状に変換可能なコネクタが附属しています。 +このようなアダプタを使用する場合には、 +マウスから一番遠いコネクタの形状を見てください。 +.Pp +次に決めねばならないことは、インタフェースのために使用するポートです。 +バス、InPort、PS/2 マウスでは、選択肢はありません: +バスおよび InPort マウスは常に +.Pa /dev/mse0 +を使用し、 +PS/2 マウスは常に +.Pa /dev/psm0 +を使用します。 +シリアルマウスの場合、接続可能なポートが複数ありえます。 +多くの人が組み込みのシリアルポート +.Pa /dev/cuaa0 +をマウスに割当てます。 +シンボリックリンク +.Pa /dev/mouse +でマウスの実際のポートを指すようにして、 +どのマウスポートか後で簡単に分かるようにするのが良いかもしれません。 +.Pp +次に適切なマウスプロトコルを選択します。 +.Nm +コマンドはマウスタイプを自動決定可能かもしれません。 +.Nm +コマンドを +.Fl i +オプションを付けて実行し、表示を見ます。 +コマンドがプロトコルタイプを識別した場合、あなたは何も調べる必要はありません。 +プロトコルタイプを指定せずにデーモンを起動可能です +.Po Sx 使用例 +を参照 +.Pc +。 +.Pp +コマンドは、マウスドライバが +.Ar sysmouse +プロトコルをサポートする場合、 +.Ar sysmouse +と表示するかもしれません。 +.Pp +表示される +.Dv type +と +.Dv model +は、対象のポインティングデバイスの製品名では必ずしもありませんが、 +互換性のあるデバイスの名前でしょう。 +.Pp +.Fl i +オプションがなにも表示しない場合、 +.Nm +に対して +.Fl t +オプションを使用し、プロトコルタイプを指定する必要があります。 +予測して試行する必要があります。 +以下に経験則を示します: +.Pp +.Bl -tag -compact -width 1.X +.It 1. +バスおよび InPort マウスはブランドに依らず +.Ar busmouse +プロトコルを使用します +.It 2. +PS/2 マウスはブランドに依らず +.Ar ps/2 +プロトコルを使用します +.It 3. +ほとんどの 2 ボタンシリアルマウスは +.Ar microsoft +プロトコルをサポートします。 +.It 4. +3 ボタンシリアルマウスは +.Ar mousesystems +プロトコルで動作するかもしれません。動作しない場合には、 +三番目(中)ボタンが機能せずに +.Ar microsoft +プロトコルで動作するでしょう。 +3 ボタンシリアルマウスは、期待通り三番目のボタンが動作しつつ +.Ar mouseman +プロトコルで動作するかもしれません。 +.It 5. +3 ボタンマウスには小さなスイッチが付いていて、 +``MS'' と ``PC'' または ``2'' と ``3'' とで選択できるできるようになっている +かもしれません。 +``MS'' と ``2'' は通常 +.Ar microsoft +プロトコルを意味します。 +``PC'' と ``3'' は +.Ar mousesystems +プロトコルを選択します。 +.It 6. +マウスにローラやホイールが付いている場合、 +.Ar intellimouse +プロトコル互換でしょう。 +.El +.Pp +マウスのために選択したプロトコルタイプが正しいかどうかテストする目的で、 +現在の仮想コンソールでマウスポインタを有効にします。 +.Pp +.Dl vidcontrol -m on +.Pp +マウスデーモンをフォアグラウンドで開始します。 +.Pp +.Dl moused -f -p Ar _selected_port_ -t Ar _selected_protocol_ +.Pp +マウスポインタがマウスの移動に伴い、 +正しく移動することを確認してください。 +そして、カットとペーストの機能を左、右、中のボタンを使用して確認してください。 +^C をタイプすると、コマンドは停止します。 +.Ss 複数のマウス +システムに接続したマウスと同じ数だけ、マウスデーモンを同時実行可能です; +一つのマウスデーモンが一つのマウスに対応します。 +ラップトップコンピュータ組み込みの PS/2 ポインティングデバイスを移動中使用し、 +オフィスではドッキングステーション接続のシリアルマウスを使用する +場合に有用です。 +マウスデーモンを二つ実行し、アプリケーションプログラム +.Pq 例えば X Window System +に +.Xr sysmouse +を使用させます。 +するとアプリケーションプログラムは常に両マウスからマウスデータを受け取ります。 +シリアルマウスが取り付けられていない場合、 +対応するマウスデーモンは移動やボタン状態の変化を検出しませんので、 +アプリケーションプログラムは PS/2 マウスのデーモンからのマウスデータ +のみを使います。 +一方この構成で両方のマウスを接続し同時に両方を動かした場合、 +マウスの移動をすべて組合せたようにマウスポインタがスクリーン上を移動します。 +.Sh 関連ファイル +.Bl -tag -width /dev/consolectl -compact +.It Pa /dev/consolectl +コンソール制御デバイス +.It Pa /dev/mse%d +バスおよび InPort マウスのドライバ +.It Pa /dev/psm%d +PS/2 マウスドライバ +.It Pa /dev/sysmouse +仮想化されたマウスドライバ +.It Pa /dev/ttyv%d +仮想コンソール .El .Sh 使用例 .Pp -.Dl moused -t microsoft -p /dev/mouse +.Dl moused -p /dev/cuaa0 -i type +.Pp +.Nm +コマンドにシリアルポート +.Pa /dev/cuaa0 +に接続されたマウスのプロトコルタイプを識別させます。 +成功すると、コマンドはタイプを表示しますが、 +失敗すると ``unknown'' が表示されます。 +.Pp +.Dl moused -p /dev/cuaa0 .Dl vidcontrol -m on .Pp -マウスデーモンを、シリアルデバイス +.Nm +が指定されたポートのマウスプロトコルタイプを識別可能な場合、 +.Fl t +オプション無してデーモンを起動可能であり、 +前記のようにマウスポインタをテキストコンソール上で有効にできます。 +.Pp +.Dl moused -p /dev/mouse -t microsoft +.Dl vidcontrol -m on +.Pp +シリアルポート .Pa /dev/mouse -に対し、マイクロソフトマウス、マウスポインタ有効の条件で開始します。 +に対してマウスデーモンを起動します。 +プロトコルタイプは +.Ar microsoft +を +.Fl t +オプションにて陽に指定しています。 +.Pp +.Dl moused -p /dev/mouse -m 1=3 -m 3=1 +.Pp +物理ボタン 3 (右ボタン) を論理ボタン 1 (論理的に左) に、 +物理ボタン 1 (左ボタン) を論理ボタン 3 (論理的に右) に、 +それぞれ割当てます。 +左右のボタンを事実上交換します。 +.Pp +.Dl moused -p /dev/mouse -t intellimouse -z 4 +.Pp +Z 軸(ローラ)における負の移動をボタン 4 が押されたものとし、 +Z 軸における正の移動をボタン 5 が押されたものとします。 +.Sh 警告 +.Nm +コマンドは現在別のコンソールドライバ +.Xr pcvt 4 +では動作しません。 +.Pp +バッドデバイスの多くは、 +ユーザがパッド表面を ``タップ'' した場合に最初の(左) ボタンが +押されたものとします。 +また、ALPS GlidePoint モデルによっては、 +タップ動作を 4 番目のボタンのイベントとして扱います。 +このようなモデルでは、オプション ``-m 1=4'' を使用して、 +他のパッドデバイスと同様の効果を得られます。 +.Pp +仮想コンソールでのカットとペーストの機能は、 +マウスに 3 ボタンあることを仮定しています。 +論理ボタン 1 (論理的に左) は、 +コンソールのテキスト領域を選択してカットバッファにコピーします。 +論理ボタン 3 (論理的に右) は、 +選択された領域を拡張します。 +論理ボタン 2 (論理的に中) は、 +選択されたテキストをテキストカーソル位置にペーストします。 +マウスに 2 つしかボタンが無い場合、中央の `ペースト' ボタン +は使用できません。 +ペースト機能を使用するためには、 +.Fl 3 +オプションを使用して中ボタンをエミュレートするか、 +.Fl m +オプションを ``-m 2=3'' のように使用して +物理右ボタンに論理中ボタンを割当てます。 .Sh 関連項目 +.Xr kill 1 , .Xr vidcontrol 1 , .Xr keyboard 4 , +.Xr mse 4 , .Xr pcvt 4 , +.Xr psm 4 , .Xr screen 4 , .Xr sysmouse 4 +.Sh 規格 +.Nm +コマンドは ``Plag and Play External COM Device Specification'' の一部を +サポートし、PnP シリアルマウスをサポートします。 +しかしながら、シリアルマウスごとに仕様充足の度合が異なりますので、 +標準のバージョン 1.0 に完全に従ってはいません。 +このように厳密さを欠いた方法でも、シリアルマウスの適切なプロトコルタイプ +を常に決定できるわけではありません。 .Sh 作者 .Nm コマンドは、 @@ -113,6 +540,9 @@ MM HitTablet このマニュアルは、 .An Mike Pritchard .Aq mpp@FreeBSD.org によって書かれました。 +コマンドとマニュアルページを、 +.An Kazutaka YOKOTA Aq yokota@FreeBSD.org +が更新しました。 .Sh 歴史 .Nm コマンドは、 diff --git a/ja_JP.eucJP/man/man8/natd.8 b/ja_JP.eucJP/man/man8/natd.8 index ed10998370..59322d9e9c 100644 --- a/ja_JP.eucJP/man/man8/natd.8 +++ b/ja_JP.eucJP/man/man8/natd.8 @@ -235,7 +235,26 @@ alias オプションか .Fl interface オプションが指定されなければなりません。 - +指定されたアドレスは、 +公開されたネットワークインタフェースに割当てられたアドレスである +必要があります。 +.Pp +このアドレスのインタフェースを通って出る全データのソースアドレスは +.Ar address +に書換えられます。 +外部からこのインタフェースに到着する全データは、 +既に alias された外向け接続にマッチするかどうかチェックされます。 +マッチする場合、パケットはそれぞれ変換されます。 +マッチしない場合、 +.Fl redirect_port +と +.Fl redirect_address +の割り当てをチェックしそれぞれの動作を行います。 +他の動作が行えない場合かつ +.Fl deny_incoming +が指定されていない場合、 +パケットに指定された通りに +パケットはローカルのマシンのポートに配送されます。 .It Fl n | interface Ar interface alias アドレスを決めるのに、 .Ar interface @@ -244,6 +263,10 @@ alias に関連づけられた IP アドレスが変化する可能性がある場合には、 .Fl dynamic フラグも指定されるべきです。 +.Pp +指定された +.Ar interface +は公開されたネットワークインタフェースである必要があります。 .It Fl f | config Ar configfile .Ar configfile @@ -387,8 +410,8 @@ alias .El .Sh 関連項目 -.Xr socket 2 , .Xr getservbyname 2 , +.Xr socket 2 , .Xr divert 4 , .Xr services 5 , .Xr ipfw 8 diff --git a/ja_JP.eucJP/man/man8/newfs.8 b/ja_JP.eucJP/man/man8/newfs.8 index 3f05b73902..e41d7d8530 100644 --- a/ja_JP.eucJP/man/man8/newfs.8 +++ b/ja_JP.eucJP/man/man8/newfs.8 @@ -29,10 +29,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)newfs.8 8.3 (Berkeley) 3/27/94 +.\" @(#)newfs.8 8.6 (Berkeley) 5/3/95 .\" jpman %Id: newfs.8,v 1.3 1997/07/26 22:02:06 horikawa Stab % .\" -.Dd March 27, 1994 +.Dd May 3, 1995 .Dt NEWFS 8 .Os BSD 4.2 .Sh 名称 @@ -43,6 +43,7 @@ .Nm newfs .Op Fl NO .Op Fl S Ar sector-size +.Op Fl T Ar disktype .Op Fl a Ar maxcontig .Op Fl b Ar block-size .Op Fl c Ar cylinders @@ -53,6 +54,7 @@ .Op Fl k Ar skew .Op Fl l Ar interleave .Op Fl m Ar free space +.Op Fl n Ar rotational positions .Op Fl o Ar optimization .Op Fl p Ar sectors .Op Fl r Ar revolutions @@ -73,6 +75,7 @@ .Op Fl f Ar frag-size .Op Fl i Ar bytes .Op Fl m Ar free space +.Op Fl n Ar rotational positions .Op Fl o Ar options .Op Fl s Ar size .Ar special node @@ -107,7 +110,9 @@ に指定するパラメータは .Nm newfs のものと同じです。 -スペシャルファイルはディスクラベルを読むためにのみ使われ、 +.Fl T +フラグが指定されると(下記参照)、スペシャルファイルを使用しません。 +そうでない場合、スペシャルファイルはディスクラベルを読むためにのみ使われ、 それによってメモリベースファイルシステムへのコンフィギュレーション パラメータが得られます。 このスペシャルファイルは通常、第一スワップ領域を指定します。という @@ -133,6 +138,10 @@ 4.3BSD フォーマットのファイルシステムを作成します。この オプションは、古いブート ROM が理解できるルートファイル システムを使う必要がある場合に使います。 +.It Fl T +指定したディスクのための情報を +.Pa /etc/disktab +から得て、disklabel を使用しません。 .It Fl a Ar maxconting 回転遅延 (rotational delay) を強制する前に 配置される連続ブロックの最大数を指定します ( @@ -153,6 +162,7 @@ 期待値を指定します (ミリ秒単位)。デフォルトは0ミリ秒です。詳細は、 .Xr tunefs 8 を参照してください。 +.ne 1i .It Fl e Ar maxbpg 単一のファイルが他のシリンダグループへまたがることを強制される前に、 1 つのシリンダグループから割り当てることのできる最大のブロック数を指定し @@ -230,6 +240,7 @@ i に含まれません。 .It Fl r Ar revolutions/minute 1 分間あたりのディスク回転速度を指定します。 +.ne 1i .It Fl t Ar #tracks/cylinder ファイルシステムによってデータを割り当てることができるシリンダあたりの トラック数です。デフォルトは 1 です。0 が設定された場合にはディスクラベル @@ -268,11 +279,11 @@ i .El .Sh 使用例 .Pp -.Dl mount_mfs -s=20480 -o nosuid,nodev /dev/sd0b /tmp +.Dl mount_mfs -s=131072 -o nosuid,nodev /dev/sd0b /tmp .Pp .Xr mount 8 の nosuid と nodev のオプションを指定し、 -10240 KB の大きさのメモリファイルシステムを /tmp にマウントします。 +64 MB の大きさのメモリファイルシステムを /tmp にマウントします。 .Sh 関連項目 .Xr fdformat 1 , .Xr disktab 5 , diff --git a/ja_JP.eucJP/man/man8/pccardd.8 b/ja_JP.eucJP/man/man8/pccardd.8 index 344191dfea..c017c010bc 100644 --- a/ja_JP.eucJP/man/man8/pccardd.8 +++ b/ja_JP.eucJP/man/man8/pccardd.8 @@ -23,7 +23,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: pccardd.8,v 1.4.2.2 1997/10/08 07:33:51 charnier Exp % +.\" %Id: pccardd.8,v 1.4.2.3 1997/12/25 09:35:59 hoek Exp % .\" jpman %Id: pccardd.8,v 1.4 1997/07/26 22:04:06 horikawa Stab % .\" .Dd November 1, 1994 diff --git a/ja_JP.eucJP/man/man8/pnpinfo.8 b/ja_JP.eucJP/man/man8/pnpinfo.8 new file mode 100644 index 0000000000..fcea6dca01 --- /dev/null +++ b/ja_JP.eucJP/man/man8/pnpinfo.8 @@ -0,0 +1,59 @@ +.\" Copyright (c) 1996, Sujal M. Patel +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Sujal M. Patel +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: pnpinfo.8,v 1.1.1.1 1997/09/19 15:36:00 jmg Exp % +.\" +.Dd January 7, 1996 +.Dt PNPINFO 8 +.Os +.Sh 名称 +.Nm pnpinfo +.Nd "Plug-n-Play ISA デバイスに関する情報の報告" +.Sh 書式 +.Nm pnpinfo +.Sh 解説 +.Nm +は Plug-n-Play ISA デバイスに関する情報を報告します。 +ベンダ ID、シリアル番号、I/O ポート、IRQ といった情報は、 +ISA PnP デバイス付きでカーネルを構築するときに有用です。 +.Sh バグ +数個のタグが未実装です (99% の PnP カードには十分です)。 +.Sh 関連項目 +.Xr pnp 4 +.Sh 歴史 +.Nm +ユーティリティは +.Tn FreeBSD +2.2 +にて初めて登場しました。 +.Sh 作者 +.Bl -tag +Sujal M. Patel, smpatel@umiacs.umd.edu +.El diff --git a/ja_JP.eucJP/man/man8/ppp.8 b/ja_JP.eucJP/man/man8/ppp.8 index 1824a47d12..3832e1216d 100644 --- a/ja_JP.eucJP/man/man8/ppp.8 +++ b/ja_JP.eucJP/man/man8/ppp.8 @@ -1,15 +1,21 @@ -.\" %Id: ppp.8,v 1.19.2.32 1997/10/05 14:28:27 brian Exp % +." $Id: ppp.8,v 1.2 1998-02-27 01:27:29 hanai Exp $ .\" jpman %Id: ppp.8,v 1.4 1997/06/08 18:41:58 saeki Stab % .Dd 20 September 1995 .Os FreeBSD .Dt PPP 8 .Sh 名称 .Nm ppp -.Nd -PPP (Point to Point Protocol) (別名 iijppp) +.Nd PPP (Point to Point Protocol) (別名 iijppp) .Sh 書式 .Nm -.Op Fl auto | background | ddial | direct | dedicated +.\" SOMEONE FIX ME ! The .Op macro can't handle enough args ! +[ +.Fl auto | +.Fl background | +.Fl ddial | +.Fl direct | +.Fl dedicated +] .Op Fl alias .Op Ar system .Sh 解説 @@ -17,22 +23,22 @@ PPP (Point to Point Protocol) ( .Em PPP パッケージです。 .Em PPP -は通常、(pppd でそうなっているように) カーネルの一部として実装されますが、 +は通常、( +.Xr pppd 8 +でそうなっているように) カーネルの一部として実装されますが、 そのため、デバッグや動作の変更が少々難しい場合があります。 しかしながら、この実装ではトンネルデバイス (tun) を利用して、ユーザプロセスで .Em PPP を実現しています。 - .Sh 主な特徴 - .Bl -diag -.It 対話的なユーザインターフェースを提供 +.It 対話的なユーザインタフェースを提供 コマンドモードで利用する場合、ユーザがコマンドを -入力することで、簡単にリモートコンピュータとの接続の確立や接続状態の確認、 -接続の解放を行なうことができます。 +入力することで、簡単にリモートコンピュータとの接続の確立、 +接続状態の確認、 +接続の解放を行うことができます。 オプションとして、セキュリティ確保のために すべての機能をパスワードで保護することができます。 - .It 手動と自動でのダイアルをサポート 対話モードでは、直接モデムと通信できるように .Dq term @@ -40,56 +46,71 @@ PPP (Point to Point Protocol) ( モデムがリモートホストと接続されて、 .Em PPP での通信が始まったら、 -.Em PPP +.Nm はそれを検出して自動的にパケットモードに移行します。 ひとたびリモートホストとの接続に必要なコマンドシーケンスがわかったら、 後々の接続を簡単にするため、必要なダイアル手順やログイン手順を定義した チャットスクリプトを書くことができます。 - .It オンデマンドでのダイアルアップをサポート -auto モード (自動モード) では +.Fl auto +モード (自動モード) では .Nm はデーモンとして動作し、 .Em PPP リンクを通して送られるパケットを待ちうけます。 -パケットを検出すると、デーモンが自動的にダイアルを行なって接続を確立します。 - -ddial モード (専用モードまたはデーモンダイアルモード) でも -ほぼ同様に、自動ダイアルと接続の確立を行ないます。 +パケットを検出すると、デーモンが自動的にダイアルを行って接続を確立します。 +.Fl ddial +モード (直接ダイアルモード) でも +ほぼ同様に、自動ダイアルと接続の確立を行います。 しかしながらこのモードは、送るべきパケットが存在しない場合にも、 リンクが切れていることを検出するといつでもリモートへダイアルするという点が auto モードと異なります。 このモードは、電話料金よりも常時接続されていることが重視される場合に有用です。 - +3 番目の +.Fl dedicated +モード (専用モード) も利用可能です。 +このモードは 2 つのマシン間の専用線を対象にしています。 +専用モードでは +.Nm +は自発的に動作を終了することはありません - 終了するには +.Dq quit all +コマンドを診断ソケットを介して送る必要があります。 +.Dv SIGHUP +は LCP の再交渉を強要し、 +.Dv SIGTERM +は終了を強要します。 .It パケットエイリアシングをサポート -一般には IP マスカレードとして知られるパケットエイリアシングにより、 +パケットエイリアシング (別名: IP マスカレード) により、 未登録でプライベートなネットワーク上のコンピュータからも インターネットにアクセスすることが可能です。 .Em PPP ホストはマスカレードゲートウェイとして動作します。 送信パケットの IP アドレスと TCP や UDP のポート番号は どちらもエイリアスされ、返信パケットではエイリアスが元に戻されます。 - .It バックグラウンド PPP 接続をサポート バックグラウンドモードでは、接続を確立するのに成功した場合に .Nm はデーモンになります。 それ以外の場合はエラーで終了します。 - +これにより、 +接続が成功裏に確立した場合のみコマンドを実行するようなスクリプト +をセットアップすることが出来ます。 .It サーバとしての PPP 接続をサポート ダイレクトモードでは、 .Nm は標準入力/標準出力からの .Em PPP 接続を受け入れるサーバとして動作させることができます。 - .It PAP と CHAP による認証をサポート - +PAP もしくは CHAP を用いることにより、Unix スタイルの +.Xr login 1 +手続きをスキップし、 +.Em PPP +プロトコルを代りに認証に使用することが可能です。 .It 代理 arp (Proxy Arp) をサポート .Em PPP -がサーバとして動作している時、その接続について代理 arp を行なうよう +がサーバとして動作している時、その接続について代理 arp を行うよう 設定できます。 - .It パケットのフィルタリングをサポート ユーザは 4 種類のフィルタを定義できます。 .Em ifilter @@ -97,22 +118,19 @@ auto .Em ofilter は送信パケットに対するフィルタです。 .Em dfilter -はダイアルを行なうきっかけとなるパケットを定義するフィルタで、 +はダイアルを行うきっかけとなるパケットを定義するフィルタで、 .Em afilter は接続を保持するためのパケットを定義するフィルタです。 - .It トンネルドライバは bpf (Berkeley Packet Filter) をサポート .Em PPP リンクを流れるパケットを調べるために、 .Xr tcpdump 1 を使うことができます。 - -.It PPP over TCP をサポート - +.It PPP オーバ TCP をサポート .It IETF ドラフトの Predictor-1 圧縮をサポート .Nm は VJ 圧縮の他に Predictor-1 圧縮もサポートしています。 -モデムは通常 (たとえば v42.bis のような) 組み込みの圧縮機能を持っており、 +モデムは通常 (例えば v42.bis のような) 組み込みの圧縮機能を持っており、 その結果システムは .\"(訳注)「転送データレートよりも」をここにいれたいと考えています。 .\" 2.2.1R 対象(1997/04/02) Takeshi MUTOH @@ -124,15 +142,13 @@ auto VJ 圧縮とは異なり、Predictor-1 圧縮はリンクを通る .Em すべての データをあらかじめ圧縮しておくことで、オーバヘッドを最小にします。 - -.It マイクロソフトの IPCP 拡張をサポート -マイクロソフトの +.It Microsoft の IPCP 拡張をサポート +Microsoft の .Em PPP スタックを使用するクライアント (つまり Win95, WinNT) との間で ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを -調停することができます。 +交渉することができます。 .El - .Sh パーミッション .Nm ppp はユーザ @@ -142,27 +158,27 @@ VJ 、パーミッション .Dv 4550 でインストールされます。 +デフォルトでは .Nm ppp -は、起動したユーザ ID が 0 でない場合には、 -クライアントモードでは実行しません。 -.Nm ppp -は、通常ユーザの場合には、 -.Fl direct -モードで実行します。 -しかし実行パーミッションの都合により、 -このユーザはグループ -.Dv network -に属する必要があります。 -通常ユーザとして実行するする場合には、 -システムのルーティングテーブルを変更するために、 +は、起動したユーザ ID が 0 でない場合には実行しません。 +これは +.Dq allow users +コマンドを +.Pa /etc/ppp/ppp.conf +に記載することにより変更することが可能です。 +通常ユーザとして実行する場合には、 .Nm -はユーザ ID 0 に変わります。 +はユーザ ID 0 に変わり、システムのルーティングテーブルを変更するために、 +システムロックファイルを作成し、 +ppp の設定ファイルを読みます。 全ての外部コマンド ("shell" や "!bg" で実行されます) は、 .Nm ppp を起動したユーザ ID で実行されます。 - +ユーザ ID 0 にて正確になにが行われているのかに興味がある場合には、 +ログ機能の +.Sq ID0 +を参照してください。 .Sh 始める前に - 最初に .Nm を実行する時には、いくつかの初期設定を整える必要があります。 @@ -170,29 +186,27 @@ VJ なりません (GENERIC カーネルではデフォルトで 1 つ含まれます)。 もし含まれていない場合や複数の tun インタフェースが必要な場合、 以下の行をカーネル設定ファイルに追加して、 -カーネルを再構築する必要があります。 - +カーネルを再構築する必要があります: +.Pp .Dl pseudo-device tun N - +.Pp ここで .Ar N は .Em PPP -接続を行ないたい最大の数です。 - +接続を行いたい最大の数です。 つぎに、 .Pa /dev ディレクトリにトンネルデバイスのエントリ .Pa /dev/tunN があるかどうかを調べてください。 ここで -.Ar N +.Sq N は、0 から始まる tun デバイスの番号です。 -もし無いようならば、"MAKEDEV tunN" を実行すれば作ることができます。 +もし無いようならば、"sh ./MAKEDEV tunN" を実行すれば作ることができます。 これにより 0 から .Ar N までの tun デバイスが作成されます。 - 最後に、ログファイルを作成します。 .Nm ppp は @@ -203,81 +217,77 @@ VJ このファイルに出力を行うためには、以下の行を .Pa /etc/syslog.conf ファイルに記述してください: - -.Dl !ppp -.Dl *.*/var/log/ppp.log - +.Bd -literal -offset indent +!ppp +*.*/var/log/ppp.log +.Ed +.Pp TAB と書かれている場所には、実際にはタブを入力します。 スペースを使うと、なにも知らされぬままこの行は無視されます。 - -ppp の実行形式にリンクを作成することにより、 -複数の ppp ログファイルを持つことが可能です: - +.Nm +の実行形式にリンクを作成することにより、複数の +.Em PPP +ログファイルを持つことが可能です: +.Pp .Dl # cd /usr/sbin .Dl # ln ppp ppp0 - +.Pp として .Pa /etc/syslog.conf で - -.Dl !ppp0 -.Dl *.* /var/log/ppp0.log - +.Bd -literal -offset indent +!ppp0 +*.* /var/log/ppp0.log +.Ed +.Pp とします。 .Pa /etc/syslog.conf を更新した後に、 -.Nm syslogd +.Xr syslogd 8 に .Dv HUP シグナルを送ることをお忘れなく。 - .Sh 手動ダイアル - 以下の例では、あなたのマシン名が -.Nm awfulhak +.Dv awfulhak であるとして説明します。 - -ホスト名とパスワードを -.Pa /etc/ppp/ppp.secret -に設定している場合、help, passwd, quit コマンドしか実行できないでしょう。 - -.Bd -literal -offset indent -ppp on "your hostname"> help - help : Display this message - passwd : Password for security - quit : Quit the PPP program -ppp on awfulhak> pass -.Ed - -正しいパスワードを入力すると、プロンプトの "on" は "ON" に変わります。 - +.Nm +を引数無しで起動すると (前述の +.Em パーミッション +参照) 次のプロンプトが表示されます: .Bd -literal -offset indent ppp ON awfulhak> .Ed - +.Pp +プロンプトの +.Sq ON +の部分は常に大文字であるべきです。ここが小文字の場合、 +.Dq passwd +コマンドを使用してパスワードを入力しなければならないことを意味します。 +実行中の +.Nm +に接続し、 +まだ正しいパスワードを入力していない場合にのみこのような状態になります。 +.Pp ここで、モデムのデバイス名、スピードやパリティの設定、 CTS/RTS 信号を使うかどうか (デフォルトでは CTS/RTS が使用されます) を -指定できます。もしハードウェアが CTS/RTS 信号を持っていない場合 -(これは ppp 可能な端末サーバに直接つなぐ場合に起こり得ます)、 +指定して、開始可能です。もしハードウェアが CTS/RTS 信号を持っていない場合 +(これは PPP 可能な端末サーバに直接つなぐ場合に起こり得ます)、 .Nm は そのポートを通してどんな出力も送らず、来るはずのない信号を待ち続けます。 したがって、直接接続で通信ができないような場合には、 -ctsrts を off にしてみてください。 - +CTS/RTS を off にしてみてください: .Bd -literal -offset indent ppp ON awfulhak> set line /dev/cuaa0 ppp ON awfulhak> set speed 38400 ppp ON awfulhak> set parity even ppp ON awfulhak> set ctsrts on ppp ON awfulhak> show modem - * モデム関連のパラメータが、ここに示されます * - ppp ON awfulhak> .Ed - -ここでは、直接モデムと通信するために term コマンドを使用可能です。 - +.Pp +ここでは、直接モデムと通信するために term コマンドを使用可能です: .Bd -literal -offset indent ppp ON awfulhak> term at @@ -288,82 +298,84 @@ login: ppp Password: Protocol: ppp .Ed - -相手が PPP で話しはじめると、 +.Pp +相手が +.Em PPP +で話しはじめると、 .Nm はそれを自動的に検出してコマンドモードに戻ります。 - .Bd -literal -offset indent ppp ON awfulhak> PPP ON awfulhak> .Ed - +.Pp これで接続されました! プロンプトの .Sq PPP が大文字に変化して、接続されたことを知らせます。 show コマンドを使用すれば、どのように事態が進行しているのかが分ります: - .Bd -literal -offset indent PPP ON awfulhak> show lcp - * LCP 関連の情報がここに表示されます * - PPP ON awfulhak> show ipcp - * IPCP 関連の情報がここに表示されます * .Ed - +.Pp この時点で、マシンは接続先に対するホスト単位のルート (host route) を持っています。 これはリンクの相手のホストとのみ接続可能であるという意味です。 デフォルトルートのエントリ -(他のルーティングエントリを持たずに、全パケットを ppp リンクの相手に送る +(他のルーティングエントリを持たずに、全パケットを +.Em PPP +リンクの相手に送る ように、あなたのマシンに指示します)を追加したければ、 以下のコマンドを入力してください。 - .Bd -literal -offset indent -PPP ON awfulhak> add 0 0 HISADDR +PPP ON awfulhak> add default HISADDR .Ed - +.Pp .Sq HISADDR という文字列は、相手側の IP アドレスを表します。 -この変数は接続が確立して始めて使用可能となります。 -よくある誤りとして、上記記述を -.Pa ppp.conf -ファイルに指定してしまうということがあります。 -このファイルが読まれる時には、リモート IP アドレスは確立していませんので、 -うまくいきません。 - +.Sq HISADDR +の位置に +.Sq INTERFACE +キーワードを使用可能です。 +これにより tun インタフェース上に直接経路を作成します。 ここで、(ping, telnet, ftp のような) ネットワークアプリケーションを 別のウインドウで使用可能です。 - -使用可能コマンドの詳細は PPP コマンドリストの節を参照してください。 - +使用可能コマンドの詳細は +.Em PPP コマンドリスト +の節を参照してください。 .Sh 自動ダイアル - -自動ダイアルを行なうためには、 Dial と Login のチャットスクリプトを +自動ダイアルを行うためには、 Dial と Login のチャットスクリプトを 用意しなければなりません。定義の例は .Pa /etc/ppp/ppp.conf.sample -を見てください (ppp.conf の書式は非常に簡単です)。 - +を見てください ( +.Pa /etc/ppp/ppp.conf +の書式は非常に簡単です)。 +各行は単一のコメント、インクルード、ラベル、コマンドのいずれかを含みます。 .Bl -bullet -compact - .It -各行には一つのコマンドまたはラベル、コメントのいずれかが書かれます。 - -.It -.Sq # +.Pq Dq # で始まる行は、コメントとして扱われます。 +コメント行と認識した場合、先行する空白は無視されます。 .It -ラベルは行頭から始まり、最後にコロン (:) が続かなければなりません。 - +インクルードは語 +.Sq !include +から始まる行です。 +一つの引数 - インクルードするファイル - を持つ必要があります。 +古いバージョンの +.Dq !include ~/.ppp.conf +を使用したいかもしれません。 +.It +ラベルは行頭から始まり、最後にコロン +.Pq Dq \&: +が続かなければなりません。 .It コマンド行は、空白かタブで始まらなければなりません。 - .El - -.Pa ppp.conf +.Pp +.Pa /etc/ppp/ppp.conf ファイルには少くとも .Dq default セクションが存在する必要があります。 @@ -376,7 +388,6 @@ PPP ON awfulhak> add 0 0 HISADDR は入力の .Nm 構成を表したります。 - .Nm ppp を立ち上げる際に、接続先のラベル名を指定可能です。 .Dq default @@ -386,15 +397,17 @@ PPP ON awfulhak> add 0 0 HISADDR を引数無しで起動した場合、 .Dq default だけは実行されます。load コマンドを使用して、 -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf のセクションを手動でロード可能です: - .Bd -literal -offset indent PPP ON awfulhak> load MyISP .Ed - -ひとたび接続が確立したなら、プロンプトの ppp は PPP に変わります: - +.Pp +ひとたび接続が確立したなら、プロンプトの +.Sq ppp +は +.Sq PPP +に変わります: .Bd -literal -offset indent # ppp MyISP ... @@ -403,7 +416,7 @@ dial OK! login OK! PPP ON awfulhak> .Ed - +.Pp もし .Pa /etc/ppp/ppp.linkup が存在していれば、 @@ -415,18 +428,22 @@ PPP ON awfulhak> の .Dq pmdeman の例を参照してください。 -HISADDR という文字列はリモート側の IP アドレスを表しています。 +.Dv HISADDR , +.Dv MYADDR , +.Dv INTERFACE +という文字列はおのおのの IP アドレスとインタフェース名を表しています。 同様に、接続が閉じられると、 .Pa /etc/ppp/ppp.linkdown ファイルの内容が実行されます。 - +これらのファイルのフォーマットは +.Pa /etc/ppp/ppp.conf +と同じです。 .Sh バックグラウンドダイアル - .Nm ppp -を使って非対話的に接続を確立したい場合 (たとえば -.Xr crontab(5) +を使って非対話的に接続を確立したい場合 (例えば +.Xr crontab 5 エントリや -.Xr at(1) +.Xr at 1 ジョブから使うような場合) には、 .Fl background オプションを使います。この場合にも @@ -438,7 +455,6 @@ HISADDR リモートの接続先の IP アドレスを定義する必要があります。( .Pa /etc/ppp/ppp.conf.sample 参照。) - .Fl background が指定された場合、 .Nm @@ -447,7 +463,6 @@ HISADDR これらに失敗すると、 .Nm は即座に終了し、0 でない終了コードを返します。 - 接続に成功すると .Nm はデーモンになり、呼び出し側に終了コード 0 を返します。 @@ -455,9 +470,7 @@ HISADDR もしくは .Dv TERM シグナルを受け取った場合に、自動的に終了します。 - -.Sh ダイアル・オンデマンド - +.Sh ダイアルオンデマンド デマンドダイアル機能は .Fl auto または @@ -470,13 +483,12 @@ HISADDR コマンドも書かれていなければなりません ( .Pa /etc/ppp/ppp.conf.sample を参照してください)。 - .Bd -literal -offset indent # ppp -auto pmdemand ... # .Ed - +.Pp .Fl auto または .Fl ddial @@ -489,35 +501,37 @@ HISADDR や .Fl direct のモードでも可能です): - .Bd -literal -offset indent # pppctl -v 3000 show ipcp Password: -IPCP [OPEND] +IPCP [Opened] his side: xxxx .... .Ed - +.Pp 現在 .Xr telnet 1 -を使用して対話的に会話できます。 - +を使用して対話的に会話することもできます。 .Pp -それぞれの +これを実現するために、後述のように +.Dq set server +コマンドを使用する必要があります。 +.Pa /etc/ppp/ppp.secret +を設定し +.Dv USR1 +シグナルを送ることにより、 +過去を振り返って診断ポートにて listen するように .Nm -デーモンは "3000 + トンネルデバイス番号" で計算される番号のポートで -参照できます。 - +プログラムを実行することが可能です。 .Fl auto モードにて 送信パケットが検出された時、 .Nm -は (チャットスクリプトにもとづいて) ダイアルを行ない、 +は (チャットスクリプトに基づいて) ダイアルを行い、 通信相手に接続しようとします。 .Fl ddial モードでは回線がダウンしていることが確認された場合にはいつでも -ダイアルが行なわれます。 - +ダイアルが行われます。 接続に失敗したら、デフォルトの動作では 30 秒間待ち、 別の送信パケットが検出された時に接続しようとします。 この動作は @@ -552,10 +566,9 @@ set redial 10.3 4 .Pp は個々の送信パケットに対して 4 回接続を試み、 番号間の待ち時間が 3 秒で、すべての番号を試した後に -10 秒待つことをあらわします。 +10 秒待つことを表します。 複数の電話番号が指定されている場合でも、トータルのダイアル回数は 4 回のままです。 (それぞれの番号を 4 回ダイアルするのではありません)。 - リンクの両端が .Nm のデマンドダイアルモードを利用している場合は、 @@ -563,7 +576,6 @@ set redial 10.3 4 もし、リンクの両端が同じタイムアウト時間に設定されていて、 リンクが切れて両方に送信待ちのパケットがあった場合、 両方が同時に相手を呼び出しあうことになってしまいます。 - 場所によっては、シリアルリンクに信頼性がなく、 切れるべきでない時にキャリアが失われるかもしれません。 セッションの途中で予期せずキャリアが失われた場合、 @@ -572,16 +584,18 @@ set redial 10.3 4 .Bd -literal -offset indent set reconnect timeout ntries .Ed - +.Pp このコマンドは、キャリアが失われた時に .Ar timeout 秒待ってから .Ar ntries -回まで接続を再確立するよう ppp に指示します。たとえば、 +回まで接続を再確立するよう +.Nm +に指示します。例えば、 .Bd -literal -offset indent set reconnect 3 5 .Ed - +.Pp は、予期せぬキャリア喪失の際に .Ar 3 秒待ってから再接続を試みるように @@ -590,43 +604,42 @@ set reconnect 3 5 .Nm があきらめる前に .Ar 5 -回まで行なわれます。 +回まで行われます。 ntries のデフォルト値はゼロ (再接続しない) です。 このオプションを使用する際には注意が必要です。 もしローカル側のタイムアウトがリモート側よりもわずかに長いと、 リモート側がタイムアウトにより回線を切断した場合に、 再接続機能が (指定した回数まで) 起動されてしまいます。 - 注: この文脈においては、多くの LQR を喪失するとキャリア喪失を引き起こし、 ひいては再接続を引き起こします。 - .Fl background -フラグが指定された場合、接続が行なえるまで +フラグが指定された場合、接続が行えるまで すべての電話番号が最大一回ダイアルされます。 .Dq set redial -コマンドにて、リダイアル期間の後には、 +コマンドにて、リダイアル期間の後に、 再接続回数を指定します。 リダイアル値が指定した電話番号数より少ない場合、 指定した電話番号で使用されないものが出来ます。 - プログラムを終了させるには、以下のように入力してください。 - - PPP ON awfulhak> close - ppp ON awfulhak> quit all - +.Bd -literal -offset indent +PPP ON awfulhak> close +ppp ON awfulhak> quit all +.Ed .Pp .Dq quit -コマンドは telnet による接続を終了しますが、 +コマンドは +.Xr pppctl 8 +もしくは +.Xr telnet 1 +による接続を終了しますが、 プログラム自身は終了させません。 -プログラムも終了させたい場合には、 +.Nm +も終了させたい場合には、 .Dq quit all を実行してください。 - .Sh PPP 接続の受け入れ (方法その 1) - .Em PPP 接続要求を受け入れるには、以下の手順にしたがってください。 - .Bl -enum .It モデムと、 (必要であれば) @@ -634,124 +647,170 @@ ntries が正しく設定されていることを確認します。 .Bl -bullet -compact .It -フロー制御にはハードフロー (CTS/RTS) を使います。 +フロー制御にはハードウェアハンドシェイク (CTS/RTS) を使います。 .It -モデムはエコーバックを行なわず (ATE0) 、コマンドの結果も報告しない (ATQ1) +モデムはエコーバックを行わず (ATE0) 、コマンドの結果も報告しない (ATQ1) ように設定されていなければなりません。 .El - +.Pp .It -モデムが接続されているポートで getty が起動されるように +モデムが接続されているポートで +.Xr getty 8 +が起動されるように .Pa /etc/ttys を編集します。 - -たとえば、以下のように設定すれば良いでしょう。 - +例えば、以下のように設定すれば良いでしょう: .Dl ttyd1 "/usr/libexec/getty std.38400" dialup on secure - -getty を起動するために init プロセスに +.Xr getty 8 +を起動するために +.Xr init 8 +プロセスに .Dv HUP シグナルを送るのを 忘れないでください。 - .Dl # kill -HUP 1 - .It 接続するユーザのためのアカウントを用意します。 .Bd -literal ppp:xxxx:66:66:PPP Login User:/home/ppp:/usr/local/bin/ppplogin .Ed - +.Pp .It .Pa /usr/local/bin/ppplogin -ファイルを以下のような内容で作成します。 +ファイルを以下のような内容で作成します: .Bd -literal -offset indent #!/bin/sh -p exec /usr/sbin/ppp -direct .Ed - -(さらに制御を行なうためにラベル名を指定することもできます。) - .Pp -ダイレクトモード ( -.Fl direct ) +(さらに制御を行うためにラベル名を指定することもできます。) +.Pp +ダイレクトモード +.Pq Fl direct では、 .Nm は標準入力と標準出力を使って動作します。クライアント動作の .Nm と同様に、 -.Nm pppctl -を使用するか、3000 番 + 現在のトンネルデバイス番号のポートに -.Nm telnet -することでコマンドモードでの制御が可能です。 - +.Xr pppctl 8 +を使用するか設定済みの診断ポートに +.Xr telnet 8 +することで、コマンドモードでの制御が可能です。 .It -ネームサーバのアドレスと NetBIOS ネームサーバのアドレスを調停する、 -マイクロソフトの IPCP 拡張のサポートを有効にするには、 +オプションでサポートされている +Microsoft の IPCP ネームサーバと NetBIOS ネームサーバの +交渉を有効にすることが可能です。 .Dq enable msext と .Dq set ns pri-addr [sec-addr] および .Dq set nbns pri-addr [sec-addr] -を ppp.conf ファイルに追加します。 - +を +.Pa /etc/ppp/ppp.conf +ファイルに追加します。 .El - +.Pp .Sh PPP 接続の受け入れ (方法その 2) - この方法は、モデムの接続を扱うのに .Em mgetty+sendfax を使用するようにすすめている点が異なります。 -最近のバージョン 0.99 では、 +最近のバージョン (0.99 以降) では、 .Dq AUTO_PPP オプションをつけてコンパイルすることで、クライアントが -ログインプロンプトに向かって PPP を話すのを検出することができます。 - +ログインプロンプトに向かって +.Em PPP +を話すのを検出することができます。 手順は以下の通りです: - .Bl -enum - .It AUTO_PPP オプションが使えるように、バージョン 0.99 か それ以降の mgetty+sendfax を入手、設定、インストールします。 - .It モデムが接続されているポートで mgetty が起動されるように .Pa /etc/ttys を編集します。 例えば、以下のように設定すれば良いでしょう: - .Dl cuaa1 "/usr/local/sbin/mgetty -s 57600" dialup on - .It 接続するユーザのためのアカウントを用意します。 .Bd -literal Pfred:xxxx:66:66:Fred's PPP:/home/ppp:/etc/ppp/ppp-dialup .Ed - +.Pp .It -以下のファイルをよく読んで、要点を理解してください。 -.Pa /etc/ppp/sample.ppp-dialup -.Pa /etc/ppp/sample.ppp-pap-dialup +ファイル +.Pa /etc/ppp/sample.ppp-dialup , +.Pa /etc/ppp/sample.ppp-pap-dialup , .Pa /etc/ppp/ppp.conf.sample -以下のようにすると ppp-pap-dialup が +をよく読んで、要点を理解してください。以下のようにすると +.Pa /etc/ppp/ppp-pap-dialup +が .Pa /usr/local/etc/mgetty+sendfax/login.conf から呼び出されます。 - .Dl /AutoPPP/ - - /etc/ppp/ppp-pap-dialup .El - +.Pp +.Sh 内向き接続の認証 +通常、接続の受信側は相手が相手自身を認証することを要求します。 +これは通常 +.Xr login 1 +にて行われますが、代りに PAP か CHAP を使用可能です。 +2 つのうちで CHAP の方がより安全ですが、 +クライアントによってはサポートしていないものがあります。 +どちらを使いたいか決めたら、 +.Sq enable chap +または +.Sq enable pap +を +.Pa ppp.conf +の適切なセクションに追加してください。 +.Pp +その後、 +.Pa /etc/ppp/ppp.secret +ファイルの設定を行う必要があります。 +このファイルは、クライアントになりうるマシンごとに 1 行を含みます。 +各行は 4 つまでのフィールドからなります: +.Bd -literal -offset indent +name key [hisaddr [label]] +.Ed +.Pp +.Ar name +と +.Ar key +は期待されるクライアントを指定します。 +.Pa ppp.secret +の如何なる +.Ar name No / Ar key +の組み合わせにおいても適切でない返答をクライアントが与える場合、 +認証は失敗します。 +.Pp +認証に成功したならば、 +.Pq 指定時には +.Ar hisaddr +を IP 番号交渉時に使用します。詳細は +.Dq set ifaddr +コマンドを参照してください。 +.Pp +認証に成功し +.Ar label +が指定された場合、現在のシステムラベルは +.Ar label +にマッチするように修正されます。 +このことはファイル +.Pa ppp.linkup +と +.Pa ppp.linkdown +の後続のパーズに影響があります。 .Sh PPP オーバ TCP (別名: トンネリング) - -シリアルリンク上以外の ppp の使用方法として、 +シリアルリンク上以外の +.Nm +の使用方法として、 ホストとポートを指定することにより、 -tcp 接続を使用することが可能です。 - +TCP 接続を使用することが可能です: .Dl set device ui-gate:6669 - シリアルデバイスをオープンする代りに、 .Nm -は指定されたマシンンの指定されたソケットへの tcp 接続をオープンします。 +は指定されたマシンの指定されたソケットへの TCP 接続をオープンします。 .Nm は telnet プロトコルを使用しないこと、 telnet サーバと交渉できないことに注意を払うべきです。 @@ -759,36 +818,32 @@ telnet この ppp 接続を受信するポートを設定する必要があります。まず .Pa /etc/services を更新して、サービスを定義します: - -.Dl ppp-in 6669/tcp # Incoming ppp connections over tcp - +.Dl ppp-in 6669/tcp # Incoming PPP connections over tcp そして .Pa /etc/inetd.conf -を更新して、このポートへの受信接続をどのように扱うかを inetd に指示します: - +を更新して、このポートへの受信接続をどのように扱うかを +.Xr inetd 8 +に指示します: .Dl ppp-in stream tcp nowait root /usr/sbin/ppp ppp -direct ppp-in - .Pa /etc/inetd.conf を更新した後には、 -.Nm inetd +.Xr inetd 8 に .Dv HUP シグナルを送るのをお忘れなく。 - ここではラベル名 .Dq ppp-in を使用します。 ui-gate (受信側) の .Pa /etc/ppp/ppp.conf エントリは以下を含みます: - .Bd -literal -offset indent ppp-in: set timeout 0 set ifaddr 10.0.4.1 10.0.4.2 - add 10.0.1.0 255.255.255.0 10.0.4.1 + add 10.0.1.0 255.255.255.0 10.0.4.2 .Ed - +.Pp セキュリティのために PAP もしくは CHAP の設定をしたいかもしれません。 PAP を有効にするには以下の行を追加します: .Bd -literal -offset indent @@ -805,7 +860,6 @@ MyAuthName MyAuthPasswd awfulhak (起動側) の .Pa /etc/ppp/ppp.conf エントリは以下を含む必要があります: - .Bd -literal -offset indent ui-gate: set escape 0xff @@ -814,7 +868,7 @@ ui-gate: set timeout 30 5 4 set log Phase Chat Connect Carrier hdlc LCP IPCP CCP tun set ifaddr 10.0.4.2 10.0.4.1 - add 10.0.2.0 255.255.255.0 10.0.4.2 + add 10.0.2.0 255.255.255.0 10.0.4.1 .Ed .Pp PAP を有効にしようとしている場合、以下の設定も必要です: @@ -822,76 +876,80 @@ PAP set authname MyAuthName set authkey MyAuthKey .Ed - +.Pp 我々は、 ui-gate に 10.0.4.1 のアドレスを割り当て、 awfulhak に 10.0.4.2 のアドレスを割り当てようとしています。 - 接続をオープンするためには、以下をタイプするだけで良いです。 - .Dl awfulhak # ppp -background ui-gate - 結果として、 awfulhak にはネットワーク 10.0.2.0/24 への新たな「ルート」が、 ui-gate にはネットワーク 10.0.1.0/24 への新たな「ルート」が、 -tcp 接続経由でそれぞれ作成されます。 - +TCP 接続経由でそれぞれ作成されます。 ネットワークは実質的にブリッジされます - -下にある tcp 接続はパブリックなネットワーク (例えばインターネット) を +下にある TCP 接続はパブリックなネットワーク (例えばインターネット) を またがっても良いです。 また 2 つのゲートウェイ間では ppp トラフィックは -概念的に tcp ストリーム中でカプセル化されます +概念的に TCP ストリーム中でカプセル化されます (パケットがパケットに対応するわけではありません)。 - この機構の大きな欠点は、同時に 2 つの「配送保証」機構が存在することです - -この 2 つとは、下の tcp ストリームと ppp リンク上で使用されるプロトコルであり、 -おそらくまた tcp でしょう。 -パケット喪失が起ると、両者はそれぞれの方法で喪失したパケットを再送しようと +この 2 つとは、下の TCP ストリームと +.Em PPP +リンク上で使用されるプロトコルであり、おそらくまた TCP でしょう。 +パケット喪失が起ると、両者はそれぞれの方法で喪失した +パケットを再送しようと するでしょう。 - .Sh パケットエイリアシング - .Fl alias -コマンドラインオプションにより、パケットエイリアシングが有効になります。 -これにより、ppp ホストがローカルエリアネットワークの他のコンピュータに対して +コマンドラインオプションにより、 +パケットエイリアシングが有効になります。 +これにより、 +.Nm +ホストがローカルエリアネットワークの他のコンピュータに対して マスカレードゲートウェイとして動作するようになります。 -送信される IP パケットは、まるで ppp ホストから来たかのようにエイリアスされ、 +送信される IP パケットは、まるで +.Nm +ホストから来たかのようにエイリアスされ、 受信パケットは、それがローカルエリアネットワークの正しいマシンに 送られるようにエイリアスが戻されます。 - パケットエイリアシングにより、 未登録でプライベートなサブネット上のコンピュータを 外部から見えないようにしつつ、 インターネットへアクセス可能とします。 - -一般に、ppp が正しく動作していることの確認は、 -まず最初にパケットエイリアシングを禁止して行ないます。 +一般に、 +.Nm +が正しく動作していることの確認は、 +まず最初にパケットエイリアシングを禁止して行います。 次に .Fl alias -オプションを有効にして、ppp ホストの上で (ウェブブラウザや telnet, ftp, ping, -traceroute などの) ネットワークアプリケーションの動作を確認します。 +オプションを有効にして、 +.Nm +ホストの上で (ウェブブラウザや +.Xr telnet 1 , +.Xr ftp 1 , +.Xr ping 8 , +.Xr traceroute 8 +などの) ネットワークアプリケーションの動作を確認します。 最後に、LAN 上の別のコンピュータの上で同様なアプリケーションの 動作を確認することになります。 - -ppp ホストではネットワークアプリケーションが正しく動作するのに、 +.Nm +ホストではネットワークアプリケーションが正しく動作するのに、 LAN 上の別のコンピュータでは動かないのであれば、マスカレードソフトウェアは 正しく動いているけれども、ホストが IP パケットをフォワーディングしないか、 ひょっとするとパケットが送られて来ていないかのどちらかです。 .Pa /etc/rc.conf で IP フォワーディングが有効にされていることと、 -他のコンピュータで ppp ホストがその LAN のゲートウェイとして +他のコンピュータで +.Nm +ホストがその LAN のゲートウェイとして 指定されていることを確認してください。 - .Sh パケットのフィルタリング - この実装では、パケットのフィルタリングがサポートされています。 -ifilter, ofilter, dfilter の 3 種類のフィルタがあります。 +ifilter, ofilter, dfilter, afilter の 4 種類のフィルタがあります。 ここでは基本的なことについて書くことにします。 - .Bl -bullet -compact .It フィルタ定義は以下のような構文になっています。 - set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] [proto [src [lt|eq|gt] port ]] [dst [lt|eq|gt] port] [estab] .Bl -enum @@ -918,48 +976,40 @@ set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] は数字で指定するか、 .Pa /etc/services のサービス名で指定することができます。 - .El - +.Pp .It 各フィルタは規則 0 から始まり、20 個までの規則をもつことができます。 規則の集合は、規則 0 が定義されていなければ、有効にはなりません。 すなわち、デフォルトでは全てが通されます。 - .It パケットにマッチする規則が無い場合は、パケットは破棄 (ブロック) されます。 - .It すべての規則を消去するには、 .Dq set filter-name -1 を使ってください。 - .El - +.Pp .Pa /etc/ppp/ppp.conf.filter.example を参照してください。 - - .Sh アイドルタイマ、回線品質要求タイマ、リトライタイマの設定 - アイドルタイマを調べたり/設定するためには、それぞれ .Dq show timeout と .Dq set timeout [lqrtimer [retrytimer]] コマンドを使ってください: - .Bd -literal -offset indent ppp ON awfulhak> set timeout 600 .Ed - +.Pp タイムアウト時間は秒数で指定します。デフォルト値は timeout が 180 秒 (3 分)、lprtimer が 30 秒、 retrytimer が 3 秒です。 アイドルタイマ機能を使わないようにするためには、 +次のコマンドを利用してください。 .Bd -literal -offset indent ppp ON awfulhak> set timeout 0 .Ed -コマンドを利用してください。 - +.Pp .Fl auto モードでは、アイドルタイムアウトが発生すると .Nm @@ -967,26 +1017,32 @@ ppp ON awfulhak> set timeout 0 .Em PPP セッションを終了します。別の引金となるパケットがきた時に リンクを再び確立しようとします。 - -.Sh Predictor-1 圧縮 - -このバージョンでは、現在の IETF ドラフトに基づいた CCP および Predictor type 1 -圧縮をサポートしています。 +.Sh Predictor-1 および DEFLATE 圧縮 +このバージョンでは、 +現在の IETF ドラフトに基づき、CCP および Predictor type 1 圧縮 +もしくは deflate 圧縮をサポートしています。 デフォルトの動作として、 .Nm -は、接続相手が同意 (あるいは要求) した場合に、 +は、接続相手が同意 +.Pq あるいは要求 +した場合に、 この機能を使おうと (もしくは受け入れようと) します。 - -完全に CCP/predictor 機能を停止するためには、 -.Dq disable pred1 -と -.Dq deny pred1 -コマンドを使ってください。 - -.Sh IP アドレスの制御 - .Nm -は IP アドレスの調停のために IPCP を使います。接続の両側は、自分が +は deflate プロトコルを優先します。 +これらの機能を使用したくない時には +.Dq disable +と +.Dq deny +のコマンドを参照してください。 +.Pp +.Dq disable deflate +か +.Dq deny deflate +の一方を使用することにより、 +方向ごとに異ったアルゴリズムを使用することができます。 +.Sh IP アドレスの制御 +.Nm +は IP アドレスの交渉のために IPCP を使います。接続の両側は、自分が 使おうとするアドレスを提示し、要求された IP アドレスが受け入れ可能な ものであれば、相手に ACK (肯定応答) を返します。 受け入れることができなければ、別の IP アドレスの使用を促すために @@ -994,16 +1050,14 @@ ppp ON awfulhak> set timeout 0 は相手に NAK (否定応答) を返します。 接続の両側が受け取った要求に同意し (ACK を送っ) た時、 IPCP はオープン状態にセットされ、ネットワーク層での接続が確立されます。 - IPCP の動作を制御するために、この実装はローカルとリモートの IP アドレスを定義するための .Dq set ifaddr コマンドを持っています。 - .Bd -literal -offset indent set ifaddr [src_addr [dst_addr [netmask [trigger_addr]]]] .Ed - +.Pp ここで、 .Sq src_addr はローカル側で使おうと思っている IP アドレスで、 @@ -1021,85 +1075,77 @@ set ifaddr [src_addr [dst_addr [netmask [trigger_addr]]]] に適したマスク値です。 .Sq netmask は小さくすることのみ可能です。便利な値は 255.255.255.255 でしょう。 -誤った ppp の実装には、接続ネゴシエーションのために、 +誤った +.Em PPP +の実装には、接続交渉のために、 .Sq src_addr ではなく特別な IP アドレスを使用しなければならないものがあります。 この場合、 -.Sq trg_addr +.Sq trigger_addr で指定した IP アドレスが使用されます。 相手がこの提案された番号に同意しない限り、 ルーティングテーブルには影響しません。 - .Bd -literal -offset indent set ifaddr 192.244.177.38 192.244.177.2 255.255.255.255 0.0.0.0 .Ed - -上の例は、 +.Pp +上の例の意味は次の通りです: .Bl -bullet -compact .It 自分の IP アドレスとしてまず 0.0.0.0 を提案しますが、 アドレス 192.244.177.38 のみは受け付けます。 - .It 相手側のアドレスとして 192.244.177.2 を使うように要求し， 192.244.177.2 以外のどんなアドレスを使うことも許可しません。 相手側が別の IP アドレスを要求してきた時は、いつでも 192.244.177.2 を提案します。 - .It ルーティングテーブルのネットマスク値は 0xffffffff に設定されます。 .El - +.Pp これは、両側が既に決まった IP アドレスを持っている場合には うまくいきますが、多くの場合、一方がすべての IP アドレスを制御する サーバとして動作しており、もう一方はその方針に従わなくてはなりません。 - より柔軟な動作をさせるために、`ifaddr' 変数の IP アドレス指定を もっと緩やかにすることが可能です: - +.Pp .Dl set ifaddr 192.244.177.38/24 192.244.177.2/20 - +.Pp スラッシュ (/) に続く数字は、この IP アドレスで意味のあるビットの数を 表現しています。上の例は以下のことを示しています。 - .Bl -bullet -compact .It 可能なら自分のアドレスとして 192.244.177.38 を使おうとしますが、 192.244.177.0 から 192.244.177.255 の間の任意の IP アドレスも受け入れます。 - .It 相手のアドレスとして 192.244.177.2 を使うことを希望しますが、 192.244.176.0 から 192.244.191.255 の間の任意の IP アドレスも許可します。 - .It すでにお気づきと思いますが、 192.244.177.2 は 192.244.177.2/32 と書くことと 等価です。 - .It 例外として、0 は 0.0.0.0/0 と等価であり、希望する IP アドレスは 特に無く、リモート接続先の選択に従うことを意味します。 0 を使用した場合は、接続が確立するまで、ルーティングテーブルエントリは まったく設定されません。 - .It 192.244.177.2/0 は、どんな IP アドレスでも受け入れる/許可することを 意味しますが、最初に 192.244.177.2 を使うように提案します。 .El - +.Pp .Sh インターネットサービスプロバイダと接続する - -プロバイダに接続する際には、以下のステップを踏む必要があるでしょう。 - +プロバイダに接続する際には、以下のステップを踏む必要があるでしょう: .Bl -enum .It .Dq set phone コマンドを使って、ダイアルスクリプトにプロバイダの電話番号を記述します。 ダイアルやリダイアルに使用する電話番号は、 パイプ (|) またはコロン (:) で区切って -複数指定することができます。たとえば、以下のようになります。 +複数指定することができます。例えば、以下のようになります。 .Bd -literal -offset indent set phone "111[|222]...[:333[|444]...]... .Ed +.Pp 最初のパイプで区切られたリストの番号は、 直前の番号でダイアルもしくはログインスクリプトが失敗した場合のみ使用されます。 コロンで区切られた番号は、直前の番号の使用によりなにが起ったのかにかかわらず、 @@ -1122,25 +1168,22 @@ set phone "1234567|2345678:3456789|4567890" リストが終了すると、 通常のリダイアル期間だけ待ち、 最初から再開します。 - .Dq set dial コマンドの \\\\T 文字列は選択された番号で置きかえられます。 (以下を参照してください)。 - .It リダイアルに関する設定は、 .Dq set redial -で行ないます。 -たとえば回線の調子が悪かったり、 (最近では +で行います。 +例えば回線の調子が悪かったり、 (最近では それほど多くないでしょうが) プロバイダがいつも話中だったりすると、 -以下のように設定したくなるかもしれません。 +以下のように設定したくなるかもしれません: .Bd -literal -offset indent set redial 10 4 .Ed .Pp -これは最初の番号にリダイアルを行なう前に 10 秒待って、 +これは最初の番号にリダイアルを行う前に 10 秒待って、 4 回までダイアルしてみるという意味になります。 - .It .Dq set dial と @@ -1148,73 +1191,84 @@ set redial 10 4 コマンドを使ってログイン手続きを記述します。 .Dq set dial コマンドはモデムと通信してプロバイダへのリンクを確立するのに使われます。 -たとえば、以下のようになります。 +例えば、以下のようになります: .Bd -literal -offset indent -set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT" +set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" \e + ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT" .Ed .Pp このモデム「チャット」文字列の意味は以下の通りです。 - .Bl -bullet .It "BUSY" または "NO CARRIER" を受信した場合には処理を中止します。 .It タイムアウトを 4 秒にセットします。 .It -文字列の受信待ちは行ないません。 +文字列の受信待ちは行いません。 .It ATZ を送信します。 .It -OK の受信待ちを行ないます。もし受信できなければ、 -もう一度 ATZ を送信し、OK の受信待ちを行ないます。 +OK の受信待ちを行います。もし 4 秒以内に受信できなければ、 +もう一度 ATZ を送信し、OK の受信待ちを行います。 .It ATDTxxxxxxx を送信します。xxxxxxx は 上の電話番号リストの中の、次にダイアルする番号です。 .It タイムアウトを 60 にセットします。 .It -文字列 CONNECT の受信待ちを行ないます。 +文字列 CONNECT の受信待ちを行います。 .El - +.Pp 一旦接続が確立されると、ログインスクリプトが実行されます。 -このスクリプトはダイアルスクリプトと同じスタイルで書かれます。 +このスクリプトはダイアルスクリプトと同じスタイルで書かれますが、 +パスワードがログされないように注意してください: .Bd -literal -offset indent -set login "TIMEOUT 15 login:-\\\\r-login: awfulhak word: xxx ocol: PPP HELLO" +set authkey MySecret +set login "TIMEOUT 15 login:-\\\\r-login: awfulhak \e + word: \\\\P ocol: PPP HELLO" .Ed .Pp このログイン「チャット」文字列の意味は以下の通りです。 - .Bl -bullet .It タイムアウトを 15 秒にセットします。 .It -"login:" の受信待ちを行ないます。もし受信できなければ -改行文字を送信して、再び "login:" の受信待ちを行ないます。 +"login:" の受信待ちを行います。もし受信できなければ +復改文字を送信して、再び "login:" の受信待ちを行います。 .It "awfulhak" を送信します。 .It -"word:" ("Password:" プロンプトの末尾) の受信待ちを行ないます。 +"word:" ("Password:" プロンプトの末尾) の受信待ちを行います。 .It -"xxx" を送信します。 +.Ar authkey +に現在設定されている値を送信します。 .It -"ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行ないます。 +"ocol:" ("Protocol:" プロンプトの末尾) の受信待ちを行います。 .It "PPP" を送信します。 .It -"HELLO" の受信待ちを行ないます。 +"HELLO" の受信待ちを行います。 .El .Pp +.Dq set authkey +( +.Ar command +ログ使用時には) コマンドのログは特別な方法でとられ、( +.Sq ******** +とログされますので) 実際のパスワードが危険にさらされることはありません。 +.Ar chat +ログ使用時には、実際のパスワードの代りに '\\P' とログされます。 +.Pp ログインスクリプトはプロバイダによって大きく違うものになるでしょう。 - .It シリアル回線と通信速度を指定するためには .Dq set line と .Dq set speed -を使います。たとえば以下のようになります。 +を使います。例えば以下のようになります。 .Bd -literal -offset indent set line /dev/cuaa0 -set sp 115200 +set speed 115200 .Ed .Pp FreeBSD では cuaa0 が一つめのシリアルポートになります。 @@ -1224,7 +1278,6 @@ OpenBSD あなたのモデムが 28800 かそれ以上のビットレートで通信することが できるなら、シリアルポートの速度には 115200 を指定しておくべきでしょう。 一般に、シリアルポートの速度はモデムの速度の約 4 倍にしておきます。 - .It .Dq set ifaddr コマンドで IP アドレスを定義します。 @@ -1259,18 +1312,18 @@ ISP .Bd -literal -offset indent set ifaddr 10.10.10.10/0 10.10.11.11/0 0.0.0.0 0.0.0.0 .Ed - +.Pp .It ほとんどの場合、プロバイダはデフォルトルータでもあるでしょう。 -この場合、以下の行を -.Pa ppp.conf +この場合で +.Fl auto +モード使用時には、以下の行を +.Pa /etc/ppp/ppp.conf に追加します。 - .Bd -literal -offset indent delete ALL -add 0 0 HISADDR +add default HISADDR .Ed - .Pp これは、 .Nm @@ -1279,37 +1332,44 @@ add 0 0 HISADDR それから 10.10.11.11 をデフォルトルートとして追加するよう .Nm に指示します。 +.Fl auto +モードを使用していない時にはこれは必要ありません。 +なぜなら、 +.Nm +がすぐにダイアルして新しい IP 番号を相手と交渉できるからです。 .Pp -もし動的 IP アドレスを使うのであれば、以下の 2 行を -.Pa ppp.linkup +.Fl auto +モードを使用していないとき、もしくは動的 IP 番号を使用するときには、 +次の 2 行を +.Pa /etc/ppp/ppp.linkup ファイルに追加しておかなければなりません: - .Bd -literal -offset indent delete ALL -add 0 0 HISADDR +add default HISADDR .Ed - +.Pp HISADDR は「相手」の IP 番号を意味するマクロです。 -使用する IP 番号に関して、 -(IPCP を使用して) 合意されて始めて、使用可能です。 +使用する IP 番号に関して (IPCP を使用して) 合意 +もしくは ( +.Dq set ifaddr +を使用して) 設定してはじめて、使用可能です。 一旦接続が確立されると、 .Nm は直接ではないインタフェースのルートを全て削除し、 -デフォルトルートが相手の IP 番号を差すように設定します。 -.Pa ppp.conf +デフォルトルートが相手の IP 番号を指すように設定します。 +.Pa /etc/ppp/ppp.conf で使ったのと同じラベルを使用してください。 .Pp もしコマンドを対話的に入力しているのであれば、接続に成功した後で .Bd -literal -offset indent -add 0 0 HISADDR +add default HISADDR .Ed .Pp とタイプするだけで充分です。 - .It プロバイダが PAP/CHAP による認証を要求している場合は、 -.Pa ppp.conf -ファイルに以下の行を追加してください。 +.Pa /etc/ppp/ppp.conf +ファイルに以下の行を追加してください: .Bd -literal -offset indent set authname MyName set authkey MyPassword @@ -1317,21 +1377,18 @@ set authkey MyPassword .Pp デフォルトではどちらも受け付けられますので、ISP が何を要求しても大丈夫です。 .El - +.Pp 現実の例を見たい場合には、 .Pa /etc/ppp/ppp.conf.sample と .Pa /etc/ppp/ppp.linkup.sample を参照してください。 ラベル pmdemand は、ほとんどのプロバイダで使用できるでしょう。 - .Sh ログ機能 - .Nm -は以下のログ情報を +は以下のログ情報を、 .Xr syslog 3 -経由で出力することができます。 - +経由で、もしくはスクリーンに出力することができます: .Bl -column SMMMMMM -offset indent .It Li Async 非同期レベルパケットの 16 進ダンプ .It Li Carrier 'CARRIER' まで含めたチャットログの生成 @@ -1341,6 +1398,7 @@ set authkey MyPassword .It Li Connect 完全なチャットログの生成 .It Li Debug (非常に長い)デバッグ情報のログ .It Li HDLC HDLC パケットの 16 進ダンプ +.It Li ID0 ユーザ ID 0 で実行された全関数呼び出しを詳細に記録 .It Li IPCP IPCP パケットトレースの生成 .It Li LCP LCP パケットトレースの生成 .It Li Link アドレスの割当およびリンクの確立、解放イベントのログ @@ -1352,35 +1410,48 @@ set authkey MyPassword .It Li Error ターミナルデバイスとログファイルへの出力で、LOG_ERROR を使用します。 .It Li Alert ログファイルへの出力で、LOG_ALERT を使用します。 .El - +.Pp .Dq set log コマンドで、ログの出力レベルを設定することができます。 -また、複数のレベルを指定することも可能です。 +また、複数のレベルを単一コマンドラインにて指定することも可能です。 デフォルトは、 .Dq set log Carrier Link Phase です。 - +.Pp +スクリーンに直接ログを表示することも可能です。 +文法は同じで、語 +.Dq local +が .Dq set log +の直後に付くことだけが違います。 +デフォルトは +.Dq set log local +(つまり、直接スクリーンにログ表示) です。 +.Pp +.Dq set log Op local への最初の引数が '+' か '-' の文字で始まる場合、 現在のログレベルを消去せずに修正します。例えば: - .Bd -literal -offset indent +PPP ON awfulhak> set log carrier link phase PPP ON awfulhak> show log -Log: Carrier Link Phase -PPP ON awfulhak> set log -Link +tcp/ip +Log: Carrier Link Phase Warning Error Alert +Local: Warning Error Alert +PPP ON awfulhak> set log -link +tcp/ip -warning +PPP ON awfulhak> set log local +command PPP ON awfulhak> show log -Log: Carrier Phase TCP/IP +Log: Carrier Phase TCP/IP Warning Error Alert +Local: Command Warning Error Alert .Ed - +.Pp レベル Warning, Error, Alert のメッセージログは -.Dq set log +.Dq set log Op local では制御できません。 - +.Pp +.Ar Warning +レベルは特別で、ローカルに表示可能な場合にはログされません。 .Sh シグナルハンドリング - -.Nm ppp +.Nm は以下のシグナルを扱います: - .Bl -tag -width 20 .It INT このシグナルを受信すると、現在の接続がもしあればそれを終了します。 @@ -1390,27 +1461,32 @@ Log: Carrier Phase TCP/IP のモードではない場合、 .Nm は終了します。 - .It HUP, TERM, QUIT .Nm を終了させます。 - .It USR1 対話モードではない場合、 .Nm にサーバソケットが存在する場合にはそれらをクローズさせ、 -デフォルトのポート番号選択規則で選んだインターネットソケットを -オープンさせます - このポートは 3000 + トンネルデバイス番号です。 - +3000 + トンネルデバイス番号のインターネットソケットを +オープンさせます。 +これは、適切なローカルパスワードが +.Pa /etc/ppp/ppp.secret +に指定されている場合にのみ行われます。 +.It USR2 +.Nm +に全サーバソケットをクローズさせます。 .El - +.Pp .Sh PPP コマンドリスト - この節では利用可能コマンドとその効果をリストします。 -ppp セッションで対話的に使用することも、 -コンフィギュレーションファイルで指定することも、 -telnet セッションで指定することも可能です。 - +.Nm ppp +セッションで対話的に使用することも、 +設定ファイルで指定することも、 +.Xr pppctl 8 +もしくは +.Xr telnet 1 +セッションで指定することも可能です。 .Bl -tag -width 20 .It accept|deny|enable|disable option.... これらのディレクティブは @@ -1418,7 +1494,7 @@ telnet .Nm に指示します。各 .Dq option -には、accept/deny および enable/disable のデフォルトを持ちます。 +は、accept/deny および enable/disable のデフォルトを持ちます。 .Dq accept は相手がこのオプションを要求したら、ACK を送ることを意味します。 .Dq deny @@ -1430,39 +1506,31 @@ telnet .Pp .Dq option は以下のいずれかです: - .Bl -tag -width 20 -.It vjcomp +.It acfcomp デフォルト: enable かつ accept。 -このオプションは Van Jacobson ヘッダ圧縮を使用するかどうかを決定します。 - -.It lqr -デフォルト: disable かつ accept。 -このオプションはリンク品質要求 (Link Quality Request) を送信するかどうかを -決定します。 -LQR は、モデムのキャリア検出を使用せずに、リンクダウンを -.Nm -に決定させるプロトコルです。 - +ACFComp はアドレスおよびコントロールフィールド圧縮 +(Address and Control Field Compression) を意味します。 +LCP パケット以外は非常に良く似たフィールトを持ちますので、 +簡単に圧縮可能です。 .It chap デフォルト: disable かつ accept。 -CHAP はチャレンジ交換承認プロトコル +CHAP はチャレンジ交換認証プロトコル (Challenge Handshake Authentication Protocol) を意味します。 CHAP もしくは PAP (後述) のどちらか一方のみ交渉可能です。 -CHAP では、承認者は「チャレンジ」メッセージを相手に送ります。 +CHAP では、認証者は「チャレンジ」メッセージを相手に送ります。 相手は一方向ハッシュ関数を使用して「チャレンジ」を暗号化し、 結果を送り返します。 -承認者は同じことを行い結果を比較します。 +認証者は同じことを行い結果を比較します。 この機構の利点は、接続を介してパスワードを送らないことです。 - 接続が最初に確立する時にチャレンジが行われます。 更なるチャレンジが行われるかもしれません。 -相手の承認を行いたい場合は、 +相手の認証を行いたい場合は、 .Dq enable chap を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に書き、相手のエントリを -.Pa ppp.secret +.Pa /etc/ppp/ppp.secret に書く必要があります。 .Pp クライアントとして CHAP を使用する場合、 @@ -1470,26 +1538,78 @@ CHAP と .Dq AuthKey を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に指定するだけで良いです。 CHAP はデフォルトで accept されます。 - +.Em PPP +の実装によっては、チャレンジの暗号化に +MD5 ではなく "MS-CHAP" を使用するものがあります。 +詳細については +.Dq set encrypt +コマンドの記述を参照してください。 +.It deflate +デフォルト: enable かつ accept。 +このオプションは圧縮制御プロトコル (Compression Control Protocol; CCP) に +deflate 圧縮を使用するか否かを決定します。 +使用されるアルゴリズムは +.Xr gzip 1 +プログラムが使用するものと同じです。 +注: +.Xr pppd 8 +- 多くのオペレーティングシステムで使用可能な +.Em PPP +の実装 - との +.Ar deflate +能力についてのネゴシエーションには問題があります +.Nm pppd +(バージョン 2.3.1) が +.Ar deflate +圧縮の交渉を行おうとする CCP コンフィギュレーションタイプは、 +.Pa rfc1979 +に規定されたタイプ +.Em 26 +ではなくタイプ +.Em 24 +であり、誤っています。 +タイプ +.Ar 24 +は実際には +.Pa rfc1975 +では +.Dq PPP Magnalink Variable Resource Compression +と指定されています! +.Nm +は +.Nm pppd +と交渉する能力がありますが、 +.Dq pppd-deflate +が +.Ar enable +かつ +.Ar accept +されている場合のみです。 +.It lqr +デフォルト: disable かつ accept。 +このオプションはリンク品質要求 (Link Quality Request) を送信するかどうかを +決定します。 +LQR は、モデムのキャリア検出を使用せずに、リンクダウンを +.Nm +に決定させるプロトコルです。 .It pap デフォルト: disable かつ accept。 -PAP はパスワード承認プロトコル (Password Authentication Protocol) を +PAP はパスワード認証プロトコル (Password Authentication Protocol) を 意味します。 CHAP (前述) もしくは PAP のどちらか一方のみ交渉可能です。 PAP では、ID とパスワードが相手に送られ続け、 -承認されるか接続が終了されるかまでこれが続きます。 +認証されるか接続が終了されるかまでこれが続きます。 これは比較的良くないセキュリティ機構です。 接続が最初に確立した時のみ実行可能です。 - -相手の承認を行いたい場合は、 +相手の認証を行いたい場合は、 .Dq enable pap を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に書き、相手のエントリを -.Pa ppp.secret +.Pa /etc/ppp.secret に書く必要があります (ただし、後述の .Dq passwdauth オプションを参照)。 @@ -1499,81 +1619,278 @@ PAP と .Dq AuthKey を -.Pa ppp.conf +.Pa /etc/ppp/ppp.conf に指定するだけで良いです。 PAP はデフォルトで accept されます。 - -.It acfcomp +.It pppd-deflate +デフォルト: disable かつ deny。 +.Ar deflate +オプションのバリエーションで、 +.Xr pppd 8 +プログラムとの交渉を許可します。 +詳細は、上述の +.Ar deflate +部分を参照してください。デフォルトでは抑止されますので、 +.Pa rfc1975 +に従っていないことになります。 +.It pred1 デフォルト: enable かつ accept。 -ACFComp はアドレスおよびコントロールフィールド圧縮 -(Address and Control Field Compression) を意味します。 -LCP パケット以外は非常に良く似たフィールトを持ちますので、 -簡単に圧縮可能です。 - +このオプションは圧縮制御プロトコル (Compression Control Protocol; CCP) に +Predictor 1 圧縮を使用するかどうかを決定します。 .It protocomp デフォルト: enable かつ accept。 このオプションは PFC (プロトコルフィールド圧縮) の交渉を行うために使用されます。 この機構により、 プロトコルフィールドが 2 オクテッドから 1 オクテッドに減ります。 - -.It pred1 +.It vjcomp デフォルト: enable かつ accept。 -このオプションは Predictor 1 圧縮を使用するかどうかを決定します。 - -.It msext -デフォルト: disable。 -このオプションは Microsoft の ppp 拡張を使用を許可します。 -これにより、Microsoft PPP DNS と Microsoft NetBIOS NS をサポートします。 -このオプションを有効にすることにより、"set ns" と "set nbns" で -与えられる値を渡せるようになります。 - +このオプションは Van Jacobson ヘッダ圧縮を使用するかどうかを決定します。 .El +.Pp 以下のオプションは、実際には相手と交渉しません。 それゆえ accept および deny は意味を持ちません。 - .Bl -tag -width 20 +.It msext +デフォルト: disable。 +このオプションは Microsoft の +.Em PPP +拡張の使用を許可します。 +これにより、DNS と NetBIOS NS の交渉をサポートします。 +このオプションを有効にすることにより、"set ns" と "set nbns" で +与えられる値を渡せるようになります。 +.It passwdauth +デフォルト: disable。 +このオプションを指定することにより、 +PAP 認証コードが呼び出し側を認証する時に、 +.Pa /etc/ppp/ppp.secret +ファイルではなくパスワードファイル ( +.Xr passwd 5 +参照) を使用させます。 .It proxy デフォルト: disable。 このオプションを指定することにより、 .Nm -に相手へのプロクシ ARP をさせます。 - -.It passwdauth +に相手のためにプロクシ ARP をさせます。 +.It throughput デフォルト: disable。 -このオプションを指定することにより、 -PAP 承認コードが呼び出し側を承認する時に、 -.Pa ppp.secret -ファイルではなく -.Pa passwd -ファイルを使用させます。 - +このオプションを有効にすると、 +.Nm +はスループット統計を収集します。 +ずれ動く 5 秒間のウィンドウにおいて入出力が検査され、 +現在、最良、総計の数値が保持されます。 +このデータは関連する +.Em PPP +層が終了するときに出力され、また +.Dq show +コマンドで表示することで得られます。スループット統計は +.Dq IPCP +と +.Dq modem +のレベルで利用可能です。 .It utmp デフォルト: enable。 -通常ユーザが PAP もしくは CHAP で承認された時で、 +通常ユーザが PAP もしくは CHAP で認証された時で、 .Nm が .Fl direct モードで実行されている時は、このユーザのエントリが utmp ファイルおよび wtmp ファイルに作成されます。 -このオプションを disable すると、utmp および wtmp のエントリは作成されません。 +このオプションを disable すると、 +.Nm +は utmp および wtmp のエントリを作成しません。 通常、 -ユーザがログインしかつ承認することを要求する場合のみ必要です。 - +ユーザがログインしかつ認証することを要求する場合のみ必要です。 .El - -.It add dest mask gateway -.Dq dest +.It add[!] dest mask gateway +.Ar dest は宛先 IP アドレスであり、 -.Dq mask +.Ar mask はそのマスクです。 -.Dq 0 0 +.Ar 0 0 はデフォルトルートを意味します。 -.Dq gateway +.Ar dest +および +.Ar mask +の引数の場所で、シンボル名 +.Sq default +を使用可能です。 +.Ar gateway は、 -.Dq dest +.Ar dest マシン/ネットワークに至る、次のホップのゲートウェイです。 - +宛先にシンボル名 +.Sq MYADDR +と +.Sq HISADDR +を使用可能であり、 +.Ar gateway +には +.Sq HISADDR +もしくは +.Sq INTERFACE +を使用可能です。 +.Sq MYADDR +はインタフェースアドレスに置き換えられ、 +.Sq HISADDR +はインタフェースの宛先アドレスに置き換えられ、 +.Sq INTERFACE +は現在のインタフェース名に置き換えられます。 +インタフェースの宛先アドレスが ( +.Dq set ifaddr +によって) 割当てられていない場合、現在の +.Sq INTERFACE +が +.Sq HISADDR +の代りに使用されます。 +.Pp +このコマンドを +.Pa ppp.conf +ファイルで使用するときの制限についての詳細は、後述の +.Dq set ifaddr +コマンドを参照してください。 +.Pp +.Ar add! +コマンド ( +.Dq \&! +に注意) 使用時には、 +ルートが存在する場合には +.Sq route change +コマンド (詳細は +.Xr route 8 +参照) にてルートを更新します。 +.It allow ..... +このコマンドは +.Nm +と設定ファイルへのアクセスを制御します。 +ユーザレベルでのアクセスは可能であり、 +設定ファイルのラベルと +.Nm +の実行モードに依存します。 +例えば、ユーザ +.Sq fred +のみがラベル +.Sq fredlabel +に +.Fl background +モードでアクセスできるように、 +.Nm +を構成したいかもしれません。 +.Pp +ユーザ ID 0 はこれらのコマンドの対象外です。 +.Bl -tag -width 20 +.It allow user|users logname... +デフォルトでは、ユーザ ID 0 のみがアクセスを許されています。 +このコマンドが指定されると、 +.Dq allow users +が記載されている個所に列挙されているユーザのアクセスが可能となります。 +.Sq default +セクションは +常に最初にチェックされます (スタートアップ時に常にロードされる唯一の +セクションです)。後続する +.Dq allow users +コマンドは、先行するコマンドに優先します。 +あるラベル以外のすべてにアクセスを許すことが可能であり、 +そのためにはデフォルトユーザを +.Sq default +セクションで指定し、新しいユーザリストをこのあるラベルに指定します。 +.Pp +ユーザ +.Sq * +が指定されると、全ユーザにアクセスが許されます。 +.It allow mode|modes modelist... +デフォルトでは全 +.Nm +モードが使用可能です。 +このコマンドが使用されると、 +このコマンドが指定されたラベルのロードに許されるアクセスモードが制限されます。 +.Dq allow users +コマンドと同様、 +各 +.Dq allow modes +コマンドは先行するコマンドに優先し、 +.Sq default +セクションは常に最初にチェックされます。 +.Pp +使用可能なモードは以下の通りです: +.Sq interactive , +.Sq auto , +.Sq direct , +.Sq dedicated , +.Sq ddial , +.Sq background , +.Sq * . +.El +.Pp +.It alias ..... +このコマンドは +.Nm +組込みのエイリアシング (マスカレーディング) 機能を +制御するために使用します。 +このコードが必要となるまで、 +.Nm +はこのコードをロードしません。 +エイリアスライブラリがあなたのシステムにインストールされないことも +大いにありえます +(エイリアスライブラリがセキュリティ的に危険だと認識する管理者もいます)。 +あなたのシステムでエイリアシングが有効になると、 +以下のコマンドが使用可能となります: +.Bl -tag -width 20 +.It alias enable [yes|no] +エイリアシングを有効もしくは無効にします。 +.Fl alias +コマンドラインフラグは +.Dq alias enable yes +と同じ意味です。 +.It alias port [proto targetIP:targetPORT [aliasIP:]aliasPORT] +このコマンドにより、 +マシン [aliasIP] の +.Dq aliasPORT +へ到着する接続を、 +.Dq targetIP +の +.Dq targetPORT +へリダイレクトします。 +proto を指定した場合、指定したプロトコルの接続のみマッチします。 +あなたのゲートウェイの後のマシンでインターネット電話等を実行したい場合に、 +このオプションは有用です。 +.It alias addr [addr_local addr_alias] +このコマンドにより、 +.Dq addr_alias +へのデータを +.Dq addr_local +へリダイレクトします。 +あなたのゲートウェイの後で +少数の実 IP アドレスを持ち、 +これらをあなたのゲートウェイの後の特定のマシンにマップしたい場合に有用です。 +.It alias deny_incoming [yes|no] +yes に設定した場合、ファイアウォールがパケットを落すのと同様に、 +全ての入力の接続を拒否します。 +.It alias log [yes|no] +このオプションを指定することにより、 +種々のエイリアシングの統計と情報を、ファイル +.Pa /var/log/alias.log +にログします。 +.It alias same_ports [yes|no] +有効になると、 +エイリアスライブラリが出力パケットのポート番号を変更しようとすることを +止めさせます。 +RPC や LPD といった、 +ウェルノウンポート (well known port) からの接続を要求する +プロトコルをサポートするのに有用です。 +.It alias use_sockets [yes|no] +有効になると、 +エイリアスライブラリにソケットを作成させ、 +正しい ftp データ入力や IRC 接続を保証できるようになります。 +.It alias unregistered_only [yes|no] +出力パケットを、登録されていない送信元アドレスに変更することだけを行います。 +RFC1918 に依ると、登録されていない送信元アドレスは +10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 です。 +.It alias help|? +このコマンドにより、 +使用可能なエイリアスコマンドのまとめを表示します。 +.El +.Pp .It [!]bg command 指定したコマンドをバックグラウンドで実行します。 擬似引数 @@ -1586,27 +1903,30 @@ utmp を停止させたい場合は、 .Dv shell コマンドを使用してください。 - .It close 現在の接続をクローズします (が終了しません)。 - -.It delete ALL | dest [gateway [mask]] -.Dq ALL +.It delete[!] dest +このコマンドは指定した +.Ar dest +IP アドレスのルートを削除します。 +.Ar dest +に +.Sq ALL が指定された場合、 .Nm が使用中のインタフェースの非直接エントリが全て削除されます。 tunX のエントリで実際のリンク以外を削除することを意味します。 -.Dq ALL -を使用しない場合、宛先 -.Dq dest -、宛先ネットワーク -.Dq mask -.Dq gateway -へのルートが削除されます。 -デフォルトの -.Dq mask -の値は 0.0.0.0 です - +.Ar dest +に +.Sq default +が指定された場合、デフォルトルートが削除されます。 +.Pp +.Ar delete! +コマンドが使用された場合 (最後の +.Dq \&! +に注意)、存在しないルートについて +.Nm +は文句を言わなくなります. .It dial|call [remote] .Dq remote が指定されている場合、 @@ -1617,17 +1937,18 @@ tunX .Dq login スクリプトを使用して確立されます。 そうでない場合、現在の設定が使用されて接続が確立されます。 - .It display 上述 .Dq accept|deny|enable|disable option.... で指定された、交渉可能な値の現在の状態を表示します。 - -.It passwd pass -全ての -.Nm -コマンドセットにアクセスするために要求されるパスワードを指定します。 - +.It down +リンクを切断しますが、 +綺麗な方法ではなく、物理層が使用不能になったように見えます。 +このコマンドを使用することは丁寧ではないとされています。 +.It help|? [command] +利用可能なコマンドをリストします。 +.Dq command +を指定した場合、このコマンドの使用方法を表示します。 .It load [remote] 指定された .Dq remote @@ -1636,22 +1957,54 @@ tunX が指定されない場合、 .Dq default ラベルが仮定されます。 - +.It passwd pass +全ての +.Nm +コマンドセットにアクセスするために要求されるパスワードを指定します。 +このパスワードは診断ポート ( +.Dq set server +コマンド参照) に接続するときに必要です。 +.Ar pass +の指定は、 +.Dq set server +コマンドラインもしくは +ローカルホストの +.Pa /var/log/ppp.secret +エントリにて可能です。 +.Ar command +ログが有効でも、値 +.Ar pass +はログされず、文字列 +.Dq ******** +がログされます。 +.It quit|bye [all] +.Nm +を終了します。 +.Nm +が対話モードであるか +.Dq all +引数が指定された場合、 +.Nm +は終了し、接続をクローズします。 +単に +.Dq quit +を +.Xr pppctl 8 +もしくは +.Xr telnet 1 +のセッションから発行しても、現在の接続をクローズしません。 .It save このオプションは (まだ) 実装されていません。 - .It set[up] var value このオプションは以下の変数の設定のために使用します: - .Bl -tag -width 20 .It set accmap hex-value ACCMap は非同期制御文字マップ (Asyncronous Control Character Map) を 意味します。 これはいつも相手と交渉され、デフォルト値は 0x00000000 です。 このプロトコルが必要なのは、 -特定の文字 (XON/XOFF など) を終点間で受渡すことに依存するハードウェアを +(XON/XOFF などの) 特定の文字を終点間で受渡すことに依存するハードウェアを 使用する場合です。 - .It set filter-name rule-no action [src_addr/src_width] [dst_addr/dst_width] [proto [src [lt|eq|gt] port ]] [dst [lt|eq|gt] port] [estab] @@ -1668,7 +2021,6 @@ dfilter ifilter はマシンに入力可能なパケットを指定します。 ofilter はマシンから出力可能なパケットを指定します。 デフォルトでは全てのフィルタが全パケットを通過させる値に設定されます。 - ルールは .Dq n に従って順番に処理されます。 @@ -1677,25 +2029,28 @@ ofilter ifilter と ofilter では、パケットをドロップすることを意味します。 afilter では、アイドルタイマをリセットしないことを意味します。 dfilter ではダイアルさせることにはならないことを意味します。 - 上述のパケットのフィルタリングの節を参照してください。 - .It set authkey|key value クライアントモードでの PAP または CHAP の交渉で使用される 認証キー (もしくはパスワード) を、指定した値に設定します。 -ダイアルもしくはログインスクリプトで使用されるパスワードを指定しますが、 +ダイアルもしくはログインスクリプトの '\\P' シーケンス +で使用されるパスワードを指定しますが、 実際のパスワードがログされることを防ぎます。 - +.Ar command +ログが有効な場合、セキュリティの観点から、 +.Ar value +は +.Ar ******** +としてログされます。 .It set authname id クライアントモードでの PAP または CHAP の交渉で使用される 認証 ID を設定します。 - .It set ctsrts ハードウェアフロー制御をセットします。 これがデフォルトです。 - -.It set device|line value -ppp が使用するデバイスを指定する +.It set device|line value[,value...] +.Nm +が使用するデバイスを指定する .Dq value に設定します。 全シリアルデバイス名は @@ -1714,100 +2069,303 @@ ppp の指定された .Dq port と接続しようとします。 -詳細は上述の PPP オーバ TCP の節を参照してください。 - +詳細は上述の +.Em PPP オーバ TCP +の節を参照してください。 +複数の +.Dq value +を指定した場合、 +.Nm +は全デバイスについて実行し終るまで、順番にオープンを試みます。 .It set dial chat-script 相手へダイアルする際に使用されるチャットスクリプトを指定します。 後述の -.Dv set login +.Dq set login コマンドも参照してください。 チャットスクリプトのフォーマットの詳細については、 .Xr chat 8 -とコンフィギュレーションファイルの例を参照してください。 -文字列 \\\\T は現在の電話番号に置換されます (後述の +と設定ファイルの例を参照してください。 +以下の特殊な +.Sq value +をチャットスクリプトに指定可能です: +.Bd -literal -offset indent +.It \\\\\\\\\\\\\\\\c +.Sq 送信 +文字列の最後の文字として使用した場合、 +改行を追加してはならないことを意味します。 +.It \\\\\\\\\\\\\\\\d +チャットスクリプトがこのシーケンスに出会うと、2 秒待ちます。 +.It \\\\\\\\\\\\\\\\p +チャットスクリプトがこのシーケンスに出会うと、1/4 秒待ちます。 +.It \\\\\\\\\\\\\\\\n +改行文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\r +復改文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\s +空白文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\t +タブ文字と置き換えられます。 +.It \\\\\\\\\\\\\\\\T +現在の電話番号と置き換えられます (後述の .Dq set phone -参照) 。 -文字列 \\\\P はパスワードに置換されます (後述の -.Dq set key -参照) 。 - +参照)。 +.It \\\\\\\\\\\\\\\\P +現在の +.Ar authkey +値と置き換えられます (前述の +.Dq set authkey +参照)。 +.It \\\\\\\\\\\\\\\\U +現在の +.Ar authname +値と置き換えられます (前述の +.Dq set authname +参照)。 +.Ed +.Pp +2 つのパーザがこれらのエスケープシーケンスを検査することに注意してください。 +.Sq チャットのパーザ +にエスケープ文字を見せるには、 +.Sq コマンドパーザ +からエスケープする必要があります。 +つまり、2 つのエスケープを使用する必要があります。例えば次のようにします: +.Bd -literal -offset indent +set dial "... ATDT\\\\T CONNECT" +.Ed +.Pp +チャットスクリプトから外部コマンドを実行することもできます。 +そうするためには、最初の文字をエクスクラメーションマーク +.Pq Dq \&! +にします。 +コマンドが実行されると、標準入力と標準出力がモデムデバイス ( +.Dq set device +参照) に向けられ、標準エラー出力が +.Nm +に読まれて受信待ち文字列もしくは送信文字列に置き換えられます。 +.Nm +が対話モードで実行している場合、ファイルデスクリプタは +.Pa /dev/tty +に接続されます。 +.Pp +例えば (読み易さのために折り返しています); +.Bd -literal -offset indent +set login "TIMEOUT 5 \\"\\" \\"\\" login:--login: ppp \e +word: ppp \\"!sh \\\\\\\\-c \\\\\\"echo \\\\\\\\-n label: >&2\\\\\\"\\" \e +\\"!/bin/echo in\\" HELLO" +.Ed +.Pp +は下記のチャットシーケンスになります (ダイヤル前の +.Sq set log local chat +コマンドによる出力): +.Bd -literal -offset indent +Dial attempt 1 of 1 +dial OK! +Chat: Expecting: +Chat: Sending: +Chat: Expecting: login:--login: +Chat: Wait for (5): login: +Chat: Sending: ppp +Chat: Expecting: word: +Chat: Wait for (5): word: +Chat: Sending: ppp +Chat: Expecting: !sh \\-c "echo \\-n label: >&2" +Chat: Exec: sh -c "echo -n label: >&2" +Chat: Wait for (5): !sh \\-c "echo \\-n label: >&2" --> label: +Chat: Exec: /bin/echo in +Chat: Sending: +Chat: Expecting: HELLO +Chat: Wait for (5): HELLO +login OK! +.Ed +.Pp +複数レベルのネストについて、 +エスケープ文字の使用方法に (再度) 注意してください。 +ここでは、4 つのパーザが動作してます。 +1 番目は、オリジナルの行をパーズし、3 つの引数として読みます。 +2 番目は、第 3 引数を 11 個の引数として読みます。 +ここで、 +.Dq \&- +記号がエスケープされていることが重要です。 +そうでなければパーザは、 +受信待ち-送信-受信待ちのシーケンスとして見てしまいます。 +.Dq \&! +文字を見付けると、実行パーザは最初のコマンドを 3 つの引数として読み、 +.Xr sh 1 +自身が +.Fl c +以降の引数を展開します。 +我々は出力をモデムに送り返したいので、 +1 番目の例では出力をファイルデスクリプタ 2 (stderr) にリダイレクトして +.Nm +自身に送信およびログさせ、 +2 番目の例では単に stdout に出力して直接モデムに出力させます。 +.Pp +もちろん全体を、組み込みのものではなく外部の +.Dq chat +コマンドに実行させることが可能です。 +良い代替方法については +.Xr chat 8 +を参照してください。 +.Pp .It set hangup chat-script モデムをクローズする前にこれをリセットする時に使用する、 チャットスクリプトを指定します。 - +.It set encrypt MSChap|MD5 +CHAP チャレンジを発行するときに要求および使用する +暗号化アルゴリズムを指定します。 +MSChap に設定すると、 +.Nm +は CHAP チャレンジ送信時 (CHAP が enable されていると仮定しています) +に Microsoft RAS のように振舞います。 +チャレンジへの応答時には、 +.Nm +チャレンジに基いてどのように暗号化するかを決定しますので、 +この設定は無視されます。 +.Bl -tag -width 注: +.It 注: +Microsoft の暗号化アルゴリズムは MD4 と DES の組み合わせを使用しますので、 +.Nm +構築前にマシンに DES 暗号化ソフトウェアをインストールしていないと、 +このオプションは使用できません - この場合 MD5 のみ使用されます。 +.El +.Pp .It set escape value... このオプションは上述の .Dq set accmap オプションに似ています。 リンクを経由する時に「エスケープ」される文字を指定するために使用します。 - .It set ifaddr [myaddr [hisaddr [netmask [triggeraddr]]]] このコマンドは、IPCP 交渉の間使用される IP アドレスを指定します。 アドレスのフォーマットは以下の通りです。 - .Dl a.b.c.d/n - a.b.c.d は IP アドレスであり、 n はこのうち何ビットが有効であるかを示します。 もし /n ビットが省略された場合、デフォルトの /32 になります。 ただし IP アドレスが 0.0.0.0 である場合には、マスクのデフォルトは /0 です。 - -.Dq triggeraddr +.Pp +.Ar hisaddr +に IP 番号の範囲として +.Dl a.b.c.d[-d.e.f.g][,h.i.j.k[-l,m,n,o]]... +のフォーマットを指定できます。例えば: +.Dl set ifaddr 10.0.0.1 10.0.1.2-10.0.1.10,10.0.1.20 +は +.Ar 10.0.0.1 +のみをローカル IP 番号として交渉しますが、指定された 10 個の IP 番号から +相手に割り当てを行います。 +相手がこれらの番号のうちの一つを要求し、この番号が未使用な場合には、 +.Nm +は相手の要求を認めます。 +相手がリンクを再確立して前回割当てていた IP 番号を使用したい場合に有用です。 +相手が要求した IP 番号が範囲外もしくは使用中の場合、 +.Nm +はまず範囲内の未使用 IP 番号をランダムに指示します。 +相手がこれに賛成しないと、 +番号が選択されるか過多の IPCP 構成要求が送出されるまで、 +.Nm +は次の番号を指示します。 +.Pp +.Ar triggeraddr が指定された場合、この値が -.Dq myaddr +.Ar myaddr の代りに IPCP 交渉で使用されます。 ただし、 -.Dq myaddr +.Ar myaddr の範囲のアドレスのみ受け入れられます。 - +.Pp +.Fl auto +モードでは設定ファイルの +.Dq set ifaddr +行を読んだ直後に +.Nm +がインタフェースを構成することに注意してください。 +他のモードではこれらの値は IPCP 交渉で使用され、 +IPCP 層がアップするまでこれらのインタフェースは構成されません。 +結果として、 +.Fl auto +モードでない限り、 +.Dq add +コマンドを +.Pa ppp.conf +で使用することは不可能 +.Pq か、少くとも賢くない +です (代りに +.Pa ppp.linkup +ファイルが使用されます)。 +.Dq allow mode auto +を使用して、現在のプロファイルを +.Fl auto +モードのみに限定してください。 +.Pp +また、一旦クライアントが自己を認証した後では、 +.Ar hisaddr +引数は +.Pa ppp.secret +ファイルによって優先されることに注意してください。詳細は +.Em 内向き接続の認証 +の節を参照してください。 .It set loopback on|off -.Dq on +.Ar on に設定された場合 (デフォルトです)、 -宛先アドレスが ppp インタフェースのアドレスと同一の送出パケットを、 +宛先アドレスが +.Em PPP +インタフェースのアドレスと同一の送出パケットを、 .Nm は自動的にループバックさせます。 -.Dq off +.Ar off に設定された場合、 .Nm はパケットを送信します。 この場合おそらく相手方で ICMP リダイレクトが発生します。 - -.It set log [+|-]value... +.It set log [local] [+|-]value... このコマンドにより現在のログレベルを修正できます。 詳細はログ機能の節を参照してください。 - .It set login chat-script -このチャットスクリプトはダイアルスクリプトを補います。 +この +.Ar chat-script +はダイアルスクリプトを補います。 もし両方が指定された場合、ダイアルスクリプトの後で、 ログインスクリプトが実行されます。 ダイアルスクリプト中で使用可能なエスケープシーケンスはここでも使用可能です。 - .It set mru value デフォルトの MRU は 1500 です。 この値を増加させた場合、相手は MTU を増加させても *かまいません*。 デフォルトの MRU より減らすことは意味がありません。 -なぜなら、PPP プロトコルでは少なくとも 1500 オクテッドのパケットを +なぜなら、 +.Em PPP +プロトコルでは少なくとも 1500 オクテッドのパケットを 受信できなければ *ならない* からです。 - .It set mtu value デフォルトの MTU は 1500 です。 相手が指定した MRU によって増加させることができます。 MTU はこのオプションによってのみ減らすことが可能です。 この値を増加させることは無効です。 なぜなら、相手は大きくなったパケットを受信できる保証が無いからです。 - -.It set openmode active|passive -デフォルトでは、openmode は常に active です。 +.It set ns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft DNS サーバを設定します。 +.It set nbns x.x.x.x y.y.y.y +このオプションは交渉される Microsoft NetBIOS DNS サーバを設定します。 +.It set openmode active|passive Op delay +デフォルトでは、 +.Ar openmode +は常に、1 秒の +.Ar delay +をもって +.Ar active +となります。 この場合、 .Nm -はいつでも LCP/IPCP/CCP の交渉を開始します。 -相手が交渉開始するのを待ちたい場合は、値 +は回線が設定されてから 1 秒が経過したなら +いつでも LCP/IPCP/CCP の交渉を開始します。 +相手が交渉を開始するのを待ちたい場合は、値 .Dq passive を使用します。 - +直ちにもしくは 1 秒以上待ってから交渉を開始したい場合、 +.Ar delay +を秒単位で指定します。 .It set parity odd|even|none|mark -ラインのパリティを設定できます。デフォルト値は none です。 - +ラインのパリティを設定できます。デフォルト値は +.Ar none +です。 .It set phone telno[|telno]...[:telno[|telno]...]... ダイアルおよびログインのチャットスクリプトで使用される \\\\T 文字列が 置き換えられる電話番号を指定できます。 @@ -1824,39 +2382,36 @@ MTU で指定します。 .Fl background モードでは各番号は最大 1 回試行されます。 - .It set reconnect timeout ntries (CD の喪失もしくは LQR の失敗により) 予想外のライン切断となった場合、 指定した -.Dq timeout +.Ar timeout の後に接続が再確立されます。 ラインは最大 -.Dq ntries +.Ar ntries 回、再接続されます。 -.Dq ntries +.Ar ntries のデフォルトは 0 です。 -.Dq timeout +.Ar timeout に -.Dq random +.Ar random を指定すると、0 から 30 秒の間の任意時間の停止となります。 - .It set redial seconds[.nseconds] [attempts] .Nm ppp に -.Dq attempts +.Ar attempts 回のリダイアルを指示できます。 1 より大きな数を指定した場合 (上述の -.Dq set phone +.Ar set phone 参照)、 各番号にダイアルする前に、 -.Dq nseconds +.Ar nseconds だけ停止します。 最初の番号にダイアル開始する前に -.Dq seconds +.Ar seconds だけ停止します。 .Dq random もここで使用できます。 - .It set stopped [LCPseconds [IPCPseconds [CCPseconds]]] このオプションが指定されると、 指定した有限状態機械が停止状態になってから @@ -1864,66 +2419,104 @@ MTU で指定した秒数だけ停止したのち、 .Nm はタイムアウトします。 -このオプションが便利かもしれないのは、 -ppp が停止状態になったことにより返事をしないといった状態を見る場合です。 +このオプションは、 +.Nm +が停止状態になったことにより返事をしないといった状態を見る場合と、 +.Dq set openmode passive +を使用した場合に相手が指定時間内に Configure Request を送らないことを +タイムアウト検出する場合には、便利かもしれません。 .Dq set log +lcp +ipcp +ccp を使用すると、 .Nm は全状態遷移をログします。 .Pp デフォルト値は 0 であり、 -停止状態による ppp のタイムアウトは発生しません。 - -.It set server|socket TcpPort|LocalName|none [mask] -通常、対話モードでない場合には、 +停止状態による .Nm -はコマンド接続を受け入れるために TCP ソケットを listen します。 -デフォルトのソケット番号は、3000 + -.Nm -がオープンしたトンネルデバイス番号で計算されます。 -例えば、 -.Nm -が tun2 をオープンした場合、ソケット 3002 を使用します。 +のタイムアウトは発生しません。 .Pp -このコマンドを使用すると、 -ポート番号やローカルドメインソケット (絶対ファイル名として指定) を指定可能 -ですし、 +この値は openmode の遅延 (上述の +.Dq set openmode +参照) より小さくなってはなりません。 +.It set server|socket TcpPort|LocalName|none [password] [mask] +このコマンドは .Nm -にコマンド接続を拒否させることも可能です。 -ローカルドメインソケットが指定された場合、 -ソケット作成の前にオクテットマスクを指定可能です。 -.Dv USR1 -シグナルの使用方法も参照してください。 - +に指定したポートもしくは +.Sq 診断ポート +にてコマンド接続の入力を listen するように指示します。 +これは +.Nm +が対話モードの時には出来ません。 +語 +.Ar none +は +.Nm +に既に存在するソケットをクローズさせます。 +UNIX ドメインソケットを指定したい場合、 +.Ar LocalName +に絶対ファイル名を指定します。そうしないと、TCP ポートの名前もしくは番号 +であると解釈されます。 +UNIX ドメインソケットに使用される 8 進 umask を指定可能です。 +.Sq 0 +から始まる 4 桁 8 進数で指定します。 +umask の詳細については +.Xr umask 2 +を参照してください。TCP ポート名がどのように変換されるかについては +.Xr services 5 +を参照してください。 +.Pp +このソケットにクライアントが接続するときに使用されねばならないパスワードも +指定可能です。 +ここにパスワードを指定しないと、 +.Pa /etc/ppp/ppp.secret +からドメインサフィックスを除いたローカルホスト名にてマシン名で検索を行います。 +詳細は +.Xr hostname 1 +を参照してください。 +パスワードに空文字列を指定すると、パスワードは要求されなくなります。 .Pp .Nm をサーバソケットと共に使用する場合、通信機構として .Xr pppctl 8 -コマンドを使用する方が好ましいです。 +コマンドを使用することが好ましいです。 現在 .Xr telnet 1 -も使用可能ですが、将来リンク暗号化が実装されますので、 -.Nm telnet +も使用可能ですが、将来リンク暗号化が実装されるかもしれませんので、 +.Xr telnet 1 に依存しないようにしてください。 - .It set speed value シリアルデバイスの速度を指定します。 - .It set timeout Idle [ lqr [ retry ] ] アイドルタイマ、 -(有効にされているなら )LQR タイマ、 +(有効にされているなら) LQR タイマ、 リトライタイマの値を指定します。 - -.It set ns x.x.x.x y.y.y.y -このオプションは交渉される Microsoft DNS サーバを設定します。 - -.It set nbns x.x.x.x y.y.y.y -このオプションは交渉される Microsoft NetBIOS DNS サーバを設定します。 - +.It set vj slots nslots +このコマンドは最初の +.Ar slots +番号を指定します。 +.Nm +は VJ 圧縮が enable されている時には、 +これを使用して相手と交渉をします (前述の +.Sq enable +コマンドを参照してください)。 +デフォルト値は 16 です。 +.Ar nslots +は +.Ar 4 +から +.Ar 16 +の間で、それぞれの値を含みます。 +.It set vj slotcomp on|off +このコマンドは +.Nm +に VJ スロット圧縮を交渉するか否かを指示します。 +デフォルトではスロット圧縮は +.Ar on +です。 .It set help|? 使用可能なセットコマンドのまとめを表示します。 .El - +.Pp .It shell|! [command] .Dq command が指定されない場合、 @@ -1937,85 +2530,67 @@ ppp は適切な値に置き換えられます。! 文字を使用した場合、 この後のコマンドとの間にスペースが必要です。 このコマンドはフォアグラウンドで実行されることに注意してください - -ppp はプロセスが終了するまでは実行を続けません。 +.Nm +はプロセスが終了するまでは実行を続けません。 バックグラウンドでコマンド処理を行いたい場合には、 .Dv bg コマンドを使用してください。 - .It show var このコマンドを使用して、以下を確認できます: - .Bl -tag -width 20 .It show [adio]filter -指定したフィルタの現在の規則をリストします。 - +指定したフィルタの現在のルールをリストします。 .It show auth -現在の authname と authkey を表示します。 - +現在の authname と暗号値を表示します。 +.Nm +を DES サポート無しで構築した場合、 +.Ar MD5 +が使用されるため、暗号値は表示されません。 .It show ccp 現在の CCP 統計を表示します。 - .It show compress 現在の圧縮統計を表示します。 - .It show escape 現在のエスケープ文字を表示します。 - .It show hdlc 現在の HDLC 統計を表示します。 - .It show ipcp 現在の IPCP 統計を表示します。 - .It show lcp 現在の LCP 統計を表示します。 - .It show loopback 現在のループバック状態を表示します。 - .It show log 現在のログ値を表示します。 - .It show mem 現在のメモリ統計を表示します。 - .It show modem 現在のモデム統計を表示します。 - .It show mru 現在の MRU を表示します。 - .It show mtu 現在の MTU を表示します。 - .It show proto 現在のプロトコルの総計を表示します。 - .It show reconnect 現在の再接続値を表示します。 - .It show redial 現在のリダイアル値を表示します。 - .It show stopped 現在の stopped タイムアウト値を表示します。 - .It show route 現在のルーティングテーブルを表示します。 - .It show timeout 現在のタイムアウト値を表示します。 - .It show msext 現在の Microsoft 拡張値を表示します。 - .It show version -ppp の現在のバージョン番号を表示します。 - +.Nm +の現在のバージョン番号を表示します。 .It show help|? 利用可能な show コマンドのまとめを表示します。 .El - +.Pp .It term ターミナルモードに移行します。 キーボードからタイプした文字はモデムに送られます。 @@ -2025,116 +2600,12 @@ ppp の相手が認識された時には、 .Nm は自動的にパケットモードを有効にし、コマンドモードに戻ります。 - -.It alias ..... -このコマンドは -.Nm ppp -組込みのエイリアシング (マスカレーディング) 機能を -制御するために使用します。 -このコードが必要となるまで、 -.Nm ppp -はこのコードをロードしません。 -エイリアスライブラリがあなたのシステムにインストールされないことも -大いにありえます -(エイリアスライブラリがセキュリティ的に危険だと認識する管理者もいます)。 - -あなたのシステムでエイリアシングが有効になると、 -以下のコマンドが使用可能となります: - -.Bl -tag -width 20 -.It alias enable [yes|no] -エイリアシングを有効もしくは無効にします。 -.Fl alias -コマンドラインフラグは -.Dq alias enable yes -と同じ意味です。 - -.It alias port [proto targetIP:targetPORT [aliasIP:]aliasPORT] -このコマンドにより、 -マシン [aliasIP] の -.Dq aliasPORT -へ到着する接続を、 -.Dq targetIP -の -.Dq targetPORT -へリダイレクトします。 -proto を指定した場合、指定したプロトコルの接続のみマッチします。 -あなたのゲートウェイの後のマシンでインターネット電話等を実行したい場合に、 -このオプションは有用です。 - -.It alias addr [addr_local addr_alias] -このコマンドにより、 -.Dq addr_alias -へのデータを -.Dq addr_local -へリダイレクトします。 -あなたのゲートウェイの後で -少数の実 IP アドレスを持ち、 -これらをあなたのゲートウェイの後の特定のマシンにマップしたい場合に有用です。 - -.It alias deny_incoming [yes|no] -yes に設定した場合、ファイアウォールがパケットを落すのと同様に、 -全ての入力の接続を拒否します。 - -.It alias log [yes|no] -このオプションを指定することにより、 -種々のエイリアシングの統計と情報を、ファイル -.Pa /var/log/alias.log -にログします。 - -.It alias same_ports [yes|no] -有効になると、 -エイリアスライブラリが出力パケットのポート番号を変更しようとすることを -止めさせます。 -RPC や LPD といった、 -ウェルノウンポート (well known port) からの接続を要求する -プロトコルをサポートするのに有用です。 - -.It alias use_sockets [yes|no] -有効になると、 -エイリアスライブラリにソケットを作成させ、 -正しい ftp データ入力と IRC 接続を保証できるようになります。 - -.It alias unregistered_only [yes|no] -出力パケットを、登録されていない送信元アドレスに変更することだけを行います。 -RFC1918 に依ると、登録されていない送信元アドレスは -10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 です。 - -.It alias help|? -このコマンドにより、 -使用可能なエイリアスコマンドのまとめを表示します。 - .El - -.It quit|bye [all] -.Nm ppp -を終了します。 -.Nm -が対話モードであるか -.Dq all -引数が指定された場合、ppp は終了し、接続をクローズします。 -単に -.Dq quit -を telnet セッションから入力するだけでは現在の接続をクローズしません。 - -.It help|? [command] -利用可能なコマンドをリストします。 -.Dq command -を指定した場合、このコマンドの使用方法を表示します。 - -.It down -リンクを切断しますが、綺麗な方法ではありません。 -このコマンドを使用することは丁寧ではないとされています。 - -.El - +.Pp .Sh 更に詳細について - .Bl -bullet -compact - .It 設定ファイルの例を読んでください。良い情報源です。 - また、 .It .Dq help , @@ -2144,79 +2615,85 @@ RFC1918 .Dq set ? コマンドを使ってください。 .El - +.Pp .Sh 関連ファイル .Nm -は、ppp.conf, ppp.linkup, ppp.linkdown, ppp.secret を参照します。 +は、4 つのファイル +.Pa ppp.conf , +.Pa ppp.linkup , +.Pa ppp.linkdown , +.Pa ppp.secret +を参照します。 これらのファイルは .Pa /etc/ppp -に置かれますが、ユーザが自分用のファイルを -.Pa .ppp.conf , -.Pa .ppp.linkup , -.Pa .ppp.linkdown , -.Pa .ppp.secret -として $HOME ディレクトリに作成することもできます。 -いつでも -.Nm -はユーザの個人設定を優先的に参照します。 - +に置かれます。 .Bl -tag -width flag -.Pa $HOME/ppp/.ppp.[conf|linkup|linkdown|secret] -ユーザ個人の設定ファイル。 - -.Pa /etc/ppp/ppp.conf +.It Pa /etc/ppp/ppp.conf システムのデフォルト設定ファイル。 - -.Pa /etc/ppp/ppp.secret +.It Pa /etc/ppp/ppp.secret 各システム用の認証設定ファイル。 - -.Pa /etc/ppp/ppp.linkup +.It Pa /etc/ppp/ppp.linkup .Nm がネットワーク層の接続を確立した時に実行されるファイル。 - -.Pa /etc/ppp/ppp.linkdown +.It Pa /etc/ppp/ppp.linkdown .Nm がネットワークレベルの接続を閉じるときにチェックするファイル。 - -.Pa /var/log/ppp.log -ログとデバッグ情報のファイル。 - -.Pa /var/spool/lock/LCK..* -tty ポートをロックするためのファイル。詳細は -.Xr uucplock 8 +.It Pa /var/log/ppp.log +ログとデバッグ情報のファイル。このファイル名は +.Pa /etc/syslogd.conf +にて指定されます。詳細は +.Xr syslog.conf 5 を参照してください。 - -.Pa /var/run/tunX.pid -tunX デバイスに接続されている ppp プログラムのプロセス id (pid) 。 +.It Pa /var/spool/lock/LCK..* +tty ポートをロックするためのファイル。詳細は +.Xr uucplock 3 +を参照してください。 +.It Pa /var/run/tunX.pid +tunX デバイスに接続されている +.Nm +プログラムのプロセス ID (pid) 。 ここで 'X' はデバイスの番号です。このファイルは .Fl background , .Fl auto , .Fl ddial のいずれかのモードの時のみ作成されます。 - -.Pa /var/run/ttyXX.if -このポートで使われている tun インターフェース。 +.It Pa /var/run/ttyXX.if +このポートで使われている tun インタフェース。 このファイルも .Fl background , .Fl auto , .Fl ddial のいずれかのモードの時のみ作成されます。 - -.Pa /etc/services +.Pa It /etc/services サービス名でポート番号が指定されている場合に、ポート番号を取得します。 .El - +.Pp .Sh 関連項目 +.Xr at 1 , .Xr chat 8 , +.Xr crontab 5 , +.Xr ftp 1 , +.Xr getty 8 , +.Xr gzip 1 , +.Xr hostname 1 , +.Xr inetd 8 , +.Xr init 8 , +.Xr login 1 , +.Xr passwd 5 , +.Xr ping 8 , +.Xr pppctl 8 , .Xr pppd 8 , -.Xr uucplock 3 , +.Xr route 8 , .Xr syslog 3 , .Xr syslog.conf 5 , .Xr syslogd 8 , -.Xr pppctl 8 , -.Xr telnet 1 - +.Xr tcpdump 1 , +.Xr telnet 1 , +.Xr traceroute 8 , +.Xr uucplock 3 .Sh 歴史 元のプログラムは Toshiharu OHNO (tony-o@iij.ad.jp) が作成し、 FreeBSD-2.0.5 に Atsushi Murai (amurai@spec.co.jp) が提出しました。 -多くの面で性能向上が計られたため、見た目がかなり異なります。 +.Pp +それから、本質的に Brian Somers (brian@Awfulhak.org) が修正をし、'97 年 +11 月に OpenBSD に移植されました (2.2-RELEASE の直後です)。 diff --git a/ja_JP.eucJP/man/man8/pppctl.8 b/ja_JP.eucJP/man/man8/pppctl.8 index fe20055386..ffc1b2a0d3 100644 --- a/ja_JP.eucJP/man/man8/pppctl.8 +++ b/ja_JP.eucJP/man/man8/pppctl.8 @@ -1,164 +1,200 @@ -.\" %Id: pppctl.8,v 1.1.2.3 1997/10/05 14:23:26 brian Exp % +.\" %Id: pppctl.8,v 1.1.2.4 1998/01/26 20:00:49 brian Exp % .Dd 26 June 1997 .Os FreeBSD .Dt PPPCTL 8 -.Sh 名称 +.Sh $BL>>N(B .Nm pppctl .Nd -PPP 制御プログラム -.Sh 書式 +PPP $B@)8f%W%m%0%i%`(B +.Sh $B=q<0(B .Nm .Op Fl v .Op Fl t Ar n .Op Fl p Ar passwd .Ar [host:]Port | LocalSocket -.Ar command -.Op Ar ;command -.Ar ... -.Sh 解説 -このプログラムは -.Nm ppp -デーモンのコマンドラインからの制御手段を提供します。 -基本的な使い方は、実行中のデーモンを制御する単純なスクリプトを -簡単に書けるようにすることです。 - -.Nm -は少なくともふたつの引数を必要とします。ひとつめは -.Nm ppp -デーモンが listen しているソケットを指定します。ソケットが -先頭に '/' を含んでいると、 AF_LOCAL ソケットとして扱われます。 -コロンを含んでいると host:port の組として扱われ、 -それ以外は単にローカルマシン (127.0.0.1) のポートを -指定したものとみなされます。 -DNS 検索を避けたい場合や、 -.Pa /etc/services -内に指定されたポートのエントリがない場合には、 -host と port には数字で指定することができます。 - +.Op command[;command]... +.Sh $B2r@b(B +$B$3$N%W%m%0%i%`$O(B +.Xr ppp 8 +$B%G!<%b%s$N%3%^%s%I%i%$%s$+$i$N@)8f/$J$/$H$b$R$H$D$N0z?t$rI,MW$H$7$^$9!#(B +$B>\:Y$K$D$$$F$O!"(B +.Nm ppp +$B%3%^%s%I$N(B +.Sq set server +$B$r;2>H$7$F2<$5$$!#(B +$B%=%1%C%H$,@hF,$K(B '/' $B$r4^$s$G$$$k$H!"(B +.Dv AF_LOCAL +$B%=%1%C%H$H$7$F07$o$l$^$9!#(B +$B%3%m%s$r4^$s$G$$$k$H(B +.Ar host:port +$B$NAH$H$7$F07$o$l!"(B +$B$=$l0J30$OC1$K%m!<%+%k%^%7%s(B (127.0.0.1) $B$N(B TCP $B%]!<%H$r(B +$B;XDj$7$?$b$N$H$_$J$5$l$^$9!#(B +DNS $B8!:w$rHr$1$?$$>l9g$d!"(B +.Pa /etc/services +$BFb$K;XDj$5$l$?%]!<%H$N%(%s%H%j$,$J$$>l9g$K$O!"(B +.Ar host +$B$H(B +.Ar port +$B$K$O?t;z$G;XDj$9$k$3$H$,$G$-$^$9!#(B +.Pp +$B;D$j$N0z?t$O$9$Y$F!"(B +.Nm ppp +$B%G!<%b%s$KAw$i$l$k(B ($BJ#?t$N(B) +.Ar $B%3%^%s%I(B +$B$r7A@.$9$k$?$a$KO"7k$5$l$^$9!#(B +$B%;%_%3%m%sJ8;z$O%3%^%s%I%G%j%_%?$H$7$F07$o$l!"$R$H$D$N(B +.Sq $B%;%C%7%g%s(B +$B$GJ#?t$N(B +.Ar $B%3%^%s%I(B +$B$r;XDj$9$k$3$H$,2DG=$G$9!#(B +$BNc$($P(B: +.Bd -literal -offset indent +pppctl 3000 set timeout 300\\; show timeout +.Ed +.Pp +$B$[$H$s$I$N%7%'%k$G$O(B ';' $B$OFCl9g!"(B +.Nm +$B$O%$%s%?%i%/%F%#%V%b!<%I$K$J$j$^$9!#(B +$B$3$3$G!"%3%^%s%I$OI8=`F~NO$+$iFI$_9~$^$l$^$9!#(B +$B%3%^%s%I$rFI$s$G$$$k;~$K!"(B +.Xr editline 3 +$B$,;H$o$l$F$$$l$P!"(B( +.Xr editrc 5 +$B$G;XDj$7$??6$kIq$$$G(B) +$B9TJT=8$,2DG=$K$J$j$^$9!#(B $BMzNr$NBg$-$5$O%G%U%)%k%H$G$O(B +.Em 20 $B9T(B +$B$G$9!#(B +.Pp +$B0J2<$N%3%^%s%I%i%$%s%*%W%7%g%s$,MxMQ2DG=$G$9(B: .Bl -tag -width Ds .It Fl v .Nm ppp -デーモンに送られたデータ、 +$B%G!<%b%s$KAw$i$l$?%G!<%?!"(B .Nm ppp -デーモンから受け取ったデータをすべて表示します。 -.Nm pppctl -は通常、受け取った non-prompt 行のみ表示します。 +$B%G!<%b%s$+$io!"e$G%G!<%b%s$r@)8f$7$h$&$H$9$k(B +$B>l9g$KI,MW$+$b$7$l$^$;$s!#(B .It Fl p Ar passwd .Nm ppp -デーモンが必要とするパスワードを指定します。 -このスイッチが指定されないと、 +$B%G!<%b%s$,I,MW$H$9$k%Q%9%o!<%I$r;XDj$7$^$9!#(B +$B$3$N%9%$%C%A$,;XDj$5$l$J$$$H!"(B .Nm -は +$B$O(B .Nm ppp -への接続が成功した時にパスワードの入力を促します。 +$B$X$N@\B3$,@.8y$7$?;~$K%Q%9%o!<%I$NF~NO$rB%$7$^$9!#(B .El - -.Sh 使用例 +.Pp +.Sh $B;HMQNc(B .Nm ppp -を +$B$r(B .Fl auto -モードで実行する場合、 +$B%b!<%I$Gl9g!"(B .Nm -は多くの仕事を自動化するのに利用できます。 +$B$OB?$/$N;E;v$r<+F02=$9$k$N$KMxMQ$G$-$^$9(B +($B$b$A$m$s!"$N?M$KFI$a$J$$$h$&$K$J$C$F$$$?$H$7$F$b(B) +$B$*4+$a$G$-$^$;$s!#(B .Pp -.Nm pppctl -と共に利用可能なソケットを -.Nm ppp -が作るようにするためには、ローカルシステムに -パスワードを設定する必要があります。 -.Bd -literal -offset indent -# touch /etc/ppp/ppp.secret -# chown root.wheel /etc/ppp/ppp.secret -# chmod 400 /etc/ppp/ppp.secret -# echo "`hostname -s` MyPassword" >>/etc/ppp/ppp.secret -.Ed -.Pp -簡単で安全に .Nm -へアクセスできるようにしたり、 -.Nm ppp -をいくつも起動した場合にそれらを識別したりする最も安全な方法は、 +$B$X$N4JC1$G0BA4$J%"%/%;%9$rDs6!$9$k$b$C$H$bNI$$J}K!$O!"(B .Pa /etc/ppp/ppp.conf -(の正しいセクション) にローカルサーバソケットを作成することです: - +($B$N@5$7$$%;%/%7%g%s(B) $B$K0J2<$N$h$&$K%m!<%+%k%5!<%P%=%1%C%H$r:n@.$9$k$3$H$G$9(B: .Bd -literal -offset indent -set server /var/run/internet 0666 +set server /var/run/internet "" 0177 .Ed - -これはデフォルトで作られる tcp ソケットではなく、 -ローカルドメインソケットを作成するように -.Nm ppp -に指示します。より詳しい解説はマニュアルページ -.Xr ppp 8 -を参照してください。 - .Pp -このようにするといくつかのお気楽スクリプトが作成可能になります。 -インターネットに接続するには: - +$B$3$l$O!"(B +.Nm ppp +$B$r\$7$$2r@b$O%^%K%e%"%k%Z!<%8(B +.Xr ppp 8 +$B$r;2>H$7$F$/$@$5$$!#(B +.Pp +$B$3$N$h$&$K$9$k$H$$$/$D$+$N$*5$3Z%9%/%j%W%H$,:n@.2DG=$K$J$j$^$9!#(B +$B%$%s%?!<%M%C%H$K@\B3$9$k$K$O(B: .Bd -literal -offset indent #! /bin/sh test $# -eq 0 && time=300 || time=$1 -exec pppctl -t 60 /var/run/internet set timeout $time\\; dial +exec pppctl /var/run/internet set timeout $time\\; dial .Ed - .Pp -切断するには: +$B@ZCG$9$k$K$O(B: .Bd -literal -offset indent #! /bin/sh exec pppctl /var/run/internet set timeout 300\\; close .Ed - .Pp -接続されているかどうか確かめるには: +$B@\B3$5$l$F$$$k$+$I$&$+3N$+$a$k$K$O(B: .Bd -literal -offset indent #! /bin/sh -pppctl -p '' -v /var/run/internet '' | grep ^PPP >/dev/null +pppctl -p '' -v /var/run/internet quit | grep ^PPP >/dev/null if [ $? -eq 0 ]; then echo Link is up else echo Link is down fi .Ed - .Pp -このような汎用スクリプトも作成可能です: +$B$3$N$h$&$JHFMQ%9%/%j%W%H$b:n@.2DG=$G$9(B: .Bd -literal -offset indent #! /bin/sh exec pppctl /var/run/internet "$@" .Ed - -.Sh 関連項目 +.Pp +.Sh $B4D6-JQ?t(B +$B0J2<$N4D6-JQ?t$,!"%$%s%?%i%/%F%#%V%b!<%ICf$N(B +.Nm +$B$K$h$C$FM}2r$5$l$^$9(B: +.Bl -tag -width XXXXXXXXXX +.It Dv EL_SIZE +$BMzNr9T$N?t$G$9!#%G%U%)%k%H$G$O(B 20 $B$G$9!#(B +.It Dv EL_EDITOR +$BJT=8%b!<%I$G$9!#(B "emacs" $B$b$7$/$O(B "vi" $B$@$1$,$NCM$OL5;k$7$^$9!#$3$N4D6-JQ?t$O(B +.Pa ~/.editrc +$B$N(B +.Ar bind -v +$B$d(B +.Ar bind -e +$B$G>e=q$-$5$l$^$9!#(B +.El +.Pp +.Sh $B4XO"9`L\(B +.Xr editline 3 , +.Xr editrc 5 , .Xr ppp 8 , +.Xr ps 1 , .Xr services 5 -.Sh 歴史 +.Sh $BNr;K(B .Nm -コマンドは FreeBSD 2.2.5 で最初に登場しました。 +$B%3%^%s%I$O(B FreeBSD 2.2.5 $B$G:G=i$KEP>l$7$^$7$?!#(B diff --git a/ja_JP.eucJP/man/man8/pw.8 b/ja_JP.eucJP/man/man8/pw.8 index 40566438c3..cd04d2b0a7 100644 --- a/ja_JP.eucJP/man/man8/pw.8 +++ b/ja_JP.eucJP/man/man8/pw.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: pw.8,v 1.1.1.1.2.4 1997/10/14 06:38:56 charnier Exp % +.\" %Id: pw.8,v 1.1.1.1.2.5 1997/11/04 07:16:14 charnier Exp % .\" jpman %Id: pw.8,v 1.3 1997/10/28 15:30:48 kuriyama Stab % .\" .Dd December 9, 1996 @@ -788,10 +788,10 @@ pw .Xr chpass 1 , .Xr passwd 1 , .Xr group 5 , +.Xr login.conf 5 , .Xr passwd 5 , .Xr pw.conf 5 , .Xr pwd_mkdb 8 , -.Xr login.conf 5 , .Xr vipw 8 .Sh 歴史 .Nm diff --git a/ja_JP.eucJP/man/man8/rbootd.8 b/ja_JP.eucJP/man/man8/rbootd.8 index 323154f924..7b51bc5b55 100644 --- a/ja_JP.eucJP/man/man8/rbootd.8 +++ b/ja_JP.eucJP/man/man8/rbootd.8 @@ -38,7 +38,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rbootd.8 8.2 (Berkeley) 12/11/93 -.\" %Id: rbootd.8,v 1.3 1996/09/22 21:54:30 wosch Exp % +.\" %Id: rbootd.8,v 1.3.2.1 1997/12/16 07:17:43 charnier Exp % .\" .\" Utah $Hdr: rbootd.man 3.1 92/07/06$ .\" Author: Jeff Forys, University of Utah CSS @@ -56,29 +56,29 @@ .Op Fl i Ar interface .Op config_file .Sh 解説 -.Nm rbootd +.Nm ユーティリティは、LAN 上の Hewlett-Packard 社製ワークステーションからの ブート要求に対するサービスを行います。 全てのブートファイルはブートファイル用のディレクトリになければならず、 さらに、もしクライアントがブートリクエスト中にパス情報をつけていた場合は、 処理する前にそのパスは取り除かれます。デフォルトでは、 -.Nm rbootd +.Nm は, そのコンフィグレーションファイル中にリストされているマシンからの リクエストにのみ応答します。 .Pp オプションとしては以下のものがあります: -.Bl -tag -width Fl +.Bl -tag -width indent .It Fl a どのようなマシンからのブート要求にも応えます。このオプションが設定された 場合は、コンフィギュレーションファイルは無視されます。 .It Fl d -.Nm rbootd +.Nm をデバッグモードで起動します。受信および送信 されたパケットが端末に表示されるようになります。 .It Fl i Ar interface 指定したインタフェースに対してサービスを行います。 もし指定されていない場合には、 -.Nm rbootd +.Nm はループバック以外のもっとも小さい番号の使用可能なインタフェースを システムインタフェースリストから探します。 早いもの順で選ぶので、組合せはバラバラになります。 @@ -86,7 +86,7 @@ .Pp .Ar config_file を指定すれば、 -.Nm rbootd +.Nm はデフォルトのコンフィギュレーションファイルではなく、こちらのファイルを 使用するようになります。 .Pp @@ -110,12 +110,12 @@ Ethernet .It 8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either) .El .Pp -.Nm rbootd +.Nm のログやエラーメッセージは .Xr syslog 3 を使っています。スタートアップメッセージはつねにログに記録され、 致命的なエラー(もしくは -.Nm rbootd +.Nm を殺すようなシグナル) が起こった場合にはサーバの終了メッセージもログに残します。 一般的には、致命的ではないエラーはそれによってひき起こされる動作を @@ -146,7 +146,7 @@ Ethernet .It /usr/mdec/rbootd ブートファイルを置くディレクトリ .It /var/run/rbootd.pid -.Nm rbootd +.Nm のプロセス ID .El .Sh 関連項目 diff --git a/ja_JP.eucJP/man/man8/revnetgroup.8 b/ja_JP.eucJP/man/man8/revnetgroup.8 index 50a1e2a7c9..069f559a00 100644 --- a/ja_JP.eucJP/man/man8/revnetgroup.8 +++ b/ja_JP.eucJP/man/man8/revnetgroup.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: revnetgroup.8,v 1.1.1.1 1995/10/26 16:25:29 wpaul Exp % +.\" %Id: revnetgroup.8,v 1.1.1.1.2.1 1997/12/16 07:20:16 charnier Exp % .\" jpman %Id: revnetgroup.8,v 1.2 1997/06/14 16:12:45 horikawa Stab % .\" .Dd October 24, 1995 @@ -40,6 +40,8 @@ .Sh 書式 .Nm revnetgroup .Fl u +.Op Fl f Ar netgroup_file +.Nm revnetgroup .Fl h .Op Fl f Ar netgroup_file .Sh 解説 @@ -54,25 +56,27 @@ 逆ネットグループフォーマットでは、 あるメンバが属するグループを示します。 この情報は -.Nm netgroup.byuser +.Pa netgroup.byuser と -.Nm netgroup.byhosts -の NIS マップを作成するために使用します。 +.Pa netgroup.byhosts +の +.Tn NIS +マップを作成するために使用します。 これらの逆ネットグループマップは、ネットグループの参照、 特に .Fn innetgr ライブラリ関数を高速化するために使用されます。 .Pp 例えば、標準の -.Nm /etc/netgroup +.Pa /etc/netgroup ファイルはネットグループとそのメンバリストを列挙します。 ここで、ネットグループは -.Pa キー +.Em キー であるとし、メンバ名を -.Pa データ +.Em データ であるとします。 これに対し、逆の -.Nm netgroup.byusers +.Pa netgroup.byusers データベースは、ユニークなメンバをキーとし、 メンバが属するネットグループをデータとします。 ユーザとホストに属する情報を保持する別々のデータベースを作成します; @@ -80,56 +84,65 @@ 独立のキー空間にて実行されます。 .Pp あらかじめ逆ネットグループデータベース -(およびこれに対応する NIS マップ)を構築することにより、 +(およびこれに対応する +.Tn NIS +マップ)を構築することにより、 要求ごとに .Xr getnetgrent 3 ライブラリ関数が依存関係を処理しなくても良くなります。 これは、ユーザ数及びホスト数が多いネットワークでは重要です。 なぜなら、巨大なネットグループデータベースの処理は多大な時間を要するからです。 .Pp -.Nm revnetgroup +.Nm コマンドは結果を標準出力に表示します。 通常は -.Nm /var/yp/Makefile +.Pa /var/yp/Makefile から呼ばれるだけであり、 -これは NIS ネットグループマップを構築する時です。 +これは +.Tn NIS +ネットグループマップを構築する時です。 .Pp .Sh オプション -.Nm revnetgroup +.Nm コマンドは以下のオプションをサポートします: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl u -netgroup.byuser を生成します; +.Pa netgroup.byuser +を生成します; 元のネットグループファイルのユーザ名情報のみが処理されます。 .It Fl h -netgroup.byhost を生成します; +.Pa netgroup.byhost +を生成します; 元のネットグループファイルのホスト名情報のみが処理されます。( .Fl u か .Fl h のいずれかを指定する必要が有ります。) .It Op Fl f Ar netgroup_file -.Nm revnetgroup +.Nm コマンドは -.Nm /etc/netgroup +.Pa /etc/netgroup をデフォルトの入力ファイルとします。 .Fl f フラグにて、ユーザは別の入力ファイルを指定できます。``-'' を 入力ファイルとして指定すると、 -.Nm revnetgroup +.Nm は標準入力を読みます。 .El .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -NIS データベースを構築するために +.Tn NIS +データベースを構築するために .Nm yp_mkdb と .Nm revnetgroup を呼び出す Makefile。 .It Pa /etc/netgroup デフォルトのネットグループデータベースファイル。 -ほとんどの場合、NIS マスタサーバにだけ有ります。 +ほとんどの場合、 +.Tn NIS +マスタサーバにだけ有ります。 .El .Sh 関連項目 .Xr yp 4 , @@ -137,4 +150,4 @@ NIS .Xr yp_mkdb 8 , .Xr getnetgrent 3 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/rexecd.8 b/ja_JP.eucJP/man/man8/rexecd.8 index edcf701df2..7aaf912cf2 100644 --- a/ja_JP.eucJP/man/man8/rexecd.8 +++ b/ja_JP.eucJP/man/man8/rexecd.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" @(#)rexecd.8 8.2 (Berkeley) 12/11/93 +.\" %Id: rexecd.8,v 1.3.2.3 1997/12/16 07:22:06 charnier Exp % .\" jpman %Id: rexecd.8,v 1.2 1997/05/28 07:05:49 yugawa Stab % -.\" %Id: rexecd.8,v 1.3.2.2 1996/11/23 08:25:35 phk Exp % .\" .Dd September 23, 1994 .Dt REXECD 8 @@ -42,14 +42,14 @@ .Sh 書式 .Nm rexecd .Sh 解説 -.Nm rexecd +.Nm は、 .Xr rexec 3 ルーチンのためのサーバです。本サーバは、ユーザ名と パスワードに基づいたユーザ認証による、リモートプロセス実行の環境 を提供します。 .Pp -.Nm rexecd +.Nm は、 .Xr services 5 にて ``exec'' サービスが定義されたポートを @@ -78,7 +78,7 @@ NUL されます。コマンドの長さは、システムの引数リストの制限を越えない長さに 制限されます。 .It -.Nm rexecd +.Nm は、次に、ログイン時と同様にユーザの認証を行い、 ユーザ認証が成功した場合、 カレントディレクトリを当該ユーザのホームディレクトリに変更し、 @@ -87,18 +87,22 @@ NUL .It NUL 文字が最初のソケットに返却され、コマンドラインは当該ユーザの 通常のログインシェルに渡されます。シェルは -.Nm rexecd +.Nm によって確立されたネットワークコネクションを継承します。 .El .Sh 警告 -.Nm rexecd -は root のログイン、/etc/ftpusers にリストされたユーザでのアクセス、 +.Nm +は root のログイン、 +.Pa /etc/ftpusers +にリストされたユーザでのアクセス、 パスワードの無いユーザのアクセスを許可しません。 これらはすべて重大なセキュリティホールでした。 rexec/rexecd のコンセプトは、メジャーなセキュリティホールと、それをさせない ための例です。 -.Nm rexecd -は /etc/inetd.conf ではデフォルトで無効になっています。 +.Nm +は +.Pa /etc/inetd.conf +ではデフォルトで無効になっています。 .Sh 診断 以下のリストの一番最後のものを除き、全ての診断メッセージは、 他のネットワークコネクションが切断された後に、最初の socket を経由して返却 @@ -123,7 +127,7 @@ rexec/rexecd コマンドが失敗しました。 .It Sy Try again. サーバによる -.Xr fork +.Xr fork 2 が失敗しました。 .It Sy : ... ユーザのログインシェルが起動できませんでした。このメッセージは diff --git a/ja_JP.eucJP/man/man8/rlogind.8 b/ja_JP.eucJP/man/man8/rlogind.8 index d0149428c0..228f16d921 100644 --- a/ja_JP.eucJP/man/man8/rlogind.8 +++ b/ja_JP.eucJP/man/man8/rlogind.8 @@ -30,8 +30,8 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rlogind.8 8.1 (Berkeley) 6/4/93 +.\" %Id: rlogind.8,v 1.4.2.3 1998/02/18 11:48:06 markm Exp % .\" jpman %Id: rlogind.8,v 1.2 1997/05/23 00:50:03 mutoh Stab % -.\" %Id: rlogind.8,v 1.4.2.1 1996/12/22 23:05:33 mpp Exp % .\" .Dd June 4, 1993 .Dt RLOGIND 8 @@ -40,17 +40,17 @@ .Nm rlogind .Nd リモートログインのサーバ .Sh 書式 -.Nm rlogind +.Nm .Op Fl Daln .Sh 解説 -.Nm rlogind +.Nm は、 .Xr rlogin 1 のためのサーバです。サーバは信頼できるホストからの 特権ポート番号に基づいた認証を用いて、リモートログイン機能を提供します。 -.Nm rlogind +.Nm では、以下のオプションが使用可能です。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl D TCP_NODELAY ソケットオプションを設定します。これは、いくつかの ネットワークトラフィックの増大に対して、応答性を向上します。 @@ -66,20 +66,21 @@ TCP_NODELAY .El .Pp Kerberos を使っている時には、以下のようなオプションが利用可能です。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl k Kerberos 認証を利用可能にします。 .It Fl v vacuous モードを利用可能にします。 .It Fl x -.Nm rlogin +.Xr rlogin 1 セッションで流される全てのデータに .Tn DES 暗号化を施します。このオプションを利用すると、応答性や CPU に負荷が かかりますが、機密性は向上します。 .El .Pp -rlogind は、 login サービスの仕様に基づく番号のポートで、要求を受け付けます。 +.Nm +は、``login'' サービスの仕様に基づく番号のポートで、要求を受け付けます。 詳しくは .Xr services 5 を参照してください。 @@ -107,7 +108,7 @@ rlogind .El .Pp 要求元ポートの番号を調べ終えたら、 -.Nm rlogind +.Nm は、 .Xr rshd 8 で説明している認証作業を開始します。 @@ -131,7 +132,7 @@ rlogind .Pp ログインプロセスの親プロセスは、疑似ターミナルのマスター側を操作します。 すなわちログインプロセスと、クライアント側の -.Xr rlogin +.Xr rlogin 1 プログラムを実体化したものとの間で処理を行います。 通常の処理においては、 .Ql ^S/^Q @@ -155,12 +156,16 @@ rlogind 通信不能になってしまった時に、セッションをタイムアウトで 終了することが可能になります。 .Sh 診断 -すべての診断メッセージは、ネットワーク接続が切断された後に、最初に 1 の値が -付加されて通知されます。ログインが起動された後にエラーが発生しない場合、 +すべての診断メッセージは、ネットワーク接続が切断された後に、最初に 1 の値 +のバイトが付加されて通知されます。 +.Xr login 1 +が起動された後にエラーが発生しない場合、 処理成功の通知のために、NULL バイトを返します。 .Bl -tag -width Ds .It Sy Try again. -サーバが fork に失敗したことを表します。 +サーバが +.Xr fork 2 +に失敗したことを表します。 .El .Sh 関連項目 .Xr login 1 , @@ -178,7 +183,7 @@ rlogind .Sh バグ このコマンドが用いている認証手続きは、それぞれのクライアントマシンと 接続媒体が完全であるということを仮定したものです。これはセキュリティホールに -なりやすいのですが、「オープン」な環境においては有用な方針です。 +なりやすいのですが、``オープン'' な環境においては有用な方針です。 .Pp 全てのデータについて暗号化を行なう機能が実装されるべきです。 .Pp diff --git a/ja_JP.eucJP/man/man8/rpc.rquotad.8 b/ja_JP.eucJP/man/man8/rpc.rquotad.8 index 4d09183fb7..dce03b7195 100644 --- a/ja_JP.eucJP/man/man8/rpc.rquotad.8 +++ b/ja_JP.eucJP/man/man8/rpc.rquotad.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: rpc.rquotad.8,v 1.1.1.1.2.1 1997/03/14 06:10:09 mpp Exp % +.\" %Id: rpc.rquotad.8,v 1.1.1.1.2.2 1997/12/17 07:31:27 charnier Exp % .\" jpman %Id: rpc.rquotad.8,v 1.3 1997/09/04 17:40:03 horikawa Stab % .\" .Dd June 22, 1994 @@ -39,7 +39,7 @@ .Sh 書式 .Nm /usr/libexec/rpc.rquotad .Sh 解説 -.Nm rpc.rquotad +.Nm は、リモートマシンへ NFS マウントされているファイルシステムについて ユーザに対するローカルマシンでの割り当て制限値を返す .Xr rpc 3 @@ -47,18 +47,20 @@ .Xr quota 1 は、リモートファイルシステムの割り 当て制限値を表示するために本サーバを用います。 -.Nm rpc.rquotad +.Nm は通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rquotad +.Nm .Pa /usr/include/rpcsvc/rquota.x -で定義される RPC プロトコルを使用します。 +で定義される +.Tn RPC +プロトコルを使用します。 .Sh バグ .Bx 4.4 と -.Tn FreeBSD +.Bx Free はグループに対する割り当て制限をサポートしていますが、 rqutoa プロトコルはこれをサポートしていません。 .Sh 関連項目 diff --git a/ja_JP.eucJP/man/man8/rpc.rstatd.8 b/ja_JP.eucJP/man/man8/rpc.rstatd.8 index f7194242f7..e34c1dd854 100644 --- a/ja_JP.eucJP/man/man8/rpc.rstatd.8 +++ b/ja_JP.eucJP/man/man8/rpc.rstatd.8 @@ -31,10 +31,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rstatd.8,v 1.1.1.1 1994/08/28 14:49:04 csgr Exp % +.\" %Id: rpc.rstatd.8,v 1.1.1.1.8.1 1997/12/17 07:33:09 charnier Exp % .\" -.Dd June 7, 1993 .\" jpman %Id: rpc.rstatd.8,v 1.2 1997/05/22 08:05:12 mitchy Stab % +.Dd June 7, 1993 .Dt RPC.RSTATD 8 .Os BSD 4.3 .Sh 名称 @@ -43,21 +43,22 @@ .Sh 書式 .Nm /usr/libexec/rpc.rstatd .Sh 解説 -.Nm rpc.rstatd +.Nm はカーネルから性能統計を取得するサーバーです。 この統計は、 .Xr rup 1 コマンドを使って読むことができます。 -.Nm rpc.rstatd +.Nm デーモンは通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rstatd +.Nm は .Pa /usr/include/rpcsvc/rstat.x -で定義された RPC プロトコルを使用します。 +で定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rup 1 , .Xr inetd 8 - diff --git a/ja_JP.eucJP/man/man8/rpc.rusersd.8 b/ja_JP.eucJP/man/man8/rpc.rusersd.8 index 0a52dad0bc..0421c53187 100644 --- a/ja_JP.eucJP/man/man8/rpc.rusersd.8 +++ b/ja_JP.eucJP/man/man8/rpc.rusersd.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rusersd.8,v 1.1.1.1 1994/08/28 14:53:44 csgr Exp % +.\" %Id: rpc.rusersd.8,v 1.1.1.1.8.1 1997/12/17 07:34:41 charnier Exp % .\" jpman %Id: rpc.rusersd.8,v 1.2 1997/05/22 08:10:18 mitchy Stab % .\" .Dd June 7, 1993 @@ -43,22 +43,24 @@ .Sh 書式 .Nm /usr/libexec/rpc.rusersd .Sh 解説 -.Nm rpc.rusersd +.Nm は、システムに現在ログインしているユーザに関する情報を 返すサーバです。 .Pp 現在ログインしているユーザについて、 .Xr rusers 1 を用いることで問い合わせることが出来ます。 -.Nm rpc.rusersd +.Nm デーモンは、通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rusersd +.Nm は、 .Pa /usr/include/rpcsvc/rnusers.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rusers 1 , .Xr who 1 , diff --git a/ja_JP.eucJP/man/man8/rpc.rwalld.8 b/ja_JP.eucJP/man/man8/rpc.rwalld.8 index 7f63f2f875..26d348165d 100644 --- a/ja_JP.eucJP/man/man8/rpc.rwalld.8 +++ b/ja_JP.eucJP/man/man8/rpc.rwalld.8 @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.rwalld.8,v 1.1.1.1 1994/08/28 14:58:36 csgr Exp % +.\" %Id: rpc.rwalld.8,v 1.1.1.1.8.1 1997/12/17 07:36:28 charnier Exp % .\" jpman %Id: rpc.rwalld.8,v 1.2 1997/05/22 08:15:10 mitchy Stab % .\" .Dd June 7, 1993 @@ -42,25 +42,38 @@ .Nd ログインしているユーザにメッセージを送るためのサーバ .Sh 書式 .Nm /usr/libexec/rpc.rwalld +.Op Fl n .Sh 解説 -.Nm rpc.rwalld +.Nm は、システムにログインしている全てのユーザに対して メッセージを送るためのサーバです。本サーバは .Xr wall 1 を起動し、メッセージの送信を行ないます。 .Pp +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl n +デーモンになりません。 +.Nm +が +.Xr inetd 8 +から起動された場合のみ、本オプションを使用可能です。 +.El +.Pp メッセージは、 .Xr rwall 1 コマンドを用いて本サーバに送信されます。 -.Nm rpc.walld +.Nm デーモンは、通常は .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.rwalld +.Nm は、 .Pa /usr/include/rpcsvc/rwall.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr rwall 1 , .Xr wall 1 , diff --git a/ja_JP.eucJP/man/man8/rpc.sprayd.8 b/ja_JP.eucJP/man/man8/rpc.sprayd.8 index ba23cbafee..f55f880378 100644 --- a/ja_JP.eucJP/man/man8/rpc.sprayd.8 +++ b/ja_JP.eucJP/man/man8/rpc.sprayd.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %Id: rpc.sprayd.8,v 1.2 1996/04/07 00:05:54 mpp Exp % +.\" %Id: rpc.sprayd.8,v 1.2.2.1 1997/12/17 07:38:17 charnier Exp % .\" jpman %Id: rpc.sprayd.8,v 1.3 1997/09/04 17:42:05 horikawa Stab % .\" .Dd June 22, 1994 @@ -39,19 +39,21 @@ .Sh 書式 .Nm /usr/libexec/rpc.sprayd .Sh 解説 -.Nm rpc.sprayd +.Nm は、 .Xr spray 8 コマンドによって送出されたパケットを記録し、パケットの送出者に ネットワークトラフィックの情報を送信するサーバです。 -.Nm rpc.sprayd +.Nm は、通常 .Xr inetd 8 から起動されます。 .Pp -.Nm rpc.sprayd +.Nm は、 .Pa /usr/include/rpcsvc/spray.x -に定義された RPC プロトコルを使用します。 +に定義された +.Tn RPC +プロトコルを使用します。 .Sh 関連項目 .Xr spray 8 diff --git a/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 b/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 index 2c0c3f4b66..6e83ed91f9 100644 --- a/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 +++ b/ja_JP.eucJP/man/man8/rpc.yppasswdd.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: rpc.yppasswdd.8,v 1.4.2.1 1997/03/06 08:00:02 mpp Exp % +.\" %Id: rpc.yppasswdd.8,v 1.4.2.2 1997/11/05 07:37:00 charnier Exp % .\" jpman %Id: rpc.yppasswdd.8,v 1.3 1997/08/31 14:17:34 horikawa Stab % .\" .Dd February 8, 1996 @@ -51,14 +51,14 @@ .Op Fl u .Op Fl h .Sh 解説 -.Nm rpc.yppasswdd +.Nm デーモンは、ユーザが .Xr yppasswd 1 と .Xr ypchpass 1 コマンド使うことで、 NIS パスワードおよび他の情報を変更することを許します。 -.Nm rpc.yppasswdd +.Nm は、パスワードの変更要求を受け入れ、その認証を行い、 .Pa /var/yp/master.passwd ファイル中に更新された情報を配置し、 @@ -68,7 +68,7 @@ NIS .Pa passwd マップを更新する、 RPC を使ったサーバです。 .Pp -.Nm rpc.yppasswdd +.Nm は、普通の NIS ユーザが、自分の NIS パスワード・ ('GECOS'フィールドとして知られている)フルネーム・シェルを変更することを許します。 これらの更新は、典型的には @@ -86,7 +86,7 @@ NIS 規則 (securenets に関する詳細な情報は .Xr ypserv 8 のマニュアルページを参照してください。 -.Nm rpc.yppasswdd +.Nm サーバは、 .Xr ypserv 8 と同じアクセス制御機構を使います。)に照らして、 @@ -106,8 +106,9 @@ NIS .Pa /var/yp/Makefile に渡されます。) .Pp -FreeBSD 版の -.Nm rpc.yppasswdd +.Bx Free +版の +.Nm は、NIS マスタサーバ上のスーパユーザが NIS パスワードマップを更新するための より洗練された方法を提供します。スーパユーザは任意のドメインの 任意のユーザの master.passwd エントリの任意のフィールドを変更できます。 @@ -121,17 +122,15 @@ FreeBSD また、これは、 NIS マスタサーバ上のスーパユーザだけに適用されます。 これらの特別な機能はネットワークを介しては提供されません。 .Pp -.Nm rpc.yppasswdd +.Nm デーモンは、 NIS マスタサーバである機械上でだけ実行することが できます。 .Sh オプション -以下のオプションとフラグが、 -.Nm rpc.yppasswdd -で提供されています。 -.Bl -tag -width flag +以下のオプションが使用可能です: +.Bl -tag -width indent .It Fl t Ar master.passwd template file デフォルトでは、 -.Nm rpc.yppasswdd +.Nm は、デフォルトドメインの .Pa master.passwd と @@ -145,13 +144,13 @@ FreeBSD (注意): このフラグとともに指定されたテンプレートファイルが .Pa /etc/master.passwd である場合、 -.Nm rpc.yppasswdd +.Nm は NIS のマップに加えてローカルのパスワードデータベースを 再構成するために、自動的に .Xr pwd_mkdb 8 を呼び出します。 .It Fl d Ar domain -.Nm rpc.yppasswdd +.Nm サーバは複数のドメインを扱うことができますが、一つのドメインを デフォルトとして選ばなければなりません。 .Xr domainname 1 @@ -178,7 +177,7 @@ NIS .Pa master.passwd マップエントリのどんなフィールドでも、無制限の変更を行うことが 許されています。 -.Nm rpc.yppasswdd +.Nm がこのフラグを付けて実行された場合、 .Xr chpass 1 を使用したローカルパスワードデータベース更新にて可能であるのと同様に、 @@ -187,11 +186,12 @@ NIS マルチドメインモードを有効にします。 .Xr ypserv 8 は同時にいくつかのドメインを扱うことができますが、ほとんどの -.Nm rpc.yppasswdd +.Nm 実装では、一つの NIS ドメインだけしか扱うことができません。 これは、一般に NIS マスタサーバのシステムデフォルトドメインと同じです。 -FreeBSD の -.Nm rpc.yppasswdd +.Bx Free +の +.Nm は、 .Pa yppasswd プロトコルでは @@ -200,7 +200,7 @@ FreeBSD プロトコル固有の制限にもかかわらず、 この問題を解決しようとしています。 マルチドメインモードでは、 -.Nm rpc.yppasswdd +.Nm は .Pa /var/yp 下の全ドメインの全パスワードマップを検索し、 @@ -237,7 +237,7 @@ FreeBSD したがって、偏執的な管理者はマルチドメインモードを利用不可能にしたいと 思うでしょう。 .It Fl i -.Nm rpc.yppasswdd +.Nm がこのフラグ付きで呼び出された場合、マップ更新をその場で行おうとします。 この意味は、 パスワードテンプレートファイルを直接更新してマップ更新する代わりに、 @@ -258,7 +258,7 @@ FreeBSD たくさんの商用の .Xr yppasswd 1 クライアントは、 -.Nm rpc.yppasswdd +.Nm への要求を送る時に予約ポートを使いません。 これは、 .Xr yppasswd 1 @@ -266,27 +266,27 @@ FreeBSD スーパユーザのためにクライアント接続が確立されたとき、 予約ポートを割り当てることをしないようになっているためです。 デフォルトでは、 -.Nm rpc.yppasswdd +.Nm は、クライアントからの結果を予約ポートを使って受け取ることを期待します。 非特権ポートから受け取った要求は、排除されます。不幸にして、この振舞いは 特権ポートを使えないクライアントシステムからのパスワード更新要求を妨げます。 .Fl u フラグを指定することで、 -.Nm rpc.yppasswdd +.Nm は、特権ポートを使えない .Xr yppasswd 1 でも働くように、特権ポートのチェックを無効にします。 これは、少しセキュリティを低下させますが、クライアントの振舞いを 変更できない場合には必要になるでしょう。 .It Fl h -.Nm rpc.yppasswdd +.Nm が理解できるフラグやオプションのリストを表示します。 .El .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /usr/libexec/yppwupdate NIS マップを更新し、その後でプッシュするために、 -.Nm rpc.yppasswdd +.Nm によって呼び出されるスクリプトです。 .It Pa /var/yp/master.passwd デフォルトドメインのためのテンプレートパスワードファイルです。 @@ -306,7 +306,7 @@ yppasswd.x YPPASSWDPROC_UPDATE プロシジャは二つの引数を取ります。 更新するユーザ情報を含む V7 形式のパスワード構造および、 ユーザの暗号化されない (クリアテキスト) パスワードです。 -.Nm rpc.yppasswdd +.Nm はリモートの NIS クライアントマシンからの更新要求を扱うことを 仮定しています。これは、 .Xr yppasswd 1 @@ -323,4 +323,4 @@ YPPASSWDPROC_UPDATE 途中でとらえられ、 そのユーザアカウントに対する不正アクセスに使用されるかも知れません。 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/rshd.8 b/ja_JP.eucJP/man/man8/rshd.8 index 84130eb419..bd52178f20 100644 --- a/ja_JP.eucJP/man/man8/rshd.8 +++ b/ja_JP.eucJP/man/man8/rshd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: rshd.8,v 1.4.2.1 1997/05/10 21:41:51 davidn Exp % +.\" %Id: rshd.8,v 1.4.2.3 1998/02/18 11:52:19 markm Exp % .\" jpman %Id: rshd.8,v 1.4 1997/08/10 18:35:56 horikawa Stab % .\" .Dd June 4, 1993 @@ -43,17 +43,17 @@ .Nm rshd .Op Fl alnL .Sh 解説 -.Nm rshd +.Nm は、 .Xr rcmd 3 ルーチンのためのサーバであり、結果として .Xr rsh 1 の実行のために必要となるサーバです。 -.Nm rshd +.Nm は、信頼できるホストからの特権ポート番号に基づいた 認証を行なうことによって、プログラムのリモート実行機能を提供します。 .Pp -.Nm rshd +.Nm サーバは、``cmd'' サービスに割り当てられたポート ( .Xr services 5 参照) でサービス要求を受け付けます。サービス要求を受信すると、 @@ -64,7 +64,9 @@ 要求元ポート番号 が 512 から 1023 の範囲にない場合、サーバは接続を強制切断します。 .It -サーバは、ソケットからヌルバイト (`\e0') を検出するまで文字を読みます。 +サーバは、ソケットから +.Tn ヌル +バイト (`\e0') を検出するまで文字を読みます。 受信文字列は、 .Tn ASCII コードによる 10 進数の数値に変換します。 @@ -105,7 +107,7 @@ コマンドを取得します。コマンド長の制限は、システムの引数リスト サイズの上限に依存します。 .It -.Nm rshd +.Nm は、 .Pa /etc/hosts.equiv および当該ユーザのホームディレクトリ上に存在する @@ -114,22 +116,29 @@ .Xr ruserok 3 を使用して、ユーザ認証を行います。 .Fl l -オプションは、ユーザがスーパユーザでない限り、``.rhosts'' ファイルに基づいた +オプションは、ユーザがスーパユーザでない限り、 +.Pa .rhosts +ファイルに基づいた .Xr ruserok 3 のすべての認証をおこなわないようにします。 .It .Pa /etc/nologin ファイルが存在し、ユーザがスーパユーザでない場合、接続を 切断します。 -nologin ファイルの名前に関しては、login.conf にて -ローカルユーザのログインクラスに関する nologin= ケーパビリティが優先します。 +nologin ファイルの名前に関しては、 +.Pa login.conf +にて +ローカルユーザのログインクラスに関する nologin ケーパビリティが優先します。 ログインクラスは、ログイン時間(times.allow と times.denny ケーパビリティ) およびリモートホスト(hosts.allow と hosts.denny ケーパビリティ)による -rsh アクセスの制限にも使われます。 +.Xr rsh 1 +アクセスの制限にも使われます。 .It -最初のソケットを用いてヌルバイトを返し、コマンドライン +最初のソケットを用いて +.Tn ヌル +バイトを返し、コマンドライン を、ユーザの通常のログインシェルに渡します。シェルは -.Nm rshd +.Nm によって確立されたネットワーク接続を継承します。 .El .Pp @@ -157,26 +166,28 @@ rsh クライアントマシン上のユーザ名が、16 文字を超えています。 .It Sy Ruser too long. リモートマシン上のユーザ名が、16 文字を超えています。 -.It Sy Command too long . +.It Sy Command too long. 渡されたコマンドラインの長さが、引数リストの大きさを超えています (システムに依存します)。 .It Sy Login incorrect. -当該ユーザに関するエントリが、パスワードファイルに登録されていません。 +当該ユーザに関するエントリが、パスワードファイルに登録されていないか、 +上述の認証手続きに失敗しました。 .It Sy Remote directory. ホームディレクトリへの -.Xr chdir -コマンドが失敗しました。 -.It Sy Permission denied. -前述の認証手続きが失敗しました。 +.Xr chdir 2 +巻数が失敗しました。 .It Sy Logins not available right now. -ローカルユーザのログインクラスに対する login.conf において、 -許された時間以外で rsh が試されました。 +ローカルユーザのログインクラスに対する +.Pa login.conf +において、許された時間以外で +.Xr rsh 1 +が試されました。 .It Sy Can't make pipe. .Em 標準エラー出力 に必要なパイプを作成できませんでした。 .It Sy Can't fork; try again. サーバによる -.Xr fork +.Xr fork 2 が失敗しました。 .It Sy : ... ユーザのログインシェルを起動できませんでした。本メッセージの出力は @@ -201,6 +212,7 @@ rsh .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .It Pa /etc/hosts.equiv +.It Pa /etc/login.conf .It Pa $HOME/.rhosts .It Pa /etc/nologin .El diff --git a/ja_JP.eucJP/man/man8/rstat_svc.8 b/ja_JP.eucJP/man/man8/rstat_svc.8 index 3ff2207b9e..63c4caea02 100644 --- a/ja_JP.eucJP/man/man8/rstat_svc.8 +++ b/ja_JP.eucJP/man/man8/rstat_svc.8 @@ -10,7 +10,7 @@ rstat_svc \- .B rstat_svc は、 カーネルから得られた性能統計を返すサーバです。 -これらの統計値はサン・マイクロシステムズのプログラム、 +これらの統計値は Sun Microsystems のプログラム、 .BR perfmeter (1) によってグラフで表示されます。 .B rstat_svc diff --git a/ja_JP.eucJP/man/man8/shutdown.8 b/ja_JP.eucJP/man/man8/shutdown.8 index 85c8681fd6..72eb1ce1ec 100644 --- a/ja_JP.eucJP/man/man8/shutdown.8 +++ b/ja_JP.eucJP/man/man8/shutdown.8 @@ -37,7 +37,7 @@ .Os BSD 4 .Sh 名称 .Nm shutdown -.Nd 指定時間後にシステムを停止する +.Nd 指定時刻にシステムを停止する .Sh 書式 .Nm shutdown .Op Fl @@ -46,11 +46,12 @@ .Op Ar warning-message ... .Sh 解説 .Nm shutdown -は、ユーザにシステムがシャットダウンされる時にユーザに知らせ、 -システム管理者やハッカーやグルのようなたの人を面倒がらせないように -します。 +は、自動的にシャットダウンするための手順をスーパユーザに提供します。 +システムがシャットダウンされるときユーザに知らせるので、 +こういったお知せを面倒がって行なわない +システム管理者やハッカーやグルといった人々から、ユーザを救います。 .Pp -オプションとしては以下のものがあります。 +以下の親切なオプションがあります: .Bl -tag -width time .It Fl h .Ar time @@ -58,15 +59,16 @@ .Xr halt 8 を実行し、システムを停止します。 .It Fl k +全ユーザを追い出します。 実際にはシステムを停止しませんが、 -スーパーユーザ以外のユーザをログインできなくします。 +マルチユーザシステムのままでスーパユーザ以外のユーザをログインできなくします。 .It Fl n -停止する前に +停止する前に、通常実行される .Xr sync 2 を実行しません。 .It Fl r .Ar time -で指定された時間に +で指定した時刻に .Xr reboot 8 を実行し、システムを再起動します。 .It Ar time @@ -74,11 +76,11 @@ がシステムを停止させる時間を指定します。 .Ar now を指定すると即時にシステムを停止します。 -また、時間を指定する次の二つの書式があります。 +また、時間を指定する次の二つの書式があります: .Ar +number もしくは .Ar yymmddhhmm -の形式で指定します。現在のシステムの年・月・日の値がデフォルトになっています。 +の形式です。現在のシステムの年・月・日の値がデフォルトになっています。 一つめの書式は .Ar number 分経過後をあらわし、二つめの書式は停止する時刻を直接指定します。 @@ -90,8 +92,8 @@ がオプションとして与えられると、警告メッセージを標準入力から読み取ります。 .El .Pp -システム停止の 10 時間前から、ログイン中の全てのユーザーの端末に -警告メッセージが表示されはじめ、停止が近付くにつれ頻繁になってきます。 +システム停止の 10 時間前から、ログイン中の全てのユーザの端末に +警告メッセージが表示されはじめ、終末が近付くにつれ頻繁になってきます。 システム停止の 5 分前、もしくは 5 分以内にシステム停止する場合には、 ただちに警告メッセージをコピーした .Pa /etc/nologin diff --git a/ja_JP.eucJP/man/man8/slstat.8 b/ja_JP.eucJP/man/man8/slstat.8 index d4c190a53d..c978b9c8ca 100644 --- a/ja_JP.eucJP/man/man8/slstat.8 +++ b/ja_JP.eucJP/man/man8/slstat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)slstat.8 6.8 (Berkeley) 6/20/91 -.\" %Id: slstat.8,v 1.6.2.2 1997/03/06 08:00:20 mpp Exp % +.\" %Id: slstat.8,v 1.6.2.3 1997/11/06 07:40:40 charnier Exp % .\" jpman %Id: slstat.8,v 1.2 1997/05/24 05:28:27 mitchy Stab % .\" .Dd October 11, 1996 @@ -45,7 +45,7 @@ .Op Fl vr .Op Ar unit .Sh 解説 -.Nm slstat +.Nm はシリアル回線インターネットプロトコル (SLIP) のトラフィックに関連する カーネルの統計情報を表示します。 .Pp diff --git a/ja_JP.eucJP/man/man8/spkrtest.8 b/ja_JP.eucJP/man/man8/spkrtest.8 index 1db177d3d2..51d5c43c26 100644 --- a/ja_JP.eucJP/man/man8/spkrtest.8 +++ b/ja_JP.eucJP/man/man8/spkrtest.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: spkrtest.8,v 1.2.2.1 1997/03/06 08:00:22 mpp Exp % +.\" %Id: spkrtest.8,v 1.2.2.2 1997/11/07 07:19:03 charnier Exp % .\" jpman %Id: spkrtest.8,v 1.3 1997/08/16 13:43:02 horikawa Stab % .Dd May, 1995 @@ -50,4 +50,6 @@ .Sh 歴史 .Nm -スクリプトは FreeBSD 1.0 で登場しました。 +スクリプトは +.Fx 1.0 +で登場しました。 diff --git a/ja_JP.eucJP/man/man8/spray.8 b/ja_JP.eucJP/man/man8/spray.8 index 52523137b5..460f1af19d 100644 --- a/ja_JP.eucJP/man/man8/spray.8 +++ b/ja_JP.eucJP/man/man8/spray.8 @@ -21,8 +21,8 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd July 10, 1995 .\" jpman %Id: spray.8,v 1.3 1997/07/22 16:59:25 horikawa Stab % +.Dd July 10, 1995 .Dt SPRAY 8 .Os FreeBSD .Sh 名称 @@ -34,8 +34,6 @@ .Op Fl d Ar delay .Op Fl l Ar length .Ar host -\&... -.Ek .Sh 解説 .Nm spray は複数の RPC パケットを @@ -66,8 +64,7 @@ RPC .Nm spray は、ネットワークのテストや計測や管理のための利用を想定しています。 このコマンドは、 -.Bf -emphasis -ネットワークにとても負荷をかけますので、利用には注意してください。 +.Em "ネットワークにとても負荷をかけますので、利用には注意してください。" .Ef .Pp .Sh 関連項目 diff --git a/ja_JP.eucJP/man/man8/sysctl.8 b/ja_JP.eucJP/man/man8/sysctl.8 index b8672baacc..976a549cdc 100644 --- a/ja_JP.eucJP/man/man8/sysctl.8 +++ b/ja_JP.eucJP/man/man8/sysctl.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 -.\" %Id: sysctl.8,v 1.10.2.1 1997/08/30 14:11:21 kato Exp % +.\" %Id: sysctl.8,v 1.10.2.2 1997/11/07 07:27:11 charnier Exp % .\" jpman %Id: sysctl.8,v 1.2 1997/05/30 00:57:58 yugawa Stab % .\" .Dd September 23, 1994 @@ -51,35 +51,31 @@ .Op Fl bn .Fl aAX .Sh 解説 -.Nm sysctl +.Nm はカーネル状態を取り出し、適切な権限があれば プロセスがカーネル状態を設定することを許します。取り出され たり、設定されたりした状態は、``Management Information Base''(``MIB'') 形式を使って記述されます。この形式では、要素はドット ``.'' で 接続されます。 .Pp -.Fl a -フラグを使うと、現在有効な文字列や整数値 -をすべて表示します。 -.Pp -.Fl A -フラグでは、 -.Nm sysctl -がそのデータ形式を知らないもの(以下、形式不明の変数と称する) を含めて、 +以下のオプションを使用可能です: +.Bl -tag -width indent +.It Fl a +現在有効な文字列や整数値をすべて表示します。 +.It Fl A +データ形式を知らないもの(以下、形式不明の変数と称する) を含めて、 存在している全ての MIB を表示します。 .Fl a フラグ同様、文字列や整数値も表示されます。 形式不明の変数に関しては、 そのフォーマットおよび長さに関する情報と、その変数の内容の最初の数バイトを 16 進数でダンプします。 -.Pp -.Fl X +.It Fl X フラグは、形式不明の変数の全ての内容が 16 進数でダンプされる以外は .Fl A と同じです。 -.Pp -.Fl n -フラグをつけると、フィールド名の出力は抑制されて、値 +.It Fl n +フィールド名の出力は抑制されて、値 だけが表示されます。これはシェル変数を設定するのに役に 立ちます。たとえば、ページサイズを変数 psize に保存する には、以下のようにします: @@ -87,21 +83,23 @@ set psize=`sysctl -n hw.pagesize` .Ed .Pp -.Fl b -フラグをつけると、変数の値を加工せずに、バイナリ形式で表示します。 +.It Fl b +変数の値を加工せずに、バイナリ形式で表示します。 変数名や、最後の改行文字は出力されません。これは、単一の変数に対して 操作する際に便利でしょう。 -.Pp -MIB 形式の名前だけを指定すると、その名前に対応する -値が得られます。値を設定するには -.Fl w -フラグを用い、MIB 名 -のあとにイコール記号 ``='' をつけて、そのあとに設定する新 -しい値を指定します。 -.Pp -.Nm sysctl +.It Fl w Ar name=value ... +MIB の +.Ar name +を新しい値 +.Ar value +に設定します。 +MIB 形式 +.Ar name +だけが指定された場合、その名前に対応する値が得られます。 +.El +.Nm で得られる情報は、整数、文字列、形式不明の変数です。 -.Nm sysctl +.Nm はいくつかの形式不明の変数の形式を知っているだけで、それ以外のものに 対しては 16 進ダンプに頼ります。 形式不明の変数の情報は、 @@ -180,7 +178,6 @@ changeable .El .Pp .Sh 使用例 -.Pp たとえば、システム中で許されている最大のプロセス数を知りたい ときは、以下のようにします: .Bd -literal -offset indent -compact @@ -231,7 +228,7 @@ sysctl vm.loadavg .Xr sysctl 3 .Sh バグ 現状では -.Nm sysctl +.Nm は、sysctl ツリーの追跡、および、形式と名前の情報を得る際に、 文書化されていないカーネルの sysctl 機能へのインタフェースを使用しています。 この方法に関する正しいインタフェースは、現在検討中です。 diff --git a/ja_JP.eucJP/man/man8/syslogd.8 b/ja_JP.eucJP/man/man8/syslogd.8 index 96486e7cee..478b37b740 100644 --- a/ja_JP.eucJP/man/man8/syslogd.8 +++ b/ja_JP.eucJP/man/man8/syslogd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)syslogd.8 8.1 (Berkeley) 6/6/93 -.\" %Id: syslogd.8,v 1.6.2.4 1997/09/19 22:27:26 brian Exp % +.\" %Id: syslogd.8,v 1.6.2.5 1997/11/07 07:30:40 charnier Exp % .\" jpman %Id: syslogd.8,v 1.3 1997/05/19 17:08:30 horikawa Stab % .\" .Dd October 12, 1995 @@ -47,15 +47,15 @@ .Op Fl m Ar mark_interval .Op Fl p Ar log_socket .Sh 解説 -.Nm syslogd +.Nm はコンフィグレーションファイルに指定された通りに、システムコンソール、 ログファイル、他のマシンやユーザへのメッセージを読み込み、記録します。 オプションには以下のものがあります。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a Ar allowed_peer .Ar allowed_peer がこの -.Nm syslogd +.Nm に UDP データグラムを使用してログすることを許します。複数の .Fl a オプションを指定可能です。 @@ -104,9 +104,9 @@ UDP service 全てのホストから受け付けます。 .El .It Fl d -.Nm syslogd +.Nm をデバッグモードで実行します。これは恐らく、 -.Nm syslogd +.Nm の開発者にのみ役立ちます。 .It Fl f 代りのコンフィグレーションファイルのパス名を指定します。 @@ -126,14 +126,14 @@ UDP service ために listen しません。 .El .Pp -.Nm syslogd +.Nm は起動時とhangupシグナルを受けとった時はいつでもコンフィグレーションファ イルを読み込みます。 コンフィグレーションファイルのフォーマットに関する情報は、 .Xr syslog.conf 5 参照して下さい。 .Pp -.Nm syslogd +.Nm は .Tn UNIX ドメインソケット @@ -144,15 +144,15 @@ UDP service .Pa /dev/klog (カーネルメッセージを読むため）からメッセージを読み込みます。 .Pp -.Nm syslogd +.Nm はファイル .Pa /var/run/syslog.pid を作成し、プロセスIDを記録します。 これは -.Nm syslogd +.Nm のkillやコンフィグレーションファイルを読み込ませるために使えます。 .Pp -.Nm syslogd +.Nm に送られるメッセージは単一の行で構成されます。このメッセージは先頭に優 先順位コードを含んでいます。このコードは .Sq Aq 5 @@ -164,8 +164,8 @@ UDP service .It Pa /etc/syslog.conf コンフィグレーションファイル .It Pa /var/run/syslog.pid -動作している -.Nm syslogd +動作中の +.Nm のプロセスID .It Pa /var/run/log .Tn UNIX @@ -179,7 +179,7 @@ UDP service .Xr services 5 , .Xr syslog.conf 5 .Sh 歴史 -.Nm syslogd +.Nm コマンドは .Bx 4.3 から登場しました。 @@ -194,7 +194,7 @@ UDP service UDPパケットで受けとったメッセージを記録する能力は認証されていないディ スクを溢れさせるリモートサービスと等価であり、恐らくデフォルトで無効に されるべきです。ある種の -.Nm syslogd +.Nm 間の認証メカニズムが用意されるべきでしょう。 最悪の無駄遣いを避けるために、 .Fl a diff --git a/ja_JP.eucJP/man/man8/talkd.8 b/ja_JP.eucJP/man/man8/talkd.8 index 41d0ea879d..a176ca0257 100644 --- a/ja_JP.eucJP/man/man8/talkd.8 +++ b/ja_JP.eucJP/man/man8/talkd.8 @@ -59,10 +59,14 @@ 構造体のメッセージを送って、 接続の初期化を行います。すると、サーバはすでに呼び出し が行われているかどうか内部テーブルを検索します (相手はメッセージ -のなかで指定されています)。検索に失敗すると、クライアントは +のなかで指定されています)。 +.Pp +検索に失敗すると、クライアントは .Dv ANNOUNCE メッセージを送り、サーバに呼び出す相手のログイン端末に通知を -ブロードキャストさせて接続要求を行います。相手が応答すると、ローカル +ブロードキャストさせて接続要求を行います。 +.Pp +相手が応答すると、ローカル のサーバは内部テーブルの記録を用いて適切なアドレスで 接続を行い、呼び出し側と呼び出された側との間にストリーム型 の接続を確立して、そこで会話が行えるようにします。 diff --git a/ja_JP.eucJP/man/man8/telnetd.8 b/ja_JP.eucJP/man/man8/telnetd.8 index 2067c793ba..8af3dcc3bb 100644 --- a/ja_JP.eucJP/man/man8/telnetd.8 +++ b/ja_JP.eucJP/man/man8/telnetd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)telnetd.8 8.3 (Berkeley) 3/1/94 -.\" %Id: telnetd.8,v 1.5.2.1 1997/02/05 06:02:38 pst Exp % +.\" %Id: telnetd.8,v 1.5.2.2 1997/12/19 07:33:31 charnier Exp % .\" jpman %Id: telnetd.8,v 1.2 1997/05/12 08:14:57 yugawa Stab % .\" .Dd March 1, 1994 @@ -50,19 +50,19 @@ .Op Fl X Ar authtype .Op Fl a Ar authmode .Op Fl edebug -.Op Fl P Ar loginprog +.Op Fl p Ar loginprog .Op Fl r Ns Ar lowpty-highpty .Op Fl u Ar len .Op Fl debug Op Ar port .Sh 解説 -.Nm telnetd +.Nm コマンドは、 .Tn DARPA 標準 .Tn TELNET 仮想端末プロトコル をサポートするサーバです。 -.Nm telnetd +.Nm は、通常は .Pa /etc/services ファイル( @@ -76,59 +76,59 @@ オプションは、 .Xr inetd 8 の代わりに -.Nm telnetd +.Nm を手動で起動するために用いられます。 このように手動で起動された場合には、 代わりの .Tn TCP ポート番号で -.Nm telnetd +.Nm を動かすために .Ar port を指定する事ができます。 .Pp -.Nm telnetd +.Nm コマンドには以下のオプションがあります: -.Bl -tag -width "-a authmode" +.Bl -tag -width indent .It Fl a Ar authmode このオプションは、どのモードが認証に使われるかを指定するために用いられます。 このオプションは、 -.Nm telnetd +.Nm が .Dv AUTHENTICATION オプションをサポートする設定で構築された場合においてのみ役に立つことに 注意して下さい。 以下に示すようないくつかの .Ar authmode -があります。 +があります: .Bl -tag -width debug -.It debug +.It Cm debug 認証のデバッグコードを有効にします。 -.It user +.It Cm user リモートユーザは、自分自身であること示すための有効な認証情報を 提供した時にのみ接続が許可されます。 この場合、指定されたアカウントに対しては、パスワードの提供なしに接続が 許可されます。 -.It valid +.It Cm valid リモートユーザが自分自身であることを示すための有効な認証情報を 提供した時にのみ接続が許可されます。 リモートユーザが指定されたアカウントに対する自動的な接続が許可されて いなければ .Xr login 1 コマンドは、必要となるユーザ認証を実施します。 -.It other +.It Cm other ある種の認証情報を提供した場合のみ接続を許可します。 現在このオプションはすべての認証方法でサポートされていないため .Fl a .Cm valid オプションを指定した時と同じ動作をします。 -.It none +.It Cm none デフォルトではこの状態です。 認証情報は要求されません。 もし認証情報がなかったり不十分であれば、 .Xr login 1 プログラムによって必要となるユーザ認証を実施します。 -.It off +.It Cm off 認証コードを無効にします。 すべてのユーザ証明が .Xr login 1 @@ -136,7 +136,7 @@ .El .It Fl B bftp サーバモードを指定します。このモードでは -.Nm telnetd +.Nm は、login にユーザの通常のシェルではなく .Xr bftp 1 セッションを開始するように指示します。 @@ -147,13 +147,13 @@ bftp .It Fl D Ar debugmode このモードはデバックのために用いられます。 これによって -.Nm telnetd +.Nm がデバッグ情報を表示し、ユーザは -.Nm telnetd +.Nm が何をしているのかを見ることが許されます。 以下に示すようないくつかの .Ar debugmode -が可能です。 +が可能です: .Bl -tag -width exercise .It Cm options .Tn TELNET @@ -164,7 +164,7 @@ bftp どのような操作が行われているのかという、いくつかの付加的な情報が 表示されます。 .It Cm netdata -.Nm telnetd +.Nm が受け取ったデータストリームを表示します。 .It Cm ptydata pty に書かれたデータを表示します。 @@ -172,7 +172,7 @@ pty まだ実装されていません。 .El .It Fl debug -.Nm telnetd +.Nm によって作られたソケットについてのデバッグを可能にします ( .Xr socket 2 @@ -180,11 +180,11 @@ pty .Dv SO_DEBUG 参照)。 .It Fl edebug -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築されている場合に、 .Fl edebug オプションは、暗号化デバッグコードを可能にするために使われます。 -.It Fl P Ar loginprog +.It Fl p Ar loginprog ログインを完了する際に実行されるコマンドとして .Xr login 1 以外のコマンドを指定します。指定されたコマンドは通常の login と同じ引数を @@ -206,14 +206,14 @@ init です。 .It Fl k このオプションは、 -.Nm telnetd +.Nm が linemode と kludge linemode をサポートする設定で構築されている ときにのみ有効です。 .Fl k オプションが指定されている場合で、もしリモートのクライアントが .Dv LINEMODE オプションをサポートしていなければ、 -.Nm telnetd +.Nm は、 character at a time mode で動きます。 この様な状態でも kludge linemode をサポートしますが、リモートのクライアントが 要求した場合のみ kludge linemode になります @@ -239,7 +239,7 @@ line mode .It Fl n .Dv TCP keep-alives を行いません。通常、 -.Nm telnetd +.Nm は .Tn TCP keep-alive を有効にしています。なぜなら、クラッシュしたり、すでに接続 @@ -248,7 +248,7 @@ keep-alive 調べる必要があるからです。 .It Fl r Ar lowpty-highpty このオプションは、 -.Nm telnetd +.Nm が .Dv UNICOS 用に構築されている場合にのみ有効です。 @@ -267,7 +267,7 @@ keep-alive .Ar lowpty を省略した場合でも文字 - を省略する事は出来ません。 文字 - を省略してしまうと -.Nm telnetd +.Nm はそれが .Ar highpty であることを判断できずに @@ -275,7 +275,7 @@ keep-alive であると判断してしまうからです。 .It Fl s このオプションは、 -.Nm telnetd +.Nm が .Tn SecurID カードをサポートする設定で構築されている時にのみ有効です。 @@ -309,23 +309,23 @@ keep-alive ファイルに書き込まれるようにします。 .It Fl U このオプションは -.Nm telnetd +.Nm が、 .Xr gethostbyaddr 3 ルーチンを通して symbolic name にマップされないようなアドレスからの コネクションを拒絶するようにします。 .It Fl X Ar authtype このオプションは -.Nm telnetd +.Nm が認証オプションをサポートする設定で構築されたときにのみ有効です。 .Ar authtype 認証を使用不能にし、 -.Nm telnetd +.Nm を再コンパイルすることなしに 特定の認証タイプを一時的に使用不能にする事が出来ます。 .El .Pp -.Nm telnetd +.Nm は仮想端末デバイス( .Xr pty 4 参照)をクライアントに割り当てます。 @@ -335,7 +335,7 @@ keep-alive と .Dv stderr として仮想端末のスレーブ側を使用する login プロセスを生成します。 -.Nm telnetd +.Nm は、 .Tn TELNET プロトコルを実装し、 @@ -344,7 +344,7 @@ keep-alive .Pp .Tn TELNET セッションが開始されると -.Nm telnetd +.Nm は以下の .Tn TELNET オプションをクライアント側に送信して、これらの @@ -378,7 +378,7 @@ DO TIMING-MARK .Xr tty 4 参照) が有効な状態で操作するように設定されます。 .Pp -.Nm telnetd +.Nm は、ローカル側で有効な以下に示す .Tn TELNET オプションをサポートしています: @@ -427,19 +427,19 @@ DO TIMING-MARK .Tn TELNET セッションはシャットダウンされます。 .It "WILL ENCRYPT" -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築された場合のみ送信され、 データ列に対して暗号の復号するように指定します。 .El .Pp -.Nm telnetd +.Nm はリモート側で有効な以下に示す .Tn TELNET オプションをサポートしています: .Bl -tag -width "DO AUTHENTICATION" .It "DO BINARY" -.Tn telnetd -が8ビットのデータ列を受信するように指定します。 +.Nm telnetd +が 8 ビットのデータ列を受信するように指定します。 .It "DO LFLOW" クライアントがフロー制御文字をリモート側で処理するように指定します。 .It "DO ECHO" @@ -475,11 +475,11 @@ RFC 1572 RFC 1408 に示されている環境変数に関する情報を 要求できるように指定します。 .It "DO LINEMODE" -.Nm telnetd +.Nm が linemode をサポートする設定で構築された場合のみ送信され、 クライアントに行単位の処理を行う事を要求します。 .It "DO TIMING-MARK" -.Nm telnetd +.Nm が linemode および kludge linemode の両方をサポートする設定で 構築され、クライアントが .Dv WONT LINEMODE @@ -491,25 +491,24 @@ RFC 1408 .Op Fl k オプションによりこの機能を無効にする事ができます。 .It "DO AUTHENTICATION" -.Nm telnetd +.Nm が認証機能をサポートする設定で構築された場合のみ送信され、 自動ログインに使用する認証情報を受信するようにします。 .It "DO ENCRYPT" -.Nm telnetd +.Nm がデータの暗号化をサポートする設定で構築された場合のみ送信され、 データ列に対して暗号の復号するように指定します。 -.Sh 環境 +.Sh 環境変数 .Sh ファイル -.Pa /etc/services -.br -.Pa /etc/inittab +.Bl -tag -width /usr/ucb/bftp -compact +.It Pa /etc/services +.It Pa /etc/inittab (UNICOS システムのみ) -.br -.Pa /etc/iptos +.It Pa /etc/iptos (サポートされている場合) -.br -.Pa /usr/ucb/bftp +.It Pa /usr/ucb/bftp (サポートされている場合) +.El .Sh "関連項目" .Xr bftp 1 , .Xr login 1 , @@ -568,7 +567,7 @@ Telnet Environment Option オリジナルの 4.2 BSD の .Xr telnet 1 のバグに対処するため、 -.Nm telnetd +.Nm は、ある種のあいまいなプロトコル変換を行うことにより、 リモートクライアントが実際に 4.2 BSD の .Xr telnet 1 @@ -580,7 +579,7 @@ Telnet Environment Option .Pp リモートクライアントから受け取った端末タイプの名前は小文字に変換されます。 .Pp -.Nm telnetd +.Nm は、 .Tn TELNET .Dv IAC GA diff --git a/ja_JP.eucJP/man/man8/tftpd.8 b/ja_JP.eucJP/man/man8/tftpd.8 index 6322ec2cfa..540ebf8fce 100644 --- a/ja_JP.eucJP/man/man8/tftpd.8 +++ b/ja_JP.eucJP/man/man8/tftpd.8 @@ -40,13 +40,13 @@ .Nd インターネット TFTP (Trivial File Transfer Protocol) サーバ .Sh 書式 -.Nm tftpd +.Nm /usr/libexec/tftpd .Op Fl l .Op Fl n .Op Fl s Ar directory .Op Ar directory ... .Sh 解説 -.Nm tftpd +.Nm は、インターネット TFTP プロトコル ( .Tn RFC 783 ) を提供するサーバです。 @@ -63,7 +63,7 @@ .Xr tftp 1 の利用には、リモートシステムのアカウントやパスワードを必要としません。 認証情報がありませんので、 -.Nm tftpd +.Nm はパブリックに読み込み可能なファイルだけしかアクセスを許可しません。 文字列 ``/\|\fB.\|.\fP\|/'' を含んだファイル、もしくは ``\|\fB.\|.\fP\|/'' から始まるファイルのアクセスは許可されません。 @@ -78,7 +78,7 @@ 持たねばなりません。 .Pp ファイルへのアクセス制限は、 -.Nm tftpd +.Nm 起動時のディレクトリリストを、 .Pa /etc/inetd.conf にサーバプログラムへの引数として 20 までのパス名を指定することにより可能です。 @@ -87,14 +87,18 @@ 与えられたディレクトリは、相対ファイル指定要求に対しての探索パスと しても利用されます。 .Pp -chroot オプションは、 tftpd のアクセスを chroot されたファイルシステム +chroot オプションは、 +.Nm +のアクセスを chroot されたファイルシステム だけに制限することで、セキュリティを追加します。 これは、ブートサーバとして -.Nm -s +.Fl s を提供している OS から実行する時に便利です。 -chroot の実行は root に制限されていますので、tftpd は root で +chroot の実行は root に制限されていますので、 +.Nm +は root で 実行しなければなりません。しかしながら、 chroot した場合、 -.Nm tftpd +.Nm はユーザ id を nobody に設定します。 .Pp 以下のようなオプションがあります。 @@ -106,7 +110,9 @@ chroot .It Fl n 存在しない相対ファイル名に対する要求の否定応答を抑止します。 .It Fl s Ar directory -コマンドを受け取る前に tftpd を +コマンドを受け取る前に +.Nm +を .Pa directory へ chroot させます。更に、ユーザ id を nobody にします。 .Pp diff --git a/ja_JP.eucJP/man/man8/timed.8 b/ja_JP.eucJP/man/man8/timed.8 index 1251c4263e..d39a5d7a59 100644 --- a/ja_JP.eucJP/man/man8/timed.8 +++ b/ja_JP.eucJP/man/man8/timed.8 @@ -50,7 +50,7 @@ 本コマンドは、タイムサーバデーモンであり、通常はブート時に .Xr rc 8 ファイル内の記述に従って起動されます。本コマンドにより、ホストと、 -.Nm timed +.Nm を実行しているローカルネットワーク上のマシンとの時刻の同期を取ります。 これらのタイムサーバは、 マシン時刻の刻みを遅らせたり進ませたりすることで、それらのマシンの時計を @@ -59,11 +59,11 @@ タイムスタンプリクエストメッセージを用いることで、 マシン間の時刻差分を計測し、ネットワーク平均時間を計算します。 .Pp -.Nm timed +.Nm によって提供されるサービスは、マスタ−スレーブ構造に基づいて構成されています。 -.Nm timed +.Nm がマシン上で動作し始めると、 -.Nm timed +.Nm は、マスタサーバにネットワーク時刻を問い合わせ、自マシンの時刻を設定します。 この後、マスタサーバから送られる同期メッセージを定期的に受け取り、 マシン時間の補正が必要な場合には @@ -83,11 +83,11 @@ や .Fl F オプションを付加しないで動作している -.Nm timed +.Nm は、スレーブのままです。 .Fl t フラグは、 -.Nm timed +.Nm が受信するメッセージを .Pa /var/log/timed.log へ記録するようにします。このトレース機能は、 @@ -95,8 +95,10 @@ を用いてオン/オフを変更できます。 .Fl d フラグは、デーモンのデバッグのためのオプションです。 -本オプションは、プログラムをバックグラウンド実行しないようにします。通常、 -.Nm timed +本オプションは、プログラムをバックグラウンド実行しないようにします。 +.Pp +通常、 +.Nm は、接続されているネットワーク上のマスタタイムサーバをチェックしますが、 以下に記述のあるオプションを指定して動作を変更した場合にはこの限りでは ありません。 @@ -131,7 +133,7 @@ .Fl i は、同時に使用できません。 .Pp -.Nm timed +.Nm は、接続されているネットワーク上のマスタタイムサーバをチェックします。しかし、 .Fl n や @@ -142,7 +144,9 @@ マスタサーバが見つからなくなった場合のために、 定期的に他のネットワークをチェックします。 .Pp -マシン群の同期をとるための 1つの方法として、NTP デーモンを用いてあるマシン +マシン群の同期をとるための 1つの方法として、 +.Tn NTP +デーモンを用いてあるマシン の時刻を遠距離の標準時刻や電波受信機の時刻に同期させ、かつ、信頼できる マシンは自分自身だけであることを timed デーモンに .Fl F Ar hostname @@ -164,21 +168,24 @@ 別のネットワークにおいてスレーブになることを選択したことを示します。 .Sh 警告 もし -.Nm timed +.Nm や -.Xr NTP +.Tn NTP のような 2 つ以上の時刻デーモンが同じ時計を更新しようとした場合に、 一時的に時刻がおかしくなる可能性があります。 .Nm と他のタイムデーモンが同じマシン上で走行している場合には、 .Fl F オプションを使用していることを確認して下さい。これは、 -.Nm timed +.Nm がローカルマシンの時計を更新しないようにするためです。 .Pp なお、このデーモンが使用するネットワークプロトコルは、 -UDP/IP ブロードキャストに基づいています。 -ブロードキャスト範囲内で TSP プロトコルを用いるすべてのマシンは +.Tn UDP/IP +ブロードキャストに基づいています。 +ブロードキャスト範囲内で +.Tn TSP +プロトコルを用いるすべてのマシンは 協調しあわなければなりません。 ブロードキャストパケットが届くマシン間では、 .Fl F diff --git a/ja_JP.eucJP/man/man8/timedc.8 b/ja_JP.eucJP/man/man8/timedc.8 index 1b1b4d5a5a..89a8e3fe1e 100644 --- a/ja_JP.eucJP/man/man8/timedc.8 +++ b/ja_JP.eucJP/man/man8/timedc.8 @@ -45,7 +45,7 @@ .Op Ar argument ... .Oc .Sh 解説 -.Nm timedc +.Nm は、 .Xr timed 8 を制御するために使用します。具体的には、以下に示す機能を有します。 @@ -61,16 +61,16 @@ 様々なデバッグ動作 .El .Pp -.Nm timedc +.Nm を引数なしで起動した場合、 -.Nm timedc +.Nm はプロンプトを表示し、標準入力からの コマンド入力待ちの状態になります。起動時に引数を指定した場合、 -.Nm timedc +.Nm は、最初の引数をコマンドとして、残りの引数をそのコマンドのパラメータとして 解釈します。 また -.Nm timedc +.Nm は、標準入力の代わりにリダイレクションを使用してファイルからコマンドを 読み込むこともできます。 コマンドは短縮可能です; 使用可能なコマンドは以下の通りです: @@ -83,7 +83,7 @@ 使用可能なコマンドの一覧を表示します。 .Pp .It Ic clockdiff Ar host ... -.Nm timedc +.Nm を実行したマシンの時刻と、引数で指定したマシンの時刻 の比較を行ない、その結果を表示します。 .Pp @@ -99,7 +99,7 @@ へのメッセージの .Pa /var/log/timed.log への記録の有効/無効を指定します。 -.It Ic election Ar host +.It Ic election Ar host1 Op Ar host2 ... .Ar host で指定したホスト上の timed デーモンに対し、"election" タイマをリセットし、 新たにマスタタイムサーバが選択されていることを確実にするよう要求します。 @@ -112,7 +112,7 @@ timedc .Xr timed 8 のテストやデバッグのために実装してあります。 それらのコマンドについては、 -.Nm timedc +.Nm の help コマンドを用いたり、本コマンドのソースを参照するなどして調べて下さい。 .Sh 関連ファイル .Bl -tag -width /var/log/timed.masterlog -compact diff --git a/ja_JP.eucJP/man/man8/traceroute.8 b/ja_JP.eucJP/man/man8/traceroute.8 index 5896caa481..2f3feee717 100644 --- a/ja_JP.eucJP/man/man8/traceroute.8 +++ b/ja_JP.eucJP/man/man8/traceroute.8 @@ -13,7 +13,7 @@ .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" -.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.2 1996/10/08 02:44:23 sef Exp % +.\" %Header: /home/ncvs/src/contrib/traceroute/traceroute.8,v 1.2.2.1 1998/01/09 18:51:35 steve Exp % .\" .\" jpman %Id: traceroute.8,v 1.2 1997/05/13 00:58:05 mutoh Stab % .\" diff --git a/ja_JP.eucJP/man/man8/trpt.8 b/ja_JP.eucJP/man/man8/trpt.8 index ef96c9d2e8..d97ce5beea 100644 --- a/ja_JP.eucJP/man/man8/trpt.8 +++ b/ja_JP.eucJP/man/man8/trpt.8 @@ -50,7 +50,7 @@ .Ar system Op Ar core .Oc .Sh 解説 -.Nm trpt +.Nm は、socket に .Dq デバッグ情報の記録 を指示した時 ( @@ -59,7 +59,7 @@ .Tn TCP のトレースレコードの内容を表示します。 オプションを指定しない場合には、 -.Nm trpt +.Nm は、システム中のすべてのトレースレコードを、 .Tn TCP コネクションの @@ -67,7 +67,7 @@ (protocol control block) によってグループ化して表示します。 以下のオプションを使ってこの動作を変更することができます。 -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a 通常の出力に加えて、 記録された各パケットの送信元と宛先のアドレスを表示します。 @@ -88,7 +88,7 @@ 通常の出力に加えて、トレースの各時点でのすべてのタイマの値を表示します。 .El .Pp -.Nm trpt +.Nm は、以下のようにして使ってみて下さい。 問題となっているコネクションを切り分けて、それに関わる socket に対して デバッグ機能を有効にします。 @@ -99,7 +99,7 @@ そして、 .Fl p オプションと PCB アドレスを引数にして -.Nm trpt +.Nm を実行します。 .Fl f オプションを使うと、一度見つけたトレースログを追い続けることができます。 @@ -117,8 +117,9 @@ .El .Sh 関連項目 .Xr netstat 1 , -.Xr setsockopt 2 , -.Xr trsp 8 +.Xr setsockopt 2 +.\" .Xr setsockopt 2 , +.\" .Xr trsp 8 .Sh 診断 .Bl -tag -width Ds .It Sy no namelist diff --git a/ja_JP.eucJP/man/man8/tzsetup.8 b/ja_JP.eucJP/man/man8/tzsetup.8 index 97e28b4dcc..8a83c30f10 100644 --- a/ja_JP.eucJP/man/man8/tzsetup.8 +++ b/ja_JP.eucJP/man/man8/tzsetup.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: tzsetup.8,v 1.3.2.1 1997/03/06 08:00:38 mpp Exp % +.\" %Id: tzsetup.8,v 1.3.2.2 1997/11/07 07:36:15 charnier Exp % .\" jpman %Id: tzsetup.8,v 1.3 1997/07/22 17:04:38 horikawa Stab % .Dd Jan 1996 @@ -33,13 +33,23 @@ .Nm tzsetup .Nd ローカルタイムゾーンを設定する -.Sh 解説 +.Sh 書式 .Nm tzsetup +.Op Fl n + +.Sh 解説 +.Nm は、メニューによるローカルタイムゾーンの設定を行うためのプログラムです。 もっとも良くあなたの場所を表現している大陸と (例えば、あなたの首都の様な) 都市を選びます。すると -.Nm tzsetup +.Nm が全ての仕事を行ってくれます。 +.Pp +以下のオプションが使用可能です: +.Bl -tag -width indent +.It Fl n +実際には何も行わない。 +.El .Sh バグ 変更が効果を持つためには、機械をリブートする必要があります。 @@ -51,7 +61,8 @@ .It Pa /usr/share/zoneinfo ゾーン情報ファイルのためのディレクトリ .It Pa /etc/wall_cmos_clock -adjkerntz(8) を見てください。 +.Xr adjkerntz 8 +を見てください。 .El .Sh 関連項目 diff --git a/ja_JP.eucJP/man/man8/uucpd.8 b/ja_JP.eucJP/man/man8/uucpd.8 index cb663ceecf..3a5a1c22b9 100644 --- a/ja_JP.eucJP/man/man8/uucpd.8 +++ b/ja_JP.eucJP/man/man8/uucpd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)rshd.8 8.1 (Berkeley) 6/4/93 -.\" %Id: uucpd.8,v 1.2 1996/08/23 20:36:11 mpp Exp % +.\" %Id: uucpd.8,v 1.2.2.1 1997/12/18 07:32:41 charnier Exp % .\" .\" jpman %Id: uucpd.8,v 1.3 1997/09/04 16:43:12 horikawa Stab % .Dd Feb 18, 1996 @@ -40,11 +40,11 @@ .Nm uucpd .Nd uucp ネットワークサーバ .Sh 書式 -.Nm uucpd +.Nm /usr/libexec/uucpd .Sh 解説 -.Nm uucpd +.Nm は、ネットワーク経由での uucp 接続をサポートするサーバです。 -.Nm uucpd +.Nm は、``uucp'' サービスとして定められたポート( .Xr services 5 参照)を監視し、リクエストが来るのを待ちます。 @@ -62,7 +62,7 @@ .It Pa /etc/inetd.conf .El .Sh 歴史 -.Nm uucpd +.Nm ユーティリティは、 .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man8/vipw.8 b/ja_JP.eucJP/man/man8/vipw.8 index f417060a03..7aa13c6ccf 100644 --- a/ja_JP.eucJP/man/man8/vipw.8 +++ b/ja_JP.eucJP/man/man8/vipw.8 @@ -43,23 +43,23 @@ .Sh 書式 .Nm vipw .Sh 解説 -.Nm vipw +.Nm は、適切なロックをしてパスワードファイルの編集を行い、 ロックを解除した後で必要な処理を行います。すでに他のユーザによって パスワードファイルが編集中でロックされていた場合には、 -.Nm vipw +.Nm は後で再度実行するように知らせます。 デフォルトでは、 .Xr vi 1 がエディタとして使用されます。 .Pp -.Nm vipw +.Nm はパスワードファイルエントリの多くの整合性をチェックし、「間違った」エントリを 含むパスワードファイルがインストールされないようにします。 間違っていた場合にはユーザに再編集を要求します。 .Pp パスワードファイルの情報が正しいことが確かめられると、 -.Nm vipw +.Nm は .Xr pwd_mkdb 8 を使ってデータベースを更新します。これはバックグラウンドで行なわれ、 @@ -68,7 +68,7 @@ 新しい情報をプログラムで利用することはできません。 .Sh 環境変数 以下の環境変数が -.Nm vipw +.Nm で参照されます。 .Bl -tag -width EDITOR .It Ev EDITOR diff --git a/ja_JP.eucJP/man/man8/vnconfig.8 b/ja_JP.eucJP/man/man8/vnconfig.8 index 88911f0fd6..e3e1a682df 100644 --- a/ja_JP.eucJP/man/man8/vnconfig.8 +++ b/ja_JP.eucJP/man/man8/vnconfig.8 @@ -45,15 +45,19 @@ .Nd vnode ディスクを構築して利用できるようする .Sh 書式 .Nm vnconfig -.Op Fl cdeuv +.Op Fl cdeguv +.Op Fl s Ar option +.Op Fl r Ar option .Ar special_file Ar regular_file .Oo Ar feature Oc .Nm vnconfig .Fl a -.Op Fl cdeuv +.Op Fl cdeguv +.Op Fl s Ar option +.Op Fl r Ar option .Op Fl f Ar config_file .Sh 解説 -.Nm vnconfig +.Nm コマンドは、vnode 疑似ディスクデバイスを構築して使用可能にします。 コマンドの最初の書式では、スペシャルファイル .Ar special_file @@ -66,6 +70,9 @@ .Pp オプションは動作を指定します: .Bl -tag -width indent +.It Fl a +コマンドファイルを読み込み、 +各デバイス/ファイルの組に対して指定された動作を実行します。 .It Fl c デバイスを構築します。 成功すると、 @@ -73,6 +80,10 @@ への参照は、 .Ar regular_file の内容へのアクセスとなります。 +.It Fl d +指定した +.Ar feature +を(可能であれば)無効にします。 .It Fl e デバイスを構築し、指定された .Ar feature @@ -83,10 +94,19 @@ は .Fl c と同じ意味になります。 -.It Fl d -(可能なら) 指定した -.Ar feature -を無効にします。 +.It Fl f Ar config_file +.Ar config_file +を構成ファイルの代りに使用します。 +.It Fl g +global オプションを制御します。 +.It Fl r Ar option +.Ar option +をリセットします。 +.Ar option +は labels, follow, debug, io, all, none のいずれかです。 +.It Fl s Ar option +.Ar option +をセットします。 .It Fl u デバイスを無効にし、``無構築状態'' にします。 .It Fl v @@ -122,15 +142,6 @@ ``mountrw='' と同じです。 .El .Pp -第 2 の書式 ( -.Fl a -) では、構成ファイルを読み込んで、 -デバイスとファイルのそれぞれの組について指定された動作を実行します。 -.Fl f -によって、読み込む構成ファイル -.Ar config_file -を指定します。 -この指定がないと、デフォルトの構成ファイルを読みます。 構成ファイルは、1 行にデバイスとファイル名の組を次の形式で持ちます: .Bd -literal special_file regular_file [ feature ] diff --git a/ja_JP.eucJP/man/man8/watch.8 b/ja_JP.eucJP/man/man8/watch.8 index 3ab8cb4863..98a315eac9 100644 --- a/ja_JP.eucJP/man/man8/watch.8 +++ b/ja_JP.eucJP/man/man8/watch.8 @@ -14,34 +14,34 @@ .Ar tty .\" watch [-ciotnW] [] .Sh 解説 -.Nm watch +.Nm は、特定の tty を通して流れてくる全てのデータをスーパユーザに 提供します。 -.Nm watch +.Nm は、標準出力に出力します。 .Pp 以下のようなオプションがあります。 -.Bl -tag -width "-l nul " +.Bl -tag -width indent .It Fl c 閉じられた時点で再接続を行います。 -.Nm watch +.Nm によって観察されている tty が閉じられたならば、自動的に同じ tty に 再接続します。 このオプションが指定されていない時は、 -.Nm watch +.Nm は対話モードで実行されている時には新しい tty を要求し、 tty 制御を行わずに実行されている場合は終了します。 .It Fl i 対話モードにします。 対話モードは、 -.Nm watch +.Nm が tty から実行された場合のデフォルトです。 出力がファイルにリダイレクションされている時は、 このオプションを指定することで対話モードにできます。 .It Fl o オーバフローによって再接続します。 観察している tty がオーバフローした時の -.Nm watch +.Nm の振舞いは、観察している tty が閉じられた時の振舞いに似ています。 詳しい情報は、 .Xr snp 4 @@ -54,7 +54,7 @@ tty 現在の tty が閉じられたりオーバフローを起こした場合の自動プロンプトともに 無効にします。 プロンプトが表示される全ての場合、 -.Nm watch +.Nm .\"(訳注)実際は文中の語でしたが、ここでは.Nmを使いました。 .\" 2.2.1R 対象(1997/04/28) Takeshi MUTOH は終了します。再接続フラグは、このオプションに影響されません。 @@ -70,7 +70,7 @@ tty .Pp .Bl -tag -width "XXXX" -compact .It Sy "" -.Nm watch +.Nm の終了。 .It Sy "" 画面の消去。 @@ -78,7 +78,7 @@ tty 除き見る tty の変更。 .Sh 制限事項 スーパユーザだけが、 -.Nm watch +.Nm を実行できます。 .Sh 関連項目 .Xr pty 4 , @@ -88,9 +88,9 @@ tty 端末エミュレーション機能はありません。 全てのユーザの出力はそのままの形で再構成されます。 .Sh 作者 -Ugen J.S. Antsilevich +.An Ugen J.S. Antsilevich Aq ugen@NetVision.net.il .Sh 歴史 -.Nm watch +.Nm は、 .Fx 2.1 で、はじめて導入されました。 diff --git a/ja_JP.eucJP/man/man8/wlconfig.8 b/ja_JP.eucJP/man/man8/wlconfig.8 index 654dada71d..eda74185ab 100644 --- a/ja_JP.eucJP/man/man8/wlconfig.8 +++ b/ja_JP.eucJP/man/man8/wlconfig.8 @@ -9,7 +9,7 @@ .Ar ifname .Op Ar param value ... .Sh 解説 -.Nm wlconfig +.Nm コマンドは、NCR/AT&T Wavelan 無線 LAN カードのパラメータを読んだり、 設定したりするのに使うことができます。 カード内の不揮発性パラメータ格納エリア (Parameter Storage Area; PSA) @@ -36,9 +36,9 @@ .Va value .It irq IRQ の値 (リセット後に有効)。 3, 4, 5, 6, 10, 11, 12, 15 のうちの -どれか一つ +どれか一つ。 .It mac -固有の MAC の値 (イーサネットアドレス) +固有の MAC の値 (イーサネットアドレス)。 .It macsel ( .Sq mac @@ -46,7 +46,7 @@ IRQ .Sq soft か、(工場で設定される) .Sq default -のどちらか +のどちらか。 .It nwid NWID はカードの無線モデムに渡される 2 バイトのパラメータです。 NWID により、同じ空間を共有して複数の論理的に分割された @@ -85,7 +85,7 @@ IP .Pp Wavelan カードの IRQ が間違っている場合には、インタフェースが 設定されたとしても機能しないであろうことに注意して下さい。 -.Nm wlconfig +.Nm プログラムは正しい値にカードを再設定するよう使われるべきです。 .Sh 使用例 NWID を 0x1234 に設定する : @@ -126,6 +126,9 @@ CRC status : OK .Xr wl 4, .Xr sysctl 8 . .Sh 歴史 -.Nm wlconfig +.Nm コマンドのこの実装は完全に新規のもので、Hilink Internet のために -Michael Smith により書かれ、Jim Binkley &c により更新されました。 +.An Michael Smith +により書かれ、 +.An Jim Binkley &c +により更新されました。 diff --git a/ja_JP.eucJP/man/man8/wormcontrol.8 b/ja_JP.eucJP/man/man8/wormcontrol.8 index 1aefce1c9c..1b1010bf90 100644 --- a/ja_JP.eucJP/man/man8/wormcontrol.8 +++ b/ja_JP.eucJP/man/man8/wormcontrol.8 @@ -32,7 +32,7 @@ .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" -.\" %Id: wormcontrol.8,v 1.3.2.2 1997/03/06 08:00:45 mpp Exp % +.\" %Id: wormcontrol.8,v 1.3.2.3 1997/11/18 07:28:14 charnier Exp % .\" jpman %Id: wormcontrol.8,v 1.3 1997/08/16 13:45:04 horikawa Stab % .\" .\" arrgh, hilit19 needs this" :-( @@ -48,16 +48,6 @@ .Ar command .Op Ar params... .Sh 解説 -.Ss オプション -.Bl -tag -ident -width "XXX" -.It Fl f Ar device -デフォルトの -.Pa /dev/rworm0 -に代えて、デバイス -.Ar device -を使用します。 -.El -.Ss 概略 .Nm は、書き込み可能 CD .Pq CD-R @@ -94,8 +84,14 @@ CD-R させなければなりません。 これは目録とリードアウト情報をディスクに書き込む処理であり、 この処理をしなくてはディスクは利用できません。 -.Ss コマンド -.Bl -tag -indent -width "prepdisk" +以下のオプションを指定可能です: +.Bl -tag -width ident +.It Fl f Ar device +デフォルトの +.Pa /dev/rworm0 +ではなく +.Ar device +を使用します。 .It select Ar vendor-id model-id 残念なことに、各 CD-R ドライブベンダは独自の SCSI コマンドセットを 実装することになってしまいました。従って @@ -186,7 +182,7 @@ CD-R 内部で呼び出される .Xr ioctl 2 コマンドのエラーコードが -.Xr perror 3 +.Xr err 3 機能によって表示されます。 .Sh 使用例 データ CD-R を焼く典型的な手順はこのようになります: @@ -218,7 +214,7 @@ CD-R .Xr dd 1 , .Xr team 1 , .Xr ioctl 2 , -.Xr perror 3 , +.Xr err 3 , .Xr worm 4 .Pp .Pa /usr/share/examples/worm/* diff --git a/ja_JP.eucJP/man/man8/xntpd.8 b/ja_JP.eucJP/man/man8/xntpd.8 index 83d1c12104..6c06271233 100644 --- a/ja_JP.eucJP/man/man8/xntpd.8 +++ b/ja_JP.eucJP/man/man8/xntpd.8 @@ -96,8 +96,8 @@ xntpd - Network Time Protocol .PP 通常、 .I xntpd -は、起動時にコンフィギュレーションファイルから設定を読込みます。デフォ -ルトのコンフィギュレーションファイル名は、 +は、起動時にコンフィギュレーションファイルから設定を読込みます。 +デフォルトのコンフィギュレーションファイル名は、 .IR /etc/ntp.conf ですが、コマンドラインの指定の方が優先します。また、もっぱらコマンド ラインだけで、その局面に役立つ @@ -113,21 +113,21 @@ xntpd - Network Time Protocol .IR ntpq (8) および .IR xntpdc (8) -を使用することで、デーモンのさまざまな内部変数を表示したり設定オプショ -ンを変更できます。 +を使用することで、デーモンのさまざまな内部変数を表示したり +設定オプションを変更できます。 .PP デーモンはアクティブ/パッシブ, クライアント/サーバ, ブロードキャスト /マルチキャスト等の対称的なモードを含むいずれかのモードで働くことが -できます。ブロードキャストもしくはマルチキャスト・クライアントは、自 -動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 +できます。ブロードキャストもしくはマルチキャスト・クライアントは、 +自動的にリモートサーバを探し出し、片道の遅延補正因子を計算して、自動的 に自身に対する設定を行います。これにより、その環境に固有の詳細な設定 -やコンフィギュレーションファイルなしに、一群のワークステーションを配 -置することが可能になります。 +やコンフィギュレーションファイルなしに、一群のワークステーションを +配置することが可能になります。 .PP 以下にあげるコマンドライン引数が .I xntpd -により理解されます。(より完全な機能の説明については、コンフィギュレー -ションファイルの説明を参照のこと): +により理解されます。(より完全な機能の説明については、 +コンフィギュレーションファイルの説明を参照のこと): .Ip -a 8 「認証」 (\*(L"authenticate\*(R") モードで実行します。 @@ -146,15 +146,15 @@ driftfile .Ip -k 8 NTP の認証キーを含むファイルのある場所を指定します。 .Ip -m 8 -マルチキャストメッセージを待受けて、可能ならそれらに同期します (マル -チキャストカーネルが必要になります)。 +マルチキャストメッセージを待受けて、可能ならそれらに同期します ( +マルチキャストカーネルが必要になります)。 .Ip -p 8 デーモンのプロセス ID を記録するためのファイル名を指定します。 .Ip -r 8 -通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバとク -ライアントとの間のネットワーク遅延を自動的に補正します。遅延の測定作 -業が失敗した場合には、ここで指定した (秒の) デフォルトの遅延を使用す -るようになります。 +通常、デーモンは、ブロードキャストもしくはマルチキャストのサーバと +クライアントとの間のネットワーク遅延を自動的に補正します。 +遅延の測定作業が失敗した場合には、ここで指定した (秒の) デフォルトの +遅延を使用するようになります。 .Ip -s 8 統計ファイルを作成するためのディレクトリを指定します。 .Ip "-t trustedkey" 8 @@ -166,16 +166,17 @@ NTP .SH "コンフィギュレーションオプション" .I xntpd -のコンフィギュレーションファイルのフォーマットは、他の Unix コンフィ -ギュレーションファイルのものに似ています。コメントは文字 \*(L"#\*(R" -で始まり、行末まで続きます。空行は無視されます。設定コマンドは、行頭 -のキーワードとそれに続く空白で区切られた引数のリストからなります。引 -数の内いくつかは、省略可能な場合があります。これらのコマンドは複数行 -にわたってはなりません。引数は、ホスト名, ドットで区切られた 4 つ組 -の数からなる (dotted-quad) 形式のホストアドレス, 整数, 浮動少数点数 -(秒で時間を指定する際用います), テキスト文字列などです。以下の説明で -は、省略可能な引数は、\*(L"[]\*(R" で囲み、複数択一の引数は、互いに -\*(L"|\*(R" で区切って表します。 +のコンフィギュレーションファイルのフォーマットは、 +他の Unix コンフィギュレーションファイルのものに似ています。 +コメントは文字 \*(L"#\*(R" で始まり、行末まで続きます。空行は無視されます。 +設定コマンドは、行頭のキーワードとそれに続く空白で区切られた +引数のリストからなります。引数の内いくつかは、省略可能な場合があります。 +これらのコマンドは複数行にわたってはなりません。 +引数は、ホスト名, ドットで区切られた 4 つ組の数からなる (dotted-quad) 形式の +ホストアドレス, 整数, 浮動少数点数 (秒で時間を指定する際用います), +テキスト文字列などです。 +以下の説明では、省略可能な引数は、\*(L"[]\*(R" で囲み、 +複数択一の引数は、互いに \*(L"|\*(R" で区切って表します。 .PP .B peer .I host_address @@ -214,39 +215,39 @@ NTP .I # ] .PP -これらの 3つのコマンドは、利用されるべき時間サーバや与えられるべき時 -間サービスを指定します。 +これらの 3つのコマンドは、利用されるべき時間サーバや与えられるべき +時間サービスを指定します。 .B peer コマンドは、ローカルサーバが、コマンド中の .I host_address で示されるリモートサーバに対し、「対称的アクティブ」 (\*(L"symmetric active\*(R") モードで動作するよう指示します。これは、さまざまな失敗 -の仕方によって、ローカルもしくはリモートのサーバホストのいずれかがよ -り良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ +の仕方によって、ローカルもしくはリモートのサーバホストのいずれかが +より良い時刻供給源となり得るようなサーバのネットワークにおいて、役立つ ものです。 .B server -コマンドは、ローカルサーバが、指定したリモートサーバに対して \*(L"ク -ライアント\*(R" モードで動作するよう指示します。このモードでは、ロー -カルサーバはリモートサーバに同期しますが、リモートサーバがローカルサー -バに同期することは決してありません。 +コマンドは、ローカルサーバが、指定したリモートサーバに +対して \*(L"クライアント\*(R" モードで動作するよう指示します。 +このモードでは、ローカルサーバはリモートサーバに同期しますが、 +リモートサーバがローカルサーバに同期することは決してありません。 .B broadcast -コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで動 -作するよう指示します。ローカルサーバは、コマンド中で指定されるブロー -ドキャスト/マルチキャスト/アドレスを持つクライアント集団に、定期的に -ブロードキャストメッセージを送ります。通常、この指示は、送信側 -(transmitter) として動作しているローカルサーバにのみ適用されます。 +コマンドは、ローカルサーバが、\*(L"ブロードキャスト\*(R" モードで +動作するよう指示します。ローカルサーバは、コマンド中で指定される +ブロードキャスト/マルチキャスト/アドレスを持つクライアント集団に、 +定期的にブロードキャストメッセージを送ります。通常、この指示は、 +送信側 (transmitter) として動作しているローカルサーバにのみ適用されます。 ブロードキャストクライアントに対する動作については、以下に説明する .B broadcastclient もしくは .B multicastclient コマンドの項を参照して下さい。このモードでは、 .I host_address -は、通常、そのローカルネットワーク (もしくは複数のローカルネットワー -クの内のひとつ)の上でのブロードキャストアドレスであるか、NTP に割当 -てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が割 -当てられてきました。現在のところは、このアドレスのみを使用すべきです。 +は、通常、そのローカルネットワーク (もしくは複数の +ローカルネットワークの内のひとつ)の上でのブロードキャストアドレスであるか、 +NTP に割当てられたマルチキャストアドレスです。NTPには、アドレス 224.0.1.1 が +割当てられてきました。現在のところは、このアドレスのみを使用すべきです。 マルチキャスト機能はマルチキャストカーネルを必要としますが、これは、 -まだ、どのベンダーの製品にでも存在するものではないということに注意し +まだ、どのベンダの製品にでも存在するものではないということに注意し て下さい。 .PP .B key @@ -262,9 +263,9 @@ active\*(R") 全ての点では同等ですが、正常に動作している一群のホストの中から同期を 取る対象として選ばれます。 .B ttl -オプションは、ブロードキャストモードでのみ使用され、マルチキャストパ -ケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 です -が、適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 +オプションは、ブロードキャストモードでのみ使用され、マルチキャスト +パケットで用いられる生存時間 (TTL) を指定します。デフォルトは 127 ですが、 +適切な値を選択することは、黒魔術の一種であり、ネットワーク管理者 との調整を必要とします。 .PP .B broadcastclient @@ -274,11 +275,10 @@ active\*(R") します。ローカルサーバは、最初のブロードキャストメッセージを受取る際、 リモートサーバとクライアント/サーバ間の短いやりとりを用いて、名目上 の (nominal) ネットワーク遅延を測定してから、後続のブロードキャスト -メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライア -ント\*(R" モードに入ります。このモードでの偶然もしくは故意の分裂状態 +メッセージを待ち受けて、それに同期する\*(L"ブロードキャストクライアント\*(R" +モードに入ります。このモードでの偶然もしくは故意の分裂状態 を避けるため、ローカルとリモートのサーバの両方は認証に同一の信頼でき -るキーとキー識別子を使用して動作しなくてはならないことに注意して下さ -い。 +るキーとキー識別子を使用して動作しなくてはならないことに注意して下さい。 .PP .B multicastclient [ @@ -288,8 +288,8 @@ active\*(R") このコマンドは、 .IR broadcastclient コマンドと同じように用いられますが、IP マルチキャストを使用して動作 -します。この機能をサポートするには、マルチキャストカーネルと認証の使 -用が必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ +します。この機能をサポートするには、マルチキャストカーネルと認証の使用が +必要です。1 つ以上の IP アドレスが与えられると、サーバはそれぞれ のマルチキャストグループに加わります。1 つも与えられなければ、NTP に は IP アドレス (224.0.1.1) が割当てられていると想定されます。 .PP @@ -297,40 +297,40 @@ active\*(R") .I filename .PP このコマンドは、ローカルの時計発振子の周波数オフセットを記録するため -のファイル名を指定します。このファイルが存在すると、起動時に初期周波 -数オフセットを指定するのに使用され、その後デーモンにより計算されるカ -レント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 +のファイル名を指定します。このファイルが存在すると、起動時に初期周波数 +オフセットを指定するのに使用され、その後デーモンにより計算される +カレント周波数オフセットで、 1 時間に 1 度更新されます。ファイルが存在 しないか、このコマンドが与えられていない場合、初期周波数オフセットは ゼロと仮定されます。この場合、周波数が安定し、残った時間誤差が収まる -のに数時間かかります。このファイルが、最初にカレント変動値を一時ファ -イルに書込み、 +のに数時間かかります。このファイルが、最初にカレント変動値を一時 +ファイルに書込み、 .IR rename (3) により古いファイルと置換えることで更新されることに注意して下さい。これは、 .I xntpd が、 ドリフトファイルのあるディレクトリに対し書込み権を持っていなけ -ればならず、ファイルは、シンボリックであろうとなかろうと、ファイルシ -ステムリンクであるべきではないだろうことを意味しています。 +ればならず、ファイルは、シンボリックであろうとなかろうと、 +ファイルシステムリンクであるべきではないだろうことを意味しています。 .PP .B enable auth|bclient|pll|monitor|stats [ .I ... ] .PP -さまざまなサーバオプションを有効にします。指定されていないフラグは影 -響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 -できるキーとキー識別子を使用して正しく認証されている場合に限って、サー -バが指定されていない相手に同期するようにします。このフラグのデフォル -トは無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード +さまざまなサーバオプションを有効にします。指定されていないフラグは +影響を受けません。\*(L"auth\*(R" フラグは、その通信相手 (peer) が信頼 +できるキーとキー識別子を使用して正しく認証されている場合に限って、サーバが +指定されていない相手に同期するようにします。このフラグのデフォルトは +無効 (オフ) です。 \*(L"bclient\*(R" フラグは、サーバがブロード キャストもしくはマルチキャストサーバからのメッセージを待受けるように します。これにより、そのサーバに対する連携 (association) が自動的に 成立します。このフラグのデフォルトは無効 (オフ) です。 \*(L"pll\*(R" フラグは、サーバのローカル時計を調整するようにします。デフォルトでは 有効 (オン) です。無効にした場合、ローカル時計は固有の時間と周波数の -まま動きます。このフラグは、ローカル時計が他の何らかのデバイスやプロ -トコルにより制御されており、NTPは他のクライアントと同期をとるためだ -けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、モ -ニタファシリティ (facility) を有効にします(下記参照のこと)。デフォル -トでは有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ +まま動きます。このフラグは、ローカル時計が他の何らかのデバイスや +プロトコルにより制御されており、NTPは他のクライアントと同期をとるためだ +けに使用されている場合に、役立ちます。\*(L"monitor\*(R" フラグは、 +モニタファシリティ (facility) を有効にします(下記参照のこと)。デフォルトでは +有効 (オン) です。\*(L"stats\*(R" フラグは、統計のファシリティ の filegen (下記説明を参照のこと) を有効にします。デフォルトでは有効 (オン) です。 .PP @@ -339,9 +339,9 @@ active\*(R") .I ... ] .PP -さまざまなサーバオプションを無効にします。指定されていないフラグは影 -響を受けません。現在使用可能なオプションは、enable コマンドの項で説 -明しています。 +さまざまなサーバオプションを無効にします。指定されていないフラグは影響を +受けません。現在使用可能なオプションは、enable コマンドの項で説明 +しています。 .SH "認証オプション" .PP @@ -350,8 +350,8 @@ active\*(R") .PP このコマンドは、認証モードでの操作の際、 .I xntpd -により使用される暗号化キーとキー識別子を含むファイルの名前を指定しま -す。このファイルのフォーマットは以降で説明します。 +により使用される暗号化キーとキー識別子を含むファイルの名前を指定します。 +このファイルのフォーマットは以降で説明します。 .PP .B trustedkey .I # @@ -361,9 +361,9 @@ active\*(R") .PP このコマンドは、同期するのにふさわしい通信相手を認証する目的にとって 信用できる暗号化キー識別子を指定するのに使用されます。異なるサーバは -異なるキーを使用できますが、認証手続きにはローカルとリモート両方のサー -バがこの目的のため同一のキーとキー識別子を共有することが必要です。引 -数は、32bitの符合なし整数ですが、 NTP キー 0 は固定されており周知の +異なるキーを使用できますが、認証手続きにはローカルとリモート両方の +サーバがこの目的のため同一のキーとキー識別子を共有することが必要です。 +引数は、32 ビット符合なし整数ですが、 NTP キー 0 は固定されており周知の ものであることに注意してください。意味のある認証が行われるべきならば、 キー 0 は信用すべきではありません。 .PP @@ -376,13 +376,15 @@ active\*(R") .IR xntpdc (8) プログラムにより使用されるキー識別子を指定します。 .I xntpdc -プログラムの動作は、 xntpd のこの固有の実装に特定されており、これお -よび以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル -サーバの状態に影響を与えるリモートの xntpdc プログラムからの要求は、 -認証されねばなりません。そのためには、リモートプログラムとローカルサー -バが共通のキーとキー識別子を共有することが必要です。このコマンドの引 -数は、32bitの符合なし整数です。コンフィギュレーションファイルに -.B requestkey +プログラムの動作は、 xntpd のこの固有の実装に特定されており、これ +および以前のバージョンのデーモンとのみ動作すると見込まれます。ローカル +サーバの状態に影響を与えるリモートの +.I xntpdc +プログラムからの要求は、 +認証されねばなりません。そのためには、リモートプログラムとローカル +サーバが共通のキーとキー識別子を共有することが必要です。このコマンドの引数は、 +32 ビット符合なし整数です。コンフィギュレーションファイルに +.B controlkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 .PP @@ -400,10 +402,10 @@ active\*(R") の動作は RFC 1305 の定義を満たしています。ローカルサーバの状態に影響 を与えるリモートの .I ntpq -プログラムからの要求は、認証されねばなりません。そのためには、リモー -トプログラムとローカルサーバが共通のキーとキー識別子を共有することが -必要です。このコマンドの引数は、32bitの符合なし整数です。コンフィギュ -レーションファイルに +プログラムからの要求は、認証されねばなりません。そのためには、リモート +プログラムとローカルサーバが共通のキーとキー識別子を共有することが +必要です。このコマンドの引数は、32 ビット符合なし整数です。 +コンフィギュレーションファイルに .B requestkey コマンドが含まれていないか、キーがマッチしないと、この要求は無視され ます。 @@ -411,8 +413,8 @@ active\*(R") .B authdelay .I seconds .PP -ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の総 -計を示します。この値は、送出パケットに認証が用いられる際、送信タイム +ローカル計算機上で NTP 認証フィールドを暗号化するのに要する時間の +総計を示します。この値は、送出パケットに認証が用いられる際、送信タイム スタンプを修正するのに使用されます。通常、この値は 0.0001 秒から 0.003 秒あたりになりますが、これはホスト計算機の CPU 速度に依存して います。通常、この値は、ディストリビューションに含まれている @@ -436,30 +438,30 @@ active\*(R") いるかどうか調べられます。ここで、最後にマッチしたものが受信パケット に関する制限フラグを定義します。受信パケットのソースアドレスは、制限 リストのエントリに関するマスクでアンドをとられた 32 ビットアドレスと -マッチするか調べられ、それからエントリアドレス (これもまたマスクとア -ンドをとられます) と比較され、マッチするものを探します。引数 +マッチするか調べられ、それからエントリアドレス (これもまたマスクと +アンドをとられます) と比較され、マッチするものを探します。引数 \*(L"mask\*(R" のデフォルトは 255.255.255.255 で、\*(L"address\*(R" -が個別のホストのアドレスとして扱われることを意味します。デフォルトエ -ントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の +が個別のホストのアドレスとして扱われることを意味します。デフォルト +エントリ (address 0.0.0.0, mask 0.0.0.0) は常にリストに含まれ、既定の ソートアルゴリズムでは、リストの先頭のエントリとなります。 -\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask オプ -ションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルトエン -トリを示すために使用できることに、注意して下さい。 +\*(L"address\*(R" は、通常、 dotted\-quad 形式で与えられ、 mask +オプションを伴わないテキスト文字列 \*(L"default\*(R" は、デフォルト +エントリを示すために使用できることに、注意して下さい。 .PP 現在の実装では、フラグは常にアクセスを制限します。すなわち、フラグを -持たないエントリは、サーバへの自由なアクセスが与えられることを示すこ -とになります。フラグは直交的ではなく、より制限の強いフラグは、より制 -限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 -されます。時間サービスを制限するものと、情報問い合わせやサーバの実 -行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する +持たないエントリは、サーバへの自由なアクセスが与えられることを示す +ことになります。フラグは直交的ではなく、より制限の強いフラグは、より +制限の弱いフラグを冗長にします。フラグは、一般に 2 つのカテゴリに分類 +されます。時間サービスを制限するものと、情報問い合わせやサーバの +実行時再設定の試みを制限するものです。次のフラグの内1つ以上を指定する ことができます: .Ip ignore 10 -このエントリにマッチするホストからのすべてのパケットを無視します。こ -のフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ +このエントリにマッチするホストからのすべてのパケットを無視します。 +このフラグが指定されると、問い合わせも時間サーバへのポーリングも応答さ れなくなります。 .Ip noquery 10 -NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要 -求) を無視します。時間サービスは影響を受けません。 +NTP の モード 6 と 7のすべてのパケット (つまり情報問い合わせと設定要求) +を無視します。時間サービスは影響を受けません。 .Ip nomodify 10 サーバの状態を変えようとするモード 6 と 7のすべてのパケット (つまり 実行時再設定) を無視します。情報を返す問い合わせは許されます。 @@ -472,9 +474,9 @@ NTP マッチしたホストによるトラップセットを低い優先度として宣言します。1 つのサーバが保持し得るトラップの数は制限されています(現在の制限値は 3 です)。トラップは通常、先入れ先処理ベースで割当てられ、後から来た -トラップ要求はサービスを拒否されます。このフラグは、通常優先度のトラッ -プに対する後からの要求が、低い優先度のトラップより優先されることを許 -すことで、通常の割当てアルゴリズムを変更します。 +トラップ要求はサービスを拒否されます。このフラグは、通常優先度の +トラップに対する後からの要求が、低い優先度のトラップより優先されることを +許すことで、通常の割当てアルゴリズムを変更します。 .Ip noserve 10 モード 6 と 7 以外のすべての NTP パケットを無視します。基本的には、 時間サービスは拒否されますが、それでも問い合わせは許されています。 @@ -490,11 +492,11 @@ NTP ます。ここで言うネットとは、 (class A, class B, class C 等の) ネット の IP 表記のことです。サーバで見えており、過去 \*(L"client_limit_period\*(R" 秒の間アクティブであった、最初の -\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一のネッ -トの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 +\*(L"client_limit\*(R" 個のホストのみが、受付けられます。同一の +ネットの他のクライアントからの要求は拒否されます。時間要求パケットのみが、 考慮されます。\*(L"プライベート\*(R"", \*(L"制御\*(R"", \*(L"ブロー -ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、ク -ライアントの数の内には入れられません。クライアントの履歴は、 +ドキャスト\*(R" 等のパケットは、クライアント制限の対象にはならず、 +クライアントの数の内には入れられません。クライアントの履歴は、 .I xntpd のモニタリング機能を使用して維持されます。それゆえ、モニタリングは、 \*(L"limited\*(R" フラグに制限エントリがある限り、アクティブです。 @@ -509,53 +511,52 @@ UDP されます。 .PP デフォルトの制限リストエントリは、フラグ \*(L"ignore, ntpport\*(R" -を持ち、ローカルホストのインターフェイスアドレスの各々に対し、スター -トアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと +を持ち、ローカルホストのインタフェースアドレスの各々に対し、 +スタートアップ時にテーブルに挿入され、サーバがそれ自身の時間に同期しようと しないようにします。また、デフォルトエントリは常に存在しますが、他で は設定されない場合は、どのフラグもデフォルトエントリに関連づけられま -せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になりま -す) 。 +せん (すなわち、あなた自身の NTP サーバ以外のすべてが無制限になります) 。 .PP -制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在のア -クセスポリシが、 +制限ファシリティは、NSFnet の幹線上で動いている時間サーバの現在の +アクセスポリシが、 .I xntpd と同様に実装され得るように、付け加えられたものです。このファシリティ は、あなたのサーバが、望まないか故障したリモート時間サーバの影響を受 -けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証ファ -シリティの代わりになると考えるべきではありません。ソースアドレスに基 -づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 +けないようにするのに、ことのほか有用ですが、これが 標準の NTP 認証 +ファシリティの代わりになると考えるべきではありません。ソースアドレスに +基づく制限は、確信犯的クラッカーにたやすく裏をかかれます。 .PP .B clientlimit .I limit .PP -\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント制 -限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される +\*(L"client_limit\*(R" を \*(L"limit\*(R" にセットし、クライアント +制限ポリシの設定を可能にします。この変数は、そのサーバの使用を許される 同一ネットワークからのクライアント数を定義します。 .PP .B clientperiod .I period .PP \*(L"client_limit_period\*(R" をセットし、クライアント制限ポリシの設 -定を可能にします。この変数は、その時間後にクライアントがインアクティ -ブになると考えられ、従って制限されるクライアント数にもはや数えられな +定を可能にします。この変数は、その時間後にクライアントがインアクティブに +なると考えられ、従って制限されるクライアント数にもはや数えられな くなるような秒数を指定します。 .SH "モニタリングオプション" .PP .B statsdir .I /directory path/ .PP -統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参 -照)。このキーワードにより (そうでなければ定数である) filegen ファイ -ル名のプレフィックスを統計ログ処理に対して用いられるファイル生成セッ -トに対して修正することが可能となります (下記 +統計ファイルが作られるべきディレクトリのフルパスを指定します(下記参照)。 +このキーワードにより (そうでなければ定数である) filegen ファイル名の +プレフィックスを統計ログ処理に対して用いられるファイル生成セットに対して +修正することが可能となります (下記 .B filegen 文を参照)。 .PP .B statistics .IR name \.\.\. .PP -統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポー -トされています。 +統計レコードの書込みを有効にします。現在のところ、3 種類の統計がサポート +されています。 .Ip loopstats 10 ループフィルタの統計情報の記録を有効にします。ローカル時計の更新を 行う度に、\*(L"loopstats\*(R" と名付けられたファイル生成セットに次の @@ -566,26 +567,26 @@ UDP .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次の 3 つのフィールドは、時計の更新時の、秒 -での時間オフセット, 100 万分の 1 単位の周波数オフセット, +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次の 3 つのフィールドは、時計の更新時の、 +秒での時間オフセット, 100 万分の 1 単位の周波数オフセット, clock-discipline アルゴリズムの時定数です。 .RE .Ip peerstats 10 通信相手に関する統計情報の記録を有効にします。これには、存在し初期化 -された NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコー -ドが含まれます。有効な更新が行われる度に、 \*(L"peerstats\*(R" と名 -付けられたファイル生成セットの現在の要素に次の形式の行を出力します: +された NTP サーバと 1-pps シグナルのすべての通信相手に関する統計レコードが +含まれます。有効な更新が行われる度に、 \*(L"peerstats\*(R" と +名付けられたファイル生成セットの現在の要素に次の形式の行を出力します: .PP .RS 5 48773 10847.650 127.127.4.1 9714 -0.001605 0.00000 0.00142 .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ -dotted-quad 記法で表された通信相手のアドレスとステータスです。ステー -タスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次の 2 つのフィールドは、それぞれ +dotted-quad 記法で表された通信相手のアドレスとステータスです。 +ステータスフィールドは、 NTP の仕様である RFC 1305 の Appendix A で記述さ れたフォーマットに従い 16 進数にエンコードされています。最後の 3 つ のフィールドは、オフセット, 遅延, ばらつきで、すべて秒単位です。 .RE @@ -599,10 +600,10 @@ dotted-quad .RE .RS 10 -最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC 午 -前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された -時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイ -ムコードで、ここでは意味のある ASCII 形式になっています。いくつかの +最初の 2 つのフィールドは、日付 (ユリウス歴に修正済) と時刻 (UTC +午前 0 時からの秒数)です。次のフィールドは、dotted-quad 記法で表された +時計のアドレスです。最後のフィールドは、時計から受け取った最後のタイム +コードで、ここでは意味のある ASCII 形式になっています。いくつかの 時計ドライバでは、たくさんの付加的情報が集められ、同様に表示されます。 より詳しくは、それぞれの時計の仕様情報を参照してください。 .RE @@ -612,8 +613,8 @@ dotted-quad を参照)を用いて管理されます。統計を記録することで得られる情報は、 .I xntpd サーバの一時的なプロパティ (properties) の解析を可能にします。通常は -主要な (primary) サーバで役立つだけで、あるいはキャンパスのメインサー -バーでも役立つかもしれません。 +主要な (primary) サーバで役立つだけで、あるいはキャンパスのメイン +サーバでも役立つかもしれません。 .PP .B filegen .I name @@ -634,9 +635,9 @@ dotted-quad .PP ファイル生成セット (file generation set) .IR name -の設定を行います。ファイル生成セットは、サーバーの活動期間を通じて継 -続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計はこ -のようなファイルの典型例です。ファイル生成セットにより、現状のデータ +の設定を行います。ファイル生成セットは、サーバの活動期間を通じて +継続的に大きくなっていくファイルを扱う手段を提供します。サーバ統計は +このようなファイルの典型例です。ファイル生成セットにより、現状のデータ を格納するのに用いられるファイル集合にアクセスできます。任意の時点で、 集合の高々 1 つの要素への書き込みが行われます。 .I type @@ -651,11 +652,10 @@ dotted-quad .Ip prefix 10 不変なファイル名のパスです。 .B filegen -文による修正の対象にはなりません。サーバによって定義され、通常コンパ -イル時の定数として指定されます。しかし、他のコマンドにより、個別のファ -イル生成セットに対して設定は可能です。たとえば、"loopstats" と -"peerstats" という filegen で用いられるプレフィックスは、すでに説明 -した +文による修正の対象にはなりません。サーバによって定義され、通常コンパイル時の +定数として指定されます。しかし、他のコマンドにより、個別のファイル生成 +セットに対して設定は可能です。たとえば、"loopstats" と +"peerstats" という filegen で用いられるプレフィックスは、すでに説明した .B statsdir 文を使用して設定できます。 .Ip filename 10 @@ -707,19 +707,19 @@ dotted-quad .I 週 という用語は、年の始まりからの日数の 7 の商により定義されます。この ようなファイル生成セットの要素は、ファイル集合のファイル名のベースに -次のようなサフィックスをつけることで区別されます。サフィックスは、ドッ -ト, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 -年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つファ -イルに出力されます。 +次のようなサフィックスをつけることで区別されます。サフィックスは、 +ドット, 4 桁の西暦年, 文字 \*(L"W\*(R", 2 桁の週番号です。例えば、 1992 +年 1 月 10 日からの情報は、サフィックス \*(L".1992W1\*(R" を持つ +ファイルに出力されます。 .Ip month 10 -1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ -フィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 +1 月に 1 つのファイル生成セットの要素が作成されます。ファイル名の +サフィックスは、ドット, 4 桁の西暦年, 2 桁の月からなります。 .Ip year 10 -1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名のサ -フィックスは、ドットと 4 桁の西暦年からなります。 +1 年に 1 つのファイル生成セットの要素が作成されます。ファイル名の +サフィックスは、ドットと 4 桁の西暦年からなります。 .Ip age 10 -この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要 -素に変わります。ファイル名のサフィックスは、ドット, 文字 +この型のファイル生成セットは、サーバが 24 時間活動するごとに新たな要素に +変わります。ファイル名のサフィックスは、ドット, 文字 \*(L"a\*(R", 8 桁の数からなります。この数は、対応する 24 時間の始め からサーバが実行されている秒数であるようになります。 .PP @@ -730,14 +730,14 @@ dotted-quad .I 現在の 要素に決まった名前でアクセスできると便利です。この機能は、 \*(L"link\*(R" を指定することで有効になり、 \*(L"nolink\*(R" を使っ -て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素からサ -フイックスを持たないファイルへのハードリンクが作成されます。その名前 +て無効になります。 \*(L"link\*(R" が指定されると、 現在の要素から +サフイックスを持たないファイルへのハードリンクが作成されます。その名前 を持つファイルが既に存在し、そのファイルのリンク数が 1 の場合、その ファイル名に、ドット, 文字 \*(L"C\*(R", .I xntpd -サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 以 -上の場合、ファイルはアンリンクされます。これにより現在のファイルを定 -数名でアクセスすることができます。 +サーバプロセスの pid をつなげて、名前変更を行います。リンク数が 1 +以上の場合、ファイルはアンリンクされます。これにより現在のファイルを +定数名でアクセスすることができます。 .SH "その他のオプション" .PP .B precision @@ -752,10 +752,10 @@ dotted-quad .B broadcastdelay .I seconds .PP -ブロードキャストおよびマルチキャストモードは、ローカルとリモートサー -バ間のネットワーク遅延を決定するため、特別の修正を必要とします。通常、 +ブロードキャストおよびマルチキャストモードは、ローカルとリモートサーバ間の +ネットワーク遅延を決定するため、特別の修正を必要とします。通常、 この修正は、ローカルとリモートサーバ間の最初のプロトコル交換により、 -自動的に行われます。修正手続きは、例えば、ネットワークもしくはサーバー +自動的に行われます。修正手続きは、例えば、ネットワークもしくはサーバ のアクセス制御のために失敗する可能性があります。このコマンドは、これ らの状況下で使用されるデフォルトの遅延を指定します。(イーサネットに 対する)典型としては、0.003 から 0.007 秒が適切です。このコマンドが使 @@ -771,12 +771,12 @@ dotted-quad .I interface_addess ] .PP -このコマンドは、指定されたローカルインターフェイスに送られるメッセー -ジに対する、所与のホストアドレスとポート番号でのトラップレシーバを設 -定します。ポート番号が指定されない場合、 18447 が使用されます。イン -ターフェイスアドレスが指定されない場合、メッセージが送信時に通過する -ローカルインターフェイスのアドレスをソースアドレスとしてメッセージが -送られます。マルチホームのホストでは、使用されるインターフェイスが、 +このコマンドは、指定されたローカルインタフェースに送られる +メッセージに対する、所与のホストアドレスとポート番号でのトラップレシーバを +設定します。ポート番号が指定されない場合、 18447 が使用されます。 +インタフェースアドレスが指定されない場合、メッセージが送信時に通過する +ローカルインタフェースのアドレスをソースアドレスとしてメッセージが +送られます。マルチホームのホストでは、使用されるインタフェースが、 ルーティングの変更にともない変化し得ることに注意してください。 .PP トラップレシーバは、一般には、イベントメッセージやサーバからのその他 @@ -789,8 +789,8 @@ dotted-quad .I variable .I [default] .PP -このコマンドは、付加的なシステム変数を追加します。これらの変数は、ア -クセスポリシなどの付加的な情報を配布するために使用できます。 +このコマンドは、付加的なシステム変数を追加します。これらの変数は、 +アクセスポリシなどの付加的な情報を配布するために使用できます。 = の形式の変数に、キーワード .I default が続いた場合、変数はデフォルトのシステム変数の一部としてリストされる @@ -820,8 +820,8 @@ dotted-quad コマンドに置き換えられました。ここにあげたのは歴史を述べるためです。 .SH "認証キーファイルのフォーマット" .PP -NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケッ -ト内の認証の指示を与えるための拡張を定めています。これは、 +NTP 標準は、受信した NTP パケットの認証の確認を可能とし、送信パケット内の +認証の指示を与えるための拡張を定めています。これは、 .I xntpd においては、デジタル署名, あるいは message-digest を計算するため、 DES もしくは MD5 アルゴリズムを使用して実装されています。この仕様は、 @@ -839,8 +839,8 @@ DES .B keys 文を使用して指定されるファイルからキーを読み込みます。キー番号 0 は、 NTP 標準によって (56 ビットの 0 として) 決定されており、変更できませ -んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任 -意にセットできます。 +んが、一方、1 から 15 のキー番号の内の 1 つ以上がキーファイル中で任意に +セットできます。 .PP キーファイルは、コンフィギュレーションファイルと同様のコメント記述法 を使用しています。キーエントリはの形式の固定されたフォーマットを @@ -897,11 +897,11 @@ NTP 標 コンパイルできます。参照時計は、一般に (常にではなく)、カナダの NRC やアメリカの NIST により提供されるサービスと同様の標準時刻の供給源に 同期している無線時刻コード受信機です。コンピュータと時刻コード受信機 -の間のインターフェイスはデバイス依存で多種にわたりますが、多くはシリ -アルポートです。 +の間のインタフェースはデバイス依存で多種にわたりますが、多くは +シリアルポートです。 .PP -多種類の参照時計ドライバに対するサポートは、他の場所で記述されたコン -パイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 +多種類の参照時計ドライバに対するサポートは、他の場所で記述された +コンパイラ定義のコードを使用して、条件コンパイルされます。参照時計を設定 しようとする試みは、特定のサポートが得られないか、ハードウェアポート が適切に設定されていないとき、システムログファイルに警告を残しますが、 そのほかでは障害となりません。 @@ -917,8 +917,8 @@ NTP 標 .I t は、時計の型を示す整数で、 .I u -は、型で特定されるユニット番号を示します。参照時計は、コンフィギュレー -ションファイル中の +は、型で特定されるユニット番号を示します。参照時計は、コンフィギュレーション +ファイル中の .B server 文を使用して設定されます。このときの .I host_address @@ -974,13 +974,12 @@ NTP 標 と .B time2 オプションは、秒単位の固定小数点で指定され、いくつかの時計ドライバで -は、補正定数として使用されます。慣習により、別のやり方で示されない限 -り、 +は、補正定数として使用されます。慣習により、別のやり方で示されない限り、 .B time1 は、特定の時計の名目上の時間オフセットを、高精度の PPS 信号のような、 外部の標準に一致させるように調整するための補正定数として使用されます。 -指定されたオフセットは、内部の DIP スイッチのような他の手段により与 -えられた伝搬遅延に付加されます。 +指定されたオフセットは、内部の DIP スイッチのような他の手段により与えられた +伝搬遅延に付加されます。 .B stratum オプションは 0 から 15 までの数で、時計に対し非標準の operating stratum を割当てるのに使用します。 @@ -1001,12 +1000,12 @@ stratum .B flag4 は、 .I filegen -コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリ -ングデータの記録を有効にするために使用されます。 ppsclock ストリーム -モジュールについてのさらなる情報は、現在の xntp3 プログラムのディス -トリビューション中の ./kernel ディレクトリの README ファイル内にあり -ます。この機能についてのさらなる情報は、同じディストリビューション中 -の ./scripts/stats ディレクトリにあります。 +コマンドで設定される時計統計 (clockstats) ファイルへの詳細なモニタリング +データの記録を有効にするために使用されます。 ppsclock ストリーム +モジュールについてのさらなる情報は、現在の xntp3 プログラムの +ディストリビューション中の ./kernel ディレクトリの README ファイル内にあり +ます。この機能についてのさらなる情報は、 +同じディストリビューション中の ./scripts/stats ディレクトリにあります。 .PP 通常、参照時計の stratum は、デフォルトで 0 です。 .I xntpd @@ -1025,16 +1024,16 @@ discipline 現在、Unix マシン上の .I xntpd は、バックアップとして用いられる、あるいは他の時計供給源が与えられな -いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計ハー -ドウェアをサポートしています。たいていの時計ドライバの場合、xntp3 プ -ログラムのディストリビューション中の ./doc ディレクトリの README ファ -イル内で述べられているように 1-pps 精度のタイミング信号に対するサポー -トが利用可能です。時計ドライバ、およびそれらを設定するのに使用される +いとき使用される特殊な仮想時計に加えて、いくつかの異なる型の時計 +ハードウェアをサポートしています。たいていの時計ドライバの場合、xntp3 +プログラムのディストリビューション中の ./doc ディレクトリの README +ファイル内で述べられているように 1-pps 精度のタイミング信号に対する +サポートが利用可能です。時計ドライバ、およびそれらを設定するのに使用される アドレスは、現在の xntp3 プログラムのディストリビューション中の doc ディレクトリの README.refclocks で記述されています。 .PP .SH 変数 - NTP protocol により用いられるたいていの変数は、 +NTP protocol により用いられるたいていの変数は、 .I xntpdc (モード 7 メッセージ) と .I ntpq @@ -1059,8 +1058,8 @@ discipline .Ip 01/10 8 リープ秒が、付加/削除されます (オペレータによるリープ秒の強制)。 .Ip 11 8 -同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が与 -えられます) 。 +同期源からのリープ情報は、無視されます (それゆえ LEAP_NOWARNING が +与えられます) 。 .PP .SH 関連ファイル .Ip /etc/ntp.conf 20 @@ -1077,13 +1076,13 @@ discipline .SH 歴史 .PP .Nm -コマンドはトロント大学の Dennis Ferguson によって書かれました。テキ -ストはデラウェア大学の David Mills により修正されました。 +コマンドはトロント大学の Dennis Ferguson によって書かれました。 +テキストはデラウェア大学の David Mills により修正されました。 .SH バグ .PP .I xntpd -はかなり大きくなってしまいました。巨大とは言いませんが、ワークステー -ションで実行される可変プライオリティのデーモンとして望ましい大きさを +はかなり大きくなってしまいました。巨大とは言いませんが、ワークステーションで +実行される可変プライオリティのデーモンとして望ましい大きさを 超えてしまいました。それは特に、かさばる凝った特徴の多くが、高い stratum のワークステーションよりは、高負荷の主要 (primary) サーバに あわせて設計されているからです。 diff --git a/ja_JP.eucJP/man/man8/xtend.8 b/ja_JP.eucJP/man/man8/xtend.8 index acbb04180c..d56721a474 100644 --- a/ja_JP.eucJP/man/man8/xtend.8 +++ b/ja_JP.eucJP/man/man8/xtend.8 @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: xtend.8,v 1.4 1996/09/23 22:23:09 wosch Exp % +.\" %Id: xtend.8,v 1.4.2.1 1997/12/18 07:37:46 charnier Exp % .\" jpman %Id: xtend.8,v 1.2 1997/06/16 08:01:33 yugawa Stab % .\" .Th XTEND 8 "30 Oct 1993" @@ -35,56 +35,61 @@ .Dt XTEND 8 .Os BSD FreeBSD .Sh 名称 -xtend \- X-10 デーモン +.Nm xtend +.Nd X-10 デーモン .Sh 書式 -.Nm xtend +.Nm /usr/libexec/xtend .Sh 解説 -.Nm xtend +.Nm は、ユーザレベルのプログラムと TW523 X-10 コントローラとのインターフェイスを 行います。TW523 から受信した全てのパケットを記録し、全ての X-10 デバイスの 状態を可能な限り追跡し、X-10 デバイスの操作を必要とするユーザレベルの クライアントプログラムからのソケット接続を受け付けます。 .Pp -.Nm xtend +.Nm を起動すると、自分自身をフォークし、制御端末を切り離し、以降発生する 全ての X-10 の活動状況と診断メッセージを記録するログファイルを開きます。 その後、TW523 から受信したパケットの処理を開始し、X-10 のコマンドを発行する -クライアントの接続を 1 度に ひとつだけ受け付けます。通常、 xtend は、 -.Pa /etc/rc.local +クライアントの接続を 1 度にひとつだけ受け付けます。 +.Nm +は、 +.Pa /etc/rc.conf +スクリプトにて有効に設定された場合、 +.Pa /etc/rc.i386 起動スクリプトから実行されます。 .Pp -.Nm xtend +.Nm に SIGHUP を送ると、ログファイルを一旦閉じ、再び開きます。これは、 ログファイルの肥大化を避けるために、シェルスクリプトによりログファイルを 変更する場合に便利でしょう。 -.Nm xtend +.Nm が SIGTERM を受け取ると、素直にシャットダウンし、終了します。 SIGPIPE を送ると、 -.Nm xtend +.Nm は現在のクライアント接続を強制的に切り離します。 .Pp -.Nm xtend +.Nm は、クライアントのプロセスと、単純なプロトコルを用いて通信を行います。 このプロトコルは、クライアントから送られる 1 行のコマンドに対して、 デーモンが 1 行の応答を行うような単純な物です。 .Pp -.Nm xtend -には、4 種類のコマンドがあります。コマンド +.Nm +には、4 種類のコマンドがあります。コマンド: .Bl -tag .It status H U .El .Pp に対して、 -.Nm xtend +.Nm は指定されたデバイスの状態を 1 行で返答します。ここで、H はハウスコードを 示す 1 文字で、U は数字のユニットコードです。 -コマンド +コマンド: .Bl -tag .It send H U N .El .Pp に対して、 -.Nm xtend +.Nm は指定された X-10 の送信を行います。ここで、H はハウスコードを示す 1 文字で、 U は数字のユニットコードまたはリストに対する機能コード( .Pa xtend/packet.c @@ -96,25 +101,27 @@ OK .B ERROR と応答します。 -コマンド +コマンド: .Bl -tag .It dump .El .Pp に対して、 -.Nm xtend -はスプールディレクトリの ASCII ファイルに全てのデバイスの現在の状態を +.Nm +はスプールディレクトリの +.Tn ASCII +ファイルに全てのデバイスの現在の状態を ダンプします。状態のダンプに成功したかどうかに関わらず、 .B OK と応答します。 -コマンド +コマンド: .Bl -tag .It monitor H U .El .Pp に対して、 -.Nm xtend +.Nm は指定された X-10 デバイスに関する活動状況を報告するクライアントのリストに、 現在のクライアントのソケット接続を加えます。 リスト中のクライアント数の最大値 (現状では 5) を超えなければ、 @@ -124,10 +131,10 @@ OK .B ERROR を返答します。その後、 -.Nm xtend +.Nm クライアントからの接続を受け付ける通常モードに戻ります。 しかし、それ以降に指定されたデバイスの状態が変化すると、 -.Nm xtend +.Nm は ( .B status @@ -153,16 +160,18 @@ pid .It Pa /var/spool/xten/Status デバイス状態ファイル(バイナリ) .It Pa /var/spool/xtend/status.out -デバイス情報の ASCII ダンプ +デバイス情報の +.Tn ASCII +ダンプ .El .Sh バグ 現状では、クライアントのソケット接続にタイムアウトはありません。そのため、 ハングしたクライアントプログラムがあると、他のクライアントはデーモンに アクセスする事ができなくなります。 .Pp -.Nm xtend +.Nm はできる限りデバイスの状態を追跡しますが、デバイスが手動で操作された ことを知る方法はありません。これは、ほとんどの X-10 デバイスが状態の 問い合わせに対して応答する事ができないからです。 .Sh 作者 -Eugene W. Stark (stark@cs.sunysb.edu) +.An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja_JP.eucJP/man/man8/yp_mkdb.8 b/ja_JP.eucJP/man/man8/yp_mkdb.8 index b0cec06a7f..53bb573aac 100644 --- a/ja_JP.eucJP/man/man8/yp_mkdb.8 +++ b/ja_JP.eucJP/man/man8/yp_mkdb.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yp_mkdb.8,v 1.2.2.2 1997/04/15 08:04:48 jmg Exp % +.\" %Id: yp_mkdb.8,v 1.2.2.3 1997/11/18 07:32:58 charnier Exp % .\" jpman %Id: yp_mkdb.8,v 1.3 1997/05/19 17:09:21 horikawa Stab % .\" .Dd March 12, 1996 @@ -48,6 +48,7 @@ .Op Fl s .Op Fl i Ar inputfile .Op Fl o Ar outputfile +.Op Fl d Ar domainname .Op Fl m Ar mastername .Ar inputfile .Ar dbname @@ -58,40 +59,42 @@ スタイルのデータベースを作成します。 .Nm yp_mkdb はデータを -.Nm inputfile +.Ar inputfile から読み取り、 そのデータを -.Nm dbname +.Ar dbname に .Xr db 3 フォーマットで書き込みます (ハッシュテーブル法を使用します)。 入力は 'key data' の形式、 -すなわち空白で区切られた 2 つの ASCII データフィールドである必要があります。 +すなわち空白で区切られた 2 つの +.Tn ASCII +データフィールドである必要があります。 1 番目のフィールドはキーであるとされ、他は全てデータであるとされます。 通常、データベースが格納されるのは -.Nm /var/yp/[domainname] +.Pa /var/yp/[domainname] です。ここで、 -.Nm domainname +.Ar domainname はサーバが対象とする NIS ドメイン名です。 .Nm yp_mkdb が起動されるのは、通常 -.Nm /var/yp/Makefile +.Pa /var/yp/Makefile からです。 -.Nm yp_mkdb +.Nm で NIS データベースファイルをダンプし、内容検査を行えます。 セキュリティのため、 -.Nm yp_mkdb +.Nm が作成した全てのデータベースは、オーナのみ読み書き可能です (通常オーナは root です)。 .Sh オプション .Nm yp_mkdb コマンドは以下のフラグとオプションをサポートしています: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl c YPPROC_CLEAR リクエストをローカルホスト上の .Xr ypserv 8 宛に送ることを -.Nm yp_mkdb +.Nm に指示します。 このシグナルにより、 サーバはオープンしているデータベースデスクリプタをクローズし、 @@ -99,14 +102,14 @@ YPPROC_CLEAR このフラグを単体で使用した場合、 サーバにシグナルを送るだけで他には何もしません。 データベース作成コマンドとともに使用した場合には、 -.Nm yp_mkdb +.Nm は新たなデータベースが成功裏に作成された後にのみシグナルを送ります。 .It Fl b このフラグを指定すると、キーが .Em YP_INTERDOMAIN でありデータフィールドが空である特別のエントリの データベースへの追加を -.Nm yp_mkdb +.Nm に指示します。 このキーがマップ中に存在すると、 .Xr ypserv 8 @@ -124,7 +127,6 @@ YPPROC_CLEAR 他のマップに .Fl b フラグを使用しても効果はありません。 -.Pp .It Fl s このフラグは、キーが .Em YP_SECURE @@ -137,48 +139,48 @@ YPPROC_CLEAR これは主に、特権アクセスのみに制限しなければならない .Em master.passwd マップのために使用します。 -.Pp .It Fl u Ar dbname -.Pp NIS データベースをダンプします('ほどき'ます)。 既に存在する NIS データベースの内容を検査するために使用可能です。 -.It Op Fl i Ar inputfile -.Pp +.It Fl i Ar inputfile NIS マップ作成時に、キーが .Em YP_INPUT_FILE であり -.Nm inputfile +.Ar inputfile がエンコードされた特別なエントリをデータベース中に作成します。 -.It Op Fl o Ar outputfile -.Pp +.It Fl o Ar outputfile NIS マップ作成時に、キーが .Em YP_OUTPUT_FILE で -.Nm outputfile +.Ar outputfile がエンコードされた特別なエントリをデータベース中に作成します。 -.Pp -.It Op Fl m Ar mastername -.Pp +.It Fl d Ar domainname +NIS マップ作成時に、キーが +.Em YP_DOMAIN_NAME +であり +.Ar domainname +がエンコードされた特別なエントリをデータベース中に作成します。 +.It Fl m Ar mastername NIS マップ作成時に、キーが .Em YP_MASTER_NAME であり -.Nm mastername +.Ar mastername がエンコードされた特別なエントリをデータベース中に作成します。 データベース中のこのエントリは、 ドメイン中の NIS マスタサーバの名前を判定するために、 様々な NIS ユーティリティからしばしば使用されます。 デフォルトでは、 -.Nm yp_mkdb +.Nm はローカルホストが NIS マスタであるとします; -.Ar m +.Fl m オプションをすればこのデフォルトを上書きできます。 .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /var/yp/Makefile -compact .It Pa /var/yp/Makefile -.Nm yp_mkdb +.Nm を呼び出し NIS データベースを作成する Makefile .Sh 関連項目 .Xr db 3 , .Xr ypserv 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/ypbind.8 b/ja_JP.eucJP/man/man8/ypbind.8 index 008193a93b..59ad6076c5 100644 --- a/ja_JP.eucJP/man/man8/ypbind.8 +++ b/ja_JP.eucJP/man/man8/ypbind.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypbind.8,v 1.5.2.2 1997/04/15 08:09:11 jmg Exp % +.\" %Id: ypbind.8,v 1.5.2.3 1997/11/18 07:37:39 charnier Exp % .\" jpman %Id: ypbind.8,v 1.4 1997/06/18 16:55:44 horikawa Stab % .\" .Dd April 9, 1995 @@ -66,18 +66,17 @@ NIS .Nm はサーバがもう実行していないものとし、 別サーバにバインドされるまでネットワークブロードキャストを再開します。 -.Nm ypbind +.Nm は、サーバが返答しなかったことを検知するたび および新たなサーバにバインドされるたび、 警告メッセージを .Xr syslog 3 の機能を使用して記録します。 -.Pp .Sh オプション 以下のオプションが .Nm にてサポートされています: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl ypset .Xr ypset 8 コマンドを使用し、 @@ -101,17 +100,14 @@ YPBINDPROC_SETDOM フラグに似ていますが、YPBINDPROC_SETDOM リクエストがローカルホスト発の場合のみ 処理を許すという点のみ異なります。 .It Fl s -.Fl s -フラグを指定すると .Nm を安全モードで実行します: root 以外により実行されている NIS サーバ (つまり、特権 TCP ポートを使用していないもの)へのバインドを拒否します。 .It Fl S Ar domainname,server1,server2,server3,... システム管理者は -.Fl S -フラグを指定する事により、 -ypbind を特定のドメインおよび NIS サーバグループへロック出来ます。 +.Nm +を特定のドメインおよび NIS サーバグループへロック出来ます。 10 サーバまで指定できます。 domain/server 指定においては、コンマの間には空白を入れてはなりません。 このオプションを指定する事により、 @@ -151,10 +147,10 @@ domain/server .Nm はデフォルトドメインへのバインドを自動的に保持します。 .Sh 関連ファイル -.Bl -tag -width Pa -compact +.Bl -tag -width /etc/rc.conf -compact .It Pa /var/yp/binding/[domainname].[version] NIS ドメインに関連したバインド情報を保持するファイル。 -.It Pa /etc/sysconfig +.It Pa /etc/rc.conf システムデフォルトのドメインと ypbind 開始オプションを指定する コンフィギュレーションファイル。 .El @@ -165,4 +161,4 @@ NIS .Xr ypserv 8 , .Xr ypset 8 .Sh 作者 -Theo de Raadt +.An Theo de Raadt Aq deraadt@fsa.ca diff --git a/ja_JP.eucJP/man/man8/yppush.8 b/ja_JP.eucJP/man/man8/yppush.8 index 39f2b7fdef..40cc97e6aa 100644 --- a/ja_JP.eucJP/man/man8/yppush.8 +++ b/ja_JP.eucJP/man/man8/yppush.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: yppush.8,v 1.4 1996/04/03 03:23:59 wpaul Exp % +.\" %Id: yppush.8,v 1.4.2.1 1997/11/18 07:45:16 charnier Exp % .\" jpman %Id: yppush.8,v 1.3 1997/09/09 04:08:40 yugawa Stab % .\" .Dd February 5, 1995 @@ -57,14 +57,16 @@ からのみ起動されます。 .Pa /var/yp/Makefile はデフォルトでは -.Nm yppush +.Nm を起動しない事に注意して下さい: これを変えるにはまず、Makefile 中の .Nm NOPUSH=True エントリをコメントアウトしなければなりません -(デフォルトの FreeBSD の設定は小さなネットワークに +(デフォルトの +.Bx Free +の設定は小さなネットワークに 単一の NIS サーバがある状況を想定しています; この様な設定では -.Nm yppush +.Nm は不要です)。 .Pp デフォルトでは、 @@ -81,48 +83,46 @@ コピーされるマップ名と .Xr ypxfr 8 が -.Nm yppush +.Nm に `コールバック' して転送を完遂するために必要な特別な情報とが、 各リクエストに含まれます。 コールバックにおいて -.Nm yppush +.Nm が .Xr ypxfr 8 から受け取るエラーメッセージは全て標準エラー出力に出力されます。 .Pp .Sh オプション -.Nm yppush -は以下のオプションをサポートしています: -.Bl -tag -width flag +以下のオプションが使用可能です: +.Bl -tag -width indent .It Fl d Ar domain ドメイン名を指定します。 ローカルホストの NIS ドメイン名がデフォルトで使用されます。 ローカルホストのドメイン名が設定されていない場合には、 このフラグでドメイン名を指定しなければなりません。 .It Fl t Ar timeout -.Fl t -フラグにてタイムアウト値を秒単位で指定します。 +タイムアウト値を秒単位で指定します。 このタイムアウトは、 -.Nm yppush +.Nm がリスト中の次のスレーブサーバ宛にマップ転送要求を送る前に 返答をどれくらい待つかを制御します。 .It Fl j Ar #parallel jobs .Nm yppush -は通常、転送を逐次的に行います。これはどういうことかというと、 -マップ転送要求をスレーブサーバに送り、 +は通常、転送を逐次的に行います。すなわち、 +マップ転送要求を一つのスレーブサーバに送り 次のスレーブサーバに取り掛かる前に返答を待つということです。 多くのスレーブがいる環境では、 同時に複数のマップ転送を開始し、転送を並列に行う方が効率が良くなります。 .Fl j フラグにて並列処理するジョブ数を指定します: -.Nm yppush +.Nm は指定された数の転送をすぐに開始し、返答を待ちます。 並列ジョブ数がスレーブ数より少ない場合は、 -.Nm yppush +.Nm は指定されたジョブ数の処理のみを開始し、返答を待ち、 処理が完了してから残りの処理に取り掛かります。 .Pp -.Nm yppush +.Nm はコールバックを非同期に取り扱う事に注意して下さい。 これはどういうことかというと、 全てのマップ転送要求を送信する前であろうとも、 @@ -130,8 +130,6 @@ からコールバック情報を受け取るとすぐに、 この情報を表示する事を意味します。 .It Fl h Ar host -.Fl h -フラグにて、 .Pa ypservers マップ中のサーバのリストの代わりに、 ユーザが指定するマシンもしくはマシンのグループ宛にマップを転送できます。 @@ -140,7 +138,7 @@ フラグを使用します。 .It Fl p Ar path デフォルトでは、 -.Nm yppush +.Nm は全てのローカル NIS マップは .Pa /var/yp 以下に格納してあると期待しています。 @@ -149,10 +147,10 @@ システム管理者が NIS マップを別の場所に格納する状況に対処できます。 .It Fl v 冗長モード: -.Nm yppush +.Nm の実行時にデバッグ情報を表示させます。 このフラグを 2 回指定すると、 -.Nm yppush +.Nm はより冗長に情報を表示します。 .Sh 関連ファイル .Bl -tag -width Pa -compact @@ -166,7 +164,7 @@ .Sh バグ NIS v1 における NIS マップ転送機構は NIS v2 におけるものとは異なります。 このバージョンの -.Nm yppush +.Nm は NIS v2 システム宛のマップ転送のみをサポートしています。 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu diff --git a/ja_JP.eucJP/man/man8/ypserv.8 b/ja_JP.eucJP/man/man8/ypserv.8 index a021d730b7..ad8b3494ad 100644 --- a/ja_JP.eucJP/man/man8/ypserv.8 +++ b/ja_JP.eucJP/man/man8/ypserv.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypserv.8,v 1.8.2.2 1997/04/15 08:12:11 jmg Exp % +.\" %Id: ypserv.8,v 1.8.2.3 1997/11/18 07:52:07 charnier Exp % .\" jpman %Id: ypserv.8,v 1.3 1997/05/19 17:11:16 horikawa Stab % .\" .Dd February 4, 1995 @@ -44,26 +44,34 @@ .Op Fl p Ar path .Sh 解説 .Tn NIS -は RPC ベースのサービスであり、多くの UNIX ベースのマシン間で -共通のコンフィギュレーションファイルの集合を共有する事ができます。 -NIS では、 +は複数の UNIX ベースのマシン間で +共通のコンフィギュレーションファイルの集合を共有するための +RPC ベースのサービスです。 +.Tn NIS +では、 .Pa /etc/hosts , .Pa /etc/passwd , .Pa /etc/group といった、ほとんどの環境で頻繁に更新されるファイルの複数のコピーを システム管理者が更新する必要は無く、 -一箇所で更新可能な 1 組のデータを計算機の集合が共有する事を許します。 +計算機のグループで一箇所で更新可能な 1 組のデータを共有することができます。 .Pp .Nm -は NIS +は +.Tn NIS .Em ドメイン -内のクライアントシステムに NIS データベースを配布するサーバです。 -NIS ドメイン内のクライアントは +内のクライアントシステムに +.Tn NIS +データベースを配布するサーバです。 +.Tn NIS +ドメイン内のクライアントは .Xr domainname 1 コマンドを使用し、 .Nm がサービスしているドメイン名を設定しなければなりません。 -単一 NIS ドメイン中に複数のサーバが存在しうるため、 +また、単一 +.Tn NIS +ドメイン中に複数のサーバが存在しうるため、 クライアントは、 .Xr ypbind 8 を実行させ、特定のサーバに接続する必要もあります。 @@ -80,33 +88,42 @@ NIS .Nm デーモンにて全て処理可能です。 .Pp -データベース、(もしくはしばしば +データベース (もしくはしばしば .Pa マップ -と呼ばれます)は、様々なシステムファイルを元に +と呼ばれます)は、様々なシステムファイルをソースとして .Pa /var/yp/Makefile -から作成されます。 +によって作成されます。 データベースファイルは .Xr db 3 フォーマットであり、レコード数が多くとも高速に検索可能です。 -FreeBSD では、セキュリティのため、マップの読み書きは root のみ可能です。 -技術的には、パスワードマップのみこの様な制限が必要です。 +.Bx Free +では、セキュリティのため、マップの読み書きは root のみ可能です。 +技術的には、このような制限はパスワードマップにのみ必要ですが、 他のマップの内容は誰もが読める他のファイルに書いてありますので、 -この様な制約は害ではなく、現実的だと考えられています。 +この様な制約は害ではなく、現実的であると考えられています。 .Pp .Nm は -.Pa /etc/sysconfig +.Pa /etc/rc.conf にて有効にされている場合に -.Pa /etc/rc +.Pa /etc/rc.network から起動されます。 .Sh 特別な仕様 -FreeBSD のパスワードデータベースを NIS にて配布する場合には問題があります: -FreeBSD は通常、暗号化したパスワードを、root のみ読み書き可能な +.Bx Free +のパスワードデータベースを +.Tn NIS +によって配布する場合にいくつかの問題があります。 +.Bx Free +は通常、暗号化したパスワードを、root のみ読み書き可能な .Pa /etc/master.passwd -に格納します。 -このファイルを NIS マップにすると、セキュリティが完全に破れてしまいます。 +にのみ格納します。 +このファイルを +.Tn NIS +マップにすると、セキュリティが完全に破れてしまいます。 .Pp -これに対処するために、FreeBSD の +これに対処するために、 +.Bx Free +の .Nm は .Pa master.passwd.byname @@ -120,14 +137,16 @@ FreeBSD サーバはこれを利用して特権ユーザからの要求か否かを判定できます。 非特権ユーザからの全ての要求は拒否されます。 .Pp -また、FreeBSD の標準 C ライブラリ中の +また、 +.Bx Free +の標準 C ライブラリ中の .Xr getpwent 3 ルーチンは、スーパユーザが使用した場合には .Pa master.passwd.byname と .Pa master.passwd.byuid -のマップからデータを取得します: 通常のユーザが使用した場合には、 -標準の +のマップからデータを取得します。 +通常のユーザがこれらのルーチンをコールした場合には、標準の .Pa passwd.byname と .Pa passwd.byuid @@ -139,12 +158,16 @@ FreeBSD 非特権ユーザに渡しても安全です。 このように .Pa master.passwd -データベースのシャドウパスワード機構は NIS においても守られます。 +データベースのシャドウパスワード機構は +.Tn NIS +においても守られます。 .Pp .Sh 注釈 .Ss 制限 -NIS 環境にてシャドウパスワードを使用する事に起因する問題が 2 つあります。 -ユーザは次の事に気を付けねばなりません: +.Tn NIS +環境にてシャドウパスワードを使用することに起因する問題が 2 つあります。 +ユーザは次のことに気をつけねばなりません。 +.Pp .Bl -enum -offset indent .It .Sq TCP ポートが 1024 より小さい @@ -153,17 +176,25 @@ NIS これを破る事が可能です (UNIX ベースではないオペレーティングシステムを実行するマシンでも可能です)。 .It -FreeBSD システムを、シャドウパスワードをサポートしない非 FreeBSD クライアント -(ほとんどがそうです)に対するサーバにしようとしている場合には、 +.Bx Free +システムを、シャドウパスワードをサポートしない非 +.Bx Free +クライアント +(ほとんどがそうです) に対するサーバにしようとしている場合には、 .Pa /var/yp/Makefile の .Em UNSECURE=True エントリのコメントを外し、 シャドウパスワードを無効にする必要があります。 +これにより、 .Pa passwd.byname と .Pa passwd.byuid -のマップに、非 FreeBSD クライアントが NIS を通じてユーザ認証を +のマップに、非 +.Bx Free +クライアントが +.Tn NIS +を通じてユーザ認証を 行うために必要とする、 有効な暗号化されたパスワードフィールドが含まれるようになります。 .El @@ -171,10 +202,12 @@ FreeBSD .Ss セキュリティ 一般的に、リモートユーザは、ドメイン名を知ってさえいれば、RPC を .Nm -に発行し、NIS マップの内容を取得可能です。 +に発行し、 +.Tn NIS +マップの内容を取得可能です。 このような権限の無いトランザクションを防ぐために、 .Nm -は +には .Pa securenets と呼ばれる、あるホストの集合にのみアクセスを制限する機能があります。 起動時に、 @@ -184,7 +217,7 @@ FreeBSD から読み込みます。 (後述するように、このパスは、 .Fl p -オプションによって指定するパスによって変化する事に注意して下さい。) +オプションによって指定するパスによって変化することに注意して下さい。) このファイルは、空白によって区切られるネットワークとネットワークマスクからなる エントリを複数含みます。 .Dq \&# @@ -215,14 +248,17 @@ securenets .Em tcpwrapper パッケージをサポートしますが、 .Em tcpwrapper -パッケージは FreeBSD とともに配布されていないため、 +パッケージは +.Bx Free +とともに配布されていないため、 デフォルトでは組み込まれていません。 +しかし .Pa libwrap.a と .Pa tcpd.h -を持っているならば、容易に +があれば、容易に .Nm -をリコンパイル出来ます。 +を再コンパイルすることができます。 これにより、アクセス管理のために、 システム管理者は tcpwrapper のコンフィグレーションファイル ( @@ -235,38 +271,49 @@ securenets の代わりに使用できます。 .Pp 注: どちらのアクセス制御もそれなりのセキュリティを提供しますが、 -特権ポートテストと同様、 -.Dq IP 詐称(spoofing) +特権ポートテストと同様に +.Dq IP 詐称 (spoofing) 攻撃には無力であることに 注意して下さい。 .Pp .Ss NIS v1 互換性 このバージョンの .Nm -は NIS v1 クライアントに対してある程度サービス可能です。 -FreeBSD の NIS 実装は NIS v2 プロトコルのみを使用しますが、 -他の実装は古いシステムとのバックワードコンパチビリティのために -v1 プロトコルのサポートを含みます。 -このようなシステムに提供されている +は +.Tn NIS +v1 クライアントに対してある程度サービス可能です。 +.Bx Free +の +.Tn NIS +実装は +.Tn NIS +v2 プロトコルのみを使用しますが、 +他の実装では古いシステムとのバックワードコンパチビリティのために +v1 プロトコルもサポートしています。 +そのようなシステムで提供されている .Xr ypbind 8 -デーモンは、実際にはそうする事が不要であっても、 -NIS v1 サーバにバインドしようとします。 +デーモンは、実際にはおそらく不要なのですが、 +.Tn NIS +v1 サーバにバインドしようとします。 (そして、v2 サーバから返答を受け取ったとしてもサーバを探すために -ブロードキャストし続けます)。 -通常のクライアントの呼び出しがサポートされていますが、 +ブロードキャストし続けます。) このバージョンの .Nm -は v1 マップ転送要求を扱いません; -すなわち、古い NIS サーバとともに、マスタとしてもしくはスレーブとして -使用する事は出来ません。 -好運なことに、今日ではこの様なサーバは存在しない事でしょう。 +では通常のクライアントの呼び出しはサポートされていますが、 +v1 マップ転送要求は扱いません。 +すなわち、古い +.Tn NIS +サーバとともに、マスタもしくはスレーブとして使用することはできません。 +好運なことに、今日ではこの様なサーバは存在しないでしょう。 .Ss NIS クライアントでもある NIS サーバ 複数のサーバが存在するドメインにおいて、 -サーバが NIS クライアントでもある場合には、 +サーバが +.Tn NIS +クライアントでもある場合には、 .Nm の実行に注意を払う必要があります。 バインド要求をブロードキャストさせてサーバ間でバインドさせるのではなく、 -サーバを自分自身にバインドすることは一般的には良い考えです: +サーバを自分自身にバインドすることは一般的には良い考えです。 あるサーバがダウンし、他のサーバがそのサーバに依存していた場合には、 奇妙な障害が生じ得ます。(結果として全てのクライアントがタイムアウトし、 他のサーバにバインドしようとしますが、遅延は無視できず、 @@ -278,7 +325,7 @@ NIS v1 .Sh オプション 以下のオプションが .Nm -にてサポートされています: +にてサポートされています。 .Bl -tag -width flag .It Fl n このオプションは @@ -295,7 +342,7 @@ NIS v1 .Fl n フラグを指定すると、 .Nm -はさらなる処理を行います: +はさらなる処理を行います。 すぐにあきらめずに、ホスト名もしくはアドレスを DNS ネームサーバに問い合わせて 解決しようとします。 問い合わせが成功すると、 @@ -305,15 +352,21 @@ NIS v1 .Pp この仕様は SunOS 4.1.x との互換性のために用意されています。 そのシステムの標準 C ライブラリではリゾルバが腐っており、 -ホスト名とアドレスの解決のために NIS に依存していました。 -FreeBSD のリゾルバは DNS への問い合わせを直接行えますので、 -FreeBSD である NIS クライアントに対してのみサービスする場合は、 +ホスト名とアドレスの解決のために +.Tn NIS +に依存していました。 +.Bx Free +のリゾルバは DNS への問い合わせを直接行えますので、 +.Bx Free +である +.Tn NIS +クライアントに対してのみサービスする場合は、 このオプションを有効にする必要はありません。 .It Fl d サーバをデバッグモードで実行します。 通常 .Nm -は異常時のエラー(アクセス違反、ファイルアクセス失敗)のみを +は異常時のエラー (アクセス違反、ファイルアクセス失敗) のみを .Xr syslog 3 機能を使用して報告します。 デバッグモードでは、サーバは自身をバックグラウンドでは実行せず、 @@ -330,21 +383,26 @@ yp_all .It Fl p Ar path 通常 .Nm -は NIS マップは +は +.Tn NIS +マップは .Pa /var/yp -以下にあるものと期待します。 +以下にあるものと想定します。 .Fl p -フラグを使用し、別の NIS ルートパスを指定できますので、 +フラグを使用し、別の +.Tn NIS +ルートパスを指定できますので、 システム管理者はファイルシステム中の別の場所にマップファイルを移動できます。 .El .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /var/yp/[domainname]/[maps] -NIS マップ。 +.Tn NIS +マップ .It Pa /etc/host.conf -リゾルバ構成ファイル。 +リゾルバ構成ファイル .It Pa /var/yp/securenets -ホストアクセス制御ファイル。 +ホストアクセス制御ファイル .El .Sh 関連項目 .Xr ypcat 1 , @@ -355,7 +413,7 @@ NIS .Xr yppush 8 , .Xr ypxfr 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu .Sh 歴史 このバージョンの .Nm diff --git a/ja_JP.eucJP/man/man8/ypset.8 b/ja_JP.eucJP/man/man8/ypset.8 index 5cdbc60a19..25be2a654e 100644 --- a/ja_JP.eucJP/man/man8/ypset.8 +++ b/ja_JP.eucJP/man/man8/ypset.8 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypset.8,v 1.1.2.1 1997/03/06 08:01:10 mpp Exp % +.\" %Id: ypset.8,v 1.1.2.2 1997/11/18 07:54:08 charnier Exp % .\" jpman %Id: ypset.8,v 1.2 1997/04/06 14:59:23 horikawa Stab % .\" .Dd October 25, 1994 @@ -86,4 +86,4 @@ YP .Xr ypmatch 1 , .Xr ypbind 8 , .Sh 作者 -Theo De Raadt +.An Theo De Raadt diff --git a/ja_JP.eucJP/man/man8/ypxfr.8 b/ja_JP.eucJP/man/man8/ypxfr.8 index bc0b6c3579..0ff35e8943 100644 --- a/ja_JP.eucJP/man/man8/ypxfr.8 +++ b/ja_JP.eucJP/man/man8/ypxfr.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" %Id: ypxfr.8,v 1.3 1996/06/05 05:42:47 wpaul Exp % +.\" %Id: ypxfr.8,v 1.3.2.1 1997/12/19 07:35:33 charnier Exp % .\" jpman %Id: ypxfr.8,v 1.3 1997/09/09 04:09:30 yugawa Stab % .\" .Dd February 5, 1995 @@ -38,7 +38,7 @@ .Nm ypxfr .Nd "リモートのサーバからローカルホストへ NIS データベースを転送する" .Sh 書式 -.Nm ypxfr +.Nm /usr/libexec/ypxfr .Op Fl f .Op Fl c .Op Fl d Ar target domain @@ -49,26 +49,43 @@ .Ar mapname .Sh 解説 .Nm ypxfr -は NIS サービスを使用し、NIS データベース(または +は +.Tn NIS +データベース(または .Pa マップ ) -を NIS サーバから別のホストにコピーします。FreeBSD では一般的に、 +を +.Tn NIS +サービスを使用し、ある +.Tn NIS +サーバから別のサーバにコピーします。 +.Bx Free +では一般に、 +.Nm +は .Xr yppush 8 からマップ転送要求を受け取った .Xr ypserv 8 から -.Nm ypxfr -が起動されます。 -基本的には、 -.Nm ypxfr -が使用されるのは、複数の NIS サーバが単一ドメイン内で使用される環境です。 -あるサーバ(NIS マスタ)は全ての NIS マップの基準となるコピーを管理します。 -その他のサーバ(NIS スレーブ)は、(ユーザが +起動されます。 +基本的に、 +.Nm +を使用するのは、単一ドメイン内で複数の +.Tn NIS +サーバが使用される環境です。 +一台のサーバ( +.Tn NIS +マスタ)は全ての +.Tn NIS +マップの基準となるコピーを管理します。 +その他のサーバ( +.Tn NIS +スレーブ)は、マップに更新があったとき (例えば、ユーザが .Xr yppasswd 1 -を用いてパスワードを更新した時等)マップに更新があった時に、 +を用いてパスワードを更新したとき)に、 新しいバージョンのマップをマスタからコピーします。 .Pp 実行時、 -.Nm ypxfr +.Nm は一時データベースファイルを .Pa /var/yp/[domainmame] に作成し、 @@ -78,26 +95,29 @@ .Ar mapname の内容で埋めます。 マップ全体の転送が完了すると、 -.Nm ypxfr +.Nm は .Ar mapname -のオリジナルのコピーを消去し、一時ファイルを代わりにそこに置きます。 +の古いコピーを消去し、代わりに一時ファイルを置きます。 転送完了時に、 -.Nm ypxfr -は `現在のマップをクリア' する要求を、 -古いマップを参照しているかもしれないのでそれをクリアさせなければならない、 +.Nm +は `現在のマップのクリア' 要求を、 ローカルの .Xr ypserv 8 -プロセス宛に送信しようとします。 +プロセス宛に送信し、 +古いマップを参照している場合にはクリアさせようとします。 .Pp -.Nm ypxfr +.Nm が作成した全てのファイルがオーナのみ読み書き可能なのは、 セキュリティのためである事に注意して下さい。 -NIS マップとそれを格納するディレクトリは通常 root が所有しますので、 +.Tn NIS +マップとそれを格納するディレクトリは通常 root が所有しますので、 非特権ユーザによる権限の無い変更を防ぎます。 .Pp -全ての NIS サーバ間で一貫性を保持するために -.Nm ypxfr +全ての +.Tn NIS +サーバ間で一貫性を保持するために +.Nm を .Xr cron 8 ジョブとして定期的に実行する事が出来ます。 @@ -107,104 +127,138 @@ NIS .Pa passwd.byname や .Pa passwd.byuid ) -はおそらく 1 時間に 1 度変更すべきでしょう。 +はおそらく 1 時間に 1 度更新すべきでしょう。 .Xr cron 8 を使用し NIS マップを自動的に更新する事は厳密には必須ではありません。 -なぜなら、全ての更新は NIS マスタサーバ上で +なぜなら、全ての更新は +.Tn NIS +マスタサーバ上で .Pa /var/yp/Makefile が実行された時に .Xr yppush 8 にて伝搬されているはずだからです。 -ただし、通信不能となって NIS サーバ間で同期が取れなくなる事があるような +ただし、通信不能となって +.Tn NIS +サーバ間で同期が取れなくなる事があるような 大きなネットワークでは、良い実現方式です。 .Pp -.Nm ypxfr +.Nm が制御端末無しで起動された場合、例えば .Xr ypserv 8 内部から起動された場合には、 .Xr syslog 3 機構を使用して、全ての出力のログを取ります。 .Sh 注釈 -FreeBSD の -.Nm ypxfr -は FreeBSD の +.Bx Free +バージョンの +.Nm +は +.Bx Free +の .Xr rpc.ypxfrd 8 サーバと連動する特別なマップ転送プロトコルをサポートします。 このプロトコルは、 -生のマップデータベースファイルを NIS マスタサーバから転送する事を許しますので、 -特に大きな NIS マップの場合は、標準の転送方法よりも数倍高速です。 -.Nm ypxfr -コマンドは NIS マスタサーバ上に +生のマップデータベースファイルを +.Tn NIS +マスタサーバから転送する事を許しますので、 +特に大きな +.Tn NIS +マップの場合は、標準の転送方法よりも数倍高速です。 +.Nm +コマンドは +.Tn NIS +マスタサーバ上に .Xr rpc.ypxfrd 8 が登録されているかをチェックし、存在する場合にはこれを使用しようとします。 存在しない場合には、標準プロトコルを使用し、 .Xr ypserv 8 からマップの内容をコピーし、新たなマップを作成します。 .Pp -概念的には FreeBSD の ypxfrd プロトコルは +概念的には +.Bx Free +の ypxfrd プロトコルは SunOS の ypxfrd プロトコルと同じですが、 -FreeBSD のプロトコルは SunOS のプロトコルとは互換ではないため、 +.Bx Free +のプロトコルは SunOS のプロトコルとは互換ではないため、 Sun の ypxfrd サーバとともに使用する事は出来ない事に注意して下さい。 -FreeBSD のスレーブは 非 FreeBSD の NIS サーバから +FreeBSD のスレーブは +.Bx 非 Free +の +.Tn NIS +サーバから マップを転送する事が出来ますが、 -高速プロトコルを使用できるのは、マスタサーバも FreeBSD の場合だけです。 +高速プロトコルを使用できるのは、マスタサーバも +.Bx Free +の場合だけです。 .Sh オプション -以下のオプションが -.Nm ypxfr -にてサポートされています: -.Bl -tag -width flag +.Nm +がサポートするオプションは以下の通りです: +.Bl -tag -width indent .It Fl f マップ転送を強制します。通常、 -NIS マスタ上のコピーがローカルホスト上にあるコピーよりも新しくない場合には、 -.Nm ypxfr +.Tn NIS +マスタ上のコピーがローカルホスト上にあるコピーよりも新しくない場合には、 +.Nm はマップを転送しません: .Fl f フラグにより、サーバ上のバージョンが新しいか否かにかにかかわらず、 -転送を強制します。 +転送します。 .It Fl c ローカルホスト上で実行されている .Xr ypserv 8 -プロセス宛に `現在のマップをクリア' する要求を送信しません。 +プロセス宛に `現在のマップのクリア' 要求を送信しません。 このフラグは通常 .Xr ypserv 8 を実行していないマシン上で -.Nm ypxfr +.Nm を手動で起動する時に使用します。 -このフラグを指定しないと、ローカルの NIS サーバと通信できないために、 -.Nm ypxfr -が転送を中止してしまいます。 +このフラグを指定しないと、ローカルの +.Tn NIS +サーバと通信できないために、 +.Nm +は転送を中止します。 .It Fl d Ar target domain -現在の NIS ドメインではない別のドメイン名を指定します。 +現在の +.Tn NIS +ドメインではない別のドメイン名を指定します。 .It Fl h Ar source host -NIS マップのコピー元のホスト名を指定します。 +.Tn NIS +マップのコピー元のホスト名を指定します。 このオプションにより -.Nm ypxfr -が NIS マスタサーバからのみマップをコピーする事を保証できます。 +.Nm +が +.Tn NIS +マスタサーバからのみマップをコピーする事を保証できます。 .It Fl s Ar source domain マップの転送元のドメインを指定します。 -これは 2 つの NIS ドメイン間で転送を行う時に有用です。 +これは 2 つの +.Tn NIS +ドメイン間で転送を行う時に有用です。 .It Fl p Ar path -NIS マップを保持する最上位ディレクトリを指定します。 +.Tn NIS +マップを保持する最上位ディレクトリを指定します。 デフォルトではこのパスは .Pa /var/yp です。 .Fl p フラグにより別のパスを指定し、 -NIS マップを別の場所に格納する場合に対処できます。 -NIS サーバ +.Tn NIS +マップを別の場所に格納する場合に対処できます。 +.Tn NIS +サーバ .Xr ypserv 8 が別のパスを使用するように指示された場合にも、このフラグを -.Nm ypxfr +.Nm に渡します。 .It Fl C Ar taskid program-number ipaddr port .Xr yppush 8 によるマップ転送要求への応答として、 -.Nm ypxfr +.Nm が .Xr ypserv 8 から起動された場合にのみ、このオプションは使用されます。 この場合、 -.Nm ypxfr +.Nm は .Xr yppush 8 を `コールバック' して通信する必要がありますので、 @@ -227,11 +281,15 @@ NIS .Sh 関連ファイル .Bl -tag -width Pa -compact .It Pa /var/yp/[domainname]/[maps] -ある NIS ドメインの NIS マップ。 +ある +.Tn NIS +ドメインの +.Tn NIS +マップ。 .El .Sh 関連項目 .Xr yp 4 , .Xr ypserv 8 , .Xr yppush 8 .Sh 作者 -Bill Paul +.An Bill Paul Aq wpaul@ctr.columbia.edu