/* Definitions for POSIX spawn interface.

[0] Fix | Delete

Copyright (C) 2000-2018 Free Software Foundation, Inc.

[1] Fix | Delete

This file is part of the GNU C Library.

[2] Fix | Delete

[3] Fix | Delete

The GNU C Library is free software; you can redistribute it and/or

[4] Fix | Delete

modify it under the terms of the GNU Lesser General Public

[5] Fix | Delete

License as published by the Free Software Foundation; either

[6] Fix | Delete

version 2.1 of the License, or (at your option) any later version.

[7] Fix | Delete

[8] Fix | Delete

The GNU C Library is distributed in the hope that it will be useful,

[9] Fix | Delete

but WITHOUT ANY WARRANTY; without even the implied warranty of

[10] Fix | Delete

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

[11] Fix | Delete

Lesser General Public License for more details.

[12] Fix | Delete

[13] Fix | Delete

You should have received a copy of the GNU Lesser General Public

[14] Fix | Delete

License along with the GNU C Library; if not, see

[15] Fix | Delete

<http://www.gnu.org/licenses/>. */

[16] Fix | Delete

[17] Fix | Delete

#ifndef _SPAWN_H

[18] Fix | Delete

#define _SPAWN_H 1

[19] Fix | Delete

[20] Fix | Delete

#include <features.h>

[21] Fix | Delete

#include <sched.h>

[22] Fix | Delete

#include <sys/types.h>

[23] Fix | Delete

#include <bits/types/sigset_t.h>

[24] Fix | Delete

[25] Fix | Delete

[26] Fix | Delete

/* Data structure to contain attributes for thread creation. */

[27] Fix | Delete

typedef struct

[28] Fix | Delete

{

[29] Fix | Delete

short int __flags;

[30] Fix | Delete

pid_t __pgrp;

[31] Fix | Delete

sigset_t __sd;

[32] Fix | Delete

sigset_t __ss;

[33] Fix | Delete

struct sched_param __sp;

[34] Fix | Delete

int __policy;

[35] Fix | Delete

int __pad[16];

[36] Fix | Delete

} posix_spawnattr_t;

[37] Fix | Delete

[38] Fix | Delete

[39] Fix | Delete

/* Data structure to contain information about the actions to be

[40] Fix | Delete

performed in the new process with respect to file descriptors. */

[41] Fix | Delete

typedef struct

[42] Fix | Delete

{

[43] Fix | Delete

int __allocated;

[44] Fix | Delete

int __used;

[45] Fix | Delete

struct __spawn_action *__actions;

[46] Fix | Delete

int __pad[16];

[47] Fix | Delete

} posix_spawn_file_actions_t;

[48] Fix | Delete

[49] Fix | Delete

[50] Fix | Delete

/* Flags to be set in the `posix_spawnattr_t'. */

[51] Fix | Delete

#define POSIX_SPAWN_RESETIDS 0x01

[52] Fix | Delete

#define POSIX_SPAWN_SETPGROUP 0x02

[53] Fix | Delete

#define POSIX_SPAWN_SETSIGDEF 0x04

[54] Fix | Delete

#define POSIX_SPAWN_SETSIGMASK 0x08

[55] Fix | Delete

#define POSIX_SPAWN_SETSCHEDPARAM 0x10

[56] Fix | Delete

#define POSIX_SPAWN_SETSCHEDULER 0x20

[57] Fix | Delete

#ifdef __USE_GNU

[58] Fix | Delete

# define POSIX_SPAWN_USEVFORK 0x40

[59] Fix | Delete

# define POSIX_SPAWN_SETSID 0x80

[60] Fix | Delete

#endif

[61] Fix | Delete

[62] Fix | Delete

[63] Fix | Delete

__BEGIN_DECLS

[64] Fix | Delete

[65] Fix | Delete

/* Spawn a new process executing PATH with the attributes describes in *ATTRP.

[66] Fix | Delete

Before running the process perform the actions described in FILE-ACTIONS.

[67] Fix | Delete

[68] Fix | Delete

This function is a possible cancellation point and therefore not

[69] Fix | Delete

marked with __THROW. */

