<!doctype linuxdoctr system>

<article>

<title> Linux ACPI-HOWTO </title>

<author> Ariel Glenn (<tt>ariel@columbia.edu</tt>)
<date> v 0.1c, 16 July 2000

<trans> The Linux Japanese FAQ Project (<tt>JF@linux.or.jp</tt>)
<tdate> v 0.1cj, 24 December 2000

<!--
Linux ACPI-HOWTO
Ariel Glenn, ariel@columbia.edu
v 0.1c, 16 July 2000
-->

<!--
This document describes how to compile, install, and use the ACPI
driver for Linux and its associated applications.  The latest version
of this document can be found at 
http://www.columbia.edu/~ariel/acpi/acpi_howto.txt.
-->
<abstract>
この文書は Linux の ACPI ドライバのコンパイルやインストールおよび使い方と、
アプリケーションとの関連について記述します。この文書の最新版は
 <htmlurl url="http://www.columbia.edu/~ariel/acpi/acpi_howto.txt"
 name="http://www.columbia.edu/~ariel/acpi/acpi_howto.txt">
 から入手できます。
</abstract>

<!--
Table of Contents

1. General information and hardware requirements

   1.1  Introduction
   1.2  Copyright notice and disclaimer
   1.3  Changes to this document
   1.4  Where are the latest acpi driver / acpid package / pmtools package,
        and where can I get them?
   1.5  Are binary distributions available?
   1.6  What chipsets are supported?
   1.7  Which kernels are supported?
   1.8  Which BIOSes are supported?
   1.9  When will my favorite (unsupported) system become supported?
   1.10 What ACPI capabilities are supported?
   1.11 Mailing lists and other information sources

2. Compilation and installation

   2.1 Prerequisites and kernel setup
   2.2 Compilation and installation of acpid and acpictl
   2.3 Compilation and installation of pmtools
   2.4 Driver options
   2.5 System resource settings

3. Miscellaneous driver information

   3.1 What are all these proc entries and how can I use them?
   3.2 What do these messages from 'e820' in /var/log/messages mean?

4. Debugging tips and programming information

   4.1 The driver isn't working right for me. How can I figure out
       what's wrong?  
   4.2 Submitting useful bug reports
   4.3 Guidelines for Linux device driver writers 

6. Credits and license information
 
   6.1 Credits
   6.2 GNU Free Documentation License

-->
<toc>

<!--
1.1 Introduction
-->
<sect> 一般的な情報と必要なハードウェア
<sect1> はじめに

<p>
<!--
ACPI, which stands for Advanced Configuration and Power Interface, is the
successor to APM (Advanced Power Management).  The specification provides
for many functions besides power management, such as thermal management
and plug-and-play events. However, this document concentrates on the power 
management functions, which is the principal work of the ACPI4Linux group 
to date.
-->
<!--draft1
&dquot;Advanced Configuration and Power Interface&dquot; の略語である ACPI は
 APM (Advanced Power Management) に取って代わるものです。その仕様は電源管理に
加えて温度管理やプラグアンドプレイイベント等といったたくさんの機能を規程して
います。しかしながら、この文書は ACPI4Linux グループの今日までの主要な作業で
ある電源管理機能に集中します。
-->
&dquot;Advanced Configuration and Power Interface&dquot; の略語である ACPI は
 APM (Advanced Power Management) に取って代わるものです。その仕様は電源管理に
加えて温度管理やプラグアンドプレイイベント等といったたくさんの機能を規定して
います。しかしながら、この文書は ACPI4Linux グループの今日までの主要な作業で
ある電源管理機能に集中します。

<!--
ACPI support for Linux consists of a driver which is supplied with recent
kernels, a daemon and user client contained in the acpid package, and a
set of analysis and debugging tools called pmtools. These packages and the
driver are still in the early stages of development. They should not be
considered stable software. Please take appropriate precautions before using
them.  Having said that, however, the more people help to test and debug 
them and add features, the sooner they will become production quality.
Your help is most welcome!
-->
Linux のための ACPI サポートは最近のカーネルとともに供給されるドライバと、
acpid パッケージに含まれるデーモンとクライアント、pmtools と呼ばれる解析と
デバッグのツールを集めたものから成ります。これらのパッケージとドライバは
まだ開発の初期段階です。安定したソフトウェアと考えるべきではありません。
それらを使用する前に、しかるべき予防策を取ってください。それでもたくさんの
人がそれらのテストとデバッグを行い、機能追加しているので、すぐに製品品質に
なるでしょう。もちろんあなたの力添えは大歓迎です！

<!--
Please send suggestions, complaints or comments about this document
to ariel@columbia.edu. Please do NOT send me bug reports about the driver;
see section 4.2 (Submitting useful bug reports) for more information on
reporting driver bugs.
-->
この文書についての提案や苦情、意見があれば、著者 <tt/ariel@columbia.edu/ まで
送ってください。ドライバのバグレポートは送らないでください――ドライバの
バグの報告方法の詳細はセクション 4.2 (役立つバグレポートの提出) を参照して
ください。

<!--
1.2 Copyright notice and disclaimer
-->
<sect1> Copyright notice and disclaimer
<!--verbとして訳さないことにしました-->
<p>
<verb>
Copyright (c) 2000 Ariel T. Glenn

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with 
no Back-Cover Texts. A copy of the license is included in the section 
entitled "GNU Free Documentation License".

This document is provided ``AS IS'', with no express or implied
warranties.  Use the information in this document at your own risk.
</verb>

<!--
1.3  Changes to this document
-->
<sect1> 文書の変更

<p>
<!--
     0.1c  Added documentation for pmtest script and utility
           Corrected version number of ACPI spec
           Added information on the driver included with the 2.4.0-test3
           series of kernels and later (new /proc interface, reduced 
           functionality of new acpid, changed driver options)
-->
<verb>
     0.1c  pmtestのスクリプトとユーティリティの文書を追加
           ACPI 仕様のバージョン番号を修正
           2.4.0-test3およびそれ以降のカーネルに含まれるドライバの情報を追加
           (新しい /proc インターフェース、新しい acpid 機能の限定、
           ドライバオプションの変更)
</verb>
      
<!--
1.4  Where are the latest acpi driver / acpid package / pmtools package,
     and where can I get them?
-->
<sect1> 最新の acpi ドライバと acpid パッケージと pmtools パッケージはどこに
あり、どこから入手できるか？

<p>
<!--
The latest version of the acpi driver is always included in the most
recent Linux kernel which, as of this writing, is 2.4.0-test5-pre1. You can
get the kernel at ftp://ftp.kernel.org/ or any of its mirror sites.
Patches are not backported to earlier versions.
-->
acpi ドライバの最新バージョンはいつも一番新しい Linux のカーネルに含まれます。
この文書を書いてる時点では 2.4.0-test5-pre1 です。カーネルは
 <htmlurl url="ftp://ftp.kernel.org/"  name="ftp://ftp.kernel.org/">
 から入手できます。昔のバージョンにさかのぼってドライバを使うパッチは
ありません。

<!--
The latest acpid is acpid-071100.tar.gz for 2.4.0-test3 and later kernels 
with the AML interpreter enabled, and acpid-052200.tar.gz otherwise.
The latest pmtools is pmtools-060600.tar.gz.  The latest versions are always 
available from http://www.geocities.com/SiliconValley/Hardware/3165/ and are 
mirrored at http://phobos.fs.tum.de/acpi/download.html. These packages 
include the full source. 
-->
最新の acpid は 2.4.0-test3 およびそれ以降のカーネルで AML インタープリタを
有効にした時のもので、acpid-071100.tar.gz です。そうでないものは
 acpid-052200.tar.gz です。
最新の pmtools は pmtools-060600.tar.gz です。最新のバージョンは
 <htmlurl url="http://www.geocities.com/SiliconValley/Hardware/3165/"
 name="http://www.geocities.com/SiliconValley/Hardware/3165/">
 か、ミラーサイトの
 <htmlurl url="http://phobos.fs.tum.de/acpi/download.html"
 name="http://phobos.fs.tum.de/acpi/download.html">
 から入手できます。これらのパッケージは全部のソースを含みます。

<!--
1.5 Are binary distributions available?
-->
<sect1> バイナリ配布で入手できるか？

<p>
<!--
No; the driver is included only in development kernels and so precompiled 
versions are not available. Acpid and pmtools are still alpha software and
likewise are not ready for binary distribution.
-->
いいえ――ドライバは開発カーネルに含まれているだけなので、コンパイル済みの
バージョンは入手できません。acpid と pmtools も開発段階のソフトウェアなので
同様にバイナリ配布は用意されていません。

<!--
1.6 What chipsets are supported?
-->
<sect1> どのチップセットがサポートされているか？

<p>
<!--
In theory, any compliant ACPI implementation is supported. In practice, there
are a lot of buggy ACPI implementations out there. Even implementations based 
on chipsets specifically targeted by the driver can have their oddities.
The specific systems that are known to behave in a way the driver expects
are: (list them here)
Systems known to have odd behavior are: (list them here)
-->
理論的には、ACPI に準拠した実装はサポートされます。実際には、誤って ACPI を
実装したものが出荷されています。具体的に言うと、ドライバが対象とした
チップセットの実装でさえ奇異な動作をする可能性があります。
ドライバが期待した振る舞いをする具体的なシステム： (それらをここに記述)
奇妙な振る舞いをするシステム： (それらをここに記載)

<!--
1.7  Which kernels are supported?
-->
<sect1> どのカーネルがサポートされているか？

<p>
<!--
The ACPI driver was included with the development kernel starting with
version 2.3.19. Patches were at one time made available for 2.2.x but as new 
features have been added, no attempt has been made to backport the changes to 
the 2.2.x patches, and those patches are no longer available.
-->
バージョン 2.3.19 から、開発カーネルに ACPI ドライバが含まれるように
なりました。2.2.x のために一度だけ作られたパッチがありましたが、
新しい機能が追加されても 2.2.x にさかのぼって変更を行うパッチを作る試みは
ありません。そしてそれらのパッチはもはや入手できません。

<!--
1.8  Which BIOSes are supported?
-->
<sect1> どの BIOS がサポートされているか？

<p>
<!--
A table of BIOS manufacturers and versions, along with what ACPI
capabilities the BIOS supports, is available at 
http://phobos.fs.tum.de/acpi/bios.sql.
-->
BIOS の製造会社とバージョンおよびBIOS がサポートする ACPI の能力の表は
 <htmlurl url="http://phobos.fs.tum.de/acpi/bios.sql"
 name="http://phobos.fs.tum.de/acpi/bios.sql">
 から入手できます。

<!--
1.9  When will my favorite (unsupported) system become supported?
-->
<sect1> お気に入りの (サポートされていない) システムがいつ
サポートされるのか？

<p>
<!--
If you test the package and can send the developers information about your 
ACPI BIOS, they will get to it sooner. If you write some code for your
BIOS and submit it, they'll get to it even sooner yet :-)
-->
あなたがパッケージをテストし、あなたの ACPI BIOS についての情報を開発者に
送ることができれば、すぐにサポートされるでしょう。あなたの BIOS のための
数行のコードを書き、提出すれば、さらに早くサポートされるでしょう。:-)

<!--
See section XXX on how to determine the capabilities of your BIOS.
-->
あなたの BIOS の能力を測定する方法はセクション XXX を参照してください。
 
<!--
1.10  What ACPI capabilities are supported?
-->
<sect1> ACPI 能力の何がサポートされているか？

<p>
<!--
Currently, sleep mode (S1), resume, and power off (S5) are the only ACPI 
capabilities supported by the driver. Next on the todo list are other suspend
states; lower on the list because it must be coordinated with updates
to other device drivers is suspend-to-disk (hibernation).
-->
現在のところ、ドライバでサポートされる ACPI 能力は、スリープモード (S1)、
リジューム、パワーオフ (S5) のみです。次にサポートされるのはサスペンド状態
の他のものが予定されています――サスペンドが後回しなのは、suspend-to-disk
 (ハイバネーション) などの他のデバイスドライバの更新と統一される必要がある
からです。

<!--
1.11  Mailing lists and other information sources
-->
<sect1> メーリングリストと他の情報源

<p>
<!--
The ACPI driver and supporting packages are the work of the ACPI4Linux 
project, which has a web site at http://phobos.fs.tum.de/acpi/.
-->
ACPI ドライバとそのサポートパッケージは ACPI4Linux プロジェクトの作業で、
ACPI4Linux プロジェクトのウェブサイトが
 <htmlurl url="http://phobos.fs.tum.de/acpi/"
 name="http://phobos.fs.tum.de/acpi/">
 にあります。

