OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man2 / bdflush.2
index 1ac840f..5325821 100644 (file)
 .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
 .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
-.\"         all rights reserved.
-.\" Translated Sat Feb 22 20:03:58 JST 1997
-.\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated & Modified Thu Feb  3 03:15:15 JST 2005
-.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.\"WORD:       buffer-dirty-flush      ¥Ð¥Ã¥Õ¥¡¡¼¡¦¥À¡¼¥Æ¥£¡¼¡¦¥Õ¥é¥Ã¥·¥å
-.\"WORD:       daemon                  ¥Ç¡¼¥â¥ó
-.\"WORD:       flush                   ¥Õ¥é¥Ã¥·¥å
-.\"WORD:       tune                    Ä´À°
-.\"WORD:       long word               ¥í¥ó¥°¡¦¥ï¡¼¥É
-.\"WORD:       parameter               ¥Ñ¥é¥á¡¼¥¿¡¼
-.\"WORD:       source file             ¥½¡¼¥¹¡¦¥Õ¥¡¥¤¥ë
-.\"
-.TH BDFLUSH 2 2004-06-17 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O bdflush \- start, flush, or tune buffer-dirty-flush daemon
-bdflush \- ¥Ð¥Ã¥Õ¥¡¡¼¡¦¥À¡¼¥Æ¥£¡¼¡¦¥Õ¥é¥Ã¥·¥å¡¦¥Ç¡¼¥â¥ó¤òµ¯Æ°¡¢¥Õ¥é¥Ã¥·¥å¡¢Ä´À°¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\"*******************************************************************
+.TH BDFLUSH 2 2012\-03\-05 Linux "Linux Programmer's Manual"
+.SH 名前
+bdflush \- バッファー・ダーティー・フラッシュ・デーモンを起動、フラッシュ、調整する
+.SH 書式
 .nf
-.B #include <sys/kdaemon.h>
+\fB#include <sys/kdaemon.h>\fP
 
-.BI "int bdflush(int "  func ", long *" address );
-.BI "int bdflush(int "  func ", long " data );
+\fBint bdflush(int \fP\fIfunc\fP\fB, long *\fP\fIaddress\fP\fB);\fP
+\fBint bdflush(int \fP\fIfunc\fP\fB, long \fP\fIdata\fP\fB);\fP
 .fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR bdflush ()
-.\"O starts, flushes, or tunes the buffer-dirty-flush daemon.
-.BR bdflush ()
-¤Ï¥Ð¥Ã¥Õ¥¡¡¼¡¦¥À¡¼¥Æ¥£¡¼¡¦¥Õ¥é¥Ã¥·¥å (buffer-dirty-flush)¡¦
-¥Ç¡¼¥â¥ó (daemon) ¤òµ¯Æ°¡¢¥Õ¥é¥Ã¥·¥å (flush)¡¢Ä´À° (tune) ¤¹¤ë¡£
-.\"O Only a privileged process (one with the
-.\"O .B CAP_SYS_ADMIN
-.\"O capability) may call
-.\"O .BR bdflush ().
-.RB ( CAP_SYS_ADMIN
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤ò»ý¤Ä) Æø¢¥×¥í¥»¥¹¤Î¤ß¤¬
-.BR bdflush ()
-¤ò¸Æ¤Ó½Ð¤¹¤³¤È¤¬¤Ç¤­¤ë¡£
+.SH 説明
+.\" As noted in a changes in the 2.5.12 source
+\fI注意\fP: Linux 2.6 以降では、このシステムコールは非推奨であり、何も行わない。
+将来のカーネルのリリースで完全になくなる可能性が高い。現在は、\fBbdflush\fP() が
+実行していた処理はカーネルの \fIpdflush\fP スレッドによって行われている。
+
+\fBbdflush\fP()  はバッファー・ダーティー・フラッシュ (buffer\-dirty\-flush)・ デーモン (daemon)
+を起動、フラッシュ (flush)、調整 (tune) する。 (\fBCAP_SYS_ADMIN\fP ケーパビリティ (capability) を持つ)
+特権プロセスのみが \fBbdflush\fP()  を呼び出すことができる。
 .PP
