VirtualBox

source: kBuild/trunk/src/kmk/filedef.h@ 1729

Last change on this file since 1729 was 1701, checked in by bird, 16 years ago

kmk: Implemented secondary target expansion. Fixes #42.

  • Property svn:eol-style set to native
File size: 9.7 KB
Line 
1/* Definition of target file data structures for GNU Make.
2Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
31998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software
4Foundation, Inc.
5This file is part of GNU Make.
6
7GNU Make is free software; you can redistribute it and/or modify it under the
8terms of the GNU General Public License as published by the Free Software
9Foundation; either version 2, or (at your option) any later version.
10
11GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
12WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
13A PARTICULAR PURPOSE. See the GNU General Public License for more details.
14
15You should have received a copy of the GNU General Public License along with
16GNU Make; see the file COPYING. If not, write to the Free Software
17Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. */
18
19
20/* Structure that represents the info on one file
21 that the makefile says how to make.
22 All of these are chained together through `next'. */
23
24#include "hash.h"
25
26struct file
27 {
28 const char *name;
29 const char *hname; /* Hashed filename */
30 const char *vpath; /* VPATH/vpath pathname */
31 struct dep *deps; /* all dependencies, including duplicates */
32 struct commands *cmds; /* Commands to execute for this target. */
33 int command_flags; /* Flags OR'd in for cmds; see commands.h. */
34 const char *stem; /* Implicit stem, if an implicit
35 rule has been used */
36 struct dep *also_make; /* Targets that are made by making this. */
37 FILE_TIMESTAMP last_mtime; /* File's modtime, if already known. */
38 FILE_TIMESTAMP mtime_before_update; /* File's modtime before any updating
39 has been performed. */
40 struct file *prev; /* Previous entry for same file name;
41 used when there are multiple double-colon
42 entries for the same file. */
43 struct file *last; /* Last entry for the same file name. */
44
45 /* File that this file was renamed to. After any time that a
46 file could be renamed, call `check_renamed' (below). */
47 struct file *renamed;
48
49 /* List of variable sets used for this file. */
50 struct variable_set_list *variables;
51
52 /* Pattern-specific variable reference for this target, or null if there
53 isn't one. Also see the pat_searched flag, below. */
54 struct variable_set_list *pat_variables;
55
56 /* Immediate dependent that caused this target to be remade,
57 or nil if there isn't one. */
58 struct file *parent;
59
60 /* For a double-colon entry, this is the first double-colon entry for
61 the same file. Otherwise this is null. */
62 struct file *double_colon;
63
64#ifdef CONFIG_WITH_EXPLICIT_MULTITARGET
65 /* For a target of an explicit multi target rule, this points to the
66 primary target. Otherwise this is null. */
67 struct file *multi_head;
68 /* Pointer to next target of an explicit multi target rule. */
69 struct file *multi_next;
70#endif
71
72 short int update_status; /* Status of the last attempt to update,
73 or -1 if none has been made. */
74
75 enum cmd_state /* State of the commands. */
76 { /* Note: It is important that cs_not_started be zero. */
77 cs_not_started, /* Not yet started. */
78 cs_deps_running, /* Dep commands running. */
79 cs_running, /* Commands running. */
80 cs_finished /* Commands finished. */
81 } command_state ENUM_BITFIELD (2);
82
83 unsigned int precious:1; /* Non-0 means don't delete file on quit */
84 unsigned int low_resolution_time:1; /* Nonzero if this file's time stamp
85 has only one-second resolution. */
86 unsigned int tried_implicit:1; /* Nonzero if have searched
87 for implicit rule for making
88 this file; don't search again. */
89 unsigned int updating:1; /* Nonzero while updating deps of this file */
90 unsigned int updated:1; /* Nonzero if this file has been remade. */
91 unsigned int is_target:1; /* Nonzero if file is described as target. */
92 unsigned int cmd_target:1; /* Nonzero if file was given on cmd line. */
93 unsigned int phony:1; /* Nonzero if this is a phony file
94 i.e., a prerequisite of .PHONY. */
95 unsigned int intermediate:1;/* Nonzero if this is an intermediate file. */
96 unsigned int secondary:1; /* Nonzero means remove_intermediates should
97 not delete it. */
98 unsigned int dontcare:1; /* Nonzero if no complaint is to be made if
99 this target cannot be remade. */
100 unsigned int ignore_vpath:1;/* Nonzero if we threw out VPATH name. */
101 unsigned int pat_searched:1;/* Nonzero if we already searched for
102 pattern-specific variables. */
103 unsigned int considered:1; /* equal to 'considered' if file has been
104 considered on current scan of goal chain */
105#ifdef CONFIG_WITH_EXPLICIT_MULTITARGET
106 unsigned int multi_maybe:1; /* Nonzero if this file isn't always updated
107 by the explicit multi target rule. */
108#endif
109#ifdef CONFIG_WITH_2ND_TARGET_EXPANSION
110 unsigned int need_2nd_target_expansion:1; /* Nonzero if this file needs
111 second expansion of its name. Whether it
112 can receive this is decided at parse time,
113 and the expanding done in snap_deps. */
114#endif
115
116 };
117
118
119extern struct file *default_goal_file, *suffix_file, *default_file;
120extern char **default_goal_name;
121
122
123struct file *lookup_file (const char *name);
124struct file *enter_file (const char *name);
125struct dep *parse_prereqs (char *prereqs);
126void remove_intermediates (int sig);
127void snap_deps (void);
128void rename_file (struct file *file, const char *name);
129void rehash_file (struct file *file, const char *name);
130void set_command_state (struct file *file, enum cmd_state state);
131void notice_finished_file (struct file *file);
132void init_hash_files (void);
133char *build_target_list (char *old_list);
134
135#if FILE_TIMESTAMP_HI_RES
136# define FILE_TIMESTAMP_STAT_MODTIME(fname, st) \
137 file_timestamp_cons (fname, (st).st_mtime, (st).st_mtim.ST_MTIM_NSEC)
138#else
139# define FILE_TIMESTAMP_STAT_MODTIME(fname, st) \
140 file_timestamp_cons (fname, (st).st_mtime, 0)
141#endif
142
143/* If FILE_TIMESTAMP is 64 bits (or more), use nanosecond resolution.
144 (Multiply by 2**30 instead of by 10**9 to save time at the cost of
145 slightly decreasing the number of available timestamps.) With
146 64-bit FILE_TIMESTAMP, this stops working on 2514-05-30 01:53:04
147 UTC, but by then uintmax_t should be larger than 64 bits. */
148#define FILE_TIMESTAMPS_PER_S (FILE_TIMESTAMP_HI_RES ? 1000000000 : 1)
149#define FILE_TIMESTAMP_LO_BITS (FILE_TIMESTAMP_HI_RES ? 30 : 0)
150
151#define FILE_TIMESTAMP_S(ts) (((ts) - ORDINARY_MTIME_MIN) \
152 >> FILE_TIMESTAMP_LO_BITS)
153#define FILE_TIMESTAMP_NS(ts) ((int) (((ts) - ORDINARY_MTIME_MIN) \
154 & ((1 << FILE_TIMESTAMP_LO_BITS) - 1)))
155
156/* Upper bound on length of string "YYYY-MM-DD HH:MM:SS.NNNNNNNNN"
157 representing a file timestamp. The upper bound is not necessarily 19,
158 since the year might be less than -999 or greater than 9999.
159
160 Subtract one for the sign bit if in case file timestamps can be negative;
161 subtract FLOOR_LOG2_SECONDS_PER_YEAR to yield an upper bound on how many
162 file timestamp bits might affect the year;
163 302 / 1000 is log10 (2) rounded up;
164 add one for integer division truncation;
165 add one more for a minus sign if file timestamps can be negative;
166 add 4 to allow for any 4-digit epoch year (e.g. 1970);
167 add 25 to allow for "-MM-DD HH:MM:SS.NNNNNNNNN". */
168#define FLOOR_LOG2_SECONDS_PER_YEAR 24
169#define FILE_TIMESTAMP_PRINT_LEN_BOUND \
170 (((sizeof (FILE_TIMESTAMP) * CHAR_BIT - 1 - FLOOR_LOG2_SECONDS_PER_YEAR) \
171 * 302 / 1000) \
172 + 1 + 1 + 4 + 25)
173
174FILE_TIMESTAMP file_timestamp_cons (char const *, time_t, int);
175FILE_TIMESTAMP file_timestamp_now (int *);
176void file_timestamp_sprintf (char *p, FILE_TIMESTAMP ts);
177
178/* Return the mtime of file F (a struct file *), caching it.
179 The value is NONEXISTENT_MTIME if the file does not exist. */
180#define file_mtime(f) file_mtime_1 ((f), 1)
181/* Return the mtime of file F (a struct file *), caching it.
182 Don't search using vpath for the file--if it doesn't actually exist,
183 we don't find it.
184 The value is NONEXISTENT_MTIME if the file does not exist. */
185#define file_mtime_no_search(f) file_mtime_1 ((f), 0)
186FILE_TIMESTAMP f_mtime (struct file *file, int search);
187#define file_mtime_1(f, v) \
188 ((f)->last_mtime == UNKNOWN_MTIME ? f_mtime ((f), v) : (f)->last_mtime)
189
190/* Special timestamp values. */
191
192/* The file's timestamp is not yet known. */
193#define UNKNOWN_MTIME 0
194
195/* The file does not exist. */
196#define NONEXISTENT_MTIME 1
197
198/* The file does not exist, and we assume that it is older than any
199 actual file. */
200#define OLD_MTIME 2
201
202/* The smallest and largest ordinary timestamps. */
203#define ORDINARY_MTIME_MIN (OLD_MTIME + 1)
204#define ORDINARY_MTIME_MAX ((FILE_TIMESTAMP_S (NEW_MTIME) \
205 << FILE_TIMESTAMP_LO_BITS) \
206 + ORDINARY_MTIME_MIN + (FILE_TIMESTAMPS_PER_S - 1)) /* bird: MSC overflow fix */
207
208/* Modtime value to use for `infinitely new'. We used to get the current time
209 from the system and use that whenever we wanted `new'. But that causes
210 trouble when the machine running make and the machine holding a file have
211 different ideas about what time it is; and can also lose for `force'
212 targets, which need to be considered newer than anything that depends on
213 them, even if said dependents' modtimes are in the future. */
214#define NEW_MTIME INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP)
215
216#define check_renamed(file) \
217 while ((file)->renamed != 0) (file) = (file)->renamed /* No ; here. */
218
219/* Have we snapped deps yet? */
220extern int snapped_deps;
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette