diff --git a/ja_JP.eucJP/man/man9/BUS_PRINT_CHILD.9 b/ja_JP.eucJP/man/man9/BUS_PRINT_CHILD.9 index 2cfe144eba..355af3fb97 100644 --- a/ja_JP.eucJP/man/man9/BUS_PRINT_CHILD.9 +++ b/ja_JP.eucJP/man/man9/BUS_PRINT_CHILD.9 @@ -1,59 +1,59 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/BUS_PRINT_CHILD.9,v 1.6.2.4 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/BUS_PRINT_CHILD.9,v 1.6.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/BUS_PRINT_CHILD.9,v 1.6 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_PRINT_CHILD 9 .Os .Sh 名称 .Nm BUS_PRINT_CHILD .Nd デバイスについての情報の表示 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn BUS_PRINT_CHILD "device_t dev" "device_t child" .Sh 解説 これはデバイスの説明をプリントアウトするシステムのコードから呼び出されます。 それは子デバイスが持っている親とのアタッチメントを記述するべきです。 例えば、TurboLaser のバスはどのノードにアタッチされたかをプリントします。 BUS_PRINT_CHILD によって出力されるメッセージの適切なフォーマット に関しての更なる情報は .Xr bus_generic_print_child 9 を見てください。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 戻り値 出力の文字数です。 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/BUS_READ_IVAR.9 b/ja_JP.eucJP/man/man9/BUS_READ_IVAR.9 index 2704b9bf03..8a5eca4943 100644 --- a/ja_JP.eucJP/man/man9/BUS_READ_IVAR.9 +++ b/ja_JP.eucJP/man/man9/BUS_READ_IVAR.9 @@ -1,64 +1,64 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/BUS_READ_IVAR.9,v 1.3.2.3 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/BUS_READ_IVAR.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/BUS_READ_IVAR.9,v 1.5 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_READ_IVAR 9 .Os .Sh 名称 .Nm BUS_READ_IVAR , .Nm BUS_WRITE_IVAR .Nd バス特有のデバイスインスタンス変数の操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn BUS_READ_IVAR "device_t dev" "device_t child" "int index" "uintptr_t *result" .Ft int .Fn BUS_WRITE_IVAR "device_t dev" "device_t child" "int index" "uintptr_t value" .Sh 解説 これらの 2 つのメソッドは子デバイスのバス特有のインスタンス変数の組 を管理します。 その意図は、異なった型のバスはそれぞれが適当なインスタンス変数 の組(ISA バスにおける port や irq という具合に)を定義するということです。 .Pp この情報は構造体として子デバイスに与えられることも出来ましたが、 そうすると、全てのドライバを編集し再コンパイルするという作業なしには、 バスが変数を追加したり削除したりすることは困難になります。 この作業はベンダが供給するバイナリのドライバでは不可能かもしれません。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/BUS_SETUP_INTR.9 b/ja_JP.eucJP/man/man9/BUS_SETUP_INTR.9 index 6c496e84de..6b99ed8471 100644 --- a/ja_JP.eucJP/man/man9/BUS_SETUP_INTR.9 +++ b/ja_JP.eucJP/man/man9/BUS_SETUP_INTR.9 @@ -1,72 +1,72 @@ .\" Copyright (c) 2000 Jeroen Ruigrok van der Werven .\" 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/share/man/man9/BUS_SETUP_INTR.9,v 1.1.2.5 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/BUS_SETUP_INTR.9,v 1.1.2.6 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/BUS_SETUP_INTR.9,v 1.4 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd April 2, 2000 .Dt BUS_SETUP_INTR 9 .Os .Sh 名称 .Nm BUS_SETUP_INTR .Nd 割り込みハンドラの作成と接続 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn BUS_SETUP_INTR "device_t dev" "device_t child" "struct resource *irq" "int flags" "driver_intr_t *intr" "void *arg" "void **cookiep" .Sh 解説 メソッド .Nm は、資源マネージャの .Xr BUS_ALLOC_RESOURCE 9 メソッドによって以前に割り当てられた割り込みに対し、 割り込みハンドラを生成してアタッチします。 ハンドラ .Fa intr は唯一の引数 .Fa arg の値を伴なって呼び出されます。 .Pp 割り込みハンドラは、 .Fn BUS_TEARDOWN_INTR によってデタッチされます。 正しい割り込みハンドラを破棄するために、クッキーが .Fn BUS_TEARDOWN_INTR に渡される必要があります。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr BUS_TEARDOWN_INTR 9 , .Xr device 9 , .Xr driver 9 .Sh 作者 .An -nosplit このマニュアルページは、 .An Doug Rabson .Aq dfr@FreeBSD.org が書いた BUS_CREATE_INTR および BUS_CONNECT_INTR のマニュアルページを基に、 .An Jeroen Ruigrok van der Werven .Aq asmodai@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man9/DEVICE_ATTACH.9 b/ja_JP.eucJP/man/man9/DEVICE_ATTACH.9 index b111bc0f46..0ebca457a5 100644 --- a/ja_JP.eucJP/man/man9/DEVICE_ATTACH.9 +++ b/ja_JP.eucJP/man/man9/DEVICE_ATTACH.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/DEVICE_ATTACH.9,v 1.3.2.3 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/DEVICE_ATTACH.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/DEVICE_ATTACH.9,v 1.6 2001/08/17 06:26:56 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_ATTACH 9 .Os .Sh 名称 .Nm DEVICE_ATTACH .Nd デバイスのアタッチ .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn DEVICE_ATTACH "device_t dev" .Sh 解説 デバイスをシステムにアタッチします。 プローブメソッドは既に呼び出されているでしょうし、 デバイスが存在していると示されているでしょう。 このルーチンはハードウェアの初期化と その他のシステムリソース ( .Pa dev エントリなど) の割り当てを行なうべきです。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr DEVICE_DETACH 9 , .Xr DEVICE_PROBE 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/DEVICE_DETACH.9 b/ja_JP.eucJP/man/man9/DEVICE_DETACH.9 index 7f914d9241..90c8bc8444 100644 --- a/ja_JP.eucJP/man/man9/DEVICE_DETACH.9 +++ b/ja_JP.eucJP/man/man9/DEVICE_DETACH.9 @@ -1,62 +1,62 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/DEVICE_DETACH.9,v 1.3.2.4 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/DEVICE_DETACH.9,v 1.3.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/DEVICE_DETACH.9,v 1.6 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_DETACH 9 .Os .Sh 名称 .Nm DEVICE_DETACH .Nd デバイスのデタッチ .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn DEVICE_DETACH "device_t dev" .Sh 解説 デバイスをデタッチします。 ユーザがドライバソフトウェアを置き換えた場合、またはデバイスが システムから物理的に切り離されようとしている場合(たとえば pccard デバイス)に、 呼び出されることができます。 .Pp このメソッドは .Xr DEVICE_ATTACH 9 メソッドで割り当てられたあらゆるシステムリソースを開放し、 ハードウェアを健全な状態にリセットする (つまり割り込みをディセーブルするなど)べきです。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr DEVICE_ATTACH 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/DEVICE_PROBE.9 b/ja_JP.eucJP/man/man9/DEVICE_PROBE.9 index d7432559f9..31af376c14 100644 --- a/ja_JP.eucJP/man/man9/DEVICE_PROBE.9 +++ b/ja_JP.eucJP/man/man9/DEVICE_PROBE.9 @@ -1,88 +1,88 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/DEVICE_PROBE.9,v 1.4.2.5 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/DEVICE_PROBE.9,v 1.4.2.6 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/DEVICE_PROBE.9,v 1.5 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Os .Dt DEVICE_PROBE 9 .Os .Sh 名称 .Nm DEVICE_PROBE .Nd デバイスの存在のプローブ .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn DEVICE_PROBE "device_t dev" .Sh 解説 このデバイスメソッドはデバイスがあるかどうかを知るためにプローブするべきです。 デバイスが存在すれば 0 を、デバイスが見つからなければ .Er ENXIO を返すべきです。 プローブの間にその他のエラー(メモリ割当の失敗など)が起こった場合は、 適切なエラーコードが返されるべきです。 1 つのデバイスに 1 つ以上のドライバが当てはまるような場合のために、 優先順位を返すことができます。 この場合、成功の値は 0 以下の値で、 最も大きな値が最も適切であることを意味します。 失敗の値は正の値で表現され、 通常の UNIX エラーコードが目的に応じて使用されるべきです。 .Pp ドライバが 0 より小さい成功値を返す場合、 ドライバはそのデバイスにアタッチされるのが 同じドライバであると想定してはいけません。 特に、softc 構造体に格納されたすべての値が アタッチメソッドで利用可能であると想定してはいけませんし、 また、アタッチメソッドが呼ばれた場合、 プローブの間に割り当てられたあらゆるリソースは開放して 再割り当てしなければなりません。 成功値 0 を返す場合には、 ドライバはそのドライバがアタッチされると想定することができます。 .Pp バスを実装するデバイスは、 バスに接続されたデバイスの存在をプローブし それらを子デバイスとして追加するために、 このメソッドを使用するべきです。 このメソッドが .Xr bus_generic_attach 9 の使用と結合していれば、 子デバイスは自動的にプローブされ、アタッチされるでしょう。 .Sh 戻り値 0 以下の値は成功を表し、0 より大きな値はエラー(errno)を表します。 0 以下の値の時、0 は最高の優先順位を表し、それ以上のプローブは行ないません。 0 未満の値は、低い値程、低い優先順位を表します。 たとえば、-100 は -50 よりも低い優先順位を表します。 .Sh 関連項目 .Xr device 9 , .Xr DEVICE_ATTACH 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/DEVICE_SHUTDOWN.9 b/ja_JP.eucJP/man/man9/DEVICE_SHUTDOWN.9 index 82110d7bb1..fba47b31d2 100644 --- a/ja_JP.eucJP/man/man9/DEVICE_SHUTDOWN.9 +++ b/ja_JP.eucJP/man/man9/DEVICE_SHUTDOWN.9 @@ -1,55 +1,55 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/DEVICE_SHUTDOWN.9,v 1.2.2.3 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/DEVICE_SHUTDOWN.9,v 1.2.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/DEVICE_SHUTDOWN.9,v 1.5 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_SHUTDOWN 9 .Os .Sh 名称 .Nm DEVICE_SHUTDOWN .Nd システムシャットダウンの間に呼ばれる .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn DEVICE_SHUTDOWN "device_t dev" .Sh 解説 システムシャットダウンの間に呼び出され、 ドライバがハードウェアをコンピュータがリブートしても構わない状態にすることを 可能にします。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合にはエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr DEVICE_ATTACH 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/DRIVER_MODULE.9 b/ja_JP.eucJP/man/man9/DRIVER_MODULE.9 index f3567d1bda..7fe3615dd7 100644 --- a/ja_JP.eucJP/man/man9/DRIVER_MODULE.9 +++ b/ja_JP.eucJP/man/man9/DRIVER_MODULE.9 @@ -1,112 +1,112 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 2000 Alexander Langer .\" .\" 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. .\" .\" 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/share/man/man9/DRIVER_MODULE.9,v 1.1.2.4 2001/08/28 07:12:36 alex Exp % +.\" %FreeBSD: src/share/man/man9/DRIVER_MODULE.9,v 1.1.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/DRIVER_MODULE.9,v 1.4 2001/08/18 23:50:58 horikawa Exp $ +.\" $FreeBSD$ .Dd May 16, 2000 .Dt DRIVER_MODULE 9 .Os .Sh 名称 .Nm DRIVER_MODULE .Nd カーネルドライバ宣言マクロ .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In sys/bus.h +.In sys/module.h .Fn DRIVER_MODULE name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg" .Fn MULTI_DRIVER_MODULE name busname "driver_t drivers[]" "devclass_t devclass" "modeventhand_t evh" "void *arg" .Sh 解説 .Fn DRIVER_MODULE マクロは、カーネルドライバを宣言します。 .Fn DRIVER_MODULE は実際のドライバ宣言に展開し、そこで .Fa name はドライバとその関数の接頭辞として使用されます。 これはプレインテキストとして与えられ、 .Li char または .Li char * ではないことに注意してください。 .Pp .Fa busname はドライバの親のバス (PCI, ISA, PPBUS, その他) で、 .Ql pci , .Ql isa , .Ql ppbus 等です。 .Pp .Fn DRIVER_MODULE の中で使用される識別子は、ドライバの名前と別のものにすることができます。 また、異なるバス上には同じドライバ識別子が存在できます。 これは、同じドライバを使用する同一または異なるバス上の種々のカード用に、 フロントエンドをうまくきれいに作成する方法です。 例えば、次のようにできます。 .Pp .Fn DRIVER_MODULE foo isa foo_driver foo_devclass NULL NULL ; .Pp .Fn DRIVER_MODULE foo pci foo_driver foo_devclass NULL NULL ; .Pp .Fa driver は .Li driver_t 型のドライバで、ドライバについての情報を含み、それゆえ .Fn DRIVER_MODULE を呼び出すための最も重要な 2 つの部分のうちの 1 つです。 .Pp 引数 .Fa devclass はデバイスについてのカーネル内部の情報を含み、 カーネルドライバモジュールの内部で使用されます。 .Pp 引数 .Fa evh はドライバ (またはモジュール) がロードまたはアンロードされた時に 呼び出されるイベントハンドラです ( .Xr module 9 を参照してください)。 .Pp 現時点では .Fa arg は使用されず、 .Dv NULL ポインタであるべきです。 .Pp .Fn MULTI_DRIVER_MODULE は .Fn DRIVER_MODULE の特殊バージョンであり、 単一のドライバインスタンスの代りにドライバリストを取ります。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 , .Xr module 9 .Sh 作者 このマニュアルページは .An Alexander Langer Aq alex@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man9/MD5.9 b/ja_JP.eucJP/man/man9/MD5.9 index 5c78f97791..582721a677 100644 --- a/ja_JP.eucJP/man/man9/MD5.9 +++ b/ja_JP.eucJP/man/man9/MD5.9 @@ -1,77 +1,77 @@ .\" $OpenBSD: md5.9,v 1.1 1996/04/17 21:40:14 mickey Exp $ .\" .\" Copyright (c) 1996 Michael Shalayeff .\" 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 Michael Shalayeff .\" 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/share/man/man9/MD5.9,v 1.5.2.2 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/MD5.9,v 1.5.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/MD5.9,v 1.4 2001/05/14 01:10:21 horikawa Exp $ +.\" $FreeBSD$ .Dd April 17, 1996 .Dt MD5 9 .Os .Sh 名称 .Nm MD5 , .Nm MD5Init , .Nm MD5Transform .Nd メッセージダイジェストルーチン .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/md5.h .Ft void .Fn MD5Init "MD5_CTX *buf" .Ft void .Fn MD5Transform "u_int32_t buf[4]" "const unsigned char block[64]" .Sh 解説 .Nm モジュールは、RSA Data Security, Inc. の MD5 メッセージダイジェスト アルゴリズム(MD5)を実装しています。 これはデータの 128 ビットの MD5 ダイジェストを生成します。 .Pp .Bl -hang -width MD5Transformxx .It Pa MD5Init ダイジェストを生成するために .Fn MD5Transform を使用する直前に呼び出さなくてはなりません。 引数 .Fa buf は次に続いて呼ばれる .Fn MD5Transform ルーチンが生成するダイジェストの格納領域です。 .It Pa MD5Transform MD5 アルゴリズムの中核で、 引数 .Fa block で渡される 64 文字の新しいデータの追加を反映するように、 .Fa buf に格納してある MD5 ハッシュを変更します。 .El .Sh 著作権 MD5 変換のコードはパブリックドメインに置かれていた Colin Plumb の 実装から得ています。 MD5 暗号化チェックサムは Ronald Rivest が考案し、 RFC 1321 "The MD5 Message Digest Algorithm" に記述されています。 diff --git a/ja_JP.eucJP/man/man9/VFS_CHECKEXP.9 b/ja_JP.eucJP/man/man9/VFS_CHECKEXP.9 index 4ede5ba764..5d52ddc504 100644 --- a/ja_JP.eucJP/man/man9/VFS_CHECKEXP.9 +++ b/ja_JP.eucJP/man/man9/VFS_CHECKEXP.9 @@ -1,89 +1,89 @@ .\" .\" Copyright (c) 1999 Alfred Perlstein .\" .\" 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 condition .\" is met: .\" Redistributions of source code must retain the above copyright .\" notice, this condition and the following disclaimer. .\" .\" 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/share/man/man9/VFS_CHECKEXP.9,v 1.2.2.3 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VFS_CHECKEXP.9,v 1.2.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VFS_CHECKEXP.9,v 1.4 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd September 10, 1999 .Os .Dt VFS_CHECKEXP 9 .Sh 名称 .Nm VFS_CHECKEXP .Nd vnode がクライアントにエクスポートされているかどうかをチェック .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h .Ft int .Fn VFS_CHECKEXP "struct mount *mp" "struct mbuf *nam" "int *exflagsp" "struct ucred **credanonp" .Sh 解説 これは、クライアントにマウントポイントがエクスポート されているかどうかをチェックするために、NFS サーバが使用します。 .Pp 引数は以下の通りです。 .Bl -tag -width credanonp .It Ar mp チェック対象のマウントポイント。 .It Ar nam クライアントのネットワークアドレスを含む mbuf。 .It Ar exflagsp このクライアントに対する、エクスポートフラグの戻り値。 .It Ar credanonp このクライアントに対する、匿名の証明の戻り値。 .El .Pp ファイルシステムのマウント構造に対して呼び出して、 .Fa nam にアドレスが含まれるクライアントに対してそのファイルシステムが エクスポートされているかどうかを決定できます。 .Pp 一般的には、 クライアントがファイルシステムにアクセス可能かを確認するために、 .Xr VFS_FHTOVP 9 の前に呼び出されます。 .Pp ファイルシステムは、 クライアントがファイルシステムをアクセスできるかを実証するために、 .Dv netexport 構造体の適切なアドレス、クライアントのアドレス、および .Fa nam を伴って、 .Xr vfs_export_lookup 9 を呼び出すべきです。 .Sh 戻り値 そのクライアントに対するエクスポートフラグと ( .Xr vfs_export_lookup 9 から返される) 匿名の証明が .Fa *exflagsp と .Fa *credanonp に返されるでしょう。 .Sh 関連項目 .Xr VFS 9 , .Xr VFS_FHTOVP 9 , .Xr VFS_VPTOFH 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Alfred Perlstein が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_FHTOVP.9 b/ja_JP.eucJP/man/man9/VFS_FHTOVP.9 index f6491eef01..c693582a28 100644 --- a/ja_JP.eucJP/man/man9/VFS_FHTOVP.9 +++ b/ja_JP.eucJP/man/man9/VFS_FHTOVP.9 @@ -1,82 +1,82 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_FHTOVP.9,v 1.6.2.4 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VFS_FHTOVP.9,v 1.6.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VFS_FHTOVP.9,v 1.6 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_FHTOVP 9 .Sh 名称 .Nm VFS_FHTOVP .Nd NFS ファイルハンドルから vnode への変換 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_FHTOVP "struct mount *mp" "struct fid *fhp" "struct vnode **vpp" .Sh 解説 これは NFS ファイルハンドルから vnode へ 変換するために NFS サーバによって使用されます。 .Pp 引数は以下の通りです。 .Bl -tag -width vpp .It Ar mp ファイルシステム。 .It Ar fhp 変換されるファイルハンドル。 .It Ar vpp 新しい、ロックされた vnode の戻り値。 .El .Pp ファイルハンドルの内容は、ファイルシステムによって定義されていて、 システムの他の部分によって検査されません。 ファイルが削除された時や新しいファイルのためにファイルシステムの資源が 再利用された時の通知と同じ程度に、ファイルシステムの中のファイルを 独自に識別するための十分な情報を含んでいるべきです。 例えば、UFS ファイルシステムは、ファイルハンドルの中に inode 番号 および inode 世代カウンタを格納します。 .Pp 一般的にはこの関数への呼び出し前は、そのファイルがクライアントにとって アクセス可能であるかどうかを検査するために .Xr VFS_CHECKEXP 9 呼び出しが行われます。 .Sh 戻り値 そのファイルのロックされた vnode が .Fa *vpp に返されます。 .Sh 関連項目 .Xr VFS 9 , .Xr VFS_CHECKEXP 9 , .Xr VFS_VPTOFH 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_INIT.9 b/ja_JP.eucJP/man/man9/VFS_INIT.9 index 3f1dcefcb1..4c1f53e004 100644 --- a/ja_JP.eucJP/man/man9/VFS_INIT.9 +++ b/ja_JP.eucJP/man/man9/VFS_INIT.9 @@ -1,56 +1,56 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_INIT.9,v 1.6 1999/08/28 00:21:08 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_INIT.9,v 1.6.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_INIT 9 .Sh 名称 .Nm VFS_INIT .Nd ファイルシステムの初期化 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_INIT .Sh 解説 この関数は、ファイルシステムが保持可能な 全ての大域データ構造体を初期化するために、一度だけ呼び出されます。 オペレーティングシステムの起動時または、 動的に読み込まれたファイルシステムでは ファイルシステムを含むカーネルモジュールが読み込まれた時に、呼び出されます。 .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_MOUNT.9 b/ja_JP.eucJP/man/man9/VFS_MOUNT.9 index 31f5b607a8..1b435cb431 100644 --- a/ja_JP.eucJP/man/man9/VFS_MOUNT.9 +++ b/ja_JP.eucJP/man/man9/VFS_MOUNT.9 @@ -1,92 +1,92 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_MOUNT.9,v 1.7 2000/03/03 14:05:05 sheldonh Exp % +.\" %FreeBSD: src/share/man/man9/VFS_MOUNT.9,v 1.7.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_MOUNT 9 .Sh 名称 .Nm VFS_MOUNT .Nd ファイルシステムのマウント .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_MOUNT "struct mount *mp" "char *path" "caddr_t data" "struct nameidata *ndp" "struct proc *p" .Sh 解説 システムの名前空間にファイルシステムをマウントします。 .Pp 引数は以下の通りです。 .Bl -tag -width data .It Ar mp ファイルシステムを表現する構造体。 .It Ar path そのファイルシステムがマウントされるパス名。 .It Ar data ファイルシステム固有データ。これはカーネルに .Xr copyin 9 を使用して読み込まれるべきです。 .It Ar ndp マウントポイントのパス名での .Xr namei 9 の呼び出しの結果。 .It Ar p ファイルシステムをマウントしようとしているプロセス。 .El .Pp これは、新しいファイルシステムをマウントする目的と、 既存のファイルシステムの属性変更の目的の、両方の用途で呼び出されます。 .Fa mp->mnt_flag に .Dv MNT_UPDATE フラグが設定されている場合には、ファイルシステムは .Fa mp->mnt_flag の値により内部状態を更新するべきです。 例えば、読み取り専用ファイルシステムから読み書き可能への変換に 使用されることが可能です。 また、 .Xr mountd 8 によってファイルシステムの NFS エクスポート情報の更新にも使用されています。 .Pp .Dv MNT_UPDATE フラグが設定されていない場合には、 これは新規にマウントされたファイルシステムです。 ファイルシステムのコードは、ファイルシステムの表現に必要な私的データの 割り当てと初期化を行なうべきです (この情報を格納するために .Fa mp->mnt_data フィールドを使用可能です)。 .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_QUOTACTL.9 b/ja_JP.eucJP/man/man9/VFS_QUOTACTL.9 index 1a1d1fade0..77b29138b4 100644 --- a/ja_JP.eucJP/man/man9/VFS_QUOTACTL.9 +++ b/ja_JP.eucJP/man/man9/VFS_QUOTACTL.9 @@ -1,55 +1,55 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_QUOTACTL.9,v 1.5 1999/08/28 00:21:08 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_QUOTACTL.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_QUOTACTL 9 .Sh 名称 .Nm VFS_QUOTACTL .Nd ファイルシステムクォータの操作 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_QUOTACTL "struct mount *mp" "int cmds" "uid_t uid" "caddr_t arg" "struct proc *p" .Sh 解説 ファイルシステムのクォータを実装します。 引数についての解説は .Xr quotactl 2 を参照してください。 .Sh 関連項目 .Xr quotactl 2 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_ROOT.9 b/ja_JP.eucJP/man/man9/VFS_ROOT.9 index 2c6c380129..fe36f30e95 100644 --- a/ja_JP.eucJP/man/man9/VFS_ROOT.9 +++ b/ja_JP.eucJP/man/man9/VFS_ROOT.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_ROOT.9,v 1.5 1999/08/28 00:21:08 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_ROOT.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_ROOT 9 .Sh 名称 .Nm VFS_ROOT .Nd ファイルシステムのルート vnode の取得 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_ROOT "struct mount *mp" "struct vnode **vpp" .Sh 解説 ファイルシステムのルートディレクトリに対する、ロックされた vnode を返します。 .Pp 引数は以下の通りです。 .Bl -tag -width vpp .It Ar mp ファイルシステム。 .It Ar vpp ルート vnode の引数の戻り値。 .El .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_START.9 b/ja_JP.eucJP/man/man9/VFS_START.9 index 7a76f1a5b5..145611a568 100644 --- a/ja_JP.eucJP/man/man9/VFS_START.9 +++ b/ja_JP.eucJP/man/man9/VFS_START.9 @@ -1,63 +1,63 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_START.9,v 1.5 1999/08/28 00:21:09 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_START.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_START 9 .Sh 名称 .Nm VFS_START .Nd ファイルシステムを操作可能にする .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_START "struct mount *mp" "int flags" "struct proc *p" .Sh 解説 これは .Xr VFS_MOUNT 9 の後且つファイルシステムへの最初のアクセスの前に呼び出されます。 引数は以下の通りです。 .Bl -tag -width flags .It Ar mp ファイルシステム。 .It Ar flags ?? .It Ar p ファイルシステムを起動しているプロセス。 .El .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_STATFS.9 b/ja_JP.eucJP/man/man9/VFS_STATFS.9 index af76599bce..22e5ff4364 100644 --- a/ja_JP.eucJP/man/man9/VFS_STATFS.9 +++ b/ja_JP.eucJP/man/man9/VFS_STATFS.9 @@ -1,63 +1,63 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_STATFS.9,v 1.5 1999/08/28 00:21:09 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_STATFS.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_STATFS 9 .Sh 名称 .Nm VFS_STATFS .Nd ファイルシステムの状態の取得 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_STATFS "struct mount *mp" "struct statfs *sbp" "struct proc *p" .Sh 解説 この呼び出しは、ファイルシステムについての様々な情報を返します。 この情報には、推奨されている入出力サイズ、空き領域、空き inode 等があります。 .Pp 引数は以下の通りです。 .Bl -tag -width sbp .It Ar mp ファイルシステム。 .It Ar sbp ファイルシステムの状態のための戻り値。 .It Ar p ファイルシステムに問い合わせているプロセス。 .El .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_SYNC.9 b/ja_JP.eucJP/man/man9/VFS_SYNC.9 index b1aea5d5a7..5d6ca5e920 100644 --- a/ja_JP.eucJP/man/man9/VFS_SYNC.9 +++ b/ja_JP.eucJP/man/man9/VFS_SYNC.9 @@ -1,71 +1,71 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_SYNC.9,v 1.6 1999/08/28 00:21:09 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_SYNC.9,v 1.6.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_SYNC 9 .Sh 名称 .Nm VFS_SYNC .Nd 未書き込みデータの吐き出し .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_SYNC "struct mount *mp" "int waitfor" "struct ucred *cred" "struct proc *p" .Sh 解説 これはファイルシステムの全ての未書き込みのデータを書き出します。 .Pp 引数は以下の通りです。 .Bl -tag -width waitfor .It Ar mp ファイルシステム。 .It Ar waitfor 関数が入出力の完了まで待つべきかどうか。 .It Ar cred 呼び出し元の証明。 .It Ar p 呼び出しているプロセス。 .El .Pp これは、通常、ファイルシステム中の全ての vnode のために .Xr VOP_FSYNC 9 を呼び出します。 .Sh 関連項目 .Xr fsync 2 , .Xr sync 2 , .Xr VFS 9 , .Xr vnode 9 , .Xr VOP_FSYNC 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_UNMOUNT.9 b/ja_JP.eucJP/man/man9/VFS_UNMOUNT.9 index 1c4d037fcd..b88226dd01 100644 --- a/ja_JP.eucJP/man/man9/VFS_UNMOUNT.9 +++ b/ja_JP.eucJP/man/man9/VFS_UNMOUNT.9 @@ -1,66 +1,66 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_UNMOUNT.9,v 1.5 1999/08/28 00:21:10 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_UNMOUNT.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_UNMOUNT 9 .Sh 名称 .Nm VFS_UNMOUNT .Nd ファイルシステムのアンマウント .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_UNMOUNT "struct mount *mp" "int mntflags" "struct proc *p" .Sh 解説 ファイルシステムをアンマウントします。 .Pp 引数は以下の通りです。 .Bl -tag -width mntflags .It Ar mp ファイルシステム。 .It Ar mntflags いろいろなフラグ。 .It Ar p ファイルシステムをアンマウントしているプロセス。 .El .Pp .Dv MNT_FORCE フラグが指定された場合には、開いているファイルは強制的に閉じられるべきです。 .Sh 関連項目 .Xr vflush 9 , .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_VGET.9 b/ja_JP.eucJP/man/man9/VFS_VGET.9 index 147a72bd74..e792f1d377 100644 --- a/ja_JP.eucJP/man/man9/VFS_VGET.9 +++ b/ja_JP.eucJP/man/man9/VFS_VGET.9 @@ -1,74 +1,74 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_VGET.9,v 1.5.2.1 2000/12/08 14:59:20 ru Exp % +.\" %FreeBSD: src/share/man/man9/VFS_VGET.9,v 1.5.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VFS_VGET.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_VGET 9 .Sh 名称 .Nm VFS_VGET .Nd inode 番号から vnode への変換 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_VGET "struct mount *mp" "ino_t ino" "struct vnode **vpp" .Sh 解説 これは inode 番号を、ロックされた vnode へ変換します。 .Pp 引数は以下の通りです。 .Bl -tag -width ino .It Ar mp ファイルシステム。 .It Ar ino そのファイルを表現する inode。 .It Ar vpp vnode の戻り値。 .El .Pp これは、ファイルシステム中の各ファイルに対して 一意の識別番号を持つファイルシステムのための、 オプションのファイルシステムエントリポイントです。 UFS ファイルシステムはこれを内部的に使用していますし、 また NFSv3 サーバは .Dv READDIRPLUS NFS 呼び出しを実装するために使用しています。 .Pp ファイルシステムがこの呼び出しをサポートしていない場合には、 .Er EOPNOTSUPP を返すべきです。 .Sh 関連項目 .Xr VFS 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VFS_VPTOFH.9 b/ja_JP.eucJP/man/man9/VFS_VPTOFH.9 index ac6d2a15fa..2ed51b3e2d 100644 --- a/ja_JP.eucJP/man/man9/VFS_VPTOFH.9 +++ b/ja_JP.eucJP/man/man9/VFS_VPTOFH.9 @@ -1,64 +1,64 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VFS_VPTOFH.9,v 1.6 1999/08/28 00:21:11 peter Exp % +.\" %FreeBSD: src/share/man/man9/VFS_VPTOFH.9,v 1.6.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VFS_VPTOFH 9 .Sh 名称 .Nm VFS_VPTOFH .Nd vnode から NFS ファイルハンドルへの変換 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h +.In sys/vnode.h .Ft int .Fn VFS_VPTOFH "struct vnode *vp" "struct fid *fhp" .Sh 解説 これは NFS サーバが使用し、 一意にファイルを識別する不透明なファイルハンドルを作成します。 このファイルハンドルを使用することにより、 将来 NFS クライアントがそのファイルをアクセス可能となります。 .Pp 引数は以下の通りです。 .Bl -tag -width fhp .It Ar vp ファイルハンドルを生成する対象の vnode。 .It Ar fhp ファイルハンドルの戻り値。 .El .Sh 関連項目 .Xr VFS 9 , .Xr VFS_FHTOVP 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_ACCESS.9 b/ja_JP.eucJP/man/man9/VOP_ACCESS.9 index cfa40cc692..68f47754a8 100644 --- a/ja_JP.eucJP/man/man9/VOP_ACCESS.9 +++ b/ja_JP.eucJP/man/man9/VOP_ACCESS.9 @@ -1,150 +1,150 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_ACCESS.9,v 1.7.2.3 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_ACCESS.9,v 1.7.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_ACCESS.9,v 1.4 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_ACCESS 9 .Sh 名称 .Nm VOP_ACCESS .Nd ファイルまたは UNIX ドメインソケットのアクセス許可の調査 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_ACCESS "struct vnode *vp" "int mode" "struct ucred *cred" "struct proc *p" .Sh 解説 このエントリポイントは、与えられた証明に対する、ファイルの アクセス許可を調査します。 .Pp 引数は以下の通りです。 .Bl -tag -width mode .It Ar vp 調査対象ファイルの vnode。 .It Ar mode 要求されたアクセスのタイプ。 .It Ar cred 調査対象のユーザ証明。 .It Ar p 調査しているプロセス。 .El .Pp .Fa mode は .Dv VREAD , .Dv VWRITE または .Dv VEXEC を含むマスクです。 .Sh ロック vnode は、入る時にロックされ、戻る時にもロックされ続けます。 .Sh 戻り値 ファイルが指定された方法でアクセス可能な場合には、0 が返されます。 そうでない場合には、適切なエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_access(struct vnode *vp, int mode, struct ucred *cred, struct proc *p) { int error; /* * ファイルがソケット、FIFO、またはファイルシステムに存在する * ブロック型または文字型デバイスでない場合には、読み込み専用 * ファイルシステムへの書き込みは認められません。 */ if (mode & VWRITE) { switch (vp->v_type) { case VDIR: case VLNK: case VREG: if (vp->v_mount->mnt_flag & MNT_RDONLY) return EROFS; break; } } /* 不変ビットが設定されていれば、誰も書き込めません。 */ if ((mode & VWRITE) && vp has immutable bit set) return EPERM; /* そうでなければ、uid が 0 ならば常に許可。 */ if (cred->cr_uid == 0) return 0; mask = 0; /* そうでなければ、所有者を調べます。 */ if (cred->cr_uid == owner of vp) { if (mode & VEXEC) mask |= S_IXUSR; if (mode & VREAD) mask |= S_IRUSR; if (mode & VWRITE) mask |= S_IWUSR; return (((mode of vp) & mask) == mask ? 0 : EACCES); } /* そうでなければ、グループを調べます。 */ for (i = 0, gp = cred->cr_groups; i < cred->cr_ngroups; i++, gp++) if (group of vp == *gp) { if (mode & VEXEC) mask |= S_IXGRP; if (mode & VREAD) mask |= S_IRGRP; if (mode & VWRITE) mask |= S_IWGRP; return (((mode of vp) & mask) == mask ? 0 : EACCES); } /* そうでなければ、その他を調べます。 */ if (mode & VEXEC) mask |= S_IXOTH; if (mode & VREAD) mask |= S_IROTH; if (mode & VWRITE) mask |= S_IWOTH; return (((mode of vp) & mask) == mask ? 0 : EACCES); } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er EPERM 不変ファイルを変更しようとしました。 .It Bq Er EACCES 許可されません。 .El .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_ACLCHECK.9 b/ja_JP.eucJP/man/man9/VOP_ACLCHECK.9 index c7a9f437b6..c10a859bbf 100644 --- a/ja_JP.eucJP/man/man9/VOP_ACLCHECK.9 +++ b/ja_JP.eucJP/man/man9/VOP_ACLCHECK.9 @@ -1,100 +1,100 @@ .\"- .\" Copyright (c) 1999 Robert N. M. Watson .\" 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/share/man/man9/VOP_ACLCHECK.9,v 1.1.2.2 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_ACLCHECK.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_ACLCHECK.9,v 1.2 2001/05/14 01:10:21 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt VOP_ACLCHECK 9 .Sh 名称 .Nm VOP_ACLCHECK .Nd vnode のアクセス制御リストの調査 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/acl.h .Ft int .Fn VOP_ACLCHECK "struct vnode *vp" "acl_type_t type" "struct acl *aclp" "struct ucred *cred" "struct proc *p" .Sh 解説 この vnode 呼び出しは、特定のファイルまたはディレクトリに対する 特定のアクセス制御リスト (ACL) の妥当性を決定するために、使用可能です。 .Pp 引数は以下の通りです。 .Bl -tag -width type .It Ar vp ファイルまたはディレクトリの vnode。 .It Ar type 調査対象の ACL の型。 .It Ar aclp ACL データの取り出し元の ACL 構造体を指しているポインタ。 .It Ar cred 要求の認証のために使用されるユーザ証明。 .It Ar p ACL を調査しているプロセス。 .El .Pp .Fa cred ポインタは、NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この cred の設定は、アクティブプロセスに許されていない ACL 証明を、 カーネルが正当化することを認めるために使用可能です。 .Pp vnode ACL インタフェースは、ファイルまたはディレクトリの ACL インタフェースの セマンティクスではなく文法を定義します。 カーネル内の ACL 管理についての詳細な情報は .Xr acl 9 を参照してください。 .Sh ロック この vnode メソッドの呼び出しのためにロックは不要で、 入る時に保持していた全てのロックは戻る時まで保持されます。 .Sh 戻り値 .Fa vp オブジェクトのための .Fa type 型の有効な ACL を .Fa aclp ポインタが指している場合には 0 が返されます。 そうでない場合には適切なエラーコードが返されます。 .Sh エラー .Bl -tag -width Er .It Bq Er EINVAL 渡された vnode の ACL 型が無効または ACL データが無効です。 .It Bq Er EACCES 許可されませんでした。 .It Bq Er ENOMEM 要求を実行するためのメモリが十分ではありません。 .It Bq Er EOPNOTSUPP ファイルシステムが VOP_ACLCHECK をサポートしていません。 .El .Sh 関連項目 .Xr acl 9 , .Xr vnode 9 , .Xr VOP_GETACL 9 , .Xr VOP_SETACL 9 .Sh 作者 このマニュアルページは .An Robert Watson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_ADVLOCK.9 b/ja_JP.eucJP/man/man9/VOP_ADVLOCK.9 index 9365fe9c91..78fc1c0298 100644 --- a/ja_JP.eucJP/man/man9/VOP_ADVLOCK.9 +++ b/ja_JP.eucJP/man/man9/VOP_ADVLOCK.9 @@ -1,85 +1,85 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_ADVLOCK.9,v 1.6.2.2 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_ADVLOCK.9,v 1.6.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_ADVLOCK.9,v 1.3 2001/07/29 05:15:41 horikawa Exp $ +.\" $FreeBSD$ .Dd June 30, 1999 .Os .Dt VOP_ADVLOCK 9 .Sh 名称 .Nm VOP_ADVLOCK .Nd 問合せ型レコードロック .Sh 書式 -.Fd #include -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/fcntl.h +.In sys/lockf.h .Ft int .Fn VOP_ADVLOCK "struct vnode *vp" "caddr_t id" "int op" "struct flock *fl" "int flags" .Sh 解説 引数は以下の通りです。 .Bl -tag -width flags .It Ar vp 操作されている vnode。 .It Ar id ロックを変更している識別トークン。 .It Ar op 実行するべき操作 ( .Xr fcntl 2 を参照してください)。 .It Ar fl ロックの記述。 .It Ar flags 以下の値のひとつ以上。 .Bl -column F_UNLCK -offset indent .It Dv F_RDLCK Ta 共有または読み込みロック .It Dv F_UNLCK Ta ロック解除 .It Dv F_WRLCK Ta 排他的または書き込みロック .It Dv F_WAIT Ta ロックが承認されるまで待機 .It Dv F_FLOCK Ta ロックのために .Xr flock 2 のセマンティクス使用 .It Dv F_POSIX Ta ロックのために POSIX のセマンティクスを使用 .El .El .Pp このエントリポイントは、ファイルの問合せ型レコードロックを操作します。 ほとんどのファイルシステムは、この呼び出しのための作業を .Fn lf_advlock に委任します。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr fcntl 2 , .Xr flock 2 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_ATTRIB.9 b/ja_JP.eucJP/man/man9/VOP_ATTRIB.9 index 612cd384b2..4864615cd5 100644 --- a/ja_JP.eucJP/man/man9/VOP_ATTRIB.9 +++ b/ja_JP.eucJP/man/man9/VOP_ATTRIB.9 @@ -1,160 +1,160 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_ATTRIB.9,v 1.9.2.1 2000/03/16 22:43:43 chris Exp % +.\" %FreeBSD: src/share/man/man9/VOP_ATTRIB.9,v 1.9.2.2 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_ATTRIB 9 .Sh 名称 .Nm VOP_GETATTR , .Nm VOP_SETATTR .Nd ファイルまたはディレクトリの属性の取得または設定 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_GETATTR "struct vnode *vp" "struct vattr *vap" "struct ucred *cred" "struct proc *p" .Ft int .Fn VOP_SETATTR "struct vnode *vp" "struct vattr *vap" "struct ucred *cred" "struct proc *p" .Sh 解説 これらのエントリポイントは、 ファイルまたはディレクトリの様々な属性を操作します。 操作対象には、ファイルパーミッション、所有者、グループ、 大きさ、アクセス時刻、更新時刻を含みます。 .Pp 引数は以下の通りです。 .Bl -tag -width cred .It Ar vp ファイルの vnode。 .It Ar vap ファイルの属性。 .It Ar cred 呼び出したプロセスのユーザ証明。 .It Ar p プロセス。 .El .Pp .Xr VOP_SETATTR 9 によって更新されようとしていない属性は .Dv VNOVAL が設定されているべきです。 .Sh ロック .Xr VOP_GETATTR 9 は、入る時に vnode がロックされていて、戻り時まで vnode がロックされたままで あることを期待します。 .Pp .Xr VOP_SETATTR 9 は、入る時に vnode がロックされていて、戻り時まで vnode がロックされたままで あることを期待します。 .Sh 戻り値 .Xr VOP_GETATTR 9 は .Fa *vap にファイルの情報を返します。 .Xr VOP_SETATTR 9 は属性がうまく変更された場合には 0 を返し、 そうでない場合には適切なエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_getattr(struct vnode *vp, struct vattr *vap, struct ucred *cred, struct proc *p) { /* * *vap をファイルシステムからの情報で埋めます。 */ ...; return 0; } int vop_setattr(struct vnode *vp, struct vattr *vap, struct ucred *cred, struct proc *p) { /* * 設定できない属性をチェックします。 */ if ((vap->va_type != VNON) || (vap->va_nlink != VNOVAL) || (vap->va_fsid != VNOVAL) || (vap->va_fileid != VNOVAL) || (vap->va_blocksize != VNOVAL) || (vap->va_rdev != VNOVAL) || ((int)vap->va_bytes != VNOVAL) || (vap->va_gen != VNOVAL)) { return (EINVAL); } if (vap->va_flags != VNOVAL) { /* * ファイルの変更不能と追加フラグを設定します。 */ } if (vap->va_uid != (uid_t)VNOVAL || vap->va_gid != (gid_t)VNOVAL) { /* * ファイルの所有者および/またはグループを変更します。 */ } if (vap->va_size != VNOVAL) { /* * ファイルを指定された大きさに切り詰めます。 */ } if (vap->va_atime.tv_sec != VNOVAL || vap->va_mtime.tv_sec != VNOVAL) { /* * ファイルのアクセスおよび/または更新時刻を変更します。 */ } if (vap->va_mode != (mode_t)VNOVAL) { /* * ファイルのパーミッションを変更します。 */ } return 0; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er EPERM ファイルは変更不可能です。 .It Bq Er EACCES 許可されませんでした。 .It Bq Er EROFS ファイルシステムが読み込み専用です。 .El .Sh 関連項目 .Xr vnode 9 , .Xr VOP_ACCESS 9 .Sh AUTHORS このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_BWRITE.9 b/ja_JP.eucJP/man/man9/VOP_BWRITE.9 index 5c4879e63d..55525502e1 100644 --- a/ja_JP.eucJP/man/man9/VOP_BWRITE.9 +++ b/ja_JP.eucJP/man/man9/VOP_BWRITE.9 @@ -1,58 +1,58 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_BWRITE.9,v 1.5.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_BWRITE.9,v 1.5.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_BWRITE.9,v 1.2 2001/05/14 01:10:21 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_BWRITE 9 .Sh 名称 .Nm VOP_BWRITE .Nd ファイルシステムバッファの書き込み .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_BWRITE "struct vnode *vp" "struct buf *bp" .Sh 解説 引数は以下の通りです。 .Bl -tag -width 2n .It Ar vp 書き込まれているファイルの vnode。 .It Ar bp 書き込まれるべきバッファ。 .El .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_CREATE.9 b/ja_JP.eucJP/man/man9/VOP_CREATE.9 index 5f2328e104..a1063541f7 100644 --- a/ja_JP.eucJP/man/man9/VOP_CREATE.9 +++ b/ja_JP.eucJP/man/man9/VOP_CREATE.9 @@ -1,189 +1,189 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_CREATE.9,v 1.9 1999/11/13 21:00:26 eivind Exp % +.\" %FreeBSD: src/share/man/man9/VOP_CREATE.9,v 1.9.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_CREATE 9 .Sh 名称 .Nm VOP_CREATE , .Nm VOP_MKNOD , .Nm VOP_MKDIR , .Nm VOP_SYMLINK .Nd ファイル、ソケット、FIFO、デバイス、ディレクトリまたはシンボリックリンクの作成 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/namei.h .Ft int .Fn VOP_CREATE "struct vnode *dvp" "struct vnode **vpp" "struct componentname *cnp" "struct vattr *vap" .Ft int .Fn VOP_MKNOD "struct vnode *dvp" "struct vnode **vpp" "struct componentname *cnp" "struct vattr *vap" .Ft int .Fn VOP_MKDIR "struct vnode *dvp" "struct vnode **vpp" "struct componentname *cnp" "struct vattr *vap" .Ft int .Fn VOP_SYMLINK "struct vnode *dvp" "struct vnode **vpp" "struct componentname *cnp" "struct vattr *vap" "char *target" .Sh 解説 これらのエントリポイントは、新しいファイル、ソケット、FIFO、デバイス、 ディレクトリまたはシンボリックリンクを、 指定されたディレクトリの中に作成します。 .Pp 引数は以下の通りです。 .Bl -tag -width target .It Ar dvp ディレクトリのロックされた vnode。 .It Ar vpp 作成結果のロックされた vnode が格納されるべき、変数のアドレス。 .It Ar cnp 生成された要素のパス名。 .It Ar vap 新しいオブジェクトの作成時に使用されるべき属性。 .It Ar target シンボリックリンクの対象のパス名。 .El .Pp これらのエントリポイントは、オブジェクトの生成中に .Xr VOP_LOOKUP 9 の後に呼び出されます。 通常、 .Xr VOP_LOOKUP 9 は .Dv SAVENAME フラグを .Fa cnp->cn_flags 中に設定して、 .Fa cnp->cn_pnbuf で指されるメモリを正当なままに保ちます。 ファイルの作成時にエラーが検出された場合には、このメモリは開放されます。 ファイルがうまく作成された場合には、 .Fa cnp に .Dv SAVESTART フラグが指定されていなければ、開放されます。 .Sh ロック ディレクトリ .Fa dvp は入る時にロックされ、戻る時にもロックされ続けてなければなりません。 呼び出しが成功の場合には、新しいオブジェクトがロックされて返されます。 .Sh 戻り値 成功時には、新しいオブジェクトの vnode が .Fa *vpp に置かれ、0 が返されます。 そうでない場合には、適切なエラーが返されます。 .Sh 疑似コード .Bd -literal int vop_create(struct vnode *dvp, struct vnode **vpp, struct componentname *cnp struct vattr *vap) { int mode = MAKEIMODE(vap->va_type, vap->va_mode); struct vnode *vp; int error; *vpp = NULL; if ((mode & IFMT) == 0) mode |= IFREG; error = SOMEFS_VALLOC(dvp, mode, cnp->cn_cred, &vp); if (error) { free(cnp->cn_pnbuf, M_NAMEI); vput(dvp); return error; } /* * 新しい vnode のパーミッションを更新します。 * これには、ディレクトリからのグループのコピーを含みます。 */ ...; #ifdef QUOTA /* * できる限りクォータ情報をチェックします。 */ ...; #endif /* * ディレクトリに新しい vnode を入れ、ディレクトリ内容が変更される * 前に vnode がディスクをアクセスしない様に注意します。 */ error = ...; if (error) goto bad; if ((cnp->cn_flags & SAVESTART) == 0) free(cnp->cn_pnbuf, M_NAMEI); vput(dvp); *vpp = vp; return 0; bad: /* * inode またはディレクトリの更新の試みで書き込みエラーが * 発生したため inode の割り当てを開放しなければなりません。 */ free(cnp->cn_pnbuf, M_NAMEI); vput(vp); /* * vp のためのファイルシステム資源を開放。 */ ...; vput(dvp); return error; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er ENOSPC ファイルシステムが一杯です。 .It Bq Er EDQUOT クォータを超過しました。 .El .Sh 関連項目 .Xr VOP_LOOKUP 9, .Xr vnode 9 .Sh 歴史 関数 .Nm は .Bx 4.3 で登場しました。 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_FSYNC.9 b/ja_JP.eucJP/man/man9/VOP_FSYNC.9 index a738d06189..06539e9f47 100644 --- a/ja_JP.eucJP/man/man9/VOP_FSYNC.9 +++ b/ja_JP.eucJP/man/man9/VOP_FSYNC.9 @@ -1,141 +1,141 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_FSYNC.9,v 1.6.2.1 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_FSYNC.9,v 1.6.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_FSYNC.9,v 1.2 2001/05/14 01:10:21 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_FSYNC 9 .Sh 名称 .Nm VOP_FSYNC .Nd ファイルシステムバッファのファイルへの吐き出し .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_FSYNC "struct vnode *vp" "struct ucred *cred" "int waitfor" "struct proc *p" .Sh 解説 この呼び出しはファイルの全ての汚れたバッファを吐き出します。 .Xr sync 2 および .Xr fsync 2 システムコールを実装するために使用されます。 .Pp 引数は以下の通りです。 .Bl -tag -width waitfor .It Ar vp ファイルの vnode。 .It Ar cred 呼び出し側の証明。 .It Ar waitfor 入出力の完了を関数が待つべきかどうか。 .It Ar p 呼び出しているプロセス。 .El .Pp 引数 .Fa waitfor は .Dv MNT_WAIT または .Dv MNT_NOWAIT のどちらかで、関数が戻る前に書き込みの終了を待つべきかどうかを指定します。 .Sh ロック ファイルはエントリ時にロックされるべきです。 .Sh 戻り値 呼び出しが成功した場合には 0 が返され、 そうでない場合には適切なエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_fsync(struct vnode *vp, struct ucred *cred, int waitfor, struct proc *p) { struct buf *bp; struct buf *nbp; struct timeval tv; int s; loop: s = splbio(); for (bp = vp->v_dirtyblkhd.lh_first; bp; bp = nbp) { nbp = bp->b_vnbufs.le_next; /* * 既に書き込み中のバッファを無視します。 */ if (bp->b_flags & B_BUSY) continue; /* * バッファが汚れているか確認します。 */ if ((bp->b_flags & B_DELWRI) == 0) panic("vop_fsync: not dirty"); vfs_bio_awrite(bp); splx(s); goto loop; } splx(s); if (waitfor == MNT_WAIT) { s = splbio(); while (vp->v_numoutput) { vp->v_flag |= VBWAIT; tsleep((caddr_t)&vp->v_numoutput, PRIBIO + 1, "vopfsn"); } splx(s); #ifdef DIAGNOSTIC if (vp->v_dirtyblkhd.lh_first) { vprint("vop_fsync: dirty", vp); goto loop; } #endif } /* * ディスク上の vnode を書き出します。 */ tv = time; return VOP_UPDATE(vp, &tv, &tv, waitfor == MNT_WAIT); } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er ENOSPC ファイルシステムが一杯です。 .It Bq Er EDQUOT クォータを超過しました。 .El .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_GETACL.9 b/ja_JP.eucJP/man/man9/VOP_GETACL.9 index 137d42c17e..3ef7af9319 100644 --- a/ja_JP.eucJP/man/man9/VOP_GETACL.9 +++ b/ja_JP.eucJP/man/man9/VOP_GETACL.9 @@ -1,101 +1,101 @@ .\"- .\" Copyright (c) 1999 Robert N. M. Watson .\" 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/share/man/man9/VOP_GETACL.9,v 1.1.2.2 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_GETACL.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_GETACL.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt VOP_GETACL 9 .Sh 名称 .Nm VOP_GETACL .Nd vnode のアクセス制御リストの取り出し .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/acl.h .Ft int .Fn VOP_GETACL "struct vnode *vp" "acl_type_t type" "struct acl *aclp" "struct ucred *cred" "struct proc *p" .Sh 解説 この vnode 呼び出しは、 ファイルまたはディレクトリからアクセス制御リスト (ACL) を 取り出すために使用可能です。 .Pp 引数は以下の通りです。 .Bl -tag -width type .It Fa vp ファイルまたはディレクトリの vnode。 .It Fa type 取り出す ACL の型。 .It Fa aclp ACL データを受け取る ACL 構造体へのポインタ。 .It Fa cred 要求の認証で使用されるユーザ証明。 .It Fa p ACL を要求しているプロセス。 .El .Pp .Fa cred ポインタは、 .Dv NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この cred の設定は、アクティブプロセスに許されていない ACL の取り出しを、 カーネルが正当化することを認めるために使用可能です。 .Pp vnode ACL インタフェースはファイルまたはディレクトリの ACL インタフェースの セマンティクスではなく文法を定義します。 カーネル内の ACL 管理についての詳細な情報は .Xr acl 9 を参照してください。 .Sh ロック この vnode メソッドの呼び出しのためにロックは不要で、 入る時に保持していた全てのロックは戻る時まで保持されます。 .Sh 戻り値 .Fa aclp ポインタが有効な ACL を指している場合には、0 が返されます。 そうでない場合には適切なエラーコードが返されます。 .Sh エラー .Bl -tag -width Er .It Bq Er EINVAL 渡された ACL 型はこの vnode には無効です。 .It Bq Er EACCES 許可されませんでした。 .It Bq Er ENOMEM 要求を処理するために利用可能なメモリが足りません。 .It Bq Er EOPNOTSUPP ファイルシステムは .Fn VOP_GETACL をサポートしていません。 .El .Sh 関連項目 .Xr acl 9 , .Xr vnode 9 , .Xr VOP_ACLCHECK 9 , .Xr VOP_SETACL 9 .Sh 作者 このマニュアルページは .An Robert Watson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_GETEXTATTR.9 b/ja_JP.eucJP/man/man9/VOP_GETEXTATTR.9 index 77ba09c380..bd33c81a57 100644 --- a/ja_JP.eucJP/man/man9/VOP_GETEXTATTR.9 +++ b/ja_JP.eucJP/man/man9/VOP_GETEXTATTR.9 @@ -1,104 +1,104 @@ .\"- .\" Copyright (c) 1999 Robert N. M. Watson .\" 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/share/man/man9/VOP_GETEXTATTR.9,v 1.1.2.2 2001/08/17 13:08:53 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_GETEXTATTR.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_GETEXTATTR.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt VOP_GETEXTATTR 9 .Sh 名称 .Nm VOP_GETEXTATTR .Nd vnode からの名前付き拡張属性の取り出し .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/extattr.h .Ft int .Fn VOP_GETEXTATTR "struct vnode *vp" "char *name" "struct uio *uio" "struct ucred *cred" "struct proc *p" .Sh 解説 この vnode 呼び出しは、ファイルまたはディレクトリから、 指定した名前付き拡張属性を取り出すために使用することができます。 .Pp 引数は以下の通りです。 .Bl -tag -width type .It Fa vp ファイルまたはディレクトリの vnode。 .It Fa name 属性名が入った null で終端された文字列へのポインタ。 .It Fa uio 読み込むまたは書き込むべきデータの位置。 .It Fa cred 要求の認証で使用するためのユーザ証明。 .It Fa p 拡張属性を要求しているプロセス。 .El .Pp .Fa cred ポインタは、 .Dv NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この .Fa cred の設定は、アクティブプロセスに許されていない拡張属性の取り出しを カーネルが正当化することを認めるために使用可能です。 .Pp 拡張属性のセマンティクスはファイルシステムの呼び出しの実装によって 異なるでしょう。拡張属性のより多くの情報は .Xr extattr 9 を参照してください。 .Sh LOCKS この vnode メソッドを呼び出すためにはロックは不要であり、 入る時に保持していた全てのロックは戻り時まで保持されます。 .Sh 戻り値 成功時には 0 が返され、読み込んだデータを反映して uio 構造体が更新されます。 そうでなければ適切なエラーコードが返されます。 .Sh エラー .Bl -tag -width Er .It Bq Er ENOENT この vnode のための属性名が定義されていません。 .It Bq Er EACCES 許可されませんでした。 .It Bq Er ENXIO 指定された vnode および属性名に対する要求は、このファイルシステムでは無効です。 .It Bq Er ENOMEM 要求を実行するための十分なメモリがありません。 .It Bq Er EFAULT uio 構造体が無効なユーザ空間アドレスを参照しています。 .It Bq Er EINVAL .Fa name または .Fa uio 引数が無効です。 .It Bq Er EOPNOTSUPP ファイルシステムが .Fn VOP_GETEXTATTR をサポートしていません。 .El .Sh 関連項目 .Xr extattr 9 , .Xr vnode 9 , .Xr VOP_SETEXTATTR 9 diff --git a/ja_JP.eucJP/man/man9/VOP_GETPAGES.9 b/ja_JP.eucJP/man/man9/VOP_GETPAGES.9 index c3ba734535..12f157265c 100644 --- a/ja_JP.eucJP/man/man9/VOP_GETPAGES.9 +++ b/ja_JP.eucJP/man/man9/VOP_GETPAGES.9 @@ -1,74 +1,74 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_GETPAGES.9,v 1.4.2.1 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_GETPAGES.9,v 1.4.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_GETPAGES.9,v 1.2 2001/05/14 01:10:21 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_GETPAGES 9 .Sh 名称 .Nm VOP_GETPAGES , .Nm VOP_PUTPAGES .Nd ファイルから VM ページへの読み込みまたは書き込み .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In vm/vm.h .Ft int .Fn VOP_GETPAGES "struct vnode *vp" "vm_page_t *m" "int count" "int reqpage" "vm_ooffset_t offset" .Ft int .Fn VOP_PUTPAGES "struct vnode *vp" "vm_page_t *m" "int count" "int sync" "int *rtvals" "vm_ooffset_t offset" .Sh 解説 引数は以下の通りです。 .Bl -tag -width reqpage .It Ar vp アクセスするファイル。 .It Ar m ページ ???。 .It Ar count アクセスするページ数。 .It Ar sync 書き込みが同期するべきである場合には 0 でない値。 .It Ar rtvals ???。 .It Ar reqpage ???。 .It Ar offset アクセスを開始するファイルの中のオフセット。 .El .Pp この引数については完全に確かではありません。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_INACTIVE.9 b/ja_JP.eucJP/man/man9/VOP_INACTIVE.9 index c1e3712704..fa7d744791 100644 --- a/ja_JP.eucJP/man/man9/VOP_INACTIVE.9 +++ b/ja_JP.eucJP/man/man9/VOP_INACTIVE.9 @@ -1,106 +1,106 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_INACTIVE.9,v 1.5.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_INACTIVE.9,v 1.5.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_INACTIVE.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_INACTIVE 9 .Sh 名称 .Nm VOP_INACTIVE , .Nm VOP_RECLAIM .Nd vnode のためのファイルシステム資源の回収 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_INACTIVE "struct vnode *vp" "struct proc *p" .Ft int .Fn VOP_RECLAIM "struct vnode *vp" "struct proc *p" .Sh 解説 引数は以下の通りです。 .Bl -tag -width 2n .It Ar vp 回収されている vnode。 .El .Pp .Xr VOP_INACTIVE 9 は、カーネルがもはやその vnode を使用しなくなった時に呼び出されます。 これは、参照カウントが 0 になった時、 またはオープンされているファイルがあるファイルシステムが 強制的にアンマウントされた時に起こります。 「オープンされているが削除された」ファイルのための領域を回収するために、 使用可能です。 .Xr VOP_RECLAIM 9 は、異なるファイルシステムのために vnode が再利用される時に呼び出されます。 vnode に関連しているあらゆるファイルシステム固有の資源は、開放されるべきです。 .Sh ロック VOP_INACTIVE では、入る時に vp がロックされます。 VOP_INACTIVE コードは、戻る前に vp をアンロックしなければなりません。 .Pp VOP_RECLAIM では、入る時に vp はロックされず、 戻り時もロックされないままでいるべきです。 .Sh 疑似コード .Bd -literal int vop_inactive(struct vnode *vp) { if (link count of vp == 0) { /* * vp のためのファイルシステム内の領域を回収します。 */ ...; } VOP_UNLOCK(vp, 0, p); return 0; } int vop_reclaim(struct vnode *vp) { /* * 名前キャッシュを一掃します。 */ cache_purge(vp); /* * ファイルシステムに関連したデータを開放します。 */ ...; return 0; } .Ed .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_IOCTL.9 b/ja_JP.eucJP/man/man9/VOP_IOCTL.9 index ca85f9f836..d955f53a67 100644 --- a/ja_JP.eucJP/man/man9/VOP_IOCTL.9 +++ b/ja_JP.eucJP/man/man9/VOP_IOCTL.9 @@ -1,81 +1,81 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_IOCTL.9,v 1.5 1999/08/28 00:21:13 peter Exp % +.\" %FreeBSD: src/share/man/man9/VOP_IOCTL.9,v 1.5.2.1 2001/12/17 11:30:18 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_IOCTL 9 .Sh 名称 .Nm VOP_IOCTL .Nd デバイス固有の制御 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_IOCTL "struct vnode *vp" "u_long command" "caddr_t data" "int fflag" "struct ucred *cred" "struct proc *p" .Sh 解説 デバイス依存の方法でのファイルを操作します。 .Pp 引数は以下の通りです。 .Bl -tag -width command .It Ar vp ファイル (通常はデバイスを表現する) の vnode。 .It Ar command 実行すべきデバイス固有の操作。 .It Ar cnp 指定された操作のための拡張データ。 .It Ar fflag 幾つかのフラグ ??? .It Ar cred 呼び出し側の証明。 .It Ar p 呼び出したプロセス。 .El .Pp ほとんどのファイルシステムはこのエントリポイントを実装しません。 .Sh ロック 入る時、ファイルはロックされているべきではありません。 .Sh 戻り値 成功時には 0 が返され、そうでない場合には適切なエラーが返されます。 .Sh 疑似コード .Bd -literal int vop_ioctl(struct vnode *vp, int command, caddr_t data, int fflag, struct ucred *cred, struct proc *p) { return EOPNOTSUPP; } .Ed .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_LEASE.9 b/ja_JP.eucJP/man/man9/VOP_LEASE.9 index 78723cd80a..0ef846d609 100644 --- a/ja_JP.eucJP/man/man9/VOP_LEASE.9 +++ b/ja_JP.eucJP/man/man9/VOP_LEASE.9 @@ -1,61 +1,61 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_LEASE.9,v 1.2.2.4 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_LEASE.9,v 1.2.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_LEASE.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd September 24, 1999 .Os .Dt VOP_LEASE 9 .Sh 名称 .Nm VOP_LEASE .Nd ユーザ証明と操作のタイプの特有の組に対する vnode の正当性の確認 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/mount.h .Ft int .Fn VOP_LEASE "struct vnode *vp" "struct proc *p" "struct ucred *cred" "int type" .Sh 解説 このエントリポイントは、現在実装されていません。 この着想は、ユーザ証明と操作の型の特有の組のための vnode を確認するための ものだと信じています。 サポートされている、2 つの操作の型は LEASE_READ および LEASE_WRITE です。 現在、関数は常に 0 を返します。 .Sh ロック 入る時、vnode は排他的にロックされていなければならず、 戻り時まで排他的にロックされ続けているべきです。 .Sh 戻り値 成功時には、0 が返されます。そうでない場合にも、うーん... 0 が返されます。 .\" .Sh エラー .Sh 関連項目 .Xr VOP_READ 9 , .Xr VOP_WRITE 9 .Sh 作者 このマニュアルページは .An Matt Dillon が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_LINK.9 b/ja_JP.eucJP/man/man9/VOP_LINK.9 index 2038ac3c37..388f8ac1fc 100644 --- a/ja_JP.eucJP/man/man9/VOP_LINK.9 +++ b/ja_JP.eucJP/man/man9/VOP_LINK.9 @@ -1,138 +1,138 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_LINK.9,v 1.9.2.2 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_LINK.9,v 1.9.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_LINK.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_LINK 9 .Sh 名称 .Nm VOP_LINK .Nd ファイルの新しい名前の作成 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_LINK "struct vnode *dvp" "struct vnode *vp" "struct componentname *cnp" .Sh 解説 これは、既存のファイルに対し、 指定したディレクトリ中の新しい名前をリンクします。 .Pp 引数は以下の通りです。 .Bl -tag -width 8n .It Ar dvp ディレクトリの vnode。 .It Ar vp リンクされるファイルの vnode。 .It Ar cnp ファイルについてのパス名情報。 .El .Pp パス名情報は、戻り時に開放されなければなりません。 ディレクトリとファイルの vnode は戻り時に開放されるべきではありません。 .Sh ロック ディレクトリ .Fa dvp は、入る時にロックされていて、戻り時もロックされ続けているべきです。 ファイル .Fa vp は、入る時にロックされておらず、戻り時もそのままであるべきです。 VOP コードが .Fa vp をロックする場合には、戻る前に必ずロックを解除しなければなりません。 .Sh 戻り値 ファイルが成功裏にリンクされた場合には 0 が返され、 そうでない場合にはエラーが返されます。 .Sh 疑似コード .Bd -literal int vop_link(struct vnode *dvp, struct vnode *vp, struct componentname *cnp) { int error = 0; if (vp->v_mount != dvp->v_mount) { VOP_ABORTOP(dvp, cnp); error = EXDEV; goto out2; } if (vp != dvp && (error = VOP_LOCK(vp))) { VOP_ABORTOP(dvp, cnp); goto out2; } /* * 今、vp をロックしたので、out2 の代わりに out1 を使用 * しなければなりません。 */ if (vp would have too many links) { VOP_ABORTOP(dvp, cnp); error = EMLINK; goto out1; } if (vp is immutable) { VOP_ABORTOP(dvp, cnp); error = EPERM; goto out1; } /* * vp のリンクカウントをインクリメントし、ディスクに書き戻します。 */ ...; if (!error) { /* * ディレクトリの新しい名前を追加します。 */ ...; } free(cnp->cn_pnbuf, M_NAMEI); out1: if (vp != dvp) VOP_UNLOCK(vp); out2: return error; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er EPERM ファィルが変更不可能です。 .El .Sh 関連項目 .Xr vnode 9 , .Xr vn_lock 9 .Sh 作者 このマニュアルページは .An Doug Rabson が初めて書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_LOCK.9 b/ja_JP.eucJP/man/man9/VOP_LOCK.9 index 337fc671ff..118a4ad991 100644 --- a/ja_JP.eucJP/man/man9/VOP_LOCK.9 +++ b/ja_JP.eucJP/man/man9/VOP_LOCK.9 @@ -1,177 +1,177 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_LOCK.9,v 1.8.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_LOCK.9,v 1.8.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_LOCK.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_LOCK 9 .Sh 名称 .Nm VOP_LOCK , .Nm VOP_UNLOCK , .Nm VOP_ISLOCKED , .Nm vn_lock .Nd vnode アクセスの直列化 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/lock.h +.In sys/vnode.h .Ft int .Fn VOP_LOCK "struct vnode *vp" "int flags" "struct proc *p" .Ft int .Fn VOP_UNLOCK "struct vnode *vp" "int flags" "struct proc *p" .Ft int .Fn VOP_ISLOCKED "struct vnode *vp" "struct proc *p" .Ft int .Fn vn_lock "struct vnode *vp" "int flags" "struct proc *p" .Sh 解説 これらの呼び出しは、 ファイルシステムへのアクセスを直列化するために使用されます。 例えば、同一ファイルに対する 2 つの書き込みが同時に発生することを 避けるために使用します。 .Pp 引数は以下の通りです。 .Bl -tag -width flags .It Ar vp ロックまたはロック解除される vnode。 .It Ar flags 以下のロック要求タイプのひとつ。 .Bl -column LK_EXCLUPGRADE -offset indent .It Dv LK_SHARED Ta 共有ロック .It Dv LK_EXCLUSIVE Ta 排他的ロック .It Dv LK_UPGRADE Ta 共有から排他的へのアップグレード .It Dv LK_EXCLUPGRADE Ta 最初の共有から排他的へのアップグレード .It Dv LK_DOWNGRADE Ta 排他的から共有へのダウングレード .It Dv LK_RELEASE Ta 全てのロックタイプの解除 .It Dv LK_DRAIN Ta ロック状態終了までの待機 .El .Pp ロックタイプは、以下のロックフラグと .Em OR されているかもしれません。 .Bl -column LK_CANRECURSE -offset indent .It Dv LK_NOWAIT Ta ロックを待つために sleep しない .It Dv LK_SLEEPFAIL Ta sleep して、失敗を返す .It Dv LK_CANRECURSE Ta 再帰的排他的ロックを認める .It Dv LK_REENABLE Ta ロック消失後再有効化されるべき .It Dv LK_NOPAUSE Ta 空回りしない .El .Pp ロックタイプは、以下の制御フラグと .Em OR されているかもしれません。 .Bl -column LK_INTERLOCK -offset indent .It Dv LK_INTERLOCK Ta 呼び出し側が既に簡易ロックを保持している時に指定 (VOP_LOCK はロックを取得した後で簡易ロックを解除します) .It Dv LK_RETRY Ta ロックされるまでリトライ .It Dv LK_NOOBJ Ta オブジェクトを作成しない .El .It Ar p ロックを使用するためのプロセスコンテクスト。 .El .Pp カーネルコードは vnode をロックするために .Fn VOP_LOCK を直接呼び出さずに、 .Fn vn_lock を使用するべきです。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 疑似コード .Bd -literal struct vopnode { int von_flag; /* * 他のファイルシステム固有データ */ ...; }; #define VON_LOCKED 1 #define VON_WANTED 2 #define VTOVON(vp) ((struct vopnode *) (vp)->v_data) int vop_lock(struct vnode *vp) { struct vopnode* vop; start: while (vp->v_flag & VXLOCK) { vp->v_flag |= VXWANT; tsleep((caddr_t)vp, PINOD, "voplk1", 0); } if (vp->v_tag == VT_NON) return ENOENT; vop = VTOVON(vp); if (vop->von_flag & VON_LOCKED) { vop->von_flag |= VON_WANTED; tsleep((caddr_t) vop, PINOD, "voplk2", 0); goto start; } vop->von_flag |= VON_LOCKED; return 0; } int vop_unlock(struct vnode *vp) { struct vopnode *vop = VTOVON(vp); if ((vop->von_flag & VON_LOCKED) == 0) { panic("vop_unlock not locked"); } vop->von_flag &= ~VON_LOCKED; if (vop->von_flag & VON_WANTED) { vop->von_flag &= ~VON_WANTED; wakeup((caddr_t) vop); } return 0; } int vop_islocked(struct vnode *vp) { struct vopnode *vop = VTOVON(vp); if (vop->von_flag & VON_LOCKED) return 1; else return 0; } .Ed .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_OPENCLOSE.9 b/ja_JP.eucJP/man/man9/VOP_OPENCLOSE.9 index 222ad24c8e..4bcc07c841 100644 --- a/ja_JP.eucJP/man/man9/VOP_OPENCLOSE.9 +++ b/ja_JP.eucJP/man/man9/VOP_OPENCLOSE.9 @@ -1,102 +1,102 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_OPENCLOSE.9,v 1.6.2.1 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_OPENCLOSE.9,v 1.6.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_OPENCLOSE.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_OPEN 9 .Sh 名称 .Nm VOP_OPEN , .Nm VOP_CLOSE .Nd ファイルのオープンまたはクローズ .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_OPEN "struct vnode *vp" "int mode" "struct ucred *cred" "struct proc *p" .Ft int .Fn VOP_CLOSE "struct vnode *vp" "int mode" "struct ucred *cred" "struct proc *p" .Sh 解説 .Xr VOP_OPEN 9 エントリポイントは、 ファイルがプロセスによってアクセスされる前に呼び出され、 .Xr VOP_CLOSE 9 エントリポイントは、 ファイルに対するプロセスの仕事の完了後に呼び出されます。 .Pp 引数は以下の通りです。 .Bl -tag -width mode .It Ar vp ファイルの vnode。 .It Ar mode 呼び出しプロセスによって要求されたアクセスモード。 .It Ar p ファイルにアクセスしているプロセス。 .El .Pp アクセスモードは、 .Dv FREAD , .Dv FWRITE , .Dv O_NONBLOCK , .Dv O_APPEND を含むフラグの組です。 .Sh ロック .Xr VOP_OPEN 9 は、入る時に .Fa vp がロックされていることを期待し、戻り時までロックされたままにします。 .Pp .Xr VOP_CLOSE 9 は、vnode に結びつけられた参照が少なくとも 1 個は存在することを期待し、 vnode がロックされているかどうかは気にしません。 ロックおよび参照状態は、戻る時に変更されずにそのままになります。 .Fa vn_close は、ロックされていない参照された vnode を期待し、 戻る前に参照を手繰ることに注意してください。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_open(struct vnode *vp, int mode, struct ucred *cred, struct proc *p) { /* * ほとんどのファイルシステムは、ここでは大したことはしません。 */ return 0; } .Ed .Sh 関連項目 .Xr vnode 9 , .Xr VOP_LOOKUP 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_PATHCONF.9 b/ja_JP.eucJP/man/man9/VOP_PATHCONF.9 index 5ec76b864b..52cc6873a8 100644 --- a/ja_JP.eucJP/man/man9/VOP_PATHCONF.9 +++ b/ja_JP.eucJP/man/man9/VOP_PATHCONF.9 @@ -1,87 +1,87 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_PATHCONF.9,v 1.6.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_PATHCONF.9,v 1.6.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_PATHCONF.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_PATHCONF 9 .Sh 名称 .Nm VOP_PATHCONF .Nd POSIX パス構成情報の取得 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/unistd.h .Ft int .Fn VOP_PATHCONF "struct vnode *vp" "int name" "int *retval" .Sh 解説 引数は以下の通りです。 .Bl -tag -width retval .It Ar vp 情報を得る対象の vnode。 .It Ar name 返す情報の型。 .It Ar retval 情報を返す場所。 .El .Pp .Fa name の値は以下の何が返されるかを指定します。 .Bl -tag -width _PC_CHOWN_RESTRICTED .It Dv _PC_LINK_MAX ファイルへのリンクの最大値。 .It Dv _PC_NAME_MAX ファイル名の最大バイト数。 .It Dv _PC_PATH_MAX パス名の最大バイト数。 .It Dv _PC_PIPE_BUF 不可分にパイプに書き出される最大バイト数。 .It Dv _PC_CHOWN_RESTRICTED .Xr chown 2 システムコールのために適切な特権が必要な場合には 1、 そうでない場合には 0。 .It Dv _PC_NO_TRUNC .Dv KERN_NAME_MAX よりも長いファイル名が切り詰められる場合には 1。 .El .Sh 戻り値 .Fa name が認識される場合、 .Fa *retval に指定された値が設定されて 0 が返され、そうでない場合には .Er EINVAL が返されます。 .Sh 関連項目 .Xr pathconf 2 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_PRINT.9 b/ja_JP.eucJP/man/man9/VOP_PRINT.9 index b529dabe5f..743ae65ab3 100644 --- a/ja_JP.eucJP/man/man9/VOP_PRINT.9 +++ b/ja_JP.eucJP/man/man9/VOP_PRINT.9 @@ -1,56 +1,56 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_PRINT.9,v 1.4.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_PRINT.9,v 1.4.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_PRINT.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_PRINT 9 .Sh 名称 .Nm VOP_PRINT .Nd デバッグ情報の表示 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_PRINT "struct vnode *vp" .Sh 解説 引数は以下の通りです。 .Bl -tag -width 2n .It Ar vp 表示対象の vnode。 .El .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_RDWR.9 b/ja_JP.eucJP/man/man9/VOP_RDWR.9 index fe451d198f..f67992c344 100644 --- a/ja_JP.eucJP/man/man9/VOP_RDWR.9 +++ b/ja_JP.eucJP/man/man9/VOP_RDWR.9 @@ -1,233 +1,233 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_RDWR.9,v 1.9.2.1 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_RDWR.9,v 1.9.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_RDWR.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_RDWR 9 .Sh 名称 .Nm VOP_READ , .Nm VOP_WRITE .Nd ファイルの読み込みまたは書き込み .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/uio.h .Ft int .Fn VOP_READ "struct vnode *vp" "struct uio *uio" "int ioflag" "struct ucred *cred" .Ft int .Fn VOP_WRITE "struct vnode *vp" "struct uio *uio" "int ioflag" "struct ucred *cred" .Sh 解説 これらのエントリポイントは、ファイルの内容を読み込みまたは書き込みます。 .Pp 引数は以下の通りです。 .Bl -tag -width ioflag .It Ar vp ファイルの vnode。 .It Ar uio 読み込みまたは書き込み対象のデータの位置。 .It Ar ioflag 様々なフラグ。 .It Ar cnp 呼び出し側の証明。 .El .Pp .Fa ioflag 引数は、ファイルシステムに対する命令およびヒントを与えるために使用されます。 読み込みを試みる時には、上位の 16 ビットは、 ファイルシステムが試みるべき先読みのヒントを (ファイルシステムブロック単位で) 提供するために使用されます。 下位の 16 ビットは、以下のフラグを含むことができるビットマスクです。 .Bl -tag -width IO_NODELOCKED .It Dv IO_UNIT 不可分に入出力を行ないます。 .It Dv IO_APPEND 末尾に追加書き込みを行ないます。 .It Dv IO_SYNC 同期的に入出力を行ないます。 .It Dv IO_NODELOCKED 下位層のノードは既にロックされています。 .It Dv IO_NDELAY ファイルテーブルに .Dv FNDELAY フラグを設定します。 .It Dv IO_VMIO 仮想メモリ入出力 (VMIO) 領域にデータが既にあります。 .El .Sh ロック 入る時に、ファイルはロックされているべきで、終了時までロックされ続けます。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_read(struct vnode *vp, struct uio *uio, int ioflag, struct ucred *cred) { struct buf *bp; off_t bytesinfile; daddr_t lbn, nextlbn; long size, xfersize, blkoffset; int error; size = block size of filesystem; for (error = 0, bp = NULL; uio->uio_resid > 0; bp = NULL) { bytesinfile = size of file - uio->uio_offset; if (bytesinfile <= 0) break; lbn = uio->uio_offset / size; blkoffset = uio->uio_offset - lbn * size; xfersize = size - blkoffset; if (uio->uio_resid < xfersize) xfersize = uio->uio_resid; if (bytesinfile < xfersize) xfersize = bytesinfile; error = bread(vp, lbn, size, NOCRED, &bp); if (error) { brelse(bp); bp = NULL; break; } /* * 入出力エラーが起こった時には 0 でない b_resid のみ * を得ます。これは上で break を引き起こすべきです。 * しかしながら、短い読み込みがエラーを起こさなかった * 場合には、間違ったまたは初期化されていないデータの * uiomove を行なわないことを保証したい。 */ size -= bp->b_resid; if (size < xfersize) { if (size == 0) break; xfersize = size; } error = uiomove((char *)bp->b_data + blkoffset, (int)xfersize, uio); if (error) break; bqrelse(bp); } if (bp != NULL) bqrelse(bp); return error; } int vop_write(struct vnode *vp, struct uio *uio, int ioflag, struct ucred *cred) { struct buf *bp; off_t bytesinfile; daddr_t lbn, nextlbn; off_t osize; long size, resid, xfersize, blkoffset; int flags; int error; osize = size of file; size = block size of filesystem; resid = uio->uio_resid; if (ioflag & IO_SYNC) flags = B_SYNC; else flags = 0; for (error = 0; uio->uio_resid > 0;) { lbn = uio->uio_offset / size; blkoffset = uio->uio_offset - lbn * size; xfersize = size - blkoffset; if (uio->uio_resid < xfersize) xfersize = uio->uio_resid; if (uio->uio_offset + xfersize > size of file) vnode_pager_setsize(vp, uio->uio_offset + xfersize); if (size > xfersize) flags |= B_CLRBUF; else flags &= ~B_CLRBUF; error = find_block_in_file(vp, lbn, blkoffset + xfersize, cred, &bp, flags); if (error) break; if (uio->uio_offset + xfersize > size of file) set size of file to uio->uio_offset + xfersize; error = uiomove((char *)bp->b_data + blkoffset, (int) xfersize, uio); /* XXX ufs はここでエラーチェックをしていません。何故? */ if (ioflag & IO_VMIO) bp->b_flags |= B_RELBUF; /* ??? */ if (ioflag & IO_SYNC) bwrite(bp); else if (xfersize + blkoffset == size) bawrite(bp); else bdwrite(bp); if (error || xfersize == 0) break; } if (error) { if (ioflag & IO_UNIT) { VOP_TRUNCATE(vp, osize, ioflag & IO_SYNC, cred, uio->uio_procp); uio->uio_offset -= resid - uio->uio_resid; uio->uio_resid = resid; } } else if (resid > uio->uio_resid && (ioflag & IO_SYNC)) { struct timeval tv; error = VOP_UPDATE(vp, &tv, &tv, 1); /* XXX これは何をしているの? */ } return error; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er ENOSPC ファイルシステムが一杯です。 .El .Sh 関連項目 .Xr uiomove 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_READLINK.9 b/ja_JP.eucJP/man/man9/VOP_READLINK.9 index 0c11b6079b..beaee11132 100644 --- a/ja_JP.eucJP/man/man9/VOP_READLINK.9 +++ b/ja_JP.eucJP/man/man9/VOP_READLINK.9 @@ -1,84 +1,84 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_READLINK.9,v 1.7.2.1 2001/03/06 19:08:22 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_READLINK.9,v 1.7.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_READLINK.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_READLINK 9 .Sh 名称 .Nm VOP_READLINK .Nd シンボリックリンクのターゲットの読み込み .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/uio.h .Ft int .Fn VOP_READLINK "struct vnode *vp" "struct uio *uio" "struct ucred *cred" .Sh 解説 これは、シンボリックリンクのターゲットのパス名を読み込みます。 .Bl -tag -width uio .It Ar vp シンボリックリンクの vnode。 .It Ar uio 読み込みまたは書き込みのためのデータの位置。 .It Ar cred 呼び出し側の証明。 .El .Sh ロック 入る時に、vnode はロックされているべきで、終了時にもロックされ続けます。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_readlink(struct vnode *vp, struct uio *uio, struct ucred *cred) { int error = 0; /* * シンボリックリンクのターゲットを読み込みます。 */ ...; return error; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er EIO シンボリックリンクの内容の読み込みの間に、読み込みエラーが発生しました。 .El .Sh 関連項目 .Xr uiomove 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_REALLOCBLKS.9 b/ja_JP.eucJP/man/man9/VOP_REALLOCBLKS.9 index 1627d01b22..96c7188800 100644 --- a/ja_JP.eucJP/man/man9/VOP_REALLOCBLKS.9 +++ b/ja_JP.eucJP/man/man9/VOP_REALLOCBLKS.9 @@ -1,61 +1,61 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_REALLOCBLKS.9,v 1.6.2.1 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_REALLOCBLKS.9,v 1.6.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_REALLOCBLKS.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_REALLOCBLKS 9 .Sh 名称 .Nm VOP_REALLOCBLKS .Nd ファイルのブロックを連続するように再配列 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_REALLOCBLKS "struct vnode *vp" "struct cluster_save *buflist" .Sh 解説 引数は以下の通りです。 .Bl -tag -width buflist .It Ar vp 操作対象のファイル。 .It Ar buflist 再配列対象のブロックのリスト。 .El .Pp これは進行中の作業の一部分のようです。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr buf 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは、 .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_REMOVE.9 b/ja_JP.eucJP/man/man9/VOP_REMOVE.9 index a60e6c1b15..7fc60986f3 100644 --- a/ja_JP.eucJP/man/man9/VOP_REMOVE.9 +++ b/ja_JP.eucJP/man/man9/VOP_REMOVE.9 @@ -1,109 +1,109 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_REMOVE.9,v 1.7.2.1 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/VOP_REMOVE.9,v 1.7.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_REMOVE.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_REMOVE 9 .Sh 名称 .Nm VOP_REMOVE , .Nm VOP_RMDIR .Nd ファイルまたはディレクトリの削除 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_REMOVE "struct vnode *dvp" "struct vnode *vp" "struct componentname *cnp" .Ft int .Fn VOP_RMDIR "struct vnode *dvp" "struct vnode *vp" "struct componentname *cnp" .Sh 解説 これらのエントリポイントは、それぞれファイルとディレクトリを削除します。 .Pp 引数は以下の通りです。 .Bl -tag -width dvp .It Ar dvp ディレクトリの vnode。 .It Ar vp 削除対象ファイルの vnode。 .It Ar cnp ファイルのパス名情報。 .El .Sh ロック .Fa dvp および .Fa vp 共に、入る時にロックされているべきで、戻り時もロックされ続けています。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーコードが返されます。 .Sh 疑似コード .Bd -literal int vop_remove(struct vnode *dvp, struct vnode *vp, struct componentname *cnp) { int error = 0; if (vp is immutable) { error = EPERM; goto out; } /* * ディレクトリから cnp->cn_nameptr の名前を削除し、vp のリンク * カウントを更新します。 */ ...; /* * "." の削除を試みる場合は注意してください。XXX これはより * 上層で取り扱われるべきです。 */ if (dvp == vp) vrele(vp); else vput(vp); vput(dvp); return error; } .Ed .Sh エラー .Bl -tag -width Er .It Bq Er EPERM ファイルは変更不可能です。 .It Bq Er ENOTEMPTY 空ではないディレクトリを削除しようとしています。 .El .Sh 関連項目 .Xr vnode 9 , .Xr VOP_LOOKUP 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_SETACL.9 b/ja_JP.eucJP/man/man9/VOP_SETACL.9 index 47afc7ec82..2533d15481 100644 --- a/ja_JP.eucJP/man/man9/VOP_SETACL.9 +++ b/ja_JP.eucJP/man/man9/VOP_SETACL.9 @@ -1,108 +1,108 @@ .\"- .\" Copyright (c) 1999 Robert N. M. Watson .\" 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/share/man/man9/VOP_SETACL.9,v 1.1.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_SETACL.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_SETACL.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt VOP_SETACL 9 .Sh 名称 .Nm VOP_SETACL .Nd vnode のアクセス制御リストの設定 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/acl.h .Ft int .Fn VOP_SETACL "struct vnode *vp" "acl_type_t type" "struct acl *aclp" "struct ucred *cred" "struct proc *p" .Sh 解説 この vnode 呼び出しは、ファイルまたはディレクトリの アクセス制御リスト (ACL) を設定するために使用可能です。 .Pp 引数は以下の通りです。 .Bl -tag -width type .It Fa vp ファイルまたはディレクトリの vnode。 .It Fa type 設定される ACL の型。 .It Fa aclp ACL データの取り出し元の ACL 構造体へのポインタ。 .It Fa cred 要求の認証時に使用されるユーザ証明。 .It Fa p ACL を設定しているプロセス。 .El .Pp .Fa aclp ポインタは、 .Dv NULL を指定可能であり、 指定した ACL が削除されるべきであることを示します。 .Pp .Fa cred ポインタは、NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この cred の設定は、アクティブプロセスに許されていない ACL 証明を、 カーネルが正当化することを認めるために使用可能です。 この cred の設定は、アクティブプロセスに許されていない拡張属性の変更を カーネルが正当化することを認めるために使用可能です。 .Pp vnode ACL インタフェースは、ファイルまたはディレクトリの ACL インタフェースの セマンティクスではなく文法を定義します。 カーネル内の ACL 管理についての詳細な情報は .Xr acl 9 を参照してください。 .Sh ロック 入る時に vnode はロックされ、戻り時にもロックされ続けているべきです。 .Sh 戻り値 ACL が成功裏に設定された場合には 0 が返されます。 そうでない場合には適切なエラーコードが返されます。 .Sh エラー .Bl -tag -width Er .It Bq Er EINVAL 渡された ACL 型はこの vnode には無効です。または、ACL データが無効です。 .It Bq Er EACCES 許可されませんでした。 .It Bq Er ENOMEM 要求を実行するための十分なメモリがありません。 .It Bq Er EOPNOTSUPP ファイルシステムが .Fn VOP_SETACL をサポートしていません。 .It Bq Er ENOSPC ファイルシステムの領域不足です。 .It Bq Er EROFS ファイルシステムが読み取り専用です。 .El .Sh 関連項目 .Xr acl 9 , .Xr vnode 9 , .Xr VOP_ACLCHECK 9 , .Xr VOP_GETACL 9 .Sh 作者 このマニュアルページは .An Robert Watson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_SETEXTATTR.9 b/ja_JP.eucJP/man/man9/VOP_SETEXTATTR.9 index 59e632f047..e4c73efdec 100644 --- a/ja_JP.eucJP/man/man9/VOP_SETEXTATTR.9 +++ b/ja_JP.eucJP/man/man9/VOP_SETEXTATTR.9 @@ -1,119 +1,119 @@ .\"- .\" Copyright (c) 1999 Robert N. M. Watson .\" 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/share/man/man9/VOP_SETEXTATTR.9,v 1.1.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/VOP_SETEXTATTR.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_SETEXTATTR.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt VOP_SETEXTATTR 9 .Sh 名称 .Nm VOP_SETEXTATTR .Nd vnode への名前つき拡張属性の設定 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/extattr.h .Ft int .Fn VOP_SETEXTATTR "struct vnode *vp" "char *name" "struct uio *uio" "struct ucred *cred" "struct proc *p" .Sh 解説 この vnode 呼び出しは、ファイルまたはディレクトリに対し、 特定の名前付き拡張属性を設定するために使用可能です。 .Pp 引数は以下の通りです。 .Bl -tag -width type .It Fa vp ファイルまたはディレクトリの vnode。 .It Fa name 属性の名前が入った、ヌル文字で終端された文字列へのポインタ。 .It Fa uio 読み込みまたは書き込みされるデータの位置。 .It Fa cred 要求の認証で使用するユーザ証明。 .It Fa p 拡張属性を設定しているプロセス。 .El .Pp uio 構造体は、 .Xr VOP_WRITE での同じ名前の引数と同様に使用されます。しかしながら、 拡張属性が厳密な "name=value" のセマンティクスを規定しているので、 0 でないオフセットは却下されるでしょう。 .Pp .Fa uio ポインタは、 .Dv NULL であることが可能であり、 指定された拡張属性が削除されるべきであることを指示します。 .Pp .Fa cred ポインタは、 .Dv NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この .Fa cred の設定は、アクティブプロセスに許されていない拡張属性の変更を、 カーネルが正当化することを認めるために使用可能です。 .Pp 拡張属性のセマンティクスは、 呼び出しを実装しているファイルシステムに依存して異なり得ます。 拡張属性についてのより多くの情報は .Xr extattr 9 を参照してください。 .Sh ロック vnode は、入る時にロックされ、戻り時にもロックされ続けているべきです。 .Sh 戻り値 拡張属性が成功裏に設定された場合には 0 が返されます。 そうでない場合には適切なエラーコードが返されます。 .Sh エラー .Bl -tag -width Er .It Bq Er EACCES 許可されませんでした。 .It Bq Er ENXIO 指定された vnode および属性名に対する要求は、このファイルシステムでは無効です。 .It Bq Er ENOMEM 要求を実行するための十分なメモリがありません。 .It Bq Er EFAULT uio 構造体が無効なユーザ空間アドレスを参照しています。 .It Bq Er EINVAL 名前または uio 引数が無効です。 .It Bq Er EOPNOTSUPP ファイルシステムが .Fn VOP_GETEXTATTR をサポートしていません。 .It Bq Er ENOSPC ファイルシステムに空き領域がありません。 .It Bq Er EROFS ファイルシステムが読み取り専用です。 .El .Sh 関連項目 .Xr extattr 9 , .Xr vnode 9 , .Xr VOP_GETEXTATTR 9 .Sh 作者 このマニュアルページは .An Robert Watson が書きました。 diff --git a/ja_JP.eucJP/man/man9/VOP_STRATEGY.9 b/ja_JP.eucJP/man/man9/VOP_STRATEGY.9 index 9eb0f2a0f6..d9e1ab510b 100644 --- a/ja_JP.eucJP/man/man9/VOP_STRATEGY.9 +++ b/ja_JP.eucJP/man/man9/VOP_STRATEGY.9 @@ -1,63 +1,63 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/VOP_STRATEGY.9,v 1.8.2.2 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/VOP_STRATEGY.9,v 1.8.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/VOP_STRATEGY.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VOP_STRATEGY 9 .Sh 名称 .Nm VOP_STRATEGY .Nd ファイルシステムバッファの読み書き .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn VOP_STRATEGY "struct vnode *vp" "struct buf *bp" .Sh 解説 引数は以下の通りです。 .Bl -tag -width 2n .It Ar vp バッファが対象にする vnode。 .It Ar bp 読み書きされるべきバッファ。 .El .Pp この呼び出しは、 .Fa bp->b_flags の値に依存して、ファイルの読み込みまたは書き込みを行ないます。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .\" .Xr buf 9 , .Xr vnode 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/acl.9 b/ja_JP.eucJP/man/man9/acl.9 index 9421fee55d..0844db0974 100644 --- a/ja_JP.eucJP/man/man9/acl.9 +++ b/ja_JP.eucJP/man/man9/acl.9 @@ -1,121 +1,121 @@ .\"- .\" Copyright (c) 1999, 2000 Robert N. M. Watson .\" 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/share/man/man9/acl.9,v 1.2.2.3 2001/07/21 09:16:54 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/acl.9,v 1.2.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/acl.9,v 1.3 2001/05/14 04:06:10 horikawa Exp $ +.\" $FreeBSD$ .Dd December 23, 1999 .Os .Dt ACL 9 .Sh 名称 .Nm acl .Nd 仮想ファイルシステムアクセス制御リスト .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h +.In sys/acl.h .Pp .Bd -literal typedef int acl_type_t; typedef int acl_tag_t; typedef mode_t acl_perm_t; struct acl_entry { acl_tag_t ae_tag; uid_t ae_id; acl_perm_t ae_perm; }; typedef struct acl_entry *acl_entry_t; struct acl { int acl_cnt; struct acl_entry acl_entry[ACL_MAX_ENTRIES]; }; typedef struct acl *acl_t; /* * acl_entry_t の a_tag に有効な値 */ #define ACL_USER_OBJ 0x00000001 #define ACL_USER 0x00000002 #define ACL_GROUP_OBJ 0x00000004 #define ACL_GROUP 0x00000008 #define ACL_MASK 0x00000010 #define ACL_OTHER 0x00000020 #define ACL_OTHER_OBJ ACL_OTHER /* * a_type_t 引数に有効な値 */ #define ACL_TYPE_ACCESS 0x00000000 #define ACL_TYPE_DEFAULT 0x00000001 #define ACL_TYPE_AFS 0x00000002 #define ACL_TYPE_CODA 0x00000003 #define ACL_TYPE_NTFS 0x00000004 #define ACL_TYPE_NWFS 0x00000005 /* * a_perm フィールドに可能なフラグ */ #define ACL_PERM_EXEC 0x0001 #define ACL_PERM_WRITE 0x0002 #define ACL_PERM_READ 0x0004 #define ACL_PERM_NONE 0x0000 #define ACL_PERM_BITS (ACL_PERM_EXEC | ACL_PERM_WRITE | ACL_PERM_READ) #define ACL_POSIX1E_BITS (ACL_PERM_EXEC | ACL_PERM_WRITE | ACL_PERM_READ) .Ed .Sh 解説 アクセス制御リスト、すなわち ACL は、 ファイルおよびディレクトリを表現する vnode に対する権限を、 きめ細かく指定可能とします。 しかしながら、 異なる ACL のセマンティクスを持つファイルシステムが過多にあるため、 vnode インタフェースは ACL の文法のみを理解し、基礎をなすファイルシステムが 細部を実装することを当てにしています。 基礎をなすファイルシステムに依存して、個々のファイルまたはディレクトリは、 関連付けられる 0 個以上の ACL を持つことが可能です。 それぞれ ACL の名前は、適切な vnode ACL 呼び出し .Xr VOP_ACLCHECK 9 , .Xr VOP_GETACL 9 , .Xr VOP_SETACL 9 の .Fa type フィールドを使用して指定されます。 .Pp 現在は、個々の ACL はカーネル内で固定サイズの ACL 構造体によって表現されます。 ACL は、ACL エントリの固定サイズ配列で構成されます。 各 ACL エントリは、 パーミッションの組、主要な名前空間、主要な識別子から構成されます。 結びつけられた acl_cnt フィールドの値に依存して、 これらの 0 個以上のエントリが "定義" されることが出来ます。 .Sh 関連項目 .Xr VFS 9 , .Xr VOP_ACLCHECK 9 , .Xr VOP_GETACL 9 , .Xr VOP_SETACL 9 .Sh 作者 このマニュアルページは .An Robert Watson が書きました。 diff --git a/ja_JP.eucJP/man/man9/at_exit.9 b/ja_JP.eucJP/man/man9/at_exit.9 index 5cc512fd2f..374514d8b7 100644 --- a/ja_JP.eucJP/man/man9/at_exit.9 +++ b/ja_JP.eucJP/man/man9/at_exit.9 @@ -1,76 +1,76 @@ .\" .\" Copyright (c) 1996 Julian Elischer .\" .\" 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/share/man/man9/at_exit.9,v 1.10.2.6 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/at_exit.9,v 1.10.2.7 2001/12/17 11:30:18 ru Exp % .\" " -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/at_exit.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd August 15, 1996 .Os .Dt AT_EXIT 9 .Sh 名称 .Nm at_exit , .Nm rm_at_exit .Nd exit 時に実行される関数の問合せ .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft typedef\ void ( exitlist_fn ) ( struct\ proc\ * ) ; .Pp .Ft int .Fn at_exit "exitlist_fn func" .Ft int .Fn rm_at_exit "exitlist_fn func" .Sh 解説 .Nm の仕組みは、あらゆるプロセスの exit 時に、 そのことがカーネルモジュールに通知されることを保証します。 関数 .Fa func は、exit しようとしているプロセスの proc 構造体へのポインタを引数として 呼び出されます。 .Pp 通知に対する必要条件が取り除かれた場合、 .Fn at_exit の呼び出しと正確に一致する引数 .Fa func を伴って関数 .Fn rm_at_exit を呼び出さなければなりません。 .Sh 戻り値 .Fa at_exit 関数は errno を返し、0 は成功を意味します。 .Fn rm_at_exit 関数は、削除された項目の個数 (0 または 1 であるべきです) を返します。 .Sh 関連項目 .Xr _exit 2 .Sh 歴史 .Fn at_exit 関数は .Fx 2.2 で登場しました。 .Sh 作者 この関数は .An Julian Elischer Aq julian@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man9/at_fork.9 b/ja_JP.eucJP/man/man9/at_fork.9 index 79a6821ee6..fe07ff4acd 100644 --- a/ja_JP.eucJP/man/man9/at_fork.9 +++ b/ja_JP.eucJP/man/man9/at_fork.9 @@ -1,79 +1,79 @@ .\" .\" Copyright (c) 1996 Julian Elischer .\" .\" 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/share/man/man9/at_fork.9,v 1.9.2.5 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/at_fork.9,v 1.9.2.6 2001/12/17 11:30:18 ru Exp % .\" " -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/at_fork.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd August 15, 1996 .Os .Dt AT_FORK 9 .Sh 名称 .Nm at_fork , .Nm rm_at_fork .Nd fork 時に実行される関数の問合せ .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft "typedef void" ( *forklist_fn ) .Fa ( "struct proc*" , "struct proc*" , int ) ; .Pp .Ft int .Fn at_fork "forklist_fn func" .Ft int .Fn rm_at_fork "forklist_fn func" .Sh 解説 .Nm の仕組みは、あらゆるプロセスの fork 時に、 そのことがカーネルモジュールに通知されることを保証します。 関数 .Fa func は、fork しようとしているプロセスの proc 構造体へのポインタ、 子プロセスの構造体へのポインタおよび .Xr rfork 2 で使用される fork の型を示すフラグを引数として呼び出されます。 .Pp 通知に対する必要条件が取り除かれた場合、 .Fn at_fork の呼び出しと正確に一致引数 .Fa func をとって関数 .Fn rm_at_fork を呼び出さなければなりません。 .Sh 戻り値 .Fn at_fork は errno を返し、0 は成功を意味します。 .Fn rm_at_fork は関数は、削除された項目の個数 (0 または 1 であるべきです) を返します。 .Sh 関連項目 .Xr fork 2 .Sh 歴史 .Fn at_fork 関数は .Fx 2.2 で登場しました。 .Sh 作者 この関数は .An Julian Elischer Aq julian@FreeBSD.org が書きました。 diff --git a/ja_JP.eucJP/man/man9/bios.9 b/ja_JP.eucJP/man/man9/bios.9 index 2fedf9135f..822b8feb7a 100644 --- a/ja_JP.eucJP/man/man9/bios.9 +++ b/ja_JP.eucJP/man/man9/bios.9 @@ -1,123 +1,123 @@ -.\" %FreeBSD: src/share/man/man9/bios.9,v 1.4.2.5 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bios.9,v 1.4.2.6 2001/12/17 11:30:18 ru Exp % .\" .\" Copyright (c) 1997 Michael Smith .\" 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: doc/ja_JP.eucJP/man/man9/bios.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd Aug 1, 1997 .Dt BIOS 9 .Os .Sh 名称 .Nm bios_sigsearch , .Nm bios32_SDlookup , .Nm bios32 .Nd PC BIOS との相互作用 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In machine/pc/bios.h .Ft u_int32_t .Fn bios_sigsearch "u_int32_t start" "u_char *sig" "int siglen" "int paralen" "int sigofs" .Ft int .Fn bios32_SDlookup "struct bios32_SDentry *ent" .Ft void .Fn bios32 "caddr_t entry" "struct bios32_args *args" .Fn BIOS_PADDRTOVADDR "addr" .Fn BIOS_VADDRTOPADDR "addr" .Vt extern struct bios32_SDentry PCIbios ; .Vt extern struct SMBIOS_table SMBIOStable ; .Vt extern struct DMI_table DMItable ; .Sh 解説 これらの関数は、BIOS 関数と x86 PC アーキテクチャシステムで出会うデータを 取り扱うための、汎用インタフェースを提供します。 .Bl -tag -width 20n .It Fn bios_sigsearch サービスシグネチャの BIOS アドレス空間を検索します。 サービスシグネチャは、 大抵はアンダスコアで囲まれている大文字の ASCII 文字列です。 検索は、 .Fa start から、または .Fa start が 0 の場合には BIOS の最初から始まります。 .Fa siglen バイトの BIOS イメージと .Fa sig とが、現在位置から .Fa sigofs バイトのオフセットにおいて比較されます。 マッチしないことが分かると、現在位置が .Fa paralen バイト増加されて検索が繰り返されます。 シグネチャが見つかった場合には、その実効物理アドレスが返されます。 シグネチャが見つからなかった場合には、0 が返されます。 .It Fn BIOS_VADDRTOPADDR カーネル仮想アドレス .Fa addr に対応する実効物理アドレスを返します。 .It Fn BIOS_VADDRTOPADDR 実効物理アドレス .Fa addr に対応するカーネル仮想アドレスを返します。 .It SMBIOStable NULL でない場合は、システム起動時に システムマネージメント BIOS (System Management BIOS; SMBIOS) テーブル から読み込まれた情報を含んでいる .Ft struct SMBIOS_table 構造体を指します。 .It DMItable NULL でない場合は、システム起動時に デスクトップマネージメントインタフェース (Desktop Management Interface; DMI) パラメータテーブル から読み込まれた情報を含んでいる .Ft struct DMI_table 構造体を指します。 .El .Sh BIOS32 システム起動時に、BIOS32 サービスディレクトリ (PCI 仕様の一部) の ために BIOS がスキャンされ、ディレクトリの存在が記録されます。 これは後で、他のサービスの場所を特定するために使用できます。 .Bl -tag -width 20n .It Fn bios32_SDlookup 引数 .Fa ent の .Fa ident フィールドで渡される 4 バイトの識別子にマッチする BIOS32 サービス の場所を特定しようと試みます。 .It Fn bios32 bios32 関数を呼び出します。 これは関数が、カーネルセグメント内で動作できることを 仮定しています (通常の場合)。 エントリポイントの仮想アドレスは .Fa entry で与えられ、 関数へのレジスタ引数は .Fa args で与えられます。 .It PCIbios NULL でない場合は、システム起動時に見つかった PCI BIOS エントリポイントを記述する .Ft struct bios32_SDentry 構造体を指します。 .El diff --git a/ja_JP.eucJP/man/man9/boot.9 b/ja_JP.eucJP/man/man9/boot.9 index 09a1f92dba..7d7bbc0897 100644 --- a/ja_JP.eucJP/man/man9/boot.9 +++ b/ja_JP.eucJP/man/man9/boot.9 @@ -1,107 +1,107 @@ .\" %NetBSD: boot.9,v 1.2 1996/09/24 07:01:26 ghudson Exp % .\" .\" Copyright (c) 1997 .\" Mike Pritchard. All rights reserved. .\" .\" 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 .\" for the NetBSD Project. .\" 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/share/man/man9/boot.9,v 1.4.2.1 2001/07/22 11:02:04 dd Exp % +.\" %FreeBSD: src/share/man/man9/boot.9,v 1.4.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/boot.9,v 1.2 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd February 14, 1997 .Dt BOOT 9 .Os .Sh 名称 .Nm boot .Nd システムの停止または再起動 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h +.In sys/reboot.h .Ft void .Fn boot "int howto" .Sh 解説 .Fn boot 関数は、システムの最終的なシステムシャットダウンと、 停止または再起動を取り扱います。 行なわれる正確な動作は、 .Fa howto で渡されるフラグと、 システムが自動コンフィギュレーションを既に終えているかどうか、 によって決定されます。 .Pp システムが自動コンフィギュレーションを既に終えている場合には、 .Fn boot は次の動作をします。 .Bl -enum -offset indent .It これが最初の .Fn boot の実施の場合で、 .Fa howto に .Dv RB_NOSYNC フラグがセットされていなければ、 .Xr vfs_unmountall 9 を呼び出すことにより、ディスクの同期とアンマウントを行ないます。 .It 割り込みを無効にします。 .It クラッシュの後の再起動の場合 (例えば、 .Fa howto に .Dv RB_DUMP がセットされているが .Dv RB_HALT がセットされていない) は、 システムクラッシュダンプを保存します。 .It .Xr at_shutdown 9 によって以前に設定されたあらゆるシャットダウンフックを実行します。 .It システムが停止させられているのか、 再起動させられているのかを示すメッセージを表示します。 .It .Fa howto に .Dv RB_HALT がセットされている場合には、システムを停止します。 そうでなければ、システムを再起動します。 .El .Pp システムが自動コンフィギュレーションをまだ終えていない場合には、 .Fn boot は .Xr at_shutdown 9 によって以前に設定されたあらゆるシャットダウンフックを実行し、 メッセージを表示し、システムを停止します。 .Sh 関連項目 .Xr at_shutdown 9 , .Xr vfs_unmountall 9 diff --git a/ja_JP.eucJP/man/man9/bus_alloc_resource.9 b/ja_JP.eucJP/man/man9/bus_alloc_resource.9 index 097d7335da..f47811ec24 100644 --- a/ja_JP.eucJP/man/man9/bus_alloc_resource.9 +++ b/ja_JP.eucJP/man/man9/bus_alloc_resource.9 @@ -1,160 +1,160 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 2000 Alexander Langer .\" .\" 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. .\" .\" 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/share/man/man9/bus_alloc_resource.9,v 1.2.2.8 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_alloc_resource.9,v 1.2.2.9 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_alloc_resource.9,v 1.7 2001/08/10 02:12:55 horikawa Exp $ +.\" $FreeBSD$ .Dd May 18, 2000 .Dt BUS_ALLOC_RESOURCE 9 .Os .Sh 名称 .Nm bus_alloc_resource .Nd バス上の資源の割り当て .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Pp -.Fd #include -.Fd #include -.Fd #include +.In machine/bus.h +.In sys/rman.h +.In machine/resource.h .Ft struct resource * .Fn bus_alloc_resource "device_t dev" "int type" "int *rid" "u_long start" "u_long end" "u_long count" "u_int flags" .Sh 解説 これは資源管理関数群への簡単なインタフェースです。 親のメソッドテーブルを通る間接的な方法を隠蔽します。 この関数は、一般的にアタッチ時に呼び出されるべきですが、 (競合状態の場合を除いて) 決してその前に呼び出してはなりません。 .Pp 引数は以下の通りです。 .Bl -item .It .Fa dev は、資源の所有を要求するデバイスです。 割り当て前は、資源は親のバスによって所有されています。 .It .Fa type は、割り当てたい資源の型です。 以下の内の 1 つです。 .Bl -tag -width SYS_RES_MEMORY .It Dv SYS_RES_IRQ IRQ 用。 .It Dv SYS_RES_DRQ ISA DMA ライン用。 .It Dv SYS_RES_IOPORT 入出力ポート用。 .It Dv SYS_RES_MEMORY 入出力メモリ用。 .El .It .Fa rid は、割り当てている資源を識別する、バス固有のハンドルを指します。 ISA では、PnP の仕組みまたは hints の仕組みを通して、デバイスのために セットアップされている資源の配列へのインデックスです。 PCCARD では、この文章を書いている現時点では同様ですが、 将来の newcard では変わるかもしれません。 PCI では、pci コンフィグ空間において、 資源を記述するワードへのオフセットになっています。 バスのメソッドは、引数として与えられている RID を無制限に変更します。 以前に与えた時の値に依存してはなりません。 .It .Fa start および .Fa end は資源の開始/終了アドレスです。 start に .Dv 0 の値を end に .Dv ~0 の値を指定した場合には、バスのためのデフォルト値が計算されます。 .It .Fa count は資源の大きさで、例えば、入出力ポートの大きさです (これは大抵、PCI 上では .Dv 1 で、ISA および PCCARD 上ではデバイス依存です)。 .Fa start および .Fa end にデフォルト値を指定した場合、 .Fa count がデフォルト値よりも小さいならばデフォルト値が使用され、 .Fa count がデフォルト値以上ならば count が使用されます。 .It .Fa flags は資源のためのフラグを設定します。 以下のフラグを 1 つ以上設定できます。 .Bl -tag -width RF_SHAREABLE .It Dv RF_ALLOCATED 資源は既に予約されています。 資源は引続き .Xr rman_activate_resource 9 で活性化される必要があります。 .It Dv RF_ACTIVE 不可分に、資源を活性化します。 .It Dv RF_SHAREABLE 資源は同時共有を許可します。 その資源が共有不可であることを知らない場合、常に設定されるべきです。 バスが共有をサポートしていない場合、 このフラグを取り除くのはバスのコードの仕事です。この例として、 pccard/cardbus ではデバイスを共有できるかできないかは、バスに依存します。 .It Dv RF_TIMESHARE 資源は時分割共有を許可します。 .El .El .Sh 戻り値 成功時には .Va struct resource 構造体へのポインタが返され、そうでない場合にはヌルポインタが返されます。 .Sh 使用例 これはあるサンプルのコードです。 .Va portid および .Va irqid の値はこれらの呼び出しの後で、デバイスの softc の中に保存されるはずです。 .Bd -literal struct resource *portres, irqres; int portid, irqid; portid = 0; irqid = 0; portres = bus_alloc_resource(dev, SYS_RES_IOPORT, &portid, 0ul, ~0ul, 32, RF_ACTIVE); irqres = bus_alloc_resource(dev, SYS_RES_IRQ, &irqid, 0ul, ~0ul, 1, RF_ACTIVE | RF_SHAREABLE); .Ed .Sh 関連項目 .Xr bus_release_resource 9 , .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Alexander Langer Aq alex@big.endian.de が書き、部分的に .An Warner Losh Aq imp@FreeBSD.ORG が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_attach.9 b/ja_JP.eucJP/man/man9/bus_generic_attach.9 index de3bbf5bc3..71e2fcb590 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_attach.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_attach.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_attach.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_attach.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_attach.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_ATTACH 9 .Os .Sh 名称 .Nm bus_generic_attach .Nd バスのための .Dv DEVICE_ATTACH の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_attach "device_t dev" .Sh 解説 この関数はほとんどのバスのコードで使用されることができる .Xr DEVICE_ATTACH 9 メソッドの 1 つの実装を提供します。 単純に、バスに接続されているそれぞれの子デバイスに対して .Xr device_probe_and_attach 9 を呼びます。 .Sh 戻り値 成功時は 0 を、そうでない場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_detach.9 b/ja_JP.eucJP/man/man9/bus_generic_detach.9 index a57132a08d..3243b06b9c 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_detach.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_detach.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_detach.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_detach.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_detach.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_DETACH 9 .Os .Sh 名称 .Nm bus_generic_detach .Nd バスのための .Dv DEVICE_DETACH の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_detach "device_t dev" .Sh 解説 この関数はほとんどのバスのコードで使用されることが可能な .Xr DEVICE_DETACH 9 メソッドの 1 つの実装を提供します。 これは単純にバスにアタッチされている各々の子デバイスの .Xr DEVICE_DETACH 9 を呼びます。 .Sh 戻り値 成功時は 0 を、そうでない場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_map_intr.9 b/ja_JP.eucJP/man/man9/bus_generic_map_intr.9 index 70190b31b5..1bce09224b 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_map_intr.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_map_intr.9 @@ -1,58 +1,58 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_map_intr.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_map_intr.9,v 1.3.2.3 2001/12/21 10:07:15 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_map_intr.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_MAP_INTR 9 .Os .Sh 名称 .Nm bus_generic_map_intr .Nd バスのための .Dv BUS_MAP_INTR の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_map_intr "device_t dev" "device_t child" "driver_intr_t *intr" "void *arg" .Sh 解説 この .Xr BUS_MAP_INTR 9 の単純な実装は、 .Fa dev の親のメソッドを呼び出すだけです。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_print_child.9 b/ja_JP.eucJP/man/man9/bus_generic_print_child.9 index 9aaecc0499..07c51a000f 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_print_child.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_print_child.9 @@ -1,70 +1,70 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_print_child.9,v 1.5.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_print_child.9,v 1.5.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_print_child.9,v 1.5 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_PRINT_CHILD 9 .Os .Sh 名称 .Nm bus_generic_print_child .Nd バスのための .Dv DEVICE_PRINT_CHILD の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_print_child "device_t dev" "device_t child" .Sh 解説 この実装はデフォルトのデバイスアナウンスメッセージを出力します。 与えられた 'bar0' バス上の 'foo0' デバイスが、"FooCard 1234" という名前であるならば、 下記のように出力されるでしょう。 .Pp foo0: on bar0 .Pp bus_generic_print_child 自身は .Fn bus_print_child_header と .Fn bus_print_child_footer の 2 つの関数を呼び出します。 これらはそれぞれ "foo0: " と "on bar0" の文字を出力します。 もし .Fn bus_generic_print_child があなたの要求に完全には合わない場合でも、 可能であればあなたの独自のコードでこれらのルーチンを使用するべきです .Sh 関連項目 .Xr device 9 .Sh 戻り値 出力した文字数。 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_read_ivar.9 b/ja_JP.eucJP/man/man9/bus_generic_read_ivar.9 index c89e9ecd17..1335ee1831 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_read_ivar.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_read_ivar.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_read_ivar.9,v 1.4.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_read_ivar.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_read_ivar.9,v 1.5 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_READ_IVAR 9 .Os .Sh 名称 .Nm bus_generic_read_ivar , .Nm bus_generic_write_ivar .Nd バスのための .Dv BUS_READ_IVAR および .Dv BUS_WRITE_IVAR の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_read_ivar "device_t dev" "device_t child" "int index" "uintptr_t *result" .Ft int .Fn bus_generic_write_ivar "device_t dev" "device_t child" "int index" "uintptr_t value" .Sh 解説 これらの関数は単純に .Er ENOENT を返します。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_generic_shutdown.9 b/ja_JP.eucJP/man/man9/bus_generic_shutdown.9 index 864ff24b60..0266ea3e6c 100644 --- a/ja_JP.eucJP/man/man9/bus_generic_shutdown.9 +++ b/ja_JP.eucJP/man/man9/bus_generic_shutdown.9 @@ -1,61 +1,61 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/bus_generic_shutdown.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_generic_shutdown.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_generic_shutdown.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt BUS_GENERIC_SHUTDOWN 9 .Os .Sh 名称 .Nm bus_generic_shutdown .Nd バスのための .Dv DEVICE_SHUTDOWN の一般的な実装 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn bus_generic_shutdown "device_t dev" .Sh 解説 この関数は、ほとんどのバスのコードで使用されることができる .Xr DEVICE_SHUTDOWN 9 の実装を提供します。 これは単純に、 バスにアタッチされているの子デバイスそれぞれの .Xr DEVICE_SHUTDOWN 9 メソッドを呼び出します。 .Sh 戻り値 成功時には 0 が返され、それ以外の場合は適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/bus_release_resource.9 b/ja_JP.eucJP/man/man9/bus_release_resource.9 index 05cc238cd1..926b81c48e 100644 --- a/ja_JP.eucJP/man/man9/bus_release_resource.9 +++ b/ja_JP.eucJP/man/man9/bus_release_resource.9 @@ -1,110 +1,110 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 2000 Alexander Langer .\" .\" 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. .\" .\" 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/share/man/man9/bus_release_resource.9,v 1.2.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/bus_release_resource.9,v 1.2.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/bus_release_resource.9,v 1.4 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd May 18, 2000 .Dt BUS_RELEASE_RESOURCE 9 .Os .Sh 名称 .Nm bus_release_resource .Nd バス上の資源の開放 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Pp -.Fd #include -.Fd #include -.Fd #include +.In machine/bus.h +.In sys/rman.h +.In machine/resource.h .Fd #include .Ft int .Fn bus_release_resource "device_t dev" "int type" "int rid" "struct resource *r" .Sh 解説 .Xr bus_alloc_resource 9 によって割り当てられた資源を開放します。 その資源は開放時に使用中であってはなりません。 すなわち、適切な関数 (IRQ のための .Xr bus_teardown_intr 9 など) を事前に呼び出してください。 .Bl -item .It .Fa dev は、資源を所有しているデバイスです。 .It .Fa type は、開放される資源の型です。 以前に割り当てた時と同一の型でなければなりません。 有効な型については .Xr bus_alloc_resource 9 を参照してください。 .It .Fa rid は、資源の資源識別子です。 .Fa rid は .Xr bus_alloc_resource 9 によって返された識別子と同一でなければなりません。 .It .Fa r は .Va struct resource 構造体へのポインタで、すなわち .Xr bus_alloc_resource 9 によって返された資源そのものです。 .El .Sh 戻り値 デバイス .Fa dev が親を持たない場合には .Er EINVAL が返され、そうでない場合には .Dv 0 が返されます。 資源を開放できない場合には、カーネルはパニックするでしょう。 .Sh 使用例 .Bd -literal /* IRQ の不活性化 */ bus_teardown_intr(dev, foosoftc->irqres, foosoftc->irqid); /* IRQ 資源の開放 */ bus_release_resource(dev, SYS_RES_IRQ, foosoftc->irqid, foosoftc->irqres); /* 入出力ポートの資源の開放 */ bus_release_resource(dev, SYS_RES_IOPORT, foosoftc->portid, foosoftc->portres); .Ed .Sh 関連項目 .Xr bus_alloc_resource 9 , .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Alexander Langer Aq alex@big.endian.de が書きました。 diff --git a/ja_JP.eucJP/man/man9/copy.9 b/ja_JP.eucJP/man/man9/copy.9 index 1aa11dd416..3ca9f130a6 100644 --- a/ja_JP.eucJP/man/man9/copy.9 +++ b/ja_JP.eucJP/man/man9/copy.9 @@ -1,143 +1,143 @@ .\" %NetBSD: copy.9,v 1.2 1996/01/09 03:23:04 thorpej Exp % .\" .\" Copyright (c) 1996 Jason R. Thorpe. .\" All rights reserved. .\" .\" This code is derived from software contributed by Kenneth Stailey. .\" .\" 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 for the NetBSD Project .\" by Jason R. Thorpe. .\" 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/share/man/man9/copy.9,v 1.6.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/copy.9,v 1.6.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/copy.9,v 1.4 2001/05/14 01:10:22 horikawa Exp $ +.\" $FreeBSD$ .Dd January 7, 1996 .Dt COPY 9 .Os .Sh 名称 .Nm copy , .Nm copyin , .Nm copyout , .Nm copystr , .Nm copyinstr .\" .Nm copyinstr , .\" .Nm copyoutstr .Nd カーネルコピー関数 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft int .Fn copyin "const void *uaddr" "void *kaddr" "size_t len" .Ft int .Fn copyout "const void *kaddr" "void *uaddr" "size_t len" .Ft int .Fn copystr "const void *kfaddr" "void *kdaddr" "size_t len" "size_t *done" .Ft int .Fn copyinstr "const void *uaddr" "void *kaddr" "size_t len" "size_t *done" .\" .Ft int .\" .Fn copyoutstr "const void *kaddr" "void *uaddr" "size_t len" "size_t *done" .Sh 解説 .Nm 関数群は連続したデータをあるアドレスから 別のアドレスへコピーするようデザインされています。 .Fn copystr 以外の関数は、ユーザー空間からカーネル空間へ、 あるいは反対向きにデータをコピーします。 .Pp .Nm 関数群は以下の機能を提供します。 .Bl -tag -width "copyoutstr()" .It Fn copyin ユーザー空間のアドレス .Pa uaddr からカーネル空間のアドレス .Pa kaddr へ .Pa len バイトのデータをコピーします。 .It Fn copyout カーネル空間のアドレス .Pa kaddr からユーザー空間のアドレス .Pa uaddr へ .Pa len バイトのデータをコピーします。 .It Fn copystr カーネル空間のアドレス .Pa kfaddr からカーネル空間のアドレス .Pa kdaddr へヌル文字で終端された最大 .Pa len 文字の文字列をコピーします。 末尾のヌル文字を含む実際にコピーされた文字数が .Pa *done に返されます。 .It Fn copyinstr ユーザー空間のアドレス .Pa uaddr からカーネル空間のアドレス .Pa kaddr へヌル文字で終端された最大 .Pa len 文字の文字列をコピーします。 末尾のヌル文字を含む実際にコピーされた文字数が .Pa *done に返されます。 .\" .It Fn copyoutstr .\" カーネル空間のアドレス .\" .Pa kaddr .\" からユーザー空間のアドレス .\" .Pa uaddr .\" へヌル文字で終端された最大 .\" .Pa len .\" 文字の文字列をコピーします。 .\" 末尾のヌル文字を含む実際にコピーされた文字数が .\" .Pa *done .\" に返されます。 .El .Sh 戻り値 それぞれの .Nm 関数は成功した時に 0 を、不正なアドレスに遭遇した時に .Er EFAULT を返します。 さらに、 .Fn copystr および .Fn copyinstr .\" 、 .\" .Fn copyoutstr 関数は文字列が .Pa len バイトよりも長い時に .Er ENAMETOOLONG を返します。 .Sh 関連項目 .Xr fetch 9 , .Xr store 9 diff --git a/ja_JP.eucJP/man/man9/devclass_add_driver.9 b/ja_JP.eucJP/man/man9/devclass_add_driver.9 index 511a64e3e6..4aeb6063ff 100644 --- a/ja_JP.eucJP/man/man9/devclass_add_driver.9 +++ b/ja_JP.eucJP/man/man9/devclass_add_driver.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_add_driver.9,v 1.3.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_add_driver.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_add_driver.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_ADD_DRIVER 9 .Os .Sh 名称 .Nm devclass_add_driver , .Nm devclass_delete_driver , .Nm devclass_find_driver .Nd devclass の中のドライバの操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn devclass_add_driver "devclass_t dc" "driver_t *driver" .Ft int .Fn devclass_delete_driver "devclass_t dc" "driver_t *driver" .Ft driver_t * .Fn devclass_find_driver "devclass_t dc" "const char *name" .Sh 解説 これらの関数は、システムに新しいドライバを追加するため、 古いドライバを削除するため、 および存在しているドライバを探すため、使用可能です。 通常、ドライバはシステム初期化時に自動的に追加されます。 .Sh 関連項目 .Xr devclass 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_find.9 b/ja_JP.eucJP/man/man9/devclass_find.9 index fbdc3a02ea..9edf9c124a 100644 --- a/ja_JP.eucJP/man/man9/devclass_find.9 +++ b/ja_JP.eucJP/man/man9/devclass_find.9 @@ -1,57 +1,57 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_find.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_find.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_find.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_FIND 9 .Os .Sh 名称 .Nm devclass_find .Nd devclass の検索 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft devclass_t .Fn devclass_find "const char *classname" .Sh 解説 指定された名前の .Dv devclass を検索します。 .Sh 戻り値 .Dv devclass が存在する場合にはその devclass が返され、そうでない場合には .Dv NULL が返されます。 .Sh 関連項目 .Xr devclass 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_get_device.9 b/ja_JP.eucJP/man/man9/devclass_get_device.9 index 4bdbdcb5a9..31375dd853 100644 --- a/ja_JP.eucJP/man/man9/devclass_get_device.9 +++ b/ja_JP.eucJP/man/man9/devclass_get_device.9 @@ -1,55 +1,55 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_get_device.9,v 1.4.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_get_device.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_get_device.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_GET_DEVICE 9 .Os .Sh 名称 .Nm devclass_get_device .Nd ユニット番号からデバイスへの変換 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft device_t .Fn devclass_get_device "devclass_t dc" "int unit" .Sh 解説 この関数は、指定されたユニット番号のデバイスインスタンスを取り出し、 それを返します。 .Sh 戻り値 デバイスが存在する場合にはそのデバイスが返され、 そうでない場合には NULL が返されます。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_get_devices.9 b/ja_JP.eucJP/man/man9/devclass_get_devices.9 index 5ad9ed5846..c6476ab177 100644 --- a/ja_JP.eucJP/man/man9/devclass_get_devices.9 +++ b/ja_JP.eucJP/man/man9/devclass_get_devices.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_get_devices.9,v 1.4.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_get_devices.9,v 1.4.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_get_devices.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_GET_DEVICES 9 .Os .Sh 名称 .Nm devclass_get_devices .Nd devclass の中のデバイスのリストの取り出し .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn devclass_get_devices "devclass_t dc" "device_t **devlistp" "int *devcountp" .Sh 解説 現在 devclass の中にある全てのデバイスインスタンスのリストを取り出し、 .Fa *devlistp にそのリストを .Fa *devcountp にその個数を返します。 リストのために割り当てられたメモリは、 .Fn free "*devlistp" "M_TEMP" を用いて開放されるべきです。 .Sh 戻り値 成功時には 0 が返され、そうでない場合には適切なエラーが返されます。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_get_maxunit.9 b/ja_JP.eucJP/man/man9/devclass_get_maxunit.9 index a751bab5d8..eff2bc0f54 100644 --- a/ja_JP.eucJP/man/man9/devclass_get_maxunit.9 +++ b/ja_JP.eucJP/man/man9/devclass_get_maxunit.9 @@ -1,53 +1,53 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_get_maxunit.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_get_maxunit.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_get_maxunit.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_GET_MAXUNIT 9 .Os .Sh 名称 .Nm devclass_get_maxunit .Nd クラスの中の最大のユニット番号を検索 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn devclass_get_maxunit "devclass_t dc" .Sh 解説 指定された .Dv devclass の中のデバイスインスタンスに割り当てられた、最大のユニット番号を返します。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_get_name.9 b/ja_JP.eucJP/man/man9/devclass_get_name.9 index 3d29678094..c94c16a6f7 100644 --- a/ja_JP.eucJP/man/man9/devclass_get_name.9 +++ b/ja_JP.eucJP/man/man9/devclass_get_name.9 @@ -1,51 +1,51 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_get_name.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_get_name.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_get_name.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_GET_NAME 9 .Os .Sh 名称 .Nm devclass_get_name .Nd devclass の名前の入手 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft const char * .Fn devclass_get_name "devclass_t dc" .Sh 解説 devclass の名前を返します。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devclass_get_softc.9 b/ja_JP.eucJP/man/man9/devclass_get_softc.9 index 30b75b6219..4cc2c938e7 100644 --- a/ja_JP.eucJP/man/man9/devclass_get_softc.9 +++ b/ja_JP.eucJP/man/man9/devclass_get_softc.9 @@ -1,56 +1,56 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/devclass_get_softc.9,v 1.4.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devclass_get_softc.9,v 1.4.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devclass_get_softc.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVCLASS_GET_SOFTC 9 .Os .Sh 名称 .Nm devclass_get_softc .Nd ユニット番号からドライバの私的構造体への変換 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void * .Fn devclass_get_softc "devclass_t dc" "int unit" .Sh 解説 この関数は、指定されたユニット番号から、 そのデバイスのためのドライバの私的なインスタンス変数を取り出し、 それを返します。 .Sh 戻り値 そのデバイスが存在している場合には、 そのデバイスのドライバの私的な変数が返され、 そうでない場合には、NULL が返されます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_add_child.9 b/ja_JP.eucJP/man/man9/device_add_child.9 index 7ab154ecd7..461f9b0974 100644 --- a/ja_JP.eucJP/man/man9/device_add_child.9 +++ b/ja_JP.eucJP/man/man9/device_add_child.9 @@ -1,99 +1,99 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_add_child.9,v 1.8.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_add_child.9,v 1.8.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_add_child.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_ADD_CHILD 9 .Os .Sh 名称 .Nm device_add_child , .Nm device_add_child_ordered .Nd 存在しているデバイスの子として新しいデバイスを追加 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft device_t .Fn device_add_child "device_t dev" "const char *name" "int unit" .Ft device_t .Fn device_add_child_ordered "device_t dev" "int order" "const char *name" "int unit" .Sh 解説 .Fa dev の新しい子デバイスを追加します。 .Fa name および .Fa unit 引数はデバイスの名前とユニット番号を指定します。 名前が不明の場合には、呼び出し側は .Dv NULL を渡すべきです。 ユニット番号が不明の場合には、呼び出し側は .Dv -1 を渡すべきで、システムは次の使用可能なユニット番号を選択するでしょう。 .Pp デバイスの名前は、どのドライバがそのデバイスに適切であるかを 決定するために使用されます。 名前が指定されている場合には、その名前のドライバのみがプローブされます。 名前が与えられなかった場合には、 認識しているバスの全てのドライバがプローブされます。 .Pp これは、デバイスインスタンスを独自に識別することができるバス (PCI 等) が、 個々のドライバが個々のデバイスインスタンスに適合しているか チェック可能にします。 供給されたプローブヒントに依存して、 たった 1 つのドライバがデバイスをプローブ可能なバスでは、 ドライバの名前はデバイスの名前として指定されるべきです。 .Pp 通常、ユニット番号はシステムによって時動的に選択されますので、ユニット番号は .Dv -1 が与えられるべきです。 指定のユニット番号が希望された時に (例えば、ハードウェアの一部分を あらかじめ設定されたユニット番号に結びつけるため)、unit は渡されるべきです。 指定されたユニット番号が既に割り当てられていた場合には、新しいユニット番号が 割り当てられ、診断メッセージが表示されます。 .Pp 指定の順序でプローブされなければならないバス (例えば、ISA バス用の幾つかの デバイスは関連の無いドライバのプローブの試みの失敗に敏感で、それゆえ 最初にプローブされなければならない) にアタッチされたデバイスの場合には、 .Xr device_add_child_ordered 9 の .Fa order 引数が半順序を指定するために使用されるべきです。 新しいデバイスは、 既存のより大きい順序を持つすべてのデバイスの前に追加されます。 .Xr device_add_child 9 が使用された場合には、順序が 0 であるとして新しい子が追加されます。 .Sh 戻り値 成功時には新しいデバイスが、そうでなければ NULL が返されます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_delete_child.9 b/ja_JP.eucJP/man/man9/device_delete_child.9 index f4f3d8aaf0..91e08840a1 100644 --- a/ja_JP.eucJP/man/man9/device_delete_child.9 +++ b/ja_JP.eucJP/man/man9/device_delete_child.9 @@ -1,60 +1,60 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_delete_child.9,v 1.3.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_delete_child.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_delete_child.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_DELETE_CHILD 9 .Os .Sh 名称 .Nm device_delete_child .Nd デバイスから子を削除 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn device_delete_child "device_t dev" "device_t child" .Sh 解説 指定されたデバイスを .Fa dev から取り除き削除します。 そのデバイスが現在アタッチされている場合には、先にデタッチ ( .Xr DEVICE_ATTACH 9 および .Xr DEVICE_DETACH 9 を参照してください) されます。 .Sh 戻り値 成功時には 0 が返され、そうでない場合にはエラーが返されます。 .Sh 関連項目 .Xr device_add_child 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_enable.9 b/ja_JP.eucJP/man/man9/device_enable.9 index f4b66e4701..f429f2b1e4 100644 --- a/ja_JP.eucJP/man/man9/device_enable.9 +++ b/ja_JP.eucJP/man/man9/device_enable.9 @@ -1,65 +1,65 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_enable.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_enable.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_enable.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_ENABLE 9 .Os .Sh 名称 .Nm device_enable , .Nm device_disable , .Nm device_is_enabled .Nd デバイスの有効フラグの操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void .Fn device_enable "device_t dev" .Ft void .Fn device_disable "device_t dev" .Ft int .Fn device_is_enabled "device_t dev" .Sh 解説 個々のデバイスは、結びつけられた有効フラグを持っています。 デバイスは生成時にはデフォルトで有効になっていますが、(例えば、破壊的または 時間を消費するプローブの試みを防ぐために) 無効にできます。 デバイスを無効にするには .Xr device_disable 9 を呼び出し、再度有効にするには .Xr device_enable 9 を呼び出し、デバイスが有効かどうか確認するには .Xr device_is_enabled 9 を呼び出します。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_find_child.9 b/ja_JP.eucJP/man/man9/device_find_child.9 index 229fa9df56..a479dabf69 100644 --- a/ja_JP.eucJP/man/man9/device_find_child.9 +++ b/ja_JP.eucJP/man/man9/device_find_child.9 @@ -1,58 +1,58 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_find_child.9,v 1.4.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_find_child.9,v 1.4.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_find_child.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_FIND_CHILD 9 .Os .Sh 名称 .Nm device_find_child .Nd デバイスの子の検索 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft device_t .Fn device_find_child "device_t dev" "const char* name" "int unit" .Sh 解説 この関数は、 .Dv dev の子で、 .Fa name および .Fa unit を持つものを検索します。 .Sh 戻り値 存在している場合には子デバイスが返され、そうでない場合には NULL が返されます。 .Sh 関連項目 .Xr device_add_child 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_children.9 b/ja_JP.eucJP/man/man9/device_get_children.9 index 62725c2890..ad77adc19a 100644 --- a/ja_JP.eucJP/man/man9/device_get_children.9 +++ b/ja_JP.eucJP/man/man9/device_get_children.9 @@ -1,62 +1,62 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_children.9,v 1.1.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_children.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_children.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd December 1, 1999 .Dt DEVICE_GET_CHILDREN 9 .Os .Sh 名称 .Nm device_get_children .Nd デバイスに接続されているデバイスのリストの取得 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn device_get_children "device_t dev" "device_t **devlistp" "int *devcountp" .Sh 解説 現在 .Pa dev に接続されている全てのデバイスインスタンスのリストを取り出し、そのリストを .Fa *devlistp に、その個数を .Fa *devcountp に入れて返します。 リストのために割り当てられたメモリは .Fn free "*devlistp" "M_TEMP" を使用して開放されるべきです。 .Sh 戻り値 成功時には 0 が返され、そうでない場合には適切なエラーが返されます。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_devclass.9 b/ja_JP.eucJP/man/man9/device_get_devclass.9 index 350e927c91..f869ecbbb2 100644 --- a/ja_JP.eucJP/man/man9/device_get_devclass.9 +++ b/ja_JP.eucJP/man/man9/device_get_devclass.9 @@ -1,54 +1,54 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_devclass.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_devclass.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_devclass.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_DEVCLASS 9 .Os .Sh 名称 .Nm device_get_devclass .Nd デバイスのデバイスクラスへのアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft devclass_t .Fn device_get_devclass "device_t dev" .Sh 解説 デバイスに関連づけられている現在のデバイスクラスが返されます。 デバイスがデバイスクラスを持っていない場合には、 .Dv NULL が返されます。 .Sh 関連項目 .Xr devclass 9 , .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_driver.9 b/ja_JP.eucJP/man/man9/device_get_driver.9 index 34e5b23f12..266faa1e32 100644 --- a/ja_JP.eucJP/man/man9/device_get_driver.9 +++ b/ja_JP.eucJP/man/man9/device_get_driver.9 @@ -1,54 +1,54 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_driver.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_driver.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_driver.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_DRIVER 9 .Os .Sh 名称 .Nm device_get_driver .Nd デバイスのドライバへのアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft driver_t * .Fn device_get_driver "device_t dev" .Sh 解説 デバイスに関連づけられている現在のドライバが返されます。 デバイスがドライバを持っていない場合には、 .Dv NULL が返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_ivars.9 b/ja_JP.eucJP/man/man9/device_get_ivars.9 index 1132f8a862..14d8e4a7f6 100644 --- a/ja_JP.eucJP/man/man9/device_get_ivars.9 +++ b/ja_JP.eucJP/man/man9/device_get_ivars.9 @@ -1,50 +1,50 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_ivars.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_ivars.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_ivars.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_IVARS 9 .Os .Sh 名称 .Nm device_get_ivars .Nd バスの私的変数へのアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void * .Fn device_get_ivars "device_t dev" .Sh 解説 デバイスのバス固有のインスタンス変数を返します。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_softc.9 b/ja_JP.eucJP/man/man9/device_get_softc.9 index c3ae657224..3b6be87c97 100644 --- a/ja_JP.eucJP/man/man9/device_get_softc.9 +++ b/ja_JP.eucJP/man/man9/device_get_softc.9 @@ -1,52 +1,52 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_softc.9,v 1.3.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_softc.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_softc.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_SOFTC 9 .Os .Sh 名称 .Nm device_get_softc .Nd ドライバの私的なインスタンス変数へのアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void * .Fn device_get_softc "device_t dev" .Sh 解説 デバイスのドライバ固有のインスタンス変数を返します。 .Sh 戻り値 デバイス固有のインスタンス変数へのポインタが返されます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_state.9 b/ja_JP.eucJP/man/man9/device_get_state.9 index ebc2ef9c43..e8f286d248 100644 --- a/ja_JP.eucJP/man/man9/device_get_state.9 +++ b/ja_JP.eucJP/man/man9/device_get_state.9 @@ -1,95 +1,95 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_state.9,v 1.3.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_state.9,v 1.3.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_state.9,v 1.5 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_STATE 9 .Os .Sh 名称 .Nm device_get_state , .Nm device_busy , .Nm device_unbusy , .Nm device_is_alive .Nd デバイス状態の操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft device_state_t .Fn device_get_state "device_t dev" .Ft void .Fn device_busy "device_t dev" .Ft void .Fn device_unbusy "device_t dev" .Ft int .Fn device_is_alive "device_t dev" .Sh 解説 デバイスの現在の状態は、 .Dv DS_NOTPRESENT , .Dv DS_ALIVE , .Dv DS_ATTACHED , .Dv DS_BUSY ( .Xr device 9 で説明されています) を返す .Xr device_get_state 9 の呼び出しによってアクセスされます。 デバイスがうまくプローブされたことを確認するには、単純に状態が .Dv DS_ALIVE 以上であるかどうかを返す .Xr device_is_alive 9 を呼び出します。 .Pp 個々のデバイスは、 .Xr device_busy 9 が呼び出された時にインクリメントされ、 .Xr device_unbusy 9 が呼び出された時にデクリメントされるビジーカウントを持っています。 どちらのルーチンもデバイスの状態が .Dv DS_ATTACHED より小さい場合にはエラーを返します。 .Pp デバイスが .Dv DS_ATTACHED 状態で .Xr device_busy 9 が呼び出された時には、デバイスは .Dv DS_BUSY 状態に遷移します。 .Xr device_unbusy 9 が呼び出されでデクリメントされた後にデバイスのビジーカウントが 0 ならば、 デバイスは .Dv DS_ATTACHED 状態に遷移します。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_get_unit.9 b/ja_JP.eucJP/man/man9/device_get_unit.9 index baed47023b..919cf74be4 100644 --- a/ja_JP.eucJP/man/man9/device_get_unit.9 +++ b/ja_JP.eucJP/man/man9/device_get_unit.9 @@ -1,50 +1,50 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_get_unit.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_get_unit.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_get_unit.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_GET_UNIT 9 .Os .Sh 名称 .Nm device_get_unit .Nd デバイスのユニット番号へのアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn device_get_unit "device_t dev" .Sh 解説 デバイスのユニット番号を返します。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_probe_and_attach.9 b/ja_JP.eucJP/man/man9/device_probe_and_attach.9 index 5bffce3537..43abc89836 100644 --- a/ja_JP.eucJP/man/man9/device_probe_and_attach.9 +++ b/ja_JP.eucJP/man/man9/device_probe_and_attach.9 @@ -1,61 +1,61 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_probe_and_attach.9,v 1.3.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_probe_and_attach.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_probe_and_attach.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_PROBE_AND_ATTACH 9 .Os .Sh 名称 .Nm device_probe_and_attach .Nd デバイスの初期化 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft int .Fn device_probe_and_attach "device_t dev" .Sh 解説 この関数は、自動コンフィギュレーションの間に呼び出され、 システムのデバイスを初期化します。 個々のデバイスに対して、適切なドライバの .Xr DEVICE_PROBE 9 メソッドが呼び出され、プローブに成功した場合には、デバイスの記述が表示され、 .Xr DEVICE_ATTACH 9 メソッドが呼び出されます。 .Xr device_disable 9 を使用してデバイスが無効にされている場合には、プローブされません。 .Sh 戻り値 成功時には 0 が返され、そうでない場合には適切なエラーが返されます。 .Sh 関連項目 .Xr device 9 , .Xr driver 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_quiet.9 b/ja_JP.eucJP/man/man9/device_quiet.9 index d98a9b50d5..77e4a5e38b 100644 --- a/ja_JP.eucJP/man/man9/device_quiet.9 +++ b/ja_JP.eucJP/man/man9/device_quiet.9 @@ -1,68 +1,68 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_quiet.9,v 1.3.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_quiet.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_quiet.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 21, 1999 .Dt DEVICE_QUIET 9 .Os .Sh 名称 .Nm device_quiet , .Nm device_verbose , .Nm device_is_quiet .Nd デバイスの沈黙フラグの操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void .Fn device_quiet "device_t dev" .Ft void .Fn device_verbose "device_t dev" .Ft int .Fn device_is_quiet "device_t dev" .Sh 解説 個々のデバイスは結びつけられた沈黙フラグを持っています。 デバイスは生成時のデフォルトでは冗長ですが、プローブ中に デバイス識別文字列の出力を妨げるために、沈黙させられます。 デバイスを沈黙させるには .Xr device_quiet 9 を呼び出し、プローブメッセージを再度有効 (例えば .Xr device_detach 9 の後に、メッセージが再び現れるようにします) にするには .Xr device_verbose 9 を呼び出します。 デバイスが沈黙状態かどうかを確認するためには .Xr device_is_quiet 9 を呼び出します。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_set_desc.9 b/ja_JP.eucJP/man/man9/device_set_desc.9 index 1d48faf526..897cd39619 100644 --- a/ja_JP.eucJP/man/man9/device_set_desc.9 +++ b/ja_JP.eucJP/man/man9/device_set_desc.9 @@ -1,65 +1,65 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1998 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_set_desc.9,v 1.5.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_set_desc.9,v 1.5.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_set_desc.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1998 .Dt DEVICE_SET_DESC 9 .Os .Sh 名称 .Nm device_set_desc , .Nm device_set_desc_copy , .Nm device_get_desc .Nd デバイスの記述にアクセス .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void .Fn device_set_desc "device_t dev" "const char *desc" .Ft void .Fn device_set_desc_copy "device_t dev" "const char *desc" .Ft const char * .Fn device_get_desc "device_t dev" .Sh DESCRIPTION デバイスの冗長な記述を操作します。 (存在するならば) この記述は、 自動コンフィギュレーションの間のアタッチ時に、 メッセージの一部として表示されます。 変種の .Xr device_set_desc_copy 9 は、渡される文字列が上書きされるかも知れない一時的なバッファである場合に、 使用されます。 この場合にはシステムはその文字列をコピーしますが、 そうでない場合には渡されたポインタが直接使用されます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/device_set_flags.9 b/ja_JP.eucJP/man/man9/device_set_flags.9 index a5a7e664f5..e8ac547e7c 100644 --- a/ja_JP.eucJP/man/man9/device_set_flags.9 +++ b/ja_JP.eucJP/man/man9/device_set_flags.9 @@ -1,59 +1,59 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1999 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/device_set_flags.9,v 1.1.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/device_set_flags.9,v 1.1.2.5 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/device_set_flags.9,v 1.3 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd September 6, 1999 .Dt DEVICE_GET_FLAGS 9 .Os .Sh 名称 .Nm device_set_flags , .Nm device_get_flags .Nd ドライバフラグの操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/bus.h .Ft void .Fn device_set_flags "device_t dev" "u_int32_t flags" .Ft u_int32_t .Fn device_get_flags "device_t dev" .Sh 解説 個々のデバイスは、デバイスの振舞いを制御するために使用される ドライバ依存のフラグの組を、しばしばサポートしています。 これらのフラグは .Xr device_get_flags 9 の呼び出しによって読み込まれ、 .Xr device_set_flags 9 の呼び出しによって書き込まれます。 .Sh 関連項目 .Xr device 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/devtoname.9 b/ja_JP.eucJP/man/man9/devtoname.9 index cac1ac0788..a372e79635 100644 --- a/ja_JP.eucJP/man/man9/devtoname.9 +++ b/ja_JP.eucJP/man/man9/devtoname.9 @@ -1,57 +1,57 @@ .\" Copyright (c) 1999 Chris Costello .\" 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/share/man/man9/devtoname.9,v 1.2.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/devtoname.9,v 1.2.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/devtoname.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd September 25, 1999 .Os .Dt DEVTONAME 9 .Sh 名称 .Nm devtoname .Nd dev_t データをデバイス名を示す文字列に変換 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/conf.h .Ft const char * .Fn devtoname "dev_t dev" .Sh 解説 .Fn devtoname 関数は、渡されたデバイスの名前へのポインタを返します。 名前は .Fn make_dev で設定されたものです。 .Va dev に関連付けられた名前が無い場合には、 .Dq # とそれに続く .Va dev に割り当てられている .Dq Va メジャー Ns / Ns Va マイナ番号 で構成される文字列へのポインタが返されます。 .Sh 歴史 .Fn devtoname インタフェースは .Fx 4.0 で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man9/fetch.9 b/ja_JP.eucJP/man/man9/fetch.9 index f5abaf30e7..6489c0f10d 100644 --- a/ja_JP.eucJP/man/man9/fetch.9 +++ b/ja_JP.eucJP/man/man9/fetch.9 @@ -1,90 +1,91 @@ .\" %NetBSD: fetch.9,v 1.2 1996/01/09 21:59:24 perry Exp % .\" .\" Copyright (c) 1996 Jason R. Thorpe. .\" All rights reserved. .\" .\" This code is derived from software contributed by Kenneth Stailey. .\" .\" 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 for the NetBSD Project .\" by Jason R. Thorpe. .\" 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/share/man/man9/fetch.9,v 1.6.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/fetch.9,v 1.6.2.4 2001/12/17 11:30:18 ru Exp % +.\" $FreeBSD$ .\" .Dd January 7, 1996 .Dt FETCH 9 .Os .Sh 名称 .Nm fetch , .Nm fubyte , .Nm fusword , .Nm fuswintr , .Nm fuword .Nd ユーザー空間からのデータの取り出し .Sh 書式 -.Fd #include -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In sys/time.h +.In sys/systm.h +.In sys/resourcevar.h .Ft int .Fn fubyte "const void *base" .Ft int .Fn fusword "void *base" .Ft int .Fn fuswintr "void *base" .Ft long .Fn fuword "const void *base" .Sh 解説 .Nm 関数群はユーザー空間から小さなデータをコピーするようにデザインされています。 .Pp .Nm ルーチンは以下の機能を提供します。 .Bl -tag -width "fuswintr()" .It Fn fubyte ユーザー空間のアドレス .Pa base から 1 バイトのデータを取り出します。 .It Fn fusword ユーザー空間のアドレス .Pa base から 1 ショートワードのデータを取り出します。 .It Fn fuswintr ユーザー空間のアドレス .Pa base から 1 ショートワードデータを取り出します。 この関数は割り込みコンテキスト中でも安全に呼び出せます。 .It Fn fuword ユーザー空間のアドレス .Pa base から 1 ワードのデータを取り出します。 .El .Sh 戻り値 .Nm 関数は取り出したデータを返しますが、失敗した場合は -1 を返します。 .Sh 関連項目 .Xr copy 9 , .Xr store 9 diff --git a/ja_JP.eucJP/man/man9/inittodr.9 b/ja_JP.eucJP/man/man9/inittodr.9 index 87af51f82c..75710ab520 100644 --- a/ja_JP.eucJP/man/man9/inittodr.9 +++ b/ja_JP.eucJP/man/man9/inittodr.9 @@ -1,116 +1,117 @@ .\" %NetBSD: inittodr.9,v 1.2 1996/03/27 21:16:06 jtc 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 .\" for the NetBSD Project. .\" 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/share/man/man9/inittodr.9,v 1.4.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/inittodr.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp % +.\" $FreeBSD$ .\" .Dd March 22, 1997 .Dt INITTODR 9 .Os .Sh 名称 .Nm inittodr .Nd システムタイムの初期化 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft void .Fn inittodr "time_t base" .Sh 解説 .Fn inittodr 関数は時刻を決定しシステムクロックの設定を行います。 システムのバッテリバックアップクロックおよび .Fa base で与えられるルートファイルシステムから得られる時刻 を検査する発見方法を使用して正しい時刻の取得を試みます。 .Fa base の値を得る方法は、ルートファイルシステムのタイプに依存して変化するでしょう。 下記の発見方法が使用されます。 .Bl -bullet .It バッテリバックアップクロックが妥当な時刻であれば、これが使用されます。 .\" .It .\" If the battery-backed clock does not have a valid time, and .\" the time provided in .\" .Fa base .\" is within reason, .\" .Fa base .\" is used as the current time. .\" .It .\" If the battery-backed clock appears invalid, and .\" .Fa base .\" appears non-sensical or was not provided (was given as zero), .\" a arbitrary base (typically some time in the late 1970s) .\" will be used. .It バッテリバックアップクロックが妥当な時刻でなければ、 .Fa base で与えられた時刻が使用されます。 .El .Pp 一度システムタイムが決定されると、これが .Va time 変数に格納されます。 .Sh 診断 システムタイムの計算に問題があった場合は、 .Fn inittodr 関数は診断メッセージを出力します。 出力される診断メッセージには下記の状態が含まれます。 .Bl -bullet .It バッテリバックアップクロックが無意味のようである。 .\" .It .\" The .\" .Fa base .\" time appears nonsensical. .\" .It .\" The .\" .Fa base .\" time and the battery-backed clock's time differ by a large amount. .El .Sh 関連項目 .Xr resettodr 9 , .Xr time 9 .Sh バグ 多くのシステムで .Fn inittodr は、 年、月、日、時、分、秒で表現される時刻から、秒で表現される .Va time に変換しなければなりません。 多くの実装ではコードの共有が可能ですが、共有していません。 .Pp それぞれのシステムの正確な時刻取得のための発見方法は、わずかに異なります。 .Pp .Fx の実装は、 バッテリバックアップクロックを使用できない場合は、 .Fa base で与えられた時刻をもっとうまく検証するべきでしょう。 現在は無条件にシステムタイムをこの値に設定します。 diff --git a/ja_JP.eucJP/man/man9/kernacc.9 b/ja_JP.eucJP/man/man9/kernacc.9 index 46dfa7b114..e8476bfa18 100644 --- a/ja_JP.eucJP/man/man9/kernacc.9 +++ b/ja_JP.eucJP/man/man9/kernacc.9 @@ -1,90 +1,90 @@ .\" %NetBSD: access.9,v 1.1 1996/06/16 10:38:35 pk Exp % .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Paul Kranenburg. .\" .\" 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 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/share/man/man9/kernacc.9,v 1.7.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/kernacc.9,v 1.7.2.4 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/kernacc.9,v 1.4 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 16, 1996 .Dt KERNACC 9 .Os .Sh 名称 .Nm kernacc , .Nm useracc .Nd メモリ領域がアクセス可能か否かの調査 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In vm/vm.h +.In vm/vm_extern.h .Ft int .Fn kernacc "caddr_t addr" "int len" "int rw" .Ft int .Fn useracc "caddr_t addr" "int len" "int rw" .Sh 解説 .Fn kernacc および .Fn useracc 関数は、 .Fa addr および .Fa len によって与えられる仮想アドレス範囲で、 .Fa rw で指定された操作のタイプが許可されるかどうかを調査します。 .Fa rw の指定可能な値は、 .Dv VM_PROT_READ , .Dv VM_PROT_WRITE および .Dv VM_PROT_EXECUTE の論理合成値です。 .Fn kernacc はカーネルアドレス空間の中のアドレスを調べ、一方 .Fn useracc は .Fa addr をユーザ空間のアドレス表現とみなします。 この操作に使用されるプロセスコンテキストは大域変数 .Va curproc から得られます。 .Sh 戻り値 どちらの関数も、 .Fa rw によって指定されるタイプのアクセスが許可されている場合には、 ブール値 true を返します。 そうでない場合には、ブール値 false が返されます。 .Sh バグ .Fn useracc への引数として、プロセスへのポインタが渡されるべきです。 diff --git a/ja_JP.eucJP/man/man9/make_dev.9 b/ja_JP.eucJP/man/man9/make_dev.9 index ca1a946d95..d5d81f1f43 100644 --- a/ja_JP.eucJP/man/man9/make_dev.9 +++ b/ja_JP.eucJP/man/man9/make_dev.9 @@ -1,95 +1,95 @@ .\" Copyright (c) 1999 Chris Costello .\" 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/share/man/man9/make_dev.9,v 1.2.2.2 2001/07/24 09:49:39 dd Exp % +.\" %FreeBSD: src/share/man/man9/make_dev.9,v 1.2.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/make_dev.9,v 1.3 2001/07/23 02:27:01 horikawa Exp $ +.\" $FreeBSD$ .Dd September 25, 1999 .Os .Dt MAKE_DEV 9 .Sh 名称 .Nm make_dev , .Nm destroy_dev .Nd 新しいデバイスのための dev_t の作成と削除 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/conf.h .Ft dev_t .Fn make_dev "struct cdevsw *cdevsw" "int minor" "uid_t uid" "gid_t gid" "int perms" "char *fmt" ... .Ft void .Fn destroy_dev "dev_t dev" .Sh 解説 .Fn make_dev 関数は新しいデバイスのための .Fa dev_t 構造体を作成します。 そのデバイスは .Va uid によって所有され、 .Va gid のグループに所有され、 .Va name で指定される名前を持ちます。 .Va perms に指定するファイルのパーミッションは .Aq Pa sys/stat.h で定義されています。 .Pp .Bd -literal -offset indent -compact #define S_IRWXU 0000700 /* 所有者の RWX マスク #define S_IRUSR 0000400 /* 所有者の R */ #define S_IWUSR 0000200 /* 所有者の W */ #define S_IXUSR 0000100 /* 所有者の X */ #define S_IRWXG 0000070 /* グループの RWX マスク */ #define S_IRGRP 0000040 /* グループの R */ #define S_IWGRP 0000020 /* グループの W */ #define S_IXGRP 0000010 /* グループの X */ #define S_IRWXO 0000007 /* その他の RWX マスク */ #define S_IROTH 0000004 /* その他の R */ #define S_IWOTH 0000002 /* その他の W */ #define S_IXOTH 0000001 /* その他の X */ #define S_ISUID 0004000 /* 実行時にユーザ ID を設定 */ #define S_ISGID 0002000 /* 実行時にグループ ID を設定 */ #define S_ISVTX 0001000 /* スティッキービット */ #ifndef _POSIX_SOURCE #define S_ISTXT 0001000 #endif .Ed .Pp .Fn destroy_dev 関数は、 .Fn make_dev から返された .Fa dev_t をとり、そのデバイスの登録を削除します。 .Sh 歴史 .Fn make_dev および .Fn destroy_dev 関数は .Fx 4.0 で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man9/malloc.9 b/ja_JP.eucJP/man/man9/malloc.9 index fe9449eb26..fabdd2035b 100644 --- a/ja_JP.eucJP/man/man9/malloc.9 +++ b/ja_JP.eucJP/man/man9/malloc.9 @@ -1,246 +1,247 @@ .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Paul Kranenburg. .\" .\" 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 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. .\" .\" $NetBSD: malloc.9,v 1.3 1996/11/11 00:05:11 lukem Exp $ -.\" %FreeBSD: src/share/man/man9/malloc.9,v 1.13.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/malloc.9,v 1.13.2.5 2001/12/17 11:30:18 ru Exp % +,\" $FreeBSD$ .\" .Dd June 16, 1996 .Dt MALLOC 9 .Os .Sh 名称 .Nm malloc , .Nm MALLOC , .Nm free , .Nm FREE .Nd カーネルメモリマネージメントルーチン .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/malloc.h .Ft void * .Fn malloc "unsigned long size" "struct malloc_type *type" "int flags" .Fn MALLOC "space" "cast" "unsigned long size" "struct malloc_type *type" "int flags" .Ft void .Fn free "void *addr" "struct malloc_type *type" .Fn FREE "void *addr" "struct malloc_type *type" .Sh 解説 .Fn malloc 関数はカーネルアドレス空間の初期化されていないメモリを .Fa size で指定された大きさの 1 つのオブジェクトとして割り当てます。 .Fn free は .Fn malloc で先に割り当てられていた .Fa addr のアドレスのメモリを再使用するために開放します。 メモリは 0 にクリアされません。 マクロ版の .Fn MALLOC は機能的には .Bd -literal -offset indent (space) = (cast)malloc((u_long)(size), type, flags) .Ed .Pp と同等で、 マクロ版 .Fn FREE は .Bd -literal -offset indent free((addr), type) .Ed .Pp と同等です。 標準Cライブラリの同義関数 .Pq Xr malloc 3 とは異なり、カーネルバージョンは更に 2 つの引き数をとります。 引き数 .Fa flags は .Fn malloc の操作上の特性を以下のようにみなします。 .Bl -tag -width M_NOWAIT .It Dv M_NOWAIT リソースの不足のため直ちに要求を満たすことができない場合は、 .Fn malloc が .Dv NULL を返すようにします。 通常は、 .Fn malloc は他のプロセスによるリソースの開放を待つために .Fn sleep を呼び出すでしょう。 このフラグがセットされていれば、 .Fn malloc はブロックせずに .Dv NULL を返します。 .Dv M_WAITOK が 0 に定義されていることに注意してください。 これはブロッキング操作がデフォルトだということです。 .It Dv M_ASLEEP リソースの不足のため直ちに要求を満たすことができない場合は、 .Fn malloc が .Fn asleep を呼ぶようにします。 .Dv M_ASLEEP の単独での使用は実用的ではなく、常に .Dv M_NOWAIT との論理和(OR)をとって .Fn malloc に .Fn asleep を呼ばせ、直ちに .Dv NULL を返させます。 呼び出し側がある時点で .Fn await を呼び、割り当てのリトライをすることが期待されています。 当のルーチンに依存して、呼び出し側で一時的な失敗を上位に連鎖的に伝搬し、実際に .Fn malloc がキューに入れた非同期のウェイトをブロックする 幾つかの別の高レベルルーチンをもつことを決めることも出来ます。 .It Dv M_WAITOK リソースを待つことが可能(OK)であることを示します。 都合の悪いことに 0 と定義されているので、直接この値に対して比較したり、 フラグとして論理積(AND)をとったりしないように注意されなければなりません。 デフォルトの操作はメモリの割り当てが成功するまでブロックします。 .Dv M_NOWAIT が指定されると .Fn malloc は単に .Dv NULL を返すことが出来ます。 .It Dv M_USE_RESERVE 要求されたメモリを獲得するために、 システムがリザーブ領域を使ってよいことを示します。 このオプションは以前は M_KERNEL と呼ばれていましたが、 より明示的に改名されました。 このオプションは軽視されていて、カーネルから徐々に削除されています。 そのため、新たなプログラミングでは使用されない様にするべきです。 .El .Pp 引き数 .Fa type はメモリの利用方法の統計をとるためと、 簡単なサニティチェックのために使われています。 この統計は .Sq vmstat -m で調べることが出来ます。 .Pp .Fa type は .Fn MALLOC_DECLARE と .Fn MALLOC_DEFINE マクロを通じて .Va malloc_type_t typedef を使用して定義されます。 .Bd -literal -offset indent /* sys/something/foo_extern.h */ MALLOC_DECLARE(M_FOOBUF); /* sys/something/foo_main.c */ MALLOC_DEFINE(M_FOOBUF, "foobuffers", "Buffers to foo data into the ether"); /* sys/something/foo_subr.c */ \&... MALLOC(buf, struct foo_buf *, sizeof *buf, M_FOOBUF, M_NOWAIT); .Ed .Sh 戻り値 .Fn malloc はすべてのタイプのオブジェクトの格納に適切なように整列された カーネル仮想アドレスを、 または要求が満足できずかつ .Dv M_NOWAIT がセットされている場合に .Dv NULL を返します。 .Dv M_ASLEEP がセットされていて .Fn malloc が .Dv NULL を返す場合、副作用として .Fn asleep が呼び出されます。 .Sh 関連項目 .Xr vmstat 8 .Sh 診断 .Dv DIAGNOSTIC コンフィギュレーションオプションを付けてコンパイルされたカーネルは、 割り当てられた領域以外への書き込みや .Fn malloc 関数と .Fn free 関数の不均衡な呼び出しなどにより生じたメモリ不正の検出を試みます。 一貫性チェックの失敗はパニックまたはシステムコンソールメッセージを出力します。 .Bl -bullet -offset indent -compact .Pp .It panic: .Dq malloc: bogus type .It panic: .Dq malloc: allocation too large .It panic: .Dq malloc: wrong bucket .It panic: .Dq malloc: lost data .It panic: .Dq free: address 0x%x out of range .It panic: .Dq free: type %d out of range .It panic: .Dq free: unaligned addr Aq description of object .It panic: .Dq free: item modified .It panic: .Dq free: multiple free[s] .It .Dq Data modified on freelist: Aq description of object .El diff --git a/ja_JP.eucJP/man/man9/microtime.9 b/ja_JP.eucJP/man/man9/microtime.9 index bb4e346dca..b01aea7f11 100644 --- a/ja_JP.eucJP/man/man9/microtime.9 +++ b/ja_JP.eucJP/man/man9/microtime.9 @@ -1,110 +1,110 @@ .\" Copyright (c) 2000 Kelly Yancey .\" 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/share/man/man9/microtime.9,v 1.2.2.2 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/microtime.9,v 1.2.2.3 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/microtime.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd January 3, 2000 .Dt MICROTIME 9 .Os .Sh 名称 .Nm microtime , .Nm getmicrotime , .Nm nanotime , .Nm getnanotime .Nd 現在時刻の取得 .Sh 書式 -.Fd #include +.In sys/time.h .Ft void .Fn microtime "struct timeval *tv" .Ft void .Fn getmicrotime "struct timeval *tv" .Ft void .Fn nanotime "struct timespec *ts" .Ft void .Fn getnanotime "struct timespec *tsp" .Sh 解説 .Fn microtime および .Fn getmicrotime 関数は、 .Fa tv によって指定されたアドレスに、 .Ft timeval 構造体として、システム時刻を保存します。 .Fn nanotime および .Fn getnanotime 関数は、同じ作用を実行しますが、代りに .Ft timespec 構造体として時刻を記録します。 .Pp .Fn microtime および .Fn nanotime は、可能な限り正確な現在時刻を返す時刻カウンタを、常に請求します。 それに反して、 .Fn getmicrotime および .Fn getnanotime 関数は、正確ではないが高速に得られる時刻を代りに返し得る抽象化です。 この振舞いは、kern.timecounter.method sysctl 変数により、 切り替えることができます。 .Bl -tag -width ABC .It Dv 0 高速なコード実行を選択して、正確さを犠牲にします。 .It Dv 1 ( .Fn microtime または .Fn nanotime の呼び出しと同等の) より正確な時刻を返します。 .El .Pp .Fn getmicrotime および .Fn getnanotime 関数の意図は、タイマの正確さ対実行時間のユーザの好みを強化することです。 .Sh 関連項目 .Xr getmicrouptime 9 , .Xr getnanouptime 9 , .Xr microuptime 9 , .Xr nanouptime 9 , .Xr tvtohz 9 .Sh 診断 バグのあるハードウェアは kern.timecounter.method が 0 に設定されている時に、 "calcru negative..." を起こすことがあります。 .Sh 歴史 .Nm および .Nm nanotime 関数は .Fx 3.0 で初めて登場しましたが、別の形で .Bx 4.4 から存在していました。 .Sh 作者 このマニュアルページは .An Kelly Yancey Aq kbyanc@posi.net が書きました。 diff --git a/ja_JP.eucJP/man/man9/microuptime.9 b/ja_JP.eucJP/man/man9/microuptime.9 index 447ca2a2f9..53f6935667 100644 --- a/ja_JP.eucJP/man/man9/microuptime.9 +++ b/ja_JP.eucJP/man/man9/microuptime.9 @@ -1,101 +1,101 @@ .\" Copyright (c) 2000 Kelly Yancey .\" 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/share/man/man9/microuptime.9,v 1.2.2.1 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/microuptime.9,v 1.2.2.2 2001/12/17 11:30:18 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/microuptime.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd January 3, 2000 .Dt MICROUPTIME 9 .Os .Sh 名称 .Nm microuptime , .Nm getmicrouptime , .Nm nanouptime , .Nm getnanouptime .Nd 起動からの経過時間の取得 .Sh 書式 -.Fd #include +.In sys/time.h .Ft void .Fn microuptime "struct timeval *tv" .Ft void .Fn getmicrouptime "struct timeval *tv" .Ft void .Fn nanouptime "struct timespec *ts" .Ft void .Fn getnanouptime "struct timespec *tsp" .Sh 解説 .Fn microuptime および .Fn getmicrouptime 関数は、 .Fa tv によって指定されたアドレスに、 .Ft timeval 構造体として、起動からの経過時間を保存します。 .Fn nanouptime および .Fn getnanouptime 関数は、同じ作用を実行しますが、代りに .Ft timespec 構造体として経過時間を記録します。 .Pp .Fn microuptime および .Fn nanouptime は、常に可能な限り正確な現在時刻を返す時刻カウンタを請求します。 それに反して、 .Fn getmicrouptime および .Fn getnanouptime 関数は、正確ではないが高速に得られる時刻を代りに返し得る抽象化です。 この振舞いは、kern.timecounter.method sysctl 変数により、 切り替えることができます。 .Bl -tag -width ABC .It Dv 0 高速なコード実行を選択して、正確さを犠牲にします。 .It Dv 1 ( .Fn microuptime または .Fn nanouptime の呼び出しと同等の) より正確な時刻を返します。 .El .Pp .Fn getmicrouptime および .Fn getnanouptime 関数の意図は、タイマの正確さ対実行時間のユーザの好みを強化することです。 .Sh 関連項目 .Xr getmicrotime 9 , .Xr getnanotime 9 , .Xr microtime 9 , .Xr nanotime 9 , .Xr tvtohz 9 .Sh 診断 バグのあるハードウェアは kern.timecounter.method が 0 に設定されている時に、 "calcru negative..." を起こすことがあります。 .Sh 作者 このマニュアルページは .An Kelly Yancey Aq kbyanc@posi.net が書きました。 diff --git a/ja_JP.eucJP/man/man9/panic.9 b/ja_JP.eucJP/man/man9/panic.9 index a4b3093aad..b80bf58bb7 100644 --- a/ja_JP.eucJP/man/man9/panic.9 +++ b/ja_JP.eucJP/man/man9/panic.9 @@ -1,66 +1,67 @@ .\" %NetBSD: panic.9,v 1.2 1996/10/09 17:20:04 explorer Exp % .\" .\" Copyright (c) 1996 Michael Graff. .\" 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 Michael Graff .\" for the NetBSD Project. .\" 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/share/man/man9/panic.9,v 1.4.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/panic.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp % +.\" $FreeBSD$ .\" .Dd August 11, 1995 .Dt PANIC 9 .Os .Sh 名称 .Nm panic .Nd 致命的なエラーによるシステムダウン .Sh 書式 -.Fd #include +.In sys/param.h .Ft void .Fn panic "const char *fmt" ... .Sh 解説 .Fn panic 関数は動作中のシステムを終了させます。 .Fa fmt メッセージは .Xr printf 3 スタイルのフォーマット文字列です。 このメッセージはコンソールに出力され、 後でオペレーティングシステムのコアダンプから取り出すために .Fa panicstr がこのメッセージのアドレスに設定されます。 .Pp もしカーネルデバッガが搭載されていれば、デバッガに制御を渡します。 さもなければ、オペレーティングシステムのコアダンプを 設定されているダンプデバイスに保存するように試みます。 .Pp もし .Fn panic が 2 度呼ばれた場合(たとえばディスク同期ルーチンから)には、 ディスクの同期無しでシステムはリブートされます。 .Sh 戻り値 .Fn panic 関数は戻りません。 diff --git a/ja_JP.eucJP/man/man9/physio.9 b/ja_JP.eucJP/man/man9/physio.9 index 8448a0ce7a..345dcb576f 100644 --- a/ja_JP.eucJP/man/man9/physio.9 +++ b/ja_JP.eucJP/man/man9/physio.9 @@ -1,141 +1,142 @@ .\" %NetBSD: physio.9,v 1.2 1996/11/11 00:05:12 lukem Exp % .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Paul Kranenburg. .\" .\" 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 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/share/man/man9/physio.9,v 1.6.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/physio.9,v 1.6.2.4 2001/12/17 11:30:18 ru Exp % +.\" $FreeBSD$ .\" .Dd June 15, 1996 .Dt PHYSIO 9 .Os .Sh 名称 .Nm physio .Nd ロウデバイスの入出力の開始 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/param.h +.In sys/systm.h +.In sys/buf.h .Ft int .Fn physio "dev_t dev" "struct uio *uio" "int ioflag" .Sh 解説 .Fn physio は通常、 文字型デバイスの read および write ルーチンから呼び出されるヘルパー関数で、 ユーザープロセスのバッファへの入出力を開始させます。 この関数は .Fa uio 構造体に記述されている転送が完了するまで、与えられた .Fa strategy ルーチンを 1 回以上呼び出します。 .Fa strategy を呼び出すごとの最大のデータ転送量は .Fa minphys ルーチンによって決定されます。 .Fa uio 構造体は通常ユーザー空間のアドレスを示すので、 .Fn physio はプロセスをメモリ中にロックする必要があります。 これは、プロセスに .Dv P_PHYSIO フラグをセットすることで行ないます。 以前にエラー状態が検出された時を除いて、 .Fn physio は常にリターンする前に全ての要求された転送が完了するまで待ちます。 全ての場合に、 .Fa bp に渡されるバッファは転送が完了するまでの期間中、ロック( .Dq busy にマーク)されます。 .Pp 引数の詳細を下記に示します。 .Bl -tag -width "strategy" .It Fa strategy それぞれのデータのかたまりをデバイスに入出力開始させるために呼ばれる デバイスの strategy ルーチン。 .It Fa bp strategy ルーチンで使用されるバッファ。 このバッファのフラグは strategy に渡される時に .Dv B_BUSY および .Dv B_PHYS がセットされます。 もし bp が .Dv NULL であれば、システムのプールから割り当てられます。 .It Fa dev デバイスを識別するために関連付けられたデバイス番号。 .It Fa flags 転送方向。 有効な設定は .Dv B_READ または .Dv B_WRITE のみ。 .It Fa minphys デバイスの strategy ルーチンが取り扱う事ができる最大の転送サイズを 決定するために呼ばれる、デバイス固有のルーチン。 .It Fa uio ユーザープロセスから要求された転送全体の記述。 現在は、 .Fa uio 構造体の .Sq uio_segflg フラグに .Dv UIO_USERSPACE 以外の値をセットして渡した場合の結果は未定義です。 .El .Sh 戻り値 成功すれば .Fn physio は 0 を返します。 .Fa uio 構造体に示されているアドレス範囲が要求したプロセスから アクセスできない場合には .Er EFAULT を返します。 .Fn physio はデバイスの strategy ルーチンを呼んだ結果として発生する あらゆるエラーを .Dv B_ERROR バッファフラグおよび .Va b_error フィールドを調査して返します。 デバイスが .Dq end of file の状態を示している時には、実際の転送サイズは .Fa uio 構造体で要求しているサイズよりも小さくなる事に注意してください。 .Sh 関連項目 .Xr read 2 , .Xr write 2 diff --git a/ja_JP.eucJP/man/man9/resettodr.9 b/ja_JP.eucJP/man/man9/resettodr.9 index 55014a01cd..280da3f4f8 100644 --- a/ja_JP.eucJP/man/man9/resettodr.9 +++ b/ja_JP.eucJP/man/man9/resettodr.9 @@ -1,59 +1,60 @@ .\" %NetBSD: resettodr.9,v 1.1 1995/11/25 21:24:51 perry 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 .\" for the NetBSD Project. .\" 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/share/man/man9/resettodr.9,v 1.4.2.1 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/resettodr.9,v 1.4.2.2 2001/12/17 11:30:18 ru Exp % +.\" $FreeBSD$ .\" .Dd November 13, 1995 .Dt RESETTODR 9 .Os .Sh 名称 .Nm resettodr .Nd バッテリーバックアップの時計をシステムの時間に合わせる .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft void .Fn resettodr "void" .Sh 解説 .Fn resettodr 関数はシステムのバッテリーバックアップの時計をシステムが保有している .Va time 変数の時間に合わせます。 .Sh 関連項目 .Xr inittodr 9 , .Xr time 9 .Sh バグ 多くのシステムで .Fn resettodr は内部表現の .Va time から年、月、日、時、分、秒で表現される時刻に変換しなければなりません。 多くのインプリメンテーションではコードの共有が可能ですが、共有していません。 diff --git a/ja_JP.eucJP/man/man9/spl.9 b/ja_JP.eucJP/man/man9/spl.9 index f2c122443e..b22ddf9267 100644 --- a/ja_JP.eucJP/man/man9/spl.9 +++ b/ja_JP.eucJP/man/man9/spl.9 @@ -1,198 +1,199 @@ .\" .\" Copyright (c) 1996 Joerg Wunsch .\" .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %FreeBSD: src/share/man/man9/spl.9,v 1.8.2.4 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/spl.9,v 1.8.2.5 2001/12/17 11:30:19 ru Exp % +.\" $FreeBSD$ .\" .Dd July 21, 1996 .Os .Dt SPL 9 .Sh 名称 .Nm splbio , .Nm splclock , .Nm splhigh , .Nm splimp , .Nm splnet , .Nm splsoftclock , .Nm splsofttty , .Nm splstatclock , .Nm spltty , .Nm splvm , .Nm spl0 , .Nm splx .Nd 割り込み優先度の操作 .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/systm.h .Ft intrmask_t .Fn splbio "void" .Ft intrmask_t .Fn splclock "void" .Ft intrmask_t .Fn splhigh "void" .Ft intrmask_t .Fn splimp "void" .Ft intrmask_t .Fn splnet "void" .Ft intrmask_t .Fn splsoftclock "void" .Ft intrmask_t .Fn splsofttty "void" .Ft intrmask_t .Fn splstatclock "void" .Ft intrmask_t .Fn spltty "void" .Ft void .Fn spl0 "void" .Ft void .Fn splx "intrmask_t ipl" .Sh 解説 .Fn spl 関数ファミリは CPU の割り込み優先度の .Dq レベル を設定します。 これはブロックされた優先度レベルの割り込みハンドラの実行を抑制します。 割り込みハンドラによって調査あるいは修正されたであろうデータ領域を 調査あるいは修正するドライバの .Dq synchronous 部分(ユーザープロセスを代表して実行される部分)で使用されます。 .Pp 通常それぞれの割り込みを使用するドライバは、 config ファイルのキーワードによって 1 つの 割り込み優先度グループに割り当てられます。 例えば、 .Bd -literal -offset indent device foo0 at isa? port 0x0815 irq 12 tty .Ed .Pp は、割り込み 12 を .Dq tty 優先度グループに割り当てます。 システムは自動的に .Em xxx グループの割り込みを優先度が .Ns spl Ns Em xxx \&() 以上の時に呼ばれるように準備します。 .Pp .Fn splx 関数は割り込み優先度レベルを絶対的な数値に設定します。 これは別の割り込みレベル関数が返した値をローカルの変数に保存して、 後で元の優先度レベルに戻すために .Fn splx を使用する事を意図しています。 .Pp .Fn spl0 関数は全ての割り込みハンドラをブロックしない値に優先度を減少させます。 ただし、AST(非同期システムトラップ)はシステムが ユーザーモードに戻るまでの間はブロックされます。 .Pp いろいろなデバイスドライバの割り込み優先度グループの伝統的な割り当ては、 おおよそ次のように分類できます。 .Bl -tag -width Fn .It Fn splnet 全てのネットワークインターフェイスドライバ。 .It Fn splbio 全ての .Em バッファ入出力 (つまりディスクなど)のドライバ。 .It Fn spltty 基本的にはネットワーク以外の通信デバイスですが、 事実上はネットワークとディスク以外の全てのドライバ。 .El .Sh 戻り値 .Fn splx および .Fn spl0 以外の全ての関数は、操作前の優先度の値を返します。 .Sh 使用例 以下は、標準的な使用例です。 .Bd -literal struct foo_softc { ... int flags; #define FOO_ASLEEP 1 #define FOO_READY 2 } foo_softc[NFOO]; int foowrite(...) { struct foo_softc *sc; int s, error; ... s = spltty(); if (!(sc->flags & FOO_READY)) { /* 準備ができていません、待機しなければなりません */ sc->flags |= FOO_ASLEEP; error = tsleep(sc, PZERO, "foordy", 0); sc->flags &= ~FOO_ASLEEP; } sc->flags &= ~FOO_READY; splx(s); ... } void foointr(...) { struct foo_softc *sc; ... sc->flags |= FOO_READY; if (sc->flags & FOO_ASLEEP) /* 誰かが我々を待っています、起こしてください */ wakeup(sc); ... } .Ed 割り込みハンドラは .Em 絶対に 優先度レベルを減少させるべきではない、ということに注意してください。 自動的に、自分のレベルの割り込み優先度に増加させられます。 すなわち、同じグループの全ての割り込みはブロックされます。 .Sh 歴史 割り込み優先度レベルは早期のバージョンの Unix で登場しました。 伝統的には名前ではなく数字が使われていて、そのレベルまでの全てを含んで (優先度 5 はレベル 5 までの全てをブロックします)いた事が知られています。 これは .Fx にはあてはまりません。 伝統的な名前 .Ql level はいまだに文字 .Ql l としてそれぞれの関数や変数の名前に反映されています。 しかし、実際にはもはやレベルではなく、 むしろ異なった(部分的に含まれた)関数群がシステムのある期間ブロックされます。 歴史的な番号による方法は単純で順番通りの 割り込み優先度レベルグループであるとみなす事ができます。 .Sh 作者 このマニュアルページは .An J\(:org Wunsch が書きました。 diff --git a/ja_JP.eucJP/man/man9/store.9 b/ja_JP.eucJP/man/man9/store.9 index 25d566dec9..2bf0988e9d 100644 --- a/ja_JP.eucJP/man/man9/store.9 +++ b/ja_JP.eucJP/man/man9/store.9 @@ -1,90 +1,91 @@ .\" %NetBSD: store.9,v 1.2 1996/01/09 21:59:27 perry Exp % .\" .\" Copyright (c) 1996 Jason R. Thorpe. .\" All rights reserved. .\" .\" This code is derived from software contributed by Kenneth Stailey. .\" .\" 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 for the NetBSD Project .\" by Jason R. Thorpe. .\" 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/share/man/man9/store.9,v 1.7.2.3 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/store.9,v 1.7.2.4 2001/12/17 11:30:19 ru Exp % +.\" $FreeBSD$ .\" .Dd January 7, 1996 .Dt STORE 9 .Os .Sh 名称 .Nm store , .Nm subyte , .Nm susword , .Nm suswintr , .Nm suword .Nd ユーザー空間へのデータの格納 .Sh 書式 -.Fd #include -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In sys/time.h +.In sys/systm.h +.In sys/resourcevar.h .Ft int .Fn subyte "void *base" "int byte" .Ft int .Fn susword "void *base" "int word" .Ft int .Fn suswintr "void *base" "int word" .Ft int .Fn suword "void *base" "int word" .Sh 解説 .Nm 関数群はユーザー空間へ小さなデータをコピーするようにデザインされています。 .Pp .Nm ルーチンは以下の機能を提供します。 .Bl -tag -width "suswintr()" .It Fn subyte 1 バイトのデータをユーザー空間のアドレス .Pa base へ格納します。 .It Fn susword 1 ショートワードのデータをユーザー空間のアドレス .Pa base へ格納します。 .It Fn suswintr 1 ショートワードのデータをユーザー空間のアドレス .Pa base へ格納します。 この関数は割り込みコンテキスト中でも安全に呼び出せます。 .It Fn suword 1 ワードのデータをユーザー空間のアドレス .Pa base へ格納します。 .El .Sh 戻り値 .Nm 関数は 0 を返しますが、失敗した場合は -1 を返します。 .Sh 関連項目 .Xr copy 9 , .Xr fetch 9 diff --git a/ja_JP.eucJP/man/man9/style.9 b/ja_JP.eucJP/man/man9/style.9 index 7008fcc31e..f413850a63 100644 --- a/ja_JP.eucJP/man/man9/style.9 +++ b/ja_JP.eucJP/man/man9/style.9 @@ -1,614 +1,692 @@ -.\" Copyright (c) 1995 FreeBSD Inc. +.\" Copyright (c) 1995-2001 FreeBSD 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. .\" .\" 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 [your name] 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/share/man/man9/style.9,v 1.32.2.15 2001/11/26 17:48:15 obrien Exp % .\" $FreeBSD$ .\" -.Dd December 14, 1995 +.Dd December 7, 2001 .Dt STYLE 9 .Os .Sh 名称 .Nm style .Nd カーネルソースファイルのスタイルガイド .Sh 解説 このファイルは .Fx ソースツリーのカーネルソースに好ましいスタイルを明記しています。 これはユーザランドのコードスタイルの手引きでもあります。 .\" $ と FreeBSD を続けるとキーワード置換されるので、\& を挿入 .\" 2001/05/23 horikawa@jp.FreeBSD.org .Bd -literal /* * FreeBSD のためのスタイルガイドです。 * CSRG の KNF (Kernel Normal Form, カーネル標準書式) に基づいています。 * * @(#)style 1.14 (Berkeley) 4/28/95 - * $\&FreeBSD: src/share/man/man9/style.9,v 1.32.2.15 2001/11/26 17:48:15 obrien Exp $ + * $\&FreeBSD: src/share/man/man9/style.9,v 1.32.2.16 2001/12/17 11:30:19 ru Exp $ */ /* * とても重要な 1 行のコメントはこのようにします。 */ /* 殆どの 1 行のコメントはこのようにします。 */ /* * 複数行にわたるコメントはこのようにします。実際の文章を書きます。実際の * 段落に見えるように埋めていきます。 */ .Ed .Pp 著作権ヘッダの後には空行を 1 行入れ、ソースファイルには .Va rcsid を付けます。 バージョン管理システムの ID タグは、ファイル中に 1 個のみあるべきです (このファイルでは違いますが)。 C/C++ ソースファイル以外はこの例に従いますが、 C/C++ ソースファイルは以降の例に従います。 外部から入手したファイルの すべての VCS (バージョン管理システム) リビジョン識別子は、 存在すれば維持します。 これには、ファイルの来歴を示す複数の ID も含みます。 -一般的に、`$' も含めて、ID はそのままとします。 -外部からの VCS ID の前に "From" を付ける理由はありません。 +一般的に、 +.So Li $ Sc +も含めて、ID はそのままとします。 +外部からの VCS ID の前に +.Qq Li "From" +を付ける理由はありません。 ほとんどの非 .Fx の VCS ID は、 コメント中ではタブでインデントされているでしょう。 .Bd -literal #include __RCSID("@(#)style 1.14 (Berkeley) 4/28/95"); -__FBSDID("$\&FreeBSD: src/share/man/man9/style.9,v 1.32.2.15 2001/11/26 17:48:15 obrien Exp $"); +__FBSDID("$\&FreeBSD: src/share/man/man9/style.9,v 1.32.2.16 2001/12/17 11:30:19 ru Exp $"); .Ed .Pp ヘッダファイルの前に、空行を 1 行付けます。 .Pp -カーネルのインクルードファイル (すなわち、sys/*.h) が初めに来ます。 -通常、 または のどちらかが必要ですが、 +カーネルのインクルードファイル (すなわち、 +.Pa sys/*.h +) が初めに来ます。 +通常、 +.Aq Pa sys/types.h +または +.Aq Pa sys/param.h +のどちらかが必要ですが、 両方は必要ないでしょう。 - は をインクルードしており、 +.Aq Pa sys/types.h +は +.Aq Pa sys/cdefs.h +をインクルードしており、 依存関係は問題ありません。 .Bd -literal #include /* 山括弧による非ローカルインクルード */ .Ed .Pp ネットワークプログラムである場合は、 次にネットワークインクルードファイルを置きます。 .Bd -literal #include #include #include #include #include .Ed .Pp -それから空行を置き、/usr インクルードファイルを続けます。 -/usr インクルードファイルはアルファベット順にソートされているべきです。 +それから空行を置き、 +.Pa /usr +インクルードファイルを続けます。 +.Pa /usr +インクルードファイルはアルファベット順にソートされているべきです。 .Bd -literal #include .Ed .Pp -グローバルなパス名は /usr/include/paths.h で定義されています。 -プログラムにローカルなパス名はローカルディレクトリの pathnames.h に入れます。 +グローバルなパス名は +.Pa /usr/include/paths.h +で定義されています。 +プログラムにローカルなパス名はローカルディレクトリの +.Qq Pa pathnames.h +に入れます。 .Bd -literal #include .Ed .Pp それから、空行があって、ユーザインクルードファイルが来ます。 .Bd -literal #include "pathnames.h" /* " " によるローカルインクルード */ .Ed .Pp アプリケーションインタフェースを実装している場合を除き、 -実装の名前空間で #define したり名前を定義したりしてはいけません。 +実装の名前空間で +.Ic #define +したり名前を定義したりしてはいけません。 .Pp .Dq Li 安全でない マクロ (副作用を持っているもの) の名前と、 明らかな定数のマクロの名前はすべて大文字です。 式のように展開されるマクロは、単一のトークンにするか外側に括弧をつけます。 -.Ql #define +.Ic #define とマクロ名の間にタブ文字を 1 個入れます。 マクロがある関数のインライン展開である場合は、 関数名は全て小文字で、マクロはすべて大文字の同じ名前を持ちます。 .\" XXX 上記は名前が同じマクロを #undef すれば関数を使える .\" という ANSI のスタイルと衝突します。 .\" これは MALLOC() については言えないし、インライン関数を使う時の .\" 一般的なやりかたではありません。 マクロが 1 行以上必要な場合は、ブレース -.Sq ( \&{ +.Ql ( \&{ と -.Sq \&} ) +.Ql \&} ) を使用します。 バックスラッシュは右揃えします。こうすると読みやすくなります。 マクロが複合文をカプセル化する場合には、それを -.Dq Li do +.Ic do ループで囲みます。 これにより、 -.Dq Li if +.Ic if 文で安全に使用できます。 最後の文の終端のセミコロンは、 マクロではなくマクロの実施時に付けられるべきです。 これにより、清書器やエディタで文法解析しやすくなります。 .Bd -literal #define MACRO(x, y) do { \e variable = (x) + (y); \e (y) += 2; \e } while(0) .Ed .Pp 列挙値は全て大文字を使用します。 .Bd -literal enum enumtype { ONE, TWO } et; .Ed .Pp 構造体の中で変数を宣言する時には、 使用順、サイズ順、アルファベット順にソートして宣言します。 最初の区分は通常適用しませんが、例外があります。 各宣言は、それぞれ独立した行にて行います。 構造体の名前の位置を、あなたの判断で読み易いように、 タブ 1 個または 2 個を使用して揃えてください。 ほとんどのメンバを揃えるのに十分であれば、単一のタブを使用すべきです。 非常に長い型の後の名前は、単一の空白で区切られるべきです。 .Pp 重要な構造体は、それが使用されるファイルの先頭で宣言されるか、 複数のソースファイルで使用される場合は別のヘッダファイルで宣言されるべきです。 構造体がヘッダファイルで宣言されている場合には、 -それら構造体の使用は、宣言とは分けられるべきで、かつ "extern" であるべきです。 +それら構造体の使用は、宣言とは分けられるべきで、かつ +.Ic "extern +であるべきです。 .Bd -literal struct foo { struct foo *next; /* 使用中の foo のリスト */ struct mumble amumble; /* mumble のコメント */ int bar; /* コメントを揃えようとしています */ struct verylongtypename *baz; /* タブ 2 個には収まりません */ }; struct foo *foohead; /* グローバルな foo リストの先頭 */ .Ed .Pp 可能な時には必ず、あなた自身でリストを操作するのではなく、 .Xr queue 3 マクロを使用してください。 従って、前の例をより良く書くと次のようになります。 .Bd -literal #include struct foo { LIST_ENTRY(foo) link; /* foo リストにキューマクロを使用 */ struct mumble amumble; /* mumble のコメント */ int bar; /* コメントを揃えようとしています */ struct verylongtypename *baz; /* タブ 2 個には収まりません */ }; LIST_HEAD(, foo) foohead; /* グローバルな foo リストの先頭 */ .Ed .Pp 構造体の型に typedef を使用する事は避けてください。 使用してしまうと、 構造体へのポインタを不透明 (opaque) に使用することが、 アプリケーションにとって不可能となります。 通常の struct タグを使用すると、これが可能となり、かつ有益です。 -規約が typedef を要求する場合には、その名前を構造体タグに一致させます。 -標準 C または -.Tn POSIX +規約が +.Ic typedef +を要求する場合には、その名前を構造体タグに一致させます。 +標準 C または \*[Px] によって明示されたものを除いては、 -.Dq Li \&_t +.Dq Li _t で終る typedef を避けてください。 .Bd -literal /* 構造体名と typedef を一致させます */ typedef struct bar { int level; } BAR; .Ed .Pp 全ての関数はどこかでプロトタイプされます。 .Pp 私的な関数 (すなわち、他のどこでも使用されない関数など) の関数プロトタイプは、 最初のソースモジュールの先頭に置かれます。 単一のソースモジュールにローカルな関数は、 -.Ql static +.Ic static で宣言されるべきです。 .Pp カーネルの別の部分から使用される関数は、 関連のあるインクルードファイルの中でプロトタイプされます。 .Pp 複数のモジュールでローカルに使用される関数は、 -.Pa extern.h +.Qq Pa extern.h 等の分離したヘッダファイルの中に置かれます。 .Pp 一般にソースファイルが K&R 旧約聖書コンパイラで コンパイル可能である (べき) 時にのみ、 -インクルードファイル の __P マクロを使用します。 -新しいコードでの __P マクロの使用は反対されていますが、 +インクルードファイル +.Aq Pa sys/cdefs.h +の +.Dv __P +マクロを使用します。 +新しいコードでの +.Dv __P +マクロの使用は反対されていますが、 既存のファイルに対する修正はそのファイルの規約と首尾一貫しているべきです。 .Pp ファイルの 50% かそれ以上を巻き込んだ修正の場合は、 一般にコードは .Dq 新しいコード とみなすことができます。 これは既存のコードの慣例を破り、 -現在のスタイルガイドラインを使用するのに十分です。 +現在の +.Nm +ガイドラインを使用するのに十分です。 .Pp カーネルはパラメータの型に関連付けられた名前を持ちます。 例えば、カーネル内でこのように使用します。 .Bd -literal void function(int fd); .Ed .Pp ユーザランドのアプリケーションに対して見えるヘッダファイルの中では、 可視のプロトタイプは、 型を伴った .Dq 保護された (アンダスコアで開始する) 名前を使用するか、 型だけで名前を使用しないかのどちらかが必要です。 保護された名前の使用がより望ましいです。 例えば、このように使用します。 .Bd -literal void function(int); .Ed .Pp または .Bd -literal void function(int _fd); .Ed .Pp プロトタイプは関数名の行揃えを行なうために、タブの後に追加のスペース文字を 置いても構いません。 .Bd -literal static char *function(int _arg, const char *_arg2, struct foo *_arg3, struct bar *_arg4); static void usage(void); /* * 全ての主要なルーチンはそれが何をするのかを簡潔に記述した * コメントを持つべきです。"main" ルーチンの前のコメントは * そのプログラムが何をするのかを記述するべきです。 */ int main(int argc, char *argv[]) { long num; int ch; char *ep; .Ed .Pp -一貫性のために、オプションの解析には getopt が使用されるべきです。 -getopt 呼び出しと switch 文では、オプションをソートすべきですが、 -switch 文のカスケードの一部の場合は例外です。 -switch 文のカスケード要素は FALLTHROUGH コメントを持つべきです。 +一貫性のために、オプションの解析には +.Xr getopt 3 +が使用されるべきです。 +.Xr getopt 3 +呼び出しと +.Ic switch +文では、オプションをソートすべきですが、 +.Ic switch +文のカスケードの一部の場合は例外です。 +.Ic switch +文のカスケード要素は +.Li FALLTHROUGH +コメントを持つべきです。 数値の引数は精度をチェックされるべきです。 -到達できないコードは NOTREACHED コメントを持つべきです。 +到達できないコードは +.Li NOTREACHED +コメントを持つべきです。 .Bd -literal while ((ch = getopt(argc, argv, "abn:")) != -1) switch (ch) { /* switch をインデント */ case 'a': /* case はインデントしない */ aflag = 1; /* FALLTHROUGH */ case 'b': bflag = 1; break; case 'n': num = strtol(optarg, &ep, 10); if (num <= 0 || *ep != '\e0') { warnx("illegal number, -n argument -- %s", optarg); usage(); } break; case '?': default: usage(); /* NOTREACHED */ } argc -= optind; argv += optind; .Ed .Pp -予約語 (if, while, for, return, switch) の後にスペースを入れます。 +予約語 +.Pq Ic if , while , for , return , switch +の後にスペースを入れます。 何も伴わないかただ 1 つの文を伴う制御文は、ブレースを使用しません。 1 つの文が 複数行である文の場合には、これは許されます。 -無限ループは while ではなく for で行ないます。 +無限ループは +.Ic while +ではなく +.Ic for +で行ないます。 .Bd -literal for (p = buf; *p != '\e0'; ++p) ; /* 何もなし */ for (;;) stmt; for (;;) { z = a + really + long + statement + that + needs + two lines + gets + indented + four + spaces + on + the + second + and + subsequent + lines; } for (;;) { if (cond) stmt; } if (val != NULL) val = realloc(val, newsize); .Ed .Pp -for ループの各部は空のまま残しても構いません。 +.Ic for +ループの各部は空のまま残しても構いません。 異常に複雑なルーチンでない限りは、ブロックの中に宣言を置いてはなりません。 .Bd -literal for (; cnt < 15; cnt++) { stmt1; stmt2; } .Ed .Pp インデントは 8 文字のタブです。 第 2 レベルのインデントは 4 文字のスペースです。 長い分を折り返す必要がある場合、オペレータを行末に置きます。 .Bd -literal while (cnt < 20 && this_variable_name_is_too_long_for_its_own_good && ep != NULL) z = a + really + long + statement + that + needs + two lines + gets + indented + four + spaces + on + the + second + and + subsequent + lines; .Ed .Pp 空白文字を行末に追加してはいけません。 また、インデントを形成するためには、タブとその後にスペースのみを使用します。 タブが生み出す以上のスペースや、タブの前のスペースは使用しません。 .Pp -ブレースの終了と開始は else と同じ行に置かれます。 +ブレースの終了と開始は +.Ic else +と同じ行に置かれます。 必要でないブレースは省いても構いません。 .Bd -literal if (test) stmt; else if (bar) { stmt; stmt; } else stmt; .Ed .Pp 関数名の後はスペースを空けません。 コンマの後にはスペースを持ちます。 -.Sq \&( +.Ql \&( または -.Sq \&[ +.Ql \&[ の後ろまたは -.Sq \&] +.Ql \&] または -.Sq \&) +.Ql \&) の前にはスペースを空けません。 .Bd -literal error = function(a1, a2); if (error != 0) exit(error); .Ed .Pp 単項演算子はスペースを要求しませんが、二項演算子は要求します。 優先順位が要求する場合または文が括弧なしでは混乱する場合以外は、 括弧は使用しません。 他人はあなたよりも混乱しやすいかもしれないということを覚えておいてください。 あなたは以下を理解できますか? .Bd -literal a = b->c[0] + ~d == (e || f) || g && h ? i : j >> 1; k = !(l & FLAGS); .Ed .Pp 成功時には 0 で、または .Xr sysexits 3 にあらかじめ定義してある値で exit するべきです。 .Bd -literal exit(EX_OK); /* * "Exit 0 on success." (成功時は 0 で終了) * の様に明白なコメントは避けてください */ } .Ed .Pp 関数の型は、関数自身に先行する行にあるべきです。 .Bd -literal static char * function(int a1, int a2, float fl, int a4) { .Ed .Pp 関数の中で変数を宣言する時には、サイズ順に、次にアルファベット順に ソートして宣言します。 1 行に複数の宣言は可能です。 行が溢れる場合は、型の予約語を再度使用します。 .Pp 宣言時に変数を初期化することによってコードを 不明瞭にしない様に注意してください。 この機能は良く考えて使用してください。 初期化に関数呼び出しを使用しないでください。 .Bd -literal struct foo one, *two; double three; int *four, five; char *six, seven, eight, nine, ten, eleven, twelve; four = myfunction(); .Ed .Pp 他の関数の内部で関数を宣言しないでください。 ANSI C によると、このような宣言は、宣言のネスティングによらず、 ファイルスコープになります。 ローカルスコープに見えるものの中にファイルの宣言を隠すことは好ましくなく、 良いコンパイラは苦情を言います。 .Pp -キャストと sizeof 演算子の後にはスペースを続けません。 +キャストと +.Ic sizeof +演算子の後にはスペースを続けません。 この規則は .Xr indent 1 が理解しないことに注意してください。 .Pp -NULL は、好まれるヌルポインタ定数です。 +.Dv NULL +は、好まれるヌルポインタ定数です。 コンパイラが型を知っている文脈、例えば代入では、 -(type *)0 または (type *)NULL の代わりに、NULL を使用します。 +.Vt ( "type *" ) Ns 0 +または +.Vt ( "type *" ) Ns Dv NULL +の代わりに、 +.Dv NULL +を使用します。 他の文脈では、特に全ての関数の引数では、 -(type *)NULL を使用します。 +.Vt ( "type *" ) Ns Dv NULL +を使用します。 (関数のプロトタイプがスコープ外かもしれない場合に、 キャストはいろいろな引数にとって必須で、その他の引数にとっても必要です。) -ポインタは NULL と比較します。例えば、 +ポインタは +.Dv NULL +と比較します。例えば、 .Bd -literal !(p = f()) .Ed .Pp ではなく、このように使います。 .Bd -literal (p = f()) == NULL .Ed .Pp -真理値ではない場合、テストには '!' を使用しないでください。 +真理値ではない場合、テストには +.Ic \&! +を使用しないでください。 例えば、下記のように使います。 .Bd -literal if (*p == '\e0') .Ed .Pp 下記のようには使いません。 .Bd -literal if (!*p) .Ed .Pp -void * を返すルーチンでは、 +.Vt "void *" +を返すルーチンでは、 戻り値をどのポインタ型にもキャストしてはなりません。 .Pp .Xr err 3 または .Xr warn 3 を使用し、勝手に作らないでください。 .Bd -literal if ((four = malloc(sizeof(struct foo))) == NULL) err(1, (char *)NULL); if ((six = (int *)overflow()) == NULL) errx(1, "number overflowed"); return (eight); } .Ed .Pp 古いスタイルの関数宣言はこのようになっています。 .Bd -literal static char * function(a1, a2, fl, a4) int a1, a2; /* int 型も宣言します、デフォルトにしないこと */ float fl; /* double と float の違いに気を付けてください */ int a4; /* 出てきた順に宣言します */ { .Ed .Pp あなたが明確に K&R との互換性を必要とする場合以外は、 ANSI の関数宣言を使用してください。 長いパラメータリストの折り返しには、 4 個の空白による通常のインデントを付けます。 .Pp 可変個数の引数はこのようにします。 .Bd -literal #include void vaf(const char *fmt, ...) { va_list ap; va_start(ap, fmt); STUFF; va_end(ap); /* void 型の関数に return は不要です */ } static void usage() { /* 関数がローカル変数を持たない場合、空行をいれます */ .Ed .Pp -fputs/puts/putchar 等ではなく、 +.Xr fputs 3 , +.Xr puts 3 , +.Xr putchar 3 +等ではなく、 .Xr printf 3 を使用してください。 これは速くて大抵はきれいで、言うまでもなくつまらないバグを避けます。 .Pp -使用法 (usage) の文はマニュアルページの書式の様であるべきです。 +使用法 (usage) の文はマニュアルページの +.Sx SYNOPSIS +(書式) の様であるべきです。 使用法の文は、次の構造であるべきです: -.Pp .Bl -enum .It オペランドの無いオプションが、最初にアルファベット順に、 1 組の大括弧 -.Sq ( \&[ +.Ql ( \&[ と -.Sq \&] ) +.Ql \&] ) でくくられます。 .It オプションとそのオペランドがこれもアルファベット順に続き、 それぞれのオプションとその引数を 1 組の大括弧でくくります。 .It 必須の引数 (もしあれば) が続き、 コマンドラインで指定されるべき順で一覧されます。 .It 最後に、 すべての任意の引数が指定されるべき順で、 すべて大括弧の中に一覧されます。 .El .Pp 縦棒 -.Pq Sq \&| -は、二者択一のオプションまたは引数を分割し、 +.Pq Ql \&| +は、 +.Dq 二者択一 +のオプションまたは引数を分割し、 同時に使用するオプションと引数は、単一の大括弧でくくります。 -.Pp -.Bd -ragged -offset 4n +.Bd -literal -offset 4n "usage: f [-aDde] [-b b_arg] [-m m_arg] req1 req2 [opt1 [opt2]]\en" "usage: f [-a | -b] [-c [-dEe] [-n number]]\en" .Ed .Bd -literal (void)fprintf(stderr, "usage: f [-ab]\en"); exit(EX_USAGE); } .Ed .Pp マニュアルページのオプション記述は、 純粋なアルファベット順であるべきであることに注意してください。 つまり、オプションが引数を取るか否かに関わらないということです。 アルファベット順は、前述の大文字小文字の順序を考慮に入れるべきです。 .Pp -新しい中心的なカーネルのコードは、適度にスタイルガイドに従うべきです。 +新しい中心的なカーネルのコードは、適度に +.Nm +ガイドに従うべきです。 サードパーティが保守するモジュールやデバイスドライバのためのガイドラインは より緩やかですが、最低限内部的には彼らの一貫したスタイルであるべきです。 .Pp ソースリポジトリの文体の変更 (空白文字の変更を含む) は困難で、 正当な理由なしには避けるべきです。 リポジトリの中のおおよそ KNF -.Xr style 9 +.Nm に適合しているコードは、この適合から離れてはなりません。 .Pp 可能な時にはいつでも、 コードはコードチェッカ (例えば、 .Xr lint 1 -または "gcc -Wall") を +または +.Nm gcc Fl Wall +) を 通過し、発生する警告は最小限となるべきです。 .Sh 関連項目 .Xr indent 1 , .Xr lint 1 , .Xr err 3 , .Xr sysexits 3 , .Xr warn 3 .Sh 歴史 このページは .Bx 4.4 Lite2 -リリースの src/admin/style/style ファイルに大きく基づいていて、 +リリースの +.Pa src/admin/style/style +ファイルに大きく基づいていて、 現在の実装と .Fx プロジェクトの要望を反映して、頻繁に更新しています。 diff --git a/ja_JP.eucJP/man/man9/tvtohz.9 b/ja_JP.eucJP/man/man9/tvtohz.9 index 5b2be161f2..630f91bc3b 100644 --- a/ja_JP.eucJP/man/man9/tvtohz.9 +++ b/ja_JP.eucJP/man/man9/tvtohz.9 @@ -1,60 +1,60 @@ .\" Copyright (c) 2000 Kelly Yancey .\" 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/share/man/man9/tvtohz.9,v 1.1.4.1 2001/08/17 13:08:54 ru Exp % +.\" %FreeBSD: src/share/man/man9/tvtohz.9,v 1.1.4.2 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/tvtohz.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd January 3, 2000 .Dt TVTOHZ 9 .Os .Sh 名称 .Nm tvtohz .Nd 時間間隔からティック数への変換 .Sh 書式 -.Fd #include +.In sys/time.h .Ft int .Fn tvtohz "struct timeval *tv" .Sh 解説 .Fn tvtohz 関数は、時間間隔を示す単一引数 .Fa tv を受け付けます。 この時間間隔中に、システムティックが何個経過するかを計算します。 .Sh 戻り値 指定された時間間隔中に経過すると予測されるシステムティック数を、 整数で返します。 この数には、現在のティックも含まれます。 .Sh 関連項目 .Xr microtime 9 , .Xr microuptime 9 , .Xr timeout 9 .Sh 歴史 .Nm 関数は、 .Fx 3.0 で初めて登場しました。 .Sh 作者 このマニュアルページは .An Kelly Yancey Aq kbyanc@posi.net が書きました。 diff --git a/ja_JP.eucJP/man/man9/uio.9 b/ja_JP.eucJP/man/man9/uio.9 index fa3d367000..989ad2a34d 100644 --- a/ja_JP.eucJP/man/man9/uio.9 +++ b/ja_JP.eucJP/man/man9/uio.9 @@ -1,177 +1,180 @@ .\" .\" Copyright (c) 1997 Joerg Wunsch .\" .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" %FreeBSD: src/share/man/man9/uio.9,v 1.5.2.3 2001/07/21 09:16:58 schweikh Exp % +.\" %FreeBSD: src/share/man/man9/uio.9,v 1.5.2.4 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/uio.9,v 1.5 2001/05/26 02:41:06 horikawa Exp $ -.\" " +.\" +.\" $FreeBSD$ .Dd February 2, 1997 .Os .Dt UIO 9 .Sh 名称 .Nm uio , .Nm uiomove .Nd デバイスドライバ入出力ルーチン .Sh 書式 -.Fd #include -.Fd #include +.In sys/types.h +.In sys/uio.h .Pp .Bd -literal struct uio { struct iovec *uio_iov; int uio_iovcnt; off_t uio_offset; int uio_resid; enum uio_seg uio_segflg; enum uio_rw uio_rw; struct proc *uio_procp; }; .Ed .Ft int .Fn uiomove "caddr_t buf" "int howmuch" "struct uio *uiop" .Sh 解説 .Fn uiomove 関数は、ユーザ空間とカーネル空間の境界を越えることさえ可能で、 バッファと入出力ベクタ間のデータ転送の実行に使用されます。 .Pp 文字型デバイスのドライバに渡された、あらゆる .Xr read 2 , .Xr write 2 , .Xr readv 2 ないし .Xr writev 2 システムコールの結果として、適切なドライバの -.Em read +.Va d_read または -.Em write +.Va d_write エントリが -.Fa "struct uio" +.Vt "struct uio" 構造体のポインタを渡されて呼び出されます。 転送のリクエストは、この構造体の中にエンコードされます。 ドライバ自身もこの構造体の中のデータを取り出すために .Fn uiomove を使用するべきです。 .Pp -uio 構造体の各フィールドは下記のとおりです。 -.Bl -tag -width "uio_iovcntX" -compact -.It Dv uio_iov +.Vt uio +構造体の各フィールドは下記のとおりです。 +.Bl -tag -width ".Va uio_iovcnt" +.It Va uio_iov 処理すべき入出力ベクタの配列です。 散在的な入出力の場合には、一つ以上のベクタとなるでしょう。 -.It Dv uio_iovcnt +.It Va uio_iovcnt 存在している入出力ベクタの数を示します。 -.It Dv uio_offset +.It Va uio_offset デバイスのオフセットです。 -.It Dv uio_resid +.It Va uio_resid 処理すべきバイト数です。 -.It Dv uio_segflg +.It Va uio_segflg 以下のフラグの中の一つです。 -.Bl -tag -width "UIO_USERISPACEX" -compact -.It Dv UIO_USERSPACE +.Bl -tag -width ".Dv UIO_USERISPACE" +.It Va UIO_USERSPACE 入出力ベクタはプロセスのアドレス空間を指しています。 -.It Dv UIO_SYSSPACE +.It Va UIO_SYSSPACE 入出力ベクタはカーネルのアドレス空間を指しています。 -.It Dv UIO_USERISPACE +.It Va UIO_USERISPACE 入出力ベクタはプロセスのアドレス空間の命令領域を指しています。 -.It Dv UIO_NOCOPY +.It Va UIO_NOCOPY オブジェクト中に既にデータがあり、コピーしません。 .El -.It Dv uio_rw +.It Va uio_rw 要求された転送の方向を示し、 .Dv UIO_READ または .Dv UIO_WRITE です。 -.It Dv uio_procp -プロセスに関連付けられた -.Li struct proc +.It Va uio_procp +スレッドに関連付けられた +.Vt "struct thread" 構造体へのポインタです。 .Dv uio_segflg がプロセスのアドレス空間との転送をすべきであると示している場合に 使用されます。 .El .Sh 具体例 考え方として、ドライバはデータのためのプライベートなバッファの保守を行ない、 このバッファの最大サイズのデータのかたまりの要求を処理します。 下記のバッファの取り扱いはとても簡略化されていて 恐らく動きません(バッファのポインタは部分的な読み込みの場合進みません)し、 -uio の取り扱いを実際にやって見せているだけだ、ということに注意してください。 +.Nm +の取り扱いを実際にやって見せているだけだ、ということに注意してください。 .Bd -literal /* MIN() の定義はこの中にあります */ #include #define BUFSIZE 512 static char buffer[BUFSIZE]; static int data_available; /* 読み込めるデータ量 */ static int fooread(dev_t dev, struct uio *uio, int flag) { int rv, amnt; while (uio->uio_resid > 0) { if (data_available > 0) { amnt = MIN(uio->uio_resid, data_available); if ((rv = uiomove((caddr_t)buffer, amnt, uio)) != 0) goto error; data_available -= amnt; } else { tsleep(...); /* より良い時期まで待つ */ } } return 0; error: /* エラーのクリーンアップをここで行なう */ return rv; } .Ed .Sh 戻り値 .Fn uiomove は プロセスのアドレス空間との転送の場合に、 .Xr copyin 9 または .Xr copyout 9 によって引き起こされた .Er EFAULT を返すことがあります。 .Sh 関連項目 .Xr read 2 , .Xr readv 2 , .Xr write 2 , .Xr writev 2 , .Xr copyin 9 , .Xr copyout 9 , .Xr sleep 9 .Sh 歴史 -uio の仕組みはある早期のバージョンの +.Nm +の仕組みはある早期のバージョンの .Ux で登場しました。 .Sh 作者 このマニュアルページは .An J\(:org Wunsch が書きました。 diff --git a/ja_JP.eucJP/man/man9/vget.9 b/ja_JP.eucJP/man/man9/vget.9 index 67527f3cc4..b249a6199a 100644 --- a/ja_JP.eucJP/man/man9/vget.9 +++ b/ja_JP.eucJP/man/man9/vget.9 @@ -1,73 +1,73 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/vget.9,v 1.5 1999/08/28 00:21:34 peter Exp % +.\" %FreeBSD: src/share/man/man9/vget.9,v 1.5.2.1 2001/12/17 11:30:19 ru Exp % .\" .\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VGET 9 .Sh 名称 .Nm vget .Nd 開放リストから vnode を取得 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft int .Fn vget "struct vnode *vp" "int lockflag" "struct proc *p" .Sh 解説 フリーリストから vnode を取得し、その参照カウントをインクリメントします。 .Bl -tag -width lockflag .It Ar vp フリーリストから取り除く vnode。 .It Ar lockflag 0 でない場合は、その vnode はロックもされるでしょう。 .El .Pp 使用されなくなった時、vnode はフリーリストに保持されます。 これらの vnode は有効なファイルを参照していますが、 いつでも新しいファイルを参照するために再利用され得ます。 vnode は、名前キャッシュ等の システム中のキャッシュの中にも、しばしば保持されます。 .Pp フリーリスト上にある vnode が再利用される時、例えば .Xr VOP_LOOKUP 9 を呼び出した結果名前キャッシュにその vnode が見つかった場合、 参照カウントのインクリメントとフリーリストからの削除のために、 新しい使用者は .Xr vget 9 を呼び出すことが必要です。 .Sh 関連項目 .Xr vnode 9 , .Xr vput 9 , .Xr vref 9 , .Xr vrele 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/vput.9 b/ja_JP.eucJP/man/man9/vput.9 index 3e40e67c3c..ecb830a363 100644 --- a/ja_JP.eucJP/man/man9/vput.9 +++ b/ja_JP.eucJP/man/man9/vput.9 @@ -1,65 +1,65 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/vput.9,v 1.6.2.2 2000/12/29 10:18:08 ru Exp % +.\" %FreeBSD: src/share/man/man9/vput.9,v 1.6.2.3 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/vput.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VPUT 9 .Sh 名称 .Nm vput .Nd vnode の使用カウントのデクリメントとロック解除 .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft void .Fn vput "struct vnode *vp" .Sh 解説 vnode の .Dv v_usecount フィールドをデクリメントし、その vnode のロックを解除します。 .Bl -tag -width 2n .It Ar vp デクリメントされる vnode。 .El .Pp この操作は、 .Xr vrele 9 が続く .Xr VOP_UNLOCK 9 の呼び出しと、機能的に同等です。 .Sh 関連項目 .Xr vnode 9 , .Xr VOP_UNLOCK 9 , .Xr vref 9 , .Xr vrele 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/vref.9 b/ja_JP.eucJP/man/man9/vref.9 index 54c8ee00b4..43432eaaad 100644 --- a/ja_JP.eucJP/man/man9/vref.9 +++ b/ja_JP.eucJP/man/man9/vref.9 @@ -1,70 +1,70 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/vref.9,v 1.6.2.1 2000/12/29 10:18:08 ru Exp % +.\" %FreeBSD: src/share/man/man9/vref.9,v 1.6.2.2 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/vref.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VREF 9 .Sh 名称 .Nm vref .Nd vnode の使用カウントのインクリメント .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft void .Fn vref "struct vnode *vp" .Sh 解説 vnode の .Dv v_usecount フィールドをインクリメントします。 .Bl -tag -width 2n .It Ar vp インクリメントされる vnode。 .El .Pp 個々の vnode は、システムの何個の部分でその vnode が使用中であるかを示す 参照カウントを維持管理します。 これにより、 vnode がもはや使われなくなって別のファイル用に安全に再利用可能なことを、 ファイルシステムが検知可能となります。 .Pp vnode を使用中のシステム中の全てのコード (例えば、 あるアルゴリズムの操作中や、データ構造の格納時) は、 .Xr vref 9 を呼び出すべきです。 .Sh 関連項目 .Xr vget 9 , .Xr vnode 9 , .Xr vput 9 , .Xr vrele 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/vrele.9 b/ja_JP.eucJP/man/man9/vrele.9 index 7b294bb705..9665752c6d 100644 --- a/ja_JP.eucJP/man/man9/vrele.9 +++ b/ja_JP.eucJP/man/man9/vrele.9 @@ -1,67 +1,67 @@ .\" -*- nroff -*- .\" .\" Copyright (c) 1996 Doug Rabson .\" .\" 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. .\" .\" 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/share/man/man9/vrele.9,v 1.6.2.1 2000/12/29 10:18:08 ru Exp % +.\" %FreeBSD: src/share/man/man9/vrele.9,v 1.6.2.2 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/vrele.9,v 1.2 2001/05/14 01:10:24 horikawa Exp $ +.\" $FreeBSD$ .Dd July 24, 1996 .Os .Dt VRELE 9 .Sh 名称 .Nm vrele .Nd vnode の使用カウントのデクリメント .Sh 書式 -.Fd #include -.Fd #include +.In sys/param.h +.In sys/vnode.h .Ft void .Fn vrele "struct vnode *vp" .Sh 解説 vnode の .Dv v_usecount フィールドをデクリメントします。 .Bl -tag -width 2n .It Ar vp デクリメントされる vnode。 .El .Pp vnode を使用中のシステム中の全てのコードは、 その vnode を使い終えた時には、 .Xr vrele 9 を呼び出すべきです。 その vnode の .Dv v_usecount フィールドが 0 に達した場合には、その vnode はフリーリストに置かれます。 .Sh 関連項目 .Xr vget 9 , .Xr vnode 9 , .Xr vput 9 , .Xr vref 9 .Sh 作者 このマニュアルページは .An Doug Rabson が書きました。 diff --git a/ja_JP.eucJP/man/man9/vslock.9 b/ja_JP.eucJP/man/man9/vslock.9 index cc3254aa4a..dfc378136b 100644 --- a/ja_JP.eucJP/man/man9/vslock.9 +++ b/ja_JP.eucJP/man/man9/vslock.9 @@ -1,74 +1,74 @@ .\" %NetBSD: vslock.9,v 1.1 1996/06/15 20:47:29 pk Exp % .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Paul Kranenburg. .\" .\" 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 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/share/man/man9/vslock.9,v 1.4.2.2 2001/08/17 13:08:55 ru Exp % +.\" %FreeBSD: src/share/man/man9/vslock.9,v 1.4.2.3 2001/12/17 11:30:19 ru Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man9/vslock.9,v 1.5 2001/07/29 05:15:42 horikawa Exp $ +.\" $FreeBSD$ .Dd June 15, 1996 .Dt VSLOCK 9 .Os .Sh 名称 .Nm vslock , .Nm vsunlock .Nd ユーザー空間のアドレスのメモリへのロックとアンロック .Sh 書式 -.Fd #include -.Fd #include -.Fd #include +.In sys/types.h +.In vm/vm.h +.In vm/vm_extern.h .Ft void .Fn vslock "caddr_t addr" "u_int len" .Ft void -.Fn vsunlock "caddr_t addr" "u_int len" "int dirtied" +.Fn vsunlock "caddr_t addr" "u_int len" .Sh 解説 .Fn vslock および .Fn vsunlock 関数は現在実行中のプロセスに属するアドレスの範囲を メモリ中にそれぞれロックしたりアンロックしたりします。 ロックされる実際のメモリ量はマシンのページサイズの倍数になります。 開始ページナンバーは .Fa addr をすぐ前のページ境界に切りつめられ、終了ページは .Fa addr + .Fa len の次のページ境界に切り上げられて計算されます。 この操作に使用されるプロセスのコンテキストはグローバル変数 .Va curproc を参照します。 .Sh 関連項目 .Xr physio 9 .Sh バグ 引数としてプロセスのポインタを渡すべきです。