Ruby: internal/process.h Source File

Ruby 3.3.4p94 (2024-07-09 revision be1089c8ec5ba40e09b1553e36b3174bf4014d9d)

process.h
1#ifndef INTERNAL_PROCESS_H /*-*-C-*-vi:se ft=c:*/
2#define INTERNAL_PROCESS_H
11#include "ruby/internal/config.h" /* for rb_pid_t */
12#include <stddef.h> /* for size_t */
13
14#ifdef HAVE_SYS_TYPES_H
15# include <sys/types.h> /* for mode_t */
16#endif
17
18#ifdef _WIN32
19# include "ruby/win32.h" /* for mode_t */
20#endif
21
22#include "ruby/ruby.h" /* for VALUE */
23#include "internal/compilers.h" /* for __has_warning */
24#include "internal/imemo.h" /* for RB_IMEMO_TMPBUF_PTR */
25
26#define RB_MAX_GROUPS (65536)
27
28struct waitpid_state;
29struct rb_process_status;
30 struct rb_execarg {
31 union {
32 struct {
33 VALUE shell_script;
34 } sh;
35 struct {
36 VALUE command_name;
37 VALUE command_abspath; /* full path string or nil */
38 VALUE argv_str;
39 VALUE argv_buf;
40 } cmd;
41 } invoke;
42 VALUE redirect_fds;
43 VALUE envp_str;
44 VALUE envp_buf;
45 VALUE dup2_tmpbuf;
46 unsigned use_shell : 1;
47 unsigned pgroup_given : 1;
48 unsigned umask_given : 1;
49 unsigned unsetenv_others_given : 1;
50 unsigned unsetenv_others_do : 1;
51 unsigned close_others_given : 1;
52 unsigned close_others_do : 1;
53 unsigned chdir_given : 1;
54 unsigned new_pgroup_given : 1;
55 unsigned new_pgroup_flag : 1;
56 unsigned uid_given : 1;
57 unsigned gid_given : 1;
58 unsigned exception : 1;
59 unsigned exception_given : 1;
60 struct rb_process_status *status;
61 struct waitpid_state *waitpid_state; /* for async process management */
62 rb_pid_t pgroup_pgid; /* asis(-1), new pgroup(0), specified pgroup (0<V). */
63 VALUE rlimit_limits; /* Qfalse or [[rtype, softlim, hardlim], ...] */
64 mode_t umask_mask;
65 rb_uid_t uid;
66 rb_gid_t gid;
67 int close_others_maxhint;
68 VALUE fd_dup2;
69 VALUE fd_close;
70 VALUE fd_open;
71 VALUE fd_dup2_child;
72 VALUE env_modification; /* Qfalse or [[k1,v1], ...] */
73 VALUE path_env;
74 VALUE chdir_dir;
75};
76
77/* process.c */
78rb_pid_t rb_call_proc__fork(void);
79void rb_last_status_clear(void);
80static inline char **ARGVSTR2ARGV(VALUE argv_str);
81static inline size_t ARGVSTR2ARGC(VALUE argv_str);
82
83#ifdef HAVE_PWD_H
84 VALUE rb_getlogin(void);
85 VALUE rb_getpwdirnam_for_login(VALUE login); /* read as: "get pwd db home dir by username for login" */
86 VALUE rb_getpwdiruid(void); /* read as: "get pwd db home dir for getuid()" */
87#endif
88
89RUBY_SYMBOL_EXPORT_BEGIN
90/* process.c (export) */
91int rb_exec_async_signal_safe(const struct rb_execarg *e, char *errmsg, size_t errmsg_buflen);
92rb_pid_t rb_fork_async_signal_safe(int *status, int (*chfunc)(void*, char *, size_t), void *charg, VALUE fds, char *errmsg, size_t errmsg_buflen);
93 VALUE rb_execarg_new(int argc, const VALUE *argv, int accept_shell, int allow_exc_opt);
94struct rb_execarg *rb_execarg_get(VALUE execarg_obj); /* dangerous. needs GC guard. */
95int rb_execarg_addopt(VALUE execarg_obj, VALUE key, VALUE val);
96void rb_execarg_parent_start(VALUE execarg_obj);
97void rb_execarg_parent_end(VALUE execarg_obj);
98int rb_execarg_run_options(const struct rb_execarg *e, struct rb_execarg *s, char* errmsg, size_t errmsg_buflen);
99 VALUE rb_execarg_extract_options(VALUE execarg_obj, VALUE opthash);
100void rb_execarg_setenv(VALUE execarg_obj, VALUE env);
101RUBY_SYMBOL_EXPORT_END
102
103/* argv_str contains extra two elements.
104 * The beginning one is for /bin/sh used by exec_with_sh.
105 * The last one for terminating NULL used by execve.
106 * See rb_exec_fillarg() in process.c. */
107static inline char **
108ARGVSTR2ARGV(VALUE argv_str)
109{
110 char **buf = RB_IMEMO_TMPBUF_PTR(argv_str);
111 return &buf[1];
112}
113
114static inline size_t
115ARGVSTR2ARGC(VALUE argv_str)
116{
117 size_t i = 0;
118 char *const *p = ARGVSTR2ARGV(argv_str);
119 while (p[i++])
120 ;
121 return i - 1;
122}
123
124#endif /* INTERNAL_PROCESS_H */
ruby.h
rb_execarg
Definition process.h:30
rb_process_status
Definition process.c:587
waitpid_state
Definition process.c:1151
VALUE
uintptr_t VALUE
Type that represents a Ruby object.
Definition value.h:40