<!--
The project has a mailing list which users and developers can join,
by sending mail to acpi-request@phobos.fs.tum.de with the subject list
"Subscribe" or by using the Web interface to subscribe at
http://phobos.fs.tum.de/mailman/listinfo/acpi. Archives of the list
are kept at http://phobos.fs.tum.de/pipermail/acpi/.
-->
ユーザと開発者が参加できるメーリングリストを持っています。主題の欄に
 &dquot;Subscribe&dquot; と書いたメールを <tt/acpi-request@phobos.fs.tum.de/
 に送るか、メーリングリストへの参加のためのウェブインターフェースが
 <htmlurl url="http://phobos.fs.tum.de/mailman/listinfo/acpi"
 name="http://phobos.fs.tum.de/mailman/listinfo/acpi"> にあるのでそれを
使用して参加できます。メーリングリストのアーカイブは
 <htmlurl url="http://phobos.fs.tum.de/pipermail/acpi/"
 name="http://phobos.fs.tum.de/pipermail/acpi/"> にあります。

<!--
The ACPI specification itself is on the Web at http://www.teleport.com/~acpi/,
and a description of the ACPI Component Architecture, including in particular
the AML interpreter and ACPI core code used in acpid, is available at 
ftp://download.intel.com/technology/iapc/downloads/cadoc100.zip.
-->
ACPI 自体の仕様はウェブ上の
 <htmlurl url="http://www.teleport.com/~acpi/"
 name="http://www.teleport.com/~acpi/"> にあります。acpid で使用される特定の
 AML インタープリタと ACPI コアコードを含む ACPI コンポーネントアーキテクチャ
の詳細は、
<htmlurl url="ftp://download.intel.com/technology/iapc/downloads/cadoc100.zip"
 name="ftp://download.intel.com/technology/iapc/downloads/cadoc100.zip">
 から入手できます。

<!--
2.1 Prerequisites and kernel setup
-->
<sect> コンパイルとインストール

<sect1> 前提条件とカーネルのセットアップ

<p>
<!--
There are two versions of the driver. The version included in kernels
earlier than 2.4.0-test3 will be referred to as the no-AML-interpreter
version; this is the same version you run if you answer 'n' to
CONFIG_ACPI_INTERPRETER in later versions of the kernel. (See below for
configuration options.) The version included in 2.4.0-test3 and later kernels
that you run if you say 'y' to CONFIG_ACPI_INTERPRETER will be referred
to as the includes-AML-interpreter version.  You will need to know
which version of the driver you are running when reading this document.
-->
<!--draft1
ドライバのバージョンは２つあります。ひとつは 2.4.0-test3 よりも前のカーネルに
含まれるバージョンです。以下、no-AML-interpreter バージョンと
呼ぶことにします。これは 2.4.0-test3 および、それ以降のカーネルのバージョンで
 CONFIG_ACPI_INTERPRETER に N と応答し実行したバージョンと同じです (以下の
コンフィグレーションオプションズを参照のこと)。もうひとつは 2.4.0-test3
 および、それ以降のカーネルで CONFIG_ACPI_INTERPRETER に Y と応答し実行した
バージョンです。以下、includes-AML-interpreter バージョンと
呼ぶことにします。
-->
ドライバのバージョンは２つあります。ひとつは 2.4.0-test3 よりも前のカーネルに
含まれるバージョンです。以下、no-AML-interpreter バージョンと
呼ぶことにします。これは 2.4.0-test3 および、それ以降のカーネルのバージョンで
 CONFIG_ACPI_INTERPRETER に N と応答し実行したバージョンと同じです (以下の
コンフィグレーションオプションズを参照のこと)。もうひとつは 2.4.0-test3
 および、それ以降のカーネルで CONFIG_ACPI_INTERPRETER に Y と応答し実行した
バージョンです。以下、includes-AML-interpreter バージョンと
呼ぶことにします。このドキュメントを読むに当たって、あなたが使用される
ドライバがどのバージョンかを知っておく必要があるでしょう。

<!--
You should start by obtaining the most recent kernel, 2.4.0-xxx. Earlier
versions of the driver included with earlier versions of the kernel are not
guaranteed to work with the most recent acpid or pmtools, and only the latest
versions of those packages are guaranteed to be available.
-->
一番新しいカーネル (2.4.0-xxx) を手に入れることから始めるべきです。初期の
カーネルのバージョンに含まれる初期のドライバのバージョンは、一番新しい acpid
 や pmtools との動作が保証されていません。しかも acpid や pmtools の
パッケージで入手できるバージョンは、最新のものしかありません。

<!--
Make sure that you update all packages required to build the kernel; see
the file Documentation/Changes in the kernel source tree for information.
For more general information on building the Linux kernel, see 
the Kernel-HOWTO. Linux HOWTOS are kept at many sites, including the
Linux Documentation Project, http://www.ldp.org/. 
-->
カーネルをビルドするのに必要なすべてのパッケージの更新を必ず行って
ください (そのための情報がカーネルソースツリーの中の
 &dquot;Documentation/Changes&dquot; というファイルにありますので、参照して
ください)。
Linux カーネルのビルドについてのもっと一般的情報は &dquot;Kernel-HOWTO&dquot;
を参照してください。Linux HOWTO は Linux Documentation Project を含むたくさん
のサイトで維持されています。Linux Documentation Project の URL は、
<htmlurl url="http://www.ldp.org/" name="http://www.ldp.org/"> です。

<!--
You will need to rebuild your kernel to include ACPI support. Say 'y'
to the CONFIG_ACPI option. If you want to build in the (as yet) experimental
support for sleep mode, say 'y' to the CONFIG_ACPI_S1_SLEEP option as well.
You do not need to disable APM support; if ACPI support is found at run-time, 
APM support will be turned off automatically in the running kernel.
If you want to try the new 2.4.0-test3 or later driver interface, say 'y' to
CONFIG_ACPI_INTERPRETER, which builds the AML interpreter right into the 
kernel and makes some changes in the /proc/sys/acpi interface as well.
-->
<!--draft1
ACPI サポートのためには、カーネルのリビルドが必要です。
CONFIG_ACPI オプションに Y と答えてください。(今のところ)実験的な
サポートですが、スリープモードを組み込みたい場合、
CONFIG_ACPI_S1_SLEEP オプションに Y と答えればいいです。
APM サポートを無効にする必要はありません――ACPI サポートは実行時に
 APM サポートを見つけると、実行しているカーネルが自動的にオフにします。
2.4.0-test3 かそれ以降のドライバの新しいインターフェースを試したいのなら、
CONFIG_ACPI_INTERPRETER に Y と答えればいいです。これにより、
&dquot;AML interpreter&dquot; が正しく組み込まれ、
/proc/sys/acpi インターフェース内にいくつかの変更が行われます。
-->
ACPI サポートのためには、カーネルのリビルドが必要です。
CONFIG_ACPI オプションに Y と答えてください。(今のところ)実験的な
サポートですが、スリープモードを組み込みたい場合、
CONFIG_ACPI_S1_SLEEP オプションにも Y と答えればいいです。
APM サポートを無効にする必要はありません――ACPI サポートは実行時に
 APM サポートを見つけると、実行しているカーネルが自動的にオフにします。
2.4.0-test3 かそれ以降のドライバの新しいインターフェースを試したいのなら、
CONFIG_ACPI_INTERPRETER に Y と答えればいいです。これにより、
&dquot;AML interpreter&dquot; が正しく組み込まれ、
/proc/sys/acpi インターフェース内にもいくつかの変更が行われます。

<!--
After configuration, build and install your kernel as usual.
-->
コンフィグレーションの後に、いつものようにカーネルをビルドしインストールして
ください。

<!--
You can test the driver by examining /proc/sys/acpi; if there isn't one,
odds are you didn't configure the kernel correctly. Otherwise, 
if you have the includes-AML-interpreter driver, you should see 
-->
/proc/sys/acpi の試験をすることによって、ドライバのテストができます――
/proc/sys/acpi が存在しないなら、たぶんカーネルが正しく構成されていません。
存在しているなら、以下のように見えなければなりません。

includes-AML-interpreter ドライバを使っている場合

<tscreen><verb>
/proc/sys/acpi/c2_exit_latency
/proc/sys/acpi/c2_enter_latency
/proc/sys/acpi/c3_exit_latency
/proc/sys/acpi/c3_enter_latency
/proc/sys/acpi/event
</verb></tscreen>

<!--
If you have the no-AML-interpreter driver you should see the entries
-->
no-AML-interpreter ドライバを使っている場合

<!--たぶん typo
最終行は
  /proc/sys/acpis5_slp_typ.
だったので修正
-->
<tscreen><verb>
/proc/sys/acpi/facp
/proc/sys/acpi/dsdt
/proc/sys/acpi/pm1_enable
/proc/sys/acpi/gpe_enable
/proc/sys/acpi/gpe_level
/proc/sys/acpi/event
/proc/sys/acpi/p_blk
/proc/sys/acpi/p_lvl2_lat
/proc/sys/acpi/p_lvl3_lat
/proc/sys/acpi/enter_lvl2_lat
/proc/sys/acpi/enter_lvl3_lat
/proc/sys/acpi/s0_slp_typ
/proc/sys/acpi/s1_slp_typ
/proc/sys/acpi/s5_slp_typ.
</verb></tscreen>

<!--
In either case, if you compiled in the sleep option, you should also see 
/proc/sys/acpi/sleep.
-->
どちらのドライバを使っていても、スリープオプションでコンパイルしたなら、

<tscreen><verb>
/proc/sys/acpi/sleep
</verb></tscreen>

も見えなければなりません。

<!--
If you have the no-AML-interpreter driver, you can try
cat -v /proc/sys/acpi/facp | more 
which should start with the characters 'FACP' and should then have a few bytes
of garbage followed by an OEM name. If you see this, odds are that the driver
has found the appropriate tables from your BIOS and is ready to roll. If not, 
you may need to set one of the boot options (or module options) as described 
in the driver options section.
-->
no-AML-interpreter ドライバを使っているなら

<quote>
次のコマンドを試すことができます。
</quote>

<tscreen><verb>
cat -v /proc/sys/acpi/facp | more 
</verb></tscreen>
<quote>
<!--draft1
文字が 'FACP' で始まり、数バイトの文字化けの後に OEM 名が表示されます。これが
見えたなら、たぶん BIOS の適切なテーブルをドライバは見つけた、始動準備が
できています。
見えないなら、ブートオプション (またはモジュールオプション) のひとつを設定する
必要があるかもしれません。これについてはドライバオプションのセクションで
記述しています。
-->
文字が 'FACP' で始まり、数バイトの文字化けの後に OEM 名が表示されます。もし、
これが見えたならドライバはBIOSから適正なテーブルを見つけたと言うことなので、
うまくいくかもしれません。
見えないなら、ブートオプション (またはモジュールオプション) のひとつを設定する
必要があるかもしれません。これについてはドライバオプションのセクションで
記述しています。
</quote> 

<!--
If you have the includes-AML-interpreter driver, there's not much in /proc 
for you to look at. You can check in /var/log/messages for the entry 
'ACPI: ACPI support found'; if you see this, all tables including the FACP
should have been loaded and the AML namespace loaded successfully as well.
However, if you later see 'ACPI: enable failed' this means that there was a 
problem setting up event or SCI handlers or putting the system into ACPI mode,
and your system will not be processing ACPI events. A more detailed discussion
of log entries is in section XXX.
-->
includes-AML-interpreter ドライバを使っているなら

<quote>
/proc に見るべきものはあまりありません。/var/log/messages
 内の 'ACPI: ACPI support found' の行をチェックできます――この行が見えたなら、
FACP を含むすべてのテーブルはロードされ、AML namespace のロードも同様に
成功しています。
しかしながら、この行の後の方に 'ACPI: enable failed' という行があったなら、
イベントか SCI ハンドラの設定か、ACPI モードへのシステム移行で問題があった
ことを意味します。なので、システムは ACPI イベントを処理できません。
ログエントリのもっと詳細な議論はセクション XXX にあります。
</quote>

<!--
2.2 Build and Installation of apcid and acpictl
-->
<sect1> acpid と acpictl のビルドとインストール

<p>
<!--
Once you have rebuilt the Linux kernel with ACPI support, download the
appropriate version of acpid. If you have the includes-AML-interpreter
driver, you should download acpid-071100.tar.gz; if you answered 'n', 
you should download acpid-052200.tar.gz.
-->
ACPI サポートしたカーネルをビルドしたら、すぐに適切な acpid のバージョンを
ダウンロードしてください。includes-AML-interpreter ドライバを使っているなら
 acpid-071100.tar.gz を、違うなら acpid-052200.tar.gz をダウンロードしなければ
なりません。

<!--
  Make a directory where you want to build the
package. Cd into the directory and unpack the archive by giving the command
-->
パッケージをビルドしたいディレクトリを作成します。cd でディレクトリの中に入り、
アーカイブを unpack するコマンドを与えます。

<tscreen><verb>
zcat acpid-xxx.tar.gz | tar xvf - 
</verb></tscreen>
  
<!--
where xxx is the version of the package you downloaded.
-->
xxx はダウンロードしたパッケージのバージョンです。

<!--
In the same directory, type
-->
同じディレクトリで、

<tscreen><verb>
./configure
</verb></tscreen>

<!--
to configure the package,
-->
と入力すると、パッケージの構成が行われます。

