exec、execl、execle、execlp、execv、execve、execvp、exect、または fexecve サブルーチン

目的

ファイルを実行します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <unistd.h>

extern 
char **environ;

int execl (
 Path, 
 Argument0 [, Argument1, ...], 0)
const char *Path, *Argument0, *Argument
1, ...;

int execle (
 Path, 
 Argument0 [, Argument1, ...], 0,
        
 EnvironmentPointer)
const 
char *Path, *Argument0, *Argum
ent
1, ...;
char *const EnvironmentPointer[ ];

int execlp (
 File, 
 Argument0 [, Argument1
, ...], 0)
const char *File, *Argument0, *Argument
1, ...;

int execv (
 Path, 
 ArgumentV)
const char *Path;
char *const ArgumentV[ ];

int execve (
 Path, 
 ArgumentV,
        
 EnvironmentPointer)
const char *Path;
char 
*const ArgumentV[ ], *EnvironmentPointer
[ ];

int execvp (
 File, 
 ArgumentV)
const char *File;
char *const ArgumentV[ ];

int exect (
 Path,
 ArgumentV,
 EnvironmentPointer)
char *Path, *ArgumentV, *EnvironmentPointer [ ];

int fexecve (FileDescriptor, ArgumentV, EnvironmentPointer)
int FileDescriptor;
char *const ArgumentV[ ], *EnvironmentPointer[ ];

説明

EXEC サブルーチンは、そのすべての形式で、呼び出しプロセスで新しいプログラムを実行します。 EXEC サブルーチンは新規プロセスを作成しませんが、 新規プロセス・イメージと呼ばれる新規プログラムで現行プログラムをオーバーレイします。 新規プロセス・イメージ・ファイルは、以下の 3 つのファイル・タイプのいずれかにすることができます。

• XCOFF ファイル形式の実行可能バイナリー・ファイル。
• シェル・プロシージャーを含む実行可能テキスト・ファイル ( 実行可能プログラム および EXEC サブルーチンのみが、このタイプの新規プロセス・イメージ・ファイルを許可します)。
• 実行する実行可能バイナリー・ファイルまたはシェル・プロシージャーを指定するファイル。

Fexecve サブルーチンは 実行 サブルーチンと同等ですが、fexecve サブルーチンは、実行されるオープン・ファイルのファイル・ディスクリプターを、パス名ではなく最初のパラメーターとして取る点が異なります。 ただし、以下が適用されます。

新規プロセス・イメージは、呼び出しプロセス・イメージから、セッション・メンバーシップ、補足グループ ID、プロセス・シグナル・マスク、および保留シグナルの各属性を継承します。

上記の最後のタイプは、以下の構文のヘッダーによって認識されます。

#! Path [String]

#! ファイル・タイプを識別するファイル マジックナンバーです。 実行されるファイルのパス名は、 パス パラメーターによって指定されます。 ストリング パラメーターは、タブ文字もスペース文字も含まないオプションの文字ストリングです。 指定した場合、このストリングは、新規プロセス・イメージ・ファイルの名前の前に引数として新規プロセスに渡されます。 ヘッダーは改行文字で終わらなければなりません。 呼び出されると、新規プロセスは Path パラメーターを ArgumentV[0] として渡します。 新規プロセス・イメージ・ファイルに String パラメーターが指定されている場合、 exec サブルーチンは ArgumentV[0] を、連結された String および Path パラメーター値に設定します。 渡される残りの引数は、 EXEC サブルーチンに渡されるものと同じです。

EXEC サブルーチンは、このプロセスによって未解決の 非同期入出力要求 を取り消そうとします。 非同期入出力要求を取り消すことができない場合、要求が完了するまでアプリケーションはブロックされます。

EXEC サブルーチンは ロード サブルーチンと似ていますが、 EXEC サブルーチンには明示的なライブラリー・パス・パラメーターがないという点が異なります。 代わりに、 exec サブルーチンは LIBPATH または LD_LIBRARY_PATH 環境変数を使用します。 LIBPATH 変数が設定されている場合は、 LD_LIBRARY_PATHを優先して使用されます。設定されていない場合は、 LD_LIBRARY_PATH が使用されます。 これらのライブラリー・パス変数は、 EXEC サブルーチンが実行されるプログラムに、呼び出し側プログラム (例えば、 水性 プログラム) より多くの特権がある場合には無視されます。

