xref: /titanic_50/usr/src/head/spawn.h (revision 3f3aaf4e95972f6d6393cbff0a4652f4ee2c0dbf)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
24  *
25  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
26  * Use is subject to license terms.
27  */
28 
29 /*
30  * Copyright (c) 2011 by Delphix. All rights reserved.
31  */
32 
33 #ifndef _SPAWN_H
34 #define	_SPAWN_H
35 
36 #include <sys/feature_tests.h>
37 #include <sys/types.h>
38 #include <signal.h>
39 #include <sched.h>
40 
41 #ifdef	__cplusplus
42 extern "C" {
43 #endif
44 
45 /*
46  * flags for posix_spawnattr_setflags()
47  */
48 #define	POSIX_SPAWN_RESETIDS		0x0001
49 #define	POSIX_SPAWN_SETPGROUP		0x0002
50 #define	POSIX_SPAWN_SETSIGDEF		0x0004
51 #define	POSIX_SPAWN_SETSIGMASK		0x0008
52 #define	POSIX_SPAWN_SETSCHEDPARAM	0x0010
53 #define	POSIX_SPAWN_SETSCHEDULER	0x0020
54 /*
55  * non-portable Solaris extensions
56  */
57 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
58 #define	POSIX_SPAWN_SETSIGIGN_NP	0x0800
59 #define	POSIX_SPAWN_NOSIGCHLD_NP	0x1000
60 #define	POSIX_SPAWN_WAITPID_NP		0x2000
61 #define	POSIX_SPAWN_NOEXECERR_NP	0x4000
62 #endif	/* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
63 
64 typedef struct {
65 	void *__spawn_attrp;	/* implementation-private */
66 } posix_spawnattr_t;
67 
68 typedef struct {
69 	void *__file_attrp;	/* implementation-private */
70 } posix_spawn_file_actions_t;
71 
72 extern int posix_spawn(
73 	pid_t *_RESTRICT_KYWD pid,
74 	const char *_RESTRICT_KYWD path,
75 	const posix_spawn_file_actions_t *file_actions,
76 	const posix_spawnattr_t *_RESTRICT_KYWD attrp,
77 	char *const argv[_RESTRICT_KYWD],
78 	char *const envp[_RESTRICT_KYWD]);
79 
80 extern int posix_spawnp(
81 	pid_t *_RESTRICT_KYWD pid,
82 	const char *_RESTRICT_KYWD file,
83 	const posix_spawn_file_actions_t *file_actions,
84 	const posix_spawnattr_t *_RESTRICT_KYWD attrp,
85 	char *const argv[_RESTRICT_KYWD],
86 	char *const envp[_RESTRICT_KYWD]);
87 
88 extern int posix_spawn_file_actions_init(
89 	posix_spawn_file_actions_t *file_actions);
90 
91 extern int posix_spawn_file_actions_destroy(
92 	posix_spawn_file_actions_t *file_actions);
93 
94 extern int posix_spawn_file_actions_addopen(
95 	posix_spawn_file_actions_t *_RESTRICT_KYWD file_actions,
96 	int filedes,
97 	const char *_RESTRICT_KYWD path,
98 	int oflag,
99 	mode_t mode);
100 
101 extern int posix_spawn_file_actions_addclose(
102 	posix_spawn_file_actions_t *file_actions,
103 	int filedes);
104 
105 extern int posix_spawn_file_actions_adddup2(
106 	posix_spawn_file_actions_t *file_actions,
107 	int filedes,
108 	int newfiledes);
109 
110 extern int posix_spawnattr_init(
111 	posix_spawnattr_t *attr);
112 
113 extern int posix_spawnattr_destroy(
114 	posix_spawnattr_t *attr);
115 
116 extern int posix_spawnattr_setflags(
117 	posix_spawnattr_t *attr,
118 	short flags);
119 
120 extern int posix_spawnattr_getflags(
121 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
122 	short *_RESTRICT_KYWD flags);
123 
124 extern int posix_spawnattr_setpgroup(
125 	posix_spawnattr_t *attr,
126 	pid_t pgroup);
127 
128 extern int posix_spawnattr_getpgroup(
129 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
130 	pid_t *_RESTRICT_KYWD pgroup);
131 
132 extern int posix_spawnattr_setschedparam(
133 	posix_spawnattr_t *_RESTRICT_KYWD attr,
134 	const struct sched_param *_RESTRICT_KYWD schedparam);
135 
136 extern int posix_spawnattr_getschedparam(
137 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
138 	struct sched_param *_RESTRICT_KYWD schedparam);
139 
140 extern int posix_spawnattr_setschedpolicy(
141 	posix_spawnattr_t *attr,
142 	int schedpolicy);
143 
144 extern int posix_spawnattr_getschedpolicy(
145 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
146 	int *_RESTRICT_KYWD schedpolicy);
147 
148 extern int posix_spawnattr_setsigdefault(
149 	posix_spawnattr_t *_RESTRICT_KYWD attr,
150 	const sigset_t *_RESTRICT_KYWD sigdefault);
151 
152 extern int posix_spawnattr_getsigdefault(
153 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
154 	sigset_t *_RESTRICT_KYWD sigdefault);
155 
156 /*
157  * non-portable Solaris extensions
158  */
159 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
160 
161 extern int posix_spawn_pipe_np(
162 	pid_t *_RESTRICT_KYWD pidp,
163 	int *_RESTRICT_KYWD fdp,
164 	const char *_RESTRICT_KYWD cmd,
165 	boolean_t write,
166 	posix_spawn_file_actions_t *_RESTRICT_KYWD fact,
167 	posix_spawnattr_t *_RESTRICT_KYWD attr);
168 
169 extern int posix_spawn_file_actions_addclosefrom_np(
170 	posix_spawn_file_actions_t *file_actions,
171 	int lowfiledes);
172 
173 extern int posix_spawnattr_setsigignore_np(
174 	posix_spawnattr_t *_RESTRICT_KYWD attr,
175 	const sigset_t *_RESTRICT_KYWD sigignore);
176 
177 extern int posix_spawnattr_getsigignore_np(
178 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
179 	sigset_t *_RESTRICT_KYWD sigignore);
180 
181 #endif	/* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
182 
183 extern int posix_spawnattr_setsigmask(
184 	posix_spawnattr_t *_RESTRICT_KYWD attr,
185 	const sigset_t *_RESTRICT_KYWD sigmask);
186 
187 extern int posix_spawnattr_getsigmask(
188 	const posix_spawnattr_t *_RESTRICT_KYWD attr,
189 	sigset_t *_RESTRICT_KYWD sigmask);
190 
191 #ifdef	__cplusplus
192 }
193 #endif
194 
195 #endif	/* _SPAWN_H */
196