<tscreen><verb>
make
</verb></tscreen>

<!--
to build it, and
-->
とするとビルドが行われ

<tscreen><verb>
make install
</verb></tscreen>

<!--
to install it.  Note that the default installation directory is /usr/local;
if you prefer to install the files somewhere else, you will need to configure
the package with 
-->
とするとインストールされます。既定のインストールディレクトリが /usr/local で
あることに注意してください――ファイルをインストールする場所を他に選ぶなら、
パッケージの構成で次のようにする必要があります。

<tscreen><verb>
./configure --prefix=/new/place/to/put/them
</verb></tscreen>

<quote>
(訳注：/new/place/to/put/them を好みの場所に置きかえて入力します。)
</quote>

<!--
The programs installed are acpid and acpictl. Acpid will by default be placed
in /usr/local/sbin, and acpictl will be placed in /usr/local/bin. No man pages
are available for them currently, so here is a quick summary of each program.
-->
インストールされるプログラムは acpid と acpictl です。既定では、acpid は
 /usr/local/sbin に、acpictl は /usr/local/bin に置かれます。現時点で
これらの man ページは入手できないので、それぞれのプログラムのクィックサマリを
ここに記載します。

<!--
If you have the includes-AML-interpreter driver, read this section.
-->
includes-AML-interpreter ドライバを使っているなら、この項を読んでください。

<!--
  Acpid is a daemon that watches for ACPI events and processes them; it also
  watches for user requests and sends them to the driver. It accepts the
  following options:
-->
<quote>
acpid は ACPI イベントを監視し、処理するデーモンです――ユーザの要求の監視と
ドライバへの送信も行います。以下のオプションを受け付けます。
</quote>

<!--
  -d or &#045;&#045;debug    Run daemon in the foreground.
  -v or &#045;&#045;version  Print version information.
-->
<tscreen><verb>
  -d または --debug    フォアグランドでデーモンを実行
  -v または --version  バージョン情報を出力
</verb></tscreen>

<!--
  Acpictl is a user client that talks to acpid. It accepts the following
  options:
-->
<quote>
acpictl は acpid と通信するためのユーザクライアントです。以下のオプションを
受け付けます。
</quote>

<!--
  -p or &#045;&#045;pid           print acpid's pid
  -b or &#045;&#045;battery       print battery information &#045;&#045; this option doesn't work
                        with the new driver yet.			
  -i or &#045;&#045;intermediary  act as intermediary between another program and acpid
	
  The intermediary option does not actually do anything right now :-)
-->
<!-- another program が何を指すのか分かりませんでした -->
<tscreen><verb>
  -p または --pid           acpid のプロセス ID を出力
  -b または --battery       電池情報を出力――このオプションは新しいドライバ
                            でも未だ動作しません			
  -i または --intermediary  他のプログラムと acpid との仲立ち
</verb></tscreen>

<quote>	
実のところ intermediary オプションは、現在何もしていません :-)
</quote>

<!--
If you have the no-AML-interpreter driver, read this section.
-->
no-AML-interpreter ドライバを使っているなら、この項を読んでください。


<!--
  Acpid is a daemon that watches for ACPI events and processes them; it also
  watches for user requests and sends them to the driver. It accepts the
  following options:
-->
<quote>
acpid は ACPI イベントを監視し、処理するデーモンです――ユーザの要求の監視と
ドライバへの送信も行います。以下のオプションを受け付けます。
</quote>

<!--
  -d or &#045;&#045;debug    Run daemon in the foreground.
  -t or &#045;&#045;trace    Create a (sizeable) debug trace.
  -v or &#045;&#045;version  Print version information.

  The debug option, besides running acpid without disassociating from the tty,
  allows the user to specify various commands interactively. The list of 
  commands can be seen by giving the command 'help' when in debug mode.
-->
<tscreen><verb>
  -d または --debug    フォアグランドでデーモンを実行
  -t または --trace    (かなり大きい) デバッグトレースの作成
  -v または --version  バージョン情報を出力
</verb></tscreen>

<quote>
tty から引き離さず debug オプションを使用した acpid の実行は、対話式で
各種のコマンドを指定することをユーザに許します。コマンドのリストは debug
モードにおいて 'help' コマンドを与えることで見ることができます。
</quote>

<!--
  Acpictl is a user client that talks to acpid. It accepts the following
  options:
-->
<quote>
acpictl は acpid と通信するためのユーザクライアントです。以下のオプションを
受け付けます。
</quote>

<!--
  -p or &#045;&#045;pid           print acpid's pid
  -b or &#045;&#045;battery       print battery information
  -i or &#045;&#045;intermediary  act as intermediary between another program and acpid

  The intermediary option does not actually do anything right now :-)
-->
<!-- another program が何を指すのか分かりませんでした -->
<tscreen><verb>
  -p または --pid           acpid のプロセス ID を出力
  -b または --battery       電池情報を出力			
  -i または --intermediary  他のプログラムと acpid との仲立ち
</verb></tscreen>
	
<quote>
実のところ intermediary オプションは、現在何もしていません :-)
</quote>

<!--
2.3 Compilation and installation of pmtools
-->
<sect1> pmtools のコンパイルとインストール
 
<p>
<!--
You need perl to run some of the utilities in this package.
-->
pmtools パッケージ内のいくつかのユーティリティの実行には perl が必要です。

<!--
Make sure you have downloaded the most recent version of pmtools. Make a 
directory where you want to build the package. Cd into the directory and 
unpack the archive by giving the command
-->
確実に一番新しい pmtools のバージョンをダウンロードしてください。パッケージを
ビルドしたいディレクトリを作成します。cd でディレクトリの中に入り、
アーカイブを unpack するコマンドを与えます。

<tscreen><verb>
zcat pmtools-xxx.tar.gz | tar xvf - 
</verb></tscreen>

<!--
where xxx is the version of the package you downloaded.
-->
xxx はダウンロードしたパッケージのバージョンです。

<!--
In the same directory, type
-->
同じディレクトリで、

<tscreen><verb>
make
</verb></tscreen>

<!--
to build the package.
-->
と入力すると、パッケージのビルドが行われます。

<!--
No facilities are provided yet to install the utilities, so you will
have to copy them to the appropriate place by hand:
-->
ユーティリティをインストールする機能は未だ提供されていないので、手動で適切な
場所にユーティリティをコピーします。

<tscreen><verb>
cp acpianalyze/acpianalyze /usr/local/bin
cp acpidisasm/acpidisasm /usr/local/bin
cp acpidmp/acpidmp acpdmp/acpitbl acpidmp/acpxtract /usr/local/bin
cp pmtest/pmtest /usr/local/bin
</verb></tscreen>

<!--
or to whichever directory you would like to install them.
-->
または好みのディレクトリにインストールしてもいいです。

<!--
No documentation is provided for this package either, so here is a quick
summary.
-->
このパッケージも文書が提供されていないので、クィックサマリをここに記載します。

<!--
Acpidmp must be run as root or installed suid (better to run it as root,
if you have a multiuser system, but then why are you installing development
kernels on it?)
-->
acpidmp は root か suid を設定して実行しなければなりません (マルチユーザ
システムとして稼動しているなら、root で実行したほうがいいです。それにしても
何でマルチユーザシステムに開発カーネルをインストールしてるの？)。

<!--
It looks for the tables provided by your ACPI BIOS and dumps the one you
specify to stdout. The table names it knows are FACP, DSDT, and RSDT.
If you want to know the innards of these tables, you should look at the
ACPI version 1.0b specification. If you do not provide a name, all
of the tables it finds will be dumped to stdout. It will also show the
RSDP, which you can not ask for on the command line.
-->
acpidmp は ACPI BIOS によって提供されるテーブルを捜し、指定された標準出力
 (stdout) にダンプします。テーブルは FACP, DSDT, RSDT と名づけられています。
これらのテーブルの内部を知りたいのなら、ACPI バージョン 1.0b の仕様を見て
ください。名前を与えず acpidmp を実行した場合、テーブルのすべてを捜し、
標準出力にダンプします。この場合、コマンドラインでは応答しない RSDP も見ること
ができます。

<!--
Acpidmp does not produce human-readable output. For that, you need to pipe
it through acpidisasm. Example: on my Sony VAIO F420, 
-->
acpidmp は人間が読み取れる出力を作成しません。読めるようにするには、パイプで
 acpidisasm に渡す必要があります。著者の Sony VAIO F420 での例を示します。

<tscreen><verb>
acpidmp DSDT | acpidisasm 
</verb></tscreen>

<!--
produces the output
-->
作成された出力は

<tscreen><verb>
00000000: Scope _PR_ (\_PR_)
00000006:   Processor CPU0 (\_PR_.CPU0)
0000000d:     0x00
0000000e:     0x00008010
00000012:     0x06
00000013: Name _S0_ (\_S0_)
00000018:   Package
0000001a:     0x04
0000001b:     0x05
0000001d:     0x05
0000001f:     0x00
00000021:     0x00
00000023: Name _S1_ (\_S1_)
00000028:   Package
0000002a:     0x04
0000002b:     0x04
0000002d:     0x04
0000002f:     0x00
00000031:     0x00
00000033: Name _S3_ (\_S3_)
00000038:   Package
0000003a:     0x04
...
</verb></tscreen>