エクサクト サブルーチンは、 ptrace コマンドでトレースされる古いプログラムとの互換性のために組み込まれています。 実行中のプログラムは、強制的にハードウェア単一ステップ・モードになります。

パラメーター

C プログラムが実行されると、C プログラムは以下のパラメーターを受け取ります。

main (ArgumentCount, ArgumentV, EnvironmentPointer)
int ArgumentCount;
char *ArgumentV[ ], *EnvironmentPointer[ 
];

この例では、 ArgumentCount パラメーターは引数のカウントであり、 ArgumentV パラメーターは引数自体を指す文字ポインターの配列です。 規則により、 ArgumentCount パラメーターの値は少なくとも 1 であり、 ArgumentV[0] パラメーターは、新規プロセス・イメージ・ファイルの名前を含むストリングを指します。

C 言語プログラムの メイン ルーチンは、ランタイム・スタート・オフ・ルーチンで自動的に開始されます。 このルーチンは、 EnvironmentPointerでプログラムに渡される環境配列を指すように environ グローバル変数を設定します。 このグローバル変数にアクセスするには、プログラムに以下の宣言を組み込みます。

extern char **environ;

実行可能プログラム、 EXEC、 実行可能プログラム、および EXEC サブルーチンは、 エンビロン グローバル変数を使用して、呼び出しプロセスの現行環境を新規プロセスに渡します。

呼び出しプロセスでオープンされているファイル記述子は、 実行時クローズ フラグが設定されているファイル記述子を除き、オープンのままです。 オープンしたままのファイル記述子の場合、ファイル・ポインターは変更されません。 (ファイル制御については、 fcntl.h ファイルを参照してください。)

新規プロセス・イメージ内の変換状態記述子およびメッセージ・カタログ記述子は未定義です。 新規プロセスの場合、カテゴリーの LC_ALL (L) 値とロケールの 「C」 値を指定する setlocale サブルーチンに相当するものが、始動時に実行されます。

新しいプログラムが共用ライブラリーを必要とする場合、 EXEC サブルーチンは、それぞれのライブラリーを検出し、オープンし、新しいプロセス・アドレス・スペースにロードします。 EXEC の発行者によって使用されている共有ライブラリーの参照カウントが減分されます。 共有ライブラリーは、 ライブラリー・パス 環境変数にリストされているディレクトリーで検索されます。 これらのファイルのいずれかがリモートの場合、データはローカル仮想メモリーにコピーされます。

EXEC サブルーチンは、キャッチされたすべてのシグナルをデフォルトのアクションにリセットします。 デフォルト・アクションの原因となるシグナルは、 EXEC サブルーチンの後も引き続き実行されます。 無視されたシグナルは無視され、シグナル・マスクは同じままで、シグナル・スタック状態はリセットされます。 (シグナルについては、 署名アクション サブルーチンを参照してください。)

新規プロセス・イメージ・ファイルの SetUserID モード・ビットが設定されている場合、 exec サブルーチンは新規プロセスの有効ユーザー ID を新規プロセス・イメージ・ファイルの所有者 ID に設定します。 同様に、新規プロセス・イメージ・ファイルの SetGroupID モード・ビットが設定されている場合、新規プロセスの実効グループ ID は、新規プロセス・イメージ・ファイルのグループ ID に設定されます。 新規プロセスの実ユーザー ID および実グループ ID は、呼び出しプロセスの実ユーザー ID および実グループ ID と同じままです。 ( SetID モードについては、 chmod サブルーチンを参照してください。)

EXEC 操作の終了時に、プロセスの保管済みユーザー ID と保管済みグループ ID は、常にプロセスの実効ユーザー ID と実効グループ ID に設定されます。

セット ID モード・ビットの一方または両方が設定され、実行されるファイルがリモート・ファイルである場合、ファイル・ユーザーおよびグループ ID はサーバーでアウトバウンド変換を経由します。 その後、クライアント・ノードに送信され、インバウンド変換テーブルに従って変換されます。 これらの変換された ID は、新規プロセスのユーザー ID およびグループ ID になります。

新規プロセスのプロファイル作成は無効になっています。

新規プロセスは、呼び出しプロセスから以下の属性を継承します。

