docs: Fix small errors in TOSHARG-Compiling
[Samba.git] / lib / util / util_runcmd.c
blobbc5cc10a8bcd004a26c1a07a186fec4830c387f1
1 /*
2 Unix SMB/CIFS mplementation.
4 run a child command
6 Copyright (C) Andrew Tridgell 2010
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 this runs a child command with stdout and stderr going to the Samba
25 log
28 #include "includes.h"
29 #include "system/filesys.h"
30 #include <tevent.h>
31 #include "../lib/util/tevent_unix.h"
33 struct samba_runcmd_state {
34 int stdout_log_level;
35 int stderr_log_level;
36 struct tevent_fd *fde_stdout;
37 struct tevent_fd *fde_stderr;
38 int fd_stdin, fd_stdout, fd_stderr;
39 char *arg0;
40 pid_t pid;
41 char buf[1024];
42 uint16_t buf_used;
45 static int samba_runcmd_state_destructor(struct samba_runcmd_state *state)
47 if (state->pid > 0) {
48 kill(state->pid, SIGKILL);
49 waitpid(state->pid, NULL, 0);
50 state->pid = -1;
53 if (state->fd_stdin != -1) {
54 close(state->fd_stdin);
56 return 0;
59 static void samba_runcmd_io_handler(struct tevent_context *ev,
60 struct tevent_fd *fde,
61 uint16_t flags,
62 void *private_data);
65 run a command as a child process, with a timeout.
67 any stdout/stderr from the child will appear in the Samba logs with
68 the specified log levels
70 struct tevent_req *samba_runcmd_send(TALLOC_CTX *mem_ctx,
71 struct tevent_context *ev,
72 struct timeval endtime,
73 int stdout_log_level,
74 int stderr_log_level,
75 const char * const *argv0, ...)
77 struct tevent_req *req;
78 struct samba_runcmd_state *state;
79 int p1[2], p2[2], p3[2];
80 char **argv;
81 va_list ap;
83 req = tevent_req_create(mem_ctx, &state,
84 struct samba_runcmd_state);
85 if (req == NULL) {
86 return NULL;
89 state->stdout_log_level = stdout_log_level;
90 state->stderr_log_level = stderr_log_level;
91 state->fd_stdin = -1;
93 state->arg0 = talloc_strdup(state, argv0[0]);
94 if (tevent_req_nomem(state->arg0, req)) {
95 return tevent_req_post(req, ev);
98 if (pipe(p1) != 0) {
99 tevent_req_error(req, errno);
100 return tevent_req_post(req, ev);
102 if (pipe(p2) != 0) {
103 close(p1[0]);
104 close(p1[1]);
105 tevent_req_error(req, errno);
106 return tevent_req_post(req, ev);
108 if (pipe(p3) != 0) {
109 close(p1[0]);
110 close(p1[1]);
111 close(p2[0]);
112 close(p2[1]);
113 tevent_req_error(req, errno);
114 return tevent_req_post(req, ev);
117 state->pid = fork();
118 if (state->pid == (pid_t)-1) {
119 close(p1[0]);
120 close(p1[1]);
121 close(p2[0]);
122 close(p2[1]);
123 close(p3[0]);
124 close(p3[1]);
125 tevent_req_error(req, errno);
126 return tevent_req_post(req, ev);
129 if (state->pid != 0) {
130 /* the parent */
131 close(p1[1]);
132 close(p2[1]);
133 close(p3[0]);
134 state->fd_stdout = p1[0];
135 state->fd_stderr = p2[0];
136 state->fd_stdin = p3[1];
138 set_blocking(state->fd_stdout, false);
139 set_blocking(state->fd_stderr, false);
140 set_blocking(state->fd_stdin, false);
142 smb_set_close_on_exec(state->fd_stdin);
143 smb_set_close_on_exec(state->fd_stdout);
144 smb_set_close_on_exec(state->fd_stderr);
146 talloc_set_destructor(state, samba_runcmd_state_destructor);
148 state->fde_stdout = tevent_add_fd(ev, state,
149 state->fd_stdout,
150 TEVENT_FD_READ,
151 samba_runcmd_io_handler,
152 req);
153 if (tevent_req_nomem(state->fde_stdout, req)) {
154 close(state->fd_stdout);
155 close(state->fd_stderr);
156 return tevent_req_post(req, ev);
158 tevent_fd_set_auto_close(state->fde_stdout);
160 state->fde_stderr = tevent_add_fd(ev, state,
161 state->fd_stderr,
162 TEVENT_FD_READ,
163 samba_runcmd_io_handler,
164 req);
165 if (tevent_req_nomem(state->fde_stdout, req)) {
166 close(state->fd_stderr);
167 return tevent_req_post(req, ev);
169 tevent_fd_set_auto_close(state->fde_stderr);
171 if (!timeval_is_zero(&endtime)) {
172 tevent_req_set_endtime(req, ev, endtime);
175 return req;
178 /* the child */
179 close(p1[0]);
180 close(p2[0]);
181 close(p3[1]);
182 close(0);
183 close(1);
184 close(2);
186 /* we want to ensure that all of the network sockets we had
187 open are closed */
188 tevent_re_initialise(ev);
190 /* setup for logging to go to the parents debug log */
191 dup2(p3[0], 0);
192 dup2(p1[1], 1);
193 dup2(p2[1], 2);
195 close(p1[1]);
196 close(p2[1]);
197 close(p3[0]);
199 argv = str_list_copy(state, discard_const_p(const char *, argv0));
200 if (!argv) {
201 fprintf(stderr, "Out of memory in child\n");
202 _exit(255);
205 va_start(ap, argv0);
206 while (1) {
207 char *arg = va_arg(ap, char *);
208 if (arg == NULL) break;
209 argv = discard_const_p(char *, str_list_add((const char **)argv, arg));
210 if (!argv) {
211 fprintf(stderr, "Out of memory in child\n");
212 _exit(255);
215 va_end(ap);
217 (void)execvp(state->arg0, argv);
218 fprintf(stderr, "Failed to exec child - %s\n", strerror(errno));
219 _exit(255);
220 return NULL;
224 handle stdout/stderr from the child
226 static void samba_runcmd_io_handler(struct tevent_context *ev,
227 struct tevent_fd *fde,
228 uint16_t flags,
229 void *private_data)
231 struct tevent_req *req = talloc_get_type_abort(private_data,
232 struct tevent_req);
233 struct samba_runcmd_state *state = tevent_req_data(req,
234 struct samba_runcmd_state);
235 int level;
236 char *p;
237 int n, fd;
239 if (fde == state->fde_stdout) {
240 level = state->stdout_log_level;
241 fd = state->fd_stdout;
242 } else if (fde == state->fde_stderr) {
243 level = state->stderr_log_level;
244 fd = state->fd_stderr;
245 } else {
246 return;
249 if (!(flags & TEVENT_FD_READ)) {
250 return;
253 n = read(fd, &state->buf[state->buf_used],
254 sizeof(state->buf) - state->buf_used);
255 if (n > 0) {
256 state->buf_used += n;
257 } else if (n == 0) {
258 if (fde == state->fde_stdout) {
259 talloc_free(fde);
260 state->fde_stdout = NULL;
262 if (fde == state->fde_stderr) {
263 talloc_free(fde);
264 state->fde_stderr = NULL;
266 if (state->fde_stdout == NULL &&
267 state->fde_stderr == NULL) {
268 int status;
269 /* the child has closed both stdout and
270 * stderr, assume its dead */
271 pid_t pid = waitpid(state->pid, &status, 0);
272 if (pid != state->pid) {
273 if (errno == ECHILD) {
274 /* this happens when the
275 parent has set SIGCHLD to
276 SIG_IGN. In that case we
277 can only get error
278 information for the child
279 via its logging. We should
280 stop using SIG_IGN on
281 SIGCHLD in the standard
282 process model.
284 tevent_req_done(req);
285 return;
287 DEBUG(0,("Error in waitpid() for child %s - %s \n",
288 state->arg0, strerror(errno)));
289 if (errno == 0) {
290 errno = ECHILD;
292 tevent_req_error(req, errno);
293 return;
295 status = WEXITSTATUS(status);
296 DEBUG(3,("Child %s exited with status %d - %s\n",
297 state->arg0, status, strerror(status)));
298 if (status != 0) {
299 tevent_req_error(req, status);
300 return;
303 tevent_req_done(req);
304 return;
306 return;
309 while (state->buf_used > 0 &&
310 (p = (char *)memchr(state->buf, '\n', state->buf_used)) != NULL) {
311 int n1 = (p - state->buf)+1;
312 int n2 = n1 - 1;
313 /* swallow \r from child processes */
314 if (n2 > 0 && state->buf[n2-1] == '\r') {
315 n2--;
317 DEBUG(level,("%s: %*.*s\n", state->arg0, n2, n2, state->buf));
318 memmove(state->buf, p+1, sizeof(state->buf) - n1);
319 state->buf_used -= n1;
322 /* the buffer could have completely filled - unfortunately we have
323 no choice but to dump it out straight away */
324 if (state->buf_used == sizeof(state->buf)) {
325 DEBUG(level,("%s: %*.*s\n",
326 state->arg0, state->buf_used,
327 state->buf_used, state->buf));
328 state->buf_used = 0;
332 int samba_runcmd_recv(struct tevent_req *req, int *perrno)
334 if (tevent_req_is_unix_error(req, perrno)) {
335 tevent_req_received(req);
336 return -1;
339 tevent_req_received(req);
340 return 0;