<!--
(There are 3800 lines or so of output so I'll spare you the rest.)
-->
です (3800 行ぐらいの出力があるので、休憩してもいいですよ)。

<!--
This actually disassembles the AML that is found in the DSDT table.
-->
上記は DSDT テーブルを検索した AML の実際の解読結果です。

<!--
If you have the no-AML-interpeter driver, you can use acpitbl to see table 
headers and registers without AML; this relies on /proc entries which are not 
available when the interpreter is enabled in the kernel. Here's an example 
from my laptop.
-->
no-AML-interpeter ドライバを使っているなら、AML 無しでテーブルのヘッダの参照と
登録のために acpitbl を使用できます――acpitbl は /proc エントリを参照します。
/proc エントリはカーネルで AML interpreter が有効になっていると利用でき
ません。著者の laptop の例を示します。

<tscreen><verb>
acpitbl /proc/sys/acpi/dsdt 
</verb></tscreen>

<!--
produces
-->
とすれば、出力は

<tscreen><verb>
Signature:        DSDT
Length:           11841
Revision:         0x01
Checksum:         0x3c
OEMID:            SONY
OEM Table ID:     K1
OEM Revision:     0x20000203
Creator ID:       MSFT
Creator Revision: 0x01000007
</verb></tscreen>

<!--
which is just the dsdt table header.
-->
となり、これは dsdt テーブルのヘッダです。

<!--
The FACP table may be examined in the same fashion:
-->
FACP テーブルも同じ方法で調べられます。

<tscreen><verb>
acpitbl /proc/sys/acpi/facp
</verb></tscreen>

<!--
shows, on my laptop,
-->
著者の laptop では

<tscreen><verb>
Signature:        FACP
Length:           116
Revision:         0x01
Checksum:         0x12
OEMID:            SONY
OEM Table ID:     K1
OEM Revision:     0x20000203
Creator ID:       PTL
Creator Revision: 0x000f4240
FIRMWARE_CTRL:    0x03ffffc0
DSDT:             0x03ffc924
INT_MODEL:        0x00
SCI_INT:          9
SMI_CMD:          0x000000b2
ACPI_ENABLE:      0xf0
ACPI_DISABLE:     0xf1
S4BIOS_REQ:       0xf2
PM1a_EVT_BLK:     0x00008000
PM1b_EVT_BLK:     0x00000000
PM1a_CNT_BLK:     0x00008042
PM1b_CNT_BLK:     0x00000000
PM2_CNT_BLK:      0x00000022
PM_TMR_BLK:       0x00008008
GPE0_BLK:         0x0000800c
GPE1_BLK:         0x00000000
PM1_EVT_LEN:      4
PM1_CNT_LEN:      2
PM2_CNT_LEN:      1
PM_TM_LEN:        4
GPE0_BLK_LEN:     4
GPE1_BLK_LEN:     0
GPE1_BASE:        0
P_LVL2_LAT:       10
P_LVL3_LAT:       4097
FLUSH_SIZE:       0
FLUSH_STRIDE:     0
DUTY_OFFSET:      1
DUTY_WIDTH:       3
DAY_ALRM:         0x0d
MON_ALRM:         0x00
CENTURY:          0x32
Flags:            0x00000000
</verb></tscreen>

<!--
You should see the same entry names, though your values may vary. 
-->
と見えます。あなたも同じエントリ名が見えるはずですが、値は異なるかも
しれません。

<!--
Alternatively, instead of reading from /proc or if you have the 
includes-AML-interpreter driver you can read right from /dev/mem by doing
-->
もう一つの方法として、includes-AML-interpreter ドライバを使っているなら、/proc
から読む代わりに、一番確かな /dev/mem からテーブルを読むことができます。それは

<tscreen><verb>
acpidmp FACP | acpitbl 
</verb></tscreen>

<!--
which should net you the same results. This is the only option you have 
available to you if you said 'y' to CONFIG_ACPI_INTERPRETER. 
-->
<!-- 第１文、第２文ともに悩んだ末の意訳です -->
とすると、実際の値に非常に近い結果が得られます。CONFIG_ACPI_INTERPRETER に Y
 と答えた場合のみ利用できる方法です。

<!--
Pmtest is intended for device driver writers who are adding support for
different sleep states in their drivers. 
-->
pmtest はデバイスドライバの作者用です。作者が作者のドライバに異なる
スリープ状態のサポートを追加する時に使用します。

<!--
It is a kernel module which sets up the following entries in /proc:
-->
pmtest は /proc 内に以下のエントリをセットアップするカーネルモジュールです。

<tscreen><verb>
/proc/driver/pmtest/devices
</verb></tscreen>

<!--
  Reading from this interface lets you see which devices have been registered
  for power management, and what state they are in.
  It writes out triplets of 
    devicetype deviceid state 
  for each device, where state is 0-3 for device states D0-D3, devicetype is 
  0-5, where the mapping is given by the device types enumerated in  
  /usr/include/linux/pm.h, and deviceid is one of those also listed in 
  /usr/include/linux/pm.h.
-->
このインターフェースを読むことで、どのデバイスが電源管理のために登録されて
いるのか、そして、そのデバイスがどの状態にいるのか、調べることができます。
各々のデバイスについて、次の３つの項目を全部書き出しています。

<tscreen><verb>
devicetype deviceid state 
</verb></tscreen>

<!-- 悩んで表現をかえました -->
state は 0-3 で、D0-D3 のデバイスの状態に対応します。
devicetype は 0-5 で、/usr/include/linux/pm.h に列挙されたデバイスタイプに
対応します。
deviceid も /usr/include/linux/pm.h に記載された内の一つに対応します。

<tscreen><verb>
/proc/driver/pmtest/control
</verb></tscreen>

<!--
  Writing to this file lets you place one of the devices in the list shown in 
  /proc/driver/pmtest/devices into a suspend state (one of D0-D3).
  You should write a triplet like those you see when you look at
  /proc/driver/pmtest/devices above, 
    devicetype deviceid state
-->
このファイルに書くことで、/proc/driver/pmtest/devices で一覧表示される
デバイスの一つをサスペンド状態 (D0-D3 の一つ) に置くことができます。
/proc/driver/pmtest/devices を見た時と同じように、前述した次の３つの項目を
書かなければなりません。
　
<tscreen><verb>
devicetype deviceid state 
</verb></tscreen>

<!-- scrip tpmtest はたぶん、typo
You should use the perl scrip tpmtest in the same directory instead of using
the module directly. Why? Because it's easy, it's convenient, and then you
don't have to translate numeric device ids and types (for most commands).
-->
今まで説明したカーネルモジュール pmtest を直接使用する代わりに、同じ
ディレクトリ (既定では /usr/local/bin) にある perl スクリプトの pmtest を
使うべきです。なぜ？それは、簡単だし、便利だし、それから
 (ほとんどのコマンドで) デバイスの ID とタイプを数値に変換しなくてもいいから
です。
  
<!--
Make sure insmod and rmmod are in your path. You want to be root to run 
this. Pmtest loads the module, runs the command you give, and then unloads
the module, very convenient for testing.
-->
insmod と rmmod があなたの path にあることを確認してください。スクリプトは
 root で実行してください。pmtest はモジュールをロードし、与えられたコマンドを
実行し、それからモジュールをアンロードする、とてもテストには便利なものです。

<!--
Usage: pmtest [OPTION] [TYPE] [ID]

  where OPTION is one of:
    -l                   list devices (default)
    -d0                  resume device (ACPI D0)
    -d1, -d2, -d3        suspend device (ACPI D1-D3)

  and TYPE is one of:
    unknown PCI USB SCSI ISA system

  and ID is one of: 
    keyboard serial irda floppy vga pcmcia  
  or a specific device number from /usr/include/linux/pm.h.
-->
<verb>
使用法： pmtest [OPTION] [TYPE] [ID]

  OPTION は次の一つです。
    -l                   デバイスの一覧表示 (既定値)
    -d0                  デバイスをリジューム (ACPI D0)
    -d1, -d2, -d3        デバイスをサスペンド (ACPI D1-D3)

  TYPE は次の一つです。
    unknown PCI USB SCSI ISA system

  ID は次の一つです。
    keyboard serial irda floppy vga pcmcia  
  あるいは /usr/include/linux/pm.h にあるデバイスの数値を指定します。
</verb>

<!--
Examples:
  pmtest -l PCI           list all registered PCI devices
  pmtest -d0 VGA          resume (unblank) the console
  pmtest -d3 PCI 0x1234   suspend a PCI device
-->
<verb>
例として：
  pmtest -l PCI           PCI として登録されたデバイスの一覧表示
  pmtest -d0 VGA          コンソールをリジューム (見えるように)
  pmtest -d3 PCI 0x1234   ある PCI デバイスをサスペンド
</verb>

<!--
For example, on my laptop (with ACPI turned off), I see
-->
(ACPI をオフにした) 著者の laptop を例にすると、以下のように見えます。

<tscreen><verb>
  [root@devel2 pmtest]# ./pmtest -l
    VGA (D0)
    PCMCIA (D0)
    keyboard (D0)
    PCI 0x0 (D0)
</verb></tscreen>
 
<!--
2.4 Driver options
-->
<sect1> ドライバオプション

<p>
<!--
If you have the includes-AML-interpreter driver, there are no run-time 
options. 
-->
includes-AML-interpreter ドライバを使っているなら、実行時のオプションは
ありません。

<!--
If you have the no-AML-interpreter driver, the ACPI driver supports the 
following run-time (module or kernel boot) options:
-->
<!--訳注はくどいかもしれませんが書きました-->
no-AML-interpreter ドライバを使っているなら、ACPI ドライバは
 (モジュールまたはカーネルブートでの) 実行時に以下のオプションを
サポートします(訳注：既定値の説明は省略された場合、このオプションが
セットされているのかオフなのかを意味します)。

<descrip>
<!--
  on      upon initialization, the driver will try to find an ACPI-compliant
          device and use it. (set by default)
-->
<tag>on</tag>
初期化時、ドライバは ACPI 準拠デバイスを探し使えるようにしよう
とします。(既定値はセット)

<!--
  off     the driver will not look for an ACPI-compliant device, and will
          not do any ACPI event processing. No /p[roc entries will be created.
          Use this option to disable ACPI at runtime. If you compile in
          ACPI together with APM, you can use this option to turn off ACPI 
          so that APM handles power management events. (off by default) 
-->
<!-- /p[roc はたぶん /proc の typo -->
<tag>off</tag>
ドライバは ACPI 準拠デバイス を探さず、ACPI イベント処理を行いません。
/proc エントリも作成しません。このオプションは実行時に ACPI を無効にする
ために使います。APM とともに ACPI をコンパイルしているなら、この
オプションで ACPI をオフにし、APM で電源管理イベントを処理できます。
(既定値はオフ)

<!--
  tables  An ACPI BIOS provides several tables which contain information
          about capabilities, pointers to status registers, and pointers to
          registers which can cause a change in sleep status, among other 
          things. These tables are used by the driver to enable and trigger
          ACPI events. Generally, a given chipset should always have the same
          capabilities and registers, but if you want to be sure that you
          are using the tables provided by the BIOS, set this option. (off
          by default) 
-->
<tag>tables</tag>
ACPI BIOS はたくさんのテーブルを用意しています。これらのテーブルは、例えば、
能力、ステータスレジスタへのポインタ、スリープ状態に移行させるための
レジスタへのポインタ、の情報を含んでいます。ACPI イベントを有効にし、引き
起こすために、ドライバはこれらのテーブルを使います。通常、特定の
チップセットはいつも同じ能力とレジスタを持つはずですが、BIOS が用意する
テーブルを使うのが確実と思うなら、このオプションをセットします。
(既定値はオフ)

<!--
  chipset The counterpart to the tables option above, this option tells the
          driver to use a predefined table for one of a list of known chipsets;
          if your device is one of these and you suspect the BIOS-provided
          tables of being inaccurate, try this option. The list of chipsets
          for which this option is supported is currently PIIX4 and VIA. 
          (off by default) 
-->
<!-- 訳に of being inaccurate がもりこめてません -->
<tag>chipset</tag>
<!--draft1
前記のオプション tables と似たようなもので、このオプションは、既知の
チップセットのリスト中のチップセットのためあらかじめ用意されたテーブルを
使うこと、をドライバに伝えます――あなたのデバイスがこのリストにあるもので、
BIOS が用意したテーブルが疑わしいなら、このオプションを使ってみてください。
現在このオプションでこのオプションでサポートされるチップセットのリストは
 PIIX4 と VIA です。(既定値はオフ)
-->
前記のオプション tables と似たようなもので、このオプションは、既知の
チップセットのリスト中のチップセットのためあらかじめ用意されたテーブルを
使うこと、をドライバに伝えます――あなたのデバイスがこのリストにあるもので、
BIOS が用意したテーブルを間違いではないかと思っている場合、
このオプションを使ってみてください。
現在このオプションでこのオプションでサポートされるチップセットのリストは
 PIIX4 と VIA です。(既定値はオフ)

<!--
  no-errata  The ACPI implementor may have 'published' changes to the 
          root-level ACPI table header (RSDP). In theory, this option should
          tell the driver to ignore these changes. In practice, this option
          appears to be unimplemented in the current version of the driver.
-->
<tag>no-errata</tag>
ACPI の実装社 (者) は root-level ACPI table header (RSDP) の変更を
 &dquot;公開&dquot; したかもしれません。理論的には、このオプションはこれらの
変更を無視するようドライバに伝えるはずです。実際には、現時点のドライバの
バージョンで、このオプションは実装されていないようです。

<!--
  copy-tables If this option is set, the FACP and DSDT ACPI tables will be
          copied to a new location in memory before they are used. Some 
          ACPI BIOSes require this. These BIOSes put the tables in low memory
          without being reserved by the memory map code. Copying ensures
          that we have a good snapshot of the table available for later use.
          You'll know if your BIOS is one of these by noticing if, upon   
          initialization, the driver writes the error 
             "ACPI: unreserved memory @ 0xnn!" 
          in /var/log/messages. (For a fixed list of BIOSes this option is on 
          by default; currently that list consists of AMI only.  For all 
          other BIOSes, this option is off by default.)
-->
<!-- low はあえて訳しませんでした -->
<!-- 既定値の説明で AMI は on となっていますが、セットと訳しています -->
<tag>copy-tables</tag>
このオプションがセットされていると、FACP と DSDT の ACPI のテーブルは、
それらが使われる前にメモリの新しい場所にコピーされます。いくつかの
 ACPI BIOS は、これを必要とします。これらの BIOS は memory map code によって
まだ確保されていない low メモリにテーブルを置きます。コピーは、後で使うことが
可能なテーブルの十分なスナップショットを持つことを保証します。初期化時に
 /var/log/messages に "ACPI: unreserved memory @ 0xnn!" と書くなら、この
 BIOS はコピーの必要な BIOS であることがわかります。(既定値をセットにする
 BIOS はリストで決まっています。現在このリストに含まれているのは AMI だけ
です。他の BIOS でのこのオプションの既定値はオフです。)

<!--
  trust-tables This option is generally used in conjunction with the copy-table
          option above. Use it when your BIOS publishes ACPI tables in low
          memory without them being reserved by the memory map code. You'll
          see the same message as above in your log. WARNING: if you use this 
          option and the tables are not really there, a kernel panic will 
          result. (For a fixed list of BIOSes this option is on 
          by default; currently that list consists of AMI only.  For all 
          other BIOSes, this option is off by default.)
-->
<tag>trust-tables</tag>
このオプションは通常、前記の copy-table オプションと一緒に使われます。BIOS
 が、memory map code によってまだ確保されていない low メモリに ACPI テーブル
を公開する時に、このオプションを使います。ログに前記と同じメッセージが
書かれます。警告――このオプションを使い、テーブルが実際に存在しないなら、
カーネルパニックを起こします。 (既定値をセットにする BIOS はリストで決まって
います。現在このリストに含まれているのは AMI だけです。他の BIOS でのこの
オプションの既定値はオフです。)

<!--
  no-sci  If this option is enabled, no irq will be requested for ACPI and 
          no events will be enabled or processed. In particular, changes may 
          not be made to the pm1x_evt, gpe0 and gpe1 registers. You may want
          to use this option if you would like the driver to load the ACPI 
          tables but not to do any event handling, for debugging purposes. 
	  (off by default)
-->
<tag>no-sci</tag>
このオプションが有効なら、ACPI のために irq を使用せず、有効なイベントや
処理されるイベントはありません。詳しく言えば、pm1x_evt, gpe0, gpe1 レジスタに
対する変更を行いません。デバッグ目的のためにドライバに ACPI テーブルをロード
したいが、いくつかのイベントの扱いはしたくない時に、このオプションを使うと
いいでしょう。(既定値はオフ)

<!--
  no-c2   Before initialization, some global variables are set so that the 
  no-c3   processor power states C2 and C3 states cannot be entered. During 
          normal initialization, C2 (cpu idle) and C3 (cpu idle, caches
          ignore snoops) states are both enabled. This step will be skipped 
          if these options are enabled. Set the no-c2 option to disable 
          entering C2; set no-c3 to disable entering C3. (off by default)
-->
<!-- オプションの enable という表現は統一性のためセットにかえました -->
<tag>no-c2, no-c3</tag>
<!--draft1
初期化前に、プロセッサの電源状態が C2 と C3 の状態に入ることができない
ように、いくつかのグローバル変数をセットします。普通の初期化の間に、C2
 (CPU アイドル) と C3 (CPU アイドル、キャッシュはスヌープを無視する) の状態は
両方とも有効にされます。これらのオプションをセットすると、このステップは
スキップされます。no-c2 オプションをセットすると、C2 状態に入れなくなります。
no-c3 オプションをセットすると、C3 状態に入れなくなります。(既定値はオフです)
-->
初期化前に、プロセッサの電源状態が C2 と C3 の状態に入ることができない
ように、いくつかのグローバル変数をセットします。普通の初期化の間に、C2
 (CPU アイドル) と C3 (キャッシュがスヌープを無視する CPU アイドル) の状態は
両方とも有効にされます。これらのオプションをセットすると、このステップは
スキップされます。no-c2 オプションをセットすると、C2 状態に入れなくなります。
no-c3 オプションをセットすると、C3 状態に入れなくなります。(既定値はオフです)

<!--
  no-s1   If these options are enabled, the S1 and S5 sleeping states will 
  no-s5   not be entered. Set no-s1 to disable entering S1 or sleep mode; set 
          no-s5 to disable entering S5 (soft off). (no-s5 is off by default; 
          no-s1 is on if CONFIG_ACPI_S1_SLEEP was not defined during 
          configuration of the kernel, and off otherwise) 
-->
<!-- オプションの enable という表現は統一性のためセットにかえました -->
<tag>no-s1, no-s5</tag>
<!--draft1
これらのオプションがセットされると、S1 と S5 のスリープ状態に入りません。
no-s1 オプションをセットすると、S1 状態あるいはスリープモードに入れなく
なります。no-s5 オプションをセットすると、S5(ソフトオフ) 状態に入れなく
なります。(no-s5 の既定値はオフです。no-s1 の既定値は、
カーネルコンフィグレーション時に CONFIG_ACPI_S1_SLEEP を定義していないなら
オン、定義したならオフです。)
-->
これらのオプションがセットされると、S1 と S5 のスリープ状態に入りません。
no-s1 オプションをセットすると、S1 状態あるいはスリープモードに入れなく
なります。no-s5 オプションをセットすると、S5(ソフトオフ) 状態に入れなく
なります。(no-s5 の既定値はオフです。no-s1 の既定値は、
カーネルコンフィグレーション時に CONFIG_ACPI_S1_SLEEP を定義していないなら
セット、定義したならオフです。)
</descrip>

<!--
2.5 System resource settings
-->
<sect1> システムリソースの設定

<p>
<!--
If the pci driver cannot find an interrupt for the appropriate pin of the
ACPI device, you may need to specify pci=biosirq as a boot option to the
kernel.  Ordinarily the kernel looks for the IRQ routing table for PCI
interrupts in the region of memory reserved for that table, but if it
cannot find the table, and the pci=biosirq option is set, the kernel will then 
proceed to try to get the same information from the PCI BIOS.
-->
pci ドライバが ACPI デバイスの適切な割込みの pin を見つけることができないなら
ブートオプションとして、カーネルに pci=biosirq を指定する必要があるかも
しれません。通常カーネルは IRQ ルーティングテーブルのために確保された
メモリ領域の中から PCI 割込みのためのテーブルを探します。しかし、テーブルが
見つからない場合、pci=biosirq オプションをセットすれば、カーネルは PCI BIOS
 から同じ情報を得ようとします。

<!--
In rare cases the ACPI interrupt may conflict with some other device already
configured on your system. You may disable that other device or try to 
reconfigure it. To check for interrupt conflicts, 
cat /proc/interrupts
and examine the output. The only devices you should see that share an interrupt
with the ACPI device are PCI devices; all others should be using some other
interrupt(s). My sample output, for example, shows
-->
まれなケースで ACPI 割込みが既にシステムに構成したいくつかの他のデバイスと
衝突してるかもしれません。衝突したデバイスを無効にするか、それを再構成するか
してみてください。割込みの衝突をチェックするには

<tscreen><verb>
cat /proc/interrupts
</verb></tscreen>

とし、その出力を調べてください。ただし PCI デバイスだけは、ACPI デバイスと
割込みを共有することができます――他のすべてのデバイスは、いくつかの他の
割込みを使用しなければなりません。例として、著者のサンプル出力を記載します。

<!--
[ariel@devel2 kernel]$ cat /proc/interrupts
           CPU0
  0:    5416567          XT-PIC  timer
  1:      55261          XT-PIC  keyboard
  2:          0          XT-PIC  cascade
  3:     364126          XT-PIC  wvlan_cs
  8:          7          XT-PIC  rtc
  9:        134          XT-PIC  ACPI, Ricoh Co Ltd RL5c478, Ricoh Co Ltd RL5c478
(#2)
 12:     602159          XT-PIC  PS/2 Mouse
 13:          1          XT-PIC  fpu
 14:     129102          XT-PIC  ide0
 15:          9          XT-PIC  ide1
NMI:          0
ERR:          0
-->
<tscreen><verb>
[ariel@devel2 kernel]$ cat /proc/interrupts
         CPU0
  0:  5416567  XT-PIC  timer
  1:    55261  XT-PIC  keyboard
  2:        0  XT-PIC  cascade
  3:   364126  XT-PIC  wvlan_cs
  8:        7  XT-PIC  rtc
  9:      134  XT-PIC  ACPI, Ricoh Co Ltd RL5c478, Ricoh Co Ltd RL5c478 (#2)
 12:   602159  XT-PIC  PS/2 Mouse
 13:        1  XT-PIC  fpu
 14:   129102  XT-PIC  ide0
 15:        9  XT-PIC  ide1
NMI:        0
ERR:        0
</verb></tscreen>

<!--
A quick check of /proc/pci shows that the two Ricoh devices are cardbus
bridges on the PCI bus, so they can share the same interrupt comfortably.
-->
/proc/pci をちょっと調べると、２つの Ricoh デバイスが PCI バスの
カードバスブリッジにあるのが見えています。このように PCI デバイスは気楽に同じ
割込みを共有できます。

<!--
One user reported seeing both ACPI and fpu on 13; this is a case of a 
genuine conflict which must be resolved if the device is to function
properly.
-->
あるユーザは IRQ 13 上に ACPI と fpu が見えていると報告してきました――これは
本物の衝突のケースで、デバイスを正常に機能させたいなら、衝突を解決しなければ
なりません。

<!--
3.1 What are all these proc entries and how can I use them?
-->
<sect> その他のドライバ情報
<sect1> proc エントリとその使い方

<p>
<!--
If you have the includes-AML-interpreter driver, read this section.
-->
includes-AML-interpreter ドライバを使っているなら、この項を読んでください。

<tscreen><verb>
/proc/sys/acpi/c2_exit_latency
/proc/sys/acpi/c3_exit_latency
</verb></tscreen>

<!--
    These indicate the latency for exiting level 2 or level 3 processor 
    sleep states (C2 or C3). These can be used to do things like "sleep in 
    C2 until the power drops to %n (where %n is computed based on the 
    latency for coming out of C3)..."
    Initially they are set to infinity, but when C2 and C3 are enabled, 
    these are determined by values in the FACP table. 
    If your driver cannot read the tables fro the BIOS and relies on
    its predefined tables instead, these values are left at infinity.
    You will then have to change them yourself to some reasonable values 
    in order to enable C2 and C3 states. 
-->
<!--第４文の fro は意味が取れなかったので typo と考え from とし訳しました-->
<quote>
<!--draft1
これらはレベル２かレベル３のプロセッサのスリープ状態 (C2 か C3) から抜け出る
ための待ち時間を表します。
最初は無限大に設定されますが、C2 と C3 が有効にされる時に FACP テーブル上の
値によって決定されます。ドライバが BIOS のテーブルを読めず、とあらかじめ定義
した BIOS の変わりのテーブルを信頼するなら、これらの値は無限大のままです。
そのときは、C2 と C3 状態を正常に有効にするためには、自分で妥当な値に変更
しなければなりません。
-->
これらはレベル２かレベル３のプロセッサのスリープ状態 (C2 か C3) から抜け出る
ための待ち時間を表します。これらは、次のように使うことができます。&dquot;
電源断 %n 経過するまで C2 でスリープ (%n は C3 に移行するまでの待ち時間
として見積られている)・・・&dquot;。
最初は無限大に設定されますが、C2 と C3 が有効にされる時に FACP テーブル上の
値によって決定されます。ドライバが BIOS のテーブルを読めず、とあらかじめ定義
した BIOS の変わりのテーブルを信頼するなら、これらの値は無限大のままです。
そのときは、C2 と C3 状態を正常に有効にするためには、自分で妥当な値に変更
しなければなりません。
</quote>

<tscreen><verb>
/proc/sys/acpi/c2_enter_latency
/proc/sys/acpi/c3_enter_latency
</verb></tscreen>

<!--
    These indicate the latency for entering C2 or C3 sleep states.
    These are pretty short and are fixed, except initially when they are 
    infinite (so that the states will not be entered until they are 
    specifically enabled).
-->
<quote>
これらは C2 か C3 のスリープ状態に入るための待ち時間を表します。
これらは非常に短く一定しています。最初は例外で無限大になっています (だから
この状態には、はっきりと有効にするまで入りません)。
</quote>

<tscreen><verb>
/proc/sys/acpi/event
</verb></tscreen>

<!--
    Reading from this entry shows you the hex value associated with ACPI events
    noticed by the BIOS (and enabled). If in one window you do
    cat /proc/sys/acpi/event
    and in another window try pressing various buttons and key combinations,
    you can see if any of them register as ACPI events and how they register.
    Not all events are enabled by the driver. Currently there is no way to
    enable all events as you could do under the no-AML-interpreter driver.
    Your power button will only be visible as an event under 
    /proc/sys/acpid/event if it is enabled by the driver.
-->
<quote>
このエントリを読むことで、BIOSによって通知された (有効になっている)
 ACPI イベントに関連付けられた 16 進数を見ることができます。一つのウィンドウで
</quote>

<tscreen><verb>
cat /proc/sys/acpi/event
</verb></tscreen>

<quote>
とし、もう一つのウィンドウで様々なボタンとキーの組合せを押して見てください。
それらのいくつかが ACPI イベントとして登録されていれば、イベントを見ることが
でき、どのように登録されているかわかります。
ドライバはすべてのイベントを有効にしてはいません。現在 no-AML-interpreter
 ドライバの下で使用できるすべてのイベントを有効にする方法はありません。
ドライバによって電源ボタンが有効になっていても、それは /proc/sys/acpid/event
 の下のイベントとして見えるだけです。
</quote>

<tscreen><verb>
/proc/sys/acpi/sleep
</verb></tscreen>
  
<!--
     Writing to this is currently the only way to put the system into a sleep
     state; specifically, it will enter S1 if you 
-->
<quote>
これに書くことは、システムをスリープ状態に置く現在唯一の方法です――具体的に
</quote>

<tscreen><verb>
echo 1 > /proc/sys/acpi/sleep
</verb></tscreen>

<quote>
とすれば、S1 に入ります。
</quote>

<!--
     WARNING: before you do this, it is a good idea to quit unnecessary 
     processes. Possibly, your system may not recognize the various key
     presses that are supposed to trigger a wake-up! (Mine does not with the
     current driver.)
-->
<quote>
警告――これをする前に、不要なプロセスを終了してください。ひょとしたら、
目覚めのきっかけに想定されている様々なキーを押すことをシステムは認識しない
かもしれません(著者のものは、現在のドライバでキーを押すことを認識しません)。
</quote>

<!--
If you have the no-AML-interpreter driver, read this section.
-->
no-AML-interpreter ドライバを使っているなら、この項を読んでください。

<!--
  Most of the ACPI /proc entries are informational; a few can be used to 
  trigger ACPI events. Here is a decription of each one and how it can be used.
-->
<quote>
ACPI の /proc エントリのほとんどは、通知です――いくつかは ACPI イベントを
引き起こすのに使えます。それぞれ通知の詳細と使い方を記載します。
</quote>

<tscreen><verb>
/proc/sys/acpi/facp
</verb></tscreen>
 
<!--
    This allows access to the FACP table header and body. Reading this gives
    you a look at the table, which can can be examined to understand your
    ACPI's capabilities and current state; writing to it can either replace
    the header and body of the entire table (ordinarily only done by the 
    driver) or can update the value of a single register. To read the FACP
    table and make any sense of it, you probably want to use the pmtools
    package and run the command
-->
<quote>
これは FACP テーブルのヘッダとボディにアクセスすることを許します。これを
読むことで、ACPI の能力と現在の状態を分かるために調査できるテーブルを見る
ことができます――書くことで、完全なテーブルのヘッダとボディの差し替え (普通は
ドライバにより完了しています) か、一つのレジスタの値の変更、のどちらかが
できます。FACP テーブルを読み、それを理解するためには、pmtools パッケージを
使った方がいいでしょう。次のコマンドを実行してください。
</quote>

<tscreen><verb>
acpitbl /proc/sys/acpi/facp
</verb></tscreen>

<!--
    which presents a more-or-less human-readable dump of the table.
-->
<quote>
幾分人間の読める形でテーブルのダンプが表示されます。
</quote>

<tscreen><verb>
/proc/sys/acpi/dsdt
</verb></tscreen>
   
<!--
    This allows access to the DSDT table header and body.  The notes on the
    facp entry hold here as well, with the exception that, to read the dsdt
    entry and make sense of it, you will want to run the command
-->
<quote>
これは DSDT テーブルのヘッダとボディにアクセスすることを許します。
例外はありますが、facp エントリの注釈と同じことがいえます。dsdt エントリを
読み、それを理解するには、次のコマンドを実行するといいでしょう。
</quote>

<tscreen><verb>
acpitbl /proc/sys/acpi/dsdt 
</verb></tscreen>

<!--
    to look at the header, and 
-->
<quote>
とすれば、ヘッダが見え、
</quote>

<tscreen><verb>
cat /proc/sys/acpi/dsdt | acpidisasm    
</verb></tscreen>

<!--
    to read the AML (disassembled).
-->
<quote>
とすれば (解釈された) AML を読めます。
</quote>

<!-- shsys はたぶん typo
    /proc/shys/acpi/pm1_enable
-->
<tscreen><verb>
/proc/sys/acpi/pm1_enable
</verb></tscreen>
   
<!--
    Reading from this entry shows you which power management events are
    enabled. Each event has a corresponding bitmask; if the bits in the
    value corresponding to that mask are set, then the event is enabled,
    otherwise, it is disabled. Writing to this entry enables events. To
    enable all power management events that your ACPI implementation supports,
    write "0xffffffff" to the entry. When you read it, you will most likely 
    not see 0xffffffff as the value, because not all defined events will be 
    supported. (Even if they were, are all the bits in use?)
-->
<quote>
このエントリを読むことで、どの電源管理イベントが有効にされているかみることが
できます。各々のイベントはビットマスクに対応しています――そのマスクに対応した
値のビットがセットならイベントは有効で、オフならイベントは無効です。ACPI の
実装でサポートしているすべての電源管理イベントを有効にするには、このエントリに
 &dquot;0xffffffff&dquot; を書きます。このエントリを呼んだ場合、たぶん値は
 0xffffffff ではありません。なぜなら、すべての定義されたイベントがサポート
されていないからです (もしサポートされたとすると、すべてのビットは使われる
のかな？)。
</quote>

<!--
    How to determine which events correpsond to which bitmasks...
-->
<quote>
どのイベントをどのビットマスクに対応させるか決める方法は・・・
</quote>

<tscreen><verb>
/proc/sys/acpi/gpe_enable
</verb></tscreen>
   
<!--
    Reading from this entry shows you which general purpose events are enabled.
    Manipulating this entry is done in the same way as the pm1_enable entry
    described above. 
-->
<quote>
このエントリを読むことで、どの汎用イベントが有効にされているかみることが
できます。前述の pm1_enable と同じ方法でこのエントリを操作できます。
</quote>

<!--
    How to determine which events correspond to which bitmasks...
-->
<quote>
どのイベントをどのビットマスクに対応させるか決める方法は・・・
</quote>

<tscreen><verb>
/proc/sys/acpi/gpe_level 
</verb></tscreen>

<!--
    Reading from this entry shows you which level the current general purpose 
    events are; writing to it changes that level. (Read the spec for more 
    info; section 4.7 talks about child events a bit.) 
-->
<quote>
このエントリを読むことで、汎用イベントがどのレベルなのか見ることが
できます――このエントリに書くことはレベルを変更することになります (詳細は
セクション 4.7 のチャイルドイベントのビットについての記述を見てください)。
</quote>

<tscreen><verb>
/proc/sys/acpi/event
</verb></tscreen>

<!--
    Reading from this entry shows you the hex value associated with ACPI events
    noticed by the BIOS (and enabled). If you enable all events by writing
    0xffffffff to gp1_enable and pm1_enable, and then in one window do
    cat /proc/sys/acpi/event
    and in another window try pressing various buttons and key combinations,
    you can see if any of them register as ACPI events and how they register.
    This is one way to see what your power button does, for example.
-->
<quote>
このエントリを読むことで、BIOSによって通知された (有効になっている)
 ACPI イベントに関連付けられた 16 進数を見ることができます。gp1_enable と
 pm1_enable に 0xffffffff を書くことですべてのイベントを有効にしているなら、
次いで一つのウィンドウで
</quote>

<tscreen><verb>
cat /proc/sys/acpi/event
</verb></tscreen>

<quote>
とし、もう一つのウィンドウで様々なボタンとキーの組合せを押して見てください。
それらのいくつかが ACPI イベントとして登録されていれば、イベントを見ることが
できます。例えば、これは、電源ボタンが何かを見る一つの方法です。
</quote>

<!--
    For example, on my Sony VAIO, I did the following:
-->
<quote>
例として、著者の Sony VAIO で実行した結果を以下に示します。
</quote>

<tscreen><verb>
[root@devel2 kernel]# echo 0xffffffff > /proc/sys/acpi/pm1_enable
[root@devel2 kernel]#  echo 0xffffffff > /proc/sys/acpi/gpe_enable
[root@devel2 kernel]# cat /proc/sys/acpi/pm1_enable
0x00000521
[root@devel2 kernel]# cat /proc/sys/acpi/gpe_enable
0x00000f01
(press power button)
[root@devel2 kernel]# cat /proc/sys/acpi/event
0x00000001 0x00000000 0x0
0x00000001 0x00000000 0x0
0x00000000 0x00000200 0x0
</verb></tscreen>

<!--
    You can see the power button press: it's the last line in the cat.
-->
<quote>
電源ボタンの押したことをみることができます――それは cat の最後の行です。
</quote>

<tscreen><verb>
/proc/sys/acpi/p_blk
</verb></tscreen>

<!--
    There is one of these for each processor (according to the spec); it's
    used to control the processor, for example, to put it into C2 or C3 state.
    The driver only supports one processor at the moment, so there is only
    space for one of these in the /proc interface. You should never need to
    write to it directly; the driver will do that for you when switching
    from one sleep state to another.
-->
<quote>
(仕様によれば) 各々のプロセッサのためにこれらの一つがあります――例えば C2 か
 C3 の状態にプロセッサを置くような、プロセッサの制御に使われます。
ドライバはある瞬間をとらえると一つのプロセッサだけをサポートしていますので、
/proc インターフェースにはこれらの一つの場所しかありません。ここに直接書く
必要は絶対にありません――一つのスリープ状態からもう一つの状態に切り換える時、
ドライバが書き込みます。
</quote>

<tscreen><verb>
/proc/sys/acpi/p_lvl2_lat
/proc/sys/acpi/p_lvl3_lat
</verb></tscreen>

<!--
    These indicate the latency for exiting level 2 or level 3 sleep states.
    These can be used to do things like "sleep in C2 until the power drops
    to %n (where %n is computed based on the latency for coming out of C3)..."
    Initially they are set to infinity, but when C2 and C3 are enabled, 
    these are determined by values in the FACP table. If you are using the   
    'chipset' option to the driver, these values are set to infinity and
    are never changed; you will have to change them yourself to some 
    reasonable values in order to enable C2 and C3 states. Likewise if the
    driver can't find your tables and falls back to using the chipset 
    information, you will have to set the values yourself.
-->
<!--最後の文の falls back は失敗としました-->
<quote>
<!--draft1
これらはレベル２かレベル３のプロセッサのスリープ状態から抜け出るための
待ち時間を表します。
最初は無限大に設定されますが、C2 と C3 が有効にされる時に FACP テーブル上の
値によって決定されます。ドライバに 'chipset' オプションを使用するなら、
これらの値は無限大に設定され、決して変更しません――C2 と C3 状態を正常に
有効にするためには、自分で妥当な値に変更しなければなりません。同様に、
ドライバがテーブルを見つけることができず、チップセット情報の使用が失敗した
なら、自分で値を設定しなければなりません。
-->
これらはレベル２かレベル３のプロセッサのスリープ状態から抜け出るための
待ち時間を表します。これらは、次のように使うことができます。&dquot;
電源断 %n 経過するまで C2 でスリープ (%n は C3 に移行するまでの待ち時間
として見積られている)・・・&dquot;。
最初は無限大に設定されますが、C2 と C3 が有効にされる時に FACP テーブル上の
値によって決定されます。ドライバに 'chipset' オプションを使用するなら、
これらの値は無限大に設定され、決して変更しません――C2 と C3 状態を正常に
有効にするためには、自分で妥当な値に変更しなければなりません。同様に、
ドライバがテーブルを見つけることができず、チップセット情報の使用が失敗した
なら、自分で値を設定しなければなりません。
</quote>

<tscreen><verb>
/proc/sys/acpi/enter_lvl2_lat
/proc/sys/acpi/enter_lvl3_lat
</verb></tscreen>

<!--
    These indicate the latency for entering level 2 or level 3 sleep states.
    These are pretty short and are fixed, except initially when they are 
    infinite (so that the states will not be entered until they are 
    specifically enabled).
-->
<quote>
これらはレベル２かレベル３のスリープ状態に入るための待ち時間を表します。
これらは非常に短く一定しています。最初は例外で無限大になっています (だから
この状態には、はっきりと有効にするまで入りません)。
</quote>

<tscreen><verb>
/proc/sys/acpi/s0_slp_typ
/proc/sys/acpi/s1_slp_typ
/proc/sys/acpi/s5_slp_typ
</verb></tscreen>

<!--
    These indicate the value that, after some processing, needs to be stuffed
    into pm1a_cnt and pm1b_cnt in order to place your system into the 
    appropriate sleep state (S0, S1, or S5).  The driver does not initialize
    these by itself; acpid looks them up via the BIOS nd then asks the driver 
    to set them according to the values it retrieved. If you have trouble
    with acpid and want to set these values directly, you could try guessing
    according to the chipset, or you could try looking at the output from
    a dump of the DSDT. (Use the command acpidmp DSDT | acpidisasm.) It may 
    indicate the values in a section something like:
-->
<quote>
これらは、いくつかの処理の後、正常にシステムを適切なスリープ状態 (S0, S1, S5)
 に置くために、pm1a_cnt と pm1b_cnt に詰め込む必要のある値を表します。
ドライバはこれらを初期化しません――acpid は BIOS を通してそれらを参照し、
ドライバが受け取った値によってそれらを設定するかドライバにたずねます。
acpid に問題があり直接これらの値を設定したいなら、チップセットによって推測し
試すか、DSDT のダンプ (&dquot;acpidmp DSDT | acpidisasm&dquot; のコマンドを
使う) の出力から見つけることができます。DSDT のダンプのこの項に関するところは
次のようなものになります。
</quote>

<tscreen><verb>
00000013: Name _S0_ (\_S0_)
00000018:   Package
0000001a:     0x04
0000001b:     0x05
0000001d:     0x05
0000001f:     0x00
00000021:     0x00
00000023: Name _S1_ (\_S1_)
00000028:   Package
0000002a:     0x04
0000002b:     0x04
0000002d:     0x04
0000002f:     0x00
00000031:     0x00
00000033: Name _S3_ (\_S3_)
00000038:   Package
0000003a:     0x04
0000003b:     0x01
0000003d:     0x01
0000003f:     0x00
00000041:     0x00
</verb></tscreen>

<!--
    and so on. You can see that the second and third bytes in each entry
    correspond to the values in the logs below.
-->
<quote>
出力はたくさん続きます。各々のエントリの２番目と３番目のバイトは、下記に示す
ログの値に対応します。
</quote>

<!--
    If acpid is working, you can also see these values in /var/log/messages, 
    written when acpid starts up.
    For example, my log entries look like
-->
<quote>
acpid が動作しているなら、acpid が起動した時に /var/log/messages に書き込む
これらの値を見ることができます。
例として、著者のログエントリは以下のようになっています。
</quote>

<tscreen><verb>
Jun 11 00:51:02 devel2 acpid: S0 SLP_TYP (0x0505)
Jun 11 00:51:02 devel2 acpid: S1 SLP_TYP (0x0404)
Jun 11 00:51:02 devel2 acpid: S2 not supported
Jun 11 00:51:02 devel2 acpid: S3 SLP_TYP (0x0101)
Jun 11 00:51:02 devel2 acpid: S4 SLP_TYP (0x0000)
Jun 11 00:51:02 devel2 acpid: S5 SLP_TYP (0x0000)
</verb></tscreen>

<!--
    Yes, you get a couple of bonus numbers for which there are no proc entries
    currently.
-->
<quote>
<!--draft1
そうです、数値２つを得られますが、現在の proc エントリではありません。
-->
そうです、おまけの数値２つを得れますが、現在の proc エントリではありません。
</quote>

<tscreen><verb>
/proc/sys/acpi/sleep
</verb></tscreen>
<!--
     Writing to this is currently the only way to put the system into a sleep
     state; specifically, it will enter S1 if you 
-->
<quote>
これに書くことは、システムをスリープ状態に置く現在唯一の方法です――具体的に
</quote>

<tscreen><verb>
echo 1 > /proc/sys/acpi/sleep
</verb></tscreen>

<quote>
とすれば、S1 に入ります。
</quote>

<!--
     WARNING: before you do this, it is a good idea to quit unnecessary 
     processes. Possibly, your system may not recognize the various key
     presses that are supposed to trigger a wake-up! (Mine does not with the
     current driver.)
-->
<quote>
警告――これをする前に、不要なプロセスを終了してください。ひょとしたら、
目覚めのきっかけに想定されている様々なキーを押すことをシステムは認識しない
かもしれません(著者のものは、現在のドライバでキーを押すことを認識しません)。
</quote>

<!--
3.2 What do these messages from 'e820' in /var/log/messages mean?
-->
<sect1> /var/log/messages 内の 'e820' からのメッセージの意味は何か？

<p>
<!--
    You may see messages like these in your /var/log/messages:
-->
/var/log/messages 内に次のようなメッセージを見るかもしれません。

<tscreen><verb>
e820: 000000000000f800 @ 0000000003ff0000 (ACPI data)
e820: 0000000000000800 @ 0000000003fff800 (ACPI NVS) 
</verb></tscreen>

<!--
    Interrupt 15 subfunction e820 causes the BIOS to return the system memory
    map. 
-->
割込み 15 のサブファンクション e820 は、システムメモリマップを返すために BIOS
 が引き起こしています。

<!--
    The data area includes the various ACPI tables. This area cvan be reclaimed
    by the OS when it's done using the tables.
-->
データ領域は、様々な ACPI テーブルが含まれます。テーブルの使用が終わったとき、
OS はこの領域を取り戻します。

<!--
    NVS stands for Non-Volatile-Sleeping Memory; this area is supposed to 
    be saved and restored by the OS before entering the S4 state. This area 
    can never be reclaimed.
-->
<!-- cvan は can の typo -->
NVS は Non-Volatile-Sleeping Memory の略語です――これは S4 状態に入る前に
 OS が保存と復旧を行う領域として想定されています。この領域は決して取り
戻されません。

<!--
    If you don't see the ACPI data message in your logs, this is probably
    an indication that the driver can't find the tables. If it appears to be
    working anyways, it is probably using chipset-specific information. 
    You can experiment with the boot options to find out (see section 2.4
    for more information).
-->
ログ内に ACPI のデータ領域が見えないなら、これはたぶん、ドライバがテーブルを
見つけられなかったことを表します。どうにか動作していると思われるなら、たぶん
チップセット固有の情報を使っています。調査のためにブートオプションを試みる
ことができます (詳細は セクション 2.4 を見てください)。

<!--
4.1 The driver isn't working right for me. How can I figure out
    what's wrong?  
-->
<sect> デバッグのこつとプログラミング情報
<sect1> ドライバが正しく動作していない。いかにして何が悪いか解明するか？

<p>
<!--
    If you have the includes-AML-interpreter driver, read this section.
-->
includes-AML-interpreter ドライバを使っているなら、この項を読んでください。

<!--
      First, is the driver initializing? You can determine this by checking for
      /proc/sys/acpi entries.
-->
<quote>
最初にドライバが初期化を行っているか？/proc/sys/acpi エントリをチェックする
ことで確認できます。
</quote>

<!--
      If it is, does your driver locate the APCI tables for your BIOS or
      is it guessing based on the chipset? You can determine this by 
      looking in /var/log/messages for the message 'ACPI: support found'; if 
      you see this message, the driver is getting the table information from
      the BIOS. If you don't see this message, but the driver has initialized,
      you are using chipset-based information, predefined for the PIIX4 or the 
      VIA.
-->
<quote>
エントリがあれば、ドライバが BIOS のための ACPI テーブルを置いたか、
チップセットに基づき推測したのか？
/var/log/messages 内に 'ACPI: support found' の
メッセージが見えるかどうかで確認できます――このメッセージが見えれば、
ドライバは BIOS からテーブル情報を得ています。このメッセージが見えなくとも、
ドライバは初期化をし、(PIIX4 か VIA のためにあらかじめ定義された)
 チップセットに基づく情報を使っています。
</quote>

<!--
      If it is using the tables, what do they show? Use 
      acpidmp DSDT | acpidisasm 
      and 
      acpidmp FACP | acpitbl 
      to examine them.    
-->
<quote>
テーブルを使用しているなら、何を見てるのか？
</quote>

<tscreen><verb>
acpidmp DSDT | acpidisasm 
</verb></tscreen>

<quote>
と
</quote>

<tscreen><verb>
acpidmp FACP | acpitbl 
</verb></tscreen>

<quote>
のコマンドを使い調査します。
</quote>

<!--
      Does pressing your power button register as an ACPI event? To check this,
      cat /proc/sys/acpi/events
      and watch it; then in another window press the power button. Do you
      see a change? A non-zero value? Do you see instead an entry in 
      /var/log/messages, like 'ACPI: EC GPE'?
-->
<quote>
電源ボタンを押すことが ACPI イベントとして登録されているか？チェックのために
</quote>

<tscreen><verb>
cat /proc/sys/acpi/events
</verb></tscreen>

<quote>
とし、監視してください――それからもう一つのウィンドウでパワーボタンを
押します。変更が見えましたか？０でない値ですか？代わりに /var/log/messages
に 'ACPI: EC GPE' のようなエントリが見えますか？
</quote>

<!--
      This is a pretty preliminary checklist; suggestions are appreciated.
-->
<quote>
これは、ちょっとした予備的なチェックリストです――十分理解することを提案
します。
</quote>

<!--
    If you have the no-AML-interpreter driver, read this section.
-->
no-AML-interpreter ドライバを使っているなら、この項を読んでください。

<!--
      First, is the driver initializing? You can determine this by checking for
      /proc/sys/acpi entries.
-->
<quote>
最初にドライバが初期化を行っているか？/proc/sys/acpi エントリをチェックする
ことで確認できます。
</quote>

<!--
      If it is, does your driver locate the APCI tables for your BIOS or
      is it guessing based on the chipset? You can determine this by using the
      tables option to the driver and see if the driver still initializes.
-->
<quote>
エントリがあれば、ドライバが BIOS のための ACPI テーブルを置いたか、
チップセットに基づき推測したのか？
ドライバの tables オプションを使い、ドライバが初期化
していることを見れば確認できます。
</quote>

<!--
      If it is using the tables, what do they show? Use 
      acpidmp DSDT | acpidisasm 
      and 
      acpidmp FACP | acpitbl 
      to examine them.    
-->
<quote>
テーブルを使用しているなら、何を見てるのか？
</quote>

<tscreen><verb>
acpidmp DSDT | acpidisasm 
</verb></tscreen>

<quote>
と
</quote>

<tscreen><verb>
acpidmp FACP | acpitbl 
</verb></tscreen>

<quote>
のコマンドを使い調査します。
</quote>

<!--
      If you start acpid, then shoot it, then shutdown your host, does
      power off actually work (or does it sit there after writing 'Power off'
      to the console)?
-->
<quote>
acpid が起動してるなら、それに質問してから、ホストを停止します。電源オフは
実際に動作しますか (またはコンソールに 'Power off' と表示しそのままですか)？
</quote>

<!--
      Does pressing your power button register as an ACPI event? To check this,
      echo "0xffffffff" > /proc/sys/acpi/pm1_enable
      echo 0xffffffff > /proc/sys/acpi/gpe_enable
      Now in one window do 
      cat /proc/sys/acpi/events
      and watch it; then in another window press the power button. Do you
      see a change? A non-zero value?
-->
<quote>
電源ボタンを押すことが ACPI イベントとして登録されているか？チェックのために
</quote>

<tscreen><verb>
echo "0xffffffff" > /proc/sys/acpi/pm1_enable
echo 0xffffffff > /proc/sys/acpi/gpe_enable
</verb></tscreen>

<quote>
とします。この時、一つのウィンドウで
</quote>

<tscreen><verb>
cat /proc/sys/acpi/events
</verb></tscreen>

<quote>
とし、監視してください――それからもう一つのウィンドウでパワーボタンを
押します。変更が見えましたか？０でない値ですか？
</quote>

<!--
      This is a pretty preliminary checklist; suggestions are appreciated.
-->
<quote>
これは、ちょっとした予備的なチェックリストです――十分理解することを提案
します。
</quote>

<!--
4.2 Submitting useful bug reports
-->
<sect1> 役立つバグレポートの提出

<p>
<!--
    If you would like to report an ACPI bug, please include the following 
    information:
-->
ACPI バグを報告するのであれば、どうか以下の情報を含んでください。

<!--
    1) Any system information you have available (motherboard, chipset, BIOS, 
       system vendor)
    2) Any relevant information from the kernel log: do
       dmesg | grep -iE 'version|acpi|apm|e820' > kernel.log
       to get the relevant lines
    3) Actual description of the problem you are experiencing and if possible 
       how to reproduce it
    4) Output of acpidmp: get this by
       acpidmp > acpidmp.log
       Acpidmp is part of the pmtools package described in section 2.3.
-->
<verb>
1) 使用しているシステムの情報
   (マザーボード、チップセット、BIOS、システムベンダ)