• nice 値 ( getpriority サブルーチン、 設定優先度 サブルーチン、 ナイス サブルーチンを参照)
• プロセス ID
• 親プロセスの ID
• プロセス・グループ ID
• 半調整 値 ( セモップ サブルーチンを参照)
• tty グループ ID ( 出口、 AtExit、または 終了 (_Exit) サブルーチン、 署名アクション サブルーチンを参照)
• トレース フラグ ( ptrace サブルーチンの要求 0 を参照)
• アラーム・クロック・シグナルまでの残り時間 ( incinterval サブルーチン、 setitimer サブルーチン、および alarm サブルーチンを参照)
• 現行ディレクトリー
• ルート・ディレクトリー
• ファイル・モード作成マスク ( Umask サブルーチンを参照)
• ファイル・サイズ制限 ( ulimit サブルーチンを参照)
• リソース限界 ( GetrLimit サブルーチン、 SetrLimit サブルーチン、および vlimit サブルーチンを参照)
• tms_utime,tms_stime,tms_cutime、およびtms_ctimeTMS 構造体のフィールド ( 回 サブルーチンを参照)
• ログイン・ユーザー ID

正常に完了すると、 EXEC サブルーチンは更新のマークを付けます。st_atimeファイルのフィールド。

例

1. コマンドを実行してパラメーターを渡すには、次のように入力します。

   execlp("ls", "ls", "-al", 0);

   実行可能プログラム サブルーチンは、 パス 環境変数にリストされている各ディレクトリーで LS コマンドを検索してから、このコマンドで現行プロセス・イメージをオーバーレイします。 LS コマンドを実行できない場合を除き、 実行可能プログラム サブルーチンは戻されません。
   注: この例ではシェル・コマンド・プロセッサーを実行しないため、シェルによって解釈される操作 (ファイル名にワイルドカード文字を使用するなど) は無効です。
2. シェルを実行してコマンドを解釈するには、次のように入力します。

   execl("/usr/bin/sh", "sh", "-c", "ls -l *.c", 
   0);

   これにより、 「-c」 フラグを指定して Sh コマンドが実行されます。これは、以下のパラメーターが解釈されるコマンドであることを示します。 この例では、 execlp サブルーチンの代わりに execl サブルーチンを使用します。絶対パス名 /usr/bin/sh が指定されているため、パス検索は不要です。

   通常、この例に示すように、子プロセスでシェル・コマンドを実行する方が、単に EXEC サブルーチンを使用するよりも有用です。 これを行う最も簡単な方法は、 システム サブルーチンを使用することです。

3. 実行するプログラムを指定する新規プロセス・ファイルの例を以下に示します。

   #! /usr/bin/awk -f
   { for (i = NF; i > 0; --i) print $i }

   このファイルに名前が付けられている場合reverseコマンド行に次のコマンドを入力します。

   reverse chapter1 chapter2

   このコマンドは、以下のコマンドを実行します。

   /usr/bin/awk -f reverse chapter1 chapter2

   注: EXEC サブルーチンは、新規プロセス・イメージ・ファイルの最初の行のみを使用し、残りの行は無視します。 また、 アーク コマンドは、# (ポンド記号) の後に続くテキストをコメントとして解釈します。

戻り値

正常に完了すると、呼び出しプロセス・イメージが新規プロセス・イメージによってオーバーレイされるため、 EXEC サブルーチンは戻りません。 EXEC サブルーチンが呼び出しプロセスに戻ると、値 -1 が戻され、エラーを識別するために エラー番号 グローバル変数が設定されます。

エラー・コード

EXEC サブルーチンが失敗すると、以下の 1 つ以上のエラー・コードを戻します。

パス名の解決を必要とする条件のために EXEC サブルーチンが失敗した場合は、以下の 1 つ以上のエラー・コードを戻します。

また、古いプロセス・イメージが上書きされた後で new-process ファイルを使用すると、いくつかのエラーが発生する可能性があります。 これらのエラーには、新規データおよびスタック・レジスターのセットアップの問題、共有ライブラリーのマッピングの問題、または新規プロセス・ファイルの読み取りの問題が含まれます。 呼び出しプロセスに戻ることができないため、これらのエラーのいずれかが発生すると、システムは シグキル シグナルをプロセスに送信します。

共有ライブラリーのマッピング中にエラーが発生した場合、シグナル シグキル がプロセスに送信される前に、エラーの理由を説明するエラー・メッセージが標準エラーに書き込まれます。 共用ライブラリーをマップできない場合、サブルーチンは以下のいずれかのエラー・コードを戻します。

Fexecve サブルーチンが失敗した場合は、以下のいずれかのエラー・コードも戻されることがあります。

NFS がシステムにインストールされている場合、以下の条件が満たされていると、 exec サブルーチンも失敗する可能性があります。