bdflushのヘルプ・マニュアル
日本語 英語
bdflush --help
man bdflush
BDFLUSH(2) Linux Programmer’s Manual BDFLUSH(2)
名前
bdflush - バッファー・ダーティー・フラッシュ・デーモンを起動、フラッシ
ュ、調整する
書式
#include
int bdflush(int func, long *address);
int bdflush(int func, long data);
説明
bdflush() はバッファー・ダーティー・フラッシュ (buffer-dirty-flush)・デ
ー モ ン (daemon) を 起 動 、 フラッシュ (flush)、調整 (tune) する。
(CAP_SYS_ADMIN ケーパビリティ (capability) を持つ) 特権プロセスの み が
bdflush() を呼び出すことができる。
func が負か 0 でデーモンが起動されていなれば、 bdflush() はデーモンのコ
ードへ入り、戻ってこない。
func が 1 ならば、汚れた (dirty) バッファーがディスクへと書き込まれる。
func が 2 以上で偶数 (最小ビットが 0) ならば、 address にロング・ワード
でアドレスを指定し、そのアドレスに (func-2)/2 で指定された調節パラメ ー
ターが返される。
func が 3 以上で奇数 (最小ビットが 1) ならば、 data をロング・ワードで
指定し、その値を (func-3)/2 で指定された調節パラメーターに設定する。
パラメーターの集合やその値、有効な範囲はカーネルのソース・ファ イ ル の
fs/buffer.c に定義されている。
返り値
func が負か 0 で、デモーンの起動に成功した場合は bdflush() は返ってこな
い。そうでなければ成功した場合には 0 が返される。失敗した場合には -1 が
返され、 errno にそのエラーが指示される。
エラー
EBUSY 他のプロセスが既にデーモン・コードに入っているのに、入ろうと試み
た。
EFAULT address がアクセス可能なアドレス空間の外部を指している。
EINVAL 不正なパラメーターの読み書きを試みたか、パラメーターへ不正な値を
書き込もうとした。
EPERM 呼び出し元に CAP_SYS_ADMIN ケーパビリティがない。
準拠
bdflush() は Linux 特有であり移植を意図したプログラムで使用すべきではな
い。
関連項目
fsync(2), sync(2), sync(8), update(8)
Linux 2004-06-17 BDFLUSH(2)
BDFLUSH(2) Linux Programmer’s Manual BDFLUSH(2)
NAME
bdflush - start, flush, or tune buffer-dirty-flush daemon
SYNOPSIS
#include
int bdflush(int func, long *address);
int bdflush(int func, long data);
DESCRIPTION
Note: Since Linux 2.6, this system call is deprecated and does nothing.
It is likely to disappear altogether in a future kernel release. Nowa-
days, the task performed by bdflush() is handled by the kernel pdflush
thread.
bdflush() starts, flushes, or tunes the buffer-dirty-flush daemon.
Only a privileged process (one with the CAP_SYS_ADMIN capability) may
call bdflush().
If func is negative or 0, and no daemon has been started, then
bdflush() enters the daemon code and never returns.
If func is 1, some dirty buffers are written to disk.
If func is 2 or more and is even (low bit is 0), then address is the
address of a long word, and the tuning parameter numbered (func-2)/2 is
returned to the caller in that address.
If func is 3 or more and is odd (low bit is 1), then data is a long
word, and the kernel sets tuning parameter numbered (func-3)/2 to that
value.
The set of parameters, their values, and their valid ranges are defined
in the kernel source file fs/buffer.c.
RETURN VALUE
If func is negative or 0 and the daemon successfully starts, bdflush()
never returns. Otherwise, the return value is 0 on success and -1 on
failure, with errno set to indicate the error.
ERRORS
EBUSY An attempt was made to enter the daemon code after another pro-
cess has already entered.
EFAULT address points outside your accessible address space.
EINVAL An attempt was made to read or write an invalid parameter num-
ber, or to write an invalid value to a parameter.
EPERM Caller does not have the CAP_SYS_ADMIN capability.
CONFORMING TO
bdflush() is Linux-specific and should not be used in programs intended
to be portable.
SEE ALSO
fsync(2), sync(2), sync(8), update(8)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2004-06-17 BDFLUSH(2)