posix_spawnattr_destroy または posix_spawnattr_init サブルーチン

目的

spawn 属性オブジェクトを破棄し、初期化します。

構文

#include <spawn.h>

int posix_spawnattr_destroy(posix_spawnattr_t *attr);
int posix_spawnattr_init(posix_spawnattr_t *attr); 

説明

posix_spawnattr_destroy サブルーチンは、spawn 属性オブジェクトを破棄します。 破棄された attr 属性オブジェクトは、 posix_spawnattr_initを使用して再初期化できます。それ以外の場合は、破棄されたオブジェクトを参照した後の結果は未定義です。 インプリメンテーションが原因で、 posix_spawnattr_destroyattr によって参照されるオブジェクトを無効な値に設定することがあります。

posix_spawnattr_init サブルーチンは、spawn 属性オブジェクト attr を、インプリメンテーションが使用する個々の属性すべてのデフォルト値で初期化します。 既に初期化されている attr 属性オブジェクトを指定して posix_spawnattr_init を呼び出すと、結果は未定義になります。

spawn 属性オブジェクトは、タイプ posix_spawnattr_t ( spawn.h ヘッダー・ファイルで定義) で、spawn 操作全体にわたるプロセス属性の継承を指定するために使用されます。 型 posix_spawnattr_t の比較演算子または代入演算子が定義されていません。

各実装は、使用する個々の属性とそのデフォルト値を文書化します。ただし、これらの値が IEEE Std 1003.1-2001によって定義されている場合を除きます。 IEEE Std 1003.1-2001によって定義されていない属性、そのデフォルト値、およびそれらの属性値を取得および設定する関連関数の名前は、インプリメンテーションによって定義されます。

結果の spawn 属性オブジェクト (個々の属性値を設定することによって変更される可能性があります) は、 posix_spawn または posix_spawnpの動作を変更するために使用されます。 posix_spawn または posix_spawnpの呼び出しによってプロセスを spawn するために spawn 属性オブジェクトが使用された後は、属性オブジェクトに影響を与える関数 (破棄を含む) は、この方法で spawn されたプロセスには影響しません。

戻り値

正常終了すると、 posix_spawnattr_destroy および posix_spawnattr_init サブルーチンは 0を戻します。それ以外の場合は、エラーを示すエラー番号が戻されます。

エラー・コード

posix_spawnattr_destroy サブルーチンは、以下の場合に失敗することがあります。
項目 説明
EINVAL attr によって指定された値が無効です。