More robust creation of a subprocess, attempt to solve bug #13546.
[emacs.git] / src / w32proc.c
blob1e72d41e16b2ac7902b7807a991edf69f70ce615
1 /* Process support for GNU Emacs on the Microsoft Windows API.
2 Copyright (C) 1992, 1995, 1999-2013 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 Drew Bliss Oct 14, 1993
21 Adapted from alarm.c by Tim Fleehart
24 #include <stdio.h>
25 #include <stdlib.h>
26 #include <errno.h>
27 #include <ctype.h>
28 #include <io.h>
29 #include <fcntl.h>
30 #include <signal.h>
31 #include <sys/file.h>
33 /* must include CRT headers *before* config.h */
34 #include <config.h>
36 #undef signal
37 #undef wait
38 #undef spawnve
39 #undef select
40 #undef kill
42 #include <windows.h>
43 #ifdef __GNUC__
44 /* This definition is missing from mingw32 headers. */
45 extern BOOL WINAPI IsValidLocale (LCID, DWORD);
46 #endif
48 #ifdef HAVE_LANGINFO_CODESET
49 #include <nl_types.h>
50 #include <langinfo.h>
51 #endif
53 #include "lisp.h"
54 #include "w32.h"
55 #include "w32common.h"
56 #include "w32heap.h"
57 #include "systime.h"
58 #include "syswait.h"
59 #include "process.h"
60 #include "syssignal.h"
61 #include "w32term.h"
62 #include "dispextern.h" /* for xstrcasecmp */
63 #include "coding.h"
65 #define RVA_TO_PTR(var,section,filedata) \
66 ((void *)((section)->PointerToRawData \
67 + ((DWORD_PTR)(var) - (section)->VirtualAddress) \
68 + (filedata).file_base))
70 Lisp_Object Qhigh, Qlow;
72 /* Signal handlers...SIG_DFL == 0 so this is initialized correctly. */
73 static signal_handler sig_handlers[NSIG];
75 static sigset_t sig_mask;
77 static CRITICAL_SECTION crit_sig;
79 /* Improve on the CRT 'signal' implementation so that we could record
80 the SIGCHLD handler and fake interval timers. */
81 signal_handler
82 sys_signal (int sig, signal_handler handler)
84 signal_handler old;
86 /* SIGCHLD is needed for supporting subprocesses, see sys_kill
87 below. SIGALRM and SIGPROF are used by setitimer. All the
88 others are the only ones supported by the MS runtime. */
89 if (!(sig == SIGCHLD || sig == SIGSEGV || sig == SIGILL
90 || sig == SIGFPE || sig == SIGABRT || sig == SIGTERM
91 || sig == SIGALRM || sig == SIGPROF))
93 errno = EINVAL;
94 return SIG_ERR;
96 old = sig_handlers[sig];
97 /* SIGABRT is treated specially because w32.c installs term_ntproc
98 as its handler, so we don't want to override that afterwards.
99 Aborting Emacs works specially anyway: either by calling
100 emacs_abort directly or through terminate_due_to_signal, which
101 calls emacs_abort through emacs_raise. */
102 if (!(sig == SIGABRT && old == term_ntproc))
104 sig_handlers[sig] = handler;
105 if (!(sig == SIGCHLD || sig == SIGALRM || sig == SIGPROF))
106 signal (sig, handler);
108 return old;
111 /* Emulate sigaction. */
113 sigaction (int sig, const struct sigaction *act, struct sigaction *oact)
115 signal_handler old = SIG_DFL;
116 int retval = 0;
118 if (act)
119 old = sys_signal (sig, act->sa_handler);
120 else if (oact)
121 old = sig_handlers[sig];
123 if (old == SIG_ERR)
125 errno = EINVAL;
126 retval = -1;
128 if (oact)
130 oact->sa_handler = old;
131 oact->sa_flags = 0;
132 oact->sa_mask = empty_mask;
134 return retval;
137 /* Emulate signal sets and blocking of signals used by timers. */
140 sigemptyset (sigset_t *set)
142 *set = 0;
143 return 0;
147 sigaddset (sigset_t *set, int signo)
149 if (!set)
151 errno = EINVAL;
152 return -1;
154 if (signo < 0 || signo >= NSIG)
156 errno = EINVAL;
157 return -1;
160 *set |= (1U << signo);
162 return 0;
166 sigfillset (sigset_t *set)
168 if (!set)
170 errno = EINVAL;
171 return -1;
174 *set = 0xFFFFFFFF;
175 return 0;
179 sigprocmask (int how, const sigset_t *set, sigset_t *oset)
181 if (!(how == SIG_BLOCK || how == SIG_UNBLOCK || how == SIG_SETMASK))
183 errno = EINVAL;
184 return -1;
187 if (oset)
188 *oset = sig_mask;
190 if (!set)
191 return 0;
193 switch (how)
195 case SIG_BLOCK:
196 sig_mask |= *set;
197 break;
198 case SIG_SETMASK:
199 sig_mask = *set;
200 break;
201 case SIG_UNBLOCK:
202 /* FIXME: Catch signals that are blocked and reissue them when
203 they are unblocked. Important for SIGALRM and SIGPROF only. */
204 sig_mask &= ~(*set);
205 break;
208 return 0;
212 pthread_sigmask (int how, const sigset_t *set, sigset_t *oset)
214 if (sigprocmask (how, set, oset) == -1)
215 return EINVAL;
216 return 0;
220 sigismember (const sigset_t *set, int signo)
222 if (signo < 0 || signo >= NSIG)
224 errno = EINVAL;
225 return -1;
227 if (signo > sizeof (*set) * BITS_PER_CHAR)
228 emacs_abort ();
230 return (*set & (1U << signo)) != 0;
234 setpgrp (int pid, int gid)
236 return 0;
239 pid_t
240 getpgrp (void)
242 return getpid ();
246 setpgid (pid_t pid, pid_t pgid)
248 return 0;
251 /* Emulations of interval timers.
253 Limitations: only ITIMER_REAL and ITIMER_PROF are supported.
255 Implementation: a separate thread is started for each timer type,
256 the thread calls the appropriate signal handler when the timer
257 expires, after stopping the thread which installed the timer. */
259 struct itimer_data {
260 volatile ULONGLONG expire;
261 volatile ULONGLONG reload;
262 volatile int terminate;
263 int type;
264 HANDLE caller_thread;
265 HANDLE timer_thread;
268 static ULONGLONG ticks_now;
269 static struct itimer_data real_itimer, prof_itimer;
270 static ULONGLONG clocks_min;
271 /* If non-zero, itimers are disabled. Used during shutdown, when we
272 delete the critical sections used by the timer threads. */
273 static int disable_itimers;
275 static CRITICAL_SECTION crit_real, crit_prof;
277 /* GetThreadTimes is not available on Windows 9X and possibly also on 2K. */
278 typedef BOOL (WINAPI *GetThreadTimes_Proc) (
279 HANDLE hThread,
280 LPFILETIME lpCreationTime,
281 LPFILETIME lpExitTime,
282 LPFILETIME lpKernelTime,
283 LPFILETIME lpUserTime);
285 static GetThreadTimes_Proc s_pfn_Get_Thread_Times;
287 #define MAX_SINGLE_SLEEP 30
288 #define TIMER_TICKS_PER_SEC 1000
290 /* Return a suitable time value, in 1-ms units, for THREAD, a handle
291 to a thread. If THREAD is NULL or an invalid handle, return the
292 current wall-clock time since January 1, 1601 (UTC). Otherwise,
293 return the sum of kernel and user times used by THREAD since it was
294 created, plus its creation time. */
295 static ULONGLONG
296 w32_get_timer_time (HANDLE thread)
298 ULONGLONG retval;
299 int use_system_time = 1;
300 /* The functions below return times in 100-ns units. */
301 const int tscale = 10 * TIMER_TICKS_PER_SEC;
303 if (thread && thread != INVALID_HANDLE_VALUE
304 && s_pfn_Get_Thread_Times != NULL)
306 FILETIME creation_ftime, exit_ftime, kernel_ftime, user_ftime;
307 ULARGE_INTEGER temp_creation, temp_kernel, temp_user;
309 if (s_pfn_Get_Thread_Times (thread, &creation_ftime, &exit_ftime,
310 &kernel_ftime, &user_ftime))
312 use_system_time = 0;
313 temp_creation.LowPart = creation_ftime.dwLowDateTime;
314 temp_creation.HighPart = creation_ftime.dwHighDateTime;
315 temp_kernel.LowPart = kernel_ftime.dwLowDateTime;
316 temp_kernel.HighPart = kernel_ftime.dwHighDateTime;
317 temp_user.LowPart = user_ftime.dwLowDateTime;
318 temp_user.HighPart = user_ftime.dwHighDateTime;
319 retval =
320 temp_creation.QuadPart / tscale + temp_kernel.QuadPart / tscale
321 + temp_user.QuadPart / tscale;
323 else
324 DebPrint (("GetThreadTimes failed with error code %lu\n",
325 GetLastError ()));
328 if (use_system_time)
330 FILETIME current_ftime;
331 ULARGE_INTEGER temp;
333 GetSystemTimeAsFileTime (&current_ftime);
335 temp.LowPart = current_ftime.dwLowDateTime;
336 temp.HighPart = current_ftime.dwHighDateTime;
338 retval = temp.QuadPart / tscale;
341 return retval;
344 /* Thread function for a timer thread. */
345 static DWORD WINAPI
346 timer_loop (LPVOID arg)
348 struct itimer_data *itimer = (struct itimer_data *)arg;
349 int which = itimer->type;
350 int sig = (which == ITIMER_REAL) ? SIGALRM : SIGPROF;
351 CRITICAL_SECTION *crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
352 const DWORD max_sleep = MAX_SINGLE_SLEEP * 1000 / TIMER_TICKS_PER_SEC;
353 HANDLE hth = (which == ITIMER_REAL) ? NULL : itimer->caller_thread;
355 while (1)
357 DWORD sleep_time;
358 signal_handler handler;
359 ULONGLONG now, expire, reload;
361 /* Load new values if requested by setitimer. */
362 EnterCriticalSection (crit);
363 expire = itimer->expire;
364 reload = itimer->reload;
365 LeaveCriticalSection (crit);
366 if (itimer->terminate)
367 return 0;
369 if (expire == 0)
371 /* We are idle. */
372 Sleep (max_sleep);
373 continue;
376 if (expire > (now = w32_get_timer_time (hth)))
377 sleep_time = expire - now;
378 else
379 sleep_time = 0;
380 /* Don't sleep too long at a time, to be able to see the
381 termination flag without too long a delay. */
382 while (sleep_time > max_sleep)
384 if (itimer->terminate)
385 return 0;
386 Sleep (max_sleep);
387 EnterCriticalSection (crit);
388 expire = itimer->expire;
389 LeaveCriticalSection (crit);
390 sleep_time =
391 (expire > (now = w32_get_timer_time (hth))) ? expire - now : 0;
393 if (itimer->terminate)
394 return 0;
395 if (sleep_time > 0)
397 Sleep (sleep_time * 1000 / TIMER_TICKS_PER_SEC);
398 /* Always sleep past the expiration time, to make sure we
399 never call the handler _before_ the expiration time,
400 always slightly after it. Sleep(5) makes sure we don't
401 hog the CPU by calling 'w32_get_timer_time' with high
402 frequency, and also let other threads work. */
403 while (w32_get_timer_time (hth) < expire)
404 Sleep (5);
407 EnterCriticalSection (crit);
408 expire = itimer->expire;
409 LeaveCriticalSection (crit);
410 if (expire == 0)
411 continue;
413 /* Time's up. */
414 handler = sig_handlers[sig];
415 if (!(handler == SIG_DFL || handler == SIG_IGN || handler == SIG_ERR)
416 /* FIXME: Don't ignore masked signals. Instead, record that
417 they happened and reissue them when the signal is
418 unblocked. */
419 && !sigismember (&sig_mask, sig)
420 /* Simulate masking of SIGALRM and SIGPROF when processing
421 fatal signals. */
422 && !fatal_error_in_progress
423 && itimer->caller_thread)
425 /* Simulate a signal delivered to the thread which installed
426 the timer, by suspending that thread while the handler
427 runs. */
428 HANDLE th = itimer->caller_thread;
429 DWORD result = SuspendThread (th);
431 if (result == (DWORD)-1)
432 return 2;
434 handler (sig);
435 ResumeThread (th);
438 /* Update expiration time and loop. */
439 EnterCriticalSection (crit);
440 expire = itimer->expire;
441 if (expire == 0)
443 LeaveCriticalSection (crit);
444 continue;
446 reload = itimer->reload;
447 if (reload > 0)
449 now = w32_get_timer_time (hth);
450 if (expire <= now)
452 ULONGLONG lag = now - expire;
454 /* If we missed some opportunities (presumably while
455 sleeping or while the signal handler ran), skip
456 them. */
457 if (lag > reload)
458 expire = now - (lag % reload);
460 expire += reload;
463 else
464 expire = 0; /* become idle */
465 itimer->expire = expire;
466 LeaveCriticalSection (crit);
468 return 0;
471 static void
472 stop_timer_thread (int which)
474 struct itimer_data *itimer =
475 (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
476 int i;
477 DWORD err, exit_code = 255;
478 BOOL status;
480 /* Signal the thread that it should terminate. */
481 itimer->terminate = 1;
483 if (itimer->timer_thread == NULL)
484 return;
486 /* Wait for the timer thread to terminate voluntarily, then kill it
487 if it doesn't. This loop waits twice more than the maximum
488 amount of time a timer thread sleeps, see above. */
489 for (i = 0; i < MAX_SINGLE_SLEEP / 5; i++)
491 if (!((status = GetExitCodeThread (itimer->timer_thread, &exit_code))
492 && exit_code == STILL_ACTIVE))
493 break;
494 Sleep (10);
496 if ((status == FALSE && (err = GetLastError ()) == ERROR_INVALID_HANDLE)
497 || exit_code == STILL_ACTIVE)
499 if (!(status == FALSE && err == ERROR_INVALID_HANDLE))
500 TerminateThread (itimer->timer_thread, 0);
503 /* Clean up. */
504 CloseHandle (itimer->timer_thread);
505 itimer->timer_thread = NULL;
506 if (itimer->caller_thread)
508 CloseHandle (itimer->caller_thread);
509 itimer->caller_thread = NULL;
513 /* This is called at shutdown time from term_ntproc. */
514 void
515 term_timers (void)
517 if (real_itimer.timer_thread)
518 stop_timer_thread (ITIMER_REAL);
519 if (prof_itimer.timer_thread)
520 stop_timer_thread (ITIMER_PROF);
522 /* We are going to delete the critical sections, so timers cannot
523 work after this. */
524 disable_itimers = 1;
526 DeleteCriticalSection (&crit_real);
527 DeleteCriticalSection (&crit_prof);
528 DeleteCriticalSection (&crit_sig);
531 /* This is called at initialization time from init_ntproc. */
532 void
533 init_timers (void)
535 /* GetThreadTimes is not available on all versions of Windows, so
536 need to probe for its availability dynamically, and call it
537 through a pointer. */
538 s_pfn_Get_Thread_Times = NULL; /* in case dumped Emacs comes with a value */
539 if (os_subtype != OS_9X)
540 s_pfn_Get_Thread_Times =
541 (GetThreadTimes_Proc)GetProcAddress (GetModuleHandle ("kernel32.dll"),
542 "GetThreadTimes");
544 /* Make sure we start with zeroed out itimer structures, since
545 dumping may have left there traces of threads long dead. */
546 memset (&real_itimer, 0, sizeof real_itimer);
547 memset (&prof_itimer, 0, sizeof prof_itimer);
549 InitializeCriticalSection (&crit_real);
550 InitializeCriticalSection (&crit_prof);
551 InitializeCriticalSection (&crit_sig);
553 disable_itimers = 0;
556 static int
557 start_timer_thread (int which)
559 DWORD exit_code;
560 HANDLE th;
561 struct itimer_data *itimer =
562 (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
564 if (itimer->timer_thread
565 && GetExitCodeThread (itimer->timer_thread, &exit_code)
566 && exit_code == STILL_ACTIVE)
567 return 0;
569 /* Clean up after possibly exited thread. */
570 if (itimer->timer_thread)
572 CloseHandle (itimer->timer_thread);
573 itimer->timer_thread = NULL;
575 if (itimer->caller_thread)
577 CloseHandle (itimer->caller_thread);
578 itimer->caller_thread = NULL;
581 /* Start a new thread. */
582 if (!DuplicateHandle (GetCurrentProcess (), GetCurrentThread (),
583 GetCurrentProcess (), &th, 0, FALSE,
584 DUPLICATE_SAME_ACCESS))
586 errno = ESRCH;
587 return -1;
589 itimer->terminate = 0;
590 itimer->type = which;
591 itimer->caller_thread = th;
592 /* Request that no more than 64KB of stack be reserved for this
593 thread, to avoid reserving too much memory, which would get in
594 the way of threads we start to wait for subprocesses. See also
595 new_child below. */
596 itimer->timer_thread = CreateThread (NULL, 64 * 1024, timer_loop,
597 (void *)itimer, 0x00010000, NULL);
599 if (!itimer->timer_thread)
601 CloseHandle (itimer->caller_thread);
602 itimer->caller_thread = NULL;
603 errno = EAGAIN;
604 return -1;
607 /* This is needed to make sure that the timer thread running for
608 profiling gets CPU as soon as the Sleep call terminates. */
609 if (which == ITIMER_PROF)
610 SetThreadPriority (itimer->timer_thread, THREAD_PRIORITY_TIME_CRITICAL);
612 return 0;
615 /* Most of the code of getitimer and setitimer (but not of their
616 subroutines) was shamelessly stolen from itimer.c in the DJGPP
617 library, see www.delorie.com/djgpp. */
619 getitimer (int which, struct itimerval *value)
621 volatile ULONGLONG *t_expire;
622 volatile ULONGLONG *t_reload;
623 ULONGLONG expire, reload;
624 __int64 usecs;
625 CRITICAL_SECTION *crit;
626 struct itimer_data *itimer;
628 if (disable_itimers)
629 return -1;
631 if (!value)
633 errno = EFAULT;
634 return -1;
637 if (which != ITIMER_REAL && which != ITIMER_PROF)
639 errno = EINVAL;
640 return -1;
643 itimer = (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
645 ticks_now = w32_get_timer_time ((which == ITIMER_REAL)
646 ? NULL
647 : GetCurrentThread ());
649 t_expire = &itimer->expire;
650 t_reload = &itimer->reload;
651 crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
653 EnterCriticalSection (crit);
654 reload = *t_reload;
655 expire = *t_expire;
656 LeaveCriticalSection (crit);
658 if (expire)
659 expire -= ticks_now;
661 value->it_value.tv_sec = expire / TIMER_TICKS_PER_SEC;
662 usecs =
663 (expire % TIMER_TICKS_PER_SEC) * (__int64)1000000 / TIMER_TICKS_PER_SEC;
664 value->it_value.tv_usec = usecs;
665 value->it_interval.tv_sec = reload / TIMER_TICKS_PER_SEC;
666 usecs =
667 (reload % TIMER_TICKS_PER_SEC) * (__int64)1000000 / TIMER_TICKS_PER_SEC;
668 value->it_interval.tv_usec= usecs;
670 return 0;
674 setitimer(int which, struct itimerval *value, struct itimerval *ovalue)
676 volatile ULONGLONG *t_expire, *t_reload;
677 ULONGLONG expire, reload, expire_old, reload_old;
678 __int64 usecs;
679 CRITICAL_SECTION *crit;
680 struct itimerval tem, *ptem;
682 if (disable_itimers)
683 return -1;
685 /* Posix systems expect timer values smaller than the resolution of
686 the system clock be rounded up to the clock resolution. First
687 time we are called, measure the clock tick resolution. */
688 if (!clocks_min)
690 ULONGLONG t1, t2;
692 for (t1 = w32_get_timer_time (NULL);
693 (t2 = w32_get_timer_time (NULL)) == t1; )
695 clocks_min = t2 - t1;
698 if (ovalue)
699 ptem = ovalue;
700 else
701 ptem = &tem;
703 if (getitimer (which, ptem)) /* also sets ticks_now */
704 return -1; /* errno already set */
706 t_expire =
707 (which == ITIMER_REAL) ? &real_itimer.expire : &prof_itimer.expire;
708 t_reload =
709 (which == ITIMER_REAL) ? &real_itimer.reload : &prof_itimer.reload;
711 crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
713 if (!value
714 || (value->it_value.tv_sec == 0 && value->it_value.tv_usec == 0))
716 EnterCriticalSection (crit);
717 /* Disable the timer. */
718 *t_expire = 0;
719 *t_reload = 0;
720 LeaveCriticalSection (crit);
721 return 0;
724 reload = value->it_interval.tv_sec * TIMER_TICKS_PER_SEC;
726 usecs = value->it_interval.tv_usec;
727 if (value->it_interval.tv_sec == 0
728 && usecs && usecs * TIMER_TICKS_PER_SEC < clocks_min * 1000000)
729 reload = clocks_min;
730 else
732 usecs *= TIMER_TICKS_PER_SEC;
733 reload += usecs / 1000000;
736 expire = value->it_value.tv_sec * TIMER_TICKS_PER_SEC;
737 usecs = value->it_value.tv_usec;
738 if (value->it_value.tv_sec == 0
739 && usecs * TIMER_TICKS_PER_SEC < clocks_min * 1000000)
740 expire = clocks_min;
741 else
743 usecs *= TIMER_TICKS_PER_SEC;
744 expire += usecs / 1000000;
747 expire += ticks_now;
749 EnterCriticalSection (crit);
750 expire_old = *t_expire;
751 reload_old = *t_reload;
752 if (!(expire == expire_old && reload == reload_old))
754 *t_reload = reload;
755 *t_expire = expire;
757 LeaveCriticalSection (crit);
759 return start_timer_thread (which);
763 alarm (int seconds)
765 #ifdef HAVE_SETITIMER
766 struct itimerval new_values, old_values;
768 new_values.it_value.tv_sec = seconds;
769 new_values.it_value.tv_usec = 0;
770 new_values.it_interval.tv_sec = new_values.it_interval.tv_usec = 0;
772 if (setitimer (ITIMER_REAL, &new_values, &old_values) < 0)
773 return 0;
774 return old_values.it_value.tv_sec;
775 #else
776 return seconds;
777 #endif
780 /* Defined in <process.h> which conflicts with the local copy */
781 #define _P_NOWAIT 1
783 /* Child process management list. */
784 int child_proc_count = 0;
785 child_process child_procs[ MAX_CHILDREN ];
786 child_process *dead_child = NULL;
788 static DWORD WINAPI reader_thread (void *arg);
790 /* Find an unused process slot. */
791 child_process *
792 new_child (void)
794 child_process *cp;
795 DWORD id;
797 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
798 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess == NULL)
799 goto Initialize;
800 if (child_proc_count == MAX_CHILDREN)
802 DebPrint (("new_child: No vacant slots, looking for dead processes\n"));
803 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
804 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess)
806 DWORD status = 0;
808 if (!GetExitCodeProcess (cp->procinfo.hProcess, &status))
810 DebPrint (("new_child.GetExitCodeProcess: error %lu for PID %lu\n",
811 GetLastError (), cp->procinfo.dwProcessId));
812 status = STILL_ACTIVE;
814 if (status != STILL_ACTIVE
815 || WaitForSingleObject (cp->procinfo.hProcess, 0) == WAIT_OBJECT_0)
817 DebPrint (("new_child: Freeing slot of dead process %d\n",
818 cp->procinfo.dwProcessId));
819 CloseHandle (cp->procinfo.hProcess);
820 cp->procinfo.hProcess = NULL;
821 CloseHandle (cp->procinfo.hThread);
822 cp->procinfo.hThread = NULL;
823 goto Initialize;
827 if (child_proc_count == MAX_CHILDREN)
828 return NULL;
829 cp = &child_procs[child_proc_count++];
831 Initialize:
832 memset (cp, 0, sizeof (*cp));
833 cp->fd = -1;
834 cp->pid = -1;
835 cp->procinfo.hProcess = NULL;
836 cp->status = STATUS_READ_ERROR;
838 /* use manual reset event so that select() will function properly */
839 cp->char_avail = CreateEvent (NULL, TRUE, FALSE, NULL);
840 if (cp->char_avail)
842 cp->char_consumed = CreateEvent (NULL, FALSE, FALSE, NULL);
843 if (cp->char_consumed)
845 /* The 0x00010000 flag is STACK_SIZE_PARAM_IS_A_RESERVATION.
846 It means that the 64K stack we are requesting in the 2nd
847 argument is how much memory should be reserved for the
848 stack. If we don't use this flag, the memory requested
849 by the 2nd argument is the amount actually _committed_,
850 but Windows reserves 8MB of memory for each thread's
851 stack. (The 8MB figure comes from the -stack
852 command-line argument we pass to the linker when building
853 Emacs, but that's because we need a large stack for
854 Emacs's main thread.) Since we request 2GB of reserved
855 memory at startup (see w32heap.c), which is close to the
856 maximum memory available for a 32-bit process on Windows,
857 the 8MB reservation for each thread causes failures in
858 starting subprocesses, because we create a thread running
859 reader_thread for each subprocess. As 8MB of stack is
860 way too much for reader_thread, forcing Windows to
861 reserve less wins the day. */
862 cp->thrd = CreateThread (NULL, 64 * 1024, reader_thread, cp,
863 0x00010000, &id);
864 if (cp->thrd)
865 return cp;
868 delete_child (cp);
869 return NULL;
872 void
873 delete_child (child_process *cp)
875 int i;
877 /* Should not be deleting a child that is still needed. */
878 for (i = 0; i < MAXDESC; i++)
879 if (fd_info[i].cp == cp)
880 emacs_abort ();
882 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess == NULL)
883 return;
885 /* reap thread if necessary */
886 if (cp->thrd)
888 DWORD rc;
890 if (GetExitCodeThread (cp->thrd, &rc) && rc == STILL_ACTIVE)
892 /* let the thread exit cleanly if possible */
893 cp->status = STATUS_READ_ERROR;
894 SetEvent (cp->char_consumed);
895 #if 0
896 /* We used to forcibly terminate the thread here, but it
897 is normally unnecessary, and in abnormal cases, the worst that
898 will happen is we have an extra idle thread hanging around
899 waiting for the zombie process. */
900 if (WaitForSingleObject (cp->thrd, 1000) != WAIT_OBJECT_0)
902 DebPrint (("delete_child.WaitForSingleObject (thread) failed "
903 "with %lu for fd %ld\n", GetLastError (), cp->fd));
904 TerminateThread (cp->thrd, 0);
906 #endif
908 CloseHandle (cp->thrd);
909 cp->thrd = NULL;
911 if (cp->char_avail)
913 CloseHandle (cp->char_avail);
914 cp->char_avail = NULL;
916 if (cp->char_consumed)
918 CloseHandle (cp->char_consumed);
919 cp->char_consumed = NULL;
922 /* update child_proc_count (highest numbered slot in use plus one) */
923 if (cp == child_procs + child_proc_count - 1)
925 for (i = child_proc_count-1; i >= 0; i--)
926 if (CHILD_ACTIVE (&child_procs[i])
927 || child_procs[i].procinfo.hProcess != NULL)
929 child_proc_count = i + 1;
930 break;
933 if (i < 0)
934 child_proc_count = 0;
937 /* Find a child by pid. */
938 static child_process *
939 find_child_pid (DWORD pid)
941 child_process *cp;
943 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
944 if ((CHILD_ACTIVE (cp) || cp->procinfo.hProcess != NULL)
945 && pid == cp->pid)
946 return cp;
947 return NULL;
951 /* Thread proc for child process and socket reader threads. Each thread
952 is normally blocked until woken by select() to check for input by
953 reading one char. When the read completes, char_avail is signaled
954 to wake up the select emulator and the thread blocks itself again. */
955 static DWORD WINAPI
956 reader_thread (void *arg)
958 child_process *cp;
960 /* Our identity */
961 cp = (child_process *)arg;
963 /* We have to wait for the go-ahead before we can start */
964 if (cp == NULL
965 || WaitForSingleObject (cp->char_consumed, INFINITE) != WAIT_OBJECT_0
966 || cp->fd < 0)
967 return 1;
969 for (;;)
971 int rc;
973 if (fd_info[cp->fd].flags & FILE_LISTEN)
974 rc = _sys_wait_accept (cp->fd);
975 else
976 rc = _sys_read_ahead (cp->fd);
978 /* The name char_avail is a misnomer - it really just means the
979 read-ahead has completed, whether successfully or not. */
980 if (!SetEvent (cp->char_avail))
982 DebPrint (("reader_thread.SetEvent failed with %lu for fd %ld\n",
983 GetLastError (), cp->fd));
984 return 1;
987 if (rc == STATUS_READ_ERROR)
988 return 1;
990 /* If the read died, the child has died so let the thread die */
991 if (rc == STATUS_READ_FAILED)
992 break;
994 /* Wait until our input is acknowledged before reading again */
995 if (WaitForSingleObject (cp->char_consumed, INFINITE) != WAIT_OBJECT_0)
997 DebPrint (("reader_thread.WaitForSingleObject failed with "
998 "%lu for fd %ld\n", GetLastError (), cp->fd));
999 break;
1002 return 0;
1005 /* To avoid Emacs changing directory, we just record here the directory
1006 the new process should start in. This is set just before calling
1007 sys_spawnve, and is not generally valid at any other time. */
1008 static char * process_dir;
1010 static BOOL
1011 create_child (char *exe, char *cmdline, char *env, int is_gui_app,
1012 int * pPid, child_process *cp)
1014 STARTUPINFO start;
1015 SECURITY_ATTRIBUTES sec_attrs;
1016 #if 0
1017 SECURITY_DESCRIPTOR sec_desc;
1018 #endif
1019 DWORD flags;
1020 char dir[ MAXPATHLEN ];
1022 if (cp == NULL) emacs_abort ();
1024 memset (&start, 0, sizeof (start));
1025 start.cb = sizeof (start);
1027 #ifdef HAVE_NTGUI
1028 if (NILP (Vw32_start_process_show_window) && !is_gui_app)
1029 start.dwFlags = STARTF_USESTDHANDLES | STARTF_USESHOWWINDOW;
1030 else
1031 start.dwFlags = STARTF_USESTDHANDLES;
1032 start.wShowWindow = SW_HIDE;
1034 start.hStdInput = GetStdHandle (STD_INPUT_HANDLE);
1035 start.hStdOutput = GetStdHandle (STD_OUTPUT_HANDLE);
1036 start.hStdError = GetStdHandle (STD_ERROR_HANDLE);
1037 #endif /* HAVE_NTGUI */
1039 #if 0
1040 /* Explicitly specify no security */
1041 if (!InitializeSecurityDescriptor (&sec_desc, SECURITY_DESCRIPTOR_REVISION))
1042 goto EH_Fail;
1043 if (!SetSecurityDescriptorDacl (&sec_desc, TRUE, NULL, FALSE))
1044 goto EH_Fail;
1045 #endif
1046 sec_attrs.nLength = sizeof (sec_attrs);
1047 sec_attrs.lpSecurityDescriptor = NULL /* &sec_desc */;
1048 sec_attrs.bInheritHandle = FALSE;
1050 strcpy (dir, process_dir);
1051 unixtodos_filename (dir);
1053 flags = (!NILP (Vw32_start_process_share_console)
1054 ? CREATE_NEW_PROCESS_GROUP
1055 : CREATE_NEW_CONSOLE);
1056 if (NILP (Vw32_start_process_inherit_error_mode))
1057 flags |= CREATE_DEFAULT_ERROR_MODE;
1058 if (!CreateProcess (exe, cmdline, &sec_attrs, NULL, TRUE,
1059 flags, env, dir, &start, &cp->procinfo))
1060 goto EH_Fail;
1062 cp->pid = (int) cp->procinfo.dwProcessId;
1064 /* Hack for Windows 95, which assigns large (ie negative) pids */
1065 if (cp->pid < 0)
1066 cp->pid = -cp->pid;
1068 /* pid must fit in a Lisp_Int */
1069 cp->pid = cp->pid & INTMASK;
1071 *pPid = cp->pid;
1073 return TRUE;
1075 EH_Fail:
1076 DebPrint (("create_child.CreateProcess failed: %ld\n", GetLastError ()););
1077 return FALSE;
1080 /* create_child doesn't know what emacs' file handle will be for waiting
1081 on output from the child, so we need to make this additional call
1082 to register the handle with the process
1083 This way the select emulator knows how to match file handles with
1084 entries in child_procs. */
1085 void
1086 register_child (int pid, int fd)
1088 child_process *cp;
1090 cp = find_child_pid (pid);
1091 if (cp == NULL)
1093 DebPrint (("register_child unable to find pid %lu\n", pid));
1094 return;
1097 #ifdef FULL_DEBUG
1098 DebPrint (("register_child registered fd %d with pid %lu\n", fd, pid));
1099 #endif
1101 cp->fd = fd;
1103 /* thread is initially blocked until select is called; set status so
1104 that select will release thread */
1105 cp->status = STATUS_READ_ACKNOWLEDGED;
1107 /* attach child_process to fd_info */
1108 if (fd_info[fd].cp != NULL)
1110 DebPrint (("register_child: fd_info[%d] apparently in use!\n", fd));
1111 emacs_abort ();
1114 fd_info[fd].cp = cp;
1117 /* When a process dies its pipe will break so the reader thread will
1118 signal failure to the select emulator.
1119 The select emulator then calls this routine to clean up.
1120 Since the thread signaled failure we can assume it is exiting. */
1121 static void
1122 reap_subprocess (child_process *cp)
1124 if (cp->procinfo.hProcess)
1126 /* Reap the process */
1127 #ifdef FULL_DEBUG
1128 /* Process should have already died before we are called. */
1129 if (WaitForSingleObject (cp->procinfo.hProcess, 0) != WAIT_OBJECT_0)
1130 DebPrint (("reap_subprocess: child fpr fd %d has not died yet!", cp->fd));
1131 #endif
1132 CloseHandle (cp->procinfo.hProcess);
1133 cp->procinfo.hProcess = NULL;
1134 CloseHandle (cp->procinfo.hThread);
1135 cp->procinfo.hThread = NULL;
1138 /* For asynchronous children, the child_proc resources will be freed
1139 when the last pipe read descriptor is closed; for synchronous
1140 children, we must explicitly free the resources now because
1141 register_child has not been called. */
1142 if (cp->fd == -1)
1143 delete_child (cp);
1146 /* Wait for any of our existing child processes to die
1147 When it does, close its handle
1148 Return the pid and fill in the status if non-NULL. */
1151 sys_wait (int *status)
1153 DWORD active, retval;
1154 int nh;
1155 int pid;
1156 child_process *cp, *cps[MAX_CHILDREN];
1157 HANDLE wait_hnd[MAX_CHILDREN];
1159 nh = 0;
1160 if (dead_child != NULL)
1162 /* We want to wait for a specific child */
1163 wait_hnd[nh] = dead_child->procinfo.hProcess;
1164 cps[nh] = dead_child;
1165 if (!wait_hnd[nh]) emacs_abort ();
1166 nh++;
1167 active = 0;
1168 goto get_result;
1170 else
1172 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
1173 /* some child_procs might be sockets; ignore them */
1174 if (CHILD_ACTIVE (cp) && cp->procinfo.hProcess
1175 && (cp->fd < 0 || (fd_info[cp->fd].flags & FILE_AT_EOF) != 0))
1177 wait_hnd[nh] = cp->procinfo.hProcess;
1178 cps[nh] = cp;
1179 nh++;
1183 if (nh == 0)
1185 /* Nothing to wait on, so fail */
1186 errno = ECHILD;
1187 return -1;
1192 /* Check for quit about once a second. */
1193 QUIT;
1194 active = WaitForMultipleObjects (nh, wait_hnd, FALSE, 1000);
1195 } while (active == WAIT_TIMEOUT);
1197 if (active == WAIT_FAILED)
1199 errno = EBADF;
1200 return -1;
1202 else if (active >= WAIT_OBJECT_0
1203 && active < WAIT_OBJECT_0+MAXIMUM_WAIT_OBJECTS)
1205 active -= WAIT_OBJECT_0;
1207 else if (active >= WAIT_ABANDONED_0
1208 && active < WAIT_ABANDONED_0+MAXIMUM_WAIT_OBJECTS)
1210 active -= WAIT_ABANDONED_0;
1212 else
1213 emacs_abort ();
1215 get_result:
1216 if (!GetExitCodeProcess (wait_hnd[active], &retval))
1218 DebPrint (("Wait.GetExitCodeProcess failed with %lu\n",
1219 GetLastError ()));
1220 retval = 1;
1222 if (retval == STILL_ACTIVE)
1224 /* Should never happen */
1225 DebPrint (("Wait.WaitForMultipleObjects returned an active process\n"));
1226 errno = EINVAL;
1227 return -1;
1230 /* Massage the exit code from the process to match the format expected
1231 by the WIFSTOPPED et al macros in syswait.h. Only WIFSIGNALED and
1232 WIFEXITED are supported; WIFSTOPPED doesn't make sense under NT. */
1234 if (retval == STATUS_CONTROL_C_EXIT)
1235 retval = SIGINT;
1236 else
1237 retval <<= 8;
1239 cp = cps[active];
1240 pid = cp->pid;
1241 #ifdef FULL_DEBUG
1242 DebPrint (("Wait signaled with process pid %d\n", cp->pid));
1243 #endif
1245 if (status)
1247 *status = retval;
1249 else if (synch_process_alive)
1251 synch_process_alive = 0;
1253 /* Report the status of the synchronous process. */
1254 if (WIFEXITED (retval))
1255 synch_process_retcode = WEXITSTATUS (retval);
1256 else if (WIFSIGNALED (retval))
1258 int code = WTERMSIG (retval);
1259 const char *signame;
1261 synchronize_system_messages_locale ();
1262 signame = strsignal (code);
1264 if (signame == 0)
1265 signame = "unknown";
1267 synch_process_death = signame;
1270 reap_subprocess (cp);
1273 reap_subprocess (cp);
1275 return pid;
1278 /* Old versions of w32api headers don't have separate 32-bit and
1279 64-bit defines, but the one they have matches the 32-bit variety. */
1280 #ifndef IMAGE_NT_OPTIONAL_HDR32_MAGIC
1281 # define IMAGE_NT_OPTIONAL_HDR32_MAGIC IMAGE_NT_OPTIONAL_HDR_MAGIC
1282 # define IMAGE_OPTIONAL_HEADER32 IMAGE_OPTIONAL_HEADER
1283 #endif
1285 static void
1286 w32_executable_type (char * filename,
1287 int * is_dos_app,
1288 int * is_cygnus_app,
1289 int * is_gui_app)
1291 file_data executable;
1292 char * p;
1294 /* Default values in case we can't tell for sure. */
1295 *is_dos_app = FALSE;
1296 *is_cygnus_app = FALSE;
1297 *is_gui_app = FALSE;
1299 if (!open_input_file (&executable, filename))
1300 return;
1302 p = strrchr (filename, '.');
1304 /* We can only identify DOS .com programs from the extension. */
1305 if (p && xstrcasecmp (p, ".com") == 0)
1306 *is_dos_app = TRUE;
1307 else if (p && (xstrcasecmp (p, ".bat") == 0
1308 || xstrcasecmp (p, ".cmd") == 0))
1310 /* A DOS shell script - it appears that CreateProcess is happy to
1311 accept this (somewhat surprisingly); presumably it looks at
1312 COMSPEC to determine what executable to actually invoke.
1313 Therefore, we have to do the same here as well. */
1314 /* Actually, I think it uses the program association for that
1315 extension, which is defined in the registry. */
1316 p = egetenv ("COMSPEC");
1317 if (p)
1318 w32_executable_type (p, is_dos_app, is_cygnus_app, is_gui_app);
1320 else
1322 /* Look for DOS .exe signature - if found, we must also check that
1323 it isn't really a 16- or 32-bit Windows exe, since both formats
1324 start with a DOS program stub. Note that 16-bit Windows
1325 executables use the OS/2 1.x format. */
1327 IMAGE_DOS_HEADER * dos_header;
1328 IMAGE_NT_HEADERS * nt_header;
1330 dos_header = (PIMAGE_DOS_HEADER) executable.file_base;
1331 if (dos_header->e_magic != IMAGE_DOS_SIGNATURE)
1332 goto unwind;
1334 nt_header = (PIMAGE_NT_HEADERS) ((unsigned char *) dos_header + dos_header->e_lfanew);
1336 if ((char *) nt_header > (char *) dos_header + executable.size)
1338 /* Some dos headers (pkunzip) have bogus e_lfanew fields. */
1339 *is_dos_app = TRUE;
1341 else if (nt_header->Signature != IMAGE_NT_SIGNATURE
1342 && LOWORD (nt_header->Signature) != IMAGE_OS2_SIGNATURE)
1344 *is_dos_app = TRUE;
1346 else if (nt_header->Signature == IMAGE_NT_SIGNATURE)
1348 IMAGE_DATA_DIRECTORY *data_dir = NULL;
1349 if (nt_header->OptionalHeader.Magic == IMAGE_NT_OPTIONAL_HDR32_MAGIC)
1351 /* Ensure we are using the 32 bit structure. */
1352 IMAGE_OPTIONAL_HEADER32 *opt
1353 = (IMAGE_OPTIONAL_HEADER32*) &(nt_header->OptionalHeader);
1354 data_dir = opt->DataDirectory;
1355 *is_gui_app = (opt->Subsystem == IMAGE_SUBSYSTEM_WINDOWS_GUI);
1357 /* MingW 3.12 has the required 64 bit structs, but in case older
1358 versions don't, only check 64 bit exes if we know how. */
1359 #ifdef IMAGE_NT_OPTIONAL_HDR64_MAGIC
1360 else if (nt_header->OptionalHeader.Magic
1361 == IMAGE_NT_OPTIONAL_HDR64_MAGIC)
1363 IMAGE_OPTIONAL_HEADER64 *opt
1364 = (IMAGE_OPTIONAL_HEADER64*) &(nt_header->OptionalHeader);
1365 data_dir = opt->DataDirectory;
1366 *is_gui_app = (opt->Subsystem == IMAGE_SUBSYSTEM_WINDOWS_GUI);
1368 #endif
1369 if (data_dir)
1371 /* Look for cygwin.dll in DLL import list. */
1372 IMAGE_DATA_DIRECTORY import_dir =
1373 data_dir[IMAGE_DIRECTORY_ENTRY_IMPORT];
1374 IMAGE_IMPORT_DESCRIPTOR * imports;
1375 IMAGE_SECTION_HEADER * section;
1377 section = rva_to_section (import_dir.VirtualAddress, nt_header);
1378 imports = RVA_TO_PTR (import_dir.VirtualAddress, section,
1379 executable);
1381 for ( ; imports->Name; imports++)
1383 char * dllname = RVA_TO_PTR (imports->Name, section,
1384 executable);
1386 /* The exact name of the cygwin dll has changed with
1387 various releases, but hopefully this will be reasonably
1388 future proof. */
1389 if (strncmp (dllname, "cygwin", 6) == 0)
1391 *is_cygnus_app = TRUE;
1392 break;
1399 unwind:
1400 close_file_data (&executable);
1403 static int
1404 compare_env (const void *strp1, const void *strp2)
1406 const char *str1 = *(const char **)strp1, *str2 = *(const char **)strp2;
1408 while (*str1 && *str2 && *str1 != '=' && *str2 != '=')
1410 /* Sort order in command.com/cmd.exe is based on uppercasing
1411 names, so do the same here. */
1412 if (toupper (*str1) > toupper (*str2))
1413 return 1;
1414 else if (toupper (*str1) < toupper (*str2))
1415 return -1;
1416 str1++, str2++;
1419 if (*str1 == '=' && *str2 == '=')
1420 return 0;
1421 else if (*str1 == '=')
1422 return -1;
1423 else
1424 return 1;
1427 static void
1428 merge_and_sort_env (char **envp1, char **envp2, char **new_envp)
1430 char **optr, **nptr;
1431 int num;
1433 nptr = new_envp;
1434 optr = envp1;
1435 while (*optr)
1436 *nptr++ = *optr++;
1437 num = optr - envp1;
1439 optr = envp2;
1440 while (*optr)
1441 *nptr++ = *optr++;
1442 num += optr - envp2;
1444 qsort (new_envp, num, sizeof (char *), compare_env);
1446 *nptr = NULL;
1449 /* When a new child process is created we need to register it in our list,
1450 so intercept spawn requests. */
1452 sys_spawnve (int mode, char *cmdname, char **argv, char **envp)
1454 Lisp_Object program, full;
1455 char *cmdline, *env, *parg, **targ;
1456 int arglen, numenv;
1457 int pid;
1458 child_process *cp;
1459 int is_dos_app, is_cygnus_app, is_gui_app;
1460 int do_quoting = 0;
1461 /* We pass our process ID to our children by setting up an environment
1462 variable in their environment. */
1463 char ppid_env_var_buffer[64];
1464 char *extra_env[] = {ppid_env_var_buffer, NULL};
1465 /* These are the characters that cause an argument to need quoting.
1466 Arguments with whitespace characters need quoting to prevent the
1467 argument being split into two or more. Arguments with wildcards
1468 are also quoted, for consistency with posix platforms, where wildcards
1469 are not expanded if we run the program directly without a shell.
1470 Some extra whitespace characters need quoting in Cygwin programs,
1471 so this list is conditionally modified below. */
1472 char *sepchars = " \t*?";
1473 /* This is for native w32 apps; modified below for Cygwin apps. */
1474 char escape_char = '\\';
1476 /* We don't care about the other modes */
1477 if (mode != _P_NOWAIT)
1479 errno = EINVAL;
1480 return -1;
1483 /* Handle executable names without an executable suffix. */
1484 program = build_string (cmdname);
1485 if (NILP (Ffile_executable_p (program)))
1487 struct gcpro gcpro1;
1489 full = Qnil;
1490 GCPRO1 (program);
1491 openp (Vexec_path, program, Vexec_suffixes, &full, make_number (X_OK));
1492 UNGCPRO;
1493 if (NILP (full))
1495 errno = EINVAL;
1496 return -1;
1498 program = full;
1501 /* make sure argv[0] and cmdname are both in DOS format */
1502 cmdname = SDATA (program);
1503 unixtodos_filename (cmdname);
1504 argv[0] = cmdname;
1506 /* Determine whether program is a 16-bit DOS executable, or a 32-bit Windows
1507 executable that is implicitly linked to the Cygnus dll (implying it
1508 was compiled with the Cygnus GNU toolchain and hence relies on
1509 cygwin.dll to parse the command line - we use this to decide how to
1510 escape quote chars in command line args that must be quoted).
1512 Also determine whether it is a GUI app, so that we don't hide its
1513 initial window unless specifically requested. */
1514 w32_executable_type (cmdname, &is_dos_app, &is_cygnus_app, &is_gui_app);
1516 /* On Windows 95, if cmdname is a DOS app, we invoke a helper
1517 application to start it by specifying the helper app as cmdname,
1518 while leaving the real app name as argv[0]. */
1519 if (is_dos_app)
1521 cmdname = alloca (MAXPATHLEN);
1522 if (egetenv ("CMDPROXY"))
1523 strcpy (cmdname, egetenv ("CMDPROXY"));
1524 else
1526 strcpy (cmdname, SDATA (Vinvocation_directory));
1527 strcat (cmdname, "cmdproxy.exe");
1529 unixtodos_filename (cmdname);
1532 /* we have to do some conjuring here to put argv and envp into the
1533 form CreateProcess wants... argv needs to be a space separated/null
1534 terminated list of parameters, and envp is a null
1535 separated/double-null terminated list of parameters.
1537 Additionally, zero-length args and args containing whitespace or
1538 quote chars need to be wrapped in double quotes - for this to work,
1539 embedded quotes need to be escaped as well. The aim is to ensure
1540 the child process reconstructs the argv array we start with
1541 exactly, so we treat quotes at the beginning and end of arguments
1542 as embedded quotes.
1544 The w32 GNU-based library from Cygnus doubles quotes to escape
1545 them, while MSVC uses backslash for escaping. (Actually the MSVC
1546 startup code does attempt to recognize doubled quotes and accept
1547 them, but gets it wrong and ends up requiring three quotes to get a
1548 single embedded quote!) So by default we decide whether to use
1549 quote or backslash as the escape character based on whether the
1550 binary is apparently a Cygnus compiled app.
1552 Note that using backslash to escape embedded quotes requires
1553 additional special handling if an embedded quote is already
1554 preceded by backslash, or if an arg requiring quoting ends with
1555 backslash. In such cases, the run of escape characters needs to be
1556 doubled. For consistency, we apply this special handling as long
1557 as the escape character is not quote.
1559 Since we have no idea how large argv and envp are likely to be we
1560 figure out list lengths on the fly and allocate them. */
1562 if (!NILP (Vw32_quote_process_args))
1564 do_quoting = 1;
1565 /* Override escape char by binding w32-quote-process-args to
1566 desired character, or use t for auto-selection. */
1567 if (INTEGERP (Vw32_quote_process_args))
1568 escape_char = XINT (Vw32_quote_process_args);
1569 else
1570 escape_char = is_cygnus_app ? '"' : '\\';
1573 /* Cygwin apps needs quoting a bit more often. */
1574 if (escape_char == '"')
1575 sepchars = "\r\n\t\f '";
1577 /* do argv... */
1578 arglen = 0;
1579 targ = argv;
1580 while (*targ)
1582 char * p = *targ;
1583 int need_quotes = 0;
1584 int escape_char_run = 0;
1586 if (*p == 0)
1587 need_quotes = 1;
1588 for ( ; *p; p++)
1590 if (escape_char == '"' && *p == '\\')
1591 /* If it's a Cygwin app, \ needs to be escaped. */
1592 arglen++;
1593 else if (*p == '"')
1595 /* allow for embedded quotes to be escaped */
1596 arglen++;
1597 need_quotes = 1;
1598 /* handle the case where the embedded quote is already escaped */
1599 if (escape_char_run > 0)
1601 /* To preserve the arg exactly, we need to double the
1602 preceding escape characters (plus adding one to
1603 escape the quote character itself). */
1604 arglen += escape_char_run;
1607 else if (strchr (sepchars, *p) != NULL)
1609 need_quotes = 1;
1612 if (*p == escape_char && escape_char != '"')
1613 escape_char_run++;
1614 else
1615 escape_char_run = 0;
1617 if (need_quotes)
1619 arglen += 2;
1620 /* handle the case where the arg ends with an escape char - we
1621 must not let the enclosing quote be escaped. */
1622 if (escape_char_run > 0)
1623 arglen += escape_char_run;
1625 arglen += strlen (*targ++) + 1;
1627 cmdline = alloca (arglen);
1628 targ = argv;
1629 parg = cmdline;
1630 while (*targ)
1632 char * p = *targ;
1633 int need_quotes = 0;
1635 if (*p == 0)
1636 need_quotes = 1;
1638 if (do_quoting)
1640 for ( ; *p; p++)
1641 if ((strchr (sepchars, *p) != NULL) || *p == '"')
1642 need_quotes = 1;
1644 if (need_quotes)
1646 int escape_char_run = 0;
1647 char * first;
1648 char * last;
1650 p = *targ;
1651 first = p;
1652 last = p + strlen (p) - 1;
1653 *parg++ = '"';
1654 #if 0
1655 /* This version does not escape quotes if they occur at the
1656 beginning or end of the arg - this could lead to incorrect
1657 behavior when the arg itself represents a command line
1658 containing quoted args. I believe this was originally done
1659 as a hack to make some things work, before
1660 `w32-quote-process-args' was added. */
1661 while (*p)
1663 if (*p == '"' && p > first && p < last)
1664 *parg++ = escape_char; /* escape embedded quotes */
1665 *parg++ = *p++;
1667 #else
1668 for ( ; *p; p++)
1670 if (*p == '"')
1672 /* double preceding escape chars if any */
1673 while (escape_char_run > 0)
1675 *parg++ = escape_char;
1676 escape_char_run--;
1678 /* escape all quote chars, even at beginning or end */
1679 *parg++ = escape_char;
1681 else if (escape_char == '"' && *p == '\\')
1682 *parg++ = '\\';
1683 *parg++ = *p;
1685 if (*p == escape_char && escape_char != '"')
1686 escape_char_run++;
1687 else
1688 escape_char_run = 0;
1690 /* double escape chars before enclosing quote */
1691 while (escape_char_run > 0)
1693 *parg++ = escape_char;
1694 escape_char_run--;
1696 #endif
1697 *parg++ = '"';
1699 else
1701 strcpy (parg, *targ);
1702 parg += strlen (*targ);
1704 *parg++ = ' ';
1705 targ++;
1707 *--parg = '\0';
1709 /* and envp... */
1710 arglen = 1;
1711 targ = envp;
1712 numenv = 1; /* for end null */
1713 while (*targ)
1715 arglen += strlen (*targ++) + 1;
1716 numenv++;
1718 /* extra env vars... */
1719 sprintf (ppid_env_var_buffer, "EM_PARENT_PROCESS_ID=%lu",
1720 GetCurrentProcessId ());
1721 arglen += strlen (ppid_env_var_buffer) + 1;
1722 numenv++;
1724 /* merge env passed in and extra env into one, and sort it. */
1725 targ = (char **) alloca (numenv * sizeof (char *));
1726 merge_and_sort_env (envp, extra_env, targ);
1728 /* concatenate env entries. */
1729 env = alloca (arglen);
1730 parg = env;
1731 while (*targ)
1733 strcpy (parg, *targ);
1734 parg += strlen (*targ++);
1735 *parg++ = '\0';
1737 *parg++ = '\0';
1738 *parg = '\0';
1740 cp = new_child ();
1741 if (cp == NULL)
1743 errno = EAGAIN;
1744 return -1;
1747 /* Now create the process. */
1748 if (!create_child (cmdname, cmdline, env, is_gui_app, &pid, cp))
1750 delete_child (cp);
1751 errno = ENOEXEC;
1752 return -1;
1755 return pid;
1758 /* Emulate the select call
1759 Wait for available input on any of the given rfds, or timeout if
1760 a timeout is given and no input is detected
1761 wfds and efds are not supported and must be NULL.
1763 For simplicity, we detect the death of child processes here and
1764 synchronously call the SIGCHLD handler. Since it is possible for
1765 children to be created without a corresponding pipe handle from which
1766 to read output, we wait separately on the process handles as well as
1767 the char_avail events for each process pipe. We only call
1768 wait/reap_process when the process actually terminates.
1770 To reduce the number of places in which Emacs can be hung such that
1771 C-g is not able to interrupt it, we always wait on interrupt_handle
1772 (which is signaled by the input thread when C-g is detected). If we
1773 detect that we were woken up by C-g, we return -1 with errno set to
1774 EINTR as on Unix. */
1776 /* From w32console.c */
1777 extern HANDLE keyboard_handle;
1779 /* From w32xfns.c */
1780 extern HANDLE interrupt_handle;
1782 /* From process.c */
1783 extern int proc_buffered_char[];
1786 sys_select (int nfds, SELECT_TYPE *rfds, SELECT_TYPE *wfds, SELECT_TYPE *efds,
1787 EMACS_TIME *timeout, void *ignored)
1789 SELECT_TYPE orfds;
1790 DWORD timeout_ms, start_time;
1791 int i, nh, nc, nr;
1792 DWORD active;
1793 child_process *cp, *cps[MAX_CHILDREN];
1794 HANDLE wait_hnd[MAXDESC + MAX_CHILDREN];
1795 int fdindex[MAXDESC]; /* mapping from wait handles back to descriptors */
1797 timeout_ms =
1798 timeout ? (timeout->tv_sec * 1000 + timeout->tv_nsec / 1000000) : INFINITE;
1800 /* If the descriptor sets are NULL but timeout isn't, then just Sleep. */
1801 if (rfds == NULL && wfds == NULL && efds == NULL && timeout != NULL)
1803 Sleep (timeout_ms);
1804 return 0;
1807 /* Otherwise, we only handle rfds, so fail otherwise. */
1808 if (rfds == NULL || wfds != NULL || efds != NULL)
1810 errno = EINVAL;
1811 return -1;
1814 orfds = *rfds;
1815 FD_ZERO (rfds);
1816 nr = 0;
1818 /* Always wait on interrupt_handle, to detect C-g (quit). */
1819 wait_hnd[0] = interrupt_handle;
1820 fdindex[0] = -1;
1822 /* Build a list of pipe handles to wait on. */
1823 nh = 1;
1824 for (i = 0; i < nfds; i++)
1825 if (FD_ISSET (i, &orfds))
1827 if (i == 0)
1829 if (keyboard_handle)
1831 /* Handle stdin specially */
1832 wait_hnd[nh] = keyboard_handle;
1833 fdindex[nh] = i;
1834 nh++;
1837 /* Check for any emacs-generated input in the queue since
1838 it won't be detected in the wait */
1839 if (detect_input_pending ())
1841 FD_SET (i, rfds);
1842 return 1;
1845 else
1847 /* Child process and socket input */
1848 cp = fd_info[i].cp;
1849 if (cp)
1851 int current_status = cp->status;
1853 if (current_status == STATUS_READ_ACKNOWLEDGED)
1855 /* Tell reader thread which file handle to use. */
1856 cp->fd = i;
1857 /* Wake up the reader thread for this process */
1858 cp->status = STATUS_READ_READY;
1859 if (!SetEvent (cp->char_consumed))
1860 DebPrint (("nt_select.SetEvent failed with "
1861 "%lu for fd %ld\n", GetLastError (), i));
1864 #ifdef CHECK_INTERLOCK
1865 /* slightly crude cross-checking of interlock between threads */
1867 current_status = cp->status;
1868 if (WaitForSingleObject (cp->char_avail, 0) == WAIT_OBJECT_0)
1870 /* char_avail has been signaled, so status (which may
1871 have changed) should indicate read has completed
1872 but has not been acknowledged. */
1873 current_status = cp->status;
1874 if (current_status != STATUS_READ_SUCCEEDED
1875 && current_status != STATUS_READ_FAILED)
1876 DebPrint (("char_avail set, but read not completed: status %d\n",
1877 current_status));
1879 else
1881 /* char_avail has not been signaled, so status should
1882 indicate that read is in progress; small possibility
1883 that read has completed but event wasn't yet signaled
1884 when we tested it (because a context switch occurred
1885 or if running on separate CPUs). */
1886 if (current_status != STATUS_READ_READY
1887 && current_status != STATUS_READ_IN_PROGRESS
1888 && current_status != STATUS_READ_SUCCEEDED
1889 && current_status != STATUS_READ_FAILED)
1890 DebPrint (("char_avail reset, but read status is bad: %d\n",
1891 current_status));
1893 #endif
1894 wait_hnd[nh] = cp->char_avail;
1895 fdindex[nh] = i;
1896 if (!wait_hnd[nh]) emacs_abort ();
1897 nh++;
1898 #ifdef FULL_DEBUG
1899 DebPrint (("select waiting on child %d fd %d\n",
1900 cp-child_procs, i));
1901 #endif
1903 else
1905 /* Unable to find something to wait on for this fd, skip */
1907 /* Note that this is not a fatal error, and can in fact
1908 happen in unusual circumstances. Specifically, if
1909 sys_spawnve fails, eg. because the program doesn't
1910 exist, and debug-on-error is t so Fsignal invokes a
1911 nested input loop, then the process output pipe is
1912 still included in input_wait_mask with no child_proc
1913 associated with it. (It is removed when the debugger
1914 exits the nested input loop and the error is thrown.) */
1916 DebPrint (("sys_select: fd %ld is invalid! ignoring\n", i));
1921 count_children:
1922 /* Add handles of child processes. */
1923 nc = 0;
1924 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
1925 /* Some child_procs might be sockets; ignore them. Also some
1926 children may have died already, but we haven't finished reading
1927 the process output; ignore them too. */
1928 if (CHILD_ACTIVE (cp) && cp->procinfo.hProcess
1929 && (cp->fd < 0
1930 || (fd_info[cp->fd].flags & FILE_SEND_SIGCHLD) == 0
1931 || (fd_info[cp->fd].flags & FILE_AT_EOF) != 0)
1934 wait_hnd[nh + nc] = cp->procinfo.hProcess;
1935 cps[nc] = cp;
1936 nc++;
1939 /* Nothing to look for, so we didn't find anything */
1940 if (nh + nc == 0)
1942 if (timeout)
1943 Sleep (timeout_ms);
1944 return 0;
1947 start_time = GetTickCount ();
1949 /* Wait for input or child death to be signaled. If user input is
1950 allowed, then also accept window messages. */
1951 if (FD_ISSET (0, &orfds))
1952 active = MsgWaitForMultipleObjects (nh + nc, wait_hnd, FALSE, timeout_ms,
1953 QS_ALLINPUT);
1954 else
1955 active = WaitForMultipleObjects (nh + nc, wait_hnd, FALSE, timeout_ms);
1957 if (active == WAIT_FAILED)
1959 DebPrint (("select.WaitForMultipleObjects (%d, %lu) failed with %lu\n",
1960 nh + nc, timeout_ms, GetLastError ()));
1961 /* don't return EBADF - this causes wait_reading_process_output to
1962 abort; WAIT_FAILED is returned when single-stepping under
1963 Windows 95 after switching thread focus in debugger, and
1964 possibly at other times. */
1965 errno = EINTR;
1966 return -1;
1968 else if (active == WAIT_TIMEOUT)
1970 return 0;
1972 else if (active >= WAIT_OBJECT_0
1973 && active < WAIT_OBJECT_0+MAXIMUM_WAIT_OBJECTS)
1975 active -= WAIT_OBJECT_0;
1977 else if (active >= WAIT_ABANDONED_0
1978 && active < WAIT_ABANDONED_0+MAXIMUM_WAIT_OBJECTS)
1980 active -= WAIT_ABANDONED_0;
1982 else
1983 emacs_abort ();
1985 /* Loop over all handles after active (now officially documented as
1986 being the first signaled handle in the array). We do this to
1987 ensure fairness, so that all channels with data available will be
1988 processed - otherwise higher numbered channels could be starved. */
1991 if (active == nh + nc)
1993 /* There are messages in the lisp thread's queue; we must
1994 drain the queue now to ensure they are processed promptly,
1995 because if we don't do so, we will not be woken again until
1996 further messages arrive.
1998 NB. If ever we allow window message procedures to callback
1999 into lisp, we will need to ensure messages are dispatched
2000 at a safe time for lisp code to be run (*), and we may also
2001 want to provide some hooks in the dispatch loop to cater
2002 for modeless dialogs created by lisp (ie. to register
2003 window handles to pass to IsDialogMessage).
2005 (*) Note that MsgWaitForMultipleObjects above is an
2006 internal dispatch point for messages that are sent to
2007 windows created by this thread. */
2008 drain_message_queue ();
2010 else if (active >= nh)
2012 cp = cps[active - nh];
2014 /* We cannot always signal SIGCHLD immediately; if we have not
2015 finished reading the process output, we must delay sending
2016 SIGCHLD until we do. */
2018 if (cp->fd >= 0 && (fd_info[cp->fd].flags & FILE_AT_EOF) == 0)
2019 fd_info[cp->fd].flags |= FILE_SEND_SIGCHLD;
2020 /* SIG_DFL for SIGCHLD is ignore */
2021 else if (sig_handlers[SIGCHLD] != SIG_DFL &&
2022 sig_handlers[SIGCHLD] != SIG_IGN)
2024 #ifdef FULL_DEBUG
2025 DebPrint (("select calling SIGCHLD handler for pid %d\n",
2026 cp->pid));
2027 #endif
2028 dead_child = cp;
2029 sig_handlers[SIGCHLD] (SIGCHLD);
2030 dead_child = NULL;
2033 else if (fdindex[active] == -1)
2035 /* Quit (C-g) was detected. */
2036 errno = EINTR;
2037 return -1;
2039 else if (fdindex[active] == 0)
2041 /* Keyboard input available */
2042 FD_SET (0, rfds);
2043 nr++;
2045 else
2047 /* must be a socket or pipe - read ahead should have
2048 completed, either succeeding or failing. */
2049 FD_SET (fdindex[active], rfds);
2050 nr++;
2053 /* Even though wait_reading_process_output only reads from at most
2054 one channel, we must process all channels here so that we reap
2055 all children that have died. */
2056 while (++active < nh + nc)
2057 if (WaitForSingleObject (wait_hnd[active], 0) == WAIT_OBJECT_0)
2058 break;
2059 } while (active < nh + nc);
2061 /* If no input has arrived and timeout hasn't expired, wait again. */
2062 if (nr == 0)
2064 DWORD elapsed = GetTickCount () - start_time;
2066 if (timeout_ms > elapsed) /* INFINITE is MAX_UINT */
2068 if (timeout_ms != INFINITE)
2069 timeout_ms -= elapsed;
2070 goto count_children;
2074 return nr;
2077 /* Substitute for certain kill () operations */
2079 static BOOL CALLBACK
2080 find_child_console (HWND hwnd, LPARAM arg)
2082 child_process * cp = (child_process *) arg;
2083 DWORD thread_id;
2084 DWORD process_id;
2086 thread_id = GetWindowThreadProcessId (hwnd, &process_id);
2087 if (process_id == cp->procinfo.dwProcessId)
2089 char window_class[32];
2091 GetClassName (hwnd, window_class, sizeof (window_class));
2092 if (strcmp (window_class,
2093 (os_subtype == OS_9X)
2094 ? "tty"
2095 : "ConsoleWindowClass") == 0)
2097 cp->hwnd = hwnd;
2098 return FALSE;
2101 /* keep looking */
2102 return TRUE;
2105 /* Emulate 'kill', but only for other processes. */
2107 sys_kill (int pid, int sig)
2109 child_process *cp;
2110 HANDLE proc_hand;
2111 int need_to_free = 0;
2112 int rc = 0;
2114 /* Only handle signals that will result in the process dying */
2115 if (sig != SIGINT && sig != SIGKILL && sig != SIGQUIT && sig != SIGHUP)
2117 errno = EINVAL;
2118 return -1;
2121 cp = find_child_pid (pid);
2122 if (cp == NULL)
2124 /* We were passed a PID of something other than our subprocess.
2125 If that is our own PID, we will send to ourself a message to
2126 close the selected frame, which does not necessarily
2127 terminates Emacs. But then we are not supposed to call
2128 sys_kill with our own PID. */
2129 proc_hand = OpenProcess (PROCESS_TERMINATE, 0, pid);
2130 if (proc_hand == NULL)
2132 errno = EPERM;
2133 return -1;
2135 need_to_free = 1;
2137 else
2139 proc_hand = cp->procinfo.hProcess;
2140 pid = cp->procinfo.dwProcessId;
2142 /* Try to locate console window for process. */
2143 EnumWindows (find_child_console, (LPARAM) cp);
2146 if (sig == SIGINT || sig == SIGQUIT)
2148 if (NILP (Vw32_start_process_share_console) && cp && cp->hwnd)
2150 BYTE control_scan_code = (BYTE) MapVirtualKey (VK_CONTROL, 0);
2151 /* Fake Ctrl-C for SIGINT, and Ctrl-Break for SIGQUIT. */
2152 BYTE vk_break_code = (sig == SIGINT) ? 'C' : VK_CANCEL;
2153 BYTE break_scan_code = (BYTE) MapVirtualKey (vk_break_code, 0);
2154 HWND foreground_window;
2156 if (break_scan_code == 0)
2158 /* Fake Ctrl-C for SIGQUIT if we can't manage Ctrl-Break. */
2159 vk_break_code = 'C';
2160 break_scan_code = (BYTE) MapVirtualKey (vk_break_code, 0);
2163 foreground_window = GetForegroundWindow ();
2164 if (foreground_window)
2166 /* NT 5.0, and apparently also Windows 98, will not allow
2167 a Window to be set to foreground directly without the
2168 user's involvement. The workaround is to attach
2169 ourselves to the thread that owns the foreground
2170 window, since that is the only thread that can set the
2171 foreground window. */
2172 DWORD foreground_thread, child_thread;
2173 foreground_thread =
2174 GetWindowThreadProcessId (foreground_window, NULL);
2175 if (foreground_thread == GetCurrentThreadId ()
2176 || !AttachThreadInput (GetCurrentThreadId (),
2177 foreground_thread, TRUE))
2178 foreground_thread = 0;
2180 child_thread = GetWindowThreadProcessId (cp->hwnd, NULL);
2181 if (child_thread == GetCurrentThreadId ()
2182 || !AttachThreadInput (GetCurrentThreadId (),
2183 child_thread, TRUE))
2184 child_thread = 0;
2186 /* Set the foreground window to the child. */
2187 if (SetForegroundWindow (cp->hwnd))
2189 /* Generate keystrokes as if user had typed Ctrl-Break or
2190 Ctrl-C. */
2191 keybd_event (VK_CONTROL, control_scan_code, 0, 0);
2192 keybd_event (vk_break_code, break_scan_code,
2193 (vk_break_code == 'C' ? 0 : KEYEVENTF_EXTENDEDKEY), 0);
2194 keybd_event (vk_break_code, break_scan_code,
2195 (vk_break_code == 'C' ? 0 : KEYEVENTF_EXTENDEDKEY)
2196 | KEYEVENTF_KEYUP, 0);
2197 keybd_event (VK_CONTROL, control_scan_code,
2198 KEYEVENTF_KEYUP, 0);
2200 /* Sleep for a bit to give time for Emacs frame to respond
2201 to focus change events (if Emacs was active app). */
2202 Sleep (100);
2204 SetForegroundWindow (foreground_window);
2206 /* Detach from the foreground and child threads now that
2207 the foreground switching is over. */
2208 if (foreground_thread)
2209 AttachThreadInput (GetCurrentThreadId (),
2210 foreground_thread, FALSE);
2211 if (child_thread)
2212 AttachThreadInput (GetCurrentThreadId (),
2213 child_thread, FALSE);
2216 /* Ctrl-Break is NT equivalent of SIGINT. */
2217 else if (!GenerateConsoleCtrlEvent (CTRL_BREAK_EVENT, pid))
2219 DebPrint (("sys_kill.GenerateConsoleCtrlEvent return %d "
2220 "for pid %lu\n", GetLastError (), pid));
2221 errno = EINVAL;
2222 rc = -1;
2225 else
2227 if (NILP (Vw32_start_process_share_console) && cp && cp->hwnd)
2229 #if 1
2230 if (os_subtype == OS_9X)
2233 Another possibility is to try terminating the VDM out-right by
2234 calling the Shell VxD (id 0x17) V86 interface, function #4
2235 "SHELL_Destroy_VM", ie.
2237 mov edx,4
2238 mov ebx,vm_handle
2239 call shellapi
2241 First need to determine the current VM handle, and then arrange for
2242 the shellapi call to be made from the system vm (by using
2243 Switch_VM_and_callback).
2245 Could try to invoke DestroyVM through CallVxD.
2248 #if 0
2249 /* On Windows 95, posting WM_QUIT causes the 16-bit subsystem
2250 to hang when cmdproxy is used in conjunction with
2251 command.com for an interactive shell. Posting
2252 WM_CLOSE pops up a dialog that, when Yes is selected,
2253 does the same thing. TerminateProcess is also less
2254 than ideal in that subprocesses tend to stick around
2255 until the machine is shutdown, but at least it
2256 doesn't freeze the 16-bit subsystem. */
2257 PostMessage (cp->hwnd, WM_QUIT, 0xff, 0);
2258 #endif
2259 if (!TerminateProcess (proc_hand, 0xff))
2261 DebPrint (("sys_kill.TerminateProcess returned %d "
2262 "for pid %lu\n", GetLastError (), pid));
2263 errno = EINVAL;
2264 rc = -1;
2267 else
2268 #endif
2269 PostMessage (cp->hwnd, WM_CLOSE, 0, 0);
2271 /* Kill the process. On W32 this doesn't kill child processes
2272 so it doesn't work very well for shells which is why it's not
2273 used in every case. */
2274 else if (!TerminateProcess (proc_hand, 0xff))
2276 DebPrint (("sys_kill.TerminateProcess returned %d "
2277 "for pid %lu\n", GetLastError (), pid));
2278 errno = EINVAL;
2279 rc = -1;
2283 if (need_to_free)
2284 CloseHandle (proc_hand);
2286 return rc;
2289 /* The following two routines are used to manipulate stdin, stdout, and
2290 stderr of our child processes.
2292 Assuming that in, out, and err are *not* inheritable, we make them
2293 stdin, stdout, and stderr of the child as follows:
2295 - Save the parent's current standard handles.
2296 - Set the std handles to inheritable duplicates of the ones being passed in.
2297 (Note that _get_osfhandle() is an io.h procedure that retrieves the
2298 NT file handle for a crt file descriptor.)
2299 - Spawn the child, which inherits in, out, and err as stdin,
2300 stdout, and stderr. (see Spawnve)
2301 - Close the std handles passed to the child.
2302 - Reset the parent's standard handles to the saved handles.
2303 (see reset_standard_handles)
2304 We assume that the caller closes in, out, and err after calling us. */
2306 void
2307 prepare_standard_handles (int in, int out, int err, HANDLE handles[3])
2309 HANDLE parent;
2310 HANDLE newstdin, newstdout, newstderr;
2312 parent = GetCurrentProcess ();
2314 handles[0] = GetStdHandle (STD_INPUT_HANDLE);
2315 handles[1] = GetStdHandle (STD_OUTPUT_HANDLE);
2316 handles[2] = GetStdHandle (STD_ERROR_HANDLE);
2318 /* make inheritable copies of the new handles */
2319 if (!DuplicateHandle (parent,
2320 (HANDLE) _get_osfhandle (in),
2321 parent,
2322 &newstdin,
2324 TRUE,
2325 DUPLICATE_SAME_ACCESS))
2326 report_file_error ("Duplicating input handle for child", Qnil);
2328 if (!DuplicateHandle (parent,
2329 (HANDLE) _get_osfhandle (out),
2330 parent,
2331 &newstdout,
2333 TRUE,
2334 DUPLICATE_SAME_ACCESS))
2335 report_file_error ("Duplicating output handle for child", Qnil);
2337 if (!DuplicateHandle (parent,
2338 (HANDLE) _get_osfhandle (err),
2339 parent,
2340 &newstderr,
2342 TRUE,
2343 DUPLICATE_SAME_ACCESS))
2344 report_file_error ("Duplicating error handle for child", Qnil);
2346 /* and store them as our std handles */
2347 if (!SetStdHandle (STD_INPUT_HANDLE, newstdin))
2348 report_file_error ("Changing stdin handle", Qnil);
2350 if (!SetStdHandle (STD_OUTPUT_HANDLE, newstdout))
2351 report_file_error ("Changing stdout handle", Qnil);
2353 if (!SetStdHandle (STD_ERROR_HANDLE, newstderr))
2354 report_file_error ("Changing stderr handle", Qnil);
2357 void
2358 reset_standard_handles (int in, int out, int err, HANDLE handles[3])
2360 /* close the duplicated handles passed to the child */
2361 CloseHandle (GetStdHandle (STD_INPUT_HANDLE));
2362 CloseHandle (GetStdHandle (STD_OUTPUT_HANDLE));
2363 CloseHandle (GetStdHandle (STD_ERROR_HANDLE));
2365 /* now restore parent's saved std handles */
2366 SetStdHandle (STD_INPUT_HANDLE, handles[0]);
2367 SetStdHandle (STD_OUTPUT_HANDLE, handles[1]);
2368 SetStdHandle (STD_ERROR_HANDLE, handles[2]);
2371 void
2372 set_process_dir (char * dir)
2374 process_dir = dir;
2377 /* To avoid problems with winsock implementations that work over dial-up
2378 connections causing or requiring a connection to exist while Emacs is
2379 running, Emacs no longer automatically loads winsock on startup if it
2380 is present. Instead, it will be loaded when open-network-stream is
2381 first called.
2383 To allow full control over when winsock is loaded, we provide these
2384 two functions to dynamically load and unload winsock. This allows
2385 dial-up users to only be connected when they actually need to use
2386 socket services. */
2388 /* From w32.c */
2389 extern HANDLE winsock_lib;
2390 extern BOOL term_winsock (void);
2391 extern BOOL init_winsock (int load_now);
2393 DEFUN ("w32-has-winsock", Fw32_has_winsock, Sw32_has_winsock, 0, 1, 0,
2394 doc: /* Test for presence of the Windows socket library `winsock'.
2395 Returns non-nil if winsock support is present, nil otherwise.
2397 If the optional argument LOAD-NOW is non-nil, the winsock library is
2398 also loaded immediately if not already loaded. If winsock is loaded,
2399 the winsock local hostname is returned (since this may be different from
2400 the value of `system-name' and should supplant it), otherwise t is
2401 returned to indicate winsock support is present. */)
2402 (Lisp_Object load_now)
2404 int have_winsock;
2406 have_winsock = init_winsock (!NILP (load_now));
2407 if (have_winsock)
2409 if (winsock_lib != NULL)
2411 /* Return new value for system-name. The best way to do this
2412 is to call init_system_name, saving and restoring the
2413 original value to avoid side-effects. */
2414 Lisp_Object orig_hostname = Vsystem_name;
2415 Lisp_Object hostname;
2417 init_system_name ();
2418 hostname = Vsystem_name;
2419 Vsystem_name = orig_hostname;
2420 return hostname;
2422 return Qt;
2424 return Qnil;
2427 DEFUN ("w32-unload-winsock", Fw32_unload_winsock, Sw32_unload_winsock,
2428 0, 0, 0,
2429 doc: /* Unload the Windows socket library `winsock' if loaded.
2430 This is provided to allow dial-up socket connections to be disconnected
2431 when no longer needed. Returns nil without unloading winsock if any
2432 socket connections still exist. */)
2433 (void)
2435 return term_winsock () ? Qt : Qnil;
2439 /* Some miscellaneous functions that are Windows specific, but not GUI
2440 specific (ie. are applicable in terminal or batch mode as well). */
2442 DEFUN ("w32-short-file-name", Fw32_short_file_name, Sw32_short_file_name, 1, 1, 0,
2443 doc: /* Return the short file name version (8.3) of the full path of FILENAME.
2444 If FILENAME does not exist, return nil.
2445 All path elements in FILENAME are converted to their short names. */)
2446 (Lisp_Object filename)
2448 char shortname[MAX_PATH];
2450 CHECK_STRING (filename);
2452 /* first expand it. */
2453 filename = Fexpand_file_name (filename, Qnil);
2455 /* luckily, this returns the short version of each element in the path. */
2456 if (GetShortPathName (SDATA (ENCODE_FILE (filename)), shortname, MAX_PATH) == 0)
2457 return Qnil;
2459 dostounix_filename (shortname);
2461 return build_string (shortname);
2465 DEFUN ("w32-long-file-name", Fw32_long_file_name, Sw32_long_file_name,
2466 1, 1, 0,
2467 doc: /* Return the long file name version of the full path of FILENAME.
2468 If FILENAME does not exist, return nil.
2469 All path elements in FILENAME are converted to their long names. */)
2470 (Lisp_Object filename)
2472 char longname[ MAX_PATH ];
2473 int drive_only = 0;
2475 CHECK_STRING (filename);
2477 if (SBYTES (filename) == 2
2478 && *(SDATA (filename) + 1) == ':')
2479 drive_only = 1;
2481 /* first expand it. */
2482 filename = Fexpand_file_name (filename, Qnil);
2484 if (!w32_get_long_filename (SDATA (ENCODE_FILE (filename)), longname, MAX_PATH))
2485 return Qnil;
2487 dostounix_filename (longname);
2489 /* If we were passed only a drive, make sure that a slash is not appended
2490 for consistency with directories. Allow for drive mapping via SUBST
2491 in case expand-file-name is ever changed to expand those. */
2492 if (drive_only && longname[1] == ':' && longname[2] == '/' && !longname[3])
2493 longname[2] = '\0';
2495 return DECODE_FILE (build_string (longname));
2498 DEFUN ("w32-set-process-priority", Fw32_set_process_priority,
2499 Sw32_set_process_priority, 2, 2, 0,
2500 doc: /* Set the priority of PROCESS to PRIORITY.
2501 If PROCESS is nil, the priority of Emacs is changed, otherwise the
2502 priority of the process whose pid is PROCESS is changed.
2503 PRIORITY should be one of the symbols high, normal, or low;
2504 any other symbol will be interpreted as normal.
2506 If successful, the return value is t, otherwise nil. */)
2507 (Lisp_Object process, Lisp_Object priority)
2509 HANDLE proc_handle = GetCurrentProcess ();
2510 DWORD priority_class = NORMAL_PRIORITY_CLASS;
2511 Lisp_Object result = Qnil;
2513 CHECK_SYMBOL (priority);
2515 if (!NILP (process))
2517 DWORD pid;
2518 child_process *cp;
2520 CHECK_NUMBER (process);
2522 /* Allow pid to be an internally generated one, or one obtained
2523 externally. This is necessary because real pids on Windows 95 are
2524 negative. */
2526 pid = XINT (process);
2527 cp = find_child_pid (pid);
2528 if (cp != NULL)
2529 pid = cp->procinfo.dwProcessId;
2531 proc_handle = OpenProcess (PROCESS_SET_INFORMATION, FALSE, pid);
2534 if (EQ (priority, Qhigh))
2535 priority_class = HIGH_PRIORITY_CLASS;
2536 else if (EQ (priority, Qlow))
2537 priority_class = IDLE_PRIORITY_CLASS;
2539 if (proc_handle != NULL)
2541 if (SetPriorityClass (proc_handle, priority_class))
2542 result = Qt;
2543 if (!NILP (process))
2544 CloseHandle (proc_handle);
2547 return result;
2550 #ifdef HAVE_LANGINFO_CODESET
2551 /* Emulation of nl_langinfo. Used in fns.c:Flocale_info. */
2552 char *
2553 nl_langinfo (nl_item item)
2555 /* Conversion of Posix item numbers to their Windows equivalents. */
2556 static const LCTYPE w32item[] = {
2557 LOCALE_IDEFAULTANSICODEPAGE,
2558 LOCALE_SDAYNAME1, LOCALE_SDAYNAME2, LOCALE_SDAYNAME3,
2559 LOCALE_SDAYNAME4, LOCALE_SDAYNAME5, LOCALE_SDAYNAME6, LOCALE_SDAYNAME7,
2560 LOCALE_SMONTHNAME1, LOCALE_SMONTHNAME2, LOCALE_SMONTHNAME3,
2561 LOCALE_SMONTHNAME4, LOCALE_SMONTHNAME5, LOCALE_SMONTHNAME6,
2562 LOCALE_SMONTHNAME7, LOCALE_SMONTHNAME8, LOCALE_SMONTHNAME9,
2563 LOCALE_SMONTHNAME10, LOCALE_SMONTHNAME11, LOCALE_SMONTHNAME12
2566 static char *nl_langinfo_buf = NULL;
2567 static int nl_langinfo_len = 0;
2569 if (nl_langinfo_len <= 0)
2570 nl_langinfo_buf = xmalloc (nl_langinfo_len = 1);
2572 if (item < 0 || item >= _NL_NUM)
2573 nl_langinfo_buf[0] = 0;
2574 else
2576 LCID cloc = GetThreadLocale ();
2577 int need_len = GetLocaleInfo (cloc, w32item[item] | LOCALE_USE_CP_ACP,
2578 NULL, 0);
2580 if (need_len <= 0)
2581 nl_langinfo_buf[0] = 0;
2582 else
2584 if (item == CODESET)
2586 need_len += 2; /* for the "cp" prefix */
2587 if (need_len < 8) /* for the case we call GetACP */
2588 need_len = 8;
2590 if (nl_langinfo_len <= need_len)
2591 nl_langinfo_buf = xrealloc (nl_langinfo_buf,
2592 nl_langinfo_len = need_len);
2593 if (!GetLocaleInfo (cloc, w32item[item] | LOCALE_USE_CP_ACP,
2594 nl_langinfo_buf, nl_langinfo_len))
2595 nl_langinfo_buf[0] = 0;
2596 else if (item == CODESET)
2598 if (strcmp (nl_langinfo_buf, "0") == 0 /* CP_ACP */
2599 || strcmp (nl_langinfo_buf, "1") == 0) /* CP_OEMCP */
2600 sprintf (nl_langinfo_buf, "cp%u", GetACP ());
2601 else
2603 memmove (nl_langinfo_buf + 2, nl_langinfo_buf,
2604 strlen (nl_langinfo_buf) + 1);
2605 nl_langinfo_buf[0] = 'c';
2606 nl_langinfo_buf[1] = 'p';
2611 return nl_langinfo_buf;
2613 #endif /* HAVE_LANGINFO_CODESET */
2615 DEFUN ("w32-get-locale-info", Fw32_get_locale_info,
2616 Sw32_get_locale_info, 1, 2, 0,
2617 doc: /* Return information about the Windows locale LCID.
2618 By default, return a three letter locale code which encodes the default
2619 language as the first two characters, and the country or regional variant
2620 as the third letter. For example, ENU refers to `English (United States)',
2621 while ENC means `English (Canadian)'.
2623 If the optional argument LONGFORM is t, the long form of the locale
2624 name is returned, e.g. `English (United States)' instead; if LONGFORM
2625 is a number, it is interpreted as an LCTYPE constant and the corresponding
2626 locale information is returned.
2628 If LCID (a 16-bit number) is not a valid locale, the result is nil. */)
2629 (Lisp_Object lcid, Lisp_Object longform)
2631 int got_abbrev;
2632 int got_full;
2633 char abbrev_name[32] = { 0 };
2634 char full_name[256] = { 0 };
2636 CHECK_NUMBER (lcid);
2638 if (!IsValidLocale (XINT (lcid), LCID_SUPPORTED))
2639 return Qnil;
2641 if (NILP (longform))
2643 got_abbrev = GetLocaleInfo (XINT (lcid),
2644 LOCALE_SABBREVLANGNAME | LOCALE_USE_CP_ACP,
2645 abbrev_name, sizeof (abbrev_name));
2646 if (got_abbrev)
2647 return build_string (abbrev_name);
2649 else if (EQ (longform, Qt))
2651 got_full = GetLocaleInfo (XINT (lcid),
2652 LOCALE_SLANGUAGE | LOCALE_USE_CP_ACP,
2653 full_name, sizeof (full_name));
2654 if (got_full)
2655 return DECODE_SYSTEM (build_string (full_name));
2657 else if (NUMBERP (longform))
2659 got_full = GetLocaleInfo (XINT (lcid),
2660 XINT (longform),
2661 full_name, sizeof (full_name));
2662 /* GetLocaleInfo's return value includes the terminating null
2663 character, when the returned information is a string, whereas
2664 make_unibyte_string needs the string length without the
2665 terminating null. */
2666 if (got_full)
2667 return make_unibyte_string (full_name, got_full - 1);
2670 return Qnil;
2674 DEFUN ("w32-get-current-locale-id", Fw32_get_current_locale_id,
2675 Sw32_get_current_locale_id, 0, 0, 0,
2676 doc: /* Return Windows locale id for current locale setting.
2677 This is a numerical value; use `w32-get-locale-info' to convert to a
2678 human-readable form. */)
2679 (void)
2681 return make_number (GetThreadLocale ());
2684 static DWORD
2685 int_from_hex (char * s)
2687 DWORD val = 0;
2688 static char hex[] = "0123456789abcdefABCDEF";
2689 char * p;
2691 while (*s && (p = strchr (hex, *s)) != NULL)
2693 unsigned digit = p - hex;
2694 if (digit > 15)
2695 digit -= 6;
2696 val = val * 16 + digit;
2697 s++;
2699 return val;
2702 /* We need to build a global list, since the EnumSystemLocale callback
2703 function isn't given a context pointer. */
2704 Lisp_Object Vw32_valid_locale_ids;
2706 static BOOL CALLBACK
2707 enum_locale_fn (LPTSTR localeNum)
2709 DWORD id = int_from_hex (localeNum);
2710 Vw32_valid_locale_ids = Fcons (make_number (id), Vw32_valid_locale_ids);
2711 return TRUE;
2714 DEFUN ("w32-get-valid-locale-ids", Fw32_get_valid_locale_ids,
2715 Sw32_get_valid_locale_ids, 0, 0, 0,
2716 doc: /* Return list of all valid Windows locale ids.
2717 Each id is a numerical value; use `w32-get-locale-info' to convert to a
2718 human-readable form. */)
2719 (void)
2721 Vw32_valid_locale_ids = Qnil;
2723 EnumSystemLocales (enum_locale_fn, LCID_SUPPORTED);
2725 Vw32_valid_locale_ids = Fnreverse (Vw32_valid_locale_ids);
2726 return Vw32_valid_locale_ids;
2730 DEFUN ("w32-get-default-locale-id", Fw32_get_default_locale_id, Sw32_get_default_locale_id, 0, 1, 0,
2731 doc: /* Return Windows locale id for default locale setting.
2732 By default, the system default locale setting is returned; if the optional
2733 parameter USERP is non-nil, the user default locale setting is returned.
2734 This is a numerical value; use `w32-get-locale-info' to convert to a
2735 human-readable form. */)
2736 (Lisp_Object userp)
2738 if (NILP (userp))
2739 return make_number (GetSystemDefaultLCID ());
2740 return make_number (GetUserDefaultLCID ());
2744 DEFUN ("w32-set-current-locale", Fw32_set_current_locale, Sw32_set_current_locale, 1, 1, 0,
2745 doc: /* Make Windows locale LCID be the current locale setting for Emacs.
2746 If successful, the new locale id is returned, otherwise nil. */)
2747 (Lisp_Object lcid)
2749 CHECK_NUMBER (lcid);
2751 if (!IsValidLocale (XINT (lcid), LCID_SUPPORTED))
2752 return Qnil;
2754 if (!SetThreadLocale (XINT (lcid)))
2755 return Qnil;
2757 /* Need to set input thread locale if present. */
2758 if (dwWindowsThreadId)
2759 /* Reply is not needed. */
2760 PostThreadMessage (dwWindowsThreadId, WM_EMACS_SETLOCALE, XINT (lcid), 0);
2762 return make_number (GetThreadLocale ());
2766 /* We need to build a global list, since the EnumCodePages callback
2767 function isn't given a context pointer. */
2768 Lisp_Object Vw32_valid_codepages;
2770 static BOOL CALLBACK
2771 enum_codepage_fn (LPTSTR codepageNum)
2773 DWORD id = atoi (codepageNum);
2774 Vw32_valid_codepages = Fcons (make_number (id), Vw32_valid_codepages);
2775 return TRUE;
2778 DEFUN ("w32-get-valid-codepages", Fw32_get_valid_codepages,
2779 Sw32_get_valid_codepages, 0, 0, 0,
2780 doc: /* Return list of all valid Windows codepages. */)
2781 (void)
2783 Vw32_valid_codepages = Qnil;
2785 EnumSystemCodePages (enum_codepage_fn, CP_SUPPORTED);
2787 Vw32_valid_codepages = Fnreverse (Vw32_valid_codepages);
2788 return Vw32_valid_codepages;
2792 DEFUN ("w32-get-console-codepage", Fw32_get_console_codepage,
2793 Sw32_get_console_codepage, 0, 0, 0,
2794 doc: /* Return current Windows codepage for console input. */)
2795 (void)
2797 return make_number (GetConsoleCP ());
2801 DEFUN ("w32-set-console-codepage", Fw32_set_console_codepage,
2802 Sw32_set_console_codepage, 1, 1, 0,
2803 doc: /* Make Windows codepage CP be the codepage for Emacs tty keyboard input.
2804 This codepage setting affects keyboard input in tty mode.
2805 If successful, the new CP is returned, otherwise nil. */)
2806 (Lisp_Object cp)
2808 CHECK_NUMBER (cp);
2810 if (!IsValidCodePage (XINT (cp)))
2811 return Qnil;
2813 if (!SetConsoleCP (XINT (cp)))
2814 return Qnil;
2816 return make_number (GetConsoleCP ());
2820 DEFUN ("w32-get-console-output-codepage", Fw32_get_console_output_codepage,
2821 Sw32_get_console_output_codepage, 0, 0, 0,
2822 doc: /* Return current Windows codepage for console output. */)
2823 (void)
2825 return make_number (GetConsoleOutputCP ());
2829 DEFUN ("w32-set-console-output-codepage", Fw32_set_console_output_codepage,
2830 Sw32_set_console_output_codepage, 1, 1, 0,
2831 doc: /* Make Windows codepage CP be the codepage for Emacs console output.
2832 This codepage setting affects display in tty mode.
2833 If successful, the new CP is returned, otherwise nil. */)
2834 (Lisp_Object cp)
2836 CHECK_NUMBER (cp);
2838 if (!IsValidCodePage (XINT (cp)))
2839 return Qnil;
2841 if (!SetConsoleOutputCP (XINT (cp)))
2842 return Qnil;
2844 return make_number (GetConsoleOutputCP ());
2848 DEFUN ("w32-get-codepage-charset", Fw32_get_codepage_charset,
2849 Sw32_get_codepage_charset, 1, 1, 0,
2850 doc: /* Return charset ID corresponding to codepage CP.
2851 Returns nil if the codepage is not valid. */)
2852 (Lisp_Object cp)
2854 CHARSETINFO info;
2856 CHECK_NUMBER (cp);
2858 if (!IsValidCodePage (XINT (cp)))
2859 return Qnil;
2861 if (TranslateCharsetInfo ((DWORD *) XINT (cp), &info, TCI_SRCCODEPAGE))
2862 return make_number (info.ciCharset);
2864 return Qnil;
2868 DEFUN ("w32-get-valid-keyboard-layouts", Fw32_get_valid_keyboard_layouts,
2869 Sw32_get_valid_keyboard_layouts, 0, 0, 0,
2870 doc: /* Return list of Windows keyboard languages and layouts.
2871 The return value is a list of pairs of language id and layout id. */)
2872 (void)
2874 int num_layouts = GetKeyboardLayoutList (0, NULL);
2875 HKL * layouts = (HKL *) alloca (num_layouts * sizeof (HKL));
2876 Lisp_Object obj = Qnil;
2878 if (GetKeyboardLayoutList (num_layouts, layouts) == num_layouts)
2880 while (--num_layouts >= 0)
2882 DWORD kl = (DWORD) layouts[num_layouts];
2884 obj = Fcons (Fcons (make_number (kl & 0xffff),
2885 make_number ((kl >> 16) & 0xffff)),
2886 obj);
2890 return obj;
2894 DEFUN ("w32-get-keyboard-layout", Fw32_get_keyboard_layout,
2895 Sw32_get_keyboard_layout, 0, 0, 0,
2896 doc: /* Return current Windows keyboard language and layout.
2897 The return value is the cons of the language id and the layout id. */)
2898 (void)
2900 DWORD kl = (DWORD) GetKeyboardLayout (dwWindowsThreadId);
2902 return Fcons (make_number (kl & 0xffff),
2903 make_number ((kl >> 16) & 0xffff));
2907 DEFUN ("w32-set-keyboard-layout", Fw32_set_keyboard_layout,
2908 Sw32_set_keyboard_layout, 1, 1, 0,
2909 doc: /* Make LAYOUT be the current keyboard layout for Emacs.
2910 The keyboard layout setting affects interpretation of keyboard input.
2911 If successful, the new layout id is returned, otherwise nil. */)
2912 (Lisp_Object layout)
2914 DWORD kl;
2916 CHECK_CONS (layout);
2917 CHECK_NUMBER_CAR (layout);
2918 CHECK_NUMBER_CDR (layout);
2920 kl = (XINT (XCAR (layout)) & 0xffff)
2921 | (XINT (XCDR (layout)) << 16);
2923 /* Synchronize layout with input thread. */
2924 if (dwWindowsThreadId)
2926 if (PostThreadMessage (dwWindowsThreadId, WM_EMACS_SETKEYBOARDLAYOUT,
2927 (WPARAM) kl, 0))
2929 MSG msg;
2930 GetMessage (&msg, NULL, WM_EMACS_DONE, WM_EMACS_DONE);
2932 if (msg.wParam == 0)
2933 return Qnil;
2936 else if (!ActivateKeyboardLayout ((HKL) kl, 0))
2937 return Qnil;
2939 return Fw32_get_keyboard_layout ();
2943 void
2944 syms_of_ntproc (void)
2946 DEFSYM (Qhigh, "high");
2947 DEFSYM (Qlow, "low");
2949 defsubr (&Sw32_has_winsock);
2950 defsubr (&Sw32_unload_winsock);
2952 defsubr (&Sw32_short_file_name);
2953 defsubr (&Sw32_long_file_name);
2954 defsubr (&Sw32_set_process_priority);
2955 defsubr (&Sw32_get_locale_info);
2956 defsubr (&Sw32_get_current_locale_id);
2957 defsubr (&Sw32_get_default_locale_id);
2958 defsubr (&Sw32_get_valid_locale_ids);
2959 defsubr (&Sw32_set_current_locale);
2961 defsubr (&Sw32_get_console_codepage);
2962 defsubr (&Sw32_set_console_codepage);
2963 defsubr (&Sw32_get_console_output_codepage);
2964 defsubr (&Sw32_set_console_output_codepage);
2965 defsubr (&Sw32_get_valid_codepages);
2966 defsubr (&Sw32_get_codepage_charset);
2968 defsubr (&Sw32_get_valid_keyboard_layouts);
2969 defsubr (&Sw32_get_keyboard_layout);
2970 defsubr (&Sw32_set_keyboard_layout);
2972 DEFVAR_LISP ("w32-quote-process-args", Vw32_quote_process_args,
2973 doc: /* Non-nil enables quoting of process arguments to ensure correct parsing.
2974 Because Windows does not directly pass argv arrays to child processes,
2975 programs have to reconstruct the argv array by parsing the command
2976 line string. For an argument to contain a space, it must be enclosed
2977 in double quotes or it will be parsed as multiple arguments.
2979 If the value is a character, that character will be used to escape any
2980 quote characters that appear, otherwise a suitable escape character
2981 will be chosen based on the type of the program. */);
2982 Vw32_quote_process_args = Qt;
2984 DEFVAR_LISP ("w32-start-process-show-window",
2985 Vw32_start_process_show_window,
2986 doc: /* When nil, new child processes hide their windows.
2987 When non-nil, they show their window in the method of their choice.
2988 This variable doesn't affect GUI applications, which will never be hidden. */);
2989 Vw32_start_process_show_window = Qnil;
2991 DEFVAR_LISP ("w32-start-process-share-console",
2992 Vw32_start_process_share_console,
2993 doc: /* When nil, new child processes are given a new console.
2994 When non-nil, they share the Emacs console; this has the limitation of
2995 allowing only one DOS subprocess to run at a time (whether started directly
2996 or indirectly by Emacs), and preventing Emacs from cleanly terminating the
2997 subprocess group, but may allow Emacs to interrupt a subprocess that doesn't
2998 otherwise respond to interrupts from Emacs. */);
2999 Vw32_start_process_share_console = Qnil;
3001 DEFVAR_LISP ("w32-start-process-inherit-error-mode",
3002 Vw32_start_process_inherit_error_mode,
3003 doc: /* When nil, new child processes revert to the default error mode.
3004 When non-nil, they inherit their error mode setting from Emacs, which stops
3005 them blocking when trying to access unmounted drives etc. */);
3006 Vw32_start_process_inherit_error_mode = Qt;
3008 DEFVAR_INT ("w32-pipe-read-delay", w32_pipe_read_delay,
3009 doc: /* Forced delay before reading subprocess output.
3010 This is done to improve the buffering of subprocess output, by
3011 avoiding the inefficiency of frequently reading small amounts of data.
3013 If positive, the value is the number of milliseconds to sleep before
3014 reading the subprocess output. If negative, the magnitude is the number
3015 of time slices to wait (effectively boosting the priority of the child
3016 process temporarily). A value of zero disables waiting entirely. */);
3017 w32_pipe_read_delay = 50;
3019 DEFVAR_LISP ("w32-downcase-file-names", Vw32_downcase_file_names,
3020 doc: /* Non-nil means convert all-upper case file names to lower case.
3021 This applies when performing completions and file name expansion.
3022 Note that the value of this setting also affects remote file names,
3023 so you probably don't want to set to non-nil if you use case-sensitive
3024 filesystems via ange-ftp. */);
3025 Vw32_downcase_file_names = Qnil;
3027 #if 0
3028 DEFVAR_LISP ("w32-generate-fake-inodes", Vw32_generate_fake_inodes,
3029 doc: /* Non-nil means attempt to fake realistic inode values.
3030 This works by hashing the truename of files, and should detect
3031 aliasing between long and short (8.3 DOS) names, but can have
3032 false positives because of hash collisions. Note that determining
3033 the truename of a file can be slow. */);
3034 Vw32_generate_fake_inodes = Qnil;
3035 #endif
3037 DEFVAR_LISP ("w32-get-true-file-attributes", Vw32_get_true_file_attributes,
3038 doc: /* Non-nil means determine accurate file attributes in `file-attributes'.
3039 This option controls whether to issue additional system calls to determine
3040 accurate link counts, file type, and ownership information. It is more
3041 useful for files on NTFS volumes, where hard links and file security are
3042 supported, than on volumes of the FAT family.
3044 Without these system calls, link count will always be reported as 1 and file
3045 ownership will be attributed to the current user.
3046 The default value `local' means only issue these system calls for files
3047 on local fixed drives. A value of nil means never issue them.
3048 Any other non-nil value means do this even on remote and removable drives
3049 where the performance impact may be noticeable even on modern hardware. */);
3050 Vw32_get_true_file_attributes = Qlocal;
3052 staticpro (&Vw32_valid_locale_ids);
3053 staticpro (&Vw32_valid_codepages);
3055 /* end of w32proc.c */