1 /* shell.c -- GNU's idea of the POSIX shell specification. */
3 /* Copyright (C) 1987-2010 Free Software Foundation, Inc.
5 This file is part of GNU Bash, the Bourne Again SHell.
7 Bash is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 Bash is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with Bash. If not, see <http://www.gnu.org/licenses/>.
23 Sunday, January 10th, 1988.
24 Initial author: Brian Fox
26 #define INSTALL_DEBUG_MODE
30 #include "bashtypes.h"
31 #if !defined (_MINIX) && defined (HAVE_SYS_FILE_H)
32 # include <sys/file.h>
34 #include "posixstat.h"
35 #include "posixtime.h"
43 #if defined (HAVE_UNISTD_H)
49 #define NEED_SH_SETLINEBUF_DECL /* used in externs.h */
54 #include "mailcheck.h"
56 #include "builtins/common.h"
58 #if defined (JOB_CONTROL)
60 #endif /* JOB_CONTROL */
63 #include "execute_cmd.h"
66 #if defined (USING_BASH_MALLOC) && defined (DEBUG) && !defined (DISABLE_MALLOC_WRAPPERS)
67 # include <malloc/shmalloc.h>
71 # include "bashhist.h"
72 # include <readline/history.h>
75 #if defined (READLINE)
76 # include "bashline.h"
79 #include <tilde/tilde.h>
80 #include <glob/strmatch.h>
82 #if defined (__OPENNT)
83 # include <opennt/opennt.h>
86 #if !defined (HAVE_GETPW_DECLS)
87 extern struct passwd *getpwuid ();
88 #endif /* !HAVE_GETPW_DECLS */
94 #if defined (NO_MAIN_ENV_ARG)
95 extern char **environ; /* used if no third argument to main() */
98 extern char *dist_version, *release_status;
99 extern int patch_level, build_version;
100 extern int shell_level;
101 extern int subshell_environment;
102 extern int last_command_exit_value;
103 extern int line_number;
104 extern int expand_aliases;
105 extern int array_needs_making;
106 extern int gnu_error_format;
107 extern char *primary_prompt, *secondary_prompt;
108 extern char *this_command_name;
110 /* Non-zero means that this shell has already been run; i.e. you should
111 call shell_reinitialize () if you need to start afresh. */
112 int shell_initialized = 0;
114 COMMAND *global_command = (COMMAND *)NULL;
116 /* Information about the current user. */
117 struct user_info current_user =
119 (uid_t)-1, (uid_t)-1, (gid_t)-1, (gid_t)-1,
120 (char *)NULL, (char *)NULL, (char *)NULL
123 /* The current host's name. */
124 char *current_host_name = (char *)NULL;
126 /* Non-zero means that this shell is a login shell.
129 1 = login shell from getty (or equivalent fake out)
130 -1 = login shell from "--login" (or -l) flag.
131 -2 = both from getty, and from flag.
135 /* Non-zero means that at this moment, the shell is interactive. In
136 general, this means that the shell is at this moment reading input
137 from the keyboard. */
140 /* Non-zero means that the shell was started as an interactive shell. */
141 int interactive_shell = 0;
143 /* Non-zero means to send a SIGHUP to all jobs when an interactive login
147 /* Non-zero means to list status of running and stopped jobs at shell exit */
148 int check_jobs_at_exit = 0;
150 /* Non-zero means to change to a directory name supplied as a command name */
153 /* Tells what state the shell was in when it started:
154 0 = non-interactive shell script
157 3 = wordexp evaluation
158 This is a superset of the information provided by interactive_shell.
160 int startup_state = 0;
162 /* Special debugging helper. */
163 int debugging_login_shell = 0;
165 /* The environment that the shell passes to other commands. */
166 char **shell_environment;
168 /* Non-zero when we are executing a top-level command. */
171 /* The number of commands executed so far. */
172 int current_command_number = 1;
174 /* Non-zero is the recursion depth for commands. */
175 int indirection_level = 0;
177 /* The name of this shell, as taken from argv[0]. */
178 char *shell_name = (char *)NULL;
180 /* time in seconds when the shell was started */
181 time_t shell_start_time;
183 /* Are we running in an emacs shell window? */
184 int running_under_emacs;
186 /* Do we have /dev/fd? */
188 int have_devfd = HAVE_DEV_FD;
193 /* The name of the .(shell)rc file. */
194 static char *bashrc_file = "~/.bashrc";
196 /* Non-zero means to act more like the Bourne shell on startup. */
197 static int act_like_sh;
199 /* Non-zero if this shell is being run by `su'. */
202 /* Non-zero if we have already expanded and sourced $ENV. */
203 static int sourced_env;
205 /* Is this shell running setuid? */
206 static int running_setuid;
208 /* Values for the long-winded argument names. */
209 static int debugging; /* Do debugging things. */
210 static int no_rc; /* Don't execute ~/.bashrc */
211 static int no_profile; /* Don't execute .profile */
212 static int do_version; /* Display interesting version info. */
213 static int make_login_shell; /* Make this shell be a `-bash' shell. */
214 static int want_initial_help; /* --help option */
216 int debugging_mode = 0; /* In debugging mode with --debugger */
217 int no_line_editing = 0; /* Don't do fancy line editing. */
218 int dump_translatable_strings; /* Dump strings in $"...", don't execute. */
219 int dump_po_strings; /* Dump strings in $"..." in po format */
220 int wordexp_only = 0; /* Do word expansion only */
221 int protected_mode = 0; /* No command substitution with --wordexp */
223 #if defined (STRICT_POSIX)
224 int posixly_correct = 1; /* Non-zero means posix.2 superset. */
226 int posixly_correct = 0; /* Non-zero means posix.2 superset. */
229 /* Some long-winded argument names. These are obviously new. */
232 static const struct {
238 { "debug", Int, &debugging, (char **)0x0 },
239 #if defined (DEBUGGER)
240 { "debugger", Int, &debugging_mode, (char **)0x0 },
242 { "dump-po-strings", Int, &dump_po_strings, (char **)0x0 },
243 { "dump-strings", Int, &dump_translatable_strings, (char **)0x0 },
244 { "help", Int, &want_initial_help, (char **)0x0 },
245 { "init-file", Charp, (int *)0x0, &bashrc_file },
246 { "login", Int, &make_login_shell, (char **)0x0 },
247 { "noediting", Int, &no_line_editing, (char **)0x0 },
248 { "noprofile", Int, &no_profile, (char **)0x0 },
249 { "norc", Int, &no_rc, (char **)0x0 },
250 { "posix", Int, &posixly_correct, (char **)0x0 },
251 { "protected", Int, &protected_mode, (char **)0x0 },
252 { "rcfile", Charp, (int *)0x0, &bashrc_file },
253 #if defined (RESTRICTED_SHELL)
254 { "restricted", Int, &restricted, (char **)0x0 },
256 { "verbose", Int, &echo_input_at_read, (char **)0x0 },
257 { "version", Int, &do_version, (char **)0x0 },
258 #if defined (WORDEXP_OPTION)
259 { "wordexp", Int, &wordexp_only, (char **)0x0 },
261 { (char *)0x0, Int, (int *)0x0, (char **)0x0 }
264 /* These are extern so execute_simple_command can set them, and then
265 longjmp back to main to execute a shell script, instead of calling
266 main () again and resulting in indefinite, possibly fatal, stack
268 procenv_t subshell_top_level;
270 char **subshell_argv;
271 char **subshell_envp;
275 #if defined (BUFFERED_INPUT)
276 /* The file descriptor from which the shell is reading input. */
277 int default_buffered_input = -1;
280 /* The following two variables are not static so they can show up in $-. */
281 int read_from_stdin; /* -s flag supplied */
282 int want_pending_command; /* -c flag supplied */
284 /* This variable is not static so it can be bound to $BASH_EXECUTION_STRING */
285 char *command_execution_string; /* argument to -c option */
287 int malloc_trace_at_exit = 0;
289 static int shell_reinitialized = 0;
291 static FILE *default_input;
293 static STRING_INT_ALIST *shopt_alist;
294 static int shopt_ind = 0, shopt_len = 0;
296 static int parse_long_options __P((char **, int, int));
297 static int parse_shell_options __P((char **, int, int));
298 static int bind_args __P((char **, int, int, int));
300 static void start_debugger __P((void));
302 static void add_shopt_to_alist __P((char *, int));
303 static void run_shopt_alist __P((void));
305 static void execute_env_file __P((char *));
306 static void run_startup_files __P((void));
307 static int open_shell_script __P((char *));
308 static void set_bash_input __P((void));
309 static int run_one_command __P((char *));
310 #if defined (WORDEXP_OPTION)
311 static int run_wordexp __P((char *));
314 static int uidget __P((void));
316 static void init_interactive __P((void));
317 static void init_noninteractive __P((void));
318 static void init_interactive_script __P((void));
320 static void set_shell_name __P((char *));
321 static void shell_initialize __P((void));
322 static void shell_reinitialize __P((void));
324 static void show_shell_usage __P((FILE *, int));
328 _cygwin32_check_tmp ()
332 if (stat ("/tmp", &sb) < 0)
333 internal_warning (_("could not find /tmp, please create!"));
336 if (S_ISDIR (sb.st_mode) == 0)
337 internal_warning (_("/tmp must be a valid directory name"));
340 #endif /* __CYGWIN__ */
342 #if defined (NO_MAIN_ENV_ARG)
343 /* systems without third argument to main() */
348 #else /* !NO_MAIN_ENV_ARG */
350 main (argc, argv, env)
353 #endif /* !NO_MAIN_ENV_ARG */
356 int code, old_errexit_flag;
357 #if defined (RESTRICTED_SHELL)
360 volatile int locally_skip_execution;
361 volatile int arg_index, top_level_arg_index;
366 #endif /* __OPENNT */
372 USE_VAR(old_errexit_flag);
373 #if defined (RESTRICTED_SHELL)
377 /* Catch early SIGINTs. */
378 code = setjmp (top_level);
384 #if defined (USING_BASH_MALLOC) && defined (DEBUG) && !defined (DISABLE_MALLOC_WRAPPERS)
386 malloc_set_register (1);
393 _cygwin32_check_tmp ();
394 #endif /* __CYGWIN__ */
396 /* Wait forever if we are debugging a login shell. */
397 while (debugging_login_shell) sleep (3);
399 set_default_locale ();
401 running_setuid = uidget ();
403 if (getenv ("POSIXLY_CORRECT") || getenv ("POSIX_PEDANTIC"))
406 #if defined (USE_GNU_MALLOC_LIBRARY)
407 mcheck (programming_error, (void (*) ())0);
408 #endif /* USE_GNU_MALLOC_LIBRARY */
410 if (setjmp (subshell_top_level))
412 argc = subshell_argc;
413 argv = subshell_argv;
418 shell_reinitialized = 0;
420 /* Initialize `local' variables for all `invocations' of main (). */
422 if (arg_index > argc)
424 command_execution_string = (char *)NULL;
425 want_pending_command = locally_skip_execution = read_from_stdin = 0;
426 default_input = stdin;
427 #if defined (BUFFERED_INPUT)
428 default_buffered_input = -1;
431 /* Fix for the `infinite process creation' bug when running shell scripts
432 from startup files on System V. */
433 login_shell = make_login_shell = 0;
435 /* If this shell has already been run, then reinitialize it to a
437 if (shell_initialized || shell_name)
439 /* Make sure that we do not infinitely recurse as a login shell. */
440 if (*shell_name == '-')
443 shell_reinitialize ();
444 if (setjmp (top_level))
448 shell_environment = env;
449 set_shell_name (argv[0]);
450 shell_start_time = NOW; /* NOW now defined in general.h */
452 /* Parse argument flags from the input line. */
454 /* Find full word arguments first. */
455 arg_index = parse_long_options (argv, arg_index, argc);
457 if (want_initial_help)
459 show_shell_usage (stdout, 1);
460 exit (EXECUTION_SUCCESS);
465 show_shell_version (1);
466 exit (EXECUTION_SUCCESS);
469 /* All done with full word options; do standard shell option parsing.*/
470 this_command_name = shell_name; /* for error reporting */
471 arg_index = parse_shell_options (argv, arg_index, argc);
473 /* If user supplied the "--login" (or -l) flag, then set and invert
475 if (make_login_shell)
478 login_shell = -login_shell;
481 set_login_shell ("login_shell", login_shell != 0);
484 dump_translatable_strings = 1;
486 if (dump_translatable_strings)
487 read_but_dont_execute = 1;
489 if (running_setuid && privileged_mode == 0)
490 disable_priv_mode ();
492 /* Need to get the argument to a -c option processed in the
493 above loop. The next arg is a command to execute, and the
494 following args are $0...$n respectively. */
495 if (want_pending_command)
497 command_execution_string = argv[arg_index];
498 if (command_execution_string == 0)
500 report_error (_("%s: option requires an argument"), "-c");
505 this_command_name = (char *)NULL;
507 cmd_init(); /* initialize the command object caches */
509 /* First, let the outside world know about our interactive status.
510 A shell is interactive if the `-i' flag was given, or if all of
511 the following conditions are met:
513 no arguments remaining or the -s flag given
514 standard input is a terminal
515 standard error is a terminal
516 Refer to Posix.2, the description of the `sh' utility. */
518 if (forced_interactive || /* -i flag */
519 (!command_execution_string && /* No -c command and ... */
520 wordexp_only == 0 && /* No --wordexp and ... */
521 ((arg_index == argc) || /* no remaining args or... */
522 read_from_stdin) && /* -s flag with args, and */
523 isatty (fileno (stdin)) && /* Input is a terminal and */
524 isatty (fileno (stderr)))) /* error output is a terminal. */
527 init_noninteractive ();
530 * Some systems have the bad habit of starting login shells with lots of open
531 * file descriptors. For instance, most systems that have picked up the
532 * pre-4.0 Sun YP code leave a file descriptor open each time you call one
533 * of the getpw* functions, and it's set to be open across execs. That
534 * means one for login, one for xterm, one for shelltool, etc. There are
535 * also systems that open persistent FDs to other agents or files as part
536 * of process startup; these need to be set to be close-on-exec.
538 if (login_shell && interactive_shell)
540 for (i = 3; i < 20; i++)
541 SET_CLOSE_ON_EXEC (i);
544 /* If we're in a strict Posix.2 mode, turn on interactive comments,
545 alias expansion in non-interactive shells, and other Posix.2 things. */
548 bind_variable ("POSIXLY_CORRECT", "y", 0);
549 sv_strict_posix ("POSIXLY_CORRECT");
552 /* Now we run the shopt_alist and process the options. */
556 /* From here on in, the shell must be a normal functioning shell.
557 Variables from the environment are expected to be set, etc. */
561 set_default_locale_vars ();
564 * M-x term -> TERM=eterm EMACS=22.1 (term:0.96) (eterm)
565 * M-x shell -> TERM=dumb EMACS=t (no line editing)
566 * M-x terminal -> TERM=emacs-em7955 EMACS= (line editing)
568 if (interactive_shell)
572 term = get_string_value ("TERM");
573 emacs = get_string_value ("EMACS");
575 /* Not sure any emacs terminal emulator sets TERM=emacs any more */
576 no_line_editing |= term && (STREQ (term, "emacs"));
577 no_line_editing |= emacs && emacs[0] == 't' && emacs[1] == '\0' && STREQ (term, "dumb");
579 /* running_under_emacs == 2 for `eterm' */
580 running_under_emacs = (emacs != 0) || (term && STREQN (term, "emacs", 5));
581 running_under_emacs += term && STREQN (term, "eterm", 5) && emacs && strstr (emacs, "term");
583 if (running_under_emacs)
584 gnu_error_format = 1;
587 top_level_arg_index = arg_index;
588 old_errexit_flag = exit_immediately_on_error;
590 /* Give this shell a place to longjmp to before executing the
591 startup files. This allows users to press C-c to abort the
593 code = setjmp (top_level);
596 if (code == EXITPROG || code == ERREXIT)
597 exit_shell (last_command_exit_value);
600 #if defined (JOB_CONTROL)
601 /* Reset job control, since run_startup_files turned it off. */
602 set_job_control (interactive_shell);
604 /* Reset value of `set -e', since it's turned off before running
605 the startup files. */
606 exit_immediately_on_error += old_errexit_flag;
607 locally_skip_execution++;
611 arg_index = top_level_arg_index;
613 /* Execute the start-up scripts. */
615 if (interactive_shell == 0)
617 unbind_variable ("PS1");
618 unbind_variable ("PS2");
621 /* This has already been done by init_noninteractive */
622 expand_aliases = posixly_correct;
627 change_flag ('i', FLAG_ON);
631 #if defined (RESTRICTED_SHELL)
632 /* Set restricted_shell based on whether the basename of $0 indicates that
633 the shell should be restricted or if the `-r' option was supplied at
635 restricted_shell = shell_is_restricted (shell_name);
637 /* If the `-r' option is supplied at invocation, make sure that the shell
638 is not in restricted mode when running the startup files. */
639 saverst = restricted;
643 /* The startup files are run with `set -e' temporarily disabled. */
644 if (locally_skip_execution == 0 && running_setuid == 0)
646 old_errexit_flag = exit_immediately_on_error;
647 exit_immediately_on_error = 0;
649 run_startup_files ();
650 exit_immediately_on_error += old_errexit_flag;
653 /* If we are invoked as `sh', turn on Posix mode. */
656 bind_variable ("POSIXLY_CORRECT", "y", 0);
657 sv_strict_posix ("POSIXLY_CORRECT");
660 #if defined (RESTRICTED_SHELL)
661 /* Turn on the restrictions after executing the startup files. This
662 means that `bash -r' or `set -r' invoked from a startup file will
663 turn on the restrictions after the startup files are executed. */
664 restricted = saverst || restricted;
665 if (shell_reinitialized == 0)
666 maybe_make_restricted (shell_name);
667 #endif /* RESTRICTED_SHELL */
669 #if defined (WORDEXP_OPTION)
673 last_command_exit_value = run_wordexp (argv[arg_index]);
674 exit_shell (last_command_exit_value);
678 if (command_execution_string)
680 arg_index = bind_args (argv, arg_index, argc, 0);
686 #if defined (ONESHOT)
688 run_one_command (command_execution_string);
689 exit_shell (last_command_exit_value);
691 with_input_from_string (command_execution_string, "-c");
692 goto read_and_execute;
693 #endif /* !ONESHOT */
696 /* Get possible input filename and set up default_buffered_input or
697 default_input as appropriate. */
698 if (arg_index != argc && read_from_stdin == 0)
700 open_shell_script (argv[arg_index]);
703 else if (interactive == 0)
704 /* In this mode, bash is reading a script from stdin, which is a
705 pipe or redirected file. */
706 #if defined (BUFFERED_INPUT)
707 default_buffered_input = fileno (stdin); /* == 0 */
709 setbuf (default_input, (char *)NULL);
710 #endif /* !BUFFERED_INPUT */
714 /* Bind remaining args to $1 ... $n */
715 arg_index = bind_args (argv, arg_index, argc, 1);
717 if (debugging_mode && locally_skip_execution == 0 && running_setuid == 0)
720 /* Do the things that should be done only for interactive shells. */
721 if (interactive_shell)
723 /* Set up for checking for presence of mail. */
727 #if defined (HISTORY)
728 /* Initialize the interactive history stuff. */
729 bash_initialize_history ();
730 /* Don't load the history from the history file if we've already
731 saved some lines in this session (e.g., by putting `history -s xx'
732 into one of the startup files). */
733 if (shell_initialized == 0 && history_lines_this_session == 0)
737 /* Initialize terminal state for interactive shells after the
738 .bash_profile and .bashrc are interpreted. */
742 #if !defined (ONESHOT)
744 #endif /* !ONESHOT */
746 shell_initialized = 1;
748 /* Read commands until exit condition. */
750 exit_shell (last_command_exit_value);
754 parse_long_options (argv, arg_start, arg_end)
756 int arg_start, arg_end;
758 int arg_index, longarg, i;
761 arg_index = arg_start;
762 while ((arg_index != arg_end) && (arg_string = argv[arg_index]) &&
763 (*arg_string == '-'))
767 /* Make --login equivalent to -login. */
768 if (arg_string[1] == '-' && arg_string[2])
774 for (i = 0; long_args[i].name; i++)
776 if (STREQ (arg_string + 1, long_args[i].name))
778 if (long_args[i].type == Int)
779 *long_args[i].int_value = 1;
780 else if (argv[++arg_index] == 0)
782 report_error (_("%s: option requires an argument"), long_args[i].name);
786 *long_args[i].char_value = argv[arg_index];
791 if (long_args[i].name == 0)
795 report_error (_("%s: invalid option"), argv[arg_index]);
796 show_shell_usage (stderr, 0);
799 break; /* No such argument. Maybe flag arg. */
809 parse_shell_options (argv, arg_start, arg_end)
811 int arg_start, arg_end;
814 int arg_character, on_or_off, next_arg, i;
815 char *o_option, *arg_string;
817 arg_index = arg_start;
818 while (arg_index != arg_end && (arg_string = argv[arg_index]) &&
819 (*arg_string == '-' || *arg_string == '+'))
821 /* There are flag arguments, so parse them. */
822 next_arg = arg_index + 1;
824 /* A single `-' signals the end of options. From the 4.3 BSD sh.
825 An option `--' means the same thing; this is the standard
826 getopt(3) meaning. */
827 if (arg_string[0] == '-' &&
828 (arg_string[1] == '\0' ||
829 (arg_string[1] == '-' && arg_string[2] == '\0')))
833 on_or_off = arg_string[0];
834 while (arg_character = arg_string[i++])
836 switch (arg_character)
839 want_pending_command = 1;
843 make_login_shell = 1;
851 o_option = argv[next_arg];
854 list_minus_o_opts (-1, (on_or_off == '-') ? 0 : 1);
857 if (set_minus_o_option (on_or_off, o_option) != EXECUTION_SUCCESS)
863 /* Since some of these can be overridden by the normal
864 interactive/non-interactive shell initialization or
865 initializing posix mode, we save the options and process
866 them after initialization. */
867 o_option = argv[next_arg];
870 shopt_listopt (o_option, (on_or_off == '-') ? 0 : 1);
873 add_shopt_to_alist (o_option, on_or_off);
878 dump_translatable_strings = 1;
882 if (change_flag (arg_character, on_or_off) == FLAG_ERROR)
884 report_error (_("%c%c: invalid option"), on_or_off, arg_character);
885 show_shell_usage (stderr, 0);
890 /* Can't do just a simple increment anymore -- what about
891 "bash -abouo emacs ignoreeof -hP"? */
892 arg_index = next_arg;
898 /* Exit the shell with status S. */
903 fflush (stdout); /* XXX */
906 /* Do trap[0] if defined. Allow it to override the exit status
908 if (signal_is_trapped (0))
909 s = run_exit_trap ();
911 #if defined (PROCESS_SUBSTITUTION)
913 #endif /* PROCESS_SUBSTITUTION */
915 #if defined (HISTORY)
916 if (interactive_shell)
917 maybe_save_shell_history ();
920 #if defined (COPROCESS_SUPPORT)
924 #if defined (JOB_CONTROL)
925 /* If the user has run `shopt -s huponexit', hangup all jobs when we exit
926 an interactive login shell. ksh does this unconditionally. */
927 if (interactive_shell && login_shell && hup_on_exit)
930 /* If this shell is interactive, terminate all stopped jobs and
931 restore the original terminal process group. Don't do this if we're
932 in a subshell and calling exit_shell after, for example, a failed
934 if (subshell_environment == 0)
936 #endif /* JOB_CONTROL */
938 /* Always return the exit status of the last command to our parent. */
942 /* A wrapper for exit that (optionally) can do other things, like malloc
943 statistics tracing. */
948 #if defined (MALLOC_DEBUG) && defined (USING_BASH_MALLOC)
949 if (malloc_trace_at_exit)
950 trace_malloc_stats (get_name_for_error (), (char *)NULL);
956 /* Source the bash startup files. If POSIXLY_CORRECT is non-zero, we obey
957 the Posix.2 startup file rules: $ENV is expanded, and if the file it
958 names exists, that file is sourced. The Posix.2 rules are in effect
959 for interactive shells only. (section 4.56.5.3) */
961 /* Execute ~/.bashrc for most shells. Never execute it if
962 ACT_LIKE_SH is set, or if NO_RC is set.
964 If the executable file "/usr/gnu/src/bash/foo" contains:
971 COMMAND EXECUTE BASHRC
972 --------------------------------
976 rsh machine ls YES (for rsh, which calls `bash -c')
977 rsh machine foo YES (for shell started by rsh) NO (for foo!)
984 execute_env_file (env_file)
989 if (env_file && *env_file)
991 fn = expand_string_unsplit_to_string (env_file, Q_DOUBLE_QUOTES);
993 maybe_execute_file (fn, 1);
1001 #if defined (JOB_CONTROL)
1002 int old_job_control;
1004 int sourced_login, run_by_ssh;
1006 /* get the rshd/sshd case out of the way first. */
1007 if (interactive_shell == 0 && no_rc == 0 && login_shell == 0 &&
1008 act_like_sh == 0 && command_execution_string)
1010 #ifdef SSH_SOURCE_BASHRC
1011 run_by_ssh = (find_variable ("SSH_CLIENT") != (SHELL_VAR *)0) ||
1012 (find_variable ("SSH2_CLIENT") != (SHELL_VAR *)0);
1017 /* If we were run by sshd or we think we were run by rshd, execute
1018 ~/.bashrc if we are a top-level shell. */
1019 if ((run_by_ssh || isnetconn (fileno (stdin))) && shell_level < 2)
1022 # if defined (__OPENNT)
1023 maybe_execute_file (_prefixInstallPath(SYS_BASHRC, NULL, 0), 1);
1025 maybe_execute_file (SYS_BASHRC, 1);
1028 maybe_execute_file (bashrc_file, 1);
1033 #if defined (JOB_CONTROL)
1034 /* Startup files should be run without job control enabled. */
1035 old_job_control = interactive_shell ? set_job_control (0) : 0;
1040 /* A shell begun with the --login (or -l) flag that is not in posix mode
1041 runs the login shell startup files, no matter whether or not it is
1042 interactive. If NON_INTERACTIVE_LOGIN_SHELLS is defined, run the
1043 startup files if argv[0][0] == '-' as well. */
1044 #if defined (NON_INTERACTIVE_LOGIN_SHELLS)
1045 if (login_shell && posixly_correct == 0)
1047 if (login_shell < 0 && posixly_correct == 0)
1050 /* We don't execute .bashrc for login shells. */
1053 /* Execute /etc/profile and one of the personal login shell
1054 initialization files. */
1055 if (no_profile == 0)
1057 maybe_execute_file (SYS_PROFILE, 1);
1059 if (act_like_sh) /* sh */
1060 maybe_execute_file ("~/.profile", 1);
1061 else if ((maybe_execute_file ("~/.bash_profile", 1) == 0) &&
1062 (maybe_execute_file ("~/.bash_login", 1) == 0)) /* bash */
1063 maybe_execute_file ("~/.profile", 1);
1069 /* A non-interactive shell not named `sh' and not in posix mode reads and
1070 executes commands from $BASH_ENV. If `su' starts a shell with `-c cmd'
1071 and `-su' as the name of the shell, we want to read the startup files.
1072 No other non-interactive shells read any startup files. */
1073 if (interactive_shell == 0 && !(su_shell && login_shell))
1075 if (posixly_correct == 0 && act_like_sh == 0 && privileged_mode == 0 &&
1077 execute_env_file (get_string_value ("BASH_ENV"));
1081 /* Interactive shell or `-su' shell. */
1082 if (posixly_correct == 0) /* bash, sh */
1084 if (login_shell && sourced_login++ == 0)
1086 /* We don't execute .bashrc for login shells. */
1089 /* Execute /etc/profile and one of the personal login shell
1090 initialization files. */
1091 if (no_profile == 0)
1093 maybe_execute_file (SYS_PROFILE, 1);
1095 if (act_like_sh) /* sh */
1096 maybe_execute_file ("~/.profile", 1);
1097 else if ((maybe_execute_file ("~/.bash_profile", 1) == 0) &&
1098 (maybe_execute_file ("~/.bash_login", 1) == 0)) /* bash */
1099 maybe_execute_file ("~/.profile", 1);
1104 if (act_like_sh == 0 && no_rc == 0)
1107 # if defined (__OPENNT)
1108 maybe_execute_file (_prefixInstallPath(SYS_BASHRC, NULL, 0), 1);
1110 maybe_execute_file (SYS_BASHRC, 1);
1113 maybe_execute_file (bashrc_file, 1);
1116 else if (act_like_sh && privileged_mode == 0 && sourced_env++ == 0)
1117 execute_env_file (get_string_value ("ENV"));
1119 else /* bash --posix, sh --posix */
1122 if (interactive_shell && privileged_mode == 0 && sourced_env++ == 0)
1123 execute_env_file (get_string_value ("ENV"));
1126 #if defined (JOB_CONTROL)
1127 set_job_control (old_job_control);
1131 #if defined (RESTRICTED_SHELL)
1132 /* Return 1 if the shell should be a restricted one based on NAME or the
1133 value of `restricted'. Don't actually do anything, just return a
1136 shell_is_restricted (name)
1143 temp = base_pathname (name);
1146 return (STREQ (temp, RESTRICTED_SHELL_NAME));
1149 /* Perhaps make this shell a `restricted' one, based on NAME. If the
1150 basename of NAME is "rbash", then this shell is restricted. The
1151 name of the restricted shell is a configurable option, see config.h.
1152 In a restricted shell, PATH, SHELL, ENV, and BASH_ENV are read-only
1154 Do this also if `restricted' is already set to 1; maybe the shell was
1157 maybe_make_restricted (name)
1162 temp = base_pathname (name);
1165 if (restricted || (STREQ (temp, RESTRICTED_SHELL_NAME)))
1167 set_var_read_only ("PATH");
1168 set_var_read_only ("SHELL");
1169 set_var_read_only ("ENV");
1170 set_var_read_only ("BASH_ENV");
1173 return (restricted);
1175 #endif /* RESTRICTED_SHELL */
1177 /* Fetch the current set of uids and gids and return 1 if we're running
1178 setuid or setgid. */
1185 if (current_user.uid != u)
1187 FREE (current_user.user_name);
1188 FREE (current_user.shell);
1189 FREE (current_user.home_dir);
1190 current_user.user_name = current_user.shell = current_user.home_dir = (char *)NULL;
1192 current_user.uid = u;
1193 current_user.gid = getgid ();
1194 current_user.euid = geteuid ();
1195 current_user.egid = getegid ();
1197 /* See whether or not we are running setuid or setgid. */
1198 return (current_user.uid != current_user.euid) ||
1199 (current_user.gid != current_user.egid);
1203 disable_priv_mode ()
1205 setuid (current_user.uid);
1206 setgid (current_user.gid);
1207 current_user.euid = current_user.uid;
1208 current_user.egid = current_user.gid;
1211 #if defined (WORDEXP_OPTION)
1217 WORD_LIST *wl, *tl, *result;
1219 code = setjmp (top_level);
1221 if (code != NOT_JUMPED)
1225 /* Some kind of throw to top_level has occured. */
1227 return last_command_exit_value = 127;
1230 return last_command_exit_value;
1232 return last_command_exit_value = 1;
1234 command_error ("run_wordexp", CMDERR_BADJUMP, code, 0);
1238 /* Run it through the parser to get a list of words and expand them */
1239 if (words && *words)
1241 with_input_from_string (words, "--wordexp");
1242 if (parse_command () != 0)
1244 if (global_command == 0)
1249 if (global_command->type != cm_simple)
1251 wl = global_command->value.Simple->words;
1253 for (tl = wl; tl; tl = tl->next)
1254 tl->word->flags |= W_NOCOMSUB|W_NOPROCSUB;
1255 result = wl ? expand_words_no_vars (wl) : (WORD_LIST *)0;
1258 result = (WORD_LIST *)0;
1260 last_command_exit_value = 0;
1268 /* Count up the number of words and bytes, and print them. Don't count
1269 the trailing NUL byte. */
1270 for (nw = nb = 0, wl = result; wl; wl = wl->next)
1273 nb += strlen (wl->word->word);
1275 printf ("%u\n%u\n", nw, nb);
1276 /* Print each word on a separate line. This will have to be changed when
1277 the interface to glibc is completed. */
1278 for (wl = result; wl; wl = wl->next)
1279 printf ("%s\n", wl->word->word);
1285 #if defined (ONESHOT)
1286 /* Run one command, given as the argument to the -c option. Tell
1287 parse_and_execute not to fork for a simple command. */
1289 run_one_command (command)
1294 code = setjmp (top_level);
1296 if (code != NOT_JUMPED)
1298 #if defined (PROCESS_SUBSTITUTION)
1299 unlink_fifo_list ();
1300 #endif /* PROCESS_SUBSTITUTION */
1303 /* Some kind of throw to top_level has occured. */
1305 return last_command_exit_value = 127;
1308 return last_command_exit_value;
1310 return last_command_exit_value = 1;
1312 command_error ("run_one_command", CMDERR_BADJUMP, code, 0);
1315 return (parse_and_execute (savestring (command), "-c", SEVAL_NOHIST));
1317 #endif /* ONESHOT */
1320 bind_args (argv, arg_start, arg_end, start_index)
1322 int arg_start, arg_end, start_index;
1327 for (i = arg_start, args = (WORD_LIST *)NULL; i < arg_end; i++)
1328 args = make_word_list (make_word (argv[i]), args);
1331 args = REVERSE_LIST (args, WORD_LIST *);
1332 if (start_index == 0) /* bind to $0...$n for sh -c command */
1334 /* Posix.2 4.56.3 says that the first argument after sh -c command
1335 becomes $0, and the rest of the arguments become $1...$n */
1336 shell_name = savestring (args->word->word);
1337 FREE (dollar_vars[0]);
1338 dollar_vars[0] = savestring (args->word->word);
1339 remember_args (args->next, 1);
1340 push_args (args->next); /* BASH_ARGV and BASH_ARGC */
1342 else /* bind to $1...$n for shell script */
1344 remember_args (args, 1);
1345 push_args (args); /* BASH_ARGV and BASH_ARGC */
1348 dispose_words (args);
1357 remember_args ((WORD_LIST *)NULL, 1);
1358 pop_args (); /* Reset BASH_ARGV and BASH_ARGC */
1364 #if defined (DEBUGGER) && defined (DEBUGGER_START_FILE)
1367 old_errexit = exit_immediately_on_error;
1368 exit_immediately_on_error = 0;
1370 maybe_execute_file (DEBUGGER_START_FILE, 1);
1371 function_trace_mode = 1;
1373 exit_immediately_on_error += old_errexit;
1378 open_shell_script (script_name)
1381 int fd, e, fd_is_tty;
1382 char *filename, *path_filename, *t;
1386 #if defined (ARRAY_VARS)
1387 SHELL_VAR *funcname_v, *bash_source_v, *bash_lineno_v;
1388 ARRAY *funcname_a, *bash_source_a, *bash_lineno_a;
1391 filename = savestring (script_name);
1393 fd = open (filename, O_RDONLY);
1394 if ((fd < 0) && (errno == ENOENT) && (absolute_program (filename) == 0))
1397 /* If it's not in the current directory, try looking through PATH
1399 path_filename = find_path_file (script_name);
1403 filename = path_filename;
1404 fd = open (filename, O_RDONLY);
1413 file_error (filename);
1414 exit ((e == ENOENT) ? EX_NOTFOUND : EX_NOINPUT);
1417 free (dollar_vars[0]);
1418 dollar_vars[0] = exec_argv0 ? savestring (exec_argv0) : savestring (script_name);
1422 exec_argv0 = (char *)NULL;
1425 #if defined (ARRAY_VARS)
1426 GET_ARRAY_FROM_VAR ("FUNCNAME", funcname_v, funcname_a);
1427 GET_ARRAY_FROM_VAR ("BASH_SOURCE", bash_source_v, bash_source_a);
1428 GET_ARRAY_FROM_VAR ("BASH_LINENO", bash_lineno_v, bash_lineno_a);
1430 array_push (bash_source_a, filename);
1433 t = itos (executing_line_number ());
1434 array_push (bash_lineno_a, t);
1437 array_push (funcname_a, "main");
1441 fd_is_tty = isatty (fd);
1446 /* Only do this with non-tty file descriptors we can seek on. */
1447 if (fd_is_tty == 0 && (lseek (fd, 0L, 1) != -1))
1449 /* Check to see if the `file' in `bash file' is a binary file
1450 according to the same tests done by execute_simple_command (),
1451 and report an error and exit if it is. */
1452 sample_len = read (fd, sample, sizeof (sample));
1456 if ((fstat (fd, &sb) == 0) && S_ISDIR (sb.st_mode))
1457 internal_error (_("%s: is a directory"), filename);
1461 file_error (filename);
1465 else if (sample_len > 0 && (check_binary_file (sample, sample_len)))
1467 internal_error (_("%s: cannot execute binary file"), filename);
1468 exit (EX_BINARY_FILE);
1470 /* Now rewind the file back to the beginning. */
1474 /* Open the script. But try to move the file descriptor to a randomly
1475 large one, in the hopes that any descriptors used by the script will
1476 not match with ours. */
1477 fd = move_to_high_fd (fd, 1, -1);
1479 #if defined (BUFFERED_INPUT)
1480 default_buffered_input = fd;
1481 SET_CLOSE_ON_EXEC (default_buffered_input);
1482 #else /* !BUFFERED_INPUT */
1483 default_input = fdopen (fd, "r");
1485 if (default_input == 0)
1487 file_error (filename);
1491 SET_CLOSE_ON_EXEC (fd);
1492 if (fileno (default_input) != fd)
1493 SET_CLOSE_ON_EXEC (fileno (default_input));
1494 #endif /* !BUFFERED_INPUT */
1496 /* Just about the only way for this code to be executed is if something
1497 like `bash -i /dev/stdin' is executed. */
1498 if (interactive_shell && fd_is_tty)
1503 #if defined (BUFFERED_INPUT)
1504 default_buffered_input = 0;
1506 fclose (default_input);
1507 default_input = stdin;
1510 else if (forced_interactive && fd_is_tty == 0)
1511 /* But if a script is called with something like `bash -i scriptname',
1512 we need to do a non-interactive setup here, since we didn't do it
1514 init_interactive_script ();
1520 /* Initialize the input routines for the parser. */
1524 /* Make sure the fd from which we are reading input is not in
1526 #if defined (BUFFERED_INPUT)
1527 if (interactive == 0)
1528 sh_unset_nodelay_mode (default_buffered_input);
1530 #endif /* !BUFFERED_INPUT */
1531 sh_unset_nodelay_mode (fileno (stdin));
1533 /* with_input_from_stdin really means `with_input_from_readline' */
1534 if (interactive && no_line_editing == 0)
1535 with_input_from_stdin ();
1536 #if defined (BUFFERED_INPUT)
1537 else if (interactive == 0)
1538 with_input_from_buffered_stream (default_buffered_input, dollar_vars[0]);
1539 #endif /* BUFFERED_INPUT */
1541 with_input_from_stream (default_input, dollar_vars[0]);
1544 /* Close the current shell script input source and forget about it. This is
1545 extern so execute_cmd.c:initialize_subshell() can call it. If CHECK_ZERO
1546 is non-zero, we close default_buffered_input even if it's the standard
1549 unset_bash_input (check_zero)
1552 #if defined (BUFFERED_INPUT)
1553 if ((check_zero && default_buffered_input >= 0) ||
1554 (check_zero == 0 && default_buffered_input > 0))
1556 close_buffered_fd (default_buffered_input);
1557 default_buffered_input = bash_input.location.buffered_fd = -1;
1558 bash_input.type = st_none; /* XXX */
1560 #else /* !BUFFERED_INPUT */
1563 fclose (default_input);
1564 default_input = (FILE *)NULL;
1566 #endif /* !BUFFERED_INPUT */
1570 #if !defined (PROGRAM)
1571 # define PROGRAM "bash"
1575 set_shell_name (argv0)
1578 /* Here's a hack. If the name of this shell is "sh", then don't do
1579 any startup files; just try to be more like /bin/sh. */
1580 shell_name = argv0 ? base_pathname (argv0) : PROGRAM;
1582 if (argv0 && *argv0 == '-')
1584 if (*shell_name == '-')
1589 if (shell_name[0] == 's' && shell_name[1] == 'h' && shell_name[2] == '\0')
1591 if (shell_name[0] == 's' && shell_name[1] == 'u' && shell_name[2] == '\0')
1594 shell_name = argv0 ? argv0 : PROGRAM;
1595 FREE (dollar_vars[0]);
1596 dollar_vars[0] = savestring (shell_name);
1598 /* A program may start an interactive shell with
1599 "execl ("/bin/bash", "-", NULL)".
1600 If so, default the name of this shell to our name. */
1601 if (!shell_name || !*shell_name || (shell_name[0] == '-' && !shell_name[1]))
1602 shell_name = PROGRAM;
1608 expand_aliases = interactive_shell = startup_state = 1;
1613 init_noninteractive ()
1615 #if defined (HISTORY)
1616 bash_history_reinit (0);
1617 #endif /* HISTORY */
1618 interactive_shell = startup_state = interactive = 0;
1619 expand_aliases = posixly_correct; /* XXX - was 0 not posixly_correct */
1620 no_line_editing = 1;
1621 #if defined (JOB_CONTROL)
1622 set_job_control (0);
1623 #endif /* JOB_CONTROL */
1627 init_interactive_script ()
1629 init_noninteractive ();
1630 expand_aliases = interactive_shell = startup_state = 1;
1634 get_current_user_info ()
1636 struct passwd *entry;
1638 /* Don't fetch this more than once. */
1639 if (current_user.user_name == 0)
1641 entry = getpwuid (current_user.uid);
1644 current_user.user_name = savestring (entry->pw_name);
1645 current_user.shell = (entry->pw_shell && entry->pw_shell[0])
1646 ? savestring (entry->pw_shell)
1647 : savestring ("/bin/sh");
1648 current_user.home_dir = savestring (entry->pw_dir);
1652 current_user.user_name = _("I have no name!");
1653 current_user.user_name = savestring (current_user.user_name);
1654 current_user.shell = savestring ("/bin/sh");
1655 current_user.home_dir = savestring ("/");
1661 /* Do whatever is necessary to initialize the shell.
1662 Put new initializations in here. */
1668 /* Line buffer output for stderr and stdout. */
1669 if (shell_initialized == 0)
1671 sh_setlinebuf (stderr);
1672 sh_setlinebuf (stdout);
1675 /* Sort the array of shell builtins so that the binary search in
1676 find_shell_builtin () works correctly. */
1677 initialize_shell_builtins ();
1679 /* Initialize the trap signal handlers before installing our own
1680 signal handlers. traps.c:restore_original_signals () is responsible
1681 for restoring the original default signal handlers. That function
1682 is called when we make a new child. */
1683 initialize_traps ();
1684 initialize_signals (0);
1686 /* It's highly unlikely that this will change. */
1687 if (current_host_name == 0)
1689 /* Initialize current_host_name. */
1690 if (gethostname (hostname, 255) < 0)
1691 current_host_name = "??host??";
1693 current_host_name = savestring (hostname);
1696 /* Initialize the stuff in current_user that comes from the password
1697 file. We don't need to do this right away if the shell is not
1699 if (interactive_shell)
1700 get_current_user_info ();
1702 /* Initialize our interface to the tilde expander. */
1703 tilde_initialize ();
1705 /* Initialize internal and environment variables. Don't import shell
1706 functions from the environment if we are running in privileged or
1707 restricted mode or if the shell is running setuid. */
1708 #if defined (RESTRICTED_SHELL)
1709 initialize_shell_variables (shell_environment, privileged_mode||restricted||running_setuid);
1711 initialize_shell_variables (shell_environment, privileged_mode||running_setuid);
1714 /* Initialize the data structures for storing and running jobs. */
1715 initialize_job_control (0);
1717 /* Initialize input streams to null. */
1718 initialize_bash_input ();
1720 initialize_flags ();
1722 /* Initialize the shell options. Don't import the shell options
1723 from the environment variables $SHELLOPTS or $BASHOPTS if we are
1724 running in privileged or restricted mode or if the shell is running
1726 #if defined (RESTRICTED_SHELL)
1727 initialize_shell_options (privileged_mode||restricted||running_setuid);
1728 initialize_bashopts (privileged_mode||restricted||running_setuid);
1730 initialize_shell_options (privileged_mode||running_setuid);
1731 initialize_bashopts (privileged_mode||running_setuid);
1735 /* Function called by main () when it appears that the shell has already
1736 had some initialization performed. This is supposed to reset the world
1737 back to a pristine state, as if we had been exec'ed. */
1739 shell_reinitialize ()
1741 /* The default shell prompts. */
1742 primary_prompt = PPROMPT;
1743 secondary_prompt = SPROMPT;
1745 /* Things that get 1. */
1746 current_command_number = 1;
1748 /* We have decided that the ~/.bashrc file should not be executed
1749 for the invocation of each shell script. If the variable $ENV
1750 (or $BASH_ENV) is set, its value is used as the name of a file
1752 no_rc = no_profile = 1;
1754 /* Things that get 0. */
1755 login_shell = make_login_shell = interactive = executing = 0;
1756 debugging = do_version = line_number = last_command_exit_value = 0;
1757 forced_interactive = interactive_shell = subshell_environment = 0;
1760 #if defined (HISTORY)
1761 bash_history_reinit (0);
1762 #endif /* HISTORY */
1764 #if defined (RESTRICTED_SHELL)
1766 #endif /* RESTRICTED_SHELL */
1768 /* Ensure that the default startup file is used. (Except that we don't
1769 execute this file for reinitialized shells). */
1770 bashrc_file = "~/.bashrc";
1772 /* Delete all variables and functions. They will be reinitialized when
1773 the environment is parsed. */
1774 delete_all_contexts (shell_variables);
1775 delete_all_variables (shell_functions);
1777 reinit_special_variables ();
1779 #if defined (READLINE)
1780 bashline_reinitialize ();
1783 shell_reinitialized = 1;
1787 show_shell_usage (fp, extra)
1792 char *set_opts, *s, *t;
1795 fprintf (fp, _("GNU bash, version %s-(%s)\n"), shell_version_string (), MACHTYPE);
1796 fprintf (fp, _("Usage:\t%s [GNU long option] [option] ...\n\t%s [GNU long option] [option] script-file ...\n"),
1797 shell_name, shell_name);
1798 fputs (_("GNU long options:\n"), fp);
1799 for (i = 0; long_args[i].name; i++)
1800 fprintf (fp, "\t--%s\n", long_args[i].name);
1802 fputs (_("Shell options:\n"), fp);
1803 fputs (_("\t-irsD or -c command or -O shopt_option\t\t(invocation only)\n"), fp);
1805 for (i = 0, set_opts = 0; shell_builtins[i].name; i++)
1806 if (STREQ (shell_builtins[i].name, "set"))
1807 set_opts = savestring (shell_builtins[i].short_doc);
1810 s = strchr (set_opts, '[');
1815 t = strchr (s, ']');
1818 fprintf (fp, _("\t-%s or -o option\n"), s);
1824 fprintf (fp, _("Type `%s -c \"help set\"' for more information about shell options.\n"), shell_name);
1825 fprintf (fp, _("Type `%s -c help' for more information about shell builtin commands.\n"), shell_name);
1826 fprintf (fp, _("Use the `bashbug' command to report bugs.\n"));
1831 add_shopt_to_alist (opt, on_or_off)
1835 if (shopt_ind >= shopt_len)
1838 shopt_alist = (STRING_INT_ALIST *)xrealloc (shopt_alist, shopt_len * sizeof (shopt_alist[0]));
1840 shopt_alist[shopt_ind].word = opt;
1841 shopt_alist[shopt_ind].token = on_or_off;
1850 for (i = 0; i < shopt_ind; i++)
1851 if (shopt_setopt (shopt_alist[i].word, (shopt_alist[i].token == '-')) != EXECUTION_SUCCESS)
1855 shopt_ind = shopt_len = 0;