名前

       fpathconf, pathconf - ファイルの設定値を取得する

書式

       #include <unistd.h>

        long fpathconf(int fd, int name);
       long pathconf(const char *path, int name);

説明

       fpathconf()  はオープンされているファイルディスクリプター fd に対して設定されているオプション name の値を
       取得する。

       pathconf()  はファイル名 path に対して設定されているオプション name の値を取得する。

       対応するマクロのうち <unistd.h> で定義されているものは最小値である。アプリケーションによってはこれらの 値
       を変更してより有利な動作を行おうとするものがある。この場合でも  fpathconf()  または pathconf() は呼び出す
       ことができる。この場合はより大きな値が返ることになろう。

       name を以下の定数のどれかにすると、対応する設定オプションが返される。

       _PC_LINK_MAX
              ファイルへのリンクの最大数。 fd または path がディレクトリの場合は、この値はディレクトリ全体に適用
              される。対応する マクロは _POSIX_LINK_MAX である。

       _PC_MAX_CANON
              フォーマット付き入力行の最大長。このとき fd または path は端末を参照していなければならない。  対応
              するマクロは _POSIX_MAX_CANON である。

       _PC_MAX_INPUT
              入力行の最大長。このとき  fd  または  path  は端末を参照していなければならない。  対応するマクロは
              _POSIX_MAX_INPUT である。

       _PC_NAME_MAX
              ディレクトリ path または fd 内に、そのプロセスが作成することができるファイル名の最大長。  対応する
              マクロは _POSIX_NAME_MAX である。

       _PC_PATH_MAX
              path または fd がカレントディレクトリの場合、相対パス名の最大長。 対応するマクロは _POSIX_PATH_MAX
              である。

       _PC_PIPE_BUF
              The maximum number of bytes that can be written atomically to a pipe of FIFO.  For fpathconf(), fd
              should  refer  to a pipe or FIFO.  For fpathconf(), path should refer to a FIFO or a directory; in
              the latter case, the  returned  value  corresponds  to  FIFOs  created  in  that  directory.   The
              corresponding macro is _POSIX_PIPE_BUF.

       _PC_CHOWN_RESTRICTED
              This  returns a positive value if the use of chown(2)  and fchown(2) for changing a file's user ID
              is restricted to a process with appropriate privileges, and changing a file's group ID to a  value
              other than the process's effective group ID or one of its supplementary group IDs is restricted to
              a  process  with  appropriate  privileges.   According  to  POSIX.1, this variable shall always be
              defined with a value other than -1.  The corresponding macro is _POSIX_CHOWN_RESTRICTED.

              If fd or path refers to a directory, then the return value applies to all files in that directory.

       _PC_NO_TRUNC
              アクセス中のファイル名が _POSIX_NAME_MAX よりも長く、エラーとなる場合には 0 以外の値を返す。  対応
              するマクロは _POSIX_NAME_MAX である。

       _PC_VDISABLE
              特殊文字  (special  character)  の処理が許されていない場合は 0 以外の値を 返す。このとき fd または
              path は端末を参照していなければならない。

返り値

       The return value of these functions is one of the following:

       *  On error, -1 is returned and errno is set to indicate the cause of the  error  (for  example,  EINVAL,
          indicating that name is invalid).

       *  If name corresponds to a maximum or minimum limit, and that limit is indeterminate, -1 is returned and
          errno  is not changed.  (To distinguish an indeterminate limit from an error, set errno to zero before
          the call, and then check whether errno is nonzero when -1 is returned.)

       *  If name corresponds to an option, a positive value is returned if the option is supported, and  -1  is
          returned if the option is not supported.

       *  Otherwise,  the  current  value  of  the  option  or  limit  is returned.  This value will not be more
          restrictive than the corresponding value that was  described  to  the  application  in  <unistd.h>  or
          <limits.h> when the application was compiled.

エラー

       EACCES (pathconf())  Search permission is denied for one of the directories in the path prefix of path.

       EBADF  (fpathconf()) fd が適切なファイルディスクリプターでない。

       EINVAL name が無効である。

       EINVAL The implementation does not support an association of name with the specified file.

       ELOOP  (pathconf()) path を解決する際に遭遇したシンボリックリンクが多過ぎる。

       ENAMETOOLONG
              (pathconf()) path が長過ぎる。

       ENOENT (pathconf())  A component of path does not exist, or path is an empty string.

       ENOTDIR
              (pathconf()) path のディレクトリ部分が実際にはディレクトリでない。

属性

       この節で使用されている用語の説明については、 attributes(7) を参照。
       ┌─────────────────────────┬───────────────┬─────────┐
       │ インターフェース        │ 属性          │ 値      │
       ├─────────────────────────┼───────────────┼─────────┤
       │  fpathconf(),           │ Thread safety │ MT-Safe │
       │ pathconf()              │               │         │
       └─────────────────────────┴───────────────┴─────────┘

準拠

       POSIX.1-2001, POSIX.1-2008.

注意

       name  に _PC_NAME_MAX を入れて返された値よりも長いファイル名を持つファイルが、与えられたディ レクトリに存
       在するかもしれない。

       いくつかの返り値はとても大きくなることがある。これらを使って メモリーの割り当てを行うのは適当ではない。

関連項目

       getconf(1), open(2), statfs(2), confstr(3), sysconf(3)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10  の一部である。プロジェクトの説明とバグ報告
       に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

GNU                                                 2017-07-13                                      FPATHCONF(3)