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, 675 Mass Ave, Cambridge, MA 02139, USA. */
19 /* Structure that represents the info on one file
20 that the makefile says how to make.
21 All of these are chained together through `next'. */
27 char *hname
; /* Hashed filename */
28 char *vpath
; /* VPATH/vpath pathname */
30 struct commands
*cmds
; /* Commands to execute for this target. */
31 int command_flags
; /* Flags OR'd in for cmds; see commands.h. */
32 char *stem
; /* Implicit stem, if an implicit
34 struct dep
*also_make
; /* Targets that are made by making this. */
35 time_t last_mtime
; /* File's modtime, if already known. */
36 struct file
*prev
; /* Previous entry for same file name;
37 used when there are multiple double-colon
38 entries for the same file. */
40 /* File that this file was renamed to. After any time that a
41 file could be renamed, call `check_renamed' (below). */
44 /* List of variable sets used for this file. */
45 struct variable_set_list
*variables
;
47 /* Immediate dependent that caused this target to be remade,
48 or nil if there isn't one. */
51 /* For a double-colon entry, this is the first double-colon entry for
52 the same file. Otherwise this is null. */
53 struct file
*double_colon
;
55 short int update_status
; /* Status of the last attempt to update,
56 or -1 if none has been made. */
58 enum /* State of the commands. */
59 { /* Note: It is important that cs_not_started be zero. */
60 cs_not_started
, /* Not yet started. */
61 cs_deps_running
, /* Dep commands running. */
62 cs_running
, /* Commands running. */
63 cs_finished
/* Commands finished. */
64 } command_state
ENUM_BITFIELD (2);
66 unsigned int precious
:1; /* Non-0 means don't delete file on quit */
67 unsigned int tried_implicit
:1; /* Nonzero if have searched
68 for implicit rule for making
69 this file; don't search again. */
70 unsigned int updating
:1; /* Nonzero while updating deps of this file */
71 unsigned int updated
:1; /* Nonzero if this file has been remade. */
72 unsigned int is_target
:1; /* Nonzero if file is described as target. */
73 unsigned int cmd_target
:1; /* Nonzero if file was given on cmd line. */
74 unsigned int phony
:1; /* Nonzero if this is a phony file
75 i.e., a dependency of .PHONY. */
76 unsigned int intermediate
:1;/* Nonzero if this is an intermediate file. */
77 /* Nonzero, for an intermediate file,
78 means remove_intermediates should not delete it. */
79 unsigned int secondary
:1;
80 unsigned int dontcare
:1; /* Nonzero if no complaint is to be made if
81 this target cannot be remade. */
82 unsigned int ignore_vpath
:1;/* Nonzero if we threw out VPATH name */
85 /* Number of intermediate files entered. */
87 extern unsigned int num_intermediates
;
89 extern struct file
*default_goal_file
, *suffix_file
, *default_file
;
92 extern struct file
*lookup_file (), *enter_file ();
93 extern void remove_intermediates (), snap_deps ();
94 extern void rename_file (), rehash_file (), file_hash_enter ();
95 extern void set_command_state ();
98 /* Return the mtime of file F (a struct file *), caching it.
99 The value is -1 if the file does not exist. */
100 #define file_mtime(f) file_mtime_1 ((f), 1)
101 /* Return the mtime of file F (a struct file *), caching it.
102 Don't search using vpath for the file--if it doesn't actually exist,
104 The value is -1 if the file does not exist. */
105 #define file_mtime_no_search(f) file_mtime_1 ((f), 0)
106 extern time_t f_mtime ();
107 #define file_mtime_1(f, v) \
108 ((f)->last_mtime != (time_t) 0 ? (f)->last_mtime : f_mtime ((f), v))
110 /* Modtime value to use for `infinitely new'. We used to get the current time
111 from the system and use that whenever we wanted `new'. But that causes
112 trouble when the machine running make and the machine holding a file have
113 different ideas about what time it is; and can also lose for `force'
114 targets, which need to be considered newer than anything that depends on
115 them, even if said dependents' modtimes are in the future.
117 If time_t is unsigned, its maximum value is the same as "(time_t) -1",
118 so use one less than that, because -1 is used for non-existing files. */
120 (INTEGER_TYPE_SIGNED (time_t) \
121 ? INTEGER_TYPE_MAXIMUM (time_t) \
122 : (INTEGER_TYPE_MAXIMUM (time_t) - 1))
124 #define check_renamed(file) \
125 while ((file)->renamed != 0) (file) = (file)->renamed /* No ; here. */