名前

       getusershell, setusershell, endusershell - 許可されたユーザーシェルを得る

書式

       #include <unistd.h>

       char *getusershell(void);

       void setusershell(void);

       void endusershell(void);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       getusershell(), setusershell(), endusershell():
           glibc 2.21 以降:
               _DEFAULT_SOURCE
           glibc 2.19 と 2.20:
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           glibc 2.19 以前:
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

説明

       getusershell()  関数は /etc/shells ファイルから (開く必要があればこのファイルを開いてから) 現在行の次の一
       行を返す。 返された行の中身は有効なユーザーシェルのうちの一つのパス名である。 (訳注. 一行に付き一つのシェ
       ルのパス名が書かれている。)  もし /etc/shells が存在しないか、読み込み不可の場合には、 getusershell()  は
       /bin/sh と /bin/csh がファイルに記されているかのようにふるまう。

       setusershell()  関数は /etc/shells ファイルの ファイルポインターを先頭に戻す。

       endusershell()  関数は /etc/shells ファイルを閉じる。

返り値

       getusershell() 関数はファイルの終端では NULL を返す。

ファイル

       /etc/shells

属性

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

準拠

       4.3BSD.

関連項目

       shells(5)

この文書について

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

GNU                                                 2016-03-15                                   GETUSERSHELL(3)