1 /* Process support for GNU Emacs on the Microsoft W32 API.
2 Copyright (C) 1992, 1995, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005 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 2, or (at your option)
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; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA.
22 Drew Bliss Oct 14, 1993
23 Adapted from alarm.c by Tim Fleehart
34 /* must include CRT headers *before* config.h */
48 /* This definition is missing from mingw32 headers. */
49 extern BOOL WINAPI
IsValidLocale(LCID
, DWORD
);
58 #include "syssignal.h"
61 #define RVA_TO_PTR(var,section,filedata) \
62 ((void *)((section)->PointerToRawData \
63 + ((DWORD)(var) - (section)->VirtualAddress) \
64 + (filedata).file_base))
66 /* Control whether spawnve quotes arguments as necessary to ensure
67 correct parsing by child process. Because not all uses of spawnve
68 are careful about constructing argv arrays, we make this behaviour
69 conditional (off by default). */
70 Lisp_Object Vw32_quote_process_args
;
72 /* Control whether create_child causes the process' window to be
73 hidden. The default is nil. */
74 Lisp_Object Vw32_start_process_show_window
;
76 /* Control whether create_child causes the process to inherit Emacs'
77 console window, or be given a new one of its own. The default is
78 nil, to allow multiple DOS programs to run on Win95. Having separate
79 consoles also allows Emacs to cleanly terminate process groups. */
80 Lisp_Object Vw32_start_process_share_console
;
82 /* Control whether create_child cause the process to inherit Emacs'
83 error mode setting. The default is t, to minimize the possibility of
84 subprocesses blocking when accessing unmounted drives. */
85 Lisp_Object Vw32_start_process_inherit_error_mode
;
87 /* Time to sleep before reading from a subprocess output pipe - this
88 avoids the inefficiency of frequently reading small amounts of data.
89 This is primarily necessary for handling DOS processes on Windows 95,
90 but is useful for W32 processes on both Windows 95 and NT as well. */
91 int w32_pipe_read_delay
;
93 /* Control conversion of upper case file names to lower case.
94 nil means no, t means yes. */
95 Lisp_Object Vw32_downcase_file_names
;
97 /* Control whether stat() attempts to generate fake but hopefully
98 "accurate" inode values, by hashing the absolute truenames of files.
99 This should detect aliasing between long and short names, but still
100 allows the possibility of hash collisions. */
101 Lisp_Object Vw32_generate_fake_inodes
;
103 /* Control whether stat() attempts to determine file type and link count
104 exactly, at the expense of slower operation. Since true hard links
105 are supported on NTFS volumes, this is only relevant on NT. */
106 Lisp_Object Vw32_get_true_file_attributes
;
108 Lisp_Object Qhigh
, Qlow
;
111 void _DebPrint (const char *fmt
, ...)
116 va_start (args
, fmt
);
117 vsprintf (buf
, fmt
, args
);
119 OutputDebugString (buf
);
123 typedef void (_CALLBACK_
*signal_handler
)(int);
125 /* Signal handlers...SIG_DFL == 0 so this is initialized correctly. */
126 static signal_handler sig_handlers
[NSIG
];
128 /* Fake signal implementation to record the SIGCHLD handler. */
130 sys_signal (int sig
, signal_handler handler
)
139 old
= sig_handlers
[sig
];
140 sig_handlers
[sig
] = handler
;
144 /* Defined in <process.h> which conflicts with the local copy */
147 /* Child process management list. */
148 int child_proc_count
= 0;
149 child_process child_procs
[ MAX_CHILDREN
];
150 child_process
*dead_child
= NULL
;
152 DWORD WINAPI
reader_thread (void *arg
);
154 /* Find an unused process slot. */
161 for (cp
= child_procs
+(child_proc_count
-1); cp
>= child_procs
; cp
--)
162 if (!CHILD_ACTIVE (cp
))
164 if (child_proc_count
== MAX_CHILDREN
)
166 cp
= &child_procs
[child_proc_count
++];
169 memset (cp
, 0, sizeof(*cp
));
172 cp
->procinfo
.hProcess
= NULL
;
173 cp
->status
= STATUS_READ_ERROR
;
175 /* use manual reset event so that select() will function properly */
176 cp
->char_avail
= CreateEvent (NULL
, TRUE
, FALSE
, NULL
);
179 cp
->char_consumed
= CreateEvent (NULL
, FALSE
, FALSE
, NULL
);
180 if (cp
->char_consumed
)
182 cp
->thrd
= CreateThread (NULL
, 1024, reader_thread
, cp
, 0, &id
);
192 delete_child (child_process
*cp
)
196 /* Should not be deleting a child that is still needed. */
197 for (i
= 0; i
< MAXDESC
; i
++)
198 if (fd_info
[i
].cp
== cp
)
201 if (!CHILD_ACTIVE (cp
))
204 /* reap thread if necessary */
209 if (GetExitCodeThread (cp
->thrd
, &rc
) && rc
== STILL_ACTIVE
)
211 /* let the thread exit cleanly if possible */
212 cp
->status
= STATUS_READ_ERROR
;
213 SetEvent (cp
->char_consumed
);
214 if (WaitForSingleObject (cp
->thrd
, 1000) != WAIT_OBJECT_0
)
216 DebPrint (("delete_child.WaitForSingleObject (thread) failed "
217 "with %lu for fd %ld\n", GetLastError (), cp
->fd
));
218 TerminateThread (cp
->thrd
, 0);
221 CloseHandle (cp
->thrd
);
226 CloseHandle (cp
->char_avail
);
227 cp
->char_avail
= NULL
;
229 if (cp
->char_consumed
)
231 CloseHandle (cp
->char_consumed
);
232 cp
->char_consumed
= NULL
;
235 /* update child_proc_count (highest numbered slot in use plus one) */
236 if (cp
== child_procs
+ child_proc_count
- 1)
238 for (i
= child_proc_count
-1; i
>= 0; i
--)
239 if (CHILD_ACTIVE (&child_procs
[i
]))
241 child_proc_count
= i
+ 1;
246 child_proc_count
= 0;
249 /* Find a child by pid. */
250 static child_process
*
251 find_child_pid (DWORD pid
)
255 for (cp
= child_procs
+(child_proc_count
-1); cp
>= child_procs
; cp
--)
256 if (CHILD_ACTIVE (cp
) && pid
== cp
->pid
)
262 /* Thread proc for child process and socket reader threads. Each thread
263 is normally blocked until woken by select() to check for input by
264 reading one char. When the read completes, char_avail is signalled
265 to wake up the select emulator and the thread blocks itself again. */
267 reader_thread (void *arg
)
272 cp
= (child_process
*)arg
;
274 /* We have to wait for the go-ahead before we can start */
276 || WaitForSingleObject (cp
->char_consumed
, INFINITE
) != WAIT_OBJECT_0
)
283 rc
= _sys_read_ahead (cp
->fd
);
285 /* The name char_avail is a misnomer - it really just means the
286 read-ahead has completed, whether successfully or not. */
287 if (!SetEvent (cp
->char_avail
))
289 DebPrint (("reader_thread.SetEvent failed with %lu for fd %ld\n",
290 GetLastError (), cp
->fd
));
294 if (rc
== STATUS_READ_ERROR
)
297 /* If the read died, the child has died so let the thread die */
298 if (rc
== STATUS_READ_FAILED
)
301 /* Wait until our input is acknowledged before reading again */
302 if (WaitForSingleObject (cp
->char_consumed
, INFINITE
) != WAIT_OBJECT_0
)
304 DebPrint (("reader_thread.WaitForSingleObject failed with "
305 "%lu for fd %ld\n", GetLastError (), cp
->fd
));
312 /* To avoid Emacs changing directory, we just record here the directory
313 the new process should start in. This is set just before calling
314 sys_spawnve, and is not generally valid at any other time. */
315 static char * process_dir
;
318 create_child (char *exe
, char *cmdline
, char *env
, int is_gui_app
,
319 int * pPid
, child_process
*cp
)
322 SECURITY_ATTRIBUTES sec_attrs
;
324 SECURITY_DESCRIPTOR sec_desc
;
327 char dir
[ MAXPATHLEN
];
329 if (cp
== NULL
) abort ();
331 memset (&start
, 0, sizeof (start
));
332 start
.cb
= sizeof (start
);
335 if (NILP (Vw32_start_process_show_window
) && !is_gui_app
)
336 start
.dwFlags
= STARTF_USESTDHANDLES
| STARTF_USESHOWWINDOW
;
338 start
.dwFlags
= STARTF_USESTDHANDLES
;
339 start
.wShowWindow
= SW_HIDE
;
341 start
.hStdInput
= GetStdHandle (STD_INPUT_HANDLE
);
342 start
.hStdOutput
= GetStdHandle (STD_OUTPUT_HANDLE
);
343 start
.hStdError
= GetStdHandle (STD_ERROR_HANDLE
);
344 #endif /* HAVE_NTGUI */
347 /* Explicitly specify no security */
348 if (!InitializeSecurityDescriptor (&sec_desc
, SECURITY_DESCRIPTOR_REVISION
))
350 if (!SetSecurityDescriptorDacl (&sec_desc
, TRUE
, NULL
, FALSE
))
353 sec_attrs
.nLength
= sizeof (sec_attrs
);
354 sec_attrs
.lpSecurityDescriptor
= NULL
/* &sec_desc */;
355 sec_attrs
.bInheritHandle
= FALSE
;
357 strcpy (dir
, process_dir
);
358 unixtodos_filename (dir
);
360 flags
= (!NILP (Vw32_start_process_share_console
)
361 ? CREATE_NEW_PROCESS_GROUP
362 : CREATE_NEW_CONSOLE
);
363 if (NILP (Vw32_start_process_inherit_error_mode
))
364 flags
|= CREATE_DEFAULT_ERROR_MODE
;
365 if (!CreateProcess (exe
, cmdline
, &sec_attrs
, NULL
, TRUE
,
366 flags
, env
, dir
, &start
, &cp
->procinfo
))
369 cp
->pid
= (int) cp
->procinfo
.dwProcessId
;
371 /* Hack for Windows 95, which assigns large (ie negative) pids */
375 /* pid must fit in a Lisp_Int */
376 cp
->pid
= cp
->pid
& INTMASK
;
383 DebPrint (("create_child.CreateProcess failed: %ld\n", GetLastError()););
387 /* create_child doesn't know what emacs' file handle will be for waiting
388 on output from the child, so we need to make this additional call
389 to register the handle with the process
390 This way the select emulator knows how to match file handles with
391 entries in child_procs. */
393 register_child (int pid
, int fd
)
397 cp
= find_child_pid (pid
);
400 DebPrint (("register_child unable to find pid %lu\n", pid
));
405 DebPrint (("register_child registered fd %d with pid %lu\n", fd
, pid
));
410 /* thread is initially blocked until select is called; set status so
411 that select will release thread */
412 cp
->status
= STATUS_READ_ACKNOWLEDGED
;
414 /* attach child_process to fd_info */
415 if (fd_info
[fd
].cp
!= NULL
)
417 DebPrint (("register_child: fd_info[%d] apparently in use!\n", fd
));
424 /* When a process dies its pipe will break so the reader thread will
425 signal failure to the select emulator.
426 The select emulator then calls this routine to clean up.
427 Since the thread signaled failure we can assume it is exiting. */
429 reap_subprocess (child_process
*cp
)
431 if (cp
->procinfo
.hProcess
)
433 /* Reap the process */
435 /* Process should have already died before we are called. */
436 if (WaitForSingleObject (cp
->procinfo
.hProcess
, 0) != WAIT_OBJECT_0
)
437 DebPrint (("reap_subprocess: child fpr fd %d has not died yet!", cp
->fd
));
439 CloseHandle (cp
->procinfo
.hProcess
);
440 cp
->procinfo
.hProcess
= NULL
;
441 CloseHandle (cp
->procinfo
.hThread
);
442 cp
->procinfo
.hThread
= NULL
;
445 /* For asynchronous children, the child_proc resources will be freed
446 when the last pipe read descriptor is closed; for synchronous
447 children, we must explicitly free the resources now because
448 register_child has not been called. */
453 /* Wait for any of our existing child processes to die
454 When it does, close its handle
455 Return the pid and fill in the status if non-NULL. */
458 sys_wait (int *status
)
460 DWORD active
, retval
;
463 child_process
*cp
, *cps
[MAX_CHILDREN
];
464 HANDLE wait_hnd
[MAX_CHILDREN
];
467 if (dead_child
!= NULL
)
469 /* We want to wait for a specific child */
470 wait_hnd
[nh
] = dead_child
->procinfo
.hProcess
;
471 cps
[nh
] = dead_child
;
472 if (!wait_hnd
[nh
]) abort ();
479 for (cp
= child_procs
+(child_proc_count
-1); cp
>= child_procs
; cp
--)
480 /* some child_procs might be sockets; ignore them */
481 if (CHILD_ACTIVE (cp
) && cp
->procinfo
.hProcess
)
483 wait_hnd
[nh
] = cp
->procinfo
.hProcess
;
491 /* Nothing to wait on, so fail */
498 /* Check for quit about once a second. */
500 active
= WaitForMultipleObjects (nh
, wait_hnd
, FALSE
, 1000);
501 } while (active
== WAIT_TIMEOUT
);
503 if (active
== WAIT_FAILED
)
508 else if (active
>= WAIT_OBJECT_0
509 && active
< WAIT_OBJECT_0
+MAXIMUM_WAIT_OBJECTS
)
511 active
-= WAIT_OBJECT_0
;
513 else if (active
>= WAIT_ABANDONED_0
514 && active
< WAIT_ABANDONED_0
+MAXIMUM_WAIT_OBJECTS
)
516 active
-= WAIT_ABANDONED_0
;
522 if (!GetExitCodeProcess (wait_hnd
[active
], &retval
))
524 DebPrint (("Wait.GetExitCodeProcess failed with %lu\n",
528 if (retval
== STILL_ACTIVE
)
530 /* Should never happen */
531 DebPrint (("Wait.WaitForMultipleObjects returned an active process\n"));
536 /* Massage the exit code from the process to match the format expected
537 by the WIFSTOPPED et al macros in syswait.h. Only WIFSIGNALED and
538 WIFEXITED are supported; WIFSTOPPED doesn't make sense under NT. */
540 if (retval
== STATUS_CONTROL_C_EXIT
)
548 DebPrint (("Wait signaled with process pid %d\n", cp
->pid
));
555 else if (synch_process_alive
)
557 synch_process_alive
= 0;
559 /* Report the status of the synchronous process. */
560 if (WIFEXITED (retval
))
561 synch_process_retcode
= WRETCODE (retval
);
562 else if (WIFSIGNALED (retval
))
564 int code
= WTERMSIG (retval
);
567 synchronize_system_messages_locale ();
568 signame
= strsignal (code
);
573 synch_process_death
= signame
;
576 reap_subprocess (cp
);
579 reap_subprocess (cp
);
585 w32_executable_type (char * filename
, int * is_dos_app
, int * is_cygnus_app
, int * is_gui_app
)
587 file_data executable
;
590 /* Default values in case we can't tell for sure. */
592 *is_cygnus_app
= FALSE
;
595 if (!open_input_file (&executable
, filename
))
598 p
= strrchr (filename
, '.');
600 /* We can only identify DOS .com programs from the extension. */
601 if (p
&& stricmp (p
, ".com") == 0)
603 else if (p
&& (stricmp (p
, ".bat") == 0
604 || stricmp (p
, ".cmd") == 0))
606 /* A DOS shell script - it appears that CreateProcess is happy to
607 accept this (somewhat surprisingly); presumably it looks at
608 COMSPEC to determine what executable to actually invoke.
609 Therefore, we have to do the same here as well. */
610 /* Actually, I think it uses the program association for that
611 extension, which is defined in the registry. */
612 p
= egetenv ("COMSPEC");
614 w32_executable_type (p
, is_dos_app
, is_cygnus_app
, is_gui_app
);
618 /* Look for DOS .exe signature - if found, we must also check that
619 it isn't really a 16- or 32-bit Windows exe, since both formats
620 start with a DOS program stub. Note that 16-bit Windows
621 executables use the OS/2 1.x format. */
623 IMAGE_DOS_HEADER
* dos_header
;
624 IMAGE_NT_HEADERS
* nt_header
;
626 dos_header
= (PIMAGE_DOS_HEADER
) executable
.file_base
;
627 if (dos_header
->e_magic
!= IMAGE_DOS_SIGNATURE
)
630 nt_header
= (PIMAGE_NT_HEADERS
) ((char *) dos_header
+ dos_header
->e_lfanew
);
632 if ((char *) nt_header
> (char *) dos_header
+ executable
.size
)
634 /* Some dos headers (pkunzip) have bogus e_lfanew fields. */
637 else if (nt_header
->Signature
!= IMAGE_NT_SIGNATURE
638 && LOWORD (nt_header
->Signature
) != IMAGE_OS2_SIGNATURE
)
642 else if (nt_header
->Signature
== IMAGE_NT_SIGNATURE
)
644 /* Look for cygwin.dll in DLL import list. */
645 IMAGE_DATA_DIRECTORY import_dir
=
646 nt_header
->OptionalHeader
.DataDirectory
[IMAGE_DIRECTORY_ENTRY_IMPORT
];
647 IMAGE_IMPORT_DESCRIPTOR
* imports
;
648 IMAGE_SECTION_HEADER
* section
;
650 section
= rva_to_section (import_dir
.VirtualAddress
, nt_header
);
651 imports
= RVA_TO_PTR (import_dir
.VirtualAddress
, section
, executable
);
653 for ( ; imports
->Name
; imports
++)
655 char * dllname
= RVA_TO_PTR (imports
->Name
, section
, executable
);
657 /* The exact name of the cygwin dll has changed with
658 various releases, but hopefully this will be reasonably
660 if (strncmp (dllname
, "cygwin", 6) == 0)
662 *is_cygnus_app
= TRUE
;
667 /* Check whether app is marked as a console or windowed (aka
668 GUI) app. Accept Posix and OS2 subsytem apps as console
670 *is_gui_app
= (nt_header
->OptionalHeader
.Subsystem
== IMAGE_SUBSYSTEM_WINDOWS_GUI
);
675 close_file_data (&executable
);
679 compare_env (const void *strp1
, const void *strp2
)
681 const char *str1
= *(const char **)strp1
, *str2
= *(const char **)strp2
;
683 while (*str1
&& *str2
&& *str1
!= '=' && *str2
!= '=')
685 /* Sort order in command.com/cmd.exe is based on uppercasing
686 names, so do the same here. */
687 if (toupper (*str1
) > toupper (*str2
))
689 else if (toupper (*str1
) < toupper (*str2
))
694 if (*str1
== '=' && *str2
== '=')
696 else if (*str1
== '=')
703 merge_and_sort_env (char **envp1
, char **envp2
, char **new_envp
)
719 qsort (new_envp
, num
, sizeof (char *), compare_env
);
724 /* When a new child process is created we need to register it in our list,
725 so intercept spawn requests. */
727 sys_spawnve (int mode
, char *cmdname
, char **argv
, char **envp
)
729 Lisp_Object program
, full
;
730 char *cmdline
, *env
, *parg
, **targ
;
734 int is_dos_app
, is_cygnus_app
, is_gui_app
;
737 /* We pass our process ID to our children by setting up an environment
738 variable in their environment. */
739 char ppid_env_var_buffer
[64];
740 char *extra_env
[] = {ppid_env_var_buffer
, NULL
};
741 char *sepchars
= " \t";
743 /* We don't care about the other modes */
744 if (mode
!= _P_NOWAIT
)
750 /* Handle executable names without an executable suffix. */
751 program
= make_string (cmdname
, strlen (cmdname
));
752 if (NILP (Ffile_executable_p (program
)))
758 openp (Vexec_path
, program
, Vexec_suffixes
, &full
, make_number (X_OK
));
768 /* make sure argv[0] and cmdname are both in DOS format */
769 cmdname
= SDATA (program
);
770 unixtodos_filename (cmdname
);
773 /* Determine whether program is a 16-bit DOS executable, or a w32
774 executable that is implicitly linked to the Cygnus dll (implying it
775 was compiled with the Cygnus GNU toolchain and hence relies on
776 cygwin.dll to parse the command line - we use this to decide how to
777 escape quote chars in command line args that must be quoted).
779 Also determine whether it is a GUI app, so that we don't hide its
780 initial window unless specifically requested. */
781 w32_executable_type (cmdname
, &is_dos_app
, &is_cygnus_app
, &is_gui_app
);
783 /* On Windows 95, if cmdname is a DOS app, we invoke a helper
784 application to start it by specifying the helper app as cmdname,
785 while leaving the real app name as argv[0]. */
788 cmdname
= alloca (MAXPATHLEN
);
789 if (egetenv ("CMDPROXY"))
790 strcpy (cmdname
, egetenv ("CMDPROXY"));
793 strcpy (cmdname
, SDATA (Vinvocation_directory
));
794 strcat (cmdname
, "cmdproxy.exe");
796 unixtodos_filename (cmdname
);
799 /* we have to do some conjuring here to put argv and envp into the
800 form CreateProcess wants... argv needs to be a space separated/null
801 terminated list of parameters, and envp is a null
802 separated/double-null terminated list of parameters.
804 Additionally, zero-length args and args containing whitespace or
805 quote chars need to be wrapped in double quotes - for this to work,
806 embedded quotes need to be escaped as well. The aim is to ensure
807 the child process reconstructs the argv array we start with
808 exactly, so we treat quotes at the beginning and end of arguments
811 The w32 GNU-based library from Cygnus doubles quotes to escape
812 them, while MSVC uses backslash for escaping. (Actually the MSVC
813 startup code does attempt to recognise doubled quotes and accept
814 them, but gets it wrong and ends up requiring three quotes to get a
815 single embedded quote!) So by default we decide whether to use
816 quote or backslash as the escape character based on whether the
817 binary is apparently a Cygnus compiled app.
819 Note that using backslash to escape embedded quotes requires
820 additional special handling if an embedded quote is already
821 preceeded by backslash, or if an arg requiring quoting ends with
822 backslash. In such cases, the run of escape characters needs to be
823 doubled. For consistency, we apply this special handling as long
824 as the escape character is not quote.
826 Since we have no idea how large argv and envp are likely to be we
827 figure out list lengths on the fly and allocate them. */
829 if (!NILP (Vw32_quote_process_args
))
832 /* Override escape char by binding w32-quote-process-args to
833 desired character, or use t for auto-selection. */
834 if (INTEGERP (Vw32_quote_process_args
))
835 escape_char
= XINT (Vw32_quote_process_args
);
837 escape_char
= is_cygnus_app
? '"' : '\\';
840 /* Cygwin apps needs quoting a bit more often */
841 if (escape_char
== '"')
842 sepchars
= "\r\n\t\f '";
851 int escape_char_run
= 0;
857 if (escape_char
== '"' && *p
== '\\')
858 /* If it's a Cygwin app, \ needs to be escaped. */
862 /* allow for embedded quotes to be escaped */
865 /* handle the case where the embedded quote is already escaped */
866 if (escape_char_run
> 0)
868 /* To preserve the arg exactly, we need to double the
869 preceding escape characters (plus adding one to
870 escape the quote character itself). */
871 arglen
+= escape_char_run
;
874 else if (strchr (sepchars
, *p
) != NULL
)
879 if (*p
== escape_char
&& escape_char
!= '"')
887 /* handle the case where the arg ends with an escape char - we
888 must not let the enclosing quote be escaped. */
889 if (escape_char_run
> 0)
890 arglen
+= escape_char_run
;
892 arglen
+= strlen (*targ
++) + 1;
894 cmdline
= alloca (arglen
);
908 if ((strchr (sepchars
, *p
) != NULL
) || *p
== '"')
913 int escape_char_run
= 0;
919 last
= p
+ strlen (p
) - 1;
922 /* This version does not escape quotes if they occur at the
923 beginning or end of the arg - this could lead to incorrect
924 behaviour when the arg itself represents a command line
925 containing quoted args. I believe this was originally done
926 as a hack to make some things work, before
927 `w32-quote-process-args' was added. */
930 if (*p
== '"' && p
> first
&& p
< last
)
931 *parg
++ = escape_char
; /* escape embedded quotes */
939 /* double preceding escape chars if any */
940 while (escape_char_run
> 0)
942 *parg
++ = escape_char
;
945 /* escape all quote chars, even at beginning or end */
946 *parg
++ = escape_char
;
948 else if (escape_char
== '"' && *p
== '\\')
952 if (*p
== escape_char
&& escape_char
!= '"')
957 /* double escape chars before enclosing quote */
958 while (escape_char_run
> 0)
960 *parg
++ = escape_char
;
968 strcpy (parg
, *targ
);
969 parg
+= strlen (*targ
);
979 numenv
= 1; /* for end null */
982 arglen
+= strlen (*targ
++) + 1;
985 /* extra env vars... */
986 sprintf (ppid_env_var_buffer
, "EM_PARENT_PROCESS_ID=%d",
987 GetCurrentProcessId ());
988 arglen
+= strlen (ppid_env_var_buffer
) + 1;
991 /* merge env passed in and extra env into one, and sort it. */
992 targ
= (char **) alloca (numenv
* sizeof (char *));
993 merge_and_sort_env (envp
, extra_env
, targ
);
995 /* concatenate env entries. */
996 env
= alloca (arglen
);
1000 strcpy (parg
, *targ
);
1001 parg
+= strlen (*targ
++);
1014 /* Now create the process. */
1015 if (!create_child (cmdname
, cmdline
, env
, is_gui_app
, &pid
, cp
))
1025 /* Emulate the select call
1026 Wait for available input on any of the given rfds, or timeout if
1027 a timeout is given and no input is detected
1028 wfds and efds are not supported and must be NULL.
1030 For simplicity, we detect the death of child processes here and
1031 synchronously call the SIGCHLD handler. Since it is possible for
1032 children to be created without a corresponding pipe handle from which
1033 to read output, we wait separately on the process handles as well as
1034 the char_avail events for each process pipe. We only call
1035 wait/reap_process when the process actually terminates.
1037 To reduce the number of places in which Emacs can be hung such that
1038 C-g is not able to interrupt it, we always wait on interrupt_handle
1039 (which is signalled by the input thread when C-g is detected). If we
1040 detect that we were woken up by C-g, we return -1 with errno set to
1041 EINTR as on Unix. */
1044 extern HANDLE keyboard_handle
;
1046 /* From w32xfns.c */
1047 extern HANDLE interrupt_handle
;
1049 /* From process.c */
1050 extern int proc_buffered_char
[];
1053 sys_select (int nfds
, SELECT_TYPE
*rfds
, SELECT_TYPE
*wfds
, SELECT_TYPE
*efds
,
1054 EMACS_TIME
*timeout
)
1057 DWORD timeout_ms
, start_time
;
1060 child_process
*cp
, *cps
[MAX_CHILDREN
];
1061 HANDLE wait_hnd
[MAXDESC
+ MAX_CHILDREN
];
1062 int fdindex
[MAXDESC
]; /* mapping from wait handles back to descriptors */
1064 timeout_ms
= timeout
? (timeout
->tv_sec
* 1000 + timeout
->tv_usec
/ 1000) : INFINITE
;
1066 /* If the descriptor sets are NULL but timeout isn't, then just Sleep. */
1067 if (rfds
== NULL
&& wfds
== NULL
&& efds
== NULL
&& timeout
!= NULL
)
1073 /* Otherwise, we only handle rfds, so fail otherwise. */
1074 if (rfds
== NULL
|| wfds
!= NULL
|| efds
!= NULL
)
1084 /* Always wait on interrupt_handle, to detect C-g (quit). */
1085 wait_hnd
[0] = interrupt_handle
;
1088 /* Build a list of pipe handles to wait on. */
1090 for (i
= 0; i
< nfds
; i
++)
1091 if (FD_ISSET (i
, &orfds
))
1095 if (keyboard_handle
)
1097 /* Handle stdin specially */
1098 wait_hnd
[nh
] = keyboard_handle
;
1103 /* Check for any emacs-generated input in the queue since
1104 it won't be detected in the wait */
1105 if (detect_input_pending ())
1113 /* Child process and socket input */
1117 int current_status
= cp
->status
;
1119 if (current_status
== STATUS_READ_ACKNOWLEDGED
)
1121 /* Tell reader thread which file handle to use. */
1123 /* Wake up the reader thread for this process */
1124 cp
->status
= STATUS_READ_READY
;
1125 if (!SetEvent (cp
->char_consumed
))
1126 DebPrint (("nt_select.SetEvent failed with "
1127 "%lu for fd %ld\n", GetLastError (), i
));
1130 #ifdef CHECK_INTERLOCK
1131 /* slightly crude cross-checking of interlock between threads */
1133 current_status
= cp
->status
;
1134 if (WaitForSingleObject (cp
->char_avail
, 0) == WAIT_OBJECT_0
)
1136 /* char_avail has been signalled, so status (which may
1137 have changed) should indicate read has completed
1138 but has not been acknowledged. */
1139 current_status
= cp
->status
;
1140 if (current_status
!= STATUS_READ_SUCCEEDED
1141 && current_status
!= STATUS_READ_FAILED
)
1142 DebPrint (("char_avail set, but read not completed: status %d\n",
1147 /* char_avail has not been signalled, so status should
1148 indicate that read is in progress; small possibility
1149 that read has completed but event wasn't yet signalled
1150 when we tested it (because a context switch occurred
1151 or if running on separate CPUs). */
1152 if (current_status
!= STATUS_READ_READY
1153 && current_status
!= STATUS_READ_IN_PROGRESS
1154 && current_status
!= STATUS_READ_SUCCEEDED
1155 && current_status
!= STATUS_READ_FAILED
)
1156 DebPrint (("char_avail reset, but read status is bad: %d\n",
1160 wait_hnd
[nh
] = cp
->char_avail
;
1162 if (!wait_hnd
[nh
]) abort ();
1165 DebPrint (("select waiting on child %d fd %d\n",
1166 cp
-child_procs
, i
));
1171 /* Unable to find something to wait on for this fd, skip */
1173 /* Note that this is not a fatal error, and can in fact
1174 happen in unusual circumstances. Specifically, if
1175 sys_spawnve fails, eg. because the program doesn't
1176 exist, and debug-on-error is t so Fsignal invokes a
1177 nested input loop, then the process output pipe is
1178 still included in input_wait_mask with no child_proc
1179 associated with it. (It is removed when the debugger
1180 exits the nested input loop and the error is thrown.) */
1182 DebPrint (("sys_select: fd %ld is invalid! ignoring\n", i
));
1188 /* Add handles of child processes. */
1190 for (cp
= child_procs
+(child_proc_count
-1); cp
>= child_procs
; cp
--)
1191 /* Some child_procs might be sockets; ignore them. Also some
1192 children may have died already, but we haven't finished reading
1193 the process output; ignore them too. */
1194 if (CHILD_ACTIVE (cp
) && cp
->procinfo
.hProcess
1196 || (fd_info
[cp
->fd
].flags
& FILE_SEND_SIGCHLD
) == 0
1197 || (fd_info
[cp
->fd
].flags
& FILE_AT_EOF
) != 0)
1200 wait_hnd
[nh
+ nc
] = cp
->procinfo
.hProcess
;
1205 /* Nothing to look for, so we didn't find anything */
1213 start_time
= GetTickCount ();
1215 /* Wait for input or child death to be signalled. If user input is
1216 allowed, then also accept window messages. */
1217 if (FD_ISSET (0, &orfds
))
1218 active
= MsgWaitForMultipleObjects (nh
+ nc
, wait_hnd
, FALSE
, timeout_ms
,
1221 active
= WaitForMultipleObjects (nh
+ nc
, wait_hnd
, FALSE
, timeout_ms
);
1223 if (active
== WAIT_FAILED
)
1225 DebPrint (("select.WaitForMultipleObjects (%d, %lu) failed with %lu\n",
1226 nh
+ nc
, timeout_ms
, GetLastError ()));
1227 /* don't return EBADF - this causes wait_reading_process_output to
1228 abort; WAIT_FAILED is returned when single-stepping under
1229 Windows 95 after switching thread focus in debugger, and
1230 possibly at other times. */
1234 else if (active
== WAIT_TIMEOUT
)
1238 else if (active
>= WAIT_OBJECT_0
1239 && active
< WAIT_OBJECT_0
+MAXIMUM_WAIT_OBJECTS
)
1241 active
-= WAIT_OBJECT_0
;
1243 else if (active
>= WAIT_ABANDONED_0
1244 && active
< WAIT_ABANDONED_0
+MAXIMUM_WAIT_OBJECTS
)
1246 active
-= WAIT_ABANDONED_0
;
1251 /* Loop over all handles after active (now officially documented as
1252 being the first signalled handle in the array). We do this to
1253 ensure fairness, so that all channels with data available will be
1254 processed - otherwise higher numbered channels could be starved. */
1257 if (active
== nh
+ nc
)
1259 /* There are messages in the lisp thread's queue; we must
1260 drain the queue now to ensure they are processed promptly,
1261 because if we don't do so, we will not be woken again until
1262 further messages arrive.
1264 NB. If ever we allow window message procedures to callback
1265 into lisp, we will need to ensure messages are dispatched
1266 at a safe time for lisp code to be run (*), and we may also
1267 want to provide some hooks in the dispatch loop to cater
1268 for modeless dialogs created by lisp (ie. to register
1269 window handles to pass to IsDialogMessage).
1271 (*) Note that MsgWaitForMultipleObjects above is an
1272 internal dispatch point for messages that are sent to
1273 windows created by this thread. */
1274 drain_message_queue ();
1276 else if (active
>= nh
)
1278 cp
= cps
[active
- nh
];
1280 /* We cannot always signal SIGCHLD immediately; if we have not
1281 finished reading the process output, we must delay sending
1282 SIGCHLD until we do. */
1284 if (cp
->fd
>= 0 && (fd_info
[cp
->fd
].flags
& FILE_AT_EOF
) == 0)
1285 fd_info
[cp
->fd
].flags
|= FILE_SEND_SIGCHLD
;
1286 /* SIG_DFL for SIGCHLD is ignore */
1287 else if (sig_handlers
[SIGCHLD
] != SIG_DFL
&&
1288 sig_handlers
[SIGCHLD
] != SIG_IGN
)
1291 DebPrint (("select calling SIGCHLD handler for pid %d\n",
1295 sig_handlers
[SIGCHLD
] (SIGCHLD
);
1299 else if (fdindex
[active
] == -1)
1301 /* Quit (C-g) was detected. */
1305 else if (fdindex
[active
] == 0)
1307 /* Keyboard input available */
1313 /* must be a socket or pipe - read ahead should have
1314 completed, either succeeding or failing. */
1315 FD_SET (fdindex
[active
], rfds
);
1319 /* Even though wait_reading_process_output only reads from at most
1320 one channel, we must process all channels here so that we reap
1321 all children that have died. */
1322 while (++active
< nh
+ nc
)
1323 if (WaitForSingleObject (wait_hnd
[active
], 0) == WAIT_OBJECT_0
)
1325 } while (active
< nh
+ nc
);
1327 /* If no input has arrived and timeout hasn't expired, wait again. */
1330 DWORD elapsed
= GetTickCount () - start_time
;
1332 if (timeout_ms
> elapsed
) /* INFINITE is MAX_UINT */
1334 if (timeout_ms
!= INFINITE
)
1335 timeout_ms
-= elapsed
;
1336 goto count_children
;
1343 /* Substitute for certain kill () operations */
1345 static BOOL CALLBACK
1346 find_child_console (HWND hwnd
, LPARAM arg
)
1348 child_process
* cp
= (child_process
*) arg
;
1352 thread_id
= GetWindowThreadProcessId (hwnd
, &process_id
);
1353 if (process_id
== cp
->procinfo
.dwProcessId
)
1355 char window_class
[32];
1357 GetClassName (hwnd
, window_class
, sizeof (window_class
));
1358 if (strcmp (window_class
,
1359 (os_subtype
== OS_WIN95
)
1361 : "ConsoleWindowClass") == 0)
1372 sys_kill (int pid
, int sig
)
1376 int need_to_free
= 0;
1379 /* Only handle signals that will result in the process dying */
1380 if (sig
!= SIGINT
&& sig
!= SIGKILL
&& sig
!= SIGQUIT
&& sig
!= SIGHUP
)
1386 cp
= find_child_pid (pid
);
1389 proc_hand
= OpenProcess (PROCESS_TERMINATE
, 0, pid
);
1390 if (proc_hand
== NULL
)
1399 proc_hand
= cp
->procinfo
.hProcess
;
1400 pid
= cp
->procinfo
.dwProcessId
;
1402 /* Try to locate console window for process. */
1403 EnumWindows (find_child_console
, (LPARAM
) cp
);
1406 if (sig
== SIGINT
|| sig
== SIGQUIT
)
1408 if (NILP (Vw32_start_process_share_console
) && cp
&& cp
->hwnd
)
1410 BYTE control_scan_code
= (BYTE
) MapVirtualKey (VK_CONTROL
, 0);
1411 /* Fake Ctrl-C for SIGINT, and Ctrl-Break for SIGQUIT. */
1412 BYTE vk_break_code
= (sig
== SIGINT
) ? 'C' : VK_CANCEL
;
1413 BYTE break_scan_code
= (BYTE
) MapVirtualKey (vk_break_code
, 0);
1414 HWND foreground_window
;
1416 if (break_scan_code
== 0)
1418 /* Fake Ctrl-C for SIGQUIT if we can't manage Ctrl-Break. */
1419 vk_break_code
= 'C';
1420 break_scan_code
= (BYTE
) MapVirtualKey (vk_break_code
, 0);
1423 foreground_window
= GetForegroundWindow ();
1424 if (foreground_window
)
1426 /* NT 5.0, and apparently also Windows 98, will not allow
1427 a Window to be set to foreground directly without the
1428 user's involvement. The workaround is to attach
1429 ourselves to the thread that owns the foreground
1430 window, since that is the only thread that can set the
1431 foreground window. */
1432 DWORD foreground_thread
, child_thread
;
1434 GetWindowThreadProcessId (foreground_window
, NULL
);
1435 if (foreground_thread
== GetCurrentThreadId ()
1436 || !AttachThreadInput (GetCurrentThreadId (),
1437 foreground_thread
, TRUE
))
1438 foreground_thread
= 0;
1440 child_thread
= GetWindowThreadProcessId (cp
->hwnd
, NULL
);
1441 if (child_thread
== GetCurrentThreadId ()
1442 || !AttachThreadInput (GetCurrentThreadId (),
1443 child_thread
, TRUE
))
1446 /* Set the foreground window to the child. */
1447 if (SetForegroundWindow (cp
->hwnd
))
1449 /* Generate keystrokes as if user had typed Ctrl-Break or
1451 keybd_event (VK_CONTROL
, control_scan_code
, 0, 0);
1452 keybd_event (vk_break_code
, break_scan_code
,
1453 (vk_break_code
== 'C' ? 0 : KEYEVENTF_EXTENDEDKEY
), 0);
1454 keybd_event (vk_break_code
, break_scan_code
,
1455 (vk_break_code
== 'C' ? 0 : KEYEVENTF_EXTENDEDKEY
)
1456 | KEYEVENTF_KEYUP
, 0);
1457 keybd_event (VK_CONTROL
, control_scan_code
,
1458 KEYEVENTF_KEYUP
, 0);
1460 /* Sleep for a bit to give time for Emacs frame to respond
1461 to focus change events (if Emacs was active app). */
1464 SetForegroundWindow (foreground_window
);
1466 /* Detach from the foreground and child threads now that
1467 the foreground switching is over. */
1468 if (foreground_thread
)
1469 AttachThreadInput (GetCurrentThreadId (),
1470 foreground_thread
, FALSE
);
1472 AttachThreadInput (GetCurrentThreadId (),
1473 child_thread
, FALSE
);
1476 /* Ctrl-Break is NT equivalent of SIGINT. */
1477 else if (!GenerateConsoleCtrlEvent (CTRL_BREAK_EVENT
, pid
))
1479 DebPrint (("sys_kill.GenerateConsoleCtrlEvent return %d "
1480 "for pid %lu\n", GetLastError (), pid
));
1487 if (NILP (Vw32_start_process_share_console
) && cp
&& cp
->hwnd
)
1490 if (os_subtype
== OS_WIN95
)
1493 Another possibility is to try terminating the VDM out-right by
1494 calling the Shell VxD (id 0x17) V86 interface, function #4
1495 "SHELL_Destroy_VM", ie.
1501 First need to determine the current VM handle, and then arrange for
1502 the shellapi call to be made from the system vm (by using
1503 Switch_VM_and_callback).
1505 Could try to invoke DestroyVM through CallVxD.
1509 /* On Win95, posting WM_QUIT causes the 16-bit subsystem
1510 to hang when cmdproxy is used in conjunction with
1511 command.com for an interactive shell. Posting
1512 WM_CLOSE pops up a dialog that, when Yes is selected,
1513 does the same thing. TerminateProcess is also less
1514 than ideal in that subprocesses tend to stick around
1515 until the machine is shutdown, but at least it
1516 doesn't freeze the 16-bit subsystem. */
1517 PostMessage (cp
->hwnd
, WM_QUIT
, 0xff, 0);
1519 if (!TerminateProcess (proc_hand
, 0xff))
1521 DebPrint (("sys_kill.TerminateProcess returned %d "
1522 "for pid %lu\n", GetLastError (), pid
));
1529 PostMessage (cp
->hwnd
, WM_CLOSE
, 0, 0);
1531 /* Kill the process. On W32 this doesn't kill child processes
1532 so it doesn't work very well for shells which is why it's not
1533 used in every case. */
1534 else if (!TerminateProcess (proc_hand
, 0xff))
1536 DebPrint (("sys_kill.TerminateProcess returned %d "
1537 "for pid %lu\n", GetLastError (), pid
));
1544 CloseHandle (proc_hand
);
1549 /* extern int report_file_error (char *, Lisp_Object); */
1551 /* The following two routines are used to manipulate stdin, stdout, and
1552 stderr of our child processes.
1554 Assuming that in, out, and err are *not* inheritable, we make them
1555 stdin, stdout, and stderr of the child as follows:
1557 - Save the parent's current standard handles.
1558 - Set the std handles to inheritable duplicates of the ones being passed in.
1559 (Note that _get_osfhandle() is an io.h procedure that retrieves the
1560 NT file handle for a crt file descriptor.)
1561 - Spawn the child, which inherits in, out, and err as stdin,
1562 stdout, and stderr. (see Spawnve)
1563 - Close the std handles passed to the child.
1564 - Reset the parent's standard handles to the saved handles.
1565 (see reset_standard_handles)
1566 We assume that the caller closes in, out, and err after calling us. */
1569 prepare_standard_handles (int in
, int out
, int err
, HANDLE handles
[3])
1572 HANDLE newstdin
, newstdout
, newstderr
;
1574 parent
= GetCurrentProcess ();
1576 handles
[0] = GetStdHandle (STD_INPUT_HANDLE
);
1577 handles
[1] = GetStdHandle (STD_OUTPUT_HANDLE
);
1578 handles
[2] = GetStdHandle (STD_ERROR_HANDLE
);
1580 /* make inheritable copies of the new handles */
1581 if (!DuplicateHandle (parent
,
1582 (HANDLE
) _get_osfhandle (in
),
1587 DUPLICATE_SAME_ACCESS
))
1588 report_file_error ("Duplicating input handle for child", Qnil
);
1590 if (!DuplicateHandle (parent
,
1591 (HANDLE
) _get_osfhandle (out
),
1596 DUPLICATE_SAME_ACCESS
))
1597 report_file_error ("Duplicating output handle for child", Qnil
);
1599 if (!DuplicateHandle (parent
,
1600 (HANDLE
) _get_osfhandle (err
),
1605 DUPLICATE_SAME_ACCESS
))
1606 report_file_error ("Duplicating error handle for child", Qnil
);
1608 /* and store them as our std handles */
1609 if (!SetStdHandle (STD_INPUT_HANDLE
, newstdin
))
1610 report_file_error ("Changing stdin handle", Qnil
);
1612 if (!SetStdHandle (STD_OUTPUT_HANDLE
, newstdout
))
1613 report_file_error ("Changing stdout handle", Qnil
);
1615 if (!SetStdHandle (STD_ERROR_HANDLE
, newstderr
))
1616 report_file_error ("Changing stderr handle", Qnil
);
1620 reset_standard_handles (int in
, int out
, int err
, HANDLE handles
[3])
1622 /* close the duplicated handles passed to the child */
1623 CloseHandle (GetStdHandle (STD_INPUT_HANDLE
));
1624 CloseHandle (GetStdHandle (STD_OUTPUT_HANDLE
));
1625 CloseHandle (GetStdHandle (STD_ERROR_HANDLE
));
1627 /* now restore parent's saved std handles */
1628 SetStdHandle (STD_INPUT_HANDLE
, handles
[0]);
1629 SetStdHandle (STD_OUTPUT_HANDLE
, handles
[1]);
1630 SetStdHandle (STD_ERROR_HANDLE
, handles
[2]);
1634 set_process_dir (char * dir
)
1641 /* To avoid problems with winsock implementations that work over dial-up
1642 connections causing or requiring a connection to exist while Emacs is
1643 running, Emacs no longer automatically loads winsock on startup if it
1644 is present. Instead, it will be loaded when open-network-stream is
1647 To allow full control over when winsock is loaded, we provide these
1648 two functions to dynamically load and unload winsock. This allows
1649 dial-up users to only be connected when they actually need to use
1653 extern HANDLE winsock_lib
;
1654 extern BOOL
term_winsock (void);
1655 extern BOOL
init_winsock (int load_now
);
1657 extern Lisp_Object Vsystem_name
;
1659 DEFUN ("w32-has-winsock", Fw32_has_winsock
, Sw32_has_winsock
, 0, 1, 0,
1660 doc
: /* Test for presence of the Windows socket library `winsock'.
1661 Returns non-nil if winsock support is present, nil otherwise.
1663 If the optional argument LOAD-NOW is non-nil, the winsock library is
1664 also loaded immediately if not already loaded. If winsock is loaded,
1665 the winsock local hostname is returned (since this may be different from
1666 the value of `system-name' and should supplant it), otherwise t is
1667 returned to indicate winsock support is present. */)
1669 Lisp_Object load_now
;
1673 have_winsock
= init_winsock (!NILP (load_now
));
1676 if (winsock_lib
!= NULL
)
1678 /* Return new value for system-name. The best way to do this
1679 is to call init_system_name, saving and restoring the
1680 original value to avoid side-effects. */
1681 Lisp_Object orig_hostname
= Vsystem_name
;
1682 Lisp_Object hostname
;
1684 init_system_name ();
1685 hostname
= Vsystem_name
;
1686 Vsystem_name
= orig_hostname
;
1694 DEFUN ("w32-unload-winsock", Fw32_unload_winsock
, Sw32_unload_winsock
,
1696 doc
: /* Unload the Windows socket library `winsock' if loaded.
1697 This is provided to allow dial-up socket connections to be disconnected
1698 when no longer needed. Returns nil without unloading winsock if any
1699 socket connections still exist. */)
1702 return term_winsock () ? Qt
: Qnil
;
1705 #endif /* HAVE_SOCKETS */
1708 /* Some miscellaneous functions that are Windows specific, but not GUI
1709 specific (ie. are applicable in terminal or batch mode as well). */
1711 /* lifted from fileio.c */
1712 #define CORRECT_DIR_SEPS(s) \
1713 do { if ('/' == DIRECTORY_SEP) dostounix_filename (s); \
1714 else unixtodos_filename (s); \
1717 DEFUN ("w32-short-file-name", Fw32_short_file_name
, Sw32_short_file_name
, 1, 1, 0,
1718 doc
: /* Return the short file name version (8.3) of the full path of FILENAME.
1719 If FILENAME does not exist, return nil.
1720 All path elements in FILENAME are converted to their short names. */)
1722 Lisp_Object filename
;
1724 char shortname
[MAX_PATH
];
1726 CHECK_STRING (filename
);
1728 /* first expand it. */
1729 filename
= Fexpand_file_name (filename
, Qnil
);
1731 /* luckily, this returns the short version of each element in the path. */
1732 if (GetShortPathName (SDATA (filename
), shortname
, MAX_PATH
) == 0)
1735 CORRECT_DIR_SEPS (shortname
);
1737 return build_string (shortname
);
1741 DEFUN ("w32-long-file-name", Fw32_long_file_name
, Sw32_long_file_name
,
1743 doc
: /* Return the long file name version of the full path of FILENAME.
1744 If FILENAME does not exist, return nil.
1745 All path elements in FILENAME are converted to their long names. */)
1747 Lisp_Object filename
;
1749 char longname
[ MAX_PATH
];
1751 CHECK_STRING (filename
);
1753 /* first expand it. */
1754 filename
= Fexpand_file_name (filename
, Qnil
);
1756 if (!w32_get_long_filename (SDATA (filename
), longname
, MAX_PATH
))
1759 CORRECT_DIR_SEPS (longname
);
1761 return build_string (longname
);
1764 DEFUN ("w32-set-process-priority", Fw32_set_process_priority
,
1765 Sw32_set_process_priority
, 2, 2, 0,
1766 doc
: /* Set the priority of PROCESS to PRIORITY.
1767 If PROCESS is nil, the priority of Emacs is changed, otherwise the
1768 priority of the process whose pid is PROCESS is changed.
1769 PRIORITY should be one of the symbols high, normal, or low;
1770 any other symbol will be interpreted as normal.
1772 If successful, the return value is t, otherwise nil. */)
1774 Lisp_Object process
, priority
;
1776 HANDLE proc_handle
= GetCurrentProcess ();
1777 DWORD priority_class
= NORMAL_PRIORITY_CLASS
;
1778 Lisp_Object result
= Qnil
;
1780 CHECK_SYMBOL (priority
);
1782 if (!NILP (process
))
1787 CHECK_NUMBER (process
);
1789 /* Allow pid to be an internally generated one, or one obtained
1790 externally. This is necessary because real pids on Win95 are
1793 pid
= XINT (process
);
1794 cp
= find_child_pid (pid
);
1796 pid
= cp
->procinfo
.dwProcessId
;
1798 proc_handle
= OpenProcess (PROCESS_SET_INFORMATION
, FALSE
, pid
);
1801 if (EQ (priority
, Qhigh
))
1802 priority_class
= HIGH_PRIORITY_CLASS
;
1803 else if (EQ (priority
, Qlow
))
1804 priority_class
= IDLE_PRIORITY_CLASS
;
1806 if (proc_handle
!= NULL
)
1808 if (SetPriorityClass (proc_handle
, priority_class
))
1810 if (!NILP (process
))
1811 CloseHandle (proc_handle
);
1818 DEFUN ("w32-get-locale-info", Fw32_get_locale_info
,
1819 Sw32_get_locale_info
, 1, 2, 0,
1820 doc
: /* Return information about the Windows locale LCID.
1821 By default, return a three letter locale code which encodes the default
1822 language as the first two characters, and the country or regionial variant
1823 as the third letter. For example, ENU refers to `English (United States)',
1824 while ENC means `English (Canadian)'.
1826 If the optional argument LONGFORM is t, the long form of the locale
1827 name is returned, e.g. `English (United States)' instead; if LONGFORM
1828 is a number, it is interpreted as an LCTYPE constant and the corresponding
1829 locale information is returned.
1831 If LCID (a 16-bit number) is not a valid locale, the result is nil. */)
1833 Lisp_Object lcid
, longform
;
1837 char abbrev_name
[32] = { 0 };
1838 char full_name
[256] = { 0 };
1840 CHECK_NUMBER (lcid
);
1842 if (!IsValidLocale (XINT (lcid
), LCID_SUPPORTED
))
1845 if (NILP (longform
))
1847 got_abbrev
= GetLocaleInfo (XINT (lcid
),
1848 LOCALE_SABBREVLANGNAME
| LOCALE_USE_CP_ACP
,
1849 abbrev_name
, sizeof (abbrev_name
));
1851 return build_string (abbrev_name
);
1853 else if (EQ (longform
, Qt
))
1855 got_full
= GetLocaleInfo (XINT (lcid
),
1856 LOCALE_SLANGUAGE
| LOCALE_USE_CP_ACP
,
1857 full_name
, sizeof (full_name
));
1859 return build_string (full_name
);
1861 else if (NUMBERP (longform
))
1863 got_full
= GetLocaleInfo (XINT (lcid
),
1865 full_name
, sizeof (full_name
));
1867 return make_unibyte_string (full_name
, got_full
);
1874 DEFUN ("w32-get-current-locale-id", Fw32_get_current_locale_id
,
1875 Sw32_get_current_locale_id
, 0, 0, 0,
1876 doc
: /* Return Windows locale id for current locale setting.
1877 This is a numerical value; use `w32-get-locale-info' to convert to a
1878 human-readable form. */)
1881 return make_number (GetThreadLocale ());
1884 DWORD
int_from_hex (char * s
)
1887 static char hex
[] = "0123456789abcdefABCDEF";
1890 while (*s
&& (p
= strchr(hex
, *s
)) != NULL
)
1892 unsigned digit
= p
- hex
;
1895 val
= val
* 16 + digit
;
1901 /* We need to build a global list, since the EnumSystemLocale callback
1902 function isn't given a context pointer. */
1903 Lisp_Object Vw32_valid_locale_ids
;
1905 BOOL CALLBACK
enum_locale_fn (LPTSTR localeNum
)
1907 DWORD id
= int_from_hex (localeNum
);
1908 Vw32_valid_locale_ids
= Fcons (make_number (id
), Vw32_valid_locale_ids
);
1912 DEFUN ("w32-get-valid-locale-ids", Fw32_get_valid_locale_ids
,
1913 Sw32_get_valid_locale_ids
, 0, 0, 0,
1914 doc
: /* Return list of all valid Windows locale ids.
1915 Each id is a numerical value; use `w32-get-locale-info' to convert to a
1916 human-readable form. */)
1919 Vw32_valid_locale_ids
= Qnil
;
1921 EnumSystemLocales (enum_locale_fn
, LCID_SUPPORTED
);
1923 Vw32_valid_locale_ids
= Fnreverse (Vw32_valid_locale_ids
);
1924 return Vw32_valid_locale_ids
;
1928 DEFUN ("w32-get-default-locale-id", Fw32_get_default_locale_id
, Sw32_get_default_locale_id
, 0, 1, 0,
1929 doc
: /* Return Windows locale id for default locale setting.
1930 By default, the system default locale setting is returned; if the optional
1931 parameter USERP is non-nil, the user default locale setting is returned.
1932 This is a numerical value; use `w32-get-locale-info' to convert to a
1933 human-readable form. */)
1938 return make_number (GetSystemDefaultLCID ());
1939 return make_number (GetUserDefaultLCID ());
1943 DEFUN ("w32-set-current-locale", Fw32_set_current_locale
, Sw32_set_current_locale
, 1, 1, 0,
1944 doc
: /* Make Windows locale LCID be the current locale setting for Emacs.
1945 If successful, the new locale id is returned, otherwise nil. */)
1949 CHECK_NUMBER (lcid
);
1951 if (!IsValidLocale (XINT (lcid
), LCID_SUPPORTED
))
1954 if (!SetThreadLocale (XINT (lcid
)))
1957 /* Need to set input thread locale if present. */
1958 if (dwWindowsThreadId
)
1959 /* Reply is not needed. */
1960 PostThreadMessage (dwWindowsThreadId
, WM_EMACS_SETLOCALE
, XINT (lcid
), 0);
1962 return make_number (GetThreadLocale ());
1966 /* We need to build a global list, since the EnumCodePages callback
1967 function isn't given a context pointer. */
1968 Lisp_Object Vw32_valid_codepages
;
1970 BOOL CALLBACK
enum_codepage_fn (LPTSTR codepageNum
)
1972 DWORD id
= atoi (codepageNum
);
1973 Vw32_valid_codepages
= Fcons (make_number (id
), Vw32_valid_codepages
);
1977 DEFUN ("w32-get-valid-codepages", Fw32_get_valid_codepages
,
1978 Sw32_get_valid_codepages
, 0, 0, 0,
1979 doc
: /* Return list of all valid Windows codepages. */)
1982 Vw32_valid_codepages
= Qnil
;
1984 EnumSystemCodePages (enum_codepage_fn
, CP_SUPPORTED
);
1986 Vw32_valid_codepages
= Fnreverse (Vw32_valid_codepages
);
1987 return Vw32_valid_codepages
;
1991 DEFUN ("w32-get-console-codepage", Fw32_get_console_codepage
,
1992 Sw32_get_console_codepage
, 0, 0, 0,
1993 doc
: /* Return current Windows codepage for console input. */)
1996 return make_number (GetConsoleCP ());
2000 DEFUN ("w32-set-console-codepage", Fw32_set_console_codepage
,
2001 Sw32_set_console_codepage
, 1, 1, 0,
2002 doc
: /* Make Windows codepage CP be the current codepage setting for Emacs.
2003 The codepage setting affects keyboard input and display in tty mode.
2004 If successful, the new CP is returned, otherwise nil. */)
2010 if (!IsValidCodePage (XINT (cp
)))
2013 if (!SetConsoleCP (XINT (cp
)))
2016 return make_number (GetConsoleCP ());
2020 DEFUN ("w32-get-console-output-codepage", Fw32_get_console_output_codepage
,
2021 Sw32_get_console_output_codepage
, 0, 0, 0,
2022 doc
: /* Return current Windows codepage for console output. */)
2025 return make_number (GetConsoleOutputCP ());
2029 DEFUN ("w32-set-console-output-codepage", Fw32_set_console_output_codepage
,
2030 Sw32_set_console_output_codepage
, 1, 1, 0,
2031 doc
: /* Make Windows codepage CP be the current codepage setting for Emacs.
2032 The codepage setting affects keyboard input and display in tty mode.
2033 If successful, the new CP is returned, otherwise nil. */)
2039 if (!IsValidCodePage (XINT (cp
)))
2042 if (!SetConsoleOutputCP (XINT (cp
)))
2045 return make_number (GetConsoleOutputCP ());
2049 DEFUN ("w32-get-codepage-charset", Fw32_get_codepage_charset
,
2050 Sw32_get_codepage_charset
, 1, 1, 0,
2051 doc
: /* Return charset of codepage CP.
2052 Returns nil if the codepage is not valid. */)
2060 if (!IsValidCodePage (XINT (cp
)))
2063 if (TranslateCharsetInfo ((DWORD
*) XINT (cp
), &info
, TCI_SRCCODEPAGE
))
2064 return make_number (info
.ciCharset
);
2070 DEFUN ("w32-get-valid-keyboard-layouts", Fw32_get_valid_keyboard_layouts
,
2071 Sw32_get_valid_keyboard_layouts
, 0, 0, 0,
2072 doc
: /* Return list of Windows keyboard languages and layouts.
2073 The return value is a list of pairs of language id and layout id. */)
2076 int num_layouts
= GetKeyboardLayoutList (0, NULL
);
2077 HKL
* layouts
= (HKL
*) alloca (num_layouts
* sizeof (HKL
));
2078 Lisp_Object obj
= Qnil
;
2080 if (GetKeyboardLayoutList (num_layouts
, layouts
) == num_layouts
)
2082 while (--num_layouts
>= 0)
2084 DWORD kl
= (DWORD
) layouts
[num_layouts
];
2086 obj
= Fcons (Fcons (make_number (kl
& 0xffff),
2087 make_number ((kl
>> 16) & 0xffff)),
2096 DEFUN ("w32-get-keyboard-layout", Fw32_get_keyboard_layout
,
2097 Sw32_get_keyboard_layout
, 0, 0, 0,
2098 doc
: /* Return current Windows keyboard language and layout.
2099 The return value is the cons of the language id and the layout id. */)
2102 DWORD kl
= (DWORD
) GetKeyboardLayout (dwWindowsThreadId
);
2104 return Fcons (make_number (kl
& 0xffff),
2105 make_number ((kl
>> 16) & 0xffff));
2109 DEFUN ("w32-set-keyboard-layout", Fw32_set_keyboard_layout
,
2110 Sw32_set_keyboard_layout
, 1, 1, 0,
2111 doc
: /* Make LAYOUT be the current keyboard layout for Emacs.
2112 The keyboard layout setting affects interpretation of keyboard input.
2113 If successful, the new layout id is returned, otherwise nil. */)
2119 CHECK_CONS (layout
);
2120 CHECK_NUMBER_CAR (layout
);
2121 CHECK_NUMBER_CDR (layout
);
2123 kl
= (XINT (XCAR (layout
)) & 0xffff)
2124 | (XINT (XCDR (layout
)) << 16);
2126 /* Synchronize layout with input thread. */
2127 if (dwWindowsThreadId
)
2129 if (PostThreadMessage (dwWindowsThreadId
, WM_EMACS_SETKEYBOARDLAYOUT
,
2133 GetMessage (&msg
, NULL
, WM_EMACS_DONE
, WM_EMACS_DONE
);
2135 if (msg
.wParam
== 0)
2139 else if (!ActivateKeyboardLayout ((HKL
) kl
, 0))
2142 return Fw32_get_keyboard_layout ();
2148 Qhigh
= intern ("high");
2149 Qlow
= intern ("low");
2154 defsubr (&Sw32_has_winsock
);
2155 defsubr (&Sw32_unload_winsock
);
2157 defsubr (&Sw32_short_file_name
);
2158 defsubr (&Sw32_long_file_name
);
2159 defsubr (&Sw32_set_process_priority
);
2160 defsubr (&Sw32_get_locale_info
);
2161 defsubr (&Sw32_get_current_locale_id
);
2162 defsubr (&Sw32_get_default_locale_id
);
2163 defsubr (&Sw32_get_valid_locale_ids
);
2164 defsubr (&Sw32_set_current_locale
);
2166 defsubr (&Sw32_get_console_codepage
);
2167 defsubr (&Sw32_set_console_codepage
);
2168 defsubr (&Sw32_get_console_output_codepage
);
2169 defsubr (&Sw32_set_console_output_codepage
);
2170 defsubr (&Sw32_get_valid_codepages
);
2171 defsubr (&Sw32_get_codepage_charset
);
2173 defsubr (&Sw32_get_valid_keyboard_layouts
);
2174 defsubr (&Sw32_get_keyboard_layout
);
2175 defsubr (&Sw32_set_keyboard_layout
);
2177 DEFVAR_LISP ("w32-quote-process-args", &Vw32_quote_process_args
,
2178 doc
: /* Non-nil enables quoting of process arguments to ensure correct parsing.
2179 Because Windows does not directly pass argv arrays to child processes,
2180 programs have to reconstruct the argv array by parsing the command
2181 line string. For an argument to contain a space, it must be enclosed
2182 in double quotes or it will be parsed as multiple arguments.
2184 If the value is a character, that character will be used to escape any
2185 quote characters that appear, otherwise a suitable escape character
2186 will be chosen based on the type of the program. */);
2187 Vw32_quote_process_args
= Qt
;
2189 DEFVAR_LISP ("w32-start-process-show-window",
2190 &Vw32_start_process_show_window
,
2191 doc
: /* When nil, new child processes hide their windows.
2192 When non-nil, they show their window in the method of their choice.
2193 This variable doesn't affect GUI applications, which will never be hidden. */);
2194 Vw32_start_process_show_window
= Qnil
;
2196 DEFVAR_LISP ("w32-start-process-share-console",
2197 &Vw32_start_process_share_console
,
2198 doc
: /* When nil, new child processes are given a new console.
2199 When non-nil, they share the Emacs console; this has the limitation of
2200 allowing only one DOS subprocess to run at a time (whether started directly
2201 or indirectly by Emacs), and preventing Emacs from cleanly terminating the
2202 subprocess group, but may allow Emacs to interrupt a subprocess that doesn't
2203 otherwise respond to interrupts from Emacs. */);
2204 Vw32_start_process_share_console
= Qnil
;
2206 DEFVAR_LISP ("w32-start-process-inherit-error-mode",
2207 &Vw32_start_process_inherit_error_mode
,
2208 doc
: /* When nil, new child processes revert to the default error mode.
2209 When non-nil, they inherit their error mode setting from Emacs, which stops
2210 them blocking when trying to access unmounted drives etc. */);
2211 Vw32_start_process_inherit_error_mode
= Qt
;
2213 DEFVAR_INT ("w32-pipe-read-delay", &w32_pipe_read_delay
,
2214 doc
: /* Forced delay before reading subprocess output.
2215 This is done to improve the buffering of subprocess output, by
2216 avoiding the inefficiency of frequently reading small amounts of data.
2218 If positive, the value is the number of milliseconds to sleep before
2219 reading the subprocess output. If negative, the magnitude is the number
2220 of time slices to wait (effectively boosting the priority of the child
2221 process temporarily). A value of zero disables waiting entirely. */);
2222 w32_pipe_read_delay
= 50;
2224 DEFVAR_LISP ("w32-downcase-file-names", &Vw32_downcase_file_names
,
2225 doc
: /* Non-nil means convert all-upper case file names to lower case.
2226 This applies when performing completions and file name expansion.
2227 Note that the value of this setting also affects remote file names,
2228 so you probably don't want to set to non-nil if you use case-sensitive
2229 filesystems via ange-ftp. */);
2230 Vw32_downcase_file_names
= Qnil
;
2233 DEFVAR_LISP ("w32-generate-fake-inodes", &Vw32_generate_fake_inodes
,
2234 doc
: /* Non-nil means attempt to fake realistic inode values.
2235 This works by hashing the truename of files, and should detect
2236 aliasing between long and short (8.3 DOS) names, but can have
2237 false positives because of hash collisions. Note that determing
2238 the truename of a file can be slow. */);
2239 Vw32_generate_fake_inodes
= Qnil
;
2242 DEFVAR_LISP ("w32-get-true-file-attributes", &Vw32_get_true_file_attributes
,
2243 doc
: /* Non-nil means determine accurate link count in `file-attributes'.
2244 Note that this option is only useful for files on NTFS volumes, where hard links
2245 are supported. Moreover, it slows down `file-attributes' noticeably. */);
2246 Vw32_get_true_file_attributes
= Qt
;
2248 staticpro (&Vw32_valid_locale_ids
);
2249 staticpro (&Vw32_valid_codepages
);
2251 /* end of ntproc.c */
2253 /* arch-tag: 23d3a34c-06d2-48a1-833b-ac7609aa5250
2254 (do not change this comment) */