diff --git a/ja_JP.eucJP/man/man4/Makefile b/ja_JP.eucJP/man/man4/Makefile new file mode 100644 index 0000000000..0ba793e3f3 --- /dev/null +++ b/ja_JP.eucJP/man/man4/Makefile @@ -0,0 +1,180 @@ +MAN4= adv.4\ + adw.4\ + aha.4\ + ahb.4\ + ahc.4\ + aic.4\ + apm.4\ + ar.4\ + arp.4\ + asc.4\ + atkbd.4\ + atkbdc.4\ + ax.4\ + bktr.4\ + bpf.4\ + bridge.4\ + bt.4\ + ccd.4\ + cd.4\ + ch.4\ + cs.4\ + cx.4\ + cy.4\ + da.4\ + daic.4\ + ddb.4\ + de.4\ + dgb.4\ + divert.4\ + dpt.4\ + drum.4\ + dummynet.4\ + ed.4\ + el.4\ + en.4\ + ep.4\ + euc.4\ + ex.4\ + fd.4\ + fdc.4\ + fe.4\ + fpa.4\ + fxp.4\ + gsc.4\ + i4b.4\ + i4bctl.4\ + i4bipr.4\ + i4bisppp.4\ + i4bq921.4\ + i4bq931.4\ + i4brbch.4\ + i4btel.4\ + i4btrc.4\ + icmp.4\ + ie.4\ + ifmib.4\ + iic.4\ + iicbb.4\ + iicbus.4\ + iicsmb.4\ + imm.4\ + inet.4\ + intro.4\ + io.4\ + ip.4\ + ipfirewall.4\ + ipnat.4\ + joy.4\ + keyboard.4\ + labpc.4\ + le.4\ + lkm.4\ + lnc.4\ + lo.4\ + lp.4\ + lpbb.4\ + lpt.4\ + matcd.4\ + mcd.4\ + mem.4\ + mouse.4\ + mtio.4\ + mx.4\ + natm.4\ + ncr.4\ + netintro.4\ + npx.4\ + null.4\ + od.4\ + opie.4\ + pass.4\ + pcf.4\ + pcm.4\ + pcvt.4\ + perfmon.4\ + plip.4\ + pn.4\ + pnp.4\ + ppbus.4\ + ppc.4\ + ppi.4\ + ppp.4\ + psm.4\ + pt.4\ + pty.4\ + random.4\ + rdp.4\ + rl.4\ + route.4\ + sa.4\ + sb.4\ + scd.4\ + screen.4\ + scsi.4\ + sd.4\ + si.4\ + sio.4\ + sl.4\ + smb.4\ + smbus.4\ + smp.4\ + snp.4\ + spkr.4\ + splash.4\ + sr.4\ + ssc.4\ + st.4\ + stl.4\ + su.4\ + sysmouse.4\ + tcp.4\ + tl.4\ + ttcp.4\ + tty.4\ + tun.4\ + tw.4\ + tx.4\ + udp.4\ + uk.4\ + unix.4\ + update.4\ + utf2.4\ + vga.4\ + vinum.4\ + vn.4\ + vpo.4\ + vr.4\ + vx.4\ + wb.4\ + wd.4\ + wfd.4\ + worm.4\ + wt.4\ + xl.4\ + yp.4\ + ze.4\ + zero.4\ + zp.4 + +MLINKS+=fd.4 stderr.4 +MLINKS+=fd.4 stdin.4 +MLINKS+=fd.4 stdout.4 +MLINKS+=fpa.4 fea.4 +MLINKS+=ipfirewall.4 ipaccounting.4 +MLINKS+=ipfirewall.4 ipacct.4 +MLINKS+=ipfirewall.4 ipfw.4 +MLINKS+=mem.4 kmem.4 +MLINKS+=netintro.4 networking.4 +MLINKS+=pcvt.4 vt.4 +MLINKS+=random.4 urandom.4 +MLINKS+=scsi.4 cam.4 +MLINKS+=smp.4 SMP.4 +MLINKS+=spkr.4 speaker.4 +MLINKS+=splash.4 screensaver.4 +MLINKS+=stl.4 stli.4 +MLINKS+=yp.4 NIS.4 +MLINKS+=yp.4 YP.4 +MLINKS+=yp.4 nis.4 + +.include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man4/adv.4 b/ja_JP.eucJP/man/man4/adv.4 new file mode 100644 index 0000000000..084b89c1e9 --- /dev/null +++ b/ja_JP.eucJP/man/man4/adv.4 @@ -0,0 +1,166 @@ +.\" +.\" Copyright (c) 1998 +.\" Justin T. Gibbs. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: adv.4,v 1.1 1998/10/16 21:12:07 ken Exp % +.\" jpman %Id: adv.4,v 1.3 1999/08/15 14:19:54 horikawa Stab % +.\" +.Dd October 16, 1998 +.Dt ADV 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm adv +.Nd Advansys 社製 ISA/VL/EISA/PCI 8 ビット SCSI ホストアダプタドライバ +.Sh 書式 +ISA または VL カードに対して: +.Cd controller isa0 +.Cd controller "adv0 at isa? port ? cam irq ? drq ?" +.Pp +EISA カードに対して: +.Cd controller eisa0 +.Cd controller adv0 +.Pp +PCI カードに対して: +.Cd controller pci0 +.Cd controller adv0 +.Pp +SCSI バスに対して: +.Cd controller scbus0 at adv0 +.Sh 解説 +このドライバは、Advanced System Products, Inc. 社製の +.Tn ASC900 , +.Tn ASC1000 , +.Tn ASC1090 , +.Tn ASC1200 , +.Tn ASC3050 , +.Tn ASC3150 +ホストアダプタチップに接続された +8 ビット +.Tn SCSI +バスへのアクセスを提供します。 +以下の表で、これらのチップを用いた AdvanSys 社製品、接続バスのタイプ、 +最大同期転送速度、そのアダプタで同時に処理できる最大コマンド数を示します。 +.Pp +.Bd -filled -offset indent +.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " Footnotes +接続のための製品: +.Pp +.Em "Adapter Bus Floppy MaxSync Commands Footnotes" +ABP510/5150 ISA No 10MHz 240 1 +ABP5140 ISA PnP No 10MHz 16 1, 3 +ABP5142 ISA PnP Yes 10MHz 16 4 +ABP920 PCI No 10MHz 16 +ABP930 PCI No 10MHz 16 5 +ABP930U PCI No 20MHz 16 +ABP930UA PCI No 20MHz 16 +ABP960 PCI No 10MHz 16 2 +ABP960U PCI No 20MHz 16 2 +.El +.Pp +脚注: +.Bl -enum -compact +.It +このボードは HP 社が 4020i CD-R ドライブと一緒に出荷しています。この +ボードには BIOS がありませんので、ブートデバイスを制御できませんが、 +セカンダリ SCSI デバイスならなんでも制御できます。 +.It +このボードは、Iomega 社が Jaz Jet PCI アダプタとして販売しています。 +.It +このボードは、SIIG 社が i540 SpeedMaster として発売しています。 +.It +このボードは、SIIG 社が i542 SpeedMaster として発売しています。 +.It +このボードは、SIIG 社が Fast SCSI Pro PCI として発売しています。 +.El +.Ed +.Pp +.Bd -filled -offset indent +.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " Commands +単一チャネル製品: +.Pp +.Em "Adapter Bus Floppy MaxSync Commands" +ABP542 ISA Yes 10MHz 240 +ABP742 EISA Yes 10MHz 240 +ABP842 VL Yes 10MHz 240 +ABP940 PCI No 10MHz 240 +ABP940U PCI No 20MHz 240 +ABP970 PCI No 10MHz 240 +ABP970U PCI No 20MHz 240 +.El +.Ed +.Pp +.Bd -filled -offset indent +.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " "Channels " +多重チャネル製品 (コマンドはチャネルごとに実行可能): +.Pp +.Em "Adapter Bus Floppy MaxSync Commands Channels" +ABP752 EISA Yes 10MHz 240 2 +ABP852 VL Yes 10MHz 240 2 +ABP950 PCI No 10MHz 240 2 +ABP980 PCI No 10MHz 240 4 +ABP980U PCI No 20MHz 240 4 +.El +.Ed +.Pp +ISA もしくは Vesa ローカルバス用アダプタに関しては、システムに接続する +カードごとにカーネル設定エントリ 1 つが必要です。ポートアドレス、 +割り込み要求番号(irq)、 +DMA リクエスト番号 (drq) に特定の値を指定することも可能です。 +ワイルドカードの値が指定された場合、ドライバがデバイスに対して現在の +設定値を問い合わせて、その値を使います。ポートアドレスがワイルドカードである +場合、ドライバは指定可能なポートアドレスの位置に関する内部の表を引き、 +アタッチされていないものの中で最初に見つけたものをアタッチします。これらの +カードで生じ得るポートアドレスは、0x110, 0x130, 0x150, 0x190, 0x210, +0x230, 0x250, 0x330 です。 +.Pp +.Tn AdvanceWare +メニューはブート時にアクセス可能なものですが、この +メニューで指定されたターゲットごとの設定は、このドライバでも参照されます。 +これには、同期/非同期転送、最大同期ネゴシエーション速度、切断、タグ付きキュー、 +ホストアダプタの SCSI ID が含まれます。ターゲットごとに許可された +タグ付きトランザクションの最大数の大域設定は使用されません。というのは、 +CAM SCSI システムは、デバイス間での公平なリソース割り当てを保証するのと +同時に、あるデバイスが受信できるタグの最大数を自動的に決定するからです。 +.Sh 関連項目 +.Xr adw 4 , +.Xr aha 4 , +.Xr ahb 4 , +.Xr ahc 4 , +.Xr cd 4 , +.Xr da 4 , +.Xr sa 4 , +.Xr scsi 4 +.Sh 作者 +.Nm adv +ドライバは、 +Advanced System Products, Inc. 社の +.An Bob Frey +が書いた Linux ドライバから +.An Justin T. Gibbs +が移植しました。 +もともとのドライバを、FreeBSD での使用に適したライセンスで AdvanSys 社が +提供してくれたことに感謝致します。 +.Sh 歴史 +.Nm +ドライバは +.Fx 3.0 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/adw.4 b/ja_JP.eucJP/man/man4/adw.4 new file mode 100644 index 0000000000..ae246a5a7e --- /dev/null +++ b/ja_JP.eucJP/man/man4/adw.4 @@ -0,0 +1,78 @@ +.\" +.\" Copyright (c) 1998 +.\" Justin T. Gibbs. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: adw.4,v 1.1 1998/10/16 21:12:07 ken Exp % +.\" jpman %Id: adw.4,v 1.3 1999/08/15 14:19:40 horikawa Stab % +.\" +.Dd October 16, 1998 +.Dt ADW 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm adw +.Nd Advansys 社製 PCI 16bit SCSI ホストアダプタドライバ +.Sh 書式 +.Cd controller pci0 +.Cd controller adw0 +.Pp +SCSI バスに対して: +.Cd controller scbus0 at adw0 +.Sh 解説 +このドライバは、Advanced Systems Products, Inc. 社の +ABP940UW SCSI ホストアダプタボード上の +.Tn ASC3550 +に接続された 16 ビット +.Tn SCSI +バスへのアクセスを提供します。 +このチップは Ultra SCSI (20MHz)、16 ビット転送、タグ付キュー機能、253 個を +上限とする SCSI トランザクションの同時実行をサポートしています。 +.Pp +.Tn AdvanceWare +メニューはブート時にアクセス可能なものですが、この +メニューで指定されたターゲットごとの設定は、このドライバでも参照されます。 +これには、同期/非同期転送、最大同期ネゴシエーション速度、ワイド転送、 +切断、タグ付きキュー、 +ホストアダプタボードの SCSI ID が含まれます。ターゲットごとに許可された +タグ付きトランザクションの最大数の大域設定は使用されません。というのは、 +CAM SCSI システムは、デバイス間での公平なリソース割り当てを保証するのと +同時に、あるデバイスが受信できるタグの最大数を自動的に決定するからです。 +.Sh 関連項目 +.Xr adv 4 , +.Xr cd 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh 作者 +.Nm +ドライバは、 +Advanced System Products, Inc. 社の +.An Bob Frey +が書いた Linux ドライバから +.An Justin T. Gibbs +が移植しました。 +もともとのドライバを、FreeBSD での使用に適したライセンスで AdvanSys 社が +提供してくれたことに感謝致します。 +.Sh 歴史 +.Nm +ドライバは +.Fx 3.0 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/aha.4 b/ja_JP.eucJP/man/man4/aha.4 new file mode 100644 index 0000000000..2abb3b154b --- /dev/null +++ b/ja_JP.eucJP/man/man4/aha.4 @@ -0,0 +1,80 @@ +.\" +.\" Copyright (c) 1994 Wilko Bulte +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: aha.4,v 1.7 1998/10/16 04:41:38 ken Exp % +.\" jpman %Id: aha.4,v 1.3 1999/03/31 16:49:31 horikawa Stab % +.\" +.Dd October 15, 1998 +.Dt AHA 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm aha +.Nd Adaptec SCSI ホストアダプタドライバ +.Sh 書式 +.Cd controller "aha0 at isa? port ? cam irq ? drq 5" +.Cd controller scbus0 at aha0 +.Sh 解説 +このドライバは、 +Adaptec の 154xA, 154xB, 154xC, 154xCF, 154xCP のいずれかの +ホストアダプタに接続された +.Tn SCSI +バスへのアクセスを提供します。 +154X 互換インタフェースをサポートするホストアダプタも、 +このドライバにアタッチできます。 +このようなホストアダプタには、 +154x エミュレーションモードの一部の Tekram コントローラや +Adaptec 174x コントローラなどがあります。 +Adaptec 174x コントローラで最適なパフォーマンスを得るには、 +エンハンストモードに設定し、 +.Xr ahb 4 +ドライバを通じてアタッチするとよいでしょう。 +.Pp +カーネルの設定ファイルには、システムに取り付けられたカード毎に +1 つのエントリが必要です。 +ポートアドレス、割り込み番号 (irq)、DMA リクエスト番号 (drq) +には特定の値を指定できます。 +値にワイルドカードが使用された場合、 +ドライバはデバイスに現在の設定を問い合わせ、結果を使用します。 +ポートアドレスがワイルドカードの場合、 +ドライバは、ありうるポートアドレス位置が書かれた内部表を参照し、 +最初に見つけたアタッチされていないカードをアタッチします。 +このカードにありうるポートアドレスは、 +0x330, 0x334, 0x230, 0x234, 0x130, 0x134 です。 +.Sh 関連項目 +.Xr ahb 4 , +.Xr ahc 4 , +.Xr cd 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.\" +.\" .Sh 診断 +.\" +.Sh 作者 +.Nm aha +ドライバは、Justin T. Gibbs による +.Nm bt +ドライバを、M. Warner Losh が移植したものです。 diff --git a/ja_JP.eucJP/man/man4/ahb.4 b/ja_JP.eucJP/man/man4/ahb.4 new file mode 100644 index 0000000000..c559b4eda5 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ahb.4 @@ -0,0 +1,63 @@ +.\" +.\" Copyright (c) 1994 Wilko Bulte +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ahb.4,v 1.9 1998/10/16 04:41:38 ken Exp % +.\" jpman %Id: ahb.4,v 1.3 1999/11/19 15:20:40 horikawa Stab % +.\" +.Dd October 15, 1998 +.Dt AHB 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ahb +.Nd Adaptec 社製 EISA SCSI ホストアダプタドライバ +.Sh 書式 +.Cd controller ahb0 +.Cd controller scbus0 at ahb0 +.Sh 解説 +このドライバは、 +.Dq Em エンハンスト +モードに設定した Adaptec 174x ホストアダプタに接続された +.Tn SCSI +バスへのアクセスを提供します。 +タグ付きキューイング、同期 SCSI 転送をサポートしています。 +.Sh 警告 +Adaptec 174X は SCSI バスのターミネータの処理と使用するケーブルの長さ +に極めて敏感です。また、最近のいくつかのデバイスの操作に難が +あり、それら新型デバイスのスピードに対応できず、コントローラにおいて +タイミング上の問題が生じることがあります。この種の機器間の不整合に +対処するための機構は知られていません。 +.Sh 関連項目 +.Xr aha 4 , +.Xr ahc 4 , +.Xr cd 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh 作者 +.Nm +ドライバは、 +.An Justin T. Gibbs +が作成しました。 diff --git a/ja_JP.eucJP/man/man4/ahc.4 b/ja_JP.eucJP/man/man4/ahc.4 new file mode 100644 index 0000000000..13547a5818 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ahc.4 @@ -0,0 +1,262 @@ +.\" +.\" Copyright (c) 1995, 1996, 1997, 1998 +.\" Justin T. Gibbs. 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ahc.4,v 1.13 1998/10/16 15:06:26 gibbs Exp % +.\" jpman %Id: ahc.4,v 1.3 1999/11/19 15:20:44 horikawa Stab % +.\" +.\" WORD: tagged queueing タグキューイング +.\" WORD: programmed I/O プログラムド I/O +.\" WORD: maximum synchronous negotiation rate 最大同期ネゴシエーション速度 +.\" WORD: disconnection ディスコネクト +.\" WORD: scatter gather +.\" WORD: transaction トランザクション +.\" WORD: bus traffic バスの流量 +.\" WORD: clock crystal 水晶発振子 +.\" +.Dd October 15, 1998 +.Dt AHC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ahc +.Nd Adaptec VL/EISA/PCI SCSI ホストアダプタドライバ +.Sh 書式 +VL/EISA カード 1 つ以上につき: +.Cd controller eisa0 +.Cd controller ahc0 +.Pp +PCI カード 1 つ以上につき: +.Cd controller pci0 +.Cd controller ahc0 +.Pp +PCI アダプタにメモリマップド I/O を許可するには: +.Cd options AHC_ALLOW_MEMIO +.Pp +SCSI バス 1 つ以上につき: +.Cd controller scbus0 at ahc0 +.Sh 解説 +このドライバは +Adaptec +.Tn AIC7770, +.Tn AIC7850, +.Tn AIC7860, +.Tn AIC7870, +.Tn AIC7880, +.Tn AIC7890, +.Tn AIC7891, +.Tn AIC7895, +.Tn AIC7896, +.Tn AIC7897 +ホストアダプタチップに接続された +.Tn SCSI +バスを利用できるようにします。 +これらのチップは +次に挙げる Adaptec SCSI コントローラカードや、 +多くのマザーボードに載っています。 +.Tn 274X(W), +.Tn 274X(T), +.Tn 284X, +.Tn 2920C, +.Tn 2940, +.Tn 2940U, +.Tn 2940AU, +.Tn 2940UW, +.Tn 2940UW Dual, +.Tn 2940U2W, +.Tn 2940U2B, +.Tn 2950U2W, +.Tn 2950U2B, +.Tn 3940, +.Tn 3940U, +.Tn 3940AU, +.Tn 3940UW, +.Tn 3940AUW, +.Tn 3940U2W, +.Tn 3985 +.Pp +このドライバは twin/wide バスやコントローラのタイプに応じた +fast/ultra/ultra2 同期転送、そしてタグキューイングや SCB ページング +をサポートしています。 +.Pp +PCI デバイスでは +.Dq Dv AHC_ALLOW_MEMIO +設定オプションを記述することでメモリマップド I/O を利用するようになります。 +メモリマップド I/O は +(オプションを記述しない場合に利用する) プログラムド I/O よりも効率的です。 +たいていの PCI BIOS は、 +カードと通信するのにどちらの手段でも使えるようにデバイスをマップします。 +しかし場合によっては +(大抵は PCI デバイスが PCI->PCI ブリッジの向こう側にある場合)、 +チップがメモリマップド I/O を利用するための初期化を BIOS が実施できません。 +この問題の症状は、通常、 +メモリマップド I/O の利用を試みるとシステムがハングアップすることです。 +最近のマザーボードはたいていうまく初期化をするので、 +このオプションを有効にしてもきちんと動作します。 +.Pp +ターゲット毎の設定は、 +.Tn EISA +以外のモデルで起動時に利用できる +.Tn SCSI-Select +メニューで行ない、 +.Tn EISA +モデルでは +.Tn EISA +設定ユーティリティで行ないます。 +このドライバは、このターゲット毎の設定を受け取ります。 +.Tn EISA +アダプタでは +.Tn BIOS +が有効になっているという条件が必要です。 +受け取る設定項目は、同期/非同期転送、最大同期ネゴシエーション速度、 +ディスコネクト、ホストアダプタの SCSI ID、そして +.Tn EISA +ツインチャネルコントローラの場合にはプライマリチャネルの選択です。 +.Pp +I/O アドレスは検出ルーチンによって自動的に決定されますが、 +284x +.Pq Tn VESA No ローカルバスコントローラ +を +.Tn EISA +システムで使う場合には注意が必要です。 +他の +.Tn EISA +カードとの衝突を防ぐために、 +284x が使用する I/O 領域を設定するジャンパが、 +カードが挿し込まれている +.Tn EISA +スロットと適合していることを確かめて下さい。 +.Pp +性能と機能の組合せは、aic7xxx の製品の種類によってさまざまです。 +次の表は +.Nm +ドライバがサポートするさまざまなチップの比較です。 +ワイドおよびツインチャネル機能は、 +たとえ特定のチップで常にサポートされていても、 +特定のマザーボードやカードの設計では無効になっているかもしれないことに +注意して下さい。 +.Pp +.Bd -filled -offset indent +.Bl -column "aic7770 " "10 " "EISA/VL " "10MHz " "16bit " "SCBs " Features +.Em "Chip MIPS Bus MaxSync MaxWidth SCBs Features" +aic7770 10 EISA/VL 10MHz 16Bit 4 1 +aic7850 10 PCI/32 10MHz 8Bit 3 +aic7860 10 PCI/32 20MHz 8Bit 3 +aic7870 10 PCI/32 10MHz 16Bit 16 +aic7880 10 PCI/32 20MHz 16Bit 16 +aic7890 20 PCI/32 40MHz 16Bit 16 3 4 5 6 7 +aic7891 20 PCI/64 40MHz 16Bit 16 3 4 5 6 7 +aic7895 15 PCI/32 20MHz 16Bit 16 2 3 4 5 +aic7896 20 PCI/32 40MHz 16Bit 16 2 3 4 5 6 7 +aic7897 20 PCI/64 40MHz 16Bit 16 2 3 4 5 6 7 +.El +.Pp +.Bl -enum -compact +.It +多重ツインチャネルデバイス - 1 つのコントローラが 2 つのバスを提供します。 +.It +多機能ツインチャネルデバイス - 1 つのチップに 2 つのコントローラが存在します。 +.It +コマンドチャネルのセカンダリ DMA エンジン - +スキャッタギャザリストと SCB の先読みを許します。 +.It +64 バイト SCB サポート - +余計な DMA を排除するために SCSI CDB が SCB に組み込まれています。 +.It +ブロック移動命令サポート - 特定のシーケンサ操作のスピードを倍にします。 +.It +.Sq Bayonet +スタイルのスキャッタギャザエンジン - S/G 先読みの性能を改善します。 +.It +キューイングレジスタ - +シーケンサを停止させずに新たなトランザクションをキューイングできます。 +.El +.Ed +.Pp + +.Sh SCSI コントロールブロック (SCB) +SCSI バス上のデバイスに送られるトランザクションは、それぞれ 1 つの +.Sq SCSI コントロールブロック +(SCB) に割り当てられます。 +SCB はコントローラがトランザクションを処理するのに必要な全ての +情報を持っています。 +(上の) チップの機能の表には、チップ上のメモリに格納できる +SCB 数が挙げられています。 +モデルナンバが 7870 以上の全てのチップは、 +外部 SRAM によってチップ上の SCB 空間を、最大で 255 SCB まで増加可能です。 +Adaptec のコントローラで外部 SRAM を持っているものはほとんどありません。 + +外部 SRAM が利用できない場合には SCB は限りある資源であり、 +率直 (馬鹿正直) な方法で使うと、 +同時に処理中にできるトランザクション数は、SCB 数までです。 +これでは SCSI バスやデバイスをフルに活用するのに十分な余裕がありません。 +この問題を解決するのは +.Em SCB ページング +というメモリのページングと同様の考え方です。 +SCB ページングは、デバイスが普段は長い時間コントローラと会話せず、 +SCSI バスとの接続をディスコネクト (切断) しているという事実を利用しています。 +ディスコネクトしているトランザクションの SCB は、 +コントローラにとっては転送が再開した時にだけ役に立ちます。 +コントローラが実行すべき別のトランザクションをホストがキューイングした時、 +コントローラのファームウェアは、未使用の SCB があればそれを使います。 +ない場合、ディスコネクトされてから一番時間が経っていない +(それゆえ最も長くディスコネクトされたままであろう) SCB の状態を +DMA を経由してホストのメモリに保存し、 +コントローラの SCB を再利用して新しいトランザクションを始めます。 +これによりコントローラは SCB 空間の大きさによらず +最大 255 のトランザクションをキューイング可能です。 +コントローラの SCB 空間がディスコネクトされているトランザクションの +キャッシュとして機能するため、利用できる SCB 空間が大きければ大きいほど、 +SCB のデータを保存したり復元したりするために使われるホストのバスの +流量が少なくなります。 +.Sh バグ +ある Quantum のドライブ (少なくとも Empire 2100 と 1080s) は、 +.Tn AIC7870 +Rev B の 10MHz の同期モードでは使えません。 +この問題があるコントローラは 42MHz の水晶発振子を持っていて、 +10MHz よりちょっと高い周波数で動作します。 +このためドライブに支障をきたしバスがハングアップします。 +.Tn SCSI-Select +ユーティリティで最大同期ネゴシエーション速度を 8MHz に設定すれば +普通に使えるようになります。 +.Sh 関連項目 +.Xr aha 4 , +.Xr ahb 4 , +.Xr cd 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh 作者 +.Nm +ドライバ、 +.Tn AIC7xxx +シーケンサコードアセンブラ、 +そして aic7xxx チップで動作するファームウェアは +.An Justin T. Gibbs +が書きました。 +.Sh 歴史 +.Nm +ドライバは +.Fx 2.0 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/aic.4 b/ja_JP.eucJP/man/man4/aic.4 new file mode 100644 index 0000000000..322991a0df --- /dev/null +++ b/ja_JP.eucJP/man/man4/aic.4 @@ -0,0 +1,51 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: aic.4,v 1.4 1997/02/22 13:25:10 peter Exp % +.\" jpman %Id: aic.4,v 1.3 1999/10/06 10:51:40 horikawa Stab % +.\" +.Dd November 29, 1994 +.Dt AIC 4 i386 +.Os +.Sh 名称 +.Nm aic +.Nd Adaptec の AIC-6260 と AIC-6360 の SCSI ドライバ +.Sh 書式 +.Cd "device aic0 at isa? port 0x340 bio irq 11" +.Sh 解説 +.Nm aic +ドライバは Adaptec の AIC-6260 と AIC-6360 の SCSI +コントローラチップのサポートを提供します。 +これは、Adaptec 152x と Creative +Labs SoundBlaster SCSI ホストアダプタを含みます。 +.Pp +これらのコントローラチップを用いた多くのシステムは +ブート ROM を持っていません。したがって、ここからブートはできません。 +.Sh 関連項目 +.Xr cd 4 , +.Xr ch 4 , +.Xr intro 4 , +.Xr sd 4 , +.Xr st 4 + + diff --git a/ja_JP.eucJP/man/man4/apm.4 b/ja_JP.eucJP/man/man4/apm.4 new file mode 100644 index 0000000000..b878b8cd2f --- /dev/null +++ b/ja_JP.eucJP/man/man4/apm.4 @@ -0,0 +1,160 @@ +.\" LP (Laptop Package) +.\" +.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi +.\" +.\" This software may be used, modified, copied, and distributed, in +.\" both source and binary form provided that the above copyright and +.\" these terms are retained. Under no circumstances is the author +.\" responsible for the proper functioning of this software, nor does +.\" the author assume any responsibility for damages incurred with its +.\" use. +.\" +.\" %Id: apm.4,v 1.9 1998/12/18 03:08:57 jkoshy Exp % +.\" jpman %Id: apm.4,v 1.4 2000/07/17 05:48:14 osana Stab % +.\" +.Dd November 1, 1994 +.Dt APM 4 i386 +.Os +.Sh 名称 +.Nm apm +.Nd APM BIOS インタフェース +.Sh 書式 +.Cd device apm0 at isa? +.Sh 解説 +.Nm apm +はラップトップ PC の Intel / Microsoft APM (Advanced Poewr Management) +BIOS へのインタフェースです。 +.Pp +.Nm apm +は次の電源管理機能を提供します。 +.Bl -enum -offset indent +.It +システムがサスペンドモードから復帰した時に、 +.Nm apm +はシステムの時計を RTC に合わせます。 +.It +システムがサスペンドモードから復帰した時に、 +システムが復帰した時刻とサスペンドモード中に経過した時間で構成される +メッセージを、 +.Nm apm +は +.Xr syslogd 8 +に通知します。 +.It +.Nm apm +はシステムの活動 (実行可能なプロセス、割り込みなど) がない時に +CPU のクロックを減速します。 +この機能は APM が CPU のアイドリングをサポートしているシステムでのみ有効です。 +.It +.Nm apm +はキャラクタ型デバイスとしてアプリケーションインタフェースを提供します。 +アプリケーションはこのインタフェースを介して APM を制御したり、 +APM の状態情報を引き出したりすることができます。 +.Nm apm +は次のインタフェースを提供します。これらのシンボルは +.Dq Pa /usr/include/machine/apm_bios.h +で定義されています。 +.Bl -tag -width 4n -offset indent +.It Sy APMIO_SUSPEND +システムをサスペンドします。 +.It Sy APMIO_GET +電源管理情報を入手します。 +.It Sy APMIO_ENABLE +.It Sy APMIO_DISABLE +電源管理を有効 / 無効にします。 +.It Sy APMIO_HALTCPU +.It Sy APMIO_NOTHALTCPU +カーネルコンテキスト切り替えルーチンでの HLT の実行を制御します。 +.Pp +HLT +.Pq 割り込みが発生するまで CPU を停止 +命令を +.Dq Pa Idle CPU +呼び出しの中で実行する APM の実装もありますし、そうでないものもあります。 +ですからこれを有効にすると、 +.Dq Pa Idle CPU +を呼び出すカーネルコンテキスト切り替えルーチンが +元々 HLT 命令を実行することにより、 +余分な HLT 命令を実行することになる可能性があります。 +この結果、システムのピーク性能を減少させる可能性があります。 +.Pp +また、カーネルコンテキスト切り替えルーチンでの HLT 命令を無効にした場合、 +マシンの APM の実装が +.Dq Pa Idle CPU +で HLT を実行しない場合には、システムはハングアップします。 +CPU クロックの減速をサポートしていない実装では、APM は HLT +を実行しないかもしれません。 +そのようなマシンでは、 +.Nm apm +は +.Sy APMIO_NOTHALTCPU +の操作を無効にします。 +.Pp +現在のバージョンの +.Nm apm +は、クロックの減速がサポートされていない場合には、 +カーネルコンテキスト切り替えルーチンから +.Dq Pa Idle CPU +を呼び出さず、デフォルトでは HLT 命令を実行します。 +したがって、大抵の場合にはこれらの 2 つの操作を行う必要はありません +.El +.Pp +これらのインタフェースは +.Xr apm 8 +と +.Xr apmconf 8 +が使用します。 +.It +.Nm apm +は APM イベントをポーリングし、次のイベントを処理します。 +.Bl -column PMEV_POWERSTATECHANGEXXX "suspend system xxxxx" +.It Sy "名称 " "動作 " "解説" +.It Dv "PMEV_STANDBYREQ " No "サスペンド " "待機要求" +.It Dv "PMEV_SUSPENDREQ " No "サスペンド " "サスペンド要求" +.It Dv "PMEV_USERSUSPENDREQ " No "サスペンド " "ユーザサスペンド要求" +.It Dv "PMEV_CRITSUSPEND " No "サスペンド " "非常サスペンド要求" +.It Dv "PMEV_NORMRESUME " No "レジューム " "通常の復元" +.It Dv "PMEV_CRITRESUME " No "レジューム " "非常復元" +.It Dv "PMEV_STANDBYRESUME " No "レジューム " "待機復元" +.It Dv "PMEV_BATTERYLOW " No "メッセージ通知 " "電池不足" +.It Dv "PMEV_UPDATETIME " No "時計合わせ " "時刻を更新" +.El +.El +.Sh バグ +警告! +現在のところ、ラップトップマシンの APM BIOS の実装は、 +ほとんどとまではいかなくてもバグだらけです。 +このインタフェースを使用すると LCD ディスプレイや電池を +危険にさらす可能性があります。 +(これが MS-Windows で問題とならない理由はリアルモードインタフェース +を使用しているからです。) +このコードを使用してあなたのシステムが奇妙な動作をするのを発見した場合には、 +電源プラグと電池を直ちにとまではいかなくてもできるだけ早く抜き、 +このコードを無効にしてください。 +.Pp +私達はこのコードが動作するようになることに関心を持っています。 +異常な動作の観察結果をぜひ私達に連絡してください。 +.Pp +.Nm apm +が有効である時、ホットキーを使って BIOS 設定ルーチンを呼び出すと +システムレジューム時に重大な障害を引き起こす可能性があります。 +BIOS 設定プログラムはブートストラップ時または DOS から呼び出すべきです。 +.Pp +APM の実装によっては、電源ボタンを押したことやカバーを閉じるといった +イベントを扱うことができない場合があります。 +そのような実装でシステムをサスペンドする場合には、 +.Ar 必ず +.Xr apm 8 +または +.Xr zzz 8 +.Ar だけ +を使用してください。 +.Pp +ディスク減速、LCD バックライト制御、パワーオンデマンドは +現在のバージョンではサポートされていません。 +.Sh 関連項目 +.Xr apm 8 , +.Xr apmconf 8 , +.Xr zzz 8 +.Sh 作者 +Tatsumi Hosokawa diff --git a/ja_JP.eucJP/man/man4/ar.4 b/ja_JP.eucJP/man/man4/ar.4 new file mode 100644 index 0000000000..b287c99353 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ar.4 @@ -0,0 +1,108 @@ +.\" +.\" Copyright (c) 1995 John Hay. 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 John Hay. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY John Hay ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL John Hay BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ar.4,v 1.9 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ar.4,v 1.3 1999/04/19 14:33:05 horikawa Stab % +.\" +.\" WORD: link level layer リンクレベルの層 +.\" +.Dd November 19, 1995 +.Dt AR 4 i386 +.Os +.Sh 名称 +.Nm ar +.Nd +同期 Arnet デバイスドライバ +.Sh 書式 +.Cd "device ar0 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Cd "device ar1 at isa? port 0x310 net irq 11 iomem 0xd0000" +.Pp +.Cd "pseudo-device sppp" +.Sh 解説 +.Nm ar +ドライバは HD64570 チップを使用した Arnet SYNC/570i ISA カードを +サポートします。 +2 ポートと 4 ポートの両方のカードをサポートし、自動検出します。 +.Pp +回線速度は最大で 2Mbps まで得られます。この速度では 486DX プロセッサで +帯域の約 85 % を使用することができます。 +.Pp +リンクレベルの層に、標準の +.\" link level layer は OSI モデルでは data link layer に相当するもの +.\" もしくは data link layer の一部に相当するものと思いますが、原文を +.\" 尊重して「リンクレベルの層」としたい +.Tn FreeBSD +sppp コードを使用します。 +デフォルトのプロトコルは PPP です。 +Cisco HDLC プロトコルは +.Xr ifconfig 8 +に +.Ar link2 +を追加することによって使用できます。 +.Sh 番号 +カーネル設定ファイルでは、カード毎に 1 行のみが必要です。 +最初のカードのポートは、ar0 から導入されます。 +次のカードの番号は、最初のカードで止まった所から続けます。 +つまり、もし最初のカードが 2 ポートのカードなら、そのカードは ar0 と ar1 +を使います。そして次のカードは、ar2 から始めます。 +.Pp +カードは IRQ 3, 5, 7, 10, 11, 12, 15 のみをサポートします。 +.Pp +iomem 領域は、16Kb ブロックであり、16Kb 境界から始まる必要があります。 +.Pp +.Sh 診断 +.Bl -diag +.It "ar%d: Warning illegal interrupt %d." +カードが指定された割り込みを使用できません。他の割り込みを選んでください。 +.El +.Sh 関連ファイル +.Bl -tag -width /sys/i386/isa/ic/hd64570.h -compact +.It Pa /sys/i386/isa/ic/hd64570.h +.It Pa /sys/i386/isa/if_arregs.h +.It Pa /sys/i386/isa/if_ar.c +.El +.Sh バグ +現時点で V.35 と X.21 インタフェースだけを試験しています。 +他のものではクロック部分のコードを微調整する必要があるでしょう。 +.Pp +このコードには、おそらく最適化の余地があります。 +.Pp +このコードは、まだできたばかりですから非常に多くのバグがあるでしょう。 +バグは jhay@mikom.csir.co.za へ報告してください。 +.Sh 関連項目 +.Xr cx 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr lsdev 8 +.Sh 作者 +.Nm ar +デバイスドライバは +.An John Hay Aq jhay@mikom.csir.co.za +が作成しました。 diff --git a/ja_JP.eucJP/man/man4/arp.4 b/ja_JP.eucJP/man/man4/arp.4 new file mode 100644 index 0000000000..ce6c004706 --- /dev/null +++ b/ja_JP.eucJP/man/man4/arp.4 @@ -0,0 +1,149 @@ +.\" Copyright (c) 1985, 1986, 1988, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)arp4.4 6.5 (Berkeley) 4/18/94 +.\" jpman %Id: arp.4,v 1.3 1999/11/06 13:01:31 horikawa Stab % +.\" +.Dd April 18, 1994 +.Dt ARP 4 +.Os BSD 4 +.Sh 名称 +.Nm arp +.Nd アドレス解決プロトコル +.Sh 書式 +.Em "pseudo-device ether" +.Sh 解説 +アドレス解決プロトコル (ARP) はインターネットホストアドレスと +10Mb/s のイーサネットアドレスを動的にマッピングするプロトコルです。 +これは全ての 10Mb/s イーサネットインタフェースドライバで +利用されています。 +このプロトコルはインターネットプロトコルや 10Mb/s イーサネットに +限定されているわけではありませんが、 +現在の実装ではこの組み合わせしかサポートしていません。 +.Pp +ARP はインターネットアドレスとイーサネットアドレスのマッピング (対応関係) を +キャッシュします。 +キャッシュにないアドレスのマッピングをインタフェースが要求したとき、 +ARP は、そのマッピングを要求するメッセージをキューに入れ、 +そのアドレスマッピングを要求するメッセージを +接続されたネットワークに対してブロードキャストします。 +応答があった場合、新たにマッピングされたアドレスを +キャッシュに格納し、キューに入れられていたメッセージを送信します。 +ARP はマッピング要求の応答を待つ間、 +高々 1 つのパケットをキューに保持します。 +すなわち、1 番最近 ``送信した'' パケットのみを保持します。 +もし目的のホストが数回の要求にも応じない場合、 +そのホストは短期間 (通常 20 秒) ダウンしていると考えられ、 +その間の転送要求に対しエラーが返ります。 +そのエラーは、宛先のホストが応じない場合は +.Li EHOSTDOWN +、ルータが応じない場合は +.Li EHOSTUNREACH +となります。 +.Pp +ARP キャッシュは、動的に生成されたホスト経路として、 +システムのルーティングテーブルに収められます。 +直接接続されているイーサネットネットワークへの経路は +.Dq 複製 +された経路 ( +.Li RTF_CLONING +フラグが立った経路) として格納され、 +そのネットワーク上の個々のホストへの経路は必要に応じて生成されます。 +これらの経路は定期的にタイムアウトします +(通常その経路が有効になってから 20 分でタイムアウトし、 +これらのエントリは使われない限り有効にはなりません)。 +応答のないホストへのエントリは +.Dq 拒否 +された経路 ( +.Li RTF_REJECT +フラグが立てられた経路) になります。 +.Pp +ARP エントリは +.Xr arp 8 +ユーティリティにより追加や削除、変更されることがあります。 +手作業で追加されたエントリには一時的なものも永続的なものもありえますし、 +.Dq 公表 +されることもあります。公表された場合、システムは ARP リクエストに対し、 +自分がそのリクエストの目的ホストであるかのように応答します。 +.Pp +以前 ARP は、トレーラカプセル化の使用を +交渉するために使われていました。 +これはもはやサポートされていません。 +.Pp +ARP は自分の振りをするホスト (つまり自分のアドレスに対する +ARP 要求に応答するホスト) を受動的に監視します。 +.Sh 診断 +.Em "arp: %x:%x:%x:%x:%x:%x is using my IP address %d.%d.%d.%d!" : +ARP はローカルネットワークに、 +違うイーサネットアドレスなのにもかかわらず +自分と同じインターネットアドレスに対する +マッピング要求に応答する別のホストを見つけました。 +一般的に、2 つのホストが同じインターネットアドレスを +使おうとしていることを示しています。 +.Pp +.Em "arp: ether address is broadcast for IP address %d.%d.%d.%d!" : +ARP はあるホストについての情報を要求し、そのホストのイーサネットアドレスが +イーサネットのブロードキャストアドレスであることを示す応答を +受け取りました。 +これはデバイスの設定ミスか、壊れていることを示しています。 +.Pp +.Em "arp: %d.%d.%d.%d moved from %x:%x:%x:%x:%x:%x to %x:%x:%x:%x:%x:%x" : +ARP は参照したホストのイーサネットアドレスをキャッシュしていますが、 +そのホストが新しいアドレスを持っていることを示す応答を受け取りました。 +これは通常ホストのハードウェアアドレスが変わったり、モバイル端末が +ローカルのサブネットに繋がれたか切り放されたときに起こります。 +またこれは代理 ARP の問題であることもあります。 +.Pp +.Em "arpresolve: can't allocate llinfo for %d.%d.%d.%d" : +参照しているホストへの経路は ARP が要求されたデバイスを指しています。 +しかし ARP はそのホストの MAC アドレスを格納する +ルーティングテーブルのエントリを割り当てることができませんでした。 +これは通常ルーティングテーブルの設定ミスを示しています。 +また、カーネルがメモリを割り当てられなかった時にも起ります。 +.Sh 関連項目 +.Xr inet 4 , +.Xr route 4 , +.Xr arp 8 , +.Xr ifconfig 8 , +.Xr route 8 +.sp +.Rs +.%A Plummer, D. +.%B "An Ethernet Address Resolution Protocol" +.%T RFC826 +.Re +.Rs +.%A Leffler, S.J. +.%A Karels, M.J. +.%B "Trailer Encapsulations +.%T RFC893 +.Re + diff --git a/ja_JP.eucJP/man/man4/asc.4 b/ja_JP.eucJP/man/man4/asc.4 new file mode 100644 index 0000000000..c816e37224 --- /dev/null +++ b/ja_JP.eucJP/man/man4/asc.4 @@ -0,0 +1,185 @@ +.\" asc(4) - manual page for the scanner device driver `asc' +.\" +.\" +.\" Copyright (c) 1995 Gunther Schadow, Luigi Rizzo. 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 acknowledgements: +.\" This product includes software developed by Gunther Schadow. +.\" This product includes software developed by Luigi Rizzo. +.\" 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. +.\" +.\" %Id: asc.4,v 1.8 1998/10/22 14:17:44 bde Exp % +.\" jpman %Id: asc.4,v 1.3 2000/08/03 06:57:17 horikawa Stab % +.Dd January 19, 1995 +.Dt ASC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm asc +.Nd GI1904 ベースのハンドスキャナ用デバイスドライバ +.Sh 書式 +.Cd "device asc0 at isa? port" \&"IO_ASC1\&" tty drq 3 irq 10 +.Sh 解説 +キャラクタ型デバイスドライバ +.Nm +は、現在のところ、 +.Tn GI1904 +ベースのハンドスキャナ (例えば Trust Amiscan Grey など) を扱います。 +このデバイスドライバは、DMA と割り込みを使用します。50 ラインまでの +スキャン入力データをドライバ中でバッファリングします。 +.Pp +このデバイスは、4 つの異なる解像度 (100, 200, 300, 400 ドット/インチ) +で動作させることができます。最上位ビットが左側に来る単純なビットマップ +を生成します。このドライバは、別途、単純な +ポータブルビットマップファイル形式 +.Xr pbm 5 +を生成させることもできます。 +これにより、ほとんどのグラフィックパッケージで、このスキャン結果を +容易に処理することが出来ます。 +.Pp +出力ビットマップの幅は、解像度の値により決まる固定の値です。しかし、 +.Xr pbm 5 +モードの場合、ビットマップの高さを指定する必要があります。これは、 +ドライバがいつ「ファイルの終端」に達するかを知っておく必要がある +からです。デフォルトでは、正方形のイメージを生成します。つまり、幅と +高さが等しいとされます。この機能により、 +.Xr cat 1 +を用いてスキャナの出力を直接 +.Xr pbm 5 +ファイルにコピーすることができます。 +このドライバを raw モードで使用する場合、 +.Xr dd 1 +コマンドを使用することにより、この効果と似た効果を得ることもできます。 +.Sh IOCTL +.Nm +に適用可能な +.Xr ioctl 2 +コマンドは次のとおりです。 +.Xr sasc 1 +により、ユーザレベルでこれらのコマンドを使用することができます。 +.Bl -tag -width "ASC_GHEIGHT" +.It Dv ASC_GRES +.Pq Li int +現在の解像度を、ドット/インチ (dpi) 単位で返します。 +.It Dv ASC_GWIDTH +.Pq Li int +現在のビットマップ幅をピクセル単位で返します。 +.It Dv ASC_SHEIGHT +.Pq Li int +.Xr pbm 5 +モードのビットマップの高さを設定します。 +実際のところ、これは、最初の読み込み処理以後スキャン可能なラインの累積数 +に対する制限です。この制限に到達すると、読み込みは 0 を返します。 +しかし、デバイスが動作を停止するのは、オープンされたファイル記述子がすべて +クローズされたときに限ります。 +.It Dv ASC_GHEIGHT +.Pq Li int +現在のビットマップの高さを返します。 +.It Dv ASC_SBLEN +.Pq Li int +DMA 転送を行なう際に内部的に使用するバッファの長さを指定します。 +バッファの長さはビットマップのライン数で指定します。バッファサイズの +制限が (現在のところ) 0x3000 バイトであるため、指定可能なライン最大数は +ラインあたりの幅により変わります。 +指定した長さがこの制限を越える場合、 +.Er ENOMEM +エラーが返されます。 +.It Dv ASC_GBLEN +.Pq Li int +現在のバッファの長さをライン数単位で返します。 +.It Dv ASC_SBTIME +.Pq Li int +バッファ 1 つへの読み込み完了までのタイムアウトを指定します。 +ハンディスキャナは人間とコンピュータ間のインタフェースであるため、 +普通は、タイムアウト値はフラットスキャナよりも大きくしておく必要が +あります。デフォルトは 15 秒です。タイムアウトに到達すると、読み込み処理は +.Er EBUSY +エラーで失敗します。 +各バッファから読み出されるごとにタイムアウトタイマが新たに開始されます。 +よって、タイマ値を減らすことにより、より長いイメージをより速くスキャン +できるようになるわけではありません。 +.It Dv ASC_GBTIME +.Pq Li int +現在のバッファタイムアウト値を返します。 +.El +.Pp +.Dv ASC_SBTIME +を除き、パラメータを変更する +.Fn ioctl +リクエストのすべては、現在進行中のスキャン処理に影響しません。ユーザは +デバイスをクローズし、再びオープンして、新しい設定が効力をあらわすよう +にする必要があります。結局のところ、デバイスのオープンクローズにより、 +パラメータの設定がリセットされることは +.Em ありません。 +.Pp +同様に、値を読み込むリクエストは、現在進行中のスキャン処理で用いられて +いる値を返しません。スキャン処理中に必要な値は、スキャン開始時に保存され、 +.Fn ioctl +リクエストではアクセスできないようになっています。 +.Pp +しかし、 +.Dv ASC_SBTIME +の値は、現在進行中のスキャン処理に即座に影響を及ぼします。これにより、 +例えば、ユーザがスキャンを開始するまではタイムアウトに大きな値を設定し、 +開始後は小さな値を設定することで、ユーザのスキャン中止に即座に反応する +ようにできます。 +.Pp +.Xr pbm 5 +と raw モードの選択は、マイナ番号により行なわれます。 +.Fn ioctl +リクエストでは行なえません。raw モードでは、指定されたビットマップの +高さは効果をあらわしません。 +.Sh 関連ファイル +.Bl -tag -width /dev/asc0pd -compact +.It Pa /dev/asc0 +raw 出力用のデバイスノード。 +.It Pa /dev/asc0d +raw 出力用のデバイスノード。 +.Dv ASCDEBUG +オプションをカーネル設定ファイルで指定した場合、デバッグメッセージが +出力されます。 +.It Pa /dev/asc0p +.Xr pbm 5 +ファイル形式出力用のデバイスノード。 +.It Pa /dev/asc0pd +.Xr pbm 5 +ファイル形式出力用かつデバッグモードのデバイスノード。 +.El +.\" +.\" .Sh 診断 +.\" +.Sh 関連項目 +.Xr sasc 1 , +.Xr pbm 5 +.Sh バグ +ioctl のサポートがまだ動作していません。 +.Sh 作者 +.Nm +ドライバは、 +Luigi Rizzo +が書きました。 +.Sh 歴史 +.Nm +ドライバが最初に現れたのは +.Fx 2.1 +です。 diff --git a/ja_JP.eucJP/man/man4/atkbd.4 b/ja_JP.eucJP/man/man4/atkbd.4 new file mode 100644 index 0000000000..a45ebafc52 --- /dev/null +++ b/ja_JP.eucJP/man/man4/atkbd.4 @@ -0,0 +1,113 @@ +.\" +.\" Copyright (c) 1999 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: atkbd.4,v 1.1.2.2 1999/02/10 14:49:51 yokota Exp % +.\" jpman %Id: atkbd.4,v 1.3 1999/08/15 14:21:26 horikawa Stab % +.\" +.Dd February 9, 1999 +.Dt ATKBD 4 +.Os FreeBSD +.Sh 名称 +.Nm atkbd +.Nd +AT キーボードのインタフェース +.Sh 書式 +.Cd "device atkbd0 at isa? tty irq 1" +.Sh 解説 +.Nm +ドライバは +.Nm atkbdc +ドライバと共に、AT キーボードコントローラに接続された +AT 84キーボードや AT 拡張キーボードを利用できるようにします。 +.Pp +このドライバはコンソールドライバ +.Xr syscons 4 +もしくは +.Xr pcvt 4 +のために必要です。 +.Pp +カーネル設定ファイルには +.Nm +デバイスを 1 つだけ定義することができます。 +また、このデバイスが機能するためには +.Nm atkbdc +キーボードコントローラが必要です。 +.Em irq +は常に 1 であることが必要で、変えることはできません。 +.Sh ドライバの設定 +.\".Ss カーネル設定オプション +.Ss ドライバのフラグ +.Nm +ドライバは次のドライバフラグを受け付けます。 +これらはカーネル設定ファイル +.Pq Xr config 8 参照 +か、もしくはブート時のユーザ設定メニュー +.Pq Xr boot 8 参照 +で指定できます。 +.Bl -tag -width FAIL +.It bit 0 (FAIL_IF_NO_KBD) +デフォルトでは、たとえ実際にはキーボードが接続されていなくても、 +.Nm +ドライバはインストールされます。 +このオプションは、このような状況ではドライバをインストールしないようにします。 +.It bit 1 (NO_RESET) +このオプションが与えられると、 +.Nm +ドライバは初期化の際にキーボードをリセットしません。 +ファンクションキーが特別な機能を持っていて、キーボードをリセットすると +機能が失われるようなラップトップコンピュータで、役に立つかもしれません。 +.It bit 2 (ALT_SCANCODESET) +ThinkPad のいくつかのモデルのキーボードのように、キーボードのなかには +古い XT キーボードのように振舞うものがあります。このようなキーボードでは +このオプションが必要です。 +.El +.\".Sh FILES +.\".Sh EXAMPLE +.\".Sh DIAGNOSTICS +.\".Sh CAVEATS +.\".Sh BUGS +.Sh 関連項目 +.Xr atkbdc 4 , +.Xr pcvt 4 , +.Xr psm 4 , +.Xr syscons 4 , +.Xr boot 8 , +.Xr config 8 +.Sh 歴史 +.Nm +ドライバは +.Fx 3.1 +に初めて登場しました。 +.Sh 作者 +.Nm +ドライバは +.ie t .An S\(/oren Schmidt Aq sos@FreeBSD.org +.el .An Soren Schmidt Aq sos@FreeBSD.org +と +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。このマニュアルページは +.An Kazutaka Yokota +が書きました。 diff --git a/ja_JP.eucJP/man/man4/atkbdc.4 b/ja_JP.eucJP/man/man4/atkbdc.4 new file mode 100644 index 0000000000..1a017b143e --- /dev/null +++ b/ja_JP.eucJP/man/man4/atkbdc.4 @@ -0,0 +1,118 @@ +.\" +.\" Copyright (c) 1999 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: atkbdc.4,v 1.1.2.2 1999/02/10 14:49:51 yokota Exp % +.\" jpman %Id: atkbdc.4,v 1.3 1999/08/15 14:21:23 horikawa Stab % +.\" +.Dd February 9, 1999 +.Dt ATKBDC 4 +.Os FreeBSD +.Sh 名称 +.Nm atkbdc +.Nd +AT キーボードコントローラのインタフェース +.Sh 書式 +.Cd "options" \&"KBD_RESETDELAY=N\&" +.Cd "options" \&"KBD_MAXWAIT=N\&" +.Cd "options" \&"KBDIO_DEBUG=N\&" +.Cd "controller atkbdc0 at isa? port IO_KBD tty" +.Sh 解説 +キーボードコントローラ +.Nm +は AT キーボードや PS/2 マウス形式のポインティングデバイスへの +I/O サービスを提供します。 +このコントローラはキーボードドライバ +.Nm atkbd +と PS/2 ポインティングデバイスドライバ +.Nm psm +のために必要です。 +.Pp +システム中には +.Nm +デバイスを 1 つだけ設定することができます。 +.Sh ドライバの設定 +.Ss カーネル設定オプション +.Nm +ドライバを制御するために、次のカーネル設定オプションが使えます。 +これらはカーネル設定ファイル +.Pq Xr config 8 参照 +で指定できます。 +.Bl -tag -width MOUSE +.It Em KBD_RESETDELAY=X, KBD_MAXWAIT=Y +キーボードドライバ +.Nm atkbd +やポインティングデバイスドライバ +.Nm psm +は、ブート時に +.Nm +ドライバを通じてデバイスをリセットします。 +これらのデバイスがリセットコマンドに応答するのに +時間がかかることがあります。 +これらのオプションは、 +.Nm +ドライバが応答を待つのをあきらめるまでの時間を設定します。 +ドライバは最大で +.Fa X +* +.Fa Y +ミリ秒待ちます。 +もしドライバがデバイスを検出できないようなら、 +これらの値を増やすと良いかもしれません。 +デフォルトの値は +.Fa X +が 200 ミリ秒で、 +.Fa Y +が 5 です。 +.It Em KBDIO_DEBUG=N +デバッグレベルを +.Fa N +にします。 +デフォルトは 0 で、すべてのデバッグ出力は抑制されます。 +.El +.\".Ss Driver Flags +.\".Sh FILES +.\".Sh EXAMPLE +.\".Sh DIAGNOSTICS +.\".Sh CAVEATS +.\".Sh BUGS +.Sh 関連項目 +.Xr atkbd 4 , +.Xr psm 4 , +.Xr config 8 +.Sh 歴史 +.Nm +ドライバは +.Fx 3.1 +に初めて登場しました。 +これは +.Fx 2.2 +の kbdio モジュールに基づいています。 +.Sh 作者 +kbdio モジュールと +.Nm +ドライバ、およびこのマニュアルページは +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。 diff --git a/ja_JP.eucJP/man/man4/ax.4 b/ja_JP.eucJP/man/man4/ax.4 new file mode 100644 index 0000000000..f0bcc65a49 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ax.4 @@ -0,0 +1,153 @@ +.\" Copyright (c) 1997, 1998, 1999 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ax.4,v 1.2 1999/01/18 17:26:01 wpaul Exp % +.\" jpman %Id: ax.4,v 1.3 1999/11/28 15:53:12 horikawa Stab % +.\" +.Dd January 2, 1999 +.Dt AX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ax +.Nd +ASIX Electronics AX88140A ファストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device ax0" +.Sh 解説 +.Nm +ドライバは、ASIX AX88140A ファストイーサネットコントローラチップを用いた +PCI イーサネットアダプタと組み込みコントローラをサポートします。これには、 +Alfa Inc. の GFC2204 や、CNet の Pro110B が含まれます。 +.Pp +この ASIX チップはバスマスタ DMA を使用し、DEC 21x4x 類似になるように +設計されています。DEC チップと ASIX チップの唯一の大きな違いは、ASIX +の受信器のフィルタが 2 つの特殊なレジスタを用いてプログラミングするの +に対し、DEC チップでは送信器の DMA エンジン経由で、特別のセットアップ +フレームをアップロードすることです。ASIX 受信フィルタは、 +ローカルステーションのアドレスに対するフィルタエントリまるごと 1 つと +64 ビットのマルチキャストハッシュテーブル 1 つだけをプログラミング +できます。一方、DEC のフィルタは、他にいくつかのオプションを +サポートします。ASIX ファストイーサネットコントローラは、外部 MII +トランシーバを使用することで、全 2 重もしくは半 2 重において、 +10Mbps と 100Mbps の両方の速度をサポートします。 +.Pp +.Nm +ドライバは次に示すメディアタイプをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択機能を使用します。 +メディアオプションを +.Pa /etc/rc.conf +ファイルに追加することにより、自動選択されたモードをユーザ自身が変更 +することができます。 +.It 10baseT/UTP +10Mbps 動作を設定します。 +.Ar mediaopt +オプションを指定して、 +.Ar full-duplex +モードか +.Ar half-duplex +モードのいずれかを指定することもできます。 +.It 100baseTX +100Mbps (ファストイーサネット) 動作を設定します。 +.Ar mediaopt +オプションを指定して、 +.Ar full-duplex +モードか +.Ar half-duplex +モードのいずれかを指定することもできます。 +.El +.Pp +.Nm +ドライバは、次に示すメディアオプションをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +強制的に全 2 重動作を指定します。 +.It half-duplex +強制的に半 2 重動作を指定します。 +.El +.Pp +このデバイスの設定に関しこれ以上の情報が必要ならば、 +.Xr ifconfig 8 +を参照して下さい。 +.Sh 診断 +.Bl -diag +.It "ax%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "ax%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "ax%d: watchdog timeout" +このデバイスはネットワークへの応答を停止しました。もしくは、ネットワーク +への接続 (ケーブル) に問題があります。 +.It "ax%d: no memory for rx list" +ドライバが、受信データのリングバッファへの mbuf 割り当てに失敗しました。 +.It "ax%d: no memory for tx list" +ドライバが、パッドバッファ割り当ての際、もしくは mbuf チェーンをクラスタへ +入れる際に、送信データのリングバッファへの mbuf 割り当てに失敗しました。 +.It "ax%d: chip is in D3 power state -- setting to D0" +このメッセージは電力管理をサポートしているアダプタのみに適用されます。 +オペレーティングシステムによっては、シャットダウンの際にコントローラを +ローパワーモードにするものがあります。PCI BIOS の中には、チップに設定 +する前に、チップをこの状態から元に戻すことができないものがあります。 +D3 状態では、コントローラは自分の PCI 設定情報のすべてを失って +しまいますので、BIOS が間に合うようにフルパワーモードに戻さなかった場合、 +正しくコントローラを設定できなくなります。ドライバはこの状態を検知して +アダプタを D0 (フルパワー) 状態に戻そうとします。しかし、完全に動作する +状況にドライバを戻すためには、これだけでは不十分である可能性があります。 +起動時にこのメッセージが出てきて、ドライバがこのデバイスを +ネットワークインタフェースとしてアタッチし損なう場合、デバイスを正しく +設定させるために、もう 1 回ウォームブートさせる必要があります。 +.Pp +この条件は、他のオペレーティングシステムの後にウォームブートさせる場合 +のみ生じます。 +.Fx +をブートする前にシステムの電源を切る場合、 +カードは正しく設定されるはずです。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Rs +.%T ASIX AX81140A データシート +.%O http://www.asix.com.tw +.Re +.Sh 歴史 +.Nm +デバイスドライバは、 +.Fx 3.0 +で初めて現れました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/bktr.4 b/ja_JP.eucJP/man/man4/bktr.4 new file mode 100644 index 0000000000..73f257c4b0 --- /dev/null +++ b/ja_JP.eucJP/man/man4/bktr.4 @@ -0,0 +1,95 @@ +.\" +.\" %Id: bktr.4,v 1.2 1998/11/04 22:13:35 nsouch Exp % +.\" jpman %Id: bktr.4,v 1.3 2000/01/03 03:15:16 horikawa Stab % +.\" +.Dd January 28, 1998 +.br +.in +0.5i +.Dt BKTR 4 i386 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm brooktree +.Nd ビデオキャプチャドライバ +.Sh 書式 +.Nm device bktr0 +.Pp +.Nm controller iicbus0 +.Nm controller iicbb0 +.Nm controller smbus0 +.Sh 解説 +.Nm bktr +ドライバは、低コスト、高パフォーマンスのボードで PCI +.Em ビデオ +キャプチャを提供します。 +このドライバは、Matrox Meteor ドライバに基づいています。 +bktr ドライバは +.Em Brooktree Bt848 Video Capture Chip +が載っているビデオカードのほとんどをサポートします。 +.Pp +特に、次のカードが動作することが分かっています: +.br +.Em Hauppage Wincast TV +.br +.Em STB TV PCI Television Tuner +.br +.Em Miro PC TV +.br +.Em Intel Smart Video Recorder III +.Pp +このドライバは現在、次の機能をサポートします: +.br +.in +0.5i +PCI から PCI への DMA 転送 +.br +クリッピング +.br +yuv +.br +rgb16 +.br +rgb24 +.br +rgb32 +.in -0.5i +.Pp +これらのカードでは、チューナとほかの部品が I2C バスで内部接続されてい +ます。Brooktree848 チップは、そのバス上でそれらの部品をコントロールす +るマスタデバイスとして動作しています。 +従って、 +.Xr iicbus 4 , +.Xr iicbb 4 +と +.Xr smbus 4 +コントローラの宣言はアクティブな bktr サポートに必須です。 +.Pp +次のカーネルパラメータがドライバのさらなる設定に使用可能です: +.Pp +.Em options "BROOKTREE_ALLOC_PAGES=xxx" +はプローブに成功したときに、割り当てる連続したページの数を指定します。 +カーネルが割り当てるページの数のデフォルトは 216 です。 +これは、(216*4096) バイト使用可能であることを示しています。 +.Pp +.Sh 作者 +このドライバは +.An Jim Lowe Aq james@miller.cs.uwm.edu , +.An Mark Tinguely Aq tinguely@plains.nodak.edu , +.An Amancio Hasty Aq hasty@star-gate.com +とその他の人々の作業に基づいています。 +.Sh 関連ファイル +.Bl -tag -width /usr/share/examples/meteor -compact +.It Pa /usr/share/examples/meteor +Meteor ドライバ (よく似た設計である) でできることの例 +.It Pa /usr/ports/graphics/fxtv +bktr ドライバを利用する表示プログラム - +.Em The X Window System +と +.Em The Ports Collection +がインストールされている必要があります。 +.El +.Sh 関連項目 +.Xr meteor 4 +.Sh 歴史 +.Nm +ドライバは +.Fx 2.2 +で初めて現れました。 diff --git a/ja_JP.eucJP/man/man4/bpf.4 b/ja_JP.eucJP/man/man4/bpf.4 new file mode 100644 index 0000000000..dd799bc337 --- /dev/null +++ b/ja_JP.eucJP/man/man4/bpf.4 @@ -0,0 +1,740 @@ +.\" Copyright (c) 1990 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that: (1) source code distributions +.\" retain the above copyright notice and this paragraph in its entirety, (2) +.\" distributions including binary code include the above copyright notice and +.\" this paragraph in its entirety in the documentation or other materials +.\" provided with the distribution, and (3) all advertising materials mentioning +.\" features or use of this software display the following acknowledgement: +.\" ``This product includes software developed by the University of California, +.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of +.\" the University nor the names of its contributors may be used to endorse +.\" or promote products derived from this software without specific prior +.\" written permission. +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED +.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" This document is derived in part from the enet man page (enet.4) +.\" distributed with 4.3BSD Unix. +.\" +.\" %Id: bpf.4,v 1.16 1999/01/10 04:59:59 danny Exp % +.\" jpman %Id: bpf.4,v 1.3 2000/09/03 14:51:07 yt-kage Stab % +.\" +.\" WORD: promiscuous 無差別な +.\" WORD: alignment 境界調整 [POSIX] +.\" WORD: addressing mode アドレッシングモード +.\" WORD: padding パディング +.\" WORD: truncation amount 切り詰め量 +.Dd January 16, 1996 +.Dt BPF 4 +.Os BSD 4.4 +.Sh 名称 +.Nm bpf +.Nd バークレイパケットフィルタ +.Sh 書式 +.Cd pseudo-device bpfilter +.Sh 解説 +バークレイパケットフィルタは、データリンク層においてプロトコル非依存の +生の形のインターフェースを提供します。 +ネットワーク上のパケットは、たとえ他のホストに向けられた +ものであっても、すべてこの機構を通してアクセスすることができます。 +.Pp +このパケットフィルタは +.Pa /dev/bpf0 , +.Pa /dev/bpf1 +などの +キャラクタ型特殊デバイスに見えます。 +このデバイスをオープンした後、ファイル記述子は +.Dv BIOCSETIF +ioctl によって、特定のネットワークインタフェースに結びつけなければなりません。 +指示されたインタフェースは複数の監視者で共有することができ、 +各記述子の下にあるフィルタは、同じパケットの流れを見ることになります。 +オープンできるファイルの上限は、 +カーネルの設定で与えられた値に制限されます。 +上の +.Sx 書式 +で与えられた例では、制限は 16 になっています。 +.Pp +それぞれのマイナデバイスには、別々のデバイスファイルが必要です。 +デバイスファイルが使用中であるならば、オープンは失敗し、 +.Va errno +には +.Er EBUSY がセットされます。 +.Pp +オープンされた +.Nm bpf +ファイルの実体それぞれに関連づけられているのが、 +ユーザが設定可能なパケットフィルタです。 +あるインタフェースでパケットを受信したときはいつでも、そのインタフェースを +監視しているファイル記述子はすべて自身のフィルタを適用します。 +パケットを受け取る各記述子は、自分用のコピーを受け取ります。 +.Pp +それぞれのファイルからの入力は、フィルタでマッチしたパケットの +次のグループを返します。 +性能を上げるために、read に渡すバッファは +.Nm +が内部で使用するバッファと同じサイズでなければなりません。 +このサイズは、 +.Dv BIOCGBLEN +ioctl (下記を参照) で得られ、 +.Dv BIOCSBLEN +で設定できます。 +このサイズより大きい個々のパケットは、 +必然的に切り詰められてしまうことに注意して下さい。 +.Pp +このパケットフィルタは、固定長ヘッダであれば +どのリンクレベルプロトコルでもサポートします。 +今のところ、イーサネットと +.Tn SLIP +と +.Tn PPP +ドライバだけが +.Nm bpf +と協調して動作するように修正されています。 +.Pp +パケットデータはネットワークバイトオーダになっているので、 +アプリケーションが複数バイトの値を引き出すためには +.Xr byteorder 3 +マクロを使わなければなりません。 +.Pp +.Nm bpf +ファイル記述子に書き込むことでネットワークにパケットを +送出することができます。 +書き込みはバッファリングされないので、1 回の書き込みにつき +1 つのパケットだけしか処理されません。 +現在イーサネットと +.Tn SLIP +リンクへの書き込みだけがサポートされています。 +.Sh IOCTL +次のような +.Xr ioctl 2 +コマンドコードが で定義されています。すべてのコマンドには +次のようなインクルードファイルが必要です。 +.Bd -literal + #include + #include + #include + #include +.Ed +.Pp +さらに、 +.Dv BIOCGETIF +と +.Dv BIOCSETIF +は、 +.Aq Pa sys/socket.h +と +.Aq Pa net/if.h +を必要とします。 + +.Dv FIONREAD +と +.Dv SIOCGIFADDR +以外にも、次のようなコマンドを +オープンした +.Nm +ファイルに適用できます。 +.Xr ioctl 2 +への (3 番目の) 引数は、 +指定の型へのポインタでなければなりません。 + +.Bl -tag -width BIOCGRTIMEOUT +.It Dv BIOCGBLEN +.Pq Li u_int +.Nm +ファイル上で読み込みを行うために必要なバッファ長を返します。 +.It Dv BIOCSBLEN +.Pq Li u_int +.Nm +ファイル上で読み込みを行うためのバッファ長を設定します。バッファは、ファイルが +.Dv BIOCSETIF +によってインタフェースに接続される前に設定されなければなりません。 +要求されたバッファサイズが適用できなかった場合は、 +許容できるサイズで最も近いものに設定され、それが引数の中に返されます。 +このサイズでないパケットがバッファを通ったときには、 +読み込みコールは +.Er EIO +の値で終了します。 +.It Dv BIOCGDLT +.Pq Li u_int +接続されたインタフェースの下にあるデータリンク層の型を返します。 +インタフェースが指定されていなかった場合 +.Er EINVAL +が返されます。 +デバイスの型は、 +.Dq Li DLT_ +が前に付いた形であり、 +.Aq Pa net/bpf.h +で定義されています。 +.It Dv BIOCPROMISC +強制的にインタフェースを無差別 (promiscuous) モードにします。 +ローカルホストに向けられたもののみならずすべてのパケットが処理されます。 +複数のファイルが与えられたインタフェースを監視することができるので、 +そのインタフェースを無差別でないモードでオープンした監視者でも +パケットを無差別に受信することができてしまいます。 +この問題は適当なフィルタで矯正することができます。 +.It Dv BIOCFLUSH +到着パケットのバッファをフラッシュし、BIOCGSTATS で返される +集計値をリセットします。 +.It Dv BIOCGETIF +.Pq Li "struct ifreq" +ファイルが監視しているハードウェアインタフェースの名前を返します。 +名前は +.Li ifreq +構造体の ifr_name フィールドに返されます。 +他のフィールドはすべて未定義となります。 +.It Dv BIOCSETIF +.Pq Li "struct ifreq" +ファイルに関連付けるハードウェアインタフェースを設定します。 +このコマンドは、どんなパケットを読み込むよりも前に +実行されなければいけません。 +デバイスは、 +.Li ifreq +構造体の +.Li ifr_name +フィールドを使って名前で示されます。 +さらに +.Dv BIOCFLUSH +の動作を実行します。 +.It Dv BIOCSRTIMEOUT +.It Dv BIOCGRTIMEOUT +.Pq Li "struct timeval" +タイムアウトパラメータを設定または取得します。 +引数には、読み込み要求でタイムアウトするまでの +待ち時間の長さを指定します。 +このパラメータは、 +.Xr open 2 +により 0 に初期化され、タイムアウトしないことを指示します。 +.It Dv BIOCGSTATS +.Pq Li "struct bpf_stat" +パケット集計値の次の構造体を返します: +.Bd -literal +struct bpf_stat { + u_int bs_recv; /* 受信したパケット数 */ + u_int bs_drop; /* 落としたパケット数 */ +}; +.Ed +.Pp +フィールドは次のようになります: +.Bl -hang -offset indent +.It Li bs_recv +オープンまたはリセット後に、この記述子によって受信したパケット数 +(最後の読み込みコールからバッファされているものを含みます)。 +.It Li bs_drop +フィルタが受け取りはしたが、バッファのオーバフローにより +カーネルが落としたパケットの数 +(つまり、アプリケーションの読み込みがパケットの流量に追いついていない +ということです)。 +.El +.It Dv BIOCIMMEDIATE +.Pq Li u_int +引数の真偽値に基づいて ``直接モード'' を有効または無効にします。 +直接モードが有効なとき、パケットを受け取ると読み込みは +ただちに返されます。無効なとき、入力はカーネルバッファがいっぱいになるか、 +またはタイムアウトが起こるまでブロックされます。 +これは、リアルタイムにメッセージに応答しなければならない +.Xr rarpd 8 +のようなプログラムには便利です。 +新しいファイルに対しては、デフォルトではオフになります。 +.It Dv BIOCSETF +.Pq Li "struct bpf_program" +興味のないパケットを捨てるために +カーネルが使うフィルタプログラムを設定します。 +次の構造体を通して命令を並べた配列とその長さが渡されます: +.Bd -literal +struct bpf_program { + int bf_len; + struct bpf_insn *bf_insns; +}; +.Ed + +フィルタプログラムは +.Li bf_insns +フィールドで指定され、 +.Sq Li struct bpf_insn +の構造体中におけるプログラムの長さが +.Li bf_len +フィールドで与えられます。 +そして、 +.Dv BIOCFLUSH +の動作が実行されます。 +フィルタ言語の説明については +.Sx フィルタマシン +のセクションを見て下さい。 +.It Dv BIOCVERSION +.Pq Li "struct bpf_version" +現在カーネルに認識されているフィルタ言語のメジャーおよび +マイナバージョン番号を返します。フィルタをインストールする前に、 +アプリケーションは、動作しているカーネルと現在のバージョンとが +互換性があるかどうかを調べなければなりません。 +メジャー番号が一致し、アプリケーションのマイナ番号が +カーネルのマイナ番号に等しいか、それ以下ならバージョン番号は互換性が +あります。 +カーネルのバージョン番号は以下の構造体で返されます: +.Bd -literal +struct bpf_version { + u_short bv_major; + u_short bv_minor; +}; +.Ed +.Pp +現在のバージョン番号は +.Aq Pa net/bpf.h +中の +.Dv BPF_MAJOR_VERSION +と +.Dv BPF_MINOR_VERSION +によって与えられます。 +互換性のないフィルタでは、予期しない動作に終わるかもしれません +(最もありそうなのは、 +.Fn ioctl +によってエラーが返されるか、または偶然にパケットが一致することです) 。 +.Sh BPF ヘッダ +.Xr read 2 +によって返される各パケットの先頭には、 +次のような構造体がつけられています: +.Bd -literal +struct bpf_hdr { + struct timeval bh_tstamp; /* タイムスタンプ */ + u_long bh_caplen; /* キャプチャされた部分の長さ */ + u_long bh_datalen; /* パケットのオリジナルの長さ */ + u_short bh_hdrlen; /* bpf ヘッダの長さ (この構造体 + + 境界調整パディング) */ +}; +.Ed +.Pp +フィールドはホスト順で保存されており、次のようになります: +.Pp +.Bl -tag -compact -width bh_datalen +.It Li bh_tstamp +パケットフィルタによって、そのパケットが処理された時刻 +.It Li bh_caplen +パケットのキャプチャされた部分の長さ。 +これは切り詰め量の最小値で、 +フィルタとパケット長によって指定されています。 +.It Li bh_datalen +経路から離れたパケット長。 +この値はフィルタで指定された切り詰め量には依存しません。 +.It Li bh_hdrlen +.Nm +ヘッダの長さ。これは +.\" XXX - not really a function call +.Fn sizeof "struct bpf_hdr" +に等しいとは限りません。 +.El +.Pp +.Li bh_hdrlen +フィールドはヘッダとリンクレベルプロトコル間の +パディングのために存在します。この目的は、 +パケットデータ構造の適切な境界調整を保証することです。 +これは、 +境界調整に厳しいアーキテクチャが必要とすることであり、 +また、これによって他の多くのアーキテクチャにおける性能が向上します。 +パケットフィルタは +.Li bpf_hdr +とネットワーク層のヘッダがワード境界になることを保証します。 +境界調整が制約されたマシン上でリンク層プロトコルをアクセス +するときには、適切な注意を払わなければなりません +(これはイーサネット上では問題にはなりません。なぜなら、 +フィールドの型が short であり偶数オフセットに落ち着きますし、 +アドレスがおそらくバイト単位でアクセスされるからです)。 +.Pp +さらに、個々のパケットはワード境界で始まるようにパディングされます。 +これにより、アプリケーションはパケットから次のパケットを得る方法を +知っていることが要求されます。 +このプロセスを手助けするために、マクロ +.Dv BPF_WORDALIGN +が +.Aq Pa net/bpf.h +中で定義されています。 +引数は最も近いワード境界値 (ワードが +.Dv BPF_ALIGNMENT +バイト幅) に切り上げられます。 +.Pp +例えば +.Sq Li p +がパケットの先頭を指すとき、次の表現は +ポインタを次のパケットへ進めます: +.Dl p = (char *)p + BPF_WORDALIGN(p->bh_hdrlen + p->bh_caplen) +.Pp +境界調整の機構を適切に動作させるために +.Xr read 2 +に渡されるバッファは、それ自身がワード境界になければなりません。 +.Xr malloc 3 +関数は常にワード境界のバッファを返します。 +.Sh フィルタマシン +フィルタプログラムは命令を並べた配列であり、すべての分岐が +コードの前方に向かうものであり、また、 +.Em return +命令で終わるものです。 +各命令は、アキュムレータ、インデックスレジスタ、一時メモリ記憶、 +および暗黙のプログラムカウンタから成る疑似マシン状態上で +何らかの動作を行ないます。 + +次の構造体が命令フォーマットの定義です: +.Bd -literal +struct bpf_insn { + u_short code; + u_char jt; + u_char jf; + u_long k; +}; +.Ed + +.Li k +フィールドは命令によって異なる用法で用いられ、 +.Li jt +と +.Li jf +フィールドは分岐命令によってオフセットとして用いられます。 +操作コードは半階層的な形で符号化されます。 +命令には 8 つのクラス +.Dv BPF_LD , +.Dv BPF_LDX , +.Dv BPF_ST , +.Dv BPF_STX , +.Dv BPF_ALU , +.Dv BPF_JMP , +.Dv BPF_RET , +.Dv BPF_MISC +があります。 +他のいろいろなモードと操作ビットは実際の命令を与えるために +ビット加算 (or) され、クラスに変換されます。 +クラスとモードは +.Aq Pa net/bpf.h +内で定義されています。 + +以下は定義されたそれぞれの +.Nm +命令です。 +便宜的に A がアキュムレータ、X がインデックスレジスタ、 +P[] がパケットデータ、M[] が寄せ集めの一時メモリ記憶であるとします。 +P[i:n] はパケット内の ``i'' バイトオフセットのデータを指し、 +ワード (n=4)、符号無し半ワード (n=2)、符号無しバイト (n=1) +に翻訳されます。 +M[i] は、一時メモリ記憶の中で i 番目のワードを指し、ワード単位の +アドレスだけが割り振られます。メモリ記憶は 0 から +.Dv BPF_MEMWORDS +- 1 に番号付けされます。 +.Li k , +.Li jt , +.Li jf +は、命令定義の中で対応するフィールドになります。``len'' は、 +パケット長を参照します。 +.Pp +.Bl -tag -width BPF_STXx -compact +.It Dv BPF_LD +これらの命令は、値をアキュムレータに複写します。 +ソースオペランドの型は、``アドレッシングモード'' で指定され、 +定数 +.Pq Dv BPF_IMM +でも、固定オフセットのパケットデータ +.Pq Dv BPF_ABS +、可変オフセットのパケットデータ +.Pq Dv BPF_IND +、パケット長 +.Pq Dv BPF_LEN +、一時メモリ記憶内のワード +.Pq Dv BPF_MEM +をとり得ます。 +.Dv BPF_IND +と +.Dv BPF_ABS +の場合、データサイズは、ワード +.Pq Dv BPF_W +、ハーフワード +.Pq Dv BPF_H +、バイト +.Pq Dv BPF_B +のいずれかでなければなりません。 +使用可能な全 +.Dv BPF_LD +命令の意味は次の通りです。 +.Pp +.Bl -tag -width "BPF_LD+BPF_W+BPF_IND" -compact +.It Li BPF_LD+BPF_W+BPF_ABS +A <- P[k:4] +.It Li BPF_LD+BPF_H+BPF_ABS +A <- P[k:2] +.It Li BPF_LD+BPF_B+BPF_ABS +A <- P[k:1] +.It Li BPF_LD+BPF_W+BPF_IND +A <- P[X+k:4] +.It Li BPF_LD+BPF_H+BPF_IND +A <- P[X+k:2] +.It Li BPF_LD+BPF_B+BPF_IND +A <- P[X+k:1] +.It Li BPF_LD+BPF_W+BPF_LEN +A <- len +.It Li BPF_LD+BPF_IMM +A <- k +.It Li BPF_LD+BPF_MEM +A <- M[k] +.El + +.It Dv BPF_LDX +これらの命令は値をインデックスレジスタにロードします。 +この命令のときのアドレッシングモードは、アキュムレータへのロード +時よりも厳密ですが、IP ヘッダ長をロードする効果的な方法である +.Dv BPF_MSH +を含んでいることに注目して下さい。 + +.Bl -tag -width "BPF_LDX+BPF_W+BPF_MEM" -compact +.It Li BPF_LDX+BPF_W+BPF_IMM +X <- k +.It Li BPF_LDX+BPF_W+BPF_MEM +X <- M[k] +.It Li BPF_LDX+BPF_W+BPF_LEN +X <- len +.It Li BPF_LDX+BPF_B+BPF_MSH +X <- 4*(P[k:1]&0xf) +.El + +.It Dv BPF_ST +この命令はアキュムレータを一時メモリに退避します。 +行き先の可能性が一つしかないのでアドレッシングモードは不要です。 + +.Bl -tag -width "BPF_ST" -compact +.It Li BPF_ST +M[k] <- A +.El + +.It Dv BPF_STX +この命令はインデックスレジスタを一時メモリに退避します。 + +.Bl -tag -width "BPF_STX" -compact +.It Li BPF_STX +M[k] <- X +.El + +.It Dv BPF_ALU +alu 命令は、アキュムレータとインデックスレジスタまたは定数間の +操作を実行し、結果をアキュムレータに戻します。 +バイナリ操作のためにはソースモードが必要です +.Po +.Dv BPF_K +または +.Dv BPF_X +.Pc 。 + +.Bl -tag -width "BPF_ALU+BPF_MUL+BPF_K" -compact +.It Li BPF_ALU+BPF_ADD+BPF_K +A <- A + k +.It Li BPF_ALU+BPF_SUB+BPF_K +A <- A - k +.It Li BPF_ALU+BPF_MUL+BPF_K +A <- A * k +.It Li BPF_ALU+BPF_DIV+BPF_K +A <- A / k +.It Li BPF_ALU+BPF_AND+BPF_K +A <- A & k +.It Li BPF_ALU+BPF_OR+BPF_K +A <- A | k +.It Li BPF_ALU+BPF_LSH+BPF_K +A <- A << k +.It Li BPF_ALU+BPF_RSH+BPF_K +A <- A >> k +.It Li BPF_ALU+BPF_ADD+BPF_X +A <- A + X +.It Li BPF_ALU+BPF_SUB+BPF_X +A <- A - X +.It Li BPF_ALU+BPF_MUL+BPF_X +A <- A * X +.It Li BPF_ALU+BPF_DIV+BPF_X +A <- A / X +.It Li BPF_ALU+BPF_AND+BPF_X +A <- A & X +.It Li BPF_ALU+BPF_OR+BPF_X +A <- A | X +.It Li BPF_ALU+BPF_LSH+BPF_X +A <- A << X +.It Li BPF_ALU+BPF_RSH+BPF_X +A <- A >> X +.It Li BPF_ALU+BPF_NEG +A <- -A +.El + +.It Dv BPF_JMP +ジャンプ命令はフロー制御を変更します。条件ジャンプは +アキュムレータと、定数 +.Pq Dv BPF_K +またはインデックスレジスタ +.Pq Dv BPF_X +間の比較を行ないます。 +結果が真 (つまり非 0) であった場合に真の分岐が選択され、 +そうでなければ偽の分岐が選択されます。 +ジャンプオフセットは 8 ビットに符号化されるので、 +最長ジャンプは 256 命令分です。 +しかし、常時ジャンプ操作コード +.Pq Dv BPF_JA +は、オフセットとして 32 ビットの +.Li k +フィールドを使用し、離れた任意の行き先を許します。 +すべての条件は慣習的に符号無し比較を用います。 + +.Bl -tag -width "BPF_JMP+BPF_KSET+BPF_X" -compact +.It Li BPF_JMP+BPF_JA +pc += k +.It Li BPF_JMP+BPF_JGT+BPF_K +pc += (A > k) ? jt : jf +.It Li BPF_JMP+BPF_JGE+BPF_K +pc += (A >= k) ? jt : jf +.It Li BPF_JMP+BPF_JEQ+BPF_K +pc += (A == k) ? jt : jf +.It Li BPF_JMP+BPF_JSET+BPF_K +pc += (A & k) ? jt : jf +.It Li BPF_JMP+BPF_JGT+BPF_X +pc += (A > X) ? jt : jf +.It Li BPF_JMP+BPF_JGE+BPF_X +pc += (A >= X) ? jt : jf +.It Li BPF_JMP+BPF_JEQ+BPF_X +pc += (A == X) ? jt : jf +.It Li BPF_JMP+BPF_JSET+BPF_X +pc += (A & X) ? jt : jf +.El + +.It Dv BPF_RET +リターン命令はフィルタプログラムを終了し、受信するパケットの量を +指定します (すなわち、切り詰め量を返します)。 +戻り値 0 は、そのパケットが無視されるべきであることを表しています。 +戻り値は定数 +.Pq Dv BPF_K +またはアキュムレータ +.Pq Dv BPF_A +のいずれかです。 + +.Bl -tag -width "BPF_RET+BPF_K" -compact +.It Li BPF_RET+BPF_A +A バイト受信 +.It Li BPF_RET+BPF_K +k バイト受信 +.El + +.It Dv BPF_MISC +上記のクラスに適合しないものや、追加されるべき新しい命令 +のために、その他のカテゴリが作られました。 +現在、インデックスレジスタをアキュムレータに複写する、 +またはその逆を行なうレジスタ転送命令があります。 + +.Bl -tag -width "BPF_MISC+BPF_TAX" -compact +.It Li BPF_MISC+BPF_TAX +X <- A +.It Li BPF_MISC+BPF_TXA +A <- X +.El +.Pp +.Nm +インタフェースは、配列の初期化を手助けする次のマクロを提供しています: +.Fn BPF_STMT opcode operand +と +.Fn BPF_JUMP opcode operand true_offset false_offset +.Pp +.Sh 使用例 +以下のフィルタが RARP デーモンから取得されます。フィルタは、 +RARP 要求のみを受信します。 +.Bd -literal +struct bpf_insn insns[] = { + BPF_STMT(BPF_LD+BPF_H+BPF_ABS, 12), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, ETHERTYPE_REVARP, 0, 3), + BPF_STMT(BPF_LD+BPF_H+BPF_ABS, 20), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, REVARP_REQUEST, 0, 1), + BPF_STMT(BPF_RET+BPF_K, sizeof(struct ether_arp) + + sizeof(struct ether_header)), + BPF_STMT(BPF_RET+BPF_K, 0), +}; +.Ed +.Pp +このフィルタは 128.3.112.15 と 128.3.112.35 の間の IP パケット +だけを受け取ります。 +.Bd -literal +struct bpf_insn insns[] = { + BPF_STMT(BPF_LD+BPF_H+BPF_ABS, 12), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, ETHERTYPE_IP, 0, 8), + BPF_STMT(BPF_LD+BPF_W+BPF_ABS, 26), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 0x8003700f, 0, 2), + BPF_STMT(BPF_LD+BPF_W+BPF_ABS, 30), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 0x80037023, 3, 4), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 0x80037023, 0, 3), + BPF_STMT(BPF_LD+BPF_W+BPF_ABS, 30), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 0x8003700f, 0, 1), + BPF_STMT(BPF_RET+BPF_K, (u_int)-1), + BPF_STMT(BPF_RET+BPF_K, 0), +}; +.Ed +.Pp +最後に、このフィルタは TCP finger パケットだけを返します。 +TCP ヘッダにたどり着くためには IP ヘッダを解析しなければなりません。 +.Dv BPF_JSET +命令は IP フラグメントオフセットが 0 であることを調べます。 +それで TCP ヘッダであることを確認します。 +.Bd -literal +struct bpf_insn insns[] = { + BPF_STMT(BPF_LD+BPF_H+BPF_ABS, 12), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, ETHERTYPE_IP, 0, 10), + BPF_STMT(BPF_LD+BPF_B+BPF_ABS, 23), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, IPPROTO_TCP, 0, 8), + BPF_STMT(BPF_LD+BPF_H+BPF_ABS, 20), + BPF_JUMP(BPF_JMP+BPF_JSET+BPF_K, 0x1fff, 6, 0), + BPF_STMT(BPF_LDX+BPF_B+BPF_MSH, 14), + BPF_STMT(BPF_LD+BPF_H+BPF_IND, 14), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 79, 2, 0), + BPF_STMT(BPF_LD+BPF_H+BPF_IND, 16), + BPF_JUMP(BPF_JMP+BPF_JEQ+BPF_K, 79, 0, 1), + BPF_STMT(BPF_RET+BPF_K, (u_int)-1), + BPF_STMT(BPF_RET+BPF_K, 0), +}; +.Ed +.Sh 関連項目 +.Xr tcpdump 1 , +.Xr ioctl 2 , +.Xr byteorder 3 +.Rs +.%A McCanne, S. +.%A Jacobson V. +.%T "An efficient, extensible, and portable network monitor" +.Re +.Sh 関連ファイル +.Bl -tag -compact -width /dev/bpfXXX +.It Pa /dev/bpf Ns Sy n +パケットフィルタデバイス +.El +.Sh バグ +読み込みバッファは固定長 ( +.Dv BIOCGBLEN +ioctl で返される値) でなければなりません。 +.Pp +無差別モードを要求しないファイルは、同じハードウェアインタフェース上で +このモードを要求する他のファイルの副作用として、 +無差別にパケットを受信するかもしれません。 +これは、オーバヘッドのある処理を追加すれば、カーネル内で修正できるでしょう。 +しかし、インタフェースは無差別であるとすべてのファイルがみなさなければならないような +モデルの方が好まれます。必要なら、外部のパケットをはじくためのフィルタを +利用しなければなりません。 +.Pp +可変長ヘッダのデータリンクプロトコルは現在サポートされていません。 + +.Sh 歴史 +.Pp +Enet パケットフィルタは、 1980 年にカーネギーメロン大学の +Mike Accetta と Rick Rashid により作成されました。 +スタンフォードの Jeffrey Mogul がコードを BSD に移植して +1983 年以降発展させました。その後 +.Tn DEC +の Ultrix パケットフィルタ、 +.Tn SunOS 4.1 +の +.Tn STREAMS +.Tn NIT +モジュール、 +.Tn BPF +へと進化しました。 +.Sh 著者 +Lawrence Berkeley 研究所の +.An Steven McCanne +が 1990 年夏に BPF をインプリメントしました。 +多くは +.An Van Jacobson +によってデザインされました。 diff --git a/ja_JP.eucJP/man/man4/bridge.4 b/ja_JP.eucJP/man/man4/bridge.4 new file mode 100644 index 0000000000..85f472e99c --- /dev/null +++ b/ja_JP.eucJP/man/man4/bridge.4 @@ -0,0 +1,69 @@ +.\" +.\" %Id: bridge.4,v 1.2 1998/12/21 22:37:53 luigi Exp % +.\" jpman %Id: bridge.4,v 1.3 2000/05/08 06:15:02 mitchy Stab % +.\" +.Dd Sep 28, 1998 +.Dt BRIDGE 4 +.Os +.Sh 名称 +.Nm bridge +.Nd ブリッジのサポート +.Sh 解説 +バージョン 2.2.8 からは、 FreeBSD はイーサネット型インタフェースでの +ブリッジをサポートします。 +これはカーネル設定ファイルで次のオプションを使うことで実現されます。 +.Bd -literal + options BRIDGE +.Ed + +そして 2 つの +.Nm sysctl +変数で制御されます: +.Bd -literal + net.link.ether.bridge +.Ed + +ブリッジを有効にするには 1 に設定し、無効にするには 0 に設定してください。 +.Bd -literal + net.link.ether.bridge_ipfw +.Ed + + +ブリッジされたパケットに対して +.Nm ipfw +フィルタリングを有効にするには 1 に設定してください。 +.Nm ipfw +ルールは IP パケットに対してのみ適用されることに注意してください。 +IP 以外のパケットはデフォルトの +.Nm ipfw +ルール(65535番)に従います。 +ARP やその他の IP 以外のパケットがブリッジを通り抜けるようにしたい場合には、 +これは +.Ar allow +ルールでなければなりません。 + + +.Sh バグ +.Pp +ブリッジのトポロジにループを作らないように気を付けねばなりません。 +カーネルは、ループを検出したときにいくつかのインタフェースを無効にする、 +原始的な形のループ検出機構しかサポートしていません。 +スパニングツリーアルゴリズムを実現するデーモンのためのサポートは、 +今のところ用意されていません。 +.Pp +ブリッジを有効にすると、インタフェースは無差別(promiscuous)モードになるので、 +望ましくない通信を受信しフィルタではじく分、システムに負荷をかけます。 +.Pp +インタフェースのクラスタについて選択的にブリッジを有効にする拡張機能 +については、まだ作業中です。 +.Pp +すべてのインタフェースがブリッジをサポートしているわけではありません。 +現在 ``ed'', ``de'', ``ep'', ``fxp'', ``lnc'' インタフェースで動作します。 +.Sh 関連項目 +.Xr ip 4 , +.Xr ipfw 8 , +.Xr sysctl 8 +.Sh 歴史 +.Nm +によるブリッジは FreeBSD 2.2.8 で +Luigi Rizzo により導入されました。 diff --git a/ja_JP.eucJP/man/man4/bt.4 b/ja_JP.eucJP/man/man4/bt.4 new file mode 100644 index 0000000000..365ca66d31 --- /dev/null +++ b/ja_JP.eucJP/man/man4/bt.4 @@ -0,0 +1,139 @@ +.\" +.\" Copyright (c) 1994 Jordan Hubbard +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: bt.4,v 1.6 1998/10/16 21:33:34 ken Exp % +.\" jpman %Id: bt.4,v 1.3 1999/11/19 15:20:29 horikawa Stab % +.\" +.Dd October 16, 1998 +.Dt BT 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm bt +.Nd Buslogic/Mylex MultiMaster SCSI ホストアダプタドライバ +.Sh 書式 +.Cd "controller bt0 at isa? port ? cam irq ?" +.Cd controller scbus0 at bt0 +.Sh 解説 +このドライバは Buslogic/Mylex MultiMaster または互換コントローラに +接続された +.Tn SCSI +バスへのアクセスを提供します (訳注: 次の表でコマンドは +キューイング可能な CCBの個数です): +.Pp +.Bd -filled -offset indent +.Bl -column "BT-956CD " "ISA " "Commands " Description +MultiMaster "W" シリーズホストアダプタ: +.Pp +.Em "アダプタ バス コマンド 解説" +BT-948 PCI 192 ULtra SCSI-3 +BT-958 PCI 192 Wide ULtra SCSI-3 +BT-958D PCI 192 Wide Differential ULtra SCSI-3 +.El +.Bl -column "BT-956CD " "ISA " "Commands " Description +MultiMaster "C" シリーズホストアダプタ: +.Pp +.Em "アダプタ バス コマンド 解説" +BT-946C PCI 100 Fast SCSI-2 +BT-956C PCI 100 Wide Fast SCSI-2 +BT-956CD PCI 100 Wide Differential Fast SCSI-2 +BT-445C VLB 100 Fast SCSI-2 +BT-747C EISA 100 Fast SCSI-2 +BT-757C EISA 100 Wide Fast SCSI-2 +BT-757CD EISA 100 Wide Differential Fast SCSI-2 +BT-545C ISA 50 Fast SCSI-2 +BT-540CF ISA 50 Fast SCSI-2 +.El +.Bl -column "BT-956CD " "ISA " "Commands " Description +MultiMaster "S" シリーズホストアダプタ: +.Pp +.Em "アダプタ バス コマンド 解説" +BT-445S VLB 30 Fast SCSI-2 +BT-747S EISA 30 Fast SCSI-2 +BT-747D EISA 30 Differential Fast SCSI-2 +BT-757S EISA 30 Wide Fast SCSI-2 +BT-757D EISA 30 Wide Differential Fast SCSI-2 +BT-545S ISA 30 Fast SCSI-2 +BT-542D ISA 30 Differential Fast SCSI-2 +BT-742A EISA 30 SCSI-2 (742A リビジョン H) +BT-542B ISA 30 SCSI-2 (542B リビジョン H) +.El +.Bl -column "BT-956CD " "ISA " "Commands " Description +MultiMaster "A" シリーズホストアダプタ: +.Pp +.Em "アダプタ バス コマンド 解説" +BT-742A EISA 30 SCSI-2 (742A リビジョン A - G) +BT-542B ISA 30 SCSI-2 (542B リビジョン A - G) +.El +.Ed +.Pp +AMI FastDisk ホストアダプタは、真の BusLogic MultiMaster クローンなので +同様にこのドライバでサポートされます。 +.Pp +タグ付きキューイングは、'W' シリーズのアダプタ、ファームウェアが +リビジョン 4.42 以上の 'C' シリーズアダプタ、ファームウェアが +リビジョン 3.35 以上の 'S' シリーズアダプタでサポートされます。 +.Pp +ボードのファームウェアのリビジョンによっては、 +特定デバイスへの高負荷でロックアップするかも知れません。 +タグ付きキューイングが使われている場合には、特にこれが言えます。 +あなたのアダプタで問題が起きた場合は、 +Mylex のテクニカルサポートに連絡し、 +そのコントローラ用の最新のファームウェアを使っている事を確認して下さい。 +.Sh 関連項目 +.Xr cd 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh 作者 +.An Julian Elischer +が Multimaster カード用のドライバを書き、 +これが 386BSD パッチキットで配布されました。 +.An Justin T. Gibbs +がそのドライバが書き直し、 +新しいボードの機能を活用して FreeBSD 3.0R の CAM SCSI フレームワークで +動作するようにしました。 +.Pp +Linux 用に完全かつ詳しく解説された Mylex/BusLogic MultiMaster ドライバを +書いてくれた Leonard N. Zubkoff に感謝します。 +このドライバでの広範囲の MultiMaster コントローラと +ファームウェアリビジョン、他では書かれないようなそれらの癖の +サポートは彼の功績無しには不可能だったでしょう。 +.Sh 関連ファイル +.Bl -tag -width /usr/share/man0/template.doc -compact +.It Pa sys/dev/buslogic/bt.c +ドライバ実装のコア +.It Pa sys/dev/buslogic/btreg.h +MultiMaster のレジスタセットとドライバのコアのデータ構造 +.It Pa sys/pci/bt_pci.c +PCI バスドライバアタッチメント +.It Pa sys/i386/eisa/bt_eisa.c +EISA バスドライバアタッチメント +.It Pa sys/i386/isa/bt_isa.c +ISA/VL バスドライバアタッチメント +.El +.Sh 歴史 +.Nm +ドライバは 386BSD パッチキットから登場しました。 diff --git a/ja_JP.eucJP/man/man4/ccd.4 b/ja_JP.eucJP/man/man4/ccd.4 new file mode 100644 index 0000000000..f99d5d5ded --- /dev/null +++ b/ja_JP.eucJP/man/man4/ccd.4 @@ -0,0 +1,158 @@ +.\" %NetBSD: ccd.4,v 1.5 1995/10/09 06:09:09 thorpej Exp % +.\" +.\" Copyright (c) 1994 Jason Downs. +.\" Copyright (c) 1994, 1995 Jason R. Thorpe. +.\" 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 for the NetBSD Project +.\" by Jason Downs and Jason R. Thorpe. +.\" 4. Neither the name of the author 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 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. +.\" +.\" jpman %Id: ccd.4,v 1.3 2000/07/05 04:58:37 horikawa Stab % +.\" Based on Japanese translation by +.\" YABU (Shigeru Kasahara) [man-jp 1289] +.Dd August 9, 1995 +.Dt CCD 4 +.Os NetBSD +.Sh 名称 +.Nm ccd +.Nd 結合ディスクドライバ +.Sh 書式 +.Cd "pseudo-device ccd 4" +.Sh 解説 +.Nm +ドライバは、 +1 つ以上のディスクやパーティションを結合し、 +1 つの仮想ディスクにすることを可能にします。 +.Pp +この文書は、読者がカーネルを構築できること、 +カーネルの設定ファイルのなかでディスクと仮想デバイスを正しく設定できること、 +ディスクパーティションを適切に切れることを前提としています。 +.Pp +.Sq 生の +ディスクパーティションは、結合 +.Pa すべきではありません +。構成要素のパーティションとしては、FS_BSDFFS タイプ ( +.Xr disklabel 8 +では、タイプ +.Dq 4.2BSD +と表示されます) のみ、カーネルは受け入れます。 +.Pp +ccd サポートをカーネルに組み込むには、 +カーネルの設定ファイル中に次のような行を挿入する必要があります: +.Bd -unfilled -offset indent +pseudo-device ccd 4 # concatenated disk devices +.Ed +.Pp +引数は、ブート時にメモリを割り当てる +.Nm +の個数です。 +この例では 4 を越える +.Nm +は設定できません。 +.Pp +.Nm +は、直列に結合されているか、インタリーブされているかのいずれかです。 +パーティションを直列に結合するには、 +インタリーブファクタを 0 に設定します。 +.Pp +.Nm +を設定する、実行時に用いるユーティリティがあります。 +詳細は +.Xr ccdconfig 8 +を参照してください。 +.Ss インタリーブファクタ +.Nm +が適切にインタリーブされているなら、 +.Dq ストライピング +効果が発生します。 +これは、連続した読み書きの実行を高速化します。 +インタリーブファクタは、 +DEV_BSIZE (普通は 512 バイト) を単位としてあらわされます。 +大容量の書き込みのためには、 +最適なインタリーブファクタは普通はトラックの大きさであり、 +大容量の読み込みのためには、だいたいトラックの 1/4 の数字となります +(ディスクの数と速度に依存して、大きく変わります)。 +例えば、 +2 つの Fast-Wide SCSI バスにつながれた 8 つの 7200 回転のディスクでは、 +最適なインタリーブファクタは、 +書き込みのためには 128、読み込みのためには 32 となります。 +.Pp +構成要素となる全ディスクが同じジオメトリと大きさとなっていれば、 +最適の速度が得られます。 +最適のストライピング効果は、異った種類のディスクでは得られません。 +.Pp +ニュースサーバのように、ランダムアクセスを主とする作業では、 +もっと大きなインタリーブファクタ (例えば 65,536) が望ましいです。 +シークタイムによって制限されているアプリケーションの高速化には、 +.Nm +はあまり効果が無いことに注意してください。 +インタリーブファクタを大きくすることにより、 +1 つのディレクトリまたはファイルの読み込みのために +2 つのディスクヘッドのシークが必要となる可能性を、 +少くとも減らしはします。 +.Ss ディスクミラーリング +.Nm +は、偶数のディスクに対して +.Dq ミラー +するように設定可能です。 +必要なフラグについては、 +.Xr ccdconfig 8 +を参照してください。 +ディスク不良に対しては、 +.Xr dd 1 +を用いて復旧可能です。 +.Pp +単一ディスクの +.Nm +はオリジナルのパーティションと同じではないことに注意してください。 +これは特に、2 個のディスクでミラーされた +.Nm +上にファイルシステムがあって片方のディスクが不良になったとすると、 +残りのパーティションをマウントしてそのまま使うことはできないことを意味します。 +この場合、単一ディスクの +.Nm +として使う必要があります。 +.Sh 警告 +.Nm +として使用している 1 個 (以上) のディスクが不良となった場合、 +ディスクをミラーリングしているのでなければ、 +ファイルシステム全体が失われます。 +.Sh 関連ファイル +/dev/{,r}ccd* - ccd デバイスの特殊ファイル。 +.Pp +.Sh 歴史 +結合ディスクドライバは、もともと University of Utah で記述されました。 +.Sh 関連項目 +.Xr dd 1 , +.Xr ccdconfig 8 , +.Xr config 8 , +.Xr disklabel 8 , +.Xr fsck 8 , +.Xr MAKEDEV 8 , +.Xr mount 8 , +.Xr newfs 8 diff --git a/ja_JP.eucJP/man/man4/cd.4 b/ja_JP.eucJP/man/man4/cd.4 new file mode 100644 index 0000000000..56626d9317 --- /dev/null +++ b/ja_JP.eucJP/man/man4/cd.4 @@ -0,0 +1,493 @@ +.\" 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: cd.4,v 1.12 1998/10/12 03:27:51 ken Exp % +.\" jpman %Id: cd.4,v 1.3 2000/01/03 03:15:12 horikawa Stab % +.\" +.Dd October 10, 1998 +.Dt CD 4 +.Os FreeBSD +.Sh 名称 +.Nm cd +.Nd SCSI CD-ROM ドライバ +.Sh 書式 +.Cd device cd +.Cd device cd1 at scbus0 target 4 lun 0 +.Cd options "CHANGER_MIN_BUSY_SECONDS=3" +.Cd options "CHANGER_MAX_BUSY_SECONDS=11" +.Sh 解説 +.Nm cd +ドライバは、 +.Tn SCSI +.Tn CD-ROM +(コンパクトディスク-読み出し専用メモリ) ドライブをサポートします。 +通常ディスクと同じように見せるために、 +.Nm +ドライバは、 +.Tn CD-ROM +全体をカバーする 1 つのパーティションからなる +パーティションテーブルを合成します。 +このパーティションテーブルを +.Xr disklabel 8 +を用いて修正することは可能ですが、 +その修正は +.Tn CD-ROM +をアンマウントするまでの間のみ有効です。 +一般的に、このインタフェースは +.Xr wd 4 +や +.Xr da 4 +で述べられているものと同様です。 +.Pp +.Tn SCSI +アダプタがブート中にプローブされる際、 +.Tn SCSI +バス上のデバイスが走査されます。 +見つかったデバイスのうち、 +タイプ CDROM (タイプ 5) あるいは WORM (タイプ 4) と応答したものは +.Nm +ドライバにアタッチされます。 +.Fx 2.1 +以前のバージョンでは、 +最初に見つかったデバイスは +.Li cd0 +としてアタッチされ、その次が +.Li cd1 +のようになっていました。 +.Fx 2.1 +からは、デバイスが何番の cd ユニットとなるべきか指定できます。 +カーネル設定の詳細については +.Xr scsi 4 +を参照して下さい。 +.Pp +システムユーティリティ +.Xr disklabel 8 +を用いて、合成されたディスクラベル構造体を読み出せます。 +この構造体には、必要となる +.Tn CD-ROM +のサイズに関する正しい値が含まれます。 +.Pp +.Sh カーネル設定 +システム設定に関わらず、任意の数の +.Tn CD-ROM +デバイスをシステムにアタッチできます。 +全てのリソースは動的にアロケートされます。 +.Sh IOCTL +.Tn SCSI +.Tn CD-ROM +ドライブに適用される以下の +.Xr ioctl 2 +呼び出しが、ヘッダファイル +.Aq Pa sys/cdio.h +と +.Aq Pa sys/disklabel.h +で定義されています。 +.Pp +.Bl -tag -width CDIOCREADSUBCHANNEL -compact +.It Dv DIOCGDINFO +.It Dv DIOCSDINFO +.Pq Li "struct disklabel" +当該ドライブに対するディスクラベルのカーネル内コピーを読み書きします。 +ディスクラベルは scsi inquiry コマンドから読み取った情報で初期化されます。 +その値はブート時に表示されたものと同一のはずです。 +この構造体は +.Xr disklabel 5 +で定義されています。 + +.It Dv CDIOCCAPABILITY +.Pq Li "struct ioc_capability" +当該ドライブがサポートしている機能に関する情報を取り出します。 +情報は以下の構造体で返されます。 +.Bd -literal -offset indent +struct ioc_capability { + u_long play_function; +#define CDDOPLAYTRK 0x00000001 + /* tracks/index 指定で再生可能 */ +#define CDDOPLAYMSF 0x00000002 + /* msf (分秒フレーム) 指定で再生可能 */ +#define CDDOPLAYBLOCKS 0x00000004 + /* ブロック指定で再生可能 */ +#define CDDOPAUSE 0x00000100 + /* 出力を一時停止可能 */ +#define CDDORESUME 0x00000200 + /* 出力を再開可能 */ +#define CDDORESET 0x00000400 + /* ドライブを完全にリセット可能 */ +#define CDDOSTART 0x00000800 + /* オーディオ開始可能 */ +#define CDDOSTOP 0x00001000 + /* オーディオ停止可能 */ +#define CDDOPITCH 0x00002000 + /* オーディオピッチ調整可能 */ + + u_long routing_function; +#define CDREADVOLUME 0x00000001 + /* ボリューム設定の読み出し可能 */ +#define CDSETVOLUME 0x00000002 + /* ボリュームの設定可能 */ +#define CDSETMONO 0x00000100 + /* 出力をモノラルに設定可能 */ +#define CDSETSTEREO 0x00000200 + /* 出力をステレオに設定可能 (デフォルト) */ +#define CDSETLEFT 0x00000400 + /* 出力を左のみに設定可能 */ +#define CDSETRIGHT 0x00000800 + /* 出力を右のみに設定可能 */ +#define CDSETMUTE 0x00001000 + /* 出力のミュート可能 */ +#define CDSETPATCH 0x00008000 + /* ダイレクトルーティング制御可能 */ + + u_long special_function; +#define CDDOEJECT 0x00000001 + /* トレーのオープン可能 */ +#define CDDOCLOSE 0x00000002 + /* トレーのクローズ可能 */ +#define CDDOLOCK 0x00000004 + /* トレーのロック可能 */ +#define CDREADHEADER 0x00000100 + /* 目次の読み出し可能 */ +#define CDREADENTRIES 0x00000200 + /* 目次エントリの読み出し可能 */ +#define CDREADSUBQ 0x00000200 + /* サブチャネル情報の読み出し可能 */ +#define CDREADRW 0x00000400 + /* サブコード R-W の読み出し可能 */ +#define CDHASDEBUG 0x00004000 + /* トレーがダイナミックデバッグ機能を持つ */ +}; +.Ed +.It Dv CDIOCPLAYTRACKS +.Pq Li "struct ioc_play_track" +指定されたトラックアドレスおよび長さに基づいてオーディオの再生を開始します。 +この構造体は以下のように定義されます: +.Bd -literal -offset indent +struct ioc_play_track +{ + u_char start_track; + u_char start_index; + u_char end_track; + u_char end_index; +}; +.Ed + +.It Dv CDIOCPLAYBLOCKS +.Pq Li "struct ioc_play_blocks" +指定されたブロックアドレスおよび長さに基づいてオーディオの再生を開始します。 +この構造体は以下のように定義されます: +.Bd -literal -offset indent +struct ioc_play_blocks +{ + int blk; + int len; +}; +.Ed + +.It Dv CDIOCPLAYMSF +.Pq Li "struct ioc_play_msf" +指定された「分-秒-フレーム」と長さに基づいてオーディオの再生を開始します。 +この構造体は以下のように定義されます: +.Bd -literal -offset indent +struct ioc_play_msf +{ + u_char start_m; + u_char start_s; + u_char start_f; + u_char end_m; + u_char end_s; + u_char end_f; +}; +.Ed + +.It Dv CDIOCREADSUBCHANNEL +.Pq Li "struct ioc_read_subchannel" +この構造体で指定されたロケーションのサブチャネルから情報を読み出します。 +.Bd -literal -offset indent +struct ioc_read_subchannel { + u_char address_format; +#define CD_LBA_FORMAT 1 +#define CD_MSF_FORMAT 2 + u_char data_format; +#define CD_SUBQ_DATA 0 +#define CD_CURRENT_POSITION 1 +#define CD_MEDIA_CATALOG 2 +#define CD_TRACK_INFO 3 + u_char track; + int data_len; + struct cd_sub_channel_info *data; +}; +.Ed + +.It Dv CDIOREADTOCHEADER +.Pq Li "struct ioc_toc_header" +マウントされた +.Tn CD-ROM +の目次に関する情報のサマリを返します。 +この情報は以下の構造体に格納して返されます。 +.Bd -literal -offset indent +struct ioc_toc_header { + u_short len; + u_char starting_track; + u_char ending_track; +}; +.Ed + +.It Dv CDIOREADTOCENTRYS +.Pq Li "struct ioc_read_toc_entry" +指定された目次エントリからの情報を返します。 +(そう、このコマンド名のスペルは間違っています。) +引数の構造体は以下のようになります: +.Bd -literal -offset indent +struct ioc_read_toc_entry { + u_char address_format; + u_char starting_track; + u_short data_len; + struct cd_toc_entry *data; +}; +.Ed +要求データは、 +.Li data +が指す大きさ +.Li data_len +の領域に格納されます。 + +.It Dv CDIOCSETPATCH +.Pq Li "struct ioc_patch" +様々なオーディオチャネルを様々な出力チャネルに割り当てます。 +引数の構造体は次のように定義されます: +.Bd -literal -offset indent +struct ioc_patch { + u_char patch[4]; + /* 各チャネルに対し 1 要素が対応 */ +}; +.Ed + +.It Dv CDIOCGETVOL +.It Dv CDIOCSETVOL +.Pq Li "struct ioc_vol" +出力チャネルのボリューム設定に関する情報を取得 (あるいは設定) します。 +引数の構造体は次のとおりです: +.Bd -literal -offset indent +struct ioc_vol +{ + u_char vol[4]; + /* 各チャネルに対し 1 要素が対応 */ +}; +.Ed + +.It Dv CDIOCSETMONO +全ての出力チャネルを全ての入力チャネルに割り当てます。 + +.It Dv CDIOCSETSTEREO +左入力チャネルを左出力チャネルに、右入力チャネルを右出力チャネルに、 +それぞれ割り当てます。 + +.It Dv CDIOCSETMUTE +ボリューム設定を変更せずに出力をミュートします。 + +.It Dv CDIOCSETLEFT +.It Dv CDIOCSETRIGHT +両方の出力チャネルを左 (または右) 入力チャネルに割り当てます。 + +.It Dv CDIOCSETDEBUG +.It Dv CDIOCCLRDEBUG +対応するデバイスに対するデバッグ機能をオン (またはオフ) にします。 + +.It Dv CDIOCPAUSE +.It Dv CDIOCRESUME +オーディオ再生を一時停止 (または再開) します。 +読み出しヘッドの位置はリセットしません。 + +.It Dv CDIOCRESET +ドライブをリセットします。 + +.It Dv CDIOCSTART +.It Dv CDIOCSTOP +ドライブに対し、 +.Tn CD-ROM +の回転開始 (または停止) を指示します。 + +.It Dv CDIOCALLOW +.It Dv CDIOCPREVENT +ドライブに対し、 +.Tn CD-ROM +ディスクの手動による取り出しを許可 (または禁止) します。 +この機能をサポートしないドライブがあります。 + +.It Dv CDIOCEJECT +.Tn CD-ROM +を取り出します。 + +.It Dv CDIOCCLOSE +ドライブに対し、ドアを閉じメディアをロードするよう指示します。 +この機能をサポートしないドライブがあります。 + +.It Dv CDIOCPITCH +.Pq Li "struct ioc_pitch" +この機能をサポートするドライブに対し、 +オーディオを通常より早い速度ないし遅い速度で再生するよう指示します。 +.Li speed +の値が -32767 から -1 までの間なら遅い速度で再生します。 +値が 0 なら通常速度です。値が 1 から 32767 の場合は早い速度で再生します。 +分解能が 16 ビット未満のドライブの場合、エラーを出さず、 +単に下位ビットが無視されます。 +この構造体は次のように定義されます: +.Bd -literal -offset indent +struct ioc_pitch +{ + short speed; +}; +.Ed +.El +.Sh 注意 +.Nm +ドライバで制御されているドライブ中の +.Tn CD-ROM +が入れ換えられた場合、 +メディア交換操作によってカーネル内のディスクラベルと関連情報が +無効化されます。 +データ破損を避けるため、当該デバイスを参照するオープンファイル +デスクリプタがなくなるまで、当該デバイスに対するアクセスは全て破棄されます。 +この間、新たなオープン操作は全て拒否されます。 +当該デバイスを参照するオープンファイルデスクリプタがなくなると、 +後続の最初のオープン操作により、当該ドライブに対する新しい +パラメータ一式 (ディスクラベルを含む) がロードされます。 +.Pp +.Nm +ドライバ中のオーディオコードは +.Tn SCSI-2 +標準のオーディオコマンドのみサポートします。 +多くの +.Tn CD-ROM +製造業者はこの標準規格に従っていないため、 +オーディオが動作しない +.Tn CD-ROM +ドライブが数多く存在します。 +より一般的な「ダメな」 +.Tn CD-ROM +ドライブをサポートする作業も計画されていますが、 +まだ実行に移されていません。 +.Sh チェンジャ操作 +このドライバは LUN ベースの CD チェンジャのサポートを内蔵しています。 +LUN ベースの CD チェンジャとは、2 つ以上の CD を保持できるが、 +CD 再生機構を一組しか持たないドライブです。 +このドライブ内の各 CD は、 +.Tn SCSI +バス上の別々の論理ユニットとして現れます。 +この +.Nm cd +ドライバは自動的に LUN ベースのチェンジャを認識し、 +内部のスケジューラを通してチェンジャに対するコマンドを送り出します。 +このスケジューラは、チェンジャ中の異なる LUN に同時にコマンドを送ることで +引き起こされる、チェンジャの「スラッシング」を防ぎます。 +.Pp +スケジューラは、ドライバが特定の LUN で消費するタイムクァンタムの +最小値と最大値を管理します。 +最小値とは、たとえその LUN に処理中の I/O がない場合でも、 +その LUN で費すことが保証されている最小時間量です。 +最大値とは、他の LUN に処理中の I/O がある場合に、 +ある LUN でチェンジャが費す最大時間量です。 +他の LUN に処理中の I/O がない場合は、 +ドライバはある LUN に対するアクセスに上限を設けません。 +.Pp +最小および最大タイムクァンタムはカーネルオプションや sysctl 変数を +通じて変更できます。カーネルオプションは以下の通り: + +.Bl -tag -width 1234 -compact +.It Cd options "CHANGER_MIN_BUSY_SECONDS=3" +.It Cd options "CHANGER_MAX_BUSY_SECONDS=11" +.El +.Pp +sysctl 変数は以下の通り: +.Pp +.Bl -tag -width 1234 -compact +.It Cd kern.cam.cd.changer.min_busy_seconds +.It Cd kern.cam.cd.changer.max_busy_seconds +.El +.Pp +ユーザは、sysctl 変数を通じて最小および最大タイムアウトを試し、 +自分のチェンジャに最適な値を見つけるとよいでしょう。 +一旦、自分のチェンジャに対する最適タイムアウトが決まれば、 +それをカーネル設定ファイルに記述できます。 +.Pp +自分のシステムに LUN ベースのチェンジャが存在すれば、 +ブートプロセスが進むに従って、そのチェンジャの様々な LUN に対する +プローブメッセージが表示されることに気づくでしょう。 +これは正常であり、チェンジャのスケジューリングコードによって引き起こされます。 +.Sh 関連ファイル +.Bl -tag -width /dev/rcd[0-9][a-h] -compact +.It Pa /dev/cd[0-9][a-h] +ブロックモード +.Tn CD-ROM +デバイス +.It Pa /dev/rcd[0-9][a-h] +raw モード +.Tn CD-ROM +デバイス +.El +.Sh 診断 +ありません。 +.Sh 関連項目 +.Xr scsi 4 , +.Xr da 4 , +.Xr disklabel 5 , +.Xr disklabel 8 , +.Xr cd 9 +.Sh バグ +.Fn ioctl +に対する 3 番目の引数に用いられる構造体の名前は適当ではありません。 +また、 +.Fn ioctl +コマンドの中にはスペルミスがいくつも残っています。 +.Pp +現在のところ、異なる CD チェンジャに対して異なる最小および最大 +タイムアウト値を設定する機構はありません。 +カーネルオプションあるいは sysctl 変数で設定したタイムアウト値は +システムにある LUN ベースの CD チェンジャ全てに適用されます。 +このようなサポートを実装することは可能ですが、 +少なくとも sysctl による実装はあまりエレガントではありません。 +というのは、現在の sysctl コードではコンパイル後のノード追加を +取り扱うことができないためです。 +それゆえ、動的に大きさを決定する sysctl 変数を用意し、 +ユーザレベルのユーティリティを用いてタイムアウト値を取得ないし設定する +ことになるでしょう。 +カーネル設定ファイル中で、異なる CD デバイスに対して +別々のタイムアウトを指定できるようにするには、 +.Xr config 8 +を修正し、 +固定的に記述した +.Nm cd +デバイスに 2 つのタイムアウト値をサポートするようにしなければ +ならないかもしれません。 +.Sh 歴史 +本 +.Nm cd +ドライバは、Julian Ellischer が記述し 386BSD 0.1 に登場した +.Nm cd +ドライバをベースにしています。 +.Nm cd +ドライバの CAM バージョンは Kenneth Merry が記述し、 +.Fx 3.0 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man4/ch.4 b/ja_JP.eucJP/man/man4/ch.4 new file mode 100644 index 0000000000..16fda2199f --- /dev/null +++ b/ja_JP.eucJP/man/man4/ch.4 @@ -0,0 +1,302 @@ +.\" %Id: ch.4,v 1.12 1998/09/15 10:26:24 gibbs Exp % +.\" jpman %Id: ch.4,v 1.3 2000/01/06 12:54:41 horikawa Stab % +.\" 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 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. +.\" +.Dd May 14, 1998 +.Dt CH 4 +.Os FreeBSD +.Sh 名称 +.Nm ch +.Nd SCSI メディアチェンジャ (ジュークボックス) ドライバ +.Sh 書式 +.Cd device ch +.Cd device ch1 target 4 lun 0 +.Sh 解説 +.Xr ch +ドライバは、 +.Em SCSI +メディアチェンジャをサポートします。このドライバは、多くのスロットに +存在するメディアを複数のドライブの間で多重化して利用できるようにします。 +チェンジャデバイスには、オプションとしてバーコードリーダを備え付けること +もできます。このリーダを使い、メディアに付随する情報を読み込みます。 +.Pp +SCSI チェンジャをシステムに組み込む前に、SCSI アダプタを別途組み込んで +おく必要があります。 +.Pp +ブート時に SCSI アダプタをプローブしているときに、 +.Em SCSI +バスを走査しデバイスを探します。`Changer' タイプであると応答するデバイスが +見つかると、それらは +.Nm +ドライバに「アタッチ」されます。 +2.1 より前のリリースの FreeBSD では、最初に見つかったデバイスが +.Em ch0 +にアタッチされ、以後見つかったデバイスは順次、 +.Em ch1 +などにアタッチされます。 +2.1 から、あるデバイスがどの ch ユニットとして接続すべきかを指定 +できるようになりました。このためのカーネル設定については、 +.Xr scsi 4 +を参照して下さい。 +.Pp +.Sh カーネル設定 +設定の際に、オプションとして +.Ar count +を指定した場合、その数だけの SCSI メディアチェンジャが設定されます。 +ドライバの記憶領域のほとんどは、デバイスが見つかった時にのみ +割り当てられるので、たくさんのデバイスを設定しても +高くはつきません (ひとたび最初のデバイスがドライバを組み込んだ場合)。 +.Pp +.Sh IOCTL +ユーザモードプログラムは、次に示す ioctl を使ってチェンジャドライバと +データのやりとりを行ないます。カーネルとチェンジャデバイスとの間の +データのやりとりで使用される、チェンジャエレメントのアドレスは、 +0 から始まる論理アドレスに割り当てられます。エレメントのタイプは +次のように指定します。 +.Bl -tag -width CHET_MT +.It Dv CHET_MT +メディア移動エレメント (ピッカ) +.It Dv CHET_ST +ストレージエレメント (スロット) +.It Dv CHET_IE +持ち込み/持ち出しエレメント (ポータル) +.It Dv CHET_DT +データ転送エレメント (ドライブ) +.El +.Pp +次に示す +.Xr ioctl 2 +呼び出しがチェンジャに適用されます。これらはヘッダファイル +.Aq Pa sys/chio.h +で定義されます。 +.Pp +.Bl -tag -width CHIOEXCHANGE +.It Dv CHIOMOVE +.Pq Li "struct changer_move" +これは、現在のピッカを用いて、メディアをあるエレメントから別の +エレメントに移動させます (\fBMOVE MEDIUM\fR)。移動元と移動先の +エレメントは、changer_move 構造体の中で指定します。この構造体は、 +少なくとも次に示すフィールドを持ちます。 +.Bd -literal -offset indent +u_int cm_fromtype; /* 移動元エレメントのタイプ */ +u_int cm_fromunit; /* 移動元エレメントの論理ユニット */ +u_int cm_totype; /* 移動先エレメントのタイプ */ +u_int cm_tounit; /* 移動先エレメントの論理ユニット */ +u_int cm_flags; /* その他フラグ */ + +.Ed +\fBcm_flags\fR フィールドの \fBCM_INVERT\fR が設定されている場合、 +メディアチェンジャは移動中にメディアを反転させるように指示されます。 +.It Dv CHIOEXCHANGE +.Pq Li "struct changer_exchange" +これは、移動元エレメントにあるメディアを最初の移動先エレメントに移動させ、 +最初の移動先エレメントにあったメディアを 2 番目の移動先エレメントに +移動させます。単純な交換の場合、移動元と 2 番目の移動先とは同じである +必要があります。この操作の遂行に際し現在のピッカが用いられます。影響を +受けるエレメントのアドレスは、changer_exchange 構造体に含めて +ioctl に対して指定します。この構造体は少なくとも次の要素を持ちます。 +.Bd -literal -offset indent +u_int ce_srctype; /* 移動元エレメントのタイプ */ +u_int ce_srcunit; /* 移動元の論理ユニット */ +u_int ce_fdsttype; /* 最初の移動先エレメントのタイプ */ +u_int ce_fdstunit; /* 最初の移動先の論理ユニット */ +u_int ce_sdsttype; /* 2番目の移動先エレメントのタイプ */ +u_int ce_sdstunit; /* 2番目の移動先の論理ユニット */ +u_int ce_flags; /* その他フラグ */ + +.Ed +\fBce_flags\fR の中で、\fBCM_INVERT1\fR と \fBCM_INVERT2\fR を設定 +でき、これらはそれぞれ、最初のメディアと 2 番目のメディアを移動中に +反転させます。 +.Pp +\fIこの機能はテストしていません。\fR +.It Dv CHIOPOSITION +.Pq Li "struct changer_position" +これは、現在のピッカを移動させ指定したエレメントの前に置きます。 +エレメントは changer_position 構造体で指定します。これは少なくとも +次の要素を持ちます。 +.Bd -literal -offset indent +u_int cp_type; /* エレメントのタイプ */ +u_int cp_unit; /* エレメントの論理ユニット */ +u_int cp_flags; /* その他フラグ */ + +.Ed +\fBcp_flags\fR フィールドで \fBCP_INVERT\fR を設定でき、これは +移動中にピッカを反転させます。 +.It Dv CHIOGPICKER +.Pq Li "int" +これは、現在のピッカの論理アドレスを返します。 +.It Dv CHIOSPICKER +.Pq Li "int" +これは、与えた論理アドレスが指すピッカを選択します。 +.It Dv CHIOGPARAMS +.Pq Li "struct changer_params" +これは、メディアチェンジャの設定パラメータを返します。この ioctl は、 +ユーザが渡した changer_params 構造体の、 +少なくとも以下のフィールドを埋めます。 +.Bd -literal -offset indent +u_int cp_npickers; /* ピッカの数 */ +u_int cp_nslots; /* スロットの数 */ +u_int cp_nportals; /* 持ち込み/持ち出しポータルの数 */ +u_int cp_ndrives; /* ドライブの数 */ + +.Ed +アプリケーションが \fBCHIGSTATUS\fR ioctl を用いてジュークボックスの +状態を調べるに先だって、ジュークボックスの諸元を問い合わせる際に、この +呼び出しを使用できます。 +.It Dv CHIOIELEM +これは、メディアチェンジャデバイスに対し、\fBINITIALIZE ELEMENT STATUS\fR +呼び出しを行ないます。これにより、メディアチェンジャは、ロードしている +メディアに関する内部状態情報を更新させられます。チェンジャがラベルリーダを +持つ場合、バーコードラベルの走査もあわせて行ないます。この呼び出しでは、 +.Nm +ドライバの状態は影響を受けません。 +.It Dv CHIOGSTATUS +.Pq Li "struct changer_element_status_request" +これは、メディアチェンジャデバイスに対し、\fBREAD ELEMENT STATUS\fR +呼び出しを行ないます。この呼び出しはメディアチェンジャの +エレメント状態情報を読み込み、それを \fBchanger_element_status\fR +構造体の配列に変換します。 +.Pp +.Dv CHIOGSTATUS +の呼び出しごとに、あるタイプの 1 つ以上のエレメントの状態が +問い合わされます。 +.Pp +アプリケーションは changer_element_status_request 構造体を +.Nm +ドライバに渡します。この構造体は次に示すフィールドを持ちます。 +.Bd -literal -offset indent +u_int cesr_element_type; +u_int cesr_element_base; +u_int cesr_element_count; +u_int cesr_flags; +struct changer_element_status *cesr_element_status; + +.Ed +ドライバはこの構造体を読み込み、タイプ、論理ベースアドレス、エレメント数 +を決定し、cesr_element_status フィールドが指す changer_element_status +構造体の配列にどの情報を返すかを知ります。アプリケーションは、 +cesr_element_count 個の状態構造体 (次を見て下さい) を保持するのに +十分な大きさのメモリを割り当てる必要があります。cesr_flags にオプションで +.Dv CESR_VOLTAGS +を設定し、ボリュームタグ (バーコード) 情報をジュークボックスから +読み込んで返す必要があることを通知できます。 +.Pp +cesr_element_base フィールドと cesr_element_count フィールドは、 +チェンジャの物理的構成に照らして正当な値でなければなりません。もし +正当な値でない場合、 +.Dv CHIOGSTATUS +ioctl は +.Er EINVAL +エラーコードを返します。 +.Pp +エレメントについての情報は、changer_element_status 構造体の配列の中に +返されます。この構造体は少なくとも次に示すフィールドを持ちます。 +.Bd -literal -offset indent +u_int ces_addr; /* メディアチェンジャのエレメントアドレス */ +u_char ces_flags; /* 以下の CESTATUS の定義を参照 */ +u_char ces_sensecode; /* エレメントの追加センスコード */ +u_char ces_sensequal; /* 追加センスコード修飾子 */ +u_char ces_invert; /* 反転ビット */ +u_char ces_svalid; /* 移動元アドレス (ces_source) が有効 */ +u_short ces_source; /* メディアの移動元アドレス */ +changer_voltag_t ces_pvoltag; /* プライマリボリュームタグ */ +changer_voltag_t ces_avoltag; /* 代替ボリュームタグ */ +u_char ces_idvalid; /* ces_scsi_id が有効 */ +u_char ces_scsi_id; /* エレメントの SCSI id (ces_idvalid が非 0 の場合) */ +u_char ces_lunvalid; /* ces_scsi_lun が有効 */ +u_char ces_scsi_lun; /* エレメントの SCSI lun (ces_lunvalid が非 0 の場合) */ + +.Ed +ces_addr フィールドは、メディアチェンジャの座標系で表した +エレメントのアドレスを保持します。ドライバはこれを使用しません。 +診断目的のみで使用して下さい。 +.Pp +\fBces_flags\fR フィールドに対し、次に示すフラグが定義されます。 +.Bl -tag -width CESTATUS_IMPEXP +.It Dv CESTATUS_FULL +メディアが存在します。 +.It Dv CESTATUS_IMPEXP +メディアを置いたのはオペレータです (ピッカが置いたものではありません)。 +.It Dv CESTATUS_EXCEPT +そのエレメントは例外的状態 (例えば、バーコードラベルが不当な値、 +バーコードがまだ走査されていない) にあります。 +.It Dv CESTATUS_ACCESS +そのエレメントはピッカによってアクセス可能な状態です。 +.It Dv CESTATUS_EXENAB +そのエレメントはメディア持ち出しをサポートしています。 +.It Dv CESTATUS_INENAB +そのエレメントはメディア持ち込みをサポートしています。 +.El +.Pp +すべてのエレメントタイプに対しすべてのフラグが有効とは限らないことに +注意して下さい。 +.El +.Sh 注 +このバージョンの +.Nm +ドライバは、DEC TZ875 (5 スロット、1 DLT ドライブ) と Breece Hill Q47 +(60 スロット、4 DLT ドライブ、バーコードリーダ付き) を用いてテストして +あります。 +.Pp +テストに利用できたデバイスが必要なコマンドをサポートしていないという +事実により、 +.Nm +ドライバがサポートする機能の多くは、完全にテストできていません。これは、 +代替ボリュームタグ、メディア反転、エレメントの持ち込み/持ち出し操作、 +複数ピッカ操作、その他の機能があります。 +.Sh 作者 +.Nm +は、 +And Communications, http://www.and.com/ の +.An Jason R. Thorpe Aq thorpej@and.com +が記述しました。これを、その手のデバイスを持っていた +.An Stefan Grefen Aq grefen@goofy.zdv.uni-mainz.de +がシステムに付け加えました。 +これを CAM に移植したのは、 +.An Kenneth Merry Aq ken@FreeBSD.ORG +です。 +これを更新してボリュームタグをサポートするようにしたのは、 +.An Hans Huebner Aq hans@artcom.de +です。 +.Sh 関連ファイル +.Bl -tag -width /dev/ch[0-9] -compact +.It Pa /dev/ch[0-9] +デバイスエントリ +.El +.Sh 診断 +メディアチェンジャが +.Nm +ドライバが要求する機能をサポートしていない場合、ここで記述した ioctl に +対し、コンソールエラーメッセージとエラーリターンコードを生成します。 +.Sh 関連項目 +.Xr chio 1 , +.Xr cd 4 , +.Xr sd 4 , +.Xr st 4 +.Sh 歴史 +.Nm +は、386BSD 0.1 で現れました。 diff --git a/ja_JP.eucJP/man/man4/cs.4 b/ja_JP.eucJP/man/man4/cs.4 new file mode 100644 index 0000000000..ba32f400d5 --- /dev/null +++ b/ja_JP.eucJP/man/man4/cs.4 @@ -0,0 +1,105 @@ +.\" +.\" Copyright (c) 1998 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 AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: cs.4,v 1.2 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: cs.4,v 1.3 1999/11/28 15:53:08 horikawa Stab % +.\" +.Dd July 20, 1998 +.Dt CS 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm cs +.Nd イーサネットデバイスドライバ +.Sh 書式 +.Cd "device cs0 at isa? port 0x300 net irq ?" +.Cd "device cs1 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Sh 解説 +.Nm +ドライバは +.Nm Crystal Semiconductor CS8900 と CS8920 +NIC をベースにした ISA イーサネットアダプタをサポートします。 +これらのデバイスは CS89x0 ファミリの欠点を補うだけの +高い完成度と小型化および低価格化を実現した、 +.Nm IBM EtherJet ISA +アダプタおよび同デバイスを組み込んだ多くの製品において使われています。 +.Pp +.Nm +ドライバは設定パラメータを、設定エントリまたはカードのどちらからでも +取得できます。設定エントリで指定されたパラメータがもし存在すれば +そちらを使用しますが、カードはソフトウェアで設定できるので、 +これらの設定は適正な値になっていると思われます。 +CS8920 ベースのアダプタは、通常 PnP 設定を提供するので、ドライバは +.Nm IBM EtherJet +と +.Nm CSC6040 +を自動的に検出します。 +.Pp +CS8900 は 4 つの IRQ 値に限定されていることに注意してください。これらの値は +通常 5, 10, 11, 12 となっています。CS8920 にはそのような制限はありません。 +.Pp +メモリマップと DMA 動作は現時点ではサポートされていません。 +.Sh 診断 +.Bl -diag +.It "cs%d: full/half duplex negotiation timeout" +ハブとの全二重設定ネゴシエート試行がタイムアウトを起こしました。 +このことはケーブル接続に問題があるか、欠陥か、互換性のないハブであることを +示しています。 +.It "cs%d: failed to enable " +CS89x0 は指示されたメディアの選択に失敗しました。そのメディアが存在しないか、 +操作が正しくありません。 +.It "cs%d: No EEPROM, assuming defaults" +CS89x0 に EEPROM がないか、絶望的に損傷しています。設定エントリがアダプタの +値に適した値になっていた場合にしか操作できません。 +.It "cs%d: Invalid irq" +設定エントリで指定された IRQ がアダプタにあっていません。 +.It "cs%d: Could not allocate memory for NIC" +致命的なメモリ不足です。アダプタは動きません。 +.It "cs%d: Adapter has no media" +アダプタは特定のメディアタイプに設定されていません。 +メディアタイプは手動でセットする必要があります。 +.It "This is a %s, but LDN %d is disabled" +PnP 探査コードは処理可能なアダプタを検出しましたが、 +アダプタは無効化されています。 +.It "failed to read pnp parms" +PnP アダプタが検出されましたが、そのアダプタ用の設定パラメータが読めません。 +.It "failed to pnp card parametars" +PnP 経由で得たパラメータをドライバは受けとれませんでした。アダプタはたぶん +動かないでしょう。 +.Sh 警告 +CS89x0 ファミリのアダプタは、とても小さな RAM バッファ (4K) しか +持っていません。このことは極端に高いネットワーク負荷や +爆発的なネットワークトラフィック下では問題を起こすかもしれません。 +実際、NFS 操作はオーバランを防ぐために、 1k の読み書き処理に +制限するべきです。 +.Sh 作者 +.Nm +デバイスドライバは +.An Maxim Bolotin +と +.An Oleg Sharoiko +が書きました。 +このマニュアルページは +.An Michael Smith +が書きました。 diff --git a/ja_JP.eucJP/man/man4/cx.4 b/ja_JP.eucJP/man/man4/cx.4 new file mode 100644 index 0000000000..4a9455eefd --- /dev/null +++ b/ja_JP.eucJP/man/man4/cx.4 @@ -0,0 +1,289 @@ +.\" +.\" %Id: cx.4,v 1.4 1997/06/23 04:02:37 steve Exp % +.\" jpman %Id: cx.4,v 1.3 2000/08/10 13:49:49 horikawa Stab % +.\" +.Dd December 12, 1994 +.Dt CX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm cx , +.Nm if_cx +.Nd 同期/非同期 Cronyx-Sigma アダプタドライバ +.Sh 設定 +.Cd "device cx0 at isa? port 0x240 irq 15 drq 7" +.Cd "device cx1 at isa? port 0x260 irq 12 drq 6" +.Cd pseudo-device sppp +.Pp +i/o ベースアドレスは、ボード上のジャンパで設定されます。 +DMA チャネルと割り込みリクエスト番号は、 +アダプタ初期化時にソフトウェアで設定されます。 +通常の値は以下の通りです。 +.Pp +.Bl -tag -compact -width Port +.It Port +0x240, 0x260, 0x280, 0x300, 0x320, 0x380 +.It IRQ +3, 5, 7, 10, 11, 12, 15 +.It DMA +5, 6, 7 +.Sh 解説 +Cronyx-Sigma ドライバはモデル 100, +400, 500, 401, 404, 410, 440, 703, 801, 810, 840 をサポートします。 +モデルが異なると、チャネルのセットが異なります。 +.Pp +.Bl -tag -compact -width Cronyx-Sigma-999 +.It モデル +チャネル +.It Cronyx-Sigma-100 +0 +.It Cronyx-Sigma-400 +4, 5, 6, 7 +.It Cronyx-Sigma-500 +0, 4, 5, 6, 7 +.It Cronyx-Sigma-401 +0, 1, 2, 3 +.It Cronyx-Sigma-404 +0, 1, 2, 3 +.It Cronyx-Sigma-410 +0, 1, 2, 3 +.It Cronyx-Sigma-440 +0, 1, 2, 3 +.It Cronyx-Sigma-703 +0, 1, 2, 4, 5, 6, 7 +.It Cronyx-Sigma-801 +0, 1, 2, 3, 4, 5, 6, 7 +.It Cronyx-Sigma-810 +0, 1, 2, 3, 4, 5, 6, 7 +.It Cronyx-Sigma-840 +0, 1, 2, 3, 4, 5, 6, 7 +.El +.Pp +ふたつのアダプタは、ボード間接続用の短い専用ケーブルで接続することができます。 +ふたつの接続されたアダプタは、同じ IRQ と DMA チャネルを使用し、 +ドライバから見ればひとつの 16 チャネルマルチプレクサとして動作します。 +接続されたボードの片方が ``マスタ'' に、もう一方が ``スレーブ'' になります。 +.Pp +スレーブになったボードのチャネルは、 +ドライバによって 8 から始まる番号が割り当てられます。 +たとえばモデル 100 と モデル 500 を接続すると、 +0, 8, 12, 13, 14, 15 番のチャネル番号が割り当てられます。 +.Pp +RS-232C インタフェースをもつチャネルは、 +同期モードと非同期モードのどちらでも動作することが可能 +(cxconfig ユーティリティによってソフトウェア的に選択します) であり、 +そのため ``ユニバーサルチャネル'' と呼ばれます。 +.Pp +Cronyx-Sigma アダプタ用のデバイス型特殊ファイル +.Pa /dev/* +は、 +.Xr MAKEDEV 8 +によっ作られます。 +たとえば、以下のように作ります: +.Bd -literal +cd /dev +sh MAKEDEV cronyx ttyx0 ttyx1 ttyy0 +.El +.Sh 非同期ドライバ +.Pp +非同期チャネルのデバイスファイルには次のような名前が付けられます: +.Pa /dev/ttyx# +- はアダプタ cx0 に、 +.Pa /dev/ttyy# +- はアダプタ cx1 に、 +.Pa /dev/ttyz# +- はアダプタ cx2 に付けられます。 +ここで # は 0-9-a-f の、16 進数でのチャネル番号です。 +.Pp +ドライバは以下の標準 ioctl を受け付けます ( +.Xr ioctl +を参照): +.Pp +.Bl -tag -width TIOCXXXXX -compact +.It Dv TIOCSBRK +BREAK を送信開始します。 +.It Dv TIOCCBRK +BREAK の送信を停止します。 +.It Dv TIOCSDTR +DTR 信号をセットします (DTR := 1)。 +DTR 信号は最初の open(2) で必ずセットされ、 +.Dv TIOCCDTR , +.Dv TIOCSDTR , +.Dv TIOCMSET , +.Dv TIOCMBIS , +.Dv TIOCMBIC +の ioctl により変更可能です。 +.It TIOCCDTR +DTR 信号をクリアします (DTR := 0)。 +.It TIOCMSET +DTR 信号と RTS 信号に、指定した値をセットします ( := data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMBIS +DTR 信号と RTS 信号をセットします ( |= data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMBIC +DTR 信号と RTS 信号をクリアします ( &= ~data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMGET +ライン上のモデム信号の状態を判定します。 +呼び出しのあと、引数のデータは下記のビットを保持しています: +.Pp +.Bl -tag -width TIOCM_XXX -compact +.It TIOCM_LE +常にセット (ラインイネーブル状態) +.It TIOCM_DSR +データセットレディ信号 (DSR) 受信済 +.It TIOCM_CTS +送信可能信号 (CTS) 受信済 +.It TIOCM_CD +データキャリア検出信号 (CD) 受信済 +.It TIOCM_DTR +データ端末レディ (DTR) 信号送信済 +.It TIOCM_RTS +送信要求 (RTS) 送信済 +.El +.El +.Sh 同期ドライバ +.Pp +同期チャネルとユニバーサルチャネルは、 +.Xr cxconfig 8 +ユーティリティによって同期モードに設定すると、 +ネットワークインタフェース ``cx#'' +(# は 0 から 47 までのチャネル番号) としてアクセス可能です。 +すべての標準的なネットワークインタフェースパラメータは、 +.Xr ifconfig 8 +によって設定可能です。 +また +.Xr cxconfig 8 +コマンドは、拡張されたチャネルオプションの変更や、 +上位レベルのソフトウェアプロトコル +(PpP や Cisco HDLC など) の設定に使用されます。 +.Pp +ユニバーサルチャネルは同期モードでも非同期モードでも使用することができます。 +デフォルトでは非同期モードに設定されており、モードは +.Xr cxconfig 8 +ユーティリティによって変更可能です。 +チャネルがビジー状態 (非同期チャネルがオープン状態の場合や、 +ネットワークインタフェースが動作中 (up) の場合) +の間、モードはブロックされます。 +.Sh 同期ポイントツーポイントプロトコル +.Pp +Cronyx-Sigma ドライバは、組み込みの同期ポイントツーポイントプロトコル +(sppp) を使用します。 +本プロトコルには、PpP/HDLC や Cisco/HDLC、keepalive パケットによる +自動的なコネクションロス検出もサポートしています。 +sppp プロトコルセットは独立したモジュールとして実装され、 +他の同期シリアルチャネルのドライバによって使用することも可能です。 +BSD/386 (BSDI) 用の +ドライバでは、OS 側で実装されている一般的な同期プロトコルのセットも使用 +可能です。外部プロトコルセットは、``cxconfig ext'' コマンド +( +.Xr cxconfig 8 +を参照) によって選択可能です。 +.Sh チャネルオプションの管理 +.Pp +.Xr cxconfig 8 +ユーティリティは、チャネルオプションを設定するのに使用されます。 +チャネルオプションは、通常、オペレーティングシステムが起動する際に (たとえば +.Pa /etc/rc +ファイルなどで) 設定されます。 +すべての場合において、 +すべてのオプションが意味を持つとは限らないことに注意してください。 +また、 +オプションの設定によっては、 +チャネルもしくはアダプタ全体のハングアップの原因になります。 +.Pp +実際のチャネルオプションの制御機能は、 +デバイス型特殊ファイル /dev/cronyx に対する +いくつかの ioctl を経由する形で実装されており、以下の ioctl が使用できます。 +.Pp +.Bl -tag -width CXIOCXXXXXXX -compact +.It CXIOCGETMODE +チャネルオプションの値を取得します。 +.It CXIOCSETMODE +チャネルオプションの値を設定します。 +.El +.Pp +ioctl コールのデータ引数は以下のオプション構造体のアドレスを持ちます: +.Bd -literal +typedef struct { + unsigned char board; /* アダプタ番号であり、0..2 */ + unsigned char channel; /* チャネル番号であり、0..15 */ + unsigned char type; /* チャネルタイプ (読み込み専用) */ + unsigned char iftype; /* chan0 インタフェース */ + unsigned long rxbaud; /* 受信速度 */ + unsigned long txbaud; /* 転送速度 */ + cx_chan_mode_t mode; /* チャネルモード */ + cx_chan_opt_t opt; /* 共通のチャネルオプション */ + cx_opt_async_t aopt; /* 非同期モードオプション */ + cx_opt_hdlc_t hopt; /* hdlc モードオプション */ + cx_opt_bisync_t bopt; /* bisync モードオプション */ + cx_opt_x21_t xopt; /* x.21 モードオプション */ + cx_soft_opt_t sopt; /* ソフトウェアオプションと状態フラグ */ +} cx_options_t; /* ユーザが設定可能なオプション */ +.Ed +.Pp +.Bl -tag -width rxbaudxxx +.It Fa board +0..2 の、アダプタ番号 +.It Fa channel +0..15 の、チャネル番号 +.It Fa type +チャネルのタイプ (読み取り専用の引数) +.It Fa iftype +0 番 (と 8 番) チャネルのインタフェースタイプ。 0 - RS-232, 1 - RS-449/V.35。 +.It Fa rxbaud +受信ボーレート +.It Fa txbaud +送信ボーレート +.It Fa mode +チャネルモード: 非同期/HDLC/Bisync/X.21 +.It Fa opt +共通のチャネルオプション +.It Fa aopt +非同期モードオプション +.It Fa hopt +HDLC モードオプション +.It Fa bopt +Bisync モードオプション +.It Fa xopt +X.21 モードオプション +.It Fa sopt +ソフトウェアプロトコルオプション +.El +.Sh 関連ファイル +.Bl -tag -width /dev/cxXXXX -compact +.It Pa /dev/cx?? +非同期チャネル +.It Pa /dev/cronyx +チャネルオプション管理用のデバイス型特殊ファイル +.El +.Pp +ドライバを含んでいるソースファイルは以下の通りです: +.Pp +.Bl -tag -width /dev/cxXXXX -compact +.It Pa /sys/i386/isa/cronyx.c +.It Pa /sys/i386/isa/cx.c +.It Pa /sys/i386/isa/if_cx.c +.It Pa /sys/i386/isa/cronyx.h +.It Pa /sys/i386/isa/cxreg.h +.It Pa /sys/net/if_spppsubr.c +.It Pa /sys/net/if_sppp.h +.El +.Sh 関連項目 +.Xr cxconfig 8 , +.Xr ifconfig 8 diff --git a/ja_JP.eucJP/man/man4/cy.4 b/ja_JP.eucJP/man/man4/cy.4 new file mode 100644 index 0000000000..0e42c0e112 --- /dev/null +++ b/ja_JP.eucJP/man/man4/cy.4 @@ -0,0 +1,232 @@ +.\" Copyright (c) 1990, 1991 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Systems Programming Group of the University of Utah Computer +.\" Science Department. +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91 +.\" jpman %Id: cy.4,v 1.3 2000/05/09 22:59:06 yt-kage Stab % +.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp +.\" from: sio.4,v 1.16 1995/06/26 06:05:30 bde Exp $ +.\" %Id: cy.4,v 1.9 1998/10/22 14:51:19 bde Exp % +.\" +.Dd October 10, 1995 +.Dt CY 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm cy +.Nd Cyclades Cyclom-Y シリアルドライバ +.Sh 書式 +.Cd "device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000" +.Cd "device cy1 at isa? tty irq 11 iomem 0xd6000 iosiz 0x2000" +.Pp +マイナ番号: +.Pp +.Bd -literal +0b\fIMMMMMMMMMMMMMMMMxxxxxxxxOLIMMMMM\fR + call\fBO\fRut + \fBL\fRock + \fBI\fRnitial + \fBMMMMMMMMMMMMMMMM MMMMMM\fRinor +.Ed +.Sh 解説 +.Nm cy +ドライバは Cyclades の Cyclom-Y ボード に載っている +Cirrus Logic CD1400 ベースの +.Tn EIA +.Tn RS-232C +.Pf ( Tn CCITT +.Tn V.24 ) +通信インタフェース (ポート) をサポートします。 +それぞれの CD1440 は 4 つのポートを提供します。 +Cyclom-Y ボードにはさまざまな数の CD1400 を搭載したモデルがあります。 +このドライバは 1 つのボードあたり最大 8 つまでの CD1440 (32 ポート) を +サポートしています。 +.Pp +回線の入出力は以下の速度のいずれかを回線ごとに設定可能です: +50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, +19200, 38400, 57600, 115200 bps。 +それ以降、最大 150000 までの速度は、termios インタフェースではサポート +されていますが、sgttyb 互換インタフェースではサポートされていません。 +CD1440 は 115200 bps 以上の速度を効率よく扱えるほどの速さは +ありません。 +1 つの回線だと 115200 bps より心持ち速く送信することができますが、 +4 つの回線を双方向で同時に使用する場合は、CD1440 では +約 90000 bps が限界になります。 +.\" XXX the following should be true for all serial drivers and +.\" should not be repeated in the man pages for all serial drivers. +.\" It was copied from sio.4. The only change was s/sio/cy/g. +.Pp +.Nm cy +ドライバによって制御されるシリアルポートは `着呼' と `発呼' のどちらにでも +使用できます。 +それぞれのポートに対し、着呼デバイスと発呼デバイスが存在します。 +発呼デバイスのマイナ番号は対応する着呼ポートのものより 128 だけ大きい番号が +ついています。 +一般的には、着呼デバイスを使います。 +着呼デバイスをオープン途中のプロセスは、通常は、キャリアが来るまで、かつ、 +発呼デバイスが活動状態でなくなるまで待たされます。 +発呼デバイスを使用することで、着呼デバイスでキャリア待ちしている +プロセスの隙をついてポートを使用することができます。 +発呼デバイスをオープンしようとするプロセスはキャリア待ちをしません。 +かつ、発呼デバイスをオープンしようとするプロセスは、キャリア待ち +している他のプロセスをより深いスリープ状態にします。これにより、 +発呼セッションで両プロセスが衝突することはなくなります。 +一般的なポートで動作し、かつ、キャリア待ちせずにポートを +オープンする必要があると仮定しているプログラムで発呼デバイスを +扱うことは誤用であり、全く馬鹿げたことです。 +.Pp +また +.Nm cy +ドライバは、発呼と着呼それぞれのデータデバイスに対して、 +初期状態の制御とロック状態の制御をサポートします。 +初期状態デバイスのマイナ番号は対応するデータデバイスより 32 だけ大きい番号が +ついています。 +ロック状態デバイスのマイナ番号は対応するデータデバイスより 64 だけ大きい番号が +ついています。 +データデバイスにおける termios の設定は、初めてオープンする際に対応する +初期状態デバイスより複製され、以前にオープンされていたときの状態からは +継承されません。 +.Xr stty 1 +を初期状態デバイスに対して通常のやりかたで実行することにより、 +あなたの望む設定に適した初期 termios 状態をプログラムできます。 +.Pp +ロック termios の状態は、データデバイスの termios 状態の変更を +不可能にするフラグとして +振舞います。例えば CRTSCTS のようなフラグ変数をロックするには、 +ロック状態デバイスにおいて +.Em "stty crtscts" +とします。 +速度や特殊文字の設定をロックするには、 +ロック状態デバイスの対応する値を 0 でない値に設定するとよいです。 +.Pp +外部デバイスを正しく結線して正しいプログラムで通信している限りは、 +ほぼどのような初期状態であっても、ほとんどロックしなくても動作します。 +そうでない場合は、デフォルトの初期状態を変更し、その状態にロックを掛ける +ことで、うまく動くようになることもあるかもしれません。 +特に、バグありのプログラムが (POSIX) 標準でないフラグを変更されない +ようにするために、標準でないフラグの初期状態を接続されたデバイスに +合うように設定し、ロックしてやる必要があるかもしれません。 +例えば、常時 RTS/CTS ハンドシェイクをサポートするデバイスでは、CRTSCTS は +オンのままロックしておく必要があります。また、全くサポートしないデバイスに +対してはオフでロックしておく必要があります。 +CLOCAL はキャリアをサポートしないデバイスに対してはオンにロックするべきです。 +HUPCL は何らかの理由で切断したくない場合にはオフにロックするべきです。 +一般的に、何かが間違った状態でロックすると、とても悪いことが起こります。 +複数の設定をサポートするデバイスにはロックを行なうべきではありません。 +着呼ポートでの CLOCAL フラグは、ある種のセキュリティホールを避けるために +オフにロックしておくべきですが、着呼ポートを何か他の用途に使う +場合には、この設定を getty で行なうべきです。 +.Sh 関連ファイル +.\" XXX more cloning: s/d/c/g and add a ? for the card number. +.Bl -tag -width /dev/ttyic?? -compact +.It Pa /dev/ttyc?? +着呼ポート +.It Pa /dev/ttyic?? +.It Pa /dev/ttylc?? +対応する着呼初期状態とロック状態デバイス +.Pp +.\" XXX more cloning: s/a/c/g. No consistency :-(. +.It Pa /dev/cuac?? +発呼ポート +.It Pa /dev/cuaic?? +.It Pa /dev/cualc?? +対応する発呼初期状態とロック状態デバイス +.El +.Pp +.Bl -tag -width /etc/rc.serial -compact +.It Pa /etc/rc.serial +初期状態とロック状態デバイス設定の例 +.El +.Pp +これらのデバイス名の1つめの疑問符はカード番号 (0 と 65535 を含めた間の +10 進数) の略です。 +2つめの疑問符はポート番号 ([0-9a-v]の間の文字) の略です。 +.Sh 診断 +.Bl -diag +.\" XXX back to s/sio/cy/g. +.It cy%d: silo overflow. +割り込みハンドラに問題があります。 +.El +.Bl -diag +.It cy%d: interrupt-level buffer overflow. +ドライバのボトムハーフに問題があります。 +.El +.Bl -diag +.It cy%d: tty-level buffer overflow. +アプリケーションに問題があります。 +モジュールが処理し切れない速さで入力が行なわれ、一部の入力は失われてしまいました。 +.El +.\" .Bl -diag +.\" .It sio%d: reduced fifo trigger level to %d. +.\" Attempting to avoid further silo overflows. +.\" .El +.Sh 関連項目 +.Xr stty 1 , +.Xr termios 4 , +.Xr tty 4 , +.Xr comcontrol 8 , +.Xr pstat 8 +.Sh 歴史 +.Nm +ドライバは +.Nm sio +ドライバと NetBSD の +.Nm +ドライバより派生し、現在開発継続中です。 +.Sh バグ +BREAK はまだ実装されていません。 +.Pp +シリアルコンソールはまだ実装されていません。 +.Pp +遅いシステム下での高ボーレートやポートの多過ぎるシステム、あるいは +高負荷状態のシステムで crtscts が動かない状況下では、 +データの脱落が起きるかもしれません。 +.Pp +コンパイル時にしか設定できないフラグが多過ぎます。 +CD1440 には NS16550 に比べて若干少ない fifo しかないので +(16 でなく 12 バイト)、NS16550 よりも多くの仮想 DMA を必要とします。 +デフォルトの設定は一般的には実効で約 30% の相対コストの時に最適化されていま +す。これらのコンパイル時定義は効率を良くするために変更されるかもしれません: +.Pp +RxFifoThreshold: デフォルトは 6; 486DX-33 では、この値では 8 ポートが +互いに通信できるのは 115200 bps であり、11 にした場合、8 ポートが互いに +通信できるのは 57600 bps です。閾値を低くするのは、 +.Tn FreeBSD +のためではなく、実際には 115200 bps を維持できない CD1400 によるものです。 +.Pp +PollMode: Cyclom-16Y に必要です。Cyclom-8Y では、相対的にみて 10-20% +効率が犠牲になります +(RxFifoThreshold を低くすればもっと増えます)。 +.Pp +SOFT_HOTCHAR: RxFifoThreshold に小さな値を与えた場合には、 +SLIP や PPP を 8 ポートにおいて 115200 bps で使用する時にオーバランを +防ぐために必要です。相対的にみて、5% 効率が犠牲になります。 \ No newline at end of file diff --git a/ja_JP.eucJP/man/man4/da.4 b/ja_JP.eucJP/man/man4/da.4 new file mode 100644 index 0000000000..63acbfc4e8 --- /dev/null +++ b/ja_JP.eucJP/man/man4/da.4 @@ -0,0 +1,312 @@ +.\" 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: da.4,v 1.12 1998/10/16 03:28:12 ken Exp % +.\" jpman %Id: da.4,v 1.3 1999/11/19 15:20:21 horikawa Stab % +.\" +.\" WORD: solid-state 半導体 +.\" WORD: partitioning 区画割り +.\" +.Dd October 15, 1998 +.Dt DA 4 +.Os FreeBSD +.Sh 名称 +.Nm da +.Nd SCSI ダイレクトアクセスデバイスドライバ +.Sh 書式 +.Cd device da0 +.Cd device da1 at scbus0 target 4 lun 0 +.Sh 解説 +.Nm da +ドライバは、サポート済みの +.Tn SCSI +ホストアダプタを用いてシステムに接続されているダイレクトアクセス型のすべての +.Tn SCSI +デバイスのサポートを提供します。 +ダイレクトアクセス型はディスク、光磁気、 +そして半導体デバイスを含みます。 +.Pp +.Tn SCSI +ホストアダプタは +.Tn SCSI +ダイレクトアクセスデバイスが設定される前に +システムの中で別に設定されることが必要です。 +.Sh 区画割り (パーティショニング) +.Nm +ドライバはディスクに 2 つのレベルの区画割りを持つことを許可します。 +1 つ目の層は、 +.Dq スライス層 +と呼ばれ、 +ほかのオペレーティングシステムで使用されている領域から、 +.Tn FreeBSD +のディスクの領域を分離するために用いられます。 +2 つ目の層は、 +.Bx 4.4 +に固有の区画構成で、 +.Xr disklabel 5 +によって、 +個々のファイルシステムとスワップ空間のための領域に +.Tn FreeBSD +のスライスを再分割するために用いられます。 +より詳しい情報は、それぞれ、 +.Xr fdisk 8 +と +.Xr disklabel 8 +を見てください。 +.Pp +もし、初期化されていないディスクを開いた場合には、 +ディスク全体を計測して、 +仮の +.Tn FreeBSD +スライスを用いて、スライステーブルの初期化が行われます。 +同様に、初期化されていない +(または非 +.Tn FreeBSD ) +スライスが開かれた場合、そのディスクラベルは +ドライブによって返されるパラメータで初期化され、 +単一の +.Sq Li c +パーティションでスライス全体を包括します。 +.Sh キャッシュの効果 +多くのダイレクトアクセスデバイスは、読み込みと書き込みの両方もしくは一方の +キャッシュを持っています。 +デバイスキャッシュの効果をもたらすパラメータはモードページ 8、 +すなわちキャッシュ制御ページに納められています。 +モードページは +.Xr camcontrol 8 +ユーティリティによって調べて、変更することができます。 + +読み込みキャッシュは、何度も用いられるデータだけでなく、 +デバイスによる先読み操作のデータを格納するために用いられます。 +読み込みキャッシュはユーザに透過であり、 +有効にしてもまったく害はありません。 +読み込みキャッシュを持ったほとんどのデバイスは、 +工場出荷時にこの機能が有効にされています。 +読み込みキャッシュはキャッシュ制御モードページの +.Tn RCD +(読み込みキャッシュ不許可) ビットをセットすることで、 +不許可にできます。 + +書き込みキャッシュは書き込み操作による遅延を大幅に減らすことができ、 +効率と性能を増加させるために、書き込みを再編成することをデバイスに +認めます。 +この性能の増加にはかなりの代償が発生します。 +もし、 +書き込み操作が終了していないキャッシュを含んでいるときに、 +デバイス電源が消失すると、これらの書き込みは失われるでしょう。 +書き込み処理の失敗の影響は、ファイルシステムに不確定性をもたらし、 +不正な状況を引き起こすでしょう。 +多くのデバイスでは、書き込みトランザクションをエージングし、 +最近完了報告した少数のトランザクションのみに弱点を限定します。 +しかし、それでもなお、無停電電源装置 (UPS) を備えた書き込みキャッシュを +可能にしたデバイスのシステムでは、推奨されます。 +.Nm da +デバイスドライバは、 +デバイスの最後のクローズ、または予期しないシャットダウン (パニック) イベントの +ときに、キャッシュとメディアが同期すること保証します。 +これにより、オペレーティングシステムが停止したことを報告した後では、 +電源を切断しても安全であることが保証されます。 +書き込みキャッシュはキャッシュ制御モードページの +.Tn WCE +(書き込みキャッシュ許可) ビットをセットすることで +許可に出来ます。 +.Sh タグ付きキューイング +.Nm da +デバイスドライバは、タグ付きキューイングとして知られている SCSI 機能の利点を +完全に利用します。 +タグ付きキューイングはデバイスが同時に多数のトランザクションを処理することを +可能にし、しばしばシークの数と長さを減らすために、それらを並べ変えます。 +現在のヘッドの位置により近いサービスの要求によって、 +メディアの遠い部分へのトランザクションが +不確定に延期させられるかもしれません。 +このようなトランザクションが適切な時期に完了することを保証するために、 +デバイスの操作が続いている間、 +順番付けされたタグ付きトランザクションが 1 つ 15 秒ごとに送られます。 +.Sh 不良ブロックの修復 +ダイレクトアクセスデバイスは欠陥のあるメディアの部分を +マップアウトする能力を持っています。 +メディアの修復パラメータはモードページ 1、すなわち読み書きエラー修復モード +ページに位置しています。 +ほとんどの重要なメディアの再配置機能は '自動書き込み再割り当て' と '自動 +読み込み再割り当て' であり、それぞれ、読み書きエラー修復ページの +AWRE ビットと ARRE ビットを有効にすることで機能します。 +多くのデバイスは、工場出荷時にこれらの機能が無効にされています。 +モードページは +.Xr camcontrol 8 +ユーティリティによって調べて、変更することが出来ます。 +.Sh カーネルの設定 +ひとつの +.Nm da +デバイスを明示的に設定することのみが必要です。 +.Tn SCSI +バス上に見つかったディスクごとに +データ構造が動的に割り当てられます。 +.Sh IOCTL +次の +.Xr ioctl 2 +呼び出しは +他のディスクと同様に +.Tn SCSI +ドライブにも適用されます。 +それらは、ヘッダファイル +.Aq Pa sys/disklabel.h +の中で定義されています。 +.Pp +.Bl -tag -width DIOCSDINFO +.It Dv DIOCSBAD +一般にディスクの不良ブロックのマッピングシステムのセットアップに +用いられます。 +.Tn SCSI +デバイスはそれら自身に不良ブロックマッピングが組み込まれているので、 +このコマンドは実装されていません。 +.It Dv DIOCGDINFO +ドライブのディスクラベルの in-core コピーをカーネルから +読み込みます。もし、ドライブが一度も初期化されていないときは、 +仮のディスクラベルを与え、その場合には、 +.Tn SCSI +の inquiry コマンドから、読み込んだ情報を含んでいます。 +.It Dv DIOCSDINFO +使用する新しいディスクラベルをドライバに与えます。 +ドライバはディスクに新しいディスクラベルを書き込み +.Em ません +。 +.It Dv DIOCWLABEL +ディスク上のディスクラベルに対する、ドライバの +ソフトウエア書き込みプロテクトを有効または無効にします。 +.It Dv DIOCWDINFO +使用する新しいディスクラベルをドライバに与えます。 +ドライバはディスクに新しいディスクラベルを書き込み +.Em ます +。 +.El +.Sh 注 +もし、デバイスが無効になると (メディアが取り外される, デバイスが +応答しなくなる)、 +カーネル中に保持されているディスクラベルやデバイスついての情報は +無効になります。 +新たに挿入されたメディアや置き換えられたデバイスの破壊を防ぐために、 +古いデバイスを参照している最後のファイル記述子が閉じられるまで、 +デバイスへのすべてのアクセスは破棄されます。 +この間は、すべての新しいファイルを開こうとする試みは拒否されます。 +.Sh 関連ファイル +.Bl -tag -width /dev/rsdXXXXX -compact +.It Pa /dev/rda Ns Ar u +raw モード +.Tn SCSI +ディスクユニット +.Ar u , +区画割りされていないデバイスとしてアクセスされます +.Sm off +.It Pa /dev/da Ar u Pa s Ar n +.Sm on +block モード +.Tn SCSI +デバイスユニット +.Ar u , +スライス +.Ar n , +区画割りされていないデバイスとしてアクセスされます +.Sm off +.It Pa /dev/rda Ar u Pa s Ar n +.Sm on +raw モード +.Tn SCSI +ディスクユニット +.Ar u , +スライス +.Ar n , +区画割りされていないデバイスとしてアクセスされます +.It Pa /dev/da Ns Ar u Ns Ar p +block モード +.Tn SCSI +ディスクユニット +.Ar u , +初めの +.Tn FreeBSD +スライス, パーティション +.Ar p +.It Pa /dev/dad Ns Ar u Ns Ar p +raw モード +.Tn SCSI +ディスクユニット +.Ar u , +初めの +.Tn FreeBSD +スライス, パーティション +.Ar p +.Sm off +.It Xo +.Pa /dev/da +.Ar u +.Pa s +.Ar n +.Ar p +.Xc +.Sm on +block モード +.Tn SCSI +ディスクユニット +.Ar u , +.Ar n +番目のスライス, パーティション +.Ar p +.Sm off +.It Xo +.Pa /dev/dad +.Ar u +.Pa s +.Ar n +.Ar p +.Xc +raw モード +.Tn SCSI +ディスクユニット +.Ar u , +.Ar n +番目のスライス, パーティション +.Ar p +.El +.Sh 診断 +なし。 +.Sh 関連項目 +.Xr wd 4 , +.Xr disklabel 5 , +.Xr disklabel 8 , +.Xr fdisk 8 , +.Xr da 9 +.Sh 歴史 +.Nm +ドライバは +.Tn CAM +.Tn SCSI +サブシステム用に +Justin T. Gibbs が書きました。 +Julian Elischer +が +.Tn Mach +2.5 から移植して書いた +.Nm sd +デバイスドライバから、多くのアイデアが集められました。 +スライスのサポートは Bruce Evans が書きました。 diff --git a/ja_JP.eucJP/man/man4/daic.4 b/ja_JP.eucJP/man/man4/daic.4 new file mode 100644 index 0000000000..077fe6e494 --- /dev/null +++ b/ja_JP.eucJP/man/man4/daic.4 @@ -0,0 +1,104 @@ +.\" Copyright (c) 1997 Martin Husemann +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: daic.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" jpman %Id: daic.4,v 1.3 1999/12/29 19:03:49 horikawa Stab % +.\" +.\" last edit-date: [Fri Jan 30 22:49:48 1998] +.\" +.\" -mh writing manual pages +.\" +.\" +.Dd January 30, 1998 +.Dt daic 4 +.Sh 名称 +.Nm daic +.Nd EICON.Diehl active isdn カード用 isdn4bsd ドライバ +.Pp +.Nm +ドライバは古い Diehl active カード: +.Em S, SX, SXn, SCOM +そして +.Em QUADRO +をサポートします。 +.Sh 書式 +.Pp +以下のような設定行を用います +.Cd "daic0 at isa? iomem 0xd8000 irq 10" +.Pp +.Em QUADRO +カードについても同じ設定を用います。ドライバはボードの種類を検出して +4 つのポート全てを、ISDN4BSD システムのコントローラとして +アタッチします。 +アタッチされた各々のポートは、isdnctl ユーティリティを使って表示できます。 +.Sh 解説 +.Nm +ドライバは isdn カードを ISDN4BSD カーネルサブシステムへ +インタフェースします。 +それ以下のレイヤは全てカードによって扱われます。 +このドライバは EICON.Diehl によって作られた、どこの国の +isdn プロトコルにおいても、あなたのカードが動作すると +思われますが、ドライバは DSS1 プロトコルにおいてしかテストされておらず、 +カードインタフェースのある部分は isdn プロコトルに依存しています。 +.Pp +.Nm +ドライバは 1992 年より文書化されている Diehl の +.Nm ISDN-Karten Benutzerhandbuch +に準拠するよう作られています。 +.Sh マイクロコードのダウンロード +どの active カードも使用する前にそれぞれのカードに適合した +オペレーティングソフトウェアを必要としますので、 +ISDN4BSD を使用する前にダウンロードをしてください。 +ダウンロードには isdnctl ユーティリティを用います。 +例えばコントローラ番号 1 にファイル +.Nm te_etsi.sx +をダウンロードするには +.Nm "isdnctl -d te_etsi.sx 1" +とします。 +使用可能なコントローラ (とポート) を全て表示するには、 +.Nm "isdnctl -l" +としてください。 +あなたの isdn インタフェースに合った正しい isdn プロトコルファイルを +選択する必要があります。詳細は Diehl の資料を参照してください。 +.Pp +カードの起動プロセスでは、カード種別や使用するプロトコルに依存しない、 +それ以外のファイルも処理します。 +現在の Diehl によるソフトウェアの配布では、このファイルは +.Nm download.bin +と呼ばれており、 +.Nm dev/ic/microcode/daic +以下のカーネルコンパイル用ディレクトリにコピーしておく必要があり、 +またそのディレクトリで +.Nm make +を行なって、カーネルをコンパイルする際に必要となる +ヘッダファイルに変換しておく必要があります。 +この操作を忘れると、カーネルのコンパイルに失敗するので、 +忘れたことがわかるでしょう。 +著作権による制限のため、このファイルを統合してドライバを配布することは +できません。しかしカードを持っていればファイルも持っています (または +Diehl のウェブサーバから取得できます)。 +.Sh バグ +このドライバはまだ完成していません。NetBSD でのみこのドライバを +コンパイルすることが可能ですが、そこでさえも動いていません。 +この問題は近いうちに修正され、ドライバは FreeBSD に移植されるでしょう。 +.Sh 関連項目 +.Xr isdnctl 1 diff --git a/ja_JP.eucJP/man/man4/ddb.4 b/ja_JP.eucJP/man/man4/ddb.4 new file mode 100644 index 0000000000..9de2b4b62c --- /dev/null +++ b/ja_JP.eucJP/man/man4/ddb.4 @@ -0,0 +1,580 @@ +.\" +.\" Mach Operating System +.\" Copyright (c) 1991,1990 Carnegie Mellon University +.\" All Rights Reserved. +.\" +.\" Permission to use, copy, modify and distribute this software and its +.\" documentation is hereby granted, provided that both the copyright +.\" notice and this permission notice appear in all copies of the +.\" software, derivative works or modified versions, and any portions +.\" thereof, and that both notices appear in supporting documentation. +.\" +.\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS" +.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR +.\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. +.\" +.\" Carnegie Mellon requests users of this software to return to +.\" +.\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU +.\" School of Computer Science +.\" Carnegie Mellon University +.\" Pittsburgh PA 15213-3890 +.\" +.\" any improvements or extensions that they make and grant Carnegie Mellon +.\" the rights to redistribute these changes. +.\" +.\" changed a \# to #, since groff choked on it. +.\" +.\" HISTORY +.\" ddb.4,v +.\" Revision 1.1 1993/07/15 18:41:02 brezak +.\" Man page for DDB +.\" +.\" Revision 2.6 92/04/08 08:52:57 rpd +.\" Changes from OSF. +.\" [92/01/17 14:19:22 jsb] +.\" Changes for OSF debugger modifications. +.\" [91/12/12 tak] +.\" +.\" Revision 2.5 91/06/25 13:50:22 rpd +.\" Added some watchpoint explanation. +.\" [91/06/25 rpd] +.\" +.\" Revision 2.4 91/06/17 15:47:31 jsb +.\" Added documentation for continue/c, match, search, and watchpoints. +.\" I've not actually explained what a watchpoint is; maybe Rich can +.\" do that (hint, hint). +.\" [91/06/17 10:58:08 jsb] +.\" +.\" Revision 2.3 91/05/14 17:04:23 mrt +.\" Correcting copyright +.\" +.\" Revision 2.2 91/02/14 14:10:06 mrt +.\" Changed to new Mach copyright +.\" [91/02/12 18:10:12 mrt] +.\" +.\" Revision 2.2 90/08/30 14:23:15 dbg +.\" Created. +.\" [90/08/30 dbg] +.\" +.\" %Id: ddb.4,v 1.6 1997/04/12 21:54:48 joerg Exp % +.\" jpman %Id: ddb.4,v 1.3 2000/05/06 08:15:07 isaki Stab % +.\" +.\" WORD: wired ハードコーディングされた [Jargon File] +.\" WORD: modifier 修飾子 +.\" +.Dd January 16, 1996 +.Dt DDB 4 +.Os FreeBSD +.Sh 名称 +.Nm ddb +.Nd 対話型カーネルデバッガ +.Sh 書式 +.Cd options DDB +.Sh 解説 +.Nm +カーネルデバッガは古い kdb のほとんどの機能を、 +.Xr gdb 1 +の影響を受けた合理的なシンタックスでサポートしています。 +.Pp +現在のロケーションは `dot' と呼ばれます。 +`dot' はプロンプトに 16 進数の形式で表示されます。 +検査と書き込みコマンドは、 +最後に検査したか最後に変更したロケーションに `dot' を更新します。 +そして、`next' を次に検査もしくは変更するロケーションのアドレスにセットします。 +他のコマンドは `dot' を変更せず、`next' を `dot' と同じにします。 +.Pp +一般的なコマンドシンタックスは +.Cm command Ns Op Li \&/ Ns Ar modifier +.Ar address Ns Op Li , Ns Ar count +となります。 +.Pp +空白行は直前のコマンドをアドレス `next' からカウントを 1、 +修飾子 (modifier) なしとして繰り返し実行します。 +.Ar address +を指定すると `dot' はそのアドレスに設定されます。 +.Ar address +を省略すると `dot' がアドレスとして使われます。 +.Ar count +が指定されないと、表示コマンドに対しては 1 が指定されたものとされ、 +スタックトレースに対しては無限が指定されたものとなります。 +.Pp +.Nm +デバッガは出力に対し +.Xr more 1 +のような機能をサポートしています。 +出力行が変数 +.Li \&$lines +で指定されている数を越えると、 +.Dq Em --db_more-- +を表示し応答を待ちます。 +これに対する有効な応答は以下の通りです。 +.Pp +.Bl -tag -compact -width SPC +.It Li SPC +次の 1 ページを表示します +.It Li RET +次の 1 行を表示します +.It Li q +現在のコマンドを中断し、コマンド入力モードに戻ります +.El +.Pp +.Nm +は小さい (現在は 10 項目) コマンドヒストリや、 +簡単な Emacs 風のコマンド行編集機能を提供しています。 +Emacs のコントロールキーに加え、 +通常の ANSI の矢印キーでもヒストリバッファをブラウズしたり、 +現在行の中でカーソルを動かしたりすることができるでしょう。 +.Sh コマンド +.Bl -ohang -compact +.It Cm examine +.It Cm x +修飾子のフォーマットによって、 +指定されたアドレスロケーションの内容を表示します。 +複数の修飾子を指定すると、複数のロケーションが表示されます。 +フォーマットが指定されないと、 +このコマンドに最後に使われたフォーマットが使われます。 +.Pp +フォーマット文字は以下の通りです。 +.Bl -tag -compact -width indent +.It Li b +バイト (8 ビット) で表示します。 +.It Li h +ハーフワード (16 ビット) で表示します。 +.It Li l +ロングワード (32 ビット) で表示します。 +.It Li a +表示されたロケーションを表示します。 +.It Li A +可能ならばロケーションを行番号で表示します。 +.It Li x +符号無しの 16 進数で表示します。 +.It Li z +符号付きの 16 進数で表示します。 +.It Li o +符号無しの 8 進数で表示します。 +.It Li d +符号付きの 10 進数で表示します。 +.It Li u +符号無しの 10 進数で表示します。 +.It Li r +現在の基数を符号付きで表示します。 +.It Li c +下位 8 ビットを文字として表示します。 +表示できない文字は 8 進数のエスケープコード (例: `\e000') +で表示されます。 +.It Li s +そのロケーションをナル文字で終了する文字列として表示します。 +表示できない文字は 8 進数のエスケープコードで表示されます。 +.It Li m +各行末に文字ダンプをつけて符号無しの 16 進数で表示します。 +各行頭にロケーションも 16 進数で表示されます。 +.It Li i +命令として表示します。 +.It Li I +マシンに依存したおそらく別のフォーマットで命令として表示します。 +.Bl -tag -width MIPS -compact +.It Tn VAX +外部ラベルを手続きのエントリマスクとして想定しません。 +.It Tn i386 +続くロングワードの境界の丸めを行いません。 +.It Tn MIPS +レジスタの内容を表示します。 +.El +.El + +.It Cm xf +前方検査: +最後に指定されたパラメータを使って、検査コマンドを実行します。 +最後に実行されたコマンドによって表示されたアドレスが +開始アドレスとして使われます。 + +.It Cm xb +後方検査: +最後に指定されたパラメータを使って、検査コマンドを実行します。 +最後に実行されたコマンドによって表示されたアドレスから +表示されたもののサイズを引いた結果が開始アドレスとして使われます。 + +.It Cm print Ns Op Cm /acdoruxz +指定された修飾子文字 (上述の +.Li examine +参照) にしたがって、 +.No Ar addr +を表示します。 +有効なフォーマットは +.Li a , +.Li x , +.Li z , +.Li o , +.Li d , +.Li u , +.Li r , +.Li c +です。 +修飾子が指定されないと、最後に指定されたものが使われます。 +.Ar addr +は文字列で指定することができます。 +その場合はその通りに表示されます。 +例えば、 +.Bd -literal -offset indent +print/x \&"eax = \&" $eax \&"\enecx = \&" $ecx \&"\en\&" +.Ed +.Pp +は次のように表示されます。 +.Bd -literal -offset indent +eax = xxxxxx +ecx = yyyyyy +.Ed + +.It Xo +.Cm write Ns Op Cm /bhl +.No Ar addr Ar expr1 Op Ar "expr2 ..." +.Xc +コマンド行で +.Ar addr +の後に指定された式を +.Ar addr +からはじまるロケーションに書き込みます。 +書き込みサイズの単位は修飾子として文字 +.Li b +(バイト), +.Li h +(ハーフワード), +.Li l +(ロングワード) としてそれぞれ指定できます。 +これが省略されると、ロングワードが指定されたものとみなされます。 +.Pp +.Sy 警告 : +式の間にはデリミタがないので、奇妙なことが起こり得ます。 +各式は括弧で括ったほうがいいでしょう。 + +.It Xo +.Cm set +.No Li \&$ Ns Ar variable +.Op Li = +.Ar expr +.Xc +名前つき変数やレジスタに +.Ar expr +の値をセットします。 +有効な変数名は後述します。 + +.It Cm break Ns Op Cm /u +.Ar addr +にブレークポイントをセットします。 +.Ar count +が指定されたら、ブレークポイントで停止するまで、 +.Ar count +- 1 回継続します。 +ブレークポイントがセットされたら、ブレークポイント番号が +.Sq Li \&# +で表示されます。 +この数字はブレークポイントを削除したり、 +それに条件を追加するのに使うことができます。 +.Pp +修飾子 +.Li u +が指定されると、 +このコマンドはユーザ空間アドレスにブレークポイントをセットします。 +.Li u +オプションが指定されない場合は、 +アドレスはカーネル空間のものであると判断され、 +空間アドレスが間違っていると、 +それは受け付けられずエラーメッセージが表示されます。 +この修飾子は +マシン依存ルーチンによってサポートされているときのみ使うことができます。 +.Pp +.Sy 警告 : +ユーザテキストが通常のユーザ空間デバッガによってシャドウされている場合は、 +ユーザ空間のブレークポイントは正しく動作しません。 +また、低レベルのコードパスにおいてブレークポイントをセットすると +奇妙なことも起こるかもしれません。 + +.It Cm delete Ar addr +.It Cm delete Li \&# Ns Ar number +ブレークポイントを削除します。 +削除対象のブレークポイントは +.Li # +でブレークポイント番号を指定するか、 +元の +.Cm break +コマンドで指定したものと同じ +.Ar addr +によって指定します。 + +.It Cm step Ns Op Cm /p +.Ar count +回シングルステップで実行します +(ここではカンマは必ず付けなければなりません)。 +修飾子 +.Li p +が指定されると、各ステップ毎に命令を表示します。 +これが指定されない場合は、最後の命令のみを表示します。 +.Pp +.Sy 警告 : +マシンのタイプによって異なります。 +いくつかの低レベルのコードパスやユーザコードのシングルステップ実行は +できないかもしれません。 +ソフトウェアによってシングルステップをエミュレートしているマシン +(例: pmax) では、割り込みハンドラで実行されているコードからの +ステップ実行はおそらく間違ったことを行うことになるでしょう。 + +.It Cm continue Ns Op Cm /c +ブレークポイントかウォッチポイントまで実行を継続します。 +修飾子 +.Li c +が指定されると、実行中の命令をカウントします。 +pmax のようないくつかのマシンでは load と store もカウントします。 +.Pp +.Sy 警告 : +カウント中はデバッガは何も表示せずにシングルステップを実行しています。 +これは低レベルのコードでのシングルステップ実行が奇妙な振舞いを引き起こす +かもしれないことを意味しています。 + +.It Cm until Ns Op Cm /p +次の call か return 命令で止まります。 +修飾子 +.Li p +が指定されると、 +深くネストした call と命令の累積カウントを各 call もしくは return +で表示します。 +この指定がなければ、マッチする return にヒットした時にのみ表示します。 + +.It Cm next Ns Op Cm /p +.It Cm match Ns Op Cm /p +マッチする return 命令で止まります。 +修飾子 +.Li p +が指定されると、 +深くネストした call と命令の累積カウントを各 call もしくは return +で表示します。 +この指定がなければ、マッチする return にヒットした時にのみ表示します。 + +.It Xo +.No Cm trace Ns Op Cm /u +.Op Ar frame +.Op Ar ,count +.Xc +スタックトレース。 +オプション +.Li u +を指定すると、ユーザ空間をトレースします。 +これがなければ、 +.Cm trace +はカーネル空間のみをトレースします。 +.Ar count +はトレースされるフレーム数です。 +.Ar count +が省略されると、全てのフレームが表示されます。 +.Pp +.Sy 警告 : +ユーザ空間スタックトレースは、 +マシン依存コードによってサポートされている場合のみ有効となります。 + +.It Xo +.No Cm search Ns Op Cm /bhl +.Ar addr +.Ar value +.Op Ar mask +.Op Ar ,count +.Xc +メモリ中で +.Ar value +を検索します。 +もし検索した値が見つからなければ、 +このコマンドは興味深い方法で失敗するでしょう。 +これは ddb がメモリを不正にアクセスした場合に常にリカバーしているわけでは +ないことに起因しています。 +オプションの引数 +.Ar count +によって検索を制限します。 + +.It Cm show all procs Ns Op Cm /m +.It Cm ps Ns Op Cm /m +全てのプロセスの情報を表示します。 +プロセスの情報はマシンによってサポートされていない場合や、 +ターゲットのプロセスのスタックの底がその時にメインメモリにない場合は +表示されないかもしれません。 +修飾子 +.Li m +によって、プロセスの VM マップアドレスを表示し、 +他の情報を表示しないようにできます。 + +.It Cm show registers Ns Op Cm /u +レジスタセットを表示します。 +オプション +.Li u +が指定されると、カーネルか現在セーブされているものの代わりに +ユーザレジスタが表示されます。 +.Pp +.Sy 警告 : +修飾子 +.Li u +のサポートはマシンに依ります。 +サポートされていない場合は、正しくない情報が表示されるでしょう。 + +.It Xo +.Cm show map Ns Op Cm /f +.Ar addr +.Xc +.Ar addr +における VM マップを表示します。 +修飾子 +.Li f +が指定されると、完全なマップが表示されます。 + +.It Xo +.Cm show object Ns Op Cm /f +.Ar addr +.Xc +.Ar addr +における VM オブジェクトを表示します。 +オプション +.Li f +が指定されると、完全なオブジェクトが表示されます。 + +.It Cm "show watches" +全てのウォッチポイントを表示します。 + +.It Xo +.Cm watch +.No Ar addr Ns Li \&, Ns Ar size +.Xc +ある領域にウォッチポイントをセットします。 +その領域への変更が試みられた時に、実行は停止します。 +引数 +.Ar size +のデフォルトは 4 です。 +間違った空間アドレスを指定すると、その要求は拒否されエラーメッセージが +表示されます。 +.Pp +.Sy 警告 : +ハードコーディングされたカーネルメモリをウォッチポイントにセットすると、 +i386 のようないくつかのシステムでは復旧不可能なエラーが発生することがあります。 +ユーザアドレスでのウォッチポイントがもっともうまく動作します。 + +.It Cm gdb +リモート GDB モードと DDB モードを切替えます。 +リモート GDB モードでは、 +リモートデバッグ機能を使って +.Xr gdb 1 +を実行するためにターゲットマシンのシリアルコンソールに接続されているもう +1 台のマシンが必要となります。 +現在は +.Em i386 +アーキテクチャでのみ利用することができます。 + +.It Cm help +利用可能なコマンドとコマンドの短縮形の要約を表示します。 + +.El + +.Sh 変数 +デバッガはレジスタと変数を +.No Li \&$ Ns Em name +としてアクセスします。 +レジスタ名は +.Dq Cm show registers +コマンドで示されるものです。 +変数には変数名の頭に数字を付加したり、 +変数名の直後にコロンに続いていくつかの修飾子を指定することができます。 +たとえば、レジスタ変数は +.Li $eax:u +のように修飾子 +.Li u +をつけてユーザレジスタを表すことができます。 +.Pp +現在サポートされているビルトイン変数には次のものがあります。 +.Bl -tag -width tabstops -compact +.It Li radix +入力と出力の基数 +.It Li maxoff +offset が maxoff より大きくなければ、 +アドレスは 'symbol'+offset として表示されます。 +.It Li maxwidth +表示行の幅 +.It Li lines +行数。"more" 機能で使われます。 +.It Li tabstops +タブストップ幅。 +.It Li work Ns Ar xx +ワーク変数。 +.Ar xx +は 0 から 31 の値をとることができます。 +.El +.Sh 式 +.Sq Li \&~ +と +.Sq Li \&^ +と +単項演算子の +.Sq Li \&& +を除き、C 言語のほとんど全ての式の演算子がサポートされています。 +.Nm +での特別ルールは以下の通りです。 +.Bl -tag -width Identifiers +.It Em 識別子 +シンボルの名称はシンボルの値に翻訳されます。 +それは対応するオブジェクトのアドレスとなります。 +.Sq Li \&. +と +.Sq Li \&: +は識別子に使うことができます。 +オブジェクトフォーマット依存ルーチンによってサポートされていれば、 +.No Xo +.Op Em filename Ns Li \&: +.Em func Ns Li \&: Ns Em lineno +.Xc +と +.No Xo +.Op Em filename Ns Li \&: +.Em variable +.Xc +と +.No Xo +.Op Em filename Ns Li \&: +.Em lineno +.Xc +はシンボルとして受け入れられます。 +.It Em 数字 +基数は最初の 2 文字で決定されます。 +.Li 0x +は 16 進数, +.Li 0o +は 8 進数, +.Li 0t +は 10 進数となり、これらの他は現在の基数にしたがいます。 +.It Li \&. +`dot' +.It Li \&+ +`next' +.It Li \&.. +検査した最後の行の始めのアドレス。 +`dot' や `next' とは違い、これは +.Dq Li examine +か +.Dq Li write +コマンドでのみ変更されます。 +.It Li \&' +明示的に指定した最後のアドレス。 +.It Li \&$ Ns Em variable +指定された変数の値に翻訳されます。 +これに +.Li : +と修飾子を前述したように続けることができます。 +.It Em a Ns Li \&# Ns Em b +左側を右側の次の倍数に切り上げる 2 項演算子。 +.It Li \&* Ns Em expr +間接。 +これに +.Sq Li : +と修飾子を前述したように続けることができます。 +.El +.Sh 関連項目 +.Xr gdb 1 +.Sh 歴史 +.Nm +デバッガは Mach 用に開発され、386BSD 0.1 に移植されました。 +このマニュアルページは Garrett Wollman によって +.Fl man +マクロから書き換えられました。 diff --git a/ja_JP.eucJP/man/man4/de.4 b/ja_JP.eucJP/man/man4/de.4 new file mode 100644 index 0000000000..64253942f4 --- /dev/null +++ b/ja_JP.eucJP/man/man4/de.4 @@ -0,0 +1,119 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: de.4,v 1.5 1998/03/12 07:30:31 charnier Exp % +.\" jpman %Id: de.4,v 1.4 2000/05/11 12:10:13 isaki Stab % +.\" +.Dd January 19, 1997 +.Dt DE 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm de +.Nd +DEC DC21x4x イーサネットデバイスドライバ +.Sh 書式 +.Cd "device de0" +.Sh 解説 +.Nm +ドライバは Digital Equipment DC21x4x 由来のそれ自身も含むイーサネットチップ +を積んだイーサネットアダプタをサポートするために用意されています。 +.Pp +このドライバは DEC PCI DE435 カード, DEC EISA DE425, DEC DE450, DEC DE500, +SMC 8432, 9332, 9334, Cogent EM100FX, EM440TX, Asante, ZNYX ZX3xx や 21040 +及び 21041 イーサネットコントローラあるいは 21140[A], 21141, 21142 及び +21143 ファスト 100Mbps イーサネットコントローラを積んだ他のカードをサポート +します。 +.Pp +.Nm +ドライバは以下のメディアタイプをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を可能にします。 +.It 10baseT/UTP +10baseT ポート上で 10Mbps による動作にセットします。 +.It 10base2/BNC +BNC ポート上で 10Mbps による動作にセットします。 +.It 10base5/AUI +AUI ポート上で 10Mbps による動作にセットします。 +.It 100baseTX +100Mbps (ファストイーサネット) による動作にセットします。 +.It 100baseFX +100Mbps による動作にセットします。 +.It 100baseT4 +100Mbps による動作にセットします (4-pair cat-3 cable)。 +.El +.Pp +.Nm +ドライバは以下のメディアオプションをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxx +.It full-duplex +全二重による動作にセットします。 +.El +.Pp +利用できるメディアタイプは使用する個々のカードに依存します。セットアップ +ユーティリティによって特定のメディアタイプにはっきりとプログラムする +カードや変更できないカードがあります。 +.Pp +あなたの特定のカードにサポートされているメディアタイプを列挙するために +.Xr ifconfig 8 +コマンド、特に +.Fl m +フラグを使用します。 +.Pp +古い設定方法である +.Dq ifconfig linkN +はサポートされていません。 +.Sh 診断 +.Bl -diag +.It "de%d: waking device from sleep/snooze mode" +21041 と 21140A チップはカードのサスペンド操作をサポートしています。 +.It "de%d: error: desired IRQ of %d does not match device's actual IRQ of %d" +デバイスプローブは、ボードがカーネル設定ファイルに指定されたのとは異なる +割り込みで構成されていることを検出しました。 +.It "de%d: not configured; limit of %d reached or exceeded" +1 台のマシンで許されている +.Nm +デバイスには 32 個の制限があります。 +.It "de%d: not configured; 21040 pass 2.0 required (%d.%d found)" +.It "de%d: not configured; 21140 pass 1.1 required (%d.%d found)" +チップセットの一定のリビジョンはサポートされていません。 +.El +.Sh 警告 +21040 は EISA と PCI の両方のボードで利用できるので、カーネルコンフィグ +ファイルでの 21040 の定義の方法に注意すべきです。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 作者 +.Nm +デバイスドライバは +.An Matt Thomas +によって書かれました。 +このマニュアルページは +.An David E. O'Brien +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/dgb.4 b/ja_JP.eucJP/man/man4/dgb.4 new file mode 100644 index 0000000000..7b90a81b5d --- /dev/null +++ b/ja_JP.eucJP/man/man4/dgb.4 @@ -0,0 +1,364 @@ +.\" Copyright (c) 1990, 1991 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Systems Programming Group of the University of Utah Computer +.\" Science Department. +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" from: @(#)dca.4 5.2 (Berkeley) 3/27/91 +.\" jpman %Id: dgb.4,v 1.3 2000/05/09 22:59:18 yt-kage Stab % +.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp +.\" from: sio.4,v 1.15 1994/12/06 20:14:30 bde Exp +.\" %Id: dgb.4,v 1.7 1997/03/03 18:47:38 bde Exp % +.\" +.\" WORD: alternate pinout 結線交換 [man-jp-reviewer 1629-1631] +.Dd Oct 13, 1995 +.Dt DGB 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm dgb +.Nd DigiBoard インテリジェントシリアルカードドライバ +.Sh 書式 +.Cd "options" \&"NDGBPORTS=8\&" +.\" ↓閉じ " を追加 (send-pr docs/14684 HEAD RELENG_3 に適用済) +.Cd "device dgb0 at isa? tty port 0x220 iomem 0xfc0000 iosiz ? flags 0x0" +値は全部ただの例です。 +.Pp +\fBNDGBPORTS\fR オプションは、システムにインストールされている +全てのカード上のポート数の合計を定義します。 +数が定義されていない場合は計算によって求められます: +.br + デフォルトの \fBNDGBPORTS\fR = 記述された DigiBoard カードの数 * 16 +もしこの数字が実際のポート数よりも小さかった場合、 +システムは先頭から \fBNDGBPORTS\fR 番目のポートまでしか +使うことができません。 +もしこの数字が実際のポート数よりも大きかった場合、 +全てのポートを使用できますが、若干のメモリが無駄になります。 +.Pp +\fBflags\fR の意味: +.br +\fB0x0001\fR 結線交換 (DCD と DSR の線を交換) を使用します。 +.br +\fB0x0002\fR PC/Xe の 8K ウィンドウモードを使用しません。 +.Pp +デバイス番号: +.br +0b\fICC\fRmmmmmmmm\fIOLIPPPPP\fR +.br + \fBCC\fRard number +.br + mmmmmmmm\fRajor number +.br + call\fBO\fRut +.br + \fBL\fRock +.br + \fBI\fRnitial +.br + \fBPPPPP\fRort number +.Sh 解説 +.Nm dgb +ドライバは +.Tn EIA +.Tn RS-232C +.Pf ( Tn CCITT +.Tn V.24 ) +標準に準拠し、非同期インタフェースを備えた +DigiBoard PC/Xe シリーズと PC/Xi シリーズの +インテリジェントシリアルマルチポートカードをサポートします。 +.Pp +各ラインの入出力は以下のボーレートのどれか一つに設定できます; +50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, +19200, 38400, 57600, 更に新しいカードのバージョンでは 115200。 +.Pp +ドライバは割り込みを使わず、``ポーリングベース''で動きます。 +このことはドライバが DigiBoard カードの生成する割り込みでなく、 +クロック割り込みを使用することを意味しており、 +カードの状態を 1 秒あたり 25 回チェックします。 +この方法は実用的です。なぜなら、 +DigiBoard カードは大きな入出力バッファ (ポートあたり 1 KByte 以上) と、 +注意の必要なポートを効率良く見つけられるハードウェアを +持っているからです。 +このポリシを用いることでみられる問題点は、SLIP や PPP のレスポンスが +遅くなるということだけです。 +.Pp +カーネル設定ファイルの各行には +.Xr sio 4 +ドライバのようにポートを記述するのではなく、カードを記述します。 +.Pp +.Em flags +キーワードをカーネル設定ファイルの各 +.Em "device dgb" +行で用いると、インタフェースの結線を変更したり、PC/Xe カードで +8 K メモリウィンドウ互換モード (64K メモリウィンドウ) を使用したり +できます。8K メモリウィンドウを使用すると、入出力バッファが小さくなる +というわけではないことに注意してください。ただ、全てのバッファが +同じメモリアドレスにマップされ、必要に応じて切り替わるというだけの +ことです。 +.Pp +.Em port +値はカードのジャンパで設定された +.Em port +値と同じでなければなりません。 +PC/Xi カードでは +.Em iomem +値についても同じことがいえます。この値は、カードのジャンパで +設定されたメモリアドレスと同じでなければなりません。 +.\"Some documentation gives the address as a ``paragraph'' or ``segment''; +.\"you can get the value of address by adding the digit "0" at end of +.\"paragraph value, e.g., 0xfc000 -> 0xfc0000. +PC/Xe カードではジャンパをこの目的で使う必要はありません。 +実のところ、そのような機能を持ったジャンパは存在しません。 +カーネル設定ファイルの +.Em iomem +に使用したいアドレスを書くだけで良いのです。カードは、そのアドレスを +使うようにプログラムされます。 +.Pp +インストールされた DigiBoard はみな、 +同じメモリアドレス範囲 (他のカードのためのメモリや物理メモリを除く) を +使用します。大容量メモリ (256K や 512K またおそらく 128K でも) を +持った DigiBoard は最初の 1 メガバイト以外のメモリアドレスにマップ +されなければなりません。 +コンピュータが 15 メガバイト以上のメモリを持っていた場合、 +最初の 1 メガバイトのアドレス空間以外には、DigiBoard をマップできる +空間は存在しません。 +この場合コンピュータの総メモリ量を減らす必要があるかもしれません。 +しかし多くのマシンではより良い方法を提供しています。 +そうしたマシンでは、BIOS 設定を用いて、16 番目のメガバイト +(アドレス 0xF00000 - 0xFFFFFF) を ``無効'' にすることができます。 +この設定により、DigiBoard のアドレス空間をこの ``穴'' に設定することが +できるようになります。 +.\" XXX the following should be true for all serial drivers and +.\" should not be repeated in the man pages for all serial drivers. +.\" It was copied from sio.4. The only changes were s/sio/dgb/g. +.Pp +.Nm dgb +ドライバによって制御されるシリアルポートは `着呼' と `発呼' のどちらにでも +使用できます。 +それぞれのポートに対し、着呼デバイスと発呼デバイスが存在します。 +発呼デバイスのマイナ番号には、対応する着呼ポートのものより 128 だけ +大きい番号がついています。 +一般的な用途には、着呼デバイスを使います。 +着呼デバイスをオープン途中のプロセスは、通常はキャリアを待ち、また +発呼デバイスが活動状態でなくなるまで待ちます。 +発呼デバイスを使用することで、着呼デバイスでキャリア待ちしている +プロセスの隙をついてポートを使用することができます。 +発呼デバイスをオープンしようとするプロセスはキャリア待ちをしません。 +かつ、発呼デバイスをオープンしようとするプロセスは、着呼デバイス上でキャリア待ち +している他のプロセスをより深いスリープ状態にします。これにより、 +発呼セッションで両プロセスが衝突することはなくなります。 +発呼デバイスを一般的なポートと同じだがキャリア待ちをせずにオー +プンする必要がある、と考えて操作するプログラムがありますが、 +そのような発呼デバイスの使い方は誤用であり、全く馬鹿げています。 +.Pp +また +.Nm dgb +ドライバは、発呼と着呼それぞれのデータデバイスに対する +初期状態制御デバイスとロック状態制御デバイスをサポートします。 +初期状態デバイスのマイナ番号には、対応するデータデバイスより 32 だけ大きい番号が +ついています。 +ロック状態デバイスのマイナ番号には、対応するデータデバイスより 64 だけ大きい番号が +ついています。 +データデバイスにおける termios の設定は、初めてオープンする際に対応する +初期状態デバイスより複製され、直前にオープンされていたときの状態からは +継承されません。 +初期状態デバイスに対して普段通りの方法で +.Xr stty 1 +を +使用することで、 +あなたの望む設定に適した初期 termios 状態をプログラムできます。 +.Pp +ロック termios の状態は、データデバイスの termios 状態の変更を +不可能にするフラグとして +振舞います。例えば CRTSCTS のようなフラグ変数をロックするには、 +ロック状態デバイスで +.Em "stty crtscts" +を実行します。 +速度や特殊文字の設定をロックするには、 +ロック状態デバイス上の対応する値を 0 でない値に設定するとよいです。 +.Pp +外部デバイスを正しく結線して正しいプログラムで通信している限りは、 +.\" XXX change next line in other man pages too, and rewrite this paragraph. +ほぼどのような初期状態であっても、ロックなしで動作します。 +そうでない場合は、デフォルトの初期状態を変更し、その状態にロックを掛ける +ことで、うまく動くようになることもあるかもしれません。 +特に、(POSIX) 標準でないフラグの初期状態は、 +接続されたデバイスに合うように設定すべきであり、 +バグのあるプログラムがこれらのフラグを変更しないように、 +ロックする必要があるかもしれません。 +例えば、常時 RTS/CTS ハンドシェイクをサポートするデバイスでは、CRTSCTS は +オンの状態でロックしておく必要があります。また、全くサポートしないデバイスに +対しては、オフの状態でロックしておくべきです。 +CLOCAL は、キャリアをサポートしないデバイスに対してはオンの状態でロックするべきです。 +HUPCL は、何らかの理由で切断したくない場合にはオフの状態でロックするべきです。 +一般的に、何かが間違った状態でロックすると、とても悪いことが起こります。 +また、複数の設定をサポートするデバイスに対してはロックを行なうべきではありません。 +着呼ポートでの CLOCAL フラグは、login のある種のセキュリティホールを +避けるためにオフの状態にロックしておくべきですが、着呼ポートを何か他の用途に +使う場合には、この設定を getty で行なうべきです。 +.Sh 関連ファイル +.Bl -tag -width /dev/ttyiD?? -compact +.It Pa /dev/ttyD?? +着呼ポート +.It Pa /dev/ttyiD?? +.It Pa /dev/ttylD?? +対応する着呼初期状態デバイスとロック状態デバイス +.Pp +.It Pa /dev/cuaD?? +発呼ポート +.It Pa /dev/cuaiD?? +.It Pa /dev/cualD?? +対応する発呼初期状態デバイスとロック状態デバイス +.El +.Pp +.Bl -tag -width /etc/rc.serial -compact +.It Pa /etc/rc.serial +初期状態とロック状態デバイス設定の例 +.El +.Pp +これらのデバイス名の 1 つめの疑問符はカード番号 (0 から 65535 まで +10 進数。0 および 65535 を含みます) の略です。 +2 つめの疑問符はポート番号 ([0-9a-v]の間の文字) の略です。 +.Sh 診断 +ソースファイル dgb.c の先頭にある DEBUG を定義することにより、 +拡張された診断を得ることができます。 +.Bl -diag +.It dgb\fIX\fB: warning: address \fIN\fB truncated to \fIM\fB +PC/Xe 用の 8K ウィンドウのメモリアドレスが正しく配置されていないか +(8K 境界に配置されるべきです)、最初の 1 メガバイトの範囲外です。 +.El +.Bl -diag +.It dgb\fIX\fB: 1st reset failed +カードの I/O ポートへのアクセスに問題があります。おそらく +カーネル設定ファイルにおいて、間違った \fBport\fR 値が指定されています。 +.El +.Bl -diag +.It dgb\fIX\fB: 2nd reset failed +ハードウェアに問題があります。 +.El +.Bl -diag +.It dgb\fIX\fB: \fIN\fB[st,nd,rd,th] memory test failed +カードのメモリへのアクセスに問題があります。おそらく +カーネル設定ファイルにおいて、間違った \fBiomem\fR 値が指定されています。 +.El +.Bl -diag +.It dgb\fIX\fB: BIOS start failed +オンボード BIOS の起動に問題があります。おそらく DigiBoard の +メモリアドレスが、何か他のデバイスあるいは RAM と重なっています。 +.El +.Bl -diag +.It dgb\fIX\fB: BIOS download failed +オンボード BIOS に問題があります。おそらく DigiBoard の +メモリアドレスが、何か他のデバイスあるいは RAM と重なっています。 +.El +.Bl -diag +.It dgb\fIX\fB: FEP code download failed +フロントエンドプロセッサのマイクロ OS のダウンロードに問題があります。 +おそらく DigiBoard の +メモリアドレスが、何か他のデバイスあるいは RAM と重なっています。 +.El +.Bl -diag +.It dgb\fIX\fB: FEP/OS start failed +フロントエンドプロセッサのマイクロ OS の起動に問題があります。 +おそらく DigiBoard の +メモリアドレスが、何か他のデバイスあるいは RAM と重なっています。 +.El +.Bl -diag +.It dgb\fIX\fB: too many ports +この DigiBoard は、自分が 32 より多くのポートを持っていると報告してきました。 +おそらくハードウェアの問題があるか、 DigiBoard の +メモリアドレスが、何か他のデバイスあるいは RAM と重なっています。 +.El +.Bl -diag +.It dgb\fIX\fB: only \fIN\fB ports are usable +NDGBPORTS パラメータが小さすぎるため、このカードには \fIN\fR ポート +分の空間しか割り当てられません。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB is broken +オンボードの診断プログラムが、指定されたポートにハードウェア上の問題が +あると報告しました。 +.El +.Bl -diag +.It dgb\fIX\fB: polling of disabled board stopped +ドライバのポーリングロジックに内部的な問題が生じました。 +.El +.Bl -diag +.It dgb\fIX\fB: event queue's head or tail is wrong! +ドライバかハードウェアに内部的な問題が生じました。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB: got event on nonexisting port +物理的に存在するポートの状態に何らかの変化がありましたが、 +設定が正しくないため使用できません。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB: event \fIN\fB mstat \fIM\fB lstat \fIK\fB +ドライバはカードから得体の知れないイベントを受けとりました。 +おそらくイベントリストが拡張された新しいカードを使用しているか、 +それ以外の何かハードウェア上の問題です。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB: overrun +入力バッファが一杯になりました。 +ドライバのポーリングロジックに問題があります。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB: FEP command on disabled port +ドライバに内部的な問題が生じました。 +.El +.Bl -diag +.It dgb\fIX\fB: port \fIY\fB: timeout on FEP command +ハードウェアに問題があります。 +.Sh 関連項目 +.Xr stty 1 , +.Xr termios 4 , +.Xr tty 4 , +.Xr MAKEDEV 8 , +.Xr comcontrol 8 +.\" XXX add next line to many other drivers. +.Sh 歴史 +.Nm +ドライバは +.Xr sio 4 +ドライバと +.Tn Linux +の DigiBoard ドライバに由来しており、現在開発継続中です。 +.Sh バグ +BREAK 送信の実装は完全ではありません。 +どのような場合でも 1/4 秒の固定長で BREAK を送信します。 +.Pp +.Xr select 2 +の実装にバグがありました。 +この問題は現在は修正されていますが、まだ広範囲なテストはされていません。 +.Pp +ditty コマンドはありません。その機能の多く (結線交換、 +115200 ボーへの速度向上など) はドライバ自身に実装されています。 +それ以外のいくつかの機能は欠けています。 diff --git a/ja_JP.eucJP/man/man4/divert.4 b/ja_JP.eucJP/man/man4/divert.4 new file mode 100644 index 0000000000..89f2c3bd1c --- /dev/null +++ b/ja_JP.eucJP/man/man4/divert.4 @@ -0,0 +1,177 @@ +.\" %Id: divert.4,v 1.12 1998/06/05 23:20:12 julian Exp % +.\" jpman %Id: divert.4,v 1.3 2000/05/30 09:19:15 isaki Stab % +.\" +.\" WORD: divert 迂回 +.\" +.Dd June 18, 1996 +.Dt DIVERT 4 +.Os FreeBSD +.Sh 名称 +.Nm divert +.Nd カーネルによるパケット迂回メカニズム +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket PF_INET SOCK_RAW IPPROTO_DIVERT +.Sh 解説 +.Pp +迂回ソケットは +.Xr bind 2 +システムコールを経由して特定の +.Nm +ポートにバインドすることができることを除き、 +生の IP ソケットとほぼ同じです。 +bind での IP アドレスは無視され、ポート番号のみが意味を持ちます。 +迂回ポートにバインドされた迂回ソケットは、 +何らか (ここでは特定しません) の +カーネルメカニズムによってそのポートに迂回された全てのパケットを受信します。 +パケットを迂回ポートに書き込むこともできます。 +その場合はカーネルの IP パケット処理に再び入力されます。 +.Pp +通常、迂回ソケットは FreeBSD のパケットフィルタリングの実装や +.Xr ipfw 8 +プログラムと共に使われます。 +迂回ソケットからの読み出しや書き込みによって、 +合致するパケットをホストマシンを経由する時に任意の ``フィルタ'' を通したり、 +特別なルーティングの細工を行うといったことができます。 +.Sh パケットを読む +\``入ってくるパケット'' であっても ``出ていくパケット'' であっても迂回 +させることができます。 +入力パケットは IP インタフェース上で受信された後に迂回されます。 +出力パケットは次のホップに転送する前に迂回されます。 +.Pp +迂回パケットは +.Xr read 2 , +.Xr recv 2 , +もしくは +.Xr recvfrom 2 +によってそのままの形で読み出すことができます。 +後者の場合に得られるアドレスでは、 +ポート番号にはパケット迂回者が提供するなんらかのタグ +(通常は ipfw のルール番号) が設定され、 +IPアドレス部には +入力パケットの場合はパケットが受信された (最初の) インタフェースアドレス、 +出力パケットの場合は +.Dv INADDR_ANY +が設定されます。 +入力パケットの場合はアドレスに続く 8 バイトの中に +インタフェース名も (そこに収まるものとして) おかれます。 +.Sh パケットを書く +迂回ソケットへの書き込みは生の IP ソケットへの書き込みと似ています。 +パケットは ``そのままの'' 形で通常のカーネル IP パケット処理へ送られ、 +最小のエラーチェックのみが行われます。 +パケットは入力としても出力としても書くことができます。 +すなわち +.Xr write 2 +もしくは +.Xr send 2 +がパケットの配送に使われるか、 +.Xr sendto 2 +が +.Dv INADDR_ANY +の宛先 IP アドレスと共に使われると、 +パケットはそれが出力であるかのように扱われます。 +つまりローカルでないアドレスへ差し向けられます。 +その他の場合は、入力であると想定され、 +全てのパケットルーティングが実行されます。 +.Pp +後者の場合では、 +指定された IP アドレスは、 +どれかのローカルインタフェースのアドレスと一致するか、 +インタフェース名が IP アドレスの後に見つからなければなりません。 +もしインタフェース名が見つかれば、 +そのインタフェースが使われ、IP アドレスの値は無視されます +(それが +.Dv INADDR_ANY +でないことは無視されません)。 +これは、どのインタフェースからパケットが ``到着'' したかを示すためです。 +.Pp +通常、入力として読み出されるパケットは入力として書かれなければなりません。 +出力パケットについても同様です。 +パケットを読み出して書き戻す時には、 +.Xr recvfrom 2 +によって与えられたソケットアドレスと同じものを、そのままの形で +.Xr sendto 2 +に渡すことで物事が単純になります (下記参照)。 +.Pp +.Xr sendto 2 +へ渡されるソケットアドレスのポート部分には、 +迂回モジュールにとって意味のあるタグが含まれます。 +.Xr ipfw 8 +の場合には、タグは、 +.Em この次の +ルール番号からルール処理を再開すべきと解釈されます。 +.Sh ループの回避 +迂回ソケットへ ( +.Xr sendto 2 +を使って) 書き込まれたパケットは、 +ソケットアドレスのポート部分に与えられたタグに続くルール番号から、 +パケットフィルタに再入されます。 +通常、ソケットアドレスは迂回を発生させる +(同じ番号においていくつかのルールがある場合は次のルールではない) +ルール番号においてすでにセットされています。 +もし 'タグ' が別の再入点を示すために置き換えられていれば、 +同じパケットが同じルールで 1 度以上迂回されるようなループを +回避するための考慮がなされるべきです。 +.Sh 詳細 +迂回ソケットを有効とするためには、 +.Dv IPDIVERT +オプションを指定してカーネルをコンパイルしなければなりません。 +.Pp +パケットは迂回されるがポートにバインドされるソケットがない場合、 +もしくは +.Dv IPDIVERT +がカーネルにおいて有効にされていない場合は、パケットは捨てられます。 +.Pp +迂回される入力パケットフラグメントは配送前に全てリアセンブルされます。 +フラグメントが 1 つでも迂回されると全てのパケットが迂回されることになります。 +もし、フラグメントのいくつかが違うポートに迂回されると、 +最後にどのポートが選択されるかは予期できません。 +.Pp +パケットは受信されて、変更されずに送信されますが、 +出力として書かれたパケットの IP ヘッダのチェックサムは +正しい値に書き換えられます。 +入力として書かれ、誤ったチェックサムを持つパケットは捨てられます。 +それら以外は、全てのヘッダフィールドは変更されません +(もちろんネットワークに届いた順番で)。 +.Pp +タイプ SOCK_RAW のソケットの生成と同様に、 +1024 より小さいボート番号をバインドするためには +スーパユーザアクセスが必要となります。 +.Sh エラー +生のパケットの書き込み時に通常発生するエラーに加え、 +迂回ソケットへの書き込みは以下のエラーを返すことがあります。 +.Bl -tag -width Er +.It Bq Er EINVAL +パケットのヘッダが不正か、 +パケットの IP オプションと設定されたソケットのオプションに不整合があります。 +.It Bq Er EADDRNOTAVAIL +宛先アドレスに含まれる IP アドレスは、 +.Dv INADDR_ANY +と等しくなく、 +どのインタフェースにも関連づけられていません。 +.El +.Sh 関連項目 +.Xr bind 2 , +.Xr recvfrom 2 , +.Xr sendto 2 , +.Xr socket 2 , +.Xr ipfw 8 +.Sh バグ +これはユーザモードプロセスがアドレス変換のような様々な IP +の細工を実装するためのすっきりした方法を提供することを試みたものです。 +しかし、もっとすっきりさせることができるでしょうし、 +.Xr ipfw 8 +に依存しすぎています。 +.Pp +入力のフラグメントが迂回の前に再構成されるべきかどうか +については疑問の余地があります。 +例えば、他のマシン宛のパケットのうち数個のフラグメントが +ローカルマシン経由でルーティングされないだけで、 +パケットが失われます。 +これはおそらく何らかの方法で設定可能なオプションにするべきです。 +.Sh 作者 +.An Archie Cobbs Aq archie@whistle.com , +Whistle Communications Corp. diff --git a/ja_JP.eucJP/man/man4/dpt.4 b/ja_JP.eucJP/man/man4/dpt.4 new file mode 100644 index 0000000000..9080be2ca4 --- /dev/null +++ b/ja_JP.eucJP/man/man4/dpt.4 @@ -0,0 +1,79 @@ +.\" +.\" Copyright (c) 1998 Justin T. Gibbs +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: dpt.4,v 1.1 1998/10/16 22:00:55 ken Exp % +.\" jpman %Id: dpt.4,v 1.3 1999/10/06 10:51:50 horikawa Stab % +.\" +.Dd October 16, 1998 +.Dt DPT 4 i386 +.Os FreeBSD 3.0 +.Sh 名称 +.Nm dpt +.Nd DPT RAID コントローラ SCSI ドライバ +.Sh 書式 +1 つ以上の EISA コントローラに対し +.Cd "controller eisa0" +.Cd "controller dpt0" +.Pp +1 つ以上の PCI コントローラに対し +.Cd "controller pci0" +.Cd "controller dpt0" +.Pp +PCI アダプタがメモリマップ I/O を使用できるようにするには +以下の指定を有効とする。 +.Cd options DPT_ALLOW_MEMIO +.Pp +.Sh 解説 +.Nm +ドライバは +DPT Smart Cache Plus, Smart Cache III, Smart Raid III, Smart Cache IV, +Smart RAID IV ファミリのサポートを提供します。 +.Sh 関連ファイル +.Bl -tag -width /usr/share/man0/template.doc -compact +.It Pa sys/dev/dpt/dpt_scsi.c +コアドライバの実装 +.It Pa sys/dev/dpt/dpt.h +レジスタセットとコアドライバのデータ構造 +.It Pa sys/pci/dpt_pci.c +PCI バスドライバに付属するもの +.It Pa sys/i386/eisa/dpt_eisa.c +EISA バスドライバに付属するもの +.El +.Sh 関連項目 +.Xr cd 4 , +.Xr ch 4 , +.Xr scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh 作者 +.Nm +ドライバは +.An Simon Shapiro +が記述し、 +.An Justin T. Gibbs +が CAM SCSI システムに移植しました。 +.Sh 歴史 +.Nm +は +.Fx 2.2.6 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/drum.4 b/ja_JP.eucJP/man/man4/drum.4 new file mode 100644 index 0000000000..1cd84a3e9c --- /dev/null +++ b/ja_JP.eucJP/man/man4/drum.4 @@ -0,0 +1,61 @@ +.\" Copyright (c) 1980, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)drum.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: drum.4,v 1.3 1999/08/12 10:59:46 horikawa Stab % +.\" %Id: drum.4,v 1.2 1997/03/07 02:49:22 jmg Exp % +.\" +.Dd June 5, 1993 +.Dt DRUM 4 +.Os BSD 4 +.Sh 名称 +.Nm drum +.Nd ページングデバイス +.Sh 解説 +このファイルはシステムによって使用中のページングデバイスを参照します。 +実際にはいずれかのディスクドライバのサブデバイスかもしれませんが、 +複数のディスクドライブにまたがってインタリーブしてページングするシステムでは、 +複数のドライブへアクセスする間接的なドライバになります。 +.Sh 関連ファイル +.Bl -tag -width /dev/drum +.It Pa /dev/drum +.El +.Sh 歴史 +.Nm +特殊ファイルは +.Bx 3.0 +に初めて登場しました。 +.Sh バグ +drum からの、インタリーブの境界をまたがる読み出しは禁止されています。 +この境界は 0.5M バイトごとにあり、システムはこの境界をまたぐような +."\ 原文は .5Mbytes or so となっているが、 or so を無視 +."\ See [man-jp-reviewer 1241] by mzaki@e-mail.ne.jp +ブロックを割り当てないので、通常はこれが問題になることはありません。 diff --git a/ja_JP.eucJP/man/man4/dummynet.4 b/ja_JP.eucJP/man/man4/dummynet.4 new file mode 100644 index 0000000000..a0f4d9703c --- /dev/null +++ b/ja_JP.eucJP/man/man4/dummynet.4 @@ -0,0 +1,182 @@ +.\" +.\" %Id: dummynet.4,v 1.2 1998/12/21 22:37:53 luigi Exp % +.\" +.\" jpman %Id: dummynet.4,v 1.3 1999/09/26 12:24:30 horikawa Stab % +.Dd Sep 28, 1998 +.Dt DUMMYNET 4 +.Os +.Sh 名称 +.Nm dummynet +.Nd フレキシブルな帯域マネージャおよび遅延エミュレータ +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn setsockopt raw_socket IPPROTO_IP "ipfw option" "struct ipfw" size +.Sh 解説 +dummynet は、帯域幅とキューのサイズに制限を加えたり、パケットの遅延や +損失をシミュレートすることにより、様々なネットワークインターフェイスを +介してやりとりされるトラフィックを制御可能にします。 +.Pp +現在の実装では、パケットの選別は +.Nm ipfw +プログラムの +.Nm ``パイプ'' +ルールにより行われます。 +dummynet の +.Nm パイプ +においては、帯域幅、遅延、キューサイズ、損失率を設定できます。 +これらの設定は +.Nm ipfw +プログラムで行います。 +パイプには 1 から 65534 までの番号がつけられます。また、パケットは +ipfw の設定によっては複数のパイプを介して送出する事が可能です。 +.Pp +dummynet は IP レベルで動作しますが、ブリッジ拡張機能を有効にすることに +より、ブリッジされるパケットをパイプを介して送出できます。 +.Sh 使用法 +下記のコマンドにより、パイプにパケットを送出します。 +.Bd -literal + ipfw add pipe NNN .... +.Ed + +また、パイプの設定は下記のコマンドにより行います。 +.Bd -literal + ipfw pipe NNN config bw B delay D queue Q plr P +.Ed + +ただし、帯域幅 B は、bit/s, Kbit/s, Mbit/s, Bytes/s, KBytes/s, MBytes/s +で表すことができます。 +delay はミリ秒単位で、また、キューサイズはパケット数かバイト数 +により指定します。 +また、plr はパケットがランダムに失われる割合です。 +.Pp +ipfw を正しく動作させることは簡単ではありません。システムが +ルータやブリッジとして機能している場合はなおさらです。 +.Pp +ルータとして機能する場合は、ルーティングされるパケットの入力経路、および、 +出力経路に同じルールセットが適用されますので、パケットが同じパイプを +二度通らないように注意してください (本当にそうしたい場合は別です)。 +.Pp +ブリッジとして機能する時は、ブリッジされるパケットに対して、 +.Nm ipfw +フィルタは、入力経路で一度だけ起動されます。 +.Pp +同様に、真の全二重チャネルをシミュレートする場合には、方向の違う +2 つのパイプを用いるようにしてください。 +例えば、非対象な双方向のリンクをシミュレートする場合のルールセットは +次のようになるでしょう。 +.Bd -literal + ipfw add pipe 1 ip from A to B out + ipfw add pipe 2 ip from B to A in + ipfw pipe 1 config bw 1Mbit/s delay 80ms + ipfw pipe 2 config bw 128Kbit/s delay 300ms +.Ed + +.Pp +.Sh 操作 +.Nm ipfw +のコードは、帯域幅、キューサイズ、遅延、損失を適用するべき +パケットを選別し、それらの制限を記述する ``パイプ'' の識別子を +返します。 +.Pp +選別されたパケットは、まず割り当てられたサイズのキューに蓄えられます。 +キューに蓄えられたパケットは、プログラムされた速さで取り出され、遅延を +シミュレートするための 2 番目のキューに移されます。 +2 番目のキューから取り出される際に、パケットが送られてきたのと同じ +プロトコルスタックに入れられます(例えば ip_input(), ip_output(), +bdg_forward() など)。 +これは sysctl の + sys.net.inet.ipfw.one_pass +の設定値に依存します。 +パイプから出力されたパケットは、パケットの宛先に転送されるか、 +マッチしたルールの後に記述された +.Nm ipfw +のルールに再び渡されます。 +.Pp +.Nm dummynet +はタイマの 1 tick 毎に処理を行います。つまり、処理の周期はカーネル +オプションの +.Bd -literal + options HZ +.Ed + +によって制御されます。デフォルト値 (100) は 10ms 周期を意味します。 +高いデータ速度で正確なシミュレーションを行うためには、タイマ +周期を 1ms 以下に設定する必要があるかもしれません。 +しかし、プログラムによる I/O (programmed I/O) +を用いているインタフェースの中には、 +パケットを出力するのにかなりの時間を要するものがあることに注意して +ください。つまり、タイマ周期を小さくし過ぎると、タイマの周期に処理が +追い付かず、処理の精度を損なってしまうおそれがあります。 + +.Sh カーネルオプション +カーネル設定ファイル内の以下のオプションが +.Nm dummynet +の動作に関係します。 +.Bd -literal + IPFIREWALL - ipfirewall を有効化 (dummynet 使用には必須)。 + IPFIREWALL_VERBOSE - ファイアウォールの詳細出力を有効化。 + IPFIREWALL_VERBOSE_LIMIT - ファイアウォールの詳細出力を制限。 + DUMMYNET - dummynet の処理を有効化。 + NMBCLUSTER - ネットワークパケットバッファの大きさを設定。 + HZ - タイマの周期を設定。 +.Ed +.Pp +通常、下記のオプションは必須です。 +.Bd -literal + options IPFIREWALL + options DUMMYNET +.Ed + +加えて、設定したすべてのパイプの、帯域幅と遅延時間の積と、キューサイズ +の合計によっては、mbuf クラスタ +(ネットワークパケットを蓄えておくために使われます) +の数を増やす方が良いかもしれません。 + +.Sh SYSCTL 変数 +.Pp +.Bd -literal + net.inet.ip.fw.one_pass +.Ed + +パケットがファイアウォールのコードを一度のみ通るようにしたい場合、 +1 に設定します。 +.Bd -literal + net.link.ether.bridge_ipfw +.Ed + +ブリッジされるパケットをファイアウォールのコードに渡したい場合にセットします。 + +.Sh コマンド +パイプを扱うためには、以下のソケットオプションを用います。 +.Pp +IP_DUMMYNET_CONFIGURE は、パイプの設定を更新します。(または新しい +パイプを作成します。) +.Pp +IP_DUMMYNET_DEL は、マッチするルール番号が存在するすべてのパイプを +削除します。 +.Pp +IP_DUMMYNET_GET は、指定した番号にマッチするパイプを返します。 +.Pp +IP_FW_FLUSH 指定した番号にマッチするパイプをフラッシュします。 +.Pp +カーネルセキュリティーレベルが 2 より大きい場合は、 +IP_DUMMYNET_GET のみが使用可能です。 +.Sh 関連項目 +.Xr setsockopt 2 , +.Xr ip 4 , +.Xr ipfw 8 , +.Xr sysctl 8 . +.Sh バグ +このマニュアルページは dummynet 使用方法の全部を記述している +わけではありません。 +.Sh 歴史 +.Nm +dummynet +は、ACM Computer Communication Review, Jan.97 issue に記述されているように、 +TCP の輻輳の制御のために Luigi Rizzo が実装しました。 +その後、IP およびブリッジレベルで機能するように変更され、さらに +IPFW パケットフィルタに統合されました。 diff --git a/ja_JP.eucJP/man/man4/ed.4 b/ja_JP.eucJP/man/man4/ed.4 new file mode 100644 index 0000000000..08ce3ca8db --- /dev/null +++ b/ja_JP.eucJP/man/man4/ed.4 @@ -0,0 +1,191 @@ +.\" +.\" Copyright (c) 1994, David Greenman +.\" 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 David Greenman. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ed.4,v 1.13 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ed.4,v 1.3 1999/08/18 16:40:27 horikawa Stab % +.\" +.Dd October 28, 1995 +.Dt ED 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ed +.Nd 高性能イーサネットデバイスドライバ +.Sh 書式 +.Cd "device ed0 at isa? port 0x280 net irq 5 iomem 0xd8000" +.Cd "device ed1 at isa? port 0x300 net irq 5 iomem 0xd8000" +.Cd "device ed2 at isa? port 0x320 net irq 10 flags 0x4 iosiz 16384 iomem 0xd8000" +.Sh 解説 +.Nm ed +ドライバは、National Semiconductor の DS8390 に基づく +8 または 16 ビットの ISA イーサネットカードと、 +他の会社が製造した同様の NIC (訳注: ネットワークインタフェースカード) +をサポートします。 +.Pp +このドライバは Western Digital が製造したすべての 80x3 シリーズの +ISA イーサネットカードと SMC, SMC Ultra, 3Com 3c503, +Novell NE1000/NE2000, HP PC Lan+ をサポートします。 +.Pp +.Nm +ドライバは独特のマルチバッファ機構を用いて、高い伝送性能を達成しています。 +16 ビット ISA カードを使ったときに、IEEE 802.3 CSMA イーサネットの +理論最大性能の 97% が実現できます。 +.Pp +標準の、ポートや IRQ の指定機能に加え、 +8/16 ビットモードの強制機能、 +マルチバッファの有効化/無効化機能、そして +デフォルトインタフェースタイプの選択機能 +(AUI/BNC、ツイストペアを持つカードでは AUI/10BaseT) +をサポートする、いくつもの +.Em flags +を +.Nm +ドライバはサポートしています。 +.Pp +.Em flags +はビットフィールドであり、まとめると次のようになります: +.Pp +.Bl -hang -offset indent +.It Em 0x01 +トランシーバを無効にします。トランシーバをサポートするカードでは、このフラグ +はトランシーバを無効にして、デフォルトで AUI 接続が使われます。 +.It Em 0x02 +強制的に 8 ビットモードにします。このフラグは、カードが自分をどのように +認識したとしても、強制的に 8 ビットモードにします。このフラグは、 +8 ビットインタフェースしか持っていないにもかかわらず、自分自身を +16 ビットであると誤認識するいくつかのクローンのカードで必要になります。 +.It Em 0x04 +強制的に 16 ビットモードにします。このフラグは、カードが自分をどのように +認識したとしても、強制的に 16 ビットモードにします。このフラグは、 +16 ビット ISA インタフェースを持っているにもかかわらず、自分自身を +8 ビットであると誤認識するいくつかのクローンのカードで必要になります。 +.It Em 0x08 +マルチバッファによる転送を無効にします。このフラグは、複数の転送バッファ +の使用を禁止します。 +送り先のマシンが扱えるよりも速くパケットを送るときに発生する +競合状態 (重大なパケット損失により分かります) で必要になるかもしれません。 +いくつかの +.Pf ( Ns Tn FreeBSD No でない +:-)) マシンは、ひどいイーサネット性能で、単なる 1100K+ データ転送さえも +対処できません。 +このフラグを使うことは、受信バッファをパケット 1 個分増やす価値もあります。 +また、8 ビットカード上では、受信損失を減らす助けになるかもしれません。 +.El +.Pp +3c503 カードを使うとき、 +.Xr ifconfig 8 +に +.Em link2 +オプションを指定することによって、 +AUI 接続を選択してもかまいません (BNC がデフォルト)。 +.Sh 診断 +.Bl -diag +.It "ed%d: kernel configured irq %d doesn't match board configured irq %d." +カーネル設定ファイルの中で指定され (カーネルに組み込まれ) た +IRQ 番号が、インタフェースカードに設定された IRQ と異なっています。 +.It "ed%d: failed to clear shared memory at %x - check configuration." +システムブートの際にカードがプローブされたときに、 +.Nm ed +ドライバがカードの共有メモリをクリアできないことが判明しました。 +これは大抵、BIOS の拡張 ROM がイーサネットカードの共有メモリと +同じアドレスに設定されている場合に起こります。 +ぶつかっているカードをみつけて、 +BIOS ROM を衝突しないアドレスに変更してください。 +または、カードの共有メモリが衝突しないアドレスにマップされるように、 +カーネル設定ファイル内の +.Em iomem +オプションを変更して下さい。 +.It "ed%d: Invalid irq configuration (%d) must be 2-5 for 3c503." +カーネル設定ファイル内で指定されている IRQ 番号が 3Com 3c503 +カードにとって不正です。 +3x503 には、IRQ 2 から 5 までのみ割り当て可能です。 +.It "ed%d: Cannot find start of RAM." +.It "ed%d: Cannot find any RAM, start : %d, x = %d." +カードのパケットメモリの設定中に、Gateway 製カードのプローブに失敗しました。 +これは、誤ってカードを Gateway 製であると認識したか、 +カードが壊れていることを示している可能性が高いです。 +.It "ed: packets buffered, but transmitter idle." +ドライバの論理的な問題を示しています。これはまず起こらないでしょう。 +.It "ed%d: device timeout" +予期された転送割り込みが生じなかったことを示しています。通常、ISA バスの +他のカードとの割り込みの衝突によって起こります。 +.It "ed%d: NIC memory corrupt - invalid packet length %d." +IEEE 802.3 規格で許されている最大長より大きなサイズ +または最小長より短いサイズのパケットが受信されたことを示しています。 +通常、ISA バスの他のカードとの衝突により起こりますが、場合によっては +間違ったケーブルの引き回しを示していることもあります。 +.It "ed%d: remote transmit DMA failed to complete." +これは、NE1000 や NE2000 の型のカードへのプログラム I/O 転送を正しく完了 +できなかったことを示しています。 +通常、ISA バス速度の設定が速過ぎた場合に起こります。 +.El +.Sh 警告 +DS8390 チップの初期リビジョンには問題があります。 +受信リングバッファが溢れると固まってしまうのです。 +ときにはパケットリングヘッダ内の長さフィールドのバイト順を切り替えてしまい +(この原因として off-by-one アラインメントに関連したものが +いくつかあります)、"NIC memory corrupt - invalid packet length" +というメッセージを出力します。 +このような問題が起こるとカードはリセットされますが、 +この状態からの回復に関するその他の問題はありません。 +.Pp +NIC メモリのアクセスは、 +3Com や Novell のカードでは WD/SMC のカードより非常に遅いです。 +8 ビットボードでは +1MB/秒以下、16 ビットカードでは 2MB/秒以下となります。 +著しいネットワークトラフィックがある場合に、リングバッファがあふれて +パケットを落すことになるかもしれません。 +.Pp +16 ビット Compex カードは自分が 8 ビットであると認識します。 +このカードは 8 ビットモードでも動作しますが、カーネル設定ファイルに +.Em "flags 0x04" +(16 ビットモードを強制する) を指定すると、より高い性能が得られます。 +さらに 16 ビットモードが提供する追加の 8k の共有メモリを利用するために、 +.Em "iosize 16384" +も指定した方が良いでしょう。 +.Sh バグ +.Nm ed +ドライバは、不正なパケットを受信したときには、少々積極的にカードを +リセットし過ぎるきらいがあります。 +結果として、受信した正当なパケットで、 +カードから主メモリに転送していないものを、捨ててしまうかもしれません。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm ed +デバイスドライバは、 +.Fx 1.0 +で最初に登場しました。 +.Sh 作者 +.Nm +デバイスドライバと本マニュアルは +.An David Greenman +が書きました。 diff --git a/ja_JP.eucJP/man/man4/el.4 b/ja_JP.eucJP/man/man4/el.4 new file mode 100644 index 0000000000..98c708c962 --- /dev/null +++ b/ja_JP.eucJP/man/man4/el.4 @@ -0,0 +1,58 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: el.4,v 1.7 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: el.4,v 1.3 1999/08/18 16:40:09 horikawa Stab % +.\" +.Dd July 10, 1995 +.Dt EL 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm el +.Nd 3Com Etherlink 3C501 デバイスドライバのためのイーサネットドライバ +.Sh 書式 +.Cd "device el0 at isa? port 0x300 net irq 9" +.Sh 解説 +.Nm +インタフェースは、 +3Com 3c501 8 ビット ISA イーサネットカードのサポートを提供します。 +3c501 カードはかなり遅いことが知られていますので、 +もし可能なら他のイーサネットカードを用いるべきです。 +しかし、10 Mb/s イーサネットネットワークへのアクセスとしては安価です。 +.Pp +有効な I/O ポートは 0x280-0x3f0 の範囲です。 +.Sh バグ +ドライバはカードがカーネルと同じ IRQ に設定されていると仮定します。 +これが正しいかどうか確かめるプローブやチェックは行われていません。 +.Pp +現在、DMA はサポートしていません。 +.Pp +現在、マルチキャストはサポートしていません。 +.Sh 関連項目 +.Xr ed 4 , +.Xr eg 4 , +.Xr ep 4 , +.Xr ie 4 , +.Xr intro 4 , +.Xr le 4 , +.Xr ifconfig 8 diff --git a/ja_JP.eucJP/man/man4/en.4 b/ja_JP.eucJP/man/man4/en.4 new file mode 100644 index 0000000000..d7d40c5d13 --- /dev/null +++ b/ja_JP.eucJP/man/man4/en.4 @@ -0,0 +1,65 @@ +.\" jpman %Id: en.4,v 1.3 1999/09/26 12:24:23 horikawa Stab % +.Dd December 29, 1997 +.Dt EN 4 +.Os BSD +.Sh 名称 +.Nm en +.Nd +Midway ベースの ATM インタフェースのデバイスドライバ +.Sh 書式 +.Cd "device en0" +.Cd "pseudo-device atm" +.Sh 解説 +.Nm +デバイスドライバは Efficient Networks, Inc. ENI-155 と +Adaptec ANA-59x0 を含む、Midway ベースの ATM インタフェースを +サポートしています。 +Midway は +ALL5 SAR (Segmentation and Reassenbly: セル分割・組立サブレイヤ) +チップです。 +.Pp +本ドライバは ATM PVC のみサポートしており、SVC や ATM-ARP +はサポートしていません。 +.Pp +カードに IP の設定をするには以下の様にします: +.Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up +ホストに PVC を加えるには ``route'' コマンドを使用する必要があります: +.Dl # route add -iface -link en0:z.0.x.y +ここで、x と y は使用する VCI のバイト表現形式であり、 +また z は次に示すフラグのバイト表現形式です。 +.Dl 0x01 (AAL5 を使用)、 +.Dl 0x02 (AAL5 を使用する場合、LLCSNAP ヘッダを使用する) +従って、パラメータが 3 の場合は AAL5 及び LLC/SNAP カプセル化 +の使用を意味します。 +BPF は LLC/SNAP カプセル化がされている場合のみ +使用可能であることに注意してください。 +.Sh 使用例 +2 つのホスト 128.252.200.1 と 128.252.200.2 があり、 +これらが PVC # 201 (0xc9) の ATM で接続されていると +仮定しましょう。 +このリンクを有効化するには次の様にコマンドを使用します: +.Dl ホスト 128.252.200.1 上で: +.Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up +.Dl # route add -iface 128.252.200.2 -link en0:3.0.0.c9 +.Pp +.Dl ホスト 128.252.200.2 上で: +.Dl # ifconfig en0 128.252.200.2 netmask 0xffffff00 up +.Dl # route add -iface 128.252.200.1 -link en0:3.0.0.c9 +.Sh 診断 +.Bl -diag +.It "en0 rev 0 int a irq 5 on pci0:16" +.It "en0: ATM midway v0, board IDs 6.0, Utopia (pipelined), 512KB on-board RAM" +.It "en0: maximum DMA burst length = 64 bytes" +.It "en0: 7 32KB receive buffers, 8 32KB transmit buffers allocated" +.El +.Sh 警告 +本ドライバは PCI において DMA を広範囲に使用します。 +初期の PCI チップセットでは動作しないか、十分な性能が出ません。 +.Sh 関連項目 +.Xr ifconfig 8 , +.Xr pvcsif 8 , +.Xr pvctxctl 8 , +.Xr route 8 +.Sh 作者 +1996 年、NetBSD において、Washington University の Chuck Cranor が +EN ドライバを実装しました。 diff --git a/ja_JP.eucJP/man/man4/ep.4 b/ja_JP.eucJP/man/man4/ep.4 new file mode 100644 index 0000000000..9ca7f0f87b --- /dev/null +++ b/ja_JP.eucJP/man/man4/ep.4 @@ -0,0 +1,121 @@ +.\" +.\" Copyright (c) 1994 Herb Peyerl +.\" 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 Herb Peyerl +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ep.4,v 1.9 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ep.4,v 1.3 1999/08/18 16:40:32 horikawa Stab % +.\" +.Dd February 04, 1993 +.Dt EP 4 i386 +.Os +.Sh 名称 +.Nm ep +.Nd +3Com Etherlink III イーサネットデバイスドライバ (3c5x9) +.Sh 書式 +.Cd "device ep0 at isa? port 0x300 net irq 10" +.Sh 解説 +.Nm ep +ドライバは 3c509 (ISA) と 3c579 (EISA) のサポートを提供します。 +これらのカードのさまざまなモデルは、コネクタの配列がそれぞれ異なります。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It AUI/DIX +標準 15 ピンコネクタ +.It 10Base2 +BNC (シンケーブルとしても知られているもの) +.It 10BaseT +UTP (ツイストペアとしても知られているもの) +.El +.Pp +デフォルトで使用されるポートは、 +セットアップユーティリティで選択されているポートです。 +これをオーバライドするには、 +.Xr ifconfig 8 +または +.Pa /etc/rc.conf +ファイルで次のフラグを使用します。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It link0 +AUI ポートを使用 +.It link1 +BNC ポートを使用 +.It link2 +UTP ポートを使用 +.El +.Pp +コンピュータに複数のカードを装着している場合は、次の順番で探されます。 +最初に 3c579 EISA カードが探されます -- +これらは EISA スロット番号順に検出されます。 +次に、3c509 ISA カードが探されます -- +イーサネットアドレスの昇順に検出されます。 +次に、どのようにプローブされるかの例を示します。 +.Pp +ep0 at isa0 port 0x6000-0x600f irq 10: aui/bnc address 00:60:8c:70:e5:c5 +ep1 at isa0 port 0x300-0x30f irq 3: aui/bnc/utp address 00:20:af:10:62:ab +.Pp +カードが発見されることが期待されるポートと IRQ を指定することもできますが、 +この指定は必ずしも必要ではありません。 +カードは ISA バス上での自分の居場所を我々に伝えるに +十分なインテリジェンスを備えているのです。 +.Pp +.Sh 注釈 +3c509 カードにはアドレスを設定するジャンパがありません。 +3Com はカードのアドレスを設定するソフトウェアを提供しています。 +ISA バス上でこのカードを見つけるために、 +カーネルは IO アドレス 0x110 で複雑なスキャン操作を行います。 +注意してください! このアドレスに他のカードを配置することは避けてください。 +.Pp +.Sh 診断 +ep0: reset (status: %x) +.in +4 +ドライバは FIFO のアンダランまたはオーバランを検出しました。ドライバが +カードをリセットし、パケットが失われます。これは致命的ではありません。 +.in -4 +ep0: eeprom failed to come ready +.in +4 +EEPROM の準備ができていません。おそらくカードが死んでいます。 +.in -4 +ep0: 3c509 in test mode. Erase pencil mark! +.in +4 +誰かがカードの上のテスト領域に鉛筆で落書きをしているかもしれません。鉛筆書き +の跡を消してリブートしてください (これはジョークではありません)。 +.in -4 +.Sh 関連項目 +.Xr ed 4 , +.Xr eg 4 , +.Xr el 4 , +.Xr ie 4 , +.Xr intro 4 , +.Xr le 4 , +.Xr vx 4 , +.Xr ifconfig 8 +.Sh 規格 +は偉大なり。豊富な選択肢があります。 + diff --git a/ja_JP.eucJP/man/man4/euc.4 b/ja_JP.eucJP/man/man4/euc.4 new file mode 100644 index 0000000000..5298d2ec12 --- /dev/null +++ b/ja_JP.eucJP/man/man4/euc.4 @@ -0,0 +1,244 @@ +.\" Copyright (c) 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Paul Borman at Krystal Technologies. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)euc.4 8.1 (Berkeley) 6/4/93 +.\" jpman %Id: euc.4,v 1.3 1999/09/11 08:12:14 horikawa Stab % +.\" +.Dd June 4, 1993 +.Dt EUC 4 +.Os +.Sh 名称 +.Nm euc +.Nd EUC エンコーディング +.Sh 書式 +.Nm ENCODING +.Qq EUC +.Pp +.Nm VARIABLE +.Ar len1 +.Ar mask1 +.Ar len2 +.Ar mask2 +.Ar len3 +.Ar mask3 +.Ar len4 +.Ar mask4 +.Ar mask +.Sh 説明 +.Nm EUC +エンコーディングは、 +.Ux +ベースのシステムとの互換性を保つために提供されています。 +.Ev LC_TYPE +ソースファイルのフォーマットに関する完全な説明を求めるなら、 +.Xr mklocale 1 +を参照してください。 +.Pp +.Nm EUC +は、4 つのマルチバイトコードセットを実装しています。 +1 番目のコードセット中のマルチバイト文字は、0x00 から 0x7f までの範囲の +1 バイトから始まる +.Ar len1 +バイトのデータで構成されています。 +ASCII 文字が使えるようにするため、 +.Ar len1 +は常に 1 です。 +2 番目のコードセット中のマルチバイト文字は、 +0x8e と 0x8f を除いた 0x80 から 0xff までの範囲の 1 バイトから始まる +.Ar len2 +バイトのデータで構成されています。 +3 番目のコードセット中のマルチバイト文字は、 +1 バイト目が 0x8e で始まる +.Ar len3 +バイトのデータで構成されています。 +4 番目のコードセット中のマルチバイト文字は、 +1 バイト目が 0x8f で始まる +.Ar len4 +バイトのデータで構成されています。 +.Pp +.Nm EUC +マルチバイト文字の +.Ev rune_t +エンコーディングは +.Ar len +および +.Ar mask +引数に依存しています。 +はじめに、各バイトは次のような式で +.Ev rune_t +に変換されます。 +.Bd -literal +byte0 << ((\fIlen\fPN-1) * 8) | byte1 << ((\fIlen\fPN-2) * 8) | ... | byte\fIlen\fPN-1 +.Ed +.Pp +そして、この結果を +.Ar ~mask +と AND をとり、 +.Ar maskN +と OR をとります。 +コードセット 2 および 3 は処理が特殊で、最初に先頭バイト (0x8e あるいは 0x8f) +を削除し、 +.Ar lenN +引数の値を 1 減らします。 +.Pp +例えば、日本語ロケールは次のような +.Ev VARIABLE +行を持っています。 +.Bd -literal +VARIABLE 1 0x0000 2 0x8080 2 0x0080 3 0x8000 0x8080 +.Ed +.Pp +コードセット 1 は、0x0000 から 0x007f までの値で構成されています。 +.Pp +コードセット 2 は 0x8080 ビットがセットされた値で構成されています。 +.Pp +コードセット 3 は 0x0080 から 0x00ff までの 値で構成されています。 +.Pp +コードセット 4 は 0x0080 ビットがセットされた値を除いた 0x8000 から +0xff7f までの値で構成されています。 +.Pp +グローバルな +.Ar mask +値は、0x8080 にセットされることに注意してください。これは、この 2 ビット +からコードセットが決定されるということを示しています。 +.Sh 例 - 日本語ロケール +以下に示す例は、日本語ロケール用の +.Ev LC_CTYPE +ソースファイルの完全な例です。 +.Bd -literal +/* + * JIS 文字集合の EUC を用いた日本語 LOCALE_CTYPE の定義 + */ + +ENCODING "EUC" + +/* JIS JIS JIS */ +/* X201 X208 X201 */ +/* 00-7f 84-fe */ + +VARIABLE 1 0x0000 2 0x8080 2 0x0080 3 0x8000 0x8080 + +/* + * コードセット 1 + */ +ALPHA 'A' - 'Z' 'a' - 'z' +CONTROL 0x00 - 0x1f 0x7f +DIGIT '0' - '9' +GRAPH 0x21 - 0x7e +LOWER 'a' - 'z' +PUNCT 0x21 - 0x2f 0x3a - 0x40 0x5b - 0x60 0x7b - 0x7e +SPACE 0x09 - 0x0d 0x20 +UPPER 'A' - 'Z' +XDIGIT 'a' - 'f' 'A' - 'F' +BLANK ' ' '\t' +PRINT 0x20 - 0x7e + +MAPLOWER < 'A' - 'Z' : 'a' > < 'a' - 'z' : 'a' > +MAPUPPER < 'A' - 'Z' : 'A' > < 'a' - 'z' : 'A' > +TODIGIT < '0' - '9' : 0 > +TODIGIT < 'A' - 'F' : 10 > < 'a' - 'f' : 10 > + +/* + * コードセット 2 + */ + +SPACE 0xa1a1 +PHONOGRAM 0xa1bc +SPECIAL 0xa1a2 - 0xa1fe +PUNCT 0xa1a2 - 0xa1f8 /* ここに書くことはたくさんありすぎます */ + +SPECIAL 0xa2a1 - 0xa2ae 0xa2ba - 0xa2c1 0xa2ca - 0xa2d0 0xa2dc - 0xa2ea +SPECIAL 0xa2f2 - 0xa2f9 0xa2fe + +DIGIT 0xa3b0 - 0xa3b9 +UPPER 0xa3c1 - 0xa3da /* ローマ字 */ +LOWER 0xa3e1 - 0xa3fa /* ローマ字 */ +MAPLOWER < 0xa3c1 - 0xa3da : 0xa3e1 > /* 英字 */ +MAPLOWER < 0xa3e1 - 0xa3fa : 0xa3e1 > /* 英字 */ +MAPUPPER < 0xa3c1 - 0xa3da : 0xa3c1 > +MAPUPPER < 0xa3e1 - 0xa3fa : 0xa3c1 > + +XDIGIT 0xa3c1 - 0xa3c6 0xa3e1 - 0xa3e6 + +TODIGIT < 0xa3b0 - 0xa3b9 : 0 > +TODIGIT < 0xa3c1 - 0xa3c6 : 10 > < 0xa3e1 - 0xa3e6 : 10 > + +PHONOGRAM 0xa4a1 - 0xa4f3 +PHONOGRAM 0xa5a1 - 0xa5f6 + +UPPER 0xa6a1 - 0xa6b8 /* ギリシャ文字 */ +LOWER 0xa6c1 - 0xa6d8 /* ギリシャ文字 */ +MAPLOWER < 0xa6a1 - 0xa6b8 : 0xa6c1 > < 0xa6c1 - 0xa6d8 : 0xa6c1 > +MAPUPPER < 0xa6a1 - 0xa6b8 : 0xa6a1 > < 0xa6c1 - 0xa6d8 : 0xa6a1 > + +UPPER 0xa7a1 - 0xa7c1 /* キリル文字 */ +LOWER 0xa7d1 - 0xa7f1 /* キリル文字 */ +MAPLOWER < 0xa7a1 - 0xa7c1 : 0xa7d1 > < 0xa7d1 - 0xa7f1 : 0xa7d1 > +MAPUPPER < 0xa7a1 - 0xa7c1 : 0xa7a1 > < 0xa7d1 - 0xa7f1 : 0xa7a1 > + +SPECIAL 0xa8a1 - 0xa8c0 + +IDEOGRAM 0xb0a1 - 0xb0fe 0xb1a1 - 0xb1fe 0xb2a1 - 0xb2fe +IDEOGRAM 0xb3a1 - 0xb3fe 0xb4a1 - 0xb4fe 0xb5a1 - 0xb5fe +IDEOGRAM 0xb6a1 - 0xb6fe 0xb7a1 - 0xb7fe 0xb8a1 - 0xb8fe +IDEOGRAM 0xb9a1 - 0xb9fe 0xbaa1 - 0xbafe 0xbba1 - 0xbbfe +IDEOGRAM 0xbca1 - 0xbcfe 0xbda1 - 0xbdfe 0xbea1 - 0xbefe +IDEOGRAM 0xbfa1 - 0xbffe 0xc0a1 - 0xc0fe 0xc1a1 - 0xc1fe +IDEOGRAM 0xc2a1 - 0xc2fe 0xc3a1 - 0xc3fe 0xc4a1 - 0xc4fe +IDEOGRAM 0xc5a1 - 0xc5fe 0xc6a1 - 0xc6fe 0xc7a1 - 0xc7fe +IDEOGRAM 0xc8a1 - 0xc8fe 0xc9a1 - 0xc9fe 0xcaa1 - 0xcafe +IDEOGRAM 0xcba1 - 0xcbfe 0xcca1 - 0xccfe 0xcda1 - 0xcdfe +IDEOGRAM 0xcea1 - 0xcefe 0xcfa1 - 0xcfd3 0xd0a1 - 0xd0fe +IDEOGRAM 0xd1a1 - 0xd1fe 0xd2a1 - 0xd2fe 0xd3a1 - 0xd3fe +IDEOGRAM 0xd4a1 - 0xd4fe 0xd5a1 - 0xd5fe 0xd6a1 - 0xd6fe +IDEOGRAM 0xd7a1 - 0xd7fe 0xd8a1 - 0xd8fe 0xd9a1 - 0xd9fe +IDEOGRAM 0xdaa1 - 0xdafe 0xdba1 - 0xdbfe 0xdca1 - 0xdcfe +IDEOGRAM 0xdda1 - 0xddfe 0xdea1 - 0xdefe 0xdfa1 - 0xdffe +IDEOGRAM 0xe0a1 - 0xe0fe 0xe1a1 - 0xe1fe 0xe2a1 - 0xe2fe +IDEOGRAM 0xe3a1 - 0xe3fe 0xe4a1 - 0xe4fe 0xe5a1 - 0xe5fe +IDEOGRAM 0xe6a1 - 0xe6fe 0xe7a1 - 0xe7fe 0xe8a1 - 0xe8fe +IDEOGRAM 0xe9a1 - 0xe9fe 0xeaa1 - 0xeafe 0xeba1 - 0xebfe +IDEOGRAM 0xeca1 - 0xecfe 0xeda1 - 0xedfe 0xeea1 - 0xeefe +IDEOGRAM 0xefa1 - 0xeffe 0xf0a1 - 0xf0fe 0xf1a1 - 0xf1fe +IDEOGRAM 0xf2a1 - 0xf2fe 0xf3a1 - 0xf3fe 0xf4a1 - 0xf4a4 +/* + * これは、コードセット 3 の半角かな用です。 + */ +SPECIAL 0xa1 - 0xdf +PHONOGRAM 0xa1 - 0xdf +CONTROL 0x84 - 0x97 0x9b - 0x9f 0xe0 - 0xfe +.Ed +.Sh 関連項目 +.Xr mklocale 1 , +.Xr setlocale 3 diff --git a/ja_JP.eucJP/man/man4/ex.4 b/ja_JP.eucJP/man/man4/ex.4 new file mode 100644 index 0000000000..ef427df931 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ex.4 @@ -0,0 +1,84 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ex.4,v 1.6 1998/10/22 14:32:20 bde Exp % +.\" jpman %Id: ex.4,v 1.4 1999/08/15 14:19:03 horikawa Stab % +.\" +.\" WORD: Plug-N-Play プラグアンドプレイ +.\" +.Dd January 19, 1997 +.Dt EX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ex +.Nd +Intel EtherExpress Pro/10 と Pro/10+ イーサネットデバイスドライバ +.Sh 書式 +.Cd "device ex0 at isa? port? net irq ?" +.Sh 解説 +.Nm +ドライバは Intel i82595 チップを搭載した 16 ビット PCI の +Intel EtherExpress Pro/10 と Pro/10+ イーサネットカードの +サポートを提供します。 +.Pp +ポートの開始アドレスが見つからなければ、 +I/O アドレスの 0x200 から 0x3a0 の範囲からカードを探します。 +IRQ が指定されていなければ、カードの EEPROM から読み出されます。 +新しめのカードでの正しい操作のためには +プラグアンドプレイのサポートを無効にすべきです。 +.Pp +.Sh 診断 +.Bl -diag +.It "ex%d: Intel EtherExpress Pro/10, address %6D, connector %s" +デバイスプローブはインストールされたカードを発見して、 +デバイスドライバを正しくインストールすることができました。 +.It "ex%d: WARNING: board's EEPROM is configured for IRQ %d, using %d" +デバイスプローブはカーネル設定ファイルで指定されたものとは +異なる割り込みが設定されているボードを検出しました。 +.It "ex%d: invalid IRQ." +デバイスプローブは不正な IRQ 設定を検出しました。 +.El +.Pp +.Sh バグ +現在は、ドライバはマルチキャストをサポートしていません。 +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2 +に初めて登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.ie t .An Javier Mart\)'in Rueda +.el .An Javier Martin Rueda +によって書かれました。 +このマニュアルページは +.An David E. O'Brien +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/fd.4 b/ja_JP.eucJP/man/man4/fd.4 new file mode 100644 index 0000000000..a975a65f09 --- /dev/null +++ b/ja_JP.eucJP/man/man4/fd.4 @@ -0,0 +1,90 @@ +.\" Copyright (c) 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)fd.4 8.1 (Berkeley) 6/9/93 +.\" %Id: fd.4,v 1.4 1997/03/07 02:49:26 jmg Exp % +.\" jpman %Id: fd.4,v 1.3 1999/09/11 08:12:27 horikawa Stab % +.\" " +.Dd June 9, 1993 +.Dt FD 4 +.Os +.Sh 名称 +.Nm fd , +.Nm stdin , +.Nm stdout , +.Nm stderr +.Nd ファイル記述子ファイル +.Sh 解説 +.Pa /dev/fd/0 +から +.Pa /dev/fd/# +のファイルは、 +ファイルシステムを介してアクセス可能なファイル記述子を参照します。 +そのファイル記述子がオープンされていて、 +オープンしようとするファイルのモードが +すでに存在する記述子のモードのサブセットであれば、呼び出し: +.Bd -literal -offset indent +fd = open("/dev/fd/0", mode); +.Ed +.Pp +と呼び出し: +.Bd -literal -offset indent +fd = fcntl(0, F_DUPFD, 0); +.Ed +.Pp +は等価になります。 +.Pp +ファイル +.Pa /dev/stdin , +.Pa /dev/stdout , +.Pa /dev/stderr +をオープンすることは次の呼び出しと等価です: +.Bd -literal -offset indent +fd = fcntl(STDIN_FILENO, F_DUPFD, 0); +fd = fcntl(STDOUT_FILENO, F_DUPFD, 0); +fd = fcntl(STDERR_FILENO, F_DUPFD, 0); +.Ed +.Pp +.Xr open 2 +への +.Dv O_RDONLY , +.Dv O_WRONLY , +.Dv O_RDWR +以外のフラグは無視されます。 +.Sh 関連ファイル +.Bl -tag -width /dev/stderr -compact +.It Pa /dev/fd/# +.It Pa /dev/stdin +.It Pa /dev/stdout +.It Pa /dev/stderr +.El +.Sh 関連項目 +.Xr tty 4 diff --git a/ja_JP.eucJP/man/man4/fdc.4 b/ja_JP.eucJP/man/man4/fdc.4 new file mode 100644 index 0000000000..9e9edfeb42 --- /dev/null +++ b/ja_JP.eucJP/man/man4/fdc.4 @@ -0,0 +1,78 @@ +.\" +.\" Copyright (c) 1994 Wilko Bulte +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: fdc.4,v 1.11 1998/12/27 13:40:51 phk Exp % +.\" jpman %Id: fdc.4,v 1.3 1999/09/11 08:12:37 horikawa Stab % +.\" +.Dd August 31, 1994 +.Dt FDC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm fdc +.Nd +PCアーキテクチャのフロッピディスクコントローラドライバ +.Sh 書式 +.Cd "controller fdc0 at isa? port" \&"IO_FD1\&" "bio flags 0x1 irq 6 drq 2" +.Cd "disk fd0 at fdc0 drive 0 +.Cd "disk fd1 at fdc0 drive 1 +.Sh 説明 +このドライバは、フロッピディスクドライブおよび QIC40/80 +テープドライブへのアクセスを提供します。 +/dev ディレクトリには、各フロッピディスクデバイス用に多数の +マイナデバイスが存在します。 デバイス名が英文字で終わる +/dev/fd* デバイスは、フロッピディスク上の 'パーティション' を +表すのに使用されます。 +/dev/fd*.<数字> という名前のデバイスは、フロッピディスクの +サイズ (つまり、720KB や 1440KB など) を表します。後者は、 +fdformat コマンドを使ってフロッピディスクをフォーマットするときや、 +複数の記録密度のフロッピディスクを扱えるドライブで、異なる記録密度の +フロッピディスクにアクセスするとき (例: 1.44MB ドライブで 720KB +ディスクにアクセスするとき) に使われます。 +.Pp +通常は、フロッピドライブの設定を得るために、 +システムの CMOS メモリに問い合わせます。 +CMOS 内部に、この設定値を持たないマシンもいくつかあります。 +こうしたマシンでは、 +.Ql 0x1 +という値のフラグを使用して、CMOS に問い合わせを行わずに、 +1.44MB フロッピドライブを最初のユニットとして見せかけるように +してください。 +.Sh ファイル +.Bl -tag -width Pa -compact +.It /dev/fd* +フロッピディスクデバイスのノード +.\" floppy disk device nodes +.It /dev/fd*. +フロッピディスクデバイスのノード。後に続く数字がフロッピディスクの +記憶容量を表しています。 +.It Pa /sys/i386/conf/GENERIC +サンプルの generic カーネルの設定ファイル +.It Pa /sys/i386/isa/fd.c +フロッピドライバのソース +.El +.Sh 関連項目 +.Xr fdformat 1 , +.Xr disktab 5 diff --git a/ja_JP.eucJP/man/man4/fe.4 b/ja_JP.eucJP/man/man4/fe.4 new file mode 100644 index 0000000000..75474211b0 --- /dev/null +++ b/ja_JP.eucJP/man/man4/fe.4 @@ -0,0 +1,284 @@ +.\" All Rights Reserved, Copyright (C) Fujitsu Limited 1995 +.\" +.\" This document may be used, modified, copied, distributed, and sold, in +.\" both source and printed form provided that the above copyright, these +.\" terms and the following disclaimer are retained. The name of the author +.\" and/or the contributor may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS DOCUMENT IS PROVIDED BY THE AUTHOR AND THE CONTRIBUTOR ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR THE CONTRIBUTOR BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS DOCUMENT, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" Contributed by M. Sekiguchi . +.\" for fe driver. +.\" +.\" %Id: fe.4,v 1.11 1998/10/22 13:01:19 bde Exp % +.\" jpman %Id: fe.4,v 1.3 2000/08/10 13:49:45 horikawa Stab % +.\"" lair events -> typo of "rare" events (approved by original writer) +.Dd March 3, 1996 +.Dt FE 4 i386 +.Sh 名称 +.Nm fe +.Nd 富士通 MB86960A/MB86965A をベースとしたイーサネットアダプタ +.Sh 書式 +.Cd "device fe0 at isa? port 0x300 net irq ?" +.Sh 解説 +.Nm fe +は、富士通 MB86960A, MB86965A またはその他の互換チップをベースとした +イーサネットアダプタのためのネットワークデバイスドライバです。 +.Pp +このドライバは、アダプタのハードウェアが対応していれば、 +I/O ポートアドレスと IRQ の設定を自動的に行ないます。 +.Pp +このドライバはプログラム I/O データ転送技術を使用しており、 +まずまずのパフォーマンスが得られます。 +アダプタがたとえ持っていたとしても、共有メモリは使用しません。 +.Pp +このドライバは現在のところ、ISA 用の富士通 FMV-180 シリーズ、 +ISA 用の アライドテレシス AT1700 シリーズと RE2000 シリーズ、 +富士通 MBH10302 PC カードに対応しています。 +.Ss パラメータ +カーネル設定ファイルにおいて、2 つのパラメータ +.Ar port +と +.Ar irq +には、アダプタのハードウェア設定を反映した値を指定する必要があります。 +もう 1 つオプションとして +.Ar flags +パラメータがあり、付加的な設定を行なうことができます。 +その他の device 文におけるパラメータは書式に書かれているとおりに +書く必要があります。 +.Pp +.Ar port +パラメータは、アダプタのベース I/O ポートアドレスを指定します。 +この値はアダプタのハードウェア設定と合致している必要があります。 +.Ar port +は、 +.Dq Li \&? +にして、指定せずに残しておくこともできます。 +その場合、ドライバは I/O アドレスに関するハードウェア設定の検出を +自動的に試みます。 +この機能はアダプタハードウェアによっては動かないかもしれません。 +.Pp +.Ar irq +パラメータは、アダプタが使用する IRQ 番号を指定します。 +この値はアダプタのハードウェア設定と合致している必要があります。 +.Ar irq +は、 +.Dq Li \&? +にして、指定せずに残しておくこともできます。 +その場合、ドライバは IRQ に関するハードウェア設定の検出を +自動的に試みます。 +この機能はアダプタハードウェアによっては動かないかもしれません。 +.Pp +.Ar flags +は、様々なデバイス設定の組み合わせからなる数値です。 +現在のバージョンでは以下の flags が定義されています。 +2 つ以上の設定をデバイスに設定するには、 +それぞれの flag 値を数値で加算してください。 +以下で指定されていない flag ビットは予約されており、0 にしなければ +なりません。実際には、それぞれのビットは単に無視されるか、テスト用や +ドライバの文書化されていない機能を制御するために使われます。 +文書化されていない機能については、プログラムのソースを参照してください。 +.Bl -tag -width "99999999" +.It Li 0x007F +これらの flag ビットは、 +.Ar flags +の +.Li 0x0080 +ビットが設定されている時に、MB86960A/MB86965A チップの DLCR6 レジスタを +初期化するために使用されます。 +DLCR6 上書き機能に関する詳細は以下を参照してください。 +将来のバージョンにおけるドライバの互換性を保持するために、 +.Li 0x0080 +ビットがセットされていない場合以外、 +.Li 0x007F +flag ビットは 0 にしておいてください。 +.It Li 0x0080 +この flag は、MB86960A/MB86965A チップの DLCR6 レジスタに対する +デフォルト設定を flag 値の 低位 7 bit を用いて上書きします。 +この flag は問題解決用のものであり、アダプタハードウェアに関する +知識がある人のみが使用してください。 +DLCR6 設定に関する詳細な情報は、富士通のマニュアルを参照してください。 +.El +.Sh オプション +.Nm fe +ドライバはカーネル設定ファイルにおいて、 +.Dq option +文で指定できるいくつかの私的なオプションを持っています。 +以下に私的オプションをリストします。 +ドライバはこれ以外にも文書化されていないオプションを受け付けます。 +それらの名前には全て +.Dv "FE_" +という固定された接頭辞が付けられています。 +文書化されていないオプションについては、プログラムのソースを参照してください。 +.Bl -tag -width "FE_" +.It Dv "FE_DEBUG=" Ns Ar level +このオプションは、デバイスと (または) ドライバのデバッギングレベルを +制御する数値を受けとります。 +.Dv "FE_DEBUG" +ここにリストされていない値にオプションを設定すると、 +文書化されていない動作を引き起こすかもしれません。 +このオプションに関するデフォルトの設定値は 1 です。 +.Bl -bullet +.It +.Dv "FE_DEBUG=0" +を設定すると、正当性の確認を含めた多くのデバッグ用コードが、 +ドライバのオブジェクトコードから除かれます。 +この設定は最も速くて小さなオブジェクトコードを生成します。 +この設定であっても、いくつかの非常時メッセージは記録されます。 +.It +.Dv "FE_DEBUG=1" +を設定すると、最低限のデバッグ用コードが含まれ、 +最小量のメッセージが記録されます。 +この設定では致命的なエラーメッセージのみが記録されます。 +.It +.Dv "FE_DEBUG=2" +を設定すると、標準的なデバッグ用コードが含まれ、 +中間量のメッセージが記録されます。 +この設定では滅多にないイベントや怪しげな状態でのメッセージが記録されます。 +.It +.Dv "FE_DEBUG=3" +を設定すると、全てのデバッグ用コードが含まれ、 +最大量のメッセージが記録されます。 +この設定では通常動作の報告やレジスタ値のダンプなどの +冗長なメッセージが記録されます。 +.El +.El +.Sh ハードウェアモデルに特有の機能 +.Nm fe +ドライバには、アダプタのハードウェアモデルに特有の機能や制限が +いくつかあります。 +以下はそのような性質の概略です。 +.Ss 富士通 FMV-180 シリーズアダプタ +これらのアダプタでは、IRQ と I/O ポートアドレスの両方が +自動的に検出可能です。 +.Pp +FMV-180 シリーズでは +.Nm fe +の自動 I/O ポートアドレス検出機能はたいていの場合具合良く動きます。 +もしシステムに 2 つ以上の FMV-180 があったとしても、 +ちゃんと動きます。 +しかし、それ以外のアダプタとの組み合わせは、ドライバを混乱させるかも +しれません。 +ハードウェア検出で何か困難を感じた時は、 +.Em "port ?" +を使わないことをお勧めします。 +.Pp +FMV-180 シリーズでは +.Nm fe +の自動 IRQ 検出機能は確実に動きます。 +FMV-180 には常に +.Em "irq ?" +を使うことをお勧めします。 +IRQ のハードウェア設定は、カーネル設定ファイルにおいて IRQ 値が指定されて +いたとしても、アダプタの EEPROM 設定から読み込まれます。 +ドライバはカーネル設定ファイルで指定された IRQ が EEPROM に保存された値と +違っていた場合、警告メッセージを生成し、 +設定ファイルで指定された値を使用します +(この振舞は前回のリリースより変更になっています)。 +.Ss アライドテレシス AT1700 シリーズと RE2000 シリーズアダプタ +アライドテレシス AT1700 シリーズと RE2000 シリーズでは、 +自動 I/O ポートアドレス検出機能は動きますが、 +FMV-180 シリーズよりは確実度が落ちます。 +アライドテレシスのアダプタでこの機能を使用するのはお勧めできません。 +.Pp +自動 IRQ 検出も制限つきですが可能です。 +.Nm fe +ドライバは設定ファイルで +.Dq irq \&? +が設定されていた場合、ボードの EEPROM 設定より IRQ 設定を得ようとします。 +不幸なことに、AT1700 シリーズと RE2000 シリーズには 2 種類のモデルが +あるように思えます; +あるタイプは IRQ を 3/4/5/9 から選択可能で、もう片方は 10/11/12/15 から選択 +可能です。 +これらのモデルの識別方法は、良く知られていません。 +このため、アライドテレシスのアダプタでの自動 IRQ 検出は確実でないようです。 +何かトラブルが起きた時は、正確な IRQ 番号を指定してください。 +.Pp +AT17000 シリーズと RE2000 シリーズの違いや、 +これらのシリーズ内でのマイナモデルの見分けはしていません。 +.Ss 富士通 MBH10302 PC カード +.Nm fe +ドライバは富士通 MBH10302 と互換 PC カードをサポートしています。 +動作には PC カード (PCMCIA) サポートパッケージが必要です。 +.Sh 関連項目 +.Xr netstat 1 , +.Xr crd 4 , +.Xr ed 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr pccardd 8 +.Sh バグ +以下は、既知の大きなバグです: +.Pp +.Nm fe +ドライバによって保たれているコリジョン数の統計は正確ではありません; +.Xr netstat 1 +の +.Fi i +オプションは実際のコリジョン数より若干少ない値を示します。 +.Pp +思ったよりも多くの mbuf クラスタが消費されます。 +パケット受信ルーチンが、mbuf クラスタの割り当てポリシに、わざ +と違反しているからです。 +不必要に割り当てられたクラスタは短い生存期間で解放されるため、 +長い目で見ればカーネルメモリ消費量には影響しません。 +.Pp +XNS と IPX へのサポートがドライバには含まれていますが、 +一度もテストはされておらず、たくさんのバグがあるはずです。 +.Sh 作者、著作権、免責条項 +.Pp +.Nm fe +ドライバは +.An David Greenman +が書いた +.Nm ed +ドライバを模範として、 +.An M. Sekiguchi Aq seki@sysrap.cs.fujitsu.co.jp +が独自に作成して寄贈しました。 +.Nm fe +における PC カードサポートは +.An Hidetoshi Kimura Aq h-kimura@tokyo.se.fujitsu.co.jp +が書きました。 +このマニュアルページは +.An M. Sekiguchi +が書きました。 +.Pp +.Em "All Rights Reserved, Copyright (C) Fujitsu Limited 1995" +.Pp +This document and the associated software may be used, modified, +copied, distributed, and sold, in both source and binary form provided +that the above copyright, these terms and the following disclaimer are +retained. The name of the author and/or the contributor may not be +used to endorse or promote products derived from this document and the +associated software without specific prior written permission. +.Pp +THIS DOCUMENT AND THE ASSOCIATED SOFTWARE IS PROVIDED BY THE AUTHOR +AND THE CONTRIBUTOR +.Dq 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 THE +CONTRIBUTOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +DOCUMENT AND THE ASSOCIATED SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. +.Sh 歴史 +.Nm +ドライバは +.Fx 2.0.5 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/fpa.4 b/ja_JP.eucJP/man/man4/fpa.4 new file mode 100644 index 0000000000..d0e7e1daeb --- /dev/null +++ b/ja_JP.eucJP/man/man4/fpa.4 @@ -0,0 +1,58 @@ +.\" +.\" Copyright (c) 1995, Matt Thomas +.\" All rights reserved. +.\" +.\" %Id: fpa.4,v 1.10 1998/03/12 07:30:16 charnier Exp % +.\" jpman %Id: fpa.4,v 1.3 2000/07/05 05:26:07 horikawa Stab % +.\" +.Dd March 13, 1995 +.Dt FPA 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm fpa , +.Nm fea +.Nd DEC FDDI コントローラ用デバイスドライバ +.Sh 書式 +.Cd "device fpa0" +.Cd "device fea0" +.Pp +.Tn FreeBSD +のみ: +.Cd "pseudo-device fddi" +.Sh 解説 +.Nm fpa +と +.Nm fea +デバイスドライバは、それぞれ DEC DEFPA PCI FDDI コントローラと DEC DEFEA +EISA FDDI コントローラをサポートします。DAS 接続と SAS 接続も含め、 +これらのコントローラと同等な製品もすべてサポートされます。 +.Pp +.Sh 診断 +.Bl -diag +.It "fea%d: error: desired IRQ of %d does not match device's actual IRQ (%d)" +デバイス検出によって、カーネルの設定ファイルに記述された IRQ とは異なる値が +DEFEA ボードに設定されていることが発見されました。 +.It "fea%d: error: memory not enabled! ECU reconfiguration required" +デバイス検出によって、DEFEA ボード上のどのデバイスメモリも使用可能になって +いないことがわかりました。デバイスメモリを使わずに DEFEA ボードを設定する +ことは可能ですが、このデバイスドライバには最低 1K のデバイスメモリが設定 +されていることが必要です。 +ECU (EISA 設定ユーティリティ) を使えばこの設定を変更することができます。 +.El +.Sh 警告 +通常、このデバイスドライバで SMT フレームを受信することはできません。 +しかし IFF_LINK1 フラグをセットすれば、このデバイスドライバで SMT +フレームを受信できるようになり、それらのフレームをバークレイパケット +フィルタに引き渡すようになります。 +.Pp +.Sh 参照 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 作者 +.Nm fpa +と +.Nm fea +デバイスドライバおよびマニュアルは +.An Matt Thomas +によって作成されました。 diff --git a/ja_JP.eucJP/man/man4/fxp.4 b/ja_JP.eucJP/man/man4/fxp.4 new file mode 100644 index 0000000000..89023b0f42 --- /dev/null +++ b/ja_JP.eucJP/man/man4/fxp.4 @@ -0,0 +1,96 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: fxp.4,v 1.6 1998/03/12 07:30:32 charnier Exp % +.\" jpman %Id: fxp.4,v 1.3 1999/08/18 16:40:18 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt FXP 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm fxp +.Nd +Intel EtherExpress Pro/100B イーサネットデバイスドライバ +.Sh 書式 +.Cd "device fxp0" +.Sh 解説 +.Nm +ドライバは Intel i82557 イーサネットチップを搭載した EtherExpress +Pro/10 と Pro/100B PCI ファーストイーサネットアダプタの +サポートを提供します。 +.Pp +.Nm +ドライバは次のメディアタイプをサポートします: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションを自動選択します +.It 10baseT/UTP +10Mbps に設定します +.It 100baseTX +100Mbps (ファーストイーサネット) に設定します +.El +.Pp +.Nm +ドライバは次のメディアオプションをサポートします: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +全二重通信に設定します +.El +.Pp +メディアタイプ 100baseTX は Pro/100B のみ可能です。 +このデバイスの設定に関するさらなる情報は +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "fxp%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "fxp%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "fxp%d: Failed to malloc memory" +割り当てるための mbuf が十分にはありません。 +.It "fxp%d: device timeout" +デバイスはネットワークに対しての応答を停止しているか、 +またはネットワークの接続 (ケーブル) に問題があります。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.1 +に初めて登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.An David Greenman +が書きました。 +このマニュアルページは +.An David E. O'Brien +が書きました。 diff --git a/ja_JP.eucJP/man/man4/gsc.4 b/ja_JP.eucJP/man/man4/gsc.4 new file mode 100644 index 0000000000..3156d09e95 --- /dev/null +++ b/ja_JP.eucJP/man/man4/gsc.4 @@ -0,0 +1,289 @@ +.\" gsc.4 - manual page for the scanner device driver `gsc' +.\" +.\" +.\" Copyright (c) 1995 Gunther Schadow. 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 Gunther Schadow. +.\" 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. +.\" +.\" %Id: gsc.4,v 1.9 1998/06/08 06:11:59 jkoshy Exp % +.\" jpman %Id: gsc.4,v 1.3 2000/08/03 06:57:03 horikawa Stab % +.\" +.Dd January 9, 1995 +.Os FreeBSD +.Dt GSC 4 i386 +.Sh 名称 +.Nm gsc +.Nd ハンディスキャナ用デバイスドライバ +.Sh 書式 +.Fd #include +.Pp +.Cd マイナ番号ビット: Ar uu d g p ... +.Bl -tag -width "uu " -compact -offset indent +.It Ar uu +ユニット gsc0 .. gsc3 +.It Ar d +.Em デバッグ +メッセージの記録を選択 +.It Ar g +.Em ビットマップ +または +.Em グレーマップ +出力を選択 +.It Ar p +.Em raw +または portable +.Em pnm +出力を選択 +.El +.Pp +.Sh 解説 +.Nm gsc +キャラクタデバイスドライバは、今のところ Genius GS-4500 ハンディスキャナ +のみを扱っています。このドライバはハードウェアが irq を使用して +動作可能であっても、完全に dma 方式で制御を行ないます。 +私には割り込み駆動型のデバイスドライバを書くのに十分な +ドキュメントも経験もありません。 +.Pp +デバイスは、次の 4 つの異なった +.Em 解像度 +で動作可能です: +100, 200, +300, 400dpi。デバイスは最上位のビットが左にくるシンプルなビットマップを +生成します。ドライバは Jef Poskanzer による、 +よく知られていて適度にシンプルなポータブルビットマップファイル形式 +.Xr pbm 5 +で出力することもできます。 +したがってスキャンの結果はその辺にあるどのようなグラフィックパッケージ +(一部の名前を挙げるなら +.Xr xpaint 1 , +.Xr xv 1 , +.Xr xli 1 +など) で簡単に処理することができます。 +.Em raw +モードでは、スキャナは白い紙の上の黒い点を検出するため、 +セットされたビットは黒いピクセルを意味します。 +逆に、pnm フォーマットはビデオ画面の電子ビームの光度を記述するため、 +.Em pbm +モードにおいては、セットされたビットは白いピクセルを意味します。 +.Pp +出力されたビットマップの +.Em 幅 +は与えられた解像度値によって固定されます。しかしながら +.Em pnm +モードでは、ドライバはいつ 'ファイルの終わり' が検出されたかを知っている +はずなので、ビットマップの +.Em 高さ +は自動で設定されます。 +この機能により、 +.Xr cat +を用いてスキャナ出力を pbm ファイルに直接コピーすることができます。 +もちろん +ドライバを +.Em raw +モードで使用し +.Xr dd 1 +を用いて似た効果を得ることはできます。 +.Pp +.Em グレーマップ +出力モードはまだドライバに実装されていません。 +外部プログラムがこの作業をよりうまくできるかどうかは怪しいですが、 +その結果カーネルの大きさが減るかどうかは疑問に思っています。 +ただたとえそうであったとしても、中間調ビットマップからグレーマップを +生成するツールを私は知りません。 +.Pp +.Nm gsc +が処理する ioctl リクエストは以下に列挙されています。 +sgsc(1) と呼ばれるユーティリティを使うと、シェルからこれらの +リクエストにアクセスできます。 +.Bl -tag -width Ds +.It GSC_SRES int +.Em 解像度 +の値を設定します。デバイスへの最初の読み込みアクセスの後に、 +この呼び出しを行なった場合は、デバイスをクローズして再びオープンしない限り +効果を持ちません。 +.It GSC_GRES int +現在の解像度を 1 インチあたりのドット数 (dpi) で取得します。 +.It GSC_SRESSSW void +解像度の値をセレクタスイッチで設定します。ドライバはオープンされているが +触れられていない状態である必要があります。そうでない場合はリクエストは +失敗し、 +.Xr errno 2 +には EBUSY が入ります。 +.It GSC_SWIDTH int +ビットマップの +.Em 幅 +を設定します。どのような設定可能な解像度もまさしく一つの幅に対応するので、 +実際はこのリクエストは解像度を設定する代わりの手段となります。 +設定可能な値は下の表に列挙されています。 +.Bl -tag -width resolution -compact -offset indent +.It 解像度 +幅 +.It 100 dpi +424 ピクセル +.It 200 dpi +840 ピクセル +.It 300 dpi +1264 ピクセル +.It 400 dpi +1648 ピクセル +.It ? +1696 ピクセル +.It ? +2544 ピクセル +.It ? +3648 ピクセル +.El +.Pp +上の表に書かれていない値は ioctl 呼び出しに失敗し、 +.Xr errno 2 +には +.Er EINVAL +が入ります。 +.Pp +見たとおり、1696 よりも大きな幅の値があります。しかし、このことは +スキャナの幅よりも長いラインをスキャンできたり、 +もっと高い解像度でスキャンできたりすることを意味するわけではありません。 +実際、解像度はハードウェアスイッチのみによって選択されます。 +実際の解像度で定義されている以上の長さのラインで、標準のラインの長さを越えた +右部分は定義されていません (通常は白になります)。 +.It GSC_GWIDTH int +現在のビットマップの幅をピクセル数で取得します。 +.It GSC_SHEIGHT int +.Em pnm +モードでのビットマップの +.Em 高さ +を設定します。 +実際にはこのリクエストは最初の読み込み操作の後、スキャンできるライン数の合計を +制限します。制限値に達した時、読み込みは 0 を返します。 +しかし、(呼び出しプロセスの終了時に、明示的あるいは暗黙的に) +デバイスがクローズされた時にのみ、電源は切断されます。 +.It GSC_GHEIGHT int +現在のビットマップの高さを取得します。 +.It GSC_SBLEN int +DMA 転送に内部で使用するバッファの長さを設定します。 +バッファの長さはビットマップのライン数で与えられます。 +バッファーのサイズは (現在) 0x3000 バイトに制限されているので、 +許されるラインの最大数は各ラインの幅によって変化します。 +この上限は、現在の値を上書きし +.Xr errno 2 +変数に ENOMEM を入れてしまう前にチェックされます。 +しかし、バッファライン数を選択した後もビットマップの幅を変更することは +できるので、バッファライン数が大きすぎることがわかった時は読み込みリクエストは +ENOMEM で失敗するかもしれません。一般的にはより良い出力を得るためには、 +節約するよりも長いバッファを選択する方が賢いです。 +.It GSC_GBLEN int +現在のバッファの長さをライン数で取得します。 +.It GSC_SBTIME int +1 つのバッファを読み込み終わるまでのタイムアウト時間を設定します。 +ハンディスキャナはフラットスキャナよりも、人間 / コンピュータ +インタフェースのタイムアウト時間が長いので、デフォルトでは 15 秒に +なっています。タイムアウト時間後は、読み込み操作は EBUSY で失敗します。 +タイムアウトタイマはそれぞれのバッファが読み込まれる度に +新たに開始されるので、長いイメージを早くスキャンできるようになる +わけではないことに注意してください。BLEN/BTIME は termios(4) の +MIN/TIME と似ています。 +.It GSC_GBTIME int +現在のバッファのタイムアウト時間を取得します。 +.El +.Pp +パラメータを変更する GSC_SBTIME 以外のすべての ioctl リクエストは、 +現在進行中のスキャンプロセスには影響しません。すなわち最初の読み込み +リクエスト時の設定がデバイスのオープン中は続きます。影響を及ぼすには +デバイスをクローズしてオープンし直す必要があります。したがって、 +設定はデバイスをクローズするかオープンするまでリセットされません。 +.Pp +同様に、設定値を読むリクエストは現在進行中のスキャンプロセスで +使われている値を報告しません。スキャンプロセスが必要とする値は +開始時に保存されているので、ioctl リクエストではアクセスできません。 +.Pp +しかし BTIME 値は現在進行中のスキャンにすぐに反映されます。 +したがってタイムアウト時間は、例えばユーザがスキャンを開始するまでの +長い時間に設定することができます。 +またユーザが停止したら (ほぼ) すぐに反応できるような短い時間に +設定することもできます。 +ユーザが慌てることなく一つのバッファを埋められるだけの時間は、最低でも残す +必要があることに注意してください。 +.Pp +.Em pbm +と +.Em raw +のモード選択は、ioctl リクエストではなく、マイナ番号によって行なわれる +ことに注意してください。 +.Em raw +モードでは、選択されたビットマップの高さはなんの効果も持ちません。 +.Sh 関連ファイル +.Bl -tag -width /dev/gsc0pd +.It Pa /dev/gsc0 +.Em raw +出力のためのデバイスノードで、マイナ番号は 0 です。 +.It Pa /dev/gsc0d +.Em raw +出力のためのデバイスノードで、 +コンパイル時に GSCDEBUG オプションが設定されていたら、 +.Em デバック +メッセージを出力します。マイナ番号は 32 です。 +.It Pa /dev/gsc0p +.Em pbm +ファイルフォーマット出力のためのデバイスノードで、マイナ番号は 8 です。 +.It Pa /dev/gsc0pd +.Em pbm +と +.Em debug +モードのためのデバイスノードで、マイナ番号は 40 です。 +.PB +.Sh 使用例 +.Bd -literal -offset indent +dd if=/dev/gsc0 of=rawfile bs=(width/8) count=(height) +cat /dev/gsc0p > pbmfile +.Ed +.Sh 診断 +.Bl -tag +.It GSCDEBUG +カーネル設定でこの名称を `option' として定義すると、 +デバッグビット (すなわち 7 ビット中のビット 5) がセットされたマイナ番号 +でドライバにアクセスした場合デバッグ出力を得ることができます。 +.El +.Sh 関連項目 +.Xr cat 1 , +.Xr dd 1 , +.Xr pbmtopgm 1 , +.Xr pnm 1 , +.Xr sgsc 1 , +.Xr close 2 , +.Xr intro 2 , +.Xr ioctl 2 , +.Xr open 2 , +.Xr read 2 , +.Xr termios 4 , +.Xr pbm 5 +.Sh 作者 +.An Gunther Schadow Aq gusw@fub46.zedat.fu-berlin.de +.Sh バグ +たとえスキャナデバイスに、4 つの解像度のうち 1 つを選択できるように +なっている小さなスイッチがあったとしても、私にはまだその状態を知る方法が +わかっていません。 +この問題が解決されない限り、ハードウェアで選択した解像度と一致する保証 +のない ioctl(2) で渡した値にドライバは依存します。 diff --git a/ja_JP.eucJP/man/man4/i4b.4 b/ja_JP.eucJP/man/man4/i4b.4 new file mode 100644 index 0000000000..8decc37d6f --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4b.4 @@ -0,0 +1,111 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4b.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" +.\" last edit-date: [Sat Dec 5 18:38:11 1998] +.\" jpman %Id: i4b.4,v 1.3 1999/12/29 15:19:06 horikawa Stab % +.\" " +.Dd February 3, 1998 +.Dt i4b 4 +.Sh 名称 +.Nm i4b +.Nd isdn4bsd 呼制御 ISDN ドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4b\&" +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +デバイスドライバは +.Xr isdnd 8 +デーモンが isdn4bsd カーネル部分とメッセージを交換するのに使用します。 +その目的は、呼 (call) の確立や制御、切断、 +および様々な制御情報や状態情報にアクセスすることです。 +.Pp +メッセージおよびメッセージパラメータは、インクルードファイル +.Em /usr/include/machine/i4b_ioctl.h +に記述されています。 +.Pp +次の ioctl が利用可能です: +.Pp +.Bl -tag -width Ds -compact -offset indent +.It Ar I4B_CDID_REQ +交換局とのローカル D チャネルの単一のやりとりを一意に識別する +呼記述識別子 (CDID: Call Description IDentifier) を要求します。 +.It Ar I4B_CONNECT_REQ +呼設定 (call setup) をリモート ISDN 加入者 (subscriber) に能動的に要求します。 +.It Ar I4B_CONNECT_RESP +着呼 (incoming call) に対し、受け入れ、拒否、または無視すると応答します。 +.It Ar I4B_DISCONNECT_REQ +能動的に呼を終了させます。 +.It Ar I4B_CTRL_INFO_REQ +設置されている ISDN コントローラカードについての情報を要求します。 +.It Ar I4B_DIALOUT_RESP +ダイヤルアウトを要求してきたドライバに対し、 +呼設定に関する情報を与えます。 +.It Ar I4B_TIMEOUT_UPD +動的に計算されるショートホールドモードのタイミングが変わった場合に、 +カーネルのタイムアウト値を更新します。 +.It Ar I4B_UPDOWN_IND +カーネルのユーザランドドライバにインタフェースのソフト的 +アップ/ダウン状態変化を知らせます。 +.It Ar I4B_CTRL_DOWNLOAD +アクティブなカードにファームウェアをダウンロードします。 +.It Ar I4B_ACTIVE_DIAGNOSTIC +アクティブなカードからの診断情報を返します。 +.El +.Pp +カーネルから得られる状態メッセージと +イベントメッセージには次のものがあります: +.Pp +.Bl -tag -width Ds -compact -offset indent +.It Ar MSG_CONNECT_IND +リモートの ISDN ユーザからの着呼を示します。 +.It Ar MSG_CONNECT_ACTIVE_IND +着呼がローカルで受け入れられた後、 +あるいは発呼 (outgoing call) がリモートに受け入れられた後で、 +交換局がアクティブ接続を通知しました。 +対応する B チャネルが交換されます。 +.It Ar MSG_DISCONNECT_IND +呼は終了しました。 +.It Ar MSG_DIALOUT_IND +ユーザランドインタフェースドライバがデーモンに +ダイヤルアウトするよう要求します +(典型的には、ネットワークインタフェースの送信キューにパケットが届く時です)。 +.It Ar MSG_IDLE_TIMEOUT_IND +B チャネルのアイドルタイムアウトが起こったために、 +isdn4bsd カーネルドライバが呼を終了させました。 +.It Ar MSG_ACCT_IND +ネットワークドライバからのアカウンティング情報です。 +.It Ar MSG_CHARGING_IND +カーネルからの課金情報です。 +.El +.Pp +.Sh 関連項目 +.Xr isdnd 8 +.Sh 作者 +.Nm +デバイスドライバと本マニュアルページは Hellmuth Michaelis が書きました。 +彼の連絡先は、hm@kts.org です。 diff --git a/ja_JP.eucJP/man/man4/i4bctl.4 b/ja_JP.eucJP/man/man4/i4bctl.4 new file mode 100644 index 0000000000..ff45b3f216 --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4bctl.4 @@ -0,0 +1,51 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4bctl.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" jpman %Id: i4bctl.4,v 1.3 1999/12/29 15:19:17 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:38:22 1998] +.\" +.Dd February 3, 1998 +.Dt i4bctl 4 +.Sh 名称 +.Nm i4bctl +.Nd カーネル内の isdn4bsd を制御するためのデバイス +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4bctl\&" +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +は +.Xr isdndebug 8 +ユーティリティによって使用されます。これにより、isdn4bsd パッケージと +呼ばれるカーネル内の ISDN を扱うレイヤについて、その現在のデバッグ +レベルやその他の情報を取得したり設定します。 +.Sh 関連項目 +.Xr isdndebug 8 +.Sh 作者 +.Nm +デバイスドライバとこのマニュアルページは Hellmuth Michaelis が +作成しました。hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4bipr.4 b/ja_JP.eucJP/man/man4/i4bipr.4 new file mode 100644 index 0000000000..986a2b2be9 --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4bipr.4 @@ -0,0 +1,97 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4bipr.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" jpman %Id: i4bipr.4,v 1.3 1999/12/29 15:19:14 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:38:34 1998] +.\" +.Dd July 6, 1998 +.Dt i4bipr 4 +.Sh 名称 +.Nm i4bipr +.Nd ISDN B チャネルを用いた IP 伝送のための isdn4bsd ネットワークドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4bipr\&" Op count +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +ドライバは、オペレーティングシステム内の IP サブシステムと isdn4bsd +パッケージの仲介をすることによって、ISDN 接続を用いた IP パケットの +伝送を可能にします。 +.Pp +このドライバは、先頭や後尾に何も追加せずに IP パケットを B チャネルの +HDLC パケットに載せてリモートサイトに送信します。 +リモートサイトから受信された IP パケットはローカルな IP プロトコル +スタックに追加されます。 +.Pp +B チャネルに載せられたパケットのフォーマットは次のようになります: +.Pp +.Dl (HDLC 開始フラグ) (IP パケット) (CRC) (HDLC 終了フラグ) +.Pp +リモートサイトへの IP パケットがドライバに届いたのにそこへの接続が +未確立であるときには、このドライバは +.Xr isdnd 8 +デーモンと通信して接続を確立します。 +.Pp +.Nm ipr +インタフェースに対して +.Xr tcpdump 1 +コマンドを使えるようにするために、このドライバは +.Xr bpf 4 +サブシステムと通信できます。 +.Pp +このドライバは (IPR_VJ オプションを付けてコンパイルされているとき) +Van Jacobsen ヘッダ圧縮の機能を持ちます。これは +.Xr ifconfig 8 +の link0 および link1 オプションを使って制御できます: +.Pp +.Bl -tag -width 15n -offset indent -compact +.It link0 +このインタフェースからの送信パケットに VJ 圧縮を施し、受信パケットは +伸長される必要があると仮定します。 +.It link1 +受信パケットに Van Jacobsen 圧縮がなされているかどうかチェックします; +圧縮されていると思われるときは自動的に link0 がセットされます。 +.El +.Pp +デフォルトでは +.Em link1 +が +.Em on +で +.Em link0 +が +.Em off +です。 +.Sh 関連項目 +.Xr isdnd 8 +.Xr isdnd.rc 5 +.Xr bpf 4 +.Xr tcpdump 1 +.Sh 作者 +.Nm +デバイスドライバとこのマニュアルページは Hellmuth Michaelis が +作成しました。hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4bisppp.4 b/ja_JP.eucJP/man/man4/i4bisppp.4 new file mode 100644 index 0000000000..3a01242d24 --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4bisppp.4 @@ -0,0 +1,105 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4bisppp.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" jpman %Id: i4bisppp.4,v 1.3 1999/12/29 15:19:20 horikawa Stab % +.\" +.\" last edit-date: [Tue Dec 22 20:15:08 1998] +.\" +.Dd December 22, 1998 +.Dt i4bisppp 4 +.Sh 名称 +.Nm i4bisppp +.Nd ISDN B-チャネルを用いた同期 PPP のための isdn4bsd ネットワークドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4bisppp\&" Op count +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +ドライバは、オペレーティングシステム内の IP サブシステムと isdn4bsd +パッケージの仲介をすることによって、ISDN 接続を用いた IP パケットの +伝送を可能にします。 +.Pp +このドライバは、Serge Vakulenko による sppp のバックエンドと ISDN4BSD +パッケージを単に接続するためのレイヤです。 +.Pp +リモート側への IP パケットがドライバに届いたのにそこへの接続が未確立で +あるときには、このドライバは +.Xr isdnd 8 +デーモンと通信して接続を確立します。 +.Pp +.Nm isp +インタフェースに対して +.Xr tcpdump 1 +コマンドを使えるようにするために、このドライバは +.Xr bpf 4 +サブシステムと通信できます。 +.Pp +リモートサイトへ接続するために PPP が必要とするすべての段階を設定するには +.Xr spppcontrol 8 +ユーティリティを用います。 +.Sh LINK0 および LINK1 +.Xr ifconfig 8 +に渡された +.Em link0 +および +.Em link1 +フラグは、 +.Nm isp +デバイスに対して次のような意味をもちます: +.Bl -tag -width link0 -compact +.Pp +.It Li link0 +接続を受け付けるように待ちます。 +.Pp +.It Li link1 +送信時に自動的にダイヤルします。 +.El +.Pp +デフォルトでは +.Em link0 +および +.Em link1 +フラグは +.Em off +になっています。 +.Pp +これらのフラグについての詳細な議論は +.Xr sppp 4 +を参照して下さい。 +.Pp +.Sh 関連項目 +.Xr isdnd 8 +.Xr isdnd.rc 5 +.Xr spppcontrol 8 +.Xr sppp 4 +.Xr bpf 4 +.Xr tcpdump 1 +.Sh AUTHOR +.Nm +デバイスドライバは Joerg Wunsch が作成し、Gary Jennejohn が ISDN4BSD +に追加しました。 +このマニュアルページは Hellmuth Michaelis が作成しました。hm@kts.org +で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4bq921.4 b/ja_JP.eucJP/man/man4/i4bq921.4 new file mode 100644 index 0000000000..ac2e6949a3 --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4bq921.4 @@ -0,0 +1,49 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4bq921.4,v 1.1 1998/12/27 21:47:13 phk Exp % +.\" jpman %Id: i4bq921.4,v 1.3 1999/12/29 15:19:26 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:38:57 1998] +.\" +.Dd February 3, 1998 +.Dt i4bq921 4 +.Sh 名称 +.Nm i4bq921 +.Nd Q.921 プロトコルを扱う isdn4bsd 疑似デバイスドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4bq921\&" +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +は ISDN D チャネルレイヤ 2 のハンドラです。 +.Sh 規格 +ITU 勧告 Q.920 と Q.921 +.Sh 関連項目 +.Xr i4bq931 4 +.Sh 作者 +.Nm +ドライバとこのマニュアルページは Hellmuth Michaelis が作成しました。 +hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4bq931.4 b/ja_JP.eucJP/man/man4/i4bq931.4 new file mode 100644 index 0000000000..dfea927d21 --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4bq931.4 @@ -0,0 +1,49 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4bq931.4,v 1.1 1998/12/27 21:47:14 phk Exp % +.\" jpman %Id: i4bq931.4,v 1.3 1999/12/29 15:19:29 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:39:08 1998] +.\" +.Dd February 3, 1998 +.Dt i4bq931 4 +.Sh 名称 +.Nm i4bq931 +.Nd Q.931 プロトコルを扱う isdn4bsd 疑似デバイスドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4bq931\&" +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +は ISDN D チャネルレイヤ 2 のハンドラです。 +.Sh 規格 +ITU 勧告 Q.930 と Q.931 +.Sh 関連項目 +.Xr i4bq921 4 +.Sh 作者 +.Nm +ドライバとこのマニュアルページは Hellmuth Michaelis が作成しました。 +hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4brbch.4 b/ja_JP.eucJP/man/man4/i4brbch.4 new file mode 100644 index 0000000000..a77abcabab --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4brbch.4 @@ -0,0 +1,49 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4brbch.4,v 1.1 1998/12/27 21:47:14 phk Exp % +.\" jpman %Id: i4brbch.4,v 1.3 1999/12/29 15:19:37 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:39:19 1998] +.\" +.Dd February 3, 1998 +.Dt i4brbch 4 +.Sh 名称 +.Nm i4brbch +.Nd ISDN B チャネルに直接アクセスするための isdn4bsd ドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4brbch\&" Op count +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +ドライバは何も変換が施されていない B チャネルとのインタフェースを提供 +します。これは isdn4bsd パッケージの一部です。 +.Sh 関連項目 +.Xr isdnd 8 +.Xr isdnd.rc 5 +.Sh 作者 +.Nm +ドライバとこのマニュアルページは Hellmuth Michaelis が作成しました。 +hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4btel.4 b/ja_JP.eucJP/man/man4/i4btel.4 new file mode 100644 index 0000000000..038f2d7aaf --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4btel.4 @@ -0,0 +1,51 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4btel.4,v 1.1 1998/12/27 21:47:14 phk Exp % +.\" jpman %Id: i4btel.4,v 1.3 1999/12/29 15:19:42 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:39:31 1998] +.\" +.Dd February 3, 1998 +.Dt i4btel 4 +.Sh 名称 +.Nm i4btel +.Nd isdn4bsd の ISDN B チャネル電話インタフェースドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4btel\&" Op count +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +ドライバは電話を扱うアプリケーションのために B チャネルとのインタフェース +を提供します。今のところ自動応答機をサポートするために +.Xr isdnd 8 +によって使われています。このドライバは isdn4bsd パッケージの一部です。 +.Sh 関連項目 +.Xr isdnd 8 +.Xr isdnd.rc 5 +.Sh 作者 +.Nm +デバイスドライバとこのマニュアルページは Hellmuth Michaelis が作成 +しました。hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/i4btrc.4 b/ja_JP.eucJP/man/man4/i4btrc.4 new file mode 100644 index 0000000000..a36b5eaf3e --- /dev/null +++ b/ja_JP.eucJP/man/man4/i4btrc.4 @@ -0,0 +1,51 @@ +.\" +.\" Copyright (c) 1997, 1998 Hellmuth Michaelis. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: i4btrc.4,v 1.1 1998/12/27 21:47:14 phk Exp % +.\" jpman %Id: i4btrc.4,v 1.3 1999/12/29 15:19:48 horikawa Stab % +.\" +.\" last edit-date: [Sat Dec 5 18:39:42 1998] +.\" +.Dd February 3, 1998 +.Dt i4btrc 4 +.Sh 名称 +.Nm i4btrc +.Nd D および B チャネルのための isdn4bsd ISDN インタフェースドライバ +.Sh FreeBSD での書式 +.Cd pseudo-device \&"i4btrc\&" Op count +.Sh NetBSD での書式 +なし +.Sh 解説 +.Nm +ドライバは、D および (または) B チャネルから受信したデータにヘッダを +付加して待ち行列へ追加します。これらは +.Xr isdntrace 8 +ユーティリティが読み取り、更に処理することになります。 +.Sh 関連項目 +.Xr isdnd 8 +.Xr isdntrace 8 +.Sh 作者 +.Nm +デバイスドライバとこのマニュアルページは Hellmuth Michaelis が作成 +しました。hm@kts.org で彼に連絡できます。 diff --git a/ja_JP.eucJP/man/man4/icmp.4 b/ja_JP.eucJP/man/man4/icmp.4 new file mode 100644 index 0000000000..a4389ec302 --- /dev/null +++ b/ja_JP.eucJP/man/man4/icmp.4 @@ -0,0 +1,115 @@ +.\" Copyright (c) 1986, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)icmp.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: icmp.4,v 1.3 1999/03/11 15:30:19 horikawa Stab % +.\" %Id: icmp.4,v 1.6 1997/03/19 19:47:30 bde Exp % +.\" +.\" WORD: Internet Control Message Protocol インターネットコントロールメッセージプロトコル +.Dd June 5, 1993 +.Dt ICMP 4 +.Os BSD 4.3 +.Sh 名称 +.Nm icmp +.Nd インターネットコントロールメッセージプロトコル +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket AF_INET SOCK_RAW proto +.Sh 解説 +.Tn ICMP +は、 +.Tn IP +及びインターネットプロトコルファミリにおける、 +エラー及び制御通知のためのプロトコルです。 +本プロトコルの機能であるネットワークのモニタリング及び診断機能は、 +.Dq raw socket +を介したアクセスにより利用することができます。 +.Tn ICMP +ソケットを作成するための socket コールへの引数 +.Fa proto +は +.Xr getprotobyname 3 +から得られます。 +.Tn ICMP +ソケットはコネクションレス型であり、普通 +.Xr sendto 2 +及び +.Xr recvfrom 2 +コールと共に使用されます。 +ただし、後で送られるパケットの宛先を固定する場合は +.Xr connect 2 +コールも使用できます (その場合には普通 +.Xr read 2 +または +.Xr recv 2 +、及び +.Xr write 2 +または +.Xr send 2 +システムコールと共に使用されます)。 +.Pp +送信パケットには (宛先アドレスに基づいて) 作成された +.Tn IP +ヘッダが自動的に付与されます。 +受信パケットは、 +.Tn IP +ヘッダ及びオプションが全く損なわれずに受信されます。 +.Sh 診断 +ソケット操作の失敗の際には次のエラーのうちの一つが返されます: +.Bl -tag -width [EADDRNOTAVAIL] +.It Bq Er EISCONN +既にコネクションが確立されているソケットに対し +さらにコネクションを確立させようとした時、 +あるいは既にソケットのコネクションが確立されているのに、 +宛先アドレスを指定してデータグラムを送信しようとした時 +.It Bq Er ENOTCONN +ソケットのコネクションが確立されていない場合に、 +宛先アドレスの指定をせずデータグラムの送信を行おうとした時 +.It Bq Er ENOBUFS +内部的なデータ構造のためのメモリが不足した時 +.It Bq Er EADDRNOTAVAIL +対応したネットワークインタフェースが存在しない +ネットワークアドレスを指定し、ソケットを作成しようとした時 +.El +.Sh 関連項目 +.Xr recv 2 , +.Xr send 2 , +.Xr inet 4 , +.Xr intro 4 , +.Xr ip 4 +.Sh 歴史 +.Nm +プロトコルは +.Bx 4.3 +から登場しました。 \ No newline at end of file diff --git a/ja_JP.eucJP/man/man4/ie.4 b/ja_JP.eucJP/man/man4/ie.4 new file mode 100644 index 0000000000..2693c4cc84 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ie.4 @@ -0,0 +1,96 @@ +.\" jpman %Id: ie.4,v 1.3 1999/11/28 15:53:03 horikawa Stab % +.\" +.\" Copyright (c) 1994, Wilko Bulte +.\" All rights reserved. +.\" +.\" %Id: ie.4,v 1.7 1998/10/22 14:12:55 bde Exp % +.\" +.Dd September 23, 1994 +.Dt IE 4 i386 +.Os +.Sh 名称 +.Nm ie +.Nd +イーサーネットデバイスドライバ +.Sh 書式 +.Cd "device ie0 at isa? port 0x360 net irq 7 iomem 0xd0000" +.Sh 解説 +.Nm ie +ドライバは、8 ビット及び 16ビットの Intel i82586 チップをベースにした、 +ISA イーサネットカードのサポートを提供します。 +これは AT&T の Starlan 10 及び Starlan Fiber、 +EN100、Intel EtherExpress 16、3COM 3C507 及び RACAL Interlan NI5210 +をサポートします。 +.Pp +.Sh 診断 +.Bl -diag +.It "ie%d: unknown board type code %d" +i82586 チップは見つかりましたが、 +ドライバはプローブ中に実際のボードタイプを決定できませんでした。 +.It "ie%d: kernel configured maddr %x doesn't match board configured maddr %x" +デバイスプローブは、 +カーネル設定ファイルに指定された maddr と異なる maddr を検出しました。 +.It "ie%d: can't find shared memory" +デバイスプローブは、 +共有メモリの大きさを得るためのアクセスができませんでした。 +.It "ie%d: kernel configured msize %d doesn't match board configured msize %d" +デバイスプローブは、 +共有メモリの大きさがカーネル設定ファイルに指定されたサイズと異なることを +検出しました。 +.It "ie%d: kernel configured irq %d doesn't match board configured irq %d" +デバイスプローブは、 +ボードの割り込み設定がカーネル設定ファイルに指定された設定と異なることを +検出しました。 +.It "ie%d: reset" +Intel i82586 はドライバによりリセットされる必要がありました。 +.It "ie%d: transceiver problem" +ドライバは、イーサーネットトランシーバに問題を検出しました。 +これは、 +外付けトランシーバを使用しているときにトランシーバケーブルが緩んでいる、 +もしくは破損していることを意味します。 +もしこの問題をカード上のトランシーバで経験した場合には、 +カードが外付けトランシーバを使用するように +誤ってジャンパ設定されているかもしれません。 +最悪の場合、オンボードトランシーバは壊れているかもしれません。 +.It "ie%d: TDR detected an open %d clocks away" +ドライバは、 +イーサーネットケーブルの回路がオープンになっていることを検出しました。 +同軸ケーブルと終点抵抗を確認してください。 +.It "ie%d: TDR detected a short %d clocks away" +ドライバは、 +イーサーネットケーブルが短絡していることを検出しました。 +同軸ケーブルと終端抵抗を確認してください。 +.It "ie%d: TDR returned unknown status %x" +ドライバは、イーサーネットケーブル試験で不明な状態を得ました。 +.It "ie%d: multicast address setup command failed" +カードは、マルチキャストモードに入れませんでした。 +.It "ie%d: configure command failed" +カードは、設定中に正常に応答することを拒否しました。 +.It "ie%d: individual address setup command failed" +イーサネットの MAC アドレスをプログラムすることに失敗しました。 +.El +.Sh 警告 +Racal Interlan NI5210 には、 +共有メモリが 8K バイトのものと 16K バイトのものとがあります。 +16K バイトのものを使用することを強く推奨します。 +8K バイトカードは、追加の RAM チップを加えることにより、 +16K バイトにすることができます。 +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 作者 +.Nm +デバイスドライバは、 +.An William F. Jolitz +及び Lawrence Berkeley Laboratories のコードを基に +.An Garrett A. Wollman +が作成しました。 +.Tn 3C507 +サポートは +.An Charles M. Hannum +が作成しました。 +このマニュアルページは +.An Wilko C. Bulte +が記述しました。 diff --git a/ja_JP.eucJP/man/man4/ifmib.4 b/ja_JP.eucJP/man/man4/ifmib.4 new file mode 100644 index 0000000000..dda38ebea0 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ifmib.4 @@ -0,0 +1,183 @@ +.\" Copyright 1996 Massachusetts Institute of Technology +.\" +.\" Permission to use, copy, modify, and distribute this software and +.\" its documentation for any purpose and without fee is hereby +.\" granted, provided that both the above copyright notice and this +.\" permission notice appear in all copies, that both the above +.\" copyright notice and this permission notice appear in all +.\" supporting documentation, and that the name of M.I.T. not be used +.\" in advertising or publicity pertaining to distribution of the +.\" software without specific, written prior permission. M.I.T. makes +.\" no representations about the suitability of this software for any +.\" purpose. It is provided "as is" without express or implied +.\" warranty. +.\" +.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS +.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, +.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT +.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ifmib.4,v 1.7 1997/03/19 19:47:31 bde Exp % +.\" jpman %Id: ifmib.4,v 1.3 2000/07/13 04:29:01 horikawa Stab % +.\" +.Dd November 15, 1996 +.Dt IFMIB 4 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm ifmib +.Nd ネットワークインタフェースの MIB +.Sh 概要 +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Sh 解説 +.Nm ifmib +機能は、 +.Xr netstat 1, +.Xr slstat 8 +及び +.Tn SNMP +管理エージェントのようなクライアントアプリケーションに対し、 +ネットワークインタフェースに関する管理情報を提供する +.Xr sysctl 3 +インタフェースのアプリケーションです。 +この情報は、表のそれぞれの行が論理的なネットワークインタフェース +(ハードウェアデバイスまたは +.Xr lo 4 +のようなソフトウェアによる仮想デバイスのどちらか) からなる表形式で +構築されます。 +表には 2 つの列があり、それぞれの列はひとつの構造体を持ちます。 +ひとつの列はすべてのインタフェースに関連する一般的な情報を含み、 +もう一方の列はインタフェースの特定のクラスに固有な情報を含みます。 +(一般的に後者は、もし存在しカーネルに実装可能であれば、 +特定のインタフェースクラスを定義する +.Tn SNMP +.Tn MIB +を実装します。) +.Pp +.Nm +機能は +.Xr sysctl 3 +MIB の +.Dq Li net.link.generic +ブランチ経由でアクセスされます。 +.Xr sysctl 3 +.Ar name +のそれぞれのレベルの明白な定数は +.Aq Pa net/if_mib.h +で定義されます。 +インタフェースの総数 (そしてつまり表の行数) は +.Dq Li net.link.generic.system.ifcount +(または、明白な定数である +.Dv CTL_NET , +.Dv PF_LINK , +.Dv NETLINK_GENERIC , +.Dv IFMIB_SYSTEM , +.Dv IFMIB_IFCOUNT ) +によって与えられます。 +特定のインタフェースを検索する管理アプリケーションは、1 番目の行から +開始し、指定されたインタフェースが検出されるか、インタフェースの総数に +達するまで、行から行へと表を移動します。 +.Pp +すべてのインタフェースに共通な、一般的なインタフェース情報は下記の手順で +アクセスできます: +.Bd -literal -offset indent +int +get_ifmib_general(int row, struct ifmibdata *ifmd) +{ + int name[6]; + + name[0] = CTL_NET; + name[1] = PF_LINK; + name[2] = NETLINK_GENERIC; + name[3] = IFMIB_IFDATA; + name[4] = row; + name[5] = IFDATA_GENERAL; + + return sysctl(name, 6, ifmd, sizeof *ifmd, (void *)0, 0); +} +.Ed +.Pp +.Li ifmibdata 構造体 +のフィールドは下記のとおりです: +.Bl -tag -width "ifmd_snd_drops" +.It Li ifmd_name +.Pq Li "char []" +ユニット番号を含む、インタフェースの名前 +.It Li ifmd_pcount +.Pq Li int +無差別に接続を待っている数 +.It Li ifmd_flags +.Pq Li int +インタフェースのフラグ ( +.Aq Pa net/if.h +で定義されています) +.It Li ifmd_snd_len +.Pq Li int +送信キューの現在の瞬間的な長さ +.It Li ifmd_snd_drops +.Pq Li int +送信キューが一杯だったためこのインタフェースがドロップしたパケット数 +.It Li ifmd_data +.Pq Li struct if_data +.Aq Pa net/if.h +に定義されている構造体からの詳細情報 +.Pq Xr if_data 9 を参照して下さい +.El +.Pp +クラス固有な情報は +.Dv IFDATA_LINKSPECIFIC +列を代わりに調べることによって取得できます。構造体の形式および長さは +インタフェースのクラスに依存することに注意して下さい。 +.Dv IFT_ETHER, +.Dv IFT_ISO88023 , +.Dv IFT_STARLAN +インタフェースについては, 構造体は +.Dq Li struct ifmib_iso_8802_3 +( +.Aq Pa net/if_mib.h +で定義されています) と呼ばれていて、 +イーサネットライクなネットワークのための +.Tn "RFC 1650" +MIB のスーパセットを実装しています。 +.\" これはそのうち ethermib(4) で定義されます。 +.Dv IFT_SLIP については, +構造体は +.Dq Li struct sl_softc +.Pq Aq Pa net/if_slvar.h +です。 +.Sh 関連項目 +.Xr sysctl 3 , +.Xr intro 4 , +.Xr ifnet 9 +.\" .Xr ethermib 4 , +.Rs +.%T "Definitions of Managed Objects for the Ethernet-like Interface Types Using SMIv2" +.%A F. Kastenholz +.%D 1994年 8月 +.%O RFC 1650 +.Re +.Sh バグ +ほとんどのイーサネットライクなインタフェースは Ethernet MIB を +まだサポートしていません。サポートすることを知られているインタフェースには +.Xr ed 4 +及び +.Xr de 4 +を含みます。 +にもかかわらず、すべてのインタフェースは自動的に generic MIB をサポートします。 +.Sh 歴史 +.Nm +は +.Fx 2.2 +で初めて出現しました。 diff --git a/ja_JP.eucJP/man/man4/iic.4 b/ja_JP.eucJP/man/man4/iic.4 new file mode 100644 index 0000000000..917cb84716 --- /dev/null +++ b/ja_JP.eucJP/man/man4/iic.4 @@ -0,0 +1,65 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: iic.4,v 1.3 1999/09/11 08:12:48 horikawa Stab % +.Dd October 25, 1998 +.Dt IIC 4 +.Os FreeBSD +.Sh 名称 +.Nm iic +.Nd +I2C 汎用 I/O デバイスドライバ +.Sh 書式 +.Cd "device iic0 at iicbus?" +.Sh 解説 +.Em iic +キャラクタデバイスドライバは、 +.Xr iicbus 4 +の実体に対し、汎用の I/O を提供します。 +I2C デバイスを制御するためには、 +次の ioctl を /dev/iic? に使用します。 +.Pp +.Bl -column "ioctls" -compact +.It Em Ioctl Ta Em 解説 +.It Sy I2CSTART Ta "バス上の (7 ビットアドレスで) 指定されたデバイスに開始状態を送る" +.It Sy I2CSTOP Ta "バスに停止状態を送る" +.It Sy I2CRSTCARD Ta "バスをリセットする" +.El +.Pp +読み出し/書き込みルーチンも使用することができ、 +その場合は I2C の開始/停止のハンドシェークは +iicbus システムによって管理されます。 +.Pp +.Sh 関連項目 +.Xr iicbus 4 +.Sh 歴史 +.Nm +のマニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/iicbb.4 b/ja_JP.eucJP/man/man4/iicbb.4 new file mode 100644 index 0000000000..cf5233358b --- /dev/null +++ b/ja_JP.eucJP/man/man4/iicbb.4 @@ -0,0 +1,61 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: iicbb.4,v 1.3 1999/09/11 08:12:58 horikawa Stab % +.\" WORD: bit-banging ビット操作 +.Dd October 25, 1998 +.Dt IICBB 4 +.Os FreeBSD +.Sh 名称 +.Nm iicbb +.Nd +I2C 汎用ビット操作ドライバ +.Sh 書式 +.Cd "controller iicbb0" +.Pp +.Cd "device lpbb at ppbus?" +.Pp +1 つ以上の iicbus バスに: +.Cd "controller iicbus0" +.Sh 解説 +.Em iicbb +ドライバは +.Xr iicbus 4 +システム用の汎用のビット操作 (bit-banging) インタフェースの +サポートを提供します。 +.Pp +.Sh 関連項目 +.Xr iicbus 4 , +.Xr lpbb 4 , +.Xr ppbus 4 +.Sh 歴史 +.Nm +のマニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/iicbus.4 b/ja_JP.eucJP/man/man4/iicbus.4 new file mode 100644 index 0000000000..6d6a23504f --- /dev/null +++ b/ja_JP.eucJP/man/man4/iicbus.4 @@ -0,0 +1,119 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: iicbus.4,v 1.3 1999/09/11 08:13:08 horikawa Stab % +.Dd August 6, 1998 +.Dt IICBUS 4 +.Os FreeBSD +.Sh 名称 +.Nm iicbus +.Nd +I2C バスシステム +.Sh 書式 +.Cd "controller iicbus0" +.Cd "controller iicbb0" +.Pp +.Cd "device iic0 at iicbus?" +.Cd "device ic0 at iicbus?" +.Cd "device iicsmb0 at iicbus?" +.Sh 解説 +様々な I2C デバイスを制御し種々の I2C コントローラを利用する +ドライバを実装するため、 +.Em iicbus +システムは、 +単一形態で、モジュール化された、 +アーキテクチャに依存しないシステムを提供します。 +.Sh I2C +I2C は相互統合回路バス (Inter Integrated Circuit bus) の略称です。 +I2C バスは Philips semiconductors によって 1980 年代の初期に開発されました。 +その目的は TV セットにおいて +CPU と周辺チップの接続を容易にするためのものでした。 +.Pp +バスは物理的には、 +2 つのアクティブワイヤと 1 つのグランドへの接続から構成されます。 +アクティブワイヤである SDA と SCL はどちらも双方向のものです。 +SDA は シリアルデータラインであり、SCL はシリアルクロックラインです。 + +バスに接続されるすべてのコンポーネントは、 +それが CPU、LCD ドライバ、メモリもしくは複雑な機能を持ったチップであれば、 +ユニークなアドレスを持ちます。 +これらの各々のチップは、その機能に応じて、 +受信側としても送信側としても (またその両方としても) +動作することができます。 +明らかに LCD ドライバは受信側だけでしょうし、 +メモリや I/O チップは送信側と受信側の両方になるでしょう。 +さらに 1 つ以上のバスマスタが存在します。 + +バスマスタはバス上に命令を発行するチップです。 +I2C プロトコル仕様では、 +バス上のデータ転送を開始させる IC がバスマスタであるとされています。 +その時点では、全ての他のコンポーネントはバススレーブとみなされます。 +すでに述べたように、IC バスはマルチマスタバスです。 +これはデータ転送を開始させることのできる IC を +1 つ以上接続することができることを意味しています。 +.Sh デバイス +いくつかの I2C デバイスドライバが使用可能です。 +.Pp +.Bl -column "デバイス" -compact +.It Em デバイス Ta Em 説明 +.It Sy iic Ta "一般の I/O 操作" +.It Sy ic Ta "ネットワーク IP インタフェース" +.It Sy iicsmb Ta "I2C から SMB へのソフトウェアブリッジ" +.El +.Sh インタフェース +I2C プロトコルはハードウェアによってもソフトウェアによっても +実装することができます。 +ソフトウェアインタフェースは、 +通常は 2 つの抵抗によって駆動される 2 本の信号線からなる +非常に単純なハードウェアにのみ依存しています。 +ハードウェアインタフェースはもっとインテリジェントなものであり、 +I2C プロトコルにしたがってバスに書かれた 8 ビット文字データを受け取ります。 + +I2C インタフェースはバス上でスレーブデバイスとして振る舞うことができ、 +I2C プロトコルのマルチマスタ能力のおかげで +自動的に双方向通信を行うことができます。 + +いくつかの I2C インタフェースが使用可能です。 +.Pp +.Bl -column "インタフェース" -compact +.It Em インタフェース Ta Em 説明 +.It Sy pcf Ta "Philips PCF8584 マスタ/スレーブインタフェース" +.It Sy iicbb Ta "汎用ビット操作マスタ専用ドライバ" +.It Sy lpbb Ta "パラレルポート専用ビット操作インタフェース" +.It Sy bktr Ta "Brooktree848 ビデオチップセット, ハードウェアおよびソフトウェアマスタ専用インタフェース" +.El +.Sh 関連項目 +.Xr pcf 4 , +.Xr iicbb 4 , +.Xr lpbb 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で最初に登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/iicsmb.4 b/ja_JP.eucJP/man/man4/iicsmb.4 new file mode 100644 index 0000000000..e53403b975 --- /dev/null +++ b/ja_JP.eucJP/man/man4/iicsmb.4 @@ -0,0 +1,57 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: iicsmb.4,v 1.3 1999/09/11 08:13:21 horikawa Stab % +.Dd August 10, 1998 +.Dt IICSMB 4 +.Os FreeBSD +.Sh 名称 +.Nm iicsmb +.Nd +I2C から SMB へのブリッジ +.Sh 書式 +.Cd "device iicsmb0 at iicbus?" +.Pp +1 つ以上の smbus バスに対して: +.Cd "controller smbus0" +.Sh 解説 +.Em iicsmb +ドライバは +.Xr iicbus 4 +を介した +.Xr smbus 4 +システム用の SMB コマンドをサポートしています。 +.Pp +.Sh 関連項目 +.Xr smbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で最初に登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/imm.4 b/ja_JP.eucJP/man/man4/imm.4 new file mode 100644 index 0000000000..d0ce1dc650 --- /dev/null +++ b/ja_JP.eucJP/man/man4/imm.4 @@ -0,0 +1,61 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: imm.4,v 1.3 1999/09/11 08:13:32 horikawa Stab % +.Dd October 27, 1998 +.Dt IMM 4 +.Os FreeBSD +.Sh 名称 +.Nm imm +.Nd +パラレルから SCSI へのインタフェースドライバ +.Sh 書式 +.Cd "controller vpo at ppbus?" +.Pp +1 つ以上の SCSI バスに対し: +.Cd "controller scbus0 at vpo0" +.Sh 解説 +imm ドライバは、 +.Xr vpo 4 +ドライバを拡張して、 +Iomega Matchmaker Parallel to SCSI インタフェース用にしたものです。 +このドライバのほとんどは +.Xr microseq 9 +のメカニズムを使用して書かれています。 +.Sh 関連項目 +.Xr ppbus 4 , +.Xr vpo 4 , +.Xr microseq 9 , +.Xr scsi 4 , +.Xr sd 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/inet.4 b/ja_JP.eucJP/man/man4/inet.4 new file mode 100644 index 0000000000..c2a1081b26 --- /dev/null +++ b/ja_JP.eucJP/man/man4/inet.4 @@ -0,0 +1,302 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)inet.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: inet.4,v 1.3 2000/07/13 04:28:56 horikawa Stab % +.\" %Id: inet.4,v 1.8 1997/02/22 13:24:32 peter Exp % +.\" +.Dd February 14, 1995 +.Dt INET 4 +.Os BSD 4.2 +.Sh 名称 +.Nm inet +.Nd インターネットプロトコルファミリ +.Sh 書式 +.Fd #include +.Fd #include +.Sh 解説 +インターネットプロトコルファミリは +.Em Internet Protocol +.Pq Tn IP +トランスポート層の上に位置し、インターネットアドレスフォーマットを +利用するプロトコル群です。 +インターネットファミリは、 +.Dv SOCK_STREAM , SOCK_DGRAM +および +.Dv SOCK_RAW +ソケットタイプのためのプロトコルのサポートを提供します。 +.Dv SOCK_RAW +インタフェースは +.Tn IP +プロトコルへのアクセスを提供します。 +.Sh アドレッシング +インターネットアドレスは 4 バイトの大きさであり、 +ネットワーク標準フォーマットで格納されています ( +.Tn VAX +では、ワード、バイトの順序を逆にしたものです)。 +インクルードファイル +.Aq Pa netinet/in.h +では、このアドレスを +区分された共用体として定義しています。 +.Pp +インターネットプロトコルファミリに結合されたソケットは、次の +アドレッシング構造体を利用します。 +.Bd -literal -offset indent +struct sockaddr_in { + u_char sin_len; + u_char sin_family; + u_short sin_port; + struct in_addr sin_addr; + char sin_zero[8]; +}; +.Ed +.Pp +到着メッセージに対する +.Dq ワイルドカード +マッチングの効果を得る場合、 +.Dv INADDR_ANY +ローカルアドレスを用いて、 +ソケットを生成することができます。 +.Xr connect 2 +あるいは +.Xr sendto 2 +の呼び出しで与えるアドレスとして、 +.Dq このホスト +を意味するために、 +.Dv INADDR_ANY +を与えても構いません。 +もし最初からネットワークがブロードキャストをサポートするように設定 +されていれば、 +特別のアドレスである +.Dv INADDR_BROADCAST +が、プライマリネットワーク上のブロードキャストアドレスを表す略記として +許されています。 +.Sh プロトコル +インターネットプロトコルファミリは、 +.Tn IP +ネットワークプロトコル、 +インターネットコントロールメッセージプロトコル +.Pq Tn ICMP +、インターネットグループマネジメントプロトコル +.Pq Tn IGMP +、トランスミッションコントロールプロトコル +.Pq Tn TCP +、およびユーザデータグラムプロトコル +.Pq Tn UDP +からなります。 +.Tn TCP +は +.Dv SOCK_STREAM +アブストラクションをサポートするために使われ、 +.Tn UDP +は +.Dv SOCK_DGRAM +アブストラクションをサポートするために使われます。 +.Tn IP +に対する raw インタフェースが、 +.Dv SOCK_RAW +タイプのインターネットソケットを生成することにより +利用可能です。 +.Tn ICMP +メッセージプロトコルが raw ソケットからアクセス可能です。 +.Pp +32 ビットのインターネットアドレスはネットワーク部とホスト部の +両方を含んでいます。 +しかしながら、アドレスに対して直接検査することは推奨されません。 +どうしてもアドレスをその 2 つの部分に分割する必要のあるプログラムの +ために、次の +.Xr ioctl 2 +コマンドがインターネットドメインのデータグラムソケット向けに +提供されています。 +それらは +.Dv SIOCIFADDR +コマンド ( +.Xr intro 4 +を参照 ) と同じ形式を持ちます。 +.Pp +.Bl -tag -width SIOCSIFNETMASK +.It Dv SIOCSIFNETMASK +インタフェースのネットワークマスクを設定します。 +ネットワークマスクはアドレスのネットワーク部を定義します。 +もしそれがアドレスタイプが示すよりも多いアドレスを含むなら、 +サブネットが使われています。 +.It Dv SIOCGIFNETMASK +インタフェースのネットワークマスクを得ます。 +.El +.Sh ルーティング +インターネットプロトコルの現在の実装は、トランザクション TCP +(Transaction TCP) および経路の MTU 検出 (Path MTU Discovery) +に必要なある種のエンドツーエンド情報に対する強力な +キャッシングを提供するために、ルーティングテーブルに対する +いくつかの調整を含んでいます。 +次に示す変更が最も重要です : +.Bl -enum +.It +.Dv RTF_CLONING +フラグ付きあるいはマルチキャストの終点宛 +以外の IP 経路は +.Dv RTF_PRCLONING +フラグが強制的に立てられます (これは +.Dq "プロトコルクローニング" +と呼ばれます。) +.It +ある IP 経路への最後の参照が欠落している場合、 +その経路が、そのような経路をコピーすることにより生成されたかどうかが +検査されます。 +もしそうであれば、 +.Dv RTF_PROTO3 +フラグが立てられ、net.inet.ip.rtexpire 秒以内に消去されるように +無効化のためのタイマが初期化されます。 +そのような経路が再び参照されると、フラグとタイマはリセットされます。 +.It +10 分に 1 回、あるいはカーネルのルーティングテーブルに期限切れ直前の +経路が存在するとすぐにカーネルタイムアウトが実行され、 +期限切れの経路を削除します。 +.El +.Pp +キャッシュされている経路が大きくなり過ぎた場合、 +net.inet.ip.rtexpire の値を変更するための +動的な処理が実行されます。 +期限切れ消去の実行後に、net.inet.ip.rtmaxcache +より多い数の経路が参照されないまま残っている場合、 +rtexpire が 3/4 にされ、これより長い期限をもつ +すべての経路の期限が調整されます。 +最小の rtexpire 値 (net.inet.ip.rtminexpire) の指定および +この削減を 10 分に 1 回おきに起こるように制限することにより、 +このプロセスの効果はいくらか小さくなります。 +.Pp +何らかの外部プロセスが、 +プロトコルクローンで作られた経路の +オリジナルの経路を削除した場合、 +「子の経路」は削除されます。 +(実際のところ、これは、プロトコル要求クローニングをサポートする +ルーティングコードにおける一般的なメカニズムです。) +.Pp +プロトコルクローニングにより生成されたのではない経路を管理する +試みは行なわれません。 +それらは静的であり、 +外部のルーティングプロセスや、あるいは +リンク層 (たとえば +イーサネットにおける +.Tn ARP ) +の管理下にあると想定されます。 +.Pp +ある種のネットワーク活動だけが、このメカニズムを用いて経路のクローニング +を行ないます。 +特にある宛先を持ち、長い間継続する経路の参照を自分自身でキャッシュ +するプロトコル ( +.Tn TCP +や +.Tn UDP +のような ) +は、このメカニズムを起動するきっかけとなります。 +一方、ローカルに生成されたものであれフォワードされたものであれ、 +生の IP パケットだと、このメカニズムは起動しません。 +.Sh MIB 変数 +.Xr sysctl 3 +MTB の net.inet ブランチには、多くの +変数が実装されています。 +トランスポートプロトコルによりサポートされる変数 +(各々のマニュアルページを参照してください) +に加え、次の一般的な変数が定義されています。 +.Bl -tag -width IPCTL_SENDREDIRECTS +.It Dv IPCTL_FORWARDING +.Pq ip.forwarding +ブール値: IP パケットのフォワーディングを可能にする / 抑制する +(デフォルトではカーネル設定オプション +.Dv GATEWAY +によります)。 +.It Dv IPCTL_SENDREDIRECTS +.Pq ip.redirect +ブール値: フォワードできない +.Tn IP +パケットについて ICMP リダイレクトを送出する / 送出しない +(デフォルトは真)。 +.It Dv IPCTL_DEFTTL +.Pq ip.ttl +整数値: 外に出ていく +.Tn IP +パケットのデフォルトの生存時間。 +.It Dv IPCTL_SOURCEROUTE +.Pq ip.sourceroute +ブール値: 始点経路制御された IP パケットのフォワードを +可能にする / 抑制する (デフォルトは偽)。 +.It Dv IPCTL_RTEXPIRE +.Pq ip.rtexpire +整数値: プロトコルクローンされた +.Tn IP +経路の、最後の参照が終了した後の秒単位の +生存時間 (デフォルトは 1 時間)。 +上記のように、この値は動的に変化します。 +.It Dv IPCTL_RTMINEXPIRE +.Pq ip.rtminexpire +整数値: ip.rtexpire の最小値 (デフォルトは 10 秒)。 +この値はユーザによる変更に対しては効果がなく、上記のような動的調整に +限られています。 +.It Dv IPCTL_RTMAXCACHE +.Pq ip.rtmaxcache +整数値: キャッシュされ、かつ参照されず、かつプロトコル +クローンされた経路の、動的な調整を開始するトリガレベル (デフォルトは 128)。 +.El +.Sh 関連項目 +.Xr ioctl 2 , +.Xr socket 2 , +.Xr sysctl 3 , +.Xr icmp 4 , +.Xr igmp 4 , +.Xr intro 4 , +.Xr ip 4 , +.Xr tcp 4 , +.Xr ttcp 4 , +.Xr udp 4 +.Rs +.%T "An Introductory 4.3 BSD Interprocess Communication Tutorial" +.%B PS1 +.%N 7 +.Re +.Rs +.%T "An Advanced 4.3 BSD Interprocess Communication Tutorial" +.%B PS1 +.%N 8 +.Re +.Sh 警告 +インターネットプロトコルのサポートは、インターネットプロトコルの +発展に従属しています。ユーザは現在の実装の詳細に依存してはならず、 +むしろエクスポートされたサービスに依存すべきです。 +.Sh 歴史 +.Nm +プロトコルインタフェースは +.Bx 4.2 +で登場しました。 +.Dq プロトコルクローニング +のコードは +.Fx 2.1 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/intro.4 b/ja_JP.eucJP/man/man4/intro.4 new file mode 100644 index 0000000000..7bf83c472e --- /dev/null +++ b/ja_JP.eucJP/man/man4/intro.4 @@ -0,0 +1,203 @@ +.\" +.\" Copyright (c) 1996 David E. O'Brien, Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: intro.4,v 1.11 1998/11/30 17:52:45 rnordier Exp % +.\" jpman %Id: intro.4,v 1.3 1999/11/19 15:20:10 horikawa Stab % +.\" WORD: pseudo-device 疑似デバイス +.\" WORD: block device ブロック型デバイス +.\" WORD: device node デバイスノード +.\" WORD: buffered device バッファリングされるデバイス +.\" WORD: unbuffered device バッファリングされないデバイス +.\" WORD: raw device raw デバイス +.\" WORD: i386 architecture i386 アーキテクチャ +.\" +.Dd January 20, 1996 +.Dt INTRO 4 +.Os FreeBSD 2.1 +.Sh 名称 +.Nm intro +.Nd デバイスおよびデバイスドライバの紹介 +.Sh 解説 +本セクションではデバイス、デバイスドライバ、 +その他ハードウェアに関連した情報を記します。 +.Ss デバイスの抽象化 +デバイスとは多くの場合、ディスク、プリンタ、 +あるいはキーボード付きのグラフィックスディスプレイのような、 +システムに属すハードウェア関連の機材を表す用語です。 +また、いわゆる +.Em 疑似デバイス +というものもあります。これは、デバイスドライバが +ソフトウェア的にデバイスの動作をエミュレートするもので、 +特定のハードウェアを根幹として持ちません。 +後者の類の典型的な例として +.Pa /dev/mem +があります。 +これは通常ファイルと同じセマンティクスで +物理メモリにアクセスできる小穴のようなものです。 +.Pp +一般に、デバイスの抽象化の上位層では、 +共通的なシステムコール群が提供されます。 +これらのシステムコールはカーネルの上位層によって +対応するデバイスドライバへ送られます。 +デバイスに利用できるシステムコール群は、 +.Xr open 2 , +.Xr close 2 , +.Xr read 2 , +.Xr write 2 , +.Xr ioctl 2 , +.Xr select 2 , +.Xr mmap 2 +から選ばれます。 +すべてのドライバがこれらのシステムコールすべてを +実装しているわけではありません。例えば、 +.Xr mmap 2 +を端末デバイス上で呼び出しても何の役にも立たないでしょう。 +.Ss デバイスへのアクセス +UNIX 風オペレーティングシステム下のほとんどのデバイスには、 +いわゆる +.Em デバイスノード +、あるいは +.Em 特殊ファイル +とも呼ばれるものを介してアクセスします。 +これは通常はそのファイルシステム階層の +.Pa /dev +ディレクトリ下に置かれます。 +.Pq Xr hier 7 を参照 +。 +.Pp +.Xr devfs 5 +が完全に機能していなければ、各デバイスノードは静的に、 +かつ関連するデバイスドライバの存在とは無関係に、作成される必要があります。 +大抵は +.Xr MAKEDEV 8 +を実行させて作成します。 +.Pp +これはつまり、一貫した状態にならないかもしれないということです。 +関連するドライバが設定されていないようなデバイスノードが +存在するかもしれませんし、デバイスの検出に成功したのに、 +対応するデバイスノードがまだ無いために +アクセスできないドライバが存在するかもしれません。 +前者の場合では、そのデバイスノードを通してデバイスを参照しようとしても、 +カーネルの上位層からエラーが返されます。 +通常このエラーは +.Ql ENXIO +です。 +後者の場合では、ドライバとデバイスを使えるようにするには、 +デバイスノードを作成する必要があります。 +.Pp +デバイスによっては 2 種類に分かれることがあります。 +.Em ブロック型 (block) デバイス +と +.Em キャラクタ型 (character) デバイス +です。より正確に言えばすなわち、 +バッファリングされるデバイスとバッファリングされないデバイス +.Pq raw デバイス +です。 +.Ql ls -l +の出力では、ファイルの型の識別に文字 +.Ql b +と +.Ql c +で慣習的な呼び名を表しています。 +バッファリングされるデバイスは、 +オペレーティングシステムのバッファキャッシュを経由してアクセスされています。 +そして、このようなデバイスは、その上位にファイルシステムを +重ねることのみを目的としています。 +通常、バッファリングされるデバイスは、 +ディスクやディスク風デバイス、 +それに歴史的な理由からテープデバイスにのみ実装されます。 +.Pp +raw デバイスはすべてのドライバに利用できます。 +これにはバッファリングされるデバイスも実装するようなドライバも含みます。 +そのようなデバイスでは、慣習的にデバイスノードのパス名に文字 +.Ql r +を前置して違いを表します。 +例えば、 +.Pa /dev/rda0 +は 1 台目の SCSI ディスク用の raw デバイスを表します。一方、 +.Pa /dev/da0 +は同じくバッファリングされるデバイスのデバイスノードです。 +.Pp +バッファリングされないデバイスは、 +ファイルシステム操作に関連しない動作すべてに用いられるでしょう。 +これはそのデバイスがディスクデバイスだとしてもです。 +これには、ディスクパーティション全体のバックアップを取るときや、 +.Em raw +フロッピディスクへバックアップする場合を含みます +.Pq このとき、フロッピディスクはテープのように使われます +。 +.Pp +デバイスノードへのアクセス制限は、 +カーネル内部のドライバによって直接に暗黙指定されているわけではなく、 +普通はそのデバイスノードエントリの通常ファイルパーミッションの問題です。 +.Ss デバイスノードを持たないドライバ +ネットワークデバイス用のドライバにアクセスするときには +デバイスノードは使いません。 +これらのドライバはカーネル内部の別の判断で選択されます。 +また一般的にネットワークデバイスの利用は、 +.Xr open 2 +を呼び出すのではなく、 +.Xr socket 2 +システムコールでおこなわれます。 +.Ss カーネルにドライバを組み込む +各カーネルには、そのカーネルの機能やドライバを選択したり +各種オプションを調整するための基礎として用いられる、設定ファイルが存在します。 +関連するファイルの詳細な記述については +.Xr config 8 +を参照してください。 +本セクションの個々のマニュアルページは、 +設定ファイルのサンプル行をその書式セクションに提示しています。 +設定ファイルのサンプルとして +.Po +.Em i386 +アーキテクチャ用の +.Pc +.Pa /sys/i386/conf/LINT +も参照してください。 +.Sh 関連項目 +.Xr close 2 , +.Xr ioctl 2 , +.Xr mmap 2 , +.Xr open 2 , +.Xr read 2 , +.Xr select 2 , +.Xr socket 2 , +.Xr write 2 , +.Xr devfs 5 , +.Xr hier 7 , +.Xr config 8 , +.Xr MAKEDEV 8 +.Sh 作者 +本マニュアルページは +.An David E. O'Brien +の投稿を元に +.if t J\(:org Wunsch +.if n Joerg Wunsch +が書きました。 +.Sh 歴史 +.Nm intro +は +.Fx 2.1 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/io.4 b/ja_JP.eucJP/man/man4/io.4 new file mode 100644 index 0000000000..3f2eb2f255 --- /dev/null +++ b/ja_JP.eucJP/man/man4/io.4 @@ -0,0 +1,72 @@ +.\" +.\" Copyright (c) 1996 Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" This program is free software. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: io.4,v 1.5 1997/03/21 20:13:45 mpp Exp % +.\" jpman %Id: io.4,v 1.4 2000/07/20 10:04:48 osana Stab % +.\" +.Dd Jan 1, 1996 +.Dt IO 4 i386 +.Os +.Sh 名称 +.Nm io +.Nd I/O 特権ファイル +.Sh 解説 +特殊ファイル +.Pa /dev/io +は制御下にあるセキュリティホールで、 +.Pq 通常はカーネルの内部コードに予約された +I/O 特権を得ることをプロセスに許可します。 +.Pa /dev/io +を開いたファイル記述子を持ったどんなプロセスでも、 +フラグレジスタセットの中の +.Em IOPL +ビットを得ることができます。 +すなわち、直接 I/O を操作することが許されます。 +これは、ハードウェアを直接操作する +ユーザランドのプログラムを書くために役立ちます。 +.Pp +アクセス制御全体は +.Pa /dev/io +のファイルアクセスパーミッションによって管理されていますので、 +このデバイスに正しいパーミッションを与えるように +注意する必要があります。 +読み込み専用のアクセスでさえ、すべての I/O 特権を +与えてしまうことに注意してください。 +.Sh ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/io +.El +.Sh 関連項目 +.Xr mem 4 +.Sh 歴史 +.Nm io +ファイルは +.Fx 1.0 +で登場しました。 + + + diff --git a/ja_JP.eucJP/man/man4/ip.4 b/ja_JP.eucJP/man/man4/ip.4 new file mode 100644 index 0000000000..023c639f02 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ip.4 @@ -0,0 +1,436 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)ip.4 8.2 (Berkeley) 11/30/93 +.\" %Id: ip.4,v 1.9 1997/03/19 19:47:33 bde Exp % +.\" +.\" jpman %Id: ip.4,v 1.3 2000/07/13 04:28:20 horikawa Stab % +.\" WORD: source routing 指定経路制御 [IPv6] +.Dd November 30, 1993 +.Dt IP 4 +.Os BSD 4.2 +.Sh 名称 +.Nm ip +.Nd インターネットプロトコル +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket AF_INET SOCK_RAW proto +.Sh 説明 +.Tn IP +は、インターネットプロトコルファミリが用いるトランスポート層の +プロトコルです。 +.Tn IP +に基づいた、より高位のプロトコル (例えば、 +.Tn TCP +や +.Tn UDP +) +を用いているときには、 +.Tn IP +レベルでオプションを設定できます。 +また、新しいプロトコルや特別な用途のアプリケーションを +開発しているときには、 +.Dq raw ソケット +を通してアクセスすることもできます。 +.Pp +.Tn IP レベル +の +.Xr setsockopt 2 +ならびに +.Xr getsockopt 2 +オプションがいくつかあります。 +.Dv IP_OPTIONS +は、送信される各パケットの +.Tn IP +ヘッダ中に埋め込まれる +.Tn IP +オプションを提供したり、受信されるパケットの +ヘッダ部のオプションを検査したりするために +使われます。 +.Tn IP +オプションは、インターネットファミリの全てのソケットタイプで +使うことができます。 +送信される +.Tn IP +オプションのフォーマットは、 +.Tn IP +プロトコルの仕様 (RFC-791) で決められています。ただし、1 つ例外が +あります。 +指定経路制御オプション用のアドレスリストには、ゲートウェイ +リストの先頭に、最初にパケットが通過するゲートウェイが含まれて +いることが必要です。 +最初にパケットが通過するゲートウェイのアドレスはオプションリストから +取り出され、使用される前に適切な大きさに直されます。 +以前に指定されたオプションを無効にするには、長さ 0 のバッファを使用して +ください。 +.Bd -literal +setsockopt(s, IPPROTO_IP, IP_OPTIONS, NULL, 0); +.Ed +.Pp +.Dv IP_TOS +および +.Dv IP_TTL +は、 +.Dv SOCK_STREAM +および +.Dv SOCK_DGRAM +で用いられる +.Tn IP +ヘッダ内の、 +サービスタイプ (type-of-service) フィールドと生存時間 (time-to-live) +フィールドを設定するために使用されます。 +例えば、以下のようにします。 +.Bd -literal +int tos = IPTOS_LOWDELAY; /* 参照 */ +setsockopt(s, IPPROTO_IP, IP_TOS, &tos, sizeof(tos)); +int ttl = 60; /* 最大値は 255 */ +setsockopt(s, IPPROTO_IP, IP_TTL, &ttl, sizeof(ttl)); +.Ed +.Pp +もし、 +.Dv IP_RECVDSTADDR +オプションが +.Dv SOCK_DGRAM +ソケットで有効になっていた場合、 +.Xr recvmsg 2 +システムコールは、 +.Tn UDP +ダイアグラム用の送り先の +.Tn IP +アドレスを返します。 +msghdr 構造体の msg_control フィールドは +.Tn IP +アドレスの後に続いた cmsghdr 構造体の入ったバッファへの +ポインタになっています。 +cmsghdr フィールドは以下のような値を持ちます。 +.Bd -literal +cmsg_len = sizeof(struct in_addr) +cmsg_level = IPPROTO_IP +cmsg_type = IP_RECVDSTADDR +.Ed +.Pp +.Dv IP_PORTRANGE +は、ポート番号の範囲を設定するために使されます。 +この範囲のローカルポート番号のうちのひとつが、 +ポート番号を指定しなかった (0 が指定された) ソケット用に選択されます。 +これは、以下のような値を取り得ます。 +.Bl -tag -width IP_PORTRANGE_DEFAULT +.It Dv IP_PORTRANGE_DEFAULT +デフォルトの範囲のポート番号値を使います。通常は +.Dv IPPORT_RESERVED +から +.Dv IPPORT_USERRESERVED +です。 +この値は、sysctl の設定、 +.Sy net.inet.ip.portrange.first +および +.Sy net.inet.ip.portrange.last +を通して調整できます。 +.It Dv IP_PORTRANGE_HIGH +は、大きな値の範囲のポート番号を使います。通常は +.Dv IPPORT_HIFIRSTAUTO +および +.Dv IPPORT_HILASTAUTO +です。 +この値は、sysctlの設定、 +.Sy net.inet.ip.portrange.hifirst +および +.Sy net.inet.ip.portrange.hilast +を通して調整できます。 +.It Dv IP_PORTRANGE_LOW +は、小さな値の範囲のポート番号を使います。通常は、 +.Ux +システム上で特権を持ったプロセスに使用が限定されています。 +この値の範囲は、通常 +.Dv IPPORT_RESERVED +から +.Li 1 +までで、降順に並んでいます。この値の範囲は sysctl では設定できません。 +.El +.Ss マルチキャストオプション +.Pp +.Tn IP +のマルチキャストは +.Dv SOCK_DGRAM +および +.Dv SOCK_RAW +型の +.Dv AF_INET +ソケットで、インタフェースドライバがマルチキャスト +に対応しているネットワークのみで行えます。 +.Pp +.Dv IP_MULTICAST_TTL +オプションは、送信されるマルチキャストデータグラムの +生存時間 (TTL) 値を変更します。この値を変更することで +マルチキャストの範囲を制御できます。 +.Bd -literal +u_char ttl; /* 0 から 255 の範囲。 デフォルト値は 1 */ +setsockopt(s, IPPROTO_IP, IP_MULTICAST_TTL, &ttl, sizeof(ttl)); +.Ed +.Pp +TTL 値が 1 のデータグラムは、ローカルネットワークを超えて +転送されることはありません。 +TTL 値が 0 のデータグラムはどのネットワークにも送信されませんが、 +データグラムを送ったホストが送り先のグループに属しており、 +送信を行うソケットがマルチキャストループパックを無効にしていなければ +(下記参照)、ローカルネットワークには送信されるかもしれません。 +TTL 値が 1 より大きいデータグラムは、ローカルネットワークに +マルチキャストルータが接続されていれば、他のネットワークに転送されます。 +.Pp +複数のインタフェースを持ったホストには、各マルチキャスト +送信は、最初のネットワークインタフェースから行われます。 +.Dv IP_MULTICAST_IF +オプションを使うと、指定されたソケットからの次の送信のために +デフォルト値を書きかえることができます。 +.Bd -literal +struct in_addr addr; +setsockopt(s, IPPROTO_IP, IP_MULTICAST_IF, &addr, sizeof(addr)); +.Ed +.Pp +ここで、"addr" は、ローカルホストの使用したいインタフェースの +.Tn IP +アドレスです。または、 +.Dv INADDR_ANY +を指定して、デフォルトのインタフェースを示すようにもできます。 +インタフェースのローカル IP アドレスおよびマルチキャスト能力の +有無は、 +.Dv SIOCGIFCONF +および +.Dv SIOCGIFFLAGS +ioctl システムコールで得ることができます。 +普通のアプリケーションではこのオプションを使う必要は +ないはずです。 +.Pp +もし、マルチキャストデータグラムが送り元のホスト自身が +属しているグループ (送り先のインタフェース上にある) +に送信されるのであれば、デフォルトではローカルへの配送用に、 +そのダイアグラムのコピーが IP 層によってループバック +されます。 +.Dv IP_MULTICAST_LOOP +オプションは、送信ホストに今後のデータグラムをループバック +するのかどうかを制御する権限を明示的に与えます。 +.Bd -literal +u_char loop; /* 0 = 無効, 1 = 有効 (デフォルト) */ +setsockopt(s, IPPROTO_IP, IP_MULTICAST_LOOP, &loop, sizeof(loop)); +.Ed +.Pp +このオプションは、自身が送信したパケットを受け取る際のオーバヘッドを +軽減することで、1 つのホストに 1 つしか実体を持たないアプリケーション +(例えば、ルータデーモン) のパフォーマンスを向上させます。 +このオプションは、1 つのホスト上で複数の実体を持ち得るアプリケーション +(例えば、会議プログラム) や、 +送信元のホストが送信先のグループに属さないアプリケーション (例えば、 +時刻問い合わせプログラム) では使われません。 +.Pp +TTL の初期値を 1 より大きくして送信されたマルチキャストデータグラムは、 +送信元のインタフェースとは別のインタフェース上のホストから送信元 +のホストに配送されるかもしれません。 +ただし、送信元ではない方のインタフェース上で、 +このホストが宛先のグループに属している場合です。 +ループバックコントロールオプションは、このような配送に対しては +何の効力も持ちません。 +.Pp +あるマルチキャストグループから送信されたデータグラムを受け取るには、 +ホストがそのマルチキャストグループに属していることが必要です。 +あるマルチキャストグループに加わるには、 +.Dv IP_ADD_MEMBERSHIP +オプションを使用します。 +.Bd -literal +struct ip_mreq mreq; +setsockopt(s, IPPROTO_IP, IP_ADD_MEMBERSHIP, &mreq, sizeof(mreq)); +.Ed +.Pp +ここでは、 +.Fa mreq +は以下のような構造体です。 +.Bd -literal +struct ip_mreq { + struct in_addr imr_multiaddr; /* グループの IP マルチキャストアドレス */ + struct in_addr imr_interface; /* インタフェースのローカル IP アドレス */ +} +.Ed +.Pp +デフォルトのマルチキャストインタフェースを選択するには、 +.Dv imr_interface +は +.Dv INADDR_ANY +にします。 +また、ホストがマルチホームに設定されていれば、 +特定のマルチキャスト可能なインタフェースの +.Tn IP +アドレスに指定することが必要です。 +メンバシップは、1 つのインタフェースに結びついています。 +そのため、マルチホームホスト上で動作しているプログラムは、 +1 つ以上のインタフェース上で同一のグループに入る必要がある +かもしれません。 +1 つのソケットに最大 +.Dv IP_MAX_MEMBERSHIPS +(現在では 20) 個のメンバシップを設定できます。 +.Pp +メンバから抜けるには、以下の関数を使います。 +.Bd -literal +struct ip_mreq mreq; +setsockopt(s, IPPROTO_IP, IP_DROP_MEMBERSHIP, &mreq, sizeof(mreq)); +.Ed +.Pp +ここで、 +.Fa mreq +はメンバに加わるときに使ったのと同じ値が入ります。ソケットを閉じたり +プロセスが終了したりした場合はメンバから抜けます。 +.\"----------------------- +.Ss "raw IP ソケット" +.Pp +raw +.Tn IP +ソケットは、コネクションを持たないソケットで、 +通常は +.Xr sendto 2 +や +.Xr recvfrom 2 +コールと一緒に使われます。 +ただし、 +.Xr connect 2 +コールは、 +これから流れてくるパケットの送り先を定めるためにも使われます。 +(この場合には、 +.Xr read 2 +もしくは +.Xr recv 2 +、および +.Xr write 2 +もしくは +.Xr send 2 +システムコールが使われるでしょう。) +.Pp +.Fa proto +が 0 の場合には、パケットの送信にはデフォルトの +プロトコルである +.Dv IPPROTO_RAW +が使われ、このプロトコルに向かって送られてきたパケットだけが +受信されます。 +.Fa proto +が 0 でない場合、そのプロトコルの番号が送信パケット上で使われ、 +また、入力パケットをフィルタリングするために使われます。 +.Pp +送信パケットには、自動的に +.Tn IP +ヘッダ (これは、送り先アドレスおよびソケットが +作成されたときのプロトコル番号にもどづいています) +が与えられます。ただし、 +.Dv IP_HDRINCL +オプションが設定されているときは +.Tn IP +ヘッダは与えられません。 +受信パケットは、完全な形の +.Tn IP +ヘッダおよびオプションと一緒に受け取られます。 +.Pp +.Dv IP_HDRINCL +は、データと一緒に完全な IP ヘッダが含まれていることを +示し、 +.Dv SOCK_RAW +型でしか使われません。 +.Bd -literal +#include +#include + +int hincl = 1; /* 1: オン , 0: オフ */ +setsockopt(s, IPPROTO_IP, IP_HDRINCL, &hincl, sizeof(hincl)); +.Ed +.Pp +以前の +.Tn BSD +リリースとは違って、このプログラムでは、すべての IP ヘッダ +のフィールドを設定することが必要です。これには次のフィールド +も含みます。 +.Bd -literal +ip->ip_v = IPVERSION; +ip->ip_hl = hlen >> 2; +ip->ip_id = 0; /* 0 ということは、カーネルが適切な値を + 設定してくれるということです。 */ +ip->ip_off = offset; +.Ed +.Pp +ヘッダの送り元のアドレスが +.Dv INADDR_ANY +に設定されていたら、 +カーネルが適切なアドレスを選択します。 +.Sh 診断 +ソケット操作が次のようなエラーのいずれかを返して失敗することが +あります。 +.Bl -tag -width [EADDRNOTAVAIL] +.It Bq Er EISCONN +すでに接続が確立されたソケットに接続を試みようとしたときや、 +送り先アドレスを指定してデータグラムを送信しようとしたときに +送り先のソケットがすでに接続されているときに生じます。 +.It Bq Er ENOTCONN +データグラムを送信しようとしたときに、送り先アドレスが +指定されておらず、ソケットがまだ接続されていないときに生じます。 +.It Bq Er ENOBUFS +内部のデータ構造でシステムがメモリを使い果たしたときに +生じます。 +.It Bq Er EADDRNOTAVAIL +ネットワークアドレスを用いてソケットを作成しようとしたが、 +そのためのネットワークインタフェースが存在しないときに +生じます。 +.It Bq Er EACESS +特権のないプロセスによって raw IP ソケットを作成しようと +したときに生じます。 +.El +.Pp +次のような、 +.Tn IP +に特有のエラーが +.Tn IP +のオプションを設定したり取得したりする際に生じることがあります。 +.Bl -tag -width EADDRNOTAVAILxx +.It Bq Er EINVAL +ソケットのオプション名に不明なものが与えられました。 +.It Bq Er EINVAL +IP のオプションフィールドが適切な形になっていませんでした。 +すなわち、オプションフィールドが最小値より短かったり、 +与えられたオプションバッファよりも長かったりしたということです。 +.El +.Sh 関連項目 +.Xr getsockopt 2 , +.Xr recv 2 , +.Xr send 2 , +.Xr icmp 4 , +.Xr inet 4 , +.Xr intro 4 +.Sh 歴史 +.Nm +プロトコルは、 +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/ipfirewall.4 b/ja_JP.eucJP/man/man4/ipfirewall.4 new file mode 100644 index 0000000000..ddb9178fe3 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ipfirewall.4 @@ -0,0 +1,205 @@ +.\" +.\" %Id: ipfirewall.4,v 1.12 1997/09/29 10:10:15 wosch Exp % +.\" jpman %Id: ipfirewall.4,v 1.3 2000/07/13 04:28:14 horikawa Stab % +.\" +.Dd June 22, 1997 +.Dt IPFIREWALL 4 +.Os +.Sh 名称 +.Nm ipfirewall +.Nd IP パケットフィルタおよびトラフィック測定 +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn setsockopt raw_socket IPPROTO_IP "ipfw option" "struct ipfw" size +.Sh 解説 +ipfirewall (別名 ipfw) は、システムのインタフェースを通過する IP パケットに +対してフィルタリングやリダイレクトなどの処理を行うシステムの機能です。 +パケットは適合するものが見つかるまでパターンルールの順リストと照らし合わされ +ます。適合するルールが見つかった時点でそれに対応する動作を実行します。 +ルールは 1 から 65534 までの番号を振られ、 +複数のルールが同じ番号を共有することも可能です。 +.Pp +唯一必ず存在するルールとしてルール番号 65535 があります。 +このルールは通常はすべてのパケットを破棄します。 +したがって、これより小さな番号のルールに適合しなかったパケットはすべて +破棄されます。 +しかし、カーネルをコンパイルする時のオプション +.Dq IPFIREWALL_DEFAULT_TO_ACCEPT +を指定すると、管理者はすべて (のパケットの通過を) 許可するように +この固定ルールを変更することができます。 +.Pp +.Fn setsockopt +へ渡される値は、ルールを記述している ip_fw 構造体 (下記参照) です。 +(IP_FW_DEL のような) いくつかのケースではルール番号のみが重要になります。 +.Sh コマンド +ルールリストを扱うために次のソケットオプションを使います: +.Pp +IP_FW_ADD は、ルールリストにルールを挿入します。 +.Pp +IP_FW_DEL は、適合するルール番号を持つルールをすべて削除します。 +.Pp +IP_FW_GET は、適合するルール番号の (最初の) ルールを返します。 +.Pp +IP_FW_ZERO は、 +適合するルール番号を持つすべてのルールに関する統計を 0 にします。 +ルール番号が 0 の場合にはすべてのルールを 0 にします。 +.Pp +IP_FW_FLUSH (65535 を除く) すべてのルールを消去します。 +.Pp +カーネルのセキュリティレベルが 2 より大きい場合は +IP_FW_GET のみが許可されます。 +.Sh ルール構造体 +ルールは次の構造体で記述されています: +.Bd -literal +/* 1 個のインタフェースを指定 */ +union ip_fw_if { + struct in_addr fu_via_ip; /* IP アドレスで指定 */ + struct { /* インタフェース名で指定 */ +#define FW_IFNLEN 6 /* 構造体を 2^x 境界に置く */ + char name[FW_IFNLEN]; + short unit; /* -1 は任意のユニットに適合 */ + } fu_via_if; +}; + +/* 1 個の ipfw ルール */ +struct ip_fw { + u_long fw_pcnt,fw_bcnt; /* パケットとバイト数のカウンタ */ + struct in_addr fw_src, fw_dst; /* 始点と終点の IP アドレス */ + struct in_addr fw_smsk, fw_dmsk;/* 始点と終点の IP アドレスのマスク */ + u_short fw_number; /* ルール番号 */ + u_short fw_flg; /* フラグ語 */ +#define IP_FW_MAX_PORTS 10 /* 程良い最大値 */ + u_short fw_pts[IP_FW_MAX_PORTS];/* 適合するポート番号の配列 */ + u_char fw_ipopt,fw_ipnopt; /* IP オプションのセット/アンセット */ + u_char fw_tcpf,fw_tcpnf; /* TCP フラグのセット/アンセット */ +#define IP_FW_ICMPTYPES_DIM (256 / (sizeof(unsigned) * 8)) + unsigned fw_icmptypes[IP_FW_ICMPTYPES_DIM]; /* ICMP タイプのビットマップ */ + long timestamp; /* 最終適合のタイムスタンプ (tv_sec) */ + union ip_fw_if fw_in_if, fw_out_if;/* 入力/出力のインタフェース */ + union { + u_short fu_divert_port; /* Divert/tee ポート */ + u_short fu_skipto_rule; /* SKIPTO コマンドルール番号 */ + u_short fu_reject_code; /* REJECT 応答コード */ + } fw_un; + u_char fw_prot; /* IP プロトコル */ + u_char fw_nports; /* ポート配列中の、始点ポート数と */ + /* 終点ポート数 (終点ポートが始点 */ + /* ポートに後続。最大で計 10 ポート */ + /* 0 は全ポートマッチの意味) */ +}; + +/* 始点/終点のポート数を "fw_nports" にエンコード */ + +#define IP_FW_GETNSRCP(rule) ((rule)->fw_nports & 0x0f) +#define IP_FW_SETNSRCP(rule, n) do { \\ + (rule)->fw_nports &= ~0x0f; \\ + (rule)->fw_nports |= (n); \\ + } while (0) +#define IP_FW_GETNDSTP(rule) ((rule)->fw_nports >> 4) +#define IP_FW_SETNDSTP(rule, n) do { \\ + (rule)->fw_nports &= ~0xf0; \\ + (rule)->fw_nports |= (n) << 4;\\ + } while (0) + +/* flags" フィールド用フラグ値 */ + +#define IP_FW_F_IN 0x0001 /* 入力パケットをチェック */ +#define IP_FW_F_OUT 0x0002 /* 出力パケットをチェック */ +#define IP_FW_F_IIFACE 0x0004 /* 入力インタフェーステストを適用 */ +#define IP_FW_F_OIFACE 0x0008 /* 出力インタフェーステストを適用 */ + +#define IP_FW_F_COMMAND 0x0070 /* 連鎖型エントリ用のマスク */ +#define IP_FW_F_DENY 0x0000 /* これは拒否ルール */ +#define IP_FW_F_REJECT 0x0010 /* 拒否して応答パケットを送信 */ +#define IP_FW_F_ACCEPT 0x0020 /* これは受理ルール */ +#define IP_FW_F_COUNT 0x0030 /* これは計数ルール */ +#define IP_FW_F_DIVERT 0x0040 /* これは divert ルール */ +#define IP_FW_F_TEE 0x0050 /* これは分岐ルール */ +#define IP_FW_F_SKIPTO 0x0060 /* これはスキップルール */ + +#define IP_FW_F_PRN 0x0080 /* このルールが適合した場合に表示 */ + +#define IP_FW_F_SRNG 0x0100 /* 最初の 2 つの始点ポートは、最小と * + * 最大の範囲 (ホストのバイト順で格納) */ + +#define IP_FW_F_DRNG 0x0200 /* 最初の 2 つの終点ポートは、最小と * + * 最大の範囲 (ホストのバイト順で格納) */ + +#define IP_FW_F_IIFNAME 0x0400 /* 入力インタフェースは名前/ユニット * + * (IP ではない) */ +#define IP_FW_F_OIFNAME 0x0800 /* 出力インタフェースは名前/ユニット * + * (IP ではない) */ + +#define IP_FW_F_INVSRC 0x1000 /* 始点チェックの意味を反転 */ +#define IP_FW_F_INVDST 0x2000 /* 終点チェックの意味を反転 */ + +#define IP_FW_F_FRAG 0x4000 /* 断片 */ + +#define IP_FW_F_ICMPBIT 0x8000 /* ICMP タイプビットマップは有効 */ + +#define IP_FW_F_MASK 0xFFFF /* ありうるすべてのフラグビットのマスク */ +.Ed + +.Sh ルールの動作 +各ルールは、フラグ語中の IP_FW_F_COMMAND ビットで示される、次の動作を持ちます。 + + IP_FW_F_DENY - パケットを破棄します + IP_FW_F_REJECT - パケットを破棄し、ICMP または TCP を経由して拒否を通知します + IP_FW_F_ACCEPT - パケットを受け入れます + IP_FW_F_COUNT - カウンタを増加させ、マッチングを続けます + IP_FW_F_DIVERT - パケットを divert(4) ソケットにそらします + IP_FW_F_TEE - パケットを divert(4) ソケットにコピーし、継続します + IP_FW_F_SKIPTO - ルール番号 fu_skipto_rule へスキップします +.Pp +IP_FW_F_REJECT の場合、fu_reject_code の番号が 0 から 255 ならば +対応するコードとともに受信したパケットの始点の IP アドレスへ +ICMP unreachable パケットを送り返します。 +そうではない場合には、値は 256 でプロトコルが IPPROTO_TCP である必要があり、 +この場合 TCP reset パケットが送られます。 +.Pp +IP_FW_F_SKIPTO を使用すると、fu_skipto_rule より小さいルール番号を持つ +すべての連続するルールがスキップされます。 +.Sh カーネルオプション +カーネル設定ファイルでのオプション: + IPFIREWALL - ipfirewall を有効にします + IPFIREWALL_VERBOSE - firewall の出力を有効にします + IPFIREWALL_VERBOSE_LIMIT - firewall の出力を抑制します + DIVERT - divert(4) ソケットを有効にします +.Pp +パケットが IP_FW_F_PRN ビットがセットされているルールに適合し、 +IPFIREWALL_VERBOSE が有効にされている場合にはメッセージがコンソールに +出力されます。 +IPFIREWALL_VERBOSE_LIMIT はそれぞれのルールがログメッセージを出力できる +回数の最大値を制限します。 +これらの変数も +.Xr sysctl 3 +インタフェースを経由して利用できます。 +.Sh 診断 + +[EINVAL] IP オプションの欄が最小値より短いか、提供されたオプション + バッファより長く不適切な形式でした。ip_fw 構造体で構造的 + なエラーが発生しました (n_src_p+n_dst_p 過大、ALL/ICMP + プロトコルのためのポートセットなど)。不正なルール番号が + 使われました。 +.Sh 関連項目 +.Xr setsockopt 2 , +.Xr divert 4 , +.Xr ip 4 , +.Xr ipfw 8 , +.Xr sysctl 8 +.Sh バグ +``tee'' ルールはまだ実装されていません (現在は効果がありません)。 +.Pp +この man ページはまだ作業が必要です。 +.Sh 歴史 +ipfw 機能は最初に BSDI へのパッケージとして +Daniel Boulet +によって書かれました。 +Ugen J.S.Antsilevich +が大幅に変更し、FreeBSD へ移植しました。 +.Pp +Archie Cobbs によっていくつかの拡張が加えられました。 diff --git a/ja_JP.eucJP/man/man4/ipnat.4 b/ja_JP.eucJP/man/man4/ipnat.4 new file mode 100644 index 0000000000..afcffc5efa --- /dev/null +++ b/ja_JP.eucJP/man/man4/ipnat.4 @@ -0,0 +1,106 @@ +.TH IPNAT 4 +.\" jpman %Id: ipnat.4,v 1.3 2000/07/13 04:28:23 horikawa Stab % +.SH 名称 +ipnat \- ネットワークアドレス変換 (NAT) のカーネルインタフェース +.SH 書式 +#include +.br +#include +.br +#include +.br +#include +.SH IOCTL +.PP +NAT リストにルールを追加および削除するために、 +2 つの `基本的' な ioctl が提供されています。 +ioctl は下記のように呼ばれます: +.LP +.nf + ioctl(fd, SIOCADNAT, struct ipnat *) + ioctl(fd, SIOCRMNAT, struct ipnat *) +.fi +.PP +\fBipf(4)\fP とは異なり、カーネルの NAT インタフェースによって +サポートされているリストは 1 つだけです。 +動作中のリストと交換可能な非動作中のリストの機能は、 +現在はサポートされていません。 + +上記の ioctl は、ルーティング ioctl として振舞うように +実装されているので、各種のルーティング ioctl に用いるものと +同じルールやファイル記述子が使用されます。 +たいていの場合 fd は、そのモジュールに関連する +デバイス (例えば /dev/ipl) のファイル記述子であることが必要です。 +.LP +.PP +NAT インタフェースで用いられる構造体は以下の通りです: +.LP +.nf +typedef struct ipnat { + struct ipnat *in_next; + void *in_ifp; + u_short in_flags; + u_short in_pnext; + u_short in_port[2]; + struct in_addr in_in[2]; + struct in_addr in_out[2]; + struct in_addr in_nextip; + int in_space; + int in_redir; /* 0 マップされている、1 リダイレクトは困難 */ + char in_ifname[IFNAMSIZ]; +} ipnat_t; + +#define in_pmin in_port[0] /* 静的なリダイレクトポートも保持 */ +#define in_pmax in_port[1] +#define in_nip in_nextip.s_addr +#define in_inip in_in[0].s_addr +#define in_inmsk in_in[1].s_addr +#define in_outip in_out[0].s_addr +#define in_outmsk in_out[1].s_addr + +.fi +.PP +in_redir で認識される値: +.LP +.nf +#define NAT_MAP 0 +#define NAT_REDIRECT 1 +.fi +.PP +.LP +\fBNAT 統計\fP +.PP +マップされたパケットの数や送受信されたパケットの数 +に関する統計が採取されます。 +また、NAT テーブルに新規のエントリが追加されたり、 +(期限切れのために) エントリが削除された回数や現在の NAT テーブルの +使用量に関する統計が採取されます。 +.PP +カーネル内部にある NAT テーブルへのポインタと、 +\fBSIOCADNAT\fP ioctl で組み立てられた内部の NAT リストの +先頭へのポインタが得られます。 +.PP +このテーブル自身は、NAT_SIZE (デフォルトでは 367) の大きさの +ハッシュテーブルです。 +.PP +統計を取得するには、\fBSIOCGNATS\fP ioctl を用いて、 +適切な構造体を以下のように参照で渡す必要があります: +.PP +.nf + ioctl(fd, SIOCGNATS, struct natstat *) + +typedef struct natstat { + u_long ns_mapped[2]; + u_long ns_added; + u_long ns_expire; + u_long ns_inuse; + nat_t ***ns_table; + ipnat_t *ns_list; +} natstat_t; +.fi +.SH バグ +フィルタルールの追加や削除がもっと柔軟にできれば良いでしょう。 +.SH 関連ファイル +/dev/ipnat +.SH 関連項目 +ipf(4), ipnat(5), ipf(8), ipnat(8), ipfstat(8) diff --git a/ja_JP.eucJP/man/man4/joy.4 b/ja_JP.eucJP/man/man4/joy.4 new file mode 100644 index 0000000000..32ef4a8e9f --- /dev/null +++ b/ja_JP.eucJP/man/man4/joy.4 @@ -0,0 +1,92 @@ +.\" +.\" %Id: joy.4,v 1.9 1998/03/12 07:30:33 charnier Exp % +.\" jpman %Id: joy.4,v 1.3 1999/08/15 14:21:09 horikawa Stab % +.\" +.\" WORD: potentiometer 分圧器 +.\" +.Dd January 23, 1995 +.Dt JOY 4 i386 +.Sh 名称 +.Nm joy +.Nd ジョイスティックのデバイスドライバ +.Sh 書式 +.Cd device joy0 at isa? port "IO_GAME" +.Fd #include +.Sh 解説 +ジョイスティックデバイスドライバは、アプリケーションが PC ジョイスティック +の状態を読み出せるようにします。 +.Pp +ある時点でこのデバイスをオープンできるプロセスは 1 つだけです。 +.Pp +ジョイスティックの状態は、read() システムコールによって、 +joystick 構造体に入れられます。 +この構造体はヘッダファイルで次のように定義されています。 +.Pp +.Bd -literal -offset indent + struct joystick { + int x; /* x 位置 */ + int y; /* y 位置 */ + int b1; /* ボタン 1 の状態 */ + int b2; /* ボタン 2 の状態 */ + }; +.Ed +.Pp +位置は一般に 0-2000 の値をとります。 +.Ss perl の 1 行実行例: +perl -e 'open(JOY,"/dev/joy0")||die;while(1) +.br +{sysread(JOY,$x,16);@j=unpack("iiii",$x);print "@j\\n";sleep(1);}' +.Ss ioctl 呼び出し +いくつかの ioctl() 呼び出しも利用できます。 +これらは int * 型の引数を 1 つ取ります。 +.Bl -tag -width JOY_SET_X_OFFSET +.It Dv JOY_SETTIMEOUT Fa int *limit +ジョイスティックの状態を読み出す際の時間制限 (マイクロ秒単位) を設定します。 +あまり小さな値を設定すると正しい位置の値を得ることができなくなります +(その場合は -2147483648 になります) が、 +それでもボタンの状態だけに注目している場合には役に立つかもしれません。 +.It Dv JOY_GETTIMEOUT Fa int *limit +ジョイスティックの状態を読み出す際の時間制限 (マイクロ秒単位) を得ます。 +.It Dv JOY_SET_X_OFFSET Fa int *offset +ジョイスティックの状態を読み出す際に X 位置に加算する値を設定します。 +.It Dv JOY_SET_Y_OFFSET Fa int *offset +ジョイスティックの状態を読み出す際に Y 位置に加算する値を設定します。 +.It Dv JOY_GET_X_OFFSET Fa int *offset +ジョイスティックの状態を読み出す際に X 位置に加算する値を得ます。 +.It Dv JOY_GET_Y_OFFSET Fa int *offset +ジョイスティックの状態を読み出す際に Y 位置に加算する値を得ます。 + +.Sh 技術的仕様 + +DB-15 コネクタのピン配置は次の通りです: +.Pp + 1 XY1 (+5v) + 2 スイッチ 1 + 3 X1 (分圧器 #1) + 4 スイッチ 1 (GND) + 5 スイッチ 2 (GND) + 6 Y1 (分圧器 #2) + 7 スイッチ 2 + 8 N.C. + 9 XY2 (+5v) + 10 スイッチ 4 + 11 X2 (分圧器 #3) + 12 スイッチ 3&4 (GND) + 13 Y2 (分圧器 #4) + 14 スイッチ 3 + 15 N.C. +.Pp +分圧器は通常 0-150k (まれに 0-100k) の可変抵抗で、 +IBM の技術文書によれば、時間は次の式で表されます: +Time = 24.2e-6s + 0.011e-6s * R/Ohms + +.Sh 関連ファイル +.Bl -tag -width /dev/joy? +.It Pa /dev/joy? +ジョイスティックのデバイスファイル +.Sh 作者 +.An Jean-Marc Zucconi Aq jmz@cabri.obs-besancon.fr +.Sh 歴史 +joystick ドライバは +.Fx 2.0.5 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/keyboard.4 b/ja_JP.eucJP/man/man4/keyboard.4 new file mode 100644 index 0000000000..a5b8ce3ef2 --- /dev/null +++ b/ja_JP.eucJP/man/man4/keyboard.4 @@ -0,0 +1,164 @@ +.\" +.\" %Id: keyboard.4,v 1.16 1998/06/29 07:04:08 hoek Exp % +.\" jpman %Id: keyboard.4,v 1.3 2000/08/03 06:58:14 horikawa Stab % +.\" WORD: function key ファンクションキー +.\" WORD: history 履歴 [keyboard.4] (スクロールされた表示内容を戻す機能) +.\" WORD: modifier key 修飾キー +.\" WORD: normal key 通常キー +.\" WORD: numerical keypad 数字キーパッド +.\" WORD: scancode スキャンコード [keyboard.4] +.\" WORD: substructure サブ構造体 (構造体中の構造体メンバ) +.\" " +.Dd January 8, 1995 +.Dt KEYBOARD 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm keyboard +.Nd PC キーボードのインタフェース +.Sh 解説 + +PC キーボードはコンソールの文字入力デバイスとして使用されます。 +キーボードは現在の仮想コンソールが専有します。 +仮想コンソールを切り替えるには、シーケンス +.Ar ALT+Fn +を使ってください。これは、ALT を押しながらファンクションキーの +ひとつを押すという意味です。そうすると、そのファンクションキーの +番号と同じ仮想コンソールが現在の仮想コンソールとして選択され、 +キーボードやディスプレイの専有的な使用権が与えられます。 + +コンソールでは、特別なキーシーケンスを用いることにより、キーボード上に物理的に +存在しない値を入力できます。この機能を使うには、ALT を押したままにして、 +数字キーパッドで 0 から 255 の 10 進数字を入力し、ALT を離してください。 +そうすると、入力された値がひとつの文字を表す ASCII 値として使われます。 +このようにして、キーボード上に無い任意の ASCII 値を入力することができます。 +また、コンソールドライバは履歴機能も備えています。 +履歴機能は scroll-lock キーを押すことで有効になります。 +これは表示を固定し、最近スクロールされた行に渡って矢印キーで +スクロールアップ・ダウンできるようにします。 + +キーボードは、個々のユーザや国の違いによる配置に合わせて設定できます。 + +キーボード上のキーは次の機能のどれでも持つことができます: + + 通常キー - そのキーに関連付けられた ASCII 値を入力。 + + ファンクションキー - ASCII 数値列を入力。 + + スイッチキー - 仮想コンソールを切り替える。 + + 修飾キー - 別のキーの意味を変更する。 + + +キーボードとは、1 から n の番号を付けられたキーの集合と見なせます。 +この番号はよく、あるキーに対する「スキャンコード (scancode)」と呼ばれます。 +あるキーが押されたとき、そのキーの番号はビット 7 が 0 の 8 ビット文字に +変換され、離されたときはビット 7 が 1 の数値に変換されます。 +これにより、キーのマッピングが完全に設定可能となります。 + +それぞれのキーの持つ意味は PIO_KEYMAP ioctl の呼び出しによって +プログラムできます。これは keymap_t 構造体を引数に取ります。 +この構造体の構成は次のようになります: +.Pp +.Bd -literal -offset indent + struct keymap { + u_short n_keys; + struct key_t { + u_char map[NUM_STATES]; + u_char spcl; + u_char flgs; + } key[NUM_KEYS]; + }; +.Ed +.Pp +フィールド n_keys はいくつのキー定義 (スキャンコード) が続くかをシステムに +示します。各スキャンコードはサブ構造体の key_t で指定されます。 + +各スキャンコードは、shift, control, alt の状態により +8 つの異なる値に変換され得ます。 +これら 8 通りの状態は次のような配列 map で表現されます: + + alt + scan cntrl alt alt cntrl + code base shift cntrl shift alt shift cntrl shift + map[n] 0 1 2 3 4 5 6 7 + ---- ------------------------------------------------------ + 0x1E 'a' 'A' 0x01 0x01 'a' 'A' 0x01 0x01 + +これは、通常 0x1E のスキャンコードを持つ「A」と記されたキーの +デフォルトのマッピングです。8 通りの状態が示されているように、 +「A」キーの通常の動作を与えます。 +フィールド spcl は、キーに「特殊な (special)」扱いを与えるために使われ、 +次のように解釈されます。 +各ビットは上記の状態のひとつに対応します。 +そのビットが 0 なら、そのキーは map[] の対応するエントリに示された数値を +送出します。ビットが 1 なら、そのキーは「特殊」です。 +すなわち、そのキーは何も送出しません。 +代わりに、「状態 (state)」の変更を施します。 +つまり、そのキーは shift, control, alt, lock, switch-screen, +ファンクションキー, あるいは no-op キーであるということです。 +map のビットは逆向きになります。 +つまり、ビット 7 が base に、ビット 6 が shift に、などと対応します。 + +フィールド flgs は、そのキーが caps-lock (1)、num-lock (2)、または +その両方 (3) に反応すべきか、あるいは両方とも無視 (0) するべきかを決めます。 + +.Xr kbdcontrol 1 +ユーティリティは、こういった記述をカーネルに/カーネルから +実行時にロードするために使われます。これにより実行時にキー割り当てを +変更することができます。あるいは、より重要なことですが、 +キーの正確な意味を (GIO_KEYMAP ioctl で) カーネルから取得します +(例えば、X サーバが利用します)。 + +ファンクションキーは SETFKEY ioctl 呼び出しを用いてプログラムできます。 + +この ioctl は fkeyarg_t 型の引数を取ります: +.Bd -literal -offset indent + struct fkeyarg { + u_short keynum; + char keydef[MAXFK]; + char flen; + }; +.Ed +.Pp +フィールド keynum はどのファンクションキーをプログラムするかを決めます。 +配列 keydef は使用する新しい文字列 (長さは MAXFK まで) を含み、 +その長さを flen に入れなければなりません。 + +GETFKEY ioctl 呼び出しは似たように働きますが、 +これは keynum の現在の設定を返します。 + +ファンクションキーは次のように番号付けされます: +.Bd -literal -offset indent + F1-F12 key 1 - 12 + Shift F1-F12 key 13 - 24 + Ctrl F1-F12 key 25 - 36 + Ctrl+shift F1-F12 key 37 - 48 + + Home key 49 + Up arrow key 50 + Page Up key 51 + (keypad) - key 52 + Left arrow key 53 + (keypad) 5 key 54 + Right arrow key 55 + (keypad) + key 56 + End key 57 + Down arrow key 58 + Page down key 59 + Insert key 60 + Delete key 61 + + Right window key 62 + Left window key 63 + Menu key 64 +.Ed + +.Xr kbdcontrol 1 +ユーティリティで実行時にこれらの値を変更することもできます。 +.Pp +.Sh 作者 +.ie t .An S\(/oren Schmidt Aq sos@FreeBSD.org +.el .An So/ren Schmidt Aq sos@FreeBSD.org +.\" ISO-8859 集合の文字(0xe4)に対処 金ん田 1999.02.23 +.\" .An Soren Schmidt Aq sos@FreeBSD.org +.\" ^0xe4 diff --git a/ja_JP.eucJP/man/man4/labpc.4 b/ja_JP.eucJP/man/man4/labpc.4 new file mode 100644 index 0000000000..b74b54e505 --- /dev/null +++ b/ja_JP.eucJP/man/man4/labpc.4 @@ -0,0 +1,164 @@ +.\" +.\" Copyright (c) 1995 HD Associates, Inc. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: labpc.4,v 1.6 1998/10/22 14:51:19 bde Exp % +.\" jpman %Id: labpc.4,v 1.3 2000/08/10 13:49:55 horikawa Stab % +.\" +.rm ES +.rm EE +.de ES +.Pp +.nf +.in +0.5i +.. +.de EE +.in -0.5i +.fi +.. +.Dd April 26, 1995 +.Dt LABPC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm labpc +.Nd +National Instruments 社の LABPC と LABPC+ のドライバ +.Sh 書式 +.Cd "device labpc0 at isa? port 260 tty irq 5" +.Sh 解説 +このドライバは National Instruments 社の LABPC と LABPC+ の +低コストマルチファンクション I/O ボードをサポートします。 +.Pp +このボードは +8 つの 12 ビット A-D 入力チャネル、 +2 つの 12 ビット D-A 出力チャネル、 +3 つの 8 ビットデジタル I/O ポートを提供します。 +また、デジタル I/O ポートとは別に、 +National Instruments 社の SCXI バスの設定をサポートしていますが、 +そのソフトウェアは現在は、ドライバの一部としてではなく、 +外部プログラムとして提供されています。 +.Pp +入出力デバイス、モード、チャネルの選択は +マイナ番号を通して行ないます。 +.ES +8 ビットのマイナ番号の形式は UUSIDCCC で、以下のようになります。 + UU: ボードユニット + S: SCAN ビット (スキャン可) + I: INTERVAL (インターバルサポート) + D: 1: デジタル I/O, 0: アナログ I/O +CCC: チャネルの選択 : + アナログ: + 入力: チャネルは AD0 から AD 7 に対応して 0 から 7 まで + 出力: チャネルは 0 から 2 まで + 0: D-A 0 + 1: D-A 1 + 2: チャネル 0 と 1 を交互に + + デジタル: + 入力: チャネルは 0 から 2 まで + 出力: チャネルは 0 から 2 まで +.EE +.Pp +"sh MAKEDEV labpcaio" や "sh MAKEDEV labpcdio" を実行すると、 +/dev/MAKEDEV スクリプトは基本的なアナログとデジタルのデバイスを +作成しますが、 +INTERVAL や SCAN デバイスのためのデバイスエントリは作成しません。 +SCAN デバイスは、自動的に全チャネルを 0 に向かって走査します。 +(例えば /dev/ad7 に対する SCAN は +AD7 から AD0 までのチャネルを読みだします) +INTERVAL デバイスは、外部信号を待ち、そして、 +選択されたチャネル番号から 0 までの全チャネルを +可能な限りの速さで読みだします。 +これはハードウェアが実行し、 +(この機能をオンにすることを除いて)ドライバはなにもしません。 +センサが動かない時は \fILabPC+User's Manual\fP や +ソースコードを参照して下さい。 +.Pp +このドライバは複数の一般的なアナログ I/O ioctl 呼出しを +サポートしています。 +これらは sys/dataacq.h で定義されており、 +他のデータ取得 (acquisition) ボードのデバイスドライバで +実装されているものと同じ意味です。 +.Pp +AD_MICRO_PERIOD_SET はサンプリングの間隔を +マイクロ秒で表した long 値へのポインタを引数にとります。 +.Pp +AD_MICRO_PERIOD_GET は long 値へのポインタを引数にとり、 +現在のサンプリング間隔をマイクロ秒で表した整数値を返します。 +.Pp +AD_NGAINS_GET は整数値へのポインタを引数にとり、 +ボードがサポートする差分ゲイン設定値の個数を返します。 +これは LabPC ボードでは 8 です。 +.Pp +AD_NCHANS_GET は整数値へのポインタを引数にとり、 +ボードがサポートするチャネルの数を返します。 +これは LabPC ボードでは 8 です。 +.Pp +AD_SUPPORTED_GAINS は NGAINS (AD_NGAINS_GET で取得した数) の長さの +double 配列を返します。 +これらはボードがサポートするゲインです。 +.Pp +AD_GAINS_SET は NCHAMS (AD_NCHANS_GET で取得した数) の長さの +整数配列を引数にとり、ボードのゲインを設定します。 +これらは、サポートされているゲインの配列に対する、 +各チャネルのゲインを指すインデックスです。 +.Pp +AD_GAINS_GET は NCHANS (AD_NCHANS_GET が返します) の長さの +整数配列を引数にとり、現在のボードのゲインを返します。 +.Sh バグ +一般的には、私が必要とした能力のみが提供されています。 +特に、以下の目立つ制限があります。 +.Pp +アナログ入力は、クロックによる変換モードでのみサポートされています。 +.Pp +サンプリングクロックは 15 Hz までしか下げられません。 +もっと遅くするためには、 +ドライバを修正して TCINTEN をサポートすることにより、 +カウンタの連鎖により低いクロックレートを得ることが必要です。 +.Pp +クロックによる D-A 出力はサポートしていません。 +.Pp +デジタル I/O ポートを提供している 8255 は +モード 0 (3 つの 8 ビットポート) でのみサポートされています。 +.Pp +LABPC ボードとは別に SCXI バスをサポートしています。 +これはドライバの中にはなく、 +デジタル入出力デバイスへアクセスするための +別のユーザプロセスです。 +これについては dufault@hda.com に尋ねて下さい。 +.Pp +MAKEDEV は「基本的な」デバイスのみを作成します。 +INTERVAL や SCAN デバイスは手動で作成しなければなりません。 +.Pp +INTERVAL デバイスはクロックレートを可能な限り高く設定します。 +外部信号の後、できる限り素早く全チャネルをサンプリングするためです。 +これはばかげた制限です。シンプルにクロックの設定を使用するべきです。 +.Sh 警告 +National Instrument 社 +(他の大抵の実験室レベルの品質のボードベンダもそうですが) +の低コストの定義は、インターネット上の多くのものとは劇的に異なります。 diff --git a/ja_JP.eucJP/man/man4/le.4 b/ja_JP.eucJP/man/man4/le.4 new file mode 100644 index 0000000000..5373810c21 --- /dev/null +++ b/ja_JP.eucJP/man/man4/le.4 @@ -0,0 +1,93 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: le.4,v 1.5 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: le.4,v 1.3 2000/07/13 04:29:43 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt LE 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm le +.Nd +DEC EtherWORKS II/III イーサネットデバイスドライバ +.Sh 書式 +.Cd "device le0 at isa? port 0x300 net irq 5 iomem 0xd0000" +.Sh 解説 +.Nm +ドライバは、後期の Digital Equipment EtherWORKS II +(DE200, DE201, DE202, DE422) と DEC EtherWORKS III (DE203, DE204, DE205) NIC +のサポートを提供します。 +.Pp +.Nm +ドライバのための有効な IRQ 設定は 5, 10, 11, 15 です。 +.Pp +.Sh 診断 +.Bl -diag +.It "le%d: not configured -- too many devices" +1 台のマシンに許される +.Nm +デバイスの数には制限があります。 +.It "le%d: lemac configuration error: expected IRQ 0x%x actual 0x%x" +検出された IRQ 値は、カーネル設定ファイルで指定される値と一致しません +でした。カードを変更するか、新しいカーネルを構築しなければなりません。 +.It "le%d: lemac configuration error: expected iomem 0x%x actual 0x%x" +検出された iomem 値は、カーネル設定ファイルで指定される値と一致しませ +んでした。 カードを変更するか、新しいカーネルを構築しなければなりません。 +.It "le%d: reset: EEPROM checksum failed (0x%x)" +EEPROM 内の情報が正確であるということに +.Nm +ドライバは依存します。このエラーが発生するならば、カードを変更してください。 +.It "le%d: fatal RXD error, attempting recovery" +.It "le%d: recovery failed -- board disabled" +受信エラーが発生しました。ドライバは、このエラーから回復しようとします。 +しかし、それが不可能な場合、ドライバはカードをシャットダウンします。 +.It "le%d: lance: warning: excessive collisions: TDR%dns (%d-%dm)" +極めて多くのイーサネットコリジョンが検出されました。ネットワークが非常 +に混雑している場合かもしれません。あるいは、これは EtherWORKS カードに +よる問題を示唆するかもしれません。 +.El +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr config 8 , +.Xr ifconfig 8 +.Rs +.%T "Building 4.3 BSD UNIX System with Config" +.Re +.Sh 歴史 +.Nm +デバイスドライバは、 +.Fx 2.0 +で存在しました。 +.Sh 作者 +.Nm +デバイスドライバは、 +.An Matt Thomas +が書きました。 +このマニュアルページは、 +.An David E. O'Brien +が書きました。 diff --git a/ja_JP.eucJP/man/man4/lkm.4 b/ja_JP.eucJP/man/man4/lkm.4 new file mode 100644 index 0000000000..8679d83f47 --- /dev/null +++ b/ja_JP.eucJP/man/man4/lkm.4 @@ -0,0 +1,174 @@ +.\" Copyright (c) 1993 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: lkm.4,v 1.10 1998/03/12 07:30:17 charnier Exp % +.\" jpman %Id: lkm.4,v 1.3 2000/08/03 06:58:49 horikawa Stab % +.\" +.Dd January 17, 1996 +.Dt LKM 4 +.Os FreeBSD 2.0 +.Sh 名称 +.Nm lkm +.Nd カーネルモジュールを動的にロードする機能 +.Sh 解説 +動的にロードするカーネルモジュールを用いることにより、システム管理者は +実行中のシステムに動的に機能を加えたり取り除いたり出来ます。 +更に、この機能によりソフトウェア開発者は +自らの変更をテストする為に頻繁に再起動をかける事を避けながら +カーネルの新しい構成部品を開発することもできます。 +.Pp +多様なタイプのモジュールをシステムにロードすることが出来ます。 +後述するように、定義されたモジュールのタイプが幾つかあり、 +これらのタイプ毎に予め決められた方法でモジュールはシステムに付加されます。 +その上、一般的なタイプもあって、このタイプについてはモジュールは +それ自体がローディングとアンローディングを処理するものと +します。 +.Pp +.Tn FreeBSD +システムでは動的にロードするカーネルモジュールを広汎に利用していて、 +大部分のファイルシステム、 +.Tn NFS +クライアントとサーバ、全てのスクリーンセーバ、そして +.Tn iBCS2 +や +.Tn Linux +エミュレータなどについて動的にロードするバージョンを +提供しています。 +システムと共に配布されたモジュールは +.Pa /lkm +ディレクトリにあります。 +.Pp +.Nm +インタフェースを利用するには +.Pa /dev/lkm +デバイスに対して +.Xr ioctl 2 +システムコールを +発行します。 +通常、動的にロードするカーネルモジュールに関わる全ての操作は、 +.Xr modload 8 +と +.Xr modunload 8 +と +.Xr modstat 8 +の +プログラムにより処理されます。 +ユーザは直接 +.Pa /dev/lkm +に関与する必要は無い筈です。 +.Sh モジュールのタイプ +.Bl -ohang +.It Sy "システムコールモジュール" +システムコールは新しいシステムコールを +.Nm +インタフェースを通してロードすることにより置き換えること +が出来ます。 +全てのシステムコールを置き換えることが出来ますが、しかし +.Xr ioctl 2 +システムコールに関しては特に注意を払わなければなりません。 +何故なら、このシステムコールがモジュールのロードとアンロードに +用いられているからです。 +.Pp +システムコールモジュールがアンロードされるときには、 +動的にロードされたモジュールにより置き換えられていたシステムコール +はシステムコールテーブルの適正な位置に戻されます。 +.It Sy 仮想ファイルシステムモジュール +仮想ファイルシステムは +.Nm +インタフェースを通してロードできます。 +.It Sy "デバイスドライバモジュール +新しいブロック型と文字型のデバイスドライバを +.Nm LKM +を用いて、システムにロードすることが出来ます。 +デバイスドライバをロードする場合の主要な問題は +アクセスするデバイスに対応してドライバのデバイスノードが +存在しなければならないことです。 +これらのデバイスノードを作成するには通常 +ドライバのロードが成功した場合に +適切なプログラムを実行するよう +.Xr modload 8 +に指定する事により行います。 +.It Sy 実行クラス +イメージアクティベータ (image activator) としても知られています。 +実行クラスとは、これにより +.Xr execve 2 +システムコールが実行可能ファイルの形式を識別してメモリにロード +できるような機構です。 +.It Sy 雑モジュール +雑モジュールは、いまのところ明確に定義された、あるいは +一般的となっている拡張のためのインタフェースがないモジュールです。 +ユーザは固有のローダを書かなければなりません。 +新しいモジュールのロード時およびアンロード時に、 +そのモジュールを有効化および無効化するために +必要となるすべてのカーネルデータを、このローダが操作します。 +.El +.Sh 関連ファイル +.Bl -tag -width /usr/share/examples/lkm -compact +.It Pa /dev/lkm +.Nm +インタフェースデバイス +.It Pa /lkm +システムと同梱されたモジュールのバイナリが置いてあるディレクトリ +.It Pa /usr/include/sys/lkm.h +モジュールタイプの定義が置いてあるファイル +.It Pa /usr/share/examples/lkm +2タイプのモジュールを実装しているソースコードの例 +.Sh 関連項目 +.Xr modload 8 , +.Xr modstat 8 , +.Xr modunload 8 +.Sh バグ +モジュールが正しい初期化に失敗し、更にシステムがこの失敗を見つけることが +出来た場合には、システムは直ちにパニックによる再起動を行います。 +.Pp +システムの内部のインタフェースが変更された場合には、 +古いままのモジュールはしばしばこの変更を発見できないので、 +このようなモジュールはロードされた時に +しばしばクラッシュするかまたは不可解な機能不全を起こします。 +.Sh 作者 +.Nm +の機能を最初に実装したのは +.An Terrence R. Lambert +です。 +動的にロードするファイルシステムを実装したのは +.An Garrett Wollman +です。 +動的にロードする実行クラスを実装したのは +.An David Greenman +と +.An Soren Schmidt +と +.An Garrett Wollman +です。 +.Sh 歴史 +この +.Nm +機能は +.Tn SunOS +4.1.3 が実装した動的にロードするカーネルモジュールと機能が類似するように +設計されています。 +.\" Translated by Tetsuro Furuya (古谷 哲郎) , Dec 1999. +.\" ML Checked by MITSUNAGA Noriaki +.\" Final Checked by diff --git a/ja_JP.eucJP/man/man4/lnc.4 b/ja_JP.eucJP/man/man4/lnc.4 new file mode 100644 index 0000000000..5b044cc178 --- /dev/null +++ b/ja_JP.eucJP/man/man4/lnc.4 @@ -0,0 +1,124 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: lnc.4,v 1.6 1998/11/06 09:46:02 obrien Exp % +.\" jpman %Id: lnc.4,v 1.3 2000/01/03 03:14:36 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt LNC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm lnc +.Nd +AMD Lance/PCnet イーサネットデバイスドライバ +.Sh 書式 +.Cd "device lnc0 at isa? port 0x280 net irq 10 drq 0" +.Sh 解説 +.Nm +ドライバは、Am7990 と Am79C960 含む AMD ファミリを利用している +Lance/PCnet Ethernet NIC をサポートするために用意されています。 +.Nm +インタフェースによってサポートされているイーサネットカードは次の通りです: +.Bl -tag -width -offset ident -compat +.It Novell NE2100 +.It Novell NE32-VL +.It Isolan BICC +.It Digital DEPCA +.It Hewlett Packard Vectra 486/66XM +.It Hewlett Packard Vectra XU +.El +.Sh 診断 +.Bl -diag +.It "lnc%d: Framing error" +フレーミングエラーが発生しました。 +これはまた、CRC エラーも発生したことを意味しています。 +この結果、 +ドライバはフレーミングエラーを含んでいるパケットを落としました。 +.It "lnc%d: Receive CRC error" +受信したイーサネットフレームは、CRC チェックサムに失敗しました。 +この結果、 +ドライバがチェックサムに失敗したパケットを落としました。 +.It "lnc%d: Packet dropped, no mbufs" +ドライバは mbuf を使い果してしまいました。 +おそらく資源の問題だと思われます。 +.It "lnc%d: Couldn't allocate memory for NIC" +致命的エラーです。 +この状況下では、カードに対してドライバはアタッチされません。 +.It "lnc%d: Memory allocated above 16Mb limit" +ISA と ESIA カードは、 +16MB 以上の領域に DMA 転送を行うために、バウンスバッファが必要となります。 +Am7990 と Am79C960 のアドレスラインは 24 本しかありませんので、 +物理メモリのうち、下位の 16MB にしかアクセスできません。 +.Nm +ドライバは、自己が割り当てるメモリが下位 16MB の範囲内にあると仮定しています。 +これはあまり妥当な仮定ではありませんが、 +これ以外の方法は今のところ何もできません。 +共有メモリを利用した NIC に関しては関係ありません。 +.It "lnc%d: Device timeout -- Resetting" +デバイスはネットワークに応答するのを停止したか、あるいは、 +ネットワーク接続 (ケーブル) に関する問題が発生しました。 +使用中のネットワーク接続とカードの設定が同じになっているか +どうか確認してください。 +.It "lnc%d: Transmit late collision -- Net error?" +.It "lnc%d: Loss of carrier during transmit -- Net error?" +.It "lnc%d: Transmit of packet failed after 16 attempts -- TDR = %d" +.It "lnc%d: Heartbeat error -- SQE test failed" +.It "lnc%d: Babble error - more than 1519 bytes transmitted" +.It "lnc%d: Missed packet -- no receive buffer" +.It "lnc%d: Memory error -- Resetting" +.It "lnc%d: Couldn't get mbuf for transmit packet -- Resetting" +.It "lnc%d: Receive buffer error" +.It "lnc%d: Receive overflow error" +.It "lnc%d: Receive interrupt with buffer still owned by controller -- Resetting" +.It "lnc%d: Receive interrupt but not start of packet -- Resetting" +.It "lnc%d: Start of packet found before end of previous in receive ring -- Resetting" +.It "lnc%d: End of received packet not found -- Resetting" +.It "lnc%d: Transmit interrupt with buffer still owned by controller -- Resetting" +.It "lnc%d: Transmit interrupt but not start of packet -- Resetting" +.It "lnc%d: Start of packet found before end of previous in transmit ring -- Resetting" +.It "lnc%d: End of transmitted packet not found -- Resetting" +.It "lnc%d: Transmit buffer error -- Resetting" +.It "lnc%d: Transmit underflow error -- Resetting" +.El +.Sh バグ +このドライバは、 +どのイーサネットドライバよりも冗長に作られている可能性があります。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2 +から登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.An Paul Richards +が作成しました。 +このマニュアルページは +.An David E. O'Brien +が書きました。 diff --git a/ja_JP.eucJP/man/man4/lo.4 b/ja_JP.eucJP/man/man4/lo.4 new file mode 100644 index 0000000000..6649da66ae --- /dev/null +++ b/ja_JP.eucJP/man/man4/lo.4 @@ -0,0 +1,91 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)lo.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: lo.4,v 1.3 2000/01/03 03:14:15 horikawa Stab % +.\" %Id: lo.4,v 1.5 1997/02/22 13:24:37 peter Exp % +.\" +.Dd June 5, 1993 +.Dt LO 4 +.Os BSD 4.2 +.Sh 名称 +.Nm lo +.Nd ソフトウェアループバックネットワークインタフェース +.Sh 書式 +.Cd "pseudo-device loop" +.\" lo.4,v 1.5 での原文は +.\" .Sy pseudo-device +.\" .Nm loop +.\" 表示が乱れるので、他のファイルにならって .Cd 使用 +.\" docs/10495 で send-pr 済み +.\" SETA Takuji 1999/03/09 +.Sh 解説 +.Nm loop +インタフェースはソフトウェアループバック機構であり、 +性能診断、ソフトウェア試験、ローカルな通信等に使用されます。 +他のネットワークインタフェースと同様に、 +ループバックインタフェースもそのインタフェースが使用する +それぞれのアドレスファミリのために割り当てられた +ネットワークアドレスを持つ必要があります。 +これらのアドレスは +.Dv SIOCSIFADDR +.Xr ioctl 2 +によって設定、または変更されます。 +ループバックインタフェースは +最後のネットワークインタフェースとして設定される必要があります。 +これはプロトコルが優先度の指標として +設定の順序を使用するかもしれないためです。 +ループバックインタフェースはハードウェアインタフェースが +存在しない場合を除いて +.Em 最初に設定されるべきではありません。 +.Sh 診断 +.Bl -diag +.It lo%d: can't handle af%d. +インタフェースは不適当なアドレスファミリに含まれる +アドレス形式のメッセージを受け取りました。 +パケットは捨てられました。 +.El +.Sh 関連項目 +.Xr inet 4 , +.Xr intro 4 +.\" .Xr ns 4 +.Sh 歴史 +.Nm +デバイスは +.Bx 4.2 +に登場しました。 +.Sh バグ +システムがループバックインタフェースを自動的に利用可能にした +以前のバージョンでは、 +非標準のインターネットアドレス (127.1) を使用していました。 +このアドレスの使用は現在では使わないよう勧められています。 +かわりにローカルなネットワークのために予約されたホストアドレスを +使用する必要があります。 diff --git a/ja_JP.eucJP/man/man4/lp.4 b/ja_JP.eucJP/man/man4/lp.4 new file mode 100644 index 0000000000..7bc1c8cd9d --- /dev/null +++ b/ja_JP.eucJP/man/man4/lp.4 @@ -0,0 +1,258 @@ +.\" -*- nroff -*- +.\" +.\" Copyright (c) 1996 A.R.Gordon, andrew.gordon@net-tel.co.uk +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: lp.4,v 1.7 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: lp.4,v 1.3 1999/09/11 08:13:51 horikawa Stab % +.\" +.\" WORD: nibble ニブル +.\" +.Dd March 4, 1996 +.Os +.Dt LP 4 i386 +.Sh 名称 +.Nm lp +.Nd プリンタポートインターネットプロトコルドライバ +.Sh 書式 +.Nm ifconfig lp0 +.Ar 自アドレス 相手アドレス +.Op Fl link0 +.Cd "device lpt0 at isa? port? tty irq 7" +.Sh 解説 +.Nm +ドライバによって、PC パラレルプリンタポートを、 +同様に設定された 2 つのシステム間で、 +point-to-point ネットワークインタフェースとして使うことができます。 +データは一度に 4 ビットずつ転送し、 +入力にはプリンタ状態信号を使用します。 +よって、特別な双方向ハードウェアは必要とせず、 +割り込みで動作する標準の AT 互換のプリンタポートを使うことができます。 +.Pp +.Nm +ドライバは +.Nm lpt +ドライバを統合したものとして実装されており、 +インターネットのサポートと少なくとも 1 つの +.Nm lpt +デバイスを設定したカーネルに自動的に組み込まれます。 +ブートプロセス中に検出され割り込みが割り当てられた各 +.Nm lpt +プリンタデバイスについて、 +対応する +.Nm +ネットワークデバイスが生成されます。 +使用可能なデバイスは +.Dl lp0: TCP/IP capable interface +のようなメッセージによってアナウンスされます。 +.Pp +初期状態では +.Nm lpt +デバイスは印刷用にアクティブとなっており、 +ネットワークインタフェースは非アクティブです。 +しかし、一旦対応する +.Nm +デバイスが +.Xr ifconfig 8 +によって 'up' に設定されると、 +ネットワークインタフェースが 'down' に設定されるまで印刷は行えません。 +.Pp +通信プロトコルは +.Cm link0 +フラグによって選択されます。 +.Bl -tag -width Fl +.It Fl link0 +(デフォルト) FreeBSD モード (LPIP) を使用します。 +もう一つのモードに比べシンプルなもので、やや効率が良いものです。 +.It Cm link0 +Cyrnwr/Linux 互換のモード (CLPIP) を使用します。 +このモードはイーサネットパケットヘッダをシミュレートしており、 +他のタイプの機器とのインタフェースが容易です。 +.El +.Pp +インタフェース MTU のデフォルト値は 1500 となっていますが、 +ほかの値に設定することが可能です。 +リンクの両端では同じ値の MTU に設定されることが必要です。 +.Ss ケーブルの接続 +2 つのパラレルポートを接続するケーブルは、 +次のように結線されていることが必要です。 +.Bd -literal + ピン ピン 説明 + 2 15 Data0 -> ERROR* + 3 13 Data1 -> SLCT + 4 12 Data2 -> PE + 5 10 Data3 -> ACK* + 6 11 Data4 -> BUSY + 15 2 ERROR* -> Data0 + 13 3 SLCT -> Data1 + 12 4 PE -> Data2 + 10 5 ACK* -> Data3 + 11 6 BUSY -> Data4 + 18-25 18-25 グランド +.Ed +.Pp +この結線のケーブルは 'Laplink' ケーブルとして広く入手可能であり、 +よく黄色にカラーリングされています。 +.Pp +接続は対称的であり、各方向で 5 本を使用します +(データに 4 本とハンドシェイク用に 1 本)。 +2 つのモードは同じ結線のものを使いますが、 +どの線をハンドシェイクに使用するかが異なっています。 +.Ss FreeBSD LPIP モード +信号線は次のように使われます。 +.Bl -tag -width dataxxxx(xxピン) +.It Em Data0 (ピン 2) +出力データのビット 0。 +.It Em Data1 (ピン 3) +出力データのビット 1。 +.It Em Data2 (ピン 4) +出力データのビット 2。 +.It Em Data3 (ピン 5) +ハンドシェイク出力。 +.It Em Data4 (ピン 6) +出力データのビット 3。 +.It Em ERROR* (ピン 15) +入力データのビット 0。 +.It Em SLCT (ピン 13) +入力データのビット 1。 +.It Em PE (ピン 12) +入力データのビット 2。 +.It Em BUSY (ピン 11) +入力データのビット 3。 +.It Em ACK* (ピン 10) +ハンドシェイク入力。 +.El +.Pp +アイドル時、すべてのデータ線は 0 になっています。 +各バイトは次のように 4 段階で送信されます。 +送信側が上位 4 ビットを書き込み、ハンドシェイクラインを上げます。 +受信側はその 4 ビットを読み、 +読み込んだことを知らせるためにハンドシェイクラインを上げます。 +送信側は下位 4 ビットをデータ線にセットし、ハンドシェイクラインを下げます。 +受信側はデータを読み、ハンドシェイクラインを下げます。 +.Pp +パケットは固定値 0x08, 0x00 からなる 2 バイトのヘッダに +IP ヘッダとデータが続く形式となっています。 +.Pp +パケットの開始は単にヘッダの最初のバイトを送信することで示されます。 +パケットの終了はハンドシェイクラインの状態を変えずに、 +データ線を反転する (すなわち直前に送信したニブルの 1 の補数を書く) +ことによって示されます。 +.Pp +パケット終了のマークはハンドシェイク信号と出力データビットが +1 つの命令で書き込めることを前提にしていることに注意してください。 +さもなければ、パケットデータ中のあるバイト値が +パケット終了として誤って解釈されることが起こりえます。 +これは PC のプリンタポートでは問題とはなりませんが、 +このプロトコルを他の機器に実装する場合に注意が必要となります。 + +.Ss Crynwr/Linux CLPIP モード +信号線は次のように使われます。 +.Bl -tag -width dataxxxx(xxピン) +.It Em Data0 (ピン 2) +出力データのビット 0。 +.It Em Data1 (ピン 3) +出力データのビット 1。 +.It Em Data2 (ピン 4) +出力データのビット 2。 +.It Em Data3 (ピン 5) +出力データのビット 3。 +.It Em Data4 (ピン 6) +ハンドシェイク出力。 +.It Em ERROR* (ピン 15) +入力データのビット 0。 +.It Em SLCT (ピン 13) +入力データのビット 1。 +.It Em PE (ピン 12) +入力データのビット 2。 +.It Em ACK* (ピン 10) +入力データのビット 3。 +.It Em BUSY (ピン 11) +ハンドシェイク入力。 +.El +.Pp +アイドル時にはすべてのデータ線は 0 になっています。 +各バイトは次のように 4 段階で送信されます。 +送信側が下位 4 ビットを書き込み、ハンドシェイクラインを上げます。 +受信側はその 4 ビットを読み、 +読み込んだことを知らせるためにハンドシェイクラインを上げます。 +送信側は上位 4 ビットをデータ線にセットし、ハンドシェイクラインを下げます。 +受信側はデータを読み、ハンドシェイクラインを下げます。 +[LPIP モードとはニブルの順番が逆になっていることに注意してください。] +.Pp +パケットの形式は次のようになります。 +.Bd -literal +長さ (下位バイト) +長さ (上位バイト) +12 バイトの想定 MAC アドレス (FreeBSD では無視) +固定バイト 0x08 +固定バイト 0x00 + +チェックサムバイト +.Ed +.Pp +長さには、ヘッダの 14 バイトが含まれますが、 +長さを示すバイト自身とチェックサムバイトは含まれません。 +.Pp +チェックサムはすべてのバイト +(繰り返しますが、ヘッダ部分は含みますが、チェックサムと長さのバイトは除きます) +の単純な算術和です。 +FreeBSD では送信時にはチェックサムを計算していますが、 +受信したものについての確認は行っていません。 +.Pp +ハンドシェイク入力に選択されている信号線は +割り込みを生成するためには使われていないので、 +パケットの開始は特別な方法で信号化することが必要です。 +送信側は、データ線に値 0x08 を書き、 +受信側がデータ線に 0x01 を書くことにより応答するのを待ちます。 +その後、送信側はパケットの最初のバイト (長さバイト) の送信を開始します。 +.Pp +パケットの終了はパケット長から分かるため、 +特別な方法での信号化はされません。 +(データ線はアイドル状態である 0 に戻され、 +次のパケットの開始とならないようにはされますが。) +.Sh 関連項目 +.Xr lpt 4 , +.Xr ifconfig 8 +.Sh バグ +データの転送中のハンドシェイクにはビジーウェイトループが使われています。 +(さらに、受信側システムでのパケット開始の割り込みに応答するための待ちに +おいても同様です。) +そのため、低速なシステムと通信を行っている高速なシステムでは +かなりの CPU 時間を消費してしまいます。 +これは ハンドシェイクの信号の選択により CLPIP モードでは避けられないものです。 +理論的には LPIP モードの場合では改善することができます。 +.Pp +ポーリングのタイムアウトはタイマではなく +ループの回数によって制御されており、CPU の速度に依存しています。 +これは実際にポートを読むために +(低速な) ISA のバスサイクルを実行する必要があるため、 +いくぶん安定化されています。 diff --git a/ja_JP.eucJP/man/man4/lpbb.4 b/ja_JP.eucJP/man/man4/lpbb.4 new file mode 100644 index 0000000000..3819d75584 --- /dev/null +++ b/ja_JP.eucJP/man/man4/lpbb.4 @@ -0,0 +1,88 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: lpbb.4,v 1.3 1999/09/11 08:13:57 horikawa Stab % +.\" WORD: bit-banging ビット操作 +.Dd October 25, 1998 +.Dt LPBB 4 +.Os FreeBSD +.Sh 名称 +.Nm lpbb +.Nd +パラレルポート I2C ビット操作インタフェース +.Sh 書式 +.Cd "controller iicbus" +.Cd "controller iicbb0" +.Pp +.Cd "device lpbb0 at ppbus?" +.Cd "device iic0 at iicbus?" +.Sh 解説 +.Em lpbb +ドライバはフィリップスの正式な +I2C パラレルビット操作 (bit-banging) インタフェースをサポートします。 +.\" 訳注: フィリップスの社名の訳は日本フィリップス社のウェブサイト +.\" (http://www.philips.co.jp/) で確認。ウェブサイト中ではオランダ本社 +.\" は「フィリップス」として参照されている。 +.Pp +.Bd -literal + + LS05 ピン 14 (Vcc) o ------- + | | | + +--+--+---------------------+--+--+------------+------+-o 1 | + | | | | | | ===.1μF| +5V | + -------- [R][R][R] 3x10kΩ 3x10kΩ [R][R][R] LS05 | | | + | | | | | | | | ピン 7 o-+------+-o 2 | + | 12 o-+--+ | | 3|\\ 4 | | | (Gnd) | GND | + | 17 o-+-----|--|----| >o-------------+--|--|--------------+ | | + | | | | |/ 8 /|9 | | 10 /|11 +----+-o 3 | + | 15 o-+-----+--|--------------o< |------+--|------o< |----+ | SCL | + | | | 1|\\ 2 \\| | \\| | | + | 9 o-+--------|----| >o-------------------+--------------+----+-o 4 | + | | | |/ 6 /|5 | | SDA | + | 11 o-+--------+----------------------------------o< |----+ ------- + | 10 o-+-+ \\| 4 ピン + | 13 o-+-+--oGND コネクタ + | 25 o-+-+ + | 25 o-+-+ ------------------ 部品リスト --------------------------- + -------- | 1 - .1μF コンデンサ| 6 - 10kΩ 5% 抵抗 | + 25 ピン D 型 | 1 - 4 ピン コネクタ | 1 - 25 ピン D 型コネクタ (オス) | +コネクタ (オス) | 1 - 74LS05 オープンコレクタの 6 個のインバータ | + PC のプリンタ --------------------------------------------------------- + ポートへ +.Ed +.Pp +.Sh 関連項目 +.Xr iicbus 4 , +.Xr iicbb 4 , +.Xr ppbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +から登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/lpt.4 b/ja_JP.eucJP/man/man4/lpt.4 new file mode 100644 index 0000000000..38853baa90 --- /dev/null +++ b/ja_JP.eucJP/man/man4/lpt.4 @@ -0,0 +1,83 @@ +.\" +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" Copyright (c) 1994 Geoffrey M. Rehmet +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software withough 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. +.\" +.\" from: lpt.4,v 1.1 1993/08/06 10:34:12 cgd Exp +.\" $id: lpt.4,v 1.8 1998/10/22 14:12:55 bde Exp $ +.\" jpman %Id: lpt.4,v 1.3 1999/09/11 08:14:05 horikawa Stab % +.\" +.Dd August 28, 1993 +.Dt LPT 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm lpt +.Nd +パラレルポートドライバ +.Sh 書式 +割り込み駆動ポート: +.Cd "device lpt0 at isa? port" \&"IO_LPT1\&" tty irq 7 +.Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty irq 7 +.Cd "device lpt2 at isa? port" \&"IO_LPT3\&" tty irq 7 +.Pp +BIOS がプローブするポート: +.Cd "device lpt0 at isa? port? tty irq 7" +.Pp +ポーリングポート: +.Cd "device lpt0 at isa? port? tty" +.Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty +.Sh 解説 +このドライバはパラレルポートへのアクセスを提供します。 +.Pp +ドライバは割り込み駆動と、 +プリンタへのポーリングのいずれかに設定することができます。 +割り込み駆動に設定されたポートは +.Xr lptcontrol 8 +コマンドを使ってポーリングモードに変更することができます。 +.Pp +このドライバは現在は存在しない +.Xr lpa 4 +ドライバの機能を置き換えるものです。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/lpt0 +パラレルポートドライバの最初のもの +.El +.Sh 関連項目 +.Xr lp 4 , +.Xr lptcontrol 8 +.Sh バグ +沢山あります。特に安価なパラレルポートの実装において沢山あります。 +.Pp +lpt ポートはプリンタが接続されていて、 +かつオンライン状態にある時しかオープンできません。このため、 +プリンタが接続されていない時には、 +.Xr lptcontrol 8 +は実行できません。 +.Pp +このドライバはまだ書き直す必要があるかもしれません。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/aic.4 b/ja_JP.eucJP/man/man4/man4.i386/aic.4 new file mode 100644 index 0000000000..322991a0df --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/aic.4 @@ -0,0 +1,51 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: aic.4,v 1.4 1997/02/22 13:25:10 peter Exp % +.\" jpman %Id: aic.4,v 1.3 1999/10/06 10:51:40 horikawa Stab % +.\" +.Dd November 29, 1994 +.Dt AIC 4 i386 +.Os +.Sh 名称 +.Nm aic +.Nd Adaptec の AIC-6260 と AIC-6360 の SCSI ドライバ +.Sh 書式 +.Cd "device aic0 at isa? port 0x340 bio irq 11" +.Sh 解説 +.Nm aic +ドライバは Adaptec の AIC-6260 と AIC-6360 の SCSI +コントローラチップのサポートを提供します。 +これは、Adaptec 152x と Creative +Labs SoundBlaster SCSI ホストアダプタを含みます。 +.Pp +これらのコントローラチップを用いた多くのシステムは +ブート ROM を持っていません。したがって、ここからブートはできません。 +.Sh 関連項目 +.Xr cd 4 , +.Xr ch 4 , +.Xr intro 4 , +.Xr sd 4 , +.Xr st 4 + + diff --git a/ja_JP.eucJP/man/man4/man4.i386/apm.4 b/ja_JP.eucJP/man/man4/man4.i386/apm.4 new file mode 100644 index 0000000000..b878b8cd2f --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/apm.4 @@ -0,0 +1,160 @@ +.\" LP (Laptop Package) +.\" +.\" Copyright (c) 1994 by HOSOKAWA, Tatsumi +.\" +.\" This software may be used, modified, copied, and distributed, in +.\" both source and binary form provided that the above copyright and +.\" these terms are retained. Under no circumstances is the author +.\" responsible for the proper functioning of this software, nor does +.\" the author assume any responsibility for damages incurred with its +.\" use. +.\" +.\" %Id: apm.4,v 1.9 1998/12/18 03:08:57 jkoshy Exp % +.\" jpman %Id: apm.4,v 1.4 2000/07/17 05:48:14 osana Stab % +.\" +.Dd November 1, 1994 +.Dt APM 4 i386 +.Os +.Sh 名称 +.Nm apm +.Nd APM BIOS インタフェース +.Sh 書式 +.Cd device apm0 at isa? +.Sh 解説 +.Nm apm +はラップトップ PC の Intel / Microsoft APM (Advanced Poewr Management) +BIOS へのインタフェースです。 +.Pp +.Nm apm +は次の電源管理機能を提供します。 +.Bl -enum -offset indent +.It +システムがサスペンドモードから復帰した時に、 +.Nm apm +はシステムの時計を RTC に合わせます。 +.It +システムがサスペンドモードから復帰した時に、 +システムが復帰した時刻とサスペンドモード中に経過した時間で構成される +メッセージを、 +.Nm apm +は +.Xr syslogd 8 +に通知します。 +.It +.Nm apm +はシステムの活動 (実行可能なプロセス、割り込みなど) がない時に +CPU のクロックを減速します。 +この機能は APM が CPU のアイドリングをサポートしているシステムでのみ有効です。 +.It +.Nm apm +はキャラクタ型デバイスとしてアプリケーションインタフェースを提供します。 +アプリケーションはこのインタフェースを介して APM を制御したり、 +APM の状態情報を引き出したりすることができます。 +.Nm apm +は次のインタフェースを提供します。これらのシンボルは +.Dq Pa /usr/include/machine/apm_bios.h +で定義されています。 +.Bl -tag -width 4n -offset indent +.It Sy APMIO_SUSPEND +システムをサスペンドします。 +.It Sy APMIO_GET +電源管理情報を入手します。 +.It Sy APMIO_ENABLE +.It Sy APMIO_DISABLE +電源管理を有効 / 無効にします。 +.It Sy APMIO_HALTCPU +.It Sy APMIO_NOTHALTCPU +カーネルコンテキスト切り替えルーチンでの HLT の実行を制御します。 +.Pp +HLT +.Pq 割り込みが発生するまで CPU を停止 +命令を +.Dq Pa Idle CPU +呼び出しの中で実行する APM の実装もありますし、そうでないものもあります。 +ですからこれを有効にすると、 +.Dq Pa Idle CPU +を呼び出すカーネルコンテキスト切り替えルーチンが +元々 HLT 命令を実行することにより、 +余分な HLT 命令を実行することになる可能性があります。 +この結果、システムのピーク性能を減少させる可能性があります。 +.Pp +また、カーネルコンテキスト切り替えルーチンでの HLT 命令を無効にした場合、 +マシンの APM の実装が +.Dq Pa Idle CPU +で HLT を実行しない場合には、システムはハングアップします。 +CPU クロックの減速をサポートしていない実装では、APM は HLT +を実行しないかもしれません。 +そのようなマシンでは、 +.Nm apm +は +.Sy APMIO_NOTHALTCPU +の操作を無効にします。 +.Pp +現在のバージョンの +.Nm apm +は、クロックの減速がサポートされていない場合には、 +カーネルコンテキスト切り替えルーチンから +.Dq Pa Idle CPU +を呼び出さず、デフォルトでは HLT 命令を実行します。 +したがって、大抵の場合にはこれらの 2 つの操作を行う必要はありません +.El +.Pp +これらのインタフェースは +.Xr apm 8 +と +.Xr apmconf 8 +が使用します。 +.It +.Nm apm +は APM イベントをポーリングし、次のイベントを処理します。 +.Bl -column PMEV_POWERSTATECHANGEXXX "suspend system xxxxx" +.It Sy "名称 " "動作 " "解説" +.It Dv "PMEV_STANDBYREQ " No "サスペンド " "待機要求" +.It Dv "PMEV_SUSPENDREQ " No "サスペンド " "サスペンド要求" +.It Dv "PMEV_USERSUSPENDREQ " No "サスペンド " "ユーザサスペンド要求" +.It Dv "PMEV_CRITSUSPEND " No "サスペンド " "非常サスペンド要求" +.It Dv "PMEV_NORMRESUME " No "レジューム " "通常の復元" +.It Dv "PMEV_CRITRESUME " No "レジューム " "非常復元" +.It Dv "PMEV_STANDBYRESUME " No "レジューム " "待機復元" +.It Dv "PMEV_BATTERYLOW " No "メッセージ通知 " "電池不足" +.It Dv "PMEV_UPDATETIME " No "時計合わせ " "時刻を更新" +.El +.El +.Sh バグ +警告! +現在のところ、ラップトップマシンの APM BIOS の実装は、 +ほとんどとまではいかなくてもバグだらけです。 +このインタフェースを使用すると LCD ディスプレイや電池を +危険にさらす可能性があります。 +(これが MS-Windows で問題とならない理由はリアルモードインタフェース +を使用しているからです。) +このコードを使用してあなたのシステムが奇妙な動作をするのを発見した場合には、 +電源プラグと電池を直ちにとまではいかなくてもできるだけ早く抜き、 +このコードを無効にしてください。 +.Pp +私達はこのコードが動作するようになることに関心を持っています。 +異常な動作の観察結果をぜひ私達に連絡してください。 +.Pp +.Nm apm +が有効である時、ホットキーを使って BIOS 設定ルーチンを呼び出すと +システムレジューム時に重大な障害を引き起こす可能性があります。 +BIOS 設定プログラムはブートストラップ時または DOS から呼び出すべきです。 +.Pp +APM の実装によっては、電源ボタンを押したことやカバーを閉じるといった +イベントを扱うことができない場合があります。 +そのような実装でシステムをサスペンドする場合には、 +.Ar 必ず +.Xr apm 8 +または +.Xr zzz 8 +.Ar だけ +を使用してください。 +.Pp +ディスク減速、LCD バックライト制御、パワーオンデマンドは +現在のバージョンではサポートされていません。 +.Sh 関連項目 +.Xr apm 8 , +.Xr apmconf 8 , +.Xr zzz 8 +.Sh 作者 +Tatsumi Hosokawa diff --git a/ja_JP.eucJP/man/man4/man4.i386/ar.4 b/ja_JP.eucJP/man/man4/man4.i386/ar.4 new file mode 100644 index 0000000000..b287c99353 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/ar.4 @@ -0,0 +1,108 @@ +.\" +.\" Copyright (c) 1995 John Hay. 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 John Hay. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY John Hay ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL John Hay BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ar.4,v 1.9 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ar.4,v 1.3 1999/04/19 14:33:05 horikawa Stab % +.\" +.\" WORD: link level layer リンクレベルの層 +.\" +.Dd November 19, 1995 +.Dt AR 4 i386 +.Os +.Sh 名称 +.Nm ar +.Nd +同期 Arnet デバイスドライバ +.Sh 書式 +.Cd "device ar0 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Cd "device ar1 at isa? port 0x310 net irq 11 iomem 0xd0000" +.Pp +.Cd "pseudo-device sppp" +.Sh 解説 +.Nm ar +ドライバは HD64570 チップを使用した Arnet SYNC/570i ISA カードを +サポートします。 +2 ポートと 4 ポートの両方のカードをサポートし、自動検出します。 +.Pp +回線速度は最大で 2Mbps まで得られます。この速度では 486DX プロセッサで +帯域の約 85 % を使用することができます。 +.Pp +リンクレベルの層に、標準の +.\" link level layer は OSI モデルでは data link layer に相当するもの +.\" もしくは data link layer の一部に相当するものと思いますが、原文を +.\" 尊重して「リンクレベルの層」としたい +.Tn FreeBSD +sppp コードを使用します。 +デフォルトのプロトコルは PPP です。 +Cisco HDLC プロトコルは +.Xr ifconfig 8 +に +.Ar link2 +を追加することによって使用できます。 +.Sh 番号 +カーネル設定ファイルでは、カード毎に 1 行のみが必要です。 +最初のカードのポートは、ar0 から導入されます。 +次のカードの番号は、最初のカードで止まった所から続けます。 +つまり、もし最初のカードが 2 ポートのカードなら、そのカードは ar0 と ar1 +を使います。そして次のカードは、ar2 から始めます。 +.Pp +カードは IRQ 3, 5, 7, 10, 11, 12, 15 のみをサポートします。 +.Pp +iomem 領域は、16Kb ブロックであり、16Kb 境界から始まる必要があります。 +.Pp +.Sh 診断 +.Bl -diag +.It "ar%d: Warning illegal interrupt %d." +カードが指定された割り込みを使用できません。他の割り込みを選んでください。 +.El +.Sh 関連ファイル +.Bl -tag -width /sys/i386/isa/ic/hd64570.h -compact +.It Pa /sys/i386/isa/ic/hd64570.h +.It Pa /sys/i386/isa/if_arregs.h +.It Pa /sys/i386/isa/if_ar.c +.El +.Sh バグ +現時点で V.35 と X.21 インタフェースだけを試験しています。 +他のものではクロック部分のコードを微調整する必要があるでしょう。 +.Pp +このコードには、おそらく最適化の余地があります。 +.Pp +このコードは、まだできたばかりですから非常に多くのバグがあるでしょう。 +バグは jhay@mikom.csir.co.za へ報告してください。 +.Sh 関連項目 +.Xr cx 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr lsdev 8 +.Sh 作者 +.Nm ar +デバイスドライバは +.An John Hay Aq jhay@mikom.csir.co.za +が作成しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/cs.4 b/ja_JP.eucJP/man/man4/man4.i386/cs.4 new file mode 100644 index 0000000000..ba32f400d5 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/cs.4 @@ -0,0 +1,105 @@ +.\" +.\" Copyright (c) 1998 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 AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: cs.4,v 1.2 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: cs.4,v 1.3 1999/11/28 15:53:08 horikawa Stab % +.\" +.Dd July 20, 1998 +.Dt CS 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm cs +.Nd イーサネットデバイスドライバ +.Sh 書式 +.Cd "device cs0 at isa? port 0x300 net irq ?" +.Cd "device cs1 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Sh 解説 +.Nm +ドライバは +.Nm Crystal Semiconductor CS8900 と CS8920 +NIC をベースにした ISA イーサネットアダプタをサポートします。 +これらのデバイスは CS89x0 ファミリの欠点を補うだけの +高い完成度と小型化および低価格化を実現した、 +.Nm IBM EtherJet ISA +アダプタおよび同デバイスを組み込んだ多くの製品において使われています。 +.Pp +.Nm +ドライバは設定パラメータを、設定エントリまたはカードのどちらからでも +取得できます。設定エントリで指定されたパラメータがもし存在すれば +そちらを使用しますが、カードはソフトウェアで設定できるので、 +これらの設定は適正な値になっていると思われます。 +CS8920 ベースのアダプタは、通常 PnP 設定を提供するので、ドライバは +.Nm IBM EtherJet +と +.Nm CSC6040 +を自動的に検出します。 +.Pp +CS8900 は 4 つの IRQ 値に限定されていることに注意してください。これらの値は +通常 5, 10, 11, 12 となっています。CS8920 にはそのような制限はありません。 +.Pp +メモリマップと DMA 動作は現時点ではサポートされていません。 +.Sh 診断 +.Bl -diag +.It "cs%d: full/half duplex negotiation timeout" +ハブとの全二重設定ネゴシエート試行がタイムアウトを起こしました。 +このことはケーブル接続に問題があるか、欠陥か、互換性のないハブであることを +示しています。 +.It "cs%d: failed to enable " +CS89x0 は指示されたメディアの選択に失敗しました。そのメディアが存在しないか、 +操作が正しくありません。 +.It "cs%d: No EEPROM, assuming defaults" +CS89x0 に EEPROM がないか、絶望的に損傷しています。設定エントリがアダプタの +値に適した値になっていた場合にしか操作できません。 +.It "cs%d: Invalid irq" +設定エントリで指定された IRQ がアダプタにあっていません。 +.It "cs%d: Could not allocate memory for NIC" +致命的なメモリ不足です。アダプタは動きません。 +.It "cs%d: Adapter has no media" +アダプタは特定のメディアタイプに設定されていません。 +メディアタイプは手動でセットする必要があります。 +.It "This is a %s, but LDN %d is disabled" +PnP 探査コードは処理可能なアダプタを検出しましたが、 +アダプタは無効化されています。 +.It "failed to read pnp parms" +PnP アダプタが検出されましたが、そのアダプタ用の設定パラメータが読めません。 +.It "failed to pnp card parametars" +PnP 経由で得たパラメータをドライバは受けとれませんでした。アダプタはたぶん +動かないでしょう。 +.Sh 警告 +CS89x0 ファミリのアダプタは、とても小さな RAM バッファ (4K) しか +持っていません。このことは極端に高いネットワーク負荷や +爆発的なネットワークトラフィック下では問題を起こすかもしれません。 +実際、NFS 操作はオーバランを防ぐために、 1k の読み書き処理に +制限するべきです。 +.Sh 作者 +.Nm +デバイスドライバは +.An Maxim Bolotin +と +.An Oleg Sharoiko +が書きました。 +このマニュアルページは +.An Michael Smith +が書きました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/cx.4 b/ja_JP.eucJP/man/man4/man4.i386/cx.4 new file mode 100644 index 0000000000..4a9455eefd --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/cx.4 @@ -0,0 +1,289 @@ +.\" +.\" %Id: cx.4,v 1.4 1997/06/23 04:02:37 steve Exp % +.\" jpman %Id: cx.4,v 1.3 2000/08/10 13:49:49 horikawa Stab % +.\" +.Dd December 12, 1994 +.Dt CX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm cx , +.Nm if_cx +.Nd 同期/非同期 Cronyx-Sigma アダプタドライバ +.Sh 設定 +.Cd "device cx0 at isa? port 0x240 irq 15 drq 7" +.Cd "device cx1 at isa? port 0x260 irq 12 drq 6" +.Cd pseudo-device sppp +.Pp +i/o ベースアドレスは、ボード上のジャンパで設定されます。 +DMA チャネルと割り込みリクエスト番号は、 +アダプタ初期化時にソフトウェアで設定されます。 +通常の値は以下の通りです。 +.Pp +.Bl -tag -compact -width Port +.It Port +0x240, 0x260, 0x280, 0x300, 0x320, 0x380 +.It IRQ +3, 5, 7, 10, 11, 12, 15 +.It DMA +5, 6, 7 +.Sh 解説 +Cronyx-Sigma ドライバはモデル 100, +400, 500, 401, 404, 410, 440, 703, 801, 810, 840 をサポートします。 +モデルが異なると、チャネルのセットが異なります。 +.Pp +.Bl -tag -compact -width Cronyx-Sigma-999 +.It モデル +チャネル +.It Cronyx-Sigma-100 +0 +.It Cronyx-Sigma-400 +4, 5, 6, 7 +.It Cronyx-Sigma-500 +0, 4, 5, 6, 7 +.It Cronyx-Sigma-401 +0, 1, 2, 3 +.It Cronyx-Sigma-404 +0, 1, 2, 3 +.It Cronyx-Sigma-410 +0, 1, 2, 3 +.It Cronyx-Sigma-440 +0, 1, 2, 3 +.It Cronyx-Sigma-703 +0, 1, 2, 4, 5, 6, 7 +.It Cronyx-Sigma-801 +0, 1, 2, 3, 4, 5, 6, 7 +.It Cronyx-Sigma-810 +0, 1, 2, 3, 4, 5, 6, 7 +.It Cronyx-Sigma-840 +0, 1, 2, 3, 4, 5, 6, 7 +.El +.Pp +ふたつのアダプタは、ボード間接続用の短い専用ケーブルで接続することができます。 +ふたつの接続されたアダプタは、同じ IRQ と DMA チャネルを使用し、 +ドライバから見ればひとつの 16 チャネルマルチプレクサとして動作します。 +接続されたボードの片方が ``マスタ'' に、もう一方が ``スレーブ'' になります。 +.Pp +スレーブになったボードのチャネルは、 +ドライバによって 8 から始まる番号が割り当てられます。 +たとえばモデル 100 と モデル 500 を接続すると、 +0, 8, 12, 13, 14, 15 番のチャネル番号が割り当てられます。 +.Pp +RS-232C インタフェースをもつチャネルは、 +同期モードと非同期モードのどちらでも動作することが可能 +(cxconfig ユーティリティによってソフトウェア的に選択します) であり、 +そのため ``ユニバーサルチャネル'' と呼ばれます。 +.Pp +Cronyx-Sigma アダプタ用のデバイス型特殊ファイル +.Pa /dev/* +は、 +.Xr MAKEDEV 8 +によっ作られます。 +たとえば、以下のように作ります: +.Bd -literal +cd /dev +sh MAKEDEV cronyx ttyx0 ttyx1 ttyy0 +.El +.Sh 非同期ドライバ +.Pp +非同期チャネルのデバイスファイルには次のような名前が付けられます: +.Pa /dev/ttyx# +- はアダプタ cx0 に、 +.Pa /dev/ttyy# +- はアダプタ cx1 に、 +.Pa /dev/ttyz# +- はアダプタ cx2 に付けられます。 +ここで # は 0-9-a-f の、16 進数でのチャネル番号です。 +.Pp +ドライバは以下の標準 ioctl を受け付けます ( +.Xr ioctl +を参照): +.Pp +.Bl -tag -width TIOCXXXXX -compact +.It Dv TIOCSBRK +BREAK を送信開始します。 +.It Dv TIOCCBRK +BREAK の送信を停止します。 +.It Dv TIOCSDTR +DTR 信号をセットします (DTR := 1)。 +DTR 信号は最初の open(2) で必ずセットされ、 +.Dv TIOCCDTR , +.Dv TIOCSDTR , +.Dv TIOCMSET , +.Dv TIOCMBIS , +.Dv TIOCMBIC +の ioctl により変更可能です。 +.It TIOCCDTR +DTR 信号をクリアします (DTR := 0)。 +.It TIOCMSET +DTR 信号と RTS 信号に、指定した値をセットします ( := data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMBIS +DTR 信号と RTS 信号をセットします ( |= data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMBIC +DTR 信号と RTS 信号をクリアします ( &= ~data)。 +DTR 信号と RTS 信号は、 +ioctl システムコールの引数中の +.Dv TIOCM_DTR +と +.Dv TIOCM_RTS +のビットにより制御可能です。 +.It TIOCMGET +ライン上のモデム信号の状態を判定します。 +呼び出しのあと、引数のデータは下記のビットを保持しています: +.Pp +.Bl -tag -width TIOCM_XXX -compact +.It TIOCM_LE +常にセット (ラインイネーブル状態) +.It TIOCM_DSR +データセットレディ信号 (DSR) 受信済 +.It TIOCM_CTS +送信可能信号 (CTS) 受信済 +.It TIOCM_CD +データキャリア検出信号 (CD) 受信済 +.It TIOCM_DTR +データ端末レディ (DTR) 信号送信済 +.It TIOCM_RTS +送信要求 (RTS) 送信済 +.El +.El +.Sh 同期ドライバ +.Pp +同期チャネルとユニバーサルチャネルは、 +.Xr cxconfig 8 +ユーティリティによって同期モードに設定すると、 +ネットワークインタフェース ``cx#'' +(# は 0 から 47 までのチャネル番号) としてアクセス可能です。 +すべての標準的なネットワークインタフェースパラメータは、 +.Xr ifconfig 8 +によって設定可能です。 +また +.Xr cxconfig 8 +コマンドは、拡張されたチャネルオプションの変更や、 +上位レベルのソフトウェアプロトコル +(PpP や Cisco HDLC など) の設定に使用されます。 +.Pp +ユニバーサルチャネルは同期モードでも非同期モードでも使用することができます。 +デフォルトでは非同期モードに設定されており、モードは +.Xr cxconfig 8 +ユーティリティによって変更可能です。 +チャネルがビジー状態 (非同期チャネルがオープン状態の場合や、 +ネットワークインタフェースが動作中 (up) の場合) +の間、モードはブロックされます。 +.Sh 同期ポイントツーポイントプロトコル +.Pp +Cronyx-Sigma ドライバは、組み込みの同期ポイントツーポイントプロトコル +(sppp) を使用します。 +本プロトコルには、PpP/HDLC や Cisco/HDLC、keepalive パケットによる +自動的なコネクションロス検出もサポートしています。 +sppp プロトコルセットは独立したモジュールとして実装され、 +他の同期シリアルチャネルのドライバによって使用することも可能です。 +BSD/386 (BSDI) 用の +ドライバでは、OS 側で実装されている一般的な同期プロトコルのセットも使用 +可能です。外部プロトコルセットは、``cxconfig ext'' コマンド +( +.Xr cxconfig 8 +を参照) によって選択可能です。 +.Sh チャネルオプションの管理 +.Pp +.Xr cxconfig 8 +ユーティリティは、チャネルオプションを設定するのに使用されます。 +チャネルオプションは、通常、オペレーティングシステムが起動する際に (たとえば +.Pa /etc/rc +ファイルなどで) 設定されます。 +すべての場合において、 +すべてのオプションが意味を持つとは限らないことに注意してください。 +また、 +オプションの設定によっては、 +チャネルもしくはアダプタ全体のハングアップの原因になります。 +.Pp +実際のチャネルオプションの制御機能は、 +デバイス型特殊ファイル /dev/cronyx に対する +いくつかの ioctl を経由する形で実装されており、以下の ioctl が使用できます。 +.Pp +.Bl -tag -width CXIOCXXXXXXX -compact +.It CXIOCGETMODE +チャネルオプションの値を取得します。 +.It CXIOCSETMODE +チャネルオプションの値を設定します。 +.El +.Pp +ioctl コールのデータ引数は以下のオプション構造体のアドレスを持ちます: +.Bd -literal +typedef struct { + unsigned char board; /* アダプタ番号であり、0..2 */ + unsigned char channel; /* チャネル番号であり、0..15 */ + unsigned char type; /* チャネルタイプ (読み込み専用) */ + unsigned char iftype; /* chan0 インタフェース */ + unsigned long rxbaud; /* 受信速度 */ + unsigned long txbaud; /* 転送速度 */ + cx_chan_mode_t mode; /* チャネルモード */ + cx_chan_opt_t opt; /* 共通のチャネルオプション */ + cx_opt_async_t aopt; /* 非同期モードオプション */ + cx_opt_hdlc_t hopt; /* hdlc モードオプション */ + cx_opt_bisync_t bopt; /* bisync モードオプション */ + cx_opt_x21_t xopt; /* x.21 モードオプション */ + cx_soft_opt_t sopt; /* ソフトウェアオプションと状態フラグ */ +} cx_options_t; /* ユーザが設定可能なオプション */ +.Ed +.Pp +.Bl -tag -width rxbaudxxx +.It Fa board +0..2 の、アダプタ番号 +.It Fa channel +0..15 の、チャネル番号 +.It Fa type +チャネルのタイプ (読み取り専用の引数) +.It Fa iftype +0 番 (と 8 番) チャネルのインタフェースタイプ。 0 - RS-232, 1 - RS-449/V.35。 +.It Fa rxbaud +受信ボーレート +.It Fa txbaud +送信ボーレート +.It Fa mode +チャネルモード: 非同期/HDLC/Bisync/X.21 +.It Fa opt +共通のチャネルオプション +.It Fa aopt +非同期モードオプション +.It Fa hopt +HDLC モードオプション +.It Fa bopt +Bisync モードオプション +.It Fa xopt +X.21 モードオプション +.It Fa sopt +ソフトウェアプロトコルオプション +.El +.Sh 関連ファイル +.Bl -tag -width /dev/cxXXXX -compact +.It Pa /dev/cx?? +非同期チャネル +.It Pa /dev/cronyx +チャネルオプション管理用のデバイス型特殊ファイル +.El +.Pp +ドライバを含んでいるソースファイルは以下の通りです: +.Pp +.Bl -tag -width /dev/cxXXXX -compact +.It Pa /sys/i386/isa/cronyx.c +.It Pa /sys/i386/isa/cx.c +.It Pa /sys/i386/isa/if_cx.c +.It Pa /sys/i386/isa/cronyx.h +.It Pa /sys/i386/isa/cxreg.h +.It Pa /sys/net/if_spppsubr.c +.It Pa /sys/net/if_sppp.h +.El +.Sh 関連項目 +.Xr cxconfig 8 , +.Xr ifconfig 8 diff --git a/ja_JP.eucJP/man/man4/man4.i386/el.4 b/ja_JP.eucJP/man/man4/man4.i386/el.4 new file mode 100644 index 0000000000..98c708c962 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/el.4 @@ -0,0 +1,58 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: el.4,v 1.7 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: el.4,v 1.3 1999/08/18 16:40:09 horikawa Stab % +.\" +.Dd July 10, 1995 +.Dt EL 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm el +.Nd 3Com Etherlink 3C501 デバイスドライバのためのイーサネットドライバ +.Sh 書式 +.Cd "device el0 at isa? port 0x300 net irq 9" +.Sh 解説 +.Nm +インタフェースは、 +3Com 3c501 8 ビット ISA イーサネットカードのサポートを提供します。 +3c501 カードはかなり遅いことが知られていますので、 +もし可能なら他のイーサネットカードを用いるべきです。 +しかし、10 Mb/s イーサネットネットワークへのアクセスとしては安価です。 +.Pp +有効な I/O ポートは 0x280-0x3f0 の範囲です。 +.Sh バグ +ドライバはカードがカーネルと同じ IRQ に設定されていると仮定します。 +これが正しいかどうか確かめるプローブやチェックは行われていません。 +.Pp +現在、DMA はサポートしていません。 +.Pp +現在、マルチキャストはサポートしていません。 +.Sh 関連項目 +.Xr ed 4 , +.Xr eg 4 , +.Xr ep 4 , +.Xr ie 4 , +.Xr intro 4 , +.Xr le 4 , +.Xr ifconfig 8 diff --git a/ja_JP.eucJP/man/man4/man4.i386/ep.4 b/ja_JP.eucJP/man/man4/man4.i386/ep.4 new file mode 100644 index 0000000000..9ca7f0f87b --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/ep.4 @@ -0,0 +1,121 @@ +.\" +.\" Copyright (c) 1994 Herb Peyerl +.\" 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 Herb Peyerl +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ep.4,v 1.9 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ep.4,v 1.3 1999/08/18 16:40:32 horikawa Stab % +.\" +.Dd February 04, 1993 +.Dt EP 4 i386 +.Os +.Sh 名称 +.Nm ep +.Nd +3Com Etherlink III イーサネットデバイスドライバ (3c5x9) +.Sh 書式 +.Cd "device ep0 at isa? port 0x300 net irq 10" +.Sh 解説 +.Nm ep +ドライバは 3c509 (ISA) と 3c579 (EISA) のサポートを提供します。 +これらのカードのさまざまなモデルは、コネクタの配列がそれぞれ異なります。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It AUI/DIX +標準 15 ピンコネクタ +.It 10Base2 +BNC (シンケーブルとしても知られているもの) +.It 10BaseT +UTP (ツイストペアとしても知られているもの) +.El +.Pp +デフォルトで使用されるポートは、 +セットアップユーティリティで選択されているポートです。 +これをオーバライドするには、 +.Xr ifconfig 8 +または +.Pa /etc/rc.conf +ファイルで次のフラグを使用します。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It link0 +AUI ポートを使用 +.It link1 +BNC ポートを使用 +.It link2 +UTP ポートを使用 +.El +.Pp +コンピュータに複数のカードを装着している場合は、次の順番で探されます。 +最初に 3c579 EISA カードが探されます -- +これらは EISA スロット番号順に検出されます。 +次に、3c509 ISA カードが探されます -- +イーサネットアドレスの昇順に検出されます。 +次に、どのようにプローブされるかの例を示します。 +.Pp +ep0 at isa0 port 0x6000-0x600f irq 10: aui/bnc address 00:60:8c:70:e5:c5 +ep1 at isa0 port 0x300-0x30f irq 3: aui/bnc/utp address 00:20:af:10:62:ab +.Pp +カードが発見されることが期待されるポートと IRQ を指定することもできますが、 +この指定は必ずしも必要ではありません。 +カードは ISA バス上での自分の居場所を我々に伝えるに +十分なインテリジェンスを備えているのです。 +.Pp +.Sh 注釈 +3c509 カードにはアドレスを設定するジャンパがありません。 +3Com はカードのアドレスを設定するソフトウェアを提供しています。 +ISA バス上でこのカードを見つけるために、 +カーネルは IO アドレス 0x110 で複雑なスキャン操作を行います。 +注意してください! このアドレスに他のカードを配置することは避けてください。 +.Pp +.Sh 診断 +ep0: reset (status: %x) +.in +4 +ドライバは FIFO のアンダランまたはオーバランを検出しました。ドライバが +カードをリセットし、パケットが失われます。これは致命的ではありません。 +.in -4 +ep0: eeprom failed to come ready +.in +4 +EEPROM の準備ができていません。おそらくカードが死んでいます。 +.in -4 +ep0: 3c509 in test mode. Erase pencil mark! +.in +4 +誰かがカードの上のテスト領域に鉛筆で落書きをしているかもしれません。鉛筆書き +の跡を消してリブートしてください (これはジョークではありません)。 +.in -4 +.Sh 関連項目 +.Xr ed 4 , +.Xr eg 4 , +.Xr el 4 , +.Xr ie 4 , +.Xr intro 4 , +.Xr le 4 , +.Xr vx 4 , +.Xr ifconfig 8 +.Sh 規格 +は偉大なり。豊富な選択肢があります。 + diff --git a/ja_JP.eucJP/man/man4/man4.i386/ex.4 b/ja_JP.eucJP/man/man4/man4.i386/ex.4 new file mode 100644 index 0000000000..ef427df931 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/ex.4 @@ -0,0 +1,84 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ex.4,v 1.6 1998/10/22 14:32:20 bde Exp % +.\" jpman %Id: ex.4,v 1.4 1999/08/15 14:19:03 horikawa Stab % +.\" +.\" WORD: Plug-N-Play プラグアンドプレイ +.\" +.Dd January 19, 1997 +.Dt EX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ex +.Nd +Intel EtherExpress Pro/10 と Pro/10+ イーサネットデバイスドライバ +.Sh 書式 +.Cd "device ex0 at isa? port? net irq ?" +.Sh 解説 +.Nm +ドライバは Intel i82595 チップを搭載した 16 ビット PCI の +Intel EtherExpress Pro/10 と Pro/10+ イーサネットカードの +サポートを提供します。 +.Pp +ポートの開始アドレスが見つからなければ、 +I/O アドレスの 0x200 から 0x3a0 の範囲からカードを探します。 +IRQ が指定されていなければ、カードの EEPROM から読み出されます。 +新しめのカードでの正しい操作のためには +プラグアンドプレイのサポートを無効にすべきです。 +.Pp +.Sh 診断 +.Bl -diag +.It "ex%d: Intel EtherExpress Pro/10, address %6D, connector %s" +デバイスプローブはインストールされたカードを発見して、 +デバイスドライバを正しくインストールすることができました。 +.It "ex%d: WARNING: board's EEPROM is configured for IRQ %d, using %d" +デバイスプローブはカーネル設定ファイルで指定されたものとは +異なる割り込みが設定されているボードを検出しました。 +.It "ex%d: invalid IRQ." +デバイスプローブは不正な IRQ 設定を検出しました。 +.El +.Pp +.Sh バグ +現在は、ドライバはマルチキャストをサポートしていません。 +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2 +に初めて登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.ie t .An Javier Mart\)'in Rueda +.el .An Javier Martin Rueda +によって書かれました。 +このマニュアルページは +.An David E. O'Brien +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/fe.4 b/ja_JP.eucJP/man/man4/man4.i386/fe.4 new file mode 100644 index 0000000000..75474211b0 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/fe.4 @@ -0,0 +1,284 @@ +.\" All Rights Reserved, Copyright (C) Fujitsu Limited 1995 +.\" +.\" This document may be used, modified, copied, distributed, and sold, in +.\" both source and printed form provided that the above copyright, these +.\" terms and the following disclaimer are retained. The name of the author +.\" and/or the contributor may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS DOCUMENT IS PROVIDED BY THE AUTHOR AND THE CONTRIBUTOR ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR THE CONTRIBUTOR BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS DOCUMENT, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" Contributed by M. Sekiguchi . +.\" for fe driver. +.\" +.\" %Id: fe.4,v 1.11 1998/10/22 13:01:19 bde Exp % +.\" jpman %Id: fe.4,v 1.3 2000/08/10 13:49:45 horikawa Stab % +.\"" lair events -> typo of "rare" events (approved by original writer) +.Dd March 3, 1996 +.Dt FE 4 i386 +.Sh 名称 +.Nm fe +.Nd 富士通 MB86960A/MB86965A をベースとしたイーサネットアダプタ +.Sh 書式 +.Cd "device fe0 at isa? port 0x300 net irq ?" +.Sh 解説 +.Nm fe +は、富士通 MB86960A, MB86965A またはその他の互換チップをベースとした +イーサネットアダプタのためのネットワークデバイスドライバです。 +.Pp +このドライバは、アダプタのハードウェアが対応していれば、 +I/O ポートアドレスと IRQ の設定を自動的に行ないます。 +.Pp +このドライバはプログラム I/O データ転送技術を使用しており、 +まずまずのパフォーマンスが得られます。 +アダプタがたとえ持っていたとしても、共有メモリは使用しません。 +.Pp +このドライバは現在のところ、ISA 用の富士通 FMV-180 シリーズ、 +ISA 用の アライドテレシス AT1700 シリーズと RE2000 シリーズ、 +富士通 MBH10302 PC カードに対応しています。 +.Ss パラメータ +カーネル設定ファイルにおいて、2 つのパラメータ +.Ar port +と +.Ar irq +には、アダプタのハードウェア設定を反映した値を指定する必要があります。 +もう 1 つオプションとして +.Ar flags +パラメータがあり、付加的な設定を行なうことができます。 +その他の device 文におけるパラメータは書式に書かれているとおりに +書く必要があります。 +.Pp +.Ar port +パラメータは、アダプタのベース I/O ポートアドレスを指定します。 +この値はアダプタのハードウェア設定と合致している必要があります。 +.Ar port +は、 +.Dq Li \&? +にして、指定せずに残しておくこともできます。 +その場合、ドライバは I/O アドレスに関するハードウェア設定の検出を +自動的に試みます。 +この機能はアダプタハードウェアによっては動かないかもしれません。 +.Pp +.Ar irq +パラメータは、アダプタが使用する IRQ 番号を指定します。 +この値はアダプタのハードウェア設定と合致している必要があります。 +.Ar irq +は、 +.Dq Li \&? +にして、指定せずに残しておくこともできます。 +その場合、ドライバは IRQ に関するハードウェア設定の検出を +自動的に試みます。 +この機能はアダプタハードウェアによっては動かないかもしれません。 +.Pp +.Ar flags +は、様々なデバイス設定の組み合わせからなる数値です。 +現在のバージョンでは以下の flags が定義されています。 +2 つ以上の設定をデバイスに設定するには、 +それぞれの flag 値を数値で加算してください。 +以下で指定されていない flag ビットは予約されており、0 にしなければ +なりません。実際には、それぞれのビットは単に無視されるか、テスト用や +ドライバの文書化されていない機能を制御するために使われます。 +文書化されていない機能については、プログラムのソースを参照してください。 +.Bl -tag -width "99999999" +.It Li 0x007F +これらの flag ビットは、 +.Ar flags +の +.Li 0x0080 +ビットが設定されている時に、MB86960A/MB86965A チップの DLCR6 レジスタを +初期化するために使用されます。 +DLCR6 上書き機能に関する詳細は以下を参照してください。 +将来のバージョンにおけるドライバの互換性を保持するために、 +.Li 0x0080 +ビットがセットされていない場合以外、 +.Li 0x007F +flag ビットは 0 にしておいてください。 +.It Li 0x0080 +この flag は、MB86960A/MB86965A チップの DLCR6 レジスタに対する +デフォルト設定を flag 値の 低位 7 bit を用いて上書きします。 +この flag は問題解決用のものであり、アダプタハードウェアに関する +知識がある人のみが使用してください。 +DLCR6 設定に関する詳細な情報は、富士通のマニュアルを参照してください。 +.El +.Sh オプション +.Nm fe +ドライバはカーネル設定ファイルにおいて、 +.Dq option +文で指定できるいくつかの私的なオプションを持っています。 +以下に私的オプションをリストします。 +ドライバはこれ以外にも文書化されていないオプションを受け付けます。 +それらの名前には全て +.Dv "FE_" +という固定された接頭辞が付けられています。 +文書化されていないオプションについては、プログラムのソースを参照してください。 +.Bl -tag -width "FE_" +.It Dv "FE_DEBUG=" Ns Ar level +このオプションは、デバイスと (または) ドライバのデバッギングレベルを +制御する数値を受けとります。 +.Dv "FE_DEBUG" +ここにリストされていない値にオプションを設定すると、 +文書化されていない動作を引き起こすかもしれません。 +このオプションに関するデフォルトの設定値は 1 です。 +.Bl -bullet +.It +.Dv "FE_DEBUG=0" +を設定すると、正当性の確認を含めた多くのデバッグ用コードが、 +ドライバのオブジェクトコードから除かれます。 +この設定は最も速くて小さなオブジェクトコードを生成します。 +この設定であっても、いくつかの非常時メッセージは記録されます。 +.It +.Dv "FE_DEBUG=1" +を設定すると、最低限のデバッグ用コードが含まれ、 +最小量のメッセージが記録されます。 +この設定では致命的なエラーメッセージのみが記録されます。 +.It +.Dv "FE_DEBUG=2" +を設定すると、標準的なデバッグ用コードが含まれ、 +中間量のメッセージが記録されます。 +この設定では滅多にないイベントや怪しげな状態でのメッセージが記録されます。 +.It +.Dv "FE_DEBUG=3" +を設定すると、全てのデバッグ用コードが含まれ、 +最大量のメッセージが記録されます。 +この設定では通常動作の報告やレジスタ値のダンプなどの +冗長なメッセージが記録されます。 +.El +.El +.Sh ハードウェアモデルに特有の機能 +.Nm fe +ドライバには、アダプタのハードウェアモデルに特有の機能や制限が +いくつかあります。 +以下はそのような性質の概略です。 +.Ss 富士通 FMV-180 シリーズアダプタ +これらのアダプタでは、IRQ と I/O ポートアドレスの両方が +自動的に検出可能です。 +.Pp +FMV-180 シリーズでは +.Nm fe +の自動 I/O ポートアドレス検出機能はたいていの場合具合良く動きます。 +もしシステムに 2 つ以上の FMV-180 があったとしても、 +ちゃんと動きます。 +しかし、それ以外のアダプタとの組み合わせは、ドライバを混乱させるかも +しれません。 +ハードウェア検出で何か困難を感じた時は、 +.Em "port ?" +を使わないことをお勧めします。 +.Pp +FMV-180 シリーズでは +.Nm fe +の自動 IRQ 検出機能は確実に動きます。 +FMV-180 には常に +.Em "irq ?" +を使うことをお勧めします。 +IRQ のハードウェア設定は、カーネル設定ファイルにおいて IRQ 値が指定されて +いたとしても、アダプタの EEPROM 設定から読み込まれます。 +ドライバはカーネル設定ファイルで指定された IRQ が EEPROM に保存された値と +違っていた場合、警告メッセージを生成し、 +設定ファイルで指定された値を使用します +(この振舞は前回のリリースより変更になっています)。 +.Ss アライドテレシス AT1700 シリーズと RE2000 シリーズアダプタ +アライドテレシス AT1700 シリーズと RE2000 シリーズでは、 +自動 I/O ポートアドレス検出機能は動きますが、 +FMV-180 シリーズよりは確実度が落ちます。 +アライドテレシスのアダプタでこの機能を使用するのはお勧めできません。 +.Pp +自動 IRQ 検出も制限つきですが可能です。 +.Nm fe +ドライバは設定ファイルで +.Dq irq \&? +が設定されていた場合、ボードの EEPROM 設定より IRQ 設定を得ようとします。 +不幸なことに、AT1700 シリーズと RE2000 シリーズには 2 種類のモデルが +あるように思えます; +あるタイプは IRQ を 3/4/5/9 から選択可能で、もう片方は 10/11/12/15 から選択 +可能です。 +これらのモデルの識別方法は、良く知られていません。 +このため、アライドテレシスのアダプタでの自動 IRQ 検出は確実でないようです。 +何かトラブルが起きた時は、正確な IRQ 番号を指定してください。 +.Pp +AT17000 シリーズと RE2000 シリーズの違いや、 +これらのシリーズ内でのマイナモデルの見分けはしていません。 +.Ss 富士通 MBH10302 PC カード +.Nm fe +ドライバは富士通 MBH10302 と互換 PC カードをサポートしています。 +動作には PC カード (PCMCIA) サポートパッケージが必要です。 +.Sh 関連項目 +.Xr netstat 1 , +.Xr crd 4 , +.Xr ed 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr pccardd 8 +.Sh バグ +以下は、既知の大きなバグです: +.Pp +.Nm fe +ドライバによって保たれているコリジョン数の統計は正確ではありません; +.Xr netstat 1 +の +.Fi i +オプションは実際のコリジョン数より若干少ない値を示します。 +.Pp +思ったよりも多くの mbuf クラスタが消費されます。 +パケット受信ルーチンが、mbuf クラスタの割り当てポリシに、わざ +と違反しているからです。 +不必要に割り当てられたクラスタは短い生存期間で解放されるため、 +長い目で見ればカーネルメモリ消費量には影響しません。 +.Pp +XNS と IPX へのサポートがドライバには含まれていますが、 +一度もテストはされておらず、たくさんのバグがあるはずです。 +.Sh 作者、著作権、免責条項 +.Pp +.Nm fe +ドライバは +.An David Greenman +が書いた +.Nm ed +ドライバを模範として、 +.An M. Sekiguchi Aq seki@sysrap.cs.fujitsu.co.jp +が独自に作成して寄贈しました。 +.Nm fe +における PC カードサポートは +.An Hidetoshi Kimura Aq h-kimura@tokyo.se.fujitsu.co.jp +が書きました。 +このマニュアルページは +.An M. Sekiguchi +が書きました。 +.Pp +.Em "All Rights Reserved, Copyright (C) Fujitsu Limited 1995" +.Pp +This document and the associated software may be used, modified, +copied, distributed, and sold, in both source and binary form provided +that the above copyright, these terms and the following disclaimer are +retained. The name of the author and/or the contributor may not be +used to endorse or promote products derived from this document and the +associated software without specific prior written permission. +.Pp +THIS DOCUMENT AND THE ASSOCIATED SOFTWARE IS PROVIDED BY THE AUTHOR +AND THE CONTRIBUTOR +.Dq 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 THE +CONTRIBUTOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +DOCUMENT AND THE ASSOCIATED SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. +.Sh 歴史 +.Nm +ドライバは +.Fx 2.0.5 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/ie.4 b/ja_JP.eucJP/man/man4/man4.i386/ie.4 new file mode 100644 index 0000000000..2693c4cc84 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/ie.4 @@ -0,0 +1,96 @@ +.\" jpman %Id: ie.4,v 1.3 1999/11/28 15:53:03 horikawa Stab % +.\" +.\" Copyright (c) 1994, Wilko Bulte +.\" All rights reserved. +.\" +.\" %Id: ie.4,v 1.7 1998/10/22 14:12:55 bde Exp % +.\" +.Dd September 23, 1994 +.Dt IE 4 i386 +.Os +.Sh 名称 +.Nm ie +.Nd +イーサーネットデバイスドライバ +.Sh 書式 +.Cd "device ie0 at isa? port 0x360 net irq 7 iomem 0xd0000" +.Sh 解説 +.Nm ie +ドライバは、8 ビット及び 16ビットの Intel i82586 チップをベースにした、 +ISA イーサネットカードのサポートを提供します。 +これは AT&T の Starlan 10 及び Starlan Fiber、 +EN100、Intel EtherExpress 16、3COM 3C507 及び RACAL Interlan NI5210 +をサポートします。 +.Pp +.Sh 診断 +.Bl -diag +.It "ie%d: unknown board type code %d" +i82586 チップは見つかりましたが、 +ドライバはプローブ中に実際のボードタイプを決定できませんでした。 +.It "ie%d: kernel configured maddr %x doesn't match board configured maddr %x" +デバイスプローブは、 +カーネル設定ファイルに指定された maddr と異なる maddr を検出しました。 +.It "ie%d: can't find shared memory" +デバイスプローブは、 +共有メモリの大きさを得るためのアクセスができませんでした。 +.It "ie%d: kernel configured msize %d doesn't match board configured msize %d" +デバイスプローブは、 +共有メモリの大きさがカーネル設定ファイルに指定されたサイズと異なることを +検出しました。 +.It "ie%d: kernel configured irq %d doesn't match board configured irq %d" +デバイスプローブは、 +ボードの割り込み設定がカーネル設定ファイルに指定された設定と異なることを +検出しました。 +.It "ie%d: reset" +Intel i82586 はドライバによりリセットされる必要がありました。 +.It "ie%d: transceiver problem" +ドライバは、イーサーネットトランシーバに問題を検出しました。 +これは、 +外付けトランシーバを使用しているときにトランシーバケーブルが緩んでいる、 +もしくは破損していることを意味します。 +もしこの問題をカード上のトランシーバで経験した場合には、 +カードが外付けトランシーバを使用するように +誤ってジャンパ設定されているかもしれません。 +最悪の場合、オンボードトランシーバは壊れているかもしれません。 +.It "ie%d: TDR detected an open %d clocks away" +ドライバは、 +イーサーネットケーブルの回路がオープンになっていることを検出しました。 +同軸ケーブルと終点抵抗を確認してください。 +.It "ie%d: TDR detected a short %d clocks away" +ドライバは、 +イーサーネットケーブルが短絡していることを検出しました。 +同軸ケーブルと終端抵抗を確認してください。 +.It "ie%d: TDR returned unknown status %x" +ドライバは、イーサーネットケーブル試験で不明な状態を得ました。 +.It "ie%d: multicast address setup command failed" +カードは、マルチキャストモードに入れませんでした。 +.It "ie%d: configure command failed" +カードは、設定中に正常に応答することを拒否しました。 +.It "ie%d: individual address setup command failed" +イーサネットの MAC アドレスをプログラムすることに失敗しました。 +.El +.Sh 警告 +Racal Interlan NI5210 には、 +共有メモリが 8K バイトのものと 16K バイトのものとがあります。 +16K バイトのものを使用することを強く推奨します。 +8K バイトカードは、追加の RAM チップを加えることにより、 +16K バイトにすることができます。 +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 作者 +.Nm +デバイスドライバは、 +.An William F. Jolitz +及び Lawrence Berkeley Laboratories のコードを基に +.An Garrett A. Wollman +が作成しました。 +.Tn 3C507 +サポートは +.An Charles M. Hannum +が作成しました。 +このマニュアルページは +.An Wilko C. Bulte +が記述しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/io.4 b/ja_JP.eucJP/man/man4/man4.i386/io.4 new file mode 100644 index 0000000000..3f2eb2f255 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/io.4 @@ -0,0 +1,72 @@ +.\" +.\" Copyright (c) 1996 Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" This program is free software. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: io.4,v 1.5 1997/03/21 20:13:45 mpp Exp % +.\" jpman %Id: io.4,v 1.4 2000/07/20 10:04:48 osana Stab % +.\" +.Dd Jan 1, 1996 +.Dt IO 4 i386 +.Os +.Sh 名称 +.Nm io +.Nd I/O 特権ファイル +.Sh 解説 +特殊ファイル +.Pa /dev/io +は制御下にあるセキュリティホールで、 +.Pq 通常はカーネルの内部コードに予約された +I/O 特権を得ることをプロセスに許可します。 +.Pa /dev/io +を開いたファイル記述子を持ったどんなプロセスでも、 +フラグレジスタセットの中の +.Em IOPL +ビットを得ることができます。 +すなわち、直接 I/O を操作することが許されます。 +これは、ハードウェアを直接操作する +ユーザランドのプログラムを書くために役立ちます。 +.Pp +アクセス制御全体は +.Pa /dev/io +のファイルアクセスパーミッションによって管理されていますので、 +このデバイスに正しいパーミッションを与えるように +注意する必要があります。 +読み込み専用のアクセスでさえ、すべての I/O 特権を +与えてしまうことに注意してください。 +.Sh ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/io +.El +.Sh 関連項目 +.Xr mem 4 +.Sh 歴史 +.Nm io +ファイルは +.Fx 1.0 +で登場しました。 + + + diff --git a/ja_JP.eucJP/man/man4/man4.i386/lnc.4 b/ja_JP.eucJP/man/man4/man4.i386/lnc.4 new file mode 100644 index 0000000000..5b044cc178 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/lnc.4 @@ -0,0 +1,124 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: lnc.4,v 1.6 1998/11/06 09:46:02 obrien Exp % +.\" jpman %Id: lnc.4,v 1.3 2000/01/03 03:14:36 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt LNC 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm lnc +.Nd +AMD Lance/PCnet イーサネットデバイスドライバ +.Sh 書式 +.Cd "device lnc0 at isa? port 0x280 net irq 10 drq 0" +.Sh 解説 +.Nm +ドライバは、Am7990 と Am79C960 含む AMD ファミリを利用している +Lance/PCnet Ethernet NIC をサポートするために用意されています。 +.Nm +インタフェースによってサポートされているイーサネットカードは次の通りです: +.Bl -tag -width -offset ident -compat +.It Novell NE2100 +.It Novell NE32-VL +.It Isolan BICC +.It Digital DEPCA +.It Hewlett Packard Vectra 486/66XM +.It Hewlett Packard Vectra XU +.El +.Sh 診断 +.Bl -diag +.It "lnc%d: Framing error" +フレーミングエラーが発生しました。 +これはまた、CRC エラーも発生したことを意味しています。 +この結果、 +ドライバはフレーミングエラーを含んでいるパケットを落としました。 +.It "lnc%d: Receive CRC error" +受信したイーサネットフレームは、CRC チェックサムに失敗しました。 +この結果、 +ドライバがチェックサムに失敗したパケットを落としました。 +.It "lnc%d: Packet dropped, no mbufs" +ドライバは mbuf を使い果してしまいました。 +おそらく資源の問題だと思われます。 +.It "lnc%d: Couldn't allocate memory for NIC" +致命的エラーです。 +この状況下では、カードに対してドライバはアタッチされません。 +.It "lnc%d: Memory allocated above 16Mb limit" +ISA と ESIA カードは、 +16MB 以上の領域に DMA 転送を行うために、バウンスバッファが必要となります。 +Am7990 と Am79C960 のアドレスラインは 24 本しかありませんので、 +物理メモリのうち、下位の 16MB にしかアクセスできません。 +.Nm +ドライバは、自己が割り当てるメモリが下位 16MB の範囲内にあると仮定しています。 +これはあまり妥当な仮定ではありませんが、 +これ以外の方法は今のところ何もできません。 +共有メモリを利用した NIC に関しては関係ありません。 +.It "lnc%d: Device timeout -- Resetting" +デバイスはネットワークに応答するのを停止したか、あるいは、 +ネットワーク接続 (ケーブル) に関する問題が発生しました。 +使用中のネットワーク接続とカードの設定が同じになっているか +どうか確認してください。 +.It "lnc%d: Transmit late collision -- Net error?" +.It "lnc%d: Loss of carrier during transmit -- Net error?" +.It "lnc%d: Transmit of packet failed after 16 attempts -- TDR = %d" +.It "lnc%d: Heartbeat error -- SQE test failed" +.It "lnc%d: Babble error - more than 1519 bytes transmitted" +.It "lnc%d: Missed packet -- no receive buffer" +.It "lnc%d: Memory error -- Resetting" +.It "lnc%d: Couldn't get mbuf for transmit packet -- Resetting" +.It "lnc%d: Receive buffer error" +.It "lnc%d: Receive overflow error" +.It "lnc%d: Receive interrupt with buffer still owned by controller -- Resetting" +.It "lnc%d: Receive interrupt but not start of packet -- Resetting" +.It "lnc%d: Start of packet found before end of previous in receive ring -- Resetting" +.It "lnc%d: End of received packet not found -- Resetting" +.It "lnc%d: Transmit interrupt with buffer still owned by controller -- Resetting" +.It "lnc%d: Transmit interrupt but not start of packet -- Resetting" +.It "lnc%d: Start of packet found before end of previous in transmit ring -- Resetting" +.It "lnc%d: End of transmitted packet not found -- Resetting" +.It "lnc%d: Transmit buffer error -- Resetting" +.It "lnc%d: Transmit underflow error -- Resetting" +.El +.Sh バグ +このドライバは、 +どのイーサネットドライバよりも冗長に作られている可能性があります。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2 +から登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.An Paul Richards +が作成しました。 +このマニュアルページは +.An David E. O'Brien +が書きました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/mcd.4 b/ja_JP.eucJP/man/man4/man4.i386/mcd.4 new file mode 100644 index 0000000000..af9d25bbc9 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/mcd.4 @@ -0,0 +1,151 @@ +.\" +.\" Copyright (c) 1994 Keith E. Walker +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: mcd.4,v 1.6 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: mcd.4,v 1.3 1999/11/19 15:19:56 horikawa Stab % +.\" +.Dd December 8, 1994 +.Dt MCD 4 i386 +.Os FreeBSD 2.0 +.Sh 名称 +.Nm mcd +.Nd Mitsumi CD-ROM ドライバ +.Sh 書式 +.Cd "device mcd0 at isa? port 0x300 bio irq 10" +.Sh 解説 +.Nm mcd +ドライバは Mitsumi 製 CD-ROM プレイヤに対して、データとオーディオの +インタフェースを提供します。 +CD-ROM プレイヤは、Mitsumi 専用のコントローラ +ボードの 1 つを経てISA バスに接続されていることが必要です。 +サポートされているコントローラボードは LU002S, LU005S, FX001, そして一般的な +FX001D です。 +.Pp +.Nm mcd +ドライバはディスク固有の +.Fn ioctl +コマンド、すなわち +.Dv DIOCGDINFO , +.Dv DIOCGPART , +.Dv DIOCWDINFO , +.Dv DIOCSDINFO , +コマンドに対して応答します。 +他のディスク固有の +.Fn ioctl +コマンドにはエラーを返すものもあるでしょう。 +.Pp +.Nm mcd +ドライバは、特別な CD-ROM +.Fn ioctl +コマンドに対しても応答します。これらのコマンドは、CD-ROM プレイヤの +オーディオ機能を制御します。 +コマンドは次の通りです: +.Pp +.Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent +.It CDIOCREADSUBCHANNEL +ディスクを再生中の現在の状態におけるサブチャネルの情報を取得します。 +.It CDIOCREADTOCHEADER +目次ヘッダを取得します。 +.It CDIOCREADTOCENTRYS +全ての目次を取得します。 +.It CDIOCPLAYTRACKS +指定された位置において、オーディオ再生を始めます。 +.It CDIOCPLAYBLOCKS +.Dv EINVAL +エラーで失敗します。 +.It CDIOCPLAYMSF +指定された位置において、オーディオ再生を始めます。 +.It CDIOCRESUME +あらかじめ一時停止したディスクの再生をレジュームします。 +.It CDIOCPAUSE +ディスクの再生を一時停止します。 +.It CDIOCSTART +ディスク再生を始めます。 +.It CDIOCSTOP +あらかじめ再生中のディスクを停止します。 +.It CDIOCEJECT +ディスクトレーをオープンします +(クローズするコマンドはサポートされていません)。 +.It CDIOCRESET +あらゆる再生を停止し、Mitsumi コントローラボードをリセットします。 +.It CDIOCSETDEBUG +カーネルは +.Nm mcd +ドライバについてのデバッグメッセージをコンソールに出力します。 +.It CDIOCCLRDEBUG +カーネルは +.Nm mcd +ドライバについてのデバッグメッセージの出力を終了します。 +.El +.Pp +上記で定義した +.Fn ioctl +コマンドは +.Nm mcd +ドライバがサポートするコマンドだけです。( +.Dv CDIOCSETVOL +や +.Dv CDIOCSETSTERIO +のような) CD-ROM 関連 +.Fn ioctl +コマンドも存在しますが、そのようなコマンドは +ドライバの将来のバージョンでサポートされるかも知れません。 +.Sh 関連ファイル +.Bl -tag -width /dev/(r)mcd0a -compact +.It Pa /dev/(r)mcd0a +ディスク上の BSD パーティションにアクセスします。通常、CD-ROM ディスク +上に存在するファイルシステムは単一です。 +.It Pa /dev/(r)mcd0c +raw デバイスにアクセスします。 +.El +.Sh 注 +.Nm mcd +ドライバのキャラクタモードデバイスは、 +オーディオ機能に限定してアクセスするために使うべきです。 +データ機能にアクセスすると、性能がひどく悪いからです。 +.Pp +ドライバの現在のバージョンは、生成されたあらゆる IRQ に対して割り込み +ハンドラを保持しているにもかかわらず、インタフェースボードの DMA と +IRQ 機能のどちらも用いていません。 +ともかく DMA 機能がサポートされるまで、ボード +の生成する割り込みだけはドライバによってサポートされません。 +.Sh 関連項目 +.Pa /usr/include/sys/cdio.h +.Sh 作者 +ドライバは +.An Holger Veit +(データ部分) 及び +.An Brian Moore +(オーディオ部分) が書きました。それに対する変更が +.An Gary Clark II , +.An Andrew A. Chernov , +.An Jordan K. Hubbard +によって提供されました。 +.Sh 歴史 +.Nm mcd +ドライバは +.Fx 1.0 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/npx.4 b/ja_JP.eucJP/man/man4/man4.i386/npx.4 new file mode 100644 index 0000000000..92bbfa1162 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/npx.4 @@ -0,0 +1,79 @@ +.\" +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software withough 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. +.\" +.\" from: npx.4,v 1.1 1993/08/06 10:58:03 cgd Exp +.\" %Id: npx.4,v 1.5 1998/10/22 14:22:13 bde Exp % +.\" jpman %Id: npx.4,v 1.3 1999/08/15 14:20:56 horikawa Stab % +.\" +.\" WORD: Numeric Processing Extension coprocessor 数値演算コプロセッサ +.\" +.Dd August 28, 1993 +.Dt NPX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm npx +.Nd 数値演算コプロセッサとエミュレータ +.Sh 書式 +.Cd "options MATH_EMULATE" +.\" XXX this is awful hackery to get it to work right... -- cgd +.Cd "device npx0 at isa? port IO_NPX tty irq 13" +.Sh 解説 +.Nm npx +ドライバは、システムに数値演算コプロセッサがあれば、 +それを利用できるようにします。 +拡張数値演算機能 (NPX) は、 +.Sy 486DX +CPU を使ったシステムや、 +.Sy 387 +または +.Sy 487SX +コプロセッサを使ったシステムに存在します。 +.Nm npx +ドライバは NPX が存在するか否かに関わらず、 +システムが正常に動作するために必要です。 +.Pp +もし NPX がシステムに存在しない場合には、 +カーネル設定ファイルに "MATH_EMULATE" オプションが +記述されていることが必要です。 +これにより、通常は NPX で実行される命令がサポートされます。 +システムに NPX が存在せず、カーネルが数学エミュレーションを付けずに +構築されている場合には、システムは起動しません。 +.Sh 警告 +エミュレータは NPX コプロセッサと比べて非常に遅いです。 +そのため、エミュレータを使わなければならないときには、 +浮動小数点演算の性能が悪くなります。 +.Sh バグ +たくさんあります。特に安っぽいマザーボード上で使った時にはそうです。 +NPX から CPU への割り込みラインが正しく結線されていない +マザーボードがあります。 +もしこのような場合に、システムが常に正常な動作をすることを望むならば、 +エミュレータを使うことが必要です。 +.Pp +超越関数命令のエミュレーションは不正確です。 +それ以外の命令のエミュレーションも怪しいです。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/pcf.4 b/ja_JP.eucJP/man/man4/man4.i386/pcf.4 new file mode 100644 index 0000000000..93481c0775 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/pcf.4 @@ -0,0 +1,65 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: pcf.4,v 1.3 1999/09/11 08:14:22 horikawa Stab % +.Dd August 6, 1998 +.Dt PCF 4 +.Os FreeBSD +.Sh 名称 +.Nm pcf +.Nd +Philips I2C バスコントローラ +.Sh 書式 +.Cd "controller pcf0 at isa? port? irq 5" +.Pp +1 つ以上の iicbus バスに対し +.Cd "controller iicbus0" +.Sh 解説 +.Em pcf +ドライバは +.Xr iicbus 4 +システム用の Philips PCF8584 I2C コントローラのサポートを提供します。 +.Pp +PCF8584 は CMOS テクノロジで設計された集積回路であり、 +ほとんどの標準的なパラレルバスマイクロコントローラ/マイクロプロセッサと +シリアル I2C バスとの間のインタフェースを提供します。 +PCF8584 はマスタとスレーブの両方の機能を提供します。 +I2C バスとの通信は割り込みかポーリングハンドシェークを使い、 +バイトを基本として実行されます。 +また、I2C バス特有のシーケンス、プロトコル、調停、タイミングの全てを +制御します。 +PCF8584 はパラレルバスシステムの I2C バスとの双方向通信を可能にしています。 +.Pp +.Sh 関連項目 +.Xr iicbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/perfmon.4 b/ja_JP.eucJP/man/man4/man4.i386/perfmon.4 new file mode 100644 index 0000000000..58f9694811 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/perfmon.4 @@ -0,0 +1,225 @@ +.\" +.\" Copyright 1996 Massachusetts Institute of Technology +.\" +.\" Permission to use, copy, modify, and distribute this software and +.\" its documentation for any purpose and without fee is hereby +.\" granted, provided that both the above copyright notice and this +.\" permission notice appear in all copies, that both the above +.\" copyright notice and this permission notice appear in all +.\" supporting documentation, and that the name of M.I.T. not be used +.\" in advertising or publicity pertaining to distribution of the +.\" software without specific, written prior permission. M.I.T. makes +.\" no representations about the suitability of this software for any +.\" purpose. It is provided "as is" without express or implied +.\" warranty. +.\" +.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS +.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, +.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT +.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: perfmon.4,v 1.6 1998/03/12 07:30:36 charnier Exp % +.\" jpman %Id: perfmon.4,v 1.3 2000/08/10 13:48:05 horikawa Stab % +.Dd March 26, 1996 +.Dt PERFMON 4 i386 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm perfmon +.Nd CPU の性能モニタリングをするインタフェース +.Sh 書式 +.Cd cpu \&"I586_CPU\&" +.Cd cpu \&"I686_CPU\&" +.Cd options PERFMON +.Sh 解説 +.Nm perfmon +ドライバにより +.Tn Intel +の +.Tn Pentium +と +.Tn "Pentium Pro" +の +CPU 内部の性能モニタリング機能にアクセスできます。 +これらのプロセッサには多彩なイベントについて発生回数または +(CPU サイクルでの) 持続時間のどちらかを測定するように設定できる +2 個の内部カウンタと、同じくクロックサイクルを数える +1 個のサイクルカウンタが実装されています。 +.Nm +ドライバではこれらの機能に対してデバイス形式によるインタフェースを提供 +します。 +.Pp +性能モニタリングをするカウンタへの全てのアクセスは +デバイス型特殊ファイルの +.Dq Pa /dev/perfmon +を媒介として処理されます。 +このデバイスが提供する +.Xr ioctl 2 +リクエストは多くあり +.Aq Pa machine/perfmon.h +の中で定義され、このファイルの中には +.Tn Pentium +と +.Tn "Pentium Pro" +プロセッサの両方の色々なカウンタの定義もあります。 +.Pp +.Sy 注意事項: +利用可能なイベントの集合はプロセッサ毎に異なります。 +使用されるイベントコードが測定される CPU の型式に対して +適正であることを確認することはプログラマの責任です。 +.Pp +以下の +.Xr ioctl 2 +リクエストが定義されています: +.Bl -tag -width PMIOTSTAMP +.It Dv PMIOSETUP +.Pq Li "struct pmc" +構造体に定義されているパラメータとフラグでカウンタを設定します。 +以下のフィールドが +.Li struct pmc +に定義されています: +.Bl -tag -width "u_char pmc_eventx" +.It Li "int pmc_num" +指定するカウンタ番号です。 +.Dv NPMC +(現在は 2) より小さくなければなりません。 +.It Li "u_char pmc_event" +モニタすべき特定のイベントコードで、 +.Aq Pa machine/perfmon.h +に定義されています。 +.It Li "u_char pmc_unit" +イベントの型に対応する装置のマスクの値です ( +.Tn Intel +の文書を参照)。 +.It Li "u_char pmc_flags" +カウンタの働きを変更するフラグ (下記参照) です。 +.It Li "u_char pmc_mask" +カウンタのマスクの値です。つまり、本来、この値は指定された数のクロック +以上 (又は以下) の間継続するイベントにカウントを制限する為に使用されるしきい値 +です。 +.El +.Pp +次のような +.Li pmc_flags +の値が定義されています: +.Bl -tag -compact -width PMCF_USRxx +.It Dv PMCF_USR +イベントをユーザモードでカウントします。 +.It Dv PMCF_OS +イベントをカーネルモードでカウントします。 +.It Dv PMCF_E +イベントを持続時間ではなくその数でカウントします。 +.It Dv PMCF_INV +カウンタのマスクの比較の意味を逆転します。 +.El +.It Dv PMIOGET +.Pq Li "struct pmc" +指定されたカウンタの現在の設定を返します。 +.It Dv PMIOSTART +.It Dv PMIOSTOP +.Pq Li int +指定したカウンタを起動 (停止) します。ハードウェアの欠陥により、番号順に +起動と停止をしなければなりません。 +(即ち、カウンタ 0 は必ずまずカウンタ 1 を停止してから停止しなければなりません)。 +ドライバではこの制約を +.Sy 強制していません +(と言うのも将来の CPU ではこの制約はなくなるかも知れません)。 +.It Dv PMIORESET +.Pq Li int +指定されたカウンタを 0 にリセットします。カウンタはリセットする前に +.Dv PMIOSTOP +により停止されなければなりません。全てのカウンタは自動的に +.Dv PMIOSETUP +によってリセットされます。 +.It Dv PMIOREAD +.Pq Li "struct pmc_data" +カウンタの現在の値を取り出します。 +.Li pmc_data +構造体には次のような 2 個のフィールドが定義されています: +.Pp +.Bl -tag -compact -width "quad_t pmcd_value" +.It Li "int pmcd_num" +読み出すカウンタの番号。 +.It Li "int pmcd_value" +64 ビットの符号付き整数での終了値。 +.El +.Pp +将来、 +.Tn "Pentium Pro" +プロセッサから +カウンタを直接読み出す為に +.Li RDPMC +命令を使用出来る様になるでしょう。 +.It Dv PMIOTSTAMP +.Pq Li "struct pmc_tstamp" +タイムスタンプカウンタを読み出します。 +.Li pmc_tstamp +構造体では 2 個のフィールドが定義されています: +.Pp +.Bl -tag -compact -width "quad_t pmct_value" +.It Li "int pmct_rate" +カウンタの MHz でのおおよその速度です。 +.It Li "quad_t pmct_value" +64 ビット整数でのカウンタの現在の値です。 +.El +.Pp +.Li pmct_rate +フィールドに与えられるカウンタの速度は、 +校正が困難な事やクロックの進行が不完全な為に、 +往々にして正確ではないことに注意する事が大切です。 +このフィールドについては +クロックが刻む速度を実際に表示するものというよりも +手がかりか又は適正さの検査くらいに考えるべきです。 +.El +.Sh 関連ファイル +.Bl -tag -compact -width "/usr/include/machine/perfmon.h" +.It Pa /dev/perfmon +カウンタへの文字型デバイスのインタフェース +.It Pa /usr/include/machine/perfmon.h +構造体とイベントコードを定義しているインクルードファイル +.It Pa /usr/share/examples/perfmon +全ての +.Fn ioctl +コマンドの使用を具体的に例示したサンプルのソースコード +.El +.Sh 関連項目 +.Xr ioctl 2 +.Rs +.%A Intel Corporation +.%B Pentium Pro Family Developer's Manual +.%D January 1996 +.%V vol. 3 +.%O Operating System Writer's Manual +.Re +.\"訳者注開始 +.Rs +.%A インテルジャパン株式会社 +.%B Pentium Pro ファミリー ディベロッパーズ マニュアル +.%D January 1996 +.%V 下巻 +.%O オペレーティング システム ライターズ マニュアル +.Re +.\"訳者注終り +.Sh 歴史 +The +.Nm +デバイスは +.Fx 2.2 +で初めて現れました。 +.Sh 作者 +.Nm +ドライバは +.An Garrett A. Wollman , +MIT Laboratory for Computer Science +が書きました。 +.\"Translated by Tetsuro Furuya , Dec. 1999. +.\"ML Checked by Tetsuya Isaki (井崎哲也) , +.\" Satoru Koizumi (小泉 悟 ) +.\"Final Checked by diff --git a/ja_JP.eucJP/man/man4/man4.i386/pnp.4 b/ja_JP.eucJP/man/man4/man4.i386/pnp.4 new file mode 100644 index 0000000000..9b20c43719 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/pnp.4 @@ -0,0 +1,221 @@ +.\" pnp(4) - manual page for the scanner device driver `asc' +.\" +.\" +.\" Copyright (c) 1997 Luigi Rizzo +.\" +.\" 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 acknowledgements: +.\" This product includes software developed by Luigi Rizzo. +.\" 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. +.\" +.\" %Id: pnp.4,v 1.2 1998/03/12 07:30:36 charnier Exp % +.\" +.\" Based on Japanese translation by Yasuhito FUTATSUKI +.\" [man-jp 1426] +.\" jpman %Id: pnp.4,v 1.3 2000/08/31 20:36:14 kuma Stab % +.\" +.Dd September 7, 1997 +.Dt PNP 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm pnp +.Nd PnP デバイスのサポート +.Sh 書式 +.Cd controller pnp0 +.Sh 解説 +.Fx +の PnP デバイスサポートによって、ユーザが PnP カードの設定を +強制設定することが可能になります。また、デバイスドライバが PnP カードの +パラメータを取得・変更することが可能になります。 +.Pp +手動で強制設定する機能を用いるためには、カーネルを +.Cd options USERCONFIG +付きでコンパイルする必要があります。 +このときカーネルは、PnP デバイスの設定を記録するための +一定の大きさのテーブル (デフォルトで 20 エントリ) を確保します。 +PnP カード 1 つが複数の独立したデバイスから構成されている +こともあります (5 つ 6 つもあるということは異常ではありません)。 +.Pp +カーネルを +.Dq Fl c +フラグ付きでブートすることで、 +PnP カードの設定変更のコマンドを使用できます。コマンドは +.Dl pnp CSN LDN +というシーケンスから始まります。ここで、CSN ならびに LDN は +それぞれ、デバイスに振られているカード選択番号 +.Pq Card Select Number +および論理デバイス番号 +.Pq Logiacal Device Number +です。 +このシーケンスに続けて、以下のコマンドの任意の組み合わせが使えます。 + +.Bl -tag -width "mmmmmmmmmm"" +.It Dv irqN Ar line +カード上の割り込み 0 または 1 +.Pq 訳注: N で指定 +に使用する IRQ 線を設定します。 +.Ar line +に 0 を指定することは、IRQ 線を使用しないことを意味します。 +.It Dv drqN Ar n +カード上の DMA 0 または 1 +.Pq 訳注: N で指定 +に使用する DRQ チャネルを設定します。 +チャネルに 4 を指定することは、チャネルを使用しないことを意味します。 +.It Dv portN Ar address +N 番目のポート領域 +.Pq port's range +の基底アドレス +.Pq base address +を設定します (N=0..7)。 +.Ar address +に 0 を指定することは、ポートを使用しないことを意味します。 +.It Dv memN Ar address +N 番目のメモリ領域 +.Pq memory's range +の基底アドレス +.Pq base address +を設定します (N=0..3)。 +.Ar address +に 0 を指定することは、メモリ領域を使用しないことを意味します。 +.It Dv bios +PnP デバイスの設定として、BIOS が設定したものを使用します。 +これはデフォルトであり、 +BIOS が PnP をサポートしている場合には通常はこれでよいでしょう。 +BIOS 設定を使用する場合には +.Dq Dv flags +以外のパラメータは無視されます。 +.It Dv os +PnP デバイスの設定に、このエントリで指定したものを使用します。 +.It Dv enable +PnP デバイスを有効にします。 +.It Dv disable +PnP デバイスを無効にします。 +.It Dv delete +デバイスに使用されているエントリを開放し、別の CSN/LDN の組を持つ +他のデバイスで使用できるようにします。 +.It Dv flags +デバイスドライバに渡す 32 ビットの flags エントリの値を設定します。 +flags は、特別な動作モードを指定するのに使われることがあります。 +(例えば、ある種のサウンドカードで SB と WSS のエミュレーションを +切り替える、など) +.El +.Pp +現在のテーブル内の設定値は、userconfig の +.Ic ls +コマンドで表示されます。 +このテーブルは、ユーザが行なった変更に加え、 +PnP デバイスドライバがアクセスしたすべての論理デバイスのエントリを +保持します。 +.Pp +テーブルの変更結果は、 +.Xr dset 8 +コマンドによってファイルシステム上のブートイメージに保存されます。 +.Pq 訳注: カーネルの ELF 化により dset コマンドは廃止されました +.Pp +.Sh PnP をサポートするデバイスドライバ +カーネルは PnP デバイスを自動的に認識して設定します。 +PnP デバイスは以下のデータ構造で識別します。 +.Bd -literal +struct pnp_device { + char *pd_name; + char *(*pd_probe ) (u_long csn, u_long vendor_id); + void (*pd_attach ) (u_long csn, u_long vend_id, char * name, + struct isa_device *dev); + u_long *pd_count; + u_int *imask; + struct isa_device dev; +}; +.Ed +.Pp +プローブ (probe) ルーチンは、渡される vendor_id が自分が +認識するものであるか、 +カード中の必要なデバイスが有効になっているかをチェックし、 +チェックに +失敗した場合には NULL 値を、成功した場合には NULL でない値 +(一般にデバイス名を指すポインタ) を返します。 +プローブルーチン内において、論理デバイスが有効であるかどうかの +チェックには、 +.Fn read_pnp_parms +を使用できます。 +.Pp +アタッチ (attach) ルーチンは、 +PnP カードを ISA アクセス可能にする、 +設定を取得する、デバイスの ISA ドライバを呼ぶ、 +といった必要な初期化をすべて行うことが必要です。 +.Pp +次のルーチンとデータ構造が使用できます。 +.Bl -tag -width "xxxxxxxxxx" +.It Dv struct pnp_cinfo +このデータ構造 +.Po +.Pa /usr/i386/isa/pnp.h +で定義されている +.Pc +は、 +PnP 論理デバイスに関連するすべての情報を含んでいます。 +.It Fn read_pnp_parms "struct pnp_cinfo *d" "int ldn" +この関数は要求された論理デバイスの設定を返します。 +この関数はプローブおよびアタッチの +ルーチンから呼ばれることだけを想定しているため、 +CSN を指定することはできません。 +.It Fn write_pnp_parms "struct pnp_cinfo *d" "int ldn" +この関数は要求された論理デバイスのパラメータを設定します。 +同時に、カーネルの強制設定用テーブルのエントリを更新します。 +BIOS や (userconfig を使用する) ユーザの方が、 +どうパラメータを設定すべきかをよく知っているはずなので、 +デバイスドライバは通常デバイスの設定を変更すべきでは +.Em ありません。 +特に、 +userconfig による強制設定メカニズムを破綻させてしまうため、 +無効になっている論理デバイスを +.Em 有効にしてはなりません。 +デバイスドライバは論理デバイスやポート領域などを無効にしても +かまいませんが、これは、 +特定のデバイスやパラメータが問題を起こすことがわかっている場合に +限るべきです。 +.It Fn enable_pnp_card void +この関数はアタッチルーチン内部で +.Em のみ、 +カードの ISA ポート/メモリのアドレス領域にアクセスする前に +.Em 呼ばなければなりません。 +.El +.Pp +.Sh 関連項目 +.Xr dset 8 +.Pq 訳注: 廃止されました +.Sh バグ +ビジュアルコンフィギュレーションには、PnP デバイス設定のサポートが +ありません。 +userconfig のコマンドで PnP デバイスの設定を取得することができれば +素晴らしいことでしょう。 +.Sh 作者 +PnP サポートは +.An Sujal Patel +が初めに手掛けたものを元に、 +.An Luigi Rizzo +が書きました。 +.Sh 歴史 +.Nm +は +.Fx 2.2.5 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/scd.4 b/ja_JP.eucJP/man/man4/man4.i386/scd.4 new file mode 100644 index 0000000000..afac49411a --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/scd.4 @@ -0,0 +1,65 @@ +.\" +.\" Copyright (c) 1995 Jordan K. Hubbard +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: scd.4,v 1.6 1998/03/12 07:30:37 charnier Exp % +.\" jpman %Id: scd.4,v 1.3 1999/11/19 15:19:24 horikawa Stab % +.\" +.Dd January 1, 1995 +.Dt SCD 4 i386 +.Os FreeBSD 2.0.5 +.Sh 名称 +.Nm scd +.Nd Sony CDU31/33 CD-ROM ドライバ +.Sh 書式 +.Cd "device scd0 at isa? port 0x230 bio" +.Sh 解説 +.Nm scd +ドライバは Sony CDU31 及び CDU33A CD-ROM ドライブに対する +データインタフェースを提供します。 +ドライブは、 +Sony 固有のインタフェースカードか互換カードに接続する必要があります。 +.Sh 関連ファイル +.Bl -tag -width /dev/[r]scd0a -compact +.It Pa /dev/[r]scd0a +ディスク上の BSD パーティションにアクセスします。通常、CDROM ディスク +上には単一のファイルシステムのみ存在します。 +.It Pa /dev/[r]scd0c +raw デバイスにアクセスします。 +.Sh 関連項目 +.Pa /sys/i386/isa/scd.c +.Sh 作者 +本ドライバは、 +.An Holger Veit +と +.An Brian Moore +が寄贈したコードを用いて、 +.An Mikael Hybsch +が書きました。 +.Sh 歴史 +.Nm scd +ドライバは +.Fx 2.0.5 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/spkr.4 b/ja_JP.eucJP/man/man4/man4.i386/spkr.4 new file mode 100644 index 0000000000..9650f2401c --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/spkr.4 @@ -0,0 +1,234 @@ +.\" +.\" %Id: spkr.4,v 1.10 1998/03/12 07:30:38 charnier Exp % +.\" jpman %Id: spkr.4,v 1.3 1999/08/15 14:20:39 horikawa Stab % +.\" +.Dd November 7, 1993 +.Dt SPKR 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm speaker , +.Nm spkr +.Nd コンソールスピーカのデバイスドライバ +.Sh 書式 +.Cd pseudo-device speaker +.Fd #include +.Sh 解説 +スピーカデバイスドライバは、 +.Tn FreeBSD +が走っている +.Tn IBM-PC +互換 PC 上で、 +アプリケーションがコンソールスピーカを制御できるようにします。 +.Pp +いかなるときでも、このデバイスをオープンできるのは +ただ 1 つのプロセスだけです。 +このため、このデバイスのロックと解放には、 +.Xr open 2 +と +.Xr close 2 +を使用します。 +他のプロセスがデバイスを独占している時にオープンしようとすると、 +.Er EBUSY +エラーを示して -1 を返します。 +デバイスへの書き込みは、 ASCII 文字で単純にメロディを表記した +演奏文字列 (`play string') として解釈されます。 +.Xr ioctl 2 +リクエストによる任意の周波数の発音もサポートされています。 +.Pp +発音することでプロセッサを独占することはありません。 +実際には、ドライバは PC ハードウェアが音を発している間の +ほとんどの時間をスリープして待っています。 +他のプロセスはドライバが走っている間にビープを鳴らすことができます。 +.Pp +アプリケーションは、スピーカのファイル記述子に対して +.Xr ioctl 2 +呼び出しをすることにより、スピーカドライバを直接制御可能です。 +.Xr ioctl 2 +インタフェースについての定義は +.Pa /usr/include/machine/speaker.h +にあります。 +これらの呼び出しに使われる +.Li tone_t +構造体には、 +周波数 (ヘルツ) と持続時間 (1/100 秒単位で) を指定する +2 つのフィールドがあります。 +周波数 0 は、休符と解釈されます。 +.Pp +現在そのような +.Xr ioctl 2 +呼び出しは 2 つあります。 +.Dv SPKRTONE +は、第 3 引数に単一の tone 構造体へのポインタ 1 個を受け取り、 +それを演奏します。 +.Dv SPKRTUNE +は、単一の tone 構造体配列の先頭へのポインタ 1 個を受け取り、 +それらを順番に演奏します。 +この配列は末尾が持続時間 0 のメンバで終っていることが必要です。 +.Pp +演奏文字列の語法は +.Tn IBM +Advanced BASIC 2.0 の PLAY 文の習慣を模倣しています。 +PLAY 文の +.Li MB , +.Li MF , +.Li X +要素は時分割環境では役に立たないため除かれます。 +`オクターブ追従' 機能とスラー記号は新しく追加されたものです。 +.Pp + 7 オクターブ 84 音が使用可能で 1-84 の番号がついています。 +.\" 原文では 1-83 となっている。 send-pr 済み。 +それぞれのオクターブは C から B まで続いていて 0-6 の番号がついています。 +音階は A440 に合わせて調律されていて、オクターブ 3 は真中の C から始まります。 +デフォルトでは演奏機能は半秒の音符を発音し、そのうち最後の 1/16 秒は休みます。 +.Pp +演奏文字列は左から右へと、演奏コマンドグループの連続として解釈されます。 +大文字小文字は区別されません。演奏コマンドグループは次の通りです: +.Bl -tag -width CDEFGABxx +.It Li CDEFGAB +A から G までの文字は対応する音を現在のオクターブで鳴らします。 +音符文字にはオプションで、 # + - のうちいずれかひとつの +.Dq Em "臨時記号" +を続けることができます。このうち最初の 2 つは音を半音高くし、 +最後のものは音を半音低くします。 +また音符文字の後には音長を表す数字と付点記号 (後述) をつけることもできます。 +音長は次の L コマンドの場合と同様に解釈されます。 +.It Ns Li O Sy n +もし +.Sy n +が数字なら、以後のオクターブを設定します。 +.Sy n +に +.Li L +または +.Li N +のいずれかを指定することにより、 +オクターブ追従を有効または無効にすることができます +(デフォルトでは無効です)。 +オクターブ追従が有効になっている時は、1 組の音符を解釈すると、 +音符間での音程の差が最小になるように必要に応じてオクターブが変化します。 +したがって、 ``olbc'' は ``olb>c'' のように、 +``olcb'' は ``olc と < と O[0123456] に続く、1 音符については無効です。 +(オクターブ追従機能は +.Tn IBM +BASIC ではサポートされていません。) +.It Li > +現在のオクターブを 1 つ上げます。 +.It Li < +現在のオクターブを 1 つ下げます。 +.It Ns Li N Sy n +音符 +.Sy n +を演奏します。 +.Sy n +は 1 から 84 か、現在の音長の休符として 0 です。 +付点記号を続けることもできます。 +.It Ns Li L Sy n +音符の音長を設定します。デフォルトは +.Li L4 +で、四分音符です。 +この値は 1 から 64 までが認められます。 +.Li L1 +は全音符に、 +.Li L2 +は二分音符に、 +.Li L4 +は四分音符に、などと設定されます。 +.It Ns Li P Sy n +.Sy n +を +.Ns Li L Sy n +と同様に解釈した休符です。付点記号をつけることもできます。 +.Li ~ +と書くこともできます。 +.It Ns Li T Sy n +1 分あたりの四分音符の数を設定します。デフォルトは 120 です。 +よくあるテンポの音楽名: + +.Bd -literal -offset indent + テンポ 分あたり拍数 +とても遅い Larghissimo + Largo 40-60 + Larghetto 60-66 + Grave + Lento + Adagio 66-76 +遅い Adagietto + Andante 76-108 +中くらい Andantino + Moderato 108-120 +速い Allegretto + Allegro 120-168 + Vivace + Veloce + Presto 168-208 +とても速い Prestissimo +.Ed +.It Li M[LNS] +調音を設定します。 +.Li MN +.Ns No ( Li N +は普通 (normal) を示します) がデフォルトで、音符の最後 1/8 を休みます。 +レガート (休みなし) にするには +.Li ML +を、スタッカート (1/4 休む) にするには +.Li MS +を設定できます。 +.El +.Pp +音符 (つまり +.Li CDEFGAB +または +.Li N +コマンド文字グループ) には付点記号 (.) を続けることができます。 +.\" dot とは . であるが日本語では明示しないとわからない +それぞれの付点記号は 1 つにつき、音符の音長を 1.5 倍にします。 +したがって、付点記号が 1 つついた音符はついていないものの 3/2 の音長に、 +2 つついた音符は 9/4 の音長に、 +3 つついた音符は 27/8 の音長になります。 +.Pp +音符と付点記号にはスラー記号 (_) を続けることができます。 +これによって音符の後に普段ある小さな休みが埋められて、 +音符を次の音符にスラーでつなげます。(スラー機能は +.Tn IBM +BASIC ではサポートされていません。) +.Pp +演奏文字列中の空白は単に飛ばされるので、 +楽節を分けるのに使うことができます。 +.Sh バグ +音程テーブルの丸めや、発音ハードウェアやタイマハードウェアの +こぼれ (どちらも精度を考慮していない) のため、 +音程の正確さやタイミングは数学的に厳密ではありません。 +音量調節はありません。 +.Pp +2 つ以上の付点記号の動作は標準的な音楽記号を反映していません。 +標準的には、それぞれの付点記号は前の付点の半分だけ音長を長くするのであり、 +付点によって修正された音符の半分ではありません。 +つまり、付点記号が 1 つついた音符はついていないものの 3/2 の音長に、 +2 つついた音符は 7/4 の音長に、 +3 つついた音符は 15/8 の音長になります。 +それでも、3/2 倍にする解釈は +.Tn IBM +BASIC マニュアルに記されているため、 +互換性のためにそのままにしています。 +.Pp +非常に長い (システムの物理 I/O ブロックよりも長い) 演奏文字列では、 +ブロック境界をまたがるために、 +音符の修飾や数値が時々間違って解釈されることがあります。 +.Sh 関連ファイル +.Bl -tag -width /dev/speakerxx +.It Pa /dev/speaker +スピーカデバイスファイル +.El +.Sh 関連項目 +.Xr spkrtest 8 +.Sh 作者 +.An Eric S. Raymond Aq esr@snark.thyrsus.com +1990 年 6 月 +.Sh 移植者 +.An Andrew A. Chernov Aq ache@astral.msk.su +.Sh 歴史 +.Nm +デバイスは +.Fx 1.0 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/sr.4 b/ja_JP.eucJP/man/man4/man4.i386/sr.4 new file mode 100644 index 0000000000..d2d885505c --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/sr.4 @@ -0,0 +1,119 @@ +.\" +.\" Copyright (c) 1996 John Hay. 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 John Hay. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY John Hay ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL John Hay BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: sr.4,v 1.10 1998/10/22 14:12:55 bde Exp % +.\" +.\" jpman %Id: sr.4,v 1.3 2000/08/27 09:00:10 koich Stab % +.Dd July 4, 1996 +.Dt SR 4 i386 +.Os +.Sh 名称 +.Nm sr +.Nd 同期 RISCom/N2 / WANic 400/405 デバイスドライバ +.Sh 書式 +.Cd "device sr0 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Cd "device sr1 at isa? port 0x310 net irq 11 flags 0x1 iomem 0xd0000" +.Pp +.Cd "pseudo-device sppp" +.Sh 解説 +.Nm sr +ドライバは、HD64570 チップを使用した、 +RISCom/N2 ISA カードと WANic 400/405 PCI カードをサポートします。 +.Pp +リンクレベルの層に、標準の +.Tn FreeBSD +sppp コードを使用します。 +デフォルトのプロトコルは PPP です。 +Cisco HDLC プロトコルは +.Xr ifconfig 8 +に +.Em link2 +を追加することによって使用できます。 +.Pp +.Em flags +フィールドは省略可能です。省略した場合、ドライバは次のように仮定します: +.Pp +.Bl -hang -offset indent +.It "カードには 2 ポートあります。" +.It "シリアルポートのクロックは外部のものを使用しており、" +送信と受信のクロックは同じです。 +.El +.Pp +.Em flags +はビットフィールドであり、デフォルト以外の動作をさせるために使用します。 +.Pp +.Bl -hang -offset indent +.It Em 0x01 +カードには 1 ポートだけあります。 +.It Em 0x10 +ポート 0 で、送信と受信で別々の外部クロックを使用します。 +.It Em 0x40 +ポート 1 で、送信と受信で別々の外部クロックを使用します。 +.El +.Pp +.Sh 番号 +カーネル設定ファイルでは、カード毎に 1 行のみが必要です。 +最初のカードのポートは sr0 から振られます。 +次のカードの番号は、最初のカードの終った所から続けられます。 +つまり、もし最初のカードが 2 ポートのカードなら、そのカードは sr0 と sr1 +を使います。そして次のカードは sr2 から始まります。 +.Pp +カードは IRQ 3, 4, 5, 7, 10, 11, 12, 15 のみをサポートします。 +.Pp +iomem 領域は、16Kb ブロックであり、16Kb 境界から始まる必要があります。 +.Pp +.Sh 診断 +.Bl -diag +.It "sr%d: Warning illegal interrupt %d." +カードが指定された割り込みを使用できません。他の割り込みを選んでください。 +.El +.Sh 関連ファイル +.Bl -tag -width /sys/i386/isa/ic/hd64570.h -compact +.It Pa /sys/i386/isa/ic/hd64570.h +.It Pa /sys/i386/isa/if_srregs.h +.It Pa /sys/i386/isa/if_sr.c +.It Pa /sys/pci/if_sr_p.c +.El +.Sh バグ +現時点で X.21 インタフェースだけを試験しています。 +他のものでは、クロック選択コードを微調整する必要があるでしょう。 +.Pp +このコードには、おそらく最適化の余地があります。 +.Sh 関連項目 +.Xr ar 4 , +.Xr cx 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr lsdev 8 +.Sh 作者 +.Nm sr +デバイスドライバは +.An John Hay Aq jhay@FreeBSD.org +が作成しました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/vx.4 b/ja_JP.eucJP/man/man4/man4.i386/vx.4 new file mode 100644 index 0000000000..331b3c2ce6 --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/vx.4 @@ -0,0 +1,102 @@ +.\" +.\" Copyright (c) 1996, Fred Gray +.\" 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 David Greenman. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: vx.4,v 1.7 1998/03/12 07:30:39 charnier Exp % +.\" jpman %Id: vx.4,v 1.3 1999/08/15 14:20:25 horikawa Stab % +.\" +.Dd January 15, 1996 +.Dt VX 4 i386 +.Os +.Sh 名称 +.Nm vx +.Nd +PCI イーサネットデバイスドライバ +.Sh 書式 +.Cd "device vx0" +.Sh 解説 +.Nm vx +ドライバは、 +3Com の 3c590 と 3c595、すなわち EtherLink III と Fast EtherLink III の +PCI イーサネットカードを、10 Mbps モードでサポートします。 +次の +.Xr ifconfig 8 +コマンドへの link フラグによって、媒体を選択可能です。 +.Pp +.Bl -tag -width LINK0X -compact +.It Em link0 +AUI ポートを使用します。 +.It Em link1 +BNC ポートを使用します。 +.It Em link2 +UTP ポートを使用します。 +.El +.Sh 診断 +.Bl -diag +.It "vx%d: not configured; kernel is built for only %d devices." +システムにあるアダプタ数に対して、カーネル設定ファイル内の +デバイス数が十分ではありません。 +設定ファイルにデバイスを追加し、 +カーネルを再構築してリブートして下さい。 +.Pp +他のすべての診断はハードウェアの問題かドライバのバグを示しています。 +.Sh 警告 +初期のいくつかの 3c590 カードには問題があり、 +受信あふれの被害を受けます。 +その結果として、パケット損失を引き起こします。 +作者は、3 Com から提供される情報を基に、 +このようなリビジョンの検査を実装しようとしました。 +しかし、検査の出力の大部分は疑わしい警告にすぎません。 +.Pp +カードのバスマスタリング機能を使用せず +ポーリングモードの I/O のみを使用することから、 +このドライバの性能はいくらか制限されます。 +.Sh バグ +.Nm vx +ドライバはいくつかのシステム上でワームブートの後、アダプタを正しく +リセットしないことが知られています。 +.Pp +.Nm vx +ドライバは、サポートしているとされるカードのすべてのモデルで +徹底的にテストを行なっているわけではありません。 +.Sh 歴史 +.Nm vx +デバイスドライバは +.Fx 2.1 +で最初に登場しました。 +これは +.Nm ep +ドライバに由来していて、多くの制限を継承しています。 +.Sh 作者 +.Nm vx +デバイスドライバとこのマニュアルページは、 +.An Herb Peyerl +の作業とその他の多くの人の援助を基に +.An Fred Gray Aq fgray@rice.edu +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/man4.i386/wd.4 b/ja_JP.eucJP/man/man4/man4.i386/wd.4 new file mode 100644 index 0000000000..ccf0d1d9da --- /dev/null +++ b/ja_JP.eucJP/man/man4/man4.i386/wd.4 @@ -0,0 +1,106 @@ +.\" +.\" Copyright (c) 1994 Wilko Bulte +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: wd.4,v 1.10 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: wd.4,v 1.3 1999/08/18 16:40:15 horikawa Stab % +.\" +.Dd August 31, 1994 +.Dt WD 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm wd +.Nd +一般的な WD100x/IDE ディスクコントローラ用ドライバ +.Sh 書式 +.Cd "controller wdc0 at isa? port" \&"IO_WD1\&" bio irq 14 +.Cd "disk wd0 at wdc0 drive 0 +.Cd "disk wd1 at wdc0 drive 1 +.Pp +CMD640b IDE コントローラ用: +.Cd "options" \&"CMD640\&" +.Sh 解説 +このドライバで、Western Digital WD100x シリーズをエミュレートする +コントローラに接続されたディスクにアクセスできるようになります。 +これには、WD1003 ST412 コントローラ、WD1007 ESDI コントローラ、 +そしてほとんどのマザーボードにある一般的な IDE コントローラを含みます。 +.Pp +WD100x シリーズとの互換性については、通常、コントローラの資料に説明があります。 +.Pp +.Ar flags +パラメータを使って、ドライバにヒントや指令を伝えることができます。 +.Pp +16 ビット整数のフラグがドライブ毎にあり、 +それぞれに 4 (訳注: 実際には 6) 個のビットフィールドがあります: +.\" By mzaki@e-mail.ne.jp (Mar 1 1999) +.Bl -tag -width 0x0000 -offset 1c +.It 0x8000 +ドライブの 32 ビット転送機能が使えれば使います。 +.It 0x4000 +ドライブがスリープモードから脱しているところであるようならば、 +混乱しているとみなして再初期化します。 +.It 0x2000 +最近の PCI チップセットにあるバスマスタ DMA 機能があるか調べて利用します。 +.It 0x1000 +デフォルトの CHS アドレッシングではなく、LBA アドレッシングを使います。 +.It 0x0f00 +ヘッドの数を ((flags & 0xf00)>>8) と見なして、 +それに合うようにシリンダ数を計算し直します。 +.It 0x00ff +ドライブのマルチセクタ転送モードが使えれば使います。 +最大で (flags & 0x00ff) セクタの転送を試みます。 +.El +.Pp +このフラグは drive 行に 16 ビット整数で指定するか、 +あるいは controller 行に 32 ビット整数で指定します。 +この場合、上位 16 ビットが番号の大きなドライブに適用されます。 +.Pp +.Dq Dv CMD640 +オプションによって、CMD640b IDE コントローラの欠陥に対処するようになります。 +このオプションが指定されていて、 +かつ PCI サブシステムがこのチップを検出した場合には、 +プライマリとセカンダリのコントローラは同時には使われません。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/wd* +ディスクのブロックデバイスノード +.It Pa /dev/rwd* +ディスクのキャラクタデバイスノード +.It Pa /sys/i386/conf/GENERIC +.\" 原文 +.\" sample generic kernel config file for (a.o.) wd based systems +.\" の a.o. ってなんでしょう？ +wd によるシステムのためのジェネリックカーネルの設定ファイルのサンプル +.It Pa /sys/i386/isa/wd.c +ドライバのソース +.El +.Sh 関連項目 +.Xr bad144 8 +.Sh 注釈 +このコントローラとディスクの組合わせは、 +自動的にバッドブロックを処理をするための機構を備えていません。 +バッドブロックを調べるには +.Xr bad144 8 +を実行する必要があります。 diff --git a/ja_JP.eucJP/man/man4/matcd.4 b/ja_JP.eucJP/man/man4/matcd.4 new file mode 100644 index 0000000000..814f534a06 --- /dev/null +++ b/ja_JP.eucJP/man/man4/matcd.4 @@ -0,0 +1,426 @@ +.\"Matsushita(Panasonic) / Creative CD-ROM Driver (matcd) +.\"Authored by Frank Durda IV +.\" +.\"Program and Documentation are Copyright 1994, 1995 Frank Durda IV. +.\"All rights reserved. +.\" "FDIV" is a trademark of Frank Durda IV. +.\" +.\" +.\"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 positioned at the very beginning of this file without +.\" modification, all copyright strings, all related programming +.\" codes that display the copyright strings, this list of +.\" conditions and the following disclaimer. +.\"2. Redistributions in binary form must contain all copyright strings +.\" and related programming code that display the copyright strings. +.\"3. 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. +.\"4. All advertising materials mentioning features or use of this +.\" software must display the following acknowledgement: +.\" "The Matsushita/Panasonic CD-ROM driver was developed +.\" by Frank Durda IV for use with "FreeBSD" and similar +.\" operating systems." +.\" "Similar operating systems" includes mainly non-profit oriented +.\" systems for research and education, including but not restricted +.\" to "NetBSD", "386BSD", and "Mach" (by CMU). The wording of the +.\" acknowledgement (in electronic form or printed text) may not be +.\" changed without permission from the author. +.\"5. Absolutely no warranty of function, fitness or purpose is made +.\" by the author Frank Durda IV. +.\"6. Neither the name of the author nor the name "FreeBSD" may +.\" be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" (The author can be reached at bsdmail@nemesis.lonestar.org) +.\"7. The product containing this software must meet all of these +.\" conditions even if it is unsupported, not a complete system +.\" and/or does not contain compiled code. +.\"8. These conditions will be in force for the full life of the +.\" copyright. +.\"9. If all the above conditions are met, modifications to other +.\" parts of this file may be freely made, although any person +.\" or persons making changes do not receive the right to add their +.\" name or names to the copyright strings and notices in this +.\" software. Persons making changes are encouraged to insert edit +.\" history in matcd.c and to put your name and details of the +.\" change there. +.\"10. You must have prior written permission from the author to +.\" deviate from these terms. +.\" +.\"Vendors who produce product(s) containing this code are encouraged +.\"(but not required) to provide copies of the finished product(s) to +.\"the author and to correspond with the author about development +.\"activity relating to this code. Donations of development hardware +.\"and/or software are also welcome. (This is one of the faster ways +.\"to get a driver developed for a device.) +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPER(S) ``AS IS'' AND ANY +.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE DEVELOPER(S) BE +.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, +.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT +.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +.\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\"-------------------------------------------------------------------------- +.\"Dedicated to: My family and Max, my Golden Retriever +.\"-----No changes are allowed above this line------------------------------- +.\" +.\" Please note any documentation updates here including your name +.\" and the date. +.\"<2> Text brought in sync with changes made in versions 1(17) - 1(21) +.\" Frank Durda IV 4-Jul-95 +.\"<3> Text brought in sync with changes made in versions 1(22) - 1(25) +.\" Frank Durda IV 24-Sep-95 +.\" +.\" %Id: matcd.4,v 1.10 1998/03/12 07:30:34 charnier Exp % +.\" jpman %Id: matcd.4,v 1.3 2000/07/13 04:29:08 horikawa Stab % +.\" +.Dd September 24, 1995 +.Dt MATCD 4 i386 +.\"Synchronized to Version 1(25) of matcd.c +.Os FreeBSD 2.0.5 +.Sh 名称 +.Nm matcd +.Nd Matsushita (Panasonic) CD-ROM ドライバ +.Sh 書式 +.Pp +.Cd "controller matcd[0-4] at isa? port [?| addr]" +.br +.Cd "/dev/[r]matcd[0-15][a|c] +.br +.Cd "/dev/[r]matcdl[0-15][a|c] +.Pp +.Sh 解説 +.\" Matsushita-Kotobuki Electronics Industries および Matsushita の +.\" 日本語表記は、http://www.panasonic.co.jp/corp/group.html で確認 +.\" horikawa@jp.FreeBSD.org 2000/07/06 +.Nm matcd +ドライバは、松下寿電子工業製の、または短縮して松下製の、CR-562-x +及び CR-563-x CD-ROM ドライブを制御します。これら CD-ROM ドライブは +Panasonic (松下の商標)、Creative Labs (omniCD)、Reveal などのブランドで +販売され、Tandy、AST、Packard Bell など多くのコンピュータに採用されて +います。 + +これらのドライブは、専用のホストインタフェースを通じて PC ISA バスに +接続します。このインタフェースはスタンドアロンの ISA カードとして存在す +ることもありますし、サウンドカード上に含まれていることもあります。 + +.Sh ドライバの設定 +.Nm matcd +ドライバは、それぞれが 4 台までのドライブをもつホストインタフェースを +上限 4 つまでサポートします。オーディオ機能は全てのドライブで同時に実行で +きるかもしれませんが、データ読み取り操作の対象は、どの瞬間においても 1 +つのホストインタフェースに対して 1 つのドライブのみになります。 + +マルチホストインタフェースをサポートするためには、 +カーネルコンフィギュレーションファイルのエントリを修正する必要があります。 +通常、このファイルはシステム上の +\fI/usr/src/sys/i386/conf/GENERIC\fR に存在します。 +これをコピーしてシステムの名前をつけると良いでしょう。この新しいファイル +にシステムでサポートしたいデバイスを含め、逆に不要なデバイスのエントリ +は削除します。 + +このファイルには以下のようなエントリが見つかるでしょう: + + controller matcd0 at isa? port ? bio + +2 つのホストインタフェースをサポートするためには、以下のように変更します: + + controller matcd0 at isa? port ? bio +.br + controller matcd1 at isa? port ? bio +.br + +(3 つ、あるいは 4 つまでホストインタフェースをサポートさせたい場合、同様 +にエントリを追加してください。) +.if n .bp +.if t .sp +ホストインタフェースが 1 つのみで 4 台までのドライブをサポートする場合、 +カーネルコンフィギュレーションの修正は不要であることに注意してください。 +2 つ目のインタフェースを追加するまで、1 つめのインタフェース上で必ずしも +4 台のドライブを持たなくてかまいません。 + +デフォルトでは、 +.Nm matcd +は Creative ホストアダプタ (\fIoptions.h\fR 参照) の既知の I/O ポート +テーブルを用いて CD-ROM ホストアダプタを探索します。これは非常に柔軟で +すが、 +.Nm matcd +がチェックした CD-ROM ホストインタフェースの I/O ポートに、システムの +他のデバイスが存在するときに問題を起こします。さらに、複数の位置を検索 +する必要があるため、ブートプロセスに時間がかかる原因となります。 +.if t .bp +.if n .sp +これらの問題は、CD-ROM ホストインタフェースの位置を明示することに +よって解決することができます。例えば、デフォルトのほとんどの Sound Blaster +カードは I/O ポート 0x230 の位置に松下 CD-ROM ホスト +インタフェースを持っています。 +(これはカード上のオーディオ機能に 0x10 を加えた I/O ポートの値です。) +システムがこのような場合、カーネルブートプロンプトにおいて、 +-c オプションを用いることによりカーネルがハードウェアを検出する位置を +変更できます。こうしてカーネルをロードすると、それに含まれる +あらゆるデバイスの設定を変更する機会を得ることができます。 +例えば、 +.Nm matcd +アダプタ 0 に対する I/O ポートを変更するには以下のように記述すれば良い +でしょう。 + + config> port matcd0c 0x340 + +カーネルをリコンパイルするなら、カーネルコンフィギュレーションファイル +のエントリを以下のように変更して特定のアドレスを指定することができます: + + controller matcd0 at isa? port 0x230 bio + +このように変更すると +.Nm matcd +ドライバは最初の CD-ROM ホストインタフェースのために I/O ポート 0x230 +のみを探索し、他の I/O ポートは妨げません。 + +カーネルコンフィギュレーションファイルの調整が完了したら、カーネルを +設定、リコンパイル、及びインストールします。そして変更した個所を +有効にするために再起動する必要があります。 +.Sh サポートされているハードウェア +現在、 +.Nm matcd +ドライバで動作するドライブは、2 つが知られているだけです: +.Bl -tag -width CR-123-X -compact -offset indent +.br +.It 松下 CR-562-x +.br +.It 松下 CR-563-x +.br +.El +たいていの再販業者はこれらにもともとついていたマーキングをそのままに +してあり、ラベルは FCC, VDE, CSA, RU などの認定証がついています。 + +これらのドライブは両方とも駆動ドレイがついています。オリジナルを +カスタマイズされた製品も出回っていて、ボリュームコントロールや +ヘッドフォンジャックがついていないもの +(Tandy コンピュータにみられるかもしれません) がある +かも知れませんが、これも +.Nm matcd +ドライバで動作します。 + +松下 CR-522-x 及び CR-523-x CD-ROM ドライブは +.Nm matcd +を利用できません。 +CR-522 及び CR-523 は CD キャディを必要とするので正面から識別すること +もできます。 + +IDE インタフェースをもつドライブは、IDE ドライバを使わなければなりま +せん。 + +TEAC CD-55 4X CD-ROM ドライブは Creative/Panasonic インタフェースも使っ +ていますが、TEAC のドライブは松下 CR-56x ドライブと互換ではあり\fIませ +ん\fR。 TEAC のドライブは +.Nm matcd +ドライバでは利用できません。 +.if t .sp +.if n .bp +Panasonic ドライブ用のホストインタフェースアダプタの出所で最も一般的なの +は、SoundBlaster サウンドカードを含む Creative Labs 製品に見られます。 +SoundBlaster サウンドカードには多数のモデルが存在し、ほとんどの最新の +カードは適当なインタフェースを提供しますが、"Creative/Panasonic" +インタフェースとラベルづけられていることもあります。 + +以下のホストインタフェースアダプタは +.Nm matcd +ドライバで動作することが知られています: +.Bl -tag -width LONGNAME -compact -offset indent +.It Creative +Sound Blaster Pro (SBPRO) (CT1330A) +.It Creative +Sound Blaster 16 (CT1730) +.It Creative +Sound Blaster 16 - 廉価版 (CT1740) +.It Creative +OmniCD アップグレードキットアダプタカード - スタンドアロン CD (CT1810) +.It Creative +Sound Blaster 16 - 2 層、廉価版 (CT2230) +.It Creative +Sound Blaster 16 (Vibra16) - 2 層、単一チップ (CT2260) +.It Creative +Sound Blaster 16 Value (SB16) - 2 層、廉価版 (CT2770) +.It Creative +PhoneBlaster SB16 + Sierra 14.4K Voice/FAX/Data/Speakerphone モデム(CT3100) +.It Reveal +(SC400) +.El + +警告: これらサウンドカードには、敢えて Panasonic/Creative インタフェース +を含まないように作られているものがあるので、モデルナンバに基づいて +単独責任で買う前に、ボードをチェックしましょう。 + +これは完全なリストで決してはありません。 +Creative Labs および他のベンダは、 +Creative/Panasonic ドライブインタフェースの新しバージョンのサウンドカードを +いつもリリースするからです。 + +Creative Labs アダプタに加えて、Media Vision, IBM, Lasermate +アダプタで、互換性があるアダプタもまたサポートされます。しかし、これらの +アダプタは広範囲にわたるI/Oポートアドレスを使いますので、 +これらのアダプタの位置決めをするためにドライバの再構成が必要です。 + +異なったホストインタフェースの実装を行っているメーカが存在することを +理解することが重要です。MS-DOSで Creative Labs 純正のドライバを用いても、 +どうしても通信できないボードがあるなら、 +.Nm matcd +はそのホストアダプタでは動作しないかもしれません。 +.br +.if t .bp +.if n .sp +.Sh サポートされた操作 +.Nm matcd +ドライバは、ブロックアクセス及びキャラクタアクセスをサポートします。 +パーティション "a" は、データ CD から 2048 バイトのユーザデータブロックを返し +ます。パーティション "c" は、オーディオ CD を含めてあらゆるタイプの CD +から全部で 2352 バイトのフレームを返します。(パーティション "c" は +cd9660 ファイルシステムや他のファイルシステムエミュレータを用いて "マウント" +できません。) 他にサポートされているパーティションはありません。 + +ドライブ上のデバイスが全てクローズされるまで、ドライブトレイがロックさ +れたままになるということを除き、 +.Nm matcdl +デバイスは通常の +.Nm matcd +デバイスと同様に動作します。 +.if n .bp +.if t .sp +.Nm matcd +は CD-ROM オーディオに関連した機能やトレイ制御の機能を含む多くの +.Fn ioctl +コマンドを受理します。コマンドは以下の通りです: +.Pp +.Bl -tag -width CDIOCREADSUBCHANNELXXX -compact -offset indent +.It DIOCGDINFO +ディスクラベルを取得します。 +.It DIOCGDPART +パーティションを取得します。 +.It DIOCWDINFO +アップデートディスクをセットします。 +.It DIOCSDINFO +ディスクラベルをセットします。 +.It CDIOCREADSUBCHANNEL +再生中のディスクの状態におけるサブチャネル情報を取得します。 +.It CDIOCREADTOCHEADER +コンテンツサマリのテーブルを読み取ります。 +.It CDIOCREADTOCENTRYS +長さと他のトラック情報を読み取ります。 +.It CDIOCPLAYTRACKS +あるトラック/インデックスから開始してあるトラック/インデックスで終了する +オーディオを演奏します。 +.It CDIOCPLAYMSF +特定の時刻オフセットから開始するオーディオを演奏します。 +.It CDIOCPAUSE +再生中のディスクを一時停止します。 +.It CDIOCRESUME +一時停止したディスクの再生をレジュームします。ドライブが既に再生してい +る場合には無視されます。 +.It CDIOCSTOP +再生中のディスクを停止します。 +.It CDIOCEJECT +ディスクトレイをオープンします。 +.It CDIOCCLOSE +ディスクトレイをクローズします。 +.It CDIOCPREVENT +全てのデバイスがクローズされるか CDIOCALLOW ioctl が発行されるまで、 +ドライブドアをオープンしようとする操作を阻止します。 +.It CDIOCALLOW +ドライブドアがロックされていれば解除します。この ioctl は何らかのロック +されたデバイスがオープンしていれば拒否されます。 +.It CDIOCGETVOL +ドライブにセットされたボリュームを返します。 +.It CDIOCSETVOL +ドライブにセットされたボリュームをセットします。 +.It CDIOCSETSTEREO +このコマンドにより左チャネルのオーディオを左チャネルの出力に送り、 +右チャネルのオーディオを右チャネルの出力に送ります。 +これはデフォルトの状態です。 +.It CDIOCSETMUTE +このコマンドによりオーディオ出力は停止します。 +ドライブはディスク上のオーディオを読み続けますが、 +オーディオ出力が再会されるまでそのデータは破棄されます。 +.It CDIOCSETLEFT +このコマンドにより左のチャネルのオーディオは左右のチャネルの出力に送ら +れます。 +.It CDIOCSETRIGHT +このコマンドにより右のチャネルのオーディオは左右のチャネルの出力に送ら +れます。 +.It CDIOCSETPATCH +指定されるビットマップに従い、オーディオをルーティングします。 +.It CDIOCSETPITCH +このコマンドはオーディオの再生速度を増減します (カラオケのときなど)。 +.It CDIOCCAPABILITY +ドライブとドライバの性能をレポートします。 +.El +.Pp +.Nm matcd +ドライバは上述のように定義された +.Fn ioctl +コマンドのみをサポートします。 +.bp +.Sh 関連ファイル +.Bl -tag -width /dev/(r)matcd0a_/dev/(r)matcdl0a -compact +.It Pa /dev/[r]matcd0a /dev/[r]matcdl0a +CD-ROM ディスク上の 2048 バイトブロックデータにアクセスするときに使用します。 +これは モード 1 フォーム 1 フォーマットで記録されたものです。 +.It Pa /dev/[r]matcd0c /dev/[r]matcdl0c +CD-ROM ディスク上の 2352 バイトフレームに任意のフォーマットで記録された +データにアクセスするときに使用します。 +.It Pa /usr/src/sys/i386/isa/matcd/* +.Nm matcd +用のソースコードとコンパイラオプションです。 +.El + +\fIoptions.h\fR ファイルには全てのコンパイルオプションが書かれています。 +デフォルトでは ドライバは FreeBSD の current バージョンで動作するよう +に設定されています。 +.Sh 注 +.Pp +ドライブが割り込みもしくは DMA を利用することができても、 +Creative/Panasonic インタフェース上でこれらを利用することはできません。 + +1 つ以上のパーティションがオープンしているにも関わらず、 +ディスクトレイがオープンしているならば、ドライブ上の全てのパーティションに対す +るこれ以上の I/O は全てのパーティションがクローズするまで拒否されます。 + +物理ドライブ 0 として割り当てられる各々のホストインタフェース上には +ドライブが存在していなければなりません。もしそうでない場合、 +ドライバはホストインタフェースあるいは接続されたドライブを 1 つも +見つけることができないでしょう。 + +第 2 のホストインタフェース開始のドライブは、論理ドライブ 4-7 +(第 3 のインタフェースの 8-11 と第 4 の 12-15) とみなされます。 + +最初のホストインタフェースにいくつのドライブが存在しているかに関わりなく、 +2 番目のホストインタフェース上の最初のドライブは論理ドライブ 4 になり +ます。 + +ホストインタフェースはカーネルコンフィギュレーションファイルに宣言され +た順番か、カーネルコンフィギュレーションファイルでポートアドレスに "?" +を用いたならばそれが見つかった順番に番号を割り振られます。 +ホストインタフェースの番号は常に切目なく連続しています。 +.Sh 関連項目 +.Pa /usr/include/sys/cdio.h +.Sh 作者 +ドライバとドキュメントは +.An Frank Durda IV +が書きました。 +.br +Program and Documentation are Copyright 1994, 1995, All rights +reserved. +.Sh 歴史 +.Nm matcd +ドライバは +.Fx 2.0.5 +において登場しました。 diff --git a/ja_JP.eucJP/man/man4/mcd.4 b/ja_JP.eucJP/man/man4/mcd.4 new file mode 100644 index 0000000000..af9d25bbc9 --- /dev/null +++ b/ja_JP.eucJP/man/man4/mcd.4 @@ -0,0 +1,151 @@ +.\" +.\" Copyright (c) 1994 Keith E. Walker +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: mcd.4,v 1.6 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: mcd.4,v 1.3 1999/11/19 15:19:56 horikawa Stab % +.\" +.Dd December 8, 1994 +.Dt MCD 4 i386 +.Os FreeBSD 2.0 +.Sh 名称 +.Nm mcd +.Nd Mitsumi CD-ROM ドライバ +.Sh 書式 +.Cd "device mcd0 at isa? port 0x300 bio irq 10" +.Sh 解説 +.Nm mcd +ドライバは Mitsumi 製 CD-ROM プレイヤに対して、データとオーディオの +インタフェースを提供します。 +CD-ROM プレイヤは、Mitsumi 専用のコントローラ +ボードの 1 つを経てISA バスに接続されていることが必要です。 +サポートされているコントローラボードは LU002S, LU005S, FX001, そして一般的な +FX001D です。 +.Pp +.Nm mcd +ドライバはディスク固有の +.Fn ioctl +コマンド、すなわち +.Dv DIOCGDINFO , +.Dv DIOCGPART , +.Dv DIOCWDINFO , +.Dv DIOCSDINFO , +コマンドに対して応答します。 +他のディスク固有の +.Fn ioctl +コマンドにはエラーを返すものもあるでしょう。 +.Pp +.Nm mcd +ドライバは、特別な CD-ROM +.Fn ioctl +コマンドに対しても応答します。これらのコマンドは、CD-ROM プレイヤの +オーディオ機能を制御します。 +コマンドは次の通りです: +.Pp +.Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent +.It CDIOCREADSUBCHANNEL +ディスクを再生中の現在の状態におけるサブチャネルの情報を取得します。 +.It CDIOCREADTOCHEADER +目次ヘッダを取得します。 +.It CDIOCREADTOCENTRYS +全ての目次を取得します。 +.It CDIOCPLAYTRACKS +指定された位置において、オーディオ再生を始めます。 +.It CDIOCPLAYBLOCKS +.Dv EINVAL +エラーで失敗します。 +.It CDIOCPLAYMSF +指定された位置において、オーディオ再生を始めます。 +.It CDIOCRESUME +あらかじめ一時停止したディスクの再生をレジュームします。 +.It CDIOCPAUSE +ディスクの再生を一時停止します。 +.It CDIOCSTART +ディスク再生を始めます。 +.It CDIOCSTOP +あらかじめ再生中のディスクを停止します。 +.It CDIOCEJECT +ディスクトレーをオープンします +(クローズするコマンドはサポートされていません)。 +.It CDIOCRESET +あらゆる再生を停止し、Mitsumi コントローラボードをリセットします。 +.It CDIOCSETDEBUG +カーネルは +.Nm mcd +ドライバについてのデバッグメッセージをコンソールに出力します。 +.It CDIOCCLRDEBUG +カーネルは +.Nm mcd +ドライバについてのデバッグメッセージの出力を終了します。 +.El +.Pp +上記で定義した +.Fn ioctl +コマンドは +.Nm mcd +ドライバがサポートするコマンドだけです。( +.Dv CDIOCSETVOL +や +.Dv CDIOCSETSTERIO +のような) CD-ROM 関連 +.Fn ioctl +コマンドも存在しますが、そのようなコマンドは +ドライバの将来のバージョンでサポートされるかも知れません。 +.Sh 関連ファイル +.Bl -tag -width /dev/(r)mcd0a -compact +.It Pa /dev/(r)mcd0a +ディスク上の BSD パーティションにアクセスします。通常、CD-ROM ディスク +上に存在するファイルシステムは単一です。 +.It Pa /dev/(r)mcd0c +raw デバイスにアクセスします。 +.El +.Sh 注 +.Nm mcd +ドライバのキャラクタモードデバイスは、 +オーディオ機能に限定してアクセスするために使うべきです。 +データ機能にアクセスすると、性能がひどく悪いからです。 +.Pp +ドライバの現在のバージョンは、生成されたあらゆる IRQ に対して割り込み +ハンドラを保持しているにもかかわらず、インタフェースボードの DMA と +IRQ 機能のどちらも用いていません。 +ともかく DMA 機能がサポートされるまで、ボード +の生成する割り込みだけはドライバによってサポートされません。 +.Sh 関連項目 +.Pa /usr/include/sys/cdio.h +.Sh 作者 +ドライバは +.An Holger Veit +(データ部分) 及び +.An Brian Moore +(オーディオ部分) が書きました。それに対する変更が +.An Gary Clark II , +.An Andrew A. Chernov , +.An Jordan K. Hubbard +によって提供されました。 +.Sh 歴史 +.Nm mcd +ドライバは +.Fx 1.0 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man4/mem.4 b/ja_JP.eucJP/man/man4/mem.4 new file mode 100644 index 0000000000..aa6d417797 --- /dev/null +++ b/ja_JP.eucJP/man/man4/mem.4 @@ -0,0 +1,75 @@ +.\" Copyright (c) 1991 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)mem.4 5.3 (Berkeley) 5/2/91 +.\" jpman %Id: mem.4,v 1.3 1999/08/13 08:27:34 horikawa Stab % +.\" %Id: mem.4,v 1.3 1997/03/07 02:49:51 jmg Exp % +.\" +.Dd May 2, 1991 +.Dt MEM 4 i386 +.Os +.Sh 名称 +.Nm mem , +.Nm kmem +.Nd メモリファイル +.Sh 解説 +特殊ファイル +.Nm /dev/mem +はコンピュータの物理メモリへのインタフェースです。 +このファイルでのバイトオフセットは、物理メモリアドレスとして解釈されます。 +このファイルへの読み書きは、メモリそのものへの読み書きと同等です。 +.Nm /dev/mem +の範囲内のオフセットだけが許されます。 +.Pp +.Nm /dev/mem +と同じやりかたで +.Nm /dev/kmem +インタフェースを通じてカーネルの仮想メモリにアクセスできます。 +現在メモリにマップされているカーネル仮想アドレスのみが許されます。 +.Pp +.Tn ISA +システムでは +.Tn I/O +メモリ空間が物理アドレス 0x000a0000 から始まり 0x00100000 まで続きます。 +現在のプロセスのプロセス毎データの大きさは +.Dv UPAGES +で、仮想アドレス 0xf0000000 で終ります。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/mem +.It Pa /dev/kmem +.El +.Sh 歴史 +.Nm mem , +.Nm kmem +ファイルは +.At v6 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/mouse.4 b/ja_JP.eucJP/man/man4/mouse.4 new file mode 100644 index 0000000000..724c8b3f73 --- /dev/null +++ b/ja_JP.eucJP/man/man4/mouse.4 @@ -0,0 +1,388 @@ +.\" +.\" Copyright (c) 1997 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: mouse.4,v 1.2 1998/03/12 07:30:35 charnier Exp % +.\" jpman %Id: mouse.4,v 1.3 2000/08/24 05:57:25 yt-kage Stab % +.\" WORD: track ball トラックボール +.\" " +.Dd December 3, 1997 +.Dt MOUSE 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm mouse +.Nd マウス、ポインティングデバイス用ドライバ +.Sh 書式 +.Fd #include +.Sh 解説 +マウスドライバ +.Xr mse 4 , +.Xr psm 4 , +.Xr sysmouse 4 +はユーザプログラムにマウスの動きやボタン状態の情報を提供します。 +現在のところ、バスマウス用、InPort マウス用、PS/2 マウス用の +特有のデバイスドライバがあります。 +シリアルマウスは、専用のドライバでは直接サポートされてはいませんが、 +シリアルデバイスドライバを介して、あるいは +.Xr moused 8 +や +.Xr sysmouse 4 +を経由してアクセスできます。 +.Pp +ユーザプログラムでは、単純に +.Xr open 2 +呼び出しでマウスデバイスをオープンし、 +.Xr read 2 +でデバイスからマウスのデータを読み取ります。 +動きとボタン状態は通常、固定長のデータパケットにエンコードされます。 +マウスデバイスによっては、可変長のパケットでデータを送るかもしれません。 +それぞれのドライバが実際に用いるプロトコル (データ形式) は大きく異なります。 +.Pp +マウスドライバは ``非ブロッキング'' 属性を持つことができます。 +その場合、マウスデータが取得できなければドライバはすぐに戻ります。 +.Pp +マウスデバイスドライバは大抵いくつかのレベルの操作を提供します。 +現在の操作レベルは +.Xr ioctl 2 +コマンドで調査、変更することができます。 +レベル 0 が最も低いレベルであり、 +このときドライバはユーザプログラムに基本的なサービスを提供します。 +このレベルでは、ほとんどのドライバがマウスの水平移動と垂直移動、 +および 3 つまでのボタンの状態を提供します。 +レベル 1 では、ドライバがサポートしている場合、 +マウスデータは標準的な形式の +.Dv MOUSE_PROTO_SYSMOUSE +にエンコードされます。 +その形式は次の通りです: +.Pp +.Bl -tag -width "バイト_1" -compact +.It バイト 1 +.Bl -tag -width "ビット_7" -compact +.It ビット 7 +常に 1 です。 +.It ビット 6..3 +常に 0 です。 +.It ビット 2 +左ボタンの状態: 押されていればクリアされ、そうでなければセットされます。 +.It ビット 1 +中ボタンの状態: 押されていればクリアされ、そうでなければセットされます。 +デバイスが中ボタンを持たなければ、常に 1 です。 +.It ビット 0 +右ボタンの状態: 押されていればクリアされ、そうでなければセットされます。 +.El +.It バイト 2 +水平移動量の前半部分の、2 の補数表現です。 +-128 から 127 の範囲になります。 +.It バイト 3 +垂直移動量の前半部分の、2 の補数表現です。 +-128 から 127 の範囲になります。 +.It バイト 4 +水平移動量の後半部分の、2 の補数表現です。 +-128 から 127 の範囲になります。 +水平移動量全体を得るには、 +バイト 2 とバイト 4 を足してください。 +.It バイト 5 +垂直移動量の後半部分の、2 の補数表現です。 +-128 から 127 の範囲になります。 +垂直移動量全体を得るには、 +バイト 3 とバイト 5 を足してください。 +.It バイト 6 +ビット 7 は常に 0 です。 +下位 7 ビットは Z 軸移動量の前半部分を +2 の補数表現でエンコードします。 +-64 から 63 の範囲になります。 +.It バイト 7 +ビット 7 は常に 0 です。 +下位 7 ビットは Z 軸移動量の後半部分を +2 の補数表現でエンコードします。 +-64 から 63 の範囲になります。 +全体の Z 軸移動量を得るには、 +バイト 6 と バイト 7 を足してください。 +.It バイト 8 +ビット 7 は常に 0 です。 +ビット 0 から 6 はボタン 4 から 10 の状態を表します。 +ボタンが押されていれば対応するビットがクリアされ、 +そうでなければセットされます。 +.El +.Pp +この形式の最初の 5 バイトは MouseSystems 形式と互換になっています。 +残りの 3 バイトは、最上位ビットが常に 0 にセットされています。 +そのため、ユーザプログラムが MouseSystems データ形式を解釈できて、 +ビットパターン 10000xxxb を検出することで +このデータ形式の 1 バイト目を見つけ出そうとしている場合、 +追加分のバイトを棄てることによって、 +x, y および 3 つのボタンの状態を正しくデコードできます。 +.Pp +デバイスドライバが 2 以上の操作レベルを提供することもあります。 +詳しくは個々のドライバのマニュアルページを参照してください。 +.Sh IOCTL +次の +.Xr ioctl 2 +コマンドがマウスドライバ用に定義されています。 +サポートの状況はドライバによって変わります。 +本セクションではコマンドの一般的な解説を記します。 +特定のドライバの詳細については、個々のドライバのマニュアルページを +参照してください。 +.Pp +.Bl -tag -width MOUSE -compact +.It Dv MOUSE_GETLEVEL Ar int *level +.It Dv MOUSE_SETLEVEL Ar int *level +これらのコマンドはマウスドライバの操作レベルを扱います。 +.Pp +.It Dv MOUSE_GETHWINFO Ar mousehw_t *hw +接続されているデバイスのハードウェア情報を次の構造体に返します。 +.Dv iftype +フィールド以外は、 +デバイスドライバが必ずしも正しい値で構造体を埋めるとは限りません。 +サポートの詳細は個々のドライバのマニュアルページを参照してください。 +.Bd -literal +typedef struct mousehw { + int buttons; /* ボタン数 */ + int iftype; /* I/F の型 */ + int type; /* マウス/トラックボール/トラックパッド... */ + int model; /* I/F 依存のモデル ID */ + int hwid; /* I/F 依存のハードウェア ID */ +} mousehw_t; +.Ed +.Pp +.Dv buttons +フィールドはドライバが検出したボタン数を保持します。 +ドライバが正確な数を検出できなければ、 +2 などの適当な値がこのフィールドに代入されることもあります。 +.Pp +.Dv iftype +はインタフェースの型で、 +.Dv MOUSE_IF_SERIAL , +.Dv MOUSE_IF_BUS , +.Dv MOUSE_IF_INPORT , +.Dv MOUSE_IF_PS2 , +.Dv MOUSE_IF_SYSMOUSE , +.Dv MOUSE_IF_UNKNOWN +のいずれかです。 +.Pp +.Dv type +はデバイスの型を示し、 +.Dv MOUSE_MOUSE , +.Dv MOUSE_TRACKBALL , +.Dv MOUSE_STICK , +.Dv MOUSE_PAD , +.Dv MOUSE_UNKNOWN +のいずれかです。 +.Pp +.Dv model +は +.Dv MOUSE_MODEL_GENERIC +か、あるいは定数 +.Dv MOUSE_MODEL_XXX +のうちの 1 つです。 +.Pp +.Dv hwid +はそのポインティングデバイスが返す ID 値です。 +これはインタフェースの型に依ります。 +取りうる値については特定のマウスドライバのマニュアルページを参照してください。 +.Pp +.It Dv MOUSE_GETMODE Ar mousemode_t *mode +本コマンドはマウスドライバの現在の操作パラメータを報告します。 +.Bd -literal +typedef struct mousemode { + int protocol; /* MOUSE_PROTO_XXX */ + int rate; /* 報告頻度 (秒単位) */ + int resolution; /* MOUSE_RES_XXX、不明なら -1 */ + int accelfactor; /* アクセラレーションの要素 */ + int level; /* ドライバの操作レベル */ + int packetsize; /* データパケットの長さ */ + unsigned char syncmask[2]; /* 同期ビット */ +} mousemode_t; +.Ed +.Pp +.Dv protocol +フィールドは、ユーザプログラムがマウスデータを読み取る際に、 +デバイスの状態が返される形式を示します。 +これは定数 +.Dv MOUSE_PROTO_XXX +のうちのひとつです。 +.Pp +.Dv rate +フィールドは状態報告の頻度 (回/秒) であり、 +デバイスはこの頻度でホストコンピュータに移動報告を送ります。 +不明かまたは適用できなければ -1 です。 +.Pp +.Dv resolution +フィールドはポインティングデバイスの解像度を示す値を保持します。 +正の値か、定数 +.Dv MOUSE_RES_XXX +のうちの 1 つです。 +.Pp +.Dv accelfactor +フィールドは、アクセラレーション機能を制御するための値を保持します。 +この値は 0 以上でなければなりません。 +0 であればアクセラレーション機能は無効です。 +.Pp +.Dv packetsize +フィールドは、固定サイズのデータパケットの長さ +または可変長パケットの固定部の長さを示します。 +このサイズは、インタフェースの型、デバイスの型やモデル、 +ドライバのプロトコルや操作レベルに依存します。 +.Pp +配列 +.Dv syncmask +は、データパケットの 1 バイト目を検出するための +ビットマスクとビットパターンを保持します。 +.Dv syncmask[0] +はビットマスクで、データのバイトとの積 (AND) を取るためのものです。 +その結果が +.Dv syncmask[1] +に等しければ、おそらくそのバイトはデータパケットの 1 バイト目でしょう。 +但しこの 1 バイト目の検出法は 100% 信頼性があるとは言えません。 +ですので、単に補助的な手段だととらえてください。 +.Pp +.It Dv MOUSE_SETMODE Ar mousemode_t *mode +本コマンドは、マウスドライバの現在の操作パラメータを +.Ar mode +で指定される通りに変更します。 +変更可能なのは、 +.Dv rate , +.Dv resolution , +.Dv level , +.Dv accelfactor +だけです。 +他のフィールドに値を代入しても、エラーは発生しませんし、効果もありません。 +.Pp +あるフィールドの現在の設定を変更したくないときは、 +そのフィールドに -1 を入れてください。 +また +.Dv resolution +と +.Dv rate +には 0 を入れることもできます。 +そうすると、そのフィールドのデフォルト値が選択されます。 +.\" .Pp +.\" .It Dv MOUSE_GETVARS Ar mousevar_t *vars +.\" Get internal variables of the mouse driver. +.\" The variables which can be manipulated through these commands +.\" are specific to each driver. +.\" This command may not be supported by all drivers. +.\" .Bd -literal +.\" typedef struct mousevar { +.\" int var[16]; /* internal variables */ +.\" } mousevar_t; +.\" .Ed +.\" .Pp +.\" If the commands are supported, the first element of the array is +.\" filled with a signature value. +.\" Apart from the signature data, there is currently no standard concerning +.\" the other elements of the buffer. +.\" .Pp +.\" .It Dv MOUSE_SETVARS Ar mousevar_t *vars +.\" Get internal variables of the mouse driver. +.\" The first element of the array must be a signature value. +.\" This command may not be supported by all drivers. +.Pp +.It Dv MOUSE_READDATA Ar mousedata_t *data +本コマンドはデバイスから生のデータを読み取ります。 +.Bd -literal +typedef struct mousedata { + int len; /* バッファ内のデータ数 */ + int buf[16]; /* データ用バッファ */ +} mousedata_t; +.Ed +.Pp +呼び出し元プロセスは、 +バッファに読み込まれるバイト数を +.Dv len +フィールドに入れておかなくてはなりません。 +本コマンドはすべてのドライバがサポートしているとは限りません。 +.Pp +.It Dv MOUSE_READSTATE Ar mousedata_t *state +本コマンドはデバイスから生の状態データを読み取ります。 +上記と同じ構造体を使用します。 +本コマンドはすべてのドライバがサポートしているとは限りません。 +.Pp +.It Dv MOUSE_GETSTATE Ar mousestatus_t *status +本コマンドは、現在のボタン状態と移動量を次の構造体に返します。 +.Bd -literal +typedef struct mousestatus { + int flags; /* 状態変更フラグ */ + int button; /* ボタン状態 */ + int obutton; /* 以前のボタン状態 */ + int dx; /* x 方向の移動 */ + int dy; /* y 方向の移動 */ + int dz; /* z 方向の移動 */ +} mousestatus_t; +.Ed +.Pp +.Dv button +フィールドと +.Dv obutton +フィールドは、マウスボタンの現在の状態と以前の状態を保持します。 +ボタンが押されたとき、対応するビットがセットされます。 +マウスドライバは 0 から 31 までのビットを使って +31 個までのボタンをサポートできます。 +いくつかのボタンビットが +.Dv MOUSE_BUTTON1DOWN +から +.Dv MOUSE_BUTTON8DOWN +として定義されています。 +最初の 3 つのボタンは、左ボタン、中ボタン、右ボタンに対応します。 +.Pp +前回の +.Dv MOUSE_GETSTATE +呼び出しからボタンの状態が変わっていれば、 +.Dv flags +フィールドの対応するビットがセットされます。 +前回の呼び出しからマウスが移動していれば、 +.Dv flags +フィールド中の +.Dv MOUSE_POSCHANGED +ビットもセットされます。 +.Pp +その他のフィールドは、 +前回の +.Dv MOUSE_GETSTATE +呼び出しからの移動量を保持します。 +本コマンドが呼び出された後に、毎回内部カウンタがリセットされます。 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/sysmouseXX -compact +.It Pa /dev/cuaa%d +シリアルポート +.It Pa /dev/mse%d +バスマウス、InPort マウスデバイス +.It Pa /dev/psm%d +PS/2 マウスデバイス +.It Pa /dev/sysmouse +仮想マウスデバイス +.El +.Sh 関連項目 +.Xr ioctl 2 , +.Xr mse 4 , +.Xr psm 4 , +.Xr sysmouse 4 , +.Xr moused 8 +.\".Sh HISTORY +.Sh 作者 +本マニュアルページは +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。 diff --git a/ja_JP.eucJP/man/man4/mtio.4 b/ja_JP.eucJP/man/man4/mtio.4 new file mode 100644 index 0000000000..9312d67c94 --- /dev/null +++ b/ja_JP.eucJP/man/man4/mtio.4 @@ -0,0 +1,303 @@ +.\" Copyright (c) 1996 +.\"Mike Pritchard . All rights reserved. +.\" +.\" Copyright (c) 1983, 1991, 1993 +.\"The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\"This product includes software developed by the University of +.\"California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)mtio.48.1 (Berkeley) 6/5/93 +.\" jpman %Id: mtio.4,v 1.3 2000/08/03 06:58:06 horikawa Stab % +.\"%Id: mtio.4,v 1.3.2.1 1999/02/05 08:26:30 mjacob Exp % +.\" +.Dd February 11, 1996 +.Dt MTIO 4 i386 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm mtio +.Nd +.Tn FreeBSD +磁気テープインタフェース +.Sh 解説 +.Pa /dev/[nr]sa* +という名前のスペシャルファイルは、 +SCSI テープドライブを表しています。 +このドライブは、システムに接続することができます。 +.Pa /dev/[nr]sa*.ctl +は、コントロールデバイスで、SCSI テープドライバに +ioctl システムコールを発行するのに使用できます。 +これによって、テープをアンマウントした後も続けて有効にする必要のある +パラメータを設定できます。 +.Pp +巻き戻し用デバイスは、最後の読み込み、書きこみ、そしてシーク要求が +終了するか、あるいはテープの最後に到達したときに、自動的にテープを +巻き戻します。 +通常、巻き戻しを行わないデバイス名には、文字 +.Ql n +が付けられます。 +.Pp +テープには、固定長レコードも可変長レコードも書きこむことができます。 +さらなる情報を得たい場合は、 +.Xr sa 4 +を参照してください。テープの最後には、end-of-file マーカが 2 つ付けられ、 +テープファイルの末尾には、end-of-file マーカが 1 つ付けられます。 +テープが巻き戻されない場合には、テープの位置は 2 つのテープマークの +間に +ヘッドがくる所となり、次回の書きこみで 2 つ目の end-of-file マーカ +が上書きされることになります。 +.Pp +磁気テープデバイスはすべて +.Xr mt 1 +コマンドで制御されます。 +.Pp +raw 磁気テープデバイスでは、 +.Xr ioctl 2 +での操作がいくらか可能です。 +以下の宣言は +.Aq Pa sys/mtio.h +からのものです。 +.Bd -literal +/* + * 磁気テープ IO 制御コマンド用構造体および宣言 + */ + +/* MTIOCTOP - 磁気テープ操作コマンド用構造体 */ +struct mtop { + shortmt_op; /* 以下で宣言する操作 */ + daddr_tmt_count; /* 何回操作するのか */ +}; + +/* 操作 */ +#define MTWEOF 0 /* end-of-file レコードを書く */ +#define MTFSF 1 /* 空きファイルまで前進 */ +#define MTBSF 2 /* 空きファイルまで後退 */ +#define MTFSR 3 /* 空きレコードまで前進 */ +#define MTBSR 4 /* 空きレコードまで後退 */ +#define MTREW 5 /* 巻き戻し */ +#define MTOFFL 6 /* 巻き戻してドライブをオフラインにする */ +#define MTNOP 7 /* 何もしない。ステータスを設定するだけ */ +#define MTCACHE 8 /* コントローラキャッシュを有効 */ +#define MTNOCACHE 9 /* コントローラキャッシュを無効 */ + +#if defined(__FreeBSD__) +/* デバイス用のブロックサイズを設定します。デバイスが可変長のものである */ +/* 場合、0 以外のパラメータを与えると、受け付けられたパラメータ値の */ +/* ブロックサイズを持った固定ブロック長のものに変えられます。ブロック */ +/* サイズを 0 に戻すと、デバイスは再び可変長ブロックのものに戻ります。 */ + +#define MTSETBSIZ 10 + +/* デバイスの密度を設定します。密度の値は SCSI II の仕様で定められて */ +/* おり、0 から 0x17 までの値を取ります。オープンモードのときのみこの */ +/* 値を設定してください。 */ + +#define MTSETDNSTY 11 + +#define MTERASE 12 /* EOM まで消去 */ +#define MTEOD 13 /* EOM まで空白にする */ +#define MTCOMP 14 /* 圧縮モードの選択 0= オフ, 1= 定義 */ +#define MTRETENS 15 /* テープのたるみ直し */ +#define MTWSS 16 /* セットマーク書き込み */ +#define MTFSS 17 /* セットマークまで前進 */ +#define MTBSS 18 /* セットマークまで後退 */ + +#define MT_COMP_ENABLE 0xffffffff +#define MT_COMP_DISABLED 0xfffffffe +#define MT_COMP_UNSUPP 0xfffffffd + +/* + * mt_dsreg の値で、今デバイスが何をしているかを表す。 + */ +#defineMTIO_DSREG_NIL 0 /* 未知 */ +#defineMTIO_DSREG_REST 1 /* 何もしない */ +#defineMTIO_DSREG_RBSY 2 /* テープと通信中 (しかし、操作していません) */ +#defineMTIO_DSREG_WR 20 /* 書き込み中 */ +#defineMTIO_DSREG_FMK 21 /* ファイルマークの書き込み中 */ +#defineMTIO_DSREG_ZER 22 /* 消去中 */ +#defineMTIO_DSREG_RD 30 /* 読み込み中 */ +#defineMTIO_DSREG_FWD 40 /* 送り中 */ +#defineMTIO_DSREG_REV 41 /* 戻し中 */ +#defineMTIO_DSREG_POS 42 /* ハードウェアによる位置決め中 (方向不明) */ +#defineMTIO_DSREG_REW 43 /* 巻き戻し中 */ +#defineMTIO_DSREG_TEN 44 /* たるみ直し中 */ +#defineMTIO_DSREG_UNL 45 /* 取り除き中 */ +#defineMTIO_DSREG_LD 46 /* 取り除き中 */ + +#endif + +/* MTIOCGET 用の構造体 - 磁気テープの状態取得コマンド */ + +struct mtget { + shortmt_type; /* 磁気テープデバイスの種類 */ +/* 次の 2 つのレジスタはほとんどデバイス依存です */ + shortmt_dsreg; /* ``デバイス状態'' レジスタ */ + shortmt_erreg; /* ``エラー'' レジスタ */ +/* デバイス依存レジスタの終わり */ + shortmt_resid; /* 残りカウンタ */ +#if defined (__FreeBSD__) + daddr_t mt_blksiz; /* 現在効力のあるブロックサイズ */ + daddr_t mt_density; /* 現在効力のある記録密度 */ + daddr_t mt_comp; /* 現在効力のある圧縮法 */ + daddr_t mt_blksiz0; /* モード 0 用ブロックサイズ */ + daddr_t mt_blksiz1; /* モード 1 用ブロックサイズ */ + daddr_t mt_blksiz2; /* モード 2 用ブロックサイズ */ + daddr_t mt_blksiz3; /* モード 3 用ブロックサイズ */ + daddr_t mt_density0; /* モード 0 用記録密度 */ + daddr_t mt_density1; /* モード 1 用記録密度 */ + daddr_t mt_density2; /* モード 2 用記録密度 */ + daddr_t mt_density3; /* モード 3 用記録密度 */ +/* 以下のものは、まだ実装されていません。 */ + u_charmt_comp0; /* モード 0 用圧縮法 */ + u_charmt_comp1; /* モード 1 用圧縮法 */ + u_charmt_comp2; /* モード 2 用圧縮法 */ + u_charmt_comp3; /* モード 3 用圧縮法 */ +/* 未実装部分終わり */ +#endif + daddr_tmt_fileno; /* 現在位置のファイル番号 */ + daddr_tmt_blkno; /* 現在位置のブロック番号 */ +}; + +/* MTIOCERRSTAT - テープエラー状態を取得するコマンド用構造体 */ +/* 現在は、SCSI テープ用のみサポートされています。 */ +struct scsi_tape_errors { + /* + * 操作用に SCSI Check Condition を書き出すコマンドの + * 最後の実行結果から、これらのメンバが保持されます。 + * MTIOCERRSTAT を発行すると保持されていたメンバがクリアされます。 + */ + u_int8_t io_sense[32]; /* データ I/O 用の最終センスデータ */ + u_int32_t io_resid; /* 最後のデータ I/O からの残りカウンタ */ + u_int8_t io_cdb[16]; /* 最終センスデータを作ったコマンド */ + u_int8_t ctl_sense[32]; /* 制御 I/O 用の最終センスデータ */ + u_int32_t ctl_resid; /* 最後の制御 I/O からの残りカウンタ */ + u_int8_t ctl_cdb[16]; /* 最終制御センスデータを作ったコマンド */ + /* + * これらは、読み書き時の累積エラーカウンタです。 + * (どのように累積エラーカウンタをリセットするかは + * まだ決まっていません。) + * (まだ実装されていませんが、場所だけは確保してあります。) + */ + struct { + u_int32_t retries; /* 実行したリトライの総数 */ + u_int32_t corrected; /* 実行した誤り訂正の総数 */ + u_int32_t processed; /* 誤り訂正の成功総数 */ + u_int32_t failures; /* 誤り訂正 / リトライ失敗総数 */ + u_int64_t nbytes; /* 処理した総バイト数 */ + } wterr, rderr; +}; + +union mterrstat { + struct scsi_tape_errors scsi_errstat; + char _reserved_padding[256]; +}; +/* + * mt_type バイト用定数。これらの定数は、リストされている + * タイプと互換性のあるコントローラで同一のものです。 + */ +#defineMT_ISTS 0x01 /* TS-11 */ +#defineMT_ISHT 0x02 /* TM03 マスバス: TE16, TU45, TU77 */ +#defineMT_ISTM 0x03 /* TM11/TE10 ユニバス */ +#defineMT_ISMT 0x04 /* TM78/TU78 ユニバス */ +#defineMT_ISUT 0x05 /* ユニバス上の SI TU-45 エミュレーション */ +#defineMT_ISCPC 0x06 /* SUN */ +#defineMT_ISAR 0x07 /* SUN */ +#defineMT_ISTMSCP 0x08 /* DEC TMSCP プロトコル (TU81, TK50) */ +#define MT_ISCY 0x09 /* CCI Cipher */ +#define MT_ISCT 0x0a /* HP 1/4 テープ */ +#define MT_ISFHP 0x0b /* HP 7980 1/2 テープ */ +#define MT_ISEXABYTE 0x0c /* Exabyte */ +#define MT_ISEXA8200 0x0c /* Exabyte EXB-8200 */ +#define MT_ISEXA8500 0x0d /* Exabyte EXB-8500 */ +#define MT_ISVIPER1 0x0e /* Archive Viper-150 */ +#define MT_ISPYTHON 0x0f /* Archive Python (DAT) */ +#define MT_ISHPDAT 0x10 /* HP 35450A DAT ドライブ */ +#define MT_ISMFOUR 0x11 /* M4 Data 1/2 9 トラック ドライブ */ +#define MT_ISTK50 0x12 /* DEC SCSI TK50 */ +#define MT_ISMT02 0x13 /* Emulex MT02 SCSI テープコントローラ */ + +/* 磁気テープ I/O 制御コマンド */ +#define MTIOCTOP_IOW('m', 1, struct mtop) /* 磁気テープを操作する */ +#define MTIOCGET_IOR('m', 2, struct mtget) /* テープ状態取得 */ +/* 次の 2 つのコマンドはどこでも使用されていないようです。 */ +#define MTIOCIEOT_IO('m', 3) /* EOT エラーを無視 */ +#define MTIOCEEOT_IO('m', 4) /* EOT エラー有効 */ +/* + * 32 バイト type 2 構造をフルサポートする SCSI-3 SCC (ストリーム + * デバイス) がもっと出現するときには、この仕様が対象とする全エンティティ + * (64 ビットのブロック、論理ファイルレコード番号等) をこれらの ioctl が + * 扱えるように、再考する必要があるでしょう。 + */ +#define MTIOCRDSPOS _IOR('m', 5, u_int32_t) /* 論理ブロックアドレスを取得 */ +#define MTIOCRDHPOS _IOR('m', 6, u_int32_t) /* ハードウェアブロックアドレスを取得 */ +#define MTIOCSLOCATE _IOW('m', 5, u_int32_t) /* 論理ブロックアドレスを探す */ +#define MTIOCHLOCATE _IOW('m', 6, u_int32_t) /* ハードウェアブロックアドレスを探す */ +#define MTIOCERRSTAT _IOR('m', 7, union mterrstat) /* テープのエラーを取得 */ + +#ifndef KERNEL +#defineDEFTAPE"/dev/nrsa0" +#endif + +#ifdefKERNEL +/* + * マイナデバイス番号 + */ + +#define T_UNIT 003 /* ユニットの選択 */ +#define T_NOREWIND 004 /* 巻き戻しを行わない */ +#define T_DENSEL 030 /* 記録密度の選択 */ +#define T_800BPI 000 /* 800 bpi を選択 */ +#define T_1600BPI 010 /* 1600 bpi を選択 */ +#define T_6250BPI 020 /* 6250 bpi を選択 */ +#define T_BADBPI 030 /* 未定義値を選択 */ +#endif +#endif /* _SYS_MTIO_H_ */ +.Ed +.Pp +.Sh 関連ファイル +.Bl -tag -width /dev/[nr]sa* -compact +.It Pa /dev/[nr]sa* +.El +.Sh 関連項目 +.Xr mt 1 , +.Xr tar 1 , +.Xr st 4 +.Sh 歴史 +.Nm mtio +のマニュアルは +.Bx 4.2 +で登場しました。 +i386 バージョンは最初に +.Fx 2.2 +で登場しました。 +.Sh バグ +ステータスは、デバイスに依らないフォーマットで返されるように +すべきです。 +.Pp +スペシャルファイルの命名については、もっと一貫した分かりやすい +方法でやり直すべきです。 diff --git a/ja_JP.eucJP/man/man4/mx.4 b/ja_JP.eucJP/man/man4/mx.4 new file mode 100644 index 0000000000..a1b12db28e --- /dev/null +++ b/ja_JP.eucJP/man/man4/mx.4 @@ -0,0 +1,165 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: mx.4,v 1.2 1998/12/05 09:31:25 rnordier Exp % +.\" jpman %Id: mx.4,v 1.3 1999/11/28 15:52:53 horikawa Stab % +.\" +.Dd November 5, 1998 +.Dt MX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm mx +.Nd +Macronix 98713/98715/98725 ファストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device mx0" +.Sh 解説 +.Nm +ドライバは Macronix 98713, 98713A, 98715, 98715A, 98725 +ファストイーサネットコントローラチップを塔載した PCI イーサネットアダプタ +やそれが組み込まれたコントローラをサポートします。NDC +Communications SOHOware SFA110, SVEC PN102-TX ファストイーサネットカード +などを含みます。 +.Pp +Macronix のチップはバスマスタ DMA を用い、DEC 'tulip' 互換として +デザインされています。オリジナルの 98713 は 外部 PHY をコントロール +するための MII バス を用いていますが、98713A より上位のチップは NWAY +をサポートした内部トランシーバを用いています。Macronix のチップは DEC +21x4x コントローラとレジスタ互換であると公表されています。Macronix +コントローラはすべて、10, 100 Mbps を全二重または半二重通信でサポート +します。 +.Pp +.Nm +ドライバは次のメディアタイプをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を有効にします。 +ユーザは、 +.Pa /etc/rc.conf +ファイルにメディアオプションを加えることによって、 +自動選択されたモードを手動で上書き可能です。 +.It 10baseT/UTP +10Mbps に設定します。 +.Ar mediaopt +オプションも +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために使用可能です。 +.It 100baseTX +100Mbps (ファストイーサネット) に設定します。 +.Ar mediaopt +オプションも +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために使用可能です。 +.El +.Pp +.Nm +ドライバは次のメディアオプションをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +全二重通信に設定します。 +.It half-duplex +半二重通信に設定します。 +.El +.Pp +メディアタイプ 100baseTX はアダプタがサポートしている場合にのみ可能です。 +このデバイスの設定に関するさらなる情報は +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "mx%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "mx%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "mx%d: watchdog timeout" +デバイスがネットワークに反応しなくなったか、 +ネットワークとの接続 (ケーブル) に問題があります。 +.It "mx%d: no memory for rx list" +ドライバはレシーバリング用の mbuf の確保に失敗しました。 +.It "mx%d: no memory for tx list" +パッドバッファを確保、または mbuf チェインをクラスタに +縮めるときに、トランスミッタリング用の mbuf の確保に失敗しました。 +.It "mx%d: chip is in D3 power state -- setting to D0" +パワーマネージメントをサポートするアダプタにのみ、このメッセージが出ま +す。シャットダウン時にコントローラをローパワーモードにするオペレーティング +システムがあり、チップ設定前にこの状態を解除しない PCI BIOS があります。 +ます。D3 状態において、コントローラは PCI の設定すべてを失うので、BIOS +がそのときにフルパワーモードに設定しなおさなければ、正しく設定すること +はできません。ドライバはこの状態を検出し、アダプタを D0 (フルパワー) +状態に設定しなおそうとしますが、ドライバを完全に操作できる状態にするの +には至らないかもしれません。ブート時にこのメッセージが現れ、ドライバが +ネットワークインタフェースとしてデバイスをアタッチすることに失敗するの +なら、デバイスを適切に設定するために 2 度目のウォームブートを行う必要が +あります。 +.Pp +他のオペレーティングシステムからウォームブートするときのみに、この状態は +起こります。 +.Fx +のブート前にシステムの電源を切れば、カードが正常に設定されます。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Rs +.%T Macronix 98713/A, 98715/A, 98725 データシート +.%O http://www.macronix.com +.Re +.Rs +.%T Macronix 98713/A, 98715/A アプリケーションノート +.%O http://www.macronix.com +.Re +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +に初めて現れました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 +.Sh バグ +Macronix アプリケーションノートによると、チップを通常動作に設定するに +は、ドライバはあるマジックナンバを CSR16 レジスタに書き込む必要があります。 +そのマジックナンバはアプリケーションノートに書いてありますが、ビット +の正確な意味は書いてありません。 +.Pp +98713A は 10Mbps 全二重通信モードに問題があるようです。 +トランスミッタは動作しますが、レシーバは全体のパフォーマンスを著しく下 +げるような不明なエラーを大量に出す傾向にあります。 +98715A にはこの問題がありません。98713A のそれ以外のすべてのモードでは +正しく動作するようです。 diff --git a/ja_JP.eucJP/man/man4/natm.4 b/ja_JP.eucJP/man/man4/natm.4 new file mode 100644 index 0000000000..78dcc36745 --- /dev/null +++ b/ja_JP.eucJP/man/man4/natm.4 @@ -0,0 +1,125 @@ +.\" jpman %Id: natm.4,v 1.3 1999/09/19 11:41:32 vanitas Stab % +.Dd December 29, 1997 +.Dt NATM 4 +.Os BSD +.Sh 名称 +.Nm natm +.Nd ネイティブモード ATM プロトコル層 +.Sh 解説 +BSD ATM ソフトウエアはネイティブモード ATM プロトコル層を含み、 +AAL0 と AAL5 の仮想回線 (バーチャルサーキット) +へのソケットレベルのアクセスを提供します。 +本プロトコル層を有効にするには、カーネル設定ファイルに +.Dl options NATM +を加え、カーネルの再構築を行ってください +(その際 +.Dq make clean +を忘れずに行ってください)。 +.Sh NATM API +NATM 層では仮想回線を指定するために +.Dv struct sockaddr_natm +を使用します: +.Bd -literal -offset indent +struct sockaddr_natm { + u_int8_t snatm_len; /* 長さ */ + u_int8_t snatm_family; /* AF_NATM */ + char snatm_if[IFNAMSIZ]; /* インタフェース名 */ + u_int16_t snatm_vci; /* vci */ + u_int8_t snatm_vpi; /* vpi */ +}; +.Ed +.Pp +VPI 0, VCI 201 の仮想回線に AAL5 +コネクションを作成するには次の様にします: +.Bd -literal -offset indent + struct sockaddr_natm snatm; + int s, r; + s = socket(AF_NATM, SOCK_STREAM, PROTO_NATMAAL5); + /* 注: PROTO_NATMAAL0 は AAL0 です */ + if (s < 0) { perror("socket"); exit(1); } + bzero(&snatm, sizeof(snatm)); + snatm.snatm_len = sizeof(snatm); + snatm.snatm_family = AF_NATM; + sprintf(snatm.snatm_if, "en0"); + snatm.snatm_vci = 201; + snatm.snatm_vpi = 0; + r = connect(s, (struct sockaddr *)&snatm, sizeof(snatm)); + if (r < 0) { perror("connect"); exit(1); } + /* 以上で s が ATM に接続されました! */ +.Ed +.Pp +.Fn socket +コールは単純に未接続の NATM ソケットを作成します。 +.Fn connect +コールは未接続の NATM ソケットを仮想回線に結び付け、 +データの受信のためにその仮想回線を有効にするようドライバに通知します。 +.Fn connect +コールの実行後、そのソケットに対し +.Fn read +または +.Fn write +を使用して ATM 入出力を行います。 +.Sh 内部の NATM 操作 +内部的に、NATM プロトコル層は +そのシステム上の全てのアクティブな仮想回線のリストを +.Dv natm_pcbs +に保持しています。 +これは、NATM と IP が仮想回線上で衝突することを防ぐために、 +その時 IP で使用中の回線を含みます。 +.Pp +仮想回線のデータ受信が有効化されると、 +NATM プロトコル層はプロトコル制御ブロックのアドレスを +受信 +.Dq ハンドル +としてドライバへ渡します。 +入力データが到着すると、 +ドライバは適切な受信ハンドルと共にデータを返します。 +NATM 層は、 +プロトコル制御ブロックの検索のオーバヘッドを避けるために、 +この情報を使用します。 +これにより、ATM が既にデータをデマルチプレクスしてある結果を +利用することができます。 +.Sh その他の NATM の問題 +我々は現在ビデオサーバプロジェクトに取り組んでおり、 +その構成の一部としてこのドライバを使用しています。 +我々の手元には我々の作成した MMX と呼ばれるデバイスがあります。 +ビデオカメラを MMX に接続して、ビデオ出力を AAL0 の +セルストリームとして送信させることができます。 +もちろんこのストリームはかなり速く (実際に大容量です!)、 +本ドライバの通常の AAL0 への処理では対処できません +(皆さんは、小さい mbuf ごとのセルをアプリケーションに +作成させようと試みるでしょう。しかし、ソケット層がその種の +データストリームの処理についていけない事がわかります)。 +この問題を解決するため、我々は +.Dq raw +モードを実装しました。 +これは、カードから得た未処理の AAL0 の情報を、大きなデータの +かたまりへと処理します。 +ソケット層がおかしな振る舞いをすること無く、このデータをリアルタイムに +ディスクへ保存することができます。 +あいにく、そのデータ内には RBD (receive buffer descriptors: +受信バッファ記述子) 及びセルヘッダが含まれていますが、 +これは取り込み後に除去しなければなりません。 +.Dq raw +モードを有効化するには次の様に ioctl を使用します: +.Bd -literal -offset indent + int size = 4000; /* bytes */ + ret = ioctl(s, SIOCRAWATM, (caddr_t)&size); +.Ed +.Pp +この例では、通常の 48 バイトのかたまりではなく、4000 バイトの +かたまりで AAL0 のデータを処理するようドライバに伝えます。 +明らかにこれは少々粗雑な方法ではありますが、 +我々の現在のアプリケーションには必要なものです。 +将来、適した大きな AAL5 のフレームでビデオ情報源からの +データ送信が行われることを期待しています。 +.Sh 警告 +NATM プロトコルのサポートは ATM プロトコルの開発により +変更されやすいです。 +ユーザは現在の実装の詳細に依存するべきではなく、 +むしろエクスポートされたサービスに依存すべきです。 +.Sh 関連項目 +.Xr en 4 +.Sh 作者 +1996 年、NetBSD において、Washington University の Chuck Cranor が +NATM プロトコル層を EN ATM ドライバと共に実装しました。 diff --git a/ja_JP.eucJP/man/man4/ncr.4 b/ja_JP.eucJP/man/man4/ncr.4 new file mode 100644 index 0000000000..530f57b1ab --- /dev/null +++ b/ja_JP.eucJP/man/man4/ncr.4 @@ -0,0 +1,53 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ncr.4,v 1.5 1998/09/18 04:36:48 jkoshy Exp % +.\" jpman %Id: ncr.4,v 1.3 1999/04/23 15:11:32 jsakai Stab % +.\" +.Dd July 10, 1996 +.Dt NCR 4 i386 +.Os +.Sh 名称 +.Nm ncr +.Nd NCR 53C8xx SCSI ドライバ +.Sh 書式 +.Cd "device ncr0" +.Sh 解説 +.Nm +ドライバは +NCR/Symbios 53C810, 53C810a, +53C815, 53C820, 53C825a, 53C860, 53C875, 53C875j, 53C885, +53C895, 53C896 SCSI コントローラチップのサポートを提供します。 +.Sh 注釈 +NCR 5380 と 53C400 チップのサポートは +.Xr nca 4 +ドライバによって提供されます。 +.Sh 関連項目 +.Xr cd 4 , +.Xr ch 4 , +.Xr intro 4 , +.Xr nca 4 , +.Xr sd 4 , +.Xr st 4 + + diff --git a/ja_JP.eucJP/man/man4/netintro.4 b/ja_JP.eucJP/man/man4/netintro.4 new file mode 100644 index 0000000000..71e121dea2 --- /dev/null +++ b/ja_JP.eucJP/man/man4/netintro.4 @@ -0,0 +1,344 @@ +.\" Copyright (c) 1983, 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)netintro.4 8.2 (Berkeley) 11/30/93 +.\" %Id: netintro.4,v 1.8 1997/03/19 19:47:38 bde Exp % +.\" +.\" jpman %Id: netintro.4,v 1.3 2000/09/04 00:24:05 horikawa Stab % +.Dd November 30, 1993 +.Dt NETINTRO 4 +.Os BSD 4.2 +.Sh 名称 +.Nm networking +.Nd ネットワーク機構の紹介 +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Sh 説明 +このセクションでは、本システムで利用可能なネットワーク機構について +の一般的な紹介を行っています。セクション 4 のこの部分のドキュメントは +3 つの領域に分かれます。 +.Em プロトコルファミリ +(ドメイン)、 +.Em プロトコル、 +そして +.Em ネットワークインタフェース +です。 +.Pp +ネットワークプロトコルは、すべて特定の +.Em プロトコルファミリ +と関連づけられています。 +プロトコルファミリは、プロトコルが特定のネットワーク環境下で +機能できるようにするため、プロトコルの実装に対しての基本的な +サービスを提供します。これらのサービスはパケットの分割および +統合、ルーティング、アドレッシング、そして基本的な転送なども +含まれるでしょう。現在のプロトコルの実装ではサポートされていません +が、プロトコルファミリは、複数のアドレッシング方法を提供 +するかもしれません。プロトコルファミリには、通常各 +.Xr socket 2 +タイプに 1 つずつというように、多数のプロトコルが含まれています。 +プロトコルファミリは、すべてのソケットタイプをサポートする必要は +ありません。プロトコルファミリには、同一のソケットアブストラクションをサポート +するために、複数のプロトコルが含まれることがあります。 +.Pp +プロトコルは、 +.Xr socket 2 +で詳しく決められたソケットアブストラクションの 1 つをサポートします。 +特定のプロトコルには、適切なプロトコルファミリとタイプのソケットを +作成するか、ソケットを作成する際に明示的にそのプロトコルを要求 +することによってアクセスすることができます。プロトコルは、通常 +1 種類のアドレスフォーマットのみを受け取ります。通常、そのアドレス +フォーマットは、プロトコルファミリとネットワークアーキテクチャの +デザインに必要なアドレッシング構造体を用いて定義されています。 +ある基本的なソケットアブストラクションのセマンティクスは、 +プロトコルに特有のものです。 +プロトコルはすべてそれぞれに特有のソケットタイプについての基本モデル +をサポートするようになっています。しかし、さらに、そのメカニズムに対して、 +標準的ではない機構や拡張機能を提供することもあります。例えば、 +.Dv SOCK_STREAM +をサポートするプロトコルが、各帯域外 (out-of-band) メッセージにつき +1 バイト以上の帯域外メッセージを送信することができます。 +.Pp +ネットワークインタフェースは、デバイスインタフェースと似ています。 +ネットワークインタフェースは、ネットワークサブシステムの最下位層 +を構成します。これは、実際の送信用ハードウェアと相互に影響します。 +ネットワークインタフェースは、 +1 つ以上のプロトコルファミリやアドレスフォーマットをサポート可能です。 +各ネットワークインタフェースのエントリの書式 (SYNOPSIS) のセクション +には、 +.Xr config 8 +プログラムにシステムの詳細を提供する際に使われる、関連ドライバの +仕様の例があります。 +診断 (DIAGNOSTICS) のセクションのメッセージ一覧は、 +デバイスを操作中に起こるエラーに起因して、コンソールやシステムエラーログ +.Pa /var/log/messages +( +.Xr syslogd 8 +を参照) 中に出力されるものです。 +.Sh プロトコル +本システムでは、現在、インターネットプロトコル、Xerox Network Systems(tm) +プロトコル、そして +.Tn ISO OSI +プロトコルのいくつかがサポートされています。 +ソケットの raw インタフェースがインターネットの +.Tn IP +プロトコル層、 +Xerox +.Tn NS +の +.Tn IDP +プロトコルに対して提供されています。 +各プロトコルファミリのサポートに関するさらなる情報が必要な場合は、 +しかるべきマニュアルページを調べてみてください。 +.Sh アドレッシング +各プロトコルファミリと関連付けられているのが、アドレスフォーマットです。 +ネットワークアドレスは、すべて以下に示す sockaddr と呼ばれる一般的な +構造体と結びついています。しかし、各プロトコルは、より洗練された特有の +構造体を使うように強制しています。一般的には、変数名を変えるといったこと +です。このことについては、上で述べたプロトコルファミリのマニュアルページで +議論されています。 +.Bd -literal -offset indent + struct sockaddr { + u_char sa_len; + u_char sa_family; + char sa_data[14]; +}; +.Ed +.Pp +.Ar sa_len +フィールドには、この構造体全体の長さが入ります。この長さは 16 バイトを +超えるかもしれません。 +次に示す +.Ar sa_family +用のアドレス値は、システム側で既知なものです +(将来実装されるかもしれないフォーマットも加えて、ここで定義しています)。 +.Bd -literal +#define AF_UNIX 1 /* ローカルホスト (パイプ、ポート) */ +#define AF_INET 2 /* インターネット: UDP, TCP など */ +#define AF_NS 6 /* Xerox NS プロトコル */ +#define AF_CCITT 10 /* CCITT プロトコル、X.25 など */ +#define AF_HYLINK 15 /* NSC ハイパーチャネル */ +#define AF_ISO 18 /* ISO プロトコル */ +.Ed +.Sh ルーティング +.Tn UNIX +では、パケットのルーティング機構がいくつか提供されています。 +カーネルは、ルーティング情報データベースを管理しています。 +このデータベースは、パケットを転送するときに適切なネットワークインタフェース +を選ぶ際に使用されます。 +.Pp +ユーザプロセス (あるいは、複数の相互に協調し合ったプロセス) は、 +特別な種類のソケットを通してメッセージを送ることで、 +このデータベースを管理しています。 +この方法が、以前のリリースで使われていた固定長の +.Xr ioctl 2 +に取って代わりました。 +.Pp +この機構については、 +.Xr route 4 +に説明があります。 +.Sh インタフェース +システム内の各ネットワークインタフェースは、メッセージの送受信に +使われるパスに対応しています。ネットワークインタフェースは、通常、 +関連のあるハードウェアデバイスを持っています。しかし、 +.Xr lo 4 +のようなループバックインタフェースはハードウェアデバイスを持っていません。 +.Pp +次の +.Xr ioctl 2 +コールは、ネットワークインタフェースを操作するのに使われます。 +.Fn ioctl +関数は、所望のドメインのソケット (特に +.Dv SOCK_DGRAM +型) 上で実行します。以前のリリースでサポートされていたリクエストの多くは、 +パラメータに +.Ar ifreq +構造体を取っていました。この構造体は、次の形式です +.Bd -literal +struct ifreq { +#define IFNAMSIZ 16 + char ifr_name[IFNAMSIZ]; /* if 名であり、例えば "en0" */ + union { + struct sockaddr ifru_addr; + struct sockaddr ifru_dstaddr; + struct sockaddr ifru_broadaddr; + short ifru_flags; + int ifru_metric; + int ifru_mtu; + int ifru_phys; + caddr_t ifru_data; + } ifr_ifru; +#define ifr_addr ifr_ifru.ifru_addr /* アドレス */ +#define ifr_dstaddr ifr_ifru.ifru_dstaddr /* p-to-p リンクのもう一方の終端 */ +#define ifr_broadaddr ifr_ifru.ifru_broadaddr /* ブロードキャストアドレス*/ +#define ifr_flags ifr_ifru.ifru_flags /* フラグ */ +#define ifr_metric ifr_ifru.ifru_metric /* メトリック */ +#define ifr_mtu ifr_ifru.ifru_mtu /* mtu */ +#define ifr_phys ifr_ifru.ifru_phys /* 物理的な線 */ +#define ifr_data ifr_ifru.ifru_data /* インタフェースが使用 */ +}; +.Ed +.Pp +現在では非推奨のシステムコールは次の通りです。 +.Bl -tag -width SIOCGIFBRDADDR +.It Dv SIOCSIFADDR +プロトコルファミリ用のインタフェースアドレスを設定します。 +アドレスの割り当てに続いて、 +インタフェース用の ``初期化'' ルーチンが呼ばれます。 +.It Dv SIOCSIFDSTADDR +プロトコルファミリおよびインタフェース用の、 +point to point アドレスを設定します。 +.It Dv SIOCSIFBRDADDR +プロトコルファミリおよびインタフェース用の、 +ブロードキャストアドレスを設定します。 +.El +.Pp +アドレスを取得するための +.Fn ioctl +リクエストと、 +アドレス以外のデータを設定したり検索したりするためのリクエストについては、 +今でも完全にサポートしており、 +.Ar ifreq +構造体を使用しています。 +.Bl -tag -width SIOCGIFBRDADDR +.It Dv SIOCGIFADDR +プロトコルファミリ用の、インタフェースアドレスを取得します。 +.It Dv SIOCGIFDSTADDR +プロトコルファミリおよびインタフェース用の、 +point to point アドレスを取得します。 +.It Dv SIOCGIFBRDADDR +プロトコルファミリおよびインタフェース用の、 +ブロードキャストアドレスを取得します。 +.It Dv SIOCSIFFLAGS +インタフェースフラグのフィールドをセットします。もし、インタフェースが動作 +していないという印 (down) がつけられたら、 +現在そのインタフェースを通してパケットを +ルーティングしているすべてのプロセスは通知を受けます。 +インタフェースによっては、新たに入ってくるパケットをもう受け取らないように +するためにリセットするものがあります。再び動作しているという印 (up) +がつけられたら、 +インタフェースは再初期化されます。 +.It Dv SIOCGIFFLAGS +インタフェースフラグを取得します。 +.It Dv SIOCSIFMETRIC +インタフェースのルーティングメトリックを設定します。 +このメトリックは、ユーザレベルのルータのみで使用されます。 +.It Dv SIOCGIFMETRIC +インタフェースメトリックを取得します。 +.El +.Pp +新しい構造体を使用するリクエストは 2 つあります。 +.Bl -tag -width SIOCGIFBRDADDR +.It Dv SIOCAIFADDR +プロトコルによっては、 +単一のインタフェースに対して複数のアドレスを関連付けられるものがあります。 +このリクエストは、新たなアドレスを追加する +手段を提供します (あるいは、アドレスファミリ用のデフォルトアドレスが +指定されていれば、プライマリアドレスの特徴を変更します)。 +終点アドレス、ブロードキャストアドレスあるいはネットワークマスクを +設定するために別々のシステムコールを作るのではなく +(現在では、複数のプロトコルで必要不可欠な特徴です)、 +これらの 3 つのものを同時に指定するために別々の構造体を用います +(下記参照)。 +各ファミリ専用に、この構造体を少し手直ししたバージョンを使用することも +あるでしょう (各 sockaddr 構造体をファミリ特有のものに置きかえるなど)。 +sockaddr 構造体自身がデフォルトの大きさよりも大きい場合には、 +.Fn ioctl +のところで述べたように、 +.Fn ioctl +識別子自体を全体が入るように変更する必要があります。 +.It Dv SIOCDIFADDR +このリクエストは、インタフェースに関連付けられたリストから、 +指定したアドレスを削除します。このリクエストは +.Ar if_aliasreq +構造体も使用することにより、 +複数のネットワークマスクや終点アドレスを +プロトコルが許可することも可能にします。 +また、デフォルトアドレスを指定することは、 +このアドレスファミリに属するもののうちで、 +このソケットを最初に開いたときの +最初のインタフェースアドレスを削除することを意味するという約束事を、 +このリクエストは採用しています。 +.It Dv SIOCGIFCONF +インタフェースの設定リストを取得します。このリクエストは +値と結果の両用のパラメータ (value-result parameter) として +.Ar ifconf +構造体を取ります (下記参照)。 +.Ar ifc_len +フィールドには、最初に、 +.Ar ifc_buf +で指し示されたバッファの大きさをセットしておかなくてはなりません。 +戻るときに、このフィールドには設定リストのバイト単位の大きさが +入ります。 +.El +.Bd -literal +/* +* SIOCAIFCONF で使用される構造体 +*/ +struct ifaliasreq { + char ifra_name[IFNAMSIZ]; /* if 名であり、例えば "en0" */ + struct sockaddr ifra_addr; + struct sockaddr ifra_broadaddr; + struct sockaddr ifra_mask; +}; +.Ed +.Pp +.Bd -literal +/* +* SIOCGIFCONF リクエストで使用される構造体。 +* マシンのインタフェースの設定を検索するのに使用されます +* (アクセス可能なネットワークをすべて分かっておかなくてはならない +* プログラムに有用です)。 +*/ +struct ifconf { + int ifc_len; /* 関連バッファの大きさ */ + union { + caddr_t ifcu_buf; + struct ifreq *ifcu_req; + } ifc_ifcu; +#define ifc_buf ifc_ifcu.ifcu_buf /* バッファアドレス */ +#define ifc_req ifc_ifcu.ifcu_req /* 返される構造体の配列 */ +}; +.Ed +.Sh 関連項目 +.Xr ioctl 2 , +.Xr socket 2 , +.Xr intro 4 , +.Xr config 8 , +.Xr routed 8 +.Sh 歴史 +.Nm netintro +マニュアルは、 +.Bx 4.3 tahoe +で出現しました。 diff --git a/ja_JP.eucJP/man/man4/npx.4 b/ja_JP.eucJP/man/man4/npx.4 new file mode 100644 index 0000000000..92bbfa1162 --- /dev/null +++ b/ja_JP.eucJP/man/man4/npx.4 @@ -0,0 +1,79 @@ +.\" +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Christopher G. Demetriou. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software withough 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. +.\" +.\" from: npx.4,v 1.1 1993/08/06 10:58:03 cgd Exp +.\" %Id: npx.4,v 1.5 1998/10/22 14:22:13 bde Exp % +.\" jpman %Id: npx.4,v 1.3 1999/08/15 14:20:56 horikawa Stab % +.\" +.\" WORD: Numeric Processing Extension coprocessor 数値演算コプロセッサ +.\" +.Dd August 28, 1993 +.Dt NPX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm npx +.Nd 数値演算コプロセッサとエミュレータ +.Sh 書式 +.Cd "options MATH_EMULATE" +.\" XXX this is awful hackery to get it to work right... -- cgd +.Cd "device npx0 at isa? port IO_NPX tty irq 13" +.Sh 解説 +.Nm npx +ドライバは、システムに数値演算コプロセッサがあれば、 +それを利用できるようにします。 +拡張数値演算機能 (NPX) は、 +.Sy 486DX +CPU を使ったシステムや、 +.Sy 387 +または +.Sy 487SX +コプロセッサを使ったシステムに存在します。 +.Nm npx +ドライバは NPX が存在するか否かに関わらず、 +システムが正常に動作するために必要です。 +.Pp +もし NPX がシステムに存在しない場合には、 +カーネル設定ファイルに "MATH_EMULATE" オプションが +記述されていることが必要です。 +これにより、通常は NPX で実行される命令がサポートされます。 +システムに NPX が存在せず、カーネルが数学エミュレーションを付けずに +構築されている場合には、システムは起動しません。 +.Sh 警告 +エミュレータは NPX コプロセッサと比べて非常に遅いです。 +そのため、エミュレータを使わなければならないときには、 +浮動小数点演算の性能が悪くなります。 +.Sh バグ +たくさんあります。特に安っぽいマザーボード上で使った時にはそうです。 +NPX から CPU への割り込みラインが正しく結線されていない +マザーボードがあります。 +もしこのような場合に、システムが常に正常な動作をすることを望むならば、 +エミュレータを使うことが必要です。 +.Pp +超越関数命令のエミュレーションは不正確です。 +それ以外の命令のエミュレーションも怪しいです。 diff --git a/ja_JP.eucJP/man/man4/null.4 b/ja_JP.eucJP/man/man4/null.4 new file mode 100644 index 0000000000..f5bbd77a93 --- /dev/null +++ b/ja_JP.eucJP/man/man4/null.4 @@ -0,0 +1,58 @@ +.\" Copyright (c) 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)null.4 8.1 (Berkeley) 6/5/93 +.\" %Id: null.4,v 1.3 1997/03/07 02:49:28 jmg Exp % +.\" jpman %Id: null.4,v 1.3 2000/02/08 14:57:01 yt-kage Stab % +.\" +.Dd June 5, 1993 +.Dt NULL 4 +.Os +.Sh 名称 +.Nm null +.Nd null デバイス +.Sh 解説 +.Nm +デバイスは普通のファイルのように (いくらでも) データを受け入れ、 +読み込みますが、データは捨て去ります。 +.Nm null +デバイスの長さは常に 0 です。 +.Sh 関連ファイル +.Bl -tag -width /dev/null +.It Pa /dev/null +.El +.Sh 関連項目 +.Xr zero 4 +.Sh 歴史 +.Nm +デバイスは +.At v7 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/od.4 b/ja_JP.eucJP/man/man4/od.4 new file mode 100644 index 0000000000..688bc4b0eb --- /dev/null +++ b/ja_JP.eucJP/man/man4/od.4 @@ -0,0 +1,295 @@ +.\" Copyright (c) 1996,1997 Shunsuke Akiyama . +.\" 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 Shunsuke Akiyama. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Shunsuke Akiyama 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 Shunsuke Akiyama OR CONTRIBUTORS BE +.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: od.4,v 1.4 1998/03/12 07:30:17 charnier Exp % +.\" +.\" jpman %Id: od.4,v 1.3 2000/09/02 16:44:13 yt-kage Stab % +.\" Based on od.4 from Yuji +.Dd March 16, 1997 +.Dt OD 4 +.Os FreeBSD +.Sh 名称 +.Nm od +.Nd SCSI 光ディスクドライバ +.Sh 書式 +.Cd device od +.Cd device od1 at scbus0 target 3 lun 0 +.Pp +偽の ASC/ASCQ を返すドライバを使うには +.Cd options OD_BOGUS_NOT_READY +.Pp +自動回転停止機能を使うには +.Cd options OD_AUTO_TURNOFF +.Sh 解説 +.Nm +ドライバは +.Em SCSI +光ディスク (いわゆる、光磁気や相変化光学ディスク) ドライブをサポートします。 +メディアの交換や、ディスクを分割して +.Em パーティション +と呼ばれる疑似デバイスに割り当てることが可能になります。 +パーティションには +.Em raw +インタフェースと +.Em ブロックモード +インタフェースがあります。 +インタフェースは全般的に +.Xr wd 4 +や +.Xr sd 4 +の記述と同様です。 +.Pp +起動中に SCSI アダプタがプローブされるとき、デバイスを検出するために +.Em SCSI +バスが調べられます。検出されたもののうち +.Sq Em Optical (光) +かつ +.Sq Em removable (取り外し可能) +型と返されるどのデバイスも +.Nm +ドライバに接続されます。 +.Fx 2.1.5 +以降では、最初に検出されたデバイスは +.Em od0 +として接続され、次は +.Em od1 +と以下同様に続きます。 +デバイスがどの od ユニットとして稼働すべきかを指定できます。 +カーネルの構成についての詳細は +.Xr scsi 4 +を参照してください。 +.Fx 2.2 +から +.Nm +ドライバは +.Sq Em Optical (光) +かつ +.Sq Em removable (取り外し可能) +型だけでなく、 +.Sq Em Direct (直接) +かつ +.Sq Em removable (取り外し可能) +型と返されるどんなデバイスユニットも操作できます。 +.Sh パーティショニング +.Nm +ドライバはディスクに対し、2 つの階層のパーティションが可能です。 +1 つ目の層は +.Dq スライス層 +と呼ばれるもので、 +.Tn FreeBSD +領域とその他のオペレーティングシステムで使用されている領域を +分離するために用います。 +2 つ目は、 +.Xr disklabel 5 +による純然たる +.Bx 4.4 +のパーティショニング機構であり、 +.Tn FreeBSD +スライスを独自のファイルシステムに細分するために用います。 +詳細は、 +.Xr fdisk 8 +および +.Xr disklabel 8 +をそれぞれ参照してください。 +.Pp +初期化されていないディスクが開かれると、ディスク全体まで及ぶ架空の +.Tn FreeBSD +スライスによって、スライステーブルが初期化されます。 +同様に、初期化されていない (あるいは非 +.Tn FreeBSD ) +スライスが開かれると、ドライブおよびスライス全体を含む単一 +.Sq Li c +パーティションによって返されるパラメータで、ディスクラベルが初期化されます。 +.Sh カーネルの設定 +設定ファイルに +.Nm +デバイスが 1 つだけ必要です。すなわちデータ構造は、ディスクが +.Tn SCSI +バス上に検出されたとき、動的に割り当てられます。 +.Sh IOCTL +次の +.Xr ioctl 2 +コールは他のディスクだけでなく、光ディスクにも対応します。 +これらはヘッダファイル +.Aq Pa sys/disklabel.h +に定義されています。 +.Pp +.Bl -tag -width CDIOCPREVENT +.It Dv DIOCSBAD +通常、ディスク上の不良ブロックマッピングシステムを設定するために用いられます。 +SCSI ドライバは独自の不良ブロックマッピングを組み込むので、 +これは実装されていません。 +しかし、将来的には、 +SCSI 不良ブロックマッピングへの '対処的な (kludged)' インタフェースとして +実装されるかもしれません。 +.It Dv DIOCGDINFO +ドライブ用のディスクラベルの内部コピーを、カーネルをから読み込みます。 +ドライブが初期化されていない時は、架空のディスクラベルであるかもしれません。 +この場合は、SCSI 調査 (inquiry) コマンドで読み込んだ情報を含みます。 +そして起動時に表示される情報と同じになります。 +.It Dv DIOCSDINFO +ドライバに新しいディスクラベルを与えます。 +ドライバは、新しいディスクラベルをディスクに書き込みません。 +.It Dv DIOCWLABEL +ディスク上のディスクラベルに対するドライバのソフトウェアライトプロテクトを、 +有効または無効にします。 +.It Dv DIOCWDINFO +ドライバに新しいディスクラベルを与えます。 +ドライバは、新しいディスクラベルをディスクに書き込もうとします。 +.El +.Pp +次の +.Xr ioctl 2 +コールは他のディスクだけでなく、光ディスクにも対応します。 +これらはヘッダファイル +.Aq Pa sys/cdio.h +に定義されています。 +.Bl -tag -width CDIOCPREVENT +.It Dv CDIOCEJECT +光ディスクを排出します。 +.It Dv CDIOCALLOW +ドライブに対し、光ディスクの手動排出を許可します。 +.It Dv CDIOCPREVENT +ドライブに対し、光ディスクの手動排出を禁止します。 +.El +.Pp +加えて、 +.Xr scsi 4 +の一般的な ioctl は +.Nm +ドライバで使っても構いません。 +しかし 4 番目のパーティション (ディスク全体) だけは避けてください。 +.Sh 注 +現在のところ、 +.Nm +ドライバは 512, 1024, 2048 バイト/セクタのメディアに対応しています。 +raw およびブロックモードのデバイスにおける、 +非 512 バイト/セクタのメディアへのアクセスは、 +各セクタサイズ境界線の開始位置と I/O サイズに関してのみ可能です。 +.Sh 関連ファイル +.Bl -tag -width /dev/rodXXXXX -compact +.It Pa /dev/rod Ns Ar u +raw モードの +.Tn SCSI +光ディスクユニット +.Ar u +です。パーティショニングされていないデバイスとしてアクセスされます。 +.Sm off +.It Pa /dev/od Ar u Pa s Ar n +.Sm on +ブロックモードの +.Tn SCSI +光ディスクユニット +.Ar u +スライス +.Ar n +です。パーティショニングされていないデバイスとしてアクセスされます。 +.Sm off +.It Pa /dev/rod Ar u Pa s Ar n +.Sm on +raw モードの +.Tn SCSI +光ディスクユニット +.Ar u +スライス +.Ar n +です。パーティショニングされていないデバイスとしてアクセスされます。 +.It Pa /dev/od Ns Ar u Ns Ar p +ブロックモードの +.Tn SCSI +光ディスクユニット +.Ar u +の最初の +.Tn FreeBSD +スライスのパーティション +.Ar p +です。 +.It Pa /dev/rod Ns Ar u Ns Ar p +raw モードの +.Tn SCSI +光ディスクユニット +.Ar u +の最初の +.Tn FreeBSD +スライスのパーティション +.Ar p +です。 +.Sm off +.It Xo +.Pa /dev/od Ar u Pa s Ar n Ar p +.Xc +.Sm on +ブロックモードの +.Tn SCSI +光ディスクユニット +.Ar u +の +.No Ar n +番目のスライスに存在するパーティション +.Ar p +です。 +.Sm off +.It Xo +.Pa /dev/rod Ar u Pa s Ar n Ar p +.Xc +raw モードの +.Tn SCSI +光ディスクユニット +.Ar u +の +.No Ar n +番目のスライスに存在するパーティション +.Ar p +です。 +.Sm off +.It Xo +.Pa /dev/rod Ar u Pa .ctl +.Xc +.Xr scsi 8 +で使われる制御デバイスユニット +.Ar u +です。 +.El +.Sh 診断 +ありません。 +.Sh 関連項目 +.Xr fdisk 1 , +.Xr cd 4 , +.Xr scsi 4 , +.Xr sd 4 , +.Xr disklabel 5 , +.Xr disklabel 8 +.Sh 作者 +Shunsuke Akiyama +.Sh 歴史 +.Nm +ドライバは +.Fx 2.1.5 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/opie.4 b/ja_JP.eucJP/man/man4/opie.4 new file mode 100644 index 0000000000..6beed6b582 --- /dev/null +++ b/ja_JP.eucJP/man/man4/opie.4 @@ -0,0 +1,430 @@ +.\" opie.4: Overview of the OPIE software. +.\" +.\" %%% portions-copyright-cmetz-96 +.\" Portions of this software are Copyright 1996-1997 by Craig Metz, All Rights +.\" Reserved. The Inner Net License Version 2 applies to these portions of +.\" the software. +.\" You should have received a copy of the license with this software. If +.\" you didn't get a copy, you may request one from . +.\" +.\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan +.\" McDonald, All Rights Reserved. All Rights under this copyright are assigned +.\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and +.\" License Agreement applies to this software. +.\" +.\" History: +.\" +.\" Modified by cmetz for OPIE 2.2. Removed MJR DES documentation. Removed +.\" references to the old square brackets challenge delimiters. +.\" Modified at NRL for OPIE 2.01. Updated UNIX trademark credit. +.\" Definition of "seed" written by Neil Haller of Bellcore +.\" Written at NRL for OPIE 2.0. +.\" +.\" WORD: challenge チャレンジ、誰何 +.\" WORD: checksum チェックサム、検査合計(JIS-08.03.05) +.\" WORD: cryptographic checksum 暗号的検査合計、暗号的チェックサム、暗号論的チェックサム +.\" WORD: hash identifier ハッシュ識別子 +.\" WORD: keystroke キー操作 +.\" WORD: MD4 Message Digest MD4によるメッセージダイジェスト +.\" WORD: MD5 Message Digest MD5によるメッセージダイジェスト +.\" WORD: response レスポンス、応答 +.\" WORD: secret pass phrase 秘密のパスフレーズ +.\" WORD: secret password 秘密のパスワード(password:合言葉;JIS-08.06.05) +.\" WORD: secure hash セキュアハッシュ、(暗号的)ハッシュ関数、(暗号)ハッシュ関数 +.\" WORD: seed シード、種 +.\" WORD: sequence number シーケンス番号 +.\" +.TH OPIE 4 "January 10, 1995" +.\" jpman %Id: opie.4,v 1.3 2000/08/14 23:52:15 horikawa Stab % +.SH 名称 +.B OPIE \- 全てにワンタイムパスワードを +.SH 解説 +.LP +OPIE は Bellcore 社の S/Key の第 1 版の配布物から派生したパッケージです。 +このパッケージは、繰り返し攻撃 (下記参照) からシステムを守るのに役立ちます。 +OPIE ではこのような機能を果たす為に、暗号的ハッシュ関数と +チャレンジ / レスポンスシステムを用いています。 +このパッケージでは、 +.IR login (1) +や、 +.IR su (1) +および、 +.IR ftpd (8) +などとの置換えとして OPIE 認証を組み込んだプログラムを提供しています。 +更に、OPIE 認証を用いるためには、プログラムをどの様に書き直すべきか +ということも例示します。 +OPIE は、合衆国海軍研究所 (the United States Naval Research Laboratory "NRL") +において、同研究所で使用する為に開発されました。 +OPIE の或る部分は、 +Berkeley Standard Distribution UNIX 及び、 +Bellcore 社の S/Key の Version 1 の配布物から派生したものです。 +.LP +通常のユーザの観点からすれば、 +OPIE とは、ユーザのアカウントをクラックから守ってくれるものの、 +面倒くさいというのが実情でしょう。 +ユーザが初めて OPIE を使いたいと思ったときには、 +.IR opiepasswd (1) +コマンドを用いて、自分自身に関する項目を OPIE データベースに +登録する必要があります。 +その後であれば、このユーザは、OPIE を組み込んだどのようなプログラムにおいても、 +自らを認証するために OPIE を使用できます。 +他に何もクライアントが使用されていない場合には、 +.I telnet, +.I rlogin, +.I ftp +によってシステムにログインするとき、 +(モデムのような) 端末回線にログインするとき、 +他のユーザにアカウントを切替えるときに、 +OPIE を使用できます。 +通常ならユーザにパスワードの入力を求めるというような場面では、 +サーバはチャレンジを表示します。 +この時、ユーザは、チャレンジをコピーして (又は、 +ウィンドウシステムのようなもの +によってコピーペーストが行えない場合には、手でタイプし直して) +OPIE 計算機に入力し、 +更にパスワード (パスフレーズ) も OPIE 計算機に入力しなければなりません。 +それから、このユーザのパスワードとして、OPIE 計算機からレスポンス +をコピーしなければなりません +(又は、手でタイプし直さなければなりません)。 +最初は、このような手続きは厄介に思えるかもしれません。 +しかしながら、いくらか練習をすれば容易になるものです。 +.SH 術語 +.TP +.I ユーザ名 +システムがユーザを識別する名前です。例えば、"jdoe"。 +.TP +.I 秘密のパスワード +秘密のパスワードは通常ユーザが選定するもので、システムへのアクセス権を得る為に +必要となります。例えば、"SEc1_rt" 。 +.\" 注: OPIE 固有のパスワードである "pass phrase" もあるので注意！(By T.F.) +.TP +.I チャレンジ (誰何) +ユーザを認証する必要がある場合にシステムにより表示される、 +一組の情報です。 +OPIE では、チャレンジを構成する組合せは、 +ハッシュ識別子、シーケンス番号、及びシード (種) の 3 項目です。 +OPIE 計算機が適正なレスポンスを生成するには、 +これらの情報が必要です。 +例えば、"otp-md5 95 wi14321"。 +.TP +.I レスポンス (応答) +このチャレンジから生成される一組の情報は、ユーザを認証する為にシステムにより +使用されます。 +OPIE におけるレスポンスは、6 個の単語を一組にしたもので、その生成は +チャレンジと秘密のパスワードを入力して OPIE 計算機を用いて +行います。 +例えば、"PUP SOFT ROSE BIAS FLAG END"。 +.TP +.I シード (種) +これは、レスポンスを計算する為に秘密のパスワードとシーケンス番号と一緒に +使用される 1 個の情報です。 +その目的は同一の秘密のパスワードを、 +シードを変更するだけで複数のチャレンジレスポンス系列に対して +使用できるようにしたり、 +異なるシードを使うことで複数のマシンに対する認証に +使用できるようにすることです。 +.TP +.I シーケンス番号 +鍵の繰り返しを見張るために用いられるカウンタです。 +OPIE では、システムが受け取るレスポンスが成功する度に +シーケンス番号は減っていきます。 +例えば、"95" 。 +.TP +.I ハッシュ識別子 +正しいレスポンスを生成するために使用する、 +実際のアルゴリズムを識別するための文字列です。 +OPIE では、有効なハッシュ識別子は 2 つしかありません。 +1 つ目のハッシュ識別子は "otp-md4" で MD4 のハッシュ関数を指定します。 +そして、 2 つ目のハッシュ識別子は "otp-md5" で MD5 のハッシュ関数を指定します。 +.SH 繰り返し攻撃 +読者が +.IR telnet (1) +のようなネットワーク通信プログラムを使用しているときや、 +コンピュータシステムにログインするためにモデム迄も用いているときには、 +ログイン名と秘密のパスワードが必要となります。 +読者のログイン名と秘密のパスワードをシステムに入力できる人であれば、誰でも +読者であると識別されてしまいます。 +それと言うのも、理論的には読者のパスワードを知っているのは +読者しかいないはずだからです。 +残念なことに、今や多くのコンピュータ通信メディアでは盗聴が容易になっています。 +モデムや多様なネットワークによって通信するとき、 +ユーザのパスワードは遠隔地へのリンクにおいて通常安全とは言えません。 +ユーザがパスワードをネットワークに流すときクラッカーが盗聴していたら、 +そのクラッカーはパスワードのコピーを手に入れて何時でも好きなときに +読者のアカウントに侵入することができます。 +一度ならず、インターネット上の多くのサイトではこの通りの手口で +侵入されてきました。 +.LP +攻撃者にしてみればたった一度でよいからパスワードを捕捉して、 +サーバに要求されたときに +そのパスワードを繰り返しさえすればよいのです。 +たとえパスワードが符号化や暗号化されてマシン間で通信されていても、 +クラッカーが事前に捕捉していた通信を繰り返しするだけで侵入できる限り、 +ユーザは危険な状態にあります。 +ごく最近まで、Novell NetWare はこれが弱点でした。 +クラッカーには本当のパスワードが何であるかは分かりませんでした。 +しかし、クラッカーは知る必要もなかったのです +\(em 何故なら、ユーザのアカウントに侵入する為には、 +暗号化されたパスワードを捕捉しサーバに要求されたときに +そのパスワードを返信しさえすればよかったからです。 +.SH ワンタイムパスワード +繰り返し攻撃の問題に対する一つの解決策は、 +パスワードを符号化する方法を変え続ける +ことで、リンクを越えて他のシステムに送り込まれる暗号を +唯一度だけしか使用できないようにすることです。 +もしこのようなことが可能であれば、 +クラッカーは何度でも気が済む迄繰り返し攻撃が +できるでしょう \(em しかし、 +幾らやってもどこのシステムにも侵入できないでしょう。 +とはいえここで重要なことは、符号化したパスワードを元にして +真のパスワードやこれから使用する符号化したパスワードを +クラッカーが見破ってしまわない様な方法で、念入りに符号化を施すことです。 +そうしなければ、符号化しない方式や固定的な符号化の方式に比べれば +改善ではあるものの、 +やはりアカウントは侵入される可能性があります。 +.SH S/KEY アルゴリズム + +これら総ての問題に対する解決策は、1981 年に Lamport が発明しました。 +この技術は、Bellcore 研究所において Haller, Karn, Walden らにより +実装されました。 +彼らが作成したフリーソフトウェアパッケージは "S/Key" と名付けられ、 +暗号的チェックサム (暗号的検査合計) というアルゴリズムを使用していました。 +暗号的チェックサムとは優れた一方向性の関数で、 +関数の出力が分かったとしても +それでもなお攻撃者は実質的には入力が特定できないようなものです。 +そして、巡回冗長検査のチェックサム (CRC) と異なっていることは、 +暗号的チェックサムには結果が同一のハッシュ値となる入力が +殆んど無いということです。 +.LP +S/Key では、変化するのはパスワードが暗号的ハッシュ関数に代入される回数です。 +まずパスワードは暗号的ハッシュ関数に一度代入されます。 +その出力のハッシュ関数値は再び暗号的ハッシュ関数に代入されます。 +その出力値は更に又暗号的ハッシュ関数に代入されます。 +そして、この繰り返しは、パスワードが暗号的ハッシュ関数に代入される回数が +目標のシーケンス番号に達するまで続けられます。 +この方式は、まあ、例えばシーケンス番号をパスワードの前に挿入して +暗号的ハッシュ関数に一回だけ代入するやり方よりもかなり遅くはなります。 +しかし、この方式にはユーザにとってとりわけ意義深い利点があります。 +ユーザが接続しようとしているサーバマシンは +上述のゴチャゴチャの計算全体の結果が +正しいかどうかを判断するための何らかの手段を持たなければなりません。 +サーバが何らの符号化もないままか、 +或いは通常の符号化だけでパスワードを保管している +場合には、クラッカーはやはりユーザのパスワードを入手できるでしょう。 +しかしサーバマシンが暗号的ハッシュでパスワードを保持しているならば、 +シーケンス番号が変化しているのに、どうやって毎回レスポンスの変化 +を計算すれば良いのでしょうか、 +また、盗聴できないようなマシンにユーザがどうやっても辿りつけない場合には +どうすべきでしょうか？ +ユーザはリンクを越えてパスワードを送信せずに +どうやってパスワードを変更したらよいのでしょうか？ +.LP +心に留めておくべき +Lamport が考案した巧妙な解決策とは、 +シーケンス番号は常に 1 づつ減少させること、 +次に S/Key システムでは +単にシーケンス番号 N のレスポンスを暗号的ハッシュ関数に代入して +計算するだけでシーケンス番号 N+1 のレスポンスを得ることがるできこと、 +ただし、逆方向の計算はできないということです。 +.\" cf.「Lamport署名方式」の使い捨て鍵署名。(By T.F.) +さて、任意の指定された時刻に最後に有効であった +システムが持っているレスポンスのシーケンス番号を N+1 とし、 +ユーザがシステムに指定したレスポンスのシーケンス番号を N とします。 +N 番のレスポンスを生成するパスワードが N+1 番の +レスポンスを生成するパスワードと同じ場合には、N 番のレスポンスを +暗号的ハッシュ関数にもう一回代入して総計 N+1 回目の代入を行い、 +N+1 番のレスポンスと同じものを得ることができます。 +これら 2 個のレスポンスを比較して同じ場合には、N から 1 を引いて今 +証明したばかりの N 番のキーを N+1 番の新しいキーにすることができます。 +ユーザはこの新しいキーを保存して次回にキーを証明しなければならないときに +使用できます。 +このことは次のことをも意味しています。 +即ち、ユーザがパスワードを変更しなければならないのにマシンにアクセス +する安全な方法がない場合には、ユーザのパスワードを認証する為に +システムに本当に必要とされるものは、ユーザが開始したいシーケンス番号より +1 つだけ大きいシーケンス番号 +に対する有効なレスポンスであるということです。 +.LP +良い対策としてだけの理由で、実際にレスポンスを生成したり認証したりする時に、 +この全ての認証のどちらの側においても +パスワードに加えてシードを使用できます。 +これにより、万一の時に備えて状況を複雑に混ぜ返すことに多少は役立ちます。 +そうでなければ、潤沢な時間とディスクスペースを自由にできるクラッカーは、 +数多くのありふれたパスワードに対応するレスポンスを全て生成して +システムを打ち負かすことができるでしょう。 +.LP +以上記述したことは決して S/Key アルゴリズムがどう機能するかということや +幾つかのより細部の項目 +についての最良の説明ではありません。 +ですから、ユーザはこの問題について現在公開されているいくつかの論文を +参照するべきでしょう。 +以上は覆いの下で何が行われているかということについてのほんの間に合わせの +入門です。 +.SH OPIE の構成要素 + +OPIE 配布物は 3 つの標準的なクライアントプログラムに組み込まれています。 +即ち、 +.IR login (1) +, +.IR su (1) +, +及び +.IR ftpd (8) +です。 +.LP +OPIE 配布物には又、OPIE システムに固有な 3 つのプログラムがあります。 +即ち、 +.IR opiepasswd (1) +はユーザがパスワードを設定したり変更したりするのに使用します。 +.IR opieinfo (1) +はユーザが現在のシーケンス番号やシードを調べるために使用します。そして、 +.IR opiekey(1) +は OPIE 鍵計算機です。 +.SH OPIE のユーザプログラムへの組み込み + +OPIE 配布物にクライアントとして含まれている +プログラム以外のユーザプログラムに +OPIE 認証を組み込むことはさして困難なことではありません。 +まず第 1 に、プログラムのどこかに が include されていることを +確認しなければなりません。 +次に、 や他の include 宣言の後方でかつ、変数宣言の前方に、 + を include しなければなりません。 +"struct opie" 型の変数を読者のプログラムに加えなければなりません。 +読者がユーザのパスワードを格納するのに用いるバッファが OPIE_RESPONSE_MAX+1 +個の文字を充分保持できるだけ大きいことを確認する必要があります。 +そして、チャレンジ文字列を格納するバッファも OPIE_CHALLENGE_MAX+1 個の文字を +充分保持できるだけ大きいことを確認しなければなりません。 +.LP +読者がチャレンジ文字列を表示してユーザの名前を知ろうとする時は、 +opiechallenge 関数を呼出して下さい。 +更に、受取ったレスポンスを照合する為には +opieverify 関数を呼出して下さい。 +例えば、 + +.sp 0 + +.sp 0 + #include +.sp 0 + . +.sp 0 + . +.sp 0 + #include +.sp 0 + . +.sp 0 + . +.sp 0 + char *user_name; +.sp 0 + /* 常に末尾のヌル文字を忘れないこと! */ +.sp 0 + char password[OPIE_RESPONSE_MAX+1]; +.sp 0 + . +.sp 0 + . +.sp 0 + struct opie opiedata; +.sp 0 + char opieprompt[OPIE_CHALLENGE_MAX+1]; +.sp 0 + . +.sp 0 + . +.sp 0 + opiechallenge(&opiedata, user_name, opieprompt); +.sp 0 + . +.sp 0 + . +.sp 0 + if (opieverify(&opiedata, password)) { +.sp 0 + printf("Login incorrect"); +.sp 0 +.SH 端末のセキュリティと OPIE + +ユーザが OPIE を使用する際には、誰かが盗聴をしてパスワードを捕捉できるような +安全でない経路を通じてパスワードを送信しない様に注意しなければなりません。 +回線を盗聴してパスワードを取得しようとする者から、 +ユーザを OPIE は保護可能です。しかし、これは実は限られた場合であって、 +ユーザが必ずパスワードそのものを通信回線に送信しない様に +行動する時だけです。 +肝腎なことは、OPIE 計算機を動作させるマシンは、常にユーザが +現実に手元で使用しているマシンでなければならないということで \(em +決してネットワークやダイアルアップ回線の向こう側のマシンであってはいけません。 +.LP +X ウィンドウシステムに関しては注意が必要です。 +その理由は X ウィンドウシステムを使うと事情が大きく変わるからです。 +例えば、ユーザが xterm (又は好みの同等プログラム) +をどこか別のマシン上で動作させ +それをユーザのマシンに表示させる場合には、OPIE 計算機を +そのウィンドウで動作させてはいけません。 +秘密のパスワードをキーインした場合には、 +パスワードはやはりネットワーク上を xterm が +動作しているマシンまで伝送されます。 +ネットワーク越しにしか OPIE 計算機を動作させられない X 端末のようなマシン +を使用している人達は特に危険にさらされています。 +というのも、実はこのような人達には他に選択の余地がないからです。 +また、他の何らかのウィンドウシステム (例えば、NeWS) と同じように +X ウィンドウシステムを使用している場合、 +喩え OPIE 計算機をローカルマシン上で +動作させていたとしても読者のキー操作を読んでパスワードを +捕捉することは往々にして可能です。 +X サーバを守るために常に読者のシステムで利用可能な +最高のセキュリティ手段を使用するべきです。 +たとえそれが、XDM-AUTHORIZATION-1 や XDM-MAGIC-COOKIE-1、或いは +ホストアクセスコントロールであったとしても。 +＊決して＊どのマシンでも読者のサーバに接続できるようにしてはいけません。 +何故なら、こうしてしまうと、読者が気がつかないうちに、読者の何らかの +ウィンドウやキー操作を読み出すことを、任意のマシンに許すことになるからです。 +.SH 関連項目 +.BR ftpd (8) +.BR login (1), +.BR opie (4), +.BR opiekeys (5), +.BR opieaccess (5), +.BR opiekey (1), +.BR opieinfo (1), +.BR opiepasswd (1), +.sp +Lamport, L. "Password Authentication with Insecure Communication (安全でない通信におけるパスワードの認証)", +Communications of the ACM 24.11 (November 1981), pp. 770-772。 +.sp +Haller, N. "The S/KEY One-Time Password System (S/Key ワンタイムパスワードシステム)", Proceedings of the ISOC +Symposium on Network and Distributed System Security, February 1994, +San Diego, CA.。 +.sp +Haller, N. and Atkinson, R, "On Internet Authentication (インターネットの認証に関して)", RFC-1704、 +DDN Network Information Center, October 1994。 +.sp +Rivest, R. "The MD5 Message Digest Algorithm (MD5 によるメッセージダイジェストのアルゴリズム)", RFC-1321、 +DDN Network Information Center, April 1992。 +.sp +Rivest, R. "The MD4 Message Digest Algorithm (MD4 によるメッセージダイジェストのアルゴリズム)", RFC-1320、 +DDN Network Information Center, April 1992。 +.SH 作者 +Bellcore 社の S/Key は Bellcore 社の Phil Karn, +.br +Neil M. Haller, John S. Walden +が書きました。 +OPIE は NRL において Randall Atkinson, +Dan McDonald, Craig Metz +が作成しました。 + +"S/Key" はベル通信研究所 (Bell Communications Research [Bellcore]) の +所有する登録商標です。 +"UNIX" は X/Open の所有する登録商標です。 +.SH 連絡先 +OPIE は Bellcore 社の「 S/Key ユーザーズ」メーリングリスト +において議論されています。 +このメーリングリストに参加するには、申込みの電子メールを次のアドレスに +送って下さい: +.sp +skey-users-request@thumper.bellcore.com +.\" 翻訳: Tetsuro Furuya (古谷 哲郎) , 1999. +.\" ML: 猿丸(旧姓: 太田)芳彦 (Yoshihiko SARUMARU) +.\" ML: Kazuo Horikawa (堀川和雄) +.\" 査読: diff --git a/ja_JP.eucJP/man/man4/pass.4 b/ja_JP.eucJP/man/man4/pass.4 new file mode 100644 index 0000000000..e85fc4fd6f --- /dev/null +++ b/ja_JP.eucJP/man/man4/pass.4 @@ -0,0 +1,108 @@ +.\" +.\" Copyright (c) 1998 Kenneth D. Merry. +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: pass.4,v 1.2 1998/10/16 00:26:22 ken Exp % +.\" jpman %Id: pass.4,v 1.3 2000/08/10 13:48:14 horikawa Stab % +.\" +.Dd October 10, 1998 +.Dt PASS 4 +.Os FreeBSD 3.0 +.Sh NAME +.Nm pass +.Nd CAM アプリケーションパススルードライバ +.Sh 書式 +.Cd device pass0 +.Cd device pass2 at scbus0 target 3 lun 0 +.Sh 説明 +.Nm pass +ドライバはユーザランドアプリケーションに CAM CCB を発行する方法を +提供します。 +.Pp +.Nm pass +ドライバは CAM サブシステムへ直接アクセスすることを可能に +するため、このドライバへのアクセスを許可する場合、 +システム管理者は用心するべきです。 +このドライバは正しく使われないと、ユーザランドアプリケーションが +マシンをクラッシュさせたり、データの損失を引き起こすことを可能にする +かもしれません。 +.Pp +.Nm pass +ドライバは検出されたすべての +.Tn SCSI +デバイスにアタッチされます。 +そのため、 +.Tn SCSI +デバイスにアクセスする一般的な方法を提供し、 +そのデバイスに関連する "標準の" ペリフェラルドライバ +無しにユーザがアクセスすることを可能にします。 +.Sh カーネルコンフィギュレーション +必要なのは、カーネルの中に 1 つの +.Nm pass +デバイスを設定することだけです; +.Nm pass +デバイスは +.Tn SCSI +デバイスが検出された分だけ割り当てられます。 +.Sh IOCTLS +.Bl -tag -width 012345678901234 +.It CAMIOCOMMAND +任意の種類の CAM CCB を受け取り、CAM トランスポートレイヤへ通過させます。 +.It CAMGETPASSTHRU +XPT_GDEVLIST CCB を受け取り、該当するデバイスに対応するパススルーデバイス +を返します。この ioctl は +.Nm pass +ドライバで利用できますが、制限されたものです。この ioctl を +発行するときは、該当するデバイスがパススルーデバイスであること +をすでに知っていなければならないからです。 +.Xr xpt 4 +デバイスを経由してこの ioctl を発行したほうが便利でしょう。 +.El +.Sh ファイル +.Bl -tag -width 01234567890 -compact +.It Pa /dev/pass Ns Ar n +.Nm pass +ドライバのためのキャラクタ型デバイスノードです。 +CAM サブシステムを経由してアクセスされるデバイスそれぞれに +存在するべきです。 +.El +.Sh 診断 +ありません。 +.Sh 関連項目 +.Xr cam 3 , +.Xr cam_cdbparse 3 , +.Xr xpt 4 , +.Xr camcontrol 8 +.Sh 歴史 +CAM パススルードライバは +.Fx 3.0 +で初めて登場しました。 +.Sh 作者 +.An Kenneth Merry Aq ken@FreeBSD.ORG +.Sh バグ +パススルードライバを経由して非同期に CCB を送信する方法があれば +好ましいでしょう。そのためにはおそらく何らかの種類の read/write +インタフェースあるいは非同期の ioctl インタフェイスが必要でしょう。 diff --git a/ja_JP.eucJP/man/man4/pcf.4 b/ja_JP.eucJP/man/man4/pcf.4 new file mode 100644 index 0000000000..93481c0775 --- /dev/null +++ b/ja_JP.eucJP/man/man4/pcf.4 @@ -0,0 +1,65 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: pcf.4,v 1.3 1999/09/11 08:14:22 horikawa Stab % +.Dd August 6, 1998 +.Dt PCF 4 +.Os FreeBSD +.Sh 名称 +.Nm pcf +.Nd +Philips I2C バスコントローラ +.Sh 書式 +.Cd "controller pcf0 at isa? port? irq 5" +.Pp +1 つ以上の iicbus バスに対し +.Cd "controller iicbus0" +.Sh 解説 +.Em pcf +ドライバは +.Xr iicbus 4 +システム用の Philips PCF8584 I2C コントローラのサポートを提供します。 +.Pp +PCF8584 は CMOS テクノロジで設計された集積回路であり、 +ほとんどの標準的なパラレルバスマイクロコントローラ/マイクロプロセッサと +シリアル I2C バスとの間のインタフェースを提供します。 +PCF8584 はマスタとスレーブの両方の機能を提供します。 +I2C バスとの通信は割り込みかポーリングハンドシェークを使い、 +バイトを基本として実行されます。 +また、I2C バス特有のシーケンス、プロトコル、調停、タイミングの全てを +制御します。 +PCF8584 はパラレルバスシステムの I2C バスとの双方向通信を可能にしています。 +.Pp +.Sh 関連項目 +.Xr iicbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/pcm.4 b/ja_JP.eucJP/man/man4/pcm.4 new file mode 100644 index 0000000000..3f24bb5fcd --- /dev/null +++ b/ja_JP.eucJP/man/man4/pcm.4 @@ -0,0 +1,234 @@ +.\" +.\" Copyright (c) 1998, Luigi Rizzo +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: pcm.4,v 1.2 1998/10/22 14:12:55 bde Exp % +.\" +.\" Based on Japanese translation by Yasuhito FUTATSUKI +.\" [man-jp 1426] +.\" jpman %Id: pcm.4,v 1.3 2000/08/29 00:54:17 jsakai Stab % +.\" +.Dd June 3, 1998 +.Dt PCM 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm pcm +.Nd FreeBSD オーディオデバイスドライバ +.Sh 書式 +.Cd "device pcm0 at isa? port? tty irq 5 drq 1 flags 0x15" +.Sh 解説 +.Nm +ドライバは WSS/MSS 仕様または SBPro や SB16 と互換性のある +様々な ISA サウンドカードをサポートしています。 +音声入力/再生のみをサポートしており、また、ほとんどのカードで +疑似でない本当の全二重動作が可能です。 +.Pp +通常のパラメータの他に flags フィールドをセカンダリ DMA のチャネルを +指定するのに使用します +(一般的には全二重カードで音声入力するために使用します)。 +flags には、セカンダリ DMA チャネルを使用しないカードでは 0 を、 +使用する場合にはチャネル C を指定するのに 0x10 + C をセットします。 +.Pp +PnP オーディオカードも FreeBSD リリース 2.2.6 から利用できるようになった +.Nm pnp +ドライバを用いることでサポートしています。 +詳しい情報は +.Xr pnp 4 +のマニュアルページを参照して下さい。 +特に (認識された) PnP カードに割り当てられるユニット番号はレガシ ISA +デバイスの後になること、実際にドライバで使用するリソース +(port および irq と drq) は "device pcm0" の行からではなく +PnP の設定が用いられることは覚えておいてください。 +ですから、カーネルコンフィグファイルに +.Pp +.Cd "device pcm0 ..." +.Pp +のように書いたとすると、最初に見つかる PnP オーディオカードの +ユニット番号は 1 となり、/dev/audio1、/dev/dsp1 等として +アクセスすることができます。 +アプリケーションの多くは暗黙のうちに +/dev/audio を使用するようになっているので、 +以下のように /dev/audio から正しいデバイスのエントリにシンボリックリンクを +作るのがよいでしょう。 +.Pp +.Cd cd /dev +.Cd rm audio dsp dspW mixer +.Cd ./MAKEDEV snd1 +.Cd ln -s audio1 audio +.Cd ln -s dsp1 dsp +.Cd ln -s dspW1 dspW +.Cd ln -s mixer1 mixer +.Pp +本ドライバは WSS/MSS カードで最大能力を発揮します。 +WSS/MSS はすっきりした構造をしており、 +それぞれ独立した機能の集合になっています。 +偶然にもこれらのカードは市場で一番安いオーディオカードでもあります。 +SB や ESS などといった他のカードは内部構造が複雑で、 +また資料が手に入らないことも稀ではありません。 +結果、これらのカードのサポートはそれほど良くありません。 +.Pp +ドライバは装備されているハードウェアを認識し、 +正しく動作させるために出来る限りのことをします。 +したがってカーネルのコンフィグファイルに +それほど詳細な設定をする必要はありません。 +PnP カードについては自動的に識別するので実に簡単です。 +PnP でない ISA のカードについては +(カーネルコンフィグファイルで明示的にアドレスを指定して +優先させない限りは) +まずアドレス 0x530 と 0x604 で MSS カードを探し、 +その後に 0x220 と 0x240 で SB カードを探します。 + +.Sh IOCTL +本ドライバは Voxware の ioctl() のほとんどをサポートしており、 +(広く使われている mpeg プレイヤや Linux のバイナリを含めて) +ほとんどのアプリケーションは修正することなしに動作します。 +違いはいくつかはあります (その中でも重要なひとつはオーディオ +バッファをメモリマップしてアクセスする能力の違いです)。 +このためにアプリケーションの中にはオーディオモジュールに +ちょっとした変更をして再コンパイルする必要があるものもあるでしょう。 +サポートしている ioctl の完全なリストについては +/usr/include/machine/soundcard.h を参照して下さい。 + +.Sh サポートしているカード +.Pp +サポートしているコーデック (訳注: 音声の入出力を行う回路)/カードのリストを、 +PnP 設定が可能なものについては適用可能な PnP の設定情報も含めて、 +以下に示します +(デフォルトのパラメータを示しますが、 +実際のあなたのリソースはこれと違っているかもしれません。) + +.Bl -tag -width 2m % begin list +.It CS4237, CS4236, CS4232, CS4231 +.Cd "pnp 1 0 os enable port0 0x534 port2 0x220 irq0 5 drq0 1 drq1 3" +.Pp +これらのカードはすべて MSS モードで全二重で完璧に動作します。 +このチップセットは、他にもありますが、A/Open の AW35 および AW32、 +Intel のマザーボードのいくつか、 +および (CS4231は) 非 PnP のカードに使用されています。 +.Pp +Voxware の資料によれば CS4232 はバグ持ちとの報告がありますが、 +本当かどうか定かではありません。 +私の Intel 製マザーボードの 1 つでは音声入力が動作しませんが、 +これは単に音声入力の DMA チャネルが ISA の DMA コントローラに +接続されていないためです。 + +.It GUSPnP +.Cd "pnp 1 0 os enable port0 0x220 port1 0x320 port2 0x32c irq0 5 drq0 7 drq1 5" +.Pp +MSS モードで全二重をサポートしています。 +GUSPnP は、本物の CS4231 を使用しておらず、 +また mu-law 形式を扱うときのエミュレーションにバグがあると疑っています。 +このカードはもう生産されていませんので、 +わざわざカードを (mu-law で動作することがわかっている) "Mode3" に +セットする特別なコードを採り入れることはしないで +内部的に U8 形式を用いてドライバ内部でソフトウェアで形式の変換をしています。 +このことによって分解能が失われますので、 +このカードでは可能な限り 16 ビットモードを使用して下さい。 + +.It Yamaha OPL-SAx +.Cd "pnp 1 0 os enable port0 0x220 port1 0x530 port2 0x388 port3 0x370 irq0 5 drq0 1 drq1 3" +.Pp +すべてのモードで完全に動作します。 +このチップは様々な PnP カードで使用されているのみならず、 +(非 PnP モードで) マザーボードやラップトップマシンで用いられています +(たとえば東芝の Libretto)。 + +.It OPTi931 +.Cd "pnp 1 1 os enable port0 0x534 port2 0x220 port3 0xe0d irq0 10 drq0 1 drq1 6" +.Pp +このチップはバグ持ちですが、これらのチップ以外に全二重で動作するカードを +見付けることが出来なかった時期もあったので、ドライバでたくさんの回避策を +とって全二重で動作するようにしました。チップのバグのため、u-law 形式は +内部では U8 形式を用いています。 + +.It SB16, Vibra16C, および古い SB16/AWExx カード +.Cd "pnp 1 0 os enable port0 0x220 irq0 5 drq0 1 drq1 5" +.Pp +これらのコーデックは、 +片方向を 8 ビットで、もう一方を 16 ビットで使用することで、 +制限付きの全二重動作可能です。 +ドライバはこのモードでの動作をサポートしていますが、 +このモードでの動作は CreativeLabs ではサポートされていないことを +覚えておいて下さい。 + +.It Vibra16X および新しめの SB16/AWExx カード +.Cd "pnp 1 0 os enable port0 0x220 irq0 5 drq0 1 drq1 3" +.Pp +最近になって CreativeLabs はコーデック (DSP) を変更しましたが、 +新しい回路は古い物と若干異なっています。 +最も顕著な違いは 2 つの 8 ビット DMA チャネルの使用法です。 +これによって本ドライバの全二重動作サポートが動作しなくなったようです。 +ウェーブテーブルを使用することによって全二重動作は可能になるかもしれませんが、 +本ドライバではウェーブテーブルをサポートしていないので +半二重で我慢してください。 + +.It SBPro とそのクローン +その他のほとんどのカードの既定動作がこのモードです。 +それらのカードに対しては限定的な (そしてバグがあるかもしれない) +サポート、8 ビット半二重しかありません。 +(ESS チップの場合のように)時としてハードウェアがそれ以上の能力を +もっている場合でも、です。 +.El +.Pp +.Sh 診断と問題解決 +.Bl -tag -width 2m +.It "This is XXX but LDN Y is disabled" +.Pp +これは bios が PnP デバイスを使用不可のままにしており、 +手動で "-c" つきでブートして上記の pnp 設定を行わなければならないことを +示しています。 + +.It "pcmX: unit not configured, perhaps you want pcmY ?" +これは正しくないユニットを用いていることを示しています。 +一般に、正しいユニットへのシンボリックリンクを作らずに +PnP カードを使用しているときに起こります。 +/dev ディレクトリで正しいユニットを指すようにシンボリックリンクを +(場合によってはデバイスエントリも) 作り直して下さい。 + +.It "timeout flushing dbuf_out ..." +これはカードの設定に問題 (具体的には、DMA チャネル) があるか +あるいは (滅多にないことですが) ドライバに問題があるかによって、 +カードが正しく認識されていないことを示します。音声入力に使用する +DMA チャネルを確認して下さい。 + +.It capture does not work +これは入力 DMA チャネルが正しく設定されないときによく起こります。 + +.El +.Sh バグ +資料がないため、SB16 のサポート状態は十分ではありません。 +同様に、ミキサのサポートは不完全であり、 +またあなたのカードの機能 (たとえば全体の音量の制御など) の中には +すべてのデバイスについて +サポートされていないものがあるかもしれません。 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2.6 +で初めて登場しました。 +.Sh 作者 +.Nm +デバイスドライバおよびこのマニュアルページは +.An Luigi Rizzo (luigi@iet.unipi.it) +が書きました。 diff --git a/ja_JP.eucJP/man/man4/pcvt.4 b/ja_JP.eucJP/man/man4/pcvt.4 new file mode 100644 index 0000000000..149186df66 --- /dev/null +++ b/ja_JP.eucJP/man/man4/pcvt.4 @@ -0,0 +1,931 @@ +.\" +.\" Copyright (c) 1992, 1995 Hellmuth Michaelis, Brian Dunford-Shore, +.\" Joerg Wunsch and Holger Veit. +.\" +.\" 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 Hellmuth Michaelis, +.\" Brian Dunford-Shore, Joerg Wunsch and Holger Veit. +.\" 4. The name authors may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" @(#)pcvt.4, 3.20, Last Edit-Date: [Sun Apr 2 18:23:39 1995] +.\" jpman %Id: pcvt.4,v 1.3 2000/08/31 13:57:19 koich Stab % +.\" %Id: pcvt.4,v 1.14.2.1 1999/02/07 05:43:14 yokota Exp % +.\" +.\" Man page pcvt(4) created after pcvt_ioctl.h on 13-Jan-93 +.\" by Joerg Wunsch +.\" +.\" updated for rel 2.10 (-hm) +.\" updated for rel 2.20 (-hm) +.\" updated for rel 3.00 (-jw) +.\" updated for final rel 3.00 (-hm) +.\" removed references to 386BSD (-hm) +.\" +.\" WORD: virtual screen 仮想スクリーン +.\" WORD: character set 文字集合 +.Dd February 27, 1994 +.Dt PCVT 4 i386 +.Sh 名称 +.Nm pcvt , +.Nm vt +.Nd PC コンソール仮想スクリーンシステム +.Sh 書式 +options +.Do +.Em PCVT_FREEBSD = version +| +.Em PCVT_NETBSD = version +.Dc +.br +.Op options Dq Em PCVT_NSCREENS = number +.br +.Op options Dq Em PCVT_XXXX +.Po +.Sx 設定 +の項目を参照してください。 +.Pc +.Pp +.Cd "device vt0 at isa? tty" +.Sh 説明 +.Ss 概要 +.Nm pcvt +ドライバは、伝統的なコンソールドライバには無いいくつかの +機能を持った仮想スクリーンシステムを提供します。 +複数の仮想スクリーンを扱えるほか、おそらく最も重要なものは +広範囲にわたる +DEC VT-220 +.if t \(tm +.if n (TM) +エミュレーションです。詳細は +.Sx 特徴 +の項目を参照してください。 +.Pp +.Nm pcvt +ドライバを使用するには +.Nm atkbd +キーボードドライバがカーネルで設定されていることが必要です。 +.Ss 特徴 +.Bl -bullet +.It +ほぼ完全な DEC VT220 +.if t \(tm +.if n (TM) +の機能 +.Po +VT320 +.if t \(tm +.if n (TM) +へ移行中 +.Pc +。 +.It +MDA/HGC/CGA/EGA および VGA のための完全に独立な仮想端末。 +.It +それぞれの仮想スクリーンに対する 25, 28, 35, 40, 43 あるいは 50x80 +のスクリーン解像度。 +.It +各国のキーボードをサポートするための、完全に再マップ可能なキーボード。 +.It +すべての VT220 文字集合に加え、ISO Latin-1 と DEC technical をサポート。 +.It +EGA/VGA 使用時における VT220 のダウンロード可能な文字集合の利用。 +.It +それぞれの仮想端末に対する VT220 ユーザ定義キー。 +.It +Hewlett-Packard のオプショナルなファンクションキーラベルのサポート。 +.It +ファンクションコードの表示機能。 +.It +MDA, CGA, EGA および VGA ディスプレイアダプタのサポート。 +.It +VGA チップセットにおける 132 カラムのサポート。 +.It +XFree86 バージョン 1.2 以上では pccons モデル、2.0 以上では syscons +モデルを用いた X ウィンドウシステムのサポート +.Po +.Em PCVT_USL_VT_COMPAT +が設定されていることが必要です +.Pc +。 +.El + +できないこと: +.Bl -bullet +.It +2 倍角文字は扱えません。 +.It +softscroll はありません。 +.It +背景の反転はできません。 +.It +VT220 のプリンタ出力はサポートしません。 +.It +VT52 の機能のサポートは全くありません。 +.It +8 ビットコントロールは使えません。 +.It +AT キーボード +.Pq 84 キー +に対しては、 +.Pq 未だに +限定されたサポートしかありません。 +.It +お金を稼ぐのを助けることはできません... +.El +.Ss 設定 +現在 +.Nm pcvt +コンソールドライバは、 Intel ベースの +BSD オペレーティングシステムである +.Tn NetBSD/i386 +(リリース 0.9 以上) +および +.Tn FreeBSD +(リリース 1.0-GAMMA 以上) +で利用できます。 +システムからの適切なサポートを得るために、 +.Em PCVT_NETBSD +または +.Em PCVT_FREEBSD +のうちどちらかのオプションをシステムの設定ファイルで +指定しなければなりません +.Pq Xr config 8 を参照してください +。 +さらに +.Tn FreeBSD +および +.Tn NetBSD +では、これらのオプションにオペレーティングシステムのバージョン番号を +設定する必要があります。 +.Tn FreeBSD +では、バージョン番号を 3 桁の数字で表現しなければなりません。 +例えば、1.0 release +.Pq 実際にはバージョン 1.0.2 +を使っているなら、 + +.Em PCVT_FREEBSD = 102 + +のように定義しなければなりません。 + +.Em NetBSD +では、NetBSD 0.9 の場合、このバージョン番号は 9 と表現されなければならず、 +NetBSD-current (1.0 以前) の場合は 9 より大きい任意の値になります。 +NetBSD 1.0の場合は ( +.Tn FreeBSD +と同様に) +100 を、NetBSD-current では 999 を使うことが推奨されます。 +例えば +.Nx 1.0 +release の場合、 + +.Em PCVT_NETBSD = 100 + +と定義すべきです。 + +.Nm pcvt +ドライバは、すべての人の要求を満足させるため、高度に設定可能であるように +設計されてきました。望ましい設定方法は、おそらくデフォルト値を +上書きするような形で、設定ファイルに適切な +.Em options +行を書き込むことです。こうすることで、それぞれ異なる振る舞いをする +ドライバを持つ別個のカーネルを 1 台のマシン上で +コンパイルすることが可能です。 + +利用可能な設定オプションの通覧を次のリストに示します。 +詳細はカーネルソースツリーの +.Pa i386/isa/pcvt/pcvt_hdr.h +を参照してください。 + +ノート: すべてのブール値オプションについて、次のような約束をします。 +もしあるオプションが値なしで与えられた場合、1 という値 +.Pq 有効 +になります。 +オプション値として 0 が与えられた場合、そのオプションは +無効になります。それ以外の値では 1 になります。 +オプションが省略された場合、デフォルトの動作が仮定されます。 + +.Bl -tag -width indent -compact + +.It Em PCVT_NSCREENS +仮想スクリーンの数を定義します。 +.br +デフォルト: 8 + +.It Em PCVT_VT220KEYB +有効にすると、DEC VT200 (TM) に似たキーボードレイアウトが生成されます。 +無効状態では、VT220 と HP の混成が使われます。完全な説明は、 +.Nm pcvt +のドキュメントディレクトリにある +.Pa Keyboard.VT +および +.Pa Keyboard.HP +というファイルを参照してください。 +.br +デフォルト: オフ + +.It Em PCVT_SCREENSAVER +内蔵スクリーンセーバの機能を有効にします。 +.br +デフォルト: オン + +.It Em PCVT_PRETTYSCRNS +有効状態では、星が点滅するスクリーンセーバが使われます。 +無効にすると、スクリーンは単純に暗転します +.Pq これは省電力モニタに対して有用でしょう +。 +.br +デフォルト: オン + +.It Em PCVT_CTRL_ALT_DEL +有効にすると、 +.Aq Em Ctrl +.Aq Em Alt +.Aq Em Del +というキーの組合わせで CPU をリセットします。 +.br +デフォルト: オフ + +.It Em PCVT_USEKBDSEC +キーボードに対するセキュリティロックをオーバライドしません。 +.br +デフォルト: オン + +.It Em PCVT_24LINESDEF +有効にすると、オリジナルの DEC VT220 (TM) に対して互換性を +高める目的のためだけに、デフォルトの 25 行モードから 24 行モードにします。 +.Po +VT エミュレーションは 25 行で、HP エミュレーションは 28 行です +.Pc +したがって、特に変更をしなくても、それらの端末のための端末情報を利用する +ことができるでしょう。これはスタートアップオプションであることに +注意してください。 +.Xr scon 1 +ユーティリティで 24 行モードと 25 行モードを +切り替えることができます。 +.br +デフォルト: オフ + +.It Em PCVT_EMU_MOUSE +キーパッド経由で 3 ボタンマウスをエミュレートします。 +ノートブックで XFree86 を使う時に便利です。後述の +.Sx マウスエミュレーション +の項目を参照してください。 +.br +デフォルト: オフ + +.It Em PCVT_META_ESC +有効にすると、 +.Aq Em Alt +キーと共に押されたキーは、 +.Aq Em esc +により構成されるシーケンスの後に、通常のキーコードを生成します。 +無効状態では、通常のキーコードに +.Em 0x80 +を加算したものが送られます。 +.br +デフォルト: オフ + +.El + +主にデバッグやハードウェアの問題に対処するために、さらにオプションが +用意されています。 +.Pa i386/isa/pcvt/pcvt_hdr.h +に説明があります。 + +.Ss 内部機能 +.Nm pcvt +ドライバに関連するデバイスノード上のオープンファイル記述子をともなって +.Xr ioctl 2 +システムコールを呼ぶことで、 +以下に述べるような機能にアクセスすることができます。 +それらを利用するためには、プログラムは次の行を含む必要があります: + +.Dl #include + +以下に引用されたパラメータの定義は、このファイルの中に +見つけることができるでしょう。 + + +.Em キーボードに関連する機能 + +基本的なキーボードのハードウェアに関係する機能が 3 つあります。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDRESET +キーボードをリセットし、デフォルト値を設定します。 +.It KBDGTPMAT +現在のキーリピートに関する値を取得します。パラメータは +値を格納する int 型変数へのポインタです。 +.It KBDSTPMAT +現在のキーリピートに関する値を設定します。 +パラメータは上のコマンドと同様です。 +.El + +適切な定数を表すシンボル値が利用できます。 +キーリピート遅延時間の初期値を指定するのは、 +250 ミリ秒を表す KBD_TPD250 から、1000 ミリ秒を表す KBD_TPD1000 までの +250 ミリ秒刻みの値です。 +キーリピート速度は、 +毎秒 30.0 文字を表す KBD_TPM300 から、 +毎秒 2.0 文字を表す KBD_TPM20 までの値があります。 +中間値は、毎秒 30.0, 26.7, 24.0, 21.8, 20.0, 18.5, +17.1, 16.0, 15.0, 13.3, 12.0, 10.9, 10.0, 9.2, 8.6, 8.0, +7.5, 6.7, 6.0, 5.5, 5.0, 4.6, 4.3, 4.0, 3.7, 3.3, 3.0, 2.7, +2.5, 2.3, 2.1, 2.0 文字が指定できます。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDGREPSW +キーリピートスイッチの値を取得します。 +.It KBDSREPSW +キーリピートスイッチの値を設定します。 +.El + +これらも値を格納する int 型変数へのポインタをパラメータとして +受け取り、ドライバ内部のキーリピートフラグを操作します。 +可能な値は KBD_REPEATOFF あるいは KBD_REPEATON です。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDGLEDS +LED の状態を取得します。 +.It KBDSLEDS +LED の状態を設定し、キーボードのインジケータを操作します。 +ただし、ドライバが保持するキーのロック状態には影響しません。 +.El + +引数であるポインタの指す int 型変数は +KBD_SCROLLLOCK, KBD_NUMLOCK, KBD_CAPSLOCK +という値をとり、これらは論理和の組み合わせの形で使われるでしょう。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDGLOCK +SCROLL,NUM,CAPS の状態を取得します。 +.It KBDSLOCK +SCROLL,NUM,CAPS および LED の状態を設定します。 +.El + +これらも、ドライバが持つ LED フラグの状態を +設定したり取得したりするのと同じ方法で使われるべきです。 + +.Em キーボードの再マップ + +.Nm pcvt +ドライバの重要な機能の一つとして、 +内蔵のキー定義を再定義できる機能があります。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDGCKEY +現在のキーの値を取得します。 +.It KBDSCKEY +新しいキー割り当て値を設定します。 +.It KBDGOKEY +オリジナルのキー割り当て値を取得します。 +.El + +これらがその機能を構成します。これらは次に述べる +.Em struct kbd_ovlkey +へのポインタを引数として受け取ります。 +加えて、次のような関数があります。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDRMKEY +キー割り当てを解除します。対象となるキー番号を保持する int 型変数への +ポインタを受け取ります。 +.It KBDDEFAULT +すべてのキー割り当てを解除します。 +.El +.Bd -literal +struct kbd_ovlkey /* キーの完全な定義 */ +{ + u_short keynum; /* キーそのもの */ + u_short type; /* キーのタイプ。以下を参照。 */ + u_char subu; /* サブタイプ。書き込み時には無視される。 */ + char unshift[KBDMAXOVLKEYSIZE+1]; /* 非 shift 時に生成される文字列。 */ + u_char subs; /* サブタイプ。書き込み時には無視される。 */ + char shift[KBDMAXOVLKEYSIZE+1]; /* shift 時に生成される文字列。 */ + u_char subc; /* サブタイプ。書き込み時には無視される。 */ + char ctrl[KBDMAXOVLKEYSIZE+1]; /* control 時に生成される文字列。 */ + u_char suba; /* サブタイプ。書き込み時には無視される。 */ + char altgr[KBDMAXOVLKEYSIZE+1]; /* altgr 時に生成される文字列。 */ +}; +.Ed + +.Em type +フィールドの適切な値は次の通りです。 + +.Bl -tag -width 20n -offset indent -compact +.It KBD_NONE +機能なし。キーは無効。 +.It KBD_SHIFT +キーボードシフト。 +.It KBD_META +オルタネートシフト。ASCII コードの 8 ビット目をセット。 +.It KBD_NUM +数字シフト。数字キーパッドモードおよびアプリケーションモード。 +.It KBD_CTL +コントロールコードの生成。 +.It KBD_CAPS +CAPS シフト。大文字小文字を入れ替える。 +.It KBD_ASCII +ASCII コードを生成するキー。 +.It KBD_SCROLL +出力を停止する。 +.It KBD_FUNC +ファンクションキー。 +.It KBD_KP +キーパッドキー。 +.It KBD_BREAK +無視される。 +.It KBD_ALTGR +AltGr 変換機能。 +.It KBD_SHFTLOCK +シフトロック。 +.It KBD_CURSOR +カーソルキー +.It KBD_RETURN +.Dq Return +あるいは +.Dq Enter +キー。 +.El + + +.Em サブタイプ +フィールドは次のうちの どれか 1 つの値を保持します。 + +.Bl -tag -width 20n -offset indent -compact +.It KBD_SUBT_STR +キーは文字列に結び付けられています。 +.It KBD_SUBT_FNC +キーは機能に結び付けられています。 +.El + +.Em マウスエミュレーション + +マウスエミュレータは (もし設定されていれば) Mouse Systems +プロトコルを使って 3 ボタンマウスの振りをします。 +仮想スクリーンによって使われていない、最初の +.Nm pcvt +デバイスノードがマウスデバイスです。 +例えば、デフォルト値である 8 つの仮想スクリーンの場合、 +.Pa /dev/ttyv0 +から +.Pa /dev/ttyv7 +までが仮想スクリーンを表わし、 +.Pa /dev/ttyv8 +がマウスエミュレータデバイスとなるでしょう。 +マウスエミュレーションは +.Aq Em NumLock +キーを押すことによりオンになります。 +マウスポインタは数字キーパッドにより、そのキーが示す方向へ動きます。 +始めは 1 ステップずつ動き、調整可能な時間 +.Pq デフォルトは 500 ミリ秒 +の後、約 6 倍まで加速します。 +マウスボタンは 3 つの通常のキーにより +エミュレートされ、デフォルトではこれらは +.Aq Em \&F1 , +.Aq Em \&F2 , +および +.Aq Em \&F3 +のファンクションキーに割り当てられています。 +ここで 2 種類の動作が選択できます: 通常ボタンと、 +.Dq stickey +ボタンです。 +通常ボタンは、期待通りの振舞いをします。 +.Dq stickey +ボタンは、最初の押下のときに、押されていることが +通知され、そのキーがもう一度押されるか、 +他のボタンをエミュレートしているキーが押されるまで、 +.Dq 押されたまま +の状態になっています。ボタンの押下と離しは、PC 内蔵スピーカにより、それぞれ +.Dq ピリッ +とか +.Dq ピロッ +という音でユーザに通知されます。 + +次のコマンドにより、エミュレーションを制御します。 + +.Bl -tag -width 20n -offset indent -compact +.It KBDMOUSEGET +現在の定義を取得します。 +.It KBDMOUSESET +新しい定義を設定します。 +.El + +どちらも +.Li mousedefs +構造体へのポインタを ioctl 呼び出し時の 3 番目の引数として受け取ります: + +.Bd -literal +struct mousedefs { + int leftbutton; /* "左ボタン" のキーに対応する (PC) スキャンコード */ + int middlebutton; /* "中ボタン" のキーに対応する (PC) スキャンコード */ + int rightbutton; /* "右ボタン" のキーに対応する (PC) スキャンコード */ + int stickybuttons; /* 真ならば "sticky" である。 */ + int acceltime; /* マウスポインタが加速し始めるまでのマイクロ秒単位の時間 */ + /* デフォルト値: scan(F1), scan(F2), scan(F3), 偽, 500000 */ +}; +.Ed + + +.Em ダウンロード可能な文字集合のインターフェイス + +EGA および VGA ビデオアダプタは、ダウンロード可能なソフトウェアフォントを +扱うことができます。どの IBM 互換 PC ビデオボードの +.Sq ネイティブな文字集合 +も、DEC 多国籍文字集合や ISO Latin-1 +.Pq ISO 8859-1 +の完全な表現は不可能なので、これは U**X 環境にとって有用です。 + +.Bl -tag -width 20n -offset indent -compact +.It VGASETFONTATTR +フォント属性を設定します。 +.It VGAGETFONTATTR +フォント属性を取得します。 +.El + +これらはダウンロードフォントに関する情報を扱います。 +.Em struct vgafontattr +へのポインタを引数としてとります: + +.Bd -literal +struct vgafontattr { + int character_set; /* VGA 文字集合 */ + int font_loaded; /* フォントがロードされているかされていないかのマーク */ + int screen_size; /* スクリーン当たりの行数 */ + int character_scanlines; /* 文字当たりのスキャンライン数 - 1 */ + int screen_scanlines; /* スクリーン当たりのスキャンライン数 - 1 バイト */ +}; +.Ed + +それぞれのフォントのそれぞれの文字は、次の関数によりダウンロードされます。 + +.Bl -tag -width 20n -offset indent -compact +.It VGALOADCHAR +vga 文字をロードする。 +.El + +.Em struct vgaloadchar +へのポインタを引数としてとります: + +.Bd -literal +struct vgaloadchar { + int character_set; /* ロードする VGA 文字集合 */ + int character; /* ロードする文字 */ + int character_scanlines; /* 文字のスキャンライン数 */ + u_char char_table[32]; /* VGA 文字の形のテーブル */ +}; +.Ed + +EGA あるいは VGA において、 +.Em character_set +フィールドは CH_SET0, CH_SET1, CH_SET2, CH_SET3 という値を +とります。VGA では、最大 8 つのフォントをロードして持つことが +できますので、CH_SET4, CH_SET5, CH_SET6, CH_SET7 という値も +とることができます。 + +フォントサイズと、表示可能なスクリーンの +.Pq 行単位の +高さの関係は、使われるビデオカードに依存することに注意してください: + +.Bd -literal +スクリーンの大きさ (行の数) EGA VGA +フォントサイズ + +8 x 8 43 50 +8 x 10 35 40 +8 x 14 25 28 +8 x 16 利用不可 25 + +.Ed + + +.Em 一般的なスクリーン操作コマンド + +.Bl -tag -width 20n -offset indent -compact +.It VGACURSOR +カーソルの形を設定します。 +.El + +以下の構造体へのポインタを引数としてとります: +.Bd -literal +struct cursorshape { + int screen_no; /* 設定するスクリーン番号。 */ + /* -1 は現在のアクティブなスクリーン。 */ + int start; /* トップスキャンライン。0 から 文字の高さ -1 の範囲 */ + int end; /* エンドスキャンライン。0 から 文字の高さ -1 の範囲 */ +}; +.Ed + +.Bl -tag -width 20n -offset indent -compact +.It VGASETSCREEN +スクリーンの情報を設定します。 +.It VGAGETSCREEN +スクリーンの情報を取得します。 +.El + +これらは、いくつかの一般的なドライバ内部変数へのインタフェースを提供します。 +それらの内部変数は、スクリーンの振舞いを変更したり、 +単にドライバをある一つのスクリーンへ強制的に切替えたりするものです。 +以下の構造体へのポインタを引数としてとります: + +.Bd -literal +struct screeninfo { + int adaptor_type; /* インストールされているビデオアダプタの */ + /* タイプ。 */ + /* 読み取り専用。書き込み時は (未だ!) 無 */ + /* 視されます。 */ + int totalfonts; /* ダウンロード可能なフォントの数。 */ + /* 読み取り専用。書き込み時は無視されま */ + /* す。 */ + int totalscreens; /* 仮想スクリーンの数。 */ + /* 読み取り専用。書き込み時は無視されま */ + /* す。 */ + int screen_no; /* 構造体の情報を取得したスクリーン番号。 */ + /* 書き込み時に -1 ならば pure_vt_mode */ + /* または/かつ screen_size を現在のスク */ + /* リーンに適用し、それ以外ならば与えられ */ + /* た screen_no のスクリーンに適用します。*/ + int current_screen; /* 現在表示されているスクリーン番号。 */ + /* 書き込み時に -1 ならば現在表示されてい */ + /* るスクリーンをカレントスクリーンとし、 */ + /* それ以外なら現在表示されているスクリー */ + /* ンをパラメータのスクリーンに切替えま */ + /* す。 */ + int pure_vt_mode; /* 純粋な VT モードか HP/VT モードかを表 */ + /* すフラグ。 */ + /* 書き込み時に -1 ならば変更しません。 */ + int screen_size; /* スクリーンサイズ。 */ + /* 書き込み時に -1 ならば変更しません。 */ + int force_24lines; /* 純粋な VT220 のスクリーンサイズを得る */ + /* ために 25 ライン VT モードか、 */ + /* 28 ライン HP モードの場合に 24 ライン */ + /* を強制します。 */ + /* 書き込み時に -1 ならば変更ません。 */ + int vga_family; /* adaptor_type が VGA ならば、読み取り後 */ + /* チップセットファミリを反映しています。 */ + /* 書き込み時には何も起こりません... */ + int vga_type; /* adaptor_type が VGA ならば、読み取り後 */ + /* チップセットを反映しています。 */ + /* 書き込み時には何も起こりません... */ + int vga_132; /* ドライバが 132 カラムをサポートしてい */ + /* る場合、1 が設定されます。 */ + /* 現在、書き込み時には無視されます。 */ +}; +.Ed + +.Em pure_vt_mode +フィールドは、ファンクションキーラベルとステータスラインを伴う +VTxxx と HP Mode の混成に対しては M_HPVT という値を取り、 +ラベルを伴わない VTxxx シーケンスのみが認識されるものに対しては +M_PUREVT を取ります。 + +.Bl -tag -width 20n -offset indent -compact +.It VGASETCOLMS +現在のスクリーンに対してカラムの数を設定します。 +.El + +これのパラメータは、80 あるいは 132 のどちらかの値を保持する +int 型変数へのポインタです。 +カラム数 132 がサポートされるのは VGA アダプタ使用時のみです。 +サポートされないカラム数では ioctl は失敗し、 +.Em errno +.Pq Xr intro 2 を参照 +に +.Em EINVAL +が設定されます。 + +.Em VGA カラーパレットインタフェース + +VGA アダプタにおいてのみ、出力にカラーパレットレジスタが存在します。 +256 種類の内部カラーコードのそれぞれに対する 赤、緑、青の出力電圧を +保持し、0 から 63 までの値を取ります (63 はベースカラーについて +もっとも明くなる値です)。 +すなわち、これらのアダプタはそれぞれのカラーコードを、 +262144 色の中から取り出した +.Dq パレット +の色へマップします。 + +.Bl -tag -width 20n -offset indent -compact +.It VGAREADPEL +VGA パレットエントリーを読み取ります。 +.It VGAWRITEPEL +VGA パレットエントリーに書き込みます。 +.El + +これらのコマンドは、パレットレジスタに対するインタフェースを +確立します。引数は以下の構造体へのポインタです: + +.Bd -literal +struct vgapel { + unsigned idx; /* パレットへのインデクス。0 から 255 が有効。 */ + unsigned r, g, b; /* RGB の値。VGA_PMASK (63) でマスクされる。 */ +}; +.Ed + + +.Em ドライバの判別 + +.Bl -tag -width 20n -offset indent -compact +.It VGAPCVTID +現在ドライバの中にコンパイルされているのが pcvt であるかどうかの +情報と、そのメジャーリビジョンおよびマイナーリビジョン番号を +返します。引数として以下の構造体へのポインタをとります: +.El + +.Bd -literal +struct pcvtid { +#define PCVTIDNAMELN 16 /* ドライバ ID - 文字列の長さ */ + char name[PCVTIDNAMELN]; /* ドライバの名前 == PCVTIDSTR */ +#define PCVTIDNAME "pcvt" /* ドライバ ID - 文字列 */ + int rmajor; /* メジャーリビジョン番号 */ +#define PCVTIDMAJOR 3 + int rminor; /* マイナーリビジョン番号 */ +#define PCVTIDMINOR 00 +}; +.Ed + + +.Bl -tag -width 20n -offset indent -compact +.It VGAPCVTINFO +現在ドライバの中にコンパイルされているのが pcvt であるかどうかの +情報と、そのコンパイル時オプションを返します。 +引数として以下の構造体へのポインタをとります: +.El + +.Bd -literal +struct pcvtinfo { + u_int opsys; /* PCVT_xxx(x)BSD */ +#define CONF_UNKNOWNOPSYS 0 +#define CONF_386BSD 1 /* サポートされていません !!! */ +#define CONF_NETBSD 2 +#define CONF_FREEBSD 3 + u_int opsysrel; /* NetBSD/FreeBSD に対するリリース */ + u_int nscreens; /* PCVT_NSCREENS */ + u_int scanset; /* PCVT_SCANSET */ + u_int updatefast; /* PCVT_UPDATEFAST */ + u_int updateslow; /* PCVT_UPDATESLOW */ + u_int sysbeepf; /* PCVT_SYSBEEPF */ + u_int pcburst; /* PCVT_PCBURST */ + u_int kbd_fifo_sz; /* PCVT_KBD_FIFO_SZ */ + +/* 設定ブール値 */ + + u_long compile_opts; /* PCVT_xxxxxxxxxxxxxxx */ +}; +.Ed + + +.Em スクリーンセーバ + +.Nm pcvt +の設定によっては、シンプルなスクリーンセーバが利用できるかもしれません。 +これは次のコマンドにより制御します。 + +.Bl -tag -width 20n -offset indent -compact +.It VGASCREENSAVER +スクリーンセーバのタイムアウトを秒単位で設定します。 +0 はスクリーンセーバをオフにします。 +.El + +これは整数へのポインタを引数としてとります。コマンドの名前とは関係なく、 +.Xr config 8 +の +.Dq PCVT_SCREENSAVER +オプションにより設定されていれば、 +.Em どのような +種類のアダプタでも利用できます。 + +.Em USL スタイル VT のための互換コマンド + +この +.Nm pcvt +ドライバのリリース 3.00 では、仮想端末インタフェースを制御するのに使われる +USL スタイルのコマンドのサブセットをサポートします。 +この機能は、主に +.Em XFree86 +のリリース 2.0 以降で、X サーバが動いている時でも +仮想スクリーンを切替えることができるようにと意図されています。 +それらは、暗黙のセマンティクスに関して醜く +.Pq つまり、Berkeley セマンティクスを破っています +、したがって一般的な利用については推奨されません。 +それらのドキュメンテーションについては、 +.Pa i386/include/pcvt_ioctl.h +を参照してください。 + +.Sh ファイル +.Bl -tag -width /usr/include/machine/pcvt_ioctl.h +.It Pa /usr/include/machine/pcvt_ioctl.h +.Xr ioctl 2 +ファンクションコールのための定義。 +.It Pa /dev/ttyv? +.It Pa /dev/console +.Nm pcvt +ドライバへアクセスするためのデバイスノード。 +.It Pa i386/isa/pcvt/pcvt_hdr.h +.Pq カーネルソースツリーに対する相対パス +.Nm pcvt +を仕立てるための様々なコンパイル時オプションについて書かれています。 +.Sh 歴史 +.Nm pcvt +ドライバは 386BSD リリース 0.1 のために開発され、提供されてきました。 +リリース 3.00 から、NetBSD 0.9 に対する明示的なサポートが +提供されています。リリース 3.00 以降は、pcvt において 386BSD 0.1 向けの +さらなる開発はないと予想され、実際、リリース 3.20 では +386BSD のサポートは打ち切られました。 +.Sh 作者 +.An Brian Dunford-Shore Aq brian@morpheus.wustl.edu +および +.br +.if n Joerg Wunsch +.if t J\(:org Wunsch +.Aq joerg_wunsch@uriah.sax.de +らの協力の下、 +.br +.An Hellmuth Michaelis Aq hm@hcshh.hcs.de +によって書かれました。 +.br +このドライバは数人によってなされた成果を元にしています。 +特に、 +.An William Jolitz' +と +.An Don Ahn's Aq ljolitz@cardio.ucsf.edu +による歴史的な +.Xr pccons 4 +の実装、および +.An Holger Veit Aq veit@first.gmd.de +によるキーボードマップのコードによっています。 +.Sh 関連項目 +.Xr intro 2 , +.Xr ioctl 2 , +.Xr atkbd 4 , +.Xr keyboard 4 , +.Xr screen 4 , +.Xr config 8 , +.Xr ispcvt 8 +.Sh バグ +もちろん存在します。最新のバグリストは、ドキュメントディレクトリの +.Pa BugList +ファイルを参照してください。 + +.Ss 検証済みのビデオボード +.Bd -literal +製造者 チップセット モニタ + +2theMax (?) ET4000 VGA Color +Video7 Inc. Video 7 VGA Color +Diamond Stealth VRAM S3 NEC 3FGx +Trident TVGA 8800CS NEC 3D +Data General C&T P82C604 VGA Color +NoName Hercules W86855AF Mono +Kyocera (Mainboard) WD90C11 Sony Color +unknown ET3000 NEC 3D +.Ed + +.Ss 検証済みのキーボード +.Bd -literal +製造者 タイプ レイアウト + +Cherry MF II US +Cherry/Tandon MF II German +Hewlett-Packard MF II US +Hewlett-Packard MF II German +Tatung AT German +.Ed + +古い PC キーボードは全くサポートされておりません +.Pq それらは 83 個のキーがあります +。 + +F9 から F12 までは機能の制御のためにエミュレータが必要としているので、 +AT キーボード +.Pq 84 個のキーとそれとは別の数字キーパッドがあり、F11 と F12 はありません +に対するサポートは制限されています。 +また現在のキーボードドライバの設計のゆえに +ALtGr キーを持たない各国のキーボードに対する +.Pq 完全な +サポートはありません。 + +MF キーボードは、101 キーおよび 102 キーのバージョンに +ついて完全にサポートされております。 diff --git a/ja_JP.eucJP/man/man4/perfmon.4 b/ja_JP.eucJP/man/man4/perfmon.4 new file mode 100644 index 0000000000..58f9694811 --- /dev/null +++ b/ja_JP.eucJP/man/man4/perfmon.4 @@ -0,0 +1,225 @@ +.\" +.\" Copyright 1996 Massachusetts Institute of Technology +.\" +.\" Permission to use, copy, modify, and distribute this software and +.\" its documentation for any purpose and without fee is hereby +.\" granted, provided that both the above copyright notice and this +.\" permission notice appear in all copies, that both the above +.\" copyright notice and this permission notice appear in all +.\" supporting documentation, and that the name of M.I.T. not be used +.\" in advertising or publicity pertaining to distribution of the +.\" software without specific, written prior permission. M.I.T. makes +.\" no representations about the suitability of this software for any +.\" purpose. It is provided "as is" without express or implied +.\" warranty. +.\" +.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS +.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, +.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT +.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: perfmon.4,v 1.6 1998/03/12 07:30:36 charnier Exp % +.\" jpman %Id: perfmon.4,v 1.3 2000/08/10 13:48:05 horikawa Stab % +.Dd March 26, 1996 +.Dt PERFMON 4 i386 +.Os FreeBSD 2.2 +.Sh 名称 +.Nm perfmon +.Nd CPU の性能モニタリングをするインタフェース +.Sh 書式 +.Cd cpu \&"I586_CPU\&" +.Cd cpu \&"I686_CPU\&" +.Cd options PERFMON +.Sh 解説 +.Nm perfmon +ドライバにより +.Tn Intel +の +.Tn Pentium +と +.Tn "Pentium Pro" +の +CPU 内部の性能モニタリング機能にアクセスできます。 +これらのプロセッサには多彩なイベントについて発生回数または +(CPU サイクルでの) 持続時間のどちらかを測定するように設定できる +2 個の内部カウンタと、同じくクロックサイクルを数える +1 個のサイクルカウンタが実装されています。 +.Nm +ドライバではこれらの機能に対してデバイス形式によるインタフェースを提供 +します。 +.Pp +性能モニタリングをするカウンタへの全てのアクセスは +デバイス型特殊ファイルの +.Dq Pa /dev/perfmon +を媒介として処理されます。 +このデバイスが提供する +.Xr ioctl 2 +リクエストは多くあり +.Aq Pa machine/perfmon.h +の中で定義され、このファイルの中には +.Tn Pentium +と +.Tn "Pentium Pro" +プロセッサの両方の色々なカウンタの定義もあります。 +.Pp +.Sy 注意事項: +利用可能なイベントの集合はプロセッサ毎に異なります。 +使用されるイベントコードが測定される CPU の型式に対して +適正であることを確認することはプログラマの責任です。 +.Pp +以下の +.Xr ioctl 2 +リクエストが定義されています: +.Bl -tag -width PMIOTSTAMP +.It Dv PMIOSETUP +.Pq Li "struct pmc" +構造体に定義されているパラメータとフラグでカウンタを設定します。 +以下のフィールドが +.Li struct pmc +に定義されています: +.Bl -tag -width "u_char pmc_eventx" +.It Li "int pmc_num" +指定するカウンタ番号です。 +.Dv NPMC +(現在は 2) より小さくなければなりません。 +.It Li "u_char pmc_event" +モニタすべき特定のイベントコードで、 +.Aq Pa machine/perfmon.h +に定義されています。 +.It Li "u_char pmc_unit" +イベントの型に対応する装置のマスクの値です ( +.Tn Intel +の文書を参照)。 +.It Li "u_char pmc_flags" +カウンタの働きを変更するフラグ (下記参照) です。 +.It Li "u_char pmc_mask" +カウンタのマスクの値です。つまり、本来、この値は指定された数のクロック +以上 (又は以下) の間継続するイベントにカウントを制限する為に使用されるしきい値 +です。 +.El +.Pp +次のような +.Li pmc_flags +の値が定義されています: +.Bl -tag -compact -width PMCF_USRxx +.It Dv PMCF_USR +イベントをユーザモードでカウントします。 +.It Dv PMCF_OS +イベントをカーネルモードでカウントします。 +.It Dv PMCF_E +イベントを持続時間ではなくその数でカウントします。 +.It Dv PMCF_INV +カウンタのマスクの比較の意味を逆転します。 +.El +.It Dv PMIOGET +.Pq Li "struct pmc" +指定されたカウンタの現在の設定を返します。 +.It Dv PMIOSTART +.It Dv PMIOSTOP +.Pq Li int +指定したカウンタを起動 (停止) します。ハードウェアの欠陥により、番号順に +起動と停止をしなければなりません。 +(即ち、カウンタ 0 は必ずまずカウンタ 1 を停止してから停止しなければなりません)。 +ドライバではこの制約を +.Sy 強制していません +(と言うのも将来の CPU ではこの制約はなくなるかも知れません)。 +.It Dv PMIORESET +.Pq Li int +指定されたカウンタを 0 にリセットします。カウンタはリセットする前に +.Dv PMIOSTOP +により停止されなければなりません。全てのカウンタは自動的に +.Dv PMIOSETUP +によってリセットされます。 +.It Dv PMIOREAD +.Pq Li "struct pmc_data" +カウンタの現在の値を取り出します。 +.Li pmc_data +構造体には次のような 2 個のフィールドが定義されています: +.Pp +.Bl -tag -compact -width "quad_t pmcd_value" +.It Li "int pmcd_num" +読み出すカウンタの番号。 +.It Li "int pmcd_value" +64 ビットの符号付き整数での終了値。 +.El +.Pp +将来、 +.Tn "Pentium Pro" +プロセッサから +カウンタを直接読み出す為に +.Li RDPMC +命令を使用出来る様になるでしょう。 +.It Dv PMIOTSTAMP +.Pq Li "struct pmc_tstamp" +タイムスタンプカウンタを読み出します。 +.Li pmc_tstamp +構造体では 2 個のフィールドが定義されています: +.Pp +.Bl -tag -compact -width "quad_t pmct_value" +.It Li "int pmct_rate" +カウンタの MHz でのおおよその速度です。 +.It Li "quad_t pmct_value" +64 ビット整数でのカウンタの現在の値です。 +.El +.Pp +.Li pmct_rate +フィールドに与えられるカウンタの速度は、 +校正が困難な事やクロックの進行が不完全な為に、 +往々にして正確ではないことに注意する事が大切です。 +このフィールドについては +クロックが刻む速度を実際に表示するものというよりも +手がかりか又は適正さの検査くらいに考えるべきです。 +.El +.Sh 関連ファイル +.Bl -tag -compact -width "/usr/include/machine/perfmon.h" +.It Pa /dev/perfmon +カウンタへの文字型デバイスのインタフェース +.It Pa /usr/include/machine/perfmon.h +構造体とイベントコードを定義しているインクルードファイル +.It Pa /usr/share/examples/perfmon +全ての +.Fn ioctl +コマンドの使用を具体的に例示したサンプルのソースコード +.El +.Sh 関連項目 +.Xr ioctl 2 +.Rs +.%A Intel Corporation +.%B Pentium Pro Family Developer's Manual +.%D January 1996 +.%V vol. 3 +.%O Operating System Writer's Manual +.Re +.\"訳者注開始 +.Rs +.%A インテルジャパン株式会社 +.%B Pentium Pro ファミリー ディベロッパーズ マニュアル +.%D January 1996 +.%V 下巻 +.%O オペレーティング システム ライターズ マニュアル +.Re +.\"訳者注終り +.Sh 歴史 +The +.Nm +デバイスは +.Fx 2.2 +で初めて現れました。 +.Sh 作者 +.Nm +ドライバは +.An Garrett A. Wollman , +MIT Laboratory for Computer Science +が書きました。 +.\"Translated by Tetsuro Furuya , Dec. 1999. +.\"ML Checked by Tetsuya Isaki (井崎哲也) , +.\" Satoru Koizumi (小泉 悟 ) +.\"Final Checked by diff --git a/ja_JP.eucJP/man/man4/plip.4 b/ja_JP.eucJP/man/man4/plip.4 new file mode 100644 index 0000000000..bd08fcaff9 --- /dev/null +++ b/ja_JP.eucJP/man/man4/plip.4 @@ -0,0 +1,77 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: plip.4,v 1.3 1999/09/11 08:14:35 horikawa Stab % +.Dd March 5, 1998 +.Dt PLIP 4 +.Os FreeBSD +.Sh 名称 +.Nm plip +.Nd +パラレルポートネットワークインタフェース +.Sh 書式 +.Cd "device plip at ppbus?" +.Sh 解説 +.Em plip +ドライバは +.Xr lp 4 +ドライバを +.Xr ppbus 4 +システムへ移植したものです。 +.Pp +この移植の 1 つの目的は、 +パラレルポートを他のパラレルデバイスと共有できるようにすることです。 +パラレルポートバスの割り当てが元の +.Xr lp 4 +ドライバに追加されています。 +また、inb()/outb() の呼び出しは +ppbus の関数への呼び出しに置き換えられています。 +plip は ppbus インタフェースのおかげで、現在アーキテクチャ独立となっています。 +ppbus システムの詳細な情報については +.Xr ppbus 4 +を参照してください。 +.Pp +ppbus はパラレルネットワークインタフェースが up になった時に割り当てられ、 +インタフェースが down になると開放されます。 +その結果、ネットワークインタフェースが up の時は、 +パラレルポートバスは他のデバイスから使用できなくなります。 +plip は割り込み駆動であり、 +パラレルポートの割り込みを受け取るためにバスを保有する必要があります。 +.Pp +あなたの MACHINE ファイルの +.Xr ppc 4 +のエントリに net 割り込みレベルが定義されていることを確認してください... +.Sh 関連項目 +.Xr ppbus 4 , +.Xr lp 4 , +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/pn.4 b/ja_JP.eucJP/man/man4/pn.4 new file mode 100644 index 0000000000..0d5eb41b8c --- /dev/null +++ b/ja_JP.eucJP/man/man4/pn.4 @@ -0,0 +1,164 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: pn.4,v 1.3 1999/01/11 15:38:25 wpaul Exp % +.\" jpman %Id: pn.4,v 1.3 2000/07/13 04:29:38 horikawa Stab % +.\" +.Dd November 7, 1998 +.Dt PN 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm pn +.Nd +Lite-On 82c168/82c169 PNIC ファストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device pn0" +.Sh 解説 +.Nm +ドライバは Lite-On 82c168、82c169 ファストイーサネットコントローラチップを +使用した PCI イーサネットアダプタ及び組み込みコントローラをサポートします。 +これらの中には、LinkSys LNE100TX、 +Bay Networks Netgear FA310TX リビジョン D1、 +Matrox Networks FastNIC 10/100、また D-Link や Trendware をはじめとする、 +いくつかのファストイーサネットカードが含まれます。 +.Pp +バスマスタ DMA を使用する Lite-On チップは、 +DEC の 'tulip' と似た動作をするように設計されています。 +以前 DEC 21x4x デバイスを使用して設計していたたくさんのベンダが現在では +PNIC を代わりに使用しています。 +このチップは内蔵トランシーバと MII バス経由の外部トランシーバの +両方をサポートしています。 +Lite-On チップは EEPROM や MII アクセスが追加されましたが、 +DEC 21x4x コントローラとレジスタ互換であるように設計されています。 +PNIC コントローラは 10Mbps、100Mbps のそれぞれで全二重、半二重の双方を +サポートします。 +.Pp +.Nm +ドライバは以下のメディアタイプをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を許可します。ユーザは +.Pa /etc/rc.conf +ファイルにメディアオプションを追加することにより、手動で自動選択されたモードを +変更することができます。 +.It 10baseT/UTP +10Mbps 動作に設定します。さらに、 +.Ar mediaopt +オプションは +.Ar full-duplex +と +.Ar half-duplex のモードを設定するのに使えます。 +.It 100baseTX +100Mbps (ファストイーサネット) 動作に設定します。 +.Ar mediaopt +またオプションは、 +.Ar full-duplex +もしくは +.Ar half-duplex +モードで動作するように設定することもできます。 +.El +.Pp +.Nm +ドライバは以下のメディアオプションをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +強制的に半二重モードでの動作にします。 +.It half-duplex +強制的に半二重モードでの動作にします。 +.El +.Pp +メディアタイプ 100baseTX は、 +アダプタによってサポートされている場合にのみ使用可能だということに +注意してください。 +このデバイスの設定に関するより情報については、 +.Xr ifconfig 8 +も参照してください。 +.Sh 診断 +.Bl -diag +.It "pn%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "pn%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "pn%d: watchdog timeout" +デバイスがネットワークへの応答を停止したか、 +ネットワークへの接続 (ケーブル) に問題があります。 +.It "pn%d: no memory for rx list" +ドライバが受信呼出しのためのメモリバッファを確保できませんでした。 +.It "pn%d: no memory for tx list" +ドライバが、送信のためのバッファを確保できなかったか、 +送信バッファのメモリチェーンが壊れました。 +.It "pn%d: chip is in D3 power state -- setting to D0" +このメッセージはパワーマネジメントをサポートしたカードでのみ発生します。 +オペレーティングシステムによっては、シャットダウンの際にコントローラを +省電力モードにするものがあり、PCI BIOS によっては、 +チップの設定をする前にこのモードからチップを戻すことができません。 +コントローラは D3 状態ですべての +PCI コンフィギュレーションを失うため、BIOS がその時にフルパワーモードにセット +することができなければ正しい設定を行うことはできません。 +ドライバはこの状況を検出して D0 (フルパワー) 状態に持っていこうとしますが、 +これではドライバを通常の作動状態に復帰させることはできないでしょう。 +もしこのメッセージが起動時に表示されて、 +ドライバがデバイスをネットワークインタフェースとして認識することが +できなければ、 +デバイスが正しく設定されるように二度目の再起動を行う必要があります。 +.Pp +この状況は他の OS を使用していて再起動した (warm booting) +ときにだけ発生することに注意してください。もし電源を切ってから、最初に +.Fx +を起動すれば、 +カードは正しく設定されるでしょう。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +ではじめて登場しました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +によって開発されました。 +.Sh バグ +.Nm +ドライバは現在のところ、 +MII バス経由の PNIC コントローラに接続されている外部トランシーバをもつ +カードしかサポートしていません。 +これは +作者が内蔵トランシーバをテストするためのボードを入手できなかったためです。 +現在出回っている PNIC の実装のほとんどは外部 PHY を使用しており、 +したがってこのことは深刻な問題ではないでしょう。 +ハードウェアが入手できるようになれば、 +内蔵トランシーバをサポートするコードが追加されるかもしれません。 diff --git a/ja_JP.eucJP/man/man4/pnp.4 b/ja_JP.eucJP/man/man4/pnp.4 new file mode 100644 index 0000000000..9b20c43719 --- /dev/null +++ b/ja_JP.eucJP/man/man4/pnp.4 @@ -0,0 +1,221 @@ +.\" pnp(4) - manual page for the scanner device driver `asc' +.\" +.\" +.\" Copyright (c) 1997 Luigi Rizzo +.\" +.\" 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 acknowledgements: +.\" This product includes software developed by Luigi Rizzo. +.\" 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. +.\" +.\" %Id: pnp.4,v 1.2 1998/03/12 07:30:36 charnier Exp % +.\" +.\" Based on Japanese translation by Yasuhito FUTATSUKI +.\" [man-jp 1426] +.\" jpman %Id: pnp.4,v 1.3 2000/08/31 20:36:14 kuma Stab % +.\" +.Dd September 7, 1997 +.Dt PNP 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm pnp +.Nd PnP デバイスのサポート +.Sh 書式 +.Cd controller pnp0 +.Sh 解説 +.Fx +の PnP デバイスサポートによって、ユーザが PnP カードの設定を +強制設定することが可能になります。また、デバイスドライバが PnP カードの +パラメータを取得・変更することが可能になります。 +.Pp +手動で強制設定する機能を用いるためには、カーネルを +.Cd options USERCONFIG +付きでコンパイルする必要があります。 +このときカーネルは、PnP デバイスの設定を記録するための +一定の大きさのテーブル (デフォルトで 20 エントリ) を確保します。 +PnP カード 1 つが複数の独立したデバイスから構成されている +こともあります (5 つ 6 つもあるということは異常ではありません)。 +.Pp +カーネルを +.Dq Fl c +フラグ付きでブートすることで、 +PnP カードの設定変更のコマンドを使用できます。コマンドは +.Dl pnp CSN LDN +というシーケンスから始まります。ここで、CSN ならびに LDN は +それぞれ、デバイスに振られているカード選択番号 +.Pq Card Select Number +および論理デバイス番号 +.Pq Logiacal Device Number +です。 +このシーケンスに続けて、以下のコマンドの任意の組み合わせが使えます。 + +.Bl -tag -width "mmmmmmmmmm"" +.It Dv irqN Ar line +カード上の割り込み 0 または 1 +.Pq 訳注: N で指定 +に使用する IRQ 線を設定します。 +.Ar line +に 0 を指定することは、IRQ 線を使用しないことを意味します。 +.It Dv drqN Ar n +カード上の DMA 0 または 1 +.Pq 訳注: N で指定 +に使用する DRQ チャネルを設定します。 +チャネルに 4 を指定することは、チャネルを使用しないことを意味します。 +.It Dv portN Ar address +N 番目のポート領域 +.Pq port's range +の基底アドレス +.Pq base address +を設定します (N=0..7)。 +.Ar address +に 0 を指定することは、ポートを使用しないことを意味します。 +.It Dv memN Ar address +N 番目のメモリ領域 +.Pq memory's range +の基底アドレス +.Pq base address +を設定します (N=0..3)。 +.Ar address +に 0 を指定することは、メモリ領域を使用しないことを意味します。 +.It Dv bios +PnP デバイスの設定として、BIOS が設定したものを使用します。 +これはデフォルトであり、 +BIOS が PnP をサポートしている場合には通常はこれでよいでしょう。 +BIOS 設定を使用する場合には +.Dq Dv flags +以外のパラメータは無視されます。 +.It Dv os +PnP デバイスの設定に、このエントリで指定したものを使用します。 +.It Dv enable +PnP デバイスを有効にします。 +.It Dv disable +PnP デバイスを無効にします。 +.It Dv delete +デバイスに使用されているエントリを開放し、別の CSN/LDN の組を持つ +他のデバイスで使用できるようにします。 +.It Dv flags +デバイスドライバに渡す 32 ビットの flags エントリの値を設定します。 +flags は、特別な動作モードを指定するのに使われることがあります。 +(例えば、ある種のサウンドカードで SB と WSS のエミュレーションを +切り替える、など) +.El +.Pp +現在のテーブル内の設定値は、userconfig の +.Ic ls +コマンドで表示されます。 +このテーブルは、ユーザが行なった変更に加え、 +PnP デバイスドライバがアクセスしたすべての論理デバイスのエントリを +保持します。 +.Pp +テーブルの変更結果は、 +.Xr dset 8 +コマンドによってファイルシステム上のブートイメージに保存されます。 +.Pq 訳注: カーネルの ELF 化により dset コマンドは廃止されました +.Pp +.Sh PnP をサポートするデバイスドライバ +カーネルは PnP デバイスを自動的に認識して設定します。 +PnP デバイスは以下のデータ構造で識別します。 +.Bd -literal +struct pnp_device { + char *pd_name; + char *(*pd_probe ) (u_long csn, u_long vendor_id); + void (*pd_attach ) (u_long csn, u_long vend_id, char * name, + struct isa_device *dev); + u_long *pd_count; + u_int *imask; + struct isa_device dev; +}; +.Ed +.Pp +プローブ (probe) ルーチンは、渡される vendor_id が自分が +認識するものであるか、 +カード中の必要なデバイスが有効になっているかをチェックし、 +チェックに +失敗した場合には NULL 値を、成功した場合には NULL でない値 +(一般にデバイス名を指すポインタ) を返します。 +プローブルーチン内において、論理デバイスが有効であるかどうかの +チェックには、 +.Fn read_pnp_parms +を使用できます。 +.Pp +アタッチ (attach) ルーチンは、 +PnP カードを ISA アクセス可能にする、 +設定を取得する、デバイスの ISA ドライバを呼ぶ、 +といった必要な初期化をすべて行うことが必要です。 +.Pp +次のルーチンとデータ構造が使用できます。 +.Bl -tag -width "xxxxxxxxxx" +.It Dv struct pnp_cinfo +このデータ構造 +.Po +.Pa /usr/i386/isa/pnp.h +で定義されている +.Pc +は、 +PnP 論理デバイスに関連するすべての情報を含んでいます。 +.It Fn read_pnp_parms "struct pnp_cinfo *d" "int ldn" +この関数は要求された論理デバイスの設定を返します。 +この関数はプローブおよびアタッチの +ルーチンから呼ばれることだけを想定しているため、 +CSN を指定することはできません。 +.It Fn write_pnp_parms "struct pnp_cinfo *d" "int ldn" +この関数は要求された論理デバイスのパラメータを設定します。 +同時に、カーネルの強制設定用テーブルのエントリを更新します。 +BIOS や (userconfig を使用する) ユーザの方が、 +どうパラメータを設定すべきかをよく知っているはずなので、 +デバイスドライバは通常デバイスの設定を変更すべきでは +.Em ありません。 +特に、 +userconfig による強制設定メカニズムを破綻させてしまうため、 +無効になっている論理デバイスを +.Em 有効にしてはなりません。 +デバイスドライバは論理デバイスやポート領域などを無効にしても +かまいませんが、これは、 +特定のデバイスやパラメータが問題を起こすことがわかっている場合に +限るべきです。 +.It Fn enable_pnp_card void +この関数はアタッチルーチン内部で +.Em のみ、 +カードの ISA ポート/メモリのアドレス領域にアクセスする前に +.Em 呼ばなければなりません。 +.El +.Pp +.Sh 関連項目 +.Xr dset 8 +.Pq 訳注: 廃止されました +.Sh バグ +ビジュアルコンフィギュレーションには、PnP デバイス設定のサポートが +ありません。 +userconfig のコマンドで PnP デバイスの設定を取得することができれば +素晴らしいことでしょう。 +.Sh 作者 +PnP サポートは +.An Sujal Patel +が初めに手掛けたものを元に、 +.An Luigi Rizzo +が書きました。 +.Sh 歴史 +.Nm +は +.Fx 2.2.5 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/ppbus.4 b/ja_JP.eucJP/man/man4/ppbus.4 new file mode 100644 index 0000000000..b6d9c3ed13 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ppbus.4 @@ -0,0 +1,366 @@ +.\" Copyright (c) 1998, 1999 Nicolas Souchu +.\" 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. +.\" +.\" WORD: finite state automate 有限状態オートマトン +.\" WORD: compatible mode コンパチブルモード +.\" WORD: bidirectional mode 双方向モード +.\" WORD: byte mode バイトモード +.\" WORD: extended capability port mode ECP モード +.\" WORD: enhanced parallel port mode EPP モード +.\" WORD: mixed mode 混合モード +.\" +.Dd March 1, 1998 +.\" jpman %Id: ppbus.4,v 1.3 1999/08/20 11:32:02 kuma Stab % +.Dt PPBUS 4 +.Os FreeBSD +.Sh 名称 +.Nm ppbus +.Nd +パラレルポートバスシステム +.Sh 書式 +.Cd "controller ppbus0" +.Pp +.Cd "controller vpo0 at ppbus?" +.Pp +.Cd "device nlpt0 at ppbus?" +.Cd "device plip0 at ppbus?" +.Cd "device ppi0 at ppbus?" +.Cd "device pps0 at ppbus?" +.Cd "device lpbb0 at ppbus?" +.Sh 解説 +.Em ppbus +システムは、様々なパラレルデバイスを制御したり、 +異なったパラレルポートチップセットを使うためのドライバを実装するための、 +単一形態でモジュール化された、アーキテクチャに依存しないシステムを提供します。 +.Sh デバイスドライバ +新しいドライバを書いたり、すでにあるドライバを移植するために、 +ppbus システムは以下の機能を提供しています。 +.Bl -bullet -item -offset indent +.It +パラレルポートをアクセスするための、アーキテクチャに依存しないマクロや関数 +.It +いろいろなデバイスが同じパラレルポートを共有できるようにするための機構 +.It +カーネル内のデバイスと競合することなく、 +カーネルの外部からパラレルポートをアクセスすることができる +.Xr ppi 4 +と呼ばれるユーザインタフェース +.El +.Ss 新しいドライバを開発する +.Pp +ppbus システムは標準および非標準のソフトウェアの開発をサポートするために設計されてきました。 +.Pp +.Bl -column "ドライバ" -compact +.It Em ドライバ Ta Em 説明 +.It Sy vpo Ta "VPI0 パラレル - Adaptec AIC-7110 SCSI コントローラドライバ"。 +これは標準および非標準のパラレルポートアクセスを使用しています。 +.It Sy ppi Ta "一般の I/O のためのパラレルポートインタフェース" +.It Sy pps Ta "秒単位パルス (pulse per second) タイミングインタフェース" +.It Sy lpbb Ta "Philips 社公式のパラレルポート I2C ビット操作インタフェース" +.El +.Ss 現在あるドライバを移植する +.Pp +ppbus のもう 1 つのアプローチは現在あるドライバを移植するためのものです。 +いろいろなドライバが既に移植されています。 +.Pp +.Bl -column "ドライバ" -compact +.It Em ドライバ Ta Em 説明 +.It Sy nlpt Ta "lpt プリンタドライバ" +.It Sy plip Ta "lp パラレルネットワークインタフェースドライバ" +.El +.Pp +ppbus を用いることで、同様なサービスを提供する他の +オペレーティングシステムからでも、 +ソフトウェアを移植することが可能となります。 +.Sh パラレルポートチップセット +パラレルポートチップセットは +.Xr ppc 4 +によってサポートされます。 +.Pp +ppbus システムは、新しいパラレルポートバスを割り当てるための +関数とマクロを提供し、 +それと上位の周辺デバイスドライバを初期化します。 +.Pp +ppc はチップセットの検出と初期化を行った後、 +ppbus システムを初期化するために ppbus 付属関数をコールします。 +.Sh パラレルポートモデル +ppbus システムで採用された論理パラレルポートモデルは、 +PC のパラレルポートモデルです。 +さらに i386 での ppbus の実装では、 +ppc によって提供されているほとんどのサービスは inb() および outb() を +行うマクロです。 +しかし、他のアーキテクチャでは、ppbus の論理レジスタ +(データ、ステータス、制御...) へのアクセスは、 +複数の I/O アクセスが必要となるかもしれません。 +.Ss 解説 +パラレルポートは以下のモードで操作することができます。 +.Bl -bullet -item -offset indent +.It +コンパチブルモード、セントロニクスモードとも呼ばれる +.It +双方向 8/4 ビットモード、ニブルモードとも呼ばれる +.It +バイトモード、PS/2 モードとも呼ばれる +.It +ECP モード (Extended Capability Port mode) +.It +EPP モード (Enhanced Parallel Port mode) +.It +ECP と EPP の混合モード、もしくは ECP と PS/2 の混合モード +.El +.Ss コンパチブルモード +このモードは、ほとんどの PC で用いられている、 +プリンタにデータを転送するためのプロトコルを定義するものです。 +このモードでは、データはポートのデータ線にセットされ、 +プリンタのステータスがエラーがなくビジーでないことがチェックされた後、 +プリンタへのデータ送信のタイミングとして +データストローブがソフトウェアによって生成されます。 +.Pp +コンパチブルモードプロトコルでデータを転送する際に、FIFO バッファを使う +モードが実装されている I/O コントローラが多数あります。 +このモードは "高速セントロニクス" もしくは "パラレルポート FIFO モード" +と呼ばれています。 +.Ss 双方向モード +ニブルモードは、プリンタや周辺機器からの逆方向チャネルデータを +取り込むための最も一般的な方法です。 +ホストからプリンタへの転送を行なう標準モードと組み合わせることで、 +完全な双方向チャネルが提供されます。 +.Pp +このモードでは出力は 8 ビット長です。 +入力は、ステータスレジスタの 8 ビットのうち 4 ビットを +読むことにより実現されています。 +.Ss バイトモード +このモードではデータレジスタは出力用にも入力用にも使われます。 +この場合、全ての転送は 8 ビット長です。 +.Ss ECP モード +ECP プロトコルは、プリンタやスキャナタイプの周辺機器との通信のために、 +さらに進んだモードとして提案されたものです。 +EPP プロトコルと同様に、ECP モードはホストアダプタと周辺機器との間での +高性能な双方向通信を行なうための経路を提供しています。 +.Pp +ECP プロトコルには以下の機能が含まれています。 +.Bl -item -offset indent +.It +ホストアダプタ用のランレングスエンコーディング (RLE) データ圧縮 +.It +順方向および逆方向チャネル用の FIFO +.It +ホストレジスタインタフェースのためのプログラム I/O に加え DMA +.El +.Ss EPP モード +EPPプロトコルはもともと標準のパラレルポートと互換性を保ちながら、 +高性能なパラレルポートリンクを提供する手段として開発されました。 +.Ss 混合モード +SMC のように、混合モードをサポートするチップセットを供給している +製造業者がいくつかあります。 +そのようなチップセットでは、拡張制御レジスタをアクセスすることによって、 +いつでもモードを変更することができます。 +.Sh IEEE1284-1994 標準 +.Ss 背景 +この標準は "IEEE Standard Signaling Method for a Bidirectional Parallel +Peripheral Interface for Personal Computers" +(「パーソナルコンピュータのための双方向パラレル周辺機器 +インタフェースのIEEE 標準信号化方式」) +とも呼ばれています。 +これはホストとプリンタその他の周辺機器との間の、 +非同期で完全に連動して動作する双方向のパラレル通信の +信号化方法を規定したものです。 +この方式は、周辺機器識別用の文字列のフォーマットと、 +双方向データストリーム外を通じてその文字列をホストに返す方法も +規定しています。 +.Pp +この標準はアーキテクチャに依存せず、 +信号レベルでのハンドシェークのやりとりのみを規定しています。 +マシン依存のレジスタ、マッピングされたメモリ、その他 +これらの信号を制御するものすべてを操作するためには、 +アーキテクチャに特化したドキュメントを参照する必要があるでしょう。 +.Pp +IEEE1284 プロトコルは、サポートしている全てのパラレルポートモードに +対して完全に適合します。 +コンピュータはマスタとして、周辺機器はスレーブとして動作します。 +.Pp +全ての転送は有限状態オートマトンとして定義されます。 +これにより、ソフトウェアは、完全に連動して動作する信号化方式の体系を +うまく管理することができるようになります。 +コンパチブルモードはそれが「コンパチブル」なため、 +一切のネゴシエーションなしでそのままサポートされます。 +この他の全てのモードでは、周辺機器がそのモードをサポートしているかどうかを +チェックし、その後、フォワードアイドル状態の一つに入るために、 +ホストは最初にネゴシエーションが行なわれなければなりません。 +.Pp +どのような時にでも、スレーブからホストにデータを送る必要が生じることが +あるでしょう。 +スレーブからのデータ送信はフォワードアイドル状態 (ニブル、バイト、ECP...) +からのみ可能です。 +そのため、周辺機器がデータ転送要求を行うことを許可するために、 +ホストは前もってネゴシエーションを行っておく必要があります。 +時間を浪費するポーリング方式を避けるために、 +割り込みラインをデータ要求信号用として使うこともできます。 +.Pp +しかし、マスタホストにとっては、周辺からの要求は単なるヒントで +しかありません。 +ホストが転送を受け付けると、まず逆方向モードのネゴシエーションを行って、 +それから転送を開始します。 +逆方向の転送中も、ホストはいつでも転送を止めることができますし、 +スレーブももうデータがないことを信号によって知らせることができます。 +.Ss 実装 +IEEE1284 標準のサポートは、ppbus システムの上に実装されています。 +どのモードにおいても標準が規定する低レベルの特性に煩わされることなく、 +ネゴシエーション、ターミネーション、転送のような高レベルの機能を実行する +手続きのセットとして実装されています。 +.Pp +IEEE1284 は、ppbus システムとはできるだけ相互作用を +おこなわないようになっています。 +これは、現在のところ、ppbus をアクセスしたいときには +ppbus に要求をしなければならないことを意味します。 +ネゴシエーション機能では、ppbus へのアクセスは勝手には行われないと +いうことです。 +これをあとで解放しなければならないのは当然でしょう。 +.Sh アーキテクチャ +.Ss アダプタ層, ppbus 層, デバイス層 +まず、ppbus システムの最下位に +.Em アダプタ +層があります。 +これは、論理モデルをその下位にあるハードウエアにマップする、 +低レベルの関数の集合によって抽象化されたチップセットです。 +.Pp +その次には +.Em ppbus +層があり、以下の機能を提供しています。 +.Bl -enum -offset indent +.It +デイジーチェーンのように接続されたデバイス間でのパラレルポートバスの共有 +.It +ppbus に結合されたデバイスの管理 +.It +ハードウェア層をアクセスするためのアーキテクチャ独立のインタフェースの提供 +.El +.Pp +最後は +.Em デバイス +層で、パラレル周辺デバイスドライバを集めたものとなっています。 +.Pp +各階層は、それぞれが専用の C 構造体を一つ、それぞれ +ppb_adapter, ppb_data, ppb_device を持ちます。 +ppb_link 構造体は他の構造体へのポインタと、 +異なった層の間で共有する情報をまとめたものです。 +.Pp +これらの構造体については +.Xr ppbconf 9 +の説明を参照してください。 +.Ss パラレルモード管理 +いろいろな ppbus システム層において、 +動作モードを区別しなければなりません。 +実際には、ppbus とアダプタの動作モード、 +それぞれに対して、現在のモードと使用可能なモードは分離されています。 +.Pp +このレベルの抽象化によって、特定のチップセットでは、 +上位層を煩わせることなく、ネイティブモードから、拡張モードによって +エミュレートされる他のどのようなモードへでも切替えることが +できるようになるかもしれません。 +例えば、ほとんどのチップセットはニブルモードをネイティブモードとして +サポートしており、それで、ECP や EPP モードをエミュレートしています。 +.Pp +このアーキテクチャによって IEEE1284-1994 のモードをサポートでき +るはずです。 +.Sh 特徴的な機能 +.Ss ブートプロセス +ブートプロセスは ISA バス (PC アーキテクチャ) の初期化中に、 +.Xr ppc 4 +ドライバのプローブから始まります。 +ppc ドライバの attach 中に、ppbus 構造体が新しく割り当てられ +初期化 (アダプタ構造体とリンクされる) されて、関数 +.Fn ppb_attachdevs "struct ppb_data *ppb" +に渡されます。 +.Pp +.Fn ppb_attachdevs "" +は PnP パラレル周辺機器 ( +.%T "Plug and Play Parallel Port Devices" +ドラフト(c)1993-4 Microsoft Corporation +による) の検出を試みた後、プローブ処理と +既知のデバイスドライバの割り付け (attach) を行います。 +.Pp +プローブ中には、デバイスドライバは ppbus に要求を出して、 +自分の動作モードの設定を試みることになっています。 +設定された動作モードはコンテキスト構造体にセーブされ、 +ドライバが ppbus に要求したときに戻されます。 +.Ss バスの割り当てと割り込み +ppbus の割り当ては他のデバイスの I/O を破壊しては +ならないことが必須です。ppbus の割り当てのその他の使い方は、 +ポートを予約して割り込みの入力を受けることです。 +.Pp +割り込みは、 +.Fn ppcintr "" +関数に接続されています。この関数は、 +.Fn ppb_intr "struct ppb_link *pl" +の呼び出しを用いて、割り込みを ppbus に直接届けます。 +バスのオーナのハンドラが定義されていれば、 +ppbus は割り込みをそのハンドラにリダイレクトします。 +したがって、デバイスが割り込みを届けてもらいたければ、 +ppbus のオーナとならなければなりません。 +.Ss マイクロシーケンス +.Em マイクロシーケンス +はパラレルポートの高速な低レベルの操作を可能とするための、 +汎用のメカニズムです。 +マイクロシーケンスは (IEEE1284 モードにおける) 標準な転送にも、 +非標準な転送にも使うことができるでしょう。 +マイクロシーケンスの考えかたは、ppbus 層のオーバーヘッドを回避し、 +ほとんどの仕事をアダプタレベルで行おうとするものです。 +.Pp +マイクロシーケンスはオペコードとパラメータの配列です。 +各オペコードはオペレーションをコード化したものです。 +(オペコードは +.Xr microseq 9 +で解説されています。) +標準の I/O 操作は ppbus レベルで実装されていますが、 +基本的な I/O 操作とマイクロセック言語は、効率化のために +アダプタレベルでコード化されています。 +.Pp +例えば、 +.Xr vpo 4 +ドライバの実装では、 +.Bl -bullet -offset indent +.It +ニブル転送モードの変更バージョン +.It +周辺機器の初期化と選択と割り当てを行うさまざまな I/O シーケンス +.El +.Pp +を実装するためにマイクロシーケンスが使われています。 +.Sh 関連項目 +.Xr ppbconf 9 , +.Xr ppc 4 , +.Xr ppi 4 , +.Xr vpo 4 , +.Xr nlpt 4 , +.Xr plip 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で最初に登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/ppc.4 b/ja_JP.eucJP/man/man4/ppc.4 new file mode 100644 index 0000000000..5fee88cbdf --- /dev/null +++ b/ja_JP.eucJP/man/man4/ppc.4 @@ -0,0 +1,120 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: ppc.4,v 1.3 1999/09/26 12:24:37 horikawa Stab % +.\" +.\" WORD: phasis フェーズ +.\" +.Dd March 5, 1998 +.Dt PPC 4 +.Os FreeBSD +.Sh 名称 +.Nm ppc +.Nd +パラレルポートチップセットドライバ +.Sh 書式 +.Cd "controller ppc0 at isa? port? tty irq 7" +.Pp +1 つ以上の PPBUS バスに対して: +.Cd "controller ppbus at ppc0" +.Sh 解説 +.Em ppc +ドライバは、 +.Xr ppbus 4 +システム用に、 +様々なパラレルポートチップセットの低レベルのサポートを提供します。 +.Pp +プローブフェーズの間に、ppc はパラレルポートチップセットの検出を行い、 +それらの動作モード +(コンパチブル、ニブル、PS/2、EPP、ECP または他の混合モード) +に従ってプライベートなデータの初期化を行います。 +スタートアップ時にブートインタフェースの +flags 変数によってモードが指定された場合には、 +チップセットの動作モードは「flags」とその使用可能なモードによって +強制的に決定されます。 +.Pp +アタッチフェーズでは、ppc は ppbus 構造体の割り当てを行い、 +それを初期化して ppbus の attach 関数をコールします。 +.Ss サポートされているフラグ +.Bl -item -offset indent +.It +ビット 0-4: チップセット強制モード +.Bd -literal +PPB_COMPATIBLE 0x0 /* セントロニクスコンパチブルモード */ +PPB_NIBBLE 0x1 /* 反転 4 ビットモード */ +PPB_PS2 0x2 /* PS/2 バイトモード */ +PPB_EPP 0x4 /* EPP モード, 32 ビット */ +PPB_ECP 0x8 /* ECP モード */ +.Ed +.Pp +これらを組み合わせることにより混合モードとなります。 +.It +ビット 5: EPP プロトコル (0 EPP 1.9, 1 EPP 1.7) +.It +ビット 6: IRQ の活性化 (1 IRQ 無効, 0 IRQ 有効) +.El +.Ss サポートされているチップセット +ppc はいくつかのパラレルポートチップセットを明示的にサポートしています。 +それらでは検出と初期化のコードは仕様データシートに従って書かれています。 +.Bl -bullet -offset indent +.It +SMC FDC37C665GT と FDC37C666GT チップセット +.It +Natsemi PC873xx ファミリ (PC87332 と PC87306) +.It +Winbond W83877xx ファミリ (W83877F と W83877AF) +.It +SMC ライクな混合モードのチップセット ( +.Xr ppbus 4 +参照) +.El +.Ss 新しいチップセットのサポートを追加する +あなたの一番新しいマザーボードについているチップセットをサポートしたいでしょう? +ISA バスではチップセットの仕様を取り寄せて、対応する +.Fn ppc_mychipset_detect "" +関数を書くだけで良いです。 +そして汎用の +.Fn ppc_detect "" +関数にエントリを追加します。 +.Pp +あなたの +.Fn ppc_mychipset_detect "" +関数では以下のことを確認してください。 +.Va flags +ブート変数のモードフィールドがヌルでなければ、 +動作モードは強制的に指定されたモードになり、他のモードは使用不可となります。 +また、ppb->ppb_avm フィールドには、 +そのチップセットで使用できるモードが含まれています。 +.Sh 関連項目 +.Xr ppbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で最初に登場しました。 +.Sh 作者 +このマニュアルは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/ppi.4 b/ja_JP.eucJP/man/man4/ppi.4 new file mode 100644 index 0000000000..80b41efda4 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ppi.4 @@ -0,0 +1,109 @@ +.\" Copyright (c) 1997 +.\" Michael Smith +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' +.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE +.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ppi.4,v 1.1 1998/01/02 09:31:18 msmith Exp % +.\" jpman %Id: ppi.4,v 1.3 1999/09/11 08:15:15 horikawa Stab % +.\" +.Dd January 2, 1998 +.Dt PPI 4 +.Os FreeBSD +.Sh 名称 +.Nm ppi +.Nd +ppbus パラレル 'geek' ポートへのユーザ空間インタフェース +.Sh 書式 +.Cd "device ppi0 at ppbus?" +.sp +マイナー番号: ユニット番号は ppbus 番号に直接対応する。 +.Sh 解説 +.Nm +デバイスドライバはユーザアプリケーションが +パラレルポートの状態を操作するための便利な手段を提供し、 +.Pa /dev/io +インタフェースを使うことに起因するセキュリティ問題を生じることなく、 +容易に低速 I/O 操作ができるようにします。 +.Sh プログラミングインタフェース +.Pp +.Fd #include +.Fd #include +.Pp +.Nm +インタフェースでのすべての I/O は +.Fn ioctl +呼び出しを使うことによって行います。 +各々のコマンドは 1 つの +.Ty u_int8_t +引数をとり、1 バイトのデータを転送します。 +以下のコマンドを使うことができます。 +.Bl -tag -width 10 +.It PPIGDATA, PPISDATA +データレジスタの内容の読み出しと書き込みを行います。 +.It PPIGSTATUS, PPISSTATUS +ステータスレジスタの内容の読み出しと書き込みを行います。 +.It PPIGCTRL, PPISCTRL +制御レジスタの内容の読み出しと書き込みを行います。 +以下ではこのレジスタのビットに対応した定義を行っています。 +制御レジスタのビットをセットすることは相当する出力を low にすることになります。 +.Bl -tag -width 10 -compact +.It STROBE +.It AUTOFEED +.It nINIT +.It SELECTIN +.It PCD +.El +.It PPIGEPP, PPISEPP +EPP 制御レジスタの内容の読み出しと書き込みを行います。 +.It PPIGECR, PPISECR +ECP 制御レジスタの内容の読み出しと書き込みを行います。 +.It PPIGFIFO, PPISFIFO +ECP FIFO の読み書きをおこないます (8 ビット操作のみ)。 +.El +.Sh 使用例 +データポートに値 0x5a を出力するために、 +STROBE を low にした後 high に戻します。 +次のコードを使うことができます。 +.Bd -literal -compact + + int fd; + u_int8_t val; + + val = 0x5a; + ioctl(fd, PPISDATA, &val); + ioctl(fd, PPIGCTRL, &val); + val |= STROBE; + ioctl(fd, PPISCTRL, &val); + val &= ~STROBE; + ioctl(fd, PPISCTRL, &val); + +.Ed +.Sh バグ +出力信号がレジスタ値と逆になっているのは混乱を招きかねません。 +.Pp +.Fn ioctl +インタフェースは低速であり、 +複数の操作を連続して行うための方法が (まだ) ありません。 +.Pp +ユーザアプリケーションで必要なヘッダは +標準のシステムではインストールされません。 diff --git a/ja_JP.eucJP/man/man4/ppp.4 b/ja_JP.eucJP/man/man4/ppp.4 new file mode 100644 index 0000000000..f631726751 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ppp.4 @@ -0,0 +1,71 @@ +.\" %NetBSD: ppp.4,v 1.1 1996/08/10 21:26:12 explorer Exp % +.\" +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)lo.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: ppp.4,v 1.3 2000/01/03 03:15:36 horikawa Stab % +.\" +.Dd August 10, 1996 +.Dt PPP 4 +.Os +.Sh 名称 +.Nm ppp +.Nd point to point プロトコルネットワークインタフェース +.Sh 書式 +.Cd "pseudo-device ppp" Op Ar count +.Sh 解説 +.Nm ppp +インタフェースによって、 +.Em point-to-point +プロトコルを用いたネットワークインタフェースとして、 +シリアル回線を使用できます。 +.Nm ppp +インタフェースはさまざまな種類の圧縮を使用でき、そして +.Xr sl 4 +プロトコルよりも多くの機能を持っています。 +.Sh 診断 +.Bl -diag +.It ppp%d: af%d not supported. +インタフェースは不適当なアドレスファミリに含まれる +アドレス形式のメッセージを受け取りました。 +パケットは捨てられました。 +.El +.Sh 関連項目 +.Xr inet 4 , +.Xr intro 4 , +.Xr sl 4 , +.Xr pppd 8 , +.Xr pppstats 8 +.Sh バグ +現在は +.Xr ip 4 +プロトコルのみがサポートされています。 diff --git a/ja_JP.eucJP/man/man4/psm.4 b/ja_JP.eucJP/man/man4/psm.4 new file mode 100644 index 0000000000..eeae8989c2 --- /dev/null +++ b/ja_JP.eucJP/man/man4/psm.4 @@ -0,0 +1,830 @@ +.\" +.\" Copyright (c) 1997 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: psm.4,v 1.13.2.2 1999/02/10 14:49:51 yokota Exp % +.\" jpman %Id: psm.4,v 1.3 2000/08/29 00:56:36 jsakai Stab % +.\" +.Dd January 30, 1999 +.Dt PSM 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm psm +.Nd +PS/2 マウス方式のポインティングデバイス用ドライバ +.Sh 書式 +.Cd "options" \&"PSM_HOOKAPM\&" +.Cd "options" \&"PSM_RESETAFTERSUSPEND\&" +.Cd "options" \&"KBD_RESETDELAY=N\&" +.Cd "options" \&"KBD_MAXWAIT=N\&" +.Cd "options" \&"PSM_DEBUG=N\&" +.Cd "options" \&"KBDIO_DEBUG=N\&" +.Cd "device psm0 at isa? tty irq 12" +.Sh 解説 +.Nm +ドライバは PS/2 方式のポインティングデバイスについての +サポートを行ないます。 +現在、システムには唯ひとつの +.Nm +デバイスノードをおくことができます。 +PS/2 マウスポートはキーボードコントローラの補助ポートに配置されているので、 +キーボードコントローラ用のドライバである +.Nm atkbdc +も一緒にカーネルに組み込まれていなければなりません。 +なお現時点では +.Em irq +番号を変更することはできないので注意して下さい。 +.Pp +基本的な PS/2 方式のポインティングデバイスには 2 個または 3 個の +ボタンがあります。 +中にはローラ又はホイールやボタンが幾つか追加されている +デバイスもあります。 +.Ss デバイス分解能 +通常 PS/2 方式のポインティングデバイスは何段階かの分解能、即ち、 +移動についての感度を持っています。 +これらの分解能は一般に、1 インチあたり 25、50、100、200 パルス +となっています。 +デバイスによってはより細密な分解能を有しているものもあります。 +現在の分解能は実行時に変更できます。 +.Nm +ドライバでは、ユーザは予めドライバフラグを用いて分解能を +設定する +.Po Sy ドライバの設定 +を参照 +.Pc +か、または後で +.Xr ioctl 2 +コマンドの +.Dv MOUSE_SETMODE +.Po Sx IOCTL +を参照 +.Pc +を用いて分解能を変更することができます。 +.Ss 通知レート +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +デバイスがホストシステムに移動とボタン状態の報告を行なう +頻度、即ち通知レートの設定も変更可能です。 +一般的にいって PS/2 方式のポインティングデバイスは +毎秒 10、20、40、60、80、100、200 回 +の報告を送信することができます。 +.\" 訳注 ここ迄。 +60 回または 100 回毎秒の通知レートが多数のデバイスについてのデフォルト値であると +思われます。 +何の移動もなく、且つどのボタンもその状態を変更していない時は、 +そのデバイスはホストシステムに何も通知しないということに注意してください。 +通知レートは ioctl コールを用いて変更できます。 +.Ss 動作レベル +.Nm +ドライバには 3 段階の動作レベルがあります。 +現在の動作レベルは ioctl コールを用いて設定できます。 +.Pp +レベル 0 では基本的なサポートが行なわれます。 +即ち、デバイスドライバは接続されたデバイスの水平方向と垂直方向の移動 +及び最高 3 個までのボタンの状態を報告します。 +移動とボタンの状態は一連の固定長データパケット +.Po +.Sy データパケット形式 +参照 +.Pc +に符号化されます。 +レベル 0 はデフォルトの動作レベルであって、ユーザプログラム +がドライバをオープンしたとき、 +最初はこのレベルにあります。 +.Pp +動作レベル 1、即ち「拡張」レベルでは、もし存在するならローラ (又はホイール)、 +及び最高 11 個迄のボタンがサポートされます。 +ローラによる移動は Z 軸に沿った移動として報告されます。 +このレベルでは 8 バイトのデータパケットがユーザプログラムに送られます。 +.Pp +動作レベル 2 では、ポインティングデバイスからのデータはそのままユーザプログラム +に渡されます。 +最新の PS/2 方式のポインティングデバイスはしばしば固有のデータ形式を +用いています。 +その為、ユーザプログラムではこのレベルでドライバを操作するときに +特殊なデバイスからのデータ形式に関する知識に精通していることが +求められます。 +このレベルを「ネイティブ」レベルといいます。 +.Ss データパケット形式 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +.Nm +ドライバから引き渡されるデータパケットは動作レベルによって異なった形式 +になっています。 +.\" 訳注 ここ迄。 +.Pp +PS/2 マウス方式のポインティングデバイスからのデータパケットは、 +動作レベル 0 では 3 バイトあります: +.Pp +.Bl -tag -width Byte_1 -compact +.It Byte 1 +.Bl -tag -width bit_7 -compact +.It bit 7 +1 は垂直移動カウントの算術あふれを示します。 +.It bit 6 +1 は水平移動カウントの算術あふれを示します。 +.It bit 5 +垂直移動カウントが負の場合にセットされます。 +.It bit 4 +水平移動カウントが負の場合にセットされます。 +.It bit 3 +常に 1 です。 +.\" ALPS GlidePointはこのビットについてユーザがパッドの表面を「叩いた」ときに +.\" クリアし、そうでないときにはセットします。 +.\" 全てではないにしても、他の大抵のデバイスはいつもこのビットをセットします。 +.It bit 2 +中ボタンの状態; 押下されていればセットされます。中ボタンがないデバイス +では、このビットは常に 0 です。 +.It bit 1 +右ボタンの状態; 押下されていればセットされます。 +.It bit 0 +左ボタンの状態; 押下されていればセットされます。 +.El +.It Byte 2 +2 の補数での水平移動カウント; +-256 から 255 まで。 +符号ビットは第 1 バイトにあることに注意してください。 +.It Byte 3 +2 の補数での垂直移動カウント; +-256 から 255 まで。 +符号ビットは第 1 バイトにあることに注意して下さい。 +.El +.Pp +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +レベル 1 では、 +.Xr mouse 4 +に定義されている標準形式である +.Dv MOUSE_PROTO_SYSMOUSE +形式が用いられます。 +.\" ここ迄。 +.Pp +レベル 2 、即ちネイティブレベルでは、データパケットの長さと形式には標準が +ありません。 +.Ss 加速 +.Nm +ドライバはポインティングデバイスの移動をある程度「加速」することができます。 +デバイスを速く動かすほど、ポインタは画面上をより遠くまで移動します。 +ドライバには加速の効果を支配する内部変数があります。 +その変数の値はドライバフラグを用いるか又は ioctl コールを用いて +変更できます。 +.Ss デバイス番号 +.Nm +のマイナデバイス番号は次式により生成されます。 +.Bd -literal -offset indent +minor = (`unit' << 1) | `non-blocking' +.Ed +.Pp +ここで、「unit」とはデバイス番号 (通常 0) です。 +そして「非ブロッキング」ビットがセットされるのは +「プロセスブロックを行なうことでマウス入力があるまでウェイトせずに、 +直ちに復帰する」ことを示す為です。 +「非ブロッキング」ビットは \fIXFree86\fP については +セットされなければならず、 +その為 \fIXFree86\fP について通常用いられるマイナデバイス番号は 1 です。 +デバイスノード名については +.Bf Sy +関連ファイル +.Ef +を参照して下さい。 +.Sh ドライバの設定 +.Ss カーネル設定オプション +.Nm +ドライバを制御する為に以下のようなカーネル設定オプションがあります。 +これらオプションはカーネル設定ファイル +.Po Xr config 8 +を参照 +.Pc に設定できます。 +.Bl -tag -width MOUSE +.It Em PSM_HOOKAPM +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +ラップトップコンピュータの中には、システムが省電力モードから +「レジューム」した直後、どういう訳か +組み込まれた PS/2 ポインティングデバイスが操作不能になっているものがあります。 +もっとも、結局は使用可能にはなります。 +.\" 訳注 ここ迄。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +入出力操作を実行してデバイスを刺激すればデバイスを早く目覚めさせる +ことができるらしいという報告があります。 +.\" 訳注 ここ迄。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +このオプションは、一連のコードを +.Nm +ドライバに追加してAPM「レジューム」イベントをフックし、デバイスに +無害な入出力操作を施します。 +.\" ここ迄。 +.It Em PSM_RESETAFTERSUSPEND +このオプションにより上述の問題に対しもっと強力な動作を加えます。 +このオプションを指定すると、APM レジュームイベントの後 +.Nm +ドライバはデバイスをリセットします。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +このオプションを使うには +.Em PSM_HOOKAPM +オプションもまた一緒に指定して下さい。 +.\" 訳注 ここ迄。 +.It Em KBD_RESETDELAY=X, KBD_MAXWAIT=Y +.Nm +ドライバは起動の過程でポインティングデバイスをリセットしようとします。 +時々リセット後にデバイスが応答するまで時間がかかることがあります。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +これらのオプションによりドライバがどのくらいの時間待つべきかを制御します。 +.\" 訳注 ここ迄。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +ドライバは最高で +.Fa X +* +.Fa Y +ミリ秒の間ウェイトします。 +.\" 訳注 ここ迄。 +ドライバがユーザのポインティングデバイスを検出できないように見える場合には、 +ユーザはこれらの値を増加させたいと考えるかも知れません。 +デフォルト値は +.Fa X +に対しては 200 ミリ秒で +.Fa Y +に対しては 5 です。 +.It Em PSM_DEBUG=N, KBDIO_DEBUG=N +これはデバッグレベルを +.Fa N +に設定します。 +デフォルトのデバッグレベルは 0 です。 +デバッグログについては +.Bf Sy +診断 +.Ef +を参照して下さい。 +.El +.Ss ドライバフラグ +.Nm +ドライバは以下のようなフラグを受け付けます。 +カーネル設定ファイルの中かまたは起動時のユーザ設定メニュー +.Po +.Xr boot 8 +を参照 +.Pc +でこれらのフラグを +設定して下さい。 +.Pp +.Bl -tag -width MOUSE +.It bit 0..3 RESOLUTION +このフラグはポインティングデバイスの分解能を指定します。 +0 から 4 迄でなければなりません。 +この値が大きければ大きいほど、デバイスは分解能が高くなります。 +このフィールドにより指定される実際の分解能はデバイスのモデルにより +異なります。 +一般的な分解能は以下の通りです。 +.Pp +.Bl -tag -width 0_(medium_high)__ -compact +.It Em 1 (low) +25 パルス毎インチ (ppi) +.It Em 2 (medium low) +50 ppi +.It Em 3 (medium high) +100 ppi +.It Em 4 (high) +200 ppi +.El +.Pp +このフラグを 0 のままにしておけば、(それが何であれ) +デバイスのデフォルトの分解能となります。 +.It bit 4..7 ACCELERATION +このフラグは加速効果の程度を加減します。 +このフラグの値が小さければ小さいほど、移動の感度は上がります。 +許容される最小値は 1 であり、この値で最も感度が高い設定となります。 +このフラグを 0 に設定すれば完全に加速効果を無効にします。 +.It bit 8 NOCHECKSYNC +.Nm +ドライバはデータパケットの第 1 バイトの検出を +そのバイトのビットパターンを検査することにより行なおうとします。 +このやり方は大抵の PS/2 ポインティングデバイスでは旨く行きます。 +しかし既知のデバイスとあまり互換性のないデバイスの中には +このやり方と相容れないものがあるかも知れません。 +もし、あなたのポインティングデバイスが期待通りには機能していないと考えられ、 +且つカーネルが頻繁に +.Bd -literal -offset indent +psmintr: out of sync (xxxx != yyyy). +.Ed +.Pp +のようなメッセージをコンソールに表示する場合には、 +同期検査を無効にする為にこのフラグをセットして +効果があるかどうかを調べて下さい。 +.It bit 9 NOIDPROBE +このフラグが指定されると、 +.Nm +ドライバはポインティングデバイスのモデルを調査しようとしたり +モデル固有の初期化をしません。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +その場合、デバイスは標準的な PS/2 マウスのように振舞うはずです。 +.\" 訳注 ここ迄。 +ホイールや追加されたボタンのような特別な機能は +.Nm +ドライバには認識されないでしょう。 +.It bit 10 NORESET +このフラグがセットされていれば、 +デバイスを初期化するときに +.Nm +ドライバはポインティングデバイスをリセットしません。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +もし FreeBSD カーネルが他の OS の起動した後に立ち上がったなら、 +ポインティングデバイスは以前の OS の設定を継承することになります。 +.\" 訳注 ここ迄。 +しかし、 +.Nm +ドライバにはその設定を知る為の方法がないので、 +デバイスとドライバは正しく動作しないかも知れません。 +このフラグは正常な環境下では決して必要とはならないはずです。 +.It bit 11 FORCETAP +パッドデバイスの中には、デバイスの表面をユーザが「軽く叩く(タップする)」と、 +あたかも 4 番目のボタンが押されたかのように報告するものがあります +.Po +.Sy 警告 +参照 +.Pc +。 +このフラグにより +.Nm +ドライバはデバイスがこのように振舞うと仮定します。 +このフラグがなければ、 +本ドライバは ALPS GlidePoint モデルに対してのみ +このような振舞いを仮定します。 +.It bit 12 IGNOREPORTERROR +このフラグによって、PS/2 マウスポートを検査するときに +.Nm +ドライバは若干のエラー状態を無視します。 +これは正常な環境下では決して必要にはならないはずです。 +.El +.Sh IOCTL +マウスドライバにはいくつかの +.Xr ioctl 2 +コマンドがあります。 +これらのコマンドと関連する構造体及び定数は +.Ao Pa machine/mouse.h Ac +に定義されています。 +コマンドの一般的な解説は +.Xr mouse 4 +に与えられています。 +このセクションでは +.Nm +ドライバに固有の機能について解説します。 +.Pp +.Bl -tag -width MOUSE -compact +.It Dv MOUSE_GETLEVEL Ar int *level +.It Dv MOUSE_SETLEVEL Ar int *level +これらのコマンドで +.Nm +ドライバの動作レベルを操作します。 +.Pp +.It Dv MOUSE_GETHWINFO Ar mousehw_t *hw +これは接続されたデバイスのハードウェア情報を以下の構造体で返します。 +.Bd -literal +typedef struct mousehw { + int buttons; /* ボタンの数 */ + int iftype; /* I/F の種類 */ + int type; /* マウス/トラックボール/パッド... */ + int model; /* I/F に固有のモデル ID */ + int hwid; /* I/F に固有のハードウェア ID */ +} mousehw_t; +.Ed +.Pp +.Dv buttons +フィールドはデバイスにあるボタンの数を保持します。 +現在 +.Nm +ドライバは Logitech 製の 3 ボタンマウスを検出して +そのように報告することができます。 +他のメーカ製の 3 ボタンマウスについては正しく報告されるかどうかは +分かりません。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +しかし、 +ボタンの数が正しく検出されてもされなくてもドライバの運用には影響しません。 +.\" 訳注 ここ迄。 +.Pp +.Dv iftype +フィールドは常に +.Dv MOUSE_IF_PS2 +です。 +.Pp +.Dv type +フィールドは次のようなデバイスの種類を示します。即ち +.Dv MOUSE_MOUSE , +.Dv MOUSE_TRACKBALL , +.Dv MOUSE_STICK , +.Dv MOUSE_PAD , +.Dv MOUSE_UNKNOW +です。 +ユーザはこのフィールドに頼り過ぎてはいけません。 +というのは、ドライバは必ずしも常に +デバイスの種類を識別できる訳ではないからです。 +.\" 訳注 以下は 本マニュアルの作者である横田氏に加筆修正していただきました。 +実際のところデバイスの種類を識別できることは稀なのです。 +.\" 訳注 ここ迄。 +.Pp +.Dv model +フィールドは動作レベル 0 では常に +.Dv MOUSE_MODEL_GENERIC +です。 +これはより高次の動作レベルでは +.Dv MOUSE_MODEL_GENERIC +かまたは +.Dv MOUSE_MODEL_XXX +のうちのどれか 1 つになるかも知れません。 +この場合にも +.Nm +ドライバがこのフィールドに適切な値をセットするかどうかは分かりません。 +.Pp +.Dv hwid +フィールドはデバイスにより返された ID の値です。 +一般的な ID は以下の通りです。 +.Pp +.Bl -tag -width 0__ -compact +.It Em 0 +マウス (Microsoft, Logitech 及び他の多数のメーカ) +.It Em 2 +Microsoft Ballpoint mouse +.It Em 3 +Microsoft IntelliMouse +.El +.Pp +.It Dv MOUSE_GETMODE Ar mousemode_t *mode +このコマンドによりマウスドライバの現在の動作パラメータを得ます。 +.Bd -literal +typedef struct mousemode { + int protocol; /* MOUSE_PROTO_XXX */ + int rate; /* 通知レート (毎秒)、不明の時は -1 */ + int resolution; /* MOUSE_RES_XXX、不明の時は -1 */ + int accelfactor; /* 加速因子 */ + int level; /* ドライバの動作レベル */ + int packetsize; /* データパケットの長さ */ + unsigned char syncmask[2]; /* 同期ビット */ +} mousemode_t; +.Ed +.Pp +.Dv protocol +フィールドは動作レベル 0 と 2 では +.Dv MOUSE_PROTO_PS2 +です。 +動作レベル 1 では、 +.Dv MOUSE_PROTO_SYSMOUSE +です。 +.Pp +.Dv rate +フィールドは状態を通知する頻度 (1 秒当りに報告する回数) で、 +この頻度でデバイスはホストコンピュータに移動の報告を送ります。 +サポートされている一般的な値は、10, 20, 40, 60, 80, 100, 200 です。 +中には他の任意の値をも受容するマウスもあるでしょう。 +.Pp +.Dv resolution +フィールドはポインティングデバイスの分解能で、定数 +.Dv MOUSE_RES_XXX +の中のいずれかひとつの値かまたはある正の値です。 +この値が大きいほど、マウスは分解能が細密になります。 +定数 +.Dv MOUSE_RES_XXX +によって指定される実際の分解能はマウスのモデルによって異なります。 +一般的な分解能は次の通りです: +.Pp +.Bl -tag -width MOUSE_RES_MEDIUMHIGH__ -compact +.It Dv MOUSE_RES_LOW +25 ppi +.It Dv MOUSE_RES_MEDIUMLOW +50 ppi +.It Dv MOUSE_RES_MEDIUMHIGH +100 ppi +.It Dv MOUSE_RES_HIGH +200 ppi +.El +.Pp +.Dv accelfactor +フィールドは加速機能 +.Po Sy 加速 +を参照 +.Pc +を管理する為の値を保持します。 +この値は 0 か正でなければなりません。 +もしこの値が 0 であれば、加速は無効となります。 +.Pp +.Dv packetsize +フィールドはデータパケットの長さを示します。 +これは動作レベルやポインティングデバイスのモデルによって変わります。 +.Pp +.Bl -tag -width level_0__ -compact +.It Em level 0 +3 バイト +.It Em level 1 +8 バイト +.It Em level 2 +デバイスのモデルで決まります +.El +.Pp +配列である +.Dv syncmask +フィールドはデータパケットの第 1 バイトを検出する為の +ビットマスクとビットパターンを保持します。 +.Dv syncmask[0] +フィールドは各バイトと AND をとるためのビットマスクです。 +その結果が +.Dv syncmask[1] +フィールドに等しい場合には、恐らくそのバイトはデータパケットの第 1 バイト +であろう思われます。 +注意すべきことは、この検出方法は 100% 信頼できるものではなく、そのため、 +単に参考となる手段でしかないと見なすべきことです。 +.Pp +.It Dv MOUSE_SETMODE Ar mousemode_t *mode +このコマンドはマウスドライバの現在の動作パラメータを +.Ar mode +フィールドに指定された通りに変更します。 +.Dv rate , +.Dv resolution , +.Dv level , +.Dv accelfactor +の各フィールドだけが変更できます。 +その他のフィールドに値をセットしても +エラーを生成しませんし効果もありません。 +.Pp +あるフィールドの現在の設定を変更したくない場合には、 +そのフィールドに -1 を入れて下さい。 +.Dv resolution +フィールドと +.Dv rate +フィールドには 0 を入れることもでき、この場合にはそのフィールドのデフォルト値 +が設定されます。 +.\" .Pp +.\" .It Dv MOUSE_GETVARS Ar mousevar_t *vars +.\" .It Dv MOUSE_SETVARS Ar mousevar_t *vars +.\" これらのコマンドは +.\" .Nm +.\" ドライバはサポートしていません。 +.Pp +.It Dv MOUSE_READDATA Ar mousedata_t *data +.\" このコマンドは生のデータをデバイスから読みだします。 +.\" .Bd -literal +.\" typedef struct mousedata { +.\" int len; /* バッファ内のデータの数 */ +.\" int buf[16]; /* データバッファ */ +.\" } mousedata_t; +.\" .Ed +.\" .Pp +.\" ユーザプログラムに戻った直後に、ドライバはバッファ内の有効なデータバイトの数を +.\" .Dv len +.\" フィールドにセットします。 +.\" .Pp +.It Dv MOUSE_READSTATE Ar mousedata_t *state +.\" このコマンドはデバイスからハードウェアの設定を読み出します。 +.\" ユーザプログラムに戻った直後に、 +.\" ドライバはバッファ内の有効なデータバイトの数を +.\" .Dv len +.\" フィールドにセットします。 +.\" これは通常 3 バイトです。 +.\" バッファは次のようにフォーマットされます: +.\" .Pp +.\" .Bl -tag -width Byte_1 -compact +.\" .It Byte 1 +.\" .Bl -tag -width bit_6 -compact +.\" .It bit 7 +.\" 予約済み。 +.\" .It bit 6 +.\" 0 - ストリームモード、 1 - リモートモード。 +.\" ストリームモードでは、ポインティングデバイスはその状態が変わる度に +.\" デバイス状態を送ります。 +.\" リモートモードでは、ホストコンピュータはデバイスの状態を送るように +.\" リクエストしなければなりません。 +.\" .Nm +.\" ドライバはデバイスをストリームモードにします。 +.\" .It bit 5 +.\" ポインティングデバイスが現在有効であればセットされます。 +.\" 有効でなければ 0 です。 +.\" .It bit 4 +.\" 0 - 1:1 スケーリング、 1 - 2:1 スケーリング +.\" 1:1 スケーリングがデフォルトです。 +.\" .It bit 3 +.\" 予約済み。 +.\" .It bit 2 +.\" 左ボタン状態;押下されていればセット。 +.\" .It bit 1 +.\" 中ボタン状態;押下されていればセット。 +.\" .It bit 0 +.\" 右ボタン状態;押下されていればセット。 +.\" .El +.\" .It Byte 2 +.\" .Bl -tag -width bit_6_0 -compact +.\" .It bit 7 +.\" 予約済み。 +.\" .It bit 6..0 +.\" 分解能コード: 0 から 3 迄。分解能コードに対する実際の分解能は +.\" デバイスによって変わります。 +.\" .El +.\" .It Byte 3 +.\" 状態通知レート(1秒当りの報告の回数)で、この頻度でデバイスはホストコンピュータ +.\" に移動報告を行ないます。 +.\" .El +これらのコマンドについては、現在 +.Nm +ドライバはサポートしていません。 +.Pp +.It Dv MOUSE_GETSTATE Ar mousestatus_t *status +このコマンドは +.Xr mouse 4 +に記述されているようにボタンの現在の状態と移動カウントを返します。 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/npsm0 -compact +.It Pa /dev/psm0 +「非ブロッキング」型デバイスノード +.It Pa /dev/bpsm0 +.Em devfs +での「ブロッキング」型デバイスノード。 +.El +.Sh 使用例 +.Dl "options" \&"PSM_HOOKAPM\&" +.Dl "device psm0 at isa? tty irq 12" +.Pp +「レジューム」イベント後にポインティングデバイスを刺激するための +オプションのコードとともに +.Nm +ドライバをカーネルに組み込みます。 +.Pp +.Dl "device psm0 at isa? tty flags 0x024 irq 12" +.Pp +デバイス分解能を高く (4) セットし、加速因子を 2 にセットします。 +.Sh 診断 +.Pp +デバッグレベル 0 では、起動過程での以下のような行以外には +殆ど情報はログされません: +.Bd -literal -offset indent +psm0: device ID X +.Ed +.Pp +ここで +.Fa X +は発見されたポインティングデバイスから返されたデバイス ID コードです。 +既知の ID については +.Dv MOUSE_GETINFO +を参照して下さい。 +.Pp +デバッグレベル 1 ではドライバが補助ポート (マウスポート) +を検査している間により多くの情報がログされます。 +メッセージは LOG_DEBUG の level で LOG_KERN を facility として +.Po Xr syslogd 8 +を参照 +.Pc +ログされます。 +.Bd -literal -offset indent +psm0: current command byte:xxxx +kbdio: TEST_AUX_PORT status:0000 +kbdio: RESET_AUX return code:00fa +kbdio: RESET_AUX status:00aa +kbdio: RESET_AUX ID:0000 +[...] +psm: status 00 02 64 +psm0 irq 12 on isa +psm0: model AAAA, device ID X, N buttons +psm0: config:00000www, flags:0000uuuu, packet size:M +psm0: syncmask:xx, syncbits:yy +.Ed +.Pp +第 1 行目は補助ポートが検査される直前のキーボードコントローラの +コマンドバイトの値を示します。 +これは通常は、4D, 45, 47, 65 のいずれかで、通電時にマザーボード BIOS が +キーボードコントローラを初期化した方法により決まります。 +.Pp +第 2 行目は補助ポートインタフェースに対してキーボードコントローラが +テストした結果を示し、0 でエラーが無いことを示します。 +しかしながら、たとえシステムにポートが存在しなくてもエラーが無いと +報告するコントローラも中にはあることに注意して下さい。 +.Pp +第 3 行目から第 5 行目まではポインティングデバイスのリセット状態を示します。 +機能しているデバイスであれば FA AA という順序に並んだデータ +を返すはずです。 +この ID コードは上で解説したものです。 +.Pp +第 7 行目は現在のハードウェアの設定を示します。 +.\" 定義については +.\" .Dv MOUSE_READSTATE +.\" を参照して下さい。 +これらのバイトは次のようにフォーマットされます: +.Pp +.Bl -tag -width Byte_1 -compact +.It Byte 1 +.Bl -tag -width bit_6 -compact +.It bit 7 +予約済み。 +.It bit 6 +0 - ストリームモード、1 - リモートモード。 +ストリームモードでは、ポインティングデバイスはその状態が変わる度に +デバイス状態を送ります。 +リモートモードでは、ホストコンピュータはデバイスの状態が送られるように +要求しなければなりません。 +.Nm +ドライバはデバイスをストリームモードにします。 +.It bit 5 +ポインティングデバイスが現在有効であればセットされます。 +有効でなければ 0 です。 +.It bit 4 +0 - 1:1 スケーリング、1 - 2:1 スケーリング。 +1:1 スケーリングがデフォルトです。 +.It bit 3 +予約済み。 +.It bit 2 +左ボタン状態; 押下されていればセット。 +.It bit 1 +中ボタン状態; 押下されていればセット。 +.It bit 0 +右ボタン状態; 押下されていればセット。 +.El +.It Byte 2 +.Bl -tag -width bit_6_0 -compact +.It bit 7 +予約済み。 +.It bit 6..0 +分解能コード: 0 から 3 迄。 +分解能コードに対応する実際の分解能はデバイスにより異なります。 +.El +.It Byte 3 +状態通知レート (1 秒当りに報告する回数) で、この頻度でデバイスは +移動報告をホストコンピュータに送ります。 +.El +.Pp +.Nm +ドライバがユーザプログラムによりオープンされるまでは +ポインティングデバイスは有効にならないことに注意して下さい。 +.Pp +残りの行についてはデバイス ID コード、検出されたボタンの数、及び +内部変数を表示します。 +.Pp +デバッグレベル 2 では、ずっと多くの詳細な情報がログされます。 +.Sh 警告 +多くのパッドデバイスは、ユーザがパッドの表面を「軽く叩いた(タップした)」時に、 +まるで第 1 (左) ボタンが +押下されたかのように振舞います。 +これに対し、ALPS GlidePoint のパッドモデルの中には、軽く叩く(タッピング)動作を +第 4 番目のボタンのイベントとして処理するものがあります。 +.Pp +MouseSystems 製の PS/2 マウスの中には、正しく機能させるために +高分解能モードにする必要があるものがあります。 +ドライバフラグを用いて分解能を設定して下さい。 +.Pp +一旦データストリームの同期がずれた場合には、 +パケットの第 1 バイトに再び同期することを保証する方法はありません。 +しかしながら、X サーバが +.Xr moused 1 +を用いてマウスにアクセスしていない場合には、 +ユーザが \fIXFree86\fP サーバを使用中に問題が生じても、 +仮想端末に切替えてから X サーバに戻れば X サーバを +マウスと同期させることができるかも知れません。 +マウスを移動させないでいずれかのボタンをクリックすれば +やはり効果があるかも知れません。 +.Sh バグ +ioctl コマンドの +.Dv MOUSEIOCREAD +は削除されました。 +どのみち、これは機能していなかったのです。 +.Sh 関連項目 +.Xr ioctl 2 , +.Xr syslog 3 , +.Xr atkbdc 4 , +.Xr mouse 4 , +.Xr mse 4 , +.Xr sysmouse 4 , +.Xr moused 8 , +.Xr syslogd 8 +.\".Sh 歴史 +.Sh 作者 +.Nm +ドライバは非常に多くの人々によりなされた仕事に基づいています。 +これらの人々の中から少数の方々を挙げれば +.An Eric Forsberg , +.An Sandi Donno , +.An Rick Macklem , +.An Andrew Herbert , +.An Charles Hannum , +.An Shoji Yuen , +.An Kazutaka Yokota +がいます。 +.Pp +このマニュアルページは +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。 +.\"Translated by Tetsuro Furuya (古谷 哲郎) ,Dec.,1999. +.\" Supervised by Kazutaka YOKOTA , Jan. 10, 2000. +.\" ML Checked by 井崎哲也 , Jan 12, 2000. +.\" Final Checked by diff --git a/ja_JP.eucJP/man/man4/pt.4 b/ja_JP.eucJP/man/man4/pt.4 new file mode 100644 index 0000000000..c9fc58c149 --- /dev/null +++ b/ja_JP.eucJP/man/man4/pt.4 @@ -0,0 +1,94 @@ +.\" Copyright (c) 1995 +.\" Peter Dufault, All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: pt.4,v 1.5 1997/03/07 02:49:30 jmg Exp % +.\" jpman %Id: pt.4,v 1.3 2000/01/03 03:15:33 horikawa Stab % +.\" +.Dd March 2, 1995 +.Dt PT 4 +.Os FreeBSD +.Sh 名称 +.Nm pt +.Nd SCSI プロセッサ型ドライバ +.Sh 書式 +.Cd device pt0 at scbus? +.Sh 解説 +.Nm +ドライバは +.Tn SCSI +プロセッサ型デバイスをサポートします。 +このような機器は、大抵スキャナなどのデバイスであり、 +データストリームに機器固有の命令を埋め込むことにより、 +.Tn SCSI +接続を通信インタフェースとして使用します。 +.Pp +.Tn SCSI +ドライバを利用する前に、各 SCSI アダプタをシステムに対して設定する +必要があります。 +.Pp +このデバイスは +.Xr read 2 , +.Xr write 2 +および、一般的な +.Tn SCSI +.Xr ioctl 2 +システムコールのみが利用可能です。 +.Sq Li at scbus? +という記述がシステムを構成するための設定ファイル中に必要となります。 +これは、デバイスが SCSI デバイスであることをシステムに通知し、 +適切なテーブルを生成するのに必要となります。 +.Pp +設定ファイル中の +.Sq Li pt0 +には +.Sq Li 0 +を指定する必要があります。 +これは +.Xr config 8 +の欠陥です。 +.Sh IOCTL +.Nm +ドライバは独自の ioctl は持ちませんが、一般的な +.Xr scsi 4 +コマンドへの媒介として動作します。 +これらに関しては、 +.Em sys/scsiio.h +に記述されています。 +.Xr scsi 4 +の全てのデバッグ用 ioctl が +.Nm +デバイスで利用可能です。 +.Sh 関連ファイル +.Bl -tag -width /dev/ptQQQ -compact +.It Pa /dev/pt Ns Ar N +.No Ar N 番目の外部機器へのドライバ +.El +.Sh 関連項目 +.Xr scsi 4 +.Sh 歴史 +.Nm +ドライバは +.Fx 2.1 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/pty.4 b/ja_JP.eucJP/man/man4/pty.4 new file mode 100644 index 0000000000..138514fc33 --- /dev/null +++ b/ja_JP.eucJP/man/man4/pty.4 @@ -0,0 +1,214 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)pty.4 8.2 (Berkeley) 11/30/93 +.\" %Id: pty.4,v 1.6 1998/01/02 19:22:51 alex Exp % +.\" jpman %Id: pty.4,v 1.3 2000/01/06 12:54:45 horikawa Stab % +.\" WORD: control status information 制御状態情報 [pty.4] +.\" WORD: exceptional condition 例外条件 [pty.4] +.\" WORD: record boundary レコード境界 [pty.4] +.\" " +.Dd November 30, 1993 +.Dt PTY 4 +.Os BSD 4.2 +.Sh 名称 +.Nm pty +.Nd 疑似端末ドライバ +.Sh 書式 +.Cd "pseudo-device pty" Op Ar count +.Sh 解説 +.Nm pty +ドライバは +.Em 疑似端末 +と呼ばれるデバイス対のサポートを提供します。 +疑似端末とは、 +.Em マスタ +デバイスと +.Em スレーブ +デバイスという +一対のキャラクタ型デバイスです。 +スレーブデバイスは、 +.Xr tty 4 +に記述されているものと同一のインタフェースをプロセスに提供します。 +ただし、 +.Xr tty 4 +に記述されるインタフェースを提供するような他のデバイスはすべて、 +根底に何らかのハードウェアデバイスを持つのに対し、 +スレーブデバイスは疑似端末のマスタ側を通じて別のプロセスに操作されます。 +つまり、マスタデバイスに書き込まれた内容は +すべてスレーブデバイスへ入力として送られ、 +スレーブデバイスに書き込まれた内容は +すべてマスタデバイスへ入力として渡されます。 +.Pp +カーネル設定ファイル中の指定にオプションの +.Ar count +を与えると、その数だけ疑似端末の組が構成されます。 +count のデフォルトは 32 です。 +.Pp +次に挙げる +.Xr ioctl 2 +呼び出しは疑似端末にのみ適用できます: +.Bl -tag -width TIOCREMOTE +.It Dv TIOCSTOP +端末への出力を止めます (例えば +.Ql ^S +を押すように)。 +パラメータは取りません。 +.It Dv TIOCSTART +( +.Dv TIOCSTOP +か +.Ql ^S +を押すことで止められていた +) 出力を再開します。 +パラメータは取りません。 +.It Dv TIOCPKT +.Em パケット +モードを有効/無効にします。 +パケットモードは非 0 のパラメータを指定 (参照渡し) すると有効になり、 +0 を指定 (参照渡し) すると無効になります。 +疑似端末のマスタ側に適用された場合、以後端末から +.Xr read 2 +を呼び出すと、1 個の 0 バイト (シンボル定義では +.Dv TIOCPKT_DATA +) に続いて疑似端末のスレーブ側に書き込まれたデータが返されるか、 +あるいは制御状態情報を表す単一バイトが返されるようになります。 +後者の場合、返されるバイトは次のビットの 0 個以上の和 (OR) になります: +.Bl -tag -width TIOCPKT_FLUSHWRITE +.It Dv TIOCPKT_FLUSHREAD +端末の読み込みキューがフラッシュされたとき +.It Dv TIOCPKT_FLUSHWRITE +端末の書き込みキューがフラッシュされたとき +.It Dv TIOCPKT_STOP +端末への出力が +.Ql ^S +のようにして止められたとき +.It Dv TIOCPKT_START +端末への出力が再開されたとき +.It Dv TIOCPKT_DOSTOP +.Em t_stopc +が +.Ql ^S +で +.Em t_startc +が +.Ql ^Q +となったとき +.It Dv TIOCPKT_NOSTOP +START 文字、STOP 文字が +.Ql ^S/^Q +でなくなったとき +.Pp +このモードが有効な間、 +マスタ側から読み込まれる制御状態情報の存在は +.Xr select 2 +で例外条件として検出できます。 +.Pp +.Xr rlogin 1 +や +.Xr rlogind 8 +はこのモードを用いて、 +リモート側でエコーしローカル側で +.Ql ^S/^Q +フロー制御する、出力のバックフラッシュが適切に行なわれる +リモートログイン機構を実装しています。 +その他の似たプログラムでもこのモードが利用できます。 +.El +.It Dv TIOCUCNTL +少数の単純なユーザ +.Xr ioctl 2 +コマンドを、 +.Dv TIOCPKT +と似たプロトコルを用いて疑似端末を通して渡すことのできるモードを、 +有効/無効にします。 +.Dv TIOCUCNTL +モードと +.Dv TIOCPKT +モードは互いに排他的です。 +このモードは疑似端末のマスタ側から設定します。 +非 0 のパラメータを指定 (参照渡し) すると有効になり、 +0 を指定 (参照渡し) すると無効になります。 +以後マスタ側から +.Xr read 2 +を呼び出すと、 +1 個の 0 バイトに続いて疑似端末のスレーブ側に書き込まれたデータが返されるか、 +あるいはスレーブ側のユーザ制御操作を表す単一のバイトが返されるようになります。 +ユーザ制御コマンドは、データを持たない特別な +.Xr ioctl 2 +操作で構成されます。コマンドは +.Dv UIOCCMD Ns (n) +の形で渡します。ここで、 +.Ar n +は 1 から 255 の範囲の数字です。 +操作値 +.Ar n +は、マスタ側からの次回の +.Xr read 2 +により単一バイトとして受け取られます。 +.Xr ioctl 2 +.Dv UIOCCMD Ns (0) +は何も操作は行いませんが (no-op)、 +この機能の有無を調べるために使えます。 +.Dv TIOCPKT +モードの場合と同様、コマンド操作は +.Xr select 2 +で例外条件として検出できます。 +.It Dv TIOCREMOTE +疑似端末のマスタ側用のモードで、 +.Dv TIOCPKT +とは独立です。 +このモードでは (端末のモードに関わらず)、 +疑似端末への入力をフロー制御し、入力編集を行わないようにします。 +制御端末へ書き込みを行うと、 +その端末から読み込むプロセスのためにレコード境界が作られます。 +通常の使用では、 +データの書き込みはそのデータが端末から行入力されたようになり、 +0 バイトの書き込みはファイル終了文字が入力されたようになります。 +.Dv TIOCREMOTE +は、ウィンドウマネージャでリモート行編集を行うときや、 +入力をフロー制御する必要のあるときに利用できます。 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/tty[p-sP-S][0-9a-v]x -compact +.It Pa /dev/pty[p-sP-S][0-9a-v] +マスタ疑似端末 +.It Pa /dev/tty[p-sP-S][0-9a-v] +スレーブ疑似端末 +.El +.Sh 診断 +ありません。 +.Sh 関連項目 +.Xr tty 4 +.Sh 歴史 +.Nm +ドライバは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/random.4 b/ja_JP.eucJP/man/man4/random.4 new file mode 100644 index 0000000000..026073779a --- /dev/null +++ b/ja_JP.eucJP/man/man4/random.4 @@ -0,0 +1,175 @@ +.\" +.\" random.c -- A strong random number generator +.\" +.\" Version 0.92, last modified 21-Sep-95 +.\" +.\" Copyright Theodore Ts'o, 1994, 1995. 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, and the entire permission notice in its entirety, +.\" including the disclaimer of warranties. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. The name of the author may not be used to endorse or promote +.\" products derived from this software without specific prior +.\" written permission. +.\" +.\" ALTERNATIVELY, this product may be distributed under the terms of +.\" the GNU Public License, in which case the provisions of the GPL are +.\" required INSTEAD OF the above restrictions. (This clause is +.\" necessary due to a potential bad interaction between the GPL and +.\" the restrictions contained in a BSD-style copyright.) +.\" +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED +.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED +.\" OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: random.4,v 1.6 1997/10/13 11:08:40 charnier Exp % +.\" jpman %Id: random.4,v 1.3 2000/01/03 03:15:50 horikawa Stab % +.\" +.Dd October 21, 1995 +.Dt RANDOM 4 i386 +.Os +.Sh 名称 +.Nm random , +.Nm urandom +.Nd 乱数デバイス +.Sh 解説 +このデバイスはデバイスドライバなどから環境ノイズを集め、暗号での利用に適当な +良い乱数を返します。暗号での利用はもちろん、この数は TCP シーケンス番号のための +乱数の種や、ランダムなだけでなく攻撃者の予想が難しい数が望ましいその他の +ところでも良いものです。 +.Ss 操作の理論 +コンピュータはとても予測しやすい装置です。従ってコンピュータで本当に乱数を +作ることは \(em アルゴリズムを使って簡単に作れる疑似乱数とは +対照的に \(em 非常に難しいです。 +不幸にも、攻撃者が疑似乱数生成器の乱数の列を推量することはとても簡単です。 +そしてあるアプリケーションにとっては、これは受け入れられません。 +そこでその代わりに、コンピュータの環境から「環境ノイズ」を集めて、それを使って +乱数を作る必要があります。「環境ノイズ」は外部の攻撃者には見るのが難しいもので +なければなりません。Unix 環境では、これはカーネル中で行うのが最善です。 +.Pp +環境からの乱数源には、キーを押す間のタイミングやいくつかの割り込みの +間のタイミング、そして (a) 非決定論的で (b) 外部の観察者から +測定するのが難しいその他の事象が含まれます。 +この源からの乱数は「エントロピーのたまり場」に加えられます。 +「エントロピーのたまり場」は周期的に CBC モードの MD5 圧縮関数を使って +かき混ぜられます。 +乱数がエントロピーのたまり場でかき混ぜられるときに、ルーチンは +何ビットの乱数が乱数生成器の内部状態に蓄えられたかを +.Em 見積り +ます。 +.Pp +乱数が要求されると、カウンタと「エントロピーのたまり場」の +内容の和の MD5 ハッシュをとることにより、乱数が得られます。 +MD5 ハッシュを使う理由は乱数生成器の内部状態を外にさらすのを防げるからです。 +MD5 ハッシュはたまり場を保護しますが、たまり場から作られる乱数はそれぞれ +内部状態から得られる情報をいくらか漏らします。そのため情報量が増えると +外の攻撃者は乱数生成器の内部状態についていくらか推測してみることが +できるようになります。 +この理由からルーチンは乱数を出力するとき、エントロピーのたまり場に含まれている +「真の乱数」のビット数の内部での見積りを減らします。 +.Pp +もしこの見積りが 0 になっても、ルーチンは乱数を作り続けることができます。 +しかしながら、攻撃者が乱数生成器の出力や MD5 アルゴリズムを解析して +ルーチンの出力の推測に成功するかも知れません。 +最悪の場合、カウンタとばれていない秘密に対して MD5 ハッシングしたもの +と同じになるので、 +Phil Karn (エントロピーのたまり場から乱数を取り出すのに、カウンタを加えた +MD5 を使う機構を考えた人物) はこれを「実用的な乱雑さ」と呼んでいます。 +もし MD5 が強力な暗号ハッシュであれば、これはかなり攻撃に耐えられるはずです。 +.Ss エクスポートされたインタフェース \(em 出力 +エクスポートされたインタフェースは 3 つあります。第 1 はカーネルの内部から +使うことを意図したものです。 +.Pp +.Bl -tag -width Pa -compact +.It Pa void get_random_bytes(void *buf, int nbytes); +.El +.Pp +このインタフェースは要求されたバイト数の乱数を返し、それを要求されたバッファに +置きます。 +.Pp +他の 2 つのインタフェースは +.Pa /dev/random +と +.Pa /dev/urandom +の 2 つのキャラクタ型デバイスです。 +最大でもエントロピーのたまり場に含まれる (乱数生成器により見積もられた) +ビット数の乱数しか返さないので +.Pa /dev/random +デバイスは非常に高品質の乱数が必要なとき (例えば、鍵の生成) の使用に +ふさわしいです。 +.Pp +.Pa /dev/urandom +デバイスはこの制限がなく、要求されただけのバイトを返します。 +エントロピーのたまり場が再蓄積する時間を与えずに多くの乱数を要求すると、 +乱数の質が低くなります。 +しかしながら、多くのアプリケーションにとってはこれは受け入れられるでしょう。 +.Ss エクスポートされたインタフェース \(em 入力 +デバイスから環境ノイズを集める現在のエクスポートされたインタフェースは +次の 2 つです。 +.Pp +.Bl -tag -width Pa -compact +.It Pa void add_keyboard_randomness(unsigned char scancode); +.It Pa void add_interrupt_randomness(int irq); +.El +.Pp +1 番目の関数は「エントロピーのたまり場」へのランダムな入力として、scancode は +もちろん、キーを押す間のタイミングも使います。 +.Pp +2 番目の関数はエントロピーのたまり場へのランダムな入力として割り込みの間の +タイミングを使います。すべての割り込みが良い乱数源という訳ではないことに +注意して下さい！例えば、タイマ割り込みは良い選択ではありません。なぜなら +割り込みの周期性が非常に規則的なため攻撃者が予測できるからです。 +ディスク割り込みのタイミングはより予測できないので、ディスク割り込みの方が +より良いです。ルーチンは割り込みのタイミングの 1 次と 2 次のデルタを取ることで +特定の割り込みチャンネルが提供するランダムさが何ビットかを見積もろうとします。 +.Sh 謝辞 +元の中心となるコードは +.An Theodore Ts'o +が Linux プラットフォーム向けに書きました。 +.Bx Free +に移植したのは +.Xr rndcontrol 8 +ユーティリティ +も書いた +.An Mark Murray +です。 +.Pp +この乱数生成器を構成する考えは Pretty Good Privacy の乱数生成器と +Phil Karn との個人的な議論から得たものです。この設計はさらに私一人で +修正したので、いかなる欠陥も私だけの責任であり、PGP の著作者や Phil に +帰するべきではありません。 +.Pp +MD5 変換のコードはパブリックドメインである Colin Plumb の実装から +取りました。MD5 暗号チェックサムは Ronald Rivest により発明され、 +RFC 1321、 "The MD5 Message Digest Algorithm" で解説されています。 +.Pp +この話題に関するこれ以上の予備知識は Donald Eastlake, Steve Crocker, +Jeff Schiller による RFC 1750、"Randomness Recommendations for Security" から +得られるでしょう。 +.Sh 関連項目 +.Xr rndcontrol 8 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/random +.It Pa /dev/urandom +.El +.Sh 歴史 +.Pa random , +.Pa urandom +ファイルは +.Fx 2.1.5 +で登場しました。 diff --git a/ja_JP.eucJP/man/man4/rdp.4 b/ja_JP.eucJP/man/man4/rdp.4 new file mode 100644 index 0000000000..c4143cb6fb --- /dev/null +++ b/ja_JP.eucJP/man/man4/rdp.4 @@ -0,0 +1,189 @@ +.\" +.\" +.\" Copyright (c) 1997 Joerg Wunsch +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: rdp.4,v 1.1.1.1 1998/12/21 18:01:15 joerg Exp % +.\" jpman %Id: rdp.4,v 1.3 2000/08/10 13:47:28 horikawa Stab % +.\" +.\" +.\" " (emacs disconfusion) +.Dd December 21, 1998 +.Dt RDP 4 i386 +.Os +.Sh 名称 +.Nm rdp +.Nd RealTek RTL 8002 ポケットイーサネットのためのイーサネットドライバ +.Sh 書式 +.Cd "device rdp0 at isa? port 0x378 net irq 7" +.Cd "device rdp0 at isa? port 0x378 net irq 7 flags 0x2" +.Sh 解説 +.Nm +デバイスドライバは、標準パラレルポートに接続される +RealTek RTL 8002 ベースのポケットイーサネットアダプタをサポートします。 +.Pp +これらアダプタはポケットイーサネットアダプタのうちで安価なものに属する +と考えられます。RTL 8002 はその中心部で、標準パラレルプリンタアダプタと +通信するようにデザインされたホストインタフェースだけでなく、 +BNC および UTP (10 Mbit/s) メディアへのインタフェースも含むものです。 +完全なイーサネットアダプタとして動くためには、 +送信および受信パケットバッファ (RTL 8002 では 16 K x 4) として +使われる外部 RAM と、割り当てられたイーサネットハードウェアアドレス +を保持してくための EEPROM が必要です。 +RTL 8002 では、EEPROM は 標準 93C46 シリアル EEPROM +(一般にこれが選択されるようです) または 74S288 パラレル EEPROM を +使うことができます。後者の変種を動かすためには、 +デバイスコンフィギュレーションにフラグ 0x1 が必要です。 +.Pp +標準的なプリンタアダプタは、タイミングの要求仕様に関して +大幅なばらつきがあるようなので、 +ポケットイーサネットアダプタとプリンタインタフェース +との間でデータを交換する方法が現在 2 つ存在します。 +デフォルトでは RTL 8002 がサポートする最も高速なモードです。 +もし使用するプリンタアダプタが特に低速であれば +(パケットが損なわれたり、正しくパケットが受信されていない +かどうかを観察することで知ることができます) +.Nm +ドライバを減速させるために +コンフィギュレーションフラグに 0x2 をセットすることができます。 +高速モードではデータ転送速度は非対称で、送信のほうが受信よりも +やや高速 (最大 2 倍) です。送信が 150 KB/s で受信が 80 KB/s +というのが一般的です。低速モードでは双方の転送速度は等しく、 +50KB/s から 70KB/s の範囲になりますが、もちろん場合によって +異なります。 +.Pp +ブート時にアダプタが認識されない場合、 +.Em bootverbose +フラグ +.Pq Ql Fl v +をセットすることでその原因を診断する助けになるでしょう。 +RTL 8002 アダプタは ( +.Xr lpt 4 +とは違い) プリンタアダプタに動作する割り込みが利用できることを +要求するので、イーサネットアダプタが検出時に +割り込みを表明できない場合、 +.Nm +ドライバはアタッチに失敗します。 +.Pp +RTL 8002 は (ハードウェア) マルチキャストをサポートしません。 +.Pp +.Nm +ドライバはきわめて初期に検出されるようにするため +フラグを内部でセットします。このため、同一のカーネルで +.Nm +ドライバと +.Xr lpt 4 +の両方を設定することが可能です。もし RTL 8002 が存在しなければ +最終的にプリンタドライバが検出されるでしょう。 +.Sh 診断 +.Pp +.Dl "rdp0: configured IRQ (7) cannot be asserted by device" +.Pp +プリンタアダプタを通して割り込みをアサートする RTL 8002 を、 +検出ルーチンは見付けられませんでした。 +.Pp +.Dl "rdp0: failed to find a valid hardware address in EEPROM" +.Pp +EEPROM の中のハードウェアアドレスが格納されている標準的な場所が +存在しないと推測される場合、 +.Nm +ドライバは IEEE の OUI による割り当てを元に +正しいと思われるイーサネットハードウェアアドレスを見つけるまで +(シリアル) EEPROM 全体を見回ります。 +この診断はドライバがアドレスを見つけることができなかった +ことを示しています。注: これはアダプタが 74S288 EEPROM +を搭載していることによるまれな場合かもしないので、 +.Ql flags 0x1 +を試すべきです。 +.Pp +.Dl "rdp0: Device timeout" +.Pp +パケットの転送開始後、イーサネットアダプタが +転送の通知 (成功または失敗) を返しませんでした。 +ハードウェアが動けなくなってしまっているようなのでリセットしています。 +.Pp +.Sh 関連項目 +.Xr lpt 4 , +.Xr ifconfig 8 +.Sh 作者 +このドライバは ReakTek による RTL 8002 のための パケットドライバと、 +RealTek が提供していてくれた RTL 8012 (RTL 8002 の後継です) +に関するいくつかの情報を元に +.ie t J\(:org Wunsch +.el Joerg Wunsch +が書きました。 +.Sh バグ +もちろんたくさんあります。 +.Pp +.Nm +ドライバはブート時にハードウェアを検出する必要があるので、 +その時に存在していなければなりません。 +.Pp +RealTek のパケットドライバが扱うことができる 8 つの速度モード +のうち、2つしか実装されていません。したがって +現在の低速モードでさえ、ハードウェアにとって速過ぎる場合が +あるかもしれません。 +.Pp +利用可能なモードを自動的に認識する検出ルーチンの中に DMA 転送テストが +存在するべきです。 +.Pp +データ交換のために標準プリンタインタフェースを酷使することは、 +エラーになりやすい傾向にあります。偶発的なハードウェアの停止はそれほど +驚くことではなく、タイムアウトルーチンがそのような状態を +捕捉してくれるでしょう。 +ping の洪水 (flood-pinging) はこの問題を引き起こすよい例です。 +同様に、BPF はもちろんサポートされていますが、 +無差別 (promiscuous) モードを使って混雑しているイーサネットを +覗こうとするのは悪いアイデアです。 +.Pp +RTL 8002 は 受信バッファ空間が 4 KB しかないので +(2 x 2 KB は送信バッファに使われます)、 +.Nm +ドライバを使ったマシンが NFS の標準的なブロックサイズである 8 KBで +高速のサーバをマウントした場合、 +大きなパケットが到着することで発生する、 +よくある NFS のデットロックが起こるかもしれません。 +(NFS は パケット全体を再送することしかできないので、 +同じパケットが何度も転送されることになるでしょう。) +.Pp +EEPROM からイーサネットハードウェアアドレスを見つけ出す発見的 +な手法は最悪ですが、EEPROM の中の実際の場所に依存しない唯一の賢い +一般的な方法はないようです。 +RealTek によるサンプルドライバでは直接アドレス 0 に定めていました。 +他のベンダは、たとえば 15 のような +正しいイーサネットアドレスと混同してはならないゴミとともに拾い上げていました。 +.Pp +後継のチップである RTL 8012 をサポートするべきです。 +これは近ごろ入手可能になり、使われているようです。 +(RTL 8002 はすでにいくぶん歳をとっており、1992 年または 93 年のものです。) +RTL 8012 は転送をかなり高速化することができるであろう、 +双方向の SPP または EPP のような進化した +プリンタアダプタハードウェアをサポートしています。 +また、RTL 8012 はハードウェアマルチキャストをサポートしており、 +パケットバッファ RAM は 64K x 4 のアドレス空間を扱うことができます。 +.Pp +このドライバはスタンドアロンで動作するのではなく、 +ppc ドライバの上位に位置するべきです。またローダブルモジュールと +することによって、ポケットイーサネットアダプタが実際に取り付けられてから +デバイスを検出できるようにするべきです。 diff --git a/ja_JP.eucJP/man/man4/rl.4 b/ja_JP.eucJP/man/man4/rl.4 new file mode 100644 index 0000000000..6757562ed2 --- /dev/null +++ b/ja_JP.eucJP/man/man4/rl.4 @@ -0,0 +1,190 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: rl.4,v 1.7 1998/12/24 18:52:47 wpaul Exp % +.\" jpman %Id: rl.4,v 1.3 1999/11/28 15:52:49 horikawa Stab % +.\" +.Dd November 4, 1998 +.Dt RL 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm rl +.Nd +RealTek 8129/8139 ファストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device rl0" +.Sh 解説 +.Nm +ドライバは、RealTek 8129, 8139 ファストイーサネットコントローラチップが +載っている、PCI イーサネットアダプタやコントローラをサポートしています。 +これは、 +Allied Telesyn AT2550, Genius GF100TXR, +NDC Communications NE100TX-E, OvisLink LEF-8129TX, OvisLink LEF-8139TX, +Netronix Inc. EA-1210 NetEther 10/100, KTX-9130TX 10/100 Fast Ethernet, +Encore ENL832-TX 10/100 M PCI, Longshine LCS-8038TX-R, +SMC EZ Card 10/100 PCI 1211-TX や、ほかの安価なアダプタを含みます。 +RealTek 互換であると思われる MPX5030 (または MPX5038) と書いてあるチップ +が載っているAccton EN1207D もサポートしています。 +.Pp +RealTek コントローラはバスマスタ DMA を使いますが、ディスクリプタベース +のデータ伝送機構は用いません。受信側はひとつの固定サイズのリングバッファ +を用い、パケットはそこから mbuf にコピーされます。 +伝送のために、外向きのパケットアドレスレジスタが 4 つだけありますが、 +外向きのパケットがすべて隣接したバッファに入れられることが要求されます。 +さらに、外向きのパケットバッファは longword に整列されている必要があります。 +さもなければ、伝送は失敗します。 +.Pp +8139 は特別なダイレクトアクセスレジスタによってコントロールされる内部 PHY を +持っていますが、8129 は MII バス経由で外部 PHY を用いているという点で、 +8139 と 8129 は違います。8139 は全二重または半二重における 10 +または 100Mbps をサポートしています。8129 は適切な PHY チップによって +決まっている同じスピードとモードをサポートしています。 +.Pp +.Nm +ドライバは次のようなメディアタイプをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を使用可能にします。これは、 +RealTek コントローラについている PHY チップが NWAY オートネゴシエーションを +サポートしているときのみ可能です。ユーザは +.Pa /etc/rc.conf +ファイルにメディアオプションを書き加えることで、 +自動選択モードを手動で上書きすることができます。 +.It 10baseT/UTP +10Mbps に設定します。 +.Ar mediaopt +は +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために用いることができます。 +.It 100baseTX +100Mbps (ファストイーサネット) に設定します。 +.Ar mediaopt +は +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために用いることができます。 +.El +.Pp +.Nm +ドライバは次のようなメディアオプションをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +全二重に設定します。 +.It half-duplex +半二重に設定します。 +.El +.Pp +アダプタがサポートしているときのみ、100baseTX メディアタイプは有効です。 +このデバイスをさらに設定するためには、 +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "rl%d: couldn't map memory" +致命的な初期化エラーが起こりました。 +.It "rl%d: couldn't map interrupt" +致命的な初期化エラーが起こりました。 +.It "rl%d: watchdog timeout" +デバイスがネットワークに応答しなくなったか、ネットワークの +接続 (ケーブル) に問題があります。 +.It "rl%d: no memory for rx list" +ドライバがレシーバリング用の mbuf の確保に失敗しました。 +.It "rl%d: no memory for tx list" +パッドバッファを確保、または mbuf チェインをクラスタにまとめるときに、 +トランスミッタリング用の mbuf の確保に失敗しました。 +.It "rl%d: chip is in D3 power state -- setting to D0" +パワーマネージメントをサポートするアダプタにのみ、このメッセージが出ま +す。シャットダウン時にコントローラをローパワーモードにするオペレーティング +システムがあり、チップ設定前にこの状態を解除しない PCI BIOS があります。 +D3 状態において、コントローラは PCI の設定すべてを失うので、BIOS +がそのときにフルパワーモードに設定しなおさなければ、正しく設定すること +はできません。ドライバはこの状態を検出し、アダプタを D0 (フルパワー) +状態に設定しなおそうとしますが、ドライバを完全に操作できる状態にするの +には至らないかもしれません。ブート時にこのメッセージが現れ、ドライバが +ネットワークインタフェースとしてデバイスをアタッチすることに失敗するの +なら、デバイスを適切に設定するために 2 度目のウォームブートを行う必要が +あります。 +.Pp +他のオペレーティングシステムからウォームブートするときのみに、この状態は +起こります。 +.Fx +のブート前にシステムの電源を切れば、カードが正常に設定されます。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Rs +.%B RealTek 8129 と 8139 のデータシート +.%O ftp.realtek.com.tw:/lancard/data sheet +.Re +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +に初めて現れました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 +.Sh バグ +外に出て行くパケットは longword に並べる必要があるので、伝送ルーチン +は伝送前に、整列していないパケットを mbuf クラスタバッファにコピーする +必要があります。 +システム開始時にページ境界から始まる連続 +した領域にクラスタバッファプールが確保されているという事実を、 +ドライバは濫用します。 +クラスタバッファは 2048 バイトなので、当然 longword 境界に整列しています。 +ドライバはおそらくこの特性に依存するべきではありません。 +.Pp +RealTek のデータシートの品質はとりわけ貧弱です。文法とスペルはひどいですし、 +多くの情報、特に受信器としての処理に関する情報が抜けています。 +非常に重要な事実として、 +チップが受信バッファをフィルする (訳注: 受信データを入れる) +方法に関して記述してないということがあります。 +フレームが受信されたことを知らせる割り込みが起きたときに、 +ドライバがこのフレームを処理している間に、 +次のフレームが受信バッファへコピーされている最中になる可能性があります。 +チップが次のフレームの残りを +DMA してしまう前に、ドライバが最初のフレームを処理し終えたなら、チップ +が次のフレームのすべてを DMA するより前に、バッファにあるそのフレーム +をドライバが処理しようとするかもしれません。 +.Pp +ドライバは実パケットデータの前についているヘッダ中のフレーム長を調べる +ことで、不完全なフレームかどうかをチェックできます。不完全なフレームは +0xFFF0 というマジック長です。ドライバはこの長さを発見すると、現在有効 +なパケットをすべて処理し終えたことを知ることができます。このマジック値 +とその重要性については、RealTek のデータシートのどこにも書いてありません。 diff --git a/ja_JP.eucJP/man/man4/route.4 b/ja_JP.eucJP/man/man4/route.4 new file mode 100644 index 0000000000..aefdc0e65c --- /dev/null +++ b/ja_JP.eucJP/man/man4/route.4 @@ -0,0 +1,265 @@ +.\" Copyright (c) 1990, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)route.4 8.6 (Berkeley) 4/19/94 +.\" jpman %Id: route.4,v 1.3 2000/09/02 16:43:12 yt-kage Stab % +.\" %Id: route.4,v 1.6 1997/03/19 19:47:39 bde Exp % +.\" +.Dd October 8, 1996 +.Dt ROUTE 4 +.Os +.Sh 名称 +.Nm route +.Nd カーネルパケット転送データベース +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket PF_ROUTE SOCK_RAW "int family" +.Sh 解説 +.Tn UNIX +はパケットルーティング装置を提供します。 +カーネルはルーティング情報データベースを管理しています。 +そして、ルーティング情報データベースは、パケットを転送する際に +適当なネットワークインタフェースを選択するのに使用されます。 +.Pp +ユーザプロセス (あるいは複数の共同プロセス) は、 +特殊なソケットを通してメッセージを送ることによって +このデータベースを管理します。 +これは、初期のリリースで使われていた固定サイズの +.Xr ioctl 2 +での管理にとって代わったものです。 +ルーティングテーブルの変更はスーパユーザによってのみ行なわれます。 +.Pp +オペレーティングシステムは、リダイレクトを受け取ったとか、 +要求に対して適当な経路を設定することに失敗したというような +外部イベントに対する反応として、 +自発的にルーティングメッセージを出すかもしれません。 +このメッセージタイプの詳細は以下に記述されています。 +.Pp +ルーティングデータベースのエントリは 2 種類からなります。 +1 つは特定のホスト向け、もう 1 つは +(ビットマスクとマスク後に残る値によって指定される) +一般的なサブネットワーク内の全てのホスト向けです。 +ワイルドカードやデフォルト経路の効果は、 +すべてのビットが 0 のマスクを使用することによって +生じます。 +それは階層的な経路になっているかもしれません。 +.Pp +システムが起動してネットワークインタフェースにアドレスが割り当てられる時、 +各プロトコルファミリは、トラフィックに対して準備ができた時点で +各インタフェースにルーティングテーブルエントリをインストールします。 +通常プロトコルは、各インタフェースを通して +宛先となるホストまたはネットワークへ +.Dq 直接 +接続するものとして経路を指定します。 +もし経路が直接であれば、 +パケット内で指定されているのと同じホストへそれが送られるよう +プロトコルファミリのトランスポート層が要求します。 +そうでなければ、 +ルーティングエントリにリストされたゲートウェイに +該当パケットを送るようにインタフェースが要求されます +(即ち、パケットは転送されます)。 +.Pp +パケットがルーティングされる時、 +カーネルは宛先に最も明確に一致する経路を見付けようと試みます。 +(もし 2 つの異なるマスクがあって、マスクをかけた後の値が +一致しているペアがあるなら、 +より明確に一致するというのはマスクの中のビットがより多く +立っている方です。 +ホストへの経路は、宛先中のビットが最も多く 1 になっている +マスクを持っているとみなされます)。 +エントリが見つからなければ、宛先には到達不能であると宣言され、 +以下で記述される経路制御ソケット上でメッセージ待ちをしている +リスナがいれば +routing\-miss メッセージが生成されます。 +.Pp +ワイルドカードルーティングエントリは、宛先アドレスが 0 で +マスクもすべて 0 で指定されます。 +ワイルドカード経路は、システムが宛先に一致する経路を見つけるのに +失敗した時に使用されます。 +ワイルドカード経路とルーティングリダイレクトとを +組み合わせて使用すると、ルーティングにかかるトラフィックを +合理的に軽減できる機構を提供できます。 +.Pp +上の書式で示されるソケットコールを使って経路制御メッセージを +やりとりするとめのチャネルをオープンします。 +.Pp +.Fa family +パラメータは、 +すべてのアドレスファミリについての経路情報を提供する +.Dv AF_UNSPEC +をとることができます。あるいは、どのアドレスファミリを希望するか +指定することによって特定の +アドレスファミリだけに限定することも出来ます。 +1 つのシステムで 1 つ以上のルーティングソケットをオープンすることが出来ます。 +.Pp +メッセージは +ヘッダとそれに続くいくつかの sockaddr +(特に +.Tn ISO +の場合、可変長) によって構成され、 +位置によって解釈され、 +sockaddr の新しい length エントリによって区切られます。 +例えば、4 つのアドレスをもったメッセージは +.Tn ISO +リダイレクトかもしれません。つまり +宛先、ネットマスク、ゲートウェイ、リダイレクトの作者です。 +どのアドレスが表されているかの解釈はヘッダ内のビットマスクで +与えられます。 +順序は、vector 内の最下位ビットから最上位ビットへの順になります。 +.Pp +カーネルに送られるメッセージはすべて返され、 +メッセージ待ちをしているすべてのリスナにはそのコピーが +送られます。 +カーネルはメッセージを送るプロセスのプロセス ID を提供します。 +そして、メッセージを送るプロセスは、未解決のメッセージ同士を +区別するための +付加シーケンスフィールドを用いるかもしれません。 +しかし、カーネルバッファが一杯であるとメッセージの返答は +失われるかもしれません。 +.Pp +カーネルは特定のメッセージを拒否し、 +.Ar rtm_errno +フィールドを埋めることによってそれを示します。 +ルーティングコードは、 +もしすでに存在するエントリを複写しようとすると +.Dv EEXIST +を、 +存在しないエントリを削除しようとすると +.Dv ESRCH +を、 +新しい経路を導入するために必要な資源が足りない場合は +.Dv ENOBUFS +を返します。 +現在の実装では、すべてのルーティングプロセスはローカルで動作して +いるので、ルーティング返答メッセージが失われたとしても +.Ar rtm_errno +の値は、通常の +.Em errno +機構から入手可能です。 +.Pp +プロセスは、 +.Dv SOL_SOCKET +レベルでの +.Dv SO_USELOOPBACK +オプションをオフにすることを示す +.Xr setsockopt 2 +コールを発行することで、自分自身のメッセージに対する返答を +読む負荷を回避することができます。 +プロセスは更に +.Xr shutdown 2 +システムコールを行なうことによって +ルーティングソケットからのすべてのメッセージを無視することができます。 +.Pp +もし経路が使用中に削除されると、 +そのルーティングエントリにはダウンとマークされ、 +経路表から除かれます。 +しかしそれに関連づけられた資源は、経路への参照がすべて +解放されるまで返還されません。 +ユーザプロセスは、 +.Dv RTM_GET +メッセージを使うか、 +.Pa /dev/kmem +デバイスを読むか、あるいは +.Xr getkerninfo 2 +システムコールを発行することによって +特定の宛先へのルーティングエントリに関する情報を取得することが +できます。 +.Pp +メッセージは次のものを含んでいます: +.Bd -literal +#define RTM_ADD 0x1 /* 経路追加 */ +#define RTM_DELETE 0x2 /* 経路削除 */ +#define RTM_CHANGE 0x3 /* メトリックやフラグやゲートウェイを変更 */ +#define RTM_GET 0x4 /* 情報報告 */ +#define RTM_LOOSING 0x5 /* カーネルは partitioning を疑っている */ +#define RTM_REDIRECT 0x6 /* 別の経路を使うように言っている */ +#define RTM_MISS 0x7 /* アドレス照合に失敗した */ +#define RTM_RESOLVE 0xb /* 宛先を LL addr に解決する要求 */ +.Ed +.Pp +1 つのメッセージヘッダは以下から成ります: +.Bd -literal +struct rt_msghdr { + u_short rmt_msglen; /* 分からないメッセージをスキップするため */ + u_char rtm_version; /* 将来のバイナリ互換性 */ + u_char rtm_type; /* メッセージタイプ */ + u_short rmt_index; /* 関連のある ifp のインデックス */ + int rtm_flags; /* フラグ、incl kern & message, 例えば DONE */ + int rtm_addrs; /* msg 中の sockaddr を識別するビットマスク */ + pid_t rmt_pid; /* 送信者を識別する */ + int rtm_seq; /* 送信者に対して動作を識別する */ + int rtm_errno; /* 何故失敗したか */ + int rtm_use; /* rtentry から */ + u_long rtm_inits; /* どの値を初期化するか */ + struct rt_metrics rtm_rmx; /* メトリック自身 */ +}; +.Ed +.Pp +ここで +.Dq Li "struct rt_metrics" +およびフラグビットは +.Xr rtentry 9 +で定義されています。 +.Pp +rms_locks と rms_inits のメトリック値の指定子は次の通りです: +.Bd -literal +#define RTV_SSTHRESH 0x1 /* _ssthresh の初期化あるいはロック */ +#define RTV_RPIPE 0x2 /* _recvpipe の初期化あるいはロック */ +#define RTV_SPIPE 0x4 /* _sendpipe の初期化あるいはロック */ +#define RTV_HOPCOUNT 0x8 /* _hopcount の初期化あるいはロック */ +#define RTV_RTT 0x10 /* _rtt の初期化あるいはロック */ +#define RTV_RTTVAR 0x20 /* _rttvar の初期化あるいはロック */ +#define RTV_MTU 0x40 /* _mtu の初期化あるいはロック */ +.Ed +.Pp +メッセージ中でどのアドレスが渡されたかの指定子は次の通りです: +.Bd -literal +#define RTA_DST 0x1 /* 宛先 sockaddr が渡された */ +#define RTA_GATEWAY 0x2 /* ゲートウェイ sockaddr が渡された */ +#define RTA_NETMASK 0x4 /* ネットマスク sockaddr が渡された */ +#define RTA_GENMASK 0x8 /* クローニング sockaddr が渡された */ +#define RTA_IFP 0x10 /* インタフェース名 sockaddr が渡された */ +#define RTA_IFA 0x20 /* インタフェースアドレス sockaddr が渡された */ +#define RTA_AUTHOR 0x40 /* リダイレクトの作者の sockaddr */ +.Ed +.Sh 関連項目 +.Xr route 8 , +.Xr rtentry 9 +.Sh 歴史 +.Dv PF_ROUTE +プロトコルファミリは +.Bx 4.3 reno +で最初に現れました。 diff --git a/ja_JP.eucJP/man/man4/sa.4 b/ja_JP.eucJP/man/man4/sa.4 new file mode 100644 index 0000000000..1caba855a5 --- /dev/null +++ b/ja_JP.eucJP/man/man4/sa.4 @@ -0,0 +1,215 @@ +.\" 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: sa.4,v 1.12.2.1 1999/02/05 08:33:15 mjacob Exp % +.\" jpman %Id: sa.4,v 1.3 2000/08/10 13:47:43 horikawa Stab % +.\" +.Dd October 15, 1998 +.Dt SA 4 +.Os FreeBSD +.Sh 名称 +.Nm sa +.Nd SCSI シーケンシャルアクセスデバイスドライバ +.Sh 書式 +.Cd device sa0 +.Cd device sa1 at scbus0 target 4 lun 0 +.Sh 解説 +.Nm sa +ドライバはサポートされている +.Tn SCSI +ホストアダプタを経由して、システムにアタッチされている +シーケンシャルなアクセスクラスのすべての +.Tn SCSI +デバイスへのサポートを提供します。 +シーケンシャルアクセスクラスはテープなどのリニアなアクセスデバイスです。 +.Pp +.Tn SCSI +ホストアダプタは +.Tn SCSI +シーケンシャルアクセスデバイスが設定される前に +別にシステムに設定されていなければなりません。 +.Sh マウントセッション +.Nm +ドライバは、テープがマウントされてからアンマウントされるまでの +期間として定義される +.Dq Em マウントセッション +の概念に基づいています。マウントセッションの間にセットされた +任意のパラメータは、そのセッションの残り期間あるいは +テープが取り替えられるまで、有効になっています。 +何からの方法でセッションをクローズすることで、 +テープをアンマウントすることができます。 +クローズする方法には次のようなものがあります。 +.Bl -enum +.It +以下に示すサブモード 00 にしたがい `巻戻しデバイス' をクローズする。例えば +.Pa /dev/rsa0 。 +.It +.Xr ioctl 2 +の MTOFFL コマンドを使う。 +.Xr mt 1 +の +.Sq Cm offline +コマンドを利用することにより可能です。 +.El +.Pp +テープデバイスは排他的にオープンされるデバイスであることに +注意すべきです。制御モードデバイスがオープンされている場合は例外で、 +必要な時 (例えばパラメータをセットする時) に限り排他的な +アクセスをする必要があります。 +.Sh サブモード +マイナー番号のビット 0 とビット 1 は +.Sq サブモード +として解釈されます。 +サブモードの違いは、デバイスがクローズされた時の挙動にあります: +.Bl -tag -width XXXX +.It 00 +クローズされるとデバイスを巻戻します; もしテープに書き込まれていたら、 +巻戻しが要求される前にファイルマークが書き込まれます。デバイスは +アンマウントされます。 +.It 01 +クローズ後もテープがマウントされたままにします。 +テープに書き込まれていたら、ファイルマークが書き込まれます。 +それ以外にヘッドの移動は行なわれません。 +さらに読み込んだり書き込んだりすると、最後に読み出された +り、あるいはファイルマークが書き込まれた後から直接行なわれます。 +.It 10 +クローズされるとデバイスを巻き戻します。もしテープに書き込まれて +いたら、巻き戻し要求の前にファイルマークが書き込まれます。 +巻き戻しが完了すると、アンロードコマンドが発行されます。 +デバイスはアンマウントされます。 +.Sh ブロッキングモード +.Tn SCSI +テープは +.Sq Em 可変 +あるいは +.Sq Em 固定 +ブロックサイズモードで動くことができます。 +ほとんどの +.Tn QIC +タイプのデバイスは固定ブロックサイズモードで動き、 +ほとんどの 9 トラックテープと多くの新しいカートリッジフォーマットは +可変ブロックサイズを許容します。この二つの違いはつぎの通りです: +.Bl -inset +.It 可変ブロックサイズ: +デバイスへの書き込み毎に、単一の論理レコードがテープに書き込まれます。 +レコードの +.Em 一部分 +をテープから読み込んだり書き込んだりすることはできません +(たとえ大きなブロックを要求して小さなレコードを読んでもです); +複数のブロックを読み込むこともできません。 +すなわち、1 回の書き込みによるデータは 1 回で読み込まれます。 +ブロックサイズは、デバイスすなわち +.Tn SCSI +アダプタとシステムがサポートしている任意の値です。 +(大抵は 1 バイトから 64K バイトの間で、もっと大きくなる場合もあります。) +.Pp +テープから可変長のレコードやブロックを読み込む時、 +ヘッドは最後に読み込まれたアイテムの直後にあり、 +次のアイテムの直前にあると考えられます。もし次のアイテムがファイルマークで、 +まだ読まれていなかったとすると、読み込みですぐにそのファイルマークに +当たり、ファイル終端 (end-of-file) の通知を受けます。 +.It 固定ブロックサイズ: +ユーザが書き込んだデータは固定サイズのブロックの連続としてテープに +渡されます。それはメモリ中で連続しているかもしれませんが、 +独立したブロックの連続と考えられます。 +ブロックサイズの正確な整数倍ではない量のデータを読み込む +ことはできません。異なるレコード集合として、同じデータを読み込んだり +書き込んだりすることはできます。 +言い換えると、一緒に書き込まれたブロックを別々に読み込むことが +できますし、逆もまた可能です。 +.Pp +ファイルの中に残っているものより多いブロックが要求されると、ドライブは +ファイルマークに遭遇するでしょう。返すべきデータが存在する +ので (ファイルマークより前にレコードが存在する限り)、 +そのデータは返され、読み込みは成功します。 +次の読み込みは直ちに 0 を返します。 +(上のように、もしファイルマークが読まれないと、非巻き戻しモードの場合は +次の読み込み処理へ残ります)。 +.El +.Sh ファイルマークの扱い +ファイルマークは自動的に扱われます。ユーザがテープに書き込み、 +最後に書き込んでから読み込みをしなかった場合、デバイスをクローズ +する時にファイルマークがテープに書き込まれるでしょう。 +書き込みの後に巻き戻し要求があると、ドライバはテープ上の最後のファイルが +書き込まれたと仮定し、テープに書き込まれた 2 つのファイルマークが存在 +することを保証します。 +これには例外があって、 +ある種のテープは、実際には 2 つのファイルマークを書き込まず、 +最後のファイルが読み込まれた時に `幻の' ファイルマークを報告するという +標準 (我々はこれに従いますが、どうしてそうするのか理解できません) +が存在するようです。 +それらのデバイスには、QIC ファミリが含まれます。 +(このデバイスは固定ブロックデバイスと同じかも +しれません。これはまだはっきりとしていませんが、現在ドライバは別の +振舞いとして扱っています。) +.Sh IOCTL +.Nm sa +ドライバは +.Xr mtio 4 +のすべての ioctl をサポートしています。 +.Sh ファイル +.Bl -tag -width /dev/[n][e]rsa[0-9] -compact +.It Pa /dev/[n][e]rsa[0-9] +一般的な形 : +.It Pa /dev/rsa0 +クローズ時に巻き戻し +.It Pa /dev/nrsa0 +クローズ時に巻き戻さない +.It Pa /dev/erst0 +クローズ時にイジェクトする (可能なら) +.It Pa /dev/rsa0.ctl +制御モードデバイス (他のプログラムがそのデバイスにアクセスしている間に +状態を検査するなどのためのもの) +.Sh バグ +古いデバイスを扱うために必要な多くのハックが欠けています。 +多くの古い +.Tn SCSI-1 +デバイスは、このドライバでは正しく動かないでしょう。 +.Pp +特別なデバイス名に結合された、高密度および圧縮モードのサポートを +加える必要があります。 +.Pp +パーティションの利用による高速なインデックシングのサポートがありません。 +.Sh 診断 +ありません。 +.Sh 関連項目 +.Xr mt 1 , +.Xr scsi 4 , +.Xr sa 9 +.Sh 歴史 +.Nm sa +ドライバは +.Tn CAM +.Tn SCSI +サブシステムのために Justin T. Gibbs と Kenneth Merry が書きました。 +Julian Elischer が書き、 +.Tn Mach +2.5 から移植した +.Nm st +デバイスドライバからはたくさんのアイディアを得ています。 +.sp +現在、記録を所有しているのは、 +テープドライバを破壊してきたあまりにも長い年月を +犠牲にしている Matthew Jacob です。 diff --git a/ja_JP.eucJP/man/man4/sb.4 b/ja_JP.eucJP/man/man4/sb.4 new file mode 100644 index 0000000000..ccb6b244e4 --- /dev/null +++ b/ja_JP.eucJP/man/man4/sb.4 @@ -0,0 +1,82 @@ +.\" Man page for the SoundBlaster driver +.\" +.\" Copyright (c) 1997, Alex Zepeda. +.\" +.\" This documentation is public domain, and is provided without warranty. +.\" Alex Zepeda, the "author" of this page is not responsible for any +.\" consequences of any sort of manipulation of this document. +.\" +.\" SoundBlaster and any phrases including it's name are copyright +.\" Creative Labs, not me. +.\" +.\" alex!@bigfoot.com +.\" +.Dd August 9, 1997 +.\" jpman %Id: sb.4,v 1.3 2000/01/03 03:16:06 horikawa Stab % +.Dt SB 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm sb +.Nd Creative Labs SoundBlaster 及び互換デバイスドライバ +.Sh 書式 +sb ドライバでサポートされている全てのサウンドカードには以下が必要です: +.Cd controller snd0 +.Pp +SoundBlaster, SB Pro, SoundBlaster16, Pro Audio Spectrum (SB エミュレート) +のために: +.Cd "device sb0 at isa? port 0x220 irq 7 drq 1" +.Pp +SB16 固有のサポートのために: +.Cd "device sbxvi0 at isa? drq 5" +.Pp +SoundBlaster 16 における 16 ビット MIDI サポートのために: +.Cd "device sbmidi0 at isa? port 0x300" +.Pp +Jazz16 サポートを追加するために: +.Cd "options JAZZ16" +.Pp +Logitech SoundMan Games サポートを追加するために: +.Cd "options SM_GAMES" +.Pp +SG NX Pro mixer サポートを追加するために: +.Cd "options __SGNXPRO__" +.Pp +OPL-2/3 は SoundBlaster, SoundBlaster Pro, SB 16, Pro Audio +Spectrum で使われています。Yamaha OPL-2/OPL-3 FM サポートのために: +.Cd "device opl0 at isa? port 0x388" +.Sh 解説 +このドライバは SoundBlaster 1.0 から SoundBlaster 16/SoundBlaster 32 +を含む SoundBlaster ファミリをカバーしています。awe ドライバは +AWE32/64 の機能を提供しています。このドライバは FreeBSD 2.0-current +バージョンから 3.0-current バージョンまで提供されています。 +設定ファイルに conflicts キーワードを使うことによって、 +複数のカードを同一の DMA を使用するように設定できます。 +これは、複数のエミュレーションを行うボードに有用です。 +.Sh バグ +SB16 は、別のドライバと同じ IRQ とアドレスを使うため、検出できない +snd ドライバも存在するでしょう。 +これは、衝突が発生しているとカーネルが考えるためです。 +これは、sb16 デバイスの行に "confilicts" キーワードを用いれば回避できます。 +.Pp +現在のバージョンは、デバイスをクローズして再度オープンすることなく +モードを変更する機能をサポートをしていません。この機能のサポートについては、 +将来のバージョンに実装されるかもしれません。 +.Sh 関連項目 +cdcontrol(1), cdplay(1), mixer(8) +.Sh 作者 +オリジナルの SoundBlaster DSP, SoundBlaster 16 MIDI, Yamaha OPL-3 +デバイスは +.An Hannu Savolainen +が書きました。 +SoundBlaster 16 DSP のコードは +.An J. Schuber Aq jsb@sth.ruhr-uni-bochum.de +が書きました。 +OPL-3 ドライバに対する改良は +.An Rob Hooft Aq hooft@chem.ruu.nl +が行いました。 +.Sh 歴史 +Sound Galaxy NX Pro のサポートは Hunyue Yau が追加しました(Jan 6 1994)。 +MV ProSonic/Jazz 16 の 16ビットサポートは JRA Gibson が追加しました +(April 1995)。 +Audio Excel DSP 16 サポートは Riccardo Facchetti が追加しました(March +24 1995)。 diff --git a/ja_JP.eucJP/man/man4/scd.4 b/ja_JP.eucJP/man/man4/scd.4 new file mode 100644 index 0000000000..afac49411a --- /dev/null +++ b/ja_JP.eucJP/man/man4/scd.4 @@ -0,0 +1,65 @@ +.\" +.\" Copyright (c) 1995 Jordan K. Hubbard +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: scd.4,v 1.6 1998/03/12 07:30:37 charnier Exp % +.\" jpman %Id: scd.4,v 1.3 1999/11/19 15:19:24 horikawa Stab % +.\" +.Dd January 1, 1995 +.Dt SCD 4 i386 +.Os FreeBSD 2.0.5 +.Sh 名称 +.Nm scd +.Nd Sony CDU31/33 CD-ROM ドライバ +.Sh 書式 +.Cd "device scd0 at isa? port 0x230 bio" +.Sh 解説 +.Nm scd +ドライバは Sony CDU31 及び CDU33A CD-ROM ドライブに対する +データインタフェースを提供します。 +ドライブは、 +Sony 固有のインタフェースカードか互換カードに接続する必要があります。 +.Sh 関連ファイル +.Bl -tag -width /dev/[r]scd0a -compact +.It Pa /dev/[r]scd0a +ディスク上の BSD パーティションにアクセスします。通常、CDROM ディスク +上には単一のファイルシステムのみ存在します。 +.It Pa /dev/[r]scd0c +raw デバイスにアクセスします。 +.Sh 関連項目 +.Pa /sys/i386/isa/scd.c +.Sh 作者 +本ドライバは、 +.An Holger Veit +と +.An Brian Moore +が寄贈したコードを用いて、 +.An Mikael Hybsch +が書きました。 +.Sh 歴史 +.Nm scd +ドライバは +.Fx 2.0.5 +で最初に登場しました。 diff --git a/ja_JP.eucJP/man/man4/screen.4 b/ja_JP.eucJP/man/man4/screen.4 new file mode 100644 index 0000000000..981bb988fc --- /dev/null +++ b/ja_JP.eucJP/man/man4/screen.4 @@ -0,0 +1,176 @@ +.\" +.\" %Id: screen.4,v 1.10 1998/06/08 06:11:59 jkoshy Exp % +.\" jpman %Id: screen.4,v 1.3 2000/01/03 06:30:20 horikawa Stab % +.\" WORD: original console device オリジナルコンソールデバイス +.\" WORD: character attribute 文字属性 +.\" WORD: blink 明滅(表示) [screen.4] +.\" WORD: reverse 反転(表示) [screen.4] +.\" WORD: cyan シアン +.\" WORD: magenta マゼンタ +.\" " +.Dd January 8, 1995 +.Dt SCREEN 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm screen +.Nd PC ディスプレイのインタフェース +.Sh 解説 + +/dev にあるデバイスファイル ttyv0 - ttyvb を通して +.Ar 仮想コンソール +へアクセスできます。 +これらのファイルはそれぞれ別々の仮想コンソールに対応します。 +すべての仮想コンソールデバイスを同時にオープンすることもできますが、 +アクティブなのは一度にひとつだけです。 +アクティブな仮想コンソールがキーボードやディスプレイ画面を「占有」します。 +.Pp +ディスプレイに現在向けられていない仮想コンソールへの出力は、 +「画面全体」(普通は 25 行) の行を保持するバッファに保存されます。 +.Ar /dev/console +(オリジナルコンソールデバイス) へ書き込まれた出力はすべて +/dev/ttyv0 にエコーされます。 +.Pp +仮想コンソールを切り替えるには、シーケンス +.Ar ALT+Fn +を使います。 +これは ALT を押しながらファンクションキーのひとつを押すという意味です。 +そうすると、そのファンクションキーと同じ番号の仮想コンソールが +現在の仮想コンソールとして選択され、 +キーボードやディスプレイの専有的な使用権が与えられます。 +この切り替えシーケンスは +キーボードマッピング ioctl 呼び出しで変更できます (keyboard.4 参照)。 +.Pp + +コンソールでは、特別なキーシーケンスを用いてキーボード上に物理的に +存在しない値を入力できます。この機能を使うには、ALT を押したままにして、 +数字キーパッドで 0 から 255 の 10 進数字を入力し、ALT を離してください。 +そうすると、入力された値がひとつの文字を表す ASCII 値として使われます。 +このようにして、任意の ASCII 値を入力することができます。 +また、コンソールドライバは履歴機能も備えています。 +履歴機能は scroll-lock キーを押すことで有効になります。 +これは表示を固定し、最近スクロールされた行に渡って矢印キーで +スクロールアップ・ダウンできるようにします。 + +コンソールは ANSI x3.64 文字シーケンスのサブセットを解釈します。 +古い pccons ドライバとの互換性のため、 +PC3 文字シーケンスもサポートされています。 +.Pp +.Bd -literal +ANSI Seq 機能 termcap エントリ +======= ======= ===================================== ============== + +-- E7 カーソル位置を保存 sc + +-- E8 保存したカーソル位置を復元 rc + +CUU E[nA カーソルを n 行上に移動 up/UP (ku) + +CUD E[nB カーソルを n 行下に移動 do/DO (kd) + +CUF E[nC カーソルを n 文字右に移動 nd/RI (kr) + +CUB E[nD カーソルを n 文字左に移動 --/LE (kl) + +HPA E[n` カーソルを文字位置 n に移動 ch + +HPR E[na カーソルを n 文字右に移動 -- + +VPA E[nd カーソルを行 n に移動 cv + +VPR E[ne カーソルを n 行下に移動 -- + +CPL E[nF カーソルを n 行上の行頭に移動 -- (@7) + +CNL E[nE カーソルを n 行下の行頭に移動 nw + +CUP E[y;xH カーソルを x, y に移動 cm + +HVP E[y;xf カーソルを x, y に移動 -- + +CBT E[nZ カーソルを n タブ戻す bt (kB) + +IL E[nL n 行の空行を挿入 al/AL + +ICH E[n@ n 個の空白文字を挿入 ic/IC + +DL E[nM n 行削除 dl/DL + +DCH E[nP n 文字削除 dc/DC + +ED E[nJ 表示の一部または全部を消去: cd + n=0 カーソルから表示終端までを消去 + n=1 表示始点からカーソルまでを消去 + n=2 表示全体を消去 + +EL E[nK 行の一部または全部を消去: ce + n=0 カーソルから行末までを消去 + n=1 行頭からカーソルまでを消去 + n=2 行全体を消去 + +ECH E[nX n 文字消去 ec + +SU E[nS 表示を n 行スクロールアップ (進める) sf/SF + +SD E[nT 表示を n 行スクロールダウン (戻す) sr/SR + + +SGR E[nm 文字属性を設定: -- + n= 0 通常の属性 (すべてオフ) + n= 1 ボールド体 (ハイライト表示) + n= 4 下線付き (ハードウェアがサポートしている場合) + n= 5 明滅表示 (ハードウェアがサポートしている場合) + n= 7 反転表示 + n=3X 前景色を設定 (次表参照) + n=4X 背景色を設定 (次表参照) + + X=0 黒 X=1 赤 + X=2 緑 X=3 茶 + X=4 青 X=5 マゼンタ + X=6 シアン X=7 白 + +-- E[s カーソル位置を保存 sc + +-- E[u 保存したカーソル位置を復元 rc + +-- E[=p;dB ベル音の調子 (p) と時間 (d) を設定 -- + 調子は 840 nS 単位 + 時間は 0.1 S 単位 + +-- E[=tC カーソル種を設定 -- + 1 で明滅カーソル + 0 で固定カーソル + +-- E[=nA 境界色を n に設定 + (次表参照) (ハードウェアがサポートしている場合) + +-- E[=cF 通常前景色を n に設定 -- + (次表参照) + +-- E[=cG 通常背景色を n に設定 -- + (次表参照) + +-- E[=cH 反転前景色を n に設定 -- + (次表参照) + +-- E[=cI 反転背景色を n に設定 -- + (次表参照) + + n= 0 黒 n= 8 灰 + n= 1 青 n= 9 明るい青 + n= 2 緑 n=10 明るい緑 + n= 3 シアン n=11 明るいシアン + n= 4 赤 n=12 明るい赤 + n= 5 マゼンタ n=13 明るいマゼンタ + n= 6 茶 n=14 黄 + n= 7 白 n=15 明るい白 + +注: シーケンス (Seq) 中の最初の E は ESC (0x1b) を表します。 + +.Ed +.Pp +.Sh 作者 +.ie t .An S\(/oren Schmidt Aq sos@FreeBSD.org +.el .An So/ren Schmidt Aq sos@FreeBSD.org +.\" ISO-8859 集合の文字(0xe4)に対処 金ん田 1999.03.12 +.\" .An Soren Schmidt Aq sos@FreeBSD.org +.\" ^0xe4 diff --git a/ja_JP.eucJP/man/man4/scsi.4 b/ja_JP.eucJP/man/man4/scsi.4 new file mode 100644 index 0000000000..74e8df2f26 --- /dev/null +++ b/ja_JP.eucJP/man/man4/scsi.4 @@ -0,0 +1,299 @@ +.\" %Id: scsi.4,v 1.12 1998/10/16 04:28:39 ken Exp % +.\" jpman %Id: scsi.4,v 1.3 2000/07/20 02:38:04 horikawa Stab % +.\" 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 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. +.\" +.Dd October 15, 1998 +.Dt SCSI 4 +.Os FreeBSD 3.0 +.Sh 名称 +.Nm SCSI , +.Nm CAM +.Nd CAM SCSI サブシステム +.Sh 書式 +.Cd "controller scbus0" +.Cd "controller scbus1 at ahc0" +.Cd "controller scbus3 at ahc1 bus 0" +.Cd "controller scbus2 at ahc1 bus 1" +.Cd "device cd0" +.Cd "device ch0" +.Cd "device da0" +.Cd "device pass0" +.Cd "device pt0" +.Cd "device sa0" +.Cd "device ch1 at scbus0 target 4 unit 0" +.Cd options CAMDEBUG +.Cd options "CAM_DEBUG_BUS=-1" +.Cd options "CAM_DEBUG_TARGET=-1" +.Cd options "CAM_DEBUG_LUN=-1" +.Cd options "CAM_DEBUG_FLAGS=CAM_DEBUG_INFO|CAM_DEBUG_CDB" +.Cd options "CAM_MAX_HIGHPOWER=4" +.Cd options SCSI_NO_SENSE_STRINGS +.Cd options SCSI_NO_OP_STRINGS +.Cd options SCSI_DELAY=8000 +.Sh 解説 +CAM +.Tn SCSI +サブシステムは、 +各種の +.Tn SCSI +デバイスを制御するドライバや、ホストアダプタドライバを経由して異なる +.Tn SCSI +ホストアダプタを利用するドライバを実装するための、 +均質でモジュール化されたシステムを提供します。 +システムが +.Tn SCSI +バスをプローブし、発見したデバイスを適切なドライバにアタッチします。 +.Xr pass 4 +ドライバがカーネルに組み込まれていれば、すべての +.Tn SCSI +デバイスがアタッチされます。 +.Sh カーネルの設定 +CAM +.Tn SCSI +サブシステム用に一般的なカーネル設定オプションがいくつかあります: +.Bl -tag -width SCSI_NO_SENSE_STRINGS +.It Dv CAMDEBUG +このオプションは、CAM デバッグ用の printf コードを有効にします。 +実際には、このオプションだけではデバッグ情報は出力されません。 +出力するためには追加設定が必要です。詳細は下記を参照して下さい。 +.It Dv "CAM_MAX_HIGHPOWER=4" +同時使用できる "high power" コマンドの最大数を設定します。 +"high power" コマンドとは、 +他のコマンドに比べて、実行するのにより多くの電力を必要とするコマンドです。 +その一例は +.Tn SCSI +START UNIT コマンドです +(現在のところ "high power" の烙印を押されている唯一のコマンドです)。 +SCSI ディスクを起動するには、通常のディスク操作に比べて +かなり大きな電力を消費します。 +このオプションで、コンピュータの電源に負荷をかけ過ぎずに +"high power" コマンドを同時にいくつまで発行できるかを指定できます。 +.It Dv SCSI_NO_SENSE_STRINGS +.Tn SCSI +Additional Sense Code と Additional Sense Code Qualifier の組についての +解説文をすべて除去します。 +この文は本当に大きなテキストデータベースなので、 +除去すれば、カーネルのサイズを少し削減できます。 +このオプションは、主としてブートフロッピや、 +他のディスク空間あるいはメモリ空間が小さい環境で必要となります。 +他の環境でも、 +多くの場合はこのオプションを有効にすべきです。 +.Tn SCSI +のエラーメッセージの解釈を速めることになるからです。 +カーネルを無用に膨張 ("kernel bloat") させることばかりに熱中しないで、 +あなたのカーネルに解説文を残さないようにしましょう! +.It Dv SCSI_NO_OP_STRINGS +.Tn SCSI +opcode の解説文をすべて無効にします。 +このオプションは、前述した sense 文字列と場合と同様、主として +カーネルサイズが重要なブートフロッピのような環境で役に立ちます。 +通常の使用環境でこのオプションを有効にすることは推奨されません。 +.Tn SCSI +の障害のデバッグを遅らせるからです。 +.It Dv SCSI_DELAY=8000 +.Tn SCSI +のバスが安定するまでの遅延 ("bus settle delay") です。 +CAM の場合、 +.Em ミリ秒 +単位で指定します。 +以前の +.Tn SCSI +層で使われていた秒単位ではありません。 +カーネルはブート時にバスリセットを各 +.Tn SCSI +バスに送り、各デバイスが転送ネゴシエーションやその他の設定を +デフォルトの状態に自分自身でリセットするよう通知します。 +ほとんどの +.Tn SCSI +デバイスは、バスリセットから復帰するのに、ある程度の時間を必要とします。 +最近のディスクは 100ms 程度の短かい時間しか必要としませんが、 +古くて遅いデバイスはもっと長い時間を必要とするかもしれません。 +.Dv SCSI_DELAY +を指定しなければ、デフォルトでは 2 秒になります。 +.Dv SCSI_DELAY +の最小値は "100"、すなわち 100ms です。 +唯一特殊なケースは +.Dv SCSI_DELAY +に 0 を指定した場合で、"できるだけ小さい値" を意味します。 +この場合、 +.Dv SCSI_DELAY +は 100ms にリセットされます。 +.El +.Pp +すべてのデバイスおよび SCSI バスはブート時の割当てをサポートしているので、 +上位の番号のデバイスおよびコントローラを設定する必要はありません; +.Cd "device da0" +は任意の番号のディスクドライバに対して十分な記述です。 +.Pp +デバイスは、特定のデバイスユニットとして認識される +.Em wired +(束縛される) か、 +その次に有効な未使用ユニットとして認識される +.Em counted +(数え上げられる) のどちらかです。 +.Pp +カーネル内のドライバがデバイスを束縛しないように設定するには、 +.Cd "device ch0" +のような設定行を記述して、チェンジャドライバを組み込んで下さい。 +.Pp +ユニットを束縛するには、 +.Cd "device ch1 at scbus0 target 4 unit 0" +のような設定行を記述して、 +チェンジャ 1 を SCSI バス 0 上の SCSI ID 4、SCSI 論理ユニット 0 の +チェンジャに割り当てます。 +各 SCSI バスを指定したコントローラに束縛するには、 +.Cd "controller scbus0 at ahc0" +のように設定行を記述します。 +これは、SCSI バス 0 を ahc ドライバを用いる最初のユニットに割り当てます。 +複数のバスをサポートするコントローラの場合、 +特定のバスを +.Cd "controller scbus3 at ahc1 bus 1" +の形式で指定できます。 +これは、SCSI バス 1 を ahc1 デバイス上で 2 番目にプローブされたバスに +割り当てます。 +.Pp +wired デバイスと counted デバイスが混在している場合、 +そのデバイスタイプについての最初の非 wired ユニットから数え始めます。 +すなわち、wired ディスク +.Em "device da1" +があると、最初の非 wired ディスクは +.Em da2 +として認識されることになります。 +.Sh アダプタ +このシステムでは、たくさんの種類の異なるアダプタに +共通のデバイスドライバを使用することが可能です。 +アダプタは上位層から要求を受けて、 +.Em SCSI +バスとシステムの間のすべての IO を実行します。 +転送の最大サイズはアダプタによって支配されます。 +ほとんどのアダプタが一度の操作で 64KB を転送できますが、 +多くのアダプタはもっと大量に転送できるかもしれません。 +.Sh ターゲットモード +いくつかのアダプタは、 +.Em ターゲットモード +をサポートしています。 +このモードでは、 +システムをひとつのデバイスとして操作することが可能となり、 +別のシステムが発行した操作に応答するようになります。 +ターゲットモードは、いつくかのアダプタでサポートされていますが、 +このバージョンの CAM +.Tn SCSI +サブシステムではまだ完全ではありません。 +.Sh 関連ファイル +他の SCSI デバイスのエントリを参照して下さい。 +.Sh 診断 +カーネルが options CAMDEBUG 付きでコンパイルされている場合、 +XPT_DEBUG CCB を用いれば、 +任意の指定したデバイスに関して、さまざまな量のトレース情報を +取得可能になります。 +トレースされていないデバイスはトレース情報を生成しません。 +現在は 4 つのデバッグフラグをオンにできます: +.Bl -tag -width CAM_DEBUG_SUBTRACE +.It Dv CAM_DEBUG_INFO +該当するデバイス (群) について一般的な情報の printf 出力が可能になります。 +.It Dv CAM_DEBUG_TRACE +関数レベルでのコマンドフローのトレースが可能になります。 +すなわち、関数の入口と出口でカーネルの printf 出力が発生します。 +.It Dv CAM_DEBUG_SUBTRACE +関数内部でのデバッグ出力が可能になります。 +.It Dv CAM_DEBUG_CDB +特定のデバイス (群) に送信されたすべての +.Tn SCSI +コマンドをカーネルが印字するようになります。 +.El +.Pp +これらのフラグのうち、特に +.Dv CAM_DEBUG_TRACE +と +.Dv CAM_DEBUG_SUBTRACE +は膨大な量のカーネルの printf 出力を発生しますので、 +あまり有益ではありません。 +.Dv CAM_DEBUG_INFO +のレベルでログ出力されるものは多くはありませんので、 +これもそれほど有益ではありません。 +最も有益なデバッグフラグは +.Dv CAM_DEBUG_CDB +フラグです。 +以下のカーネルオプションを使用して、 +カーネル設定ファイルからデバッグを有効にできます: +.Bl -tag -width CAM_DEBUG_TARGET +.It Dv CAMDEBUG +CAM のデバッグを有効にします。 +このオプションなしでは、ユーザランドから +.Xr camcontrol 8 +を経由してデバッグを有効にすることもできません。 +.It Dv CAM_DEBUG_FLAGS +上に述べたような各種のデバッグフラグを、 +カーネル設定ファイルで設定することが可能になります。 +フラグの論理和を取れば、 +複数のデバッグレベルでの printf 出力を見ることもできます。 +.It Dv CAM_DEBUG_BUS +デバッグの対象とするバスを指定します。 +すべてのバスをデバッグするには、この値を -1 に設定します。 +.It Dv CAM_DEBUG_TARGET +デバッグの対象とするターゲットを指定します。 +すべてのターゲットをデバッグするには、この値を -1 に設定します。 +.It Dv CAM_DEBUG_LUN +デバッグの対象とする論理ユニット番号を指定します。 +すべての論理ユニット番号をデバッグするには、この値を -1 に設定します。 +.El +.Pp +あるバス、ターゲット、もしくは論理ユニット番号を指定する場合には、 +上述した 3 つのバス/ターゲット/論理ユニット番号のオプションを +すべて指定することが必須となります。 +ワイルドカードを使用すれば、 +ほとんどの機器についてデバッグを有効にすることができます。 +.Pp +.Dv CAMDEBUG +オプションを設定ファイルに含めていれば、 +.Xr camcontrol 8 +ユーティリティを使用して、起動中に printf デバッグを有効にすることもできます。 +詳細は +.Xr camcontrol 8 +を参照して下さい。 +.Sh 関連項目 +.Xr aha 4 , +.Xr ahb 4 , +.Xr ahc 4 , +.Xr bt 4 , +.Xr cd 4 , +.Xr ch 4 , +.Xr da 4 , +.Xr pass 4 , +.Xr pt 4 , +.Xr sa 4 , +.Xr xpt 4 , +.Xr camcontrol 8 +.Sh 歴史 +CAM +.Tn SCSI +サブシステムは +.Fx 3.0 +で初めて登場しました。 +.Sh 作者 +CAM +.Tn SCSI +サブシステムは Justin Gibbs と Kenneth Merry によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/sd.4 b/ja_JP.eucJP/man/man4/sd.4 new file mode 100644 index 0000000000..6fcd520368 --- /dev/null +++ b/ja_JP.eucJP/man/man4/sd.4 @@ -0,0 +1,41 @@ +.\" 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: sd.4,v 1.12 1998/10/16 04:06:21 ken Exp % +.\" jpman %Id: sd.4,v 1.3 1999/11/06 17:28:30 horikawa Stab % +.\" +.Dd October 15, 1998 +.Dt SD 4 +.Os FreeBSD +.Sh 名称 +.Nm sd +.Nd SCSI ディスクドライバ +.Sh 解説 +.Nm sd +ドライバは +.Xr da 4 +ドライバによって置き換えられました。 +.Sh 関連項目 +.Xr da 4 diff --git a/ja_JP.eucJP/man/man4/si.4 b/ja_JP.eucJP/man/man4/si.4 new file mode 100644 index 0000000000..67b7efc6d8 --- /dev/null +++ b/ja_JP.eucJP/man/man4/si.4 @@ -0,0 +1,191 @@ +.\" %Id: si.4,v 1.13 1998/06/08 06:11:59 jkoshy Exp % +.\" jpman %Id: si.4,v 1.3 2000/08/31 20:36:25 kuma Stab % +.\" The following requests are required for all man pages. +.\" WORD: callin 着呼(デバイス)[si,sio] +.\" WORD: dialin 着呼(デバイス)[si,sio] +.\" WORD: callout 発呼(デバイス)[si,sio] +.\" +.Dd September 16, 1995 +.Os FreeBSD +.Dt SI 4 i386 +.Sh NAME +.Nm si +.Nd Specialix International SI/XIO および SX インテリジェントシリアルカードのためのドライバ +.Sh 書式 +.Cd "device si0" +.Cd "device si0 at isa? tty irq 12 iomem 0xd0000" +.Sh 解説 +Specialix の SI/XIO および SX ハードウェアは +8 ポートから 32 ポートの RS-232 シリアルマルチプレクサを構成します。 +.Pp +上の 1 行目は EISA と PCI ホストカード用で、2 行目は +ISA ホストカード用のものです。 +.Pp +システムは 2 つの部分を使います: +「ホストアダプタ」は ISA、EISA あるいは PCI スロットに挿入され、 +37 ピンケーブル形式の外部バスと、 +制御とデータのバッファリングおよび処理を行う能力を提供します。 +.Pp +このケーブルには「モジュール」が接続されます。 +"SI" モジュールは 4 ポートあるいは 8 ポートの +バージョンがあります。"XIO" および "SX" モジュールは +8 ポートのバージョンだけがあります。 +.Pp +ホストアダプタはデータをポーリングし、 +モジュールとマシンの間の転送を行ないます。 +ホストアダプタは、制御できる 32 個のポートのそれぞれについて +256 バイトの送信用および 256 バイトの受信用 +FIFO バッファを提供します。 +.Pp +XIO モジュールは 8 個のポートそれぞれについて 115,200 ボーで +使用できます。SI バージョンは 57,600 ボーです。 +SX モジュールは 8 個のポートそれぞれについて最大 921,600 ボーで +使用できます。 +.Pp +SX モジュールは SX ホストカードに接続されている場合にのみ +サポートされます。SI または XIO はどのホストカードでもサポート +されています。 +.Pp +ホストアダプタは、ISA バスの 0xA0000 から 0xEFFFF までの間にある +伝統的な "穴" にある共有メモリブロックを使用します。 +アダプタ自体はそれ以外の範囲にも設定できますが、そのメモリ領域は +明示的に +非キャッシュ状態にしておく必要があります。 +ドライバは、このモードでの使用をまだサポートしていません。 +.Pp +SX の ISA ホストカードは、8 ビットモードと 16 ビットモードを +切り替えるスイッチまたはジャンパを持っています。 +このスイッチまたはジャンパは、8 ビットモードにセットされていなければ +なりません。 +.Pp +ISA アダプタは IRQ 11, 12, 15 を利用できます +(さらに、SX ホストカードでは IRQ 9 と 10 が利用できます)。 +.Pp +si デバイスドライバは、実行時にいくつかの設定を +.Xr sicontrol 8 +ユーティリティで変更することができます。 +.Pp +si デバイスドライバはクローズオンドレイン (drain-on-close) の +タイムアウトを設定するための +.Xr comcontrol 8 +ユーティリティにも反応します。 +.Pp +ドライバは 3 個の 操作可能な sysctl 変数を定義しています: +machdep.si_debug は、ドライバ全体のデバッグレベルを設定します。 +これを利用するには、ドライバが SI_DEBUG フラグ付きでコンパイル +されている必要があります。 +machdep.si_pollrate は、割り込みが消失したときのために +ドライバが 1 秒間に何回ポーリングするかを設定します。 +machdep.si_realpoll は、毎回のポーリングの際に、割り込みが +発生したかのように扱うかどうかを設定します。 +.Pp +si ドライバが制御する /dev のデバイスノードに対する +オープンは、 +.Xr sio 4 +ドライバと同じセマンティクスで動作します。 +このドライバは、cua ポートの通常のセマンティクスと "初期状態の termios" +および "ロックされた termios" の設定を完全にサポートします。 +簡単にまとめると、 +O_NONBLOCK がセットされていない限り、tty ポートのオープンは +DCD が上がるまでブロックされます。 +CLOCAL も効きます。これを設定すると、cua ポートのオープンは +常に成功しますが、ひとたび DCD が上がってからは、DCD の変化も効きます。 +.Pp +si ドライバは SI/XIO ホストカードを最大 4 枚まで制御できます。 +割り込みが足りないため、同時に使用できる SI/XIO ホストカードは +3 枚までです。 +.Pp +マイナデバイス番号の下位 5 ビットは、モジュールクラスタ上のポート番号 +を選択するために使われます。次の 2 ビットは 4 枚のホストアダプタカードの +どれを選択するかを決めます。これにより、このドライバ上で +最大 128 個のポートが利用可能になります。 +.Pp +bit 7 で tty/着呼ポート (bit 7=0) と +cua/発呼ポート (bit 7=1) を区別します。 +.Pp +bit 7 から bit 15 ( +.Tn FreeBSD において ) +はメジャーデバイス番号の影にあたるため利用できません。 +.Pp +bit 16 が 1 であれば、そのデバイスノードは "初期状態" デバイスである +ことを示します。 +この "初期状態" は、最初にオープンされた時にデバイスの +.Xr termios 4 +の設定を準備するために使われます。 +bit 17 が 1 であれば、"ロック状態" デバイスであることを示します。 +"ロック状態" は、 +.Xr termios 4 +の設定の変更を阻止するために使われます。 +.Pp +初期 / ロックの設定を操作するためには、 +.Xr stty 1 +コマンドを使うとよいでしょう。 +"ロック" 変数の設定においては、 +ロックデバイスのモードを有効にすると、 +.Xr termios 4 +のモードがロックされます。逆に、ロックデバイスのモードを無効にすると、 +.Xr termios 4 +のモードがロック解除されます。 +.Sh ファイル +.Bl -tag -width /dev/si_control -compact +.It Pa /dev/si_control +.Xr sicontrol 8 +が使用する、ドライバを制御するグローバルなファイル。 +.It Pa /dev/ttyA* +ターミナル / 着呼ポート +.It Pa /dev/cuaA* +発呼ポート +.It Pa /dev/ttyiA* +初期状態 termios デバイス +.It Pa /dev/ttylA* +ロック状態 termios デバイス +.It Pa /dev/cuaiA* +発呼ポート用の初期状態 termios デバイス +.It Pa /dev/cualA* +発呼ポート用のロック状態 termios デバイス +.El +.Sh 関連項目 +.Xr stty 1 , +.Xr sio 4 , +.Xr termios 4 , +.Xr tty 4 , +.Xr comcontrol 8 , +.Xr sicontrol 8 +.Sh 歴史 +このドライバは Specialix 由来のドライバコードを +おおざっぱにベースとしており、 +.An Andy Rutter Aq andy@specialix.co.uk +が BSDI で動かすために移植しました。 +System V 用のドライバソースが ftp で +.Sy ftp.specialix.co.uk . +から入手可能です (入手可能でした)。 +.Pp +Specialix International はこのドライバをサポートしていません。 +.Sh 作者 +.An Peter Wemm Aq peter@netplex.com.au +が Andy Rutter からコードを得て、 +.Fx +へ移植しマニュアルページとともに提出しました。 +.An Bruce Evans Aq bde@zeta.org.au +は移植作業の間、多くの助力をしてくれました。 +.An Nick Sayer Aq nick@specialix.com +は EISA、PCI および SX のポートを書きました。 +.Sh バグ +割り込みのチューニング比は、現在のところ +最大の効率を得られるように最適化されていないと思います。 +.Pp +ポーリングモード (Specialix による標準ドライバの特徴) は +実装されていませんが、machdep.si_realpoll をオンにすることで +似た動作とすることができます。ポーリング周期は +machdep.si_pollrate で設定します (1/100 秒の単位です)。 +.Pp +このドライバは、SX モジュールで 115,200 より大きいボーレートを +まだサポートしていません。 +.Pp +伝統的な ISA の "穴" の外での動作はまだサポートされていません。 +プローブルーチンから穴のテストを削除すれば動くはずですが。 +.Pp +複数のホストカードはサポートされていますが、異なるバスタイプの +ホストカードの組み合わせについてはテストされていません。- +デバイスの番号づけに +問題があることが分かっています。予期しない結果を招くかもしれません。 diff --git a/ja_JP.eucJP/man/man4/sio.4 b/ja_JP.eucJP/man/man4/sio.4 new file mode 100644 index 0000000000..7a5310c2e8 --- /dev/null +++ b/ja_JP.eucJP/man/man4/sio.4 @@ -0,0 +1,349 @@ +.\" Copyright (c) 1990, 1991 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Systems Programming Group of the University of Utah Computer +.\" Science Department. +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" from: @(#)dca.45.2 (Berkeley) 3/27/91 +.\" jpman %Id: sio.4,v 1.3 2000/08/29 00:55:24 jsakai Stab % +.\" from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp +.\" %Id: sio.4,v 1.28 1998/10/22 14:12:55 bde Exp % +.\" +.Dd October 10, 1995 +.Dt SIO 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm sio +.Nd +高速割り込み駆動非同期シリアル通信インタフェース +.Sh 書式 +標準ポート用 : +.Cd "device sio0 at isa? port" \&"IO_COM1\&" tty irq 4 +.Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 +.Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 +.Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 +.Pp +AST 互換 4ポートマルチポートカード用 : +.Cd "options" \&"COM_MULTIPORT\&" +.Cd "device sio4 at isa? port 0x2a0 tty flags 0x701" +.Cd "device sio5 at isa? port 0x2a8 tty flags 0x701" +.Cd "device sio6 at isa? port 0x2b0 tty flags 0x701" +.Cd "device sio7 at isa? port 0x2b8 tty flags 0x701 irq 12" +.Pp +Boca Board 互換 8 ポートマルチポートカード用 : +.Cd "options" \&"COM_MULTIPORT\&" +.Cd "device sio4 at isa? port 0x100 tty flags 0xb05" +.Cd "..." +.Cd "device sio11 at isa? port 0x138 tty flags 0xb05 irq 12" +.Pp +ヘイズ ESP カード用 : +.Cd "options" \&"COM_ESP\&" +.Cd "..." +.Pp +.Ar フラグ +の意味 : +.Bl -tag -offset indent -compact -width 0x000000 +.It 0x00001 +共有 IRQ +.It 0x00002 +FIFO を無効にする +.It 0x00004 +AST/4 互換の IRQ コントロールレジスタを使用しない +.It 0x00008 +失われた出力割り込みから早く復旧する +.It 0x00010 +デバイスはシステムコンソールになることができる +.It 0x00020 +デバイスは強制的にシステムコンソールとなる +.It 0x00040 +下位層の IO (例えば、リモートカーネルデバッグ) 用にデバイスを予約する +.It 0x0 Ns Em ?? Ns 00 +マスタポートのマイナナンバ +.It 0x20000 +デバイスが 16650A タイプ (拡張 FIFO) のチップを使用すると仮定する +.El +.Pp +マイナナンバリング : +.br +0b\fIOLIMMMMM\fR +.br + call\fBO\fRut +.br + \fBL\fRock +.br + \fBI\fRnitial +.br + \fBMMMMMM\fRinor +.Sh 解説 +.Nm sio +ドライバは、NS8250, NS16450, NS16550 そして NS16550A 互換の +.Tn EIA +.Tn RS-232C +.Pf ( Tn CCITT +.Tn V.24 ) +通信インタフェースをサポートします。NS8250 および NS16450 は +1 文字分のバッファを持っています。NS16550A は 16 文字の FIFO 入力 +および出力バッファを持っています。 +.Pp +各ラインの入出力は、以下のボーレートのうちのいずれかに設定できます : +50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, +19200, 38400, 57600, 115200。ハードウェアによっては、 +ボーレートの選択の幅が狭まるかもしれません。 +.Pp +このドライバは、`マルチポート' カードをサポートしています。 +マルチポートカードとは、1 つないし複数のポートのグループを持って +いるカードで、そのグループは、グループごとに割り込み要求 (IRQ) ラインを +共有しています。 +別々のカードで同じ IRQ を共有することはサポートされていません。 +多くの場合、4 ポートで IRQ を 1 つ共有しています。 したがって、 +8 ポートのカードでは、4 ポートの組が 2 つあるので、IRQ を 2 つ +使用するものがあります。 +カードによっては、最初の 2 つのシリアルポートが、ポートごとに別の +IRQ を持つようにできるものがあります (DOS PC 標準に従って) 。 +.Pp +カードによっては、各グループについて IRQ コントロールレジスタを +持つものがあります。また、このようなレジスタに関連する特別な +初期化が必要なカードもあります。 +AST/4 互換の IRQ コントロールレジスタのみがサポートされています。 +カードによっては、各グループに対して IRQ ステータスレジスタを +持っているものがあります。 +本ドライバは、まだこうしたレジスタを必要とせず、使用してもいません。 +グループに対するコントロールレジスタならびにステータスレジスタを +ともかくも使用できるようにするには、そのグループ内のポートの +スクラッチレジスタ (レジスタ 7) にマップしなくてはなりません。 +こうしたポートは +.Em マスタ +ポートと呼ばれています。 +.Pp +16550A UART 上の FIFO を無効にするために、 +カーネル設定ファイル内の各 +.Em device sio +行で、 +.Em flags +キーワードを使用できます +(書式の項を参照) 。 +ほとんどの場合、FIFO を無効にする必要はありません。 +.Pp +IRQ を共有するグループの一部であるポートはすべて、 +.Em flags +キーワードを使用 +.Em しなくてはなりません。 +1 ビットで IRQ の共有を指定し、 +もう 1 ビットでポートが +AST/4 互換の初期化を +.Em 必要としない +かどうかを指定します。 +グループのマスタポートに対応する +デバイスのマイナナンバは、高位バイトのビットフィールドとして +符号化されます。 +1 つのグループに属するポート用には、 +同一のマスタポートを指定しなくてはなりません。 +.Pp +マスタポートならびに IRQ 共有グループに属さないポート用には +.Em irq +を指定してやらなくてはなりません。 +それ以外のポートに対しては指定してはいけません。 +.Pp +書式の項で、 +.Em flags 0x701 +とあるのは、8 番目のポート (sio7) が +マスタポートであり、 +またこのポートは 共有 IRQ ならびに AST/4 互換の +IRQ コントロールレジスタを持ったマルチポートカード上にある +という意味です。 +.Pp +.Em flags 0xb05 +は、12 番目のポート (sio11) が +マスタポートであり、 +共有 IRQ を持っているが、特に IRQ コントロールレジスタを持たない +マルチポートカード上にこのポートがあるという意味です。 +.Pp +どちらのポートがマスタポートとなるかは、カードの種類に依存します。 +お手持ちのカードのハードウェア説明書を調べてください。 +IRQ ステータスレジスタが使われることは決してなく、 +IRQ コントロールレジスタは AST/4 互換のカードでしか使われないこと、 +また、コントロール / ステータスレジスタをグループ内の +すべてのポートに対してマップするカードがあることから、 +グループ内のどのポートでもマスタポートにして良いことがあります。 +将来の互換性のために IRQ ステータスレジスタを含んだポートを +選択してください。 +また、確実性を持たせるために、もっとも上位の番号のポートを選択して +ください。 +.Pp +.Nm sio +ドライバで制御されるシリアルポート +は、「着呼」にも「発呼」にも使うことができます。 +各ポートについて、着呼デバイスと発呼デバイスがあります。 +発呼デバイスのマイナナンバは、対応する着呼デバイス用のものより +128 だけ大きいものになっています。 +着呼デバイスは一般的な用途のものです。着呼デバイスをオープンするプロセスは、 +通常キャリアを待ったり、発呼デバイスが使用停止の状態になるのを待ちます。 +発呼デバイスは、着呼デバイス上でキャリアを待っているプロセスから +ポートを奪うのに使われます。 +発呼デバイスをオープンするプロセスはキャリアを待たず、着呼プロセス上で +キャリア待ちをしている任意のプロセスをより深い休眠状態にします。 +これにより、着呼デバイス上でキャリアを待っているプロセスは +発呼セッションと競合しなくなります。 +発呼デバイスは、一般的なポートで動き、かつポートをキャリア待ちをせずに +オープンする必要があると仮定された制御プログラムで誤用されていますが、 +そのような使い方をするのは全く馬鹿げています。 +.Pp +.Nm sio +ドライバは、初期状態およびロック状態をコントロールする、 +各着呼および発呼 "データ" デバイス用の制御デバイスもサポートします。 +初期状態制御デバイスのマイナナンバは、 +対応するデータデバイスのマイナナンバよりも +32 だけ大きいものです。 +また、ロック状態を制御するデバイスのマイナナンバは、 +対応するデータデバイスのマイナナンバよりも 64 だけ大きいものです。 +データデバイスの termios の設定は、 +初めてオープンした初期状態制御デバイスに対応したものがコピーされます。 +過去にオープンしたときのものは継承されません。 +termios の初期状態をあなたが望むようにプログラムしたいのであれば、 +初期状態制御デバイス上で通常の方法で +.Xr stty 1 +を使用してください。 +.Pp +termios のロック状態は、termios の状態変更を無効にするフラグのような +振舞いをします。 +たとえば、CRTSCTS のような flag 変数をロックするには、 +ロック制御デバイスで +.Em stty crtscts +を使用してください。 +通信速度やスペシャルキャラクタをロックするには、 +ロック状態制御デバイス内の対応する値に 0 以外の値を設定します。 +.Pp +正しく接続された外部デバイスと通信するプログラムは、 +誤りがなければほとんどどのような初期状態でもロックせずに動作しますが、 +他のセットアップを用いた方がデフォルトの初期状態をいくつか +変更したり、状態をロックしたりするのに便利なことがあります。 +特に、接続されたデバイスを適切なものにするためには、 +POSIX 標準でないフラグの初期状態を設定すべきです。 +また、場合によってはバグのありそうなプログラムが POSIX 標準でない +フラグを書き換えてしまわないように初期状態をロックする必要が +あるかもしれません。 +例えば、CRTSCTS フラグは、 RTS/CTS ハンドシェークをいつでもサポートする +デバイスではロックすべきですし、 +RTS/CTS ハンドシェークを一切サポートしないデバイスではロックすべきでは +ありません。 +CLOCAL フラグはキャリアをサポートしないデバイスではロックすべきです。 +HUPCL フラグは、何らかの理由でハングアップさせたくないのなら +ロックすべきではありません。 +一般的に、適切でない状態で何かをロックすると非常に良くないことが +起こります。また、2 つ以上の設定をサポートするデバイスはロック +すべきではありません。 +着呼ポートの CLOCAL フラグは、logins プログラムがある種の +セキュリティホールを作ってしまうのを防ぐために、 +ロックしないでおくべきです。 +ただし、着呼ポートが他の用途に使用されている場合に、 +着呼ポートがロックされないようにするには、getty を用いる必要があります。 +.Sh 関連ファイル +.Bl -tag -width /dev/ttyid? -compact +.It Pa /dev/ttyd? +着呼ポート用 +.It Pa /dev/ttyid? +.It Pa /dev/ttyld? +対応する着呼初期状態制御デバイスおよびロック状態制御デバイス +.Pp +.It Pa /dev/cuaa? +発呼ポート用 +.It Pa /dev/cuaia? +.It Pa /dev/cuala? +対応する発呼初期状態制御デバイスおよびロック状態制御デバイス +.El +.Pp +.Bl -tag -width /etc/rc.serial -compact +.It Pa /etc/rc.serial +初期状態制御デバイスおよびロック状態制御デバイスの設定例 +.El +.Pp +デバイス番号は、[0-9a-v] という +集合からなっているので、10 ポート以上の場合もサポートできます。 +.Sh 診断 +.Bl -diag +.It sio%d: silo overflow. +割り込みハンドラ内で問題がありました。 +.El +.Bl -diag +.It sio%d: interrupt-level buffer overflow. +ドライバのボトムハーフでの問題です。 +.El +.Bl -diag +.It sio%d: tty-level buffer overflow. +アプリケーション側での問題です。 +与えられたモジュールの処理速度よりも速く入力が到着してしまい、 +いくつかデータを失ってしまいました。 +.El +.\" .Bl -diag +.\" .It sio%d: reduced fifo trigger level to %d. +.\" Attempting to avoid further silo overflows. +.\" .El +.Sh 関連項目 +.Xr stty 1 , +.Xr termios 4 , +.Xr tty 4 , +.Xr comcontrol 8 +.Sh 歴史 +.Nm +ドライバは、 +.Tn HP9000/300 +.Xr dca 4 +ドライバから生まれており、 +.\" .Ud +現在、開発中 +です。 +.Sh バグ +遅いシステムでボーレートを高くしたり、ポートが多すぎたり、 +あるいは負荷の高いシステムで crtsct が使えないときには、 +データが失われることがあります。 +NS16550A のものを使うと、システムの負荷を下げ、データが失われる +のを防ぐことができます。 +.Pp +ただの NS16550 を使わないでください。これは初期のチップ実装であり、 +機能しない FIFO ハードウェアを搭載しています。 +.Pp +さまざまなシリアルポートの場所を定義する定数値は、 +.Tn DOS +から引き継いだものです。 +御覧のとおり、16 進数表記のアドレスを替わりに使用することができますし、 +また、分かりやすさから言ってもそうすべきでしょう。 +.Pp +注意として、AST/4 を使用するときには、ディップスイッチを割り込み共有を +使用するようには設定 +.Em しないで +ください。 +AST/4 のような割り込み共有が使用できるのは、 +.Em 複数の +AST/4 カードが同じシステムに設置されているときだけです。 +sio ドライバは、ひとつの IRQ に +複数の AST/4 カードが設置されているような場合はサポートしていません。 +.Pp +書式の項の例はかなりベンダに依存したものです。 diff --git a/ja_JP.eucJP/man/man4/sl.4 b/ja_JP.eucJP/man/man4/sl.4 new file mode 100644 index 0000000000..85852eedbc --- /dev/null +++ b/ja_JP.eucJP/man/man4/sl.4 @@ -0,0 +1,84 @@ +.\" %NetBSD: sl.4,v 1.1 1996/08/10 21:26:14 explorer Exp % +.\" +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)lo.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: sl.4,v 1.3 2000/07/17 01:37:48 takamune Stab % +.\" +.\" WORD: header compression ヘッダ圧縮 +.\" WORD: autodetection 自動検出 +.\" +.Dd August 10, 1996 +.Dt SL 4 +.Os +.Sh 名称 +.Nm sl +.Nd slip ネットワークインタフェース +.Sh 書式 +.Cd "pseudo-device sl" Op Ar count +.Sh 解説 +.Nm sl +インタフェースによって、 +.Em slip +プロトコルを用いたネットワークインタフェースとして、 +シリアル回線を使用できます。 +.Nm sl +インタフェースは Van Jacobson TCP ヘッダ圧縮と +ICMP フィルタリングを使用できます。 +この機能は、 +.Xr ifconfig 8 +コマンドに様々なリンクレベルフラグを用いることで準備されます: +.Pp +.Bl -tag -width LINK0X -compact +.It Em link0 +VJ ヘッダ圧縮を有効にします。 +.It Em link1 +ICMP トラフィックを抑制します。 +.It Em link2 +VJ ヘッダ圧縮の自動検出を有効にします。 +ドライバが最初の VJ 圧縮パケットを見つけるとすぐに +.Em link0 +フラグを有効にします。 +.El +.Sh 診断 +.Bl -diag +.It sl%d: af%d not supported. +インタフェースは不適当なアドレスファミリに含まれる +アドレス形式のメッセージを受け取りました。 +パケットは捨てられました。 +.El +.Sh 関連項目 +.Xr inet 4 , +.Xr intro 4 , +.Xr slattach 8 , +.Xr sliplogin 8 , +.Xr slstat 8 diff --git a/ja_JP.eucJP/man/man4/smb.4 b/ja_JP.eucJP/man/man4/smb.4 new file mode 100644 index 0000000000..0fbbc7b094 --- /dev/null +++ b/ja_JP.eucJP/man/man4/smb.4 @@ -0,0 +1,71 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: smb.4,v 1.3 1999/09/11 08:15:29 horikawa Stab % +.Dd October 25, 1998 +.Dt SMB 4 +.Os FreeBSD +.Sh 名称 +.Nm smb +.Nd +SMB 汎用 I/O デバイスドライバ +.Sh 書式 +.Cd "device smb0 at smbus?" +.Sh 解説 +.Em smb +キャラクタデバイスドライバは、 +すべての +.Xr smbus 4 +のインスタンスに汎用の I/O を提供します。 +SMB デバイスを制御するためには、次の ioctl で /dev/smb? を使用します。 +.Pp +.Bl -column "システム管理バス ioctl" -compact +.It Em ioctl Ta Em 説明 +.It Sy SMB_QUICK_WRITE Ta "QuickWrite コマンド" +.It Sy SMB_QUICK_READ Ta "QuickRead コマンド" +.It Sy SMB_SENDB Ta "SendByte コマンド" +.It Sy SMB_RECVB Ta "ReceiveByte コマンド" +.It Sy SMB_WRITEB Ta "WriteByte コマンド" +.It Sy SMB_WRITEW Ta "WriteWord コマンド" +.It Sy SMB_READB Ta "ReadByte コマンド" +.It Sy SMB_READW Ta "ReadWord コマンド" +.It Sy SMB_PCALL Ta "ProcedureCall コマンド" +.It Sy SMB_BWRITE Ta "BlockWrite コマンド" +.It Sy SMB_BREAD Ta "BlockRead コマンド" +.El +.Pp +write ルーチンを使うのは SMB_WRITEW ioctl と等価です。 +.Pp +.Sh 関連項目 +.Xr smbus 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/smbus.4 b/ja_JP.eucJP/man/man4/smbus.4 new file mode 100644 index 0000000000..bfe98776c3 --- /dev/null +++ b/ja_JP.eucJP/man/man4/smbus.4 @@ -0,0 +1,85 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.\" jpman %Id: smbus.4,v 1.3 1999/09/11 08:15:39 horikawa Stab % +.Dd August 10, 1998 +.Dt SMBBUS 4 +.Os FreeBSD +.Sh 名称 +.Nm smbus +.Nd +システム管理バス +.Sh 書式 +.Cd "controller smbus" +.Pp +.Cd "device iicsmb0 at iicbus?" +.Cd "device bktr0" +.Sh 解説 +様々な SMB デバイスを制御し +種々の SMB コントローラ (I2C, PIIX4, Brooktree848, vm86...) +を利用するドライバを実装するため、 +.Em smbus +システムは、 +単一形態で、モジュール化された、 +アーキテクチャに依存しないシステムを提供します。 +.Sh システム管理バス +.Em システム管理バス +は 2 本のワイヤからなるインタフェースであり、 +単純な電源関連のチップが +システムの残りの部分と通信できるようにするためのものです。 +これはバックボーンとして I2C を使っています ( +.Xr iicbus 4 +参照)。 + +SMB を使ったシステムはデバイスの個々の制御ラインを見ていくのではなく、 +デバイスとメッセージのやりとりをします。 + +SMBus を使うことにより、 +デバイスは、製造業者の情報を提供すること、 +システムに対してそのモデルや部品番号を伝えること、 +サスペンドイベントのために状態を保存すること、 +様々なタイプのエラーを報告すること、 +制御パラメータを受け付けること、 +ステータスを返すことが可能となります。 + +適切な電気的ブリッジが内部の SMB デバイスと外部の ACCESS +バスデバイスの間に提供されていれば、 +SMBus は、 +ACCESS バスのコンポーネントとして +同じホストデバイスと物理バスを共有できます。 +.Sh 関連項目 +.Xr iicbus 4 , +.Xr iicsmb 4 , +.Xr bktr 4 , +.Xr smb 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/smp.4 b/ja_JP.eucJP/man/man4/smp.4 new file mode 100644 index 0000000000..3f7e0543af --- /dev/null +++ b/ja_JP.eucJP/man/man4/smp.4 @@ -0,0 +1,55 @@ +.\" Copyright (c) 1997 +.\" Steve Passe . All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the developer may NOT be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE 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. +.Dd August 4, 1997 +.\" jpman %Id: smp.4,v 1.3 1999/12/27 00:44:58 mitchy Stab % +.Dt SMP 4 +.Os FreeBSD 3.0 +.Sh 名称 +.Nm SMP +.Nd FreeBSD 対称型マルチプロセッサカーネルの説明 +.Sh 書式 +.Nm SMP +.Sh 解説 +.Nm +カーネルは対称型マルチプロセッサのサポートを実装しています。 + +.Sh 互換性 +.Nm +カーネルはインテルの MP 仕様 バージョン 1.4 に準拠したマザーボードをサポートしています。 + +.Sh バグ +きっとそうでしょう… + +.Sh 関連項目 +.Xr mptable 1 , +.Xr dmesg 8 + +.Sh 歴史 +.Nm +カーネルの初期の歴史は (ちゃんと) 記録されていません。 +1997 年 4 月 26 日までは別の CVS ブランチで開発されており、 +その時点で 3.0-current にマージされました。 +この日までには Lite2 のカーネルコードは 3.0-current へマージされていました。 + +.Sh 作者 +.An Steve Passe Aq fsmp@FreeBSD.org diff --git a/ja_JP.eucJP/man/man4/snp.4 b/ja_JP.eucJP/man/man4/snp.4 new file mode 100644 index 0000000000..694eb53934 --- /dev/null +++ b/ja_JP.eucJP/man/man4/snp.4 @@ -0,0 +1,69 @@ +.\" +.\" %Id: snp.4,v 1.14 1998/03/12 07:30:18 charnier Exp % +.\" jpman %Id: snp.4,v 1.3 2000/01/03 03:14:18 horikawa Stab % +.\" +.Dd February 24, 1995 +.Dt SNP 4 +.Os FreeBSD +.Sh 名称 +.Nm snp +.Nd tty 端末を覗き見るインタフェース +.Sh 書式 +.Fd #include +.Ft int +.Fn ioctl fd SNPSTTY &dev +.Ft int +.Fn ioctl fd SNPGTTY &dev +.Ft int +.Fn ioctl fd FIONREAD &result +.Sh 解説 +/dev/snp? はユーザが任意の tty 端末に接続してその端末での活動を監視することを +可能にする検査用のデバイスです。 + +所定の +.Nm snp +デバイスと監視すべき tty とを結合するには、 +.Nm snp +デバイスをオープンしてから SNPSTTY ioctl システムコールを発行してください。 +IOCTL システムコールに渡される引数は dev_t 型の変数のアドレスです。 +引数の値に -1 へのポインタを指定することにより、 +snp デバイスを tty から切り離すことが出来ます。 +.Pp +SNPGTTY ioctl システムコールはオープンされている +.Nm snp +デバイスにその時点で結合されている tty に関する情報を返します。 +.Pp +FIONREAD ioctl システムコールは読込みバッファに格納されている文字数 +に等しい正の数を返します。 +定義されている特別の値は以下の通りです: +.Bl -tag -width SNP_TTYCLOSE +.It Dv SNP_OFLOW +デバイスオーバフローが発生して、デバイスは切り離されました。 +.It Dv SNP_TTYCLOSE +tty は結合されていません。 +.It Dv SNP_DETACH +ユーザが +.Nm snp +デバイスを切り離したか又は tty デバイスがクローズされて切り離されました。 +.Sh 関連項目 +.Xr pty 4 , +.Xr sio 4 , +.Xr watch 8 +.Sh 制限項目 +スーパユーザだけが +.Nm snp +デバイスにアクセスできます。 +.Sh バグ +行処理モードである間は、ユーザの入力は見えません。 +監視している tty へは、シグナルを送れません。 +.Sh 作者 +.An Ugen J.S. Antsilevich Aq ugen@NetVision.net.il +.Sh 歴史 +.Nm snp +デバイスは +.Fx 2.1 +で初めて現れました。 +.\" Translated by Tetsuro Furuya (古谷 哲郎) , Dec. 1999. +.\" ML Checked by Tetsuya Isaki (井崎哲也) +.\" ML Checked by MORI Kouji (森 浩二) +.\" Final Checked by Kazuo Horikawa (堀川和雄) diff --git a/ja_JP.eucJP/man/man4/spkr.4 b/ja_JP.eucJP/man/man4/spkr.4 new file mode 100644 index 0000000000..9650f2401c --- /dev/null +++ b/ja_JP.eucJP/man/man4/spkr.4 @@ -0,0 +1,234 @@ +.\" +.\" %Id: spkr.4,v 1.10 1998/03/12 07:30:38 charnier Exp % +.\" jpman %Id: spkr.4,v 1.3 1999/08/15 14:20:39 horikawa Stab % +.\" +.Dd November 7, 1993 +.Dt SPKR 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm speaker , +.Nm spkr +.Nd コンソールスピーカのデバイスドライバ +.Sh 書式 +.Cd pseudo-device speaker +.Fd #include +.Sh 解説 +スピーカデバイスドライバは、 +.Tn FreeBSD +が走っている +.Tn IBM-PC +互換 PC 上で、 +アプリケーションがコンソールスピーカを制御できるようにします。 +.Pp +いかなるときでも、このデバイスをオープンできるのは +ただ 1 つのプロセスだけです。 +このため、このデバイスのロックと解放には、 +.Xr open 2 +と +.Xr close 2 +を使用します。 +他のプロセスがデバイスを独占している時にオープンしようとすると、 +.Er EBUSY +エラーを示して -1 を返します。 +デバイスへの書き込みは、 ASCII 文字で単純にメロディを表記した +演奏文字列 (`play string') として解釈されます。 +.Xr ioctl 2 +リクエストによる任意の周波数の発音もサポートされています。 +.Pp +発音することでプロセッサを独占することはありません。 +実際には、ドライバは PC ハードウェアが音を発している間の +ほとんどの時間をスリープして待っています。 +他のプロセスはドライバが走っている間にビープを鳴らすことができます。 +.Pp +アプリケーションは、スピーカのファイル記述子に対して +.Xr ioctl 2 +呼び出しをすることにより、スピーカドライバを直接制御可能です。 +.Xr ioctl 2 +インタフェースについての定義は +.Pa /usr/include/machine/speaker.h +にあります。 +これらの呼び出しに使われる +.Li tone_t +構造体には、 +周波数 (ヘルツ) と持続時間 (1/100 秒単位で) を指定する +2 つのフィールドがあります。 +周波数 0 は、休符と解釈されます。 +.Pp +現在そのような +.Xr ioctl 2 +呼び出しは 2 つあります。 +.Dv SPKRTONE +は、第 3 引数に単一の tone 構造体へのポインタ 1 個を受け取り、 +それを演奏します。 +.Dv SPKRTUNE +は、単一の tone 構造体配列の先頭へのポインタ 1 個を受け取り、 +それらを順番に演奏します。 +この配列は末尾が持続時間 0 のメンバで終っていることが必要です。 +.Pp +演奏文字列の語法は +.Tn IBM +Advanced BASIC 2.0 の PLAY 文の習慣を模倣しています。 +PLAY 文の +.Li MB , +.Li MF , +.Li X +要素は時分割環境では役に立たないため除かれます。 +`オクターブ追従' 機能とスラー記号は新しく追加されたものです。 +.Pp + 7 オクターブ 84 音が使用可能で 1-84 の番号がついています。 +.\" 原文では 1-83 となっている。 send-pr 済み。 +それぞれのオクターブは C から B まで続いていて 0-6 の番号がついています。 +音階は A440 に合わせて調律されていて、オクターブ 3 は真中の C から始まります。 +デフォルトでは演奏機能は半秒の音符を発音し、そのうち最後の 1/16 秒は休みます。 +.Pp +演奏文字列は左から右へと、演奏コマンドグループの連続として解釈されます。 +大文字小文字は区別されません。演奏コマンドグループは次の通りです: +.Bl -tag -width CDEFGABxx +.It Li CDEFGAB +A から G までの文字は対応する音を現在のオクターブで鳴らします。 +音符文字にはオプションで、 # + - のうちいずれかひとつの +.Dq Em "臨時記号" +を続けることができます。このうち最初の 2 つは音を半音高くし、 +最後のものは音を半音低くします。 +また音符文字の後には音長を表す数字と付点記号 (後述) をつけることもできます。 +音長は次の L コマンドの場合と同様に解釈されます。 +.It Ns Li O Sy n +もし +.Sy n +が数字なら、以後のオクターブを設定します。 +.Sy n +に +.Li L +または +.Li N +のいずれかを指定することにより、 +オクターブ追従を有効または無効にすることができます +(デフォルトでは無効です)。 +オクターブ追従が有効になっている時は、1 組の音符を解釈すると、 +音符間での音程の差が最小になるように必要に応じてオクターブが変化します。 +したがって、 ``olbc'' は ``olb>c'' のように、 +``olcb'' は ``olc と < と O[0123456] に続く、1 音符については無効です。 +(オクターブ追従機能は +.Tn IBM +BASIC ではサポートされていません。) +.It Li > +現在のオクターブを 1 つ上げます。 +.It Li < +現在のオクターブを 1 つ下げます。 +.It Ns Li N Sy n +音符 +.Sy n +を演奏します。 +.Sy n +は 1 から 84 か、現在の音長の休符として 0 です。 +付点記号を続けることもできます。 +.It Ns Li L Sy n +音符の音長を設定します。デフォルトは +.Li L4 +で、四分音符です。 +この値は 1 から 64 までが認められます。 +.Li L1 +は全音符に、 +.Li L2 +は二分音符に、 +.Li L4 +は四分音符に、などと設定されます。 +.It Ns Li P Sy n +.Sy n +を +.Ns Li L Sy n +と同様に解釈した休符です。付点記号をつけることもできます。 +.Li ~ +と書くこともできます。 +.It Ns Li T Sy n +1 分あたりの四分音符の数を設定します。デフォルトは 120 です。 +よくあるテンポの音楽名: + +.Bd -literal -offset indent + テンポ 分あたり拍数 +とても遅い Larghissimo + Largo 40-60 + Larghetto 60-66 + Grave + Lento + Adagio 66-76 +遅い Adagietto + Andante 76-108 +中くらい Andantino + Moderato 108-120 +速い Allegretto + Allegro 120-168 + Vivace + Veloce + Presto 168-208 +とても速い Prestissimo +.Ed +.It Li M[LNS] +調音を設定します。 +.Li MN +.Ns No ( Li N +は普通 (normal) を示します) がデフォルトで、音符の最後 1/8 を休みます。 +レガート (休みなし) にするには +.Li ML +を、スタッカート (1/4 休む) にするには +.Li MS +を設定できます。 +.El +.Pp +音符 (つまり +.Li CDEFGAB +または +.Li N +コマンド文字グループ) には付点記号 (.) を続けることができます。 +.\" dot とは . であるが日本語では明示しないとわからない +それぞれの付点記号は 1 つにつき、音符の音長を 1.5 倍にします。 +したがって、付点記号が 1 つついた音符はついていないものの 3/2 の音長に、 +2 つついた音符は 9/4 の音長に、 +3 つついた音符は 27/8 の音長になります。 +.Pp +音符と付点記号にはスラー記号 (_) を続けることができます。 +これによって音符の後に普段ある小さな休みが埋められて、 +音符を次の音符にスラーでつなげます。(スラー機能は +.Tn IBM +BASIC ではサポートされていません。) +.Pp +演奏文字列中の空白は単に飛ばされるので、 +楽節を分けるのに使うことができます。 +.Sh バグ +音程テーブルの丸めや、発音ハードウェアやタイマハードウェアの +こぼれ (どちらも精度を考慮していない) のため、 +音程の正確さやタイミングは数学的に厳密ではありません。 +音量調節はありません。 +.Pp +2 つ以上の付点記号の動作は標準的な音楽記号を反映していません。 +標準的には、それぞれの付点記号は前の付点の半分だけ音長を長くするのであり、 +付点によって修正された音符の半分ではありません。 +つまり、付点記号が 1 つついた音符はついていないものの 3/2 の音長に、 +2 つついた音符は 7/4 の音長に、 +3 つついた音符は 15/8 の音長になります。 +それでも、3/2 倍にする解釈は +.Tn IBM +BASIC マニュアルに記されているため、 +互換性のためにそのままにしています。 +.Pp +非常に長い (システムの物理 I/O ブロックよりも長い) 演奏文字列では、 +ブロック境界をまたがるために、 +音符の修飾や数値が時々間違って解釈されることがあります。 +.Sh 関連ファイル +.Bl -tag -width /dev/speakerxx +.It Pa /dev/speaker +スピーカデバイスファイル +.El +.Sh 関連項目 +.Xr spkrtest 8 +.Sh 作者 +.An Eric S. Raymond Aq esr@snark.thyrsus.com +1990 年 6 月 +.Sh 移植者 +.An Andrew A. Chernov Aq ache@astral.msk.su +.Sh 歴史 +.Nm +デバイスは +.Fx 1.0 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/splash.4 b/ja_JP.eucJP/man/man4/splash.4 new file mode 100644 index 0000000000..a79aa3a213 --- /dev/null +++ b/ja_JP.eucJP/man/man4/splash.4 @@ -0,0 +1,261 @@ +.\" +.\" Copyright (c) 1999 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: splash.4,v 1.1.2.2 1999/02/10 14:49:52 yokota Exp % +.\" jpman %Id: splash.4,v 1.3 1999/09/26 12:24:44 horikawa Stab % +.\" +.\" WORD: splash screen 起動画面 +.\" WORD: welcome banner +.\" WORD: color depth 色数 +.\" +.Dd February 9, 1999 +.Dt SPLASH 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm splash +.Nd +起動画面 (splash screen) とスクリーンセーバのインタフェース +.Sh 書式 +.Cd "pseudo-device splash" +.Sh 解説 +.Nm +疑似デバイスドライバは、カーネルに +起動画面とスクリーンセーバのサポートを加えます。 +このドライバは起動画面のビットマップイメージを読み込みたい時や、 +スクリーンセーバを使いたい時に必要です。 +.Sh 起動画面 (SPLASH SCREEN) +システムが起動しようとしている時に、任意のビットマップイメージを +画面上に表示できます。 +この画像はカーネルの初期化プロセスの間じゅう画面に表示され、 +``Login'' プロンプトが画面に現れるか、 +スクリーンセーバが読み込まれて初期化されるまで残ります。 +また、この画像はキーを打つと消えますが、 +カーネルがまだデバイスを検出している間は +すぐには消えないかもしれません。 +.Pp +もしカーネルを読み込む際に +.Fl c +ないし +.Fl v +ブートオプションを指定すると、起動画面の画像は表示されません。 +ただしそれでも画像は読み込まれていて、後でスクリーンセーバとして使えます。 +下記を参照してください。 +.Pp +ビットマップを表示するためには、ビットマップファイルと、 +それに対応した起動画面イメージ復号モジュールが +ブートローダによって読み込まれていることが必要です。 +現在、以下の復号モジュールが利用可能です: +.Pp +.Bl -tag -width splash_decoder -compact +.It Pa splash_bmp.ko +W*ndows BMP ファイル復号器。 +BMP ファイルフォーマットにはさまざまな色数のものがありますが、 +この復号器は現在のところ 256 色のビットマップのみを扱えます。 +それ以外の色数のビットマップは表示できません。 +.El +.Pp +.Sx 使用例 +の節で起動画面の設定法を詳しく説明しています。 +.Pp +VGA の標準的なビデオモードを使う場合には +ビットマップのサイズは 320x200 以下であることが必要です。 +VESA モジュールを静的にリンクするか +もしくは VESA モジュールを読み込むかして、 +カーネルの VESA モードサポートを有効にしているのなら +.Pq Xr vga 4 参照 +、VESA BIOS とビデオカード上のビデオメモリの量にもよりますが、 +最大で 1024x768 の解像度のビットマップを読み込むことができます。 +.Sh スクリーンセーバ +.\" 原文 will activate は will be activated ？ +スクリーンセーバはシステムがアイドル状態だと考えられる時に起動されます。 +アイドル状態とは、 +指定した時間の間、ユーザがキーを打たず、マウスも動かさなかった時です。 +スクリーンセーバは選択可能なモジュールですので、 +明示的にメモリに読み込まれている必要があります。 +現在、以下のスクリーンセーバモジュールが利用可能です: +.Pp +.Bl -tag -width splash_module.ko -compact +.It Pa blank_saver.ko +これは単に画面を空白にするだけです。 +.It Pa daemon_saver.ko +BSD デーモンのアニメーション。 +.It Pa fade_saver.ko +画面が徐々に消えてゆきます。 +.It Pa green_saver.ko +モニタが省電力モードを備えていれば、電源を切ります。 +.It Pa logo_saver.ko +グラフィックによる BSD デーモンのアニメーション。 +.It Pa rain_saver.ko +画面に夕立を描きます。 +.It Pa snake_saver.ko +文字列でできた蛇を描きます。 +.It Pa star_saver.ko +星が瞬きます。 +.It Pa warp_saver.ko +星が素早く流れます。 +.El +.Pp +スクリーンセーバモジュールは +.Xr kldload 1 +を使って読み込みます: +.\" ここに余計な空行が入ってしまう +.Pp +.Dl kldload logo_saver +.Pp +以下のようにしてタイムアウトの秒数を指定できます: +.Pp +.Dl vidcontrol -t N +.Pp +また +.Pa /etc/rc.conf +ファイルの +.Ar saver +変数をあなたの選んだスクリーンセーバに設定し +タイムアウトを +.Ar blanktime +変数に設定できます。これによりシステム起動時に、 +自動的にスクリーンセーバを読み込み、タイムアウトを設定できます。 +.Pp +.Ar saver +キーを押すことで +スクリーンセーバを直ちに起動できます。 +デフォルトは AT 拡張キーボードでは +.Em Shift-Pause +、AT 84 キーボードでは +.Em Shift-Ctrl-NumLock/Pause +です。 +キーマップ +.Pq Xr kbdcontrol 1 、 Xr keymap 5 参照 +を書き換えて +.Ar saver +機能をお好みのキーに割り当てることで、 +.Ar saver +キーを変更できます。 +.Pp +画面がテキストモードでない時にはスクリーンセーバは機能しません。 +.Sh 起動画面をスクリーンセーバとして使う +起動画面の画像を読み込んでいてスクリーンセーバを読み込んでいない場合、 +起動画面の画像をスクリーンセーバとして使い続けることができます。 +画面を切替えるまでの間隔は、上の +.Sx スクリーンセーバ +の節にあるやりかたで指定できます。 +.\".Sh DRIVER CONFIGURATION +.Sh 関連ファイル +.Bl -tag -width /modules/splash_xxxx.ko -compact +.It /boot/loader.rc +ブートローダが読み込むスクリプト +.It /etc/rc.conf +システムの設定情報 +.It /modules/splash_*.ko +起動画面イメージ復号モジュール +.It /modules/*_saver.ko +スクリーンセーバモジュール +.It /modules/vesa.ko +VESA サポートモジュール +.El +.Sh 使用例 +起動画面やスクリーンセーバを読み込むためには、 +カーネル設定ファイルに以下の行があることが必要です。 +.Pp +.Dl pseudo-device splash +.Pp +以下の例は、ブートローダのプロンプトから起動画面の画像を +読み込む方法を示しています。 +これらはプロンプトのところで手で打っても良いですし、 +ブートローダのスクリプト +.Pa /boot/loader.rc +.Pq Xr loader.rc 5 参照 +に書いてもかまいません。 +.Bd -literal -offset indent +load kernel +load -t splash_image_data chuck.bmp +load splash_bmp +.Ed +.Pp +2 行目で起動画面に使うビットマップイメージファイルを読み込みます。 +上の例では、ファイル +.Pa chuck.bmp +が読み込まれます。 +この行に +.Fl t Ar splash_image_data +というオプションを含めることが非常に重要です。 +起動画面イメージ復号モジュールは、 +既に読み込まれているはずのビットマップデータを探す時に +このタグ名を探すからです。 +3 行目で起動画面イメージ復号モジュール +.Pa splash_bmp +を読み込んでいます。 +.Pp +以下の例では、VESA モジュールを読み込んでいるので、 +標準の VGA モードでは表示できないビットマップファイルも、 +VESA ビデオモードを使って表示されるはずです。 +.Bd -literal -offset indent +load kernel +load vesa +load -t splash_image_data chuck.bmp +load splash_bmp +.Ed +.Pp +もし VESA サポートがカーネルに静的にリンクされているなら、 +VESA モジュールを読み込む必要はありません。 +上の最初の例のように、ただビットマップファイルと +起動画面イメージ復号モジュールを読み込むだけで良いです。 +.\".Sh DIAGNOSTICS +.Sh 警告 +起動画面もスクリーンセーバも、コンソールドライバとして +.Xr syscons 4 +を用いる場合にのみ有効です。 +もうひとつのコンソールドライバ +.Xr pcvt 4 +では利用できません。 +.Sh バグ +スクリーンセーバが既に読み込まれている時に +他のスクリーンセーバを読み込んだ場合、 +最初のスクリーンセーバは自動的には取り除かれずにメモリに残り、 +カーネルのメモリを無駄に消費します。 +.Sh 関連項目 +.Xr vidcontrol 1 , +.Xr syscons 4 , +.Xr vga 4 , +.Xr rc.conf 5 , +.Xr kldload 8 , +.Xr kldunload 8 +.Sh 歴史 +.Nm +ドライバは +.Fx 3.1 +に初めて登場しました。 +.Sh 作者 +.Nm +ドライバとこのマニュアルページは +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。 +.Pa splash_bmp +モジュールは +.An Michael Smith Aq msmith@FreeBSD.org +と +.An Kazutaka Yokota +が書きました。 diff --git a/ja_JP.eucJP/man/man4/sr.4 b/ja_JP.eucJP/man/man4/sr.4 new file mode 100644 index 0000000000..d2d885505c --- /dev/null +++ b/ja_JP.eucJP/man/man4/sr.4 @@ -0,0 +1,119 @@ +.\" +.\" Copyright (c) 1996 John Hay. 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 John Hay. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY John Hay ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL John Hay BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: sr.4,v 1.10 1998/10/22 14:12:55 bde Exp % +.\" +.\" jpman %Id: sr.4,v 1.3 2000/08/27 09:00:10 koich Stab % +.Dd July 4, 1996 +.Dt SR 4 i386 +.Os +.Sh 名称 +.Nm sr +.Nd 同期 RISCom/N2 / WANic 400/405 デバイスドライバ +.Sh 書式 +.Cd "device sr0 at isa? port 0x300 net irq 10 iomem 0xd0000" +.Cd "device sr1 at isa? port 0x310 net irq 11 flags 0x1 iomem 0xd0000" +.Pp +.Cd "pseudo-device sppp" +.Sh 解説 +.Nm sr +ドライバは、HD64570 チップを使用した、 +RISCom/N2 ISA カードと WANic 400/405 PCI カードをサポートします。 +.Pp +リンクレベルの層に、標準の +.Tn FreeBSD +sppp コードを使用します。 +デフォルトのプロトコルは PPP です。 +Cisco HDLC プロトコルは +.Xr ifconfig 8 +に +.Em link2 +を追加することによって使用できます。 +.Pp +.Em flags +フィールドは省略可能です。省略した場合、ドライバは次のように仮定します: +.Pp +.Bl -hang -offset indent +.It "カードには 2 ポートあります。" +.It "シリアルポートのクロックは外部のものを使用しており、" +送信と受信のクロックは同じです。 +.El +.Pp +.Em flags +はビットフィールドであり、デフォルト以外の動作をさせるために使用します。 +.Pp +.Bl -hang -offset indent +.It Em 0x01 +カードには 1 ポートだけあります。 +.It Em 0x10 +ポート 0 で、送信と受信で別々の外部クロックを使用します。 +.It Em 0x40 +ポート 1 で、送信と受信で別々の外部クロックを使用します。 +.El +.Pp +.Sh 番号 +カーネル設定ファイルでは、カード毎に 1 行のみが必要です。 +最初のカードのポートは sr0 から振られます。 +次のカードの番号は、最初のカードの終った所から続けられます。 +つまり、もし最初のカードが 2 ポートのカードなら、そのカードは sr0 と sr1 +を使います。そして次のカードは sr2 から始まります。 +.Pp +カードは IRQ 3, 4, 5, 7, 10, 11, 12, 15 のみをサポートします。 +.Pp +iomem 領域は、16Kb ブロックであり、16Kb 境界から始まる必要があります。 +.Pp +.Sh 診断 +.Bl -diag +.It "sr%d: Warning illegal interrupt %d." +カードが指定された割り込みを使用できません。他の割り込みを選んでください。 +.El +.Sh 関連ファイル +.Bl -tag -width /sys/i386/isa/ic/hd64570.h -compact +.It Pa /sys/i386/isa/ic/hd64570.h +.It Pa /sys/i386/isa/if_srregs.h +.It Pa /sys/i386/isa/if_sr.c +.It Pa /sys/pci/if_sr_p.c +.El +.Sh バグ +現時点で X.21 インタフェースだけを試験しています。 +他のものでは、クロック選択コードを微調整する必要があるでしょう。 +.Pp +このコードには、おそらく最適化の余地があります。 +.Sh 関連項目 +.Xr ar 4 , +.Xr cx 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr lsdev 8 +.Sh 作者 +.Nm sr +デバイスドライバは +.An John Hay Aq jhay@FreeBSD.org +が作成しました。 diff --git a/ja_JP.eucJP/man/man4/ssc.4 b/ja_JP.eucJP/man/man4/ssc.4 new file mode 100644 index 0000000000..0a56ef9e56 --- /dev/null +++ b/ja_JP.eucJP/man/man4/ssc.4 @@ -0,0 +1,104 @@ +.\" %Id: ssc.4,v 1.2 1998/08/31 16:41:07 wosch Exp % +.\" jpman %Id: ssc.4,v 1.3 2000/08/10 13:48:27 horikawa Stab % +.\" +.\" Copyright (c) 1997 Brian Somers +.\" 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. +.\" +.Dd December 29, 1997 +.Dt SSC 4 +.Os FreeBSD +.Sh 名称 +.Nm ssc +.Nd `スーパ SCSI' ドライバ +.Sh 書式 +.Cd "pseudo-device ssc" +.Sh 解説 +.Nm +ドライバは、以前に SCSI デバイスが 1 つも検出されなかった場合に使用される +アクセスポイントを、SCSI ドライバのコード内部に提供します。これは、外部 +SCSI デバイスしか持っていないシステムにとっては便利なものです。こうした +SCSI デバイスはブート時に電源が切れているかもしれないからです。 +.Pp +.Sq scsi user +、すなわち +.Xr su 4 +疑似デバイスが +.Nm ssc +には使われるため、su デバイスも設定していなくてはなりません。 +.Sh カーネルの設定 +ssc 疑似デバイスには、設定パラメータはありません。 +.Pp +.Sh IOCTL +.Nm +ドライバは、ただ 1 つ自分自身の +.Dv SCIOCADDR +を持っています。この ioctl は、 +.Pa /dev/ssc +をオープンした後に使用しなくてはなりません。また、この ioctl よりも前に +他の ioctl コールを発行してはいけません: +.Bd -literal -offset indent +.Fd #include + +.Ft int +.Fn ioctl "int fd" "SCIOCADDR" "struct scsi_addr *data" +.Ed +.Pp +.Ar fd +は、 +.Xr open 2 +が返す識別子を表し、 +.Ar data +は要求に合わせて設定された +.Ar scbus , +.Ar target , +.Ar lun +フィールドを持っていなくてはなりません。この ioctl は、次に呼ばれる ioctl が +影響を与えるデバイスを任意に変更するために使用できます。 +.Pp +その他の ioctl はすべて直接 +.Xr su 4 +疑似デバイスドライバに渡されます。その際、最新の +.Dv SCIOCADDR +ioctl コールで設定された Bus, Target, Lun フィールドを使用します。 +.Sh 関連ファイル +.Bl -tag -width /dev/ssc -compact +.It Pa /dev/ssc +.Sq スーパ SCSI +ドライバをアクセスするのに使われるデバイスファイルです。 +.El +.Sh 診断 +.Dv SCIOCADDR +ioctl を発行するよりも前に別の ioctl を発行しようとすると、 +.Dv ENXIO +が返されます。そうでない場合は、該当の ioctl は直接 +.Xr su 4 +ドライバに送られます。 +.Sh 関連項目 +.Xr open 2 , +.Xr su 4 , +.Xr scsi 8 +.Sh 歴史 +.Nm +は、最初に FreeBSD 2.0.5 で登場しました。 diff --git a/ja_JP.eucJP/man/man4/st.4 b/ja_JP.eucJP/man/man4/st.4 new file mode 100644 index 0000000000..3c1b2b3006 --- /dev/null +++ b/ja_JP.eucJP/man/man4/st.4 @@ -0,0 +1,41 @@ +.\" 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: st.4,v 1.12 1998/10/16 04:06:21 ken Exp % +.\" jpman %Id: st.4,v 1.3 1999/09/26 13:27:40 horikawa Stab % +.\" +.Dd October 15, 1998 +.Dt ST 4 +.Os FreeBSD +.Sh 名称 +.Nm st +.Nd SCSI テープドライバ +.Sh 解説 +.Nm st +ドライバは +.Xr sa 4 +ドライバによって置き換えられました。 +.Sh 関連項目 +.Xr sa 4 diff --git a/ja_JP.eucJP/man/man4/stl.4 b/ja_JP.eucJP/man/man4/stl.4 new file mode 100644 index 0000000000..20786c75b6 --- /dev/null +++ b/ja_JP.eucJP/man/man4/stl.4 @@ -0,0 +1,321 @@ +.\" Copyright (c) 1996 Greg Ungerer (gerg@stallion.oz.au). +.\" 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 Greg Ungerer. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd December 2, 1996 +.\" jpman %Id: stl.4,v 1.3 2000/09/02 16:45:09 yt-kage Stab % +.Os FreeBSD +.Dt STL 4 i386 +.Sh 名称 +.Nm stl , +.Nm stli +.Nd "Stallion Technologies 社製のマルチポートシリアルコントローラ用のドライバ" +.Sh 書式 +.Cd "stl0 at isa? port tty irq " +.Cd "stli0 at isa? port tty iomem iosiz flags " +.Cd "stli0 at eisa? port tty iomem iosiz flags " +.Sh 解説 +これは、Stallion Technologies 社製のマルチポートシリアルコントローラ用の +カーネルドライバです。 +ドライバは 2 種類あり、それぞれ異なる種類のボードに対応しています。 +.Nm stl +ドライバは EasyIO ボードと EasyConnection 8/32 ボードに対応しており、 +.Nm stli +ドライバは他の全ての種類のボードに対応しています。これには +ONboard, Brumby, EasyConnection 8/64 が含まれます。 +.Sh 設定 +システムにインストールされているそれぞれのボードについて、 +カーネルの設定ファイルにエントリが必要です。 +ボードの種類が異なると、それぞれに対して必要なオプションやパラメータも +少しずつ異なります。 +ボードの種類によって、 +.Nm stl +ドライバか +.Nm stli +ドライバのいずれかが使われます。 +.Nm stl +ドライバと +.Nm stli +ドライバは 8 枚までのボードに対応できます。 +.Pp +ハードウェアの設定 (ディップスイッチ、ジャンパ等) はボードごとに +異なります。 +ハードウェアの細かい設定については、ボードに付属している文書を +ご覧ください。 +あるいは、Stallion Technologies 社の WWW サイト (http://www.stallion.com) +からもボードに関する文書を入手できます。 +.Pp +EasyIO 系と EasyConnection 8/32 系のボードでは +.Nm stl +ドライバを使います。 +.Nm stl +ドライバ用の ISA ボード設定エントリは、一般的に以下の形式です: +.Pp +.Cd "stlX at isa? port tty irq " +.Pp +.Ar X +はボードに割り当てられているユニット番号です。 +0 から 7 までの任意のユニークな番号が有効です。 +.Pp +ボードが使用する I/O アドレスは +.Ar +で指定します。 +EasyIO ボードと EasyConnection 8/32-AT ボードはそれぞれ 0 から 0x400 +の範囲の I/O アドレスを使用できます。 +.Pp +全ての EasyIO ボードと EasyConnection 8/32 ボードは割り込みを必要とし、 +この割り込みは +.Ar +で指定します。 +ISA ボードで有効な IRQ 値は 3, 4, 5, 7, 10, 11, 12, 15 です。 +EasyIO-8M を除く全てのボードでは、割り込みはソフトウェア的に +プログラムされています。 +.Pp +EasyConnection 8/32-AT ボードはセカンダリの I/O アドレス領域も使います。 +このアドレス値は、ドライバのコード内で 0x280 に決め打ちされています。 +全ての EasyConnection 8/32-AT ボードは同じセカンダリ I/O アドレス領域 +を共有できます。 +.Pp +EasyConnection 8/32 PCI ボードは、起動時にシステムが自動的に検出します。 +これらのボードに対しては、設定情報を予め与えておく必要はありません。 +起動中には、 +.Nm stl +ドライバは EasyConnection 8/32 PCI ボードを検出したことと、このカード +に関するいくつかの情報を示すメッセージを出力します。 +.Pp +以下では、 +.Nm stl +ドライバがサポートしている ISA ボードのそれぞれに対する設定エントリの +例をいくつか示します。 +それぞれの設定例においては、各種類のボードに関する重要な詳細情報も +いくつか述べます。 +.Pp +それぞれの EasyIO ボードは 8 バイトの I/O アドレス空間と 1 つの IRQ 線 +を必要とします。 +EasyIO ボード用の設定エントリは以下のようになるでしょう: +.Pp +.Cd "stl0 at isa? port 0x2a8 tty irq 15" +.Pp +このエントリは、I/O アドレスが 0x2a8 にあり、IRQ 15 を使っている +EasyIO ボードを指定します。 +I/O アドレスと IRQ 値は必要に応じて変更できます。 +.Pp +それぞれの EasyConnection 8/32-AT ボードは 2 組の I/O アドレスと +1 つの IRQ 線を必要とします。 +プライマリの I/O アドレス領域は、大きさが 2 バイトで、かつシステム上に +あるそれぞれの EasyConnection 8/32-AT ボードについてユニークでなければ +なりません。 +セカンダリの I/O アドレス領域は、大きさは 32 バイトですが、複数の +EasyConnection 8/32-AT ボードで共有できます。 +このセカンダリの I/O アドレスは、ドライバのコード中で 0x280 に +設定されています。 +設定エントリは以下のようになります: +.Pp +.Cd "stl0 at isa? port 0x2a0 irq 10 tty" +.Pp +この設定は、プライマリの I/O アドレスが 0x2a0, セカンダリの I/O アドレス +が 0x280, IRQ が 10 である EasyConnection 8/32-AT を指定します。 +.Pp +ONboard, Brumby, EasyConnection 8/64 系のボードでは +.Nm stli +ドライバを使います。 +.Nm stli +ドライバはこれらの系列のカードの ISA 版と EISA 版に対応しています。 +.Pp +.Nm stli +ドライバ用の ISA ボード設定エントリは、一般的に以下の形式となります: +.Pp +.Cd "stliX at isa? port tty iomem iosiz flags " +.Pp +.Ar X +はボードに割り当てられたユニット番号です。 +0 から 7 までの任意のユニークな番号が有効です。 +.Pp +ボードが使う I/O アドレスは +.Ar +で指定します。 +サポートされているボードであっても、有効な I/O アドレスの制限は +ボードの種類ごとにそれぞれ異なり、必要とされる I/O 空間の大きさも +異なります。 +.Pp +.Nm stli +を用いる全てのボードは、操作できる共有メモリ領域を必要とします。 +ボードの種類によって、必要な領域の大きさは 4k バイトから 64k バイトま +で変わります。ボードの領域の大きさは設定エントリの +.Ar +フィールドで指定し、この領域のアドレスは +.Ar +フィールドで指定します。 +.Pp +flags フィールドは、このエントリが適用される特定のボードを指定します。 +ドライバは必ずしも全ての種類のボードを実行時に識別するわけではないので、 +ドライバはこのフィールドを必要とします。 +有効なボードの種類を以下に示します: +.Bd -literal -offset indent +ボード名 種類 I/O サイズ + +Brumby 2 0x4000 +ONboard 4 0x10000 +ONboard/E 7 0x10000 +EasyConnection 8/64-AT 23 0x1000 +EasyConnection 8/64-EISA 24 0x10000 +.Ed +.Pp +.Nm stli +ドライバがサポートしているそれぞれのボードについて、設定例を以下にいく +つか示します。それぞれの設定例では、各種類のボードに関する重要 +な詳細情報もいくつか述べます。 +.Pp +EasyConnection 8/64-AT ボードは、4 バイトの I/O アドレス空間と +4k バイトのメモリ空間を必要とします。 +設定エントリは以下のようになります: +.Pp +.Cd "stli0 at isa? port 0x2a0 tty iomem 0xcc000 iosiz 0x1000 flags 23" +.Pp +このエントリの flags フィールドでは、これが EasyConnection 8/64-AT ボード +であることを指定しています。 +I/O アドレスは 0x2a0 に設定され、メモリアドレスは 0xcc000 に設定されます。 +.Ar iosiz +パラメータは、メモリ領域のサイズとして 4k バイトを指定しています。 +.Pp +EasyConnection 8/64-EISA ボードは、メモリ空間に 64k バイトの領域を +必要とします。 +この領域は 32 ビットメモリアドレス空間のどこに置いても構いません。 +設定エントリは以下のようになります: +.Pp +.Cd "stli0 at eisa? port 0x2000 tty iomem 0x80000000 iosiz 0x10000 flags 24" +.Pp +flags フィールドは、これが EasyConnection 8/64-EISA ボードであることを +示すために用います。 +I/O (ポート) アドレス資源は、ボードが挿さっている EISA スロットから得ま +す。 +各 EISA スロットには、システムのハードウェアから I/O アドレス空間の +一部が割り当てられます。 +このアドレスは 0xX0000 となります(X はスロット番号)。 +例で取り上げているボードはメモリアドレス 0x80000000 にあります。これは +2G バイトを表します。 +.Ar iosiz +パラメータはメモリ領域の大きさを指定します。この例では 64k バイトです。 +.Pp +それぞれの ONboard ISA ボードは 16 バイトの I/O 空間と、 +メモリアドレス空間上の64k バイトの領域を必要とします。 +ONboard の有効な I/O アドレスは 0x200 から 0x300 の範囲内です。 +ONboard ISA の設定エントリは以下のようになります: +.Pp +.Cd "stli0 at isa? port 0x240 tty iomem 0xd0000 iosiz 0x10000 flags 4" +.Pp +このエントリでは、flags を 4 に設定することによって ONboard ISA を指定 +しています。 +このエントリでは I/O アドレス 0x240 と、メモリアドレス 0xd0000 の 64k +バイトの領域を使っています。 +.Pp +各 ONboard/E ボードは 64k バイトのメモリ領域を必要とし、これは +32 ビットアドレス空間 (0 から 4G バイトまで) 上のどこでも構いません。 +設定エントリは以下のようになります: +.Pp +.Cd "stli0 at eisa? port 0x3000 tty iomem 0xc0000000 iosiz 0x10000 flags 7" +.Pp +.\" 'example' が抜けてません? +この例は、0xc0000000 (3G バイト) を共有メモリアドレスに使い、 +スロット 3 にある ONboard/E を指定しています。 +.Pp +Brumby ボードは 1 枚につき 16 バイトの I/O アドレス空間と +共有メモリ空間の 4k バイトの領域を必要とします。 +Brumby の有効な I/O アドレスの範囲は 0x300 から 0x400 までです。 +Brumby の共有メモリ領域は、メモリアドレス空間の 0xc0000 から +0xdc000 の領域でなければなりません。 +Brumby の設定エントリは以下のようになるでしょう: +.Pp +.Cd "stli0 at isa? port 0x360 tty iomem 0xc8000 iosiz 0x4000 flags 2" +.Pp +このエントリは、I/O アドレス 0x360 にあり、アドレス 0xc8000 にある +共有メモリ領域を使っている Brumby ボードを指定しています。 +.Sh 注 +ポートに対するデバイスノードを作成する際には、正しいデバイス名である +.Nm stl +または +.Nm stli +を必ず使ってください。 +それぞれのドライバには別のメジャー番号が割り当てられています。 +したがって、たとえポートのデバイス名がそれぞれのドライバについて +同じであっても、デバイスノードのメジャー番号は異なります。 +デバイスを作成するには +.Xr MAKEDEV 8 +スクリプトを使ってください。 +.Nm stl +ドライバに対しては ttyE と cue タグを使い、 +.Nm stli +ドライバに対しては ttyEi と cuei タグを使ってください。 +.Pp +インテリジェントなタイプのボード(ONboard, Brumby, EasyConnection 8/64) +は、ファームウェアをダウンロードしなければポートが操作可能になりません。 +これは +.Nm stlload +コマンドを使って行うことができます。 +詳しい使い方についてはマニュアルページを参照してください。 +.Sh 関連ファイル +.Bl -tag -width "/dev/staliomem?" -compact +.It Pa /dev/ttyE? +標準の着呼デバイス +.It Pa /dev/ttyiE? +初期状態の着呼デバイス +.It Pa /dev/ttylE? +ロック状態の着呼デバイス +.It Pa /dev/cue? +標準の発呼デバイス +.It Pa /dev/cuie? +初期状態の発呼デバイス +.It Pa /dev/cule? +ロック状態の発呼デバイス +.It Pa /dev/staliomem? +ボード制御デバイス +.El +.sp +ポート番号はボード 0 のポート 0 の 0 から始まる点に注意してください。 +それぞれのボードには 64 個のポートスロットが割り当てられています。 +したがって、2 番目のボードのポート番号は 64 から 127 までです。 +デバイスを作成するには +.Xr MAKEDEV 8 +スクリプトを使ってください。 +.Nm stl +ドライバに対しては ttyE と cue タグを使い、 +.Nm stli +ドライバに対しては ttyEi と cuei タグを使ってください。 +.Sh 関連項目 +.Xr stty 1 , +.Xr termios 4 , +.Xr tty 4 , +.Xr comcontrol 8 , +.Xr MAKEDEV 8 , +.Xr stlload 8 , +.Xr stlstats 8 +.Sh 歴史 +このドライバを最初に開発したのは +.An Greg Ungerer Aq gerg@stallion.com +です。 diff --git a/ja_JP.eucJP/man/man4/su.4 b/ja_JP.eucJP/man/man4/su.4 new file mode 100644 index 0000000000..9ae892da44 --- /dev/null +++ b/ja_JP.eucJP/man/man4/su.4 @@ -0,0 +1,82 @@ +.\" %Id: su.4,v 1.11 1997/12/29 21:07:49 brian Exp % +.\" 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 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. +.\" +.\" jpman %Id: su.4,v 1.3 1999/10/06 10:52:01 horikawa Stab % +.\" WORD: address 指定する +.\" WORD: location 位置 +.\" WORD: medium 仲介 +.Dd August 27, 1993 +.Dt SU 4 +.Os FreeBSD +.Sh 名称 +.Nm su +.Nd scsi ユーザレベルドライバ +.Sh 書式 +.Cd "pseudo-device su" +.Sh 解説 +.Nm su +ドライバは、scsi バス上の任意の位置を指定するためのサポートを、 +プロセスに対して提供します、 +マイナ番号は bus:target:lun と一対一に対応しています。 +最下位の 3 ビットは lun で、次の 3 ビットは target です。 +残りのビットは bus 番号です。 +.Pp +SCSI アダプタは、このドライバが有効になる前に、 +別にシステムに組み込まれていることが必要です。 +.Pp +.Sh カーネルの設定 +su のオプションには設定パラメータはありません。 +あっても無視されます。 +.Pp +.Sh IOCTL +.Nm +ドライバはそれ自身の ioctl 機能はありません、しかし、一般的な +.Xr scsi 4 +ioctl の仲介として機能します。 +これらは、 +.Em sys/scsiio.h +で述べられています。 +.Sh 関連ファイル +.Bl -tag -width /dev/su0-0-0XXXXXXXXXXX -compact +.It Pa /dev/su[0-9]-[0-7]-[0-7] +su{x}-{y}-{z} は bus x, target y, lun z のデバイスの su デバイスです。 +.El +.Sh 診断 +すべての +.Xr scsi 4 +のデバッグ ioctl は +.Nm +デバイスで動作します。 +.Sh 関連項目 +.Xr cd 4 , +.Xr scsi 4 , +.Xr sd 4 , +.Xr ssc 4 , +.Xr st 4 , +.Xr uk 4 +.Sh 歴史 +.Nm +ドライバは 386BSD 0.1 で登場しました。 diff --git a/ja_JP.eucJP/man/man4/sysmouse.4 b/ja_JP.eucJP/man/man4/sysmouse.4 new file mode 100644 index 0000000000..f7df536aed --- /dev/null +++ b/ja_JP.eucJP/man/man4/sysmouse.4 @@ -0,0 +1,456 @@ +.\" Copyright (c) 1997 +.\" John-Mark Gurney. 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. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY John-Mark Gurney AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: sysmouse.4,v 1.7 1998/03/12 07:30:38 charnier Exp % +.\" jpman %Id: sysmouse.4,v 1.3 1999/08/15 14:18:48 horikawa Stab % +.\" +.\" word: movement (マウスの)動き[sysmouse.4] +.\" +.Dd December 3, 1997 +.Dt SYSMOUSE 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm sysmouse +.Nd 仮想化されたマウスドライバ +.Sh 書式 +.Fd #include +.Fd #include +.Sh 解説 +マウスデーモン +.Xr moused 8 +と一緒に使うことにより、コンソールドライバは、 +.Nm +ドライバを通して、ユーザプロセスに標準的な方法でマウスのデータを提供します。 +このように整理することで、 +.Po +.Tn X\ Window System +などのような +.Pc +ユーザプロセスとコンソールとでマウスを共有することができるようになります。 +.Pp +ユーザプロセスがマウス機能を利用しようとする場合、単に +.Xr open 2 +システムコールで +.Pa /dev/sysmouse +をオープンし、 +.Xr read 2 +システムコールを用いてマウスデータを読み込むだけでよいです。 +ここで、確実に +.Xr moused 8 +を実行しておいて下さい。さもないと、ユーザプロセスはマウスからデータを +一切受け取ることができないでしょう。 +.Pp +.Ss 機能レベル +.Nm +ドライバには 2 つの機能レベルがあります。現在の機能レベルは ioctl +システムコールにより参照、変更することができます。 +.Pp +レベル 0 は最も低いレベルで、基本的なレベルでもあります。このレベルでは、 +ドライバは、ユーザプログラムに対して基本的なサービスを提供します。 +.Nm +ドライバは、マウスの水平垂直の動きと、最大で 3 個までのボタンの状態を、 +以下に示す +.Tn MouseSystems +形式で通知します。 +.Pp +.Bl -tag -width Byte_1 -compact +.It Byte 1 +.Bl -tag -width bit_7 -compact +.It bit 7 +常に 1 です。 +.It bit 6..3 +常に 0 です。 +.It bit 2 +左ボタンの状態です。押し下げられている状態でビットクリア、そうでなければ +ビットセットです。 +.It bit 1 +中ボタンの状態です。押し下げられている状態でビットクリア、そうでなければ +ビットセット。中ボタンを持たない機器の場合は常に 1 です。 +.It bit 0 +右ボタンの状態です。押し下げられている状態でビットクリア、そうでなければ +ビットセットです。 +.El +.It Byte 2 +水平の動きのカウントを 2 の補数形式で表した値の先頭半分です。 +-128 から 127 までの値。 +.It Byte 3 +垂直の動きのカウントを 2 の補数形式で表した値の先頭半分です。 +-128 から 127 までの値。 +.It Byte 4 +水平の動きのカウントを 2 の補数形式で表した値の後ろ半分です。 +-128 から 127 までの値。水平の動きのカウントを得るには、 +byte 2 と byte 4 を足して下さい。 +.It Byte 5 +垂直の動きのカウントを 2 の補数形式で表した値の後ろ半分です。 +-128 から 127 までの値。垂直の動きのカウントを得るには、 +byte 3 と byte 5 を足して下さい。 +.El +.Pp +レベル 1 は拡張レベルで、マウスのデータは +.Xr mouse 4 +で定義された標準形式 +.Dv MOUSE_PROTO_SYSMOUSE +でコード化されます。 +.\" .Ss Acceleration +.\" The +.\" .Nm +.\" driver can somewhat `accelerate' the movement of the pointing device. +.\" The faster you move the device, the further the pointer +.\" travels on the screen. +.\" The driver has an internal variable which governs the effect of +.\" the acceleration. Its value can be modified via the driver flag +.\" or via an ioctl call. +.Sh IOCTL +この節では、2 種類の +.Xr ioctl 2 +コマンドについて説明します。 +1 つは、 +.Nm +ドライバそれ自体に対するコマンドで、もう 1 つは、コンソールと +コンソール制御ドライバに対するコマンドです。 +.Ss Sysmouse Ioctl +マウスドライバに対するコマンドがいくつかあります。このコマンド一般の説明は、 +.Xr mouse 4 +にあります。 +以下では、 +.Nm +ドライバ固有の機能を説明します。 +.Pp +.Bl -tag -width MOUSE -compact +.It Dv MOUSE_GETLEVEL Ar int *level +.It Dv MOUSE_SETLEVEL Ar int *level +これらのコマンドは、マウスドライバの機能レベルを操作します。 +.Pp +.It Dv MOUSE_GETHWINFO Ar mousehw_t *hw +以下の構造体で、接続された機器のハードウエア情報を返します。現在の +バージョンの +.Nm +ドライバでは、 +.Dv iftype +フィールドだけが正しい値が詰まっていることが保証されています。 +.Bd -literal +typedef struct mousehw { + int buttons; /* ボタンの数 */ + int iftype; /* I/F タイプ */ + int type; /* マウス/トラックボール/パッド... */ + int model; /* I/F 依存のモデル ID */ + int hwid; /* I/F 依存のハードウェア ID */ +} mousehw_t; +.Ed +.Pp +.Dv buttons +フィールドには、ドライバが検出したボタンの数が保持されています。 +.Pp +.Dv iftype +は常に +.Dv MOUSE_IF_SYSMOUSE +です。 +.Pp +.Dv type +は機器の型: +.Dv MOUSE_MOUSE , +.Dv MOUSE_TRACKBALL , +.Dv MOUSE_STICK , +.Dv MOUSE_PAD , +.Dv MOUSE_UNKNOWN +を表します。 +.Pp +.Dv model +は、機能レベル 0 では常に +.Dv MOUSE_MODEL_GENERIC +です。 +これは、より高いレベルでは、 +.Dv MOUSE_MODEL_GENERIC +または、 +.Dv MOUSE_MODEL_XXX +のうちの 1 つになります。 +.Pp +.Dv hwid +は常に 0 です。 +.Pp +.It Dv MOUSE_GETMODE Ar mousemode_t *mode +このコマンドは、マウスドライバの現在の機能パラメータを返します。 +.Bd -literal +typedef struct mousemode { + int protocol; /* MOUSE_PROTO_XXX */ + int rate; /* 通知レート (秒単位) */ + int resolution; /* MOUSE_RES_XXX, 不明の場合は -1 */ + int accelfactor; /* 加速率 */ + int level; /* ドライバの機能レベル */ + int packetsize; /* データパケットの長さ */ + unsigned char syncmask[2]; /* 同期ビット */ +} mousemode_t; +.Ed +.Pp +.Dv protocol +フィールドは、ユーザプログラムがマウスデータを読みとる時に、 +その機器の状態を返す形式を表します。 +機能レベル 0 では、 +.Dv MOUSE_PROTO_MSC +であり、機能レベル 1 では、 +.Dv MOUSE_PROTO_SYSMOUSE +です。 +.Pp +.Dv rate +フィールドは、常に -1 です。 +.Pp +.Dv resolution +フィールドは、常に -1 です。 +.Pp +.Dv accelfactor +フィールドは、常に 0 です。 +.Pp +.Dv packetsize +フィールドは、データパケットの長さを表します。これは機能レベルに +よって変わります。 +.Pp +.Bl -tag -width level_0__ -compact +.It Em レベル 0 +5 バイト +.It Em レベル 1 +8 バイト +.El +.Pp +配列 +.Dv syncmask +は、データパケットの先頭バイトを検出するための、ビットマスクとパターンを +保持します。 +.Dv syncmask[0] +はビットマスクで、調べるバイトと AND を取ります。この結果が +.Dv syncmask[1] +と等しい場合、そのバイトはデータパケットの先頭バイトらしいと言えます。 +この方法で先頭バイトを検出するやり方は 100% 確実とは言えません。 +よって、これは参考扱いにするべきと注意をしておきます。 +.Pp +.It Dv MOUSE_SETMODE Ar mousemode_t *mode +このコマンドは、マウスドライバの現在の機能パラメータを +.Ar mode +で指定した値に変更します。 +.Dv level +だけが変更可能です。他のフィールドに値を設定してもエラーは出ませんが、 +何の効果も及ぼしません。 +.\" .Pp +.\" .It Dv MOUSE_GETVARS Ar mousevar_t *vars +.\" .It Dv MOUSE_SETVARS Ar mousevar_t *vars +.\" These commands are not supported by the +.\" .Nm +.\" driver. +.Pp +.It Dv MOUSE_READDATA Ar mousedata_t *data +.It Dv MOUSE_READSTATE Ar mousedata_t *state +これらのコマンドは +.Nm +ドライバではサポートされません。 +.Pp +.It Dv MOUSE_GETSTATE Ar mousestatus_t *status +このコマンドはボタンの現在の状態と動きのカウントを +.Xr mouse 4 +で定義された構造体で返します。 +.El +.Ss コンソールとコンソール制御 Ioctl +ユーザプログラムは、現在の仮想コンソールに対してコンソール +.Fn ioctl +システムコールを発行し、マウスポインタを制御します。コンソール +.Fn ioctl +はまた、ボタンが押された時に +.Xr signal 3 +を受け取る手段をユーザプロセスに提供します。 +.Pp +マウスデーモン +.Xr moused 8 +は、 +コンソール制御デバイス +.Pa /dev/consolectl +に対して +.Fn ioctl +システムコールを用いることにより、 +マウスの動きとボタンの状態を含むマウスの動作をコンソールに通知します。 +.Pp +両方のクラスの +.Fn ioctl +コマンドとも、以下の引数を取る +.Dv CONS_MOUSECTL +として定義されています。 +.Bd -literal +struct mouse_info { + int operation; + union { + struct mouse_data data; + struct mouse_mode mode; + struct mouse_event event; + } u; +}; +.Ed +.Pp +.Bl -tag -width operation -compact +.It Dv operation +これは以下のどれか 1 つを取ります。 +.Pp +.Bl -tag -width MOUSE_MOVEABS -compact +.It Dv MOUSE_SHOW +マウスカーソルを有効にして表示します。 +.It Dv MOUSE_HIDE +マウスカーソルを無効にして隠します。 +.It Dv MOUSE_MOVEABS +マウスカーソルを +.Dv u.data +で与えた位置に移動させます。 +.It Dv MOUSE_MOVEREL +現在の位置に、 +.Dv u.data +で与えた値を加えた位置に移動させます。 +.It Dv MOUSE_GETINFO +現在の仮想コンソールにおけるマウスの現在の位置と、ボタンの状態を +.Dv u.data +に収めて返します。 +.It Dv MOUSE_MODE +これは、 +.Xr signal 3 +を設定し、現在のプロセスにボタンが押されたことを通知します。 +シグナルは +.Dv u.mode +に収められて通知されます。 +.El +.Pp +ここまでの機能は仮想コンソールに対するものです。これ以後に定義する機能は +コンソール制御ドライバに対するもので、 +.Xr moused 8 +がマウスデータをコンソールドライバに渡すために用います。 +.Pp +.Bl -tag -width MOUSE_MOVEABS -compact +.It Dv MOUSE_ACTION +.It Dv MOUSE_MOTIONEVENT +これらの機能は +.Dv u.data +に情報を取り、その上で動作します。 +.Nm +ドライバがオープンされている場合、マウスデータは +.Nm +ドライバに送られます。 +.Dv MOUSE_ACTION +はボタン押し下げ動作を一緒に行ない、要求がある場合はシグナルを送ります。 +現在のコンソールがテキストインタフェースを持つ場合、カットアンドペースト +処理を行ないます。 +.It Dv MOUSE_BUTTONEVENT +.Dv u.data +で、ボタンの種類とそのクリックカウント数を指定します。コンソールドライバは +その情報を用い、要求がある場合はシグナルを送り、コンソールが +テキストインタフェースを持つ場合は、カットアンドペースト処理を行ないます。 +.El +.Pp +.Dv MOUSE_MOTIONEVENT +と +.Dv MOUSE_BUTTONEVENT +は、新しいインタフェースで、この 2 つを一緒に使うことを想定して +作られています。これらは +.Dv MOUSE_ACTION +ひとつで行なわれている機能を置き換えるためのものです。 +.Pp +.It Dv u +この共用体は、以下のいずれかです。 +.Pp +.Bl -tag -width data -compact +.It Dv data +.Bd -literal +struct mouse_data { + int x; + int y; + int z; + int buttons; +}; +.Ed +.Pp +.Dv x , +.Dv y , +.Dv z +は、それぞれの方向に対するマウスの移動を表します。 +.Dv buttons +はボタンの状態を示します。ビット 0 からビット 30 までで最大 31 個の +ボタンの状態を表すことができます。ボタンが押されていると、対応する +ビットがセットされます。 +.Pp +.It Dv mode +.Bd -literal +struct mouse_mode { + int mode; + int signal; +}; +.Ed +.Pp +.Dv signal +フィールドは、プロセスに送るシグナルを指定します。この値は +.Ao Pa signal.h Ac +で定義された値のうちのひとつである必要があります。 +.Dv mode +フィールドは現在は使用されていません。 +.Pp +.It Dv event +.Bd -literal +struct mouse_event { + int id; + int value; +}; +.Ed +.Pp +.Dv id +フィールドは、 +.Dv u.data.buttons +と同じように、ボタン番号を指定します。 +1 ビット/ボタンだけを設定できます。 +.Dv value +フィールドは、クリック数を保持しています。これは、ユーザがボタンを +連続して押した回数です。 +.Pp +.El +.El +.Sh 関連ファイル +.Bl -tag -width /dev/consolectl -compact +.It Pa /dev/consolectl +コンソールを制御するデバイス +.It Pa /dev/sysmouse +仮想化されたマウスドライバ +.It Pa /dev/ttyv%d +仮想コンソール +.El +.Sh 関連項目 +.Xr vidcontrol 1 , +.Xr ioctl 2 , +.Xr signal 3 , +.Xr mouse 4 , +.Xr moused 8 +.Sh 歴史 +.Nm +マニュアルページは、 +.Fx 2.2 +で初めて現れました。 +.Sh 作者 +このマニュアルは +.An John-Mark Gurney Aq gurney_j@efn.org +と +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。 +.\" translated by Norihiro Kumagai kuma@nk.rim.or.jp 99-7-18 diff --git a/ja_JP.eucJP/man/man4/tcp.4 b/ja_JP.eucJP/man/man4/tcp.4 new file mode 100644 index 0000000000..936a980b71 --- /dev/null +++ b/ja_JP.eucJP/man/man4/tcp.4 @@ -0,0 +1,279 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)tcp.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: tcp.4,v 1.3 1999/11/01 16:08:37 yt-kage Stab % +.\" %Id: tcp.4,v 1.9 1997/03/19 19:47:40 bde Exp % +.\" +.\" WORD: boolean option ブールオプション +.Dd February 14, 1995 +.Dt TCP 4 +.Os BSD 4.2 +.Sh 名称 +.Nm tcp +.Nd インターネットトランスミッションコントロールプロトコル +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket AF_INET SOCK_STREAM 0 +.Sh 解説 +.Tn TCP +プロトコルは信頼性のある、フロー制御された、 +全二重のデータ転送を提供します。 +本プロトコルは +.Dv SOCK_STREAM +として抽象化された機能をサポートするものとして使用される、 +バイトストリーム型のプロトコルです。 +TCP は標準のインターネットアドレスフォーマットを使用し、 +加えてホスト毎の +.Dq ポートアドレス +の集合も使用します。 +従って各アドレスは、ホスト及びネットワークを特定する +インターネットアドレスと、 +ホスト上のピアエンティティを識別する特定 +.Tn TCP +ポートから構成されます。 +.Pp +tcp プロトコルを利用しているソケットは +.Dq 能動型 +および +.Dq 受動型 +の 2 種類があります。 +能動型のソケットは、受動型のソケットに対しコネクションを開始します。 +デフォルトでは +.Tn TCP +ソケットは能動型のものが作成されます。 +受動型ソケットを作成するには、 +.Xr bind 2 +システムコールでソケットをバインドした後、 +.Xr listen 2 +システムコールを使う必要があります。 +受動型ソケットのみが、 +.Xr accept 2 +コールを使用して、入力されるコネクション要求を受け付ける +ことができます。 +また、能動型ソケットのみが、 +.Xr connect 2 +コールを使用してコネクションを開始することができます。 +.Tn TCP +はさらに、トランザクション +.Tn TCP +と呼ばれるデータグラムの様なモードもサポートしています。 +本件に関しては +.Xr ttcp 4 +で述べられています。 +.Pp +受動型ソケットは +複数のネットワークから来るコネクション要求に対処するために、 +その位置を +.Dq 明確に指定しない +ことができます。 +この技術は +.Dq ワイルドカードアドレッシング +と呼ばれ、 +単一のサーバが複数のネットワーク上のクライアントに +サービスを提供することができます。 +全ネットワークからのコネクション要求に応答するソケットを +作成するには、 +インターネットアドレス +.Dv INADDR_ANY +をバインドする必要があります。 +この時点でも、 +.Tn TCP +ポートを指定できます。 +もしポートが指定されていない場合はシステムがポートを割り当てます。 +コネクションが一度確立されると、 +ソケットのアドレスはピアエンティティの場所により固定されます。 +ソケットが割り当てられたアドレスは、 +ネットワークインタフェースと +結び付けられており、このネットワークインタフェースを通して +パケットが送受信されます。 +普通、このアドレスはピアエンティティのネットワークと一致します。 +.Pp +.Tn TCP +はソケットのオプションをいくつかサポートしており、それらは +.Xr setsockopt 2 +により設定できます。また、 +.Xr getsockopt 2 +によりオプションの設定を調べることができます: +.Bl -tag -width TCP_NODELAYx +.It Dv TCP_NODELAY +大抵の状況下において、 +.Tn TCP +はデータが現れるとそれを送信します。 +確認応答されていないデータが残っている場合は、 +確認応答が受信された時すぐに一つのパケットで送信するために +少量の出力データを集めておきます。 +応答を受け取らないマウスイベントのストリームを送信する +ウィンドウシステムのような +少数のクライアントにとっては、 +このパケット化は重大な遅延の原因となります。 +ブールオプション +.Dv TCP_NODELAY +によりこのアルゴリズムを無効にすることができます。 +.It Dv TCP_MAXSEG +デフォルトでは、送信側及び受信側の TCP 間の各コネクションで +各々最大セグメントサイズの取り決めを行います。 +.Dv TCP_MAXSEG +オプションにより +この取り決めの結果をユーザが決定することができ、 +また要求があればその値を減らすことができます。 +.It Dv TCP_NOOPT +.Tn TCP +は普通、 +本実装において提供される様々な +.Tn TCP +拡張機能に従って、 +各パケット中でいくつかオプションを送信します。 +ブールオプション +.Dv TCP_NOOPT +は各コネクションで使用される +.Tn TCP +オプションを無効化するために提供されています。 +.It Dv TCP_NOPUSH +慣例により、送信側の TCP は +.Dq push +ビットをセットし、(もし許可されていれば) +.Xr write 2 +または +.Xr writev 2 +が呼ばれる度に即座に送信します。 +.Dv TCP_NOPUSH +オプションは +トランザクション TCP ( +.Xr ttcp 4 +を参照) +をサーバが簡単に利用するために提供されています。 +本オプションが 0 以外の値にセットされると、 +.Tn TCP +はソケットがクローズされるか内部の送信バッファがいっぱいになるまで、 +あらゆるデータの送信を遅らせます。 +.El +.Pp +.Xr setsockopt 2 +コールにおけるオプションレベルは +.Tn TCP +のプロトコルナンバであり、 +.Xr getprotobyname 3 +あるいは +.Dv IPPROTO_TCP +から得ることができます。 +オプションは、すべて +.Aq Pa netinet/tcp.h +で定義されています。 +.Pp +.Tn IP +トランスポートレベルでのオプションは +.Tn TCP +で使用可能です。本件は +.Xr ip 4 +を参照してください。 +ソースルートの入力コネクション要求が記載されており、 +また逆向きのソースルートが応答で使用されます。 +.Sh MIB の変数 +.Nm +プロトコルは、 +.Xr sysctl 3 +MIB の +.Li net.inet +ブランチで 3 つの変数を実装しています。 +.Bl -tag -width TCPCTL_DO_RFC1644 +.It Dv TCPCTL_DO_RFC1323 +.Pq tcp.rfc1323 +RFC 1323 のウィンドウスケーリング及び +タイムスタンプのオプションの実装 +(デフォルトは真)。 +.It Dv TCPCTL_DO_RFC1644 +.Pq tcp.rfc1644 +トランザクション +.Tn TCP +の実装。 +RFC 1644 で述べられています。 +.It Dv TCPCTL_MSSDFLT +.Pq tcp.mssdflt +最大セグメントサイズ +.Pq Dq MSS +のデフォルト値。 +MSS の取り決めの際に特に指示が無い場合に使用されます。 +.El +.Sh 診断 +ソケット操作の失敗の際には次のエラーのうちの一つが返されます: +.Bl -tag -width [EADDRNOTAVAIL] +.It Bq Er EISCONN +既にコネクションが確立されているソケットに対し +さらにコネクションを確立させようとした時 +.It Bq Er ENOBUFS +内部的なデータ構造のためのメモリが不足した時 +.It Bq Er ETIMEDOUT +過度の再送信によりコネクションが落ちた時 +.It Bq Er ECONNRESET +リモートピアが強制的にコネクションをクローズした時 +.It Bq Er ECONNREFUSED +リモートピアが意識的にコネクションの確立を拒否してきた時 +(大抵はそのポートを監視しているプロセスが無いためです) +.It Bq Er EADDRINUSE +既に割り当てられているポートに対しソケットを作成しようとした時 +.It Bq Er EADDRNOTAVAIL +対応したネットワークインタフェースが存在しない +ネットワークアドレスを指定し、ソケットを作成しようとした時 +.It Bq Er EAFNOSUPPORT +マルチキャストアドレスに対し +ソケットをバインドまたは接続しようとした時 +.El +.Sh 関連項目 +.Xr getsockopt 2 , +.Xr socket 2 , +.Xr sysctl 3 , +.Xr inet 4 , +.Xr intro 4 , +.Xr ip 4 , +.Xr ttcp 4 +.Rs +.%A V. Jacobson, R. Braden, and D. Borman +.%T "TCP Extensions for High Performance" +.%O RFC 1323 +.Re +.Rs +.%A R. Braden +.%T "T/TCP \- TCP Extensions for Transactions" +.%O RFC 1644 +.Re +.Sh 歴史 +.Nm +プロトコルは +.Bx 4.2 +から登場しました。 +ウィンドウスケーリング及びタイムスタンプに関する RFC 1323 の拡張機能は +.Bx 4.4 +で追加されました。 + diff --git a/ja_JP.eucJP/man/man4/tl.4 b/ja_JP.eucJP/man/man4/tl.4 new file mode 100644 index 0000000000..fe441dc803 --- /dev/null +++ b/ja_JP.eucJP/man/man4/tl.4 @@ -0,0 +1,137 @@ +\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: tl.4,v 1.2.2.1 1999/01/29 16:32:46 wpaul Exp % +.\" jpman %Id: tl.4,v 1.3 2000/01/03 03:14:23 horikawa Stab % +.\" +.Dd May 1, 1998 +.Dt TL 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm tl +.Nd +Texas Instruments ThunderLAN イーサネットデバイスドライバ +.Sh 書式 +.Cd "device tl0" +.Sh 解説 +.Nm +ドライバは Texas Instruments ThunderLAN イーサネット +コントローラチップを利用した +PCI イーサネットアダプタをサポートしています。 +このドライバは Compaq Prosignia サーバ、 +および Compaq Deskpro デスクトップ機のうち、 +いくつかのモデルに組込まれている +組み込み型イーサネットコントローラをはじめとする、 +数多くの Compaq PCI バスイーサネットアダプタに対応しています。 +加えて、このドライバは +Olicom OC-2135/2138 をはじめ、OC-2325, OC-2326 10/100 TX UTP アダプタ、 +Racore 8165 10/100baseTX, 8148 10baseT/100baseTX/100baseFX +など多数のカードをサポートしています。 +.Pp +ThunderLAN コントローラは、 +最高 32 個の物理的インタフェース装置 (PHY) を +サポートする標準の MII インタフェースを持ちます。 +また、MII アドレス 31 に結線されている内蔵型 10baseT PHY も持っています。 +このインタフェースは、 +10Mbps のみ利用するハードウェア構成で使用可能です。 +100Mbps 用の構成においては、 +National Semiconductor 社の DP83840A, 又は他社の MII 対応型 PHY が +ThunderLan の MII に接続されていることでしょう。 +DP83840A あるいは相当品が利用できる場合は、ThunderLan チップは +全二重または半二重による、10Mbps および 100Mbps の転送速度で機能します。 +ThunderLAN の内蔵 PHY および DP83840A は、 +オートネゴシエーションをサポートしています。 +.Pp +.Nm +ドライバは次に挙げるメディアタイプをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を有効にします。 +このオプションは、オートネゴシエーションをサポートした PHY が +附属している場合にのみ、利用可能であることに注意してください。 +また、後に挙げるメディアオプションの指定によって +明示的に無効化されたモードに関しては、PHY は通告しません。 +.It 10baseT/UTP +転送方式を 10Mbps に設定します。 +.It 100baseTX +転送方式を 100Mbps (ファーストイーサネット) に設定します。 +.It 10base5/AUI +AUI/BNC インタフェースを有効にします (組込み PHY がある場合のみ +利用できます)。 +.El +.Pp +.Nm +ドライバは次に挙げるメディアオプションをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +強制的に全二重に設定します。 +.It half-duplex +強制的に半二重に設定します。 +.It hw-loopback +ハードウェアループバックモードを有効にします。 +.El +.Pp +100baseTX メディアタイプは、PHY がサポートしている場合に限って +利用できることに注意してください。 +このデバイスの設定に関する、さらに詳しい情報については +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "tl%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "tl%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "tl%d: device timeout" +デバイスはネットワークに対する応答を停止しました。 +ネットワークへの接続 (ケーブル) に問題があります。 +.It "tl%d: no memory for rx list" +ドライバは、mbuf をレシーバリングに割り当てられませんでした。 +.It "tl%d: no memory for tx list" +パッドバッファを割り当てる際、 +あるいは mbuf チェーンをクラスタに詰め込む際に、 +ドライバは mbuf を送信リングに割り当てられませんでした。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.2 +で初めて登場しました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/ttcp.4 b/ja_JP.eucJP/man/man4/ttcp.4 new file mode 100644 index 0000000000..2d2125edbd --- /dev/null +++ b/ja_JP.eucJP/man/man4/ttcp.4 @@ -0,0 +1,250 @@ +.\" Copyright 1994, 1995 Massachusetts Institute of Technology +.\" +.\" Permission to use, copy, modify, and distribute this software and +.\" its documentation for any purpose and without fee is hereby +.\" granted, provided that both the above copyright notice and this +.\" permission notice appear in all copies, that both the above +.\" copyright notice and this permission notice appear in all +.\" supporting documentation, and that the name of M.I.T. not be used +.\" in advertising or publicity pertaining to distribution of the +.\" software without specific, written prior permission. M.I.T. makes +.\" no representations about the suitability of this software for any +.\" purpose. It is provided "as is" without express or implied +.\" warranty. +.\" +.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS +.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, +.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT +.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: ttcp.4,v 1.6 1997/03/19 19:47:42 bde Exp % +.\" jpman %Id: ttcp.4,v 1.4 2000/08/08 11:22:39 isaki Stab % +.\" +.Dd January 18, 1995 +.Dt TTCP 4 +.Os FreeBSD 2.1 +.Sh 名称 +.Nm ttcp +.Nd トランスミッションコントロールプロトコルのトランザクション拡張機能 +.Sh +.Fd #include +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn setsockopt sock IPPROTO_TCP TCP_NOPUSH &One "sizeof One" +.br +.Ft ssize_t +.Fn sendto sock msg len MSG_EOF &sin "sizeof sin" +.br +.Ft ssize_t +.Fn sendto sock msg len MSG_EOF 0 0 +.Sh 解説 +.Tn T/TCP +は +.Tn TCP +プロトコル +( +.Xr tcp 4 +を参照) +への拡張機能の集合です。 +本機能により少量のデータを 2 つのパケットの交換でやりとりすることができ、 +従って標準の +.Tn TCP +コネクションで本来発生する余分な往復による遅延を無くすことができます。 +ソケットインタフェースは +.Tn T/TCP +をサポートするように修正されており、 +またここでは明確なケースについて詳述しています。 +プロトコルに依存しない部分のサポートについては +.Xr socket 2 +及び +.Xr send 2 +のマニュアルページで述べられています。 +.Tn T/TCP +は RFC 1644 で定義されています。 +.Pp +.Tn T/TCP +特定のコネクションの全セグメントにおいて、あるオプションを +いくつか含めることにより、T/TCP 拡張は機能します。 +これにより一組のホスト間での最初の接続を除く全ての +3 ウェイハンドシェークを無くすことができます。 +さらに同じオプションを用いて、 +古い重複したパケットをより確実に判別することが可能であり、 +従って +.Tn TCP +プロトコルが接続を閉じた後、状態を保たなければならない +時間を減らすことができます。 +.Dq Li net.inet.tcp.rfc1644 +の MIB の変数は実行時に +.Tn T/TCP +ネゴシエーションを無効化するために使用することができます。 +しかしながら、本プロトコルは、T/TCP ではないシステムが +T/TCP 拡張されたシステムと通信しようとしたときに、 +自動的に標準の +.Tn TCP +に戻して通信することを保証するために設計されたものです。 +.Sh トランザクションモデル +.Tn T/TCP +で用いられる +.Dq トランザクション +のモデルはかなり単純なものです: +.Bl -enum +.It +クライアントプログラムはサーバに送信する要求を作成します。 +それは単一の +.Tn TCP +セグメントに収まるくらい十分小さなものです。 +そしてオプションとデータと共に +SYN PUSH FIN セグメントをサーバに送ります。 +.It +サーバプログラムは標準の +.Tn TCP +接続と同様に、要求を受け取り解読し、 +単一のセグメントに収まる大きさの応答を作成します。 +その要求が T/TCP の場合、 +応答は、(異なった) オプションとデータと共に +単一の SYN PUSH FIN ACK セグメントでクライアントに返されます。 +T/TCP ではない場合は、 +(ほぼ) 通常の +.Tn TCP +に戻された接続になります。 +サーバはこの時 T/TCP ソケットをクローズします。 +.It +クライアントは応答を読み込み、ソケットをクローズします。 +.El +.Sh クライアントサポート +クライアント側のサポートは、 +.Dq 暗黙の接続 +及び +.Dq 送信とシャットダウン +の概念を理解する様に +.Xr sendto 2 +及び +.Xr sendmsg 2 +システムコールの意味を拡張することにより提供されます。 +トランザクションによる要求を送信するには +.Xr sendto 2 +システムコールを通常使用し、次の例の様にします: +.Bd -literal -offset indent +char request[REQ_LEN]; +struct sockaddr_in sin; +int sock, req_len; + +sock = socket(PF_INET, SOCK_STREAM, 0); + +/* request[] と sin の準備 */ + +err = sendto(sock, request, req_len, MSG_EOF, + (struct sockaddr *)&sin, sin.sin_len); + +/* エラー処理 */ + +req_len = read(sock, request, sizeof request); +close(sock); + +/* 応答処理 */ + +.Ed +.Pp +.Fn sendto +を呼び出すと、その時のソケットの状態は +.Xr connect 2 +及び +.Xr shutdown 2 +システムコールが使われた時と +同じ状態になることに注意して下さい。 +つまり、このソケット上で実行するのに適した操作は、 +.Xr read 2 +および +.Xr close 2 +だけです +(クライアントの +.Tn TCP +送信部はすでにシャットダウンされているので、 +このソケットを他の送り先へ +.Xr connect 2 +することはできません)。 +.Sh サーバサポート +.Tn T/TCP +を使用する際にサーバで利用可能なオプションが +2 つあります: +.Bl -enum +.It +.Dv TCP_NOPUSH +ソケットオプションをセットし、 +標準の +.Xr write 2 +コールを使って応答を行って下さい。 +.It +クライアントの場合と同様に、 +.Xr sendto 2 +を +.Dv MSG_EOF +フラグと共に使用して下さい。 +ただし、送り先は指定しません。 +.El +.Pp +既存のサーバが +.Tn T/TCP +拡張機能を使用するように変更を行う際には、 +最初のオプションを用いるのは一般的に妥当な選択です。 +単純に +.Fn setsockopt sock IPPROTO_TCP TCP_NOPUSH &One "sizeof One" +(ここで +.Va One +は 0 以外の値の整数の変数です) へのコールを追加するだけだからです。 +何かデータが送信される前に +(ソケットのバッファが飽和していない限り) +サーバ側のソケットは閉じていなければなりません。 +.Pp +2 番目のオプションは、新しいサーバにはより望ましいものです。 +場合によっては、古いサーバにも適用できるくらい簡単です。 +この場合、応答段階で通常 +.Fn write +の呼び出しを含んでいますが、 +それを次のように置き換えます : +.Pp +.Dl "sendto(sock, buf, len, MSG_EOF, (struct sockaddr *)0, 0)" +.Pp +この場合、応答は直ちに送信されますが、クライアントの場合と同様に、 +ソケットはこの時点で何にも使用することは出来ません。 +直ちにクローズすべきです。 +.Sh MIB の変数 +.Tn T/TCP +拡張機能を利用するには、 +適切な +.Tn TCP +オプションを送信するように MIB 変数 +.Dq Li net.inet.tcp.rfc1644 +が真であることを必要とします。 +詳細は +.Xr tcp 4 +を参照して下さい。 +.Sh 関連項目 +.Xr send 2 , +.Xr setsockopt 2 , +.Xr inet 4 , +.Xr tcp 4 +.Rs +.%A R. Braden +.%T "T/TCP \- TCP Extensions for Transactions" +.%O RFC 1644 +.Re +.Sh 歴史 +.Tn T/TCP +のサポートは +.Fx 2.1 +で初めて行われました。 +それは The University of Southern California の +Information Sciences Institute の Bob Braden と Liming Wei +が書いたコードを基にしており、 +The University of Twente の Andras Olah が移植しました。 diff --git a/ja_JP.eucJP/man/man4/tty.4 b/ja_JP.eucJP/man/man4/tty.4 new file mode 100644 index 0000000000..e57543a349 --- /dev/null +++ b/ja_JP.eucJP/man/man4/tty.4 @@ -0,0 +1,429 @@ +.\" Copyright (c) 1991, 1992, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)tty.4 8.3 (Berkeley) 4/19/94 +.\" %Id: tty.4,v 1.7 1997/02/22 13:24:48 peter Exp % +.\" jpman %Id: tty.4,v 1.3 2000/07/26 07:33:41 yt-kage Stab % +.\" WORD: Carrier Detect (CD) キャリア検出 [tty.4] +.\" WORD: Clear To Send (CTS) 送信可 [tty.4] +.\" WORD: Data Set Ready (DSR) データセットレディ [tty.4] +.\" WORD: Data Terminal Ready (DTR) データ端末レディ [tty.4] +.\" WORD: Line Enable (LE) 回線利用可能 [tty.4] +.\" WORD: Request To Send (RTS) 送信要求 [tty.4] +.\" WORD: Ring Indication (RI) 被呼表示 [tty.4] +.\" WORD: Secondary Receive (SR) 従局受信 [tty.4] +.\" WORD: Secondary Transmit (ST) 従局送信 [tty.4] +.\" WORD: ioctl request ioctl リクエスト [tty.4] +.\" WORD: kernel console カーネルコンソール +.\" WORD: kernel message カーネルメッセージ +.\" WORD: line discipline 回線制御規則 [tty.4] +.\" WORD: out-calling modem 発信モデム +.\" WORD: pty 疑似端末 +.\" WORD: terminal semantics 端末セマンティクス [tty.4] +.\" WORD: terminal special file 端末型特殊ファイル +.\" WORD: termios state termios 状態 [tty.4] +.\" " +.Dd August 14, 1992 +.Dt TTY 4 +.Os BSD 4 +.Sh 名称 +.Nm tty +.Nd 一般的な端末へのインタフェース +.Sh 書式 +.Fd #include +.Sh 解説 +本セクションではシステムの端末ドライバへのインタフェースを解説します。 +.Ss 端末型特殊ファイル +システム上の各ハードウェア端末ポートは、通常 +ディレクトリ ``/dev/'' 内にある端末型特殊デバイスファイル +(例えば ``/dev/tty03'' など) に関連付けられます。 +ユーザがこうしたハードウェア端末ポートからシステムにログインしたときには、 +システムはすでに関連するデバイスをオープンしており、 +通常の対話的利用のために回線を準備しています ( +.Xr getty 8 +を参照)。 +一方、ハードウェア端末ポートにではなく、 +別のプログラムに接続する特別な端末型ファイルもあります。 +そういった特別な端末デバイスは +.Em 疑似端末 (pty) +と呼ばれ、ネットワーク越しに (例えば +.Xr rlogin 1 +や +.Xr telnet 1 +を利用して) ログインする際に、 +ログイン先のシステムに対して同様の +インタフェースをユーザに与えるのに必要な機構を提供します。 +そのような場合にも、 +端末型ファイルがどのようにオープンされ準備されたかといった細かな +ことは、 +システム内部の特別なソフトウェアがすでに処理してくれています。 +こういった具合に、ユーザは通常 +どのようにこれらの回線をオープンし利用するかといった細かなことに +気を回す必要はありません。 +また、これらの回線は (発信モデムを通して) +システムのダイヤルアウトにもよく使われますが、 +その場合にも、こうした端末型特殊ファイルへのアクセスの詳細を +隠してくれるプログラムをシステムが提供します ( +.Xr tip 1 +参照)。 +.Pp +ユーザが対話的にログインしたとき、システムはその回線をある様式 ( +.Em 回線制御規則 (line discipline) +と呼ばれます) に従う動作をするように準備します。 +回線制御規則の詳細は、コマンドレベルでは +.Xr stty 1 +に、プログラミングレベルでは +.Xr termios 4 +に解説がされています。 +ユーザは独自のログイン端末に関する設定を変更しようと思うかもしれません。 +そんなときは、先に挙げたほうのマニュアルページを +参照してよくある事例を調べるとよいでしょう。 +本マニュアルページの残りでは、端末デバイスを低レベルで使用したり +制御したりする際の詳細について解説します。おそらく、 +システムの提供する機能と似たものを提供しようとするプログラムでは +必要なことでしょう。 +.Ss 回線制御規則 +端末型ファイルは、 +標準システムコールを用いてオープン、読み込み、書き込みができるという +点でシステム中の他のファイルと同じように使用されます。 +存在する端末型ファイルそれぞれにつき、 +.Em 回線制御規則 +と呼ばれるソフトウェア処理モジュールが関連付けられます。 +.Em 回線制御規則 +は、本質的には、低レベルのデバイスドライバのコードと +高レベルの一般インタフェースルーチン ( +.Xr read 2 +や +.Xr write 2 +など) を結びつけ、 +そのデバイスについてのセマンティクスを実装する役目を持ちます。 +最初に端末型ファイルがプログラムからオープンされると、 +.Dv termios +回線制御規則と呼ばれるデフォルトの +.Em 回線制御規則 +がそのファイルに関連付けられます。 +これはほとんどの場合で利用される主要な回線制御規則であり、 +通常、ユーザが端末に関連付けるようなセマンティクスを提供します。 +.Dv termios +回線制御規則が有効になると、端末型ファイルは +.Xr termios 4 +で記述されている規則に従って動作し、操作されます。 +端末セマンティクスの完全な解説については +termios マニュアルページを参照してください。 +このマニュアルページで解説されている操作は、 +一般にすべての +.Em 回線制御規則 +に対して共通な機能を表しています。 +しかし、これらの中には +.Dv termios +以外の回線制御規則と一緒に使用しても意味の無い呼び出しや、 +ハードウェアでサポートされていない +(または、疑似端末の場合のように、ハードウェア自体を持たないため使用できない) +ものもあります。 +.Ss 端末型ファイルの操作 +次に挙げる操作はすべて +システムコール +.Xr ioctl 2 +を使って呼び出されます。 +パラメータ +.Em request +と +.Em argp +の説明については ioctl マニュアルページを参照してください。 +ここに定義されている ioctl +.Em リクエスト +に加え、有効となった回線制御規則によっては特有の +.Em リクエスト +を他に定義していることもあります (実際は、 +.Xr termios 4 +はそれらを ioctl +.Em リクエスト +ではなく関数呼び出しとして定義しています)。 +次のセクションでは利用可能な ioctl リクエストを列挙します。 +リクエスト名、その利用目的の説明、そして (パラメータを取る場合は) 型を示した +.Em argp +パラメータを記します。 +例えば、最初の項目では +.Pp +.D1 Em "TIOCSETD int *ldisc" +.Pp +という記述があります。これは、 +次のような部分コードを用いて +ファイル記述子 0 に関連付けられた端末上で呼び出されるでしょう。 +.Bd -literal + int ldisc; + + ldisc = TTYDISC; + ioctl(0, TIOCSETD, &ldisc); +.Ed +.Ss 端末型ファイル用リクエストの解説 +.Bl -tag -width TIOCGWINSZ +.It Dv TIOCSETD Fa int *ldisc +.Fa ldisc +が指す新しい回線規則に変更します。 +利用可能な回線制御規則は +.Pa Aq sys/ttycom.h +に列挙されています。現在は次のものが利用可能です: +.Pp +.Bl -tag -width TIOCGWINSZ -compact +.It TTYDISC +termios 対話的回線制御規則 +.It TABLDISC +タブレット回線制御規則 +.It SLIPDISC +シリアル IP 回線制御規則 +.It PPPDISC +PPP 回線制御規則 +.El +.Pp +.It Dv TIOCGETD Fa int *ldisc +.Fa ldisc +の指す整数に現在の回線制御規則を返します。 +.It Dv TIOCSBRK Fa void +端末ハードウェアをブレーク (BREAK) 条件に設定します。 +.It Dv TIOCCBRK Fa void +端末ハードウェアのブレーク条件をクリアします。 +.It Dv TIOCSDTR Fa void +データ端末レディ (DTR) を有効にします。 +.It Dv TIOCCDTR Fa void +データ端末レディ (DTR) をクリアします。 +.It Dv TIOCGPGRP Fa int *tpgrp +端末が関連付けられている現在のプロセスグループを +.Fa tpgrp +の指す整数に返します。これは +.Xr termios 4 +の +.Fn tcgetattr +呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCSPGRP Fa int *tpgrp +.Fa tpgrp +の指すプロセスグループ (整数) に端末を関連付けます。 +これは +.Xr termios 4 +の +.Fn tcsetattr +呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCGETA Fa struct termios *term +デバイスが関連付けられている現在の termios 状態を +.Fa term +の指す termios 構造体に代入します。 +これは +.Xr termios 4 +の +.Fn tcgetattr +呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCSETA Fa struct termios *term +デバイスに関連付けられている termios 状態を即座に設定します。 +これは +.Xr termios 4 +の +.Fn tcsetattr +に +.Dv TCSANOW +オプションを渡した場合の呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCSETAW Fa struct termios *term +まず出力がすべて完了するのを待ち、それからデバイスに関連付けられた +termios 状態を設定します。 +これは +.Xr termios 4 +の +.Fn tcsetattr +に +.Dv TCSADRAIN +オプションを渡した場合の呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCSETAF Fa struct termios *term +まず出力がすべて完了するのを待ち、保留されている入力をクリアし、 +それからデバイスに関連付けられた termios 状態を設定します。 +これは +.Xr termios 4 +の +.Fn tcsetattr +に +.Dv TCSAFLUSH +オプションを渡した場合の呼び出しを実装している下位の呼び出しです。 +.It Dv TIOCOUTQ Fa int *num +現在の出力キューにある文字数を +.Fa num +の指す整数に代入します。 +.It Dv TIOCSTI Fa char *cp +タイピング入力をシミュレートします。端末が +.Fa cp +の指す文字入力を受けたかのように見せかけます。 +.It Dv TIOCNOTTY Fa void +この呼び出しは時代遅れですが、互換性のために残されています。 +以前は、制御端末 ( +.Xr termios 4 +の +.Em 端末制御 +セクションを参照) を持たないプロセスが最初に端末デバイスをオープンしたとき、 +その端末をプロセスの制御端末として利用できました。 +プログラムによっては最初は制御端末を必要としない場合もあるので、 +これは危険なことでした。 +そこでこの呼び出しは、プロセスから制御端末を切り離す機能を提供していたのです。 +ファイル +.Pa /dev/tty +をオープンし、そのファイル記述子で +.Dv TIOCNOTTY +を呼び出さなければ +.Em なりません。 +.Pp +現在のシステムでは、 +.Fn open +呼び出しにおいてプロセスに制御端末を割り当てるようなことはしません。 +端末を制御端末にするための +.Dv TIOSCTTY +という特別な ioctl が存在します。 +また、プログラム中で +.Fn fork +を行い +.Fn setsid +システムコールを呼び出して、プロセスを専用のセッションに置くこともできます。 +そうするとプロセスを制御端末から切り離す効果があります。 +プログラム中で制御端末を取り除くには、こちらが新しく、望ましい方法です。 +.It Dv TIOCSTOP Fa void +(キーボードから ^S を入力するように) 端末の出力を止めます。 +.It Dv TIOCSTART Fa void +(キーボードから ^Q を入力するように) 端末の出力を開始します。 +.It Dv TIOCSCTTY Fa void +端末をプロセスの制御端末にします +(このときプロセスは制御端末を持っていてはいけません)。 +.It Dv TIOCDRAIN Fa void +すべての出力が終わるまで待ちます。 +.It Dv TIOCEXCL Fa void +端末を専有使用するよう設定します。 +以後、root 以外がこの端末をオープンすることはできません。 +もちろん、root によって実行された (あるいは setuid された) プログラムは +この専有設定には従いません。 +これによって、この機能の有用性が制限されることになります。 +.It Dv TIOCNXCL Fa void +端末の専有使用を取り消します。 +以後、この端末をオープンできるようになります。 +.It Dv TIOCFLUSH Fa int *what +.Fa what +の指す整数値が +.Pa Aq sys/file.h +に定義されている +.Dv FREAD +ビットを含むなら、 +入力キューにある文字はすべて消去されます。 +.Dv FWRITE +ビットを含むなら、 +出力キューにある文字はすべて消去されます。 +整数値が 0 なら、 +.Dv FREAD +ビットと +.Dv FWRITE +ビットの両方がセットされているかのように動作します +(つまり両方のキューをクリアします)。 +.It Dv TIOCGWINSZ Fa struct winsize *ws +端末に関連付けられたウィンドウのサイズ情報を +.Fa ws +の指す +.Va winsize +構造体に代入します。 +ウィンドウサイズの構造体は、端末に接続されたデバイスの行数と桁数 +(適切な場合にはピクセル数も) を保持します。 +これはユーザソフトウェアによって設定され、 +全画面指向のプログラムのほとんどがこの方法で画面サイズを決定します。 +.Va winsize +構造体は +.Pa Aq sys/ioctl.h +に定義されています。 +.It Dv TIOCSWINSZ Fa struct winsize *ws +端末に関連付けられたウィンドウのサイズを +.Fa ws +の指す +.Va winsize +構造体 (上記参照) 中の値に設定します。 +.It Dv TIOCCONS Fa int *on +.Fa on +が 0 以外の整数を指していれば、 +カーネルコンソールの出力 (カーネルの printf 先) +をこの端末にリダイレクトします。 +.Fa on +が整数 0 を指していれば、 +カーネルコンソールの出力を通常のコンソールに戻します。 +これは普通、ワークステーション上でカーネルメッセージを +特定のウィンドウにリダイレクトするのに使われます。 +.It Dv TIOCMSET Fa int *state +.Fa state +の指す整数は、モデムの状態に対応するビットを含みます。 +次のリストは定義済み変数とそれが表すモデムの状態です: +.Pp +.Bl -tag -width TIOCMXCTS -compact +.It TIOCM_LE +回線利用可能 (Line Enable) +.It TIOCM_DTR +データ端末レディ (Data Terminal Ready) +.It TIOCM_RTS +送信要求 (Request To Send) +.It TIOCM_ST +従局送信 (Secondary Transmit) +.It TIOCM_SR +従局受信 (Secondary Receive) +.It TIOCM_CTS +送信可 (Clear To Send) +.It TIOCM_CAR +キャリア検出 (Carrier Detect) +.It TIOCM_CD +キャリア検出 (別称) +.It TIOCM_RNG +被呼表示 (Ring Indication) +.It TIOCM_RI +被呼表示 (別称) +.It TIOCM_DSR +データセットレディ (Data Set Ready) +.El +.Pp +この呼び出しは、端末モデムを +.Fa state +の表す状態に設定します。 +すべての端末がこの呼び出しをサポートしているとは限りません。 +.It Dv TIOCMGET Fa int *state +上記のような端末モデム回線の現在の状態を +.Fa state +の指す整数に返します。 +.It Dv TIOCMBIS Fa int *state +.Fa state +の指す整数が含むビットは、上記のようなモデムの状態を表しますが、 +現在の状態との OR (和) が設定されます。 +.It Dv TIOCMBIC Fa int *state +.Fa state +の指す整数が含むビットは、上記のようなモデムの状態を表しますが、 +.Fa state +中でオンになっている各ビットを端末中でクリアします。 +.El +.Sh 関連項目 +.Xr stty 1 , +.Xr ioctl 2 , +.Xr pty 4 , +.Xr termios 4 , +.Xr getty 8 diff --git a/ja_JP.eucJP/man/man4/tun.4 b/ja_JP.eucJP/man/man4/tun.4 new file mode 100644 index 0000000000..7acb876e48 --- /dev/null +++ b/ja_JP.eucJP/man/man4/tun.4 @@ -0,0 +1,237 @@ +.\" %NetBSD: tun.4,v 1.1 1996/06/25 22:17:37 pk Exp % +.\" %Id: tun.4,v 1.5 1998/05/31 04:53:30 mph Exp % +.\" jpman %Id: tun.4,v 1.3 2000/07/20 02:30:19 horikawa Stab % +.\" Based on PR#2411 +.\" +.Dd March 10, 1996 +.Dt TUN 4 +.Os +.Sh 名称 +.Nm tun +.Nd トンネルソフトウェアネットワークデバイス +.Sh 書式 +.Cd pseudo-device tun Op Ar count +.Sh 解説 +.Nm tun +インタフェースはソフトウェアループバック機構であり、大雑把に説明すると +.Xr pty 4 +のネットワークインタフェース版のようなものです。つまり +.Nm tun +は、 +.Nm pty +ドライバが端末に対して行なうことを、ネットワークインタフェースに対して +行います。 +.Pp +.Nm tun +ドライバは +.Nm pty +ドライバと同様に、2 つのインタフェースを提供します: ドライバが +シミュレートしている通常の機能のようなインタフェース +.\" 注意: 原文通りに「.Po」「.Pc」を用いると表示が乱れるため、 +.\" 代わりに「(」「)」を使っています。 +.\" .Po +(これは +.Nm tun +の場合にはネットワークインタフェースであり、 +.Nm pty +の場合には端末です) +.\" .Pc +および、キャラクタ型特殊デバイス +.Dq 制御 +インタフェースです。 +.Pp +ネットワークインタフェースには +.Sy tun Ns Ar 0 , +.Sy tun Ns Ar 1 +等のように名前が付けられます。これは +.Sy pseudo-device +行で指定された +.Ar count +の数だけあります。各インタフェースはネットワークインタフェースの +通常の +.Xr ioctl 2 +( +.Dv SIOCSIFADDR +や +.Dv SIOCSIFNETMASK +等) をサポートしているので、他のインタフェースと同様に +.Xr ifconfig 8 +で使うことができます。このインタフェースは起動時には +.Dv POINTOPOINT +インタフェースですが、変更することができます。後述する制御デバイスの +説明を参照してください。システムがパケットをネットワークインタフェース +に送ることになった時、そのパケットを制御デバイスから読むことができます +.Po +これは +.Dq input +としてここに現われます +.Pc 。 +パケットを制御デバイスに書き込むと、ネットワークインタフェースには入力 +パケットが生成されます。この動作は、 +.Pq 存在しない +ハードウェアがパケットを受け取ったかのように行われます。 +.Pp +トンネルデバイス (通常は +.Pa /dev/tun Ns Sy N +) は排他的にオープンされるデバイス +.Po +既にオープンされている場合にはオープンできません +.Pc +であり、スーパユーザしか利用できないように制限されています。 +インタフェースが +.Dq ready +状態 (制御デバイスがオープンされており、インタフェースのアドレスが設定 +されている状態) でなければ、 +.Fn read +システムコールはエラー +.Pq Er EHOSTDOWN +を返します。 +インタフェースが ready 状態になった時、パケットが読み込み可能であれば +.Fn read +はパケットを返します。読み込み可能でなければ、パケットが読み込めるまで +ブロックするか +.Er EWOULDBLOCK +を返します。どちらの動作になるのかは、非ブロッキング I/O モードが有効 +にされているかどうかで決まります。 +.Fn read +に渡されるバッファに許されているよりもパケットが長い場合には、超過分の +データは黙って捨てられます。 +.Pp +オプション指定により、パケットがネットワークインタフェースの出力ルーチン +.Pq Sq Li tunoutput +に与えられる際に、パケットの前に終点アドレスを付けるようにすることがで +きます。 +終点アドレスのフォーマットは、構造体 +.Sq Li sockaddr +です。前に付いたアドレスの実際の長さは、構造体のメンバ +.Sq Li sa_len +に格納されます。パケットのデータはこの直後に続けて置かれます。 +.Xr write 2 +システムコールの呼び出しによりパケットをインタフェースに渡して、 +仮想インタフェースがパケットを +.Dq 受信 +した状態にします。 +.Fn write +システムコール 1 回の呼び出しで、ちょうど 1 つのパケットを与えます。 +パケット長は +.Fn write +に与えられたデータの量から決められます。 +書き込みはブロックされません。パケットが一時的な理由 +.Pq 例: バッファに利用できる容量が無い +で受け取られなかった場合には、パケットは黙って捨てられます。理由が +一時的なものでなかった場合 +.Pq 例: パケットが大きすぎる +には、エラーが返されます。 +.Dq リンク層 (link-layer) モード +が有効 +.Pq 後述の Dv TUNSLMODE No を参照 +ならば、実際のパケットデータの前には、構造体 +.Sq Li sockaddr +がなければなりません。 +現在のドライバは +.Sq Li sa_family +フィールドしか調べません。 +以下の +.Xr ioctl 2 +呼び出しがサポートされています +.Pq 定義されている場所は Aq Pa net/if_tun.h Ns : +.Bl -tag -width TUNSIFMODE +.It Dv TUNSDEBUG +引数は +.Va int +へのポインタでなければなりません。 +これは内部的なデバッグ用変数をその値に設定します。この変数が制御するも +のは (もしあったとしても) ここでは説明しません。ソースコードを読んでくだ +さい。 +.It Dv TUNGDEBUG +引数は +.Va int +へのポインタでなければなりません。 +これは、内部的なデバッグ用変数の値を引数が示す場所に格納します。 +.It Dv TUNSIFMODE +引数は +.Va int +へのポインタでなければなりません。 +この値は +.Dv IFF_POINTOPOINT +または +.Dv IFF_BROADCAST +でなければなりません。 +対応する +.Em tun Ns Sy n +インタフェースのタイプが与えられたタイプに設定されます。上記以外の値が +指定された場合には、エラー +.Er EINVAL +が発生します。この時にはインタフェースは停止 (down) していなければ +なりません。動作していれば、エラー +.Er EBUSY +が起こります。 +.It Dv TUNSLMODE +引数は +.Va int +へのポインタでなければなりません。 +0 でない値を指定すると、 +.Dq リンク層 +モードが有効になります。このモードでは、トンネルデバイスから読み込んだ +パケットの前にネットワーク終点アドレスが追加されます。 +.It Dv FIONBIO +読み込み時の非ブロッキング I/O の有効・無効を設定します。引数 +.Va int +の値が 0 かどうかによって、無効か有効かが決まります +.Pq 書き込みは必ず非ブロッキングです +。 +.It Dv FIOASYNC +読み込み時の非同期 I/O +.Po +つまり、データが読み込み可能な時に +.Dv SIGIO +が生成されるかどうか +.Pc +の有効・無効を設定します。引数 +.Va int +の値が 0 かどうかによって、無効か有効かが決まります。 +.It Dv FIONREAD +パケットが読み込みキューに入っている場合、最初のパケットのサイズを引数 +.Va int +に格納します。それ以外の場合には 0 を格納します。 +.It Dv TIOCSPGRP +非同期 I/O が有効になっている場合に、 +.Dv SIGIO +シグナルを受け取るプロセスグループとして引数 +.Va int +の値を設定します。 +.It Dv TIOCGPGRP +.Dv SIGIO +シグナルに対するプロセスグループの値を取得し、この値を引数 +.Va int +に格納します。 +.El +.Pp +制御デバイスは読み込みに対する +.Xr select 2 +もサポートしています。書き込みに対する select は必ず成功するので意味 +がありません。なぜなら、書き込みは必ず非ブロッキングだからです。 +.Pp +最後のデータデバイスを閉じた時、デフォルトではインタフェースが停止 +します +.Po +.Dq ifconfig tun Ns Sy n No down +が実行されたのと同様になります +.Pc +。 +キューに入っているパケットは全て捨てられます +.\" 注意: 原文通りに「.Po」「.Pc」を用いると表示が乱れるため、 +.\" 代わりに「(」「)」を使っています。 +.\".Po +(データデバイスがオープンされていない時にインタフェースが動作している +場合、出力パケットは蓄積されないで、常に捨てられます)。 +.\".Pc +.Sh 関連項目 +.Xr inet 4 , +.Xr intro 4 +.Sh バグ +現在は IP 専用です。 +.Sh 作者 +このマニュアルページは +.Bx Net +から取得しました。 diff --git a/ja_JP.eucJP/man/man4/tw.4 b/ja_JP.eucJP/man/man4/tw.4 new file mode 100644 index 0000000000..738ac8dfd0 --- /dev/null +++ b/ja_JP.eucJP/man/man4/tw.4 @@ -0,0 +1,115 @@ +.\" Copyright (c) 1992, 1993 Eugene W. Stark +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Eugene W. Stark. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY EUGENE W. STARK (THE AUTHOR) ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: tw.4,v 1.8 1998/03/12 07:30:39 charnier Exp % +.\" jpman %Id: tw.4,v 1.3 2000/08/10 13:48:54 horikawa Stab % +.\" +.Dd Oct 30, 1993 +.Dt TW 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm tw +.Nd TW-523 X-10 デバイスドライバ +.Sh 解説 +.Nm tw +は、X-10 Inc. の家庭用コントロール製品と共に使用する、 +TW-523 電源ラインインターフェイスのドライバです。 +X-10 プロトコルは、Radio Shack の ``Plug 'n Power(tm)'' や +スタンレーの ``Lightmaker(tm)'' を含む、 +多くの家庭用コントロールシステムと互換性があります。 +.Pp +このドライバは +.Fn read +.Fn write +.Fn select +のシステムコールをサポートします。 +ドライバは複数のプロセスに読み書きができるように動作しますが、実際には +複数の読み取りプロセスがいたり複数の書き込みプロセスがいる場合には +意味が無いかもしれません。 +また現状では、 +実際にふたつのプロセスが同時に送信をしようとすると、 +競合状態になる可能性があります +(tw_sc のなかの sc_pkt 構造体の非同期のアクセス構造によるものです)。 +.Pp +送信は +.Fn write +を呼び出し、3 バイトのデータパケットを送信することによってなされます。 +最初のバイトは 4 ビットのハウスコード (0=A から 15=P まで)、2 バイト目は +5 ビットの unit/key コード (0= ユニット 1 から 15= ユニット 16 まで、 +16= 全ユニットオフ、31= ステータスリクエスト) です。 +3 バイト目は、連続して +間を空けずに送信されるパケットの数を指定します。通常は X-10 Inc. の文書に +したがってこの値は 2 ですが、他の値をとることもできます。 +.Fn write +の呼び出しはそれぞれが任意のデータ長 (バイト数) を指定できますが、 +どの呼び出しでも最大ひとつのパケットしか処理されません。 +不完全なパケットは続いて起きる +.Fn write +呼び出しが完全にデータを提供するまでバッファされます。 +連続する +.Fn write +の呼び出しに対しては、X-10 Inc. の文書にしたがって、3 サイクルの間隔が +とられます。ドライバは 1 サイクルに 3 回ビットを送るように定めている +X-10 Inc. の文書と異なり、半サイクルに 1 ビットずつしか送りません。 +これは TW523 が +電源ラインがゼロ点を通る時の同期しか提供していないためです。したがって +3 相交流の商用電源サービスではドライバがうまく動作しない可能性があります。 +ほとんどの住宅ではこのドライバが作動する 2 線の電源を使用しています。 +.Pp +受信は +.Fn read +で行います。 +ドライバは、3 文字から成るパケットを生成します。 +それぞれのパケットで、最初の文字はフラグから成り、2 番目の文字は 4 ビットの +ハウスコード (0-15)、3 番目の文字は 5 ビットの key/function コード (0-31) で +す。フラグは以下の通りです。 +.Bl -diag +.It +#define TW_RCV_LOCAL 1 /* ローカルな転送中にパケットが到着しました */ +.It +#define TW_RCV_ERROR 2 /* 不正/壊れたパケットが到着しました */ +.El +.Pp +.Fn select +システムコールは、通常通り、読み取ることのできるデータが存在しているかどうかを +確かめるため、使用可能です。 +.Sh 関連項目 +.Xr xten 1 , +.Xr xtend 8 +.Bl -diag +.It +X-10 Inc. による TW-523 に関する文書 +.El +.Sh 関連ファイル +.Bl -tag -width /dev/tw +.It Pa /dev/tw? +TW523 デバイス型特殊ファイル +.El +.Sh 作者 +.An Eugene W. Stark Aq stark@cs.sunysb.edu diff --git a/ja_JP.eucJP/man/man4/tx.4 b/ja_JP.eucJP/man/man4/tx.4 new file mode 100644 index 0000000000..64c31ddbcb --- /dev/null +++ b/ja_JP.eucJP/man/man4/tx.4 @@ -0,0 +1,91 @@ +.\" +.\" Copyright (c) 1998 Semen Ustimenko +.\" +.\" 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. +.\" +.\" +.Dd January 28, 1997 +.\" jpman %Id: tx.4,v 1.3 2000/01/03 03:14:27 horikawa Stab % +.Dt TX 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm tx +.Nd +SMC9432TX ファーストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device tx0" +.Sh 解説 +.Nm +デバイスドライバは SMC 83c170 (EPIC) を利用したイーサネットアダプタを +サポートしています。 +.Pp +.Nm +ドライバは以下に挙げるメディアタイプをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxx +.It autoselect +自動判別を有効にします (デフォルト) +.It 100baseTX +100Mbps (ファーストイーサネット) による転送を利用します +.It 10baseT/UTP +10BaseT ポートでの 10Mbps による転送を利用します +.El +.Pp +.Nm +ドライバは以下に挙げるメディアオプションをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxx +.It full-duplex +全二重による転送を利用します +.El +.Pp +以前の ``ifconfig tx0 linkN'' による設定はサポートされていません。 +.Sh 診断 +.Bl -diag +.It "tx%d: device timeout %d packets" +デバイスは、応答するのを中止しました。 +このエラーの後、デバイスとドライバはリセットされます。 +.It "tx%d: PCI fatal error occured (%s)" +次にあげるエラーのうちどれかひとつが発生しました: PCI Target Abort, +PCI Master Abort, Data Parity Error, Address Parity Error。 +このエラーの後、デバイスとドライバはリセットされます。 +.It "tx%d: WARNING! no link established" +メディアが接続されていません。 +起動時にのみ表示されます。 +.It "tx%d: cannot allocate mbuf header/cluster" +受信パケットのためのメモリを用意できません。 +パケットは破棄されます。 +.\" Revision 1.5.2.2 では packt thrown away に修正されている +.\" Dec 31 1999, +.It "tx%d: can't stop %s DMA" +リセットを行っている間に、 +ドライバはデバイスを正常に停止させることができませんでした。 +.El +.Sh バグ +.Pp +マルチキャストパケットフィルタリングは、サポートしていません。 +ひとつの PHY (Quality Semiconductor QS6612) のみ、実際にテストしました。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 diff --git a/ja_JP.eucJP/man/man4/udp.4 b/ja_JP.eucJP/man/man4/udp.4 new file mode 100644 index 0000000000..b528e89b82 --- /dev/null +++ b/ja_JP.eucJP/man/man4/udp.4 @@ -0,0 +1,134 @@ +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)udp.4 8.1 (Berkeley) 6/5/93 +.\" jpman %Id: udp.4,v 1.3 1999/03/11 15:31:24 horikawa Stab % +.\" %Id: udp.4,v 1.6 1997/03/19 19:47:43 bde Exp % +.\" +.Dd June 5, 1993 +.Dt UDP 4 +.Os BSD 4.2 +.Sh 名称 +.Nm udp +.Nd インターネットユーザデータグラムプロトコル +.Sh 書式 +.Fd #include +.Fd #include +.Fd #include +.Ft int +.Fn socket AF_INET SOCK_DGRAM 0 +.Sh 解説 +.Tn UDP +は単純で信頼性のないデータグラムプロトコルであり、 +インターネットプロトコルファミリにおいて +.Dv SOCK_DGRAM +として抽象化された機能をサポートするものとして使用されます。 +.Tn UDP +ソケットはコネクションレス型であり、普通 +.Xr sendto 2 +及び +.Xr recvfrom 2 +コールと共に使用されます。 +ただし、後で送られるパケットの宛先を固定する目的で +.Xr connect 2 +コールも使用できます (その場合には普通 +.Xr recv 2 +または +.Xr read 2 +、及び +.Xr send 2 +または +.Xr write 2 +システムコールと共に使用されます)。 +.Pp +.Tn UDP +のアドレスフォーマットは +.Tn TCP +で使用されるものと同一です。 +特に +.Tn UDP +は標準のインターネットアドレスフォーマットに加え、 +ポート識別子を提供します。 +.Tn UDP +ポート空間は +.Tn TCP +ポート空間とは分離していることに注意してください +(すなわち、 +.Tn UDP +ポートは +.Tn TCP +ポートと +.Dq 接続できません +)。 +加えて、ブロードキャストパケットは予約された +.Dq ブロードキャストアドレス +を用いて送信されます +(下位層のネットワークがこれをサポートしているものと仮定しています)。 +ブロードキャストアドレスはネットワークインタフェースに依存します。 +.Pp +.Tn IP +トランスポート層におけるオプションは +.Tn UDP +で使用できます。本件については +.Xr ip 4 +を参照してください。 +.Sh 診断 +ソケット操作の失敗の際には次のエラーのうちの一つが返されます: +.Bl -tag -width [EADDRNOTAVAIL] +.It Bq Er EISCONN +既にコネクションが確立されているソケットに対し +さらにコネクションを確立させようとした時、 +あるいは既にソケットのコネクションが確立されているのに、 +宛先アドレスを指定してデータグラムを送信しようとした時 +.It Bq Er ENOTCONN +ソケットのコネクションが確立されていない場合に、 +宛先アドレスの指定をせずデータグラムの送信を行おうとした時 +.It Bq Er ENOBUFS +内部的なデータ構造のためのメモリが不足した時 +.It Bq Er EADDRINUSE +既に割り当てられているポートに対しソケットを作成しようとした時 +.It Bq Er EADDRNOTAVAIL +対応したネットワークインタフェースが存在しない +ネットワークアドレスを指定し、ソケットを作成しようとした時 +.El +.Sh 関連項目 +.Xr getsockopt 2 , +.Xr recv 2 , +.Xr send 2 , +.Xr socket 2 , +.Xr inet 4 , +.Xr intro 4 , +.Xr ip 4 +.Sh 歴史 +.Nm +プロトコルは +.Bx 4.2 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/uk.4 b/ja_JP.eucJP/man/man4/uk.4 new file mode 100644 index 0000000000..a274eb3eb8 --- /dev/null +++ b/ja_JP.eucJP/man/man4/uk.4 @@ -0,0 +1,90 @@ +.\" %Id: uk.4,v 1.12 1997/03/21 20:13:27 mpp Exp % +.\" jpman %Id: uk.4,v 1.3 2000/01/03 03:14:07 horikawa Stab % +.\" 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 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. +.\" +.Dd October 11, 1993 +.Dt UK 4 +.Os FreeBSD +.Sh 名称 +.Nm uk +.Nd SCSI ユーザレベルドライバ +.Sh 書式 +.Cd "device uk" +.Sh 解説 +.Nm uk +ドライバは、ドライバの設定が行われていないデバイスを、 +SCSI バス上でアドレスするためのサポートを提供します。 +.Pp +.Fx 2.1 +以前は、 +最初にみつかった未知のデバイスは、 +.Em uk0 +としてアタッチされ、以下 +.Em uk1 +という具合にアタッチしてゆきます。 +.Fx 2.1 +以降では、あるデバイスがどの uk ユニットとして接続すべきかを +指定できるようになりました。 +カーネルを設定する上での詳細は +.Xr scsi 4 +を参照してください。 +.Pp +このドライバを利用する前に、各 SCSI アダプタをシステムに対して設定する +必要があります。 +.Pp +.Sh カーネルの設定 +数が指定されると、その数の +.Nm +ドライバがカーネルに組み込まれます。 +.Pp +.Sh IOCTL +.Nm +ドライバは独自の ioctl は持ちませんが、一般的な +.Xr scsi 4 +コマンドへの媒介として動作します。 +これらに関しては、 +.Em sys/scsiio.h +に記述されています。 +.Sh 関連ファイル +.Bl -tag -width /dev/uk0XXX -compact +.It Pa /dev/uk[0-255] +uk{x} は「x 番目」に見つかった未知のデバイスです。 +.El +.Sh 診断 +.Xr scsi 4 +の全てのデバッグ用 ioctl が +.Nm +デバイスで利用可能です。 +.Sh 関連項目 +.Xr cd 4 , +.Xr ch 4 , +.Xr scsi 4 , +.Xr sd 4 , +.Xr st 4 , +.Xr su 4 +.Sh 歴史 +.Nm +ドライバは 386BSD 0.1 で登場しました。 diff --git a/ja_JP.eucJP/man/man4/unix.4 b/ja_JP.eucJP/man/man4/unix.4 new file mode 100644 index 0000000000..f858c4ac60 --- /dev/null +++ b/ja_JP.eucJP/man/man4/unix.4 @@ -0,0 +1,157 @@ +.\" Copyright (c) 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)unix.4 8.1 (Berkeley) 6/9/93 +.\" jpman %Id: unix.4,v 1.3 2000/08/03 07:00:33 horikawa Stab % +.\" %Id: unix.4,v 1.2 1997/03/07 02:49:37 jmg Exp % +.\" +.Dd June 9, 1993 +.Dt UNIX 4 +.Os +.Sh 名称 +.Nm unix +.Nd UNIX ドメインプロトコルファミリ +.Sh 書式 +.Fd #include +.Fd #include +.Sh 解説 +.Tn UNIX +ドメインプロトコルファミリは、通常の +.Xr socket 2 +メカニズムを用いる +ローカルな (マシン上の) プロセス間通信を提供するプロトコル群です。 +.Tn UNIX +ドメインファミリは +.Dv SOCK_STREAM +および +.Dv SOCK_DGRAM +ソケットタイプをサポートし、 +アドレッシングにファイルシステムのパス名を使います。 +.Sh アドレッシング +.Tn UNIX +ドメインのアドレスは、 +最大 104 文字の可変長のファイルシステムパス名です。 +インクルードファイル +.Aq Pa sys/un.h +がこのアドレスを定義しています: +.Bd -literal -offset indent +struct sockaddr_un { +u_char sun_len; +u_char sun_family; +char sun_path[104]; +}; +.Ed +.Pp +.Xr bind 2 +で +.Tn UNIX +ドメインソケットに名前をバインドすることにより、 +ファイルシステムにソケットファイルが作成されます。 +このファイルはソケットがクローズされても削除されません。削除には +.Xr unlink 2 +を使わなければなりません。 +.Pp +.Tn UNIX +ドメインプロトコルファミリは、ブロードキャストアドレッシングや +入力メッセージに対するどのような形態の +.Dq ワイルドカード +マッチングもサポート +しません。全てのアドレスは他の +.Tn UNIX +ドメインソケットの絶対あるいは相対パス名です。 +また、パス名を参照するときには、 +通常のファイルシステムのアクセスコントロールが適用されます。 +例えば +.Xr connect 2 +あるいは +.Xr sendto 2 +の終点は書き込み可能 +でなければなりません。 +.Sh プロトコル +.Tn UNIX +ドメインプロトコルファミリは +.Dv SOCK_STREAM +および +.Dv SOCK_DGRAM +アブストラクション +をサポートするシンプルなトランスポートプロトコルから成ります。 +また、 +.Dv SOCK_STREAM +ソケットは、 +.Xr sendmsg 2 +および +.Xr recvmsg 2 +へ与える引数の中の +.Ar msg_control +フィールドの使用を通じて +.Tn UNIX +ファイル記述子の通信をサポートします。 +.Pp +任意の正当な記述子をメッセージ中に含めて送信可能です。 +渡されるファイル記述子はインクルードファイル +.Aq Pa sys/socket.h +で定義される +.Ar struct cmsghdr +を用いて記述されます。そのメッセージの +タイプは +.Dv SCM_RIGHTS +であり、メッセージのデータ部は渡される +ファイル記述子を表現する整数の配列です。 +渡される記述子の数はメッセージの length フィールドで定義されています。 +length フィールドはヘッダのサイズと +ファイル記述子の配列のサイズの合計です。 +.Pp +受信された記述子は、 +.Xr dup 2 +の呼び出しによって生成されたかのような、 +送信者の記述子の +.Em 複製 +です。 +.Xr fcntl 2 +でセットされたプロセス毎の記述子フラグは、 +受信者には +.Em 渡されません。 +配送を待っている、あるいは意図的に受け取られない +記述子は、終点ソケットがクローズされたときに +システムによって自動的にクローズされます。 +.Sh 関連項目 +.Xr socket 2 , +.Xr intro 4 +.Rs +.%T "An Introductory 4.3 BSD Interprocess Communication Tutorial" +.%B PS1 +.%N 7 +.Re +.Rs +.%T "An Advanced 4.3 BSD Interprocess Communication Tutorial" +.%B PS1 +.%N 8 +.Re diff --git a/ja_JP.eucJP/man/man4/update.4 b/ja_JP.eucJP/man/man4/update.4 new file mode 100644 index 0000000000..a92c8c75c8 --- /dev/null +++ b/ja_JP.eucJP/man/man4/update.4 @@ -0,0 +1,84 @@ +.\" Copyright (c) 1996 +.\" Mike Pritchard . All rights reserved. +.\" +.\" Copyright (c) 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: update.4,v 1.4 1997/03/07 02:49:37 jmg Exp % +.\" jpman %Id: update.4,v 1.3 1999/08/18 16:39:47 horikawa Stab % +.\" +.Dd February 11, 1996 +.Dt UPDATE 4 +.Os FreeBSD +.Sh 名称 +.Nm update +.Nd 内部のファイルシステムのキャッシュを定期的にディスクに書き出す +.Sh 書式 +.Nm update +.Sh 解説 +.Nm update +カーネルプロセスは、 +揮発性のファイルシステムデータのキャッシュをディスクに書き出すことで、 +ディスクボリュームの完全性を守ることに一役買っています。 +これはデフォルトでは 30 秒間隔で行なわれます。 +この間隔は、 +.Xr sysctl 8 +を使って +.Va kern.update +変数を書き換えることで変えることができます。 +.Nm update +プロセスは +.Xr sync 2 +ファンクションコールがするのと同じ作業をします。 +.Sh 関連項目 +.Xr sync 2 , +.Xr fsck 8 , +.Xr init 8 , +.Xr rc 8 , +.Xr sync 8 , +.Xr sysctl 8 +.Sh バグ +クラッシュと同時に +.Xr sync +が起きるとファイルシステムのダメージの原因となりうるシステムがあります。 +.Xr fsck 8 +を参照してください。 +.Sh 歴史 +.Nm update +コマンドは +.At v6 +で登場し、 +通常、システムがマルチユーザモードに移行する際に /etc/rc から起動されました。 +カーネルが起動する +.Nm update +プロセスは +.Fx 2.0 +に初めて登場しました。 diff --git a/ja_JP.eucJP/man/man4/utf2.4 b/ja_JP.eucJP/man/man4/utf2.4 new file mode 100644 index 0000000000..17bf47f2eb --- /dev/null +++ b/ja_JP.eucJP/man/man4/utf2.4 @@ -0,0 +1,93 @@ +.\" Copyright (c) 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" Paul Borman at Krystal Technologies. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)utf2.4 8.1 (Berkeley) 6/4/93 +.\" jpman %Id: utf2.4,v 1.3 1999/08/18 16:40:05 horikawa Stab % +.\" +.Dd June 4, 1993 +.Dt UTF2 4 +.Os +.Sh 名称 +.Nm utf2 +.Nd "ユニバーサル文字集合変換フォーマットによる文字のエンコーディング +.Sh 書式 +.Nm ENCODING +.Qq UTF2 +.Sh 解説 +.Nm UTF2 +エンコーディングは、 +X-Open が提案した多バイト +\s-1FSS-UCS-TF\s+1 +(File System Safe Universal Character Set Transformation Format) +エンコーディングに基づいており、 +.Nm Bell Labs の Plan 9 +で使われているものと同様のものです。 +このエンコーディングは 16 bit 以上を表すことができますが、 +現在の実装では Unicode Standard によって +定義されている 16 bit までに制限されています。 +.Pp +.Nm UTF2 +による表現は ASCII の上位互換ですので、 +0x00-0x7f は ASCII 文字集合に当てはまります。 +0x0080 から 0xffff までの文字の多バイトエンコーディングは、 +全体が高位ビットがセットされたバイトで構成されています。 +実際のエンコーディングは次の表によって表されています: +.Bd -literal +[0x0000 - 0x007f] [00000000.0bbbbbbb] -> 0bbbbbbb +[0x0080 - 0x07ff] [00000bbb.bbbbbbbb] -> 110bbbbb, 10bbbbbb +[0x0800 - 0xffff] [bbbbbbbb.bbbbbbbb] -> 1110bbbb, 10bbbbbb, 10bbbbbb +.Ed +.Pp +ある値に対して 1 つ以上の表現が存在する場合には +(例えば 0x00 と 0xC0 0x80 と 0xE0 0x80 0x80)、 +常に最も短い表現が使われます。 +(ただし長い表現のものも正しくデコードされるでしょう。) +.Pp +X-Open は最終的な 3 つのエンコーディングを用意しています: +.Bd -literal +[00000000.000bbbbb.bbbbbbbb.bbbbbbbb] -> + 11110bbb, 10bbbbbb, 10bbbbbb, 10bbbbbb + +[000000bb.bbbbbbbb.bbbbbbbb.bbbbbbbb] -> + 111110bb, 10bbbbbb, 10bbbbbb, 10bbbbbb, 10bbbbbb + +[0bbbbbbb.bbbbbbbb.bbbbbbbb.bbbbbbbb] -> + 1111110b, 10bbbbbb, 10bbbbbb, 10bbbbbb, 10bbbbbb, 10bbbbbb +.Ed +.Pp +これらは提案されている完全な ISO-10646 31 bit Standard のために +用意されていますが、現在は実装されていません。 +.Sh 関連項目 +.Xr mklocale 1 , +.Xr setlocale 3 diff --git a/ja_JP.eucJP/man/man4/vga.4 b/ja_JP.eucJP/man/man4/vga.4 new file mode 100644 index 0000000000..bb81502abf --- /dev/null +++ b/ja_JP.eucJP/man/man4/vga.4 @@ -0,0 +1,184 @@ +.\" +.\" Copyright (c) 1999 +.\" Kazutaka YOKOTA +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer as +.\" the first lines of this file unmodified. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: vga.4,v 1.1.2.2 1999/02/10 14:49:52 yokota Exp % +.\" jpman %Id: vga.4,v 1.3 1999/08/18 16:40:13 horikawa Stab % +.\" +.Dd February 9, 1999 +.Dt VGA 4 +.Os FreeBSD +.Sh 名称 +.Nm vga +.Nd +汎用ビデオカードインタフェース +.Sh 書式 +.Cd "options" \&"VESA\&" +.Cd "options" \&"VESA_DEBUG=N\&" +.Cd "options" \&"VGA_ALT_SEQACCESS\&" +.Cd "options" \&"VGA_NO_FONT_LOADING\&" +.Cd "options" \&"VGA_NO_MODE_CHANGE\&" +.Cd "options" \&"VGA_SLOW_IOACCESS\&" +.Cd "options" \&"VM86\&" +.Cd "device vga0 at isa? port ? conflicts" +.Sh 解説 +.Nm +ドライバは汎用ビデオカードドライバであり、 +ビデオカードを利用できるようにします。 +このドライバはコンソールドライバ +.Xr syscons 4 +のために必要です。 +コンソールドライバは +.Nm +ドライバを呼び出してビデオハードウェアを操作します +(ビデオモードの変更、フォントの読み込み、など)。 +.Pp +ビデオカードは他のドライバと同じ範囲の I/O ポートを使用するかもしれないので、 +キーワード +.Em conflicts +が必要です。 +.Pp +.Nm +ドライバは次の規格のビデオカードをサポートします: MDA, CGA, EGA, VGA。 +さらに、ビデオカードがサポートしていれば +VESA 拡張 BIOS を利用することもできます。 +VESA サポートは静的にカーネルに含めておくことも、 +独立したモジュールとして読み込むこともできます。 +.Pp +VESA サポートをカーネルに静的にリンクするためには、 +カーネル設定ファイルで +.Em VESA +オプション(以下参照) と +.Em VM86 +オプションを定義することが必要です。 +.Pp +.Nm vesa +モジュールは +.Xr kldload 8 +を使って動的にカーネルに読み込むことができます。 +このためには、 +.Em VM86 +オプションをカーネル設定ファイルで定義しておく必要があります。 +.Sh ドライバの設定 +.Ss カーネル設定オプション +.Nm +ドライバを制御するために、 +以下のカーネル設定オプション +.Pq Xr config 8 参照 +が使えます。 +これらのオプションはある種の VGA カードとの互換性をとるためのものです。 +.Bl -tag -width MOUSE +.It Em VGA_ALT_SEQACCESS +マウスポインタが正しく描画されない場合や、 +あるいはフォントが VGA カードにうまく読み込めていないように思える場合には、 +このオプションを試すと良いかも知れません。 +ただしシステムによってはちらつきが生じるようになるかもしれません。 +.It Em VGA_SLOW_IOACCESS +古い VGA カードを正しく動作させるためにこのオプションが必要かもしれません。 +これによってドライバは VGA レジスタに対しバイト幅の I/O を行なうようになり、 +若干動作が遅くなります。 +.El +.Pp +以下のオプションはドライバに任意選択の機能を付け加えます。 +.Bl -tag -width MOUSE +.It Em VESA +ドライバに VESA BIOS サポートを加えます。 +もし VGA カードが VESA 拡張 BIOS 1.2 以降を持っていれば、 +このオプションによって高解像度モードへの切替えに +VESA BIOS を利用するようになります。 +このオプションを使用するには +.Em VM86 +オプションも必要です。 +.It Em VESA_DEBUG=N +VESA サポートのデバッグレベルを +.Fa N +にします。 +デフォルトは 0 で、すべてのデバッグ出力は抑制されます。 +.El +.Pp +以下のオプションは +.Nm +ドライバから機能を削り、カーネルの使用メモリを節約します。 +.Bl -tag -width MOUSE +.It Em VGA_NO_FONT_LOADING +.Nm +ドライバは EGA や VGA のカードにソフトウェアフォントを読み込めます。 +このオプションはこの機能を削ります。 +.It Em VGA_NO_MODE_CHANGE +このオプションはドライバがビデオモードを変更できないようにします。 +.El +.\".Sh 関連ファイル +.Sh 使用例 +カーネル設定ファイルには普通は以下の記述があるはずです: +.Pp +.Dl "device vga0 at isa? port ? conflicts" +.Pp +VESA 拡張 BIOS サポートを有効にするためには、 +カーネル設定ファイルに次の 3 行を含めてください。 +.Pp +.Dl "options" \&"VM86\&" +.Dl "options" \&"VESA\&" +.Dl "device vga0 at isa? port ? conflicts" +.Pp +VESA サポートをカーネルに含めたくないが、たまには使いたい場合には、 +次の 2 行をカーネル設定ファイルに加えてください: +.Pp +.Dl "options" \&"VM86\&" +.Dl "device vga0 at isa? port ? conflicts" +.Pp +そして使いたくなったら +.Nm vesa +モジュールを読み込んでください: +.Pp +.Dl kldload vesa +.Pp +.\".Sh 診断 +.\".Sh 警告 +.\".Sh バグ +.Sh 関連項目 +.Xr syscons 4 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 +.Sh 規格 +.Rs +.%T "VESA BIOS Extension (VBE)" +.%A Video Electronics Standards Association +.Re +.Sh 歴史 +.Nm +ドライバは +.Fx 3.1 +に初めて登場しました。 +.Sh 作者 +.Nm +ドライバは +.ie t .An S\(/oren Schmidt Aq sos@FreeBSD.org +.el .An Soren Schmidt Aq sos@FreeBSD.org +と +.An Kazutaka Yokota Aq yokota@FreeBSD.org +が書きました。このマニュアルページは +.An Kazutaka Yokota +が書きました。 diff --git a/ja_JP.eucJP/man/man4/vinum.4 b/ja_JP.eucJP/man/man4/vinum.4 new file mode 100644 index 0000000000..2dc05485c2 --- /dev/null +++ b/ja_JP.eucJP/man/man4/vinum.4 @@ -0,0 +1,998 @@ +.\" Hey, Emacs, edit this file in -*- nroff-fill -*- mode +.\"- +.\" Copyright (c) 1997, 1998 +.\" Nan Yang Computer Services Limited. All rights reserved. +.\" +.\" This software is distributed under the so-called ``Berkeley +.\" License'': +.\" +.\" 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 Nan Yang Computer +.\" Services Limited. +.\" 4. Neither the name of the Company nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" This software is provided ``as is'', and 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 company or contributors be liable for any +.\" direct, indirect, incidental, special, exemplary, or consequential +.\" damages (including, but not limited to, procurement of substitute +.\" goods or services; loss of use, data, or profits; or business +.\" interruption) however caused and on any theory of liability, whether +.\" in contract, strict liability, or tort (including negligence or +.\" otherwise) arising in any way out of the use of this software, even if +.\" advised of the possibility of such damage. +.\" +.\" %Id: vinum.4,v 1.6.2.3 1999/02/05 00:59:31 grog Exp % +.\" +.\" jpman %Id: vinum.4,v 1.3 1999/09/26 12:24:52 horikawa Stab % +.\" WORD: attach 結合 (する) [vinum.8] +.\" WORD: detach 分離 (する) +.\" +.Dd 22 July 1998 +.Dt vinum 4 +.Os FreeBSD +.Sh 名称 +.Nm vinum +.Nd 論理ボリュームマネージャ +.Sh 書式 +.Cd "kldload vinum" +.Cd "kldload Vinum" +.Sh 解説 +.Nm +は論理ボリュームマネージャです。Veritas Volume Manager に喚起されていますが +直接由来するものではありません。これは次のような機能を提供します。 +.Bl -bullet +.It +デバイスに依存しない論理ディスクを提供します。 +これを\fIボリューム\fPと呼びます。 +ボリュームはシステム内のディスクの大きさに制限されません。 +.It +ボリュームは 1 つ以上の\fIプレックス\fPから構成されます。各プレックスは +ボリュームの全アドレス空間を持ちます。これは RAID-1 (ミラー) の実装を表します。 +複数のプレックスを使うことにより以下のような効果があります。 +.\" XXX What about sparse plexes? Do we want them? +.if t .sp +.Bl -bullet +.It +読み出しスループットの向上。 +.Nm +は最もアクセスの少ないディスクからデータを読み出すので、 +複数のディスクからなるプレックスを持つボリュームなら +より多くのデータを並列に読み出すことが可能です。 +.Nm +は 1 プレックスからのみデータを読み出しますが、 +すべてのプレックスに対してデータを書き込みます。 +.It +信頼性の向上。異なるディスク上の複数のプレックスに格納することにより、 +プレックスのうちの 1 つが利用不能になったとしてもデータを取り出せるでしょう。 +RAID-5 プレックス (下記参照) と比べて、複数のプレックスはより多くのストレージ +領域を必要としますが、パフォーマンスが優れています。特にドライブ故障の際の +差は顕著でしょう。 +.It +冗長なプレックスを利用して、オンラインのままデータ再構成ができます。 +あるプレックスを結合し、 +続いて古いプレックスの 1 つを分離することにより、アクセスを妨げることなく +オンラインでデータを移動できます。 +.It +冗長なプレックスにより、一貫性を持ったファイルシステムダンプを +得ることができます。 +プレックスを結合し、ある時点で分離することにより、分離されたプレックスは +分離した時点におけるファイルシステムの正確なスナップショットになります。 +.\" Make sure to flush! +.El +.It +各プレックスは、\fIサブディスク\fPと呼ばれる、 +1 つ以上の論理ディスクスライスから構成されます。 +サブディスクは物理ディスクの連続したブロックとして定義されます。 +プレックスはあらゆる適切な数のサブディスクで構成できます。(言い替えれば、 +本当の制限はサブディスクの数ではなく別の要因、多くのサブディスクの管理に +関するメモリやパフォーマンスといったものです) +.It +サブディスクとプレックスの間の編成にはいくつかの種類があります: +.Bl -bullet +.It +\fIコンカチネート化プレックス\fP\|は 1 つ以上のサブディスクからなり、 +各サブディスク +はプレックスのアドレス空間の中で連続した部分として編成されます。 +.It +\fIストライプ化プレックス\fP\|は 2 つ以上の、 +大きさの等しいサブディスクからなります。 +ファイルのアドレス空間は\fIストライプ\fPに、 +すなわちサブディスクの大きさの整数分の 1 に、対応付けられます。 +連続したプレックスアドレス空間には、 +各サブディスクのストライプが順番に対応付けられます。 +.if t \{\ +.PS +move right 2i +down +SD0: box +SD1: box +SD2: box + +"plex 0" at SD0.n+(0,.2) +"subdisk 0" rjust at SD0.w-(.2,0) +"subdisk 1" rjust at SD1.w-(.2,0) +"subdisk 2" rjust at SD2.w-(.2,0) +.PE +.\} +ストライプ化プレックスのサブディスクはすべて同じ大きさである必要があります。 +.It +\fIRAID-5 プレックス\fP\|には大きさの等しいサブディスクが、 +少なくとも 3 つは必要です。 +これはストライプ化プレックスに似ていますが、 +各ストライプの中で 1 つのサブディスク +がパリティ情報を持っている点が異なります。パリティ情報を持つサブディスクは +ストライプによって異なります。1 番目のストライプでは 1 番目のサブディスク、 +2 番目のストライプでは 2 番目のサブディスクといったようになります。 +単一ディスク故障の場合、 +.Nm +は残りのサブディスクに格納されている情報からデータを復元します。 +この編成は読み出しが集中するアクセスに特に向いています。RAID-5 プレックスの +サブディスクはすべて同じ大きさである必要があります。 +.\" Make sure to flush! +.El +.It +.Nm ドライブ +はストレージ階層の中で最も低レベルなものです。これはディスク特殊デバイスを +表します。 +.It +.Nm +は自動起動機能を提供します。通常の UNIX ファイルシステムと異なり、 +.Nm +ボリューム内にすべての設定情報を持っているため、サブシステムが利用可能に +なった時に正しく起動することを保証できます。 +この点が Veritas\(tm File System に対する重要な利点でもあります。 +この機能はボリュームの存在を検出します。 +これは、ボリュームを自動的にマウントするという意味ではありません。 +マウントを実行するのは、通常の +.Pa /etc/fstab +による起動手順です。 +.El +.Sh カーネルの設定 +.Nm +は現在カーネルロード可能モジュール (kld) として提供されており、 +カーネルの設定は不要です。 +他の kld と同様、kld は OS のバージョンと +絶対に適合する必要があります。そうでなければ +.Nm +はエラーメッセージを出力して終了するでしょう。 +.Pp +.Nm +には現在 2 つのバージョンがあります。 +それは、RAID-5 機能を持たない自由に入手可能なバージョンと、 +RAID-5 の機能を持つ完全なバージョンです。完全なバージョンは +Cybernet Systems Inc. (http://www.cybernet.com\fR) から入手可能です。 +.Sh VINUM の起動 +通常、設定されたバージョンの +.Nm +をブート時に起動させます。 +.Ar /etc/rc.conf +内の変数 +.Ar vinum_drives +に +.Nm +ドライブが置かれているスライスを設定します。例えば、 +.Nm +ドライブが +.Ar /dev/da1h , +.Ar /dev/da2h , +.Ar /dev/da3h , +.Ar /dev/da4h , +.Ar /dev/da5h +にあるとすると、この変数を次のように設定します。 +.Bd -literal +vinum_drives="/dev/da1 /dev/da2 /dev/da3 /dev/da4 /dev/da5" +.Ed +.Pp +.Sh VINUM のインストール +自由に入手可能なバージョンの +.Nm +kld は +.Pa /modules/vinum.ko +であり、RAID-5 バージョンの kld は +.Pa /modules/Vinum.o +です。 +モジュールをロードするには次のコマンドを実行します: +.Pp +.Bd -unfilled -offset indent +# kldload vinum +.Ed +.Pp +また +.Nm vinum(8) +はロードされていなければ kld モジュールを自動的にロードします。 +.Pp +.Nm vinum +をロードした後、設定を実行する必要があります。すでにインストールが +終わっていれば、次のコマンドにより、 +存在するディスク集合から設定を読み出します。 +.Bd -unfilled -offset indent +# vinum read /dev/da1 /dev/da2 /dev/da3 /dev/da4 /dev/da5 /dev/da6 +.Ed +.sp +このコマンドでは +.Nm vinum +により使われるすべてのデバイスを指定する必要があります。 +.Nm vinum(8) +は、最新の設定ファイルを使用して、 +設定をデバイスより読み出します。 +引き続いて、より古い設定から得られた追加情報があれば、設定を更新します。 +このようなコマンドは通常、起動ファイル +.Pa /etc/rc +に埋めこまれています。 +.Pp +.Nm +設定を作成する方法については +.Xr vinum 8 +を参照してください。 +.Pp +kld をアンロードするには、まず +.Pa kldstat +で +.Ar Id +フィールドを探します。 +.Bd -unfilled -offset indent +# kldstat +Id Refs Address Size Name + 1 2 0xf0100000 1c7de8 kernel + 2 1 0xf0f5b000 b0000 Vinum.ko +.Ed +.Pp +モジュールをアンロードするには +.Pa kldunload +を使います: +.Bd -unfilled -offset indent +# kldunload -n Vinum +.Ed +.Pp +kld をアンロードできるのはアイドル中、言い替えると +ボリュームがマウントされておらず、他の +.Nm +プログラムのインスタンスがアクティブでない時のみです。 +kld のアンロードはボリューム内のデータを破壊しません。 +.Ss オブジェクトの設定と起動 +.Nm +オブジェクトの設定と起動には、 +.Xr vinum 8 +ユーティリティを使ってください。 +.Sh IOCTL 呼び出し +.Pa ioctl +呼び出しは +.Nm +設定プログラムだけが使うように設計されています。 +ヘッダファイル +.Pa /sys/sys/vinumio.h +に説明があります。 +.Ss ディスクラベル +伝統的なディスク特殊デバイスは +.Em ディスクラベル +をデバイスの第 2 セクタに持っています。 +詳細については +.Xr disklabel 5 +を参照してください。 +このディスクラベルにはデバイス内のパーティション情報が記述されています。 +.Nm +はボリュームをさらに分割することはないので、ボリュームには物理ディスクラベル +がありません。 +利便のため、 +.Nm +には ioctl 呼び出し DIOCGDINFO (ディスクラベルの取得), +DIOCGPART (パーティション情報の取得), +DIOCWDINFO (パーティション情報の書き込み), DIOCSDINFO +(パーティション情報の設定) が実装されています。DIOCGDINFO と DIOCGPART は +内部的なディスクラベル情報を参照しますが、これはボリューム内には存在しません。 +従って、 +.Xr disklabel 8 +の +.Fl r +オプションは、生のディスク情報を読むので、失敗するでしょう。 +.Pp +一般に、 +.Xr disklabel 8 +は vinum ボリュームにとって有用な効果はありません。もし動作させると、 +disklabel は 3 つのパーティション a, b, c を表示し、fstype を除いて +これらは同じになるでしょう。例えば以下のように表示されます: +.Bd -unfilled -offset +3 partitions: +# size offset fstype [fsize bsize bps/cpg] + a: 2048 0 4.2BSD 1024 8192 0 # (Cyl. 0 - 0) + b: 2048 0 swap # (Cyl. 0 - 0) + c: 2048 0 unused 0 0 # (Cyl. 0 - 0) +.Ed +.Pp +.Nm +は DIOCWDINFO と DIOCSDINFO の ioctl を無視します。すなわち何も変更しません。 +従って、ディスクラベルを変更しようとすると何の表示もなく無視されるでしょう。 +.Sh ファイルシステムの作成 +.Nm +ボリュームはパーティションを持たないので、ボリュームの名前に関してディスク +パーティションの名前付けの通常のルールに従う必要はありません。 +物理ディスクパーティションにおいては、デバイス名の最後の文字は +パーティション識別子 (a から h) を指定します。 +.Nm +ボリュームはこの規則に従う必要はありません。しかし従わなかった場合、 +.Nm newfs +がパーティションの識別が出来ないと文句を言うでしょう。この問題を解決するには +.Nm newfs +に対して +.Fl v +フラグを指定してください。 +.Sh オブジェクトの名前付け +.Nm +はデフォルトの名前をプレックスとサブディスクに割り当てます。この名前を +上書きすることも可能です。しかしデフォルトの名前を上書きすることは推奨 +しません。オブジェクトに任意の名前を付けられる +.if t Veritas\(tm +.if n Veritas(tm) +volume manager の使用経験からすると、このような自由度に大きな利点はなく、 +混乱を引き起こすでしょう。 +.sp +名前には空白でない任意の文字を使えますが、英数字とアンダスコアのみに +制限することを勧めます。ボリューム、プレックス、サブディスクの名前には +64 文字まで、またドライブの名前には 32 文字まで使えます。 +ボリュームとプレックスの名前を選ぶ時には、 +自動的に生成されるプレックス名とサブボリューム名が、 +これらの元となる名前よりも長くなることに注意してください。 +.Bl -bullet +.It +.Nm vinum(8) +がオブジェクトを生成または削除すると、ディレクトリ +.Ar /dev/vinum +を作成し、その中に vinum が検出した各ボリュームに対応する +デバイスエントリを作成します。また、vinum はサブディレクトリ +.Ar /dev/vinum/plex +と +.Ar /dev/vinum/sd +を作成し、その中にプレックスとサブディスクに対応するデバイスエントリを +格納します。更に、vinum は2つのディレクトリ +.Ar /dev/vinum/vol +と +.Ar /dev/vinum/drive +を作成し、その中にボリュームとドライブに対する階層的な情報を格納します。 +.It +.Nm UNIX +ドライブと異なり、 +.Nm +ボリュームをパーティションへとさらに分割しません。 +従ってディスクラベルを持ちません。 +不幸な事に、このことによっていくつかのユーティリティ、特に +.Nm newfs +は混乱します。 +.Nm newfs +は通常 +.Nm +ボリューム名の最後の文字をパーティション識別子として解釈しようとするからです。 +.Ar a +から +.Ar c +の文字で終わらない文字列をボリューム名に使った場合には、 +.Nm newfs +に対して +.Fl v +フラグを指定してこの規則を無視するよう +.Nm newfs +に指示することが必要です。 +.\" +.It +プレックスには明示的に名前を割り当てる必要はありません。デフォルトのプレックス +名はボリューム名に文字列 \f(CW.p\fR とプレックスの番号を続けたものです。 +例えば、ボリューム +.Ar vol3 +のプレックスは +.Ar vol3.p0 , +.Ar vol3.p1 +といった風に名付けられます。 +この名前を上書きすることは可能ですがお勧めしません。 +.br +.It +プレックスと同様、サブディスクについても自動的に名前が割り当てられ、 +明示的な名前付けはお勧めしません。 +サブディスク名はプレックス名に文字列 \f(CW.s\fR とサブディスク +を識別する番号を続けたものです。例えば、プレックス +.Ar vol3.p0 +のサブディスクは +.Ar vol3.p0.s0 , +.Ar vol3.p0.s1 +といった風に名付けられます。 +.br +.It +一方、 +.Nm ドライブ +は必ず名前を付ける必要があります。これにより、ドライブを異なる場所に移動した +としても自動的に認識することが可能になります。 +ドライブ名の長さは 32 文字までです。 +.El +.Pp +使用例 +.Pp +.Nm +オブジェクトが +.Xr vinum 8 +の設定ファイル例の節に説明されているものであるとします。 +ディレクトリ +.Ar /dev/vinum +は次のように見えるでしょう: +.Bd -unfilled -offset indent +# ls -lR /dev/vinum/ /dev/rvinum +total 5 +brwxr-xr-- 1 root wheel 25, 2 Mar 30 16:08 concat +brwx------ 1 root wheel 25, 0x40000000 Mar 30 16:08 control +drwxrwxrwx 2 root wheel 512 Mar 30 16:08 drive +drwxrwxrwx 2 root wheel 512 Mar 30 16:08 plex +drwxrwxrwx 2 root wheel 512 Mar 30 16:08 rvol +drwxrwxrwx 2 root wheel 512 Mar 30 16:08 sd +brwxr-xr-- 1 root wheel 25, 3 Mar 30 16:08 strcon +brwxr-xr-- 1 root wheel 25, 1 Mar 30 16:08 stripe +brwxr-xr-- 1 root wheel 25, 0 Mar 30 16:08 tinyvol +drwxrwxrwx 7 root wheel 512 Mar 30 16:08 vol +brwxr-xr-- 1 root wheel 25, 4 Mar 30 16:08 vol5 + +/dev/vinum/drive: +total 0 +brw-r----- 1 root operator 4, 15 Oct 21 16:51 drive2 +brw-r----- 1 root operator 4, 31 Oct 21 16:51 drive4 + +/dev/vinum/plex: +total 0 +brwxr-xr-- 1 root wheel 25, 0x10000002 Mar 30 16:08 concat.p0 +brwxr-xr-- 1 root wheel 25, 0x10010002 Mar 30 16:08 concat.p1 +brwxr-xr-- 1 root wheel 25, 0x10000003 Mar 30 16:08 strcon.p0 +brwxr-xr-- 1 root wheel 25, 0x10010003 Mar 30 16:08 strcon.p1 +brwxr-xr-- 1 root wheel 25, 0x10000001 Mar 30 16:08 stripe.p0 +brwxr-xr-- 1 root wheel 25, 0x10000000 Mar 30 16:08 tinyvol.p0 +brwxr-xr-- 1 root wheel 25, 0x10000004 Mar 30 16:08 vol5.p0 +brwxr-xr-- 1 root wheel 25, 0x10010004 Mar 30 16:08 vol5.p1 + +/dev/vinum/rvol: +total 0 +crwxr-xr-- 1 root wheel 91, 2 Mar 30 16:08 concat +crwxr-xr-- 1 root wheel 91, 3 Mar 30 16:08 strcon +crwxr-xr-- 1 root wheel 91, 1 Mar 30 16:08 stripe +crwxr-xr-- 1 root wheel 91, 0 Mar 30 16:08 tinyvol +crwxr-xr-- 1 root wheel 91, 4 Mar 30 16:08 vol5 + +/dev/vinum/sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000002 Mar 30 16:08 concat.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100002 Mar 30 16:08 concat.p0.s1 +brwxr-xr-- 1 root wheel 25, 0x20010002 Mar 30 16:08 concat.p1.s0 +brwxr-xr-- 1 root wheel 25, 0x20000003 Mar 30 16:08 strcon.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100003 Mar 30 16:08 strcon.p0.s1 +brwxr-xr-- 1 root wheel 25, 0x20010003 Mar 30 16:08 strcon.p1.s0 +brwxr-xr-- 1 root wheel 25, 0x20110003 Mar 30 16:08 strcon.p1.s1 +brwxr-xr-- 1 root wheel 25, 0x20000001 Mar 30 16:08 stripe.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100001 Mar 30 16:08 stripe.p0.s1 +brwxr-xr-- 1 root wheel 25, 0x20000000 Mar 30 16:08 tinyvol.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100000 Mar 30 16:08 tinyvol.p0.s1 +brwxr-xr-- 1 root wheel 25, 0x20000004 Mar 30 16:08 vol5.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100004 Mar 30 16:08 vol5.p0.s1 +brwxr-xr-- 1 root wheel 25, 0x20010004 Mar 30 16:08 vol5.p1.s0 +brwxr-xr-- 1 root wheel 25, 0x20110004 Mar 30 16:08 vol5.p1.s1 + +/dev/vinum/vol: +total 5 +brwxr-xr-- 1 root wheel 25, 2 Mar 30 16:08 concat +drwxr-xr-x 4 root wheel 512 Mar 30 16:08 concat.plex +brwxr-xr-- 1 root wheel 25, 3 Mar 30 16:08 strcon +drwxr-xr-x 4 root wheel 512 Mar 30 16:08 strcon.plex +brwxr-xr-- 1 root wheel 25, 1 Mar 30 16:08 stripe +drwxr-xr-x 3 root wheel 512 Mar 30 16:08 stripe.plex +brwxr-xr-- 1 root wheel 25, 0 Mar 30 16:08 tinyvol +drwxr-xr-x 3 root wheel 512 Mar 30 16:08 tinyvol.plex +brwxr-xr-- 1 root wheel 25, 4 Mar 30 16:08 vol5 +drwxr-xr-x 4 root wheel 512 Mar 30 16:08 vol5.plex + +/dev/vinum/vol/concat.plex: +total 2 +brwxr-xr-- 1 root wheel 25, 0x10000002 Mar 30 16:08 concat.p0 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 concat.p0.sd +brwxr-xr-- 1 root wheel 25, 0x10010002 Mar 30 16:08 concat.p1 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 concat.p1.sd + +/dev/vinum/vol/concat.plex/concat.p0.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000002 Mar 30 16:08 concat.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100002 Mar 30 16:08 concat.p0.s1 + +/dev/vinum/vol/concat.plex/concat.p1.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20010002 Mar 30 16:08 concat.p1.s0 + +/dev/vinum/vol/strcon.plex: +total 2 +brwxr-xr-- 1 root wheel 25, 0x10000003 Mar 30 16:08 strcon.p0 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 strcon.p0.sd +brwxr-xr-- 1 root wheel 25, 0x10010003 Mar 30 16:08 strcon.p1 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 strcon.p1.sd + +/dev/vinum/vol/strcon.plex/strcon.p0.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000003 Mar 30 16:08 strcon.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100003 Mar 30 16:08 strcon.p0.s1 + +/dev/vinum/vol/strcon.plex/strcon.p1.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20010003 Mar 30 16:08 strcon.p1.s0 +brwxr-xr-- 1 root wheel 25, 0x20110003 Mar 30 16:08 strcon.p1.s1 + +/dev/vinum/vol/stripe.plex: +total 1 +brwxr-xr-- 1 root wheel 25, 0x10000001 Mar 30 16:08 stripe.p0 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 stripe.p0.sd + +/dev/vinum/vol/stripe.plex/stripe.p0.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000001 Mar 30 16:08 stripe.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100001 Mar 30 16:08 stripe.p0.s1 + +/dev/vinum/vol/tinyvol.plex: +total 1 +brwxr-xr-- 1 root wheel 25, 0x10000000 Mar 30 16:08 tinyvol.p0 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 tinyvol.p0.sd + +/dev/vinum/vol/tinyvol.plex/tinyvol.p0.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000000 Mar 30 16:08 tinyvol.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100000 Mar 30 16:08 tinyvol.p0.s1 + +/dev/vinum/vol/vol5.plex: +total 2 +brwxr-xr-- 1 root wheel 25, 0x10000004 Mar 30 16:08 vol5.p0 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 vol5.p0.sd +brwxr-xr-- 1 root wheel 25, 0x10010004 Mar 30 16:08 vol5.p1 +drwxr-xr-x 2 root wheel 512 Mar 30 16:08 vol5.p1.sd + +/dev/vinum/vol/vol5.plex/vol5.p0.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20000004 Mar 30 16:08 vol5.p0.s0 +brwxr-xr-- 1 root wheel 25, 0x20100004 Mar 30 16:08 vol5.p0.s1 + +/dev/vinum/vol/vol5.plex/vol5.p1.sd: +total 0 +brwxr-xr-- 1 root wheel 25, 0x20010004 Mar 30 16:08 vol5.p1.s0 +brwxr-xr-- 1 root wheel 25, 0x20110004 Mar 30 16:08 vol5.p1.s1 + +/dev/rvinum: +crwxr-xr-- 1 root wheel 91, 2 Mar 30 16:08 rconcat +crwxr-xr-- 1 root wheel 91, 3 Mar 30 16:08 rstrcon +crwxr-xr-- 1 root wheel 91, 1 Mar 30 16:08 rstripe +crwxr-xr-- 1 root wheel 91, 0 Mar 30 16:08 rtinyvol +crwxr-xr-- 1 root wheel 91, 4 Mar 30 16:08 rvol5 +.Ed +.Pp +プレックスやサブディスクを分離した場合には、 +この名前は予約されたままになります。 +サブディスクはそれが配置されているディスクの名を元に名付けられ、 +プレックスはサブディスクの名を元に名付けられています。 +.\" XXX +.Nm この対応付けにはまだ考慮の余地があります。 +.Ss オブジェクトの状態 +.Pp +各 +.Nm +オブジェクトには、オブジェクトに関連づけられた\fI状態\fRがあります。 +.Nm +はオブジェクトに対する操作を決定するためにこの状態を利用します。 +.Pp +.Ss ボリュームの状態 +ボリュームには次の状態がありえます。 +.sp +.Bl -hang -width 14n +.It volume_down +ボリュームが全くアクセス不能です。 +.It volume_up +ボリュームは起動しており、少なくとも一部は機能しています。すべてのプレックス +が利用可能とは限りません。 +.El +.Ss プレックスの状態 +プレックスには次の状態がありえます。 +.sp +.ne 1i +.Bl -hang -width 14n +.It faulty +プレックスは I/O エラーにより完全に停止しています。 +.It down +プレックスは管理者により停止させられています。 +.It initializing +プレックスは初期化中です。 +.sp +以下の状態は、プレックスの少なくとも一部は起動していることを表します。 +.It corrupt +プレックスエントリは少なくとも一部は起動しています。すべてのサブディスクが +利用可能ではなく、一貫性の欠如が起こっています。 +もし壊れていない他のプレックスが +なければ、ボリュームにはもはや一貫性がありません。 +.It degraded +RAID-5 プレックスエントリはアクセス可能ですが、 +1 つのサブディスクが停止しており、 +多くの I/O 要求のためには修復が必要です。 +.It flaky +プレックスは本当に起動していますが、復旧されたサブディスクを持っています。 +このサブディスクは、完全に信じることのできない状態であり、 +もし避けることが可能であれば読みたくない状態です。 +.It up +プレックスエントリは完全に起動しています。 +すべてのサブディスクが起動しています。 +.El +.sp 2v +.Ss サブディスクの状態 +サブディスクには次の状態がありえます。 +.sp +.ne 1i +.Bl -hang -width 14n +.It empty +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスクは更新されていますが、ディスク上にデータはありません。 +.It initializing +サブディスクエントリは完全に作成され、現在初期化中です。 +.sp +以下の状態は、無効なデータを表します。 +.It obsolete +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスク上の設定は更新され、データは有効ですが、ドライブが停止させられており、 +その結果更新に失敗しています。 +.It stale +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスクは更新され、データは有効ですが、ドライブが故障しており、 +更新が失われています。 +.sp +以下の状態は、有効だがアクセスできないデータを表します。 +.It crashed +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスクは更新され、データは有効ですが、ドライブが停止しています。 +故障の後サブディスクへの書き込みは行われておらず、そのためデータは有効です。 +.It down +サブディスクエントリは起動しており、有効なデータを持ち、管理者により +停止させられています。データは有効です。 +.It reviving +サブディスクは現在復活作業中です。書き込みは可能ですが、読み出しはできません。 +.sp +以下の状態は、有効なデータを持つアクセス可能なサブディスクを表します。 +.It reborn +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスクは更新され、データは有効ですが、 +ドライブが停止した後再び起動した状態です。 +更新は全く失われていませんが、サブディスクが損傷している可能性があります。 +選択の余地があればこのサブディスクからの読み出しは行わないでしょう。 +もしこのサブディスクがプレックス内で該当するアドレス空間をカバーする唯一の +サブディスクだった場合、そのような状況下ではサブディスクの状態を up に設定 +します。従ってこの状態は、読み出し要求を満たす他のサブディスクが存在することを +意味します。 +.It up +サブディスクエントリは完全に作成されました。すべてのフィールドは正常で、 +ディスクは更新され、データは有効です。 +.El +.sp 2v +.Ss ドライブの状態 +ドライブには次の状態がありえます。 +.sp +.ne 1i +.Bl -hang -width 14n +.It down +ドライブはアクセス不能です。 +.It up +ドライブは起動しており動作中です。 +.El +.sp 2v +.Sh バグと手抜かり +.Bl -enum +.It +.Nm +は新しいプロダクトです。多くのバグがあるでしょう。 +設定のメカニズムは必ずしも完全には動作していません。 +もし困ったら、問題を報告する前に次の URL を参照してください。 +http://www.lemis.com/vinum_beta.html および +http://www.lemis.com/vinum_debugging.html +.It +.Nm +モジュールを +.Nm kldunload +コマンドを使ってアンロードすることが可能です。しかしこの操作にはバグが多く、 +この操作が存在する理由は単にシステムをテストする人がやりやすいようにするため +です。代わりの方法はリブートです。 +動作確率は約 80% です。 +すなわちアンロードの 5 回に 1 回はパニックになると思われます。 +.It +.Nm +を静的にリンクしたカーネルを構築することもできますが、この方法は +全くテストされていません。もし、 +.Nm +擬似デバイスを静的リンクした状態で問題が起きた場合でも kld モジュール +で問題が再現されない限り、わざわざ問題を報告しないで下さい。 +.It +RAID-5 プレックスは初期化する必要があります。 +初期化をしなくても、通常の運用の妨げにはなりませんが、 +ディスクのうちの 1 つが故障した際に +全体の破壊を引き起こすでしょう。この初期化を強制するためのよい方法 +(または低速だとしても、パリティブロックを再構築する代替方法) +が思いつきません。 +何かいいアイデアがあれば提供を歓迎します。 +.It +カーネルと kld のバージョンの相違を検出する仕組みは実装されていません。 +.El +.Sh VINUM に関する問題のデバッグ +.Pp +.Nm +に関する問題の解決は難しい事かもしれません。この節ではいくつかのアプローチ +を紹介します。 +.Ss 設定に関する問題 +.Pp +.Nm +の設定は、比較的 (非常に) 問題にぶつかりやすいと言えます。 +問題が起きたら、まず行うべきことは設定情報の +更新を次のようにして止めることです。 +.if t .ps -3 +.if t .vs -3 +.Bd -literal +# vinum setdaemon 4 +.Ed +.if t .vs +.if t .ps +.Pp +これにより更新とディスク上の設定の更なる破壊を止めるでしょう。 +.Pp +次に、ディスク上の設定を確認します。Bourne タイプのシェルで次のようにします。 +.if t .ps -3 +.if t .vs -3 +.Bd -literal +# rm -f log +# for i in /dev/da0s1h /dev/da1s1h /dev/da2s1h /dev/da3s1h; do +> (dd if=/dev/da1h skip=8 count=6|tr -d '\e000-\e011\e200-\e377'; echo) >> log +> done +.Ed +.if t .vs +.if t .ps +.Pp +デバイスの名前は、すべての +.Nm +スライスの名前です。 +そうすると、 +.Pa log +ファイルには次のような内容が入っているはずです。 +.if t .ps -3 +.if t .vs -3 +.Bd -literal +IN VINOpanic.lemis.comdrive1}6E7~^K6T^Yfoovolume obj state up +volume src state up +volume raid state down +volume r state down +volume foo state up +plex name obj.p0 state corrupt org concat vol obj +plex name obj.p1 state corrupt org striped 128b vol obj +plex name src.p0 state corrupt org striped 128b vol src +plex name src.p1 state up org concat vol src +plex name raid.p0 state faulty org disorg vol raid +plex name r.p0 state faulty org disorg vol r +plex name foo.p0 state up org concat vol foo +plex name foo.p1 state faulty org concat vol foo +sd name obj.p0.s0 drive drive2 plex obj.p0 state reborn len 409600b driveoffset 265b plexoffset 0b +sd name obj.p0.s1 drive drive4 plex obj.p0 state up len 409600b driveoffset 265b plexoffset 409600b +sd name obj.p1.s0 drive drive1 plex obj.p1 state up len 204800b driveoffset 265b plexoffset 0b +sd name obj.p1.s1 drive drive2 plex obj.p1 state reborn len 204800b driveoffset 409865b plexoffset 128b +sd name obj.p1.s2 drive drive3 plex obj.p1 state up len 204800b driveoffset 265b plexoffset 256b +sd name obj.p1.s3 drive drive4 plex obj.p1 state up len 204800b driveoffset 409865b plexoffset 384b +.Ed +.if t .vs +.if t .ps +.Pp +最初の行は +.Nm +ラベルを含んでおり、 +.Li IN VINO +というテキストで始まっている必要があります。 +この行にはシステムの名前も含まれています。正確な定義は +.Pa /usr/src/sys/dev/vinum/vinumvar.h +に記載されています。 +保存された設定はこの行の途中から +.Li volume obj state up +というテキストで始まっています。これはディスクのセクタ 9 から始まっています。 +それ以降の出力はディスク上の設定の残りの部分を示しています。もしかすると +すべての設定を見るためには、 +.Cm dd +コマンドの +.Ar count +の引数を増やす必要があるかもしれません。 +.Pp +すべてのディスク上の設定は同じであることが必要です。そうでない場合には、 +.Pa log +ファイルの正確な中身とともに問題を報告して下さい。 +ディスク上の設定を回復するためにできることはおそらくほとんどないでしょうが、 +もしオブジェクトを生成した時に使ったファイルのコピーを保存してあれば、 +オブジェクトを再生成できるでしょう。 +.Cm create +コマンドはサブディスクのデータを変更しないので、このコマンドはデータの破壊を +引き起こしません。この種の問題に出会った場合には、 +.Cm resetconfig +コマンドを使う必要があるかもしれません。 +.Ss カーネルパニック +.Pp +.Nm +に由来すると思われるパニックを解析するには、 +デバッグ用カーネルを構築する必要 +があります。デバッグ用カーネルの構築の詳細については、オンラインハンドブック +を参照してください。 +.P +.Nm +カーネルロード可能モジュールのシンボル情報を得るには、更に作業が必要です。 +.Bl -enum +.It +可能であれば、デバッグカーネルのコピーまたはリンクを +.Pa /var/crash/kernel.gdb +に作成します。これは +.Cm gdb +の初期化ファイルがこの位置を検索するからです。 +.It +.Nm +モジュールをデバッグ情報とともに構築していることを確認しましょう。 +通常の +.Pa Makefile +であれば、これはデフォルトの設定です。 +.It +.Nm +開始後、次のコマンドを実行しましょう: +.if t .ps -3 +.if t .vs -3 +.Bd -literal +echo add-symbol-file /modules/vinum.ko \e + 0x`objdump --section-headers /modules/vinum.ko \e + | grep ' .text' \e + | awk '{print $4}'`\+`kldstat \e + | grep vinum | awk '{print $3}'` +.Ed +.if t .vs +.if t .ps +.Pp +これをファイルに格納し、実行可能にし、実行するのが最も簡単です。 +出力は次のようになるでしょう: +.if t .ps -3 +.if t .vs -3 +.Bd -literal +add-symbol-file /modules/vinum.ko 0x00005e24+0xf0f4e000 +.Ed +.if t .vs +.if t .ps +.It +.Pa /usr/src/sys/modules/vinum/.gdbinit.crash +ファイルをあなたが解析を実行したいディレクトリ (例えば +.Pa /var/crash +) にコピーし、 +.Pa .gdbinit +に名前を変えます。 +.It +.Pa /modules +に置いてあるバージョンの +.Nm +がシンボルを含んでいないと、エラーメッセージは表示されませんが、 +スタックトレースはシンボルを表示しません。 +.Nm gdb +を始める前にモジュールをチェックしましょう。 +.Bd -literal +$ file /modules/vinum.ko +/modules/vinum.ko: ELF 32-bit LSB shared object, Intel 80386, + version 1 (FreeBSD), not stripped +.Ed +.Pp +その出力が +.Pa /modules/vinum.ko +is stripped だった場合、strip されていないバージョンを見つける必要が +あります。通常、 +.Pa /usr/obj/sys/modules/vinum/vinum.ko +の中 ( +.Ar make world +を用いて +.Nm +を構築した場合) +か +.Pa /usr/src/sys/modules/vinum/vinum.ko +の中 (このディレクトリで +.Nm +を構築した場合) にあります。 +.It +もしデバッグカーネルを +.Pa /var/crash/kernel.gdb +という名前にしていない場合には、 +.Pa .gdbinit +を編集して、正しい場所を指し示すようにしてください。 +.P +シリアル接続を通してリモートデバッグをしている場合には、 +.Pa /usr/src/sys/modules/vinum/.gdbinit.crash +ファイルを +.Pa .gdbinit +という名前でデバッグを実行しているディレクトリにコピーして、 +次のコマンドで起動してください。 +.Bd -literal -indent +gdb -k +.Ed +.Pp +.Cd gdb +は自動的に接続を確立します。リモートマシンはその時点で +.Nm gdb +が動作中でなければなりません。この +.Pa .gdbinit +ファイルはシリアル接続が 38400 bps で動作するものと期待しています。 +別のスピードで動作させたい場合には、このファイルを適切に編集してください ( +.Ar remotebaud +に関する記述を探してください)。 +.It +ダンプを取ったり +.Cm gdb +を使うことにより問題を分析してください。あるいは上記のシェルスクリプトの出力 +を利用してください。次にリモートデバッグのセッションで +.Nm vinum(8) +における +.Ar debug +コマンドの利用例を示します。 +.if t .ps -3 +.if t .vs -3 +.Bd -literal +(kgdb) add-symbol-file /usr/src/sys/modules/vinum/vinum.ko 0x00005e24+0xf0f4e000 +add symbol table from file "/usr/src/sys/modules/vinum/vinum.ko" at text_addr = 0xf0f53e24? +(y or n) y +(kgdb) bt +#0 Debugger (msg=0xf0f661ac "vinum debug") at ../../i386/i386/db_interface.c:318 +#1 0xf0f60a7c in vinumioctl (dev=0x40001900, cmd=0xc008464b, data=0xf6923ed0 "", + flag=0x3, p=0xf688e6c0) at + /usr/src/sys/modules/vinum/../../dev/vinum/vinumioctl.c:109 +#2 0xf01833b7 in spec_ioctl (ap=0xf6923e0c) at ../../miscfs/specfs/spec_vnops.c:424 +#3 0xf0182cc9 in spec_vnoperate (ap=0xf6923e0c) at ../../miscfs/specfs/spec_vnops.c:129 +#4 0xf01eb3c1 in ufs_vnoperatespec (ap=0xf6923e0c) at ../../ufs/ufs/ufs_vnops.c:2312 +#5 0xf017dbb1 in vn_ioctl (fp=0xf1007ec0, com=0xc008464b, data=0xf6923ed0 "", + p=0xf688e6c0) at vnode_if.h:395 +#6 0xf015dce0 in ioctl (p=0xf688e6c0, uap=0xf6923f84) at ../../kern/sys_generic.c:473 +#7 0xf0214c0b in syscall (frame={tf_es = 0x27, tf_ds = 0x27, tf_edi = 0xefbfcff8, + tf_esi = 0x1, tf_ebp = 0xefbfcf90, tf_isp = 0xf6923fd4, tf_ebx = 0x2, + tf_edx = 0x804b614, tf_ecx = 0x8085d10, tf_eax = 0x36, tf_trapno = 0x7, + tf_err = 0x2, tf_eip = 0x8060a34, tf_cs = 0x1f, tf_eflags = 0x286, + tf_esp = 0xefbfcf78, tf_ss = 0x27}) at ../../i386/i386/trap.c:1100 +#8 0xf020a1fc in Xint0x80_syscall () +#9 0x804832d in ?? () +#10 0x80482ad in ?? () +#11 0x80480e9 in ?? () +(kgdb) f 1 +#1 0xf0f60a7c in vinumioctl (dev=0x40001900, cmd=0xc008464b, data=0xf6923ed0 "", + flag=0x3, p=0xf688e6c0) at + /usr/src/sys/modules/vinum/../../dev/vinum/vinumioctl.c:109 +Source file is more recent than executable. +109 Debugger ("vinum debug"); +.Ed +.if t .vs +.if t .ps +.Pp +デバッガから実行開始する時、フレーム 1 のソース (上の例では最後の部分) に次の +文字列が含まれていることは重要です。 +.if t .ps -3 +.if t .vs -3 +.Bd -literal +Debugger ("vinum debug"); +.Ed +.if t .vs +.if t .ps +.Pp +これはアドレス定義が正しいことを示しています。 +.El +.Pp +最初の調査で最も重要な情報は、上に示されているように +.Nm bt +(バックトレース) コマンドの出力です。 +.Sh 作者 +Greg Lehey +.Pa +.Sh 歴史 +.Nm vinum +は FreeBSD 3.0 から登場しました。 +.Sh 関連項目 +.Xr vinum 8 , +.Xr disklabel 5 , +.Xr disklabel 8 diff --git a/ja_JP.eucJP/man/man4/vn.4 b/ja_JP.eucJP/man/man4/vn.4 new file mode 100644 index 0000000000..b50f4a8497 --- /dev/null +++ b/ja_JP.eucJP/man/man4/vn.4 @@ -0,0 +1,91 @@ +.\" %NetBSD: vnd.4,v 1.1 1995/12/30 18:10:48 thorpej Exp % +.\" +.\" Copyright (c) 1995 Jason R. Thorpe. +.\" 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 for the NetBSD Project +.\" by Jason R. Thorpe. +.\" 4. Neither the name of the author 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 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. +.\" +.\" Original Revision: 1.2 +.\" jpman %Id: vn.4,v 1.3 1999/08/18 16:40:07 horikawa Stab % +.Dd December 30, 1995 +.Dt VN 4 +.Os +.Sh 名称 +.Nm vn +.Nd vnode ディスクドライバ +.Sh 書式 +.Cd "pseudo-device vn" Op Ar count +.Sh 解説 +.Nm +ドライバは、ファイルに対する、ディスクと同様のインタフェースを提供します。 +このドライバは、スワップファイルだとか、 +ミニルートやフロッピディスクイメージの作成などのような、 +さまざまな応用に役立ちます。 +.Pp +この文書は、あなたがカーネルの作りかたや、カーネル設定ファイルにおいて +どうやってディスクや疑似デバイスを正しく設定するか、 +といったことに通じていることを前提にしています。 +.Pp +.Nm vn +ドライバをサポートしたカーネルをコンパイルするためには、 +カーネル設定ファイルに次のような行を追加する必要があります: +.Bd -unfilled -offset indent +pseudo-device vn 4 #Vnode driver +.Ed +.Pp +.Ar count +はブート時にメモリを割り当てる +.Nm vn +ドライバの数です。 +この例では、4 つを越えた分の +.Nm vn +ドライバは準備されません。 +.Pp +.Nm vn +ドライバを実行時に設定するために使うユーティリティがあります。 +詳しくは、 +.Xr vnconfig 8 +を参照して下さい。 +.Sh バグ +対象となるファイルがローカルファイルシステムにない場合には、 +.Nm +ドライバはうまく機能しません。 +.Sh 関連ファイル +/dev/{,r}vn* - vn デバイスの特殊ファイル +.Pp +.Sh 歴史 +vnode ディスクドライバのオリジナルは +ユタ大学 (the University of Utah) で書かれました。 +.Sh 関連項目 +.Xr config 8 , +.Xr fsck 8 , +.Xr MAKEDEV 8 , +.Xr mount 8 , +.Xr newfs 8 , +.Xr vnconfig 8 diff --git a/ja_JP.eucJP/man/man4/vpo.4 b/ja_JP.eucJP/man/man4/vpo.4 new file mode 100644 index 0000000000..3570338ae7 --- /dev/null +++ b/ja_JP.eucJP/man/man4/vpo.4 @@ -0,0 +1,58 @@ +.\" Copyright (c) 1998, Nicolas Souchu +.\" 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. +.\" +.\" +.Dd March 5, 1998 +.\" jpman %Id: vpo.4,v 1.3 1999/09/11 08:16:16 horikawa Stab % +.Dt VPO 4 +.Os FreeBSD +.Sh 名称 +.Nm vpo +.Nd +パラレルから SCSI へのインタフェースドライバ +.Sh 書式 +.Cd "controller vpo at ppbus?" +.Pp +1 つ以上の SCSI バスに対し: +.Cd "controller scbus0 at vpo0" +.Sh 解説 +.Em vpo +ドライバの第 1 の目的は、 +Iomega ZIP ドライブに組み込まれた Adaptec AIC-7110 SCSI コントローラへの +アクセスを提供することです。 +しかし、Iomega Jaz Traveller のパラレルから SCSI へのインタフェースでも +動作するでしょう。 +.Sh 関連項目 +.Xr ppbus 4 , +.Xr scsi 4 , +.Xr sd 4 +.Sh 歴史 +.Nm +マニュアルページは +.Fx 3.0 +で初めて登場しました。 +.Sh 作者 +このマニュアルページは +.An Nicolas Souchu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/vr.4 b/ja_JP.eucJP/man/man4/vr.4 new file mode 100644 index 0000000000..515d06d935 --- /dev/null +++ b/ja_JP.eucJP/man/man4/vr.4 @@ -0,0 +1,164 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: vr.4,v 1.2 1998/12/05 09:31:25 rnordier Exp % +.\" jpman %Id: vr.4,v 1.3 2000/01/06 12:54:50 horikawa Stab % +.\" +.Dd November 22, 1998 +.Dt VR 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm vr +.Nd +VIA Technologies VT3043 と VT86C100A イーサネットデバイスドライバ +.Sh 書式 +.Cd "device vr0" +.Sh 解説 +.Nm +ドライバは、VIA Technologies 社の VT3043 Rhine I と +VT86C100A Rhine II のファーストイーサネットチップを搭載した +PCI イーサネットカードのサポートを提供します。 +このサポート範囲には、D-Link DFE530-TX やその他諸々の安価な +ファーストイーサネットカードが含まれます。 +.Pp +VIA Rhine チップはバスマスタ DMAを使用し、DEC 21x4x "tulip" チップに +似たデザインのソフトウェアインタフェースを持っています。大きな違いは、 +Rhine チップの受信フィルタの方がはるかに単純だということです。tulip の +ように、送信 DMA エンジン経由で特殊な設定フレームをダウンロードしたり +せずに、Rhine はレジスタ経由でプログラミングします。また、送信 DMA +バッファ、受信 DMA バッファとも、longword で境界調整する必要があることも +違います。Rhine チップは、外部にある物理層デバイスとは MII バスを通して +接続されるように設計されています。また、10Mbps と 100Mbps の両方の +スピードが、全二重、半二重のどちらのモードでもサポートされています。 +.Pp +.Nm +ドライバは次のようなメディアタイプをサポートします。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプやオプションの自動選択を使用可能にします。 +ユーザは、 +.Pa /etc/rc.conf +ファイルにメディアオプションを書き加えることで、 +自動選択されたモードを手動で強制的に変更できます。 +.It 10baseT/UTP +10Mbps に設定します。 +.Ar mediaopt +は、 +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために使用可能です。 +.It 100baseTX +100Mbps (ファストイーサネット) に設定します。 +.Ar mediaopt +は +.Ar full-duplex +または +.Ar half-duplex +モードを選択するために使用可能です。 +.El +.Pp +.Nm +ドライバは、次のメディアオプションをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +full duplex に設定します。 +.It half-duplex +half duplex に設定します。 +.El +.Pp +アダプタがサポートしているときのみ、100baseTX メディアタイプは使用可能です。 +このデバイスを設定するためにもっと多くの情報が必要な場合は +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "vr%d: couldn't map memory" +致命的な初期化エラーが起こりました。 +.It "vr%d: couldn't map interrupt" +致命的な初期化エラーが起こりました。 +.It "vr%d: watchdog timeout" +デバイスがネットワークに応答しなくなったか、ネットワークの +接続 (ケーブル) に問題があります。 +.It "vr%d: no memory for rx list" +ドライバがレシーバリング用の mbuf の確保に失敗しました。 +.It "vr%d: no memory for tx list" +パッドバッファを確保、または mbuf チェインをクラスタにまとめるときに、 +トランスミッタリング用の mbuf の確保に失敗しました。 +.It "vr%d: chip is in D3 power state -- setting to D0" +パワーマネージメントをサポートするアダプタにのみ、このメッセージが出ます。 +オペレーティングシステムの中にはシャットダウン時にコントローラを +ローパワーモードにするものがあり、チップになにか新しく設定する前に +この状態から脱出しなければならないのですが、PCI BIOS の中にはこの脱出に +失敗してしまうものもあります。コントローラはこの D3 状態になると設定状態が +揮発してしまうので、もし BIOS が規定の時間内にもとの状態に戻せなかったら、 +その後の設定は正常に実行できません。 +ドライバはこの状態の検出し、アダプタを D0 (フルパワー) 状態に +戻そうとしますが、これでは、ドライバが完全に動作する状態に戻すためには +不十分かもしれません。 +ブート時にこのメッセージが表示され、ドライバがこのデバイスを +ネットワークインタフェースとして接続できない場合は、さらに 1 回ウォームブート +させて、デバイスを適切に設定させる必要があります。 +.Pp +他のオペレーティングシステムからウォームブートするときのみに、この状態は +起こります。 +.Fx +のブートに先だってシステムをシャットダウンする場合、カードを正常に +設定しておく必要があります。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Rs +.%T VIA Technologies VT86C100A データシート +.%O http://www.via.com.tw +.Re +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +に初めて登場しました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 +.Sh バグ +.Nm +ドライバは、送信前には常に、送信 mbuf チェーンを longword 境界に整列した +バッファへコピーすることにより、Rhine チップの暴走を避けます。 +バッファ境界が正しくない場合、 +チップは与えられたバッファアドレスを丸めてしまい、 +間違った境界アドレスから DMAを開始してしまいます。 +バッファのコピーはシステム性能を低下させますが、不可避です。 +(Pentium II のような) 速いマシンでは、性能への影響はずっと少ないでしょう。 diff --git a/ja_JP.eucJP/man/man4/vx.4 b/ja_JP.eucJP/man/man4/vx.4 new file mode 100644 index 0000000000..331b3c2ce6 --- /dev/null +++ b/ja_JP.eucJP/man/man4/vx.4 @@ -0,0 +1,102 @@ +.\" +.\" Copyright (c) 1996, Fred Gray +.\" 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 David Greenman. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: vx.4,v 1.7 1998/03/12 07:30:39 charnier Exp % +.\" jpman %Id: vx.4,v 1.3 1999/08/15 14:20:25 horikawa Stab % +.\" +.Dd January 15, 1996 +.Dt VX 4 i386 +.Os +.Sh 名称 +.Nm vx +.Nd +PCI イーサネットデバイスドライバ +.Sh 書式 +.Cd "device vx0" +.Sh 解説 +.Nm vx +ドライバは、 +3Com の 3c590 と 3c595、すなわち EtherLink III と Fast EtherLink III の +PCI イーサネットカードを、10 Mbps モードでサポートします。 +次の +.Xr ifconfig 8 +コマンドへの link フラグによって、媒体を選択可能です。 +.Pp +.Bl -tag -width LINK0X -compact +.It Em link0 +AUI ポートを使用します。 +.It Em link1 +BNC ポートを使用します。 +.It Em link2 +UTP ポートを使用します。 +.El +.Sh 診断 +.Bl -diag +.It "vx%d: not configured; kernel is built for only %d devices." +システムにあるアダプタ数に対して、カーネル設定ファイル内の +デバイス数が十分ではありません。 +設定ファイルにデバイスを追加し、 +カーネルを再構築してリブートして下さい。 +.Pp +他のすべての診断はハードウェアの問題かドライバのバグを示しています。 +.Sh 警告 +初期のいくつかの 3c590 カードには問題があり、 +受信あふれの被害を受けます。 +その結果として、パケット損失を引き起こします。 +作者は、3 Com から提供される情報を基に、 +このようなリビジョンの検査を実装しようとしました。 +しかし、検査の出力の大部分は疑わしい警告にすぎません。 +.Pp +カードのバスマスタリング機能を使用せず +ポーリングモードの I/O のみを使用することから、 +このドライバの性能はいくらか制限されます。 +.Sh バグ +.Nm vx +ドライバはいくつかのシステム上でワームブートの後、アダプタを正しく +リセットしないことが知られています。 +.Pp +.Nm vx +ドライバは、サポートしているとされるカードのすべてのモデルで +徹底的にテストを行なっているわけではありません。 +.Sh 歴史 +.Nm vx +デバイスドライバは +.Fx 2.1 +で最初に登場しました。 +これは +.Nm ep +ドライバに由来していて、多くの制限を継承しています。 +.Sh 作者 +.Nm vx +デバイスドライバとこのマニュアルページは、 +.An Herb Peyerl +の作業とその他の多くの人の援助を基に +.An Fred Gray Aq fgray@rice.edu +によって書かれました。 diff --git a/ja_JP.eucJP/man/man4/wb.4 b/ja_JP.eucJP/man/man4/wb.4 new file mode 100644 index 0000000000..50529456ce --- /dev/null +++ b/ja_JP.eucJP/man/man4/wb.4 @@ -0,0 +1,176 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: wb.4,v 1.2 1998/12/05 09:31:25 rnordier Exp % +.\" jpman %Id: wb.4,v 1.3 2000/01/06 12:55:02 horikawa Stab % +.\" +.Dd November 4, 1998 +.Dt WB 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm wb +.Nd +Winbond W89C840F ファーストイーサネットデバイスドライバ +.Sh 書式 +.Cd "device wb0" +.Sh 解説 +.Nm +ドライバは、Winbond W89C840F ファーストイーサネットコントローラを +利用した、PCI イーサネットアダプタ、 +及び組み込み型コントローラをサポートしています。 +このドライバには、Trendware TE100-PCIE など、 +他の様々な安価なボードを含んでいます。 +840F と 940F を混同しないでください。 +940F は NE2000 クローンのため、10Mbps のみサポートしています。 +.Pp +Winbond コントローラは、バスマスタ DMA を使っています。 +また、DECの 'tulip' と同性能になるようにデザインされています。 +DEC の標準な設計とは、いくつかの点において異なっています: +コントロールレジスタとステータスレジスタは +8 バイトではなく 4 バイト間隔になっています。 +また、受信フィルタの設定は、 +DMA 転送エンジンを経由した、特別なセットアップフレームを +ダウンロードする方式ではなく、レジスタを通して行います。 +外部の PHY を使うことによって、Winbond チップは、全二重または半二重に +よる、10Mbps および 100Mbps の転送速度をサポートしています。 +.Pp +.Nm +ドライバは次に挙げるメディアタイプをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプ及びオプションの自動設定を有効にします。このオプションは、 +Winbond コントローラに取り付けられた PHY チップが +NWAY オートネゴシエーションをサポートする場合のみ利用可能です。 +.Pa /etc/rc.conf +にメディアオプションを追加することによって、 +自動的に設定されたモードをユーザが手動で変更可能となります。 +.It 10baseT/UTP +転送方式を 10Mbps に設定します。 +.Ar mediaopt +オプションを指定することによって、 +.Ar 全二重 +モード、または +.Ar 半二重 +モードのどちらかひとつを利用できます。 +.It 100baseTX +転送方式を 100Mbps (ファーストイーサネット) に設定します。 +.Ar mediaopt +オプションを指定することによって、 +.Ar 全二重 +モード、または +.Ar 半二重 +モードのどちらかひとつを利用できます。 +.El +.Pp +.Nm +ドライバは次に挙げるメディアオプションをサポートしています: +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +強制的に全二重に設定します。 +.It half-duplex +強制的に半二重に設定します。 +.El +.Pp +100baseTX メディアタイプは、アダプタがサポートしているときに限って使用可能 +であることに注意してください。 +このデバイスの設定に関する、さらに詳しい情報については +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "wb%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "wb%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "wb%d: watchdog timeout" +デバイスがネットワークに応答するのを停止したか、あるいは、 +ネットワーク接続 (ケーブル) に関する問題が発生しました。 +.It "wb%d: no memory for rx list" +ドライバは、mbuf を受信リングに割り当てられませんでした。 +.It "wb%d: no memory for tx list" +パッドバッファを割り当てる際、 +あるいは mbuf チェーン をクラスタに分割する際に、 +ドライバは mbuf を送信リングに割り当てられませんでした。 +.It "wb%d: chip is in D3 power state -- setting to D0" +このメッセージは、 +パワーマネジメントをサポートするアダプタだけにあてはまります。 +オペレーティングシステムによっては、 +シャットダウン時にコントローラを低消費電力モードに設定します。 +しかし、PCI BIOS によっては、チップの設定を開始するまでに、 +チップを低消費電力モードから回復させることができないものがあります。 +コントローラは D3 状態になると、PCI に関する設定を全て失ってしまいます。 +従って、 +BIOS が時間内にコントローラをフルパワーモードに戻すことができない場合、 +PCI に関する設定を正常に行うことができません。 +ドライバはこのような状態を検知したとき、アダプタを D0 (フルパワー) +状態に戻すことを試みます。 +しかし、ドライバを完全に操作可能な状態まで、 +復帰させることができないことがあります。 +もしブート時にこのようなメッセージが表示され、 +ドライバがネットワークインタフェースとして +デバイスにアタッチできなかった場合には、 +デバイスを正しく設定するために +もう一回ウォームブートを行う必要があります。 +.Pp +このような状況は、他のオペレーティングシステムから +ウォームブートを行った場合にのみ発生します。 +.Fx +をブートする前にマシンの電源を落しておけば、 +カードは正しく認識されるはずです。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +で登場しました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が作成しました。 +.Sh バグ +接続先がモードを切り換える際、Winbond チップは +奇妙な振舞いを起しているように思われます。 +例として、両方を 10Mbps 半二重の状態にセットしたとします。 +それから片方を 100Mbps 全二重に設定すると、 +Winbond チップのレシーバは RX 記述子の至るところにゴミを +書き始めます。 +.Nm +ドライバは、コントローラチップと付属の PHY を +強制的にリセットすることによってこの問題に対処します。 +荒治療ではありますが、このような状態から正しく回復するための +唯一の方法に思えます。 + diff --git a/ja_JP.eucJP/man/man4/wd.4 b/ja_JP.eucJP/man/man4/wd.4 new file mode 100644 index 0000000000..ccf0d1d9da --- /dev/null +++ b/ja_JP.eucJP/man/man4/wd.4 @@ -0,0 +1,106 @@ +.\" +.\" Copyright (c) 1994 Wilko Bulte +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: wd.4,v 1.10 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: wd.4,v 1.3 1999/08/18 16:40:15 horikawa Stab % +.\" +.Dd August 31, 1994 +.Dt WD 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm wd +.Nd +一般的な WD100x/IDE ディスクコントローラ用ドライバ +.Sh 書式 +.Cd "controller wdc0 at isa? port" \&"IO_WD1\&" bio irq 14 +.Cd "disk wd0 at wdc0 drive 0 +.Cd "disk wd1 at wdc0 drive 1 +.Pp +CMD640b IDE コントローラ用: +.Cd "options" \&"CMD640\&" +.Sh 解説 +このドライバで、Western Digital WD100x シリーズをエミュレートする +コントローラに接続されたディスクにアクセスできるようになります。 +これには、WD1003 ST412 コントローラ、WD1007 ESDI コントローラ、 +そしてほとんどのマザーボードにある一般的な IDE コントローラを含みます。 +.Pp +WD100x シリーズとの互換性については、通常、コントローラの資料に説明があります。 +.Pp +.Ar flags +パラメータを使って、ドライバにヒントや指令を伝えることができます。 +.Pp +16 ビット整数のフラグがドライブ毎にあり、 +それぞれに 4 (訳注: 実際には 6) 個のビットフィールドがあります: +.\" By mzaki@e-mail.ne.jp (Mar 1 1999) +.Bl -tag -width 0x0000 -offset 1c +.It 0x8000 +ドライブの 32 ビット転送機能が使えれば使います。 +.It 0x4000 +ドライブがスリープモードから脱しているところであるようならば、 +混乱しているとみなして再初期化します。 +.It 0x2000 +最近の PCI チップセットにあるバスマスタ DMA 機能があるか調べて利用します。 +.It 0x1000 +デフォルトの CHS アドレッシングではなく、LBA アドレッシングを使います。 +.It 0x0f00 +ヘッドの数を ((flags & 0xf00)>>8) と見なして、 +それに合うようにシリンダ数を計算し直します。 +.It 0x00ff +ドライブのマルチセクタ転送モードが使えれば使います。 +最大で (flags & 0x00ff) セクタの転送を試みます。 +.El +.Pp +このフラグは drive 行に 16 ビット整数で指定するか、 +あるいは controller 行に 32 ビット整数で指定します。 +この場合、上位 16 ビットが番号の大きなドライブに適用されます。 +.Pp +.Dq Dv CMD640 +オプションによって、CMD640b IDE コントローラの欠陥に対処するようになります。 +このオプションが指定されていて、 +かつ PCI サブシステムがこのチップを検出した場合には、 +プライマリとセカンダリのコントローラは同時には使われません。 +.Sh 関連ファイル +.Bl -tag -width Pa -compact +.It Pa /dev/wd* +ディスクのブロックデバイスノード +.It Pa /dev/rwd* +ディスクのキャラクタデバイスノード +.It Pa /sys/i386/conf/GENERIC +.\" 原文 +.\" sample generic kernel config file for (a.o.) wd based systems +.\" の a.o. ってなんでしょう？ +wd によるシステムのためのジェネリックカーネルの設定ファイルのサンプル +.It Pa /sys/i386/isa/wd.c +ドライバのソース +.El +.Sh 関連項目 +.Xr bad144 8 +.Sh 注釈 +このコントローラとディスクの組合わせは、 +自動的にバッドブロックを処理をするための機構を備えていません。 +バッドブロックを調べるには +.Xr bad144 8 +を実行する必要があります。 diff --git a/ja_JP.eucJP/man/man4/wfd.4 b/ja_JP.eucJP/man/man4/wfd.4 new file mode 100644 index 0000000000..60cb5b6a6a --- /dev/null +++ b/ja_JP.eucJP/man/man4/wfd.4 @@ -0,0 +1,244 @@ +.\" Copyright (c) 1997 Junichi Satoh +.\" 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. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY FreeBSD, 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 FreeBSD, Inc. OR CONTRIBUTORS BE +.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: wfd.4,v 1.5 1998/08/31 16:41:07 wosch Exp % +.\" jpman %Id: wfd.4,v 1.3 2000/07/05 04:58:40 horikawa Stab % +.\" +.Dd January 16, 1998 +.Dt WFD 4 +.Os FreeBSD +.Sh 名称 +.Nm wfd +.Nd +ATAPI フロッピドライバ (LS-120 フロッピドライバ) +.Sh 書式 +.Cd options ATAPI +.Cd options ATAPI_STATIC +.Cd device wfd0 +.Pp +.Sh 解説 +.Nm +ドライバは +.Em ATAPI +フロッピディスクや、典型的な LS-120 スタイルである 120mb/1.4mb +フロッピドライブをサポートします。一般的にインタフェースは +.Xr wd 4 , +.Xr sd 4 , +.Xr od 4 +に書かれていることと類似しています。 +.Pp +ブート時に IDE コントローラがプローブされるとき、デバイスを検出するた +めに +.Em IDE +バスが調べられます。検出されたもののうち +.Sq Em Floppy +かつ +.Sq Em removable +型と返されるどのデバイスも +.Nm +ドライバに接続されます。 +以降では、最初に検出されたデバイスは +.Em wfd0 +として接続され、次は +.Em wfd1 +と以下同様に続きます。 +.\" 1.5.2.4 で wfd1 になっている +.Pp +LS-120 ドライブと共に使われるとき、このドライバは次のタイプのフロッピ +ディスクを読み書きします。 +.Bl -tag -width 1.25MB -compact +.It 120mb +.It 1.44mb +.It 1.25mb (PC-9801 シリーズのフォーマット形式) +.It 1.2mb +.It 720kb +.El +.Sh パーティション +.Nm +ドライバはディスクに対し、2 つの階層のパーティションが可能です。 +一つ目の層は +.Dq スライス層 +と呼ばれるもので、ディスク中の +.Tn FreeBSD +領域と、その他のオペレーティングシステムで使用されている領域を分離するた +めに用います。2 つ目は、 +.Xr disklabel 5 +による純然たる +.Bx 4.4 +のパーティショニングの実行で、 +.Tn FreeBSD +スライスを独自のファイルシステムに細分するために用いられます。 +さらに詳しい事は、 +.Xr fdisk 8 +や +.Xr disklabel 8 +をそれぞれ参照してください。 +.Pp +初期化されていないディスクが開かれると、ディスク全体まで及ぶ仮想的な +.Tn FreeBSD +スライスによって、スライステーブルが初期化されます。同様に、初期化され +ていない (あるいは非 +.Tn FreeBSD ) +スライスが開かれると、ドライブおよびスライス全体を含む単一 +.Sq Li c +パーティションによって返されるパラメータで、ディスクラベルが初期化されます。 +.Sh 使用例 +スライスコードを使うかどうかに依存しますが、LS-120/ZIP ディスクを作る +事は、普通より少しばかり複雑です。LS-120 フロッピは一般的にフロッピ +デバイスと考えられ、スライステーブルを有効にしません。一方、同じドライバ +を用いる Zip ディスクは、ベンダがハードディスクであるとみなしています。 +そのため、互換性のために、スライステーブルを使うべきです。 +.Pp +このドライバは、スライステーブルを用いるディスクと用いないディスクの、 +両タイプのディスクを扱います。しかしその互換性のため、一般的にベンダの特性に +合ったディスクを作るべきです。 +.Pp +スライステーブルのない UFS LS-120 ディスクを作るためには、最初にその +ディスクにスライステーブルがないことを確認して下さい。 +.Dl # dd if=/dev/zero of=/dev/wfd0 count=16 + +次に、ディスクラベルを書き込みます。 +.Dl # disklabel -rw wfd0 fd120m + +そして、普通通り newfs を行います。 +.Dl # newfs /dev/rfd0a +.Fi + +スタンダードな 1.44mb のフロッピを LS-120 ドライブに作るためには、同様 +の手順に従いますが、 +.Nm disklabel +コマンドを使う時には +.Ar fd1440 +をディスクレイアウトとして使います。 +.Sh カーネルの設定 +唯一、一つの +.Nm +デバイスが設定ファイルの中に必要です。データ構造は +.Tn IDE +バスで検出されたディスクとして、動的に割り当てられます。 +.Sh 注 +このドライバは +.Xr wdc 4 +IDE/ATAPI ディスクコントローラのドライバにアタッチされます。また、IDE +コントローラが設定されておらず、カーネル内で有効になっていない限り、動 +作しません。 +.Sh バグ +フロッピのフォーマットは、まだサポートされていません。 +.Pp +このドライバはまだベータバージョンです。もし問題が生じた場合は +.Aq bugs@FreeBSD.org +と作者に報告してください。 +.Sh 関連ファイル +.Bl -tag -width /dev/rwfdXXXXX -compact +.It Pa /dev/rwfd Ns Ar u +raw モードの +.Tn ATAPI +フロッピ +.Ar u +は、パーティショニングされていないデバイスとしてアクセスされます。 +.Sm off +.It Pa /dev/wfd Ar u Pa s Ar n +.Sm on +ブロックモードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +スライス +.Ar n +は、パーティショニングされていないデバイスとしてアクセスされます。 +.Sm off +.It Pa /dev/rwfd Ar u Pa s Ar n +.Sm on +raw モードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +スライス +.Ar n +は、パーティショニングされていないデバイスとしてアクセスされます。 +.It Pa /dev/wfd Ns Ar u Ns Ar p +ブロックモードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +の最初の +.Tn FreeBSD +スライスのパーティション +.Ar p +。 +.It Pa /dev/rwfd Ns Ar u Ns Ar p +raw モードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +の最初の +.Tn FreeBSD +スライスのパーティション +.Ar p +。 +.Sm off +.It Xo +.Pa /dev/wfd Ar u Pa s Ar n Ar p +.Xc +.Sm on +ブロックモードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +の +.No Ar n +番目のスライスに存在するパーティション +.Ar p +。 +.Sm off +.It Xo +.Pa /dev/rwfd Ar u Pa s Ar n Ar p +.Xc +.Sm on +raw モードの +.Tn ATAPI +フロッピディスクユニット +.Ar u +の +.No Ar n +番目のスライスに存在するパーティション +.Ar p +。 +.El +.Sh 関連項目 +.Xr fdisk 1 , +.Xr wcd 4 , +.Xr wd 4 , +.Xr disklabel 5 , +.Xr disklabel 8 +.Sh 作者 +.An Junichi\ Satoh\ Aq junichi@jp.FreeBSD.org +.Sh 歴史 +.Nm +ドライバは、 +.Fx 2.2.6 +で最初に現れました。 diff --git a/ja_JP.eucJP/man/man4/worm.4 b/ja_JP.eucJP/man/man4/worm.4 new file mode 100644 index 0000000000..162be17a71 --- /dev/null +++ b/ja_JP.eucJP/man/man4/worm.4 @@ -0,0 +1,106 @@ +.\" +.\" Copyright (C) 1996 +.\" interface business GmbH +.\" Tolkewitzer Strasse 49 +.\" D-01277 Dresden +.\" F.R. Germany +.\" +.\" All rights reserved. +.\" +.\" Written by Joerg Wunsch +.\" +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY +.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT +.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR +.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE +.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH +.\" DAMAGE. +.\" +.\" %Id: worm.4,v 1.17 1998/10/16 00:26:23 ken Exp % +.\" +.\" jpman %Id: worm.4,v 1.3 1999/08/18 16:40:22 horikawa Stab % +.\" WORD FreeBSD ports collection FreeBSD ports コレクション (ports.7) +.\" " +.Dd October 15, 1998 +.Dt WORM 4 +.Os FreeBSD +.Sh 名称 +.Nm worm +.Nd 1 回書き込み型 (CD-R) ディスクドライバ +.Sh 書式 +ありません。 +.Sh 解説 +.Nm worm +ドライバは +.Fx 3.0 +以前の FreeBSD リリースで提供されていました。 +.Pp +FreeBSD の +.Tn SCSI +レイヤは +.Fx 3.0 +では CAM に従った +.Tn SCSI +レイヤに置き換えられました。 +新しい +.Tn SCSI +レイヤは +.Xr worm 4 +ドライバを含んでいませんし、将来も含まないでしょう。 +おそらく、将来 CD-R/CD-RW/DVD ドライブのカーネル内サポートが +.Xr cd 4 +ドライバを通じて実装されるでしょう。 +WORM, CD-R, CD-RW のドライブで CD に書き込みをしたいユーザは、 +.Nm cdrecord +を使ってください。これは FreeBSD ports コレクションに含まれています。 +.Pp +.Xr cd 4 +ドライバは CD, CD-R, CD-RW のドライブへの読み込み専用の +アクセスを提供しています。 +これは CDROM コマンドセットをサポートした WORM ドライブも同様です。 +ですから、WORM ドライブ中の CD をマウントしたいユーザは、 +代わりに +.Xr cd 4 +ドライバを使ってください。 +.Sh 関連項目 +.Xr close 2 , +.Xr ioctl 2 , +.Xr open 2 , +.Xr write 2 , +.Xr cd 4 , +.Xr pass 4 , +.Xr xpt 4 +.Sh 作者 +.Nm +ドライバの最初の骨組みは +.An Peter Dufault +が 1995 年 5 月に書きました。 +その後 1996 年 1 月に +.ie t J\(:org Wunsch +.el Joerg Wunsch +が改良して実際に使えるようになりました。 +.Sh 歴史 +.Nm +ドライバは +.Fx 2.1 +に登場して、 +.Fx 3.0 +で CAM +.Tn SCSI +レイヤが登場したのにともなってなくなりました。 diff --git a/ja_JP.eucJP/man/man4/wt.4 b/ja_JP.eucJP/man/man4/wt.4 new file mode 100644 index 0000000000..1b8677e89a --- /dev/null +++ b/ja_JP.eucJP/man/man4/wt.4 @@ -0,0 +1,46 @@ +.\" +.\" Copyright (c) 1994 James A. Jegers +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: wt.4,v 1.4 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: wt.4,v 1.3 1999/09/26 13:27:13 horikawa Stab % +.\" +.Dd July 10, 1995 +.Dt WT 4 i386 +.Os +.Sh 名称 +.Nm wt +.Nd +Archive/Wangtek カートリッジテープドライバ +.Sh 書式 +.Cd "device wt0 at isa? port 0x300 bio irq 5 drq 1" +.Sh 解説 +.Nm wt +ドライバは以下の Archive と Wangtek のボードのサポートを提供します: +.Pp +.Bl -tag -width -offset indent -compact +.It QIC-02 +.It QIC-36 +.El +.Pp +.Sh 関連項目 +.Xr intro 4 diff --git a/ja_JP.eucJP/man/man4/xl.4 b/ja_JP.eucJP/man/man4/xl.4 new file mode 100644 index 0000000000..b6f20c186c --- /dev/null +++ b/ja_JP.eucJP/man/man4/xl.4 @@ -0,0 +1,191 @@ +.\" Copyright (c) 1997, 1998 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: xl.4,v 1.3 1998/12/05 09:36:15 rnordier Exp % +.\" jpman %Id: xl.4,v 1.3 1999/09/11 08:16:30 horikawa Stab % +.\" +.Dd August 16, 1998 +.Dt XL 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm xl +.Nd +3Com Etherlink XL および Fast Etherlink XL イーサネットデバイスドライバ +.Sh 書式 +.Cd "device xl0" +.Sh 解説 +.Nm +ドライバは、3Com の「ブーメラン (boomerang)」と「サイクロン (cyclone)」の +バスマスタ Etherlink XL チップに基づいた、 +PCI イーサネットアダプタと内蔵コントローラをサポートします。 +これには 3c900-TP, 3c900-COMBO, 3c905-TX, 3c905-T4, 3c905B-TP, 3c905B-T4, +3c905B-TX, それに一部の Dell Optiplex や Dell Precision デスクトップマシン +と一部の Dell Latitude ラップトップドッキングステーションに内蔵される +イーサネットハードウェア 3c905-TX と 3c905B-TX が含まれます。 +.Pp +Etherlink XL チップは内蔵の 10baseT, 10base2 と 10base5 のトランシーバ、 +および外付の PHY トランシーバ用の MII バスをサポートしています。 +3c905 シリーズは全二重および半二重での 10/100 Mbps のサポートに +通常ナショナルセミコンダクター社の NS 83840A 10/100 PHY を使用しています。 +.\" (訳注) National Semiconductor の日本法人のウェブサイトでは +.\" 米国本社は「ナショナルセミコンダクター社」と表記されているので合わせる。 +.\" By mihara@prd.fc.nec.co.jp (Mar 9, 1999) +3c905B アダプタは以前のドライバとの互換性を保つために MII 上にマップされた +内蔵の自動ネゴシエーションロジックを持っています。 +3c905-TX や 3c905B-TX のような Fast Etherlink XL アダプタは +全二重および半二重モードで +10 Mbps もしくは 100 Mbps のデータレートをサポートしており、 +それらのモードは手動での設定の他、 +自動ネゴシエーションによって +接続先との間での最高のモードに設定することもできます。 +.Pp +.Nm +ドライバは以下のメディアタイプをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It autoselect +メディアタイプとオプションの自動選択を有効にします。 +3c905 と 3c905B のアダプタで、 +PHY が外付されているか自動ネゴシエーションロジックが内蔵されている場合のみ、 +このオプションを使用できます。 +3c900 アダプタではドライバは EEPROM において指定されているモードを選択します。 +ユーザは +.Pa /etc/rc.conf +にメディアオプションを追加することによって、この設定を変更できます。 +.It 10baseT/UTP +10 Mbps で動作するように設定します。 +.Ar mediaopt +オプションによって +.Ar full-duplex +か +.Ar half-duplex +モードを選択できます。 +.It 100baseTX +100 Mbps (ファーストイーサネット) で動作するように設定します。 +.Ar mediaopt +オプションによって +.Ar full-duplex +か +.Ar half-duplex +モードを選択できます。 +.It 10base5/AUI +AUI トランシーバを有効にします。 +(AUI トランシーバは COMBO カードでのみ提供されています。) +.It 10base2/BNC +BNC coax トランシーバを有効にします。 +(BNC coax トランシーバは COMBO カードでのみ提供されています。) +.El +.Pp +.Nm +ドライバは以下のメディアオプションをサポートしています。 +.Pp +.Bl -tag -width xxxxxxxxxxxxxxxxxxxx +.It full-duplex +強制的に全二重の動作に設定します。 +.It half-duplex +強制的に半二重の動作に設定します。 +.El +.Pp +100baseTX のメディアタイプはサポートされているアダプタでのみ +使うことができます。 +このデバイスを設定する上での詳細については +.Xr ifconfig 8 +を参照してください。 +.Sh 診断 +.Bl -diag +.It "xl%d: couldn't map memory" +致命的な初期化エラーが発生しました。 +.It "xl%d: couldn't map interrupt" +致命的な初期化エラーが発生しました。 +.It "xl%d: device timeout" +デバイスがネットワークに対して応答しなくなったか、 +ネットワーク接続 (ケーブル) に問題があります。 +.It "xl%d: no memory for rx list" +ドライバは受信リング用の mbuf の確保に失敗しました。 +.It "xl%d: no memory for tx list" +パディング用バッファを確保する際、 +もしくは mbuf チェーンをたたんでクラスタへ変換する際、 +ドライバは送信リング用の mbuf の確保に失敗しました。 +.It "xl%d: command never completed!" +3c90x ASIC へ発行されたコマンドの完了に時間がかかっています。 +ドライバは次のコマンドを実行する前に +ステータスレジスタの「コマンド実行中」ビットがクリアされるまで待ちます。 +このビットはまれにクリアされないことがあります。 +無限の待ちループに陥ることを避けるために、 +ドライバはこのビットを有限回数ポーリングした後あきらめて、 +このメッセージを出力します。 +このメッセージは低速のマシンではドライバの初期化中に出力されることもあります。 +このメッセージが出力されてもドライバが正常に機能しているようであれば、 +おそらくこのメッセージは無視することができるでしょう。 +.It "xl%d: chip is in D3 power state -- setting to D0" +このメッセージは 3c905B (電源管理がサポートされている) +にのみ適用されるものです。 +オペレーティングシステムによってはシャットダウン時に +3c905B を低電力モードに設定します。 +また PCI BIOS には、 +チップの設定の際に、チップをこの状態から脱出させられないものがあります。 +3c905B は D3 状態ではすべての PCI 設定を失うため、 +BIOS がアダプタを全電力モードに戻すことが遅れると +設定を正しくおこなうことができません。 +ドライバはこの状態を検出しアダプタを D0 (全電力) 状態に戻そうとしますが、 +これだけではドライバが完全に動作できる状態としては十分ではありません。 +このメッセージがブート時に出力されて、 +ドライバがデバイスをネットワークインタフェースとして追加できなかったら、 +デバイスが正しく設定できるように +2 回目のウォームブートを行う必要があるでしょう。 +.Pp +この状態は他のオペレーティングシステムから +ウォームブートを行ったときのみ発生します。 +.Bx Free +をブートする前にシステムの電源を落していたら、カードは正常に設定されます。 +.It "xl%d: WARNING: no media options bits set in the media options register!" +3c905-TX アダプタを内蔵した Dell Latitude のドッキングステーションで +このドライバを使っているときに、この警告メッセージが表示されることがあります。 +この機器でのメディアオプションレジスタの「MII 有効」ビットは、 +MII が使用可能な状態 (3c905-TX は常に外部 PHY トランシーバを使用します) +でもセットされません。 +ドライバは PCI デバイス ID に基づいて正しいメディアタイプを推測しようとします。 +ドライバの作者はこれを製造上の欠点だと考えており、 +ドライバはこの状態では沢山のノイズ (訳注: メッセージ) を出すようにしています。 +.El +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 3.0 +で最初に登場しました。 +.Sh 作者 +.Nm +ドライバは +.An Bill Paul Aq wpaul@ctr.columbia.edu +が書きました。 diff --git a/ja_JP.eucJP/man/man4/yp.4 b/ja_JP.eucJP/man/man4/yp.4 new file mode 100644 index 0000000000..ed6271e70c --- /dev/null +++ b/ja_JP.eucJP/man/man4/yp.4 @@ -0,0 +1,571 @@ +.\" Copyright (c) 1992/3 Theo de Raadt +.\" 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. 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. +.\" +.\" from: @(#)yp.8 1.0 (deraadt) 4/26/93 +.\" %Id: yp.4,v 1.14 1997/12/22 07:35:40 charnier Exp % +.\" jpman %Id: yp.4,v 1.4 2000/02/06 17:48:28 horikawa Stab % +.\" +.Dd April 5, 1993 +.Dt YP 4 +.Os BSD 4.2 +.Sh 名称 +.Nm yp +.Nd YP/NIS システムの詳細 +.Sh 書式 +.Nm yp +.Sh 解説 +.Nm YP +サブシステムを使用すると、passwd, group, netgroup, hosts, +services, rpc, bootparams, ethers の各ファイルのエントリ +を次の関数を通してネットワーク管理することができます: +.Xr getpwent 3 , +.Xr getgrent 3 , +.Xr getnetgrent 3 , +.Xr gethostent 3 , +.Xr getnetent 3 , +.Xr getrpcent 3 , +.Xr ethers 3 +。 +.Xr bootparamd 8 +デーモンは、 +.Tn NIS +ライブラリを直接呼び出します。なぜなら、 +標準 C ライブラリでは、bootparams を読み込む +関数が存在しないからです。 +hosts, services, rpc のデータベースを +.Tn NIS +でサポートにするには、 +.Pa /etc/host.conf +ファイルの +.Em nis +の行のコメントを外してください。 +残りのデータベースの +.Tn NIS +でのサポートについては、 +適切なファイルに特別な意味を持つ '+' エントリを足すと有効になります。 +.Pp +.Nm YP +サブシステムは、 +.Pa /etc/rc.conf +ファイル中で初期化されていて、かつ、 +.Pa /var/yp +ディレクトリが存在していれば +(デフォルトの配布物では存在しています)、 +.Pa /etc/rc +ファイル中で自動的に実行されます。 +デフォルトの +.Tn NIS +ドメインは、 +.Xr domainname 1 +コマンドで設定されている必要があります。 +これについても、 +.Pa /etc/rc.conf +ファイルで指定されていれば、システム起動時に自動的に +行われます。 +.Pp +.Tn NIS +は +.Tn RPC +ベースの +クライアントサーバシステムであり、 +.Tn NIS +ドメイン内のマシンが同じ設定ファイルを共有できるように +するシステムです。 +.Tn NIS +を使用することで、システム管理者は最低限の設定データだけで +.Tn NIS +クライアントシステムを立ち上げることができ、 +1 つの場所から設定データを追加したり、消したり、変更したり +することができます。 +.Pp +.Tn NIS +のすべての情報の正当なコピーは +.Em Tn NIS マスタサーバ +と呼ばれる 1 つのマシン上に保存されます。 +情報を保存するのに使用されるデータベースは +.Em Tn NIS マップ +と呼ばれています。 +.Bx Free +では、 +これらのマップは +.Pa /var/yp/[domainname] +に保存されます。 +ここで、 +.Pa [domainname] +は、サービスを受けている +.Tn NIS +ドメイン名です。 +1 つの +.Tn NIS +サーバで +一度に複数のドメインをサポートすることができます。そのため、 +このような名前のディレクトリが複数あるということもあり得ます。 +サポートされるドメイン 1 つにつき、1 つのディレクトリを持ちます。 +ドメインはそれぞれ独立した NIS マップのセットを持っています。 +.Pp +.Bx Free +では、 +.Tn NIS +マップは Barkeley DB ハッシュのデータベースファイル +(これは、 +.Xr passwd 5 +データベースファイルで使用されているフォーマットと同じものです) +になっています。 +他のオペレーティングシステムで、 +.Tn NIS +をサポートしているものでは、古い形式の nbdm データベースを +代わりに使用しています +(Sun Microsystems 社が最初に +.Tn NIS +の実装を ndbm 上で行ったことが大きな要因です。他のベンダは、 +自分達で別のデータベースフォーマットを使って実装を行わずに、 +単に Sun のコードのライセンスを受けたということです)。 +これらのシステムでは、データベースは通常 +.Em .dir +ファイルと +.Em .pag +ファイルに分けられています。ndbm コードは、これら 2 つの +ファイルを使って、ハッシュデータベースの別々の部分を +保持するようになっています。Berkeley DB ハッシュの +方法では、この 2 つの部分に分かれている情報を保持するのに +単一のファイルを使います。 +つまり、他のオペレーティングシステムでは、 +.Pa passwd.byname.dir +ファイルと +.Pa passwd.byname.pag +ファイルがあるのに対し +(これら 2 つはどちらも同じマップの一部分です)、 +.Bx Free +では、 +.Pa passwd.byname +という名前のファイルがひとつだけあります。 +このフォーマットの違いは、たいして重要ではありません。 +.Tn NIS +サーバ +.Xr ypserv 8 +そして関連のあるツール群だけが、 +.Tn NIS +マップのフォーマットがどうなっているのかを知る +必要があります。 +.Tn NIS +クライアントシステムでは、 +.Tn NIS +データはすべて +.Tn ASCII +形式で受け取ります。 +.Pp +.Tn NIS +システムには、主要な 3 つのタイプがあります。 +.Bl -enum -offset indent +.It +.Pa Tn NIS クライアント… +これは、 +.Tn NIS +サーバに情報の問い合わせをします。 +.It +.Pa Tn NIS マスタサーバ… +これは、 +.Tn NIS +マップの正当なコピーをすべて管理しています。 +.It +.Pa Tn NIS スレーブサーバ… +これは、 +.Tn NIS +マップのバックアップコピーを管理しています。バックアップ +コピーは、定期的にマスタサーバが更新しています。 +.El +.Pp +.Tn NIS +クライアントは、 +.Xr ypbind 8 +デーモンを利用して +.Tn NIS +サーバといわゆる +.Em バインド +を確立します。 +.Xr ypbind 8 +はシステムのデフォルトのドメインをチェックし ( +.Xr domainname 1 +コマンドで設定されます)、 +.Tn RPC +リクエストをローカルネットワーク上でブロードキャスト +し始めます。 +.Xr ypbind 8 +がバインドを確立しようとしているドメイン名は、 +これらのリクエストが指定します。 +リクエストのあったドメインのサービスを行うように +設定されているサーバがこのブロードキャストメッセージを +受け取ると、 +このサーバは、 +.Xr ypbind 8 +に対して応答します。そして、 +.Xr ypbind 8 +はこのサーバのアドレスを記録するのです。もし、複数の +サーバが使用可能であるなら +(例えば、マスタサーバ 1 台とスレーブサーバ数台というような場合)、 +.Xr ypbind 8 +は、一番最初に応答してきたサーバのアドレスを使用します。 +この時点から、クライアントシステムは +.Tn NIS +リクエストをすべてこのサーバに送ります。 +.Xr ypbind 8 +は時々サーバに "ping" をかけ、サーバがまだ上がっていて、動作 +しているかを確認します。この ping の応答を適切な時間内に +受け取らない場合は、 +.Xr ypbind 8 +は、バインドされていないという印をこのドメインにつけ、再度 +ブロードキャストを始めて別のサーバの場所を特定 +しようとします。 +.Pp +.Tn NIS +マスタサーバおよびスレーブサーバでは、 +.Tn NIS +のリクエストはすべて +.Xr ypserv 8 +デーモンで扱います。 +.Xr ypserv 8 +デーモンは、 +.Tn NIS +クライアントから入ってくるリクエストを受け取り、 +リクエストされたドメインおよびマップ名を対応するデータベース +へのパスに変換し、そのデータベースからデータを取り出して +クライアントに送り返すという仕事をしています。 +特別なリクエストのセットがあり、 +.Xr ypserv 8 +はこのセットを扱えるように設計されています。そのほとんどが +標準 C ライブラリ内の関数として実装されています。 +.Bl -bullet -offset indent +.It +.Fn yp_order +この関数は、特定のマップの作成日時を調べます。 +.It +.Fn yp_master +この関数は、与えられたマップ / ドメインの +.Tn NIS +マスタサーバ名を獲得します。 +.It +.Fn yp_match +この関数は、特定のマップ / ドメイン内のキーで与えられた +ものに対応するデータを見つけます。 +.It +.Fn yp_first +この関数は、特定のマップ / ドメイン内の最初の +キーとデータのペアを獲得します。 +.It +.Fn yp_next +この関数は、 +.Xr ypserv 8 +に特定のマップ / ドメイン内のキーを渡し、このキーのすぐ次に +あるキーとデータの対を +.Xr ypserv 8 +に返してもらいます (関数 +.Fn yp_first +と +.Fn yp_next +とを用いて、 +.Tn NIS +マップを順番に検索できます)。 +.It +.Fn yp_all +この関数は、マップの内容をすべて取り出します。 +.El +.Pp +この他にも、 +.Xr ypserv 8 +が扱うことのできるリクエストはいくつかあります +(つまり、特定のドメインを扱うことができているのかどうかを +応答するもの (YPPROC_DOMAIN) や、ドメインを扱うことができる +ときだけ応答し、そうでないときには黙っているもの +(YPPROC_DOMAIN_NONACK) などです)。 +しかし、これらは普通、 +.Xr ypbind 8 +のみが生成するリクエストであり、標準のユーティリティ +で扱われるわけではありません。 +.Pp +ホストが膨大にあるネットワーク上では、ただ 1 台の +マスタサーバを使うよりも、マスタサーバ 1 台と複数のスレーブサーバ +を使う方が良いことが多いのです。スレーブサーバは、 +マスタサーバと全く同じ情報を提供します。ですから、 +マスタサーバ上のマップを変更するときはいつでも新しいデータを +.Xr yppush 8 +コマンドを使ってスレーブサーバに伝播させるようにすべきです。 +.Tn NIS +の Makefile +.Pf ( Pa /var/yp/Makefile ) +を使うと、この操作を自動的に行うことができます。 +そのためには、管理者が Makefile ファイル中の +.Em NOPUSH=true +と書かれた行をコメントアウトしてください +(NOPUSH は、デフォルトでは true に設定されています。 +デフォルトの設定では、 +.Tn NIS +サーバが 1 つだけの、小さなネットワーク用になっているからです)。 +.Xr yppush 8 +コマンドは、マスタサーバとスレーブサーバとの +トランザクションを開始します。その間に、スレーブサーバは、 +特定のマップをマスタサーバから、 +.Xr ypxfr 8 +コマンドを用いて転送します +(スレーブサーバは、 +.Xr ypserv 8 +内部で +.Xr ypxfr 8 +コマンドを自動的に呼び出します。そのため、管理者が直接 +.Xr ypxfr 8 +コマンドを実行する必要は普通ありません。それでも、 +そうしたいなら、手で打って実行することもできます)。 +スレーブサーバを管理すると、大きなネットワーク上の +.Tn NIS +のパフォーマンス向上に役立ちます。理由は次の通りです。 +.Pp +.Bl -bullet -offset indent +.It +.Tn NIS +マスタサーバがクラッシュした場合や参照できない場合に、 +バックアップサービスを提供します。 +.It +マスタサーバの負荷が過度に増してしまわないように、 +クライアントの負荷を複数のマシンに分散します。 +.It +1 つの +.Tn NIS +ドメインをローカルネットワークを越えて使用できます ( +サーバが +.Xr ypbind 8 +のブロードキャストの範囲外の所にあったならば、 +.Xr ypbind 8 +デーモンはサーバの場所を自動的に決定できなかったでしょう。 +.Xr ypset 8 +コマンドを使って +.Xr ypbind 8 +デーモンが特定のサーバとバインドを確立するように +することはできますが、このようにすると不便なことがあります。 +この問題は、ただスレーブサーバをローカルネットワーク上に +置くだけで回避できます)。 +.El +.Pp +.Bx Free +の +.Xr ypserv 8 +は、 +.Bx Free +のクライアントシステムだけを使った場合、(他の +.Tn NIS +の実装よりも) 強化された +セキュリティを提供するように設計されています。 +.Bx Free +のパスワードデータベースシステム +(これは、 +.Bx 4.4 +からそのまま受け継がれたものです) +には、 +.Em 「シャドウパスワード」 +のサポートが含まれています。標準的なパスワードデータベース +には、暗号化されたユーザパスワードは含まれていません。 +かわりに、暗号化されたパスワードは +(他の情報と一緒に) +スーパユーザのみがアクセス可能なデータベースに分けて +保存されています。 +暗号化されたパスワードが +.Tn NIS +マップとして入手できるとしたら、 +このセキュリティは全体的に機能しなくなるでしょう。なぜなら、 +ユーザは誰でも +.Tn NIS +のデータを取得できるからです。 +.Pp +暗号化されたパスワードを +.Tn NIS +経由で取得されないようにするため、 +.Bx Free +の +.Tn NIS +サーバでは、特殊な方法でシャドウパスワードマップ +.Pf ( Pa master.passwd.byname +と +.Pa master.passwd.byuid ) +を扱います。サーバは、特権ポートで生成されたリクエストに +対する応答をするときのみ、シャドウパスワードマップに +アクセスします。特権ポートへの接続が +許されているのは root だけなので、サーバは、そのような +リクエストはすべて特権ユーザ (root) からのものであると +仮定するわけです。その他のポートからのアクセスはすべて +拒否されます。特権のないポートからリクエストを出しても +サーバからはエラーコードが返ってくるだけです。 +さらに、 +.Bx Free +の +.Xr ypserv 8 +は、Wietse Venema の tcp ラッパパッケージをサポートしています。 +tcp ラッパのサポートを有効にすると、管理者は、 +.Xr ypserv 8 +が限られたクライアントに対してのみ応答するように、設定可能です。 +.Pp +これらの機能強化によって、普通の +.Tn NIS +よりも優れたセキュリティを提供できますが、それでも +決して 100 パーセント効果があるわけではありません。 +ネットワークにアクセスできる誰かがサーバをだまして +シャドウパスワードマップを開示させるようにすることが +それでも可能なのです。 +.Pp +クライアント側では、 +.Bx Free +の +.Fn getpwent 3 +関数は自動的に +.Pa master.passwd +マップを探し、存在していたらそれを使います。もし、 +マップが存在していたら、それを使い、これら特別な +マップの全フィールド +(クラス、パスワードが使われている期間、 +そしてアカウントの有効期限) +をデコードします。もし、存在していないなら、 +標準の +.Pa passwd +マップが代わりに使われます。 +.Sh 互換性 +システムによっては、例えば +SunOS 4.x などでは、 +ホスト名を解決する関数 +( +.Fn gethostbyname +や +.Fn gethostbyaddr +など) +が正しく作動するためには +.Tn NIS +が動作している必要があるものがあります。 +こういったシステムでは、 +.Xr ypserv 8 +デーモンは、 +.Pa hosts.byname +あるいは +.Pa hosts.byaddr +マップ中に存在していないホストに関する +情報を返すように要求された場合には、 +.Tn DNS +を参照します。 +.Bx Free +のリゾルバは、デフォルトで +.Tn DNS +を使います +(望むなら、 +.Tn NIS +を使うようにもできます)。 +そのため、 +.Bx Free +の +.Tn NIS +サーバは、 +.Tn DNS +をデフォルトでは参照しません。 +しかし、特別なフラグをつけて +.Xr ypserv 8 +を起動した場合は +.Tn DNS +を参照するようになります。 +また、 +v1 サーバが存在することを強く要求するような +システムをおとなしくさせるため、 +.Xr ypserv 8 +を +.Tn NIS +v1 サーバとして登録することもできます +.Pf ( Bx Free +は、 +.Tn NIS +v2 のみ使用しますが、その他のシステムでは、 +.Tn SunOS +4.x もそうですが、バインドを確立する際に、 +v1 および v2 の両方の機能を有するサーバを探索するものが多いです)。 +.Bx Free +の +.Xr ypserv 8 +は、実は +.Tn NIS +v1 リクエストを扱いません。 +しかし、この "対処モード (kludge mode)" +は、v1 および v2 の両方の機能を有するサーバを頑固に探索するシステムを +黙らせるには便利です +.Pp +(これらの特殊な機能やフラグについての詳細は +.Xr ypserv 8 +のマニュアルページを参照してください)。 +.Sh バグ +.Bx Free +では、現在 +.Tn NIS +クライアントにもサーバにもなることができますが、 +.Xr ypupdated 8 +あるいは、 +.Fn yp_update +関数はサポートされていません。これらには、両方とも +安全な +.Tn RPC +が必要ですが、 +.Bx Free +では、これについてもサポートされていません。 +.Pp +.Xr getservent 3 +と +.Xr getprotoent 3 +関数は、まだ +.Tn NIS +をサポートしていません。 +幸いなことに、これらのファイルは +それほど頻繁に更新する必要がありません。 +.Pp +マニュアルページをもっとたくさん書くべきです。特に、 +.Xr ypclnt 3 +についてはそうです。 +しばらくは、手元の Sun マシンを探して、それ用の +マニュアルを読んでください。 +.Pp +Sun もこのプログラムの著者も、起動時に ypbind がサーバを見つけられないとき +に生じる問題を分かりやすく扱う方法を思い付きませんでした。 +.Sh 歴史 +.Nm YP +サブシステムは、 +Sun の実装と互換性を持たせるために、 +.An Theo de Raadt +が最初から書きました。 +バグフィックスと改良 +および +.Tn NIS +サーバのサポートは、後に +.An Bill Paul +が追加しました。 +サーバ側のコードは、もともと、 +.An Peter Eriksson +と +.An Tobias Reber +が書き、 +GNU Public License +に従っています。 +Sun +のコードは一切参照されませんでした。 diff --git a/ja_JP.eucJP/man/man4/ze.4 b/ja_JP.eucJP/man/man4/ze.4 new file mode 100644 index 0000000000..d7701da85e --- /dev/null +++ b/ja_JP.eucJP/man/man4/ze.4 @@ -0,0 +1,90 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: ze.4,v 1.6 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: ze.4,v 1.3 1999/11/28 15:52:45 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt ZE 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm ze +.Nd +IBM/National Semiconductor PCMCIA イーサネットデバイスドライバ +.Sh 書式 +.Cd "device ze0 at isa? port 0x300 net irq 5 iomem 0xd8000" +.Sh 解説 +.Nm +ドライバは、IBM/National Semiconductor ベースの +PCMCIA イーサネットコントローラのサポートを提供します。 +これは IBM Thinkpad 用 +IBM Credit Card adapter I 及び II や，National `InfoMover' NE4100 +PCMCIA カードを含みます。 +.Nm +ドライバは National Semiconductor DS8390 イーサネットアダプタ用の +デバイスドライバに基づいています。 +.Sh 診断 +.Bl -diag +.It "ze%d: device timeout, isr=%02x, imr=%02x, imask=%04x" +デバイスがネットワークに応答しなくなりました。または、ネットワーク接続 +(ケーブル) に問題があります。 +.It "ze%d: shared memory corrupt - invalid packet length %d" +このエラーは、イーサネットドライバチップが初期リビジョンで、負荷が高い +場合にときどき見られます。パケット長のバイトオーダが切り替わってしまう +ためです。 +.El +.Sh 警告 +このドライバは IBM Credit Card Adapter for Ethernet に対してのみ動作す +ることが知られています。 +PCMCIA コンフィギュレーションオプションレジスタ (COR) の位置決定を、 +IBM のカードで予想されている値にハードコーディングするかわりに、 +コンフィギュレーションタプルを解析するようドライバを修正すれば、 +他の PCMCIA カードでもおそらく動作するでしょう。 +.Sh バグ +現在、 このドライバはマルチキャストをサポートしていません。 +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 1.1.5 +から登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.An Keith Moore +が書きました。もともと +.An David Greenman +の成果に基づいており、Keith が PCMCIA の変更と追加をしました。 +それを +.An Jordan Hubbard +が +.Fx 1.1.5 +に合わせて改造しました。 +このマニュアルページは +.An David E. O'Brien +が書きました。 diff --git a/ja_JP.eucJP/man/man4/zero.4 b/ja_JP.eucJP/man/man4/zero.4 new file mode 100644 index 0000000000..e2cfbab31e --- /dev/null +++ b/ja_JP.eucJP/man/man4/zero.4 @@ -0,0 +1,56 @@ +.\" Copyright (c) 1996 +.\" Mike Pritchard . 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 Mike Pritchard and +.\" contributors. +.\" 4. Neither the name of the author 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 AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %Id: zero.4,v 1.2 1997/03/07 02:49:38 jmg Exp % +.\" jpman %Id: zero.4,v 1.3 1999/12/17 05:29:55 mitchy Stab % +.\" +.Dd April 7, 1996 +.Dt ZERO 4 +.Os +.Sh 名称 +.Nm zero +.Nd zero デバイス +.Sh 解説 +.Nm +デバイスは普通のファイルのように (いくらでも) データを受け入れ、 +読み出せますが、書き込まれたデータは捨て去られます。 +また、読み出すとナルバイトを際限なく返します。 +.Sh 関連ファイル +.Bl -tag -width /dev/zero +.It Pa /dev/zero +.El +.Sh 関連項目 +.Xr null 4 +.Sh 歴史 +.Nm +デバイスは +.Bx 4.4 +から登場しました。 diff --git a/ja_JP.eucJP/man/man4/zp.4 b/ja_JP.eucJP/man/man4/zp.4 new file mode 100644 index 0000000000..ff42812b3c --- /dev/null +++ b/ja_JP.eucJP/man/man4/zp.4 @@ -0,0 +1,67 @@ +.\" +.\" Copyright (c) 1997 David E. O'Brien +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %Id: zp.4,v 1.5 1998/10/22 14:12:55 bde Exp % +.\" jpman %Id: zp.4,v 1.3 1999/08/18 16:40:24 horikawa Stab % +.\" +.Dd January 19, 1997 +.Dt ZP 4 i386 +.Os FreeBSD +.Sh 名称 +.Nm zp +.Nd +3Com PCMCIA Etherlink III イーサネットデバイスドライバ +.Sh 書式 +.Cd "device zp0 at isa? port 0x300 net irq 10 iomem 0xd8000" +.Sh 解説 +.Nm +ドライバは +3Com 3C589 PCMCIA Etherlink III イーサネットコントローラの +サポートを提供します。 +.Pp +.Sh 関連項目 +.Xr arp 4 , +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh 歴史 +.Nm +デバイスドライバは +.Fx 2.0.5 +で初めて登場しました。 +.Sh 作者 +.Nm +デバイスドライバは +.An Tatsumi Hosokawa +が書きました。 +これは、 +.An Herb Peyerl , +.An Devid Hinds , +.An Donald Becker , +.An David Greenman , +.An Seiji Murata +によるイーサネットドライバのコードに基づいています。 +このマニュアルページは +.An David E. O'Brien +が書きました。