1 /* Common code for executing a program in a sub-process.
2 Copyright (C) 2005 Free Software Foundation, Inc.
3 Written by Ian Lance Taylor <ian@airs.com>.
5 This file is part of the libiberty library.
6 Libiberty is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Library General Public
8 License as published by the Free Software Foundation; either
9 version 2 of the License, or (at your option) any later version.
11 Libiberty is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Library General Public License for more details.
16 You should have received a copy of the GNU Library General Public
17 License along with libiberty; see the file COPYING.LIB. If not,
18 write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
19 Boston, MA 02110-1301, USA. */
22 #include "libiberty.h"
23 #include "pex-common.h"
27 #ifdef NEED_DECLARATION_ERRNO
40 extern int mkstemps (char *, int);
42 /* This file contains subroutines for the program execution routines
43 (pex_init, pex_run, etc.). This file is compiled on all
46 static void pex_add_remove (struct pex_obj *, const char *, int);
47 static int pex_get_status_and_time (struct pex_obj *, int, const char **,
50 /* Initialize a pex_obj structure. */
53 pex_init_common (int flags, const char *pname, const char *tempbase,
54 const struct pex_funcs *funcs)
58 obj = XNEW (struct pex_obj);
61 obj->tempbase = tempbase;
62 obj->next_input = STDIN_FILE_NO;
63 obj->next_input_name = NULL;
64 obj->next_input_name_allocated = 0;
69 obj->number_waited = 0;
70 obj->input_file = NULL;
71 obj->read_output = NULL;
72 obj->remove_count = 0;
79 /* Add a file to be removed when we are done. */
82 pex_add_remove (struct pex_obj *obj, const char *name, int allocated)
87 obj->remove = XRESIZEVEC (char *, obj->remove, obj->remove_count);
92 obj->remove[obj->remove_count - 1] = add;
95 /* Generate a temporary file name based on OBJ, FLAGS, and NAME.
96 Return NULL if we were unable to reserve a temporary filename.
98 If non-NULL, the result is either allocated with malloc, or the
99 same pointer as NAME. */
101 temp_file (struct pex_obj *obj, int flags, char *name)
105 if (obj->tempbase == NULL)
107 name = make_temp_file (NULL);
111 int len = strlen (obj->tempbase);
115 && strcmp (obj->tempbase + len - 6, "XXXXXX") == 0)
116 name = xstrdup (obj->tempbase);
118 name = concat (obj->tempbase, "XXXXXX", NULL);
120 out = mkstemps (name, 0);
127 /* This isn't obj->funcs->close because we got the
128 descriptor from mkstemps, not from a function in
129 obj->funcs. Calling close here is just like what
130 make_temp_file does. */
134 else if ((flags & PEX_SUFFIX) != 0)
136 if (obj->tempbase == NULL)
137 name = make_temp_file (name);
139 name = concat (obj->tempbase, name, NULL);
146 /* As for pex_run (), but permits the environment for the child process
150 pex_run_in_environment (struct pex_obj *obj, int flags, const char *executable,
151 char * const * argv, char * const * env,
152 const char *orig_outname, const char *errname,
158 int outname_allocated;
166 outname = (char *) orig_outname;
167 outname_allocated = 0;
169 /* If the user called pex_input_file, close the file now. */
172 if (fclose (obj->input_file) == EOF)
174 errmsg = "closing pipeline input file";
177 obj->input_file = NULL;
182 if (obj->next_input_name != NULL)
184 /* We have to make sure that the previous process has completed
185 before we try to read the file. */
186 if (!pex_get_status_and_time (obj, 0, &errmsg, err))
189 in = obj->funcs->open_read (obj, obj->next_input_name,
190 (flags & PEX_BINARY_INPUT) != 0);
194 errmsg = "open temporary file";
197 if (obj->next_input_name_allocated)
199 free (obj->next_input_name);
200 obj->next_input_name_allocated = 0;
202 obj->next_input_name = NULL;
206 in = obj->next_input;
210 errmsg = "pipeline already complete";
215 /* Set OUT and OBJ->NEXT_INPUT/OBJ->NEXT_INPUT_NAME. */
217 if ((flags & PEX_LAST) != 0)
220 out = STDOUT_FILE_NO;
221 else if ((flags & PEX_SUFFIX) != 0)
223 outname = concat (obj->tempbase, outname, NULL);
224 outname_allocated = 1;
226 obj->next_input = -1;
228 else if ((obj->flags & PEX_USE_PIPES) == 0)
230 outname = temp_file (obj, flags, outname);
234 errmsg = "could not create temporary file";
238 if (outname != orig_outname)
239 outname_allocated = 1;
241 if ((obj->flags & PEX_SAVE_TEMPS) == 0)
243 pex_add_remove (obj, outname, outname_allocated);
244 outname_allocated = 0;
247 /* Hand off ownership of outname to the next stage. */
248 obj->next_input_name = outname;
249 obj->next_input_name_allocated = outname_allocated;
250 outname_allocated = 0;
254 if (obj->funcs->pipe (obj, p, (flags & PEX_BINARY_OUTPUT) != 0) < 0)
262 obj->next_input = p[READ_PORT];
267 out = obj->funcs->open_write (obj, outname,
268 (flags & PEX_BINARY_OUTPUT) != 0);
272 errmsg = "open temporary output file";
277 if (outname_allocated)
280 outname_allocated = 0;
286 errdes = STDERR_FILE_NO;
289 /* We assume that stderr is in text mode--it certainly shouldn't
290 be controlled by PEX_BINARY_OUTPUT. If necessary, we can add
291 a PEX_BINARY_STDERR flag. */
292 errdes = obj->funcs->open_write (obj, errname, 0);
296 errmsg = "open error file";
301 /* If we are using pipes, the child process has to close the next
304 if ((obj->flags & PEX_USE_PIPES) == 0)
307 toclose = obj->next_input;
309 /* Run the program. */
311 pid = obj->funcs->exec_child (obj, flags, executable, argv, env,
312 in, out, errdes, toclose, &errmsg, err);
317 obj->children = XRESIZEVEC (long, obj->children, obj->count);
318 obj->children[obj->count - 1] = pid;
323 if (in >= 0 && in != STDIN_FILE_NO)
324 obj->funcs->close (obj, in);
325 if (out >= 0 && out != STDOUT_FILE_NO)
326 obj->funcs->close (obj, out);
327 if (errdes >= 0 && errdes != STDERR_FILE_NO)
328 obj->funcs->close (obj, errdes);
329 if (outname_allocated)
337 pex_run (struct pex_obj *obj, int flags, const char *executable,
338 char * const * argv, const char *orig_outname, const char *errname,
341 return pex_run_in_environment (obj, flags, executable, argv, NULL,
342 orig_outname, errname, err);
345 /* Return a FILE pointer for a temporary file to fill with input for
348 pex_input_file (struct pex_obj *obj, int flags, const char *in_name)
350 char *name = (char *) in_name;
353 /* This must be called before the first pipeline stage is run, and
354 there must not have been any other input selected. */
356 || (obj->next_input >= 0 && obj->next_input != STDIN_FILE_NO)
357 || obj->next_input_name)
363 name = temp_file (obj, flags, name);
367 f = fopen (name, (flags & PEX_BINARY_OUTPUT) ? "wb" : "w");
375 obj->next_input_name = name;
376 obj->next_input_name_allocated = (name != in_name);
381 /* Return a stream for a pipe connected to the standard input of the
382 first stage of the pipeline. */
384 pex_input_pipe (struct pex_obj *obj, int binary)
389 /* You must call pex_input_pipe before the first pex_run or pex_one. */
393 /* You must be using pipes. Implementations that don't support
394 pipes clear this flag before calling pex_init_common. */
395 if (! (obj->flags & PEX_USE_PIPES))
398 /* If we have somehow already selected other input, that's a
400 if ((obj->next_input >= 0 && obj->next_input != STDIN_FILE_NO)
401 || obj->next_input_name)
404 if (obj->funcs->pipe (obj, p, binary != 0) < 0)
407 f = obj->funcs->fdopenw (obj, p[WRITE_PORT], binary != 0);
410 int saved_errno = errno;
411 obj->funcs->close (obj, p[READ_PORT]);
412 obj->funcs->close (obj, p[WRITE_PORT]);
417 obj->next_input = p[READ_PORT];
426 /* Return a FILE pointer for the output of the last program
430 pex_read_output (struct pex_obj *obj, int binary)
432 if (obj->next_input_name != NULL)
437 /* We have to make sure that the process has completed before we
438 try to read the file. */
439 if (!pex_get_status_and_time (obj, 0, &errmsg, &err))
445 obj->read_output = fopen (obj->next_input_name, binary ? "rb" : "r");
447 if (obj->next_input_name_allocated)
449 free (obj->next_input_name);
450 obj->next_input_name_allocated = 0;
452 obj->next_input_name = NULL;
459 if (o < 0 || o == STDIN_FILE_NO)
461 obj->read_output = obj->funcs->fdopenr (obj, o, binary);
462 obj->next_input = -1;
465 return obj->read_output;
468 /* Get the exit status and, if requested, the resource time for all
469 the child processes. Return 0 on failure, 1 on success. */
472 pex_get_status_and_time (struct pex_obj *obj, int done, const char **errmsg,
478 if (obj->number_waited == obj->count)
481 obj->status = XRESIZEVEC (int, obj->status, obj->count);
482 if ((obj->flags & PEX_RECORD_TIMES) != 0)
483 obj->time = XRESIZEVEC (struct pex_time, obj->time, obj->count);
486 for (i = obj->number_waited; i < obj->count; ++i)
488 if (obj->funcs->wait (obj, obj->children[i], &obj->status[i],
489 obj->time == NULL ? NULL : &obj->time[i],
490 done, errmsg, err) < 0)
493 obj->number_waited = i;
498 /* Get exit status of executed programs. */
501 pex_get_status (struct pex_obj *obj, int count, int *vector)
503 if (obj->status == NULL)
508 if (!pex_get_status_and_time (obj, 0, &errmsg, &err))
512 if (count > obj->count)
514 memset (vector + obj->count, 0, (count - obj->count) * sizeof (int));
518 memcpy (vector, obj->status, count * sizeof (int));
523 /* Get process times of executed programs. */
526 pex_get_times (struct pex_obj *obj, int count, struct pex_time *vector)
528 if (obj->status == NULL)
533 if (!pex_get_status_and_time (obj, 0, &errmsg, &err))
537 if (obj->time == NULL)
540 if (count > obj->count)
542 memset (vector + obj->count, 0,
543 (count - obj->count) * sizeof (struct pex_time));
547 memcpy (vector, obj->time, count * sizeof (struct pex_time));
552 /* Free a pex_obj structure. */
555 pex_free (struct pex_obj *obj)
557 if (obj->next_input >= 0 && obj->next_input != STDIN_FILE_NO)
558 obj->funcs->close (obj, obj->next_input);
560 /* If the caller forgot to wait for the children, we do it here, to
562 if (obj->status == NULL)
567 obj->flags &= ~ PEX_RECORD_TIMES;
568 pex_get_status_and_time (obj, 1, &errmsg, &err);
571 if (obj->next_input_name_allocated)
572 free (obj->next_input_name);
573 if (obj->children != NULL)
574 free (obj->children);
575 if (obj->status != NULL)
577 if (obj->time != NULL)
579 if (obj->read_output != NULL)
580 fclose (obj->read_output);
582 if (obj->remove_count > 0)
586 for (i = 0; i < obj->remove_count; ++i)
588 remove (obj->remove[i]);
589 free (obj->remove[i]);
594 if (obj->funcs->cleanup != NULL)
595 obj->funcs->cleanup (obj);