os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Initial Japanese translations

Browse source 
Submitted by:	Yoshihito Ryuzaki <riew@cybtec.co.jp>
This commit is contained in:
Kazuo Horikawa 2003-08-16 20:32:16 +00:00
parent 6deedc282b
commit 32c6e335e4
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=17887
3 changed files with 304 additions and 0 deletions

2
ja_JP.eucJP/man/man5/Makefile
View file

@ -10,7 +10,9 @@ MAN5 = a.out.5\
crontab.5\
ctm.5\
cvs.5\
devd.conf.5\
devfs.5\
device.hints.5\
dhclient.conf.5\
dhclient.leases.5\
dhcp-eval.5\

136
ja_JP.eucJP/man/man5/devd.conf.5 Normal file
View file

@ -0,0 +1,136 @@
.\"
.\" Copyright (c) 2002 M. Warner Losh
.\" 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 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/devd/devd.conf.5,v 1.8 2003/03/03 11:51:30 ru Exp %
.\"
.\" The section on comments was taken from named.conf.5, which has the
.\" following copyright:
.\" Copyright (c) 1999-2000 by Internet Software Consortium
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
.\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
.\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, 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.
.\"
.\" $FreeBSD$
.\"
.\" WORDS
.\" statement ステートメント
.\" general syntax 一般的な文法
.\" appeal to ～にとって便利な(文脈で流しました)
.\" C-style C 形式(の)
.\" C++-style C++ 形式(の)
.\" nest ネスト(する)
.\"
.Dd October 17, 2002
.Dt DEVD.CONF 5
.Os
.Sh 名称
.Nm devd.conf
.Nd
.Xr devd 8
用の設定ファイル
.Sh 解説
.Ss 一般的な文法
.Xr devd 8
設定ファイルの内容には、ステートメントとコメントの大きく 2 種類があります。
ステートメントの終りは全てセミコロンです。
ステートメントの多くはサブステートメントを持つことが出来ますが、
サブステートメントの終りもセミコロンです。
.Pp
次のステートメントがサポートされています:
.Bl -tag -width ".Ic options"
.It Ic options
.Xr devd 8
の処理で適用されるさまざまなオプションやパラメータを指定します。
.It Ic attach
各種デバイスの照合基準とその基準に適合したデバイスを新規にアタッチするときに
実行するアクションを指定します。
.It Ic detach
各種デバイスの照合基準とその基準に適合したデバイスを新規にデタッチするときに
実行するアクションを指定します。
.It Ic nomatch
適合するデバイスドライバが現状カーネルにロードされていない (新しい)
デバイスについて、
各種の照合基準と適合したデバイスに対して実行するアクションを指定します。
.El
.Pp
ステートメントは設定ファイル中にどの順番でも、また必要な数だけ
何度でも、書くことが出来ます。
文法及びそれぞれのステートメントやそのサブステートメントの意味について、
以下に詳しく説明します。
.Pp
コメントは設定ファイル中で空白を入れられる場所にならば、どこにでも
入れることが出来ます。
全てのプログラマにとって便利なように、コメントは C、C++、shell/Perl のどの
形式でも書くことが出来るようになっています。
.Pp
C 形式のコメントは
.Ql /*
(slash, star) の 2 文字で始まり
.Ql */
(star, slash) で終ります。
この形式のコメントはこれらの文字で完全に区切ることが出来るので、
行の一部や複数行にまたがるコメントに使用することが出来ます。
.Pp
C 形式のコメントは、ネストすることが出来ません。
例えば、次の例は最初の
.Ql */
でコメントが完全に終了するので無効です:
.Bd -literal -offset indent
/* ここからコメントが始まります。
ここはまだ、コメントの内部です。
/* ここでコメントをネストしようとしていますが、これは間違いです。*/
ここは、もうコメントの内部ではありません。*/
.Ed
.Pp
C++ 形式のコメントは
.Ql //
(slash, slash) の 2 文字で始まり、物理行の終りまでになります。
この形式のコメントは物理行をまたぐことが出来ません。つまり、
論理的に 1 つのコメントでも複数行にまたがる場合には、それぞれの行に
.Ql //
を入れなくてはなりません。
例えば:
.Bd -literal -offset indent
// ここからコメントが始まります。次の行は
// 新しいコメントです。たとえ、論理的に
// 前のコメントの一部であったとしても、です。
.Ed
.Sh 関連ファイル
.Bl -tag -width ".Pa /etc/devd.conf" -compact
.It Pa /etc/devd.conf
.Xr devd 8
設定ファイル
.El
.Sh 関連項目
.Xr devd 8

166
ja_JP.eucJP/man/man5/device.hints.5 Normal file
View file

