Changeset 51 in kBuild for trunk/src/kmk/job.h
- Timestamp:
- Apr 7, 2003 1:30:32 AM (22 years ago)
- File:
-
- 1 edited
-
trunk/src/kmk/job.h (modified) (8 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/kmk/job.h
r25 r51 18 18 * 3. All advertising materials mentioning features or use of this software 19 19 * must display the following acknowledgement: 20 * 21 * 20 * This product includes software developed by the University of 21 * California, Berkeley and its contributors. 22 22 * 4. Neither the name of the University nor the names of its contributors 23 23 * may be used to endorse or promote products derived from this software … … 36 36 * SUCH DAMAGE. 37 37 * 38 * from: @(#)job.h8.1 (Berkeley) 6/6/9338 * from: @(#)job.h 8.1 (Berkeley) 6/6/93 39 39 * $FreeBSD: src/usr.bin/make/job.h,v 1.11 2000/01/17 06:43:41 kris Exp $ 40 40 */ … … 42 42 /*- 43 43 * job.h -- 44 * 45 * 44 * Definitions pertaining to the running of jobs in parallel mode. 45 * Exported from job.c for the use of remote-execution modules. 46 46 */ 47 47 #ifndef _JOB_H_ 48 48 #define _JOB_H_ 49 49 50 #define TMPPAT 50 #define TMPPAT "/tmp/makeXXXXXXXXXX" 51 51 52 52 /* … … 55 55 * seconds and SEL_USEC is the number of micro-seconds 56 56 */ 57 #define SEL_SEC 58 #define SEL_USEC 57 #define SEL_SEC 0 58 #define SEL_USEC 100000 59 59 60 60 … … 64 64 * 65 65 * Each job has several things associated with it: 66 * 67 * 68 * 69 * 70 * 71 * 72 * 73 * 74 * 75 * 76 * 77 * 78 * 79 * 80 * 81 * 82 * 83 * 84 * 66 * 1) The process id of the child shell 67 * 2) The graph node describing the target being made by this job 68 * 3) A LstNode for the first command to be saved after the job 69 * completes. This is NILLNODE if there was no "..." in the job's 70 * commands. 71 * 4) An FILE* for writing out the commands. This is only 72 * used before the job is actually started. 73 * 5) A union of things used for handling the shell's output. Different 74 * parts of the union are used based on the value of the usePipes 75 * flag. If it is true, the output is being caught via a pipe and 76 * the descriptors of our pipe, an array in which output is line 77 * buffered and the current position in that buffer are all 78 * maintained for each job. If, on the other hand, usePipes is false, 79 * the output is routed to a temporary file and all that is kept 80 * is the name of the file and the descriptor open to the file. 81 * 6) An identifier provided by and for the exclusive use of the 82 * Rmt module. 83 * 7) A word of flags which determine how the module handles errors, 84 * echoing, etc. for the job 85 85 * 86 86 * The job "table" is kept as a linked Lst in 'jobs', with the number of … … 92 92 * traversal of the dependency graph. 93 93 */ 94 #define JOB_BUFSIZE 1024 94 #define JOB_BUFSIZE 1024 95 #define JOB_TMPFILESIZE 128 95 96 typedef struct Job { 96 int pid;/* The child's process ID */97 char tfile[sizeof(TMPPAT)];98 99 GNode 100 LstNode 101 102 FILE 103 104 int 105 short flags;/* Flags to control treatment of job */106 #define JOB_IGNERR 0x001/* Ignore non-zero exits */107 #define JOB_SILENT 0x002/* no output */108 #define JOB_SPECIAL 0x004/* Target is a special one. i.e. run it locally109 110 #define JOB_IGNDOTS 0x008/* Ignore "..." lines when processing111 112 #define JOB_REMOTE 0x010/* Job is running remotely */113 #define JOB_FIRST 0x020/* Job is first job for the node */114 #define JOB_REMIGRATE 0x040/* Job needs to be remigrated */115 #define JOB_RESTART 0x080/* Job needs to be completely restarted */116 #define JOB_RESUME 0x100/* Job needs to be resumed b/c it stopped,117 118 #define JOB_CONTINUING 0x200/* We are in the process of resuming this job.119 120 97 int pid; /* The child's process ID */ 98 char tfile[JOB_TMPFILESIZE]; 99 /* Temporary file to use for job */ 100 GNode *node; /* The target the child is making */ 101 LstNode tailCmds; /* The node of the first command to be 102 * saved when the job has been run */ 103 FILE *cmdFILE; /* When creating the shell script, this is 104 * where the commands go */ 105 int rmtID; /* ID returned from Rmt module */ 106 short flags; /* Flags to control treatment of job */ 107 #define JOB_IGNERR 0x001 /* Ignore non-zero exits */ 108 #define JOB_SILENT 0x002 /* no output */ 109 #define JOB_SPECIAL 0x004 /* Target is a special one. i.e. run it locally 110 * if we can't export it and maxLocal is 0 */ 111 #define JOB_IGNDOTS 0x008 /* Ignore "..." lines when processing 112 * commands */ 113 #define JOB_REMOTE 0x010 /* Job is running remotely */ 114 #define JOB_FIRST 0x020 /* Job is first job for the node */ 115 #define JOB_REMIGRATE 0x040 /* Job needs to be remigrated */ 116 #define JOB_RESTART 0x080 /* Job needs to be completely restarted */ 117 #define JOB_RESUME 0x100 /* Job needs to be resumed b/c it stopped, 118 * for some reason */ 119 #define JOB_CONTINUING 0x200 /* We are in the process of resuming this job. 120 * Used to avoid infinite recursion between 121 * JobFinish and JobRestart */ 121 122 union { 122 123 int op_inPipe;/* Input side of pipe associated124 125 int op_outPipe;/* Output side of pipe associated with126 127 charop_outBuf[JOB_BUFSIZE + 1];128 129 130 int op_curPos;/* Current position in op_outBuf */131 } o_pipe;/* data used when catching the output via132 133 134 char of_outFile[sizeof(TMPPAT)];135 136 137 int of_outFd;/* Stream open to the output138 139 140 141 142 } o_file;/* Data used when catching the output in143 144 } output;/* Data for tracking a shell's output */123 struct { 124 int op_inPipe; /* Input side of pipe associated 125 * with job's output channel */ 126 int op_outPipe; /* Output side of pipe associated with 127 * job's output channel */ 128 char op_outBuf[JOB_BUFSIZE + 1]; 129 /* Buffer for storing the output of the 130 * job, line by line */ 131 int op_curPos; /* Current position in op_outBuf */ 132 } o_pipe; /* data used when catching the output via 133 * a pipe */ 134 struct { 135 char of_outFile[JOB_TMPFILESIZE]; 136 /* Name of file to which shell output 137 * was rerouted */ 138 int of_outFd; /* Stream open to the output 139 * file. Used to funnel all 140 * from a single job to one file 141 * while still allowing 142 * multiple shell invocations */ 143 } o_file; /* Data used when catching the output in 144 * a temporary file */ 145 } output; /* Data for tracking a shell's output */ 145 146 } Job; 146 147 147 #define outPipe 148 #define inPipe 149 #define outBuf 150 #define curPos 151 #define outFile 152 #define outFd 148 #define outPipe output.o_pipe.op_outPipe 149 #define inPipe output.o_pipe.op_inPipe 150 #define outBuf output.o_pipe.op_outBuf 151 #define curPos output.o_pipe.op_curPos 152 #define outFile output.o_file.of_outFile 153 #define outFd output.o_file.of_outFd 153 154 154 155 … … 157 158 * Shell Specifications: 158 159 * Each shell type has associated with it the following information: 159 * 160 * 161 * 162 * 163 * 164 * 165 * 166 * 167 * 168 * 169 * 170 * 171 * 172 * 173 * 160 * 1) The string which must match the last character of the shell name 161 * for the shell to be considered of this type. The longest match 162 * wins. 163 * 2) A command to issue to turn off echoing of command lines 164 * 3) A command to issue to turn echoing back on again 165 * 4) What the shell prints, and its length, when given the echo-off 166 * command. This line will not be printed when received from the shell 167 * 5) A boolean to tell if the shell has the ability to control 168 * error checking for individual commands. 169 * 6) The string to turn this checking on. 170 * 7) The string to turn it off. 171 * 8) The command-flag to give to cause the shell to start echoing 172 * commands right away. 173 * 9) The command-flag to cause the shell to Lib_Exit when an error is 174 * detected in one of the commands. 174 175 * 175 176 * Some special stuff goes on if a shell doesn't have error control. In such … … 181 182 */ 182 183 typedef struct Shell { 183 char *name;/* the name of the shell. For Bourne and C184 185 186 187 188 189 Boolean hasEchoCtl;/* True if both echoOff and echoOn defined */190 char *echoOff; 191 char *echoOn; 192 char *noPrint; 193 194 195 int noPLen; 196 Boolean hasErrCtl;/* set if can control error checking for197 198 char *errCheck;/* string to turn error checking on */199 char *ignErr;/* string to turn off error checking */184 char *name; /* the name of the shell. For Bourne and C 185 * shells, this is used only to find the 186 * shell description when used as the single 187 * source of a .SHELL target. For user-defined 188 * shells, this is the full path of the shell. 189 */ 190 Boolean hasEchoCtl; /* True if both echoOff and echoOn defined */ 191 char *echoOff; /* command to turn off echo */ 192 char *echoOn; /* command to turn it back on again */ 193 char *noPrint; /* command to skip when printing output from 194 * shell. This is usually the command which 195 * was executed to turn off echoing */ 196 int noPLen; /* length of noPrint command */ 197 Boolean hasErrCtl; /* set if can control error checking for 198 * individual commands */ 199 char *errCheck; /* string to turn error checking on */ 200 char *ignErr; /* string to turn off error checking */ 200 201 /* 201 202 * command-line flags 202 203 */ 203 char *echo; 204 char *exit; 204 char *echo; /* echo commands */ 205 char *exit; /* exit on error */ 205 206 } Shell; 206 207 207 208 208 extern char *targFmt;/* Format string for banner that separates209 210 211 212 extern GNode *lastNode;/* Last node for which a banner was printed.213 214 215 216 extern int nJobs;/* Number of jobs running (local and remote) */217 extern int nLocal;/* Number of jobs running locally */218 extern Lst jobs;/* List of active job descriptors */219 extern Lst stoppedJobs;/* List of jobs that are stopped or didn't220 221 extern Boolean jobFull;/* Non-zero if no more jobs should/will start*/209 extern char *targFmt; /* Format string for banner that separates 210 * output from multiple jobs. Contains a 211 * single %s where the name of the node being 212 * made should be put. */ 213 extern GNode *lastNode; /* Last node for which a banner was printed. 214 * If Rmt module finds it necessary to print 215 * a banner, it should set this to the node 216 * for which the banner was printed */ 217 extern int nJobs; /* Number of jobs running (local and remote) */ 218 extern int nLocal; /* Number of jobs running locally */ 219 extern Lst jobs; /* List of active job descriptors */ 220 extern Lst stoppedJobs; /* List of jobs that are stopped or didn't 221 * quite get started */ 222 extern Boolean jobFull; /* Non-zero if no more jobs should/will start*/ 222 223 223 224
Note:
See TracChangeset
for help on using the changeset viewer.
