* lisp/printing.el (pr-menu-bind): Doc fix.
[emacs.git] / nt / cmdproxy.c
blob4f2d113a900d9f07d4a0bccbea8170a7f2217465
1 /* Proxy shell designed for use with Emacs on Windows 95 and NT.
2 Copyright (C) 1997, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
3 2008, 2009, 2010 Free Software Foundation, Inc.
5 Accepts subset of Unix sh(1) command-line options, for compatibility
6 with elisp code written for Unix. When possible, executes external
7 programs directly (a common use of /bin/sh by Emacs), otherwise
8 invokes the user-specified command processor to handle built-in shell
9 commands, batch files and interactive mode.
11 The main function is simply to process the "-c string" option in the
12 way /bin/sh does, since the standard Windows command shells use the
13 convention that everything after "/c" (the Windows equivalent of
14 "-c") is the input string.
16 This file is part of GNU Emacs.
18 GNU Emacs is free software: you can redistribute it and/or modify
19 it under the terms of the GNU General Public License as published by
20 the Free Software Foundation, either version 3 of the License, or
21 (at your option) any later version.
23 GNU Emacs is distributed in the hope that it will be useful,
24 but WITHOUT ANY WARRANTY; without even the implied warranty of
25 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 GNU General Public License for more details.
28 You should have received a copy of the GNU General Public License
29 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
31 #include <windows.h>
33 #include <stdarg.h> /* va_args */
34 #include <malloc.h> /* alloca */
35 #include <stdlib.h> /* getenv */
36 #include <string.h> /* strlen */
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 stdin GetStdHandle (STD_INPUT_HANDLE)
47 #define stdout GetStdHandle (STD_OUTPUT_HANDLE)
48 #define stderr GetStdHandle (STD_ERROR_HANDLE)
50 int
51 vfprintf(HANDLE hnd, char * msg, va_list args)
53 DWORD bytes_written;
54 char buf[1024];
56 wvsprintf (buf, msg, args);
57 return WriteFile (hnd, buf, strlen (buf), &bytes_written, NULL);
60 int
61 fprintf(HANDLE hnd, char * msg, ...)
63 va_list args;
64 int rc;
66 va_start (args, msg);
67 rc = vfprintf (hnd, msg, args);
68 va_end (args);
70 return rc;
73 int
74 printf(char * msg, ...)
76 va_list args;
77 int rc;
79 va_start (args, msg);
80 rc = vfprintf (stdout, msg, args);
81 va_end (args);
83 return rc;
86 void
87 fail (char * msg, ...)
89 va_list args;
91 va_start (args, msg);
92 vfprintf (stderr, msg, args);
93 va_end (args);
95 exit (-1);
98 void
99 warn (char * msg, ...)
101 va_list args;
103 va_start (args, msg);
104 vfprintf (stderr, msg, args);
105 va_end (args);
108 /******************************************************************/
110 char *
111 canon_filename (char *fname)
113 char *p = fname;
115 while (*p)
117 if (*p == '/')
118 *p = '\\';
119 p++;
122 return fname;
125 char *
126 skip_space (char *str)
128 while (isspace (*str)) str++;
129 return str;
132 char *
133 skip_nonspace (char *str)
135 while (*str && !isspace (*str)) str++;
136 return str;
139 int escape_char = '\\';
141 /* Get next token from input, advancing pointer. */
143 get_next_token (char * buf, char ** pSrc)
145 char * p = *pSrc;
146 char * o = buf;
148 p = skip_space (p);
149 if (*p == '"')
151 int escape_char_run = 0;
153 /* Go through src until an ending quote is found, unescaping
154 quotes along the way. If the escape char is not quote, then do
155 special handling of multiple escape chars preceding a quote
156 char (ie. the reverse of what Emacs does to escape quotes). */
157 p++;
158 while (1)
160 if (p[0] == escape_char && escape_char != '"')
162 escape_char_run++;
163 p++;
164 continue;
166 else if (p[0] == '"')
168 while (escape_char_run > 1)
170 *o++ = escape_char;
171 escape_char_run -= 2;
174 if (escape_char_run > 0)
176 /* escaped quote */
177 *o++ = *p++;
178 escape_char_run = 0;
180 else if (p[1] == escape_char && escape_char == '"')
182 /* quote escaped by doubling */
183 *o++ = *p;
184 p += 2;
186 else
188 /* The ending quote. */
189 *o = '\0';
190 /* Leave input pointer after token. */
191 p++;
192 break;
195 else if (p[0] == '\0')
197 /* End of string, but no ending quote found. We might want to
198 flag this as an error, but for now will consider the end as
199 the end of the token. */
200 *o = '\0';
201 break;
203 else
205 *o++ = *p++;
209 else
211 /* Next token is delimited by whitespace. */
212 char * p1 = skip_nonspace (p);
213 memcpy (o, p, p1 - p);
214 o += (p1 - p);
215 *o = '\0';
216 p = p1;
219 *pSrc = p;
221 return o - buf;
224 /* Search for EXEC file in DIR. If EXEC does not have an extension,
225 DIR is searched for EXEC with the standard extensions appended. */
227 search_dir (char *dir, char *exec, int bufsize, char *buffer)
229 char *exts[] = {".bat", ".cmd", ".exe", ".com"};
230 int n_exts = sizeof (exts) / sizeof (char *);
231 char *dummy;
232 int i, rc;
234 /* Search the directory for the program. */
235 for (i = 0; i < n_exts; i++)
237 rc = SearchPath (dir, exec, exts[i], bufsize, buffer, &dummy);
238 if (rc > 0)
239 return rc;
242 return 0;
245 /* Return the absolute name of executable file PROG, including
246 any file extensions. If an absolute name for PROG cannot be found,
247 return NULL. */
248 char *
249 make_absolute (char *prog)
251 char absname[MAX_PATH];
252 char dir[MAX_PATH];
253 char curdir[MAX_PATH];
254 char *p, *fname;
255 char *path;
256 int i;
258 /* At least partial absolute path specified; search there. */
259 if ((isalpha (prog[0]) && prog[1] == ':') ||
260 (prog[0] == '\\'))
262 /* Split the directory from the filename. */
263 fname = strrchr (prog, '\\');
264 if (!fname)
265 /* Only a drive specifier is given. */
266 fname = prog + 2;
267 strncpy (dir, prog, fname - prog);
268 dir[fname - prog] = '\0';
270 /* Search the directory for the program. */
271 if (search_dir (dir, prog, MAX_PATH, absname) > 0)
272 return strdup (absname);
273 else
274 return NULL;
277 if (GetCurrentDirectory (MAX_PATH, curdir) <= 0)
278 return NULL;
280 /* Relative path; search in current dir. */
281 if (strpbrk (prog, "\\"))
283 if (search_dir (curdir, prog, MAX_PATH, absname) > 0)
284 return strdup (absname);
285 else
286 return NULL;
289 /* Just filename; search current directory then PATH. */
290 path = alloca (strlen (getenv ("PATH")) + strlen (curdir) + 2);
291 strcpy (path, curdir);
292 strcat (path, ";");
293 strcat (path, getenv ("PATH"));
295 while (*path)
297 /* Get next directory from path. */
298 p = path;
299 while (*p && *p != ';') p++;
300 strncpy (dir, path, p - path);
301 dir[p - path] = '\0';
303 /* Search the directory for the program. */
304 if (search_dir (dir, prog, MAX_PATH, absname) > 0)
305 return strdup (absname);
307 /* Move to the next directory. */
308 path = p + 1;
311 return NULL;
314 /*****************************************************************/
316 #if 0
317 char ** _argv;
318 int _argc;
320 /* Parse commandline into argv array, allowing proper quoting of args. */
321 void
322 setup_argv (void)
324 char * cmdline = GetCommandLine ();
325 int arg_bytes = 0;
329 #endif
331 /* Information about child proc is global, to allow for automatic
332 termination when interrupted. At the moment, only one child process
333 can be running at any one time. */
335 PROCESS_INFORMATION child;
336 int interactive = TRUE;
338 BOOL
339 console_event_handler (DWORD event)
341 switch (event)
343 case CTRL_C_EVENT:
344 case CTRL_BREAK_EVENT:
345 if (!interactive)
347 /* Both command.com and cmd.exe have the annoying behavior of
348 prompting "Terminate batch job (y/n)?" when interrupted
349 while running a batch file, even if running in
350 non-interactive (-c) mode. Try to make up for this
351 deficiency by forcibly terminating the subprocess if
352 running non-interactively. */
353 if (child.hProcess &&
354 WaitForSingleObject (child.hProcess, 500) != WAIT_OBJECT_0)
355 TerminateProcess (child.hProcess, 0);
356 exit (STATUS_CONTROL_C_EXIT);
358 break;
360 #if 0
361 default:
362 /* CLOSE, LOGOFF and SHUTDOWN events - actually we don't get these
363 under Windows 95. */
364 fail ("cmdproxy: received %d event\n", event);
365 if (child.hProcess)
366 TerminateProcess (child.hProcess, 0);
367 #endif
369 return TRUE;
372 /* Change from normal usage; return value indicates whether spawn
373 succeeded or failed - program return code is returned separately. */
375 spawn (char * progname, char * cmdline, char * dir, int * retcode)
377 BOOL success = FALSE;
378 SECURITY_ATTRIBUTES sec_attrs;
379 STARTUPINFO start;
380 /* In theory, passing NULL for the environment block to CreateProcess
381 is the same as passing the value of GetEnvironmentStrings, but
382 doing this explicitly seems to cure problems running DOS programs
383 in some cases. */
384 char * envblock = GetEnvironmentStrings ();
386 sec_attrs.nLength = sizeof (sec_attrs);
387 sec_attrs.lpSecurityDescriptor = NULL;
388 sec_attrs.bInheritHandle = FALSE;
390 memset (&start, 0, sizeof (start));
391 start.cb = sizeof (start);
393 if (CreateProcess (progname, cmdline, &sec_attrs, NULL, TRUE,
394 0, envblock, dir, &start, &child))
396 success = TRUE;
397 /* wait for completion and pass on return code */
398 WaitForSingleObject (child.hProcess, INFINITE);
399 if (retcode)
400 GetExitCodeProcess (child.hProcess, (DWORD *)retcode);
401 CloseHandle (child.hThread);
402 CloseHandle (child.hProcess);
403 child.hProcess = NULL;
406 FreeEnvironmentStrings (envblock);
408 return success;
411 /* Return size of current environment block. */
413 get_env_size ()
415 char * start = GetEnvironmentStrings ();
416 char * tmp = start;
418 while (tmp[0] || tmp[1])
419 ++tmp;
420 FreeEnvironmentStrings (start);
421 return tmp + 2 - start;
424 /******* Main program ********************************************/
427 main (int argc, char ** argv)
429 int rc;
430 int need_shell;
431 char * cmdline;
432 char * progname;
433 int envsize;
434 char **pass_through_args;
435 int num_pass_through_args;
436 char modname[MAX_PATH];
437 char path[MAX_PATH];
438 char dir[MAX_PATH];
441 interactive = TRUE;
443 SetConsoleCtrlHandler ((PHANDLER_ROUTINE) console_event_handler, TRUE);
445 if (!GetCurrentDirectory (sizeof (dir), dir))
446 fail ("error: GetCurrentDirectory failed\n");
448 /* We serve double duty: we can be called either as a proxy for the
449 real shell (that is, because we are defined to be the user shell),
450 or in our role as a helper application for running DOS programs.
451 In the former case, we interpret the command line options as if we
452 were a Unix shell, but in the latter case we simply pass our
453 command line to CreateProcess. We know which case we are dealing
454 with by whether argv[0] refers to ourself or to some other program.
455 (This relies on an arcane feature of CreateProcess, where we can
456 specify cmdproxy as the module to run, but specify a different
457 program in the command line - the MSVC startup code sets argv[0]
458 from the command line.) */
460 if (!GetModuleFileName (NULL, modname, sizeof (modname)))
461 fail ("error: GetModuleFileName failed\n");
463 /* Change directory to location of .exe so startup directory can be
464 deleted. */
465 progname = strrchr (modname, '\\');
466 *progname = '\0';
467 SetCurrentDirectory (modname);
468 *progname = '\\';
470 /* Due to problems with interaction between API functions that use "OEM"
471 codepage vs API functions that use the "ANSI" codepage, we need to
472 make things consistent by choosing one and sticking with it. */
473 SetConsoleCP (GetACP());
474 SetConsoleOutputCP (GetACP());
476 /* Although Emacs always sets argv[0] to an absolute pathname, we
477 might get run in other ways as well, so convert argv[0] to an
478 absolute name before comparing to the module name. Don't get
479 caught out by mixed short and long names. */
480 GetShortPathName (modname, modname, sizeof (modname));
481 path[0] = '\0';
482 if (!SearchPath (NULL, argv[0], ".exe", sizeof (path), path, &progname)
483 || !GetShortPathName (path, path, sizeof (path))
484 || stricmp (modname, path) != 0)
486 /* We are being used as a helper to run a DOS app; just pass
487 command line to DOS app without change. */
488 /* TODO: fill in progname. */
489 if (spawn (NULL, GetCommandLine (), dir, &rc))
490 return rc;
491 fail ("Could not run %s\n", GetCommandLine ());
494 /* Process command line. If running interactively (-c or /c not
495 specified) then spawn a real command shell, passing it the command
496 line arguments.
498 If not running interactively, then attempt to execute the specified
499 command directly. If necessary, spawn a real shell to execute the
500 command.
504 progname = NULL;
505 cmdline = NULL;
506 /* If no args, spawn real shell for interactive use. */
507 need_shell = TRUE;
508 interactive = TRUE;
509 /* Ask command.com to create an environment block with a reasonable
510 amount of free space. */
511 envsize = get_env_size () + 300;
512 pass_through_args = (char **) alloca (argc * sizeof(char *));
513 num_pass_through_args = 0;
515 while (--argc > 0)
517 ++argv;
518 /* Act on switches we recognize (mostly single letter switches,
519 except for -e); all unrecognized switches and extra args are
520 passed on to real shell if used (only really of benefit for
521 interactive use, but allow for batch use as well). Accept / as
522 switch char for compatibility with cmd.exe. */
523 if (((*argv)[0] == '-' || (*argv)[0] == '/') && (*argv)[1] != '\0')
525 if (((*argv)[1] == 'c' || (*argv)[1] == 'C') && ((*argv)[2] == '\0'))
527 if (--argc == 0)
528 fail ("error: expecting arg for %s\n", *argv);
529 cmdline = *(++argv);
530 interactive = FALSE;
532 else if (((*argv)[1] == 'i' || (*argv)[1] == 'I') && ((*argv)[2] == '\0'))
534 if (cmdline)
535 warn ("warning: %s ignored because of -c\n", *argv);
537 else if (((*argv)[1] == 'e' || (*argv)[1] == 'E') && ((*argv)[2] == ':'))
539 int requested_envsize = atoi (*argv + 3);
540 /* Enforce a reasonable minimum size, as above. */
541 if (requested_envsize > envsize)
542 envsize = requested_envsize;
543 /* For sanity, enforce a reasonable maximum. */
544 if (envsize > 32768)
545 envsize = 32768;
547 else
549 /* warn ("warning: unknown option %s ignored", *argv); */
550 pass_through_args[num_pass_through_args++] = *argv;
553 else
554 break;
557 #if 0
558 /* I think this is probably not useful - cmd.exe ignores extra
559 (non-switch) args in interactive mode, and they cannot be passed on
560 when -c was given. */
562 /* Collect any remaining args after (initial) switches. */
563 while (argc-- > 0)
565 pass_through_args[num_pass_through_args++] = *argv++;
567 #else
568 /* Probably a mistake for there to be extra args; not fatal. */
569 if (argc > 0)
570 warn ("warning: extra args ignored after '%s'\n", argv[-1]);
571 #endif
573 pass_through_args[num_pass_through_args] = NULL;
575 /* If -c option, determine if we must spawn a real shell, or if we can
576 execute the command directly ourself. */
577 if (cmdline)
579 /* If no redirection or piping, and if program can be found, then
580 run program directly. Otherwise invoke a real shell. */
582 static char copout_chars[] = "|<>&";
584 if (strpbrk (cmdline, copout_chars) == NULL)
586 char *args;
588 /* The program name is the first token of cmdline. Since
589 filenames cannot legally contain embedded quotes, the value
590 of escape_char doesn't matter. */
591 args = cmdline;
592 if (!get_next_token (path, &args))
593 fail ("error: no program name specified.\n");
595 canon_filename (path);
596 progname = make_absolute (path);
598 /* If we found the program, run it directly (if not found it
599 might be an internal shell command, so don't fail). */
600 if (progname != NULL)
601 need_shell = FALSE;
605 pass_to_shell:
606 if (need_shell)
608 char * p;
609 int extra_arg_space = 0;
610 int maxlen, remlen;
611 int run_command_dot_com;
613 progname = getenv ("COMSPEC");
614 if (!progname)
615 fail ("error: COMSPEC is not set\n");
617 canon_filename (progname);
618 progname = make_absolute (progname);
620 if (progname == NULL || strchr (progname, '\\') == NULL)
621 fail ("error: the program %s could not be found.\n", getenv ("COMSPEC"));
623 /* Need to set environment size when running command.com. */
624 run_command_dot_com =
625 (stricmp (strrchr (progname, '\\'), "command.com") == 0);
627 /* Work out how much extra space is required for
628 pass_through_args. */
629 for (argv = pass_through_args; *argv != NULL; ++argv)
630 /* We don't expect to have to quote switches. */
631 extra_arg_space += strlen (*argv) + 2;
633 if (cmdline)
635 char * buf;
637 /* Convert to syntax expected by cmd.exe/command.com for
638 running non-interactively. Always quote program name in
639 case path contains spaces (fortunately it can't contain
640 quotes, since they are illegal in path names). */
642 remlen = maxlen =
643 strlen (progname) + extra_arg_space + strlen (cmdline) + 16;
644 buf = p = alloca (maxlen + 1);
646 /* Quote progname in case it contains spaces. */
647 p += _snprintf (p, remlen, "\"%s\"", progname);
648 remlen = maxlen - (p - buf);
650 /* Include pass_through_args verbatim; these are just switches
651 so should not need quoting. */
652 for (argv = pass_through_args; *argv != NULL; ++argv)
654 p += _snprintf (p, remlen, " %s", *argv);
655 remlen = maxlen - (p - buf);
658 if (run_command_dot_com)
659 _snprintf (p, remlen, " /e:%d /c %s", envsize, cmdline);
660 else
661 _snprintf (p, remlen, " /c %s", cmdline);
662 remlen = maxlen - (p - buf);
663 cmdline = buf;
665 else
667 if (run_command_dot_com)
669 /* Provide dir arg expected by command.com when first
670 started interactively (the "command search path"). To
671 avoid potential problems with spaces in command dir
672 (which cannot be quoted - command.com doesn't like it),
673 we always use the 8.3 form. */
674 GetShortPathName (progname, path, sizeof (path));
675 p = strrchr (path, '\\');
676 /* Trailing slash is acceptable, so always leave it. */
677 *(++p) = '\0';
679 else
680 path[0] = '\0';
682 remlen = maxlen =
683 strlen (progname) + extra_arg_space + strlen (path) + 13;
684 cmdline = p = alloca (maxlen + 1);
686 /* Quote progname in case it contains spaces. */
687 p += _snprintf (p, remlen, "\"%s\" %s", progname, path);
688 remlen = maxlen - (p - cmdline);
690 /* Include pass_through_args verbatim; these are just switches
691 so should not need quoting. */
692 for (argv = pass_through_args; *argv != NULL; ++argv)
694 p += _snprintf (p, remlen, " %s", *argv);
695 remlen = maxlen - (p - cmdline);
698 if (run_command_dot_com)
700 _snprintf (p, remlen, " /e:%d", envsize);
701 remlen = maxlen - (p - cmdline);
706 if (!progname)
707 fail ("Internal error: program name not defined\n");
709 if (!cmdline)
710 cmdline = progname;
712 if (spawn (progname, cmdline, dir, &rc))
713 return rc;
715 if (!need_shell)
717 need_shell = TRUE;
718 goto pass_to_shell;
721 fail ("Could not run %s\n", progname);
723 return 0;
726 /* arch-tag: 88678d93-07ac-4e2f-ad63-d4a740ca69ac
727 (do not change this comment) */