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/>. */
26 #include <sys/types.h>
33 #ifdef HAVE_WINDOW_SYSTEM
35 #endif /* HAVE_WINDOW_SYSTEM */
39 #include <windows.h> /* just for w32.h */
41 #include "w32heap.h" /* for prototype of sbrk */
44 #ifdef NS_IMPL_GNUSTEP
45 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
46 #include <GNUstepBase/GSConfig.h>
50 #include "intervals.h"
51 #include "character.h"
56 #include "blockinput.h"
57 #include "syssignal.h"
60 #include "termhooks.h"
68 #if (defined PROFILING \
69 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
70 # include <sys/gmon.h>
71 extern void moncontrol (int mode
);
80 #include <sys/resource.h>
83 #ifdef HAVE_PERSONALITY_LINUX32
84 #include <sys/personality.h>
91 static const char emacs_version
[] = VERSION
;
92 static const char emacs_copyright
[] = "Copyright (C) 2012 Free Software Foundation, Inc.";
94 /* Empty lisp strings. To avoid having to build any others. */
95 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
97 /* Set after Emacs has started up the first time.
98 Prevents reinitialization of the Lisp world and keymaps
99 on subsequent starts. */
103 extern void unexec_init_emacs_zone (void);
106 #ifdef DOUG_LEA_MALLOC
107 /* Preserves a pointer to the memory allocated that copies that
108 static data inside glibc's malloc. */
109 static void *malloc_state_ptr
;
110 /* From glibc, a routine that returns a copy of the malloc internal state. */
111 extern void *malloc_get_state (void);
112 /* From glibc, a routine that overwrites the malloc internal state. */
113 extern int malloc_set_state (void*);
114 /* True if the MALLOC_CHECK_ environment variable was set while
115 dumping. Used to work around a bug in glibc's malloc. */
116 static bool malloc_using_checking
;
119 Lisp_Object Qfile_name_handler_alist
;
121 Lisp_Object Qrisky_local_variable
;
123 Lisp_Object Qkill_emacs
;
125 /* If true, Emacs should not attempt to use a window-specific code,
126 but instead should use the virtual terminal under which it was started. */
127 bool inhibit_window_system
;
129 /* If true, a filter or a sentinel is running. Tested to save the match
130 data on the first attempt to change it inside asynchronous code. */
131 bool running_asynch_code
;
133 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
134 /* If true, -d was specified, meaning we're using some window system. */
138 /* An address near the bottom of the stack.
139 Tells GC how to save a copy of the stack. */
142 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
143 /* The address where the heap starts (from the first sbrk (0) call). */
144 static void *my_heap_start
;
148 /* The gap between BSS end and heap start as far as we can tell. */
149 static uprintmax_t heap_bss_diff
;
152 /* True means running Emacs without interactive terminal. */
155 /* True means remove site-lisp directories from load-path. */
158 /* Name for the server started by the daemon.*/
159 static char *daemon_name
;
161 /* Pipe used to send exit notification to the daemon parent at
165 /* Save argv and argc. */
169 static void sort_args (int argc
, char **argv
);
170 static void syms_of_emacs (void);
172 /* MSVC needs each string be shorter than 2048 bytes, so the usage
173 strings below are split to not overflow this limit. */
175 Usage: %s [OPTION-OR-FILENAME]...\n\
177 Run Emacs, the extensible, customizable, self-documenting real-time\n\
178 display editor. The recommended way to start Emacs for normal editing\n\
179 is with no options at all.\n\
181 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
182 read the main documentation for these command-line arguments.\n\
184 Initialization options:\n\
186 --batch do not do interactive display; implies -q\n\
187 --chdir DIR change to directory DIR\n\
188 --daemon start a server in the background\n\
189 --debug-init enable Emacs Lisp debugger for init file\n\
190 --display, -d DISPLAY use X server DISPLAY\n\
191 --no-desktop do not load a saved desktop\n\
192 --no-init-file, -q load neither ~/.emacs nor default.el\n\
193 --no-shared-memory, -nl do not use shared memory\n\
194 --no-site-file do not load site-start.el\n\
195 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
196 --no-splash do not display a splash screen on startup\n\
197 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
198 --quick, -Q equivalent to:\n\
199 -q --no-site-file --no-site-lisp --no-splash\n\
200 --script FILE run FILE as an Emacs Lisp script\n\
201 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
202 --user, -u USER load ~USER/.emacs instead of your own\n\
208 FILE visit FILE using find-file\n\
209 +LINE go to line LINE in next FILE\n\
210 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
211 --directory, -L DIR add DIR to variable load-path\n\
212 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
213 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
214 --file FILE visit FILE using find-file\n\
215 --find-file FILE visit FILE using find-file\n\
216 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
217 --insert FILE insert contents of FILE into current buffer\n\
218 --kill exit without asking for confirmation\n\
219 --load, -l FILE load Emacs Lisp FILE using the load function\n\
220 --visit FILE visit FILE using find-file\n\
226 --background-color, -bg COLOR window background color\n\
227 --basic-display, -D disable many display features;\n\
228 used for debugging Emacs\n\
229 --border-color, -bd COLOR main border color\n\
230 --border-width, -bw WIDTH width of main border\n\
231 --color, --color=MODE override color mode for character terminals;\n\
232 MODE defaults to `auto', and\n\
233 can also be `never', `always',\n\
234 or a mode name like `ansi8'\n\
235 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
236 --font, -fn FONT default font; must be fixed-width\n\
237 --foreground-color, -fg COLOR window foreground color\n\
238 --fullheight, -fh make the first frame high as the screen\n\
239 --fullscreen, -fs make the first frame fullscreen\n\
240 --fullwidth, -fw make the first frame wide as the screen\n\
241 --maximized, -mm make the first frame maximized\n\
242 --geometry, -g GEOMETRY window geometry\n\
243 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
244 --iconic start Emacs in iconified state\n\
245 --internal-border, -ib WIDTH width between text and main border\n\
246 --line-spacing, -lsp PIXELS additional space to put between lines\n\
247 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
248 --name NAME title for initial Emacs frame\n\
249 --no-blinking-cursor, -nbc disable blinking cursor\n\
250 --reverse-video, -r, -rv switch foreground and background\n\
251 --title, -T TITLE title for initial Emacs frame\n\
252 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
253 --xrm XRESOURCES set additional X resources\n\
254 --parent-id XID set parent window\n\
255 --help display this help and exit\n\
256 --version output version information and exit\n\
260 You can generally also specify long option names with a single -; for\n\
261 example, -batch as well as --batch. You can use any unambiguous\n\
262 abbreviation for a --option.\n\
264 Various environment variables and window system resources also affect\n\
265 Emacs' operation. See the main documentation.\n\
267 Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs\n\
268 section of the Emacs manual or the file BUGS.\n"
271 /* Signal code for the fatal signal that was received. */
272 static int fatal_error_code
;
274 /* True if handling a fatal error already. */
275 bool fatal_error_in_progress
;
278 /* NS autrelease pool, for memory management. */
279 static void *ns_pool
;
284 /* Handle bus errors, invalid instruction, etc. */
286 handle_fatal_signal (int sig
)
288 fatal_error_backtrace (sig
, 10);
292 deliver_fatal_signal (int sig
)
294 handle_on_main_thread (sig
, handle_fatal_signal
);
297 /* Report a fatal error due to signal SIG, output a backtrace of at
298 most BACKTRACE_LIMIT lines, and exit. */
300 fatal_error_backtrace (int sig
, int backtrace_limit
)
302 fatal_error_code
= sig
;
303 signal (sig
, SIG_DFL
);
305 TOTALLY_UNBLOCK_INPUT
;
307 /* If fatal error occurs in code below, avoid infinite recursion. */
308 if (! fatal_error_in_progress
)
310 fatal_error_in_progress
= 1;
312 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
313 Fkill_emacs (make_number (sig
));
315 shut_down_emacs (sig
, Qnil
);
316 emacs_backtrace (backtrace_limit
);
319 /* Signal the same code; this time it will really be fatal.
320 Remember that since we're in a signal handler, the signal we're
321 going to send is probably blocked, so we have to unblock it if we
322 want to really receive it. */
326 sigemptyset (&unblocked
);
327 sigaddset (&unblocked
, fatal_error_code
);
328 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
332 kill (getpid (), fatal_error_code
);
334 /* This shouldn't be executed, but it prevents a warning. */
340 /* Handler for SIGDANGER. */
341 static void deliver_danger_signal (int);
344 handle_danger_signal (int sig
)
346 struct sigaction action
;
347 emacs_sigaction_init (&action
, deliver_danger_signal
);
348 sigaction (sig
, &action
, 0);
350 malloc_warning ("Operating system warns that virtual memory is running low.\n");
352 /* It might be unsafe to call do_auto_save now. */
353 force_auto_save_soon ();
357 deliver_danger_signal (int sig
)
359 handle_on_main_thread (sig
, handle_danger_signal
);
363 /* Code for dealing with Lisp access to the Unix command line. */
366 init_cmdargs (int argc
, char **argv
, int skip_args
)
369 Lisp_Object name
, dir
, handler
;
370 ptrdiff_t count
= SPECPDL_INDEX ();
371 Lisp_Object raw_name
;
376 raw_name
= build_string (argv
[0]);
378 /* Add /: to the front of the name
379 if it would otherwise be treated as magic. */
380 handler
= Ffind_file_name_handler (raw_name
, Qt
);
381 if (! NILP (handler
))
382 raw_name
= concat2 (build_string ("/:"), raw_name
);
384 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
385 Vinvocation_directory
= Ffile_name_directory (raw_name
);
387 /* If we got no directory in argv[0], search PATH to find where
388 Emacs actually came from. */
389 if (NILP (Vinvocation_directory
))
392 int yes
= openp (Vexec_path
, Vinvocation_name
,
393 Vexec_suffixes
, &found
, make_number (X_OK
));
396 /* Add /: to the front of the name
397 if it would otherwise be treated as magic. */
398 handler
= Ffind_file_name_handler (found
, Qt
);
399 if (! NILP (handler
))
400 found
= concat2 (build_string ("/:"), found
);
401 Vinvocation_directory
= Ffile_name_directory (found
);
405 if (!NILP (Vinvocation_directory
)
406 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
407 /* Emacs was started with relative path, like ./emacs.
409 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, Qnil
);
411 Vinstallation_directory
= Qnil
;
413 if (!NILP (Vinvocation_directory
))
415 dir
= Vinvocation_directory
;
417 /* If we are running from the build directory, set DIR to the
418 src subdirectory of the Emacs tree, like on Posix
420 if (SBYTES (dir
) > sizeof ("/i386/") - 1
421 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
423 dir
= Fexpand_file_name (build_string ("../.."), dir
);
424 #else /* !WINDOWSNT */
426 name
= Fexpand_file_name (Vinvocation_name
, dir
);
429 Lisp_Object tem
, lib_src_exists
;
430 Lisp_Object etc_exists
, info_exists
;
432 /* See if dir contains subdirs for use by Emacs.
433 Check for the ones that would exist in a build directory,
434 not including lisp and info. */
435 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
436 lib_src_exists
= Ffile_exists_p (tem
);
439 /* MSDOS installations frequently remove lib-src, but we still
440 must set installation-directory, or else info won't find
441 its files (it uses the value of installation-directory). */
442 tem
= Fexpand_file_name (build_string ("info"), dir
);
443 info_exists
= Ffile_exists_p (tem
);
448 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
450 tem
= Fexpand_file_name (build_string ("etc"), dir
);
451 etc_exists
= Ffile_exists_p (tem
);
452 if (!NILP (etc_exists
))
454 Vinstallation_directory
455 = Ffile_name_as_directory (dir
);
460 /* See if dir's parent contains those subdirs. */
461 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
462 lib_src_exists
= Ffile_exists_p (tem
);
466 /* See the MSDOS commentary above. */
467 tem
= Fexpand_file_name (build_string ("../info"), dir
);
468 info_exists
= Ffile_exists_p (tem
);
473 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
475 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
476 etc_exists
= Ffile_exists_p (tem
);
477 if (!NILP (etc_exists
))
479 tem
= Fexpand_file_name (build_string (".."), dir
);
480 Vinstallation_directory
481 = Ffile_name_as_directory (tem
);
486 /* If the Emacs executable is actually a link,
487 next try the dir that the link points into. */
488 tem
= Ffile_symlink_p (name
);
491 name
= Fexpand_file_name (tem
, dir
);
492 dir
= Ffile_name_directory (name
);
499 Vcommand_line_args
= Qnil
;
501 for (i
= argc
- 1; i
>= 0; i
--)
503 if (i
== 0 || i
> skip_args
)
504 /* For the moment, we keep arguments as is in unibyte strings.
505 They are decoded in the function command-line after we know
506 locale-coding-system. */
508 = Fcons (make_unibyte_string (argv
[i
], strlen (argv
[i
])),
512 unbind_to (count
, Qnil
);
515 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
516 doc
: /* Return the program name that was used to run Emacs.
517 Any directory names are omitted. */)
520 return Fcopy_sequence (Vinvocation_name
);
523 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
525 doc
: /* Return the directory name in which the Emacs executable was located. */)
528 return Fcopy_sequence (Vinvocation_directory
);
533 /* A valid but unlikely value for the TZ environment value.
534 It is OK (though a bit slower) if the user actually chooses this value. */
535 static char dump_tz
[] = "UtC0";
538 #ifndef ORDINARY_LINK
539 /* We don't include crtbegin.o and crtend.o in the link,
540 so these functions and variables might be missed.
541 Provide dummy definitions to avoid error.
542 (We don't have any real constructors or destructors.) */
545 /* Define a dummy function F. Declare F too, to pacify gcc
546 -Wmissing-prototypes. */
547 #define DEFINE_DUMMY_FUNCTION(f) \
548 void f (void) ATTRIBUTE_CONST EXTERNALLY_VISIBLE; void f (void) {}
550 #ifndef GCC_CTORS_IN_LIBC
551 DEFINE_DUMMY_FUNCTION (__do_global_ctors
)
552 DEFINE_DUMMY_FUNCTION (__do_global_ctors_aux
)
553 DEFINE_DUMMY_FUNCTION (__do_global_dtors
)
554 /* GNU/Linux has a bug in its library; avoid an error. */
556 char * __CTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
558 char * __DTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
559 #endif /* GCC_CTORS_IN_LIBC */
560 DEFINE_DUMMY_FUNCTION (__main
)
561 #endif /* __GNUC__ */
562 #endif /* ORDINARY_LINK */
564 /* Test whether the next argument in ARGV matches SSTR or a prefix of
565 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
566 (the argument is supposed to have a value) store in *VALPTR either
567 the next argument or the portion of this one after the equal sign.
568 ARGV is read starting at position *SKIPPTR; this index is advanced
569 by the number of arguments used.
571 Too bad we can't just use getopt for all of this, but we don't have
572 enough information to do it right. */
575 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
576 int minlen
, char **valptr
, int *skipptr
)
582 /* Don't access argv[argc]; give up in advance. */
583 if (argc
<= *skipptr
+ 1)
586 arg
= argv
[*skipptr
+1];
589 if (strcmp (arg
, sstr
) == 0)
593 *valptr
= argv
[*skipptr
+2];
600 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
601 ? p
- arg
: strlen (arg
));
602 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
604 else if (valptr
== NULL
)
615 else if (argv
[*skipptr
+2] != NULL
)
617 *valptr
= argv
[*skipptr
+2];
627 #ifdef DOUG_LEA_MALLOC
629 /* malloc can be invoked even before main (e.g. by the dynamic
630 linker), so the dumped malloc state must be restored as early as
631 possible using this special hook. */
634 malloc_initialize_hook (void)
638 if (!malloc_using_checking
)
639 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
640 ignored if the heap to be restored was constructed without
641 malloc checking. Can't use unsetenv, since that calls malloc. */
645 for (p
= environ
; p
&& *p
; p
++)
646 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
655 malloc_set_state (malloc_state_ptr
);
656 #ifndef XMALLOC_OVERRUN_CHECK
657 free (malloc_state_ptr
);
662 if (my_heap_start
== 0)
663 my_heap_start
= sbrk (0);
664 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
668 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
670 #endif /* DOUG_LEA_MALLOC */
675 main (int argc
, char **argv
)
680 char stack_bottom_variable
;
681 bool do_initial_setlocale
;
683 #ifdef HAVE_SETRLIMIT
693 struct sigaction fatal_error_action
;
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 #if defined (MSDOS) || defined (WINDOWSNT)
863 /* We do all file input/output as binary files. When we need to translate
864 newlines, we do that manually. */
866 #endif /* MSDOS || WINDOWSNT */
869 if (!isatty (fileno (stdin
)))
870 setmode (fileno (stdin
), O_BINARY
);
871 if (!isatty (fileno (stdout
)))
874 setmode (fileno (stdout
), O_BINARY
);
878 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
879 The build procedure uses this while dumping, to ensure that the
880 dumped Emacs does not have its system locale tables initialized,
881 as that might cause screwups when the dumped Emacs starts up. */
883 char *lc_all
= getenv ("LC_ALL");
884 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
887 /* Set locale now, so that initial error messages are localized properly.
888 fixup_locale must wait until later, since it builds strings. */
889 if (do_initial_setlocale
)
890 setlocale (LC_ALL
, "");
892 inhibit_window_system
= 0;
894 /* Handle the -t switch, which specifies filename to use as terminal. */
898 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
903 result
= emacs_open (term
, O_RDWR
, 0);
904 if (result
< 0 || dup (0) < 0)
906 char *errstring
= strerror (errno
);
907 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
912 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
915 fprintf (stderr
, "Using %s\n", term
);
916 #ifdef HAVE_WINDOW_SYSTEM
917 inhibit_window_system
= 1; /* -t => -nw */
924 /* Command line option --no-windows is deprecated and thus not mentioned
925 in the manual and usage information. */
926 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
927 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
928 inhibit_window_system
= 1;
930 /* Handle the -batch switch, which means don't do interactive display. */
932 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
935 Vundo_outer_limit
= Qnil
;
937 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
939 noninteractive
= 1; /* Set batch mode. */
940 /* Convert --script to -scriptload, un-skip it, and sort again
941 so that it will be handled in proper sequence. */
942 /* FIXME broken for --script=FILE - is that supposed to work? */
943 argv
[skip_args
- 1] = (char *) "-scriptload";
945 sort_args (argc
, argv
);
948 /* Handle the --help option, which gives a usage message. */
949 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
951 printf (USAGE1
, argv
[0], USAGE2
);
957 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
958 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
963 /* Start as a daemon: fork a new child process which will run the
964 rest of the initialization code, then exit.
966 Detaching a daemon requires the following steps:
970 - close the tty file-descriptors
972 We only want to do the last 2 steps once the daemon is ready to
973 serve requests, i.e. after loading .emacs (initialization).
974 OTOH initialization may start subprocesses (e.g. ispell) and these
975 should be run from the proper process (the one that will end up
976 running as daemon) and with the proper "session id" in order for
977 them to keep working after detaching, so fork and setsid need to be
978 performed before initialization.
980 We want to avoid exiting before the server socket is ready, so
981 use a pipe for synchronization. The parent waits for the child
982 to close its end of the pipe (using `daemon-initialized')
984 if (pipe (daemon_pipe
) == -1)
986 fprintf (stderr
, "Cannot pipe!\n");
990 #ifndef NS_IMPL_COCOA
992 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
993 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
994 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
997 #else /* NS_IMPL_COCOA */
998 /* Under Cocoa we must do fork+exec as CoreFoundation lib fails in
999 forked process: http://developer.apple.com/ReleaseNotes/
1000 CoreFoundation/CoreFoundation.html)
1001 We mark being in the exec'd process by a daemon name argument of
1002 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
1003 NAME is the original daemon name, if any. */
1004 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1005 f
= fork (); /* in orig */
1007 f
= 0; /* in exec'd */
1008 #endif /* NS_IMPL_COCOA */
1014 /* Close unused writing end of the pipe. */
1015 close (daemon_pipe
[1]);
1017 /* Just wait for the child to close its end of the pipe. */
1020 retval
= read (daemon_pipe
[0], &buf
, 1);
1022 while (retval
== -1 && errno
== EINTR
);
1026 fprintf (stderr
, "Error reading status from child\n");
1029 else if (retval
== 0)
1031 fprintf (stderr
, "Error: server did not start correctly\n");
1035 close (daemon_pipe
[0]);
1040 fprintf (stderr
, "Cannot fork!\n");
1044 #ifdef NS_IMPL_COCOA
1046 /* In orig process, forked as child, OR in exec'd. */
1047 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1048 { /* In orig, child: now exec w/special daemon name. */
1051 snprintf (fdStr
, sizeof fdStr
,
1052 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1053 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1055 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1057 fprintf (stderr
, "daemon: child name too long\n");
1061 argv
[skip_args
] = fdStr
;
1063 execv (argv
[0], argv
);
1064 fprintf (stderr
, "emacs daemon: exec failed: %d\n", errno
);
1068 /* In exec'd: parse special dname into pipe and name info. */
1069 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1070 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1072 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1075 dname_arg2
[0] = '\0';
1076 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1078 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1080 #endif /* NS_IMPL_COCOA */
1083 daemon_name
= xstrdup (dname_arg
);
1084 /* Close unused reading end of the pipe. */
1085 close (daemon_pipe
[0]);
1086 /* Make sure that the used end of the pipe is closed on exec, so
1087 that it is not accessible to programs started from .emacs. */
1088 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1094 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1099 if (! noninteractive
)
1101 #if defined (USG5) && defined (INTERRUPT_INPUT)
1104 #if defined (HAVE_PTHREAD) && !defined (SYSTEM_MALLOC) && !defined (DOUG_LEA_MALLOC)
1106 extern void malloc_enable_thread (void);
1108 malloc_enable_thread ();
1114 emacs_sigaction_init (&fatal_error_action
, deliver_fatal_signal
);
1116 /* Don't catch SIGHUP if dumping. */
1123 /* In --batch mode, don't catch SIGHUP if already ignored.
1124 That makes nohup work. */
1125 bool catch_SIGHUP
= !noninteractive
;
1128 struct sigaction old_action
;
1129 sigaction (SIGHUP
, 0, &old_action
);
1130 catch_SIGHUP
= old_action
.sa_handler
!= SIG_IGN
;
1133 sigaction (SIGHUP
, &fatal_error_action
, 0);
1138 ! noninteractive
|| initialized
1144 /* Don't catch these signals in batch mode if dumping.
1145 On some machines, this sets static data that would make
1146 signal fail to work right when the dumped Emacs is run. */
1147 sigaction (SIGQUIT
, &fatal_error_action
, 0);
1148 sigaction (SIGILL
, &fatal_error_action
, 0);
1149 sigaction (SIGTRAP
, &fatal_error_action
, 0);
1151 add_user_signal (SIGUSR1
, "sigusr1");
1154 add_user_signal (SIGUSR2
, "sigusr2");
1157 sigaction (SIGABRT
, &fatal_error_action
, 0);
1160 sigaction (SIGHWE
, &fatal_error_action
, 0);
1163 sigaction (SIGPRE
, &fatal_error_action
, 0);
1166 sigaction (SIGORE
, &fatal_error_action
, 0);
1169 sigaction (SIGUME
, &fatal_error_action
, 0);
1172 sigaction (SIGDLK
, &fatal_error_action
, 0);
1175 sigaction (SIGCPULIM
, &fatal_error_action
, 0);
1178 /* This is missing on some systems - OS/2, for example. */
1179 sigaction (SIGIOT
, &fatal_error_action
, 0);
1182 sigaction (SIGEMT
, &fatal_error_action
, 0);
1184 sigaction (SIGFPE
, &fatal_error_action
, 0);
1186 sigaction (SIGBUS
, &fatal_error_action
, 0);
1188 sigaction (SIGSEGV
, &fatal_error_action
, 0);
1190 sigaction (SIGSYS
, &fatal_error_action
, 0);
1192 /* May need special treatment on MS-Windows. See
1193 http://lists.gnu.org/archive/html/emacs-devel/2010-09/msg01062.html
1194 Please update the doc of kill-emacs, kill-emacs-hook, and
1195 NEWS if you change this.
1198 sigaction (SIGINT
, &fatal_error_action
, 0);
1199 sigaction (SIGTERM
, &fatal_error_action
, 0);
1201 sigaction (SIGXCPU
, &fatal_error_action
, 0);
1204 sigaction (SIGXFSZ
, &fatal_error_action
, 0);
1205 #endif /* SIGXFSZ */
1208 /* This just means available memory is getting low. */
1210 struct sigaction action
;
1211 emacs_sigaction_init (&action
, deliver_danger_signal
);
1212 sigaction (SIGDANGER
, &action
, 0);
1217 /* 20 is SIGCHLD, 21 is SIGTTIN, 22 is SIGTTOU. */
1218 sigaction (SIGXCPU
, &fatal_error_action
, 0);
1219 sigaction (SIGIOINT
, &fatal_error_action
, 0);
1220 sigaction (SIGGRANT
, &fatal_error_action
, 0);
1221 sigaction (SIGRETRACT
, &fatal_error_action
, 0);
1222 sigaction (SIGSOUND
, &fatal_error_action
, 0);
1223 sigaction (SIGMSG
, &fatal_error_action
, 0);
1227 noninteractive1
= noninteractive
;
1229 /* Perform basic initializations (not merely interning symbols). */
1236 init_charset_once ();
1237 init_coding_once ();
1238 init_syntax_once (); /* Create standard syntax table. */
1239 init_category_once (); /* Create standard category table. */
1240 /* Must be done before init_buffer. */
1241 init_casetab_once ();
1242 init_buffer_once (); /* Create buffer table and some buffers. */
1243 init_minibuf_once (); /* Create list of minibuffers. */
1244 /* Must precede init_window_once. */
1246 /* Call syms_of_xfaces before init_window_once because that
1247 function creates Vterminal_frame. Termcap frames now use
1248 faces, and the face implementation uses some symbols as
1251 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1252 be better to arrange things not to have this dependency. */
1254 /* Call syms_of_keyboard before init_window_once because
1255 keyboard sets up symbols that include some face names that
1256 the X support will want to use. This can happen when
1257 CANNOT_DUMP is defined. */
1258 syms_of_keyboard ();
1260 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1263 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1265 /* Before syms_of_coding because it initializes Qcharsetp. */
1267 /* Before init_window_once, because it sets up the
1268 Vcoding_system_hash_table. */
1269 syms_of_coding (); /* This should be after syms_of_fileio. */
1271 init_window_once (); /* Init the window system. */
1272 #ifdef HAVE_WINDOW_SYSTEM
1273 init_fringe_once (); /* Swap bitmaps if necessary. */
1274 #endif /* HAVE_WINDOW_SYSTEM */
1279 if (do_initial_setlocale
)
1282 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1283 Vsystem_time_locale
= Vprevious_system_time_locale
;
1289 running_asynch_code
= 0;
1293 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1296 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1299 ns_pool
= ns_alloc_autorelease_pool ();
1300 if (!noninteractive
)
1302 #ifdef NS_IMPL_COCOA
1303 if (skip_args
< argc
)
1305 /* FIXME: Do the right thing if getenv returns NULL, or if
1307 if (!strncmp (argv
[skip_args
], "-psn", 4))
1310 chdir (getenv ("HOME"));
1312 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1315 chdir (getenv ("HOME"));
1320 #endif /* HAVE_NS */
1322 #ifdef HAVE_X_WINDOWS
1323 /* Stupid kludge to catch command-line display spec. We can't
1324 handle this argument entirely in window system dependent code
1325 because we don't even know which window system dependent code
1326 to run until we've recognized this argument. */
1328 char *displayname
= 0;
1329 int count_before
= skip_args
;
1331 /* Skip any number of -d options, but only use the last one. */
1334 int count_before_this
= skip_args
;
1336 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1338 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1343 count_before
= count_before_this
;
1346 /* If we have the form --display=NAME,
1347 convert it into -d name.
1348 This requires inserting a new element into argv. */
1349 if (displayname
&& count_before
< skip_args
)
1351 if (skip_args
== count_before
+ 1)
1353 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1354 (argc
- (count_before
+ 2)) * sizeof *argv
);
1355 argv
[count_before
+ 2] = displayname
;
1358 argv
[count_before
+ 1] = (char *) "-d";
1363 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1364 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1368 /* Don't actually discard this arg. */
1369 skip_args
= count_before
;
1371 #else /* !HAVE_X_WINDOWS */
1374 int count_before
= skip_args
;
1376 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1377 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1380 skip_args
= count_before
;
1384 /* argmatch must not be used after here,
1385 except when building temacs
1386 because the -d argument has not been skipped in skip_args. */
1389 /* Call early 'cause init_environment needs it. */
1391 /* Set defaults for several environment variables. */
1393 init_environment (argc
, argv
, skip_args
);
1400 /* Initialize environment from registry settings. */
1401 init_environment (argv
);
1402 init_ntproc (); /* must precede init_editfns. */
1405 /* Initialize and GC-protect Vinitial_environment and
1406 Vprocess_environment before set_initial_environment fills them
1409 syms_of_callproc ();
1410 /* egetenv is a pretty low-level facility, which may get called in
1411 many circumstances; it seems flimsy to put off initializing it
1412 until calling init_callproc. Do not do it when dumping. */
1413 if (initialized
|| ((strcmp (argv
[argc
-1], "dump") != 0
1414 && strcmp (argv
[argc
-1], "bootstrap") != 0)))
1415 set_initial_environment ();
1417 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1418 if this is not done. Do it after set_global_environment so that we
1419 don't pollute Vglobal_environment. */
1420 /* Setting LANG here will defeat the startup locale processing... */
1425 init_buffer (); /* Init default directory of main buffer. */
1427 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1428 init_cmdargs (argc
, argv
, skip_args
); /* Must precede init_lread. */
1432 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1433 Lisp_Object old_log_max
;
1434 old_log_max
= Vmessage_log_max
;
1435 XSETFASTINT (Vmessage_log_max
, 0);
1436 message_dolog ("", 0, 1, 0);
1437 Vmessage_log_max
= old_log_max
;
1440 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1443 /* Check to see if Emacs has been installed correctly. */
1444 check_windows_init_file ();
1447 /* Intern the names of all standard functions and variables;
1448 define standard keys. */
1452 /* The basic levels of Lisp must come first. Note that
1453 syms_of_data and some others have already been called. */
1459 syms_of_floatfns ();
1462 syms_of_bytecode ();
1464 syms_of_casefiddle ();
1466 syms_of_category ();
1468 syms_of_character ();
1475 syms_of_filelock ();
1478 /* syms_of_keymap (); */
1486 syms_of_terminal ();
1492 syms_of_textprop ();
1493 syms_of_composite ();
1496 #endif /* WINDOWSNT */
1500 #ifdef HAVE_WINDOW_SYSTEM
1503 #endif /* HAVE_WINDOW_SYSTEM */
1504 #ifdef HAVE_X_WINDOWS
1509 syms_of_xsettings ();
1516 #endif /* HAVE_X_WINDOWS */
1527 syms_of_w32select ();
1530 #endif /* HAVE_NTGUI */
1536 syms_of_win16select ();
1543 syms_of_nsselect ();
1545 #endif /* HAVE_NS */
1552 syms_of_dbusbind ();
1553 #endif /* HAVE_DBUS */
1557 #endif /* WINDOWSNT */
1559 keys_of_casefiddle ();
1562 keys_of_keyboard ();
1568 /* Initialization that must be done even if the global variable
1569 initialized is non zero. */
1571 globals_of_w32font ();
1572 globals_of_w32fns ();
1573 globals_of_w32menu ();
1574 globals_of_w32select ();
1575 #endif /* HAVE_NTGUI */
1580 init_editfns (); /* init_process_emacs uses Voperating_system_release. */
1581 init_process_emacs (); /* init_display uses add_keyboard_wait_descriptor. */
1582 init_keyboard (); /* This too must precede init_sys_modes. */
1583 if (!noninteractive
)
1584 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1586 #ifdef HAVE_WINDOW_SYSTEM
1588 #endif /* HAVE_WINDOW_SYSTEM */
1596 /* Handle -l loadup, args passed by Makefile. */
1597 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1598 Vtop_level
= Fcons (intern_c_string ("load"),
1599 Fcons (build_string (file
), Qnil
));
1600 /* Unless next switch is -nl, load "loadup.el" first thing. */
1602 Vtop_level
= Fcons (intern_c_string ("load"),
1603 Fcons (build_string ("loadup.el"), Qnil
));
1610 /* If the execution TZ happens to be the same as the dump TZ,
1611 change it to some other value and then change it back,
1612 to force the underlying implementation to reload the TZ info.
1613 This is needed on implementations that load TZ info from files,
1614 since the TZ file contents may differ between dump and execution. */
1615 char *tz
= getenv ("TZ");
1616 if (tz
&& !strcmp (tz
, dump_tz
))
1626 /* Set up for profiling. This is known to work on FreeBSD,
1627 GNU/Linux and MinGW. It might work on some other systems too.
1628 Give it a try and tell us if it works on your system. To compile
1629 for profiling, use the configure option --enable-profiling. */
1630 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1635 extern unsigned char etext
asm ("etext");
1641 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1650 #ifdef LOCALTIME_CACHE
1651 /* Some versions of localtime have a bug. They cache the value of the time
1652 zone rather than looking it up every time. Since localtime() is
1653 called to bolt the undumping time into the undumped emacs, this
1654 results in localtime ignoring the TZ environment variable.
1655 This flushes the new TZ value into localtime. */
1657 #endif /* defined (LOCALTIME_CACHE) */
1659 /* Enter editor command loop. This never returns. */
1665 /* Sort the args so we can find the most important ones
1666 at the beginning of argv. */
1668 /* First, here's a table of all the standard options. */
1670 struct standard_args
1673 const char *longname
;
1678 static const struct standard_args standard_args
[] =
1680 { "-version", "--version", 150, 0 },
1681 { "-chdir", "--chdir", 130, 1 },
1682 { "-t", "--terminal", 120, 1 },
1683 { "-nw", "--no-window-system", 110, 0 },
1684 { "-nw", "--no-windows", 110, 0 },
1685 { "-batch", "--batch", 100, 0 },
1686 { "-script", "--script", 100, 1 },
1687 { "-daemon", "--daemon", 99, 0 },
1688 { "-help", "--help", 90, 0 },
1689 { "-nl", "--no-loadup", 70, 0 },
1690 { "-nsl", "--no-site-lisp", 65, 0 },
1691 /* -d must come last before the options handled in startup.el. */
1692 { "-d", "--display", 60, 1 },
1693 { "-display", 0, 60, 1 },
1694 /* Now for the options handled in `command-line' (startup.el). */
1695 /* (Note that to imply -nsl, -Q is partially handled here.) */
1696 { "-Q", "--quick", 55, 0 },
1697 { "-quick", 0, 55, 0 },
1698 { "-q", "--no-init-file", 50, 0 },
1699 { "-no-init-file", 0, 50, 0 },
1700 { "-no-site-file", "--no-site-file", 40, 0 },
1701 { "-u", "--user", 30, 1 },
1702 { "-user", 0, 30, 1 },
1703 { "-debug-init", "--debug-init", 20, 0 },
1704 { "-iconic", "--iconic", 15, 0 },
1705 { "-D", "--basic-display", 12, 0},
1706 { "-basic-display", 0, 12, 0},
1707 { "-nbc", "--no-blinking-cursor", 12, 0 },
1708 /* Now for the options handled in `command-line-1' (startup.el). */
1709 { "-nbi", "--no-bitmap-icon", 10, 0 },
1710 { "-bg", "--background-color", 10, 1 },
1711 { "-background", 0, 10, 1 },
1712 { "-fg", "--foreground-color", 10, 1 },
1713 { "-foreground", 0, 10, 1 },
1714 { "-bd", "--border-color", 10, 1 },
1715 { "-bw", "--border-width", 10, 1 },
1716 { "-ib", "--internal-border", 10, 1 },
1717 { "-ms", "--mouse-color", 10, 1 },
1718 { "-cr", "--cursor-color", 10, 1 },
1719 { "-fn", "--font", 10, 1 },
1720 { "-font", 0, 10, 1 },
1721 { "-fs", "--fullscreen", 10, 0 },
1722 { "-fw", "--fullwidth", 10, 0 },
1723 { "-fh", "--fullheight", 10, 0 },
1724 { "-mm", "--maximized", 10, 0 },
1725 { "-g", "--geometry", 10, 1 },
1726 { "-geometry", 0, 10, 1 },
1727 { "-T", "--title", 10, 1 },
1728 { "-title", 0, 10, 1 },
1729 { "-name", "--name", 10, 1 },
1730 { "-xrm", "--xrm", 10, 1 },
1731 { "-parent-id", "--parent-id", 10, 1 },
1732 { "-r", "--reverse-video", 5, 0 },
1734 { "-reverse", 0, 5, 0 },
1735 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1736 { "-vb", "--vertical-scroll-bars", 5, 0 },
1737 { "-color", "--color", 5, 0},
1738 { "-no-splash", "--no-splash", 3, 0 },
1739 { "-no-desktop", "--no-desktop", 3, 0 },
1741 { "-NSAutoLaunch", 0, 5, 1 },
1742 { "-NXAutoLaunch", 0, 5, 1 },
1743 { "-disable-font-backend", "--disable-font-backend", 65, 0 },
1744 { "-_NSMachLaunch", 0, 85, 1 },
1745 { "-MachLaunch", 0, 85, 1 },
1746 { "-macosx", 0, 85, 0 },
1747 { "-NSHost", 0, 85, 1 },
1749 /* These have the same priority as ordinary file name args,
1750 so they are not reordered with respect to those. */
1751 { "-L", "--directory", 0, 1 },
1752 { "-directory", 0, 0, 1 },
1753 { "-l", "--load", 0, 1 },
1754 { "-load", 0, 0, 1 },
1755 /* This has no longname, because using --scriptload confuses sort_args,
1756 because then the --script long option seems to match twice; ie
1757 you can't have a long option which is a prefix of another long
1758 option. In any case, this is entirely an internal option. */
1759 { "-scriptload", NULL
, 0, 1 },
1760 { "-f", "--funcall", 0, 1 },
1761 { "-funcall", 0, 0, 1 },
1762 { "-eval", "--eval", 0, 1 },
1763 { "-execute", "--execute", 0, 1 },
1764 { "-find-file", "--find-file", 0, 1 },
1765 { "-visit", "--visit", 0, 1 },
1766 { "-file", "--file", 0, 1 },
1767 { "-insert", "--insert", 0, 1 },
1769 { "-NXOpen", 0, 0, 1 },
1770 { "-NXOpenTemp", 0, 0, 1 },
1771 { "-NSOpen", 0, 0, 1 },
1772 { "-NSOpenTemp", 0, 0, 1 },
1773 { "-GSFilePath", 0, 0, 1 },
1775 /* This should be processed after ordinary file name args and the like. */
1776 { "-kill", "--kill", -10, 0 },
1779 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1780 so that the highest priority ones come first.
1781 Do not change the order of elements of equal priority.
1782 If an option takes an argument, keep it and its argument together.
1784 If an option that takes no argument appears more
1785 than once, eliminate all but one copy of it. */
1788 sort_args (int argc
, char **argv
)
1790 char **new = xmalloc (argc
* sizeof *new);
1791 /* For each element of argv,
1792 the corresponding element of options is:
1793 0 for an option that takes no arguments,
1794 1 for an option that takes one argument, etc.
1795 -1 for an ordinary non-option argument. */
1796 int *options
= xnmalloc (argc
, sizeof *options
);
1797 int *priority
= xnmalloc (argc
, sizeof *priority
);
1799 int incoming_used
= 1;
1803 /* Categorize all the options,
1804 and figure out which argv elts are option arguments. */
1805 for (from
= 1; from
< argc
; from
++)
1809 if (argv
[from
][0] == '-')
1813 /* If we have found "--", don't consider
1814 any more arguments as options. */
1815 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1817 /* Leave the "--", and everything following it, at the end. */
1818 for (; from
< argc
; from
++)
1820 priority
[from
] = -100;
1826 /* Look for a match with a known old-fashioned option. */
1827 for (i
= 0; i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1828 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1830 options
[from
] = standard_args
[i
].nargs
;
1831 priority
[from
] = standard_args
[i
].priority
;
1832 if (from
+ standard_args
[i
].nargs
>= argc
)
1833 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1834 from
+= standard_args
[i
].nargs
;
1838 /* Look for a match with a known long option.
1839 MATCH is -1 if no match so far, -2 if two or more matches so far,
1840 >= 0 (the table index of the match) if just one match so far. */
1841 if (argv
[from
][1] == '-')
1843 char const *equals
= strchr (argv
[from
], '=');
1845 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1850 i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1851 if (standard_args
[i
].longname
1852 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1861 /* If we found exactly one match, use that. */
1864 options
[from
] = standard_args
[match
].nargs
;
1865 priority
[from
] = standard_args
[match
].priority
;
1866 /* If --OPTION=VALUE syntax is used,
1867 this option uses just one argv element. */
1870 if (from
+ options
[from
] >= argc
)
1871 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1872 from
+= options
[from
];
1874 /* FIXME When match < 0, shouldn't there be some error,
1875 or at least indication to the user that there was a
1882 /* Copy the arguments, in order of decreasing priority, to NEW. */
1884 while (incoming_used
< argc
)
1887 int best_priority
= -9999;
1889 /* Find the highest priority remaining option.
1890 If several have equal priority, take the first of them. */
1891 for (from
= 1; from
< argc
; from
++)
1893 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1895 best_priority
= priority
[from
];
1898 /* Skip option arguments--they are tied to the options. */
1899 if (options
[from
] > 0)
1900 from
+= options
[from
];
1906 /* Copy the highest priority remaining option, with its args, to NEW.
1907 Unless it is a duplicate of the previous one. */
1908 if (! (options
[best
] == 0
1909 && ! strcmp (new[to
- 1], argv
[best
])))
1911 new[to
++] = argv
[best
];
1912 for (i
= 0; i
< options
[best
]; i
++)
1913 new[to
++] = argv
[best
+ i
+ 1];
1916 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1918 /* Clear out this option in ARGV. */
1920 for (i
= 0; i
< options
[best
]; i
++)
1921 argv
[best
+ i
+ 1] = 0;
1924 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1928 memcpy (argv
, new, sizeof (char *) * argc
);
1935 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1936 doc
: /* Exit the Emacs job and kill it.
1937 If ARG is an integer, return ARG as the exit program code.
1938 If ARG is a string, stuff it as keyboard input.
1940 This function is called upon receipt of the signals SIGTERM
1941 or SIGHUP, and upon SIGINT in batch mode.
1943 The value of `kill-emacs-hook', if not void,
1944 is a list of functions (of no args),
1945 all of which are called before Emacs is actually killed. */)
1948 struct gcpro gcpro1
;
1957 hook
= intern ("kill-emacs-hook");
1958 Frun_hooks (1, &hook
);
1962 #ifdef HAVE_X_WINDOWS
1963 /* Transfer any clipboards we own to the clipboard manager. */
1964 x_clipboard_manager_save_all ();
1967 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1970 ns_release_autorelease_pool (ns_pool
);
1973 /* If we have an auto-save list file,
1974 kill it because we are exiting Emacs deliberately (not crashing).
1975 Do it after shut_down_emacs, which does an auto-save. */
1976 if (STRINGP (Vauto_save_list_file_name
))
1977 unlink (SSDATA (Vauto_save_list_file_name
));
1980 exit_code
= (XINT (arg
) < 0
1981 ? XINT (arg
) | INT_MIN
1982 : XINT (arg
) & INT_MAX
);
1983 else if (noninteractive
&& (fflush (stdout
) || ferror (stdout
)))
1984 exit_code
= EXIT_FAILURE
;
1986 exit_code
= EXIT_SUCCESS
;
1991 /* Perform an orderly shutdown of Emacs. Autosave any modified
1992 buffers, kill any child processes, clean up the terminal modes (if
1993 we're in the foreground), and other stuff like that. Don't perform
1994 any redisplay; this may be called when Emacs is shutting down in
1995 the background, or after its X connection has died.
1997 If SIG is a signal number, print a message for it.
1999 This is called by fatal signal handlers, X protocol error handlers,
2003 shut_down_emacs (int sig
, Lisp_Object stuff
)
2005 /* Prevent running of hooks from now on. */
2008 /* Don't update display from now on. */
2009 Vinhibit_redisplay
= Qt
;
2011 /* If we are controlling the terminal, reset terminal modes. */
2014 int pgrp
= EMACS_GETPGRP (0);
2015 int tpgrp
= tcgetpgrp (0);
2016 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2018 reset_all_sys_modes ();
2019 if (sig
&& sig
!= SIGTERM
)
2020 fprintf (stderr
, "Fatal error %d: %s", sig
, strsignal (sig
));
2025 reset_all_sys_modes ();
2028 stuff_buffered_input (stuff
);
2030 inhibit_sentinels
= 1;
2031 kill_buffer_processes (Qnil
);
2032 Fdo_auto_save (Qt
, Qnil
);
2034 #ifdef CLASH_DETECTION
2035 unlock_all_files ();
2038 /* There is a tendency for a SIGIO signal to arrive within exit,
2039 and cause a SIGHUP because the input descriptor is already closed. */
2047 /* Do this only if terminating normally, we want glyph matrices
2048 etc. in a core dump. */
2049 if (sig
== 0 || sig
== SIGTERM
)
2051 check_glyph_memory ();
2052 check_message_stack ();
2060 ns_term_shutdown (sig
);
2064 xml_cleanup_parser ();
2074 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2075 doc
: /* Dump current state of Emacs into executable file FILENAME.
2076 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2077 This is used in the file `loadup.el' when building Emacs.
2079 You must run Emacs in batch mode in order to dump it. */)
2080 (Lisp_Object filename
, Lisp_Object symfile
)
2084 ptrdiff_t count
= SPECPDL_INDEX ();
2088 if (! noninteractive
)
2089 error ("Dumping Emacs works only in batch mode");
2093 /* Warn if the gap between BSS end and heap start is larger than this. */
2094 # define MAX_HEAP_BSS_DIFF (1024*1024)
2096 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2098 fprintf (stderr
, "**************************************************\n");
2099 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2100 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2102 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2103 fprintf (stderr
, "fail because of this. See the section about\n");
2104 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2105 fprintf (stderr
, "**************************************************\n");
2107 #endif /* GNU_LINUX */
2109 /* Bind `command-line-processed' to nil before dumping,
2110 so that the dumped Emacs will process its command line
2111 and set up to work with X windows if appropriate. */
2112 symbol
= intern ("command-line-processed");
2113 specbind (symbol
, Qnil
);
2115 CHECK_STRING (filename
);
2116 filename
= Fexpand_file_name (filename
, Qnil
);
2117 if (!NILP (symfile
))
2119 CHECK_STRING (symfile
);
2120 if (SCHARS (symfile
))
2121 symfile
= Fexpand_file_name (symfile
, Qnil
);
2125 Vpurify_flag
= Qnil
;
2128 set_time_zone_rule (dump_tz
);
2129 #ifndef LOCALTIME_CACHE
2130 /* Force a tz reload, since set_time_zone_rule doesn't. */
2136 /* Tell malloc where start of impure now is. */
2137 /* Also arrange for warnings when nearly out of space. */
2138 #ifndef SYSTEM_MALLOC
2140 /* On Windows, this was done before dumping, and that once suffices.
2141 Meanwhile, my_edata is not valid on Windows. */
2143 extern char my_edata
[];
2144 memory_warnings (my_edata
, malloc_warning
);
2146 #endif /* not WINDOWSNT */
2147 #if defined (HAVE_PTHREAD) && !defined SYNC_INPUT
2148 /* Pthread may call malloc before main, and then we will get an endless
2149 loop, because pthread_self (see alloc.c) calls malloc the first time
2150 it is called on some systems. */
2151 reset_malloc_hooks ();
2153 #endif /* not SYSTEM_MALLOC */
2154 #ifdef DOUG_LEA_MALLOC
2155 malloc_state_ptr
= malloc_get_state ();
2158 #ifdef USE_MMAP_FOR_BUFFERS
2161 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2162 #ifdef USE_MMAP_FOR_BUFFERS
2165 #ifdef DOUG_LEA_MALLOC
2166 free (malloc_state_ptr
);
2171 return unbind_to (count
, Qnil
);
2174 #endif /* not CANNOT_DUMP */
2177 /* Recover from setlocale (LC_ALL, ""). */
2181 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2182 so that numbers are read and printed properly for Emacs Lisp. */
2183 setlocale (LC_NUMERIC
, "C");
2186 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2189 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2191 if (! EQ (*plocale
, desired_locale
))
2193 *plocale
= desired_locale
;
2194 setlocale (category
, (STRINGP (desired_locale
)
2195 ? SSDATA (desired_locale
)
2200 /* Set system time locale to match Vsystem_time_locale, if possible. */
2202 synchronize_system_time_locale (void)
2204 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2205 Vsystem_time_locale
);
2208 /* Set system messages locale to match Vsystem_messages_locale, if
2211 synchronize_system_messages_locale (void)
2214 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2215 Vsystem_messages_locale
);
2218 #endif /* HAVE_SETLOCALE */
2222 decode_env_path (const char *evarname
, const char *defalt
)
2224 const char *path
, *p
;
2225 Lisp_Object lpath
, element
, tem
;
2228 const char *emacs_dir
= egetenv ("emacs_dir");
2229 static const char *emacs_dir_env
= "%emacs_dir%/";
2230 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2233 /* It's okay to use getenv here, because this function is only used
2234 to initialize variables when Emacs starts up, and isn't called
2237 path
= getenv (evarname
);
2248 /* Ensure values from the environment use the proper directory separator. */
2251 char *path_copy
= alloca (strlen (path
) + 1);
2252 strcpy (path_copy
, path
);
2253 dostounix_filename (path_copy
);
2260 p
= strchr (path
, SEPCHAR
);
2262 p
= path
+ strlen (path
);
2263 element
= (p
- path
? make_string (path
, p
- path
)
2264 : build_string ("."));
2266 /* Relative file names in the default path are interpreted as
2267 being relative to $emacs_dir. */
2268 if (emacs_dir
&& defaulted
2269 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2270 element
= Fexpand_file_name (Fsubstring (element
,
2271 make_number (emacs_dir_len
),
2273 build_string (emacs_dir
));
2276 /* Add /: to the front of the name
2277 if it would otherwise be treated as magic. */
2278 tem
= Ffind_file_name_handler (element
, Qt
);
2280 /* However, if the handler says "I'm safe",
2281 don't bother adding /:. */
2285 prop
= Fget (tem
, intern ("safe-magic"));
2291 element
= concat2 (build_string ("/:"), element
);
2293 lpath
= Fcons (element
, lpath
);
2299 return Fnreverse (lpath
);
2302 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2303 doc
: /* Return non-nil if the current emacs process is a daemon.
2304 If the daemon was given a name argument, return that name. */)
2309 return build_string (daemon_name
);
2316 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2317 doc
: /* Mark the Emacs daemon as being initialized.
2318 This finishes the daemonization process by doing the other half of detaching
2319 from the parent process and its tty file descriptors. */)
2326 error ("This function can only be called if emacs is run as a daemon");
2328 if (daemon_pipe
[1] < 0)
2329 error ("The daemon has already been initialized");
2331 if (NILP (Vafter_init_time
))
2332 error ("This function can only be called after loading the init files");
2334 /* Get rid of stdin, stdout and stderr. */
2335 nfd
= open ("/dev/null", O_RDWR
);
2337 err
|= dup2 (nfd
, 0) < 0;
2338 err
|= dup2 (nfd
, 1) < 0;
2339 err
|= dup2 (nfd
, 2) < 0;
2340 err
|= close (nfd
) != 0;
2342 /* Closing the pipe will notify the parent that it can exit.
2343 FIXME: In case some other process inherited the pipe, closing it here
2344 won't notify the parent because it's still open elsewhere, so we
2345 additionally send a byte, just to make sure the parent really exits.
2346 Instead, we should probably close the pipe in start-process and
2347 call-process to make sure the pipe is never inherited by
2349 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2350 err
|= close (daemon_pipe
[1]) != 0;
2351 /* Set it to an invalid value so we know we've already run this function. */
2352 daemon_pipe
[1] = -1;
2355 error ("I/O error during daemon initialization");
2360 syms_of_emacs (void)
2362 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2363 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2364 DEFSYM (Qkill_emacs
, "kill-emacs");
2367 defsubr (&Sdump_emacs
);
2370 defsubr (&Skill_emacs
);
2372 defsubr (&Sinvocation_name
);
2373 defsubr (&Sinvocation_directory
);
2374 defsubr (&Sdaemonp
);
2375 defsubr (&Sdaemon_initialized
);
2377 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2378 doc
: /* Args passed by shell to Emacs, as a list of strings.
2379 Many arguments are deleted from the list as they are processed. */);
2381 DEFVAR_LISP ("system-type", Vsystem_type
,
2382 doc
: /* The value is a symbol indicating the type of operating system you are using.
2384 `gnu' compiled for a GNU Hurd system.
2385 `gnu/linux' compiled for a GNU/Linux system.
2386 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2387 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2388 `ms-dos' compiled as an MS-DOS application.
2389 `windows-nt' compiled as a native W32 application.
2390 `cygwin' compiled using the Cygwin library.
2391 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2392 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2393 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2394 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2396 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2397 doc
: /* Value is string indicating configuration Emacs was built for.
2398 On MS-Windows, the value reflects the OS flavor and version on which
2399 Emacs is running. */);
2400 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2402 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2403 doc
: /* String containing the configuration options Emacs was built with. */);
2404 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2406 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2407 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2409 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2410 doc
: /* Hook run when `kill-emacs' is called.
2411 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2412 in other similar situations), functions placed on this hook should not
2413 expect to be able to interact with the user. To ask for confirmation,
2414 see `kill-emacs-query-functions' instead.
2416 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2417 `noninteractive' was non-nil. */);
2418 Vkill_emacs_hook
= Qnil
;
2420 DEFVAR_LISP ("path-separator", Vpath_separator
,
2421 doc
: /* String containing the character that separates directories in
2422 search paths, such as PATH and other similar environment variables. */);
2425 Vpath_separator
= make_string (&c
, 1);
2428 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2429 doc
: /* The program name that was used to run Emacs.
2430 Any directory names are omitted. */);
2432 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2433 doc
: /* The directory in which the Emacs executable was found, to run it.
2434 The value is nil if that directory's name is not known. */);
2436 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2437 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2438 In an installed Emacs, this is normally nil. It is non-nil if
2439 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2440 within the variable `invocation-directory' or its parent. For example,
2441 this is the case when running an uninstalled Emacs executable from its
2442 build directory. */);
2443 Vinstallation_directory
= Qnil
;
2445 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2446 doc
: /* System locale for messages. */);
2447 Vsystem_messages_locale
= Qnil
;
2449 DEFVAR_LISP ("previous-system-messages-locale",
2450 Vprevious_system_messages_locale
,
2451 doc
: /* Most recently used system locale for messages. */);
2452 Vprevious_system_messages_locale
= Qnil
;
2454 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2455 doc
: /* System locale for time. */);
2456 Vsystem_time_locale
= Qnil
;
2458 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2459 doc
: /* Most recently used system locale for time. */);
2460 Vprevious_system_time_locale
= Qnil
;
2462 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2463 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2464 Vbefore_init_time
= Qnil
;
2466 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2467 doc
: /* Value of `current-time' after loading the init files.
2468 This is nil during initialization. */);
2469 Vafter_init_time
= Qnil
;
2471 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2472 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2473 inhibit_x_resources
= 0;
2475 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2476 doc
: /* Short copyright string for this version of Emacs. */);
2477 Vemacs_copyright
= build_string (emacs_copyright
);
2479 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2480 doc
: /* Version numbers of this version of Emacs. */);
2481 Vemacs_version
= build_string (emacs_version
);
2483 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2484 doc
: /* Alist of dynamic libraries vs external files implementing them.
2485 Each element is a list (LIBRARY FILE...), where the car is a symbol
2486 representing a supported external library, and the rest are strings giving
2487 alternate filenames for that library.
2489 Emacs tries to load the library from the files in the order they appear on
2490 the list; if none is loaded, the running session of Emacs won't have access
2493 Note that image types `pbm' and `xbm' do not need entries in this variable
2494 because they do not depend on external libraries and are always available.
2496 Also note that this is not a generic facility for accessing external
2497 libraries; only those already known by Emacs will be loaded. */);
2498 Vdynamic_library_alist
= Qnil
;
2499 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2501 /* Make sure IS_DAEMON starts up as false. */