1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2012
4 Free Software Foundation, Inc.
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
11 (at 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/>. */
27 #include <sys/types.h>
36 #include <windows.h> /* just for w32.h */
38 #include "w32heap.h" /* for prototype of sbrk */
41 #ifdef NS_IMPL_GNUSTEP
42 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
43 #include <GNUstepBase/GSConfig.h>
47 #include "intervals.h"
48 #include "character.h"
53 #include "blockinput.h"
54 #include "syssignal.h"
57 #include "termhooks.h"
69 #if (defined PROFILING \
70 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
71 # include <sys/gmon.h>
72 extern void moncontrol (int mode
);
85 #include <sys/resource.h>
88 #ifdef HAVE_PERSONALITY_LINUX32
89 #include <sys/personality.h>
96 static const char emacs_version
[] = VERSION
;
97 static const char emacs_copyright
[] = "Copyright (C) 2012 Free Software Foundation, Inc.";
99 /* Empty lisp strings. To avoid having to build any others. */
100 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
102 /* Set nonzero after Emacs has started up the first time.
103 Prevents reinitialization of the Lisp world and keymaps
104 on subsequent starts. */
108 extern void unexec_init_emacs_zone (void);
111 #ifdef DOUG_LEA_MALLOC
112 /* Preserves a pointer to the memory allocated that copies that
113 static data inside glibc's malloc. */
114 static void *malloc_state_ptr
;
115 /* From glibc, a routine that returns a copy of the malloc internal state. */
116 extern void *malloc_get_state (void);
117 /* From glibc, a routine that overwrites the malloc internal state. */
118 extern int malloc_set_state (void*);
119 /* Non-zero if the MALLOC_CHECK_ environment variable was set while
120 dumping. Used to work around a bug in glibc's malloc. */
121 static int malloc_using_checking
;
124 Lisp_Object Qfile_name_handler_alist
;
126 Lisp_Object Qrisky_local_variable
;
128 Lisp_Object Qkill_emacs
;
130 /* If non-zero, Emacs should not attempt to use a window-specific code,
131 but instead should use the virtual terminal under which it was started. */
132 int inhibit_window_system
;
134 /* If non-zero, a filter or a sentinel is running. Tested to save the match
135 data on the first attempt to change it inside asynchronous code. */
136 int running_asynch_code
;
138 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
139 /* If non-zero, -d was specified, meaning we're using some window system. */
143 /* An address near the bottom of the stack.
144 Tells GC how to save a copy of the stack. */
147 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
148 /* The address where the heap starts (from the first sbrk (0) call). */
149 static void *my_heap_start
;
153 /* The gap between BSS end and heap start as far as we can tell. */
154 static uprintmax_t heap_bss_diff
;
157 /* Nonzero means running Emacs without interactive terminal. */
160 /* Nonzero means remove site-lisp directories from load-path. */
163 /* Name for the server started by the daemon.*/
164 static char *daemon_name
;
166 /* Pipe used to send exit notification to the daemon parent at
170 /* Save argv and argc. */
174 static void sort_args (int argc
, char **argv
);
175 static void syms_of_emacs (void);
177 /* MSVC needs each string be shorter than 2048 bytes, so the usage
178 strings below are split to not overflow this limit. */
180 Usage: %s [OPTION-OR-FILENAME]...\n\
182 Run Emacs, the extensible, customizable, self-documenting real-time\n\
183 display editor. The recommended way to start Emacs for normal editing\n\
184 is with no options at all.\n\
186 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
187 read the main documentation for these command-line arguments.\n\
189 Initialization options:\n\
191 --batch do not do interactive display; implies -q\n\
192 --chdir DIR change to directory DIR\n\
193 --daemon start a server in the background\n\
194 --debug-init enable Emacs Lisp debugger for init file\n\
195 --display, -d DISPLAY use X server DISPLAY\n\
196 --no-desktop do not load a saved desktop\n\
197 --no-init-file, -q load neither ~/.emacs nor default.el\n\
198 --no-shared-memory, -nl do not use shared memory\n\
199 --no-site-file do not load site-start.el\n\
200 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
201 --no-splash do not display a splash screen on startup\n\
202 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
203 --quick, -Q equivalent to:\n\
204 -q --no-site-file --no-site-lisp --no-splash\n\
205 --script FILE run FILE as an Emacs Lisp script\n\
206 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
207 --user, -u USER load ~USER/.emacs instead of your own\n\
213 FILE visit FILE using find-file\n\
214 +LINE go to line LINE in next FILE\n\
215 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
216 --directory, -L DIR add DIR to variable load-path\n\
217 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
218 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
219 --file FILE visit FILE using find-file\n\
220 --find-file FILE visit FILE using find-file\n\
221 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
222 --insert FILE insert contents of FILE into current buffer\n\
223 --kill exit without asking for confirmation\n\
224 --load, -l FILE load Emacs Lisp FILE using the load function\n\
225 --visit FILE visit FILE using find-file\n\
231 --background-color, -bg COLOR window background color\n\
232 --basic-display, -D disable many display features;\n\
233 used for debugging Emacs\n\
234 --border-color, -bd COLOR main border color\n\
235 --border-width, -bw WIDTH width of main border\n\
236 --color, --color=MODE override color mode for character terminals;\n\
237 MODE defaults to `auto', and\n\
238 can also be `never', `always',\n\
239 or a mode name like `ansi8'\n\
240 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
241 --font, -fn FONT default font; must be fixed-width\n\
242 --foreground-color, -fg COLOR window foreground color\n\
243 --fullheight, -fh make the first frame high as the screen\n\
244 --fullscreen, -fs make the first frame fullscreen\n\
245 --fullwidth, -fw make the first frame wide as the screen\n\
246 --maximized, -mm make the first frame maximized\n\
247 --geometry, -g GEOMETRY window geometry\n\
248 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
249 --iconic start Emacs in iconified state\n\
250 --internal-border, -ib WIDTH width between text and main border\n\
251 --line-spacing, -lsp PIXELS additional space to put between lines\n\
252 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
253 --name NAME title for initial Emacs frame\n\
254 --no-blinking-cursor, -nbc disable blinking cursor\n\
255 --reverse-video, -r, -rv switch foreground and background\n\
256 --title, -T TITLE title for initial Emacs frame\n\
257 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
258 --xrm XRESOURCES set additional X resources\n\
259 --parent-id XID set parent window\n\
260 --help display this help and exit\n\
261 --version output version information and exit\n\
265 You can generally also specify long option names with a single -; for\n\
266 example, -batch as well as --batch. You can use any unambiguous\n\
267 abbreviation for a --option.\n\
269 Various environment variables and window system resources also affect\n\
270 Emacs' operation. See the main documentation.\n\
272 Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs\n\
273 section of the Emacs manual or the file BUGS.\n"
276 /* Signal code for the fatal signal that was received. */
277 static int fatal_error_code
;
279 /* Nonzero if handling a fatal error already. */
280 int fatal_error_in_progress
;
282 #ifdef FORWARD_SIGNAL_TO_MAIN_THREAD
283 /* When compiled with GTK and running under Gnome,
284 multiple threads may be created. Keep track of our main
285 thread to make sure signals are delivered to it (see syssignal.h). */
287 pthread_t main_thread
;
291 /* NS autrelease pool, for memory management. */
292 static void *ns_pool
;
297 /* Handle bus errors, invalid instruction, etc. */
298 #ifndef FLOAT_CATCH_SIGILL
302 fatal_error_signal (int sig
)
304 SIGNAL_THREAD_CHECK (sig
);
305 fatal_error_code
= sig
;
306 signal (sig
, SIG_DFL
);
308 TOTALLY_UNBLOCK_INPUT
;
310 /* If fatal error occurs in code below, avoid infinite recursion. */
311 if (! fatal_error_in_progress
)
313 fatal_error_in_progress
= 1;
315 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
316 Fkill_emacs (make_number (sig
));
318 shut_down_emacs (sig
, 0, Qnil
);
321 /* Signal the same code; this time it will really be fatal.
322 Remember that since we're in a signal handler, the signal we're
323 going to send is probably blocked, so we have to unblock it if we
324 want to really receive it. */
326 sigunblock (sigmask (fatal_error_code
));
329 kill (getpid (), fatal_error_code
);
334 /* Handler for SIGDANGER. */
336 memory_warning_signal (int sig
)
338 signal (sig
, memory_warning_signal
);
339 SIGNAL_THREAD_CHECK (sig
);
341 malloc_warning ("Operating system warns that virtual memory is running low.\n");
343 /* It might be unsafe to call do_auto_save now. */
344 force_auto_save_soon ();
348 /* We define abort, rather than using it from the library,
349 so that GDB can return from a breakpoint here.
350 MSDOS has its own definition in msdos.c. */
352 #if ! defined (DOS_NT) && ! defined (NO_ABORT)
357 kill (getpid (), SIGABRT
);
358 /* This shouldn't be executed, but it prevents a warning. */
364 /* Code for dealing with Lisp access to the Unix command line. */
367 init_cmdargs (int argc
, char **argv
, int skip_args
)
370 Lisp_Object name
, dir
, handler
;
371 ptrdiff_t count
= SPECPDL_INDEX ();
372 Lisp_Object raw_name
;
377 raw_name
= build_string (argv
[0]);
379 /* Add /: to the front of the name
380 if it would otherwise be treated as magic. */
381 handler
= Ffind_file_name_handler (raw_name
, Qt
);
382 if (! NILP (handler
))
383 raw_name
= concat2 (build_string ("/:"), raw_name
);
385 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
386 Vinvocation_directory
= Ffile_name_directory (raw_name
);
388 /* If we got no directory in argv[0], search PATH to find where
389 Emacs actually came from. */
390 if (NILP (Vinvocation_directory
))
393 int yes
= openp (Vexec_path
, Vinvocation_name
,
394 Vexec_suffixes
, &found
, make_number (X_OK
));
397 /* Add /: to the front of the name
398 if it would otherwise be treated as magic. */
399 handler
= Ffind_file_name_handler (found
, Qt
);
400 if (! NILP (handler
))
401 found
= concat2 (build_string ("/:"), found
);
402 Vinvocation_directory
= Ffile_name_directory (found
);
406 if (!NILP (Vinvocation_directory
)
407 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
408 /* Emacs was started with relative path, like ./emacs.
410 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, Qnil
);
412 Vinstallation_directory
= Qnil
;
414 if (!NILP (Vinvocation_directory
))
416 dir
= Vinvocation_directory
;
418 /* If we are running from the build directory, set DIR to the
419 src subdirectory of the Emacs tree, like on Posix
421 if (SBYTES (dir
) > sizeof ("/i386/") - 1
422 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
424 dir
= Fexpand_file_name (build_string ("../.."), dir
);
425 #else /* !WINDOWSNT */
427 name
= Fexpand_file_name (Vinvocation_name
, dir
);
430 Lisp_Object tem
, lib_src_exists
;
431 Lisp_Object etc_exists
, info_exists
;
433 /* See if dir contains subdirs for use by Emacs.
434 Check for the ones that would exist in a build directory,
435 not including lisp and info. */
436 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
437 lib_src_exists
= Ffile_exists_p (tem
);
440 /* MSDOS installations frequently remove lib-src, but we still
441 must set installation-directory, or else info won't find
442 its files (it uses the value of installation-directory). */
443 tem
= Fexpand_file_name (build_string ("info"), dir
);
444 info_exists
= Ffile_exists_p (tem
);
449 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
451 tem
= Fexpand_file_name (build_string ("etc"), dir
);
452 etc_exists
= Ffile_exists_p (tem
);
453 if (!NILP (etc_exists
))
455 Vinstallation_directory
456 = Ffile_name_as_directory (dir
);
461 /* See if dir's parent contains those subdirs. */
462 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
463 lib_src_exists
= Ffile_exists_p (tem
);
467 /* See the MSDOS commentary above. */
468 tem
= Fexpand_file_name (build_string ("../info"), dir
);
469 info_exists
= Ffile_exists_p (tem
);
474 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
476 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
477 etc_exists
= Ffile_exists_p (tem
);
478 if (!NILP (etc_exists
))
480 tem
= Fexpand_file_name (build_string (".."), dir
);
481 Vinstallation_directory
482 = Ffile_name_as_directory (tem
);
487 /* If the Emacs executable is actually a link,
488 next try the dir that the link points into. */
489 tem
= Ffile_symlink_p (name
);
492 name
= Fexpand_file_name (tem
, dir
);
493 dir
= Ffile_name_directory (name
);
500 Vcommand_line_args
= Qnil
;
502 for (i
= argc
- 1; i
>= 0; i
--)
504 if (i
== 0 || i
> skip_args
)
505 /* For the moment, we keep arguments as is in unibyte strings.
506 They are decoded in the function command-line after we know
507 locale-coding-system. */
509 = Fcons (make_unibyte_string (argv
[i
], strlen (argv
[i
])),
513 unbind_to (count
, Qnil
);
516 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
517 doc
: /* Return the program name that was used to run Emacs.
518 Any directory names are omitted. */)
521 return Fcopy_sequence (Vinvocation_name
);
524 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
526 doc
: /* Return the directory name in which the Emacs executable was located. */)
529 return Fcopy_sequence (Vinvocation_directory
);
534 /* A valid but unlikely value for the TZ environment value.
535 It is OK (though a bit slower) if the user actually chooses this value. */
536 static char dump_tz
[] = "UtC0";
539 #ifndef ORDINARY_LINK
540 /* We don't include crtbegin.o and crtend.o in the link,
541 so these functions and variables might be missed.
542 Provide dummy definitions to avoid error.
543 (We don't have any real constructors or destructors.) */
546 /* Define a dummy function F. Declare F too, to pacify gcc
547 -Wmissing-prototypes. */
548 #define DEFINE_DUMMY_FUNCTION(f) \
549 void f (void) ATTRIBUTE_CONST EXTERNALLY_VISIBLE; void f (void) {}
551 #ifndef GCC_CTORS_IN_LIBC
552 DEFINE_DUMMY_FUNCTION (__do_global_ctors
)
553 DEFINE_DUMMY_FUNCTION (__do_global_ctors_aux
)
554 DEFINE_DUMMY_FUNCTION (__do_global_dtors
)
555 /* GNU/Linux has a bug in its library; avoid an error. */
557 char * __CTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
559 char * __DTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
560 #endif /* GCC_CTORS_IN_LIBC */
561 DEFINE_DUMMY_FUNCTION (__main
)
562 #endif /* __GNUC__ */
563 #endif /* ORDINARY_LINK */
565 /* Test whether the next argument in ARGV matches SSTR or a prefix of
566 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
567 (the argument is supposed to have a value) store in *VALPTR either
568 the next argument or the portion of this one after the equal sign.
569 ARGV is read starting at position *SKIPPTR; this index is advanced
570 by the number of arguments used.
572 Too bad we can't just use getopt for all of this, but we don't have
573 enough information to do it right. */
576 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
577 int minlen
, char **valptr
, int *skipptr
)
583 /* Don't access argv[argc]; give up in advance. */
584 if (argc
<= *skipptr
+ 1)
587 arg
= argv
[*skipptr
+1];
590 if (strcmp (arg
, sstr
) == 0)
594 *valptr
= argv
[*skipptr
+2];
601 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
602 ? p
- arg
: strlen (arg
));
603 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
605 else if (valptr
== NULL
)
616 else if (argv
[*skipptr
+2] != NULL
)
618 *valptr
= argv
[*skipptr
+2];
628 #ifdef DOUG_LEA_MALLOC
630 /* malloc can be invoked even before main (e.g. by the dynamic
631 linker), so the dumped malloc state must be restored as early as
632 possible using this special hook. */
635 malloc_initialize_hook (void)
639 if (!malloc_using_checking
)
640 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
641 ignored if the heap to be restored was constructed without
642 malloc checking. Can't use unsetenv, since that calls malloc. */
646 for (p
= environ
; p
&& *p
; p
++)
647 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
656 malloc_set_state (malloc_state_ptr
);
657 #ifndef XMALLOC_OVERRUN_CHECK
658 free (malloc_state_ptr
);
663 if (my_heap_start
== 0)
664 my_heap_start
= sbrk (0);
665 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
669 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
671 #endif /* DOUG_LEA_MALLOC */
676 main (int argc
, char **argv
)
681 char stack_bottom_variable
;
682 int do_initial_setlocale
;
684 #ifdef HAVE_SETRLIMIT
699 #if defined (USE_GTK) && defined (G_SLICE_ALWAYS_MALLOC)
700 /* This is used by the Cygwin build. */
701 setenv ("G_SLICE", "always-malloc", 1);
707 extern char my_endbss
[];
708 extern char *my_endbss_static
;
710 if (my_heap_start
== 0)
711 my_heap_start
= sbrk (0);
713 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
717 #ifdef RUN_TIME_REMAP
719 run_time_remap (argv
[0]);
722 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
725 unexec_init_emacs_zone ();
728 sort_args (argc
, argv
);
730 while (argv
[argc
]) argc
++;
732 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
734 const char *version
, *copyright
;
737 Lisp_Object tem
, tem2
;
738 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
739 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
742 fprintf (stderr
, "Invalid value of `emacs-version'\n");
747 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
752 version
= SSDATA (tem
);
753 copyright
= SSDATA (tem2
);
758 version
= emacs_version
;
759 copyright
= emacs_copyright
;
761 printf ("GNU Emacs %s\n", version
);
762 printf ("%s\n", copyright
);
763 printf ("GNU Emacs comes with ABSOLUTELY NO WARRANTY.\n");
764 printf ("You may redistribute copies of Emacs\n");
765 printf ("under the terms of the GNU General Public License.\n");
766 printf ("For more information about these matters, ");
767 printf ("see the file named COPYING.\n");
771 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
772 if (chdir (ch_to_dir
) == -1)
774 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
775 argv
[0], ch_to_dir
, strerror (errno
));
780 #ifdef HAVE_PERSONALITY_LINUX32
782 && (strcmp (argv
[argc
-1], "dump") == 0
783 || strcmp (argv
[argc
-1], "bootstrap") == 0)
784 && ! getenv ("EMACS_HEAP_EXEC"))
786 static char heapexec
[] = "EMACS_HEAP_EXEC=true";
787 /* Set this so we only do this once. */
790 /* A flag to turn off address randomization which is introduced
791 in linux kernel shipped with fedora core 4 */
792 #define ADD_NO_RANDOMIZE 0x0040000
793 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
794 #undef ADD_NO_RANDOMIZE
796 execvp (argv
[0], argv
);
798 /* If the exec fails, try to dump anyway. */
801 #endif /* HAVE_PERSONALITY_LINUX32 */
803 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
804 /* Extend the stack space available.
805 Don't do that if dumping, since some systems (e.g. DJGPP)
806 might define a smaller stack limit at that time. */
809 && (!noninteractive
|| initialized
)
811 && !getrlimit (RLIMIT_STACK
, &rlim
))
814 extern size_t re_max_failures
;
815 /* Approximate the amount regex.c needs per unit of re_max_failures. */
816 int ratio
= 20 * sizeof (char *);
817 /* Then add 33% to cover the size of the smaller stacks that regex.c
818 successively allocates and discards, on its way to the maximum. */
820 /* Add in some extra to cover
821 what we're likely to use for other reasons. */
822 newlim
= re_max_failures
* ratio
+ 200000;
824 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
825 stack allocation routine for new process that the allocation
826 fails if stack limit is not on page boundary. So, round up the
827 new limit to page boundary. */
828 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
830 if (newlim
> rlim
.rlim_max
)
832 newlim
= rlim
.rlim_max
;
833 /* Don't let regex.c overflow the stack we have. */
834 re_max_failures
= (newlim
- 200000) / ratio
;
836 if (rlim
.rlim_cur
< newlim
)
837 rlim
.rlim_cur
= newlim
;
839 setrlimit (RLIMIT_STACK
, &rlim
);
841 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
843 /* Record (approximately) where the stack begins. */
844 stack_bottom
= &stack_bottom_variable
;
848 #ifndef SYSTEM_MALLOC
849 /* Arrange to get warning messages as memory fills up. */
850 memory_warnings (0, malloc_warning
);
852 /* Call malloc at least once, to run the initial __malloc_hook.
853 Also call realloc and free for consistency. */
854 free (realloc (malloc (4), 4));
857 /* Arrange to disable interrupt input inside malloc etc. */
858 uninterrupt_malloc ();
859 # endif /* not SYNC_INPUT */
860 #endif /* not SYSTEM_MALLOC */
862 #ifdef FORWARD_SIGNAL_TO_MAIN_THREAD
863 main_thread
= pthread_self ();
864 #endif /* FORWARD_SIGNAL_TO_MAIN_THREAD */
866 #if defined (MSDOS) || defined (WINDOWSNT)
867 /* We do all file input/output as binary files. When we need to translate
868 newlines, we do that manually. */
870 #endif /* MSDOS || WINDOWSNT */
873 if (!isatty (fileno (stdin
)))
874 setmode (fileno (stdin
), O_BINARY
);
875 if (!isatty (fileno (stdout
)))
878 setmode (fileno (stdout
), O_BINARY
);
882 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
883 The build procedure uses this while dumping, to ensure that the
884 dumped Emacs does not have its system locale tables initialized,
885 as that might cause screwups when the dumped Emacs starts up. */
887 char *lc_all
= getenv ("LC_ALL");
888 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
891 /* Set locale now, so that initial error messages are localized properly.
892 fixup_locale must wait until later, since it builds strings. */
893 if (do_initial_setlocale
)
894 setlocale (LC_ALL
, "");
896 inhibit_window_system
= 0;
898 /* Handle the -t switch, which specifies filename to use as terminal. */
902 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
907 result
= emacs_open (term
, O_RDWR
, 0);
908 if (result
< 0 || dup (0) < 0)
910 char *errstring
= strerror (errno
);
911 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
916 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
919 fprintf (stderr
, "Using %s\n", term
);
920 #ifdef HAVE_WINDOW_SYSTEM
921 inhibit_window_system
= 1; /* -t => -nw */
928 /* Command line option --no-windows is deprecated and thus not mentioned
929 in the manual and usage information. */
930 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
931 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
932 inhibit_window_system
= 1;
934 /* Handle the -batch switch, which means don't do interactive display. */
936 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
939 Vundo_outer_limit
= Qnil
;
941 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
943 noninteractive
= 1; /* Set batch mode. */
944 /* Convert --script to -scriptload, un-skip it, and sort again
945 so that it will be handled in proper sequence. */
946 /* FIXME broken for --script=FILE - is that supposed to work? */
947 argv
[skip_args
- 1] = (char *) "-scriptload";
949 sort_args (argc
, argv
);
952 /* Handle the --help option, which gives a usage message. */
953 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
955 printf (USAGE1
, argv
[0], USAGE2
);
961 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
962 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
967 /* Start as a daemon: fork a new child process which will run the
968 rest of the initialization code, then exit.
970 Detaching a daemon requires the following steps:
974 - close the tty file-descriptors
976 We only want to do the last 2 steps once the daemon is ready to
977 serve requests, i.e. after loading .emacs (initialization).
978 OTOH initialization may start subprocesses (e.g. ispell) and these
979 should be run from the proper process (the one that will end up
980 running as daemon) and with the proper "session id" in order for
981 them to keep working after detaching, so fork and setsid need to be
982 performed before initialization.
984 We want to avoid exiting before the server socket is ready, so
985 use a pipe for synchronization. The parent waits for the child
986 to close its end of the pipe (using `daemon-initialized')
988 if (pipe (daemon_pipe
) == -1)
990 fprintf (stderr
, "Cannot pipe!\n");
994 #ifndef NS_IMPL_COCOA
996 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
997 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
998 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1001 #else /* NS_IMPL_COCOA */
1002 /* Under Cocoa we must do fork+exec as CoreFoundation lib fails in
1003 forked process: http://developer.apple.com/ReleaseNotes/
1004 CoreFoundation/CoreFoundation.html)
1005 We mark being in the exec'd process by a daemon name argument of
1006 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
1007 NAME is the original daemon name, if any. */
1008 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1009 f
= fork (); /* in orig */
1011 f
= 0; /* in exec'd */
1012 #endif /* NS_IMPL_COCOA */
1018 /* Close unused writing end of the pipe. */
1019 close (daemon_pipe
[1]);
1021 /* Just wait for the child to close its end of the pipe. */
1024 retval
= read (daemon_pipe
[0], &buf
, 1);
1026 while (retval
== -1 && errno
== EINTR
);
1030 fprintf (stderr
, "Error reading status from child\n");
1033 else if (retval
== 0)
1035 fprintf (stderr
, "Error: server did not start correctly\n");
1039 close (daemon_pipe
[0]);
1044 fprintf (stderr
, "Cannot fork!\n");
1048 #ifdef NS_IMPL_COCOA
1050 /* In orig process, forked as child, OR in exec'd. */
1051 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1052 { /* In orig, child: now exec w/special daemon name. */
1055 snprintf (fdStr
, sizeof fdStr
,
1056 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1057 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1059 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1061 fprintf (stderr
, "daemon: child name too long\n");
1065 argv
[skip_args
] = fdStr
;
1067 execv (argv
[0], argv
);
1068 fprintf (stderr
, "emacs daemon: exec failed: %d\n", errno
);
1072 /* In exec'd: parse special dname into pipe and name info. */
1073 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1074 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1076 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1079 dname_arg2
[0] = '\0';
1080 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1082 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1084 #endif /* NS_IMPL_COCOA */
1087 daemon_name
= xstrdup (dname_arg
);
1088 /* Close unused reading end of the pipe. */
1089 close (daemon_pipe
[0]);
1090 /* Make sure that the used end of the pipe is closed on exec, so
1091 that it is not accessible to programs started from .emacs. */
1092 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1098 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1103 if (! noninteractive
)
1105 #if defined (USG5) && defined (INTERRUPT_INPUT)
1108 #if defined (HAVE_PTHREAD) && !defined (SYSTEM_MALLOC) && !defined (DOUG_LEA_MALLOC)
1110 extern void malloc_enable_thread (void);
1112 malloc_enable_thread ();
1119 /* Don't catch SIGHUP if dumping. */
1126 sigblock (sigmask (SIGHUP
));
1127 /* In --batch mode, don't catch SIGHUP if already ignored.
1128 That makes nohup work. */
1129 if (! noninteractive
1130 || signal (SIGHUP
, SIG_IGN
) != SIG_IGN
)
1131 signal (SIGHUP
, fatal_error_signal
);
1132 sigunblock (sigmask (SIGHUP
));
1137 ! noninteractive
|| initialized
1143 /* Don't catch these signals in batch mode if dumping.
1144 On some machines, this sets static data that would make
1145 signal fail to work right when the dumped Emacs is run. */
1146 signal (SIGQUIT
, fatal_error_signal
);
1147 signal (SIGILL
, fatal_error_signal
);
1148 signal (SIGTRAP
, fatal_error_signal
);
1150 add_user_signal (SIGUSR1
, "sigusr1");
1153 add_user_signal (SIGUSR2
, "sigusr2");
1156 signal (SIGABRT
, fatal_error_signal
);
1159 signal (SIGHWE
, fatal_error_signal
);
1162 signal (SIGPRE
, fatal_error_signal
);
1165 signal (SIGORE
, fatal_error_signal
);
1168 signal (SIGUME
, fatal_error_signal
);
1171 signal (SIGDLK
, fatal_error_signal
);
1174 signal (SIGCPULIM
, fatal_error_signal
);
1177 /* This is missing on some systems - OS/2, for example. */
1178 signal (SIGIOT
, fatal_error_signal
);
1181 signal (SIGEMT
, fatal_error_signal
);
1183 signal (SIGFPE
, fatal_error_signal
);
1185 signal (SIGBUS
, fatal_error_signal
);
1187 signal (SIGSEGV
, fatal_error_signal
);
1189 signal (SIGSYS
, fatal_error_signal
);
1191 /* May need special treatment on MS-Windows. See
1192 http://lists.gnu.org/archive/html/emacs-devel/2010-09/msg01062.html
1193 Please update the doc of kill-emacs, kill-emacs-hook, and
1194 NEWS if you change this.
1196 if (noninteractive
) signal (SIGINT
, fatal_error_signal
);
1197 signal (SIGTERM
, fatal_error_signal
);
1199 signal (SIGXCPU
, fatal_error_signal
);
1202 signal (SIGXFSZ
, fatal_error_signal
);
1203 #endif /* SIGXFSZ */
1206 /* This just means available memory is getting low. */
1207 signal (SIGDANGER
, memory_warning_signal
);
1211 /* 20 is SIGCHLD, 21 is SIGTTIN, 22 is SIGTTOU. */
1212 signal (SIGXCPU
, fatal_error_signal
);
1213 signal (SIGIOINT
, fatal_error_signal
);
1214 signal (SIGGRANT
, fatal_error_signal
);
1215 signal (SIGRETRACT
, fatal_error_signal
);
1216 signal (SIGSOUND
, fatal_error_signal
);
1217 signal (SIGMSG
, fatal_error_signal
);
1221 noninteractive1
= noninteractive
;
1223 /* Perform basic initializations (not merely interning symbols). */
1230 init_charset_once ();
1231 init_coding_once ();
1232 init_syntax_once (); /* Create standard syntax table. */
1233 init_category_once (); /* Create standard category table. */
1234 /* Must be done before init_buffer. */
1235 init_casetab_once ();
1236 init_buffer_once (); /* Create buffer table and some buffers. */
1237 init_minibuf_once (); /* Create list of minibuffers. */
1238 /* Must precede init_window_once. */
1240 /* Call syms_of_xfaces before init_window_once because that
1241 function creates Vterminal_frame. Termcap frames now use
1242 faces, and the face implementation uses some symbols as
1245 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1246 be better to arrange things not to have this dependency. */
1248 /* Call syms_of_keyboard before init_window_once because
1249 keyboard sets up symbols that include some face names that
1250 the X support will want to use. This can happen when
1251 CANNOT_DUMP is defined. */
1252 syms_of_keyboard ();
1254 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1257 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1259 /* Before syms_of_coding because it initializes Qcharsetp. */
1261 /* Before init_window_once, because it sets up the
1262 Vcoding_system_hash_table. */
1263 syms_of_coding (); /* This should be after syms_of_fileio. */
1265 init_window_once (); /* Init the window system. */
1266 #ifdef HAVE_WINDOW_SYSTEM
1267 init_fringe_once (); /* Swap bitmaps if necessary. */
1268 #endif /* HAVE_WINDOW_SYSTEM */
1273 if (do_initial_setlocale
)
1276 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1277 Vsystem_time_locale
= Vprevious_system_time_locale
;
1283 running_asynch_code
= 0;
1287 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1290 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1293 ns_pool
= ns_alloc_autorelease_pool ();
1294 if (!noninteractive
)
1296 #ifdef NS_IMPL_COCOA
1297 if (skip_args
< argc
)
1299 /* FIXME: Do the right thing if getenv returns NULL, or if
1301 if (!strncmp (argv
[skip_args
], "-psn", 4))
1304 chdir (getenv ("HOME"));
1306 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1309 chdir (getenv ("HOME"));
1314 #endif /* HAVE_NS */
1316 #ifdef HAVE_X_WINDOWS
1317 /* Stupid kludge to catch command-line display spec. We can't
1318 handle this argument entirely in window system dependent code
1319 because we don't even know which window system dependent code
1320 to run until we've recognized this argument. */
1322 char *displayname
= 0;
1323 int count_before
= skip_args
;
1325 /* Skip any number of -d options, but only use the last one. */
1328 int count_before_this
= skip_args
;
1330 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1332 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1337 count_before
= count_before_this
;
1340 /* If we have the form --display=NAME,
1341 convert it into -d name.
1342 This requires inserting a new element into argv. */
1343 if (displayname
&& count_before
< skip_args
)
1345 if (skip_args
== count_before
+ 1)
1347 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1348 (argc
- (count_before
+ 2)) * sizeof *argv
);
1349 argv
[count_before
+ 2] = displayname
;
1352 argv
[count_before
+ 1] = (char *) "-d";
1357 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1358 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1362 /* Don't actually discard this arg. */
1363 skip_args
= count_before
;
1365 #else /* !HAVE_X_WINDOWS */
1368 int count_before
= skip_args
;
1370 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1371 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1374 skip_args
= count_before
;
1378 /* argmatch must not be used after here,
1379 except when building temacs
1380 because the -d argument has not been skipped in skip_args. */
1383 /* Call early 'cause init_environment needs it. */
1385 /* Set defaults for several environment variables. */
1387 init_environment (argc
, argv
, skip_args
);
1394 /* Initialize environment from registry settings. */
1395 init_environment (argv
);
1396 init_ntproc (); /* must precede init_editfns. */
1399 /* Initialize and GC-protect Vinitial_environment and
1400 Vprocess_environment before set_initial_environment fills them
1403 syms_of_callproc ();
1404 /* egetenv is a pretty low-level facility, which may get called in
1405 many circumstances; it seems flimsy to put off initializing it
1406 until calling init_callproc. Do not do it when dumping. */
1407 if (initialized
|| ((strcmp (argv
[argc
-1], "dump") != 0
1408 && strcmp (argv
[argc
-1], "bootstrap") != 0)))
1409 set_initial_environment ();
1411 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1412 if this is not done. Do it after set_global_environment so that we
1413 don't pollute Vglobal_environment. */
1414 /* Setting LANG here will defeat the startup locale processing... */
1419 init_buffer (); /* Init default directory of main buffer. */
1421 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1422 init_cmdargs (argc
, argv
, skip_args
); /* Must precede init_lread. */
1426 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1427 Lisp_Object old_log_max
;
1428 old_log_max
= Vmessage_log_max
;
1429 XSETFASTINT (Vmessage_log_max
, 0);
1430 message_dolog ("", 0, 1, 0);
1431 Vmessage_log_max
= old_log_max
;
1434 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1437 /* Check to see if Emacs has been installed correctly. */
1438 check_windows_init_file ();
1441 /* Intern the names of all standard functions and variables;
1442 define standard keys. */
1446 /* The basic levels of Lisp must come first. Note that
1447 syms_of_data and some others have already been called. */
1453 syms_of_floatfns ();
1456 syms_of_bytecode ();
1458 syms_of_casefiddle ();
1460 syms_of_category ();
1462 syms_of_character ();
1469 syms_of_filelock ();
1472 /* syms_of_keymap (); */
1480 syms_of_terminal ();
1486 syms_of_textprop ();
1487 syms_of_composite ();
1490 #endif /* WINDOWSNT */
1494 #ifdef HAVE_WINDOW_SYSTEM
1497 #endif /* HAVE_WINDOW_SYSTEM */
1498 #ifdef HAVE_X_WINDOWS
1503 syms_of_xsettings ();
1510 #endif /* HAVE_X_WINDOWS */
1521 syms_of_w32select ();
1524 #endif /* HAVE_NTGUI */
1530 syms_of_win16select ();
1537 syms_of_nsselect ();
1539 #endif /* HAVE_NS */
1546 syms_of_dbusbind ();
1547 #endif /* HAVE_DBUS */
1551 #endif /* WINDOWSNT */
1553 keys_of_casefiddle ();
1556 keys_of_keyboard ();
1562 /* Initialization that must be done even if the global variable
1563 initialized is non zero. */
1565 globals_of_w32font ();
1566 globals_of_w32fns ();
1567 globals_of_w32menu ();
1568 globals_of_w32select ();
1569 #endif /* HAVE_NTGUI */
1574 init_editfns (); /* init_process_emacs uses Voperating_system_release. */
1575 init_process_emacs (); /* init_display uses add_keyboard_wait_descriptor. */
1576 init_keyboard (); /* This too must precede init_sys_modes. */
1577 if (!noninteractive
)
1578 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1580 #ifdef HAVE_WINDOW_SYSTEM
1582 #endif /* HAVE_WINDOW_SYSTEM */
1591 /* Handle -l loadup, args passed by Makefile. */
1592 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1593 Vtop_level
= Fcons (intern_c_string ("load"),
1594 Fcons (build_string (file
), Qnil
));
1595 /* Unless next switch is -nl, load "loadup.el" first thing. */
1597 Vtop_level
= Fcons (intern_c_string ("load"),
1598 Fcons (build_string ("loadup.el"), Qnil
));
1605 /* If the execution TZ happens to be the same as the dump TZ,
1606 change it to some other value and then change it back,
1607 to force the underlying implementation to reload the TZ info.
1608 This is needed on implementations that load TZ info from files,
1609 since the TZ file contents may differ between dump and execution. */
1610 char *tz
= getenv ("TZ");
1611 if (tz
&& !strcmp (tz
, dump_tz
))
1621 /* Set up for profiling. This is known to work on FreeBSD,
1622 GNU/Linux and MinGW. It might work on some other systems too.
1623 Give it a try and tell us if it works on your system. To compile
1624 for profiling, use the configure option --enable-profiling. */
1625 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1630 extern unsigned char etext
asm ("etext");
1636 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1645 #ifdef LOCALTIME_CACHE
1646 /* Some versions of localtime have a bug. They cache the value of the time
1647 zone rather than looking it up every time. Since localtime() is
1648 called to bolt the undumping time into the undumped emacs, this
1649 results in localtime ignoring the TZ environment variable.
1650 This flushes the new TZ value into localtime. */
1652 #endif /* defined (LOCALTIME_CACHE) */
1654 /* Enter editor command loop. This never returns. */
1660 /* Sort the args so we can find the most important ones
1661 at the beginning of argv. */
1663 /* First, here's a table of all the standard options. */
1665 struct standard_args
1668 const char *longname
;
1673 static const struct standard_args standard_args
[] =
1675 { "-version", "--version", 150, 0 },
1676 { "-chdir", "--chdir", 130, 1 },
1677 { "-t", "--terminal", 120, 1 },
1678 { "-nw", "--no-window-system", 110, 0 },
1679 { "-nw", "--no-windows", 110, 0 },
1680 { "-batch", "--batch", 100, 0 },
1681 { "-script", "--script", 100, 1 },
1682 { "-daemon", "--daemon", 99, 0 },
1683 { "-help", "--help", 90, 0 },
1684 { "-nl", "--no-loadup", 70, 0 },
1685 { "-nsl", "--no-site-lisp", 65, 0 },
1686 /* -d must come last before the options handled in startup.el. */
1687 { "-d", "--display", 60, 1 },
1688 { "-display", 0, 60, 1 },
1689 /* Now for the options handled in `command-line' (startup.el). */
1690 /* (Note that to imply -nsl, -Q is partially handled here.) */
1691 { "-Q", "--quick", 55, 0 },
1692 { "-quick", 0, 55, 0 },
1693 { "-q", "--no-init-file", 50, 0 },
1694 { "-no-init-file", 0, 50, 0 },
1695 { "-no-site-file", "--no-site-file", 40, 0 },
1696 { "-u", "--user", 30, 1 },
1697 { "-user", 0, 30, 1 },
1698 { "-debug-init", "--debug-init", 20, 0 },
1699 { "-iconic", "--iconic", 15, 0 },
1700 { "-D", "--basic-display", 12, 0},
1701 { "-basic-display", 0, 12, 0},
1702 { "-nbc", "--no-blinking-cursor", 12, 0 },
1703 /* Now for the options handled in `command-line-1' (startup.el). */
1704 { "-nbi", "--no-bitmap-icon", 10, 0 },
1705 { "-bg", "--background-color", 10, 1 },
1706 { "-background", 0, 10, 1 },
1707 { "-fg", "--foreground-color", 10, 1 },
1708 { "-foreground", 0, 10, 1 },
1709 { "-bd", "--border-color", 10, 1 },
1710 { "-bw", "--border-width", 10, 1 },
1711 { "-ib", "--internal-border", 10, 1 },
1712 { "-ms", "--mouse-color", 10, 1 },
1713 { "-cr", "--cursor-color", 10, 1 },
1714 { "-fn", "--font", 10, 1 },
1715 { "-font", 0, 10, 1 },
1716 { "-fs", "--fullscreen", 10, 0 },
1717 { "-fw", "--fullwidth", 10, 0 },
1718 { "-fh", "--fullheight", 10, 0 },
1719 { "-mm", "--maximized", 10, 0 },
1720 { "-g", "--geometry", 10, 1 },
1721 { "-geometry", 0, 10, 1 },
1722 { "-T", "--title", 10, 1 },
1723 { "-title", 0, 10, 1 },
1724 { "-name", "--name", 10, 1 },
1725 { "-xrm", "--xrm", 10, 1 },
1726 { "-parent-id", "--parent-id", 10, 1 },
1727 { "-r", "--reverse-video", 5, 0 },
1729 { "-reverse", 0, 5, 0 },
1730 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1731 { "-vb", "--vertical-scroll-bars", 5, 0 },
1732 { "-color", "--color", 5, 0},
1733 { "-no-splash", "--no-splash", 3, 0 },
1734 { "-no-desktop", "--no-desktop", 3, 0 },
1736 { "-NSAutoLaunch", 0, 5, 1 },
1737 { "-NXAutoLaunch", 0, 5, 1 },
1738 { "-disable-font-backend", "--disable-font-backend", 65, 0 },
1739 { "-_NSMachLaunch", 0, 85, 1 },
1740 { "-MachLaunch", 0, 85, 1 },
1741 { "-macosx", 0, 85, 0 },
1742 { "-NSHost", 0, 85, 1 },
1744 /* These have the same priority as ordinary file name args,
1745 so they are not reordered with respect to those. */
1746 { "-L", "--directory", 0, 1 },
1747 { "-directory", 0, 0, 1 },
1748 { "-l", "--load", 0, 1 },
1749 { "-load", 0, 0, 1 },
1750 /* This has no longname, because using --scriptload confuses sort_args,
1751 because then the --script long option seems to match twice; ie
1752 you can't have a long option which is a prefix of another long
1753 option. In any case, this is entirely an internal option. */
1754 { "-scriptload", NULL
, 0, 1 },
1755 { "-f", "--funcall", 0, 1 },
1756 { "-funcall", 0, 0, 1 },
1757 { "-eval", "--eval", 0, 1 },
1758 { "-execute", "--execute", 0, 1 },
1759 { "-find-file", "--find-file", 0, 1 },
1760 { "-visit", "--visit", 0, 1 },
1761 { "-file", "--file", 0, 1 },
1762 { "-insert", "--insert", 0, 1 },
1764 { "-NXOpen", 0, 0, 1 },
1765 { "-NXOpenTemp", 0, 0, 1 },
1766 { "-NSOpen", 0, 0, 1 },
1767 { "-NSOpenTemp", 0, 0, 1 },
1768 { "-GSFilePath", 0, 0, 1 },
1770 /* This should be processed after ordinary file name args and the like. */
1771 { "-kill", "--kill", -10, 0 },
1774 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1775 so that the highest priority ones come first.
1776 Do not change the order of elements of equal priority.
1777 If an option takes an argument, keep it and its argument together.
1779 If an option that takes no argument appears more
1780 than once, eliminate all but one copy of it. */
1783 sort_args (int argc
, char **argv
)
1785 char **new = xmalloc (argc
* sizeof *new);
1786 /* For each element of argv,
1787 the corresponding element of options is:
1788 0 for an option that takes no arguments,
1789 1 for an option that takes one argument, etc.
1790 -1 for an ordinary non-option argument. */
1791 int *options
= xnmalloc (argc
, sizeof *options
);
1792 int *priority
= xnmalloc (argc
, sizeof *priority
);
1794 int incoming_used
= 1;
1798 /* Categorize all the options,
1799 and figure out which argv elts are option arguments. */
1800 for (from
= 1; from
< argc
; from
++)
1804 if (argv
[from
][0] == '-')
1808 /* If we have found "--", don't consider
1809 any more arguments as options. */
1810 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1812 /* Leave the "--", and everything following it, at the end. */
1813 for (; from
< argc
; from
++)
1815 priority
[from
] = -100;
1821 /* Look for a match with a known old-fashioned option. */
1822 for (i
= 0; i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1823 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1825 options
[from
] = standard_args
[i
].nargs
;
1826 priority
[from
] = standard_args
[i
].priority
;
1827 if (from
+ standard_args
[i
].nargs
>= argc
)
1828 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1829 from
+= standard_args
[i
].nargs
;
1833 /* Look for a match with a known long option.
1834 MATCH is -1 if no match so far, -2 if two or more matches so far,
1835 >= 0 (the table index of the match) if just one match so far. */
1836 if (argv
[from
][1] == '-')
1838 char const *equals
= strchr (argv
[from
], '=');
1840 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1845 i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1846 if (standard_args
[i
].longname
1847 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1856 /* If we found exactly one match, use that. */
1859 options
[from
] = standard_args
[match
].nargs
;
1860 priority
[from
] = standard_args
[match
].priority
;
1861 /* If --OPTION=VALUE syntax is used,
1862 this option uses just one argv element. */
1865 if (from
+ options
[from
] >= argc
)
1866 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1867 from
+= options
[from
];
1869 /* FIXME When match < 0, shouldn't there be some error,
1870 or at least indication to the user that there was a
1877 /* Copy the arguments, in order of decreasing priority, to NEW. */
1879 while (incoming_used
< argc
)
1882 int best_priority
= -9999;
1884 /* Find the highest priority remaining option.
1885 If several have equal priority, take the first of them. */
1886 for (from
= 1; from
< argc
; from
++)
1888 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1890 best_priority
= priority
[from
];
1893 /* Skip option arguments--they are tied to the options. */
1894 if (options
[from
] > 0)
1895 from
+= options
[from
];
1901 /* Copy the highest priority remaining option, with its args, to NEW.
1902 Unless it is a duplicate of the previous one. */
1903 if (! (options
[best
] == 0
1904 && ! strcmp (new[to
- 1], argv
[best
])))
1906 new[to
++] = argv
[best
];
1907 for (i
= 0; i
< options
[best
]; i
++)
1908 new[to
++] = argv
[best
+ i
+ 1];
1911 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1913 /* Clear out this option in ARGV. */
1915 for (i
= 0; i
< options
[best
]; i
++)
1916 argv
[best
+ i
+ 1] = 0;
1919 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1923 memcpy (argv
, new, sizeof (char *) * argc
);
1930 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1931 doc
: /* Exit the Emacs job and kill it.
1932 If ARG is an integer, return ARG as the exit program code.
1933 If ARG is a string, stuff it as keyboard input.
1935 This function is called upon receipt of the signals SIGTERM
1936 or SIGHUP, and upon SIGINT in batch mode.
1938 The value of `kill-emacs-hook', if not void,
1939 is a list of functions (of no args),
1940 all of which are called before Emacs is actually killed. */)
1943 struct gcpro gcpro1
;
1952 hook
= intern ("kill-emacs-hook");
1953 Frun_hooks (1, &hook
);
1957 #ifdef HAVE_X_WINDOWS
1958 /* Transfer any clipboards we own to the clipboard manager. */
1959 x_clipboard_manager_save_all ();
1962 shut_down_emacs (0, 0, STRINGP (arg
) ? arg
: Qnil
);
1965 ns_release_autorelease_pool (ns_pool
);
1968 /* If we have an auto-save list file,
1969 kill it because we are exiting Emacs deliberately (not crashing).
1970 Do it after shut_down_emacs, which does an auto-save. */
1971 if (STRINGP (Vauto_save_list_file_name
))
1972 unlink (SSDATA (Vauto_save_list_file_name
));
1975 exit_code
= (XINT (arg
) < 0
1976 ? XINT (arg
) | INT_MIN
1977 : XINT (arg
) & INT_MAX
);
1978 else if (noninteractive
&& (fflush (stdout
) || ferror (stdout
)))
1979 exit_code
= EXIT_FAILURE
;
1981 exit_code
= EXIT_SUCCESS
;
1986 /* Perform an orderly shutdown of Emacs. Autosave any modified
1987 buffers, kill any child processes, clean up the terminal modes (if
1988 we're in the foreground), and other stuff like that. Don't perform
1989 any redisplay; this may be called when Emacs is shutting down in
1990 the background, or after its X connection has died.
1992 If SIG is a signal number, print a message for it.
1994 This is called by fatal signal handlers, X protocol error handlers,
1998 shut_down_emacs (int sig
, int no_x
, Lisp_Object stuff
)
2000 /* Prevent running of hooks from now on. */
2003 /* Don't update display from now on. */
2004 Vinhibit_redisplay
= Qt
;
2006 /* If we are controlling the terminal, reset terminal modes. */
2009 int pgrp
= EMACS_GETPGRP (0);
2010 int tpgrp
= tcgetpgrp (0);
2011 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2013 reset_all_sys_modes ();
2014 if (sig
&& sig
!= SIGTERM
)
2015 fprintf (stderr
, "Fatal error (%d)", sig
);
2020 reset_all_sys_modes ();
2023 stuff_buffered_input (stuff
);
2025 inhibit_sentinels
= 1;
2026 kill_buffer_processes (Qnil
);
2027 Fdo_auto_save (Qt
, Qnil
);
2029 #ifdef CLASH_DETECTION
2030 unlock_all_files ();
2033 #if 0 /* This triggers a bug in XCloseDisplay and is not needed. */
2034 #ifdef HAVE_X_WINDOWS
2035 /* It's not safe to call intern here. Maybe we are crashing. */
2036 if (!noninteractive
&& SYMBOLP (Vinitial_window_system
)
2037 && SCHARS (SYMBOL_NAME (Vinitial_window_system
)) == 1
2038 && SREF (SYMBOL_NAME (Vinitial_window_system
), 0) == 'x'
2040 Fx_close_current_connection ();
2041 #endif /* HAVE_X_WINDOWS */
2045 /* There is a tendency for a SIGIO signal to arrive within exit,
2046 and cause a SIGHUP because the input descriptor is already closed. */
2048 signal (SIGIO
, SIG_IGN
);
2055 /* Do this only if terminating normally, we want glyph matrices
2056 etc. in a core dump. */
2057 if (sig
== 0 || sig
== SIGTERM
)
2059 check_glyph_memory ();
2060 check_message_stack ();
2068 ns_term_shutdown (sig
);
2072 xml_cleanup_parser ();
2082 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2083 doc
: /* Dump current state of Emacs into executable file FILENAME.
2084 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2085 This is used in the file `loadup.el' when building Emacs.
2087 You must run Emacs in batch mode in order to dump it. */)
2088 (Lisp_Object filename
, Lisp_Object symfile
)
2092 ptrdiff_t count
= SPECPDL_INDEX ();
2096 if (! noninteractive
)
2097 error ("Dumping Emacs works only in batch mode");
2101 /* Warn if the gap between BSS end and heap start is larger than this. */
2102 # define MAX_HEAP_BSS_DIFF (1024*1024)
2104 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2106 fprintf (stderr
, "**************************************************\n");
2107 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2108 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2110 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2111 fprintf (stderr
, "fail because of this. See the section about\n");
2112 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2113 fprintf (stderr
, "**************************************************\n");
2115 #endif /* GNU_LINUX */
2117 /* Bind `command-line-processed' to nil before dumping,
2118 so that the dumped Emacs will process its command line
2119 and set up to work with X windows if appropriate. */
2120 symbol
= intern ("command-line-processed");
2121 specbind (symbol
, Qnil
);
2123 CHECK_STRING (filename
);
2124 filename
= Fexpand_file_name (filename
, Qnil
);
2125 if (!NILP (symfile
))
2127 CHECK_STRING (symfile
);
2128 if (SCHARS (symfile
))
2129 symfile
= Fexpand_file_name (symfile
, Qnil
);
2133 Vpurify_flag
= Qnil
;
2136 set_time_zone_rule (dump_tz
);
2137 #ifndef LOCALTIME_CACHE
2138 /* Force a tz reload, since set_time_zone_rule doesn't. */
2144 /* Tell malloc where start of impure now is. */
2145 /* Also arrange for warnings when nearly out of space. */
2146 #ifndef SYSTEM_MALLOC
2148 /* On Windows, this was done before dumping, and that once suffices.
2149 Meanwhile, my_edata is not valid on Windows. */
2151 extern char my_edata
[];
2152 memory_warnings (my_edata
, malloc_warning
);
2154 #endif /* not WINDOWSNT */
2155 #if defined (HAVE_PTHREAD) && !defined SYNC_INPUT
2156 /* Pthread may call malloc before main, and then we will get an endless
2157 loop, because pthread_self (see alloc.c) calls malloc the first time
2158 it is called on some systems. */
2159 reset_malloc_hooks ();
2161 #endif /* not SYSTEM_MALLOC */
2162 #ifdef DOUG_LEA_MALLOC
2163 malloc_state_ptr
= malloc_get_state ();
2166 #ifdef USE_MMAP_FOR_BUFFERS
2169 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2170 #ifdef USE_MMAP_FOR_BUFFERS
2173 #ifdef DOUG_LEA_MALLOC
2174 free (malloc_state_ptr
);
2179 return unbind_to (count
, Qnil
);
2182 #endif /* not CANNOT_DUMP */
2185 /* Recover from setlocale (LC_ALL, ""). */
2189 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2190 so that numbers are read and printed properly for Emacs Lisp. */
2191 setlocale (LC_NUMERIC
, "C");
2194 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2197 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2199 if (! EQ (*plocale
, desired_locale
))
2201 *plocale
= desired_locale
;
2202 setlocale (category
, (STRINGP (desired_locale
)
2203 ? SSDATA (desired_locale
)
2208 /* Set system time locale to match Vsystem_time_locale, if possible. */
2210 synchronize_system_time_locale (void)
2212 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2213 Vsystem_time_locale
);
2216 /* Set system messages locale to match Vsystem_messages_locale, if
2219 synchronize_system_messages_locale (void)
2222 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2223 Vsystem_messages_locale
);
2226 #endif /* HAVE_SETLOCALE */
2230 decode_env_path (const char *evarname
, const char *defalt
)
2232 const char *path
, *p
;
2233 Lisp_Object lpath
, element
, tem
;
2236 const char *emacs_dir
= egetenv ("emacs_dir");
2237 static const char *emacs_dir_env
= "%emacs_dir%/";
2238 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2241 /* It's okay to use getenv here, because this function is only used
2242 to initialize variables when Emacs starts up, and isn't called
2245 path
= getenv (evarname
);
2256 /* Ensure values from the environment use the proper directory separator. */
2259 char *path_copy
= alloca (strlen (path
) + 1);
2260 strcpy (path_copy
, path
);
2261 dostounix_filename (path_copy
);
2268 p
= strchr (path
, SEPCHAR
);
2270 p
= path
+ strlen (path
);
2271 element
= (p
- path
? make_string (path
, p
- path
)
2272 : build_string ("."));
2274 /* Relative file names in the default path are interpreted as
2275 being relative to $emacs_dir. */
2276 if (emacs_dir
&& defaulted
2277 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2278 element
= Fexpand_file_name (Fsubstring (element
,
2279 make_number (emacs_dir_len
),
2281 build_string (emacs_dir
));
2284 /* Add /: to the front of the name
2285 if it would otherwise be treated as magic. */
2286 tem
= Ffind_file_name_handler (element
, Qt
);
2288 /* However, if the handler says "I'm safe",
2289 don't bother adding /:. */
2293 prop
= Fget (tem
, intern ("safe-magic"));
2299 element
= concat2 (build_string ("/:"), element
);
2301 lpath
= Fcons (element
, lpath
);
2307 return Fnreverse (lpath
);
2310 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2311 doc
: /* Return non-nil if the current emacs process is a daemon.
2312 If the daemon was given a name argument, return that name. */)
2317 return build_string (daemon_name
);
2324 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2325 doc
: /* Mark the Emacs daemon as being initialized.
2326 This finishes the daemonization process by doing the other half of detaching
2327 from the parent process and its tty file descriptors. */)
2334 error ("This function can only be called if emacs is run as a daemon");
2336 if (daemon_pipe
[1] < 0)
2337 error ("The daemon has already been initialized");
2339 if (NILP (Vafter_init_time
))
2340 error ("This function can only be called after loading the init files");
2342 /* Get rid of stdin, stdout and stderr. */
2343 nfd
= open ("/dev/null", O_RDWR
);
2345 err
|= dup2 (nfd
, 0) < 0;
2346 err
|= dup2 (nfd
, 1) < 0;
2347 err
|= dup2 (nfd
, 2) < 0;
2348 err
|= close (nfd
) != 0;
2350 /* Closing the pipe will notify the parent that it can exit.
2351 FIXME: In case some other process inherited the pipe, closing it here
2352 won't notify the parent because it's still open elsewhere, so we
2353 additionally send a byte, just to make sure the parent really exits.
2354 Instead, we should probably close the pipe in start-process and
2355 call-process to make sure the pipe is never inherited by
2357 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2358 err
|= close (daemon_pipe
[1]) != 0;
2359 /* Set it to an invalid value so we know we've already run this function. */
2360 daemon_pipe
[1] = -1;
2363 error ("I/O error during daemon initialization");
2368 syms_of_emacs (void)
2370 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2371 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2372 DEFSYM (Qkill_emacs
, "kill-emacs");
2375 defsubr (&Sdump_emacs
);
2378 defsubr (&Skill_emacs
);
2380 defsubr (&Sinvocation_name
);
2381 defsubr (&Sinvocation_directory
);
2382 defsubr (&Sdaemonp
);
2383 defsubr (&Sdaemon_initialized
);
2385 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2386 doc
: /* Args passed by shell to Emacs, as a list of strings.
2387 Many arguments are deleted from the list as they are processed. */);
2389 DEFVAR_LISP ("system-type", Vsystem_type
,
2390 doc
: /* The value is a symbol indicating the type of operating system you are using.
2392 `gnu' compiled for a GNU Hurd system.
2393 `gnu/linux' compiled for a GNU/Linux system.
2394 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2395 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2396 `ms-dos' compiled as an MS-DOS application.
2397 `windows-nt' compiled as a native W32 application.
2398 `cygwin' compiled using the Cygwin library.
2399 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2400 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2401 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2402 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2404 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2405 doc
: /* Value is string indicating configuration Emacs was built for.
2406 On MS-Windows, the value reflects the OS flavor and version on which
2407 Emacs is running. */);
2408 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2410 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2411 doc
: /* String containing the configuration options Emacs was built with. */);
2412 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2414 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2415 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2417 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2418 doc
: /* Hook run when `kill-emacs' is called.
2419 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2420 in other similar situations), functions placed on this hook should not
2421 expect to be able to interact with the user. To ask for confirmation,
2422 see `kill-emacs-query-functions' instead.
2424 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2425 `noninteractive' was non-nil. */);
2426 Vkill_emacs_hook
= Qnil
;
2428 DEFVAR_LISP ("path-separator", Vpath_separator
,
2429 doc
: /* String containing the character that separates directories in
2430 search paths, such as PATH and other similar environment variables. */);
2433 Vpath_separator
= make_string (&c
, 1);
2436 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2437 doc
: /* The program name that was used to run Emacs.
2438 Any directory names are omitted. */);
2440 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2441 doc
: /* The directory in which the Emacs executable was found, to run it.
2442 The value is nil if that directory's name is not known. */);
2444 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2445 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2446 In an installed Emacs, this is normally nil. It is non-nil if
2447 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2448 within the variable `invocation-directory' or its parent. For example,
2449 this is the case when running an uninstalled Emacs executable from its
2450 build directory. */);
2451 Vinstallation_directory
= Qnil
;
2453 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2454 doc
: /* System locale for messages. */);
2455 Vsystem_messages_locale
= Qnil
;
2457 DEFVAR_LISP ("previous-system-messages-locale",
2458 Vprevious_system_messages_locale
,
2459 doc
: /* Most recently used system locale for messages. */);
2460 Vprevious_system_messages_locale
= Qnil
;
2462 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2463 doc
: /* System locale for time. */);
2464 Vsystem_time_locale
= Qnil
;
2466 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2467 doc
: /* Most recently used system locale for time. */);
2468 Vprevious_system_time_locale
= Qnil
;
2470 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2471 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2472 Vbefore_init_time
= Qnil
;
2474 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2475 doc
: /* Value of `current-time' after loading the init files.
2476 This is nil during initialization. */);
2477 Vafter_init_time
= Qnil
;
2479 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2480 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2481 inhibit_x_resources
= 0;
2483 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2484 doc
: /* Short copyright string for this version of Emacs. */);
2485 Vemacs_copyright
= build_string (emacs_copyright
);
2487 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2488 doc
: /* Version numbers of this version of Emacs. */);
2489 Vemacs_version
= build_string (emacs_version
);
2491 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2492 doc
: /* Alist of dynamic libraries vs external files implementing them.
2493 Each element is a list (LIBRARY FILE...), where the car is a symbol
2494 representing a supported external library, and the rest are strings giving
2495 alternate filenames for that library.
2497 Emacs tries to load the library from the files in the order they appear on
2498 the list; if none is loaded, the running session of Emacs won't have access
2501 Note that image types `pbm' and `xbm' do not need entries in this variable
2502 because they do not depend on external libraries and are always available.
2504 Also note that this is not a generic facility for accessing external
2505 libraries; only those already known by Emacs will be loaded. */);
2506 Vdynamic_library_alist
= Qnil
;
2507 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2509 /* Make sure IS_DAEMON starts up as false. */