[70] Fix | Delete

extern int posix_spawn (pid_t *__restrict __pid,

[71] Fix | Delete

const char *__restrict __path,

[72] Fix | Delete

const posix_spawn_file_actions_t *__restrict

[73] Fix | Delete

__file_actions,

[74] Fix | Delete

const posix_spawnattr_t *__restrict __attrp,

[75] Fix | Delete

char *const __argv[__restrict_arr],

[76] Fix | Delete

char *const __envp[__restrict_arr]);

[77] Fix | Delete

[78] Fix | Delete

/* Similar to `posix_spawn' but search for FILE in the PATH.

[79] Fix | Delete

[80] Fix | Delete

This function is a possible cancellation point and therefore not

[81] Fix | Delete

marked with __THROW. */

[82] Fix | Delete

extern int posix_spawnp (pid_t *__pid, const char *__file,

[83] Fix | Delete

const posix_spawn_file_actions_t *__file_actions,

[84] Fix | Delete

const posix_spawnattr_t *__attrp,

[85] Fix | Delete

char *const __argv[], char *const __envp[]);

[86] Fix | Delete

[87] Fix | Delete

[88] Fix | Delete

/* Initialize data structure with attributes for `spawn' to default values. */

[89] Fix | Delete

extern int posix_spawnattr_init (posix_spawnattr_t *__attr) __THROW;

[90] Fix | Delete

[91] Fix | Delete

/* Free resources associated with ATTR. */

[92] Fix | Delete

extern int posix_spawnattr_destroy (posix_spawnattr_t *__attr) __THROW;

[93] Fix | Delete

[94] Fix | Delete

/* Store signal mask for signals with default handling from ATTR in

[95] Fix | Delete

SIGDEFAULT. */

[96] Fix | Delete

extern int posix_spawnattr_getsigdefault (const posix_spawnattr_t *

[97] Fix | Delete

__restrict __attr,

[98] Fix | Delete

sigset_t *__restrict __sigdefault)

[99] Fix | Delete

__THROW;

[100] Fix | Delete

[101] Fix | Delete

/* Set signal mask for signals with default handling in ATTR to SIGDEFAULT. */

[102] Fix | Delete

extern int posix_spawnattr_setsigdefault (posix_spawnattr_t *__restrict __attr,

[103] Fix | Delete

const sigset_t *__restrict

[104] Fix | Delete

__sigdefault)

[105] Fix | Delete

__THROW;

[106] Fix | Delete

[107] Fix | Delete

/* Store signal mask for the new process from ATTR in SIGMASK. */

[108] Fix | Delete

extern int posix_spawnattr_getsigmask (const posix_spawnattr_t *__restrict

[109] Fix | Delete

__attr,

[110] Fix | Delete

sigset_t *__restrict __sigmask) __THROW;

[111] Fix | Delete

[112] Fix | Delete

/* Set signal mask for the new process in ATTR to SIGMASK. */

[113] Fix | Delete

extern int posix_spawnattr_setsigmask (posix_spawnattr_t *__restrict __attr,

[114] Fix | Delete

const sigset_t *__restrict __sigmask)

[115] Fix | Delete

__THROW;

[116] Fix | Delete

[117] Fix | Delete

/* Get flag word from the attribute structure. */

[118] Fix | Delete

extern int posix_spawnattr_getflags (const posix_spawnattr_t *__restrict

[119] Fix | Delete

__attr,

[120] Fix | Delete

short int *__restrict __flags) __THROW;

[121] Fix | Delete

[122] Fix | Delete

/* Store flags in the attribute structure. */

[123] Fix | Delete

extern int posix_spawnattr_setflags (posix_spawnattr_t *_attr,

[124] Fix | Delete

short int __flags) __THROW;

[125] Fix | Delete

[126] Fix | Delete

/* Get process group ID from the attribute structure. */

[127] Fix | Delete

extern int posix_spawnattr_getpgroup (const posix_spawnattr_t *__restrict

[128] Fix | Delete

__attr, pid_t *__restrict __pgroup)

