1/* $OpenBSD: spawn.h,v 1.3 2015/05/20 22:50:07 millert Exp $ */
2/*-
3 * Copyright (c) 2008 Ed Schouten <ed@FreeBSD.org>
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 * SUCH DAMAGE.
26 *
27 * $FreeBSD: src/include/spawn.h,v 1.3.2.1.6.1 2010/12/21 17:09:25 kensmith Exp $
28 */
29
30#ifndef _SPAWN_H_
31#define _SPAWN_H_
32
33#include <sys/types.h>
34#include <sys/signal.h>
35
36struct sched_param;
37
38typedef struct __posix_spawnattr *posix_spawnattr_t;
39typedef struct __posix_spawn_file_actions *posix_spawn_file_actions_t;
40
41#define POSIX_SPAWN_RESETIDS 0x01
42#define POSIX_SPAWN_SETPGROUP 0x02
43#define POSIX_SPAWN_SETSCHEDPARAM 0x04
44#define POSIX_SPAWN_SETSCHEDULER 0x08
45#define POSIX_SPAWN_SETSIGDEF 0x10
46#define POSIX_SPAWN_SETSIGMASK 0x20
47
48__BEGIN_DECLS
49/*
50 * Spawn routines
51 *
52 * XXX both arrays should be __restrict, but this does not work when GCC
53 * is invoked with -std=c99.
54 */
55int posix_spawn(pid_t *__restrict, const char *__restrict,
56 const posix_spawn_file_actions_t *, const posix_spawnattr_t *__restrict,
57 char *const [], char *const []);
58int posix_spawnp(pid_t *__restrict, const char *__restrict,
59 const posix_spawn_file_actions_t *, const posix_spawnattr_t *__restrict,
60 char *const [], char *const []);
61
62/*
63 * File descriptor actions
64 */
65int posix_spawn_file_actions_init(posix_spawn_file_actions_t *);
66int posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *);
67
68int posix_spawn_file_actions_addopen(posix_spawn_file_actions_t *__restrict,
69 int, const char *__restrict, int, mode_t);
70int posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *, int, int);
71int posix_spawn_file_actions_addclose(posix_spawn_file_actions_t *, int);
72
73/*
74 * Spawn attributes
75 */
76int posix_spawnattr_init(posix_spawnattr_t *);
77int posix_spawnattr_destroy(posix_spawnattr_t *);
78
79int posix_spawnattr_getflags(const posix_spawnattr_t *__restrict,
80 short *__restrict);
81int posix_spawnattr_getpgroup(const posix_spawnattr_t *__restrict,
82 pid_t *__restrict);
83int posix_spawnattr_getschedparam(const posix_spawnattr_t *__restrict,
84 struct sched_param *__restrict);
85int posix_spawnattr_getschedpolicy(const posix_spawnattr_t *__restrict,
86 int *__restrict);
87int posix_spawnattr_getsigdefault(const posix_spawnattr_t *__restrict,
88 sigset_t *__restrict);
89int posix_spawnattr_getsigmask(const posix_spawnattr_t *__restrict,
90 sigset_t *__restrict);
91
92int posix_spawnattr_setflags(posix_spawnattr_t *, short);
93int posix_spawnattr_setpgroup(posix_spawnattr_t *, pid_t);
94int posix_spawnattr_setschedparam(posix_spawnattr_t *__restrict,
95 const struct sched_param *__restrict);
96int posix_spawnattr_setschedpolicy(posix_spawnattr_t *, int);
97int posix_spawnattr_setsigdefault(posix_spawnattr_t *__restrict,
98 const sigset_t *__restrict);
99int posix_spawnattr_setsigmask(posix_spawnattr_t *__restrict,
100 const sigset_t *__restrict);
101__END_DECLS
102
103#endif /* !_SPAWN_H_ */