2) カーネルログからの関連情報
     dmesg | grep -iE 'version|acpi|apm|e820' > kernel.log
   とし、関連する行を得ます。
3) 実際に経験した問題の詳細と可能ならその再現方法
4) acpidmp の出力
     acpidmp > acpidmp.log
   とし、入手します。acpidmp は pmtools パッケージの一部でセクション 2.3 で
   説明しています。
</verb>

<!--
    If you have the no-AML-interpreter driver, do this.

    5) Output of acpid with debug turned on: get this by doing
       acpid -d >& acpid.log
       If (and only if) acpid crashes, instead send a full debug trace by:
       acpid -dt >& acpid.log
       Beware, this file is going to be *large*.
-->
no-AML-interpreter ドライバを使っているなら、

<verb>
5) デバッグオプションを有効にした acpid の出力
     acpid -d >& acpid.log
   とし入手します。acpid がクラッシュした場合に限り、上記に代えて
     acpid -dt >& acpid.log
   とし入手したフルデバッグトレースを送ってください。
   注意してください。これは非常に大きくなります。
</verb>

<!--
    If you have the includes-AML-interpreter driver, do this.

    5) Output of acpid with debug turned on: get this by doing
       acpid -d >& acpid.log
-->
includes-AML-interpreter ドライバを使っているなら、

