diff --git a/ja_JP.eucJP/man/man8/Makefile b/ja_JP.eucJP/man/man8/Makefile index 54826666dd..96ceca5c31 100644 --- a/ja_JP.eucJP/man/man8/Makefile +++ b/ja_JP.eucJP/man/man8/Makefile @@ -1,360 +1,361 @@ # $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\ bsdlabel.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\ conscontrol.8\ crash.8\ cron.8\ cvsbug.8\ daemon.8\ devd.8\ + devfs.8\ devinfo.8\ dhclient-script.8\ dhclient.8\ digictl.8\ diskless.8\ dmesg.8\ dump.8\ dumpfs.8\ dumpon.8\ editmap.8\ edquota.8\ extattrctl.8\ faithd.8\ fdcontrol.8\ fdisk.8\ ffsinfo.8\ fingerd.8\ fixmount.8\ fore_dnld.8\ fsck.8\ fsck_ffs.8\ fsck_msdosfs.8\ fsdb.8\ fsinfo.8\ fsirand.8\ ftpd.8\ getfmac.8\ getpmac.8\ getty.8\ growfs.8\ hlfsd.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\ isdnd.8\ isdndebug.8\ isdndecode.8\ isdnmonitor.8\ isdnphone.8\ isdntel.8\ isdntelctl.8\ isdntrace.8\ ispcvt.8\ jail.8\ jexec.8\ jls.8\ kernbb.8\ keyserv.8\ kgmon.8\ kgzip.8\ kldconfig.8\ kldload.8\ kldstat.8\ kldunload.8\ kldxref.8\ ktrdump.8\ lastlogin.8\ ldconfig.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\ mksnap_ffs.8\ mld6query.8\ mlxcontrol.8\ mount.8\ mount_cd9660.8\ mount_ext2fs.8\ mount_msdosfs.8\ mount_nfs.8\ mount_ntfs.8\ mount_nullfs.8\ mount_nwfs.8\ mount_portalfs.8\ mount_smbfs.8\ mount_std.8\ mount_udf.8\ mount_umapfs.8\ mount_unionfs.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_opie.8\ pam_opieaccess.8\ pam_radius.8\ pam_ssh.8\ pam_tacplus.8\ pccardc.8\ pccardd.8\ pciconf.8\ periodic.8\ picobsd.8\ ping.8\ ping6.8\ pnpinfo.8\ ppp.8\ pppctl.8\ pppd.8\ pppoed.8\ pppstats.8\ praliases.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\ rcorder.8\ reboot.8\ renice.8\ repquota.8\ restore.8\ revnetgroup.8\ rexecd.8\ rip6query.8\ rlogind.8\ rmail.8\ rmextattr.8\ rmt.8\ rmuser.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\ rpcbind.8\ rpcinfo.8\ rrenumd.8\ rshd.8\ rtadvd.8\ rtquery.8\ rtsold.8\ rwhod.8\ sa.8\ savecore.8\ scspd.8\ sendmail.8\ setfmac.8\ setfsmac.8\ setkey.8\ setpmac.8\ sftp-server.8\ showmount.8\ shutdown.8\ sicontrol.8\ slattach.8\ sliplogin.8\ slstat.8\ smrsh.8\ spkrtest.8\ spppcontrol.8\ spray.8\ ssh-keysign.8\ sshd.8\ sticky.8\ stlload.8\ stlstats.8\ strfile.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\ ugidfw.8\ umount.8\ usbd.8\ usbdevs.8\ vinum.8\ vipw.8\ vmstat.8\ watch.8\ wicontrol.8\ wire-test.8\ wlconfig.8\ yp.8\ yp_mkdb.8\ ypbind.8\ ypinit.8\ yppoll.8\ yppush.8\ ypserv.8\ ypset.8\ ypxfr.8\ zdump.8\ zic.8\ zzz.8 MLINKS+=apm.8 apmconf.8 MLINKS+=boot_i386.8 boot.8 MLINKS+=bootpd.8 bootpgw.8 MLINKS+=bsdlabel.8 disklabel.8 MLINKS+=dump.8 rdump.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_devfs.8 MLINKS+=mount_std.8 mount_fdescfs.8 MLINKS+=mount_std.8 mount_procfs.8 MLINKS+=mount_std.8 mount_linprocfs.8 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.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+=rc.8 rc.d.8 MLINKS+=reboot.8 halt.8 MLINKS+=reboot.8 fastboot.8 MLINKS+=reboot.8 fasthalt.8 MLINKS+=restore.8 rrestore.8 MLINKS+=rmextattr.8 setextattr.8 MLINKS+=rmextattr.8 getextattr.8 MLINKS+=rmextattr.8 lsextattr.8 MLINKS+=rpc.lockd.8 lockd.8 MLINKS+=rtsold.8 rtsol.8 MLINKS+=slattach.8 slip.8 MLINKS+=strfile.8 unstr.8 MLINKS+=swapon.8 swapoff.8 MLINKS+=swapon.8 swapctl.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/devfs.8 b/ja_JP.eucJP/man/man8/devfs.8 new file mode 100644 index 0000000000..42777d0ba3 --- /dev/null +++ b/ja_JP.eucJP/man/man8/devfs.8 @@ -0,0 +1,368 @@ +.\" +.\" Copyright (c) 2002 Dima Dorfman. +.\" 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/devfs/devfs.8,v 1.8 2003/09/14 13:41:57 ru Exp % +.\" +.\" $FreeBSD$ +.Dd July 1, 2002 +.Dt DEVFS 8 +.Os +.Sh 名称 +.Nm devfs +.Nd DEVFS 制御コマンド +.Sh 書式 +.Nm +.Op Fl m Ar mount-point +.Ar keyword +.Ar argument ... +.Sh 解説 +.Nm +ユーティリティは、マウントされた +.Xr devfs 5 +のプロパティを操作するためのインタフェースです。 +.Pp +.Ar keyword +引数で残りの引数のコンテキストを指定します。 +例えば、 +ほとんどのルールサブシステム関連のコマンドの前には +.Cm rule +キーワードをつけなければならないことになっています。 +次のフラグはすべてのキーワードに共通のものです: +.Bl -tag -offset indent +.It Fl m Ar mount-point +操作する +.Ar mount-point +を指定します。 +ここには、 +.Xr devfs 5 +がマウントされていなければなりません。 +このオプションがない時には、 +.Nm +は +.Pa /dev +を操作します。 +.El +.Ss ルールサブシステム +.Xr devfs 5 +のルールサブシステムは、システム管理者が DEVFS の各ノードの属性を変更できる +ようにするためのものです。 +.\" XXX devfs node? entry? what? +DEVFS マウントポイントにはそれぞれに +.Dq ruleset +(ルールセット) というルールのリストが関連づけられています。 +デバイスドライバが新しいノードを作成する時には、 +そのノードがユーザランドから見えるようになる前に +それぞれのマウントポイントに関連づけられているルールセットの +すべてのルールが適用されます (下記参照) 。 +これによって、管理者がノードの可視性を含めた属性を変更することが +できるようになっています。 +例えば、 +.Xr jail 2 +の +.Pa /dev +にあるすべてのディスクノードを隠すというようなこともできます。 +.Ss ルールの操作 +ルール操作コマンドは +.Cm rule +キーワードに続けて使用します。 +次のフラグは、すべてのルール操作コマンドに共通のものです : +.Bl -tag -offset indent +.It Fl s Ar ruleset +.Ar ruleset +で指定したルールセットを操作します。 +このフラグが指定されていない時は、 +指定したマウントポイントに現在関連づけられているルールセットを +操作します。 +.El +.Pp +次のコマンドが使用できます: +.Bl -tag -offset indent +.It Cm rule add Oo Ar rulenum Oc Ar rulespec +.Ar rulespec +(下記参照) +で、記述されたルールをルールセットに追加します。 +ルール番号は、 +.Ar rulenum +が明示的に指定されている場合にはその番号に、 +指定されていない場合には自動的にカーネルによって決められます。 +.It Cm rule apply Ar rulenum | rulespec +ルール番号 +.Ar rulenum +または +.Ar rulespec +で、指定されたルールをマウントポイントに適用します。 +.Dq 適用される +ルールには条件があって、マウントポイントのすべてのノードに対して +チェックを行い、条件が一致すれば指定のアクションを起こします。 +.It Cm rule applyset +ルールセットのすべてのルールをマウントポイントに適用します +(上記 +.Dq apply +の説明を参照) 。 +.It Cm rule del Ar rulenum +ルールセットからルール番号 +.Ar rulenum +のルールを削除します。 +.It Cm rule delset +指定したルールセットのすべてのルールを削除します。 +.It Cm rule show Op Ar rulenum +.Ar rulenum +で指定したルール番号のルール、 +またはルールセットのすべてのルールを表示します。 +出力行は (ルール毎に 1 行ずつ) 正しい +.Ar rulespec Ns +になっています。 +.It Cm rule showsets +設定されているルールセットの番号を表示します。 +.It Cm ruleset Ar ruleset +.Ar ruleset +で指定した番号のルールセットをマウントポイントのカレントルールセットにします。 +.El +.Ss ルール仕様 +ルールには 2 つのパートがあります: 条件部とアクション部です。 +条件部でルールを適用する DEVFS ノードを指定し、 +アクション部でルールが当てはまるノードに何をするかを指定します。 +例えば、メジャー番号が 53 のすべてのデバイスの GID を +.Dq Li games +に設定するルールを書くこともできます。 +ルール指定の最初のトークンがダッシュ文字 1 つ +.Pq Sq Fl +の場合、ルールは標準入力から読み込まれて残りの指定は無視されます。 +.Pp +次のような条件が使用できます。 +デバイスをチェックする時には、条件は AND されます。 +OR 条件を使いたい時には、複数のルールを書いてください。 +.Bl -tag -offset indent +.It Cm major Ar majdev +メジャー番号が +.Ar majdev +のすべてのノードに適合します。 +.It Cm path Ar pattern +パス名が +.Ar pattern +に合うノードすべてに適合します。 +このパターンは +.Xr glob 3 +と同じパターンで解析されます。 +.It Cm type Ar devtype +タイプが +.Ar devtype +のすべてのノードに適合します。 +使用できるタイプは +.Cm disk , mem , tape +および +.Cm tty +です。 +.El +.Pp +次のようなアクションが使用できます。 +条件部とアクション部の間には特にデリミタはありませんが、 +混乱することはないでしょう。 +.Bl -tag -offset indent +.It Cm group Ar gid +ノードのグループ ID を +.Ar gid +に設定します。 +グループ名 +.Pa ( /etc/group +で照会されます) +または、数値で指定します。 +.It Cm hide +ノードを隠します。 +隠されたノードは、マニュアルで +.Xr mknod 8 +を使用するか、 +.Cm unhide +アクションを使用するとまた見えるようになります。 +.It Cm include Ar ruleset +ルールセット番号が +.Ar ruleset +のルールセットのすべてのルールをノードに適用します。 +これによってノードが変更されるとは限りません +(例えば、ルールセットに一致するルールがない場合など)。 +.It Cm mode Ar filemode +ファイルのモードを +.Ar filemode +に設定します。 +8 進数として解釈されます。 +.It Cm user Ar uid +ユーザ ID を +.Ar uid +に設定します。ユーザ名 +.Pa ( /etc/passwd +で照会されます) または数値で指定します。 +.It Cm unhide +ノードを見えるようにします。 +.El +.Sh 実装に関する注 +ルールセットは、最初に参照される時にカーネルによって作成され、 +最後の参照がなくなる時に削除されます。 +すなわち、ルールセットはルールが追加される時かどこかのマウントポイントの +カレントルールセットに設定された時に作成されます。 +また、セットの中の最後のルールが削除される時でもう他からの参照もない +(つまり、他のルールにインクルードされてもなく、 +どのマウントポイントのカレントルールセットにもなっていない) +時に削除されます。 +.Pp +ルールセット 0 番は +すべての新しいマウントポイントのデフォルトルールセットです。 +このルールセットは常に空で、変更や削除はできず、 +.Cm showsets +コマンドの出力にも表示されません。 +.Pp +ルールやルールセットは特定のマウントポイント毎ではなく、 +システム全体で一意です。 +つまり、 +.Cm showsets +は、 +.Fl m +で指定したマウントポイントにかかわらず、常に同じ情報を表示します。 +マウントポイントが有効なのは、 +カレントルールセットを変更する時や apply コマンドを使用する時だけです。 +.Sh 実行例 +システム起動時には、 +ルールセット 0 番のみが存在しますが、 +このルールセットは後から変更することができないので、 +ルールを追加する前に別のルールセットを作成しなければなりません。 +以下の例ではほとんど +.Fl m +オプションを指定していませんので、 +操作は +.Pa /dev +に対して実行されることに注意してください +(これは、ノードのプロパティを変更するものだけが問題だからです) 。 +.Pp +.Dl "devfs ruleset 10" +.Pp +ルールセット 10 番を +.Pa /dev +のカレントルールセットに指定しています +(もし、存在していなければ作成されます)。 +.Pp +.Dl "devfs rule add path speaker mode 666" +.Pp +パス名が +.Dq Li speaker +にマッチするすべてのノード +(これは +.Pa /dev/speaker +だけですが) +をファイルモード 666 +(すべてのユーザが読み書き可能) にするルールを追加しています。 +気をつけて欲しいのは、そのようなノードが既に存在する場合には、 +このルール (やルールセット) が明示的に適用される (下記参照) まで +そのノードは変更されないということです。 +モードが変更 +.Em される +のはルールが追加された +.Em 後に +ノードが作成された場合です +(つまり、上記のルールが追加された後に +.Pa atspeaker +モジュールがロードされた場合)。 +.Pp +.Dl "devfs rule applyset" +.Pp +カレントルールセットのすべてのルールを、 +存在するすべてのノードに適用しています。 +つまり、上記のルールが +.Pa /dev/speaker +を作成した後に追加された場合に、 +このコマンドを使用してルール通りにファイルモードを 666 にすることができます。 +.Pp +.Dl devfs rule add path "snp*" mode 660 group snoopers +.Pp +(引数を引用符で囲うのは +.Cm パス名 +がシェルのファイルグロブ機能で展開されるのを防ぐ必要があるからです。) +パス名が +.Dq Li snp* , +にマッチするすべてのデバイスのファイルモードを 660 に、GID を +.Dq Li snoopers +に設定します。 +このようにすると、 +.Dq Li snoopers +グループのユーザが +.Xr snp 4 +デバイスを使えるようになります。 +.Pp +.Dl "devfs rule -s 20 add major 53 group games" +.Pp +ルールセット 20 番にルールを追加します。 +このルールセットは +どこのマウントポイントのカレントルールセットにもなっていないので、 +このルールが自動的に適用されることはありません +(後でルールセット 20 番がどこかのマウントポイントの +カレントルールセットになるまでは)。 +それでも以下のようにして、明示的にルールを適用することができます: +.Pp +.Dl "devfs -m /my/jail/dev rule -s 20 applyset" +.Pp +このコマンドではルールセット 20 番のすべてのルールを +.Pa /my/jail/dev +の DEVFS マウントに適用しています。 +このときには、ルールセット 20 番がそのマウントポイントの +カレントルールセットであるかどうかにかかわりなくルールが適用されます。 +.Pp +.Dl "devfs rule apply hide" +.Pp +このルールには条件部がありませんので、 +.Pq Cm hide +アクションがすべてのノードに適用されます。 +すべてのノードを非表示にするのはあまり便利ではありませんので、 +下のようにして取り消すことができます: +.Pp +.Dl "devfs rule apply unhide" +.Pp +このコマンドは +.Cm unhide +をすべてのノードに適用して、 +再び表示されるようにしています。 +.Pp +.Dl "cat my_rules | devfs rule -s 10 add -" +.Pp +.Pa my_rules +ファイルに書いてあるルールをすべてルールセット 10 番に追加します。 +.Pp +.Dl "devfs rule -s 20 show | devfs rule -s 10 add -" +.Pp +.Cm show +コマンドの出力が有効なルールになっているので、 +この機能を利用してルールセットをコピーすることができます。 +上のコマンドでは、ルールセット 20 番のルールをすべて +ルールセット 10 番にコピーしています。 +ルール番号は予約されていますが、 +ルールセット 10 番にはすでに +衝突しない番号のルールが入っています (その番号も予約されます)。 +.Sh 関連項目 +.Xr chmod 1 , +.Xr jail 2 , +.Xr glob 3 , +.Xr devfs 5 , +.Xr chown 8 , +.Xr jail 8 , +.Xr mknod 8 +.Sh 作者 +.An Dima Dorfman