OSDN Git Service

(split) LDP: Update draft and release (from the previous commit)
[linuxjm/LDP_man-pages.git] / release / man5 / proc.5
index 2eb4821..edf4919 100644 (file)
 .\" Updated 2013-08-16, Akihiro MOTOKI
 .\" Updated 2013-08-30, Akihiro MOTOKI, LDP v3.53
 .\"
-.TH PROC 5 2013\-09\-04 Linux "Linux Programmer's Manual"
+.TH PROC 5 2014\-03\-17 Linux "Linux Programmer's Manual"
 .SH 名前
 proc \- プロセスの情報を含む擬似ファイルシステム
 .SH 説明
@@ -297,6 +297,19 @@ flags:  01002002
 \fIpos\fP フィールドは 10 進数で、現在のファイルオフセットを示す。 \fIflags\fP フィールドは 8 進数で、
 ファイルのアクセスモードとファイル状態フラグを示す (\fBopen\fP(2)  参照)。
 
+.\" FIXME
+.\" Certain file types include additional info; see
+.\" Documentation/filesystems/proc.txt
+.\"
+.\" Especially interesting is this:
+.\"
+.\"     commit ab49bdecc3ebb46ab661f5f05d5c5ea9606406c6
+.\"     Author: Cyrill Gorcunov <gorcunov@openvz.org>
+.\"     Date:   Mon Dec 17 16:05:06 2012 -0800
+.\"
+.\" Basically, the /proc/PID/fdinfo/ entry for an inotify FD
+.\" includes the file handles for all watched FDs
+.\"
 このディレクトリのファイルは、プロセスの所有者だけが読み出すことができる。
 .TP 
 \fI/proc/[pid]/io\fP (kernel 2.6.20 以降)
@@ -361,7 +374,6 @@ been accounted for (in its \fIwrite_bytes\fP)  will not be happening.
 systems: if process A reads process B's \fI/proc/[pid]/io\fP while process B is
 updating one of these 64\-bit counters, process A could see an intermediate
 result.
-.RE
 .TP 
 \fI/proc/[pid]/limits\fP (kernel 2.6.24 以降)
 .\" commit 3036e7b490bf7878c6dae952eec5fb87b1106589
@@ -467,7 +479,6 @@ p = private (copy on write)
 \fI[heap]\fP
 プロセスのヒープ。
 .in
-.fi
 .RE
 .IP
 \fIpathname\fP が空の場合、 その領域は \fBmmap\fP(2) を使って確保された無名マッピングである。 \fBgdb\fP(1),
@@ -709,10 +720,9 @@ Writing to \fI/proc/[pid]/oom_score_adj\fP or \fI/proc/[pid]/oom_adj\fP will
 change the other with its scaled value.
 .TP 
 \fI/proc/[pid]/root\fP