<verb>
5) デバッグオプションを有効にした acpid の出力
     acpid -d >& acpid.log
   とし入手します。
</verb>

<!--
    6) Package up the bug report and log files by:
       tar cvf - bugreport.txt *.log | gzip -9 > bug.tar.gz
       and mail them (preferrably as an attachment) to andy_henroid@yahoo.com.
    7) You should also forward the bug report to the ACPI4Linux mailing list 
       (acpi@phobos.fs.tum.de).  PLEASE DO NOT INCLUDE ANY OF THE LOG FILES 
       TO THE MAILING LIST AS THESE COULD BE RATHER LARGE AND MOST PEOPLE DON'T
       APPRECIATE MULTI-MEGABYTE MAILING LIST MESSAGES.
-->
<verb>
6) バグレポートとログファイルをまとめます。
     tar cvf - bugreport.txt *.log | gzip -9 > bug.tar.gz
   とし、それら (添付ファイルを好みます) を <tt/andy_henroid@yahoo.com/ に
   メールします。
7) ACPI4Linux メーリングリスト (<tt/acpi@phobos.fs.tum.de/) にもバグレポートを
   転送すべきです。ですが、ログファイルは送らないでください。これらはかなり
   大きく、たくさんの人が MULTI-MEGABYTE MAILING LIST MESSAGES のために迷惑を
   蒙ります。
