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. */
134 /* Set to true if this instance of Emacs might dump. */
135 # ifndef DOUG_LEA_MALLOC
142 extern void unexec_init_emacs_zone (void);
145 /* If true, Emacs should not attempt to use a window-specific code,
146 but instead should use the virtual terminal under which it was started. */
147 bool inhibit_window_system
;
149 /* If true, a filter or a sentinel is running. Tested to save the match
150 data on the first attempt to change it inside asynchronous code. */
151 bool running_asynch_code
;
153 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
154 /* If true, -d was specified, meaning we're using some window system. */
158 #if defined GNU_LINUX && !defined CANNOT_DUMP
159 /* The gap between BSS end and heap start as far as we can tell. */
160 static uprintmax_t heap_bss_diff
;
163 /* To run as a background daemon under Cocoa or Windows,
164 we must do a fork+exec, not a simple fork.
166 On Cocoa, CoreFoundation lib fails in forked process:
167 http://developer.apple.com/ReleaseNotes/
168 CoreFoundation/CoreFoundation.html)
170 On Windows, a Cygwin fork child cannot access the USER subsystem.
172 We mark being in the exec'd process by a daemon name argument of
173 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
174 NAME is the original daemon name, if any. */
175 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
176 # define DAEMON_MUST_EXEC
179 /* True means running Emacs without interactive terminal. */
182 /* True means remove site-lisp directories from load-path. */
185 /* True means put details like time stamps into builds. */
188 /* Name for the server started by the daemon.*/
189 static char *daemon_name
;
191 /* 0 not a daemon, 1 new-style (foreground), 2 old-style (background). */
195 /* Pipe used to send exit notification to the background daemon parent at
196 startup. On Windows, we use a kernel event instead. */
197 static int daemon_pipe
[2];
199 HANDLE w32_daemon_event
;
202 /* Save argv and argc. */
206 static void sort_args (int argc
, char **argv
);
207 static void syms_of_emacs (void);
209 /* C99 needs each string to be at most 4095 characters, and the usage
210 strings below are split to not overflow this limit. */
211 static char const *const usage_message
[] =
214 Run Emacs, the extensible, customizable, self-documenting real-time\n\
215 display editor. The recommended way to start Emacs for normal editing\n\
216 is with no options at all.\n\
218 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
219 read the main documentation for these command-line arguments.\n\
221 Initialization options:\n\
225 --batch do not do interactive display; implies -q\n\
226 --chdir DIR change to directory DIR\n\
227 --daemon, --old-daemon[=NAME] start a (named) server in the background\n\
228 --new-daemon[=NAME] start a (named) server in the foreground\n\
229 --debug-init enable Emacs Lisp debugger for init file\n\
230 --display, -d DISPLAY use X server DISPLAY\n\
233 --no-build-details do not add build details such as time stamps\n\
234 --no-desktop do not load a saved desktop\n\
235 --no-init-file, -q load neither ~/.emacs nor default.el\n\
236 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
237 --no-site-file do not load site-start.el\n\
238 --no-x-resources do not load X resources\n\
239 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
240 --no-splash do not display a splash screen on startup\n\
241 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
244 --quick, -Q equivalent to:\n\
245 -q --no-site-file --no-site-lisp --no-splash\n\
247 --script FILE run FILE as an Emacs Lisp script\n\
248 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
249 --user, -u USER load ~USER/.emacs instead of your own\n\
255 FILE visit FILE using find-file\n\
256 +LINE go to line LINE in next FILE\n\
257 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
258 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
259 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
260 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
263 --file FILE visit FILE using find-file\n\
264 --find-file FILE visit FILE using find-file\n\
265 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
266 --insert FILE insert contents of FILE into current buffer\n\
267 --kill exit without asking for confirmation\n\
268 --load, -l FILE load Emacs Lisp FILE using the load function\n\
269 --visit FILE visit FILE using find-file\n\
275 --background-color, -bg COLOR window background color\n\
276 --basic-display, -D disable many display features;\n\
277 used for debugging Emacs\n\
278 --border-color, -bd COLOR main border color\n\
279 --border-width, -bw WIDTH width of main border\n\
282 --color, --color=MODE override color mode for character terminals;\n\
283 MODE defaults to `auto', and\n\
284 can also be `never', `always',\n\
285 or a mode name like `ansi8'\n\
286 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
287 --font, -fn FONT default font; must be fixed-width\n\
288 --foreground-color, -fg COLOR window foreground color\n\
291 --fullheight, -fh make the first frame high as the screen\n\
292 --fullscreen, -fs make the first frame fullscreen\n\
293 --fullwidth, -fw make the first frame wide as the screen\n\
294 --maximized, -mm make the first frame maximized\n\
295 --geometry, -g GEOMETRY window geometry\n\
298 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
299 --iconic start Emacs in iconified state\n\
300 --internal-border, -ib WIDTH width between text and main border\n\
301 --line-spacing, -lsp PIXELS additional space to put between lines\n\
302 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
303 --name NAME title for initial Emacs frame\n\
306 --no-blinking-cursor, -nbc disable blinking cursor\n\
307 --reverse-video, -r, -rv switch foreground and background\n\
308 --title, -T TITLE title for initial Emacs frame\n\
309 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
310 --xrm XRESOURCES set additional X resources\n\
311 --parent-id XID set parent window\n\
312 --help display this help and exit\n\
313 --version output version information and exit\n\
317 You can generally also specify long option names with a single -; for\n\
318 example, -batch as well as --batch. You can use any unambiguous\n\
319 abbreviation for a --option.\n\
321 Various environment variables and window system resources also affect\n\
322 the operation of Emacs. See the main documentation.\n\
324 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
325 section of the Emacs manual or the file BUGS.\n"
329 /* True if handling a fatal error already. */
330 bool fatal_error_in_progress
;
333 /* NS autrelease pool, for memory management. */
334 static void *ns_pool
;
339 setlocale (int cat
, char const *locale
)
345 /* True if the current system locale uses UTF-8 encoding. */
351 mbstate_t mbs
= { 0 };
352 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
359 /* Report a fatal error due to signal SIG, output a backtrace of at
360 most BACKTRACE_LIMIT lines, and exit. */
362 terminate_due_to_signal (int sig
, int backtrace_limit
)
364 signal (sig
, SIG_DFL
);
366 if (attempt_orderly_shutdown_on_fatal_signal
)
368 /* If fatal error occurs in code below, avoid infinite recursion. */
369 if (! fatal_error_in_progress
)
371 fatal_error_in_progress
= 1;
373 totally_unblock_input ();
374 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
375 Fkill_emacs (make_number (sig
));
377 shut_down_emacs (sig
, Qnil
);
378 emacs_backtrace (backtrace_limit
);
382 /* Signal the same code; this time it will really be fatal.
383 Since we're in a signal handler, the signal is blocked, so we
384 have to unblock it if we want to really receive it. */
388 sigemptyset (&unblocked
);
389 sigaddset (&unblocked
, sig
);
390 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
396 /* This shouldn't be executed, but it prevents a warning. */
400 /* Code for dealing with Lisp access to the Unix command line. */
403 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
406 Lisp_Object name
, dir
, handler
;
407 ptrdiff_t count
= SPECPDL_INDEX ();
408 Lisp_Object raw_name
;
409 AUTO_STRING (slash_colon
, "/:");
415 /* Must use argv[0] converted to UTF-8, as it begets many standard
416 file and directory names. */
418 char argv0
[MAX_UTF8_PATH
];
420 if (filename_from_ansi (argv
[0], argv0
) == 0)
421 raw_name
= build_unibyte_string (argv0
);
423 raw_name
= build_unibyte_string (argv
[0]);
426 raw_name
= build_unibyte_string (argv
[0]);
429 /* Add /: to the front of the name
430 if it would otherwise be treated as magic. */
431 handler
= Ffind_file_name_handler (raw_name
, Qt
);
432 if (! NILP (handler
))
433 raw_name
= concat2 (slash_colon
, raw_name
);
435 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
436 Vinvocation_directory
= Ffile_name_directory (raw_name
);
438 /* If we got no directory in argv[0], search PATH to find where
439 Emacs actually came from. */
440 if (NILP (Vinvocation_directory
))
443 int yes
= openp (Vexec_path
, Vinvocation_name
,
444 Vexec_suffixes
, &found
, make_number (X_OK
), false);
447 /* Add /: to the front of the name
448 if it would otherwise be treated as magic. */
449 handler
= Ffind_file_name_handler (found
, Qt
);
450 if (! NILP (handler
))
451 found
= concat2 (slash_colon
, found
);
452 Vinvocation_directory
= Ffile_name_directory (found
);
456 if (!NILP (Vinvocation_directory
)
457 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
458 /* Emacs was started with relative path, like ./emacs.
462 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
464 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
467 Vinstallation_directory
= Qnil
;
469 if (!NILP (Vinvocation_directory
))
471 dir
= Vinvocation_directory
;
473 /* If we are running from the build directory, set DIR to the
474 src subdirectory of the Emacs tree, like on Posix
476 if (SBYTES (dir
) > sizeof ("/i386/") - 1
477 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
479 dir
= Fexpand_file_name (build_string ("../.."), dir
);
480 #else /* !WINDOWSNT */
482 name
= Fexpand_file_name (Vinvocation_name
, dir
);
485 Lisp_Object tem
, lib_src_exists
;
486 Lisp_Object etc_exists
, info_exists
;
488 /* See if dir contains subdirs for use by Emacs.
489 Check for the ones that would exist in a build directory,
490 not including lisp and info. */
491 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
492 lib_src_exists
= Ffile_exists_p (tem
);
495 /* MSDOS installations frequently remove lib-src, but we still
496 must set installation-directory, or else info won't find
497 its files (it uses the value of installation-directory). */
498 tem
= Fexpand_file_name (build_string ("info"), dir
);
499 info_exists
= Ffile_exists_p (tem
);
504 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
506 tem
= Fexpand_file_name (build_string ("etc"), dir
);
507 etc_exists
= Ffile_exists_p (tem
);
508 if (!NILP (etc_exists
))
510 Vinstallation_directory
511 = Ffile_name_as_directory (dir
);
516 /* See if dir's parent contains those subdirs. */
517 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
518 lib_src_exists
= Ffile_exists_p (tem
);
522 /* See the MSDOS commentary above. */
523 tem
= Fexpand_file_name (build_string ("../info"), dir
);
524 info_exists
= Ffile_exists_p (tem
);
529 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
531 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
532 etc_exists
= Ffile_exists_p (tem
);
533 if (!NILP (etc_exists
))
535 tem
= Fexpand_file_name (build_string (".."), dir
);
536 Vinstallation_directory
537 = Ffile_name_as_directory (tem
);
542 /* If the Emacs executable is actually a link,
543 next try the dir that the link points into. */
544 tem
= Ffile_symlink_p (name
);
547 name
= Fexpand_file_name (tem
, dir
);
548 dir
= Ffile_name_directory (name
);
555 Vcommand_line_args
= Qnil
;
557 for (i
= argc
- 1; i
>= 0; i
--)
559 if (i
== 0 || i
> skip_args
)
560 /* For the moment, we keep arguments as is in unibyte strings.
561 They are decoded in the function command-line after we know
562 locale-coding-system. */
564 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
567 unbind_to (count
, Qnil
);
570 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
571 doc
: /* Return the program name that was used to run Emacs.
572 Any directory names are omitted. */)
575 return Fcopy_sequence (Vinvocation_name
);
578 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
580 doc
: /* Return the directory name in which the Emacs executable was located. */)
583 return Fcopy_sequence (Vinvocation_directory
);
587 /* Test whether the next argument in ARGV matches SSTR or a prefix of
588 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
589 (the argument is supposed to have a value) store in *VALPTR either
590 the next argument or the portion of this one after the equal sign.
591 ARGV is read starting at position *SKIPPTR; this index is advanced
592 by the number of arguments used.
594 Too bad we can't just use getopt for all of this, but we don't have
595 enough information to do it right. */
598 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
599 int minlen
, char **valptr
, int *skipptr
)
605 /* Don't access argv[argc]; give up in advance. */
606 if (argc
<= *skipptr
+ 1)
609 arg
= argv
[*skipptr
+1];
612 if (strcmp (arg
, sstr
) == 0)
616 *valptr
= argv
[*skipptr
+2];
623 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
624 ? p
- arg
: strlen (arg
));
625 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
627 else if (valptr
== NULL
)
638 else if (argv
[*skipptr
+2] != NULL
)
640 *valptr
= argv
[*skipptr
+2];
650 /* Close standard output and standard error, reporting any write
651 errors as best we can. This is intended for use with atexit. */
653 close_output_streams (void)
655 if (close_stream (stdout
) != 0)
657 emacs_perror ("Write error to standard output");
658 _exit (EXIT_FAILURE
);
661 if (close_stream (stderr
) != 0)
662 _exit (EXIT_FAILURE
);
667 main (int argc
, char **argv
)
669 char stack_bottom_variable
;
670 bool do_initial_setlocale
;
673 bool no_loadup
= false;
676 #ifdef DAEMON_MUST_EXEC
681 /* If we use --chdir, this records the original directory. */
682 char *original_pwd
= 0;
684 /* Record (approximately) where the stack begins. */
685 stack_bottom
= &stack_bottom_variable
;
687 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
688 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
690 /* True if address randomization interferes with memory allocation. */
692 bool disable_aslr
= true;
694 bool disable_aslr
= dumping
;
697 if (disable_aslr
&& disable_address_randomization ())
699 /* Set this so the personality will be reverted before execs
701 xputenv ("EMACS_HEAP_EXEC=true");
703 /* Address randomization was enabled, but is now disabled.
704 Re-execute Emacs to get a clean slate. */
705 execvp (argv
[0], argv
);
707 /* If the exec fails, warn and then try anyway. */
712 might_dump
= !initialized
;
717 char *heap_start
= my_heap_start ();
718 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
723 #if defined WINDOWSNT || defined HAVE_NTGUI
724 /* Set global variables used to detect Windows version. Do this as
725 early as possible. (unexw32.c calls this function as well, but
726 the additional call here is harmless.) */
727 cache_system_info ();
729 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
730 to have non-stub implementations of APIs we need to convert file
731 names between UTF-8 and the system's ANSI codepage. */
732 maybe_load_unicows_dll ();
734 /* This has to be done before module_init is called below, so that
735 the latter could use the thread ID of the main thread. */
736 w32_init_main_thread ();
739 #ifdef RUN_TIME_REMAP
741 run_time_remap (argv
[0]);
744 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
747 unexec_init_emacs_zone ();
750 init_standard_fds ();
751 atexit (close_output_streams
);
757 sort_args (argc
, argv
);
759 while (argv
[argc
]) argc
++;
761 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
763 const char *version
, *copyright
;
766 Lisp_Object tem
, tem2
;
767 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
768 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
771 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
776 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
781 version
= SSDATA (tem
);
782 copyright
= SSDATA (tem2
);
787 version
= emacs_version
;
788 copyright
= emacs_copyright
;
790 printf ("%s %s\n", PACKAGE_NAME
, version
);
791 printf ("%s\n", copyright
);
792 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
793 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
794 printf ("under the terms of the GNU General Public License.\n");
795 printf ("For more information about these matters, ");
796 printf ("see the file named COPYING.\n");
800 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
803 /* argv[] array is kept in its original ANSI codepage encoding,
804 we need to convert to UTF-8, for chdir to work. */
805 char newdir
[MAX_UTF8_PATH
];
807 filename_from_ansi (ch_to_dir
, newdir
);
810 original_pwd
= emacs_get_current_dir_name ();
811 if (chdir (ch_to_dir
) != 0)
813 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
814 argv
[0], ch_to_dir
, strerror (errno
));
819 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
820 /* Extend the stack space available. Don't do that if dumping,
821 since some systems (e.g. DJGPP) might define a smaller stack
822 limit at that time. And it's not needed on Cygwin, since emacs
823 is built with an 8MB stack. Moreover, the setrlimit call can
824 cause problems on Cygwin
825 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
827 if (getrlimit (RLIMIT_STACK
, &rlim
) == 0
828 && 0 <= rlim
.rlim_cur
&& rlim
.rlim_cur
<= LONG_MAX
)
830 rlim_t lim
= rlim
.rlim_cur
;
832 /* Approximate the amount regex.c needs per unit of
833 re_max_failures, then add 33% to cover the size of the
834 smaller stacks that regex.c successively allocates and
835 discards on its way to the maximum. */
836 int ratio
= 20 * sizeof (char *);
839 /* Extra space to cover what we're likely to use for other reasons. */
842 bool try_to_grow_stack
= true;
844 try_to_grow_stack
= !noninteractive
|| initialized
;
847 if (try_to_grow_stack
)
849 rlim_t newlim
= re_max_failures
* ratio
+ extra
;
851 /* Round the new limit to a page boundary; this is needed
852 for Darwin kernel 15.4.0 (see Bug#23622) and perhaps
853 other systems. Do not shrink the stack and do not exceed
854 rlim_max. Don't worry about exact values of
855 RLIM_INFINITY etc. since in practice when they are
856 nonnegative they are so large that the code does the
857 right thing anyway. */
858 long pagesize
= getpagesize ();
859 newlim
+= pagesize
- 1;
860 if (0 <= rlim
.rlim_max
&& rlim
.rlim_max
< newlim
)
861 newlim
= rlim
.rlim_max
;
862 newlim
-= newlim
% pagesize
;
864 if (pagesize
<= newlim
- lim
)
866 rlim
.rlim_cur
= newlim
;
867 if (setrlimit (RLIMIT_STACK
, &rlim
) == 0)
872 /* Don't let regex.c overflow the stack. */
873 re_max_failures
= lim
< extra
? 0 : min (lim
- extra
, SIZE_MAX
) / ratio
;
875 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
879 emacs_backtrace (-1);
881 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
882 /* Arrange to get warning messages as memory fills up. */
883 memory_warnings (0, malloc_warning
);
885 /* Call malloc at least once, to run malloc_initialize_hook.
886 Also call realloc and free for consistency. */
887 free (realloc (malloc (4), 4));
889 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
892 SET_BINARY (fileno (stdin
));
894 SET_BINARY (fileno (stdout
));
897 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
898 The build procedure uses this while dumping, to ensure that the
899 dumped Emacs does not have its system locale tables initialized,
900 as that might cause screwups when the dumped Emacs starts up. */
902 char *lc_all
= getenv ("LC_ALL");
903 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
906 /* Set locale now, so that initial error messages are localized properly.
907 fixup_locale must wait until later, since it builds strings. */
908 if (do_initial_setlocale
)
909 setlocale (LC_ALL
, "");
910 text_quoting_flag
= using_utf8 ();
912 inhibit_window_system
= 0;
914 /* Handle the -t switch, which specifies filename to use as terminal. */
918 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
920 emacs_close (STDIN_FILENO
);
921 emacs_close (STDOUT_FILENO
);
922 int result
= emacs_open (term
, O_RDWR
, 0);
923 if (result
!= STDIN_FILENO
924 || (fcntl (STDIN_FILENO
, F_DUPFD_CLOEXEC
, STDOUT_FILENO
)
927 char *errstring
= strerror (errno
);
928 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
931 if (! isatty (STDIN_FILENO
))
933 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
936 fprintf (stderr
, "Using %s\n", term
);
937 #ifdef HAVE_WINDOW_SYSTEM
938 inhibit_window_system
= true; /* -t => -nw */
945 /* Command line option --no-windows is deprecated and thus not mentioned
946 in the manual and usage information. */
947 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
948 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
949 inhibit_window_system
= 1;
951 /* Handle the -batch switch, which means don't do interactive display. */
953 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
956 Vundo_outer_limit
= Qnil
;
958 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
960 noninteractive
= 1; /* Set batch mode. */
961 /* Convert --script to -scriptload, un-skip it, and sort again
962 so that it will be handled in proper sequence. */
963 /* FIXME broken for --script=FILE - is that supposed to work? */
964 argv
[skip_args
- 1] = (char *) "-scriptload";
966 sort_args (argc
, argv
);
969 /* Handle the --help option, which gives a usage message. */
970 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
973 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
974 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
975 fputs (usage_message
[i
], stdout
);
982 /* Make sure IS_DAEMON starts up as false. */
985 w32_daemon_event
= NULL
;
991 if (argmatch (argv
, argc
, "-new-daemon", "--new-daemon", 10, NULL
, &skip_args
)
992 || argmatch (argv
, argc
, "-new-daemon", "--new-daemon", 10, &dname_arg
, &skip_args
))
994 daemon_type
= 1; /* foreground */
996 else if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
997 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
)
998 || argmatch (argv
, argc
, "-old-daemon", "--old-daemon", 10, NULL
, &skip_args
)
999 || argmatch (argv
, argc
, "-old-daemon", "--old-daemon", 10, &dname_arg
, &skip_args
))
1001 daemon_type
= 2; /* background */
1005 if (daemon_type
> 0)
1008 if (daemon_type
== 2)
1010 /* Start as a background daemon: fork a new child process which
1011 will run the rest of the initialization code, then exit.
1013 Detaching a daemon requires the following steps:
1017 - close the tty file-descriptors
1019 We only want to do the last 2 steps once the daemon is ready to
1020 serve requests, i.e. after loading .emacs (initialization).
1021 OTOH initialization may start subprocesses (e.g. ispell) and these
1022 should be run from the proper process (the one that will end up
1023 running as daemon) and with the proper "session id" in order for
1024 them to keep working after detaching, so fork and setsid need to be
1025 performed before initialization.
1027 We want to avoid exiting before the server socket is ready, so
1028 use a pipe for synchronization. The parent waits for the child
1029 to close its end of the pipe (using `daemon-initialized')
1031 if (emacs_pipe (daemon_pipe
) != 0)
1033 fprintf (stderr
, "Cannot pipe!\n");
1036 } /* daemon_type == 2 */
1038 #ifdef HAVE_LIBSYSTEMD
1039 /* Read the number of sockets passed through by systemd. */
1040 int systemd_socket
= sd_listen_fds (1);
1042 if (systemd_socket
> 1)
1045 "Warning: systemd passed more than one socket to Emacs.\n"
1046 "Try 'Accept=false' in the Emacs socket unit file.\n"));
1047 else if (systemd_socket
== 1
1048 && (0 < sd_is_socket (SD_LISTEN_FDS_START
,
1049 AF_UNSPEC
, SOCK_STREAM
, 1)))
1050 sockfd
= SD_LISTEN_FDS_START
;
1051 #endif /* HAVE_LIBSYSTEMD */
1054 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1055 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1056 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1057 #endif /* USE_GTK */
1059 if (daemon_type
== 2)
1062 #ifndef DAEMON_MUST_EXEC
1065 #else /* DAEMON_MUST_EXEC */
1066 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1067 f
= fork (); /* in orig */
1069 f
= 0; /* in exec'd */
1070 #endif /* !DAEMON_MUST_EXEC */
1076 /* Close unused writing end of the pipe. */
1077 emacs_close (daemon_pipe
[1]);
1079 /* Just wait for the child to close its end of the pipe. */
1082 retval
= read (daemon_pipe
[0], &buf
, 1);
1084 while (retval
== -1 && errno
== EINTR
);
1088 fprintf (stderr
, "Error reading status from child\n");
1091 else if (retval
== 0)
1093 fprintf (stderr
, "Error: server did not start correctly\n");
1097 emacs_close (daemon_pipe
[0]);
1102 emacs_perror ("fork");
1103 exit (EXIT_CANCELED
);
1106 #ifdef DAEMON_MUST_EXEC
1108 /* In orig process, forked as child, OR in exec'd. */
1109 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1110 { /* In orig, child: now exec w/special daemon name. */
1113 snprintf (fdStr
, sizeof fdStr
,
1114 "--old-daemon=\n%d,%d\n%s", daemon_pipe
[0],
1115 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1117 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1119 fprintf (stderr
, "daemon: child name too long\n");
1120 exit (EXIT_CANNOT_INVOKE
);
1123 argv
[skip_args
] = fdStr
;
1125 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1126 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1127 execvp (argv
[0], argv
);
1128 emacs_perror (argv
[0]);
1129 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1132 /* In exec'd: parse special dname into pipe and name info. */
1133 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1134 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1136 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1137 exit (EXIT_CANNOT_INVOKE
);
1139 dname_arg2
[0] = '\0';
1140 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1142 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1143 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1145 #endif /* DAEMON_MUST_EXEC */
1147 /* Close unused reading end of the pipe. */
1148 emacs_close (daemon_pipe
[0]);
1151 } /* daemon_type == 2 */
1152 #elif defined(WINDOWSNT)
1153 /* Indicate that we want daemon mode. */
1154 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1155 if (w32_daemon_event
== NULL
)
1157 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1162 fprintf (stderr
, "This platform does not support daemon mode.\n");
1166 daemon_name
= xstrdup (dname_arg
);
1169 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1170 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1171 # ifndef CANNOT_DUMP
1172 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1173 that causes an infinite recursive loop with FreeBSD. See
1174 Bug#14569. The part of this bug involving Cygwin is no longer
1175 relevant, now that Cygwin defines HYBRID_MALLOC. */
1176 if (!noninteractive
|| initialized
)
1178 malloc_enable_thread ();
1181 init_signals (dumping
);
1183 noninteractive1
= noninteractive
;
1185 /* Perform basic initializations (not merely interning symbols). */
1190 init_threads_once ();
1193 init_charset_once ();
1194 init_coding_once ();
1195 init_syntax_once (); /* Create standard syntax table. */
1196 init_category_once (); /* Create standard category table. */
1197 init_casetab_once (); /* Must be done before init_buffer_once. */
1198 init_buffer_once (); /* Create buffer table and some buffers. */
1199 init_minibuf_once (); /* Create list of minibuffers. */
1200 /* Must precede init_window_once. */
1202 /* Call syms_of_xfaces before init_window_once because that
1203 function creates Vterminal_frame. Termcap frames now use
1204 faces, and the face implementation uses some symbols as
1207 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1208 be better to arrange things not to have this dependency. */
1210 /* Call syms_of_keyboard before init_window_once because
1211 keyboard sets up symbols that include some face names that
1212 the X support will want to use. This can happen when
1213 CANNOT_DUMP is defined. */
1214 syms_of_keyboard ();
1216 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1218 syms_of_fns (); /* Before syms_of_charset which uses hash tables. */
1220 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1222 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1224 /* Before syms_of_coding because it initializes Qcharsetp. */
1226 /* Before init_window_once, because it sets up the
1227 Vcoding_system_hash_table. */
1228 syms_of_coding (); /* This should be after syms_of_fileio. */
1230 init_window_once (); /* Init the window system. */
1231 #ifdef HAVE_WINDOW_SYSTEM
1232 init_fringe_once (); /* Swap bitmaps if necessary. */
1233 #endif /* HAVE_WINDOW_SYSTEM */
1239 if (do_initial_setlocale
)
1242 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1243 Vsystem_time_locale
= Vprevious_system_time_locale
;
1248 running_asynch_code
= 0;
1252 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1255 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1257 build_details
= ! argmatch (argv
, argc
, "-no-build-details",
1258 "--no-build-details", 7, NULL
, &skip_args
);
1261 ns_pool
= ns_alloc_autorelease_pool ();
1262 #ifdef NS_IMPL_GNUSTEP
1263 /* GNUstep stupidly resets our locale settings after we made them. */
1267 if (!noninteractive
)
1269 #ifdef NS_IMPL_COCOA
1270 /* Started from GUI? */
1271 /* FIXME: Do the right thing if getenv returns NULL, or if
1273 if (! inhibit_window_system
&& ! isatty (STDIN_FILENO
) && ! ch_to_dir
)
1274 chdir (getenv ("HOME"));
1275 if (skip_args
< argc
)
1277 if (!strncmp (argv
[skip_args
], "-psn", 4))
1280 if (! ch_to_dir
) chdir (getenv ("HOME"));
1282 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1285 if (! ch_to_dir
) chdir (getenv ("HOME"));
1290 #endif /* HAVE_NS */
1292 #ifdef HAVE_X_WINDOWS
1293 /* Stupid kludge to catch command-line display spec. We can't
1294 handle this argument entirely in window system dependent code
1295 because we don't even know which window system dependent code
1296 to run until we've recognized this argument. */
1298 char *displayname
= 0;
1299 int count_before
= skip_args
;
1301 /* Skip any number of -d options, but only use the last one. */
1304 int count_before_this
= skip_args
;
1306 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1308 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1313 count_before
= count_before_this
;
1316 /* If we have the form --display=NAME,
1317 convert it into -d name.
1318 This requires inserting a new element into argv. */
1319 if (displayname
&& count_before
< skip_args
)
1321 if (skip_args
== count_before
+ 1)
1323 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1324 (argc
- (count_before
+ 2)) * sizeof *argv
);
1325 argv
[count_before
+ 2] = displayname
;
1328 argv
[count_before
+ 1] = (char *) "-d";
1333 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1334 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1338 /* Don't actually discard this arg. */
1339 skip_args
= count_before
;
1341 #else /* !HAVE_X_WINDOWS */
1344 int count_before
= skip_args
;
1346 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1347 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1350 skip_args
= count_before
;
1354 /* argmatch must not be used after here,
1355 except when building temacs
1356 because the -d argument has not been skipped in skip_args. */
1359 /* Call early 'cause init_environment needs it. */
1361 /* Set defaults for several environment variables. */
1363 init_environment (argc
, argv
, skip_args
);
1369 globals_of_kqueue ();
1372 #ifdef HAVE_GFILENOTIFY
1373 globals_of_gfilenotify ();
1377 /* Initialize the locale from user defaults. */
1381 /* Initialize and GC-protect Vinitial_environment and
1382 Vprocess_environment before set_initial_environment fills them
1385 syms_of_callproc ();
1386 /* egetenv is a pretty low-level facility, which may get called in
1387 many circumstances; it seems flimsy to put off initializing it
1388 until calling init_callproc. Do not do it when dumping. */
1390 set_initial_environment ();
1394 #ifdef HAVE_W32NOTIFY
1395 globals_of_w32notify ();
1397 /* Initialize environment from registry settings. Make sure to do
1398 this only after calling set_initial_environment so that
1399 Vinitial_environment and Vprocess_environment will contain only
1400 variables from the parent process without modifications from
1402 init_environment (argv
);
1403 init_ntproc (dumping
); /* must precede init_editfns. */
1406 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1407 if this is not done. Do it after set_global_environment so that we
1408 don't pollute Vglobal_environment. */
1409 /* Setting LANG here will defeat the startup locale processing... */
1414 /* Init buffer storage and default directory of main buffer. */
1415 init_buffer (initialized
);
1417 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1419 /* Must precede init_lread. */
1420 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1424 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1425 Lisp_Object old_log_max
;
1426 old_log_max
= Vmessage_log_max
;
1427 XSETFASTINT (Vmessage_log_max
, 0);
1428 message_dolog ("", 0, 1, 0);
1429 Vmessage_log_max
= old_log_max
;
1432 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1436 /* Check to see if Emacs has been installed correctly. */
1437 check_windows_init_file ();
1440 /* Intern the names of all standard functions and variables;
1441 define standard keys. */
1445 /* The basic levels of Lisp must come first. Note that
1446 syms_of_data and some others have already been called. */
1451 syms_of_floatfns ();
1454 syms_of_bytecode ();
1456 syms_of_casefiddle ();
1458 syms_of_category ();
1460 syms_of_character ();
1467 syms_of_filelock ();
1470 /* syms_of_keymap (); */
1478 syms_of_terminal ();
1489 syms_of_textprop ();
1490 syms_of_composite ();
1493 #endif /* WINDOWSNT */
1500 #ifdef HAVE_WINDOW_SYSTEM
1503 #endif /* HAVE_WINDOW_SYSTEM */
1504 #ifdef HAVE_X_WINDOWS
1510 syms_of_xsettings ();
1517 #endif /* HAVE_X_WINDOWS */
1524 syms_of_decompress ();
1534 #endif /* HAVE_NTGUI */
1536 #if defined WINDOWSNT || defined HAVE_NTGUI
1537 syms_of_w32select ();
1544 syms_of_win16select ();
1551 syms_of_nsselect ();
1553 #endif /* HAVE_NS */
1559 #endif /* HAVE_INOTIFY */
1563 #endif /* HAVE_KQUEUE */
1565 #ifdef HAVE_GFILENOTIFY
1566 syms_of_gfilenotify ();
1567 #endif /* HAVE_GFILENOTIFY */
1570 syms_of_dbusbind ();
1571 #endif /* HAVE_DBUS */
1575 #ifdef HAVE_W32NOTIFY
1576 syms_of_w32notify ();
1577 #endif /* HAVE_W32NOTIFY */
1578 #endif /* WINDOWSNT */
1581 syms_of_profiler ();
1583 keys_of_casefiddle ();
1586 keys_of_keyboard ();
1592 /* Initialization that must be done even if the global variable
1593 initialized is non zero. */
1595 globals_of_w32font ();
1596 globals_of_w32fns ();
1597 globals_of_w32menu ();
1598 #endif /* HAVE_NTGUI */
1600 #if defined WINDOWSNT || defined HAVE_NTGUI
1601 globals_of_w32select ();
1607 /* This calls putenv and so must precede init_process_emacs. Also,
1608 it sets Voperating_system_release, which init_process_emacs uses. */
1609 init_editfns (dumping
);
1611 /* These two call putenv. */
1619 /* This can create a thread that may call getenv, so it must follow
1620 all calls to putenv and setenv. Also, this sets up
1621 add_keyboard_wait_descriptor, which init_display uses. */
1622 init_process_emacs (sockfd
);
1624 init_keyboard (); /* This too must precede init_sys_modes. */
1625 if (!noninteractive
)
1626 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1629 init_crit (); /* w32notify.c needs this in batch mode. */
1630 #endif /* HAVE_W32NOTIFY */
1632 #ifdef HAVE_WINDOW_SYSTEM
1634 #endif /* HAVE_WINDOW_SYSTEM */
1642 /* Handle -l loadup, args passed by Makefile. */
1643 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1646 char file_utf8
[MAX_UTF8_PATH
];
1648 if (filename_from_ansi (file
, file_utf8
) == 0)
1651 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1653 /* Unless next switch is -nl, load "loadup.el" first thing. */
1655 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1658 /* Set up for profiling. This is known to work on FreeBSD,
1659 GNU/Linux and MinGW. It might work on some other systems too.
1660 Give it a try and tell us if it works on your system. To compile
1661 for profiling, use the configure option --enable-profiling. */
1662 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1667 extern unsigned char etext
asm ("etext");
1673 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1682 /* Enter editor command loop. This never returns. */
1688 /* Sort the args so we can find the most important ones
1689 at the beginning of argv. */
1691 /* First, here's a table of all the standard options. */
1693 struct standard_args
1696 const char *longname
;
1701 static const struct standard_args standard_args
[] =
1703 { "-version", "--version", 150, 0 },
1704 { "-chdir", "--chdir", 130, 1 },
1705 { "-t", "--terminal", 120, 1 },
1706 { "-nw", "--no-window-system", 110, 0 },
1707 { "-nw", "--no-windows", 110, 0 },
1708 { "-batch", "--batch", 100, 0 },
1709 { "-script", "--script", 100, 1 },
1710 { "-daemon", "--daemon", 99, 0 },
1711 { "-old-daemon", "--old-daemon", 99, 0 },
1712 { "-new-daemon", "--new-daemon", 99, 0 },
1713 { "-help", "--help", 90, 0 },
1714 { "-nl", "--no-loadup", 70, 0 },
1715 { "-nsl", "--no-site-lisp", 65, 0 },
1716 { "-no-build-details", "--no-build-details", 63, 0 },
1717 /* -d must come last before the options handled in startup.el. */
1718 { "-d", "--display", 60, 1 },
1719 { "-display", 0, 60, 1 },
1720 /* Now for the options handled in `command-line' (startup.el). */
1721 /* (Note that to imply -nsl, -Q is partially handled here.) */
1722 { "-Q", "--quick", 55, 0 },
1723 { "-quick", 0, 55, 0 },
1724 { "-q", "--no-init-file", 50, 0 },
1725 { "-no-init-file", 0, 50, 0 },
1726 { "-no-x-resources", "--no-x-resources", 40, 0 },
1727 { "-no-site-file", "--no-site-file", 40, 0 },
1728 { "-u", "--user", 30, 1 },
1729 { "-user", 0, 30, 1 },
1730 { "-debug-init", "--debug-init", 20, 0 },
1731 { "-iconic", "--iconic", 15, 0 },
1732 { "-D", "--basic-display", 12, 0},
1733 { "-basic-display", 0, 12, 0},
1734 { "-nbc", "--no-blinking-cursor", 12, 0 },
1735 /* Now for the options handled in `command-line-1' (startup.el). */
1736 { "-nbi", "--no-bitmap-icon", 10, 0 },
1737 { "-bg", "--background-color", 10, 1 },
1738 { "-background", 0, 10, 1 },
1739 { "-fg", "--foreground-color", 10, 1 },
1740 { "-foreground", 0, 10, 1 },
1741 { "-bd", "--border-color", 10, 1 },
1742 { "-bw", "--border-width", 10, 1 },
1743 { "-ib", "--internal-border", 10, 1 },
1744 { "-ms", "--mouse-color", 10, 1 },
1745 { "-cr", "--cursor-color", 10, 1 },
1746 { "-fn", "--font", 10, 1 },
1747 { "-font", 0, 10, 1 },
1748 { "-fs", "--fullscreen", 10, 0 },
1749 { "-fw", "--fullwidth", 10, 0 },
1750 { "-fh", "--fullheight", 10, 0 },
1751 { "-mm", "--maximized", 10, 0 },
1752 { "-g", "--geometry", 10, 1 },
1753 { "-geometry", 0, 10, 1 },
1754 { "-T", "--title", 10, 1 },
1755 { "-title", 0, 10, 1 },
1756 { "-name", "--name", 10, 1 },
1757 { "-xrm", "--xrm", 10, 1 },
1758 { "-parent-id", "--parent-id", 10, 1 },
1759 { "-r", "--reverse-video", 5, 0 },
1761 { "-reverse", 0, 5, 0 },
1762 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1763 { "-vb", "--vertical-scroll-bars", 5, 0 },
1764 { "-color", "--color", 5, 0},
1765 { "-no-splash", "--no-splash", 3, 0 },
1766 { "-no-desktop", "--no-desktop", 3, 0 },
1768 { "-NSAutoLaunch", 0, 5, 1 },
1769 { "-NXAutoLaunch", 0, 5, 1 },
1770 { "-_NSMachLaunch", 0, 85, 1 },
1771 { "-MachLaunch", 0, 85, 1 },
1772 { "-macosx", 0, 85, 0 },
1773 { "-NSHost", 0, 85, 1 },
1775 /* These have the same priority as ordinary file name args,
1776 so they are not reordered with respect to those. */
1777 { "-L", "--directory", 0, 1 },
1778 { "-directory", 0, 0, 1 },
1779 { "-l", "--load", 0, 1 },
1780 { "-load", 0, 0, 1 },
1781 /* This has no longname, because using --scriptload confuses sort_args,
1782 because then the --script long option seems to match twice; ie
1783 you can't have a long option which is a prefix of another long
1784 option. In any case, this is entirely an internal option. */
1785 { "-scriptload", NULL
, 0, 1 },
1786 { "-f", "--funcall", 0, 1 },
1787 { "-funcall", 0, 0, 1 },
1788 { "-eval", "--eval", 0, 1 },
1789 { "-execute", "--execute", 0, 1 },
1790 { "-find-file", "--find-file", 0, 1 },
1791 { "-visit", "--visit", 0, 1 },
1792 { "-file", "--file", 0, 1 },
1793 { "-insert", "--insert", 0, 1 },
1795 { "-NXOpen", 0, 0, 1 },
1796 { "-NXOpenTemp", 0, 0, 1 },
1797 { "-NSOpen", 0, 0, 1 },
1798 { "-NSOpenTemp", 0, 0, 1 },
1799 { "-GSFilePath", 0, 0, 1 },
1801 /* This should be processed after ordinary file name args and the like. */
1802 { "-kill", "--kill", -10, 0 },
1805 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1806 so that the highest priority ones come first.
1807 Do not change the order of elements of equal priority.
1808 If an option takes an argument, keep it and its argument together.
1810 If an option that takes no argument appears more
1811 than once, eliminate all but one copy of it. */
1814 sort_args (int argc
, char **argv
)
1816 char **new = xmalloc (argc
* sizeof *new);
1817 /* For each element of argv,
1818 the corresponding element of options is:
1819 0 for an option that takes no arguments,
1820 1 for an option that takes one argument, etc.
1821 -1 for an ordinary non-option argument. */
1822 int *options
= xnmalloc (argc
, sizeof *options
);
1823 int *priority
= xnmalloc (argc
, sizeof *priority
);
1825 int incoming_used
= 1;
1829 /* Categorize all the options,
1830 and figure out which argv elts are option arguments. */
1831 for (from
= 1; from
< argc
; from
++)
1835 if (argv
[from
][0] == '-')
1839 /* If we have found "--", don't consider
1840 any more arguments as options. */
1841 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1843 /* Leave the "--", and everything following it, at the end. */
1844 for (; from
< argc
; from
++)
1846 priority
[from
] = -100;
1852 /* Look for a match with a known old-fashioned option. */
1853 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1854 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1856 options
[from
] = standard_args
[i
].nargs
;
1857 priority
[from
] = standard_args
[i
].priority
;
1858 if (from
+ standard_args
[i
].nargs
>= argc
)
1859 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1860 from
+= standard_args
[i
].nargs
;
1864 /* Look for a match with a known long option.
1865 MATCH is -1 if no match so far, -2 if two or more matches so far,
1866 >= 0 (the table index of the match) if just one match so far. */
1867 if (argv
[from
][1] == '-')
1869 char const *equals
= strchr (argv
[from
], '=');
1871 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1875 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1876 if (standard_args
[i
].longname
1877 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1886 /* If we found exactly one match, use that. */
1889 options
[from
] = standard_args
[match
].nargs
;
1890 priority
[from
] = standard_args
[match
].priority
;
1891 /* If --OPTION=VALUE syntax is used,
1892 this option uses just one argv element. */
1895 if (from
+ options
[from
] >= argc
)
1896 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1897 from
+= options
[from
];
1899 else if (match
== -2)
1901 /* This is an internal error.
1902 Eg if one long option is a prefix of another. */
1903 fprintf (stderr
, "Option '%s' matched multiple standard arguments\n", argv
[from
]);
1905 /* Should we not also warn if there was no match? */
1911 /* Copy the arguments, in order of decreasing priority, to NEW. */
1913 while (incoming_used
< argc
)
1916 int best_priority
= -9999;
1918 /* Find the highest priority remaining option.
1919 If several have equal priority, take the first of them. */
1920 for (from
= 1; from
< argc
; from
++)
1922 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1924 best_priority
= priority
[from
];
1927 /* Skip option arguments--they are tied to the options. */
1928 if (options
[from
] > 0)
1929 from
+= options
[from
];
1935 /* Copy the highest priority remaining option, with its args, to NEW.
1936 Unless it is a duplicate of the previous one. */
1937 if (! (options
[best
] == 0
1938 && ! strcmp (new[to
- 1], argv
[best
])))
1940 new[to
++] = argv
[best
];
1941 for (i
= 0; i
< options
[best
]; i
++)
1942 new[to
++] = argv
[best
+ i
+ 1];
1945 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1947 /* Clear out this option in ARGV. */
1949 for (i
= 0; i
< options
[best
]; i
++)
1950 argv
[best
+ i
+ 1] = 0;
1953 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1957 memcpy (argv
, new, sizeof (char *) * argc
);
1964 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1965 doc
: /* Exit the Emacs job and kill it.
1966 If ARG is an integer, return ARG as the exit program code.
1967 If ARG is a string, stuff it as keyboard input.
1969 This function is called upon receipt of the signals SIGTERM
1970 or SIGHUP, and upon SIGINT in batch mode.
1972 The value of `kill-emacs-hook', if not void,
1973 is a list of functions (of no args),
1974 all of which are called before Emacs is actually killed. */
1975 attributes
: noreturn
)
1980 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1982 waiting_for_input
= 0;
1983 run_hook (Qkill_emacs_hook
);
1985 #ifdef HAVE_X_WINDOWS
1986 /* Transfer any clipboards we own to the clipboard manager. */
1987 x_clipboard_manager_save_all ();
1990 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1993 ns_release_autorelease_pool (ns_pool
);
1996 /* If we have an auto-save list file,
1997 kill it because we are exiting Emacs deliberately (not crashing).
1998 Do it after shut_down_emacs, which does an auto-save. */
1999 if (STRINGP (Vauto_save_list_file_name
))
2001 Lisp_Object listfile
;
2002 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
2003 unlink (SSDATA (listfile
));
2007 exit_code
= (XINT (arg
) < 0
2008 ? XINT (arg
) | INT_MIN
2009 : XINT (arg
) & INT_MAX
);
2011 exit_code
= EXIT_SUCCESS
;
2016 /* Perform an orderly shutdown of Emacs. Autosave any modified
2017 buffers, kill any child processes, clean up the terminal modes (if
2018 we're in the foreground), and other stuff like that. Don't perform
2019 any redisplay; this may be called when Emacs is shutting down in
2020 the background, or after its X connection has died.
2022 If SIG is a signal number, print a message for it.
2024 This is called by fatal signal handlers, X protocol error handlers,
2028 shut_down_emacs (int sig
, Lisp_Object stuff
)
2030 /* Prevent running of hooks from now on. */
2033 /* Don't update display from now on. */
2034 Vinhibit_redisplay
= Qt
;
2036 /* If we are controlling the terminal, reset terminal modes. */
2039 pid_t pgrp
= getpgrp ();
2040 pid_t tpgrp
= tcgetpgrp (0);
2041 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2043 reset_all_sys_modes ();
2044 if (sig
&& sig
!= SIGTERM
)
2046 static char const format
[] = "Fatal error %d: ";
2047 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2048 int buflen
= sprintf (buf
, format
, sig
);
2049 char const *sig_desc
= safe_strsignal (sig
);
2050 emacs_write (STDERR_FILENO
, buf
, buflen
);
2051 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2057 reset_all_sys_modes ();
2060 stuff_buffered_input (stuff
);
2062 inhibit_sentinels
= 1;
2063 kill_buffer_processes (Qnil
);
2064 Fdo_auto_save (Qt
, Qnil
);
2066 unlock_all_files ();
2068 /* There is a tendency for a SIGIO signal to arrive within exit,
2069 and cause a SIGHUP because the input descriptor is already closed. */
2072 /* Do this only if terminating normally, we want glyph matrices
2073 etc. in a core dump. */
2074 if (sig
== 0 || sig
== SIGTERM
)
2076 check_glyph_memory ();
2077 check_message_stack ();
2085 ns_term_shutdown (sig
);
2089 xml_cleanup_parser ();
2103 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2104 doc
: /* Dump current state of Emacs into executable file FILENAME.
2105 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2106 This is used in the file `loadup.el' when building Emacs.
2108 You must run Emacs in batch mode in order to dump it. */)
2109 (Lisp_Object filename
, Lisp_Object symfile
)
2113 ptrdiff_t count
= SPECPDL_INDEX ();
2117 if (! noninteractive
)
2118 error ("Dumping Emacs works only in batch mode");
2121 error ("Emacs can be dumped only once");
2123 #if defined GNU_LINUX && !defined CANNOT_DUMP
2125 /* Warn if the gap between BSS end and heap start is larger than this. */
2126 # define MAX_HEAP_BSS_DIFF (1024*1024)
2128 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2130 fprintf (stderr
, "**************************************************\n");
2131 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2132 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2134 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2135 fprintf (stderr
, "fail because of this. See the section about\n");
2136 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2137 fprintf (stderr
, "**************************************************\n");
2139 #endif /* GNU_LINUX */
2141 /* Bind `command-line-processed' to nil before dumping,
2142 so that the dumped Emacs will process its command line
2143 and set up to work with X windows if appropriate. */
2144 symbol
= intern ("command-line-processed");
2145 specbind (symbol
, Qnil
);
2147 CHECK_STRING (filename
);
2148 filename
= Fexpand_file_name (filename
, Qnil
);
2149 filename
= ENCODE_FILE (filename
);
2150 if (!NILP (symfile
))
2152 CHECK_STRING (symfile
);
2153 if (SCHARS (symfile
))
2155 symfile
= Fexpand_file_name (symfile
, Qnil
);
2156 symfile
= ENCODE_FILE (symfile
);
2161 Vpurify_flag
= Qnil
;
2163 #ifdef HYBRID_MALLOC
2165 static char const fmt
[] = "%d of %d static heap bytes used";
2166 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2167 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2168 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2169 /* Don't log messages, because at this point buffers cannot be created. */
2170 message1_nolog (buf
);
2175 /* Tell malloc where start of impure now is. */
2176 /* Also arrange for warnings when nearly out of space. */
2177 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2179 /* On Windows, this was done before dumping, and that once suffices.
2180 Meanwhile, my_edata is not valid on Windows. */
2181 memory_warnings (my_edata
, malloc_warning
);
2182 #endif /* not WINDOWSNT */
2183 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2185 alloc_unexec_pre ();
2187 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2189 alloc_unexec_post ();
2192 Vlibrary_cache
= Qnil
;
2194 #ifdef HAVE_WINDOW_SYSTEM
2195 reset_image_types ();
2200 return unbind_to (count
, Qnil
);
2203 #endif /* not CANNOT_DUMP */
2206 /* Recover from setlocale (LC_ALL, ""). */
2210 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2211 so that numbers are read and printed properly for Emacs Lisp. */
2212 setlocale (LC_NUMERIC
, "C");
2215 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2218 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2220 if (! EQ (*plocale
, desired_locale
))
2222 *plocale
= desired_locale
;
2224 /* Changing categories like LC_TIME usually requires specifying
2225 an encoding suitable for the new locale, but MS-Windows's
2226 'setlocale' will only switch the encoding when LC_ALL is
2227 specified. So we ignore CATEGORY, use LC_ALL instead, and
2228 then restore LC_NUMERIC to "C", so reading and printing
2229 numbers is unaffected. */
2230 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2231 ? SSDATA (desired_locale
)
2234 #else /* !WINDOWSNT */
2235 setlocale (category
, (STRINGP (desired_locale
)
2236 ? SSDATA (desired_locale
)
2238 #endif /* !WINDOWSNT */
2242 /* Set system time locale to match Vsystem_time_locale, if possible. */
2244 synchronize_system_time_locale (void)
2246 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2247 Vsystem_time_locale
);
2250 /* Set system messages locale to match Vsystem_messages_locale, if
2253 synchronize_system_messages_locale (void)
2256 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2257 Vsystem_messages_locale
);
2260 #endif /* HAVE_SETLOCALE */
2262 /* Return a diagnostic string for ERROR_NUMBER, in the wording
2263 and encoding appropriate for the current locale. */
2265 emacs_strerror (int error_number
)
2267 synchronize_system_messages_locale ();
2268 return strerror (error_number
);
2273 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2275 const char *path
, *p
;
2276 Lisp_Object lpath
, element
, tem
;
2277 /* Default is to use "." for empty path elements.
2278 But if argument EMPTY is true, use nil instead. */
2279 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2282 static const char *emacs_dir_env
= "%emacs_dir%/";
2283 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2284 const char *edir
= egetenv ("emacs_dir");
2285 char emacs_dir
[MAX_UTF8_PATH
];
2287 /* egetenv looks in process-environment, which holds the variables
2288 in their original system-locale encoding. We need emacs_dir to
2291 filename_from_ansi (edir
, emacs_dir
);
2294 /* It's okay to use getenv here, because this function is only used
2295 to initialize variables when Emacs starts up, and isn't called
2298 path
= getenv (evarname
);
2309 /* Ensure values from the environment use the proper directory separator. */
2315 char *path_utf8
, *q
, *d
;
2318 /* Convert each element of PATH to UTF-8. */
2319 p
= path_copy
= alloca (strlen (path
) + 1);
2320 strcpy (path_copy
, path
);
2321 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2324 q
= _mbschr (p
, SEPCHAR
);
2327 cnv_result
= filename_from_ansi (p
, d
);
2332 /* If conversion of this PATH elements fails, make sure
2333 destination pointer will stay put, thus effectively
2334 ignoring the offending element. */
2335 if (cnv_result
== 0)
2341 else if (cnv_result
!= 0 && d
> path_utf8
)
2342 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2344 path_copy
= path_utf8
;
2346 path_copy
= alloca (strlen (path
) + 1);
2347 strcpy (path_copy
, path
);
2349 dostounix_filename (path_copy
);
2356 p
= strchr (path
, SEPCHAR
);
2358 p
= path
+ strlen (path
);
2359 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2361 if (! NILP (element
))
2364 /* Relative file names in the default path are interpreted as
2365 being relative to $emacs_dir. */
2366 if (edir
&& defaulted
2367 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2368 element
= Fexpand_file_name (Fsubstring
2370 make_number (emacs_dir_len
),
2372 build_unibyte_string (emacs_dir
));
2375 /* Add /: to the front of the name
2376 if it would otherwise be treated as magic. */
2377 tem
= Ffind_file_name_handler (element
, Qt
);
2379 /* However, if the handler says "I'm safe",
2380 don't bother adding /:. */
2384 prop
= Fget (tem
, intern ("safe-magic"));
2391 AUTO_STRING (slash_colon
, "/:");
2392 element
= concat2 (slash_colon
, element
);
2394 } /* !NILP (element) */
2396 lpath
= Fcons (element
, lpath
);
2402 return Fnreverse (lpath
);
2405 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2406 doc
: /* Return non-nil if the current emacs process is a daemon.
2407 If the daemon was given a name argument, return that name. */)
2412 return build_string (daemon_name
);
2419 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2420 doc
: /* Mark the Emacs daemon as being initialized.
2421 This finishes the daemonization process by doing the other half of detaching
2422 from the parent process and its tty file descriptors. */)
2428 error ("This function can only be called if emacs is run as a daemon");
2430 if (!DAEMON_RUNNING
)
2431 error ("The daemon has already been initialized");
2433 if (NILP (Vafter_init_time
))
2434 error ("This function can only be called after loading the init files");
2437 if (daemon_type
== 2)
2441 /* Get rid of stdin, stdout and stderr. */
2442 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2444 err
|= dup2 (nfd
, STDIN_FILENO
) < 0;
2445 err
|= dup2 (nfd
, STDOUT_FILENO
) < 0;
2446 err
|= dup2 (nfd
, STDERR_FILENO
) < 0;
2447 err
|= emacs_close (nfd
) != 0;
2449 /* Closing the pipe will notify the parent that it can exit.
2450 FIXME: In case some other process inherited the pipe, closing it here
2451 won't notify the parent because it's still open elsewhere, so we
2452 additionally send a byte, just to make sure the parent really exits.
2453 Instead, we should probably close the pipe in start-process and
2454 call-process to make sure the pipe is never inherited by
2456 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2457 err
|= emacs_close (daemon_pipe
[1]) != 0;
2460 /* Set it to an invalid value so we know we've already run this function. */
2463 #else /* WINDOWSNT */
2464 /* Signal the waiting emacsclient process. */
2465 err
|= SetEvent (w32_daemon_event
) == 0;
2466 err
|= CloseHandle (w32_daemon_event
) == 0;
2467 /* Set it to an invalid value so we know we've already run this function. */
2468 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2472 error ("I/O error during daemon initialization");
2477 syms_of_emacs (void)
2479 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2480 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2481 DEFSYM (Qkill_emacs
, "kill-emacs");
2482 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2485 defsubr (&Sdump_emacs
);
2488 defsubr (&Skill_emacs
);
2490 defsubr (&Sinvocation_name
);
2491 defsubr (&Sinvocation_directory
);
2492 defsubr (&Sdaemonp
);
2493 defsubr (&Sdaemon_initialized
);
2495 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2496 doc
: /* Args passed by shell to Emacs, as a list of strings.
2497 Many arguments are deleted from the list as they are processed. */);
2499 DEFVAR_LISP ("system-type", Vsystem_type
,
2500 doc
: /* The value is a symbol indicating the type of operating system you are using.
2502 `gnu' compiled for a GNU Hurd system.
2503 `gnu/linux' compiled for a GNU/Linux system.
2504 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2505 `darwin' compiled for Darwin (GNU-Darwin, macOS, ...).
2506 `ms-dos' compiled as an MS-DOS application.
2507 `windows-nt' compiled as a native W32 application.
2508 `cygwin' compiled using the Cygwin library.
2509 Anything else (in Emacs 26, the possibilities are: aix, berkeley-unix,
2510 hpux, usg-unix-v) indicates some sort of Unix system. */);
2511 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2512 /* See configure.ac for the possible SYSTEM_TYPEs. */
2514 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2515 doc
: /* Value is string indicating configuration Emacs was built for. */);
2516 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2518 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2519 doc
: /* String containing the configuration options Emacs was built with. */);
2520 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2522 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2523 doc
: /* String listing some of the main features this Emacs was compiled with.
2524 An element of the form \"FOO\" generally means that HAVE_FOO was
2525 defined during the build.
2527 This is mainly intended for diagnostic purposes in bug reports.
2528 Don't rely on it for testing whether a feature you want to use is available. */);
2529 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2531 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2532 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2534 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2535 doc
: /* Hook run when `kill-emacs' is called.
2536 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2537 in other similar situations), functions placed on this hook should not
2538 expect to be able to interact with the user. To ask for confirmation,
2539 see `kill-emacs-query-functions' instead.
2541 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2542 `noninteractive' was non-nil. */);
2543 Vkill_emacs_hook
= Qnil
;
2545 DEFVAR_LISP ("path-separator", Vpath_separator
,
2546 doc
: /* String containing the character that separates directories in
2547 search paths, such as PATH and other similar environment variables. */);
2550 Vpath_separator
= make_string (&c
, 1);
2553 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2554 doc
: /* The program name that was used to run Emacs.
2555 Any directory names are omitted. */);
2557 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2558 doc
: /* The directory in which the Emacs executable was found, to run it.
2559 The value is nil if that directory's name is not known. */);
2561 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2562 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2563 In an installed Emacs, this is normally nil. It is non-nil if
2564 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2565 within the variable `invocation-directory' or its parent. For example,
2566 this is the case when running an uninstalled Emacs executable from its
2567 build directory. */);
2568 Vinstallation_directory
= Qnil
;
2570 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2571 doc
: /* System locale for messages. */);
2572 Vsystem_messages_locale
= Qnil
;
2574 DEFVAR_LISP ("previous-system-messages-locale",
2575 Vprevious_system_messages_locale
,
2576 doc
: /* Most recently used system locale for messages. */);
2577 Vprevious_system_messages_locale
= Qnil
;
2579 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2580 doc
: /* System locale for time. */);
2581 Vsystem_time_locale
= Qnil
;
2583 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2584 doc
: /* Most recently used system locale for time. */);
2585 Vprevious_system_time_locale
= Qnil
;
2587 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2588 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2589 Vbefore_init_time
= Qnil
;
2591 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2592 doc
: /* Value of `current-time' after loading the init files.
2593 This is nil during initialization. */);
2594 Vafter_init_time
= Qnil
;
2596 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2597 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2598 inhibit_x_resources
= 0;
2600 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2601 doc
: /* Short copyright string for this version of Emacs. */);
2602 Vemacs_copyright
= build_string (emacs_copyright
);
2604 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2605 doc
: /* Version numbers of this version of Emacs. */);
2606 Vemacs_version
= build_string (emacs_version
);
2608 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2609 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2610 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2612 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2613 doc
: /* Alist of dynamic libraries vs external files implementing them.
2614 Each element is a list (LIBRARY FILE...), where the car is a symbol
2615 representing a supported external library, and the rest are strings giving
2616 alternate filenames for that library.
2618 Emacs tries to load the library from the files in the order they appear on
2619 the list; if none is loaded, the running session of Emacs won't have access
2622 Note that image types `pbm' and `xbm' do not need entries in this variable
2623 because they do not depend on external libraries and are always available.
2625 Also note that this is not a generic facility for accessing external
2626 libraries; only those already known by Emacs will be loaded. */);
2627 Vdynamic_library_alist
= Qnil
;
2628 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2631 Vlibrary_cache
= Qnil
;
2632 staticpro (&Vlibrary_cache
);