The Open Group Base Specifications Issue 6
IEEE Std 1003.1, 2004 Edition
Copyright © 2001-2004 The IEEE and The Open Group, All Rights reserved.

#### NAME

> spawn.h - spawn (ADVANCED REALTIME)

#### SYNOPSIS

> `[SPN] #include <spawn.h>`

#### DESCRIPTION

> The <spawn.h> header shall define the posix_spawnattr_t and posix_spawn_file_actions_t types used in performing spawn operations.

> The <spawn.h> header shall define the flags that may be set in a posix_spawnattr_t object using the posix_spawnattr_setflags() function:

> POSIX_SPAWN_RESETIDS
> POSIX_SPAWN_SETPGROUP
> [PS]
> POSIX_SPAWN_SETSCHEDPARAM
> POSIX_SPAWN_SETSCHEDULER
> POSIX_SPAWN_SETSIGDEF
> POSIX_SPAWN_SETSIGMASK

> The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.

>     int   posix_spawn(pid_t *restrict, const char *restrict,
>               const posix_spawn_file_actions_t *,
>               const posix_spawnattr_t *restrict, char *const [restrict],
>               char *const [restrict]);
>     int   posix_spawn_file_actions_addclose(posix_spawn_file_actions_t *,
>               int);
>     int   posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *,
>               int, int);
>     int   posix_spawn_file_actions_addopen(posix_spawn_file_actions_t *restrict,
>               int, const char *restrict, int, mode_t);
>     int   posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *);
>     int   posix_spawn_file_actions_init(posix_spawn_file_actions_t *);
>     int   posix_spawnattr_destroy(posix_spawnattr_t *);
>     int   posix_spawnattr_getsigdefault(const posix_spawnattr_t *restrict,
>               sigset_t *restrict);
>     int   posix_spawnattr_getflags(const posix_spawnattr_t *restrict,
>               short *restrict);
>     int   posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict,
>               pid_t *restrict);
>     [PS]
>     int   posix_spawnattr_getschedparam(const posix_spawnattr_t *restrict,
>               struct sched_param *restrict);
>     int   posix_spawnattr_getschedpolicy(const posix_spawnattr_t *restrict,
>               int *restrict);

>     int   posix_spawnattr_getsigmask(const posix_spawnattr_t *restrict,
>               sigset_t *restrict);
>     int   posix_spawnattr_init(posix_spawnattr_t *);
>     int   posix_spawnattr_setsigdefault(posix_spawnattr_t *restrict,
>               const sigset_t *restrict);
>     int   posix_spawnattr_setflags(posix_spawnattr_t *, short);
>     int   posix_spawnattr_setpgroup(posix_spawnattr_t *, pid_t);

>     [PS]
>     int   posix_spawnattr_setschedparam(posix_spawnattr_t *restrict,
>               const struct sched_param *restrict);
>     int   posix_spawnattr_setschedpolicy(posix_spawnattr_t *, int);

>     int   posix_spawnattr_setsigmask(posix_spawnattr_t *restrict,
>               const sigset_t *restrict);
>     int   posix_spawnp(pid_t *restrict, const char *restrict,
>               const posix_spawn_file_actions_t *,
>               const posix_spawnattr_t *restrict,
>               char *const [restrict], char *const [restrict]);

> Inclusion of the <spawn.h> header may make visible symbols defined in the <sched.h>, <signal.h>, and <sys/types.h> headers.

The following sections are informative.

#### APPLICATION USAGE

> None.

#### RATIONALE

> None.

#### FUTURE DIRECTIONS

> None.

#### SEE ALSO

> <sched.h>, <semaphore.h>, <signal.h>, <sys/types.h>, the System Interfaces volume of IEEE Std 1003.1-2001, posix_spawnattr_destroy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getflags(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigmask(), posix_spawnattr_init(), posix_spawnattr_setsigdefault(), posix_spawnattr_setflags(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigmask(), posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_addopen(), posix_spawn_file_actions_destroy(), posix_spawn_file_actions_init(), posix_spawnp()

#### CHANGE HISTORY

> First released in Issue 6. Included for alignment with IEEE Std 1003.1d-1999.

> The restrict keyword is added to the prototypes for posix_spawn(), posix_spawn_file_actions_addopen(), posix_spawnattr_getsigdefault(), posix_spawnattr_getflags(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigmask(), posix_spawnattr_setsigdefault(), posix_spawnattr_setschedparam(), posix_spawnattr_setsigmask(), and posix_spawnp().

End of informative text.

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
[ Main Index | XBD | XCU | XSH | XRAT ]