</verb>

<!--
4.3 Guidelines for Linux device driver writers 
-->
<sect1> Linux のデバイスドライバを書く人のための指針

<p>
<!--
    See the file Documentation/pm.txt for information on the calls you'll
    want to add.  These calls work with either APM or ACPI. Briefly, 
-->
コールのための追加情報は Documentation/pm.txt のファイルを参照してください。
これらのコールは、APM か ACPI のどちらか一方と一緒に動作します。
簡単に説明します。

<!--
    1) Register each instance of a device with "pm_register"
    2) Call "pm_access" before accessing the hardware.
       (this will ensure that the hardware is awake and ready)
    3) Your "pm_callback" is called before going into a
       suspend state (ACPI D1-D3) or after resuming (ACPI D0)
       from a suspend.
    4) Call "pm_dev_idle" when the device is not being used
       (optional but will improve device idle detection)
    5) When unloaded, unregister the device with "pm_unregister"
-->
<enum>
<item> "pm_register" コールにより、デバイスの各々のインスタンスを登録します。
<item> ハードウェアにアクセスする前に "pm_access" をコールします
(これは確実にハードウェアを起こし準備させます)。
<item> サスペンド状態 (ACPI D1-D3) に移行する前か、サスペンドからのリジューム
 (ACPI D0) の後にあなたの "pm_callback" はコールされます。
