contrib/bmake/dir.h

   1 /*      $NetBSD: dir.h,v 1.32 2020/10/25 10:00:20 rillig Exp $  */
   2
   3 /*
   4  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
   5  *
   6  * This code is derived from software contributed to Berkeley by
   7  * Adam de Boor.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in the
  16  *    documentation and/or other materials provided with the distribution.
  17  * 3. Neither the name of the University nor the names of its contributors
  18  *    may be used to endorse or promote products derived from this software
  19  *    without specific prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  *
  33  *      from: @(#)dir.h 8.1 (Berkeley) 6/6/93
  34  */
  35
  36 /*
  37  * Copyright (c) 1988, 1989 by Adam de Boor
  38  * Copyright (c) 1989 by Berkeley Softworks
  39  * All rights reserved.
  40  *
  41  * This code is derived from software contributed to Berkeley by
  42  * Adam de Boor.
  43  *
  44  * Redistribution and use in source and binary forms, with or without
  45  * modification, are permitted provided that the following conditions
  46  * are met:
  47  * 1. Redistributions of source code must retain the above copyright
  48  *    notice, this list of conditions and the following disclaimer.
  49  * 2. Redistributions in binary form must reproduce the above copyright
  50  *    notice, this list of conditions and the following disclaimer in the
  51  *    documentation and/or other materials provided with the distribution.
  52  * 3. All advertising materials mentioning features or use of this software
  53  *    must display the following acknowledgement:
  54  *      This product includes software developed by the University of
  55  *      California, Berkeley and its contributors.
  56  * 4. Neither the name of the University nor the names of its contributors
  57  *    may be used to endorse or promote products derived from this software
  58  *    without specific prior written permission.
  59  *
  60  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  61  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  62  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  63  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  64  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  65  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  66  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  67  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  68  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  69  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  70  * SUCH DAMAGE.
  71  *
  72  *      from: @(#)dir.h 8.1 (Berkeley) 6/6/93
  73  */
  74
  75 #ifndef MAKE_DIR_H
  76 #define MAKE_DIR_H
  77
  78 /* A cache for the filenames in a directory. */
  79 typedef struct CachedDir {
  80     char *name;                 /* Name of directory, either absolute or
  81                                  * relative to the current directory.
  82                                  * The name is not normalized in any way,
  83                                  * that is, "." and "./." are different.
  84                                  *
  85                                  * Not sure what happens when .CURDIR is
  86                                  * assigned a new value; see Parse_DoVar. */
  87     int refCount;               /* Number of SearchPaths with this directory */
  88     int hits;                   /* The number of times a file in this
  89                                  * directory has been found */
  90     HashTable files;            /* Hash set of files in directory;
  91                                  * all values are NULL. */
  92 } CachedDir;
  93
  94 void Dir_Init(void);
  95 void Dir_InitDir(const char *);
  96 void Dir_InitCur(const char *);
  97 void Dir_InitDot(void);
  98 void Dir_End(void);
  99 void Dir_SetPATH(void);
 100 Boolean Dir_HasWildcards(const char *);
 101 void Dir_Expand(const char *, SearchPath *, StringList *);
 102 char *Dir_FindFile(const char *, SearchPath *);
 103 char *Dir_FindHereOrAbove(const char *, const char *);
 104 time_t Dir_MTime(GNode *, Boolean);
 105 CachedDir *Dir_AddDir(SearchPath *, const char *);
 106 char *Dir_MakeFlags(const char *, SearchPath *);
 107 void Dir_ClearPath(SearchPath *);
 108 void Dir_Concat(SearchPath *, SearchPath *);
 109 void Dir_PrintDirectories(void);
 110 void Dir_PrintPath(SearchPath *);
 111 void Dir_Destroy(void *);
 112 SearchPath *Dir_CopyDirSearchPath(void);
 113
 114 /* Stripped-down variant of struct stat. */
 115 struct make_stat {
 116     time_t mst_mtime;
 117     mode_t mst_mode;
 118 };
 119
 120 int cached_lstat(const char *, struct make_stat *);
 121 int cached_stat(const char *, struct make_stat *);
 122
 123 #endif /* MAKE_DIR_H */