diff --git a/ja_JP.eucJP/man/man1/Makefile b/ja_JP.eucJP/man/man1/Makefile index 00bc0557d8..4c0c99f49c 100644 --- a/ja_JP.eucJP/man/man1/Makefile +++ b/ja_JP.eucJP/man/man1/Makefile @@ -1,487 +1,488 @@ # $FreeBSD$ MAN1 = a2p.1\ addftinfo.1\ addr2line.1\ afmtodit.1\ apply.1\ apropos.1\ ar.1\ as.1\ at.1\ basename.1\ bc.1\ bdes.1\ biff.1\ brandelf.1\ builtin.1\ bzip2.1\ c89.1\ calendar.1\ cap_mkdb.1\ cat.1\ catman.1\ cccp.1\ cdcontrol.1\ checknr.1\ chflags.1\ chgrp.1\ chio.1\ chkey.1\ chmod.1\ chpass.1\ ci.1\ ckdist.1\ cksum.1\ cmp.1\ co.1\ col.1\ colcrt.1\ colldef.1\ colrm.1\ column.1\ comm.1\ compile_et.1\ compress.1\ cp.1\ cpio.1\ crontab.1\ crunchgen.1\ crunchide.1\ ctags.1\ ctm.1\ ctm_rmail.1\ cu.1\ cursor.1\ cut.1\ cvs.1\ date.1\ dc.1\ dd.1\ df.1\ dialog.1\ diff.1\ diff3.1\ dig.1\ dnskeygen.1\ dnsquery.1\ domainname.1\ doscmd.1\ dtmfdecode.1\ du.1\ echo.1\ ed.1\ ee.1\ enigma.1\ eqn.1\ expand.1\ expr.1\ f77.1\ false.1\ fdformat.1\ fdwrite.1\ fetch.1\ file.1\ file2c.1\ find.1\ finger.1\ fmt.1\ fold.1\ fontedit.1\ from.1\ fstat.1\ fsync.1\ ftp.1\ g711conv.1\ gasp.1\ gawk.1\ gcc.1\ gcore.1\ gdb.1\ gdbserver.1\ gencat.1\ getNAME.1\ getopt.1\ gperf.1\ gprof.1\ grep.1\ grn.1\ grodvi.1\ groff.1\ grog.1\ grolbp.1\ grolj4.1\ grops.1\ grotty.1\ groups.1\ gzexe.1\ gzip.1\ h2ph.1\ head.1\ hexdump.1\ host.1\ hostname.1\ hpftodit.1\ id.1\ ident.1\ indent.1\ indxbib.1\ info.1\ install-info.1\ install.1\ intro.1\ ipcrm.1\ ipcs.1\ ipftest.1\ ipresend.1\ ipsend.1\ iptest.1\ join.1\ jot.1\ kbdcontrol.1\ kbdmap.1\ kcon.1\ kdump.1\ kenv.1\ key.1\ keyinfo.1\ keyinit.1\ keylogin.1\ keylogout.1\ kill.1\ killall.1\ ktrace.1\ lam.1\ last.1\ lastcomm.1\ ld.1\ ldd.1\ leave.1\ less.1\ lesskey.1\ lex.1\ limits.1\ lint.1\ lkbib.1\ ln.1\ loadfont.1\ locate.1\ lock.1\ lockf.1\ logger.1\ login.1\ logname.1\ look.1\ lookbib.1\ lorder.1\ lp.1\ lpq.1\ lpr.1\ lprm.1\ lptest.1\ ls.1\ lsvfs.1\ m4.1\ mail.1\ mailq.1\ make.1\ makeinfo.1\ makewhatis.1\ man.1\ manpath.1\ mcon.1\ md5.1\ merge.1\ mesg.1\ minigzip.1\ mkdep.1\ mkdir.1\ mkfifo.1\ mklocale.1\ mkstr.1\ mktemp.1\ mptable.1\ msgs.1\ mt.1\ mv.1\ ncal.1\ ncplist.1\ ncplogin.1\ ncplogout.1\ neqn.1\ netstat.1\ newaliases.1\ nfsstat.1\ nice.1\ nl.1\ nm.1\ nohup.1\ nroff.1\ objcopy.1\ objdump.1\ objformat.1\ od.1\ opieinfo.1\ opiekey.1\ opiepasswd.1\ pagesize.1\ passwd.1\ paste.1\ patch.1\ pawd.1\ pax.1\ perl.1\ pfbtops.1\ pic.1\ pkg_add.1\ pkg_create.1\ pkg_delete.1\ pkg_info.1\ pkg_sign.1\ pkg_update.1\ pkg_version.1\ pr.1\ printenv.1\ printf.1\ ps.1\ psroff.1\ pwd.1\ quota.1\ ranlib.1\ rcp.1\ rcs.1\ rcsclean.1\ rcsdiff.1\ rcsfreeze.1\ rcsintro.1\ rcsmerge.1\ rdist.1\ readelf.1\ realpath.1\ refer.1\ rev.1\ rlog.1\ rlogin.1\ rm.1\ rmdir.1\ rpcgen.1\ rs.1\ rsh.1\ rtld.1\ rtprio.1\ rup.1\ ruptime.1\ rusers.1\ rwall.1\ rwho.1\ s2p.1\ sasc.1\ scon.1\ scp.1\ script.1\ sdiff.1\ sed.1\ send-pr.1\ sftp.1\ sgsc.1\ sh.1\ shar.1\ size.1\ skey.1\ sleep.1\ smbutil.1\ sockstat.1\ soelim.1\ sort.1\ split.1\ ssh-add.1\ ssh-agent.1\ ssh-keygen.1\ ssh-keyscan.1\ ssh.1\ startslip.1\ strings.1\ strip.1\ stty.1\ su.1\ symorder.1\ systat.1\ tail.1\ talk.1\ tar.1\ tbl.1\ tcopy.1\ tcpdump.1\ tcpslice.1\ tcsh.1\ tee.1\ telnet.1\ test.1\ texindex.1\ tfmtodit.1\ tftp.1\ time.1\ tip.1\ top.1\ touch.1\ tput.1\ tr.1\ troff.1\ true.1\ truncate.1\ truss.1\ tset.1\ tsort.1\ tty.1\ ul.1\ uname.1\ unifdef.1\ uniq.1\ units.1\ unvis.1\ uptime.1\ usbhidctl.1\ users.1\ uuconv.1\ uucp.1\ uuencode.1\ uulog.1\ uuname.1\ uupick.1\ uustat.1\ uuto.1\ uux.1\ vacation.1\ vgrind.1\ vi.1\ vidcontrol.1\ vis.1\ vt220keys.1\ vttest.1\ w.1\ wall.1\ wc.1\ what.1\ whereis.1\ which.1\ who.1\ whoami.1\ whois.1\ window.1\ write.1\ xargs.1\ xstr.1\ xten.1\ yacc.1\ yes.1\ ypcat.1\ ypmatch.1\ ypwhich.1\ yyfix.1\ zdiff.1\ zforce.1\ zmore.1\ znew.1 MLINKS= builtin.1 alias.1 builtin.1 alloc.1 builtin.1 bg.1 builtin.1 bindkey.1 \ builtin.1 break.1 builtin.1 breaksw.1 builtin.1 builtins.1 \ builtin.1 case.1 builtin.1 cd.1 builtin.1 chdir.1 builtin.1 command.1 \ builtin.1 complete.1 \ builtin.1 continue.1 builtin.1 default.1 \ builtin.1 dirs.1 builtin.1 do.1 builtin.1 done.1 \ builtin.1 echotc.1 builtin.1 elif.1 builtin.1 else.1 \ builtin.1 end.1 builtin.1 endif.1 builtin.1 endsw.1 \ builtin.1 esac.1 builtin.1 eval.1 builtin.1 exec.1 \ builtin.1 exit.1 builtin.1 export.1 builtin.1 fc.1 \ builtin.1 fg.1 builtin.1 fi.1 builtin.1 filetest.1 builtin.1 for.1 \ builtin.1 foreach.1 builtin.1 getopts.1 builtin.1 glob.1 \ builtin.1 goto.1 builtin.1 hash.1 builtin.1 hashstat.1 \ builtin.1 history.1 builtin.1 hup.1 builtin.1 if.1 builtin.1 jobid.1 \ builtin.1 jobs.1 builtin.1 limit.1 builtin.1 log.1 builtin.1 logout.1 \ builtin.1 ls-F.1 \ builtin.1 notify.1 builtin.1 onintr.1 builtin.1 popd.1 \ builtin.1 pushd.1 builtin.1 read.1 builtin.1 readonly.1 \ builtin.1 rehash.1 \ builtin.1 repeat.1 builtin.1 sched.1 builtin.1 set.1 \ builtin.1 setenv.1 builtin.1 settc.1 builtin.1 setty.1 \ builtin.1 setvar.1 builtin.1 shift.1 builtin.1 source.1 \ builtin.1 stop.1 builtin.1 suspend.1 builtin.1 switch.1 \ builtin.1 telltc.1 builtin.1 then.1 builtin.1 trap.1 builtin.1 type.1 \ builtin.1 ulimit.1 builtin.1 umask.1 builtin.1 unalias.1 \ builtin.1 uncomplete.1 \ builtin.1 unhash.1 builtin.1 unlimit.1 builtin.1 unset.1 \ builtin.1 unsetenv.1 builtin.1 until.1 builtin.1 wait.1 \ builtin.1 where.1 \ builtin.1 while.1 MLINKS+=ed.1 red.1 MLINKS+=test.1 '[.1' MLINKS+=gawk.1 awk.1 MLINKS+=gcc.1 cc.1 MLINKS+=gcc.1 c++.1 MLINKS+=gcc.1 g++.1 MLINKS+=gcc.1 CC.1 MLINKS+=cccp.1 cpp.1 MLINKS+=grep.1 egrep.1 MLINKS+=grep.1 fgrep.1 MLINKS+=grep.1 zgrep.1 MLINKS+=grep.1 zegrep.1 MLINKS+=grep.1 zfgrep.1 MLINKS+=gzip.1 gunzip.1 MLINKS+=gzip.1 zcat.1 MLINKS+=gzip.1 gzcat.1 MLINKS+=zdiff.1 zcmp.1 MLINKS+=apropos.1 whatis.1 MLINKS+=send-pr.1 sendbug.1 MLINKS+=at.1 batch.1 MLINKS+=at.1 atq.1 MLINKS+=at.1 atrm.1 MLINKS+=basename.1 dirname.1 MLINKS+=chpass.1 chfn.1 MLINKS+=chpass.1 chsh.1 MLINKS+=chpass.1 ypchpass.1 MLINKS+=chpass.1 ypchfn.1 MLINKS+=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 gate-ftp.1 MLINKS+=hexdump.1 hd.1 MLINKS+=intro.1 introduction.1 MLINKS+=less.1 more.1 MLINKS+=lex.1 flex.1 MLINKS+=lex.1 flex++.1 MLINKS+=lex.1 lex++.1 MLINKS+=mail.1 Mail.1 MLINKS+=mail.1 mailx.1 MLINKS+=passwd.1 yppasswd.1 MLINKS+=printenv.1 env.1 MLINKS+=rtld.1 ld-elf.so.1.1 MLINKS+=tput.1 clear.1 MLINKS+=tset.1 reset.1 MLINKS+=vi.1 ex.1 MLINKS+=vi.1 view.1 MLINKS+=vi.1 nex.1 MLINKS+=vi.1 nview.1 MLINKS+=vi.1 nvi.1 MLINKS+=yacc.1 byacc.1 MLINKS+=ctm_rmail.1 ctm_smail.1 MLINKS+=ctm_rmail.1 ctm_dequeue.1 MLINKS+=kbdmap.1 vidfont.1 MLINKS+=rtprio.1 idprio.1 MLINKS+=cksum.1 sum.1 MLINKS+=ktrace.1 trace.1 MLINKS+=uuencode.1 uudecode.1 MLINKS+=ncal.1 cal.1 MLINKS+=enigma.1 crypt.1 MLINKS+=ln.1 link.1 MLINKS+=rm.1 unlink.1 MLINKS+=opiekey.1 otp-md4.1 MLINKS+=opiekey.1 otp-md5.1 MLINKS+=tcsh.1 csh.1 MLINKS+=ee.1 edit.1 MLINKS+=pkg_sign.1 pkg_check.1 MLINKS+=ssh.1 slogin.1 MLINKS+=bzip2.1 bunzip2.1 MLINKS+=bzip2.1 bzcat.1 +MLINKS+=unifdef.1 unifdefall.1 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man1/basename.1 b/ja_JP.eucJP/man/man1/basename.1 index 31c1272625..303fcd05ee 100644 --- a/ja_JP.eucJP/man/man1/basename.1 +++ b/ja_JP.eucJP/man/man1/basename.1 @@ -1,96 +1,96 @@ .\" Copyright (c) 1990 The Regents of the University of California. .\" All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)basename.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/basename/basename.1,v 1.6.2.5 2001/08/16 13:16:41 ru Exp % +.\" %FreeBSD: src/usr.bin/basename/basename.1,v 1.6.2.6 2002/06/20 23:45:11 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/basename.1,v 1.11 2001/08/17 06:18:08 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt BASENAME 1 .Os .Sh 名称 .Nm basename , dirname .Nd 指定したパスのファイル名部分やディレクトリ名部分を返す .Sh 書式 .Nm basename .Ar string .Op Ar suffix .br .Nm dirname .Ar string .Sh 解説 -.Nm basename -は +.Nm +ユーティリティは .Ar string から最後の .Ql \&/ までを 削除し、 .Ar suffix が指定された場合はこれも削除します。 (まず後続する複数のスラッシュを取り除いた) .Ar string に残された文字列と .Ar suffix がまったく同じ場合には、削除しません。 そして、その結果得られるファイル名を標準出力に書き出します。 存在しない .Ar suffix は無視します。 .Pp .Nm dirname -は +ユーティリティは (まず後続する複数のスラッシュを取り除いた) .Ar string 中の最後の .Ql \&/ から最後尾までをファイル名とみなしてこの部分を削除し、 残りを標準出力に書き出します。 .Sh 使用例 次の行は、シェル変数 FOO に /usr/bin を設定するものです。 .Pp .Dl FOO=`dirname /usr/bin/trail` .Sh 診断 .Ex -std basename dirname .Sh 関連項目 .Xr csh 1 , .Xr sh 1 .Sh 規格 .Nm および .Nm dirname -の機能は、 +のユーティリティは、 .St -p1003.2 準拠であると思われます。 diff --git a/ja_JP.eucJP/man/man1/biff.1 b/ja_JP.eucJP/man/man1/biff.1 index b8c2832dc9..6d58ebcdd9 100644 --- a/ja_JP.eucJP/man/man1/biff.1 +++ b/ja_JP.eucJP/man/man1/biff.1 @@ -1,97 +1,97 @@ .\" Copyright (c) 1980, 1990 The Regents of the University of California. .\" 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 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. .\" .\" from: @(#)biff.1 6.5 (Berkeley) 3/14/91 -.\" %FreeBSD: src/usr.bin/biff/biff.1,v 1.8.2.4 2001/12/14 15:53:29 ru Exp % +.\" %FreeBSD: src/usr.bin/biff/biff.1,v 1.8.2.5 2002/06/20 23:45:13 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt BIFF 1 .Os .Sh 名称 .Nm biff .Nd メールの到着時に、メールの着信とメールの発信人を報告するかどうか設定する .Sh 書式 .Nm biff .Op Cm n | y .Sh 解説 .Nm -は、現在の端末を利用している間、メールの到着を +ユーティリティは、現在の端末を利用している間、メールの到着を システムから報告してもらうかどうかを設定します。 .Pp .Nm がサポートしているオプションとしては、以下のものがあります: .Bl -tag -width indent .It Cm n 報告しないように設定します。 .It Cm y 報告するように設定します。 .El .Pp .\" 以下の一文は元の英語版マニュアルには含まれていないので .\" とりあえずコメントアウトしてある --- jpman project sakai@csl.cl.nec.co.jp .\" .\" オプションを指定しない場合は現在状態を表示します。 .\" メールの到着を報告するように設定しているときにメールが届いた場合、 メールのヘッダとメッセージの最初の数行が自分の画面に表示されます。 ログインするたびに設定されるように、たいてい .Pa \&.login や .Pa \&.profile ファイルに .Dq Li biff y コマンドの記述が含められます。 .Pp .Nm -は非同期に動作します。同期して動作させる場合は、 +ユーティリティは非同期に動作します。同期して動作させる場合は、 .Xr sh 1 の .Ev MAIL 変数を用いるか、 .Xr csh 1 の .Ev mail 変数を利用してください。 .Sh 関連項目 .Xr csh 1 , .Xr mail 1 , .Xr sh 1 , .Xr comsat 8 .Sh 歴史 .Nm コマンドは .Bx 4.0 から登場しました。 .Nm コマンドの名前は、 Heidi Stettner の犬の名前にちなんでいます。 彼は、1993年の8月に15歳で亡くなりました。 diff --git a/ja_JP.eucJP/man/man1/cap_mkdb.1 b/ja_JP.eucJP/man/man1/cap_mkdb.1 index bcb083b23b..d757b568e2 100644 --- a/ja_JP.eucJP/man/man1/cap_mkdb.1 +++ b/ja_JP.eucJP/man/man1/cap_mkdb.1 @@ -1,107 +1,107 @@ .\" Copyright (c) 1992 The Regents of the University of California. .\" 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 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. .\" .\" from: @(#)cap_mkdb.1 5.4 (Berkeley) 3/6/93 -.\" %FreeBSD: src/usr.bin/cap_mkdb/cap_mkdb.1,v 1.7.2.4 2001/08/16 13:16:42 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/cap_mkdb.1,v 1.9 2001/08/19 10:25:02 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/cap_mkdb/cap_mkdb.1,v 1.7.2.5 2002/06/20 23:45:15 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt CAP_MKDB 1 .Os .Sh 名称 .Nm cap_mkdb .Nd ケーパビリティ・データベースを作る .Sh 書式 .Nm cap_mkdb .Op Fl v .Op Fl f Ar outfile .Ar file .Op Ar .Sh 解説 .Nm cap_mkdb -は、指定したファイルを連結して形成した +ユーティリティは、指定したファイルを連結して形成した .Xr getcap 3 論理データベースから、ハッシュ化 されたデータベースを作ります。 .Pp データベースの名前は、先頭に指定したファイルのベース名に文字列 .Dq .db を付け加えたものになります。 .Xr getcap 3 ルーチンの検索速度は、オリジナルのテキストファイルよりも、 このデータベースのほうがずっと高速です。 .Pp ファイル内の ``tc'' エントリは、データベースにストアされる前に展開され ます。 .Pp オプションとしては、以下のものがあります: .Bl -tag -width indent .It Fl f Ar outfile データベースのベース名として別のものを指定します。 .It Fl v データベース内のケーパビリティレコードの登録数を表示します。 .El .Sh 書式 個々のレコードは二種類の異なるキーを用いてデータベース内に格納されます。 .Pp 第一の形式は、キーがレコードの最初のケーパビリティ (末端のコロン(``:'')は含みません)から構成され、 データフィールドがスペシャルバイトとレコードの残りの部分から構成されています。 スペシャルバイトの値は、0 あるいは 1 のいずれかです。ここで 0 はレコードの 状態が良好であることを、1 はレコード中に展開することができなかっ た ``tc'' ケーパビリティが存在することを示します。 .Pp 第二の形式は、キーがレコード最初のケーパビリティの中の名前の一つで 構成され、データフィールドがスペシャルバイトとレコードの最初のケーパビリティ から構成されています。この場合スペシャルバイトの値は 2 です。 .Pp 通常の動作においては、まずデータベースから名前を検索します。 その結果得られるのは、第二の形式のキー/データ組です。 このキー/データ組のデータフィールドを用いて、 第一の形式のキー/データ組を検索します。これが 与えられた名前に対する実際のデータになります。 .Sh 診断 .Ex -std .\" .\" 以下の使用例の章は FreeBSD オリジナルマニュアルには無い。 .\" このような使用例の正当性を容易には確認できないので、 .\" 残念だがこの章はコメントアウトすることにした。 --- jpman J.Sakai .\" .\".Sh 使用例 .\"termcap ファイルにエントリを追加した場合などは、 .\"このコマンドを用いてデータベースファイルを更新しておきます。 .\".Pp .\".Dl # cap_mkdb -v /usr/share/misc/termcap .\".Dl cap_mkdb: 555 capability records .Sh 関連項目 .Xr dbopen 3 , .Xr getcap 3 , .Xr termcap 5 diff --git a/ja_JP.eucJP/man/man1/cdcontrol.1 b/ja_JP.eucJP/man/man1/cdcontrol.1 index d6599c5e52..b917ea9d71 100644 --- a/ja_JP.eucJP/man/man1/cdcontrol.1 +++ b/ja_JP.eucJP/man/man1/cdcontrol.1 @@ -1,193 +1,193 @@ -.\" %FreeBSD: src/usr.sbin/cdcontrol/cdcontrol.1,v 1.21.2.11 2002/05/17 09:40:49 maxim Exp % +.\" %FreeBSD: src/usr.sbin/cdcontrol/cdcontrol.1,v 1.21.2.12 2002/06/21 16:40:05 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd July 3, 1995 .Dt CDCONTROL 1 .Os .Sh 名称 .Nm cdcontrol .Nd コンパクトディスク制御ユーティリティ .Sh 書式 .Nm cdcontrol .Op Fl sv .Op Fl f Ar device .Op Ar command ... .Sh 解説 .Nm -はオーディオ CD プレイヤーを操作するためのプログラムです。 +ユーティリティはオーディオ CD プレイヤーを操作するためのプログラムです。 device には .Pa cd0 や .Pa mcd0 などを指定します。 .Pp コマンドを指定しない場合、 .Nm は対話モードになり、標準入力からコマンドを読み込みます。 .Pp 以下のオプションを使用可能です。 .Bl -tag -width indent .It Fl s サイレントモード - テーブルヘッダ及び人間が可読なコメントを表示しません。 .It Fl v 冗長モード - 表示できる情報は全て表示します。 .It Fl f Ar device .Pa /dev/cd0c や .Pa mcd0 といったデバイスを指定します。 絶対パス及び .Pa /dev からの相対パスの指定が可能です。 必要ならば最後に `c' を追加します。 .El .Pp 現時点では以下のコマンドが利用できます。 コマンドをユニークに特定できるために必要な文字だけ指定する 必要があります。 語 .Cm play は省略可能であり、 .Cm next と .Cm prev の代りに文字 .Dq + と .Dq - を使用可能です。 .Bl -tag -width Cm .It Cm play first_track last_track .Ar first_track で指定されたトラックから .Ar last_track で指定されたトラックまで演奏します。最初のトラックが1番になります。 .It Cm play Xo .Ar start_m : Ns Ar start_s . Ns Ar start_f .Oo Ar end_m : Ns Ar end_s . Ns .Ar end_f Oc .Xc 絶対アドレス (MSF) を元に演奏します。演奏開始する時間は .Ar start_m に演奏開始する分を、 .Ar start_s に秒を、 .Ar start_f にはフレーム番号を指定します。演奏終了の時間は .Ar end_m に演奏終了する分を、 .Ar end_s, に秒を、 .Ar end_f にフレーム番号を指定することで指定できます。分指定で指定できる数値は 0 から 99 の範囲の値です。秒には 0 から 59 までが指定できます。フレーム 番号は 0 から 74 までの範囲で指定できます。 .It Cm play Op Ar #start_block Op length 論理ブロック .Ar start_block から .Ar length 論理ブロック分だけ演奏します。 .It Cm next Op Ar tracks 指定した数のトラックを、前向きにスキップします (デフォルト 1)。 .It Cm prev Op Ar tracks 指定した数のトラックを、後向きにスキップします (デフォルト 1)。 .It Cm pause 演奏を停止します。ディスクは停止しません。 .It Cm resume 演奏を再開します。 .Em pause で一時停止した後に使います。 .It Cm stop ディスクを停止します。 .It Cm eject ディスクを取り出します。 .It Cm close ディスクを挿入します。 .It Cm setvol left_channel right_channel 左チャネルのボリュームを .Ar left_channel にセットし、右チャネルを .Ar right_channel にセットします。指定できる値は 0 から 255 の範囲の値です。 .It Cm volume Ar mute 音を消します。 .It Cm volume Ar mono モノラルモードにします。 .It Cm volume Ar stereo ステレオモードにします。 .It Cm volume Ar left 左サブトラックを左と右の両チャネルで演奏します。 .It Cm volume Ar right 右サブトラックを左と右の両チャネルで演奏します。 .It Cm info 目次を表示します。 .It Cm status Xo .Op Ar audio | media | volume .Xc ディスクに関する以下のような情報を表示します: .Pp .Bl -tag -width "volume" -compact .It Ar audio 現在の演奏の状態と位置、 .It Ar media 現在のメディアカタログ状態、 .It Ar volume 現在の左チャネル及び右チャネルのボリューム値。 .El .It Cm cdid CD のシリアル番号を、 cddb (http://www.cddb.org/) プロジェクトが使用する方法を使用して、 表示します。 .It Cm help 利用可能なコマンドの一覧を表示します。 .It Cm debug Ar on CD デバイスドライバのデバッグモードを有効にします。 .It Cm debug Ar off ドライバのデバッグモードを無効にします。 .It Cm reset デバイスに対するハードウェアリセットを実行します。 .It Cm set Ar msf minute-second-frame ioctl モードに設定します (デフォルト)。 .It Cm set Ar lba LBA ioctl モードに設定します。 .It Cm speed Ar s ドライブが使用可能な最高速度を指定します。 速度は、何倍速にするかを指定します。 本コマンドは、現在、ATABI ドライブでのみサポートされています。 .It Cm quit プログラムを終了します。 .El .Sh 環境変数 次の環境変数が .Nm の実行に影響します: .Pp .Bl -tag -width CD_DRIVE -compact .It Ev CDROM .Fl f フラグで指定しなかった場合に使用される CD デバイス。 .Pp .It Ev CDPLAY .It Ev CD_DRIVE .It Ev DISC .It Ev MUSIC_CD .Ev CDROM が選ばれたため、これらの変数の価値は低下しています。 .El .Sh 関連ファイル .Bl -tag -width /dev/mcd0c -compact .It Pa /dev/cd0c .It Pa /dev/mcd0c .It Pa /dev/acd0c .El .Sh 作者 .An Jean-Marc Zucconi , .An Andrey A.\ Chernov , .An Serge V.\ Vakulenko .Sh 歴史 .Nm コマンドは .Fx 2.1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/checknr.1 b/ja_JP.eucJP/man/man1/checknr.1 index f14f2806d3..e8b869d233 100644 --- a/ja_JP.eucJP/man/man1/checknr.1 +++ b/ja_JP.eucJP/man/man1/checknr.1 @@ -1,161 +1,161 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)checknr.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/checknr/checknr.1,v 1.5.2.3 2001/08/16 13:16:42 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/checknr.1,v 1.7 2001/07/29 05:14:49 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/checknr/checknr.1,v 1.5.2.4 2002/06/20 23:45:18 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt CHECKNR 1 .Os .Sh 名称 .Nm checknr .Nd nroff および troff ファイルをチェックする .Sh 書式 .Nm checknr .Op Fl a Ns Ar \&.x1.y1.x2.y2. ... \&.xn.yn .Op Fl c Ns Ar \&.x1.x2.x3 ... \&.xn .Op Fl s .Op Fl f .Ar file .Sh 解説 .Nm -は、 +ユーティリティは、 .Xr nroff 1 や .Xr troff 1 の入力ファイルのリストに対して、デリミタの開始および終了の不一致や 間違ったコマンドを含む、ある種類のエラーをチェックします。 ファイルが指定されなかった場合、 .Nm は標準入力をチェックします。 .Pp オプション .Bl -tag -width Ds .It Fl a 既知マクロのリストに追加のマクロペアを追加します。 その後ろには 6 文字のグループが続かなくてはなりません。 各グループはマクロのペアを定義します。 6 文字はピリオドと最初のマクロ名、更にピリオドと2番目のマクロ名です。 例えば、 .BS と .ES のペアを定義するためには、 .Sq Li \-a.BS.ES を使ってください。 .It Fl c 通常なら未定義であるといわれるコマンドを定義します。 .It Fl f .Nm に .Ql \ef のフォント変更を無視させます。 .It Fl s .Ql \es のサイズ変更を無視させます。 .El .Pp デリミタのチェックは以下の通りです。 .Bl -enum .It \efx ... \efP を使ったフォントの変更。 .It \esx ... \es0 を使ったサイズの変更。 .It \&.TS と .TEマクロのようにいつもペアで使われる、 ``開始...終了''形式のマクロ。 .El .Pp .Nm -は、 +ユーティリティは、 .Xr lint 1 と同じように、 .Nm によるチェックを念頭に置いて作成されたドキュメントを チェックするのに用いることを意図しています。 .\"(チェック者注) この部分若干意訳。原文は以下の通り。(sakai@jp.freebsd.org) .\".Nm Checknr .\"is intended for use on documents that are prepared with .\".Nm checknr .\"in mind, much the same as .\".Xr lint 1 . コマンドは、記述形式が .Ql \ef と .Ql \es コマンドに対して、 各 .Ql \efx は .Ql \efP で終了されており、 .Ql \esx は .Ql \es0 で終了されているようなものを期待しています。 直接次のフォントに切り替えたり、 明示的にもとのフォントやポイントサイズを指定したりしても動作しますし、 実際そのようにしているドキュメントは数多く存在しますが、 .Nm はそのような使用法に対して警告を発します。 おそらく .Ql \efP と .Ql \es0 形式を使うほうがよいはずなので、 このようなスタイルを用いることは、 ドキュメント執筆スタイルの向上に寄与すると考えて下さい。 .Pp .Nm -は、 +ユーティリティは、 .Xr ms 7 と .Xr me 7 マクロパッケージを認識します。 .Sh 関連項目 .Xr nroff 1 , .Xr troff 1 , .Xr me 7 , .Xr ms 7 .\" .Xr checkeq 1 , .Sh 診断 .Bd -ragged -compact デリミタが一致しない時に、警告を出します。 コマンドを認識できない時に、警告を出します。 コマンドの文法について、さまざまな警告を出します。 .Ed .Sh バグ .Fl a を用いて 1 文字のマクロ名を定義する方法がありません。 .Pp 条件文のような、ある種の正当な構造を認識できません。 .Sh 歴史 .Nm コマンドは .Bx 4.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/chkey.1 b/ja_JP.eucJP/man/man1/chkey.1 index 9d4a8d4e2f..0955a8bb7c 100644 --- a/ja_JP.eucJP/man/man1/chkey.1 +++ b/ja_JP.eucJP/man/man1/chkey.1 @@ -1,24 +1,24 @@ .\" @(#)chkey.1 1.5 91/03/11 TIRPC 1.0; +.\" %FreeBSD: src/usr.bin/chkey/chkey.1,v 1.4.2.3 2002/06/20 23:45:20 charnier Exp % .\" $FreeBSD$ -.\" %FreeBSD: src/usr.bin/chkey/chkey.1,v 1.4.2.2 2000/12/14 14:10:37 ru Exp % .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. .\" .Dd July 5, 1989 .Dt CHKEY 1 .Os .Sh 名称 .Nm chkey .Nd あなたの暗号鍵を変更する .Sh 書式 .Nm chkey .Sh 解説 .Nm -はユーザのログインパスワードの入力をうながし、 +ユーティリティはユーザのログインパスワードの入力をうながし、 これを使用してユーザの新しい暗号鍵を暗号化して .Xr publickey 5 データベースに格納します。 .Sh 関連項目 .Xr keylogin 1 , .Xr publickey 5 , .Xr keyserv 8 , .Xr newkey 8 diff --git a/ja_JP.eucJP/man/man1/chpass.1 b/ja_JP.eucJP/man/man1/chpass.1 index e2449d070d..553e134bdc 100644 --- a/ja_JP.eucJP/man/man1/chpass.1 +++ b/ja_JP.eucJP/man/man1/chpass.1 @@ -1,468 +1,471 @@ .\" Copyright (c) 1988, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)chpass.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.bin/chpass/chpass.1,v 1.23.2.7 2001/08/16 13:16:43 ru Exp % +.\" %FreeBSD: src/usr.bin/chpass/chpass.1,v 1.23.2.8 2002/06/20 23:45:22 charnier Exp % .\" .\" $FreeBSD$ .Dd December 30, 1993 .Dt CHPASS 1 .Os .Sh 名称 .Nm chpass , .Nm chfn , .Nm chsh , .Nm ypchpass , .Nm ypchfn , .Nm ypchsh .Nd ユーザデータベース内の情報を編集する .Sh 書式 .Nm chpass .Op Fl a Ar list .Op Fl p Ar encpass .Op Fl e Ar expiretime .Op Fl s Ar newshell .Op user .Pp .Nm chpass .Op Fl oly .Op Fl a Ar list .Op Fl p Ar encpass .Op Fl e Ar expiretime .Op Fl s Ar newshell .Op Fl d Ar domain .Op Fl h Ar host .Op user .Sh 解説 .Nm は .Ar user もしくはデフォルトでは実行したユーザのユーザデータベースの情報を変更します。 情報はフォーマットされ、必要な部分をエディタで変更します。 .Pp ユーザが変更することができる情報だけが表示されます。 .Pp オプションとしては、次のものがあります: .Bl -tag -width indent .It Fl a スーパユーザは、ユーザデータベースのエントリを .Xr passwd 5 で定義されたフォーマットで引数として直接指定できます。 この引数はコロン .Pq Dq \&: で区切られたリストであり、 空きの部分があっても許されますが、 すべてのフィールドをリストにしなければなりません。 .It Fl p スーパユーザは、暗号化されたパスワードフィールドを .Xr crypt 3 で用いられているフォーマットで引数として直接指定することができます。 .It Fl e Ar expiretime アカウントが無効となる時を変更します。 対話エディタからのようにスクリプトから、 無効となる時を変更するために、本オプションを使用します。 .It Fl s Ar newshell ユーザのシェルを .Ar newshell に変更しようとします。 .El .Pp 表示されるエントリには以下のものがあります: .Pp .Bl -tag -width "Other Information:" -compact -offset indent .It Login: ユーザのログイン名 .It Password: ユーザの暗号化されたパスワード .It Uid: ユーザの ID .It Gid: ユーザのグループ ID .It Class: ユーザの一般的な分類 .It Change: パスワードの変更時間 .It Expire: アカウントの有効期限 .It Full Name: ユーザの実際の名前 .It Office Location: ユーザのオフィスの場所 (1) .It Office Phone: ユーザのオフィスの電話番号 (1) .It Home Phone: ユーザの自宅の電話番号 (1) .It Other Information: ユーザに関するローカル定義情報 (1) .It Home Directory: ユーザのホームディレクトリ .It Shell: ユーザのログインシェル .Pp .It 注 (1) - 実際の master.passwd ファイルでは、 これらのフィールドはコンマで区切られたフィールドとして FullName フィールドに埋め込まれます。 .El .Pp .Ar login フィールドは計算機にアクセスするときに使われるユーザ名です。 .Pp .Ar password フィールドはユーザの暗号化されたパスワードが収められています。 .Pp .Ar uid フィールドは .Ar login フィールドと関連した番号です。ファイルのアクセスを制御するために、 どちらのフィールドもシステム (しばしば、複数のシステム) の中で 一意である必要があります。 .Pp 複数のエントリが同一のログイン名や同一のユーザ ID を持つことは可能ですが、 そのようにすることは通常誤りです。 これらのファイルを操作する手順では、 それらの複数のエントリ内から無作為に選んだものの一つだけを返すでしょう。 .Pp .Ar group フィールドはユーザがログイン時に所属するグループです。 .Bx が複数の グループを採用してから ( .Xr groups 1 参照) このフィールドはほとんど意味がありません。 このフィールドは番号やグループ名 ( .Xr group 5 参照) のどちらかが記述されます。 .Pp .Ar class フィールドは .Pa /etc/login.conf のクラスに関する記述を参照します。 典型的には、ユーザのログイン時に、 ユーザのシステムリソースを制限するために使用されます。 .Pp .Ar change フィールドはパスワードが変更されているべき日付です。 .Pp .Ar expire フィールドはアカウントの満了する日付です。 .Pp .Ar change と .Ar expire の両方のフィールドは .Dq month day year の形式で入力し、 .Ar month は、英語の月の名前 (はじめの 3 文字でも十分です) で、 .Ar day は、その月の中の日で、 .Ar year は、その年です。 .Pp 5 つのフィールドは、ユーザの .Ar 実際の名前 、 .Ar オフィスの場所 、 .Ar 職場 と .Ar 家で使う電話 番号、そして .Ar その他の情報 を保管しています。 .Ar その他の情報 は、コンマで区切った単一文字列であり、追加の gcos フィールドを表現します。 (典型的にはサイト固有のユーザ情報のために使用します)。 .Xr finger 1 が、 .Ar Office: というヘッダの下に オフィスの場所と電話番号をともに表示することに注意してください。 .Pp ユーザの .Ar home directory はユーザがログイン時にいる場所への絶対 .Ux パス名です。 .Pp .Ar shell フィールドはユーザの好むコマンドインタプリタです。 もし .Ar shell フィールドが空であれば、Bourne シェル .Pa /bin/sh であると仮定します。 ログインシェルを変更するときに、スーパユーザではないユーザは、 非標準シェルから、または非標準シェルへの変更は許されていません。 非標準シェルとは .Pa /etc/shells で見つけられないシェルのことです。 .Pp 一度情報が確認されたら .Nm はユーザデータベースを更新するために .Xr pwd_mkdb 8 を用います。 .Sh 環境変数 環境変数 .Ev EDITOR を設定して他のエディタを指定している場合を除き、 .Xr vi 1 エディタが使われます。エディタが終了すると、その情報は再度読み込まれ、 ユーザデータベースを変更するための情報とします。 ユーザの情報を変更できるのは、そのユーザかスーパユーザのみです。 .Pp .Ev PW_SCAN_BIG_IDS 環境変数の設定のインパクトについては、 .Xr pwd_mkdb 8 の説明を参照してください。 .Sh NIS との相互作用 いくつかの制限が適用されますが、 .Nm -を NIS と同時に使うこともできます。現在 +ユーティリティを NIS と同時に使うこともできます。現在 .Nm が .Xr rpc.yppasswdd 8 を通じて NIS のパスワードマップ中で変更できるのは、 通常はユーザのパスワード、シェル、GECOS フィールドだけです。 NIS マスタサーバ上でスーパユーザによって起動された場合を除き、 .Nm (同様に .Xr passwd 1 ) は、ユーザ情報の変更および新レコードの追加のために .Xr rpc.yppasswdd 8 サーバを使用出来ません。 なお、 .Xr rpc.yppasswdd 8 は、どのような変更を行う前にもパスワード認証を要求します。 パスワード無しで変更要求できるユーザは NIS マスタサーバ上のスーパユーザだけです; 他の全てのユーザはパスワードを入力する必要があります。 他の全てのユーザには NIS クライアント (および NIS スレーブサーバ) 上の root 権限を持つユーザも含まれます。 (NIS マスタサーバ上のスーパユーザがこの制約をバイパスできる理由は、 主に簡便さのためです: NIS マスタサーバへの root アクセス権限をもつユーザは 既に NIS マップを更新するための権限を持っています。 それにもかかわらずマップソースファイルを手で編集することは面倒です。 .Pp 注: これらの例外が適用されるのは NIS マスタサーバが .Fx システムの時だけです。) .Pp その結果として、上述の例外を除き、NIS 環境で .Nm を使う場合には以下の制限が適用されます: .Bl -enum -offset indent .It .Em "シェルと GECOS 情報だけを変更できます。" たとえ .Nm がスーパユーザによって起動された場合であってもです。 他のフィールドの変更がサポートされるようになっても、 他の NIS システムとの互換性の問題を引き起こすでしょう。 スーパユーザがあるエントリを編集している時に、 他のフィールドにデータを書いても、余分な情報として (パスワードは例外 -- 以下を参照してください) だまって廃棄されるでしょう。 .Pp 例外: NIS マスタサーバ上のスーパユーザは、 任意のフィールドの変更が許されています。 .Pp .It .Em "パスワード認証が要求されます。" どのような変更を行う前にも .Nm -はユーザの NIS パスワードを要求します。もしパスワードが間違っていたら、 +ユーティリティはユーザの NIS パスワードを要求します。 +もしパスワードが間違っていたら、 どのような変更も行われません。 .Pp 例外: NIS マスタサーバ上のスーパユーザはパスワード無しに変更要求できます。 (スーパユーザは、後述するように .Fl o フラグを指定する事によりこの仕様を無効にする事が選択できます。) .It .Em "新しいレコードのローカルパスワードデータベースへの追加は勧められません。" NIS が動作しているときに、管理者が .Nm -によって新しいレコードをローカルのパスワードデータベースに追加可能です。 +ユーティリティによって +新しいレコードをローカルのパスワードデータベースに追加可能です。 しかし、新しいレコードがマスタパスワードファイルの最後、 通常は NIS の特別な '+' エントリの後に追加されるため、 いくつかの混乱を招きかねません。 .Xr vipw 8 を使ってローカルのパスワードファイルを変更するべきです。 .Pp NIS マスタサーバ上のスーパユーザによる NIS パスワードマップへの新レコードの追加が許可されるのは、 .Xr rpc.yppasswdd 8 サーバが .Fl a フラグ付で起動された場合、すなわち追加を許可して起動された場合のみです (通常は追加を拒否します)。 .Nm -はデフォルトではローカルのパスワードデータベースを更新しようとします; +ユーティリティは +デフォルトではローカルのパスワードデータベースを更新しようとします; NIS マップを変更する場合には chpass を .Fl y フラグ付で起動してください。 .It .Em "パスワードの変更は許可されていません。" ユーザが、自分の NIS のパスワードを変更するときには .Xr passwd 1 か .Xr yppasswd 1 を使うべきです。スーパユーザは新しいパスワードを指定することを許され ています (たとえ、 .Dq Password: フィールドがエディタのテンプレートに あらわれていなくても、スーパユーザは手動で加えることができます)。 しかしながら、スーパユーザであってもユーザの元のパスワードがなければ .Xr rpc.yppasswdd 8 が NIS マップの更新を拒否するでしょう。 .Pp 例外: NIS マスタサーバ上のスーパユーザは .Nm を使用して、ユーザの NIS パスワードを変更する事が許されています。 .El .Pp .Nm が NIS をサポートしてコンパイルされたときに、数個の特別なフラグが有効 になります: .Bl -tag -width indent .It Fl l ローカルと NIS の両方のデータベースにユーザが存在していても、 ユーザのパスワード情報のローカルのコピーを修正することを .Nm に強制します。 .It Fl y .Fl l と反対の効果があります。もし NIS が動作していれば、 デフォルトでは .Nm は NIS のエントリを操作するので、 このフラグはまったく冗長です。 .It Fl d Ar domain NIS ドメインを指定します。 .Nm -はデフォルトではシステムのドメイン名を使用します。 +ユーティリティはデフォルトではシステムのドメイン名を使用します。 これは .Xr domainname 1 コマンドにて設定されています。 .Fl d オプションは、 このデフォルトを上書きするため、 もしくはドメイン名が設定されていない場合にドメイン名を指定するために 使用できます。 .It Fl h Ar host 問い合わせるべき NIS サーバの名前もしくはアドレスを指定します。 通常 .Nm は .Pa master.passwd もしくは .Pa passwd マップにて指定される NIS マスタホストと通信します。 NIS クライアントとして構成されていないホスト上では、 この情報を決定するための方法がプログラムにはありませんので、 ユーザがサーバのホスト名を指定します。 指定するホスト名は NIS マスタサーバである必要が無い事に注意してください; NIS ドメイン内のマスタサーバ名でもスレーブサーバ名でも良いのです。 .Pp .Fl d オプション使用時には、ホスト名のデフォルトは .Dq localhost です。 .Fl h オプションを .Fl d とともに使用し、ユーザが指定するホスト名でこのデフォルトを上書きできます。 .Pp .It Fl o .Xr rpc.yppasswdd 8 に RPC ベースの更新を強制します .Pq Dq 旧モード 。 NIS マスタサーバ上でスーパユーザにより起動された場合、 .Nm は専用の非 RPC ベースの機構を使用し、 NIS パスワードマップに対する無制限の変更を許可します (この場合 .Ux ドメインソケットを使用します)。 .Fl o フラグを使用する事により .Nm に標準の更新メカニズムを使用させる事が出来ます。 このオプションは主にテスト目的のために提供されています。 .El .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/master.passwd ユーザデータベース .It Pa /etc/passwd Version 7 フォーマットのパスワードファイル .It Pa /etc/chpass.XXXXXX パスワードファイルのテンポラリ用コピー .It Pa /etc/shells 利用できるシェルのリスト .El .Sh 関連項目 .Xr finger 1 , .Xr login 1 , .Xr passwd 1 , .Xr getusershell 3 , .Xr login.conf 5 , .Xr passwd 5 , .Xr pwd_mkdb 8 , .Xr vipw 8 .Rs .%A Robert Morris and .%A Ken Thompson .%T "UNIX Password security" .Re .Sh 注 .Xr chfn 1 , .Xr chsh 1 , .Xr ypchpass 1 , .Xr ypchfn 1 , .Xr ypchsh 1 コマンドは実際には .Nm にリンクしているだけです。 .Sh バグ ユーザ情報の保存はどこか他の場所にするべきです (し、いつかはそうなるでしょう)。 .Sh 歴史 .Nm コマンドは .Bx 4.3 Reno から登場しました。 diff --git a/ja_JP.eucJP/man/man1/col.1 b/ja_JP.eucJP/man/man1/col.1 index 0fab0247a4..45d4819c0f 100644 --- a/ja_JP.eucJP/man/man1/col.1 +++ b/ja_JP.eucJP/man/man1/col.1 @@ -1,133 +1,134 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Michael Rendell. .\" .\" 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. .\" .\" @(#)col.1 8.1 (Berkeley) 6/29/93 -.\" %FreeBSD: src/usr.bin/col/col.1,v 1.4.2.5 2001/07/22 12:40:00 dd Exp % +.\" %FreeBSD: src/usr.bin/col/col.1,v 1.4.2.6 2002/06/20 23:45:26 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/col.1,v 1.8 2001/07/22 23:09:20 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 29, 1993 .Dt COL 1 .Os .Sh 名称 .Nm col .Nd 入力から逆行送り (reverse line feed) を取り除くフィルタ .Sh 書式 .Nm col .Op Fl bfhpx .Op Fl l Ar num .Sh 解説 .Nm col -は、出力が順方向の行送りと半行送りで正しい順序になるように逆行送り +ユーティリティは、 +出力が順方向の行送りと半行送りで正しい順序になるように逆行送り (と半逆行送り) を取り除き、空白をなるべくタブに置き換えます。 これは、 .Xr nroff 1 と .Xr tbl 1 の出力を処理する場合に便利です。 .Pp -.Nm col -は標準入力を読み込み、標準出力に出力します。 +.Nm +ユーティリティは標準入力を読み込み、標準出力に出力します。 .Pp オプションには以下のものがあります。 .Bl -tag -width indent .It Fl b バックスペースを出力せず、各桁の位置に最後に書かれた文字だけを 表示します。 .It Fl f 順方向の半行送りを許します(``詳細 (fine) '' モード)。 半行送りの境界に打たれる文字は、通常次の行に表示されます。 .It Fl h タブのかわりに複数の空白を出力しません (デフォルト)。 .It Fl p 未知の制御シーケンスを無変更のまま通します。 通常、 .Nm は、自身で認識して解釈するもの以外の制御シーケンスを取り除きます。 自身で認識する制御シーケンスは、後述します。 .It Fl x タブのかわりに複数の空白を出力します。 .It Fl l Ar num メモリに、少なくとも .Ar num 行をバッファリングします。 デフォルトで 128 行までバッファリングされます。 .El .Pp .Nm が理解できる復帰動作の制御文字とその 10 進値の一覧を以下の表に示します。 .Pp .Bl -tag -width "carriage return" -compact .It ESC\-7 逆行送り (エスケープ 7) .It ESC\-8 半逆行送り (エスケープ 8) .It ESC\-9 半行送り (エスケープ 9) .It backspace 一桁戻る (8); 最初の桁では無視されます .It carriage return (13) .It newline 改行 (10); 復帰動作も同時に行ないます .It shift in 通常の文字セットにシフトします (15) .It shift out 異なる文字セットにシフトします (14) .It space 一桁移動します (32) .It tab 次のタブストップまで移動します (9) .It vertical tab 逆行送り (11) .El .Pp 認識できないすべての制御文字とエスケープシーケンスは捨てられます。 .Pp .Nm は、読み込まれた通りに文字セットの移り変わりを記憶し、 出力時に文字セットが正しくなるようにします。 .Pp 入力が最後に表示された行に戻ろうとすると、 .Nm -は警告メッセージを表示します。 +ユーティリティは警告メッセージを表示します。 .Sh 関連項目 .Xr expand 1 , .Xr nroff 1 , .Xr tbl 1 .Sh 歴史 .Nm コマンドは .At v6 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/colcrt.1 b/ja_JP.eucJP/man/man1/colcrt.1 index e50dd91ba3..7bd1911d0a 100644 --- a/ja_JP.eucJP/man/man1/colcrt.1 +++ b/ja_JP.eucJP/man/man1/colcrt.1 @@ -1,104 +1,104 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)colcrt.1 8.1 (Berkeley) 6/30/93 -.\" %FreeBSD: src/usr.bin/colcrt/colcrt.1,v 1.4.2.4 2001/08/16 13:16:43 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/colcrt.1,v 1.7 2001/08/17 06:18:09 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/colcrt/colcrt.1,v 1.4.2.5 2002/06/20 23:45:28 charnier Exp % +.\" $FreeBSD$ .\" .Dd March 30, 1993 .Dt COLCRT 1 .Os .Sh 名称 .Nm colcrt .Nd nroff の出力を CRT で表示するためのフィルタ .Sh 書式 .Nm colcrt .Op Fl .Op Fl \&2 .Op Ar .Sh 解説 -.Nm colcrt -は、半改行、逆改行の能力を持たず、重ね打ちで表示が壊れる端末に、 +.Nm +ユーティリティは、半改行、逆改行の能力を持たず、重ね打ちで表示が壊れる端末に、 仮想的にその機能を提供します。 半改行文字と下線(ダッシュ`-' に置換されます)は、通常の出力行の間に 新しい行をもうけて出力されます。 .Pp 利用可能なオプションは以下のとおりです; .Bl -tag -width indent .It Fl 下線を出力しません。このオプションは特に .Xr tbl 1 の .Em allbox で描かれた表を表示するのに便利です。 .It Fl 2 すべての行に半改行があるように出力します。実質的には、1 行おきに出力される ことになります。通常は半改行のない行で余分な改行を出力しません。 ただし、二つの連続した空行は省略されません。 .Fl 2 オプションは上付き、あるいは下付き文字が含まれていて、それらを 印字できないラインプリンタに対して出力する時に便利です。 .El .Sh 使用例 .Nm の典型的な利用法は、以下のとおりです。 .Bd -literal tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more .Ed .Sh 関連項目 .Xr nroff 1 , .Xr troff 1 , .Xr col 1 , .Xr more 1 , .Xr ul 1 .Sh バグ .Ql Fl オプションが指定されたときにも、空白部分の下線文字を書き、 下線文字を表示するようにすべきです。 .Pp 102 行以上の行を遡って処理することはできません。 .Pp 一般に、重ね打ちの効果は失われます。特殊なケースとして、 .Ql \&| が .Ql \- や下線と重ね打ちされる場合には、 .Ql \&+ になります。 .Pp 各行は 132 文字で切り捨てられます。 .Pp すでに 1 行おきになっている文書では、上付き、下付き文字に対する対処が必要です。 .Sh 歴史 .Nm は .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/colldef.1 b/ja_JP.eucJP/man/man1/colldef.1 index cde6a4e5a8..22571e85f1 100644 --- a/ja_JP.eucJP/man/man1/colldef.1 +++ b/ja_JP.eucJP/man/man1/colldef.1 @@ -1,233 +1,234 @@ .\" Copyright (c) 1995 Alex Tatmanjants .\" at Electronni Visti IA, Kiev, Ukraine. .\" 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 ``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. .\" -.\" %FreeBSD: src/usr.bin/colldef/colldef.1,v 1.8.2.3 2001/03/06 12:52:37 ru Exp % +.\" %FreeBSD: src/usr.bin/colldef/colldef.1,v 1.8.2.4 2002/06/20 23:45:30 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd January, 27 1995 .Dt COLLDEF 1 .Os .Sh 名称 .Nm colldef .Nd 照合シークエンスのソース定義を変換する .Sh 書式 .Nm colldef .Op Fl I Ar map_dir .Op Fl o Ar out_file .Op Ar filename .Sh 解説 -.Nm colldef -は、照合シークエンスのソース定義を +.Nm +ユーティリティは、照合シークエンスのソース定義を .Fn strxfrm と .Fn strcoll 関数で使えるフォーマットに変換します。すなわち、文字列をソートや照合で きるようにする様々な方法を定義するために使われます。 .Fn strxfrm は、その第一引数を変換して第二引数の結果に置き換えます。 変換された文字列は、 .Fn strcmp , .Fn strncmp , .Fn memcmp を使って別の変換された文字列と比較して正しくソートできるようになります。 .Fn strcoll はその引数を変換し、比較を行ないます。 .Pp -.Nm colldef -は、標準入力から照合シークエンスソース定義を読み込み、変換された定義を +.Nm +ユーティリティは、 +標準入力から照合シークエンスソース定義を読み込み、変換された定義を filename に格納します。 生成される出力ファイルの内容は、システムコマンドやシステムルーチンが 使える形式の照合シークエンス情報を持つデータベースです。 .Pp オプションリスト: .Bl -tag -width 4n .It Fl I Ar map_dir このオプションは .Ar charmap ファイルを探すディレクトリ名を設定します。 デフォルトでカレントディレクトリです。 .It Fl o Ar out_file 出力ファイル名を設定します。 デフォルトで .Ar LC_COLLATE になります。 .El .Pp 照合シークエンス定義は、照合要素集合、 およびこれを含む文字列をどのように順序付けるかを定義する規則を指定します これは異なる言語定義に最も便利です。 .Pp 指定ファイルは次の三つのステートメントから成ります: .Ar charmap , .Ar substitute, .Ar order .Pp この中で .Ar order ステートメントだけが必須です。 .Ar charmap や .Ar substitute が与えられたときは、ステートメントの順序は上のようになっていなければ なりません。 orderステートメントの後のステートメントは無視されます。 .Pp 指定ファイルの中で .Ar # で始まる行はコメントと扱われ、無視されます。空行も無視されます。 .Pp .Ar charmap charmapfile .Pp .Ar charmap は、文字のマッピングと実際の文字エンコーディングへの照合要素シンボル が見つかる場所を定義します。 .Pp .Ar charmapfile のフォーマットを以下に示します。 シンボル名とその値は、タブまたは空白文字によって区切られます。 symbol-value は 16 進 (\ex\fI??\fR) または 8 進 (\e\fI???\fR) 表現で指定でき、長さは一文字を意味します。 .Bd -literal .Ar symbol-name1 symbol-value1 .Ar symbol-name2 symbol-value2 .Ar ... .Ed .Ar charmap ステートメントはオプション指定です。 .Pp .Ar substitute \fIsymbol\fR .Ar with \fIrepl_string\fR .Pp .Ar substitute ステートメントは、文字 .Ar symbol を文字列 .Ar repl_string に置き換えます。 .Pp .Ar substitute ステートメントはオプション指定です。 .Pp .Ar order order_list .Pp .Ar order_list は、セミコロンで区切られた、照合シークエンスを定義する シンボルのリストです。 特殊シンボル .Ar ... は、簡略な形の機械語順で連なったシンボルを指定します。 .Pp orderリストの要素は、次の方法のうちのどれかで表現できます。 .Bl -bullet .It シンボル自身 (例えば、小文字の .Ar a は .Ar a と書きます) .It シンボルチェーン (例えば、 .Ar abc ) .It 8 進表現 (例えば、文字 .Ar a には .Ar \e141 ) .It 16 進表現 (例えば、文字 .Ar a には .Ar \ex61 ) .It .Ar charmap ファイル内で定義されたシンボル名 (例えば、 .Ar charmapfile の .Ar abc \e023 に対して .Ar )。文字マップ名が、文字 .Ar > を持つ場合は、 .Ar /> , のようにエスケープされなければならず、 文字 .Ar / は .Ar // のようにエスケープされなければなりません。 .It シンボル .Ar \ea , .Ar \eb , .Ar \ef , .Ar \en , .Ar \er , .Ar \ev は、通常の C言語の意味で使うことが許されています。 .It シンボルの範囲 (例えば .Ar a;...;z ) .It コンマ区切りのシンボル、範囲、チェーンは括弧でくくられます。 (例えば .Ar \&( .Ar sym1 , .Ar sym2 , .Ar ... .Ar \&) ) は同じ一次順序で割り当てられますが、異なる二次順序となります。 .It 鈎括弧でくくられたコンマ区切りのシンボル、範囲、チェーン (例えば、 .Ar \&{ .Ar sym1 , .Ar sym2 , .Ar ... .Ar \&} ) は、同じ一次順序だけに割り当てられます) .El .Pp バックスラッシュ文字 .Ar \e は、行の継続に使われます。この場合、バックスラッシュ文字の後には どんな文字も書かれてはなりません。 .Sh 診断 -.Nm colldef -は、次の戻り値で終了します。 +.Nm +ユーティリティは、次の戻り値で終了します。 .Bl -tag -width indent .It Li 0 エラーがなく、出力の生成に成功した場合 .It Li !=0 エラーが見つかった場合 .El .Sh 関連ファイル .Ar /usr/share/locale//LC_COLLATE localeの配下で、localeの照合順序のための標準共有位置 .Sh 関連項目 .Xr mklocale 1 , .Xr setlocale 3 , .Xr strcoll 3 , .Xr strxfrm 3 diff --git a/ja_JP.eucJP/man/man1/colrm.1 b/ja_JP.eucJP/man/man1/colrm.1 index 4b149f63bf..a659bd6181 100644 --- a/ja_JP.eucJP/man/man1/colrm.1 +++ b/ja_JP.eucJP/man/man1/colrm.1 @@ -1,76 +1,76 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)colrm.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/colrm/colrm.1,v 1.3.2.3 2001/08/16 13:16:45 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/colrm.1,v 1.5 2001/07/29 05:14:50 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/colrm/colrm.1,v 1.3.2.4 2002/06/20 23:45:32 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt COLRM 1 .Os .Sh 名称 .Nm colrm .Nd 指定した桁を削除する .Sh 書式 .Nm colrm .Op Ar start Op Ar stop .Sh 解説 .Nm -は、指定された桁をファイルの各行から削除します。 +ユーティリティは、指定された桁をファイルの各行から削除します。 1 桁は 1 文字分に相当します。 ファイルは標準入力から読み込まれ、結果は標準出力に書き出されます。 .Pp .Ar start だけが与えられた場合は、 .Ar start 桁目より前のすべての桁が表示されます。 .Ar start と .Ar stop の両方が指定された場合は、 .Ar start 桁目より前のすべての桁と、 .Ar stop 桁目より後のすべての桁が表示されます。 桁の番号づけは 0 ではなく 1 から始まります。 .Pp タブ文字を読むと、その桁位置の次に来る 8 の倍数の桁まで桁位置を進めます。 バックスペース文字を読むと、桁位置を 1 戻します。 .Sh 関連項目 .Xr awk 1 , .Xr column 1 , .Xr cut 1 , .Xr paste 1 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/comm.1 b/ja_JP.eucJP/man/man1/comm.1 index 93ce3d4571..0da27ef6a6 100644 --- a/ja_JP.eucJP/man/man1/comm.1 +++ b/ja_JP.eucJP/man/man1/comm.1 @@ -1,100 +1,100 @@ .\" %NetBSD: comm.1,v 1.4 1995/03/26 09:25:50 glass Exp % .\" .\" 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 .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" From: @(#)comm.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/comm/comm.1,v 1.4.2.3 2001/08/16 13:16:46 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/comm.1,v 1.9 2001/08/17 06:18:09 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/comm/comm.1,v 1.4.2.4 2002/06/20 23:45:34 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Os .Dt COMM 1 .Sh 名称 .Nm comm .Nd 2つのファイルの共通な行もしくは共通でない行を出力する .Sh 書式 .Nm comm .Op Fl 123i .Ar file1 file2 .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar file1 と .Ar file2 を読み込んで(辞書的にソートされている必要があります)、 3 つのテキストカラムを出力します: それぞれ、 .Ar file1 のみにある行; .Ar file2 のみにある行; 両方のファイルにある行です。 .Pp ファイル名 ``-'' は標準入力を意味します。 .Pp オプションとしては以下のものがあります: .Bl -tag -width indent .It Fl 1 第 1 カラムの表示をしません。 .It Fl 2 第 2 カラムの表示をしません。 .It Fl 3 第 3 カラムの表示をしません。 .It Fl i 行比較を大文字と小文字を区別せずに行います。 .El .Pp それぞれのカラムの前にタブが付属しますが、 タブの数はそのカラムより番号の若いカラムで表示されるカラムの数に等しいです。 例えば、第 2 カラムの表示をしない場合、 第 1 カラムを表示する行では先頭にタブは付属せず、 第 3 カラムを表示する行では先頭にタブが 1 つ付属します。 .Pp .Nm はファイルが辞書的にソートされている事を期待します; 全ての文字が行の比較に使用されるからです。 .Sh 診断 .Ex -std .Sh 関連項目 .Xr cmp 1 , .Xr diff 1 , .Xr sort 1 , .Xr uniq 1 .Sh 規格 .Nm ユーティリティは .St -p1003.2-92 を満します。 diff --git a/ja_JP.eucJP/man/man1/compress.1 b/ja_JP.eucJP/man/man1/compress.1 index fd2c44eeef..b6c9c211f6 100644 --- a/ja_JP.eucJP/man/man1/compress.1 +++ b/ja_JP.eucJP/man/man1/compress.1 @@ -1,164 +1,164 @@ .\" Copyright (c) 1986, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" James A. Woods, derived from original work by Spencer Thomas .\" and Joseph Orost. .\" .\" 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. .\" .\" @(#)compress.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/compress/compress.1,v 1.4.2.6 2002/04/12 16:07:06 trhodes Exp % +.\" %FreeBSD: src/usr.bin/compress/compress.1,v 1.4.2.7 2002/06/20 23:45:37 charnier Exp % .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt COMPRESS 1 .Os .Sh 名称 .Nm compress , .Nm uncompress .Nd データを圧縮、展開する .Sh 書式 .Nm compress .Op Fl cfv .Op Fl b Ar bits .Op Ar .Nm uncompress .Op Fl cfv .Op Ar .Sh 解説 .Nm -は adaptive Lempel-Ziv 法を用いて、ファイルを圧縮します。 +ユーティリティは adaptive Lempel-Ziv 法を用いて、ファイルを圧縮します。 個々の圧縮された .Ar file は、元のファイル名に拡張子 .Dq .Z を付加したものにリネームされます。そして、ファイルの更新時刻、 最終アクセス時刻、ファイルフラグ、モード、ユーザID、グループID の大半 は、パーミッションの許す範囲で圧縮ファイルに引き継がれます。 もし圧縮しても .Ar file のサイズが小さくならない場合、compress はそのファイルを無視します。 .Pp .Nm uncompress -は、compress されたファイルを元通りのファイルにリストアし、 +ユーティリティは、compress されたファイルを元通りのファイルにリストアし、 ファイル名を拡張子 .Dq .Z を除いたものにリネームします。 .Pp compress, uncompress によってリネームされるファイルの名前がすでに存在 し、標準入力が端末の場合は、上書きしてもよいか確認を求めるプロンプトが (標準エラー出力に) 出力されます。 プロンプトが出せなかったり、確認の回答が得られなかった場合には、 ファイルは上書きされません。 .Pp ファイル名が指定されなかった場合、標準入力からのデータが圧縮もしくは 展開され、結果が標準出力に出力されます。 入力および出力ファイルが通常ファイルでない場合、圧縮後のサイズの チェックとファイルの上書きチェックは行なわれません。 入力ファイルは削除されず、また入力ファイルの属性は引き継がれません。 .Pp オプションは以下のものがあります: .Bl -tag -width indent .It Fl b .Ar bits コードの上限値を指定します(以下を参照)。 .It Fl c compressed または uncompressed の出力を標準出力に出します。 入力元のファイルは参照されるのみで変更されません。 .It Fl f ファイル長が小さくなるならないにかかわらず、ファイルの圧縮を強行 します。また、圧縮ファイルと同名のファイルがすでに存在しても、確認を 求めることなく強制的にファイルの上書きを行ないます。 .It Fl v 圧縮後、ファイルサイズがどれだけ減ったかをパーセント表示します。 .El .Pp .Nm -は Lempel-Ziv修正アルゴリズムを使用します。 +ユーティリティは Lempel-Ziv 修正アルゴリズムを使用します。 ファイル内の重複する部分文字列は、まず、257 以上の 9ビットコードに 置き換えられます。コードが 512 に達すると、アルゴリズムは 10ビットコードへ切り替えられ、 .Fl b フラグによって指定された上限(デフォルトは16)に達するまで、更に上の ビットを使っていきます。 .Ar Bits は、9 から 16 の範囲になければなりません。 .Pp .Ar bits の上限に達すると、 .Nm は圧縮率を定期的にチェックします。 圧縮率が上がっているとき、 .Nm は既存のコード辞書を使い続けますが、 圧縮率が下がったときは .Nm は、部分文字列のテーブルを破棄し、最初からテーブルを作り直します。 こうして、アルゴリズムをファイルの次の "block" へ適用していくことが できます。 .Pp ランダムデータの展開または圧縮されたデータの再圧縮を行わないように するためのマジックナンバと共に、圧縮の際に指定された .Ar bits パラメータがエンコードされ、圧縮ファイルの中に保存されるため、 .Nm uncompress では .Fl b フラグが省略されています。 .Pp 得られる圧縮の量は、入力サイズ、コードあたりの .Ar bits の数, および重複する部分文字列の分布に依存しています。 普通、ソースコードや英語のテキストは、50\-60% 圧縮されます。 一般的に (packコマンドで使われている) Huffman法、または (compactコマンドで使われている)最適化Huffman法よって得られるより、圧縮 は良く、計算時間もかかりません。 .Sh 診断 .Ex -std compress uncompress .Sh 関連項目 .Xr gunzip 1 , .Xr gzexe 1 , .Xr gzip 1 , .Xr zcat 1 , .Xr zmore 1 , .Xr znew 1 .Rs .%A Welch, Terry A. .%D June, 1984 .%T "A Technique for High Performance Data Compression" .%J "IEEE Computer" .%V 17:6 .%P pp. 8-19 .Re .Sh 歴史 .Nm コマンドは .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/crontab.1 b/ja_JP.eucJP/man/man1/crontab.1 index bcae1bfbfc..49864118b6 100644 --- a/ja_JP.eucJP/man/man1/crontab.1 +++ b/ja_JP.eucJP/man/man1/crontab.1 @@ -1,128 +1,128 @@ .\"/* Copyright 1988,1990,1993 by Paul Vixie .\" * All rights reserved .\" * .\" * Distribute freely, except: don't remove my name from the source or .\" * documentation (don't take credit for my work), mark your changes (don't .\" * get me blamed for your possible bugs), don't alter or remove this .\" * notice. May be sold if buildable source is provided to buyer. No .\" * warrantee of any kind, express or implied, is included with this .\" * software; use at your own risk, responsibility for damages (if any) to .\" * anyone resulting from the use of this software rests entirely with the .\" * user. .\" * .\" * Send bug reports, bug fixes, enhancements, requests, flames, etc., and .\" * I'll try to keep a version up to date. I can be reached as follows: .\" * Paul Vixie uunet!decwrl!vixie!paul .\" */ .\" -.\" %FreeBSD: src/usr.sbin/cron/crontab/crontab.1,v 1.7.2.3 2002/04/28 22:45:48 dwmalone Exp % +.\" %FreeBSD: src/usr.sbin/cron/crontab/crontab.1,v 1.7.2.4 2002/06/21 16:40:09 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd December 29, 1993 .Dt CRONTAB 1 .Os .Sh 名称 .Nm crontab .Nd 個人用の crontab の編集を行う (V3) .Sh 書式 .Nm crontab .Op Fl u Ar user .Ar file .Nm crontab .Op Fl u Ar user { .Fl l | .Fl r | .Fl e } .Sh 解説 -.Nm crontab -は、 +.Nm +ユーティリティは、 Vixie Cron の .Xr cron 8 デーモンが扱うテーブル内のエントリの 追加、削除、およびリスト表示を行います。各ユーザは、自分用の crontab ファイルを持つことができます。このファイルは .Pa /var 内にありますが、 これはエディタで直接変更するためのものではありません。 .Pp もし .Pa allow ファイル .Pq Pa /var/cron/allow が存在した場合、このコマンドを 使うためには、あなたの名前がこの .Pa allow ファイルになければなりません。また、 .Pa allow ファイルは存在しないが .Pa deny ファイル .Pq Pa /var/cron/deny が存在した場合に、 このコマンドを使うためには、あなたの名前がこの .Pa deny ファイルにあっては .Em いけません 。 どちらのファイルも存在しない場合、サイト依存の設定パラメータにより スーパユーザだけがこのコマンドを使うことができるか、 すべてのユーザがこのコマンドを使うことができるかが決定されます。 これらのファイルの書式は、行毎にユーザ名を記述するものであり、 空白を前にも後にも入れてはなりません。 これに合致しない行は無視されますので、コメントとして使用可能です。 .Pp このコマンドの最初の書式は file から新しい crontab をインストールする 場合に使います。ファイル名として ``-'' が指定された時は、標準入力から 読み込みます。 .Pp 以下のオプションを使用可能です: .Bl -tag -width indent .It Fl u 指定した user の crontab ファイルに対して操作を行います。 このオプションがない場合には、コマンドを実行した人 の crontab ファイルに対しての操作になります。 .Xr su 1 をしている場合は混乱する可能性がありますから、正確を期するため、この場合には .Fl u をつねにつけるようにすべきです。 .It Fl l 現在の crontab ファイルを標準出力に表示します。 .It Fl r 現在の crontab ファイルを削除します。 .It Fl e 現在の crontab を編集します。環境変数 .Ev VISUAL もしくは .Ev EDITOR があれば、この環境変数で指定したエディタを利用します。 指定したエディタは、ファイルをその場で編集するものであることが .Em 必要 です。 ファイルを削除してから再作成するエディタは、使用不可です。 エディタを終了すれば、crontab ファイルが自動的にインストールされます。 .El .Sh 関連項目 .Xr crontab 5 , .Xr cron 8 .Sh 関連ファイル .Bl -tag -width /var/cron/allow -compact .It Pa /var/cron/allow .It Pa /var/cron/deny .El .Sh 規格 .Nm コマンドは .St -p1003.2 準拠です。 この新しい文法は以前の Vixie Cron のものとも 古典的な SVR3 のものとも異なっています。 .Sh 診断 誤ったコマンドラインを与えて実行した場合、 使用法についてのかなり有益なメッセージが出力されます。 .Sh 作者 .An Paul Vixie Aq paul@vix.com diff --git a/ja_JP.eucJP/man/man1/crunchgen.1 b/ja_JP.eucJP/man/man1/crunchgen.1 index 79f00d84de..7dd26d7a42 100644 --- a/ja_JP.eucJP/man/man1/crunchgen.1 +++ b/ja_JP.eucJP/man/man1/crunchgen.1 @@ -1,471 +1,471 @@ .\" .\" Copyright (c) 1994 University of Maryland .\" All Rights Reserved. .\" .\" Permission to use, copy, modify, distribute, and sell this software and its .\" documentation for any purpose is hereby granted without fee, provided that .\" the above copyright notice appear in all copies and that both that .\" copyright notice and this permission notice appear in supporting .\" documentation, and that the name of U.M. not be used in advertising or .\" publicity pertaining to distribution of the software without specific, .\" written prior permission. U.M. makes no representations about the .\" suitability of this software for any purpose. It is provided "as is" .\" without express or implied warranty. .\" .\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M. .\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR .\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" Author: James da Silva, Systems Design and Analysis Group .\" Computer Science Department .\" University of Maryland at College Park -.\" %FreeBSD: src/usr.sbin/crunch/crunchgen/crunchgen.1,v 1.11.2.9 2002/04/14 20:55:21 luigi Exp % +.\" %FreeBSD: src/usr.sbin/crunch/crunchgen/crunchgen.1,v 1.11.2.10 2002/06/21 16:40:12 charnier Exp % .\" .\" $FreeBSD$ .Dd November 16, 2000 .Dt CRUNCHGEN 1 .Os .Sh 名称 .Nm crunchgen .Nd クランチバイナリ構築環境を作成する .Sh 書式 .Bk -words .Nm .Op Fl foql .Op Fl h Ar makefile-header-name .Op Fl m Ar makefile-name .Op Fl p Ar obj-prefix .Op Fl c Ar c-file-name .Op Fl e Ar exec-file-name .Op Ar conf-file .Ek .Sh 解説 クランチバイナリ (crunched binary) は、 たくさんの別々のプログラムをひとつにまとめて 単一の実行形式にしたプログラムです。 クランチバイナリの .Fn main 関数は、 .Va argv[0] の値をみて、 どのコンポーネントプログラムが実行されるべきかを決定します。 複数プログラムをクランチしてひとつにまとめる主たる理由は、 インストールフロッピあるいはシステム回復フロッピ上に、 できるだけ多くのプログラムを収納するためです。 .Pp .Nm -は +ユーティリティは .Ar conf-file に記述されたクランチバイナリのための設定項目を読み込み、 .Pa Makefile とそれに付随するトップレベルの C ソースファイルを生成します。 これらはビルド時に各コンポーネントプログラムからクランチした実行形式を 作成します。 オプションにより、 .Nm は、各コンポーネントプログラムに対して、 そのソースディレクトリの .Pa Makefile から プログラムを構成するオブジェクトファイル (.o) を決定することも試みます。 この情報は実行のたびにキャッシュされます。 .Nm -は関連するもうひとつのプログラム +ユーティリティは関連するもうひとつのプログラム .Xr crunchide 1 を用い、全ての不要なシンボルを隠すことで コンポーネントプログラム間のリンク時のシンボル競合を防ぎます。 .Pp .Nm -は特殊な要件をパッケージの +ユーティリティは特殊な要件をパッケージの .Pa Makefile に課しており、このことが原因で .Pa Makefile が非 .Bx ソース用に使えなくなっています。 特に、 .Pa Makefile はターゲット .Ic depend を含むことが必要であり、全オブジェクトファイルを変数 .Va OBJS で定義することが必要です。 場合によっては、偽の .Pa Makefile を使えるでしょう。 .Nm は、ソースディレクトリ .Pa foo 中の .Pa Makefile を見る前に、現在のディレクトリ中の .Pa Makefile.foo を見ます。 .Pp .Nm 実行後、 .Dq Li make -f .mk を実行することで クランチバイナリを作成できます。 コンポーネントプログラムのオブジェクトファイルは既に作成されている 必要があります。 出力される makefile に含まれる .Ic objs ターゲットは、 各コンポーネントプログラムのソースディレクトリで .Xr make 1 を実行し、ユーザのためにオブジェクトファイルを作成してくれます。 しかしこのターゲットは自動的には実行されません。 リリースエンジニアリング環境では、オブジェクトを他のディレクトリで 修正するのは一般に望ましくないからです。 .Pp オプションは以下の通りです: .Bl -tag -width indent .It Fl c Ar c-file-name 出力する C のファイル名を .Ar c-file-name とします。デフォルトの名前は .Pa .c です。 .It Fl e Ar exec-file-name クランチバイナリの実行形式ファイルの名前を .Ar exec-file-name とします。デフォルトの名前は .Pa です。 .It Fl f キャッシュを消去し、キャッシュされていたパラメータを強制的に再計算します。 .It Fl l 名前の表示。このバイナリが対応する名前を一覧表示します。 .It Fl h Ar makefile-header-name .Nm が生成する .Pa Makefile の先頭に含めるファイルの名前を設定します。 make の変数を定義するのに便利です。 これには、 .Xr make 1 の動作に影響を与え、環境変数を介してでは面倒である、 .Va RELEASE_CRUNCH が含まれます。 .It Fl m Ar makefile-name 出力する .Pa Makefile の名前を .Ar makefile-name とします。デフォルトの名前は .Pa .mk です。 .It Fl o 各プログラムの make ターゲットに対し、 .Dq Li make obj ルールを追加します。 .It Fl p Ar obj-prefix .Ic objdir を計算するときに、 .Ic srcdir の前に付けるパス名を設定します。 このオプションが存在しない場合、使用するプレフィックスは .Ev MAKEOBJDIRPREFIX 環境変数の内容か、または .Pa /usr/obj です。 .It Fl q 静粛処理モード。状況報告メッセージを抑制します。 .El .Sh CRUNCHGEN コンフィギュレーションファイルコマンド .Nm -は、クランチバイナリのコンポーネントについて記述した設定項目を +ユーティリティは、クランチバイナリのコンポーネントについて記述した設定項目を .Ar conf-file から読み取ります。 最も単純な場合は、各コンポーネントプログラム名を、 そのソースファイルが置かれたトップレベルのディレクトリ名とともに、 単に列挙するだけです。 次に .Nm -は (ソースの makefile によって) オブジェクトファイルリストと +ユーティリティは (ソースの makefile によって) オブジェクトファイルリストと その位置を求め、それをキャッシュします。 もっと特殊な場合には、 .Nm が必要とするあらゆるパラメータを、ユーザが手動で指定することができます。 .Pp .Ar conf-file のコマンドは以下の通りです: .Bl -tag -width indent .It Ic srcdirs Ar dirname ... コンポーネントプログラムのソースディレクトリがあるソースツリーのリスト。 これらのディレクトリは .Bx の .Dq Pa // 方式を用いて検索されます。 .Ic srcdirs 行は複数あってもよく、ディレクトリは記述された順に検索されます。 .It Ic progs Ar progname ... クランチバイナリを構成するプログラムのリスト。 .Ic progs 行は複数あっても構いません。 .It Ic libs Ar libspec ... クランチバイナリのリンク時に含めるライブラリ指定のリスト。 .Ic libs 行は複数あっても構いません。 .It Ic buildopts Ar buildopts ... 各 make ターゲットに追加追加される、ビルドオプションのリスト。 .It Nm ln Ar progname linkname .Va argv[0] に .Ar linkname が現われたときはいつも .Ar progname を起動するよう、クランチバイナリに要請します。 これにより、起動時の名前によって振る舞いを変えるようなプログラムも 正しく動作するようにできます。 .El .Pp 特別な状況、例えば ソースファイルがないとか、 従来の .Pa Makefile によらないビルドを行うといった場合に対応するため、以下に述べる .Ic special コマンドを用いてコンポーネントプログラムの .Nm パラメータを指定できます。 .Bl -tag -width indent .It Ic special Ar progname Ic srcdir Ar pathname プログラム用 .Ar progname のオブジェクトファイル一覧を保持する make 変数の名前を設定します。 これは通常 .Nm OBJS ですが、Makefile によっては、他の約束が好ましい場合や、 .Nm SSHD_OBJS のようにプログラム名が前に付くものがあります。 .It Nm special Ar progname Nm srcdir Ar pathname プログラム .Ar progname のソースディレクトリを指定します。 通常は指定されたディレクトリ .Ic srcdirs 内の .Ar progname ディレクトリを検索して決定されます。 .It Ic special Ar progname Ic objdir Ar pathname プログラム .Ar progname の .Pa obj ディレクトリを指定します。 通常、 .Pa obj ディレクトリは、 ソースディレクトリ名の前に次のいずれかのコンポーネントを付けたものとして 計算され、コンポーネントには次の順番で優先度があります: コマンドラインにおける .Fl p の引数、環境変数 .Ev MAKEOBJDIRPREFIX の値、または .Pa /usr/obj です。 もしディレクトリが見つからなければ、ディレクトリ .Ic srcdir 自身が .Ic objdir となります。 .It Ic special Ar progname Ic buildopts Ar buildopts ビルドオプション集合を定義します。 .Ar progname 処理時には、 .Nm buildopts で指定されたものに加え、これらが追加されて .Xr make 1 のターゲットが作成されます。 .It Ic special Ar progname Ic objs Ar object-file-name ... プログラム .Ar progname のオブジェクトファイルのリストを指定します。 通常は、 .Dq Ic srcdir Ns / Ns Pa Makefile をインクルードし .Va $(OBJS) の値を出力するような一時 makefile を構築する ことで決定されます。 .It Ic special Ar progname Ic objpaths Ar full-pathname-to-object-file ... プログラム .Ar progname のオブジェクトファイルのパス名を指定します。 通常は .Ic objs リスト中の各ファイルのパス名の先頭に .Ic objdir を付加することで決定されます。 .It Ic special Ar progname Ic objvar Ar variable_name プログラム .Ar progname 用のオブジェクトファイルリストを保持する .Xr make 1 変数名を設定します。 これは通常 .Va OBJS ですが、 .Pa Makefile によっては別の規約を使用したいかもしれませんし、 変数名の前にプログラム名を付けたいかもしれません。例えば .Va SSHD_OBJS など。 .It Ic special Ar progname Ic lib Ar library-name ... .Ar progname.lo を生成するためにオブジェクトファイルとリンクするライブラリを指定します。 標準ライブラリに含まれるルーチンを再定義するライブラリを使用するときに 有用です。 .It Ic special Ar progname Ic keep Ar symbol-name ... プログラム .Ar progname の保持リストに、指定するシンボルのリストを追加します。 各シンボルの前にはアンダスコア .Pq Ql _ が付加され、 .Xr crunchide 1 フェーズでは .Fl k オプションの引数となります このオプションはシンボルが衝突するときの最後の拠所ですが、 シンボル解決の唯一の方法である場合もあります。 .It Ic special Ar progname Ic ident Ar identifier .Ar progname に対する .Pa Makefile Ns / Ns Tn C 識別子を設定します。 これは通常、 .Ar progname を元に、 .Ql - を .Ql _ にマップし、他のすべての非識別子文字を無視することにより、生成されます。 この結果、 .Qq Li foo.bar と .Qq Li foobar は、同一の識別子にマップされてしまいます。 .El .Pp 実際に .Nm が必要とするのは .Ic objpaths だけですが、 これは .Ic objdir と .Ic objs から求められ、これらも .Ic srcdir から求められます。 ですから、もし可能なら、初期のパラメータを指定し、あとは .Nm に求めさせたほうが便利な場合もあります。 .Pp .Nm が生成する makefile はオプションのターゲット .Ic objs を含みます。 これは、各コンポーネントプログラムのソースディレクトリ内で .Xr make 1 を実行してオブジェクトファイルを作成するターゲットです。 これがうまく動作するためには .Ic srcdir および .Ic objs パラメータが正しいものでなくてはなりません。 もしこれらの値があるプログラムに対して不正なものであると、 .Ic objs ターゲットではそのプログラムはスキップされてしまいます。 .Sh 実行例 .Nm の入力コンフィギュレーションファイルの例として .Dq Pa kcopy.conf の内容を示します。 .Pp .Bd -literal -offset indent srcdirs /usr/src/bin /usr/src/sbin progs test cp echo sh fsck halt init mount umount myinstall progs anotherprog ln test [ # test は [ として起動することもできる ln sh -sh # init は argv[0] を "-sh" としてシェルを起動する special myprog objpaths /homes/leroy/src/myinstall.o # ソースなし special anotherprog -DNO_FOO WITHOUT_BAR=YES libs -lutil -lcrypt .Ed .Pp このコンフィギュレーションファイルでは、 いくつかの基本的なシステムユーティリティと 自家製のインストールプログラム .Dq Pq myinstall から成る 小さなクランチバイナリを記述しています。 ソースディレクトリは全く指定されていませんが、 オブジェクトファイルは .Nm special 行で直接指定されています。 .Pp さらに、 .Dq Pa anotherprog 構築時には、引数 .Pp .Dl -DNO_FOO WITHOUT_BAR=YES .Pp がすべてのビルドターゲットに対して追加されます。 .Pp クランチバイナリ .Dq Pa kcopy は以下のようにして作成できます: .Pp .Bd -literal -offset indent % crunchgen -m Makefile kcopy.conf # Makefile と kcopy.c 作成 % make objs # コンポーネントプログラムの *.o 作成 % make # クランチバイナリ kcopy の作成 % kcopy sh # シェル sh を起動できるかどうか試すと.. $ # うまくいった! .Ed .Pp ここまでくれば、バイナリ .Dq Pa kcopy をインストールフロッピにコピーし、 各コンポーネントプログラムの名前でハードリンクを設けることができます。 .Sh 関連項目 .Xr crunchide 1 .Xr make 1 .Sh 警告 .Nm はクランチバイナリ中の各コンポーネントプログラム間のリンク競合を 除去するのに気を配っていますが、依然としてリンクされたライブラリ間で 競合が発生する可能性が残っています。 ライブラリ順の入れ換えが必要な場合もありますし、 二つのライブラリ間にどうしても解消できない競合が発生し、 結局ひとつにまとめられない場合も稀にあります。 .Pp .Bx のバージョンによっては、デフォルトのビルド環境では 単一ソースファイルのプログラムに対して 中間オブジェクトファイルを作成しないことがあります。 その場合は .Dq Li make objs ターゲットを用いてオブジェクトファイルを 作成するか、他の調整を施す必要があります。 .Sh 作者 .Nm -は +ユーティリティは .An James da Silva Aq jds@cs.umd.edu によって作成されました。 .Pp Copyright (c) 1994 University of Maryland. All Rights Reserved. diff --git a/ja_JP.eucJP/man/man1/crunchide.1 b/ja_JP.eucJP/man/man1/crunchide.1 index 6897752ff1..e38c587b6a 100644 --- a/ja_JP.eucJP/man/man1/crunchide.1 +++ b/ja_JP.eucJP/man/man1/crunchide.1 @@ -1,89 +1,89 @@ .\" .\" Copyright (c) 1994 University of Maryland .\" All Rights Reserved. .\" .\" Permission to use, copy, modify, distribute, and sell this software and its .\" documentation for any purpose is hereby granted without fee, provided that .\" the above copyright notice appear in all copies and that both that .\" copyright notice and this permission notice appear in supporting .\" documentation, and that the name of U.M. not be used in advertising or .\" publicity pertaining to distribution of the software without specific, .\" written prior permission. U.M. makes no representations about the .\" suitability of this software for any purpose. It is provided "as is" .\" without express or implied warranty. .\" .\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M. .\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR .\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" Author: James da Silva, Systems Design and Analysis Group .\" Computer Science Department .\" University of Maryland at College Park -.\" %FreeBSD: src/usr.sbin/crunch/crunchide/crunchide.1,v 1.5.2.3 2001/08/16 15:55:53 ru Exp % +.\" %FreeBSD: src/usr.sbin/crunch/crunchide/crunchide.1,v 1.5.2.4 2002/06/21 16:40:16 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/crunchide.1,v 1.7 2001/07/29 05:14:50 horikawa Exp $ +.\" $FreeBSD$ .Dd June 14, 1994 .Dt CRUNCHIDE 1 .Os .Sh 名称 .Nm crunchide .Nd プログラムをクランチしてまとめる際に、シンボル名を ld から隠蔽する .Sh 書式 .Nm crunchide .Op Fl f Ar keep-list-file .Op Fl k Ar keep-symbol .Op Ar object-file ... .Sh 解説 .Nm -は +ユーティリティは .Ar object-file の大域シンボルを隠蔽し、 続くリンカ .Xr ld 1 の実行でそれらが無視されるようにします。 .Fl k Ar keep-symbol オプションおよび .Fl f Ar keep-list-file オプションにより、 いくつかのシンボルを見える状態のままにしておくことができます。 ファイル .Ar keep-list-file は、見える状態にしておくシンボルのリストです。 このファイルにはシンボルを 1 行にひとつずつ記述します。 .Ar keep-symbol もしくは .Ar keep-list-file において指定する名前は、C における名前です。例えば C の関数 .Dq foo を見えるようにするためには、オプション .Dq -k foo を使用します。 .Pp -.Nm crunchide -は +.Nm +ユーティリティは .Xr crunchgen 1 とともに用いられるプログラムとして設計されています。 .Xr crunchgen 1 は複数のコンポーネントプログラムからクランチバイナリを作成する 処理を自動化するプログラムです。 .Sh 関連項目 .Xr crunchgen 1 , .Xr ld 1 .Sh 作者 -.Nm crunch -は +.Nm +ユーティリティは .An James da Silva Aq jds@cs.umd.edu によって作成されました。 .Pp Copyright (c) 1994 University of Maryland. All Rights Reserved. .Pp .An Chris Demetriou Aq cgd@netbsd.org が .Nm を再構成し、複数のオブジェクト形式をサポートし、 ELF オブジェクトのサポートと ECOFF オブジェクトの認識を追加しました。 .Pp Copyright (c) 1997 Christopher G. Demetriou. All Rights Reserved. diff --git a/ja_JP.eucJP/man/man1/ctags.1 b/ja_JP.eucJP/man/man1/ctags.1 index ac8c5fc333..e7a67af634 100644 --- a/ja_JP.eucJP/man/man1/ctags.1 +++ b/ja_JP.eucJP/man/man1/ctags.1 @@ -1,224 +1,224 @@ .\" Copyright (c) 1987, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)ctags.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/ctags/ctags.1,v 1.5.2.4 2001/12/14 15:53:29 ru Exp % +.\" %FreeBSD: src/usr.bin/ctags/ctags.1,v 1.5.2.5 2002/06/20 23:45:39 charnier Exp % .\" $FreeBSD$ .\" .\" ctags.1 修正時には gctags.1 も同様に修正して下さい。 .\" Aug 31 1997 .Dd June 6, 1993 .Dt CTAGS 1 .Os .Sh 名称 .Nm ctags .Nd .Pa tags ファイルを作成する .Sh 書式 .Nm ctags .Op Fl BFadtuwvx .Op Fl f Ar tagsfile .Ar name ... .Sh 解説 .Nm は、指定された C, Pascal, Fortran, .Xr yacc 1 , .Xr lex 1 , lisp のソースから、 .Xr ex 1 コマンド用の .Pa tags ファイルを作成します。 タグファイルは、指定されたオブジェクトが一群のファイル中の どの場所にあるかを示すものです。 タグファイルの各行はオブジェクトの名前、定義されているファイル、 オブジェクトの定義を見つけるための検索パターンを含み、 各々は空白で区切られています。 この .Pa tags ファイルを用いることにより、 .Xr ex 1 でこれらのオブジェクトが定義されている場所をすばやく見つけることが できます。 .Nm に与えられるオプションによりますが、オブジェクトは subroutine、 typedef、 define、 struct、 enum、 union から 構成されます。 .Pp 次のオプションを使用可能です: .Bl -tag -width indent .It Fl B 後方検索パターン .Pq Li ?...? を用います。 .It Fl F 前方検索パターン .Pq Li /.../ を用います(デフォルト)。 .It Fl a 既存の .Pa tags ファイルに追加します。 .It Fl d 引数を持たない .Li #define に関してもタグを作成します。引数を持つ .Li #define は自動的にタグが作成されます。 .It Fl f Ar tagsfile .Ar tagsfile で指定されたファイル名でタグファイルを生成します。 デフォルトでは .Pa tags というファイル名でタグファイルを生成します。 .It Fl t typedef, struct, union, enum 宣言のタグを生成します。 .It Fl u .Pa tags ファイル内の指定されたファイルに関する情報を更新します。 すなわち、関係するファイルへのすべての参照が削除され、新しいタグ情報が ファイルに追加されます。 (注意: このオプションはあまりスピードのでないような実装しか おこなわれていません。単に .Pa tags ファイルを再構築した方が早く終了するでしょう。) .It Fl v .Xr vgrind 1 形式のファイル一覧が標準出力に出力されます。 この一覧はオブジェクト名、ファイル名、1 ページあたり 64 行とした場合の ページ番号から構成されます。 出力は辞書式の順番でソートされているので、この後に .Xr sort 1 を通した方がよいでしょう。次のように使います。 .Bd -literal -offset indent ctags -v files | sort -f > index vgrind -x index .Ed .It Fl w 診断用メッセージを表示しないようにします。 .It Fl x .Nm はオブジェクト名、行番号、ファイル名、その行の内容からなる一覧を作成し、 それを標準出力に出力します。 これはオフラインでも読みやすいように印刷できる簡単な関数一覧として 利用できます。 .El .Pp .Pa .c や .Pa .h で終わる名前のファイルは、 C 言語のソースファイルとみなされ、 C の形式の関数・マクロ定義が検索されます。 .Pa .y で終わる名前のファイルは、 .Xr yacc 1 のソースファイルとみなされます。 .Pa .l で終わる名前のファイルは、最初の空白でない文字が .Ql \&; , .Ql \&( , .Ql \&[ のいずれかであれば Lisp のファイルであるとみなされ、そうでなければ .Xr lex 1 のファイルとみなされます。 その他のファイルは、まず Pascal か Fortran の定義が含まれるか どうかがチェックされ、含まれない場合には C 形式の定義が検索されます。 .Pp C 言語の場合、 .Dq Li main は特別に扱われ、元のソースファイルのパス名部分と末尾の .Pa .c の部分を取り除いたファイル名に対し、その先頭に .Ql M を付加したものをオブジェクト名とします。 これにより、同じディレクトリに複数のプログラムがある場合でも .Nm を実用的に使うことができます。 .Pp .Xr yacc 1 と .Xr lex 1 のファイルには特殊なタグがあります。 .Dq Li yyparse は .Xr yacc 1 ファイルの第二セクションの始まりを示し、 .Dq Li yylex は .Xr lex 1 ファイルの第二セクションの始まりを示します。 .Sh 関連ファイル .Bl -tag -width ".Pa tags" -compact .It Pa tags デフォルトで出力されるタグファイル .El .Sh 診断 .Nm ユーティリティは、エラーが発生すると 1 を返し、それ以外では 0 を返します。 同じ名前のオブジェクトが複数出てきてもエラーとはみなされません。 .Sh 関連項目 .Xr ex 1 , .Xr vi 1 .Sh バグ Fortran と Pascal 用の 関数(function)、サブルーチン(subroutine)、手続き(procedure) の認識にはとても単純な方法を用いています。 ブロック構造が解釈できないので、異なるブロックに同じ名前の Pascal 手続きが 存在するとうまく動作しません。 .Nm -は Pascal の型(type)も理解しません。 +ユーティリティは Pascal の型(type)も理解しません。 .Pp C か Pascal か Fortran かを判断する方法はとりあえず動いている、という程度のものです。 .Pp .Nm -はきちんと整形された入力に頼っています。 +ユーティリティはきちんと整形された入力に頼っています。 また、ソースファイルに文法的な間違いがあると 簡単に混乱してしまいます。 文法的に間違っていなくても混乱する場合があります。 例えば、 .Li #ifdef を理解しないので(バグではなく仕様です)、 .Li #ifdef 内に括弧のつりあっていないコードがあると混乱してしまいます。 同様に、定義が複数行にわたっている場合、オブジェクトの先頭行ではなく 最終行が検索パターンにマッチします。 複数行にわたる .Li typedef に関しても同様です。 .Sh 歴史 .Nm ユーティリティは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/ctm.1 b/ja_JP.eucJP/man/man1/ctm.1 index 1413310ded..211be6bdf1 100644 --- a/ja_JP.eucJP/man/man1/ctm.1 +++ b/ja_JP.eucJP/man/man1/ctm.1 @@ -1,311 +1,312 @@ .\"---------------------------------------------------------------------------- .\""THE BEER-WARE LICENSE" (Revision 42): .\" wrote this file. As long as you retain this notice you .\"can do whatever you want with this stuff. If we meet some day, and you think .\"this stuff is worth it, you can buy me a beer in return. Joerg Wunsch .\"---------------------------------------------------------------------------- .\" .\" This manual page is partially obtained from Poul-Hennings CTM README .\" file. .\" .\" CTM and ctm(1) by .\" -.\" %FreeBSD: src/usr.sbin/ctm/ctm/ctm.1,v 1.17.2.7 2001/08/16 15:55:53 ru Exp % +.\" %FreeBSD: src/usr.sbin/ctm/ctm/ctm.1,v 1.17.2.8 2002/06/21 16:40:19 charnier Exp % .\" $FreeBSD$ .\" .Dd March 25, 1995 .Os .Dt CTM 1 .Sh 名称 .Nm ctm .Nd ソースコードをミラーするプログラム .Sh 書式 .Nm ctm .Op Fl cFklquv .Op Fl b Ar basedir .Op Fl B Ar backup-file .Op Fl e Ar include-regex .Op Fl t Ar tar-command .Op Fl T Ar tmpdir .Op Fl V Ar level .Op Fl x Ar exclude-regex .Ar .Sh 解説 .Nm -は、元々 +ユーティリティは、元々 .Dq Cvs Through eMail でしたが、今は代わりに .Dq Current Through eMail と呼ぶのがふさわしいようです。 .Pp .Nm -は、今や 2 つのバージョンのディレクトリツリーの間でデルタを作成して +ユーティリティは、 +今や 2 つのバージョンのディレクトリツリーの間でデルタを作成して 適用するための最も信頼できる方法を意味します。 .Pp これにはデルタの作成と適用という 2 つの部分があります。2 つは 全く異なるものです。 .Ss 使用例 CTM デルタを適用するには、それを .Nm コマンドに渡します。CTM デルタを標準入力、またはファイル名を引数として 渡すことができます。後者の方法を取ると、とても簡単に することができます。なぜなら このプログラムは gzip で圧縮された ファイルを受け付けて、ファイルの一時的なコピーを作る必要が無いからです。 複数のデルタを一度に指定でき、それらは一度にひとつずつ処理されます。 すでに適用されているデルタは無視されます。 .Pp .Nm コマンドの実行はたくさんのパスにわかれています。 次のパスを始める前に、それぞれのパスで入力ファイルの全体が処理されます。 .Pp .Ar name で指定されたファイルを処理する前に .Nm は まず .Ar name.ctm というファイルが存在するかどうかをチェックします。 存在すれば、 .Nm は、かわりにそちらを処理します。 .Pp パス 1 では、入力ファイルが正常かどうかを確認します。 文法、データ、全体の MD5 によるチェックサムがチェックされます。 いずれか 1 つでも異常があれば、 .Nm は単純に入力ファイルを拒否します。 .Pp パス 2 ではディレクトリツリーが CTM デルタの期待している状態に なっているかどうかを確認します。これは存在する/しないはずの ファイルとディレクトリを捜して ファイルの MD5 によるチェックサムをチェックすることで行われます。 .Pp もし .Ar backup-file が .Fl B オプションで指定されていると、その .Nm の呼び出しで変更されるファイルが .Fl t オプションで指定されたアーカイバコマンドを使って、そのファイルに バックアップされます。デフォルトのアーカイバコマンドは .Nm "tar -rf %s -T -" です。 .Pp パス 3 では実際にデルタが適用されます。 .Pp .Nm によって変更されるファイルのリストは、 .Fl e と .Fl x オプションで指定された正規表現によるフィルタの対象になります。 .Fl e と .Fl x オプションは、コマンドラインで指定された順に適用されます。 与えられたファイル名に最後にマッチしたフィルタが、そのファイルを .Nm の適用対象とするかどうかを決定します。 .Pp .Nm -は、その作業ディレクトリ下にファイルの階層を展開します。 +ユーティリティは、その作業ディレクトリ下にファイルの階層を展開します。 絶対パスや .Sq Pa .\& と .Sq Pa ..\& の参照を含むファイル名は、セキュリティのために明確に禁止されています。 .Ss オプション .Bl -tag -width indent .Pp .It Fl b Ar basedir 各ファイル名に .Ar basedir で指定されたパスを前置します。 .Pp .It Fl B Ar backup-file この CTM の実行で変更されるすべてのファイルを .Ar backup-file にバックアップします。 .Fl e と .Fl x オプションで何らかのフィルタが指定されると、 CTM の実行時にフィルタが適用され、変更されたファイルが、 最終的にバックアップされるファイルのセットとなります。 .Pp .It Fl c 確認だけを行ない、他には何もしません。 .Pp .It Fl e Ar regular_expression CTM ファイル中の各ファイル名が .Ar regular_expression にマッチするかどうかを調べ、マッチすればそのファイルを処理し、 マッチしなければ何もせずそのまま残します。 このオプションは何個でも指定できます。このオプションを指定すると .Pa .ctm_status のシーケンス番号のチェックが行なわれません。 例えば、 .Ic ^usr.sbin/ctm と指定すると、 .Pa usr.sbin/ctm というソースディレクトリと、その下のすべてのパス名を指定した事に なります。 .Pp CTM の処理対象からパス名を外すには .Fl x オプションを使います。 .It Fl F 強行します。 .It Fl k ファイルとディレクトリを保存し、CTM ファイルで削除するように 指定されているものでも削除しません。 .Fl B オプションが指定されると、そのファイルとディレクトリは バックアップされません。 .It Fl l その CTM の実行で変更されるはずのファイルと、それに対して 行われるアクションをリストします。 .Fl l オプションを使うと .Pa .ctm_status のチェックと作業対象のソースツリーの正当性チェックが行なわれません。 .Fl l オプションは、 .Fl e と .Fl x オプションを組み合わせることで、与えるコマンドラインオプションで どのファイルが変更されるかを見定めることができます。 .It Fl q 表示を減らします。 .It Fl t Ar tar-command デフォルトのアーカイバである .Nm tar の代わりに .Ar tar-command を使います。 このオプションは、バックアップファイルが .Fl B オプションで指定された場合にのみ効果があります。 tar command 中には一つだけ %s を置くことができ、 バックアップファイルの名前に置き換えられます。 .It Fl T Ar tmpdir 一時ファイルを .Ar tmpdir に置きます。 .It Fl u 作成、変更されるファイルの更新時刻を CTM デルタが作成された 時刻に設定します。 .It Fl v 表示を増やします。 .It Fl V Ar level 表示を増やします。 .Ar level は饒舌さの程度です。 .It Fl x Ar regular_expression CTM ファイル中の各ファイル名を .Ar regular_expression とマッチするかどうかを調べ、マッチすればそのファイルを除外します。 このオプションは何個でも指定できます。このオプションを指定すると .Pa .ctm_status のシーケンス番号のチェックが行なわれません。 .Pp CTM の処理対象にパス名を加えるには .Fl e オプションを使います。 .Pp .El .Sh セキュリティ CTM 自身、 安全ではないプロトコルです - ソースコードへ加えられた修正が信頼できるところから送られたことを 認証しませんので、 通常の電子メール等の信頼できない媒体から CTM デルタを得た場合には注意が必要です。 CTM デルタを偽造して、正当なものを交換または上書きし、 悪意あるコードをあなたのソースツリーに挿入することは、 攻撃者にとって比較的簡単です。 正当なデルタの到着がなんらかの方法で妨げられた場合、 これを感知できるのは、後のデルタが同じファイルを触ろうとする時点です。 この時点で、MD チェックサムが失敗します。 .Pp これを回避して安全なものにするために、 FreeBSD.org が作った CTM 部品には、 GNU Privacy Guard ユーティリティ互換なフォーマットで暗号的に署名しています。 このユーティリティは /usr/ports/security/gpg および Pretty Good Privacy v5 ユーティリティ /usr/ports/security/pgp5 から入手できます。 適切な公開鍵は ctm@FreeBSD.org を finger することで得られます。 .Pp このように署名された CTM デルタは、 検知されることなく攻撃者が改変することはできません。 それゆえ、CTM デルタを電子メールで受信する場合には、 GPG または PGP5 を使用して署名を確認することを勧めます。 .Sh 環境変数 .Ev TMPDIR にパス名がセットされていると、ctm は一時ファイルの置き場所として そのパス名を使います。 これに関しての詳細は .Xr tempnam 3 を参照して下さい。 同じ効果は .Fl T フラグでも得られます。 .Sh 関連ファイル .Pa .ctm_status には、最後に適用した CTM デルタのシーケンス番号が含まれます。 このファイルを変更したり削除したりすると、 .Nm は、とても混乱します。 .Pp .Fl e と .Fl x オプションを使うとソースツリーの一部分を更新することができ、 ソースを一貫性のない状態にすることになります。 これらのオプションを使うときには、何をしているのかを理解していることが 仮定されています。 .Sh 使用例 .Bd -literal cd ~cvs /usr/sbin/ctm ~ctm/cvs-* .Ed .Pp `lib' 以下のすべてのソースを取り出してパッチを当てるには 以下のようにします。 .Bd -literal cd ~/lib-srcs /usr/sbin/ctm -e '^lib' ~ctm/src-cur* .Ed .Sh 診断 充分に説明的であるはずの沢山のメッセージが出力されます。 .Dq ノイズレベル は .Fl q , .Fl v , .Fl V オプションで調整できます。 .Sh 関連項目 .Xr ctm_rmail 1 , .Xr ctm 5 .Sh 歴史 最初の試みは .Fx 1.1.5 の作業中に行われました。そして、たくさんの バグと手法について徹底的に議論されました。 .Pp .Nm コマンドは .Fx 2.1 から登場しました。 .Sh 作者 CTM システムは .An Poul-Henning Kamp Aq phk@FreeBSD.org によってデザインされ実装されました。 .Pp このマニュアルページは .An Joerg Wunsch Aq joerg@FreeBSD.org が書きました。 .Sh 日本語訳 野首 寛高(h-nokubi@nmit.mt.nec.co.jp): FreeBSD 用に翻訳 diff --git a/ja_JP.eucJP/man/man1/ctm_rmail.1 b/ja_JP.eucJP/man/man1/ctm_rmail.1 index 641462f037..9d5d3d5209 100644 --- a/ja_JP.eucJP/man/man1/ctm_rmail.1 +++ b/ja_JP.eucJP/man/man1/ctm_rmail.1 @@ -1,499 +1,500 @@ .\" NOTICE: This is free documentation. I hope you get some use from these .\" words. In return you should think about all the nice people who sweat .\" blood to document their free software. Maybe you should write some .\" documentation and give it away. Maybe with a free program attached! .\" .\" Author: Stephen McKay .\" -.\" %FreeBSD: src/usr.sbin/ctm/ctm_rmail/ctm_rmail.1,v 1.19.2.5 2001/08/16 15:55:54 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ctm_rmail.1,v 1.14 2001/07/29 05:14:50 horikawa Exp $ +.\" %FreeBSD: src/usr.sbin/ctm/ctm_rmail/ctm_rmail.1,v 1.19.2.6 2002/06/21 16:40:21 charnier Exp % +.\" $FreeBSD$ .\" .Dd January 24, 1995 .Dt CTM_MAIL 1 .Os .Sh 名称 .Nm ctm_smail , .Nm ctm_dequeue , .Nm ctm_rmail .Nd メールを介しての .Nm ctm デルタの送受信 .Sh 書式 .Nm ctm_smail .Op Fl l Ar log .Op Fl m Ar maxmsgsize .Op Fl c Ar maxctmsize .Op Fl q Ar queue-dir .Ar ctm-delta .Ar mail-alias .Nm ctm_dequeue .Op Fl l Ar log .Op Fl n Ar numchunks .Ar queue-dir .Nm ctm_rmail .Op Fl Dfuv .Op Fl l Ar log .Op Fl p Ar piecedir .Op Fl d Ar deltadir .Op Fl b Ar basedir .Op Ar .Sh 解説 .Nm ctm_smail , .Nm ctm_dequeue , .Nm ctm_rmail は .Xr ctm 1 コマンドと組み合わせて、 ソースツリーへの変更を電子メールで配布するために使われます。 .Nm ctm_smail -には圧縮した -.Xr ctm +ユーティリティには圧縮した +.Xr ctm 1 のデルタとそれを送るメーリングリストを与えます。 するとデルタを送信できる大きさに切り分けて、メールメッセージとして エンコードしたものをメーリングリストに送ります (メールの負荷を分散させるためにキューに入れるように選択できます)。 各受信者は .Nm ctm_rmail を使い (手動または自動で) デルタのデコードと再組み立てを行い、 それをソースツリーに適用するために .Xr ctm を呼び出すようにも指定できます。 現在、 いくつかのソースツリーが、いくつかのサイトによって配布されています。 その中には .Li freefall.FreeBSD.org が配布している .Fx Ns -current のソースと CVS のツリーもあります。 .Pp .Nm ctm_smail のコマンドラインの引数には以下があります: .Bl -tag -width indent .It Fl l Ar log .Em stderr に出力する代わりに、 (コマンドラインのエラー以外の) エラー診断と情報メッセージ にタイムスタンプを付けた物がファイル .Em log に書き込まれます。 .It Fl m Ar maxmsgsize .Nm ctm_smail が送信できるメールメッセージの最大サイズを制限します。 メールヘッダとその他の細かい物をこの制限に入れていないため およその値となります。 指定されないとデフォルトは、メールの限界と噂される 64k に対して ヘッダのための 1535 バイトを残した 64000 バイトです。 .It Fl c Ar maxctmsize 送信されるデルタの最大サイズを制限します。この制限より大きいデルタは 謝罪メールをメーリングリストに送り出します。 これは大幅な変更でユーザのメールボックスを圧迫してしまうのを 避けるためです。これはエンコードする前のサイズなので注意して下さい。 エンコードされるとメールヘッダを付ける前でサイズは 4/3 倍になります。 指定されないと無制限になります。 .It Fl q Ar queue-dir デルタのかけらをメールする代わりに、後で .Nm ctm_dequeue を使ってメールされるように指定されたディレクトリに格納します。 この機能によって、巨大なデルタを数時間または数日にも渡って分散させ、 ネットワークのバンド幅が狭かったりメールのスプール領域が小さい 受信者へのインパクトを押えることが可能です。 .El .Pp .Ar ctm-delta は送信されるデルタで、 .Ar mail-alias はデルタを送信するメーリングリストです。 メールメッセージは .Xr sendmail 8 を使って送信されます。 .Pp .Nm ctm_dequeue のコマンドラインの引数には以下があります: .Bl -tag -width indent .It Fl l Ar log .Em stderr に出力する代わりに、 (コマンドラインのエラー以外の) エラー診断と情報メッセージ にタイムスタンプを付けた物がファイル .Em log に書き込まれます。 .It Fl n Ar numchunks 1 回の .Nm ctm_dequeue の実行で送信するメールメッセージの数を制限します。 デフォルトでは、 .Nm ctm_dequeue は 1 回の実行で 1 つのメールメッセージを送信します。 .El .Pp .Ar queuedir は .Nm ctm_smail が格納したメールメッセージのあるディレクトリです。 .Ar numchunks 個までのメールメッセージが実行ごとに送信されます。 受信者のメーリングリストは、溜められたファイルに すでにエンコードされています。 .Pp .Nm ctm_smail がキューにエントリを追加している最中や、複数の .Nm ctm_smail を並行に実行している最中でも .Nm ctm_dequeue を安全に実行できますが、配布される各ツリーごとに独立した キューのディレクトリを使うべきです。 これはエントリがアルファベット順に処理されるので、デルタの 作成時刻ではなく、デルタ名に従って 1 つのツリーが他の物より 前に処理されて不公平になるからです。 .Pp .Nm ctm_rmail のコマンドラインの引数には以下があります: .Bl -tag -width indent .It Fl l Ar log .Em stderr に出力する代わりに、 (コマンドラインのエラー以外の) エラー診断と情報メッセージ にタイムスタンプを付けた物がファイル .Em log に書き込まれます。 .It Fl p Ar piecedir デルタのかけらをこのディレクトリに集めます。 それぞれのかけらは 1 つのメールメッセージに対応します。 かけらは完全なデルタが出来上がると削除されます。 もし このフラグが指定されないと、入力ファイルは読まれませんが、 .Fl b フラグが指定されていれば完成しているデルタは .Xr ctm を使って適用されるかもしれません。 .It Fl d Ar deltadir このディレクトリ内の完成したデルタを集めます。デルタは、すべてのかけらが 揃っている時に 1 つ以上のかけらから組み立てられます。 .It Fl b Ar basedir 完成しているデルタを このソースツリーに適用します。このフラグが 指定されていない場合、デルタは格納されますが適用はされません。 ユーザは手動、または .Nm ctm_rmail を .Fl p フラグ無しで使ってデルタを適用できます。 もしデルタが .Ar basedir の .Li .ctm_status ファイルとマッチしない場合 (もしくは .Li .ctm_status が存在しない場合) には、デルタは適用されません。 .It Fl D .Xr ctm による適用が成功した後でデルタを削除します。 .Xr ctm はデルタのフルセットからファイルの小グループを回復する機能を 持つので、このフラグを避けて (そしてすべてのデルタを取って) おくのが 良いでしょう。 .It Fl f fork して .Xr ctm でのデルタの適用をバックグラウンドで実行します。 これは .Xr sendmail から .Nm ctm_rmail を自動的に呼び出す場合に有効です。なぜなら .Xr ctm は終了までに、とても長い時間を要し、それによって他の人のメールを 遅らせる原因になり、理論的にはリモート側の .Xr sendmail のタイムアウトによるメールの不要な再送信や、 .Xr "MH" の .Xr slocal のようなメールフィルタによる .Nm ctm_rmail の強制終了を引き起こす可能性があるからです。 膨大な数のバックグラウンドの .Xr ctm プロセスでマシンに負荷がかかる心配はありません。同時に 2 つ以上の .Xr ctm が起動されないようにロックが行われているからです。 .It Fl u 完成したデルタを適用する時に .Fl u フラグを .Xr ctm コマンドに渡します。これによって作成、変更されたファイルの 変更時刻が CTM デルタの作成時刻にセットされます。 .It Fl v 完成したデルタを適用する時に .Fl v フラグを .Xr ctm コマンドに渡します。これによってより多くの情報出力が得られます。 すべての .Xr ctm からの出力は .Nm ctm_rmail のログファイルに記録されます。 .El .Pp 引数のファイル (もし無ければ .Em 標準入力 ) がデルタのかけらとしてスキャンされます。 1 つのファイルから複数のデルタのかけらを読む事ができるので、 メールドロップ全体を 1 回のコマンドでスキャンして処理できます。 .Pp .Nm ctm_rmail を並行に (異なる入力ファイルで) 複数回起動しても安全です。 .Xr sendmail がメールを非同期に配送した時にこのようなことが起こり得ます。 これは処理を順序通りに保つためにロックが行われているからです。 .Sh ファイルフォーマット 以下は実際の (とても小さい) デルタのかけらの重要部分です: .Bd -literal From: owner-src-cur To: src-cur Subject: ctm-mail src-cur.0003.gz 1/4 CTM_MAIL BEGIN src-cur.0003.gz 1 4 H4sIAAAAAAACA3VU72/bNhD9bP0VByQoEiyRSZEUSQP9kKTeYCR2gDTdsGFAwB/HRogtG5K8NCj6 v4+UZSdtUQh6Rz0eee/xaF/dzx8up3/MFlDkBNrGnbttAwyo1pxoRgoiBNX/QJ5d3c9/X8DcPGGo lggkPiXngE4W1gUjKPJCYyk5MZRbIqmNW/ASglIFcdwIzTUxaAqhnCPcBqloKEkJVNDMF0Azk+Bo dDzzk0Ods/+A5gXv9YyJHjMCtJwQNeESNma7hOmXDRxn CTM_MAIL END 61065 .Ed .Pp メッセージのサブジェクトは常に .Dq ctm-mail で始まりデルタの名前、いくつ目のかけらか、そして全部でいくつの かけらがあるのかが続きます。データは .Dq CTM_MAIL BEGIN と .Dq CTM_MAIL END という行で囲まれており、サブジェクト行の情報の複製、加えて単純な チェックサムが付きます。 .Pp デルタが .Ar maxctmsize を超えると、代わりに以下のようなメッセージが送られます: .Bd -literal From: owner-src-cur To: src-cur Subject: ctm-notice src-cur.0999.gz src-cur.0999.gz is 792843 bytes. The limit is 300000 bytes. このデルタは ftpmail か、または大学の仲良しから得られます。 .Ed .Pp これでもうあなたのものです! .Sh 使用例 .Em src-cur の 32 番目のデルタを .Em src-guys として .Xr sendmail に登録されている素晴らしいコードハッカーのグループに、 メールのサイズをおよそ 60000 バイトに制限して送るためには 以下のように出来ます: .Bd -literal -offset indent ctm_smail -m 60000 /wherever/it/is/src-cur.0032.gz src-guys .Ed .Pp メールボックスの各 .Nm ctm-mail メッセージをデコードして、それらを完全なデルタに組み立て、そして 出来上がったデルタやそこらに転がっているデルタはどれも、 以下のように適用出来ます: .Bd -literal -offset indent ctm_rmail -p ~/pieces -d ~/deltas -b /usr/ctm-src-cur $MAIL .Ed .Pp ( .Nm ctm_rmail はメッセージを削除しないので注意して下さい。 削除には どんなメールリーダでも使用できます。) .Pp .Em receiver-dude という名前の自動的にデコードとデルタの組み立てを行うけれども、 それらの適用は行わないようなメールエイリアスは、以下の行を .Pa /etc/mail/aliases ファイルに入れる事で作成可能です ( .Pa /ctm/tmp と .Pa /ctm/deltas ディレクトリ そして .Pa /ctm/log ファイルが .Em daemon ユーザか .Em wheel グループで書き込み可能な事を仮定しています) : .Bd -literal -offset indent receiver-dude: "|ctm_rmail -p /ctm/tmp -d /ctm/deltas -l /ctm/log" owner-receiver-dude: real_dude@wherever.you.like .Ed .Pp 2 行目は、失敗した場合にそれを通常のメールボックスか、または どこか好きな所へ転送するためにあります。 .Pp 集められた全デルタを適用して、適用したものを削除するには以下のように します: .Bd -literal -offset indent ctm_rmail -D -d /ctm/deltas -b /ctm/src-cur -l /ctm/apply.log .Ed .Pp 柔軟性を最大限生かすためには、この .Xr procmail スクリプトからの引用の利用を考えてみて下さい: .Bd -literal -offset indent PATH=$HOME/bin:$PATH :0 w * ^Subject: ctm-mail cvs-cur | ctm_incoming .Ed .Pp 以下のシェルスクリプト .Pa ~/bin/ctm_incoming と一緒に使います: .Bd -literal -offset indent #! /bin/sh PATH="$HOME/bin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin" export PATH cd $HOME/ctm && ctm_rmail -f -p pieces -d deltas -l log -b /ctm .Ed .Pp これは全部の .Xr ctm デルタを .Pa ~/ctm/deltas に置き、それらを .Pa /ctm 内のツリーに適用し、失敗したものは、すべてあなたの通常の メールボックスに落します。 .Pa ctm_incoming での .Ev PATH の操作は、このサンプルを取って来た ( .Fx でない) マシンで .Nm ctm_rmail から .Xr ctm の実行を可能にするためのものです。 .Sh セキュリティ CTM 自身、 安全ではないプロトコルです - ソースコードへ加えられた修正が信頼できるところから送られたことを 認証しませんので、 通常の電子メール等の信頼できない媒体から CTM デルタを得た場合には注意が必要です。 CTM デルタを偽造して、正当なものを交換または上書きし、 悪意あるコードをあなたのソースツリーに挿入することは、 攻撃者にとって比較的簡単です。 正当なデルタの到着がなんらかの方法で妨げられた場合、 これを感知できるのは、後のデルタが同じファイルを触ろうとする時点です。 この時点で、MD チェックサムが失敗します。 .Pp これを回避して安全なものにするために、 FreeBSD.org が作った CTM 部品には、 GNU Privacy Guard ユーティリティ互換なフォーマットで暗号的に署名しています。 このユーティリティは /usr/ports/security/gpg および Pretty Good Privacy v5 ユーティリティ /usr/ports/security/pgp5 から入手できます。 適切な公開鍵は ctm@FreeBSD.org を finger することで得られます。 .Pp このように署名された CTM デルタは、 検知されることなく攻撃者が改変することはできません。 それゆえ、CTM デルタを電子メールで受信する場合には、 GPG または PGP5 を使用して署名を確認することを勧めます。 .\" This next request is for sections 1, 6, 7 & 8 only .Sh 環境変数 デルタを適用するのならば .Xr ctm 1 と .Xr gunzip 1 が .Ev PATH に含まれていなければなりません。 .Sh 関連ファイル .Bl -tag -width indent .It Pa QUEUEDIR/* メールメッセージとしてエンコードされて、メーリングリストに 送信されるのを待っているデルタのかけら。 .It Pa PIECEDIR/* 残りのかけらの到着を待っているデルタのかけら。 .It Pa DELTADIR/* 完成したデルタ。 .It Pa BASEDIR/.ctm_status このソースツリーに次に適用されるべきデルタの名前と番号を含むファイル。 .El .Sh 診断 .Nm ctm_smail , .Nm ctm_dequeue , .Nm ctm_rmail -は正常に終了するとステータスとして 0 を、何らかの障害が +ユーティリティは正常に終了するとステータスとして 0 を、何らかの障害が あった場合は 1 を返します。 .Nm ctm_rmail -は、メールの配送プログラムから呼ばれる事を想定しています。そして +ユーティリティは、メールの配送プログラムから呼ばれる事を想定しています。 +そして そのため入力されたメールメッセージが (送信者にではなく、 なるべく あなたの通常のメールドロップに) 返送されるべき状態に なった時にのみ障害を通知するようになっています。 いいかえれば、完成したデルタを .Xr ctm で適用する際に発生した障害はメールを返送する程に重要なエラーでは ないと判断されて、 .Nm ctm_rmail は終了ステータスとして 0 を返すということです。 .Pp 通常の操作では、 .Nm ctm_smail は以下のようなメッセージで報告します: .Bd -literal -offset indent ctm_smail: src-cur.0250.gz 1/2 sent to src-guys .Ed .Pp または、キューに入れたなら、 .Bd -literal -offset indent ctm_smail: src-cur.0250.gz 1/2 queued for src-guys .Ed .Pp .Nm ctm_dequeue -は以下のようなメッセージで報告します: +ユーティリティは以下のようなメッセージで報告します: .Bd -literal -offset indent ctm_dequeue: src-cur.0250.gz 1/2 sent .Ed .Pp .Nm ctm_rmail -は以下のようなメッセージで報告します: +ユーティリティは以下のようなメッセージで報告します: .Bd -literal -offset indent ctm_rmail: src-cur.0250.gz 1/2 stored ctm_rmail: src-cur.0250.gz 2/2 stored ctm_rmail: src-cur.0250.gz complete .Ed .Pp もし入力ファイルのいずれもが正しいデルタのかけらを含んでいないと、 .Nm ctm_rmail は以下のように報告します: .Bd -literal -offset indent ctm_rmail: message contains no delta .Ed .Pp そして終了ステータスとして 1 を返します。もしメールフィルタが 当てにならないのなら、これを使って気まぐれなメッセージを リダイレクトして本当のメールボックスに入れる事ができます。 .Pp これらのメッセージは .Em stderr かログファイルに出力されます。 -.Xr ctm +.Xr ctm 1 からのメッセージも同様にここに現れます。 エラーメッセージは それ自身が説明的であるべきです。 .Sh 関連項目 .Xr ctm 1 , .Xr ctm 5 .\" .Sh HISTORY .Sh 作者 Stephen McKay .Sh 日本語訳 野首 寛高 (h-nokubi@nmit.mt.nec.co.jp): FreeBSD 用に翻訳 diff --git a/ja_JP.eucJP/man/man1/doscmd.1 b/ja_JP.eucJP/man/man1/doscmd.1 index e61ee0cdf1..c04a159585 100644 --- a/ja_JP.eucJP/man/man1/doscmd.1 +++ b/ja_JP.eucJP/man/man1/doscmd.1 @@ -1,761 +1,761 @@ .\" .\" Copyright (c) 1992, 1993, 1996 .\" Berkeley Software Design, Inc. 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 Berkeley Software .\" Design, Inc. .\" .\" THIS SOFTWARE IS PROVIDED BY Berkeley Software Design, Inc. ``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 Berkeley Software Design, Inc. 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. .\" .\" BSDI doscmd.1,v 2.3 1996/04/08 19:32:29 bostic Exp -.\" %FreeBSD: src/usr.bin/doscmd/doscmd.1,v 1.12.2.10 2002/04/25 11:04:51 tg Exp % +.\" %FreeBSD: src/usr.bin/doscmd/doscmd.1,v 1.12.2.11 2002/06/20 23:45:41 charnier Exp % .\" .\" $FreeBSD$ .\" WORD: raw file ロウファイル (mknod.8 によると character special file) .\" WORD: cooked device 加工されたデバイス (mknod.8 によると block special) .Dd January 30, 1995 .Dt DOSCMD 1 .Os .Sh 名称 .Nm doscmd .Nd リアルモード DOS プログラムのサブセットを実行する .Sh 書式 .Nm doscmd .Fl 23AbDEfGHIMOPRrtVvXxYz .Fl c Ar file .Fl d Ar file .Fl i Ar port Ns Xo .Op : Ns Ar cnt .Xc .Fl o Ar port Ns Xo .Op : Ns Ar cnt .Xc .Fl S Ar int .Fl U Ar int .Op Ar cmd Op Ar args ... .Sh 解説 .Nm -は、DOS のサブセットをエミュレートして単一コマンド +ユーティリティは、DOS のサブセットをエミュレートして単一コマンド .Ar cmd .Ar args を実行することができますし、 PC をエミュレートして DOS をブートすることもできます。 DOS をブートする場合には、より多様な DOS アプリケーションを 実行することができます。 MS-DOS 6.2 以降は .Nm ではうまく扱えないようです。 DOS をブートするには、 .Fl b フラグを指定するか、 .Ar cmd 引数を省略してください。 .Fl b を指定すると、 .Ar cmd と .Ar args は無視されます。 .Pp .Nm は DOS のサブセットを提供するだけですが、 多くのプログラムを実行するには十分です。 コンパイラ、アセンブラ、リンカローダといったプログラムも実行できますが、 これらに限定するものではありません。 .Pp 次に示す多様なフラグを .Nm に指定可能です: .Bl -tag -width indent .It Fl 2 DOS プログラムからの .Nm エミュレータへのすべてのトラップのデバッグトレースを有効にします。 カーネルによって扱われるためにトレースされないトラップがあることに 注意してください。 .It Fl 3 割り込みベクタの変更や論理ドライブへのパスの初期化といった、 いくつかの下位レベル機能のデバッグを有効にします。 .\" .\" .\" .It Fl A エミュレータを通過するすべての割り込みのトレースを有効にします。 .Fl S オプションを、255 個すべての割り込みの値とともに指定する場合と同じです。 .\" .\" .\" .It Fl b DOS をエミュレートする代りに DOS をブートします。 .\" .\" .\" .It Fl c Ar file 画面へのすべての出力を捕まえて、 .Ar file へ出力します。 画面の直接の書き込みは捕まえられないことに注意してください。 .\" .\" .\" .It Fl C MS-DOS の呼び出しエミュレーションと戻り値をリストします。 .\" .\" .\" .It Fl D ディスクとファイルの操作に関するデバッグを有効にします。 .\" .\" .\" .It Fl d Ar file デバッグ出力を、標準エラー出力の代りに .Ar file へ送ります。 .\" .\" .\" .It Fl E exec ルーチンのデバッグを有効にします。 .\" .\" .\" .It Fl G ビデオ (グラフィックス) ルーチンのデバッグを有効にします。 .\" .\" .\" .It Fl H 中途半端に実装された呼び出しのトレースを有効にします。 .\" .\" .\" .It Fl I すべての割り込みのトレースを有効にします。 .Fl A とほとんど同じですが、有効になるトレースは少しだけ少ないです。 .\" .\" .\" .It Fl i Ar port Ns Xo .Op : Ns Ar cnt .Xc 入出力ポート .Ar port からのすべての入力要求のトレースを有効にします。 もし .Ar cnt が与えられると、 .Ar port から .Ar port+cnt Ns No -1 までをトレースします。 .\" .\" .\" .It Fl M メモリ操作のデバッグを有効にします。 .\" .\" .\" .It Fl O デバッグ出力を、標準エラー出力の代りに、標準出力へ出力します。 .\" .\" .\" .It Fl o Ar port Ns Xo .Op : Ns Ar cnt .Xc 入出力ポート .Ar port からのすべての出力要求のトレースを有効にします。 もし .Ar cnt が与えられると、 .Ar port から .Ar port+cnt Ns No -1 までをトレースします。 .\" .\" .\" .It Fl p Ar port Ns Xo .Op : Ns Ar cnt .Xc 要求された I/O .Ar port (オプションとして .Ar port+cnt Ns No -1 までの範囲を指定可能です) を実機ハードウェア I/O ポートへマップします。 アクセスには root 権限が必要でしょう。 .\" .\" .\" .It Fl P 入出力ポート呼び出し (例えば .Li inb , .Li outb など) のトレースを有効にします。 .\" .\" .\" .It Fl R ファイルリダイレクトコードのデバッグを有効にします。 .\" .\" .\" .It Fl r 生のキーボード入力と表示を使用します。 を押すと、 doscmd は終了します。VGA グラフィックスが使えるようになります。 .\" .\" .\" .It Fl S Ar int 割り込み .Ar int のトレースを有効にします。 .\" .\" .\" .It Fl t 命令レベルのトレースを試みます。 トレースを混乱させる命令があります。 .Li を押すとトレースモードの有効と無効とを切り替えます。 .\" .\" .\" .It Fl U Ar int 割り込み .Ar int のトレースを無効にします。 .Fl A や .Fl I の後で使用すると便利です。 .\" .\" .\" .It Fl V 未知の割り込みを報告する際、レジスタダンプも含めます。 .\" .\" .\" .It Fl v .Fl AH と同じです。 .\" .\" .\" .It Fl X XMS 操作のデバッグを有効にします。 .\" .\" .\" .It Fl x X11 のウィンドウを表示出力のためにオープンします。 他の方法では利用できない様々な割り込みを有効にします。 .Fl b を指定しても、指定しなくても、使用可能です。 .\" .\" .\" .It Fl Y EMS 操作のデバッグを有効にします。 .\" .\" .\" .It Fl z DOS プログラムにジャンプする直前に .Nm を停止させます。 .Nm を開発する以外の用途はほとんどありません。 .El .Pp 起動時に、 .Nm はコンフィギュレーションファイルを読もうとします。 まず、カレントディレクトリのファイル .Cm .doscmdrc を試します。もし見付からない場合、 .Cm $HOME を検索します。それでもなお見付からない場合、ファイル .Cm /etc/doscmdrc を使用します。 .Pp コンフィギュレーションファイルでは、コメントは \fB#\fP 文字から開始します。 また、空行は無視されます。 非空行は、環境変数またはデバイスを設定するコマンドです。 空白の前に \fB=\fP がある行は、環境変数への代入であると扱われ、 DOS の環境に追加されます。 その他の行は次のいずれかです。 .Bl -tag -width XXXXX .\" .\" .\" .It Cm boot Op Cm A: | C: ブートするデバイスを設定します。 デフォルトでは、 .Cm A: が定義されていれば最初に試され、もしそれが失敗すると、 .Cm C: が試されます。 .\" .\" .\" .It Cm assign Xo .Op Cm A-Z : .Op Fl ro .Ar path .Xc .Bsx のディレクトリ .Ar path を、指定したドライブに割り当てます。 .Fl ro フラグを指定すると、読み取り専用ファイルシステムになります。 DOS ブート時には、 .Pa /usr/libdata/doscmd/redir.com バイナリが実行されるまでは、これらの割り当ては実行されません。 .\" .\" .\" .It Cm assign Xo .Cm lpt Ns Op Cm 0-4 : .Op Cm direct .Ar path .Op Ar timeout .Xc 指定したプリンタを .Ar path に割り当てようとします。 .Ar timeout が指定された場合、 その期間 (秒数) 活動がない場合に、プリンタをフラッシュすべきことを示します。 デフォルトは 30 秒です。 .Ar path が本物のプリンタを参照している場合には、 .Cm direct オプションを指定してください。 .\" .\" .\" .It Cm assign Xo .Op Cm A: | B: .Op Fl ro .Ar path .Ar density .Xc .It Cm assign Xo .Cm flop Ns Op Cm 01 .Op Fl ro .Ar path .Ar density .Xc ファイル .Ar path を、次に利用可能なフロッピまたは指定したフロッピに割り当てます。 .Fl ro が指定されると、フロッピは読み取り専用になります。 .Ar density は次のいずれかです: .sp .Bl -tag -compact -width 1440x .It 180 9 ヘッド 40 トラック片面フロッピ .It 360 9 ヘッド 40 トラック両面フロッピ .It 720 9 ヘッド 80 トラック両面フロッピ .It 1200 15 ヘッド 80 トラック両面フロッピ .It 1440 18 ヘッド 80 トラック両面フロッピ .It 2880 36 ヘッド 80 トラック両面フロッピ .El .\" .\" .\" .It Cm assign Xo .Op Cm C-Z : .Op Fl ro .Ar path .Op Ar type | cyl head sec .Op Ar fdisk_tab .Xc .It Cm assign Xo .Cm hard Ns Op Cm 01 .Op Fl ro .Ar path .Op Ar type | cyl head sec .Op Ar fdisk_tab .Xc ファイル .Ar path を、次に利用可能なハードディスクまたは指定したハードディスクに割り当てます。 ディスクのジオメトリは、シリンダ数 .Ar cyl とヘッド数 .Ar head とトラックあたりのセクタ数 .Ar sec で直接指定することもできますし、標準タイプから 1 つを .Ar type (後述) で指定することもできます。 オプションの .Ar fdisk_tab 引数は、このディスクの最初のセクタとして使用するファイルを指定します。 .Ar path がディスクの一部のみを参照する場合に、 偽の fdisk テーブルを挿入するために使用できます。 .\" .\" .\" .It Cm assign Xo .Cm com Ns Op Cm 1-4 : .Ar path .Ar port .Ar irq .Xc .Ar path で指定した tty または pty を、 指定した com ポートとして使用するように割り当てます。 ベースアドレスは .Ar port でエミュレートされ、割り込みは .Ar irq で指定されます。 このコードは軽くテストしただけなので、向かない用途があるかもしれません。 .\" .\" .\" .It Cm "setver command version" doscmd が DOS をエミュレートする場合、 .Cm command という名前のプログラムから呼ばれた時に、DOS バージョンとして .Cm version を報告するようにします。 .Cm version のフォーマットは、後述の .Cm MS_VERSION 変数と同じです。 .El .Pp .Cm C: は、まだ割り当てられていない場合には、ルートディレクトリ (/) に割り当てられ、 .Cm C: のカレントディレクトリは、現在のカレントディレクトリに設定されます。 これはすなわち、 .Pp .Dl "doscmd ../foo .Pp のように起動しても、動作しないことを意味することに注意してください。 なぜなら .Cm C: ディレクトリはカレントパスで開始するからです。 また、次の環境変数も、未設定の場合には設定されます: .Bd -literal .Cm "COMSPEC=C:\eCOMMAND.COM .Cm "PATH=C:\e .Cm "PROMPT=DOS> .Ed .Pp .Cm PATH 変数は .Ar cmd を検索する際にも使用されます。 DOS のように、まず .Ar cmd.com が検索され、それから .Ar cmd.exe が検索されます。 .Sh コンフィギュレーション変数 doscmd の内部変数であり、実際の DOS の環境では設定されない変数が、 .Cm .doscmdrc ファイル中にいくつかあります。 それらを以下に示します: .Bl -tag -width MS_VERSION .It Cm MS_VERSION この変数の値は、 .Nm が報告を行なう DOS のバージョンを決定するために使用されます。 .Nm は、動作を変えずに、報告方法だけを変えることに注意してください。 デフォルトでは、この値は .Cm 410 であり、 .Tn "MS-DOS バージョン 4.1 に対応します。 バージョン 3.2 (以前の .Nm のデフォルトでした) に変更するには、値 .Cm 320 を使用してください。 .It Cm X11_FONT この変数の値は X window で使用するフォントを決定します。 デフォルトのフォントは .Cm vga であり .Pa /usr/libdata/doscmd/fonts にインストールされています。 X サーバがフォントを見付けられるように .Ql xset fp+ /usr/libdata/doscmd/fonts を .Pa ${HOME}/.xsession か .Pa ${HOME}/.xinitrc に追加してください。 .El .Sh ファイル変換 .Nm -は +ユーティリティは .Bsx のファイル名を .Tn DOS のファイル名に変換する際、すべて大文字に変換し、無効な文字を除去します。 ASCII ファイルを、DOS の世界で好まれる .Cm 形式へ変換するということはありません。 ASCII ファイルを変換するには、プログラム .Xr fconv 1 (ports コレクションの一部です) か、これに類するツール を使用してください。 .bp .Sh ディスクタイプ .TS H expand, box; r | r | r | r | r. タイプ シリンダ ヘッド セクタ サイズ = 01 306 4 17 10MB 02 615 4 17 20MB 03 615 6 17 30MB 04 940 8 17 62MB 05 940 6 17 46MB _ 06 615 4 17 20MB 07 462 8 17 30MB 08 733 5 17 30MB 09 900 15 17 112MB 10 820 3 17 20MB _ 11 855 5 17 35MB 12 855 7 17 49MB 13 306 8 17 20MB 14 733 7 17 42MB 15 976 15 17 121MB _ 16 612 4 17 20MB 17 977 5 17 40MB 18 977 7 17 56MB 19 1024 7 17 59MB 20 733 5 17 30MB _ 21 733 7 17 42MB 22 733 5 17 30MB 23 306 4 17 10MB 24 925 7 17 53MB 25 925 9 17 69MB _ 26 754 7 17 43MB 27 754 11 17 68MB 28 699 7 17 40MB 29 823 10 17 68MB 30 918 7 17 53MB _ 31 1024 11 17 93MB 32 1024 15 17 127MB 33 1024 5 17 42MB 34 612 2 17 10MB 35 1024 9 17 76MB _ 36 1024 8 17 68MB 37 615 8 17 40MB 38 987 3 17 24MB 39 987 7 17 57MB 40 820 6 17 40MB _ 41 977 5 17 40MB 42 981 5 17 40MB 43 830 7 17 48MB 44 830 10 17 68MB 45 917 15 17 114MB _ 46 1224 15 17 152MB .TE .bp .Sh 擬似ディスクへの DOS のインストール doscmd の擬似ハードディスクに DOS をインストールするには、 次のようにします: .Bl -tag -width XXXX .It 1 少なくとも次の記述を含む .Pa .doscmdrc を作成します: .Bd -literal -offset indent assign A: /dev/fd0.1440 1440 assign A: /dev/fd0.720 720 assign hard boot_drive 80 2 2 .Ed .Pp A: ドライブに対応するロウファイル (訳注: キャラクタスペシャルファイル) を、 システムに応じて修正する必要があるかもしれません。 この例では、HD ドライブを最初に試し、DD ドライブを次に試します (訳注: HD = High Density; 高密度、DD = Double Density; 倍密度)。 .\" HD = Hard Disk と思ってしまうと混乱するので、訳注を追加したい。 .\" HD = High Density, DD = Double Density .\" 1998/09/20 by horikawa@jp.FreeBSD.org .Pp ここでは、 ロウデバイスやロウファイルのみを使用する必要があることに注意してください。 加工された (cooked) デバイス (訳注: ブロックスペシャルファイル) を使用しないこと! (おそらくハードディスクは大丈夫でしょうが、フロッピは確実に駄目です) .Pp .Li boot_drive は、ブート可能なイメージを格納するファイルの名前です。 .Li 80 2 2 という 3 つの数字は、 ドライブが 80 個のシリンダと 2 個のヘッドとトラックあたり 2 個のセクタを 持つことを示します。 これは、MS-DOS 5.0 を .Pa config.sys と .Pa autoexec.bat のファイルと共にインストールすることが可能な、最小のドライブです。 .Pp もっと大きなブートドライブを作成したいかもしれません。 .Pp ファイル .Pa boot_drive は存在する必要がありますので、touch コマンドで作成してください。 .It 2 MS-DOS をブート可能で fdisk, format, sys コマンドを含むフロッピディスクを、 A: ドライブに挿入してください。 ファイル redir.com もフロッピにコピーしてください。 この際、msdos ファイルシステム型でフロッピをマウントするか、mtools を使用してください (例えば .Dq Li mwrite redir.com a: とします)。 .It 3 doscmd を実行してください。 .It 4 > プロンプトにて、 .Li fdisk とタイプします。 .It 5 .Li Create DOS partition or Logical Drive を選択します。 .It 6 .Li Create Primary DOS Partition を選択します。 .It 7 大きさを指定します (典型的にはドライブ全体です。それでも非常に小さいものです。) .It 8 .Li を何度か押して、FDISK を終了します。 .It 9 doscmd が実行中断するでしょうから、 そうなった場合、doscmd を再度実行します。 .It 10 > プロンプトにて、 .Li format c: とタイプし、指示に従います。 .It 11 > プロンプトにて、 .Li sys c: とタイプします。 .It 12 doscmd を終了します。 .It 13 ドライブからフロッピを取り除くか、 .Bd -literal -offset indent boot C: .Ed という行をあなたの .Pa .doscmdrc に加えてください。 .It 14 新しいディスクから DOS を動かします。 config.sys と autoexec.bat の両ファイルが欲しいでしょうから、 まず最初は次のようにします: .Bd -literal -offset indent > copy con: config.sys LASTDRIVE=Z ^Z > copy con: autoexec.bat @echo off redir.com ^Z .Ed .It 15 doscmd を終了します。 .It 16 .Fx ディスクを組み込む魔法のプログラム .Li redir を自動的に呼び出す、ブート可能な擬似ディスクが完成しました。 FreeBSD ディスクを使用するためには、次の行をあなたの .doscmdrc に追加します: .Bd -literal -offset indent assign D: /usr/dos assign P: -ro /usr/prb .Ed 名前の問題により、 アクセスできないファイルがあるかもしれないことに注意してください。 .El .Sh 診断 実装されていない割り込みに出会うと、 .Nm は次のようなメッセージを表示し終了します: .Pp .Dl Unknown interrupt 21 function 99 .Pp .Pp .Nm .Fl x スイッチ指定時に、 .Ic X11 support not compiled in というメッセージが表示された場合、環境変数 .Ev X11BASE を X Window System をインストールした場所 (通常 .Pa /usr/X11R6 ) に設定し、ソースディレクトリ (通常 .Pa /usr/src/usr.bin/doscmd ) で .Ic make install とタイプすることで、本機能を有効にすることができます。 このように動作するためには、 X プログラマキットがインストールしてある必要があります。 .Sh 作者 .An Pace Willisson , .An Paul Borman .Sh 歴史 .Nm は .Tn BSD/386 に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man1/dtmfdecode.1 b/ja_JP.eucJP/man/man1/dtmfdecode.1 index 286c0a7585..f1bb9fb8e1 100644 --- a/ja_JP.eucJP/man/man1/dtmfdecode.1 +++ b/ja_JP.eucJP/man/man1/dtmfdecode.1 @@ -1,68 +1,69 @@ .\" .\" Copyright (c) 1999 Hellmuth Michaelis. 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: dtmfdecode.1,v 1.7 2002-01-18 02:48:51 horikawa Exp $ +.\" $Id: dtmfdecode.1,v 1.8 2002-07-21 05:44:22 horikawa Exp $ .\" -.\" %FreeBSD: src/usr.sbin/i4b/dtmfdecode/dtmfdecode.1,v 1.5.2.4 2001/08/01 17:45:02 obrien Exp % +.\" %FreeBSD: src/usr.sbin/i4b/dtmfdecode/dtmfdecode.1,v 1.5.2.5 2002/06/21 16:40:31 charnier Exp % .\" .\" last edit-date: [Mon Dec 13 22:53:13 1999] .\" .\" .\" $FreeBSD$ .Dd February 15, 1999 .Dt DTMFDECODE 1 .Os .Sh 名称 .Nm dtmfdecode .Nd A-law オーディオデータから DTMF トーンへのデコード .Sh 書式 .Nm .Sh 解説 .Nm -は isdn4bsd パッケージの一部分です。オーディオストリーム中の DTMF +ユーティリティは isdn4bsd パッケージの一部分です。 +オーディオストリーム中の DTMF トーンを見つけるために使われます。 .Pp このコマンドは、標準入力から G.711 A-Law 形式のデータによる音声を 読み込み、標準出力に ASCII 文字として、見つけた番号を出力します。 .Pp 検波器は integer double-cross recursive algorithm による 8 つの狭帯域 バンドパスフィルタによって実装されています。検波した信号にヒステリシスと アンチバウンスを与えるために、様々なアドホックな方法が試みられています。 .Sh 使用例 次のコマンド .Bd -literal -offset indent dtmfdecode < beep.al .Ed .Pp は標準出力に "1" を表示します。 .Sh 規格 ITU Recommendations G.711 .Sh 作者 .Nm は .An Poul-Henning Kamp Aq phk@FreeBSD.org が作成しました。 このマニュアルページは .An Hellmuth Michaelis Aq hm@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man1/du.1 b/ja_JP.eucJP/man/man1/du.1 index 7ccf67c9b5..e2cce5f708 100644 --- a/ja_JP.eucJP/man/man1/du.1 +++ b/ja_JP.eucJP/man/man1/du.1 @@ -1,150 +1,150 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)du.1 8.2 (Berkeley) 4/1/94 -.\" %FreeBSD: src/usr.bin/du/du.1,v 1.15.2.7 2001/08/16 13:16:47 ru Exp % +.\" %FreeBSD: src/usr.bin/du/du.1,v 1.15.2.8 2002/06/20 23:45:43 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/du.1,v 1.13 2001/07/29 05:14:50 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd April 1, 1994 .Dt DU 1 .Os .Sh 名称 .Nm du .Nd ディスク使用統計の表示 .Sh 書式 .Nm du .Op Fl H | L | P .Op Fl I Ar mask .Op Fl a | s | d Ar depth .Op Fl c .Op Fl h | k .Op Fl x .Op Ar .Sh 解説 .Nm ユーティリティは、引数に指定された各ファイル、および 引数に指定された各ディレクトリを根とするファイル階層内にある 各ディレクトリ内のディスク使用統計をブロック単位で表示します。 引数にファイルが指定されなかった場合には、カレントディレクトリを 根とするファイル階層内のブロック単位の使用統計を表示します。 .Fl k フラグを指定した場合、表示は 1024 バイトブロックにて行います。 指定しなかった場合は、 .Xr getbsize 3 が使用され、どのブロックサイズを使用するかを決定します。 端数となるブロック数は切り上げられます。 .Pp オプションは以下の通りです: .Bl -tag -width indent .It Fl H コマンドラインに指定されたシンボリックリンクをたどります。 階層内を調べている途中で見つかったシンボリックリンクはたどりません。 .It Fl L コマンドラインのシンボリックリンク および階層内を調べている途中で見つかったシンボリックリンクをたどります。 .It Fl I Ar mask 指定した .Ar mask に適合するファイルおよびディレクトリを無視します。 .It Fl P シンボリックリンクを全くたどりません。 これがデフォルトです。 .It Fl a ファイル階層内の各ファイルの情報も表示します。 .It Fl h 「人間が読める」出力。単位のサフィックス、 Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte を付けます。 .It Fl r 読めないディレクトリやオープンできないファイルといったメッセージを生成します。 これはデフォルトです。 このオプションは、単に .St -xpg4 準拠のためだけにあります。 .It Fl s 指定したファイルのエントリを表示します。( .Fl d Li 0 と等価です) .It Fl d Ar depth 深さ .Ar depth までの全てのファイルとディレクトリだけを表示します. .It Fl c 総計を表示します。 .It Fl k 1024 バイト (1 キロバイト) ブロックとして報告します。 .It Fl x ファイルシステムマウントポイントはたどりません。 .El .Pp .Nm -は、 +ユーティリティは、 .Fl H もしくは .Fl L オプションが指定されない限り、シンボリックリンクの大きさは リンクの参照先の大きさではなく、シンボリックリンク自身の 占める大きさとして数えます。 もし .Fl H もしくは .Fl L のどちらかのオプションが指定された場合には、 たどられた全てのシンボリック リンクの大きさは数えられず、また表示もされません。 .Pp 複数のハードリンクを持つファイルは、 .Nm の実行中、1 回しか数えられず、1 回しか表示されません。 .Sh 環境変数 .Bl -tag -width BLOCKSIZE .It Ev BLOCKSIZE .Ev BLOCKSIZE 環境変数が指定されていて .Fl k オプションが指定されていないと、ブロック数はそのブロックサイズ単位で 表示されます。 .Ev BLOCKSIZE 環境変数が指定されておらず .Fl k オプションが指定されていないと、ブロック数は 512 ブロックサイズ単位で 表示されます。 .El .Sh 関連項目 .Xr df 1 , .Xr fts 3 , .Xr symlink 7 , .Xr quot 8 .Sh 歴史 .Nm コマンドは、 .At v1 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/ee.1 b/ja_JP.eucJP/man/man1/ee.1 index 3931bb61c5..7a95e5304e 100644 --- a/ja_JP.eucJP/man/man1/ee.1 +++ b/ja_JP.eucJP/man/man1/ee.1 @@ -1,594 +1,593 @@ .\" -.\" %FreeBSD: src/usr.bin/ee/ee.1,v 1.8.2.5 2001/07/22 12:40:03 dd Exp % +.\" %FreeBSD: src/usr.bin/ee/ee.1,v 1.8.2.6 2002/06/20 23:45:45 charnier Exp % .\" .\" $FreeBSD$ .Dd August 30, 1995 .Dt EE 1 .Os .Sh 名称 .Nm ee .Nd 簡単エディタ .Sh 書式 .Nm ee .Op Fl eih .Op +# .Op Ar .Nm ree .Op Fl eih .Op +# .Op Ar .Sh 解説 -コマンド .Nm -はシンプルなスクリーンエディタで、端末の下部にプロンプトがあるか、 +ユーティリティはシンプルなスクリーンエディタで、 +端末の下部にプロンプトがあるか、 (端末中央の箱の中に) メニューがあるとき以外は、 常にテキスト挿入モードになっています。 -コマンド .Nm ree -は +ユーティリティは .Nm と同じものですが、指定されたファイルの編集しかできない (ファィル操作やシェル を使うことができない) ように機能が制限されています。 .Pp .Nm を正常に動作させるためには、使用する端末のタイプに合わせて、環境変数 .Ev TERM を正しく設定しなければなりません。例えば、 .Tn HP 700/92 端末の場合は、 .Ev TERM 変数を "70092" に設定する必要があります。 更に詳しい情報が必要な場合は、システム管理者にお尋ねください。 .Pp 下記のオプションが使用可能です: .Bl -tag -width indent .It Fl e タブからスペースへの展開を禁止します。 .It Fl i 端末上部に情報ウィンドウを表示しません。 .It Fl h ウィンドウとメニューの縁の強調表示を止めます (一部の端末で 表示速度が向上します)。 .It Sy +# スタート時のカーソルを行番号 '#' で指定される行に置きます。 .El .Ss "コントルールキー" テキストの挿入以外の操作では、コントロールキー ( .Li Control キーは "^" で表示され、例えば ^a のように、 アルファベットキーと組み合わせて使われます) や、 キーボード上にあるファンクションキー ( .Em "Next Page" , .Em "Prev Page" , 矢印キー等) を使わなければなりません。 .Pp すべての端末がファンクションキーを持っているわけではありませんから、 .Nm ではコントロールキーに割り当てられた基本的なカーソル移動は、 キーボードに装備された、より直感的なキーでも扱えるようにしてあります。例えば、 カーソルの上方移動は、上向き矢印キーと .Em ^u のいずれでも可能です。 .Bl -tag -width indent .It ^a 挿入文字を ASCII の 10 進数で指定。 .It ^b テキストの終わりに移動。 .It ^c コマンド入力。 .It ^d カーソルを下に移動。 .It ^e 検索文字列を入力。 .It ^f 最後に削除した文字の復元。 .It ^g 行の先頭に移動。 .It ^h バックスペース。 .It ^i タブ。 .It ^j 改行を挿入。 .It ^k カーソル上の文字を消去。 .It ^l カーソルを左に移動。 .It ^m 改行を挿入 .It ^n 次ページに移動。 .It ^o 行末に移動。 .It ^p 前ページに移動。 .It ^r カーソルを右に移動。 .It ^t テキスト先頭に移動。 .It ^u カーソルを上に移動。 .It ^v 最後に削除した単語を復元。 .It ^w カーソル位置以降の単語を削除。 .It ^x 文字列検索。 .It ^y カーソル位置から行末まで削除。 .It ^z 最後に削除した行の復元。 .It ^[ (ESC) メニュー表示。 .El .Ss "EMACS キーモード" 多くのシェルは (カーソル移動その他の編集操作で) Emacs モードを 用意していますから、それらのキー割当に慣れた利用者のために、 いくつかのキー割当が別途用意さています。これは .Em 設定 メニューないしは初期化ファイル (下記を参照) から利用することができ、 その内容は次のとおりです: .Bl -tag -width indent .It ^a 行の先頭に移動。 .It ^b 1 文字後退。 .It ^c コマンド入力。 .It ^d カーソル位置の文字を消去。 .It ^e 行末に移動。 .It ^f 1 文字前進。 .It ^g 1 ページ戻る。 .It ^h バックスペース。 .It ^i タブ。 .It ^j 最後に削除した文字の復元。 .It ^k 行の削除。 .It ^l 最後に削除した行の復元。 .It ^m 改行の挿入。 .It ^n 次行に移動。 .It ^o 挿入文字を ASCII の 10 進数で指定。 .It ^p 前行に戻る。 .It ^r 最後に削除した後の復元。 .It ^t テキストの先頭に移動。 .It ^u テキストの最後に移動。 .It ^v 次ページに移動。 .It ^w カーソル以降の単語を削除。 .It ^y 検索文字列の入力。 .It ^z 次の単語。 .It ^[ (ESC) メニュー表示。 .El .Ss "ファンクションキー" .Bl -tag -width indent .It Next Page 次ページに移動。 .It Prev Page 前ページに移動。 .It Delete Char カーソル位置の文字を消去。 .It Delete Line カーソル位置から行末まで消去。 .It Insert line カーソル位置に改行を挿入。 .It Arrow keys 表示された方向にカーソルを移動。 .El .Ss コマンド ある種の操作では単一のキー操作で得られる以上の情報を必要とします。 基本的な操作のほとんどには、 .Tn ESC キーで表示されるメニューが用意されていますが、 それらに加え、いくつかの操作は、コマンド入力 (^c) に続いて 下記のうち一つをタイプすることで実行できます。 .Bl -tag -width indent .It ! Ns Ar cmd シェルを使って .Ar cmd を実行。 .It 0-9 指定された行番号に移動。 .It case 文字列検察で大文字と小文字を区別。 .It character カーソル位置の文字の ASCII 値を表示。 .It exit 編集したテキストを保存して終了。 .It expand タブをスペースに展開。 .It file ファイル名を表示。 .It help ヘルプ画面を表示。 .It line 現在行の行番号を表示。 .It nocase 文字列検索で大文字と小文字を区別しない (デフォルト)。 .It noexpand TAB キーが押されたとき、タブをスペースに展開しない。 .It quit テキストに加えられた変更を保存せずに終了。 .It read Ar file 指定されたファイル .Ar file を読み込む。 .It write Ar file 指定されたファイル .Ar file にテキストを書き込む。 .El .Ss "メニュー操作" .Em escape キー (存在しない場合は .Em ^[ ) を押すとメニューがでてきます。 メニューの中で escape キーを押すと、何もしないでメニューから抜け出すことが できます。上向き矢印と下向き矢印ないしは、上なら .Em ^u 下なら .Em ^d で希望する項目に移動して、 .Em return キーを押せば、その処理が実行されます。 .Pp メニュー項目の左側の文字のキーを押すと、そのメニューエントリを 選択することになります。 .Pp .Nm のメインメニューは次のとおりです: .Bl -tag -width indent .It leave editor 終了。 変更されている場合は、変更後のテキストを保存するかどうかの問い合わせ メニューが出ます。 .It help ヘルプ。 すべてのキー操作とコマンドを含むヘルプ画面を表示。 .It file operations ファイル操作。 ファイルの読み込み、書き込み、保存に加え、 編集内容の印刷コマンドへの送信メニュー ( .Sx "ファイルによる ee の初期化" を参照)。 .It redraw screen 画面再描画。 画面が乱れたとき画面を再描画するための手段。 .It settings 設定。 現在の操作モードと右マージンを表示。特定の項目上で return キーを押すと、 その値を変更できます。 このメニューから抜ける場合は .Em escape キーを押します。(下記の .Sx モード を参照。) .It search 検索。 新しい検索文字列ないしは既に設定した検索文字列で検索するためのメニュー。 .It miscellaneous その他。 現在の段落の整形、シェルコマンドの実行、編集中のテキストのスペルチェック を行うためのメニュー。 .El .Ss "段落整形" .Nm の段落 (paragraph) は、下記のいずれかで囲まれた部分を意味します: .Bl -bullet -width indent .It ファイルの先頭と終わり。 .It 文字を含まないない行、ないしは、スペースとタブのみの行。 .It ピリオド ('.') か 大なり記号 ('>') で始まる行。 .El .Pp 段落整形を行う方法としては、メニューの .Em 段落整形(format paragraph) を選択して明示的に行う方法と、段落の自動整形を行うように .Nm を設定する方法の二つがあります。 自動モードはメニューからでも、初期化ファイルからでも設定可能です。 .Pp .Nm のテキスト操作には、自由形式 (free-form)、マージン (margins)、 自動整形 (automatic formatting) の3つの状態があります: .Pp 「自由形式」はプログラミングのような仕事に最適で、行の長さの制限がなく、 整形も行われません。 .Pp 「マージン」を使うと、右マージン (これは .Em 設定 (settings) メニューで指定しますが、 デフォルトは端末の右縁になっています) を越えていないかどうかを気にせずに テキストをタイプすることができます。 このモードでは .Em 段落整形 (format paragraph) メニュー項目が動作します。 .Pp 「自動整形」はワードプロセッサのようなふるまいをします。 ユーザがテキストを入力する一方で、 空白文字が入力されるかテキストを削除するたびに、 .Nm は段落全体が端末の幅を越えないように調整します。 自動整形を使う場合は、マージンも有効にしておかなければなりません。 .Ss モード .Nm そのものは「モードなし」(modeless) エディタ (常にテキスト挿入モードに なっています) ですが、その動作の中には次のようなモードをもつものもあります: .Bl -tag -width indent .It タブ拡張 タブ文字として挿入するか、空白文字に置換するかを決めます。 .It 大文字と小文字の区別 文字列検索では、大文字と小文字を区別することもできますし、 同一視させることもできます。 .It マージン監視 行の長さを右マージンまでに制限することもできますし、 無限に長くすることもできます。 .It 段落の自動整形 テキストの入力中、うまく画面の幅に収まるように、 エディタに調整させることができます。 .It 8 ビット文字 8 ビット文字をそのまま表示させるか、 その値を山括弧で囲んで表示 ("<220>" 等) させるかの切り替えです。 .It 情報ウィンドウ 実行可能なキー操作を表示するウィンドウを出すか出さないかを選択します。 .It emacs キー割り当て コントロールキーの割り当てを emacs 方式にするかどうかを決めます。 .It 16 ビット文字 16 ビット文字を 1 個の 16 ビット量として扱うのか、2 個の 8 ビット量として 扱うのかを切り替えます。 主として、Chinese Big 5 コードセットで動作します。 .El .Pp これらのモードは初期化ファイル (下記を参照) とメニュー (上記を参照) の いずれでも設定可能です。 .Ss "スペルチェック" .Nm でテキストに含まれる単語のスペルをチェックする方法には、 伝統的な .Xr spell 1 コマンドを使う方法と、オプションの .Xr ispell 1 コマンドを使う方法の二つがあります。 .Pp .Nm spell を使う場合は、認識できない単語はファイルの先頭に置かれます。 .Nm ispell の場合は、ファィルをいったんディスクに書き出し、 .Nm ispell にそのファイルを処理させてから、 .Nm ispell が書き換えたファイルを再度読み込みます。 .Ss "編集内容の印刷" メニューの中に編集内容を印刷する項目があります。 .Nm -は初期化コマンドの +ユーティリティは初期化コマンドの .Em printcommand (下記の .Sx "ファイルによる ee の初期化" を参照) で指定されたコマンドに編集中のテキストをパイプで転送します。 デフォルトでは .Xr lp 1 コマンドに転送します。 .Pp .Em printcommand で指定されたコマンドは、標準入力からテキストを読み込むものでなければ なりません。詳細はシステム管理者に聞いてください。 .Ss "シェルの操作" .Em その他 (miscellaneous) のメニューで .Em シェルコマンド (shell command) を選ぶか、 .Em command: プロンプトで感嘆符 ("!") に続けて実行したいコマンドを書くことで、 .Nm の中からシェルにコマンドを実行させることができます。さらに、"!' の前に 「大なり記号」(">") を書くことで、編集バッファの内容をシェルコマンドに リダイレクトすることができます。 同様に、感嘆符の前に「小なり記号」("<") を書くと、 シェルコマンドの実行結果を編集バッファに取り込みます。 これらを同時に指定することで、シェルコマンドに出力した後、コマンドの 実行結果を読み直すことも可能です。 従って、エディタで編集中の単語のリストをソートしたい場合は、 コマンド入力で次のようにタイプすることができます: .Dl >" のように山括弧で囲まれた数値 で表示します)。 .It 16bit 16 ビット文字を扱います。 .It no16bit 16 ビット文字を扱いません。 .It emacs emacs のキー割り当てにします。 .It noemacs emacs のキー割り当てをやめます。 .El .Ss "エディタの設定の保存" .Em settings メニューからこのエントリを使用すると、 ユーザは現在のエディタの設定 (前記 .Sx "ファイルによる ee の初期化" 参照) を現在のディレクトリもしくはユーザのホームディレクトリのファイル .Pa .init.ee に保存できます。 既に存在するファイル .Pa .init.ee は .Pa .init.ee.old にリネームされます。 .Sh 警告 (原文) .\" こういう部分は日本語訳により細かなニュアンスが変わって問題になる .\" かもしれないので、原文のままにしてあります。 sakai@jp.freebsd.org 1997.6.19 THIS MATERIAL IS PROVIDED "AS IS". THERE ARE NO WARRANTIES OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Neither Hewlett-Packard nor Hugh Mahon shall be liable for errors contained herein, nor for incidental or consequential damages in connection with the furnishing, performance or use of this material. Neither Hewlett-Packard nor Hugh Mahon assumes any responsibility for the use or reliability of this software or documentation. This software and documentation is totally UNSUPPORTED. There is no support contract available. Hewlett-Packard has done NO Quality Assurance on ANY of the program or documentation. You may find the quality of the materials inferior to supported materials. .Pp Always make a copy of files that cannot be easily reproduced before editing. Save files early, and save often. .Pp (上記段落の日本語訳 −参考−) .br このプログラムはこのままの状態 (AS IS) で供給されるもので、実用性や特定用途 に対する適合性を含む、いかなる保証もありません。Hewlett-Packard と Hugh Mahon のいずれも、このプログラムの間違い、あるいは、設置や使用に付随ないしは結果と して生ずるいかなる問題についても責任を負いません。Hewlett-Packard と Hugh Mahon のいずれも、このプログラムとドキュメントの信頼性に対する責任を負いませ ん。このプログラムとドキュメントに対するサポートはありませんし、サポートの窓 口もありません。Hewlett-Packard はプログラムとドキュメントの品質検査行ってい ません。サポートのある製品にくらべて品質が劣る可能性もあります。 .Pp 編集前の状態に戻すのが困難なファイルについては、常にコピーを残してください。 早めにファイルに保存し、小刻みに保存操作を行ってください。 .Ss "国際コードセットのサポート" .Nm -は 8 ビット文字コード (8 ビットクリーン) +ユーティリティは 8 ビット文字コード (8 ビットクリーン) または Chinese Big-5 コードセットをサポートしています (他のマルチバイトコードセットも動作するかもしれませんが、 Big-5 が動作する理由は、2 バイト文字は画面上で 2 桁を占めるためです)。 .Sh 警告 低速システムでは、段落自動整形は極端に遅くなります。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/init.ee -compact .It Pa /usr/share/misc/init.ee .It Pa $HOME/.init.ee .It Pa .init.ee .El .Sh 作者 ソフトウェア .Nm は .An Hugh Mahon が開発しました。 .Pp .\" 以下の部分も原文を残し、和訳併記としてあります。 .\" sakai@jp.freebsd.org 1997.6.19 This software and documentation contains proprietary information which is protected by copyright. All rights are reserved. .Pp (上記段落の日本語訳 −参考−) .br このプログラムとドキュメントは著作権法により保護されており、 すべての権利は著作者が有します。 .Pp Copyright (c) 1990, 1991, 1992, 1993, 1995, 1996 Hugh Mahon. .Sh "関連項目" .Xr ispell 1 , .Xr lpr 1 , .Xr spell 1 , .Xr termcap 5 , .Xr terminfo 5 , .Xr environ 7 .Sh 日本語マニュアル 平林浩一 (kh@mogami-wire.co.jp) による ee 日本語化キットに含まれている 日本語化 ee の日本語マニュアルをベースに、 酒井淳嗣 (sakai@jp.freebsd.org) が一部修正。 diff --git a/ja_JP.eucJP/man/man1/enigma.1 b/ja_JP.eucJP/man/man1/enigma.1 index d15590f5d0..e99b67f86f 100644 --- a/ja_JP.eucJP/man/man1/enigma.1 +++ b/ja_JP.eucJP/man/man1/enigma.1 @@ -1,119 +1,119 @@ .\" .\" enigma (aka. crypt) man page written by Joerg Wunsch. .\" .\" Since enigma itself is distributed in the Public Domain, this file .\" is also. .\" -.\" %FreeBSD: src/usr.bin/enigma/enigma.1,v 1.5.2.1 2000/12/08 15:13:31 ru Exp % +.\" %FreeBSD: src/usr.bin/enigma/enigma.1,v 1.5.2.2 2002/06/20 23:45:48 charnier Exp % .\" .\" $FreeBSD$ .\" " .Dd October 30, 1998 .Os .Dt ENIGMA 1 .Sh 名称 .Nm enigma , .Nm crypt .Nd 非常に単純なファイルの暗号化 .Sh 書式 .Nm .Op Fl s .Op Fl k .Op Ar password .Nm crypt .Op Fl s .Op Fl k .Op Ar password .Sh 解説 -.Nm enigma -は +.Nm +ユーティリティは .Nm crypt という名前でも知られていますが、 .Dq 秘密鍵 をベースとする .Em 非常に 単純な暗号化プログラムです。 これはフィルタとして働きます。つまり、標準入力からの一連のデータを暗号化 または復号化し、その結果を標準出力に出力します。 入力データがすでに暗号化されているかどうかを自動的に検出し、すでに 暗号化されている場合は復号モードに切り替わります。 .Pp 秘密鍵をプログラムに渡す方法はいくつかあります。 デフォルトでは、制御端末上で .Xr getpass 3 を用いて、ユーザに鍵を入力するよう促します。 これが安全に鍵を渡す唯一の方法です。 .Pp 別の方法としては、プログラム起動時に、単独のコマンドライン引数 .Ar password によって鍵を渡すこともできます。 明らかなことですが、この方法を用いると、 .Xr ps 1 を実行している他のユーザが、簡単に鍵を見破ることができます。 さらにもう一つの方法としては、コマンドライン引数として .Fl k オプションを与えると、 .Nm は環境変数 .Ev CrYpTkEy から鍵を取得します。 この方法は、一見前述の他の方法よりも安全なように見えますが、 実際はそうではありません。というのは、環境変数もまた .Xr ps 1 で調べることができるからです。 従って、このオプションは、主に他の実装の .Nm enigma との互換性のために存在します。 .Pp .Fl s オプションを指定すると、 .Nm は、もう少し安全だと思われるように暗号化エンジンを変更しますが、 他の実装との互換性はなくなります。 .Pp .Ss 警告 .Nm は暗号化の手法としてはほとんど価値がありません。このプログラムは、この 実装を持つ他のオペレーティングシステムとの互換性を保つためだけのもの です。 本当の暗号化については、 .Xr bdes 1 (DES配布パッケージに含まれます)、または、 .Xr pgp 1 (ports コレクションに含まれます) を参照してください。 しかしながら、いくつかの国ではこのようなツールの輸出、輸入、使用に対する 制限が存在するかもしれないので、これらの強力なツールは、デフォルトでは オペレーティングシステムと一緒には配布されていません。 .Sh 環境変数 .Bl -tag -offset indent -width "XXCrYpTkEy" .It Ev CrYpTkEy .Fl k オプション指定時に、この変数から秘密鍵を取得します。 .El .Sh 使用例 .Bd -literal -offset indent man enigma | enigma > encrypted Enter key: (XXX \(em 鍵は表示されません) .Ed .Pp このマニュアルページを暗号化して、その結果を .Ql encrypted というファイルに格納します。 .Bd -literal -offset indent enigma XXX < encrypted .Ed .Pp 前の例で作成されたファイルを端末上に表示します。 .Sh 関連項目 .Xr bdes 1 , .Xr pgp 1 , .Xr ps 1 , .Xr getpass 3 .Sh 歴史 .Nm crypt の実装方法は .Ux オペレーティングシステムの間では非常にありふれたものです。 本プログラムの実装は、パブリックドメインの .Em Cryptbreakers Workbench のものを使用しました。 diff --git a/ja_JP.eucJP/man/man1/expand.1 b/ja_JP.eucJP/man/man1/expand.1 index 4b7f16431a..72f770acde 100644 --- a/ja_JP.eucJP/man/man1/expand.1 +++ b/ja_JP.eucJP/man/man1/expand.1 @@ -1,101 +1,114 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)error.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/expand/expand.1,v 1.3.2.4 2001/08/16 13:16:47 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/expand.1,v 1.6 2001/05/14 01:07:22 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/expand/expand.1,v 1.3.2.5 2002/06/20 08:06:44 tjr Exp % +.\" $FreeBSD$ .\" -.Dd June 6, 1993 +.Dd April 21, 2002 .Dt EXPAND 1 .Os .Sh 名称 .Nm expand , .Nm unexpand .Nd タブと空白文字の変換 .Sh 書式 .Nm expand .Op Fl Ns Ar tabstop .Oo .Fl t .Sm off .Ar tab1 , tab2 , ... , tabn .Sm on .Oc .Op Ar .Nm unexpand .Op Fl a +.Oo +.Fl t +.Sm off +.Ar tab1 , tab2 , ... , tabn +.Sm on +.Oc .Op Ar .Sh 解説 .Nm -は、指定されたファイルまたは標準入力を読み込み、 +ユーティリティは、指定されたファイルまたは標準入力を読み込み、 タブを空白文字に変換して標準出力に出力します。 バックスペース文字はそのまま出力し、 同時にタブの計算に用いるカラム位置カウンタを一つ減じます。 .Nm -は、 +ユーティリティは、 (ソートの前、特定のカラムに注目したいとき、など) タブを含んだテキストファイルの前処理用に便利です。 .Pp .\"(訳注) 原文では,以下のようなオプション列挙型の記述ではありませんが .\" 解りやすいと考えますので,私も前のバージョンの例にならいます. .\" 2.2.1R 対象(1997/04/03) Takeshi MUTOH オプションとしては以下のものがあります: .Bl -tag -width indent .It Fl t Ar tabstop タブ幅を指定します。デフォルトは 8 文字です。 .It Fl t Ar tab1,tab2,...,tabn 指定されたカラム位置にタブストップを設定します。 .El .Pp .Fl t のかわりに、 .Fl Ar tabstop もしくは .Fl Ar tab1, tab2,..., tabn という指定も許されます。 .Pp .Nm unexpand -は、 +ユーティリティは、 .Nm とは逆に、空白文字をタブに戻します。デフォルトでは、 行頭の空白文字とタブだけを、できるだけ長いタブの並びに戻します。 .Pp オプションとしては以下のものがあります: .Bl -tag -width flag .It Fl a 行頭でなくても、二つ以上の空白文字が続いており、空白文字をタブに置き換えれば サイズが圧縮されるような箇所はすべてタブに置き換えられます。 .El +.Sh 規格 +.Nm expand +および +.Nm unexpand +のユーティリティは、 +.St -p1003.1-2001 +に適合しています。 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/fdformat.1 b/ja_JP.eucJP/man/man1/fdformat.1 index 1c2cd655d6..b570ea0e9c 100644 --- a/ja_JP.eucJP/man/man1/fdformat.1 +++ b/ja_JP.eucJP/man/man1/fdformat.1 @@ -1,179 +1,179 @@ .\" Copyright (C) 1993, 1994, 1995, 2001 by Joerg Wunsch, Dresden .\" 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(S) ``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(S) 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. .\" -.\" %FreeBSD: src/usr.sbin/fdformat/fdformat.1,v 1.17.2.5 2001/08/16 15:55:57 ru Exp % +.\" %FreeBSD: src/usr.sbin/fdformat/fdformat.1,v 1.17.2.6 2002/06/21 16:40:26 charnier Exp % .\" .\" $FreeBSD$ .Dd July 2, 2001 .Os .Dt FDFORMAT 1 .Sh 名称 .Nm fdformat .Nd フロッピディスクのフォーマット .Sh 書式 .Nm fdformat .Op Fl q .Op Fl y .Op Fl v | Fl n .Op Fl f Ar capacity .Op Fl c Ar cyls .Op Fl s Ar secs .Op Fl h Ar heads .Nm fdformat .Op Fl r Ar rate .Op Fl g Ar gap3len .Op Fl i Ar intleave .Op Fl S Ar secshft .Op Fl F Ar fillbyte .Op Fl t Ar steps_per_track .Ar device_name .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar device_name デバイスのフロッピディスクをフォーマットします。 .Ar device_name は、フロッピディスクドライブのデバイスノードのフルパス名 (例えば .Pa /dev/fd0 ) か、省略形式のデフォルト名 (例えば .Em fd0 ) です。 後者の場合、 .Ar device_name は、与えられた名前に .Pa /dev/ を付け加え、後に .Em .capacity をつけくわえることで作成されます。 .Nm は、ジオメトリ情報を書き換えるため、 デバイスノード (マイナデバイス番号) に割り当てられたどんなジオメトリ情報も意味を持ちません。 .Pp 次のようなオプションがあります。 .Bl -tag -width 10n -offset indent .It Fl q コマンドからの出力を抑制し、 .Ar device_name のフロッピディスクをフォーマットしても良いかどうかの確認も行いません。 .It Fl y 自動的に "yes" と応答することにより確認要求を抑制します。 フォーマット状態の報告はまだ行います。 .It Fl f Ar capacity 望ましいフォーマットパラメータの設定をする普通の方法です。 360, 720, 800, 820, 1200, 1440, 1480, 1720 のいずれかが有効です。 .Ar capacity は、フォーマットするバイト数です。 .It Fl n フォーマットした後で、ベリファイしません。 .It Fl v ベリファイだけを行い、フォーマットしません。 .It Fl c Ar cyls シリンダ数: 40 または 80。 .It Fl s Ar secs トラックあたりのセクタ数: 9, 10, 15, 18 のいずれか。 .It Fl h Ar heads フロッピのヘッド数: 1 か 2。 .It Fl r Ar rate データレート: 250, 300, 500 のいずれか (単位は kbps)。 .It Fl g Ar gap3len ギャップ長。 .It Fl i Ar intleave インタリーブファクタ。 .It Fl S Ar secshft セクタサイズ: 0=128, 1=256, 2=512 (単位は バイト)。 .It Fl F Ar fillbyte フィルバイト。 .It Fl t Ar steps_per_track トラックあたりのステップ数。 フロッピディスクに書き込む、ジオメトリ情報を指定する別の方法です。 .El .Pp .Fl q フラグが指定されていない時、フォーマットを行う時に確認が行われます。 フォーマットを続行するためには、 .Dq y を必ず入力して、答える必要があります。 .Pp .Nm は、低レベルのフォーマットだけを行うことに注意してください。 ファイルシステムを作りたい時には、 .Em ufs ファイルシステム( UNIX ファイルシステム)を作りたい場合は、 .Xr newfs 8 コマンドを、 .Em MS-DOS (FAT) ファイルシステムを作りたい時には、 .Xr newfs_msdos 8 コマンドを、参照してください。 .Sh 診断 .Fl q が指定されていないと、ユーザにプログラムの進度を知らせるために、 標準出力に特定の 1 文字が表示されます。 最初に、 (複数の)トラックがフォーマットされている時には .Sq Em F が表示され、 ベリファイを行っている時には .Sq Em V が表示されます。 エラーが見付かった場合には、最後に .Sq Em E に変化します。 詳細な情報 (シリンダ・ヘッダ・セクタの番号と厳密なエラー原因) は、 最大 10 個のエラーに対して表示されます。 .Pp 終了ステータスは、操作が成功した時 0 を返します。 フロッピをフォーマットしている時にエラーが起こった時は 1 を返し、 間違ったコマンドライン引数が与えられた時に 2 を返します (診断出力に詳しい情報がでるので従ってください)。 .Sh 関連項目 .Xr fdc 4 , .Xr newfs 8 , .Xr newfs_msdos 8 .Sh 歴史 .Nm -は +ユーティリティは .Bx 386 0.1 のために開発され、 新しい .Xr fdc 4 フロッピディスクドライバにアップグレードされました。 これは、後に .Fx 1.1 システムの一部となりました。 .Sh 作者 .An -nosplit このプログラムは、 Dresden の .An J\(:org Wunsch のコントリビューションです。 変更は、モスクワの .An Serge Vakulenko と .An Andrey A. Chernov が行いました。 diff --git a/ja_JP.eucJP/man/man1/fdwrite.1 b/ja_JP.eucJP/man/man1/fdwrite.1 index 5c3fb6e388..95f5d2dcb1 100644 --- a/ja_JP.eucJP/man/man1/fdwrite.1 +++ b/ja_JP.eucJP/man/man1/fdwrite.1 @@ -1,122 +1,122 @@ .\" .\" ---------------------------------------------------------------------------- .\" "THE BEER-WARE LICENSE" (Revision 42): .\" wrote this file. As long as you retain this notice you .\" can do whatever you want with this stuff. If we meet some day, and you think .\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp .\" ---------------------------------------------------------------------------- .\" -.\" %FreeBSD: src/usr.sbin/fdwrite/fdwrite.1,v 1.12.2.5 2001/08/16 15:55:58 ru Exp % +.\" %FreeBSD: src/usr.sbin/fdwrite/fdwrite.1,v 1.12.2.6 2002/06/21 16:40:28 charnier Exp % .\" $FreeBSD$ .\" .\" .Dd September 16, 1993 .Os .Dt FDWRITE 1 .Sh 名称 .Nm fdwrite .Nd フロッピディスクのフォーマットと書き込み .Sh 書式 .Nm fdwrite .Op Fl v .Op Fl y .Op Fl f Ar inputfile .Op Fl d Ar device .Sh 解説 -.Nm fdwrite -は、複数のフロッピディスクをフォーマットし書き込みます。 +.Nm +ユーティリティは、複数のフロッピディスクをフォーマットし書き込みます。 フォーマットできるフロッピディスクデバイスを使うことができます。 .Pp -.Nm fdwrite -は、( +.Nm +ユーティリティは、( .Pa /dev/tty ) のユーザに新しいフロッピをいれてリターンキーを押すように指示します。 デバイスがその後にオープンされ、パラメータが尋ねられ、 その後トラックがフォーマットされ、 .Ar inputfile で指定されたデータが書き込まれ、ベリファイされます。 フロッピディスクがいっぱいになった時は、この過程が次のディスクに対して 繰り返されます。これは、プログラムが中断されるか .Ar inputfile の終り (EOF) に達するまで続けられます。 .Pp 以下のようなオプションがあります。 .Bl -tag -width 10n -offset indent .It Fl v 標準出力への出力情報の状態をトグルで変更します。 デフォルトのモードは ``on'' です。 はじめてデバイスがオープンされた後で、フォーマットが出力されます。 操作の間には、現在のフロッピディスクの残りのトラック数と 文字 I, Z, F, W, R, C,の文字が出力されます。各文字は、現在のトラックに 対して、入力 (I)、ゼロで埋める (Z)、フォーマット (F)、書き込み (W)、 読み込み (R)、比較 (C) のそれぞれを行っていることをあらわします。 .It Fl y ドライブにフロッピディスクがあるかどうか問いあわせません。 この非対話オプションはシェルスクリプトで使用するのに便利です。 .It Fl f Ar inputfile 読み込むための入力ファイルです。もし、与えられていない場合は標準入力が 仮定されます。 .It Fl d Ar device 書き込むためのフロッピデバイスの名前です。 デフォルトは、 .Pa /dev/fd0 です。 .El .Pp -.Nm fdwrite -は、ユーザがリターンを押すのを待っている間は +.Nm +ユーティリティは、ユーザがリターンを押すのを待っている間は .Ar device をクローズしています。したがって、この時には完全にドライブを別の目的で 使うことができ、あとで次のフロッピの書き込みを再開できます。 .Pp .Ar device からかえって来たパラメータは、フォーマットのために使われます。 もし、特別なフォーマットが必要な時には、 .Xr fdformat 1 を代わりに使ってください。 .Sh 使用例 -.Nm fdwrite -は、複数枚数のフロッピへの書き込みを +.Nm +ユーティリティは、複数枚数のフロッピへの書き込みを 簡単に行えるようにと考えらえて作成されたツールです。 そのような使用例は、以下の tar アーカイブの書き込みがあります。 .Pp .Dl "tar cf - . | gzip -9 | fdwrite -d /dev/fd0.1720 -v .Pp .Xr tar 1 のマルチボリューム機能との主要な違いは、 もちろんフロッピのフォーマットです。フォーマットは実行中に行われるので、 フロッピに対する仕事の量を減らすことができます。 .Sh 関連項目 .Xr fdformat 1 .Sh 歴史 -.Nm fdwrite -は、 ``make world'' が終了するのを待つ間に書かれました。 +.Nm +ユーティリティは、``make world'' が終了するのを待つ間に書かれました。 コードのうちいくつかは、 .Xr fdformat 1 から持って来ました。 .Sh 作者 このプログラムは、 .An Poul-Henning Kamp Aq phk@login.dknet.dk によるコントリビューションです。 .Sh バグ 診断機能は現在は完全ではありません。 .Pp フロッピがおかしい時に .Ar inputfile がシーク可能であれば、ユーザにディスクを無げ捨て、 別のフロッピを入れて、正しい場所まで戻って操作を続けるように指示すべきです。 .Pp この方法は、シークできない入力に対しても同様に一時ファイルを 使用することで、拡張可能です。 .Pp オプション ( デフォルトは 0) で、ユーザに失敗した時の再試行回数を 尋ねるべきでしょう。 .Pp 現在は、フロッピのマルチボリュームを読み戻すための適当なツールが ありません。 データが圧縮されていない時には、代わりに .Xr tar 1 の様なプログラムで、そのような仕事を行うことができます。 このような状態の時にはもちろん、いつも .Xr dd 1 を信用することもできます。 diff --git a/ja_JP.eucJP/man/man1/fetch.1 b/ja_JP.eucJP/man/man1/fetch.1 index fc4f08a232..33e0df4d65 100644 --- a/ja_JP.eucJP/man/man1/fetch.1 +++ b/ja_JP.eucJP/man/man1/fetch.1 @@ -1,242 +1,242 @@ .\"- .\" Copyright (c) 2000 Dag-Erling Co��an Smgrav .\" All rights reserved. .\" Portions Copyright (c) 1999 Massachusetts Institute of Technology; used .\" by permission. .\" .\" 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 .\" in this position and unchanged. .\" 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. 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. .\" -.\" %FreeBSD: src/usr.bin/fetch/fetch.1,v 1.33.2.10 2002/01/16 16:18:23 ru Exp % +.\" %FreeBSD: src/usr.bin/fetch/fetch.1,v 1.33.2.11 2002/06/20 23:45:50 charnier Exp % .\" .\" $FreeBSD$ .Dd June 28, 2000 .Dd February 22, 1999 .Dt FETCH 1 .Os .Sh 名称 .Nm fetch .Nd URL (Uniform Resource Locator) 形式でのファイルの取得 .Sh 書式 .Nm .Op Fl 146AFMPRUadlmnpqrsv .Op Fl B Ar bytes .Op Fl S Ar bytes .Op Fl T Ar seconds .Op Fl o Ar file .Op Fl w Ar seconds .Op Fl h Ar host .Op Fl c Ar dir .Op Fl f Ar file .Op Ar URL ... .Sh 解説 .Nm -は +ユーティリティは .Xr fetch 3 ライブラリへのコマンド行インタフェースを提供します。 目的は、コマンド行の URL (複数可) に示されるファイル (複数可) を取得することです。 .Pp 以下のオプションが使用可能です。 .Bl -tag -width Fl .It Fl \&1 最初にファイルの取得に成功したときに、終了値 0 を返して停止します。 .It Fl 4 .Nm が IPv4 アドレスのみを使用することを強制します。 .It Fl 6 .Nm が IPv6 アドレスのみを使用することを強制します。 .It Fl A ``一時的な'' (302) リダイレクトを自動的には追跡しません。 要求したオブジェクトが存在しない場合に、 発見できないというエラーではなくリダイレクトを返すという、 壊れたウェブサイトが存在します。 .It Fl a ソフト上での失敗の場合に自動的に転送を再試行します。 .It Fl B Ar bytes 読み込みバッファの大きさをバイト単位で指定します。 デフォルトは 4096 バイトです。 バッファの大きさを小さくしようとしても、黙って無視されます。 実際に実行された読み込み回数は、冗長レベル 2 以上で報告されます ( .Fl v フラグを参照してください)。 .It Fl c Ar dir 遠隔ホストの .Ar dir ディレクトリのファイルを取得します。 本オプションは、価値が低下しており、後方互換性のためだけに提供されています。 .It Fl d プロキシが設定されていても、直接接続します。 .It Fl F .Fl r フラグと組み合わせると、 ローカルファイルとリモートファイルの修正時刻が異なったとしても、 強制的に再開します。 .It Fl f Ar file 遠隔ホストの .Ar file という名前のファイルを取得します。 本オプションは、価値が低下しており、後方互換性のためだけに提供されています。 .It Fl h Ar host ホスト名が .Ar host にあるファイルを取得します。 本オプションは、価値が低下しており、後方互換性のためだけに提供されています。 .It Fl l 目標が、ファイル形式の URL の場合、目標を複製しようとするのではなく、 リンクを作成します。 .It Fl M .It Fl m ミラーモード: ローカルホストにファイルが既に存在し、サイズと 変更時間がリモートファイル同じである場合、転送は行われません。 .Fl m と .Fl r のフラグは、あいいれないことに注意してください。 .It Fl n 転送されるファイルの変更時間を保存しません。 .It Fl o Ar file 出力ファイル名を .Ar file にします。 デフォルトでは、``パス名'' が指定された URI から取り出され、その ベースネームが出力ファイルの名前として使われます。 .Ar file 引数として .Sq Li \&- を与えると、結果は標準出力に出力されます。 .It Fl P .It Fl p .Tn FTP プロトコルをパッシブモードで使います。 これは、入力接続をブロックする防火壁 (firewall) の背後にいる場合に有用です。 FTP URL を取得するときに .Nm がハングするように見える場合に使用してみてください。 .It Fl q 沈黙モード。 .It Fl R 与えられたファイル名は大事にされ、どんな状況下でもファイル名は消去されません。 それは、転送が失敗もしくは不完全であった時でさえ、あてはまります。 .It Fl r 以前に中断された転送を再開します。 .Fl m と .Fl r のフラグは、あいいれないことに注意してください。 .It Fl S Ar bytes サーバが報告するファイルサイズが、指定値に合致することを要求します。 合致しない場合、メッセージが表示され、ファイルは取得されません。 サーバがファイルサイズの報告をサポートしていない場合、 本オプションは無視され、無条件にファイルが取得されます。 .It Fl s 各要求ファイルごとに、取得せずに、バイト数単位の大きさを表示します。 .It Fl T Ar seconds タイムアウト時間を .Ar seconds 秒に設定します。 FTP での転送に対しては .Ev FTP_TIMEOUT 環境変数が、HTTP での転送に関しては .Ev HTTP_TIMEOUT 環境変数が、設定されていた場合は、それを上書きします。 .It Fl U パッシブな FTP を使用しているとき、データ接続用に低位 (デフォルト) ポート を割り当てます。 どのポート範囲が対応するかの指定方法の詳細については、 .Xr ip 4 を参照してください。 .It Fl v 冗長レベルを増やします。 .It Fl w Ar seconds .Fl a が指定された場合、次のリトライの前に指定した秒数だけ待ちます。 .El .Pp .Nm が .Dv SIGINFO シグナルを受け取ると ( .Xr stty 1 への .Cm status 引数を参照して下さい)、 現在の転送レートの統計情報が、 標準の完了メッセージと同じ書式で 標準エラー出力に書き込まれます。 .Sh 診断 .Nm コマンドは、成功時には 0 を返し、失敗時には 1 を返します。 コマンド行上に複数の URL を指定した場合、 .Nm は、それぞれを順番に取得しようとし、 すべての取得に成功した場合のみに 0 を返します。 .Sh 環境変数 .Bl -tag -width HTTP_TIMEOUT .It Ev FTP_TIMEOUT .Tn FTP 接続を中断するまでの最大時間を秒で指定します。 .It Ev HTTP_TIMEOUT .Tn HTTP 接続を中断するまでの最大時間を秒で指定します。 .El .Pp .Xr fetch 3 ライブラリの文書に記述されている環境変数は、すべてサポートされています。 .Sh 関連項目 .Xr fetch 3 .Sh 歴史 .Nm コマンドは .Fx 2.1.5 から導入されました。 本実装が最初に登場したのは .Fx 4.1 です。 .Sh 作者 .An -nosplit .Nm のオリジナル実装は .An Jean-Marc Zucconi が行いました。 .Fx 2.2 のために、拡張を行ったのは .An Garrett Wollman であり、後に .Xr fetch 3 を使用するように .An Dag-Erling Sm\(/orgrav が完全に書き直しました。 .Sh 注 .Fl b および .Fl t のオプションは、すでにサポートされておらず、警告を表示します。 これらのオプションは、他の OS のバグの回避策であって、 本実装ではバグを引き起こしません。 .Pp .Fl h , .Fl c , .Fl f オプションの使用と、コマンド行上の URL 指定は、同時にはできません。 diff --git a/ja_JP.eucJP/man/man1/file.1 b/ja_JP.eucJP/man/man1/file.1 index 055daa2204..ff51542f97 100644 --- a/ja_JP.eucJP/man/man1/file.1 +++ b/ja_JP.eucJP/man/man1/file.1 @@ -1,528 +1,526 @@ -.\" %FreeBSD: src/usr.bin/file/file.1,v 1.16.2.8 2001/12/13 09:14:26 ru Exp % -.\" $Id: file.1,v 1.22 2002-04-13 01:21:15 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/file/file.1,v 1.16.2.9 2002/06/20 23:45:53 charnier Exp % +.\" $Id: file.1,v 1.23 2002-07-21 05:44:22 horikawa Exp $ .\" .\" $FreeBSD$ .Dd April 4, 2001 .Dt FILE 1 "Copyright but distributable" .Os .Sh 名称 .Nm file .Nd ファイルの種類を判定する .Sh 書式 .Nm .Op Fl bciknsvzL .Op Fl f Ar namefile .Op Fl m Ar magicfiles .Ar .Nm .Fl C .Op Fl m Ar magicfile .Sh 解説 -このマニュアルは +このマニュアルは、 +引数で指定されたファイルの種類を判定する、 .Nm -コマンドのバージョン 3.36 について記載しています。 -.Pp -.Nm -は、引数で指定されたファイルの種類を判定するプログラムです。判定の -ために、ファイルシステムテスト、マジックナンバテスト、言語テストの +ユーティリティのバージョン 3.36 について記載しています。 +判定のために、ファイルシステムテスト、マジックナンバテスト、言語テストの 3 つのテストをこの順に実行し、 .Em 最初に 判定できた結果からファイルの種類を表示します。 .Pp ファイルの種類として表示されるのは、 .Dq Li text (印字可能文字と少数の制御文字だけのファイルで、 .Tn ASCII 端末に表示した場合、 問題が起こらないもの)、 .Dq Li executable ( .Ux カーネル等に理解可能な形にコンパイルされたプログラムを 含むファイル)、その他のものを意味する .Dq Li data (data は、通常 .Sq バイナリ か表示不能なもの) のうちの 1 つです。 例外は、内部フォーマットがよく知られた、 バイナリデータを含むファイル (コアファイルや tar アーカイブ) です。 ファイル .Pa /usr/share/misc/magic やプログラムそのものを変更するときは、 .Em "これらのキーワードを残して下さい" 。 ディレクトリ内のすべての可読なファイルは、 単語 .Dq Li text を表示することが期待されています。 Berkeley で行われたように、 .Dq Li "shell commands text" を .Dq Li "shell script" と変更するようなことはしないで下さい。 ファイル .Pa /usr/share/misc/magic は、 .Nm のソース配布中の .Pa Magdir サブディレクトリ中の大量の小さなファイルから機械的に構築されることに 注意してください。 .Pp ファイルシステムテストは、 .Xr stat 2 システムコールからの戻り値を調べることに基づいています。 このプログラムは、ファイルが空であるかどうか、ある種の 特殊ファイルであるかどうかを調べます。 使っているシステムに合った既知のファイルの種類 (システムに実装されたソケット、シンボリックリンク、 名前付きパイプ (FIFO)) は、システムヘッダファイル .Aq Pa sys/stat.h で定義されていれば表示されます。 .Pp マジックナンバテストは、ファイルが固定フォーマットのデータであるか どうかをチェックするために使われます。 よい例が、実行可能なバイナリ実行形式 (コンパイルされたプログラム) .Pa a.out ファイルです。このフォーマットは標準インクルードディレクトリ内の .Aq Pa a.out.h や場合により .Aq Pa exec.h で定義されています。 実行ファイルは、 ファイルの先頭近くの特定の場所に、 .Sq マジックナンバ を持ちます。 これは .Ux オペレーティングシステムに対し、 ファイルがバイナリ実行形式であり、 どのタイプの実行可能ファイルであるかを知らせます。 .Sq マジックナンバ の概念は拡張され、データファイルにも適用されています。 ファイルの先頭に近い固定位置に固定識別子があるファイルは、 このように記述できます。 これらのファイル識別情報は、組み込みのマジックファイル .Pa /usr/share/misc/magic.mgc または組み込みファイルが存在しない場合は .Pa /usr/share/misc/magic から読み込まれます。 .Pp ファイルがマジックファイルのどのエントリにもマッチしない場合、 text ファイルに見えるかどうか検査されます。 .Tn ASCII , .Tn ISO-8859-x , 非 ISO 8-bit 拡張 ASCII 文字集合 (Macintosh および IBM PC システムで使用), .Tn UTF-8-encoded Unicode , .Tn UTF-16-encoded Unicode , .Tn EBCDIC の文字集合が区別可能であり、 これには各文字集合における印字可能 text を構成する バイトの範囲およびシーケンスを使用します。 ファイルがこれらのテストのいずれかを通過した場合、文字集合が報告されます。 .Tn ASCII , .Tn ISO-8859-x , .Tn UTF-8 , extended-ASCII ファイルは .Dq text として識別されます。 なぜなら、ほとんどどのような端末においても読めるからです。 .Tn UTF-16 および .Tn EBCDIC は .Dq Li "character data" でしかありません。 これらは text を含みますが、読む前に変換が必要だからです。 さらに、 .Nm は text タイプファイルの他の特性も判定しようとします。 ファイルの行の終端が、 .Ux 標準の LF ではなく、 CR, CRLF, NEL のいずれかである場合、そのことが報告されます。 組み込みのエスケープシーケンスや重ね打ちを含むファイルについても、 識別されます。 .Pp text タイプファイルで使用されている文字集合を判定した後、 その言語を推定しようとします。 言語テストは、ファイルの始めの数ブロックに 特定の文字列 ( .Pa Inames.h を参照) があるかどうかを探します。たとえばキーワード .Ic .br があればそれはおそらく .Xr troff 1 の入力ファイルであり、 .Ic struct というキーワードは、C 言語のプログラムであることを示しています。 こうした推定方法は、前述の 2 つのテストより信頼性が低いため、 最後に行われます。言語テストルーチンは ( .Xr tar 1 アーカイブのような) その他のファイルもチェックします。 .Pp 上記の文字集合のいずれで記述されているとも識別できなかったファイルは、 単に .Dq Li data と呼ばれます。 .Sh オプション .Bl -tag -width indent .It Fl b 出力行の前にファイル名を付けません (短縮モード)。 .It Fl c マジックファイルを解析した形式を、調査できるように表示します。 通常、 新しいマジックナンバファイルを使う前にデバッグするために、 .Fl m オプションとともに用います。 .It Fl C .Pa magic.mgc 出力ファイルを書きます。 これには構文解析される前のバージョンのファイルが含まれます。 .It Fl f Ar namefile 引数の前に .Ar namefile から調べるべきファイル名を (1 行に 1 つ) 読み込みます。 .Ar namefile もしくは引数の filename は少なくとも 1 つは指定しなければなりません。 標準入力のファイルの種類を判定させる場合は、 ファイル名として、 .Dq Fl を指定します。 .It Fl i .Nm に、伝統的な人間が読める形式の代りに、 mime タイプ文字列を出力させます。 よって、 .Dq Li "ASCII text" の代りに .Dq Li "text/plain; charset=us-ascii" となります。 本オプションが動作するようにするために、 .Nm はファイル認識方法 (例えば、多くの text ファイルタイプやディレクトリ等) を変え、 別の .Pa magic ファイルを使用します (後述の .Sx 関連ファイル 節を参照してください)。 .It Fl k 最初にマッチしても停止せずに、処理を継続します。 .It Fl m Ar list マジックナンバを含む別のファイルの list を指定します。 これは、1 つのファイルか、コロン (:) で分けられたファイルのリストです。 .It Fl n 各ファイルのチェック後に、標準出力をフラッシュします。 ファイルの一覧をチェックしているときのみ、有用です。 ファイルタイプをパイプから出力するプログラムにおいて使用することを意図します。 .It Fl v プログラムのバージョンを表示して、終了します。 .It Fl z compress で圧縮されたファイルの中身を見ようとします。 .It Fl L オプションは(システムがシンボリックリンクを提供していれば)、 .Xr ls 1 コマンドの .Fl L オプションと同様にシンボリックリンクをたどって実際のファイルの中 身の種類を判定します。 .It Fl s 通常、 .Nm が引数のファイルの読み込みとタイプの判定を行うのは、 .Xr stat 2 が通常ファイルであると報告した場合のみです。 これにより問題を回避しています。 なぜなら、特殊ファイルの読み込みは、 特定の結果を発生させる場合があるからです。 .Fl s オプションを指定すると、 .Nm は、ブロックおよびキャラクタの特殊ファイルも読み込みます。 これは、raw ディスクパーティション中のデータに存在する ファイルシステムタイプの判定に有用です。 なぜなら、raw ディスクパーティションはブロック型特殊ファイルであるからです。 本オプションはまた、 .Nm が .Xr stat 2 が報告するファイルの大きさを無視するようにさせます。 なぜなら、システムによっては、 raw ディスクパーティションの大きさは 0 であると報告するものがあるからです。 .El .Sh 関連ファイル .Bl -tag -width ".Pa /usr/share/misc/magic.mime" -compact .It Pa /usr/share/misc/magic.mgc デフォルトの組み込まれたマジックナンバのリスト .It Pa /usr/share/misc/magic デフォルトのマジックナンバのリスト .It Pa /usr/share/misc/magic.mime .Fl i が指定されて mime タイプを出力する場合に使用する、 デフォルトのマジックナンバのリスト .El .Sh 環境変数 環境変数 .Ev MAGIC は、デフォルトのマジックナンバファイルを指定するために 使うことができます。 .Sh 関連項目 .Xr hexdump 1 , .Xr od 1 , .Xr strings 1 , .Xr magic 5 .Sh 標準適合性 FILE(CMD) の .St -svid4 の曖昧な記述から 判断する限りにおいては、 このプログラムはこの仕様を越えていると思われます。 同名の System V のプログラムと、ほとんど動作は同じです。 しかし、このバージョンはより多くのマジックを知っているので、多くの場合に 異なった (より正確な) 出力を出します。 .Pp このバージョンと System V のものとの大きな違いは、 このバージョンは全ての空白を区切り文字として扱うため パターン内の空白はエスケープしなければならないということです。 たとえば、 .Pp .Dl ">10 string language impress\ (imPRESS data)" .Pp とマジックファイルに書かれていた場合は、次のように 変更せねばなりません。 .Pp .Dl ">10 string language\e impress (imPRESS data)" .Pp またこのバージョンでは、バックスラッシュを含んでいる パターンもエスケープしなくてはいけません。たとえば、 .Pp .Dl "0 string \ebegindata Andrew Toolkit document" .Pp とマジックファイルに書かれていた場合は、次のように 変更せねばなりません。 .Pp .Dl "0 string \e\ebegindata Andrew Toolkit document" .Pp Sun Microsystems の SunOS リリース 3.2 もしくはそれ以降には、 System V 由来の .Xr file 1 コマンドが含まれていますが、拡張がなされています。 このバージョンは SUN のものとは、細かい点でしか異なりません。 このバージョンには .Sq Ic & 演算子の拡張が含まれています。 使い方は、次のようなものです。 .Pp .Dl ">16 long&0x7fffffff >0 not stripped" .Sh マジックディレクトリ マジックファイルのエントリは様々なソース (主に USENET) から集められたり、様々な作者から提供されました。 .An Chirstos Zoulas (下記のアドレス) が、 マジックファイルエントリをさらに集めたり訂正するでしょう。 統合したマジックファイルエントリは、定期的に配布されるでしょう。 .Pp マジックファイルにおけるエントリの順序は 重要です。 使っているシステムによって、エントリの順序が正しくなくなることが あります。 もし、あなたの古い .Nm コマンドがマジックファイルを使っているのなら、 比較のため古いマジックファイルを保存して下さい (たとえば、 .Pa /usr/share/misc/magic.orig という名前に変更します)。 .Sh 使用例 .Bd -literal $ file file.c file /dev/hda file.c: C program text file: ELF 32-bit LSB executable, Intel 80386, version 1, dynamically linked, not stripped /dev/hda: block special $ file -s /dev/hda{,1,2,3,4,5,6,7,8,9,10} /dev/hda: x86 boot sector /dev/hda1: Linux/i386 ext2 filesystem /dev/hda2: x86 boot sector /dev/hda3: x86 boot sector, extended partition table /dev/hda4: Linux/i386 ext2 filesystem /dev/hda5: Linux/i386 swap file /dev/hda6: Linux/i386 swap file /dev/hda7: Linux/i386 swap file /dev/hda8: Linux/i386 swap file /dev/hda9: empty /dev/hda10: empty $ file -i file.c file /dev/hda file.c: text/x-c file: application/x-executable, dynamically linked (uses shared libs), not stripped /dev/hda: application/x-not-regular-file .Ed .Sh 歴史 .Nm コマンドは、少なくとも Research Version 6 (マニュアルページの日付は、1975 年 1 月 16 日) からはどの .Ux にもありました。 System V バージョンはある重要な変更、 すなわち外部マジックナンバリストを導入しました。 これによってプログラムのスピードはわずかに低下しましたが、 更にまた柔軟になりました。 .Pp このプログラムは、System V バージョンを基づいており、 .An Ian Darwin Aq ian@darwinsys.com によって、他の誰かのソースコードを見ることなく 書かれました。 .Pp .An John Gilmore は、コードを拡張し、最初の版よりもよいものにしました。 .An Geoff Collyer は、不適当なところが数箇所あるのを発見し、 いくつかマジックファイルエントリを提供しました。 .An Rob McMahon Aq cudcv@warwick.ac.uk は、1989 年に、 .Sq Ic & 演算子を寄贈しました。 .Pp .An Guy Harris Aq guy@netapp.com は、1993 年から現在に至り、多くの変更を行っています。 .Pp 基本開発と 1990 年から現在に至るメンテナンスを、 .An Christos Zoulas Aq christos@astron.com が行っています。 .Pp 2000 年に .An Chris Lowth Aq chris@lowth.com が修正を行い、 .Fl i オプションが mime タイプ文字列を出力し、 別のマジックファイルと内部ロジックを使用するようになりました。 .Pp 2000 年 7 月に .An Eric Fischer Aq enf@pobox.com が修正を行い、 文字コードを識別し、非 .Tn ASCII ファイルの原語を識別しようとするようになりました。 .Pp .Pa Magdir ディレクトリ ( .Pa /usr/share/misc/magic ファイルのソース) に対する寄贈者は、ここに含めるには長過ぎます。 ご了承ください。 .Sh 法律上の注意 Copyright (c) Ian F. Darwin, Toronto, Canada, 1986-1999. Covered by the standard Berkeley Software Distribution copyright; see the file .Pa LEGAL.NOTICE in the source distribution. .Pp The files .Pa tar.h and .Pa is_tar.c were written by .An John Gilmore from his public-domain .Nm tar program, and are not covered by the above license. .Sh バグ .Pa Magdir から .Pa Magic ファイルを自動的に作成するよりよい方法があるはずです。 それは何なのでしょうか。より起動を速くするため マジックファイルをバイナリにコンパイルするとよいでしょう。 (たとえば .Xr ndbm 3 あるいは、異機種ネットワーク環境では固定長の .Tn ASCII 文字)。 そうすれば、同名の バージョン 7 のプログラムと同じぐらいの速さで System V バージョンの柔軟性を持ったプログラムとなるでしょう。 .Pp .Nm -には、正確さよりも 速度を重視したアルゴリズムが +ユーティリティには、正確さよりも 速度を重視したアルゴリズムが いくつかあるので text ファイルの内容については 間違うことがあります。 .Pp text ファイルのサポート (元々はプログラミング言語のため) は 単純で、不十分であり、更新には再コンパイルが必要です。 .Pp 複数の行に渡るものをサポートするため .Ic else 項があるべきです。 .Pp マジックファイルと キーワードの正規表現を サポートするべきです。 .Tn "ASCII TAB" をフィールドの識別子にすることは醜く、 ファイルの編集を難しくしていますが、残されています。 .Pp キーワードに大文字を許すことが勧められます。たとえば、 .Xr troff 1 コマンドと man page マクロの区別です。 正規表現のサポートで、このことは簡単になるでしょう。 .Pp .Tn FORTRAN に対してプログラムが働きません。 行の先頭にインデントされているキーワードを見ることにより .Tn FORTRAN だと判別すべきです。 正規表現のサポートによりこれは簡単になるでしょう。 .Pp .Pa ascmagic に入っている キーワードのリストは、おそらく .Pa Magic ファイルに 入れるべきものです。 これはオフセットの値として .Sq Ic * のようなキーワードを 使うことで可能でしょう。 .Pp 最初の文字、最初の語、最初の long などに関する テストを 最初に読み込んだときに全て行うことができるよう マジックファイルを並べ直す最適化法はないだろうか。 マジックファイルの矛盾について述べるようにならないか。 エントリーの順序を マジックファイル上の位置ではなく、 ファイルオフセット順にすることはできないだろうか。 .Pp プログラムは、推定が .Dq どれぐらいよい のかを知る方法を 提供すべきです。ファイルの最初の 5 文字が .Dq Li "From " であるときに推測をしても、 .Dq Li "Newsgroups:" や .Dq Li "Return-Path:" といった文字による推測ほどよくはないので、推測結果を 捨てることになります。しかし、もしそういった文字が 現れなければ最初の推定を使わなければなりません。 .Pp このプログラムは、いくつかの商用の .Nm コマンドより遅いです。 複数の文字コードのサポートにより、より遅くなっています。 .Pp このマニュアルページ、特にこの節が長過ぎます。 .Sh 入手性 オリジナル作者の最新のバージョンを anonymous FTP で、 .Pa ftp.deshaw.com の .Pa /pub/file/file-X.YY.tar.gz から手に入れることができます。 diff --git a/ja_JP.eucJP/man/man1/find.1 b/ja_JP.eucJP/man/man1/find.1 index b85b753ae9..7e53a352f7 100644 --- a/ja_JP.eucJP/man/man1/find.1 +++ b/ja_JP.eucJP/man/man1/find.1 @@ -1,798 +1,798 @@ .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)find.1 8.7 (Berkeley) 5/9/95 -.\" %FreeBSD: src/usr.bin/find/find.1,v 1.23.2.16 2002/04/12 16:18:27 trhodes Exp % +.\" %FreeBSD: src/usr.bin/find/find.1,v 1.23.2.17 2002/06/20 23:45:55 charnier Exp % .\" .\" $FreeBSD$ .Dd May 3, 2001 .Dt FIND 1 .Os .Sh 名称 .Nm find .Nd ディレクトリツリーを再帰的に下ってファイルを捜す .Sh 書式 .Nm find .Op Fl H | Fl L | Fl P .Op Fl EXdsx .Op Fl f Ar pathname .Op Ar pathname ... .Ar expression .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar pathname に対してディレクトリツリーを再帰的に下って、 ツリー上の各ファイルについて .Ar expression (後に示す .Dq プライマリ と .Dq 演算子 から構成されます) で指定された処理を実行します。 .Pp オプションとしては以下のものがあります: .Bl -tag -width indent .It Fl E .Ic -regex および .Ic -iregex のオプションの後の正規表現を、 基本正規表現 (BRE) の代りに拡張 (最近の) 正規表現として解釈します。 .Xr re_format 7 マニュアルページは、両方のフォーマットを完全に解説しています。 .It Fl H .Ar file で指定したファイルがシンボリックリンクファイルだった場合、シンボリックリンク 自体ではなく、リンク先のファイルに関してファイル情報とファイルタイプ ( .Xr stat 2 参照) を使って .Ar expression の処理をするように指定します。 もしリンク先のファイルがなければ、 シンボリックリンク自体を処理の対象とします。 コマンドラインからの .Ar file で直接指定されたのではなく、 ディレクトリツリー上で見つかったシンボリックリンクファイルに関しては、 シンボリックリンク自体を処理の対象とします。 .It Fl L .Ar file で指定したファイルがシンボリックリンクファイルだった場合、シンボリックリンク 自体ではなく、リンク先のファイルに関してファイル情報とファイルタイプ ( .Xr stat 2 参照) を使って .Ar expression の処理をするように指定します。もしリンク先のファイルがな ければ、シンボリックリンク自体を処理の対象とします。 .It Fl P シンボリックリンク自体に関して ファイル情報とファイルタイプ ( .Xr stat 2 参照) を使って .Ar expression の処理をするように指定します。 これがデフォルトです。 .It Fl X .Xr xargs 1 と組み合わせて使うときのため、より安全に動作するようにします。もし .Xr xargs 1 によりデリミタ文字 (シングルクォート .Pq Dq Li " ' " 、ダブルクォート .Pq Dq Li " \*q " 、バックスラッシュ .Pq Dq Li \e 、スペース、タブ、改行) が含まれるファイル名 が使われた場合、診断メッセージを標準エラー出力に表示して、 そのファイル名をスキップします。 .Pp ちゃんと動作する代案として、 .Fl print0 プライマリを .Ql xargs -0 と共に使用することを検討すると良いかもしれません。 .It Fl d ファイルに対する処理順序を深さ優先の探索方式にします。 すなわち、ディレクトリ自体に 対する処理を行う前に、ディレクトリ内の個々のファイルに対して処理を 実行します。デフォルトでは、ディレクトリは最初に処理されます。 (デフォルトの方式は幅優先探索方式では .Em ない です。) .It Fl f Ar file 明示的にファイルを指定します。ファイル名の先頭が .Dq \- で始まっていたり、 あとで述べる .Ar expression の指定と混同してしまうようなファイル名を指定したりするときに使用します。 (ファイルはオプション直後のオペランドとしても指定可能です。) .It Fl s .Fl s オプションは、辞書編集上の順に、 すなわち各ディレクトリ内においてアルファベット順に、 ファイル階層を .Nm に辿らせます。 注: .Ql find -s と .Ql "find | sort" は異なった結果となる場合があります。 .It Fl x ディレクトリツリーを下って行くとき、最初に file のあったファイルシステムとは 異なるファイルシステム上のファイルに対する処理になる場合は、実行しないように します。 .El .Sh プライマリ .Bl -tag -width indent .It Ic -amin Ar n 最後にファイルがアクセスされた時刻と、 .Nm を起動した時刻との差 (1 分単位で切り上げます) が .Ar n 分であれば、真とします。 .It Ic -anewer Ar file .Ic -neweram と同じです。 .It Ic -atime Ar n 最後にファイルがアクセスされた時刻と、 .Nm を起動した時刻との差 (24 時間単位で切り上げます) が .Ar n 日であれば、真とします。 .It Ic -cnewer Ar file .Ic -newercm と同じです。 .It Ic -ctime Ar n 最後にファイルのステータスが変更された時刻と、 .Nm を起動した時刻の差 (24 時間単位で切り上げます) が .Ar n 日であれば、真とします。 .It Ic -delete 見付けたファイルやディレクトリを消去します。常に真を返します。 現在の作業ディレクトリから .Nm は再帰的にディレクトリツリーを下ります。 セキュリティ上の理由から、 .Dq Pa \&. からの相対パス名に .Dq Pa / 文字を含むファイル名のファイルを 消去しようとはしません。 このオプションにより暗示的に深さ優先の処理が指定されます。 .It Ic -depth 常に真です。 .Fl d オプションと同じです。 .Nm を .Xr cpio 1 と共に使用する場合、 普通ではないパーミッションのディレクトリ中のファイルを処理するために、 .Ic -depth が有用です。 .It Ic -empty 現在のファイルまたはディレクトリが空の場合、真となります。 .It Ic -exec Ar utility Op Ar argument ... ; .Ar utility で指定した名前のプログラムを実行し、終了コードが 0 の場合、真とします。 .Ar argument は、utility への引数として渡されます。 この指定は、最後に必ずセミコロン .Pq Dq Li \&; をつけてください。 utility もしくは argument の指定 のなかで .Dq Li {} が使われていた場合は、その部分が、現在 .Nm が対象としているファイルのパス名に置き換えられます。ただし、 .Ar utility が実行されるときのカレントディレクトリは、 .Nm が起動されたディレクトリのままです。 .Ar utility と .Ar arguments は、シェルのパターンと構造の更なる展開対象とはなりません。 .It Ic -execdir Ar utility Op Ar argument ... ; .Ic -execdir プライマリは .Ic -exec プライマリと同様ですが、 .Ar utility が現在のファイルを持つディレクトリにおいて実行される点が異なります。 文字列 .Dq Li {} に対して置換されるファイル名は適切ではありません。 .It Ic -flags Oo Cm - Ns | Ns Cm + Oc Ns Ar flags , Ns Ar notflags フラグは、シンボル名 ( .Xr chflags 1 参照) で指定します。 フラグの前に .Qq Li no を付けると ( .Qq Li nodump は除きます)、 .Ar notflags と呼ばれます。 .Ar flags にあるフラグは設定されていることが検査され、 .Ar notflags にあるフラグは設定されていないことが検査されます。 これは、設定されているモードビットのみをユーザが指定可能な .Ic -perm とは異なることに注意してください。 .Pp フラグの前にダッシュ .Pq Dq Li - が付く場合、このプライマリは、ファイルのフラグビットのうち少なくとも .Ar flags 中の全ビットが設定されていて、 .Ar notflags 中のどのビットも設定されていない場合に真になります。 フラグの前にプラス .Pq Dq Li + が付く場合、このプライマリは、ファイルのフラグビットのうち .Ar flags のいずれかのビットが設定されているか、 .Ar notflags のいずれかのビットが設定されていない場合に真になります。 どちらでもない場合、このプライマリは、 .Ar flags のビットがファイルのフラグビットに完全に適合し、 .Ar flags のいずれもが .Ar notflags に適合しない場合に真になります。 .It Ic -fstype Ar type 対象ファイルが格納されているファイルシステムのタイプが、 .Ar type で指定されたものである場合に真となります。 .Xr sysctl 8 コマンドを使用して、 システム上で利用可能なファイルシステムタイプを調べることができます: .Pp .Dl "sysctl vfs" .Pp さらに、2 つの 擬似タイプ .Dq Li local と .Dq Li rdonly があります。 前者は、 .Nm を実行しているシステム上に物理的にマウントされているファイルシステムです。 後者は、読み取り専用でマウントされているファイルシステムです。 .It Ic -group Ar gname ファイルが .Ar gname で指定したグループに属している場合、真になります。 .Ar gname が数字で、そのようなグループ名がない場合は、 .Ar gname をグループ ID として扱います。 .It Ic -iname Ar pattern .Ic -name に似ていますが、大文字小文字を区別せずにマッチします。 .It Ic -inum Ar n ファイルの inode 番号が .Ar n なら、真になります。 .It Ic -ipath Ar pattern .Ic -path に似ていますが、大文字小文字を区別せずにマッチします。 .It Ic -iregex Ar pattern .Ic -regex に似ていますが、大文字小文字を区別せずにマッチします。 .It Ic -links Ar n ファイルのリンク数が .Ar n なら、真になります。 .It Ic -ls このプライマリは常に真になります。対象となっているファイルの情報を 標準出力に出力します。出力する内容は inode 番号、 512 バイトブロックでのファイルの大きさ、 ファイルのパーミッション、ハードリンクの数、所有者、グループ、 バイトで表したファイルの大きさ、最後にファイルが修正された時刻、パス名です。 ファイルがブロック型もしくはキャラクタ型の特殊ファイルならば、 バイトで表したファイルの大きさの代わりにメジャー番号とマイナー番号を 出力します。ファイルがシンボリックリンクならば、 .Dq Li -> の後にリンク先のファイルのパス名を表示します。 フォーマットは .Bk -words .Nm ls Fl dgils .Ek の出力結果と同じです。 .It Ic -maxdepth Ar n 現在のファイルのツリーにおける深さが .Ar n 以下である場合、真になります。 .It Ic -mindepth Ar n 現在のファイルのツリーにおける深さが .Ar n 以上である場合、真になります。 .It Ic -mmin Ar n 最後にファイルが修正された時刻と、 .Nm を起動した時刻との差 (1 分単位で切り上げます) が .Ar n 分であれば、真とします。 .It Ic -mnewer Ar file .Ic -newer と同じです。 .It Ic -mtime Ar n 最後にファイルが修正された時刻と、 .Nm を起動した時刻との差(24 時間単位で切り上げます)が .Ar n 日であれば、真とします。 .It Ic -name Ar pattern 対象ファイルのパス名の最後のファイル名部分が .Ar pattern で指定したものとマッチするかどうかを調べ、マッチした場合は真になります。 .Ar pattern としては、シェルで使われるパターンマッチ 指定 ( .Dq Li \&[ , .Dq Li \&] , .Dq Li * , .Dq Li \&? ) を使用することができます。これらの文字は バックスラッシュ .Pq Dq Li \e を前において、パターンマッチ指定ではなく文字として 扱う事を明示することができます。 .It Ic -newer Ar file 対象ファイルの修正日付が、 .Ar file で指定したファイルのものより新しい場合は、真になります。 .It Ic -newer Ns Ar X Ns Ar Y Ar file 現在のファイルの最終アクセス時刻 .Ar ( X Ns = Ns Cm a ) ・ステータス修正時刻 .Ar ( X Ns = Ns Cm c ) ・内容修正時刻 .Ar ( X Ns = Ns Cm m ) が、 .Ar file の最終アクセス時刻 .Ar ( Y Ns = Ns Cm a ) ・ステータス修正時刻 .Ar ( Y Ns = Ns Cm c ) ・内容修正時刻 .Ar ( Y Ns = Ns Cm m ) より新しい場合は、真となります。 さらに .Ar Y Ns = Ns Cm t の場合、 .Ar file は代りに、 .Xr cvs 1 が理解する直接的な時刻指定として解釈されます。 .Ic -newermm は .Ic -newer と同じであることに注意してください。 .It Ic -nogroup 対象ファイルのグループが unknown の場合、真になります。 .It Ic -nouser 対象ファイルの所有者が unknown の場合、真になります。 .It Ic -ok Ar utility Op Ar argument ... ; .Ic -ok プライマリは .Ic exec とほぼ同じですが、 .Ar utility を実行するかどうかの確認をユーザに求め、端末にメッセージを出力します。 .Dq Li y 以外の返答をした場合は、 コマンドは実行されず、 .Ic -ok 式の値は偽になります。 .It Ic -okdir Ar utility Op Ar argument ... ; .Ic -okdir プライマリは、 .Ic -execdir プライマリと同様ですが、 .Ic -ok プライマリの解説に該当する部分が異なります。 .It Ic -path Ar pattern 対象ファイルのパス名が、 .Ar pattern で指定したものとマッチす るかどうかを調べます、マッチした場合は真になります。 .Ar pattern としては、シェルで使われるパターンマッチ指定 ( .Dq Li \&[ , .Dq Li \&] , .Dq Li * , .Dq Li \&? ) を使用することができます。これらの文字は バックスラッシュ .Pq Dq Li \e を前において、パターンマッチ指定ではなく文字として 扱う事を明示することができます。 .Pq Dq Li / は、そのままパスのディレクトリの区切りにマッチします。 .It Ic -perm Oo Cm - Ns | Ns Cm + Oc Ns Ar mode ファイルのモードを、 .Ar mode と比較します。 .Ar mode は、シンボル 形式 ( .Xr chmod 1 参照) もしくは 8 進数形式で指定します。 .Ar mode がシンボル形式の場合は、 .Ar mode は 00000 から開始してパーミッションのセットとクリアを行います。 (プロセスのファイル生成マスクとは無関係です。) .Ar mode が 8 進数形式の場合は、 ファイルのモードビットのうち、07777 .Pq Dv S_ISUID | S_ISGID | S_ISTXT | S_IRWXU | S_IRWXG | S_IRWXO の部分が比較対象になります。 .Ar mode の最初にダッシュ .Pq Dq Li - を指定した場合は、 .Ar mode でセットされているすべてのビットが ファイルのモードでもセットされていれば、このプライマリは真となります。 .Ar mode の最初にプラス .Pq Dq Li + を指定した場合は、 .Ar mode でセットされているビットのどれかがファイルのモードでもセットされていれば、 このプライマリは真となります。 どちらでもない場合、ファイルのモードと .Ar mode が完全に一致した場合にのみ真となります。 なお、 シンボル形式でモード指定をする場合は、少なくとも最初がダッシュ .Pq Dq Li - にならない ようにする必要があります。 .It Ic -print このプライマリは常に真になります。 対象となっているファイルのパス名を標準出力に出力して改行します。 .Ic -exec , -ls , -print0 , .Ic -ok のどのプライマリも指定されなかった場合は、 与えられた式 given expression は .Cm \&( Ar "given expression" Cm \&) Ic -print で置き換えられます。 .It Ic -print0 .Ic -print とほぼ同じですが、標準出力に対象となっているファイルのパス名を出力 したあと、改行ではなく、 .Tn ASCII NUL 文字 (文字コード 0) を出力します。 .It Ic -prune このプライマリは常に真になります。 対象となっているファイル配下のディレクトリに下りないようにします。 .Fl d オプションが指定されている場合は、 .Ic -prune の指定は無効になります。 .It Ic -regex Ar pattern ファイルのパス全体が、正規表現 .Ar pattern にマッチする場合、真になります。 ファイル名 .Dq Pa ./foo/xyzzy にマッチさせるには、 正規表現 .Dq Li ".*/[xyz]*" や .Dq Li ".*/foo/.*" が使えますが、 .Dq Li xyzzy や .Dq Li /foo/ は使えません。 .It Ic -size Ar n Ns Op Cm c ファイルサイズを 512 バイトのブロック単位で数えたとき (端数は切り上げ)、 .Ar n ブロックであれば真になります。 .Ar n のあとに .Cm c が指定されていた場合は、ファイルサイズが .Ar n バイト (文字) であれば真になります。 .It Ic -type Ar t ファイルタイプが .Ar t で指定されたタイプに一致すれば真になります。 タイプとして、次のような指定が可能です: .Pp .Bl -tag -width indent -compact .\" jpman project では special file を「特殊ファイル」と訳している。 .\" これにあわせて block special を「ブロックスペシャル」ではなく .\" 「ブロック特殊」とするのは違和感があるので、「ファイル」を補った。 .\" Kazuo Horikawa 1999/03/10 .It Cm b ブロック型特殊ファイル .It Cm c キャラクタ型特殊ファイル .It Cm d ディレクトリ .It Cm f 普通のファイル .It Cm l シンボリックリンク .It Cm p FIFO .It Cm s ソケット .El .It Ic -user Ar uname ファイルの所有者が、 .Ar uname で指定されたユーザと一致すれば真になります。もし .Ar uname が数字で、そのようなユーザ名がなければ、 ユーザ ID が指定されたものとして扱います。 .El .Pp なお、数字を引数にとるプライマリは、 数字の前にプラス .Pq Dq Li + およびマイナス .Pq Dq Li \- をつけることができます。 それぞれ .Dq n より大 および .Dq n より小 の意味になり、 .Dq 正確に n という意味ではなくなります。 .Sh 演算子 以下の演算子を使って、プライマリを組み合わせることができます。 演算子は優先度が下がる順番で示されています。 .Pp .Bl -tag -width "( expression )" -compact .It Cm \&( Ar expression Cm \&) もし、括弧内の .Ar expression が真なら、真になります。 .Pp .It Cm \&! Ar expression 単項否定演算子 ( .Tn NOT ) です。 .Ar expression が偽なら、真となります。 .Pp .It Ar expression1 Cm -and Ar expression2 .It Ar expression1 expression2 論理積 ( .Tn AND ) 演算子です。 .Ar expression1 と .Ar expression2 の両方とも真のとき、真になります。 もし .Ar expression1 が偽なら、 .Ar expression2 は実行されません。 .Ic -and を書かずに、単に 2 つの expression を並べて .Pp .Ar expression1 expression2 .Pp と書いても同じです。 .Pp .It Ar expression1 Cm -or Ar expression2 論理和 ( .Tn OR ) 演算子です。 .Ar expression1 か .Ar expression2 のどちらか一方でも真であれば、真になります。もし .Ar expression1 が真なら、 .Ar expression2 は実行されません。 .El .Sh 使用例 コマンドラインからのタイプ例です。 .Bl -tag -width indent .It Li "find / \e! -name \*q*.c\*q -print" ファイル名の終わりが .Pa \&.c でない全ファイルを表示します。 .It Li "find / -newer ttt -user wnj -print" .Pa ttt というファイルより新しく 所有者が .Dq wnj である全ファイルを表示します。 .It Li "find / \e! \e( -newer ttt -user wnj \e) -print" .Pa ttt というファイルより古く所有者が .Dq wnj であるという条件が成立しない、全ファイルを表示します。 .It Li "find / \e( -newer ttt -or -user wnj \e) -print" .Pa ttt というファイルより新しいか、 所有者が .Dq wnj である、全ファイルを表示します。 .It Li "find . -newerct '1 minute ago' -print" inode 修正時刻が現在から 1 分以内の全ファイルを表示します。 .El .Sh 関連項目 .Xr chflags 1 , .Xr chmod 1 , .Xr cvs 1 , .Xr locate 1 , .Xr whereis 1 , .Xr which 1 , .Xr xargs 1 , .Xr stat 2 , .Xr fts 3 , .Xr getgrent 3 , .Xr getpwent 3 , .Xr strmode 3 , .Xr re_format 7 , .Xr symlink 7 .Sh 規格 .Nm ユーティリティの文法は .St -p1003.2 の仕様で決められた文法のスーパセットです。 全 1 文字オプションと .\" .Ic -iname , -inum , -iregex , -print0 , -delete , -ls , .\" ja-groff-0.100_3 で整形できないためマクロ使用方法を変えています .Ic -iname , .Ic -inum , .Ic -print0 , .Ic -delete , .Ic -ls , .Ic -regex のプライマリは .St -p1003.2 の拡張です。 .Pp 昔は .Fl d , h , x のオプションは それぞれ .Ic -depth , -follow , -xdev のプライマリを 用いて実装されていました。 これらのプライマリは常に真に評価されていました。 これらのプライマリは 探索が始まる前に効果を与える本当のグローバル変数であったので、 いくつかの合法的な expression が予期しない結果となりました。 一例として .Ic -print Cm -o Ic -depth の expression があります。 .Ic -print が常に真に評価されるため 標準の評価の順番では .Ic -depth は決して評価されないはずですが、 そうではありませんでした。 .Pp 演算子の .Cm -or は .Cm -o として実装されていました。 演算子の .Cm -and は .Cm -a として実装されていました。 .Pp 昔の実装では .Ic exec と .Ic -ok のプライマリでは、 tility 名やその引数中において、 空白以外の文字が前後に続く .Dq Li {} を置き換えませんでした。 このバージョンでは utility 名やその引数のどの場所に .Dq Li {} が現れても 置き換えます。 .Pp .Fl E オプションは、 .Xr grep 1 および .Xr sed 1 の類推から実装されました。 .Sh バグ .Nm によって使われる特殊文字は多くのシェルにとっても 特殊文字です。 特に .Dq Li * , .Dq Li \&[ , .Dq Li \&] , .Dq Li \&? , .Dq Li \&( , .Dq Li \&) , .Dq Li \&! , .Dq Li \e , .Dq Li \&; は、 シェルからエスケープされなくてはならないでしょう。 .Pp オプションとファイル名との間および ファイル名と .Ar expression との間を区切るデリミタが存在しませんので、 ファイル名にオプションと間違えるようなもの ( .Pa -xdev のようなもの) や、 .Ar expression と間違えるようなもの ( .Pa \&! のようなもの) を指定することは難しいです。 このようなファイル名を指定する場合は .Fl f オプションを使うか、 .Xr getopt 3 で使われるオプション指定の終了記号 .Dq Fl Fl を使用します。 .Pp .Ic -delete プライマリは、ファイルシステムツリーの検索順序に影響する 他のオプションとは十分には連係しません。 .Sh 歴史 .Nm コマンドは .At v1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/finger.1 b/ja_JP.eucJP/man/man1/finger.1 index 007f470cdc..6ce09a3338 100644 --- a/ja_JP.eucJP/man/man1/finger.1 +++ b/ja_JP.eucJP/man/man1/finger.1 @@ -1,226 +1,225 @@ .\" Copyright (c) 1989, 1990, 1993, 1994 .\" The Regents of the University of California. 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 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. .\" .\" @(#)finger.1 8.3 (Berkeley) 5/5/94 -.\" %FreeBSD: src/usr.bin/finger/finger.1,v 1.9.2.8 2002/04/06 05:39:22 dd Exp % +.\" %FreeBSD: src/usr.bin/finger/finger.1,v 1.9.2.9 2002/06/20 23:45:58 charnier Exp % .\" $FreeBSD$ .\" .Dd August 1, 1997 .Dt FINGER 1 .Os .Sh 名称 .Nm finger .Nd ユーザ情報を調べるプログラム .Sh 書式 .Nm finger .Op Fl lmpshoT .Op Ar user ...\& .Op Ar user@host ...\& .Sh 解説 .Nm -はシステムのユーザに関する情報を表示します。 +ユーティリティはシステムのユーザに関する情報を表示します。 .Pp オプションは以下の通りです: .Bl -tag -width flag .It Fl s -.Nm -はユーザのログイン名、本名、端末名、端末への書き込み +ユーザのログイン名、本名、端末名、端末への書き込み 状態 (書き込みが不可の場合は、端末名の前に ``*'' が付きます)、 アイドル時間、ログイン時間、また、オフィスの所在地と電話番号もしくは リモートホスト名を表示します。 .Fl o が指定されていた場合 (デフォルト) は、 オフィスの所在地と電話番号が表示されます。 .Fl h が指定されていた場合は、代わりに、リモートホスト名が表示されます。 .Pp アイドル時間の単位は、数字だけの場合は 何分か、``:'' がある場合は何時間何分か、``d'' がある場合は何日か、です。 アイドル時間が .Dq * の場合、ログイン時間は最後のログイン時間を示します。 ログイン時間は、6 日以内の場合は何曜日の何時何分からか、それ以上の 場合は何月何日の何時何分からかが表示されます。もし 6 ヶ月を超えて いる場合は、何年何月何日からかが表示されます。 .Pp アイドル時間やログイン時間がない場合と同様に、 不明なデバイスは一つのアスタリスクとして表示されます。 .Pp .It Fl h .Fl s オプションと共に指定されたとき、オフィスの所在地と電話番号の代わりに リモートホスト名を表示します。 .Pp .It Fl o .Fl s オプションと共に指定されたとき、リモートホスト名の代わりに オフィスの所在地と電話番号を表示します。 .Pp .It Fl l ユーザのホームディレクトリ、自宅の電話番号、ログインシェル、 メールの状態、そしてユーザのホームディレクトリの .Dq Pa .forward , .Dq Pa .plan , .Dq Pa .project の内容に加えて、 .Fl s オプションの解説で述べた情報全てが複数行にわたる形式で出力されます。 .Pp アイドル時間は 1 分以上 1 日以内の場合は、``hh:mm'' の形式となります。 1 日よりも大きいときには、``d day[s]hh:mm'' の形式となります。 .Pp 電話番号は、11 桁の場合には ``+N-NNN-NNN-NNNN'' と表示 されます。10 桁もしくは 7 桁の場合には、上の文字列の適切な 部分として表示されます。5 桁の場合は ``xN-NNNN''、 4 桁の場合は ``xNNNN'' と表示されます。 .Pp デバイスの書き込み許可がない場合、デバイス名を含む 行に ``(messages off)'' という語句が追加されます。 .Fl l オプションを指定すると、1 人のユーザにつき 1 つの項目が表示されます。 もしあるユーザが複数回ログインしている場合には、端末の情報は その各ログインについて表示されます。 .Pp メールの状態は、全くメールがない場合には ``No Mail.''、その人が自分の メールボックスに届いた新着メールを全て読んでいた場合 には ``Mail last read DDD MMM ## HH:MM YYYY (TZ)''、その人あての新着 メールがあれば ``New mail received ...'' や ``Unread since ...'' の ように表示されます。 .Pp .It Fl p オプションは、 .Nm の .Fl l オプションが、 .Dq Pa .forward , .Dq Pa .plan , .Dq Pa .project のファイルの内容を表示するのを抑制します。 .It Fl m ユーザの本名と .Ar user とが名前の比較で一致しないようにします。 .Ar user は、たいていはログイン名なのですが、 .Fl m オプションを指定しない限り、ユーザの本名との比較もまた行われてしまいます。 .Nm によって比較される名前は、大文字小文字を区別しません。 .Pp .It Fl T 最初の接続要求において、データをピギーバックしません。 このオプションは,いい加減な TCP の実装が行われている ホストに finger を行う時に必要です。 .El .Pp オプションが指定されなかった場合は、 .Nm は、対象が与えられた場合は .Fl l の出力形式、与えられなかった場合は .Fl s の出力形式をデフォルトの形式とします。 どちらの形式であったとしても、情報が有効でなかった場合には、その フィールドは欠けているかもしれないことに注意してください。 .Pp 引数が全く指定されていない場合は、 .Nm は、現在システムにログインしている各ユーザについての情報を表示します。 .Pp .Nm -は、リモートマシン上のユーザを調べることにも利用できます。 +ユーティリティは、リモートマシン上のユーザを調べることにも利用できます。 これには、 .Ar user として .Dq Li user@host もしくは .Dq Li @host と指定する形式を使います。デフォルトでは、前者は .Fl l 形式の出力、後者は .Fl s 形式の出力となります。 .Fl l オプションは、リモートマシンに渡される唯一のオプションかも知れません。 .Pp もし、ユーザのホームディレクトリに .Dq Pa .nofinger というファイルが存在した場合、 .Nm は、そのユーザが存在していないかのように振る舞います。 .Pp オプションの .Xr finger.conf 5 設定ファイルを使用して、別名を指定可能です。 .Xr finger 1 は .Xr fingerd 8 が起動しますので、 ローカルの問い合わせとネットワークの問い合わせの両方で有効です。 .Sh 環境変数 .Nm -は、もし設定されていれば、以下の環境変数を利用します: +ユーティリティは、もし設定されていれば、以下の環境変数を利用します: .Bl -tag -width Fl .It Ev FINGER .Nm に好みのオプションがあれば、この環境変数に設定しておくとよいでしょう。 .El .Sh 関連ファイル .Bl -tag -width /var/log/lastlog -compact .It Pa /etc/finger.conf 別名定義のデータベース .It Pa /var/log/lastlog 最後にログインした時間のデータベース .El .Sh 関連項目 .Xr chpass 1 , .Xr w 1 , .Xr who 1 , .Xr finger.conf 5 , .Xr fingerd 8 .Rs .%A D. Zimmerman .%T The Finger User Information Protocol .%R RFC 1288 .%D December, 1991 .Re .Sh 歴史 .Nm コマンドは、 .Bx 3.0 で登場しました。 .Sh バグ 現在の FINGER プロトコルの RFC では、 サーバが接続を閉じるまでクライアントはフルに接続をオープンする必要があります。 これでは、最適な 3 パケット T/TCP 交換を妨げてしまいます。 (この仕様に依存するサーバは壊れていますが、 広いインターネットにはこのようなサーバが存在します。) diff --git a/ja_JP.eucJP/man/man1/fmt.1 b/ja_JP.eucJP/man/man1/fmt.1 index affd6bd255..e4db22cb62 100644 --- a/ja_JP.eucJP/man/man1/fmt.1 +++ b/ja_JP.eucJP/man/man1/fmt.1 @@ -1,171 +1,171 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)fmt.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/fmt/fmt.1,v 1.7.2.2 2002/01/14 09:48:26 ru Exp % +.\" %FreeBSD: src/usr.bin/fmt/fmt.1,v 1.7.2.3 2002/06/21 15:26:55 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt FMT 1 .Os .Sh 名称 .Nm fmt .Nd 簡単なテキストフォーマッタ .Sh 書式 .Nm fmt .Op Fl cmnps .Op Fl d Ar chars .Op Fl l Ar num .Op Fl t Ar num .Op Ar goal Oo Ar maximum Oc | Fl Ns Ar width | Fl w Ar width .Op Ar .Sh 解説 .Nm -は簡単なテキストフォーマットプログラムです。 +ユーティリティは簡単なテキストフォーマットプログラムです。 引数として name が指定されていればその名前のファイルを、 指定されていなければ標準入力を読み込み、 入力した行を次々に連結していき、 .Ar maximum を超えない範囲で、 .Ar goal で指定した長さに近い文字数に整形します。 デフォルトでは、 .Ar goal の長さは 65、 .Ar maximum の長さは .Ar goal に 10 を加えたものです。 または、前にハイフンを付けるか .Fl w を使用することにより、単一の .Ar width パラメータを指定可能です。 例えば、 .Dq Li fmt -w 72 , .Dq Li fmt -72 , .Dq Li fmt 72 72 は同じ出力となります。 入力行の先頭に空白 がある場合は、整形した出力の先頭にも空白が置かれ段づけされます。 また、空白行や、文字と文字の間の空白の数も、出力に受け継がれます。 行が結合されたり分割されるのは、空白においてのみです。 つまり、複数の単語が結合されたりハイフネーションされることはありません。 .Pp オプションは次の通りです: .Bl -tag -width indent .It Fl c テキストを中央寄せさせます。 この場合、他のほとんどのオプションは無視されます。 行の分割や結合は行われません。 .It Fl m 入力に含まれるメールヘッダ行を目立つように整形しようとします。 .It Fl n .Ql \&. (ドット) 文字で開始する行を整形します。 通常では、 .Nm は、 .Xr nroff 1 との互換性のために、このような行を詰めます。 .It Fl p インデントされた段落を許します。 .Fl p フラグ無しでは、行頭の空白数が変わると、新規段落が開始します。 .It Fl s 行中の空白を潰し、複数の空白文字が単一の空白となるようにします (文末では、二つの空白となります)。 .It Fl d Ar chars .Ar chars を文末文字として認識します (他の文字はそうでないと認識します)。 デフォルトでは、文末文字は終止符 .Pq Ql \&. 疑問符 .Pq Ql \&? 感嘆符 .Pq Ql \&! です。 文字によっては、シェルから守るために、 エスケープが必要であることを覚えておいてください。 .It Fl l Ar number 各出力行の先頭の複数の空白をタブで置き換えます。 各 .Ar number 個の空白が、単一のタブで置き換えられます。 デフォルトは 8 です。 .Ar number が 0 である場合、空白は維持されます。 .It Fl t Ar number 入力ファイルのタブが、 .Ar number 個の空白をタブストップに仮定していると仮定します。 デフォルトは 8 です。 .El .Pp .Nm -は、メールメッセージを送信する前に整形するために役立ちますが、 +ユーティリティは、メールメッセージを送信する前に整形するために役立ちますが、 他の簡単なタスクのためにも使うことができます。たとえば、 .Xr ex 1 のビジュアルモード(すなわち .Xr vi 1 ) のなかで、次のコマンドを入力すると、 パラグラフを整形してくれます。 .Pp .Dl \&!}fmt .Sh 関連項目 .Xr mail 1 , .Xr nroff 1 .Sh 歴史 .Nm コマンドは .Bx 3 から登場しました。 .Pp このバージョンは完全に書き直したもので、 .Fx 4.4 に登場しました。 .Sh 作者 .An Kurt Shoens .An Liz Allen .Pf ( Ar goal の長さの概念を導入) .An Gareth McCaughan .Sh バグ このプログラムは、簡単で高速であるようにデザインされました。もっと複雑 な整形には、標準的なテキストプロセッサを使うのが適しています。 .Pp インデントされた段落の最初の行がとても長い場合 (goal の長さの 2 倍よりも長い場合)、 出力のインデントが誤りとなる可能性があります。 .Pp どの行がメールヘッダでありどれがそうでないかの判断を、 .Nm -が絶対に間違えないということはありません。 +ユーティリティが絶対に間違えないということはありません。 diff --git a/ja_JP.eucJP/man/man1/fold.1 b/ja_JP.eucJP/man/man1/fold.1 index e1a6f22965..660bfd7a7b 100644 --- a/ja_JP.eucJP/man/man1/fold.1 +++ b/ja_JP.eucJP/man/man1/fold.1 @@ -1,69 +1,82 @@ .\" Copyright (c) 1980, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)fold.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/fold/fold.1,v 1.3.2.4 2001/12/14 15:53:30 ru Exp % +.\" %FreeBSD: src/usr.bin/fold/fold.1,v 1.3.2.5 2002/06/17 11:24:21 tjr Exp % .\" .\" $FreeBSD$ .\" -.Dd June 6, 1993 +.Dd April 17, 2002 .Dt FOLD 1 .Os .Sh 名称 .Nm fold .Nd 有限桁の出力デバイスのために長い行を折り返すフィルタ .Sh 書式 .Nm +.Op Fl bs .Op Fl w Ar width .Op Ar .Sh 解説 .Nm -は、file が指定されていればそのファイルを、 +ユーティリティは、file が指定されていればそのファイルを、 指定されていなければ標準入力を読み込み、 指定された長さを超えるような入力行に対しては改行を入れて複数の行に分割します。 デフォルトでは 80 文字になるようにします。 .Pp オプションとしては以下のものがあります: .Bl -tag -width indent +.It Fl b +.Ar width +を、カラム位置ではなく、バイト位置として数えます。 +.It Fl s +最初の +.Ar width +カラム位置 (またはバイト数) 以内の最期の空白の後に、行を折り返します。 .It Fl w Ar width デフォルトの 80 文字のかわりに、一行の長さを指定します。 タブがある場合は、 .Ar width として 8 の倍数を指定するか、さもなければ、 .Nm の前に .Xr expand 1 を使用して、タブを空白文字に置き換えてください。 .El .Sh 関連項目 .Xr expand 1 +.Sh 規格 +.Nm +ユーティリティは、 +.St -p1003.1-2001 +に適合しています。 .Sh バグ アンダラインがある場合には、fold がうまくいかないことがあります。 diff --git a/ja_JP.eucJP/man/man1/fontedit.1 b/ja_JP.eucJP/man/man1/fontedit.1 index 69955382cd..3f13912568 100644 --- a/ja_JP.eucJP/man/man1/fontedit.1 +++ b/ja_JP.eucJP/man/man1/fontedit.1 @@ -1,85 +1,85 @@ -.\" %FreeBSD: src/usr.sbin/pcvt/fontedit/fontedit.1,v 1.4.2.1 2001/01/17 09:19:21 ru Exp % +.\" %FreeBSD: src/usr.sbin/pcvt/fontedit/fontedit.1,v 1.4.2.2 2002/06/21 16:41:05 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/fontedit.1,v 1.4 2001/05/14 01:07:23 horikawa Exp $ +.\" $FreeBSD$ .Dd January 16, 2001 .Dt FONTEDIT 1 .Os .Sh 名称 .Nm fontedit .Nd フォントを編集する .Sh 書式 .Nm .Ar file .Sh 解説 .Nm -は、 +ユーティリティは、 .Tn VT220 端末のダウンライン再読み込み可能文字集合 (DRCS) を 編集するために使われます。エディタは二つのディスプレイ領域からできています。 一方は現在操作しているものを表示し、もう一方は完全な DRCS を表示します。エディタに対するコマンドはファンクションキーで与えます。 .Pp .Nm -は、コマンドライン引数として +ユーティリティは、コマンドライン引数として .Ar file 名を取ります。 このファイルは、文字集合を保存するために使われます。 .Nm が立ち上げられた時にファイルが存在していれば、 DRCS を初期化するために読み込まれます。 .Nm が終了する時には、そのファイルに書き込まれます。 .Pp .Nm に対するコマンドはファンクションキーの形式で与えます。 現在の定義は以下の通りです。 .Bl -tag -width "Cursors" .It Ic HELP ヘルプ画面を表示します。 .It Ic F6 カーソルのある場所の画素をオンにします。 .It Ic F7 カーソルがある場所の画素をオフにします。 .It Ic F13 文字表示領域を消去します。 .It Ic Find フォントテーブル内の現在のフォントを保存します。 DRCS 表示を更新します。 .It Ic Select DRCS 表示のカーソルで選択された文字を文字領域に取り出します。 .It Ic Prev DRCS 表示領域で一つ前の文字にカーソルを移動します。 .It Ic Next DRCS 表示領域で次の文字にカーソルを移動します。 .It Ic Insert 現在のカーソル位置に空行を挿入します。一番下の行は失われます。 .It Ic Remove 現在のカーソル位置の行を抹消します。 その位置の下の方にある全ての行は一つ上にシフトされます。 .It Ic Cursors 主表示領域のカーソルを動かします。 .El .Pp 画面が変になった場合は、 .Aq control-L を押してください。 .Pp .Nm の終了には .Aq control-D を押してください。 DRCS は .Ar file に保存されます。 DRCS を保存せずに終了するためには、(普通は DEL になっている) 中断キーを 押してください。 .Sh 診断 .Nm -は、文字に変更が加えられた時に保存しないと警告を発します。 +ユーティリティは、文字に変更が加えられた時に保存しないと警告を発します。 また、 .Ic Select を使う時のようないくつかの破壊的な能力のある コマンドが使われた時も警告を発します。コマンドを実行するためには、 コマンドを再発行する必要があります。 .Sh 作者 .An Greg Franks diff --git a/ja_JP.eucJP/man/man1/fstat.1 b/ja_JP.eucJP/man/man1/fstat.1 index 730455c251..52d6597ec7 100644 --- a/ja_JP.eucJP/man/man1/fstat.1 +++ b/ja_JP.eucJP/man/man1/fstat.1 @@ -1,231 +1,231 @@ .\" Copyright (c) 1987, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)fstat.1 8.3 (Berkeley) 2/25/94 -.\" %FreeBSD: src/usr.bin/fstat/fstat.1,v 1.9.2.6 2002/04/16 19:53:35 charnier Exp % +.\" %FreeBSD: src/usr.bin/fstat/fstat.1,v 1.9.2.7 2002/06/21 15:26:59 charnier Exp % .\" $FreeBSD$ .\" .Dd February 25, 1994 .Dt FSTAT 1 .Os .Sh 名称 .Nm fstat .Nd ファイルのステータスを表示する .Sh 書式 .Nm .Op Fl fmnv .Op Fl M Ar core .Op Fl N Ar system .Op Fl p Ar pid .Op Fl u Ar user .Op Ar .Sh 解説 .Nm -は、現在オープンされているファイルについての情報を表示します。 +ユーティリティは、現在オープンされているファイルについての情報を表示します。 オープンされているファイルとは、プロセスによって明示的にオープンされている もの、ワーキングディレクトリ、ルートディレクトリ、アクティブな実行可能 テキストや、カーネルのトレースファイルなどを指します。引数が何も与え られなければ、 .Nm はシステム中でオープンされているすべてのファイルについての情報を表示します。 .Pp オプション: .Bl -tag -width Ds .It Fl f 表示する情報を、 .Ar filename で指定されたファイルと同じファイルシステム のものに制限します。引数が指定されていない場合は、カレントディレクトリ を含むファイルシステムのものに制限されます。たとえば、 .Pa /usr/src 以下のディレクトリでオープンされているすべてのファイルを見つけるには、 .Dq Li fstat -f /usr/src としてください。 .\" FreeBSD 2.1.0R 英語版マニュアルでは、以下で引数 core を明記していない .\" が、明らかにこれでも妥当だと考えられる。 .\" これ以降でも同様の部分がいくつか存在する。 -- jpman Sakai .\"(訳中)同様のこと確認しました。そのままにしてあります。 .\" 2.2.1R 対象(1997/05/17) Takeshi MUTOH .It Fl M Ar core 名前に関するリストから値を取り出す際、デフォルトの .Pa /dev/kmem のかわりに .Ar core を使います。 .It Fl N Ar system 名前のリストを取り出す際、デフォルトの .Pa /kernel のかわりに .Ar system を使います。 .It Fl m メモリマップされたファイルをリストに含めます。 更なる処理が必要であるため、通常はこれらは除外されています。 .It Fl n 数値フォーマットで表示を行います。マウントポイントの名前を表示する かわりに、そのファイルシステムにおけるデバイス番号 (メジャー、マイナー) を表示します。特殊ファイルに関しては、 .Pa /dev の下のファイル名 は参照されず、特殊デバイスのデバイス番号が表示されます。また、 ファイルの属性も記号ではなく、8 進数で表示されます。 .It Fl p Ar pid 指定されたプロセス ID のプロセスによってオープンされているすべてのファイル の情報を表示します。 .It Fl u Ar user 指定されたユーザによってオープンされているすべてのファイル の情報を表示します。 .It Fl v 詳細報告モード。システムのデータ構造体を見つけるのに失敗した場合などに エラーメッセージを表示します (デフォルトでは無視します)。これらの 構造体の多くは、動的に生成されたり消去されたりするもので、 .Nm を実行中に 消えてしまう可能性があります。これは、 .Nm 実行中にも、システム の残りの部分が動いているためで、ごく普通のことですし、避けることはできません。 .It Ar 表示する情報を、指定されたファイル .Ar filename に限定します。 .El .Pp 以下のような項目が表示されます。 .Bl -tag -width MOUNT .It Li USER プロセスの所有者のユーザ名 (実効ユーザ ID のものが表示されます) .It Li CMD プロセスのコマンド名 .It Li PID プロセスID .It Li FD プロセスごとのオープンしているファイルのファイル番号、もしくは 以下の特別な名前のどれかです。 .Pp .Bd -literal -offset indent -compact text - 実行可能テキストの inode wd - 現在のワーキングディレクトリ root - ルートの inode tr - カーネルトレースファイル mmap - メモリマップされたファイル .Ed .Pp ファイル番号のあとにアスタリスク記号 ``*'' がある場合は、ファイルは inode ではなく、ソケットや .Tn FIFO であったり、そのファイルにエラーがあるのかもしれません。この 場合、残りの行は後ろのヘッダと一致しません。 -- 行のフォーマットは、 .Sx ソケット のところで説明します。 .It Li MOUNT .Fl n オプションが指定されていなければ、このヘッダが現れます。 マウントされているパス名は、ファイルが存在しているファイルシステムです。 .It Li DEV .Fl n が指定されると、このヘッダが現れます。ファイルが存在しているデバイス のメジャー番号とマイナー番号です。 .Pp .It Li SZ\&|DZ ファイルがキャラクタデバイスファイルやブロックデバイスファイルでなけ れば、そのファイルのバイト数を表示します。デバイスファイルあって .Fl n が 指定されていなければ、その特殊ファイルの .Pa /dev における名前を表示します。 .Pa /dev になかったり、 .Fl n が指定されていたりする と、スペシャルデバイスが参照するメジャー番号、マイナー番号を表示します。 .It Li R/W このフィールドには、ファイルのアクセス属性が表示されます。 ``r'' の場合は、ファイルが読み込みのためにオープンされていることを意味します。 ``w'' の場合は、ファイルが書き込みのためにオープンされていることを意味します。 このフィールドは、ファイルシステムを読み込み専用状態に移行する際に、 それを妨げているプロセスを見つける場合に役に立ちます。 .It Li NAME .Ar filename が指定されていて、 .Fl f が指定されていなければ、この フィールドが表示され、指定されたファイルに関連する名前が表示されます。 普通、この名前は決まったものではありません。というのも、オープンされた ファイルから、ディレクトリ中のエントリへの逆のマッピングは存在しない からです。また、異なるディレクトリエントリが同じファイルを参照してい ることもある ( .Xr ln 2 を参照) ため、表示されている名前 は、プロセスがオープンした元のファイルの実際の名前と 異なっているかもしれません。 .El .Sh ソケット オープンしているファイルのフォーマットは、プロトコルのドメインに依存します。 最初のフィールドはドメイン名で、2 番目のフィールドは ソケットの型 (stream や dgramなど)、3 番目はソケットフラグのフィールド (16 進数) です。残りのフィールドはプロトコルに依存します。tcp の場合は、 tcpcb のアドレスですし、udp の場合は inpcb (ソケット pcb) のアドレスです。 UNIX ドメインソケットの場合はソケット pcb のアドレスと (もし接続すれば) 接続先 pcb のアドレスです。それ以外の場合はプロトコル番号とソケット自身 のアドレスが表示されます。 .Xr netstat 1 と重複しない範囲で、詳しく分析するのに十分な情報を表示しようとします。 .Pp たとえば、上で述べたアドレスは .Dq Li netstat -A コマンドで表示される tcp, udp, UNIX ドメインのそれぞれのアドレスです。ただし、パイプはソケットを用いて 実装されているので、パイプは接続先の UNIX ドメインストリームソケットとして 現れることに注意してください。単方向 UNIX ドメインソケットは、向き を持った矢印 (``<-'' か ``->'') として表示され、双方向 (全二重) UNIX ドメイン は二重矢印 (``<->'') として表示されます。 .Sh バグ .Nm はシステムのスナップショットをとるので、表示される情報は ほんのわずかな間しか正しくありません。 .Sh 関連項目 .Xr netstat 1 , .Xr nfsstat 1 , .Xr ps 1 , .Xr sockstat 1 , .Xr systat 1 , .Xr tcp 4 , .Xr unix 4 , .Xr iostat 8 , .Xr pstat 8 , .Xr vmstat 8 .Sh 歴史 .Nm コマンドは .Bx 4.3 tahoe から登場しました。 diff --git a/ja_JP.eucJP/man/man1/g711conv.1 b/ja_JP.eucJP/man/man1/g711conv.1 index 598f057d8e..083ade4cfa 100644 --- a/ja_JP.eucJP/man/man1/g711conv.1 +++ b/ja_JP.eucJP/man/man1/g711conv.1 @@ -1,97 +1,97 @@ .\" Copyright (c) 1999 Hellmuth Michaelis. 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: g711conv.1,v 1.7 2001-08-06 03:01:42 horikawa Exp $ +.\" $Id: g711conv.1,v 1.8 2002-07-21 05:44:22 horikawa Exp $ .\" -.\" %FreeBSD: src/usr.sbin/i4b/g711conv/g711conv.1,v 1.4.2.5 2001/08/01 17:45:02 obrien Exp % +.\" %FreeBSD: src/usr.sbin/i4b/g711conv/g711conv.1,v 1.4.2.6 2002/06/21 16:40:34 charnier Exp % .\" .\" last edit-date: [Mon Dec 13 22:54:33 1999] .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/g711conv.1,v 1.6 2001/07/29 05:14:50 horikawa Exp $ +.\" $FreeBSD$ .Dd March 15, 1999 .Dt G711CONV 1 .Os .Sh 名称 .Nm g711conv .Nd G.711 に従う変換 .Sh 書式 .Nm .Op Fl a .Op Fl u .Op Fl P .Op Fl A .Op Fl R .Sh 解説 .Nm -は isdn4bsd パッケージの一部分です。 +ユーティリティは isdn4bsd パッケージの一部分です。 ITU G.711で規定されている A-Law と u-law フォーマット間の変換に使われます。 このコマンドは Sun Microsystems, Inc. によって実装された リファレンス実装に基づいています。 Sun Microsystems, Inc. のリファレンス実装は 自由に入手可能で自由に利用することができます。 .Pp 以下のオプションが利用可能です: .Bl -tag -width Ds .It Fl a A-law から u-law へ変換します。 .It Fl u u-law から A-law へ変換します。 .It Fl r 変換前にビット反転を行います。 .It Fl R 変換後にビット反転を行います。 .It Fl P 実際の変換をする代わりに、標準出力に結果として 生じる変換テーブルを (C のソースとして) 表示します。 .El .Sh 規格 A-Law と u-law 間の変換方法は、 ITU Recommendation G.711 で規定されています。 .Pp 参考になる実装は Sun Microsystems, Inc. によって行われており、これは http://www.itu.int/itudoc/itu-t/rec/g/g700-799/refimpl.txt から参照できます。 .Sh 使用例 次のコマンド: .Bd -literal -offset indent g711conv -P -a .Ed .Pp は標準出力に C のソースとして A-law から u-law への変換テーブルを 表示します。 .Pp 次のコマンド: .Bd -literal -offset indent cat max_headroom.ul | g711conv -u -R > /dev/i4btel0 .Ed .Pp は u-law 形式の Max Headroom の音声を A-law へ変換して 変換結果のビットを逆にし、そしてアクティブな isdn4bsd 電話コネクションへ データを送ります。 .Sh 作者 .Nm ユーティリティとこのマニュアルページは .An Hellmuth Michaelis Aq hm@kts.org が書きました。これらは Sun Microsystems, Inc. が書いた G.711 変換リファレンスコードと、 .An Stefan Bethke が isdn4bsd へ寄贈したコードに基づいています。 diff --git a/ja_JP.eucJP/man/man1/gcore.1 b/ja_JP.eucJP/man/man1/gcore.1 index 6bd909a33f..4da1707c10 100644 --- a/ja_JP.eucJP/man/man1/gcore.1 +++ b/ja_JP.eucJP/man/man1/gcore.1 @@ -1,102 +1,102 @@ .\" Copyright (c) 1983, 1990, 1992, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)gcore.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/gcore/gcore.1,v 1.8.2.3 2001/08/16 13:16:49 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/gcore.1,v 1.7 2001/07/29 05:14:50 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/gcore/gcore.1,v 1.8.2.4 2002/06/21 15:27:02 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt GCORE 1 .Os .Sh 名称 .Nm gcore .Nd 実行中のプロセスのコアイメージを取得する .Sh 書式 .Nm gcore .Op Fl s .Op Fl c Ar core .Op Ar exec .Ar pid .Sh 解説 .Nm gcore -は指定したプロセスのコアイメージを生成します。 +ユーティリティは指定したプロセスのコアイメージを生成します。 このコアイメージは .Xr gdb 1 で用いるのに適したものです。 デフォルトでは、コアはファイル .Dq Pa core. に書き出されます。 プロセス ID .Ar pid をコマンドラインで指定する必要があります。 実行可能イメージは指定されない場合、 .Nm は .Dq Pa /proc//file を使用します。 .Pp オプションは以下の通りです: .Bl -tag -width indent .It Fl c コアファイルを .Dq Pa core. ではなく、指定したファイルに書き出します。 .It Fl s コアイメージを集める間プロセスを停止し、 集め終わったらプロセスを再開させます。 これにより、生成されたコアダンプが一貫性のとれた状態になっていることを 保証できます。 プロセスはたとえ既に停止していても、再開されます。 同じ効果は .Xr kill 1 を用いて手動で行うことも可能です。 .El .Sh 関連ファイル .Bl -tag -width /var/log/messages -compact .It Pa core. コアイメージ .It Pa /proc//file 実行可能イメージ .El .Sh 歴史 .Nm gcore -は +ユーティリティは .Bx 4.2 から登場しました。 .Sh バグ .Nm gcore 動作中にコンテキスト切り替えやページング動作が発生すると混乱します。 最善の結果を得るには、-s を用いて目的プロセスを一時停止させて下さい。 .Pp .Nm gcore はオリジナルの .Bx 4.2 バージョンと互換ではありません。 diff --git a/ja_JP.eucJP/man/man1/getopt.1 b/ja_JP.eucJP/man/man1/getopt.1 index 0b273d2e8c..c8fe479d37 100644 --- a/ja_JP.eucJP/man/man1/getopt.1 +++ b/ja_JP.eucJP/man/man1/getopt.1 @@ -1,134 +1,135 @@ -.\" %FreeBSD: src/usr.bin/getopt/getopt.1,v 1.10.2.3 2001/08/16 13:16:49 ru Exp % +.\" %FreeBSD: src/usr.bin/getopt/getopt.1,v 1.10.2.4 2002/06/21 15:27:04 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/getopt.1,v 1.9 2001/07/29 05:14:50 horikawa Exp $ +.\" $FreeBSD$ .Dd April 3, 1999 .Dt GETOPT 1 .Os .Sh 名称 .Nm getopt .Nd コマンドラインオプションの解釈を行う .Sh 書式 .Nm args=\`getopt Ar optstring $*\` ; errcode=$?; set \-\- $args .Sh 解説 .Nm -は、シェルプロシジャによって簡単に解釈できるようにコマンドライン上の +ユーティリティは、 +シェルプロシジャによって簡単に解釈できるようにコマンドライン上の オプションを切り分けます。そして、正しいオプションであるかを確かめます。 .Ar optstring は、認識されるオプション文字の文字列です ( .Xr getopt 3 を参照)。 オプション文字のあとにコロン (``:'') がある場合、そのオプションは、 (空白文字で区切られているかもしれない) 引数を持つことになります。 特別なオプション .Ql \-\- は、オプションの終りを区別するために使われます。 .Nm -は、オプションの最後に引数として +ユーティリティは、オプションの最後に引数として .Ql \-\- を配置します。または、それが陽に使われた時はそれを終りと認識します。 シェル変数 (\fB$1 $2\fR ...) は、個々のオプションが .Ql \- に続くように再設定されます。そして、それ自身をシェル変数にします。 各オプション引数は、同様にそれ用のシェル変数に入れられます。 .Sh 使用例 以下のコードの断片は、 引数無しの .Fl a, .Fl b オプションと、 引数ありの .Fl o オプションを取ろうとしているコマンドのために、どのようにして 引数を処理するのかを示しています。 .Pp .Bd -literal -offset indent args=\`getopt abo: $*\` # \`getopt abo: "$@"\` を使ってはなりません。 # 以下の set コマンドとは異ったように、引き数を解釈してしまうためです。 if [ $? != 0 ] then echo 'Usage: ...' exit 2 fi set \-\- $args # set コマンドを、バッククォートした getopt と共に、直接使用できません。 # getopt の終了コードが set のもので隠されてしまうからです。 # set の終了コードは 0 と定義されています。 for i do case "$i" in \-a|\-b) echo flag $i set; sflags="${i#-}$sflags"; shift;; \-o) echo oarg is "'"$2"'"; oarg="$2"; shift; shift;; \-\-) shift; break;; esac done echo single-char flags: "'"$sflags"'" echo oarg is "'"$oarg"'" .Ed .Pp このコードは、以下の (コマンド指定の) 例のどれでも同じように 受け入れます。 .\"(訳注)「コマンド指定の」は、訳者が勝手に挿入している。 .\" 2.2.1R 対象(1997/04/27) Takeshi MUTOH .Pp .Bd -literal -offset indent cmd \-aoarg file file cmd \-a \-o arg file file cmd \-oarg -a file file cmd \-a \-oarg \-\- file file .Pp .Ed .Sh 関連項目 .Xr sh 1 , .Xr getopt 3 .Sh 診断 .Nm -は、 +ユーティリティは、 .Ar optstring 中に含まれていないオプション文字に出会った時に、 標準エラー出力にエラーメッセージを表示し、0 より大きな状態で終了します。 .Sh 歴史 Bell Labs のマニュアルを元に、 .An Henry Spencer が書きました。 振舞いは、Bell Labs 版と同じであると信じています。 使用例は .Fx バージョン 3.2 と 4.0 で変更しました。 .Sh バグ .Xr getopt 3 が持っているバグは、そのまま持っています。 .Pp 空白文字やシェルのメタキャラクタを含んだ引数は、一般に元のまま 残りません。 これは直すのは簡単に思われますが、そうではありません。 .Nm や本マニュアルの使用例を直そうとする人は、 .Fx 中のこのファイルの履歴を確認すべきです。 .Pp 不正なオプションに対するエラーメッセージは、 .Nm を実行するシェルプロシジャから返すのではなく、 .Nm から返されます。 これも直すのは困難です。 .Pp シェルオプションの値を分離すること無く、引数を指定するための .Nm set コマンドを使うためのとっても良い方法は、シェルのバージョンを 変えることです。 .Pp 引き数を部分的に正しく解釈するために、 各シェルスクリプトは (前記使用例のような) 複雑なコードを持つ必要があります。 より良い getopt 的ツールは、複雑な部分の大半をツールの中に移動し、 クライアントのシェルスクリプトを単純にするものでしょう。 diff --git a/ja_JP.eucJP/man/man1/gprof.1 b/ja_JP.eucJP/man/man1/gprof.1 index d9555a7510..f37ac5953d 100644 --- a/ja_JP.eucJP/man/man1/gprof.1 +++ b/ja_JP.eucJP/man/man1/gprof.1 @@ -1,317 +1,316 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)gprof.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/gprof/gprof.1,v 1.12.2.6 2001/09/21 19:40:44 schweikh Exp % +.\" %FreeBSD: src/usr.bin/gprof/gprof.1,v 1.12.2.7 2002/06/21 15:27:08 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt GPROF 1 .Os .Sh 名称 .Nm gprof .Nd 呼び出しグラフに基づくプロファイルデータを表示する .Sh 書式 .Nm .Op options .Op Ar a.out Op Ar a.out.gmon ... .Sh 解説 .Nm -は、C や Pascal, Fortran77 の実行プロファイルを生成します。 +ユーティリティは、C や Pascal, Fortran77 の実行プロファイルを生成します。 .Nm では、呼び出されたルーチンの実行時間は、呼び出した側の ルーチンに加算されます。 プロファイルデータは、呼び出しグラフプロファイルファイル (call graph profile file) から読み出されます。このファイルは、 .Xr cc 1 , .Xr pc 1 , .Xr f77 1 に .Fl pg をつけてコンパイル されたプログラムによって生成されます。 .Fl pg をつけると、コンパイラは プロファイル用ライブラリをリンクします。 約束事として、これらのライブラリの名前の後には .Pa _p が付きます。つまり、プロファイルされるバージョンの .Pa libc.a は .Pa libc_p.a であり、コンパイラや隣家に直接ライブラリを指定するときに .Fl l Ns Ar c の代りに .Fl l Ns Ar c_p を使用可能です。 -.Nm -は与えられたオブジェクトファイル (デフォルトでは +与えられたオブジェクトファイル (デフォルトでは .Pa a.out ) を読み込んで、そのオブジェクトのシンボルテーブルと 呼び出しグラフプロファイルとを結び付けます。 デフォルトのグラフプロファイルファイルの名前は、 実行形式名にサフィックス .Pa .gmon を付けたものです。 2 つ以上のプロファイルファイルが与えられると、 .Nm は、それらの情報を合計して出力します。 .Pp .Nm -は、各ルーチンが消費した時間を計算します。 +ユーティリティは、各ルーチンが消費した時間を計算します。 次に、この時間は呼び出しグラフの辺にそって伝播されます。 サイクルが見つかると、サイクルに対する呼び出しが、サイクルの時間を 共有するものとされます。 最初のリストには、関数からの呼び出しグラフ全体の合計時間によって ソートされた関数が表示されています。 各関数のエントリの下には、その関数の呼び出しグラフ での (直接の) 子 (すなわち呼び出された関数名) が表示され、それらの 関数の消費時間がどれくらい親 (つまり呼び出した側の関数) に伝播されているかが 示されています。 同様に、各関数のエントリの上側には、 関数での消費時間が呼び出し元の関数にどのように伝播されているかが 示されています。 .Pp サイクル全体とそのメンバーのリストを示したエントリが、 サイクルの呼び出し回数や実行時間への各メンバーの寄与を含めて表示されます。 .Pp 次のリストでは、 .Xr prof 1 (NetBSD, FreeBSDにはありません) と同様なフラットプロファイル (flat profile) 表示されます。 ここには、関数の合計実行時間や呼び出し回数、 その関数本体のみの実行時間 (ミリ秒またはマイクロ秒)、 その関数本体及びそこから呼び出された関数の実行時間 (ミリ秒またはマイクロ秒)、 が表示されます。 .Pp 最後に関数名の索引が表示されます。 .Pp 以下のオプションが利用可能です。 .Bl -tag -width Fl .It Fl a 静的に宣言された関数の表示を抑制します。 このオプションが指定されると、静的関数についてのすべての関連する情報 (実行時間、別の関数の呼び出し、他の関数からの呼び出しなど) が、 .Pa a.out ファイル中の静的関数の直前に読み込まれるされる関数に含まれることになります。 .It Fl b プロファイル中の各フィールドの説明文を抑制します。 .It Fl c オブジェクトファイルのテキスト空間を調べる発見的な方法を使って、 プログラムの静的呼び出しグラフを見つけます。 静的な呼び出しのみの親と子供は、 呼び出し数 0 として表示されます。 アーキテクチャによっては、本オプションはサポートされていません。 .It Fl C Ar count .Ar count 数以上の関数を含む (呼び出し関係の) サイクルを取り除くために、 切断すべきアーク (呼び出し関係) の最小集合を見つけます。 注意:サイクルを中断するために用いられるアルゴリズムは指数関数的な ものです。そのため、このオプションを指定すると、 .Nm を実行するのに非常に長い時間がかかります。 .It Fl e Ar name ルーチン .Ar name とそのすべての子孫 (それらの関数が表示抑制されていない親をほかに 持っていなければ) のグラフプロファイルエントリの表示を抑制 します。2 つ以上の .Fl e を指定することができます。各 .Fl e には 1 つしか .Ar name を指定することができません。 .It Fl E Ar name .Fl e と同様、指定されたルーチン .Ar name のグラフプロファイル エントリ表示を抑制します。さらに、プログラムのトータルの時間と計算時間の パーセンテージから .Ar name で使われている時間を取り除きます。 (たとえば、 .Fl E .Ar mcount .Fl E .Ar mcleanup がデフォルトです) .It Fl f Ar name 指定されたルーチン .Ar name とその子孫のグラフプロファイルエントリ のみを表示します。 .Fl f オプションは、複数指定することができます。 各オプション .Fl f には、1 つしか .Ar name を指定することができません。 .It Fl F Ar name .Fl f と同様に、指定されたルーチン .Ar name とその子孫のグラフ プロファイルエントリのみを表示します。 プログラムのトータルの時間と計算時間の割合 には、表示されたルーチンの時間のみが使われます。 .Fl F は複数指定することができます。各オプション .Fl F には、1 つしか .Ar name を指定することができません。オプション .Fl F は、オプション .Fl E の効果を打ち消します。 .It Fl k Ar fromname Ar toname .Ar fromname から .Ar toname への関数呼び出し関係のアークを削除します。 このオプションによって、不必要だと思うサイクルを切断することができます。 オプション .Fl k は、複数指定することができます。各オプション .Fl k には一対のルーチン名 .Pf ( Ar fromname と .Ar toname ) しか 指定することができません。 .It Fl l 呼び出しグラフプロファイルの表示を抑制します。 .It Fl L フラットプロファイルの表示を抑制します。 .It Fl s 指定されたすべてのプロファイルファイル中のプロファイル情報の合計 を表すサマリプロファイルファイル .Pa gmon.sum が生成されます。 このサマリプロファイルファイルはこのあとの .Nm の実行に 対して与えられ .Pf ( その際にも通常 Fl s が指定される)、一連の .Pa a.out 実行の結果のプロファイルデータの合計を 求めることができます。 .It Fl u C プログラムには見えない名前の関数の表示を抑制します。 ELF オブジェクト形式では、文字 .Ql .\& を含む名前を意味します。 a.out オブジェクト形式では、文字 .Ql _ で開始しない名前を意味します。 それらの関数に関連する情報は、すぐ低位側のアドレスにある (表示が 抑制されていない) 関数に含まれます。 これにより関数内にあるただのラベルが関数と認識されてしまうのを 防ぐ事ができます。 .It Fl z 使用されていないルーチン (呼び出し回数と合計時間が 0 である) を表示します。 .Fl c オプションとともに使うと、一度も呼ばれていないルーチンを発見する事ができます。 .El .Sh 関連ファイル .Bl -tag -width a,out.sum -compact .It Pa a.out テキスト空間と名前リスト .It Pa a.out.gmon 動的な呼び出しグラフとプロファイル .It Pa gmon.sum 動的な呼び出しグラフとプロファイルのサマリ .El .Sh 関連項目 .Xr cc 1 , .Xr profil 2 , .Xr clocks 7 .\" .Xr monitor 3 , .\" .Xr prof 1 .Pp .Rs .%T "An Execution Profiler for Modular Programs" .%A S. Graham .%A P. Kessler .%A M. McKusick .%J "Software - Practice and Experience" .%V 13 .%P pp. 671-685 .%D 1983 .Re .Pp .Rs .%T "gprof: A Call Graph Execution Profiler" .%A S. Graham .%A P. Kessler .%A M. McKusick .%J "Proceedings of the SIGPLAN '82 Symposium on Compiler Construction, SIGPLAN Notices" .%V 17 .%N 6 .%P pp. 120-126 .%D June 1982 .Re .Sh 歴史 .Nm プロファイラは、 .Bx 4.2 から登場しました。 .Sh バグ サンプリングの周期がリストの最初に表示されますが、 統計的な域を出ないものであるかもしれません。 我々は、各関数の実行時間はその関数が消費した時間の合計をその関数の 呼び出し回数で割ったものによって表現されると仮定しています。 したがって、呼び出しグラフの関係にそって関数の親に伝播される時間は、 その関係をたどる回数に直接比例しています。 .Pp 自身がプロファイルされていない親は、プロファイルしている子供から 伝播される時間を持っており、呼び出しグラフのリストのなかで 自動的に起動されるものとして現れます。しかし、この関数が持つ時間は それ以上伝播されません。 同様に、シグナルを捕捉する関数は、それらがプロファイルされていても、 自動的に起動されるものとして現れます (もう少し複雑な理由がありますが)。 プロファイルルーチンを実行している最中にシグナルを捕捉する 関数が呼出されたとき (この場合はすべてが失われてしまいます) を除いては、 シグナルを捕捉する関数の子供の実行時間は、その親に正しく 伝播されるべきです。 .Pp プロファイルされているプログラムは、 グラフプロファイル ファイルにプロファイル情報がセーブされるよう .Xr exit 3 を呼ぶか、正常に終了しなければいけません。 diff --git a/ja_JP.eucJP/man/man1/hexdump.1 b/ja_JP.eucJP/man/man1/hexdump.1 index 7b167e4671..780c275799 100644 --- a/ja_JP.eucJP/man/man1/hexdump.1 +++ b/ja_JP.eucJP/man/man1/hexdump.1 @@ -1,328 +1,328 @@ .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)hexdump.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/hexdump/hexdump.1,v 1.9.2.6 2001/12/14 15:53:30 ru Exp % +.\" %FreeBSD: src/usr.bin/hexdump/hexdump.1,v 1.9.2.7 2002/06/21 15:27:11 charnier Exp % .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt HEXDUMP 1 .Os .Sh 名称 .Nm hexdump , hd .Nd ASCII, 10進, 16進, 8進でのダンプ .Sh 書式 .Nm .Op Fl bcCdovx .Op Fl e Ar format_string .Op Fl f Ar format_file .Op Fl n Ar length .Bk -words .Op Fl s Ar skip .Ek .Ar .Nm hd .Op Fl bcdovx .Op Fl e Ar format_string .Op Fl f Ar format_file .Op Fl n Ar length .Bk -words .Op Fl s Ar skip .Ek .Ar .Sh 解説 .Nm ユーティリティは、ファイルが指定されていればそのファイル、 指定されていなければ標準入力を読み込み、ユーザの指定した フォーマットに従って表示するフィルタです。 .Pp オプションは以下の通りです: .Bl -tag -width Fl .It Fl b .Em 1 バイト 8 進表示。 入力のオフセットを 16 進数で表示し、次に、 入力の1バイトずつを、0 詰めした 3 桁の 8 進数で、1 行あたり 16 個、 空白で区切って表示します。 .It Fl c .Em 1 バイト キャラクタ表示。 入力のオフセットを 16 進数で表示し、次に、 入力の1バイトずつを、空白詰めした 3 桁の ASCII 文字で、1 行あたり 16 個、 空白で区切って表示します。 .It Fl C .Em 標準的な hex+ASCII 表示 。 入力オフセットを 16 進数で表示し、 引続いて 16 バイトを 16 進数 2 桁で空白で区切って表示し、 引き続いて同じ 16 バイトを %_p フォーマットで ``|'' 文字で括って表示します。 .Pp コマンド .Nm hd を実行すると、このオプションで .Nm 実行したことを意味します。 .It Fl d .Em 2 バイト 10 進表示 。 入力のオフセットを 16 進数で表示し、次に、 入力の 2 バイトずつを、0 詰めした 5 桁の 10 進数で、1 行あたり 8 個、 空白で区切って表示します。 .It Fl e Ar format_string データの表示形式を決めるフォーマット文字列を指定します。 .It Fl f Ar format_file 1 つあるいはそれ以上のフォーマット文字列 (改行で区切る) の書かれたファイルを指定します。空行、および、 空白を除いた最初の文字が ハッシュ記号 .Pf ( Cm \&# ) である行は無視されます。 .It Fl n Ar length 入力のうち .Ar length バイト分だけを処理します。 .It Fl o .Em 2 バイト 8 進表示 。 入力のオフセットを 16 進数で表示し、次に、 入力の 2 バイトずつを、0 詰めした 6 桁の 8 進数で、1 行あたり 8 個、 空白で区切って表示します。 .It Fl s Ar offset 入力の先頭から .Ar offset バイトを読み飛ばします。 デフォルトでは .Ar offset は 10 進数として解釈されます。 .Cm 0x または .Cm 0X , を頭に付けると .Ar offset は 16 進数として解釈されます。また、 .Cm 0 を頭に付けると .Ar offset は 8 進数として解釈されます。 .Cm b , .Cm k , .Cm m を .Ar offset の後ろにつけると、それぞれ .Li 512 , .Li 1024 , .Li 1048576 倍と解釈されます。 .It Fl v .Fl v オプションは .Nm に対してすべての入力を表示させます。 .Fl v オプションを指定しない場合、直前の行と 内容 (オフセットは除く) が全く同じ行は何行であっても、 アスタリスク 1 個の 1 行で置き換えられます。 .It Fl x .Em 2 バイト 16 進表示 。 入力のオフセットを 16 進数で表示し、次に、 入力の 2 バイトづつを、0 詰めした 4 桁の 16 進数で、1 行あたり 8 個、 空白で区切って表示します。 .El .Pp .Nm は、各々の入力ファイルの内容を、それらが指定された順に、 .Fl e および .Fl f オプションによって指示されたフォーマット文字列に従って変換しながら、 シーケンシャルに標準出力へコピーします。 .Ss フォーマット フォーマット文字列は、任意の数のフォーマット単位を空白で区切って 並べたものです。フォーマット単位は最大 3 個までの要素すなわち 繰り返し回数・バイト数・フォーマットによって構成されます。 .Pp 繰り返し回数は正の整数で、省略時の値は 1 です。それぞれのフォーマットは この繰り返し回数だけ適用されます。 .Pp バイト数も正の整数で、省略することもできます。指定された場合には 繰り返し 1 回あたりに処理されるバイト数を示します。 .Pp 繰り返し回数とバイト数はスラッシュ (/) で区切ります。どちらか一方だけ 指定する時も、繰り返し回数の場合は直後、バイト数の場合は直前にスラッシュを 付け、曖昧にならないようにします。スラッシュの前後にある空白は無視されます。 .Pp フォーマットは必須であり、ダブルクォート (" ") で囲みます。フォーマットは fprintf 形式のフォーマット文字列 ( .Xr fprintf 3 を参照) ですが、以下の例外があります。 .Bl -bullet -offset indent .It フィールドの幅あるいは精度としてアスタリスク (*) を使用することはできません。 .It ``s'' 変換文字にはバイト数または精度を指定しなければなりません (精度が指定されなかった場合は文字列全体を表示するという .Xr fprintf 3 のデフォルトとは異なります)。 .It 変換文字 ``h'', ``l'', ``n'', ``p'' , ``q'' は サポートされていません。 .It C の標準規格の中で記述されている 以下の 1 文字エスケープシーケンスをサポートしています。 .Bd -ragged -offset indent -compact .Bl -column .It "NUL \e0 .It " \ea .It " \eb .It " \ef .It " \en .It " \er .It " \et .It " \ev .El .Ed .El .Pp .Nm -はさらに以下の変換文字をサポートします。 +ユーティリティはさらに以下の変換文字をサポートします。 .Bl -tag -width Fl .It Cm \&_a Ns Op Cm dox 次に表示されるバイトのオフセット (複数の入力ファイルを通算しての値) を表示します。文字 .Cm d , .Cm o , .Cm x を付加すると、表示をそれぞれ 10 進、8 進、16 進形式にします。 .It Cm \&_A Ns Op Cm dox .Cm \&_a 変換文字とほぼ同じですが、すべての入力が処理された後で一度だけ実行 されるという点が異なります。 .It Cm \&_c デフォルトの文字セット中における文字を表示します。 表示不能な文字は 0 詰めして 3 桁にした 8 進数で表示します。 ただし標準のエスケープ 表記 (上述) ができるものについてはその 2 文字で表示します。 .It Cm _p デフォルトの文字セット中における文字を表示します。 表示不能な文字は .Dq Cm \&. として表示します。 .It Cm _u 文字セット US ASCII 中での文字を表示します。ただし制御文字については 以下に示す小文字名で表示します。16 進で 0xff より大きな文字に ついては 16 進表記の文字列として表示します。 .Bl -column \&000_nu \&001_so \&002_st \&003_et \&004_eo .It "\&000\ nul\t001\ soh\t002\ stx\t003\ etx\t004\ eot\t005\ enq .It "\&006\ ack\t007\ bel\t008\ bs\t009\ ht\t00A\ lf\t00B\ vt .It "\&00C\ ff\t00D\ cr\t00E\ so\t00F\ si\t010\ dle\t011\ dc1 .It "\&012\ dc2\t013\ dc3\t014\ dc4\t015\ nak\t016\ syn\t017\ etb .It "\&018\ can\t019\ em\t01A\ sub\t01B\ esc\t01C\ fs\t01D\ gs .It "\&01E\ rs\t01F\ us\t0FF\ del .El .El .Pp 各々の変換文字について、サポートされているバイト数とデフォルトの バイト数は以下の通りです: .Bl -tag -width "Xc,_Xc,_Xc,_Xc,_Xc,_Xc" -offset indent .It Li \&%_c , \&%_p , \&%_u , \&%c 1 バイトのみ使用できます。 .It Xo .Li \&%d , \&%i , \&%o , .Li \&%u , \&%X , \&%x .Xc デフォルトでは 4 バイトで、1 バイト・2 バイト・4 バイトが使用できます。 .It Xo .Li \&%E , \&%e , \&%f , .Li \&%G , \&%g .Xc デフォルトでは 8 バイトで、4 バイトも使用できます。 .El .Pp 各フォーマット文字列によって処理されるデータの量は、 各フォーマット単位が必要とするデータ量の合計であり、これは バイト数の繰り返し回数倍、あるいはバイト数が指定されていない場合には フォーマットの必要とするバイト数の繰り返し回数倍になります。 .Pp 入力は ``ブロック'' ごとに処理されます。ブロックとは、フォーマット 文字列によって指定されるデータの塊のうちで最も大きいものです。 1 ブロック分のデータを処理し切らないフォーマット文字列で、その中の 最後のフォーマット単位が何バイトかを処理し、かつ繰り返し 回数が指定されていないものは、ブロック全体が処理され切るか、 フォーマット文字列に合致するデータがブロック中になくなるまで 繰り返し回数を増やされます。 .Pp ユーザの指定または hexdump が上記のように繰り返し回数を変更した結果、 繰り返し回数が 1 より大きくなった場合、最後の繰り返しにおける 末尾の空白は出力されません。 .Pp バイト数を複数の変換文字と共に指定すると、1 つを除いた全ての変換文字が .Cm \&_a または .Cm \&_A である時以外、エラーになります。 .Pp 入力がフォーマット文字列の一部分しか満たしていない状態で .Fl n オプションで指定したバイト数あるいはEOFに到達した場合、 有効なデータをすべて表示できるよう、入力ブロックには適当な数の 0 が 補われます。(すなわち、データの終端にまたがっている フォーマット単位は何バイトかの 0 を表示します。) .Pp そのようなフォーマット文字列によるさらなる出力は、等数の空白で 置き換えられます。等数の空白とは、 もとの変換文字あるいは変換文字列とフィールド幅と精度は同じで .Dq Li \&+ , .Dq \&\ \& , .Dq Li \&# を取り除いた .Cm s 変換文字が、NULL 文字列を指した場合に出力される数の空白です。 .Pp フォーマット文字列が指定されない場合、デフォルトの表示形式は .Fl x オプションが指定された場合のものと同じになります。 .Sh 診断 .Ex -std hexdump hd .Sh 使用例 入力を perusal 形式で表示する: .Bd -literal -offset indent "%06.6_ao " 12/1 "%3_u " "\et\et" "%_p " "\en" .Ed .Pp \-x オプションを実装: .Bd -literal -offset indent "%07.7_Ax\en" "%07.7_ax " 8/2 "%04x " "\en" .Ed .Sh 関連項目 .Xr gdb 1 diff --git a/ja_JP.eucJP/man/man1/indent.1 b/ja_JP.eucJP/man/man1/indent.1 index da06833a33..6ba26a5fbf 100644 --- a/ja_JP.eucJP/man/man1/indent.1 +++ b/ja_JP.eucJP/man/man1/indent.1 @@ -1,469 +1,472 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" Copyright (c) 1976 Board of Trustees of the University of Illinois. .\" 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 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. .\" .\" @(#)indent.1 8.1 (Berkeley) 7/1/93 -.\" %FreeBSD: src/usr.bin/indent/indent.1,v 1.8.2.5 2001/12/06 19:28:47 schweikh Exp % +.\" %FreeBSD: src/usr.bin/indent/indent.1,v 1.8.2.6 2002/06/21 15:27:13 charnier Exp % .\" $FreeBSD$ .\" .Dd July 1, 1993 .Dt INDENT 1 .Os .Sh 名称 .Nm indent .Nd C 言語プログラムの字下げと整形 .Sh 書式 .Nm indent .Op Ar input-file Op Ar output-file .Op Fl bad | Fl nbad .Op Fl bap | Fl nbap .Bk -words .Op Fl bbb | Fl nbbb .Ek .Op Fl \&bc | Fl nbc .Op Fl \&bl .Op Fl \&br .Op Fl c Ns Ar n .Op Fl \&cd Ns Ar n .Bk -words .Op Fl cdb | Fl ncdb .Ek .Op Fl \&ce | Fl nce .Op Fl \&ci Ns Ar n .Op Fl cli Ns Ar n .Op Fl d Ns Ar n .Op Fl \&di Ns Ar n .Bk -words .Op Fl fc1 | Fl nfc1 .Op Fl fcb | Fl nfcb .Ek .Op Fl i Ns Ar n .Op Fl \&ip | Fl nip .Op Fl l Ns Ar n .Op Fl \&lc Ns Ar n .Op Fl \&lp | Fl nlp .Op Fl npro .Op Fl pcs | Fl npcs .Op Fl psl | Fl npsl .Op Fl \&sc | Fl nsc .Bk -words .Op Fl sob | Fl nsob .Ek .Op Fl \&st .Op Fl troff .Op Fl v | Fl \&nv .Sh 解説 .Nm -は -.Ar C +ユーティリティは +.Em C 言語プログラムの整形を行います。 .Ar input-file 中の -.Ar C +.Em C プログラムをオプションに従って整形し直します。 以下で説明するオプションはファイル名の前後で指定できます。 .Pp .Sy 注 : .Ar input-file のみを指定した場合、整形は「同じ場所に」行われます。つまり、整形結果は .Ar input-file に書き戻され、カレントディレクトリに元の .Ar input-file のバックアップがコピーされます。例えば .Ar input-file の名前が .Sq Pa /blah/blah/file だったとすると、バックアップファイルの名前は .Pa file.BAK となります。 .Pp .Nm は .Ar output-file が指定されると、念のため、それが .Ar input-file とは異なっていることをチェックします。 .Pp .Nm の整形スタイルは以下にあげるオプションで制御します。 .Bl -tag -width Op .It Fl bad , nbad .Fl bad を指定すると、宣言ブロックの後ごとに空行を 1 行入れます。デフォルトは .Fl nbad です。 .It Fl bap , nbap .Fl bap を指定すると、関数本体の後ごとに空行を 1 行入れます。デフォルトは .Fl nbap です。 .It Fl bbb , nbbb .Fl bbb を指定すると、コメントブロックの前に必ず空行を 1 行入れます。デフォルトは .Fl nbbb です。 .It Fl \&bc , nbc .Fl \&bc を指定すると、宣言の中のコンマの後ごとに改行を入れます。 .Fl nbc はこれを抑止します。デフォルトは .Fl \&nbc です。 .It Fl \&br , \&bl .Fl \&bl を指定すると、複合文は以下のように行分けされます。 .Bd -literal -offset indent if (...) { code } .Ed .Pp 一方、デフォルトは .Fl \&br ですが、以下のようになります。 .Bd -literal -offset indent if (...) { code } .Ed .Pp .It Fl c Ns Ar n プログラムコードの右側に書かれたコメントを指定の桁位置に揃えます。デ フォルトでは 33 桁目に揃えられます。 .It Fl cd Ns Ar n 宣言の右側に書かれたコメントを指定の桁位置に揃えます。デフォルトでは プログラムコードの右側に書かれたコメントと同じ位置(つまり .Fl c で指定された位置)になります。 .It Fl cdb , ncdb コメント区切りを独立の行とするかどうかを指定します。コメントブロック だけに有効で、プログラムコードの右側に書かれたコメントには影響しませ ん。デフォルトは .Fl cdb で、コメントは以下のようになります。 .Bd -literal -offset indent /* * this is a comment */ .Ed .Pp 一方、 .Fl ncdb では以下のようになります。 .Bd -literal -offset indent /* this is a comment */ .Ed .Pp .It Fl ce , nce .Fl \&ce は `else' を直前の `}' につけて ``} else'' のように出力します。デフォルトは .Fl \&ce です。 .It Fl \&ci Ns Ar n 継続行の字下げを .Ar n で指定します。継続行は、その文の最初の行の先頭から指定した字数だけ字 下げされます。かっこで括られた式は .Fl \&lp が有効でなければ、入れ子になっていることを示すために余分に字下げされ ます。 .Fl \&ci のデフォルトは .Fl i と同じ値です。 .It Fl cli Ns Ar n case ラベル字下げ位置を .Ic switch 文の字下げ位置から .Ar n 個目のタブストップにします。 .Fl cli0.5 なら、タブストップの半分になります。デフォルトは .Fl cli0 です。 .It Fl d Ns Ar n プログラムコードの右側に書かれたものでない独立したコメントに関して、 その場所を制御します。例えば .Fl \&d\&1 で、コードの字下げより 1 段左側にします。デフォルトの .Fl \&d\&0 を指定すると、プログラムコードの字下げに合わせます。下記「コメントの 字下げ」の節を参照して下さい。 .It Fl \&di Ns Ar n 宣言子からそれに続く識別子への字下げを文字数で指定します。デフォルト は .Fl di16 です。 .It Fl dj , ndj .Fl \&dj は宣言を左揃えにします。 .Fl ndj は、プログラムコードと同じ字下げを行います。デフォルトは .Fl ndj です。 .It Fl \&ei , nei .Ic else-if に対し特別な処理するよう指定します(しません)。 .Fl \&ei は特別な処理を行い、 .Ic else に続く .Ic if は、最初の if 文と同じだけ字下げされます。 .Fl ei がデフォルトです。 .It Fl fc1 , nfc1 .Fl fc1 で、コメントが 1 桁目から始まっている場合も整形します(しません)。こ のような場合には、おうおうにしてプログラマが意図的にそうしているので あって、 .Fl nfc1 を使うべきではありません。デフォルトは .Fl fc1 です。 .It Fl fcb , nfcb ブロックコメント (`/*\\n' で開始するコメント) の整形を 有効とするかどうかを指定します。 プログラマは、 ブロックコメントをそれ程は注意深く手動整形していないことが多いですが、 再整形によって改行位置だけを変えるということは望ましくないことがあります。 このような場合には .Fl nfcb を使います。 ブロックコメントはボックスコメトのように扱われます。 デフォルトは .Fl fcb です。 .It Fl i Ns Ar n 1 段の字下げ量を指定します。デフォルトは 8 文字です。 .It Fl \&ip , nip パラメータ宣言を左マージンからさらに字下げします(しません)。 デフォルトは .Fl \&ip です。 .It Fl l Ns Ar n 出力行の最大幅を指定します。デフォルトは 78 文字です。 .It Fl \&lp , nlp 継続行において括弧内のプログラムコードの位置を揃えます。左括弧がその 行で閉じていない時、継続行を前の行の左括弧の 1 文字後ろから始まるよ うにします。例えば、 .Fl nlp が指定されると継続行は以下のようになります。 .Bd -literal -offset indent p1 = first_procedure(second_procedure(p2, p3), \ \ third_procedure(p4, p5)); .Ed .Pp 一方、 .Fl lp が指定されるとが指定されると、プログラムコードは以下のようには幾分見 やすくなります。 .Bd -literal -offset indent p1\ =\ first_procedure(second_procedure(p2,\ p3), \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ third_procedure(p4,\ p5)); .Ed .Pp 2行余分に改行された場合には、下のようになります。 .Bd -literal -offset indent p1\ =\ first_procedure(second_procedure(p2, \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ p3), \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ third_procedure(p4, \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ p5)); .Ed .It Fl npro 字下げのプロファイル .Sq Pa ./.indent.pro と .Sq Pa ~/.indent.pro , を使わないようになります。 .It Fl pcs , npcs .Fl pcs が指定されると、全ての関数呼出しの関数名と括弧の間に空白を 1 つ入れます。デフォルトは、 .Fl npcs です。 .It Fl psl , npsl .Fl psl が指定されると、関数定義における関数の名前を 1 桁目から始め ます。つまり、その関数の型名は前の行に置かれることになります。デフォ ルトは、 .Fl psl です。 .It Fl \&sc , nsc 全てのコメントの左端に、アスタリスク(`*') を置きます(置きません)。 デフォルトは .Fl sc です。 .It Fl sob , nsob .Fl sob が指定されると、不要な空白行を取除きます。宣言部の後ろの余分な空白行 を取り除くのに便利です。デフォルトは、 .Fl nsob です。 .It Fl \&st .Nm が標準入力に対して処理を行い、結果を標準出力に出力するようします。 .It Fl T Ns Ar typename .Ar typename を型名として扱うように追加します。 .Fl T は幾つ使ってもかまわないので、複数の型名を指定できます。 プログラム中で .Ic typedef によって定義された型名は必ず指定する必要があります。\- 多少の指定を 忘れたところで実害は全くありませんが、プログラムは意図した程きれいに は整形されないでしょう。全部の型名を指定しなければならないのは大変な ように思えますが、実際にはこれは C 言語のもつ問題が表面化したに過ぎ ません。つまり、 .Ic typedef は、言語の構文解釈を変えてしまうので、 .Nm は .Ic typedef で定義された型名を全て見付けることができないわけです。 .It Fl troff .Xr troff 1 で処理できるフォーマットで出力します。 .Xr vgrind 1 と全く同じ考え方に基づいて、出力をきれいにしようとします。出力ファイ ルが指定されていないと、出力先として入力ファイルではなく標準出力が使 われます。 .It Fl v , \&nv .Fl v で `verbose' モードになります。 .Fl \&nv は `verbose' モードを抑止します。`verbose' モードでは、入力中の 1 行 が複数行に分割された場合には、その旨を表示し、終了時には出力サイズに 付いての情報を付け加えるようになります。 デフォルトは .Fl \&nv です。 .El .Pp ログインディレクトリかカレントディレクトリの一方、あるいはその両方に .Pa .indent.pro というプロファイルを作って、その中にオプションを書いておくことにより、 あなたの好みの設定を .Nm のデフォルトとすることができます。プロファイルは、ログインディレクト リ, カレントディレクトリの順で読み込まれるため、カレントディレクトリ に `.indent.pro'があると、そちらの指定の方が優先されます。 .Nm の起動時にプロファイルが存在していると、それを読み込んでデフォルトと して使用します。ただし、コマンド行でオプションを指定すると、それは常 にプロファイル中のオプションよりも優先されます。プロファイルを書く際 には、各オプションを空白かタブもしくは改行で区切ってやらなくてはなり ません。 .Pp .Ss コメント .Sq Em 囲まれた .Em コメント の処理について説明します。 .Nm -は、コメント開始の直後にマイナスやアスタリスクが続いている(つまり +ユーティリティは、 +コメント開始の直後にマイナスやアスタリスクが続いている(つまり `/*\-' もしくは`/**' となっている)場合、そのコメントをアスタリスクで 周囲を囲まれたものとみなします。このようなコメントに対しては、コメン トの最初の行に施される字下げ位置に、続く各行を揃える他は、処理を行い ません。 .Pp つぎに、 .Em 連続したテキスト としての処理について説明します。 上にあげた以外のコメントは、連続したテキストとして扱います。 .Nm -は 1 行にできるだけ多くの単語(空白やタブもしくは改行で区切られた文字 +ユーティリティは、 +1 行にできるだけ多くの単語(空白やタブもしくは改行で区切られた文字 列)を詰め込もうとします。また、空白行により段落が分けられます。 .Pp .Ss コメントの字下げ プログラムコードの右側のコメントは、コマンド行のオプション .Fl c Ns Ns Ar n で指定された「コメント開始位置」から始まるようになります。その他のコ メントは、コマンド行のオプション .Fl d Ns Ns Ar n が指定されると、プログラムコードがおかれている位置よりも .Ar n 段少なく字下げされます。1 行の内でプログラムコードが指定されたコメン ト開始位置を超えて続いていた場合には、さらにその右へとコメントを続け ますが、極端に行が長かった場合には、自動的に右マージンが広くとられる ことがあります。 .Pp .Ss マクロ行 一般に .Nm はプリプロセッサのマクロ行をそのまま出力します。唯一の例外はその行の 右側にコメントが書かれている時で、そのコメントを整形します。ただし、 マクロの展開の結果プログラムに埋込まれるコメントは処理しません。また、 .Nm は条件付きコンパイルのマクロ .Pq Ic #ifdef...#endif を認識し、それによってもたらされる構文上の異常を正しく補おうとしま す。 .Pp .Ss C 言語の構文 .Nm -は、C 言語の構文をかなり理解しますが、「寛容な」構文解析しか行いませ +ユーティリティは、 +C 言語の構文をかなり理解しますが、「寛容な」構文解析しか行いませ ん。不完全だったり正しくない構文も、ごく普通のものならうまく処理しよ うとします。とくにあげると、以下のようなマクロも適当に処理されます。 .Pp .Dl #define forever for(;;) .Sh 環境変数 .Nm -は環境変数として、 +ユーティリティは環境変数として、 .Ev HOME を使用します。 .Sh 関連ファイル .Bl -tag -width "./.indent.pro" -compact .It Pa ./.indent.pro デフォルトの設定を記述したプロファイルです。 .It Pa ~/.indent.pro デフォルトの設定を記述したプロファイルです。 .El .Sh 歴史 .Nm コマンドは .Bx 4.2 で導入されました。 .Sh バグ .Nm -は +ユーティリティは .Xr ls 1 以上に多くのオプションを持っています。 .Pp よくある悲惨な間違いは、ディレクトリにある全ての -C +.Em C プログラムを整形しようとして .Pp .Dl indent *.c .Pp と入力してしまうことです。おそらく、これはバグであって特徴と言うべき ではないでしょう。 diff --git a/ja_JP.eucJP/man/man1/ipcrm.1 b/ja_JP.eucJP/man/man1/ipcrm.1 index c3a56541fd..0c31e47a65 100644 --- a/ja_JP.eucJP/man/man1/ipcrm.1 +++ b/ja_JP.eucJP/man/man1/ipcrm.1 @@ -1,80 +1,80 @@ .\" Copyright (c) 1994 Adam Glass .\" 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. 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 Adam Glass ``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 Adam Glass 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. .\" -.\" %FreeBSD: src/usr.bin/ipcrm/ipcrm.1,v 1.7.2.3 2001/07/22 12:40:13 dd Exp % +.\" %FreeBSD: src/usr.bin/ipcrm/ipcrm.1,v 1.7.2.4 2002/06/21 15:27:16 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ipcrm.1,v 1.9 2001/05/14 01:07:24 horikawa Exp $ +.\" $FreeBSD$ .\"" .Dd August 8, 1994 .Dt IPCRM 1 .Os .Sh 名称 .Nm ipcrm .Nd 指定したメッセージキュー、セマフォセット、共有セグメントを削除する .Sh 書式 .Nm .Op Fl q Ar msqid .Op Fl m Ar shmid .Op Fl s Ar semid .Op Fl Q Ar msgkey .Op Fl M Ar shmkey .Op Fl S Ar semkey .Ar ... .Sh 解説 .Nm ipcrm -は、指定したメッセージキュー、セマフォ、共有メモリセグメントを +ユーティリティは、指定したメッセージキュー、セマフォ、共有メモリセグメントを 削除します。これらの System V IPC オブジェクトは、 作成時につけられるID、もしくはキーで指定することができます。 .Pp 次のようなオプションにて、削除する IPC オブジェクトを指定します。 これらのオプションはいくつでも組み合わせて使用することができます: .Bl -tag -width indent .It Fl q Ar msqid .Nm msqid で指定した ID のメッセージキューを削除します。 .It Fl m Ar shmid .Nm shmid で指定した ID の共有メモリセグメントに対し、削除マークを付けます。 このマークが付けられた共有メモリは、最後のプロセスがデタッチした後、 解放されます。 .It Fl s Ar semid .Nm semid で指定した ID のセマフォセットを削除します。 .It Fl Q Ar msgkey .Nm msgkey で指定したキーに対応するメッセージキューを削除します。 .It Fl M Ar shmkey .Nm shmkey で指定したキーに対応する共有メモリセグメントに対し、削除マークをつけます。 このマークが付けられた共有メモリは、最後のプロセスがデタッチした後、 解放されます。 .It Fl S Ar semkey .Nm semkey で指定したキーに対応するセマフォセットを削除します。 .El .Pp System V IPC オブジェクトの ID とキーは、 .Xr ipcs 1 を使って知ることができます。 .Sh 関連項目 .Xr ipcs 1 diff --git a/ja_JP.eucJP/man/man1/ipcs.1 b/ja_JP.eucJP/man/man1/ipcs.1 index fed514d078..b1556b42a2 100644 --- a/ja_JP.eucJP/man/man1/ipcs.1 +++ b/ja_JP.eucJP/man/man1/ipcs.1 @@ -1,147 +1,147 @@ .\" .\" Copyright (c) 1994 SigmaSoft, Th. Lockert .\" 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 SigmaSoft, Th. Lockert. .\" 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. .\" -.\" %FreeBSD: src/usr.bin/ipcs/ipcs.1,v 1.9.2.2 2000/12/14 12:16:13 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ipcs.1,v 1.7 2001/05/14 01:07:24 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/ipcs/ipcs.1,v 1.9.2.3 2002/06/21 15:27:18 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 18, 1994 .Dt "IPCS" 1 .Os .Sh 名称 .Nm ipcs .Nd System V プロセス間通信機構の利用状況を報告する .Sh 書式 .Nm .Op Fl abcmopqstMQST .Op Fl C Ar system .Op Fl N Ar core .Sh 解説 .Nm -プログラムは、システムの System V プロセス間通信 (IPC) 機構 +ユーティリティは、システムの System V プロセス間通信 (IPC) 機構 に関する情報を提供します。 .Pp オプションは以下の通りです: .Bl -tag -width Ds .It Fl a 使用中のセマフォ、メッセージキュー、共有メモリセグメントに関し、 可能な限り多くの情報を表示します(これは .Fl b , .Fl c , .Fl o , .Fl p , .Fl t オプションを同時に指定したのと同じです)。 .It Fl b 使用中のセマフォ、メッセージキュー、共有メモリセグメントの 最大許容サイズを表示します。 .Dq 最大許容サイズ(maximum allowed size) とは、メッセージキュー中の1つのメッセージの最大バイト数、 共有メモリセグメントのサイズの最大バイト数、もしくは一組のセマフォ中の セマフォの数を意味します。 .It Fl c 使用中のセマフォ、メッセージキュー、共有メモリセグメント作成者の名前、 グループを表示します。 .It Fl m 使用中の共有メモリセグメントの情報を表示します。 .It Fl o 使用中のメッセージキュー、共有メモリセグメントの特徴的な利用状況を表示します。 .Dq 特徴的な利用状況(outstanding usage) とは、メッセージキューにあるメッセージ数や共有メモリセグメントを アタッチしているプロセスの数のことです。 .It Fl p 使用中のセマフォ、メッセージキュー、共有メモリセグメントの プロセスID情報を表示します。 .Dq プロセスID情報(process ID information) とは、メッセージキューにメッセージを送ったり、 メッセージキューからメッセージを受け取ったりした最後のプロセス、 またはセマフォを作ったプロセスや、共有メモリセグメントをアタッチしたり、 デタッチしたりした最後のプロセスのことです。 .It Fl q 使用中のメッセージキューに関する情報を表示します。 .It Fl s 使用中のセマフォに関する情報を表示します。 .It Fl t 使用中のセマフォ、メッセージキュー、共有メモリセグメントの アクセス時間を表示します。アクセス時間とは、 IPC オブジェクトに対する最後の制御操作を行った時間や、 メッセージを最後に送ったり受け取ったりした時間、 共有メモリセグメントを最後にアタッチしたりデタッチしたりした時間、 セマフォを最後に操作した時間のことです。 .It Fl C Ar system デフォルトの .Dq Pa /kernel のかわりに、指定した .Ar system から名前リストを取り出します。 .It Fl M 共有メモリに関するシステム情報を表示します。 .It Fl N Ar core デフォルトの .Dq Pa /dev/kmem のかわりに、指定した .Ar core から名前リストに関連した値を取り出します。 .It Fl Q メッセージキューに関するシステム情報を表示します。 .It Fl S セマフォに関するシステム情報を表示します。 .It Fl T 共有メモリ、メッセージキュー、セマフォに関するシステム情報を表示します。 .El .Pp もし、 .Fl M , .Fl m , .Fl Q , .Fl q , .Fl S , .Fl s オプションがいずれも指定されていなければ、使用中の IPC 機構に関する情報が 表示されます。 .Sh 制限 システムデータの構造は、 .Nm の実行中にも変化するかもしれません; .Nm の出力が矛盾のないものであることは保証されません。 .Sh バグ このマニュアルページは、完全なものではありません。なぜなら、 .Nm で表示される情報について説明していないからです。 .Sh 関連ファイル .Bl -tag -width /etc/passwd -compact .It Pa /dev/kmem デフォルトのカーネルメモリ .It Pa /kernel デフォルトのシステム名前リスト .El .Sh 関連項目 .Xr ipcrm 1 .Sh 作者 .An Thorsten Lockert Aq tholo@sigmasoft.com diff --git a/ja_JP.eucJP/man/man1/join.1 b/ja_JP.eucJP/man/man1/join.1 index c0518ca5a3..7f27f6cb7a 100644 --- a/ja_JP.eucJP/man/man1/join.1 +++ b/ja_JP.eucJP/man/man1/join.1 @@ -1,229 +1,221 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)join.1 8.3 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.bin/join/join.1,v 1.3.2.3 2001/08/16 13:16:51 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/join.1,v 1.7 2001/08/17 06:18:09 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/join/join.1,v 1.3.2.4 2002/06/18 05:14:49 jmallett Exp % +.\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt JOIN 1 .Os .Sh 名称 .Nm join .Nd リレーショナルデータベースの操作 .Sh 書式 .Nm .Oo .Fl a Ar file_number | Fl v Ar file_number .Oc .Op Fl e Ar string -.Op Fl j Ar file_number field .Op Fl o Ar list .Bk -words .Ek .Op Fl t Ar char .Op Fl \&1 Ar field .Op Fl \&2 Ar field .Ar file1 .Ar file2 .Sh 解説 .Nm ユーティリティは、指定されたファイルに対し .Dq equality join と呼ばれる、 各ファイルの同一の部分を結合する操作を施して結果を標準出力に出力します。 .Pp 比較は、それぞれのファイルの .Dq join field と呼ばれるフィールドで 行ないます。デフォルトでは、各行の最初のフィールドが使用されます。 .Ar file1 と .Ar file2 の中で、 .Dq join field が一致した行が組みとなり、1 行で出力されます。 join field と、 .Ar file1 のうちの残りのフィールド、その後、 .Ar file2 のうちの残りのフィールドが 1 行になって出力されます。 .Pp フィールドの区切は、デフォルトではタブか空白文字です。複数のタブや空白 が繋っていても、1 つの区切とみなされ、読み込み時にこれらは無視されます。 出力時の各フィールドの区切は、デフォルトでは空白 1 文字です。 .Pp ファイルとフィールドの番号に関し、多くのオプションがあります。これらの 番号は常に、1 から始まります。すなわち、コマンドラインの最初のファイル はファイル番号 1 番であり、各行の最初のフィールドは、フィールド番号 1 番となります。 .Bl -tag -width indent .It Fl a Ar file_number デフォルトの出力に加えて、 .Ar file_number で指定したファイルに関して、同一フィールドがなかった行を表示します。 -( -.Fl a -の引数の前には空白を入れてはなりません; -.Sx 互換性 -の節を御覧ください。) .It Fl e Ar string 出力時に、空のフィールドがあれば .Ar string で指定した文字列に置き換えます。 .It Fl o Ar list .Nm の処理して出力すべき行に関し、デフォルトの順序でなく、 .Ar list で指定した順序で各ファイルの各フィールドを出力 するようにします。 .Ar list の各要素は、 .Ql file_number.field +または +.Ql 0 +.Pq ゼロ で表わし、要素間は、コンマ .Pf ( Dq , Ns ) か空白で区切ります (空白で区切る場合は、シェルが要素を別々のパラメータに分解しないよう クォーティングするか、複数の .Fl o オプションを使用します)。 .It Fl t Ar char 入力および出力に使用するフィールドの区切として .Ar char で指定した文字を使用するようにします。 1行の中で出現したすべての .Ar char が有効です。 .It Fl v Ar file_number .Ar file_number で指定したファイル番号のファイルに関して、 join 処理で同一フィールドが見つからなかった行だけを表示する ようにします。 .Fl v Ar 1 と .Fl v Ar 2 を同時に指定してもかまいません。 .It Fl 1 Ar field ファイル 1 の .Dq join field を .Ar field で指定した番号のフィールドとします。 .It Fl 2 Ar field ファイル 2 の .Dq join field を .Ar field で指定した番号のフィールドとします。 .El .Pp デフォルトのフィールド区切り文字が使われた場合、 ファイルが結合される順序は .Xr sort 1 に .Fl b オプションを付けたものと同様になるはずです。 逆に、 .Nm .Fl t オプションによって、フィールド区切り文字が指定されている場合、 フィールドの照合順序は .Xr sort 1 で .Fl b オプションを指定しない場合と同じになるはずです。 .Pp .Ar file1 または .Ar file2 のうちの片方が .Dq - であった場合には、標準入力が使われます。 .Sh 診断 .Ex -std .Sh 互換性 さらに、古いバージョンの .Nm との互換のため、次のオプションも使用できます。 .Bl -tag -width indent .It Fl a デフォルトの出力に加え、file1 と file2 の各々で、同一フィールド がない行を表示します。 -(これと -.Fl a Ar file_number -を区別するために、 -.Nm -は現在後者は空白を含まないことを必要としています。) .It Fl j1 Ar field ファイル1の ``join field'' を .Ar field で指定した番号のフィールドとします。 .It Fl j2 Ar field ファイル2の ``join field'' を .Ar field で指定した番号のフィールドとします。 .It Fl j Ar field file1 と file2 の ``join field'' を .Ar field で指定した番号のフィールドとします。 .It Fl o Ar list ... 歴史的な .Nm の実装では .Fl o オプションに複数の引数を許可していました。 これらの引数は、現在の .Fl o オプションで説明したものと同じ .Dq file_number.field_number という形式でした。 しかし、この方法では .Ql 1.2 と名付けられたファイルが存在すると、明らかに困難を生じます。 .El .Pp これらのオプションは、修正をしたくないような非常に古いシェルスクリプト のためだけに用意されています。 これらのオプションは、使うべきではありません。 .Sh 規格 .Nm コマンドは -.St -p1003.2 +.St -p1003.1-2001 互換です。 .Sh 関連項目 .Xr awk 1 , .Xr comm 1 , .Xr paste 1 , .Xr sort 1 , .Xr uniq 1 diff --git a/ja_JP.eucJP/man/man1/jot.1 b/ja_JP.eucJP/man/man1/jot.1 index 93bb50735e..1358a399ef 100644 --- a/ja_JP.eucJP/man/man1/jot.1 +++ b/ja_JP.eucJP/man/man1/jot.1 @@ -1,211 +1,212 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)jot.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/jot/jot.1,v 1.8.2.4 2001/08/16 13:16:51 ru Exp % +.\" %FreeBSD: src/usr.bin/jot/jot.1,v 1.8.2.5 2002/06/21 15:27:21 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/jot.1,v 1.13 2001/08/19 10:25:03 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt JOT 1 .Os .Sh 名称 .Nm jot .Nd 連続ないしは、乱数データを出力する .Sh 書式 .Nm .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 -は、増加・減少・ランダム・冗長データを通常は数字で、一行毎に出力します。 +.Nm +ユーティリティは、 +増加・減少・ランダム・冗長データを通常は数字で、一行毎に出力します。 .Pp 以下のようなオプションが利用できます。 .Bl -tag -width indent .It Fl r デフォルトの連続したデータの代わりに、乱数を作成します。 .It Fl b Ar word .Ar word を、繰り返し出力するだけです。 .It Fl w Ar word .Ar word のあとに、生成されたデータを付け加え、出力します。 8 進・16 進・指数・ASCII・ゼロで埋めた表示・右詰め表現などは、適切な .Xr printf 3 記法を .Ar word 中で指定することで、可能です。この場合、データは追加されるというよりも、 挿入されると考えてください。 .It Fl c これは、 .Fl w Ar %c の省略形です。 .It Fl s Ar string .Ar string で分けられたデータを出力します。 普通は、改行文字がデータを分割します。 .It Fl n 通常追加される、最後の改行を出力しません。 .It Fl p Ar precision 整数 .Ar precision で指定されたデータの文字数もしくは桁数だけ表示します。 .Fl p がない場合、精度値は .Ar begin と .Ar end の精度の大きい方です。 .Fl p オプションは、 .Fl w に続く .Xr printf 3 記法が指定されている時には、上書きされます。 .El .Pp 最後の 4 つの引数はそれぞれデータ数・下界・上界と、幅の大きさまたは、乱数のため の種です。 少なくともどれか一つが指定されなければなりませんが、その他の 3 つは引数として \ - を与えると、省略できます。 これら 3 つの引数を指定すれば、4 つ目が決まります。 4 つとも指定されて、 .Ar reps の与えられた値と、計算された値とが相反する場合、小さい方を用います。 指定された数が 3 つより少ない場合には、 .Ar s を除いて、 デフォルト値を左から右へ割り当てます。 .Ar s は、 .Ar begin と .Ar end が共に指定された場合以外、デフォルト値が設定されます。 .Pp 4 つの引数に対するデフォルトは、乱数が要求された時を除いて、 それぞれ、100, 1, 100, 1です。 乱数の種 .Ar s はランダムに選択されます。 .Ar reps は、符号無し整数であると想定されています。 ゼロが与えられた場合は、無限回数となります。 .Ar begin と .Ar end は、実数、もしくは文字の場合は対応する .Tn ASCII 値としてあたえられます。 最後の引数は、実数でなければなりません。 .Pp 乱数値は、 .Xr random 3 を使って得られます。 名前 .Nm は、 APL 中の関数 .Nm iota の部分から来ています。 .Sh 使用例 コマンド .Dl jot 21 -1 1.00 .Pp は、\-1 から 1 へ増加する等間隔の数字を 21 個出力します。 .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 無限に、 .Em yes を出したい場合は、以下のようにします。 .Dl jot -b yes 0 .Pp .Xr ed 1 の置換コマンドを、30 回、2, 7, 12 行等のように (5 行毎に ) 適用する場合の 解答例は以下のようになります。 .\"(訳中)(5 行毎に )は訳者が挿入しました。 .\" 2.2.1R 対象(1997/05/06) Takeshi MUTOH .Dl jot -w %ds/old/new/ 30 2 - 5 .Pp だぶりのある 9, 9, 8, 8, 7 の様な列は、 以下のように適切にステップの大きさを設定することで、実現できます。 .Dl jot - 9 0 -.5 .Pp ファイルが正確に 1024 バイトであるように作成するには、 .Dl jot -b x 512 > block .Pp 最後に、タブを 4 つのスペースに設定し、10 カラム目からはじまって、 132 カラム目で終るようにするには、以下のようにします。 .Dl expand -`jot -s, - 10 132 4` .Pp 80 文字以上の行を全て表示するには、以下を使ってください。 .Dl grep `jot -s \&"\&" -b \&. 80` .Sh 診断 .Ex -std 次の診断メッセージは、特別な解説を要します: .Bl -diag .It "illegal or unsupported format '%s'" .Xr printf 3 用に要求された変換書式指示子は、 .Dl %[#][ ][{+,-}][0-9]*[.[0-9]*]? の書式ではありませんでした。 ここで .Dq ?\& は .Dl [l]{d,i,o,u,x} または .Dl {c,e,f,g,D,E,G,O,U,X} のいずれかひとつです。 .It "range error in conversion" 表示すべき値は、要求された出力書式に関連付けられたデータタイプの 範囲外の結果になりました。 .It "too many conversions" 1 個しか許されないところを、複数の変換書式指示子が指定されました。 .El .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/kbdmap.1 b/ja_JP.eucJP/man/man1/kbdmap.1 index 92b124c7a5..5f21572702 100644 --- a/ja_JP.eucJP/man/man1/kbdmap.1 +++ b/ja_JP.eucJP/man/man1/kbdmap.1 @@ -1,145 +1,145 @@ .\" Copyright (c) March 1995 Wolfram Schneider . Berlin. .\" 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. .\" -.\" %FreeBSD: src/usr.sbin/kbdmap/kbdmap.1,v 1.17.2.8 2001/12/14 16:48:10 ru Exp % +.\" %FreeBSD: src/usr.sbin/kbdmap/kbdmap.1,v 1.17.2.9 2002/06/21 16:40:38 charnier Exp % .\" $FreeBSD$ .Dd March 25, 1995 .Dt KBDMAP 1 .Os .Sh 名称 .Nm kbdmap , .Nm vidfont .Nd syscons 用フロントエンド .Sh 書式 .Nm .Op Fl K .Op Fl V .Op Fl d | Fl default .Op Fl h | Fl help .Op Fl l | Fl lang Ar language .Op Fl p | Fl print .Op Fl r | Fl restore .Op Fl s | Fl show .Op Fl v | Fl verbose .Sh 解説 .Nm -は有効なキーマップを容易に設定するコマンドです。 +ユーティリティは有効なキーマップを容易に設定するコマンドです。 同様に .Nm vidfont はフォントを設定します。 いずれもデータベース中の記述 (description) を探します。 この記述は英語 (デフォルト) あるいは他の言語で書かれています。 両コマンドともキーマップおよびフォントのデータベースを検査します。 デフォルトでは英語で記述されていますが、他の言語でなされても構いません。 これらのプログラムは対話的であり、 ユーザからの必要な入力 (例えばキーマップ選択) を得るために端末出動作するものと期待します。 .Pp .Tn MSDOS コードページのキーマップやフォントを使用しないよう強く勧めます。 可能であれば .Tn ISO 標準バージョンを使ってください! .Tn X11 は .Tn MSDOS コードページをサポートしません。 .Pp 次のオプションが利用可能です: .Bl -tag -width Ds .It Fl K .Nm としてコマンドを実行します。 .It Fl V .Nm vidfont としてコマンドを実行します。 .It Fl d , Fl default デフォルト言語を使用します。 .Ev LANG 環境変数は無視されます。 .It Fl h , Fl help オプション一覧を表示して終了します。 .It Fl l , Fl lang Ar language 記述およびメニューの表示に言語 .Ar language を用います。 .It Fl p , Fl print 標準出力に使用可能なキーマップもしくはフォントを表示し、終了します。 .It Fl r , Fl restore .Pa /etc/rc.conf からデフォルトフォントをロードします。 .It Fl s , Fl show 現在サポートしている言語を表示して終了します。 .It Fl v , Fl verbose 通常よりきめ細かく警告メッセージを出力します。 .El .Sh 環境変数 .Bl -tag -width LANG -compact .It Ev LANG 希望する言語。 .El .Sh 関連ファイル .Bl -tag -width /usr/share/syscons/keymaps/INDEX.keymaps -compact .It Pa /usr/share/syscons/keymaps/INDEX.keymaps キーマップのデータベース .It Pa /usr/share/syscons/fonts/INDEX.fonts フォントのデータベース .It Pa /etc/rc.conf デフォルトのフォント .It Pa /usr/X11/lib/X11/locale/locale.alias 共通な .Ev LANG に関する記述 .El .Sh バグ .\" .Nm kbdmap/vidfont .\" does not know which font is in use. E.g. if the current font .\" is iso-8859-1 and you chose lang 'ru' (for Russian) .\" you get funny latin1 characters and not russkij shrift. .\" .Nm および .Nm vidcontrol -は (仮想) コンソールでのみ機能します。 +のユーティリティは (仮想) コンソールでのみ機能します。 .Tn X11 上では動作しません。 .Sh 関連項目 .Xr dialog 1 , .Xr kbdcontrol 1 , .Xr vidcontrol 1 , .Xr kbdmap 5 , .Xr rc.conf 5 .Sh 歴史 .Nm および .Nm vidfont コマンドは .Fx 2.1 から登場しました。 .Sh 作者 .An Wolfram Schneider .Aq wosch@FreeBSD.org , Berlin. .Sh 日本語訳 酒井 淳嗣(sakai@csl.cl.nec.co.jp): FreeBSD向けに翻訳 diff --git a/ja_JP.eucJP/man/man1/kcon.1 b/ja_JP.eucJP/man/man1/kcon.1 index 196fe7b0e6..8cb02439fb 100644 --- a/ja_JP.eucJP/man/man1/kcon.1 +++ b/ja_JP.eucJP/man/man1/kcon.1 @@ -1,124 +1,124 @@ .\" Copyright (c) 1992, 2000 Hellmuth Michaelis .\" .\" 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 AUTHORS ``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 AUTHORS 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. .\" .\" Last Edit-Date: [Mon Mar 27 17:04:14 2000] .\" -.\" %FreeBSD: src/usr.sbin/pcvt/kcon/kcon.1,v 1.7.2.5 2001/12/14 16:48:10 ru Exp % +.\" %FreeBSD: src/usr.sbin/pcvt/kcon/kcon.1,v 1.7.2.6 2002/06/21 16:41:08 charnier Exp % .\" $FreeBSD$ .\" .Dd March 27, 2000 .Dt KCON 1 .Os .Sh 名称 .Nm kcon .Nd pcvt キーボードのコントロールと再割り当て .Sh 書式 .Nm .Op Fl d Ar delay .Op Fl l .Op Fl m Ar map .Op Fl o .Op Fl p .Op Fl R .Op Fl r Ar rate .Op Fl s .Op Fl t Ns Ar +/- .Op Fl x .Sh 解説 .Nm -は、 'pcvt' ビデオドライバのためにキーボード設定の全ての側面を +ユーティリティは、'pcvt' ビデオドライバのためにキーボード設定の全ての側面を 制御するために使われます。 .Pp 利用可能なオプションは以下の通りです。 .Bl -tag -width flag .It Fl d Ar delay 最後のキーを押してから、キーボードがリピートするまでの ディレイ時間を指定します。指定できる値は、0 から 3 で、 それぞれ 250, 500, 750, 1000 ミリ秒のディレイ時間をあらわします。 .It Fl l 現在のドライバに利用されているキーボードマップを表示します。 .It Fl m Ar map キーボード能力データベース .Nm keycap 中で探されるマップエントリを指定します。 データベース中のエントリを探索し、見付かればマップが読み込まれ、 直ちにこのドライバで使われます。 .It Fl o 現在のマップリスト中の、ディスプレイ制御コードを 8 進数に切り替えます。 .Fl l オプションと一緒に使われます。 .It Fl p リストの時に '純粋な (pure)' 出力を使います。 エスケープ文字は 8 進もしくは 16 進で表示され、 'ESC' とは 表示されません。 .Fl l オプションと一緒に使われます。 .It Fl r Ar rate 文字のリピートレートを指定します。有効な値は 0 から 31 で、それぞれ 30 文字/秒から 2 文字/秒をあらわします。 .It Fl R キーボードをリセットします。 .It Fl s 現在のリピートレートとディレイ値を表示します。 .It Fl t Ar +/- キーリピートオプションを有効とする .Pq Ar + か、無効とする .Pq Ar - かを指定します。 .It Fl x 現在のマップの表示で、ディスプレイ制御コードを 16 進での表示に切り替えます。 .Fl l オプションと一緒に使われます。これはデフォルトの振舞いです。 .El .Sh 関連ファイル .Bl -tag -width /usr/share/misc/keycap.pcvt -compact .It Pa /usr/share/misc/keycap.pcvt インストール時に他のものを選んでいなければ、 これがキーボード能力のデータベースファイルです .It Pa /dev/console キーボードの raw デバイス .El .Sh 関連項目 .Xr keycap 3 , .Xr keycap 5 .Sh バグ .Nm -は、keycap データベース中にいくつかの矛盾を見付けます。 +ユーティリティは、keycap データベース中にいくつかの矛盾を見付けます。 エラーの場合、 .Nm はエラーメッセージを表示して、終了します。この場合、キーボードは 未定義状態になるかもしれません。この状態を回復するためには、 .Dq Li kcon -m default を実行してください。 .Sh 使用例 コマンド .Dq Li kcon -m gb は、英国のキーボードの振舞いに切り替えるために 'gb' エントリを keycap ファイルからキーボードへ読み込みます。 .Pp コマンド .Dq Li kcon -r 0 -d 0 は、キーが 250 ミリ秒押し続けられた後で、キーボードの文字を出すレート を 30 文字/秒に設定します。 diff --git a/ja_JP.eucJP/man/man1/keylogin.1 b/ja_JP.eucJP/man/man1/keylogin.1 index 52f3e74a40..646ec8b653 100644 --- a/ja_JP.eucJP/man/man1/keylogin.1 +++ b/ja_JP.eucJP/man/man1/keylogin.1 @@ -1,34 +1,34 @@ .\" @(#)keylogin.1 1.5 91/03/11 TIRPC 1.0; .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. -.\" %FreeBSD: src/usr.bin/keylogin/keylogin.1,v 1.5.2.1 2001/07/22 12:40:14 dd Exp % +.\" %FreeBSD: src/usr.bin/keylogin/keylogin.1,v 1.5.2.2 2002/06/21 15:27:23 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/keylogin.1,v 1.4 2001/05/14 01:07:25 horikawa Exp $ +.\" $FreeBSD$ .\" .\" WORD: decrypt 復号する[keyserv.8] .\" .Dd September 9, 1987 .Dt KEYLOGIN 1 .Os .Sh 名称 .Nm keylogin .Nd 秘密鍵の復号と保存 .Sh 書式 .Nm .Sh 解説 .Nm -は、ユーザにログインパスワードの入力をうながし、 +ユーティリティは、ユーザにログインパスワードの入力をうながし、 これを使用して .Xr publickey 5 データベースに格納されたユーザの秘密鍵を復号します。 ひとたび復号されたユーザの鍵は、 NFS などの安全なネットワークサービスが使用できるように、 ローカルのキーサーバプロセス .Xr keyserv 8 が格納します。 .Sh 関連項目 .Xr chkey 1 , .Xr keylogout 1 , .Xr login 1 , .Xr publickey 5 , .Xr keyserv 8 , .Xr newkey 8 diff --git a/ja_JP.eucJP/man/man1/keylogout.1 b/ja_JP.eucJP/man/man1/keylogout.1 index 732957a033..7945dcab4b 100644 --- a/ja_JP.eucJP/man/man1/keylogout.1 +++ b/ja_JP.eucJP/man/man1/keylogout.1 @@ -1,42 +1,42 @@ -.\" %FreeBSD: src/usr.bin/keylogout/keylogout.1,v 1.4 1999/08/28 01:02:29 peter Exp % +.\" %FreeBSD: src/usr.bin/keylogout/keylogout.1,v 1.4.2.1 2002/06/21 15:27:26 charnier Exp % .\" @(#)keylogout.1 1.4 91/03/11 TIRPC 1.0; from 1.3 89/07/26 SMI; .\" $FreeBSD$ .Dd April 15, 1989 .Dt KEYLOGOUT 1 .Os .Sh 名称 .Nm keylogout .Nd 格納された秘密鍵を削除する .Sh 書式 .Nm .Op Fl f .Sh 解説 .Nm -は、鍵サーバプロセス +ユーティリティは、鍵サーバプロセス .Xr keyserv 8 が格納している鍵を削除します。 この鍵は、NFS などの安全なネットワークサービスが使用します。 これ以降の鍵へのアクセスは禁止されますが、 現在のセッション鍵は期限切れまたはリフレッシュされるまで、有効なままです。 このオプションは、 安全な RPC サービスを必要とするバックグラウンドジョブを失敗させ、 鍵を必要とする予定された .Nm at ジョブを失敗させます。 また、鍵のコピーはマシン 1 台につき 1 つだけですので、 .Pa .logout ファイルにこれを置くのは良くない考えです。 なぜなら、同一マシン上の他のセッションに影響があるからです。 .Sh オプション .Bl -tag -width indent .It Fl f ルート鍵 (rootkey) を忘れます。 サーバで実行すると、安全な NFS を破綻させます。 .El .Sh 関連項目 .Xr chkey 1 , .Xr keylogin 1 , .Xr login 1 , .Xr publickey 5 , .Xr keyserv 8 , .Xr newkey 8 diff --git a/ja_JP.eucJP/man/man1/killall.1 b/ja_JP.eucJP/man/man1/killall.1 index e172209c76..becbcdae7e 100644 --- a/ja_JP.eucJP/man/man1/killall.1 +++ b/ja_JP.eucJP/man/man1/killall.1 @@ -1,156 +1,156 @@ .\" Copyright (C) 1995 by Joerg Wunsch, Dresden .\" 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(S) ``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(S) 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. .\" -.\" %FreeBSD: src/usr.bin/killall/killall.1,v 1.11.2.8 2001/12/02 15:28:13 bsd Exp % +.\" %FreeBSD: src/usr.bin/killall/killall.1,v 1.11.2.9 2002/06/21 15:27:28 charnier Exp % .\" $FreeBSD$ .\" .Dd June 25, 1995 .Os .Dt KILLALL 1 .Sh 名称 .Nm killall .Nd 名前で指定されるプロセスにシグナルを送る .\"(訳注)原文では、 kill processes by name であるが、機能から考えて .\" "プロセスにシグナルを送る"と訳した。 .\" 2.2.1R 対象(1997/04/13) Takeshi MUTOH .Sh 書式 .Nm .Op Fl d | v .Op Fl h | ?\& .Op Fl help .Op Fl l .Op Fl m .Op Fl s .Op Fl u Ar user .Op Fl t Ar tty .Op Fl c Ar procname .Op Fl SIGNAL .Op Ar procname ... .Sh 解説 .Nm -は、 +ユーティリティは、 .Xr kill 1 がプロセス id で指定されるプロセスにシグナルを送るのに対して、 名前で指定されるプロセスにシグナルをおくります。 デフォルトでは、 .Dv TERM シグナルを、 .Nm 実行者と同じ実 UID を持つ、 .Ar procname に名前が一致する全てのプロセスに送ります。 スーパユーザはどんなプロセスにたいしてもシグナルを送ることができます。 .Pp 以下のようなオプションがあります。 .Bl -tag -width 10n -offset indent .It Fl d | v これから、行おうとすることをより冗長に報告します。一つの .Fl d オプションによって、シグナルを送ろうとするプロセスの一覧が表示されるか、 一つも一致するプロセスが見付からなかったことが示されます。 .It Fl h | ?\& .It Fl help コマンドの使い方のヘルプを表示し、終了します。 .It Fl l .Xr kill 1 の様に利用可能なシグナルの名前の一覧を表示し、終了します。 .It Fl m 引数 .Ar procname を ( 大文字小文字を区別しない ) 正規表現として、 得られた名前に対して対応を取ります。 注意! 一つのドット (.) は、呼び出しユーザと同一の実 UID を持つ 全てのプロセスに一致し、 危険です。 .It Fl s 何が行われるのかだけを表示し、シグナルは送られません。 .It Fl SIGNAL デフォルトの .Dv TERM とは違うシグナルを送ります。シグナルは、 (頭に .Dv SIG を付けても付けなくても良い) 名前もしくは数字で指定します。 .It Fl u Ar user 潜在的に対応するプロセスを、指定した .Ar user に属するものに限定します。 .It Fl t Ar tty 潜在的に対応するプロセスを、指定した .Ar tty で動作するものに限定します。 .It Fl c Ar procname .Fl u または .Fl t のフラグと共に使用されたとき、潜在的に対応するプロセスを、指定した .Ar progname に限定します。 .El .Sh 全てのプロセス uid が .Nm XYZ である全てのプロセスに対してシグナルを送る動作は、 .Xr kill 1 で既にサポートされています。したがって、このような仕事を行うためには .Xr kill 1 を使ってください(たとえば、 $ kill -TERM -1 もしくは、 root になって、 $ echo kill -TERM -1 |su -m で可能です。)。 .Sh 診断 .Nm コマンドは、コマンドエラーが起こった場合は、短い利用法のメッセージを 表示し、終了状態 2 で終了します。 終了状態 1 は、一致するプロセスが見付からなかった時か、全ての プロセスに対してシグナルを送ることに成功しなかった時に返されます。 それ以外の場合は、終了状態 0 が返されます。 .Pp 診断メッセージは、 .Fl d オプションで要求された場合だけ表示されます。 .Sh 関連項目 .Xr kill 1 , .Xr sysctl 3 .Sh 歴史 .Nm コマンドは .Fx 2.1 から導入されました。 .Nm コマンドは他のプラットホームでも利用可能なように設計されています。 .Sh 作者 .An -nosplit .Nm プログラムは、 .An Wolfram Schneider によって提供されました。 このマニュアルページは .An J\(:org Wunsch によって書かれました。 現在のバージョンの .Nm は、 .An Peter Wemm が .Xr sysctl 3 を使った C で書き直しました。 diff --git a/ja_JP.eucJP/man/man1/ktrace.1 b/ja_JP.eucJP/man/man1/ktrace.1 index 56998d07bc..1c18d3560f 100644 --- a/ja_JP.eucJP/man/man1/ktrace.1 +++ b/ja_JP.eucJP/man/man1/ktrace.1 @@ -1,177 +1,177 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)ktrace.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/ktrace/ktrace.1,v 1.8.2.7 2002/03/03 01:14:45 keramida Exp % +.\" %FreeBSD: src/usr.bin/ktrace/ktrace.1,v 1.8.2.8 2002/06/21 15:27:30 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt KTRACE 1 .Os .Sh 名称 .Nm ktrace .Nd カーネルプロセスのトレースを行う .Sh 書式 .Nm .Op Fl aCcdi .Op Fl f Ar trfile .Op Fl g Ar pgrp | Fl p Ar pid .Op Fl t Ar trstr .Nm .Op Fl adi .Op Fl f Ar trfile .Op Fl t Ar trstr .Ar command .Sh 解説 .Nm -は、指定したプロセスのカーネルのトレースログを +ユーティリティは、指定したプロセスのカーネルのトレースログを とります。カーネルトレース情報はファイル .Pa ktrace.out に記録されます。 トレースされるカーネル動作には、 システムコール、namei 変換、シグナル処理、 .Tn I/O 処理が含まれます。 .Pp いったんプロセスのトレースを行うようにすると、トレースデータは プロセスが終了するか、トレースポイントがクリアされるまで記録され続けます。 トレースしたプロセスは膨大な量のログを急速に作るため、ユーザはプロセスの トレースを行う前にトレースを取り消す方法を覚えておくことを強くお勧めします。 ユーザが実行している全てのプロセスのトレース動作を取り消すには、 以下のコマンドで十分です。このコマンドが root 権限で実行された場合には、 全てのプロセスに対してトレースの取消しが行われます。 .Pp .Dl \&$ ktrace -C .Pp トレースファイルはそのままでは読めませんので、 .Xr kdump 1 を使って解析してください。 .Pp オプションとしては、以下のものがあります。 .Bl -tag -width indent .It Fl a 既存のトレースファイルを再構築しないで、後ろに追加していきます。 .It Fl C ユーザが実行している全てのプロセスのトレース動作をオフにします。 root が実行した場合はシステムのすべてのプロセスのトレースがオフになります。 .It Fl c 指定したファイルやプロセスに対するトレースポイントをクリアします。 .It Fl d 指定したプロセスの現在の子プロセスすべてに対してトレースを行います。 .It Fl f Ar trfile トレース記録を .Pa ktrace.out のかわりに .Ar trfile に記録します。 .It Fl g Ar pgid プロセスグループ内の全てのプロセスのトレースをオン (オフ) にします( .Fl g フラグは 1 つしか指定できません)。 .It Fl i 指定したプロセスが今後生成するすべての子プロセスに対し、トレースフラグを 継承させます。 .It Fl p Ar pid 指定したプロセス ID のトレースを行います (または 取り消します) ( .Fl p フラグは 1 つしか指定できません)。 .It Fl t Ar trstr この文字列引数は、カーネルトレースポイントの 1 つを 1 文字で表現しています。 以下の表は、文字とトレースポイントの対応関係を表しています。 .Pp .Bl -tag -width flag -compact .It Cm c システムコールのトレース .It Cm n namei 変換のトレース .It Cm i .Tn I/O のトレース .It Cm s シグナル処理のトレース .It Cm u ユーザでのトレース .It Cm w コンテキストスイッチ .It Cm + トレースポイントのデフォルト集合、すなわち .Cm c , n , i , s , u をトレースします。 .El .It Ar command 指定したトレースフラグで .Ar command を実行します。 .El .Pp .Fl p , .Fl g , .Ar command は相互に排他的です。同時に利用することはできません。 .Sh 使用例 # プロセス ID 34 のプロセスすべてのカーネル動作のトレースを行います。 .Dl $ ktrace -p 34 .Pp # プロセスグループ ID 15 のすべてのプロセスのカーネル動作のトレースを行い、 現在および未来の子プロセスすべてにトレースフラグを渡します。 .Dl $ ktrace -idg 15 .Pp # プロセス ID 65 のプロセスのすべてのトレースを取り消します。 .Dl $ ktrace -cp 65 .Pp # プロセス ID 70 のプロセスとそのすべての子プロセスの、シグナルに関する トレースを取り消します。 .Dl $ ktrace -t s -cdp 70 .Pp # プロセス ID 67 のプロセスの .Tn I/O に関するトレースを有効にします。 .Dl $ ktrace -ti -p 67 .Pp # コマンド "w" を実行し、システムコールのみのトレースを行います。 .Dl $ ktrace -tc w .Pp # "tracedata" ファイルに対するすべてのトレースを取り消します。 .Dl $ ktrace -c -f tracedata .Pp # ユーザが所有しているすべてのプロセスのトレースを取り消します。 .Dl $ ktrace -C .Sh 関連項目 .Xr kdump 1 .Sh バグ .Ar trfile が普通のファイルの場合だけ働きます。 .Sh 歴史 .Nm コマンドは .Bx 4.4 から実装されました。 diff --git a/ja_JP.eucJP/man/man1/lam.1 b/ja_JP.eucJP/man/man1/lam.1 index b64fed3057..f47ba88fd1 100644 --- a/ja_JP.eucJP/man/man1/lam.1 +++ b/ja_JP.eucJP/man/man1/lam.1 @@ -1,145 +1,145 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lam.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/lam/lam.1,v 1.4.2.5 2001/09/27 17:59:13 wollman Exp % +.\" %FreeBSD: src/usr.bin/lam/lam.1,v 1.4.2.6 2002/06/21 15:27:34 charnier Exp % .\" $FreeBSD$ .\" .Dd September 20, 2001 .Dt LAM 1 .Os .Sh 名称 .Nm lam .Nd ファイルを並べて結合する .Sh 書式 .Nm .Op Fl f Ar min . Ns Ar max .Op Fl s Ar sepstring .Op Fl t Ar c .Ar .Nm .Op Fl p Ar min . Ns Ar max .Op Fl s Ar sepstring .Op Fl t Ar c .Ar .Sh 解説 .Nm は指定されたファイルを並べてコピーし、標準出力に出力します。 各入力ファイル .Ar file の .Em n 行目は、出力の .Em n 行目を構成する要素と見なされ、結合されます。 `\fB\-\fP' というファイル名は標準入力と見なされ、 繰り返し指定することもできます。 .Pp 通常、各オプションはその直後の .Ar file に対してのみ有効です。 オプション文字が大文字で指定されれば、 再び大文字になっていないオプションが現れるまで、 後続する全てのファイルに対して適用されます。 オプションは以下の通りです。 .Bl -tag -width indent .It Fl f Ar min . Ns Ar max 行の構成要素をフォーマット文字列 .Ar min . Ns Ar max に従って出力します。ここで .Ar min は最小フィールド幅、 .Ar max は最大フィールド幅です。 もし .Ar min がゼロで始まっていれば、 フィールド幅を満たすためにゼロが付加されます。 もし .Ar min が `\-' で始まっていれば、その要素はフィールド内で左詰めされます。 .It Fl p Ar min . Ns Ar max .Fl f と同様ですが、 このファイルが EOF に達したにもかかわらず他のファイルがまだ残っていれば、 このファイルのフィールドをパディングします。 .It Fl s Ar sepstring 次のファイルからの行要素を表示する前に .Ar sepstring を表示します。 このオプションは最終ファイルの後に指定することもできます。 .It Fl t Ar c 入力ファイルの行の終端文字として、改行文字に代えて、 .Ar c を用います。 省略された各出力行には、通常、改行文字が追加されます。 .El .Pp 複数ファイルを並べて表示する簡便な方法については .Xr pr 1 を参照して下さい。 .Sh 使用例 次のコマンド .Bd -literal lam file1 file2 file3 file4 .Ed .Pp は4つのファイルを各々行毎に結合します。 4つの異なるファイルの行をマージするには、以下のコマンドを用います。 .Bd -literal lam file1 \-S "\\ " file2 file3 file4 .Ed .Pp 1つのファイルの行を1行おきに結合するには、以下のコマンドを用います。 .Bd -literal lam \- \- < file .Ed .Pp `@' で示された部分を置換して letter を作成するには、 以下のコマンドを用います。 .\" ↑この部分、やや意味不明。原文は以下の通り。 .\" a form letter with substitutions keyed by `@' can be done with .Bd -literal lam \-t @ letter changes .Ed .Sh 関連項目 .Xr join 1 , .Xr paste 1 , .Xr pr 1 , .Xr printf 3 .Sh 規格 .Nm の機能の一部は、 .Xr paste 1 ユーティリティとして、 .St -p1003.2 が標準化しています。 diff --git a/ja_JP.eucJP/man/man1/last.1 b/ja_JP.eucJP/man/man1/last.1 index 25bc3194f2..02d154d2fe 100644 --- a/ja_JP.eucJP/man/man1/last.1 +++ b/ja_JP.eucJP/man/man1/last.1 @@ -1,214 +1,214 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)last.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/last/last.1,v 1.6.2.5 2002/03/11 20:08:08 iedowse Exp % +.\" %FreeBSD: src/usr.bin/last/last.1,v 1.6.2.6 2002/06/21 15:27:37 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd March 1, 2002 .Dt LAST 1 .Os .Sh 名称 .Nm last .Nd 最近ログインしたユーザの記録を表示する .Sh 書式 .Nm .Op Fl Ns Ar n .Oo .Fl d .Sm off .Op Oo Ar CC Oc Ar YY .Op Ar MM DD .Ar hh mm .Op Ar .SS .Sm on .Oc .Op Fl f Ar file .Op Fl h Ar host .Op Fl s .Op Fl t Ar tty .Op Fl w .Op Ar user ... .Sh 解説 .Nm -は指定された +ユーティリティは指定された .Ar user , .Ar tty , や .Ar host でのログインしてからログアウトまでを 最近の物から表示します。 または、本コマンドは、指定した時刻にログインしていたユーザを表示します。 出力の各行には、ユーザ名、セッションを処理した tty、ホスト名、セッションの 開始および終了時刻、セッションの期間の情報が含まれます。セッションがまだ 継続中であるか、クラッシュないしシャットダウンにより中断された場合は そのように表示されます。 .Pp .Bl -tag -width indent-two .It Fl Ar n 表示するセッション情報を、 .Ar n 行 以内に制限します。 .It Fl d Ar date スナップショットの日時を指定します。 そのスナップショットの日時にログインしていた全ユーザが報告されます。 保存されている wtmp ファイルから結果を引き出すために、 .Fl f オプションを使用可能です。 本オプションが指定されると、 .Fl f と .Fl Ar n 以外の全オプションは無視されます。 引数は次の書式であるべきです: .Sm off .Op Oo Ar CC Oc Ar YY .Op Ar MM DD .Ar hh mm .Op Ar .SS .Sm on ここで、各文字の組は次の意味です: .Pp .Bl -tag -width Ds -compact -offset indent .It Ar CC 年の最初の 2 桁 (世紀)。 .It Ar YY 年の次の 2 桁。 .Ar YY が指定され、 .Ar CC が指定されない場合、 .Ar YY に 69 から 99 の値を指定すると .Ar CC の値は 19 になります。 そうでない場合、 .Ar CC の値は 20 になります。 .It Ar MM 月であり、1 から 12 です。 .It Ar DD 日であり、1 から 31 です。 .It Ar hh 時間であり、0 から 23 です。 .It Ar mm 分であり、0 から 59 です。 .It Ar SS 秒であり、0 から 61 です。 .El .Pp .Ar CC と .Ar YY の文字の組が指定されない場合、値は現在の年になります。 .Ar SS 文字の組が指定されない場合、値は 0 になります。 .It Fl f Ar file 指定したファイルからログイン情報ファイルを読み込みます。デフォルト では、 .Pa /var/log/wtmp を読み込みます。 .It Fl h Ar host .Ar host は、ホスト名かインターネットアドレスを指定します。 .It Fl s ログインセッションの長さを、デフォルトの日数・時間数・分数ではなく、 秒数でレポートします。 .It Fl t Ar tty .Ar tty を指定します。 .Ar tty には、完全な 端末名か、tty を省略した名前を使うことができます。たとえば、 .Dq Li "last -t 03" は、 .Dq Li "last -t tty03" と同じです。 .It Fl w ログインセッションのフィールド幅を広げ、 デフォルトの日数・時間数・分数のみではなく、秒数もレポートします。 .It Fl y セッション開示時刻に年もレポートします。 .El .Pp 複数の引数が与えられ、スナップショットの日時が指定されないと、 .Nm はそれらの引数のいずれかを満足するすべての セッション情報を表示しようとします。すなわち、 .Dq Li "last root -t console" とすると、 .Dq Li root の行ったセションのすべてと、端末 console 上での セッションのすべてを表示します。もし、 .Ar user も .Ar host も .Ar tty も 指定されなければ、 .Nm はすべてのログイン、ログアウト情報を表示 します。 .Pp システムをリブートすると、その情報は仮想ユーザである .Ar reboot のセッションとして記録されます。したがって、 .Dq Li last reboot とすると、システムのリブート 間隔を知ることができます。 .Pp 割り込みが起こると、 .Pa wtmp の記録開始日時を表示します。QUIT シグナルによって割り込みが行われた場合、 .Nm は 検索を開始してからシグナルを受けるまでに検索した日付を表示し、実行を続けます。 .Sh 関連ファイル .Bl -tag -width /var/log/wtmp -compact .It Pa /var/log/wtmp ログイン情報データベース .El .Sh 関連項目 .Xr lastcomm 1 , .Xr utmp 5 , .Xr ac 8 .Sh バグ ログインシェルが何らかの理由で異常終了した場合、ログアウトの記録が wtmp ファイルに記録されない場合があります。この様な場合、last は、 ログアウトの時刻を "shutdown" と表示します。 .Sh 歴史 .Nm -は +ユーティリティは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/lastcomm.1 b/ja_JP.eucJP/man/man1/lastcomm.1 index 2ab5e7c12e..89764084c8 100644 --- a/ja_JP.eucJP/man/man1/lastcomm.1 +++ b/ja_JP.eucJP/man/man1/lastcomm.1 @@ -1,160 +1,160 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" From: @(#)lastcomm.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/lastcomm/lastcomm.1,v 1.7.2.3 2001/08/16 13:16:54 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lastcomm.1,v 1.9 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/lastcomm/lastcomm.1,v 1.7.2.4 2002/06/21 15:27:39 charnier Exp % +.\" $FreeBSD$ .\" .Dd September 18, 1996 .Dt LASTCOMM 1 .Os .Sh 名称 .Nm lastcomm .Nd 過去に実行されたコマンドの情報を逆順に表示する .Sh 書式 .Nm .Op Fl EScesu .Op Fl f Ar file .Op Ar command ...\& .Op Ar user ...\& .Op Ar terminal ...\& .Sh 解説 .Nm -は、以前に実行されたコマンドの情報を表示します。引数が +ユーティリティは、以前に実行されたコマンドの情報を表示します。引数が ないときは、現在のアカウント情報ファイルが存在している間に実行されたすべて のコマンドの記録を表示します。 .Pp 以下のオプションを使用可能です: .Bl -tag -width XXfXfileX -compact .Pp .It Fl E プロセスが終了した時刻を表示します。 .It Fl S プロセスが開始した時刻を表示します。 .It Fl c プロセスが使用した CPU 時間を表示します。 .It Fl e プロセスが経過した時間を表示します。 .It Fl s プロセスが使用したシステム時間を表示します。 .It Fl u プロセスが使用したユーザ時間を表示します。 .It Fl f Ar file デフォルトの .Pa /var/account/acct のかわりに .Ar file を読み 込みます。 .El .Pp オプションが指定されない場合には .Fl cS が仮定されます。 .Nm が引数付きで呼ばれたときは、引数で与えられた .Ar command , .Ar user , .Ar terminal にマッチする情報を表示します。 たとえば: .Pp .Dl lastcomm a.out root ttyd0 .Pp では、 .Pa a.out というコマンド名か、 .Ar root というユーザか、 .Ar ttyd0 というターミナルで実行されたコマンド全てのリストが出力されます。 .Pp 表示される情報は、次のようなものです。 .Pp .Bl -bullet -offset indent -compact .It ユーザが実行したプロセスの名前 .It システムのアカウント機能によってつけられるフラグ .It コマンドを実行したユーザ名 .It コマンドを実行した端末名 .It プロセスが使用した CPU .Pq Fl c または実 .Pq Fl e またはシステム .Pq Fl s またはユーザ .Pq Fl u 時間の合計 (秒) .It プロセスが開始 .Pq Fl S または終了 .Pq Fl E した時刻 .El .Pp フラグには次のようなものがあります: ``S'' コマンドはスーパユーザによって実行されました。 ``F'' コマンドが .Xr fork 2 を行いましたが、その後、 .Xr exec 3 を行っていません。 .\" ``C'' .\" コマンドがPDP-11互換モードで実行されました (これはVAXでのみ有効です)。 ``D'' コマンドが .Pa core ファイルを生成して終了しました。 ``X'' コマンドがシグナルで終了しました。 .Sh 関連ファイル .Bl -tag -width /var/account/acct -compact .It Pa /var/account/acct デフォルトのアカウント情報ファイル .El .Sh 関連項目 .Xr last 1 , .Xr sigvec 2 , .Xr acct 5 , .Xr core 5 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/ldd.1 b/ja_JP.eucJP/man/man1/ldd.1 index a4fa0b03b4..0dc33e6e29 100644 --- a/ja_JP.eucJP/man/man1/ldd.1 +++ b/ja_JP.eucJP/man/man1/ldd.1 @@ -1,60 +1,60 @@ -.\" %FreeBSD: src/usr.bin/ldd/ldd.1,v 1.12.2.6 2002/02/18 08:47:51 sobomax Exp % +.\" %FreeBSD: src/usr.bin/ldd/ldd.1,v 1.12.2.7 2002/06/21 15:27:41 charnier Exp % .\" .\" $FreeBSD$ .Dd October 22, 1993 .Dt LDD 1 .Os .Sh 名称 .Nm ldd .Nd 依存する共有オブジェクトの一覧 .Sh 書式 .Nm .Op Fl v .Op Fl f Ar フォーマット .Ar プログラム ... .Sh 解説 .Nm -は、 +ユーティリティは、 指定されたプログラムの実行または 指定された共有オブジェクトのロードに必要な、 すべての共有オブジェクトを表示します。 .Xr nm 1 とは異なり、 共有オブジェクトが更に別の共有オブジェクトを必要としているような .Dq 間接 依存にも対応しています。 .Pp 0、 1、 あるいは 2 つの .Fl f オプションが使用できます。 その引数は、 .Xr rtld 1 に渡されるフォーマット文字列であり、 .Nm の出力をカスタマイズします。 使用できる変換文字のリストは .Xr rtld 1 を見てください。 .Pp .Fl v オプションは、 実行プログラム中の符号化されたダイナミックリンクヘッダの 冗長なリストを表示します。 各フィールドの意味については ソースコードとインクルードファイルを見てください。 .Sh 関連項目 .Xr ld 1 , .Xr nm 1 , .Xr rtld 1 .Sh 歴史 .Nm は SunOS 4.0 で最初に登場し、 .Fx 1.1 で現在の形になりました。 .Pp .Fl v のサポートは、 .An John Polstra Aq jdp@polstra.com によって書かれたコードに基づいています。 diff --git a/ja_JP.eucJP/man/man1/leave.1 b/ja_JP.eucJP/man/man1/leave.1 index ea7545948c..532d275073 100644 --- a/ja_JP.eucJP/man/man1/leave.1 +++ b/ja_JP.eucJP/man/man1/leave.1 @@ -1,94 +1,94 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)leave.1 8.3 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.bin/leave/leave.1,v 1.4.2.3 2001/06/03 23:56:31 dd Exp % +.\" %FreeBSD: src/usr.bin/leave/leave.1,v 1.4.2.4 2002/06/21 15:27:44 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/leave.1,v 1.6 2001/07/12 00:16:01 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt LEAVE 1 .Os .Sh 名称 .Nm leave .Nd 何時離席すべきかを知らせる .Sh 書式 .Nm .Op Oo Cm \&+ Oc Ns Ar hhmm .Sh 解説 -.Nm leave -は指定した時刻が来るまで待ち、出発すべきことを思い出させます。 +.Nm +ユーティリティは指定した時刻が来るまで待ち、出発すべきことを思い出させます。 指定した時刻の 5 分前と 1 分前、その時間にお知らせが届き、 その後は、 1 分毎にお知らせが届きます。 あなたがログオフした場合には、 .Nm は次のメッセージを出す前に終了します。 .Pp 次のオプションを利用可能です: .Bl -tag -width indent .It Ar hhmm .Ar hhmm 形式での時刻の指定です。 .Ar hh は (12 時間形式もしくは 24 時間形式での) 時間の指定で、 .Ar mm は分の指定です。 全ての時刻は 12 時間形式に変換され、次の 12 時間以内が仮定されます。 .It Cm \&+ もし、時刻が .Ql Cm \&+ , の形式で指定された場合、現在から指定された時間と分が経過した時に お知らせが届きます。 .El .Pp 引数が与えられなかった時は、 .Nm は "When do you have to leave?" と尋ねます。 改行の入力は、 .Nm を終了し、それ以外の場合は時刻が入力されたものと仮定します。 この形式は、 .Pa .login や .Pa .profile に記述しておくのに適しています。 .Pp .Nm を終了したい場合は、ログオフするか、 .Ql kill \-KILL をプロセスに送らねばなりません。 .Sh 関連項目 .Xr calendar 1 .Sh 歴史 .Nm コマンドは .Bx 3.0 から導入されました。 diff --git a/ja_JP.eucJP/man/man1/limits.1 b/ja_JP.eucJP/man/man1/limits.1 index 5aeca2dd97..412dfcfe70 100644 --- a/ja_JP.eucJP/man/man1/limits.1 +++ b/ja_JP.eucJP/man/man1/limits.1 @@ -1,324 +1,328 @@ .\" Copyright (c) 1996 David Nugent .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, is permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice immediately at the beginning of the file, without modification, .\" 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. This work was done expressly for inclusion into FreeBSD. Other use .\" is permitted provided this notation is included. .\" 4. Absolutely no warranty of function or purpose is made by the author .\" David Nugent. .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" -.\" %FreeBSD: src/usr.bin/limits/limits.1,v 1.14.2.6 2001/08/16 13:16:55 ru Exp % +.\" %FreeBSD: src/usr.bin/limits/limits.1,v 1.14.2.7 2002/06/21 15:27:46 charnier Exp % .\" .\" $FreeBSD$ .Dd January 15, 1996 .Dt LIMITS 1 .Os .Sh 名称 .Nm limits .Nd リソースの制限値の設定および表示 .Sh 書式 .Nm .Op Fl C Ar class .Op Fl SHB .Op Fl ea .Op Fl cdflmnstu Op val .Nm .Op Fl C Ar class .Op Fl SHB .Op Fl cdflmnstu Op val .Op Fl E .Op Ar name Ns = Ns Ar value ... .Op Ar command .Nm .Op Fl U Ar user .Op Fl SHB .Op Fl ea .Op Fl cdflmnstu Op val .Nm .Op Fl U Ar user .Op Fl SHB .Op Fl cdflmnstu Op val .Op Fl E .Op Ar name Ns = Ns Ar value ... .Op Ar command .Sh 解説 .Nm -はカーネルのリソース制限の表示および設定を行ないます。また、 +ユーティリティはカーネルのリソース制限の表示および設定を行ないます。 +また、 .Xr env 1 のように環境変数を設定して、プログラムを選択したリソースで動作させるこ ともできます。 .Nm コマンドは以下の 3 通りの使い方ができます: .Pp .Bl -tag -width indent .It Xo .Nm .Op Ar limitflags .Op Ar name Ns = Ns Ar value .Ar command .Xc この使い方では .Ar limitflags にしたがって制限をセットし、オプションで .Ar name Ns = Ns Ar value のペアで与えられた環境変数をセットし、指定されたコマンドを実行します。 .It Xo .Nm .Op Ar limitflags .Xc この使い方ではリソースの設定の値は実際には設定せずに、設定値を .Ar limitflags にしたがって決定し、標準出力に出力します。 デフォルトでは、呼び出しプロセスにおいて有効な 現在のカーネルのリソースの設定値を出力します。 .Fl C Ar class や .Fl U Ar user フラグを使うと、ログイン能力データベース .Xr login.conf 5 で設定されているログインクラスのリソース制限エントリによって変更された 現在のリソース設定を表示します。 .It Xo .Nm .Fl e Op Ar limitflags .Xc この使い方では .Ar limitflags にしたがってリソースの設定値を決定しますが、実際には設定は行ないません。 前の使い方のように、これらの設定値を標準出力しますが、 シェルをコールするのに都合の良いように .Em eval の形式で出力します。 コールされるシェルは、親プロセスの .Pa /proc ファイルシステム中のエントリを調べて決定されます。 もし、シェルが判明すると (すなわち sh, csh, bash, tcsh, ksh, pdksh, rc のいずれか)、 .Nm は 'limit' もしくは 'ulimit' コマンドをそのシェルが解釈できるフォーマットで 出力します。シェル名が決定できなかった場合は、 .Xr sh 1 によって使われる 'ulimit' 形式で出力します。 .Pp これはスクリプトで制限を設定したり、 デーモンや他のバックグランドタスクを リソースを制限して起動したりする場合に非常に便利な機能です。 また、ログインクラスデータベースを設定し中央データベースを保守することにより、 最大使用リソースをグローバルに設定することができるという利点があります。 .Pp .Nm は通常 シェルスクリプト中では次のようにバッククォーテーションに囲み評価するよ うにして使われます。 .Pp .Dl eval `limits -e -C daemon` .Pp これで .Nm の出力が評価され、現在のシェルで設定されます。 .El .Pp 上記の中で指定された limitflags の値には以下のオプションのうちの 1 つ以上のものが含まれます: .Pp .Bl -tag -width "-d [limit]" .It Fl C Ar class 現在のリソースの値をもとに、ログインクラス "class" で適用される リソースエントリによって変更したものを使います。 .It Fl U Ar user 現在のリソースの値をもとに、"user" が属するログインクラスに適用される リソースエントリによって変更したものを使います。 user がどのクラスにも属していない場合、"default" クラスが存在すればそ のリソース能力が使用され、もしそのユーザがスーパユーザアカウントであれ ば、"root" クラスが使用されます。 .It Fl S リソースの "soft" (もしくは現在の) 制限を表示もしくは設定します。 このスイッチに続いて指定される制限の設定は、 .Fl H や .Fl B フラグでオーバライドしない限り、soft リミットに対する設定となります。 .It Fl H リソースの "hard" (もしくは最大の) 制限を表示もしくは設定します。 このスイッチに続いて指定される制限の設定は、 .Fl S や .Fl B フラグでオーバライドしない限り、hard リミットに対する設定となります。 .It Fl B リソースの "soft" (現在の) および "hard" (最大の) 制限を表示もしくは設 定します。 このスイッチに続いて指定される制限の設定は、 .Fl S や .Fl H フラグでオーバライドしない限り、soft リミットおよび hard リミットの 両者に対する設定となります。 .It Fl e 出力を "eval mode" (評価モード) の書式にします。 これは表示モードでのみ有効であり、コマンドを実行するときには使えません。 出力に使用される正確なシンタックスは .Nm が起動されたシェルのタイプに依存します。 .It Fl b Op Ar limit .Em sbsize 資源制限を選択または設定します。 .It Fl c Op Ar limit .Em coredumsize のリソースの制限を選択もしくは設定 ( 'limit' が指定された場合) します。 値に 0 を指定するとコアダンプしないようになります。 .It Fl d Op Ar limit .Em datasize のリソースの制限を選択もしくは設定 ( 'limit' が指定された場合) します。 .It Fl f Op Ar limit .Em filesize のリソースの制限を選択もしくは設定します。 .It Fl l Op Ar limit .Em memorylocked のリソースの制限を選択もしくは設定します。 .It Fl m Op Ar limit .Em memoryuse のサイズの制限を選択もしくは設定します。 .It Fl n Op Ar limit .Em openfiles のリソースの制限を選択もしくは設定します。 プロセスごとの最大オープンファイル数のシステムワイドの制限は、 \&'sysctl kern.maxfilesperproc' コマンドで表示できます。 システム全体で同時にオープンできるファイルの総数は、 \&'sysctl kern.maxfiles' コマンドで表示できる値に制限されます。 .It Fl s Op Ar limit .Em stacksize のリソースの制限を選択もしくは設定します。 .It Fl t Op Ar limit .Em cputime のリソースの制限を選択もしくは設定します。 .It Fl u Op Ar limit .Em maxproc のリソースの制限を選択もしくは設定します。 UID ごとの最大プロセス数のシステムワイドの制限は、 \&'sysctl kern.maxprocperuid' コマンドで表示できます。 システム全体で同時に走行できるプロセスの総数は、 \&'sysctl kern.maxproc' コマンドで表示できる値に制限されます。 .Pp 上記のフラグのセットにおける有効な .Ar limit の値は、無限値 (もしくは カーネルにおいて定義されている最大値) を設定する場合は文字列 .Em infinity .Em inf .Em unlimited .Em unlimit のいずれかを指定し、それ以外の場合は接尾子つきの数字を指定します。 サイズに関する値はデフォルトではバイトでの値となります。また以下の 接尾子の 1 つを付けることによってその単位となります。 .Pp .Bl -tag -offset indent -width "xxxx" -compact .It b 512 バイトブロック。 .It k キロバイト (1024 バイト)。 .It m メガバイト (1024*1024 バイト)。 .It g ギガバイト。 .It t テラバイト。 .El .Pp .Em cputime リソースについてはデフォルトでは秒による値となります。 また以下の接尾子を付加することにより、それぞれの単位で指定可能です。 有効な複数の単位指定を並べると、その和を指定したことになります: .Bl -tag -offset indent -width "xxxx" -compact .It s 秒。 .It m 分。 .It h 時間。 .It d 日。 .It w 週。 .It y 年 (365 日)。 .El .Pp .It Fl E .Sq Fl E オプションを使用すると .Nm は継承している環境を完全に無視します。 .It Fl a このオプションは特定のリソースの設定が指定されていても、 全てのリソースの設定を表示させます。 例えば、USENET ニュースシステムの立ち上げ時にコアダンプを無効にしたい が、'news' アカウントに適用されるその他の全てのリソースの設定を行ない たい場合は、次のように使います: .Pp .Dl eval `limits -U news -aBec 0` .Pp .Xr setrlimit 2 コールのように、スーパユーザのみが "hard" リソース制限を引き上げるこ とができます。 root 以外のユーザはそれを引き下げるか、リソースの "soft" リミットを hard リミットの範囲で変更することができます。 プログラムを実行する場合、 .Nm が hard リミットを引き上げようとすると、それは致命的エラーとして扱われ ます。 .El .Sh 診断 .Nm -はユーザが何らかの方法で誤使用をすると EXIT_FAILURE で終了します。誤 -使用には不正なオプションを使用した場合や、同時に設定と表示のオプション +ユーティリティは、 +ユーザが何らかの方法で誤使用をすると EXIT_FAILURE で終了します。 +誤使用には不正なオプションを使用した場合や、同時に設定と表示のオプション を指定した場合、または .Fl e がプログラムを起動する時に使われた場合などが含まれます。 表示モードもしくは評価モードにて実行されたとき、 .Nm は EXIT_SUCCESS の終了ステータスで終了します。 コマンドモードで実行されコマンドの実行が成功したときには、終了ステータスは 実行されたプログラムが返すものになります。 .Sh 関連項目 .Xr csh 1 , .Xr env 1 , .Xr limit 1 , .Xr sh 1 , .Xr getrlimit 2 , .Xr setrlimit 2 , .Xr login_cap 3 , .Xr login.conf 5 , .Xr sysctl 8 .Sh バグ 明らかな理由により、 .Nm -は等号 (``='') がその名称に含まれるコマンドを扱うことができません。 +ユーティリティは、 +等号 (``='') がその名称に含まれるコマンドを扱うことができません。 .Pp 評価用の出力が選択された場合、シェルを正しく認識し、そのシェルにとって 出力が正しいシンタックスとなるためには、 .Pa /proc ファイルシステムがインストールされマウントされていなければなりません。 デフォルトの出力は .Xr sh 1 にとって有効なものとなります。そのため、 .Pa /proc マウント前に .Nm を使用できるのは、標準の bourne シェルスクリプト中でのみとなります。 .Pp .Nm -は出力や表示するリソースの設定が現在のユーザで有効であるかや、設定可能 +ユーティリティは、 +出力や表示するリソースの設定が現在のユーザで有効であるかや、設定可能 であるかについては確認を行ないません。スーパユーザアカウントのみが hard リミットを引き上げることができます。与えられた値が大きすぎる場合は .Fx カーネルは何も出力せずにその制限値を指定された値より低く設定します。 diff --git a/ja_JP.eucJP/man/man1/lint.1 b/ja_JP.eucJP/man/man1/lint.1 index 076b11e107..f5be0fd5ac 100644 --- a/ja_JP.eucJP/man/man1/lint.1 +++ b/ja_JP.eucJP/man/man1/lint.1 @@ -1,542 +1,542 @@ .\" %NetBSD: lint.1,v 1.3 1995/10/23 13:45:31 jpo Exp % .\" .\" Copyright (c) 1994, 1995 Jochen Pohl .\" 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 Jochen Pohl for .\" The NetBSD Project. .\" 4. 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. .\" -.\" %FreeBSD: src/usr.bin/xlint/xlint/lint.1,v 1.8.2.6 2001/12/14 15:53:32 ru Exp % +.\" %FreeBSD: src/usr.bin/xlint/xlint/lint.1,v 1.8.2.7 2002/06/21 15:30:23 charnier Exp % .\" .\" $FreeBSD$ .Dd August 28, 1994 .Dt LINT 1 .Os .Sh 名称 .Nm lint .Nd C プログラムの検証を行う .Sh 書式 .Bk -words .Nm .Op Fl abceghprvxzHFV .Op Fl s | t .Op Fl i | nu .Op Fl D Ar name Ns Op = Ns Ar def .Op Fl U Ar name .Op Fl I Ar directory .Op Fl L Ar directory .Op Fl l Ar library .Op Fl o Ar outputfile .Ar .Nm .Op Fl abceghprvzHFV .Op Fl s | t .Fl C Ar library .Op Fl D Ar name Ns Op = Ns Ar def .Op Fl I Ar directory .Op Fl U Ar name .Ar .Ek .Sh 解説 .Nm -は指定された C のプログラムファイルを解析し、 +ユーティリティは、指定された C のプログラムファイルを解析し、 バグの可能性がある部分、 移植性がないと考えられる部分、 あるいは無駄なコードと考えられる部分 の検出を試みます。 加えて、 .Nm -は C コンパイラより厳密な型チェックを行います。 +ユーティリティは、C コンパイラより厳密な型チェックを行います。 .Nm は最初のフェーズでシンボル .Dq Dv lint を定義して C プリプロセッサを起動します。 これにより、ある疑わしいコード部分を .Nm に変更あるいはスキップさせることができます。 それゆえ、 .Nm がチェックする全てのコードにおいては、シンボル .Sy lint は予約語とみなすべきです。 .Pp 現在 .Nm が指摘する問題点は以下のものです。 到達しない文、 先頭から入らないループ、 宣言したものの使用しない変数、 定数値となる論理式。 関数呼び出しに関しては以下のような矛盾点が指摘されます。 あるところでは値を返すが別の場所では値を返さない関数の呼び出し、 引数の個数が変化する関数の呼び出し、 関数側で想定していない型の引数を渡す関数呼び出し、 返値を使用しない関数呼び出し、 返値のない関数の存在しない返値を使用している関数呼び出し。 .Pp ファイル名引数のうち、末尾が .Pa .c で終わるものは C のソースファイルとみなされます。 ファイル名が .Pa .ln で終わるものは、以前 .Nm を .Fl i , .Fl o あるいは .Fl C オプション付きで起動した際の結果を格納したファイルとみなされます。 .Pa .ln ファイルは、 .Xr cc 1 が .Pa .c から生成するオブジェクトファイル .Pa .o に相当します。 .Nm -はまた、 +ユーティリティはまた、 .Fl l オプションによって指定された特別なライブラリを受け付けます。 これは、ライブラリ関数と変数の定義を含むものです。 .Pp .Nm -は全ての +ユーティリティは、全ての .Pa .c , .ln ファイルと .Pa llib-l Ns Ar library Ns Pa .ln (lint ライブラリ) ファイルを受け取り、 それらをコマンドラインで指定した順に処理します。 デフォルトでは、 .Nm は標準 C lint ライブラリ .Pq Pa llib-lc.ln をファイルリストの最後に付け加えます。 .Fl i オプションが指定されていれば、 .Pa .ln ファイルは無視されます。 また、 .Fl o オプションあるいは .Fl i オプションが指定されていれば、 .Pa llib-l Ns Ar library Ns Pa .ln ファイルは無視されます。 .Fl i オプションが指定されて .Em いなければ、 .Nm の 2番目の パスでこのファイルリストが相互一貫性チェックに用いられます。 このとき、 もし問題箇所が与えられたソースファイルからではなく インクルードファイルのひとつに端を発するものならば、 表示されるソースファイル名の後ろに疑問符が付けられます。 .Pp オプションは次の通りです: .Bl -tag -width indent .It Fl a .Vt long 型以外の変数に対する .Vt long 値の代入を報告します。 .It Fl aa .Fl a に加え、 小さい型への暗黙の型変換を引き起こす .Em あらゆる 整数値代入を報告します。 .It Fl b 到達し得ない .Ic break 文を報告します。 このオプションはデフォルトでは有効ではありません。 なぜなら、ほとんどの .Xr lex 1 および多くの .Xr yacc 1 出力はこのような break を数多く含むからです。 .It Fl c 移植性に問題のあるキャストについて報告します。 .It Fl e .Vt enum 型に対する不正操作や .Vt enum 型と .Sy int 型間の組み合わせについて報告します。 .It Fl g .Xr gcc 1 が C 言語に対して行っているいくつかの拡張機能についての警告を抑制します。 現在のところ、これに該当するのは以下のものです。 自動変数の集合型初期化式に現れる非定数式、 void 型へのポインタに対する算術操作、 サイズが 0 の構造体、 左辺値でない配列の添字付け、 旧形式の関数宣言を無効化するプロトタイプ宣言、 long long 整数型。 .Fl g オプションはまた、キーワード .Ic asm および .Ic inline を有効にします ( .Ic asm および .Ic inline の先頭にアンダスコアを付けたキーワードは 常に利用可能です)。 .It Fl h いくつかの発見的テストを適用して バグを発見し、スタイルを洗練し、無駄を省くことを試みます。 .It Fl i コマンドラインの各 .Pa .c ファイルに対して .Pa .ln ファイルを生成します。 これらの .Pa .ln ファイルは .Nm の最初のパスの結果に過ぎず、 関数間の一貫性チェックは行われません。 .It Fl n 標準ライブラリに対する一貫性チェックを行いません。 .It Fl p 他の C 方言への移植性に関するチェックを試みます。 .It Fl r 重複した宣言が見つかった場合、前回の宣言の位置を報告します。 .It Fl s 厳密な ANSI C モードでチェックします。 ANSI C で必要とされる警告およびエラーを出力します。 従来の C と ANSI C とで異なる振る舞いをする構造に対しての警告は行いません。 .Fl s オプション指定時は、 プリプロセッサマクロとして .Dv __STRICT_ANSI__ が定義されます。 .It Fl t 従来の C モードでチェックします。 このモードでは .Dv __STDC__ は定義されません。 従来の C で許可されない構造に対して警告が出力されます。 従来の C と ANSI C とで異なる振る舞いをする構造に対しての警告は抑制されます。 マシンタイプ (例: .Dv sun3 ) およびマシンアーキテクチャ (例: .Dv m68k ) を記述したプリプロセッサマクロは、 先頭および末尾のアンダスコア無しで定義されます。 キーワード .Ic const , volatile および .Ic signed は従来の C モードでは利用できません (しかし、先頭にアンダスコアを 付したもう一方のキーワードは依然利用可能です)。 .It Fl u 使用されているが定義されていない、あるいは定義されているが使用されていない 関数および外部変数についての報告を行いません (この機能は、大規模プログラムを構成する一部のファイルに対して .Nm を走らせる場合に向いています)。 .It Fl v 関数中の未使用引数に関する報告を抑制します。 .It Fl x .Ic extern 宣言で参照されているが一度も使用されていない変数について報告します。 .It Fl z 定義されていない構造体に関する報告を抑制します (例えば、中身を関知せずに構造体へのポインタを用いる場合など)。 .It Fl C Ar library .Pa llib-l Ns Ar library Ns Pa .ln という名前の .Nm ライブラリを作成します。 このライブラリは、全ての入力ファイル .Pa .c および .Pa .ln から作られます。 これらのファイルに含まれる全ての大域関数および大域変数の宣言が 新しく作られるライブラリに書き出された後、 .Nm は .Fl l オプションで指定されたライブラリを含めた全ての入力ファイルに対して 相互一貫性のチェックを行います。 .It Fl D Ar name Ns Op = Ns Ar def .Xr cpp 1 のために .Ic #define ディレクティブと同様にしてマクロ .Ar name を定義します。 右辺値が指定されない場合、マクロ .Ar name は 1 と定義されます。 .It Fl I Ar directory インクルードファイルを検索するディレクトリリストに .Ar directory を追加します。 .It Fl l Ar library lint ライブラリ .Pa llib-l Ns Ar library Ns Pa .ln をインクルードします。 .It Fl L Ar directory lint ライブラリを標準の場所から探す前に、 .Ar directory および .Ar directory Ns Pa /lint の中を探します。 .It Fl F ファイルのパス名全体を表示します。 .Nm -は通常、パスを除いたファイル名だけを表示します。 +ユーティリティは通常、パスを除いたファイル名だけを表示します。 .It Fl H もし問題箇所がインクルードファイルに端を発するものならば、 .Nm はソースファイル名と それに続く疑問符に代えて インクルードファイル名を表示します。 .It Fl o Ar outputfile 出力ファイル名を .Ar outputfile とします。 出力ファイルは .Nm の2番目のパスの入力ファイルとなるものです。 .Fl o オプションは単に、このファイルを指定された名前でファイルに保存します。 同時に .Fl i オプションも指定されていれば、これらのファイルは一貫性をチェックされません。 .Pa llib-l Ns Ar library Ns Pa .ln ファイルを作成する際には、余分なメッセージを抑制するため、 .Fl u オプションの使用を推奨します。 lint ライブラリのソースファイルが単に外部インタフェースに過ぎない場合は、 .Fl v オプションを用いると便利です。 .It Fl U Ar name プリプロセッサが定義する全てのマクロ .Ar name を取り除きます。 .It Fl V 制御プログラムが C プリプロセッサおよび .Nm の第1 および第2 パスを実行する際のコマンドラインを表示します。 .El .Ss 入力文法 .Nm -の第1 パスは標準的な C ソースファイルを読み込みます。 +の第 1 パスは標準的な C ソースファイルを読み込みます。 .Nm -は以下のような C のコメントをコマンドとして認識します。 +ユーティリティは以下のような C のコメントをコマンドとして認識します。 .Bl -tag -width indent .It Li /* ARGSUSED Ns Ar n Li */ 最初の .Ar n 個の引数に対してのみ使用チェックを行います。 .Ar n を省略すると 0 と解釈されます (このオプションは、次の関数に対して .Fl v オプションと同様の働きをします)。 .It Xo .Li /* CONSTCOND */ 又は .Li /* CONSTANTCOND */ 又は .Li /* CONSTANTCONDITION */ .Xc 次の式に対する定数オペランドに関する報告を抑制します。 .It Xo .Li /* FALLTHRU */ 又は .Li /* FALLTHROUGH */ .Xc .Ic case あるいは .Ic default ラベルのついた文への fall through に関する報告を抑制します。 このディレクティブはそれらのラベルの直前に置く必要があります。 .It Li /* LINTLIBRARY */ ファイル先頭で、このファイル中で定義される全ての関数および変数が .Em 使用されている とマークします。 また、未使用の関数引数に関する報告も行いません。 .It Xo .Li /* LINTED Oo Ar comment Oc Li */ 又は .Li /* NOSTRICT Oo Ar comment Oc Li */ .Xc 未使用の変数あるいは関数に関するものを除き、 ファイル内に閉じた問題点に関する警告を抑制します。 このディレクティブは、 .Nm 警告が発生する場所の直前の行に置く必要があります。 .It Li /* LONGLONG */ long long 整数型の使用に関する報告を抑制します。 .It Li /* NOTREACHED */ しかるべき場所において、未到達コードに関する報告を抑制します (このコメントは通常、 .Xr exit 3 のような関数の呼び出しの直後に置きます)。 .It Li /* PRINTFLIKE Ns Ar n Li */ .Nm は最初の .Pq Ar n Ns -1 個の引数を普通にチェックします。 .Ar n 番目の引数は .Xr printf 3 のフォーマット文字列と同様に解釈され、 残りの引数をチェックするために用いられます。 .It Li /* PROTOLIB Ns Ar n Li */ もし .Ar n が 0 でなければ、 .Nm は関数宣言プロトタイプを関数宣言として取り扱います。 このディレクティブは .Li /* LINTLIBRARY */ と共にのみ用いることができます。 .Ar n が 0 の場合は、関数プロトタイプは通常通り取り扱われます。 .It Li /* SCANFLIKE Ns Ar n Li */ .Nm は最初の .Pq Ar n Ns -1 個の引数を普通にチェックします。 .Ar n 番目の引数は .Xr scanf 3 のフォーマット文字列と同様に解釈され、 残りの引数をチェックするために用いられます。 .It Li /* VARARGS Ns Ar n Li */ 後続する関数宣言において、引数個数に関する通常のチェックを抑制します。 最初の .Ar n 個の引数のデータ型がチェックされます。 .Ar n が指定されない場合は 0 と解釈されます。 .El .Pp .Fl i オプションおよび .Fl o オプションを用いると、ひと組の C ソースファイルに対して インクリメンタルに .Nm を適用することが可能です。 一般に、各ソースファイルに対して .Fl i オプション付きで .Nm を一度起動します。 このとき、 .Pa .c に対応して .Pa .ln ファイルが作成され、 それらのソースファイルに関する全てのメッセージが表示されます。 全てのソースファイルに対して個別の .Nm 処理が済んだ後、全ての .Pa .ln ファイルと必要な .Fl l Ns Ar library オプションを付け、( .Fl i オプション無しで) もう一度 .Nm を起動します。 ここでファイル間の一貫性に関する問題点が表示されます。 この方式は .Xr make 1 を用いるとうまくいきます。 .Xr make 1 を用いると、 前回ソースファイルの組が .Nm された後、修正のあったファイルに対してのみ .Nm を起動することができます。 .Sh 環境変数 .Bl -tag -width LIBDIR .It Ev LIBDIR .Bk -words .Fl l Ar library .Ek オプションで指定されたライブラリが存在するディレクトリ。 この環境変数が定義されていない場合は、ライブラリ検索のために デフォルトパスとして .Pa /usr/libdata/lint が用いられます。 .It Ev TMPDIR 一時ファイル用のパスは通常、この環境変数をセットすることで変更できます。 .El .Sh 関連ファイル .Bl -tag -width /usr/libdata/lint/llib-lc.ln -compact .It Pa /usr/libexec/lint Ns Bq Pa 12 プログラム .It Pa /usr/libdata/lint/llib-l*.ln 前もって作成されている様々な lint ライブラリ .It Pa /tmp/lint* 一時ファイル .El .Sh 関連項目 .Xr cc 1 , .Xr cpp 1 , .Xr make 1 .Sh 作者 .An Jochen Pohl .Sh バグ .Bl -item .It .Xr exit 3 や .Xr longjmp 3 および戻って来ない他の関数は正しく理解されません。 これらは様々な不正診断の原因となります。 .It 最初の extern 宣言の前でのみ用いられる static 関数は、 未使用であると報告されます。 .It .Fl o オプションによって作られたライブラリは、のちの .Nm 実行で用いた場合、 ライブラリ作成時に報告されたある種のエラーが再度報告され、 ライブラリ作成時に用いたオリジナルのソースファイルの行番号およびファイル名が エラーメッセージ中に表示されることがあります。 そのため、lint ライブラリ作成には .Fl C オプションを用いることを推奨します。 .El diff --git a/ja_JP.eucJP/man/man1/lock.1 b/ja_JP.eucJP/man/man1/lock.1 index cbf1c574b0..35a6d41e34 100644 --- a/ja_JP.eucJP/man/man1/lock.1 +++ b/ja_JP.eucJP/man/man1/lock.1 @@ -1,71 +1,72 @@ .\" Copyright (c) 1987, 1990 The Regents of the University of California. .\" 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 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. .\" .\" from: @(#)lock.1 6.9 (Berkeley) 7/27/91 -.\" %FreeBSD: src/usr.bin/lock/lock.1,v 1.4.2.2 2001/07/22 12:40:19 dd Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lock.1,v 1.4 2001/05/14 01:07:25 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/lock/lock.1,v 1.4.2.3 2002/06/21 15:27:48 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt LOCK 1 .Os .Sh 名称 .Nm lock .Nd 端末を予約する .Sh 書式 .Nm .Op Fl n .Op Fl p .Op Fl t Ar timeout .Sh 解説 .Nm -はユーザにパスワードを要求し、確認のためにもう一度パスワードを +ユーティリティは、 +ユーザにパスワードを要求し、確認のためにもう一度パスワードを 聞きます。以降そのパスワードがもう一度入力されるまで、 このプログラムはその端末を占有して利用できない状態にします。 このプログラムを終了するには、その他に二つの方法があります: ひとつは決められた時間まで待ってタイムアウトさせる方法、 もうひとつは権限を持つユーザがそのプロセスを kill するという方法です。 .Pp オプションは以下のものがあります: .Bl -tag -width Fl .It Fl n タイムアウト値を使用しません。端末を永遠にロックします。 .It Fl p 設定時にパスワードが要求されず、代りにユーザの現行のパスワードが使われます。 .It Fl t Ar timeout タイムリミットを .Ar timeout 分に変更します (デフォルトは 15 分)。 .El .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/lockf.1 b/ja_JP.eucJP/man/man1/lockf.1 index 76e1bbedaf..71a8773475 100644 --- a/ja_JP.eucJP/man/man1/lockf.1 +++ b/ja_JP.eucJP/man/man1/lockf.1 @@ -1,130 +1,130 @@ .\" .\" Copyright (C) 1998 John D. Polstra. 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 JOHN D. POLSTRA 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 JOHN D. POLSTRA 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. .\" -.\" %FreeBSD: src/usr.bin/lockf/lockf.1,v 1.7.2.3 2001/08/16 13:16:56 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lockf.1,v 1.8 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/lockf/lockf.1,v 1.7.2.4 2002/06/21 15:27:51 charnier Exp % +.\" $FreeBSD$ .\" .Dd July 7, 1998 .Os .Dt LOCKF 1 .Sh 名称 .Nm lockf .Nd ファイルをロックしてコマンドを実行する .Sh 書式 .Nm .Op Fl ks .Op Fl t Ar seconds .Ar file .Ar command .Op Ar arguments .Sh 解説 .Nm はファイル .Ar file に対して排他的ロックを獲得します。 この際、必要ならこのファイルを生成します。 そしてそのロックを保持したまま、 引数 .Ar arguments をつけてコマンド .Ar command を実行します。 .Ar command の実行が完了すると、 .Nm はロックを開放し、 .Fl k オプションが指定されていなければ ファイル .Ar file を削除します。 .Xr flock 2 に述べられている .Bx スタイルのロック方式が用いられます。 すなわち、 .Ar file が存在するだけではロックされているとは見なされません。 .Pp 以下のオプションが利用可能です。 .Bl -tag -width Fl .It Fl k コマンド完了後もロックを保存します (削除しません)。 .It Fl s メッセージ出力を行いません。 ロック獲得の失敗は、終了ステータスにのみ反映されます。 .It Fl t Ar seconds ロック待ちのタイムアウト値を指定します。 デフォルトでは、 .Nm はロック獲得を永遠に待ち続けます。 このオプションによりタイムアウト値が指定されていれば、 .Nm はロック獲得をあきらめるまでに最大 .Ar seconds 秒待ちます。 タイムアウトとしては 0 を指定することもでき、 その場合 .Nm はロック獲得に失敗すると即座に終了します。 .El .Pp いかなる場合でも、 他のプロセスが保持しているロックを .Nm が破棄することはありません。 .Sh 診断 ロック獲得に成功すると、 .Nm は .Ar command の終了ステータスを返します。 それ以外の場合、 .Nm は .Xr sysexits 3 にて定義されている以下のいずれかの終了コードを返します。 .Bl -tag -width F_CANTCREATX .It Dv EX_TEMPFAIL 指定されたロックファイルは他のプロセスによって既にロックされています。 .It Dv EX_CANTCREAT .Nm -はロックファイルを生成できませんでした。 +ユーティリティはロックファイルを生成できませんでした。 原因としては、例えば、適切なアクセス権がないことが考えられます。 .It Dv EX_USAGE .Nm のコマンドラインにエラーがあります。 .It Dv EX_OSERR システムコール(例えば fork)が予期せず失敗しました。 .El .Sh 関連項目 .Xr flock 2 , .Xr sysexits 3 . .Sh 歴史 .Nm -が最初に登場したのは +ユーティリティが最初に登場したのは .Fx 2.2 です。 .Sh 作者 .An John Polstra Aq jdp@polstra.com . diff --git a/ja_JP.eucJP/man/man1/logger.1 b/ja_JP.eucJP/man/man1/logger.1 index 933d4f4247..2e733ac2ef 100644 --- a/ja_JP.eucJP/man/man1/logger.1 +++ b/ja_JP.eucJP/man/man1/logger.1 @@ -1,115 +1,114 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)logger.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/logger/logger.1,v 1.4.2.5 2001/08/16 13:16:56 ru Exp % +.\" %FreeBSD: src/usr.bin/logger/logger.1,v 1.4.2.6 2002/06/21 15:27:53 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt LOGGER 1 .Os .Sh 名称 .Nm logger .Nd システムのログに記録を残す .Sh 書式 .Nm .Op Fl 46Ais .Op Fl f Ar file .Op Fl h Ar host .Op Fl p Ar pri .Op Fl t Ar tag .Op Ar message ... .Sh 解説 -.Nm logger -は、 +.Nm +ユーティリティは、 .Xr syslog 3 システムログ記録モジュールとのシェルコマンドインタフェースを提供します。 .Pp 次のオプションを使用可能です: .Bl -tag -width indent .It Fl 4 .Nm が IPv4 アドレスのみを使用するよう、強制します。 .It Fl 6 .Nm が IPv6 アドレスのみを使用するよう、強制します。 .It Fl A ホストが複数の A または AAAA レコードを持っている場合でも、 -.Nm -はメッセージを単一のアドレスにのみ送信しようとします。 +メッセージを単一のアドレスにのみ送信しようとします。 本オプションが指定されると、 .Nm はメッセージをすべてのアドレスに送信しようとします。 .It Fl i logger プロセスのプロセス ID を各行に記録します。 .It Fl s システムのログと同様に、標準エラー出力にログを出力します。 .It Fl f Ar file 指定したファイルの内容をログとして記録します。 .It Fl h Ar host ローカルでログする代わりに、リモートシステム .Ar host へメッセージを送ります。 .It Fl p Ar pri 指定した優先順位でメッセージを入力します。優先順位は、 数字で指定するか、``ファシリティ.レベル'' の組で指定されます。 たとえば、``\-p local3.info'' は .Ar local3 ファシリティに、情報( .Ar info )レベルでメッセージを記録します。デフォルトは、``user.notice'' です。 .It Fl t Ar tag 各行に指定した .Ar tag を埋め込みます。 .It Ar message この .Ar message をログとして記録します。これが指定されておらず、 .Fl f も指定されていなければ、標準入力をログとして記録します。 .El .Sh 診断 .Ex -std .Sh 使用例 .Bd -literal -offset indent -compact logger System rebooted logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc .Ed .Sh 関連項目 .Xr syslog 3 , .Xr syslogd 8 .Sh 規格 .Nm は .St -p1003.2 準拠です。 diff --git a/ja_JP.eucJP/man/man1/login.1 b/ja_JP.eucJP/man/man1/login.1 index 10baa3c6ce..48fd2ff66d 100644 --- a/ja_JP.eucJP/man/man1/login.1 +++ b/ja_JP.eucJP/man/man1/login.1 @@ -1,199 +1,199 @@ .\" %NetBSD: login.1,v 1.5 1994/12/23 06:53:00 jtc Exp % .\" .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)login.1 8.2 (Berkeley) 5/5/94 -.\" %FreeBSD: src/usr.bin/login/login.1,v 1.17.2.1 2001/07/16 07:02:39 markm Exp % +.\" %FreeBSD: src/usr.bin/login/login.1,v 1.17.2.2 2002/06/21 15:27:56 charnier Exp % .\" .\" $FreeBSD$ .Dd May 5, 1994 .Dt LOGIN 1 .Os .Sh 名称 .Nm login .Nd 指定したユーザでログインする .Sh 書式 .Nm .Op Fl fp .Op Fl h Ar hostname .Op Ar user .Sh 解説 .Nm は、指定したユーザでログインするものです。 .Pp user を指定しなかった場合、もしくは指定した user でのログインに失敗した ときには、 .Nm は、再度ユーザ名の入力を求めるプロンプトを表示します。 ユーザの確認は入力されたパスワードにより行われます。 .Pp オプションとしては以下のものがあります: .Bl -tag -width Ds .It Fl f パスワードによるユーザの確認を省略します。このオプションは、スーパーユーザ か、すでにログインしているユーザが同じユーザ名で login を実行す るときのみ指定可能です。 .It Fl h コネクションを受信可能なホスト名を指定します。この機能は .Xr telnetd 8 などのデーモンによって使われています。このオプションはスーパーユーザ しか指定することができません。 .It Fl p .Nm は、デフォルトでは実行時の環境 (環境変数など) を引き継ぎ ませんが、このオプションを指定すると、実行時の環境を引き継ぎます。 .El .Pp もし .Pa /var/run/nologin ファイルが存在した場合、 .Nm はそのファイル内容 を表示してログイン処理をせずに終了します。この機能は .Xr shutdown 8 で使用されており、システムの終了処理実行中にユーザがログインしないよう にしています。 .Pp もし .Pa /etc/login.access ファイルが存在した場合、 .Nm はそのファイルから、ユーザとホストの組が特別に許可されている、もしくは 拒否されているかどうかをチェックします。 .Pp もし .Pa /etc/fbtab ファイルが存在した場合、 .Nm はそのファイルに記述された幾つかのデバイスのプロテクトと所有者を変えます。 .Pp ファイル .Pa /etc/skeykeys が存在する場合、このファイル中にユーザのエントリが存在する時には、 .Nm は S/key パスワード認証を行います。 .Pa /etc/skey.access により、 接続元のホストやネットワークに応じて S/key パスワード使用の義務を制御します。 .Pp 通常、ユーザがログインすると、 .Nm はシステムのコピーライト表示、 ユーザが最後にログインした日付と時間、その日のメッセージなどの 情報を表示します。ただし、ユーザのホームディレクトリに .Dq Pa .hushlogin というファイルが存在した場合は、これらのメッセージを表示 しないようにします (これは .Xr uucp 1 のようなプログラムがユーザとしてログインするためにあります)。 このあと、 .Nm -は +ユーティリティは .Xr wtmp 5 と .Xr utmp 5 ファイルに記録し、ユーザのコマンドインタプリタ (シェル) を起動します。 .Pp なお、環境変数 ( .Xr environ 7 ) HOME, SHELL, PATH, TERM, LOGNAME, USER は .Nm -によりセットされます。 +ユーティリティによりセットされます。 他の環境変数はログインクラスケーパビリティデータベースの エントリにより設定されるかも知れません。 ログインクラスはユーザのシステムパスワードレコードに割り当てられています。 ログインクラスは、当該ログインに許された最大および現在の資源制約、 プロセス優先度や他の多くのユーザログイン環境を制御します。 .Pp シェルによっては、本ユーティリティと似たまたは同じ、組み込みの .Nm コマンドを提供するものがあります。 .Xr builtin 1 マニュアルページを参照してください。 .Sh 関連ファイル .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 /var/run/nologin ログインを拒否する時に表示するメッセージ .It Pa /etc/skey.access skey パスワード制御表 .It Pa /etc/skeykeys skey パスワードデータベース .It Pa /var/run/utmp 現在のログイン状況 .It Pa /var/log/lastlog 最後にログインした記録 .It Pa /var/log/wtmp ログイン・ログアウト状況 .It Pa /var/mail/user ユーザごとのメイルボックス .It Pa \&.hushlogin ログインメッセージを抑止するファイル .It Pa /etc/auth.conf 認証サービスの設定 .It Pa /etc/pam.conf .Nm が PAM サポート付きで設定されている場合、サービス名 .Dq login で .Pa /etc/pam.conf エントリを見ます .El .Sh 関連項目 .Xr builtin 1 , .Xr chpass 1 , .Xr csh 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 nologin 5 , .Xr skey.access 5 , .Xr utmp 5 , .Xr environ 7 , .Xr nologin 8 , .Xr pam 8 .Sh 歴史 .Nm login ユーティリティは .At v6 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/look.1 b/ja_JP.eucJP/man/man1/look.1 index 82008ae6d7..540e7bd0f3 100644 --- a/ja_JP.eucJP/man/man1/look.1 +++ b/ja_JP.eucJP/man/man1/look.1 @@ -1,106 +1,106 @@ .\" %NetBSD: look.1,v 1.3 1994/12/23 01:10:59 jtc Exp % .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. -.\" %FreeBSD: src/usr.bin/look/look.1,v 1.6.2.2 2001/07/22 12:40:24 dd Exp % +.\" %FreeBSD: src/usr.bin/look/look.1,v 1.6.2.3 2002/06/21 15:27:58 charnier Exp % .\" .\" @(#)look.1 8.1 (Berkeley) 6/14/93 -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/look.1,v 1.5 2001/05/14 01:07:25 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 14, 1993 .Dt LOOK 1 .Os .Sh 名称 .Nm look .Nd 指定した文字列で始まる行を表示する .Sh 書式 .Nm .Op Fl df .Op Fl t Ar termchar .Ar string .Op Ar .Sh 解説 .Nm は、 .Ar file の中の各行のうち、 .Ar string で指定された文字列で始まっている行を表示します。 .Nm はバイナリサーチを使っているため、 .Ar file で指定するファイルはソートされていなければいけません。 .Pp .Ar file が指定されなかった場合は .Pa /usr/share/dict/words が使用され、 .Fl d と .Fl f オプションが暗黙に指定されます。 .Pp オプションとしては以下のものがあります: .Bl -tag -width Ds .It Fl d 辞書で使用されているアルファベットと数字だけを比較対象とします。 .It Fl f アルファベットの大文字、小文字を区別しません。 .It Fl t 文字列の最後の文字を指定する。すなわち、 .Ar string の先頭から .Ar termchar までの文字だけで比較をします。 .El .Sh 戻り値 指定の文字列で始まる行が見つかった場合は 0 を、見つか らなかった場合は 1 を、エラーが起きた場合は 2 以上の値を返します。 .Sh 関連ファイル .Bl -tag -width /usr/share/dict/words -compact .It Pa /usr/share/dict/words デフォルトで使用される辞書ファイル .El .Sh 関連項目 .Xr grep 1 , .Xr sort 1 .Sh 互換性 もともとのマニュアルでは, .Fl d オプションが指定されている時には、タブと空白は比較対象であると 述べられていました。 これは間違っていますし、現在のマニュアルでは歴史的な実装と 一致しています。 .Sh 歴史 .Nm -は +ユーティリティは .At v7 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/lorder.1 b/ja_JP.eucJP/man/man1/lorder.1 index 021d555c15..e45651d67b 100644 --- a/ja_JP.eucJP/man/man1/lorder.1 +++ b/ja_JP.eucJP/man/man1/lorder.1 @@ -1,79 +1,78 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lorder.1 8.2 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.bin/lorder/lorder.1,v 1.5 1999/08/28 01:03:16 peter Exp % +.\" %FreeBSD: src/usr.bin/lorder/lorder.1,v 1.5.2.1 2002/06/21 15:28:00 charnier Exp % .\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt LORDER 1 .Os .Sh 名称 .Nm lorder .Nd オブジェクトファイルの依存関係を出力する .Sh 書式 .Nm .Ar .Sh 解説 .Nm -は、 +ユーティリティは、 .Xr nm 1 を用いて、コマンドラインに指定されたオブジェクトファイルの依存関係を 決定します。 .Nm -は 1 行が 2 つのファイル名から構成されるリストを生成し、 +ユーティリティは 1 行が 2 つのファイル名から構成されるリストを生成し、 前のファイルが後ろのファイルで定義されているシンボルを参照している ことを示します。 .Pp -.Nm -の出力を +出力を .Xr tsort 1 で処理することで、ライブラリ・アーカイブ作成時に一回のパスで参照が解決 できるような最適なオブジェクトの順序を決定することができます .Po 使用例の項参照 .Pc 。 .Sh 使用例 .Bd -literal -offset indent ar cr library.a `lorder ${OBJS} | tsort` .Ed .Sh 関連項目 .Xr ar 1 , .Xr ld 1 , .Xr nm 1 , .Xr ranlib 1 , .Xr tsort 1 .Sh 歴史 .Nm は .At v7 で追加されました。 diff --git a/ja_JP.eucJP/man/man1/lp.1 b/ja_JP.eucJP/man/man1/lp.1 index 767163eadd..05925f807f 100644 --- a/ja_JP.eucJP/man/man1/lp.1 +++ b/ja_JP.eucJP/man/man1/lp.1 @@ -1,121 +1,120 @@ .\" .\" Copyright (c) 1995 Joerg Wunsch .\" .\" All rights reserved. .\" .\" This program is free software. .\" .\" 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 Joerg Wunsch .\" 4. The name of the developer may not be used to endorse or promote .\" products derived from this software without specific prior written .\" permission. .\" .\" 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. .\" -.\" %FreeBSD: src/usr.sbin/lpr/lp/lp.1,v 1.12.2.3 2001/08/16 15:56:03 ru Exp % +.\" %FreeBSD: src/usr.sbin/lpr/lp/lp.1,v 1.12.2.4 2002/06/21 16:40:43 charnier Exp % .\" $FreeBSD$ .\" .Dd January 22, 1995 .Dt LP 1 .Os .Sh 名称 .Nm lp .Nd プリントスプーラのフロントエンド .Sh 書式 .Nm .Op Fl cs .Op Fl o Ar option .Op Fl d Ar printer .Op Fl n Ar num .Op Ar name ... .Sh 解説 .Nm -は +ユーティリティは .St -p1003.2 規格で必要とされるプリントスプーラのフロントエンドです。実際には -.Nm -は、適切な引数をつけて +本ユーティリティは、適切な引数をつけて .Xr lpr 1 を起動します。 .Pp 通常、 -.Nm +本ユーティリティ は指定されたファイルをターゲットとするプリンタでプリントします。 .Pp 以下のオプションを使用可能です: .Bl -tag -width indent .It Fl c 入力ファイルにそれ以上アクセスする必要がなくなるまで .Nm は終了しません。 .Nm が終了すると、アプリケーションはプリント出力処理に影響を与えることなく、 ファイルを安全に削除あるいは修正できます。 .It Fl d Ar dst 特定のプリンタを指定します。 コマンドラインに .Fl d オプションが指定されない場合、環境変数 .Ev LPDEST あるいは .Ev PRINTER の値が (この順で) 用いられます。 .It Fl n Ar num 指定された各ファイルを .Ar num 部ずつプリント出力します。 .It Fl o Ar option プリンタ固有のオプションです。 SVR との互換性のためだけに提供されているオプションであり、 サポートされていません。 .It Fl s 黙って動作します。 .St -susv2 との互換性のためだけに提供されているオプションであり、 サポートされていません。 .El .Sh 環境変数 上で述べたように、環境変数 .Ev LPDEST および .Ev PRINTER がターゲットとするプリンタを選択するのに用いられます。 .Sh 関連項目 .Xr lpr 1 .Sh 規格 .Nm コマンドは .St -p1003.2 規格を満たすと考えられます。 .Sh 作者 この .Nm コマンドの実装は .An J\(:org Wunsch によって作成されました。 .Sh バグ .St -p1003.2 規格ではテキスト以外のファイルのプリント手段が提供されていません。 プリントするファイルは、行の長さが妥当で文字も印字可能文字に限定されている テキストファイルであることが求められています。 diff --git a/ja_JP.eucJP/man/man1/lpq.1 b/ja_JP.eucJP/man/man1/lpq.1 index b8bfff748a..ce02f319fc 100644 --- a/ja_JP.eucJP/man/man1/lpq.1 +++ b/ja_JP.eucJP/man/man1/lpq.1 @@ -1,136 +1,136 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lpq.1 8.2 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.sbin/lpr/lpq/lpq.1,v 1.5.2.3 2001/08/16 15:56:04 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lpq.1,v 1.6 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.sbin/lpr/lpq/lpq.1,v 1.5.2.4 2002/06/21 16:40:46 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt LPQ 1 .Os .Sh 名称 .Nm lpq .Nd キューに登録されている印刷ジョブの確認を行う .Sh 書式 .Nm .Op Fl a .Op Fl l .Op Fl P Ns Ar printer .Op job # ...\& .Op user ...\& .Sh 解説 .Nm -は、ラインプリンタにファイルをプリントアウトするために +ユーティリティは、ラインプリンタにファイルをプリントアウトするために .Xr lpd 8 が利用するスプールエリアを調べ、 指定したジョブもしくはユーザに関連するすべてのジョブの状態を報告します。 .Nm -を引数を指定せずに実行したときは、現在、キュー内にあるすべての +ユーティリティを引数を指定せずに実行したときは、現在、キュー内にあるすべての ジョブの状態を報告します。 .Pp オプションとしては、以下のものがあります: .Pp .Bl -tag -width indent .It Fl P 特定のプリンタを指定します。 指定しない場合は、デフォルトのラインプリンタ (もしくは環境変数 .Ev PRINTER の値)が用いられます。 この他に指定された引数はすべてユーザ名ないしジョブ番号とみなされ、 操作対象のジョブを選別するのに用いられます。 .It Fl l ジョブエントリを構成するファイルのそれぞれについての情報を 表示します。たいていは 1 行に収まる程度の情報が表示されます。 .It Fl a 特定のプリンタに対しての情報だけでなく、全てのプリンタに対する情報を 報告します。 .El .Pp 委託された(つまり .Xr lpr 1 の実行)各ジョブに対して、 .Nm はユーザ名、 キュー内でのランク、ジョブが持っているファイルの名前、ジョブ識別子 (特定のジョブを削除するために .Xr lprm 1 に引数として与えられる番号)、 そして合計のサイズを報告します。ジョブの順番はスプールディレクトリを スキャンするアルゴリズムに依存し、 .Tn FIFO (First In First Out) であると仮定しています。 ジョブのファイル名がわからない場合 ( .Xr lpr 1 がパイプラインで接続された場合など) は、ファイル名は``(standard input)'' と 表示されます。 .Pp もし .Nm がデーモンがないと警告した場合 (何かの不調が原因である)、 .Xr lpc 8 コマンドを用いてプリンタデーモンをリスタートさせてください。 .Sh 環境変数 .Bl -tag -width PRINTER .It Ev PRINTER かわりのデフォルトプリンタを指定する .El .Sh 関連ファイル .Bl -tag -width "/var/spool/*/lock" -compact .It Pa /etc/printcap プリンタの特性を記述する。 .It Pa /var/spool/* スプールディレクトリ。printcap での設定により決まる。 .It Pa /var/spool/*/cf* ジョブを明記した制御ファイル。 .It Pa /var/spool/*/lock 現在アクティブなジョブを得るためのロックファイル。 .El .Sh 関連項目 .Xr lpr 1 , .Xr lprm 1 , .Xr lpc 8 , .Xr lpd 8 .Sh 歴史 .Nm -コマンドは +ユーティリティは .Bx 3 から登場しました。 .Sh バグ スプールディレクトリに格納される情報は動的に変化するため、 .Nm の報告内容は信頼性の低い場合があります。 画面出力形式は端末の行の長さの影響を受けやすく、 行方向に余分な空白が入ることがあります。 .Sh 診断 種々のファイルがオープンできません。 ロックファイルが壊れています。 デーモンが動作していなくても、スプールディレクトリにゴミが残ることがあります。 diff --git a/ja_JP.eucJP/man/man1/lpr.1 b/ja_JP.eucJP/man/man1/lpr.1 index 0688833988..32ca555112 100644 --- a/ja_JP.eucJP/man/man1/lpr.1 +++ b/ja_JP.eucJP/man/man1/lpr.1 @@ -1,299 +1,299 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lpr.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.sbin/lpr/lpr/lpr.1,v 1.11.2.5 2001/08/16 15:56:04 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lpr.1,v 1.16 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.sbin/lpr/lpr/lpr.1,v 1.11.2.6 2002/06/21 16:40:52 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt LPR 1 .Os .Sh 名称 .Nm lpr .Nd 印刷ジョブを生成し、キューに登録する .Sh 書式 .Nm .Op Fl P Ns Ar printer .Op Fl \&# Ns Ar num .Op Fl C Ar class .Op Fl J Ar job .Op Fl L Ar locale .Op Fl T Ar title .Op Fl U Ar user .Op Fl Z Ar daemon-options .Op Fl i Ar numcols .Op Fl 1234 Ar font .Op Fl w Ar num .Op Fl cdfghlnmprstv .Op Ar name ... .Sh 解説 .Nm -は、プリンタが利用可能になったときにファイルをプリント +ユーティリティは、プリンタが利用可能になったときにファイルをプリント アウトするためにスプーリングデーモンを利用します。 もしファイル名が指定されないようなら、標準入力から読みます。 .Pp 以下の単一文字のオプションは、ファイルが通常のテキストファイルでないこ とをラインプリンタのスプールデーモンに教えるためのものです。 スプールデーモンはそのデータを適切に出力するために、 データにふさわしいフィルタを使うようになります。 すべてのスプーラがすべてのデータタイプ用のフィルタを実装しているわけではなく、 サイトによってはここに記述した以外の用途でタイプを使用している場合もある ことに注意してください。 .Bl -tag -width indent .It Fl d ファイルが .Tn TeX タイプセッティングシステムから生成された .Tn DVI フォーマットデータであるとみなします。 .It Fl f 各行の最初の文字を、標準的な FORTRAN のキャリッジコントロール キャラクタとして処理するフィルタを使うようになります。 .It Fl l コントロールキャラクタを通し、ページの区切りを抑制するフィルタを利用します。 .It Fl p ファイルの整形に .Xr pr 1 を利用します。 .El .Pp 以下のオプションは歴史的なものであり、 .Fx に含まれるソフトウェアが直接サポートするものではありません。 .Bl -tag -width indent .It Fl c ファイルが .Xr cifplot 1 で作成されたデータを含んでいるものとみなします。 .It Fl g ファイルが .Xr plot ルーチンで作成された 標準的な plot データであるとみなします。 .It Fl n ファイルが .Em ditroff (デバイスに依存しない troff) からのデータであるとみなします。 .It Fl t ファイルが、太古の .Ux .Xr troff 1 から生成された .Tn C/A/T 写植印字コマンドを含むものあるとみなします。 .It Fl v ファイルが Benson Varian のようなデバイスのためのラスタイメージを 含むものとみなします。 .El .Pp 以下のオプションは、プリントジョブを操作するときに適用します: .Bl -tag -width indent .It Fl P 指定したプリンタに出力します。これを指定しない通常の場合は、 デフォルトプリンタが使われる (これはサイトごとに依存します) か、 環境変数 .Ev PRINTER の値が使われます。 .It Fl h バーストページを出力しないようにします。 .It Fl m 終了時にメールを送ってきます。 .It Fl r スプーリングの終了時にファイルを削除します。 .Fl s オプション使用時には出力の終了時に削除します。 .It Fl s シンボリックリンクを利用します。通常、ファイルはスプールディレクトリに コピーされますが、大きなファイルをコピーするよりは .Fl s オプションで .Xr symlink 2 を使ってデータファイルにリンクを張ったほうがよいでしょう。 つまり、これはファイルのプリントアウトが完了するまでは ファイルに変更を加えたり、削除したりするべきではないということを意味します。 .El .Pp 残りのオプションはコピーを行ったり、ページの表示やヘッダの表示を行います: .Bl -tag -width indent .It Fl \&# Ns Ar num .Ar num は、各ファイルのコピーの枚数です。例えば、 .Bd -literal -offset indent lpr \-#3 foo.c bar.c more.c .Ed は、foo.c のコピーを 3 回行った後、bar.c のコピーを 3 回行います。一方、 .Bd -literal -offset indent cat foo.c bar.c more.c \&| lpr \-#3 .Ed .Pp は、連結されたファイルのコピーを 3 回行います。 この機能を禁止してコピー機の使用を推奨しているサイトがあるかもしれません。 .It Xo .Fl Ns Op Cm 1234 .Ar font .Xc フォントポジション .Ar i のフォントを指定します。デーモンはフォントのパス名を参照する .Li .railmag ファイルを作成します。 .It Fl C Ar class バーストページで使うジョブ見出しです。例えば、 .Bd -literal -offset indent lpr \-C EECS foo.c .Ed .Pp は、バーストページのシステム名 ( .Xr hostname 1 で返される) を EECS に置き換えて、foo.c をプリントします。 .It Fl J Ar job バーストページに書くジョブ名です。通常は、 一番最初のファイルの名前が使われます。 .It Fl L Ar locale 環境変数の代りに、引数で指定される .Ar locale を使用します。( .Fl p オプションを使用して .Xr pr 1 によるフィルタリングを要求した場合のみ有効です。) .It Fl T Ar title .Xr pr 1 のタイトル名に、ファイル名のかわりにこのタイトルを使います。 .It Fl U Ar user バーストページで使うユーザ名であり、課金目的でも利用されます。 このオプションは実ユーザ id が daemon (あるいは daemon の代わりに printcap 中で指定されているユーザ) のみ使用できます。 .It Fl Z Ar daemon-options .Tn LPRng 等、スプーラによっては、更なるジョブ毎のオプションを、 .Ql Z 制御行を受け付けます。 .Fl Z が指定され、 .Fl p .Pq Xr pr 1 が指定されなかったとき、指定された .Ar daemon-options がリモートの .Tn LPRng スプーラへ渡されます。 .It Fl i Ar numcols 出力が .Pq Ar numcols でインデントされます。 .It Fl w Ar num .Xr pr 1 のページ幅を .Ar num にします。 .El .Sh 環境変数 以下の環境変数が存在すると、 .Nm が使用します: .Bl -tag -width PRINTER .It Ev PRINTER かわりのデフォルトプリンタを指定する .El .Sh 関連ファイル .Bl -tag -width /var/spool/output/*/tf* -compact .It Pa /etc/passwd 個人の識別を行うためのファイル .It Pa /etc/printcap プリンタの特徴を記述したデータベース .It Pa /usr/sbin/lpd ラインプリンタデーモン .It Pa /var/spool/output/* スプーリングのために利用するディレクトリ .It Pa /var/spool/output/*/cf* デーモンの制御のためのファイル .It Pa /var/spool/output/*/df* ``cf'' ファイルが指定するデータファイル .It Pa /var/spool/output/*/tf* ``cf'' ファイルの一時的なコピー .El .Sh 関連項目 .Xr lpq 1 , .Xr lprm 1 , .Xr pr 1 , .Xr symlink 2 , .Xr printcap 5 , .Xr lpc 8 , .Xr lpd 8 .Sh 歴史 .Nm コマンドは .Bx 3 から登場しました。 .Sh 診断 もしとても大きいファイルをスプールしようとするなら、途中で切れてしまう でしょう。 .Nm -はバイナリファイルの印刷を嫌がります。 +ユーティリティはバイナリファイルの印刷を嫌がります。 もし root 以外のあるユーザがファイルを印刷しようとしてスプールに 失敗したら、 .Nm はその旨のメッセージを印刷してそのファイルは印刷されません。 もしローカルマシンの .Xr lpd 8 との接続ができなければ、 .Nm はデーモンを起動できなかったと言うでしょう。その結果は .Xr lpd 8 によってファイルのスプールに失敗したとデーモンのログファイルに 残されるでしょう。 .Sh バグ .Xr troff 1 と .Tn TeX のフォントは,プリンタがつながっているホストにないといけません。 これは,現在はローカルのフォントライブラリを使うことができないことを 意味します。 .Pp .Ql Z 制御ファイル行は 2 種類の異なった目的に使用されます。 標準の .Fx .Xr lpd 8 では、 .Xr pr 1 に渡されるロケールを指定します。 .Tn LPRng .Xr lpd 8 では、スプーラの入出力フィルタが解釈する追加オプションを指定します。 ジョブを .Nm で提出するとき、 .Fl p .Fl L Ar locale は前者の意味で使用され、 .Fl Z Ar daemon-options は後者の意味で使用されます。 diff --git a/ja_JP.eucJP/man/man1/lprm.1 b/ja_JP.eucJP/man/man1/lprm.1 index 725769f25e..4c6787a87c 100644 --- a/ja_JP.eucJP/man/man1/lprm.1 +++ b/ja_JP.eucJP/man/man1/lprm.1 @@ -1,143 +1,144 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lprm.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.sbin/lpr/lprm/lprm.1,v 1.5.2.4 2001/08/16 15:56:05 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lprm.1,v 1.7 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.sbin/lpr/lprm/lprm.1,v 1.5.2.5 2002/06/21 16:40:54 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt LPRM 1 .Os .Sh 名称 .Nm lprm .Nd 印刷ジョブをキューから削除する .Sh 書式 .Nm .Op Fl P Ns Ar printer .Op Fl .Op job # ...\& .Op Ar user ...\& .Sh 解説 .Nm -は 1 つのジョブ、もしくは複数のジョブをプリンタの +ユーティリティは 1 つのジョブ、もしくは複数のジョブをプリンタの スプールキューから削除します。スプールディレクトリはユーザから保護され ているので、ジョブの削除は .Nm を利用するのが唯一の手段です。 ジョブの所有者は、ユーザのログイン名と .Xr lpr 1 を実行した計算機のホスト名で決定されます。 .Pp オプションとしては以下のものがあります: .Bl -tag -width indent .It Fl P Ns Ar printer .Ar printer を扱うキューを指定します (指定しない場合はデフォルトのプリンタを使います)。 .It Fl もし単一の `-' が与えられた場合、 .Nm はユーザのすべてのジョブを削除します。 もしスーパユーザがこのオプションを使った場合、スプール キューは完全に空になります。 .It Ar user .Nm は、 .Ar user の所有するすべてのジョブを削除しようと 試みます。この .Nm の呼び出し方は、スーパユーザだけに有用です。 .It Ar job\ \&# ユーザは、ジョブ番号を指定することで個々のジョブをキューから 削除することができます。この番号は .Xr lpq 1 プログラムから得ることができます。たとえば、以下のようになります。 .Pp .Bd -literal -offset indent \&% lpq \-l 1st:ken [job #013ucbarpa] (standard input) 100 bytes % lprm 13 .Ed .El .Pp もし、どのオプションも与えられなかったときは、 .Nm を実行したユーザが持つアクティブなジョブを削除します。 .Pp .Nm -は削除するファイルの名前をアナウンスしますが、もしキュー内 +ユーティリティは削除するファイルの名前をアナウンスしますが、もしキュー内 に削除するジョブがないときには何もアナウンスしません。 .Pp .Nm -は、スプールのファイルを削除する前に、もし必要であればアクティブな +ユーティリティは、 +スプールのファイルを削除する前に、もし必要であればアクティブな デーモンを殺します。デーモンを殺した場合、ファイルを削除したあとで 新しいデーモンを自動的に再スタートさせます。 .Sh 環境変数 もし、以下の環境変数が存在したならば、 .Nm は利用します。 .Bl -tag -width PRINTER .It Ev PRINTER もし環境変数 .Ev PRINTER が存在し、プリンタを .Fl P オプションで指定しなかった場合、デフォルトプリンタは .Ev PRINTER の値となります。 .El .Sh 関連ファイル .Bl -tag -width /var/spool/*/lock/ -compact .It Pa /etc/printcap プリンタの特徴を記述するファイル .It Pa /var/spool/* スプールディレクトリ .It Pa /var/spool/*/lock 現在のデーモンのプロセス ID と、現在アクティブなジョブのジョブ番号を 得るためのロックファイル .El .Sh 関連項目 .Xr lpq 1 , .Xr lpr 1 , .Xr lpd 8 .Sh 診断 もし、自分が所有者でないファイルを削除しようとした時は、 ``Permission denied'' になります。 .Sh バグ ロックファイルの更新時に、競争になる場合があるので、現在のアクティブ なジョブを正しく認識しないかもしれません。 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/lptest.1 b/ja_JP.eucJP/man/man1/lptest.1 index f0c1c8a726..328c40a24b 100644 --- a/ja_JP.eucJP/man/man1/lptest.1 +++ b/ja_JP.eucJP/man/man1/lptest.1 @@ -1,71 +1,71 @@ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lptest.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.sbin/lpr/lptest/lptest.1,v 1.3.2.2 2001/08/16 15:56:05 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/lptest.1,v 1.5 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.sbin/lpr/lptest/lptest.1,v 1.3.2.3 2002/06/21 16:40:58 charnier Exp % +.\" $FreeBSD$ .\" .Dd December 30, 1993 .Dt LPTEST 1 .Os .Sh 名称 .Nm lptest .Nd ラインプリンタのテスト用のパターンを出力する .Sh 書式 .Nm .Op Ar length .Op Ar count .Sh 解説 .Nm -は、伝統的な ``リプルテスト'' (ripple test) +ユーティリティは、伝統的な ``リプルテスト'' (ripple test) パターンを標準出力に書きます。 このパターンは 96 行におよび、表示可能な .Tn ASCII 96 文字すべてを各位置に出力することになります。 もともとはプリンタのテストのために作られたものですが、 端末や端末ポートのデバッグ、ランダムなデータがすぐに必要な 場合などにも大変有効です。 .Pp .Ar length 引数は、出力の 1 行の長さがデフォルトの 79 ではふさわしくない場合に 指定します。 .Pp .Ar count 引数は、行数がデフォルトの 200 ではふさわしくない場合に指定します。 .Ar count を指定したい場合は .Ar length も指定しなければならない点に注意してください。 .Sh 歴史 .Nm -コマンドは +ユーティリティは .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/m4.1 b/ja_JP.eucJP/man/man1/m4.1 index 9fd01ccf18..d435cec868 100644 --- a/ja_JP.eucJP/man/man1/m4.1 +++ b/ja_JP.eucJP/man/man1/m4.1 @@ -1,227 +1,227 @@ .\" -.\" @(#) %FreeBSD: src/usr.bin/m4/m4.1,v 1.10.2.4 2002/04/26 04:14:55 jmallett Exp % +.\" @(#) %FreeBSD: src/usr.bin/m4/m4.1,v 1.10.2.6 2002/06/21 15:28:03 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd January 26, 1993 .Dt M4 1 .Os .Sh 名称 .Nm m4 .Nd マクロ言語プロセッサ .Sh 書式 .Nm .Op Fl s .Oo .Fl D Ar name Ns Op Ar =value .Oc .Op Fl U Ar name .Op Ar .Sh 解説 .Nm ユーティリティは、さまざまな言語 (たとえば C, ratfor, fortran, lex, yacc など) のフロントエンドとして 利用できるマクロプロセッサです。 引数で指定されたファイルが指定された順に処理されます。 ファイルが指定されていないか、ファイル名が \`-\' なら 標準入力が読まれます。処理されたテキストは標準出力へ送られます。 .Pp マクロの呼出しは name(argument1[, argument2, ...,] argumentN) の 形式を取っています。 .Pp マクロ名とそれに続く開き括弧 `(' との間にはスペースがあってはいけません。 もしマクロ名の直後に開き括弧が続いていなければ引数なしのマクロ呼出しとして 処理されます。 .Pp マクロ名として先頭はアルファベットまたはアンダースコアが、2 文字目以降は 英数字またはアンダースコアが使えます。 よって正しいマクロ名にマッチする正規表現は [a-zA-Z_][a-zA-Z0-9_]* となります。 .Pp マクロの引数のうちで、先頭のクォートされていない空白、タブ、 改行文字は無視されます。 文字列をクォートするためには、左、および右シングルクォートを使用して ください (例: ` this is a string with a leading space')。 組み込みマクロ changequote を使ってクォート文字を変更することができます。 .Pp オプションは以下の通りです: .Bl -tag -width "-Dname[=value]xxx" .It Fl s .Xr cpp 1 用に、 .Em #line ディレクティブを出力します。 .It Fl D Ar name Ns Oo .Ar =value .Oc シンボル .Ar name の値を value (無指定時は NULL) と定義します。 .It Fl "U" Ar "name" シンボル .Ar name を未定義にします。 .El .Sh 文法 .Nm -には以下に示す組み込みマクロが実装されています。 +ユーティリティには以下に示す組み込みマクロが実装されています。 これらのマクロは再定義可能であり、その場合には元の定義は失われます。 特に記述のない限り戻り値は NULL です。 .Bl -tag -width changequotexxx .It changecom コメントの開始文字列と終了文字列を変更します。 デフォルトでは、ポンド記号 `#' と改行文字です。 -引数を指定しなかった場合はコメント機能がオフになります。 +引数を指定しなかった場合はシーケンスがリセットされます。 設定できる文字列の長さは最大で 5 文字です。 .It changequote 第 1、第 2 引数をクォートシンボルとして定義します。 引数の最初の文字のみ使用されることに注意してください。 引数が与えられなかった場合にはデフォルトの左右シングルクォートに 設定されます。 .It decr 引数の値を 1 だけ減少させます。 引数は正しく数値を表現する文字列でなければなりません。 .It define 第 1 引数で指定した名前の新しいマクロを定義します。 定義内容は第 2 引数で与えます。 定義中での $n (n は 0 から 9 まで) は それぞれそのマクロに与えられる 第 n 引数に置換されます。$0 はマクロ名そのものです。 指定されなかった引数は NULL 文字列に置換されます。 また $# は引数の数を表し、$* はコンマで区切られた全引数になります。 $@ は $* と同様ですが、更なる置換が行われないように全部の引数が クォートされます。 .It defn 各引数で指定されたマクロの定義内容をクォートして返します。 これはマクロ定義の名称変更 (組み込みマクロであっても) に利用できます。 .It divert .Nm には 10 本の出力キューが用意されています (0 から 9 までの番号がついています)。 処理の最後に、全てのキューは番号順に連結されて最終的な出力を 生成するようになっています。 初期状態では出力キューは 0 番に設定されています。 divert マクロを使って新しい出力キューを選ぶことが出来ます (divert に不正な引数を与えると出力が破棄されてしまいます)。 .It divnum 現在の出力キューの番号を返します。 .It dnl 改行文字を含めた行末までの入力文字を破棄します。 .It dumpdef 引数で指定した項目に関して、その名前と定義を出力します。 引数が与えられなかった場合は全てのマクロについて出力します。 .It errprint 第 1 引数を標準エラー出力ストリームへ出力します。 .It eval 第 1 引数を計算式とみなして 32-bit 幅の算術演算を用いて計算します。 演算子としては標準の C で用いられるもの、すなわち 3 項、 算術、論理、シフト、関係、ビットの各演算子、および括弧が 利用可能です。 また数値も C と同様に 8 進、10 進、16 進で記述できます。 第 2 引数で (もしあれば) 演算結果の基数を指定でき、 第 3 引数で (もしあれば) 演算結果の最小桁数を指定できます。 .It expr eval の別名です。 .It ifdef 第 1 引数で指定した名前のマクロが定義されていれば第 2 引数を返し、 定義されていなければ第 3 引数を返します。 第 3 引数が省略されていた場合は、その値は NULL になります。 ちなみに `unix' という単語があらかじめ定義されています。 .It ifelse 第 1 引数が第 2 引数とマッチしたら第 3 引数を返します。 マッチしなかった場合、その 3 個の引数は捨てられて次の 3 引数を 用いて同様の検査を繰り返します。 この処理は引数がなくなるか あるいは 1 つだけ残るまで繰り返され、 どれにもマッチしなかった場合には その最後に残った引数または NULL (引数がなくなった場合) が返されます。 .It include 第 1 引数で指定されたファイルの内容を返します。 ファイルが読み込めなかった場合にはエラーメッセージを出力して処理を 中断します。 .It incr 引数を 1 だけ増加させます。 引数は正しく数値を表現する文字列でなければいけません。 .It index 第 2 引数が、第 1 引数の中で、何文字目に出現するかを返します (たとえば index(the quick brown fox jumped, fox) では 16 が返ります)。 第 2 引数が第 1 引数の中に含まれていなかった場合には -1 を返します。 .It len 第 1 引数の文字数を返します。余分な引数は無視されます。 .It m4exit 第 1 引数 (指定されなかった場合は 0) を終了コードとして即座に終了します。 .It m4wrap 入力が最後の EOF に達したときに、どのような動作を行うかを設定します。 一般には種々の後始末を行うマクロを設定します (たとえば、m4wrap("cleanup(tempfile)") とすると他の全ての処理が終了した 後に cleanup マクロが呼び出されます)。 .It maketemp 第 1 引数の中の文字列 XXXXX を現在のプロセス ID に置換します。 その他の部分はそのままです。 これはユニークなテンポラリファイル名の生成に利用できます。 .It paste 第 1 引数で指定されたファイルの内容をマクロ処理を一切行わずに include します。 もしファイルが読み込めない場合にはエラーメッセージを出力して処理を 中断します。 .It popdef 各引数へ pushdef されている定義を戻します。 .It pushdef define と同様の引数をとってマクロを定義しますが元の定義をスタックへ 保存しておきます。 保存された定義は後で popdef で戻すことができます。 .It shift 第 1 引数を除いた全ての引数を返します。 残りの引数はクォートされてコンマで区切られます。 クォートすることによって以降の処理で置換が行われないようにしています。 .It sinclude エラーが起きても無視される点を除いて include と同じです。 .It spaste エラーが起きても無視される点を除いて paste と同じです。 .It substr 第 1 引数の文字列のうちの、第 2 引数で指定されるオフセットから始まり 第 3 引数で指定される文字数の範囲の部分文字列を返します。 第 3 引数が省略された場合は残りの文字列全てを返します。 .It syscmd 第 1 引数をシェルに渡します。戻り値はありません。 .It sysval 最後に実行した syscmd の戻り値を返します。 .It translit 第 1 引数の中の文字を、第 2 引数で指定された文字集合から第 3 引数で 指定された文字集合へ書き直します。ただし .Xr tr 1 式の省略指定を用いることはできません。 .It undefine 第 1 引数で指定されたマクロを未定義にします。 .It undivert 指定された出力キュー (引数がない場合は全てのキュー) の内容を掃き出します。 .It unix OS プラットフォームを調べるために予め定義されているマクロです。 .El .Sh 診断 .Ex -std .Pp 終了ステータスは、入力ファイルの .Em m4exit マクロを使用して指定可能です。 .Sh 関連項目 .Xr cpp 1 .Sh 規格 .Nm ユーティリティは、未実装の .Em traceon および .Em traceoff の組み込みマクロを除き、 .St -p1003.1-2001 仕様互換です .Pp .Em expr , .Em paste , .Em spaste , .Em unix の組み込みマクロは、標準を拡張したものです。 .Sh 作者 .An Ozan Yigit Aq oz@sis.yorku.ca および .An Richard A. O'Keefe Aq ok@goanna.cs.rmit.OZ.AU .Sh バグ トレーシングマクロは実装されていません。 diff --git a/ja_JP.eucJP/man/man1/mail.1 b/ja_JP.eucJP/man/man1/mail.1 index c5ddeb507b..5dd2db0710 100644 --- a/ja_JP.eucJP/man/man1/mail.1 +++ b/ja_JP.eucJP/man/man1/mail.1 @@ -1,1125 +1,1125 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)mail.1 8.8 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.bin/mail/mail.1,v 1.18.2.10 2002/03/15 19:46:32 mikeh Exp % +.\" %FreeBSD: src/usr.bin/mail/mail.1,v 1.18.2.11 2002/06/21 15:28:05 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt MAIL 1 .Os .Sh 名称 .Nm mail , .Nm Mail , .Nm mailx .Nd メールの送信と受信 .Sh 書式 .Nm .Op Fl EiInv .Op Fl s Ar subject .Op Fl c Ar cc-addr .Op Fl b Ar bcc-addr .Ar to-addr ... .Op Fl Ar sendmail-option ... .Nm .Op Fl EiInNv .Fl f .Op Ar name .Nm .Op Fl EiInNv .Op Fl u Ar user .Sh 紹介 .Nm -はインテリジェントなメール処理システムです。 +ユーティリティはインテリジェントなメール処理システムです。 コマンド文法は .Xr ed 1 に似ており、 .Xr ed 1 での行の代わりにメッセージを扱う形になっています。 .Pp 次のオプションが使用可能です。 .Bl -tag -width indent .It Fl v 冗長 (verbose) モードです。 メールの配送の詳細がユーザのターミナルに表示されます。 .It Fl E 本文が空のメッセージを送信しません。 .Xr cron 8 スクリプトのエラーをパイプする場合に有用です。 .It Fl i tty の割り込みシグナルを無視します。 これは特に雑音の多い電話回線を通して .Nm を使う場合に役に立ちます。 .It Fl I 入力がターミナルでない場合にでも強制的に .Nm を対話モードで実行します。 特にメールを送る時の特殊文字 .Ql ~ は対話モードでのみ有効となります。 .It Fl n 起動時にシステム全体の .Pa mail.rc ファイルを読み込みません。 .It Fl N メールを読んだりメールフォルダを編集する時に、最初のメッセージヘッダの 表示を行いません。 .It Fl s Ar subject コマンドラインから .Ar subject を指定します ( .Fl s フラグの後の最初の引数だけがサブジェクトとして使われます。空白を含む サブジェクトは引用符で囲むように注意して下さい。) .It Fl c Ar cc-addr カーボンコピーを .Ar cc-addr でリストされたユーザへ送ります。 .Ar cc-addr 引数は、コンマで区切られた名前のリストとなります。 .It Fl b Ar bcc-addr ブラインドカーボンコピーを .Ar bcc-addr でリストされたユーザへ送ります。 .Ar bcc-addr 引数は、コンマで区切られた名前のリストとなります。 .It Fl f あなたの .Pa mbox (もしくは指定されたファイル) の内容を処理対象として読み込みます。 .Ic quit した時には .Nm は削除されなかったメッセージをこのファイルに書き戻します。 .It Fl u これは以下と等価です。 .Pp .Dl "mail -f /var/mail/user" .El .Ss 起動時の動作 .Nm は、起動時に、システムのコマンドファイル .Pa /usr/share/misc/mail.rc , .Pa /usr/local/etc/mail.rc , .Pa /etc/mail.rc をこの順番に実行します。ただし、 .Fl n オプションを使用して、実行しないよう明示的に指定された場合は例外です。 次に、ユーザの個人的なコマンドファイル .Pa ~/.mailrc を実行します。その後 .Nm -はコマンドラインオプションを検査し、 +ユーティリティはコマンドラインオプションを検査し、 新規メッセージを送るのか既存のメールボックスを読むのかを決定します。 .Ss メールを送る メッセージを 1 人かそれ以上の人に送るために .Nm をメールが送られる相手の名前を引数として起動することができます。 メッセージをタイプした後、行の先頭で .Aq Li control-D を入力します。 下記の .Sx メールにリプライしたり、メールを始める のセクションでは手紙を編集する際に役に立つ .Nm の機能について説明しています。 .Ss メールを読む 通常の使い方では .Nm は引数を指定しないで起動すると、ポストオフィスのメールをチェックし、見 つかった各メッセージにつき 1 行ずつヘッダを表示します。 現在のメッセージは初期状態では最初のメッセージ ( 1 番に番号が振られて います) となっており、 .Ic print コマンド (省略形 .Ic p を使うことができます) によって表示することができます。 メッセージの位置を .Xr ed 1 と同様に .Ic + と .Ic \- のコマンドを使って後や前に移動したり、単に数字を指定して移動したりする ことができます。 .Ss メールを廃棄する メッセージをチェックした後、メッセージを .Ic delete コマンド .Pq Ic d で削除したり、それに .Ic reply コマンド .Pq Ic r でリプライ (返事を出す) したりすることができます。 メッセージを削除すると .Nm プログラムはそのメッセージのことを忘れますが、 この操作は取り消すことができます。 メッセージは .Ic undeleted コマンド .Pq Ic u を使ってメッセージの番号を指定するか、 .Nm のセッションを .Ic exit コマンド .Pq Ic x で中途終了することによって削除をとりやめることができます。 しかし、削除されたメッセージは通常はなくなり二度と見ることはできませ ん。 .Ss メッセージを指定する .Ic print や .Ic delete のようなコマンドは、引数に複数のメッセージの番号を指定することによって 複数のメッセージに対して一度に適用することができます。 たとえば .Dq Li "delete 1 2" はメッセージ 1 と 2 を削除し、 .Dq Li "delete 1\-5" は 1 から 5 のメッセージを削除します。 特別な名前 .Ql * は全てのメッセージを意味し、 .Ql $ は最後のメッセージを意味します。 メッセージの最初の数行を表示するコマンド .Ic top を使って .Dq Li "top *" で全てのメッセージの最初の数行を表示することができます。 .Ss メールにリプライしたり、メールを始める .Ic reply コマンドを使ってメッセージに対する返事を用意して、それをメッセージの差 出人に送り返すことができます。 タイプインしたメッセージは end-of-file までがメッセージの内容として定 義されます。 メッセージを編集している時に .Nm は 文字 .Ql ~ で始まる行を特別に扱います。 例えば、 .Ic ~m とタイプする (行にこれだけタイプします) と現在のメッセージを タブの分 (下記の変数 .Va indentprefix を参照) だけ右にシフトして返事のメッセージにコピーします。 他のエスケープはサブジェクトの設定や、メッセージの受取人の追加や削除を 行なったり、またメッセージを修正するためにエディタを起動したり、コマン ドを実行するためにシェルを起動したりします。 (下にこれらのオプションの要約があります。) .Ss メールの処理セッションを終了する .Nm セッションは .Ic quit コマンド .Pq Ic q で終了することができます。 チェックされたメッセージは削除されていなければ .Pa mbox ファイルにセーブされます。削除されている場合は本当に廃棄されます。 チェックされていないメッセージはポストオフィスに書き戻されます (上記の .Fl f オプション参照)。 .Ss 個人の配布リストとシステム全体の配布リスト たとえば .Dq Li cohorts へメールを送ると複数の人に配布されるように、個人の配布リストを作成する こともできます。 このようなリストは .Pp .Dl "alias cohorts bill ozalp jkf mark kridle@ucbcory" .Pp というような行をホームディレクトリの .Pa .mailrc ファイルに書いておくことによって定義できます。 このようなエイリアス (別名) の現在のリストは .Nm 内で .Ic alias コマンドを使って表示することができます。 システム全体にわたる配布リストは .Pa /etc/mail/aliases を編集することによって作成することができます。 これについては .Xr aliases 5 と .Xr sendmail 8 を参照してください。これらでは違った形式で記述されます。 あなたが送ったメールの中では個人のエイリアスが展開され、そのメールの受取 人が他の受取人に .Ic reply できるようになります。 システム全体の エイリアス はメールが送られた時には展開されませんが、 そのマシンに返信されたメールは .Xr sendmail 8 によって処理される際にシステム全体のエイリアスで展開されます。 .Ss ネットワークメール (ARPA, UUCP, Berknet) ネットワークアドレスの説明については .Xr mailaddr 7 を参照してください。 .Pp .Nm -には +ユーティリティには .Pa .mailrc ファイルの中でセットして動作方法を変更するためのオプションがたくさんあ ります。 たとえば .Dq Li "set askcc" は .Va askcc 機能を有効にします。 (これらのオプションについては下にまとめてあります。) .Sh 要約 ( .%T "Mail Reference Manual" より抜粋) .Pp 各コマンドは行中に単独入力されるか、またコマンドの後に引数をとることも あります。 コマンドは全て入力する必要はありません。途中まで入力されたも のに最初にマッチしたコマンドが使われます。 メッセージリストを引数として取るコマンドについては、メッセージリストが 与えられなければコマンドに要求されるものを満たす次のメッセージが使われ ます。 次のメッセージがない場合にはサーチは逆順に行なわれ、もし適用されるメッ セージが発見できない場合には .Nm は .Dq Li "No applicable messages" と表示しコマンドを中断します。 .Bl -tag -width indent .It Ic \- 前のメッセージを表示します。 数字の引数 .Ar n が指定されると、 .Ar n 個前に移動してメッセージを表示します。 .It Ic # 行中のこれ以降をコメントとして無視します。 .It Ic \&? コマンドの短い要約を表示します。 .It Ic \&! これに引き続くシェルコマンドを実行します ( .Xr sh 1 と .Xr csh 1 を参照)。 .It Ic Print .Pq Ic P .Ic print と同様ですが、無視されるヘッダフィールドも表示されます。 .Ic print , .Ic ignore , .Ic retain を参照してください。 .It Ic Reply .Pq Ic R 発信者に返信します。 元のメッセージの他の受取人には返信されません。 .It Ic Type .Pq Ic T .Ic Print と同じです。 .It Ic alias .Pq Ic a 引数がない場合は、現在定義されている全てのエイリアスを表示します。 引数がひとつ伴うと、そのエイリアスを表示します。 複数の引数が指定されると、新しいエイリアスを作成するか、古いものを変更 します。 .It Ic alternates .Pq Ic alt .Ic alternates コマンドはいくつかのマシンにアカウントがある場合に便利な機能です。 .Nm に対してリストされたアドレスがあなたのアドレスであることを指示するため に使われます。 .Ic reply コマンドによってメッセージに返信するときに .Nm は .Ic alternates リストにリストされているアドレスにはメッセージのコピーを送付しません。 .Ic alternates コマンドが引数なしで指定された場合、現在の alternate の内容が表示され ます。 .It Ic chdir .Pq Ic c ユーザの作業ディレクトリを指定されたものに変更します。 ディレクトリが指定されていなければ、ユーザのログインディレクトリに変更 します。 .It Ic copy .Pq Ic co .Ic copy コマンドは .Ic save と同様のことを行ないますが、 .Ic quit 時に削除を行なうためのマークをメッセージにつけません。 .It Ic delete .Pq Ic d メッセージのリストを引数として取り、 それら全てを削除されたものとしてマークします。 削除されるメッセージは .Pa mbox にはセーブされず、また他のほとんどのコマンドの対象となりません。 .It Ic dp (もしくは .Ic dt ) 現在のメッセージを削除し、次のメッセージを表示します。 次のメッセージがなければ、 .Nm は .Dq Li "at EOF" と表示します。 .It Ic edit .Pq Ic e メッセージのリストを引数として取り、各々を順にテキストエディタで開きま す。 メッセージはテキストエディタから戻ってきた時に再度読み込まれます。 .It Ic exit .Ic ( ex もしくは .Ic x ) ユーザのシステムメールボックス、 .Pa mbox ファイル、 .Fl f での編集ファイルを変更せずにシェルへ直ちに戻ります。 .It Ic file .Pq Ic fi .Ic folder と同様です。 .It Ic folders フォルダディレクトリ内のフォルダ名をリストします。 .It Ic folder .Pq Ic fo .Ic folder コマンドは新しいメールファイルかフォルダに切り替えます。 引数がないと、現在どのファイルを読んでいるかを表示します。 引数を指定すると、現在のファイルに対して行なった変更 (削除など) を書き 出し、新しいファイルを読み込みます。 引数の名前にはいくつかの特別な記法を使うことができます。 .Ql # は前のファイルを意味します。 .Ql % はあなたのシステムメールボックスを意味します。 .Dq Li % Ns Ar user は user のシステムメールボックスを意味します。 .Ql & はあなたの .Pa mbox ファイルを意味します。 .Dq Li + Ns Ar folder はあなたのフォルダディレクトリ中のファイルを意味します。 .It Ic from .Pq Ic f メッセージのリストを引数として取り、それらのメッセージのヘッダを表示し ます。 .It Ic headers .Pq Ic h 現在の範囲のヘッダをリストします。 現在の範囲は 18 個のメッセージのグループです。 引数として .Ql + が指定されると次の 18 個のメッセージのグループが表示され、 .Ql \- が指定されると前の 18 個のメッセージのグループが表示されます。 .It Ic help .Ic \&? と同じです。 .It Ic hold .Ic ( ho もしくは .Ic preserve ) メッセージのリストを引数として取り、各メッセージを .Pa mbox ではなくユーザのシステムメールボックスにセーブするためのマークをつけ ます。 .Ic delete によってマークが付けられているメッセージにはマークはつけません。 .It Ic ignore .Ar ignored list にヘッダフィールドのリストを追加します。 ignore list (無視リスト) に登録されているヘッダフィールドは メッセージを表示する際にターミナルに表示されません。 このコマンドはマシンが生成するヘッダフィールドの表示を省略するのに非常 に便利です。 .Ic Type と .Ic Print コマンドを使うと表示の際に無視するフィールドも含めメッセージの全てを表 示することができます。 .Ic ignore が引数なしで実行されると現在の無視するフィールドのリストが表示されます。 .It Ic inc メールを読んでいる間に届いた新規メッセージを取り込みます。 新規メッセージは、メッセージリストの最後に追加され、 現在のメッセージは最初の新メールメッセージにリセットされます。 既存のメッセージリストを再番号付けしませんし、 将来保存されるいかなる変更も実行しません。 .It Ic mail .Pq Ic m ログイン名と配布グループ名を引数として取り、メールをそれらの人々に送付 します。 .It Ic mbox 終了時にあなたのホームディレクトリの .Pa mbox へ書き込むメッセージのリストを指定します。 .Ic hold オプションをセットして .Em いなければ 、これはメッセージに対するデフォルトの動作となります。 .It Ic more .Pq Ic mo メッセージのリストを引数として取り、そのリストに対してページャを起動し ます。 .It Ic next .Pq Ic n ( .Ic \&+ や .Tn CR と同様) 次のメッセージへ進み、それを表示します。 引数リストを指定すると、次にマッチするメッセージを表示します。 .It Ic preserve .Pq Ic pre .Ic hold と同様です。 .It Ic print .Pq Ic p メッセージリストを引数として取り、各メッセージをユーザのターミナルに表 示します。 .It Ic quit .Pq Ic q セッションを終了し、 全ての未削除のまだセーブしていないメッセージをユーザのホームディレクトリの .Pa mbox ファイルへセーブし、 .Ic hold か .Ic preserve でマークされたメッセージか参照されなかったメッセージはシステムメールボッ クスに残し、その他の全てのメッセージをシステムメールボックスから削除し ます。 もし新しいメールがセッション中に届いていたら、メッセージ .Dq Li "You have new mail" を表示します。 もしメールボックスのファイルを .Fl f フラグ付きで編集している途中であれば、編集中のファイルは再度書き込まれ ます。 編集中のファイルの再書き込みが失敗しなければシェルに戻ります。 編集中のファイルの再書き込みが失敗した場合、ユーザは .Ic exit コマンドによって抜け出すことができます。 .It Ic reply .Pq Ic r メッセージリストを引数として取り、メールを指定されたメッセージの差出人 と全ての受取人に送ります。 デフォルトのメッセージは削除されていてはいけません。 .It Ic respond .Ic reply と同様です。 .It Ic retain .Em retained list (保持リスト) にヘッダフィールドのリストを追加します。 メッセージを表示する時には、retain list に登録されているヘッダ フィールドのみがターミナルに表示されます。 他の全てのフィールドは省略されます。 .Ic type と .Ic print コマンドを使うとメッセージの全てを表示することができます。 .Ic retain が引数を指定されずに実行されると、 現在 retain list に登録されているフィールドのリストを表示します。 .It Ic save .Pq Ic s メッセージのリストとファイル名を引数として取り、各メッセージを順にファ イルの末尾に追加します。 ファイル名が引用符で囲まれて表示され、それに続いて行数と文字数がユーザ のターミナルにエコーされます。 .It Ic set .Pq Ic se 引数がない場合には全ての変数の値を表示します。 引数が指定された場合はオプションをセットします。 引数は .Ar option Ns Li = Ns Ar value ( .Ql = の前後にはスペースは入りません) か .Ar option の形式を取ります。 空白やタブを代入式に含めるために引用符を代入文の どの部分にでも 置いてかまいません。例えば次のようになります。 .Dq Li "set indentprefix=\*q->\*q" .It Ic saveignore .Ic saveignore は .Ic ignore コマンドが .Ic print や .Ic type の際に行なうことを .Ic save の際に行なうものです。 これでマークされたヘッダフィールドは .Ic save コマンドによって保存される時や自動的に .Pa mbox へ保存される時にフィルタリングされて取り除かれます。 .It Ic saveretain .Ic saveretain は .Ic retain が .Ic print や .Ic type の際に行なうことを .Ic save の際におこなうものです。 .Ic save コマンドによって保存される時や自動的に .Pa mbox へ保存される時には、これでマークされたヘッダフィールドのみが保存されます。 .Ic saveretain は .Ic saveignore に優先します。 .It Ic shell .Pq Ic sh シェルを対話モード起動します。 .It Ic size メッセージのリストを引数として取り、各メッセージのサイズを文字数で表示 します。 .It Ic source .Ic source コマンドはファイルからコマンドを読み込みます。 .It Ic top メッセージのリストを引数として取り、各メッセージの先頭の数行を表示しま す。 表示する行数は変数 .Va toplines によって制御でき、デフォルトでは 5 行となっています。 .It Ic type .Pq Ic t .Ic print と同様です。 .It Ic unalias .Ic alias コマンドによって定義された名前のリストを引数として取り、記憶されている ユーザのグループを無効にします。 グループの名前は以後意味を持たなくなります。 .It Ic undelete .Pq Ic u メッセージのリストを引数として取り、各メッセージを削除されて .Em いない ものとしてマークします。 .It Ic unread .Pq Ic U メッセージのリストを引数として取り、各メッセージを .Em 未読 としてマークします。 .It Ic unset オプションの名前のリストを引数として取り、それらの記憶されている値を無 効とします。 .Ic set の逆です。 .It Ic visual .Pq Ic v メッセージのリストを引数として取り、各メッセージについてスクリーンエディ タを起動します。 .It Ic write .Pq Ic w .Ic save と同様ですが、 .Em (ヘッダを除いて) メッセージの本文 .Em のみ が保存されます。 メッセージシステムを使ってソースプログラムテキストを送受信するような作 業で非常に便利です。 .It Ic xit .Pq Ic x .Ic exit と同様です。 .It Ic z .Nm -は +ユーティリティは .Ic headers コマンドにて説明されているようにウィンドウいっぱいにメッセージヘッダを 表示します。 .Nm が指し示しているメッセージの位置は .Ic z コマンドによって次のウィンドウに進めることができます。 また、 .Ic z- コマンドを使って前のウィンドウに戻ることもできます。 .El .Ss チルダ/エスケープ ここではチルダエスケープを要約します。 チルダエスケープはメッセージを編集している時に特別の機能を実行するため に使われます。 チルダエスケープは行の先頭でのみ認識されます。 実際のエスケープ文字は .Va escape オプションによってセットできるので、 .Dq チルダエスケープ という呼び方は多少間違ったものです。 .Bl -tag -width indent .It Ic ~a sign= オプションから、署名の文字列を、メッセージに挿入します。 .It Ic ~A Sign= オプションから、署名の文字列を、メッセージに挿入します。 .It Ic ~b Ar name ... カーボンコピーの受取人のリストへ指定された name を追加します。 ただし name は Cc: 行へは表示されません ( .Dq ブラインド カーボンコピー)。 .It Ic ~c Ar name ... 指定された name をカーボンコピーの受取人のリストに追加します。 .It Ic ~d ホームディレクトリの .Pa dead.letter ファイルをメッセージ中に読み込みます。 .It Ic ~e 今までに編集したメッセージをテキストエディタで開きます。 編集セッションの終了後、メッセージに続けてテキストを追加することができ ます。 .It Ic ~f Ar messages 指定されたメッセージを送ろうとしているメッセージ中に読み込みます。 メッセージが指定されない場合は、現在のメッセージを読み込みます。 現在無視されているメッセージヘッダ ( .Ic ignore か .Ic retain コマンドによる) は読み込まれません。 .It Ic ~F Ar messages .Ic ~f と同様ですが、全てのメッセージヘッダが含まれます。 .It Ic ~h メッセージヘッダを順に各々を入力して編集し、テキストを末尾に追加したり、 現在のターミナルの erase 文字や kill 文字を使ってフィールドを変更した りします。 .It Ic ~i Ar string 指定したオプションの値を、メッセージのテキストに挿入します。 .It Ic ~m Ar messages 指定されたメッセージを現在送ろうとしているメッセージの中に読み込み、タブか .Ar indentprefix に設定されている値でインデントします。 メッセージが指定されていない場合は現在のメッセージが読み込まれます。 現在無視されているメッセージヘッダ ( .Ic ignore か .Ic retain コマンドによる) は読み込まれません。 .It Ic ~M Ar messages .Ic ~m と同様ですが、全てのメッセージヘッダが読み込まれます。 .It Ic ~p 今までに修正したメッセージをメッセージヘッダフィールドと共に表示します。 .It Ic ~q 送ろうとしているメッセージを中断し、 .Ic save がセットされている場合はホームディレクトリの .Pa dead.letter にメッセージをセーブします。 .It Ic ~r Ar filename , Ic ~r Li \&! Ns Ar command .It Ic ~< Ar filename , Ic ~< Li \&! Ns Ar command 指定されたファイルをメッセージに読み込みます。 引数が .Ql \&! で開始する場合、残りの文字列は任意のシステムコマンドとして実行され、 標準出力がメッセージに挿入されます。 .It Ic ~R Ar string .Ar string を Reply-To: フィールドとして使用します。 .It Ic ~s Ar string 指定された文字列を現在のサブジェクトフィールドに設定します。 .It Ic ~t Ar name ... 指定された名前を受取人のリストに追加します。 .It Ic ~v 別のエディタ ( .Ev VISUAL 環境変数によって定義されているもの) で現在までに修正したメッセージを 開きます。 通常は別のエディタはスクリーンエディタとなります。 エディタを終了した後、メッセージの末尾にテキストを追加できるようになり ます。 .It Ic ~w Ar filename 指定されたファイルにメッセージを書き込みます。 .It Ic ~x .Ic ~q と同様に終了しますが、メッセージは .Pa dead.letter に保存されません。 .It Ic ~! Ar command 指定されたシェルコマンドを実行し、メッセージに戻ります。 .It Ic ~| Ar command , Ic ~^ Ar command 指定されたコマンドをフィルタとし、パイプを通してメッセージに適用します。 コマンドから何の出力もないか、コマンドが異常終了した場合は、メッセージ のテキストは元のままとなります。 メッセージを整形するためによく .Xr fmt 1 コマンドが .Ar command として使われます。 .It Ic ~: Ar mail-command , Ic ~_ Ar mail-command 指定された .Nm コマンドを実行します。 しかし全てのコマンドが使えるわけではありません。 .It Ic ~~ Ar string メッセージに単独の .Ql ~ で始まるテキスト文字列を挿入します。 エスケープ文字が変更されている場合は、それを送るためにはエスケープ文字 を 2 つ指定しなければなりません。 .El .Ss メールオプション オプションは .Ic set と .Ic unset コマンドで制御します。 オプションは 2 値か文字列となります。 2 値の場合はセットされているか、されていないかだけが意味を持ちます。 文字列の場合は実際にセットしている値が意味を持ちます。 2 値のオプションには次のものがあります。 オプションが設定されていない場合、 .Nm は、同名の環境変数を探します。 .Bl -tag -width indent .It Va append メッセージを .Pa mbox にセーブする場合、先頭に書くのではなく、末尾に追加します。 これは常にセットされていなければなりません (システムの .Pa mail.rc ファイルにおいて設定することが望ましいです)。 .It Va ask , asksub .Nm は送ろうとしている各メッセージのサブジェクトの入力を促します。 改行のみを入力するとサブジェクトフィールドは送られません。 .It Va askbcc 各メッセージの編集後に追加のブラインドカーボンコピーの受取人の入力を促します。 現在のリストで十分な場合は改行のみを入力してください。 .It Va askcc 各メッセージの編集後に追加のカーボンコピーの受取人の入力を促します。 現在のリストで十分な場合は改行のみを入力してください。 .It Va autoinc 新規メッセージが届くと自動的に取り込まれるようにします。 これを設定することは、各プロンプトで .Ic inc を実行することと同様ですが、 新規メッセージが到着しても現在のメッセージがリセットされないことが違います。 .It Va autoprint .Ic delete コマンドを .Ic dp のように動作させます。 すなわちメッセージの削除後、次のものが自動的に表示されます。 .It Ar debug 2 値のオプション .Va debug をセットするとコマンド行で .Fl d を指定した時と同じ動作になり、 .Nm はデバッグに有用な全ての種類の情報を出力します。 .It Va dot 2 値のオプション .Va dot をセットすることによって、 .Nm は行中にピリオドが単独で入力されると、送ろうとしているメッセージが終了した ものとみなします。 .It Va hold このオプションはデフォルトでメッセージをシステムメールボックス中に保持 するために使われます。 .It Va ignore ターミナルからの割り込み信号を無視し、 .Li @ としてエコーします。 .It Va ignoreeof .Ar ignoreeof は .Va dot に関連するオプションであり、 .Nm にメッセージの最後での .Aq Li control-D を無視させます。 .Va ignoreeof は .Nm のコマンドモード中でも有効となります。 .It Va metoo 通常、差出人を含むグループの展開時には差出人は取り除かれます。 このオプションをセットすることによって差出人も展開されたグループに含ま れるようになります。 .It Va noheader .Va noheader オプションをセットすると、コマンド行で .Fl N フラグを指定するのと同様の動作となります。 .It Va nosave 普通は .Tn RUBOUT (erase もしくは delete) を 2 回入力してメッセージの編集を中断する時、 .Nm はホームディレクトリのファイル .Pa dead.letter に中断した手紙をコピーします。 この 2 値のオプション .Va nosave をセットすると、ファイルへのコピーは行なわれません。 .It Va Replyall .Ic reply コマンドと .Ic Reply コマンドの意味を逆転させます。 .It Va quiet 最初に起動された時にバージョンの表示を省略します。 .It Va searchheaders このオプションがセットされていると、 .Dq Li / Ns Ar x Ns Li : Ns Ar y の形式でのメッセージリストの指定はヘッダフィールド .Ar x 中にサブストリング .Ar y を含む全てのメッセージに展開されます。 ストリングのサーチは大文字と小文字を区別しません。 .Ar x を省略すると、デフォルトの .Dq Li Subject ヘッダフィールドになります。 書式 .Dq Li /to: Ns Ar y は特殊ケースであり、サブストリング .Ar y を .Dq Li To , .Dq Li Cc , .Dq Li Bcc のいずれかのヘッダフィールドに含む全メッセージに展開されます。 .Qq Li "to" のチェックは大文字小文字を区別しますので、 .Dq Li /to: Ns Ar y を使用すると、 .Ar y を .Dq Li To: フィールドでのみ探すように制限できます。 .It Va verbose .Va verbose オプションをセットするとコマンド行で .Fl v フラグをセットした時と同様の動作となります。 .Nm が verbose (饒舌) モードで実行されている時、 実際のメッセージの配送の様子がターミナルに表示されます。 .El .Ss オプションストリング値 .Bl -tag -width indent .It Ev EDITOR .Ic edit コマンドと .Ic ~e エスケープで使われるテキストエディタのパス名です。 定義されていない場合はデフォルトのエディタが使われます。 .It Ev LISTER .Ic folders コマンドで使われるディレクトリをリストするコマンドのパス名です。 デフォルトは .Pa /bin/ls です。 .It Ev PAGER .Ic more コマンドや変数 .Va crt がセットされている時に使われるプログラムのパス名です。 このオプションが定義されていないとデフォルトのページャ .Xr more 1 が使われます。 .It Ev REPLYTO 設定されている場合、送信メッセージの Reply-To フィールドの初期化に使用 されます。 .It Ev SHELL .Ic \&! コマンドや .Ic ~! エスケープで使われるシェルのパス名です。 このオプションが定義されていないとデフォルトのシェルが使われます。 .It Ev VISUAL .Ic visual コマンドや .Ic ~v エスケープで使われるテキストエディタのパス名です。 .It Va crt 値をとるオプション .Va crt は、メッセージを読むために .Ev PAGER が使われるメッセージの長さの閾値として使われます。 .Va crt が値なしでセットされていると、システムに保存されているターミナルの画面 の高さが閾値の計算に使われます ( .Xr stty 1 を参照して下さい)。 .It Va escape これが定義されていると、このオプションの最初のキャラクタがエスケープを 示すための .Ql ~ の代わりに使われます。 .It Va folder メッセージのフォルダを置くためのディレクトリ名です。 これが .Ql / で始まっていると .Nm は絶対パスとして解釈します。 それ以外の場合はフォルダのディレクトリはホームディレクトリからの 相対パスとして扱われます。 .It Ev MBOX メールボックスファイル の名前です。 これはフォルダの名前とすることもできます。 デフォルトはホームディレクトリの .Pa mbox となります。 .It Va record これが定義されていると、全ての発信されるメールを記録するために使われる ファイルのパス名となります。 定義されていない場合は、発信メールはセーブされません。 .It Va indentprefix チルダエスケープ .Ic ~m で、通常のタブ文字 .Pq Li ^I の代わりにメッセージを インデントするために使われる文字列となります。 これにスペースやタブが含まれている場合は引用符で囲んで下さい。 .It Va toplines これが定義されていると、 .Ic top コマンドで表示するメッセージの行数となります。通常は先頭の 5 行が表示 されます。 .El .Sh 環境変数 .Nm -は環境変数 +ユーティリティは環境変数 .Ev HOME と .Ev USER を使用します。また、環境変数 .Ev MAIL がセットされていると、デフォルトの .Pa /var/mail の代わりにユーザのメール ボックスの位置として使われます。 .Sh 関連ファイル .Bl -tag -width ".Pa /usr/share/misc/mail.*help" -compact .It Pa /var/mail/* ポストオフィスです。 .It Pa ~/mbox ユーザの古いメールです。 .It Pa ~/.mailrc 起動時に実行される .Nm コマンドを指定するファイルです。 .Ev MAILRC 環境変数を設定すると、こちらが優先します。 .It Pa /tmp/R* 一時ファイルです。 .It Pa /usr/share/misc/mail.*help ヘルプファイルです。 .Pp .It Pa /usr/share/misc/mail.rc .It Pa /usr/local/etc/mail.rc .It Pa /etc/mail.rc システムの初期化ファイルです。 各ファイルが存在すればこの順に読み込まれます。 .El .Sh 関連項目 .Xr fmt 1 , .Xr newaliases 1 , .Xr vacation 1 , .Xr aliases 5 , .Xr mailaddr 7 , .Xr sendmail 8 , .Rs .%T "The Mail Reference Manual" .Re .Sh 歴史 .Nm コマンドは .At v1 で登場しました。 本マニュアルページは 元々 .An Kurt Shoens によって書かれた .%T "The Mail Reference Manual" をベースにしています。 .Sh バグ ここに文書化されていないフラグがいくつか存在します。 ほとんどは一般のユーザには役に立たないものです。 .Pp 混乱しやすいのですが、通常 .Nm は .Nm Mail と .Nm mailx への単なるリンクとなっています。 .Pp .Ic alternates リストの名前は正しくない英語ですが ( .Dq alternatives であるべきです)、互換性のためのそのままとなっています。 diff --git a/ja_JP.eucJP/man/man1/mailq.1 b/ja_JP.eucJP/man/man1/mailq.1 index c1046e2405..7b7e728a38 100644 --- a/ja_JP.eucJP/man/man1/mailq.1 +++ b/ja_JP.eucJP/man/man1/mailq.1 @@ -1,73 +1,73 @@ -.\" Copyright (c) 1998-2000 Sendmail, Inc. and its suppliers. +.\" Copyright (c) 1998-2000, 2002 Sendmail, Inc. and its suppliers. .\" All rights reserved. .\" Copyright (c) 1983, 1997 Eric P. Allman. All rights reserved. .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" By using this file, you agree to the terms and conditions set .\" forth in the LICENSE file which can be found at the top level of .\" the sendmail distribution. .\" -.\" $Id: mailq.1,v 1.13 2002-05-04 01:52:38 horikawa Exp $ +.\" $Id: mailq.1,v 8.19 2002/04/12 05:07:58 gshapiro Exp % .\" -.\" %FreeBSD: src/contrib/sendmail/src/mailq.1,v 1.3.6.6 2002/04/28 19:56:31 gshapiro Exp % +.\" %FreeBSD: src/contrib/sendmail/src/mailq.1,v 1.3.6.7 2002/06/21 02:25:34 gshapiro Exp % .\" $FreeBSD$ .\" -.TH MAILQ 1 "$Date: 2002-05-04 01:52:38 $" +.TH MAILQ 1 "$Date: 2002-07-21 05:44:23 $" .SH 名称 mailq \- メールのキューを表示する .SH 書式 .B mailq .RB [ \-Ac ] .RB [ \-v ] .SH 解説 .B mailq は、後で配送するためにキューに蓄えたメールを一覧表示します。 .PP 各メッセージの 1 行目は、 ステータス文字が付くことがある、ホストがメッセージにつける内部の識別子と、 メッセージのバイト数、キューに入れられた日付と時間、 メッセージの送り手を表示します。 2 行目は、このメールがキューに入れられる原因となったエラーを表示します。 このメッセージは、 キューのなかでメールが最初に処理されているときには表示されません。 ステータス文字は次のいずれかです: .B * は、ジョブが処理中であることを示し、 .B X は、ジョブを処理するには負荷が高すぎることを示し、 .B - は、ジョブが処理するには若すぎることを示します。 そのあとの行には、メールの受け手が 1 行に 1 人ずつ表示されます。 .B mailq は ``sendmail -bp'' と等価です。 .PP 次のオプションを使用可能です: .TP .B \-Ac .I /etc/mail/submit.cf で指定されるメール提出キューを、 .IR /etc/mail/sendmail.cf で指定される MTA キューの代りに表示します。 .TP .B \-v 詳細な情報を表示します。 通常の表示に加え、メッセージの優先度と、 警告メッセージを送ったか否かを示す 1 文字の記号 (``+'' か空白) を最初の行に追加します。 さらに、メールの受け手の ``制御ユーザ (controlling user)'' 情報を表示します; これは、このメールによって実行されるプログラムの所有者および、 存在するのであれば、このコマンドが展開される元のエイリアス名です。 さらに、取得可能であれば、各受信者に関する状態メッセージを表示します。 .PP .B mailq は成功した場合は 0 を、エラーが起きた場合は 0 より大きな 値を返します。 .SH 関連項目 sendmail(8) .SH 歴史 .B mailq は 4.0BSD から登場しました。 diff --git a/ja_JP.eucJP/man/man1/make.1 b/ja_JP.eucJP/man/man1/make.1 index 8d8a9085e5..fbbb1e0344 100644 --- a/ja_JP.eucJP/man/man1/make.1 +++ b/ja_JP.eucJP/man/man1/make.1 @@ -1,1209 +1,1209 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" from: @(#)make.1 8.4 (Berkeley) 3/19/94 -.\" %FreeBSD: src/usr.bin/make/make.1,v 1.29.2.12 2001/08/16 13:16:57 ru Exp % +.\" %FreeBSD: src/usr.bin/make/make.1,v 1.29.2.13 2002/06/21 15:28:08 charnier Exp % .\" .\" this file based on that translated to japanese on NetBSD Japanese Reference .\" Manual Project, and modefied to fit FreeBSD Reference Manual .\" by Mochida Shuji 1996/04/26 .\" $FreeBSD$ .\" .Dd March 19, 1994 .Dt MAKE 1 .Os .Sh 名称 .Nm make .Nd プログラムの依存関係をメンテナンスする .Sh 書式 .Nm .Op Fl BPSXeiknqrstv .Op Fl D Ar variable .Op Fl d Ar flags .Op Fl E Ar variable .Op Fl f Ar makefile .Op Fl I Ar directory .Bk -words .Op Fl j Ar max_jobs .Op Fl m Ar directory .Ek .Op Fl V Ar variable .Op Ar variable Ns No = Ns Ar value .Op Ar target ... .Sh 解説 .Nm -は、プログラムのメンテナンスを単純化するためのツールです。 +ユーティリティは、プログラムのメンテナンスを単純化するためのツールです。 その入力はファイルの生成とプログラムとの間の依存関係を指定する リストが記述されています。 カレントディレクトリまたは特別なオブジェクトディレクトリ .Ql Va (.OBJDIR 参照) のどちらか一方において .Ql Pa makefile と .Ql Pa Makefile の最初に見つかった方から、この指定のリストが読み込まれます。 .Ql Pa .depend というファイルが見つかれば、それも読み込みます .Pq Xr mkdep 1 を参照 。 .Pp 本マニュアルはリファレンスのためのみのドキュメントです。 .Nm と makefile に関する詳しい紹介は .%T "Make \- A Tutorial" を参照してください。 .Pp オプションは以下のとおりです。 .Bl -tag -width Ds .It Fl B シーケンス中の依存行のソースを作成するために、各コマンドに対して 1 つのシェルを実行する、バックワード互換モードで実行しようとします。 このオプションは .Fl j が使用されない限り、デフォルトで有効になります。 .It Fl D Ar variable 大域変数 .Ar variable を 1 と定義します。 .It Fl d Ar flags デバッグモードを有効にし、 .Nm が表示するデバッグ情報の種類を指定します。 引数 .Ar flags には、以下のうち 1 つ以上を指定できます。 .Bl -tag -width Ds .It Ar A すべてのデバッグ情報を出力します。他のフラグをすべて指定したことと 等価です。 .It Ar a アーカイブ検索とキャッシュに関する情報を表示します。 .It Ar c 条件評価に関する情報を表示します。 .It Ar d ディレクトリ検索とキャッシュに関する情報を表示します。 .It Ar f for ループの実行に関するデバッグ情報を表示します。 今のところは何もしていません。 .It Ar "g1" 処理を行う前に、入力のグラフを表示します。 .It Ar "g2" すべての処理を行ったあと、あるいはエラーにより終了する前に入力のグラフを 表示します。 .It Ar j 複数のシェルを起動する場合の情報を表示します。 .It Ar l @ がコマンドに前置されていようといまいと、 また他の「静寂」フラグの有無に関わらず、Makefile のコマンドを表示します。 これは「やかましい」動作としても知られています。 .It Ar m ターゲットの作成と変更日付に関する情報を表示します。 .It Ar s 拡張子解釈に関する情報を表示します。 .It Ar t ターゲットリストのメンテナンスに関する情報を表示します。 .It Ar v 変数の値に関する情報を表示します。 .El .It Fl E Ar variable (存在すれば) 環境の値で上書きする、makefile の中の変数を指定します。 .It Fl e 環境の値で makefile 中のすべての変数の値を上書きするように指示します。 .It Fl f Ar makefile デフォルトの .Ql Pa makefile と .Ql Pa Makefile のかわりに、読み込むファイルを指定します。もし .Ar makefile が .Ql \- なら標準入力から読み込みます。複数のファイルが指定可能で、 指定した順に読み込まれます。 .It Fl I Ar directory makefile と、インクルードされる makefile を検索するためのディレクトリを 指定します。システムで定義してある makefile のあるディレクトリ (または、 複数のディレクトリ; .Fl m オプションを参照) は自動的にリストに含まれ、検索されます。 .It Fl i makefile から実行されたシェルコマンドが 0 でない終了ステータスを返し ても無視します。makefile 中でコマンドの先頭に .Ql \- を指定するのと同じです。 .It Fl j Ar max_jobs .Nm が同時に起動できるジョブの数を指定します。 .Ar B フラグを指定しなければ、互換性モードはオフになります。 .It Fl k エラーが発生しても処理を続行します。ただし、発生したエラーによって作成 が不能になったターゲットに依存したターゲットに関しては処理が中断されます。 .It Fl m Ar directory <...> 形式で読み込まれる sys.mk や makefile を検索するための ディレクトリを指定します。複数のディレクトリを検索パスに加えることが できます。このパスは、デフォルトのシステムインクルードパス .Pa /usr/share/mk を上書きします。 さらに、システムインクルードパスを "..." 形式のインクルードによって 追加することができます( .Fl I オプションを参照)。 .It Fl n make が実行するであろうコマンド内容の表示のみを行い、実行はしません。 .It Fl P 並行して動作するジョブを一緒に混ぜて出力するのでなく、 与えられたジョブの順番をそろえて、ジョブが終了するまで表示しません。 このオプションは .Fl j が使われた時のみ効果を持ちます。 .It Fl q いっさいのコマンドを実行せず、指定されたターゲットが最新のものであれば 0 を、そうでなければ 1 を終了ステータスとして返します。 .It Fl r システムの makefile で定義された組み込みのルールを使用しません。 .It Fl S エラーが起きた時に処理を中止します。 デフォルトの動作です。このオプションは 再帰的な構築の際に .Fl k オプションを打ち消すのに必要となります。 .It Fl s 実行するコマンドを表示しません。makefile のなかで、コマンドの先頭に .Ql Ic @ を指定するのと同じです。 .It Fl t makefile で指定されたターゲットを作り直すのではなく、ターゲットを作成 するか、あるいは最終更新日付を現在の時刻に設定することにより、 ターゲットが最新であるかのようにします。 .It Fl V Ar variable グローバルな文脈での .Nm の .Ar variable の値を表示します。如何なるターゲットも生成しません。 このオプションで複数のインスタンスを指定することができます。 変数は、各行毎に表示されます。未定義もしくは空の変数は、空行で 表現されます。 .It Fl v 特に冗長表示させます。 複数ジョブの make においては、ファイルバナーを生成させます。 .It Fl X .Fl V オプションを使用して変数の値を表示するときに、再帰的な値の展開をしません。 .It Ar variable Ns No = Ns Ar value 変数 .Ar variable の値を .Ar value に設定します。 .El .Pp makefile には 7 種類の行があります: 依存関係記述、シェルコマンド、変数 代入、インクルード文、条件命令、for ループ、コメントです。 .Pp 一般に、行は行末にバックスラッシュ .Pq Ql \e を置くことにより次行へ継続させることがで きます。この場合、バックスラッシュ直後の改行と、次の行の先頭の 空白部分は 1 つの空白に置き換えられます。 .Sh ファイル依存関係記述 入力ファイルにおける依存関係記述行は、1 つ以上のターゲット、オペレータ、 0 個 以上のソースからなります。 これは、ターゲットがソースに .Dq 依存 しているという関係を 定義しており、通常は、ソースからターゲットが作成されます。ターゲットと ソースとの厳密な関係はオペレータによって、両者間に指定します。 オペレータには以下の種類があります。 .Bl -tag -width flag .It Ic \&: ターゲットの最終更新日付が、いずれかのソースの最終更新日付よりも 古いものであれば、ターゲットは古いものであり、作り直されるべきものと 判断されます。 別の行でこのオペレータによる同じターゲットに関するソースの記述があれば、 それらはすべて 1 つにまとめられます。ターゲットの作成中に .Nm が中断されると、ターゲットは削除されます。 .It Ic \&! ターゲットはつねに作り直されます。ただし、作り直されるのは、 すべてのソースが検査され、必要と判断されたソースが作り直されたあとです。 このオペレータによる同じターゲットに関するソースの記述が別の行にもあれば、 それらはすべて 1 つにまとめられます。ターゲットの作成中に .Nm が中断されると、ターゲットは削除されます。 .It Ic \&:: ソースが指定されていなかった場合、つねにターゲットは作り直されます。 指定されていた場合にはソースのいずれかがターゲットよりも新しい時だけ ターゲットは作り直されます。本オペレータでは、別の行において同じ ターゲットに関するソースの記述があっても 1 つにまとめません。 ターゲットの作成中に .Nm が中断されても、ターゲットは削除されません。 .El .Pp ターゲットとソースは、シェルのワイルドカード表記として .Ql \&? , .Ql * , .Ql [] , .Ql {} を含むことができます。 .Ql \&? , .Ql * , .Ql [] の表記は、ターゲットまたはソースの最後の要素として記述でき、 存在するファイルを指定するものでなければなりません。 表記 .Ql {} はファイルが存在しなくてもかまいません。シェルのように辞書順に並べられて 展開されることはなく、ファイルシステム上に並んでいる順番のまま行われます。 .Sh シェルコマンド ターゲットは、シェルコマンドの列と関連付けることができ、通常はそれによって ターゲットを作成します。 これに含まれる各コマンドは、 .Em 必ず 行頭のタブに続けて記述します。同一のターゲットに 対して複数の依存記述行がある場合、 .Ql Ic :: オペレータを使用したのでなければ、それらのうちの 1 つにのみコマンド行を 続けることができます。 .Pp コマンドラインの先頭もしくは先頭 2 文字が .Ql Ic @ や .Ql Ic \- ならば、コマンドは特別な扱いを受けます。 .Ql Ic @ は、コマンドが実行前に、コマンド内容の表示を抑制します。 .Ql Ic \- は、コマンドの 0 ではない終了ステータスを無視するように指示します。 .Sh 変数代入 .Nm で使われる変数はシェルでの変数に類似しています。そして、歴史的な経緯から、 すべて大文字からなる名前が用いられます。変数代入には以下の 5 通りの オペレータを使用できます。 .Bl -tag -width Ds .It Ic \&= 変数に値を代入します。その時点までの値は失われます。 .It Ic \&+= 現在の変数の値に、右辺の値を追加します。 .It Ic \&?= 変数が未定義の場合のみ、値を代入します .It Ic \&:= 右辺を展開した値を代入します。つまり、変数に代入する前に値の展開を行います。 通常、値の展開は代入時には行われず、変数が参照されるときに行われます。 .It Ic \&!= 右辺を展開した値をシェルに実行させ、実行結果を左辺の変数に代入します。 結果のなかに含まれる改行は空白に置き換えられます。 .El .Pp いずれの場合も、値の前にある空白は無視されます。値が追加される場合、 変数の直前の値と追加する値との間に空白が挿入されます。 .Pp 変数は、ドル記号 .Pq Ql $ に続いて中括弧 .Pq Ql {} または小括弧 .Pq Ql () で囲まれた変数名を置くことにより展開されます。もし変数名が 1 文字な ら、変数名を囲む括弧は省略できますが、このような省略形は推奨できません。 .Pp 変数置換は、変数が用いられている場所により、 2 つの別々のタイミングで 行われます。依存関係記述行で用いられた変数は、その行が読み込まれたときに 展開されます。シェルコマンド内で用いられた変数は、シェルコマンド実行時に 展開されます。 .Pp 変数には、優先度に従って、4 つの異なるクラスがあります: .Bl -tag -width Ds .It 環境変数 .Nm の環境中で有効な変数 .It グローバル変数 makefile とインクルードされた makefile 内で有効な変数。 .It コマンドライン変数 コマンドラインで指定された変数。 .It ローカル変数 あるターゲットのみに対して定義される変数。ローカル変数には、 以下の 7 種類があります: .Bl -tag -width ".ARCHIVE" .It Va .ALLSRC このターゲットに対するすべてのソースのリスト。 .Ql Va \&> も同じです。 .It Va .ARCHIVE アーカイブファイル名。 .Ql Va \&! も同じです。 .It Va .IMPSRC ターゲット名に変換するのに使用するソースのファイル名またはパス名 ( .Dq 暗黙の ソース)。 .Ql Va \&< も同じです。 .It Va .MEMBER アーカイブのメンバ。 .Ql Va \&% も同じです。 .It Va .OODATE ターゲットよりも新しいソースのリスト。 .Ql Va \&? も同じです。 .It Va .PREFIX ターゲットのディレクトリ名と拡張子を取り除いた名前。 .Ql Va * も同じです。 .It Va .TARGET ターゲットの名前。 .Ql Va @ も同じです。 .El .Pp 短い形式 .Ql Va @ , .Ql Va \&! , .Ql Va \&< , .Ql Va \&% , .Ql Va ? , .Ql Va \&> , .Ql Va * は互換性のためのものですが、利用することは推奨できません。 また、 .Ql Va "@F" , .Ql Va "@D" , .Ql Va " .It Ic \&.include Ar \*qfile\*q 指定した makefile をインクルードします。 アングルブラケットが使用された場合は、 makefile はシステムの makefile ディレクトリにあるものを用います。 ダブルクォートが使用された場合は、 makefile が存在するディレクトリ、 .Fl I オプションで指定されたディレクトリ、システムの makefile ディレクトリの 順に検索します。 .It Ic \&.undef Ar variable 指定したグローバル変数を未定義とします。 グローバル変数のみ、未定義とすることができます。 .It Ic \&.error Ar message makefile の処理を即座に終了します。 makefile のファイル名と、どの行でエラーとなったかと、 指定したエラーメッセージとを、標準出力に表示し、 .Nm は終了コード 1 で終了します。 .El .Pp 条件文は Makefile のどの部分を処理するのかを判定するために使用します。 C プリプロセッサがサポートする条件文と同様に使用されます。 以下の条件文がサポートされています: .Bl -tag -width Ds .It Xo .Ic \&.if .Oo \&! Oc Ns Ar expression .Op Ar operator expression ... .Xc 式の値をテストします。 .It Xo .Ic .ifdef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc 変数の値をテストします。 .It Xo .Ic .ifndef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc 変数の値をテストします。 .It Xo .Ic .ifmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc ターゲット .Ar target が作成中かどうかをテストします。 .It Xo .Ic .ifnmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc ターゲット .Ar target が作成中かどうかをテストします。 .It Ic .else 最後に行った条件文の意味を逆にします。 .It Xo .Ic .elif .Oo \&! Oc Ns Ar expression .Op Ar operator expression ... .Xc .Ql Ic .else と直後の .Ql Ic .if を対にしたものです。 .It Xo .Ic .elifdef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc .Ql Ic .else と直後の .Ql Ic .ifdef を対にしたものです。 .It Xo .Ic .elifndef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc .Ql Ic .else と直後の .Ql Ic .ifndef を対にしたものです。 .It Xo .Ic .elifmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc .Ql Ic .else と直後の .Ql Ic .ifmake を対にしたものです。 .It Xo .Ic .elifnmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc .Ql Ic .else と直後の .Ql Ic .ifnmake を対にしたものです。 .It Ic .endif 条件文の本体を終了させます。 .El .Pp オペレータ .Ar operator は、以下のうちのいずれかです。 .Bl -tag -width "Cm XX" .It Cm \&|\&| 論理 OR。 .It Cm \&&& 論理 AND。 .Ql Ic || より優先順位が上です。 .El .Pp C 言語と同様、 .Nm は条件式を、式の値を決定するのに必要なところまでしか評価しません。 評価順序を変更するには括弧を使います。論理オペレータ .Ql Ic !\& は条件式全体の値を反転するのに使用します。 .Ql Ic !\& は .Ql Ic \&&& より優先順位が上です。 .Pp 式 .Ar expression は、以下のいずれかの形式です: .Bl -tag -width Ic .It Ic defined 引数として変数名をとり、変数が定義されていれば真となる。 .It Ic make 引数としてターゲット名をとり、そのターゲットが .Nm のコマンドライン引数に指定されているか、デフォルトのターゲット .Pq 明示的なものも暗黙的なものも含む。 Va .MAIN の項を参照 として宣言されている場合に真となる。 .It Ic empty 引数として変数名 .Pq と修飾子 をとり、展開した結果が空文字列ならば真となる。 .It Ic exists 引数としてファイル名をとり、ファイルが存在すれば真となる。 ファイルはシステム検索パス .Pq Va .PATH の項を参照 にそって検索される。 .It Ic target 引数としてターゲット名をとり、ターゲットが定義されているなら真となる。 .El .Pp 条件式 .Ar expression としては、数値あるいは文字列の比較を用いることもできます。比較オペレータの 両辺は、変数展開が適用されたあとに比較されます。値が 0x で始まるなら 16 進数 であると解釈し、さもなければ 10 進数と解釈します。8 進数はサポートして いません。標準的な C 言語の関係オペレータは全て利用可能です。 変数展開後、 .Ql Ic == または .Ql Ic "!=" の左辺値または右辺値のいずれかが数値とは認められない場合、文字列として 比較を行います。関係オペレータが指定されなかった場合、展開された変数と 0 とを 比較します。 .Pp 条件式を評価中に、評価できない単語が出現した場合は、条件式の形式によって、 .Dq make または .Dq defined オペレータを適用します。条件式が .Ql Ic .ifdef または .Ql Ic .ifndef ならば .Dq defined を、条件式が .Ql Ic .ifmake または .Ql Ic .ifnmake ならば .Dq make を、それぞれ適用します。 .Pp 条件式が真と評価されたなら、makefile の解析はそのまま続行されます。 偽と評価されたなら、 .Ql Ic .else または .Ql Ic .endif が見つかるまで makefile の解析をスキップします。 .Pp for ループは、いくつかのルールを一連のファイルに適用するのによく 用いられます。以下がループの形式です: .Pp .Bl -tag -width indent -compact .It Ic .for Ar variable Ic in Ar expression .It .It Ic \&.endfor .El .Pp .Ar expression は評価されたあとに単語に分解され、それぞれを .Ar variable に代入 しながら、 .Ic make-rules 部分を繰り返し展開します。 .Sh コメント コメントはハッシュ記号 .Pq Ql \&# から始まり、シェルコマンド行以外のどこにでも置くことができます。 コメントは改行で終わります。 .Sh 特殊ソース .Bl -tag -width Ic .It Ic .IGNORE 本ターゲットに関連したコマンドでのエラーを無視します。シェルコマンドの 先頭にダッシュ .Ql \- を指定したのと等価です。 .It Ic .MAKE たとえ、 .Fl n や .Fl t オプションが指定されていても、このターゲットに関連したシェルコマンドを 実行します。通常、再帰的な .Nm のために用いられます。 .It Ic .NOTMAIN 通常 .Nm は、最初に発見したターゲットをデフォルトのターゲットとみなします。 .Ic .NOTMAIN が指定されたターゲットはデフォルトのターゲットとはみなされなくなります。 .It Ic .OPTIONAL もし .Ic .OPTIONAL が指定されたターゲットの作り方がわからなくても、エラーとはせず、 そのターゲットは必要ないか、すでに存在しているものとみなします。 .It Ic .PRECIOUS 通常 .Nm が中断されたときは、作成途中のターゲットは削除されます。本ソースを 指定することで、そのターゲットを削除しなくなります。 .It Ic .SILENT 指定されたターゲットに関連づけられたシェルコマンドを実行するときに エコーを行いません。シェルコマンドの先頭に .Ql @ を指定したのと等価です。 .It Ic .USE 指定されたターゲットをマクロ的に扱います。 .Ic .USE をソースに持つターゲット .Pq 以下ではマクロと呼びます が別のターゲットのソースとなった場合、その ターゲットはコマンド、ソース、属性( .Ic .USE は除く) をマクロから受け取ります。もし、すでにターゲットにコマンドが指定されていた 場合は、マクロのコマンドが追加されます。 .It Ic .WAIT 特別な .Ic .WAIT ソースが依存関係行に現れた時には、ソースはその行中でソースが 作成されるまで待ちます。ループは検出されず、ループ形式のターゲットは 単に無視されます。 .El .Sh 特殊ターゲット 特殊ターゲットは、他のターゲットとともに使用してはいけません。すなわち、 依存関係記述行の唯一のターゲットとして指定する必要があります。 .Bl -tag -width Ic .It Ic .BEGIN 本ターゲットに指定されたシェルコマンドは他の処理に先立って実行されます。 .It Ic .DEFAULT これは、作成方法がわからないどんなターゲットにも適用される .Ic .USE ルールのようなものです。シェルスクリプトのみを使用します。 .Ic .DEFAULT に指定されたコマンド中の .Ic .IMPSRC 変数はターゲット自身の名前に置換されます。 .It Ic .END 本ターゲットに指定されたシェルコマンドは、他のすべての処理の終了後に 実行されます。 .It Ic .IGNORE 指定されたソースに .Ic .IGNORE 属性を付与します。もしソースが指定されていなければ、 .Fl i オプションを指定したのと同じ意味になります。 .It Ic .INCLUDES ソースファイル中で include される可能性のあるファイルの拡張子のリスト。 拡張子はあらかじめ .Ic .SUFFIXES で宣言されていなければなりません; このように宣言された拡張子は自身の検索パス( .Ic .PATH 参照) にそれぞれ .Fl I フラグを前に付けた状態で .Va .INCLUDES 特殊変数に設定されます。 .It Ic .INTERRUPT .Nm が中断されたとき、本ターゲットに指定されたコマンドを実行します。 .It Ic .LIBS .Ic .INCLUDES が include ファイルに対して行なうことと同じことを ライブラリに対して行ないます。ただし .Fl L フラグが使われます。 .It Ic .MAIN ターゲットを指定せずに .Nm が起動された場合、本ターゲットを処理します。 .Nm がデフォルトターゲットを選択した際に、 利用者がコマンドラインからデフォルトターゲットを指示できるようにするため、 明示的・暗黙的に関わらず必ず設定されます。 .It Ic .MAKEFLAGS ソースにおいて、 .Nm に指定するフラグを指定します。フラグはシェルでタイプしたのと同様に 渡されますが、 .Fl f オプションは無効になります。 .\" XXX: NOT YET!!!! .\" .It Ic .NOTPARALLEL .\" この名前のターゲットは、並列モードを使わすに実行されます。 .\" ターゲットが指定されていない時には、全てのターゲットが非並列モード .\" で実行されます。 .It Ic .NOTPARALLEL 並列モードを使いません。 .It Ic .NO_PARALLEL 上と同じですが、 pmake の変種のための互換性のためにあります。 .It Ic .ORDER シーケンス中の名前付きターゲットが作成されます。 .\" XXX: NOT YET!!!! .\" .It Ic .PARALLEL .\" 名前付きターゲットが並列モードで実行されます。 .\" ターゲットが指定されない時には、全てのターゲットが並列モードで実行 .\" されます。 .It Ic .PATH カレントディレクトリに発見できなかったときのファイルの検索パスを、 本ターゲットのソースとして指定します。ソースが指定されなかった場合、 以前に設定されていたディレクトリが無効になります。 可能であれば .Ic .PATH を利用する方が、 .Va VPATH 変数を利用するよりも好まれています。 .It Ic .PATH\fIsuffix\fR カレントディレクトリに発見できなかったときの suffix のついたファイルの検索パスをソースとして指定します。 .Nm -はファイルが見つからなかった場合に、 +ユーティリティはファイルが見つからなかった場合に、 デフォルトパスよりも先に、まず suffix の付いた検索パスで探します。 この形式は .Ic .LIBS と .Ic .INCLUDES が動作するために必要です。 .It Ic .PHONY .Ic .PHONY 属性を指定したソースに適用します。この属性を持ったターゲットは いつでも更新されていると考えられます。 .It Ic .PRECIOUS 指定されたソースに .Ic .PRECIOUS 属性を付与します。もし、ソースが指定されなかった場合、 すべてのターゲットに .Ic .PRECIOUS 属性を与えます。 .It Ic .SILENT 指定されたソースに .Ic .SILENT 属性を付与します。もし、ソースが指定されなかった場合、 ファイル中のすべてのコマンドに .Ic .SILENT 属性を与えます。 .It Ic .SUFFIXES ソースにおいて、 .Nm で用いる拡張子を指定します。ソースが指定されなかった場合は、 以前の指定が無効になります。 .El .Sh 互換性 .Nm の古いバージョンは .Ev MAKEFLAGS の代わりに .Ev MAKE を使っていました。 この機能は POSIX への互換性のために削除されました。 内部変数 .Va MAKE は .Va .MAKE と同じ値が代入されます ; この機能は将来削除されるかもしれません。 .Pp .Nm のたくさんの秘密にされいている機能の多くは、 より多くの互換性を保つために使用を避けるべきです。 .Sh 環境変数 .Nm -は次の環境変数の値を用います: +ユーティリティは次の環境変数の値を用います: .Ev MACHINE , .Ev MAKE , .Ev MAKEFLAGS , .Ev MAKEOBJDIR , .Ev MAKEOBJDIRPREFIX , .Ev PWD .Sh 関連ファイル .Bl -tag -width /usr/share/doc/psd/12.make -compact .It Pa .depend 依存関係リスト .It Pa Makefile 依存関係リスト .It Pa makefile 依存関係リスト .It obj オブジェクトディレクトリ .It Pa sys.mk システム定義の makefile (他のすべてのファイルよりも前に処理されます。これには .Pa makefile と .Pa Makefile も含まれます) .It Pa /usr/share/mk システム定義の makefile が置かれるディレクトリ .It /usr/share/doc/psd/12.make PMake のチュートリアル .It Pa /usr/obj デフォルトの .Ev MAKEOBJDIRPREFIX ディレクトリ .El .Sh バグ .Va .OBJDIR の決定は不条理といっていいほどまで曲解されます。 .Pp 複数の .Ic .MAIN 特殊ターゲットが存在した場合、 .Nm は最初のもの以外は黙って無視します。 .Pp .Nm がターゲット名なしに起動された場合と .Ic .MAIN 特殊ターゲットが存在しなかった場合、 .Va .TARGETS は設定されません。 .Pp テスト時の .Ar expression の評価はあまり気が配られていません。今のところ、 .Ql .if ${VAR} op something という形式でしか動きません。 例えば、テストは .Ql .if ${VAR} = "string" のように書かなければなりません。 他の書き方では動きません。 .Pp for ループはテストされる前に展開されるため、 .Bd -literal \&.for TMACHINE in ${SHARED_ARCHS} \&.if ${TMACHINE} = ${MACHINE} ... \&.endif \&.endfor .Ed のような断片は動きません。他の方法を使って書き直す必要があります。 .Sh 関連項目 .Xr mkdep 1 , .Xr make.conf 5 .Rs .%T "PMake - A Tutorial" .Re .Pa /usr/share/doc/psd/12.make にあります。 .Sh 歴史 .Nm は .At v7 において追加されました。 diff --git a/ja_JP.eucJP/man/man1/man.1 b/ja_JP.eucJP/man/man1/man.1 index 4bc0b9f1b4..677e91b48a 100644 --- a/ja_JP.eucJP/man/man1/man.1 +++ b/ja_JP.eucJP/man/man1/man.1 @@ -1,235 +1,235 @@ .\" Man page for man .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" -.\" %FreeBSD: src/gnu/usr.bin/man/man/man.man,v 1.10.2.7 2002/02/01 09:00:02 ru Exp % +.\" %FreeBSD: src/gnu/usr.bin/man/man/man.man,v 1.10.2.8 2002/06/25 00:02:55 eric Exp % .\" .\" $FreeBSD$ .Dd January 5, 1991 .Dt MAN 1 .Os .Sh 名称 .Nm man .Nd オンラインマニュアルのフォーマット、表示を行なう .Sh 書式 .Nm .Op Fl adfhkotw .Op Fl m Ar machine .Op Fl p Ar string .Op Fl M Ar path .Op Fl P Ar pager .Op Fl S Ar list .Op Ar section .Ar name ... .Sh 解説 .Nm はオンラインマニュアルをフォーマットし、表示します。 このバージョンでは、環境変数 .Ev MANPATH と .Ev PAGER を参照するので、 各ユーザが固有のオンラインマニュアルを持つ事や、画面で見る際のページャを 選ぶ事が可能です。 セクションを指定した場合、 .Nm はそのセクションのみを探します。 また、コマンドラインオプションや環境変数によって、 検索するセクションの順序や、ソースファイルを処理するプリプロセッサを 指定することもできます。 システム管理者の設定によっては、 ディスクスペースを節約するために、フォーマット済みのオンライン マニュアルを `/usr/bin/gzip -c' コマンドにより 圧縮し格納するようにすることも出来ます。 .Pp オプションを以下に示します: .Bl -tag -width Fl .It Fl M Ar path 別の manpath を指定します。通常、 .Nm は .Xr manpath 1 ( .Nm バイナリに組み込まれています) を使い、検索するパスを決めます。 このオプションは環境変数 .Ev MANPATH よりも優先されます。 .It Fl P Ar pager 使用するページャを指定します。通常、 .Nm は、 .Nm more -s を使用します。 このオプションは環境変数 .Ev PAGER よりも優先されます。 .It Fl S Ar list list はコロンで区切られた検索するマニュアルのセクションのリストです。 このオプションは環境変数 .Ev MANSECT よりも優先されます。 .It Fl a 通常、 .Nm は最初にみつかったマニュアルページを表示した後終了しますが、 このオプションを使用すると、最初にみつかったマニュアルページだけでなく、 .Ar name にマッチしたマニュアルページを全て表示します。 .It Fl d マニュアルページは表示せず、デバッグ用の情報を表示します。 .It Fl f .Nm whatis と同じです。 .It Fl h -一行のヘルプメッセージを表示して終了します。 +ヘルプメッセージを表示して終了します。 .It Fl k .Nm apropos と同じです。 .It Fl m Ar machine マニュアルページによっては、特定のアーキテクチャに特化したものがあります。 .Nm は、検索対象のすべてのディレクトリ中で、 現在のアーキテクチャと同じ名前のサブディレクトリを検索します。 マシン固有の検索範囲が、一般的な検索範囲の前に検索されます。 現在のマシンタイプは、環境変数 .Ev MACHINE を特定のアーキテクチャ名に設定することで変えられます。 本オプションは、 .Ev MACHINE 環境変数に優先します。 .It Fl o 元の、非ローカライズ版マニュアルページのみを検索します。 .Pp デフォルトでは、 .Nm は、 各 .Xr manpath 1 構成要素毎にローカライズ版サブディレクトリを検索します。 .Pp ロケール名は、3 個の環境変数 .Ev LC_ALL , .Ev LC_CTYPE , .Ev LANG のうち、この順番における最初の空ではないものから得られます。 .Pp 値を決定できない場合か、無効なロケール名である場合、 ローカライズされていないマニュアルページのみが検索されます。 .Pp そうでない場合、 .Nm は次のサブディレクトリを、次の優先順位で検索します: .Pp .Bl -item -offset indent -compact .Sm off .It .Pa _ . .It .Pa . .It .Pa en . .Sm on .El .Pp 例えば .Dq de_DE.ISO8859-1 ロケールの場合、 .Pa /usr/share/man manpath 構成要素中の次のサブディレクトリを .Nm は検索します: .Pp .Bl -item -offset indent -compact .It .Pa /usr/share/man/de_DE.ISO8859-1 .It .Pa /usr/share/man/de.ISO8859-1 .It .Pa /usr/share/man/en.ISO8859-1 .El .Pp 最後に、ローカライズされたマニュアルページが見付からなかった場合、 デフォルトの .Pa /usr/share/man ディレクトリを検索します。 .It Fl p Ar string nroff や troff を行う前に実行するプリプロセッサの順序を指定します。 全てのプリプロセッサがインストールされているとはかぎりません。 プリプロセッサとそれを指定するのに使われる文字は以下の通りです。 eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). このオプションは環境変数 .Ev MANROFFSEQ よりも優先されます。 .It Fl t マニュアルページをフォーマットするのに .Nm /usr/bin/groff -S -man を使い、標準出力に出力します。 .Nm /usr/bin/groff -S -man の出力は表示する前に何らかのフィルタを通す必要があるでしょう。 .It Fl w マニュアルページの表示は行わず、フォーマットや表示を行なうべきファイルの 場所を表示します。 .El .Sh 環境変数 .Bl -tag -width MANROFFSEQ .It Ev LC_ALL , LC_CTYPE , LANG これらの環境変数は、マニュアルページの好みの言語を指定します (前述の .Fl o オプションを参照してください)。 .It Ev MACHINE .Ev MACHINE が設定されると、マシン固有のサブディレクトリを検索するときに、 この値が現在のマシンタイプに優先します。 .It Ev MANPATH .Ev MANPATH がセットされていれば、その値はマニュアルページを検索するパスとして使われます。 .It Ev MANROFFSEQ .Ev MANROFFSEQ がセットされていれば、その値は nroff や troff を行う前に実行される プリプロセッサの順序を示すのに使われます。 デフォルトでは、nroff の前に tbl プリプロセッサが実行されます。 .It Ev MANSECT .Ev MANSECT がセットされていれば、その値はどのマニュアルセクションを検索するのかを 決定するのに使われます。 .It Ev PAGER .Ev PAGER がセットされていれば、その値はマニュアルページを表示するのに使われる プログラムの名前を指定するのに使われます。セットされていなければ、 .Nm more -s が使われます。 .El .Sh 使用例 通常、getopt の適切なマニュアルページ情報を検索するには、次のようにします: .Pp .Dl man getopt .Pp 一方、特定のマニュアルセクション、例えば .Xr getopt 3 を検索するには、次のようにします: .Pp .Dl man 3 getopt .Sh 関連項目 .Xr apropos 1 , .Xr groff 1 , .Xr manpath 1 , .Xr more 1 , .Xr whatis 1 , .Xr man 7 , .Xr mdoc 7 .Sh バグ .Fl t オプションは .Xr troff 1 ライクなプログラムがインストールされている場合のみ有効です。 diff --git a/ja_JP.eucJP/man/man1/md5.1 b/ja_JP.eucJP/man/man1/md5.1 index b9f288604b..62aae23566 100644 --- a/ja_JP.eucJP/man/man1/md5.1 +++ b/ja_JP.eucJP/man/man1/md5.1 @@ -1,78 +1,78 @@ -.\" %FreeBSD: src/sbin/md5/md5.1,v 1.10.2.6 2001/12/14 15:17:49 ru Exp % +.\" %FreeBSD: src/sbin/md5/md5.1,v 1.10.2.7 2002/06/20 23:09:06 charnier Exp % .\" .\" $FreeBSD$ .Dd February 14, 1994 .Dt MD5 1 .Os .Sh 名称 .Nm md5 .Nd ファイルに対するフィンガプリント(チェックサム)を計算する .Sh 書式 .Nm .Op Fl pqrtx .Op Fl s Ar string .Op Ar .Sh 解説 .Nm -は、任意の長さのメッセージを入力にとり、 128 ビットの +ユーティリティは、任意の長さのメッセージを入力にとり、128 ビットの .Dq フィンガプリント もしくは .Dq メッセージの要約 と呼ばれるものを出力として生成します。 同じ要約を持つようなメッセージを二つ造る事も、 これと決めた要約を持つように狙ってメッセージを造り出す事も、 計算量的に不可能であると推論されています。 電子署名アプリケーションにおいて、大きなファイルは .Em RSA の様な公開鍵暗号システムで非公開 (秘密) 鍵によって符号化される前に、 安全に .Dq 圧縮 されなければなりません。 MD5 はまだ (2001-09-03) 破られていませんが、 セキュリティに対するいくらかの疑いをもたらす十分な攻撃がなされています。 MD5 に対する攻撃は、 .Dq 衝突 を見つけるという種類のものです すなわち、同じ値にハッシュされる複数の入力を見つけるというものです。 しかしながら、ハッシュ値から元の入力を正確に決定することは、 まだ攻撃者にとって可能ではなさそうです。 .Pp MD5 アルゴリズムは、そのような電子署名アプリケーション向けに開発されています。 .Pp 以下のオプションを組み合わせて使うことができますが、 コマンド行のファイル名より前になければなりません。 コマンド行の各ファイルの MD5 チェックサムが、 オプション処理後に表示されます。 .Bl -tag -width indent .It Fl s Ar string 与えられた .Ar string のチェックサムを表示します。 .It Fl p 標準入力を標準出力に送り、MD5 の合計を標準出力に付け加えます。 .It Fl q 静かなモード - MD5 の合計だけを表示します。 .Fl r オプションに優先します。 .It Fl r 出力フォーマットを逆にします。 視覚による差分の助けになります。 .Fl ptx オプションと組み合わせると、なにもしません。 .It Fl t 組み込みの時間試行を実行します。 .It Fl x 組み込みのテストスクリプトを実行します。 .El .Sh 関連項目 .Xr cksum 1 .Rs .%A R. Rivest .%T The MD5 Message-Digest Algorithm .%O RFC1321 .Re .Sh 謝辞 このプログラムは、RSA Data Security 社により、 一般的な利用に対してパブリックドメインとされています。 diff --git a/ja_JP.eucJP/man/man1/minigzip.1 b/ja_JP.eucJP/man/man1/minigzip.1 index d34d80c4f2..4fba3d6c8c 100644 --- a/ja_JP.eucJP/man/man1/minigzip.1 +++ b/ja_JP.eucJP/man/man1/minigzip.1 @@ -1,70 +1,70 @@ .\" 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. .\" -.\" %FreeBSD: src/usr.bin/minigzip/minigzip.1,v 1.3.2.3 2001/07/22 12:40:26 dd Exp % +.\" %FreeBSD: src/usr.bin/minigzip/minigzip.1,v 1.3.2.4 2002/06/21 15:28:11 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/minigzip.1,v 1.7 2001/05/14 01:07:26 horikawa Exp $ +.\" $FreeBSD$ .Dd December 13, 1997 .Dt MINIGZIP 1 .Os .Sh 名称 .Nm minigzip .Nd 'gzip' 圧縮ツールの最小限度の実装 .Sh 書式 .Nm .Op Fl d .Op Ar .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/mkdep.1 b/ja_JP.eucJP/man/man1/mkdep.1 index 252e1f765d..efd5b3e207 100644 --- a/ja_JP.eucJP/man/man1/mkdep.1 +++ b/ja_JP.eucJP/man/man1/mkdep.1 @@ -1,124 +1,125 @@ .\" Copyright (c) 1987, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)mkdep.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/mkdep/mkdep.1,v 1.7.2.5 2001/08/16 13:16:57 ru Exp % +.\" %FreeBSD: src/usr.bin/mkdep/mkdep.1,v 1.7.2.6 2002/06/21 15:28:13 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/mkdep.1,v 1.9 2001/07/29 05:14:51 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt MKDEP 1 .Os .Sh 名称 .Nm mkdep .Nd Makefile の依存関係リストを構築する .Sh 書式 .Nm .Op Fl ap .Op Fl f Ar file .Op Ar flags .Ar .Sh 解説 .Nm -は C コンパイラへのフラグと C のソースファイルリストを引数にとり、 +ユーティリティは、 +C コンパイラへのフラグと C のソースファイルリストを引数にとり、 インクルードファイルの依存関係リストを構築し、 ファイル ``.depend'' に書き出します。 例えば Makefile においては以下のように用いられます: .Bd -literal -offset indent CFLAGS= -O -I../include SRCS= file1.c file2.c depend: mkdep ${CFLAGS} ${SRCS} .Ed .Pp ここでマクロ SRCS は C のソースファイルのリストであり、 CFLAGS は C コンパイラへ与えるフラグのリストです。 .Pp ユーザは、使用するプリプロセッサとプリプロセッサオプションを変更可能です。 例えば、gcc をプリプロセッサとして使用し、システムのヘッダを無視するには、 次のようにします: .Bd -literal -offset indent depend: env MKDEP_CPP="gcc -E" MKDEP_CPP_OPTS=-MM mkdep \\ ${CFLAGS} ${SRCS} .Ed .Pp オプションは以下の通りです: .Bl -tag -width Ds .It Fl a 結果を出力ファイルに追加します。 これにより同一の Makefile から .Nm を複数回実行することができます。 .It Fl f インクルードファイル依存関係を、デフォルトの ``.depend'' ではなく、ファイル .Ar file に書き出します。 .It Fl p 依存関係を以下の形式で出力します: .Bd -literal -offset indent program: program.c .Ed .Pp これにより、後続の make は中間ファイル .Pa \&.o を経ることなく、直接 C のソースモジュールから .Ar program を生成することができるようになります。 この機能は、ソースが単一のモジュールから構成されているプログラムに便利です。 .El .Sh 関連項目 .Xr cc 1 , .Xr cpp 1 , .Xr make 1 .Sh 関連ファイル .Bl -tag -width .depend -compact .It Pa .depend 依存関係リストを含むファイル .El .Sh 環境変数 .Bl -tag -width MKDEP_CPP_OPTS .It Ev CC 使用する C コンパイラを指定します。 指定されたコンパイラは、 GNU C コンパイラと一貫性のあるオプションを持つと仮定されます。 .It Ev MKDEP_CPP 使用するプリプロセッサを指定します。デフォルトは "${CC} -E" です。 .It Ev MKDEP_CPP_OPTS プリプロセッサに対する CFLAGS 以外のオプションを指定します。 デフォルトは "-M" です。 .El .Sh 歴史 .Nm コマンドは .Bx 4.3 Tahoe から登場しました。 diff --git a/ja_JP.eucJP/man/man1/mkfifo.1 b/ja_JP.eucJP/man/man1/mkfifo.1 index b27f965c68..3848224a9c 100644 --- a/ja_JP.eucJP/man/man1/mkfifo.1 +++ b/ja_JP.eucJP/man/man1/mkfifo.1 @@ -1,98 +1,98 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)mkfifo.1 8.2 (Berkeley) 1/5/94 -.\" %FreeBSD: src/usr.bin/mkfifo/mkfifo.1,v 1.6.2.3 2001/08/16 13:16:58 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/mkfifo.1,v 1.9 2001/08/17 06:18:09 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/mkfifo/mkfifo.1,v 1.6.2.4 2002/06/21 15:28:15 charnier Exp % +.\" $FreeBSD$ .\" .Dd January 5, 1994 .Dt MKFIFO 1 .Os .Sh 名称 .Nm mkfifo .Nd FIFO パイプをつくる .Sh 書式 .Nm .Op Fl m Ar mode .Ar fifo_name ... .Sh 解説 .Nm -コマンドは、指定された名前で、指定された順に +ユーティリティは、指定された名前で、指定された順に FIFO パイプをつくります。 .Pp オプションは次の通りです: .Bl -tag -width indent .It Fl m 作成する FIFO のファイルパーミッションビットを指定したモードにし、 呼び出し元プロセスの .Xr umask 2 を無視します。 モード引数は、 .Xr chmod 1 コマンドに指定可能な任意の書式を取ります。 シンボル形式のモードが指定された場合、オペランドシンボル .Dq + (プラス) と .Dq - (ハイフン) は、初期モード .Dq a=rw に対する相対として解釈されます。 .El .Pp .Fl m オプションが指定されないと、 .Li \&0666 を呼び出し元プロセスの .Xr umask 2 で修正したモードで FIFO を作成します。 .Nm -コマンドには、親ディレクトリに書き込みパーミッションが必要です。 +ユーティリティには、親ディレクトリに書き込みパーミッションが必要です。 .Sh 診断 .Ex -std .Sh 規格 .Nm -コマンドは、 +ユーティリティは、 .St -p1003.2 準拠であると考えられています。 .Sh 関連項目 .Xr mkdir 1 , .Xr rm 1 , .Xr mkfifo 2 , .Xr mknod 2 , .Xr mknod 8 .Sh 歴史 .Nm は .Bx 4.4 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/mkstr.1 b/ja_JP.eucJP/man/man1/mkstr.1 index d15fe6dfad..5d5f4989f3 100644 --- a/ja_JP.eucJP/man/man1/mkstr.1 +++ b/ja_JP.eucJP/man/man1/mkstr.1 @@ -1,143 +1,145 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)mkstr.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/mkstr/mkstr.1,v 1.7.2.1 2001/03/06 12:52:52 ru Exp % +.\" %FreeBSD: src/usr.bin/mkstr/mkstr.1,v 1.7.2.2 2002/06/21 15:28:17 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt MKSTR 1 .Os .Sh 名称 .Nm mkstr .Nd C 言語ソースファイルからエラーメッセージファイルを作成する .Sh 書式 .Nm .Op Fl .Ar messagefile .Ar prefix Ar .Sh 解説 .Nm -は C 言語ソースファイルからエラーメッセージを抽出し、 +ユーティリティは、C 言語ソースファイルからエラーメッセージを抽出し、 これを格納するファイルを作成します。また作成され たエラーメッセージファイルを使用するように、そのソースファイルを修正し ます。mkstr は巨大なプログラムのサイズを減少させ、スワップを減らすこと を目的としています ( .Sx バグ の項を参照) 。 .Pp .Nm -はコマンドラインで指定されたファイルを処理し、修正した入力ファイ -ルを、指定されたファイル名に、指定されたプレフィックスをつけた名前のファイル +ユーティリティは、 +コマンドラインで指定されたファイルを処理し、修正した入力ファイルを、 +指定されたファイル名に、指定されたプレフィックスをつけた名前のファイル で出力します。以下の使用例は典型的なものです。 .Bd -literal -offset indent mkstr pistrings xx *.c .Ed .Pp .Nm は、カレントディレクトリにあるすべての C 言語ソースから集めた エラーメッセージを、ファイル .Ar pistrings に出力し、修正されたソースファイルを、ファイル名の先頭に .Ar \&xx をつけたファイルに出力します。 .Pp オプション .Bl -tag -width indent .It Fl 指定されたエラーメッセージファイルの最後に、エラーメッセージが置かれます。 これは、 .Nm で処理された巨大なプログラムの一部を再コンパイルするために使用します。 .El .Pp .Nm -は、ソースファイル中の +ユーティリティは、ソースファイル中の .Li \&`error("' という文字列をもとにエラーメッセージを検索します。この文字列が出現すると、 .Sq \&"\& から開始される文字列および その後にヌル文字と改行文字をメッセージファイルに出力します; 変更前のソースにおいて文字列であった部分は、 メッセージファイルのオフセットに置き換えられ .Xr lseek 2 によって対応するメッセージを取り出すことができます。 実際にメッセージを取り出す場合には、以下のようなコードを使用します。 .Bd -literal -offset indent char efilname = "/usr/lib/pi_strings"; int efil = -1; error(a1, a2, a3, a4) \&{ char buf[256]; if (efil < 0) { efil = open(efilname, 0); if (efil < 0) { oops: perror(efilname); exit 1 ; } } if (lseek(efil, (long) a1, 0) \ read(efil, buf, 256) <= 0) goto oops; printf(buf, a2, a3, a4); } .Ed .Sh 関連項目 .Xr xstr 1 , .Xr lseek 2 .Sh 歴史 .Nm -は +ユーティリティは .Bx 3.0 -で追加されました。 +で登場しました。 .Sh バグ .Nm -は、PDP 11 ファミリーの制限されたアーキテクチャのために開発されました。 +ユーティリティは、 +PDP 11 ファミリーの制限されたアーキテクチャのために開発されました。 ごく一部のプログラムしか mkstr を使用していません。 Pascal インタプリタ .Xr \&pi 1 とエディタ .Xr \&ex 1 が .Nm により作成されています。 .Nm の方法は効率的なものとはいえないので、 エラーメッセージはプログラムテキストのなかに埋め込まれているべきです .Pq (訳注) 最近はメッセージの国際化等のために、プログラム中にメッセージを埋め込まない方法もよく用いられます 。 .\" 上記(訳注)は翻訳時からあったが、現状確かにそうなので残しました。 .\" 2.1.5-2.2-RELEASE 対象 .\" By horikawa@jp.freebsd.org (Mar 29 1997) diff --git a/ja_JP.eucJP/man/man1/mktemp.1 b/ja_JP.eucJP/man/man1/mktemp.1 index b3f376719f..588f21de5f 100644 --- a/ja_JP.eucJP/man/man1/mktemp.1 +++ b/ja_JP.eucJP/man/man1/mktemp.1 @@ -1,186 +1,187 @@ .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" From: %OpenBSD: mktemp.1,v 1.8 1998/03/19 06:13:37 millert Exp % -.\" %FreeBSD: src/usr.bin/mktemp/mktemp.1,v 1.7.2.6 2001/07/22 12:40:27 dd Exp % +.\" %FreeBSD: src/usr.bin/mktemp/mktemp.1,v 1.7.2.7 2002/06/21 15:28:19 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/mktemp.1,v 1.12 2001/05/14 01:07:26 horikawa Exp $ +.\" $FreeBSD$ .Dd November 20, 1996 .Dt MKTEMP 1 .Os .Sh 名称 .Nm mktemp .Nd (ユニークな) 一時ファイル名を作成する .Sh 書式 .Nm .Op Fl d .Op Fl q .Op Fl t Ar prefix .Op Fl u .Ar template ... .Nm .Op Fl d .Op Fl q .Op Fl u .Fl t Ar prefix .Sh 解説 .Nm ユーティリティは、引数のファイル名テンプレートの一つ一つに対して、 その一部を上書きすることにより、ファイル名を生成します。 このファイル名はユニークであり、アプリケーションが使用するのに適しています。 テンプレートは、いくつかの .Ql X が後続する任意のファイル名であり、例えば .Pa /tmp/temp.XXXX です。 後続する .Ql X は、現在のプロセス番号やユニークな文字の組み合わせと置き換えられます。 .Nm が返すことが可能なユニークなファイル名の数は、指定した .Ql X の数に依存します; .Ql X を 6 つ指定した場合には、およそ 26 ** 6 の組み合わせを .Nm が扱えることとなります。 .Pp .Nm がユニークなファイル名を生成することに成功した場合、 ファイルがモード 0600 ( .Fl u フラグ未指定時) で作成され、ファイル名が標準出力に出力されます。 .Pp .Fl t Ar prefix オプション指定時には、 .Nm はテンプレート文字列を .Ar prefix と、 .Ev TMPDIR 環境変数が設定されていればそれも用いて生成します。 .Ev TMPDIR が設定されていない場合の、デフォルトの場所は .Pa /tmp です。ユーザが指定したかもしれない環境変数の使用が適切であると保証 できるかどうかに注意を払ってください。 .Pp 1 回の起動でいくつでも一時ファイルを作ってかまいません。これには、 .Fl t フラグの結果の内部テンプレートをもとにするものひとつも含まれます。 .Pp .Nm -は、シェルスクリプトが安全に一時ファイルを使用するために提供されています。 +ユーティリティは、 +シェルスクリプトが安全に一時ファイルを使用するために提供されています。 伝統的に多くのシェルスクリプトが、 プログラム名に pid を付けた名前を一時ファイル名として使用しています。 この種の命名法は予測されうるので、 レース状態となった場合に容易に攻撃者が勝ってしまいます。 より安全、しかしながらまだ劣ったアプローチとして、 同じ命名法でディレクトリを作るというものがあります。 この方法では一時ファイルが壊されないことを保証できますが、 単純なサービス停止攻撃を許してしまいます。 上記のような理由により、 .Nm の使用をお勧めします。 .Sh オプション 使用可能なオプションを以下に示します: .Bl -tag -width indent .It Fl d ファイルではなくディレクトリを作成します。 .It Fl q エラーが発生した場合、黙って失敗します。 エラー出力が標準エラーに出力されることが望ましくないスクリプトで有用です。 .It Fl t Ar prefix ファイル名テンプレートを生成するために必要なテンプレートを生成します (与えられた .Ar prefix と、設定されている場合には .Ev TMPDIR を使用します)。 .It Fl u .Dq 安全ではない モードで操作します。一時ファイルは .Nm が終了する前にアンリンクされます。これは .Xr mktemp 3 よりは少しましですが、依然レース状態を引き起こします。 このオプションの使用はお勧めしません。 .El .Sh 診断 .Nm ユーティリティは、成功時には値 0 で終了します。 失敗時には値 1 で終了します。 .Sh 使用例 以下の .Xr sh 1 スクリプトの一部で、 .Nm の簡単な使用方法を説明します。 このスクリプトは、安全な一時ファイルを取得できない場合には終了します。 .Bd -literal -offset indent tempfoo=`basename $0` TMPFILE=`mktemp /tmp/${tempfoo}.XXXXXX` || exit 1 echo "program output" >> $TMPFILE .Ed .Pp $TMPDIR を使用する場合には次のようにします: .Bd -literal -offset indent tempfoo=`basename $0` TMPFILE=`mktemp -t ${tempfoo}` || exit 1 echo "program output" >> $TMPFILE .Ed .Pp 次の場合、スクリプト自身でエラーをつかまえます。 .Bd -literal -offset indent tempfoo=`basename $0` TMPFILE=`mktemp -q /tmp/${tempfoo}.XXXXXX` if [ $? -ne 0 ]; then echo "$0: Can't create temp file, exiting..." exit 1 fi .Ed .Sh 関連項目 .Xr mkdtemp 3 , .Xr mkstemp 3 , .Xr mktemp 3 , .Xr environ 7 .Sh 歴史 .Nm ユーティリティは .Ox 2.1 に登場しました。この実装は .Ox のマニュアルページとは独立に記述され、 .Fx 2.2.7 に初めて登場しました。 このマニュアルページは .Ox 由来です。 diff --git a/ja_JP.eucJP/man/man1/msgs.1 b/ja_JP.eucJP/man/man1/msgs.1 index 9e20452f0a..414a1ae727 100644 --- a/ja_JP.eucJP/man/man1/msgs.1 +++ b/ja_JP.eucJP/man/man1/msgs.1 @@ -1,217 +1,217 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)msgs.1 8.2 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.bin/msgs/msgs.1,v 1.9.2.5 2001/08/16 13:16:58 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/msgs.1,v 1.10 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/msgs/msgs.1,v 1.9.2.6 2002/06/21 15:28:22 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 28, 1995 .Dt MSGS 1 .Os .Sh 名称 .Nm msgs .Nd システムからのメッセージを読むための簡単なメールプログラム .Sh 書式 .Nm .Op Fl fhlpq .Op Ar number .Op Ar \-number .Nm .Op Fl s .Nm .Op Fl c .Op \-days .Sh 解説 .Nm -は、システムからのメッセージを読むためのプログラムです。 +ユーティリティは、システムからのメッセージを読むためのプログラムです。 これらのメッセージはユーザ `msgs' あてにメールを送ることで送信されます。 これらのメッセージは、ユーザがシステムにログインした時に、 システムからの簡単なメッセージを一度だけ表示するのに便利です。 .Pp .Nm -を +ユーティリティを .Pa .login ファイル ( .Xr sh 1 を使っているならば、 .Pa .profile ) に書いておくことによって、 ログインするたびに .Nm が実行されます。 もし、新しいメッセージがあれば、誰からのメッセージかという情報と、 Subject とを表示します。 もし Subject 行が無ければ、先頭の空行でない数行を表示します。 もし、より多くのメッセージがあれば、残りのメッセージ量を示し、 残りのメッセージを見るかどうかを尋ねます。 返事としては、以下のものを使うことができます: .Bl -tag -width Fl .It Ic y メッセージを表示します。 .It Ic RETURN y と同じです。 .It Ic n このメッセージをスキップして、次のメッセージに行きます。 .It Fl 最後に表示したメッセージを再表示します。 .It Ic q .Nm を終了します。次回には読まなかったメッセージを読むことができます。 .It Ic s メッセージをセーブします。現在のメッセージをカレントディレクトリの ``Messages'' というファイルに追加します。 `s\-' は表示する前にセーブします。 `s' や `s\-' はその後ろに空白をはさんでセーブするファイル名を指定できます。 .It Ic m 指定されたメッセージを、一時的な mailbox としてファイルに記録し、 .Xr mail 1 を起動して、記録したファイルをメールとして扱うことができるようにします。 `m' , `s' コマンドは、`-' の代わりに数字の引数を受け付けます。 .El .Pp .Nm -は、各ユーザのホームディレクトリの +ユーティリティは、各ユーザのホームディレクトリの .Pa \&.msgsrc に記録されている番号を読み込んで、新たに読むべきメッセージを決定します。 .Pa /var/msgs というディレクトリには、(シーケンシャルな)メッセージ番号を ファイル名として格納しています。 .Pa /var/msgs/bounds というファイルには、 このディレクトリにあるメッセージの一番小さな番号と大きな番号を記録しています。 これにより、 .Nm はメッセージがあるかどうか、ただちに判定できます。 .Pa bounds の内容が壊れている場合は、このファイルを削除することで、次回 .Fl s オプション付きで起動されたときに、新しく .Pa bounds を作成します。 .Nm が .Fl s 以外のオプションを指定されて実行された場合、 .Pa /var/msgs/bounds が存在しないとエラーが表示されます。 .Pp .Fl s オプションは、メッセージの配送を設定する時に使います。 .Pp .Dl msgs: \&"\&| /usr/bin/msgs \-s\&" .Pp という行を .Pa /etc/mail/aliases に挿入して ( .Xr newaliases 1 参照)、メッセージを投函できるようにします。 .Pp .Fl c オプションは .Pa /var/msgs をクリアするために使います。 .Nm を .Fl c つきで実行するシェルスクリプトのエントリを、 .Pa /etc/periodic/daily ( .Xr periodic 8 参照) に記述して、毎晩実行するようにするといいでしょう。 これで、21 日より古いメッセージを消すことができます。 デフォルトの日付を変更するにはコマンドラインで設定する必要があります。 .Pp メッセージを読む時のオプションとしては以下のものがあります: .Bl -tag -width Fl .It Fl f ``No new messages.'' を表示しません。これは、 .Pa .login ファイルなどに .Nm を書いておく場合に便利です。 .It Fl q メッセージがある場合に、``There are new messages.'' と表示するようにし ます。 .Pa .login ファイルなどに ``msgs \-q'' と書いておくと便利です。 .It Fl h メッセージの最初の部分だけを表示します。 .It Fl l ローカルに作られたメッセージだけを報告します。 .It Ar num コマンドラインから番号を与えると、 .Pa \&.msgsrc に記録されている番号を使わずに、指定した番号以降のメッセージを表示します。 つまり、 .Pp .Dl msgs \-h 1 .Pp は、すべてのメッセージのはじめの部分を表示します。 .It Ar \-number .Pa \&.msgsrc に記録されている番号より .Ar number 分だけ戻ったメッセージから表示します。最近のメッセージを見るのに便利です。 .It Fl p 長いメッセージは、 .Xr more 1 を使います。 .El .Pp .Nm のコマンド対話モードの時に、コマンドの代わりに番号を入力することで、 指定した番号のメッセージに移動することができます。 .Sh 環境変数 .Nm -は、デフォルトのホームディレクトリと端末タイプを知るために、 +ユーティリティは、デフォルトのホームディレクトリと端末タイプを知るために、 .Ev HOME と .Ev TERM を参照します。 .Sh 関連ファイル .Bl -tag -width /var/msgs/* -compact .It Pa /var/msgs/* メッセージデータベース .It Pa ~/.msgsrc 次のメッセージ番号を記録しているファイル .El .Sh 関連項目 .Xr mail 1 , .Xr more 1 , .Xr aliases 5 , .Xr periodic 8 .Sh 歴史 .Nm コマンドは、 .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/mt.1 b/ja_JP.eucJP/man/man1/mt.1 index 3b8da0270f..54da14e1f0 100644 --- a/ja_JP.eucJP/man/man1/mt.1 +++ b/ja_JP.eucJP/man/man1/mt.1 @@ -1,372 +1,372 @@ .\" Copyright (c) 1981, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)mt.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/mt/mt.1,v 1.19.2.5 2001/08/16 13:16:58 ru Exp % +.\" %FreeBSD: src/usr.bin/mt/mt.1,v 1.19.2.6 2002/06/21 15:28:24 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt MT 1 .Os .Sh 名称 .Nm mt .Nd 磁気テープ操作プログラム .Sh 書式 .Nm .Op Fl f Ar tapename .Ar command .Op Ar count .Sh 解説 .Nm -は、 +ユーティリティは、 磁気テープドライブへコマンドを与えるのに使われます。 通常、 .Nm は要求された操作を一度だけ行います。 操作によっては .Ar count で指定した回数だけ繰り返し実行できます。 なお、 .Ar tapename は生の (ブロック型でない) テープデバイスを指していなければなりません。 .Pp 使用可能なコマンドは下記のようになっています。 コマンドの指定にあたって、 一意に特定するのに必要なだけの文字数は与える必要があります。 .Bl -tag -width "eof, weof" .It Cm weof テープの現在位置に .Ar count 個のファイル終端マークを書き込みます。 .It Cm smk テープの現在位置に .Ar count 個の位置決定マークを書き込みます。 .It Cm fsf ファイル .Ar count 個分早送りします。 .It Cm fsr レコード .Ar count 個分早送りします。 .It Cm fss 位置決定マーク .Ar count 個分早送りします。 .It Cm bsf ファイル .Ar count 個分巻き戻します。 .It Cm bsr レコード .Ar count 個分巻き戻します。 .It Cm bss 位置決定マーク .Ar count 個分巻き戻します。 .It Cm rdhpos ハードウェアブロック位置を読み取ります。 この機能をサポートしないドライブもあります。 報告されるブロック番号は、そのハードウェア固有のものです。 count 引数は無視されます。 .It Cm rdspos SCSI 論理ブロック位置を読み取ります。 この機能をサポートしないドライブもあります。 count 引数は無視されます。 .It Cm sethpos ハードウェアブロック位置を設定します。 この機能をサポートしないドライブもあります。 count 引数は、テープ移動先のハードウェアブロックであると解釈されます。 .It Cm setspos SCSI 論理ブロック位置を設定します。 この機能をサポートしないドライブもあります。 count 引数は、テープ移動先の SCSI 論理ブロックであると解釈されます。 .It Cm rewind テープを巻き戻します (カウントは無視)。 .It Cm offline , rewoffl テープを巻き戻して、 テープユニットをオフライン状態にします (カウントは無視)。 .It Cm erase テープを消去します。 カウント 0 は長い消去を無効にします。これがデフォルトです。 .It Cm retension テープのたるみを取ります (一度最後まで早送りして、 また巻き戻します。カウントは無視)。 .It Cm status テープユニットの状態情報を出力します。 SCSI 磁気テープドライブに対しては、 現在の操作モードとして、密度・ブロックサイズ・圧縮の有無が報告されます。 ドライブの現在の状態 (デバイスに対して何を行っているのか) も報告されます。 ドライブが (ファイルマークおよびレコードを基準とした) BOT からの相対位置を知っている場合、これも表示します。 この情報は信頼できるものではないことに注意してください (BOT、記録メディアの終端、(ドライブが報告するのであれば) ハードウェアブロック位置と SCSI 論理ブロック位置のみが、 テープ位置として信頼できます)。 .It Cm errstat このドライブに関するエラー状態情報を表示 (およびクリア) します。 各通常操作 (例えば読み込みや書き込み) および 各制御操作 (例えば巻き戻し) に対し、 最後に実行したコマンドとこれに関連した状態と存在すれば残りのカウントを、 ドライバは格納します。 本コマンドは、この情報を引き出して表示します。 可能であれば、ラッチしたエラー情報もまたクリアします。 .It Cm blocksize テープユニットに対してブロックサイズを指定します。 零は可変長ブロックを意味します。 .It Cm density テープユニットに対して密度を指定します。 密度の符号化方式については、 下記を参照して下さい。 密度の値は、 .Dq リファレンス 欄に応じた数字と文字列のどちらでも与えることができます。 もし文字列が略記されていたら、 表に書かれてある順番で調べていき、 最初に合致した項目が使われます。 与えられた文字列と正しい密度名称を調べた結果が正確に合致しないのであれば、 与えられた文字列がどう解釈されたかについて、 通知メッセージが出力されます。 .It Cm geteotmodel 現在の EOF ファイルマークモデルを、取得して表示します。 モデル状態とは、 テープが書き込まれる場合、 書き込みクローズ時に何個のファイルマークが書き込まれるかを表現します。 .It Cm seteotmodel 現在の EOT ファイルマークモデルを、( .Ar count 引数に) 設定して表示します。 典型的には、これはファイルマーク .Ar 2 個ですが、デバイスによっては (典型的には QIC カートリッジドライブでは)、 ファイルマークを .Ar 1 個だけ書き込み可能です。現在のところ、値は .Ar 1 または .Ar 2 だけから選択可能です。 .It Cm eom 記録されたメディアの終端まで早送りします (カウントは無視)。 .It Cm eod データの終端まで早送りします。 .Cm eom と同じです。 .It Cm comp 圧縮モードを指定します。 現在、圧縮モードに指定可能な値はいくつかあります: .Pp .Bl -tag -width 9n -compact .It off 圧縮オフ .It on 圧縮オン .It none .Ar off と同じ .It enable .Ar on と同じ .It IDRC IBM Improved Data Recording Capability 圧縮 (0x10)。 .It DCLZ DCLZ 圧縮アルゴリズム (0x20)。 .El .Pp 前記の認識される圧縮キーワードに加え、 テープドライブが使用する圧縮アルゴリズムをユーザが数値で指定可能です。 ほとんどの場合、単に圧縮を .Sq on にするだけで、 ドライブがサポートしているデフォルトの圧縮アルゴリズムを有効にするという 望ましい効果が得られます。 そうでない場合 ( .Cm status を見て、どの圧縮アルゴリズムを現在使用しているかを見てください)、 サポートされている圧縮キーワード (上述) もしくは 数値の圧縮値をユーザが手動で指定可能です。 .El .Pp テープ名が与えられていないくて、かつ環境変数 .Ev TAPE が存在しない場合、 .Nm はデバイス .Pa /dev/nsa0 を使用します。 .Pp .Nm -は、操作が成功したならば 0 の終了値を、 +ユーティリティは、操作が成功したならば 0 の終了値を、 コマンドが認識不能の場合には 1 を、 また操作が失敗したならば 2 を返します。 .Pp 次に示す密度表は、1997 年 11 月 11 の SCSI-3 Stream Device Commands (SSC) working draft の Revision 11 における、 .Sq Historical sequential access density codes table (A-1) の情報です。 .Pp それぞれ密度の符号化方式は次の通りです。 .Pp .Dl "0x0 デバイスの既定値" .Dl "0xE ECMA 用予約値" .Bd -literal -offset 3n 値 幅 トラック 密度 コード 型 リファレンス 注 mm in bpmm bpi 0x01 12.7 (0.5) 9 32 (800) NRZI R X3.22-1983 2 0x02 12.7 (0.5) 9 63 (1,600) PE R X3.39-1986 2 0x03 12.7 (0.5) 9 246 (6,250) GCR R X3.54-1986 2 0x05 6.3 (0.25) 4/9 315 (8,000) GCR C X3.136-1986 1 0x06 12.7 (0.5) 9 126 (3,200) PE R X3.157-1987 2 0x07 6.3 (0.25) 4 252 (6,400) IMFM C X3.116-1986 1 0x08 3.81 (0.15) 4 315 (8,000) GCR CS X3.158-1987 1 0x09 12.7 (0.5) 18 1,491 (37,871) GCR C X3.180 2 0x0A 12.7 (0.5) 22 262 (6,667) MFM C X3B5/86-199 1 0x0B 6.3 (0.25) 4 63 (1,600) PE C X3.56-1986 1 0x0C 12.7 (0.5) 24 500 (12,690) GCR C HI-TC1 1,6 0x0D 12.7 (0.5) 24 999 (25,380) GCR C HI-TC2 1,6 0x0F 6.3 (0.25) 15 394 (10,000) GCR C QIC-120 1,6 0x10 6.3 (0.25) 18 394 (10,000) GCR C QIC-150 1,6 0x11 6.3 (0.25) 26 630 (16,000) GCR C QIC-320 1,6 0x12 6.3 (0.25) 30 2,034 (51,667) RLL C QIC-1350 1,6 0x13 3.81 (0.15) 1 2,400 (61,000) DDS CS X3B5/88-185A 5 0x14 8.0 (0.315) 1 1,703 (43,245) RLL CS X3.202-1991 5 0x15 8.0 (0.315) 1 1,789 (45,434) RLL CS ECMA TC17 5 0x16 12.7 (0.5) 48 394 (10,000) MFM C X3.193-1990 1 0x17 12.7 (0.5) 48 1,673 (42,500) MFM C X3B5/91-174 1 0x18 12.7 (0.5) 112 1,673 (42,500) MFM C X3B5/92-50 1 0x1C 6.3 (0.25) 34 1,654 (42,000) MFM C QIC-385M 1,6 0x1D 6.3 (0.25) 32 1,512 (38,400) GCR C QIC-410M 1,6 0x1E 6.3 (0.25) 30 1,385 (36,000) GCR C QIC-1000C 1,6 0x1F 6.3 (0.25) 30 2,666 (67,733) RLL C QIC-2100C 1,6 0x20 6.3 (0.25) 144 2,666 (67,733) RLL C QIC-6GB(M) 1,6 0x21 6.3 (0.25) 144 2,666 (67,733) RLL C QIC-20GB(C) 1,6 0x22 6.3 (0.25) 42 1,600 (40,640) GCR C QIC-2GB(C) ? 0x23 6.3 (0.25) 38 2,666 (67,733) RLL C QIC-875M ? 0x24 3.81 (0.15) 1 2,400 (61,000) CS DDS-2 5 0x25 3.81 (0.15) 1 3,816 (97,000) CS DDS-3 5 0x26 3.81 (0.15) 1 3,816 (97,000) CS DDS-4 5 0x27 8.0 (0.315) 1 3,056 (77,611) RLL CS Mammoth 5 0x28 12.7 (0.5) 36 1,491 (37,871) GCR C X3.224 1 0x29 12.7 (0.5) 0x2A 0x2B 12.7 (0.5) 3 ? ? ? C X3.267 5 .Ed .Bd -literal -offset 3n コード 意味 型 意味 ---------------- ---------------- NRZI 非 0 復帰、1 で変更 R リールトゥリール (Non Return to Zero, change on ones) C カートリッジ GCR グループ符号記録 CS カセット (Group Code Recording) PE 位相符号化 (Phase Encoded) IMFM 反転修正周波数変調 (Inverted Modified Frequency Modulation) MFM 修正周波数変調 (Modified Frequency Modulation) DDS DAT データ記憶装置 (Dat Data Storage) RLL ランレングス符号化 (Run Length Encoding) .Ed .\" 上記(訳注)は、略号の解説には訳文とその原文とを併記しておくことが .\" 理解の助けになるものと判断し、追加しました。 .\" 2.2.2-RELEASE 対象 .\" By taku@tail.net (June 16, 1997) .\" 3.0-RELEASE でも確認 by horikawa@jp.freebsd.org .Bd -literal -offset 3n 注 1. シリアル記録。 2. パラレル記録。 3. QIC-11 として知られる古い形式。 5. ヘリカルスキャン。 6. American National Standard ではありません。リファレンスは、 メディアフォーマットの工業標準の定義に基づいています。 .Ed .Sh 環境変数 次の環境変数が存在すれば、 .Nm に利用されます。 .Bl -tag -width Fl .It Ev TAPE 引数 .Ar tapename が与えられていない時、 .Nm -は +ユーティリティは .Ev TAPE 環境変数を調べます。 .El .Sh 関連ファイル .Bl -tag -width /dev/*rst[0-9]*xx -compact .It Pa /dev/*rwt* QIC-02/QIC-36 磁気テープインタフェース .It Pa /dev/*rsa[0-9]* SCSI 磁気テープインタフェース .El .Sh 関連項目 .Xr dd 1 , .Xr ioctl 2 , .Xr mtio 4 , .Xr sa 4 , .Xr wt 4 , .Xr environ 7 .Sh 歴史 .Nm コマンドは .Bx 4.3 で登場しました。 .Pp .Xr st 4 ドライバに関する拡張部分は .Xr st 1 コマンドとは別のものとして .Bx 386 0.1 で登場し、 .Nm コマンドに .Fx 2.1 で含められました。 .Pp .Cm weof と同義のコマンドであった .Cm eof コマンドは .Fx 2.1 で破棄されました。 なぜなら、しばしば .Cm eom との混乱があり、非常に危険だったためです。 diff --git a/ja_JP.eucJP/man/man1/ncal.1 b/ja_JP.eucJP/man/man1/ncal.1 index 605f8d2ef4..6b6e74d11e 100644 --- a/ja_JP.eucJP/man/man1/ncal.1 +++ b/ja_JP.eucJP/man/man1/ncal.1 @@ -1,123 +1,123 @@ .\" 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. .\" -.\" %FreeBSD: src/usr.bin/ncal/ncal.1,v 1.8.2.4 2001/07/22 11:02:19 dd Exp % +.\" %FreeBSD: src/usr.bin/ncal/ncal.1,v 1.8.2.5 2002/06/21 15:28:26 charnier Exp % .\" $FreeBSD$ .\". .Dd December 16, 1997 .Dt CAL 1 .Os .Sh 名称 .Nm cal , .Nm ncal .Nd カレンダおよびイースターの日付を表示する .Sh 書式 .Nm .Op Fl jy .Oo .Op Ar month .Ar year .Oc .Nm ncal .Op Fl jJpwy .Op Fl s Ar country_code .Oo .Op Ar month .Ar year .Oc .Nm ncal .Op Fl Jeo .Op Ar year .Sh 解説 .Nm -は簡単なカレンダを表示します。 +ユーティリティは簡単なカレンダを表示します。 また .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 日から始まります。 .Sh 関連項目 .Xr calendar 3 , .Xr strftime 3 .Sh 歴史 .Nm コマンドは .At v6 から登場しました。 .Nm ncal は .Fx 2.2.6 に登場しました。 .Sh 作者 .Nm ncal コマンドとマニュアルは .An Wolfgang Helbig Aq helbig@FreeBSD.ORG が作成しました。 .Sh バグ ユリウス暦からグレゴリオ暦に移行した日付とカントリーコードの対応は、 多くの国について不適当です。 diff --git a/ja_JP.eucJP/man/man1/ncplogin.1 b/ja_JP.eucJP/man/man1/ncplogin.1 index b929321725..91f3b6792f 100644 --- a/ja_JP.eucJP/man/man1/ncplogin.1 +++ b/ja_JP.eucJP/man/man1/ncplogin.1 @@ -1,222 +1,222 @@ -.\" %FreeBSD: src/usr.bin/ncplogin/ncplogin.1,v 1.4.2.7 2001/07/22 12:40:27 dd Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ncplogin.1,v 1.9 2001/07/29 05:14:51 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/ncplogin/ncplogin.1,v 1.4.2.8 2002/06/21 15:28:29 charnier Exp % +.\" $FreeBSD$ .Dd September 15, 1999 .Dt NCPLOGIN 1 .Os .Sh 名称 .Nm ncplogin .Nd NetWare サーバへの持続的なコネクションを生成する .Sh 書式 .Nm .Op Fl BCDN .Op Fl S Ar server .Op Fl U Ar user .Op Fl A Ar host .Op Fl I Ar level .Op Fl M Ar mode .Oo .Fl O Xo .Op Ar owner Ns .Op : Ns Ar group .Xc .Oc .Op Fl R Ar retrycount .Op Fl T Ar tree .Op Fl W Ar timeout .Nm .Op Fl BCDN .Op Fl A Ar host .Op Fl I Ar level .Op Fl M Ar mode .Oo .Fl O Xo .Op Ar owner Ns .Op : Ns Ar group .Xc .Oc .Op Fl R Ar retrycount .Op Fl T Ar tree .Op Fl W Ar timeout .No / Ns Ar server Ns : Ns Ar user .Sh 解説 .Tn NetWare サーバへのコネクションは、 .Xr mount_nwfs 8 とは独立に、作成および使用可能です。 .\" revision 1.5 からは independently of mount_nwfs(8) になっている .\" horikawa@jp.FreeBSD.org 2000/04/11 コネクションはどのユーザ にも作成することができます。それぞれのユーザは複数のコネクションを持つ ことができますが、NetWare サーバ : NetWare ユーザの組は一意である必要 があります。 .Pp .Nm コマンドは .Tn NetWare サーバとの持続的なコネクションを作成します。持続的な コネクションは、それを使用するアプリケーションがなくなっても残ります。 これによってユーザは ncp* プログラムをファイルサーバやユーザ名を指定せずに 使用することができるようになります。コネクションは .Xr ncplogout 1 コマンドによって解除されます。 .Pp このマニュアルで解説している大文字のオプションは他の ncp* プログラムと共通で、 .Qq connection options として参照されます。 .Fl U 及び .Fl S オプションは、 .No / Ns Ar server Ns : Ns Ar user という書式と排他的に作用します。 .Pp オプションは以下の通りです。 .Bl -tag -width indent .It Fl S Ar server 接続する .Tn NetWare サーバ名を指定します。これは .Tn IPX サーバにのみ有効です。 ネイティブ .Tn IP サーバについては .Fl A オプションを参照してください。 .It Fl U Ar user ログイン手続きで使用するユーザ名を指定します。 .It Fl A Ar host .Ar host 引数で指定した .Tn NetWare 5.x サーバへの接続に .Tn UDP プロトコルを用います。 .It Fl C パスワードを大文字に変換しません。 .It Fl D コネクションをプライマリとしてマークします。既に作成されているコネクションに 変更を加えることができます。 .Nm プログラムだけがこのオプションを理解します。 .It Fl I Ar signature_level .Ar signature_level を使用しようとします。 使用可能な値は次の通りです: .Bd -literal -offset indent 値 意味 0 署名を禁止します 1 有効化します (サーバが要求すれば署名を許可します) 2 サーバに署名を要求しますが、署名なしでも動作することを許可します 3 署名を要求します .Ed .Pp パケットヘッダへの署名だけが実装されていることに注意してください。 .It Fl M Ar mode コネクションもユーザ間で共有されます。その際に、 .Ar mode 引数のビットがファイルのパーミッションのようにふるまいます。 .Bd -literal -offset indent マスク 意味 4 READ - コネクションを見ることができます。 2 WRITE - コネクションを閉じたり、変更することができます。 1 EXECUTE - ユーザはリクエストを実行することができます。 .Ed デフォルトではコネクションは .Ar mode 0700 で作成され、 所有者のみがそれを任意に使用することができます。 .Fl M オプションに 0750 を指定すると、 グループに対する読み込み専用アクセスを許可します。 これは、グループに対し、NCP リクエストを許可しますが、 接続解除は許可しません。 ユーザが使用するサーバを明確に指定しなかった場合、ncp* プログラムは次の手順 で適切なコネクションを探します。 .Bl -enum -offset indent .It ユーザが所有しているコネクションを探します。 それが複数あればどれがプライマリであるかを探します。プライマリフラグは .Fl D オプションで制御できます。 .Pp .It 見つからなかった場合は、最初の共有コネクションが使用されます。 .El .It Fl N パスワードを要求しません。 実行時に .Nm は .Pa ~/.nwfsrc ファイルから設定の追加とパスワードを読み込みます。 もし指定された .Ar server Ns : Ns Ar user のパスワードが存在しなければ、 .Nm はそれを要求するプロンプトを表示します。 .It Fl O コネクションに対する .Ar owner と .Ar group の属性を指定します。新しく作成されたコネクションでは .Ar owner 属性に作成者のユーザ ID が、 .Ar group 属性に作成者のプライマリグループが使用されます。 この動作はこのオプションによって変更することができます。 .Ar owner を変更できるのはスーパユーザだけです。 .It Fl P 接続を持続的なものとしてマークします。 .Nm -は常に持続的なコネクションを作成します。このオプションは他の ncp* プログラム -で使用可能です。 +ユーティリティは常に持続的なコネクションを作成します。 +このオプションは他の ncp* プログラムで使用可能です。 .It Fl R Ar retry_count 接続をあきらめる前の再試行回数を指定します。既定値は 10 です。 .Pp 注: コネクションが .Sq BAD とマークされたあとは、リクエスト毎にそれを回復 しようと試みます。このプロセスは .Tn NCP コネクションだけを回復しようとしますが、 .Sq BAD とマークされたときに オープンされていたファイルを再オープンしようとはしません。 .It Fl W Ar timeout サーバへのリクエスト時のタイムアウト時間を秒単位で指定します。 既定値は 5 秒です。 .It / Ns Ar server Ns : Ns Ar user この文法は単純な操作のために提供されており、 .Fl S 及び .Fl U オプションと排他的に作用します。 .El .Sh 実装に関する注 低レベルの接続管理は .Pa ncp.ko モジュールで実現されます。 .Tn IPX サポートのためには、さらに .Xr IPXrouted 8 プログラムを読み込む必要があります。 .Sh 関連ファイル .Bl -tag -width /var/log/wtmp -compact .It Pa ~/.nwfsrc はコネクションやその他の情報に関して静的なパラメータを保持します。詳細は .Pa /usr/share/examples/nwclient/dot.nwfsrc を参照してください。 .El .Sh 歴史 .Nm が最初に登場したのは .Fx 4.0 です。 .Sh 作者 .An Boris Popov Aq bp@butya.kz , .Aq rbp@chat.ru .Sh バグ バグは作者に報告してください。 diff --git a/ja_JP.eucJP/man/man1/ncplogout.1 b/ja_JP.eucJP/man/man1/ncplogout.1 index fdc2cdb288..3e3cc309f2 100644 --- a/ja_JP.eucJP/man/man1/ncplogout.1 +++ b/ja_JP.eucJP/man/man1/ncplogout.1 @@ -1,55 +1,55 @@ -.\" %FreeBSD: src/usr.bin/ncplogin/ncplogout.1,v 1.3.2.5 2001/07/22 12:40:27 dd Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ncplogout.1,v 1.5 2001/05/14 01:07:26 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/ncplogin/ncplogout.1,v 1.3.2.6 2002/06/21 15:28:29 charnier Exp % +.\" $FreeBSD$ .Dd September 15, 1999 .Dt NCPLOGOUT 1 .Os .Sh 名称 .Nm ncplogout .Nd 持続的なコネクションを閉じるようスケジュールする .Sh 書式 .Nm .Op -S Ar server .Op -U Ar user .Op -c Ar handle .Nm .Op -c Ar handle .No / Ns Ar server Ns : Ns Ar user .Sh 解説 .Nm -は +ユーティリティは .Xr ncplogin 1 によって生成されたコネクションを閉じるようスケジュールします。 もしそのコネクションが他のプロセス で使用中であるなどの理由によりビジー状態であれば、 使用中の最後のプロセスが終了した時点で閉じられます。 このコマンドは .Tn DOS の logout.exe コマンドと同等です。 .Pp オプションは以下の通りです。 .Bl -tag -width indent .It Fl S Ar server コネクションを識別する .Tn NetWare サーバの名称を指定します。 アクティブなコネクションがひとつしかない場合は省略できます。 .It Fl U Ar user コネクションを識別するユーザ名です。 アクティブなコネクションがひとつしかない場合は省略できます。 .It Fl c Ar handle ハンドルでコネクションを閉じます。 使用可能なハンドルのリストは次のコマンドで得られます: .Bd -literal -offset indent ncplist c .Ed .El .Sh 歴史 .Nm ユーティリティが最初に登場したのは .Fx 4.0 です。 .Sh 作者 .An Boris Popov Aq bp@butya.kz , .Aq bp@FreeBSD.org .Sh バグ バグは作者に報告してください。 diff --git a/ja_JP.eucJP/man/man1/nice.1 b/ja_JP.eucJP/man/man1/nice.1 index 9a0e5018d6..89b9758648 100644 --- a/ja_JP.eucJP/man/man1/nice.1 +++ b/ja_JP.eucJP/man/man1/nice.1 @@ -1,106 +1,124 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)nice.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/nice/nice.1,v 1.12.2.5 2001/08/16 13:16:59 ru Exp % +.\" %FreeBSD: src/usr.bin/nice/nice.1,v 1.12.2.6 2002/06/18 08:40:28 tjr Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/nice.1,v 1.11 2001/07/29 05:14:51 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt NICE 1 .Os .Sh 名称 .Nm nice -.Nd スケジュールの優先度を下げてコマンドを実行する +.Nd スケジュールの優先度を下げてユーティリティを実行する .Sh 書式 .Nm nice -.Op Fl Ns Ar number -.Ar command -.Op Ar arguments +.Op Fl n Ar increment +.Ar utility +.Op Ar argument ... .Sh 解説 .Nm -はスケジュールの優先度を低くして -.Ar command -を実行します (優先度を低くすると実行速度が遅くなると考えてください)。 -もし -.Fl Ns Ar number -が指定されない場合、 -.Nm -は値を 10 であるとします。 -優先度は -20 から 20 までの値です。 -デフォルトの優先度は 0 であり、優先度 20 がもっとも低いです。 +ユーティリティは優先度を変更して +.Ar utility +を実行します。 +.Dq nice +値は指定された +.Ar increment +だけ増やされるか、またはデフォルト値の 10 が増されます。 +プロセスの nice 値を減らすと、スケジュール優先度が向上します。 +.Pp +ユーティリティを高スケジュール優先度で実行する目的で、 +スーパユーザは負の増加値を指定可能です。 +.Pp .Nm は、 .Ar command の実行優先度として、 .Ar number が .Nm の優先度に対して相対的に指定されたものとします。 現在のプロセスの優先度よりも高い優先度はスーパユーザのみ要求可能です。 -負の数を指定する場合には -.Fl - Ns Ar number -とします。 -.Pp -終了ステータスは -.Nm -が実行したコマンドの終了ステータスです。 .Pp シェルによっては、本ユーティリティと似たまたは同じ、組み込みの .Nm コマンドを提供しているものがあります。 .Xr builtin 1 マニュアルページを参照してください。 .Sh 使用例 -$ nice -5 date +$ nice -n 5 date .Pp -シェルの優先度が 0 の時、コマンド +シェルの優先度が 0 の時、ユーティリティ .Sq date を、優先度 5 にて実行します。 .Pp -# nice -16 nice --35 date +# nice -n 16 nice -n -35 date .Pp -シェルの優先度が 0 であり、スーパユーザの場合、コマンド +シェルの優先度が 0 であり、スーパユーザの場合、ユーティリティ .Sq date を優先度 -19 にて実行します。 +.Sh 診断 +.Ar utility +が起動されると、 +.Nm +の終了ステータスは +.Ar utility +の終了ステータスになります。 +.Pp +終了ステータス 126 は +.Ar utility +が見付かったものの実行不可だったことを示します。 +終了ステータス 127 は +.Ar utility +が見付からなかったことを示します。 .Sh 関連項目 .Xr builtin 1 , .Xr csh 1 , .Xr idprio 1 , .Xr rtprio 1 , .Xr getpriority 2 , .Xr setpriority 2 , .Xr renice 8 +.Sh 互換性 +伝統的な +.Fl Ns Ar increment +オプションは価値が低下していますが、まだサポートされています。 +.Sh 規格 +.Nm +ユーティリティは +.St -p1003.1-2001 +に適合しています。 .Sh 歴史 .Nm -は +ユーティリティは .At v6 で追加されました。 diff --git a/ja_JP.eucJP/man/man1/objformat.1 b/ja_JP.eucJP/man/man1/objformat.1 index 60df2e3492..f7bef969b4 100644 --- a/ja_JP.eucJP/man/man1/objformat.1 +++ b/ja_JP.eucJP/man/man1/objformat.1 @@ -1,104 +1,104 @@ .\" .\" Copyright (c) 1998 David E. O'Brien .\" .\" 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. .\" -.\" %FreeBSD: src/usr.bin/objformat/objformat.1,v 1.3.2.3 2001/07/22 12:40:29 dd Exp % +.\" %FreeBSD: src/usr.bin/objformat/objformat.1,v 1.3.2.4 2002/06/21 15:28:32 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/objformat.1,v 1.7 2001/05/14 01:07:26 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd October 25, 1998 .Os .Dt OBJFORMAT 1 .Sh 名称 .Nm objformat .Nd デフォルトのバイナリ形式を報告し、その形式用プログラムを実行する .Sh 書式 .Nm .Nm prog .Sh 解説 .Nm として実行された時には、デフォルトのオブジェクトファイル形式を報告しま す。オブジェクトファイル形式は、 .Ar aout と .Ar elf の 2 種類です。 .Pp 他の名称で実行された時には、 .Nm prog は .Pa /usr/libexec//prog と展開されて、起動されます。 .Sh 診断 引数の数が不適切であったり、 .Nm prog を起動できなかった場合には、 .Nm ユーティリティは終了コード 1 を返し終了します。 .Sh 環境変数 .Bl -tag -width OBJFORMAT_PATH .It Ev OBJFORMAT 環境変数 .Ev OBJFORMAT が設定されている場合には、デフォルトのオブジェクト形式に優先します。 .Ev OBJFORMAT は .Pa /etc/objformat よりも優先されます。 .It Ev OBJFORMAT_PATH 環境変数 .Ev OBJFORMAT_PATH が設定されている場合には、その値が .Nm prog へのパスのベースとして使われます。デフォルトでは、 .Pa /usr/libexec です。 .El .Sh 関連ファイル .Bl -tag -width /etc/objformat -compact .It Pa /etc/objformat このファイルは、使用するオブジェクトファイル形式を 指定します。書式は、 .Ql OBJFORMAT=xxx です。 .El .Sh 関連項目 .Xr file 1 , .Xr getobjformat 3 .\" .Sh STANDARDS .Sh 歴史 .Nm は .Fx 3.0 から登場しました。 .Sh 作者 .An -nosplit .Nm -は、 +ユーティリティは、 .An Peter Wemm Aq peter@netplex.com.au によって書かれました。 このマニュアルページは、 .An David O'Brien Aq obrien@NUXI.com によって書かれました。 .\" .Sh BUGS diff --git a/ja_JP.eucJP/man/man1/od.1 b/ja_JP.eucJP/man/man1/od.1 index a767da8147..c34c2e7fc7 100644 --- a/ja_JP.eucJP/man/man1/od.1 +++ b/ja_JP.eucJP/man/man1/od.1 @@ -1,85 +1,85 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)od.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/hexdump/od.1,v 1.8.2.2 2000/12/27 17:01:48 ru Exp % +.\" %FreeBSD: src/usr.bin/hexdump/od.1,v 1.8.2.3 2002/06/21 15:27:11 charnier Exp % .\" $FreeBSD$ .\" .Dd May 27, 1994 .Os .Dt OD 1 .Sh 名称 .Nm od .Nd 8進, 10進, 16進, ASCIIでのダンプ .Sh 書式 .Nm .Op Fl aBbcDdeFfHhIiLlOovXx .Sm off .Oo .Op Cm \&+ .Li offset .Op Cm \&. .Op Cm Bb .Oc .Sm on .Ar file .Sh 解説 .Nm -は +ユーティリティは .Xr hexdump 1 に取って代わられています。 .Pp -.Xr hexdump -は +.Nm hexdump +ユーティリティは .Nm という名前で起動された場合、上記の .Nm のオプションと互換の動作をします。 .Pp .Fl s オプション ( .Xr strings 1 を参照) および .Fl P , .Fl p , .Fl w オプションに対応する互換性は提供されていません。 また offset 使用時の ``label'' に対応する互換性も提供されていません。 .Sh 関連項目 .Xr hexdump 1 , .Xr strings 1 .Sh バグ たくさんあります。 .Sh 歴史 .Nm コマンドは .At v1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/pagesize.1 b/ja_JP.eucJP/man/man1/pagesize.1 index 917bdcc976..0aa6dec92c 100644 --- a/ja_JP.eucJP/man/man1/pagesize.1 +++ b/ja_JP.eucJP/man/man1/pagesize.1 @@ -1,56 +1,56 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)pagesize.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/pagesize/pagesize.1,v 1.4.2.2 2001/08/16 13:16:59 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/pagesize.1,v 1.4 2001/05/14 01:07:26 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/pagesize/pagesize.1,v 1.4.2.3 2002/06/21 15:28:34 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt PAGESIZE 1 .Os .Sh 名称 .Nm pagesize .Nd システムのページサイズを表示する .Sh 書式 .Nm .Sh 解説 .Nm -は +ユーティリティは .Xr getpagesize 3 で得られるメモリのページサイズをバイト単位で表示します。 このプログラムは移植性のあるシェルスクリプトを作成する際に有用です。 .Sh 関連項目 .Xr getpagesize 3 .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/passwd.1 b/ja_JP.eucJP/man/man1/passwd.1 index 8d560b75f6..9447c1a0bf 100644 --- a/ja_JP.eucJP/man/man1/passwd.1 +++ b/ja_JP.eucJP/man/man1/passwd.1 @@ -1,235 +1,235 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)passwd.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/passwd/passwd.1,v 1.18.2.4 2001/08/16 13:17:00 ru Exp % +.\" %FreeBSD: src/usr.bin/passwd/passwd.1,v 1.18.2.5 2002/06/21 15:28:37 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/passwd.1,v 1.18 2001/08/17 06:18:09 horikawa Exp $ +.\" $FreeBSD$ .Dd June 6, 1993 .Dt PASSWD 1 .Os .Sh 名称 .Nm passwd , yppasswd .Nd ユーザのパスワードを変更する .Sh 書式 .Nm .Op Fl l .Op Ar user .Nm yppasswd .Op Fl l .Op Fl y .Op Fl d Ar domain .Op Fl h Ar host .Op Fl o .Sh 解説 .Nm -は、ユーザの local, Kerberos, NIS パスワードを変更します。 +ユーティリティは、ユーザの local, Kerberos, NIS パスワードを変更します。 ユーザがスーパユーザでない場合、 .Nm は最初に現在のパスワードを求め、 正しいパスワードが入力されない場合には処理を停止します。 .Pp 新規パスワード入力時、パスワードは表示されません。 通りがかりの人にパスワードを見られることを避けるためです。 .Nm -は、タイプミスを検出するため、2 度新規パスワード入力を求めます。 +ユーティリティは、タイプミスを検出するため、2 度新規パスワード入力を求めます。 .Pp 新しいパスワードは、少なくとも 6 文字以上 (ユーザのログインクラスに対する .Xr login.conf 5 の .Dq minpasswordlen 設定が優先します) で、アルファベットだけにならな いようにすべきです。パスワードの最大文字数は、 .Dv _PASSWORD_LEN (現在は 128 文字) より短いことが必要です。 .Pp 新規パスワードは大文字と小文字を混合して含む必要があります (ユーザのログインクラスに対して .Xr login.conf 5 の .Dq mixpasswordcase の設定を使用することで、上書き可能です)。 小文字だけのパスワードのみ許可可能な場合に、 小文字パスワードを許すと有用でしょう。 例えば Windows クライアントを認証するために Samba を使用する場合が、 該当します。 他のすべての場合、数字、大文字、メタ文字が推奨されます。 .Pp 新しいパスワードが確認されたら .Nm は新しいパスワードを Kerberos 認証ホストに伝えます。 .Bl -tag -width flag .It Fl l Kerberosデータベースではなく、 ローカルマシンのパスワードだけを変更します。 ローカルマシンのパスワードだけを変更する場合は、 .Xr pwd_mkdb 8 がパスワードデータベースの更新に使われます。 .Pp .El ローカルまたは NIS パスワードを変更する場合、 ユーザのログインクラスの .Dq passwordtime ケーパビリティに基づき、 次にパスワードを変更すべき日付が設定されます。 .Pp 別のユーザの Kerberos パスワードを変更するには、 .Xr kinit 1 を実行してから、 .Xr passwd 1 を実行する必要があります。 スーパユーザがローカルマシンのパスワードを修正するときにかぎり、現在の パスワードの入力は不要です。 .Sh NIS との相互作用 .Nm -は NIS のサポートが組み込まれています。 +ユーティリティは NIS のサポートが組み込まれています。 もしユーザ名が NIS のパスワードデータベースの中にあり、 ローカルにはない場合、 .Nm は自動的に .Dq yppasswd に切り替わります。 指定されたユーザ名がローカルのパスワードデータベースにも、 NIS のパスワードマップにも存在しない場合、 .Nm はエラーを返します。 .Pp NIS のパスワードを変更するとき、非特権ユーザは 確認のために現在のパスワードの入力を求められます ( .Xr rpc.yppasswdd 8 デーモンはいかなる変更でも NIS パスワードマップに加える前に 現在のパスワードの入力を求めます)。 この制限はスーパユーザにも適用されますが、大きな例外があります。 NIS マスタサーバのスーパユーザはパスワードの確認が省略されるの です。 したがって、NIS マスタサーバのスーパユーザは、すべてのユーザの NIS パスワードを無制限に変更できます。 しかし、NIS クライアントや NIS スレーブサーバのスーパユーザは 変更にパスワードが必要です。 .Pp 以下のオプションは NIS のためのものです: .Bl -tag -width flag .It Fl y .Nm は強制的に NIS 用になります。 .It Fl l NIS が有効な場合に .Nm を強制的にローカル用にします。 このフラグは同じログイン名で NIS のユーザと ローカルなユーザが存在するときに、 .Dq ローカルユーザの パスワードエントリを変更するために使われます。 例えば、システム用の .Pa bin や .Pa daemon といった .Dq 場所取り エントリは NIS パスワードマップとローカルユーザデータベース の両方に存在することが、よくあります。 この場合デフォルトでは .Nm は NIS のパスワードを変更しようとします。 NIS ではなくローカルのパスワードを変更するとき .Fl l を使います。 .It Fl d Ar domain NIS パスワードを変更するとき、ドメイン名を指定します。デフォルトで .Nm は、システムのデフォルトドメイン名を使います。このフラグは主に NIS マスタサーバのスーパユーザが使用するものです。一つの NIS マスタサーバが複数のドメインを扱っている場合や、NIS マスタサーバでは ドメイン名が設定されていない (NIS サーバは必ずしもクライアントになる 必要はありません) 場合に、 .Nm コマンドがどのドメインを扱うのかを指定する必要があります。 .It Fl h Ar host NIS サーバの名前を指定します。このオプションを .Fl d オプションと共に用いることで、非ローカルな NIS サーバ上の NIS パスワードを変えることが出来ます。 .Fl d オプションでドメイン名を指定し、 NIS マスタサーバの名前が決定できな い (おそらく、ローカルのドメイン名が設定されていないため) ときには、 NIS マスタサーバは、 .Dq localhost であると仮定されます。 このサーバ名を .Fl h で指定することが出来ます。指定するホスト名は NIS マスタサーバ でなくても構いません。 NIS マスターサーバー名はドメイン内の NIS (マスタもしくはスレーブ) サーバに問い合わせることで決定される ので、スレーブサーバを指定しても構いません。 .Pp .It Fl o NIS マスタサーバにおいて、スーパユーザの確認を省略しません。 \'old' モードにします。このフラグはあまり実用的ではありませんが、 パスワードのテストに使うことが出来ます。 .El .Sh 関連ファイル .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/master.passwd パスワードのマスタファイル .It Pa /etc/passwd Version 7 形式のパスワードファイル .It Pa /etc/passwd.XXXXXX パスワード変更時に作られるテンポラリファイル .It Pa /etc/login.conf ログインクラスケーパビリティデータベース .It Pa /etc/auth.conf 認証サービスの設定 .El .Sh 関連項目 .Xr chpass 1 , .Xr kerberos 1 , .Xr kinit 1 , .Xr login 1 , .Xr login.conf 5 , .Xr passwd 5 , .Xr kpasswdd 8 , .Xr pwd_mkdb 8 , .Xr vipw 8 .Rs .%A Robert Morris .%A Ken Thompson .%T "UNIX password security" .Re .Sh 注 .Xr yppasswd 1 は実際には .Nm へのリンクです。 .Sh 歴史 .Nm passwd コマンドは .At v6 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/pax.1 b/ja_JP.eucJP/man/man1/pax.1 index f7f33d87f0..472e885c16 100644 --- a/ja_JP.eucJP/man/man1/pax.1 +++ b/ja_JP.eucJP/man/man1/pax.1 @@ -1,1194 +1,1188 @@ .\" Copyright (c) 1992 Keith Muller. .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Keith Muller of the University of California, San Diego. .\" .\" 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. .\" .\" @(#)pax.1 8.4 (Berkeley) 4/18/94 -.\" %FreeBSD: src/bin/pax/pax.1,v 1.12.2.7 2001/08/16 10:01:06 ru Exp % +.\" %FreeBSD: src/bin/pax/pax.1,v 1.12.2.8 2002/06/20 22:43:28 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt PAX 1 .Os .Sh 名称 .Nm pax .Nd ファイルアーカイブの読み書きやディレクトリ階層のコピーを行う .Sh 書式 .Nm .Op Fl cdnvz .Bk -words .Op Fl f Ar archive .Ek .Bk -words .Op Fl s Ar replstr .Ar ...\& .Ek .Bk -words .Op Fl U Ar user .Ar ...\& .Ek .Bk -words .Op Fl G Ar group .Ar ...\& .Ek .Bk -words .Oo .Fl T .Op Ar from_date .Op Ar ,to_date .Oc .Ar ...\& .Ek .Op Ar pattern ...\& .Nm .Fl r .Op Fl cdiknuvzDYZ .Bk -words .Op Fl f Ar archive .Ek .Bk -words .Op Fl o Ar options .Ar ...\& .Ek .Bk -words .Op Fl p Ar string .Ar ...\& .Ek .Bk -words .Op Fl s Ar replstr .Ar ...\& .Ek .Op Fl E Ar limit .Bk -words .Op Fl U Ar user .Ar ...\& .Ek .Bk -words .Op Fl G Ar group .Ar ...\& .Ek .Bk -words .Oo .Fl T .Op Ar from_date .Op Ar ,to_date .Oc .Ar ...\& .Ek .Op Ar pattern ...\& .Nm .Fl w .Op Fl dituvzHLPX .Bk -words .Op Fl b Ar blocksize .Ek .Oo .Op Fl a .Op Fl f Ar archive .Oc .Bk -words .Op Fl x Ar format .Ek .Bk -words .Op Fl s Ar replstr .Ar ...\& .Ek .Bk -words .Op Fl o Ar options .Ar ...\& .Ek .Bk -words .Op Fl U Ar user .Ar ...\& .Ek .Bk -words .Op Fl G Ar group .Ar ...\& .Ek .Bk -words .Op Fl B Ar bytes .Ek .Bk -words .Oo .Fl T .Op Ar from_date .Op Ar ,to_date .Op Ar /[c][m] .Oc .Ar ...\& .Ek .Op Ar .Nm .Fl r .Fl w .Op Fl diklntuvDHLPXYZ .Bk -words .Op Fl p Ar string .Ar ...\& .Ek .Bk -words .Op Fl s Ar replstr .Ar ...\& .Ek .Bk -words .Op Fl U Ar user .Ar ...\& .Ek .Bk -words .Op Fl G Ar group .Ar ...\& .Ek .Bk -words .Oo .Fl T .Op Ar from_date .Op Ar ,to_date .Op Ar /[c][m] .Oc .Ar ...\& .Ek .Op Ar .Ar directory .Sh 解説 .Nm -は、アーカイブファイルの読み込み、書きだし、アーカイブファイルに +ユーティリティは、 +アーカイブファイルの読み込み、書きだし、アーカイブファイルに 格納されているファイルの一覧読みだし、そしてディレクトリ階層のコピーを 行います。 .Nm の操作は指定したアーカイブフォーマットとは独立しており、また .Nm は広範囲に渡る種類のアーカイブフォーマットの操作をサポートします。 .Nm のサポートするアーカイブフォーマット一覧は、 .Fl x オプションの説明時に示します。 .Pp .Fl r および .Fl w は、以下の .Nm の機能モードのいずれかを指定するのに用いられます。その機能モードとは、 .Em 一覧表示モード、読み込みモード、書き込みモード、コピーモード の 4 つです。 .Bl -tag -width 6n .It .Em 一覧表示モードです。 -.Nm -は、 .Dv 標準入力 から読み込まれたアーカイブ内の格納ファイルのリストを .Dv 標準出力 へ書き出します。標準入力から読み込まれるファイルのパス名は、指定した .Ar pattern に一致するものが採用されます。 ファイル一覧は 1 行に 1 つのファイル名を含み、1 行バッファリングを行って 書き出されます。 .It Fl r .Em 読み込みモードです。 -.Nm -は、 .Dv 標準入力 からアーカイブを読み込み、その内に格納されたファイルのうち指定した .Ar pattern に一致するファイル名を持つファイルを展開します。 アーカイブフォーマット及びブロック化係数は、自動的に入力から決定されます。 展開されるファイルがディレクトリの場合、そのディレクトリ配下に連なる ファイル階層は完全な形で展開されます。 展開される全てのファイルは、現在のファイル階層からの相対ディレクトリに 生成されます。展開されるファイルの所有権、アクセス時刻、更新時刻、 そしてファイルモードの設定についての詳細は、 .Fl p オプションのところで述べます。 .It Fl w .Em 書き込みモードです。 -.Nm -は、 .Ar file オペランドで指定したファイル群のアーカイブを 指定したフォーマットで標準出力に書き出します。 .Ar file オペランドが指定されない場合には、1 行に 1 つずつ コピーするファイルを記述したリストを標準入力から読み込みます。 .Ar file オペランドがディレクトリの場合、そのディレクトリ配下の 全ファイルが作成されるアーカイブに含まれます。 .It Fl r Fl w .Em コピーモードです。 -.Nm -は、ファイルオペランドで指定したファイル群を、指定した +ファイルオペランドで指定したファイル群を、指定した .Ar ディレクトリ にコピーします。 .Ar file オペランドが指定されない場合には、1 行に 1 つずつ コピーするファイルを記述したリストを標準入力から読み込みます。 .Ar file オペランドがディレクトリの場合、そのディレクトリ配下のファイルがすべて、 コピー先として指定したディレクトリ配下に作成されます。 .Em コピーモード では、ファイルがアーカイブファイルに対して書き込まれ、 そして一方でそのアーカイブファイルが展開されるかのように見えます。 ただし、これはオリジナルファイルとコピーファイルの間に ハードリンクが張られるかも知れない事を除きます .Ns ( Fl l オプションを参照して下さい)。 .Pp .Em 注意 : コピー先の .Ar ディレクトリ には、コピー元にあるものと同じファイル名の .Ar file オペランドや .Ar file オペランドで指定されるディレクトリ階層の配下にあるファイル名などを 指定してはいけません。 そのような場合、 .Em コピー の結果は予測できないものになります。 .El .Pp .Em 読み込み 操作や .Em 一覧表示 動作において壊れたアーカイブを処理する場合、 .Nm は媒体破損を可能な限り復旧し、 アーカイブの中から可能な限りのファイルを処理しようと試みます (エラー時の 処理の詳細は .Fl E オプションを参照して下さい)。 .Sh オペランド .Ar directory オペランドは、コピー先ディレクトリの指定を行います。 .Ar directory オペランドが存在しない場合、もしくはユーザが書き込みを出来ない、 もしくは指定したオペランドがディレクトリでない場合には、 .Nm は、0 以外のステータスでプログラムを終了します。 .Pp .Ar pattern オペランドは、アーカイブに格納されているファイルの名前を選択するために 用いられます。 アーカイブメンバは、 .Xr fnmatch 3 に記述のある表記に一致するパターンを用いて選択されます。 .Ar pattern オペランドが指定されない場合には、アーカイブ内に格納されている 全てのメンバが選択されます。 .Ar pattern がディレクトリ名と一致する場合には、そのディレクトリ配下の階層に 位置する全てのファイルが選択されます。 もしアーカイブ内に .Ar pattern オペランドの指定と一致する名前のファイルがない場合には、 .Nm は .Ar 標準エラー出力 に出力される診断メッセージにこの .Ar pattern オペランドを書き出し、0 以外のステータスでプログラムを終了します。 .Pp .Ar file オペランドは、コピーもしくはアーカイブされるファイルのパス名を指定します。 .Ar file オペランドが 1 つもアーカイブメンバを選択しない場合には、 .Nm は .Dv 標準エラー出力 に出力される診断メッセージにこの .Ar file オペランドの内容を書き出し、0 以外のステータスでプログラムを終了します。 .Sh オプション .Nm では、以下のオプションが使用可能です。 .Bl -tag -width 4n .It Fl r アーカイブファイルを .Dv 標準入力 から読み込み、 .Ar files で指定したファイルを展開します。 アーカイブされているファイルの展開に中間ディレクトリの作成が必要な場合、 これらのディレクトリは、 .Xr mkdir 2 の mode 引数のところに .Dv S_IRWXU , S_IRWXG , S_IRWXO の .Dv 論理和 を指定して呼び出された場合と同様に作成されます。 選択されたアーカイブ形式がリンクファイルの指定をサポートし、 かつアーカイブ展開時にリンク不可能である場合には、 .Nm は、処理が終了する時に、診断メッセージを .Dv 標準エラー出力 に書き出し、0 以外のステータスで終了します。 .It Fl w 指定したアーカイブフォーマットで、 .Dv 標準出力 にアーカイブを書き出します。 .Ar file オペランドが指定されない場合には、1 行につき展開するファイルのパス名 1 つを 記述したリストを .Dv 標準入力 から読み込みます。 このリストの各行の先頭や末尾には .Aq 空白 を入れてはいけません。 .It Fl a すでに存在するアーカイブファイルの後ろに、ファイル .Ar files を追加書き込みします。 .Fl x オプションによるアーカイブフォーマット指定がされない場合、 アーカイブフォーマットは追加書き込み対象となるアーカイブファイルの フォーマットと同一になります。 アーカイブファイルに対して、そのアーカイブファイルのフォーマットと 異なるフォーマットを用いてファイルを追加書き込みをしようとした場合、 .Nm は即時に 0 以外の終了ステータスでプログラム終了します。 アーカイブボリュームに最初に書き込んだブロックサイズを引き継いで、 残りのアーカイブボリュームのブロックサイズとします。 .Pp .Em 注意 : 多くの記憶装置は追加書き込み処理に必要な操作をサポートできません。 そのようなサポートしていないデバイスに対するアーカイブの追加書き込みは、 アーカイブの破損もしくは他の予期せぬ結果を招くことになります。 特に、テープドライブに対する追加書き込み処理は、最もサポートしそうにない ものです。 普通のファイルシステムのファイルとして、もしくはディスクデバイス上に 保存されているアーカイブについては、通常は追加書き込み処理をサポートします。 .It Fl b Ar blocksize アーカイブを .Em 書き出す 際、アーカイブへと書き出す内容を blocksize (正の整数) で指定したバイト数 でブロック化します。 .Ar blocksize で指定出来る値は、512 の倍数でなくてはならず、最大は 64512 です。 32256 バイトより大きい場合 .Tn POSIX 標準違反であり、全システムで可搬であるわけではありません。 .Ar blocksize で指定する数は、その最後に .Li k もしくは .Li b を付加することで、1024(1K) もしくは 512 の倍数として指定できます。 .Ar blocksizes に指定する数字を .Li x で区切ることで、文字 x で区切られた数字の積がブロックサイズとして採用されます。 アーカイブの書き込みのために指定するデバイスによっては、 ブロックサイズに対してさらに制限がかかることがあります。 ブロック化が指定されない場合には、デフォルトの .Ar blocksize は使用される特定のアーカイブフォーマットに依存します。 .Ns ( Fl x オプションを参照して下さい)。 .It Fl c .Ar pattern に指定されたパターンにマッチしたファイルおよび .Ar file オペランドで指定されたファイル .Em 以外 の、全てのファイルもしくはアーカイブ内メンバにマッチします。 .It Fl d コピーもしくはアーカイブされるディレクトリ、もしくはアーカイブに格納され ているディレクトリについて、指定パターンに一致した名前のディレクトリもし くはアーカイブ内に格納されているディレクトリのみ処理し、そのディレクトリ 配下にあるファイルについては処理しません。 .It Fl f Ar archive .Ar archive で指定したファイルを入力元のアーカイブもしくは出力先のアーカイブに指定し ます。この場合、デフォルトの .Dv 標準入力 .Ns ( Em 一覧表示モード および .Em 読み込みモード の場合) もしくは .Dv 標準出力 .Ns ( Em 書き込みモード ) については無視されます。 1 つのアーカイブが複数のファイルもしくは異なるアーカイブデバイスに渡って も構いません。必要があった場合、 .Nm は、アーカイブの格納されている次のボリュームのファイルもしくはデバイスの パス名の入力を促します。 .It Fl i 対話的にファイルもしくはアーカイブ内に格納されるファイルのリネームを行います。 .Ar pattern で指定した文字列パターンに一致するアーカイブ内の格納ファイルもしくは .Ar file オペランドの指定に一致するファイルについて、 .Nm は .Pa /dev/tty に対してファイルの名前やファイルモード、そしてファイルの更新時刻を表示して 入力を促します。 それから .Nm -は +ユーティリティは .Pa /dev/tty からデータを 1 行読み込みます。 その行が空行だった場合には、その時のファイルもしくはアーカイブ内の 格納ファイルについては、処理を行いません。 その行がピリオド 1 つだけの行だった場合には、その時のファイルもしくは アーカイブ内の格納ファイルについては、ファイル名についての更新は行いません。 それ以外の場合には、ファイル名はその行の文字列で指定した名前に変更されます。 上記操作中に .Dv を .Pa /dev/tty から受けとった場合、もしくは何らかの理由で .Pa /dev/tty をオープン出来なかった場合、 .Nm -は 0 以外の終了ステータスで即座に終了します。 +ユーティリティは 0 以外の終了ステータスで即座に終了します。 .It Fl k すでに存在するファイルに対する上書きをしません。 .It Fl l (アルファベットの ``エル'') ファイルをリンクします。 .Em コピーモード .Ns ( Fl r w ) の場合には、コピー元コピー先間には可能な限りハードリンクが作成されます。 .It Fl n アーカイブに格納されるファイルのうち、各 .Ar pattern オペランドに指定した文字列パターンに一致するファイル名を持つ最初のものを 選択します。 アーカイブに格納されるファイルのうち .Ar pattern オペランドに指定した文字列パターン に一致するもので、2 つめ以降のものは選択されません。 文字列パターンで指定した条件に合致するものがディレクトリだった場合、 そのディレクトリ配下のファイルについても選択されたものとみなされます(ただし、 .Fl d オプションが指定された場合にはこの限りではありません)。 .It Fl o Ar options .Fl x で指定されるアーカイブフォーマットから特定される、 アーカイブファイル展開/書き出しアルゴリズムの更新情報を指定します。 一般的に、 .Ar options は .Cm name=value のように指定されます。 .It Fl p Ar string 1 つ以上のファイルの属性操作に関する動作をオプション指定します。 .Ar string オプション引数は、ファイル展開時に、展開ファイルの属性を保存するか破棄す るかを指定する文字列です。 string は、 .Cm a , e , m , o , p の 5 つの指定文字から成ります。 複数の属性を同じ文字列の中につなげて記述したり、複数の .Fl p オプションを指定したりすることもできます。 これらの文字は、以下のように動作の指定を行います: .Bl -tag -width 2n .It Cm a ファイルのアクセス時間を保存しません。 デフォルトでは、ファイルのアクセスタイムは可能な限り保存されます。 .It Cm e ファイルのユーザ ID, グループ ID, ファイルモードのビット、ファイルの アクセス時間、ファイルの更新時間、これらの .Sq 全ての属性を保存します。 本オプションは、 .Em スーパユーザ、 もしくは適正な権限を持ったユーザによって 使用されることを推奨します。 これは、アーカイブ内に格納されたすべてのファイルについて、 そのファイルの特性を保存するためです。 フラグを指定した場合は、 .Cm o および .Cm p フラグを指定したのと同様の効果を持ちます。 .It Cm m ファイルの更新時間を保存しません。 デフォルトでは、ファイルの更新時間は可能な限り保存されます。 .It Cm o ユーザ ID とグループ ID を保存します。 .It Cm p ファイルモードのビットを .Sq 保存します。 本オプションは、 ファイルについて、所有者情報以外の全ての情報の保存を希望するなど適正な 権限を持った .Em ユーザ に使用されることを推奨しています。 ファイルの時刻はデフォルトで保存されますが、 これを無効にしたり、展開時の時刻を用いるようにするために 別に 2 つのフラグが用意されています。 .El .Pp 先述のオプション一覧にて、 .Sq 属性の保存 とは、起動したプロセスの権限に応じて アーカイブ内に保存された属性が展開ファイルに反映されることを意味します。 これ以外の場合は、展開されるファイルの属性は、 通常のファイル生成と同様に決定されます。 .Cm e と .Cm o のどちらも指定されない場合、あるいは ユーザ ID とグループ ID がいかなる理由にせよ保存されない場合、 .Nm はファイル属性中の .Dv S_ISUID .Em ( setuid ) および .Dv S_ISGID .Em ( setgid ) のビットを設定しません。 これらの情報の引き継ぎが何らかの理由で失敗した場合、 .Nm は診断メッセージを .Dv 標準エラー出力 に書き出します。 これらの情報の保存失敗は、最終的な終了ステータスに影響しますが、 展開されたファイルが削除されるようなことはありません。 ファイル属性の操作に関するオプション文字が重複していたり、 他のオプション文字と処理上の競合を起こす場合には、 それらのオプションの中で一番最後に記述されたものの処理が採用されます。 例えば、 .Dl Fl p Ar eme が指定された場合には、ファイルの更新時間は保存されます。 .It Fl s Ar replstr アーカイブ内に格納されているファイルのうち、 .Ar pattern オペランドもしくは .Ar file オペランドで指定されたもののファイル名を、 .Ar replstr で指定された置換表現にしたがって更新します。この置換表現は、 .Xr ed 1 にて記述されている正規表現の書法に準じます。 これらの正規表現の書式は .Dl /old/new/[gp] です。 .Xr ed 1 に示されるように、 .Cm old は基本的な正規表現であり、 .Cm new はアンパサンド (&)、後方参照 \\n (nの部分は数字が入ります)、 補助表現を含むことができます。 文字列 .Cm old には、 .Dv 改行文字 を含んでも構いません。 ヌル文字以外のいかなる文字も、区切り文字として用いることが可能です (ここでは / を示しました)。 また、複数の .Fl s 表現を指定することが許されています。 これらの表現はコマンドラインで指定された順に適用され、 最初の置換が成功した時点でその置換を終了します。 置換処理の追加処理指定として、 .Cm g を指定した場合には、継続してファイル名の置換を行うことを指示します。 この場合、前回置換に成功した直後の文字から継続して置換を行います。 そして最初に置換を失敗したときに .Cm g オプションの処理を終了します。 置換処理の追加処理指定として .Cm p を指定した場合には、最初の置換成功結果を .Dv 標準エラー出力 に以下のフォーマットで書き出します: .Dl >> 空白文字に置換される通常ファイルもしくはアーカイブ内に格納されたファイルの ファイル名は、処理対象として選択されず、そのファイル名に対する 処理はスキップされます。 .It Fl t .Nm が読み込んだ、もしくはアクセスした全てのファイルやディレクトリの アクセス時間を、 .Nm がそれらのファイルやディレクトリを処理する前のものに再設定します。 .It Fl u 同じ名前ですでに存在するファイルやアーカイブ内に格納されているファイルより 古い (ファイル更新時刻が古い) ファイルを無視します。 .Em 読み込み処理 においては、アーカイブ内のファイルにファイルシステム上にすでに存在するものと 同じ名前のファイルがあり、アーカイブ内のファイルの方が新しい場合に、 アーカイブ内のファイルが展開されます。 .Em 書き込み処理 においては、ファイルシステム上のファイルとアーカイブ内のファイルの名前が 同じもので、かつファイルシステム上のファイルの方がアーカイブ内のものより も新しい場合に、ファイルシステム上のファイルのアーカイブへの格納が行われます。 .Em コピー処理 においては、コピー先にあるファイルとコピー元にあるファイルが同一のファイル名 を持ち、かつコピー元にあるファイルの方が新しい場合に、 コピーあるいはリンクが行われます。 .It Fl v .Em 一覧表示処理 において、 .Xr ls 1 コマンドの .Fl l オプションを用いた時の表示と同じ形式を用いて、アーカイブ内容の表示を行います。 アーカイブの他のメンバとの間にハードリンクを構成するファイルのパス名に ついては、以下のフォーマットで出力されます。 .Dl == アーカイブの他のメンバとの間にシンボリックリンクを構成するファイルの パス名については、以下のフォーマットで出力されます。 .Dl => ここで の箇所は、 .Xr ls 1 コマンドを .Fl l オプションを付けて実行した場合の出力形式になります。 他のオプショナルモード (読み込みモード、書き込みモード、そしてコピーモード) の場合には、当該ファイルもしくはアーカイブ内のファイルの処理が始まるとすぐに、 それらのパス名が末尾の .Dv 改行文字 なしで .Dv 標準エラー出力 に書き込まれ、フラッシュされます。 ファイル名に付随する .Dv 改行文字 はバッファリングされることなく、ファイルが読み込まれたもしくは書き込まれた 直後に書き出されます。 .It Fl x Ar format 出力されるアーカイブフォーマットを指定します。デフォルトフォーマットは、 .Ar ustar フォーマットです。 .Nm -は、現在以下のアーカイブフォーマットをサポートします: +ユーティリティは、現在以下のアーカイブフォーマットをサポートします: .Bl -tag -width "sv4cpio" .It Ar cpio .St -p1003.2 標準にて規定される、拡張 cpio 交換形式です。 本フォーマットのデフォルトブロックサイズは、5120 バイトです。 このフォーマットで欠落するファイルの inode およびデバイス情報 (この フォーマットでファイルのハードリンクの検出に用いられます) は、 .Nm にて検出され、復元されます。 .It Ar bcpio 古い binary cpio フォーマットです。 本フォーマットのデフォルトのブロックサイズは、5120 バイトです。 本フォーマットはポータビリティがそれほどよくないので、別のフォーマットが 使えるならば、そちらを使用したほうがよいでしょう。 このフォーマットで欠落するファイルの inode およびデバイス情報 (この フォーマットでファイルのハードリンクの検出に用いられます) は、 .Nm にて検出され、復元されます。 .It Ar sv4cpio Unix System V Release 4(SVR4) の cpio フォーマットです。 本フォーマットのデフォルトのブロックサイズは 5120 バイトです。 このフォーマットで欠落するファイルの inode およびデバイス情報 (この フォーマットでファイルのハードリンクの検出に用いられます) は、 .Nm にて検出され、復元されます。 .It Ar sv4crc SVR4 で使用される、ファイルの crc チェックサムつきの cpio フォーマットです。 本フォーマットのデフォルトのブロックサイズは 5120 バイトです。 このフォーマットで欠落するファイルの inode およびデバイス情報 (この フォーマットでファイルのハードリンクの検出に用いられます) は、 .Nm にて検出され、復元されます。 .It Ar tar .Bx 4.3 から用いられている古い .Bx tar フォーマットです。 本フォーマットのデフォルトのブロックサイズは、10240 バイトです。 本フォーマットでは、アーカイブ内に格納されるファイルのパス名は 100 文字以内 でなくてはなりません。 .Em 通常ファイル、ハードリンクファイル、 .Em シンボリックリンクファイル、ディレクトリ のみがアーカイブ内に格納されます (他のファイルシステムタイプについては、 サポートされません)。 さらに古い tar フォーマットとの過去の互換性は、 .Fl o オプションを用いて、アーカイブへのファイル保存時に ディレクトリを無視することで実現されます。 本オプションは、以下のように指定します: .Dl Fl o Cm write_opt=nodir .It Ar ustar .St -p1003.2 標準にて規定される、 拡張 tar 交換形式です。 本フォーマットのデフォルトのブロックサイズは、10240 バイトです。 本フォーマットのアーカイブ内に保存されるファイルのパス名は、250 文字以下 の長さでなくてはなりません。 .El .Pp .Nm -は、指定したアーカイブフォーマットの制限に起因して、ファイルの +ユーティリティは、指定したアーカイブフォーマットの制限に起因して、ファイルの アーカイブへの格納もしくはアーカイブからのファイルの展開が出来ない場合には、 それを検出し、報告します。 各アーカイブフォーマットを使用した場合には、 使用時に更にそのアーカイブフォーマットの制限が課せられることがあります。 典型的なアーカイブフォーマットの制限は、ファイルのパス名の長さ、 ファイルサイズ、リンクファイルの指すファイルのパス名の長さ、 そしてファイルタイプなど。 (なお、制限要素はこれらに限られるわけではありません。) .It Fl z 書き込み (読み取り) 時のアーカイブの圧縮 (伸長) に .Xr gzip 1 を使用します。 .Fl a とは共に使用できません。 .It Fl B Ar bytes 単一のアーカイブボリュームに書き出される最大データ長を、 .Ar bytes で制限します。 .Ar bytes パラメータの末尾には .Li m , .Li k , .Li b のいずれかの文字を付加でき、それぞれ 1048576 (1M), 1024 (1K), 512 の倍数を 意味します。 また、 .Ar bytes に指定する数字を .Li x で区切ることで、文字 x で区切られた数字の積がブロックサイズとして採用されます。 .Pp .Em 警告 : 最後の (もしくは最大の) 書き込み時のオフセットに基づいた EOF をサポートする デバイス (テープや通常ファイルなどのようなもの) にアーカイブを書き出す時 にのみ本オプションを使って下さい。 本オプションをフロッピやハードディスクデバイスファイルに対して用いる ことは、推奨しません。 .It Fl D 本オプションは、 .Fl u オプションと同様の動作を行いますが、ファイルの更新時間の代わりに ファイルの inode 変更時間がチェックされるところが異なります。 ファイルの inode 変更時間は、inode 情報 (ユーザ ID、グループ ID、その他) が コピー先のディレクトリ .Ar directory にあるものよりも新しいファイルを選択するのに用いられます。 .It Fl E Ar limit 部分的に破損したアーカイブの読み込みをリトライする際、その読み込み失敗回数を .Ar limit までに制限します。 .Ar limit に正の数を指定した場合、 .Nm はアーカイブの読み込みエラーからの復帰を試行し、アーカイブに格納されて いる次のファイルから処理を継続します。 .Ar limit が 0 の場合、 .Nm は最初のリードエラーがアーカイブボリュームに発生したところで処理を停止します。 .Ar limit が .Li NONE の場合には、読み込み失敗からの復帰を永遠に試行します。 デフォルトの .Ar limit の値は、小さい正の整数(リトライ回数)です。 .Pp .Em 警告 : .Nm コマンドを、本オプションを .Li NONE 指定して起動する場合には十分に気をつけて下さい。 というのも、処理対象となるアーカイブがぼろぼろに破損していた場合には、 処理が無限ループに陥る可能性があるからです。 .It Fl G Ar group グループ名が .Ar group で指定したものであるファイルを選択します。 グループ名が .Cm # で始まる場合には、ファイルのグループ ID がそれに連なる数字のものを 選択します。'\\' を用いて .Cm # をエスケープすることができます。 .Fl G オプションは、複数指定することが可能です。 この場合、最初にグループ名もしくはグループIDが一致したところで チェックは停止します。 .It Fl H 物理的にファイルシステムトラバースを行いながら、 コマンドラインで指定されたファイルについてのみ シンボリックリンクをたどります。 .It Fl L 全てのシンボリックリンクファイルをたどります。 すなわち、論理的にファイルシステムトラバースを行います。 .It Fl P シンボリックリンクをたどりません。 すなわち、物理的にファイルシステムトラバースを行います。 デフォルトはこのモードです。 .It Fl T Ar [from_date][,to_date][/[c][m]] ファイル更新時間もしくは inode 更新時間が .Ar from_date から .Ar to_date の間 (それぞれで指定した時間も含みます) にあるファイルを選択します。 .Ar from_date のみ指定された場合には、ファイル更新時間もしくは inode 更新時間が その時間と同じかそれより新しいもののみ選択されます。 .Ar to_date のみ指定された場合には、ファイル更新時間もしくは inode 更新時間が その時間と同じかそれより古いもののみ選択されます。 .Ar from_date と .Ar to_date が等しい場合には、ファイル更新時間もしくは inode 更新時間が その時間と等しいものが選択されます。 .Pp .Nm が .Em 書き込みモード もしくは .Em コピーモード の場合には、オプションフィールドとして .Ar [c][m] を指定することが可能です。このフィールドは、時間の比較に inode更新時間と ファイル更新時間のどちら(あるいは両方)を使うかを決定します。 どちらも指定されない場合(デフォルト時)には、ファイル更新時間のみが用いられます。 .Ar m は、ファイル更新時間 (ファイルへの書き込みが最後に行われた時間) を 比較対象として用います。 .Ar c は、inode 更新時間 (inode が最後に更新された時間。例えば所有者、 グループ、モードその他が更新された時間) を比較対象として用います。 .Ar c と .Ar m の両者が指定された場合、ファイル更新時間と inode 更新時間の両者が比較対象 になります。 inode 更新時間の比較は、最近属性が変更されたファイルや 最近作成されたファイル、そしてファイル更新時間が古いものに再設定された ファイル (ファイル更新時間を保存するオプションを用いてアーカイブから 展開されたファイルなどがこれにあたります) を選択するのに便利です。 ファイル時間も併用して時間比較をする機能は、 .Nm を用いて、 時間を基準にしたインクリメンタルアーカイブ (指定した期間内に更新された ファイルのみアーカイブすること) を行うのに便利です。 .Pp 時間の範囲は、6 つの異なるフィールドから成り、各フィールドは 2 ケタの数字を 含む必要があります。 その形式は以下の通りです: .Dl [yy[mm[dd[hh]]]]mm[.ss] .Cm yy は、年号 (西暦) の最後の 2 桁です。 最初の .Cm mm は、月 (01 から 12) です。 .Cm dd は、日付 (01 から 31 まで) です .Cm hh は、時 (00 から 23 まで) です。 2 番めの .Cm mm は、分 (00 から 59 まで)です。 そして、 .Cm ss は、秒 (00 から 59 まで)です。 分のフィールドの .Cm mm は、省略不可であり、他のフィールドはオプションであり、以下の順序で 付加されなければなりません: .Dl Cm hh , dd , mm , yy ただし、 .Cm ss フィールドだけは、他のフィールドとは独立して付加可能です。 時間の範囲は、現在時刻からの相対値で表され、 .Dl Fl T Ar 1234/cm は、本日の 12:34 PM から後のファイル更新時間、もしくは inode 更新時間を持つ ファイルを選択することを表します。 複数の .Fl T による時間範囲指定を行うことが許可されており、 指定した範囲のうちいずれかと一致したら、その後の範囲チェックは行いません。 .It Fl U Ar user ファイルの所有者名 .Ar user に基づいて、ファイル選択が行われます。所有者名が .Cm # で始まる場合には、ファイルの UID がそれに連なる数字のものを 選択します。'\\' を用いて .Cm # をエスケープすることができます。 複数の .Fl U オプションを指定することが許されており、その指定の中で最初にユーザが 一致した場合には、それ以降のユーザ名のチェックは行いません。 .It Fl X パス名で指定されたファイル階層をトラバースする場合に、異なるデバイス ID を 持つディレクトリへは下りていきません。 デバイス ID について詳細な情報を取得したい場合には、 .Xr stat 2 の .Li st_dev フィールドを参照して下さい。 .It Fl Y 本オプションは、 .Fl D オプションと動作が似ていますが、全てのファイル名更新が終了した後、 生成されたパス名を用いて inode 更新時間をチェックするところが異なります。 .It Fl Z 本オプションは、 .Fl u オプションと動作が似ていますが、全てのファイル名更新が終了した後、 生成されたパス名を用いて、ファイル更新時間をチェックするところが異なります。 .El .Pp ファイルもしくはアーカイブ内に格納されたファイルについての操作を制御する オプション ( .Fl c , .Fl i , .Fl n , .Fl s , .Fl u , .Fl v , .Fl D , .Fl G , .Fl T , .Fl U , .Fl Y , .Fl Z ) は、相互に以下のような影響を及ぼします。 .Pp .Em 読み込み 処理におけるファイル展開時には、 展開されるファイルは、まず、アーカイブ内に格納されるファイルのうち .Fl c , .Fl n , .Fl u , .Fl D , .Fl G , .Fl T , .Fl U のそれぞれのオプションを用いて指定されるユーザ指定のパターンオペランド に基づいて選択されます。 それらのファイルの中から .Fl s および .Fl i オプションがこの順に、選択されたファイル名を修正します。 それから、最終的なファイル名にて .Fl Y および .Fl Z オプションによる条件を用いて絞り込みを行い、処理するファイルのパス名が 決まります。 そして最後に、 .Fl v オプションは、これまでの処理結果として得られた名前をファイル名として 書き出します。 .Pp .Em 書き込み 操作や .Em コピー 操作のファイルアーカイブでは、以下のオプション .Fl n , .Fl u , .Fl D , .Fl G , .Fl T , .Fl U ( .Fl D オプションはコピー操作時のみ適用されます) によって アーカイブメンバのファイルを選択します。 続いて、それらのファイルの中から .Fl s および .Fl i オプションがこの順に、選択されたファイル名を修正します。 それから .Em コピー 処理においては、最終的なファイル名にて .Fl Y および .Fl Z オプションによる条件を用いて絞り込みを行い、処理するファイルのパス名が 決まります。 そして最後に、 .Fl v オプションは、これまでの処理結果として得られた名前をファイル名として 書き出します。 .Pp .Fl n といっしょに .Fl u オプションあるいは .Fl D オプションのどちらか、もしくは両方が指定された場合、そのファイルが 比較対象のファイルより新しくなければ、そのファイルは選択されたとは みなされません。 .Sh 使用例 コマンド: .Dl "pax -w -f /dev/rst0 ." は、カレントディレクトリの内容を .Pa /dev/rst0 にコピーします。 .Pp コマンド: .Dl pax -v -f filename は、 .Pa filename で指定したアーカイブに格納されているファイル内容の詳細な一覧を表示します。 .Pp 以下のコマンド: .Dl mkdir /tmp/foo .Dl cd /tmp/bar .Dl pax -rw .\ /tmp/foo を実行すると、 .Pa /tmp/bar 配下のディレクトリ階層全体を .Pa /tmp/foo にコピーします。 .Pp コマンド: .Dl pax -r -s ',^//*usr//*,,' -f a.pax は、アーカイブファイル .Pa a.pax からデータを読み込み、アーカイブ中の ``/usr'' 配下のファイルを全て、 カレントディレクトリからの相対ディレクトリに展開します。 .Pp コマンド: .Dl pax -rw -i .\ dest_dir は、カレントディレクトリから .Pa dest_dir ディレクトリにコピーしますが、ファイルをコピーするかどうかを 対話的に選択します。 .Pp コマンド: .Dl pax -r -pe -U root -G bin -f a.pax は、 .Pa a.pax 中に格納されているファイルのうち、所有者が .Em root でグループが .Em bin であるファイルを選択し、すべてのファイル属性を保存して展開します。 .Pp コマンド: .Dl pax -r -w -v -Y -Z home /backup は、コピー先ディレクトリ .Pa /backup にあるファイルのうち、コピー元ディレクトリ .Pa home に存在する同名のファイルより (inode 更新時刻もしくは ファイル更新時刻が) 古いものについて更新を行い、一覧表示します。 .Sh 規格 .Nm ユーティリティは、 .St -p1003.2 標準のスーパセットです。 オプション .Fl z , .Fl B , .Fl D , .Fl E , .Fl G , .Fl H , .Fl L , .Fl P , .Fl T , .Fl U , .Fl Y , .Fl Z 、アーカイブ形式 .Ar bcpio , .Ar sv4cpio , .Ar sv4crc , .Ar tar 、および .Ar 一覧表示 モードと .Ar 読み込み モードにおける破損したアーカイブの取り扱いは、 .Tn POSIX 標準に対する拡張です。 .Sh 関連項目 .Xr cpio 1 , .Xr tar 1 .Sh 歴史 .Nm は .Bx 4.4 に登場しました。 .Sh 作者 .An Keith Muller at the University of California, San Diego .Sh 診断 .Nm -は、以下の値のいずれかで終了します: +ユーティリティは、以下の値のいずれかで終了します: .Bl -tag -width 2n .It 0 すべてのファイルは正常に処理されました。 .It 1 エラーが発生しました。 .El .Pp アーカイブ読み込み中に .Nm がファイルを作成できない場合やリンクを張れない場合、 アーカイブに書き込み中にファイルが見つからない場合、 .Fl p オプション指定時にユーザ ID、グループ ID、ファイル属性を保存できない場合には、 診断メッセージが .Dv 標準エラー出力に 書き出され、0 以外の終了ステータスが返却されますが、 処理自体は継続して行われます。 ファイルへのリンクを作成できない場合には、 .Nm はファイルの二次コピーを作成しません。 .Pp アーカイブからのファイルの展開が、シグナル受信もしくはエラー発生により 途中で異常終了した場合、 .Nm はユーザが指定したファイルの一部分だけを展開して終了する可能性があります。 更に、展開したファイルやディレクトリの属性が不正であったり、 アクセス時間、更新時間も不正である可能性があります。 .Pp アーカイブの生成が、シグナル受信もしくはエラー発生により 途中で異常終了した場合、 .Nm は中途半端なアーカイブを生成している可能性があります。 このようなアーカイブは 特定のアーカイブフォーマット規定を満足していない可能性があります。 .Pp .Em コピー を行っている最中に、 .Nm が読み出したのと同じファイルへの書き込みを検出した場合、 そのファイルはコピーされず、診断メッセージが .Dv 標準エラー出力 へ書き出され、 .Nm は 0 以外の終了ステータスでプログラム終了します。 diff --git a/ja_JP.eucJP/man/man1/pkg_add.1 b/ja_JP.eucJP/man/man1/pkg_add.1 index b549505638..e1573306db 100644 --- a/ja_JP.eucJP/man/man1/pkg_add.1 +++ b/ja_JP.eucJP/man/man1/pkg_add.1 @@ -1,492 +1,493 @@ .\" .\" FreeBSD install - a package for the installation and maintainance .\" of non-core utilities. .\" .\" 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. .\" .\" Jordan K. Hubbard .\" .\" .\" @(#)pkg_add.1 -.\" %FreeBSD: src/usr.sbin/pkg_install/add/pkg_add.1,v 1.35.2.10 2001/12/14 16:48:11 ru Exp % +.\" %FreeBSD: src/usr.sbin/pkg_install/add/pkg_add.1,v 1.35.2.11 2002/06/21 16:42:15 charnier Exp % .\" .\" $FreeBSD$ .Dd November 25, 1994 .Dt PKG_ADD 1 .Os .Sh 名称 .Nm pkg_add .Nd ソフトウェア配布 package をインストールするプログラム .Sh 書式 .Nm .Op Fl vInfrRMS .Op Fl t Ar template .Op Fl p Ar prefix .Ar pkg-name Op Ar pkg-name ... .Sh 解説 .Nm コマンドは、 .Xr pkg_create 1 コマンドにより作成された package (訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) を展開するのに用いられます。 .Sh 警告 .Bf -emphasis .Nm コマンドは package ファイルに含まれるスクリプトやプログラムを 実行することがあるので、あなたのシステムは、危険な配布ファイルを 作る極悪人からの .Dq Em トロイの木馬 や他の巧妙な攻撃などを受ける 可能性があります。 .Pp package ファイルを提供する人物の能力と身元を確認するとよいでしょう。 より進んだ安全のためには、package を展開するのに .Fl M フラグを用い、その内容と、スクリプトがシステムに害をおよぼさないかを 確認します。 +INSTALL, +POST-INSTALL, +DEINSTALL, +REQUIRE, +POST-INSTALL, +REQUIRE, +MTREE_DIRS の各ファイルには 特に注意を払い、+CONTENTS ファイルの .Cm @cwd , .Cm @mode (setuid をチェック), .Cm @dirrm , .Cm @exec , .Cm @unexec ディレクティブを調べてください。 package ファイルを調べるのには .Xr pkg_info 1 コマンドも使えます。 .Ef .Sh オプション 以下のコマンドラインオプションが提供されています: .Bl -tag -width indent .It Ar pkg-name Op Ar pkg-name ... 指定された package がインストールされます。 - という名前が指定されると、 .Nm は stdin から読み込みます。 package がカレントディレクトリに見つからないと、 .Nm は .Ev PKG_PATH で指定された各ディレクトリを探します。 .It Fl v 饒舌な出力に切り替えます。 .It Fl I package にインストール用スクリプト (pre-install または post-install) が存在しても、それを実行しません。 .It Fl n 実際にはインストールを行わず、インストールした場合に実行されるであろう ステップを表示します。 .It Fl R package のインストール結果を記録しません。 このオプションは、後でアンインストールすることを不可能にするため、 自分が何をしているかを理解している人のみ使ってください。 .It Fl r リモートフェッチ機能を使用します。 適切なオブジェクト形式とリリースを決定してから、 package を取得してインストールします。 .It Fl f あらかじめ必要な package がインストールされていなかったり、 requirements スクリプトが失敗した場合にも強制的にインストールします。 これは .Nm が見つからない必要な package を探して自動的にインストールすることを 止めるわけではなく、見つからない場合でも中断しないようにします。 .It Fl p Ar prefix package からファイルを展開するディレクトリの前に .Ar prefix を付けます。 package がデフォルトディレクトリを保持している場合には、 このオプションで変更できます。 .Nm はディレクトリ設定が相対的に行われているか、絶対的に行われているか を知る術がないので、最初の .Cm @cwd ディレクティブのみが変更されることに注意してください。 複数回のディレクトリ変更が行われることはまれですが、 実際にあった場合、すべてのディレクトリ変更を制御したくなる でしょう。この場合、 .Cm MASTER モード、 .Cm SLAVE モードの使用を検討してみてください (オプション .Fl M と .Fl S を参照)。 .It Fl t Ar template .Dq 作業領域 を作成する際に、 .Xr mktemp 3 への入力として .Ar template を用います。 これはデフォルトでは .Pa /var/tmp/instmp.XXXXXX という文字列ですが、 .Pa /var/tmp ディレクトリの容量が制限されているような状況では 変更する必要があるかもしれません。 .Xr mktemp 3 が一意の ID を用いるために必要な `X' の文字をいくつか残しておく ことを忘れないでください。 .Pp 作業領域 .Ar template を package ファイルがインストールされるディレクトリと同じディスク パーティションに設定することによって、パフォーマンスを高めることが 可能です (大抵は .Pa /usr )。 .It Fl M .Cm MASTER モードで実行します。これは .Nm のとても特殊な実行モードであり、 .Cm SLAVE モードと共に実行しなければなりません。 このモードで実行されると、 .Nm は一時的な作業領域 ( .Fl t オプションを参照) へ package を展開する以上のことはせず、 現在の作業領域ディレクトリ名を頭に付加した packing list を標準出力に 出力します(標準出力は .Xr sed 1 のようなプログラムにフィルタされているかもしれません)。 .Cm SLAVE モードと共に用いると、中身を処理する前に package 構造に 大きな変更を加えることが可能になります。 .It Fl S .Cm SLAVE モードで実行します。これは .Nm のとても特殊な実行モードであり、 .Cm MASTER モードと共に実行しなければなりません。 このモードで実行されると、 .Nm は package の内容がすでに作業領域に展開され、その場所が 標準入力から文字列として入力されることを想定します。 完全な packing list も stdin から読み込まれ、その後中身が 通常どおり処理されます。 .El .Pp 一つ以上の .Ar pkg-name 引数を指定することが可能で、それらは package を含むファイル名 (通常 拡張子 .Dq .tgz で終わります) か、ftp サイトにあるファイルを 示す URL のどちらかになります。 したがって、anonymous ftp から直接ファイルを展開することが 可能です (例えば .Nm .Li ftp://ftp.FreeBSD.org/pub/FreeBSD/packages/shells/bash-1.14.4.tgz ) 。 注意: もし上記のような転送で用いる ftp で .Bf -emphasis passive mode .Ef を利用したいなら、環境変数 .Bf -emphasis FTP_PASSIVE_MODE .Ef に何らかの値を設定する必要があります。 そうでなければ、より一般的な ACTIVE モードが利用されます。 もしうまく動作していることがわかっているサイトから package を 得ようとして .Nm が常に失敗する場合、あなたが .Bf -emphasis passive mode .Ef の ftp を使う必要のあるファイアウォールの中にいるのが原因である場合が あります。 .Sh 技術詳細 .Nm -はきわめて単純です。各 package の "packing list" を +ユーティリティはきわめて単純です。 +各 package の "packing list" を 特別な作業ディレクトリに展開し、 中身を解析し、内容を完全に展開するために 以下の手順を実行します: .Bl -enum .It package がすでにインストールされている、と記録されているかどうかを チェックします。もしそうならインストールを中断します。 .It .Cm @pkgdep ディレクティブ ( .Xr pkg_create 1 を参照) による package のすべての依存関係をチェックし、各々が存在するかどうかを 確認します。もし存在しなければ、足りない package を見つけて自動的に インストールしようとします。もし見つからなければ、 インストールを中断します。 .It package がどのようにシステムに追加されるかを制御する .Cm @option ディレクティブを検索します。このマニュアルページを書いている時点では、 実装されているオプションは .Cm @option extract-in-place のみであり、これは .Pa /tmp 内の作業領域を経由しないで、 package を最終的なディレクトリに直接展開するようにします。 .It .Cm @option extract-in-place が指定されていれば、package は最終的な場所に直接展開され、 そうでなければ作業領域内に展開されます。 .It package が .Ar require ファイル ( .Xr pkg_create 1 を参照) を含んでいる場合、そのファイルを以下の引数を付けて実行します: .Bd -ragged -offset indent -compact .Ar pkg-name .Ar INSTALL .Ed ここで .Ar pkg-name は問題としている package の名前であり、 .Ar INSTALL キーワードはインストールの requirements チェックであることを 示しています (これは複数の機能を提供するひとつのスクリプトを 用いようとする場合に有用です)。 .It package に .Ar pre-install スクリプトが存在する場合、以下の引数を付けて実行されます: .Bd -ragged -offset indent -compact .Cm script .Ar pkg-name .Ar PRE-INSTALL .Ed .Pp ここで .Ar pkg-name は対象の package 名であり、 .Ar PRE-INSTALL はこれがインストール前のフェーズであることを示すキーワードです。 .Pp .Sy 注: ( .Fl i および .Fl I のフラグを .Xr pkg_create 1 に使用することにより) package 作成時に pre-install と post-install のスクリプトが別々に与えられる場合には、 .Ar PRE-INSTALL キーワードは登場しません。 .It .Cm @option extract-in-place が指定されていない場合、packing list ( .Pa +CONTENTS ファイル) が作業領域から最終的な場所に ファイルを移動 (必要ならコピー) するために参照されます。 .It package が .Ar mtreefile ファイル ( .Xr pkg_create 1 を参照) を含む場合、mtree が以下の引数を付けて実行されます: .Bd -ragged -offset indent -compact .Cm mtree .Fl u .Fl f .Ar mtreefile .Fl d .Fl e .Fl p .Pa prefix .Ed ここで .Pa prefix は .Fl p フラグが指定されていればその prefix、 .Fl p フラグが指定されていない場合にはこの package の最初の .Cm @cwd ディレクティブのディレクトリ名が prefix になります。 .It package に .Ar post-install スクリプトが含まれる場合、 .Bd -ragged -offset indent -compact .Cm script .Ar pkg-name .Ar POST-INSTALL .Ed として実行されます。 ここで .Ar pkg-name は対象の package 名であり、 .Ar POST-INSTALL はこれがインストール後のフェーズであることを示すキーワードです。 .Pp .Sy 注: ( .Fl i および .Fl I のフラグを .Xr pkg_create 1 に使用することにより) package 作成時に pre-install と post-install のスクリプトが別々に与えられる場合には、 .Ar POST-INSTALL キーワードは登場しません。 .Pp .Ar POST-INSTALL および .Ar PRE-INSTALL のキーワードを渡す背景には、 .Dq インストールの前とインストール後の両方 の手続きをこなす一つの .Ar install スクリプトを用いることを可能にすることがあります。 しかしながら、メンテナンスの観点からは、機能を分離する方が有利かつ容易です。 .It インストールが終了すると、後で .Xr pkg_delete 1 で使うために packing list、 .Ar deinstall スクリプト、 description、 display の各ファイルが .Pa /var/db/pkg/ にコピーされます。 package の依存関係は、他の package の .Pa /var/db/pkg//+REQUIRED_BY ファイル (PKG_DBDIR 環境変数が設定してある場合、上記の .Pa /var/db/pkg/ が置き換えられます) に記録されます。 .It 最後に、作業領域が削除されプログラムは終了します。 .El .Pp すべてのスクリプトは環境変数 .Ev PKG_PREFIX にインストール時の prefix ( 前述の .Fl p オプションを参照) が設定された状態で実行されます。 このことにより、package の作者は .Cm pkg_add の .Fl p フラグにより package がインストールされるディレクトリが 変更されても、きちんとふるまうスクリプトを書くことが可能になります。 .Sh 環境変数 .Ev PKG_PATH の値は、指定された package が見つからない時に用いられます。 環境変数はコロンで区切られた一連のエントリです。 各エントリはディレクトリ名からなります。 カレントディレクトリは空欄のディレクトリ名で暗黙のうちに指定されるか、 一つのピリオドで明示的に指定します。 .Pp 環境変数 .Ev PKG_DBDIR は、インストールされた package についてのデータベースの位置を指定します。 .Pp .Nm が作業領域の生成を試みる作業用ディレクトリの名前は、環境変数 .Ev PKG_TMPDIR と .Ev TMPDIR とから (この順で) 取られます。 これらの変数が存在しないか、指定されたディレクトリに十分な空き容量が ない場合、 .Nm は、 .Pa /var/tmp , .Pa /tmp , .Pa /usr/tmp のうちで、十分な空き容量を持つ最初のディレクトリを使います。 .Pp 環境変数 .Ev PACKAGEROOT は、 .Nm が取得を行う代替位置を指定します。 取得に使用する URL は、本環境変数と、 .Fl r オプション使用時に .Nm が自動的にディレクトリを決定する論理とで、構築されます。 設定例は .Qq Li ftp://ftp3.FreeBSD.org です。 .Pp 環境変数 .Ev PACKAGESITE は、 .Nm が取得を行う代替位置を指定します。 この変数を使用すると、 .Fl r オプション使用時に .Nm が自動的にディレクトリを決定する論理が破壊されます。 よって、これはリモートパッケージファイルへの完全な URL であることが必要です。 .Sh 関連ファイル .Bl -tag -width /var/db/pkg -compact .It Pa /var/tmp 環境変数 .Ev PKG_TMPDIR と .Ev TMPDIR のどちらも適切なディレクトリを指定しない場合に、作業領域を作成するため に用いる作業用ディレクトリ。 .It Pa /tmp .Pa /var/tmp が存在しないか、十分な空き容量を持たない場合、その次に選ばれる ディレクトリ。 .It Pa /usr/tmp .Pa /var/tmp と .Pa /tmp のどちらも作業領域を作成するには適切でない場合、最後に選ばれる ディレクトリ。 .It Pa /var/db/pkg インストールされた package についてのデータベースのデフォルトの位置。 .El .Sh 関連項目 .Xr pkg_create 1 , .Xr pkg_delete 1 , .Xr pkg_info 1 , .Xr pkg_update 1 , .Xr pkg_version 1 , .Xr mktemp 3 , .Xr sysconf 3 , .Xr mtree 8 .Sh 作者 .An Jordan Hubbard .Sh 協力者 .An John Kohl Aq jtk@rational.com .Sh バグ 配布物のファイル間のハードリンクは、 (1) 作業領域が、ファイルへのすべてのリンクの最終的な ディレクトリと同じファイルシステムの場合もしくは、 (2) ファイルへのすべてのリンクが contents ファイル内で .Cm @cwd ディレクティブで括られている場合にのみ保存されます。 .Em さらに その上、リンク名は単一の .Cm tar コマンド ( .Fn sysconf _SC_ARG_MAX により返される値に依存する実行時の引数の長さの制限により、複数の 実行には分割できません) で展開されなければなりません。 .Pp バグは他にもあるはずです。 diff --git a/ja_JP.eucJP/man/man1/pkg_delete.1 b/ja_JP.eucJP/man/man1/pkg_delete.1 index 850d877e69..d69758758a 100644 --- a/ja_JP.eucJP/man/man1/pkg_delete.1 +++ b/ja_JP.eucJP/man/man1/pkg_delete.1 @@ -1,288 +1,288 @@ .\" .\" FreeBSD install - a package for the installation and maintainance .\" of non-core utilities. .\" .\" 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. .\" .\" Jordan K. Hubbard .\" .\" .\" @(#)pkg_delete.1 -.\" %FreeBSD: src/usr.sbin/pkg_install/delete/pkg_delete.1,v 1.16.2.8 2001/10/03 07:46:02 sobomax Exp % +.\" %FreeBSD: src/usr.sbin/pkg_install/delete/pkg_delete.1,v 1.16.2.9 2002/06/21 16:42:18 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd November 25, 1994 .Dt PKG_DELETE 1 .Os .Sh 名称 .Nm pkg_delete .Nd インストールされているソフトウェア配布 package を削除するプログラム .Sh 書式 .Nm .Op Fl dDfGinrvx .Op Fl p Ar prefix .Ar pkg-name ... .Nm .Fl a .Op Ar flags .Sh 解説 .Nm コマンドは、 .Xr pkg_add 1 コマンドにより既にインストールされている package (訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) を削除するために 用いられます。 .Sh 警告 .Bf -emphasis .Nm コマンドは package ファイルにより提供されるスクリプトやプログラムを 実行することがあるので、あなたのシステムは、危険な配布ファイルを 作る極悪人からの .Dq トロイの木馬 や他の巧妙な攻撃などを受ける 可能性があります。 .Pp package ファイルを提供する人物の能力と身元を確認するとよいでしょう。 より進んだ安全のためには、package 記録ディレクトリ .Pa ( /var/db/pkg// ) にあるすべての package 制御ファイルを確認します。 +INSTALL, +POST-INSTALL, +DEINSTALL, +POST-DEINSTALL, +REQUIRE, +MTREE_DIRS の各ファイルには 特に注意を払い、+CONTENTS ファイルの .Cm @cwd , .Cm @mode (setuid をチェック), .Cm @dirrm , .Cm @exec , .Cm @unexec ディレクティブを調べてください。 インストールされている package 制御ファイルを調べるのには .Xr pkg_info 1 コマンドも使えます。 .Ef .Sh オプション 以下のコマンドラインオプションが提供されています: .Bl -tag -width indent .It Ar pkg-name ... 指定された package がアンインストールされます。 .It Fl a 無条件に、現在インストール済の package をすべて削除します。 .It Fl i 各 package の削除前に、確認を求めます。 これは、標準入力デバイスが端末かどうかに関係ありません。 .It Fl v 饒舌な出力に切り替えます。 .It Fl D package にアンインストール用スクリプトが存在しても、それを実行しません。 .It Fl n 実際にはアンインストールは行わず、アンインストールした場合に実行されるであろう ステップを表示します。 .It Fl p Ar prefix インストールされている package が明示的にディレクトリを設定していない 場合に、削除するファイルの前に .Ar prefix をディレクトリとして付け加えます。 ほとんどの package では、このディレクトリは .Xr pkg_add 1 によってインストールされた場所に自動的に設定されます。 .It Fl d ファイル削除により生じた空のディレクトリを削除します。 デフォルトでは、package の内容一覧に明示的に羅列された ファイル/ディレクトリ (通常のファイル/ディレクトリか .Cm @dirrm ディレクトリを伴ったもの) のみがアンインストール時に削除されます。 このオプションにより .Nm は package を削除することにより生ずる空ディレクトリも削除するように なります。 .It Fl f 依存関係が記録されていたり、アンインストールスクリプトや require スクリプトが失敗した場合でも、強制的に package を削除します。 .It Fl G 削除対象の package の選択時に、 .Ar pkg-name 中のシェルグロブパターンの展開を試みません (デフォルトでは、 .Nm は .Ar pkg-name 中のシェルグロブパターンを自動的に展開します)。 .It Fl x .Ar pkg-name を正規表現として扱い、名前がこの正規表現にマッチする全 package を削除します。 複数の正規表現を指定可能であす。 この場合、リスト中の少なくとも 1 個の正規表現にマッチする全 package が 削除されます。 .It Fl r 再帰的な削除。 指定した package に加え、これに依存する package もまた削除します。 .El .Sh 技術詳細 .Nm -は名前の通りに働きます。 +ユーティリティは名前の通りに働きます。 .Nm は .Pa /var/db/pkg/ に記録されたインストール済みの package をチェックし、 package の内容を削除し、最後に package の記録も削除します。 環境変数 .Ev PKG_DBDIR が設定されている場合には、前記パス .Pa /var/db/pkg/ にこれが優先します。 .Pp ある package が他のインストール済みの package から必要とされている場合、 .Nm はそれらの依存している package の一覧を表示し、package の削除は 行いません (ただし .Fl f オプションが指定された場合を除く)。 .Pp package が .Ar require ファイル( .Xr pkg_create 1 を参照)を含んでいる場合、まずそのファイルを以下の引数を付けて実行し、 アンインストール作業を続けるべきかどうかを確かめます: .Bd -ragged -offset indent -compact .Cm require .Ar .Ar DEINSTALL .Ed (ここで .Ar pkg-name は問題としている package の名前であり、 .Ar DEINSTALL はこれがアンインストールであることを示すキーワードです) 終了ステータスが 0 以外の場合には、 .Fl f オプションが指定されていない限りアンインストールを中断します。 .Pp package に .Cm deinstall スクリプトが含まれている場合、 そのスクリプトはファイルが削除される前に実行されます。 .Nm はオリジナルの package に含まれていたファイルを削除することしか 関知しないので、 package のインストールにまつわる雑多な事項をきれいに片づけるのは この .Cm deinstall スクリプトの責任です。 .\" since all ... 以下はなくてもどうにか意味が通じるだろう、という .\" のとうまい訳が見つからなかったので加えていません。 .\" By kuriyama@opt.phys.waseda.ac.jp (Jun 3 1997) .\" --> 訳してみました。By sakai@jp.freebsd.org (Jun 9, 1997) .Nm deinstall スクリプトは以下の引数を付けて実行されます: .Bd -ragged -offset indent -compact .Cm script .Ar .Ar DEINSTALL .Ed ここで、 .Ar pkg-name は対象の package 名であり、 .Ar DEINSTALL はこれがアンインストール前のフェーズであることを示すキーワードです。 .Pp .Sy 注: ( .Fl k および .Fl K のフラグを .Xr pkg_create 1 に使用することにより) package 作成時に deinstall と post-deinstall のスクリプトが別々に与えられる場合には、 .Ar DEINSTALL キーワードは登場しません。 .Pp .Cm post-deinstall スクリプトが package に対して存在する場合、 全ファイルが削除された .Cm 後 で実行されます。 package のインストールに際する更なる細々としたことを片づけ、 (願わくば) package インストール前と同じシステム状態に戻すことは、 このスクリプトの責任です。 .Pp .Nm post-deinstall は次のように呼び出されます: .Bd -ragged -offset indent -compact .Cm script .Ar .Ar POST-DEINSTALL .Ed ここで .Ar pkg-name は対象の package 名であり、 .Ar POST-DEINSTALL はこれがアンインストール後のフェーズであることを示すキーワードです。 .Pp .Sy 注: ( .Cm Fl k および .Cm Fl K のフラグを .Xr pkg_create 1 に使用することにより) package 作成時に deinstall と post-deinstall のスクリプトが別々に与えられる場合には、 .Ar POST-DEINSTALL キーワードは登場しません。 .Pp .Ar POST-DEINSTALL および .Ar PRE-DEINSTALL のキーワードを渡す背景には、 インストールと削除のすべてを扱うことができる単一のプログラム/スクリプト を記述可能にすることがあります。 .Pp しかしながら、この方法はメンテナンスがかなり難しく、 インストールおよびアンインストールの各局面を扱う別々のスクリプトを持つ方法 には及ばないことが、経験により分かりました。 .Pp すべてのスクリプトは環境変数 .Ev PKG_PREFIX にインストール時の prefix が設定された状態で実行されます (上記の .Fl p オプションを参照)。 このことにより、package の作者は .Nm や .Cm pkg_add の .Fl p フラグにより package がインストールされるディレクトリが 変更されても、きちんとふるまうスクリプトを書くことが可能になります。 .Sh 環境変数 環境変数 .Ev PKG_DBDIR は、インストール済み package の代替データベースを指定します。 .Sh 関連ファイル .Bl -tag -width /var/db/pkg -compact .It Pa /var/db/pkg インストール済み package のデーバベースのデフォルトの位置。 .El .Sh 関連項目 .Xr pkg_add 1 , .Xr pkg_create 1 , .Xr pkg_info 1 , .Xr pkg_version 1 , .Xr mktemp 3 , .Xr mtree 8 .Sh 作者 .An Jordan Hubbard .Sh 協力者 .An John Kohl Aq jtk@rational.com .Sh バグ まだあるはずです。 diff --git a/ja_JP.eucJP/man/man1/pkg_sign.1 b/ja_JP.eucJP/man/man1/pkg_sign.1 index 031190f2d6..94a1e379b2 100644 --- a/ja_JP.eucJP/man/man1/pkg_sign.1 +++ b/ja_JP.eucJP/man/man1/pkg_sign.1 @@ -1,223 +1,223 @@ -.\" %FreeBSD: src/usr.sbin/pkg_install/sign/pkg_sign.1,v 1.1.2.4 2001/07/22 12:41:24 dd Exp % +.\" %FreeBSD: src/usr.sbin/pkg_install/sign/pkg_sign.1,v 1.1.2.5 2002/06/21 16:42:20 charnier Exp % .\" $OpenBSD: pkg_sign.1,v 1.6 2000/04/15 02:15:20 aaron Exp $ .\" .\" Copyright (c) 1999 Marc Espie. .\" .\" 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 Marc Espie for the OpenBSD .\" Project. .\" .\" THIS SOFTWARE IS PROVIDED BY THE OPENBSD PROJECT 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 OPENBSD .\" PROJECT 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. .\" .\" $FreeBSD$ .\" .\"WORD: certificate 証明書 .\"WORD: verification 検証 .\" .Dd September 24, 1999 .Dt PKG_SIGN 1 .Os .Sh 名称 .Nm pkg_sign , .Nm pkg_check .Nd package の署名を扱う .Sh 書式 .Nm .Op Fl sc .Op Fl t Ar type .Op Fl u Ar id .Op Fl k Ar key .Op Ar .Nm pkg_check .Op Fl sc .Op Fl u Ar id .Op Fl k Ar cert .Op Ar .Sh 解説 .Nm -は暗号化された署名を gzip ファイル +ユーティリティは暗号化された署名を gzip ファイル .Ar file に埋めこみます。 .Ar type には .Cm pgp (デフォルト), .Cm sha1 , .Cm x509 が指定できます。 .Ar type を .Cm pgp にすると、 pgp 秘密鍵の利用を可能にするための パスフレーズ入力を促すプロンプトが表示されます。 パスフレーズを設定していなくても表示されます (これはいずれにせよ良くない状況ですが)。 .Ar type が .Cm sha1 の場合は、 .Ar id を指定する必要があります。これは package (訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) の名前として記録され、SHA1 チェックサムとして表示されます。 .Pp .Nm pkg_check -は暗号化された署名をチェックします。 +ユーティリティは暗号化された署名をチェックします。 現在は .Ar type を無視し、一番上 (topmost) の署名だけをチェックします。 .\"translator: topmost の意味/訳語は? .Cm sha1 に対しては、 .Nm pkg_check はファイルのチェックサムを取り、 結果が .Pa /var/db/pkg/SHA1 に記録されているチェックサムのリストにマッチするかどうか確認します。 .Pp オプション .Fl s および .Fl c は「package への署名」モードおよび「署名チェック」モードを強制します。 .\"nakano: pkg_sign -c = pkg_check, pkg_check -s = pkg_sign, ということ? .Pp .Cm pgp では、 package への署名や署名チェックに用いる .Ar id を .Fl u で指定できます。 .Pp .Cm x509 では、 署名キーまたは検証する証明書 (certificate) を .Fl k オプションで指定できます。 指定しないと、package は以下で記述している デフォルトのキーで署名 (デフォルトの証明書で検証) されます。 .Pp .Ar file がダッシュひとつ .Pq Sq Fl だったり指定されなかった場合は、 .Nm は標準入力から読み込みます。 .Pp package への署名では gzip 形式の特徴を利用しています。 これは、gzip のヘッダには .Dv EXTRA_FIELD というフラグを設定でき、余分のデータを gzip ヘッダと圧縮ファイルの間に保存できる、というものです。 .Ox の署名機構では、 .Sq Li SIGPGP + length や .Sq CKSHA1 + length のような 8 バイトのマーカを署名に用いています (これらのマーカは伝統的に 8 バイト長となっています)。 .Sh 診断 .Nm および .Nm pkg_check -は、 +のユーティリティは、 .Ar file のいずれかになにか問題があると、0 より大きい終了コードを返します。 .Nm pkg_check の場合、これは通常 package が署名されていない、 あるいは署名が捏造されていることを意味します。 .Bl -diag .It "File %s is already signed" その gzip ファイルには、既に署名が埋めこまれています。 .Nm -は今のところ複数の署名を扱いません。 +ユーティリティは今のところ複数の署名を扱いません。 .It "File %s is not a signed gzip file" この package には署名がありません。 .It "File %s is not a gzip file" gzip ヘッダが見つかりませんでした。 .It "File %s contains an unknown extension" gzip ファイルの拡張領域が、別の何らかの用途に既に使われていました。 .It "File %s uses old signatures, no longer supported" この gzip ファイルは、非常に古い版の (かなり遅くなる) package 署名を用いています。 .El .Sh バグ .Xr pgp 1 はあまり設計の良くないプログラムで、 インタフェースを取るのが難しいです。 例えば pgp が提供しているといっている 「分離署名機能 (separate signing scheme)」 は不便極まりないもので、パイプを通しての利用ができません。 したがって .Nm pgp_sign ではこれをなんとかするために、 pgp 署名の長さを知っていることにして、 pgp を「シームレス」署名モードで起動し、 ファイル本体は圧縮しないで署名のみを取出しています。 .\"translator: kludge it の適切な訳がちょっとわかりませんでした。 .Pp チェック動作ではあまり複雑なことはしていません。 pgp に入力するファイルをその場で再ビルドしています。 .\"translator: 逆か? -> little less convoluted .Pp .Nm pgp およびチェックサムファイルへのパスは不正利用を妨げるために ハードコードされています。そのため柔軟性は損なわれています。 .Sh 関連ファイル .Bl -tag -width "/usr/local/bin/pgp" -compact .It Pa file.sign .Nm が .Ar file からビルドする一時ファイル .It Pa /usr/local/bin/pgp .Xr pgp 1 のデフォルトのパス .It Pa /var/db/pkgs/SHA1 記録済みのチェックサム .It Pa /etc/ssl/pkg.key デフォルトの package への署名キー .It Pa /etc/ssl/pkg.crt デフォルトの package 検証用証明書 .El .Sh 関連項目 .Xr gzip 1 , .Xr pgp 1 , .Xr pkg_add 1 , .Xr sha1 1 .Sh 作者 .An -nosplit .Nm -は +ユーティリティは .An Marc Espie が .Ox プロジェクトのために作成しました。 X.509 署名と .Fx サポートは .An Wes Peters Aq wes@softweyr.com が追加しました。 diff --git a/ja_JP.eucJP/man/man1/pkg_version.1 b/ja_JP.eucJP/man/man1/pkg_version.1 index 5575e06c79..0014727e9c 100644 --- a/ja_JP.eucJP/man/man1/pkg_version.1 +++ b/ja_JP.eucJP/man/man1/pkg_version.1 @@ -1,262 +1,262 @@ .\" .\" Copyright 1998 Bruce A. Mah .\" .\" 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. .\" -.\" %FreeBSD: src/usr.sbin/pkg_install/version/pkg_version.1,v 1.5.2.13 2001/08/16 15:56:16 ru Exp % +.\" %FreeBSD: src/usr.sbin/pkg_install/version/pkg_version.1,v 1.5.2.14 2002/06/21 16:42:26 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/pkg_version.1,v 1.15 2001/07/29 05:14:52 horikawa Exp $ +.\" $FreeBSD$ .Dd July 17, 1998 .Dt PKG_VERSION 1 .Os .Sh 名称 .Nm pkg_version .Nd インストールされた package のバージョンを要約表示 .Sh 書式 .Nm .Op Fl cdhv .Op Fl l Ar limchar .Op Fl L Ar limchar .Op Fl s Ar string .Op Ar index .Nm .Op Fl t Ar version1 version2 .Sh 解説 .Nm コマンドは、 .Xr pkg_add 1 コマンドを使ってインストールされた、基本ソフトウェア以外の ソフトウェア package (訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) に関するレポートを作成するために使います。 .Pp 各 package のバージョン番号は、2 個の情報源のうちの 1 つと照会され、 この package の更新が必要が否かが判断されます。 package 中に .Fx ports ツリーにおける起源情報を含み、port の .Pa Makefile からバージョン番号を判定可能な場合、 .Pa Makefile のバージョン番号を使用して、 インストール済の package が最新であるか更新要かを判定します。 .Pp package の起源が無い場合か、port の .Pa Makefile が見付からない場合、 .Nm は ports collection インデックスファイル (典型的には .Pa /usr/ports/INDEX ) から package を探します。 マッチするバージョン番号 (複数可) を使用して、 インストール済の package が最新であるか更新要かを判定します。 .Pp 一般的に、port の .Pa Makefile のバージョン番号を使用することにより、より正確な結果となります。 これは、インデックスファイルとは異なり、 現在のバージョン番号を厳密に提供するためであり、 これは複数のバージョンの port が ports collection 中にある場合でも成立します。 更に、ports collection インデックスファイルの更新は間隔が開きますので、 ports collection に含まれるソフトウェアのバージョン番号を 完全に反映している訳ではありません。 .Pp 各 package 名が、次に示す 1 文字のステータスフラグと一緒に表示されます: .Bl -tag -width indent .It Li = インストールされている package のバージョンは、最新です。 .It Li \&< インストールされている package のバージョンは、 最新バージョンより古いものです。 .It Li \&> インストールされている package のバージョンは、 最新バージョンよりも新しいものです。 この状況は、インデックスが古い場合か、新規 port をテスト中に発生します。 .It Li \&? インストールされた package がインデックス中に見付かりませんでした。 原因としては、インデックスが古いことか、 コミットされていない package を PR から取得したことがあり得ます。 .It Li * ある特定のソフトウェア package で 複数バージョンがインデックスに列挙されているものがあります。 .Fx port コレクションを例に取ると、 Tcl ツールキットや .Tn EMACS が該当します。 .It Li \&! インストールされた package がインデックス中にありますが、 なんらかの理由で、 インストールされた package のバージョン番号と インデックス中の対応するエントリとを .Nm が比較できませんでした。 .El .Sh オプション .Nm -は、いくつかのコマンドライン引数をサポートしています: +ユーティリティは、いくつかのコマンドライン引数をサポートしています: .Bl -tag -width indent .It Fl c コマンド出力を可能にします。 コマンド出力は、 インストール済み package を port システムにおいて 最新バージョンのものに更新するために、 あなたが打込む必要があるコマンドを含んでいます。 この機能は、package を自動的に更新するシステムを構成するわけではありま .Bf Em せん .Ef 。 本コマンドの出力は、インストール済の package 間の依存関係を壊さないために、 編集する .Bf Em 必要 .Ef があります。 .It Fl d デバッグ出力を有効にします。 .It Fl h ヘルプメッセージを表示します。 .It Fl l 出力する package を、ステータスフラグが文字 .Ar limchar にマッチするものに制限します。 マッチに使用する文字を、複数個 .Ar limchar に指定可能です。 ステータスフラグの文字にはシェルの特殊文字でもあるものが存在するため、 .Ar limchar をシングルクォートで括るのが最善手です。 .It Fl L 出力する package を、ステータスフラグが .Ar limchar にマッチしないものに制限します。 複数のマッチ対象の文字を .Ar limchar に指定可能です。 ステータスフラグの文字にはシェルの特殊文字でもあるものが存在するため、 .Ar limchar をシングルクォートで括るのが最善手です。 .It Fl s 出力する package を、指定された文字列 .Ar string に名前がマッチするものに制限します。 .It Fl t バージョン番号文字列の組をテストし、終了します。 次の単一文字のいずれかを標準出力へ出力します: .Li = (等しい), .Li \&< (右側の番号が大きい), .Li \&> (左側の番号が大きい)。 本フラグは、スクリプトやテストに有用です。 .It Fl v 冗長出力を有効にします。 冗長出力は 英文による、バージョン番号比較に関する若干の説明と、 各 package の比較に使われたバージョン番号の説明が含まれています。 スクリプトやプログラムで処理するには、 おそらく冗長でない出力の方が簡単でしょう。 .It Ar index 比較の基準として利用するインデックスを指定します。 インデックスとして、ファイル名 (ローカルなファイルシステム内) または URL を指定することができます。 .Xr fetch 1 が解釈可能な URL であれば、どのようなものでも指定することができます。 コマンドラインで .Ar index ファイルが指定されていない場合は .Pa /usr/ports/INDEX が利用されます。 .El .Sh 関連項目 .Xr fetch 1 , .Xr pkg_add 1 , .Xr pkg_create 1 , .Xr pkg_delete 1 , .Xr pkg_info 1 .Sh 関連ファイル .Bl -tag -width /usr/ports/INDEX -compact .It Pa /usr/ports/INDEX デフォルトのインデックスファイル。 .El .Sh 使用例 以下は .Nm コマンドの典型的な起動方法です。 インストール済み package を ローカルの port インデックスファイルと照合します: .Pp .Dl % pkg_version -v .Pp 下のコマンドは、 オンラインの port コレクションにおける バージョン番号に対してレポートを生成します: .Pp .Dl % pkg_version ftp://ftp.FreeBSD.org/pub/FreeBSD/ports-current/INDEX .Pp 下のコマンドは、 インストールされたファイルの更新を行うために実行するコマンド群の ファイルを生成します。 コマンドは、適切に編集することなく実行 .Bf Em しないでください .Ef 。 提案として扱うべきであり、 インストール済 package 間の依存関係を考慮に入れるために 順序を入れ換える必要があるかもしれませんし、 複数のインストール済 package を共存させるために 無視する必要があるかもしれません。 本コマンドの出力を内容を確認せずに使用すると、 システムが使えなくなることがあります。 .Pp .Dl % pkg_version -c > do_update .Pp 次のコマンドは、2 個の package バージョン文字列を比較します: .Pp .Dl % pkg_version -t 1.5 1.5.1 .Sh 作者 .An Bruce A. Mah Aq bmah@FreeBSD.org .Sh 寄贈者 .An Nik Clayton Aq nik@freebsd.org , .An Dominic Mitchell Aq dom@palmerharvey.co.uk , .An Mark Ovens Aq marko@FreeBSD.org , .An Doug Barton Aq DougB@gorean.org , .An Akinori MUSHA Aq knu@FreeBSD.org .Sh バグ コマンド出力機能は、ports/packages の自動更新システムでは .Bf Em ありません .Ef 。 インストール済の packages 間の依存関係を正しく扱おうとすらしませんし、 システム上に複数のバージョンの package が共存する場合には 正しくない結果を出力します。 .Pp コマンド出力は、 .Xr pkg_add 1 を使うのではなく、 port システムを使って新しいソフトウェアをインストールすると 仮定しています。 diff --git a/ja_JP.eucJP/man/man1/printenv.1 b/ja_JP.eucJP/man/man1/printenv.1 index 151d47447f..9a4aab0578 100644 --- a/ja_JP.eucJP/man/man1/printenv.1 +++ b/ja_JP.eucJP/man/man1/printenv.1 @@ -1,133 +1,143 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" 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. .\" .\" @(#)printenv.1 8.1 (Berkeley) 6/6/93 -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/printenv.1,v 1.8 2001/07/22 23:09:20 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/printenv/printenv.1,v 1.6.2.9 2002/06/21 15:28:40 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/printenv.1,v 1.8 2001/07/22 23:09:20 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt PRINTENV 1 .Os .Sh 名称 .Nm printenv , env .Nd 環境変数を表示する、環境変数の値を設定、表示する .Sh 書式 .Nm .Op Ar name .Nm env .Op Fl .Op Fl i .Op Ar name Ns = Ns Ar value ... .Op Ar command .Sh 解説 .Nm -は、環境変数の名前と値を、1 行あたりに 1 組の名前と値の形式で表示します。 +ユーティリティは、 +環境変数の名前と値を、1 行あたりに 1 組の名前と値の形式で表示します。 .Ar name が指定されている場合は、その環境変数の値を表示します。 .Pp -もし -.Ar name -で指定された環境変数が定義されていなかった場合、 -.Nm -は戻り値として 1 を返します。それ以外の場合は 0 を返します。 -.Pp シェルによっては、本ユーティリティに似ているまたは同等の、組み込み .Nm コマンドを提供しています。 .Xr builtin 1 マニュアルページを参照してください。 .Pp .Nm env -は、コマンドラインで指定された環境変数の値を変更してから +ユーティリティは、コマンドラインで指定された環境変数の値を変更してから .Ar command を実行します。 引数で .Ar name Ns = Ns Ar value を指定することにより、環境変数 .Ar name の値を .Ar value にセットします。 .Pp オプションは次の通りです: .Bl -tag -width indent .It Fl i 指定された環境変数のみを使用して .Ar command を実行します。 .Nm env から継承した環境変数は無視します。 .It Fl .Fl i オプションと同じですが、後方互換性のためにあります。 .El .Pp .Ar command を指定しないで実行した場合、 .Nm env は すべての環境変数について ``name=value'' の形で環境変数の名前と値を表示 します。 .Pp .Nm env -が有用なのは、 +ユーティリティが有用なのは、 .Dq Li #! 構造とともに使用する場合です ( .Xr execve 2 を参照してください)。 .Dq Li #!/usr/local/bin/foo と .Dq Li "#!/usr/bin/env\ /usr/local/bin/foo" の唯一の違いは、 .Pa /usr/local/bin/foo 自身が解釈される場合でも後者は動作するという点です。 このように .Nm env を使用すると、望み通りに環境を設定できるだけでなく、 .Pa foo をパス無しで参照できます。 +.Sh 診断 +.Ex -std printenv +.Pp +.Ex -std env +終了ステータス 126 は +.Ar command +が見付かったものの実行不可だったことを示します。 +終了ステータス 127 は +.Ar command +が見付からなかったことを示します。 .Sh 関連項目 .Xr csh 1 , .Xr sh 1 , .Xr execvp 3 , .Xr environ 7 +.Sh 規格 +.Nm env +ユーティリティは +.St -p1003.1-2001 +に適合しています。 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 .Sh バグ 理由は明白ですが、 .Nm env -はイコール(``='') 記号が入ったコマンドを実行できません。 +ユーティリティは、イコール (``='') 記号が入ったコマンドを実行できません。 diff --git a/ja_JP.eucJP/man/man1/ps.1 b/ja_JP.eucJP/man/man1/ps.1 index f05a100395..3df2e9c8d3 100644 --- a/ja_JP.eucJP/man/man1/ps.1 +++ b/ja_JP.eucJP/man/man1/ps.1 @@ -1,522 +1,522 @@ .\" Copyright (c) 1980, 1990, 1991, 1993, 1994 .\" The Regents of the University of California. 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 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. .\" .\" @(#)ps.1 8.3 (Berkeley) 4/18/94 -.\" %FreeBSD: src/bin/ps/ps.1,v 1.24.2.6 2002/02/01 14:09:30 ru Exp % +.\" %FreeBSD: src/bin/ps/ps.1,v 1.24.2.7 2002/06/20 22:43:33 charnier Exp % .\" .\" $FreeBSD$ .Dd April 18, 1994 .Dt PS 1 .Os .Sh 名称 .Nm ps .Nd プロセスの状態の表示 .Sh 書式 .Nm .Op Fl aCcefhjlmrSTuvwx .Op Fl M Ar core .Op Fl N Ar system .Op Fl O Ar fmt .Op Fl o Ar fmt .Op Fl p Ar pid .Op Fl t Ar tty .Op Fl U Ar username .br .Nm .Op Fl L .Sh 解説 .Nm -は、制御端末を持つ自分 (あなた) のプロセスの情報を、 +ユーティリティは、制御端末を持つ自分 (あなた) のプロセスの情報を、 ヘッダ行に続いて表示します。 この情報は、制御端末順に整列され、その中ではプロセス .Tn ID 順に整列されます。 .Pp 表示される情報は、一連のキーワードによって選ばれます .Pf ( Fl L , .Fl O , .Fl o オプションを参照)。 デフォルトの出力フォーマットは、各プロセス毎に、 プロセス .Tn ID , 制御端末・cpu 時間 (ユーザ時間とシステム時間の両方)・ プロセス状態・プロセスに関連するコマンドから成ります。 .Pp プロセスファイルシステム ( .Xr procfs 5 参照) は、 .Nm が実行されている時にマウントされているべきです。そうでない場合、 すべての情報が利用可能になるわけではありません。 .Pp オプションを以下に示します。 .Bl -tag -width indent .It Fl a 自分のプロセスに加え自分以外のプロセスの情報も同様に表示します。 この機能は、 .Va kern.ps_showallprocs sysctl を 0 に設定することで無効化できます。 .It Fl c ``コマンド'' 桁の出力を、すべてのコマンドラインを表示するのではなく、 実行形式名だけを表示するように変更します。 .It Fl C cpu パーセンテージの計算を、``常駐'' 時間を無視する ``生'' cpu 時間を使う方法に変更します (通常これは影響ありません)。 .It Fl e 環境 (変数) も同時に表示します。 .It Fl f スワップアウトされたプロセスに関して、 コマンドラインと環境の情報を表示します。 ユーザの uid が 0 である場合のみ、このオプションが有効になります。 .It Fl h ページ毎に 1 つヘッダが入るようにします。 .It Fl j 次のキーワードに関する情報を表示します: user, pid, ppid, pgid, sess, jobc, state, tt, time, command。 .It Fl L 有効なキーワードの一覧を表示します。 .It Fl l 次のキーワードに関する情報を表示します: uid, pid, ppid, cpu, pri, nice, vsz, rss, wchan, state, tt, time, command。 .It Fl M 名前リストの値を取り出すとき、 デフォルトの .Pa /dev/kmem の代わりに、指定した .Ar core から取り出します。 .It Fl m プロセス .Tn ID 順ではなく、メモリ使用量順に整列します。 .It Fl N デフォルトの .Pa /kernel の代わりに、指定された .Ar system から名前リストを取り出します。 .It Fl O デフォルトで表示される情報に加え、 指定されたキーワードに関する情報を、 プロセス .Tn ID の後に挿入する形式で表示します。 各キーワードの後ろには、等号 (``='') と文字列を追加しても構いません。 この場合、標準のヘッダの代わりに指定された文字列が表示されます。 .It Fl o 指定されたキーワードに関する情報を、表示します。 各キーワードの後ろには、等号(``='')と文字列を追加しても構いません。 この場合、標準のヘッダの代わりに指定された文字列が表示されます。 .It Fl p 指定したプロセス .Tn ID に関する情報を表示します。 .It Fl r プロセス .Tn ID 順ではなく、現在の cpu 利用率順に整列します。 .It Fl S プロセス時間を計算するのに、 終了した子プロセスの時間を親プロセスに合計するように変更します。 .It Fl T 標準入力のデバイスに取り付けられたプロセスの情報を表示します。 .It Fl t 指定された端末デバイスに取り付けられたプロセスの情報を表示します。 .It Fl U 指定された .Ar username に属するプロセスを表示します。 .It Fl u 次のキーワードに関する情報を表示します: user, pid, %cpu, %mem, vsz, rss, tt, state, start, time, command。 .Fl u オプションを指定すると .Fl r オプションも暗に指定したことになります。 .It Fl v 次のキーワードに関する情報を表示します: pid, state, time, sl, re, pagein, vsz, rss, lim, tsiz, %cpu, %mem, command。 .Fl v オプションを指定すると .Fl m オプションも暗に指定したことになります。 .It Fl w デフォルトの現行ウィンドウ幅ではなく、132 桁幅で表示します。 一度より多く .Fl w オプションを指定すると、 .Nm はウィンドウ幅にかかわらず、必要なだけの幅を使用します。 .It Fl x 制御端末のないプロセスの情報も表示します。 .El .Pp 有効なキーワードの全リストを以下に示します。 いくつかのキーワードに関してはさらに詳しく述べます。 .Bl -tag -width indent .It %cpu プロセスの cpu 利用率です。実時間で最近 1 分間の減衰平均です。 計算の基点となる時間は変化するので (プロセスはまだ生れたばかりかもしれないので)、 .Tn \&%CPU フィールド全部の合計は 100% を越える可能性もあります。 .It %mem プロセスで使われている実メモリのパーセンテージです。 .It flags インクルードファイル .Aq Pa sys/proc.h でプロセスに定義されたフラグです。 .Bl -column SNOCLDSTOP SNOCLDSTOP .It Dv "P_ADVLOCK" Ta No "0x00001 プロセスは POSIX 提案ロックを保持している" .It Dv "P_CONTROLT" Ta No "0x00002 制御端末を持っている" .It Dv "P_INMEM" Ta No "0x00004 メモリに読み込まれている" .It Dv "P_NOCLDSTOP" Ta No "0x00008 子プロセスが停止しても SIGCHLD を送らない" .It Dv "P_PPWAIT" Ta No "0x00010 親プロセスが、子プロセスが exec/exit するのを待っている" .It Dv "P_PROFIL" Ta No "0x00020 プロファイル付きで実行された" .It Dv "P_SELECT" Ta No "0x00040 select 中; wakeup/waiting は危険である" .It Dv "P_SINTR" Ta No "0x00080 sleep は割り込み可能" .It Dv "P_SUGID" Ta No "0x00100 最後の実行以来、id 特権が設定されている" .It Dv "P_SYSTEM" Ta No "0x00200 システムプロセス: シグナルや stat やスワップが無い" .It Dv "P_TIMEOUT" Ta No "0x00400 sleep 中にタイムアウトした" .It Dv "P_TRACED" Ta No "0x00800 デバッグプロセスはトレースされている" .It Dv "P_WAITED" Ta No "0x01000 デバッグプロセスは子プロセスを待っている" .It Dv "P_WEXIT" Ta No "0x02000 終了動作中" .It Dv "P_EXEC" Ta No "0x04000 プロセスは exec で呼ばれた" .It Dv "P_OWEUPC" Ta No "0x20000 次の ast プロセスが addupc() 呼び出しの借り" .It Dv "P_SWAPPING" Ta No "0x40000 プロセスはスワップされている" .El .It lim .Xr setrlimit 2 の呼び出しで指定される、メモリ使用量のソフトリミットです。 .It lstart コマンドの実行が始まった正確な時刻を、 .Xr strftime 3 に記述された ``%c'' フォーマットで表示します。 .It nice プロセススケジューリングにおける増加値です .Ns ( Xr setpriority 2 参照)。 .\" .Ns により ( と setpriority が離れるのを防ぐ .\" by horikawa@jp.freebsd.org (Feb 9 1997) .It rss プロセスの実メモリ(常駐分)の大きさ(1024バイト単位)です。 .It start コマンドが開始された時間です。 コマンドが開始されたのが 24 時間以内なら、 開始時刻は .Xr strftime 3 で記述された ``%l:ps.1p'' フォーマットで表示されます。 コマンドが開始されたのが 7 日以内なら、 開始時刻は ``%a6.15p'' フォーマットで表示されます。 さもなくば、開始時刻は ``%e%b%y'' フォーマットで表示されます。 .It state プロセスの状態を文字の列で表示します。例えば、 .Dq Tn RWNA の最初の文字は、プロセスが runnable 状態であることを示しています。 .Pp .Bl -tag -width indent -compact .It D プロセスはディスク (あるいは他の割り込み不可能な短期間の) 待ち状態です。 .It I プロセスは idle 状態 (20 秒以上 sleep している) です。 .It J プロセスは .Xr jail 2 中のものです。 牢屋のホスト名は .Ql Li /proc//status に記述されています。 .It R プロセスは runnable 状態です。 .It S プロセスは 20 秒未満の sleep 状態です。 .It T プロセスは stop している状態です。 .It Z プロセスは死んでいる状態 (``ゾンビ'') です。 .El .Pp さらにこの後に文字があれば、さらなる状態情報を示します。 .Pp .Bl -tag -width indent -compact .It + プロセスはその制御端末のフォアグラウンドプロセスグループに属しています。 .It < プロセスは .Tn CPU のスケジュール優先度が上げられています。 .It > プロセスはメモリ要求に対するソフトリミットが指定されており、 現在そのリミットを越えています。 このようなプロセスは (必然的に) スワップされていません。 .It A プロセスはランダムなページ置換 ( .Xr madvise 2 における .Dv MADV_RANDOM のことで、例えば、 .Xr lisp 1 でのガーベージコレクション) を要求しました。 .It E プロセスは終了しようとしています。 .It L プロセスは実メモリ中にロックされたページ (例えば、raw .Tn I/O 用) を持っています。 .It N プロセスは .Tn CPU スケジューリング優先度 ( .Xr setpriority 2 参照) が下げられています。 .It S プロセスは .Tn FIFO ページ置換 ( .Xr madvise 2 における .Dv MADV_SEQUENTIAL のことで、 例えば、仮想記憶の多量のデータを順次アクセスする 大規模画像処理プログラム) を要求しました。 .It s プロセスはセッションリーダです。 .It V プロセスは .Xr vfork 2 の間、一時中断されています。 .It W プロセスはスワップアウトされています。 .It X プロセスはトレースされているか、デバッグされています。 .El .It tt もしあれば、制御端末のパス名の省略形です。 省略形は .Pa /dev/tty に続く 3 文字か、コンソール場合の ``con'' です。 もはやプロセスがその制御端末に到達できない (即ち、revoke された) 場合、 後に ``-'' が付きます。 .It wchan プロセスが待っているイベント (システム内のアドレス)。 数字で表示される時には、アドレスの最初の部分は削られて その結果が 16 進で表示されます。例えば 0x80324000 では 324000 と表示されます。 .El .Pp キーワード command には、 すでに終了しているのに親がまだ wait してくれていない プロセス(即ちゾンビ)は ``'' と表示されます。 終了しようとしてブロックされているプロセスは ``'' と表示されます。 .Nm -は、メモリやスワップ領域を検査して、 +ユーティリティは、メモリやスワップ領域を検査して、 プロセスが生成されたときのファイル名や引数を推測します。 この方法は、本質的に少々信頼できるものではなく、 プロセスはとにかくこの情報を破壊することができます。 だから、表示されるコマンド名や引数をあまり信用しすぎてはなりません。 一方、キーワード ucomm (アカウンティング名) は信用できます。 .Sh キーワード 以下は有効なキーワードとその意味の全リストです。 そのうちいくつかは別名があります。 .Pp .Bl -tag -width sigignore -compact .It %cpu cpu 使用率 (別名 pcpu) .It %mem メモリ使用率 (別名 pmem) .It acflag アカウンティングフラグ (別名 acflg) .It command コマンド名と引数 .It cpu 短期間 cpu 使用係数 (スケジューリング用) .It flags 16 進数のプロセスフラグ (別名 f) .It inblk 総ブロック読み出し数 (別名 inblock) .It jobc ジョブコントロール数 .It ktrace トレース中フラグ .It ktracep トレース中の vnode .It lim メモリ利用のリミット .It logname プロセスを開始したユーザのログイン名 .It lstart 開始時刻 .It majflt 総ページフォールト数 .It minflt 総ページ再生数 .It msgrcv 総メッセージ受信数 (パイプ/ソケットからの読み込み) .It msgsnd 総メッセージ送信数 (パイプ/ソケットへの書き込み) .It nice nice 値 (別名 ni) .It nivcsw 総強制的コンテキストスィッチ数 .It nsigs 総シグナル受け入れ数 (別名 nsignals) .It nswap 総スワップイン/スワップアウト数 .It nvcsw 総自発的コンテキストスィッチ数 .It nwchan wait チャネル (アドレスで表示) .It oublk 総ブロック書き込み数 (別名 oublock) .It p_ru リソース利用量 (ゾンビに対してのみ有効) .It paddr スワップアドレス .It pagein ページイン数 (majflt と同じ) .It pgid プロセスグループ番号 .It pid プロセス .Tn ID .It poip 進行中のページアウト数 .It ppid 親プロセス .Tn ID .It pri スケジューリング優先度 .It re 実メモリ常駐時間 (秒単位; 127 = 無限) .It rgid 実グループ .Tn ID .It rlink run 行列における逆リンク (あるいは 0) .It rss 常駐セットサイズ .It rsz 常駐セットサイズ + (テキストのサイズ/テキストの利用総数) (別名 rssize) .\" つまり、共通テキストを複数プロセスで分担しているわけだ .It rtprio 実時間優先度 (101 = 実時間プロセスではない) .It ruid 実ユーザ .Tn ID .It ruser ユーザ名 (ruid から得られたもの) .It sess セッションポインタ .It sig 遅延されたシグナル (別名 pending) .It sigcatch 捕獲されたシグナル (別名 caught) .It sigignore 無視されたシグナル (別名 ignored) .It sigmask ブロックされたシグナル (別名 blocked) .It sl sleep 時間 (秒単位; 127 = 無限) .It start 開始時刻 .It state 記号でのプロセス状態 (別名 stat) .It svgid setgid プログラムでの saved gid .It svuid setuid プログラムでの saved uid .It tdev 制御端末のデバイス番号 .It time ユーザ + システムの合計 cpu 時間 (別名 cputime) .It tpgid 制御端末プロセスグループ .Tn ID .\".It trss .\"text resident set size (in Kbytes) .\"テキスト常駐セットサイズ(Kbyte単位) .It tsess 制御端末セッションポインタ .It tsiz テキストサイズ (K バイト単位) .It tt 制御端末名 (2 文字の省略形) .It tty 制御端末の完全な名前 .It uprocp プロセスポインタ .It ucomm アカウンティングで使われるコマンド名 .It uid 実効ユーザ .Tn ID .It upr システムコールから帰る時のスケジューリング優先度 (別名 usrpri) .It user ユーザ名 (uid から得たもの) .It vsz k バイト単位の仮想記憶サイズ (別名 vsize) .It wchan wait チャネル (シンボル名で表示) .It xstat 終了ステータスまたは stop ステータス (stop プロセスかゾンビプロセスの時のみに有効) .El .Sh 関連ファイル .Bl -tag -width /var/run/kvm_kernel.db -compact .It Pa /dev/kmem デフォルトのカーネルメモリデバイス .It Pa /var/run/dev.db .Pa /dev 名前データベース .It Pa /var/run/kvm_kernel.db システム (カーネル) の名前リストデータベース .It Pa /kernel デフォルトのシステムの名前リスト .It Pa /proc .Xr procfs 5 のマウントポイント .El .Sh 関連項目 .Xr kill 1 , .Xr w 1 , .Xr kvm 3 , .Xr strftime 3 , .Xr procfs 5 , .Xr pstat 8 , .Xr sysctl 8 .Sh バグ .Nm はシステムより速く実行できず、 他のプロセスと同様にスケジュールされて実行されるので、 表示される情報は正確ではあり得ません。 diff --git a/ja_JP.eucJP/man/man1/pwd.1 b/ja_JP.eucJP/man/man1/pwd.1 index f09a07b22d..55f0280a46 100644 --- a/ja_JP.eucJP/man/man1/pwd.1 +++ b/ja_JP.eucJP/man/man1/pwd.1 @@ -1,79 +1,104 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)pwd.1 8.2 (Berkeley) 4/28/95 -.\" %FreeBSD: src/bin/pwd/pwd.1,v 1.10.2.4 2001/08/16 10:01:07 ru Exp % +.\" %FreeBSD: src/bin/pwd/pwd.1,v 1.10.2.5 2002/06/17 11:04:22 tjr Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/pwd.1,v 1.15 2001/08/17 06:18:10 horikawa Exp $ -.Dd April 28, 1995 +.\" $FreeBSD$ +.Dd February 4, 2002 .Dt PWD 1 .Os .Sh 名称 .Nm pwd .Nd ワーキングディレクトリの表示 .Sh 書式 .Nm +.Op Fl LP .Sh 解説 .Nm -は、現在のワーキングディレクトリを絶対パスで標準出力に出力します。 +ユーティリティは、 +現在のワーキングディレクトリを絶対パスで標準出力に出力します。 .Pp シェルによっては、本ユーティリティと似たまたは同じ、組み込みの .Nm コマンドを提供しているものがあります。 .Xr builtin 1 マニュアルページを参照してください。 +.Pp +オプションは次の通りです: +.Bl -tag -width indent +.It Fl L +論理的な現在のワーキングディレクトリを表示します。 +.It Fl P +物理的な現在のワーキングディレクトリを表示します +(すべてのシンボリックリンクが解決されます)。 +.El +.Pp +オプションを指定しないと、 +.Fl P +オプションが仮定されます。 +.Sh 環境変数 +.Nm +が使用する環境変数は次の通りです: +.Bl -tag -width ".Ev PWD" +.It Ev PWD +論理的な現在のワーキングディレクトリ。 +.El .Sh 診断 .Ex -std .Sh 規格 .Nm -コマンドは -.St -p1003.2 -互換です。 -.Fl L -フラグは、サポートされていません。 +ユーティリティは +.St -p1003.1-2001 +に適合しています。 .Sh 関連項目 .Xr builtin 1 , .Xr cd 1 , .Xr csh 1 , .Xr sh 1 , .Xr getcwd 3 .Sh バグ .Xr csh 1 の内部コマンド .Ic dirs の方が高速です。なぜなら、シェル組み込みだからです。 しかし、まれに違う答えを返します。 それは、シェルでカレントディレクトリに移動した後に、 カレントディレクトリかその祖先ディレクトリが移動 (訳注: mv) された場合です。 +.Pp +.Ev PWD +環境変数をシェルがエクスポートしていない場合、 +.Fl L +オプションは動作しません。 diff --git a/ja_JP.eucJP/man/man1/quota.1 b/ja_JP.eucJP/man/man1/quota.1 index 754925504d..d743cd3f74 100644 --- a/ja_JP.eucJP/man/man1/quota.1 +++ b/ja_JP.eucJP/man/man1/quota.1 @@ -1,140 +1,143 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Robert Elz at The University of Melbourne. .\" .\" 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. .\" .\" @(#)quota.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/quota/quota.1,v 1.7.2.4 2001/08/16 13:17:01 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/quota.1,v 1.8 2001/07/29 05:14:52 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/quota/quota.1,v 1.7.2.5 2002/06/21 15:28:42 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt QUOTA 1 .Os .Sh 名称 .Nm quota .Nd ディスクの使用状況と割り当て制限を表示する .Sh 書式 .Nm .Op Fl g .Op Fl u .Op Fl v | Fl q .Nm .Op Fl u .Op Fl v | Fl q .Ar user .Nm .Op Fl g .Op Fl v | Fl q .Ar group .Sh 解説 .Nm -は、ユーザのディスク使用量と割り当て制限を表示します。デフォルトで -はユーザに対する割り当て制限に関する情報のみが表示されます。 +ユーティリティは、 +ユーザのディスク使用量と割り当て制限を表示します。 +デフォルトではユーザに対する割り当て制限に関する情報のみが表示されます。 .Pp 次のオプションを使用可能です: .Bl -tag -width indent .It Fl g ユーザが所属するグループに対するグループ割り当て制限を表示します。 これに対し、 .Fl u オプションはデフォルトの動作と同じです。 .It Fl v .Nm -は使用していないファイルシステムについても割り当て制限を表示します。 +ユーティリティは、 +使用していないファイルシステムについても割り当て制限を表示します。 .It Fl q 使用量が割り当てを越えたファイルシステムに関する情報だけが含まれる簡潔 なメッセージを表示します。 .El .Pp .Fl g と .Fl u の両方を指定した場合は、(そのユーザの)ユーザ割り当て制限とグループ割 り当て制限の両方が表示されます。 .Pp スーパユーザに限り、 .Fl u オプションとユーザ名を引数に指定して 他のユーザの割り当て制限を見ることができます。 スーパユーザ以外でも自分が所属するグループについては、 .Fl g オプションと .Ar group 引数を指定することで、自分が属するグループの割り当て制限だけは 見ることができます。 .Pp .Fl q オプションは .Fl v オプションより優先されます。 .Pp .Nm -はマウントされている全てのファイルシステムに関して報告しようとします。 +ユーティリティは、 +マウントされている全てのファイルシステムに関して報告しようとします。 ファイルシステムが .Tn NFS を介してマウントされている場合、 .Xr rpc.rquotad 8 .Tn NFS サーバのデーモンと連絡しようとします。 .Tn UFS ファイルシステムでは、 .Nm は .Pa /etc/fstab にて有効にされている必要が有ります。 .Nm が 0 以外の値を返して終了した場合、割り当て制限を越えているファイルシステムが あります。 .Sh 関連ファイル .Bl -tag -width quota.group -compact .It Pa quota.user ファイルシステムのルートディレクトリに置かれたユーザの割り当て制限に関 するデータ .It Pa quota.group ファイルシステムのルートディレクトリに置かれたグループの割り当て制限に 関するデータ .It Pa /etc/fstab ファイルシステムの名前と位置 .El .Sh 歴史 .Nm コマンドは .Bx 4.2 で登場しました。 .Sh 関連項目 .Xr quotactl 2 , .Xr fstab 5 , .Xr edquota 8 , .Xr quotacheck 8 , .Xr quotaon 8 , .Xr repquota 8 , .Xr rpc.rquotad 8 diff --git a/ja_JP.eucJP/man/man1/rlogin.1 b/ja_JP.eucJP/man/man1/rlogin.1 index 7f3c154de3..2e82bb903f 100644 --- a/ja_JP.eucJP/man/man1/rlogin.1 +++ b/ja_JP.eucJP/man/man1/rlogin.1 @@ -1,223 +1,224 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)rlogin.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/rlogin/rlogin.1,v 1.11.2.6 2002/03/19 09:59:17 keramida Exp % +.\" %FreeBSD: src/usr.bin/rlogin/rlogin.1,v 1.11.2.7 2002/06/21 15:28:48 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt RLOGIN 1 .Os .Sh 名称 .Nm rlogin .Nd リモートログイン .Sh 書式 .Nm .Op Fl 468DEKLdx .Op Fl e Ar char .Op Fl i Ar localname .Op Fl k Ar realm .Op Fl l Ar username .Ar host .Sh 解説 .Nm -は、リモートホスト +ユーティリティは、リモートホスト .Ar host 上で端末セッションを開始します。 .Pp .Nm -はまず最初に、以下に述べる Kerberos 認証メカニズムの使用を試みます。 +ユーティリティはまず最初に、 +以下に述べる Kerberos 認証メカニズムの使用を試みます。 もしリモートホストが Kerberos をサポートしていなければ、 標準的な Berkeley .Pa rhosts 認証メカニズムが用いられます。 オプションは以下の通りです: .Bl -tag -width flag .It Fl 4 IPv4 アドレスのみを使用します。 .It Fl 6 IPv6 アドレスのみを使用します。 .It Fl 8 常に 8 ビットの入力データパスを有効にします。 .Fl 8 オプションを指定しなければ、 リモート側のストップ/スタートキャラクタが ^S/^Q の場合を除き、 パリティビットが取り除かれます。 .It Fl D ソケットオプション TCP_NODELAY を有効にします。 ネットワーク負荷を高めますが、対話の応答性が向上します。 .It Fl E いかなるキャラクタもエスケープキャラクタとして認識されないようにします。 .Fl 8 オプションと組み合わせて用いると、 完全に透過的なコネクションとなります。 .It Fl K .Fl K 全ての Kerberos 認証を無効にします。 .It Fl L rlogin セッションを .Dq litout モードで動作させます ( .Xr tty 4 参照)。 .It Fl d リモートホストとの通信に用いる TCP ソケットの ソケットデバッグ機能 ( .Xr setsockopt 2 参照)を有効にします。 .It Fl e エスケープキャラクタを指定します。デフォルトは .Dq ~ です。 指定はリテラルキャラクタあるいは \ennn 形式の 8 進数で行います。 .It Fl i .Fl i オプションにより、認証に使用する別のローカル名を、呼び出し元が指定可能です。 本オプションは、UID 0 のプロセスのみに制限されます。 .It Fl k .Xr krb_realmofhost 3 で決定されるリモートホストの管理領域 (realm) ではなく、指定した管理領域 .Ar realm におけるリモートホスト用チケットを得るように rlogin に要求します。 .\" UNIX MAGAZINE 95/4 および FreeBSD Handbook の日本語訳を参考に、 .\" realm -> 管理領域としています。 .\" Kazuo Horikawa 20 Aug 1997 .It Fl l .Fl l オプションにてリモートログインに別の .Ar username を指定します。 このオプションを指定しないと、ローカルなユーザ名を使用します。 .It Fl x rlogin セッションを通してやりとりされる全てのデータを .Tn DES 暗号化します。 これは応答時間や .Tn CPU 使用率に影響を及ぼしますが、 より高いセキュリティが得られます。 .El .Pp .Dq Ao escape char Ac Ns \&. という形式の行を入力すると、 リモートホストから切断します。 同様に .Dq Ao escape char Ac Ns ^Z という行を入力すると .Nm セッションを中断し、 .Dq Ao escape\ char Ac Ao delayed-suspend\ char Ac を入力すると rlogin の送信部分のみ中断し、リモートシステムからの出力は有効に保ちます。 デフォルトでは はチルダ .Pq Dq ~ であり、 は普通 control-Y .Pq Dq ^Y です。 .Pp エコーは全てリモートサイト側で行われ、(遅延を除き) .Nm は透過的です。 ^S/^Q によるフロー制御や割り込み発生時の入出力のフラッシュは 正しく処理されます。 .Sh KERBEROS 認証 各ユーザはホームディレクトリの .Pa .klogin ファイル中に各個人の認証リストを持つことができます。 このファイルの各行は .Ar principal.instance@realm という形式で Kerberos の principal 名を持っています。 もし最初のユーザが .Pa .klogin 中のある principal 名に認証されれば、 そのアカウントでのアクセスが許可されます。 もし .Pa .klogin ファイルが存在しなければ、次の principal .Ar accountname.@localrealm でのアクセスが許可されます。 これ以外の場合、 .Xr login 1 の場合と同様、リモートマシンにおいてログインとパスワードのプロンプトが 表示されます。 いくつかのセキュリティ問題を回避するため、 .Pa .klogin ファイルはリモートユーザの所有としなければなりません。 .Pp Kerberos 認証に失敗すると、警告メッセージが表示され、 標準的な Berkeley .Nm 方式が用いられます。 .Sh 環境変数 .Nm では以下の環境変数が用いられます: .Bl -tag -width TERM .It Ev TERM ユーザの端末タイプを決定します。 .El .Sh 関連項目 .Xr login 1 , .Xr rsh 1 , .Xr telnet 1 , .Xr setsockopt 2 , .Xr kerberos 3 , .Xr krb_realmofhost 3 , .Xr krb_sendauth 3 , .Xr ruserok 3 , .Xr tty 4 , .Xr auth.conf 5 , .Xr hosts 5 , .Xr hosts.equiv 5 , .Xr rlogind 8 , .Xr rshd 8 .Sh 関連ファイル .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .It Pa /etc/hosts.equiv .It Pa /etc/auth.conf .It Ev $HOME Ns Pa /.rhosts .It Ev $HOME Ns Pa /.klogin .El .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 .Pp IPv6 サポートを WIDE/KAME プロジェクトが追加しました。 .Sh バグ -.Nm rlogin -は近い将来 +.Nm +ユーティリティは近い将来 .Xr telnet 1 に置き換えられるでしょう。 .Pp より多くの環境が引き継がれるべきです。 diff --git a/ja_JP.eucJP/man/man1/rpcgen.1 b/ja_JP.eucJP/man/man1/rpcgen.1 index b42356a464..55be370fb5 100644 --- a/ja_JP.eucJP/man/man1/rpcgen.1 +++ b/ja_JP.eucJP/man/man1/rpcgen.1 @@ -1,506 +1,506 @@ .\" @(#)rpcgen.1 1.35 93/06/02 SMI -.\" %FreeBSD: src/usr.bin/rpcgen/rpcgen.1,v 1.12.2.3 2001/08/16 13:17:01 ru Exp % +.\" %FreeBSD: src/usr.bin/rpcgen/rpcgen.1,v 1.12.2.4 2002/06/21 15:28:50 charnier Exp % .\" Copyright 1985-1993 Sun Microsystems, Inc. .\" .\" $FreeBSD$ .Dd March 28, 1993 .Dt RPCGEN 1 .Os .Sh 名称 .Nm rpcgen .Nd RPC プロトコルコンパイラ .Sh 書式 .Nm .Ar infile .Nm .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 .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 .Op Fl s Ar nettype .Op Fl o Ar outfile .Op Ar infile .Nm .Op Fl n Ar netid .Op Fl o Ar outfile .Op Ar infile .\" .SH AVAILABILITY .\" .LP .\" SUNWcsu .Sh 解説 .Nm -は、ある +ユーティリティは、ある .Tn RPC プロトコルを実現する C コードを生成するツールです。 .Nm への入力は、 .Tn RPC 言語 (遠隔手続き呼び出し言語; Remote Procedure Call Language) として知られる、 C 言語に類似した言語です。 .Pp .Nm -は通常第 1 の書式で使用され、 +ユーティリティは通常第 1 の書式で使用され、 1 つの入力ファイルから 4 つの出力ファイルを生成します。 .\" ↑原文では three output files となっているが、すぐ後ろで 4 つ列挙している。 .\" 原文の誤りと思われる。 97/06/08 J.Sakai 入力ファイル .Ar infile が .Pa proto.x であるとすると、 .Nm はヘッダファイル .Pa proto.h 、 XDR ルーチンファイル .Pa proto_xdr.c 、 サーバ側スタブ .Pa proto_svc.c 、 クライアント側スタブ .Pa proto_clnt.c を作成します。 .Fl T オプションを指定すると、上記に加え、 .Tn RPC ディスパッチテーブル .Pa proto_tbl.i も作成します。 .Pp .Nm -はまた、特定アプリケーション向けにカスタマイズ可能な +ユーティリティはまた、特定アプリケーション向けにカスタマイズ可能な クライアントおよびサーバのサンプルファイルも生成できます。 オプション .Fl \&Sc , .Fl \&Ss , .Fl \&Sm によってそれぞれ、サンプルのクライアント、サーバ、makefile を生成します。 オプション .Fl a を指定するとサンプルを含め全てのファイルを生成します。 入力ファイル .Ar infile が .Pa proto.x の場合、 クライアント側サンプルファイルは .Pa proto_client.c に、 サーバ側サンプルファイルは .Pa proto_server.c に、 そしてサンプル makefile は .Pa makefile.proto に書き出されます。 .Pp 生成されたサーバは、ポートモニタ (例えば .Xr inetd 8 ) で起動することも、 それ自身で起動することもできます。 ポートモニタから起動される場合、 ファイル記述子 .Em 0 を引き渡すトランスポートのためだけの サーバを生成します。 トランスポートの名前は環境変数 .Ev PM_TRANSPORT をセットすることで 指定しなければなりません。 .Nm で作成されたサーバが実行されると、 サーバは環境変数 .Ev NETPATH で指定された全トランスポート用に サーバハンドルを作成します。 .Ev NETPATH が指定されていない場合は、ファイル .Pa /etc/netconfig に記述されている全ての可視トランスポート用にサーバハンドルを作成します。 注意: トランスポートはコンパイル時ではなく実行時に選択されます。 サーバが自分で開始すると、 デフォルトでは自動的にバックグラウンド実行に移ります。 .Em RPC_SVC_FG を定義することで、 サーバをフォアグラウンドで実行させることもできます。 .Pp 第二の書式は、更に洗練された .Tn RPC サーバを生成する特別な機能をもちます。 その特別な機能として、 ユーザが定義した .Em #define と .Tn RPC ディスパッチテーブル のサポートがあります。 .Tn RPC ディスパッチテーブルのエントリには以下のものがあります: .Bl -bullet -offset indent -compact .It その手続きに対応するサービスルーチンへのポインタ .It 入出力引数へのポインタ .It これらのルーチンのサイズ .El サーバはディスパッチテーブルを用いて認証チェックを行い、 それからサービスルーチンを実行することができます。 クライアントライブラリはそれを用いて、 記憶領域管理や XDR データ変換の詳細に対処することができます。 .Pp 上に示した他の 3 つの書式は、出力ファイルの全てではなく、 そのうちの特定のものだけを生成したい場合に用いられます。 .Nm の使用例については下の .Sx 使用例 のセクションを参照して下さい。 .Fl s オプション付きで実行されると、 .Nm は特定のトランスポートクラス用のサーバを生成します。 .Fl n オプション付きで実行されると、 .Nm は .Ar netid で指定されたトランスポート用サーバを生成します。 .Ar infile が指定されない場合、 .Nm は標準入力から入力を受け付けます。 .Pp 入力ファイルは、実際に .Nm に処理される前に、 C プリプロセッサ .Em cc -E で処理されます。 .Nm は、出力ファイルの各タイプ毎に .Nm プログラマ向けの特別なプリプロセッサシンボルを定義します: .Bl -tag -width indent .It RPC_HDR ヘッダをコンパイルする際に定義されます .It RPC_XDR XDR ルーチンをコンパイルする際に定義されます .It RPC_SVC サーバ側スタブをコンパイルする際に定義されます .It RPC_CLNT クライアント側スタブをコンパイルする際に定義されます .It RPC_TBL RPC ディスパッチテーブルをコンパイルする際に定義されます .El .Pp .Dq % で始まる行は全て、 .Nm に解釈されることなく、 出力ファイルに直接引き継がれます。 C プリプロセッサのパス名を指定するには .Fl Y フラグを使用して下さい。 .Pp .Ar infile で参照される全てのデータ型に対し、 .Nm は、そのデータ型名の前に .Em xdr_ を付与した名前の ルーチンが存在することを仮定します。 このルーチンが .Tn RPC/XDR ライブラリ中に存在しない場合は、 それを提供しなければなりません。 未定義データ型を提供することで .Xr xdr 3 ルーチンをカスタマイズすることが可能です。 .Sh オプション オプションは以下の通りです: .Bl -tag -width indent .It Fl a サンプルファイルを含め、全てのファイルを生成します。 .It Fl b 従来互換モード。 以前のバージョンの OS のために、トランスポート固有の .Tn RPC コードを生成します。 .Pp 注: .Fx ではこの互換フラグはデフォルトで有効になっています。 .Fx は以前の .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 と定義されます。 このオプションは複数回の指定が可能です。 .It Fl h C のデータ定義 (ヘッダファイル) をコンパイル出力します。 同時に .Fl T オプションを指定することで、 .Tn RPC ディスパッチテーブルをサポートするヘッダファイルを生成できます。 .It Fl i Ar size インラインコードを生成し始めるサイズを指定します。 最適化を行う際に用いられます。デフォルト値は 5 です。 .Pp 注: .Fx プラットホームでの以前の .Nm と互換性を保つため、デフォルト値は実際には 0 (つまり、 デフォルトではインラインコードは生成しない) となっています。 このデフォルト値を上書きするには明示的にゼロ以外の値を 指定しなければなりません。 .It Fl I サーバ側スタブにおける .Xr inetd 8 サポートコードを生成します。 このようにして生成したサーバは、単独で起動することも、 .Nm inetd から起動することもできます。 単独で起動した場合、デフォルトでは自らバックグラウンド動作に移ります。 特殊シンボル .Em RPC_SVC_FG を定義するか、 単に .Fl I オプションなしでコンパイルすると、 サーバプロセスはフォアグラウンドで動作します。 .Pp クライアントからの未処理リクエストがなければ、 .Nm inetd サーバは 120 秒 (デフォルト値) 経過の後、終了します。 このデフォルト値は .Fl K オプションにより変更できます。 .Nm inetd サーバの全エラーメッセージは常に .Xr syslog 3 によってログに残されます。 .\" .IP .\" Note: .\" this option is supported for backward compatibility only. .\" By default, .\" .B rpcgen .\" generates servers that can be invoked through portmonitors. .Pp .It Fl K Ar seconds デフォルトでは、 .Nm を用いて作成され、ポートモニタから起動された サービスは、リクエストを処理した後 120 秒待って終了します。 この時間は .Fl K オプションを用いて変更できます。 リクエスト処理が済むと直ちに終了するようなサーバを生成するには、 .Fl K Ar 0 と指定します。また、決して終了しないサーバを生成するには、 .Fl K Ar -1 として下さい。 .Pp サーバをモニタする場合、 あるサービスリクエストに対して .Em 常に 新しいプロセスを生成するようなポートモニタがあります。 そのようなモニタを用いてサーバを使用することがわかっている場合は、 サーバは処理完了後直ちに終了すべきです。 そのようなサーバを生成するには、 .Nm は .Fl K Ar 0 オプションとともに使用すべきです。 .It Fl l クライアント側スタブをコンパイル出力します。 .It Fl L サーバがフォアグラウンドで起動された場合、 サーバのエラーを記録するのに、標準エラー出力に出力する代わりに .Xr syslog 3 を使用します。 .It Fl m サーバ側スタブをコンパイル出力しますが、 .Qq main ルーチンは生成しません。 コールバックルーチンのみを作成したり、初期化を行うために 独自の .Qq main ルーチンを必要とする場合に便利です。 .It Fl M rpcgen が生成したコードとユーザが書いたコードの間で 引数や結果を受渡しするために、 マルチスレッド対応の (MT-safe な) スタブを生成します。 ユーザプログラム中でスレッドを使用する場合に有用です。 しかし関数 .Xr rpc_svc_calls 3 はまだ MT-safe にはなっていません。 つまり rpcgen が生成したサーバ側コードは MT-safe ではありません。 .It Fl N 手続きが複数の引数を持てるようにします。 これはまた、C 言語に大変似たパラメータ渡し方法を用います。 ですから遠隔手続きにある引数を渡す場合、 その引数へのポインタを渡す必要はなく、引数そのものを渡せます。 この動作は .Nm が生成したコードの以前の振る舞いとは異なっています。 以前との互換性を保つため、このオプションはデフォルトでは有効ではありません。 .It Fl n Ar netid .Ar netid で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 netconfig データベースには .Ar netid 用エントリが存在しなければなりません。 このオプションを複数回指定することで、 複数のトランスポートに対してサービスするサーバを作成することができます。 .It Fl o Ar outfile 出力ファイル名を指定します。 何も指定されなければ標準出力が用いられます ( .Fl c , .Fl h , .Fl l , .Fl m , .Fl n , .Fl s , .Fl \&Sc , .Fl \&Sm , .Fl \&Ss , .Fl t モード時のみ)。 .It Fl s Ar nettype クラス .Ar nettype に属する全てのトランスポート用の サーバ側スタブをコンパイル出力します。 サポートされているクラスは以下の通りです: .Em netpath , .Em visible , .Em circuit_n , .Em circuit_v , .Em datagram_n , .Em datagram_v , .Em tcp , .Em udp (これらのクラスの意味については .Xr rpc 3 を参照して下さい) このオプションは複数回指定できます。 注: トランスポートはコンパイル時ではなく実行時に選択されます。 .It Fl \&Sc 遠隔手続き呼び出しを用いるサンプルクライアントコードを生成します。 .It Fl \&Sm アプリケーションをコンパイルする際に用いるサンプル .Pa Makefile を生成します。 .It Fl \&Ss 遠隔手続き呼び出しを用いるサンプルサーバコードを生成します。 .It Fl t .Tn RPC ディスパッチテーブルをコンパイル出力します。 .It Fl T .Tn RPC ディスパッチテーブルをサポートするコードを生成します。 .Pp ある特定のタイプのファイルを生成するために、 以下のオプション .Fl c , .Fl h , .Fl l , .Fl m , .Fl s , .Fl \&Sc , .Fl \&Sm , .Fl \&Ss , .Fl t は排他的に使用されます。 他方、オプション .Fl D と .Fl T は大域的であり、他のオプションと組み合わせて使用できます。 .It Fl Y Ar pathname .Nm が C プリプロセッサを探し始めるディレクトリ名を指定します。 .El .Sh 使用例 以下の例: .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 のデータ定義 (ヘッダ) を標準出力に出力します。 .Dl example% rpcgen -h prot.x .Pp .Fl D Ns Ar TEST のテストバージョンを作成するため、 クラス .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) .Rs .%T NETP マニュアルの rpcgen の章 .Re diff --git a/ja_JP.eucJP/man/man1/rs.1 b/ja_JP.eucJP/man/man1/rs.1 index d67eb9901d..9ba50ff493 100644 --- a/ja_JP.eucJP/man/man1/rs.1 +++ b/ja_JP.eucJP/man/man1/rs.1 @@ -1,234 +1,234 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)rs.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.bin/rs/rs.1,v 1.4.2.4 2001/07/22 12:40:32 dd Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/rs.1,v 1.6 2001/05/14 01:07:28 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/rs/rs.1,v 1.4.2.5 2002/06/21 15:28:55 charnier Exp % +.\" $FreeBSD$ .\" .Dd December 30, 1993 .Dt RS 1 .Os .Sh 名称 .Nm rs .Nd データ配列の整形 .Sh 書式 .Nm .Oo .Fl Oo Cm csCS Oc Ns Op Ar x .Oo Cm kKgGw Oc Ns Op Ar N .Cm tTeEnyjhHmz .Oc .Op Ar rows Op Ar cols .Sh 解説 .Nm -は標準入力を読み込み、 +ユーティリティは標準入力を読み込み、 その各行が、配列を空白で区切った行ベクトルであるとして解釈し、 その配列をオプションに従って変換し、 結果を標準出力に書き出します。 引数を指定しない場合、 .Nm は、端末で見やすいように、入力をカラム形式 (columnar format) に変換します。 .Pp 入力配列の形状は、その行数と第 1 行目のカラム数から推測します。 それが不都合なら、 .Fl k オプションによって最初の数行を読み飛ばし、 より好都合な行を用いることもできます。 この他のオプションは、入力カラムの解釈を変更するものです。 .Pp 出力配列の形状は引数 .Ar rows および .Ar cols の指定により変化します。これらの引数は正の整数です。 それらの一方だけが正の整数である場合、 .Nm はデータ全体と整合するもう一方の値を計算します。 必要なら、オプションの説明に述べる方法で不足したデータが追加され、 余剰データが削除されます。 行と列の転置など、出力カラム形式を変更するオプションもあります。 .Pp オプションを以下に示します。 .Bl -tag -width indent .It Fl c Ns Ar x 入力カラムの区切りを単一文字 .Ar x とします。 .Ar x を省略すると `^I' であると見なされます。 .It Fl s Ns Ar x .Fl c と似ていますが、 .Ar x 中の最長文字列が区切りとされます。 .It Fl C Ns Ar x 出力カラムの区切りを単一文字 .Ar x とします。 .Ar x を省略すると `^I' であると見なされます。 .It Fl S Ns Ar x .Fl C と似ていますが、文字列 .Ar x が区切り文字となります。 .It Fl t 入力配列の列データを用いて出力配列の行を埋めます。 つまり、 .Ar rows および .Ar cols 指定を優先しつつ、入力を転置します。 .It Fl T .Ar rows および .Ar cols 指定を無視し、入力の純粋な転置結果を出力します。 .It Fl k Ns Ar N 入力の最初の .Ar N 行を無視します。 .It Fl K Ns Ar N .Fl k と似ていますが、無視した各行を表示します。 .It Fl g Ns Ar N 溝 (gutter) の幅 (カラム間のスペース) を .Ar N とします。 通常は 2 です。 .It Fl G Ns Ar N 溝 (gutter) の幅 (カラム間のスペース) として、 最大カラム幅の .Ar N パーセント増しの値を用います。 .It Fl e 入力の各行を単一の配列エントリとみなします。 .It Fl n 第 1 行目より少ないエントリしかない行があれば、 その行にヌルエントリを追加して埋め合わせます。 通常は、エントリの不足分は入力の次の行からエントリをとって埋め合わせます。 .It Fl y 出力の寸法を充たすだけのエントリがない場合、 入力を最初から繰り返し用いて出力を埋め合わせます。 通常は、出力は空白で埋め合わされます。 .It Fl h 入力配列の形状を表示するだけで、処理は何も行ないません。 形状とは単に、行数と、第 1 行目のエントリ数のことです。 .It Fl H .Fl h と似ていますが、各行の長さも表示します。 .It Fl j カラム内でエントリを右揃えにします。 .It Fl w Ns Ar N 画面表示幅を正整数 .Ar N の値に設定します。 通常は 80 です。 .It Fl m 出力配列の末尾から余分な区切り文字を削除しません。 .It Fl z カラム幅を最も大きなエントリにあわせます。 .El .Pp 引数がない場合、 .Nm は入力を転置し、 無視しない最初の行が画面表示幅を越えていなければ、 入力の各行毎に 1 つの配列エントリがあると仮定します。 数値引数をとるオプションで数値指定が省略されていると、 別途指示がない限り数値は 0 とみなされます。 .Sh 使用例 .Nm -はいくつかのプログラム (例えば、 +ユーティリティはいくつかのプログラム (例えば、 .Xr spell , .Xr du , .Xr file , .Xr look , .Xr nm , .Xr who , .Xr wc 1 ) のストリーム出力を、好都合な「ウィンドウ」形式に変換する フィルタとして利用できます。例えば .Bd -literal -offset indent who | rs .Ed .Pp これと同様な出力を行なうほとんどのプログラムに対して .Nm は十分な機能を提供しますが、 .Xr ls 1 には既にこの機能が組み込まれています。 .Pp ストリーム入力をベクトルに変換して出力し、それをまた元に戻すには、 次のようにします。 .Bd -literal -offset indent rs 1 0 | rs 0 1 .Ed .Pp 各要素が 1 から 100 までの乱数から成る 10×10 行列とその転置行列を 生成するには、以下のようにします。 .Bd -literal -offset indent jot \-r 100 | rs 10 10 | tee array | rs \-T > tarray .Ed .Pp .Xr vi 1 エディタにおいて、行あたり 9 要素の複数行ベクトルからなるファイルに対して 挿入や削除を行ない、 その後 9 カラム形式に整形するには、次のようにします。 .Bd -literal -offset indent :1,$!rs 0 9 .Ed .Pp 最後に、 あるデータベースを 4 行ずつのフィールドの最初の行でソートしたいなら、 以下のようにしてみるとよいでしょう。 .Bd -literal -offset indent rs \-eC 0 4 | sort | rs \-c 0 1 .Ed .Sh 関連項目 .Xr jot 1 , .Xr pr 1 , .Xr sort 1 , .Xr vi 1 .Sh バグ .Bl -item .It 2 次元配列しか扱えません。 .It 現在のアルゴリズムはファイル全体をメモリに読み込むため、 メモリに入りきらないファイルは整形できません。 .It 文字位置によってフィールドを定義することは、まだできません。 .It カラムを並べ換えることも、まだ不可能です。 .It オプションが多すぎます。 .El diff --git a/ja_JP.eucJP/man/man1/rsh.1 b/ja_JP.eucJP/man/man1/rsh.1 index 07d518039f..7d85f91b9b 100644 --- a/ja_JP.eucJP/man/man1/rsh.1 +++ b/ja_JP.eucJP/man/man1/rsh.1 @@ -1,202 +1,202 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)rsh.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/rsh/rsh.1,v 1.11.2.4 2001/08/16 13:17:01 ru Exp % +.\" %FreeBSD: src/usr.bin/rsh/rsh.1,v 1.11.2.5 2002/06/21 15:28:58 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/rsh.1,v 1.13 2001/07/29 05:14:52 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt RSH 1 .Os .Sh 名称 .Nm rsh .Nd リモートマシン上でコマンドを実行する .Sh 書式 .Nm .Op Fl 46Kdnx .Op Fl t Ar timeout .Op Fl k Ar realm .Op Fl l Ar username .Ar host .Op command .Sh 解説 .Nm -は +ユーティリティは、 .Ar host で指定したホスト上で、 .Ar command で指定したコマンドを実行します。 .Pp .Nm -は、標準入力をリモートコマンドに対してコピーします。また、リモートコマンドの -標準出力を、 +ユーティリティは、標準入力をリモートコマンドに対してコピーします。 +また、リモートコマンドの標準出力を、 .Nm の標準出力に、リモートコマンドの標準エラー出力を、 .Nm の標準エラー出力にコピーします。 SIGINT, SIGQUIT, SIGTERM の各シグナルに関しては、 リモートコマンドに対して通知されます。 .Nm は、リモートコマンドが正常終了した場合には正常終了します。本コマンドは、 以下のオプションが使用可能です。 .Bl -tag -width flag .It Fl 4 IPv4 アドレスのみを使用します。 .It Fl 6 IPv6 アドレスのみを使用します。 .It Fl K Keroberos による全てのユーザ認証を行いません。 .It Fl d .Nm は .Xr setsockopt 2 を用いて、リモートホストとの通信に用いられる .Tn TCP ソケットのデバッグを有効にします。 .It Fl k Ar realm .Nm はリモートホストに対して .Xr krb_realmofhost 3 によって定義されるリモートホストの realm の代わりに、指定した .Ar realm を使用して、リモートホストに対してのアクセス許可を得ます。 .It Fl l Ar username リモートの .Ar username を指定可能です。 デフォルトでは、ローカルユーザ名とリモートホスト上のユーザ名は同じです。 ユーザ認証には .Xr rlogin 1 と同様の仕組みにより Kerberos によるユーザ認証機構が使われます。 .It Fl n .Nm の入力を、特殊デバイス .Pa /dev/null にします( .Sx バグ の項を参照してください)。 .It Fl x すべてのデータ交換に .Tn DES による暗号化を有効にします。これを用いると レスポンスが著しく悪くなるかも知れません。 .It Fl t Ar timeout .Fl t オプションは、(秒で表現される) .Ar timeout を指定します。この時間の間、 データが送られも受け取りもされない場合、 .Nm は終了します。 .El .Pp .Ar command が指定されない場合には、ユーザは .Xr rlogin 1 を用いてリモートホストにログインします。 .Pp クォートされていないシェルのメタキャラクタについては、ローカルマシン上 で解釈され、クォートされているメタキャラクタはリモートホスト上で解釈 されます。例えば、 .Pp .Dl rsh otherhost cat remotefile >> localfile .Pp については、リモートマシン上のファイル .Ar remotefile を、ローカルマシン上のファイル .Ar localfile に追加します。一方 .Pp .Dl rsh otherhost cat remotefile \&">>\&" other_remotefile .Pp については、リモートマシン上の .Ar remotefile を .Ar other_remotefile に追加します。 .\" .Pp .\" Many sites specify a large number of host names as commands in the .\" directory /usr/hosts. .\" If this directory is included in your search path, you can use the .\" shorthand ``host command'' for the longer form ``rsh host command''. .Sh 関連ファイル .Bl -tag -width /etc/hosts -compact .It Pa /etc/hosts .It Pa /etc/auth.conf .El .Sh 関連項目 .Xr rlogin 1 , .Xr setsockopt 2 , .Xr kerberos 3 , .Xr krb_realmofhost 3 , .Xr krb_sendauth 3 , .Xr rcmd 3 , .Xr ruserok 3 , .Xr auth.conf 5 , .Xr hosts 5 , .Xr hosts.equiv 5 , .Xr rlogind 8 , .Xr rshd 8 .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 .Sh バグ .Xr csh 1 を用いて .Nm を標準入力からのリダイレクトなしにバックグラウンドで実行する場合、 たとえリモートコマンドの入力がなくても(必ず)ブロックされるでしょう。 リダイレクトで .Nm に入力を渡す必要がなければ、 .Fl n オプションを用いてリモートコマンドの入力元を .Pa /dev/null に切り替えてください。 .Pp .Nm を用いて、 .Xr rogue 6 や .Xr vi 1 のような会話的コマンドを実行することはできません。 代わりに .Xr rlogin 1 を使用してください。 .Pp SIGSTOP は、ローカルマシンの .Nm プロセスを停止させるだけです。これはおそらく良くない動作です. しかし、これを直すことは、現時点では困難です。ここでその理由を説明す るにはあまりに複雑なので、理由については割愛します。 diff --git a/ja_JP.eucJP/man/man1/rtprio.1 b/ja_JP.eucJP/man/man1/rtprio.1 index 72a5a73740..d4c0875cfe 100644 --- a/ja_JP.eucJP/man/man1/rtprio.1 +++ b/ja_JP.eucJP/man/man1/rtprio.1 @@ -1,202 +1,202 @@ .\" .\" Copyright (c) 1994, Henrik Vestergaard Draboel .\" 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 Henrik Vestergaard Draboel. .\" 4. 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 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. .\" -.\" %FreeBSD: src/usr.sbin/rtprio/rtprio.1,v 1.19.2.3 2001/07/22 12:41:30 dd Exp % +.\" %FreeBSD: src/usr.sbin/rtprio/rtprio.1,v 1.19.2.4 2002/06/21 16:42:31 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/rtprio.1,v 1.15 2001/05/14 01:07:28 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd July 23, 1994 .Dt RTPRIO 1 .Os .Sh 名称 .Nm rtprio , .Nm idprio .Nd リアルタイム/アイドルタイムスケジューリング優先度の実行・確認・修正 .Sh 書式 .Nm [id|rt]prio .Nm [id|rt]prio .Oo Fl Oc Ns Ar pid .Nm [id|rt]prio .Ar priority .Ar command .Op args .Nm [id|rt]prio .Ar priority .Fl Ar pid .Nm [id|rt]prio .Fl t .Ar command .Op args .Nm [id|rt]prio .Fl t .Fl Ar pid .Sh 解説 .Nm -はリアルタイムプロセススケジューリングに使用します。 +ユーティリティはリアルタイムプロセススケジューリングに使用します。 .Pp .Nm idprio -はアイドルタイムプロセススケジューリングに使用し、 +ユーティリティはアイドルタイムプロセススケジューリングに使用し、 .Nm と同じオプションにて使用します。 .Pp リアルタイム優先度のプロセスは優先度低下対象とはならず、 同じもしくはそれ以上のリアルタイム優先度のプロセスのみに横取りされます。 .Pp アイドル優先度のプロセスは、 実行可能な他のプロセスが存在せず、 優先度が同じもしくはより高い実行可能なアイドル優先度プロセスが存在しない 場合のみ実行します。 .Pp .Nm と .Nm idprio を引数無しで実行すると、現在のプロセスのリアルタイム優先度を表示します。 .Pp .Nm を引数 1 つと共に実行すると、指定した .Ar pid のリアルタイム優先度を返します。 .Pp .Ar priority を指定すると、プロセスまたはプログラムをリアルタイム優先度にて実行します。 .Fl t を指定すると、プロセスまたはプログラムを通常のプロセス (非リアルタイムプロセス) として実行します。 .Pp .Ar -pid を指定すると、 .Ar pid をプロセス識別子として持つプロセスを修正します。 そうではなく、 .Ar command を指定すると、プログラムを引数付きで実行します。 .Pp .Ar priority は 0 から RTP_PRIO_MAX (通常 31) の整数値です。 0 は最高の優先度です。 .Pp .Ar pid に 0 を指定すると "現在のプロセス" を意味します。 .Pp root のみがリアルタイム優先度およびアイドル優先度を設定可能です。 .Sh 診断 .Nm がコマンドを実行した場合、このコマンドの終了値が終了値となります。 その他の場合、 .Nm は成功時には 0 を、エラー時には 1 を終了値とします。 .Sh 使用例 現在のプロセスのリアルタイム優先度を見ます: .Bd -literal -offset indent -compact .Sy "rtprio" .Ed .Pp プロセス .Em 1423 のリアルタイム優先度を見ます: .Bd -literal -offset indent -compact .Sy "rtprio 1423" .Ed .Pp .Xr cron 8 を最低のリアルタイム優先度にて実行します: .Bd -literal -offset indent -compact .Sy "rtprio 31 cron" .Ed .Pp プロセス .Em 1423 のリアルタイム優先度を .Em 16 に変更します: .Bd -literal -offset indent -compact .Sy "rtprio 16 -1423" .Ed .Pp .Xr tcpdump 1 を非リアルタイム優先度にて実行します: .Bd -literal -offset indent -compact .Sy "rtprio -t tcpdump" .Ed .Pp リアルタイム優先度のプロセス .Em 1423 を .Dv RTP_PRIO_NORMAL (非リアルタイム/通常の優先度) に変更します: .Bd -literal -offset indent -compact .Sy "rtprio -t -1423" .Ed .Pp 他のマシンの使用の邪魔をせずに make depend します: .Bd -literal -offset indent -compact .Sy "idprio 31 make depend" .Ed .Sh 関連項目 .Xr nice 1 , .Xr ps 1 , .Xr rtprio 2 , .Xr setpriority 2 , .Xr nice 3 , .Xr renice 8 .Sh 歴史 .Nm は .Fx 2.0 から登場しましたが、HP-UX のものに似たバージョンでした。 .Sh 警告 CPU を大量消費するプロセスをリアルタイム優先度で実行すると システムを操作できなくなります。 .Sh バグ プロセス 0 (swapper) のリアルタイム優先度を設定及び確認する方法は有りません ( .Xr ps 1 を参照)。 .Pp .Fx ではプロセスのページがメモリ中に存在することを保証できないため、 プロセスがページインのために停止することが有ります ( .Xr mprotect 2 , .Xr madvise 2 参照)。 .Pp .Fx では、今のところシステムコール内で実行権を横取りされることはありません。 非リアルタイムプロセスが実行中であるために リアルタイムプロセスに実行権が割り当てられないことや、 アイドルプロセスが実行中であるために 通常優先度プロセスに実行権が割り当てられないことがあります。 .Sh 作者 .An -nosplit .An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk はオリジナルの作者です。 .An David Greenman が .Fx への実装時に、ほとんどを書き直しました。 diff --git a/ja_JP.eucJP/man/man1/rup.1 b/ja_JP.eucJP/man/man1/rup.1 index 445d4b3e94..1d1bc8a286 100644 --- a/ja_JP.eucJP/man/man1/rup.1 +++ b/ja_JP.eucJP/man/man1/rup.1 @@ -1,97 +1,97 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1985, 1991 The Regents of the University of California. .\" 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 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. .\" -.\" %FreeBSD: src/usr.bin/rup/rup.1,v 1.7.2.6 2001/08/16 13:17:02 ru Exp % +.\" %FreeBSD: src/usr.bin/rup/rup.1,v 1.7.2.7 2002/06/21 15:29:00 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/rup.1,v 1.10 2001/08/17 06:18:10 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 7, 1993 .Dt RUP 1 .Os .Sh 名称 .Nm rup .Nd ローカルネットワーク上のマシンの現在のシステム状態を表示する .Sh 書式 .Nm .Op Ar host ... .Sh 解説 .Nm -は、特定の +ユーティリティは、特定の .Ar host 、もしくはローカルネットワーク上のすべてのマシンについて、 現在のシステム状態を表示します。コマンド出力には、現在時刻、システムが立ち上 がってからの経過時間、そしてロードアベレージが表示されます。ロードアベレージ は、実行キューにつながれているジョブの数を、過去 1 分、5 分、15 分間にわたって 平均化したものです。 .Pp 本コマンドを使用する場合、対象ホスト上で .Xr rpc.rstatd 8 デーモンが起動している必要があります。 .Nm -は +ユーティリティは .Pa /usr/include/rpcsvc/rstat.x に定義されている RPC プロトコルを 使用します。 .Sh 使用例 .Bd -literal example% rup otherhost otherhost 7:36am up 6 days, 16:45, load average: 0.20, 0.23, 0.18 example% .Ed .Sh 診断 .Bl -diag .It rup: RPC: Program not registered rup の対象となるリモートホスト上で .Xr rpc.rstatd 8 が動作していません。 .It rup: RPC: Timed out 通信エラーが発生しました。ネットワークが極端に混雑しているか、 .Xr rpc.rstatd 8 がリモートホスト上で異常終了しました。 .It rup: RPC: Port mapper failure - RPC: Timed out リモートホスト上で portmapper ( .Xr portmap 8 参照) が動作しておらず、 RPC ベースのサービスが受けられません。ホストがダウンしている可能性が あります。 .El .Sh 関連項目 .Xr portmap 8 , .Xr rpc.rstatd 8 .Sh 歴史 .Nm コマンドは .Tn SunOS から登場しました。 .Sh バグ ソート用のオプションは実装されていません。 diff --git a/ja_JP.eucJP/man/man1/ruptime.1 b/ja_JP.eucJP/man/man1/ruptime.1 index 888da9c9c8..d9c2cb4622 100644 --- a/ja_JP.eucJP/man/man1/ruptime.1 +++ b/ja_JP.eucJP/man/man1/ruptime.1 @@ -1,87 +1,87 @@ .\" Copyright (c) 1983, 1990 The Regents of the University of California. .\" 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 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. .\" .\" @(#)ruptime.1 8.2 (Berkeley) 4/5/94 -.\" %FreeBSD: src/usr.bin/ruptime/ruptime.1,v 1.8.2.4 2001/08/16 13:17:02 ru Exp % +.\" %FreeBSD: src/usr.bin/ruptime/ruptime.1,v 1.8.2.5 2002/06/21 15:29:03 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ruptime.1,v 1.9 2001/07/29 05:14:52 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd April 5, 1994 .Dt RUPTIME 1 .Os .Sh 名称 .Nm ruptime .Nd ローカルネットワーク上の各マシンについて uptime と同様のステータスを表示する .Sh 書式 .Nm .Op Fl alrtu .Sh 解説 .Nm -は、ローカルネットワーク上に接続された全マシンについて、 +ユーティリティは、ローカルネットワーク上に接続された全マシンについて、 .Xr uptime 1 と同様の表示を行ないます。この表示は、ネットワーク上の各ホストから 3 分ごとに ブロードキャストされるパケットをもとに作成されます。 .Pp 状態レポートのブロードキャストが 11 分以上途切れているホストについては、 システムダウンしているものとみなします。 4 日以上状態レポートを受け取らないホストについては、まったく表示しません。 .Pp 以下のオプションが使用可能です。 .Bl -tag -width Ds .It Fl a すべてのユーザを含めます。 デフォルトでは、ユーザが 1 時間以上システムへ入力しなかった場合、 そのユーザは出力から省略されます。 .It Fl l ロードアベレージ順にソートします。 .It Fl r ソート順を逆にします。 .It Fl t uptime 順にソートします。 .It Fl u ユーザ数の順にソートします。 .El .Pp デフォルトではリストをホスト名でソートします。 .Sh 関連ファイル .Bl -tag -width /var/rwho/whod.* -compact .It Pa /var/rwho/whod.* データファイル .El .Sh 関連項目 .Xr rwho 1 , .Xr uptime 1 , .Xr rwhod 8 .Sh 歴史 .Nm -は +ユーティリティは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/script.1 b/ja_JP.eucJP/man/man1/script.1 index deca6cfd7d..32129cea95 100644 --- a/ja_JP.eucJP/man/man1/script.1 +++ b/ja_JP.eucJP/man/man1/script.1 @@ -1,147 +1,149 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)script.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/script/script.1,v 1.12.2.3 2001/08/16 13:17:03 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/script.1,v 1.12 2001/07/29 05:14:52 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/script/script.1,v 1.12.2.4 2002/06/21 15:29:06 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt SCRIPT 1 .Os .Sh 名称 .Nm script .Nd 端末上に表示したすべてのもののログをとる .Sh 書式 .Nm .Op Fl a .Op Fl k .Op Fl q .Op Fl t Ar time .Op Ar file Op command ... .Sh 解説 .Nm -は、端末上に表示したすべてのもののログ (typescript) をとります。記録後に +ユーティリティは、 +端末上に表示したすべてのもののログ (typescript) をとります。 +記録後に .Xr lpr 1 で印刷することもできるので、 学生の宿題の証明等で対話的セッションのハードコピー が必要なときなどには有効です。 .Pp .Ar file が指定されていればそのファイルに、指定されていなければ .Pa typescript というファイル名で記録されます。 .Pp 引数 .Ar command ... を指定すると、 .Nm は対話シェルの代りに指定したコマンドをオプションの引数ベクタ付きで実行します。 .Pp オプションとしては以下のものがあります: .Bl -tag -width xxxxxxx .It Fl a .Ar file もしくは .Pa typescript がすでに存在している場合には、それに追加する形で記録していきます。 .It Fl k 出力だけでなくプログラムに送られたキー入力も記録します。 .It Fl q 静かなモードで実行します。開始時と終了時のステータスメッセージを省略します。 .It Fl t Ar time スクリプト出力ファイルにフラッシュする間隔を指定します。 値 0 を指定すると .Nm は文字 I/O イベントごとにフラッシュします。 デフォルトのフラッシュ間隔は 30 秒です。 .El .Pp .Nm は、フォークしたシェル(またはコマンド)を終了したとき ( Bourne シェル .Pf ( Xr sh 1 ) なら .Em control-D で終了しますし、 C シェル .Xr csh 1 なら .Em exit , .Em logout , .Em control-D ( .Em ignoreeof が設定されていない場合) で終了します ) に記録を終わります。 .Pp .Xr vi 1 などのある種の対話コマンドでは、ログファイルにゴミが入る ことがあります。 .Nm -は、画面を操作しないようなコマンドについては、うまく動作します。 +ユーティリティは、画面を操作しないようなコマンドについては、うまく動作します。 出力結果はハードコピー端末のエミュレーションと言えるでしょう。 .Sh 環境変数 .Nm は次の環境変数を使用します: .Bl -tag -width SHELL .It Ev SHELL .Nm がフォークするシェルを指定します。 .Ev SHELL が設定されていない場合は Bourne シェルが使われます。 (ほとんどのシェルはこの変数を自動的に設定します) .El .Sh 関連項目 .Xr csh 1 ( .Em history 機能に関連) .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 .Sh バグ .Nm -は、ログファイルにラインフィードやバックスペースも含め、 +ユーティリティは、ログファイルにラインフィードやバックスペースも含め、 .Sy なんでも 記録 します。このためユーザの期待したものと違うログになることもあります。 .Pp スクリプトファイルを指定せずにコマンドを指定することはできません。 これは引数解析の互換性確保のためです。 .Pp .Fl k オプションが指定されている場合には、エコーキャンセルは理想と程遠いです。 スレーブ端末モードの ECHO モードがチェックされ、 手動エコー記録をいつ避けるべきかがチェックされます。 これは raw モード時、すなわちプログラムが手動エコーを行う時には動作しません。 diff --git a/ja_JP.eucJP/man/man1/soelim.1 b/ja_JP.eucJP/man/man1/soelim.1 index 08265aa40f..9b43ba992f 100644 --- a/ja_JP.eucJP/man/man1/soelim.1 +++ b/ja_JP.eucJP/man/man1/soelim.1 @@ -1,87 +1,87 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)soelim.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/soelim/soelim.1,v 1.4.2.1 2001/08/16 13:17:04 ru Exp % +.\" %FreeBSD: src/usr.bin/soelim/soelim.1,v 1.4.2.2 2002/06/21 15:29:11 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt SOELIM 1 .Os .Sh 名称 .Nm soelim .Nd nroff への入力ファイルに \&.so が含まれないようにする .Sh 書式 .Nm .Op Ar .Sh 解説 .Nm -は、指定したファイルまたは標準入力を読み込み、次の形式の +ユーティリティは、指定したファイルまたは標準入力を読み込み、次の形式の .Xr nroff 1 テキスト組み込みディレクティブを処理します: .Pp .Dl \&.so somefile .Pp ディレクティブは、入力ファイルの行頭に出現する必要があります。 .Xr tbl 1 と言ったプログラムは通常ディレクティブ行を処理しないので、便利です; 別々のファイルに分かれた表を 1 つのドキュメントにまとめることができます。 .Pp 単一のマイナス .Ql Fl で構成される引数は、標準入力に対応するファイル名とされます。 .Pp 組み込みは .Ql \e. の代わりに .Ql \e' を使用して抑える事ができます。 例: .Pp .Dl \'so /usr/lib/tmac.s .Pp .Nm の使用例 .Pp .Bd -literal -offset indent -compact soelim exum?.n \&| tbl \&| nroff \-ms \&| col \&| lpr .Ed .Sh 関連項目 .Xr colcrt 1 , .Xr more 1 .Sh バグ 組み込みコマンドの形式に疑問が残ってはなりません \- ファイル名の前には唯 1 つの空白があり、後には空白を付けてはなりません。 .Sh 歴史 .Nm は .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/startslip.1 b/ja_JP.eucJP/man/man1/startslip.1 index 6975763c8d..f882da32c7 100644 --- a/ja_JP.eucJP/man/man1/startslip.1 +++ b/ja_JP.eucJP/man/man1/startslip.1 @@ -1,216 +1,217 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)startslip.1 8.1 (Berkeley) 6/5/93 -.\" %FreeBSD: src/sbin/startslip/startslip.1,v 1.16.2.4 2001/12/14 15:17:56 ru Exp % +.\" %FreeBSD: src/sbin/startslip/startslip.1,v 1.16.2.5 2002/06/20 23:09:11 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd June 5, 1993 .Dt STARTSLIP 1 .Os .Sh 名称 .Nm startslip .Nd 電話をかけ、slip サーバにログインする .Sh 書式 .Nm .Op Fl d .Op Fl b Ar speed .Oo .Fl s Ar string1 .Op Fl s Ar string2 Op Ar ...\& .Oc .Op Fl h .Op Fl l .Op Fl L .Op Fl A Ar annexname .Op Fl U Ar upscript .Op Fl D Ar downscript .Op Fl t Ar script_timeout .Op Fl W Ar maxtries .Op Fl w Ar retry_pause .Op Fl K Ar keepalive .Op Fl O Ar outfill .Op Fl S Ar unit .Ar device user password .Sh 解説 .Nm -は指定された +ユーティリティは、指定された .Ar device をオープンします。 ひとたびキャリアが確認されると(モデム制御が有効にされている場合)、 .Nm は指定された .Ar user および .Ar password でのログインを試みます。 Annex オプション ( .Fl A 参照) が指定されない限り、 標準的な login: および Password: の方式を想定します。 成功すると、 .Nm はその device を slip の回線規約に設定し、 .Ar upscript を呼び出してウェイトモードに入ります。 キャリアが落ちる (モデム制御有効の場合) あるいは .Dv SIGHUP シグナルがに送られると、 .Nm は device をクローズし、 .Ar downscript を呼び出し、ダイヤルアップとログインのシーケンスを繰り返し試みます。 .Dv SIGTERM シグナルが送られると、 .Nm は device をクローズし、 .Ar downscript を呼び出し、そして終了します。 同一 device に対して .Nm が 2 回呼び出されると、処理を行う前に ひとつめの .Nm が .Dv SIGTERM シグナルによって kill されます。 .Pp 以下のオプションを利用可能です: .Bl -tag -width indent .It Fl d 行おうとしている処理に関するデバッグ情報を出力します。 .It Fl b Ar speed .Ar device に用いるボーレートを決定します。デフォルトは 9600 です。 .It Fl t Ar script_timeout ログインスクリプトのタイムアウトを秒単位で指定します。デフォルトは 90 です。 .It Fl w Ar retry_pause 接続再試行の間の待ち時間を秒単位で指定します(再試行のたびに長くなります)。 デフォルトは 60 です。 .It Fl W Ar maxtries 一つのセッション内で接続再試行する最大回数を設定します。 デフォルトは 6 回です。0 を指定すると無限回という意味になります。 .It Fl s Ar stringN オプション文字列 .Ar stringN を .Ar device に書き出します。改行は自動的に付加されます。 ダイヤルアップモデムの場合、 この文字列を用いてダイヤルシーケンスを指定します。 デフォルトでは文字列は全く書き出しません。 複数個の .Fl s Ar stringN 引数を指定して、例えばいくつかのホストの電話番号を 接続試行毎に切り替えるように指定できます。 .It Fl A Ar annexname -Xylogics の Annex box に接続しているものとみなし、引数 +.Nm +ユーティリティは、Xylogics の Annex box に接続しているものとみなし、引数 .Ar user および .Ar password を用いて適切なダイアログを行います。引数 .Ar annexname は Annex プロンプトとマッチさせて接続が確立したことを判断するのに 用いる文字列です。 .It Fl h .Ar device に対してハードウェアフロー制御 (CTS/RTS) を用います。 デフォルトではフロー制御は行いません。 .It Fl l .Ar device に対してのモデム制御 (キャリアを待つ およびキャリアドロップの検出) を 無効化します。 デフォルトではモデム制御は有効になっています。 .It Fl U Ar upscript SLIP インタフェースが接続されたときに実行するスクリプトを指定します。 このスクリプトには .Xr ifconfig 8 , .Xr route 8 や、その他適切なコマンドを含めることが できます。 スクリプトには "slX up" が引数として渡されます。 デフォルトは .Pa /sbin/ifconfig です。 ダイヤルシーケンス番号 ( .Fl s 参照) は環境変数 .Ev LINE を通じて渡されます。 .It Fl D Ar downscript SLIP インタフェースが切断されたときに実行するスクリプトを指定します。 スクリプトには引数として "slX down" が渡されます。 デフォルトは .Pa /sbin/ifconfig です。 ダイヤルシーケンス番号 ( .Fl s 参照) は環境変数 .Ev LINE を通じて渡されます。 .It Fl K Ar keepalive SLIP の "keep alive" タイムアウトの秒数を設定します。 この時間内に FRAME_END を受信しなければ、再接続が行われます。 向こう側からのアクティブな "out fill" タイムアウトを期待します。 デフォルトではタイムアウトなしです。 .It Fl O Ar outfill SLIP の "out fill" タイムアウトの秒数を設定します。 この時間内に FRAME_END を少なくとも 1 回送信するようにします。 向こう側で "keep alive" タイムアウトが設定されている必要があります。 デフォルトではタイムアウトなしです。 .It Fl S Ar unit SLIP ユニットナンバを直接設定します。 2 つのインタフェースが同一のナンバを使っていることはチェックしないので、 注意して使用して下さい。 デフォルトではダイナミックな割り当てを行います。 .It Fl L UUCP 形式のデバイスロックを行います。 既に UUCP ロックを行っている外部プログラムから .Nm を実行する場合以外は、これが必要です。 デフォルトの場合、そのようなプログラムを満足させる UUCP ロックは行いません。 .El .Sh 関連ファイル .Bl -tag -width /var/run/startslip..pid -compact .It Pa /var/run/startslip..pid PID がここに格納されます。 .It Pa /usr/share/examples/startslip/* .El .Sh 関連項目 .Xr uustat 1 , .Xr slattach 8 , .Xr sliplogin 8 .Sh 歴史 .Nm は .Bx 4.4 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/su.1 b/ja_JP.eucJP/man/man1/su.1 index 0fd2a402b3..19bcc15d17 100644 --- a/ja_JP.eucJP/man/man1/su.1 +++ b/ja_JP.eucJP/man/man1/su.1 @@ -1,241 +1,241 @@ .\" Copyright (c) 1988, 1990, 1993, 1994 .\" The Regents of the University of California. 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 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. .\" .\" @(#)su.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/su/su.1,v 1.17.2.5 2002/04/02 20:47:04 keramida Exp % +.\" %FreeBSD: src/usr.bin/su/su.1,v 1.17.2.6 2002/06/21 15:29:18 charnier Exp % .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt SU 1 .Os .Sh 名称 .Nm su .Nd 一時的に他のユーザになりかわる .Sh 書式 .Nm .Op Fl .Op Fl Kflm .Op Fl c Ar class .Op Ar login Op Ar args .Sh 解説 .Nm -は +ユーティリティは、 .Ar login するときに Kerberos パスワード (もしくはログイン ( .Ar login ) が指定されない場合には、 .Dq Ar login Ns .root のパスワード) を要求し、Kerberos 認証を得たあとにユーザとグループ ID を 切り替えます。シェルはそのあとに実行されます。もし Kerberos エラーがあれ ば、 .Nm -は、 +ユーティリティは、 .Ar login のためのパスワードを見つけるためにローカルパスワードファイルを調べま す。もし .Nm が root によって実行された場合、パスワードは要求されず、適当なユーザ ID をもったシェルが実行されます。付加的な Kerberos 認証は一つも得られ ません。 .Pp デフォルトでは、 .Ev USER , .Ev HOME , .Ev SHELL 以外の環境変数は引き継がれます。 .Ev HOME と .Ev SHELL はターゲットとなるログインのデフォルト値になります。 .Ev USER は、ターゲットログインのユーザ ID が 0 以外であれば、ターゲットログイ ンのものがセットされます。0 の場合は変更されません。実行されるシェルは ターゲットログインのログインシェルです。これは .Nm の伝統的なふるまいです。 オリジナルユーザのログインクラス ( .Xr login.conf 5 参照) の資源制約とセッション優先度も通常保たれます。 例外はターゲットログインがユーザ ID 0 の場合です。 .Pp オプションとしては、以下のものがあります: .Bl -tag -width Ds .It Fl K ユーザ認証に Kerberos を使用しません。 .It Fl f シェルとして .Xr csh 1 が実行される場合、 .Dq Pa .cshrc ファイルを読み込みません。 .It Fl l 通常にログインした場合と同様になるように環境変数が設定されます。 すなわち、環境変数は .Ev HOME , .Ev SHELL , .Ev PATH , .Ev TERM , .Ev USER 以外は捨てられます。 .Ev HOME と .Ev SHELL は上記のように変更されます。 .Ev USER はターゲットログインの値になります。 .Ev PATH は .Dq Pa /bin:/usr/bin になります。 .Ev TERM は、あなたの現在の環境変数の値になります。 ターゲットログインのクラスにより、 ログインクラスケーパビリティデータベースに基づき、 環境変数が設定もしくは変更されることがあります。 実行されるシェルはターゲット ログインのログインシェルになり、 ターゲットログインのホームディレクトリに移動します。 資源制約とセッション優先度は、 ターゲットアカウントのログインクラスのものに変更されます。 .It Fl (文字無し) .Fl l と同じです。 .It Fl m 環境変数は変化しません。 実行されるシェルは自分のログインシェルで、ディレクトリの移動も行われません。 セキュリティの用心として、もしターゲットユーザのシェルが 非標準シェル ( .Xr getusershell 3 で定義される) であったり、呼出側の実ユーザ ID が 0 でなければ、 .Nm は失敗します。 .It Fl c Ar class 指定されたログインクラスの設定を使用します。 スーパユーザのみが使用を許されます。 .El .Pp .Fl l (または .Fl ) と .Fl m は、同時に指定することはできません。最後に指定したものが優先されます。 .Pp オプションの .Ar args がコマンドラインに指定されると、 それらはターゲットログインのログインシェルに引き渡されます。 .Pp グループ 0 (通常は .Dq wheel ) のメンバのみ .Dq root となることが可能です。 グループ 0 が存在しないか空の場合には、どのユーザでも .Dq root に .Nm することが可能です。 .Pp デフォルトでは (設定がされていなければ) スーパユーザのプロンプトは .Dq Sy \&# に設定されます。 .Sh 関連ファイル .Bl -tag -width /etc/auth.conf -compact .It Pa /etc/auth.conf 認証サービスの設定 .El .Sh 関連項目 .Xr csh 1 , .Xr kerberos 1 , .Xr kinit 1 , .Xr login 1 , .Xr sh 1 , .Xr group 5 , .Xr login.conf 5 , .Xr passwd 5 , .Xr environ 7 .Sh 環境変数 .Nm で利用される環境変数は以下の通りです: .Bl -tag -width HOME .It Ev HOME 上記で示した書き換えがない限り、 実ユーザ ID のデフォルトのホームディレクトリです。 .It Ev PATH 上記で示した書き換えがない限り、実ユーザ ID のデフォルトのサーチパスで す。 .It Ev TERM なり代わる人が所有している端末のターミナルタイプです。 .It Ev USER ユーザ ID が 0 (root) 以外の場合は、ユーザ ID は常に .Nm 後の effective ID (ターゲットとなるユーザ ID) です。 .El .Sh 使用例 .Bl -tag -width 5n -compact .It Li "su man -c catman" コマンド .Li catman をユーザ .Li man で実行します。 あなたの実 UID が 0 でない場合は、man のパスワードを尋ねられます。 .It Li "su man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'" 上と同様ですが、コマンドが複数の語から構成されています。 .Fl c オプションをシェルに渡すためにクォートしています (ほとんどのシェルでは .Fl c への引数が単一語であると期待します)。 .It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'" 上と同様ですが、ログインクラス .Dq staff の資源制限にてターゲットコマンドを実行します。 注: この例では、最初の .Fl c オプションは .Nm に適用され、2 番目のものは起動されるシェルの引数となります。 .It Li "su -l foo" ユーザ foo のログインをシミュレートします。 .It Li "su - foo" 上と同じです。 .It Li "su - " rootのログインをシミュレートします。 .El .Sh 歴史 .Nm コマンドは .At v1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/systat.1 b/ja_JP.eucJP/man/man1/systat.1 index 7374553207..a46c2f58d5 100644 --- a/ja_JP.eucJP/man/man1/systat.1 +++ b/ja_JP.eucJP/man/man1/systat.1 @@ -1,527 +1,528 @@ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)systat.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.bin/systat/systat.1,v 1.23.2.6 2001/10/09 16:10:19 sobomax Exp % +.\" %FreeBSD: src/usr.bin/systat/systat.1,v 1.23.2.7 2002/06/21 15:29:21 charnier Exp % .\" .\" $FreeBSD$ .\" .Dd September 9, 1997 .Dt SYSTAT 1 .Os .Sh 名称 .Nm systat .Nd システムの統計情報を CRT に表示する .Sh 書式 .Nm .Op Fl display .Op Ar refresh-interval .Sh 解説 .Nm -はシステムの各種統計情報をスクリーン指向な方法で +ユーティリティは、 .Xr ncurses 3 -の curses スクリーンディスプレイライブラリを用いて表示します。 +の curses スクリーンディスプレイライブラリを用いたスクリーン指向な方法で、 +システムの各種統計情報を表示します。 .Pp .Nm の走行中はスクリーンが通常 2 つのウィンドウに分割されます (例外は vmstat を表示する場合で この時はスクリーン全体を使います)。 上のウィンドウはその時のシステムのロードアベレージを表示します。 下のウィンドウに表示される情報は、ユーザのコマンドに応じて 変化するかもしれません。スクリーンの最終行はユーザの入力と エラーメッセージのために予約されています。 .Pp デフォルトでは .Nm はプロセッサ使用率が最大のプロセスを下のウィンドウに表示します。 他にはスワップ領域の使用状況、ディスク .Tn I/O の統計情報 ( .Xr iostat 8 式に)、仮想記憶の統計情報 ( .Xr vmstat 8 式に)、ネットワークの ``mbuf'' 利用率、 .Tn TCP/IP 統計情報、 ネットワークコネクション ( .Xr netstat 1 式に) を表示します。 .Pp 入力は 2 つの異なるレベルで解釈されます。 ``グローバル'' なコマンドインタプリタがすべてのキーボード入力を 処理します。もしこのコマンドインタプリタがコマンドを認識できないと、 入力行は表示する種類毎のコマンドインタプリタに渡されます。 これによって各表示内容に応じたコマンドを持つ事が可能になります。 .Pp コマンド行のオプション: .Bl -tag -width "refresh_interval" .It Fl Ns Ar display .Fl に続けて .Ar display として以下のいずれか一つを指定します: .Ic icmp , .Ic iostat , .Ic ip , .Ic mbufs , .Ic netstat , .Ic pigs , .Ic swap , .Ic tcp , .Ic vmstat 。これらの表示内容は対話的にも ( .Dq Fl 無しに) 指定でき、そして詳細は以下の説明にあります。 .It Ar refresh-interval .Ar refresh-value にスクリーンの更新間隔を秒数で指定します。 .El .Pp いくつかの文字は .Nm を即座に反応させます。 そういった文字には以下の物があります .Bl -tag -width Fl .It Ic \&^L スクリーンを更新します。 .It Ic \&^G その時点で下のウィンドウに表示されている ``表示内容'' の名称と 更新間隔を表示します。 .It Ic \&^Z .Nm を停止します。 .It Ic \&: カーソルをコマンドラインに移動して打ち込まれた入力行を コマンドとして解釈します。コマンドの入力中は 現位置文字消去、単語消去、行取消の各編集機能が使えます。 .El .Pp 以下のコマンドは ``グローバル'' なコマンドインタプリタによって 解釈されます。 .Bl -tag -width Fl .It Ic help 指定可能な表示内容をコマンドラインに表示します。 .It Ic load 過去 1、5、15分間のロードアベレージをコマンドラインに表示します。 .It Ic stop スクリーンの更新を止めます。 .It Xo .Op Ic start .Op Ar number .Xc スクリーンの更新を開始 (継続) します。もし数値で秒数指定の 引数が与えられると更新間隔 (の秒数) として解釈されます。 数値のみを与えると更新間隔がその値にセットされます。 .It Ic quit .Nm を終了します。 (これは .Ic q と省略できます。) .El .Pp 指定可能な表示内容には以下があります: .Bl -tag -width Ic .It Ic pigs 下のウィンドウに、主記憶を占めプロセッサ利用率が最大のプロセスを 表示します (デフォルトの表示内容です)。 ユーザプロセスへのプロセッサの割当が 100% 未満の時は、 残りは ``idle'' プロセスに割り当てられているものと扱います。 .It Ic icmp 下のウィンドウに、 Internet Control Message Protocol .Pq Dq Tn ICMP で送受信されたメッセージの統計情報を表示します。 スクリーンの左半分には受信したパケットの情報を表示し、 右半分には送信されたと考えられるパケットの情報を表示します。 .Pp 表示内容が .Ic icmp の場合は 2 つのコマンドが利用できます: .Ic mode と .Ic reset です。 .Ic mode コマンドは与えられた引数に応じて 4 つの表示モードから 1 つを選ぶために使います: .Bl -tag -width absoluteXX -compact .It Ic rate : それぞれの値の変動を秒単位にパケット数で表示します (デフォルトです) .It Ic delta : それぞれの値の変動を更新間隔単位にパケット数で表示します .It Ic since : 表示が最後にリセットされてからのそれぞれの値の変動の総計を表示します .It Ic absolute : 各統計の絶対値を表示します .El .Pp .Ic reset コマンドは .Ic since モードの基点をリセットします。 引数なしの .Ic mode コマンドはその時点のモードをコマンドラインに表示します。 .It Ic ip .Tn IP と .Tn UDP の統計情報を表示するという点を除いて .Ic icmp と同じです。 .It Ic tcp .Ic icmp に似ていますが、 .Tn TCP の統計情報を表示します。 .It Ic iostat 下のウィンドウに、プロセッサ利用率とディスクのスループットの 統計情報を表示します。プロセッサ利用率の統計情報は ユーザモード (``user'')、低いプライオリティで実行された ユーザモードのプロセス (``nice'')、システムモード (``system'')、 割り込みモード (``interrupt'')、アイドル (``idle'') での総実行時間 の棒グラフとして表示されます。 ディスクのスループットの統計情報としては、各ドライブについて、 秒あたりのメガバイト数、秒あたりの平均ディスクトランザクション数、 トランザクションあたりの平均転送キロバイト数が表示されます。 この情報は棒グラフまたは下へスクロールする数値の列で表示されます。 棒グラフでの表示がデフォルトです; .Pp 以下のコマンドは表示内容が .Ic iostat の場合に特有です; 先頭からの一意に識別可能な文字数だけで指定可能です。 .Pp .Bl -tag -width Fl -compact .It Cm numbers ディスク .Tn I/O の統計情報を数値形式で表示します。値は下へスクロールする 数値の列として表示されます。 .It Cm bars ディスク .Tn I/O の統計情報を棒グラフ形式で表示します (デフォルト)。 .It Cm kbpt トランザクションあたりのキロバイト数の表示を切り替えます (デフォルトではトランザクションあたりのキロバイトは表示されません)。 .El .It Ic swap カーネルに組み込まれている全スワップ領域について 利用状況に関する情報を表示します。 最初の列はパーティションのデバイス名です。 次の列はパーティションの総容量です。 .Ar Used の列は それまでに使われた総ブロックを示します; グラフは各パーティションで使用中の部分の割合を示します。 2 つ以上の使用中のスワップパーティションがある場合は、 合計の行も表示されます。 カーネルに組み込まれているものの、使われていない物は 使用不可として表示されます。 .It Ic mbufs 下のウィンドウに、何らかの用途、すなわち、データ、ソケット構造体等々に 確保された mbuf の個数を表示します。 .It Ic vmstat 画面全体を使って、 仮想記憶の利用状況、プロセススケジューリング、 デバイスからの割り込み、システムの名前変換キャッシュ、 ディスク .Tn I/O 等々に関する (やや込み入った) 統計情報の要約を表示します。 .Pp 画面の左上の領域にはログインしているユーザ数と過去 1、5、15分間の ロードアベレージが表示されます。 この行の下はメモリ利用率の統計情報です。 この表の 1 行目はアクティブなプロセス、つまり過去 20 秒以内に 走行状態だったことのあるプロセスのみのメモリ利用率を報告します。 2 番目の行は全プロセスのメモリ利用状況を報告しています。 1 番目の列はプロセスによって要求された物理ページ数を表示します。 2 番目の列は読みだし専用のテキストページに当てられた 物理ページ数を表示します。 3 番目と 4 番目の列は同じ物に関して仮想ページの情報を表示します。 これは全プロセスが全ページを持つとした時に必要となるページ数を表します。 最後に、最終列はフリーリスト上の物理ページ数を示します。 .Pp メモリ情報の下は平均プロセス数のリスト (1 更新期間前からのもの) で、 走行可能 (`r')、ページ待ち中 (`p')、 ページング以外のディスク待ち中 (`d')、 スリープ状態 (`s')、スワップアウトされているが実行されるのを 待っている状態 (`w') です。 この行にはコンテキストスイッチの平均回数 (`Csw')、 トラップ (`Trp'; ページフォルトを含む)、 システムコール (`Sys')、割り込み (`Int')、 ネットワークソフトウェア割り込み (`Sof')、 ページフォルト (`Flt') も表示します。 .Pp このプロセスキューの長さのリストの下は 時間の総計をシステム (`=' で示されます)、割り込み (`+' で示されます)、 ユーザ (`>' で示されます)、ナイス (`-' で示されます)、 アイドル (` ' で示されます) について数値のリストと棒グラフで 表した物です。 .Pp プロセス情報の下はファイル名変換の統計情報です。 これは前の更新期間中に行われたファイル名から inode 番号への変換の 回数、システム全体で共通の変換キャッシュで処理された物の回数と 割合、プロセス毎の変換キャッシュで処理された物の回数と割合を 表示しています。 .Pp 左下はディスクアクセス状況です。 ここでは 1 更新間隔 (デフォルトでは 5 秒) において、 転送あたりのキロバイト数、秒あたりの転送回数、秒あたりの転送メガバイト数、 ディスクがビジーであった時間のパーセンテージを報告します。 システムは、ほぼすべてのストレージデバイスの統計情報を保持します。 一般的には、7 個までのデバイスが表示されます。 表示されるデバイスは、 デフォルトではカーネルのデバイスリストの先頭にあるものです。 devstat システムの詳細については、 .Xr devstat 3 および .Xr devstat 9 を参照してください。 .Pp 右上の日時の下はページングとスワップの稼働状況です。 最初の 2 列は、1 更新間隔の間にページフォルトとページデーモンによって、 読み込まれたページ数と掃き出されたページ数の 1 秒あたりの平均を報告します。 3 番目と 4 番目の列は、1 更新間隔の間にスケジューラによって発行された スワップ要求により 読み込まれたページ数と掃き出されたページ数の 1 秒あたりの平均を報告します。 この情報の 1 行目は 1 更新間隔での秒あたりの平均ディスク転送回数を 示します; この情報の 2 行目は 1 更新間隔での秒あたりの平均転送ページ数を 示します。 .Pp ページングの統計情報の下は仮想記憶システムの以下の項目の平均数を 表示する列です。それぞれ、 書き込み時にコピーが行われたページ数 (`cow')、 要求時 0 クリアが行われたページ数 (`zfod')、 ページング対象から外され、固定されているページ数 (`wire')、 遅い (オンザフライの) ゼロフィルの割合 (`%slo-z')、 最近参照されたページ数 (`act')、 ページングの候補になっているページ数 (`inact')、 バッファキャッシュキューにあるページ数 (`cache')、 フリーページ数 (`free')、 ページデーモンが解放したページ数 (`daefr')、 プロセスが終了した事によって解放されたページ数 (`prcfr')、 フリーリストから再有効化されたページ数 (`react')、 ページデーモンが起こされた回数 (`pdwak')、 ページデーモンが調べたページ数 (`pdpgs')、 読み込み途中でページフォルトがブロックされた回数 (`intrn') の 1 更新間隔での秒あたりの平均値です。 .Pp この列のいちばん下は、以下の用途に使われている メモリの総量をそれぞれについてキロバイト単位で示しています。 バッファキャッシュのために使われている分 (`buf')、 バッファキャッシュ中のダーティバッファ数 (`dirtybuf')、 vnode キャッシュの望まれる最大サイズ (`desiredvnodes') (ネームキャッシュのサイズまでを除くと、大部分は未使用)、 実際に確保された vnode 数 (`numvnodes')、 確保された vnode でフリーな物の数 (`freevnodes') .Pp 画面の右下はシステムによって処理された割り込みの詳細です。 リストのトップは更新期間中の秒あたりの総割り込み数です。 列の残りの部分は総割り込み数のデバイス毎の詳細です。 ブートしてから少なくとも 1 回は割り込みを発生したデバイスについてのみ 表示されます。 .Pp 以下のコマンドは表示内容が .Ic vmstat の場合に特有です; 先頭からの一意に識別可能な文字数だけで指定可能です。 .Pp .Bl -tag -width Ar -compact .It Cm boot システムがブートしてからの累積の統計情報を表示します。 .It Cm run このコマンドが与えられてからの走行中のトータルとして統計情報を表示します。 .It Cm time 更新期間の平均で統計情報を表示します (デフォルト)。 .It Cm want_fd fd デバイスのディスク使用状況を表示するか否かを切り替えます。 .It Cm zero 走行中の統計情報を 0 にリセットします。 .El .It Ic netstat 下のウィンドウにネットワーク接続状況を表示します。デフォルトでは、 リクエストを待っているネットワークサーバは表示されません。 各アドレスは ``host.port'' のフォーマットで、可能であれば シンボルで表示されます。アドレスを数字で表示することや、 ポート、ホスト、プロトコルの表示を制限することが可能です。 (先頭からの一意に識別可能な文字数だけで指定可能です): .Pp .Bl -tag -width Ar -compact .It Cm all リクエストを待っているサーバプロセスの表示を切り替えます (これは .Xr netstat 1 の .Fl a フラグと等価です)。 .It Cm numbers ネットワークアドレスを数字で表示します。 .It Cm names ネットワークアドレスをシンボルで表示します。 .It Cm proto Ar protocol .Ar protocol で指定されたプロトコルを使っているネットワークコネクションのみを 表示します (サポートしているプロトコルは ``tcp'',``udp'',``all'')。 .It Cm ignore Op Ar items 指定されたホストまたはポートとの接続に関する情報を表示しません。 ホストとポートは名前 (``vangogh'' や ``ftp'')、または数字で 指定できます。ホストのアドレスはインターネットのドット表記を 使用します (``128.32.0.9'')。空白で区切って 1 つのコマンドに 複数の指定が可能です。 .It Cm display Op Ar items 指定されたホストまたはポートとの接続に関する情報を表示します。 .Ar ignore と同様に、 .Op Ar items は名前または数字が使用可能です。 .It Cm show Op Ar ports\&|hosts コマンドラインに、その時点で選択されているプロトコル、 ホスト、ポートを表示します。無視されるホストとポートには `!' を前置します。もし .Ar ports か .Ar hosts が .Cm show の引数として与えられると、 指定された情報だけが表示されます。 .It Cm reset ポート、ホスト、プロトコルの選択メカニズムをデフォルト (あらゆるプロトコル、ポート、ホスト) の状態にリセットします。 .El .El .Pp 表示内容の切り替えコマンドは先頭からの一意に識別可能な 文字数に短縮できます; 例えば ``iostat'' は ``io'' と省略できます。 画面サイズが表示内容に不十分な時は情報が捨てられる可能性があります。 例えば、10 台のドライブがあるマシンでは .Ic iostat の棒グラフは 24 行の端末では 3 ドライブ分しか表示しません。 棒グラフが割り当てられた画面のスペースに収まらない時は 切り詰められて実際の値は棒の ``先端部分'' に表示されます。 .Pp 以下のコマンドはディスクドライブに関する情報を表示する物に 共通です。これらのコマンドは、あなたのシステムに、通常 画面に表示しきれない数のドライブがある場合に、情報を表示する ドライブのセットを選択するために使うためのものです。 .Pp .Bl -tag -width Ar -compact .It Cm ignore Op Ar drives 指定されたドライブに関する情報を表示しません。複数のドライブを 空白で区切って指定できます。 .It Cm display Op Ar drives 指定されたドライブに関する情報を表示します。複数のドライブを 空白で区切って指定できます。 .It Cm only Op Ar drives 指定されたデバイスのみ表示します。 複数のデバイスを指定可能であり、その場合空白で区切ります。 .It Cm drives 使用可能なデバイスのリストを表示します。 .It Cm match Xo .Ar type , Ns Ar if , Ns Ar pass .Op | Ar ... .Xc 指定したパターンにマッチするデバイスを表示します。 基本マッチング式は、 .Xr iostat 8 で使用するものと同じですが、1 点のみ異なります。 それぞれが OR される複数の .Fl t 引数を指定する代りに、 複数のマッチング式をパイプ .Pq Ql \&| 文字で結合して指定します。 それぞれのマッチング式中でコンマで区切られた引数に関して それぞれ AND がとられてから、 パイプで区切られたマッチング式に関してそれぞれ OR がとられます。 組み合わせ式に対してマッチするデバイスは、 表示する余地があれば表示されます。 例: .Pp .Dl match da,scsi | cd,ide .Pp これは、 全 SCSI ダイレクトアクセスデバイスと、全 IDE CDROM デバイスを表示します。 .Pp .Dl match da | sa | cd,pass .Pp これは、全ダイレクトアクセスデバイス、全シーケンシャルアクセスデバイス、 そして CDROM へのアクセスを提供する全パススルーデバイスを表示します。 .El .Sh 関連項目 .Xr netstat 1 , .Xr kvm 3 , .Xr icmp 4 , .Xr ip 4 , .Xr tcp 4 , .Xr udp 4 , .Xr iostat 8 , .Xr vmstat 8 .Sh 関連ファイル .Bl -tag -width /etc/networks -compact .It Pa /kernel ネームリストを読み出します。 .It Pa /dev/kmem 主記憶の情報を取ります。 .It Pa /etc/hosts ホスト名をひきます。 .It Pa /etc/networks ネットワーク名をひきます。 .It Pa /etc/services ポート名をひきます。 .El .Sh 歴史 .Nm プログラムは .Bx 4.3 に初めて登場しました。 .Ic icmp , .Ic ip , .Ic tcp の表示は .Fx 3.0 に初めて登場しました; .Tn ICMP , .Tn IP , .Tn TCP , .Tn UDP の統計情報のために別の表示モードを用意するという考え方は、 Silicon Graphics の .Tn IRIX システムの .Xr netstat 1 の .Fl C オプションから借用しました。 .Sh バグ 表示内容によっては 1 行に最低で 80 文字が表示できる事を想定しています。 .Ic vmstat は表示領域が足りないようです。なぜなら (訳注: 原文が切れています) (新規のプログラムとしてではなく独立した表示画面として追加されました)。 .Sh 日本語訳 野首 寛高(hnokubi@yyy.or.jp): FreeBSD 用に翻訳 diff --git a/ja_JP.eucJP/man/man1/talk.1 b/ja_JP.eucJP/man/man1/talk.1 index 119c1ce4f3..6f58ccc26b 100644 --- a/ja_JP.eucJP/man/man1/talk.1 +++ b/ja_JP.eucJP/man/man1/talk.1 @@ -1,138 +1,138 @@ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)talk.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/talk/talk.1,v 1.6.2.3 2001/12/14 15:53:31 ru Exp % +.\" %FreeBSD: src/usr.bin/talk/talk.1,v 1.6.2.4 2002/06/21 15:29:23 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt TALK 1 .Os .Sh 名称 .Nm talk .Nd 他のユーザと会話(筆談)を行う .Sh 書式 .Nm .Ar person .Op Ar ttyname .Sh 解説 .Nm -は、視覚的な通信プログラムで、 +ユーティリティは、視覚的な通信プログラムで、 端末に入力された行を他のユーザの端末にコピーします。 .Pp オプション: .Bl -tag -width ttyname .It Ar person ログイン名だけを指定したときは、同じマシンにいるユーザ と会話をすることができます。他のマシンのユーザと会話をしたい場合は、 .Ql user@host または .Ql host!user または .Ql host:user という形で .Ar person を指定します。 .It Ar ttyname 複数の端末にログイン しているユーザと会話をしたい場合、端末名 .Ar ttyname を指定することができます。 .Ar ttyename は .Dq ttyXX という形で指定します。 .El .Pp 最初に呼び出しを行うとき、 .Nm は以下のようなメッセージを .Ar person に送ります。 .Bd -literal -offset indent -compact Message from TalkDaemon@his_machine... talk: connection requested by your_name@your_machine. talk: respond with: talk your_name@your_machine .Ed .Pp メッセージを送られた相手は、この時点で以下のように返事をする必要があります。 .Pp .Dl talk \ your_name@your_machine .Pp ログイン名が同じであれば、相手はどのマシンから返事をしてもかまいません。 一度、相手との接続が確立すると、2人のユーザは同時に書き込みを行うこと ができます。2人の書き込み結果は、異なったウィンドウに分割されて表示さ れます。control-L .Ql ^L を打ち込むと、画面を書き直します。また、erase, kill, word kill 文字 は通常どおりの動作をします。会話を終了するには、中断 (interrupt) 文字を 入力します。 .Nm は、カーソルを画面の一番下に移動させ、端末を元の状態に戻します。 .Pp .Nm から呼び出しを許すかどうかは、 .Xr mesg 1 で指定することができます。 .Xr mesg 1 で設定してないときは、 .Nm からの呼び出しは許可されています。ただし、 .Xr nroff 1 や .Xr pr 1 などのプログラムなどは、 .Nm からの呼び出しで出力画面が見にくくならないように、メッセージを拒否します。 .Sh 関連ファイル .Bl -tag -width /var/run/utmp -compact .It Pa /etc/hosts 受信者のホスト名を知るために用いる .It Pa /var/run/utmp 受信者の端末名を知るために用いる .El .Sh 関連項目 .Xr mail 1 , .Xr mesg 1 , .Xr wall 1 , .Xr who 1 , .Xr write 1 .Sh バグ .Bx 4.3 で使われているバージョンの .Xr talk 1 のプロトコルは、 .Bx 4.2 のものとは互換性がありません。 .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/tcopy.1 b/ja_JP.eucJP/man/man1/tcopy.1 index 7642490c0f..c3e8e19741 100644 --- a/ja_JP.eucJP/man/man1/tcopy.1 +++ b/ja_JP.eucJP/man/man1/tcopy.1 @@ -1,112 +1,114 @@ .\" Copyright (c) 1985, 1990, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)tcopy.1 8.2 (Berkeley) 4/17/94 -.\" %FreeBSD: src/usr.bin/tcopy/tcopy.1,v 1.7.2.2 2001/08/16 13:17:06 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/tcopy.1,v 1.5 2001/05/14 01:07:29 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/tcopy/tcopy.1,v 1.7.2.3 2002/06/21 15:29:28 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 17, 1994 .Dt TCOPY 1 .Os .Sh 名称 .Nm tcopy .Nd 磁気テープのコピー、ベリファイを行う .Sh 書式 .Nm .Op Fl cvx .Op Fl s Ar maxblk .Oo Ar src Op Ar dest .Oc .Sh 解説 .Nm -は、磁気テープのコピーのためのプログラムです。 +ユーティリティは、磁気テープのコピーのためのプログラムです。 記録したデータの終わりに 2 つのテープマークがあるような 磁気テープを想定しています。 ソーステープ (デフォルトでは .Ar /dev/rsa0 ) だけが指定された場合は、 +.Nm +ユーティリティは、 レコードサイズとテープのファイルに関する情報を表示します。 ディスティネーションが指定された場合は、ソーステープがコピーされます。 ディスティネーションテープのブロッキングはソーステープと同じになります。 テープをコピーすると、サイズを表示する場合と同様の表示が得られます。 .Pp オプションには次のものがあります。 .Bl -tag -width s_maxblk .It Fl c .Ar src から .Ar dest へコピーした後、両方のテープが同一であることを確認するためベリファイをします。 .It Fl s Ar maxblk ブロックサイズの最大値を .Ar maxblk で指定した値にします。 .It Fl v .Ar src と .Ar dest の両方のテープが同一であることを確認するためベリファイのみを行ないます。 .It Fl x 標準出力へ全メッセージを出力します。 このオプションは .Ar dest が .Pa /dev/stdout の時に役に立ちます。 .El .Sh 関連項目 .Xr mtio 4 .Sh 歴史 .Nm コマンドは .Bx 4.3 から登場しました。 .Sh バグ .Bl -item .It テープイメージをファイルへ書き込むと、生データ程は保たれません。 ブロックサイズとテープの EOF マークは失われます。 これらは、テープからテープへのコピーでは保たれます。 .It EOD は、間にデータを持たない 2 個の連続した EOF マークで、判定されます。 古いシステムには、 テープファイル間に、典型的には 3 個の EOF を書き込むものがあります。 この場合、 .Xr tcopy 1 は誤ってしまい、早期にテープコピーを停止してしまいます。 .It コピーとベリファイのオプション \-c を使用すると、 .Xr tcopy 1 は開始時にテープを巻戻しません。 書き込み後、ベリファイ前に、巻き戻しされます。 BOT から開始していない場合、 意図したデータに対する比較にはならないかもしれません。 .El diff --git a/ja_JP.eucJP/man/man1/tcpslice.1 b/ja_JP.eucJP/man/man1/tcpslice.1 index c48ade0fc1..4c47b5bd20 100644 --- a/ja_JP.eucJP/man/man1/tcpslice.1 +++ b/ja_JP.eucJP/man/man1/tcpslice.1 @@ -1,266 +1,267 @@ .\" Copyright (c) 1988-1990 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that: (1) source code distributions .\" retain the above copyright notice and this paragraph in its entirety, (2) .\" distributions including binary code include the above copyright notice and .\" this paragraph in its entirety in the documentation or other materials .\" provided with the distribution, and (3) all advertising materials mentioning .\" features or use of this software display the following acknowledgement: .\" ``This product includes software developed by the University of California, .\" Lawrence Berkeley Laboratory and its contributors.'' 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 ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" -.\" %FreeBSD: src/usr.sbin/tcpdump/tcpslice/tcpslice.1,v 1.7.2.6 2001/08/16 15:56:35 ru Exp % +.\" %FreeBSD: src/usr.sbin/tcpdump/tcpslice/tcpslice.1,v 1.7.2.7 2002/06/21 16:42:35 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/tcpslice.1,v 1.13 2001/07/29 05:14:52 horikawa Exp $ +.\" $FreeBSD$ .Dd October 14, 1991 .Dt TCPSLICE 1 .Os .Sh 名称 .Nm tcpslice .Nd tcpdump ファイルの切り出し/結合 .Sh 書式 .Nm .Op Fl dRrt .Op Fl w Ar file .Op Ar start-time Op end-time .Ar .Sh 解説 .Nm -は、 +ユーティリティは、 .Xr tcpdump 1 の .Fl w フラグ を用いて作成されたパケットトレースファイルの一部を切り出すプログラムです。 また、以下に示すように、複数のパケットトレースファイルを結合する事も できます。 .Pp .Nm の基本機能は、入力ファイルに含まれるパケットのうち、指定された時間内の ものを .Pa stdout に出力する事です。 開始時刻および終了時刻の範囲は、コマンド行で指定できます。範囲は指定した 時刻自身を含みます。デフォルトでは、開始時刻は最初の入力ファイルの一つ目の パケットの時刻です。この時刻を .Em first time と呼びます。デフォルトでは、終了時刻は開始時刻の 10 年後です。 したがって、 .Nm .Ar trace-file というコマンドは単に .Ar trace-file を .Pa stdout に出力します(ファイルには 10 年分のデータがない事を 想定しています)。 .Pp 時刻の指定にはいくつかの方法があります。ひとつは .Em sssssssss.uuuuuu の形をとる Unix 時刻形式を用いる方法です (これは、 .Xr tcpdump 1 の .Fl tt フラグで指定される形式です)。 例えば、 .Em 654321098.7654 は、1990 年 9 月 25 日、午後 8 時 51 分 (PDT) から、 38 秒と 765,400 マイクロ秒後の時刻を示します。 .Pp このマニュアルの例は全て PDT の時刻で示しますが、 以下で示すように時刻を表示したり解釈したりする場合、 .Nm は、 .Xr tcpdump 1 のファイルがどのタイムゾーンで生成されたかに関わらず、 ローカルのタイムゾーンを使用します。 夏時間の設定は、対象となる日のローカルのタイムゾーンで適切な物が用いられます。 例えば、夏季の時刻には、夏時間の影響を反映し、冬季の時刻には 影響しません。 .Pp 時刻は .Em first time から(開始時刻を指定する場合)、 あるいは開始時刻から(終了時刻を指定する場合) の相対的な時刻として指定する事もできます。 指定するには秒数の前に `+' を付けます。 例えば、 .Em +200 は開始時刻が .Em first time から 200 秒後であることを示し、ふたつの引数 .Em +200 +300 は .Em first time から 200 秒後から、 .Em first time から 500 秒後までの範囲を示します。 .Pp 時刻は、年 (y)、月 (m)、日 (d)、時 (h)、分 (m)、秒 (s)、マイクロ秒 (u) で 指定する事もできます。例えば、上記の Unix 時刻 654321098.7654 は、 .Em 90y9m25d20h51m38s765400u と指定する事もできます。 .Pp この形式で時刻を指定した場合、省略されたフィールドのデフォルト値は以下 のようになります。最初に指定されたフィールドより .Em 大きい 単位の省略されたフィールドについてのデフォルト値は、 .Em first time (開始時刻を指定する場合) または開始時刻(終了時刻を指定する場合)と同じ 値となります。 最初に指定されたフィールドより .Em 小さい 単位の省略されたフィールドについてのデフォルト値はゼロとなります。 例えば、入力ファイルの .Em first time が Unix 時刻で上記の値、すなわち、1990 年 9 月 25 日、午後 8 時 51 分 (PDT) から 38 秒と 765,400 マイクロ秒後としましょう。この時、同じ日の 午後 9 時 36 分 (PDT) ちょうどを指定するには、 .Em 21h36m と表す事ができます。 午後 9 時 36 分 (PDT) から翌日の午前 1 時 54 分 (PDT) までを指定するには、 .Em 21h36m 26d1h54m と表す事ができます。 .Pp .Em ymdhmsu 形式を使用する時にも相対時刻で指定する事ができます。 この時、省略されたフィールドの単位が指定された最初のフィールドより .Em 大きい 単位ならば、デフォルト値は 0 となり、 省略されたフィールドの単位が指定された最初のフィールドより .Em 小さい 単位ならば、デフォルト値は .Em first time あるいは開始時刻と同じ値となります。 .Em first time が上記の Unix 時刻だった場合、 .Em 22h +1h10m はその日の午後 10 時 00 分 (PDT) から 午後 11 時 10 分 (PDT) までを示し、 .Em +1h +1h10m は午後 9 時 51 分 (PDT) の 38.7654 秒後から 午後 11 時 01 分 (PDT) の 38.7654 秒後までを示します。 .Em +0 +1h と指定すれば、ファイルの最初から 1 時間分のデータを取り出す事ができます。 .Pp .Em ymdhmsu 形式を用いる場合、 .Em m が、`月' を示すのか `分' を示すのかが曖昧になります。 いずれになるかは、以下のように決定されます。 .Em m フィールドの後に .Em d フィールドが来た場合、月が指定されたと判断します。それ以外の場合は、 分が指定された判断します。 .Pp 複数の入力ファイルが指定された場合、 .Nm はまず、最初のファイル内の指定された時刻の範囲にあるパケットを出力します。 次に、範囲の開始時刻を最初のファイルの最後のパケットの時刻の直後に変更し、 次のファイルを処理し、以降これを繰り返します。したがって、時間順に ならんでいないパケットを含む複数のファイルをまとめる事は .Em できません。 与えられたファイルのうち、先に処理されたファイルより新しいパケットに対して のみ処理されます。この機構によりひとつのパケットが複数回出力に現れる 事を防ぐ事ができます。 .Sh オプション .Fl R , .Fl r , .Fl t のいずれかが指定された場合、 .Nm は、各入力ファイルの最初および最後のパケットの時刻を表示して終了します。 これらの 3 個のオプションのうち、1 つだけを指定することができます。 .Pp 以下のオプションが指定できます: .Bl -tag -width indent .It Fl d 指定された範囲の開始時刻と終了時刻を表示して終了します。 このオプションは、指定した範囲が想定している時間と本当に一致しているかどうかを 確認するのに有効です。 .Fl R , .Fl r , .Fl t のいずれかが指定された場合、それらに相当する形式で時刻を表示します。 指定がない場合は、内部形式 .Pq Fl R となります。 .It Fl R 各入力ファイルの最初および最後のパケットの時刻を内部形式 (つまり、 .Em sssssssss.uuuuuu の形式) で表示します。 .It Fl r .Fl R と同じですが、 .Xr date 1 と同様の、読みやすい形式で時刻を表示します。 .It Fl t .Fl R と同じですが、時刻を .Nm 形式、すなわち、上記に示した .Em ymdhmsu の形で表示します。 .It Fl w Ar file 出力を .Pa stdout ではなく、 .Ar file とします。 .El .Sh 関連項目 .Xr tcpdump 1 .Sh 作者 .An Vern Paxson Aq vern@ee.lbl.gov , of Lawrence Berkeley Laboratory, University of California, Berkeley, CA. .Sh バグ 数字や `+' で始まるファイル名を入力ファイルとして指定すると、 開始/終了時刻と間違うことがあります。このようなファイル名は、 先頭に `./' をつけて指定します。たとえば、 `04Jul76.trace' というファイル名ならば `./04Jul76.trace' とします。 .Pp .Nm -は、入力ファイルをくまなく探すためにランダムアクセスを使用するため、 +ユーティリティは、 +入力ファイルをくまなく探すためにランダムアクセスを使用するため、 .Pa stdin から入力することはできません。 .Pp .Nm -は、出力先が端末 ( +ユーティリティは、出力先が端末 ( .Xr isatty 3 で示される) である場合、出力しません。 これはバグではなく、ユーザの端末にバイナリデータをまき散らすことを 防ぐための仕様です。つまり、 .Pa stdout をリダイレクトするか、 .Fl w により出力ファイルを指定しなければなりません。 .Pp .Nm -は、1 年以上にわたる +ユーティリティは、1 年以上にわたる .Xr tcpdump 1 のファイルや、 もともとのパケットの長さが 65,535 バイトを超えるようなパケットの一部を 含むようなファイル、3 パケット未満のパケットしか含まれないファイル に対しては正しく働かないでしょう。 これらのファイルを処理しようとすると、 `couldn't find final packet in file' というエラーメッセージが出力されます。 これらの問題は、大きなトレースファイルを扱う場合に、 .Nm が処理速度を大きく改善するために使用している機構に起因します。 一方、 .Nm は、如何なるサイズのトレースファイルでも中央のスライスを効率的に取り出す ことができ、不完全なトレースファイル (例えば、ファイル中の最後のパケットが 途中で切れているファイル、 .Xr tcpdump 1 が強制的に終了させられた 場合によくできる) に対しても正しく動作します。 diff --git a/ja_JP.eucJP/man/man1/tftp.1 b/ja_JP.eucJP/man/man1/tftp.1 index 96acf7b104..6b1f2c7d15 100644 --- a/ja_JP.eucJP/man/man1/tftp.1 +++ b/ja_JP.eucJP/man/man1/tftp.1 @@ -1,180 +1,180 @@ .\" Copyright (c) 1990, 1993, 1994 .\" The Regents of the University of California. 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 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. .\" .\" @(#)tftp.1 8.2 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/tftp/tftp.1,v 1.4.2.6 2002/04/26 17:22:43 ume Exp % +.\" %FreeBSD: src/usr.bin/tftp/tftp.1,v 1.4.2.7 2002/06/21 15:29:33 charnier Exp % .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt TFTP 1 .Os .Sh 名称 .Nm tftp .Nd 簡単なファイル転送プログラム .Sh 書式 .Nm .Op Ar host .Sh 解説 .Nm -は、インターネット +ユーティリティは、インターネット .Tn TFTP (Trivial File Transfer Protocol) を用いて、リモートマシンとの間の ファイル転送を行なうためのユーザインタフェースです。 リモートマシン名 .Ar host は、 .Nm 起動時にコマンドラインで指定することが可能です。この場合、 .Ar host はファイル転送を行なう際のデフォルトのホストとして使われます。 (以下の .Cm connect コマンドを参照のこと)。 .Sh コマンド .Nm 起動後、コマンド入力を促すプロンプト .Dq Li tftp> が表示されます。この状態で使用できるコマン ドは以下の通りです。 .Pp .Bl -tag -width verbose -compact .It Cm \&? Ar command-name ... ヘルプメッセージを出力します。 .Pp .It Cm ascii ``mode ascii'' の略です。 .Pp .It Cm binary ``mode binary'' の略です。 .Pp .It Cm connect Ar host-name Op Ar port ファイル転送を行なう .Ar host を(必要あれば .Ar port 番号も同時に) 設定します。 なお、 .Tn TFTP プロトコルは、 .Tn FTP プロトコルと違い、無通信状態においてはホスト間の コネクションを保持しないことに注意してください。 つまり、 .Cm connect コマンドはホスト 間のコネクションを確立するのではなく、実際には転送を行なうホストを 記憶するのに使用されます。 使用者は .Cm connect コマンドを使用する必要はなく、 .Cm get もしくは .Cm put コマンドを使用する時にリモートホストを指定することができます。 .Pp .It Cm get Ar filename .It Cm get Ar remotename localname .It Cm get Ar file1 file2 ... fileN 指定された形式でファイルを取得します。転送元の指定方法には 2 通りあります。 .Ar host がすでに指定されている場合、リモートホスト上のファイル名を指定し ます。もしくは .Ar hosts:filename のようにリモートマシンとファイル名の両者を指 定します。もし後者の形式が使用される場合、最後に指定されたリモートホスト名が 以後のファイル転送の対象ホストとなります。 .Pp .It Cm mode Ar transfer-mode 転送モードを設定します。転送モードは .Em ascii と .Em binary の 2 通りがあります。デフォルトは .Em ascii となります。 .Pp .It Cm put Ar file .It Cm put Ar localfile remotefile .It Cm put Ar file1 file2 ... fileN remote-directory 指定されたファイルまたはディレクトリをリモートホストに転送します。 転送先の指定方法は 2 通りあります。 .Ar host がすでに 指定されている場合、リモートホスト上に作成されるファイル名を指定します。もしく は .Ar hosts:filename のようにリモートホストとファイル名の両者を指定します。後者 の形式が使用される場合、最後に指定されたリモートホスト名が以後のファイル転送の 対象ホストとなります。また、ディレクトリを指定してリモートへのファイル転送を行 なう場合、リモートホストは .Tn UNIX マシンとみなされます。 IPv6 数値アドレスを .Ar hosts に指定する必要がある場合、コロンの区別ができるように、 .Ar [hosts]:filename のように角括弧で括ってください。 .Pp .It Cm quit .Nm を終了します。EOF (^D) を入力した場合も同様です。 .Pp .It Cm rexmt Ar retransmission-timeout パケット毎の再送タイムアウト時間を秒単位で設定します。 .Pp .It Cm status 現在の tftp の状態を表示します。 .Pp .It Cm timeout Ar total-transmission-timeout 全体の転送タイムアウト時間を、秒単位で設定します。 .Pp .It Cm trace トグル動作でパケットトレース機能の ON/OFF を設定します。 .Pp .It Cm verbose トグル動作でバーボーズモードの ON/OFF を設定します。 .El .Sh バグ .Tn TFTP プロトコルには、ユーザ認証機構がないために、リモートマシン上のファイルには 何らかの種類のアクセス制限が生じることがあります。それらに関してはいろいろな例 があるため、ここには記述しません。 .Pp 33488896 オクテット (65535 ブロック) を越えるファイルは、 クライアントとサーバがブロックサイズのネゴシエーション (RFC1783) を サポートしていなければ、転送不可能です。 .Sh 歴史 .Nm コマンドは .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/tip.1 b/ja_JP.eucJP/man/man1/tip.1 index 8a1b70aac0..9788235331 100644 --- a/ja_JP.eucJP/man/man1/tip.1 +++ b/ja_JP.eucJP/man/man1/tip.1 @@ -1,455 +1,456 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)tip.1 8.4 (Berkeley) 4/18/94 -.\" %FreeBSD: src/usr.bin/tip/tip/tip.1,v 1.7.2.6 2001/08/16 13:17:07 ru Exp % +.\" %FreeBSD: src/usr.bin/tip/tip/tip.1,v 1.7.2.7 2002/06/21 15:29:35 charnier Exp % .\" $FreeBSD$ .\" .Dd April 18, 1994 .Dt TIP 1 .Os .Sh 名称 .Nm tip .Nd リモートシステムとの接続を行なう .Sh 書式 .Nm .Op Fl v .Fl Ns Ns Ar speed .Ar system\-name .Nm .Op Fl v .Fl Ns Ns Ar speed .Ar phone\-number .Sh 解説 .Nm は、他のマシンとの間に全二重のコネクションを確立し、 リモートマシンへ直接ログインしてみせます。 言うまでもないことですが、コネクションを張りたいマシンに対しては、 ログインアカウント (かそれに相当するもの) がなければなりません。 .Pp 以下のオプションが使用可能です: .Bl -tag -width indent .It Fl v 冗長モードを設定します。 .El .Pp 入力された文字は通常は直接リモートマシンに転送されます (それは同様にエコーされます)。 行頭にチルダ文字 (`~') が入力された場合には、これはエスケープ文字として 働きます; 以下の組み合わせが認識されます: .Bl -tag -width flag .It Ic \&~^D No または Ic \&~ . コネクションを切断し、プログラムを終了します (リモートマシンにはログインしたままでいることもできます)。 .It Ic \&~c Op Ar name ローカルのカレントディレクトリを .Ar name で指定したものに変更します (引数が指定されない場合には、ホームディレクトリに移動します)。 .It Ic \&~! シェルを起動します (シェルを終了すると、tip に戻ります)。 .It Ic \&~> ローカルマシンのファイルをリモートマシンにコピーします。 .Nm -は、ローカルファイル名の入力プロンプトを出します。 +ユーティリティは、ローカルファイル名の入力プロンプトを出します。 .It Ic \&~< リモートシステムのファイルをローカルマシンに転送します。 .Nm -は、まず転送されるファイル名の入力プロンプトを出し、 +ユーティリティは、まず転送されるファイル名の入力プロンプトを出し、 それからリモートマシンで実行するコマンドのプロンプトを出します。 .It Ic \&~p Ar from Op Ar to リモートの .Ux ホストにファイルを送ります。put コマンドは .Nm が ``from'' ファイルを送っている間、リモートの .Ux システム上で ``cat > 'to''' コマンドを実行します。 ``to'' ファイル名が指定されない場合には、 このファイル名には ``from'' ファイル名を使用します。 このコマンドは、実際には ``~>''コマンドを .Ux システムに特定して実装したバージョンです。 .It Ic \&~t Ar from Op Ar to リモートの .Ux ホストからファイルを受信します。put コマンドと同じく、``to'' ファイル名 が指定されない場合には、このファイル名は ``from'' ファイル名と同じになります。 リモートホストでは .Nm にファイル転送を行なうために ``cat 'from';echo ^A'' を実行します。 .It Ic \&~| リモートコマンドからの出力を、ローカル .Ux プロセスへパイプを用いてリダイレクトします。 ローカル .Ux システムに送られるコマンド文字列は、シェルで処理されます。 .It Ic \&~$ ローカル .Ux プロセスからパイプを介してリモートホストへ出力します。 ローカル .Ux システムに送られるコマンド文字列は、シェルで処理されます。 .It Ic \&~C ローカルシステム上で \s-1XMODEM\s+1 などの特別なプロトコルを扱うための 子プロセスを起動します。この子プロセスは特別に用意された、次のような ファイル記述子を用いて動作します。 .Bd -literal -offset indent -compact 0 <-> 自側 tty 入力 1 <-> 自側 tty 出力 2 <-> 自側 tty 出力 3 <-> 相手側 tty 入力 4 <-> 相手側 tty 出力 .Ed .It Ic \&~# .Dv BREAK 信号をリモートホストに送信します。 必要な .Ar ioctl システムコールをサポートしていないシステムの場合には、回線速度の 変更と .Dv DEL 文字の組み合わせでブレイクをシミュレートします。 .It Ic \&~s 変数をセットします (以下の記述を参照してください)。 .It Ic \&~^Z .Nm を停止します (システムがジョブコントロールをサポートしている場合にのみ使用可能です)。 .It Ic \&~^Y ローカル側の .Nm のみ停止します (システムがジョブコントロールをサポートしている場合にのみ使用可能です); .Nm の ``リモート側'' すなわちリモートホストの表示出力については引続き走行します。 .It Ic \&~? チルダエスケープで使用できるコマンド一覧を表示します。 .El .Pp .Nm -は、 +ユーティリティは、 .Pa /etc/remote ファイルを用いて特定システムへの接続方法を検索し、他システムと 接続する際のパラメータを特定します; .Pa /etc/remote ファイルの完全な記述は .Xr remote 5 を参照してください。 各システムは、コネクションを確立する際にデフォルトの通信速度が決められて います。この通信速度が適当でない場合には、コマンドラインにて通信速度を 指定することができます。例えば .Ql "tip -300 mds" です。 .Pp .Nm がコネクションを確立すると、リモートホストにコネクションメッセージを 送信します; デフォルトのメッセージが存在するならば .Pa /etc/remote に定義されています ( .Xr remote 5 を参照してください)。 .Pp .Nm に引数の入力を促されている場合 (例えば、ファイル転送の設定の間) には、入力された行は標準の erase や kill 文字で編集することが許されています。 入力を促されている時に空行を入力したり操作を中断 した場合には、入力を促す画面から抜け出し、リモートマシンとの対話に戻ります。 .Pp .Nm -は、モデムや回線の排他制御や +ユーティリティは、モデムや回線の排他制御や .Xr uucico 8 で採用されているロックプロトコルを用いることで、複数のユーザが リモートシステムへ接続することを制限しています。 .Pp ファイル転送時には .Nm は転送した行数を表示します。 ~> や ~< コマンドを使用した場合には、``eofread'' 変数や ``eofwrite'' 変数は、ファイル読み込時の end-of-file 文字の認識や、ファイル書き込み時 の end-of-file 文字の指定に用いられます (後述)。ファイル転送時のフロー制御は、 通常は tandem モードで行なわれます。リモートシステムが tandem モードをサポートしない場合には、``echocheck'' が設定され、 .Nm が相手に転送した文字のエコーを用いてリモートシステムと同期します。 .Pp .Nm が他システムとの接続のために電話をかける場合には、 動作を示すさまざまな表示を行ないます。 .Nm -は AT コマンドセットを使用するモデムをサポートします。 +ユーティリティは AT コマンドセットを使用するモデムをサポートします。 .Nm -は特定のモデムを制御する方法を +ユーティリティは特定のモデムを制御する方法を .Pa /etc/modems ファイルから見つけ出します; 完全な記述は .Xr modems 5 を参照してください。 .Ss 変数 .Nm -は、自己を制御するために、 +ユーティリティは、自己を制御するために、 .Ar 変数 を取り扱います。 いくつかの変数は、一般ユーザの権限では参照のみで変更することはできません (スーパユーザのみ、これらの変数の変更が許可されています)。変数は、 ``s'' エスケープにて、参照および変更が可能です。変数設定の書式は、 .Xr vi 1 や .Xr Mail 1 での変数設定の書式と同様です。コマンドの引数に ``all'' を指定することで、 ユーザが読み出し可能なすべての変数を表示することができます。また、ユーザは 特定の変数について、変数名の最後に `?' を付加することにより、 その値を表示することができます。 例えば ``escape?'' とすることで、現在のエスケープ文字を表示します。 .Pp 変数値として採用されるものは、数値、文字列、文字、もしくは論理値です。 論理変数の設定については、単に変数名を設定するだけで設定されます; これらは、変数名の前に `!' 文字をつけることにより偽に設定 されます。他の変数型については、変数と値の間を `=' でつなぐことで設定 できます。すべての設定について、その指定中に空白を入れてはいけません。 単独の set コマンドは、変数の値を設定するだけでなく、変数の値を知るため にも用いられます。 変数は実行時に set コマンドを実行することで初期化されます ( ホームディレクトリの .Pa .tiprc ファイル中で、``~s'' プレフィックスがない場合です)。 .Fl v オプションを指定することで、 .Nm が初期化時に行なった設定を表示します。 確実に共通変数と思われるものについては、略号表記されます。 以下に共通変数およびその略号と、デフォルトの値の一覧を示します。 .Bl -tag -width Ar .It Ar beautify (論理値) セッション確立時に受けとった表示不可の文字については無視します; .Ar be と略号表記されます。 .It Ar baudrate (数値) コネクション確立時の通信速度を指定します; .Ar ba と略号表記されます。 .It Ar chardelay (数値) 各文字の送信後に待つミリ秒数を指定します; .Ar cdelay と略号表記されます。 .It Ar dialtimeout (数値) 相手先に電話をかける際に、コネクション確立までの待ち時間 (秒単位) を 指定します; .Ar dial と略号表記されます。 .It Ar echocheck (論理値) ファイル転送時のリモートホストとの同期を、 送信された最後の文字のエコーを待つことで取ります; 本変数のデフォルト値は .Ar off です。 .It Ar eofread (文字列) ~< コマンドを用いてファイル転送した場合に、 転送終了を示す文字群です; .Ar eofr と略号表記されます。 .It Ar eofwrite (文字列) ~> コマンドを用いてファイル転送した場合に、 転送終了を示すために送る文字列です; .Ar eofw と略号表記されます。 .It Ar eol (文字列) 行末を示す文字群です。 .Nm -は行末文字の直後に現れたエスケープ文字のみ、エスケープ文字として認識します。 +ユーティリティは、 +行末文字の直後に現れたエスケープ文字のみ、エスケープ文字として認識します。 .It Ar escape (文字) コマンドプレフィックス (エスケープ) 文字です; .Ar es と略号表記されます; 本変数のデフォルト値は `~' です。 .It Ar exceptions (文字列) beautification の指定で無視されない文字群を指定します; .Ar ex と略号表記されます; 本変数のデフォルト値は ``\et\en\ef\eb'' です。 .It Ar force (文字) リテラルデータ送信を強制する文字です; .Ar fo と略号表記されます; 本変数のデフォルト値は`^P'です。 .It Ar framesize (数値) ファイルを受信した場合に、ファイルシステムとの間にあるバッファに バッファリングするデータ量 (バイト単位) です; .Ar fr と略号表記されます。 .It Ar host (文字列) 接続しているホスト名です; .Ar ho と略号表記されます。 .It Ar linedelay (数値) 各行の送信後に待つミリ秒数を指定します; .Ar ldelay と略号表記されます。 .It Ar login (文字列) 接続直後に実行されるログインシェルスクリプトのパス名です; 標準入出力はリモートホストへリダイレクトされます。 パス名の先頭のチルダ文字は展開されます; .Ar li と略号表記されます。 .It Ar logout (文字列) 切断直前に実行されるシェルスクリプトのパス名です; 標準入出力はリモートホストへリダイレクトされます。 パス名の先頭のチルダ文字は展開されます; .Ar lo と略号表記されます。 .It Ar prompt (文字) リモートホストの行末文字です; .Ar pr と略号表記されます; 本変数のデフォルト値は `\en' です。本変数は、データ転送時の同期を取るのに 用いられます。ファイル転送時に行なう転送行のカウントは、この文字を いくつ受けとったかということに基づきます。 .It Ar raise (論理値) 大文字に変換するモードです; .Ar ra と略号表記されます; 本変数のデフォルト値は .Ar off です。 本モードが有効になると、すべての小文字の文字列は、リモートホストへの転送時に .Nm によって大文字に変更されます。 .It Ar raisechar (文字) 大文字へ変換するモードの切り替えを行なう入力文字です; .Ar rc と略号表記されます; 本変数のデフォルト値は `^A' です。 .It Ar record (文字列) セッションの記録を取るファイル名です; .Ar rec と略号表記されます; 本変数のデフォルト値は ``tip.record'' です。 .It Ar script (論理値) セッションの記録を取るモードです; .Ar sc と略号表記されます; 本変数のデフォルト値は .Ar off です。 .Ar script が .Li true の場合には、 .Nm はリモートホストから転送されたすべてのデータを .Ar record に指定されたファイルに記録します。 .Ar beautify スイッチが有効になっている場合には、表示可能な .Tn ASCII 文字 (文字コードに換算して 040 から 0177 までの間) についてのみ記録されます。 beautification 規則の例外を指定する .Ar exceptions 変数による設定も有効となります。 .It Ar tabexpand (論理値) ファイル転送時にタブ文字を空白文字に展開するモードです; .Ar tab と略号表記されます。 本変数のデフォルト値は .Ar false です。 本モードが有効になっている場合には、タブ文字は空白文字 8 つに展開されます。 .It Ar verbose (論理値) 冗長モードです; .Ar verb と略号表記されます; 本変数のデフォルト値は .Ar true です。 冗長モードが有効になっている場合には、 .Nm はダイヤル時にメッセージを出力したり、ファイル転送を行なっている際の 現在の転送行数を指定したりします。 .El .Sh 環境変数 .Nm -は、以下の環境変数を参照します: +ユーティリティは、以下の環境変数を参照します: .Bl -tag -width Fl .It Ev SHELL (文字列) ~! コマンド実行時に使用するシェルの名前です; デフォルト値は ``/bin/sh'' であり、環境変数に別の値が設定されている場合には、そちらの 値を参照します。 .It Ev HOME (文字列) ~c コマンド実行時に用いるホームディレクトリです; デフォルト値は、 実行時の環境によります。 .It Ev HOST 指定がない場合のデフォルトの接続先を指定します。 .El .Pp 変数 .Ev ${REMOTE} と .Ev ${PHONES} も、エクスポートされます。 .Sh 関連ファイル .Bl -tag -width /var/spool/lock/LCK..* -compact .It Pa /etc/modems システムごとのモデム設定データベース。 .It Pa /etc/remote システムごとのリモートシステム記述ファイル。 .It Pa /etc/phones システムごとの電話番号データベース。 It Ev ${REMOTE} ユーザごとに持てるリモートシステム記述ファイル。 .It Ev ${PHONES} ユーザごとに持てる電話番号データベース。 .It Pa ~/.tiprc 初期化ファイル。 .It Pa tip.record 記録ファイル。 .It Pa /var/log/aculog 回線アクセス記録。 .It Pa /var/spool/lock/LCK..* .Xr uucp 1 との回線競合を避けるための回線排他制御ファイル。 .El .Sh 診断 診断メッセージは、そのまま読んで解釈可能です。 .Sh 関連項目 .Xr cu 1 , .Xr remote 5 , .Xr phones 5 .Sh 歴史 .Nm は .Bx 4.2 から登場しました。 .Sh バグ すべての変数が文書化されているわけではありません。文書化されていないものは おそらく削除されるでしょう。 diff --git a/ja_JP.eucJP/man/man1/true.1 b/ja_JP.eucJP/man/man1/true.1 index 94d62f26e0..59db9ed90c 100644 --- a/ja_JP.eucJP/man/man1/true.1 +++ b/ja_JP.eucJP/man/man1/true.1 @@ -1,65 +1,65 @@ .\" Copyright (c) 1983, 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)true.1 8.1 (Berkeley) 6/9/93 -.\" %FreeBSD: src/usr.bin/true/true.1,v 1.5.2.4 2001/12/14 15:53:31 ru Exp % +.\" %FreeBSD: src/usr.bin/true/true.1,v 1.5.2.5 2002/06/21 15:29:38 charnier Exp % .\" $FreeBSD$ .\" .Dd June 9, 1993 .Dt TRUE 1 .Os .Sh 名称 .Nm true .Nd 「真」の値を返す .Sh 書式 .Nm .Sh 解説 .Nm ユーティリティは、常に、0 の終了コードを返します。 .Pp シェルによっては、本ユーティリティと同一の、組み込みの .Nm コマンドを提供しています。 .Xr builtin 1 マニュアルページを参照してください。 .Sh 関連項目 .Xr builtin 1 , .Xr csh 1 , .Xr false 1 , .Xr sh 1 .Sh 規格 .Nm -は +ユーティリティは .St -p1003.2 互換であるはずです。 diff --git a/ja_JP.eucJP/man/man1/truss.1 b/ja_JP.eucJP/man/man1/truss.1 index 8c795ee23c..e9ca141d81 100644 --- a/ja_JP.eucJP/man/man1/truss.1 +++ b/ja_JP.eucJP/man/man1/truss.1 @@ -1,75 +1,75 @@ -.\" %FreeBSD: src/usr.bin/truss/truss.1,v 1.5.2.5 2001/08/16 13:17:08 ru Exp % +.\" %FreeBSD: src/usr.bin/truss/truss.1,v 1.5.2.6 2002/06/21 15:29:40 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/truss.1,v 1.7 2001/07/29 05:14:53 horikawa Exp $ +.\" $FreeBSD$ .Dd November 23, 1997 .\" .\" WORD: trace トレース(する)[ktrace.1, mtrace.8] .\" .Dt TRUSS 1 .Os .Sh 名称 .Nm truss .Nd システムコールをトレースする .Sh 書式 .Nm .Op Fl S .Op Fl o Ar file .Fl p Ar pid .Nm .Op Fl S .Op Fl o Ar file command .Op args .Sh 解説 .Nm -は指定したプロセスやプログラムが呼び出すシステムコールを +ユーティリティは、指定したプロセスやプログラムが呼び出すシステムコールを トレースします。出力は指定した出力ファイルか、デフォルトでは 標準エラー出力へ送られます。処理は .Xr procfs 5 でプロセスを監視し、それを停止させたり再開させて行なわれます。 .Pp オプションは以下のとおりです : .Bl -tag -width indent .It Fl S プロセスが受信するシグナルについての情報は表示しません。 (通常、 .Nm はシステムコールイベントと同様、シグナル情報も表示します。) .It Fl o Ar file 出力を標準エラー出力ではなく、指定したファイル .Ar file へ送ります。 .It Fl p Ar pid 新しくコマンドを起動するのではなく、指定したプロセス ID .Ar pid のプロセスを追います。 .It Ar command Op args コマンド .Ar command を実行し、そのシステムコールをトレースします。 (オプション .Fl p と .Ar command は互いに排他的にしか使用できません。) .El .Sh 使用例 # "hello" を echo する際に使われるシステムコールを追います .Dl $ truss /bin/echo hello # 同じことをしますが、出力をファイルに書き込みます .Dl $ truss -o /tmp/truss.out /bin/echo hello # すでに動作しているプロセスを追います .Dl $ truss -p 1 .Sh 関連項目 .Xr kdump 1 , .Xr ktrace 1 , .Xr procfs 5 .Sh 歴史 .Nm コマンドは .An Sean Eric Fagan が .Fx 用に作成しました。 System V Release 4 や SunOS で利用可能な 類似のコマンドをモデルにしました。 diff --git a/ja_JP.eucJP/man/man1/tset.1 b/ja_JP.eucJP/man/man1/tset.1 index 748484e3ac..d016404865 100644 --- a/ja_JP.eucJP/man/man1/tset.1 +++ b/ja_JP.eucJP/man/man1/tset.1 @@ -1,394 +1,393 @@ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)tset.1 8.1 (Berkeley) 6/9/93 -.\" %FreeBSD: src/usr.bin/tset/tset.1,v 1.5.2.3 2001/08/16 13:17:09 ru Exp % +.\" %FreeBSD: src/usr.bin/tset/tset.1,v 1.5.2.4 2002/06/21 15:29:42 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/tset.1,v 1.8 2001/07/29 05:14:53 horikawa Exp $ +.\" $FreeBSD$ .\" Original Regision: 1.2.2.1 .\" .Dd June 9, 1993 .Dt TSET 1 .Os .Sh 名称 .Nm tset , .Nm reset .Nd 端末を初期化する .Sh 書式 .Nm .Op Fl IQrSs .Op Fl .Op Fl e Ar ch .Op Fl i Ar ch .Op Fl k Ar ch .Op Fl m Ar mapping .Op Ar terminal .Nm reset .Op Fl IQrSs .Op Fl .Op Fl e Ar ch .Op Fl i Ar ch .Op Fl k Ar ch .Op Fl m Ar mapping .Op Ar terminal .Sh 解説 .Nm -は端末を初期化します。まず最初に -.Nm -は使用中の端末タイプを判別 -します。判別方法は、以下の値を順番に調べ、最初に見つかった端末タイプを +ユーティリティは、端末を初期化します。 +まず最初に本ユーティリティは使用中の端末タイプを判別します。 +判別方法は、以下の値を順番に調べ、最初に見つかった端末タイプを 利用するという方法です。 .Pp .Bl -bullet -compact -offset indent .It コマンドライン上で指定した .Ar terminal 引数 .It 環境変数 .Ev TERM の値 .It 利用中の標準エラー出力デバイスに対応する、 .Pa /etc/ttys 内のエントリで定義している端末タイプ .It デフォルトの端末タイプである ``unknown'' .El .Pp 端末タイプがコマンドラインで指定されない時は、 .Fl m オプションのマッピングはその後に適用されます (詳細は下を参照)。 その後、もし端末タイプの前に ``?'' がついていたならば、端末タイプの確認用のプロンプトが出ます。空行を 与えるとその端末タイプになりますが、別の新しい端末タイプを入力することも 可能です。いったん端末タイプが決定すれば、その端末用の termcap エントリが 検索されます。termcap エントリが見つからない場合は、もう一度プロンプトが 出ます。 .Pp いったん termcap エントリが見つかれば、(他にもたくさんある中で) 画面サイズ、バックスペース、インタラプト、行消去のキャラクタがセットされ、 端末の初期化およびタブの初期化の文字列が標準エラー出力に送られます。 最後に、もし、消去、インタラプト、行削除のキャラクタが変更される、もしくは そのデフォルト値が未設定であれば、その値が標準エラー出力に表示されます。 .Pp .Nm が .Nm reset として起動された時は、上で述べた端末初期化が行なわ れる前に、端末を cooked モード、echo モードにセットし、cbreak モード、 raw モードをオフにし、newline 変換を有効にし、 未設定の特殊キャラクタをデフォルト値でリセットします。 これは、プログラムが端末を異常な状態にしたまま死んだ時に有用です。 端末が異常な状態にあるときにはキャリッジリターンが働かないことがあるので、 端末を正常に戻すためには .Dq Li reset (ラインフィードキャラクタは通常 コントロール-J です) とタイプしなければいけないかもしれないということに 注意して下さい。また、端末がコマンドのエコーを行なわなくなっているかも しれません。 .Pp オプションは以下のものがあります: .Bl -tag -width flag .It Fl 端末タイプが標準出力に表示されます。端末は初期化されません。 .It Fl e erase キャラクタを .Ar ch にします。 .It Fl I 端末初期化文字列もしくはタブ初期化文字列を端末に送りません。 .It Fl i インタラプトキャラクタを .Ar ch にします。 .It Fl k 行削除のキャラクタを .Ar ch にします。 .It Fl m ポートタイプから端末へのマッピングを指定します。詳細は下を参照して下さい。 .It Fl Q 消去、インタラプト、行削除の値を表示しません。 .It Fl r 端末タイプを標準エラー出力に表示します。 .It Fl S 端末タイプと termcap エントリを標準出力に表示します。 環境設定についての詳細は以下のセクションを参照して下さい。 .It Fl s 環境変数 .Ev TERM と .Ev TERMCAP を初期化する shell コマンド列を標準出力に書きます。 環境変数の設定についての詳細は以下のセクションを参照して下さい。 .El .Pp .Fl e , .Fl i , .Fl k オプションの引数は、実際のキャラクタを 書くか、もしくは .Dq ハット記号 を使って (すなわち コントロール-h なら .Dq Li ^H もしくは .Dq Li ^h ) 記述して下さい。 .Sh 環境設定 しばしば、端末タイプと端末の能力についての情報を shell の環境変数に設定する 必要がでてきます。これは .Fl S と .Fl s のオプションで行ないます。 .Fl S オプションが指定された時、端末タイプと termcap エントリが 標準出力に表示されます。この出力はスペースで区切られており、最後に 改行がつきません。また、この出力は .Nm csh , .Nm ksh やその他の shell の配列に 代入できます。 .Pp .Fl s オプションが指定された場合は shell の環境変数を設定するための コマンドが標準出力に書かれます。このコマンドは、環境変数 .Ev SHELL の設定値が ``csh'' で終っていれば .Nm csh 用の、それ以外は .Nm sh 用のものとなります。 .Nm csh 用のコマンドの場合は .Dq noglob シェル変数の set と unset が行なわれ、 unset したままになることに注意して下さい。以下の行を .Pa .login や .Pa .profile に記述すれば環境変数を正しく初期化できます: .Bd -literal -offset indent eval \`tset -s options ... \` .Ed .Pp .Fl S オプションの使い方を簡単に説明すると、 .Pa .login に以下のような記述をすると上と同じような効果が得られます: .Bd -literal -offset indent set noglob set term=(`tset -S options ...`) setenv TERM $term[1] setenv TERMCAP "$term[2]" unset term unset noglob .Ed .Sh 端末タイプへのマッピング 端末がシステムに組み込まれていない場合 (或は現在のシス テム情報が正しくない場合) .Pa /etc/ttys ファイル 或は .Ev TERM 環境変数から得た端末タイプは .Dq network , .Dq dialup , .Dq unknown のような generic になることがあります。 .Nm がスタートアップスクリプト ( .Xr sh 1 を使う場合は .Pa .profile 、 .Xr csh 1 を使う場合は .Pa .login ) で使われる場合は、しばしば、そのようなポートで使われる端末のタイプ の情報を提供する必要があります。 .Fl m オプションの目的は、端末タイプの状態リストから .Dq map すること、すなわち .Nm に ``もしこのポートがある特定のスピードであるならば、ある種の端末であることを 推定しなさい''という情報を伝えることです。 .Pp .Fl m オプションの引数は、ポートタイプ、オペレータ、ボーレート、コロン(``:'') と端末タイプからなります。 ポートタイプは (オペレータ或はコロン文字によって区切られた) 文字列で表し ます。オペレータは、 .Dq Li \&> , .Dq Li \&< , .Dq Li \&@ , .Dq Li !\& の組合せになります。 .Dq Li \&> は「より大きい」を意味し、 .Dq Li \&< は「より小さい」を意味し、 .Dq Li \&@ は「等しい」を意味し、 そして .Dq Li !\& は「test の評価結果の反対」を意味します。 ボーレートは数値として表され、 (コントロール端末である べき) 標準エラー出力のスピードと比較されます。 端末タイプは文字列です。 .Pp もし端末タイプがコマンドラインで示されなければ、 .Fl m マッピングが端末タイプに適用されます。 もしポートタイプとボーレートがマッピングと一致すると、マッピングで示された端 末タイプでカレントタイプを置き換えます。もし、一つ以上のマッピングが示さ れた場合には、最初に適合したマッピングを使います。 .Pp 例えば、 .Dq Li dialup>9600:vt100 というマッピングを考えます。 ポートタイプは .Dq Li dialup 、オペレータは .Dq Li > 、ボーレートは .Dq Li 9600 、そして端末タイプは .Dq Li vt100 です。 このマッピングの結果、ターミナルタイプが .Dq Li dialup で、ボーレートが 9600 ボーより大きければ、端末タイプ .Dq Li vt100 が使われます。 .Pp ポートタイプがない場合は、端末タイプは任意のポートタイプに一致します。 例えば、 .Dq Li -m dialup:vt100 -m :?xterm では、任意のダイヤルアップポートにおいて、 ボーレートを無視してターミナルタイプを .Dq Li vt100 に一致させます。そして、ダイヤルアップ以外のポートをターミナルタイプ .Dq Li ?xterm に一致させます。 ?xterm はクエスチョンマークが先頭に付いているので、実際に .Ar xterm ターミナルを使っているかどうかについてデフォルトポートで 確認を求められことに注意して下さい。 .Pp .Fl m オプションでの引数に空白は許されません。 メタキャラクタの問題を避けるために、 .Fl m オプションの引数全体はシングルコーテーションで囲むこと、そして .Nm csh を使っている場合は、すべてのイクスクラメーションマーク (``!'') の前に バックスラッシュ (``\e'') をいれることを推奨します。 .Sh 環境変数 .Nm コマンドは、環境変数 .Ev SHELL および .Ev TERM を利用します。 .Sh 関連ファイル .Bl -tag -width /usr/share/misc/termcap -compact .It Pa /etc/ttys システムポート名から端末タイプへのマッピングを記述したデータベース .It Pa /usr/share/misc/termcap termcap データベース .El .Sh 関連項目 .Xr csh 1 , .Xr sh 1 , .Xr stty 1 , .Xr tty 4 , .Xr termcap 5 , .Xr ttys 5 , .Xr environ 7 .Sh 歴史 .Nm は .Bx 3.0 から現れました。 .Sh 互換性 .Fl A , .Fl E , .Fl h , .Fl u , .Fl v オプションは .Nm ユーティリティから削除されました。 これらは .Bx 4.3 のドキュメントにはなく、限られた用途しかありません。 .Fl a , .Fl d , .Fl p オプションも同様に、ドキュメントにないか有用ではありませんが、 広く使われるので残されています。これら3つのオプショ ンの代わりに、 .Fl m オプションを使うことが強く推奨されています。 .Fl n オプションは残っていますが、無効です。 .Fl e , .Fl i , .Fl k オプションは引数なしに使うことがまだ許されていますが、 このような使用法は、 文字を明示的に指定するよう修正されることが 強く推奨されています。 .Pp .Nm reset として .Nm を実行する場合には、 .Fl Q オプションは使いません。 .Nm の幾つかの歴史的な実装上での .Fl オプションと 引数 .Ar terminal の間の干渉は排除されています。 .Pp 最後に, .Nm の実装は ( .St -p1003.1-88 に従うシステムへの追加の一部として ) 完全にやり直されました。 もはや古い端末インターフェースのシステムの上では コンパイルはされないでしょう。 diff --git a/ja_JP.eucJP/man/man1/tsort.1 b/ja_JP.eucJP/man/man1/tsort.1 index 898564ab23..92f25162b4 100644 --- a/ja_JP.eucJP/man/man1/tsort.1 +++ b/ja_JP.eucJP/man/man1/tsort.1 @@ -1,93 +1,94 @@ .\" Copyright (c) 1990, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" .\" This manual is derived from one contributed to Berkeley by .\" Michael Rendell of Memorial University of Newfoundland. .\" .\" 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. .\" .\" @(#)tsort.1 8.3 (Berkeley) 4/1/94 -.\" %FreeBSD: src/usr.bin/tsort/tsort.1,v 1.7.2.1 2001/07/22 12:40:39 dd Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/tsort.1,v 1.4 2001/05/14 01:07:30 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/tsort/tsort.1,v 1.7.2.2 2002/06/21 15:29:45 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 1, 1994 .Dt TSORT 1 .Os .Sh 名称 .Nm tsort .Nd 有向グラフのトポロジカルソートを行う .Sh 書式 .Nm .Op Fl d .Op Fl l .Op Fl q .Op Ar file .Sh 解説 .Nm -はグラフの有向アークを表現するノード名の対を列挙したもの入力とし、 +ユーティリティは、 +グラフの有向アークを表現するノード名の対を列挙したもの入力とし、 トポロジカルな順序でノード名を標準出力に出力します。 入力は指定されたファイル .Ar file から、あるいは指定がない場合は標準入力から読み込みます。 .Pp 入力においてノード名は空白で区切ります。 ノードの数は偶数個でなければなりません。 .Pp グラフ中のノードは 自分自身へのアークを持つノードとして記述することができます。 これはノードが他のノードと接続されていない場合に有用です。 .Pp グラフがサイクルを含んでいる(そのままではソートできない)場合、 サイクル上の 1 つのアークを無視してソートを続行します。 サイクルは標準エラー出力に報告されます。 .Pp オプションは以下の通り: .Bl -tag -width Ds .It Fl d デバッグ機能を有効にします。 .It Fl l 最長サイクルを検索して表示します。 かなり時間がかかる場合があります。 .It Fl q サイクルに関して詳しい情報を表示しません。 これは主としてライブラリ構築向けです。 その場合必ずしも最適な順序を求める必要はなく、 サイクルもしばしば含まれます。 .El .Sh 関連項目 .Xr ar 1 .Sh 歴史 .Nm コマンドは .At v7 で登場しました。 本 .Nm tsort コマンドとマニュアルは Memorial University of Newfoundland の Michael Rendell による Berkeley に提供されたコードをベースにしています。 diff --git a/ja_JP.eucJP/man/man1/tty.1 b/ja_JP.eucJP/man/man1/tty.1 index 42a9e92e37..0101556c91 100644 --- a/ja_JP.eucJP/man/man1/tty.1 +++ b/ja_JP.eucJP/man/man1/tty.1 @@ -1,78 +1,79 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" @(#)tty.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/tty/tty.1,v 1.6 1999/08/28 01:07:01 peter Exp % +.\" %FreeBSD: src/usr.bin/tty/tty.1,v 1.6.2.1 2002/06/21 15:29:47 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt TTY 1 .Os .Sh 名称 .Nm tty .Nd 端末名を返す .Sh 書式 .Nm .Op Fl s .Sh 解説 .Nm -は、標準入力になっている端末の名前を標準出力へ出力します。この名前は、 +ユーティリティは、標準入力になっている端末の名前を標準出力へ出力します。 +この名前は、 .Xr ttyname 3 で得られる文字列です。標準入力が端末でない場合は、 ``not a tty'' と出力します。 オプションとしては以下のものがあります。 .Bl -tag -width Ds .It Fl s 端末名を表示しません。結果は終了コードだけに反映されます。ただし、この オプションを使うよりは .Dq Li "test -t 0" コマンドを使ったほうがよりよいでしょう。 .El .Pp .Nm -は標準入力が端末だった場合は 0 を、端末でなかった場合 +ユーティリティは、標準入力が端末だった場合は 0 を、端末でなかった場合 は 1 を、エラーが起きた場合は 2 以上の値を返します。 .Sh 関連項目 .Xr test 1 , .Xr ttyname 3 .Sh 規格 .Nm ユーティリティは .St -p1003.2-92 準拠であると考えられています。 .Sh 歴史 .Nm コマンドは .At v1 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/ul.1 b/ja_JP.eucJP/man/man1/ul.1 index 771ab972f1..20a7737124 100644 --- a/ja_JP.eucJP/man/man1/ul.1 +++ b/ja_JP.eucJP/man/man1/ul.1 @@ -1,115 +1,115 @@ .\" %NetBSD: ul.1,v 1.3 1994/12/07 00:28:23 jtc Exp % .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. 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 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. -.\" %FreeBSD: src/usr.bin/ul/ul.1,v 1.6.2.3 2001/08/16 13:17:09 ru Exp % .\" .\" @(#)ul.1 8.1 (Berkeley) 6/6/93 -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ul.1,v 1.7 2001/08/19 10:25:03 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/ul/ul.1,v 1.6.2.4 2002/06/21 15:29:52 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt UL 1 .Os .Sh 名称 .Nm ul .Nd 入力中のアンダライン生成コードを端末のシーケンスに変換する .Sh 書式 .Nm .Op Fl i .Op Fl t Ar terminal .Op Ar name Ar ... .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar file が指定されていればそのファイルを、指定されていなければ標準入力を読み 込み、アンダラインを表示すべき部分を、環境変数 .Ev TERM で定義されている 端末にあわせてアンダラインを表示するシーケンスに変換します。 アンダラインのシーケンスを決定するために、 .Pa /etc/termcap が読み込まれます。 端末がアンダライン機能を持たず、強調表示機能を持っている場合に は、強調表示をかわりに使用します。もし端末が二重印字できる場合、 すなわち端末自体にアンダラインを扱う機能がある場合には、 .Nm は .Xr cat 1 と同じになります。 端末がアンダラインを扱えない場合は、アンダラインを無視します。 .Pp オプションとしては以下のものがあります。 .Bl -tag -width Ds .It Fl i アンダラインのかわりに、次の行の当該位置にダッシュ `\-' を表示し ます。画面上で .Xr nroff 出力でアンダラインを見たいときには有効です。 .It Fl t Ar terminal .Ar terminal で端末を指定します。デフォルトでは環境変数 .Ev TERM の値が使用されます。 .El .Sh 環境変数 .Bl -tag -width TERM .It Ev TERM tty デバイスの能力を表します ( .Xr termcap 5 参照)。 通常、環境変数 .Ev TERM は、ログイン時に、 .Pa /etc/ttys に指定されたデフォルト端末タイプか、ユーザのログインプロセ スのなかで .Pa login ファイル ( .Xr environ 7 参照) によって設定されます。 .El .Sh 関連項目 .Xr colcrt 1 , .Xr man 1 , .Xr nroff 1 .Sh バグ .Xr nroff 1 は、通常、 バックスペースとアンダライン文字の組とテキストとを交互に出力し、 アンダラインを表します。 .Nm は、このカーソルの逆方向への移動の最適化までは行ないません。 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/uniq.1 b/ja_JP.eucJP/man/man1/uniq.1 index 33fb4e164d..29e3664fe2 100644 --- a/ja_JP.eucJP/man/man1/uniq.1 +++ b/ja_JP.eucJP/man/man1/uniq.1 @@ -1,130 +1,140 @@ .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the Institute of Electrical and Electronics Engineers, Inc. .\" .\" 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. .\" .\" From: @(#)uniq.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/uniq/uniq.1,v 1.5.2.3 2002/05/29 16:59:31 trhodes Exp % +.\" %FreeBSD: src/usr.bin/uniq/uniq.1,v 1.5.2.4 2002/06/21 05:18:59 tjr Exp % .\" .\" $FreeBSD$ .Dd June 6, 1993 .Dt UNIQ 1 .Os .Sh 名称 .Nm uniq .Nd ファイル内の重複行の報告または、フィルタ出力 .Sh 書式 .Nm .Op Fl c | Fl d | Fl u .Op Fl i .Op Fl f Ar num .Op Fl s Ar chars .Oo .Ar input_file .Op Ar output_file .Oc .Sh 解説 .Nm -ユーティリティは、標準入力を読み込み、隣り合う行同士を比較し、 -重複した行を取り除いて標準出力へ書き込みます。 +ユーティリティは、 +.Ar input_file +を読み込み、隣り合う行同士を比較し、 +重複した行を取り除いて +.Ar output_file +へ書き込みます。 +.Ar input_file +が単一のダッシュ +.Pq Sq \&- +または無い場合、標準入力が読み込まれます。 +.Ar output_file +が無い場合、標準出力が出力として使用されます。 隣り合った行が同じ内容だったら 2 行目以降を出力しません。 同じ内容でも行が隣り合っていない場合は比較の対象になりませんので、 まずファイルをソートする事が必要になるかもしれません。 .Pp オプションとしては以下のものがあります: .Bl -tag -width Ds .It Fl c 各出力行の先頭に、行が入力中に続けて出現した回数を表示し、空白一つあけて その行の内容を表示します。 .It Fl d 重複した行のみを出力します。 .It Fl f Ar num 比較する時に、各入力行の先頭から .Ar num 個のフィールドを無視します。 フィールドとは、空白文字で区切られた、空白以外の文字からなる文字列です。 .Ar num を指定するときは、最初のフィールドを 1 として数えます。 .It Fl s Ar chars 比較する時に、各入力行の先頭から .Ar chars 文字を無視します。 本オプションを .Fl f オプションと一緒に指定した場合は、 .Ar num 個のフィールドに続く .Ar chars 文字が無視されます。 .Ar chars を指定するときは、最初の文字を 1 として数えます。 .It Fl u 入力の重複がなかった行のみを出力します。 .It Fl i 行の比較において大文字小文字を区別しません。 .\".It Fl Ns Ar n .\"(Deprecated; replaced by .\".Fl f ) . .\"Ignore the first n .\"fields on each input line when doing comparisons, .\"where n is a number. .\"A field is a string of non-blank .\"characters separated from adjacent fields .\"by blanks. .\".It Cm \&\(pl Ns Ar n .\"(Deprecated; replaced by .\".Fl s ) . .\"Ignore the first .\".Ar m .\"characters when doing comparisons, where .\".Ar m .\"is a .\"number. .El .Pp コマンドラインにさらに引数が指定されると、その最初の引数を入力ファイルの 名前として使用し、その次の引数を出力ファイルの名前として使用します。 .Sh 診断 .Ex -std .Sh 互換性 古くからある .Cm \&\(pl Ns Ar number と .Fl Ns Ar number のオプションは時代遅れですが、この実装ではまだサポートしています。 .Sh 関連項目 .Xr sort 1 .Sh 規格 .Nm ユーティリティは、 .St -p1003.2 互換であるはずです。 diff --git a/ja_JP.eucJP/man/man1/unvis.1 b/ja_JP.eucJP/man/man1/unvis.1 index 1fa9a5ccd3..b59ef4ba41 100644 --- a/ja_JP.eucJP/man/man1/unvis.1 +++ b/ja_JP.eucJP/man/man1/unvis.1 @@ -1,60 +1,60 @@ .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)unvis.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/unvis/unvis.1,v 1.5.2.1 2001/08/16 13:17:10 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/unvis.1,v 1.3 2001/05/14 01:07:30 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/unvis/unvis.1,v 1.5.2.2 2002/06/21 15:29:57 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt UNVIS 1 .Os .Sh 名称 .Nm unvis .Nd "表示できるように変換されたデータを元の形式に戻す" .Sh 書式 .Nm .Op Ar .Sh 解説 -.Nm unvis -は、 +.Nm +ユーティリティは、 .Xr vis 1 の逆関数です。 表示できるように変換されたデータを 元の形式に戻し、標準出力に出力します。 .Sh 関連項目 .Xr vis 1 , .Xr unvis 3 , .Xr vis 3 .Sh 歴史 .Nm コマンドは .Bx 4.4 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/usbhidctl.1 b/ja_JP.eucJP/man/man1/usbhidctl.1 index 160610034d..40e8b4a362 100644 --- a/ja_JP.eucJP/man/man1/usbhidctl.1 +++ b/ja_JP.eucJP/man/man1/usbhidctl.1 @@ -1,93 +1,94 @@ .\" $NetBSD: usbhidctl.1,v 1.8 1999/05/11 21:03:58 augustss Exp $ -.\" %FreeBSD: src/usr.bin/usbhidctl/usbhidctl.1,v 1.2.2.1 2002/04/03 16:48:25 joe Exp % +.\" %FreeBSD: src/usr.bin/usbhidctl/usbhidctl.1,v 1.2.2.2 2002/06/21 15:29:59 charnier Exp % .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Lennart Augustsson. .\" .\" 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 NetBSD .\" Foundation, Inc. and its contributors. .\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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. .\" .\" $FreeBSD$ .Dd July 12, 1998 .Dt USBHIDCTL 1 .Os .Sh 名称 .Nm usbhidctl .Nd USB HID 機器の操作 .Sh 書式 .Nm .Op Fl a .Fl f Ar device .Op Fl l .Op Fl n .Op Fl r .Op Fl t Ar table .Op Fl v .Op Ar item ... .Sh 解説 .Nm -を使うと USB HID (Human Interface Device) の状態のダンプをとることができます。 +ユーティリティを使うと、 +USB HID (Human Interface Device) の状態のダンプをとることができます。 指定された .Ar item それぞれが表示されます。 .Pp 以下のオプションが利用できます。 .Bl -tag -width Ds .It Fl a すべての item を表示します。 .It Fl f Ar device 操作するデバイスのパスを指定します。 .It Fl l デバイスのデータが変化するたびに、繰り返しダンプを取ります。 .It Fl n 機器名の表示を抑制します。 .It Fl r レポート記述子のダンプを取ります。 .It Fl t Ar table HID 使用法テーブルファイルのパスを指定します。 .It Fl v 詳細な表示をします。 .El .Sh 関連ファイル .Pa /usr/share/misc/usb_hid_usages デフォルトの HID 使用法テーブル .Sh バグ .Nm -では機器の出力と特長を見ることも設定することもできません。 +ユーティリティでは機器の出力と特長を見ることも設定することもできません。 .Sh 関連項目 .Xr usb 3 , .Xr uhid 4 , .Xr usb 4 .Sh 歴史 .Nm コマンドは .Nx 1.4 で登場しました。 diff --git a/ja_JP.eucJP/man/man1/users.1 b/ja_JP.eucJP/man/man1/users.1 index a74d41add8..0d6b819b2a 100644 --- a/ja_JP.eucJP/man/man1/users.1 +++ b/ja_JP.eucJP/man/man1/users.1 @@ -1,61 +1,62 @@ .\" Copyright (c) 1980, 1990, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)users.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/users/users.1,v 1.5.2.1 2001/08/16 13:17:10 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/users.1,v 1.4 2001/07/29 05:14:53 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/users/users.1,v 1.5.2.2 2002/06/21 15:30:01 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt USERS 1 .Os .Sh 名称 .Nm users .Nd 現在のユーザのリスト .Sh 書式 .Nm .Sh 解説 .Nm -は、システムに現在いるユーザのログイン名のリストを表示しま -す。リストは、空白で区切られ、ソートされて、1 行で表示されます。 +ユーティリティは、 +システムに現在いるユーザのログイン名のリストを表示します。 +リストは、空白で区切られ、ソートされて、1 行で表示されます。 .Sh 関連ファイル .Bl -tag -width /var/run/utmp .It Pa /var/run/utmp .El .Sh 関連項目 .Xr finger 1 , .Xr last 1 , .Xr who 1 , .Xr utmp 5 .Sh 歴史 .Nm コマンドは .Bx 3.0 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/vgrind.1 b/ja_JP.eucJP/man/man1/vgrind.1 index d627452c3b..29a4fdcae3 100644 --- a/ja_JP.eucJP/man/man1/vgrind.1 +++ b/ja_JP.eucJP/man/man1/vgrind.1 @@ -1,238 +1,238 @@ .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)vgrind.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/vgrind/vgrind.1,v 1.7.2.2 2001/08/16 13:17:13 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/vgrind.1,v 1.5 2001/07/29 05:14:53 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/vgrind/vgrind.1,v 1.7.2.3 2002/06/21 15:30:04 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt VGRIND 1 .Os .Sh 名称 .Nm vgrind .Nd プログラムのソースを清書する .Sh 書式 .Nm .Op Fl .Op Fl W .Op Fl d Ar file .Op Fl f .Op Fl h Ar header .Op Fl l Ns Ar language .Op Fl n .Op Fl p Ar postproc .Op Fl sn .Op Fl t .Op Fl x .Ar name Ar ... .Sh 解説 .Nm -は、プログラムのソースを +ユーティリティは、プログラムのソースを .Xr troff 1 を使って清書します。コメント はイタリック体で、キーワードはボールド体で、現在印刷中の関数名は、 各ページの余白部分に列挙されます。 .Pp .Nm -には 2 つの基本的なモード、フィルタモード( +ユーティリティには 2 つの基本的なモード、フィルタモード( .Fl f オプションの項を参照)と 標準モードがあります。フィルタモードでは、 .Nm は .Xr tbl 1 と同様 に振る舞います。すなわち、以下の .Em "troff ライク" なマクロに囲まれた部分以外 は素通しします。 .Bl -tag -width Ds .It \&.vS 処理領域開始 .It \&.vE 処理領域終了 .El .Pp マクロに囲まれた行は既に示したように清書されます。 .Nm からの出力を .Xr troff に渡すことにより印刷することができます。 .Xr eqn 1 や .Xr tbl 1 との呼び出し順序には特別な制限はありません。 .Pp 通常モードでは、 .Nm は入力ファイル全体を処理し、 ポストプロセッサを起動して出力処理を行わせます。 ポストプロセッサのデフォルトは .Xr psroff 1 です .Pp どちらのモードでも、 .Nm はピリオドで開始する行は変更せずに出力します。 .Pp オプションは以下のとおりです。 .Bl -tag -width Ar .It Fl 標準入力から読み込みます( .Fl f オプションが指定された場合はデフォルトです)。 .It Fl W (ナロー)バリアン用ではなく、(ワイド)バーサテックプリンタの出力を 行います。 .It Fl d Ar file プログラミング言語定義ファイルを指定します(デフォルトでは .Pa /usr/share/misc/vgrindefs を使用します)。 .It Fl f フィルタモードで動作します。 .It Fl h Ar header 各ページのヘッダ文字列を指定します(デフォルトは入力ファイル名です)。 .It Fl l 入力ファイルのプログラミング言語を指定します。現在使用可能なものは以下 のとおりです: .Tn PASCAL .Pq Fl l Ns Ar p , .Tn MODEL .Pq Fl l Ns Ar m , C .Pf ( Fl l Ns Ar c もしくはデフォルト), .Tn C++ .Pq Fl l Ns Ar c++ , .Tn CSH .Pq Fl l Ns Ar csh , .Tn SHELL .Pq Fl l Ns Ar sh , .Tn RATFOR .Pq Fl l Ns Ar r , .Tn MODULA2 .Pq Fl l Ns Ar mod2 , .Tn YACC .Pq Fl l Ns Ar yacc , .Tn LISP .Pq Fl l Ns Ar isp , .Tn ICON .Pq Fl l Ns Ar I , .Tn PERL .Pq Fl l Ns Ar perl 。 .It Fl n キーワードのボールド化を行いません。 .It Fl p Ar postproc .Ar postproc を出力のポストプロセッサとして使用します。 .Xr psroff 1 がデフォルトです。 .It Fl s 出力文字のポイントサイズを指定します(troff の .ps と同じ引数です)。 .It Fl t .Xr troff の同一のオプションと同じく、 フォーマット後、標準出力に書き出します。 .It Fl x インデックスファイルを清書します。 .Nm は、カレントディレクトリに .Pa index という名前のファイルがあればつねにインデックスを 出力します。このインデックスファイルを .Nm に .Fl x オプションととも に指定することで、清書することができます。 .El .Sh 関連ファイル .Bl -tag -width /usr/share/misc/vgrindefsxx -compact .It Pa index インデックスファイル .It Pa /usr/share/tmac/tmac.vgrind マクロパッケージ .It Pa /usr/libexec/vfontedpr プリプロセッサ .It Pa /usr/share/misc/vgrindefs 言語記述ファイル .El .Sh 関連項目 .Xr getcap 3 , .Xr vgrindefs 5 .Sh バグ vfontedpr は、以下のプログラミングスタイルを仮定しています: .Pp .Tn C 言語 \- 関数名は、空白またはアスタリスクのみからなる行の直後にあり、括 弧でくくられた引数リストが同じ行にある。 .Pp .Tn PASCAL \- 関数名は、キーワード .Em function または .Em procedure と同じ行にある。 .Pp .Tn MODEL \- 関数名は、キーワード .Em is beginproc と同じ行にある。 .Pp もし以上に従っていない場合、インデックスと余白への関数名印刷が不正確な ものになります。 .Pp その他、いくつかのプログラミングスタイルはきれいに清書されません: ブランクによってソースコードの先頭などを揃えた場合、正しくフォーマットされ ません。 .Nm を使って清書する場合は、タブによってソースコードを揃える ようにします。これは .Nm が可変幅フォントを使用するからです。 .Pp .Nm は、 .Xr ctags 1 が関数を検出する方式を採用すべきです。 .Pp フィルタモードは .Fl me または .Fl ms マクロを用いたドキュメントで、正しく動作しません。 (このモードは一体どこで使うのでしょう) .Sh 歴史 .Nm は .Bx 3.0 で追加されました。 diff --git a/ja_JP.eucJP/man/man1/vidcontrol.1 b/ja_JP.eucJP/man/man1/vidcontrol.1 index 1e422cccbe..939933185b 100644 --- a/ja_JP.eucJP/man/man1/vidcontrol.1 +++ b/ja_JP.eucJP/man/man1/vidcontrol.1 @@ -1,501 +1,501 @@ .\" .\" vidcontrol - a utility for manipulating the syscons video driver .\" .\" 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. .\" .\" @(#)vidcontrol.1 -.\" %FreeBSD: src/usr.sbin/vidcontrol/vidcontrol.1,v 1.24.2.12 2002/04/08 13:37:31 sobomax Exp % +.\" %FreeBSD: src/usr.sbin/vidcontrol/vidcontrol.1,v 1.24.2.13 2002/06/21 16:42:38 charnier Exp % .\" .\" $FreeBSD$ .Dd May 27, 2001 .Dt VIDCONTROL 1 .Os .Sh 名称 .Nm vidcontrol .Nd システムコンソールの制御と設定のユーティリティ .Sh 書式 .Nm .Op Fl CdLPpx .Op Fl b Ar color .Op Fl c Ar appearance .Oo .Fl f .Op Ar size .Ar file .Oc .Op Fl g Ar geometry .Op Fl h Ar size .Op Fl i Cm adapter | mode .Op Fl l Ar screen_map .Op Fl M Ar char .Op Fl m Cm on | off .Op Fl r Ar foreground Ar background .Op Fl s Ar number .Op Fl t Ar N | Cm off .Op Ar mode .Op Ar foreground Op Ar background .Op Cm show .Sh 解説 .Nm コマンドを用いて .Xr syscons 4 コンソールドライバの様々なオプション、例えば、 画面モード、色、カーソル形状、画面出力マップ、 フォント、スクリーンセーバタイムアウトを設定できます。 .Pp 以下のコマンドラインオプションをサポートしています: .Bl -tag -width indent .It Ar mode 新しいビデオモードを選択します。 現在サポートしているモードは次の通りです: .Ar 80x25 , .Ar 80x30 , .Ar 80x43 , .Ar 80x50 , .Ar 80x60 , .Ar 132x25 , .Ar 132x30 , .Ar 132x43 , .Ar 132x50 , .Ar 132x60 , .Ar VGA_40x25 , .Ar VGA_80x25 , .Ar VGA_80x50 , .Ar VGA_90x25 , .Ar VGA_90x30 , .Ar VGA_90x43 , .Ar VGA_90x50 , .Ar VGA_90x60 , .Ar EGA_80x25 , .Ar EGA_80x43 , .Ar VESA_132x25 , .Ar VESA_132x43 , .Ar VESA_132x50 , .Ar VESA_132x60 。 .\" また、グラフィックモード .\" .Ar VGA_320x200 , ラスタテキストモード .Ar VGA_800x600 も選択できます。 後述の .Sx ビデオモードサポート を参照してください。 .It Ar foreground Op Ar background テキストを表示する際の色を変更します。 前景色 (例: .Dq vidcontrol white ) 、あるいは 前景色および背景色 (例: .Dq vidcontrol yellow blue ) を指定することにより変更できます。 後述の .Cm show コマンドを使用して、使用可能な色を見られます。 .It Cm show 指定したプラットフォームでサポートされている色を表示します。 .It Fl b Ar color ボーダ色を .Ar color に設定します。 本オプションをビデオドライバが常にサポートしているのではないかもしれません。 .It Fl C ヒストリバッファをクリアします。 .It Fl c Cm normal | blink | destructive カーソルの外観を変更します。 カーソルは、反転ブロック .Pq Cm normal あるいは古いハードウェアカーソル様のもの .Pq Cm destructive のいずれかです。 前者は、オプションで .Cm blink にできます。 後者は実際にはシミュレートしています。 .It Fl d 現在の画面出力マップを表示します。 .It Xo .Fl f .Op Ar size .Ar file .Xc サイズ .Ar size 用のフォントをファイル .Ar file から読み込みます。 (現在のところ .Ar size には .Cm 8x8 , .Cm 8x14 , .Cm 8x16 のみが指定できます)。 フォントファイルは uuencode された形式でも 生のバイナリフォーマットでも構いません。 メニューによる .Xr vidfont 1 コマンドを使用して、好きなフォントをロード可能です。 .Pp .Ar size は省略可能です。 この場合、 .Nm はフォントファイルの大きさから、推測します。 .Pp MDA や CGA のような古いビデオカードは ソフトウェアフォントをサポートしないことに注意してください。 後述の .Sx ビデオモードサポート と .Sx 使用例 と .Xr syscons 4 のマニュアルページも参照してください。 .It Fl g Ar geometry テキストモードの .Ar geometry を、選択可能なジオメトリに設定します。 現在、 .Ar VESA_800x600 等のラスタモードのみが、本オプションをサポートします。 後述の、 .Sx ビデオモードサポート と .Sx 使用例を 参照してください。 .It Fl h Ar size ヒストリ (スクロールバック) バッファを .Ar size 行に設定します。 .It Fl i Cm adapter 現在のビデオアダプタに関する情報を表示します。 .It Fl i Cm mode 現在のビデオハードウェアにて使用可能なビデオモードを表示します。 .It Fl l Ar screen_map 画面出力マップをファイル .Ar screen_map から読み込んで設定します。 .Xr syscons 4 も参照してください。 .It Fl L 出力画面マップをデフォルトに設定します。 .It Fl M Ar char マウスポインタを描く基本となる文字を .Ar char にします。 .It Fl m Cm on | off マウスポインタを .Cm on または .Cm off します。 テキストモードでのカット & ペースト機能を利用するために .Xr moused 8 デーモンと共に使用します。 .It Fl p 標準入力として参照される端末デバイスに対応する、 ビデオバッファの現在の内容をキャプチャします。 .Nm -は、ビデオバッファの内容を標準出力に対し、 +ユーティリティは、ビデオバッファの内容を標準出力に対し、 生のバイナリフォーマットで出力します。 このフォーマットに関する詳細は、後述の .Sx ビデオバッファダンプのフォーマット を参照してください。 .It Fl P .Fl p と同じですが、ビデオバッファの内容をプレインテキストでダンプし、 印字不可の文字とテキスト属性情報を無視します。 .It Fl r Ar foreground background 反転表示モードで用いる色を前景色 .Ar foreground および背景色 .Ar background に変更します。 .It Fl s Ar number 現在の vty を .Ar number に設定します。 .It Fl t Ar N | Cm off スクリーンセーバのタイムアウト値を .Ar N 秒に設定、あるいはスクリーンセーバを無効 ( .Cm off )にします。 .It Fl x 出力に 16 進数を用います。 .El .Ss ビデオモードサポート 前記の全モードを ビデオカードがサポートしているとは限らないことに注意してください。 .Fl i Cm mode オプションを使用することにより、 ビデオカードがサポートしているモードを調べることが可能です。 .Pp VESA ビデオモードもしくは 132 桁モードを使用する場合には、 VESA BIOS サポートをカーネルにリンクするか KLD にてロードする必要があることにも 注意してください ( .Xr vga 4 を参照してください)。 .Pp VGA 90 桁モードを使用する場合には、カーネルを .Ar VGA_WIDTH90 オプション付きでコンパイルする必要があります ( .Xr vga 4 を参照してください)。 .Pp 25 または 30 行モード以外のビデオモードは、 特定の大きさのフォントが必要となるかもしれません。 前述の .Fl f オプションを使用し、フォントファイルをカーネルにロードしてください。 必要な大きさのフォントがカーネルにロードされていないと、 ユーザが新規ビデオモードを設定しようとした場合に .Nm は失敗します。 .Pp .Bl -column "25 line modes" "8x16 (VGA), 8x14 (EGA)" -compact .Sy モード Ta Sy フォントの大きさ .Li 25 行モード Ta 8x16 (VGA), 8x14 (EGA) .Li 30 行モード Ta 8x16 .Li 43 行モード Ta 8x8 .Li 50 行モード Ta 8x8 .Li 60 行モード Ta 8x8 .El .Pp 同じフォントの 3 つの大きさすべて (8x8, 8x14, 8x16) を 常にロードすることが望ましいです。 .Pp .Pa /etc/rc.conf または .Pa /etc/rc.conf.local 中の変数を希望のフォントファイルに設定できます。 これにより、システム起動時にこれらのフォントが自動的にロードされます。 後述を参照してください。 .Pp ラスタテキストモード .Ar VESA_800x600 を使用したい場合、 .Dv SC_PIXEL_MODE オプション付きでカーネルを再コンパイルする必要があります。 このカーネルオプションについての詳細は、 .Xr syscons 4 を参照してください。 .Ss ビデオバッファダンプのフォーマット .Nm ユーティリティは、 .Xr syscons 4 .Dv CONS_SCRSHOT .Xr ioctl 2 を使用し、ビデオバッファの現在の内容をキャプチャします。 .Nm -は、バージョンと追加情報を標準出力に書き出し、 +ユーティリティは、バージョンと追加情報を標準出力に書き出し、 その後に端末デバイスの内容を続けて書き出します。 .Pp PC ビデオメモリは、典型的には 2 バイトタプルの並びであり、 1 タプルが各文字位置に対応します。 各タプルでは、最初のバイトが文字コードであり、 2 番目のバイトが文字の色属性です。 .Pp 色属性バイトは、更に、どの前景色が有効かを指定する下位ニブルと、 どの背景色が有効かを指定する上位ニブルとに分解されます。 .Pp .Bl -hang -offset indent -compact .It 0 黒 .It 1 青 .It 2 緑 .It 3 シアン .It 4 赤 .It 5 マゼンタ .It 6 茶 .It 7 白 .It 8 灰 .It 9 明い青 .It 10 明い緑 .It 11 明いシアン .It 12 明い赤 .It 13 明いマゼンタ .It 14 黄 .It 15 白 .El .Pp 最後の 8 色は、最初の 8 色を明るく見えるようにしたものです。 .Pp 例えば、2 バイト .Pp .Dl "65 158" .Pp は、大文字 A (文字コード 65) を、 明い青の背景 (高位ニブル 9) に黄色 (下位ニブル 15) という指定です。 .Pp .Nm の出力には小さなヘッダがあり、 そこには、出力を処理するユーティリティに有用な追加情報が含まれます。 .Pp 最初の 10 バイトは、常に次の並びです。 .Bl -column "Byte range" "Contents" -offset indent .It Sy "バイト範囲 内容" .It "1 から 8 リテラルテキスト" Dq Li SCRSHOT_ .It "9 ファイルフォーマットバージョン番号" .It "10 ヘッダの残りバイト数" .El .Pp これに続くバイトは、バージョン番号依存です。 .Bl -column "Version" "13 and up" -offset indent .It Sy "バージョン バイト 意味" .It "1 11 文字数単位の端末幅" .It " 12 文字数単位の端末の深さ" .It " 13 以降 スナップショットデータ" .El .Pp 80x25 画面のダンプは (16 進数で) 次のように開始します。 .Bd -literal -offset indent 53 43 52 53 48 4f 54 5f 01 02 50 19 ----------------------- -- -- -- -- | | | | ` 10 進数の 25 | | | `--- 10 進数の 80 | | `------ 残りのヘッダデータのバイト数 2 | `--------- ファイルフォーマットバージョン 1 `------------------------ リテラル "SCRSHOT_" .Ed .Sh ビデオ出力設定 .Ss ブート時の設定 次の変数を .Pa /etc/rc.conf または .Pa /etc/rc.conf.local に設定することにより、ブート時にビデオ出力を設定可能です。 .Pp .Bl -tag -width foo_bar_var -compact .It Ar blanktime .Fl t オプション用のタイムアウトを設定します。 .It Ar font8x16 , font8x14 , font8x8 .Fl f オプション用のフォントファイルを指定します。 .It Ar scrnmap .Fl l オプション用の画面出力マップファイルを指定します。 .El .Pp 更なる詳細は .Xr rc.conf 5 を参照してください。 .Ss ドライバの設定 デフォルトフォントなどのデフォルト設定オプションの変更を、 ビデオカードドライバが許す場合があります。 その場合、ブート時のオプション設定の必要はなくなります。 詳細はビデオカードドライバマニュアル (例えば .Xr vga 4 ) を参照してください。 .Sh 関連ファイル .Bl -tag -width /usr/share/syscons/scrnmaps/foo-bar -compact .It Pa /usr/share/syscons/fonts/* フォントファイル。 .It Pa /usr/share/syscons/scrnmaps/* 画面出力マップファイル。 .El .Sh 使用例 カーネルに .Pa /usr/share/syscons/fonts/iso-8x16.fnt をロードしたい場合、 .Nm を次のように実行します。 .Pp .Dl vidcontrol -f 8x16 /usr/share/syscons/fonts/iso-8x16.fnt .Pp フォントファイルが .Pa /usr/share/syscons/fonts にある場合、ファイル名を .Pa iso-8x16 のように短縮可能です。 .Pp .Dl vidcontrol -f 8x16 iso-8x16 .Pp 更に、フォントの大きさ .Dq Li 8x16 を省略可能です。 .Pp .Dl vidcontrol -f iso-8x16 .Pp 更に、フォントの大きさを指定するサフィックスも省略可能です。 この場合、 .Nm は、現在表示されているフォントの大きさを使用してサフィックスを作成します。 .Pp .Dl vidcontrol -f iso .Pp 同様に、画面出力マップファイルが .Pa /usr/share/syscons/scrnmaps にある場合、 .Fl l オプション用のファイル名を短縮可能です。 .Pp .Dl vidcontrol -l iso-8859-1_to_cp437 .Pp このコマンドは .Pa /usr/share/syscons/scrnmaps/iso-8859-1_to_cp437.scm をロードします。 .Pp 次のコマンドは、100x37 のラスタテキストモードを設定します (LCD モデルによっては有用です): .Pp .Dl vidcontrol -g 100x37 VESA_800x600 .Pp 次のコマンドは、最初の仮想端末の内容をキャプチャし、出力を .Pa shot.scr ファイルへ向けます。 .Pp .Dl vidcontrol -p < /dev/ttyv0 > shot.scr .Pp 次のコマンドは、4 番目の仮想端末の内容を、 人間が読めるフォーマットで標準出力へダンプします。 .Pp .Dl vidcontrol -P < /dev/ttyv3 .Sh 関連項目 .Xr kbdcontrol 1 , .Xr vidfont 1 , .Xr keyboard 4 , .Xr screen 4 , .Xr syscons 4 , .Xr vga 4 , .Xr rc.conf 5 , .Xr kldload 8 , .Xr moused 8 , .Xr watch 8 .Pp 様々な .Li scr2* ユーティリティが、 .Em "Ports Collection" の .Li graphics と .Li textproc のカテゴリにあります。 .Sh 作者 .An S\(/oren Schmidt Aq sos@FreeBSD.org diff --git a/ja_JP.eucJP/man/man1/vis.1 b/ja_JP.eucJP/man/man1/vis.1 index a274d4e057..b660321665 100644 --- a/ja_JP.eucJP/man/man1/vis.1 +++ b/ja_JP.eucJP/man/man1/vis.1 @@ -1,125 +1,126 @@ .\" Copyright (c) 1989, 1991, 1993, 1994 .\" The Regents of the University of California. 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 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. .\" .\" @(#)vis.1 8.4 (Berkeley) 4/19/94 -.\" %FreeBSD: src/usr.bin/vis/vis.1,v 1.6.2.1 2001/08/16 13:17:13 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/vis.1,v 1.4 2001/08/17 06:18:10 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/vis/vis.1,v 1.6.2.2 2002/06/21 15:30:07 charnier Exp % +.\" $FreeBSD$ .\" .Dd April 19, 1994 .Dt VIS 1 .Os .Sh 名称 .Nm vis .Nd 表示不可能なキャラクタを、表示可能なフォーマットで出力する .Sh 書式 .Nm .Op Fl cbflnostw .Op Fl F Ar foldwidth .Op Ar .Sh 解説 .Nm -は表示不可能なキャラクタをビジュアルに表現に変換するフィルタです。 +ユーティリティは、 +表示不可能なキャラクタをビジュアルに表現に変換するフィルタです。 .Ql cat -v と異なり、変換した出力はユニークで、逆変換可能です。 デフォルトでは、空白文字、タブ、および改行 (ニューライン) を除く 表示不可能な全キャラクタがエンコードされます。エンコードのフォーマットの 詳細は、 .Xr vis 3 で与えられます。 .Pp オプションとしては以下のものがあります。 .Bl -tag -width Ds .It Fl b デフォルトのエンコードは、バックスラッシュと上矢印(キャレット) とメタキャラクタの組み合わせですが、これにバックスラッシュを入れないようにし ます。この出力は正確ではなく、逆変換もできませんが、 入力に対して最も変更が少ない表現です。出力は、 .Dq Li cat -v によく似たものとなります。 .It Fl c 一部の表示不可能なキャラクタに、C 言語のバックスラッシュシーケンスを 使って表示します。 .It Fl F Ar foldwidth .Xr fold 1 同様、1 行の表示幅を .Ar foldwidth に収めます(デフォルトは 80桁)。ただし .Xr fold 1 と異なり、特別な見えない改行シーケンスを用います。 この改行は .Xr unvis 1 で元のファイルに戻す際に取り除かれます。 もしファイルの最後の文字が改行で終ってない場合には、出力に 見えない改行シーケンスを付加します。 不完全な行があるとうまく動作しない数々のエディタやユーティリティでも 正しく扱える形式の出力が得られます。 .It Fl f .Fl F と同じです。 .It Fl l 改行位置が見えるように、改行の前に .Ql \e$ を挿入します。 .It Fl n バックスラッシュの二重化と .Fl f もしくは .Fl F 指定時に挿入される見えない改行シーケンス以外はエンコードしないように します。 .Fl f フラグと組み合わせたときの動作は、 逆変換可能な .Xr fold 1 ユーティリティと考えることができます。 つまり、出力を .Xr unvis 1 にかけることで fold 状態を元に戻すことができます。 .It Fl o 表示不可能なキャラクタ \eddd というように、バックスラッシュ と8進数表現で表示します。 .It Fl s 端末に送るのが適切ではないキャラクタだけをエンコードします。 デフォルトの空白文字やタブ、改行に加え、 バックスペースやベル、復帰 (carriage return) もそのまま出力されます。 .It Fl t タブをエンコード対象にします。 .It Fl w 空白、タブ、改行もエンコード対象にします。 .El .Sh 関連項目 .Xr unvis 1 , .Xr vis 3 .Sh 歴史 .Nm コマンドは .Bx 4.4 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/vt220keys.1 b/ja_JP.eucJP/man/man1/vt220keys.1 index b878cf5f24..0d6138ddce 100644 --- a/ja_JP.eucJP/man/man1/vt220keys.1 +++ b/ja_JP.eucJP/man/man1/vt220keys.1 @@ -1,165 +1,166 @@ -.\" %FreeBSD: src/usr.sbin/pcvt/userkeys/vt220keys.1,v 1.7.2.1 2001/01/17 09:19:21 ru Exp % +.\" %FreeBSD: src/usr.sbin/pcvt/userkeys/vt220keys.1,v 1.7.2.2 2002/06/21 16:42:10 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/vt220keys.1,v 1.6 2001/07/29 05:14:53 horikawa Exp $ +.\" $FreeBSD$ .Dd January 16, 2001 .Dt VT220KEYS 1 .Os .Sh 名称 .Nm vt220keys .Nd VT220 端末上のシフトファンクションキーを定義 .Sh 書式 .Nm .Op Fl cil .Op Ar keyname keystring ... .Sh 解説 .Nm -は、ユーザにシフトファンクションキーを定義させるために、 +ユーティリティは、ユーザにシフトファンクションキーを定義させるために、 vt200 モード中の .Dq vt220 端末 を設定します。 コマンドラインで指定される各 .Ar keyname は、特定の .Ar keystring がロードされます。 .Ar keyname は、以下の語句のうちのどれかです: .Cm F6 F7 F8 F9 F10 F11 ESC .Cm F12 BS F13 LF F14 HELP .Cm DO F17 F18 F19 F20 。 .Ar keystrings は、空白やタブ、シェルのメタキャラクタを含む時には、クオートしなければ なりません。 .Pp .Nm -は、いくつかのオプションフラグの組み合わせや引数のペアを受け取ることを +ユーティリティは、 +いくつかのオプションフラグの組み合わせや引数のペアを受け取ることを 期待しています。そうでない場合には、利用方法メッセージが表示されます。 .Pp オプションは以下の通りです。 .Bl -tag -width indent .It Fl c ユーザによる定義を行う前に、全てのシフトファンクションキーの定義を 消去します。 .It Fl i シフトファンクションキー定義のための初期化ファイル .Pa $HOME/.vt220rc を読み込みます。 これは、コマンドラインのどんな引数ペアを処理するよりも前に行われます。 このファイルの各行は、(空白かタブで 分けられた) 二つのフィールドから構成されていなければなりません。 最初のフィールドは .Ar keyname で、二番目のフィールドは .Ar keystring です。 二番目のフィールドは行末まで続きます。したがって、 .Ar keystring には空白やタブを含むかもしれません。 改行 (リターン) は、C 言語での改行表現 (\\n) を使うことで、文字列中に 含めることができます。 .It Fl l ファンクションキーを以降の定義からロックします。 ロックは、("i" オプションが指定されている時は、)初期化ファイルを 処理し、全ての引数ペアを処理した後で起こります。 ロックを解除するための唯一の方法は、電源を切ることです。 .El .Sh 使用例 .Bd -literal vt220keys -ci vt220keys F6 'nroff -ms ' vt220keys -i F20 'cc -O -c ' vt220keys -l HELP man .Ed .Sh "その他の特徴" シフトキーを使わずにファンクションキーを押すと、文字列を生成します。 .Xr csh 1 では、この文字列をいくつかのコマンドに別名づけ (エイリアス) することができます。例えば以下のようにしてください。 .Pp .Dl alias ^[[17~ "ls -CR | more" .Pp ここで、 .Ql "^[[17~" は、 F6 キーを押したことによって生成された文字列です。 したがって、 F6 は、シフトキーを押すか、押さないかに依存して、 二つのコマンドを生成することができます。 .Pp .Nm -は、 +ユーティリティは、 .Pa .login や .Pa .profile から呼び出すことができます。 典型的には、ユーザ は初期化ファイルを生成して、以下のようなコマンドで行を読み込みます。 .Pp .Dl "vt220keys -ci" .Pp または、 .Pp .Dl "vt220keys -cil" .Pp この方法では、シフトファンクションキーはログインした時にあなたの 好きなように設定されるでしょう。 .Sh 警告 シフトファンクションキーがロックされていない時には、 シフトファンクションキーの再定義は、以前の定義を上書きします。 .Pp シフトファンクションキーには 256 バイトが利用可能です。 この領域は、最初に来たものに最初に与える方式で利用されます。 256 バイトが使われた後では、領域を解放しなければ他のキーを 定義することはできません。これは、より少ないバイトの文字列でキーを 再定義することで可能です。 .Pp 全てのキー定義は、 揮発性の RAM に記憶されます。したがって、端末の 電源を切った時にはその定義は失われます。 .Pp (シフトを押さない) ESC キーはもはや正しいエスケープ文字を生成しません。 これは、たくさんのエディタが ESC キーの使用を要求するため、 特に重要です。ここでは、いくつかの利用可能な別の方法を紹介します。 .Bl -bullet .It エスケープ文字は、 .Ql ^[ (control\-[) を入力することで生成できます。 .It .Nm を以下のように利用してください ( .Ql ^[ は、control\-[ です): .Dl "vt220keys ESC '^['" .Pp この方法では、エスケープ文字を生成するために、SHIFT キーと ESC キーを 押さなければなりません。 .It いくつかのエディタでは、他の文字をエスケープ文字と置き換えることが できます。例えば、 .Xr emacs 1 では以下の行をあなたの .Pa .emacs_pro に挿入してください。 .Pp .Dl (bind-to-key "ESC-prefix" "\\033[23~") .Pp ESC キーが押された時、 .Nm emacs は生成された文字列 .Pq Li ^[[23~ によって エスケープ文字が押された時と同じ機能を提供します。 .El .Sh 関連ファイル .Bl -tag -width $HOME/.vt220rc .It Pa $HOME/.vt220rc 初期化ファイル .El .Sh 関連項目 .Rs .%B "VT220 Programmer Reference Manual" .Re .Rs .%B "VT220 Programmer Pocket Guide" .Re diff --git a/ja_JP.eucJP/man/man1/vttest.1 b/ja_JP.eucJP/man/man1/vttest.1 index b8a083ab0c..18b951c770 100644 --- a/ja_JP.eucJP/man/man1/vttest.1 +++ b/ja_JP.eucJP/man/man1/vttest.1 @@ -1,22 +1,22 @@ -.\" %FreeBSD: src/usr.sbin/pcvt/vttest/vttest.1,v 1.4.2.1 2001/01/17 09:19:21 ru Exp % +.\" %FreeBSD: src/usr.sbin/pcvt/vttest/vttest.1,v 1.4.2.2 2002/06/21 16:42:13 charnier Exp % .\" .\" $FreeBSD$ .Dd January 16, 2001 .Dt VTTEST 1 .Os .Sh 名称 .Nm vttest .Nd "VT100 タイプターミナルのテスト" .Sh 書式 .Nm .Sh 解説 .Nm -は、 +ユーティリティは、 .Tn VT100 ターミナル (またはエミュレータ) の機能をテストするためにデザインされたプログラムです。 ディスプレイ (エスケープシーケンスの取り扱い) とキーボードをテストします。 .Pp プログラムはメニュー方式であり、 十分なオンライン操作指示を含んでいます。 diff --git a/ja_JP.eucJP/man/man1/wall.1 b/ja_JP.eucJP/man/man1/wall.1 index db0d4ac8ab..de33fc71ae 100644 --- a/ja_JP.eucJP/man/man1/wall.1 +++ b/ja_JP.eucJP/man/man1/wall.1 @@ -1,71 +1,72 @@ .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)wall.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/wall/wall.1,v 1.3.2.3 2001/10/05 15:21:42 ru Exp % +.\" %FreeBSD: src/usr.bin/wall/wall.1,v 1.3.2.4 2002/06/21 15:30:10 charnier Exp % .\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt WALL 1 .Os .Sh 名称 .Nm wall .Nd ログインしているユーザにメッセージを送る .Sh 書式 .Nm .Op Fl g Ar group .Op Ar file .Sh 解説 .Nm -は、デフォルトでは、標準入力の内容を現在ログインしているすべての +ユーティリティは、 +デフォルトでは、標準入力の内容を現在ログインしているすべての ユーザの端末に表示します。 .Ar file を指定すれば、その内容が表示されます。 .Pp スーパユーザだけが、メッセージを拒否しているユーザや 自動的にメッセージを拒否するプログラムを使っているユーザの端末にメッセージ を送ることができます。 .Bl -tag -width indent .It Fl g このグループのユーザに対しメッセージを送ります。 本オプションは複数回指定可能であり、 指定したグループのいずれかに属するユーザがメッセージを受け取ります。 .El .Sh 関連項目 .Xr mesg 1 , .Xr talk 1 , .Xr write 1 , .Xr shutdown 8 .Sh 歴史 .Nm コマンドは .At v7 ではじめて実装されました。 diff --git a/ja_JP.eucJP/man/man1/which.1 b/ja_JP.eucJP/man/man1/which.1 index 7f009e1516..fdfacf0884 100644 --- a/ja_JP.eucJP/man/man1/which.1 +++ b/ja_JP.eucJP/man/man1/which.1 @@ -1,79 +1,79 @@ .\" Manpage Copyright (c) 1995, Jordan Hubbard .\" .\" 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 FreeBSD Project .\" its contributors. .\" 4. Neither the name of the FreeBSD Project 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 CONTRIBUTOR ``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 CONTRIBUTOR 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. .\" -.\" %FreeBSD: src/usr.bin/which/which.1,v 1.16.2.3 2001/08/16 13:17:14 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/which.1,v 1.10 2001/07/29 05:14:53 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/which/which.1,v 1.16.2.4 2002/06/21 15:30:13 charnier Exp % +.\" $FreeBSD$ .Dd January 26, 1995 .Dt WHICH 1 .Os .Sh 名称 .Nm which .Nd "ユーザパスからプログラムを見つける" .Sh 書式 .Nm .Op Fl as .Op Ar command .Ar ... .Sh 解説 .Nm -は、コマンド名のリストを受け取り、 +ユーティリティは、コマンド名のリストを受け取り、 実際に起動したならば実行できる実行形式ファイルを探します。 .Pp オプションには以下のものがあります: .Bl -tag -width indent .It Fl a (最初に見つけたものだけでなく) みつけたすべての実行形式を表示します。 .It Fl s 実行形式が見つかれば 0 を返し、見つからなければ 1 を返します。 表示はしません。 .El .Pp シェルによっては、本ユーティリティと似たまたは同じ、組み込みの .Nm コマンドを提供しているものがあります。 .Xr builtin 1 マニュアルページを参照してください。 .Sh 歴史 .Nm コマンドは .Fx 2.1 から登場しました。 .Sh 関連ファイル .Xr builtin 1 , .Xr csh 1 , .Xr find 1 , .Xr locate 1 , .Xr perl 1 , .Xr whereis 1 .Sh 作者 新しいバージョンの .Nm PERL スクリプトは .An Wolfram Schneider Aq wosch@FreeBSD.org によって書かれました。 diff --git a/ja_JP.eucJP/man/man1/whois.1 b/ja_JP.eucJP/man/man1/whois.1 index 4120840c14..8e4dbacd87 100644 --- a/ja_JP.eucJP/man/man1/whois.1 +++ b/ja_JP.eucJP/man/man1/whois.1 @@ -1,239 +1,239 @@ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/whois/whois.1,v 1.15.2.7 2002/02/10 05:47:05 mike Exp % +.\" %FreeBSD: src/usr.bin/whois/whois.1,v 1.15.2.8 2002/06/21 15:30:15 charnier Exp % .\" .\" $FreeBSD$ .Dd December 15, 2001 .Dt WHOIS 1 .Os .Sh 名称 .Nm whois .Nd インターネットのドメイン名とネットワーク番号のディレクトリサービス .Sh 書式 .Nm .Op Fl adgimpQrR6 .Op Fl c Ar country-code | Fl h Ar host .Ar name ... .Sh 解説 .Nm -はネットワークインフォメーションセンタ +ユーティリティは、ネットワークインフォメーションセンタ .Pq Tn NIC のデータベースのレコード検索を行ないます。 .Pp オプションとしては以下のものがあります。 .Bl -tag -width indent .It Fl a American Registry for Internet Numbers .Pq Tn ARIN データベースを使用します。 ここには、 .Tn APNIC および .Tn RIPE 以外がカバーする全世界の IP 番号があります。 .Pp (ヒント: .Tn ARIN whois データベース内の連絡先ハンドルは、すべて、 .Qq Li -ARIN で終ります。) .Pp .It Fl c Ar country-code .Fl h オプションを .Qq Ar country-code Ns Li .whois-servers.net という引数と共に使用するのと同等です。 .It Fl d US Department of Defense データベースを使用します。 .Pa .MIL のサブドメインの連絡先があります。 .It Fl g US の軍以外の連邦政府データベースを使用します。 .Pa .GOV のサブドメインの連絡先があります。 .It Fl h Ar host デフォルトのバリアントに代えて、指定したホスト用います。 ホスト名もしくは IP 番号を指定可能です。 .Pp デフォルトでは、提供された (単一の) 引数のトップレベルドメイン .Pq Tn TLD に .Qq Li .whois-servers.net を追加することにより、 .Nm が使用する whois サーバ名を構築します。 この効果的な方法により、多くの .Tn TLD が適切な whois サーバを自動選択できます。 .Pp IP アドレスが指定された場合、whois サーバはデフォルトの American Registry for Internet Numbers .Pq Tn ARIN になります。 .Tn ARIN への問い合わせが .Tn APNIC または .Tn RIPE を参照する場合、 .Fl Q オプションが指定されていなければ、そのサーバに対しても問い合わせを行います。 .Pp 問い合わせがドメイン名でも IP アドレスでもない場合、見付からない場合には、 .Nm は .Pa whois.crsnic.net を使用します。 .It Fl i Network Solutions Registry for Internet Numbers .Pq Pa whois.networksolutions.com データベースを使用します。 ここにはほとんどの .Pa .COM , .NET , .ORG , .EDU ドメインのネットワーク番号とドメインの連絡先情報があります。 .Sy 注意! 現在これらのドメインの登録は、多くの独立した競合する登録会社が行っています。 本データベースには、Network Solutions, Inc. 以外の登録会社が登録した ドメインの情報はまったく含まれません。 また、 .Tn InterNIC データベース .Pq Pa whois.internic.net は既に Network Solutions, Inc. の取り扱いでないことに注意してください。 詳細は .Pa http://www.internic.net/ を参照してください。 .Pp (ヒント: 術語 .Em handle で識別される連絡先情報は、 .Tn NIC ハンドルの前に .Qq Li "handle " を付けることで検索可能です。) .Pp .It Fl m Route Arbiter Database .Pq Tn RADB データベースを使用します。 ここには、多くのオペレータのネットワークのポリシ仕様があります。 .It Fl p Asia/Pacific Network Information Center .Pq Tn APNIC データベースを使用します。 ここには、東アジア、オーストラリア、ニュージーランド、太平洋諸島の IP 番号があります。 .It Fl Q 高速検索します。 .Nm が、権威のある whois サーバ (が列挙されていた場合、これ) に名前を問いあわせようとしないことを意味します。 本オプションは、他のオプションと組み合わせると効果がありません。 .It Fl r R\(aaeseaux IP Europ\(aaeens .Pq Tn RIPE データベースを使用します。 ここには、ヨーロッパのネットワーク番号とドメインの連絡先情報があります。 .It Fl R Russia Network Information Center .Pq Tn RIPN データベースを使用します。 ここには、 .Pa .RU のネットワーク番号とドメインの連絡先情報があります。 .It Fl 6 IPv6 Resource Center .Pq Tn 6bone データベースを使用します。 ここには、IPv6 のネットワーク名とアドレスがあります。 .El .Pp .Nm に指定されたオペランドは個別に取り扱われ、 別々の whois サーバへの問い合わせに使用されるかもしれません。 .Sh 使用例 ほとんどのタイプのデータ、例えばドメイン名や .Tn IP アドレスは、オプション無しで .Nm の引数とすることが可能であり、 .Nm は正しい検索先 whois サーバを選択します。 例外、すなわち .Nm が正しくデータを扱えないものについては、以下に詳細を示します。 .Pp ロシアの .Tn TLD ドメイン .Qq Li RU 中の管理者の連絡先情報を得るには、次の例のように .Fl c オプションを使用します。 ここで、 .Ar CONTACT-ID は実際の連絡先識別子で置き換えます。 .Pp .Dl "whois -c RU CONTACT-ID" .Pp (注: この例は .Tn TLD .Qq Li RU に固有ですが、他の .Tn TLD でも同様の書式で問い合わせ可能です。) .Pp 次の例は、 .Tn IPv6 アドレスまたはホスト名に関する情報を .Fl 6 を使用して取得する方法を示します。 これにより、問い合わせは .Tn 6bone に向けられます。 .Pp .Dl "whois -6 IPv6-IP-Address" .Sh 関連項目 .Rs .%A Ken Harrenstien .%A Vic White .%T NICNAME/WHOIS .%D 1 March 1982 .%O RFC 812 .Re .Sh 歴史 .Nm コマンドは .Bx 4.3 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/window.1 b/ja_JP.eucJP/man/man1/window.1 index 2fce754d49..b5a840c609 100644 --- a/ja_JP.eucJP/man/man1/window.1 +++ b/ja_JP.eucJP/man/man1/window.1 @@ -1,887 +1,887 @@ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Edward Wang at The University of California, Berkeley. .\" .\" 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. .\" .\" @(#)window.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.bin/window/window.1,v 1.5.2.5 2001/08/16 13:17:15 ru Exp % +.\" %FreeBSD: src/usr.bin/window/window.1,v 1.5.2.6 2002/06/21 15:30:19 charnier Exp % .\" $FreeBSD$ .\" .Dd December 30, 1993 .Dt WINDOW 1 .Os .Sh 名称 .Nm window .Nd ウィンドウ環境を実現します .Sh 書式 .Nm .Op Fl t .Op Fl f .Op Fl d .Op Fl e Ar escape-char .Op Fl c Ar command .Sh 解説 .Nm -は、 +ユーティリティは、 .Tn ASCII 端末上でウィンドウ環境を実装します。 .Pp ウィンドウとは物理的な端末スクリーンの中の部分的な長方形部分を指し、 ここをプロセスの集合が利用します。その大きさと位置はユーザがいつでも 変更できます。プロセスは 標準入力、標準出力、標準エラー出力を通して端末と通信する通常の方法と 同じ方法で、そのウィンドウと通信します。 ウィンドウプログラムはそのウィンドウに対する入力と出力のリダイレクトに関する 細かい処理を行います。どんな時でも、 1 つのウィンドウだけがキーボードからの 入力を受けることが出来ますが、全てのウィンドウが同時にディスプレイへの出力を 送ることが可能です。 .Pp .Nm が立ち上がった時、ユーザのホームディレクトリにある .Pa .windowrc 内のコマンドが実行されます。もしこのファイルが存在しない時は、 デフォルトとして同じ大きさのウィンドウが 2 つ作成されます。 .Pp コマンドラインオプションには以下のものがあります。 .Bl -tag -width Fl .It Fl t terse モードをオンにします (以下の .Ic terse コマンドを参照)。 .It Fl f 高速モードです。スタートアップ動作は何もしません。 .It Fl d .Pa .windowrc を無視する代わりに 2 つのデフォルトウィンドウを作成します。 .It Fl e Ar escape-char エスケープ文字を .Ar escape-char にします。 .Ar escape-char は文字 1 つか、もしくは .Ic ^X .Ns ( No control\- Ns Ar X ) のような形式です .Ns ( Ar X はどんな文字でも構いません)。 .It Fl c Ar command .Ar command をロングコマンド(以下参照)として最初に実行します。 .El .Pp ウィンドウはオーバラップ可能で、枠が必要です。 各ウィンドウには、``1'' から ``9'' の数字のうちの一つの名前が 付いています。この一文字の識別子は、ユーザが定義できるラベル文字と 同じように、ウィンドウのフレームの上の辺に表示されます。 ウィンドウは .Ar フォアグラウンド にあるように設計されています。フォアグランドウィンドウは、 普通の他のフォアグラウンドではないウィンドウよりもつねに上にあります。 このウィンドウより上になるのは、他のフォアグランドウィンドウだけです。 ウィンドウは、端末画面の辺内に完全に入っている必要はありません。 したがって、(画面よりも大きくても良い)大きいウィンドウは、その全画面の 一部分だけが表示されるでしょう。 .Pp 各ウィンドウは、カーソルと制御機能を持っています。最も知的な端末操作、 すなわち行や文字消去や挿入が提供されています。下線を引いたり反転表示等の ディスプレイモードは、端末によって提供されている場合には、利用可能です。 更に、複数ページ分のメモリがある端末と同じように、各ウィンドウは ウィンドウ画面に表示されるよりも多くの行を保持できるテキストバッファを 持っています。 .Ss プロセス環境 新しく作成されたウィンドウでは、 呼び出されたウィンドウからプロセス環境を引き継いで、 シェルプログラムが実行されます。 標準入力・出力・エラー出力は、仮想端末 ( .Xr pty 4 参照) または、 .Ux ドメインのソケット ( .Xr socketpair 2 参照)と結びつけられます。 仮想端末が使われている場合、特別な文字やモード( .Xr stty 1 参照)は、物理端末から複製されます。 このウィンドウに対する .Xr termcap 5 のエントリが作成されて、環境として( .Xr environ 7 参照)変数 .Ev TERMCAP に渡されます。 termcap エントリには、下線・反転表示・その他の表示モード・ 可能であれば端末のファンクションキーによって生み出されるコード等の 物理端末からの情報と同じように、ウィンドウの大きさや特徴が含まれています。 更に、仮想端末のウィンドウサイズ属性は、ウィンドウの大きさを反映するように 設定され、その大きさが変更された場合はその情報が更新されます。 特に、エディタ .Xr vi 1 は、この情報を画面を再表示するために利用します。 .Ss 操作 普通の実行中には、 .Nm は、二つの状態の内の一つの状態にあります。 この二つの状態は、会話モードとコマンドモードです。 会話モードでは、端末の実際のカーソルは、特定のウィンドウのカーソル位置 に位置します。この特定のウィンドウはカレントウィンドウと呼ばれます。 そして、キーボードからの入力は、そのウィンドウにあるプロセスに 送られます。カレントウィンドウは、他のウィンドウがフォアグランドに ある時を除いて、いつも他のウィンドウよりも上にあります。 更に、その識別子とラベルは反転表示で強調されています。 .Pp .Nm のエスケープ文字 (通常は、 .Ic ^P です) を入力することで、会話モードからコマンドモードへ移行します。 コマンドモードでは、端末画面の一番上の行は コマンドプロンプトウィンドウに変わり、 .Nm はキーボードからの入力をウィンドウを操作するコマンドであると解釈します。 .Pp 二つの種類のコマンドがあります。短いコマンドは普通 1文字ないし 2文字 から構成されます。長いコマンドはコマンドウィンドウ (以下の .Dq Ic \&: コマンドを参照) で入力される文字列もしくは、ファイル (以下の .Ic source 参照) から読み込まれます。 .Ss 短いコマンド 以下では、 .Ar \&# は、ウィンドウ 1 から 9 に結びつけられた、 数字の ``1'' から ``9'' のひとつを表現します。 .Ic ^X は、 .No control\- Ns Ar X を意味します。ここで、 .Ar X は任意の文字です。 特に、 .Ic ^^ は、 .Li control\-^ です。 .Ar escape はエスケープキーもしくは、 .Ic ^\&[ です。 .Bl -tag -width Ds .It Ar # ウィンドウ .Ar # をカレントウィンドウとして選択し、会話モードに戻ります。 .It Ic \&% Ns Ar # ウィンドウ .Ar # を選択しますが、コマンドモードのままです。 .It Ic ^^ 一つ前のウィンドウを選択し、会話モードに戻ります。 これは、二つのウィンドウの間を交互に移動する時に便利です。 .It Ic escape 会話モードに戻ります。 .It Ic ^P 会話モードに戻り、現在のウィンドウに .Ic ^P を書き込みます。したがって、会話モード中で二つの .Ic ^P を入力することで、一つを現在のウィンドウに送ることができます。 .Nm のエスケープを別の文字に変更している場合には、その文字がここでいう .Ic ^P と同じ動作をします。 .It Ic \&? コマンドの短いまとめを表示します。 .It Ic ^L 画面を再描画します。 .It Ic q .Nm を終了します。 確認が行われます。 .It Ic ^Z .Nm を中断します。 .It Ic w 新しいウィンドウを作成します。ユーザはウィンドウの左上の場所と 右下の場所を指定します。カーソルが画面上に表示され、 ``h'', ``j'', ``k'', ``l'' キーでカーソルをそれぞれ 左 , 下 , 上 , 右 に移動します。 ``H'', ``J'', ``K'', ``L'' キーでは、カーソルはそれぞれの方向の 画面の限界まで移動します。移動キーの前に数字を入力することで、 移動を数字の回数だけ繰り返します。リターンでカーソル位置をウィンドウの 左上の位置として入力します。右下の角も同じような方法で入力します。 この手続き中には、新しいウィンドウの位置は画面に表示される長方形の 箱として示されます。この枠が、新しいウィンドウが表示される枠です。 エスケープキーを入力することで、どの時点でも、このコマンドを キャンセルします。 .Pp このウィンドウはカレントウィンドウになります。そして、最初に利用可能な ID が与えられます。また、デフォルトのバッファサイズが使われます (以下の .Ar default_nline コマンドを参照)。 .Pp 完全に見ることのできるウィンドウだけがこの方法で作成できます。 .It Ic c Ns Ar # ウィンドウ .Ar # を閉じます。 ウィンドウ中のプロセスには、回線切断シグナル ( .Xr kill 1 参照) が送られます。 .Xr csh 1 は、このシグナルを正しく扱うべきで、そうであれば問題は起こりません。 .It Ic m Ns Ar # ウィンドウ .Ar # を別の位置に移動します。 ウィンドウの形をした箱が新しい位置を示すために画面に表示され、 .Ic w コマンドで使われたのと同じようなキーで箱の位置を指定できます。 ウィンドウは一部が画面の外にでても構いません。 .It Ic M Ns Ar # ウィンドウ .Ar # を以前の位置に動かします。 .It Ic s Ns Ar # ウィンドウ .Ar # の大きさを変更します。 ウィンドウの新しい右下の角を指定する必要があります。 新しいウィンドウの大きさを示すために、箱が書かれます。 .Ic w や .Ic m コマンドで使われたのと同じキーが位置を入力するために使われます。 .It Ic S Ns Ar # ウィンドウ .Ar # を以前の大きさに変更します。 .It Ic ^Y カレントウィンドウを一行上にスクロールします。 .It Ic ^E カレントウィンドウを一行下にスクロールします。 .It Ic ^U カレントウィンドウを画面の半分上にスクロールします。 .It Ic ^D カレントウィンドウを画面の半分下にスクロールします。 .It Ic ^B カレントウィンドウを一画面分、上にスクロールします。 .It Ic ^F カレントウィンドウを一画面分、下にスクロールします。 .It Ic h カレントウィンドウのカーソルを一カラム左に動かします。 .It Ic j カレントウィンドウのカーソルを一行下に動かします。 .It Ic k カレントウィンドウのカーソルを一行上に動かします。 .It Ic l カレントウィンドウのカーソルを一カラム右に動かします。 .It Ic y ヤンクします。ユーザはカレントウィンドウの 2点を指定します。 この 2点で示される内容がヤンクバッファに保存されます。 .It Ic p プットです。ヤンクバッファの内容を、現在のウィンドウに入力として 書き込みます。 .It Ic ^S カレントウィンドウの出力を停止します。 .It Ic ^Q カレントウィンドウの出力を開始します。 .It Ic : 長いコマンドとして実行する行を入力します。 通常の行編集文字 (エスケープ文字、単語の消去、行の消去) が提供されます。 .El .Ss 長いコマンド ロングコマンドはプログラム言語の様に解釈される文の列です。 この文法は C 言語に似ています。数字や文字列の表現や変数が、 条件分岐と同じように提供されています。 .Pp 二つのデータ型があります。文字列と数字です。 文字列は、文字で始まる文字や数字の列です。 ``_'' と ``.'' は文字と 考えられます。別の方法として、アルファベットや数字に含まれない文字を ``"''で括るか、``\\''でエスケープすることで、文字列に含めることもできます。 更に、 C言語で提供されている ``\\'' シーケンスがクオートの内外で 利用可能です (例えば、 ``\\n'' は改行を、``\\r'' はキャリッジリターンを表現します)。 以下の例は規則にあった文字列です。 abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window" .Pp 数字は、以下の3つの形式のうちの一つの整数値です。 10進数・``0'' に続いて表現される 8 進数・``0x'' もしくは ``0X'' に続いて 表現される 16 進数です。機械にとって自然な整数サイズが使われます (つまり、 Cコンパイラの符号付き整数型です)。 C 言語と同じように、 非ゼロの表現が論理的な真をあらわします。 .Pp 文字 ``#'' は、行末までのコメントの始まりを表現します。 .Pp 文は条件式もしくは式です。式文は改行 もしくは ``;'' で終りになります。式を次の行に継続するためには、 最初の行を ``\\'' で終らせます。 .Ss 条件文 .Nm -は、単一の制御構造を持ちます: +ユーティリティは、単一の制御構造を持ちます: それは完全にまとめられた if 文で、以下の形式です .Pp .Bd -literal -offset indent -compact if then \t \t... elsif then \t \t... else \t \t... endif .Ed .Pp .Ic else や .Ic elsif 部分はオプションです。 .Ic elsif は、必要なだけ繰り返して利用することができます。 は数値である必要が有ります。 .Ss 式 .Nm における式は、 C 言語中のものと似ており、ほとんどの C の演算子が 数値オペランドとして提供されています。更に、いくつかの演算子は、 文字列を操作するために拡張されています。 .Pp ある式が文として使われている時、その値は評価の後で 捨てられます。したがって、(代入や関数呼び出しの様な) 副作用を持った式のみが文として有用です。 .Pp (配列でない) 一つの値の変数が、数値と文字列に対して提供されています。 いくつかの変数は、あらかじめ定義されています。 これらは後でに示してあります。 .Pp 優先順序が増加していくように、演算子を以下に示します。 .Bl -tag -width Fl .It Xo .Aq Va expr1 .Ic = .Aq Va expr2 .Xc 代入です。名前が .Aq Va expr1 で文字列を値として持つ変数に、 .Aq Va expr2 の結果が代入されます。 .Aq Va expr2 の値を返します。 .It Xo .Aq Va expr1 .Ic ? .Aq Va expr2 .Ic : .Aq Va expr3 .Xc .Aq Va expr1 の評価値が真 (非 0 数値) である時、 .Aq Va expr2 の値を返します。そうでない場合は、 .Aq Va expr3 の値を返します。 .Aq Va expr2 と .Aq Va expr3 のどちらか一方だけが、評価されます。 .Aq Va expr1 は数値表現でなくてはなりません。 .It Xo .Aq Va expr1 .Ic \&|\&| .Aq Va expr2 .Xc 論理的和 (or) です。数値だけが使えます。短絡評価が提供されています (つまり、 .Aq Va expr1 が評価されて真である場合は、 .Aq Va expr2 は評価されません)。 .It Xo .Aq Va expr1 .Ic \&&\&& .Aq Va expr2 .Xc 短絡評価付きの論理的積 (and) です。数値だけが使えます。 .It Xo .Aq Va expr1 .Ic \&| .Aq Va expr2 .Xc ビット毎の論理和 (or) です。数値だけが使えます。 .It Xo .Aq Va expr1 .Ic ^ .Aq Va expr2 .Xc ビット毎の排他的論理和 (xor) です。数値だけが使えます。 .It Xo .Aq Va expr1 .Ic \&& .Aq Va expr2 .Xc ビット毎の論理積 (and) です。数値だけが使えます。 .It Xo .Aq Va expr1 .Ic == .Aq Va expr2 , .Aq Va expr1 .Ic != .Aq expr2 .Xc (それぞれ、等価と非等価の) 比較です。ブール値の結果 (1 か 0 のどちらか) が比較の結果として返されます。 オペランドは、数値もしくは文字列です。片一方が文字列の場合、 他のオペランドも必要であれば変換されます。 .It Xo .Aq Va expr1 .Ic < .Aq Va expr2 , .Aq Va expr1 .Ic > .Aq Va expr2 , .Aq Va expr1 .Ic <= .Aq Va expr2 , .Aq Va expr1 .Ic >= .Aq Va expr2 .\" >= を補足 .\" Aug 31 1997 .Xc それぞれ、より小さい・より大きい・以下・以上をあらわします。 数値と文字列の両方が利用可能です。 上で述べたように、自動的な変換が行われます。 .It Xo .Aq Va expr1 .Ic << .Aq Va expr2 , .Aq Va expr1 .Ic >> .Aq Va expr2 .Xc 両方のオペランドが数値である場合、 .Aq Va expr1 は、左 (もしくは、右) に .Aq Va expr2 ビットシフトされます。 .Aq Va expr1 が文字列で、最初 (もしくは、最後) の .Aq Va expr2 文字が返されます( .Aq Va expr2 も文字列の場合、その長さがその値として利用されます)。 .It Xo .Aq Va expr1 .Ic + .Aq Va expr2 , .Aq Va expr1 .Ic - .Aq Va expr2 .Xc 数値においては、加算と減算です。 ``+'' に対して、片方が文字列の場合、他方は文字列に変換され、 結果は二つの文字列の結合となります。 .It Xo .Aq Va expr1 .Ic \&* .Aq Va expr2 , .Aq Va expr1 .Ic \&/ .Aq Va expr2 , .Aq Va expr1 .Ic \&% .Aq Va expr2 .Xc かけ算・割算・モジュロ演算 (余りの計算) です。 数字だけが利用可能です。 .\".(訳注)モジュロ演算の後ろのカッコは訳で付け加えました。 .\" 2.2.1R 対象(1997/06/02) Takeshi MUTOH .It Xo .Ic \- Ns Aq Va expr , .Ic ~ Ns Aq Va expr , .Ic \&! Ns Aq Va expr , .Ic \&$ Ns Aq Va expr , .Ic \&$? Ns Aq Va expr .Xc 最初の 3つは、単項演算子のマイナス・ビット毎の補をとる (ビットの反転) ・論理的な否定であり、数値だけを取ります。 演算子 ``$'' は .Aq Va expr を取り、その名前の変数の値を返します。 .Aq Va expr が値 .Ar n を持った数値で、それが (後述の) 別名マクロ中に現れた場合、 別名呼び出しの n 番目の引数を参照します。 ``$?'' は変数 .Aq Va expr の存在を調べ、存在する場合は 1 を、それ以外では 0 を返します。 .It Xo .Ao Va expr Ac Ns Pq Aq Ar arglist .Xc 関数呼び出しです。 .Aq Va expr は文字列でなくてはならず、 .Nm の組み込み関数名の区別できる範囲でのプレフィックスであるか、 ユーザ定義の別名マクロの完全な名前でなくてはなりません。 組み込み関数の場合、 .Aq Ar arglist は以下の 2つの形式のどちらか一方です。 .Bd -literal -offset indent , , ... argname1 = , argname2 = , ... .Ed .Pp 実際、両方の形式はお互い混ぜて使うことができますが、その結果は 予想できません。ほとんどの引数は省略可能です。デフォルトの値が それらに対しては適用されます。 .Ar argnames は、引数名を区別できる範囲でのプレフィックスとすることができます。 引数を分離するコンマは、曖昧さを避けるためだけに用いられ、 通常は省略できます。 .Pp 最初の引数の形式は、ユーザ定義別名のために有効です。別名は、 .Ic alias 組み込み関数を使うことで定義されます(以下参照)。 引数は、変数機能の変種を使ってアクセスされます (前述の ``$'' 演算子を参照)。 .Pp ほとんどの関数は値を返しますが、いくつかは副作用のためだけに 使われるため文として使われなければなりません。 関数や別名が文として使われた時、引数リストを囲むカッコは 省略可能です。別名は値を返しません。 .El .Ss 組み込み関数 引数は自然な順番で名前で並べられます。 オプション引数は、四角カッコ .Sq Op で囲みます。名前の無い引数は、角カッコ .Sq <> 内に書きます。 ブール値のフラグを意味する引数 (しばしば .Ar flag という名前を付けられます) は、意味が明らかである .Ar on , .Ar off , .Ar yes , .Ar no , .Ar true , .Ar false , の内の一つの値をもつか、数値表現においては非ゼロの値が真となります。 .Bl -tag -width Fl .It Ic alias Ns Po .Bq Aq Ar string , .Bq Aq Ar string\-list .Pc 引数が与えられない場合は、全ての現在定義されている別名マクロが 表示されます。そうでない場合、 .Aq Ar string が表現 .Aq Ar string\-list の別名として定義されます。もし存在すれば、以前の .Aq Ar string の定義が返されます。デフォルトでは、 .Aq Ar string\-list は変更されません。 .It Ic close Ns Pq Aq Ar window\-list .Aq Ar window\-list で指定されたウィンドウを閉じます。 .Aq Ar window\-list が単語 .Ar all の場合、全てのウィンドウが閉じられます。値は返しません。 .It Ic cursormodes Ns Pq Bq Ar modes ウィンドウカーソルを .Ar modes に設定します。 .Ar modes は、変数 .Ar m_ul (下線)、 .Ar m_rev (反転表示)、 .Ar m_blk (点滅)、 .Ar m_grp (グラフィック、端末依存です。)で示される モードビットのビット毎の論理和です。 以前のモードの値が返されます。引数に何も指定しないと変更を行いません。 例えば、 .Li cursor($m_rev$m_blk) は、ウィンドウカーソルを点滅する反転表示に設定します。 .It Ic default_nline Ns Pq Bq Ar nline デフォルトバッファサイズを .Ar nline に設定します。 初期設定では、 48 行になっています。古いデフォルトバッファサイズが 返されます。引数に何も指定しないと変更は行いません。とても大きなバッファを 使うと、プログラムの速度が低下します。 .It Ic default_shell Ns Pq Bq Aq Ar string\-list デフォルトのウィンドウシェルプログラムを .Aq Ar string\-list に設定します。 最初の文字列として古いシェル設定が返されます。 引数に何も指定しないと変更を行いません。 初期設定では、デフォルトシェルは環境変数 .Ev SHELL から取られます。 .It Ic default_smooth Ns Pq Bq Ar flag コマンド .Nm (以下参照)への .Ar smooth 引数のデフォルトの値を設定します。 引数はブール値フラグ (上記の .Ar on , .Ar off , .Ar yes , .Ar no , .Ar true , .Ar false または数字のうちの一つ) です。引数に何も指定しないと変更を行いません。 古い値が (数字として) 返されます。 初期値は 1 (true) です。 .It Xo .Ic echo Ns ( Op Ar window , .Bq Aq Ar string\-list ) .Xc 文字列のリスト .Aq Ar string-list を、空白で分割し最後に改行を付けて .Nm へ書き出します。 文字列はウィンドウにだけ表示され、ウィンドウ中のプロセスには 影響を与えません (以下の .Ic write を参照)。 値は返されません。デフォルトはカレントウィンドウです。 .It Ic escape Ns Pq Bq Ar escapec エスケープ文字を .Ar escape-char に設定します。古いエスケープ文字を一文字の文字列として返します。 引数に何も指定しないと変更を行いません。 .Ar escapec は、一文字の文字列か、 .No control\- Ns Ar X を意味する .Fl ^X という形式です。 .It Xo .Ic foreground Ns ( Bq Ar window , .Bq Ar flag ) .Xc .Nm をフォアグラウンドに動かしたり、フォアグラウンドから外したりします。 .Ar flag はブール値です。古いフォアグランドフラグが返されます。 .Nm に対するデフォルトはカレントウィンドウで、 .Ar flag に対するデフォルトは無変更です。 .It Xo .Ic label Ns ( Bq Ar window , .Bq Ar label ) .Xc .Nm のラベルを .Ar label に設定します。 古いラベル文字列が返されます。 .Nm に対するデフォルトはカレントウィンドウで、 .Ar label に対するデフォルトは無変更です。ラベルを無くすためには、 空文字列 ("") を設定します。 .It Ic list Ns Pq 引数はありません。 全てのウィンドウの ID と ラベルが表示されます。 値は返されません。 .It Ic select Ns Pq Bq Ar window .Nm をカレントウィンドウとします。以前のカレントウィンドウが返されます。 引数を指定しないと変更を行いません。 .It Ic source Ns Pq Ar filename .Ar filename 内の長いコマンドを読み込み、実行します。 ファイルが読み込めない場合には -1 を返し、それ以外では 0 を返します。 .It Ic terse Ns Pq Bq flag 簡素 (terse) モードを .Ar flag に設定します。簡素モードでは、コマンドウィンドウはコマンドモード中 でさえ隠されたままで、エラーは端末のベルをならすことで報告されます。 .Ar flag は、上記の .Ar foreground 中の値と同じです。 古い簡素フラグが返されます。 引数を指定しないと変更は行いません。 .It Ic unalias Ns Pq Ar alias 別名定義 .Ar alias を消去します。 別名がない場合には -1 を返します。それ以外の場合は 0 を返します。 .It Ic unset Ns Pq Ar variable .Ar variable 変数の定義を消去します。 .Ar variable が存在しない場合には -1 を返します。それ以外の場合は 0 を返します。 .It Ic variables Ns Pq 引数はありません。全ての変数を表示します。値は返されません。 .It Xo .Ic window Ns ( Bq Ar row , .Bq Ar column , .Bq Ar nrow , .Bq Ar ncol , .Bq Ar nline , .Bq Ar label , .Bq Ar pty , .Bq Ar frame , .Bq Ar mapnl , .Bq Ar keepopen , .Bq Ar smooth , .Bq Ar shell ) . .Xc 左上の角が .Ar row , .Ar column で、大きさが .Ar nrow , .Ar ncol のウィンドウを開きます。 .Ar nline が指定された場合、テキストバッファにその行が割り当てられます。 そうでない場合は、デフォルトのバッファサイズが使われます。 .Ar row , .Ar column , .Ar nrow , .Ar ncol に対するデフォルトの値は、それぞれ画面の一番上, 一番左, 一番下, 一番右 になります。 .Ar label は、ウィンドウのラベル文字列です。 .Ar frame , .Ar pty , .Ar mapnl は、 (上記の) .Ar foreground への引数と同じ方法で解釈されるフラグの値です。 これはそれぞれ、このウィンドウの周りに枠を付けるか (デフォルトでは真)、 ウィンドウのためにソケットペアではなく仮想端末を割り当てるか (デフォルトでは真)、改行文字をこのウィンドウでは 復帰と行送りに マップするか (デフォルトではソケットペアの場合は真、それ以外は偽) です。 一般に、ウィンドウは、プロセスが終了した時に、自動的に閉じられます。 .Ar keepopen を真に設定する (デフォルトでは偽) ことでこの動作は妨げられます。 .Ar smooth が真である時、より端末らしい振舞いを実現するために、 画面は (このウィンドウに対して) より頻繁に更新されます。 .Ar smooth のデフォルトの値は、 (上記) .Ar default_smooth コマンドで設定します。 .Ar shell は、このウィンドウ内でシェルプログラムとして使われる文字列のリストです (デフォルトは、上記 .Ar default_shell で指定されたプログラムです)。 作成されたウィンドウの ID が数字で 返されます。 .It Xo .Ic write Ns ( Bq Ar window , .Bq Aq Ar string\-list ) .Xc .Nm に空白で分割されているが最後に改行の無い文字列リスト .Aq Ar string-list を送ります。 文字列は、実際にウィンドウの入力として使われます。 値は返しません。 デフォルトはカレントウィンドウです。 .El .Ss 定義済み変数 これらの変数は、情報のためだけにあります。これらを再定義しても、 .Nm の内部操作には影響ありません。 .Bl -tag -width modes .It Ar baud 50 から 38400の間のボーレートです。 .It Ar modes 物理端末で提供されている(反転表示・下線・点滅・グラフィック等の) 表示モードです。 .Ar modes の値は、1 ビット値 .Ar m_blk , .Ar m_grp , .Ar m_rev , .Ar m_ul (以下参照)のビット毎の論理和になっています。 これらの値は、ウィンドウのカーソルモードを設定する時に便利です (上の .Ar cursormodes 参照)。 .It Ar m_blk 点滅モードのビットです。 .It Ar m_grp グラフィックモードのビットです (それほど有用ではありません)。 .It Ar m_rev 反転表示モードのビットです。 .It Ar m_ul 下線モードのビットです。 .It Ar ncol 物理端末の列数です。 .It Ar nrow 物理端末の行数です。 .It Ar term 端末の形式です。 端末の .Ev TERMCAP エントリの 2番目のフィールドに書かれている標準名が使われます。 .El .Sh 環境変数 .Nm -は、以下のような環境変数を利用します。 +ユーティリティは、以下のような環境変数を利用します。 .Ev HOME , .Ev SHELL , .Ev TERM , .Ev TERMCAP , .Ev WINDOW_ID .Sh 関連ファイル .Bl -tag -width /dev/[pt]ty[pq]? -compact .It Pa ~/.windowrc スタートアップコマンドファイル .It Pa /dev/[pt]ty[pq]? 仮想端末デバイス .El .Sh 歴史 .Nm コマンドは、 .Bx 4.3 から導入されました。 .Sh 診断 自己説明的な診断メッセージになっています。 diff --git a/ja_JP.eucJP/man/man1/xstr.1 b/ja_JP.eucJP/man/man1/xstr.1 index c0ec675710..96ea4c60f3 100644 --- a/ja_JP.eucJP/man/man1/xstr.1 +++ b/ja_JP.eucJP/man/man1/xstr.1 @@ -1,152 +1,151 @@ .\" Copyright (c) 1980, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)xstr.1 8.2 (Berkeley) 12/30/93 -.\" %FreeBSD: src/usr.bin/xstr/xstr.1,v 1.4.2.3 2001/08/16 13:17:15 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/xstr.1,v 1.5 2001/07/29 05:14:53 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/xstr/xstr.1,v 1.4.2.4 2002/06/21 15:30:26 charnier Exp % +.\" $FreeBSD$ .\" .Dd December 30, 1993 .Dt XSTR 1 .Os .Sh 名称 .Nm xstr .Nd 共有文字列を実現するために C 言語プログラムから文字列を抽出する .Sh 書式 .Nm .Op Fl c .Op Fl .Op Fl v .Op Ar file .Sh 解説 .Nm -は、巨大なプログラムの文字列部分を保持するデータベースファイル +ユーティリティは、 +巨大なプログラムの文字列部分を保持するデータベースファイル .Pa strings をメンテナンスします。プログラム中の文字列は共通文字列 エリアへの参照に置換されます。これにより、共有文字列定数が実現できます。 これは特に read-only な文字列に有効です。 .Pp オプションは、以下のものが利用可能です: .Bl -tag -width Ds .It Fl -.Nm -は標準入力からソースを読み込みます。 +標準入力からソースを読み込みます。 .It Fl c -.Nm -は、指定された C 言語ソースまたは標準入力から文字列を抽出し、 +指定された C 言語ソースまたは標準入力から文字列を抽出し、 文字列を (&xstr[number]) 形式に変換し、適当な number を割り当てます。 適切な xstr の宣言がファイルの先頭に挿入されます。変換した C 言語ソース はファイル .Pa x.c に出力されます。文字列は文字列データベースファイル .Pa strings に格納されます。 すでに同じ文字列がデータベース中に存在している場合、 および既に存在する文字列のサフィックスの場合、 データベースは変更されません。 .It Fl v 冗長モード。 .El .Pp プログラムの全ソースファイルをコンパイルした後、 共通文字列領域を宣言するファイル .Pa xs.c を、以下のようにコマンドを実行して作成できます。 .Bd -literal -offset indent xstr .Ed .Pp このあとでファイル .Pa xs.c をコンパイルし、他のオブジェクトファイルとリンク します。 .Pa xs.c 内の文字列配列を read-only にできるならば、必要な領域とスワップ によるオーバヘッドを少なくすることができます。 .Pp .Nm はまた、1 つのファイルにのみ適用することもできます。次のコマンド .Bd -literal -offset indent xstr name .Ed .Pp によって、同じディレクトリ内のファイル .Pa strings を変更したり、参照することなく、 .Pa x.c と .Pa xs.c を 作成します。 .Pp C 言語プリプロセッサのあとで .Nm を実行するのが便利な場合、あるいはそうすることが必要な場合があります。 マクロによって文字列が生成される時などがそうです。 このときは以下のようなコマンド列を実行します。 .Pp .Bd -literal -offset indent -compact cc \-E name.c | xstr \-c \- cc \-c x.c mv x.o name.o .Ed .Pp .Nm -は新しい文字列を追加する必要がないかぎり、ファイル +ユーティリティは、新しい文字列を追加する必要がないかぎり、ファイル .Pa strings を更新しません。このため、 .Xr make 1 が不必要に .Pa xs.o を作り直すことをなくすことができます。 .Sh 関連ファイル .Bl -tag -width /tmp/xsxx* -compact .It Pa strings 文字列データベース .It Pa x.c 変換後のソースファイル .It Pa xs.c 配列 `xstr' を定義した C ソースコード .It Pa /tmp/xs* 中間ファイル .El .Sh 関連項目 .Xr mkstr 1 .Sh バグ ある文字列が他の文字列のサフィックスであり、かつ短いほうの文字列のほうが先に .Nm によって処理されたなら、 たとえ、長いほうの文字列のみを格納すればよい場合にも、 両方の文字列がデータベース strings に格納されます。 .Sh 歴史 .Nm は .Bx 3.0 で追加されました。 diff --git a/ja_JP.eucJP/man/man1/xten.1 b/ja_JP.eucJP/man/man1/xten.1 index f5f4f02cac..0ea7556f0b 100644 --- a/ja_JP.eucJP/man/man1/xten.1 +++ b/ja_JP.eucJP/man/man1/xten.1 @@ -1,114 +1,114 @@ .\" Copyright (c) 1992, 1993 Eugene W. Stark .\" 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 Eugene W. Stark. .\" 4. 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 EUGENE W. STARK (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. .\" -.\" %FreeBSD: src/usr.sbin/xten/xten.1,v 1.9.2.2 2001/03/06 14:21:47 ru Exp % +.\" %FreeBSD: src/usr.sbin/xten/xten.1,v 1.9.2.3 2002/06/21 16:42:43 charnier Exp % .\" $FreeBSD$ .\" .Dd October 30, 1993 .Dt XTEN 1 .Os .Sh 名称 .Nm xten .Nd X-10 コマンドを転送する .Sh 書式 .Nm .Op Fl "" .Ar house .Ar key Ns Op : Ns Ar cnt .Oo .Op Ar house .Ar key Ns Op : Ns Ar cnt .Ar ... .Oc .Sh 解説 .Nm -は、 X-10 デーモンへのコマンドラインインタフェースです。 +ユーティリティは、X-10 デーモンへのコマンドラインインタフェースです。 一文字のハウスコード (A-P) と一連のキー/ユニットコードが引数として 与えられて呼び出された時、X-10 デーモンへ対応する一連の X-10 パケットの転送を要求します。 コマンドが実際に受け取られて実行されるかどうかをリモートの X-10 デバイスによって 知ることは一般的にできませんが、X-10 デーモンは、パケットがすべて正しく転送されるように、 最大限努力します。 .Pp 一つの引数 .Fl 付きで呼び出された時は、 .Nm は、インタラクティブモードに入ります。ここでは、標準入力を繰り返し 読み込み、X-10 デーモンに送り、デーモンからの一行の応答が標準出力に表示されます。 .Sh オプション ハウス( .Ar house )引数は、 A-P の範囲の一文字のハウスコードです。 全ての X-10 リクエストは、ハウスコードを参照します。 各キー( .Ar key )は 1-16 の数値コードか、X-10 機能を指定する文字列です。 可能な機能コード文字列は以下の通りです。 .Bl -diag .It AllUnitsOff .It AllLightsOn .It On .It Off .It Dim .It Bright .It AllLightsOff .It ExtendedCode .It HailRequest .It HailAcknowledge .It PreSetDim0 .It PreSetDim1 .It ExtendedData .It StatusOn .It StatusOff .It StatusRequest .El .Pp 各キー( .Ar key )にはオプションの数字( .Ar cnt )が続きます。この数字は、間隙がないキーコード によっておくられるパケットの数を指定します。 この引数が省略された時、二つのパケットが転送されます。 X-10 の .Em Dim と .Em Bright コマンドでは、二つ以外のパケット数を指定して使うことができます。 .Sh 関連項目 .Xr tw 4 , .Xr xtend 8 .Sh 関連ファイル .Bl -tag -width /var/spool/xten/Status -compact .It Pa /dev/tw0 TW523 スペシャルファイル .El .Sh 作者 .An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja_JP.eucJP/man/man1/yacc.1 b/ja_JP.eucJP/man/man1/yacc.1 index 1684734b8f..b9185947f5 100644 --- a/ja_JP.eucJP/man/man1/yacc.1 +++ b/ja_JP.eucJP/man/man1/yacc.1 @@ -1,143 +1,143 @@ .\" Copyright (c) 1989, 1990 The Regents of the University of California. .\" All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Robert Paul Corbett. .\" .\" 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. .\" .\" @(#)yacc.1 5.8 (Berkeley) 5/24/93 -.\" %FreeBSD: src/usr.bin/yacc/yacc.1,v 1.10 2000/01/10 08:54:09 kris Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/yacc.1,v 1.6 2001/05/14 01:07:31 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/yacc/yacc.1,v 1.10.2.1 2002/06/21 15:30:28 charnier Exp % +.\" $FreeBSD$ .\" .Dd May 24, 1993 .Dt YACC 1 .Os .Sh 名称 .Nm yacc .Nd LALR(1) パーサジェネレータ .Sh 書式 .Nm .Op Fl dlrtv .Op Fl b Ar file_prefix .Op Fl o Ar output_filename .Op Fl p Ar symbol_prefix .Ar filename .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar filename から文法仕様を読み取り、その仕様から LR(1) パーサを生成します。 パーサは、C 言語で書かれた LALR(1) 解析テーブルとドライバルーチンのセットから構成されています。 .Nm -は通常、 +ユーティリティは通常、 .Pa y.tab.c というファイルに解析テーブルとドライバルーチンを書き込みます。 .Pp 以下のオプションが使えます: .Bl -tag -width indent .It Fl b Ar file_prefix 出力ファイル名の先頭に加えるプレフィックス文字列を .Ar file_prefix に変更します。 デフォルトのプレフィックスは .Pa y です。 .It Fl d ヘッダファイル .Pa y.tab.h を生成するよう指示します。 .It Fl l もし .Fl l オプションが指定されていなければ、 .Nm は生成コードに #line ディレクティブを挿入します。 #line ディレクティブは、生成されたコードの中のエラーと ユーザのオリジナルコードとの関連づけを C コンパイラに行わせます。 もし .Fl l オプションが指定されていれば、 .Nm は #line ディレクティブを挿入しません。 ユーザによって指定された #line ディレクティブはそのまま残されます。 .It Fl o Ar output_filename .Nm に対し、デフォルトファイルの .Pa y.tab.c の代りに .Ar output_filename に生成コードを出力させます。 .It Fl p Ar symbol_prefix yacc によって生成されたシンボルの先頭につけるプレフィックスを .Ar symbol_prefix で指定された文字列に変更します。 デフォルトのプレフィックスは、文字列 .Pa yy です。 .It Fl r .Nm はコードとテーブルを別々のファイルに出力します。コードファイル名は .Pa y.code.c となり、テーブルファイル名は .Pa y.tab.c となります。 .It Fl t .Nm によって生成されるプリプロセッサディレクティブを変更し、デバッグ 用の文をコンパイルされたコードの中に埋め込みます。 .It Fl v 生成されたパーザの詳細を人間に読める形式で、 ファイル .Pa y.output に出力します。 .El .Pp もし環境変数 .Ev TMPDIR が設定されていれば、 .Ev TMPDIR に設定されている文字列はテンポラリファイルが作られる ディレクトリ名として使用されます。 .Sh 関連ファイル .Bl -tag -width /tmp/yacc.aXXXXXXXXXX -compact .It Pa y.code.c .It Pa y.tab.c .It Pa y.tab.h .It Pa y.output .It Pa /tmp/yacc.aXXXXXXXXXX .It Pa /tmp/yacc.tXXXXXXXXXX .It Pa /tmp/yacc.uXXXXXXXXXX .El .Sh 診断 もし還元できないルールがあった場合、そのルール数が標準エラー 出力に表示されます。 もし何らかの LALR(1) の衝突があった場合、衝突数も標準エラー出力に表 示されます。 diff --git a/ja_JP.eucJP/man/man1/yes.1 b/ja_JP.eucJP/man/man1/yes.1 index f5c39d26e5..ab5b398f44 100644 --- a/ja_JP.eucJP/man/man1/yes.1 +++ b/ja_JP.eucJP/man/man1/yes.1 @@ -1,56 +1,56 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)yes.1 8.1 (Berkeley) 6/6/93 -.\" %FreeBSD: src/usr.bin/yes/yes.1,v 1.3.2.3 2001/08/16 13:17:16 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/yes.1,v 1.6 2001/07/29 05:14:53 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/yes/yes.1,v 1.3.2.4 2002/06/21 15:30:31 charnier Exp % +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt YES 1 .Os .Sh 名称 .Nm yes .Nd 繰り返し肯定する .Sh 書式 .Nm .Op Ar expletive .Sh 解説 .Nm -は指定した文字列 +ユーティリティは、指定した文字列 .Ar expletive 、もしくはデフォルトの .Dq y を永久に出力します。 .Sh 歴史 .Nm コマンドは .At 32v から登場しました。 diff --git a/ja_JP.eucJP/man/man1/ypcat.1 b/ja_JP.eucJP/man/man1/ypcat.1 index 2a5a83fdbd..db02f9977a 100644 --- a/ja_JP.eucJP/man/man1/ypcat.1 +++ b/ja_JP.eucJP/man/man1/ypcat.1 @@ -1,72 +1,72 @@ .\" Copyright (c) 1993 Winning Strategies, Inc. .\" 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 Winning Strategies, Inc. .\" 4. 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. .\" -.\" %FreeBSD: src/usr.bin/ypcat/ypcat.1,v 1.8.2.4 2002/02/01 15:51:19 ru Exp % +.\" %FreeBSD: src/usr.bin/ypcat/ypcat.1,v 1.8.2.5 2002/06/21 15:30:33 charnier Exp % .\" $FreeBSD$ .\" .Dd December 3, 1993 .Dt YPCAT 1 .Os .Sh 名称 .Nm ypcat .Nd "YP データベースのすべてのキーの値を表示する" .Sh 書式 .Nm .Op Fl kt .Op Fl d Ar domainname .Ar mapname .Nm .Fl x .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar mapname (マップの名前またはニックネーム) で指定された .Tn YP データベース中のすべてのキーに関連付けられた値を表示します。 .Pp オプションは以下のとおりです: .Bl -tag -width indent .It Fl d Ar domainname デフォルトとは異なったドメイン名を用いたいときに指定します。 .It Fl k 指定したマップのキーも表示します。値が空のマップや、値にキーが含ま れていないマップの内容を表示するのに便利です。 .It Fl t マップのニックネームを、対応したマップ名に変換することを禁止します。 .It Fl x マップのニックネームテーブルを表示します。 .El .Sh 関連項目 .Xr domainname 1 , .Xr ypmatch 1 , .Xr yp 8 , .Xr ypbind 8 , .Xr ypset 8 .Sh 作者 .An Theo De Raadt .Aq deraadt@theos.com . diff --git a/ja_JP.eucJP/man/man1/ypmatch.1 b/ja_JP.eucJP/man/man1/ypmatch.1 index 1d4e636dea..750960a8be 100644 --- a/ja_JP.eucJP/man/man1/ypmatch.1 +++ b/ja_JP.eucJP/man/man1/ypmatch.1 @@ -1,74 +1,74 @@ .\" Copyright (c) 1993 Winning Strategies, Inc. .\" 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 Winning Strategies, Inc. .\" 4. 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. .\" -.\" %FreeBSD: src/usr.bin/ypmatch/ypmatch.1,v 1.8.2.4 2002/02/01 15:51:19 ru Exp % +.\" %FreeBSD: src/usr.bin/ypmatch/ypmatch.1,v 1.8.2.5 2002/06/21 15:30:35 charnier Exp % .\" $FreeBSD$ .\" .Dd December 3, 1993 .Dt YPMATCH 1 .Os .Sh 名称 .Nm ypmatch .Nd "YP データベースのキーの値を表示する" .Sh 書式 .Nm .Op Fl kt .Op Fl d Ar domainname .Ar key ... .Ar mapname .Nm .Fl x .Sh 解説 .Nm -は、 +ユーティリティは、 .Ar mapname (マップの名前またはニックネーム) で指定された .Tn YP データベースを、 指定された 1 つまたは複数のキーで検索し、キーに対応する値を表示します。 .Pp オプションは以下のとおりです: .Bl -tag -width indent .It Fl d Ar domainname デフォルトとは異なったドメイン名を用いたいときに指定します。 .It Fl k 指定したマップのキーも表示します。値が空のマップや、値にキーが含ま れていないマップの内容を表示するのに便利です。 .It Fl t マップのニックネームを、対応したマップ名に変換することを禁止します。 .It Fl x マップのニックネームテーブルを表示します。 .El .Sh 関連項目 .Xr domainname 1 , .Xr ypcat 1 , .Xr yp 8 , .Xr ypbind 8 , .Xr ypset 8 .Sh 作者 .An Theo De Raadt Aq deraadt@theos.com . diff --git a/ja_JP.eucJP/man/man1/ypwhich.1 b/ja_JP.eucJP/man/man1/ypwhich.1 index afeddb0a2e..b0323174f0 100644 --- a/ja_JP.eucJP/man/man1/ypwhich.1 +++ b/ja_JP.eucJP/man/man1/ypwhich.1 @@ -1,99 +1,99 @@ .\" %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. .\" -.\" %FreeBSD: src/usr.bin/ypwhich/ypwhich.1,v 1.4.2.3 2002/02/01 15:51:19 ru Exp % +.\" %FreeBSD: src/usr.bin/ypwhich/ypwhich.1,v 1.4.2.4 2002/06/21 15:30:38 charnier Exp % .\" .\" $FreeBSD$ .Dd February 23, 1994 .Dt YPWHICH 1 .Os .Sh 名称 .Nm ypwhich .Nd YP サーバのホスト名、もしくはマップのマスタを表示する .Sh 書式 .Nm .Op Fl d Ar domain .Oo .Op Fl t .Fl m Oo Ar mname Oc | Ar host .Oc .Nm .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 8 , .Xr ypbind 8 , .Xr yppoll 8 , .Xr ypset 8 .Sh 作者 .An Theo De Raadt diff --git a/ja_JP.eucJP/man/man5/printcap.5 b/ja_JP.eucJP/man/man5/printcap.5 index 4d17d41293..632cb5f5d0 100644 --- a/ja_JP.eucJP/man/man5/printcap.5 +++ b/ja_JP.eucJP/man/man5/printcap.5 @@ -1,412 +1,412 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)printcap.5 8.2 (Berkeley) 12/11/93 -.\" %FreeBSD: src/usr.sbin/lpr/lpr/printcap.5,v 1.16.2.10 2002/04/28 23:29:12 gad Exp % +.\" %FreeBSD: src/usr.sbin/lpr/lpr/printcap.5,v 1.16.2.11 2002/06/19 01:57:18 gad Exp % .\" .\" $FreeBSD$ .Dd October 11, 2000 .Dt PRINTCAP 5 .Os .Sh 名称 .Nm printcap .Nd プリンタケーパビリティデータベース .Sh 書式 .Nm .Sh 解説 .Nm は、 ラインプリンタの記述に使われる .Xr termcap 5 を簡略化したものです。 スプールシステムは利用のたび毎に .Nm ファイルにアクセスするため、 プリンタを動的に追加したり削除することが可能です。 データベース中の各々のエントリが、1 台のプリンタを記述するのに使われます。 .Xr termcap 5 とは異なり、このデータベースは代替できません。 これは、アカウント情報がバイパスされてしまうことがあるからです。 .Pp デフォルトのプリンタは通常 .Em lp ですが、環境変数 .Ev PRINTER によって上書きすることもできます。 各スプーリングユーティリティはオプション .Fl P Ar printer をサポートし、出力先のプリンタ名を明示することが可能です。 .Pp あるプリンタに対するデータベースをセットアップする方法の詳細については、 .%T "4.3 BSD Line Printer Spooler Manual" を参照してください。 .Sh ケーパビリティ ファイルレイアウトの解説については .Xr termcap 5 を参照してください。 .Bl -column Namexxx Typexx "/var/spool/lpdxxxxx" .Sy "Name Type Default Description .It "af str" Ta Dv NULL Ta No "アカウンティングファイル名" .It "br num none lp が tty の場合、ボーレートを設定 " -.Pf ( Xr ioctl 2 +.Xr ( ioctl 2 call) .It "cf str" Ta Dv NULL Ta No "cifplot データ用フィルタ" .It "ct num 120 TCP コネクションのタイムアウト時間(秒)" .It "df str" Ta Dv NULL Ta No "tex データ用フィルタ" -.Pf ( Tn DVI +.Tn ( DVI フォーマット) .It "ff str" Ta So Li \ef Sc Ta No "フォームフィード送信文字" .It "fo bool false デバイスオープン時にフォームフィードを印字" .It "gf str" Ta Dv NULL Ta No "グラフデータフィルタ" -.Pf ( Xr plot 3 +.Xr ( plot 3 フォーマット .It "hl bool false バーストヘッダページを最後に印刷" .It "ic bool false 字下げ出力の用の(非標準の) ioctl をサポートした ドライバ" .It "if str" Ta Dv NULL Ta No "アカウンティングを行うためのテキストフィルタ名" .It "lf str" Ta Pa /dev/console Ta No "エラーロギングファイル名" .It "lo str" Ta Pa lock Ta No "ロックファイル名" .It "lp str" Ta Pa /dev/lp Ta No "出力時にオープンするデバイス名" .It "mc num" Ta 0 Ta Xr lpr 1 で要求できる最大部数を指定します。0 = 制限なし。 .It "ms str" Ta Dv NULL Ta No "lp が tty の場合、コンマで区切ったリスト。" tty モード記述用の .Xr stty 1 リストに似ている。 .It "mx num 1000 最大ファイルサイズ (" .Dv BUFSIZ ブロック単位)。0 = 制限なし。 .It "nd str" Ta Dv NULL Ta No "キューのリスト用の次のディレクトリ (未実装)" .It "nf str" Ta Dv NULL Ta No "ditroff データ用フィルタ (device independent troff)" .It "of str" Ta Dv NULL Ta No "出力用フィルタリングプログラム名" .It "pc num 200 1 フィートまたは 1 ページあたりの 費用 (1/100 セント単位)" .It "pl num 66 1 ページの行数" .It "pw num 132 1 行の文字数" .It "px num 0 ピクセル単位のページ幅 (水平方向)" .It "py num 0 ピクセル単位のページ長 (垂直方向)" .It "rc bool false リモートホストへ送信時、各部を再送します (下記参照)" .It "rf str" Ta Dv NULL Ta No "" .Tn FORTRAN 形式のテキストファイル出力用フィルタ .It "rg str" Ta Dv NULL Ta No "グループ制限。許可されたグループのメンバのみアクセスが許可される" .It "rm str" Ta Dv NULL Ta No "リモートプリンタ名" .It "rp str" Ta Pa lp Ta No "リモートプリンタ名引数" .It "rs bool false ローカルにアカウントを持つリモートユーザに対する制限" .It "rw bool false プリンタデバイスを読み書き用にオープンする" .It "sb bool false 短いバナー (1 行のみ)" .It "sc bool false 複数コピーの抑制" .It "sd str" Ta Pa /var/spool/lpd Ta No "スプール ディレクトリ" .It "sf bool false フォームフィードの抑制" .It "sh bool false バーストページヘッダの出力抑制" .It "sr str" Ta Dv NULL Ta No "受信される各データファイルの統計情報を保持するファイル名" .It "ss str" Ta Dv NULL Ta No "送信される各データファイルの統計情報を保持するファイル名" .It "st str" Ta Pa status Ta No "状態ファイル名" .It "tf str" Ta Dv NULL Ta No "troff データ用フィルタ (cat phototypesetter)" .It "tr str" Ta Dv NULL Ta No "キューが空の時に印刷するトレイラ文字列" .It "vf str" Ta Dv NULL Ta No "ラスタイメージ用フィルタ" .El .Pp 2 文字のケーパビリティは、別の読み易い名前があります。 .Bl -column "短い形式" "長い形式" .Sy "短い形式 長い形式" .It "af acct.file" .It "br tty.rate" .It "cf filt.cifplot" .It "ct remote.timeout" .It "df filt.dvi" .It "du daemon.user" .It "ff job.formfeed" .It "fo job.topofform" .It "gf filt.plot" .It "hl banner.last" .It "if filt.input" .It "lf spool.log" .It "lo spool.lock" .It "lp tty.device" .It "mc max.copies" .It "ms tty.mode" .It "mx max.blocks" .It "nf filt.ditroff" .It "of filt.output" .It "pc acct.price" .It "pl page.length" .It "pw page.width" .It "px page.pwidth" .It "py page.plength" .It "rc remote.resend_copies" .It "rf filt.fortran" .It "rg daemon.restrictgrp" .It "rm remote.host" .It "rp remote.queue" .It "rs daemon.restricted" .It "rw tty.rw" .It "sb banner.short" .It "sc job.no_copies" .It "sd spool.dir" .It "sf job.no_formfeed" .It "sh banner.disable" .It "sr stat.recv" .It "ss stat.send" .It "st spool.status" .It "tf filt.troff" .It "tr job.trailer" .It "vf filt.raster" .El .Pp ローカルラインプリンタのドライバが字下げをサポートしているならば、 プリンタデーモンはその使い方を理解しなければなりません。 .Sh フィルタ .Xr lpd 8 デーモンは .Em filters のパイプラインを作成し、さまざまなタイプのプリンタ用に処理を行います。 フィルタは .Xr lpr 1 へ渡されるフラグに応じて選択されます。 パイプラインは次のように設定されます。 .Bd -literal -offset indent p pr | if 通常テキスト + pr(1) none if 通常テキスト c cf cifplot d df DVI (tex) g gf plot(3) n nf ditroff f rf Fortran t tf troff v vf ラスタイメージ .Ed .Pp .Sy if フィルタは次の引数をとります。 .Bd -ragged -offset indent .Cm if .Op Fl c .Fl w Ns Ar width .Fl l Ns Ar length .Fl i Ns Ar indent .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Fl c フラグは .Fl l フラグ (コントロール文字をそのまま通過させます) が .Xr lpr 1 に指定された場合のみ渡されます。 .Ar width 機能と .Ar length 機能はページ幅とページ長を (それぞれ .Cm pw と .Cm pl によって) 文字単位で指定します。 .Fl n と .Fl h パラメータでそれぞれのジョブの所有者のログイン名とログイン先ホスト名を 指定します。 .Ar acct-file 機能は .Nm の .Cm af エントリがそのまま使われます。 .Pp .Cm if が指定されなかった場合、 .Cm of が代わりに使われます。 .Cm of は .Cm if が個々のジョブ毎にオープンされるのに対して、たった 1 回だけ オープンされると言う特徴を持っています。 そのため、アカウンティングを行うには .Cm if の方が向いています。 .Cm of には、 .Ar width と .Ar length フラグのみが与えられます。 .Pp その他の全てのフィルタは次のように呼び出されます。 .Bd -ragged -offset indent .Nm filter .Fl x Ns Ar width .Fl y Ns Ar length .Fl n Ar login .Fl h Ar host acct-file .Ed .Pp .Ar width と .Ar length はピクセル単位で表され、それぞれ .Cm px と .Cm py エントリで指定されます。 .Pp 全てのフィルタはファイルを .Em stdin から読み込み .Em stdout からの出力をプリンタに送られ、 .Em stderr または .Xr syslog 3 がログ出力に使われます。 フィルタは .Dv SIGINT を無視してはいけません。 .Sh リモートプリンティング .Cm rm を使用してリモートプリンタに印刷する時、 .Cm if または .Cm of を使用できます。両方を指定した場合、 .Cm of は無視されます。 どちらのフィルタも同様に振舞いますが、上述の通り異なった引数を渡されます。 特に、出力フィルタはファイルが転送されるたびに、停止・再起動されます。 このように動作することが必要な理由は、フィルタを通した結果の大きさをリモート .Xr lpd 8 に渡すためです。 .Pp .Fl p フラグが .Xr lpr 1 に渡されると、 .Xr pr 1 はローカルでは実行されませんが、リモートの .Xr lpd 8 に対して要求されます。それゆえ、 .Cm if を介したフィルタリングは、 .Xr pr 1 が実行される後ではなく前に実行されることになります。 .Pp ネットワークプリンタのモデルによっては、 .Xr lpd 8 からのジョブを受け付けるものの、ジョブ制御ファイルを無視し、 各データファイルがプリンタに届くと印刷するだけのものがあります。 このような動作の副作用のひとつに、 .Xr lpr 1 コマンドで指定される .Fl # フラグで指定される複数部数の要求をプリンタが無視してしまうことがあります。 .Cm rc エントリは、ユーザが元々要求した各部に対して、 .Xr lpd 8 がデータファイルを再送するようにします。 .Cm rc エントリを指定して良いのは、プリンタに直接ジョブを送るホストだけです。 .Pp .Cm lp が .Em port Ns No @ Ns Em machine で指定された場合 (そして .Cm rm が使用されない場合)、印刷は指定された .Em machine の指定された .Em port に直接転送されます。 .Sh 転送の統計情報 印刷ジョブがリモートマシン (他の UNIX ボックスかもしれませんしネットワークプリンタかもしれません) に転送されるとき、各転送の統計情報を保持することが有効かもしれません。 .Cm sr および .Cm ss のオプションは、lpd がこのような統計情報を保持するためのファイル名を示します。 ジョブの統計情報の行が各データファイルに書き込まれるのは、 ファイルの転送に成功したときです。 行の書式は、転送における送信側と受信側とで、同一です。 .Pp ジョブを送ってくる種々のマシンとプリントサーバ間のネットワーク性能に 興味がある場合、 受信データファイルの統計情報をプリントサーバで使えるかもしれません。 プリントサーバは、印刷ジョブがサーバに届くたびに、 各印刷ジョブの速度の統計情報を集めることができます。 .Pp 誰がどのジョブをリモートプリンタに送ったのか、 何時送られたのか、そしてファイルの (バイト数での) 大きさはどのくらいだったか について知りたい場合、送信データファイルの統計情報を 最小のアカウンティング記録として使えるかもしれません。 しかし、何ページ印刷したのかといった情報は一切含みません。 なぜなら、 そのような情報をリモート (ネットワーク) プリンタから得るための標準的な方法が 存在しないためです。 .Sh ロギング ラインプリンタプログラム自身 (つまり .Xr lpd 8 とそれに関連するプログラム) が生成したエラーメッセージは、 .Xr syslog 3 の .Dv LPR ファシリティを使ってロギングされます。 フィルタの 1 つから .Em stderr に出力されたメッセージは、対応する .Cm lf で指定されたファイルに送られます。 当然、フィルタ自身もまた .Xr syslogd 8 を使うことがあるかも知れません。 .Pp コンソールに送られるエラーメッセージには、ラインフィードだけではなく キャリッジリターンとラインフィードが追加されます。 .Sh 関連項目 .Xr lpq 1 , .Xr lpr 1 , .Xr lprm 1 , .Xr hosts.lpd 5 , .Xr termcap 5 , .Xr chkprintcap 8 , .Xr lpc 8 , .Xr lpd 8 , .Xr pac 8 .Rs .%T "4.3 BSD Line Printer Spooler Manual" .Re .Sh 歴史 .Nm ファイルフォーマットは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man7/groff_mdoc.7 b/ja_JP.eucJP/man/man7/groff_mdoc.7 index d90c34c1d6..77500fd189 100644 --- a/ja_JP.eucJP/man/man7/groff_mdoc.7 +++ b/ja_JP.eucJP/man/man7/groff_mdoc.7 @@ -1,4117 +1,4119 @@ .\" groff_mdoc.man .\" .\" A complete reference of the mdoc macro package for GNU troff. .\" .\" Based on NetBSD's mdoc.samples.7, version 1.21. .\" .\" .\" Warning: You can't format this file with the old mdoc macros! .\" .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)mdoc.samples.7 8.2 (Berkeley) 12/30/93 .\" .\" This reference invokes every macro in the package several .\" times and is guaranteed to give a worst case performance .\" for an already extremely slow package. .\" +.\" %FreeBSD: src/contrib/groff/tmac/groff_mdoc.man,v 1.1.1.1.4.8 2002/06/18 00:50:30 dougb Exp % +.\" .\" $FreeBSD$ .\" Copyright (c) 2001 FreeBSD jpman project .\" This is for Japanese translation done by FreeBSD jpman project. .\" WORD: epoch 基準時点 (協定世界時 1970年1月1日 00:00:00) .\" WORD: display ディスプレイ .\" WORD: bracket 角括弧 [] .\" WORD: brace 中括弧 () .\" WORD: angle bracket 山括弧 <> .\" WORD: acronym 頭字語 .\" WORD: keep キープ .\" WORD: literal リテラル .\" WORD: content macro コンテントマクロ .\" WORD: command modifier コマンド修飾子 .\" WORD: enclosure 囲い .\" WORD: quoting クォート .\" WORD: nest 入れ子 .\" WORD: block ragged 凹凸ブロック .\" WORD: constant width character 定幅文字 .\" WORD: scale indicator スケール指示子 .\" WORD: hanging tag ぶら下がりタグ .\" WORD: overhanging tag オーバハングタグ .\" WORD: parsed 構文解析される .\" WORD: callable 呼び出し可能 . .Dd July 20, 2001 .Os .Dt GROFF_MDOC 7 . . .Sh 名称 . .Nm groff_mdoc .Nd groff mdoc の実装に関するリファレンス . . .Sh 書式 . .Nm groff Fl m Ns Cm doc Ar . . .Sh 解説 . .Tn GNU .Xr troff 1 用の .Em コンテントベース でかつ .Em 領域ベース な整形用パッケージである .Nm \-mdoc マクロパッケージを使って .Ux マニュアルページを書くための完全なリファレンスです。 前身である .Xr \-man 7 パッケージは、フォントの操作や他の写植方法の詳細は個々の作者に任せ、 ページのレイアウトを取り扱ってきました。 .Nm \-mdoc では、ページレイアウトマクロは タイトル、セクションのヘッダ、ディスプレイ、リストのマクロからなる .Em "ページ構造領域" を形成しています。本質的にこれらの要素は整形されたページにおける テキストの物理的位置に影響を与えます。 ページ構造領域に加え、さらに .Em マニュアル 領域および .Em 一般 テキスト領域の 2 つの領域があります。 一般テキスト領域は、テキストの一部をクォートしたり強調したりと いったような作業を実行するマクロとして定義されています。 マニュアル領域はコマンドやルーチン、それに .Ux の関連ファイルを記述するための日常使用されるインフォーマルな言葉の サブセットであるマクロとして定義されています。 マニュアル領域のマクロはコマンド名、コマンド行の引数とオプション、 関数名、関数のパラメータ、パス名、変数名、他のマニュアルページへの クロスリファレンスなどを扱います。 これらの領域の項目は作者とマニュアルページの将来のユーザの両者に とって価値のあるものです。 マニュアル間で一貫性を高めることによって将来のドキュメントツールへの 移行が容易になることが期待されます。 .Pp .Ux マニュアルページ全体を通して、マニュアルのエントリは単純に マニュアルページ (a man page) とみなされます。 これは実際のページ数と関係ありませんし、性差別をする意図もありません。 .\" 訳注: a man page -- 1 ページ (a page) と男 (man) の意味 . . .Sh "さあ、始めよう" . このドキュメントの残りの部分で説明されている題材は以下のような構成に なっています。 . .Bl -enum -width 3n -offset indent . It . Tn "TROFF に特有な表現" . . Bl -tag -width 2n -compact . It "マクロの使用方法" . It "引数に空白文字を指定する" . It "行末の空白文字" . It "特殊文字のエスケープ" . It "その他の注意点" . El . . It . Tn "マニュアルページのテンプレート" . . It . Tn "使用法" . . It . Tn "タイトルマクロ" . . It . Tn "マニュアル領域および一般テキスト領域の紹介" . . Bl -tag -width 2n -compact . It "この名前には何が" Ns ... . It "一般的な構文" . El . . It . Tn "マニュアル領域" . . Bl -tag -width 2n -compact . It "アドレス" . It "作者名" . It "引数" . It "コンフィギュレーション宣言 (セクション 4 のみ)" . It "コマンド修飾子" . It "定義済みの変数" . It "errno (セクション 2 のみ)" . It "環境変数" . It "フラグ" . It "関数の宣言" . It "関数の型" . It "関数 (ライブラリルーチン)" . It "関数の引数" . It "戻り値" . It "終了ステータス" . \" .It "ヘッダファイル (ソースコードを含む)" . It "対話的なコマンド" . It "ライブラリ名" . It "リテラル" . It "名称" . It "オプション" . It "パス名" . It "標準" . It "変数の型" . It "変数" . It "マニュアルページのクロスリファレンス" . El . . It . Tn "一般テキスト領域" . . Bl -tag -width 2n -compact . It "AT&T マクロ" . It "BSD マクロ" . It "NetBSD マクロ" . It "FreeBSD マクロ" . It "OpenBSD マクロ" . It "BSD/OS マクロ" . It "UNIX マクロ" . It "強調マクロ" . It "フォントモード" . It "囲い/クォート マクロ" . It "無操作もしくは通常テキストマクロ" . It "空白なしマクロ" . It "セクションのクロスリファレンス" . It "記号" . It "数式記号" . It "参考文献と引用" . It "商標名 (頭字語とタイプ名)" . It "拡張引数" . El . . It . Tn "ページ構造領域" . . Bl -tag -width 2n -compact . It "セクションヘッダ" . It "サブセクションヘッダ" . It "段落と行スペース" . It "キープ" . It "例示とディスプレイ" . It "リストとカラム" . El . . It . Tn "その他のマクロ" . . It . Tn "定義済みの文字列" . . It . Tn "診断" . . It . Tn "GROFF, TROFF および NROFF を使用した整形" . . It . Tn "関連ファイル" . . It . Tn "関連項目" . . It . Tn "バグ" .El . .\" XXX .if t \ . ne 7 . . .Sh "TROFF に特有な表現" . .Nm \-mdoc パッケージは、マニュアルページを記述するプロセスを簡単にすることを 目的としています。 .Nm \-mdoc を使うために .Tn GNU .Xr troff 1 のゴタゴタした詳細を学ぶ必要がないのが理想ですが、 いくつか片付けるべき避けられない制限事項があります。 また、このパッケージは高速で .Em ない ということも予め警告しておきます。 . .Ss "マクロの使用方法" . .Tn GNU .Xr troff 1 のように、マクロは .Ql .\& (ドット) を行頭に置き、それに続けて 2 文字 (または 3 文字) からなる マクロの名称を指定することによって呼び出されます。 ドットとマクロの間にはスペースを置くことができます (ただし、タブを置くことは .Em できません )。 引数はマクロの後にスペースで区切って指定することができます (やはり、タブは使用できません)。 行頭にドットを指定することによって .Tn GNU .Xr troff 1 にそれに続く 2 文字 (あるいはそれより多い文字) を マクロ名として解釈するよう指示しています。 最初にドット 1 文字をとり、その後ろに何も来ない場合は 無視されます。 マクロを起動させたくないような文脈で、入力行の先頭に .Ql .\& (ドット) を置くためには、 .Ql .\& (ドット) の前にエスケープシーケンス .Ql \e& を指定します。 .Ql \e& は文字通りスペース幅が 0 として解釈され、出力には現れません。 .Pp 一般的に .Tn GNU .Xr troff 1 マクロは取り得る引数の数に制限はありません (9 つ以上の 引数を扱うことのできない他のバージョンの troff とは違います)。 限られた場合ではありますが、引数を次の行に続けたり、拡張したり することができます (後述の .Sx 拡張引数 のセクションを参照)。 ほとんどすべてのマクロで引用符に囲まれた引数を扱うことができます (後述の .Sx 引数に空白文字を指定する のセクションを参照)。 .Pp .Nm \-mdoc での一般テキスト領域とマニュアル領域のほとんどのマクロは、 呼び出し可能なマクロ名を決定するためにその引数のリストが .Em 構文解析 されるという点で特別なものです。 これはつまり、一般テキスト領域またはマニュアル領域のマクロ名に一致し、 かつ、呼び出し可能であると判断された引数リスト中の引数は、 処理される時に実行されるか、もしくは呼び出されるということです。 この場合、引数がマクロの名前であっても .Ql .\& (ドット) で前置されません。 このようにしてたくさんのマクロを入れ子にすることができます。 例えばオプションマクロ .Ql .Op はフラグマクロおよび引数マクロ .Ql \&Fl と .Ql \&Ar を .Em 呼び出し て、オプションのフラグを引数とともに指定することができます: . .Bl -tag -width ".Op Fl s Ar bytes" -offset indent .It Op Fl s Ar bytes は .Ql ".Op Fl s Ar bytes" で生成されます。 .El . .Pp 文字列がマクロ名と解釈されないようにするには、 その文字列の前にエスケープシーケンス .Ql \e& を指定します。 . .Bl -tag -width ".Op \&Fl s \&Ar bytes" -offset indent .It Op \&Fl s \&Ar bytes は .Ql ".Op \e&Fl s \e&Ar bytes" で生成されます。 .El . .Pp ここで文字列 .Ql \&Fl と .Ql \&Ar はマクロとして解釈されていません。 このドキュメントを通じて、 呼び出し可能な引数を調べるために引数リストが構文解析されるマクロは .Em 構文解析される マクロとして参照し、 引数リストから呼び出されることができるマクロは .Em 呼び出し可能 なマクロとして参照します。 .Nm \-mdoc のマクロはほとんどすべてが構文解析されるのですから、これは技術的には .Em 適当でない 表現ですが、常にマクロを「呼び出し可能である」とか「他のマクロを 呼び出すことができる」と表現するのは面倒なことであるため、 「構文解析される」という用語を使います。 . .Ss "引数に空白文字を指定する" . 1 つ以上の空白文字を含む文字列を引数として指定したい 場合があります。 引数リスト中の要素が特定の並びをしていることを 期待しているマクロに引数を指定する時に必要になることがあります。 さらに、こうすると .Nm \-mdoc が速く実行されるようになるのです。 例えば、関数マクロ .Ql .Fn では第 1 引数は関数名であり、残りの引数が関数のパラメータであると 想定されています。 .Tn ANSI\~C では、関数のパラメータ宣言を括弧で囲まれたパラメータリスト中に 明示することを規定しているので、 各パラメータは最低でも 2 語の文字列となります。 例えば、 .Fa int foo のようになります。 .Pp 空白を含む引数を指定するには 2 通りの方法があります。 1 つは、空白を含む文字列を渡すのに、固定の空白、 つまりパディングされない空白文字 .Ql \e\ を使う方法です。すなわち、空白の前にエスケープ文字 .Ql \e を指定します。 この方法はどのマクロでも使うことができますが、1 行が長くなり過ぎた テキストを調整するときの邪魔になるという副作用があります。 .Xr troff では、固定の空白は他の印刷可能な文字と同様に扱われ、通常期待されるように その箇所で文字列を空白や改行で分けることは行われなくなります。 この方法は文字列が行の境界にまたがることが好ましくない場合に有用です。 代替案としては、 パディング可能 (すなわち伸長可能) で分割不可能な空白 .Ql \e~ を使うことがあります (これは、 .Tn GNU .Xr troff 1 拡張です)。 2 つ目の方法は、文字列をダブルクォートで括ることです。 .Pp 例えば、次のようにします: . .Bl -tag -width ".Fn fetch char\ *str" -offset indent .It Fn fetch char\ *str は .Ql ".Fn fetch char\e *str" で生成されます。 .It Fn fetch "char *str" も .Ql ".Fn fetch \*[q]char *str\*[q]" で生成することができます。 .El . .Pp もし、最初の例の空白の前もしくは次の例のダブルクォートの前の .Ql \e が省略されていた場合には .Ql .Fn は引数が 3 つであるとみなし、その結果は .Pp .Dl Fn fetch char *str .Pp となります。 .\" For an example of what happens when the parameter list overlaps a newline .\" boundary, see the .\" .Sx BUGS .\" section. . .Ss "行末の空白文字" . .Xr Troff は行末に空白文字があると混乱してしまうことがあります。 .Ao 空白 Ac Ns Ao 行末 Ac の文字の並びからすべての空白文字を取り除くのは良い予防策です。 どうしても行末に空白文字をおく必要性が出てきた場合は、 パディングされない空白とエスケープ文字 .Ql \e& を使用することによって対応できます。 例えば、 .Ql string\e\ \e& のようにします。 . .Ss "特殊文字のエスケープ" . 改行 .Ql \en のような特殊文字は、バックスラッシュを保存するために .Ql \e を .Ql \ee で置き換え (たとえば .Ql \een とする) て扱います。 . .Ss "その他の注意点" . 表示領域外で空の入力行が見つかった場合には警告が発生します (後述)。 代わりに .Ql .sp を使用してください ( .Nm \-mdoc マクロを使用して、低レベルコマンドを使用しないようにすると ずっと良いです)。 .Pp 先頭に空白を置くと行分割が生じ、そのまま出力されてしまいます。 可能ならばこうなることを避けてください。 同様に、通常のテキスト行において単語間に 2 つ以上の空白文字を 使用しないでください。これは、他のテキストフォーマッタとは 対照的です。空白文字を 2 つ以上置いても 1 つの空白文字に .Em 置き換わりません 。 .Pp 引数として .Ql \*[q] を直接渡すことはできません。 代わりに .Ql \e*[q] (あるいは .Ql \e*q ) を使用してください。 .Pp デフォルトでは、 .Xr troff 1 は文を終了させる句読点の後に空白文字を 2 つ挿入します。 つまり、 .Ql \&) あるいは .Ql \&' などの文字はそのまま扱われ、文の終了には影響を与えません。 この動作を変更するには、 ドットの前あるいは後に .Ql \e& を挿入してください。 . .Bd -literal -offset indent The \&.Ql . character. \&.Pp The \&.Ql \e&. character. \&.Pp \&.No test . test \&.Pp \&.No test. test .Ed .Pp . は、 . .Bd -filled -offset indent The .Ql . character. .Pp The .Ql \&. character. .Pp .No test . test .Pp .No test. test .Ed .Pp となります。 .Pp . 1 行目および 3 行目にみられるように、 .Nm \-mdoc はマクロ引数の中では句読点を特別に扱います。 これについては、後述の .Sx 一般的な構文 の節で述べます。 同様の方法で、幅 0 の空白を続けることで、 省略形の後に続いたピリオドを保護しなくてはなりません。 例えば .Ql e.g.\e& のようにします。 .Pp マニュアルページのソースファイル中のコメントは、 独立した行では .Ql .\e" 、何らかの入力があった後では .Ql \e" を、あるいはどのような場所でも使いたい場合は .Ql \e# を使うことができます (後者は .Tn GNU .Xr troff 1 拡張です)。このような行の残りの部分は無視されます。 . . .Sh "マニュアルページのテンプレート" . マニュアルページの中身は次のような基本的なテンプレートから 簡単に作成できます。 . .Bd -literal -offset indent \&.\e" 以下の項目はすべてのマニュアルページで必要な項目です。 \&.Dd 月 日, 年 \&.Os [オペレーティングシステム] [バージョン/リリース] \&.Dt ドキュメントタイトル [セクション番号] [アーキテクチャ/ボリューム] \&.Sh NAME \&.Nm 名称 \&.Nd 名称についての 1 行での説明 \&.\e" 次の項目はセクション 2, 3 でのみ必要なものです。 \&.\e" .Sh LIBRARY \&.Sh SYNOPSIS \&.Sh DESCRIPTION \&.\e" 以下の項目については、必要に応じてコメントをはずして使用してく \&.\e" ださい。 \&.\e" .Sh IMPLEMENTATION NOTES \&.\e" この次の項目はセクション 2, 3, 9 でのみ必要な、関数の \&.\e" 戻り値です。 \&.\e" .Sh RETURN VALUES \&.\e" 次の項目はセクション 1, 6, 7, 8, 9 でのみ必要なものです。 \&.\e" .Sh ENVIRONMENT \&.\e" .Sh FILES \&.\e" .Sh EXAMPLES \&.\e" 次の項目はセクション 1, 6, 7, 8, 9 でのみ必要なものです。 \&.\e" ((シェルへの)コマンドの戻り値と \&.\e" fprintf/stderr タイプの診断です) \&.\e" .Sh DIAGNOSTICS \&.\e" .Sh COMPATIBILITY \&.\e" 次の項目はセクション 2, 3, 9 でのみ必要な、 \&.\e" エラーハンドリングとシグナルハンドリングです。 \&.\e" .Sh ERRORS \&.\e" .Sh SEE ALSO \&.\e" .Sh STANDARDS \&.\e" .Sh HISTORY \&.\e" .Sh AUTHORS \&.\e" .Sh BUGS .Ed .Pp . このテンプレートにおける最初の項目はマクロ .Ql .Dd , .Ql .Os , および .Ql .Dt であり、それぞれドキュメントの日付、 マニュアルページもしくは題材となっているソースの開発や変更の 対象となったオペレーティングシステム、そして マニュアルページのタイトルを属するマニュアルのセクション番号と ともに ( .Em 大文字で ) 指定したもの、となっています。 これらのマクロはそのページを識別するものであり、後述の .Sx タイトルマクロ で解説されます。 .Pp テンプレート中の残りの項目はセクションのヘッダ .Pf ( Li .Sh ) であり、それらのうち .Sx NAME , .Sx SYNOPSIS , および .Sx DESCRIPTION は必須項目です。 これらのヘッダについては .Sx "マニュアル領域" を説明した後、 .Sx "ページ構造領域" で解説されます。 いくつかのコンテントマクロはページレイアウトマクロの説明に 使用されていますので、ページレイアウトマクロの前にコンテントマクロに ついて読むことを推奨します。 . . .Sh 使用法 . 次に説明するマクロはすべて、オプションの引数は 角括弧 ([]) で括られます。 省略符号 .Pf ( Sq ... ) はさらに 0 個以上の引数があることを表しています。 パラメータの代替値は .Ql | で区切って示します。 必須パラメータに代替値がある場合は、 ( .Ql | と一緒に) 中括弧 ({}) を用い、値の組を括ります。 メタ変数は山括弧 (<>) の中で指定されます。 .Pp 例: . .Bl -tag -width 6n -offset indent .It Li .Xx Xo .Aq foo .Brq bar1 | bar2 .Op \-test1 Op \-test2 | \-test3 .No ... .Xc .El . .Pp とくに明示しない限り、すべてのマクロは 構文解析され、呼び出し可能なものです。 .Pp 大部分のマクロはデフォルトの幅の値を持っており、これを .Ql .Bl および .Ql .Bd マクロ用にラベル width .Pf ( Fl width ) あるいは offset .Pf ( Fl offset ) を指定するのに使用することができます。 .Nm \-mdoc パッケージのローカルな変更に依存することのないように、 このとても曖昧な機能は使わないことを推奨します。 . . .Sh "タイトルマクロ" . タイトルマクロはページ構造領域の一部ですが、 マニュアルページを昨日書き始めようと思ったという人のために、 最初に、他のとは別に記述されています。 3 つのヘッダマクロでドキュメントまたはマニュアルページのタイトル、 オペレーティングシステム、および原著の日付を指定します。 これらのマクロはドキュメントの最初で一度だけ呼び出されるもので、 ヘッダとフッタを構成するためだけに使用されます。 . .Bl -tag -width 6n .It Li .Dt Xo .Op Aq ドキュメントタイトル .Op Aq セクション番号 .Op Aq ボリューム .Xc ドキュメントタイトルはマニュアルページの主題であり、 troff の制限により .Tn 大文字 でなければいけません。 省略された場合、 .Sq Tn UNTITLED が使われます。 セクション番号は .No 1,\~ Ns ... Ns ,\~9 の範囲の番号もしくは .Ql unass , .Ql draft , .Ql paper のいずれかを取ることができます。 セクション番号が指定されており、ボリューム名が与えられていない 場合には、デフォルトのボリューム名が使用されます。 . .Pp .Tn \*[operating-system] では、次のセクションが定義されています: .Pp .Bl -column LOCAL -offset indent -compact .It Li 1 Ta "\*[volume-operating-system] \*[volume-ds-1]" .It Li 2 Ta "\*[volume-operating-system] \*[volume-ds-2]" .It Li 3 Ta "\*[volume-operating-system] \*[volume-ds-3]" .It Li 4 Ta "\*[volume-operating-system] \*[volume-ds-4]" .It Li 5 Ta "\*[volume-operating-system] \*[volume-ds-5]" .It Li 6 Ta "\*[volume-operating-system] \*[volume-ds-6]" .It Li 7 Ta "\*[volume-operating-system] \*[volume-ds-7]" .It Li 8 Ta "\*[volume-operating-system] \*[volume-ds-8]" .It Li 9 Ta "\*[volume-operating-system] \*[volume-ds-9]" .El .Pp . ボリューム名は任意であるか、もしくは次のものを 取ることができます: . .Pp .Bl -column LOCAL -offset indent -compact .It Li USD Ta "\*[volume-ds-USD]" .It Li PS1 Ta "\*[volume-ds-PS1]" .It Li AMD Ta "\*[volume-ds-AMD]" .It Li SMM Ta "\*[volume-ds-SMM]" .It Li URM Ta "\*[volume-ds-URM]" .It Li PRM Ta "\*[volume-ds-PRM]" .It Li KM Ta "\*[volume-ds-KM]" .It Li IND Ta "\*[volume-ds-IND]" .It Li LOCAL Ta "\*[volume-ds-LOCAL]" .It Li CON Ta "\*[volume-ds-CON]" .El .Pp . 互換性を保つため、 .Ql IND の代わりに .Ql MMI を使用することができ、 .Ql LOCAL の代わりに .Ql LOC を使用できます。 先の表の値は、新しいボリューム名を指定します。 第 3 パラメータがコンピュータアーキテクチャを表すキーワードで ある場合、その値は第 2 パラメータで指定したボリューム名の 前に追加されます。 デフォルトでは次のアーキテクチャに関するキーワードが定義されています: . \# we use `No' to avoid hyphenation .Bd -ragged -offset indent .No alpha , amiga , arc , arm26 , arm32 , atari , bebox , cobalt , evbsh3 , .No hp300 , hpcmips , i386 , luna68k , m68k , mac68k , macppc , mips , .No mmeye , mvme68k , news68k , newsmips , next68k , ofppc , pc532 , pmax , .No powerpc , prep , sgimips , sh3 , sparc , sparc64 , sun3 , tahoe , vax , .No x68k .Ed .Pp . 次の例では、マニュアルページのヘッダの左側 (これは右側と同じものです) と 中央に書かれる文字列を示しています。 . .Bd -ragged .Bl -tag -width ".Li .Dt\ FOO\ 2\ i386" -compact -offset indent .It Li ".Dt FOO 7" .Ql FOO(7) .Ql \*[volume-operating-system] \*[volume-ds-7] .It Li ".Dt FOO 2 i386" .Ql FOO(2) .Ql \*[volume-operating-system]/\*[volume-as-i386] \*[volume-ds-2] .It Li ".Dt FOO \*[q]\*[q] bar" .Ql FOO .Ql bar .El .Ed .Pp . ローカルな追加項目や OS に特化した追加項目が、ファイル .Pa mdoc.local にあるかもしれません。このファイル中で .Ql volume-ds-XXX (前者のタイプについて) および .Ql volume-as-XXX (後者のタイプについて) という名前の文字列を検索してください。ここで .Ql XXX は .Ql .Dt マクロで使用されるキーワードを表しています。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。 . .It Li .Os Xo .Op Aq オペレーティングシステム .Op Aq リリース番号 .Xc 第 1 パラメータが空の場合、 デフォルト値 .Sq Tn "\*[operating-system]" が使用されます。 これは、ローカルの設定ファイル .Pa mdoc.local で上書きできます。一般的には、 オペレーティングシステムの名称には一般的な頭字語 (略称) を 使わなければなりません。 例えば .Tn BSD や .Tn ATT といったものです。 リリース番号は、各システムでの標準のリリースの命名法を使用します。 次の表では、いくつか事前に定義されているオペレーティングシステムに 対して取り得る第 2 引数をリストしています。 .Ql .Dt と同じように、ローカルな追加項目が .Pa mdoc.local に定義されているかもしれません。このファイル中で .Ql operating-system-XXX-YYY という名前の文字列を検索してください。ここで .Ql XXX はオペレーティングシステムの頭字語 (略称) そして .Ql YYY がリリース ID です。 . .Bd -ragged -compact .Bl -tag -width ".No FreeBSD" -offset indent .It ATT 7th, 7, III, 3, V, V.2, V.3, V.4 .It BSD 3, 4, 4.1, 4.2, 4.3, 4.3t, 4.3T, 4.3r, 4.3R, 4.4 .It NetBSD 0.8, 0.8a, 0.9, 0.9a, 1.0, 1.0a, 1.1, 1.2, 1.2a, 1.2b, 1.2c, 1.2d, 1.2e, 1.3, 1.3a, 1.4, 1.5, 1.6 .It FreeBSD 1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5, 2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0, 4.1, -4.2, 4.3, 4.4, 4.5, 5.0 +4.2, 4.3, 4.4, 4.5, 4.6, 5.0 .El .Ed .Pp . .Tn ATT に関しては、判別できない第 2 パラメータがある時には それを文字列 .Tn UNIX に置き換えます。事前に定義されているその他の頭字語 (略称) に ついては、そのようなパラメータは無視され、警告メッセージが 出力されます。 認識できない引数は、ページフッタ中に記述された通りに 表示されます。例えば、典型的なフッタは次のようになるでしょう: .Pp .Dl .Os BSD 4.3 .Pp は .Ql 4.3\~Berkeley Distribution となります。また、ローカルで作られたセットの例では、 .Pp .Dl .Os CS Department .Pp は .Ql CS\~Department となります。 .Pp .Ql .Os マクロがない場合、ページの左下隅は見苦しくなってしまうでしょう。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。 . .It Li .Dd Oo .Aq 月 .Aq 日 , .Aq 年 .Oc .Ql Dd に引数がない場合は、日付には .Ql "基準時点 (協定世界時 1970年1月1日 00:00:00)" が使用されます。 ちょうど 3 つ引数がある場合には、それらは連結され、 分割できない空白で分けられたものになります。 .Pp .Dl .Dd January 25, 2001 .Pp それ以外の場合は現在の日付が使用され、パラメータは無視されます。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。 .El . . .Sh "マニュアル領域および一般テキスト領域の紹介" . .Ss "この名前には何が" Ns ... . マニュアル領域のマクロ名はコマンドやサブルーチン、それに関連ファイルを 説明するために使われている日常のインフォーマルな言葉から取られています。 この言葉と少し違うバリエーションのものがマニュアルページを書く上での 3 つの異なった側面を記述するのに使われます。 最初のものは、 .Nm \-mdoc マクロ使用方法の説明です。2 番目は .Nm \-mdoc マクロを .Em 用いた .Ux コマンドの記述です。 3 番目はコマンドを通常の言葉の感覚でユーザに示したものです。 これはすなわち、マニュアルページのテキスト中でのコマンドの 説明となります。 .Pp 最初のケースでは、 .Xr troff 1 マクロはそれ自身、一種のコマンドとなっています。 troff コマンドは一般的に以下のような形式をとります。 . .Bd -filled -offset indent .Li ".Xx argument1 argument2" ... .Ed .Pp . .Ql .Xx はマクロコマンドもしくは要求を示しており、それに続くものは すべて処理されるべき引数として処理されます。 2 番目のケースでは、コンテントマクロを使用する .Ux コマンドの記述がもう少し含まれます。 典型的な .Sx SYNOPSIS コマンド行はこのように表示されます。 . .Bd -filled -offset indent .Nm filter .Op Fl flag .Ao Ar infile Ac Ao Ar outfile Ac .Ed .Pp . ここで .Nm filter はコマンド名であり、角括弧で囲まれた文字列 .Fl flag は .Em フラグ 引数で、これは角括弧で囲むことによってオプションであることを 示しています。 .Nm \-mdoc の用語では、 .Ao Ar infile Ac および .Ao Ar outfile Ac は .Em メタ引数 と称されています。 この例では、ユーザは山括弧 (<>) の中で与えられたメタ引数を 実際のファイル名に置き換えなくてはなりません。 このドキュメントでは、メタ引数は .Nm \-mdoc コマンドを記述するのに使用していることに注意してください。 多くのマニュアルページでは、メタ変数はわざわざ山括弧を使って 書かれていません。 上の例を整形したマクロは以下のものです。 . .Bd -literal -offset indent \&.Nm filter \&.Op Fl flag \&.Ao Ar infile Ac Ao Ar outfile Ac .Ed .Pp . 3 番目のケースでは、コマンドの説明や構文に上記の例の両方が使われ、 さらに細かい記述が追加されるでしょう。 上の例での引数 .Ao Ar infile Ac および .Ao Ar outfile Ac は .Em オペランド もしくは .Em ファイル引数 として参照されます。 コマンド行の引数のリストはかなり長くなる場合もあります。 . .Bd -ragged .Bl -tag -width ".Nm make" -offset indent -compact .It Nm make .Op Fl eiknqrstv .Op Fl D Ar variable .Op Fl d Ar flags .Op Fl f Ar makefile .Op Fl I Ar directory .Op Fl j Ar max_jobs .Op Ar variable Ns = Ns Ar value .Bk .Op Ar target ... .Ek .El .Ed .Pp . ここではコマンド .Nm make について記述しており、 .Ar makefile をフラグ .Fl f の引数としています。 またオプションのファイルオペランドである .Ar target についても言及しています。 言葉での説明では、こういった詳細な記述が混乱を防いでくれますが、 .Nm \-mdoc パッケージにはフラグ .Em への 引数のためのマクロがありません。 その代わりに .Ar target のようなオペランドやファイル引数に使われる引数マクロ .Ql \&Ar が .Ar variable のようなフラグへの引数と同様に使われます。 この make コマンド行は次の指定により生成されています。 . .Bd -literal -offset indent \&.Nm make \&.Op Fl eiknqrstv \&.Op Fl D Ar variable \&.Op Fl d Ar flags \&.Op Fl f Ar makefile \&.Op Fl I Ar directory \&.Op Fl j Ar max_jobs \&.Op Ar variable Ns = Ns Ar value \&.Bk \&.Op Ar target ... \&.Ek .Ed .Pp . マクロ .Ql .Bk および .Ql .Ek は .Sx キープ セクションにおいて解説されています。 . .Ss "一般的な構文" . マニュアル領域のマクロと一般テキスト領域のマクロとはいくつか 小さな違いがあるものの、同様な構文を使用しています。とりわけ、 .Ql .Ar , .Ql .Fl , .Ql .Nm , および .Ql .Pa は引数なしで呼び出された時の違いしかありません。また、 .Ql .Fn および .Ql .Xr は引数のリストの順番が異なります。 すべてのコンテントマクロが句読点を認識し、それを正しく扱うには、 各々の句読点文字が先行する空白で分離されている必要があります。 次のように指定されている場合、 .Pp .Dl \&.Ar sptr, ptr), .Pp その結果は以下のようになります。 .Pp .Dl Ar sptr, ptr), .Pp ここでは句読点は認識されず、すべての出力は .Ql .Ar で使用されるフォントで行われています。 句読点が空白文字で区切られている場合、 .Pp .Dl \&.Ar "sptr , ptr ) ," .Pp 結果は以下のようになります。 .Pp .Dl Ar sptr , ptr ) , .Pp 今度は句読点が認識され、出力はデフォルトのフォントで行われ 引数文字列とは区別されています。 句読点文字の特別な意味を取り除くには、 .Ql \e& でエスケープしてください。 .Pp .Xr troff はマクロ言語としての限界から、以下のような、数学、論理学、引用符の 集合のメンバを含んだ文字列を表現するのは困難です。 . .Bd -literal -offset indent-two {+,\-,/,*,%,<,>,<=,>=,=,==,&,`,',"} .Ed .Pp . 問題なのは、文字によって示唆されている操作もしくは評価が、 実行されるべきであると .Xr troff が仮定する場合があることです。 これらの文字が予期しない形で評価されないようにするには、 .Ql \e& でこれらをエスケープしてください。 最初のコンテントマクロは、以下の .Ql .Ad において、その典型的な構文が示されています。 . . .Sh "マニュアル領域" . .Ss "アドレス" . アドレスマクロはアドレスの構成を識別します。 .Pp .Dl 使い方: .Ad Ao アドレス Ac ... .Pp .Bl -tag -width ".Li .Ad\ f1\ ,\ f2\ ,\ f3\ :" -compact -offset 15n .It Li ".Ad addr1" .Ad addr1 .It Li ".Ad addr1 ." .Ad addr1 . .It Li ".Ad addr1 , file2" .Ad addr1 , file2 .It Li ".Ad f1 , f2 , f3 :" .Ad f1 , f2 , f3 : .It Li ".Ad addr ) ) ," .Ad addr ) ) , .El .Pp . デフォルトの文字幅は 12n です。 . .Ss "作者名" . .Ql .An マクロは文書化されている項目の作者の名前、もしくは実際の マニュアルページの作者の名前を指定するために使われます。 .Pp .Dl 使い方: .An Ao 作者名 Ac ... .Pp .Bl -tag -width ".Li .An\ \*[q]Joe\ Author\*[q]\ )\ )\ ," -offset 15n .It Li ".An \*[q]Joe Author\*[q]" .An "Joe Author" .It Li ".An \*[q]Joe Author\*[q] ," .An "Joe Author" , .It Li ".An \*[q]Joe Author\*[q] Aq nobody@FreeBSD.org" .An "Joe Author" Aq nobody@FreeBSD.org .It Li ".An \*[q]Joe Author\*[q] ) ) ," .An "Joe Author" ) ) , .El .Pp . デフォルトの文字幅は 12n です。 .Pp .Sx AUTHORS セクションでは、 .Ql .An リクエストは改行を引き起こし、新しい名前がそれぞれの行に表示されます。 この動作が望ましくない場合、 . .Bd -literal -offset indent \&.An -nosplit .Ed .Pp . を呼び出すことで無効にできます。 それぞれの行に表示させる動作に戻したい場合は、 . .Bd -literal -offset indent \&.An -split .Ed .Pp . と記述します。 . .Ss "引数" . 引数マクロ .Li .Ar はコマンド行の引数を参照する際にはいつでも使用することができます。 引数なしで呼ばれた場合、 .Sq Ar が出力になります。 .Pp .Dl 使い方: .Ar Oo Ao 引数 Ac Oc ... .Pp .Bl -tag -width ".Li .Ar\ file1\ file2" -compact -offset 15n .It Li .Ar .Ar .It Li ".Ar file1" .Ar file1 .It Li ".Ar file1 ." .Ar file1 . .It Li ".Ar file1 file2" .Ar file1 file2 .It Li ".Ar f1 f2 f3 :" .Ar f1 f2 f3 : .It Li ".Ar file ) ) ," .Ar file ) ) , .El .Pp . デフォルト幅は 12n です。 . .Ss "コンフィギュレーション宣言 (セクション 4 のみ)" . .Ql .Cd マクロはセクション 4 のマニュアルにおいて、デバイスインタフェースの .Xr config 8 による宣言の説明に使われます。 .Pp .Dl 使い方: .Cd Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Cd\ Xdevice\ le0\ at\ scode?X" -offset 15n .It Li ".Cd \*[q]device le0 at scode?\*[q]" .Cd "device le0 at scode?" .El .Pp .Sx SYNOPSIS セクションでは .Ql .Cd リクエストはその引数が表示される前後で改行を入れます。 .Pp . デフォルト幅は 12n です。 . .Ss "コマンド修飾子" . コマンド修飾子は .Ql .Cm マクロがすべての引数の前にダッシュ文字を付けないことを除いて、 .Ql .Fl (フラグ) コマンドと同じです。 伝統的にフラグはダッシュ文字に引き続いて指定されますが、 この方法を使わないコマンドやコマンドのサブセットもあります。 コマンド修飾子はエディタコマンドのような対話的なコマンドでも 指定されることがあります。 .Sx フラグ セクションを参照してください。 .Pp デフォルト幅は 10n です。 . .Ss "定義済みの変数" . インクルードファイルにおいて定義されている変数 (もしくは定数) は マクロ .Ql .Dv によって指定します。 .Pp .Dl 使い方: .Dv Ao 定義済みの変数 Ac ... .Pp .Bl -tag -width ".Li .Dv\ MAXHOSTNAMELEN" -compact -offset 15n .It Li ".Dv MAXHOSTNAMELEN" .Dv MAXHOSTNAMELEN .It Li ".Dv TIOCGPGRP )" .Dv TIOCGPGRP ) .El .Pp . デフォルト幅は 12n です。 . .Ss errno . .Ql .Er errno マクロは、セクション 2, 3, 9 のライブラリルーチンにおける エラーの戻り値を指定します。 下記の 2 番目の例では .Ql .Er は一般テキスト領域マクロである .Ql .Bq (これはセクション 2 のマニュアルページで使われています) と共に 使われています。 .Pp .Dl 使い方: .Er Ao errno のタイプ Ac ... .Pp .Bl -tag -width ".Li .Bq\ Er\ ENOTDIR" -compact -offset 15n .It Li ".Er ENOENT" .Er ENOENT .It Li ".Er ENOENT ) ;" .Er ENOENT ) ; .It Li ".Bq Er ENOTDIR" .Bq Er ENOTDIR .El .Pp . デフォルト幅は 17n です。 . .Ss "環境変数" . .Ql .Ev マクロは環境変数を指定します。 .Pp .Dl 使い方: .Ev Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Ev\ PRINTER\ )\ )\ ," -compact -offset 15n .It Li ".Ev DISPLAY" .Ev DISPLAY .It Li ".Ev PATH ." .Ev PATH . .It Li ".Ev PRINTER ) ) ," .Ev PRINTER ) ) , .El .Pp . デフォルト幅は 15n です。 . .Ss "フラグ" . .Ql .Fl マクロはコマンド行のフラグを扱います。 フラグの前にはダッシュ .Ql \- が挿入されます。 ダッシュがつかない対話的なコマンドのために .Ql .Cm (コマンド修飾子) マクロが用意されています。 これはダッシュを付けないことを除いて同じ働きをします。 .Pp .Dl 使い方: .Fl Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Fl\ xyz\ )\ ," -compact -offset 15n .It Li .Fl .Fl .It Li ".Fl cfv" .Fl cfv .It Li ".Fl cfv ." .Fl cfv . .It Li ".Cm cfv ." .Cm cfv . .It Li ".Fl s v t" .Fl s v t .It Li ".Fl \- ," .Fl \- , .It Li ".Fl xyz ) ," .Fl xyz ) , .It Li ".Fl |" .Fl | .El .Pp 引数なしで .Ql .Fl マクロを指定すると、標準入力/標準出力を意味するダッシュとなります。 .Ql .Fl マクロにダッシュを 1 つ与えると、2 つのダッシュとなることに 注意して下さい。 .Pp デフォルト幅は 12n です。 . .Ss "関数の宣言" . .Ql .Fd マクロは .Sx SYNOPSIS セクションにおいて、セクション 2 または 3 の関数の説明で使われます。 このマクロは呼び出し不可能であり、構文解析もされせん。 .Pp .Dl 使い方: .Fd Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Fd\ X#include\ X" -compact -offset 15n .It Li ".Fd \*[q]#include \*[q]" .Fd "#include " .El .Pp .Sx SYNOPSIS セクションでは、 関数がすでに示されており、改行がまだされていない場合には .Ql .Fd リクエストは改行を入れます。 これによって前の関数呼び出しと次の関数の宣言の間に 最適な行間が設定されます。 . .Pp .Ql .In .Li ( #include 文) マクロは、以上の例を短く記述したものです。 このマクロは C プログラム中でインクルードされる C ヘッダファイルを指定します。 このマクロも改行を挿入し、 呼び出し不可能であり、構文解析されることもありません。 .Pp .Dl 使い方: .In Ao ヘッダファイル Ac .Pp .Bl -tag -width ".Li .In\ stdio.h" -compact -offset 15n .It Li ".In stdio.h" .In stdio.h .El . .Ss "関数の型" . このマクロは .Sx SYNOPSIS セクションで使うものです。 マニュアルページ中の他の場所でも問題なく使うことができますが、 セクション 2 と 3 の .Sx SYNOPSIS セクションにおいてカーネルの通常の形式で関数の型を示すことが このマクロの目的です (このマクロは関数名が次の行に置かれるように改行を挿入します)。 .Pp .Dl 使い方: .Ft Ao 型 Ac ... .Pp .Bl -tag -width ".Li .Ft\ struct\ stat" -compact -offset 15n .It Li ".Ft struct stat" .Ft struct stat .El . .Ss "関数 (ライブラリルーチン)" . .Ql .Fn マクロは .Tn ANSI\~C の記法を規範としています。 .Pp .Dl 使い方: .Fn Ao 関数 Ac Oo Ao パラメータ Ac Oc ... .Pp .Bl -tag -width ".Li .Fn\ align\ Xchar\ *ptrX\ ," -compact -offset 15n .It Li ".Fn getchar" .Fn getchar .It Li ".Fn strlen ) ," .Fn strlen ) , .It Li ".Fn align \*[q]char *ptr\*[q] ," .Fn align "char *ptr" , .El .Pp 他のマクロを呼び出すと .Ql .Fn 呼び出しの終了を意味することに注意してください (閉じ括弧がその箇所に挿入されます)。 .Pp 多くのパラメータをとる関数 (これは滅多にないことですが) では、 .Ql .Fo マクロ (関数マクロの開始) と .Ql .Fc マクロ (関数マクロの終了) を .Ql .Fa (関数の引数) と共に使って、この制限を回避することができます。 .Pp 使用例: . .Bd -literal -offset indent \&.Ft int \&.Fo res_mkquery \&.Fa "int op" \&.Fa "char *dname" \&.Fa "int class" \&.Fa "int type" \&.Fa "char *data" \&.Fa "int datalen" \&.Fa "struct rrec *newrr" \&.Fa "char *buf" \&.Fa "int buflen" \&.Fc .Ed .Pp . 生成結果: . .Bd -ragged -offset indent .Ft int .Fo res_mkquery .Fa "int op" .Fa "char *dname" .Fa "int class" .Fa "int type" .Fa "char *data" .Fa "int datalen" .Fa "struct rrec *newrr" .Fa "char *buf" .Fa "int buflen" .Fc .Ed .Pp . .Sx SYNOPSIS セクションでは、関数は常に行の先頭から開始されます。 .Sx SYNOPSIS セクションにおいて複数の関数が示されており、関数の型が 示されない場合、改行が挿入され、現在の関数名とその前の 関数名の間に最適な改行量が設定されます。 .Pp .Ql .Fn および .Ql .Fo のデフォルト幅の値はそれぞれ 12n と 16n です。 . .Ss "関数の引数" . .Ql .Fa マクロは関数の引数 (パラメータ) を マニュアルの .Sx SYNOPSIS のセクション外で参照する場合、あるいは .Ql .Fn の代わりに .Ql .Fo および .Ql .Fc 囲いマクロを使用した場合には .Sx SYNOPSIS のセクション内で参照する場合にも使われます。 .Ql .Fa は構造体のメンバを参照する場合にも使われます。 .Pp .Dl 使い方: .Fa Ao 関数の引数 Ac ... .Pp .Bl -tag -width ".Li .Fa\ d_namlen\ )\ )\ ," -compact -offset 15n .It Li ".Fa d_namlen ) ) ," .Fa d_namlen ) ) , .It Li ".Fa iov_len" .Fa iov_len .El .Pp . デフォルト幅は 12n です。 . .Ss "戻り値" . .Ql .Rv マクロは .Sx RETURN VALUES のセクションで使うテキストを生成します。 .Pp .Dl 使い方: .Rv Oo -std Oc Op Ao 関数 Ac ... .Pp 例えば、 .Ql ".Rv -std atexit" は次のテキストを生成します。 . .Bd -ragged -offset -indent \# a small hack to suppress a warning message .ds section-old "\*[section] .ds section 3 .\" following part came from doc.tmac workaround the effect of .\" -dlang=ja_JP.eucJP .ds str-Rv-std-prefix "The .ds str-Rv-std-suffix "function returns the value\~0 if successful; .as str-Rv-std-suffix " otherwise the value\~-1 is returned and .as str-Rv-std-suffix " the global variable \*[Va-font]errno\f[P] .as str-Rv-std-suffix " is set to indicate the error. .ds str-Rv-stds-prefix "The .ds str-Rv-stds-and "and .ds str-Rv-stds-suffix "functions return the value\~0 if successful; .as str-Rv-stds-suffix " otherwise the value\~-1 is returned and .as str-Rv-stds-suffix " the global variable \*[Va-font]errno\f[P] .as str-Rv-stds-suffix " is set to indicate the error. .ds str-Rv-std0 "Upon successful completion, the value\~0 is returned; .as str-Rv-std0 " otherwise the value\~-1 is returned and .as str-Rv-std0 " the global variable \*[Va-font]errno\f[P] .as str-Rv-std0 " is set to indicate the error. .Rv -std atexit .ds section "\*[section-old] .Ed .Pp . .Fl std オプションはセクション 2 と 3 のマニュアルページでのみ有効です。 現在のところ、このマクロは .Fl std フラグなしで使用しても何も起こりません。 . .Ss "終了ステータス" . .Ql .Ex マクロは .Sx DIAGNOSTICS のセクションで使うテキストを生成します。 .Pp .Dl 使い方: .Ex Oo -std Oc Op Ao ユーティリティ Ac ... .Pp 例えば .Ql ".Ex -std cat" は次のテキストを生成します。 . .Bd -ragged -offset -indent \# a small hack to suppress a warning message .ds section-old "\*[section] .ds section 1 .\" following part came from doc.tmac workaround the effect of .\" -dlang=ja_JP.eucJP .ds str-Ex-std-prefix "The .ds str-Ex-std-suffix "utility exits\~0 on success, .as str-Ex-std-suffix " and\~>0 if an error occurs. .ds str-Ex-stds-prefix "The .als str-Ex-stds-and str-Rv-stds-and .ds str-Ex-stds-suffix "utilities exit\~0 on success, .as str-Ex-stds-suffix " and\~>0 if an error occurs. .Ex -std cat .ds section "\*[section-old] .Ed .Pp . .Fl std オプションはセクション 1 と 6 と 8 のマニュアルページでのみ有効です。 現在のところ、このマクロは .Fl std フラグなしで使用しても何も起こりません。 . .Ss "対話的なコマンド" . .Ql .Ic マクロは対話的なコマンド、もしくは内部コマンドを指定します。 .Pp .Dl 使い方: .Ic Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Ic\ setenv\ ,\ unsetenv" -compact -offset 15n .It Li ".Ic :wq" .Ic :wq .It Li ".Ic \*[q]do while {...}\*[q]" .Ic "do while {...}" .It Li ".Ic setenv , unsetenv" .Ic setenv , unsetenv .El .Pp . デフォルト幅は 12n です。 . .Ss "ライブラリ名" . .Ql .Lb マクロは、関数がどのライブラリに組み込まれるかを指定します。 .Pp .Dl 使い方: .Lb Ao 引数 Ac ... .Pp .Ql .Lb マクロに対して使用可能な引数と結果は次の通りです: . .Pp .Bl -tag -width ".Li libossaudio" -compact -offset indent .It Li libarm32 .Lb libarm32 .It Li libc .Lb libc .It Li libcompat .Lb libcompat .It Li libcrypt .Lb libcrypt .It Li libcurses .Lb libcurses .It Li libedit .Lb libedit .It Li libi386 .Lb libi386 .It Li libipsec .Lb libipsec .It Li libkvm .Lb libkvm .It Li libm .Lb libm .It Li libmenu .Lb libmenu .It Li libossaudio .Lb libossaudio .It Li libposix .Lb libposix .It Li libresolv .Lb libresolv .It Li libtermcap .Lb libtermcap .It Li libutil .Lb libutil .It Li libz .Lb libz .El .Pp . ローカルな追加項目や OS 特有の追加項目が、ファイル .Pa mdoc.local にあるかもしれません。 .Ql str-Lb-XXX という名前の文字列を検索してください。ここで .Ql XXX は .Ql .Lb マクロとともに使用されるキーワードを示しています。 . .Ss リテラル . リテラルマクロ .Ql .Li は特殊文字や変数定数、その他タイプされた通りに表示する必要があるものに 使用することができます。 .Pp .Dl 使い方: .Li Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Li\ cntrl-D\ )\ ," -compact -offset 15n .It Li ".Li \een" .Li \en .It Li ".Li M1 M2 M3 ;" .Li M1 M2 M3 ; .It Li ".Li cntrl-D ) ," .Li cntrl-D ) , .It Li ".Li 1024 ..." .Li 1024 ... .El .Pp . デフォルト幅は 16n です。 . .Ss 名称 . .Ql .Nm マクロは文書のタイトルやサブジェクト名を指定するために使われます。 このマクロは呼び出された時の第 1 引数を覚えておくという 変わった特性を持っており、 それは常にそのページのサブジェクト名であるべきです。 引数なしで呼び出されると .Ql .Nm は作者のために最低限の仕事をするという意味で、 この初期化された名称を出力します。 注: セクション 2 または 3 のドキュメントの関数名は .Sx NAME セクションにおいて .Ql .Nm で指定され、 .Sx SYNOPSIS セクションや残りのセクションでは .Ql .Fn で指定されます。 .Xr csh 1 での .Ql while コマンドのキーワードのような対話的なコマンドでは .Ql .Ic マクロを使う必要があります。 .Ql .Ic はほとんど .Ql .Nm と同一ですが、 それが使われたときの第 1 引数を記憶することはできません。 .Pp .Dl 使い方: .Nm Oo Ao 引数 Ac Oc ... .Pp .Bl -tag -width ".Li .Nm\ groff_mdoc" -compact -offset 15n .It Li ".Nm groff_mdoc" .Nm groff_mdoc .It Li ".Nm \e-mdoc" .Nm \-mdoc .It Li ".Nm foo ) ) ," .Nm foo ) ) , .It Li ".Nm :" .Nm : .El .Pp . デフォルト幅は 10n です。 . .Ss オプション . .Ql .Op マクロはコマンド行の残りのすべての引数を オプションであることを示す角括弧で囲み、 末尾の句読点は角括弧の外に置きます。 .Ql .Oo マクロと .Ql .Oc マクロ (それぞれ開き角括弧と閉じ角括弧を生成します) は 複数行に渡って使うことができ、また閉じ括弧の正確な位置を 指定するのに使うことができます。 .Pp .Dl 使い方: .Op Oo Ao オプション Ac Oc ... .Pp .Bl -tag -width ".Li .Op\ Fl\ c\ Ar\ objfil\ Op\ Ar\ corfil\ ," -compact -offset 15n .It Li .Op .Op .It Li ".Op Fl k" .Op Fl k .It Li ".Op Fl k ) ." .Op Fl k ) . .It Li ".Op Fl k Ar kookfile" .Op Fl k Ar kookfile .It Li ".Op Fl k Ar kookfile ," .Op Fl k Ar kookfile , .It Li ".Op Ar objfil Op Ar corfil" .Op Ar objfil Op Ar corfil .It Li ".Op Fl c Ar objfil Op Ar corfil ," .Op Fl c Ar objfil Op Ar corfil , .It Li ".Op word1 word2" .Op word1 word2 .It Li ".Li .Op Oo Ao option Ac Oc ..." .Li .Op Oo Ao options Ac Oc ... .El .Pp これは、 .Ql .Oo マクロと .Ql .Oc マクロを使った典型的な例です: . .Bd -literal -offset indent \&.Oo \&.Op Fl k Ar kilobytes \&.Op Fl i Ar interval \&.Op Fl c Ar count \&.Oc .Ed .Pp . 出力結果: . .Bd -filled -offset indent .Oo .Op Fl k Ar kilobytes .Op Fl i Ar interval .Op Fl c Ar count .Oc .Ed .Pp . .Ql .Op マクロおよび .Ql .Oo マクロのデフォルト幅はそれぞれ 14n と 10n です。 . .Ss パス名 . .Ql .Pa マクロはパス名もしくはファイル名を整形します。 引数なしで呼ばれた場合、 .Sq Pa 文字列が出力となり、これは現在のユーザのホームディレクトリを 表しています。 .Pp .Dl 使い方: .Pa Oo Ao パス名 Ac Oc ... .Pp .Bl -tag -width ".Li .Pa\ /tmp/fooXXXXX\ )\ ." -compact -offset 15n .It Li .Pa .Pa .It Li ".Pa /usr/share" .Pa /usr/share .It Li ".Pa /tmp/fooXXXXX ) ." .Pa /tmp/fooXXXXX ) . .El .Pp . デフォルト幅は 32n です。 . .Ss 規格 . .Ql .St マクロは、規格の短縮名称を正式名称に置換します。 .Pp .Dl 使い方: .St Ao 短縮名称 Ac ... .Pp 使用可能な .Dq 短縮名称/正式名称 の組は次の通りです: . .Pp .Tn ANSI/ISO C .Pp .Bl -tag -width ".Li -iso9945-1-90" -compact -offset indent .It Li -ansiC .St -ansiC .It Li -ansiC-89 .St -ansiC-89 .It Li -isoC .St -isoC .It Li -isoC-99 .St -isoC-99 .El .Pp . .Tn POSIX パート 1: System API .Pp .Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent .It Li -iso9945-1-90 .St -iso9945-1-90 .It Li -iso9945-1-96 .St -iso9945-1-96 .It Li -p1003.1 .St -p1003.1 .It Li -p1003.1-88 .St -p1003.1-88 .It Li -p1003.1-90 .St -p1003.1-90 .It Li -p1003.1-96 .St -p1003.1-96 .It Li -p1003.1b-93 .St -p1003.1b-93 .It Li -p1003.1c-95 .St -p1003.1c-95 .It Li -p1003.1g-2000 .St -p1003.1g-2000 .It Li -p1003.1i-95 .St -p1003.1i-95 .El .Pp . .Tn POSIX パート 2: シェルとユーティリティ .Pp .Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent .It Li -iso9945-2-93 .St -iso9945-2-93 .It Li -p1003.2 .St -p1003.2 .It Li -p1003.2-92 .St -p1003.2-92 .It Li -p1003.2a-92 .St -p1003.2a-92 .El .Pp . X/Open .Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent .Pp .It Li -susv2 .St -susv2 .It Li -svid4 .St -svid4 .It Li -xbd5 .St -xbd5 .It Li -xcu5 .St -xcu5 .It Li -xcurses4.2 .St -xcurses4.2 .It Li -xns5 .St -xns5 .It Li -xns5.2 .St -xns5.2 .It Li -xpg3 .St -xpg3 .It Li -xpg4 .St -xpg4 .It Li -xpg4.2 .St -xpg4.2 .It Li -xsh5 .St -xsh5 .El .Pp . その他 .Pp .Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent .It Li -ieee754 .St -ieee754 .It Li -iso8802-3 .St -iso8802-3 .El . .Ss "変数の型" . .Ql .Vt マクロは型を参照するときにはいつでも使用することができます。 .Sx SYNOPSIS セクションでは改行が挿入されます (古いスタイルの変数宣言では便利です)。 .Pp .Dl 使い方: .Vt Ao 型 Ac ... .Pp .Bl -tag -width ".Li .Vt\ extern\ char\ *optarg\ ;" -compact -offset 15n .It Li ".Vt extern char *optarg ;" .Vt extern char *optarg ; .It Li ".Vt FILE *" .Vt FILE * .El . .Ss 変数 . 一般的な変数への参照です。 .Pp .Dl 使い方: .Va Ao 変数 Ac ... .Pp .Bl -tag -width ".Li .Va\ Xchar\ sX\ ]\ )\ )\ ," -compact -offset 15n .It Li ".Va count" .Va count .It Li ".Va settimer ," .Va settimer , .It Li ".Va \*[q]int *prt\*[q] ) :" .Va "int *prt" ) : .It Li ".Va \*[q]char s\*[q] ] ) ) ," .Va "char s" ] ) ) , .El .Pp . デフォルト幅は 12n です。 . .Ss "マニュアルページのクロスリファレンス" . .Ql .Xr マクロは最初の引数にマニュアルページの名称をとります。 オプションである第 2 引数は、文字列 (マニュアルセクションを定義します) であれば 括弧で囲われます。 .Pp .Dl 使い方: .Xr Ao マニュアルページの名称 Ac Oo Ao セクション Ac Oc ... .Pp .Bl -tag -width ".Li .Xr\ xinit\ 1x\ ;" -compact -offset 15n .It Li ".Xr mdoc" .Xr mdoc .It Li ".Xr mdoc ," .Xr mdoc , .It Li ".Xr mdoc 7" .Xr mdoc 7 .It Li ".Xr xinit 1x ;" .Xr xinit 1x ; .El .Pp . デフォルト幅は 10n です。 . . .Sh "一般テキスト領域" . .Ss "AT&T マクロ" . .Pp .Dl 使い方: .At Oo Ao バージョン Ac Oc ... .Pp .Bl -tag -width ".Li .At\ v6\ ." -compact -offset 15n .It Li .At .At .It Li ".At v6 ." .At v6 . .El .Pp .Ao バージョン Ac には次の値をとることができます: .Pp .Dl 32v, v1, v2, v3, v4, v5, v6, v7, V, V.1, V.2, V.3, V.4 . .Ss "BSD マクロ" . .Pp .Dl "使い方: .Bx" Bro -alpha | -beta | -devel Brc ... .Dl " .Bx" Oo Ao バージョン Ac Oo Ao リリース Ac Oc Oc ... .Pp .Bl -tag -width ".Li .Bx\ -devel" -compact -offset 15n .It Li .Bx .Bx .It Li ".Bx 4.3 ." .Bx 4.3 . .It Li ".Bx \-devel" .Bx -devel .El .Pp .Ao バージョン Ac が文字列 .Sq Bx の前につきます。 .Ao リリース Ac には次の値をとることができます: .Pp .Dl Reno, reno, Tahoe, tahoe, Lite, lite, Lite2, lite2 . .Ss "NetBSD マクロ" . .Pp .Dl 使い方: .Nx Oo Ao バージョン Ac Oc ... .Pp .Bl -tag -width ".Li .Nx\ 1.4\ ." -compact -offset 15n .It Li .Nx .Nx .It Li ".Nx 1.4 ." .Nx 1.4 . .El .Pp .Ao バージョン Ac にとり得る値については前述の .Sx "タイトルマクロ" セクションの .Ql .Os リクエストの説明を参照してください。 . .Ss "FreeBSD マクロ" . .Pp .Dl 使い方: .Fx Oo Ao バージョン Ac Oc ... .Pp .Bl -tag -width ".Li .Fx\ 2.2\ ." -compact -offset 15n .It Li .Fx .Fx .It Li ".Fx 2.2 ." .Fx 2.2 . .El .Pp .Ao バージョン Ac にとり得る値については前述の .Sx "タイトルマクロ" セクションの .Ql .Os リクエストの説明を参照してください。 . .Ss "OpenBSD マクロ" . .Pp .Dl 使い方: .Ox Oo Ao バージョン Ac Oc ... .Pp .Bl -tag -width ".Li .Ox\ 1.0" -compact -offset 15n .It Li ".Ox 1.0" .Ox 1.0 .El . .Ss "BSD/OS マクロ" . .Pp .Dl 使い方: .Bsx Oo Ao バージョン Ac Oc ... .Pp .Bl -tag -width ".Li .Bsx\ 1.0" -compact -offset 15n .It Li ".Bsx 1.0" .Bsx 1.0 .El . .Ss "UNIX マクロ" . .Pp .Dl 使い方: .Ux ... .Pp .Bl -tag -width ".Li .Ux" -compact -offset 15n .It Li .Ux .Ux .El . .Ss "強調マクロ" . テキストは .Ql .Em マクロを用いて強調することができます。 通常強調に用いられるフォントはイタリック体です。 .Pp .Dl 使い方: .Em Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .Em\ vide\ infra\ )\ )\ ," -compact -offset 15n .It Li ".Em does not" .Em does not .It Li ".Em exceed 1024 ." .Em exceed 1024 . .It Li ".Em vide infra ) ) ," .Em vide infra ) ) , .El .Pp . デフォルト幅は 10n です。 . .Ss "フォントモード" . .Ql .Bf フォントモードは .Ql .Ef マクロで終了しなくてはなりません (後者のマクロは引数をとりません)。 フォントモードは別のフォントモード内に入れ子にできます。 .Pp .Ql .Bf は次の文法をもっています: .Pp .Dl .Bf Ao フォントモード Ac .Pp .Ao フォントモード Ac は次の 3 種類のうちのいずれかでなくてはなりません。 .Pp .Bl -tag -width ".Sy \&Sy | Fl symbolic" -compact -offset indent .It Sy \&Em | Fl emphasis .Ql .Em マクロがテキストのブロック全体に対して使用された場合と 同じになります。 .It Sy \&Li | Fl literal .Ql .Li マクロがテキストのブロック全体に対して使用された場合と 同じになります。 .It Sy \&Sy | Fl symbolic .Ql .Sy マクロがテキストのブロック全体に対して使用された場合と 同じになります。 .El .Pp いずれのマクロも呼び出し不可能であり、構文解析もされません。 . .Ss "囲い/クォートマクロ" . 囲いの概念はクォートと似たものです。 1 つ以上の文字列が引用符や括弧のような文字のペアで囲まれている オブジェクトを指します。 クォートと囲いという用語はこの文書を通して同じ意味で使われます。 ほとんどの 1 行の囲いマクロはクォートであることをほのめかすために、 小文字の .Ql q で終了しますが、例外もいくつかあります。 各々の囲いマクロに対し、開始マクロと終了マクロのペアもあり、 それぞれ小文字の .Ql o と .Ql c で終了します。 .Pp \# XXX .if t \ . ne 10 . .Bd -filled -offset 4n .Bl -column "クォート" "終了" "開始" "クォートされたリテラル" "`string' もしくは string" .Em クォート Ta Em 開始 Ta Em 終了 Ta Em 機能 Ta Em 結果 .No .Aq Ta .Ao Ta .Ac Ta "山括弧による囲い" Ta Ao string Ac .No .Bq Ta .Bo Ta .Bc Ta "角括弧による囲い" Ta Bo string Bc .No .Brq Ta .Bro Ta .Brc Ta "中括弧による囲い" Ta Bro string Brc .No .Dq Ta .Do Ta .Dc Ta "2 重引用符" Ta Do string Dc .No .Eq Ta .Eo Ta .Ec Ta "囲い文字列 (XX による)" Ta XXstringXX .No .Pq Ta .Po Ta .Pc Ta "括弧による囲い" Ta Po string Pc .No .Ql Ta Ta Ta "クォートされたリテラル" Ta So string Sc もしくは Li string .No .Qq Ta .Qo Ta .Qc Ta "まっすぐな 2 重引用符" Ta Qo string Qc .No .Sq Ta .So Ta .Sc Ta "1 重引用符" Ta So string Sc .El .Ed .Pp .Sq q および .Sq o で終わるマクロはすべてデフォルト幅が 12n です。 . .Bl -tag -width ".Li .Ec , .Eo" .It Li .Eo , .Ec これらのマクロはそれぞれ第 1 引数に囲い始めに使う文字列と 囲い終わりに使う文字列をとります。 .It Li .Es , .En オリジナルの troff プログラムでは、引数の数が 9 つまでという 制限がありましたので、(Eo, Ec とは) 別の 2 つのマクロが 実装されています。現在は非推奨になっています。 .Ql .Es は第 1 引数と第 2 引数に左囲い文字列および右囲い文字列を とります。この文字列は、 .Ql .En の引数を囲うのに使用されます。 デフォルト幅は、どちらのマクロも 12n です。 .It Li .Eq このマクロの第 1、第 2 引数はそれぞれ囲い始めに使う文字列と 囲い終わりに使う文字列であり、この文字列の後に 囲われる引数が続きます。 .It Li .Ql クォートされたリテラルマクロは troff モードと nroff モードで 違った挙動をします。 .Xr nroff で整形された場合、 クォートされたリテラルは常にクォートされます。 troff で整形された場合、その要素の幅が固定幅文字 3 文字分の幅よりも 小さいときのみクォートされます。 これにより、リテラル (固定幅) フォントへフォントを変更すると 目立たなくなってしまうような短い文字列がより見やすくなります。 .Pp デフォルト幅は 16n です。 .It Li .Pf プレフィックスマクロは第 1 引数と第 2 引数の間の ホワイトスペースをなくします: . .Bl -tag -width ".Li .Pf\ (\ Fa\ name2" -offset indent .It Li ".Pf ( Fa name2" .Pf ( Fa name2 .El .Pp . デフォルト幅は 12n です。 .Pp .Ql .Ns マクロ (後述参照) は同じようにサフィックスに働きます。 .It Li .Ap .Ql .Ap マクロはアポストロフィを追加し、特別なテキストモードから 抜けます。そして .Ql .No モードで続けます。 .El .Pp . クォートの例: . .Pp .Bl -tag -width ".Li .Bq\ Em\ Greek\ ,\ French\ ." -compact -offset indent .It Li .Aq .Aq .It Li ".Aq Pa ctype.h ) ," .Aq Pa ctype.h ) , .It Li .Bq .Bq .It Li ".Bq Em Greek , French ." .Bq Em Greek , French . .It Li .Dq .Dq .It Li ".Dq string abc ." .Dq string abc . .It Li ".Dq \'^[A-Z]\'" .Dq \'^[A-Z]\' .It Li ".Ql man mdoc" .Ql man mdoc .It Li .Qq .Qq .It Li ".Qq string ) ," .Qq string ) , .It Li ".Qq string Ns )," .Qq string Ns ), .It Li .Sq .Sq .It Li ".Sq string" .Sq string .It Li ".Em or Ap ing" .Em or Ap ing .El .Pp . 囲いマクロの入れ子についての良い例については、 オプションマクロ .Ql .Op を参照してください。 このマクロは上でリストされているような囲いマクロと同じベースの上に 作られています。 .Ql .Xo と .Ql .Xc 拡張引数リストマクロについては後で述べます。 . .Ss "無操作もしくは通常テキストマクロ" . .Ql .No マクロは、マクロコマンド行において整形されては .Em ならない パラメータ用に使用できます。 この英単語 (マクロでなく) をパラメータとして 本当に使いたい場合は、この単語 .Ql \&No に .Ql \e& を足すように注意してください。 .Pp .Dl 使い方: .No Ao 引数 Ac ... .Pp .Bl -tag -width ".Li .No\ test\ Ta\ with\ Ta\ tabs" -compact -offset 15n .It Li ".No test Ta with Ta tabs" .No test Ta with Ta tabs .El .Pp . デフォルト幅は 12n です。 . .Ss "空白なしマクロ" . .Ql .Ns マクロは、現在の位置とマクロの第 1 パラメータとの間に 空白を挿入するのを抑止します。 例えば、フラグと引数の間に空白を含まない古いスタイルの 引数リストを使う場合に便利です: .Pp .Dl "使い方:" ... Ao 引数 Ac \&Ns Oo Ao 引数 Ac Oc ... .Dl " " .Ns Ao 引数 Ac ... .\" 訳注: 2 行目 Dl マクロの第 1 引数の空白の数は 1 行目と一致させる .Pp .Bl -tag -width ".Li .Op\ Fl\ I\ Ns\ Ar\ directory" -compact -offset 15n .It Li ".Op Fl I Ns Ar directory" .Op Fl I Ns Ar directory .El .Pp 注: .Ql .Ns マクロは他のマクロ名が続かなければ、スペースを除去したあとに .Ql .No マクロを常に起動します。 リクエストとして使用される場合 (つまり、 .Sq 使い方 の行での 2 番目の形式です)、 .Ql .Ns マクロは .Ql .No と同一です。 . .Ss "セクションのクロスリファレンス" . .Ql .Sx マクロは同一文書内でのセクションのヘッダへの参照を指定します。 .Pp .Dl 使い方: .Sx Ao セクションの参照 Ac ... .Pp .Bl -tag -width ".Li .Sx\ FILES" -offset 15n .It Li ".Sx FILES" .Sx FILES .El .Pp . デフォルト幅は 16n です。 . .Ss 記号 . 記号体強調マクロは、記号の意味でも伝統的な英語の 使い方においても通常はボールド体マクロとなっています。 .Pp .Dl 使い方: .Sy Ao 記号 Ac ... .Pp .Bl -tag -width ".Li .Sy\ Important\ Notice" -compact -offset 15n .It Li ".Sy Important Notice" .Sy Important Notice .El .Pp . デフォルト幅は 6n です。 . .Ss 数学記号 . 数学記号やそれに似たものについては、このマクロを使用して ください。 .Pp .Dl 使い方: .Ms Ao 数学記号 Ac ... .Pp .Bl -tag -width ".Li .Ms\ sigma" -compact -offset 15n .It Li ".Ms sigma" .Ms sigma .El .Pp . デフォルト幅は 6n です。 . .Ss "参考文献と引用" . 次のマクロは多少なりとも参考文献を扱えるようにと意図したものです。 これらのマクロは、せいぜい .Xr refer 1 スタイルの参考文献のサブセットを手動で 作成しやすくする程度です。 .Pp .Bl -tag -width 6n -offset indent -compact .It Li .Rs 参考文献の開始 (引数はとりません)。 .Sx "SEE ALSO" セクションでは改行を挿入し、参考文献の終了マクロが 読み込まれるまで参考文献の情報を収集します。 .It Li .Re 参考文献の終了 (引数はとりません)。 参考文献が表示されます。 .It Li .%A 参考文献の作者名。1 回の呼び出しにつき、作者名をひとつ指定します。 .It Li .%B 書籍のタイトル。 .It Li .%C 市 / 場所 (まだ実装されていません)。 .It Li .%D 日付。 .It Li .%I 発行者/出版社名。 .It Li .%J 定期刊行物の名称。 .It Li .%N 発行番号。 .It Li .%O 追加情報。 .It Li .%P ページ番号。 .It Li .%Q 組織内部、あるいは外部の著者。 .It Li .%R 報告書の名称。 .It Li .%T 記事のタイトル。 .It Li .%V 巻数。 .El .Pp .Ql % で始まるマクロは呼び出し不可能ですが、 通常の方法で複数の引数をとることができます。 パラメータとしては .Ql .Tn マクロのみ扱います。その他のマクロを使うと 奇妙な出力が得られてしまいます。 .Ql .%B および .Ql .%T を .Ql .Rs/.Re 環境の外側では使用することができます。 .Pp 使用例: . .Bd -literal -offset indent \&.Rs \&.%A "Matthew Bar" \&.%A "John Foo" \&.%T "Implementation Notes on foobar(1)" \&.%R "Technical Report ABC-DE-12-345" \&.%Q "Drofnats College, Nowhere" \&.%D "April 1991" \&.Re .Ed .Pp 出力結果 . .Bd -ragged -offset indent .Rs .%A "Matthew Bar" .%A "John Foo" .%T "Implementation Notes on foobar(1)" .%R "Technical Report ABC-DE-12-345" .%Q "Drofnats College, Nowhere" .%D "April 1991" .Re .Ed . .Ss "商標名 (頭字語とタイプ名)" . 商標名マクロは、引数をより小さなフォントで出力します。 意図される使い方は、大文字の頭字語用に小さな大文字フォントを 似せて作ることです。 .Pp .Dl 使い方: .Tn Ao シンボル Ac ... .Pp .Bl -tag -width ".Li .Tn\ ASCII" -compact -offset 15n .It Li ".Tn DEC" .Tn DEC .It Li ".Tn ASCII" .Tn ASCII .El .Pp . デフォルト幅は 10n です。 . .Ss "拡張引数" . .Li .Xo と .Li .Xc マクロによって、 .Ql .It マクロ (後述) についてマクロ境界での引数リストを 拡張することができます。 .Li .Xo と .Li .Xc マクロは囲いを開いたり閉じたりする他のすべてのマクロに 対して同じように実装されている (もちろん文字は挿入しません) ということに注意してください。 つまり、次の例もこれらのマクロには当てはまります。 .Pp 次は、スペーシングをオフにするために 空白モードマクロを使った .Ql .Xo の使用例です。 . .Bd -literal -offset indent \&.Sm off \&.It Xo Sy I Ar operation \&.No \een Ar count No \een \&.Xc \&.Sm on .Ed .Pp . これは以下のような結果になります。 .Bd -filled -offset indent .Bl -tag -compact .Sm off .It Xo Sy I Ar operation .No \en Ar count No \en .Xc .Sm on .El .Ed .Pp . 例をもうひとつ: . .Bd -literal -offset indent \&.Sm off \&.It Cm S No / Ar old_pattern Xo \&.No / Ar new_pattern \&.No / Op Cm g \&.Xc \&.Sm on .Ed .Pp . これは以下のような結果になります。 . .Bd -filled -offset indent .Bl -tag -compact .Sm off .It Cm S No \&/ Ar old_pattern Xo .No \&/ Ar new_pattern .No \&/ Op Cm g .Xc .Sm on .El .Ed .Pp . 囲いマクロを使った .Ql .Xo の他の例: 変数の値をテストして下さい。 . .Bd -literal -offset indent \&.It Xo \&.Ic .ifndef \&.Oo \e&! Oc Ns Ar variable Oo \&.Ar operator variable ... \&.Oc Xc .Ed .Pp . 結果は以下の通りです。 . .Bd -filled -offset indent .Bl -tag -width flag -compact .It Xo .Ic .ifndef .Oo \&! Oc Ns Ar variable Oo .Ar operator variable ... .Oc Xc .El .Ed .Pp . . .Sh "ページ構造領域" . .Ss "セクションヘッダ" . 次の .Ql .Sh セクションヘッダマクロは、すべてのマニュアルページで必須のものです。 残りのセクションヘッダはマニュアルページの作者の裁量において、 推奨されているものです。 .Ql .Sh マクロは構文解析されますが、一般的には呼び出し不可能です。 .Ql .Sh を呼び出すときだけは、このマクロは引数として使用することができます。 この場合、 .Ql .Sh 用のデフォルトフォントを再度有効にします。 .Pp デフォルト幅は 8n です。 . .Bl -tag -width ".Li .Sh\ RETURN\ VALUES" .It Li ".Sh NAME" .Ql ".Sh NAME" マクロは必須です。 これが指定されていないと、ヘッダとフッタ、それにデフォルトの ページレイアウトが設定されず、結果はかなり好ましくないものに なるでしょう。 .Sx NAME セクションは最低 3 つの項目からなります。 最初のものは名称マクロ .Ql .Nm であり、マニュアルページのサブジェクトとなります。 2 番目のものは名称説明マクロ .Ql .Nd であり、サブジェクト名を 3 つめの項目、 すなわちその名称の説明と分離します。 説明に割り当てられるスペースは小さいものですので、 できるだけ簡潔で分かりやすいものでなければなりません。 .Pp .Ql .Nd は全ての引数の頭に .Ql - , を印字します。 . .It Li ".Sh LIBRARY" このセクションは、セクション 2 および 3 の関数呼び出しの ためにあります。 このセクションには、 .Ql .Lb マクロ呼び出し 1 つのみが含まれている必要があります。 .Sx "ライブラリ名" を参照してください。 . .It Li ".Sh SYNOPSIS" .Sx SYNOPSIS セクションはそのマニュアルページのサブジェクトとなっている項目の 典型的な使用法を説明します。 .Ql .Nm , .Ql .Cd , あるいは .Ql .Fn です (他には .Ql .Fo , .Ql .Fc , .Ql .Fd , .Ql .Ft のマクロも必要な場合があります)。 関数名マクロ .Ql .Fn はセクション 2 と 3 のマニュアルページにおいて必須のもので、 コマンドと一般名称マクロ .Ql .Nm はセクション 1, 5, 6, 7, 8 で必須の項目です。 セクション 4 のマニュアルでは .Ql .Nm か .Ql .Fd 、もしくは設定デバイス使用法マクロ .Ql .Cd が必要です。 その他のいくつかのマクロが次に示すような書式行を生成するために 必要なことがあります: . .Bd -filled -offset indent .Nm cat .Op Fl benstuv .Op Fl .Ar .Ed .Pp . 次のマクロが使われています: .Pp .Dl ".Nm cat" .Dl ".Op Fl benstuv" .Dl ".Op Fl" .Dl .Ar . .It Li ".Sh DESCRIPTION" ほとんどの場合、 .Sx "DESCRIPTION" セクションでの最初のテキストはそのコマンド、関数もしくは ファイルについての短い段落で、オプションの構文リストと それぞれの説明がそれに続きます。 そのようなリストを作成するには .Ql .Bl (リスト開始マクロ)、 .Ql .It (リスト項目マクロ)、 .Ql .El (リスト終了マクロ) を使用します (後述の .Sx リストとカラム セクションを参照)。 . .It Li ".Sh IMPLEMENTATION NOTES" 特定の実装に関する情報はここに置く必要があります。 . .It Li ".Sh RETURN VALUES" セクション 2, 3, 9 の関数の戻り値はここに来る必要があります。 .Ql .Rv を使用して、セクション 2 および 3 のライブラリ関数の .Sx RETURN VALUES セクションを生成することができます。 .Sx "戻り値" の項を参照してください。 .El .Pp . 次の .Ql .Sh セクションヘッダはマニュアルページの好ましいレイアウトの一部であり、 一貫性を保つために適切に使われなければなりません。 これらは使われる順番にリストされています。 . .Bl -tag -width ".Li .Sh\ COMPATIBILITY" .It Li ".Sh ENVIRONMENT" .Sx ENVIRONMENT セクションでは関連する環境変数および それらの振るまいや使用方法に関する手がかりを明らかにする 必要があります。 . .It Li ".Sh FILES" マニュアルページのサブジェクトによって使用されるか生成されるファイルで、 .Sx FILES セクション中でマクロ .Ql .Pa によってリストする必要があります。 . .It Li ".Sh EXAMPLES" 使用例を生成するにはいくつか方法があります。 詳細は後述の .Sx 使用例 セクションを参照してください。 . .It Li ".Sh DIAGNOSTICS" コマンドからの診断メッセージはこのセクションに置く必要があります。 . .It Li ".Sh COMPATIBILITY" 知られている互換性の問題 (例えば、非推奨になったオプションや パラメータ) をここにリストする必要があります。 . .It Li ".Sh ERRORS" 特定のエラーハンドリング、特にライブラリ関数 (マニュアルページのセクション 2, 3, 9) でのエラーハンドリングは ここで説明する必要があります。 .Ql .Er マクロはエラー (errno) を指定するのに使用されます。 . .It Li ".Sh SEE ALSO" .Sx "SEE ALSO" セクションには、そのマニュアルページの題材に関する資料への参照と 他の関連するマニュアルページへのクロスリファレンスが記載されます。 クロスリファレンスは .Ql .Xr マクロによって指定されます。 現在、 .Xr refer 1 スタイルのリファレンスには適合していません。 .Pp クロスリファレンスはセクション番号順、同一セクションにあるものは アルファベット順に並べ、カンマで区切ることを推奨します。 以下に例を示します: .Pp .Xr ls 1 , .Xr ps 1 , .Xr group 5 , .Xr passwd 5 . .It Li ".Sh STANDARDS" コマンドやライブラリ関数やファイルが、 .St -p1003.2 や .St -ansiC のような特定の実装によるものであれば、ここで記述します。 もしコマンドがどの規格にも基づいていなければ、その歴史は .Sx HISTORY のセクションで説明されなければなりません。 . .It Li ".Sh HISTORY" 特定の規格に基づいていないコマンドは、 このセクションでその歴史の概要を説明する必要があります。 . .It Li ".Sh AUTHORS" クレジットはここに置く必要があります。 人物名を指定するには .Ql .An マクロを使用する必要があります。 . .It Li ".Sh BUGS" あきらかな問題はここで記述します。 .El .Pp . ユーザ指定の .Ql .Sh セクションを追加することができます。 例えば、このセクションは以下のように設定されています。 . .Bd -literal -offset 15n \&.Sh "ページ構造領域" .Ed . .Ss "サブセクションヘッダ" . サブセクションヘッダはセクションヘッダとまったく同じ文法を しています。 .Ql .Ss は構文解析されますが、一般的に呼び出し不可能です。 このマクロは、 .Ql .Ss の呼び出し時にのみ引数として使用できます。このとき、 .Ql .Ss のデフォルトフォントが再度有効になります。 .Pp デフォルト幅は 8n です。 . .Ss "段落と行スペース" . .Bl -tag -width ".Li .Pp" .It Li .Pp .Ql .Pp 段落コマンドは必要な場合に行スペースを指定するために使われます。 このマクロは .Ql .Sh マクロや .Ql .Ss マクロの後、ならびに .Ql .Bl マクロや .Ql .Bd マクロの前では必要ありません (いずれのマクロも .Fl compact フラグが指定されていなければ垂直方向の距離を宣言します)。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。そして 引数をとりません。別名は .Ql .Lp です。 .El . .\" XXX . .\" This worked with version one, need to redo for version three .\" .Pp .\" .Ds I .\" .Cw (ax+bx+c) \ is\ produced\ by\ \& .\" .\".Cw (ax+bx+c) \&.Va_by_) \&_and_\& \&[?/]m_b1_e1_f1[?/]\& .\" .Cl Cx \t\t .\" .Li \&.Cx\ ( .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Va ax .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Sy \+ .\" .Cx .\" .Cl Cx \&(\& .\" .Va ax .\" .Cx + .\" .Va by .\" .Cx + .\" .Va c ) .\" .Cx \t .\" .Em is produced by .\" .Cx \t .\" .Li \&.Va by .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Sy \+ .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Va c ) .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Cx .\" .Cx .\" .Cw .\" .De .\" .Pp .\" This example shows the same equation in a different format. .\" The spaces .\" around the .\" .Li \&+ .\" signs were forced with .\" .Li \e : .\" .Pp .\" .Ds I .\" .Cw (ax\ +\ bx\ +\ c) \ is\ produced\ by\ \& .\" .\".Cw (ax+bx+c) \&.Va_by_) \&_and_\& \&[?/]m_b1_e1_f1[?/]\& .\" .Cl Cx \t\t .\" .Li \&.Cx\ ( .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Va a .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Sy x .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Cx \e\ +\e\ \e& .\" .Cx .\" .Cl Cx \&(\& .\" .Va a .\" .Sy x .\" .Cx \ +\ \& .\" .Va b .\" .Sy y .\" .Cx \ +\ \& .\" .Va c ) .\" .Cx \t .\" .Em is produced by .\" .Cl Cx \t\t .\" .Li \&.Va b .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Sy y .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Cx \e\ +\e\ \e& .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Va c ) .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Cx .\" .Cx .\" .Cw .\" .De .\" .Pp .\" The incantation below was .\" lifted from the .\" .Xr adb 1 .\" manual page: .\" .Pp .\" .Ds I .\" .Cw \&[?/]m_b1_e1_f1[?/]\& is\ produced\ by .\" .Cl Cx \t\t .\" .Li \&.Cx Op Sy ?/ .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Nm m .\" .Cx .\" .Cl Cx Op Sy ?/ .\" .Nm m .\" .Ad \ b1 e1 f1 .\" .Op Sy ?/ .\" .Cx \t .\" .Em is produced by .\" .Cx \t .\" .Li \&.Ar \e\ b1 e1 f1 .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Op Sy ?/ .\" .Cx .\" .Cl Cx \t\t .\" .Li \&.Cx .\" .Cx .\" .Cw .\" .De .\" .Pp . .Ss キープ . 現在実装されているキープは単語に対するものだけです。 マクロは .Ql .Bk (キープ開始) と .Ql .Ek (キープ終了) です。 現在 .Ql .Bk が受け付けるオプションは .Fl words のみで (オプションを何も与えていなければこれがデフォルトでもあります) オプションの途中で改行が入らないようにするのに便利です。 make コマンド行の引数を生成する例 ( .Sx この名前には何が の項を参照) において、キープは .Xr nroff がフラグと引数を別の行に分けないように使われています。 .Pp いずれのマクロも呼び出し不可能であり、構文解析もされません。 .Pp キープマクロについてはもっと作業をする必要があります。 特に .Fl line オプションは追加する必要があるでしょう。 . .Ss "例示とディスプレイ" . ディスプレイには 7 つのタイプがあります。 .Pp .Bl -tag -width ".Li .D1" .It Li .D1 (D-いちです) インデントされたテキストを 1 行表示します。 このマクロは構文解析されますが、呼び出し不可能です。 .Pp .D1 Fl ldghfstru .Pp これは次の指定で生成されたものです: .Li ".D1 Fl ldghfstru" . .It Li .Dl (D-エルです) インデントされた .Em リテラル テキストを 1 行表示します。 .Ql .Dl マクロの例は本ファイル中にわたって使われています。 これによって 1 行のテキストのインデント (表示) が可能になります。 デフォルトフォントは固定幅 (リテラル) に設定されます。 .Ql .Dl は構文解析されますが、呼び出し不可能です。 .Pp .Dl % ls -ldg /usr/local/bin .Pp これは、次の指定で生成されたものです: .Li ".Dl % ls -ldg /usr/local/bin" . .It Li .Bd ディスプレイ開始。 .Ql .Bd ディスプレイは .Ql .Ed マクロで終了しなければなりません。 これは、次の書式をとります: .Pp .Bl -tag -width ".Li .Bd" -offset indent .It Li .Bd Xo .Bro \-literal | \-filled | \-unfilled | \-ragged | \-centered Brc .Oo \-offset Ao 文字列 Ac Oc Oo \-file Ao ファイル名 Ac Oc Oo \-compact Oc Xc .El .Pp . .Bl -tag -width ".Fl file Ao Ar ファイル名 Ac " -compact .It Fl ragged 行詰めされますが、右マージンは調整しません (左マージンのみです)。 .It Fl centered 現在の左マージンと右マージン間の中央線です。 線それぞれが中央揃えになるということに注意してください。 .It Fl unfilled 行詰めしません。テキストのブロックを入力されたままの状態で 表示します。改行もユーザが指定した通りに使われます。 このため、何の警告メッセージも出さずに長過ぎる行を 生成する可能性があります。 .It Fl filled 行詰めされたブロックを表示します。 テキストブロックが整形されます (つまり、 テキストは左右どちら側にも揃えられます)。 .It Fl literal リテラルフォント (通常固定幅) でブロックを表示します。 ソースコードや、単純にタブもしくは空白で整えられた テキストには便利です。 .It Fl file Ao Ar ファイル名 Ac .Fl file フラグに続いた名前を持ったファイルが読み込まれ、 指定されたディスプレイタイプで .Ql .Bd と .Ql .Ed マクロで囲まれたデータよりも前に表示されます。 ファイル中の .Xr troff/ Ns Nm \-mdoc コマンドはどんなものでも処理されます。 .It Fl offset Ao Ar 文字列 Ac .Fl offset が以下の文字列のいずれかとともに指定されていると、 その文字列は次のテキストのブロックのインデントのレベルを示すものとして 解釈されます。 . .Pp .Bl -tag -width ".Ar indent-two" -compact .It Ar left ブロックを現在の左マージンに揃えます。 これは .Ql .Bd のデフォルトのモードです。 .It Ar center ブロックを中央揃えにします。 残念ながら現時点では、 単にブロックの左側を仮想的な中央マージンに揃えるだけです。 .It Ar indent デフォルトのインデント値もしくはタブの分だけインデントします。 デフォルトのインデント値は .Ql .D1 および .Ql .Dl マクロでも使われていますので、この 2 つのディスプレイと 行が揃うことが保証されています。 インデント値は通常 6n つまり約 2/3 インチ (固定幅文字 6 つ分) です。 .It Ar indent-two デフォルトのインデント値の 2 倍分インデントします。 .It Ar right これはブロックをページの右端から約 2 インチ離して .Em 左 揃えします。 このマクロはちゃんと動作する必要があるのですが、 .Xr troff ではまったくちゃんと動作してくれていません。 .El .Pp . .Ao 文字列 Ac がそれ以外で正しい数値表現をしている場合 .Pf ( Sq Em u .Em 以外のスケール指示子を伴う)、 インデント用にその値を使用します。 スケール指示子のなかで最も役に立つものは .Sq m および .Sq n です。これらはいわゆる .Em \&Em と .Em "En square" を指定します。 これらはそれぞれ、現在のフォントでの文字 .Sq m および文字 .Sq n の幅とほぼ同じです ( nroff の出力については、 どちらのスケール指示子でも同じ値が得られます )。 .Ao 文字列 Ac が数値表現をしていない場合、文字列は .Nm \-mdoc マクロ名であるかどうか検査され、このマクロに関連する デフォルトのオフセット値が使われます。 最終的にすべてのテストが失敗した場合 the width of .Ao 文字列 Ac の幅 (固定幅フォントでのタイプセット) がオフセットと見なされます。 .It Fl compact ディスプレイを開始するときに垂直方向の空白を挿入しないようにします。 .El . .It Li .Ed ディスプレイの終了 (引数はとりません)。 .El . .Ss "リストとカラム" . リスト開始マクロ .Ql .Bl で開始できるリストには何種類かあります。 リスト中の項目は項目マクロ .Ql .It で指定され、各リストは .Ql .El マクロで終了しなければなりません。 リストはリスト自身やディスプレイの中で入れ子にすることができます。 リスト中でカラムを使ったり、カラムの中でリストを使ったりすることに ついては検証されていません。 .Pp さらに、タグ幅、リストのオフセット、コンパクトの度合 (項目間の空白行が許されているかどうか) のような リストの属性をいくつか指定することができます。 本ドキュメントのほとんどはタグ .Pf ( Fl tag ) スタイルリストで整形されています。 .Pp このマクロは次の文法規則を持っています: . .Pp .Bl -tag -width ".Li .Bl" -offset indent -compact .It Li .Bl Xo .Bro \-hang | \-ohang | \-tag | \-diag | \-inset Brc .Oo \-width Ao 文字列 Ac Oc .Oo \-offset Ao 文字列 Ac Oc Oo \-compact Oc Xc .It Li .Bl Xo .No \-column Oo \-offset Ao 文字列 Ac Oc .Ao 文字列1 Ac Ao 文字列2 Ac ... Xc .It Li .Bl Xo .Bro \-item | \-enum Oo \-nested Oc | \-bullet | \-hyphen | \-dash Brc .Oo \-offset Ao 文字列 Ac Oc Oo \-compact Oc Xc .El .Pp . 次に、このリストタイプの詳細な解説を行います。 . .Pp .Bl -tag -width ".Fl column" -compact .It Fl bullet ビュレットリストです。 . .Bd -literal -offset indent \&.Bl -bullet -offset indent -compact \&.It 1 つ目のビュレットはここにきます。 \&.It 2 つ目のビュレットはここにきます。 \&.El .Ed .Pp . 生成結果は次の通りです: . .Pp .Bl -bullet -offset indent -compact .It 1 つ目のビュレットはここにきます。 .It 2 つ目のビュレットはここにきます。 .El .Pp . .It Fl dash No ( または Fl hyphen ) ダッシュ文字によるリストです。 . .Bd -literal -offset indent \&.Bl -dash -offset indent -compact \&.It 1 つ目のダッシュはここにきます。 \&.It 2 つ目のダッシュはここにきます。 \&.El .Ed .Pp . 生成結果は次の通りです: . .Pp .Bl -dash -offset indent -compact .It 1 つ目のダッシュはここにきます。 .It 2 つ目のダッシュはここにきます。 .El .Pp . .It Fl enum 箇条書きリストです。 . .Bd -literal -offset indent \&.Bl -enum -offset indent -compact \&.It 1 つ目の項目はここにきます。 \&.It 2 つ目の項目はここにきます。 \&.El .Ed .Pp . 生成結果は次の通りです: . .Pp .Bl -enum -offset indent -compact .It 1 つ目の項目はここにきます。 .It 2 つ目の項目はここにきます。 .El .Pp . 箇条書きリストを入れ子にしたい場合、 .Fl nested フラグを使用してください (第 2 レベルのリストが開始されます): . .Bd -literal -offset indent \&.Bl -enum -offset indent -compact \&.It 1 つ目の項目はここにきます。 \&.Bl -enum -nested -compact \&.It 2 つ目の項目はここにきます。 \&.It 3 つ目の項目はここにきます。 \&.It \&.El \&.It 4 つ目の項目はここにきます。 \&.El .Ed .Pp . 生成結果は次の通りです: . .Pp .Bl -enum -offset indent -compact .It 1 つ目の項目はここにきます。 .Bl -enum -nested -compact .It 2 つ目の項目はここにきます。 .It 3 つ目の項目はここにきます。 .El .It 4 つ目の項目はここにきます。 .El .Pp . .It Fl item リストの印をつけない .Fl item タイプのリストです。 . .Bd -literal -offset indent \&.Bl -item -offset indent \&.It 1 つ目の項目はここにきます。 1 つ目の項目はここにきます。 1 つ目の項目はここにきます。 \&.It 2 つ目の項目はここにきます。 2 つ目の項目はここにきます。 2 つ目の項目はここにきます。 \&.El .Ed .Pp . 生成結果は次の通りです: . .Pp .Bl -item -offset indent .It 1 つ目の項目はここにきます。 1 つ目の項目はここにきます。 1 つ目の項目はここにきます。 .It 2 つ目の項目はここにきます。 2 つ目の項目はここにきます。 2 つ目の項目はここにきます。 .El .Pp . .It Fl tag タグつきリストです。 タグ幅を指定するには .Fl width を使用してください。 . .Pp .Bl -tag -width "PPID" -compact -offset indent .It SL プロセスが sleep している時間 (ブロックされた秒数) .It PAGEIN そのプロセスによって、まだメモリにロードされていないページへの参照が 起こることにより生じたディスク .Tn I/O の回数 .It UID 数値表記によるプロセス所有者のユーザ ID .It PPID 数値表記による親プロセスの ID、プロセスの優先度 (割り込み不可の待機状態のときには、正でない値になる) .El .Pp . 元のテキストは次の通りです: . .Bd -literal -offset indent \&.Bl -tag -width "PPID" -compact -offset indent \&.It SL プロセスが sleep している時間 (ブロックされた秒数) \&.It PAGEIN そのプロセスによって、まだメモリにロードされていないページへの参照が 起こることにより生じたディスク \&.Tn I/O の回数 \&.It UID 数値表記によるプロセス所有者のユーザ ID \&.It PPID 数値表記による親プロセスの ID、プロセスの優先度 (割り込み不可の待機状態のときには、正でない値になる) \&.El .Ed .Pp . .It Fl diag 診断リストはセクション 4 の診断リストを生成するもので、 呼び出し可能なマクロが無視されることを除き、inset リストと似ています。 フラグ .Fl width は、この文脈では意味がありません。 .Pp 使用例: . .Bd -literal -offset indent \&.Bl -diag \&.It ここで Sy を使うことはできません。 このメッセージはすべて出力されます。 \&.El .Ed .Pp . 生成結果 . .Bl -diag .It ここで Sy を使うことはできません。 このメッセージはすべて出力されます。 .El .Pp . .It Fl hang ぶら下がりタグつきリストです。 . .Bl -hang -offset indent .It Em Hanged ラベル幅よりもラベルが小さい場合には ぶら下げられたラベルはタグつきリストと同じように見えます。 .It Em Longer hanged list labels ラベル幅より長いぶら下がりリストのラベルは、 タグつき段落ラベルとは違い、段落に溶け込みます。 .El .Pp 以上の文章を生成した、整形前のテキストは 次の通りです: . .Bd -literal -offset indent \&.Bl -hang -offset indent \&.It Em Hanged ラベル幅よりもラベルが小さい場合には ぶら下げられたラベルはタグつきリストと同じようにみえます。 \&.It Em Longer Hanged list labels ラベル幅より長いぶら下がりリストのラベルは、 タグつき段落ラベルとは違い、段落に溶け込みます。 \&.El .Ed .Pp . .It Fl ohang オーバハングタグ (overhanging tags) を用いたリストは 項目に対してインデントを使いません。 タグは別の行に出力されます。 .Pp .Bl -ohang -offset indent .It Sy SL プロセスが sleep している時間 (ブロックされた秒数) .It Sy PAGEIN そのプロセスによって、まだメモリにロードされていないページへの参照が 起こることで生じたディスク .Tn I/O の回数 .It Sy UID 数値表記によるプロセス所有者のユーザ ID .It Sy PPID 数値表記による親プロセスの ID、プロセスの優先度 (割り込み不可の待機状態のときには、正でない値になる) .El .Pp . 元のテキストは次の通りです: . .Bd -literal -offset indent \&.Bl -ohang -offset indent \&.It Sy SL プロセスが sleep している時間 (ブロックされた秒数) \&.It Sy PAGEIN そのプロセスによって、まだメモリにロードされていないページへの参照が 起こることで生じたディスク \&.Tn I/O の回数 \&.It Sy UID 数値表記によるプロセス所有者のユーザ ID \&.It Sy PPID 数値表記による親プロセスの ID、プロセスの優先度 (割り込み不可の待機状態のときには、正でない値になる) \&.El .Ed .Pp . .It Fl inset 次は、inset ラベルの例です: .Bl -inset -offset indent .It Em tag タグリスト (タグ段落とも呼びます) は バークレーのマニュアルで使われている最も一般的な 種類のリストです。 後で述べるように、 .Fl width 属性を使用してください。 .It Em diag 診断リストはセクション 4 の診断リストを生成し、 呼び出し可能なマクロを無視するという点を除けば inset リストと似ています。 .It Em hang ぶら下がりラベルは気分の問題です。 .It Em ohang オーバハングラベルは空白に制限がある場合には良いです。 .It Em inset inset ラベルは段落ブロックを制御するのに便利で、 .Nm \-mdoc マニュアルを別のフォーマットに変換するのに有用です。 .El .Pp 上の例を生成したソーステキストはこうなっています: . .Bd -literal -offset indent \&.Bl -inset -offset indent \&.It Em tag タグリスト (タグ段落とも呼びます) は バークレーのマニュアルで使われている最も一般的な 種類のリストです。 後で述べるように、 \&.Fl width 属性を使用してください。 \&.It Em diag 診断リストはセクション 4 の診断リストを生成し、 呼び出し可能なマクロを無視するという点を除けば inset リストと似ています。 \&.It Em hang ぶら下がりラベルは気分の問題です。 \&.It Em ohang オーバハングラベルは空白に制限がある場合には良いです。 \&.It Em inset inset ラベルは段落ブロックを制御するのに便利で、 \&.Nm \-mdoc マニュアルを別のフォーマットに変換するのに有用です。 \&.El .Ed .Pp . .It Fl column この種類のリストは複数カラムを生成します。 カラムの数および各カラムの幅は .Fl column リストへの引数、 .Aq Ar string1 , .Aq Ar string2 等によって決定されます。 .Aq Ar stringN が .Ql .\& (ドット) で開始し直後に有効な .Nm \-mdoc マクロ名が続く場合、 .Aq Ar stringN を解釈して結果の幅を使用します。 そうでない場合、 .Aq Ar stringN (固定幅フォントでのタイプセット) は .Ar N 番目の桁の幅になります。 .Pp .Ql .It 引数はそれぞれ構文解析され行を生成します。 行中の各列はタブや .Ql .Ta マクロで分けられた引数です。 .Pp 次の表、 . .Bl -column -offset indent ".Sy 文字列" ".Sy nroff" ".Sy troff" .It Sy 文字列 Ta Sy nroff Ta Sy troff .It Li <= Ta <= Ta \*(<= .It Li >= Ta >= Ta \*(>= .El .Pp . は次のようにして生成されています: . .Bd -literal -offset indent \&.Bl -column -offset indent ".Sy 文字列" ".Sy nroff" ".Sy troff" \&.It Sy 文字列 Ta Sy nroff Ta Sy troff \&.It Li <= Ta <= Ta \e*(<= \&.It Li >= Ta >= Ta \e*(>= \&.El .Ed .El .Pp . その他のキーワード: . .Bl -tag -width ".Fl indent Ao Ar 文字列 Ac" .It Fl width Ao Ar 文字列 Ac .Aq Ar 文字列 が .Ql .\& (ドット) で開始し直後に有効な .Nm \-mdoc マクロ名が続く場合、 .Aq Ar 文字列 を解釈し、その結果の幅を使います。 本ドキュメントのほとんどすべてのリストは このオプションを使用しています。 .Pp 使用例: . .Bd -literal -offset indent \&.Bl -tag -width ".Fl test Ao Ar 文字列 Ac" \&.It Fl test Ao Ar 文字列 Ac これは、 \&.Fl width フラグをタグリストと一緒に使うとどのように 働くかを見るためのもっと長い文です。 \&.El .Ed .Pp . 生成結果: . .Bl -tag -width ".Fl test Ao Ar 文字列 Ac" .It Fl test Ao Ar 文字列 Ac これは、 .Fl width フラグをタグリストと一緒に使うとどのように 働くかを見るためのもっと長い文です。 .El .Pp . .Ao 文字列 Ac が解釈される前に現在の .Nm \-mdoc の状態が保存されることに注意してください。 文字列が解釈された後ですべての変数が再度復元されます。 しかし、ボックス (囲いに使用される) は .Tn GNU .Xr troff 1 では保存されません。結果としては、醜いエラーを防ぐためには 引数は常に .Em 平衡がとれて いなくてはなりません。 例えば、本当に開き山括弧だけが必要である場合には .Ql ".Ao Ar 文字列" と書いてはだめで、代わりに .Ql ".Ao Ar 文字列 Xc" と書かなくてはなりません。 .Pp そうでない場合、 .Aq Ar 文字列 が正当な数値表現である場合 .Sq ( Em u .Em 以外のスケール指示子を伴う)、 インデント用にその値を使用します。 最も有用なスケール指示子は .Sq m と .Sq n です。 これらはいわゆる .Em \&Em および .Em "En square" を指定します。 これらはそれぞれ、現在のフォントでの文字 .Sq m および文字 .Sq n の幅とほぼ同じです (nroff の出力については、 どちらのスケール指示子でも同じ値が得られます)。 .Aq Ar 文字列 が数値表現をしていない場合、文字列は .Nm \-mdoc マクロ名であるかどうか検査され、このマクロに関連する デフォルトのオフセット値が使われます。 最終的にすべてのテストが失敗した場合 .Aq Ar 文字列 の幅 (固定幅フォントでのタイプセット) がオフセットと見なされます。 .Pp タグリストタイプ用に幅が指定されていない場合、 .Ql .It が起動される度に適切な幅を決定しようと試みます。 .Ql .It の第 1 引数が呼び出し可能なマクロである場合、 そのマクロのデフォルト幅が使われます。 そうでなければ、 .Ql .No のデフォルト幅が使われます。 .Pp .It Fl offset Ao Ar 文字列 Ac .Aq Ar 文字列 が .Ar indent である場合、デフォルトのインデント値 (通常 6n に設定されており、 .Ql .Dl または .Ql .Bd で使われる値と似ています) が使われます。 .Aq Ar 文字列 が正当な数値表現である場合 .Pf ( Sq Em u 以外のスケール指示子を伴う )、 その値をインデントに使用します。 最も有用なスケール指示子は .Sq m と .Sq n であり、これらはいわゆる .Em \&Em および .Em "En square" です。 これらはそれぞれ、それぞれ現在のフォントでの .Sq m と .Sq n の幅とほぼ同じです (nroff の出力については、 どちらのスケール指示子も同じ値をとります)。 .Ao 文字列 Ac が数値表現でない場合、その文字列が .Nm \-mdoc のマクロ名であるかどうか検査され、このマクロに関連する デフォルトのオフセット値が使われます。 最終的にすべてのテストが失敗した場合、 .Aq Ar 文字列 の幅 (固定幅フォントでのタイプセット) がオフセットとして とられます。 .It Fl compact リストの前およびリスト項目間に垂直方向の空白を挿入しないように します。 .El . . .Sh "その他のマクロ" . ここには、いままでのセクションにはうまく当てはまらなかった 残りのマクロのリストがあります。 次のマクロに対しては本物の使用例を見つけられませんでした。 それは .Ql .Me と .Ql .Ot です。この 2 つについても完璧を期するためにここに 文書化はしています。もしこの 2 つのマクロの 適切な使い方をご存知であれば .Mt bug-groff@gnu.org までメールを送ってください (例つきで)。 . .Bl -tag -width ".Li .Bt" .It Li .Bt は . .Bd -ragged -offset indent .Bt .Ed .Pp を表示します。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。 また引数もとりません。 . .It Li .Fr .Pp .Dl 使い方: .Fr Ao 関数の戻り値 Ac ... .Pp このマクロは使わないでください。 このマクロは戻り値 (通常は数字 1 個) の直前での 改行を許してしまいます。 印刷時の振る舞いとしては悪いことです。 直前の単語と戻り値とを結合させるには .Ql \e~ を使用してください。 . .It Li .Hf (ヘッダ) ファイルをそのまま含めるにはこのマクロを 使ってください。 このマクロは、最初に .Ql File: とファイル名を表示し、その後で .Ao ファイル Ac の内容を表示します。 .Pp .Dl 使い方: .Hf Ao ファイル Ac .Pp このマクロは呼び出し不可能であり、構文解析もされません。 . .It Li .Lk 将来書かれる予定です。 . .It Li .Me 正確な使用方法は分かりません。 .Nm \-mdoc ソースファイル中の記述では .Dq "メニューエントリ" となっています。 .Pp デフォルト幅は 6n です。 . .It Li .Mt 将来書かれる予定です。 . .It Li .Ot 正確な使用方法は分かりません。 .Nm \-mdoc ソースファイル中の記述では .Dq "古い関数タイプ (fortran)" となっています。 . .It Li .Sm 空白モードを有効に (トグル) します。 .Pp .Dl 使い方: .Sm Oo on | off Oc ... .Pp 空白モードが off の場合、マクロ引数の間に空白は 挿入されません。引数なしで呼ばれた場合 (あるいは 次の引数が .Ql on でも .Ql off でもない場合) .Ql .Sm マクロは空白モードに入ります。 . .It Li .Ud マクロは . .Bd -ragged -offset indent .Ud .Ed .Pp を表示します。 .Pp このマクロは呼び出し不可能であり、構文解析もされません。 また引数もとりません。 .El . . .Sh "定義済み文字列" . 次の文字列が定義済みです: .Pp .Bl -column 文字列 infinity "troff " "まっすぐなダブルクォート" -offset indent .It Sy 文字列 Ta Sy nroff Ta Sy troff Ta Sy 意味 .It Li <= Ta <= Ta \*[<=] Ta "以下" .It Li >= Ta >= Ta \*[>=] Ta "以上" .It Li Rq Ta '' Ta \*[Rq] Ta "右側のダブルクォート" .It Li Lq Ta `` Ta \*[Lq] Ta "左側のダブルクォート" .It Li ua Ta ^ Ta \*[ua] Ta "上向き矢印" .It Li aa Ta \' Ta \*[aa] Ta "アキュートアクセント" .It Li ga Ta \` Ta \*[ga] Ta "グレーブアクセント" .It Li q Ta \&" Ta \*[q] Ta "まっすぐなダブルクォート" .It Li Pi Ta pi Ta \*[Pi] Ta "ギリシャ語のパイ" .It Li Ne Ta != Ta \*[Ne] Ta "不等号" .It Li Le Ta <= Ta \*[Le] Ta "以下" .It Li Ge Ta >= Ta \*[Ge] Ta "以上" .It Li Lt Ta < Ta \*[Lt] Ta "小なり" .It Li Gt Ta > Ta \*[Gt] Ta "大なり" .It Li Pm Ta +\- Ta \*[Pm] Ta "プラスマイナス" .It Li If Ta infinity Ta \*[If] Ta "無限" .It Li Na Ta \*[Na] Ta \*[Na] Ta "非数値" .It Li Ba Ta \*[Ba] Ta \*[Ba] Ta "垂直線" .El .Pp カラムの名前 .Sy nroff と .Sy troff は少々誤解を招くものです。 .Sy nroff は .Tn ASCII 文字を表示しますが、 .Sy troff では利用可能なもののうち一番良いグリフ形式を 表示します。 例えば、Unicode を使用可能にした .Tn TTY デバイスはすべての文字列に対して適切なグリフ表現を 持っていますが、それに対して Latin1 に対して機能を強化した .Tn TTY デバイスはプラスマイナス記号しか持っていません。 .Pp 文字を 2 つ含んだ文字列名は .Ql \e*(xx として表記できます。 文字を 1 文字だけ含んだ文字列名は .Ql \e*x と表記できます。 どのような長さの文字列名に対しても、一般的な文法は .Ql \e*[xxx] となります ( これは .Tn GNU .Xr troff 1 拡張です)。 . . \# \#===================================================================== \# .Sh 診断 . 以前のバージョンの .Nm \-mdoc パッケージでは利用可能だったデバッグ用マクロ .Ql .Db は取り除かれました。なぜなら、 .Tn GNU .Xr troff 1 ではパラメータをチェックするのにもっと良いファシリティを 提供しているからです。さらに、このマクロパッケージには エラーや警告メッセージが多数追加されており、よりロバストで 饒舌なものになっています。 .Pp 唯一残ったデバッグ用マクロは .Ql .Rd であり、これはすべてのグローバルレジスタならびに文字列の レジスタダンプを出力するものです。 通常のユーザが使う必要は決してないでしょう。 . . .Sh "GROFF, TROFF, および NROFF を使用した整形" . デフォルトでは、このパッケージでは .Sq latin1 や .Sq unicode のような .Tn TTY デバイスで表示する場合には改ページやヘッダ、フッタは 禁止されており、マニュアルをオンラインで効率良く 見ることができるようになっています。 この振る舞いは、 .Xr groff を呼んでいるときにレジスタ .Ql cR に 0 を指定することで変更することができます (例えば、 .Tn TTY 出力のハードコピーを作成したいときなど)。 .Pp .Dl groff -Tlatin1 -rcR=0 -mdoc foo.man > foo.txt .Pp 両面印刷用には、レジスタ .Ql D を 1 に設定してください: .Pp .Dl groff -Tps -rD1 -mdoc foo.man > foo.ps .Pp ドキュメントのフォントサイズを 11pt や 12pt に変更したい 場合は、レジスタ .Ql S をそれに合わせて設定してください: .Pp .Dl groff -Tdvi -rS11 -mdoc foo.man > foo.dvi .Pp レジスタ .Ql S は .Tn TTY デバイスに対しては無視されます。 . . .Sh 関連ファイル . .Bl -tag -width mdoc/doc-ditroff -compact .It Pa doc.tmac 主なマニュアル用マクロパッケージです。 .It Pa mdoc.tmac .Pa doc.tmac を呼ぶラッパファイルです。 .It Pa mdoc/doc-common 共通する文字列、定義、および印刷出力に関連する項目です。 .It Pa mdoc/doc-nroff .Tn TTY 出力デバイス用に使用される定義です。 .It Pa mdoc/doc-ditroff その他すべてのデバイス用に使用される定義です。 .It Pa mdoc.local ローカルマシンでの追加項目およびカスタマイズ項目です。 .It Pa andoc.tmac このファイルは .Nm \-mdoc パッケージと .Nm \-man パッケージのどちらを使用すべきかをチェックします。 .El . . .Sh "関連項目" . .Xr groff 1 , .Xr man 1 , .Xr troff 1 , .Xr groff_man 7 . . .Sh バグ . セクション 3f はヘッダルーチンには追加されていません。 .Pp .Ql \&.Nm .Sx NAME セクションにおいては、フォントを変更するべきです。 .Pp 行の長さが短すぎる場合に行が分割されるのを防ぐために .Ql \&.Fn がチェックを行う必要があります。 ときどき、最後の括弧が分割されることがあり、 行詰めモードであるときにおかしな結果になることがあります。 .Pp リストマクロおよびディスプレイマクロは何のキープも 行いませんが、これはキープを行うべきです。 .\" Note what happens if the parameter list overlaps a newline .\" boundary. .\" to make sure a line boundary is crossed: .\" .Bd -literal .\" \&.Fn struct\e\ dictionarytable\e\ *dictionarylookup struct\e\ dictionarytable\e\ *tab[] .\" .Ed .\" .Pp .\" produces, nudge nudge, .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab[] , .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab[] , .\" nudge .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab[] . .\" .Pp .\" If double quotes are used, for example: .\" .Bd -literal .\" \&.Fn \*qstruct dictionarytable *dictionarylookup\*q \*qchar *h\*q \*qstruct dictionarytable *tab[]\*q .\" .Ed .\" .Pp .\" produces, nudge nudge, .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab[]" , .\" nudge .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab[]" , .\" nudge .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab[]" . .\" .Pp .\" Not a pretty sight... .\" In a paragraph, a long parameter containing unpaddable spaces as .\" in the former example will cause .\" .Xr troff .\" to break the line and spread .\" the remaining words out. .\" The latter example will adjust nicely to .\" justified margins, but may break in between an argument and its .\" declaration. .\" In .\" .Xr nroff .\" the right margin adjustment is normally ragged and the problem is .\" not as severe. . .\" Local Variables: .\" mode: nroff .\" End: .\" .SH 履歴 .\" Yoshiteru Kageyama 2001/06/10 mdoc.samples.7 .\" を参考に翻訳 .\" MORI Kouji 2001/08/21 訳チェック diff --git a/ja_JP.eucJP/man/man8/Makefile b/ja_JP.eucJP/man/man8/Makefile index d8973d836a..24d0c72283 100644 --- a/ja_JP.eucJP/man/man8/Makefile +++ b/ja_JP.eucJP/man/man8/Makefile @@ -1,358 +1,359 @@ # $FreeBSD$ MAN8 = IPXrouted.8\ MAKEDEV.8\ ac.8\ accton.8\ adding_user.8\ adduser.8\ adjkerntz.8\ amd.8\ amq.8\ ancontrol.8\ apm.8\ apmd.8\ arp.8\ atacontrol.8\ atm.8\ atmarpd.8\ atrun.8\ badsect.8\ boot0cfg.8\ boot_i386.8\ bootparamd.8\ bootpd.8\ bootpef.8\ bootptest.8\ btxld.8\ burncd.8\ camcontrol.8\ ccdconfig.8\ chat.8\ chkgrp.8\ chkprintcap.8\ chown.8\ chroot.8\ clri.8\ comcontrol.8\ comsat.8\ config.8\ crash.8\ cron.8\ cvsbug.8\ dev_mkdb.8\ dhclient-script.8\ dhclient.8\ disklabel.8\ diskless.8\ diskpart.8\ dm.8\ dmesg.8\ dump.8\ dumpfs.8\ dumpon.8\ editmap.8\ edquota.8\ faithd.8\ fdcontrol.8\ fdisk.8\ ffsinfo.8\ fingerd.8\ fixmount.8\ fore_dnld.8\ fsck.8\ fsck_msdosfs.8\ fsdb.8\ fsinfo.8\ fsirand.8\ ftpd.8\ genassym.8\ gensetdefs.8\ getty.8\ gifconfig.8\ growfs.8\ hlfsd.8\ ibcs2.8\ ifconfig.8\ ifmcstat.8\ ilmid.8\ inetd.8\ init.8\ intro.8\ iostat.8\ ip6fw.8\ ipf.8\ ipfs.8\ ipfstat.8\ ipfw.8\ ipmon.8\ ipnat.8\ isdnd.8\ isdndebug.8\ isdndecode.8\ isdnmonitor.8\ isdnphone.8\ isdntel.8\ isdntelctl.8\ isdntrace.8\ ispcvt.8\ jail.8\ joy.8\ kernbb.8\ keyserv.8\ kget.8\ kgmon.8\ kgzip.8\ kldconfig.8\ kldload.8\ kldstat.8\ kldunload.8\ kzip.8\ lastlogin.8\ ldconfig.8\ linux.8\ loader.4th.8\ loader.8\ locate.updatedb.8\ lpc.8\ lpd.8\ lptcontrol.8\ mail.local.8\ mailstats.8\ mailwrapper.8\ makekey.8\ makemap.8\ makewhatis.local.8\ manctl.8\ map-mbone.8\ memcontrol.8\ mergemaster.8\ mixer.8\ mk-amd-map.8\ mknetid.8\ mknod.8\ mld6query.8\ mlxcontrol.8\ mount.8\ mount_cd9660.8\ mount_ext2fs.8\ mount_msdos.8\ mount_nfs.8\ mount_ntfs.8\ mount_null.8\ mount_nwfs.8\ mount_portal.8\ mount_smbfs.8\ mount_std.8\ mount_umap.8\ mount_union.8\ mountd.8\ moused.8\ mrinfo.8\ mrouted.8\ mtest.8\ mtrace.8\ mtree.8\ named-bootconf.8\ named-xfer.8\ named.8\ named.reload.8\ named.restart.8\ natd.8\ ndc.8\ ndp.8\ newfs.8\ newfs_msdos.8\ newkey.8\ newsyslog.8\ nextboot.8\ nfsd.8\ nfsiod.8\ ngctl.8\ nghook.8\ nologin.8\ nos-tun.8\ nslookup.8\ nsupdate.8\ ntp-genkeys.8\ ntpd.8\ ntpdate.8\ ntpdc.8\ ntpq.8\ ntptime.8\ ntptrace.8\ pac.8\ pam.8\ pam_radius.8\ pam_ssh.8\ pccardc.8\ pccardd.8\ pciconf.8\ periodic.8\ picobsd.8\ ping.8\ ping6.8\ pnpinfo.8\ portmap.8\ ppp.8\ pppctl.8\ pppd.8\ pppoed.8\ pppstats.8\ praliases.8\ prefix.8\ procctl.8\ pstat.8\ pw.8\ pwd_mkdb.8\ pxeboot.8\ quot.8\ quotacheck.8\ quotaon.8\ rarpd.8\ raycontrol.8\ rbootd.8\ rc.8\ rc.sendmail.8\ reboot.8\ renice.8\ repquota.8\ restore.8\ revnetgroup.8\ rexecd.8\ rip6query.8\ rlogind.8\ rmail.8\ rmt.8\ rmuser.8\ rndcontrol.8\ route.8\ route6d.8\ routed.8\ rpc.lockd.8\ rpc.rquotad.8\ rpc.rstatd.8\ rpc.rusersd.8\ rpc.rwalld.8\ rpc.sprayd.8\ rpc.statd.8\ rpc.umntall.8\ rpc.yppasswdd.8\ rpc.ypxfrd.8\ rpcinfo.8\ rrenumd.8\ rshd.8\ rtadvd.8\ rtquery.8\ rtsold.8\ rwhod.8\ sa.8\ savecore.8\ scspd.8\ sendmail.8\ setkey.8\ sftp-server.8\ showmount.8\ shutdown.8\ sicontrol.8\ slattach.8\ sliplogin.8\ slstat.8\ smrsh.8\ spkrtest.8\ spppcontrol.8\ spray.8\ sshd.8\ sticky.8\ stlload.8\ stlstats.8\ stlstty.8\ strfile.8\ svr4.8\ swapon.8\ sync.8\ sysctl.8\ sysinstall.8\ syslogd.8\ talkd.8\ tcpdchk.8\ tcpdmatch.8\ telnetd.8\ tftpd.8\ timed.8\ timedc.8\ traceroute.8\ traceroute6.8\ trpt.8\ tunefs.8\ tzsetup.8\ umount.8\ usbd.8\ usbdevs.8\ uuchk.8\ uucico.8\ uucpd.8\ uusched.8\ uuxqt.8\ vinum.8\ vipw.8\ vmstat.8\ vnconfig.8\ watch.8\ wicontrol.8\ wire-test.8\ wlconfig.8\ xtend.8\ yp.8\ yp_mkdb.8\ ypbind.8\ ypinit.8\ yppoll.8\ yppush.8\ ypserv.8\ ypset.8\ ypxfr.8\ zdump.8\ zic.8 MLINKS+=apm.8 apmconf.8 MLINKS+=apm.8 zzz.8 MLINKS+=boot_i386.8 boot.8 MLINKS+=bootpd.8 bootpgw.8 MLINKS+=dump.8 rdump.8 +MLINKS+=ftpd.8 lukemftpd.8 MLINKS+=inetd.8 inetd.conf.5 MLINKS+=init.8 securelevel.8 MLINKS+=locate.updatedb.8 updatedb.8 MLINKS+=makewhatis.local.8 catman.local.8 MLINKS+=mount_std.8 mount_fdesc.8 MLINKS+=mount_std.8 mount_kernfs.8 MLINKS+=mount_std.8 mount_procfs.8 MLINKS+=mount_std.8 mount_linprocfs.8 MLINKS+=newfs.8 mount_mfs.8 MLINKS+=newfs.8 mfs.8 MLINKS+=newfs.8 tmpfs.8 MLINKS+=pam.8 pam.conf.5 MLINKS+=pam.8 pam.d.5 MLINKS+=pstat.8 swapinfo.8 MLINKS+=quotaon.8 quotaoff.8 MLINKS+=rc.8 rc.atm.8 MLINKS+=rc.8 rc.early.8 MLINKS+=rc.8 rc.firewall.8 MLINKS+=rc.8 rc.i386.8 MLINKS+=rc.8 rc.local.8 MLINKS+=rc.8 rc.network.8 MLINKS+=rc.8 rc.pccard.8 MLINKS+=rc.8 rc.serial.8 MLINKS+=rc.8 rc.shutdown.8 MLINKS+=reboot.8 halt.8 MLINKS+=reboot.8 fastboot.8 MLINKS+=reboot.8 fasthalt.8 MLINKS+=restore.8 rrestore.8 MLINKS+=rtsold.8 rtsol.8 MLINKS+=slattach.8 slip.8 MLINKS+=strfile.8 unstr.8 MLINKS+=vnconfig.8 swapfile.8 MLINKS+=yp.8 NIS.8 MLINKS+=yp.8 YP.8 MLINKS+=yp.8 nis.8 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man8/fdcontrol.8 b/ja_JP.eucJP/man/man8/fdcontrol.8 index bbe2713bda..4e81808838 100644 --- a/ja_JP.eucJP/man/man8/fdcontrol.8 +++ b/ja_JP.eucJP/man/man8/fdcontrol.8 @@ -1,103 +1,103 @@ .\" .\" Copyright (C) 1994 by Joerg Wunsch, Dresden .\" 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(S) ``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(S) 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. .\" -.\" %FreeBSD: src/usr.sbin/fdcontrol/fdcontrol.8,v 1.9.2.3 2001/08/16 15:55:57 ru Exp % +.\" %FreeBSD src/usr.sbin/fdcontrol/fdcontrol.8,v 1.9.2.4 2002/06/21 16:40:24 charnier Exp % .\" .\" $FreeBSD$ .Dd May 22, 1994 .Os .Dt FDCONTROL 8 .Sh 名称 .Nm fdcontrol .Nd フロッピディスクパラメータの変更 .Sh 書式 .Nm .Op Fl d Ar 0|1 .Ar device .Nm .Op Fl s .Ar device .Sh 解説 .Nm -は +ユーティリティは、 .Ar device で指定したフロッピディスクデバイスの実行時の振る舞いを変更します。 .Ar device はキャラクタデバイスでなければなりません。 .Pp 現在のところ .Nm -では、 +ユーティリティでは、 フロッピディスクドライブのデバイスパラメータの指定 ( .Fl s , これがデフォルトモードでもあります) や、フロッピドライバが .Em DEBUG オプション付きでカーネルに組み込まれている場合には ドライバのデバッグレベルの変更 .Pq Fl d を行なうことができます。 .Pp これらの操作は他に悪影響を及ぼす可能性があるため、 この中で行なわれる .Xr ioctl 2 コマンドの実行はスーパユーザに限定されています。 .Pp 新しいパラメータ指定を要求すると、 .Nm は調整可能な各パラメータをユーザに問い合わせてきます。 これらは現在使われている値がデフォルト値となっています。 .Sh 診断 内部で呼び出される .Xr ioctl 2 のエラーコードが .Xr warn 3 によって表示されます。 .Sh バグ .Nm -コマンドは現在開発途上です。 +ユーティリティコマンドは現在開発途上です。 ユーザインタフェースはややお粗末で、将来は変更される可能性があります。 コマンドラインから何でも変更できるようなオプション整備も必要でしょう。 .Pp 現実のドライバはデバッグレベルとして (0 と 1) しかサポートしていません。 デバッグレベル 1 にすると非常に多量の出力を生成するので、 よく注意して使わないと syslog をあふれさせかねません。 .Sh 関連項目 .Xr ioctl 2 , .Xr warn 3 , .Xr fdc 4 .Sh 歴史 .Nm -は現在開発途上です。 +ユーティリティは現在開発途上です。 そのユーザインタフェースと全体機能は、 将来改良あるいは変更される可能性があります。 .Sh 作者 本プログラムは .An J\(:org Wunsch , Dresden から寄贈されました。 diff --git a/ja_JP.eucJP/man/man8/ffsinfo.8 b/ja_JP.eucJP/man/man8/ffsinfo.8 index 29793a4add..2c1f7b0afe 100644 --- a/ja_JP.eucJP/man/man8/ffsinfo.8 +++ b/ja_JP.eucJP/man/man8/ffsinfo.8 @@ -1,158 +1,158 @@ .\" Copyright (c) 2000 Christoph Herrmann, Thomas-Henning von Kamptz .\" Copyright (c) 1980, 1989, 1993 The Regents of the University of California. .\" All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Christoph Herrmann and Thomas-Henning von Kamptz, Munich and Frankfurt. .\" .\" 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 acknowledgment: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors, as well as Christoph .\" Herrmann and Thomas-Henning von Kamptz. .\" 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. .\" .\" $TSHeader: src/sbin/ffsinfo/ffsinfo.8,v 1.3 2000/12/12 19:30:55 tomsoft Exp $ -.\" %FreeBSD: src/sbin/ffsinfo/ffsinfo.8,v 1.6.2.2 2001/08/01 12:01:28 sheldonh Exp % +.\" %FreeBSD src/sbin/ffsinfo/ffsinfo.8,v 1.6.2.3 2002/06/20 23:09:03 charnier Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/ffsinfo.8,v 1.1 2001/08/05 22:17:47 horikawa Exp $ +.\" $FreeBSD$ .Dd September 8, 2000 .Dt FSINFO 8 .Os .Sh 名称 .Nm ffsinfo .Nd 既存の UFS ファイルシステムのすべてのメタ情報をダンプする .Sh 書式 .Nm .Op Fl L .Op Fl g Ar cylinder_group .Op Fl i Ar inode .Op Fl l Ar level .Op Fl o Ar outfile .Ar special | file .Sh 解説 .Nm ffsinfo -は +ユーティリティは .Xr dumpfs 8 -プログラムを拡張したものです。 +ユーティリティを拡張したものです。 .Pp 出力は .Pa outfile ファイルに生成されます。 この時、比較的大きな出力ファイルとなります。 指定したファイルシステムの 2% ほどになることも珍しくありません。 .Pp 以下のオプションが指定できます: .Bl -tag -width indent .It Fl L このオプションを指定すると disklabel のテストを省略します。 ダンプするよう指定されたファイル名が通常のファイルだった場合、 自動的に省略されます。 .It Fl g Ar cylinder_group 指定されたシリンダグループの情報のみダンプするよう制限します。 ここで .Ar 0 は、最初のシリンダグループを意味し、 .Ar -1 は最後のシリンダグループを意味します。 .It Fl i Ar inode 特定の inode の情報のみをダンプするよう制限します。 指定可能な最小の inode は .Ar 2 です。 このオプションが省略されて、シリンダグループが定義されていた場合、 そのシリンダグループ内の inode のみがダンプされます。 .It Fl l Ar level ダンプされる詳細レベルを指定します。 この値のデフォルト値は .Ar 255 で、以下の表の値の .Dq ビット論理和 で表されます: .Pp .Bl -hang -width indent -compact .It Ar 0x001 イニシャルスーパブロック .It Ar 0x002 各シリンダグループ内のスーパブロックのコピー .It Ar 0x004 イニシャルシリンダグループ内のシリンダグループのサマリ情報 .It Ar 0x008 シリンダグループ情報 .It Ar 0x010 inode 割り当てビットマップ .It Ar 0x020 フラグメント割り当てビットマップ .It Ar 0x040 クラスタのマップおよびサマリ情報 .It Ar 0x080 ローテーショナルレイアウトテーブル .It Ar 0x100 inode 情報 .It Ar 0x200 インダイレクトブロックダンプ .El .It Fl o Ar outfile ダンプの出力先ファイルを変更します。 現在のデフォルトは .Pa /var/tmp/ffsinfo です。 .El .Sh 使用例 .Dl ffsinfo -l 1023 /dev/vinum/testvol .Pp は、 .Pa /dev/vinum/testvol のすべての有効な情報をダンプします。 .Sh バグ 現在 .Nm は、マウントされていないファイルシステムのみダンプできます。 マウントされたファイルシステムをダンプしようとしないでください。 システムがパニックするかもしれませんし、 そうするとファイルシステムはもはや使えなくなるでしょう。 .Pp スナップショットも通常のファイルと同じように扱われます。 これらも、何がダンプされるかの総量を独立して制御するために、 スナップショット特有のダンプレベルが設定されるべきです。 またスナップショットをファイルシステムとしてダンプするように 多少拡張することも、おそらく有用でしょう。 .Sh 関連項目 .Xr disklabel 8 , .Xr dumpfs 8 , .Xr fsck 8 , .Xr growfs 8 , .Xr newfs 8 , .Xr tunefs 8 , .Xr vinum 8 .Sh 作者 .An Christoph Herrmann Aq chm@FreeBSD.org .An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org .An The GROWFS team Aq growfs@Tomsoft.COM .Sh 歴史 .Nm -コマンドは +ユーティリティは .Fx 4.4 で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man8/kldload.8 b/ja_JP.eucJP/man/man8/kldload.8 index 46c6fabd4a..a242fcb032 100644 --- a/ja_JP.eucJP/man/man8/kldload.8 +++ b/ja_JP.eucJP/man/man8/kldload.8 @@ -1,81 +1,81 @@ .\" .\" Copyright (c) 1997 Doug Rabson .\" 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. .\" -.\" %FreeBSD: src/sbin/kldload/kldload.8,v 1.7.2.8 2002/01/09 15:24:57 ru Exp % +.\" %FreeBSD src/sbin/kldload/kldload.8,v 1.7.2.9 2002/06/24 23:13:16 keramida Exp % .\" .\" $FreeBSD$ .\" .Dd April 25, 1997 .Dt KLDLOAD 8 .Os .Sh 名称 .Nm kldload .Nd カーネルにファイルをロードする .Sh 書式 .Nm .Op Fl v .Ar filename .Sh 解説 .Nm -はカーネルリンカを用いてファイル +ユーティリティは、カーネルリンカを用いてファイル .Ar filename Ns Pa .ko をカーネルにロードします。 .Pp 以下のオプションが利用できます : .Bl -tag -width indent .It Fl v 出力を冗長にします。 .El .Sh 診断 .Ex -std .Sh モジュールの自動ロード モジュールによっては (ipfw, ipf など)、それらの動作が .Xr rc.conf 5 で有効に設定されていると、ブート時に自動的にロードされます。 .Xr loader.conf 5 に追加することでも、モジュールを自動的にロード可能です。 .Sh 関連ファイル .Bl -tag -width /modules -compact .It Pa /modules ローダブルモジュールを格納するディレクトリ。 モジュールの拡張子は .Pa .ko である必要があります。 .El .Sh 関連項目 .Xr kldload 2 , .Xr loader.conf 5 , .Xr rc.conf 5 , .Xr kldstat 8 , .Xr kldunload 8 .Sh 歴史 .Nm コマンドは .Fx 3.0 に初めて登場し、 .Xr lkm 4 インタフェースを置き換えました。 .Sh 作者 .An Doug Rabson Aq dfr@FreeBSD.org diff --git a/ja_JP.eucJP/man/man8/lpc.8 b/ja_JP.eucJP/man/man8/lpc.8 index 408ced4e31..751c79ac01 100644 --- a/ja_JP.eucJP/man/man8/lpc.8 +++ b/ja_JP.eucJP/man/man8/lpc.8 @@ -1,203 +1,224 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)lpc.8 8.5 (Berkeley) 4/28/95 -.\" %FreeBSD: src/usr.sbin/lpr/lpc/lpc.8,v 1.8.2.7 2002/04/25 21:43:01 gad Exp % +.\" %FreeBSD: src/usr.sbin/lpr/lpc/lpc.8,v 1.8.2.10 2002/06/25 23:08:36 gad Exp % .\" .\" $FreeBSD$ .\" .Dd June 20, 2001 .Dt LPC 8 .Os .Sh 名称 .Nm lpc .Nd ラインプリンタの制御を行う .Sh 書式 .Nm .Op Ar command Op Ar argument ... .Sh 解説 .Nm は、システム管理者がラインプリンタの動作を制御するために使われます。 各ラインプリンタの設定は .Pa /etc/printcap で行います。 .Nm は以下の目的で利用します。 .Bl -bullet -offset indent .It プリンタの利用可能/不可能の設定を行う .It スプールキューへのジョブ投入可能/不可能の設定を行う .It スプールキュー内のジョブの順番を並べ直す .It プリンタ、スプールのキュー、およびプリンタデーモンのステータスを調べる +.It +プリンタキューのステータスメッセージを変更する +(ステータスメッセージは、 +.Xr lpq 1 +ユーティリティを使用してユーザが見ることができます) .El .Pp 引数なしの場合、 .Nm は標準入力からコマンドを読むためにプロンプトを出します。 引数をつけた場合、第 1 引数をコマンドとし、残りの引数を そのコマンドのパラメータと解釈します。 標準入力をリダイレクトして、 .Nm にファイルからコマンドを読み込ませることもできます。 コマンドは略して書くことができます。 利用可能なコマンドを以下に列挙します。 .Pp .Bl -tag -width indent -compact .It Ic \&? Op Ar command ... .It Ic help Op Ar command ... 引数で指定したコマンドの簡単な説明を表示します。引数がないときはコマンド の一覧を表示します。 .Pp .It Ic abort Brq Cm all | Ar printer ローカルホスト上の動作中のスプールデーモンをただちに終了させ、指定した プリンタをプリントアウトできないように ( .Xr lpr 1 が新しいデーモンをスタートさせないように) します。 .Pp .It Ic clean Brq Cm all | Ar printer ローカルマシン上の指定したプリンタのキューから、出力できない (すなわち、 完全なプリンタジョブの形になっていない) テンポラリファイル、データファイル、 コントロールファイルをすべて削除します。 本コマンドは、各プリンタキューに対し、 スプールディレクトリ中の .Pa core ファイルも探し、 発見されたものを列挙します。 本コマンドは .Pa core ファイルを削除しません。 .Ic tclean コマンドも参照してください。 .Pp .It Ic disable Brq Cm all | Ar printer 指定したプリンタのキューをオフにします。これにより、 .Xr lpr 1 によって新しいプリンタジョブがキューに入らないようになります。 .Pp +.It Ic down Bro Cm all | Ar printer ... Brc Cm -msg Ar message ... .It Ic down Bro Cm all | Ar printer Brc Ar message ... 指定したプリンタのキューをオフにし、プリントアウトできないようにし、 プリンタのステータスファイルに .Ar message -を書きます。メッセージは引用符で囲む必要はなく、残りの引数は +を書きます。 +複数のプリンタキューを指定する場合、 +新規ステータスメッセージとなるテキストとプリンタリストを分離するために、 +.Ic -msg +引数が必要です。 +メッセージは引用符で囲む必要はなく、残りの引数は .Xr echo 1 と同様に扱われます。通常、この コマンドはプリンタをダウンさせ、ユーザに対しそのダウンの理由を .Xr lpq 1 -によって説明させるために使われます。 +ユーティリティによって説明させるために使われます。 .Pp .It Ic enable Brq Cm all | Ar printer 指定したプリンタ用のキューのスプーリングを行うようにします。これは、 .Xr lpr 1 で新しいプリンタジョブをスプールキューに挿入することができるよ うにします。 .Pp .It Ic exit .It Ic quit .Nm を終了させます。 .Pp .It Ic restart Brq Cm all | Ar printer 新しいプリンタデーモンの再スタートを試みます。このコマンドは、異常な 状態になって突然デーモンが死に、キュー内にジョブが残ったままになった場合に 有効です。この状態が起きたときには、 .Xr lpq 1 は現在デーモンが動いていないことを報告します。 もしあなたがスーパユーザなら、現在動いているデーモンを先に殺してください (つまり、動かなくなったデーモンを殺してから再スタートさせるわけです)。 .Pp +.It Ic setstatus Bro Cm all | Ar printer Brc Cm -msg Ar message ... +指定したプリンタのステータスメッセージを設定します。 +新規ステータスメッセージとなるテキストとプリンタリストを分離するために、 +.Ic -msg +引数が必要です。 +印刷を無効化した後にプリンタキューがもはやアクティブではなく、 +.Xr lpq 1 +ユーティリティの出力中にユーザが見るメッセージを変更したい場合、 +通常このコマンドを使用して、ステータスメッセージを変更します。 +.Pp .It Ic start Brq Cm all | Ar printer 指定したプリンタを出力可能にしてスプールデーモンをスタートさせます。 .Pp .It Ic status Brq Cm all | Ar printer ローカルマシン上のデーモンとキューの状態を表示します。 .Pp .It Ic stop Brq Cm all | Ar printer 現行のジョブが終了したあとでデーモンのスプーリングをストップさせ、 プリントアウトできないようにします。 .Pp .It Ic tclean Brq Cm all | Ar printer 本コマンドは、 .Ic clean コマンドのテスト実行を行います。 同じチェックが行われますが、同様の .Ic clean コマンドが入力された場合に実行する事柄を、本コマンドは表示します。 本コマンドは、いかなるファイルも削除しません。 .Ic clean は特権コマンドですが、 .Ic tclean は制限がありません。 .Pp .It Ic topq Ar printer Xo .Op Ar jobnum ... .Op Ar user ... .Xc 引数に並べた順番で、ジョブをキューの先頭に移動させます。 .Pp .It Ic up Brq Cm all | Ar printer すべての状態を可能状態(enable)にし、新しいプリンタデーモンをスタートさせます。 .Ic down の逆です。 .El .Sh 関連ファイル .Bl -tag -width /var/spool/*/lockx -compact .It Pa /etc/printcap プリンタの設定を記述するファイル .It Pa /var/spool/* スプールディレクトリ .It Pa /var/spool/*/lock プリンタキューの制御を行うためのロックファイル .El .Sh 関連項目 .Xr lpq 1 , .Xr lpr 1 , .Xr lprm 1 , .Xr printcap 5 , .Xr chkprintcap 8 , .Xr lpd 8 .Sh 診断 .Bl -diag .It "?Ambiguous command" コマンド指定が省略し過ぎのため、複数のコマンドにマッチしています。 .It "?Invalid command" マッチするコマンドがありません。 .It "?Privileged command" "operator" グループのメンバか root でなければこのコマンドは 実行できません。 .El .Sh 歴史 .Nm コマンドは .Bx 4.2 から登場しました。 diff --git a/ja_JP.eucJP/man/man8/mailstats.8 b/ja_JP.eucJP/man/man8/mailstats.8 index 12539e3818..44b2e71a29 100644 --- a/ja_JP.eucJP/man/man8/mailstats.8 +++ b/ja_JP.eucJP/man/man8/mailstats.8 @@ -1,110 +1,115 @@ .\" Copyright (c) 1998-2002 Sendmail, Inc. and its suppliers. .\" All rights reserved. .\" .\" By using this file, you agree to the terms and conditions set .\" forth in the LICENSE file which can be found at the top level of .\" the sendmail distribution. .\" .\" -.\" $Id: mailstats.8,v 1.13 2002-04-29 01:09:00 horikawa Exp $ +.\" $Id: mailstats.8,v 8.30 2002/04/12 00:42:33 ca Exp % .\" .\" $FreeBSD$ -.TH MAILSTATS 8 "$Date: 2002-04-29 01:09:00 $" +.TH MAILSTATS 8 "$Date: 2002-07-21 05:44:33 $" .SH 名称 .B mailstats \- メールの統計情報を表示する .SH 書式 .B mailstats -.RB [ \-o "] [" \-p "] [" \-P ] +.RB [ \-c "] [" \-o "] [" \-p "] [" \-P ] .RB [ \-C .IR cffile ] .RB [ \-f .IR stfile ] .SH 解説 .B mailstats は、現在のメールの統計情報を表示します。 .PP まず、統計が開始された時刻が ctime(3) で指定されるフォーマットで表示されます。 次に、各メーラの状態が 1 行で表示されます。 それぞれ空白で区切られた次のフィールドからなります: .sp .RS .PD 0.2v .TP 1.2i .B M メーラ番号。 .TP .B msgsfr メーラからのメッセージ数。 .TP .B bytes_from メーラからのキロバイト数。 .TP .B msgsto メーラへのメッセージ数。 .TP .B bytes_to メーラへのキロバイト数。 .TP .B msgsrej (check_* ルールセットによって) 拒否されたメッセージ数。 .TP .B msgsdis (check_* ルールセットによって) 捨てられたメッセージ数。 .TP .B Mailer メーラ名。 .PD .RE .PP この表示の後、 すべてのメーラの総計行が表示されます (前に ``T'' が付きます)。 これらは、等号 (``='') 文字のみからなる行によりその前の情報と分けられます。 文字 ``C'' が前に付く他の行は、TCP 接続数を示します。 .PP オプションは以下の通りです: .TP .B \-C デフォルトの .B sendmail 設定 ファイルの代りに指定されたファイルを読みます。 .TP +.B \-c +デフォルトの +.B sendmail +設定ファイルの代りに submit.cf を使用します。 +.TP .B \-f .B sendmail 設定 ファイルで指定されている統計情報ファイルの代りに、 指定された統計情報ファイルを読みます。 .TP .B \-P プログラムが読み取る形式で情報を出力しますが、統計情報をクリアしません。 .TP .B \-p プログラムが読み取る形式で情報を出力し、統計情報をクリアします。 .TP .B \-o 出力においてメーラ名を表示しません。 .PP .B mailstats は成功時には 0 で、エラー時には >0 で終了します。 .SH 関連ファイル .PD 0.2v .TP 2.5i /etc/mail/sendmail.cf デフォルトの .B sendmail 設定 ファイル .TP /etc/mail/statistics デフォルトの .B sendmail 統計情報ファイル .PD .SH 関連項目 mailq(1), sendmail(8) diff --git a/ja_JP.eucJP/man/man8/ntpd.8 b/ja_JP.eucJP/man/man8/ntpd.8 index 19b8be6d50..8cab4fe9af 100644 --- a/ja_JP.eucJP/man/man8/ntpd.8 +++ b/ja_JP.eucJP/man/man8/ntpd.8 @@ -1,510 +1,510 @@ .\" -.\" %FreeBSD: src/usr.sbin/ntp/doc/ntpd.8,v 1.4.2.3 2001/12/21 17:42:33 roberto Exp % +.\" %FreeBSD: src/usr.sbin/ntp/doc/ntpd.8,v 1.4.2.4 2002/06/23 10:50:41 schweikh Exp % .\" .\" $FreeBSD$ .\" WORD: key file 鍵ファイル .\" WORD: key number 鍵番号 .\" WORD: symmetric active 対称的アクティブ .\" WORD: symmetric passive 対称的パッシブ .\" WORD: slew (時刻を)微調整する(時刻を少しずつずらすこと) .\" WORD: step (時計を)設定する(外部から得た時刻をセットすること) .\" WORD: drift file ドリフトファイル(周波数ファイルとも称されている) .\" WORD: poll ポーリングする(動詞) .\" WORD: wander (時刻の)逸脱 (ずれでさ迷い出ること) .\" WORD: one-shot mode 単発モード (起動時1回だけ時刻調整するモード) .\" WORD: discipline loop (時刻)修正ループ .\" .Dd August 2, 2001 .Dt NTPD 8 .Os .Sh 名称 .Nm ntpd .Nd Network Time Protocol (NTP) デーモン .Sh 書式 .Nm .Op Fl aAbdgLmnPqx .Op Fl c Ar conffile .Op Fl D Ar level .Op Fl f Ar driftfile .Op Fl k Ar keyfile .Op Fl l Ar logfile .Op Fl N Cm high .Op Fl p Ar pidfile .Op Fl r Ar broadcastdelay .Op Fl s Ar statsdir .Op Fl t Ar key .Op Fl v Ar variable .Op Fl V Ar variable .Sh 解説 .Nm は、インターネットの標準時間サーバと同期をとって、システム時刻 (time of day) を設定し維持するオペレーティングシステムデーモンです。 .Nm は、Network Time Protocol (NTP) バージョン 4 の完全な実装となっていますが、RFC-1305 で定義されているバージョン 3 に対する互換性も保っています。加えて、 各々 RFC-1059 と RFC-1119 で定義 されているバージョン 1 とバージョン 2 に対する互換性も保っています。 .Pp .Nm は多くの計算を 64-bit 浮動小数点演算で行ない、 究極の精度である約 232 ピコ秒を保つ必要があるときだけ、比較的扱いにくい 64-bit 固定小数点操作を行ないます。 現在の普通のワークステーションやネットワークではこの究極の精度は 達成できませんが、この精度は将来のギガヘルツ級の CPU クロックや ギガビット LAN において必要となるでしょう。 .Pp 通常、 .Nm は、起動時に設定ファイル .Xr ntp.conf 5 から読み込み、同期ソースや動作モードを決めます。 また、機能が限定されますが、コマンドラインから全ての動作を指定することにより、 設定ファイルを使わずに実行することもできます。 これは、 ローカルホストをブロードキャスト/マルチキャストクライアントとして 設定し、全ての通信相手を、実行時にブロードキャストを 待受け (listen) て決定する時には、特に有益です。 .Pp .Nm に NetInfo サポートが組み込まれている場合、 デフォルトの .Xr ntp.conf 5 ファイルが読み込めず、また .Fl c オプションによるファイルの指定もされていないときに、 .Nm は設定を NetInfo より読み込もうとします。 .Pp .Nm の実行中は、 .Xr ntpq 8 および .Xr ntpdc 8 ユーティリティプログラムを使用することで、 さまざまな .Nm 内部変数を表示したり、 設定オプションを変更できます。 .Pp .Nm は起動時に .Xr umask 2 の値を調べ、もしそれが 0 ならば、 .Xr umask 2 を 022 に設定します。 .Pp 以下にあげる引数が使用可能です: .Bl -tag -width indent .It Fl a 認証モードを有効にします (デフォルト)。 .It Fl A 認証モード無効にします。 .It Fl b NTP のブロードキャストメッセージを使って同期します。 .It Fl c Ar conffile 設定ファイルの名前とパスを指定します。 (netinfo を無効にする?) .It Fl d デバッグモードを指定します。このフラグは何回指定してもかまいませんが、 回数が多いほど表示がより詳細になります。 .It Fl D Ar level デバッグレベルを直接指定します。 .It Fl f Ar driftfile ドリフトファイルの名前とパスを指定します。 .It Fl g 通常、 .Nm はオフセットが正気限界 (sanity limit) を越えている場合は終了します。 この値のデフォルトは 1000 秒です。 正気限界を 0 に設定した場合、正気限界のチェックを行なわず、 オフセットがどのような値でも受理します。 このオプションはこの制限を無視し、 どの時刻にも制限なく設定できるようにします。 しかしこれは一度のみ起り得ます。 この後は、制限を超過すると、デーモンは終了します。 このオプションは、 .Fl q オプションとともに使用することができます。 .It Fl k Ar keyfile NTP の認証鍵を含むファイルの名前とパスを指定します。 .It Fl l Ar logfile ログファイルの名前とパスを指定します。 デフォルトはシステムログ機能です。 .It Fl L 仮想 IP を待ち受けます。 .It Fl m 224.0.1.1 の IP マルチキャストグループアドレス上の NTP マルチキャストメッセージを利用して同期します (マルチキャストカーネルが必要になります)。 .It Fl n フォークしません。 .It Fl N Ar priority オペレーティングシステムの許容範囲で、 .Nm を高優先度で実行させます。 .It Fl p Ar pidfile .Nm のプロセス ID を記録するためのファイル名とパスを指定します。 .It Fl P オペレーティングシステムによって設定される優先度制限を無視します。 意気地なしには使用を推奨しません。 .It Fl q 最初に時刻を設定した直後に .Nm の実行を終了します。この挙動は、引退させるべきプログラム .Xr ntpdate 8 の挙動を真似したものです。このオプションといっしょに、 .Fl g オプションと .Fl x オプションとを指定することができます。 .It Fl r Ar broadcastdelay ブロードキャスト/マルチキャストサーバからこのコンピュータ間の デフォルト伝播遅延を指定します。 このオプションはプロトコルによって自動的に遅延を計算できない場合にのみ 必要となります。 .It Fl s Ar statsdir 統計機能によって作成されるファイルのディレクトリパスを指定します。 .It Fl t Ar key 鍵番号を信頼できる鍵 (trusted key) のリストに付け加えます。 .It Fl v Ar variable .It Fl V Ar variable デフォルトでリストされるシステム変数を追加します。 .It Fl x 通常は、オフセットが設定閾値 (デフォルトは 128 ms) より小さい場合、 時刻は徐々に微調整 (slew) されます。設定閾値より大きい場合に、 単に時刻設定 (step) されます。 このオプションは全ての場合において微調整するように強制します。 設定閾値を 0 に設定した場合、 .Fl x オプションの有無に関わらず、また、値に関わらず、全てのオフセットで 時刻設定します。 大きな時刻誤差や周波数誤差を扱うために設計された時計状態機械を通さずに 時刻合わせするため、一般には、これはうまいやり方ではありません。 注意: 微調整の速度は 0.5 ms/s までに 制限されていますので、1 秒調節するのに 2000 秒の 償却期間が必要です。 このため、たくさんの秒数を調節するには、 償却に数時間や数日を要することもあります。 このオプションは .Fl q オプションといっしょに使用することができます。 .El .Ss "NTP はどのように動作するか" .Nm プログラムは、設定した 1 個以上のサーバと、指定したポーリング 間隔でメッセージ交換を行ないます。実行を開始する際に、 最初の起動か何度目かの起動かによって、このプログラムは これらのサーバの多数といくつかのメッセージの交換を必要とします。 その結果、 信号処理と緩和アルゴリズムによりデータを蓄積し、データを整え、 時刻設定を行ないます。 バーストからネットワークを守るため、各サーバに対する 初期ポーリング間隔は 0 から 16 秒の間のランダムな値で遅らされます。 デフォルトの初期ポーリング間隔は 64 秒です。時計を設定するまでに 数分を費やしてしまうことがあります。 .Xr ntp.conf 5 に記述されているように、 設定コマンド .Ic server で指定するキーワード .Cm iburst を使い、時計設定するまでの初期遅延を減少させることができます。 .Pp 現代のオペレーティングシステムとハードウエアの大部分は、 time-of-year (TOY) チップを持っており、電源断の間も時刻を 保持しています。 マシンが起動すると、このチップを使いオペレーティングシステムの 時刻を初期化します。マシンが NTP サーバに対して時刻同期を取った 後で、オペレーティングシステムはそのチップの時刻を必要に応じ 修正します。TOY チップが存在しないか、何らかの理由で TOY チップの 時刻とサーバの時刻の違いが 1000 秒より大きい場合、 .Nm は何か決定的にまずいことが生じたと仮定します。この場合に意味の ある動作は、オペレータが介在し手動で時計を設定することです。 この場合、 .Nm はパニックメッセージをシステムログに出力し実行終了します。 .Fl g フラグはこのチェックを上書きし、チップの時刻に関わらずサーバの 時刻が時計に設定されます。しかしながら、CMOS バッテリの故障や クロックカウンタの不調などのハードウエアの故障から 身を守るために、一度クロックを設定してから誤差が 1000 秒を越えた 場合、いずれにしても .Nm は実行終了します。 .Pp 通常の状態では、 .Nm は、時刻が実質的に連続に推移し不連続が生じないように、 時計を僅かな刻みで修正します。ネットワークの輻輳が著しい状態では、 往復遅延時間の変動 (jitter) が 3 秒を越え、同期距離 (これは、 往復遅延時間の半分と誤差量の項の和) が著しく大きくなる可能性が あります。 128ms 以下のサンプルオフセットが存在しない時間間隔が 900 秒を越えない かぎり、 .Nm のアルゴリズムでは、128ms を越えるサンプルオフセットを捨てます。 オフセットがどのような値であっても、その後最初に採取されるサンプルが 示す値で時計を設定します。現実には、誤って時刻を設定し 間違った警告を発生する率は、この処理により ほとんどなくなったと言ってもいいほどに減少されます。 .Pp この動作の結果として、一度時計が設定されると、ネットワーク経路の 輻輳と遅延時間変動が極めて大きな場合であっても、 128ms を越えた変動は極めてまれにしか生じません。 ときどき、特に .Nm が最初に起動したときには、誤差が 128ms を越えることがあります。 ローカル時計の時刻がサーバと比べ 128 秒以上先に進んでいる場合、 これにより、逆向きの時計設定が生じることがあります。 アプリケーションによっては、この動作に耐えられないものもあるかも しれません。 コマンド行に .Fl x オプションを含めている場合、時計の設定は決して行なわれません。 時刻の微調整のみを行ないます。 .Pp .Fl x オプションを使うと決める前に、それによる問題を注意深く調査する 必要があります。 可能な最大微調整速度は 500 parts-per-million (PPM) に 制限されています。これは、NTP プロトコル設計とアルゴリズム設計が 根拠とする正しさの原理による結論です。 結果として、ローカル時計が許容可能なオフセットに収束するまでに長い時間を 必要とする可能性があります。時計が許容可能な範囲外にある場合、1秒につき 約 2,000 秒が必要となります。 その間は、ローカル時計は他のネットワーク時計のどれとも一貫性はなく、 このシステムは、正しく同期したネットワーク時間を必要とする 分散アプリケーションに利用することができません。 .Pp 上記の予防策にも関わらず、大きな周波数誤差が存在する場合に、ときどき、 結果として時間オフセットは 128ms の範囲を逸脱し、その際に、 時刻設定または時刻の微調整が必要となります。そのような時刻修正の あと、最初のサンプルも受理可能な範囲外となるほど周波数誤差が大きい ならば、 .Nm は、 .Pa ntp.drift ファイルが存在しない場合と同じ状態に入ります。 この動作の意図は、周波数を素早く補正し、通常の追跡モードに動作を 戻すことにあります。最も極端な場合 (time.ien.it のことを思い出し ますが) として、時刻設定/微調整による時刻補正と、その後 周波数補正とが生じることもあります。 この動作は、このような場合に、サーバを設定する際にキーワード .Cm burst を使う助けになります。 .Ss 周波数の修正 起動時の .Nm の動作は、周波数ファイル (普通は、 .Pa ntp.drift ) が存在するかどうかに依存します。 このファイルは、時計の周波数誤差の最新の予測値が含まれます。 .Nm が起動され、このファイルが存在しないとき、 .Nm はシステムクロック発振器の時刻誤差と周波数誤差に 急速に適合するために特に設計された特殊モードに入ります。このモードには 約 15 分を必要とします。その後、時刻と周波数は公称値に設定され、 .Nm は通常のモードに入ります。このモードでは時刻と周波数は連続的に サーバに対し追従します。1 時間後、周波数ファイルが生成され、現在の 周波数オフセットが書き込まれます。 .Nm が起動され、このファイルが存在するとき、 .Nm の周波数はこのファイルの値から初期化され、直ちに通常のモードに 入ります。その後、1時間間隔で、その時点の周波数オフセットが このファイルに書き込まれます。 .Ss 動作モード .Nm はいくつかのモードのいずれかで動作します。それらのモードとしては、 .Qq アソシエーション管理 のページ ( .Pa /usr/share/doc/ntp に提供された HTML 文書の一部として利用可能です) で示したように、 対称的アクティブ/パッシブ、クライアント/サーバ、 ブロードキャスト/マルチキャスト、メニーキャストがあります。 本プログラムは、普通は連続的に動作します。その間、小さな周波数変化を 監視し、時計を究極の精度に向けて調整します。 しかしながら、単発モード (one-time mode) で動作することもあります。 このモードでは、時刻が外部サーバから設定され、周波数は以前に 記録しておいた周波数ファイルから設定されます。 ブロードキャスト/マルチキャスト、もしくはメニーキャストクライアントは、 リモートサーバを発見し、サーバクライアント間の伝播遅延補正係数を 計算し、自分自身を自動的に設定することができます。このモードにより、 その環境固有の設定を詳細にわたり指定することなしに、 多数のワークステーションを配備することができます。 .Pp デフォルトでは、 .Nm は、連続モードで動作します。このモードでは、複雑な状態機械により 決定される時間間隔で、いくつかある外部サーバのそれぞれに対し ポーリングを掛けます。状態機械は、それに付随して 往復遅延時間の変動と発振器周波数の逸脱 (wander) を測定し、 ヒューリスティックなアルゴリズムを用いて最適なポーリング間隔を 決定します。 通常は、ほとんどのオペレーティングシステム環境で、この状態機械は 64 秒の時間間隔で開始し、状況に応じ、1024 秒まで段階的に増加させます。 サーバへのアクセス集中を避けるため、微小なランダム偏差も入れて あります。加えて、しばらくの間サーバが到達できない状態になる場合には、 ネットワークのオーバーヘッドを減らすために、 ポーリング間隔を 1024 秒まで段階的に増加させます。 .Pp いくつかの場合では、 .Nm が連続モードで動作することが現実的でないことがあります。この場合、 これまでは、普通の対応方法として、 .Xr cron 8 ジョブから .Xr ntpdate 8 プログラムを 指定した時刻に実行させていましたが、 このプログラムは、 .Nm が持つ 信号処理、誤差チェック、緩和アルゴリズムに関する練り込みを 持っていません。 .Fl q オプションはこの目的のためにあります。 このオプションを設定することにより .Nm は、時計を 1 回設定した直後に実行終了します。時計の初期設定の手順は、 連続モードと同じものです。ほとんどの応用では、 .Ic server 設定コマンドで、 .Cm iburst キーワードを指定しようとすることになると思います。 このキーワードにより、メッセージが連続して矢継ぎ早に交換され、 データが整えられ、時計はおよそ 1 分間で設定されます。 適当な期間、喪に服した後に、 .Xr ntpdate 8 プログラムは引退ということになると思います。 .Pp 純正の Solaris, Tru64, Linux, .Fx の場合がそうですが、 時計周波数修正についてカーネルサポートが利用可能な場合には、 時計周波数の修正という有益な機能が利用可能です。まず、 .Nm は、選択されたサーバに対し連続モードで動作し、 固有の時計周波数オフセットを測定し、周波数ファイルに記録します。 周波数とオフセットが定常状態になるまでに数時間掛かることも あります。そのあと、 .Nm は停止し、必要に応じ単発モードで動作します。プログラム開始時には、 周波数はファイルから読み込みカーネル内周波数を初期化します。 .\"X.Ss "Poll Interval Control" .Ss ポーリング間隔制御 このバージョンの NTP は、測定された時間変動と逸脱とに合致した レベルの同期の質を維持するため、複雑な状態機械を含んでいます。 精度を増大させる処理には、時間間隔を減少させる目的や、 ネットワークのオーバーヘッドを減らすために時間間隔を増大させる目的の 方法がいくつかあります。 しかし、デフォルト最小値の 64 秒からデフォルト最大値の 1024 秒の 間のポーリング調整範囲の変更の結果について注意深く考慮することを、 ユーザには推奨します。デフォルト最小値は .Ic tinker .Cm minpoll コマンドを用いて 16 秒以上の範囲で変更することができます。 設定コマンドの .Cm minpoll オプションで上書き設定されない限り、 設定されたアソシエーションのすべてでこの値が使用されます。 注意: ポーリング間隔が 64 秒より小さい場合、ほとんどの デバイスドライバは正しく動作しません。また、ブロードキャストサーバと メニーキャストクライアントのアソシエーションも、上書き設定しない限り デフォルト値を使用します。 .Pp ダイアルアップサービスや従量性課金サービスなどの場合、 最小間隔を数 10 分にし、最大間隔を 1 日程度に増やすと便利かも しれません。 通常の動作条件では、時計修正ループがひとたび安定化すると、 時間間隔は最小値から最大値まで段階的に増えてゆきます。 しかし、これは、修正ループが誤差を修正できる程度まで 固有時計周波数誤差が小さいことが前提です。 ループの誤差補足可能範囲は、64 秒の間隔において 500 PPM で、 間隔を 2 倍にするごとに 2 の因数で減少します。 例えば、最小値 1,024 秒では、誤差補足可能範囲は 31 PPM にしか 過ぎません。固有誤差がこの値より大きい場合、ドリフトファイル (drift file) .Pa ntp.drift は、この制限以下の剰余誤差を減少させるため特別扱いせねばなりません。 この状態が一度生じると、ドリフトファイルは自動的に 1 時間に 1 回 更新され、それ以後のデーモンの再起動の際に周波数を初期化できるように なります。 .Ss "スーハーフィルタ(huff-n'-puff filter)" 電話線モデム経由で相当量のデータをダウンロード/アップロードするような 使い方では、時刻維持の品質が著しく低下する可能性があります。これは、 2 方向の送信における遅延の差が極めて大きくなる可能性があるからです。 多くの場合、時刻誤差が明らかに大きくなり、設定修正の閾値を越え、 データ転送の後もしくは途中に設定による補正が生じます。 .Pp スーハーフィルタは、これらの場合に目立つ時間オフセットを補正するために 設計されました。これは、他のトラフィックが存在しないときの伝播遅延の 知識に依存します。普通の状況でこれが生じるのは業務以外の時間です。 このフィルタは、最近の時間間隔で通常は数時間測定した中で 最小遅延を記憶するシフトレジスタを保持します。 遅延が厳しい状況では、このフィルタは、 問題の遅延と最小遅延の差と、オフセットの符号とを用いて 問題のオフセットを補正します。 このフィルタの名前は、オフセットの符号に依存した、 負の補正 (ハーと吹く) と正の補正 (プーと吹く) を表しています。 .Pp このフィルタは .Ic tinker コマンドと .Cm huffpuff キーワードにより有効にされます。これは、 .Xr ntp.conf 5 に詳しい説明があります。 .Sh 関連ファイル .Bl -tag -width /etc/ntp.drift -compact .It Pa /etc/ntp.conf デフォルトの設定ファイル名 .It Pa /etc/ntp.drift デフォルトのドリフトファイル名 .It Pa /etc/ntp.keys デフォルトの鍵ファイル名 .El .Sh 関連項目 .Xr ntp.conf 5 , .Xr ntpdate 8 , .Xr ntpdc 8 , .Xr ntpq 8 .Pp 提供されているマニュアルページに加えて、 包括的なドキュメントが world wide web 上の .Li http://www.ntp.org/ にあります。 このドキュメントのスナップショットが HTML 形式で .Pa /usr/share/doc/ntp にあります。 .Rs .%A David L. Mills .%T Network Time Protocol (Version 1) .%O RFC1059 .Re .Rs .%A David L. Mills .%T Network Time Protocol (Version 2) .%O RFC1119 .Re .Rs .%A David L. Mills .%T Network Time Protocol (Version 3) .%O RFC1305 .Re .Sh バグ .Nm はかなり大きくなってしまいました。巨大とは言いませんが、 ワークステーションで高優先度で実行する .Nm として望ましい大きさを超えてしまいました。 特に、階層数 (stratum) の大きいワークステーションよりは、 高負荷のプライマリサーバにあわせて、 かさばる凝った特徴の多くが設計されているからです。 diff --git a/ja_JP.eucJP/man/man8/renice.8 b/ja_JP.eucJP/man/man8/renice.8 index a129dacaec..2220ce2bd2 100644 --- a/ja_JP.eucJP/man/man8/renice.8 +++ b/ja_JP.eucJP/man/man8/renice.8 @@ -1,125 +1,124 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" @(#)renice.8 8.1 (Berkeley) 6/9/93 -.\" %FreeBSD: src/usr.bin/renice/renice.8,v 1.5.2.4 2001/08/16 13:17:01 ru Exp % +.\" %FreeBSD: src/usr.bin/renice/renice.8,v 1.5.2.5 2002/06/17 23:58:46 tjr Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/renice.8,v 1.10 2001/08/10 02:12:55 horikawa Exp $ +.\" $FreeBSD$ .\" .Dd June 9, 1993 .Dt RENICE 8 .Os .Sh 名称 .Nm renice .Nd 走行中のプロセスの優先度を変更する .Sh 書式 .Nm -.Ar priority -.Oo -.Op Fl p -.Ar pid ... -.Oc -.Oo -.Op Fl g -.Ar pgrp ... -.Oc -.Oo -.Op Fl u -.Ar user ... -.Oc +.Op Ar priority | Op Fl n Ar increment +.Op Oo Fl p Oc Ar pid ... +.Op Oo Fl g Oc Ar pgrp ... +.Op Oo Fl u Oc Ar user ... .Sh 解説 .Nm は、1 つ以上の走行中プロセスのスケジュール優先度を変更します。 priority に後続するパラメータ .Ar who -は、プロセス ID か、プロセスグループ ID か、ユーザ名として解釈されます。 +は、プロセス ID か、プロセスグループ ID か、ユーザ ID か、 +ユーザ名として解釈されます。 プロセスグループに対する .Nm の実行は、そのグループに属するすべてのプロセスの優先度を変化させます。 ユーザ名に対する .Nm の実行は、そのユーザが所有するすべてのプロセスの優先度を変化させます。 デフォルトでは、プロセス ID で指定したプロセスのみが影響を受けます。 .Pp .Nm にてサポートされるオプションは以下のとおりです: .Bl -tag -width Ds .It Fl g .Ar who パラメータをプロセスグループ ID であると解釈させます。 +.It Fl n +指定されたプロセスを指定された優先度へ変更するのではなく、 +後続する引数を各プロセスの現在の優先度に対する増加値として解釈します。 .It Fl u .Ar who パラメータをユーザ名であると解釈させます。 .It Fl p .Ar who -パラメータをプロセス ID であると解釈させます (デフォルト)。 +パラメータをユーザ名またはプロセス ID であると解釈させます (デフォルト)。 .El .Pp たとえば、 -.Bd -literal -offset -renice +1 987 -u daemon root -p 32 -.Ed +.Pp +.Dl "renice +1 987 -u daemon root -p 32" .Pp は、プロセス ID が 987, 32 のプロセスと、 ユーザ daemon, root が所有するすべてのプロセスの優先度を変更します。 .Pp スーパユーザ以外のユーザは所有するプロセスについてのみ変更が可能で、 プロセスの ``nice 値'' を 0 から .Dv PRIO_MAX (20) の範囲内で単調に増加させることができます。 (これによりシステム管理者による命令が無効になるのを防ぎます。) スーパユーザは、すべてのプロセスの優先度を .Dv PRIO_MIN (\-20) から .Dv PRIO_MAX (20) の範囲で自由に変更することができます。 よく用いられる値としては以下のものがあります: 20 (システム内のほかのプロセスすべてが走行しないときのみ走行する)、 0 (``基準'' となるスケジュール優先度)、 適当な負の値 (そのプロセスを素早く実行させる) .Sh 関連ファイル .Bl -tag -width /etc/passwd -compact .It Pa /etc/passwd ユーザ名とユーザ ID を関連づける .El .Sh 関連項目 .Xr nice 1 , .Xr rtprio 1 , .Xr getpriority 2 , .Xr setpriority 2 -.Sh バグ -スーパユーザ以外のユーザは、たとえ以前に優先度を下げたプロセスであって -も優先度を上げることはできません。 +.Sh 規格 +.Nm +ユーティリティは +.St -p1003.1-2001 +に適合しています。 .Sh 歴史 .Nm は .Bx 4.0 で追加されました。 +.Sh バグ +スーパユーザ以外のユーザは、たとえ以前に優先度を下げたプロセスであって +も優先度を上げることはできません。 diff --git a/ja_JP.eucJP/man/man8/rpcinfo.8 b/ja_JP.eucJP/man/man8/rpcinfo.8 index fb18df68eb..5c51f72e78 100644 --- a/ja_JP.eucJP/man/man8/rpcinfo.8 +++ b/ja_JP.eucJP/man/man8/rpcinfo.8 @@ -1,157 +1,157 @@ .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI -.\" %FreeBSD: src/usr.bin/rpcinfo/rpcinfo.8,v 1.5.2.1 2000/12/08 15:14:03 ru Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/rpcinfo.8,v 1.7 2001/05/14 01:09:58 horikawa Exp $ +.\" %FreeBSD: src/usr.bin/rpcinfo/rpcinfo.8,v 1.5.2.2 2002/06/21 15:28:53 charnier Exp % +.\" $FreeBSD$ .\" .Dd December 17, 1987 .Dt RPCINFO 8 .Os .Sh 名称 .Nm rpcinfo .Nd RPC に関する情報を表示する .Sh 書式 .Nm .Fl p .Op Ar host .Nm .Op Fl n Ar portnum .Fl u Ar host .Ar program .Op Ar version .Nm .Op Fl n Ar portnum .Fl t Ar host .Ar program .Op Ar version .Nm .Fl b .Ar program version .Nm .Fl d .Ar program version .Sh 解説 .Nm -は、 +ユーティリティは、 .Tn RPC サーバに対して .Tn RPC 呼び出しを行ない、得られた情報を表示します。 .Sh オプション .Bl -tag -width indent .It Fl p 指定されたホスト上のポートマッパーを検出し、そこに登録されている全ての .Tn RPC プログラムの一覧を出力します。 .Ar host が指定されない場合、 .Xr hostname 1 コマンドをオプション無しで実行した時に出力されるホスト名が .Ar host として採用されます。 .It Fl u .Tn UDP プロトコルを用いて、指定したホスト上のプログラムの手続き 0 に対して .Tn RPC 呼び出しを行ないます。そして、応答があったかどうかを報告します。 .It Fl t .Tn TCP プロトコルを用いて、指定したホスト上のプログラムの手続き 0 に対して .Tn RPC 呼び出しを行ないます。そして、応答があったかどうかを報告します。 .It Fl n .Fl t や .Fl u オプション使用時に、ポートマッパーに与えられたポート番号のかわり に、引数 .Ar portnum で指定した番号をポート番号として用います。 .It Fl b .Tn UDP プロトコルを用いて、引数 .Ar program および .Ar version で指定したプログラムに対し、手続き 0 に .Tn RPC ブロードキャストを行ないます。そして、応答のあった全てのホストにつ いてのレポートを出力します。 .It Fl d 引数 .Ar program および .Ar version で指定したプログラムの .Tn RPC サービスへの登録を削除します。 本オプションは、スーパユーザのみ指定可能です。 .El .Pp 引数 .Ar program は、名称・番号のいずれでも構いません。 .Pp もし引数 .Ar version が指定されると、 .Nm は引数 .Ar program で指定されたプログラムのそのバージョンの呼び出しを試みます。 .Ar version が指定されなかった場合、 .Nm は .Ar program で指定されたプログラムに対してバージョン 0 呼びだしを行なうことで、 全ての登録されているバージョンについて検索を試みます (バージョン 0 は存在しないと仮定してのものです。もし存在すれば .Ar rpcinfo は極端に高いバージョンを使って情報を得ようとします)。 .Fl b および .Fl d オプションには、バージョン番号の指定が必要であることに注意して下さい。 .Sh 使用例 ローカルマシンに登録されている全ての .Tn RPC サービスを見るには、次のようにします: .Pp .Dl example% rpcinfo -p .Pp ホスト名 klaxon 上に登録されている全ての .Tn RPC サービスを見るには、次のようにします: .Pp .Dl example% rpcinfo -p klaxon .Pp NIS サービス (Yellow Page サービス) が稼働している ローカルネットワーク上に接続されているマシンすべてを表示するには、 次のようにします: .Pp .Dl example% rpcinfo -b ypserv 'version' | uniq .Pp \&'version' のところには、上記 .Fl p オプションの結果から得られた現在の NIS サービス (Yellow Page サービス) のバージョンを使います。 .Pp バージョン 1 の .Nm walld サービスを削除するには、次のようにします: .Pp .Dl example% rpcinfo -d walld 1 .Sh 関連項目 .Xr rpc 5 , .Xr portmap 8 .Rs .%T "RPC Programming Guide" .Re .Sh バグ SunOS 3.0 以前のリリースでは、ネットワークファイルシステム ( .Tn NFS ) がポートマッパーに登録されていません。そのため .Nm は、そのような OS が稼働しているマシンに対して .Tn RPC 呼び出しを行なうことが出来ません。 diff --git a/ja_JP.eucJP/man/man8/savecore.8 b/ja_JP.eucJP/man/man8/savecore.8 index d1b5dc1c29..a034884dbc 100644 --- a/ja_JP.eucJP/man/man8/savecore.8 +++ b/ja_JP.eucJP/man/man8/savecore.8 @@ -1,133 +1,134 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. 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 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. .\" .\" From: @(#)savecore.8 8.1 (Berkeley) 6/5/93 -.\" %FreeBSD: src/sbin/savecore/savecore.8,v 1.8.2.5 2001/12/14 15:17:55 ru Exp % +.\" %FreeBSD: src/sbin/savecore/savecore.8,v 1.8.2.6 2002/06/20 23:09:09 charnier Exp % .\" $FreeBSD$ .\" .Dd September 23, 1994 .Dt SAVECORE 8 .Os .Sh 名称 .Nm savecore .Nd オペレーティングシステムのコアダンプを保存する .Sh 書式 .Nm .Fl c .Nm .Op Fl fkvz .Op Fl N Ar system .Ar directory .Sh 解説 .Nm -は現在動作中のカーネルおよびそのコアダンプをディレクトリ +ユーティリティは、現在動作中のカーネルおよびそのコアダンプをディレクトリ .Fa directory 内にコピーし、 リブートメッセージとコアダンプ情報をシステムログに書き出します。 .Pp オプションは以下の通りです: .Bl -tag -width indent .It Fl c ダンプをクリアし、これ以降起動される .Nm でそれが用いられないようにします。 .It Fl f ダンプが正しくないと思われる場合や、ディスク容量が不足している場合でも、 強制的にダンプをとります。 .It Fl k ダンプを保存した後、クリアしません。 .It Fl N ( .Xr getbootfile 3 で決定される) 動作中のカーネルの代わりに、 .Ar system をカーネルとして用います。 .It Fl v より詳しいデバッグ情報を出力します。 .It Fl z コアダンプとカーネルを圧縮します ( .Xr gzip 1 参照)。 .El .Pp .Nm -は様々な方法を用いてコアダンプが最新であること、 +ユーティリティは、様々な方法を用いてコアダンプが最新であること、 およびそのコアダンプが現在動作しているシステムに対応するものであることを 確認します。 このチェックにパスすると、 .Nm はコアイメージを .Ar directory Ns Pa /vmcore.# に保存し、システムを .Ar directory Ns Pa /kernel.# に保存します。 ``#'' はファイル .Ar directory Ns Pa /bounds 先頭からの行数で、 .Nm が正常に実行されるたびにインクリメントされてファイルに書き戻されます。 .Pp .Nm -はまた、コピーを作る前にディスク容量が足りているかどうかチェックします。 +ユーティリティはまた、 +コピーを作る前にディスク容量が足りているかどうかチェックします。 .Ar directory を含むファイルシステムのディスク容量が不足している場合、 あるいは、 .Ar directory Ns Pa /minfree が存在し、ファイル生成後のそのファイルシステムの (非スーパユーザに対する)残りキロバイト数が このファイル先頭行の数値より小さい場合、 コピー作成は試みられません。 .Pp .Nm がカーネルとコアダンプのコピーに成功すると、 コアダンプはクリアされ、その後の .Nm では用いられないようになります。 .Pp .Nm -は初期化ファイル +ユーティリティは、初期化ファイル .Pa /etc/rc の最終段階付近で呼び出されることを想定しています ( .Xr rc 8 参照)。 .Sh バグ minfree コードは圧縮の効果を考慮していません。 .Sh 関連項目 .Xr gzip 1 , .Xr getbootfile 3 , .Xr dumpon 8 , .Xr syslogd 8 .Sh 歴史 .Nm -コマンドは +ユーティリティは .Bx 4.1 で登場しました。 diff --git a/ja_JP.eucJP/man/man8/sendmail.8 b/ja_JP.eucJP/man/man8/sendmail.8 index 097577bdf9..71f97ea037 100644 --- a/ja_JP.eucJP/man/man8/sendmail.8 +++ b/ja_JP.eucJP/man/man8/sendmail.8 @@ -1,706 +1,704 @@ -.\" Copyright (c) 1998-2001 Sendmail, Inc. and its suppliers. +.\" Copyright (c) 1998-2002 Sendmail, Inc. and its suppliers. .\" All rights reserved. .\" Copyright (c) 1983, 1997 Eric P. Allman. All rights reserved. .\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" By using this file, you agree to the terms and conditions set .\" forth in the LICENSE file which can be found at the top level of .\" the sendmail distribution. .\" .\" -.\" $Id: sendmail.8,v 1.15 2002-03-31 07:00:10 horikawa Exp $ +.\" $Id: sendmail.8,v 8.51 2002/05/24 15:42:13 ca Exp % .\" -.\" %FreeBSD: src/contrib/sendmail/src/sendmail.8,v 1.3.6.4 2002/03/25 21:26:04 gshapiro Exp % +.\" %FreeBSD: src/contrib/sendmail/src/sendmail.8,v 1.3.6.5 2002/06/21 02:25:37 gshapiro Exp % .\" .\" $FreeBSD$ .\" WORD: recipient 受け手[sendmail.8] .\" WORD: envelope sender エンベロープ中の送り手[sendmail.8] .\" -.TH SENDMAIL 8 "$Date: 2002-03-31 07:00:10 $" +.TH SENDMAIL 8 "$Date: 2002-07-21 05:44:33 $" .SH 名称 sendmail \- 電子メール配送デーモン .SH 書式 .B sendmail .RI [ flags "] [" "address ..." ] .br .B newaliases .br .B mailq .RB [ \-v ] .br .B hoststat .br .B purgestat .br .B smtpd .SH 解説 .B sendmail はメッセージを一人または複数の受け手 .RI ( recipient ) に送ります。必要ならばインターネットワークを 通してメッセージを正しい場所に転送します。 .PP .B sendmail はユーザインタフェースとして使われることは考慮されていません。 ユーザにとって使いやすいフロントエンドは別のプログラムで 提供されます。 .B sendmail は、あらかじめメールとして整形されたメッセージ を配送するためだけに使われます。 .PP 引数を指定せずに起動すると、 .B sendmail は標準入力をファイルの終端まで、または `.'だけを含む行まで読み込み、 そこで確認したメッセージのコピーを、 列挙されたアドレスに送ります。アドレスの文法や内容にもとづいて 経路に使用するネットワークを決定します。 .PP ローカルアドレスは、あるファイルの中を検索して適当なエイリアスを行います。 先頭にバックスラッシュ `\\' のついたアドレスについては、エイリアスは 行なわれません。 8.10 から、送り手はエイリアス展開の対象に含まれるようになりました。 つまり、`john' が `group' にメールを送る 際に、 `john' が `group' に含まれているならば、 送ったメッセージは `john' にも送られます。 .SS パラメータ .TP .B \-Ac 動作モードが最初のメール送信依頼であることを示していない場合でも、 submit.cf を使用します。 .TP .B \-Am 動作モードが最初のメール送信依頼であることを示している場合でも、 sendmail.cf を使用します。 .TP .BI \-B type ボディのタイプを .IR type に設定します。現在有効なのは、 7BIT か 8BITMIME です。 .TP .BI \-ba ARPANET モードに移行します。すべての入力行は CR-LF で終わらなければならず、 すべてのメッセージの末尾には CR-LF がつきます。また、``From:'' と ``Sender:'' フィールドは送り手の名前としてチェックされます。 .TP .BI \-bd -デーモンモードで実行します。Berkley -IPC -が必要です。 +デーモンモードで実行します。 .B sendmail は fork を行い、バックグラウンドで動作し、ソケット番号 25 で SMTP コネクションを 待ちます。通常このモードは、 /etc/rc から実行されています。 .TP .B \-bD フォアグラウンドで動作する以外は .B \-bd と同じです。 .TP .B \-bh 継続的なホスト状況データベースの現在の値を表示します。 .TP .B \-bH 継続的なホスト状況データベースから 期限切れのエントリを抹消します。 .TP .B \-bi エイリアスデータベースを初期化します。 .TP .B \-bm 普通にメールを配送します(デフォルト)。 .TP .B \-bp メールキューのリストを表示します。 .TP .B \-bP キューの中のエントリ数を表示します。 共有メモリサポート付きの場合のみ、使用可能です。 .TP .B \-bs 標準入出力で RFC821 にもとづいた SMTP プロトコルを使います。この フラグは、 .B \-ba フラグのうち SMTP 互換の全ての操作を含みます。 .TP .B \-bt アドレスのテストモードで起動します。このモードは対話 モードでアドレスを入力し、処理の過程を表示します。設定ファイル をデバッグするのに使います。 .TP .B \-bv 名前のチェックだけを行います。メッセージの収集や配送は行い ません。ベリファイモードは、ユーザやメーリングリストが有効かどうかを確認する ために使います。 .TP .BI \-C file 別の設定ファイルを使います。 .B sendmail は、別の設定ファイル を使用する場合は root として実行することはできません。 .TP .BI \-d X デバッグ値を .IR X に設定します。 .ne 1i .TP .BI \-F fullname 送り手のフルネームを設定します。 .TP .BI \-f name ``from'' に入る名前(つまり、エンベロープ中の送り手 .RI ( "envelope sender" ) の名前です)を設定します。 最初の送信依頼の間に From: ヘッダが失われている場合、 このアドレスは From: ヘッダの中でも用いられる場合があります。 エンベロープ中の送り手アドレスは、 メッセージ伝送状態の通知の受け手として 用いられ、また、Return-Path: ヘッダにも現れます。 .B \-f は、``trusted'' なユーザ(普通は .IR root ", " daemon ", " network です)が使うか、 送り手が自分自身の名前を指定して使う場合のみ指定することができます。 それ以外の場合、X-Authentication-Warning ヘッダがメッセージに 付加されます。 .TP .BI \-G メッセージのリレー (ゲートウェイ) 送信。 例えば、 .BR rmail が .B sendmail を呼ぶときがそうです。 .TP .BI \-h N ホップカウントを .I N に設定します。ホップカウントは、 メールが処理されるたびに増えていきます。ホップカウントが上限に達した とき、メールは「エイリアスがループしている」という旨のエラーメッセージと いっしょに送り返されます。 もしこのフラグが指定されなければ、メッセージの なかの ``Received:'' 行がカウントされます。 .TP .B \-i 入力されるメッセージ中の `.' だけを含む行を無視します。 このフラグは、データをファイルから読み込むような場合に使用する必要があります。 .TP .BI "\-L " tag syslog メッセージ中で使われる識別子を、指定した .I tag に設定します。 .TP .BI "\-N " dsn 配送状況の通知条件を .I dsn に設定します。 .I dsn には、 `never' (何も通知しない)または、コンマで区切った、 `failure' (配送が失敗した場合に通知する) `delay' (配送が遅れた場合に通知する) `success' (配送が正常に行われた場合に通知する) の組み合わせを指定する事ができます。 .TP .B \-n エイリアスを行いません。 .TP \fB\-O\fP \fIoption\fR=\fIvalue\fR オプション .I option を、指定した .I value に設定します。この形式では長いオプション名が使用されます。 詳しくは後に記述します。 .TP .BI \-o "x value" オプション .I x を、指定した .I value に設定します。 この形式では、一文字のオプション名しか使用できません。 短いオプション名についてはこのマニュアルには記述されていません。 詳しくは、 .I "Sendmail Installation and Operation Guide" を参照して下さい。 .TP .BI \-p protocol メッセージを受け取るために利用するプロトコル名を設定します。 設定できるのは、``UUCP'' のようなプロトコル名だけか プロトコル+ホスト名、たとえば ``UUCP:ucbvax'' などです。 .TP \fB\-q\fR[\fItime\fR] キューのなかにあるメッセージを指定した時間間隔で処理します。 .I time を省略した場合は、キューの内容を一度だけしか処理しません。 .I time は、 秒を表す `s'、 分を表す `m' (デフォルト)、 時間を表す `h'、 日を表す `d'、 週を表す `w' の単位を付けた数字で指定します。 たとえば、 `\-q1h30m' や `\-q90m' は、タイムアウトを 1 時間 30 分に設定します。 デフォルトでは、 .B sendmail はデーモンとしてバックグラウンドで 実行されます。 このオプションは、問題なく .B \-bd と共に指定可能です。 .TP \fB\-qp\fR[\fItime\fR] \fB\-q\fItime\fR と似ていますが、sendmail は、 キューを処理する子プロセスを定期的に fork するのではなく、 キューの処理とスリープを交互に行う 1 個の永続的な子プロセスを fork します。 スリープ時間は引数で指定します。 デフォルトは 1 秒です。 直前のキュー実行においてキューが空だった場合、 プロセスは常に最低 5 秒はスリープします。 .TP \fB\-q\fRf キューに保存されているメッセージを 1 度だけ処理します。 この際、fork() せずに、フォアグラウンドで実行します。 .TP \fB\-q\fRG name .I name という名前のキューグループ中のジョブのみ処理します。 .TP \fB\-q\fR[\fI!\fR]I substr キュー ID の文字列に .I substr が含まれるジョブのみを処理します。 .I ! が指定されると、その逆となります。 .TP \fB\-q\fR[\fI!\fR]R substr 受け手のリストの文字列に .I substr が含まれるジョブのみを処理します。 .I ! が指定されると、その逆となります。 .TP \fB\-q\fR[\fI!\fR]S substr 送り手の文字列に .I substr が含まれるジョブのみを処理します。 .I ! が指定されると、その逆となります。 .TP .BI "\-R " return メッセージがバウンスした時に返送されるメッセージの量を設定します。 .I return パラメータには、メッセージ全体を返送する場合は `full' を、ヘッダのみを返送する場合は `hdrs' を指定します。 .TP .BI \-r name .B \-f フラグと同じですが、古い形式です。 .TP .B \-t 受け手をメッセージから読み取ります。To:, Cc:, Bcc: フィールドが受け手 のアドレスとして読み込まれます。Bcc: フィールドはメッセージの転送前に 削除されます。 .TP .BI "\-V " envid オリジナルのエンベロープ ID を設定します。 これは、DSN をサポートするサーバ間では SMTP 上を伝達し、 DSN に従ったエラーメッセージの中で返送されます。 .TP .B \-v 詳細モードに移行します。 エイリアスの展開などが報告されます。 .TP .BI "\-X " logfile 指定された .I logfile に、メーラに出入りする情報すべてを記録します。 メーラをデバッグする際の 最後の手段としてのみ使ってください。非常に大量の情報があっという間に記録 されます。 .TP .B \-\- コマンドフラグ処理を停止し、残りの引数をアドレスとして使用します。 .SS オプション .B sendmail には、設定することができる多くの処理オプションがあります。 通常、これらのオプションはシステム管理者のみが使います。 オプションは、コマンドラインから .B \-o フラグを使って(短いオプション名で)指定したり、 .B \-O フラグを使って(長いオプション名で)指定したり、 設定ファイルから指定することができます。ここに記述して いるのは部分的なもので、コマンド行から指定する場合に便利な物だけを、 長いオプション名で示しています。完全なリスト(と詳細)は、 .I "Sendmail Installation and Operation Guide" を参照してください。 オプションには以下の物があります。 .TP .RI AliasFile= file 別のエイリアスファイルを使います。 .TP HoldExpensive 接続するのに時間がかかるホストと接続するときは、 すぐに接続せず、リクエストはキューに入れられます。 .TP .RI CheckpointInterval= N .B sendmail が、 .I N 個の配送に成功するたびにキューファイルに チェックポイントを設定します(デフォルトは 10 個です)。これによって、 システムのクラッシュによって長いメーリングリストの配送が中断 されたときでも、再開時に同じ人に重複して配送されることを防ぎます。 .ne 1i .TP .RI DeliveryMode= x 配送モードを .I x に設定します。配送モードには `i' 対話的(同期的)配送モード、 `b' バックグラウンド(非同期的)配送モード、 `q' キューモード(実際の配送は、キューが実行されるときに行われる)、 `d' 延期モード( \-D オプションで指定された マップ (デフォルトはホストマップ) に対し データベースの検索が行われない以外は `q' と同じ)があります。 .TP .RI ErrorMode= x エラー処理をモード .I x に設定します。有効なモードとして、 `m' はエラーメッセージを送り返します。 `w' はエラーメッセージを送り手の端末に書き出します (送り手がログインしていなければ、メールを返します)。 `p' は、エラーメッセージを端末に表示します(デフォルト)。 `q' は、エラーメッセージを捨てます(exit コードだけを返します)。 `e' は、BerkNet 用に特別処理をします。 もし、モード `m' や `w' を使っている場合に、エラーとなったメッセージが エラーメールとして送り返されず、送り手が .B sendmail を実行している マシン上のユーザならば、 メッセージのコピーは送り手のホームディレクトリにある .I dead.letter に追加されます。 .TP SaveFromLine メッセージのはじめに UNIX-style の From 行を残します。 .TP .RI MaxHopCount= N メールがループしていると判断されない、最大のホップ数を 指定します。 .TP IgnoreDots `.' だけを含む行をメッセージの終わりとして解釈しません。 .TP SendMimeErrors エラーメッセージをMIMEフォーマットで送り返します。 設定されていない場合は、DSN (Delivery Status Notification: 配送状況通知) SMTP 拡張は無効になります。 .TP .RI ConnectionCacheTimeout= timeout コネクションキャッシュの タイムアウトを設定します。 .TP .RI ConnectionCacheSize= N コネクションキャッシュのサイズを 設定します。 .TP .RI LogLevel= n ログレベルを設定します。 .TP .RI MeToo= False エイリアスに自分自身が含まれていても、``me''(送り手自身)には送りません。 .TP CheckAliases newaliases(1) コマンドの実行の際、 エイリアスの右辺(エイリアスの値)の有効性をチェックします。 .TP OldStyleHeaders このオプションが設定されていれば、メッセージが古いスタイルのヘッダ を持つことがあることを意味します。 このオプションが設定されていなければ、このメッセージが新しい スタイルを持っていることが保証されます(2 つのアドレスの間は スペースのかわり にコンマで区切られます)。このオプションが設定されていると、 ヘッダのフォーマットをたいていの場合に 正しく決定する適応アルゴリズムが用いられます。 .TP .RI QueueDirectory= queuedir キューメッセージを保存するディレクトリを選択します。 .TP .RI StatusFile= file 指定した名前のファイルに統計情報をセーブします。 .TP .RI Timeout.queuereturn= time キューのなかの配送されなかったメッセージのタイムアウト時間を設定します。 この時間内に(ホストのダウンなどにより)配送が行われなかったときには、 失敗した旨のメッセージが送り返されます。デフォルトは 5 日です。 .TP .RI UserDatabaseSpec= userdatabase セットした場合、ユーザデータベースを見て、 フォワード情報を得ます。 この方法をエイリアス機構の補助として使用する事ができます。 この方法は、データベースが分配されることを意図している点が異なります。 一方、エイリアスは、そのホストローカルでのみ有効です。 .B sendmail が USERDB 付きでコンパイルされていなければ使うことはできません。 .TP ForkEachJob キューを処理する間、各ジョブごとに fork を行います。メモリが少ないマシン では便利です。 .TP SevenBitInput 到着するメッセージを 7 ビットにします (8 ビット目は落します)。 .TP .RI EightBitMode= mode 8 ビットの入力を 7 ビットの宛先へ送る場合の処理方法を .IR mode に設定します。 処理方法には、 m (mime 化) 7 ビット MIME 形式へ変換、 p (パス) 8 ビットのまま配送(プロトコルには違反します)、 s (厳密) メッセージをバウンス、 があります。 .TP .RI MinQueueAge= timeout 配送の試行の間、ジョブがキューに蓄積される時間を設定します。 .TP .RI DefaultCharSet= charset 文字集合が特に指定されていない 8 ビットデータにラベル付けする際に 用いる、デフォルトの文字集合を設定します。 .TP .RI DialDelay= sleeptime コネクションの確立が失敗した場合に、再試行までに .I sleeptime だけスリープします。オンデマンドでダイヤル接続するサイトでの 使用に便利です。 .TP .RI NoRecipientAction= action 受け手ヘッダ (To:, Cc:, Bcc:) がない場合の動作を .I action に設定します。 none メッセージを変更しない、 add-to エンベロープで指定された受け手を入れた To: ヘッダを加える、 add-apparrently-to エンベロープで指定された受け手を入れた Apparrently-To: ヘッダを加える、 add-bcc 空の Bcc: ヘッダを加える、 add-to-undisclosed `To: undisclosed-recipients:;' というヘッダを加える、という動作を指定できます。 .TP .RI MaxDaemonChildren= N 待ち受け SMTP デーモンが同時に生成する子プロセスの最大数を .I N に設定します。 .TP .RI ConnectionRateThrottle= N SMTP ポートへの 1 秒当りの最大コネクション数を .I N に設定します。 .PP エイリアスのなかで最初の文字が `|' で始まるものは、メールの内容を パイプでコマンドに送るものと解釈されます。 .B sendmail に引数の間から空白文字を削除させないようにする場合は 名前をクォートする (" でくくる)必要があります。 以下に、例を示します: .IP msgs: "|/usr/bin/msgs -s" .PP エイリアスには、 .RI ``:include: filename '' という文法もあります。 .B sendmail は、 メールの受け手のリストを得るために、指定されたファイルを読みます。 以下に、例を示します: .IP poets: ":include:/usr/local/lib/poets.list" .PP 上記の例の場合は、 .I /usr/local/lib/poets.list を読み、`poets' のグループの ためのアドレスリストを作ります。 .PP .B sendmail は、以下に示すような終了コードを返します。これらの コードは、 .RI < sysexits.h > に定義されています。 .TP EX_OK すべてのアドレスについて完全に成功しました。 .TP EX_NOUSER ユーザ名が認識できません。 .TP EX_UNAVAILABLE 処理に必要なリソースを得ることができません。 .TP EX_SYNTAX アドレスに文法的な間違いがあります。 .TP EX_SOFTWARE 引数が間違っているなどの、内部的なエラーです。 .TP EX_OSERR ``cannot fork''' のような、一時的な OS エラーです。 .TP EX_NOHOST ホスト名が認識できません。 .TP EX_TEMPFAIL メッセージはすぐには送られませんでしたが、 キューには入れられました。 .PP .B newaliases というコマンドで実行されると、 .B sendmail はエイリアスデータベースを再構築します。 .B mailq というコマンドで実行されると、 .B sendmail はメールキューの内容を表示します。 .B hoststat というコマンドで実行されると、 .B sendmail は、継続的なホスト状態データベースの内容を表示します。 .B purgestat というコマンドで実行されると、 .B sendmail は、継続的なホスト状態データベースから期限切れのエントリを抹消します。 .B smtpd というコマンドで実行されると、 .B \-bd オプションを指定されたの同じように、 .B sendmail はデーモンとして動作します。 .SH 注 .B sendmail は、多くの問題の原因だと責められることがよくありますが、 実際のところ、それらの問題は、 ディレクトリのモードが過剰に許可された状態であるなど、 他の問題に起因するものです。このため、 .B sendmail は、システムディレクトリとファイルのモードをチェックし、 それらディレクトリ、ファイルが信頼するに足るものかどうかを 決定します。 .B DontBlameSendmail オプションを設定することにより、 このチェックをオフにし、システムのセキュリティを低下することも できますが、基本的には、パーミッションの問題は修正されねばなりません。 詳細な情報は、 .I http://www.sendmail.org/tips/DontBlameSendmail.html を参照して下さい。 .SH 関連ファイル .I /etc/mail/sendmail.cf それ自身を除き、以下のファイルのパスはすべて .I /etc/mail/sendmail.cf の内部で指定されています。以下の値は概略に過ぎません。 .PP .TP /etc/mail/aliases エイリアス名の生データ .TP /etc/mail/aliases.db エイリアス名のデータベース .TP /etc/mail/sendmail.cf 設定ファイル .TP /etc/mail/helpfile ヘルプファイル .TP /etc/mail/statistics 統計情報ファイル .TP /var/spool/mqueue/* テンポラリファイル .SH 関連項目 mail(1), syslog(3), aliases(5), mailaddr(7), mail.local(8), rc(8), rmail(8) .PP DARPA Internet Request For Comments .IR RFC819 , .IR RFC821 , .IR RFC822 . .IR "Sendmail Installation and Operation Guide" , No. 8, SMM. .PP http://www.sendmail.org/ .SH 歴史 .B sendmail コマンドは 4.2BSD から登場しました。 diff --git a/ja_JP.eucJP/man/man8/smrsh.8 b/ja_JP.eucJP/man/man8/smrsh.8 index ce7efa3daf..9b2b50fb4b 100644 --- a/ja_JP.eucJP/man/man8/smrsh.8 +++ b/ja_JP.eucJP/man/man8/smrsh.8 @@ -1,90 +1,90 @@ .\" Copyright (c) 1998-2001 Sendmail, Inc. and its suppliers. .\" All rights reserved. .\" Copyright (c) 1993 Eric P. Allman. All rights reserved. .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" By using this file, you agree to the terms and conditions set .\" forth in the LICENSE file which can be found at the top level of .\" the sendmail distribution. .\" .\" -.\" $Id: smrsh.8,v 1.10 2002-04-29 00:51:39 horikawa Exp $ +.\" $Id: smrsh.8,v 8.16 2002/04/25 13:33:40 ca Exp % .\" -.\" %FreeBSD: src/contrib/sendmail/smrsh/smrsh.8,v 1.3.6.3 2002/03/25 21:25:54 gshapiro Exp % +.\" %FreeBSD: src/contrib/sendmail/smrsh/smrsh.8,v 1.3.6.4 2002/06/21 02:25:30 gshapiro Exp % .\" .\" $FreeBSD$ .\" -.TH SMRSH 8 "$Date: 2002-04-29 00:51:39 $" +.TH SMRSH 8 "$Date: 2002-07-21 05:44:33 $" .SH 名称 smrsh \- sendmail用に制限されたシェル .SH 書式 .B smrsh .B \-c command .SH 解説 .I smrsh は、 .IR sendmail (8) の設定ファイルで、 .I sh の代わりに ``prog'' メーラとして使用する事を目的としています。 .I smrsh は、システムの全体的なセキュリティを改善するために、 .I sendmail の ``|program'' 書式により起動する事ができるコマンドを制限します。 つまり、もし ``悪者'' が alias ファイルや forward ファイルを経由せずに sendmail からプログラムを実行する事ができたとしても、 .I smrsh を使えば、彼(あるいは彼女)が実行できるプログラムを制限する事ができるのです。 .PP 簡単に言うと、 .I smrsh は、実行可能なプログラムを単一のディレクトリに存在するものと、 シェル組み込みコマンドの ``exec'', ``exit'', ``echo'' だけに限定します。 このディレクトリは、デフォルトでは、/usr/libexec/sm.bin です。 これにより、システム管理者は利用可能なコマンドを選択する 事ができます。 更に、 .I smrsh は、``end run'' 攻撃を防ぐために、コマンド行に `\`', `<', `>', `;', `$', `(', `)', `\er' (復改文字), `\en' (改行文字) の文字を含むコマンドは実行しません。 ``||'' と ``&&'' は、許可されており、次のようなコマンドを使用可能です: ``"|exec /usr/local/bin/procmail -f- /etc/procmailrcs/user || exit 75"'' .PP プログラム名の前にあるパス名は全て取り除かれるため、 ``/usr/bin/vacation'', ``/home/server/mydir/bin/vacation'', ``vacation'' などは全て ``/usr/libexec/sm.bin/vacation'' と解釈されます。 .PP システム管理者は、 sm.bin ディレクトリに置くプログラムを選ぶ際には慎重な 判断をすべきです。適切な物としては、 .IR vacation (1) や .IR procmail (1) などがあげられるでしょう。いかなる要望があっても、シェルや、 .IR perl (1) などのシェルに似たプログラムを sm.bin に入れてはいけません。 これは、単に任意のプログラムを実行する事を制限するだけで、 ``#!''書式を用いた、シェルスクリプトや perl スクリプトを sm.bin ディレクトリに入れる事を制限する訳ではありません。 .SH コンパイル コンパイルはほとんどのシステムでつまらないものです。 デフォルトのサーチパス (デフォルトでは``/bin:/usr/bin'') を変更するためには、\-DSMRSH_PATH=\e"\fIpath\fP\e" を 使用する必要があり、また、 デフォルトのプログラムディレクトリ (デフォルトでは ``/usr/libexec/sm.bin'') -を変更するためには、\-DSMRSH_CMDBIN=\e"\fIdir\fP\e" を +を変更するためには、\-DSMRSH_CMDDIR=\e"\fIdir\fP\e" を 使用する必要があります。 .SH 関連ファイル /usr/libexec/sm.bin \- 制限されたプログラム用のディレクトリ .SH 関連項目 sendmail(8)