1 #ifndef _JOB_H_ 2 #define _JOB_H_ 3 4 /* $OpenBSD: job.h,v 1.38 2020/06/03 12:41:39 espie Exp $ */ 5 /* $NetBSD: job.h,v 1.5 1996/11/06 17:59:10 christos Exp $ */ 6 7 /* 8 * Copyright (c) 1988, 1989, 1990 The Regents of the University of California. 9 * Copyright (c) 1988, 1989 by Adam de Boor 10 * Copyright (c) 1989 by Berkeley Softworks 11 * All rights reserved. 12 * 13 * This code is derived from software contributed to Berkeley by 14 * Adam de Boor. 15 * 16 * Redistribution and use in source and binary forms, with or without 17 * modification, are permitted provided that the following conditions 18 * are met: 19 * 1. Redistributions of source code must retain the above copyright 20 * notice, this list of conditions and the following disclaimer. 21 * 2. Redistributions in binary form must reproduce the above copyright 22 * notice, this list of conditions and the following disclaimer in the 23 * documentation and/or other materials provided with the distribution. 24 * 3. Neither the name of the University nor the names of its contributors 25 * may be used to endorse or promote products derived from this software 26 * without specific prior written permission. 27 * 28 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 29 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 31 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 36 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 37 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 38 * SUCH DAMAGE. 39 * 40 * from: @(#)job.h 8.1 (Berkeley) 6/6/93 41 */ 42 43 /*- 44 * job.h -- 45 * Definitions pertaining to the running of jobs. 46 */ 47 48 /* Job_Make(gn); 49 * register a new job running commands associated with building gn. 50 */ 51 extern void Job_Make(GNode *); 52 /* Job_Init(maxproc); 53 * setup job handling framework 54 */ 55 extern void Job_Init(int); 56 57 /* save signal mask at start */ 58 extern void Sigset_Init(void); 59 60 /* interface with the normal build in make.c */ 61 /* okay = can_start_job(); 62 * can we run new jobs right now ? 63 */ 64 extern bool can_start_job(void); 65 66 /* finished = Job_Empty(); 67 * wait until all jobs are finished after we build everything. 68 */ 69 extern bool Job_Empty(void); 70 71 extern void Job_Wait(void); 72 extern void Job_AbortAll(void); 73 extern void print_errors(void); 74 75 /* handle_running_jobs(); 76 * wait until something happens, like a job finishing running a command 77 * or a signal coming in. 78 */ 79 extern void handle_running_jobs(void); 80 /* loop_handle_running_jobs(); 81 * handle running jobs until they're finished. 82 */ 83 extern void loop_handle_running_jobs(void); 84 extern void reset_signal_mask(void); 85 86 /* handle_all_signals(); 87 * if a signal was received, react accordingly. 88 * By displaying STATUS info, or by aborting running jobs for a fatal 89 * signals. Relies on Job_Init() for setting up handlers. 90 */ 91 extern void handle_all_signals(void); 92 93 extern void determine_expensive_job(Job *); 94 extern Job *runningJobs, *errorJobs, *availableJobs; 95 extern void debug_job_printf(const char *, ...); 96 extern void handle_one_job(Job *); 97 extern int check_dying_signal(void); 98 99 extern const char *basedirectory; 100 101 extern bool sequential; /* True if we are running one single-job */ 102 103 #endif /* _JOB_H_ */ 104