<item> デバイスを使用しなくなったとき、"pm_dev_idle" をコールします
(コールするかは任意ですが、コールすればデバイスのアイドル検出は改善します)。
<item> アンロードするとき、"pm_unregister" コールにより、デバイスを未登録に
します。
</enum>

<sect> 準備中

<sect> クレジットとライセンス情報

<!--
6.1 Credits
-->
<sect1> クレジット

<p>
<!--
  Much of this information was obtained by scouring through the ACPI mailing
  list. Andy Henroid's postings in particular were invaluable. Pieces of this
  document were taken from the pm.txt file included with the driver; this too 
  is Andy's work.  Information on bug reports came from the documentation 
  provided with the acpid package, also by Andy. Bug reports by Michael
  Johnson helped me understand the driver better. Finally, I shamelessly
  stole the framework for this document from David Hinds' PCMCIA-HOWTO since 
  I had been looking at it earlier in the evening before starting to write the
  first draft.
-->
<!--最後が何か尻切れトンボです-->
この情報の多くは ACPI メーリングリストを通じ探し回り手に入れました。
特に Andy Henroid 氏のメールはすこぶる有益な情報でした。このドキュメントの
一部分はドライバに含まれるファイル pm.txt から取って来ました――pm.txt も
 Andy 氏の働きです。バグレポートの情報は、acpid パッケージと一緒に提供される
文書から持ってきています。これもまた Andy 氏によります。Michael Johnson 氏に
よるバグレポートはドライバをよく理解する上で役に立ちました。最後に、
臆面もなく、私は最初のドラフトを書き始める前の夕方の早くに David Hinds 氏の
 PCMCIA-HOWTO を見つけたので、このドキュメントのための枠組みを盗んでしまい
ました。

<!--
6.2 GNU Free Documentation License
-->
<sect1> GNU Free Documentation License

<p>
<verb>

		GNU Free Documentation License
		   Version 1.1, March 2000

 Copyright (C) 2000  Free Software Foundation, Inc.
     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.


0. PREAMBLE

The purpose of this License is to make a manual, textbook, or other
written document "free" in the sense of freedom: to assure everyone
the effective freedom to copy and redistribute it, with or without
modifying it, either commercially or noncommercially.  Secondarily,
this License preserves for the author and publisher a way to get
credit for their work, while not being considered responsible for
modifications made by others.

This License is a kind of "copyleft", which means that derivative
works of the document must themselves be free in the same sense.  It
complements the GNU General Public License, which is a copyleft
license designed for free software.

We have designed this License in order to use it for manuals for free
software, because free software needs free documentation: a free
program should come with manuals providing the same freedoms that the
software does.  But this License is not limited to software manuals;
it can be used for any textual work, regardless of subject matter or
whether it is published as a printed book.  We recommend this License
principally for works whose purpose is instruction or reference.


1. APPLICABILITY AND DEFINITIONS

This License applies to any manual or other work that contains a
notice placed by the copyright holder saying it can be distributed
under the terms of this License.  The "Document", below, refers to any
such manual or work.  Any member of the public is a licensee, and is
addressed as "you".

A "Modified Version" of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.

A "Secondary Section" is a named appendix or a front-matter section of
the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall subject
(or to related matters) and contains nothing that could fall directly
within that overall subject.  (For example, if the Document is in part a
textbook of mathematics, a Secondary Section may not explain any
mathematics.)  The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
commercial, philosophical, ethical or political position regarding
them.

The "Invariant Sections" are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
that says that the Document is released under this License.

The "Cover Texts" are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
the Document is released under this License.

A "Transparent" copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
general public, whose contents can be viewed and edited directly and
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters.  A copy made in an otherwise Transparent file
format whose markup has been designed to thwart or discourage
subsequent modification by readers is not Transparent.  A copy that is
not "Transparent" is called "Opaque".

Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, LaTeX input format, SGML
or XML using a publicly available DTD, and standard-conforming simple
HTML designed for human modification.  Opaque formats include
PostScript, PDF, proprietary formats that can be read and edited only
by proprietary word processors, SGML or XML for which the DTD and/or
processing tools are not generally available, and the
machine-generated HTML produced by some word processors for output
purposes only.

The "Title Page" means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
this License requires to appear in the title page.  For works in
formats which do not have any title page as such, "Title Page" means
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.


2. VERBATIM COPYING

You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License applies
to the Document are reproduced in all copies, and that you add no other
conditions whatsoever to those of this License.  You may not use
technical measures to obstruct or control the reading or further
copying of the copies you make or distribute.  However, you may accept
compensation in exchange for copies.  If you distribute a large enough
number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and
you may publicly display copies.


3. COPYING IN QUANTITY

If you publish printed copies of the Document numbering more than 100,
and the Document's license notice requires Cover Texts, you must enclose
the copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover.  Both covers must also clearly and legibly identify
you as the publisher of these copies.  The front cover must present
the full title with all words of the title equally prominent and
visible.  You may add other material on the covers in addition.
Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated
as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto adjacent
pages.

If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
a publicly-accessible computer-network location containing a complete
Transparent copy of the Document, free of added material, which the
general network-using public has access to download anonymously at no
charge using public-standard network protocols.  If you use the latter
option, you must take reasonably prudent steps, when you begin
distribution of Opaque copies in quantity, to ensure that this
Transparent copy will remain thus accessible at the stated location
until at least one year after the last time you distribute an Opaque
copy (directly or through your agents or retailers) of that edition to
the public.

It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
them a chance to provide you with an updated version of the Document.


4. MODIFICATIONS

You may copy and distribute a Modified Version of the Document under
the conditions of sections 2 and 3 above, provided that you release
the Modified Version under precisely this License, with the Modified
Version filling the role of the Document, thus licensing distribution
and modification of the Modified Version to whoever possesses a copy
of it.  In addition, you must do these things in the Modified Version:

A. Use in the Title Page (and on the covers, if any) a title distinct
   from that of the Document, and from those of previous versions
   (which should, if there were any, be listed in the History section
   of the Document).  You may use the same title as a previous version
   if the original publisher of that version gives permission.
B. List on the Title Page, as authors, one or more persons or entities
   responsible for authorship of the modifications in the Modified
   Version, together with at least five of the principal authors of the
   Document (all of its principal authors, if it has less than five).
C. State on the Title page the name of the publisher of the
   Modified Version, as the publisher.
D. Preserve all the copyright notices of the Document.
E. Add an appropriate copyright notice for your modifications
   adjacent to the other copyright notices.
F. Include, immediately after the copyright notices, a license notice
   giving the public permission to use the Modified Version under the
   terms of this License, in the form shown in the Addendum below.
G. Preserve in that license notice the full lists of Invariant Sections
   and required Cover Texts given in the Document's license notice.
H. Include an unaltered copy of this License.
I. Preserve the section entitled "History", and its title, and add to
   it an item stating at least the title, year, new authors, and
   publisher of the Modified Version as given on the Title Page.  If
   there is no section entitled "History" in the Document, create one
   stating the title, year, authors, and publisher of the Document as
   given on its Title Page, then add an item describing the Modified
   Version as stated in the previous sentence.
J. Preserve the network location, if any, given in the Document for
   public access to a Transparent copy of the Document, and likewise
   the network locations given in the Document for previous versions
   it was based on.  These may be placed in the "History" section.
   You may omit a network location for a work that was published at
   least four years before the Document itself, or if the original
   publisher of the version it refers to gives permission.
K. In any section entitled "Acknowledgements" or "Dedications",
   preserve the section's title, and preserve in the section all the
   substance and tone of each of the contributor acknowledgements
   and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document,
   unaltered in their text and in their titles.  Section numbers
   or the equivalent are not considered part of the section titles.
M. Delete any section entitled "Endorsements".  Such a section
   may not be included in the Modified Version.
N. Do not retitle any existing section as "Endorsements"
   or to conflict in title with any Invariant Section.

If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
copied from the Document, you may at your option designate some or all
of these sections as invariant.  To do this, add their titles to the
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.

You may add a section entitled "Endorsements", provided it contains
nothing but endorsements of your Modified Version by various
parties--for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
standard.

You may add a passage of up to five words as a Front-Cover Text, and a
passage of up to 25 words as a Back-Cover Text, to the end of the list
of Cover Texts in the Modified Version.  Only one passage of
Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity.  If the Document already
includes a cover text for the same cover, previously added by you or
by arrangement made by the same entity you are acting on behalf of,
you may not add another; but you may replace the old one, on explicit
permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License
give permission to use their names for publicity for or to assert or
imply endorsement of any Modified Version.


5. COMBINING DOCUMENTS

You may combine the Document with other documents released under this
License, under the terms defined in section 4 above for modified
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
license notice.

The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
copy.  If there are multiple Invariant Sections with the same name but
different contents, make the title of each such section unique by
adding at the end of it, in parentheses, the name of the original
author or publisher of that section if known, or else a unique number.
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections entitled "History"
in the various original documents, forming one section entitled
"History"; likewise combine any sections entitled "Acknowledgements",
and any sections entitled "Dedications".  You must delete all sections
entitled "Endorsements."


6. COLLECTIONS OF DOCUMENTS

You may make a collection consisting of the Document and other documents
released under this License, and replace the individual copies of this
License in the various documents with a single copy that is included in
the collection, provided that you follow the rules of this License for
verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute
it individually under this License, provided you insert a copy of this
License into the extracted document, and follow this License in all
other respects regarding verbatim copying of that document.



7. AGGREGATION WITH INDEPENDENT WORKS

A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
distribution medium, does not as a whole count as a Modified Version
of the Document, provided no compilation copyright is claimed for the
compilation.  Such a compilation is called an "aggregate", and this
License does not apply to the other self-contained works thus compiled
with the Document, on account of their being thus compiled, if they
are not themselves derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these
copies of the Document, then if the Document is less than one quarter
of the entire aggregate, the Document's Cover Texts may be placed on
covers that surround only the Document within the aggregate.
Otherwise they must appear on covers around the whole aggregate.


8. TRANSLATION

Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections.  You may include a
translation of this License provided that you also include the
original English version of this License.  In case of a disagreement
between the translation and the original English version of this
License, the original English version will prevail.


9. TERMINATION

You may not copy, modify, sublicense, or distribute the Document except
as expressly provided for under this License.  Any other attempt to
copy, modify, sublicense or distribute the Document is void, and will
automatically terminate your rights under this License.  However,
parties who have received copies, or rights, from you under this
License will not have their licenses terminated so long as such
parties remain in full compliance.


10. FUTURE REVISIONS OF THIS LICENSE

The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time.  Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns. See
http:///www.gnu.org/copyleft/.

Each version of the License is given a distinguishing version number.
If the Document specifies that a particular numbered version of this
License "or any later version" applies to it, you have the option of
following the terms and conditions either of that specified version or
of any later version that has been published (not as a draft) by the
Free Software Foundation.  If the Document does not specify a version
number of this License, you may choose any version ever published (not
as a draft) by the Free Software Foundation.


ADDENDUM: How to use this License for your documents

To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and
license notices just after the title page:

      Copyright (c)  YEAR  YOUR NAME.
      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU Free Documentation License, Version 1.1
      or any later version published by the Free Software Foundation;
      with the Invariant Sections being LIST THEIR TITLES, with the
      Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
      A copy of the license is included in the section entitled "GNU
      Free Documentation License".

If you have no Invariant Sections, write "with no Invariant Sections"
instead of saying which ones are invariant.  If you have no
Front-Cover Texts, write "no Front-Cover Texts" instead of
"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.

If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
free software license, such as the GNU General Public License,
to permit their use in free software.
</verb>

<sect> 日本語訳について
<p>
翻訳に関するご意見は JF プロジェクト &lt;JF@linux.or.jp&gt; 宛に連絡
してください。

<descrip>
<tag>v 0.1cj</tag>
翻訳:
野本浩一 &lt;hng@ps.ksky.ne.jp&gt;

<verb>
校正: 
後藤雅晴さん <magotou@town.yachiyo.hyogo.jp>
</verb>
</descrip>

</article>

