HP OpenVMS Systems Documentation |
| 前へ | 次へ | 目次 | 索引 |
ファイル記述子に関連付けられているファイル指定を返します。
#include <unixio.h>関数バリアント getname関数には, _getname32および _getname64という名前のバリアントがあり,それぞれ 32 ビット・ポインタ・サイズおよび 64 ビット・ポインタ・サイズで使用されます。ポインタ・サイズ固有の関数の使い方の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.10 節を参照してください。char *getname (int file_desc, char *buffer, ...);
file_desc
ファイル記述子。buffer
ファイル指定を格納できるだけの十分な大きさの文字列を指すポインタ。...
省略可能な引数であり,1 または 0 に設定できます。1 を指定した場合は, getname関数は OpenVMS 形式でファイル指定を返します。 0 を指定した場合は,UNIX 形式でファイル指定を返します。この引数を省略すると,現在のコマンド言語インタプリタ (CLI) に従ってファイル名を返します。 UNIX 形式のファイル指定の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.4.3 項を参照してください。
getname関数は, buffer によって示される領域にファイル指定を格納し,そのアドレスを返します。buffer によって示される領域は,完全に修飾したファイル指定 ( 最大長は 256 文字 ) を格納できるだけの十分な大きさの配列でなければなりません。
x buffer 引数に渡されたアドレス。 0 エラーを示します。
UNIX コマンド・ラインの規則に従うアプリケーションで使用できるコマンド・ライン・パーサ。
#include <unistd.h> (X/Open, POSIX-1)#include <stdio.h> (X/Open, POSIX-2)
int getopt (int argc, char * const argv[], const char *optstring);
extern char *optarg;
extern int optind, opterr, optopt;
argc
mainに渡される引数の数。argv
mainに渡される引数配列。optstring
認識されるオプション文字で構成される文字列。文字の後にコロンが続く場合,そのオプションは引数を受け付けます。
変数 optindは,処理する argv ベクタの次の要素のインデックスです。この変数はシステムで 1 に初期化され, argv の各要素の処理が終了したきに, getoptによって更新されます。 argv の 1 つの要素に複数のオプション文字が含まれている場合は,どのオプションが処理済みかを getoptがどのように判断するかは不定です。getopt関数は,argv のオプション文字のうち, optstring の文字と一致する次のオプション文字 ( そのような文字が見つかった場合 ) を返します。オプションが引数を受け付ける場合は, getoptは変数 optargを,次に示すようにオプション引数を指すポインタに設定します。
- オプションが argv の要素によって示される文字列内の最後の文字である場合は, optargには argv の次の要素が格納され, optindに 2 が加算されます。 optindの結果値が argc より小さくない場合は, getoptはエラーを返し,オプション引数が不足していることを示します。
- それ以外の場合, optargは, argv のその要素内のオプション文字の後の文字列を指し, optindに 1 を加算します。
次のいずれかの条件が満たされる場合, getoptは optindを変更せずに, - 1 を返します。
argv[ optind] が NULL ポインタである
*argv[ optind] が文字 -- でない
argv[ optind] が文字列 "--" を示しているargv[ optind] が文字列 "-- --" を指す場合, getoptは, optindを増分した後, - 1 を返します。
getoptが optstring に含まれていないオプション文字を検出すると,疑問符 (?) を返します。
getoptが不足している引数を検出した場合, optstring の 1 文字目がコロンのときは,コロン文字 (:) を返します。それ以外の場合は,疑問符を返します。
上記の 2 つの場合, getoptは変数 optoptを,エラーの原因となったオプション文字に設定します。アプリケーションで変数 opterrを 0 に設定しておらず, optstring の 1 文字目がコロンでない場合は, getoptは診断メッセージを stderrにプリントします。
x コマンド・ラインに指定した次のオプション文字。 getopt が不足している引数を検出し, optstring の 1 文字目がコロンの場合は,コロンを返します。
getopt が optstring にないオプション文字を検出した場合や,不足している引数を検出し, optstring の 1 文字目がコロンでない場合は,疑問符を返します。
- 1 すべてのコマンド・ライン・オプションが解析された場合。
次の例は,ユーティリティに対する引数の処理方法を示しています。このユーティリティは,同時に組み合わせて指定することができないオプション a と b,およびオプション f と o を受け付けることができ,この 2 つのオプションはいずれも引数を必要とします。
#include <unistd.h> int main (int argc, char *argv[ ]) { int c; int bflg, aflg, errflg; char *ifile; char *ofile; extern char *optarg; extern int optind, optopt; . . . while ((c = getopt(argc, argv, ":abf:o:")) != -1) { switch (c) { case 'a': if (bflg) errflg++; else aflg++; break; case 'b': if (aflg) errflg++; else { bflg++; bproc(); } break; case 'f': ifile = optarg; break; case 'o': ofile = optarg; break; case ':': /* -f or -o without operand */ fprintf (stderr, "Option -%c requires an operand\n"' optopt); errflg++; break; case '?': fprintf (stderr, "Unrecognized option -%c\n"' optopt); errflg++; } } if (errflg) { fprintf (stderr, "usage: ..."); exit(2); } for ( ; optind < argc; optind++) { if (access(argv[optind], R_OK)) { . . . }
このサンプル・コードは,以下のいずれも等価なものとして受け付けます。
cmd -ao arg path path cmd -a -o arg path path cmd -o arg -a path path cmd -a -o arg -- path path cmd -a -oarg path path cmd -aoarg path path
システム・ページ・サイズを取得します。
#include <unistd.h>int getpagesize (void);
getpagesize関数は,ページ内のバイト数を返します。システム・ページ・サイズは,メモリ管理システム呼び出しに対する引数を指定するときに便利です。ページ・サイズはシステム・ページ・サイズであり,必ずしもハードウェア・ページ・サイズと同一ではありません。
x 常に正常終了を示します。ページ内のバイト数を返します。
プロセスに対応するプロセス・グループ ID を取得します。
#include <unistd.h>pid_t getpgid (pid_t pid);
pid
グループ ID を要求するプロセスのプロセス ID。
getpgid関数は, pid で指定されたプロセスのプロセス・グループ ID を返します。 pid が 0 の場合, getpgid関数は,呼び出し元プロセスのプロセス・グループ ID を返します。
x 指定されたプロセスのセッション・リーダのプロセス・グループ ID です。 (pid_t) - 1 エラーを示します。この関数は, errno に以下のいずれかの値を設定します。
- EPERM -- pid で指定されたプロセスが,呼び出し元プロセスと同じセッションに属していないため,この実装では,呼び出し元プロセスからこのプロセスのプロセス・グループ ID へのアクセスが許されていません。
- ESRCH -- プロセス ID が pid であるようなプロセスはありません。
- EINVAL -- pid の値が不正です。
呼び出し元プロセスのプロセス・グループ ID を取得します。
#include <unistd.h>pid_t getpgrp (void);
getpgrp関数は,呼び出し元プロセスのプロセス・グループ ID を返します。getpgrp関数は必ず成功します。エラーを示すために予約されている戻り値はありません。
x 呼び出し元プロセスのプロセス・グループ ID です。
現在のプロセスのプロセス ID を返します。
#include <unistd.h>pid_t getpid (void);
x 現在のプロセスのプロセス ID。
呼び出しプロセスの親プロセス ID を返します。
#include <unistd.h>pid_t getppid (void);
x 親プロセス ID。 0 呼び出しプロセスに親プロセスがないことを示します。
ユーザ・データベース内のユーザ・エントリ情報にアクセスします。 passwd構造体へのポインタが返されます。
#include <pwd.h>関数バリアント getpwent関数には, __getpwent32および __getpwent64という名前のバリアントがあり,それぞれ 32 ビット・ポインタ・サイズおよび 64 ビット・ポインタ・サイズで使用されます。ポインタ・サイズ固有の関数の使い方の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.10 節を参照してください。struct passwd *getpwent (void);
getpwent関数は,ユーザ・データベースのエントリから得た値がフィールドに格納された構造体へのポインタを返します。データベースのエントリは, getpwentによって順にアクセスされます。最初に呼び出されたとき, getpwentは,ユーザ・データベース内の 1 番目のエントリが格納された passwd構造体へのポインタを返します。その後の呼び出しでは,この関数は,ユーザ・データベース内の次のエントリが格納された passwd構造体へのポインタを返します。このため,連続して呼び出しを行うことで,ユーザ・データベース全体を検索できます。passwd構造体は, <pwd.h>ヘッダ・ファイルに次のように定義されています。
pw_name ユーザの名前 pw_uid ユーザの ID pw_gid ユーザの基本グループのグループ ID pw_dir ユーザのホーム・ディレクトリ pw_shell ユーザの初期プログラム
読み取り時に,ファイルの終端またはエラーが検出された場合, getpwentは NULL ポインタを返します。
getpwentはユーザ登録ファイル (SYSUAF) を直接アクセスするため,プロセスには適切な特権が必要です。特権がないと,この関数は失敗します。
注意
getpwent関数で生成される情報はすべて,スレッド単位の静的領域に格納され,関数の次の呼び出しで上書きされます。パスワート・ファイル・エントリが長すぎる場合は無視されます。
x 成功した場合, passwd 構造体へのポインタです。 NULL ファイルの終端またはエラーの発生を示します。この関数は, errno に以下のいずれかの値を設定します。
- EIO -- 入出力エラーの発生,またはユーザ登録ファイル (SYSUAF) にアクセスするための適切な特権がユーザにないことを示します。
- EMFILE -- 呼び出し元プロセス内で, OPEN_MAX 個のファイル記述子が現在オープンされています。
- ENFILE -- 許されている最大個数のファイルが,現在システム内でオープンされています。
getpwnam関数は,指定された name のユーザ・データベース・エントリについての情報を返します。getpwnam_r関数は, getpwnamのリエントラント・バージョンです。
#include <pwd.h>関数バリアント getpwnam関数と getpwnam_r関数には, __getpwnam32, _getpwnam_r32, __getpwnam64, _getpwnam_r64という名前のバリアントがあり,それぞれ 32 ビット・ポインタ・サイズおよび 64 ビット・ポインタ・サイズで使用されます。ポインタ・サイズ固有の関数の使い方の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.10 節を参照してください。struct passwd *getpwnam (const char *name); (ISO POSIX-1)
struct passwd *getpwnam (const char *name, ...); (HP C Extension)
int getpwnam_r (const char *name, struct passwd *pwd, char *buffer, size_t bufsize, struct passwd **result); (ISO POSIX-1) , (Alpha, I64)
int getpwnam_r (const char *name, struct passwd *pwd, char *buffer, size_t bufsize, struct passwd **result, ...); (HP C Extension) , (Alpha, I64)
name
属性を読み込むユーザの名前。pwd
この関数が結果を格納する passwd構造体のアドレス。buffer
passwd構造体の最長のエントリを保持できる, result 引数用の作業バッファ。 passwd構造体から指す記憶域は, buffer引数のメモリ (長さは bufsize 文字) から割り当てられます。bufsize
buffer が指す文字配列の長さ。result
成功して戻った場合,pwd が設定されます。失敗して戻った場合,result には NULL が設定されます。...
1 または 0 となるオプションの引数。 1 を指定すると,ディレクトリ指定は,OpenVMS 形式で返されます。 0 を指定すると,ディレクトリ指定 (パス名) は,UNIX 形式で返されます。この引数を省略すると,この関数は現在のコマンド言語インタプリタに従って,ディレクトリ指定を返します。 UNIX 形式のディレクトリ指定についての詳細は,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.4.3 項を参照してください。
getpwnam関数は,ユーザ・データベース内で指定された name のエントリを検索します。この関数は,データベース内のユーザ・エントリのうち, passwd構造体の pw_nameメンバが name 引数と一致する最初のエントリを返します。passwd構造体は,次に示すように <pwd.h>ヘッダ・ファイルに定義されています。
pw_name ユーザのログイン名 pw_uid 数値ユーザ ID pw_gid 数値グループ ID pw_dir ユーザのホーム・ディレクトリ pw_shell ユーザの初期プログラム
注意
getpwnam関数で生成された情報はすべて,スレッドごとの静的領域に格納され,この関数の次の呼び出しで上書きされます。
getpwnam_r関数は, getpwnamのリエントラント・バージョンです。 getpwnam_r関数は, pwd が指す passwd構造体をアップデートし, result が指すメモリ位置にこの構造体へのポインタを格納します。この構造体には,指定された name と一致するユーザ・データベースのエントリが格納されます。この構造体から指す記憶域は, buffer 引数のメモリ (長さは bufsize 文字) から割り当てられます。このバッファに必要なサイズは, sysconf関数の _SC_GETPW_R_SIZE_MAX パラメータで調べることができます。エラーの場合,または要求されたエントリが見つからない場合は, result が指すメモリ位置に,NULL ポインタが返されます。
エラー状態をチェックするアプリケーションは, getpwnamを呼び出す前に, errnoに 0 を設定する必要があります。 getpwnamが NULL ポインタを返し, errnoがゼロでない場合,エラーが発生しています。
x 一致するエントリが見つかった場合, getpwnam は正しい passwd 構造体へのポインタを返します。 NULL エラーが発生した場合,または指定されたエントリが見つからなかった場合, getpwnam は NULL を返します。 errno には,エラーを示す値が設定されます。 getpwnam 関数は,以下の場合に失敗します。
- EIO -- 入出力エラーが発生しました。
- EINTR -- getpwnam の実行中にシグナルをキャッチしました。
- EMFILE -- 呼び出し元プロセス内で, OPEN_MAX 個のファイル記述子が現在オープンされています。
- ENFILE -- 許されている最大個数のファイルが,現在システム内でオープンされています。
0 成功した場合, getpwnam_r は 0 を返し, result が指すメモリ位置に,アップデートした passwd 構造体へのポインタを格納します。 0 失敗した場合 (エラー,または要求されたエントリが見つからない場合), getpwnam_r は 0 を返し, result が指すメモリ位置に,NULL ポインタを格納します。 getpwnam_r 関数は,次の場合に失敗します。
- ERANGE -- buffer と bufsize で指定された記憶域は,得られた passwd 構造体から指すデータを格納するには不十分です。
| 前へ | 次へ | 目次 | 索引 |