-.\"O If
-.\"O .I func
-.\"O is negative or 0, and no daemon has been started, then
-.\"O .BR bdflush ()
-.\"O enters the daemon code and never returns.
-.I func
-¤¬É餫 0 ¤Ç¥Ç¡¼¥â¥ó¤¬µ¯Æ°¤µ¤ì¤Æ¤¤¤Ê¤ì¤Ð¡¢
-.BR bdflush ()
-¤Ï¥Ç¡¼¥â¥ó¤Î¥³¡¼¥É¤ØÆþ¤ê¡¢Ìá¤Ã¤Æ¤³¤Ê¤¤¡£
+\fIfunc\fP が負か 0 でデーモンが起動されていなれば、 \fBbdflush\fP()  はデーモンのコードへ入り、戻ってこない。
 .PP
-.\"O If
-.\"O .I func
-.\"O is 1,
-.\"O some dirty buffers are written to disk.
-.I func
-¤¬ 1 ¤Ê¤é¤Ð¡¢
-±ø¤ì¤¿ (dirty) ¥Ð¥Ã¥Õ¥¡¡¼¤¬¥Ç¥£¥¹¥¯¤Ø¤È½ñ¤­¹þ¤Þ¤ì¤ë¡£
+\fIfunc\fP が 1 ならば、 汚れた (dirty) バッファーがディスクへと書き込まれる。
 .PP
-.\"O If
-.\"O .I func
-.\"O is 2 or more and is even (low bit is 0), then
-.\"O .I address
-.\"O is the address of a long word,
-.\"O and the tuning parameter numbered
-.\"O .RI "(" "func" "\-2)/2"
-.\"O is returned to the caller in that address.
-.I func
-¤¬ 2 °Ê¾å¤Ç¶ö¿ô (ºÇ¾®¥Ó¥Ã¥È¤¬ 0) ¤Ê¤é¤Ð¡¢
-.I address
-¤Ë¥í¥ó¥°¡¦¥ï¡¼¥É¤Ç¥¢¥É¥ì¥¹¤ò»ØÄꤷ¡¢¤½¤Î¥¢¥É¥ì¥¹¤Ë
-.RI "(" "func" "\-2)/2" 
-¤Ç»ØÄꤵ¤ì¤¿Ä´Àá¥Ñ¥é¥á¡¼¥¿¡¼¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIfunc\fP が 2 以上で偶数 (最小ビットが 0) ならば、 \fIaddress\fP にロング・ワードでアドレスを指定し、そのアドレスに
+(\fIfunc\fP\-2)/2 で指定された調節パラメーターが返される。
 .PP
-.\"O If
-.\"O .I func
-.\"O is 3 or more and is odd (low bit is 1), then
-.\"O .I data
-.\"O is a long word,
-.\"O and the kernel sets tuning parameter numbered
-.\"O .RI "(" "func" "\-3)/2"
-.\"O to that value.
-.I func
-¤¬ 3 °Ê¾å¤Ç´ñ¿ô (ºÇ¾®¥Ó¥Ã¥È¤¬ 1) ¤Ê¤é¤Ð¡¢
-.I data
-¤ò¥í¥ó¥°¡¦¥ï¡¼¥É¤Ç»ØÄꤷ¡¢¤½¤ÎÃͤò
-.RI "(" "func" "\-3)/2"
-¤Ç»ØÄꤵ¤ì¤¿Ä´Àá¥Ñ¥é¥á¡¼¥¿¡¼¤ËÀßÄꤹ¤ë¡£
+\fIfunc\fP が 3 以上で奇数 (最小ビットが 1) ならば、 \fIdata\fP をロング・ワードで指定し、その値を (\fIfunc\fP\-3)/2
+で指定された調節パラメーターに設定する。
 .PP