-UNIX と Linux では、 ファイルシステムのルート (/) をプロセスごとに別々に
-できる。これはシステムコール \fBchroot\fP(2) によって設定する。 このファイルは
-プロセスのルートディレクトリを指すシンボリックリンクで、 exe や fd/* など
-と同じような動作をする。
+UNIX と Linux では、 ファイルシステムのルート (/) をプロセスごとに別々にできる。 これはシステムコール \fBchroot\fP(2)
+によって設定する。 このファイルはプロセスのルートディレクトリを指すシンボリックリンクで、 \fIexe\fP や \fIfd/*\fP
+などと同じような動作をする。
 
 .\" The following was still true as at kernel 2.6.13
 .\" FIXME Describe /proc/[pid]/seccomp
@@ -910,10 +920,9 @@ Linux 2.6 以降では、 値の単位はクロック tick である (\fIsysconf
 リアルタイム・シグナルに関する情報は表示されないからである。 代わりに \fI/proc/[pid]/status\fP を使うこと。
 .TP 
 \fIwchan\fP %lu
-(35) プロセスが待っている「チャネル」。これはシステムコールのアドレスであり、
-文字名が必要ならば (アドレスとシステムコール名との) 対応表から見つけられる
-(もし \fI/etc/psdatabase\fP [訳注: このファイル名はパッケージによる] を更新
-しているならば、 \fIps \-l\fP して WCHAN フィールドを見よ)。
+(35) This is the "channel" in which the process is waiting.  It is the
+address of a location in the kernel where the process is sleeping.  The
+corresponding symbolic name can be found in \fI/proc/[pid]/wchan\fP.
 .TP 
 \fInswap\fP %lu
 .\" nswap was added in 2.0
@@ -1103,6 +1112,10 @@ sleep; ディスク待ちの休眠状態)", "T (stopped; 停止状態)", "T (tra
 マルチスレッドプロセスでは、メインスレッドがすでに終了している場合、 \fI/proc/[pid]/task\fP ディレクトリの内容は参照できない
 (スレッドの終了は通常 \fBpthread_exit\fP(3)  を呼び出しにより行われる)。
 .TP 
+\fI/proc/[pid]/wchan\fP (Linux 2.6.0 以降)
+The symbolic name corresponding to the location in the kernel where the
+process is sleeping.
+.TP 
 \fI/proc/apm\fP
 Advanced Power Management のバージョンとバッテリ情報。 カーネルのコンパイル時に \fBCONFIG_APM\fP
 を定義したときに存在する。
@@ -1113,6 +1126,55 @@ Advanced Power Management のバージョンとバッテリ情報。 カーネ
 \fI/proc/bus/pccard\fP
 PCMCIA デバイスの情報が書かれるサブディレクトリ。 カーネルのコンパイル時に \fBCONFIG_PCMCIA\fP を定義したときに存在する。
 .TP 
+\fI/proc/[pid]/timers\fP (Linux 3.10 以降)
+.\" commit 5ed67f05f66c41e39880a6d61358438a25f9fee5
+.\" commit 48f6a7a511ef8823fdff39afee0320092d43a8a0
+A list of the POSIX timers for this process.  Each timer is listed with a
+line that started with the string "ID:".  For example:
+
+.in +4n
+.nf
+ID: 1
+signal: 60/00007fff86e452a8
+notify: signal/pid.2634
+ClockID: 0
+ID: 0
+signal: 60/00007fff86e452a8
+notify: signal/pid.2634
+ClockID: 1
+.fi
+.in
+
+The lines shown for each timer have the following meanings:
+.RS
+.TP 
+\fIID\fP
+The ID for this timer.  This is not the same as the timer ID returned by
+\fBtimer_create\fP(2); rather, it is the same kernel\-internal ID that is
+available via the \fIsi_timerid\fP field of the \fIsiginfo_t\fP structure (see
+\fBsigaction\fP(2)).
+.TP 
+\fIsignal\fP
+This is the signal number that this timer uses to deliver notifications
+followed by a slash, and then the \fIsigev_value.sival_ptr\fP value supplied to
+the signal handler.  Valid only for timers that notify via a signal.
+.TP 
+\fInotify\fP
+The part before the slash specifies the mechanism that this timer uses to
+deliver notifications, and is one of "thread", "signal", or "none".
+Immediately following the slash is either the string "tid" for timers with
+\fBSIGEV_THREAD_ID\fP notification, or "pid" for timers that notify by other
+mechanisms.  Following the "." is the PID of the process that will be
+delivered a signal if the timer delivers notifications via a signal.
+.TP 
+\fIClockID\fP
+This field identifies the clock that the timer uses for measuring time.  For
+most clocks, this is a number that matches one of the user\-space \fBCLOCK_*\fP
+constants exposed via \fI<time.h>\fP.  \fBCLOCK_PROCESS_CPUTIME_ID\fP
+timers display with a value of \-6 in this field.  \fBCLOCK_THREAD_CPUTIME_ID\fP
+timers display with a value of \-2 in this field.
+.RE
+.TP 
 \fI/proc/bus/pccard/drivers\fP
 .TP 
 \fI/proc/bus/pci\fP
@@ -1129,7 +1191,7 @@ PCI デバイスの情報。 \fBlspci\fP(8)  や \fBsetpci\fP(8)  でアクセ
 \fI/proc/config.gz\fP (Linux 2.6 以降)
 このファイルでは、現在実行中のカーネルの構築時に使用された 設定オプションを参照できる。 書式は、 (\fImake xconfig\fP, \fImake
 config\fP などを使って) カーネルの設定を変更した際に生成される \fI.config\fP ファイルのものと同じである。
-ファイルの内容は圧縮されており、 \fBzcat\fP(1), \fBzgrep\fP(1)  などを使うと、表示や検索ができる。 ファイルが変更されていない限り、
+ファイルの内容は圧縮されており、 \fBzcat\fP(1) や \fBzgrep\fP(1) を使うと、表示や検索ができる。 ファイルが変更されていない限り、
 \fI/proc/config.gz\fP の内容は次のコマンドで得られる内容と同じである。
 .in +4n
 .nf
@@ -1377,7 +1439,9 @@ limit is adhered to only if strict overcommit accounting is enabled (mode 2
 in \fI/proc/sys/vm/overcommit_ratio\fP).  The \fICommitLimit\fP is calculated
 using the following formula:
 
-    CommitLimit = (overcommit_ratio * Physical RAM) + Swap
+    CommitLimit =
+        ([total RAM pages] \- [total huge TLB pages]) *
+        overcommit_ratio / 100 + [total swap pages]
 
 For example, on a system with 1GB of physical RAM and 7GB of swap with a
 \fIovercommit_ratio\fP of 30, this formula yields a \fICommitLimit\fP of 7.3GB.
@@ -2092,6 +2156,10 @@ the \fBCAP_SYS_ADMIN\fP capability can change the value in this file.
 ある。 \fImsg_qbytes\fP は以降で作成されるメッセージキューで使われる。
 \fImsg_qbytes\fP 設定では、メッセージキューに書き込まれる最大バイト数を指定する。
 .TP 
+\fI/proc/sys/kernel/ngroups_max\fP (Linux 2.6.4 以降)
+This is a read\-only file that displays the upper limit on the number of a
+process's group memberships.
+.TP 
 \fI/proc/sys/kernel/ostype\fP と \fI/proc/sys/kernel/osrelease\fP
 これらのファイルは文字列 \fI/proc/version\fP の各部分を与える。
 .TP 
@@ -2145,6 +2213,10 @@ the \fBCAP_SYS_ADMIN\fP capability can change the value in this file.
 このディレクトリは、ファイル \fI/dev/random\fP の操作を制御する様々なパラメータが書かれている。 詳細は \fBrandom\fP(4)
 を参照。
 .TP 
+\fI/proc/sys/kernel/random/uuid\fP (Linux 2.4 以降)
+Each read from this read\-only file returns a randomly generated 128\-bit
+UUID, as a string in the standard UUID format.
+.TP 
 \fI/proc/sys/kernel/real\-root\-dev\fP
 このファイルは Linux カーネルソースファイル \fIDocumentation/initrd.txt\fP に記述されている。
 .TP 
@@ -2472,9 +2544,10 @@ kill されるだけかもしれない。 この場合には、カーネルパ
 \fBifconfig\fP(8), \fBinit\fP(8), \fBlsmod\fP(8), \fBlspci\fP(8), \fBmount\fP(8),
 \fBnetstat\fP(8), \fBprocinfo\fP(8), \fBroute\fP(8), \fBsysctl\fP(8)
 
-Linux カーネルのソースファイル: \fIDocumentation/filesystems/proc.txt\fP,
-\fIDocumentation/sysctl/vm.txt\fP
+Linux カーネルのソースファイル: \fIDocumentation/filesystems/proc.txt\fP
+\fIDocumentation/sysctl/fs.txt\fP, \fIDocumentation/sysctl/kernel.txt\fP,
+\fIDocumentation/sysctl/net.txt\fP, and \fIDocumentation/sysctl/vm.txt\fP.
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。