1 /* Argument parsing and main program of GNU Make.
2 Copyright (C) 1988,89,90,91,94,95,96,97,98,99 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, Boston,
18 MA 02111-1307, USA. */
33 # include <proto/dos.h>
37 #include "pathstuff.h"
39 #if defined(MAKE_JOBSERVER) && defined(HAVE_FCNTL_H)
44 int __stack
= 20000; /* Make sure we have 20K of stack space */
47 extern void init_dir
PARAMS ((void));
48 extern void remote_setup
PARAMS ((void));
49 extern void remote_cleanup
PARAMS ((void));
50 extern RETSIGTYPE fatal_error_signal
PARAMS ((int sig
));
52 extern void print_variable_data_base
PARAMS ((void));
53 extern void print_dir_data_base
PARAMS ((void));
54 extern void print_rule_data_base
PARAMS ((void));
55 extern void print_file_data_base
PARAMS ((void));
56 extern void print_vpath_data_base
PARAMS ((void));
58 #if defined HAVE_WAITPID || defined HAVE_WAIT3
59 # define HAVE_WAIT_NOHANG
66 # ifndef sun /* Sun has an incorrect decl in a header. */
67 extern void exit
PARAMS ((int)) __attribute__ ((noreturn
));
69 extern double atof ();
72 static void print_data_base
PARAMS ((void));
73 static void print_version
PARAMS ((void));
74 static void decode_switches
PARAMS ((int argc
, char **argv
, int env
));
75 static void decode_env_switches
PARAMS ((char *envar
, unsigned int len
));
76 static void define_makeflags
PARAMS ((int all
, int makefile
));
77 static char *quote_for_env
PARAMS ((char *out
, char *in
));
79 /* The structure that describes an accepted command switch. */
83 int c
; /* The switch character. */
85 enum /* Type of the value. */
87 flag
, /* Turn int flag on. */
88 flag_off
, /* Turn int flag off. */
89 string
, /* One string per switch. */
90 positive_int
, /* A positive integer. */
91 floating
, /* A floating-point number (double). */
95 char *value_ptr
; /* Pointer to the value-holding variable. */
97 unsigned int env
:1; /* Can come from MAKEFLAGS. */
98 unsigned int toenv
:1; /* Should be put in MAKEFLAGS. */
99 unsigned int no_makefile
:1; /* Don't propagate when remaking makefiles. */
101 char *noarg_value
; /* Pointer to value used if no argument is given. */
102 char *default_value
;/* Pointer to default value. */
104 char *long_name
; /* Long option name. */
105 char *argdesc
; /* Descriptive word for argument. */
106 char *description
; /* Description for usage message. */
107 /* 0 means internal; don't display help. */
110 /* True if C is a switch value that corresponds to a short option. */
112 #define short_option(c) ((c) <= CHAR_MAX)
114 /* The structure used to hold the list of strings given
115 in command switches of a type that takes string arguments. */
119 char **list
; /* Nil-terminated list of strings. */
120 unsigned int idx
; /* Index into above. */
121 unsigned int max
; /* Number of pointers allocated. */
125 /* The recognized command switches. */
127 /* Nonzero means do not print commands to be executed (-s). */
131 /* Nonzero means just touch the files
132 that would appear to need remaking (-t) */
136 /* Nonzero means just print what commands would need to be executed,
137 don't actually execute them (-n). */
141 /* Print debugging info (--debug). */
143 static struct stringlist
*db_flags
;
144 static int debug_flag
= 0;
149 /* Suspend make in main for a short time to allow debugger to attach */
151 int suspend_flag
= 0;
154 /* Environment variables override makefile definitions. */
156 int env_overrides
= 0;
158 /* Nonzero means ignore status codes returned by commands
159 executed to remake files. Just treat them all as successful (-i). */
161 int ignore_errors_flag
= 0;
163 /* Nonzero means don't remake anything, just print the data base
164 that results from reading the makefile (-p). */
166 int print_data_base_flag
= 0;
168 /* Nonzero means don't remake anything; just return a nonzero status
169 if the specified targets are not up to date (-q). */
171 int question_flag
= 0;
173 /* Nonzero means do not use any of the builtin rules (-r) / variables (-R). */
175 int no_builtin_rules_flag
= 0;
176 int no_builtin_variables_flag
= 0;
178 /* Nonzero means keep going even if remaking some file fails (-k). */
181 int default_keep_going_flag
= 0;
183 /* Nonzero means print directory before starting and when done (-w). */
185 int print_directory_flag
= 0;
187 /* Nonzero means ignore print_directory_flag and never print the directory.
188 This is necessary because print_directory_flag is set implicitly. */
190 int inhibit_print_directory_flag
= 0;
192 /* Nonzero means print version information. */
194 int print_version_flag
= 0;
196 /* List of makefiles given with -f switches. */
198 static struct stringlist
*makefiles
= 0;
200 /* Number of job slots (commands that can be run at once). */
202 unsigned int job_slots
= 1;
203 unsigned int default_job_slots
= 1;
205 /* Value of job_slots that means no limit. */
207 static unsigned int inf_jobs
= 0;
209 /* File descriptors for the jobs pipe. */
211 static struct stringlist
*jobserver_fds
= 0;
213 int job_fds
[2] = { -1, -1 };
216 /* Maximum load average at which multiple jobs will be run.
217 Negative values mean unlimited, while zero means limit to
218 zero load (which could be useful to start infinite jobs remotely
219 but one at a time locally). */
221 double max_load_average
= -1.0;
222 double default_load_average
= -1.0;
224 int max_load_average
= -1;
225 int default_load_average
= -1;
228 /* List of directories given with -C switches. */
230 static struct stringlist
*directories
= 0;
232 /* List of include directories given with -I switches. */
234 static struct stringlist
*include_directories
= 0;
236 /* List of files given with -o switches. */
238 static struct stringlist
*old_files
= 0;
240 /* List of files given with -W switches. */
242 static struct stringlist
*new_files
= 0;
244 /* If nonzero, we should just print usage and exit. */
246 static int print_usage_flag
= 0;
248 /* If nonzero, we should print a warning message
249 for each reference to an undefined variable. */
251 int warn_undefined_variables_flag
;
253 /* The table of command switches. */
255 static const struct command_switch switches
[] =
257 { 'b', ignore
, 0, 0, 0, 0, 0, 0,
259 N_("Ignored for compatibility") },
260 { 'C', string
, (char *) &directories
, 0, 0, 0, 0, 0,
261 "directory", N_("DIRECTORY"),
262 N_("Change to DIRECTORY before doing anything") },
263 { 'd', flag
, (char *) &debug_flag
, 1, 1, 0, 0, 0,
265 N_("Print lots of debugging information") },
266 { CHAR_MAX
+1, string
, (char *) &db_flags
, 1, 1, 0,
268 "debug", N_("FLAGS"),
269 N_("Print various types of debugging information") },
271 { 'D', flag
, (char *) &suspend_flag
, 1, 1, 0, 0, 0,
272 "suspend-for-debug", 0,
273 N_("Suspend process to allow a debugger to attach") },
275 { 'e', flag
, (char *) &env_overrides
, 1, 1, 0, 0, 0,
276 "environment-overrides", 0,
277 N_("Environment variables override makefiles") },
278 { 'f', string
, (char *) &makefiles
, 0, 0, 0, 0, 0,
280 N_("Read FILE as a makefile") },
281 { 'h', flag
, (char *) &print_usage_flag
, 0, 0, 0, 0, 0,
283 N_("Print this message and exit") },
284 { 'i', flag
, (char *) &ignore_errors_flag
, 1, 1, 0, 0, 0,
286 N_("Ignore errors from commands") },
287 { 'I', string
, (char *) &include_directories
, 1, 1, 0, 0, 0,
288 "include-dir", N_("DIRECTORY"),
289 N_("Search DIRECTORY for included makefiles") },
291 positive_int
, (char *) &job_slots
, 1, 1, 0,
292 (char *) &inf_jobs
, (char *) &default_job_slots
,
294 N_("Allow N jobs at once; infinite jobs with no arg") },
295 { CHAR_MAX
+2, string
, (char *) &jobserver_fds
, 1, 1, 0, 0, 0,
298 { 'k', flag
, (char *) &keep_going_flag
, 1, 1, 0,
299 0, (char *) &default_keep_going_flag
,
301 N_("Keep going when some targets can't be made") },
303 { 'l', floating
, (char *) &max_load_average
, 1, 1, 0,
304 (char *) &default_load_average
, (char *) &default_load_average
,
306 N_("Don't start multiple jobs unless load is below N") },
308 { 'l', positive_int
, (char *) &max_load_average
, 1, 1, 0,
309 (char *) &default_load_average
, (char *) &default_load_average
,
311 N_("Don't start multiple jobs unless load is below N") },
313 { 'm', ignore
, 0, 0, 0, 0, 0, 0,
316 { 'n', flag
, (char *) &just_print_flag
, 1, 1, 1, 0, 0,
318 N_("Don't actually run any commands; just print them") },
319 { 'o', string
, (char *) &old_files
, 0, 0, 0, 0, 0,
320 "old-file", N_("FILE"),
321 N_("Consider FILE to be very old and don't remake it") },
322 { 'p', flag
, (char *) &print_data_base_flag
, 1, 1, 0, 0, 0,
323 "print-data-base", 0,
324 N_("Print make's internal database") },
325 { 'q', flag
, (char *) &question_flag
, 1, 1, 1, 0, 0,
327 N_("Run no commands; exit status says if up to date") },
328 { 'r', flag
, (char *) &no_builtin_rules_flag
, 1, 1, 0, 0, 0,
329 "no-builtin-rules", 0,
330 N_("Disable the built-in implicit rules") },
331 { 'R', flag
, (char *) &no_builtin_variables_flag
, 1, 1, 0, 0, 0,
332 "no-builtin-variables", 0,
333 N_("Disable the built-in variable settings") },
334 { 's', flag
, (char *) &silent_flag
, 1, 1, 0, 0, 0,
336 N_("Don't echo commands") },
337 { 'S', flag_off
, (char *) &keep_going_flag
, 1, 1, 0,
338 0, (char *) &default_keep_going_flag
,
340 N_("Turns off -k") },
341 { 't', flag
, (char *) &touch_flag
, 1, 1, 1, 0, 0,
343 N_("Touch targets instead of remaking them") },
344 { 'v', flag
, (char *) &print_version_flag
, 1, 1, 0, 0, 0,
346 N_("Print the version number of make and exit") },
347 { 'w', flag
, (char *) &print_directory_flag
, 1, 1, 0, 0, 0,
348 "print-directory", 0,
349 N_("Print the current directory") },
350 { CHAR_MAX
+3, flag
, (char *) &inhibit_print_directory_flag
, 1, 1, 0, 0, 0,
351 "no-print-directory", 0,
352 N_("Turn off -w, even if it was turned on implicitly") },
353 { 'W', string
, (char *) &new_files
, 0, 0, 0, 0, 0,
354 "what-if", N_("FILE"),
355 N_("Consider FILE to be infinitely new") },
356 { CHAR_MAX
+4, flag
, (char *) &warn_undefined_variables_flag
, 1, 1, 0, 0, 0,
357 "warn-undefined-variables", 0,
358 N_("Warn when an undefined variable is referenced") },
362 /* Secondary long names for options. */
364 static struct option long_option_aliases
[] =
366 { "quiet", no_argument
, 0, 's' },
367 { "stop", no_argument
, 0, 'S' },
368 { "new-file", required_argument
, 0, 'W' },
369 { "assume-new", required_argument
, 0, 'W' },
370 { "assume-old", required_argument
, 0, 'o' },
371 { "max-load", optional_argument
, 0, 'l' },
372 { "dry-run", no_argument
, 0, 'n' },
373 { "recon", no_argument
, 0, 'n' },
374 { "makefile", required_argument
, 0, 'f' },
377 /* The usage message prints the descriptions of options starting in
378 this column. Make sure it leaves enough room for the longest
379 description to fit in less than 80 characters. */
381 #define DESCRIPTION_COLUMN 30
383 /* List of goal targets. */
385 static struct dep
*goals
, *lastgoal
;
387 /* List of variables which were defined on the command line
388 (or, equivalently, in MAKEFLAGS). */
390 struct command_variable
392 struct command_variable
*next
;
393 struct variable
*variable
;
395 static struct command_variable
*command_variables
;
397 /* The name we were invoked with. */
401 /* Our current directory before processing any -C options. */
403 char *directory_before_chdir
;
405 /* Our current directory after processing all -C options. */
407 char *starting_directory
;
409 /* Value of the MAKELEVEL variable at startup (or 0). */
411 unsigned int makelevel
;
413 /* First file defined in the makefile whose name does not
414 start with `.'. This is the default to remake if the
415 command line does not specify. */
417 struct file
*default_goal_file
;
419 /* Pointer to structure for the file .DEFAULT
420 whose commands are used for any file that has none of its own.
421 This is zero if the makefiles do not define .DEFAULT. */
423 struct file
*default_file
;
425 /* Nonzero if we have seen the magic `.POSIX' target.
426 This turns on pedantic compliance with POSIX.2. */
430 /* Nonzero if we have seen the `.NOTPARALLEL' target.
431 This turns off parallel builds for this invocation of make. */
435 /* Nonzero if some rule detected clock skew; we keep track so (a) we only
436 print one warning about it during the run, and (b) we can print a final
437 warning at the end of the run. */
439 int clock_skew_detected
;
441 /* Mask of signals that are being caught with fatal_error_signal. */
444 sigset_t fatal_signal_set
;
446 #ifdef HAVE_SIGSETMASK
447 int fatal_signal_mask
;
452 enter_command_line_file (name
)
456 fatal (NILF
, _("empty string invalid as file name"));
460 char *expanded
= tilde_expand (name
);
462 name
= expanded
; /* Memory leak; I don't care. */
465 /* This is also done in parse_file_seq, so this is redundant
466 for names read from makefiles. It is here for names passed
467 on the command line. */
468 while (name
[0] == '.' && name
[1] == '/' && name
[2] != '\0')
472 /* Skip following slashes: ".//foo" is "foo", not "/foo". */
478 /* It was all slashes! Move back to the dot and truncate
479 it after the first slash, so it becomes just "./". */
482 while (name
[0] != '.');
486 return enter_file (xstrdup (name
));
489 /* Toggle -d on receipt of SIGUSR1. */
492 debug_signal_handler (sig
)
495 db_level
= db_level
? DB_NONE
: DB_BASIC
;
499 decode_debug_flags ()
509 for (pp
=db_flags
->list
; *pp
; ++pp
)
515 switch (tolower (p
[0]))
521 db_level
|= DB_BASIC
;
524 db_level
|= DB_BASIC
| DB_IMPLICIT
;
530 db_level
|= DB_BASIC
| DB_MAKEFILES
;
533 db_level
|= DB_BASIC
| DB_VERBOSE
;
536 fatal (NILF
, _("unknown debug level specification `%s'"), p
);
539 while (*(++p
) != '\0')
540 if (*p
== ',' || *p
== ' ')
553 * HANDLE runtime exceptions by avoiding a requestor on the GUI. Capture
554 * exception and print it to stderr instead.
556 * If ! DB_VERBOSE, just print a simple message and exit.
557 * If DB_VERBOSE, print a more verbose message.
558 * If compiled for DEBUG, let exception pass through to GUI so that
559 * debuggers can attach.
562 handle_runtime_exceptions( struct _EXCEPTION_POINTERS
*exinfo
)
564 PEXCEPTION_RECORD exrec
= exinfo
->ExceptionRecord
;
565 LPSTR cmdline
= GetCommandLine();
566 LPSTR prg
= strtok(cmdline
, " ");
570 LPTSTR lpszStrings
[1];
573 if (! ISDB (DB_VERBOSE
))
576 _("%s: Interrupt/Exception caught (code = 0x%x, addr = 0x%x)\n"),
577 prg
, exrec
->ExceptionCode
, exrec
->ExceptionAddress
);
578 fprintf(stderr
, errmsg
);
583 _("\nUnhandled exception filter called from program %s\nExceptionCode = %x\nExceptionFlags = %x\nExceptionAddress = %x\n"),
584 prg
, exrec
->ExceptionCode
, exrec
->ExceptionFlags
,
585 exrec
->ExceptionAddress
);
587 if (exrec
->ExceptionCode
== EXCEPTION_ACCESS_VIOLATION
588 && exrec
->NumberParameters
>= 2)
589 sprintf(&errmsg
[strlen(errmsg
)],
590 (exrec
->ExceptionInformation
[0]
591 ? _("Access violation: write operation at address %x\n")
592 : _("Access violation: read operation at address %x\n")),
593 exrec
->ExceptionInformation
[1]);
595 /* turn this on if we want to put stuff in the event log too */
597 hEventSource
= RegisterEventSource(NULL
, "GNU Make");
598 lpszStrings
[0] = errmsg
;
600 if (hEventSource
!= NULL
)
602 ReportEvent(hEventSource
, /* handle of event source */
603 EVENTLOG_ERROR_TYPE
, /* event type */
604 0, /* event category */
606 NULL
, /* current user's SID */
607 1, /* strings in lpszStrings */
608 0, /* no bytes of raw data */
609 lpszStrings
, /* array of error strings */
610 NULL
); /* no raw data */
612 (VOID
) DeregisterEventSource(hEventSource
);
616 /* Write the error to stderr too */
617 fprintf(stderr
, errmsg
);
620 return EXCEPTION_CONTINUE_SEARCH
;
623 return (255); /* not reached */
628 * On WIN32 systems we don't have the luxury of a /bin directory that
629 * is mapped globally to every drive mounted to the system. Since make could
630 * be invoked from any drive, and we don't want to propogate /bin/sh
631 * to every single drive. Allow ourselves a chance to search for
632 * a value for default shell here (if the default path does not exist).
636 find_and_set_default_shell(char *token
)
641 extern char *default_shell
;
644 search_token
= default_shell
;
646 search_token
= token
;
648 if (!no_default_sh_exe
&&
649 (token
== NULL
|| !strcmp(search_token
, default_shell
))) {
650 /* no new information, path already set or known */
652 } else if (file_exists_p(search_token
)) {
653 /* search token path was found */
654 sprintf(sh_path
, "%s", search_token
);
655 default_shell
= xstrdup(w32ify(sh_path
,0));
657 (_("find_and_set_shell setting default_shell = %s\n"), default_shell
));
661 struct variable
*v
= lookup_variable ("Path", 4);
664 * Search Path for shell
670 ep
= strchr(p
, PATH_SEPARATOR_CHAR
);
675 if (dir_file_exists_p(p
, search_token
)) {
676 sprintf(sh_path
, "%s/%s", p
, search_token
);
677 default_shell
= xstrdup(w32ify(sh_path
,0));
679 *ep
= PATH_SEPARATOR_CHAR
;
684 *ep
= PATH_SEPARATOR_CHAR
;
688 ep
= strchr(p
, PATH_SEPARATOR_CHAR
);
691 /* be sure to check last element of Path */
692 if (p
&& *p
&& dir_file_exists_p(p
, search_token
)) {
693 sprintf(sh_path
, "%s/%s", p
, search_token
);
694 default_shell
= xstrdup(w32ify(sh_path
,0));
700 (_("find_and_set_shell path search set default_shell = %s\n"),
706 if (!unixy_shell
&& sh_found
&&
707 (strstr(default_shell
, "sh") || strstr(default_shell
, "SH"))) {
709 batch_mode_shell
= 0;
712 #ifdef BATCH_MODE_ONLY_SHELL
713 batch_mode_shell
= 1;
718 #endif /* WINDOWS32 */
723 msdos_return_to_initial_directory ()
725 if (directory_before_chdir
)
726 chdir (directory_before_chdir
);
730 extern char *mktemp ();
731 extern int mkstemp ();
734 open_tmpfile(name
, template)
736 const char *template;
740 #if defined HAVE_MKSTEMP || defined HAVE_MKTEMP
741 # define TEMPLATE_LEN strlen (template)
743 # define TEMPLATE_LEN L_tmpnam
745 *name
= xmalloc (TEMPLATE_LEN
+ 1);
746 strcpy (*name
, template);
748 #if defined HAVE_MKSTEMP && defined HAVE_FDOPEN
749 /* It's safest to use mkstemp(), if we can. */
750 fd
= mkstemp (*name
);
753 return fdopen (fd
, "w");
756 (void) mktemp (*name
);
758 (void) tmpnam (*name
);
762 /* Can't use mkstemp(), but guard against a race condition. */
763 fd
= open (*name
, O_CREAT
|O_EXCL
|O_WRONLY
, 0600);
766 return fdopen (fd
, "w");
768 /* Not secure, but what can we do? */
769 return fopen (*name
, "w");
777 main (argc
, argv
, envp
)
782 int main (int argc
, char ** argv
)
785 static char *stdin_nm
= 0;
786 register struct file
*f
;
787 register unsigned int i
;
789 struct dep
*read_makefiles
;
790 PATH_VAR (current_directory
);
792 char *unix_path
= NULL
;
793 char *windows32_path
= NULL
;
795 SetUnhandledExceptionFilter(handle_runtime_exceptions
);
797 /* start off assuming we have no shell */
799 no_default_sh_exe
= 1;
802 default_goal_file
= 0;
805 #if defined (__MSDOS__) && !defined (_POSIX_SOURCE)
806 /* Request the most powerful version of `system', to
807 make up for the dumb default shell. */
808 __system_flags
= (__system_redirect
810 | __system_allow_multiple_cmds
811 | __system_allow_long_cmds
812 | __system_handle_null_commands
813 | __system_emulate_chdir
);
817 /* Set up gettext/internationalization support. */
818 setlocale (LC_ALL
, "");
819 bindtextdomain (PACKAGE
, LOCALEDIR
);
820 textdomain (PACKAGE
);
822 #if !defined (HAVE_STRSIGNAL) && !defined (HAVE_SYS_SIGLIST)
824 extern void signame_init ();
830 sigemptyset (&fatal_signal_set
);
831 #define ADD_SIG(sig) sigaddset (&fatal_signal_set, sig)
833 #ifdef HAVE_SIGSETMASK
834 fatal_signal_mask
= 0;
835 #define ADD_SIG(sig) fatal_signal_mask |= sigmask (sig)
841 #define FATAL_SIG(sig) \
842 if (signal ((sig), fatal_error_signal) == SIG_IGN) \
843 (void) signal ((sig), SIG_IGN); \
857 /* Windows 9X delivers FP exceptions in child programs to their
858 parent! We don't want Make to die when a child divides by zero,
859 so we work around that lossage by catching SIGFPE. */
864 FATAL_SIG (SIGDANGER
);
875 /* Do not ignore the child-death signal. This must be done before
876 any children could possibly be created; otherwise, the wait
877 functions won't work on systems with the SVR4 ECHILD brain
878 damage, if our invoker is ignoring this signal. */
880 #ifdef HAVE_WAIT_NOHANG
882 (void) signal (SIGCHLD
, SIG_DFL
);
884 # if defined SIGCLD && SIGCLD != SIGCHLD
885 (void) signal (SIGCLD
, SIG_DFL
);
889 /* Make sure stdout is line-buffered. */
891 #ifdef HAVE_SETLINEBUF
894 #ifndef SETVBUF_REVERSED
895 setvbuf (stdout
, (char *) 0, _IOLBF
, BUFSIZ
);
896 #else /* setvbuf not reversed. */
897 /* Some buggy systems lose if we pass 0 instead of allocating ourselves. */
898 setvbuf (stdout
, _IOLBF
, xmalloc (BUFSIZ
), BUFSIZ
);
899 #endif /* setvbuf reversed. */
900 #endif /* setlinebuf missing. */
902 /* Figure out where this program lives. */
906 if (argv
[0][0] == '\0')
911 program
= strrchr (argv
[0], ']');
913 program
= strrchr (argv
[0], '/');
917 program
= strrchr (argv
[0], '\\');
920 /* Some weird environments might pass us argv[0] with
921 both kinds of slashes; we must find the rightmost. */
922 char *p
= strrchr (argv
[0], '\\');
923 if (p
&& p
> program
)
926 if (program
== 0 && argv
[0][1] == ':')
927 program
= argv
[0] + 1;
935 /* Set up to access user data (files). */
938 /* Figure out where we are. */
941 if (getcwd_fs (current_directory
, GET_PATH_MAX
) == 0)
943 if (getcwd (current_directory
, GET_PATH_MAX
) == 0)
947 perror_with_name ("getcwd: ", "");
949 error (NILF
, "getwd: %s", current_directory
);
951 current_directory
[0] = '\0';
952 directory_before_chdir
= 0;
955 directory_before_chdir
= xstrdup (current_directory
);
957 /* Make sure we will return to the initial directory, come what may. */
958 atexit (msdos_return_to_initial_directory
);
961 /* Read in variables from the environment. It is important that this be
962 done before $(MAKE) is figured out so its definitions will not be
963 from the environment. */
966 for (i
= 0; envp
[i
] != 0; ++i
)
969 register char *ep
= envp
[i
];
971 /* by default, everything gets defined and exported */
977 if (!unix_path
&& strneq(envp
[i
], "PATH=", 5))
979 else if (!windows32_path
&& !strnicmp(envp
[i
], "Path=", 5)) {
980 do_not_define
= 1; /* it gets defined after loop exits */
981 windows32_path
= ep
+1;
984 /* The result of pointer arithmetic is cast to unsigned int for
985 machines where ptrdiff_t is a different size that doesn't widen
988 define_variable (envp
[i
], (unsigned int) (ep
- envp
[i
]),
990 /* Force exportation of every variable culled from the environment.
991 We used to rely on target_environment's v_default code to do this.
992 But that does not work for the case where an environment variable
993 is redefined in a makefile with `override'; it should then still
994 be exported, because it was originally in the environment. */
999 * Make sure that this particular spelling of 'Path' is available
1002 define_variable("Path", 4, windows32_path
, o_env
, 1)->export
= v_export
;
1004 define_variable("Path", 4, unix_path
, o_env
, 1)->export
= v_export
;
1006 define_variable("Path", 4, "", o_env
, 1)->export
= v_export
;
1009 * PATH defaults to Path iff PATH not found and Path is found.
1011 if (!unix_path
&& windows32_path
)
1012 define_variable("PATH", 4, windows32_path
, o_env
, 1)->export
= v_export
;
1014 #else /* For Amiga, read the ENV: device, ignoring all dirs */
1016 BPTR env
, file
, old
;
1019 __aligned
struct FileInfoBlock fib
;
1021 env
= Lock ("ENV:", ACCESS_READ
);
1024 old
= CurrentDir (DupLock(env
));
1025 Examine (env
, &fib
);
1027 while (ExNext (env
, &fib
))
1029 if (fib
.fib_DirEntryType
< 0) /* File */
1031 /* Define an empty variable. It will be filled in
1032 variable_lookup(). Makes startup quite a bit
1034 define_variable (fib
.fib_FileName
,
1035 strlen (fib
.fib_FileName
),
1036 "", o_env
, 1)->export
= v_export
;
1040 UnLock(CurrentDir(old
));
1045 /* Decode the switches. */
1047 decode_env_switches ("MAKEFLAGS", 9);
1049 /* People write things like:
1050 MFLAGS="CC=gcc -pipe" "CFLAGS=-g"
1051 and we set the -p, -i and -e switches. Doesn't seem quite right. */
1052 decode_env_switches ("MFLAGS", 6);
1054 decode_switches (argc
, argv
, 0);
1057 fprintf(stderr
, "%s (pid = %d)\n", argv
[0], GetCurrentProcessId());
1058 fprintf(stderr
, _("%s is suspending for 30 seconds..."), argv
[0]);
1060 fprintf(stderr
, _("done sleep(30). Continuing.\n"));
1064 decode_debug_flags ();
1066 /* Print version information. */
1068 if (print_version_flag
|| print_data_base_flag
|| db_level
)
1071 /* `make --version' is supposed to just print the version and exit. */
1072 if (print_version_flag
)
1076 /* Set the "MAKE_COMMAND" variable to the name we were invoked with.
1077 (If it is a relative pathname with a slash, prepend our directory name
1078 so the result will run the same program regardless of the current dir.
1079 If it is a name with no slash, we can only hope that PATH did not
1080 find it in the current directory.) */
1083 * Convert from backslashes to forward slashes for
1084 * programs like sh which don't like them. Shouldn't
1085 * matter if the path is one way or the other for
1088 if (strpbrk(argv
[0], "/:\\") ||
1089 strstr(argv
[0], "..") ||
1090 strneq(argv
[0], "//", 2))
1091 argv
[0] = xstrdup(w32ify(argv
[0],1));
1092 #else /* WINDOWS32 */
1094 if (strchr (argv
[0], '\\'))
1098 argv
[0] = xstrdup (argv
[0]);
1099 for (p
= argv
[0]; *p
; p
++)
1103 /* If argv[0] is not in absolute form, prepend the current
1104 directory. This can happen when Make is invoked by another DJGPP
1105 program that uses a non-absolute name. */
1106 if (current_directory
[0] != '\0'
1108 && (argv
[0][0] != '/' && (argv
[0][0] == '\0' || argv
[0][1] != ':')))
1109 argv
[0] = concat (current_directory
, "/", argv
[0]);
1110 #else /* !__MSDOS__ */
1111 if (current_directory
[0] != '\0'
1112 && argv
[0] != 0 && argv
[0][0] != '/' && strchr (argv
[0], '/') != 0)
1113 argv
[0] = concat (current_directory
, "/", argv
[0]);
1114 #endif /* !__MSDOS__ */
1115 #endif /* WINDOWS32 */
1118 /* The extra indirection through $(MAKE_COMMAND) is done
1119 for hysterical raisins. */
1120 (void) define_variable ("MAKE_COMMAND", 12, argv
[0], o_default
, 0);
1121 (void) define_variable ("MAKE", 4, "$(MAKE_COMMAND)", o_default
, 1);
1123 if (command_variables
!= 0)
1125 struct command_variable
*cv
;
1127 unsigned int len
= 0;
1130 /* Figure out how much space will be taken up by the command-line
1131 variable definitions. */
1132 for (cv
= command_variables
; cv
!= 0; cv
= cv
->next
)
1135 len
+= 2 * strlen (v
->name
);
1139 len
+= 2 * strlen (v
->value
);
1143 /* Now allocate a buffer big enough and fill it. */
1144 p
= value
= (char *) alloca (len
);
1145 for (cv
= command_variables
; cv
!= 0; cv
= cv
->next
)
1148 p
= quote_for_env (p
, v
->name
);
1152 p
= quote_for_env (p
, v
->value
);
1155 p
[-1] = '\0'; /* Kill the final space and terminate. */
1157 /* Define an unchangeable variable with a name that no POSIX.2
1158 makefile could validly use for its own variable. */
1159 (void) define_variable ("-*-command-variables-*-", 23,
1160 value
, o_automatic
, 0);
1162 /* Define the variable; this will not override any user definition.
1163 Normally a reference to this variable is written into the value of
1164 MAKEFLAGS, allowing the user to override this value to affect the
1165 exported value of MAKEFLAGS. In POSIX-pedantic mode, we cannot
1166 allow the user's setting of MAKEOVERRIDES to affect MAKEFLAGS, so
1167 a reference to this hidden variable is written instead. */
1168 (void) define_variable ("MAKEOVERRIDES", 13,
1169 "${-*-command-variables-*-}", o_env
, 1);
1172 /* If there were -C flags, move ourselves about. */
1173 if (directories
!= 0)
1174 for (i
= 0; directories
->list
[i
] != 0; ++i
)
1176 char *dir
= directories
->list
[i
];
1179 char *expanded
= tilde_expand (dir
);
1183 if (chdir (dir
) < 0)
1184 pfatal_with_name (dir
);
1185 if (dir
!= directories
->list
[i
])
1191 * THIS BLOCK OF CODE MUST COME AFTER chdir() CALL ABOVE IN ORDER
1192 * TO NOT CONFUSE THE DEPENDENCY CHECKING CODE IN implicit.c.
1194 * The functions in dir.c can incorrectly cache information for "."
1195 * before we have changed directory and this can cause file
1196 * lookups to fail because the current directory (.) was pointing
1197 * at the wrong place when it was first evaluated.
1199 no_default_sh_exe
= !find_and_set_default_shell(NULL
);
1201 #endif /* WINDOWS32 */
1202 /* Figure out the level of recursion. */
1204 struct variable
*v
= lookup_variable ("MAKELEVEL", 9);
1205 if (v
!= 0 && v
->value
[0] != '\0' && v
->value
[0] != '-')
1206 makelevel
= (unsigned int) atoi (v
->value
);
1211 /* Except under -s, always do -w in sub-makes and under -C. */
1212 if (!silent_flag
&& (directories
!= 0 || makelevel
> 0))
1213 print_directory_flag
= 1;
1215 /* Let the user disable that with --no-print-directory. */
1216 if (inhibit_print_directory_flag
)
1217 print_directory_flag
= 0;
1219 /* If -R was given, set -r too (doesn't make sense otherwise!) */
1220 if (no_builtin_variables_flag
)
1221 no_builtin_rules_flag
= 1;
1223 /* Construct the list of include directories to search. */
1225 construct_include_path (include_directories
== 0 ? (char **) 0
1226 : include_directories
->list
);
1228 /* Figure out where we are now, after chdir'ing. */
1229 if (directories
== 0)
1230 /* We didn't move, so we're still in the same place. */
1231 starting_directory
= current_directory
;
1235 if (getcwd_fs (current_directory
, GET_PATH_MAX
) == 0)
1237 if (getcwd (current_directory
, GET_PATH_MAX
) == 0)
1241 perror_with_name ("getcwd: ", "");
1243 error (NILF
, "getwd: %s", current_directory
);
1245 starting_directory
= 0;
1248 starting_directory
= current_directory
;
1251 (void) define_variable ("CURDIR", 6, current_directory
, o_default
, 0);
1253 /* Read any stdin makefiles into temporary files. */
1257 register unsigned int i
;
1258 for (i
= 0; i
< makefiles
->idx
; ++i
)
1259 if (makefiles
->list
[i
][0] == '-' && makefiles
->list
[i
][1] == '\0')
1261 /* This makefile is standard input. Since we may re-exec
1262 and thus re-read the makefiles, we read standard input
1263 into a temporary file and read from that. */
1265 char *template, *tmpdir
;
1268 fatal (NILF
, _("Makefile from standard input specified twice."));
1271 # define DEFAULT_TMPDIR "sys$scratch:"
1274 # define DEFAULT_TMPDIR P_tmpdir
1276 # define DEFAULT_TMPDIR "/tmp"
1279 #define DEFAULT_TMPFILE "GmXXXXXX"
1281 if (((tmpdir
= getenv ("TMPDIR")) == NULL
|| *tmpdir
== '\0')
1282 #if defined __MSDOS__ || defined(WINDOWS32)
1283 /* These are also used commonly on these platforms. */
1284 && ((tmpdir
= getenv ("TEMP")) == NULL
|| *tmpdir
== '\0')
1285 && ((tmpdir
= getenv ("TMP")) == NULL
|| *tmpdir
== '\0')
1288 tmpdir
= DEFAULT_TMPDIR
;
1290 template = (char *) alloca (strlen (tmpdir
)
1291 + sizeof (DEFAULT_TMPFILE
) + 1);
1292 strcpy (template, tmpdir
);
1294 #if defined __MSDOS__ || defined(WINDOWS32)
1295 if (strchr ("/\\", template[strlen (template) - 1]) == NULL
)
1296 strcat (template, "/");
1299 if (template[strlen (template) - 1] != '/')
1300 strcat (template, "/");
1302 #endif /* __MSDOS__ || WINDOWS32 */
1304 strcat (template, DEFAULT_TMPFILE
);
1305 outfile
= open_tmpfile (&stdin_nm
, template);
1307 pfatal_with_name (_("fopen (temporary file)"));
1308 while (!feof (stdin
))
1311 unsigned int n
= fread (buf
, 1, sizeof (buf
), stdin
);
1312 if (n
> 0 && fwrite (buf
, 1, n
, outfile
) != n
)
1313 pfatal_with_name (_("fwrite (temporary file)"));
1315 (void) fclose (outfile
);
1317 /* Replace the name that read_all_makefiles will
1318 see with the name of the temporary file. */
1319 makefiles
->list
[i
] = xstrdup (stdin_nm
);
1321 /* Make sure the temporary file will not be remade. */
1322 f
= enter_file (stdin_nm
);
1324 f
->update_status
= 0;
1325 f
->command_state
= cs_finished
;
1326 /* Can't be intermediate, or it'll be removed too early for
1328 f
->intermediate
= 0;
1333 #if defined(MAKE_JOBSERVER) || !defined(HAVE_WAIT_NOHANG)
1334 /* Set up to handle children dying. This must be done before
1335 reading in the makefiles so that `shell' function calls will work.
1337 If we don't have a hanging wait we have to fall back to old, broken
1338 functionality here and rely on the signal handler and counting
1341 If we're using the jobs pipe we need a signal handler so that
1342 SIGCHLD is not ignored; we need it to interrupt the read(2) of the
1343 jobserver pipe in job.c if we're waiting for a token.
1345 If none of these are true, we don't need a signal handler at all. */
1347 extern RETSIGTYPE child_handler
PARAMS ((int sig
));
1349 # if defined HAVE_SIGACTION
1350 struct sigaction sa
;
1352 bzero ((char *)&sa
, sizeof (struct sigaction
));
1353 sa
.sa_handler
= child_handler
;
1354 # if defined SA_INTERRUPT
1355 /* This is supposed to be the default, but what the heck... */
1356 sa
.sa_flags
= SA_INTERRUPT
;
1358 # define HANDLESIG(s) sigaction (s, &sa, NULL)
1360 # define HANDLESIG(s) signal (s, child_handler)
1363 /* OK, now actually install the handlers. */
1364 # if defined SIGCHLD
1365 (void) HANDLESIG (SIGCHLD
);
1367 # if defined SIGCLD && SIGCLD != SIGCHLD
1368 (void) HANDLESIG (SIGCLD
);
1373 /* Let the user send us SIGUSR1 to toggle the -d flag during the run. */
1375 (void) signal (SIGUSR1
, debug_signal_handler
);
1378 /* Define the initial list of suffixes for old-style rules. */
1380 set_default_suffixes ();
1382 /* Define the file rules for the built-in suffix rules. These will later
1383 be converted into pattern rules. We used to do this in
1384 install_default_implicit_rules, but since that happens after reading
1385 makefiles, it results in the built-in pattern rules taking precedence
1386 over makefile-specified suffix rules, which is wrong. */
1388 install_default_suffix_rules ();
1390 /* Define some internal and special variables. */
1392 define_automatic_variables ();
1394 /* Set up the MAKEFLAGS and MFLAGS variables
1395 so makefiles can look at them. */
1397 define_makeflags (0, 0);
1399 /* Define the default variables. */
1400 define_default_variables ();
1402 /* Read all the makefiles. */
1404 default_file
= enter_file (".DEFAULT");
1407 = read_all_makefiles (makefiles
== 0 ? (char **) 0 : makefiles
->list
);
1410 /* look one last time after reading all Makefiles */
1411 if (no_default_sh_exe
)
1412 no_default_sh_exe
= !find_and_set_default_shell(NULL
);
1414 if (no_default_sh_exe
&& job_slots
!= 1) {
1415 error (NILF
, _("Do not specify -j or --jobs if sh.exe is not available."));
1416 error (NILF
, _("Resetting make for single job mode."));
1419 #endif /* WINDOWS32 */
1422 /* We need to know what kind of shell we will be using. */
1424 extern int _is_unixy_shell (const char *_path
);
1425 struct variable
*shv
= lookup_variable ("SHELL", 5);
1426 extern int unixy_shell
;
1427 extern char *default_shell
;
1429 if (shv
&& *shv
->value
)
1431 char *shell_path
= recursively_expand(shv
);
1433 if (shell_path
&& _is_unixy_shell (shell_path
))
1438 default_shell
= shell_path
;
1441 #endif /* __MSDOS__ */
1443 /* Decode switches again, in case the variables were set by the makefile. */
1444 decode_env_switches ("MAKEFLAGS", 9);
1446 decode_env_switches ("MFLAGS", 6);
1453 _("Parallel jobs (-j) are not supported on this platform."));
1454 error (NILF
, _("Resetting to single job (-j1) mode."));
1459 #ifdef MAKE_JOBSERVER
1460 /* If the jobserver-fds option is seen, make sure that -j is reasonable. */
1466 for (i
=1; i
< jobserver_fds
->idx
; ++i
)
1467 if (!streq (jobserver_fds
->list
[0], jobserver_fds
->list
[i
]))
1468 fatal (NILF
, _("internal error: multiple --jobserver-fds options"));
1470 /* Now parse the fds string and make sure it has the proper format. */
1472 cp
= jobserver_fds
->list
[0];
1474 if (sscanf (cp
, "%d,%d", &job_fds
[0], &job_fds
[1]) != 2)
1476 _("internal error: invalid --jobserver-fds string `%s'"), cp
);
1478 /* The combination of a pipe + !job_slots means we're using the
1479 jobserver. If !job_slots and we don't have a pipe, we can start
1480 infinite jobs. If we see both a pipe and job_slots >0 that means the
1481 user set -j explicitly. This is broken; in this case obey the user
1482 (ignore the jobserver pipe for this make) but print a message. */
1486 _("warning: -jN forced in submake: disabling jobserver mode."));
1488 /* Create a duplicate pipe, that will be closed in the SIGCHLD
1489 handler. If this fails with EBADF, the parent has closed the pipe
1490 on us because it didn't think we were a submake. If so, print a
1491 warning then default to -j1. */
1493 else if ((job_rfd
= dup (job_fds
[0])) < 0)
1496 pfatal_with_name (_("dup jobserver"));
1499 _("warning: jobserver unavailable: using -j1. Add `+' to parent make rule."));
1507 job_fds
[0] = job_fds
[1] = -1;
1508 free (jobserver_fds
->list
);
1509 free (jobserver_fds
);
1514 /* If we have >1 slot but no jobserver-fds, then we're a top-level make.
1515 Set up the pipe and install the fds option for our children. */
1521 if (pipe (job_fds
) < 0 || (job_rfd
= dup (job_fds
[0])) < 0)
1522 pfatal_with_name (_("creating jobs pipe"));
1524 /* Every make assumes that it always has one job it can run. For the
1525 submakes it's the token they were given by their parent. For the
1526 top make, we just subtract one from the number the user wants. We
1527 want job_slots to be 0 to indicate we're using the jobserver. */
1530 while (write (job_fds
[1], &c
, 1) != 1)
1532 pfatal_with_name (_("init jobserver pipe"));
1534 /* Fill in the jobserver_fds struct for our children. */
1536 jobserver_fds
= (struct stringlist
*)
1537 xmalloc (sizeof (struct stringlist
));
1538 jobserver_fds
->list
= (char **) xmalloc (sizeof (char *));
1539 jobserver_fds
->list
[0] = xmalloc ((sizeof ("1024")*2)+1);
1541 sprintf (jobserver_fds
->list
[0], "%d,%d", job_fds
[0], job_fds
[1]);
1542 jobserver_fds
->idx
= 1;
1543 jobserver_fds
->max
= 1;
1547 /* Set up MAKEFLAGS and MFLAGS again, so they will be right. */
1549 define_makeflags (1, 0);
1551 /* Make each `struct dep' point at the `struct file' for the file
1552 depended on. Also do magic for special targets. */
1556 /* Convert old-style suffix rules to pattern rules. It is important to
1557 do this before installing the built-in pattern rules below, so that
1558 makefile-specified suffix rules take precedence over built-in pattern
1561 convert_to_pattern ();
1563 /* Install the default implicit pattern rules.
1564 This used to be done before reading the makefiles.
1565 But in that case, built-in pattern rules were in the chain
1566 before user-defined ones, so they matched first. */
1568 install_default_implicit_rules ();
1570 /* Compute implicit rule limits. */
1572 count_implicit_rule_limits ();
1574 /* Construct the listings of directories in VPATH lists. */
1576 build_vpath_lists ();
1578 /* Mark files given with -o flags as very old
1579 and as having been updated already, and files given with -W flags as
1580 brand new (time-stamp as far as possible into the future). */
1583 for (p
= old_files
->list
; *p
!= 0; ++p
)
1585 f
= enter_command_line_file (*p
);
1586 f
->last_mtime
= f
->mtime_before_update
= OLD_MTIME
;
1588 f
->update_status
= 0;
1589 f
->command_state
= cs_finished
;
1594 for (p
= new_files
->list
; *p
!= 0; ++p
)
1596 f
= enter_command_line_file (*p
);
1597 f
->last_mtime
= f
->mtime_before_update
= NEW_MTIME
;
1601 /* Initialize the remote job module. */
1604 if (read_makefiles
!= 0)
1606 /* Update any makefiles if necessary. */
1608 FILE_TIMESTAMP
*makefile_mtimes
= 0;
1609 unsigned int mm_idx
= 0;
1610 char **nargv
= argv
;
1612 int orig_db_level
= db_level
;
1614 if (! ISDB (DB_MAKEFILES
))
1617 DB (DB_BASIC
, (_("Updating makefiles....\n")));
1619 /* Remove any makefiles we don't want to try to update.
1620 Also record the current modtimes so we can compare them later. */
1622 register struct dep
*d
, *last
;
1627 register struct file
*f
= d
->file
;
1628 if (f
->double_colon
)
1629 for (f
= f
->double_colon
; f
!= NULL
; f
= f
->prev
)
1631 if (f
->deps
== 0 && f
->cmds
!= 0)
1633 /* This makefile is a :: target with commands, but
1634 no dependencies. So, it will always be remade.
1635 This might well cause an infinite loop, so don't
1636 try to remake it. (This will only happen if
1637 your makefiles are written exceptionally
1638 stupidly; but if you work for Athena, that's how
1639 you write your makefiles.) */
1642 (_("Makefile `%s' might loop; not remaking it.\n"),
1646 read_makefiles
= d
->next
;
1648 last
->next
= d
->next
;
1650 /* Free the storage. */
1653 d
= last
== 0 ? read_makefiles
: last
->next
;
1658 if (f
== NULL
|| !f
->double_colon
)
1660 makefile_mtimes
= (FILE_TIMESTAMP
*)
1661 xrealloc ((char *) makefile_mtimes
,
1662 (mm_idx
+ 1) * sizeof (FILE_TIMESTAMP
));
1663 makefile_mtimes
[mm_idx
++] = file_mtime_no_search (d
->file
);
1670 /* Set up `MAKEFLAGS' specially while remaking makefiles. */
1671 define_makeflags (1, 1);
1673 switch (update_goal_chain (read_makefiles
, 1))
1677 #define BOGUS_UPDATE_STATUS 0
1678 assert (BOGUS_UPDATE_STATUS
);
1686 /* Failed to update. Figure out if we care. */
1688 /* Nonzero if any makefile was successfully remade. */
1690 /* Nonzero if any makefile we care about failed
1691 in updating or could not be found at all. */
1693 register unsigned int i
;
1696 for (i
= 0, d
= read_makefiles
; d
!= 0; ++i
, d
= d
->next
)
1698 /* Reset the considered flag; we may need to look at the file
1699 again to print an error. */
1700 d
->file
->considered
= 0;
1702 if (d
->file
->updated
)
1704 /* This makefile was updated. */
1705 if (d
->file
->update_status
== 0)
1707 /* It was successfully updated. */
1708 any_remade
|= (file_mtime_no_search (d
->file
)
1709 != makefile_mtimes
[i
]);
1711 else if (! (d
->changed
& RM_DONTCARE
))
1713 FILE_TIMESTAMP mtime
;
1714 /* The update failed and this makefile was not
1715 from the MAKEFILES variable, so we care. */
1716 error (NILF
, _("Failed to remake makefile `%s'."),
1718 mtime
= file_mtime_no_search (d
->file
);
1719 any_remade
|= (mtime
!= NONEXISTENT_MTIME
1720 && mtime
!= makefile_mtimes
[i
]);
1724 /* This makefile was not found at all. */
1725 if (! (d
->changed
& RM_DONTCARE
))
1727 /* This is a makefile we care about. See how much. */
1728 if (d
->changed
& RM_INCLUDED
)
1729 /* An included makefile. We don't need
1730 to die, but we do want to complain. */
1732 _("Included makefile `%s' was not found."),
1736 /* A normal makefile. We must die later. */
1737 error (NILF
, _("Makefile `%s' was not found"),
1743 /* Reset this to empty so we get the right error message below. */
1755 /* Updated successfully. Re-exec ourselves. */
1757 remove_intermediates (0);
1759 if (print_data_base_flag
)
1762 log_working_directory (0);
1766 /* These names might have changed. */
1767 register unsigned int i
, j
= 0;
1768 for (i
= 1; i
< argc
; ++i
)
1769 if (strneq (argv
[i
], "-f", 2)) /* XXX */
1771 char *p
= &argv
[i
][2];
1773 argv
[++i
] = makefiles
->list
[j
];
1775 argv
[i
] = concat ("-f", makefiles
->list
[j
], "");
1780 /* Add -o option for the stdin temporary file, if necessary. */
1783 nargv
= (char **) xmalloc ((nargc
+ 2) * sizeof (char *));
1784 bcopy ((char *) argv
, (char *) nargv
, argc
* sizeof (char *));
1785 nargv
[nargc
++] = concat ("-o", stdin_nm
, "");
1789 if (directories
!= 0 && directories
->idx
> 0)
1792 if (directory_before_chdir
!= 0)
1794 if (chdir (directory_before_chdir
) < 0)
1796 perror_with_name ("chdir", "");
1805 fatal (NILF
, _("Couldn't change back to original directory."));
1809 for (p
= environ
; *p
!= 0; ++p
)
1810 if (strneq (*p
, "MAKELEVEL=", 10))
1812 /* The SGI compiler apparently can't understand
1813 the concept of storing the result of a function
1814 in something other than a local variable. */
1816 sgi_loses
= (char *) alloca (40);
1818 sprintf (*p
, "MAKELEVEL=%u", makelevel
);
1826 len
= GetVar ("MAKELEVEL", buffer
, sizeof (buffer
), GVF_GLOBAL_ONLY
);
1830 sprintf (buffer
, "%u", makelevel
);
1831 SetVar ("MAKELEVEL", buffer
, -1, GVF_GLOBAL_ONLY
);
1836 if (ISDB (DB_BASIC
))
1839 fputs (_("Re-executing:"), stdout
);
1840 for (p
= nargv
; *p
!= 0; ++p
)
1848 /* Close the dup'd jobserver pipe if we opened one. */
1853 exec_command (nargv
, environ
);
1855 exec_command (nargv
);
1861 db_level
= orig_db_level
;
1864 /* Set up `MAKEFLAGS' again for the normal targets. */
1865 define_makeflags (1, 0);
1867 /* If there is a temp file from reading a makefile from stdin, get rid of
1869 if (stdin_nm
&& unlink (stdin_nm
) < 0 && errno
!= ENOENT
)
1870 perror_with_name (_("unlink (temporary file): "), stdin_nm
);
1875 /* If there were no command-line goals, use the default. */
1878 if (default_goal_file
!= 0)
1880 goals
= (struct dep
*) xmalloc (sizeof (struct dep
));
1883 goals
->file
= default_goal_file
;
1891 if (read_makefiles
== 0)
1892 fatal (NILF
, _("No targets specified and no makefile found"));
1894 fatal (NILF
, _("No targets"));
1897 /* Update the goals. */
1899 DB (DB_BASIC
, (_("Updating goal targets....\n")));
1901 switch (update_goal_chain (goals
, 0))
1904 /* Nothing happened. */
1906 /* Updated successfully. */
1907 status
= MAKE_SUCCESS
;
1910 /* We are under -q and would run some commands. */
1911 status
= MAKE_TROUBLE
;
1914 /* Updating failed. POSIX.2 specifies exit status >1 for this;
1915 but in VMS, there is only success and failure. */
1916 status
= MAKE_FAILURE
;
1922 /* If we detected some clock skew, generate one last warning */
1923 if (clock_skew_detected
)
1925 _("warning: Clock skew detected. Your build may be incomplete."));
1934 /* Parsing of arguments, decoding of switches. */
1936 static char options
[1 + sizeof (switches
) / sizeof (switches
[0]) * 3];
1937 static struct option long_options
[(sizeof (switches
) / sizeof (switches
[0])) +
1938 (sizeof (long_option_aliases
) /
1939 sizeof (long_option_aliases
[0]))];
1941 /* Fill in the string and vector for getopt. */
1947 register unsigned int i
;
1949 if (options
[0] != '\0')
1955 /* Return switch and non-switch args in order, regardless of
1956 POSIXLY_CORRECT. Non-switch args are returned as option 1. */
1959 for (i
= 0; switches
[i
].c
!= '\0'; ++i
)
1961 long_options
[i
].name
= (switches
[i
].long_name
== 0 ? "" :
1962 switches
[i
].long_name
);
1963 long_options
[i
].flag
= 0;
1964 long_options
[i
].val
= switches
[i
].c
;
1965 if (short_option (switches
[i
].c
))
1966 *p
++ = switches
[i
].c
;
1967 switch (switches
[i
].type
)
1972 long_options
[i
].has_arg
= no_argument
;
1978 if (short_option (switches
[i
].c
))
1980 if (switches
[i
].noarg_value
!= 0)
1982 if (short_option (switches
[i
].c
))
1984 long_options
[i
].has_arg
= optional_argument
;
1987 long_options
[i
].has_arg
= required_argument
;
1992 for (c
= 0; c
< (sizeof (long_option_aliases
) /
1993 sizeof (long_option_aliases
[0]));
1995 long_options
[i
++] = long_option_aliases
[c
];
1996 long_options
[i
].name
= 0;
2000 handle_non_switch_argument (arg
, env
)
2004 /* Non-option argument. It might be a variable definition. */
2006 if (arg
[0] == '-' && arg
[1] == '\0')
2007 /* Ignore plain `-' for compatibility. */
2009 v
= try_variable_definition (0, arg
, o_command
, 0);
2012 /* It is indeed a variable definition. Record a pointer to
2013 the variable for later use in define_makeflags. */
2014 struct command_variable
*cv
2015 = (struct command_variable
*) xmalloc (sizeof (*cv
));
2017 cv
->next
= command_variables
;
2018 command_variables
= cv
;
2022 /* Not an option or variable definition; it must be a goal
2023 target! Enter it as a file and add it to the dep chain of
2025 struct file
*f
= enter_command_line_file (arg
);
2030 goals
= (struct dep
*) xmalloc (sizeof (struct dep
));
2035 lastgoal
->next
= (struct dep
*) xmalloc (sizeof (struct dep
));
2036 lastgoal
= lastgoal
->next
;
2042 /* Add this target name to the MAKECMDGOALS variable. */
2046 v
= lookup_variable ("MAKECMDGOALS", 12);
2051 /* Paste the old and new values together */
2052 unsigned int oldlen
, newlen
;
2054 oldlen
= strlen (v
->value
);
2055 newlen
= strlen (f
->name
);
2056 value
= (char *) alloca (oldlen
+ 1 + newlen
+ 1);
2057 bcopy (v
->value
, value
, oldlen
);
2058 value
[oldlen
] = ' ';
2059 bcopy (f
->name
, &value
[oldlen
+ 1], newlen
+ 1);
2061 define_variable ("MAKECMDGOALS", 12, value
, o_default
, 0);
2066 /* Print a nice usage method. */
2072 register const struct command_switch
*cs
;
2075 if (print_version_flag
)
2078 usageto
= bad
? stderr
: stdout
;
2080 fprintf (usageto
, _("Usage: %s [options] [target] ...\n"), program
);
2082 fputs (_("Options:\n"), usageto
);
2083 for (cs
= switches
; cs
->c
!= '\0'; ++cs
)
2085 char buf
[1024], shortarg
[50], longarg
[50], *p
;
2087 if (!cs
->description
|| cs
->description
[0] == '-')
2090 switch (long_options
[cs
- switches
].has_arg
)
2093 shortarg
[0] = longarg
[0] = '\0';
2095 case required_argument
:
2096 sprintf (longarg
, "=%s", gettext (cs
->argdesc
));
2097 sprintf (shortarg
, " %s", gettext (cs
->argdesc
));
2099 case optional_argument
:
2100 sprintf (longarg
, "[=%s]", gettext (cs
->argdesc
));
2101 sprintf (shortarg
, " [%s]", gettext (cs
->argdesc
));
2107 if (short_option (cs
->c
))
2109 sprintf (buf
, " -%c%s", cs
->c
, shortarg
);
2112 if (cs
->long_name
!= 0)
2115 sprintf (p
, "%s--%s%s",
2116 !short_option (cs
->c
) ? " " : ", ",
2117 cs
->long_name
, longarg
);
2119 for (i
= 0; i
< (sizeof (long_option_aliases
) /
2120 sizeof (long_option_aliases
[0]));
2122 if (long_option_aliases
[i
].val
== cs
->c
)
2124 sprintf (p
, ", --%s%s",
2125 long_option_aliases
[i
].name
, longarg
);
2130 const struct command_switch
*ncs
= cs
;
2131 while ((++ncs
)->c
!= '\0')
2132 if (ncs
->description
2133 && ncs
->description
[0] == '-'
2134 && ncs
->description
[1] == cs
->c
)
2136 /* This is another switch that does the same
2137 one as the one we are processing. We want
2138 to list them all together on one line. */
2139 sprintf (p
, ", -%c%s", ncs
->c
, shortarg
);
2141 if (ncs
->long_name
!= 0)
2143 sprintf (p
, ", --%s%s", ncs
->long_name
, longarg
);
2149 if (p
- buf
> DESCRIPTION_COLUMN
- 2)
2150 /* The list of option names is too long to fit on the same
2151 line with the description, leaving at least two spaces.
2152 Print it on its own line instead. */
2154 fprintf (usageto
, "%s\n", buf
);
2158 fprintf (usageto
, "%*s%s.\n",
2159 - DESCRIPTION_COLUMN
,
2160 buf
, gettext (cs
->description
));
2163 fprintf (usageto
, _("\nReport bugs to <bug-make@gnu.org>.\n"));
2166 /* Decode switches from ARGC and ARGV.
2167 They came from the environment if ENV is nonzero. */
2170 decode_switches (argc
, argv
, env
)
2176 register const struct command_switch
*cs
;
2177 register struct stringlist
*sl
;
2180 /* getopt does most of the parsing for us.
2181 First, get its vectors set up. */
2185 /* Let getopt produce error messages for the command line,
2186 but not for options from the environment. */
2188 /* Reset getopt's state. */
2191 while (optind
< argc
)
2193 /* Parse the next argument. */
2194 c
= getopt_long (argc
, argv
, options
, long_options
, (int *) 0);
2196 /* End of arguments, or "--" marker seen. */
2199 /* An argument not starting with a dash. */
2200 handle_non_switch_argument (optarg
, env
);
2202 /* Bad option. We will print a usage message and die later.
2203 But continue to parse the other options so the user can
2204 see all he did wrong. */
2207 for (cs
= switches
; cs
->c
!= '\0'; ++cs
)
2210 /* Whether or not we will actually do anything with
2211 this switch. We test this individually inside the
2212 switch below rather than just once outside it, so that
2213 options which are to be ignored still consume args. */
2214 int doit
= !env
|| cs
->env
;
2227 *(int *) cs
->value_ptr
= cs
->type
== flag
;
2235 optarg
= cs
->noarg_value
;
2237 sl
= *(struct stringlist
**) cs
->value_ptr
;
2240 sl
= (struct stringlist
*)
2241 xmalloc (sizeof (struct stringlist
));
2244 sl
->list
= (char **) xmalloc (5 * sizeof (char *));
2245 *(struct stringlist
**) cs
->value_ptr
= sl
;
2247 else if (sl
->idx
== sl
->max
- 1)
2250 sl
->list
= (char **)
2251 xrealloc ((char *) sl
->list
,
2252 sl
->max
* sizeof (char *));
2254 sl
->list
[sl
->idx
++] = optarg
;
2255 sl
->list
[sl
->idx
] = 0;
2259 /* See if we have an option argument; if we do require that
2260 it's all digits, not something like "10foo". */
2261 if (optarg
== 0 && argc
> optind
)
2264 for (cp
=argv
[optind
]; ISDIGIT (cp
[0]); ++cp
)
2267 optarg
= argv
[optind
++];
2275 int i
= atoi (optarg
);
2278 /* Yes, I realize we're repeating this in some cases. */
2279 for (cp
= optarg
; ISDIGIT (cp
[0]); ++cp
)
2282 if (i
< 1 || cp
[0] != '\0')
2284 error (NILF
, _("the `-%c' option requires a positive integral argument"),
2289 *(unsigned int *) cs
->value_ptr
= i
;
2292 *(unsigned int *) cs
->value_ptr
2293 = *(unsigned int *) cs
->noarg_value
;
2298 if (optarg
== 0 && optind
< argc
2299 && (ISDIGIT (argv
[optind
][0]) || argv
[optind
][0] == '.'))
2300 optarg
= argv
[optind
++];
2303 *(double *) cs
->value_ptr
2304 = (optarg
!= 0 ? atof (optarg
)
2305 : *(double *) cs
->noarg_value
);
2311 /* We've found the switch. Stop looking. */
2316 /* There are no more options according to getting getopt, but there may
2317 be some arguments left. Since we have asked for non-option arguments
2318 to be returned in order, this only happens when there is a "--"
2319 argument to prevent later arguments from being options. */
2320 while (optind
< argc
)
2321 handle_non_switch_argument (argv
[optind
++], env
);
2324 if (!env
&& (bad
|| print_usage_flag
))
2331 /* Decode switches from environment variable ENVAR (which is LEN chars long).
2332 We do this by chopping the value into a vector of words, prepending a
2333 dash to the first word if it lacks one, and passing the vector to
2337 decode_env_switches (envar
, len
)
2341 char *varref
= (char *) alloca (2 + len
+ 2);
2346 /* Get the variable's value. */
2349 bcopy (envar
, &varref
[2], len
);
2350 varref
[2 + len
] = ')';
2351 varref
[2 + len
+ 1] = '\0';
2352 value
= variable_expand (varref
);
2354 /* Skip whitespace, and check for an empty value. */
2355 value
= next_token (value
);
2356 len
= strlen (value
);
2360 /* Allocate a vector that is definitely big enough. */
2361 argv
= (char **) alloca ((1 + len
+ 1) * sizeof (char *));
2363 /* Allocate a buffer to copy the value into while we split it into words
2364 and unquote it. We must use permanent storage for this because
2365 decode_switches may store pointers into the passed argument words. */
2366 p
= (char *) xmalloc (2 * len
);
2368 /* getopt will look at the arguments starting at ARGV[1].
2369 Prepend a spacer word. */
2373 while (*value
!= '\0')
2375 if (*value
== '\\' && value
[1] != '\0')
2376 ++value
; /* Skip the backslash. */
2377 else if (isblank ((unsigned char)*value
))
2379 /* End of the word. */
2384 while (isblank ((unsigned char)*value
));
2392 if (argv
[1][0] != '-' && strchr (argv
[1], '=') == 0)
2393 /* The first word doesn't start with a dash and isn't a variable
2394 definition. Add a dash and pass it along to decode_switches. We
2395 need permanent storage for this in case decode_switches saves
2396 pointers into the value. */
2397 argv
[1] = concat ("-", argv
[1], "");
2399 /* Parse those words. */
2400 decode_switches (argc
, argv
, 1);
2403 /* Quote the string IN so that it will be interpreted as a single word with
2404 no magic by decode_env_switches; also double dollar signs to avoid
2405 variable expansion in make itself. Write the result into OUT, returning
2406 the address of the next character to be written.
2407 Allocating space for OUT twice the length of IN is always sufficient. */
2410 quote_for_env (out
, in
)
2417 else if (isblank ((unsigned char)*in
) || *in
== '\\')
2425 /* Define the MAKEFLAGS and MFLAGS variables to reflect the settings of the
2426 command switches. Include options with args if ALL is nonzero.
2427 Don't include options with the `no_makefile' flag set if MAKEFILE. */
2430 define_makeflags (all
, makefile
)
2433 static const char ref
[] = "$(MAKEOVERRIDES)";
2434 static const char posixref
[] = "$(-*-command-variables-*-)";
2435 register const struct command_switch
*cs
;
2441 /* We will construct a linked list of `struct flag's describing
2442 all the flags which need to go in MAKEFLAGS. Then, once we
2443 know how many there are and their lengths, we can put them all
2444 together in a string. */
2449 const struct command_switch
*cs
;
2452 struct flag
*flags
= 0;
2453 unsigned int flagslen
= 0;
2454 #define ADD_FLAG(ARG, LEN) \
2456 struct flag *new = (struct flag *) alloca (sizeof (struct flag)); \
2459 new->next = flags; \
2461 if (new->arg == 0) \
2462 ++flagslen; /* Just a single flag letter. */ \
2464 flagslen += 1 + 1 + 1 + 1 + 3 * (LEN); /* " -x foo" */ \
2465 if (!short_option (cs->c)) \
2466 /* This switch has no single-letter version, so we use the long. */ \
2467 flagslen += 2 + strlen (cs->long_name); \
2470 for (cs
= switches
; cs
->c
!= '\0'; ++cs
)
2471 if (cs
->toenv
&& (!makefile
|| !cs
->no_makefile
))
2482 if (!*(int *) cs
->value_ptr
== (cs
->type
== flag_off
)
2483 && (cs
->default_value
== 0
2484 || *(int *) cs
->value_ptr
!= *(int *) cs
->default_value
))
2491 if ((cs
->default_value
!= 0
2492 && (*(unsigned int *) cs
->value_ptr
2493 == *(unsigned int *) cs
->default_value
)))
2495 else if (cs
->noarg_value
!= 0
2496 && (*(unsigned int *) cs
->value_ptr
==
2497 *(unsigned int *) cs
->noarg_value
))
2498 ADD_FLAG ("", 0); /* Optional value omitted; see below. */
2499 else if (cs
->c
== 'j')
2500 /* Special case for `-j'. */
2504 char *buf
= (char *) alloca (30);
2505 sprintf (buf
, "%u", *(unsigned int *) cs
->value_ptr
);
2506 ADD_FLAG (buf
, strlen (buf
));
2515 if (cs
->default_value
!= 0
2516 && (*(double *) cs
->value_ptr
2517 == *(double *) cs
->default_value
))
2519 else if (cs
->noarg_value
!= 0
2520 && (*(double *) cs
->value_ptr
2521 == *(double *) cs
->noarg_value
))
2522 ADD_FLAG ("", 0); /* Optional value omitted; see below. */
2525 char *buf
= (char *) alloca (100);
2526 sprintf (buf
, "%g", *(double *) cs
->value_ptr
);
2527 ADD_FLAG (buf
, strlen (buf
));
2536 struct stringlist
*sl
= *(struct stringlist
**) cs
->value_ptr
;
2539 /* Add the elements in reverse order, because
2540 all the flags get reversed below; and the order
2541 matters for some switches (like -I). */
2542 register unsigned int i
= sl
->idx
;
2544 ADD_FLAG (sl
->list
[i
], strlen (sl
->list
[i
]));
2550 flagslen
+= 4 + sizeof posixref
; /* Four more for the possible " -- ". */
2554 /* Construct the value in FLAGSTRING.
2555 We allocate enough space for a preceding dash and trailing null. */
2556 flagstring
= (char *) alloca (1 + flagslen
+ 1);
2557 bzero (flagstring
, 1 + flagslen
+ 1);
2563 /* Add the flag letter or name to the string. */
2564 if (short_option (flags
->cs
->c
))
2565 *p
++ = flags
->cs
->c
;
2574 strcpy (p
, flags
->cs
->long_name
);
2577 if (flags
->arg
!= 0)
2579 /* A flag that takes an optional argument which in this case is
2580 omitted is specified by ARG being "". We must distinguish
2581 because a following flag appended without an intervening " -"
2582 is considered the arg for the first. */
2583 if (flags
->arg
[0] != '\0')
2585 /* Add its argument too. */
2586 *p
++ = !short_option (flags
->cs
->c
) ? '=' : ' ';
2587 p
= quote_for_env (p
, flags
->arg
);
2590 /* Write a following space and dash, for the next flag. */
2594 else if (!short_option (flags
->cs
->c
))
2597 /* Long options must each go in their own word,
2598 so we write the following space and dash. */
2602 flags
= flags
->next
;
2605 /* Define MFLAGS before appending variable definitions. */
2607 if (p
== &flagstring
[1])
2609 flagstring
[0] = '\0';
2610 else if (p
[-1] == '-')
2612 /* Kill the final space and dash. */
2617 /* Terminate the string. */
2620 /* Since MFLAGS is not parsed for flags, there is no reason to
2621 override any makefile redefinition. */
2622 (void) define_variable ("MFLAGS", 6, flagstring
, o_env
, 1);
2624 if (all
&& command_variables
!= 0)
2626 /* Now write a reference to $(MAKEOVERRIDES), which contains all the
2627 command-line variable definitions. */
2629 if (p
== &flagstring
[1])
2630 /* No flags written, so elide the leading dash already written. */
2634 /* Separate the variables from the switches with a "--" arg. */
2637 /* We did not already write a trailing " -". */
2641 /* There is a trailing " -"; fill it out to " -- ". */
2646 /* Copy in the string. */
2649 bcopy (posixref
, p
, sizeof posixref
- 1);
2650 p
+= sizeof posixref
- 1;
2654 bcopy (ref
, p
, sizeof ref
- 1);
2655 p
+= sizeof ref
- 1;
2658 else if (p
== &flagstring
[1])
2663 else if (p
[-1] == '-')
2664 /* Kill the final space and dash. */
2666 /* Terminate the string. */
2669 v
= define_variable ("MAKEFLAGS", 9,
2670 /* If there are switches, omit the leading dash
2671 unless it is a single long option with two
2673 &flagstring
[(flagstring
[0] == '-'
2674 && flagstring
[1] != '-')
2676 /* This used to use o_env, but that lost when a
2677 makefile defined MAKEFLAGS. Makefiles set
2678 MAKEFLAGS to add switches, but we still want
2679 to redefine its value with the full set of
2680 switches. Of course, an override or command
2681 definition will still take precedence. */
2684 /* The first time we are called, set MAKEFLAGS to always be exported.
2685 We should not do this again on the second call, because that is
2686 after reading makefiles which might have done `unexport MAKEFLAGS'. */
2687 v
->export
= v_export
;
2690 /* Print version information. */
2695 extern char *make_host
;
2696 static int printed_version
= 0;
2698 char *precede
= print_data_base_flag
? "# " : "";
2700 if (printed_version
)
2701 /* Do it only once. */
2704 printf ("%sGNU Make version %s", precede
, version_string
);
2705 if (remote_description
!= 0 && *remote_description
!= '\0')
2706 printf ("-%s", remote_description
);
2708 printf (_(", by Richard Stallman and Roland McGrath.\n\
2710 %sCopyright (C) 1988, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 2000\n\
2711 %s\tFree Software Foundation, Inc.\n\
2712 %sThis is free software; see the source for copying conditions.\n\
2713 %sThere is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A\n\
2714 %sPARTICULAR PURPOSE.\n\n\
2715 %sReport bugs to <bug-make@gnu.org>.\n\n"),
2717 precede
, precede
, precede
, precede
, precede
, precede
);
2719 printed_version
= 1;
2721 /* Flush stdout so the user doesn't have to wait to see the
2722 version information while things are thought about. */
2726 /* Print a bunch of information about this and that. */
2733 when
= time ((time_t *) 0);
2734 printf (_("\n# Make data base, printed on %s"), ctime (&when
));
2736 print_variable_data_base ();
2737 print_dir_data_base ();
2738 print_rule_data_base ();
2739 print_file_data_base ();
2740 print_vpath_data_base ();
2742 when
= time ((time_t *) 0);
2743 printf (_("\n# Finished Make data base on %s\n"), ctime (&when
));
2746 /* Exit with STATUS, cleaning up as necessary. */
2752 static char dying
= 0;
2760 if (print_version_flag
)
2763 /* Wait for children to die. */
2764 for (err
= (status
!= 0); job_slots_used
> 0; err
= 0)
2765 reap_children (1, err
);
2767 /* Let the remote job module clean up its state. */
2770 /* Remove the intermediate files. */
2771 remove_intermediates (0);
2773 if (print_data_base_flag
)
2776 /* Try to move back to the original directory. This is essential on
2777 MS-DOS (where there is really only one process), and on Unix it
2778 puts core files in the original directory instead of the -C
2779 directory. Must wait until after remove_intermediates(), or unlinks
2780 of relative pathnames fail. */
2781 if (directory_before_chdir
!= 0)
2782 chdir (directory_before_chdir
);
2784 log_working_directory (0);
2790 /* Write a message indicating that we've just entered or
2791 left (according to ENTERING) the current directory. */
2794 log_working_directory (entering
)
2797 static int entered
= 0;
2799 /* Print nothing without the flag. Don't print the entering message
2800 again if we already have. Don't print the leaving message if we
2801 haven't printed the entering message. */
2802 if (! print_directory_flag
|| entering
== entered
)
2807 if (print_data_base_flag
)
2808 fputs ("# ", stdout
);
2811 printf ("%s: ", program
);
2813 printf ("%s[%u]: ", program
, makelevel
);
2815 /* Use entire sentences to give the translators a fighting chance. */
2817 if (starting_directory
== 0)
2819 puts (_("Entering an unknown directory"));
2821 puts (_("Leaving an unknown directory"));
2824 printf (_("Entering directory `%s'\n"), starting_directory
);
2826 printf (_("Leaving directory `%s'\n"), starting_directory
);