1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
// Copyright © Tavian Barnes <tavianator@tavianator.com>
// SPDX-License-Identifier: 0BSD
/**
* A process-spawning library inspired by posix_spawn().
*/
#ifndef BFS_XSPAWN_H
#define BFS_XSPAWN_H
#include "prelude.h"
#include <sys/resource.h>
#include <sys/types.h>
#include <unistd.h>
#if _POSIX_SPAWN > 0
# include <spawn.h>
#endif
/**
* bfs_spawn() flags.
*/
enum bfs_spawn_flags {
/** Use the PATH variable to resolve the executable (like execvp()). */
BFS_SPAWN_USE_PATH = 1 << 0,
/** Whether posix_spawn() can be used. */
BFS_SPAWN_USE_POSIX = 1 << 1,
};
/**
* bfs_spawn() attributes, controlling the context of the new process.
*/
struct bfs_spawn {
/** Spawn flags. */
enum bfs_spawn_flags flags;
/** Linked list of actions. */
struct bfs_spawn_action *head;
struct bfs_spawn_action **tail;
#if _POSIX_SPAWN > 0
/** posix_spawn() context, for when we can use it. */
posix_spawn_file_actions_t actions;
posix_spawnattr_t attr;
#endif
};
/**
* Create a new bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_init(struct bfs_spawn *ctx);
/**
* Destroy a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_destroy(struct bfs_spawn *ctx);
/**
* Add an open() action to a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_addopen(struct bfs_spawn *ctx, int fd, const char *path, int flags, mode_t mode);
/**
* Add a close() action to a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_addclose(struct bfs_spawn *ctx, int fd);
/**
* Add a dup2() action to a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_adddup2(struct bfs_spawn *ctx, int oldfd, int newfd);
/**
* Add an fchdir() action to a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_addfchdir(struct bfs_spawn *ctx, int fd);
/**
* Apply setrlimit() to a bfs_spawn() context.
*
* @return
* 0 on success, -1 on failure.
*/
int bfs_spawn_setrlimit(struct bfs_spawn *ctx, int resource, const struct rlimit *rl);
/**
* Spawn a new process.
*
* @param exe
* The executable to run.
* @param ctx
* The context for the new process.
* @param argv
* The arguments for the new process.
* @param envp
* The environment variables for the new process (NULL for the current
* environment).
* @return
* The PID of the new process, or -1 on error.
*/
pid_t bfs_spawn(const char *exe, const struct bfs_spawn *ctx, char **argv, char **envp);
/**
* Look up an executable in the current PATH, as BFS_SPAWN_USE_PATH or execvp()
* would do.
*
* @param exe
* The name of the binary to execute. Bare names without a '/' will be
* searched on the provided PATH.
* @return
* The full path to the executable, which should be free()'d, or NULL on
* failure.
*/
char *bfs_spawn_resolve(const char *exe);
#endif // BFS_XSPAWN_H
|
