Work around "Attempt to modify read-only object"
[emacs.git] / src / w32proc.c
blob1f633d834c274128a9aaff414eed995db0ae871f
1 /* Process support for GNU Emacs on the Microsoft Windows API.
3 Copyright (C) 1992, 1995, 1999-2015 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 Drew Bliss Oct 14, 1993
22 Adapted from alarm.c by Tim Fleehart
25 #include <mingw_time.h>
26 #include <stdio.h>
27 #include <stdlib.h>
28 #include <errno.h>
29 #include <ctype.h>
30 #include <io.h>
31 #include <fcntl.h>
32 #include <signal.h>
33 #include <sys/file.h>
34 #include <mbstring.h>
35 #include <locale.h>
37 /* must include CRT headers *before* config.h */
38 #include <config.h>
40 #undef signal
41 #undef wait
42 #undef spawnve
43 #undef select
44 #undef kill
46 #include <windows.h>
47 #if defined(__GNUC__) && !defined(__MINGW64__)
48 /* This definition is missing from mingw.org headers, but not MinGW64
49 headers. */
50 extern BOOL WINAPI IsValidLocale (LCID, DWORD);
51 #endif
53 #ifdef HAVE_LANGINFO_CODESET
54 #include <nl_types.h>
55 #include <langinfo.h>
56 #endif
58 #include "lisp.h"
59 #include "w32.h"
60 #include "w32common.h"
61 #include "w32heap.h"
62 #include "systime.h"
63 #include "syswait.h"
64 #include "process.h"
65 #include "syssignal.h"
66 #include "w32term.h"
67 #include "dispextern.h" /* for xstrcasecmp */
68 #include "coding.h"
70 #define RVA_TO_PTR(var,section,filedata) \
71 ((void *)((section)->PointerToRawData \
72 + ((DWORD_PTR)(var) - (section)->VirtualAddress) \
73 + (filedata).file_base))
75 /* Signal handlers...SIG_DFL == 0 so this is initialized correctly. */
76 static signal_handler sig_handlers[NSIG];
78 static sigset_t sig_mask;
80 static CRITICAL_SECTION crit_sig;
82 /* Improve on the CRT 'signal' implementation so that we could record
83 the SIGCHLD handler and fake interval timers. */
84 signal_handler
85 sys_signal (int sig, signal_handler handler)
87 signal_handler old;
89 /* SIGCHLD is needed for supporting subprocesses, see sys_kill
90 below. SIGALRM and SIGPROF are used by setitimer. All the
91 others are the only ones supported by the MS runtime. */
92 if (!(sig == SIGCHLD || sig == SIGSEGV || sig == SIGILL
93 || sig == SIGFPE || sig == SIGABRT || sig == SIGTERM
94 || sig == SIGALRM || sig == SIGPROF))
96 errno = EINVAL;
97 return SIG_ERR;
99 old = sig_handlers[sig];
100 /* SIGABRT is treated specially because w32.c installs term_ntproc
101 as its handler, so we don't want to override that afterwards.
102 Aborting Emacs works specially anyway: either by calling
103 emacs_abort directly or through terminate_due_to_signal, which
104 calls emacs_abort through emacs_raise. */
105 if (!(sig == SIGABRT && old == term_ntproc))
107 sig_handlers[sig] = handler;
108 if (!(sig == SIGCHLD || sig == SIGALRM || sig == SIGPROF))
109 signal (sig, handler);
111 return old;
114 /* Emulate sigaction. */
116 sigaction (int sig, const struct sigaction *act, struct sigaction *oact)
118 signal_handler old = SIG_DFL;
119 int retval = 0;
121 if (act)
122 old = sys_signal (sig, act->sa_handler);
123 else if (oact)
124 old = sig_handlers[sig];
126 if (old == SIG_ERR)
128 errno = EINVAL;
129 retval = -1;
131 if (oact)
133 oact->sa_handler = old;
134 oact->sa_flags = 0;
135 oact->sa_mask = empty_mask;
137 return retval;
140 /* Emulate signal sets and blocking of signals used by timers. */
143 sigemptyset (sigset_t *set)
145 *set = 0;
146 return 0;
150 sigaddset (sigset_t *set, int signo)
152 if (!set)
154 errno = EINVAL;
155 return -1;
157 if (signo < 0 || signo >= NSIG)
159 errno = EINVAL;
160 return -1;
163 *set |= (1U << signo);
165 return 0;
169 sigfillset (sigset_t *set)
171 if (!set)
173 errno = EINVAL;
174 return -1;
177 *set = 0xFFFFFFFF;
178 return 0;
182 sigprocmask (int how, const sigset_t *set, sigset_t *oset)
184 if (!(how == SIG_BLOCK || how == SIG_UNBLOCK || how == SIG_SETMASK))
186 errno = EINVAL;
187 return -1;
190 if (oset)
191 *oset = sig_mask;
193 if (!set)
194 return 0;
196 switch (how)
198 case SIG_BLOCK:
199 sig_mask |= *set;
200 break;
201 case SIG_SETMASK:
202 sig_mask = *set;
203 break;
204 case SIG_UNBLOCK:
205 /* FIXME: Catch signals that are blocked and reissue them when
206 they are unblocked. Important for SIGALRM and SIGPROF only. */
207 sig_mask &= ~(*set);
208 break;
211 return 0;
215 pthread_sigmask (int how, const sigset_t *set, sigset_t *oset)
217 if (sigprocmask (how, set, oset) == -1)
218 return EINVAL;
219 return 0;
223 sigismember (const sigset_t *set, int signo)
225 if (signo < 0 || signo >= NSIG)
227 errno = EINVAL;
228 return -1;
230 if (signo > sizeof (*set) * BITS_PER_CHAR)
231 emacs_abort ();
233 return (*set & (1U << signo)) != 0;
236 pid_t
237 getpgrp (void)
239 return getpid ();
242 pid_t
243 tcgetpgrp (int fd)
245 return getpid ();
249 setpgid (pid_t pid, pid_t pgid)
251 return 0;
254 pid_t
255 setsid (void)
257 return getpid ();
260 /* Emulations of interval timers.
262 Limitations: only ITIMER_REAL and ITIMER_PROF are supported.
264 Implementation: a separate thread is started for each timer type,
265 the thread calls the appropriate signal handler when the timer
266 expires, after stopping the thread which installed the timer. */
268 struct itimer_data {
269 volatile ULONGLONG expire;
270 volatile ULONGLONG reload;
271 volatile int terminate;
272 int type;
273 HANDLE caller_thread;
274 HANDLE timer_thread;
277 static ULONGLONG ticks_now;
278 static struct itimer_data real_itimer, prof_itimer;
279 static ULONGLONG clocks_min;
280 /* If non-zero, itimers are disabled. Used during shutdown, when we
281 delete the critical sections used by the timer threads. */
282 static int disable_itimers;
284 static CRITICAL_SECTION crit_real, crit_prof;
286 /* GetThreadTimes is not available on Windows 9X and possibly also on 2K. */
287 typedef BOOL (WINAPI *GetThreadTimes_Proc) (
288 HANDLE hThread,
289 LPFILETIME lpCreationTime,
290 LPFILETIME lpExitTime,
291 LPFILETIME lpKernelTime,
292 LPFILETIME lpUserTime);
294 static GetThreadTimes_Proc s_pfn_Get_Thread_Times;
296 #define MAX_SINGLE_SLEEP 30
297 #define TIMER_TICKS_PER_SEC 1000
299 /* Return a suitable time value, in 1-ms units, for THREAD, a handle
300 to a thread. If THREAD is NULL or an invalid handle, return the
301 current wall-clock time since January 1, 1601 (UTC). Otherwise,
302 return the sum of kernel and user times used by THREAD since it was
303 created, plus its creation time. */
304 static ULONGLONG
305 w32_get_timer_time (HANDLE thread)
307 ULONGLONG retval;
308 int use_system_time = 1;
309 /* The functions below return times in 100-ns units. */
310 const int tscale = 10 * TIMER_TICKS_PER_SEC;
312 if (thread && thread != INVALID_HANDLE_VALUE
313 && s_pfn_Get_Thread_Times != NULL)
315 FILETIME creation_ftime, exit_ftime, kernel_ftime, user_ftime;
316 ULARGE_INTEGER temp_creation, temp_kernel, temp_user;
318 if (s_pfn_Get_Thread_Times (thread, &creation_ftime, &exit_ftime,
319 &kernel_ftime, &user_ftime))
321 use_system_time = 0;
322 temp_creation.LowPart = creation_ftime.dwLowDateTime;
323 temp_creation.HighPart = creation_ftime.dwHighDateTime;
324 temp_kernel.LowPart = kernel_ftime.dwLowDateTime;
325 temp_kernel.HighPart = kernel_ftime.dwHighDateTime;
326 temp_user.LowPart = user_ftime.dwLowDateTime;
327 temp_user.HighPart = user_ftime.dwHighDateTime;
328 retval =
329 temp_creation.QuadPart / tscale + temp_kernel.QuadPart / tscale
330 + temp_user.QuadPart / tscale;
332 else
333 DebPrint (("GetThreadTimes failed with error code %lu\n",
334 GetLastError ()));
337 if (use_system_time)
339 FILETIME current_ftime;
340 ULARGE_INTEGER temp;
342 GetSystemTimeAsFileTime (&current_ftime);
344 temp.LowPart = current_ftime.dwLowDateTime;
345 temp.HighPart = current_ftime.dwHighDateTime;
347 retval = temp.QuadPart / tscale;
350 return retval;
353 /* Thread function for a timer thread. */
354 static DWORD WINAPI
355 timer_loop (LPVOID arg)
357 struct itimer_data *itimer = (struct itimer_data *)arg;
358 int which = itimer->type;
359 int sig = (which == ITIMER_REAL) ? SIGALRM : SIGPROF;
360 CRITICAL_SECTION *crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
361 const DWORD max_sleep = MAX_SINGLE_SLEEP * 1000 / TIMER_TICKS_PER_SEC;
362 HANDLE hth = (which == ITIMER_REAL) ? NULL : itimer->caller_thread;
364 while (1)
366 DWORD sleep_time;
367 signal_handler handler;
368 ULONGLONG now, expire, reload;
370 /* Load new values if requested by setitimer. */
371 EnterCriticalSection (crit);
372 expire = itimer->expire;
373 reload = itimer->reload;
374 LeaveCriticalSection (crit);
375 if (itimer->terminate)
376 return 0;
378 if (expire == 0)
380 /* We are idle. */
381 Sleep (max_sleep);
382 continue;
385 if (expire > (now = w32_get_timer_time (hth)))
386 sleep_time = expire - now;
387 else
388 sleep_time = 0;
389 /* Don't sleep too long at a time, to be able to see the
390 termination flag without too long a delay. */
391 while (sleep_time > max_sleep)
393 if (itimer->terminate)
394 return 0;
395 Sleep (max_sleep);
396 EnterCriticalSection (crit);
397 expire = itimer->expire;
398 LeaveCriticalSection (crit);
399 sleep_time =
400 (expire > (now = w32_get_timer_time (hth))) ? expire - now : 0;
402 if (itimer->terminate)
403 return 0;
404 if (sleep_time > 0)
406 Sleep (sleep_time * 1000 / TIMER_TICKS_PER_SEC);
407 /* Always sleep past the expiration time, to make sure we
408 never call the handler _before_ the expiration time,
409 always slightly after it. Sleep(5) makes sure we don't
410 hog the CPU by calling 'w32_get_timer_time' with high
411 frequency, and also let other threads work. */
412 while (w32_get_timer_time (hth) < expire)
413 Sleep (5);
416 EnterCriticalSection (crit);
417 expire = itimer->expire;
418 LeaveCriticalSection (crit);
419 if (expire == 0)
420 continue;
422 /* Time's up. */
423 handler = sig_handlers[sig];
424 if (!(handler == SIG_DFL || handler == SIG_IGN || handler == SIG_ERR)
425 /* FIXME: Don't ignore masked signals. Instead, record that
426 they happened and reissue them when the signal is
427 unblocked. */
428 && !sigismember (&sig_mask, sig)
429 /* Simulate masking of SIGALRM and SIGPROF when processing
430 fatal signals. */
431 && !fatal_error_in_progress
432 && itimer->caller_thread)
434 /* Simulate a signal delivered to the thread which installed
435 the timer, by suspending that thread while the handler
436 runs. */
437 HANDLE th = itimer->caller_thread;
438 DWORD result = SuspendThread (th);
440 if (result == (DWORD)-1)
441 return 2;
443 handler (sig);
444 ResumeThread (th);
447 /* Update expiration time and loop. */
448 EnterCriticalSection (crit);
449 expire = itimer->expire;
450 if (expire == 0)
452 LeaveCriticalSection (crit);
453 continue;
455 reload = itimer->reload;
456 if (reload > 0)
458 now = w32_get_timer_time (hth);
459 if (expire <= now)
461 ULONGLONG lag = now - expire;
463 /* If we missed some opportunities (presumably while
464 sleeping or while the signal handler ran), skip
465 them. */
466 if (lag > reload)
467 expire = now - (lag % reload);
469 expire += reload;
472 else
473 expire = 0; /* become idle */
474 itimer->expire = expire;
475 LeaveCriticalSection (crit);
477 return 0;
480 static void
481 stop_timer_thread (int which)
483 struct itimer_data *itimer =
484 (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
485 int i;
486 DWORD err, exit_code = 255;
487 BOOL status;
489 /* Signal the thread that it should terminate. */
490 itimer->terminate = 1;
492 if (itimer->timer_thread == NULL)
493 return;
495 /* Wait for the timer thread to terminate voluntarily, then kill it
496 if it doesn't. This loop waits twice more than the maximum
497 amount of time a timer thread sleeps, see above. */
498 for (i = 0; i < MAX_SINGLE_SLEEP / 5; i++)
500 if (!((status = GetExitCodeThread (itimer->timer_thread, &exit_code))
501 && exit_code == STILL_ACTIVE))
502 break;
503 Sleep (10);
505 if ((status == FALSE && (err = GetLastError ()) == ERROR_INVALID_HANDLE)
506 || exit_code == STILL_ACTIVE)
508 if (!(status == FALSE && err == ERROR_INVALID_HANDLE))
509 TerminateThread (itimer->timer_thread, 0);
512 /* Clean up. */
513 CloseHandle (itimer->timer_thread);
514 itimer->timer_thread = NULL;
515 if (itimer->caller_thread)
517 CloseHandle (itimer->caller_thread);
518 itimer->caller_thread = NULL;
522 /* This is called at shutdown time from term_ntproc. */
523 void
524 term_timers (void)
526 if (real_itimer.timer_thread)
527 stop_timer_thread (ITIMER_REAL);
528 if (prof_itimer.timer_thread)
529 stop_timer_thread (ITIMER_PROF);
531 /* We are going to delete the critical sections, so timers cannot
532 work after this. */
533 disable_itimers = 1;
535 DeleteCriticalSection (&crit_real);
536 DeleteCriticalSection (&crit_prof);
537 DeleteCriticalSection (&crit_sig);
540 /* This is called at initialization time from init_ntproc. */
541 void
542 init_timers (void)
544 /* GetThreadTimes is not available on all versions of Windows, so
545 need to probe for its availability dynamically, and call it
546 through a pointer. */
547 s_pfn_Get_Thread_Times = NULL; /* in case dumped Emacs comes with a value */
548 if (os_subtype != OS_9X)
549 s_pfn_Get_Thread_Times =
550 (GetThreadTimes_Proc)GetProcAddress (GetModuleHandle ("kernel32.dll"),
551 "GetThreadTimes");
553 /* Make sure we start with zeroed out itimer structures, since
554 dumping may have left there traces of threads long dead. */
555 memset (&real_itimer, 0, sizeof real_itimer);
556 memset (&prof_itimer, 0, sizeof prof_itimer);
558 InitializeCriticalSection (&crit_real);
559 InitializeCriticalSection (&crit_prof);
560 InitializeCriticalSection (&crit_sig);
562 disable_itimers = 0;
565 static int
566 start_timer_thread (int which)
568 DWORD exit_code, tid;
569 HANDLE th;
570 struct itimer_data *itimer =
571 (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
573 if (itimer->timer_thread
574 && GetExitCodeThread (itimer->timer_thread, &exit_code)
575 && exit_code == STILL_ACTIVE)
576 return 0;
578 /* Clean up after possibly exited thread. */
579 if (itimer->timer_thread)
581 CloseHandle (itimer->timer_thread);
582 itimer->timer_thread = NULL;
584 if (itimer->caller_thread)
586 CloseHandle (itimer->caller_thread);
587 itimer->caller_thread = NULL;
590 /* Start a new thread. */
591 if (!DuplicateHandle (GetCurrentProcess (), GetCurrentThread (),
592 GetCurrentProcess (), &th, 0, FALSE,
593 DUPLICATE_SAME_ACCESS))
595 errno = ESRCH;
596 return -1;
598 itimer->terminate = 0;
599 itimer->type = which;
600 itimer->caller_thread = th;
601 /* Request that no more than 64KB of stack be reserved for this
602 thread, to avoid reserving too much memory, which would get in
603 the way of threads we start to wait for subprocesses. See also
604 new_child below. */
605 itimer->timer_thread = CreateThread (NULL, 64 * 1024, timer_loop,
606 (void *)itimer, 0x00010000, &tid);
608 if (!itimer->timer_thread)
610 CloseHandle (itimer->caller_thread);
611 itimer->caller_thread = NULL;
612 errno = EAGAIN;
613 return -1;
616 /* This is needed to make sure that the timer thread running for
617 profiling gets CPU as soon as the Sleep call terminates. */
618 if (which == ITIMER_PROF)
619 SetThreadPriority (itimer->timer_thread, THREAD_PRIORITY_TIME_CRITICAL);
621 return 0;
624 /* Most of the code of getitimer and setitimer (but not of their
625 subroutines) was shamelessly stolen from itimer.c in the DJGPP
626 library, see www.delorie.com/djgpp. */
628 getitimer (int which, struct itimerval *value)
630 volatile ULONGLONG *t_expire;
631 volatile ULONGLONG *t_reload;
632 ULONGLONG expire, reload;
633 __int64 usecs;
634 CRITICAL_SECTION *crit;
635 struct itimer_data *itimer;
637 if (disable_itimers)
638 return -1;
640 if (!value)
642 errno = EFAULT;
643 return -1;
646 if (which != ITIMER_REAL && which != ITIMER_PROF)
648 errno = EINVAL;
649 return -1;
652 itimer = (which == ITIMER_REAL) ? &real_itimer : &prof_itimer;
654 ticks_now = w32_get_timer_time ((which == ITIMER_REAL)
655 ? NULL
656 : GetCurrentThread ());
658 t_expire = &itimer->expire;
659 t_reload = &itimer->reload;
660 crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
662 EnterCriticalSection (crit);
663 reload = *t_reload;
664 expire = *t_expire;
665 LeaveCriticalSection (crit);
667 if (expire)
668 expire -= ticks_now;
670 value->it_value.tv_sec = expire / TIMER_TICKS_PER_SEC;
671 usecs =
672 (expire % TIMER_TICKS_PER_SEC) * (__int64)1000000 / TIMER_TICKS_PER_SEC;
673 value->it_value.tv_usec = usecs;
674 value->it_interval.tv_sec = reload / TIMER_TICKS_PER_SEC;
675 usecs =
676 (reload % TIMER_TICKS_PER_SEC) * (__int64)1000000 / TIMER_TICKS_PER_SEC;
677 value->it_interval.tv_usec= usecs;
679 return 0;
683 setitimer(int which, struct itimerval *value, struct itimerval *ovalue)
685 volatile ULONGLONG *t_expire, *t_reload;
686 ULONGLONG expire, reload, expire_old, reload_old;
687 __int64 usecs;
688 CRITICAL_SECTION *crit;
689 struct itimerval tem, *ptem;
691 if (disable_itimers)
692 return -1;
694 /* Posix systems expect timer values smaller than the resolution of
695 the system clock be rounded up to the clock resolution. First
696 time we are called, measure the clock tick resolution. */
697 if (!clocks_min)
699 ULONGLONG t1, t2;
701 for (t1 = w32_get_timer_time (NULL);
702 (t2 = w32_get_timer_time (NULL)) == t1; )
704 clocks_min = t2 - t1;
707 if (ovalue)
708 ptem = ovalue;
709 else
710 ptem = &tem;
712 if (getitimer (which, ptem)) /* also sets ticks_now */
713 return -1; /* errno already set */
715 t_expire =
716 (which == ITIMER_REAL) ? &real_itimer.expire : &prof_itimer.expire;
717 t_reload =
718 (which == ITIMER_REAL) ? &real_itimer.reload : &prof_itimer.reload;
720 crit = (which == ITIMER_REAL) ? &crit_real : &crit_prof;
722 if (!value
723 || (value->it_value.tv_sec == 0 && value->it_value.tv_usec == 0))
725 EnterCriticalSection (crit);
726 /* Disable the timer. */
727 *t_expire = 0;
728 *t_reload = 0;
729 LeaveCriticalSection (crit);
730 return 0;
733 reload = value->it_interval.tv_sec * TIMER_TICKS_PER_SEC;
735 usecs = value->it_interval.tv_usec;
736 if (value->it_interval.tv_sec == 0
737 && usecs && usecs * TIMER_TICKS_PER_SEC < clocks_min * 1000000)
738 reload = clocks_min;
739 else
741 usecs *= TIMER_TICKS_PER_SEC;
742 reload += usecs / 1000000;
745 expire = value->it_value.tv_sec * TIMER_TICKS_PER_SEC;
746 usecs = value->it_value.tv_usec;
747 if (value->it_value.tv_sec == 0
748 && usecs * TIMER_TICKS_PER_SEC < clocks_min * 1000000)
749 expire = clocks_min;
750 else
752 usecs *= TIMER_TICKS_PER_SEC;
753 expire += usecs / 1000000;
756 expire += ticks_now;
758 EnterCriticalSection (crit);
759 expire_old = *t_expire;
760 reload_old = *t_reload;
761 if (!(expire == expire_old && reload == reload_old))
763 *t_reload = reload;
764 *t_expire = expire;
766 LeaveCriticalSection (crit);
768 return start_timer_thread (which);
772 alarm (int seconds)
774 #ifdef HAVE_SETITIMER
775 struct itimerval new_values, old_values;
777 new_values.it_value.tv_sec = seconds;
778 new_values.it_value.tv_usec = 0;
779 new_values.it_interval.tv_sec = new_values.it_interval.tv_usec = 0;
781 if (setitimer (ITIMER_REAL, &new_values, &old_values) < 0)
782 return 0;
783 return old_values.it_value.tv_sec;
784 #else
785 return seconds;
786 #endif
791 /* Here's an overview of how support for subprocesses and
792 network/serial streams is implemented on MS-Windows.
794 The management of both subprocesses and network/serial streams
795 circles around the child_procs[] array, which can record up to the
796 grand total of MAX_CHILDREN (= 32) of these. (The reasons for the
797 32 limitation will become clear below.) Each member of
798 child_procs[] is a child_process structure, defined on w32.h.
800 A related data structure is the fd_info[] array, which holds twice
801 as many members, 64, and records the information about file
802 descriptors used for communicating with subprocesses and
803 network/serial devices. Each member of the array is the filedesc
804 structure, which records the Windows handle for communications,
805 such as the read end of the pipe to a subprocess, a socket handle,
806 etc.
808 Both these arrays reference each other: there's a member of
809 child_process structure that records the corresponding file
810 descriptor, and there's a member of filedesc structure that holds a
811 pointer to the corresponding child_process.
813 Whenever Emacs starts a subprocess or opens a network/serial
814 stream, the function new_child is called to prepare a new
815 child_process structure. new_child looks for the first vacant slot
816 in the child_procs[] array, initializes it, and starts a "reader
817 thread" that will watch the output of the subprocess/stream and its
818 status. (If no vacant slot can be found, new_child returns a
819 failure indication to its caller, and the higher-level Emacs
820 primitive that called it will then fail with EMFILE or EAGAIN.)
822 The reader thread started by new_child communicates with the main
823 (a.k.a. "Lisp") thread via two event objects and a status, all of
824 them recorded by the members of the child_process structure in
825 child_procs[]. The event objects serve as semaphores between the
826 reader thread and the 'pselect' emulation in sys_select, as follows:
828 . Initially, the reader thread is waiting for the char_consumed
829 event to become signaled by sys_select, which is an indication
830 for the reader thread to go ahead and try reading more stuff
831 from the subprocess/stream.
833 . The reader thread then attempts to read by calling a
834 blocking-read function. When the read call returns, either
835 successfully or with some failure indication, the reader thread
836 updates the status of the read accordingly, and signals the 2nd
837 event object, char_avail, on whose handle sys_select is
838 waiting. This tells sys_select that the file descriptor
839 allocated for the subprocess or the the stream is ready to be
840 read from.
842 When the subprocess exits or the network/serial stream is closed,
843 the reader thread sets the status accordingly and exits. It also
844 exits when the main thread sets the status to STATUS_READ_ERROR
845 and/or the char_avail and char_consumed event handles become NULL;
846 this is how delete_child, called by Emacs when a subprocess or a
847 stream is terminated, terminates the reader thread as part of
848 deleting the child_process object.
850 The sys_select function emulates the Posix 'pselect' function; it
851 is needed because the Windows 'select' function supports only
852 network sockets, while Emacs expects 'pselect' to work for any file
853 descriptor, including pipes and serial streams.
855 When sys_select is called, it uses the information in fd_info[]
856 array to convert the file descriptors which it was asked to watch
857 into Windows handles. In general, the handle to watch is the
858 handle of the char_avail event of the child_process structure that
859 corresponds to the file descriptor. In addition, for subprocesses,
860 sys_select watches one more handle: the handle for the subprocess,
861 so that it could emulate the SIGCHLD signal when the subprocess
862 exits.
864 If file descriptor zero (stdin) doesn't have its bit set in the
865 'rfds' argument to sys_select, the function always watches for
866 keyboard interrupts, to be able to interrupt the wait and return
867 when the user presses C-g.
869 Having collected the handles to watch, sys_select calls
870 WaitForMultipleObjects to wait for any one of them to become
871 signaled. Since WaitForMultipleObjects can only watch up to 64
872 handles, Emacs on Windows is limited to maximum 32 child_process
873 objects (since a subprocess consumes 2 handles to be watched, see
874 above).
876 When any of the handles become signaled, sys_select does whatever
877 is appropriate for the corresponding child_process object:
879 . If it's a handle to the char_avail event, sys_select marks the
880 corresponding bit in 'rfds', and Emacs will then read from that
881 file descriptor.
883 . If it's a handle to the process, sys_select calls the SIGCHLD
884 handler, to inform Emacs of the fact that the subprocess
885 exited.
887 The waitpid emulation works very similar to sys_select, except that
888 it only watches handles of subprocesses, and doesn't synchronize
889 with the reader thread.
891 Because socket descriptors on Windows are handles, while Emacs
892 expects them to be file descriptors, all low-level I/O functions,
893 such as 'read' and 'write', and all socket operations, like
894 'connect', 'recvfrom', 'accept', etc., are redirected to the
895 corresponding 'sys_*' functions, which must convert a file
896 descriptor to a handle using the fd_info[] array, and then invoke
897 the corresponding Windows API on the handle. Most of these
898 redirected 'sys_*' functions are implemented on w32.c.
900 When the file descriptor was produced by functions such as 'open',
901 the corresponding handle is obtained by calling _get_osfhandle. To
902 produce a file descriptor for a socket handle, which has no file
903 descriptor as far as Windows is concerned, the function
904 socket_to_fd opens the null device; the resulting file descriptor
905 will never be used directly in any I/O API, but serves as an index
906 into the fd_info[] array, where the socket handle is stored. The
907 SOCK_HANDLE macro retrieves the handle when given the file
908 descriptor.
910 The function sys_kill emulates the Posix 'kill' functionality to
911 terminate other processes. It does that by attaching to the
912 foreground window of the process and sending a Ctrl-C or Ctrl-BREAK
913 signal to the process; if that doesn't work, then it calls
914 TerminateProcess to forcibly terminate the process. Note that this
915 only terminates the immediate process whose PID was passed to
916 sys_kill; it doesn't terminate the child processes of that process.
917 This means, for example, that an Emacs subprocess run through a
918 shell might not be killed, because sys_kill will only terminate the
919 shell. (In practice, however, such problems are very rare.) */
921 /* Defined in <process.h> which conflicts with the local copy */
922 #define _P_NOWAIT 1
924 /* Child process management list. */
925 int child_proc_count = 0;
926 child_process child_procs[ MAX_CHILDREN ];
928 static DWORD WINAPI reader_thread (void *arg);
930 /* Find an unused process slot. */
931 child_process *
932 new_child (void)
934 child_process *cp;
935 DWORD id;
937 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
938 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess == NULL)
939 goto Initialize;
940 if (child_proc_count == MAX_CHILDREN)
942 int i = 0;
943 child_process *dead_cp = NULL;
945 DebPrint (("new_child: No vacant slots, looking for dead processes\n"));
946 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
947 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess)
949 DWORD status = 0;
951 if (!GetExitCodeProcess (cp->procinfo.hProcess, &status))
953 DebPrint (("new_child.GetExitCodeProcess: error %lu for PID %lu\n",
954 GetLastError (), cp->procinfo.dwProcessId));
955 status = STILL_ACTIVE;
957 if (status != STILL_ACTIVE
958 || WaitForSingleObject (cp->procinfo.hProcess, 0) == WAIT_OBJECT_0)
960 DebPrint (("new_child: Freeing slot of dead process %d, fd %d\n",
961 cp->procinfo.dwProcessId, cp->fd));
962 CloseHandle (cp->procinfo.hProcess);
963 cp->procinfo.hProcess = NULL;
964 CloseHandle (cp->procinfo.hThread);
965 cp->procinfo.hThread = NULL;
966 /* Free up to 2 dead slots at a time, so that if we
967 have a lot of them, they will eventually all be
968 freed when the tornado ends. */
969 if (i == 0)
970 dead_cp = cp;
971 else
972 break;
973 i++;
976 if (dead_cp)
978 cp = dead_cp;
979 goto Initialize;
982 if (child_proc_count == MAX_CHILDREN)
983 return NULL;
984 cp = &child_procs[child_proc_count++];
986 Initialize:
987 /* Last opportunity to avoid leaking handles before we forget them
988 for good. */
989 if (cp->procinfo.hProcess)
990 CloseHandle (cp->procinfo.hProcess);
991 if (cp->procinfo.hThread)
992 CloseHandle (cp->procinfo.hThread);
993 memset (cp, 0, sizeof (*cp));
994 cp->fd = -1;
995 cp->pid = -1;
996 cp->procinfo.hProcess = NULL;
997 cp->status = STATUS_READ_ERROR;
999 /* use manual reset event so that select() will function properly */
1000 cp->char_avail = CreateEvent (NULL, TRUE, FALSE, NULL);
1001 if (cp->char_avail)
1003 cp->char_consumed = CreateEvent (NULL, FALSE, FALSE, NULL);
1004 if (cp->char_consumed)
1006 /* The 0x00010000 flag is STACK_SIZE_PARAM_IS_A_RESERVATION.
1007 It means that the 64K stack we are requesting in the 2nd
1008 argument is how much memory should be reserved for the
1009 stack. If we don't use this flag, the memory requested
1010 by the 2nd argument is the amount actually _committed_,
1011 but Windows reserves 8MB of memory for each thread's
1012 stack. (The 8MB figure comes from the -stack
1013 command-line argument we pass to the linker when building
1014 Emacs, but that's because we need a large stack for
1015 Emacs's main thread.) Since we request 2GB of reserved
1016 memory at startup (see w32heap.c), which is close to the
1017 maximum memory available for a 32-bit process on Windows,
1018 the 8MB reservation for each thread causes failures in
1019 starting subprocesses, because we create a thread running
1020 reader_thread for each subprocess. As 8MB of stack is
1021 way too much for reader_thread, forcing Windows to
1022 reserve less wins the day. */
1023 cp->thrd = CreateThread (NULL, 64 * 1024, reader_thread, cp,
1024 0x00010000, &id);
1025 if (cp->thrd)
1026 return cp;
1029 delete_child (cp);
1030 return NULL;
1033 void
1034 delete_child (child_process *cp)
1036 int i;
1038 /* Should not be deleting a child that is still needed. */
1039 for (i = 0; i < MAXDESC; i++)
1040 if (fd_info[i].cp == cp)
1041 emacs_abort ();
1043 if (!CHILD_ACTIVE (cp) && cp->procinfo.hProcess == NULL)
1044 return;
1046 /* reap thread if necessary */
1047 if (cp->thrd)
1049 DWORD rc;
1051 if (GetExitCodeThread (cp->thrd, &rc) && rc == STILL_ACTIVE)
1053 /* let the thread exit cleanly if possible */
1054 cp->status = STATUS_READ_ERROR;
1055 SetEvent (cp->char_consumed);
1056 #if 0
1057 /* We used to forcibly terminate the thread here, but it
1058 is normally unnecessary, and in abnormal cases, the worst that
1059 will happen is we have an extra idle thread hanging around
1060 waiting for the zombie process. */
1061 if (WaitForSingleObject (cp->thrd, 1000) != WAIT_OBJECT_0)
1063 DebPrint (("delete_child.WaitForSingleObject (thread) failed "
1064 "with %lu for fd %ld\n", GetLastError (), cp->fd));
1065 TerminateThread (cp->thrd, 0);
1067 #endif
1069 CloseHandle (cp->thrd);
1070 cp->thrd = NULL;
1072 if (cp->char_avail)
1074 CloseHandle (cp->char_avail);
1075 cp->char_avail = NULL;
1077 if (cp->char_consumed)
1079 CloseHandle (cp->char_consumed);
1080 cp->char_consumed = NULL;
1083 /* update child_proc_count (highest numbered slot in use plus one) */
1084 if (cp == child_procs + child_proc_count - 1)
1086 for (i = child_proc_count-1; i >= 0; i--)
1087 if (CHILD_ACTIVE (&child_procs[i])
1088 || child_procs[i].procinfo.hProcess != NULL)
1090 child_proc_count = i + 1;
1091 break;
1094 if (i < 0)
1095 child_proc_count = 0;
1098 /* Find a child by pid. */
1099 static child_process *
1100 find_child_pid (DWORD pid)
1102 child_process *cp;
1104 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
1105 if ((CHILD_ACTIVE (cp) || cp->procinfo.hProcess != NULL)
1106 && pid == cp->pid)
1107 return cp;
1108 return NULL;
1111 void
1112 release_listen_threads (void)
1114 int i;
1116 for (i = child_proc_count - 1; i >= 0; i--)
1118 if (CHILD_ACTIVE (&child_procs[i])
1119 && (fd_info[child_procs[i].fd].flags & FILE_LISTEN))
1120 child_procs[i].status = STATUS_READ_ERROR;
1124 /* Thread proc for child process and socket reader threads. Each thread
1125 is normally blocked until woken by select() to check for input by
1126 reading one char. When the read completes, char_avail is signaled
1127 to wake up the select emulator and the thread blocks itself again. */
1128 static DWORD WINAPI
1129 reader_thread (void *arg)
1131 child_process *cp;
1133 /* Our identity */
1134 cp = (child_process *)arg;
1136 /* We have to wait for the go-ahead before we can start */
1137 if (cp == NULL
1138 || WaitForSingleObject (cp->char_consumed, INFINITE) != WAIT_OBJECT_0
1139 || cp->fd < 0)
1140 return 1;
1142 for (;;)
1144 int rc;
1146 if (cp->fd >= 0 && (fd_info[cp->fd].flags & FILE_CONNECT) != 0)
1147 rc = _sys_wait_connect (cp->fd);
1148 else if (cp->fd >= 0 && (fd_info[cp->fd].flags & FILE_LISTEN) != 0)
1149 rc = _sys_wait_accept (cp->fd);
1150 else
1151 rc = _sys_read_ahead (cp->fd);
1153 /* Don't bother waiting for the event if we already have been
1154 told to exit by delete_child. */
1155 if (cp->status == STATUS_READ_ERROR || !cp->char_avail)
1156 break;
1158 /* The name char_avail is a misnomer - it really just means the
1159 read-ahead has completed, whether successfully or not. */
1160 if (!SetEvent (cp->char_avail))
1162 DebPrint (("reader_thread.SetEvent(0x%x) failed with %lu for fd %ld (PID %d)\n",
1163 (DWORD_PTR)cp->char_avail, GetLastError (),
1164 cp->fd, cp->pid));
1165 return 1;
1168 if (rc == STATUS_READ_ERROR || rc == STATUS_CONNECT_FAILED)
1169 return 2;
1171 /* If the read died, the child has died so let the thread die */
1172 if (rc == STATUS_READ_FAILED)
1173 break;
1175 /* Don't bother waiting for the acknowledge if we already have
1176 been told to exit by delete_child. */
1177 if (cp->status == STATUS_READ_ERROR || !cp->char_consumed)
1178 break;
1180 /* Wait until our input is acknowledged before reading again */
1181 if (WaitForSingleObject (cp->char_consumed, INFINITE) != WAIT_OBJECT_0)
1183 DebPrint (("reader_thread.WaitForSingleObject failed with "
1184 "%lu for fd %ld\n", GetLastError (), cp->fd));
1185 break;
1187 /* delete_child sets status to STATUS_READ_ERROR when it wants
1188 us to exit. */
1189 if (cp->status == STATUS_READ_ERROR)
1190 break;
1192 return 0;
1195 /* To avoid Emacs changing directory, we just record here the
1196 directory the new process should start in. This is set just before
1197 calling sys_spawnve, and is not generally valid at any other time.
1198 Note that this directory's name is UTF-8 encoded. */
1199 static char * process_dir;
1201 static BOOL
1202 create_child (char *exe, char *cmdline, char *env, int is_gui_app,
1203 pid_t * pPid, child_process *cp)
1205 STARTUPINFO start;
1206 SECURITY_ATTRIBUTES sec_attrs;
1207 #if 0
1208 SECURITY_DESCRIPTOR sec_desc;
1209 #endif
1210 DWORD flags;
1211 char dir[ MAX_PATH ];
1212 char *p;
1213 const char *ext;
1215 if (cp == NULL) emacs_abort ();
1217 memset (&start, 0, sizeof (start));
1218 start.cb = sizeof (start);
1220 #ifdef HAVE_NTGUI
1221 if (NILP (Vw32_start_process_show_window) && !is_gui_app)
1222 start.dwFlags = STARTF_USESTDHANDLES | STARTF_USESHOWWINDOW;
1223 else
1224 start.dwFlags = STARTF_USESTDHANDLES;
1225 start.wShowWindow = SW_HIDE;
1227 start.hStdInput = GetStdHandle (STD_INPUT_HANDLE);
1228 start.hStdOutput = GetStdHandle (STD_OUTPUT_HANDLE);
1229 start.hStdError = GetStdHandle (STD_ERROR_HANDLE);
1230 #endif /* HAVE_NTGUI */
1232 #if 0
1233 /* Explicitly specify no security */
1234 if (!InitializeSecurityDescriptor (&sec_desc, SECURITY_DESCRIPTOR_REVISION))
1235 goto EH_Fail;
1236 if (!SetSecurityDescriptorDacl (&sec_desc, TRUE, NULL, FALSE))
1237 goto EH_Fail;
1238 #endif
1239 sec_attrs.nLength = sizeof (sec_attrs);
1240 sec_attrs.lpSecurityDescriptor = NULL /* &sec_desc */;
1241 sec_attrs.bInheritHandle = FALSE;
1243 filename_to_ansi (process_dir, dir);
1244 /* Can't use unixtodos_filename here, since that needs its file name
1245 argument encoded in UTF-8. OTOH, process_dir, which _is_ in
1246 UTF-8, points, to the directory computed by our caller, and we
1247 don't want to modify that, either. */
1248 for (p = dir; *p; p = CharNextA (p))
1249 if (*p == '/')
1250 *p = '\\';
1252 /* CreateProcess handles batch files as exe specially. This special
1253 handling fails when both the batch file and arguments are quoted.
1254 We pass NULL as exe to avoid the special handling. */
1255 if (exe && cmdline[0] == '"' &&
1256 (ext = strrchr (exe, '.')) &&
1257 (xstrcasecmp (ext, ".bat") == 0
1258 || xstrcasecmp (ext, ".cmd") == 0))
1259 exe = NULL;
1261 flags = (!NILP (Vw32_start_process_share_console)
1262 ? CREATE_NEW_PROCESS_GROUP
1263 : CREATE_NEW_CONSOLE);
1264 if (NILP (Vw32_start_process_inherit_error_mode))
1265 flags |= CREATE_DEFAULT_ERROR_MODE;
1266 if (!CreateProcessA (exe, cmdline, &sec_attrs, NULL, TRUE,
1267 flags, env, dir, &start, &cp->procinfo))
1268 goto EH_Fail;
1270 cp->pid = (int) cp->procinfo.dwProcessId;
1272 /* Hack for Windows 95, which assigns large (ie negative) pids */
1273 if (cp->pid < 0)
1274 cp->pid = -cp->pid;
1276 *pPid = cp->pid;
1278 return TRUE;
1280 EH_Fail:
1281 DebPrint (("create_child.CreateProcess failed: %ld\n", GetLastError ()););
1282 return FALSE;
1285 /* create_child doesn't know what emacs's file handle will be for waiting
1286 on output from the child, so we need to make this additional call
1287 to register the handle with the process
1288 This way the select emulator knows how to match file handles with
1289 entries in child_procs. */
1290 void
1291 register_child (pid_t pid, int fd)
1293 child_process *cp;
1295 cp = find_child_pid ((DWORD)pid);
1296 if (cp == NULL)
1298 DebPrint (("register_child unable to find pid %lu\n", pid));
1299 return;
1302 #ifdef FULL_DEBUG
1303 DebPrint (("register_child registered fd %d with pid %lu\n", fd, pid));
1304 #endif
1306 cp->fd = fd;
1308 /* thread is initially blocked until select is called; set status so
1309 that select will release thread */
1310 cp->status = STATUS_READ_ACKNOWLEDGED;
1312 /* attach child_process to fd_info */
1313 if (fd_info[fd].cp != NULL)
1315 DebPrint (("register_child: fd_info[%d] apparently in use!\n", fd));
1316 emacs_abort ();
1319 fd_info[fd].cp = cp;
1322 /* Called from waitpid when a process exits. */
1323 static void
1324 reap_subprocess (child_process *cp)
1326 if (cp->procinfo.hProcess)
1328 /* Reap the process */
1329 #ifdef FULL_DEBUG
1330 /* Process should have already died before we are called. */
1331 if (WaitForSingleObject (cp->procinfo.hProcess, 0) != WAIT_OBJECT_0)
1332 DebPrint (("reap_subprocess: child for fd %d has not died yet!", cp->fd));
1333 #endif
1334 CloseHandle (cp->procinfo.hProcess);
1335 cp->procinfo.hProcess = NULL;
1336 CloseHandle (cp->procinfo.hThread);
1337 cp->procinfo.hThread = NULL;
1340 /* If cp->fd was not closed yet, we might be still reading the
1341 process output, so don't free its resources just yet. The call
1342 to delete_child on behalf of this subprocess will be made by
1343 sys_read when the subprocess output is fully read. */
1344 if (cp->fd < 0)
1345 delete_child (cp);
1348 /* Wait for a child process specified by PID, or for any of our
1349 existing child processes (if PID is nonpositive) to die. When it
1350 does, close its handle. Return the pid of the process that died
1351 and fill in STATUS if non-NULL. */
1353 pid_t
1354 waitpid (pid_t pid, int *status, int options)
1356 DWORD active, retval;
1357 int nh;
1358 child_process *cp, *cps[MAX_CHILDREN];
1359 HANDLE wait_hnd[MAX_CHILDREN];
1360 DWORD timeout_ms;
1361 int dont_wait = (options & WNOHANG) != 0;
1363 nh = 0;
1364 /* According to Posix:
1366 PID = -1 means status is requested for any child process.
1368 PID > 0 means status is requested for a single child process
1369 whose pid is PID.
1371 PID = 0 means status is requested for any child process whose
1372 process group ID is equal to that of the calling process. But
1373 since Windows has only a limited support for process groups (only
1374 for console processes and only for the purposes of passing
1375 Ctrl-BREAK signal to them), and since we have no documented way
1376 of determining whether a given process belongs to our group, we
1377 treat 0 as -1.
1379 PID < -1 means status is requested for any child process whose
1380 process group ID is equal to the absolute value of PID. Again,
1381 since we don't support process groups, we treat that as -1. */
1382 if (pid > 0)
1384 int our_child = 0;
1386 /* We are requested to wait for a specific child. */
1387 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
1389 /* Some child_procs might be sockets; ignore them. Also
1390 ignore subprocesses whose output is not yet completely
1391 read. */
1392 if (CHILD_ACTIVE (cp)
1393 && cp->procinfo.hProcess
1394 && cp->pid == pid)
1396 our_child = 1;
1397 break;
1400 if (our_child)
1402 if (cp->fd < 0 || (fd_info[cp->fd].flags & FILE_AT_EOF) != 0)
1404 wait_hnd[nh] = cp->procinfo.hProcess;
1405 cps[nh] = cp;
1406 nh++;
1408 else if (dont_wait)
1410 /* PID specifies our subprocess, but its status is not
1411 yet available. */
1412 return 0;
1415 if (nh == 0)
1417 /* No such child process, or nothing to wait for, so fail. */
1418 errno = ECHILD;
1419 return -1;
1422 else
1424 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
1426 if (CHILD_ACTIVE (cp)
1427 && cp->procinfo.hProcess
1428 && (cp->fd < 0 || (fd_info[cp->fd].flags & FILE_AT_EOF) != 0))
1430 wait_hnd[nh] = cp->procinfo.hProcess;
1431 cps[nh] = cp;
1432 nh++;
1435 if (nh == 0)
1437 /* Nothing to wait on, so fail. */
1438 errno = ECHILD;
1439 return -1;
1443 if (dont_wait)
1444 timeout_ms = 0;
1445 else
1446 timeout_ms = 1000; /* check for quit about once a second. */
1450 QUIT;
1451 active = WaitForMultipleObjects (nh, wait_hnd, FALSE, timeout_ms);
1452 } while (active == WAIT_TIMEOUT && !dont_wait);
1454 if (active == WAIT_FAILED)
1456 errno = EBADF;
1457 return -1;
1459 else if (active == WAIT_TIMEOUT && dont_wait)
1461 /* PID specifies our subprocess, but it didn't exit yet, so its
1462 status is not yet available. */
1463 #ifdef FULL_DEBUG
1464 DebPrint (("Wait: PID %d not reap yet\n", cp->pid));
1465 #endif
1466 return 0;
1468 else if (active >= WAIT_OBJECT_0
1469 && active < WAIT_OBJECT_0+MAXIMUM_WAIT_OBJECTS)
1471 active -= WAIT_OBJECT_0;
1473 else if (active >= WAIT_ABANDONED_0
1474 && active < WAIT_ABANDONED_0+MAXIMUM_WAIT_OBJECTS)
1476 active -= WAIT_ABANDONED_0;
1478 else
1479 emacs_abort ();
1481 if (!GetExitCodeProcess (wait_hnd[active], &retval))
1483 DebPrint (("Wait.GetExitCodeProcess failed with %lu\n",
1484 GetLastError ()));
1485 retval = 1;
1487 if (retval == STILL_ACTIVE)
1489 /* Should never happen. */
1490 DebPrint (("Wait.WaitForMultipleObjects returned an active process\n"));
1491 if (pid > 0 && dont_wait)
1492 return 0;
1493 errno = EINVAL;
1494 return -1;
1497 /* Massage the exit code from the process to match the format expected
1498 by the WIFSTOPPED et al macros in syswait.h. Only WIFSIGNALED and
1499 WIFEXITED are supported; WIFSTOPPED doesn't make sense under NT. */
1501 if (retval == STATUS_CONTROL_C_EXIT)
1502 retval = SIGINT;
1503 else
1504 retval <<= 8;
1506 if (pid > 0 && active != 0)
1507 emacs_abort ();
1508 cp = cps[active];
1509 pid = cp->pid;
1510 #ifdef FULL_DEBUG
1511 DebPrint (("Wait signaled with process pid %d\n", cp->pid));
1512 #endif
1514 if (status)
1515 *status = retval;
1516 reap_subprocess (cp);
1518 return pid;
1521 /* Old versions of w32api headers don't have separate 32-bit and
1522 64-bit defines, but the one they have matches the 32-bit variety. */
1523 #ifndef IMAGE_NT_OPTIONAL_HDR32_MAGIC
1524 # define IMAGE_NT_OPTIONAL_HDR32_MAGIC IMAGE_NT_OPTIONAL_HDR_MAGIC
1525 # define IMAGE_OPTIONAL_HEADER32 IMAGE_OPTIONAL_HEADER
1526 #endif
1528 /* Implementation note: This function works with file names encoded in
1529 the current ANSI codepage. */
1530 static void
1531 w32_executable_type (char * filename,
1532 int * is_dos_app,
1533 int * is_cygnus_app,
1534 int * is_gui_app)
1536 file_data executable;
1537 char * p;
1539 /* Default values in case we can't tell for sure. */
1540 *is_dos_app = FALSE;
1541 *is_cygnus_app = FALSE;
1542 *is_gui_app = FALSE;
1544 if (!open_input_file (&executable, filename))
1545 return;
1547 p = strrchr (filename, '.');
1549 /* We can only identify DOS .com programs from the extension. */
1550 if (p && xstrcasecmp (p, ".com") == 0)
1551 *is_dos_app = TRUE;
1552 else if (p && (xstrcasecmp (p, ".bat") == 0
1553 || xstrcasecmp (p, ".cmd") == 0))
1555 /* A DOS shell script - it appears that CreateProcess is happy to
1556 accept this (somewhat surprisingly); presumably it looks at
1557 COMSPEC to determine what executable to actually invoke.
1558 Therefore, we have to do the same here as well. */
1559 /* Actually, I think it uses the program association for that
1560 extension, which is defined in the registry. */
1561 p = egetenv ("COMSPEC");
1562 if (p)
1563 w32_executable_type (p, is_dos_app, is_cygnus_app, is_gui_app);
1565 else
1567 /* Look for DOS .exe signature - if found, we must also check that
1568 it isn't really a 16- or 32-bit Windows exe, since both formats
1569 start with a DOS program stub. Note that 16-bit Windows
1570 executables use the OS/2 1.x format. */
1572 IMAGE_DOS_HEADER * dos_header;
1573 IMAGE_NT_HEADERS * nt_header;
1575 dos_header = (PIMAGE_DOS_HEADER) executable.file_base;
1576 if (dos_header->e_magic != IMAGE_DOS_SIGNATURE)
1577 goto unwind;
1579 nt_header = (PIMAGE_NT_HEADERS) ((unsigned char *) dos_header + dos_header->e_lfanew);
1581 if ((char *) nt_header > (char *) dos_header + executable.size)
1583 /* Some dos headers (pkunzip) have bogus e_lfanew fields. */
1584 *is_dos_app = TRUE;
1586 else if (nt_header->Signature != IMAGE_NT_SIGNATURE
1587 && LOWORD (nt_header->Signature) != IMAGE_OS2_SIGNATURE)
1589 *is_dos_app = TRUE;
1591 else if (nt_header->Signature == IMAGE_NT_SIGNATURE)
1593 IMAGE_DATA_DIRECTORY *data_dir = NULL;
1594 if (nt_header->OptionalHeader.Magic == IMAGE_NT_OPTIONAL_HDR32_MAGIC)
1596 /* Ensure we are using the 32 bit structure. */
1597 IMAGE_OPTIONAL_HEADER32 *opt
1598 = (IMAGE_OPTIONAL_HEADER32*) &(nt_header->OptionalHeader);
1599 data_dir = opt->DataDirectory;
1600 *is_gui_app = (opt->Subsystem == IMAGE_SUBSYSTEM_WINDOWS_GUI);
1602 /* MingW 3.12 has the required 64 bit structs, but in case older
1603 versions don't, only check 64 bit exes if we know how. */
1604 #ifdef IMAGE_NT_OPTIONAL_HDR64_MAGIC
1605 else if (nt_header->OptionalHeader.Magic
1606 == IMAGE_NT_OPTIONAL_HDR64_MAGIC)
1608 IMAGE_OPTIONAL_HEADER64 *opt
1609 = (IMAGE_OPTIONAL_HEADER64*) &(nt_header->OptionalHeader);
1610 data_dir = opt->DataDirectory;
1611 *is_gui_app = (opt->Subsystem == IMAGE_SUBSYSTEM_WINDOWS_GUI);
1613 #endif
1614 if (data_dir)
1616 /* Look for Cygwin DLL in the DLL import list. */
1617 IMAGE_DATA_DIRECTORY import_dir =
1618 data_dir[IMAGE_DIRECTORY_ENTRY_IMPORT];
1619 IMAGE_IMPORT_DESCRIPTOR * imports =
1620 RVA_TO_PTR (import_dir.VirtualAddress,
1621 rva_to_section (import_dir.VirtualAddress,
1622 nt_header),
1623 executable);
1625 for ( ; imports->Name; imports++)
1627 IMAGE_SECTION_HEADER * section =
1628 rva_to_section (imports->Name, nt_header);
1629 char * dllname = RVA_TO_PTR (imports->Name, section,
1630 executable);
1632 /* The exact name of the Cygwin DLL has changed with
1633 various releases, but hopefully this will be
1634 reasonably future-proof. */
1635 if (strncmp (dllname, "cygwin", 6) == 0)
1637 *is_cygnus_app = TRUE;
1638 break;
1645 unwind:
1646 close_file_data (&executable);
1649 static int
1650 compare_env (const void *strp1, const void *strp2)
1652 const char *str1 = *(const char **)strp1, *str2 = *(const char **)strp2;
1654 while (*str1 && *str2 && *str1 != '=' && *str2 != '=')
1656 /* Sort order in command.com/cmd.exe is based on uppercasing
1657 names, so do the same here. */
1658 if (toupper (*str1) > toupper (*str2))
1659 return 1;
1660 else if (toupper (*str1) < toupper (*str2))
1661 return -1;
1662 str1++, str2++;
1665 if (*str1 == '=' && *str2 == '=')
1666 return 0;
1667 else if (*str1 == '=')
1668 return -1;
1669 else
1670 return 1;
1673 static void
1674 merge_and_sort_env (char **envp1, char **envp2, char **new_envp)
1676 char **optr, **nptr;
1677 int num;
1679 nptr = new_envp;
1680 optr = envp1;
1681 while (*optr)
1682 *nptr++ = *optr++;
1683 num = optr - envp1;
1685 optr = envp2;
1686 while (*optr)
1687 *nptr++ = *optr++;
1688 num += optr - envp2;
1690 qsort (new_envp, num, sizeof (char *), compare_env);
1692 *nptr = NULL;
1695 /* When a new child process is created we need to register it in our list,
1696 so intercept spawn requests. */
1698 sys_spawnve (int mode, char *cmdname, char **argv, char **envp)
1700 Lisp_Object program, full;
1701 char *cmdline, *env, *parg, **targ;
1702 int arglen, numenv;
1703 pid_t pid;
1704 child_process *cp;
1705 int is_dos_app, is_cygnus_app, is_gui_app;
1706 int do_quoting = 0;
1707 /* We pass our process ID to our children by setting up an environment
1708 variable in their environment. */
1709 char ppid_env_var_buffer[64];
1710 char *extra_env[] = {ppid_env_var_buffer, NULL};
1711 /* These are the characters that cause an argument to need quoting.
1712 Arguments with whitespace characters need quoting to prevent the
1713 argument being split into two or more. Arguments with wildcards
1714 are also quoted, for consistency with posix platforms, where wildcards
1715 are not expanded if we run the program directly without a shell.
1716 Some extra whitespace characters need quoting in Cygwin programs,
1717 so this list is conditionally modified below. */
1718 char *sepchars = " \t*?";
1719 /* This is for native w32 apps; modified below for Cygwin apps. */
1720 char escape_char = '\\';
1721 char cmdname_a[MAX_PATH];
1723 /* We don't care about the other modes */
1724 if (mode != _P_NOWAIT)
1726 errno = EINVAL;
1727 return -1;
1730 /* Handle executable names without an executable suffix. The caller
1731 already searched exec-path and verified the file is executable,
1732 but start-process doesn't do that for file names that are already
1733 absolute. So we double-check this here, just in case. */
1734 if (faccessat (AT_FDCWD, cmdname, X_OK, AT_EACCESS) != 0)
1736 struct gcpro gcpro1;
1738 program = build_string (cmdname);
1739 full = Qnil;
1740 GCPRO1 (program);
1741 openp (Vexec_path, program, Vexec_suffixes, &full, make_number (X_OK), 0);
1742 UNGCPRO;
1743 if (NILP (full))
1745 errno = EINVAL;
1746 return -1;
1748 program = ENCODE_FILE (full);
1749 cmdname = SDATA (program);
1751 else
1753 char *p = alloca (strlen (cmdname) + 1);
1755 /* Don't change the command name we were passed by our caller
1756 (unixtodos_filename below will destructively mirror forward
1757 slashes). */
1758 cmdname = strcpy (p, cmdname);
1761 /* make sure argv[0] and cmdname are both in DOS format */
1762 unixtodos_filename (cmdname);
1763 /* argv[0] was encoded by caller using ENCODE_FILE, so it is in
1764 UTF-8. All the other arguments are encoded by ENCODE_SYSTEM or
1765 some such, and are in some ANSI codepage. We need to have
1766 argv[0] encoded in ANSI codepage. */
1767 filename_to_ansi (cmdname, cmdname_a);
1768 /* We explicitly require that the command's file name be encodable
1769 in the current ANSI codepage, because we will be invoking it via
1770 the ANSI APIs. */
1771 if (_mbspbrk (cmdname_a, "?"))
1773 errno = ENOENT;
1774 return -1;
1776 /* From here on, CMDNAME is an ANSI-encoded string. */
1777 cmdname = cmdname_a;
1778 argv[0] = cmdname;
1780 /* Determine whether program is a 16-bit DOS executable, or a 32-bit Windows
1781 executable that is implicitly linked to the Cygnus dll (implying it
1782 was compiled with the Cygnus GNU toolchain and hence relies on
1783 cygwin.dll to parse the command line - we use this to decide how to
1784 escape quote chars in command line args that must be quoted).
1786 Also determine whether it is a GUI app, so that we don't hide its
1787 initial window unless specifically requested. */
1788 w32_executable_type (cmdname, &is_dos_app, &is_cygnus_app, &is_gui_app);
1790 /* On Windows 95, if cmdname is a DOS app, we invoke a helper
1791 application to start it by specifying the helper app as cmdname,
1792 while leaving the real app name as argv[0]. */
1793 if (is_dos_app)
1795 char *p;
1797 cmdname = alloca (MAX_PATH);
1798 if (egetenv ("CMDPROXY"))
1799 strcpy (cmdname, egetenv ("CMDPROXY"));
1800 else
1801 strcpy (lispstpcpy (cmdname, Vinvocation_directory), "cmdproxy.exe");
1803 /* Can't use unixtodos_filename here, since that needs its file
1804 name argument encoded in UTF-8. */
1805 for (p = cmdname; *p; p = CharNextA (p))
1806 if (*p == '/')
1807 *p = '\\';
1810 /* we have to do some conjuring here to put argv and envp into the
1811 form CreateProcess wants... argv needs to be a space separated/null
1812 terminated list of parameters, and envp is a null
1813 separated/double-null terminated list of parameters.
1815 Additionally, zero-length args and args containing whitespace or
1816 quote chars need to be wrapped in double quotes - for this to work,
1817 embedded quotes need to be escaped as well. The aim is to ensure
1818 the child process reconstructs the argv array we start with
1819 exactly, so we treat quotes at the beginning and end of arguments
1820 as embedded quotes.
1822 The w32 GNU-based library from Cygnus doubles quotes to escape
1823 them, while MSVC uses backslash for escaping. (Actually the MSVC
1824 startup code does attempt to recognize doubled quotes and accept
1825 them, but gets it wrong and ends up requiring three quotes to get a
1826 single embedded quote!) So by default we decide whether to use
1827 quote or backslash as the escape character based on whether the
1828 binary is apparently a Cygnus compiled app.
1830 Note that using backslash to escape embedded quotes requires
1831 additional special handling if an embedded quote is already
1832 preceded by backslash, or if an arg requiring quoting ends with
1833 backslash. In such cases, the run of escape characters needs to be
1834 doubled. For consistency, we apply this special handling as long
1835 as the escape character is not quote.
1837 Since we have no idea how large argv and envp are likely to be we
1838 figure out list lengths on the fly and allocate them. */
1840 if (!NILP (Vw32_quote_process_args))
1842 do_quoting = 1;
1843 /* Override escape char by binding w32-quote-process-args to
1844 desired character, or use t for auto-selection. */
1845 if (INTEGERP (Vw32_quote_process_args))
1846 escape_char = XINT (Vw32_quote_process_args);
1847 else
1848 escape_char = is_cygnus_app ? '"' : '\\';
1851 /* Cygwin apps needs quoting a bit more often. */
1852 if (escape_char == '"')
1853 sepchars = "\r\n\t\f '";
1855 /* do argv... */
1856 arglen = 0;
1857 targ = argv;
1858 while (*targ)
1860 char * p = *targ;
1861 int need_quotes = 0;
1862 int escape_char_run = 0;
1864 if (*p == 0)
1865 need_quotes = 1;
1866 for ( ; *p; p++)
1868 if (escape_char == '"' && *p == '\\')
1869 /* If it's a Cygwin app, \ needs to be escaped. */
1870 arglen++;
1871 else if (*p == '"')
1873 /* allow for embedded quotes to be escaped */
1874 arglen++;
1875 need_quotes = 1;
1876 /* handle the case where the embedded quote is already escaped */
1877 if (escape_char_run > 0)
1879 /* To preserve the arg exactly, we need to double the
1880 preceding escape characters (plus adding one to
1881 escape the quote character itself). */
1882 arglen += escape_char_run;
1885 else if (strchr (sepchars, *p) != NULL)
1887 need_quotes = 1;
1890 if (*p == escape_char && escape_char != '"')
1891 escape_char_run++;
1892 else
1893 escape_char_run = 0;
1895 if (need_quotes)
1897 arglen += 2;
1898 /* handle the case where the arg ends with an escape char - we
1899 must not let the enclosing quote be escaped. */
1900 if (escape_char_run > 0)
1901 arglen += escape_char_run;
1903 arglen += strlen (*targ++) + 1;
1905 cmdline = alloca (arglen);
1906 targ = argv;
1907 parg = cmdline;
1908 while (*targ)
1910 char * p = *targ;
1911 int need_quotes = 0;
1913 if (*p == 0)
1914 need_quotes = 1;
1916 if (do_quoting)
1918 for ( ; *p; p++)
1919 if ((strchr (sepchars, *p) != NULL) || *p == '"')
1920 need_quotes = 1;
1922 if (need_quotes)
1924 int escape_char_run = 0;
1925 /* char * first; */
1926 /* char * last; */
1928 p = *targ;
1929 /* first = p; */
1930 /* last = p + strlen (p) - 1; */
1931 *parg++ = '"';
1932 #if 0
1933 /* This version does not escape quotes if they occur at the
1934 beginning or end of the arg - this could lead to incorrect
1935 behavior when the arg itself represents a command line
1936 containing quoted args. I believe this was originally done
1937 as a hack to make some things work, before
1938 `w32-quote-process-args' was added. */
1939 while (*p)
1941 if (*p == '"' && p > first && p < last)
1942 *parg++ = escape_char; /* escape embedded quotes */
1943 *parg++ = *p++;
1945 #else
1946 for ( ; *p; p++)
1948 if (*p == '"')
1950 /* double preceding escape chars if any */
1951 while (escape_char_run > 0)
1953 *parg++ = escape_char;
1954 escape_char_run--;
1956 /* escape all quote chars, even at beginning or end */
1957 *parg++ = escape_char;
1959 else if (escape_char == '"' && *p == '\\')
1960 *parg++ = '\\';
1961 *parg++ = *p;
1963 if (*p == escape_char && escape_char != '"')
1964 escape_char_run++;
1965 else
1966 escape_char_run = 0;
1968 /* double escape chars before enclosing quote */
1969 while (escape_char_run > 0)
1971 *parg++ = escape_char;
1972 escape_char_run--;
1974 #endif
1975 *parg++ = '"';
1977 else
1979 strcpy (parg, *targ);
1980 parg += strlen (*targ);
1982 *parg++ = ' ';
1983 targ++;
1985 *--parg = '\0';
1987 /* and envp... */
1988 arglen = 1;
1989 targ = envp;
1990 numenv = 1; /* for end null */
1991 while (*targ)
1993 arglen += strlen (*targ++) + 1;
1994 numenv++;
1996 /* extra env vars... */
1997 sprintf (ppid_env_var_buffer, "EM_PARENT_PROCESS_ID=%lu",
1998 GetCurrentProcessId ());
1999 arglen += strlen (ppid_env_var_buffer) + 1;
2000 numenv++;
2002 /* merge env passed in and extra env into one, and sort it. */
2003 targ = (char **) alloca (numenv * sizeof (char *));
2004 merge_and_sort_env (envp, extra_env, targ);
2006 /* concatenate env entries. */
2007 env = alloca (arglen);
2008 parg = env;
2009 while (*targ)
2011 strcpy (parg, *targ);
2012 parg += strlen (*targ++);
2013 *parg++ = '\0';
2015 *parg++ = '\0';
2016 *parg = '\0';
2018 cp = new_child ();
2019 if (cp == NULL)
2021 errno = EAGAIN;
2022 return -1;
2025 /* Now create the process. */
2026 if (!create_child (cmdname, cmdline, env, is_gui_app, &pid, cp))
2028 delete_child (cp);
2029 errno = ENOEXEC;
2030 return -1;
2033 return pid;
2036 /* Emulate the select call
2037 Wait for available input on any of the given rfds, or timeout if
2038 a timeout is given and no input is detected
2039 wfds and efds are not supported and must be NULL.
2041 For simplicity, we detect the death of child processes here and
2042 synchronously call the SIGCHLD handler. Since it is possible for
2043 children to be created without a corresponding pipe handle from which
2044 to read output, we wait separately on the process handles as well as
2045 the char_avail events for each process pipe. We only call
2046 wait/reap_process when the process actually terminates.
2048 To reduce the number of places in which Emacs can be hung such that
2049 C-g is not able to interrupt it, we always wait on interrupt_handle
2050 (which is signaled by the input thread when C-g is detected). If we
2051 detect that we were woken up by C-g, we return -1 with errno set to
2052 EINTR as on Unix. */
2054 /* From w32console.c */
2055 extern HANDLE keyboard_handle;
2057 /* From w32xfns.c */
2058 extern HANDLE interrupt_handle;
2060 /* From process.c */
2061 extern int proc_buffered_char[];
2064 sys_select (int nfds, SELECT_TYPE *rfds, SELECT_TYPE *wfds, SELECT_TYPE *efds,
2065 struct timespec *timeout, void *ignored)
2067 SELECT_TYPE orfds, owfds;
2068 DWORD timeout_ms, start_time;
2069 int i, nh, nc, nr;
2070 DWORD active;
2071 child_process *cp, *cps[MAX_CHILDREN];
2072 HANDLE wait_hnd[MAXDESC + MAX_CHILDREN];
2073 int fdindex[MAXDESC]; /* mapping from wait handles back to descriptors */
2075 timeout_ms =
2076 timeout ? (timeout->tv_sec * 1000 + timeout->tv_nsec / 1000000) : INFINITE;
2078 /* If the descriptor sets are NULL but timeout isn't, then just Sleep. */
2079 if (rfds == NULL && wfds == NULL && efds == NULL && timeout != NULL)
2081 Sleep (timeout_ms);
2082 return 0;
2085 /* Otherwise, we only handle rfds and wfds, so fail otherwise. */
2086 if ((rfds == NULL && wfds == NULL) || efds != NULL)
2088 errno = EINVAL;
2089 return -1;
2092 if (rfds)
2094 orfds = *rfds;
2095 FD_ZERO (rfds);
2097 else
2098 FD_ZERO (&orfds);
2099 if (wfds)
2101 owfds = *wfds;
2102 FD_ZERO (wfds);
2104 else
2105 FD_ZERO (&owfds);
2106 nr = 0;
2108 /* If interrupt_handle is available and valid, always wait on it, to
2109 detect C-g (quit). */
2110 nh = 0;
2111 if (interrupt_handle && interrupt_handle != INVALID_HANDLE_VALUE)
2113 wait_hnd[0] = interrupt_handle;
2114 fdindex[0] = -1;
2115 nh++;
2118 /* Build a list of pipe handles to wait on. */
2119 for (i = 0; i < nfds; i++)
2120 if (FD_ISSET (i, &orfds) || FD_ISSET (i, &owfds))
2122 if (i == 0)
2124 if (keyboard_handle)
2126 /* Handle stdin specially */
2127 wait_hnd[nh] = keyboard_handle;
2128 fdindex[nh] = i;
2129 nh++;
2132 /* Check for any emacs-generated input in the queue since
2133 it won't be detected in the wait */
2134 if (rfds && detect_input_pending ())
2136 FD_SET (i, rfds);
2137 return 1;
2139 else if (noninteractive)
2141 if (handle_file_notifications (NULL))
2142 return 1;
2145 else
2147 /* Child process and socket/comm port input. */
2148 cp = fd_info[i].cp;
2149 if (FD_ISSET (i, &owfds)
2150 && cp
2151 && (fd_info[i].flags && FILE_CONNECT) == 0)
2153 DebPrint (("sys_select: fd %d is in wfds, but FILE_CONNECT is reset!\n", i));
2154 cp = NULL;
2156 if (cp)
2158 int current_status = cp->status;
2160 if (current_status == STATUS_READ_ACKNOWLEDGED)
2162 /* Tell reader thread which file handle to use. */
2163 cp->fd = i;
2164 /* Zero out the error code. */
2165 cp->errcode = 0;
2166 /* Wake up the reader thread for this process */
2167 cp->status = STATUS_READ_READY;
2168 if (!SetEvent (cp->char_consumed))
2169 DebPrint (("sys_select.SetEvent failed with "
2170 "%lu for fd %ld\n", GetLastError (), i));
2173 #ifdef CHECK_INTERLOCK
2174 /* slightly crude cross-checking of interlock between threads */
2176 current_status = cp->status;
2177 if (WaitForSingleObject (cp->char_avail, 0) == WAIT_OBJECT_0)
2179 /* char_avail has been signaled, so status (which may
2180 have changed) should indicate read has completed
2181 but has not been acknowledged. */
2182 current_status = cp->status;
2183 if (current_status != STATUS_READ_SUCCEEDED
2184 && current_status != STATUS_READ_FAILED)
2185 DebPrint (("char_avail set, but read not completed: status %d\n",
2186 current_status));
2188 else
2190 /* char_avail has not been signaled, so status should
2191 indicate that read is in progress; small possibility
2192 that read has completed but event wasn't yet signaled
2193 when we tested it (because a context switch occurred
2194 or if running on separate CPUs). */
2195 if (current_status != STATUS_READ_READY
2196 && current_status != STATUS_READ_IN_PROGRESS
2197 && current_status != STATUS_READ_SUCCEEDED
2198 && current_status != STATUS_READ_FAILED)
2199 DebPrint (("char_avail reset, but read status is bad: %d\n",
2200 current_status));
2202 #endif
2203 wait_hnd[nh] = cp->char_avail;
2204 fdindex[nh] = i;
2205 if (!wait_hnd[nh]) emacs_abort ();
2206 nh++;
2207 #ifdef FULL_DEBUG
2208 DebPrint (("select waiting on child %d fd %d\n",
2209 cp-child_procs, i));
2210 #endif
2212 else
2214 /* Unable to find something to wait on for this fd, skip */
2216 /* Note that this is not a fatal error, and can in fact
2217 happen in unusual circumstances. Specifically, if
2218 sys_spawnve fails, eg. because the program doesn't
2219 exist, and debug-on-error is t so Fsignal invokes a
2220 nested input loop, then the process output pipe is
2221 still included in input_wait_mask with no child_proc
2222 associated with it. (It is removed when the debugger
2223 exits the nested input loop and the error is thrown.) */
2225 DebPrint (("sys_select: fd %ld is invalid! ignoring\n", i));
2230 count_children:
2231 /* Add handles of child processes. */
2232 nc = 0;
2233 for (cp = child_procs + (child_proc_count-1); cp >= child_procs; cp--)
2234 /* Some child_procs might be sockets; ignore them. Also some
2235 children may have died already, but we haven't finished reading
2236 the process output; ignore them too. */
2237 if ((CHILD_ACTIVE (cp) && cp->procinfo.hProcess)
2238 && (cp->fd < 0
2239 || (fd_info[cp->fd].flags & FILE_SEND_SIGCHLD) == 0
2240 || (fd_info[cp->fd].flags & FILE_AT_EOF) != 0)
2243 wait_hnd[nh + nc] = cp->procinfo.hProcess;
2244 cps[nc] = cp;
2245 nc++;
2248 /* Nothing to look for, so we didn't find anything */
2249 if (nh + nc == 0)
2251 if (timeout)
2252 Sleep (timeout_ms);
2253 if (noninteractive)
2255 if (handle_file_notifications (NULL))
2256 return 1;
2258 return 0;
2261 start_time = GetTickCount ();
2263 /* Wait for input or child death to be signaled. If user input is
2264 allowed, then also accept window messages. */
2265 if (FD_ISSET (0, &orfds))
2266 active = MsgWaitForMultipleObjects (nh + nc, wait_hnd, FALSE, timeout_ms,
2267 QS_ALLINPUT);
2268 else
2269 active = WaitForMultipleObjects (nh + nc, wait_hnd, FALSE, timeout_ms);
2271 if (active == WAIT_FAILED)
2273 DebPrint (("select.WaitForMultipleObjects (%d, %lu) failed with %lu\n",
2274 nh + nc, timeout_ms, GetLastError ()));
2275 /* don't return EBADF - this causes wait_reading_process_output to
2276 abort; WAIT_FAILED is returned when single-stepping under
2277 Windows 95 after switching thread focus in debugger, and
2278 possibly at other times. */
2279 errno = EINTR;
2280 return -1;
2282 else if (active == WAIT_TIMEOUT)
2284 if (noninteractive)
2286 if (handle_file_notifications (NULL))
2287 return 1;
2289 return 0;
2291 else if (active >= WAIT_OBJECT_0
2292 && active < WAIT_OBJECT_0+MAXIMUM_WAIT_OBJECTS)
2294 active -= WAIT_OBJECT_0;
2296 else if (active >= WAIT_ABANDONED_0
2297 && active < WAIT_ABANDONED_0+MAXIMUM_WAIT_OBJECTS)
2299 active -= WAIT_ABANDONED_0;
2301 else
2302 emacs_abort ();
2304 /* Loop over all handles after active (now officially documented as
2305 being the first signaled handle in the array). We do this to
2306 ensure fairness, so that all channels with data available will be
2307 processed - otherwise higher numbered channels could be starved. */
2310 if (active == nh + nc)
2312 /* There are messages in the lisp thread's queue; we must
2313 drain the queue now to ensure they are processed promptly,
2314 because if we don't do so, we will not be woken again until
2315 further messages arrive.
2317 NB. If ever we allow window message procedures to callback
2318 into lisp, we will need to ensure messages are dispatched
2319 at a safe time for lisp code to be run (*), and we may also
2320 want to provide some hooks in the dispatch loop to cater
2321 for modeless dialogs created by lisp (ie. to register
2322 window handles to pass to IsDialogMessage).
2324 (*) Note that MsgWaitForMultipleObjects above is an
2325 internal dispatch point for messages that are sent to
2326 windows created by this thread. */
2327 if (drain_message_queue ()
2328 /* If drain_message_queue returns non-zero, that means
2329 we received a WM_EMACS_FILENOTIFY message. If this
2330 is a TTY frame, we must signal the caller that keyboard
2331 input is available, so that w32_console_read_socket
2332 will be called to pick up the notifications. If we
2333 don't do that, file notifications will only work when
2334 the Emacs TTY frame has focus. */
2335 && FRAME_TERMCAP_P (SELECTED_FRAME ())
2336 /* they asked for stdin reads */
2337 && FD_ISSET (0, &orfds)
2338 /* the stdin handle is valid */
2339 && keyboard_handle)
2341 FD_SET (0, rfds);
2342 if (nr == 0)
2343 nr = 1;
2346 else if (active >= nh)
2348 cp = cps[active - nh];
2350 /* We cannot always signal SIGCHLD immediately; if we have not
2351 finished reading the process output, we must delay sending
2352 SIGCHLD until we do. */
2354 if (cp->fd >= 0 && (fd_info[cp->fd].flags & FILE_AT_EOF) == 0)
2355 fd_info[cp->fd].flags |= FILE_SEND_SIGCHLD;
2356 /* SIG_DFL for SIGCHLD is ignored */
2357 else if (sig_handlers[SIGCHLD] != SIG_DFL &&
2358 sig_handlers[SIGCHLD] != SIG_IGN)
2360 #ifdef FULL_DEBUG
2361 DebPrint (("select calling SIGCHLD handler for pid %d\n",
2362 cp->pid));
2363 #endif
2364 sig_handlers[SIGCHLD] (SIGCHLD);
2367 else if (fdindex[active] == -1)
2369 /* Quit (C-g) was detected. */
2370 errno = EINTR;
2371 return -1;
2373 else if (rfds && fdindex[active] == 0)
2375 /* Keyboard input available */
2376 FD_SET (0, rfds);
2377 nr++;
2379 else
2381 /* Must be a socket or pipe - read ahead should have
2382 completed, either succeeding or failing. If this handle
2383 was waiting for an async 'connect', reset the connect
2384 flag, so it could read from now on. */
2385 if (wfds && (fd_info[fdindex[active]].flags & FILE_CONNECT) != 0)
2387 cp = fd_info[fdindex[active]].cp;
2388 if (cp)
2390 /* Don't reset the FILE_CONNECT bit and don't
2391 acknowledge the read if the status is
2392 STATUS_CONNECT_FAILED or some other
2393 failure. That's because the thread exits in those
2394 cases, so it doesn't need the ACK, and we want to
2395 keep the FILE_CONNECT bit as evidence that the
2396 connect failed, to be checked in sys_read. */
2397 if (cp->status == STATUS_READ_SUCCEEDED)
2399 fd_info[cp->fd].flags &= ~FILE_CONNECT;
2400 cp->status = STATUS_READ_ACKNOWLEDGED;
2402 ResetEvent (cp->char_avail);
2404 FD_SET (fdindex[active], wfds);
2406 else if (rfds)
2407 FD_SET (fdindex[active], rfds);
2408 nr++;
2411 /* Even though wait_reading_process_output only reads from at most
2412 one channel, we must process all channels here so that we reap
2413 all children that have died. */
2414 while (++active < nh + nc)
2415 if (WaitForSingleObject (wait_hnd[active], 0) == WAIT_OBJECT_0)
2416 break;
2417 } while (active < nh + nc);
2419 if (noninteractive)
2421 if (handle_file_notifications (NULL))
2422 nr++;
2425 /* If no input has arrived and timeout hasn't expired, wait again. */
2426 if (nr == 0)
2428 DWORD elapsed = GetTickCount () - start_time;
2430 if (timeout_ms > elapsed) /* INFINITE is MAX_UINT */
2432 if (timeout_ms != INFINITE)
2433 timeout_ms -= elapsed;
2434 goto count_children;
2438 return nr;
2441 /* Substitute for certain kill () operations */
2443 static BOOL CALLBACK
2444 find_child_console (HWND hwnd, LPARAM arg)
2446 child_process * cp = (child_process *) arg;
2447 DWORD process_id;
2449 GetWindowThreadProcessId (hwnd, &process_id);
2450 if (process_id == cp->procinfo.dwProcessId)
2452 char window_class[32];
2454 GetClassName (hwnd, window_class, sizeof (window_class));
2455 if (strcmp (window_class,
2456 (os_subtype == OS_9X)
2457 ? "tty"
2458 : "ConsoleWindowClass") == 0)
2460 cp->hwnd = hwnd;
2461 return FALSE;
2464 /* keep looking */
2465 return TRUE;
2468 /* Emulate 'kill', but only for other processes. */
2470 sys_kill (pid_t pid, int sig)
2472 child_process *cp;
2473 HANDLE proc_hand;
2474 int need_to_free = 0;
2475 int rc = 0;
2477 /* Each process is in its own process group. */
2478 if (pid < 0)
2479 pid = -pid;
2481 /* Only handle signals that will result in the process dying */
2482 if (sig != 0
2483 && sig != SIGINT && sig != SIGKILL && sig != SIGQUIT && sig != SIGHUP)
2485 errno = EINVAL;
2486 return -1;
2489 if (sig == 0)
2491 /* It will take _some_ time before PID 4 or less on Windows will
2492 be Emacs... */
2493 if (pid <= 4)
2495 errno = EPERM;
2496 return -1;
2498 proc_hand = OpenProcess (PROCESS_QUERY_INFORMATION, 0, pid);
2499 if (proc_hand == NULL)
2501 DWORD err = GetLastError ();
2503 switch (err)
2505 case ERROR_ACCESS_DENIED: /* existing process, but access denied */
2506 errno = EPERM;
2507 return -1;
2508 case ERROR_INVALID_PARAMETER: /* process PID does not exist */
2509 errno = ESRCH;
2510 return -1;
2513 else
2514 CloseHandle (proc_hand);
2515 return 0;
2518 cp = find_child_pid (pid);
2519 if (cp == NULL)
2521 /* We were passed a PID of something other than our subprocess.
2522 If that is our own PID, we will send to ourself a message to
2523 close the selected frame, which does not necessarily
2524 terminates Emacs. But then we are not supposed to call
2525 sys_kill with our own PID. */
2526 proc_hand = OpenProcess (PROCESS_TERMINATE, 0, pid);
2527 if (proc_hand == NULL)
2529 errno = EPERM;
2530 return -1;
2532 need_to_free = 1;
2534 else
2536 proc_hand = cp->procinfo.hProcess;
2537 pid = cp->procinfo.dwProcessId;
2539 /* Try to locate console window for process. */
2540 EnumWindows (find_child_console, (LPARAM) cp);
2543 if (sig == SIGINT || sig == SIGQUIT)
2545 if (NILP (Vw32_start_process_share_console) && cp && cp->hwnd)
2547 BYTE control_scan_code = (BYTE) MapVirtualKey (VK_CONTROL, 0);
2548 /* Fake Ctrl-C for SIGINT, and Ctrl-Break for SIGQUIT. */
2549 BYTE vk_break_code = (sig == SIGINT) ? 'C' : VK_CANCEL;
2550 BYTE break_scan_code = (BYTE) MapVirtualKey (vk_break_code, 0);
2551 HWND foreground_window;
2553 if (break_scan_code == 0)
2555 /* Fake Ctrl-C for SIGQUIT if we can't manage Ctrl-Break. */
2556 vk_break_code = 'C';
2557 break_scan_code = (BYTE) MapVirtualKey (vk_break_code, 0);
2560 foreground_window = GetForegroundWindow ();
2561 if (foreground_window)
2563 /* NT 5.0, and apparently also Windows 98, will not allow
2564 a Window to be set to foreground directly without the
2565 user's involvement. The workaround is to attach
2566 ourselves to the thread that owns the foreground
2567 window, since that is the only thread that can set the
2568 foreground window. */
2569 DWORD foreground_thread, child_thread;
2570 foreground_thread =
2571 GetWindowThreadProcessId (foreground_window, NULL);
2572 if (foreground_thread == GetCurrentThreadId ()
2573 || !AttachThreadInput (GetCurrentThreadId (),
2574 foreground_thread, TRUE))
2575 foreground_thread = 0;
2577 child_thread = GetWindowThreadProcessId (cp->hwnd, NULL);
2578 if (child_thread == GetCurrentThreadId ()
2579 || !AttachThreadInput (GetCurrentThreadId (),
2580 child_thread, TRUE))
2581 child_thread = 0;
2583 /* Set the foreground window to the child. */
2584 if (SetForegroundWindow (cp->hwnd))
2586 /* Generate keystrokes as if user had typed Ctrl-Break or
2587 Ctrl-C. */
2588 keybd_event (VK_CONTROL, control_scan_code, 0, 0);
2589 keybd_event (vk_break_code, break_scan_code,
2590 (vk_break_code == 'C' ? 0 : KEYEVENTF_EXTENDEDKEY), 0);
2591 keybd_event (vk_break_code, break_scan_code,
2592 (vk_break_code == 'C' ? 0 : KEYEVENTF_EXTENDEDKEY)
2593 | KEYEVENTF_KEYUP, 0);
2594 keybd_event (VK_CONTROL, control_scan_code,
2595 KEYEVENTF_KEYUP, 0);
2597 /* Sleep for a bit to give time for Emacs frame to respond
2598 to focus change events (if Emacs was active app). */
2599 Sleep (100);
2601 SetForegroundWindow (foreground_window);
2603 /* Detach from the foreground and child threads now that
2604 the foreground switching is over. */
2605 if (foreground_thread)
2606 AttachThreadInput (GetCurrentThreadId (),
2607 foreground_thread, FALSE);
2608 if (child_thread)
2609 AttachThreadInput (GetCurrentThreadId (),
2610 child_thread, FALSE);
2613 /* Ctrl-Break is NT equivalent of SIGINT. */
2614 else if (!GenerateConsoleCtrlEvent (CTRL_BREAK_EVENT, pid))
2616 DebPrint (("sys_kill.GenerateConsoleCtrlEvent return %d "
2617 "for pid %lu\n", GetLastError (), pid));
2618 errno = EINVAL;
2619 rc = -1;
2622 else
2624 if (NILP (Vw32_start_process_share_console) && cp && cp->hwnd)
2626 #if 1
2627 if (os_subtype == OS_9X)
2630 Another possibility is to try terminating the VDM out-right by
2631 calling the Shell VxD (id 0x17) V86 interface, function #4
2632 "SHELL_Destroy_VM", ie.
2634 mov edx,4
2635 mov ebx,vm_handle
2636 call shellapi
2638 First need to determine the current VM handle, and then arrange for
2639 the shellapi call to be made from the system vm (by using
2640 Switch_VM_and_callback).
2642 Could try to invoke DestroyVM through CallVxD.
2645 #if 0
2646 /* On Windows 95, posting WM_QUIT causes the 16-bit subsystem
2647 to hang when cmdproxy is used in conjunction with
2648 command.com for an interactive shell. Posting
2649 WM_CLOSE pops up a dialog that, when Yes is selected,
2650 does the same thing. TerminateProcess is also less
2651 than ideal in that subprocesses tend to stick around
2652 until the machine is shutdown, but at least it
2653 doesn't freeze the 16-bit subsystem. */
2654 PostMessage (cp->hwnd, WM_QUIT, 0xff, 0);
2655 #endif
2656 if (!TerminateProcess (proc_hand, 0xff))
2658 DebPrint (("sys_kill.TerminateProcess returned %d "
2659 "for pid %lu\n", GetLastError (), pid));
2660 errno = EINVAL;
2661 rc = -1;
2664 else
2665 #endif
2666 PostMessage (cp->hwnd, WM_CLOSE, 0, 0);
2668 /* Kill the process. On W32 this doesn't kill child processes
2669 so it doesn't work very well for shells which is why it's not
2670 used in every case. */
2671 else if (!TerminateProcess (proc_hand, 0xff))
2673 DebPrint (("sys_kill.TerminateProcess returned %d "
2674 "for pid %lu\n", GetLastError (), pid));
2675 errno = EINVAL;
2676 rc = -1;
2680 if (need_to_free)
2681 CloseHandle (proc_hand);
2683 return rc;
2686 /* The following two routines are used to manipulate stdin, stdout, and
2687 stderr of our child processes.
2689 Assuming that in, out, and err are *not* inheritable, we make them
2690 stdin, stdout, and stderr of the child as follows:
2692 - Save the parent's current standard handles.
2693 - Set the std handles to inheritable duplicates of the ones being passed in.
2694 (Note that _get_osfhandle() is an io.h procedure that retrieves the
2695 NT file handle for a crt file descriptor.)
2696 - Spawn the child, which inherits in, out, and err as stdin,
2697 stdout, and stderr. (see Spawnve)
2698 - Close the std handles passed to the child.
2699 - Reset the parent's standard handles to the saved handles.
2700 (see reset_standard_handles)
2701 We assume that the caller closes in, out, and err after calling us. */
2703 void
2704 prepare_standard_handles (int in, int out, int err, HANDLE handles[3])
2706 HANDLE parent;
2707 HANDLE newstdin, newstdout, newstderr;
2709 parent = GetCurrentProcess ();
2711 handles[0] = GetStdHandle (STD_INPUT_HANDLE);
2712 handles[1] = GetStdHandle (STD_OUTPUT_HANDLE);
2713 handles[2] = GetStdHandle (STD_ERROR_HANDLE);
2715 /* make inheritable copies of the new handles */
2716 if (!DuplicateHandle (parent,
2717 (HANDLE) _get_osfhandle (in),
2718 parent,
2719 &newstdin,
2721 TRUE,
2722 DUPLICATE_SAME_ACCESS))
2723 report_file_error ("Duplicating input handle for child", Qnil);
2725 if (!DuplicateHandle (parent,
2726 (HANDLE) _get_osfhandle (out),
2727 parent,
2728 &newstdout,
2730 TRUE,
2731 DUPLICATE_SAME_ACCESS))
2732 report_file_error ("Duplicating output handle for child", Qnil);
2734 if (!DuplicateHandle (parent,
2735 (HANDLE) _get_osfhandle (err),
2736 parent,
2737 &newstderr,
2739 TRUE,
2740 DUPLICATE_SAME_ACCESS))
2741 report_file_error ("Duplicating error handle for child", Qnil);
2743 /* and store them as our std handles */
2744 if (!SetStdHandle (STD_INPUT_HANDLE, newstdin))
2745 report_file_error ("Changing stdin handle", Qnil);
2747 if (!SetStdHandle (STD_OUTPUT_HANDLE, newstdout))
2748 report_file_error ("Changing stdout handle", Qnil);
2750 if (!SetStdHandle (STD_ERROR_HANDLE, newstderr))
2751 report_file_error ("Changing stderr handle", Qnil);
2754 void
2755 reset_standard_handles (int in, int out, int err, HANDLE handles[3])
2757 /* close the duplicated handles passed to the child */
2758 CloseHandle (GetStdHandle (STD_INPUT_HANDLE));
2759 CloseHandle (GetStdHandle (STD_OUTPUT_HANDLE));
2760 CloseHandle (GetStdHandle (STD_ERROR_HANDLE));
2762 /* now restore parent's saved std handles */
2763 SetStdHandle (STD_INPUT_HANDLE, handles[0]);
2764 SetStdHandle (STD_OUTPUT_HANDLE, handles[1]);
2765 SetStdHandle (STD_ERROR_HANDLE, handles[2]);
2768 void
2769 set_process_dir (char * dir)
2771 process_dir = dir;
2774 /* To avoid problems with winsock implementations that work over dial-up
2775 connections causing or requiring a connection to exist while Emacs is
2776 running, Emacs no longer automatically loads winsock on startup if it
2777 is present. Instead, it will be loaded when open-network-stream is
2778 first called.
2780 To allow full control over when winsock is loaded, we provide these
2781 two functions to dynamically load and unload winsock. This allows
2782 dial-up users to only be connected when they actually need to use
2783 socket services. */
2785 /* From w32.c */
2786 extern HANDLE winsock_lib;
2787 extern BOOL term_winsock (void);
2788 extern BOOL init_winsock (int load_now);
2790 DEFUN ("w32-has-winsock", Fw32_has_winsock, Sw32_has_winsock, 0, 1, 0,
2791 doc: /* Test for presence of the Windows socket library `winsock'.
2792 Returns non-nil if winsock support is present, nil otherwise.
2794 If the optional argument LOAD-NOW is non-nil, the winsock library is
2795 also loaded immediately if not already loaded. If winsock is loaded,
2796 the winsock local hostname is returned (since this may be different from
2797 the value of `system-name' and should supplant it), otherwise t is
2798 returned to indicate winsock support is present. */)
2799 (Lisp_Object load_now)
2801 int have_winsock;
2803 have_winsock = init_winsock (!NILP (load_now));
2804 if (have_winsock)
2806 if (winsock_lib != NULL)
2808 /* Return new value for system-name. The best way to do this
2809 is to call init_system_name, saving and restoring the
2810 original value to avoid side-effects. */
2811 Lisp_Object orig_hostname = Vsystem_name;
2812 Lisp_Object hostname;
2814 init_system_name ();
2815 hostname = Vsystem_name;
2816 Vsystem_name = orig_hostname;
2817 return hostname;
2819 return Qt;
2821 return Qnil;
2824 DEFUN ("w32-unload-winsock", Fw32_unload_winsock, Sw32_unload_winsock,
2825 0, 0, 0,
2826 doc: /* Unload the Windows socket library `winsock' if loaded.
2827 This is provided to allow dial-up socket connections to be disconnected
2828 when no longer needed. Returns nil without unloading winsock if any
2829 socket connections still exist. */)
2830 (void)
2832 return term_winsock () ? Qt : Qnil;
2836 /* Some miscellaneous functions that are Windows specific, but not GUI
2837 specific (ie. are applicable in terminal or batch mode as well). */
2839 DEFUN ("w32-short-file-name", Fw32_short_file_name, Sw32_short_file_name, 1, 1, 0,
2840 doc: /* Return the short file name version (8.3) of the full path of FILENAME.
2841 If FILENAME does not exist, return nil.
2842 All path elements in FILENAME are converted to their short names. */)
2843 (Lisp_Object filename)
2845 char shortname[MAX_PATH];
2847 CHECK_STRING (filename);
2849 /* first expand it. */
2850 filename = Fexpand_file_name (filename, Qnil);
2852 /* luckily, this returns the short version of each element in the path. */
2853 if (w32_get_short_filename (SDATA (ENCODE_FILE (filename)),
2854 shortname, MAX_PATH) == 0)
2855 return Qnil;
2857 dostounix_filename (shortname);
2859 /* No need to DECODE_FILE, because 8.3 names are pure ASCII. */
2860 return build_string (shortname);
2864 DEFUN ("w32-long-file-name", Fw32_long_file_name, Sw32_long_file_name,
2865 1, 1, 0,
2866 doc: /* Return the long file name version of the full path of FILENAME.
2867 If FILENAME does not exist, return nil.
2868 All path elements in FILENAME are converted to their long names. */)
2869 (Lisp_Object filename)
2871 char longname[ MAX_UTF8_PATH ];
2872 int drive_only = 0;
2874 CHECK_STRING (filename);
2876 if (SBYTES (filename) == 2
2877 && *(SDATA (filename) + 1) == ':')
2878 drive_only = 1;
2880 /* first expand it. */
2881 filename = Fexpand_file_name (filename, Qnil);
2883 if (!w32_get_long_filename (SDATA (ENCODE_FILE (filename)), longname,
2884 MAX_UTF8_PATH))
2885 return Qnil;
2887 dostounix_filename (longname);
2889 /* If we were passed only a drive, make sure that a slash is not appended
2890 for consistency with directories. Allow for drive mapping via SUBST
2891 in case expand-file-name is ever changed to expand those. */
2892 if (drive_only && longname[1] == ':' && longname[2] == '/' && !longname[3])
2893 longname[2] = '\0';
2895 return DECODE_FILE (build_unibyte_string (longname));
2898 DEFUN ("w32-set-process-priority", Fw32_set_process_priority,
2899 Sw32_set_process_priority, 2, 2, 0,
2900 doc: /* Set the priority of PROCESS to PRIORITY.
2901 If PROCESS is nil, the priority of Emacs is changed, otherwise the
2902 priority of the process whose pid is PROCESS is changed.
2903 PRIORITY should be one of the symbols high, normal, or low;
2904 any other symbol will be interpreted as normal.
2906 If successful, the return value is t, otherwise nil. */)
2907 (Lisp_Object process, Lisp_Object priority)
2909 HANDLE proc_handle = GetCurrentProcess ();
2910 DWORD priority_class = NORMAL_PRIORITY_CLASS;
2911 Lisp_Object result = Qnil;
2913 CHECK_SYMBOL (priority);
2915 if (!NILP (process))
2917 DWORD pid;
2918 child_process *cp;
2920 CHECK_NUMBER (process);
2922 /* Allow pid to be an internally generated one, or one obtained
2923 externally. This is necessary because real pids on Windows 95 are
2924 negative. */
2926 pid = XINT (process);
2927 cp = find_child_pid (pid);
2928 if (cp != NULL)
2929 pid = cp->procinfo.dwProcessId;
2931 proc_handle = OpenProcess (PROCESS_SET_INFORMATION, FALSE, pid);
2934 if (EQ (priority, Qhigh))
2935 priority_class = HIGH_PRIORITY_CLASS;
2936 else if (EQ (priority, Qlow))
2937 priority_class = IDLE_PRIORITY_CLASS;
2939 if (proc_handle != NULL)
2941 if (SetPriorityClass (proc_handle, priority_class))
2942 result = Qt;
2943 if (!NILP (process))
2944 CloseHandle (proc_handle);
2947 return result;
2950 #ifdef HAVE_LANGINFO_CODESET
2951 /* Emulation of nl_langinfo. Used in fns.c:Flocale_info. */
2952 char *
2953 nl_langinfo (nl_item item)
2955 /* Conversion of Posix item numbers to their Windows equivalents. */
2956 static const LCTYPE w32item[] = {
2957 LOCALE_IDEFAULTANSICODEPAGE,
2958 LOCALE_SDAYNAME1, LOCALE_SDAYNAME2, LOCALE_SDAYNAME3,
2959 LOCALE_SDAYNAME4, LOCALE_SDAYNAME5, LOCALE_SDAYNAME6, LOCALE_SDAYNAME7,
2960 LOCALE_SMONTHNAME1, LOCALE_SMONTHNAME2, LOCALE_SMONTHNAME3,
2961 LOCALE_SMONTHNAME4, LOCALE_SMONTHNAME5, LOCALE_SMONTHNAME6,
2962 LOCALE_SMONTHNAME7, LOCALE_SMONTHNAME8, LOCALE_SMONTHNAME9,
2963 LOCALE_SMONTHNAME10, LOCALE_SMONTHNAME11, LOCALE_SMONTHNAME12
2966 static char *nl_langinfo_buf = NULL;
2967 static int nl_langinfo_len = 0;
2969 if (nl_langinfo_len <= 0)
2970 nl_langinfo_buf = xmalloc (nl_langinfo_len = 1);
2972 if (item < 0 || item >= _NL_NUM)
2973 nl_langinfo_buf[0] = 0;
2974 else
2976 LCID cloc = GetThreadLocale ();
2977 int need_len = GetLocaleInfo (cloc, w32item[item] | LOCALE_USE_CP_ACP,
2978 NULL, 0);
2980 if (need_len <= 0)
2981 nl_langinfo_buf[0] = 0;
2982 else
2984 if (item == CODESET)
2986 need_len += 2; /* for the "cp" prefix */
2987 if (need_len < 8) /* for the case we call GetACP */
2988 need_len = 8;
2990 if (nl_langinfo_len <= need_len)
2991 nl_langinfo_buf = xrealloc (nl_langinfo_buf,
2992 nl_langinfo_len = need_len);
2993 if (!GetLocaleInfo (cloc, w32item[item] | LOCALE_USE_CP_ACP,
2994 nl_langinfo_buf, nl_langinfo_len))
2995 nl_langinfo_buf[0] = 0;
2996 else if (item == CODESET)
2998 if (strcmp (nl_langinfo_buf, "0") == 0 /* CP_ACP */
2999 || strcmp (nl_langinfo_buf, "1") == 0) /* CP_OEMCP */
3000 sprintf (nl_langinfo_buf, "cp%u", GetACP ());
3001 else
3003 memmove (nl_langinfo_buf + 2, nl_langinfo_buf,
3004 strlen (nl_langinfo_buf) + 1);
3005 nl_langinfo_buf[0] = 'c';
3006 nl_langinfo_buf[1] = 'p';
3011 return nl_langinfo_buf;
3013 #endif /* HAVE_LANGINFO_CODESET */
3015 DEFUN ("w32-get-locale-info", Fw32_get_locale_info,
3016 Sw32_get_locale_info, 1, 2, 0,
3017 doc: /* Return information about the Windows locale LCID.
3018 By default, return a three letter locale code which encodes the default
3019 language as the first two characters, and the country or regional variant
3020 as the third letter. For example, ENU refers to `English (United States)',
3021 while ENC means `English (Canadian)'.
3023 If the optional argument LONGFORM is t, the long form of the locale
3024 name is returned, e.g. `English (United States)' instead; if LONGFORM
3025 is a number, it is interpreted as an LCTYPE constant and the corresponding
3026 locale information is returned.
3028 If LCID (a 16-bit number) is not a valid locale, the result is nil. */)
3029 (Lisp_Object lcid, Lisp_Object longform)
3031 int got_abbrev;
3032 int got_full;
3033 char abbrev_name[32] = { 0 };
3034 char full_name[256] = { 0 };
3036 CHECK_NUMBER (lcid);
3038 if (!IsValidLocale (XINT (lcid), LCID_SUPPORTED))
3039 return Qnil;
3041 if (NILP (longform))
3043 got_abbrev = GetLocaleInfo (XINT (lcid),
3044 LOCALE_SABBREVLANGNAME | LOCALE_USE_CP_ACP,
3045 abbrev_name, sizeof (abbrev_name));
3046 if (got_abbrev)
3047 return build_string (abbrev_name);
3049 else if (EQ (longform, Qt))
3051 got_full = GetLocaleInfo (XINT (lcid),
3052 LOCALE_SLANGUAGE | LOCALE_USE_CP_ACP,
3053 full_name, sizeof (full_name));
3054 if (got_full)
3055 return DECODE_SYSTEM (build_string (full_name));
3057 else if (NUMBERP (longform))
3059 got_full = GetLocaleInfo (XINT (lcid),
3060 XINT (longform),
3061 full_name, sizeof (full_name));
3062 /* GetLocaleInfo's return value includes the terminating null
3063 character, when the returned information is a string, whereas
3064 make_unibyte_string needs the string length without the
3065 terminating null. */
3066 if (got_full)
3067 return make_unibyte_string (full_name, got_full - 1);
3070 return Qnil;
3074 DEFUN ("w32-get-current-locale-id", Fw32_get_current_locale_id,
3075 Sw32_get_current_locale_id, 0, 0, 0,
3076 doc: /* Return Windows locale id for current locale setting.
3077 This is a numerical value; use `w32-get-locale-info' to convert to a
3078 human-readable form. */)
3079 (void)
3081 return make_number (GetThreadLocale ());
3084 static DWORD
3085 int_from_hex (char * s)
3087 DWORD val = 0;
3088 static char hex[] = "0123456789abcdefABCDEF";
3089 char * p;
3091 while (*s && (p = strchr (hex, *s)) != NULL)
3093 unsigned digit = p - hex;
3094 if (digit > 15)
3095 digit -= 6;
3096 val = val * 16 + digit;
3097 s++;
3099 return val;
3102 /* We need to build a global list, since the EnumSystemLocale callback
3103 function isn't given a context pointer. */
3104 Lisp_Object Vw32_valid_locale_ids;
3106 static BOOL CALLBACK ALIGN_STACK
3107 enum_locale_fn (LPTSTR localeNum)
3109 DWORD id = int_from_hex (localeNum);
3110 Vw32_valid_locale_ids = Fcons (make_number (id), Vw32_valid_locale_ids);
3111 return TRUE;
3114 DEFUN ("w32-get-valid-locale-ids", Fw32_get_valid_locale_ids,
3115 Sw32_get_valid_locale_ids, 0, 0, 0,
3116 doc: /* Return list of all valid Windows locale ids.
3117 Each id is a numerical value; use `w32-get-locale-info' to convert to a
3118 human-readable form. */)
3119 (void)
3121 Vw32_valid_locale_ids = Qnil;
3123 EnumSystemLocales (enum_locale_fn, LCID_SUPPORTED);
3125 Vw32_valid_locale_ids = Fnreverse (Vw32_valid_locale_ids);
3126 return Vw32_valid_locale_ids;
3130 DEFUN ("w32-get-default-locale-id", Fw32_get_default_locale_id, Sw32_get_default_locale_id, 0, 1, 0,
3131 doc: /* Return Windows locale id for default locale setting.
3132 By default, the system default locale setting is returned; if the optional
3133 parameter USERP is non-nil, the user default locale setting is returned.
3134 This is a numerical value; use `w32-get-locale-info' to convert to a
3135 human-readable form. */)
3136 (Lisp_Object userp)
3138 if (NILP (userp))
3139 return make_number (GetSystemDefaultLCID ());
3140 return make_number (GetUserDefaultLCID ());
3144 DEFUN ("w32-set-current-locale", Fw32_set_current_locale, Sw32_set_current_locale, 1, 1, 0,
3145 doc: /* Make Windows locale LCID be the current locale setting for Emacs.
3146 If successful, the new locale id is returned, otherwise nil. */)
3147 (Lisp_Object lcid)
3149 CHECK_NUMBER (lcid);
3151 if (!IsValidLocale (XINT (lcid), LCID_SUPPORTED))
3152 return Qnil;
3154 if (!SetThreadLocale (XINT (lcid)))
3155 return Qnil;
3157 /* Need to set input thread locale if present. */
3158 if (dwWindowsThreadId)
3159 /* Reply is not needed. */
3160 PostThreadMessage (dwWindowsThreadId, WM_EMACS_SETLOCALE, XINT (lcid), 0);
3162 return make_number (GetThreadLocale ());
3166 /* We need to build a global list, since the EnumCodePages callback
3167 function isn't given a context pointer. */
3168 Lisp_Object Vw32_valid_codepages;
3170 static BOOL CALLBACK ALIGN_STACK
3171 enum_codepage_fn (LPTSTR codepageNum)
3173 DWORD id = atoi (codepageNum);
3174 Vw32_valid_codepages = Fcons (make_number (id), Vw32_valid_codepages);
3175 return TRUE;
3178 DEFUN ("w32-get-valid-codepages", Fw32_get_valid_codepages,
3179 Sw32_get_valid_codepages, 0, 0, 0,
3180 doc: /* Return list of all valid Windows codepages. */)
3181 (void)
3183 Vw32_valid_codepages = Qnil;
3185 EnumSystemCodePages (enum_codepage_fn, CP_SUPPORTED);
3187 Vw32_valid_codepages = Fnreverse (Vw32_valid_codepages);
3188 return Vw32_valid_codepages;
3192 DEFUN ("w32-get-console-codepage", Fw32_get_console_codepage,
3193 Sw32_get_console_codepage, 0, 0, 0,
3194 doc: /* Return current Windows codepage for console input. */)
3195 (void)
3197 return make_number (GetConsoleCP ());
3201 DEFUN ("w32-set-console-codepage", Fw32_set_console_codepage,
3202 Sw32_set_console_codepage, 1, 1, 0,
3203 doc: /* Make Windows codepage CP be the codepage for Emacs tty keyboard input.
3204 This codepage setting affects keyboard input in tty mode.
3205 If successful, the new CP is returned, otherwise nil. */)
3206 (Lisp_Object cp)
3208 CHECK_NUMBER (cp);
3210 if (!IsValidCodePage (XINT (cp)))
3211 return Qnil;
3213 if (!SetConsoleCP (XINT (cp)))
3214 return Qnil;
3216 return make_number (GetConsoleCP ());
3220 DEFUN ("w32-get-console-output-codepage", Fw32_get_console_output_codepage,
3221 Sw32_get_console_output_codepage, 0, 0, 0,
3222 doc: /* Return current Windows codepage for console output. */)
3223 (void)
3225 return make_number (GetConsoleOutputCP ());
3229 DEFUN ("w32-set-console-output-codepage", Fw32_set_console_output_codepage,
3230 Sw32_set_console_output_codepage, 1, 1, 0,
3231 doc: /* Make Windows codepage CP be the codepage for Emacs console output.
3232 This codepage setting affects display in tty mode.
3233 If successful, the new CP is returned, otherwise nil. */)
3234 (Lisp_Object cp)
3236 CHECK_NUMBER (cp);
3238 if (!IsValidCodePage (XINT (cp)))
3239 return Qnil;
3241 if (!SetConsoleOutputCP (XINT (cp)))
3242 return Qnil;
3244 return make_number (GetConsoleOutputCP ());
3248 DEFUN ("w32-get-codepage-charset", Fw32_get_codepage_charset,
3249 Sw32_get_codepage_charset, 1, 1, 0,
3250 doc: /* Return charset ID corresponding to codepage CP.
3251 Returns nil if the codepage is not valid or its charset ID could
3252 not be determined.
3254 Note that this function is only guaranteed to work with ANSI
3255 codepages; most console codepages are not supported and will
3256 yield nil. */)
3257 (Lisp_Object cp)
3259 CHARSETINFO info;
3260 DWORD dwcp;
3262 CHECK_NUMBER (cp);
3264 if (!IsValidCodePage (XINT (cp)))
3265 return Qnil;
3267 /* Going through a temporary DWORD variable avoids compiler warning
3268 about cast to pointer from integer of different size, when
3269 building --with-wide-int. */
3270 dwcp = XINT (cp);
3271 if (TranslateCharsetInfo ((DWORD *) dwcp, &info, TCI_SRCCODEPAGE))
3272 return make_number (info.ciCharset);
3274 return Qnil;
3278 DEFUN ("w32-get-valid-keyboard-layouts", Fw32_get_valid_keyboard_layouts,
3279 Sw32_get_valid_keyboard_layouts, 0, 0, 0,
3280 doc: /* Return list of Windows keyboard languages and layouts.
3281 The return value is a list of pairs of language id and layout id. */)
3282 (void)
3284 int num_layouts = GetKeyboardLayoutList (0, NULL);
3285 HKL * layouts = (HKL *) alloca (num_layouts * sizeof (HKL));
3286 Lisp_Object obj = Qnil;
3288 if (GetKeyboardLayoutList (num_layouts, layouts) == num_layouts)
3290 while (--num_layouts >= 0)
3292 HKL kl = layouts[num_layouts];
3294 obj = Fcons (Fcons (make_number (LOWORD (kl)),
3295 make_number (HIWORD (kl))),
3296 obj);
3300 return obj;
3304 DEFUN ("w32-get-keyboard-layout", Fw32_get_keyboard_layout,
3305 Sw32_get_keyboard_layout, 0, 0, 0,
3306 doc: /* Return current Windows keyboard language and layout.
3307 The return value is the cons of the language id and the layout id. */)
3308 (void)
3310 HKL kl = GetKeyboardLayout (dwWindowsThreadId);
3312 return Fcons (make_number (LOWORD (kl)),
3313 make_number (HIWORD (kl)));
3317 DEFUN ("w32-set-keyboard-layout", Fw32_set_keyboard_layout,
3318 Sw32_set_keyboard_layout, 1, 1, 0,
3319 doc: /* Make LAYOUT be the current keyboard layout for Emacs.
3320 The keyboard layout setting affects interpretation of keyboard input.
3321 If successful, the new layout id is returned, otherwise nil. */)
3322 (Lisp_Object layout)
3324 HKL kl;
3326 CHECK_CONS (layout);
3327 CHECK_NUMBER_CAR (layout);
3328 CHECK_NUMBER_CDR (layout);
3330 kl = (HKL) (UINT_PTR) ((XINT (XCAR (layout)) & 0xffff)
3331 | (XINT (XCDR (layout)) << 16));
3333 /* Synchronize layout with input thread. */
3334 if (dwWindowsThreadId)
3336 if (PostThreadMessage (dwWindowsThreadId, WM_EMACS_SETKEYBOARDLAYOUT,
3337 (WPARAM) kl, 0))
3339 MSG msg;
3340 GetMessage (&msg, NULL, WM_EMACS_DONE, WM_EMACS_DONE);
3342 if (msg.wParam == 0)
3343 return Qnil;
3346 else if (!ActivateKeyboardLayout (kl, 0))
3347 return Qnil;
3349 return Fw32_get_keyboard_layout ();
3352 /* Two variables to interface between get_lcid and the EnumLocales
3353 callback function below. */
3354 #ifndef LOCALE_NAME_MAX_LENGTH
3355 # define LOCALE_NAME_MAX_LENGTH 85
3356 #endif
3357 static LCID found_lcid;
3358 static char lname[3 * LOCALE_NAME_MAX_LENGTH + 1 + 1];
3360 /* Callback function for EnumLocales. */
3361 static BOOL CALLBACK
3362 get_lcid_callback (LPTSTR locale_num_str)
3364 char *endp;
3365 char locval[2 * LOCALE_NAME_MAX_LENGTH + 1 + 1];
3366 LCID try_lcid = strtoul (locale_num_str, &endp, 16);
3368 if (GetLocaleInfo (try_lcid, LOCALE_SABBREVLANGNAME,
3369 locval, LOCALE_NAME_MAX_LENGTH))
3371 size_t locval_len;
3373 /* This is for when they only specify the language, as in "ENU". */
3374 if (stricmp (locval, lname) == 0)
3376 found_lcid = try_lcid;
3377 return FALSE;
3379 locval_len = strlen (locval);
3380 strcpy (locval + locval_len, "_");
3381 if (GetLocaleInfo (try_lcid, LOCALE_SABBREVCTRYNAME,
3382 locval + locval_len + 1, LOCALE_NAME_MAX_LENGTH))
3384 locval_len = strlen (locval);
3385 if (strnicmp (locval, lname, locval_len) == 0
3386 && (lname[locval_len] == '.'
3387 || lname[locval_len] == '\0'))
3389 found_lcid = try_lcid;
3390 return FALSE;
3394 return TRUE;
3397 /* Return the Locale ID (LCID) number given the locale's name, a
3398 string, in LOCALE_NAME. This works by enumerating all the locales
3399 supported by the system, until we find one whose name matches
3400 LOCALE_NAME. */
3401 static LCID
3402 get_lcid (const char *locale_name)
3404 /* A simple cache. */
3405 static LCID last_lcid;
3406 static char last_locale[1000];
3408 /* The code below is not thread-safe, as it uses static variables.
3409 But this function is called only from the Lisp thread. */
3410 if (last_lcid > 0 && strcmp (locale_name, last_locale) == 0)
3411 return last_lcid;
3413 strncpy (lname, locale_name, sizeof (lname) - 1);
3414 lname[sizeof (lname) - 1] = '\0';
3415 found_lcid = 0;
3416 EnumSystemLocales (get_lcid_callback, LCID_SUPPORTED);
3417 if (found_lcid > 0)
3419 last_lcid = found_lcid;
3420 strcpy (last_locale, locale_name);
3422 return found_lcid;
3425 #ifndef _NSLCMPERROR
3426 # define _NSLCMPERROR INT_MAX
3427 #endif
3428 #ifndef LINGUISTIC_IGNORECASE
3429 # define LINGUISTIC_IGNORECASE 0x00000010
3430 #endif
3433 w32_compare_strings (const char *s1, const char *s2, char *locname,
3434 int ignore_case)
3436 LCID lcid = GetThreadLocale ();
3437 wchar_t *string1_w, *string2_w;
3438 int val, needed;
3439 extern BOOL g_b_init_compare_string_w;
3440 static int (WINAPI *pCompareStringW)(LCID, DWORD, LPCWSTR, int, LPCWSTR, int);
3441 DWORD flags = 0;
3443 USE_SAFE_ALLOCA;
3445 /* The LCID machinery doesn't seem to support the "C" locale, so we
3446 need to do that by hand. */
3447 if (locname
3448 && ((locname[0] == 'C' && (locname[1] == '\0' || locname[1] == '.'))
3449 || strcmp (locname, "POSIX") == 0))
3450 return (ignore_case ? stricmp (s1, s2) : strcmp (s1, s2));
3452 if (!g_b_init_compare_string_w)
3454 if (os_subtype == OS_9X)
3456 pCompareStringW = GetProcAddress (LoadLibrary ("Unicows.dll"),
3457 "CompareStringW");
3458 if (!pCompareStringW)
3460 errno = EINVAL;
3461 /* This return value is compatible with wcscoll and
3462 other MS CRT functions. */
3463 return _NSLCMPERROR;
3466 else
3467 pCompareStringW = CompareStringW;
3469 g_b_init_compare_string_w = 1;
3472 needed = pMultiByteToWideChar (CP_UTF8, MB_ERR_INVALID_CHARS, s1, -1, NULL, 0);
3473 if (needed > 0)
3475 SAFE_NALLOCA (string1_w, 1, needed + 1);
3476 pMultiByteToWideChar (CP_UTF8, MB_ERR_INVALID_CHARS, s1, -1,
3477 string1_w, needed);
3479 else
3481 errno = EINVAL;
3482 return _NSLCMPERROR;
3485 needed = pMultiByteToWideChar (CP_UTF8, MB_ERR_INVALID_CHARS, s2, -1, NULL, 0);
3486 if (needed > 0)
3488 SAFE_NALLOCA (string2_w, 1, needed + 1);
3489 pMultiByteToWideChar (CP_UTF8, MB_ERR_INVALID_CHARS, s2, -1,
3490 string2_w, needed);
3492 else
3494 SAFE_FREE ();
3495 errno = EINVAL;
3496 return _NSLCMPERROR;
3499 if (locname)
3501 /* Convert locale name string to LCID. We don't want to use
3502 LocaleNameToLCID because (a) it is only available since
3503 Vista, and (b) it doesn't accept locale names returned by
3504 'setlocale' and 'GetLocaleInfo'. */
3505 LCID new_lcid = get_lcid (locname);
3507 if (new_lcid > 0)
3508 lcid = new_lcid;
3509 else
3510 error ("Invalid locale %s: Invalid argument", locname);
3513 if (ignore_case)
3515 /* NORM_IGNORECASE ignores any tertiary distinction, not just
3516 case variants. LINGUISTIC_IGNORECASE is more selective, and
3517 is sensitive to the locale's language, but it is not
3518 available before Vista. */
3519 if (w32_major_version >= 6)
3520 flags |= LINGUISTIC_IGNORECASE;
3521 else
3522 flags |= NORM_IGNORECASE;
3524 /* This approximates what glibc collation functions do when the
3525 locale's codeset is UTF-8. */
3526 if (!NILP (Vw32_collate_ignore_punctuation))
3527 flags |= NORM_IGNORESYMBOLS;
3528 val = pCompareStringW (lcid, flags, string1_w, -1, string2_w, -1);
3529 SAFE_FREE ();
3530 if (!val)
3532 errno = EINVAL;
3533 return _NSLCMPERROR;
3535 return val - 2;
3539 void
3540 syms_of_ntproc (void)
3542 DEFSYM (Qhigh, "high");
3543 DEFSYM (Qlow, "low");
3545 defsubr (&Sw32_has_winsock);
3546 defsubr (&Sw32_unload_winsock);
3548 defsubr (&Sw32_short_file_name);
3549 defsubr (&Sw32_long_file_name);
3550 defsubr (&Sw32_set_process_priority);
3551 defsubr (&Sw32_get_locale_info);
3552 defsubr (&Sw32_get_current_locale_id);
3553 defsubr (&Sw32_get_default_locale_id);
3554 defsubr (&Sw32_get_valid_locale_ids);
3555 defsubr (&Sw32_set_current_locale);
3557 defsubr (&Sw32_get_console_codepage);
3558 defsubr (&Sw32_set_console_codepage);
3559 defsubr (&Sw32_get_console_output_codepage);
3560 defsubr (&Sw32_set_console_output_codepage);
3561 defsubr (&Sw32_get_valid_codepages);
3562 defsubr (&Sw32_get_codepage_charset);
3564 defsubr (&Sw32_get_valid_keyboard_layouts);
3565 defsubr (&Sw32_get_keyboard_layout);
3566 defsubr (&Sw32_set_keyboard_layout);
3568 DEFVAR_LISP ("w32-quote-process-args", Vw32_quote_process_args,
3569 doc: /* Non-nil enables quoting of process arguments to ensure correct parsing.
3570 Because Windows does not directly pass argv arrays to child processes,
3571 programs have to reconstruct the argv array by parsing the command
3572 line string. For an argument to contain a space, it must be enclosed
3573 in double quotes or it will be parsed as multiple arguments.
3575 If the value is a character, that character will be used to escape any
3576 quote characters that appear, otherwise a suitable escape character
3577 will be chosen based on the type of the program. */);
3578 Vw32_quote_process_args = Qt;
3580 DEFVAR_LISP ("w32-start-process-show-window",
3581 Vw32_start_process_show_window,
3582 doc: /* When nil, new child processes hide their windows.
3583 When non-nil, they show their window in the method of their choice.
3584 This variable doesn't affect GUI applications, which will never be hidden. */);
3585 Vw32_start_process_show_window = Qnil;
3587 DEFVAR_LISP ("w32-start-process-share-console",
3588 Vw32_start_process_share_console,
3589 doc: /* When nil, new child processes are given a new console.
3590 When non-nil, they share the Emacs console; this has the limitation of
3591 allowing only one DOS subprocess to run at a time (whether started directly
3592 or indirectly by Emacs), and preventing Emacs from cleanly terminating the
3593 subprocess group, but may allow Emacs to interrupt a subprocess that doesn't
3594 otherwise respond to interrupts from Emacs. */);
3595 Vw32_start_process_share_console = Qnil;
3597 DEFVAR_LISP ("w32-start-process-inherit-error-mode",
3598 Vw32_start_process_inherit_error_mode,
3599 doc: /* When nil, new child processes revert to the default error mode.
3600 When non-nil, they inherit their error mode setting from Emacs, which stops
3601 them blocking when trying to access unmounted drives etc. */);
3602 Vw32_start_process_inherit_error_mode = Qt;
3604 DEFVAR_INT ("w32-pipe-read-delay", w32_pipe_read_delay,
3605 doc: /* Forced delay before reading subprocess output.
3606 This is done to improve the buffering of subprocess output, by
3607 avoiding the inefficiency of frequently reading small amounts of data.
3609 If positive, the value is the number of milliseconds to sleep before
3610 reading the subprocess output. If negative, the magnitude is the number
3611 of time slices to wait (effectively boosting the priority of the child
3612 process temporarily). A value of zero disables waiting entirely. */);
3613 w32_pipe_read_delay = 50;
3615 DEFVAR_LISP ("w32-downcase-file-names", Vw32_downcase_file_names,
3616 doc: /* Non-nil means convert all-upper case file names to lower case.
3617 This applies when performing completions and file name expansion.
3618 Note that the value of this setting also affects remote file names,
3619 so you probably don't want to set to non-nil if you use case-sensitive
3620 filesystems via ange-ftp. */);
3621 Vw32_downcase_file_names = Qnil;
3623 #if 0
3624 DEFVAR_LISP ("w32-generate-fake-inodes", Vw32_generate_fake_inodes,
3625 doc: /* Non-nil means attempt to fake realistic inode values.
3626 This works by hashing the truename of files, and should detect
3627 aliasing between long and short (8.3 DOS) names, but can have
3628 false positives because of hash collisions. Note that determining
3629 the truename of a file can be slow. */);
3630 Vw32_generate_fake_inodes = Qnil;
3631 #endif
3633 DEFVAR_LISP ("w32-get-true-file-attributes", Vw32_get_true_file_attributes,
3634 doc: /* Non-nil means determine accurate file attributes in `file-attributes'.
3635 This option controls whether to issue additional system calls to determine
3636 accurate link counts, file type, and ownership information. It is more
3637 useful for files on NTFS volumes, where hard links and file security are
3638 supported, than on volumes of the FAT family.
3640 Without these system calls, link count will always be reported as 1 and file
3641 ownership will be attributed to the current user.
3642 The default value `local' means only issue these system calls for files
3643 on local fixed drives. A value of nil means never issue them.
3644 Any other non-nil value means do this even on remote and removable drives
3645 where the performance impact may be noticeable even on modern hardware. */);
3646 Vw32_get_true_file_attributes = Qlocal;
3648 DEFVAR_LISP ("w32-collate-ignore-punctuation",
3649 Vw32_collate_ignore_punctuation,
3650 doc: /* Non-nil causes string collation functions ignore punctuation on MS-Windows.
3651 On Posix platforms, `string-collate-lessp' and `string-collate-equalp'
3652 ignore punctuation characters when they compare strings, if the
3653 locale's codeset is UTF-8, as in \"en_US.UTF-8\". Binding this option
3654 to a non-nil value will achieve a similar effect on MS-Windows, where
3655 locales with UTF-8 codeset are not supported.
3657 Note that setting this to non-nil will also ignore blanks and symbols
3658 in the strings. So do NOT use this option when comparing file names
3659 for equality, only when you need to sort them. */);
3660 Vw32_collate_ignore_punctuation = Qnil;
3662 staticpro (&Vw32_valid_locale_ids);
3663 staticpro (&Vw32_valid_codepages);
3665 /* end of w32proc.c */