1 /* Proxy shell designed for use with Emacs on Windows 95 and NT.
2 Copyright (C) 1997, 2001-2012 Free Software Foundation, Inc.
4 Accepts subset of Unix sh(1) command-line options, for compatibility
5 with elisp code written for Unix. When possible, executes external
6 programs directly (a common use of /bin/sh by Emacs), otherwise
7 invokes the user-specified command processor to handle built-in shell
8 commands, batch files and interactive mode.
10 The main function is simply to process the "-c string" option in the
11 way /bin/sh does, since the standard Windows command shells use the
12 convention that everything after "/c" (the Windows equivalent of
13 "-c") is the input string.
15 This file is part of GNU Emacs.
17 GNU Emacs is free software: you can redistribute it and/or modify
18 it under the terms of the GNU General Public License as published by
19 the Free Software Foundation, either version 3 of the License, or
20 (at your option) any later version.
22 GNU Emacs is distributed in the hope that it will be useful,
23 but WITHOUT ANY WARRANTY; without even the implied warranty of
24 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 GNU General Public License for more details.
27 You should have received a copy of the GNU General Public License
28 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
32 #include <stdarg.h> /* va_args */
33 #include <malloc.h> /* alloca */
34 #include <stdlib.h> /* getenv */
35 #include <string.h> /* strlen */
36 #include <ctype.h> /* isspace, isalpha */
38 /* We don't want to include stdio.h because we are already duplicating
40 extern int _snprintf (char *buffer
, size_t count
, const char *format
, ...);
42 /******* Mock C library routines *********************************/
44 /* These routines are used primarily to minimize the executable size. */
46 #define stdout GetStdHandle (STD_OUTPUT_HANDLE)
47 #define stderr GetStdHandle (STD_ERROR_HANDLE)
50 vfprintf (HANDLE hnd
, const char * msg
, va_list args
)
55 wvsprintf (buf
, msg
, args
);
56 return WriteFile (hnd
, buf
, strlen (buf
), &bytes_written
, NULL
);
60 fprintf (HANDLE hnd
, const char * msg
, ...)
66 rc
= vfprintf (hnd
, msg
, args
);
73 printf (const char * msg
, ...)
79 rc
= vfprintf (stdout
, msg
, args
);
86 fail (const char * msg
, ...)
91 vfprintf (stderr
, msg
, args
);
98 warn (const char * msg
, ...)
102 va_start (args
, msg
);
103 vfprintf (stderr
, msg
, args
);
107 /******************************************************************/
110 canon_filename (char *fname
)
125 skip_space (const char *str
)
127 while (isspace (*str
)) str
++;
132 skip_nonspace (const char *str
)
134 while (*str
&& !isspace (*str
)) str
++;
138 int escape_char
= '\\';
140 /* Get next token from input, advancing pointer. */
142 get_next_token (char * buf
, const char ** pSrc
)
144 const char * p
= *pSrc
;
150 int escape_char_run
= 0;
152 /* Go through src until an ending quote is found, unescaping
153 quotes along the way. If the escape char is not quote, then do
154 special handling of multiple escape chars preceding a quote
155 char (ie. the reverse of what Emacs does to escape quotes). */
159 if (p
[0] == escape_char
&& escape_char
!= '"')
165 else if (p
[0] == '"')
167 while (escape_char_run
> 1)
170 escape_char_run
-= 2;
173 if (escape_char_run
> 0)
179 else if (p
[1] == escape_char
&& escape_char
== '"')
181 /* quote escaped by doubling */
187 /* The ending quote. */
189 /* Leave input pointer after token. */
194 else if (p
[0] == '\0')
196 /* End of string, but no ending quote found. We might want to
197 flag this as an error, but for now will consider the end as
198 the end of the token. */
210 /* Next token is delimited by whitespace. */
211 const char * p1
= skip_nonspace (p
);
212 memcpy (o
, p
, p1
- p
);
223 /* Search for EXEC file in DIR. If EXEC does not have an extension,
224 DIR is searched for EXEC with the standard extensions appended. */
226 search_dir (const char *dir
, const char *exec
, int bufsize
, char *buffer
)
228 const char *exts
[] = {".bat", ".cmd", ".exe", ".com"};
229 int n_exts
= sizeof (exts
) / sizeof (char *);
233 /* Search the directory for the program. */
234 for (i
= 0; i
< n_exts
; i
++)
236 rc
= SearchPath (dir
, exec
, exts
[i
], bufsize
, buffer
, &dummy
);
244 /* Return the absolute name of executable file PROG, including
245 any file extensions. If an absolute name for PROG cannot be found,
248 make_absolute (const char *prog
)
250 char absname
[MAX_PATH
];
252 char curdir
[MAX_PATH
];
256 /* At least partial absolute path specified; search there. */
257 if ((isalpha (prog
[0]) && prog
[1] == ':') ||
260 /* Split the directory from the filename. */
261 fname
= strrchr (prog
, '\\');
263 /* Only a drive specifier is given. */
265 strncpy (dir
, prog
, fname
- prog
);
266 dir
[fname
- prog
] = '\0';
268 /* Search the directory for the program. */
269 if (search_dir (dir
, prog
, MAX_PATH
, absname
) > 0)
270 return strdup (absname
);
275 if (GetCurrentDirectory (MAX_PATH
, curdir
) <= 0)
278 /* Relative path; search in current dir. */
279 if (strpbrk (prog
, "\\"))
281 if (search_dir (curdir
, prog
, MAX_PATH
, absname
) > 0)
282 return strdup (absname
);
287 /* Just filename; search current directory then PATH. */
288 path
= alloca (strlen (getenv ("PATH")) + strlen (curdir
) + 2);
289 strcpy (path
, curdir
);
291 strcat (path
, getenv ("PATH"));
295 /* Get next directory from path. */
297 while (*p
&& *p
!= ';') p
++;
298 strncpy (dir
, path
, p
- path
);
299 dir
[p
- path
] = '\0';
301 /* Search the directory for the program. */
302 if (search_dir (dir
, prog
, MAX_PATH
, absname
) > 0)
303 return strdup (absname
);
305 /* Move to the next directory. */
312 /* Try to decode the given command line the way cmd would do it. On
313 success, return 1 with cmdline dequoted. Otherwise, when we've
314 found constructs only cmd can properly interpret, return 0 and
315 leave cmdline unchanged. */
317 try_dequote_cmdline (char* cmdline
)
319 /* Dequoting can only subtract characters, so the length of the
320 original command line is a bound on the amount of scratch space
321 we need. This length, in turn, is bounded by the 32k
322 CreateProces limit. */
323 char * old_pos
= cmdline
;
324 char * new_cmdline
= alloca (strlen(cmdline
));
325 char * new_pos
= new_cmdline
;
334 while ((c
= *old_pos
++))
343 state
= INSIDE_QUOTE
;
352 /* We saw an unquoted shell metacharacter and we don't
353 understand it. Bail out. */
373 /* Variable substitution inside quote. Bail out. */
383 /* We were able to dequote the entire string. Copy our scratch
384 buffer on top of the original buffer and return success. */
385 memcpy (cmdline
, new_cmdline
, new_pos
- new_cmdline
);
386 cmdline
[new_pos
- new_cmdline
] = '\0';
390 /*****************************************************************/
396 /* Parse commandline into argv array, allowing proper quoting of args. */
400 char * cmdline
= GetCommandLine ();
407 /* Information about child proc is global, to allow for automatic
408 termination when interrupted. At the moment, only one child process
409 can be running at any one time. */
411 PROCESS_INFORMATION child
;
412 int interactive
= TRUE
;
415 console_event_handler (DWORD event
)
420 case CTRL_BREAK_EVENT
:
423 /* Both command.com and cmd.exe have the annoying behavior of
424 prompting "Terminate batch job (y/n)?" when interrupted
425 while running a batch file, even if running in
426 non-interactive (-c) mode. Try to make up for this
427 deficiency by forcibly terminating the subprocess if
428 running non-interactively. */
429 if (child
.hProcess
&&
430 WaitForSingleObject (child
.hProcess
, 500) != WAIT_OBJECT_0
)
431 TerminateProcess (child
.hProcess
, 0);
432 exit (STATUS_CONTROL_C_EXIT
);
438 /* CLOSE, LOGOFF and SHUTDOWN events - actually we don't get these
440 fail ("cmdproxy: received %d event\n", event
);
442 TerminateProcess (child
.hProcess
, 0);
448 /* Change from normal usage; return value indicates whether spawn
449 succeeded or failed - program return code is returned separately. */
451 spawn (const char *progname
, char *cmdline
, const char *dir
, int *retcode
)
453 BOOL success
= FALSE
;
454 SECURITY_ATTRIBUTES sec_attrs
;
456 /* In theory, passing NULL for the environment block to CreateProcess
457 is the same as passing the value of GetEnvironmentStrings, but
458 doing this explicitly seems to cure problems running DOS programs
460 char * envblock
= GetEnvironmentStrings ();
462 sec_attrs
.nLength
= sizeof (sec_attrs
);
463 sec_attrs
.lpSecurityDescriptor
= NULL
;
464 sec_attrs
.bInheritHandle
= FALSE
;
466 memset (&start
, 0, sizeof (start
));
467 start
.cb
= sizeof (start
);
469 if (CreateProcess (progname
, cmdline
, &sec_attrs
, NULL
, TRUE
,
470 0, envblock
, dir
, &start
, &child
))
473 /* wait for completion and pass on return code */
474 WaitForSingleObject (child
.hProcess
, INFINITE
);
476 GetExitCodeProcess (child
.hProcess
, (DWORD
*)retcode
);
477 CloseHandle (child
.hThread
);
478 CloseHandle (child
.hProcess
);
479 child
.hProcess
= NULL
;
482 FreeEnvironmentStrings (envblock
);
487 /* Return size of current environment block. */
491 char * start
= GetEnvironmentStrings ();
494 while (tmp
[0] || tmp
[1])
496 FreeEnvironmentStrings (start
);
497 return tmp
+ 2 - start
;
500 /******* Main program ********************************************/
503 main (int argc
, char ** argv
)
510 char **pass_through_args
;
511 int num_pass_through_args
;
512 char modname
[MAX_PATH
];
519 SetConsoleCtrlHandler ((PHANDLER_ROUTINE
) console_event_handler
, TRUE
);
521 if (!GetCurrentDirectory (sizeof (dir
), dir
))
522 fail ("error: GetCurrentDirectory failed\n");
524 /* We serve double duty: we can be called either as a proxy for the
525 real shell (that is, because we are defined to be the user shell),
526 or in our role as a helper application for running DOS programs.
527 In the former case, we interpret the command line options as if we
528 were a Unix shell, but in the latter case we simply pass our
529 command line to CreateProcess. We know which case we are dealing
530 with by whether argv[0] refers to ourself or to some other program.
531 (This relies on an arcane feature of CreateProcess, where we can
532 specify cmdproxy as the module to run, but specify a different
533 program in the command line - the MSVC startup code sets argv[0]
534 from the command line.) */
536 if (!GetModuleFileName (NULL
, modname
, sizeof (modname
)))
537 fail ("error: GetModuleFileName failed\n");
539 /* Change directory to location of .exe so startup directory can be
541 progname
= strrchr (modname
, '\\');
543 SetCurrentDirectory (modname
);
546 /* Due to problems with interaction between API functions that use "OEM"
547 codepage vs API functions that use the "ANSI" codepage, we need to
548 make things consistent by choosing one and sticking with it. */
549 SetConsoleCP (GetACP ());
550 SetConsoleOutputCP (GetACP ());
552 /* Although Emacs always sets argv[0] to an absolute pathname, we
553 might get run in other ways as well, so convert argv[0] to an
554 absolute name before comparing to the module name. */
556 /* The call to SearchPath will find argv[0] in the current
557 directory, append ".exe" to it if needed, and also canonicalize
558 it, to resolve references to ".", "..", etc. */
559 status
= SearchPath (NULL
, argv
[0], ".exe", sizeof (path
), path
,
561 if (!(status
> 0 && stricmp (modname
, path
) == 0))
567 /* Make sure we have argv[0] in path[], as the failed
568 SearchPath might not have copied it there. */
569 strcpy (path
, argv
[0]);
570 /* argv[0] could include forward slashes; convert them all
571 to backslashes, for strrchr calls below to DTRT. */
572 for (s
= path
; *s
; s
++)
576 /* Perhaps MODNAME and PATH use mixed short and long file names. */
577 if (!(GetShortPathName (modname
, modname
, sizeof (modname
))
578 && GetShortPathName (path
, path
, sizeof (path
))
579 && stricmp (modname
, path
) == 0))
581 /* Sometimes GetShortPathName fails because one or more
582 directories leading to argv[0] have issues with access
583 rights. In that case, at least we can compare the
584 basenames. Note: this disregards the improbable case of
585 invoking a program of the same name from another
586 directory, since the chances of that other executable to
587 be both our namesake and a 16-bit DOS application are nil. */
588 char *p
= strrchr (path
, '\\');
589 char *q
= strrchr (modname
, '\\');
593 p
= strchr (path
, ':');
599 q
= strchr (modname
, ':');
605 pdot
= strrchr (p
, '.');
606 if (!pdot
|| stricmp (pdot
, ".exe") != 0)
607 pdot
= p
+ strlen (p
);
608 qdot
= strrchr (q
, '.');
609 if (!qdot
|| stricmp (qdot
, ".exe") != 0)
610 qdot
= q
+ strlen (q
);
611 if (pdot
- p
!= qdot
- q
|| strnicmp (p
, q
, pdot
- p
) != 0)
613 /* We are being used as a helper to run a DOS app; just
614 pass command line to DOS app without change. */
615 /* TODO: fill in progname. */
616 if (spawn (NULL
, GetCommandLine (), dir
, &rc
))
618 fail ("Could not run %s\n", GetCommandLine ());
623 /* Process command line. If running interactively (-c or /c not
624 specified) then spawn a real command shell, passing it the command
627 If not running interactively, then attempt to execute the specified
628 command directly. If necessary, spawn a real shell to execute the
635 /* If no args, spawn real shell for interactive use. */
638 /* Ask command.com to create an environment block with a reasonable
639 amount of free space. */
640 envsize
= get_env_size () + 300;
641 pass_through_args
= (char **) alloca (argc
* sizeof (char *));
642 num_pass_through_args
= 0;
647 /* Act on switches we recognize (mostly single letter switches,
648 except for -e); all unrecognized switches and extra args are
649 passed on to real shell if used (only really of benefit for
650 interactive use, but allow for batch use as well). Accept / as
651 switch char for compatibility with cmd.exe. */
652 if (((*argv
)[0] == '-' || (*argv
)[0] == '/') && (*argv
)[1] != '\0')
654 if (((*argv
)[1] == 'c' || (*argv
)[1] == 'C') && ((*argv
)[2] == '\0'))
657 fail ("error: expecting arg for %s\n", *argv
);
661 else if (((*argv
)[1] == 'i' || (*argv
)[1] == 'I') && ((*argv
)[2] == '\0'))
664 warn ("warning: %s ignored because of -c\n", *argv
);
666 else if (((*argv
)[1] == 'e' || (*argv
)[1] == 'E') && ((*argv
)[2] == ':'))
668 int requested_envsize
= atoi (*argv
+ 3);
669 /* Enforce a reasonable minimum size, as above. */
670 if (requested_envsize
> envsize
)
671 envsize
= requested_envsize
;
672 /* For sanity, enforce a reasonable maximum. */
678 /* warn ("warning: unknown option %s ignored", *argv); */
679 pass_through_args
[num_pass_through_args
++] = *argv
;
687 /* I think this is probably not useful - cmd.exe ignores extra
688 (non-switch) args in interactive mode, and they cannot be passed on
689 when -c was given. */
691 /* Collect any remaining args after (initial) switches. */
694 pass_through_args
[num_pass_through_args
++] = *argv
++;
697 /* Probably a mistake for there to be extra args; not fatal. */
699 warn ("warning: extra args ignored after '%s'\n", argv
[-1]);
702 pass_through_args
[num_pass_through_args
] = NULL
;
704 /* If -c option, determine if we must spawn a real shell, or if we can
705 execute the command directly ourself. */
710 /* The program name is the first token of cmdline. Since
711 filenames cannot legally contain embedded quotes, the value
712 of escape_char doesn't matter. */
714 if (!get_next_token (path
, &args
))
715 fail ("error: no program name specified.\n");
717 canon_filename (path
);
718 progname
= make_absolute (path
);
720 /* If we found the program and the rest of the command line does
721 not contain unquoted shell metacharacters, run the program
722 directly (if not found it might be an internal shell command,
724 if (progname
!= NULL
&& try_dequote_cmdline (cmdline
))
734 int extra_arg_space
= 0;
736 int run_command_dot_com
;
738 progname
= getenv ("COMSPEC");
740 fail ("error: COMSPEC is not set\n");
742 canon_filename (progname
);
743 progname
= make_absolute (progname
);
745 if (progname
== NULL
|| strchr (progname
, '\\') == NULL
)
746 fail ("error: the program %s could not be found.\n", getenv ("COMSPEC"));
748 /* Need to set environment size when running command.com. */
749 run_command_dot_com
=
750 (stricmp (strrchr (progname
, '\\'), "command.com") == 0);
752 /* Work out how much extra space is required for
753 pass_through_args. */
754 for (argv
= pass_through_args
; *argv
!= NULL
; ++argv
)
755 /* We don't expect to have to quote switches. */
756 extra_arg_space
+= strlen (*argv
) + 2;
762 /* Convert to syntax expected by cmd.exe/command.com for
763 running non-interactively. Always quote program name in
764 case path contains spaces (fortunately it can't contain
765 quotes, since they are illegal in path names). */
768 strlen (progname
) + extra_arg_space
+ strlen (cmdline
) + 16;
769 buf
= p
= alloca (maxlen
+ 1);
771 /* Quote progname in case it contains spaces. */
772 p
+= _snprintf (p
, remlen
, "\"%s\"", progname
);
773 remlen
= maxlen
- (p
- buf
);
775 /* Include pass_through_args verbatim; these are just switches
776 so should not need quoting. */
777 for (argv
= pass_through_args
; *argv
!= NULL
; ++argv
)
779 p
+= _snprintf (p
, remlen
, " %s", *argv
);
780 remlen
= maxlen
- (p
- buf
);
783 if (run_command_dot_com
)
784 _snprintf (p
, remlen
, " /e:%d /c %s", envsize
, cmdline
);
786 _snprintf (p
, remlen
, " /c %s", cmdline
);
791 if (run_command_dot_com
)
793 /* Provide dir arg expected by command.com when first
794 started interactively (the "command search path"). To
795 avoid potential problems with spaces in command dir
796 (which cannot be quoted - command.com doesn't like it),
797 we always use the 8.3 form. */
798 GetShortPathName (progname
, path
, sizeof (path
));
799 p
= strrchr (path
, '\\');
800 /* Trailing slash is acceptable, so always leave it. */
807 strlen (progname
) + extra_arg_space
+ strlen (path
) + 13;
808 cmdline
= p
= alloca (maxlen
+ 1);
810 /* Quote progname in case it contains spaces. */
811 p
+= _snprintf (p
, remlen
, "\"%s\" %s", progname
, path
);
812 remlen
= maxlen
- (p
- cmdline
);
814 /* Include pass_through_args verbatim; these are just switches
815 so should not need quoting. */
816 for (argv
= pass_through_args
; *argv
!= NULL
; ++argv
)
818 p
+= _snprintf (p
, remlen
, " %s", *argv
);
819 remlen
= maxlen
- (p
- cmdline
);
822 if (run_command_dot_com
)
823 _snprintf (p
, remlen
, " /e:%d", envsize
);
828 fail ("Internal error: program name not defined\n");
833 if (spawn (progname
, cmdline
, dir
, &rc
))
842 fail ("Could not run %s\n", progname
);