1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2016 Free Software
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or (at
11 your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #define INLINE EXTERN_INLINE
29 #include <sys/types.h>
33 #include <close-stream.h>
40 #include <sys/socket.h>
46 #if defined WINDOWSNT || defined HAVE_NTGUI
47 #include "w32select.h"
49 #include "w32common.h"
57 #include <binary-io.h>
61 #ifdef HAVE_LIBSYSTEMD
62 # include <systemd/sd-daemon.h>
63 # include <sys/socket.h>
66 #ifdef HAVE_WINDOW_SYSTEM
68 #endif /* HAVE_WINDOW_SYSTEM */
70 #include "intervals.h"
71 #include "character.h"
76 #include "blockinput.h"
77 #include "syssignal.h"
80 #include "termhooks.h"
85 #include "composite.h"
86 #include "dispextern.h"
90 #include "sysselect.h"
94 #include "getpagesize.h"
97 #if (defined PROFILING \
98 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
99 # include <sys/gmon.h>
100 extern void moncontrol (int mode
);
103 #ifdef HAVE_SETLOCALE
111 #ifdef HAVE_SETRLIMIT
112 #include <sys/time.h>
113 #include <sys/resource.h>
116 static const char emacs_version
[] = PACKAGE_VERSION
;
117 static const char emacs_copyright
[] = COPYRIGHT
;
118 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
120 /* Empty lisp strings. To avoid having to build any others. */
121 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
124 /* Cache for externally loaded libraries. */
125 Lisp_Object Vlibrary_cache
;
128 /* Set after Emacs has started up the first time.
129 Prevents reinitialization of the Lisp world and keymaps
130 on subsequent starts. */
133 /* Set to true if this instance of Emacs might dump. */
134 #ifndef DOUG_LEA_MALLOC
140 extern void unexec_init_emacs_zone (void);
143 /* If true, Emacs should not attempt to use a window-specific code,
144 but instead should use the virtual terminal under which it was started. */
145 bool inhibit_window_system
;
147 /* If true, a filter or a sentinel is running. Tested to save the match
148 data on the first attempt to change it inside asynchronous code. */
149 bool running_asynch_code
;
151 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
152 /* If true, -d was specified, meaning we're using some window system. */
156 /* An address near the bottom of the stack.
157 Tells GC how to save a copy of the stack. */
161 /* The gap between BSS end and heap start as far as we can tell. */
162 static uprintmax_t heap_bss_diff
;
165 /* To run as a background daemon under Cocoa or Windows,
166 we must do a fork+exec, not a simple fork.
168 On Cocoa, CoreFoundation lib fails in forked process:
169 http://developer.apple.com/ReleaseNotes/
170 CoreFoundation/CoreFoundation.html)
172 On Windows, a Cygwin fork child cannot access the USER subsystem.
174 We mark being in the exec'd process by a daemon name argument of
175 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
176 NAME is the original daemon name, if any. */
177 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
178 # define DAEMON_MUST_EXEC
181 /* True means running Emacs without interactive terminal. */
184 /* True means remove site-lisp directories from load-path. */
187 /* True means put details like time stamps into builds. */
190 /* Name for the server started by the daemon.*/
191 static char *daemon_name
;
193 /* 0 not a daemon, 1 new-style (foreground), 2 old-style (background). */
197 /* Pipe used to send exit notification to the background daemon parent at
198 startup. On Windows, we use a kernel event instead. */
201 HANDLE w32_daemon_event
;
204 /* Save argv and argc. */
208 static void sort_args (int argc
, char **argv
);
209 static void syms_of_emacs (void);
211 /* C99 needs each string to be at most 4095 characters, and the usage
212 strings below are split to not overflow this limit. */
213 static char const *const usage_message
[] =
216 Run Emacs, the extensible, customizable, self-documenting real-time\n\
217 display editor. The recommended way to start Emacs for normal editing\n\
218 is with no options at all.\n\
220 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
221 read the main documentation for these command-line arguments.\n\
223 Initialization options:\n\
227 --batch do not do interactive display; implies -q\n\
228 --chdir DIR change to directory DIR\n\
229 --daemon, --old-daemon[=NAME] start a (named) server in the background\n\
230 --new-daemon[=NAME] start a (named) server in the foreground\n\
231 --debug-init enable Emacs Lisp debugger for init file\n\
232 --display, -d DISPLAY use X server DISPLAY\n\
235 --no-build-details do not add build details such as time stamps\n\
236 --no-desktop do not load a saved desktop\n\
237 --no-init-file, -q load neither ~/.emacs nor default.el\n\
238 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
239 --no-site-file do not load site-start.el\n\
240 --no-x-resources do not load X resources\n\
241 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
242 --no-splash do not display a splash screen on startup\n\
243 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
246 --quick, -Q equivalent to:\n\
247 -q --no-site-file --no-site-lisp --no-splash\n\
249 --script FILE run FILE as an Emacs Lisp script\n\
250 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
251 --user, -u USER load ~USER/.emacs instead of your own\n\
257 FILE visit FILE using find-file\n\
258 +LINE go to line LINE in next FILE\n\
259 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
260 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
261 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
262 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
265 --file FILE visit FILE using find-file\n\
266 --find-file FILE visit FILE using find-file\n\
267 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
268 --insert FILE insert contents of FILE into current buffer\n\
269 --kill exit without asking for confirmation\n\
270 --load, -l FILE load Emacs Lisp FILE using the load function\n\
271 --visit FILE visit FILE using find-file\n\
277 --background-color, -bg COLOR window background color\n\
278 --basic-display, -D disable many display features;\n\
279 used for debugging Emacs\n\
280 --border-color, -bd COLOR main border color\n\
281 --border-width, -bw WIDTH width of main border\n\
284 --color, --color=MODE override color mode for character terminals;\n\
285 MODE defaults to `auto', and\n\
286 can also be `never', `always',\n\
287 or a mode name like `ansi8'\n\
288 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
289 --font, -fn FONT default font; must be fixed-width\n\
290 --foreground-color, -fg COLOR window foreground color\n\
293 --fullheight, -fh make the first frame high as the screen\n\
294 --fullscreen, -fs make the first frame fullscreen\n\
295 --fullwidth, -fw make the first frame wide as the screen\n\
296 --maximized, -mm make the first frame maximized\n\
297 --geometry, -g GEOMETRY window geometry\n\
300 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
301 --iconic start Emacs in iconified state\n\
302 --internal-border, -ib WIDTH width between text and main border\n\
303 --line-spacing, -lsp PIXELS additional space to put between lines\n\
304 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
305 --name NAME title for initial Emacs frame\n\
308 --no-blinking-cursor, -nbc disable blinking cursor\n\
309 --reverse-video, -r, -rv switch foreground and background\n\
310 --title, -T TITLE title for initial Emacs frame\n\
311 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
312 --xrm XRESOURCES set additional X resources\n\
313 --parent-id XID set parent window\n\
314 --help display this help and exit\n\
315 --version output version information and exit\n\
319 You can generally also specify long option names with a single -; for\n\
320 example, -batch as well as --batch. You can use any unambiguous\n\
321 abbreviation for a --option.\n\
323 Various environment variables and window system resources also affect\n\
324 the operation of Emacs. See the main documentation.\n\
326 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
327 section of the Emacs manual or the file BUGS.\n"
331 /* True if handling a fatal error already. */
332 bool fatal_error_in_progress
;
335 /* NS autrelease pool, for memory management. */
336 static void *ns_pool
;
341 setlocale (int cat
, char const *locale
)
347 /* True if the current system locale uses UTF-8 encoding. */
353 mbstate_t mbs
= { 0 };
354 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
361 /* Report a fatal error due to signal SIG, output a backtrace of at
362 most BACKTRACE_LIMIT lines, and exit. */
364 terminate_due_to_signal (int sig
, int backtrace_limit
)
366 signal (sig
, SIG_DFL
);
368 if (attempt_orderly_shutdown_on_fatal_signal
)
370 /* If fatal error occurs in code below, avoid infinite recursion. */
371 if (! fatal_error_in_progress
)
373 fatal_error_in_progress
= 1;
375 totally_unblock_input ();
376 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
377 Fkill_emacs (make_number (sig
));
379 shut_down_emacs (sig
, Qnil
);
380 emacs_backtrace (backtrace_limit
);
384 /* Signal the same code; this time it will really be fatal.
385 Since we're in a signal handler, the signal is blocked, so we
386 have to unblock it if we want to really receive it. */
390 sigemptyset (&unblocked
);
391 sigaddset (&unblocked
, sig
);
392 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
398 /* This shouldn't be executed, but it prevents a warning. */
402 /* Code for dealing with Lisp access to the Unix command line. */
405 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
408 Lisp_Object name
, dir
, handler
;
409 ptrdiff_t count
= SPECPDL_INDEX ();
410 Lisp_Object raw_name
;
411 AUTO_STRING (slash_colon
, "/:");
417 /* Must use argv[0] converted to UTF-8, as it begets many standard
418 file and directory names. */
420 char argv0
[MAX_UTF8_PATH
];
422 if (filename_from_ansi (argv
[0], argv0
) == 0)
423 raw_name
= build_unibyte_string (argv0
);
425 raw_name
= build_unibyte_string (argv
[0]);
428 raw_name
= build_unibyte_string (argv
[0]);
431 /* Add /: to the front of the name
432 if it would otherwise be treated as magic. */
433 handler
= Ffind_file_name_handler (raw_name
, Qt
);
434 if (! NILP (handler
))
435 raw_name
= concat2 (slash_colon
, raw_name
);
437 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
438 Vinvocation_directory
= Ffile_name_directory (raw_name
);
440 /* If we got no directory in argv[0], search PATH to find where
441 Emacs actually came from. */
442 if (NILP (Vinvocation_directory
))
445 int yes
= openp (Vexec_path
, Vinvocation_name
,
446 Vexec_suffixes
, &found
, make_number (X_OK
), false);
449 /* Add /: to the front of the name
450 if it would otherwise be treated as magic. */
451 handler
= Ffind_file_name_handler (found
, Qt
);
452 if (! NILP (handler
))
453 found
= concat2 (slash_colon
, found
);
454 Vinvocation_directory
= Ffile_name_directory (found
);
458 if (!NILP (Vinvocation_directory
)
459 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
460 /* Emacs was started with relative path, like ./emacs.
464 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
466 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
469 Vinstallation_directory
= Qnil
;
471 if (!NILP (Vinvocation_directory
))
473 dir
= Vinvocation_directory
;
475 /* If we are running from the build directory, set DIR to the
476 src subdirectory of the Emacs tree, like on Posix
478 if (SBYTES (dir
) > sizeof ("/i386/") - 1
479 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
481 dir
= Fexpand_file_name (build_string ("../.."), dir
);
482 #else /* !WINDOWSNT */
484 name
= Fexpand_file_name (Vinvocation_name
, dir
);
487 Lisp_Object tem
, lib_src_exists
;
488 Lisp_Object etc_exists
, info_exists
;
490 /* See if dir contains subdirs for use by Emacs.
491 Check for the ones that would exist in a build directory,
492 not including lisp and info. */
493 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
494 lib_src_exists
= Ffile_exists_p (tem
);
497 /* MSDOS installations frequently remove lib-src, but we still
498 must set installation-directory, or else info won't find
499 its files (it uses the value of installation-directory). */
500 tem
= Fexpand_file_name (build_string ("info"), dir
);
501 info_exists
= Ffile_exists_p (tem
);
506 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
508 tem
= Fexpand_file_name (build_string ("etc"), dir
);
509 etc_exists
= Ffile_exists_p (tem
);
510 if (!NILP (etc_exists
))
512 Vinstallation_directory
513 = Ffile_name_as_directory (dir
);
518 /* See if dir's parent contains those subdirs. */
519 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
520 lib_src_exists
= Ffile_exists_p (tem
);
524 /* See the MSDOS commentary above. */
525 tem
= Fexpand_file_name (build_string ("../info"), dir
);
526 info_exists
= Ffile_exists_p (tem
);
531 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
533 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
534 etc_exists
= Ffile_exists_p (tem
);
535 if (!NILP (etc_exists
))
537 tem
= Fexpand_file_name (build_string (".."), dir
);
538 Vinstallation_directory
539 = Ffile_name_as_directory (tem
);
544 /* If the Emacs executable is actually a link,
545 next try the dir that the link points into. */
546 tem
= Ffile_symlink_p (name
);
549 name
= Fexpand_file_name (tem
, dir
);
550 dir
= Ffile_name_directory (name
);
557 Vcommand_line_args
= Qnil
;
559 for (i
= argc
- 1; i
>= 0; i
--)
561 if (i
== 0 || i
> skip_args
)
562 /* For the moment, we keep arguments as is in unibyte strings.
563 They are decoded in the function command-line after we know
564 locale-coding-system. */
566 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
569 unbind_to (count
, Qnil
);
572 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
573 doc
: /* Return the program name that was used to run Emacs.
574 Any directory names are omitted. */)
577 return Fcopy_sequence (Vinvocation_name
);
580 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
582 doc
: /* Return the directory name in which the Emacs executable was located. */)
585 return Fcopy_sequence (Vinvocation_directory
);
589 /* Test whether the next argument in ARGV matches SSTR or a prefix of
590 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
591 (the argument is supposed to have a value) store in *VALPTR either
592 the next argument or the portion of this one after the equal sign.
593 ARGV is read starting at position *SKIPPTR; this index is advanced
594 by the number of arguments used.
596 Too bad we can't just use getopt for all of this, but we don't have
597 enough information to do it right. */
600 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
601 int minlen
, char **valptr
, int *skipptr
)
607 /* Don't access argv[argc]; give up in advance. */
608 if (argc
<= *skipptr
+ 1)
611 arg
= argv
[*skipptr
+1];
614 if (strcmp (arg
, sstr
) == 0)
618 *valptr
= argv
[*skipptr
+2];
625 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
626 ? p
- arg
: strlen (arg
));
627 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
629 else if (valptr
== NULL
)
640 else if (argv
[*skipptr
+2] != NULL
)
642 *valptr
= argv
[*skipptr
+2];
652 /* Close standard output and standard error, reporting any write
653 errors as best we can. This is intended for use with atexit. */
655 close_output_streams (void)
657 if (close_stream (stdout
) != 0)
659 emacs_perror ("Write error to standard output");
660 _exit (EXIT_FAILURE
);
663 if (close_stream (stderr
) != 0)
664 _exit (EXIT_FAILURE
);
669 main (int argc
, char **argv
)
672 char stack_bottom_variable
;
673 bool do_initial_setlocale
;
676 bool no_loadup
= false;
679 #ifdef DAEMON_MUST_EXEC
684 /* If we use --chdir, this records the original directory. */
685 char *original_pwd
= 0;
689 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
690 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
692 /* True if address randomization interferes with memory allocation. */
694 bool disable_aslr
= true;
696 bool disable_aslr
= dumping
;
699 if (disable_aslr
&& disable_address_randomization ())
701 /* Set this so the personality will be reverted before execs
703 xputenv ("EMACS_HEAP_EXEC=true");
705 /* Address randomization was enabled, but is now disabled.
706 Re-execute Emacs to get a clean slate. */
707 execvp (argv
[0], argv
);
709 /* If the exec fails, warn and then try anyway. */
714 might_dump
= !initialized
;
720 char *heap_start
= my_heap_start ();
721 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
725 #if defined WINDOWSNT || defined HAVE_NTGUI
726 /* Set global variables used to detect Windows version. Do this as
727 early as possible. (unexw32.c calls this function as well, but
728 the additional call here is harmless.) */
729 cache_system_info ();
731 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
732 to have non-stub implementations of APIs we need to convert file
733 names between UTF-8 and the system's ANSI codepage. */
734 maybe_load_unicows_dll ();
736 /* This has to be done before module_init is called below, so that
737 the latter could use the thread ID of the main thread. */
738 w32_init_main_thread ();
741 #ifdef RUN_TIME_REMAP
743 run_time_remap (argv
[0]);
746 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
749 unexec_init_emacs_zone ();
752 init_standard_fds ();
753 atexit (close_output_streams
);
759 sort_args (argc
, argv
);
761 while (argv
[argc
]) argc
++;
763 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
765 const char *version
, *copyright
;
768 Lisp_Object tem
, tem2
;
769 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
770 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
773 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
778 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
783 version
= SSDATA (tem
);
784 copyright
= SSDATA (tem2
);
789 version
= emacs_version
;
790 copyright
= emacs_copyright
;
792 printf ("%s %s\n", PACKAGE_NAME
, version
);
793 printf ("%s\n", copyright
);
794 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
795 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
796 printf ("under the terms of the GNU General Public License.\n");
797 printf ("For more information about these matters, ");
798 printf ("see the file named COPYING.\n");
802 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
805 /* argv[] array is kept in its original ANSI codepage encoding,
806 we need to convert to UTF-8, for chdir to work. */
807 char newdir
[MAX_UTF8_PATH
];
809 filename_from_ansi (ch_to_dir
, newdir
);
812 original_pwd
= emacs_get_current_dir_name ();
813 if (chdir (ch_to_dir
) != 0)
815 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
816 argv
[0], ch_to_dir
, strerror (errno
));
821 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
822 /* Extend the stack space available. Don't do that if dumping,
823 since some systems (e.g. DJGPP) might define a smaller stack
824 limit at that time. And it's not needed on Cygwin, since emacs
825 is built with an 8MB stack. Moreover, the setrlimit call can
826 cause problems on Cygwin
827 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
829 if (getrlimit (RLIMIT_STACK
, &rlim
) == 0
830 && 0 <= rlim
.rlim_cur
&& rlim
.rlim_cur
<= LONG_MAX
)
832 long lim
= rlim
.rlim_cur
;
834 /* Approximate the amount regex.c needs per unit of
835 re_max_failures, then add 33% to cover the size of the
836 smaller stacks that regex.c successively allocates and
837 discards on its way to the maximum. */
838 int ratio
= 20 * sizeof (char *);
841 /* Extra space to cover what we're likely to use for other reasons. */
844 bool try_to_grow_stack
= true;
846 try_to_grow_stack
= !noninteractive
|| initialized
;
849 if (try_to_grow_stack
)
851 long newlim
= re_max_failures
* ratio
+ extra
;
853 /* Round the new limit to a page boundary; this is needed
854 for Darwin kernel 15.4.0 (see Bug#23622) and perhaps
855 other systems. Do not shrink the stack and do not exceed
856 rlim_max. Don't worry about exact values of
857 RLIM_INFINITY etc. since in practice when they are
858 nonnegative they are so large that the code does the
859 right thing anyway. */
860 long pagesize
= getpagesize ();
861 newlim
+= pagesize
- 1;
862 if (0 <= rlim
.rlim_max
&& rlim
.rlim_max
< newlim
)
863 newlim
= rlim
.rlim_max
;
864 newlim
-= newlim
% pagesize
;
866 if (pagesize
<= newlim
- lim
)
868 rlim
.rlim_cur
= newlim
;
869 if (setrlimit (RLIMIT_STACK
, &rlim
) == 0)
874 /* Don't let regex.c overflow the stack. */
875 re_max_failures
= lim
< extra
? 0 : min (lim
- extra
, SIZE_MAX
) / ratio
;
877 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
879 /* Record (approximately) where the stack begins. */
880 stack_bottom
= &stack_bottom_variable
;
884 emacs_backtrace (-1);
886 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
887 /* Arrange to get warning messages as memory fills up. */
888 memory_warnings (0, malloc_warning
);
890 /* Call malloc at least once, to run malloc_initialize_hook.
891 Also call realloc and free for consistency. */
892 free (realloc (malloc (4), 4));
894 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
897 SET_BINARY (fileno (stdin
));
899 SET_BINARY (fileno (stdout
));
902 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
903 The build procedure uses this while dumping, to ensure that the
904 dumped Emacs does not have its system locale tables initialized,
905 as that might cause screwups when the dumped Emacs starts up. */
907 char *lc_all
= getenv ("LC_ALL");
908 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
911 /* Set locale now, so that initial error messages are localized properly.
912 fixup_locale must wait until later, since it builds strings. */
913 if (do_initial_setlocale
)
914 setlocale (LC_ALL
, "");
915 text_quoting_flag
= using_utf8 ();
917 inhibit_window_system
= 0;
919 /* Handle the -t switch, which specifies filename to use as terminal. */
923 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
925 emacs_close (STDIN_FILENO
);
926 emacs_close (STDOUT_FILENO
);
927 int result
= emacs_open (term
, O_RDWR
, 0);
928 if (result
!= STDIN_FILENO
929 || (fcntl (STDIN_FILENO
, F_DUPFD_CLOEXEC
, STDOUT_FILENO
)
932 char *errstring
= strerror (errno
);
933 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
936 if (! isatty (STDIN_FILENO
))
938 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
941 fprintf (stderr
, "Using %s\n", term
);
942 #ifdef HAVE_WINDOW_SYSTEM
943 inhibit_window_system
= true; /* -t => -nw */
950 /* Command line option --no-windows is deprecated and thus not mentioned
951 in the manual and usage information. */
952 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
953 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
954 inhibit_window_system
= 1;
956 /* Handle the -batch switch, which means don't do interactive display. */
958 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
961 Vundo_outer_limit
= Qnil
;
963 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
965 noninteractive
= 1; /* Set batch mode. */
966 /* Convert --script to -scriptload, un-skip it, and sort again
967 so that it will be handled in proper sequence. */
968 /* FIXME broken for --script=FILE - is that supposed to work? */
969 argv
[skip_args
- 1] = (char *) "-scriptload";
971 sort_args (argc
, argv
);
974 /* Handle the --help option, which gives a usage message. */
975 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
978 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
979 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
980 fputs (usage_message
[i
], stdout
);
987 /* Make sure IS_DAEMON starts up as false. */
990 w32_daemon_event
= NULL
;
996 if (argmatch (argv
, argc
, "-new-daemon", "--new-daemon", 10, NULL
, &skip_args
)
997 || argmatch (argv
, argc
, "-new-daemon", "--new-daemon", 10, &dname_arg
, &skip_args
))
999 daemon_type
= 1; /* foreground */
1001 else if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1002 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
)
1003 || argmatch (argv
, argc
, "-old-daemon", "--old-daemon", 10, NULL
, &skip_args
)
1004 || argmatch (argv
, argc
, "-old-daemon", "--old-daemon", 10, &dname_arg
, &skip_args
))
1006 daemon_type
= 2; /* background */
1010 if (daemon_type
> 0)
1013 if (daemon_type
== 2)
1015 /* Start as a background daemon: fork a new child process which
1016 will run the rest of the initialization code, then exit.
1018 Detaching a daemon requires the following steps:
1022 - close the tty file-descriptors
1024 We only want to do the last 2 steps once the daemon is ready to
1025 serve requests, i.e. after loading .emacs (initialization).
1026 OTOH initialization may start subprocesses (e.g. ispell) and these
1027 should be run from the proper process (the one that will end up
1028 running as daemon) and with the proper "session id" in order for
1029 them to keep working after detaching, so fork and setsid need to be
1030 performed before initialization.
1032 We want to avoid exiting before the server socket is ready, so
1033 use a pipe for synchronization. The parent waits for the child
1034 to close its end of the pipe (using `daemon-initialized')
1036 if (emacs_pipe (daemon_pipe
) != 0)
1038 fprintf (stderr
, "Cannot pipe!\n");
1041 } /* daemon_type == 2 */
1043 #ifdef HAVE_LIBSYSTEMD
1044 /* Read the number of sockets passed through by systemd. */
1045 int systemd_socket
= sd_listen_fds (1);
1047 if (systemd_socket
> 1)
1050 "Warning: systemd passed more than one socket to Emacs.\n"
1051 "Try 'Accept=false' in the Emacs socket unit file.\n"));
1052 else if (systemd_socket
== 1
1053 && (0 < sd_is_socket (SD_LISTEN_FDS_START
,
1054 AF_UNSPEC
, SOCK_STREAM
, 1)))
1055 sockfd
= SD_LISTEN_FDS_START
;
1056 #endif /* HAVE_LIBSYSTEMD */
1059 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1060 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1061 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1062 #endif /* USE_GTK */
1064 if (daemon_type
== 2)
1067 #ifndef DAEMON_MUST_EXEC
1070 #else /* DAEMON_MUST_EXEC */
1071 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1072 f
= fork (); /* in orig */
1074 f
= 0; /* in exec'd */
1075 #endif /* !DAEMON_MUST_EXEC */
1081 /* Close unused writing end of the pipe. */
1082 emacs_close (daemon_pipe
[1]);
1084 /* Just wait for the child to close its end of the pipe. */
1087 retval
= read (daemon_pipe
[0], &buf
, 1);
1089 while (retval
== -1 && errno
== EINTR
);
1093 fprintf (stderr
, "Error reading status from child\n");
1096 else if (retval
== 0)
1098 fprintf (stderr
, "Error: server did not start correctly\n");
1102 emacs_close (daemon_pipe
[0]);
1107 emacs_perror ("fork");
1108 exit (EXIT_CANCELED
);
1111 #ifdef DAEMON_MUST_EXEC
1113 /* In orig process, forked as child, OR in exec'd. */
1114 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1115 { /* In orig, child: now exec w/special daemon name. */
1118 snprintf (fdStr
, sizeof fdStr
,
1119 "--old-daemon=\n%d,%d\n%s", daemon_pipe
[0],
1120 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1122 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1124 fprintf (stderr
, "daemon: child name too long\n");
1125 exit (EXIT_CANNOT_INVOKE
);
1128 argv
[skip_args
] = fdStr
;
1130 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1131 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1132 execvp (argv
[0], argv
);
1133 emacs_perror (argv
[0]);
1134 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1137 /* In exec'd: parse special dname into pipe and name info. */
1138 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1139 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1141 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1142 exit (EXIT_CANNOT_INVOKE
);
1144 dname_arg2
[0] = '\0';
1145 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1147 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1148 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1150 #endif /* DAEMON_MUST_EXEC */
1152 /* Close unused reading end of the pipe. */
1153 emacs_close (daemon_pipe
[0]);
1156 } /* daemon_type == 2 */
1157 #elif defined(WINDOWSNT)
1158 /* Indicate that we want daemon mode. */
1159 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1160 if (w32_daemon_event
== NULL
)
1162 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1167 fprintf (stderr
, "This platform does not support daemon mode.\n");
1171 daemon_name
= xstrdup (dname_arg
);
1174 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1175 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1176 # ifndef CANNOT_DUMP
1177 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1178 that causes an infinite recursive loop with FreeBSD. See
1179 Bug#14569. The part of this bug involving Cygwin is no longer
1180 relevant, now that Cygwin defines HYBRID_MALLOC. */
1181 if (!noninteractive
|| initialized
)
1183 malloc_enable_thread ();
1186 init_signals (dumping
);
1188 noninteractive1
= noninteractive
;
1190 /* Perform basic initializations (not merely interning symbols). */
1197 init_charset_once ();
1198 init_coding_once ();
1199 init_syntax_once (); /* Create standard syntax table. */
1200 init_category_once (); /* Create standard category table. */
1201 init_casetab_once (); /* Must be done before init_buffer_once. */
1202 init_buffer_once (); /* Create buffer table and some buffers. */
1203 init_minibuf_once (); /* Create list of minibuffers. */
1204 /* Must precede init_window_once. */
1206 /* Call syms_of_xfaces before init_window_once because that
1207 function creates Vterminal_frame. Termcap frames now use
1208 faces, and the face implementation uses some symbols as
1211 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1212 be better to arrange things not to have this dependency. */
1214 /* Call syms_of_keyboard before init_window_once because
1215 keyboard sets up symbols that include some face names that
1216 the X support will want to use. This can happen when
1217 CANNOT_DUMP is defined. */
1218 syms_of_keyboard ();
1220 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1222 syms_of_fns (); /* Before syms_of_charset which uses hash tables. */
1224 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1226 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1228 /* Before syms_of_coding because it initializes Qcharsetp. */
1230 /* Before init_window_once, because it sets up the
1231 Vcoding_system_hash_table. */
1232 syms_of_coding (); /* This should be after syms_of_fileio. */
1234 init_window_once (); /* Init the window system. */
1235 #ifdef HAVE_WINDOW_SYSTEM
1236 init_fringe_once (); /* Swap bitmaps if necessary. */
1237 #endif /* HAVE_WINDOW_SYSTEM */
1242 if (do_initial_setlocale
)
1245 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1246 Vsystem_time_locale
= Vprevious_system_time_locale
;
1251 running_asynch_code
= 0;
1255 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1258 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1260 build_details
= ! argmatch (argv
, argc
, "-no-build-details",
1261 "--no-build-details", 7, NULL
, &skip_args
);
1264 ns_pool
= ns_alloc_autorelease_pool ();
1265 #ifdef NS_IMPL_GNUSTEP
1266 /* GNUstep stupidly resets our locale settings after we made them. */
1270 if (!noninteractive
)
1272 #ifdef NS_IMPL_COCOA
1273 /* Started from GUI? */
1274 /* FIXME: Do the right thing if getenv returns NULL, or if
1276 if (! inhibit_window_system
&& ! isatty (STDIN_FILENO
) && ! ch_to_dir
)
1277 chdir (getenv ("HOME"));
1278 if (skip_args
< argc
)
1280 if (!strncmp (argv
[skip_args
], "-psn", 4))
1283 if (! ch_to_dir
) chdir (getenv ("HOME"));
1285 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1288 if (! ch_to_dir
) chdir (getenv ("HOME"));
1293 #endif /* HAVE_NS */
1295 #ifdef HAVE_X_WINDOWS
1296 /* Stupid kludge to catch command-line display spec. We can't
1297 handle this argument entirely in window system dependent code
1298 because we don't even know which window system dependent code
1299 to run until we've recognized this argument. */
1301 char *displayname
= 0;
1302 int count_before
= skip_args
;
1304 /* Skip any number of -d options, but only use the last one. */
1307 int count_before_this
= skip_args
;
1309 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1311 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1316 count_before
= count_before_this
;
1319 /* If we have the form --display=NAME,
1320 convert it into -d name.
1321 This requires inserting a new element into argv. */
1322 if (displayname
&& count_before
< skip_args
)
1324 if (skip_args
== count_before
+ 1)
1326 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1327 (argc
- (count_before
+ 2)) * sizeof *argv
);
1328 argv
[count_before
+ 2] = displayname
;
1331 argv
[count_before
+ 1] = (char *) "-d";
1336 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1337 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1341 /* Don't actually discard this arg. */
1342 skip_args
= count_before
;
1344 #else /* !HAVE_X_WINDOWS */
1347 int count_before
= skip_args
;
1349 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1350 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1353 skip_args
= count_before
;
1357 /* argmatch must not be used after here,
1358 except when building temacs
1359 because the -d argument has not been skipped in skip_args. */
1362 /* Call early 'cause init_environment needs it. */
1364 /* Set defaults for several environment variables. */
1366 init_environment (argc
, argv
, skip_args
);
1372 globals_of_kqueue ();
1375 #ifdef HAVE_GFILENOTIFY
1376 globals_of_gfilenotify ();
1380 /* Initialize the locale from user defaults. */
1384 /* Initialize and GC-protect Vinitial_environment and
1385 Vprocess_environment before set_initial_environment fills them
1388 syms_of_callproc ();
1389 /* egetenv is a pretty low-level facility, which may get called in
1390 many circumstances; it seems flimsy to put off initializing it
1391 until calling init_callproc. Do not do it when dumping. */
1393 set_initial_environment ();
1397 #ifdef HAVE_W32NOTIFY
1398 globals_of_w32notify ();
1400 /* Initialize environment from registry settings. Make sure to do
1401 this only after calling set_initial_environment so that
1402 Vinitial_environment and Vprocess_environment will contain only
1403 variables from the parent process without modifications from
1405 init_environment (argv
);
1406 init_ntproc (dumping
); /* must precede init_editfns. */
1409 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1410 if this is not done. Do it after set_global_environment so that we
1411 don't pollute Vglobal_environment. */
1412 /* Setting LANG here will defeat the startup locale processing... */
1417 /* Init buffer storage and default directory of main buffer. */
1418 init_buffer (initialized
);
1420 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1422 /* Must precede init_lread. */
1423 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1427 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1428 Lisp_Object old_log_max
;
1429 old_log_max
= Vmessage_log_max
;
1430 XSETFASTINT (Vmessage_log_max
, 0);
1431 message_dolog ("", 0, 1, 0);
1432 Vmessage_log_max
= old_log_max
;
1435 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1439 /* Check to see if Emacs has been installed correctly. */
1440 check_windows_init_file ();
1443 /* Intern the names of all standard functions and variables;
1444 define standard keys. */
1448 /* The basic levels of Lisp must come first. Note that
1449 syms_of_data and some others have already been called. */
1454 syms_of_floatfns ();
1457 syms_of_bytecode ();
1459 syms_of_casefiddle ();
1461 syms_of_category ();
1463 syms_of_character ();
1470 syms_of_filelock ();
1473 /* syms_of_keymap (); */
1481 syms_of_terminal ();
1492 syms_of_textprop ();
1493 syms_of_composite ();
1496 #endif /* WINDOWSNT */
1503 #ifdef HAVE_WINDOW_SYSTEM
1506 #endif /* HAVE_WINDOW_SYSTEM */
1507 #ifdef HAVE_X_WINDOWS
1513 syms_of_xsettings ();
1520 #endif /* HAVE_X_WINDOWS */
1527 syms_of_decompress ();
1537 #endif /* HAVE_NTGUI */
1539 #if defined WINDOWSNT || defined HAVE_NTGUI
1540 syms_of_w32select ();
1547 syms_of_win16select ();
1554 syms_of_nsselect ();
1556 #endif /* HAVE_NS */
1562 #endif /* HAVE_INOTIFY */
1566 #endif /* HAVE_KQUEUE */
1568 #ifdef HAVE_GFILENOTIFY
1569 syms_of_gfilenotify ();
1570 #endif /* HAVE_GFILENOTIFY */
1573 syms_of_dbusbind ();
1574 #endif /* HAVE_DBUS */
1578 #ifdef HAVE_W32NOTIFY
1579 syms_of_w32notify ();
1580 #endif /* HAVE_W32NOTIFY */
1581 #endif /* WINDOWSNT */
1583 syms_of_profiler ();
1585 keys_of_casefiddle ();
1588 keys_of_keyboard ();
1594 /* Initialization that must be done even if the global variable
1595 initialized is non zero. */
1597 globals_of_w32font ();
1598 globals_of_w32fns ();
1599 globals_of_w32menu ();
1600 #endif /* HAVE_NTGUI */
1602 #if defined WINDOWSNT || defined HAVE_NTGUI
1603 globals_of_w32select ();
1609 /* This calls putenv and so must precede init_process_emacs. Also,
1610 it sets Voperating_system_release, which init_process_emacs uses. */
1611 init_editfns (dumping
);
1613 /* These two call putenv. */
1621 /* This can create a thread that may call getenv, so it must follow
1622 all calls to putenv and setenv. Also, this sets up
1623 add_keyboard_wait_descriptor, which init_display uses. */
1624 init_process_emacs (sockfd
);
1626 init_keyboard (); /* This too must precede init_sys_modes. */
1627 if (!noninteractive
)
1628 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1631 init_crit (); /* w32notify.c needs this in batch mode. */
1632 #endif /* HAVE_W32NOTIFY */
1634 #ifdef HAVE_WINDOW_SYSTEM
1636 #endif /* HAVE_WINDOW_SYSTEM */
1644 /* Handle -l loadup, args passed by Makefile. */
1645 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1648 char file_utf8
[MAX_UTF8_PATH
];
1650 if (filename_from_ansi (file
, file_utf8
) == 0)
1653 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1655 /* Unless next switch is -nl, load "loadup.el" first thing. */
1657 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1660 /* Set up for profiling. This is known to work on FreeBSD,
1661 GNU/Linux and MinGW. It might work on some other systems too.
1662 Give it a try and tell us if it works on your system. To compile
1663 for profiling, use the configure option --enable-profiling. */
1664 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1669 extern unsigned char etext
asm ("etext");
1675 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1684 /* Enter editor command loop. This never returns. */
1690 /* Sort the args so we can find the most important ones
1691 at the beginning of argv. */
1693 /* First, here's a table of all the standard options. */
1695 struct standard_args
1698 const char *longname
;
1703 static const struct standard_args standard_args
[] =
1705 { "-version", "--version", 150, 0 },
1706 { "-chdir", "--chdir", 130, 1 },
1707 { "-t", "--terminal", 120, 1 },
1708 { "-nw", "--no-window-system", 110, 0 },
1709 { "-nw", "--no-windows", 110, 0 },
1710 { "-batch", "--batch", 100, 0 },
1711 { "-script", "--script", 100, 1 },
1712 { "-daemon", "--daemon", 99, 0 },
1713 { "-old-daemon", "--old-daemon", 99, 0 },
1714 { "-new-daemon", "--new-daemon", 99, 0 },
1715 { "-help", "--help", 90, 0 },
1716 { "-nl", "--no-loadup", 70, 0 },
1717 { "-nsl", "--no-site-lisp", 65, 0 },
1718 { "-no-build-details", "--no-build-details", 63, 0 },
1719 /* -d must come last before the options handled in startup.el. */
1720 { "-d", "--display", 60, 1 },
1721 { "-display", 0, 60, 1 },
1722 /* Now for the options handled in `command-line' (startup.el). */
1723 /* (Note that to imply -nsl, -Q is partially handled here.) */
1724 { "-Q", "--quick", 55, 0 },
1725 { "-quick", 0, 55, 0 },
1726 { "-q", "--no-init-file", 50, 0 },
1727 { "-no-init-file", 0, 50, 0 },
1728 { "-no-x-resources", "--no-x-resources", 40, 0 },
1729 { "-no-site-file", "--no-site-file", 40, 0 },
1730 { "-u", "--user", 30, 1 },
1731 { "-user", 0, 30, 1 },
1732 { "-debug-init", "--debug-init", 20, 0 },
1733 { "-iconic", "--iconic", 15, 0 },
1734 { "-D", "--basic-display", 12, 0},
1735 { "-basic-display", 0, 12, 0},
1736 { "-nbc", "--no-blinking-cursor", 12, 0 },
1737 /* Now for the options handled in `command-line-1' (startup.el). */
1738 { "-nbi", "--no-bitmap-icon", 10, 0 },
1739 { "-bg", "--background-color", 10, 1 },
1740 { "-background", 0, 10, 1 },
1741 { "-fg", "--foreground-color", 10, 1 },
1742 { "-foreground", 0, 10, 1 },
1743 { "-bd", "--border-color", 10, 1 },
1744 { "-bw", "--border-width", 10, 1 },
1745 { "-ib", "--internal-border", 10, 1 },
1746 { "-ms", "--mouse-color", 10, 1 },
1747 { "-cr", "--cursor-color", 10, 1 },
1748 { "-fn", "--font", 10, 1 },
1749 { "-font", 0, 10, 1 },
1750 { "-fs", "--fullscreen", 10, 0 },
1751 { "-fw", "--fullwidth", 10, 0 },
1752 { "-fh", "--fullheight", 10, 0 },
1753 { "-mm", "--maximized", 10, 0 },
1754 { "-g", "--geometry", 10, 1 },
1755 { "-geometry", 0, 10, 1 },
1756 { "-T", "--title", 10, 1 },
1757 { "-title", 0, 10, 1 },
1758 { "-name", "--name", 10, 1 },
1759 { "-xrm", "--xrm", 10, 1 },
1760 { "-parent-id", "--parent-id", 10, 1 },
1761 { "-r", "--reverse-video", 5, 0 },
1763 { "-reverse", 0, 5, 0 },
1764 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1765 { "-vb", "--vertical-scroll-bars", 5, 0 },
1766 { "-color", "--color", 5, 0},
1767 { "-no-splash", "--no-splash", 3, 0 },
1768 { "-no-desktop", "--no-desktop", 3, 0 },
1770 { "-NSAutoLaunch", 0, 5, 1 },
1771 { "-NXAutoLaunch", 0, 5, 1 },
1772 { "-_NSMachLaunch", 0, 85, 1 },
1773 { "-MachLaunch", 0, 85, 1 },
1774 { "-macosx", 0, 85, 0 },
1775 { "-NSHost", 0, 85, 1 },
1777 /* These have the same priority as ordinary file name args,
1778 so they are not reordered with respect to those. */
1779 { "-L", "--directory", 0, 1 },
1780 { "-directory", 0, 0, 1 },
1781 { "-l", "--load", 0, 1 },
1782 { "-load", 0, 0, 1 },
1783 /* This has no longname, because using --scriptload confuses sort_args,
1784 because then the --script long option seems to match twice; ie
1785 you can't have a long option which is a prefix of another long
1786 option. In any case, this is entirely an internal option. */
1787 { "-scriptload", NULL
, 0, 1 },
1788 { "-f", "--funcall", 0, 1 },
1789 { "-funcall", 0, 0, 1 },
1790 { "-eval", "--eval", 0, 1 },
1791 { "-execute", "--execute", 0, 1 },
1792 { "-find-file", "--find-file", 0, 1 },
1793 { "-visit", "--visit", 0, 1 },
1794 { "-file", "--file", 0, 1 },
1795 { "-insert", "--insert", 0, 1 },
1797 { "-NXOpen", 0, 0, 1 },
1798 { "-NXOpenTemp", 0, 0, 1 },
1799 { "-NSOpen", 0, 0, 1 },
1800 { "-NSOpenTemp", 0, 0, 1 },
1801 { "-GSFilePath", 0, 0, 1 },
1803 /* This should be processed after ordinary file name args and the like. */
1804 { "-kill", "--kill", -10, 0 },
1807 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1808 so that the highest priority ones come first.
1809 Do not change the order of elements of equal priority.
1810 If an option takes an argument, keep it and its argument together.
1812 If an option that takes no argument appears more
1813 than once, eliminate all but one copy of it. */
1816 sort_args (int argc
, char **argv
)
1818 char **new = xmalloc (argc
* sizeof *new);
1819 /* For each element of argv,
1820 the corresponding element of options is:
1821 0 for an option that takes no arguments,
1822 1 for an option that takes one argument, etc.
1823 -1 for an ordinary non-option argument. */
1824 int *options
= xnmalloc (argc
, sizeof *options
);
1825 int *priority
= xnmalloc (argc
, sizeof *priority
);
1827 int incoming_used
= 1;
1831 /* Categorize all the options,
1832 and figure out which argv elts are option arguments. */
1833 for (from
= 1; from
< argc
; from
++)
1837 if (argv
[from
][0] == '-')
1841 /* If we have found "--", don't consider
1842 any more arguments as options. */
1843 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1845 /* Leave the "--", and everything following it, at the end. */
1846 for (; from
< argc
; from
++)
1848 priority
[from
] = -100;
1854 /* Look for a match with a known old-fashioned option. */
1855 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1856 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1858 options
[from
] = standard_args
[i
].nargs
;
1859 priority
[from
] = standard_args
[i
].priority
;
1860 if (from
+ standard_args
[i
].nargs
>= argc
)
1861 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1862 from
+= standard_args
[i
].nargs
;
1866 /* Look for a match with a known long option.
1867 MATCH is -1 if no match so far, -2 if two or more matches so far,
1868 >= 0 (the table index of the match) if just one match so far. */
1869 if (argv
[from
][1] == '-')
1871 char const *equals
= strchr (argv
[from
], '=');
1873 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1877 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1878 if (standard_args
[i
].longname
1879 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1888 /* If we found exactly one match, use that. */
1891 options
[from
] = standard_args
[match
].nargs
;
1892 priority
[from
] = standard_args
[match
].priority
;
1893 /* If --OPTION=VALUE syntax is used,
1894 this option uses just one argv element. */
1897 if (from
+ options
[from
] >= argc
)
1898 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1899 from
+= options
[from
];
1901 else if (match
== -2)
1903 /* This is an internal error.
1904 Eg if one long option is a prefix of another. */
1905 fprintf (stderr
, "Option '%s' matched multiple standard arguments\n", argv
[from
]);
1907 /* Should we not also warn if there was no match? */
1913 /* Copy the arguments, in order of decreasing priority, to NEW. */
1915 while (incoming_used
< argc
)
1918 int best_priority
= -9999;
1920 /* Find the highest priority remaining option.
1921 If several have equal priority, take the first of them. */
1922 for (from
= 1; from
< argc
; from
++)
1924 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1926 best_priority
= priority
[from
];
1929 /* Skip option arguments--they are tied to the options. */
1930 if (options
[from
] > 0)
1931 from
+= options
[from
];
1937 /* Copy the highest priority remaining option, with its args, to NEW.
1938 Unless it is a duplicate of the previous one. */
1939 if (! (options
[best
] == 0
1940 && ! strcmp (new[to
- 1], argv
[best
])))
1942 new[to
++] = argv
[best
];
1943 for (i
= 0; i
< options
[best
]; i
++)
1944 new[to
++] = argv
[best
+ i
+ 1];
1947 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1949 /* Clear out this option in ARGV. */
1951 for (i
= 0; i
< options
[best
]; i
++)
1952 argv
[best
+ i
+ 1] = 0;
1955 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1959 memcpy (argv
, new, sizeof (char *) * argc
);
1966 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1967 doc
: /* Exit the Emacs job and kill it.
1968 If ARG is an integer, return ARG as the exit program code.
1969 If ARG is a string, stuff it as keyboard input.
1971 This function is called upon receipt of the signals SIGTERM
1972 or SIGHUP, and upon SIGINT in batch mode.
1974 The value of `kill-emacs-hook', if not void,
1975 is a list of functions (of no args),
1976 all of which are called before Emacs is actually killed. */
1977 attributes
: noreturn
)
1982 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1984 waiting_for_input
= 0;
1985 run_hook (Qkill_emacs_hook
);
1987 #ifdef HAVE_X_WINDOWS
1988 /* Transfer any clipboards we own to the clipboard manager. */
1989 x_clipboard_manager_save_all ();
1992 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1995 ns_release_autorelease_pool (ns_pool
);
1998 /* If we have an auto-save list file,
1999 kill it because we are exiting Emacs deliberately (not crashing).
2000 Do it after shut_down_emacs, which does an auto-save. */
2001 if (STRINGP (Vauto_save_list_file_name
))
2003 Lisp_Object listfile
;
2004 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
2005 unlink (SSDATA (listfile
));
2009 exit_code
= (XINT (arg
) < 0
2010 ? XINT (arg
) | INT_MIN
2011 : XINT (arg
) & INT_MAX
);
2013 exit_code
= EXIT_SUCCESS
;
2018 /* Perform an orderly shutdown of Emacs. Autosave any modified
2019 buffers, kill any child processes, clean up the terminal modes (if
2020 we're in the foreground), and other stuff like that. Don't perform
2021 any redisplay; this may be called when Emacs is shutting down in
2022 the background, or after its X connection has died.
2024 If SIG is a signal number, print a message for it.
2026 This is called by fatal signal handlers, X protocol error handlers,
2030 shut_down_emacs (int sig
, Lisp_Object stuff
)
2032 /* Prevent running of hooks from now on. */
2035 /* Don't update display from now on. */
2036 Vinhibit_redisplay
= Qt
;
2038 /* If we are controlling the terminal, reset terminal modes. */
2041 pid_t pgrp
= getpgrp ();
2042 pid_t tpgrp
= tcgetpgrp (0);
2043 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2045 reset_all_sys_modes ();
2046 if (sig
&& sig
!= SIGTERM
)
2048 static char const format
[] = "Fatal error %d: ";
2049 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2050 int buflen
= sprintf (buf
, format
, sig
);
2051 char const *sig_desc
= safe_strsignal (sig
);
2052 emacs_write (STDERR_FILENO
, buf
, buflen
);
2053 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2059 reset_all_sys_modes ();
2062 stuff_buffered_input (stuff
);
2064 inhibit_sentinels
= 1;
2065 kill_buffer_processes (Qnil
);
2066 Fdo_auto_save (Qt
, Qnil
);
2068 unlock_all_files ();
2070 /* There is a tendency for a SIGIO signal to arrive within exit,
2071 and cause a SIGHUP because the input descriptor is already closed. */
2074 /* Do this only if terminating normally, we want glyph matrices
2075 etc. in a core dump. */
2076 if (sig
== 0 || sig
== SIGTERM
)
2078 check_glyph_memory ();
2079 check_message_stack ();
2087 ns_term_shutdown (sig
);
2091 xml_cleanup_parser ();
2105 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2106 doc
: /* Dump current state of Emacs into executable file FILENAME.
2107 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2108 This is used in the file `loadup.el' when building Emacs.
2110 You must run Emacs in batch mode in order to dump it. */)
2111 (Lisp_Object filename
, Lisp_Object symfile
)
2115 ptrdiff_t count
= SPECPDL_INDEX ();
2119 if (! noninteractive
)
2120 error ("Dumping Emacs works only in batch mode");
2123 error ("Emacs can be dumped only once");
2127 /* Warn if the gap between BSS end and heap start is larger than this. */
2128 # define MAX_HEAP_BSS_DIFF (1024*1024)
2130 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2132 fprintf (stderr
, "**************************************************\n");
2133 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2134 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2136 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2137 fprintf (stderr
, "fail because of this. See the section about\n");
2138 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2139 fprintf (stderr
, "**************************************************\n");
2141 #endif /* GNU_LINUX */
2143 /* Bind `command-line-processed' to nil before dumping,
2144 so that the dumped Emacs will process its command line
2145 and set up to work with X windows if appropriate. */
2146 symbol
= intern ("command-line-processed");
2147 specbind (symbol
, Qnil
);
2149 CHECK_STRING (filename
);
2150 filename
= Fexpand_file_name (filename
, Qnil
);
2151 filename
= ENCODE_FILE (filename
);
2152 if (!NILP (symfile
))
2154 CHECK_STRING (symfile
);
2155 if (SCHARS (symfile
))
2157 symfile
= Fexpand_file_name (symfile
, Qnil
);
2158 symfile
= ENCODE_FILE (symfile
);
2163 Vpurify_flag
= Qnil
;
2165 #ifdef HYBRID_MALLOC
2167 static char const fmt
[] = "%d of %d static heap bytes used";
2168 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2169 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2170 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2171 /* Don't log messages, because at this point buffers cannot be created. */
2172 message1_nolog (buf
);
2177 /* Tell malloc where start of impure now is. */
2178 /* Also arrange for warnings when nearly out of space. */
2179 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2181 /* On Windows, this was done before dumping, and that once suffices.
2182 Meanwhile, my_edata is not valid on Windows. */
2183 memory_warnings (my_edata
, malloc_warning
);
2184 #endif /* not WINDOWSNT */
2185 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2187 alloc_unexec_pre ();
2189 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2191 alloc_unexec_post ();
2194 Vlibrary_cache
= Qnil
;
2196 #ifdef HAVE_WINDOW_SYSTEM
2197 reset_image_types ();
2202 return unbind_to (count
, Qnil
);
2205 #endif /* not CANNOT_DUMP */
2208 /* Recover from setlocale (LC_ALL, ""). */
2212 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2213 so that numbers are read and printed properly for Emacs Lisp. */
2214 setlocale (LC_NUMERIC
, "C");
2217 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2220 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2222 if (! EQ (*plocale
, desired_locale
))
2224 *plocale
= desired_locale
;
2226 /* Changing categories like LC_TIME usually requires specifying
2227 an encoding suitable for the new locale, but MS-Windows's
2228 'setlocale' will only switch the encoding when LC_ALL is
2229 specified. So we ignore CATEGORY, use LC_ALL instead, and
2230 then restore LC_NUMERIC to "C", so reading and printing
2231 numbers is unaffected. */
2232 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2233 ? SSDATA (desired_locale
)
2236 #else /* !WINDOWSNT */
2237 setlocale (category
, (STRINGP (desired_locale
)
2238 ? SSDATA (desired_locale
)
2240 #endif /* !WINDOWSNT */
2244 /* Set system time locale to match Vsystem_time_locale, if possible. */
2246 synchronize_system_time_locale (void)
2248 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2249 Vsystem_time_locale
);
2252 /* Set system messages locale to match Vsystem_messages_locale, if
2255 synchronize_system_messages_locale (void)
2258 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2259 Vsystem_messages_locale
);
2262 #endif /* HAVE_SETLOCALE */
2264 /* Return a diagnostic string for ERROR_NUMBER, in the wording
2265 and encoding appropriate for the current locale. */
2267 emacs_strerror (int error_number
)
2269 synchronize_system_messages_locale ();
2270 return strerror (error_number
);
2275 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2277 const char *path
, *p
;
2278 Lisp_Object lpath
, element
, tem
;
2279 /* Default is to use "." for empty path elements.
2280 But if argument EMPTY is true, use nil instead. */
2281 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2284 static const char *emacs_dir_env
= "%emacs_dir%/";
2285 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2286 const char *edir
= egetenv ("emacs_dir");
2287 char emacs_dir
[MAX_UTF8_PATH
];
2289 /* egetenv looks in process-environment, which holds the variables
2290 in their original system-locale encoding. We need emacs_dir to
2293 filename_from_ansi (edir
, emacs_dir
);
2296 /* It's okay to use getenv here, because this function is only used
2297 to initialize variables when Emacs starts up, and isn't called
2300 path
= getenv (evarname
);
2311 /* Ensure values from the environment use the proper directory separator. */
2317 char *path_utf8
, *q
, *d
;
2320 /* Convert each element of PATH to UTF-8. */
2321 p
= path_copy
= alloca (strlen (path
) + 1);
2322 strcpy (path_copy
, path
);
2323 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2326 q
= _mbschr (p
, SEPCHAR
);
2329 cnv_result
= filename_from_ansi (p
, d
);
2334 /* If conversion of this PATH elements fails, make sure
2335 destination pointer will stay put, thus effectively
2336 ignoring the offending element. */
2337 if (cnv_result
== 0)
2343 else if (cnv_result
!= 0 && d
> path_utf8
)
2344 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2346 path_copy
= path_utf8
;
2348 path_copy
= alloca (strlen (path
) + 1);
2349 strcpy (path_copy
, path
);
2351 dostounix_filename (path_copy
);
2358 p
= strchr (path
, SEPCHAR
);
2360 p
= path
+ strlen (path
);
2361 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2363 if (! NILP (element
))
2366 /* Relative file names in the default path are interpreted as
2367 being relative to $emacs_dir. */
2368 if (edir
&& defaulted
2369 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2370 element
= Fexpand_file_name (Fsubstring
2372 make_number (emacs_dir_len
),
2374 build_unibyte_string (emacs_dir
));
2377 /* Add /: to the front of the name
2378 if it would otherwise be treated as magic. */
2379 tem
= Ffind_file_name_handler (element
, Qt
);
2381 /* However, if the handler says "I'm safe",
2382 don't bother adding /:. */
2386 prop
= Fget (tem
, intern ("safe-magic"));
2393 AUTO_STRING (slash_colon
, "/:");
2394 element
= concat2 (slash_colon
, element
);
2396 } /* !NILP (element) */
2398 lpath
= Fcons (element
, lpath
);
2404 return Fnreverse (lpath
);
2407 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2408 doc
: /* Return non-nil if the current emacs process is a daemon.
2409 If the daemon was given a name argument, return that name. */)
2414 return build_string (daemon_name
);
2421 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2422 doc
: /* Mark the Emacs daemon as being initialized.
2423 This finishes the daemonization process by doing the other half of detaching
2424 from the parent process and its tty file descriptors. */)
2430 error ("This function can only be called if emacs is run as a daemon");
2432 if (!DAEMON_RUNNING
)
2433 error ("The daemon has already been initialized");
2435 if (NILP (Vafter_init_time
))
2436 error ("This function can only be called after loading the init files");
2439 if (daemon_type
== 2)
2443 /* Get rid of stdin, stdout and stderr. */
2444 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2446 err
|= dup2 (nfd
, STDIN_FILENO
) < 0;
2447 err
|= dup2 (nfd
, STDOUT_FILENO
) < 0;
2448 err
|= dup2 (nfd
, STDERR_FILENO
) < 0;
2449 err
|= emacs_close (nfd
) != 0;
2451 /* Closing the pipe will notify the parent that it can exit.
2452 FIXME: In case some other process inherited the pipe, closing it here
2453 won't notify the parent because it's still open elsewhere, so we
2454 additionally send a byte, just to make sure the parent really exits.
2455 Instead, we should probably close the pipe in start-process and
2456 call-process to make sure the pipe is never inherited by
2458 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2459 err
|= emacs_close (daemon_pipe
[1]) != 0;
2462 /* Set it to an invalid value so we know we've already run this function. */
2465 #else /* WINDOWSNT */
2466 /* Signal the waiting emacsclient process. */
2467 err
|= SetEvent (w32_daemon_event
) == 0;
2468 err
|= CloseHandle (w32_daemon_event
) == 0;
2469 /* Set it to an invalid value so we know we've already run this function. */
2470 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2474 error ("I/O error during daemon initialization");
2479 syms_of_emacs (void)
2481 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2482 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2483 DEFSYM (Qkill_emacs
, "kill-emacs");
2484 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2487 defsubr (&Sdump_emacs
);
2490 defsubr (&Skill_emacs
);
2492 defsubr (&Sinvocation_name
);
2493 defsubr (&Sinvocation_directory
);
2494 defsubr (&Sdaemonp
);
2495 defsubr (&Sdaemon_initialized
);
2497 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2498 doc
: /* Args passed by shell to Emacs, as a list of strings.
2499 Many arguments are deleted from the list as they are processed. */);
2501 DEFVAR_LISP ("system-type", Vsystem_type
,
2502 doc
: /* The value is a symbol indicating the type of operating system you are using.
2504 `gnu' compiled for a GNU Hurd system.
2505 `gnu/linux' compiled for a GNU/Linux system.
2506 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2507 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2508 `ms-dos' compiled as an MS-DOS application.
2509 `windows-nt' compiled as a native W32 application.
2510 `cygwin' compiled using the Cygwin library.
2511 Anything else (in Emacs 26, the possibilities are: aix, berkeley-unix,
2512 hpux, usg-unix-v) indicates some sort of Unix system. */);
2513 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2514 /* See configure.ac for the possible SYSTEM_TYPEs. */
2516 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2517 doc
: /* Value is string indicating configuration Emacs was built for. */);
2518 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2520 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2521 doc
: /* String containing the configuration options Emacs was built with. */);
2522 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2524 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2525 doc
: /* String listing some of the main features this Emacs was compiled with.
2526 An element of the form \"FOO\" generally means that HAVE_FOO was
2527 defined during the build.
2529 This is mainly intended for diagnostic purposes in bug reports.
2530 Don't rely on it for testing whether a feature you want to use is available. */);
2531 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2533 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2534 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2536 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2537 doc
: /* Hook run when `kill-emacs' is called.
2538 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2539 in other similar situations), functions placed on this hook should not
2540 expect to be able to interact with the user. To ask for confirmation,
2541 see `kill-emacs-query-functions' instead.
2543 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2544 `noninteractive' was non-nil. */);
2545 Vkill_emacs_hook
= Qnil
;
2547 DEFVAR_LISP ("path-separator", Vpath_separator
,
2548 doc
: /* String containing the character that separates directories in
2549 search paths, such as PATH and other similar environment variables. */);
2552 Vpath_separator
= make_string (&c
, 1);
2555 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2556 doc
: /* The program name that was used to run Emacs.
2557 Any directory names are omitted. */);
2559 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2560 doc
: /* The directory in which the Emacs executable was found, to run it.
2561 The value is nil if that directory's name is not known. */);
2563 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2564 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2565 In an installed Emacs, this is normally nil. It is non-nil if
2566 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2567 within the variable `invocation-directory' or its parent. For example,
2568 this is the case when running an uninstalled Emacs executable from its
2569 build directory. */);
2570 Vinstallation_directory
= Qnil
;
2572 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2573 doc
: /* System locale for messages. */);
2574 Vsystem_messages_locale
= Qnil
;
2576 DEFVAR_LISP ("previous-system-messages-locale",
2577 Vprevious_system_messages_locale
,
2578 doc
: /* Most recently used system locale for messages. */);
2579 Vprevious_system_messages_locale
= Qnil
;
2581 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2582 doc
: /* System locale for time. */);
2583 Vsystem_time_locale
= Qnil
;
2585 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2586 doc
: /* Most recently used system locale for time. */);
2587 Vprevious_system_time_locale
= Qnil
;
2589 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2590 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2591 Vbefore_init_time
= Qnil
;
2593 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2594 doc
: /* Value of `current-time' after loading the init files.
2595 This is nil during initialization. */);
2596 Vafter_init_time
= Qnil
;
2598 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2599 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2600 inhibit_x_resources
= 0;
2602 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2603 doc
: /* Short copyright string for this version of Emacs. */);
2604 Vemacs_copyright
= build_string (emacs_copyright
);
2606 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2607 doc
: /* Version numbers of this version of Emacs. */);
2608 Vemacs_version
= build_string (emacs_version
);
2610 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2611 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2612 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2614 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2615 doc
: /* Alist of dynamic libraries vs external files implementing them.
2616 Each element is a list (LIBRARY FILE...), where the car is a symbol
2617 representing a supported external library, and the rest are strings giving
2618 alternate filenames for that library.
2620 Emacs tries to load the library from the files in the order they appear on
2621 the list; if none is loaded, the running session of Emacs won't have access
2624 Note that image types `pbm' and `xbm' do not need entries in this variable
2625 because they do not depend on external libraries and are always available.
2627 Also note that this is not a generic facility for accessing external
2628 libraries; only those already known by Emacs will be loaded. */);
2629 Vdynamic_library_alist
= Qnil
;
2630 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2633 Vlibrary_cache
= Qnil
;
2634 staticpro (&Vlibrary_cache
);