1 /* Definition of target file data structures for GNU Make.
2 Copyright (C) 1988,89,90,91,92,93,94,97 Free Software Foundation, Inc.
3 This file is part of GNU Make.
5 GNU Make is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2, or (at your option)
10 GNU Make is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNU Make; see the file COPYING. If not, write to
17 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA. */
21 /* Structure that represents the info on one file
22 that the makefile says how to make.
23 All of these are chained together through `next'. */
29 char *hname
; /* Hashed filename */
30 char *vpath
; /* VPATH/vpath pathname */
32 struct commands
*cmds
; /* Commands to execute for this target. */
33 int command_flags
; /* Flags OR'd in for cmds; see commands.h. */
34 char *stem
; /* Implicit stem, if an implicit
36 struct dep
*also_make
; /* Targets that are made by making this. */
37 FILE_TIMESTAMP last_mtime
; /* File's modtime, if already known. */
38 struct file
*prev
; /* Previous entry for same file name;
39 used when there are multiple double-colon
40 entries for the same file. */
42 /* File that this file was renamed to. After any time that a
43 file could be renamed, call `check_renamed' (below). */
46 /* List of variable sets used for this file. */
47 struct variable_set_list
*variables
;
49 /* Immediate dependent that caused this target to be remade,
50 or nil if there isn't one. */
53 /* For a double-colon entry, this is the first double-colon entry for
54 the same file. Otherwise this is null. */
55 struct file
*double_colon
;
57 /* Pattern-specific variable reference for this target, or null if there
58 isn't one. Also see the pat_searched flag, below. */
59 struct pattern_var
*patvar
;
61 short int update_status
; /* Status of the last attempt to update,
62 or -1 if none has been made. */
64 enum /* State of the commands. */
65 { /* Note: It is important that cs_not_started be zero. */
66 cs_not_started
, /* Not yet started. */
67 cs_deps_running
, /* Dep commands running. */
68 cs_running
, /* Commands running. */
69 cs_finished
/* Commands finished. */
70 } command_state
ENUM_BITFIELD (2);
72 unsigned int precious
:1; /* Non-0 means don't delete file on quit */
73 unsigned int tried_implicit
:1; /* Nonzero if have searched
74 for implicit rule for making
75 this file; don't search again. */
76 unsigned int updating
:1; /* Nonzero while updating deps of this file */
77 unsigned int updated
:1; /* Nonzero if this file has been remade. */
78 unsigned int is_target
:1; /* Nonzero if file is described as target. */
79 unsigned int cmd_target
:1; /* Nonzero if file was given on cmd line. */
80 unsigned int phony
:1; /* Nonzero if this is a phony file
81 i.e., a dependency of .PHONY. */
82 unsigned int intermediate
:1;/* Nonzero if this is an intermediate file. */
83 /* Nonzero, for an intermediate file,
84 means remove_intermediates should not delete it. */
85 unsigned int secondary
:1;
86 unsigned int dontcare
:1; /* Nonzero if no complaint is to be made if
87 this target cannot be remade. */
88 unsigned int shownerror
:1; /* Nonzero if we printed an error */
89 unsigned int ignore_vpath
:1;/* Nonzero if we threw out VPATH name */
90 unsigned int pat_searched
:1;/* Nonzero if we already searched for
91 pattern-specific variables */
94 /* Number of intermediate files entered. */
96 extern unsigned int num_intermediates
;
98 extern struct file
*default_goal_file
, *suffix_file
, *default_file
;
101 extern struct file
*lookup_file
PARAMS ((char *name
));
102 extern struct file
*enter_file
PARAMS ((char *name
));
103 extern void remove_intermediates
PARAMS ((int sig
));
104 extern void snap_deps
PARAMS ((void));
105 extern void rename_file
PARAMS ((struct file
*file
, char *name
));
106 extern void rehash_file
PARAMS ((struct file
*file
, char *name
));
107 extern void file_hash_enter
PARAMS ((struct file
*file
, char *name
,
108 unsigned int oldhash
, char *oldname
));
109 extern void set_command_state
PARAMS ((struct file
*file
, int state
));
110 extern void notice_finished_file
PARAMS ((struct file
*file
));
114 # define FILE_TIMESTAMP_STAT_MODTIME(st) \
115 FILE_TIMESTAMP_FROM_S_AND_NS ((st).st_mtim.tv_sec, \
116 (st).st_mtim.ST_MTIM_NSEC)
117 # define FILE_TIMESTAMPS_PER_S \
118 MIN ((FILE_TIMESTAMP) 1000000000, \
119 (INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) \
120 / INTEGER_TYPE_MAXIMUM (time_t)))
122 # define FILE_TIMESTAMP_STAT_MODTIME(st) ((st).st_mtime)
123 # define FILE_TIMESTAMPS_PER_S 1
126 #define FILE_TIMESTAMP_FROM_S_AND_NS(s, ns) \
127 ((s) * FILE_TIMESTAMPS_PER_S \
128 + (ns) * FILE_TIMESTAMPS_PER_S / 1000000000)
129 #define FILE_TIMESTAMP_DIV(a, b) ((a)/(b) - ((a)%(b) < 0))
130 #define FILE_TIMESTAMP_MOD(a, b) ((a)%(b) + ((a)%(b) < 0) * (b))
131 #define FILE_TIMESTAMP_S(ts) FILE_TIMESTAMP_DIV ((ts), FILE_TIMESTAMPS_PER_S)
132 #define FILE_TIMESTAMP_NS(ts) \
133 (((FILE_TIMESTAMP_MOD ((ts), FILE_TIMESTAMPS_PER_S) * 1000000000) \
134 + (FILE_TIMESTAMPS_PER_S - 1)) \
135 / FILE_TIMESTAMPS_PER_S)
137 /* Upper bound on length of string "YYYY-MM-DD HH:MM:SS.NNNNNNNNN"
138 representing a file timestamp. The upper bound is not necessarily 19,
139 since the year might be less than -999 or greater than 9999.
141 Subtract one for the sign bit if in case file timestamps can be negative;
142 subtract FLOOR_LOG2_SECONDS_PER_YEAR to yield an upper bound on how many
143 file timestamp bits might affect the year;
144 302 / 1000 is log10 (2) rounded up;
145 add one for integer division truncation;
146 add one more for a minus sign if file timestamps can be negative;
147 add 4 to allow for any 4-digit epoch year (e.g. 1970);
148 add 25 to allow for "-MM-DD HH:MM:SS.NNNNNNNNN". */
149 #define FLOOR_LOG2_SECONDS_PER_YEAR 24
150 #define FILE_TIMESTAMP_PRINT_LEN_BOUND \
151 (((sizeof (FILE_TIMESTAMP) * CHAR_BIT - 1 - FLOOR_LOG2_SECONDS_PER_YEAR) \
155 extern FILE_TIMESTAMP file_timestamp_now
PARAMS ((void));
156 extern void file_timestamp_sprintf
PARAMS ((char *p
, FILE_TIMESTAMP ts
));
158 /* Return the mtime of file F (a struct file *), caching it.
159 The value is -1 if the file does not exist. */
160 #define file_mtime(f) file_mtime_1 ((f), 1)
161 /* Return the mtime of file F (a struct file *), caching it.
162 Don't search using vpath for the file--if it doesn't actually exist,
164 The value is -1 if the file does not exist. */
165 #define file_mtime_no_search(f) file_mtime_1 ((f), 0)
166 extern FILE_TIMESTAMP f_mtime
PARAMS ((struct file
*file
, int search
));
167 #define file_mtime_1(f, v) \
168 ((f)->last_mtime ? (f)->last_mtime : f_mtime ((f), v))
170 /* Modtime value to use for `infinitely new'. We used to get the current time
171 from the system and use that whenever we wanted `new'. But that causes
172 trouble when the machine running make and the machine holding a file have
173 different ideas about what time it is; and can also lose for `force'
174 targets, which need to be considered newer than anything that depends on
175 them, even if said dependents' modtimes are in the future.
177 If FILE_TIMESTAMP is unsigned, its maximum value is the same as
178 ((FILE_TIMESTAMP) -1), so use one less than that, because -1 is
179 used for non-existing files. */
181 (INTEGER_TYPE_SIGNED (FILE_TIMESTAMP) \
182 ? INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) \
183 : (INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) - 1))
185 #define check_renamed(file) \
186 while ((file)->renamed != 0) (file) = (file)->renamed /* No ; here. */