@ -0,0 +1,166 @@
.\" Copyright (c) 2001
.\" Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp>
.\" 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 as
.\" the first lines of this file unmodified.
.\" 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/share/man/man5/device.hints.5,v 1.8 2002/12/19 18:26:26 trhodes Exp %
.\" $FreeBSD$
.\"
.\" WORDS
.\" hints,hint ヒント
.\" boot loader boot loader
.\" start address スタートアドレス
.\" most often よく
.\"
.Dd October 7, 2001
.Dt DEVICE.HINTS 5
.Os
.Sh 名称
.Nm device.hints
.Nd デバイスリソースヒント
.Sh 解説
.Nm
ファイルは、システムの起動時に boot
.Xr loader 8
によって読み込まれ、その内容がカーネルに渡されます。
その内容には、カーネルの起動動作を制御するいろいろな変数が含まれます。
それらの変数は、主に
.Dq デバイスヒント
です。
.\" .Dq device hints ,
.\" and other control variables.
.Pp
ファイルの一行で一つの変数を定義します。
.Ql #
の文字で始まる行はコメントで、boot loader には無視されます。
.Pp
boot loader がファイルを読み込んでからは、
.Ic show
コマンドでその値を確認することが出来ます。
また、boot loader の
.Ic set
や
.Ic unset
コマンドを用いて、新しい変数を追加したり既存の変数を変更・削除したり
することが出来ます。
.Xr ( loader 8
参照)
.Pp
システムが起動してからは
.Xr kenv 1
コマンドで、これらの変数を表示させることが出来ます。
.Sh デバイスヒント
デバイスヒント変数は、デバイスドライバがデバイスをセットアップするのに
使用されます。
これらは ISA デバイスドライバがよく利用していて、
ドライバが適切なデバイスをプローブするのにどこを見るかや、
どのリソースを使うのかを指定するのに使われています。
.Pp
デバイスヒント行は、次のようになっています:
.Pp
.Sm off
.D1 Li hint. Ar driver Li . Ar unit Li . Ar keyword Li = Qq Ar value
.Sm on
.Pp
ここで
.Ar driver
はデバイスドライバの名称、
.Ar unit
はユニット番号、
.Ar keyword
はその行のヒントのキーワードです。
キーワードには次のものがあります:
.Pp
.Bl -tag -width ".Li disabled" -compact -offset indent
.It Li at
デバイスがアタッチされるバスを指定します。
.It Li port
デバイスが使用する I/O ポートのスタートアドレスを指定します。
.It Li irq
使用する割り込みライン番号です。
.It Li drq
DMA チャネル番号です。
.It Li maddr
デバイスが使用する物理メモリアドレスを指定します。
.It Li flags
デバイスのいろいろなフラグビットを設定します。
.It Li disabled
.Qq 1
に設定するとデバイスを使用不可にすることが出来ます。
.El
.Pp
デバイスドライバによっては、これらのキーワードの一つもしくは
それ以上のヒント行が必須になることもあるかもしれませんし、
ここのリストにないキーワードが使えるかもしれません。
使用可能なキーワードや設定可能な値については個々のデバイスドライバの
マニュアルページを参照してください。
.\" .Sh CONTROL VARIABLES
.\" Lines not starting with
.\" .Dq hint.
.\" specify other control variables for the kernel.
.\" They look:
.\" .Pp
.\" .Dl <name>="<value>"
.\" XXX
.\" WE SHOULD LIST AVAILABLE VARIABLE NAMES AND THEIR POSSIBLE VALUES HERE!
.\" .Pp
.Sh 関連ファイル
.Bl -tag -width ".Pa /sys/ Ns Ar ARCH Ns Pa /conf/GENERIC.hints" -compact
.It Pa /boot/device.hints
デバイスリソースヒントファイル
.It Pa /sys/ Ns Ar ARCH Ns Pa /conf/GENERIC.hints
.Pa GENERIC
カーネル用のサンプルリソースヒントファイル
.It Pa /sys/ Ns Ar ARCH Ns Pa /conf/NOTES
カーネル設定ファイルやデバイスリソースヒントに関する注
.El
.Sh 使用例
次の例は、ISA バス上の
.Xr sio 4
ドライバのリソースを設定するものです:
.Bd -literal -offset indent
hint.sio.0.at="isa"
hint.sio.0.port="0x3F8"
hint.sio.0.flags="0x10"
hint.sio.0.irq="4"
.Ed
.Pp
次の例は、ACPI ドライバを使用不可にするものです:
.Bd -literal -offset indent
hint.acpi.0.disabled="1"
.Ed
.\" .Pp
.\" A control variable may look like:
.\" .Pp
.\" .Bd -literal -offset indent
.\" debug.acpi.layer="ACPI_RESOURCES"
.\" .Ed
.Sh 関連項目
.Xr kenv 1 ,
.Xr loader.conf 5 ,
.Xr loader 8
.Sh 歴史
.Nm
ファイルは
.Fx 5.0
に初めて登場しました。