1 /* Miscellaneous global declarations and portability cruft for GNU Make.
2 Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
4 2012 Free Software Foundation, Inc.
5 This file is part of GNU Make.
7 GNU Make is free software; you can redistribute it and/or modify it under the
8 terms of the GNU General Public License as published by the Free Software
9 Foundation; either version 3 of the License, or (at your option) any later
12 GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
14 A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License along with
17 this program. If not, see <http://www.gnu.org/licenses/>. */
19 /* We use <config.h> instead of "config.h" so that a compilation
20 using -I. -I$srcdir will use ./config.h rather than $srcdir/config.h
21 (which it would do because make.h was found in $srcdir). */
24 #define HAVE_CONFIG_H 1
26 /* Specify we want GNU source code. This must be defined before any
27 system headers are included. */
31 /* AIX requires this to be the first thing in the file. */
38 # if !defined(__GNUC__) && !defined(WINDOWS32)
39 # ifndef alloca /* predefined by HP cc +Olibcalls */
46 /* Disable assert() unless we're a maintainer.
47 Some asserts are compute-intensive. */
48 #ifndef MAKE_MAINTAINER_MODE
54 /* This must happen before #include <signal.h> so
55 that the declaration therein is changed. */
56 # define signal bsdsignal
59 /* If we're compiling for the dmalloc debugger, turn off string inlining. */
60 #if defined(HAVE_DMALLOC_H) && defined(__GNUC__)
61 # define __NO_STRING_INLINES
64 #include <sys/types.h>
70 #ifdef HAVE_SYS_TIMEB_H
71 /* SCO 3.2 "devsys 4.2" has a prototype for `ftime' in <time.h> that bombs
72 unless <sys/timeb.h> has been included first. */
73 # include <sys/timeb.h>
75 #if TIME_WITH_SYS_TIME
76 # include <sys/time.h>
80 # include <sys/time.h>
93 # define isblank(c) ((c) == ' ' || (c) == '\t')
98 /* Ultrix's unistd.h always defines _POSIX_VERSION, but you only get
99 POSIX.1 behavior with `cc -YPOSIX', which predefines POSIX itself! */
100 # if defined (_POSIX_VERSION) && !defined (ultrix) && !defined (VMS)
105 /* Some systems define _POSIX_VERSION but are not really POSIX.1. */
106 #if (defined (butterfly) || defined (__arm) || (defined (__mips) && defined (_SYSTYPE_SVR3)) || (defined (sequent) && defined (i386)))
110 #if !defined (POSIX) && defined (_AIX) && defined (_POSIX_SOURCE)
115 # define RETSIGTYPE void
119 # define sigmask(sig) (1 << ((sig) - 1))
122 #ifndef HAVE_SA_RESTART
123 # define SA_RESTART 0
129 #ifdef HAVE_SYS_PARAM_H
130 # include <sys/param.h>
135 # define PATH_MAX MAXPATHLEN
139 # define MAXPATHLEN 1024
143 # define GET_PATH_MAX PATH_MAX
144 # define PATH_VAR(var) char var[PATH_MAX]
146 # define NEED_GET_PATH_MAX 1
147 # define GET_PATH_MAX (get_path_max ())
148 # define PATH_VAR(var) char *var = alloca (GET_PATH_MAX)
149 unsigned int get_path_max (void);
157 # define USHRT_MAX 65535
160 /* Nonzero if the integer type T is signed.
161 Use <= to avoid GCC warnings about always-false expressions. */
162 #define INTEGER_TYPE_SIGNED(t) ((t) -1 <= 0)
164 /* The minimum and maximum values for the integer type T.
165 Use ~ (t) 0, not -1, for portability to 1's complement hosts. */
166 #define INTEGER_TYPE_MINIMUM(t) \
167 (! INTEGER_TYPE_SIGNED (t) ? (t) 0 : ~ (t) 0 << (sizeof (t) * CHAR_BIT - 1))
168 #define INTEGER_TYPE_MAXIMUM(t) (~ (t) 0 - INTEGER_TYPE_MINIMUM (t))
171 # define CHAR_MAX INTEGER_TYPE_MAXIMUM (char)
174 #ifdef STAT_MACROS_BROKEN
181 #endif /* STAT_MACROS_BROKEN. */
184 # define S_ISREG(mode) (((mode) & S_IFMT) == S_IFREG)
187 # define S_ISDIR(mode) (((mode) & S_IFMT) == S_IFDIR)
192 # include <unixlib.h>
195 /* Needed to use alloca on VMS. */
196 # include <builtins.h>
199 #ifndef __attribute__
200 /* This feature is available in gcc versions 2.5 and later. */
201 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5) || __STRICT_ANSI__
202 # define __attribute__(x)
204 /* The __-protected variants of `format' and `printf' attributes
205 are accepted by gcc versions 2.6.4 (effectively 2.7) and later. */
206 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
207 # define __format__ format
208 # define __printf__ printf
211 #define UNUSED __attribute__ ((unused))
213 #if defined (STDC_HEADERS) || defined (__GNU_LIBRARY__)
216 # define ANSI_STRING 1
217 #else /* No standard headers. */
218 # ifdef HAVE_STRING_H
220 # define ANSI_STRING 1
222 # include <strings.h>
224 # ifdef HAVE_MEMORY_H
227 # ifdef HAVE_STDLIB_H
231 void *realloc (void *, int);
234 void abort (void) __attribute__ ((noreturn
));
235 void exit (int) __attribute__ ((noreturn
));
236 # endif /* HAVE_STDLIB_H. */
238 #endif /* Standard headers. */
240 /* These should be in stdlib.h. Make sure we have them. */
242 # define EXIT_SUCCESS 0
245 # define EXIT_FAILURE 1
250 /* SCO Xenix has a buggy macro definition in <string.h>. */
253 char *strerror (int errnum
);
256 #endif /* !ANSI_STRING. */
260 # include <inttypes.h>
265 #define FILE_TIMESTAMP uintmax_t
267 #if !defined(HAVE_STRSIGNAL)
268 char *strsignal (int signum
);
271 /* ISDIGIT offers the following features:
272 - Its arg may be any int or unsigned int; it need not be an unsigned char.
273 - It's guaranteed to evaluate its argument exactly once.
274 NOTE! Make relies on this behavior, don't change it!
275 - It's typically faster.
276 POSIX 1003.2-1992 section 2.5.2.1 page 50 lines 1556-1558 says that
277 only '0' through '9' are digits. Prefer ISDIGIT to isdigit() unless
278 it's important to use the locale's definition of `digit' even when the
279 host does not conform to POSIX. */
280 #define ISDIGIT(c) ((unsigned) (c) - '0' <= 9)
282 /* Test if two strings are equal. Is this worthwhile? Should be profiled. */
283 #define streq(a, b) \
285 (*(a) == *(b) && (*(a) == '\0' || !strcmp ((a) + 1, (b) + 1))))
287 /* Test if two strings are equal, but match case-insensitively on systems
288 which have case-insensitive filesystems. Should only be used for
290 #ifdef HAVE_CASE_INSENSITIVE_FS
291 # define patheq(a, b) \
293 || (tolower((unsigned char)*(a)) == tolower((unsigned char)*(b)) \
294 && (*(a) == '\0' || !strcasecmp ((a) + 1, (b) + 1))))
296 # define patheq(a, b) streq(a, b)
299 #define strneq(a, b, l) (strncmp ((a), (b), (l)) == 0)
301 #if defined(__GNUC__) || defined(ENUM_BITFIELDS)
302 # define ENUM_BITFIELD(bits) :bits
304 # define ENUM_BITFIELD(bits)
307 /* Handle gettext and locales. */
312 # define setlocale(category, locale)
317 #define _(msgid) gettext (msgid)
318 #define N_(msgid) gettext_noop (msgid)
319 #define S_(msg1,msg2,num) ngettext (msg1,msg2,num)
322 To overcome an issue parsing paths in a DOS/Windows environment when
323 built in a unix based environment, override the PATH_SEPARATOR_CHAR
324 definition unless being built for Cygwin. */
325 #if defined(HAVE_DOS_PATHS) && !defined(__CYGWIN__)
326 # undef PATH_SEPARATOR_CHAR
327 # define PATH_SEPARATOR_CHAR ';'
328 #elif !defined(PATH_SEPARATOR_CHAR)
330 # define PATH_SEPARATOR_CHAR ','
332 # define PATH_SEPARATOR_CHAR ':'
336 /* This is needed for getcwd() and chdir(), on some W32 systems. */
337 #if defined(HAVE_DIRECT_H)
344 # define pipe(_p) _pipe((_p), 512, O_BINARY)
345 # define kill(_pid,_sig) w32_kill((_pid),(_sig))
347 void sync_Path_environment (void);
348 int w32_kill (pid_t pid
, int sig
);
349 char *end_of_token_w32 (const char *s
, char stopchar
);
350 int find_and_set_default_shell (const char *token
);
352 /* indicates whether or not we have Bourne shell */
353 extern int no_default_sh_exe
;
355 /* is default_shell unixy? */
356 extern int unixy_shell
;
357 #endif /* WINDOWS32 */
359 #if defined(HAVE_SYS_RESOURCE_H) && defined(HAVE_GETRLIMIT) && defined(HAVE_SETRLIMIT)
360 # define SET_STACK_SIZE
362 #ifdef SET_STACK_SIZE
363 # include <sys/resource.h>
364 extern struct rlimit stack_limit
;
370 unsigned long lineno
;
372 #define NILF ((struct floc *)0)
374 #define STRING_SIZE_TUPLE(_s) (_s), (sizeof (_s)-1)
377 /* We have to have stdarg.h or varargs.h AND v*printf or doprnt to use
378 variadic versions of these functions. */
380 #if HAVE_STDARG_H || HAVE_VARARGS_H
381 # if HAVE_VPRINTF || HAVE_DOPRNT
382 # define USE_VARIADIC 1
386 #if HAVE_ANSI_COMPILER && USE_VARIADIC && HAVE_STDARG_H
387 const char *concat (unsigned int, ...);
388 void message (int prefix
, const char *fmt
, ...)
389 __attribute__ ((__format__ (__printf__
, 2, 3)));
390 void error (const struct floc
*flocp
, const char *fmt
, ...)
391 __attribute__ ((__format__ (__printf__
, 2, 3)));
392 void fatal (const struct floc
*flocp
, const char *fmt
, ...)
393 __attribute__ ((noreturn
, __format__ (__printf__
, 2, 3)));
395 const char *concat ();
401 void die (int) __attribute__ ((noreturn
));
402 void log_working_directory (int);
403 void pfatal_with_name (const char *) __attribute__ ((noreturn
));
404 void perror_with_name (const char *, const char *);
405 void *xmalloc (unsigned int);
406 void *xcalloc (unsigned int);
407 void *xrealloc (void *, unsigned int);
408 char *xstrdup (const char *);
409 char *xstrndup (const char *, unsigned int);
410 char *find_next_token (const char **, unsigned int *);
411 char *next_token (const char *);
412 char *end_of_token (const char *);
413 void collapse_continuations (char *);
414 char *lindex (const char *, const char *, int);
415 int alpha_compare (const void *, const void *);
416 void print_spaces (unsigned int);
417 char *find_percent (char *);
418 const char *find_percent_cached (const char **);
419 FILE *open_tmpfile (char **, const char *);
422 int ar_name (const char *);
423 void ar_parse_name (const char *, char **, char **);
424 int ar_touch (const char *);
425 time_t ar_member_date (const char *);
427 typedef long int (*ar_member_func_t
) (int desc
, const char *mem
, int truncated
,
428 long int hdrpos
, long int datapos
,
429 long int size
, long int date
, int uid
,
430 int gid
, int mode
, const void *arg
);
432 long int ar_scan (const char *archive
, ar_member_func_t function
, const void *arg
);
433 int ar_name_equal (const char *name
, const char *mem
, int truncated
);
435 int ar_member_touch (const char *arname
, const char *memname
);
439 int dir_file_exists_p (const char *, const char *);
440 int file_exists_p (const char *);
441 int file_impossible_p (const char *);
442 void file_impossible (const char *);
443 const char *dir_name (const char *);
444 void hash_init_directories (void);
446 void define_default_variables (void);
447 void set_default_suffixes (void);
448 void install_default_suffix_rules (void);
449 void install_default_implicit_rules (void);
451 void build_vpath_lists (void);
452 void construct_vpath_list (char *pattern
, char *dirpath
);
453 const char *vpath_search (const char *file
, FILE_TIMESTAMP
*mtime_ptr
,
454 unsigned int* vpath_index
, unsigned int* path_index
);
455 int gpath_search (const char *file
, unsigned int len
);
457 void construct_include_path (const char **arg_dirs
);
459 void user_access (void);
460 void make_access (void);
461 void child_access (void);
463 void close_stdout (void);
465 char *strip_whitespace (const char **begpp
, const char **endpp
);
468 void strcache_init (void);
469 void strcache_print_stats (const char *prefix
);
470 int strcache_iscached (const char *str
);
471 const char *strcache_add (const char *str
);
472 const char *strcache_add_len (const char *str
, unsigned int len
);
473 int strcache_setbufsize (unsigned int size
);
476 int setup_guile (void);
483 /* We omit these declarations on non-POSIX systems which define _POSIX_VERSION,
484 because such systems often declare them in header files anyway. */
486 #if !defined (__GNU_LIBRARY__) && !defined (POSIX) && !defined (_POSIX_VERSION) && !defined(WINDOWS32)
493 #endif /* Not GNU C library or POSIX. */
496 # if !defined(VMS) && !defined(__DECC)
501 # define getcwd(buf, len) getwd (buf)
506 # define strcasecmp stricmp
508 # define strcasecmp strcmpi
510 /* Create our own, in misc.c */
511 int strcasecmp (const char *s1
, const char *s2
);
515 #if !HAVE_STRNCASECMP
517 # define strncasecmp strnicmp
519 # define strncasecmp strncmpi
521 /* Create our own, in misc.c */
522 int strncasecmp (const char *s1
, const char *s2
, int n
);
526 extern const struct floc
*reading_file
;
527 extern const struct floc
**expanding_var
;
529 extern char **environ
;
531 extern int just_print_flag
, silent_flag
, ignore_errors_flag
, keep_going_flag
;
532 extern int print_data_base_flag
, question_flag
, touch_flag
, always_make_flag
;
533 extern int env_overrides
, no_builtin_rules_flag
, no_builtin_variables_flag
;
534 extern int print_version_flag
, print_directory_flag
, check_symlink_flag
;
535 extern int warn_undefined_variables_flag
, trace_flag
, posix_pedantic
;
536 extern int not_parallel
, second_expansion
, clock_skew_detected
;
537 extern int rebuilding_makefiles
, one_shell
;
539 /* can we run commands via 'sh -c xxx' or must we use batch files? */
540 extern int batch_mode_shell
;
542 /* Resetting the command script introduction prefix character. */
543 #define RECIPEPREFIX_NAME ".RECIPEPREFIX"
544 #define RECIPEPREFIX_DEFAULT '\t'
545 extern char cmd_prefix
;
547 extern unsigned int job_slots
;
548 extern int job_fds
[2];
551 extern double max_load_average
;
553 extern int max_load_average
;
556 extern char *program
;
557 extern char *starting_directory
;
558 extern unsigned int makelevel
;
559 extern char *version_string
, *remote_description
, *make_host
;
561 extern unsigned int commands_started
;
563 extern int handling_fatal_signal
;
567 #define MIN(_a,_b) ((_a)<(_b)?(_a):(_b))
570 #define MAX(_a,_b) ((_a)>(_b)?(_a):(_b))
574 # define MAKE_SUCCESS 1
575 # define MAKE_TROUBLE 2
576 # define MAKE_FAILURE 3
578 # define MAKE_SUCCESS 0
579 # define MAKE_TROUBLE 1
580 # define MAKE_FAILURE 2
583 /* Set up heap debugging library dmalloc. */
585 #ifdef HAVE_DMALLOC_H
589 #ifndef initialize_main
591 # define initialize_main(pargc, pargv) \
592 { _wildcard(pargc, pargv); _response(pargc, pargv); }
594 # define initialize_main(pargc, pargv)
600 # define chdir _chdir2
603 # define getcwd _getcwd2
606 /* NO_CHDIR2 causes make not to use _chdir2() and _getcwd2() instead of
607 chdir() and getcwd(). This avoids some error messages for the
608 make testsuite but restricts the drive letter support. */
610 # warning NO_CHDIR2: usage of drive letters restricted
616 #ifndef initialize_main
617 # define initialize_main(pargc, pargv)
621 /* Some systems (like Solaris, PTX, etc.) do not support the SA_RESTART flag
622 properly according to POSIX. So, we try to wrap common system calls with
623 checks for EINTR. Note that there are still plenty of system calls that
624 can fail with EINTR but this, reportedly, gets the vast majority of
625 failure cases. If you still experience failures you'll need to either get
626 a system where SA_RESTART works, or you need to avoid -j. */
628 #define EINTRLOOP(_v,_c) while (((_v)=_c)==-1 && errno==EINTR)
630 /* While system calls that return integers are pretty consistent about
631 returning -1 on failure and setting errno in that case, functions that
632 return pointers are not always so well behaved. Sometimes they return
633 NULL for expected behavior: one good example is readdir() which returns
634 NULL at the end of the directory--and _doesn't_ reset errno. So, we have
635 to do it ourselves here. */
637 #define ENULLLOOP(_v,_c) do { errno = 0; (_v) = _c; } \
638 while((_v)==0 && errno==EINTR)