Improve Windows quoting robustness
[emacs.git] / nt / cmdproxy.c
blobfe128fd17c4ff8ec2dc5e2ace659de8b6dd54c09
1 /* Proxy shell designed for use with Emacs on Windows 95 and NT.
2 Copyright (C) 1997, 2001-2011 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/>. */
30 #include <windows.h>
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
39 lots of it here */
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)
49 int
50 vfprintf (HANDLE hnd, const char * msg, va_list args)
52 DWORD bytes_written;
53 char buf[1024];
55 wvsprintf (buf, msg, args);
56 return WriteFile (hnd, buf, strlen (buf), &bytes_written, NULL);
59 int
60 fprintf (HANDLE hnd, const char * msg, ...)
62 va_list args;
63 int rc;
65 va_start (args, msg);
66 rc = vfprintf (hnd, msg, args);
67 va_end (args);
69 return rc;
72 int
73 printf (const char * msg, ...)
75 va_list args;
76 int rc;
78 va_start (args, msg);
79 rc = vfprintf (stdout, msg, args);
80 va_end (args);
82 return rc;
85 void
86 fail (const char * msg, ...)
88 va_list args;
90 va_start (args, msg);
91 vfprintf (stderr, msg, args);
92 va_end (args);
94 exit (-1);
97 void
98 warn (const char * msg, ...)
100 va_list args;
102 va_start (args, msg);
103 vfprintf (stderr, msg, args);
104 va_end (args);
107 /******************************************************************/
109 char *
110 canon_filename (char *fname)
112 char *p = fname;
114 while (*p)
116 if (*p == '/')
117 *p = '\\';
118 p++;
121 return fname;
124 const char *
125 skip_space (const char *str)
127 while (isspace (*str)) str++;
128 return str;
131 const char *
132 skip_nonspace (const char *str)
134 while (*str && !isspace (*str)) str++;
135 return 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;
145 char * o = buf;
147 p = skip_space (p);
148 if (*p == '"')
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). */
156 p++;
157 while (1)
159 if (p[0] == escape_char && escape_char != '"')
161 escape_char_run++;
162 p++;
163 continue;
165 else if (p[0] == '"')
167 while (escape_char_run > 1)
169 *o++ = escape_char;
170 escape_char_run -= 2;
173 if (escape_char_run > 0)
175 /* escaped quote */
176 *o++ = *p++;
177 escape_char_run = 0;
179 else if (p[1] == escape_char && escape_char == '"')
181 /* quote escaped by doubling */
182 *o++ = *p;
183 p += 2;
185 else
187 /* The ending quote. */
188 *o = '\0';
189 /* Leave input pointer after token. */
190 p++;
191 break;
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. */
199 *o = '\0';
200 break;
202 else
204 *o++ = *p++;
208 else
210 /* Next token is delimited by whitespace. */
211 const char * p1 = skip_nonspace (p);
212 memcpy (o, p, p1 - p);
213 o += (p1 - p);
214 *o = '\0';
215 p = p1;
218 *pSrc = p;
220 return o - buf;
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 *);
230 char *dummy;
231 int i, rc;
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);
237 if (rc > 0)
238 return rc;
241 return 0;
244 /* Return the absolute name of executable file PROG, including
245 any file extensions. If an absolute name for PROG cannot be found,
246 return NULL. */
247 char *
248 make_absolute (const char *prog)
250 char absname[MAX_PATH];
251 char dir[MAX_PATH];
252 char curdir[MAX_PATH];
253 char *p, *path;
254 const char *fname;
256 /* At least partial absolute path specified; search there. */
257 if ((isalpha (prog[0]) && prog[1] == ':') ||
258 (prog[0] == '\\'))
260 /* Split the directory from the filename. */
261 fname = strrchr (prog, '\\');
262 if (!fname)
263 /* Only a drive specifier is given. */
264 fname = prog + 2;
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);
271 else
272 return NULL;
275 if (GetCurrentDirectory (MAX_PATH, curdir) <= 0)
276 return NULL;
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);
283 else
284 return NULL;
287 /* Just filename; search current directory then PATH. */
288 path = alloca (strlen (getenv ("PATH")) + strlen (curdir) + 2);
289 strcpy (path, curdir);
290 strcat (path, ";");
291 strcat (path, getenv ("PATH"));
293 while (*path)
295 /* Get next directory from path. */
296 p = 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. */
306 path = p + 1;
309 return NULL;
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;
326 char c;
328 enum {
329 NORMAL,
330 AFTER_CARET,
331 INSIDE_QUOTE
332 } state = NORMAL;
334 while ((c = *old_pos++))
336 switch (state)
338 case NORMAL:
339 switch(c)
341 case '"':
342 *new_pos++ = c;
343 state = INSIDE_QUOTE;
344 break;
345 case '^':
346 state = AFTER_CARET;
347 break;
348 case '<': case '>':
349 case '&': case '|':
350 case '(': case ')':
351 case '%': case '!':
352 /* We saw an unquoted shell metacharacter and we don't
353 understand it. Bail out. */
354 return 0;
355 default:
356 *new_pos++ = c;
357 break;
359 break;
360 case AFTER_CARET:
361 *new_pos++ = c;
362 state = NORMAL;
363 break;
364 case INSIDE_QUOTE:
365 *new_pos++ = c;
366 if (c == '"')
367 state = NORMAL;
369 break;
373 /* We were able to dequote the entire string. Copy our scratch
374 buffer on top of the original buffer and return success. */
375 memcpy (cmdline, new_cmdline, new_pos - new_cmdline);
376 cmdline[new_pos - new_cmdline] = '\0';
377 return 1;
380 /*****************************************************************/
382 #if 0
383 char ** _argv;
384 int _argc;
386 /* Parse commandline into argv array, allowing proper quoting of args. */
387 void
388 setup_argv (void)
390 char * cmdline = GetCommandLine ();
391 int arg_bytes = 0;
395 #endif
397 /* Information about child proc is global, to allow for automatic
398 termination when interrupted. At the moment, only one child process
399 can be running at any one time. */
401 PROCESS_INFORMATION child;
402 int interactive = TRUE;
404 BOOL
405 console_event_handler (DWORD event)
407 switch (event)
409 case CTRL_C_EVENT:
410 case CTRL_BREAK_EVENT:
411 if (!interactive)
413 /* Both command.com and cmd.exe have the annoying behavior of
414 prompting "Terminate batch job (y/n)?" when interrupted
415 while running a batch file, even if running in
416 non-interactive (-c) mode. Try to make up for this
417 deficiency by forcibly terminating the subprocess if
418 running non-interactively. */
419 if (child.hProcess &&
420 WaitForSingleObject (child.hProcess, 500) != WAIT_OBJECT_0)
421 TerminateProcess (child.hProcess, 0);
422 exit (STATUS_CONTROL_C_EXIT);
424 break;
426 #if 0
427 default:
428 /* CLOSE, LOGOFF and SHUTDOWN events - actually we don't get these
429 under Windows 95. */
430 fail ("cmdproxy: received %d event\n", event);
431 if (child.hProcess)
432 TerminateProcess (child.hProcess, 0);
433 #endif
435 return TRUE;
438 /* Change from normal usage; return value indicates whether spawn
439 succeeded or failed - program return code is returned separately. */
441 spawn (const char *progname, char *cmdline, const char *dir, int *retcode)
443 BOOL success = FALSE;
444 SECURITY_ATTRIBUTES sec_attrs;
445 STARTUPINFO start;
446 /* In theory, passing NULL for the environment block to CreateProcess
447 is the same as passing the value of GetEnvironmentStrings, but
448 doing this explicitly seems to cure problems running DOS programs
449 in some cases. */
450 char * envblock = GetEnvironmentStrings ();
452 sec_attrs.nLength = sizeof (sec_attrs);
453 sec_attrs.lpSecurityDescriptor = NULL;
454 sec_attrs.bInheritHandle = FALSE;
456 memset (&start, 0, sizeof (start));
457 start.cb = sizeof (start);
459 if (CreateProcess (progname, cmdline, &sec_attrs, NULL, TRUE,
460 0, envblock, dir, &start, &child))
462 success = TRUE;
463 /* wait for completion and pass on return code */
464 WaitForSingleObject (child.hProcess, INFINITE);
465 if (retcode)
466 GetExitCodeProcess (child.hProcess, (DWORD *)retcode);
467 CloseHandle (child.hThread);
468 CloseHandle (child.hProcess);
469 child.hProcess = NULL;
472 FreeEnvironmentStrings (envblock);
474 return success;
477 /* Return size of current environment block. */
479 get_env_size (void)
481 char * start = GetEnvironmentStrings ();
482 char * tmp = start;
484 while (tmp[0] || tmp[1])
485 ++tmp;
486 FreeEnvironmentStrings (start);
487 return tmp + 2 - start;
490 /******* Main program ********************************************/
493 main (int argc, char ** argv)
495 int rc;
496 int need_shell;
497 char * cmdline;
498 char * progname;
499 int envsize;
500 char **pass_through_args;
501 int num_pass_through_args;
502 char modname[MAX_PATH];
503 char path[MAX_PATH];
504 char dir[MAX_PATH];
507 interactive = TRUE;
509 SetConsoleCtrlHandler ((PHANDLER_ROUTINE) console_event_handler, TRUE);
511 if (!GetCurrentDirectory (sizeof (dir), dir))
512 fail ("error: GetCurrentDirectory failed\n");
514 /* We serve double duty: we can be called either as a proxy for the
515 real shell (that is, because we are defined to be the user shell),
516 or in our role as a helper application for running DOS programs.
517 In the former case, we interpret the command line options as if we
518 were a Unix shell, but in the latter case we simply pass our
519 command line to CreateProcess. We know which case we are dealing
520 with by whether argv[0] refers to ourself or to some other program.
521 (This relies on an arcane feature of CreateProcess, where we can
522 specify cmdproxy as the module to run, but specify a different
523 program in the command line - the MSVC startup code sets argv[0]
524 from the command line.) */
526 if (!GetModuleFileName (NULL, modname, sizeof (modname)))
527 fail ("error: GetModuleFileName failed\n");
529 /* Change directory to location of .exe so startup directory can be
530 deleted. */
531 progname = strrchr (modname, '\\');
532 *progname = '\0';
533 SetCurrentDirectory (modname);
534 *progname = '\\';
536 /* Due to problems with interaction between API functions that use "OEM"
537 codepage vs API functions that use the "ANSI" codepage, we need to
538 make things consistent by choosing one and sticking with it. */
539 SetConsoleCP (GetACP ());
540 SetConsoleOutputCP (GetACP ());
542 /* Although Emacs always sets argv[0] to an absolute pathname, we
543 might get run in other ways as well, so convert argv[0] to an
544 absolute name before comparing to the module name. Don't get
545 caught out by mixed short and long names. */
546 GetShortPathName (modname, modname, sizeof (modname));
547 path[0] = '\0';
548 if (!SearchPath (NULL, argv[0], ".exe", sizeof (path), path, &progname)
549 || !GetShortPathName (path, path, sizeof (path))
550 || stricmp (modname, path) != 0)
552 /* We are being used as a helper to run a DOS app; just pass
553 command line to DOS app without change. */
554 /* TODO: fill in progname. */
555 if (spawn (NULL, GetCommandLine (), dir, &rc))
556 return rc;
557 fail ("Could not run %s\n", GetCommandLine ());
560 /* Process command line. If running interactively (-c or /c not
561 specified) then spawn a real command shell, passing it the command
562 line arguments.
564 If not running interactively, then attempt to execute the specified
565 command directly. If necessary, spawn a real shell to execute the
566 command.
570 progname = NULL;
571 cmdline = NULL;
572 /* If no args, spawn real shell for interactive use. */
573 need_shell = TRUE;
574 interactive = TRUE;
575 /* Ask command.com to create an environment block with a reasonable
576 amount of free space. */
577 envsize = get_env_size () + 300;
578 pass_through_args = (char **) alloca (argc * sizeof (char *));
579 num_pass_through_args = 0;
581 while (--argc > 0)
583 ++argv;
584 /* Act on switches we recognize (mostly single letter switches,
585 except for -e); all unrecognized switches and extra args are
586 passed on to real shell if used (only really of benefit for
587 interactive use, but allow for batch use as well). Accept / as
588 switch char for compatibility with cmd.exe. */
589 if (((*argv)[0] == '-' || (*argv)[0] == '/') && (*argv)[1] != '\0')
591 if (((*argv)[1] == 'c' || (*argv)[1] == 'C') && ((*argv)[2] == '\0'))
593 if (--argc == 0)
594 fail ("error: expecting arg for %s\n", *argv);
595 cmdline = *(++argv);
596 interactive = FALSE;
598 else if (((*argv)[1] == 'i' || (*argv)[1] == 'I') && ((*argv)[2] == '\0'))
600 if (cmdline)
601 warn ("warning: %s ignored because of -c\n", *argv);
603 else if (((*argv)[1] == 'e' || (*argv)[1] == 'E') && ((*argv)[2] == ':'))
605 int requested_envsize = atoi (*argv + 3);
606 /* Enforce a reasonable minimum size, as above. */
607 if (requested_envsize > envsize)
608 envsize = requested_envsize;
609 /* For sanity, enforce a reasonable maximum. */
610 if (envsize > 32768)
611 envsize = 32768;
613 else
615 /* warn ("warning: unknown option %s ignored", *argv); */
616 pass_through_args[num_pass_through_args++] = *argv;
619 else
620 break;
623 #if 0
624 /* I think this is probably not useful - cmd.exe ignores extra
625 (non-switch) args in interactive mode, and they cannot be passed on
626 when -c was given. */
628 /* Collect any remaining args after (initial) switches. */
629 while (argc-- > 0)
631 pass_through_args[num_pass_through_args++] = *argv++;
633 #else
634 /* Probably a mistake for there to be extra args; not fatal. */
635 if (argc > 0)
636 warn ("warning: extra args ignored after '%s'\n", argv[-1]);
637 #endif
639 pass_through_args[num_pass_through_args] = NULL;
641 /* If -c option, determine if we must spawn a real shell, or if we can
642 execute the command directly ourself. */
643 if (cmdline)
645 const char *args;
647 /* The program name is the first token of cmdline. Since
648 filenames cannot legally contain embedded quotes, the value
649 of escape_char doesn't matter. */
650 args = cmdline;
651 if (!get_next_token (path, &args))
652 fail ("error: no program name specified.\n");
654 canon_filename (path);
655 progname = make_absolute (path);
657 /* If we found the program and the rest of the command line does
658 not contain unquoted shell metacharacters, run the program
659 directly (if not found it might be an internal shell command,
660 so don't fail). */
661 if (progname != NULL && try_dequote_cmdline (cmdline))
662 need_shell = FALSE;
663 else
664 progname = NULL;
667 pass_to_shell:
668 if (need_shell)
670 char * p;
671 int extra_arg_space = 0;
672 int maxlen, remlen;
673 int run_command_dot_com;
675 progname = getenv ("COMSPEC");
676 if (!progname)
677 fail ("error: COMSPEC is not set\n");
679 canon_filename (progname);
680 progname = make_absolute (progname);
682 if (progname == NULL || strchr (progname, '\\') == NULL)
683 fail ("error: the program %s could not be found.\n", getenv ("COMSPEC"));
685 /* Need to set environment size when running command.com. */
686 run_command_dot_com =
687 (stricmp (strrchr (progname, '\\'), "command.com") == 0);
689 /* Work out how much extra space is required for
690 pass_through_args. */
691 for (argv = pass_through_args; *argv != NULL; ++argv)
692 /* We don't expect to have to quote switches. */
693 extra_arg_space += strlen (*argv) + 2;
695 if (cmdline)
697 char * buf;
699 /* Convert to syntax expected by cmd.exe/command.com for
700 running non-interactively. Always quote program name in
701 case path contains spaces (fortunately it can't contain
702 quotes, since they are illegal in path names). */
704 remlen = maxlen =
705 strlen (progname) + extra_arg_space + strlen (cmdline) + 16;
706 buf = p = alloca (maxlen + 1);
708 /* Quote progname in case it contains spaces. */
709 p += _snprintf (p, remlen, "\"%s\"", progname);
710 remlen = maxlen - (p - buf);
712 /* Include pass_through_args verbatim; these are just switches
713 so should not need quoting. */
714 for (argv = pass_through_args; *argv != NULL; ++argv)
716 p += _snprintf (p, remlen, " %s", *argv);
717 remlen = maxlen - (p - buf);
720 if (run_command_dot_com)
721 _snprintf (p, remlen, " /e:%d /c %s", envsize, cmdline);
722 else
723 _snprintf (p, remlen, " /c %s", cmdline);
724 cmdline = buf;
726 else
728 if (run_command_dot_com)
730 /* Provide dir arg expected by command.com when first
731 started interactively (the "command search path"). To
732 avoid potential problems with spaces in command dir
733 (which cannot be quoted - command.com doesn't like it),
734 we always use the 8.3 form. */
735 GetShortPathName (progname, path, sizeof (path));
736 p = strrchr (path, '\\');
737 /* Trailing slash is acceptable, so always leave it. */
738 *(++p) = '\0';
740 else
741 path[0] = '\0';
743 remlen = maxlen =
744 strlen (progname) + extra_arg_space + strlen (path) + 13;
745 cmdline = p = alloca (maxlen + 1);
747 /* Quote progname in case it contains spaces. */
748 p += _snprintf (p, remlen, "\"%s\" %s", progname, path);
749 remlen = maxlen - (p - cmdline);
751 /* Include pass_through_args verbatim; these are just switches
752 so should not need quoting. */
753 for (argv = pass_through_args; *argv != NULL; ++argv)
755 p += _snprintf (p, remlen, " %s", *argv);
756 remlen = maxlen - (p - cmdline);
759 if (run_command_dot_com)
760 _snprintf (p, remlen, " /e:%d", envsize);
764 if (!progname)
765 fail ("Internal error: program name not defined\n");
767 if (!cmdline)
768 cmdline = progname;
770 if (spawn (progname, cmdline, dir, &rc))
771 return rc;
773 if (!need_shell)
775 need_shell = TRUE;
776 goto pass_to_shell;
779 fail ("Could not run %s\n", progname);
781 return 0;