release/man2/bdflush.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.
   4 .\"
   5 .\" This is free documentation; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\"
  10 .\" The GNU General Public License's references to "object code"
  11 .\" and "executables" are to be interpreted as the output of any
  12 .\" document formatting or typesetting system, including
  13 .\" intermediate and printed output.
  14 .\"
  15 .\" This manual is distributed in the hope that it will be useful,
  16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 .\" GNU General Public License for more details.
  19 .\"
  20 .\" You should have received a copy of the GNU General Public
  21 .\" License along with this manual; if not, write to the Free
  22 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  23 .\" USA.
  24 .\"
  25 .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
  26 .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
  27 .\"
  28 .\"
  29 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
  30 .\"         all rights reserved.
  31 .\" Translated Sat Feb 22 20:03:58 JST 1997
  32 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  33 .\" Updated & Modified Thu Feb  3 03:15:15 JST 2005
  34 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  35 .\"
  36 .\"WORD:        buffer-dirty-flush      バッファー・ダーティー・フラッシュ
  37 .\"WORD:        daemon                  デーモン
  38 .\"WORD:        flush                   フラッシュ
  39 .\"WORD:        tune                    調整
  40 .\"WORD:        long word               ロング・ワード
  41 .\"WORD:        parameter               パラメーター
  42 .\"WORD:        source file             ソース・ファイル
  43 .\"
  44 .TH BDFLUSH 2 2004-06-17 "Linux" "Linux Programmer's Manual"
  45 .SH 名前
  46 bdflush \- バッファー・ダーティー・フラッシュ・デーモンを起動、フラッシュ、調整する
  47 .SH 書式
  48 .nf
  49 .B #include <sys/kdaemon.h>
  50
  51 .BI "int bdflush(int "  func ", long *" address );
  52 .BI "int bdflush(int "  func ", long " data );
  53 .fi
  54 .SH 説明
  55 .BR bdflush ()
  56 はバッファー・ダーティー・フラッシュ (buffer-dirty-flush)・
  57 デーモン (daemon) を起動、フラッシュ (flush)、調整 (tune) する。
  58 .RB ( CAP_SYS_ADMIN
  59 ケーパビリティ (capability) を持つ) 特権プロセスのみが
  60 .BR bdflush ()
  61 を呼び出すことができる。
  62 .PP
  63 .I func
  64 が負か 0 でデーモンが起動されていなれば、
  65 .BR bdflush ()
  66 はデーモンのコードへ入り、戻ってこない。
  67 .PP
  68 .I func
  69 が 1 ならば、
  70 汚れた (dirty) バッファーがディスクへと書き込まれる。
  71 .PP
  72 .I func
  73 が 2 以上で偶数 (最小ビットが 0) ならば、
  74 .I address
  75 にロング・ワードでアドレスを指定し、そのアドレスに
  76 .RI "(" "func" "\-2)/2"
  77 で指定された調節パラメーターが返される。
  78 .PP
  79 .I func
  80 が 3 以上で奇数 (最小ビットが 1) ならば、
  81 .I data
  82 をロング・ワードで指定し、その値を
  83 .RI "(" "func" "\-3)/2"
  84 で指定された調節パラメーターに設定する。
  85 .PP
  86 パラメーターの集合やその値、有効な範囲はカーネルのソース・ファイルの
  87 .I fs/buffer.c
  88 に定義されている。
  89 .SH 返り値
  90 .I func
  91 が負か 0 で、デモーンの起動に成功した場合は
  92 .BR bdflush ()
  93 は返ってこない。
  94 そうでなければ成功した場合には 0 が返される。失敗した場合には \-1 が返され、
  95 .I errno
  96 にそのエラーが指示される。
  97 .SH エラー
  98 .TP
  99 .B EBUSY
 100 他のプロセスが既にデーモン・コードに入っているのに、入ろうと試みた。
 101 .TP
 102 .B EFAULT
 103 .I address
 104 がアクセス可能なアドレス空間の外部を指している。
 105 .TP
 106 .B EINVAL
 107 不正なパラメーターの読み書きを試みたか、パラメーターへ不正な値を
 108 書き込もうとした。
 109 .TP
 110 .B EPERM
 111 呼び出し元に
 112 .B CAP_SYS_ADMIN
 113 ケーパビリティがない。
 114 .SH 準拠
 115 .BR bdflush ()
 116 は Linux 特有であり移植を意図したプログラムで使用すべきではない。
 117 .SH 関連項目
 118 .BR fsync (2),
 119 .BR sync (2),
 120 .BR sync (8),
 121 .BR update (8)