1/* SPDX-License-Identifier: GPL-2.0 */
 2#ifndef __SUBCMD_RUN_COMMAND_H
 3#define __SUBCMD_RUN_COMMAND_H
 4
 5#include <unistd.h>
 6
 7enum {
 8	ERR_RUN_COMMAND_FORK = 10000,
 9	ERR_RUN_COMMAND_EXEC,
10	ERR_RUN_COMMAND_PIPE,
11	ERR_RUN_COMMAND_WAITPID,
12	ERR_RUN_COMMAND_WAITPID_WRONG_PID,
13	ERR_RUN_COMMAND_WAITPID_SIGNAL,
14	ERR_RUN_COMMAND_WAITPID_NOEXIT,
15};
16#define IS_RUN_COMMAND_ERR(x) (-(x) >= ERR_RUN_COMMAND_FORK)
17
18struct child_process {
19	const char **argv;
20	pid_t pid;
21	/*
22	 * Using .in, .out, .err:
23	 * - Specify 0 for no redirections (child inherits stdin, stdout,
24	 *   stderr from parent).
25	 * - Specify -1 to have a pipe allocated as follows:
26	 *     .in: returns the writable pipe end; parent writes to it,
27	 *          the readable pipe end becomes child's stdin
28	 *     .out, .err: returns the readable pipe end; parent reads from
29	 *          it, the writable pipe end becomes child's stdout/stderr
30	 *   The caller of start_command() must close the returned FDs
31	 *   after it has completed reading from/writing to it!
32	 * - Specify > 0 to set a channel to a particular FD as follows:
33	 *     .in: a readable FD, becomes child's stdin
34	 *     .out: a writable FD, becomes child's stdout/stderr
35	 *     .err > 0 not supported
36	 *   The specified FD is closed by start_command(), even in case
37	 *   of errors!
38	 */
39	int in;
40	int out;
41	int err;
42	const char *dir;
43	const char *const *env;
44	int finish_result;
45	unsigned no_stdin:1;
46	unsigned no_stdout:1;
47	unsigned no_stderr:1;
48	unsigned exec_cmd:1; /* if this is to be external sub-command */
49	unsigned stdout_to_stderr:1;
50	unsigned finished:1;
51	void (*preexec_cb)(void);
52	 /* If set, call function in child rather than doing an exec. */
53	int (*no_exec_cmd)(struct child_process *process);
54};
55
56int start_command(struct child_process *);
57int check_if_command_finished(struct child_process *);
58int finish_command(struct child_process *);
59int run_command(struct child_process *);
60
61#define RUN_COMMAND_NO_STDIN 1
62#define RUN_EXEC_CMD	     2	/*If this is to be external sub-command */
63#define RUN_COMMAND_STDOUT_TO_STDERR 4
64int run_command_v_opt(const char **argv, int opt);
65
66#endif /* __SUBCMD_RUN_COMMAND_H */

 
 1#ifndef __SUBCMD_RUN_COMMAND_H
 2#define __SUBCMD_RUN_COMMAND_H
 3
 4#include <unistd.h>
 5
 6enum {
 7	ERR_RUN_COMMAND_FORK = 10000,
 8	ERR_RUN_COMMAND_EXEC,
 9	ERR_RUN_COMMAND_PIPE,
10	ERR_RUN_COMMAND_WAITPID,
11	ERR_RUN_COMMAND_WAITPID_WRONG_PID,
12	ERR_RUN_COMMAND_WAITPID_SIGNAL,
13	ERR_RUN_COMMAND_WAITPID_NOEXIT,
14};
15#define IS_RUN_COMMAND_ERR(x) (-(x) >= ERR_RUN_COMMAND_FORK)
16
17struct child_process {
18	const char **argv;
19	pid_t pid;
20	/*
21	 * Using .in, .out, .err:
22	 * - Specify 0 for no redirections (child inherits stdin, stdout,
23	 *   stderr from parent).
24	 * - Specify -1 to have a pipe allocated as follows:
25	 *     .in: returns the writable pipe end; parent writes to it,
26	 *          the readable pipe end becomes child's stdin
27	 *     .out, .err: returns the readable pipe end; parent reads from
28	 *          it, the writable pipe end becomes child's stdout/stderr
29	 *   The caller of start_command() must close the returned FDs
30	 *   after it has completed reading from/writing to it!
31	 * - Specify > 0 to set a channel to a particular FD as follows:
32	 *     .in: a readable FD, becomes child's stdin
33	 *     .out: a writable FD, becomes child's stdout/stderr
34	 *     .err > 0 not supported
35	 *   The specified FD is closed by start_command(), even in case
36	 *   of errors!
37	 */
38	int in;
39	int out;
40	int err;
41	const char *dir;
42	const char *const *env;
 
43	unsigned no_stdin:1;
44	unsigned no_stdout:1;
45	unsigned no_stderr:1;
46	unsigned exec_cmd:1; /* if this is to be external sub-command */
47	unsigned stdout_to_stderr:1;
 
48	void (*preexec_cb)(void);
 
 
49};
50
51int start_command(struct child_process *);
 
52int finish_command(struct child_process *);
53int run_command(struct child_process *);
54
55#define RUN_COMMAND_NO_STDIN 1
56#define RUN_EXEC_CMD	     2	/*If this is to be external sub-command */
57#define RUN_COMMAND_STDOUT_TO_STDERR 4
58int run_command_v_opt(const char **argv, int opt);
59
60#endif /* __SUBCMD_RUN_COMMAND_H */