名称

posix_spawnattr_init, posix_spawnattr_destroy — スポン属性オブジェクトを初期化して、破壊する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < spawn.h>

int
posix_spawnattr_init( posix_spawnattr_t * attr);

int
posix_spawnattr_destroy( posix_spawnattr_t * attr);

解説

posix_spawnattr_init() 関数は、実装によって使用される個々の属性のすべてのためのデフォルト値があるスポン属性オブジェクト attr を初期化します。既に初期化しているスポン属性オブジェクトを初期化することによって、メモリがリークされるかもしれません。

posix_spawnattr_destroy() 関数は、スポン属性オブジェクトを破壊します。 posix_spawnattr_init() を使用して、破壊された attr 属性オブジェクトを再初期化することができます。それを破壊した後に、オブジェクトを使用するべきではありません。

スポン属性オブジェクトは、 ( < spawn.h> で、定義される) タイプ posix_spawnattr_t であり、スポン操作に渡ってプロセス属性の継承を指定するために使用されます。

(場合により、個々の属性値を設定することによって変更される) 結果のスポン属性オブジェクトは、 posix_spawn() または posix_spawnp() の振る舞いを変更するために使用されます。スポン属性オブジェクトが posix_spawn() または posix_spawnp() への呼び出しによってプロセスをスポンするために使用された後に、 (破壊を含んで) 属性オブジェクトに影響する任意の関数は、このようにしてスポンされた任意のプロセスに影響しません。

戻り値

成功して終了すれば、 posix_spawnattr_init() と posix_spawnattr_destroy() は、0 を返します。そうでなければ、エラー番号が、エラーを示すために返されます。

エラー

posix_spawnattr_init() 関数は、次の場合に失敗します:

[ ENOMEM]

スポンファイルアクションオブジェクトを初期化するための十分なメモリがありません。

関連項目

posix_spawn(3), posix_spawnp(3)

規格

posix_spawnattr_init() と posix_spawnattr_destroy() 関数は、 IEEE Std 1003.1-2001 (“POSIX.1”) に適合しています。

歴史

posix_spawnattr_init() と posix_spawnattr_destroy() 関数は、 FreeBSD 8.0 ではじめて登場しました。

作者

Ed Schouten <ed@FreeBSD.org>