src/job.h

   1 /* Definitions for managing subprocesses in GNU Make.
   2 Copyright (C) 1992-2022 Free Software Foundation, Inc.
   3 This file is part of GNU Make.
   4
   5 GNU Make is free software; you can redistribute it and/or modify it under the
   6 terms of the GNU General Public License as published by the Free Software
   7 Foundation; either version 3 of the License, or (at your option) any later
   8 version.
   9
  10 GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
  11 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  12 A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  13
  14 You should have received a copy of the GNU General Public License along with
  15 this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 #include "output.h"
  18
  19 /* Structure describing a running or dead child process.  */
  20
  21 #ifdef VMS
  22 #define VMSCHILD                                                        \
  23     char *comname;              /* Temporary command file name */       \
  24     int efn;                    /* Completion event flag number */      \
  25     int cstatus;                /* Completion status */                 \
  26     int vms_launch_status;      /* non-zero if lib$spawn, etc failed */
  27 #else
  28 #define VMSCHILD
  29 #endif
  30
  31 #define CHILDBASE                                               \
  32     char *cmd_name;       /* Allocated copy of command run.  */ \
  33     char **environment;   /* Environment for commands. */       \
  34     VMSCHILD                                                    \
  35     struct output output  /* Output for this child.  */
  36
  37
  38 struct childbase
  39   {
  40     CHILDBASE;
  41   };
  42
  43 struct child
  44   {
  45     CHILDBASE;
  46
  47     struct child *next;         /* Link in the chain.  */
  48
  49     struct file *file;          /* File being remade.  */
  50
  51     char *sh_batch_file;        /* Script file for shell commands */
  52     char **command_lines;       /* Array of variable-expanded cmd lines.  */
  53     char *command_ptr;          /* Ptr into command_lines[command_line].  */
  54
  55     unsigned int  command_line; /* Index into command_lines.  */
  56
  57     pid_t pid;                  /* Child process's ID number.  */
  58
  59     unsigned int  remote:1;     /* Nonzero if executing remotely.  */
  60     unsigned int  noerror:1;    /* Nonzero if commands contained a '-'.  */
  61     unsigned int  good_stdin:1; /* Nonzero if this child has a good stdin.  */
  62     unsigned int  deleted:1;    /* Nonzero if targets have been deleted.  */
  63     unsigned int  recursive:1;  /* Nonzero for recursive command ('+' etc.)  */
  64     unsigned int  jobslot:1;    /* Nonzero if it's reserved a job slot.  */
  65     unsigned int  dontcare:1;   /* Saved dontcare flag.  */
  66   };
  67
  68 extern struct child *children;
  69
  70 /* A signal handler for SIGCHLD, if needed.  */
  71 void child_handler (int sig);
  72 int is_bourne_compatible_shell(const char *path);
  73 void new_job (struct file *file);
  74 void reap_children (int block, int err);
  75 void start_waiting_jobs (void);
  76 void free_childbase (struct childbase* child);
  77
  78 char **construct_command_argv (char *line, char **restp, struct file *file,
  79                                int cmd_flags, char** batch_file);
  80
  81 pid_t child_execute_job (struct childbase *child, int good_stdin, char **argv);
  82
  83 #ifdef _AMIGA
  84 void exec_command (char **argv) NORETURN;
  85 #else
  86 pid_t exec_command (char **argv, char **envp);
  87 #endif
  88
  89 void unblock_all_sigs (void);
  90
  91 extern unsigned int job_slots_used;
  92 extern unsigned int jobserver_tokens;