release/man3/fpathconf.3

   1 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" Modified Wed Jul 28 11:12:26 1993 by Rik Faith (faith@cs.unc.edu)
  26 .\"
  27 .\" FIXME Probably all of the following should be documented:
  28 .\"     _PC_SYNC_IO,
  29 .\"     _PC_ASYNC_IO,
  30 .\"     _PC_PRIO_IO,
  31 .\"     _PC_SOCK_MAXBUF,
  32 .\"     _PC_FILESIZEBITS,
  33 .\"     _PC_REC_INCR_XFER_SIZE,
  34 .\"     _PC_REC_MAX_XFER_SIZE,
  35 .\"     _PC_REC_MIN_XFER_SIZE,
  36 .\"     _PC_REC_XFER_ALIGN,
  37 .\"     _PC_ALLOC_SIZE_MIN,
  38 .\"     _PC_SYMLINK_MAX,
  39 .\"     _PC_2_SYMLINKS
  40 .\"
  41 .\"*******************************************************************
  42 .\"
  43 .\" This file was generated with po4a. Translate the source file.
  44 .\"
  45 .\"*******************************************************************
  46 .TH FPATHCONF 3 1993\-04\-04 GNU "Linux Programmer's Manual"
  47 .SH 名前
  48 fpathconf, pathconf \- ファイルの設定値を取得する
  49 .SH 書式
  50 .nf
  51 \fB#include <unistd.h>\fP
  52 .sp
  53 \fBlong fpathconf(int \fP\fIfd\fP\fB, int \fP\fIname\fP\fB);\fP
  54 .br
  55 \fBlong pathconf(char *\fP\fIpath\fP\fB, int \fP\fIname\fP\fB);\fP
  56 .fi
  57 .SH 説明
  58 \fBfpathconf\fP()  はオープンされているファイルデスクリプター \fIfd\fP に対して設定されているオプション \fIname\fP
  59 の値を取得する。
  60 .PP
  61 \fBpathconf\fP()  はファイル名 \fIpath\fP に対して設定されているオプション \fIname\fP の値を取得する。
  62 .PP
  63 対応するマクロのうち \fI<unistd.h>\fP で定義されているものは最小値である。アプリケーションによってはこれらの
  64 値を変更してより有利な動作を行おうとするものがある。この場合でも \fBfpathconf\fP()  または \fBpathconf\fP()
  65 は呼び出すことができる。この場合はより大きな値が返ることになろう。
  66 .PP
  67 \fIname\fP を以下の定数のどれかにすると、対応する設定オプションが返される。
  68 .TP
  69 \fB_PC_LINK_MAX\fP
  70 ファイルへのリンクの最大数を返す。 \fIfd\fP または \fIpath\fP がディレクトリの場合は、この値はディレクトリ全体に適用される。対応する マクロは
  71 \fB_POSIX_LINK_MAX\fP である。
  72 .TP
  73 \fB_PC_MAX_CANON\fP
  74 フォーマット付き入力行の最大長を返す。このとき \fIfd\fP または \fIpath\fP は端末を参照していなければならない。 対応するマクロは
  75 \fB_POSIX_MAX_CANON\fP である。
  76 .TP
  77 \fB_PC_MAX_INPUT\fP
  78 入力行の最大長を返す。このとき \fIfd\fP または \fIpath\fP は端末を参照していなければならない。 対応するマクロは
  79 \fB_POSIX_MAX_INPUT\fP である。
  80 .TP
  81 \fB_PC_NAME_MAX\fP
  82 ディレクトリ \fIpath\fP または \fIfd\fP 内に、そのプロセスが作成することができるファイル名の最大長を返す。 対応するマクロは
  83 \fB_POSIX_NAME_MAX\fP である。
  84 .TP
  85 \fB_PC_PATH_MAX\fP
  86 \fIpath\fP または \fIfd\fP がカレントディレクトリの場合、相対パス名の最大長を返す。 対応するマクロは \fB_POSIX_PATH_MAX\fP
  87 である。
  88 .TP
  89 \fB_PC_PIPE_BUF\fP
  90 パイプ (pipe) バッファのサイズを返す。このとき \fIfd\fP はパイプか FIFO を参照していなければならず、 \fIpath\fP は FIFO
  91 を参照していなければならない。 対応するマクロは \fB_POSIX_PIPE_BUF\fP である。
  92 .TP
  93 \fB_PC_CHOWN_RESTRICTED\fP
  94 このファイルに対する \fBchown\fP(2)  の呼び出しが許されていない場合には 0 以外の値を返す。 \fIfd\fP または \fIpath\fP
  95 がディレクトリを参照している場合は、この制限はそのディレクトリのすべて のファイルに適用される。 対応するマクロは
  96 \fB_POSIX_CHOWN_RESTRICTED\fP である。
  97 .TP
  98 \fB_PC_NO_TRUNC\fP
  99 アクセス中のファイル名が \fB_POSIX_NAME_MAX\fP よりも長く、エラーとなる場合には 0 以外の値を返す。 対応するマクロは
 100 \fB_POSIX_NAME_MAX\fP である。
 101 .TP
 102 \fB_PC_VDISABLE\fP
 103 特殊文字 (special character) の処理が許されていない場合は 0 以外の値を 返す。このとき \fIfd\fP または \fIpath\fP
 104 は端末を参照していなければならない。
 105 .SH 返り値
 106 (存在していれば) 制限値が返される。要求されたリソースへのシステムの制 限が存在していなければ \-1 が返され、 \fIerrno\fP
 107 は変更されない。エラーが起こった場合には \-1 が返され、 \fIerrno\fP がエラーに対応した値に設定される。
 108 .SH 準拠
 109 POSIX.1\-2001.
 110 .SH 注意
 111 \fIname\fP に \fB_PC_NAME_MAX\fP を入れて返された値よりも長いファイル名を持つファイルが、与えられたディ
 112 レクトリに存在するかもしれない。
 113 .PP
 114 いくつかの返り値はとても大きくなることがある。これらを使って メモリの割り当てを行うのは適当ではない。
 115 .SH 関連項目
 116 \fBgetconf\fP(1), \fBopen\fP(2), \fBstatfs\fP(2), \fBsysconf\fP(3)
 117 .SH この文書について
 118 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
 119 である。プロジェクトの説明とバグ報告に関する情報は
 120 http://www.kernel.org/doc/man\-pages/ に書かれている。