diff options
Diffstat (limited to 'spawn.h')
| -rw-r--r-- | spawn.h | 44 |
1 files changed, 43 insertions, 1 deletions
@@ -21,23 +21,65 @@ #include <signal.h> #include <sys/types.h> +/** + * bfs_spawn() flags. + */ enum bfs_spawn_flags { + /** Use the PATH variable to resolve the executable (like execvp()). */ BFS_SPAWN_USEPATH = 1 << 0, }; +/** + * bfs_spawn() attributes, controlling the context of the new process. + */ struct bfs_spawn { enum bfs_spawn_flags flags; struct bfs_spawn_action *actions; struct bfs_spawn_action **tail; }; +/** + * 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); +/** + * Set the flags for a bfs_spawn() context. + * + * @return 0 on success, -1 on failure. + */ int bfs_spawn_setflags(struct bfs_spawn *ctx, enum bfs_spawn_flags flags); +/** + * 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); -pid_t bfs_spawn(const char *file, const struct bfs_spawn *ctx, char **argv, char **envp); +/** + * 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. + * @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); #endif // BFS_SPAWN_H |