filedef.h

   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.
   4
   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)
   8 any later version.
   9
  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.
  14
  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.  */
  19
  20
  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'.  */
  24
  25 struct file
  26   {
  27     struct file *next;
  28     char *name;
  29     char *hname;                /* Hashed filename */
  30     char *vpath;                /* VPATH/vpath pathname */
  31     struct dep *deps;
  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
  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
  44     /* File that this file was renamed to.  After any time that a
  45        file could be renamed, call `check_renamed' (below).  */
  46     struct file *renamed;
  47
  48     /* List of variable sets used for this file.  */
  49     struct variable_set_list *variables;
  50
  51     /* Immediate dependent that caused this target to be remade,
  52        or nil if there isn't one.  */
  53     struct file *parent;
  54
  55     /* For a double-colon entry, this is the first double-colon entry for
  56        the same file.  Otherwise this is null.  */
  57     struct file *double_colon;
  58
  59     /* Pattern-specific variable reference for this target, or null if there
  60        isn't one.  Also see the pat_searched flag, below.  */
  61     struct pattern_var *patvar;
  62
  63     short int update_status;    /* Status of the last attempt to update,
  64                                    or -1 if none has been made.  */
  65
  66     enum                        /* State of the commands.  */
  67       {         /* Note: It is important that cs_not_started be zero.  */
  68         cs_not_started,         /* Not yet started.  */
  69         cs_deps_running,        /* Dep commands running.  */
  70         cs_running,             /* Commands running.  */
  71         cs_finished             /* Commands finished.  */
  72       } command_state ENUM_BITFIELD (2);
  73
  74     unsigned int precious:1;    /* Non-0 means don't delete file on quit */
  75     unsigned int tried_implicit:1; /* Nonzero if have searched
  76                                       for implicit rule for making
  77                                       this file; don't search again.  */
  78     unsigned int updating:1;    /* Nonzero while updating deps of this file */
  79     unsigned int updated:1;     /* Nonzero if this file has been remade.  */
  80     unsigned int is_target:1;   /* Nonzero if file is described as target.  */
  81     unsigned int cmd_target:1;  /* Nonzero if file was given on cmd line.  */
  82     unsigned int phony:1;       /* Nonzero if this is a phony file
  83                                    i.e., a dependency of .PHONY.  */
  84     unsigned int intermediate:1;/* Nonzero if this is an intermediate file.  */
  85     /* Nonzero, for an intermediate file,
  86        means remove_intermediates should not delete it.  */
  87     unsigned int secondary:1;
  88     unsigned int dontcare:1;    /* Nonzero if no complaint is to be made if
  89                                    this target cannot be remade.  */
  90     unsigned int mfile_status:1;/* Nonzero if update_status was obtained
  91                                    while remaking a makefile.  */
  92     unsigned int ignore_vpath:1;/* Nonzero if we threw out VPATH name.  */
  93     unsigned int pat_searched:1;/* Nonzero if we already searched for
  94                                    pattern-specific variables.  */
  95     unsigned int considered:1;  /* equal to `considered' if file has been
  96                                    considered on current scan of goal chain */
  97   };
  98
  99 /* Number of intermediate files entered.  */
 100
 101 extern unsigned int num_intermediates;
 102
 103 /* Current value for pruning the scan of the goal chain (toggle 0/1).  */
 104
 105 extern unsigned int considered;
 106
 107 extern struct file *default_goal_file, *suffix_file, *default_file;
 108
 109
 110 extern struct file *lookup_file PARAMS ((char *name));
 111 extern struct file *enter_file PARAMS ((char *name));
 112 extern void remove_intermediates PARAMS ((int sig));
 113 extern void snap_deps PARAMS ((void));
 114 extern void rename_file PARAMS ((struct file *file, char *name));
 115 extern void rehash_file PARAMS ((struct file *file, char *name));
 116 extern void file_hash_enter PARAMS ((struct file *file, char *name,
 117                                      unsigned int oldhash, char *oldname));
 118 extern void set_command_state PARAMS ((struct file *file, int state));
 119 extern void notice_finished_file PARAMS ((struct file *file));
 120
 121
 122 #if ST_MTIM_NSEC
 123 # define FILE_TIMESTAMP_STAT_MODTIME(st) \
 124     FILE_TIMESTAMP_FROM_S_AND_NS ((st).st_mtim.tv_sec, \
 125                                   (st).st_mtim.ST_MTIM_NSEC)
 126 # define FILE_TIMESTAMPS_PER_S \
 127     MIN ((FILE_TIMESTAMP) 1000000000, \
 128          (INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) \
 129          / INTEGER_TYPE_MAXIMUM (time_t)))
 130 #else
 131 # define FILE_TIMESTAMP_STAT_MODTIME(st) ((st).st_mtime)
 132 # define FILE_TIMESTAMPS_PER_S 1
 133 #endif
 134
 135 #define FILE_TIMESTAMP_FROM_S_AND_NS(s, ns) \
 136     ((s) * FILE_TIMESTAMPS_PER_S \
 137      + (ns) * FILE_TIMESTAMPS_PER_S / 1000000000)
 138 #define FILE_TIMESTAMP_DIV(a, b) ((a)/(b) - ((a)%(b) < 0))
 139 #define FILE_TIMESTAMP_MOD(a, b) ((a)%(b) + ((a)%(b) < 0) * (b))
 140 #define FILE_TIMESTAMP_S(ts) FILE_TIMESTAMP_DIV ((ts), FILE_TIMESTAMPS_PER_S)
 141 #define FILE_TIMESTAMP_NS(ts) \
 142     (((FILE_TIMESTAMP_MOD ((ts), FILE_TIMESTAMPS_PER_S) * 1000000000) \
 143        + (FILE_TIMESTAMPS_PER_S - 1)) \
 144       / FILE_TIMESTAMPS_PER_S)
 145
 146 /* Upper bound on length of string "YYYY-MM-DD HH:MM:SS.NNNNNNNNN"
 147    representing a file timestamp.  The upper bound is not necessarily 19,
 148    since the year might be less than -999 or greater than 9999.
 149
 150    Subtract one for the sign bit if in case file timestamps can be negative;
 151    subtract FLOOR_LOG2_SECONDS_PER_YEAR to yield an upper bound on how many
 152    file timestamp bits might affect the year;
 153    302 / 1000 is log10 (2) rounded up;
 154    add one for integer division truncation;
 155    add one more for a minus sign if file timestamps can be negative;
 156    add 4 to allow for any 4-digit epoch year (e.g. 1970);
 157    add 25 to allow for "-MM-DD HH:MM:SS.NNNNNNNNN".  */
 158 #define FLOOR_LOG2_SECONDS_PER_YEAR 24
 159 #define FILE_TIMESTAMP_PRINT_LEN_BOUND \
 160   (((sizeof (FILE_TIMESTAMP) * CHAR_BIT - 1 - FLOOR_LOG2_SECONDS_PER_YEAR) \
 161     * 302 / 1000) \
 162    + 1 + 1 + 4 + 25)
 163
 164 extern FILE_TIMESTAMP file_timestamp_now PARAMS ((void));
 165 extern void file_timestamp_sprintf PARAMS ((char *p, FILE_TIMESTAMP ts));
 166
 167 /* Return the mtime of file F (a struct file *), caching it.
 168    The value is -1 if the file does not exist.  */
 169 #define file_mtime(f) file_mtime_1 ((f), 1)
 170 /* Return the mtime of file F (a struct file *), caching it.
 171    Don't search using vpath for the file--if it doesn't actually exist,
 172    we don't find it.
 173    The value is -1 if the file does not exist.  */
 174 #define file_mtime_no_search(f) file_mtime_1 ((f), 0)
 175 extern FILE_TIMESTAMP f_mtime PARAMS ((struct file *file, int search));
 176 #define file_mtime_1(f, v) \
 177   ((f)->last_mtime ? (f)->last_mtime : f_mtime ((f), v))
 178
 179 /* Modtime value to use for `infinitely new'.  We used to get the current time
 180    from the system and use that whenever we wanted `new'.  But that causes
 181    trouble when the machine running make and the machine holding a file have
 182    different ideas about what time it is; and can also lose for `force'
 183    targets, which need to be considered newer than anything that depends on
 184    them, even if said dependents' modtimes are in the future.
 185
 186    If FILE_TIMESTAMP is unsigned, its maximum value is the same as
 187    ((FILE_TIMESTAMP) -1), so use one less than that, because -1 is
 188    used for non-existing files.  */
 189 #define NEW_MTIME \
 190      (INTEGER_TYPE_SIGNED (FILE_TIMESTAMP) \
 191       ? INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) \
 192       : (INTEGER_TYPE_MAXIMUM (FILE_TIMESTAMP) - 1))
 193
 194 #define check_renamed(file) \
 195   while ((file)->renamed != 0) (file) = (file)->renamed /* No ; here.  */