mirror of
https://github.com/mirror/make.git
synced 2025-03-15 04:10:35 +08:00
f6ea899d83
The next version of the POSIX standard defines parallel execution and requires the .WAIT special target as is implemented in some other versions of make. This implementation behaves similarly to others in that it does not create a relationship between targets in the dependency graph, so that the same two targets may be run in parallel if they appear as prerequisites elsewhere without .WAIT between them. Now that we support .WAIT it's trivial to also support prerequisites of the .NOTPARALLEL special target, which forces the prerequisites of those targets to be run serially (as if .WAIT was specified between each one). * NEWS: Announce the new .WAIT and .NOTPARALLEL support. * doc/make.texi (Parallel Disable): A new section to discuss ways in which parallel execution can be controlled. Modify cross-refs to refer to this section. * src/dep.h (struct dep): Add a new wait_here boolean. (parse_file_seq): Add PARSEFS_WAIT to check for .WAIT dependencies. * src/file.c (split_prereqs): Use PARSEFS_WAIT. (snap_deps): If .NOTPARALLEL has prerequisites, set .WAIT between each of _their_ prerequisites. (print_prereqs): Add back in .WAIT when printing prerequisites. * src/implicit.c (struct patdeps): Preserve wait_here. (pattern_search): Ditto. Use PARSEFS_WAIT when parsing prereqs for pattern rule expansion. * src/read.c (check_specials): Don't give up early: remembering to update these options is not worth the rare speedup. (check_special_file): If .WAIT is given as a target show an error-- once--if it has prereqs or commands. (record_files): Call check_special_file on each target. (parse_file_seq): If PARSEFS_WAIT is given, look for .WAIT prereqs. If we see one assume that we are building a struct dep chain and set the wait_here option while not putting it into the list. * src/remake.c (update_file_1): If wait_here is set and we are still running, then stop trying to build this target's prerequisites. * src/rule.c (get_rule_defn): Add .WAIT to the prerequisite list. * src/shuffle.c (shuffle_deps): Don't shuffle the prerequisite list if .WAIT appears anywhere in it. * tests/scripts/targets/WAIT: Add a test suite for this feature.
141 lines
5.1 KiB
C
141 lines
5.1 KiB
C
/* Definitions of dependency data structures for GNU Make.
|
|
Copyright (C) 1988-2022 Free Software Foundation, Inc.
|
|
This file is part of GNU Make.
|
|
|
|
GNU Make is free software; you can redistribute it and/or modify it under the
|
|
terms of the GNU General Public License as published by the Free Software
|
|
Foundation; either version 3 of the License, or (at your option) any later
|
|
version.
|
|
|
|
GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along with
|
|
this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
|
|
/* Structure used in chains of names, for parsing and globbing. */
|
|
|
|
#define NAMESEQ(_t) \
|
|
_t *next; \
|
|
const char *name
|
|
|
|
struct nameseq
|
|
{
|
|
NAMESEQ (struct nameseq);
|
|
};
|
|
|
|
/* Flag bits for the second argument to 'read_makefile'.
|
|
These flags are saved in the 'flags' field of each
|
|
'struct goaldep' in the chain returned by 'read_all_makefiles'. */
|
|
|
|
#define RM_NOFLAG 0
|
|
#define RM_NO_DEFAULT_GOAL (1 << 0) /* Do not set default goal. */
|
|
#define RM_INCLUDED (1 << 1) /* Search makefile search path. */
|
|
#define RM_DONTCARE (1 << 2) /* No error if it doesn't exist. */
|
|
#define RM_NO_TILDE (1 << 3) /* Don't expand ~ in file name. */
|
|
|
|
/* Structure representing one dependency of a file.
|
|
Each struct file's 'deps' points to a chain of these, through 'next'.
|
|
'stem' is the stem for this dep line of static pattern rule or NULL.
|
|
explicit is set when implicit rule search is performed and the prerequisite
|
|
does not contain %. When explicit is set the file is not intermediate. */
|
|
|
|
|
|
#define DEP(_t) \
|
|
NAMESEQ (_t); \
|
|
struct file *file; \
|
|
_t *shuf; \
|
|
const char *stem; \
|
|
unsigned int flags : 8; \
|
|
unsigned int changed : 1; \
|
|
unsigned int ignore_mtime : 1; \
|
|
unsigned int staticpattern : 1; \
|
|
unsigned int need_2nd_expansion : 1; \
|
|
unsigned int ignore_automatic_vars : 1; \
|
|
unsigned int is_explicit : 1; \
|
|
unsigned int wait_here : 1
|
|
|
|
struct dep
|
|
{
|
|
DEP (struct dep);
|
|
};
|
|
|
|
/* Structure representing one goal.
|
|
The goals to be built constitute a chain of these, chained through 'next'.
|
|
'stem' is not used, but it's simpler to include and ignore it. */
|
|
|
|
struct goaldep
|
|
{
|
|
DEP (struct goaldep);
|
|
int error;
|
|
floc floc;
|
|
};
|
|
|
|
/* Options for parsing lists of filenames. */
|
|
|
|
#define PARSEFS_NONE 0x0000
|
|
#define PARSEFS_NOSTRIP 0x0001
|
|
#define PARSEFS_NOAR 0x0002
|
|
#define PARSEFS_NOGLOB 0x0004
|
|
#define PARSEFS_EXISTS 0x0008
|
|
#define PARSEFS_NOCACHE 0x0010
|
|
#define PARSEFS_ONEWORD 0x0020
|
|
#define PARSEFS_WAIT 0x0040
|
|
|
|
#define PARSE_FILE_SEQ(_s,_t,_c,_p,_f) \
|
|
(_t *)parse_file_seq ((_s),sizeof (_t),(_c),(_p),(_f))
|
|
#define PARSE_SIMPLE_SEQ(_s,_t) \
|
|
(_t *)parse_file_seq ((_s),sizeof (_t),MAP_NUL,NULL,PARSEFS_NONE)
|
|
|
|
#ifdef VMS
|
|
void *parse_file_seq ();
|
|
#else
|
|
void *parse_file_seq (char **stringp, size_t size,
|
|
int stopmap, const char *prefix, int flags);
|
|
#endif
|
|
|
|
char *tilde_expand (const char *name);
|
|
|
|
#ifndef NO_ARCHIVES
|
|
struct nameseq *ar_glob (const char *arname, const char *member_pattern, size_t size);
|
|
#endif
|
|
|
|
#define dep_name(d) ((d)->name ? (d)->name : (d)->file->name)
|
|
|
|
#define alloc_seq_elt(_t) xcalloc (sizeof (_t))
|
|
void free_ns_chain (struct nameseq *n);
|
|
|
|
#if defined(MAKE_MAINTAINER_MODE) && defined(__GNUC__) && !defined(__STRICT_ANSI__)
|
|
/* Use inline to get real type-checking. */
|
|
#define SI static inline
|
|
SI struct nameseq *alloc_ns() { return alloc_seq_elt (struct nameseq); }
|
|
SI struct dep *alloc_dep() { return alloc_seq_elt (struct dep); }
|
|
SI struct goaldep *alloc_goaldep() { return alloc_seq_elt (struct goaldep); }
|
|
|
|
SI void free_ns(struct nameseq *n) { free (n); }
|
|
SI void free_dep(struct dep *d) { free_ns ((struct nameseq *)d); }
|
|
SI void free_goaldep(struct goaldep *g) { free_dep ((struct dep *)g); }
|
|
|
|
SI void free_dep_chain(struct dep *d) { free_ns_chain((struct nameseq *)d); }
|
|
SI void free_goal_chain(struct goaldep *g) { free_dep_chain((struct dep *)g); }
|
|
#else
|
|
# define alloc_ns() alloc_seq_elt (struct nameseq)
|
|
# define alloc_dep() alloc_seq_elt (struct dep)
|
|
# define alloc_goaldep() alloc_seq_elt (struct goaldep)
|
|
|
|
# define free_ns(_n) free (_n)
|
|
# define free_dep(_d) free_ns (_d)
|
|
# define free_goaldep(_g) free_dep (_g)
|
|
|
|
# define free_dep_chain(_d) free_ns_chain ((struct nameseq *)(_d))
|
|
# define free_goal_chain(_g) free_ns_chain ((struct nameseq *)(_g))
|
|
#endif
|
|
|
|
struct dep *copy_dep_chain (const struct dep *d);
|
|
|
|
struct goaldep *read_all_makefiles (const char **makefiles);
|
|
void eval_buffer (char *buffer, const floc *floc);
|
|
enum update_status update_goal_chain (struct goaldep *goals);
|