-.\"O The set of parameters, their values, and their valid ranges
-.\"O are defined in the kernel source file
-.\"O .IR fs/buffer.c .
-¥Ñ¥é¥á¡¼¥¿¡¼¤Î½¸¹ç¤ä¤½¤ÎÃÍ¡¢Í­¸ú¤ÊÈϰϤϥ«¡¼¥Í¥ë¤Î¥½¡¼¥¹¡¦¥Õ¥¡¥¤¥ë¤Î
-.I fs/buffer.c 
-¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O If
-.\"O .I func
-.\"O is negative or 0 and the daemon successfully starts,
-.\"O .BR bdflush ()
-.\"O never returns.
-.I func
-¤¬É餫 0 ¤Ç¡¢¥Ç¥â¡¼¥ó¤Îµ¯Æ°¤ËÀ®¸ù¤·¤¿¾ì¹ç¤Ï
-.BR bdflush ()
-¤ÏÊ֤äƤ³¤Ê¤¤¡£
-.\"O Otherwise, the return value is 0 on success and \-1 on failure, with
-.\"O .I errno
-.\"O set to indicate the error.
-¤½¤¦¤Ç¤Ê¤±¤ì¤ÐÀ®¸ù¤·¤¿¾ì¹ç¤Ë¤Ï 0 ¤¬ÊÖ¤µ¤ì¤ë¡£¼ºÇÔ¤·¤¿¾ì¹ç¤Ë¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
-.I errno
-¤Ë¤½¤Î¥¨¥é¡¼¤¬»Ø¼¨¤µ¤ì¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EBUSY
-.\"O An attempt was made to enter the daemon code after
-.\"O another process has already entered.
-¾¤Î¥×¥í¥»¥¹¤¬´û¤Ë¥Ç¡¼¥â¥ó¡¦¥³¡¼¥É¤ËÆþ¤Ã¤Æ¤¤¤ë¤Î¤Ë¡¢Æþ¤í¤¦¤È»î¤ß¤¿¡£
-.TP
-.B EFAULT
-.\"O .I address
-.\"O points outside your accessible address space.
-.I address
-¤¬¥¢¥¯¥»¥¹²Äǽ¤Ê¥¢¥É¥ì¥¹¶õ´Ö¤Î³°Éô¤ò»Ø¤·¤Æ¤¤¤ë¡£
-.TP
-.B EINVAL
-.\"O An attempt was made to read or write an invalid parameter number,
-.\"O or to write an invalid value to a parameter.
-ÉÔÀµ¤Ê¥Ñ¥é¥á¡¼¥¿¡¼¤ÎÆɤ߽ñ¤­¤ò»î¤ß¤¿¤«¡¢¥Ñ¥é¥á¡¼¥¿¡¼¤ØÉÔÀµ¤ÊÃͤò
-½ñ¤­¹þ¤â¤¦¤È¤·¤¿¡£
-.TP
-.B EPERM
-.\"O Caller does not have the
-.\"O .B CAP_SYS_ADMIN
-.\"O capability.
-¸Æ¤Ó½Ð¤·¸µ¤Ë
-.B CAP_SYS_ADMIN
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤¬¤Ê¤¤¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O .BR bdflush ()
-.\"O is Linux-specific and should not be used in programs
-.\"O intended to be portable.
-.BR bdflush ()
-¤Ï Linux ÆÃÍ­¤Ç¤¢¤ê°Ü¿¢¤ò°Õ¿Þ¤·¤¿¥×¥í¥°¥é¥à¤Ç»ÈÍѤ¹¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR fsync (2),
-.BR sync (2),
-.BR sync (8),
-.BR update (8)
+パラメーターの集合やその値、有効な範囲はカーネルのソース・ファイルの \fIfs/buffer.c\fP に定義されている。
+.SH 返り値
+\fIfunc\fP が負か 0 で、デモーンの起動に成功した場合は \fBbdflush\fP()  は返ってこない。 そうでなければ成功した場合には 0
+が返される。失敗した場合には \-1 が返され、 \fIerrno\fP にそのエラーが指示される。
+.SH エラー
+.TP 
+\fBEBUSY\fP
+他のプロセスが既にデーモン・コードに入っているのに、入ろうと試みた。
+.TP 
+\fBEFAULT\fP
+\fIaddress\fP がアクセス可能なアドレス空間の外部を指している。
+.TP 
+\fBEINVAL\fP
+不正なパラメーターの読み書きを試みたか、パラメーターへ不正な値を 書き込もうとした。
+.TP 
+\fBEPERM\fP
+呼び出し元に \fBCAP_SYS_ADMIN\fP ケーパビリティがない。
+.SH 準拠
+\fBbdflush\fP()  は Linux 特有であり移植を意図したプログラムで使用すべきではない。
+.SH 関連項目
+\fBfsync\fP(2), \fBsync\fP(2), \fBsync\fP(8), \fBupdate\fP(8)