[129] Fix | Delete

__THROW;

[130] Fix | Delete

[131] Fix | Delete

/* Store process group ID in the attribute structure. */

[132] Fix | Delete

extern int posix_spawnattr_setpgroup (posix_spawnattr_t *__attr,

[133] Fix | Delete

pid_t __pgroup) __THROW;

[134] Fix | Delete

[135] Fix | Delete

/* Get scheduling policy from the attribute structure. */

[136] Fix | Delete

extern int posix_spawnattr_getschedpolicy (const posix_spawnattr_t *

[137] Fix | Delete

__restrict __attr,

[138] Fix | Delete

int *__restrict __schedpolicy)

[139] Fix | Delete

__THROW;

[140] Fix | Delete

[141] Fix | Delete

/* Store scheduling policy in the attribute structure. */

[142] Fix | Delete

extern int posix_spawnattr_setschedpolicy (posix_spawnattr_t *__attr,

[143] Fix | Delete

int __schedpolicy) __THROW;

[144] Fix | Delete

[145] Fix | Delete

/* Get scheduling parameters from the attribute structure. */

[146] Fix | Delete

extern int posix_spawnattr_getschedparam (const posix_spawnattr_t *

[147] Fix | Delete

__restrict __attr,

[148] Fix | Delete

struct sched_param *__restrict

[149] Fix | Delete

__schedparam) __THROW;

[150] Fix | Delete

[151] Fix | Delete

/* Store scheduling parameters in the attribute structure. */

[152] Fix | Delete

extern int posix_spawnattr_setschedparam (posix_spawnattr_t *__restrict __attr,

[153] Fix | Delete

const struct sched_param *

[154] Fix | Delete

__restrict __schedparam) __THROW;

[155] Fix | Delete

[156] Fix | Delete

[157] Fix | Delete

/* Initialize data structure for file attribute for `spawn' call. */

[158] Fix | Delete

extern int posix_spawn_file_actions_init (posix_spawn_file_actions_t *

[159] Fix | Delete

__file_actions) __THROW;

[160] Fix | Delete

[161] Fix | Delete

/* Free resources associated with FILE-ACTIONS. */

[162] Fix | Delete

extern int posix_spawn_file_actions_destroy (posix_spawn_file_actions_t *

[163] Fix | Delete

__file_actions) __THROW;

[164] Fix | Delete

[165] Fix | Delete

/* Add an action to FILE-ACTIONS which tells the implementation to call

[166] Fix | Delete

`open' for the given file during the `spawn' call. */

[167] Fix | Delete

extern int posix_spawn_file_actions_addopen (posix_spawn_file_actions_t *

[168] Fix | Delete

__restrict __file_actions,

[169] Fix | Delete

int __fd,

[170] Fix | Delete

const char *__restrict __path,

[171] Fix | Delete

int __oflag, mode_t __mode)

[172] Fix | Delete

__THROW;

[173] Fix | Delete

[174] Fix | Delete

/* Add an action to FILE-ACTIONS which tells the implementation to call

[175] Fix | Delete

`close' for the given file descriptor during the `spawn' call. */

[176] Fix | Delete

extern int posix_spawn_file_actions_addclose (posix_spawn_file_actions_t *

[177] Fix | Delete

__file_actions, int __fd)

[178] Fix | Delete

__THROW;

[179] Fix | Delete

[180] Fix | Delete

/* Add an action to FILE-ACTIONS which tells the implementation to call

[181] Fix | Delete

`dup2' for the given file descriptors during the `spawn' call. */

[182] Fix | Delete

extern int posix_spawn_file_actions_adddup2 (posix_spawn_file_actions_t *

[183] Fix | Delete

__file_actions,

[184] Fix | Delete

int __fd, int __newfd) __THROW;

[185] Fix | Delete

[186] Fix | Delete

__END_DECLS

[187] Fix | Delete

[188] Fix | Delete

#endif /* spawn.h */

[189] Fix | Delete

[190] Fix | Delete