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>
32 #ifdef HAVE_WINDOW_SYSTEM
34 #endif /* HAVE_WINDOW_SYSTEM */
38 #include <windows.h> /* just for w32.h */
40 #include "w32heap.h" /* for prototype of sbrk */
43 #ifdef NS_IMPL_GNUSTEP
44 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
45 #include <GNUstepBase/GSConfig.h>
49 #include "intervals.h"
50 #include "character.h"
55 #include "blockinput.h"
56 #include "syssignal.h"
59 #include "termhooks.h"
67 #if (defined PROFILING \
68 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
69 # include <sys/gmon.h>
70 extern void moncontrol (int mode
);
79 #include <sys/resource.h>
82 #ifdef HAVE_PERSONALITY_LINUX32
83 #include <sys/personality.h>
90 static const char emacs_version
[] = VERSION
;
91 static const char emacs_copyright
[] = "Copyright (C) 2012 Free Software Foundation, Inc.";
93 /* Empty lisp strings. To avoid having to build any others. */
94 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
96 /* Set after Emacs has started up the first time.
97 Prevents reinitialization of the Lisp world and keymaps
98 on subsequent starts. */
102 extern void unexec_init_emacs_zone (void);
105 #ifdef DOUG_LEA_MALLOC
106 /* Preserves a pointer to the memory allocated that copies that
107 static data inside glibc's malloc. */
108 static void *malloc_state_ptr
;
109 /* From glibc, a routine that returns a copy of the malloc internal state. */
110 extern void *malloc_get_state (void);
111 /* From glibc, a routine that overwrites the malloc internal state. */
112 extern int malloc_set_state (void*);
113 /* True if the MALLOC_CHECK_ environment variable was set while
114 dumping. Used to work around a bug in glibc's malloc. */
115 static bool malloc_using_checking
;
118 Lisp_Object Qfile_name_handler_alist
;
120 Lisp_Object Qrisky_local_variable
;
122 Lisp_Object Qkill_emacs
;
124 /* If true, Emacs should not attempt to use a window-specific code,
125 but instead should use the virtual terminal under which it was started. */
126 bool inhibit_window_system
;
128 /* If true, a filter or a sentinel is running. Tested to save the match
129 data on the first attempt to change it inside asynchronous code. */
130 bool running_asynch_code
;
132 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
133 /* If true, -d was specified, meaning we're using some window system. */
137 /* An address near the bottom of the stack.
138 Tells GC how to save a copy of the stack. */
141 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
142 /* The address where the heap starts (from the first sbrk (0) call). */
143 static void *my_heap_start
;
147 /* The gap between BSS end and heap start as far as we can tell. */
148 static uprintmax_t heap_bss_diff
;
151 /* True means running Emacs without interactive terminal. */
154 /* True means remove site-lisp directories from load-path. */
157 /* Name for the server started by the daemon.*/
158 static char *daemon_name
;
160 /* Pipe used to send exit notification to the daemon parent at
164 /* Save argv and argc. */
168 static void sort_args (int argc
, char **argv
);
169 static void syms_of_emacs (void);
171 /* MSVC needs each string be shorter than 2048 bytes, so the usage
172 strings below are split to not overflow this limit. */
174 Usage: %s [OPTION-OR-FILENAME]...\n\
176 Run Emacs, the extensible, customizable, self-documenting real-time\n\
177 display editor. The recommended way to start Emacs for normal editing\n\
178 is with no options at all.\n\
180 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
181 read the main documentation for these command-line arguments.\n\
183 Initialization options:\n\
185 --batch do not do interactive display; implies -q\n\
186 --chdir DIR change to directory DIR\n\
187 --daemon start a server in the background\n\
188 --debug-init enable Emacs Lisp debugger for init file\n\
189 --display, -d DISPLAY use X server DISPLAY\n\
190 --no-desktop do not load a saved desktop\n\
191 --no-init-file, -q load neither ~/.emacs nor default.el\n\
192 --no-shared-memory, -nl do not use shared memory\n\
193 --no-site-file do not load site-start.el\n\
194 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
195 --no-splash do not display a splash screen on startup\n\
196 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
197 --quick, -Q equivalent to:\n\
198 -q --no-site-file --no-site-lisp --no-splash\n\
199 --script FILE run FILE as an Emacs Lisp script\n\
200 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
201 --user, -u USER load ~USER/.emacs instead of your own\n\
207 FILE visit FILE using find-file\n\
208 +LINE go to line LINE in next FILE\n\
209 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
210 --directory, -L DIR add DIR to variable load-path\n\
211 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
212 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
213 --file FILE visit FILE using find-file\n\
214 --find-file FILE visit FILE using find-file\n\
215 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
216 --insert FILE insert contents of FILE into current buffer\n\
217 --kill exit without asking for confirmation\n\
218 --load, -l FILE load Emacs Lisp FILE using the load function\n\
219 --visit FILE visit FILE using find-file\n\
225 --background-color, -bg COLOR window background color\n\
226 --basic-display, -D disable many display features;\n\
227 used for debugging Emacs\n\
228 --border-color, -bd COLOR main border color\n\
229 --border-width, -bw WIDTH width of main border\n\
230 --color, --color=MODE override color mode for character terminals;\n\
231 MODE defaults to `auto', and\n\
232 can also be `never', `always',\n\
233 or a mode name like `ansi8'\n\
234 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
235 --font, -fn FONT default font; must be fixed-width\n\
236 --foreground-color, -fg COLOR window foreground color\n\
237 --fullheight, -fh make the first frame high as the screen\n\
238 --fullscreen, -fs make the first frame fullscreen\n\
239 --fullwidth, -fw make the first frame wide as the screen\n\
240 --maximized, -mm make the first frame maximized\n\
241 --geometry, -g GEOMETRY window geometry\n\
242 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
243 --iconic start Emacs in iconified state\n\
244 --internal-border, -ib WIDTH width between text and main border\n\
245 --line-spacing, -lsp PIXELS additional space to put between lines\n\
246 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
247 --name NAME title for initial Emacs frame\n\
248 --no-blinking-cursor, -nbc disable blinking cursor\n\
249 --reverse-video, -r, -rv switch foreground and background\n\
250 --title, -T TITLE title for initial Emacs frame\n\
251 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
252 --xrm XRESOURCES set additional X resources\n\
253 --parent-id XID set parent window\n\
254 --help display this help and exit\n\
255 --version output version information and exit\n\
259 You can generally also specify long option names with a single -; for\n\
260 example, -batch as well as --batch. You can use any unambiguous\n\
261 abbreviation for a --option.\n\
263 Various environment variables and window system resources also affect\n\
264 Emacs' operation. See the main documentation.\n\
266 Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs\n\
267 section of the Emacs manual or the file BUGS.\n"
270 /* Signal code for the fatal signal that was received. */
271 static int fatal_error_code
;
273 /* True if handling a fatal error already. */
274 bool fatal_error_in_progress
;
277 /* NS autrelease pool, for memory management. */
278 static void *ns_pool
;
283 /* Handle bus errors, invalid instruction, etc. */
285 handle_fatal_signal (int sig
)
287 fatal_error_backtrace (sig
, 10);
291 deliver_fatal_signal (int sig
)
293 handle_on_main_thread (sig
, handle_fatal_signal
);
296 /* Report a fatal error due to signal SIG, output a backtrace of at
297 most BACKTRACE_LIMIT lines, and exit. */
299 fatal_error_backtrace (int sig
, int backtrace_limit
)
301 fatal_error_code
= sig
;
302 signal (sig
, SIG_DFL
);
304 TOTALLY_UNBLOCK_INPUT
;
306 /* If fatal error occurs in code below, avoid infinite recursion. */
307 if (! fatal_error_in_progress
)
309 fatal_error_in_progress
= 1;
311 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
312 Fkill_emacs (make_number (sig
));
314 shut_down_emacs (sig
, Qnil
);
315 emacs_backtrace (backtrace_limit
);
318 /* Signal the same code; this time it will really be fatal.
319 Remember that since we're in a signal handler, the signal we're
320 going to send is probably blocked, so we have to unblock it if we
321 want to really receive it. */
325 sigemptyset (&unblocked
);
326 sigaddset (&unblocked
, fatal_error_code
);
327 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
331 kill (getpid (), fatal_error_code
);
333 /* This shouldn't be executed, but it prevents a warning. */
339 /* Handler for SIGDANGER. */
340 static void deliver_danger_signal (int);
343 handle_danger_signal (int sig
)
345 struct sigaction action
;
346 emacs_sigaction_init (&action
, deliver_danger_signal
);
347 sigaction (sig
, &action
, 0);
349 malloc_warning ("Operating system warns that virtual memory is running low.\n");
351 /* It might be unsafe to call do_auto_save now. */
352 force_auto_save_soon ();
356 deliver_danger_signal (int sig
)
358 handle_on_main_thread (sig
, handle_danger_signal
);
362 /* Code for dealing with Lisp access to the Unix command line. */
365 init_cmdargs (int argc
, char **argv
, int skip_args
)
368 Lisp_Object name
, dir
, handler
;
369 ptrdiff_t count
= SPECPDL_INDEX ();
370 Lisp_Object raw_name
;
375 raw_name
= build_string (argv
[0]);
377 /* Add /: to the front of the name
378 if it would otherwise be treated as magic. */
379 handler
= Ffind_file_name_handler (raw_name
, Qt
);
380 if (! NILP (handler
))
381 raw_name
= concat2 (build_string ("/:"), raw_name
);
383 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
384 Vinvocation_directory
= Ffile_name_directory (raw_name
);
386 /* If we got no directory in argv[0], search PATH to find where
387 Emacs actually came from. */
388 if (NILP (Vinvocation_directory
))
391 int yes
= openp (Vexec_path
, Vinvocation_name
,
392 Vexec_suffixes
, &found
, make_number (X_OK
));
395 /* Add /: to the front of the name
396 if it would otherwise be treated as magic. */
397 handler
= Ffind_file_name_handler (found
, Qt
);
398 if (! NILP (handler
))
399 found
= concat2 (build_string ("/:"), found
);
400 Vinvocation_directory
= Ffile_name_directory (found
);
404 if (!NILP (Vinvocation_directory
)
405 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
406 /* Emacs was started with relative path, like ./emacs.
408 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, Qnil
);
410 Vinstallation_directory
= Qnil
;
412 if (!NILP (Vinvocation_directory
))
414 dir
= Vinvocation_directory
;
416 /* If we are running from the build directory, set DIR to the
417 src subdirectory of the Emacs tree, like on Posix
419 if (SBYTES (dir
) > sizeof ("/i386/") - 1
420 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
422 dir
= Fexpand_file_name (build_string ("../.."), dir
);
423 #else /* !WINDOWSNT */
425 name
= Fexpand_file_name (Vinvocation_name
, dir
);
428 Lisp_Object tem
, lib_src_exists
;
429 Lisp_Object etc_exists
, info_exists
;
431 /* See if dir contains subdirs for use by Emacs.
432 Check for the ones that would exist in a build directory,
433 not including lisp and info. */
434 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
435 lib_src_exists
= Ffile_exists_p (tem
);
438 /* MSDOS installations frequently remove lib-src, but we still
439 must set installation-directory, or else info won't find
440 its files (it uses the value of installation-directory). */
441 tem
= Fexpand_file_name (build_string ("info"), dir
);
442 info_exists
= Ffile_exists_p (tem
);
447 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
449 tem
= Fexpand_file_name (build_string ("etc"), dir
);
450 etc_exists
= Ffile_exists_p (tem
);
451 if (!NILP (etc_exists
))
453 Vinstallation_directory
454 = Ffile_name_as_directory (dir
);
459 /* See if dir's parent contains those subdirs. */
460 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
461 lib_src_exists
= Ffile_exists_p (tem
);
465 /* See the MSDOS commentary above. */
466 tem
= Fexpand_file_name (build_string ("../info"), dir
);
467 info_exists
= Ffile_exists_p (tem
);
472 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
474 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
475 etc_exists
= Ffile_exists_p (tem
);
476 if (!NILP (etc_exists
))
478 tem
= Fexpand_file_name (build_string (".."), dir
);
479 Vinstallation_directory
480 = Ffile_name_as_directory (tem
);
485 /* If the Emacs executable is actually a link,
486 next try the dir that the link points into. */
487 tem
= Ffile_symlink_p (name
);
490 name
= Fexpand_file_name (tem
, dir
);
491 dir
= Ffile_name_directory (name
);
498 Vcommand_line_args
= Qnil
;
500 for (i
= argc
- 1; i
>= 0; i
--)
502 if (i
== 0 || i
> skip_args
)
503 /* For the moment, we keep arguments as is in unibyte strings.
504 They are decoded in the function command-line after we know
505 locale-coding-system. */
507 = Fcons (make_unibyte_string (argv
[i
], strlen (argv
[i
])),
511 unbind_to (count
, Qnil
);
514 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
515 doc
: /* Return the program name that was used to run Emacs.
516 Any directory names are omitted. */)
519 return Fcopy_sequence (Vinvocation_name
);
522 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
524 doc
: /* Return the directory name in which the Emacs executable was located. */)
527 return Fcopy_sequence (Vinvocation_directory
);
532 /* A valid but unlikely value for the TZ environment value.
533 It is OK (though a bit slower) if the user actually chooses this value. */
534 static char dump_tz
[] = "UtC0";
537 #ifndef ORDINARY_LINK
538 /* We don't include crtbegin.o and crtend.o in the link,
539 so these functions and variables might be missed.
540 Provide dummy definitions to avoid error.
541 (We don't have any real constructors or destructors.) */
544 /* Define a dummy function F. Declare F too, to pacify gcc
545 -Wmissing-prototypes. */
546 #define DEFINE_DUMMY_FUNCTION(f) \
547 void f (void) ATTRIBUTE_CONST EXTERNALLY_VISIBLE; void f (void) {}
549 #ifndef GCC_CTORS_IN_LIBC
550 DEFINE_DUMMY_FUNCTION (__do_global_ctors
)
551 DEFINE_DUMMY_FUNCTION (__do_global_ctors_aux
)
552 DEFINE_DUMMY_FUNCTION (__do_global_dtors
)
553 /* GNU/Linux has a bug in its library; avoid an error. */
555 char * __CTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
557 char * __DTOR_LIST__
[2] EXTERNALLY_VISIBLE
= { (char *) (-1), 0 };
558 #endif /* GCC_CTORS_IN_LIBC */
559 DEFINE_DUMMY_FUNCTION (__main
)
560 #endif /* __GNUC__ */
561 #endif /* ORDINARY_LINK */
563 /* Test whether the next argument in ARGV matches SSTR or a prefix of
564 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
565 (the argument is supposed to have a value) store in *VALPTR either
566 the next argument or the portion of this one after the equal sign.
567 ARGV is read starting at position *SKIPPTR; this index is advanced
568 by the number of arguments used.
570 Too bad we can't just use getopt for all of this, but we don't have
571 enough information to do it right. */
574 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
575 int minlen
, char **valptr
, int *skipptr
)
581 /* Don't access argv[argc]; give up in advance. */
582 if (argc
<= *skipptr
+ 1)
585 arg
= argv
[*skipptr
+1];
588 if (strcmp (arg
, sstr
) == 0)
592 *valptr
= argv
[*skipptr
+2];
599 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
600 ? p
- arg
: strlen (arg
));
601 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
603 else if (valptr
== NULL
)
614 else if (argv
[*skipptr
+2] != NULL
)
616 *valptr
= argv
[*skipptr
+2];
626 #ifdef DOUG_LEA_MALLOC
628 /* malloc can be invoked even before main (e.g. by the dynamic
629 linker), so the dumped malloc state must be restored as early as
630 possible using this special hook. */
633 malloc_initialize_hook (void)
637 if (!malloc_using_checking
)
638 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
639 ignored if the heap to be restored was constructed without
640 malloc checking. Can't use unsetenv, since that calls malloc. */
644 for (p
= environ
; p
&& *p
; p
++)
645 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
654 malloc_set_state (malloc_state_ptr
);
655 #ifndef XMALLOC_OVERRUN_CHECK
656 free (malloc_state_ptr
);
661 if (my_heap_start
== 0)
662 my_heap_start
= sbrk (0);
663 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
667 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
669 #endif /* DOUG_LEA_MALLOC */
674 main (int argc
, char **argv
)
679 char stack_bottom_variable
;
680 bool do_initial_setlocale
;
682 #ifdef HAVE_SETRLIMIT
692 struct sigaction fatal_error_action
;
698 #if defined (USE_GTK) && defined (G_SLICE_ALWAYS_MALLOC)
699 /* This is used by the Cygwin build. */
700 setenv ("G_SLICE", "always-malloc", 1);
706 extern char my_endbss
[];
707 extern char *my_endbss_static
;
709 if (my_heap_start
== 0)
710 my_heap_start
= sbrk (0);
712 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
716 #ifdef RUN_TIME_REMAP
718 run_time_remap (argv
[0]);
721 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
724 unexec_init_emacs_zone ();
727 sort_args (argc
, argv
);
729 while (argv
[argc
]) argc
++;
731 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
733 const char *version
, *copyright
;
736 Lisp_Object tem
, tem2
;
737 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
738 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
741 fprintf (stderr
, "Invalid value of `emacs-version'\n");
746 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
751 version
= SSDATA (tem
);
752 copyright
= SSDATA (tem2
);
757 version
= emacs_version
;
758 copyright
= emacs_copyright
;
760 printf ("GNU Emacs %s\n", version
);
761 printf ("%s\n", copyright
);
762 printf ("GNU Emacs comes with ABSOLUTELY NO WARRANTY.\n");
763 printf ("You may redistribute copies of Emacs\n");
764 printf ("under the terms of the GNU General Public License.\n");
765 printf ("For more information about these matters, ");
766 printf ("see the file named COPYING.\n");
770 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
771 if (chdir (ch_to_dir
) == -1)
773 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
774 argv
[0], ch_to_dir
, strerror (errno
));
779 #ifdef HAVE_PERSONALITY_LINUX32
781 && (strcmp (argv
[argc
-1], "dump") == 0
782 || strcmp (argv
[argc
-1], "bootstrap") == 0)
783 && ! getenv ("EMACS_HEAP_EXEC"))
785 static char heapexec
[] = "EMACS_HEAP_EXEC=true";
786 /* Set this so we only do this once. */
789 /* A flag to turn off address randomization which is introduced
790 in linux kernel shipped with fedora core 4 */
791 #define ADD_NO_RANDOMIZE 0x0040000
792 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
793 #undef ADD_NO_RANDOMIZE
795 execvp (argv
[0], argv
);
797 /* If the exec fails, try to dump anyway. */
800 #endif /* HAVE_PERSONALITY_LINUX32 */
802 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
803 /* Extend the stack space available.
804 Don't do that if dumping, since some systems (e.g. DJGPP)
805 might define a smaller stack limit at that time. */
808 && (!noninteractive
|| initialized
)
810 && !getrlimit (RLIMIT_STACK
, &rlim
))
813 extern size_t re_max_failures
;
814 /* Approximate the amount regex.c needs per unit of re_max_failures. */
815 int ratio
= 20 * sizeof (char *);
816 /* Then add 33% to cover the size of the smaller stacks that regex.c
817 successively allocates and discards, on its way to the maximum. */
819 /* Add in some extra to cover
820 what we're likely to use for other reasons. */
821 newlim
= re_max_failures
* ratio
+ 200000;
823 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
824 stack allocation routine for new process that the allocation
825 fails if stack limit is not on page boundary. So, round up the
826 new limit to page boundary. */
827 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
829 if (newlim
> rlim
.rlim_max
)
831 newlim
= rlim
.rlim_max
;
832 /* Don't let regex.c overflow the stack we have. */
833 re_max_failures
= (newlim
- 200000) / ratio
;
835 if (rlim
.rlim_cur
< newlim
)
836 rlim
.rlim_cur
= newlim
;
838 setrlimit (RLIMIT_STACK
, &rlim
);
840 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
842 /* Record (approximately) where the stack begins. */
843 stack_bottom
= &stack_bottom_variable
;
847 #ifndef SYSTEM_MALLOC
848 /* Arrange to get warning messages as memory fills up. */
849 memory_warnings (0, malloc_warning
);
851 /* Call malloc at least once, to run the initial __malloc_hook.
852 Also call realloc and free for consistency. */
853 free (realloc (malloc (4), 4));
856 /* Arrange to disable interrupt input inside malloc etc. */
857 uninterrupt_malloc ();
858 # endif /* not SYNC_INPUT */
859 #endif /* not SYSTEM_MALLOC */
861 #if defined (MSDOS) || defined (WINDOWSNT)
862 /* We do all file input/output as binary files. When we need to translate
863 newlines, we do that manually. */
865 #endif /* MSDOS || WINDOWSNT */
868 if (!isatty (fileno (stdin
)))
869 setmode (fileno (stdin
), O_BINARY
);
870 if (!isatty (fileno (stdout
)))
873 setmode (fileno (stdout
), O_BINARY
);
877 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
878 The build procedure uses this while dumping, to ensure that the
879 dumped Emacs does not have its system locale tables initialized,
880 as that might cause screwups when the dumped Emacs starts up. */
882 char *lc_all
= getenv ("LC_ALL");
883 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
886 /* Set locale now, so that initial error messages are localized properly.
887 fixup_locale must wait until later, since it builds strings. */
888 if (do_initial_setlocale
)
889 setlocale (LC_ALL
, "");
891 inhibit_window_system
= 0;
893 /* Handle the -t switch, which specifies filename to use as terminal. */
897 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
902 result
= emacs_open (term
, O_RDWR
, 0);
903 if (result
< 0 || dup (0) < 0)
905 char *errstring
= strerror (errno
);
906 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
911 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
914 fprintf (stderr
, "Using %s\n", term
);
915 #ifdef HAVE_WINDOW_SYSTEM
916 inhibit_window_system
= 1; /* -t => -nw */
923 /* Command line option --no-windows is deprecated and thus not mentioned
924 in the manual and usage information. */
925 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
926 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
927 inhibit_window_system
= 1;
929 /* Handle the -batch switch, which means don't do interactive display. */
931 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
934 Vundo_outer_limit
= Qnil
;
936 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
938 noninteractive
= 1; /* Set batch mode. */
939 /* Convert --script to -scriptload, un-skip it, and sort again
940 so that it will be handled in proper sequence. */
941 /* FIXME broken for --script=FILE - is that supposed to work? */
942 argv
[skip_args
- 1] = (char *) "-scriptload";
944 sort_args (argc
, argv
);
947 /* Handle the --help option, which gives a usage message. */
948 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
950 printf (USAGE1
, argv
[0], USAGE2
);
956 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
957 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
962 /* Start as a daemon: fork a new child process which will run the
963 rest of the initialization code, then exit.
965 Detaching a daemon requires the following steps:
969 - close the tty file-descriptors
971 We only want to do the last 2 steps once the daemon is ready to
972 serve requests, i.e. after loading .emacs (initialization).
973 OTOH initialization may start subprocesses (e.g. ispell) and these
974 should be run from the proper process (the one that will end up
975 running as daemon) and with the proper "session id" in order for
976 them to keep working after detaching, so fork and setsid need to be
977 performed before initialization.
979 We want to avoid exiting before the server socket is ready, so
980 use a pipe for synchronization. The parent waits for the child
981 to close its end of the pipe (using `daemon-initialized')
983 if (pipe (daemon_pipe
) == -1)
985 fprintf (stderr
, "Cannot pipe!\n");
989 #ifndef NS_IMPL_COCOA
991 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
992 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
993 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
996 #else /* NS_IMPL_COCOA */
997 /* Under Cocoa we must do fork+exec as CoreFoundation lib fails in
998 forked process: http://developer.apple.com/ReleaseNotes/
999 CoreFoundation/CoreFoundation.html)
1000 We mark being in the exec'd process by a daemon name argument of
1001 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
1002 NAME is the original daemon name, if any. */
1003 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1004 f
= fork (); /* in orig */
1006 f
= 0; /* in exec'd */
1007 #endif /* NS_IMPL_COCOA */
1013 /* Close unused writing end of the pipe. */
1014 close (daemon_pipe
[1]);
1016 /* Just wait for the child to close its end of the pipe. */
1019 retval
= read (daemon_pipe
[0], &buf
, 1);
1021 while (retval
== -1 && errno
== EINTR
);
1025 fprintf (stderr
, "Error reading status from child\n");
1028 else if (retval
== 0)
1030 fprintf (stderr
, "Error: server did not start correctly\n");
1034 close (daemon_pipe
[0]);
1039 fprintf (stderr
, "Cannot fork!\n");
1043 #ifdef NS_IMPL_COCOA
1045 /* In orig process, forked as child, OR in exec'd. */
1046 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1047 { /* In orig, child: now exec w/special daemon name. */
1050 snprintf (fdStr
, sizeof fdStr
,
1051 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1052 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1054 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1056 fprintf (stderr
, "daemon: child name too long\n");
1060 argv
[skip_args
] = fdStr
;
1062 execv (argv
[0], argv
);
1063 fprintf (stderr
, "emacs daemon: exec failed: %d\n", errno
);
1067 /* In exec'd: parse special dname into pipe and name info. */
1068 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1069 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1071 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1074 dname_arg2
[0] = '\0';
1075 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1077 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1079 #endif /* NS_IMPL_COCOA */
1082 daemon_name
= xstrdup (dname_arg
);
1083 /* Close unused reading end of the pipe. */
1084 close (daemon_pipe
[0]);
1085 /* Make sure that the used end of the pipe is closed on exec, so
1086 that it is not accessible to programs started from .emacs. */
1087 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1093 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1098 if (! noninteractive
)
1100 #if defined (USG5) && defined (INTERRUPT_INPUT)
1103 #if defined (HAVE_PTHREAD) && !defined (SYSTEM_MALLOC) && !defined (DOUG_LEA_MALLOC)
1105 extern void malloc_enable_thread (void);
1107 malloc_enable_thread ();
1113 emacs_sigaction_init (&fatal_error_action
, deliver_fatal_signal
);
1115 /* Don't catch SIGHUP if dumping. */
1122 /* In --batch mode, don't catch SIGHUP if already ignored.
1123 That makes nohup work. */
1124 bool catch_SIGHUP
= !noninteractive
;
1127 struct sigaction old_action
;
1128 sigaction (SIGHUP
, 0, &old_action
);
1129 catch_SIGHUP
= old_action
.sa_handler
!= SIG_IGN
;
1132 sigaction (SIGHUP
, &fatal_error_action
, 0);
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 sigaction (SIGQUIT
, &fatal_error_action
, 0);
1147 sigaction (SIGILL
, &fatal_error_action
, 0);
1148 sigaction (SIGTRAP
, &fatal_error_action
, 0);
1150 add_user_signal (SIGUSR1
, "sigusr1");
1153 add_user_signal (SIGUSR2
, "sigusr2");
1156 sigaction (SIGABRT
, &fatal_error_action
, 0);
1159 sigaction (SIGHWE
, &fatal_error_action
, 0);
1162 sigaction (SIGPRE
, &fatal_error_action
, 0);
1165 sigaction (SIGORE
, &fatal_error_action
, 0);
1168 sigaction (SIGUME
, &fatal_error_action
, 0);
1171 sigaction (SIGDLK
, &fatal_error_action
, 0);
1174 sigaction (SIGCPULIM
, &fatal_error_action
, 0);
1177 /* This is missing on some systems - OS/2, for example. */
1178 sigaction (SIGIOT
, &fatal_error_action
, 0);
1181 sigaction (SIGEMT
, &fatal_error_action
, 0);
1183 sigaction (SIGFPE
, &fatal_error_action
, 0);
1185 sigaction (SIGBUS
, &fatal_error_action
, 0);
1187 sigaction (SIGSEGV
, &fatal_error_action
, 0);
1189 sigaction (SIGSYS
, &fatal_error_action
, 0);
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.
1197 sigaction (SIGINT
, &fatal_error_action
, 0);
1198 sigaction (SIGTERM
, &fatal_error_action
, 0);
1200 sigaction (SIGXCPU
, &fatal_error_action
, 0);
1203 sigaction (SIGXFSZ
, &fatal_error_action
, 0);
1204 #endif /* SIGXFSZ */
1207 /* This just means available memory is getting low. */
1209 struct sigaction action
;
1210 emacs_sigaction_init (&action
, deliver_danger_signal
);
1211 sigaction (SIGDANGER
, &action
, 0);
1216 /* 20 is SIGCHLD, 21 is SIGTTIN, 22 is SIGTTOU. */
1217 sigaction (SIGXCPU
, &fatal_error_action
, 0);
1218 sigaction (SIGIOINT
, &fatal_error_action
, 0);
1219 sigaction (SIGGRANT
, &fatal_error_action
, 0);
1220 sigaction (SIGRETRACT
, &fatal_error_action
, 0);
1221 sigaction (SIGSOUND
, &fatal_error_action
, 0);
1222 sigaction (SIGMSG
, &fatal_error_action
, 0);
1226 noninteractive1
= noninteractive
;
1228 /* Perform basic initializations (not merely interning symbols). */
1235 init_charset_once ();
1236 init_coding_once ();
1237 init_syntax_once (); /* Create standard syntax table. */
1238 init_category_once (); /* Create standard category table. */
1239 /* Must be done before init_buffer. */
1240 init_casetab_once ();
1241 init_buffer_once (); /* Create buffer table and some buffers. */
1242 init_minibuf_once (); /* Create list of minibuffers. */
1243 /* Must precede init_window_once. */
1245 /* Call syms_of_xfaces before init_window_once because that
1246 function creates Vterminal_frame. Termcap frames now use
1247 faces, and the face implementation uses some symbols as
1250 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1251 be better to arrange things not to have this dependency. */
1253 /* Call syms_of_keyboard before init_window_once because
1254 keyboard sets up symbols that include some face names that
1255 the X support will want to use. This can happen when
1256 CANNOT_DUMP is defined. */
1257 syms_of_keyboard ();
1259 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1262 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1264 /* Before syms_of_coding because it initializes Qcharsetp. */
1266 /* Before init_window_once, because it sets up the
1267 Vcoding_system_hash_table. */
1268 syms_of_coding (); /* This should be after syms_of_fileio. */
1270 init_window_once (); /* Init the window system. */
1271 #ifdef HAVE_WINDOW_SYSTEM
1272 init_fringe_once (); /* Swap bitmaps if necessary. */
1273 #endif /* HAVE_WINDOW_SYSTEM */
1278 if (do_initial_setlocale
)
1281 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1282 Vsystem_time_locale
= Vprevious_system_time_locale
;
1288 running_asynch_code
= 0;
1292 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1295 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1298 ns_pool
= ns_alloc_autorelease_pool ();
1299 if (!noninteractive
)
1301 #ifdef NS_IMPL_COCOA
1302 if (skip_args
< argc
)
1304 /* FIXME: Do the right thing if getenv returns NULL, or if
1306 if (!strncmp (argv
[skip_args
], "-psn", 4))
1309 chdir (getenv ("HOME"));
1311 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1314 chdir (getenv ("HOME"));
1319 #endif /* HAVE_NS */
1321 #ifdef HAVE_X_WINDOWS
1322 /* Stupid kludge to catch command-line display spec. We can't
1323 handle this argument entirely in window system dependent code
1324 because we don't even know which window system dependent code
1325 to run until we've recognized this argument. */
1327 char *displayname
= 0;
1328 int count_before
= skip_args
;
1330 /* Skip any number of -d options, but only use the last one. */
1333 int count_before_this
= skip_args
;
1335 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1337 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1342 count_before
= count_before_this
;
1345 /* If we have the form --display=NAME,
1346 convert it into -d name.
1347 This requires inserting a new element into argv. */
1348 if (displayname
&& count_before
< skip_args
)
1350 if (skip_args
== count_before
+ 1)
1352 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1353 (argc
- (count_before
+ 2)) * sizeof *argv
);
1354 argv
[count_before
+ 2] = displayname
;
1357 argv
[count_before
+ 1] = (char *) "-d";
1362 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1363 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1367 /* Don't actually discard this arg. */
1368 skip_args
= count_before
;
1370 #else /* !HAVE_X_WINDOWS */
1373 int count_before
= skip_args
;
1375 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1376 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1379 skip_args
= count_before
;
1383 /* argmatch must not be used after here,
1384 except when building temacs
1385 because the -d argument has not been skipped in skip_args. */
1388 /* Call early 'cause init_environment needs it. */
1390 /* Set defaults for several environment variables. */
1392 init_environment (argc
, argv
, skip_args
);
1399 /* Initialize environment from registry settings. */
1400 init_environment (argv
);
1401 init_ntproc (); /* must precede init_editfns. */
1404 /* Initialize and GC-protect Vinitial_environment and
1405 Vprocess_environment before set_initial_environment fills them
1408 syms_of_callproc ();
1409 /* egetenv is a pretty low-level facility, which may get called in
1410 many circumstances; it seems flimsy to put off initializing it
1411 until calling init_callproc. Do not do it when dumping. */
1412 if (initialized
|| ((strcmp (argv
[argc
-1], "dump") != 0
1413 && strcmp (argv
[argc
-1], "bootstrap") != 0)))
1414 set_initial_environment ();
1416 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1417 if this is not done. Do it after set_global_environment so that we
1418 don't pollute Vglobal_environment. */
1419 /* Setting LANG here will defeat the startup locale processing... */
1424 init_buffer (); /* Init default directory of main buffer. */
1426 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1427 init_cmdargs (argc
, argv
, skip_args
); /* Must precede init_lread. */
1431 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1432 Lisp_Object old_log_max
;
1433 old_log_max
= Vmessage_log_max
;
1434 XSETFASTINT (Vmessage_log_max
, 0);
1435 message_dolog ("", 0, 1, 0);
1436 Vmessage_log_max
= old_log_max
;
1439 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1442 /* Check to see if Emacs has been installed correctly. */
1443 check_windows_init_file ();
1446 /* Intern the names of all standard functions and variables;
1447 define standard keys. */
1451 /* The basic levels of Lisp must come first. Note that
1452 syms_of_data and some others have already been called. */
1458 syms_of_floatfns ();
1461 syms_of_bytecode ();
1463 syms_of_casefiddle ();
1465 syms_of_category ();
1467 syms_of_character ();
1474 syms_of_filelock ();
1477 /* syms_of_keymap (); */
1485 syms_of_terminal ();
1491 syms_of_textprop ();
1492 syms_of_composite ();
1495 #endif /* WINDOWSNT */
1499 #ifdef HAVE_WINDOW_SYSTEM
1502 #endif /* HAVE_WINDOW_SYSTEM */
1503 #ifdef HAVE_X_WINDOWS
1508 syms_of_xsettings ();
1515 #endif /* HAVE_X_WINDOWS */
1526 syms_of_w32select ();
1529 #endif /* HAVE_NTGUI */
1535 syms_of_win16select ();
1542 syms_of_nsselect ();
1544 #endif /* HAVE_NS */
1551 syms_of_dbusbind ();
1552 #endif /* HAVE_DBUS */
1556 #endif /* WINDOWSNT */
1558 keys_of_casefiddle ();
1561 keys_of_keyboard ();
1567 /* Initialization that must be done even if the global variable
1568 initialized is non zero. */
1570 globals_of_w32font ();
1571 globals_of_w32fns ();
1572 globals_of_w32menu ();
1573 globals_of_w32select ();
1574 #endif /* HAVE_NTGUI */
1579 init_editfns (); /* init_process_emacs uses Voperating_system_release. */
1580 init_process_emacs (); /* init_display uses add_keyboard_wait_descriptor. */
1581 init_keyboard (); /* This too must precede init_sys_modes. */
1582 if (!noninteractive
)
1583 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1585 #ifdef HAVE_WINDOW_SYSTEM
1587 #endif /* HAVE_WINDOW_SYSTEM */
1595 /* Handle -l loadup, args passed by Makefile. */
1596 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1597 Vtop_level
= Fcons (intern_c_string ("load"),
1598 Fcons (build_string (file
), Qnil
));
1599 /* Unless next switch is -nl, load "loadup.el" first thing. */
1601 Vtop_level
= Fcons (intern_c_string ("load"),
1602 Fcons (build_string ("loadup.el"), Qnil
));
1609 /* If the execution TZ happens to be the same as the dump TZ,
1610 change it to some other value and then change it back,
1611 to force the underlying implementation to reload the TZ info.
1612 This is needed on implementations that load TZ info from files,
1613 since the TZ file contents may differ between dump and execution. */
1614 char *tz
= getenv ("TZ");
1615 if (tz
&& !strcmp (tz
, dump_tz
))
1625 /* Set up for profiling. This is known to work on FreeBSD,
1626 GNU/Linux and MinGW. It might work on some other systems too.
1627 Give it a try and tell us if it works on your system. To compile
1628 for profiling, use the configure option --enable-profiling. */
1629 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1634 extern unsigned char etext
asm ("etext");
1640 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1649 #ifdef LOCALTIME_CACHE
1650 /* Some versions of localtime have a bug. They cache the value of the time
1651 zone rather than looking it up every time. Since localtime() is
1652 called to bolt the undumping time into the undumped emacs, this
1653 results in localtime ignoring the TZ environment variable.
1654 This flushes the new TZ value into localtime. */
1656 #endif /* defined (LOCALTIME_CACHE) */
1658 /* Enter editor command loop. This never returns. */
1664 /* Sort the args so we can find the most important ones
1665 at the beginning of argv. */
1667 /* First, here's a table of all the standard options. */
1669 struct standard_args
1672 const char *longname
;
1677 static const struct standard_args standard_args
[] =
1679 { "-version", "--version", 150, 0 },
1680 { "-chdir", "--chdir", 130, 1 },
1681 { "-t", "--terminal", 120, 1 },
1682 { "-nw", "--no-window-system", 110, 0 },
1683 { "-nw", "--no-windows", 110, 0 },
1684 { "-batch", "--batch", 100, 0 },
1685 { "-script", "--script", 100, 1 },
1686 { "-daemon", "--daemon", 99, 0 },
1687 { "-help", "--help", 90, 0 },
1688 { "-nl", "--no-loadup", 70, 0 },
1689 { "-nsl", "--no-site-lisp", 65, 0 },
1690 /* -d must come last before the options handled in startup.el. */
1691 { "-d", "--display", 60, 1 },
1692 { "-display", 0, 60, 1 },
1693 /* Now for the options handled in `command-line' (startup.el). */
1694 /* (Note that to imply -nsl, -Q is partially handled here.) */
1695 { "-Q", "--quick", 55, 0 },
1696 { "-quick", 0, 55, 0 },
1697 { "-q", "--no-init-file", 50, 0 },
1698 { "-no-init-file", 0, 50, 0 },
1699 { "-no-site-file", "--no-site-file", 40, 0 },
1700 { "-u", "--user", 30, 1 },
1701 { "-user", 0, 30, 1 },
1702 { "-debug-init", "--debug-init", 20, 0 },
1703 { "-iconic", "--iconic", 15, 0 },
1704 { "-D", "--basic-display", 12, 0},
1705 { "-basic-display", 0, 12, 0},
1706 { "-nbc", "--no-blinking-cursor", 12, 0 },
1707 /* Now for the options handled in `command-line-1' (startup.el). */
1708 { "-nbi", "--no-bitmap-icon", 10, 0 },
1709 { "-bg", "--background-color", 10, 1 },
1710 { "-background", 0, 10, 1 },
1711 { "-fg", "--foreground-color", 10, 1 },
1712 { "-foreground", 0, 10, 1 },
1713 { "-bd", "--border-color", 10, 1 },
1714 { "-bw", "--border-width", 10, 1 },
1715 { "-ib", "--internal-border", 10, 1 },
1716 { "-ms", "--mouse-color", 10, 1 },
1717 { "-cr", "--cursor-color", 10, 1 },
1718 { "-fn", "--font", 10, 1 },
1719 { "-font", 0, 10, 1 },
1720 { "-fs", "--fullscreen", 10, 0 },
1721 { "-fw", "--fullwidth", 10, 0 },
1722 { "-fh", "--fullheight", 10, 0 },
1723 { "-mm", "--maximized", 10, 0 },
1724 { "-g", "--geometry", 10, 1 },
1725 { "-geometry", 0, 10, 1 },
1726 { "-T", "--title", 10, 1 },
1727 { "-title", 0, 10, 1 },
1728 { "-name", "--name", 10, 1 },
1729 { "-xrm", "--xrm", 10, 1 },
1730 { "-parent-id", "--parent-id", 10, 1 },
1731 { "-r", "--reverse-video", 5, 0 },
1733 { "-reverse", 0, 5, 0 },
1734 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1735 { "-vb", "--vertical-scroll-bars", 5, 0 },
1736 { "-color", "--color", 5, 0},
1737 { "-no-splash", "--no-splash", 3, 0 },
1738 { "-no-desktop", "--no-desktop", 3, 0 },
1740 { "-NSAutoLaunch", 0, 5, 1 },
1741 { "-NXAutoLaunch", 0, 5, 1 },
1742 { "-disable-font-backend", "--disable-font-backend", 65, 0 },
1743 { "-_NSMachLaunch", 0, 85, 1 },
1744 { "-MachLaunch", 0, 85, 1 },
1745 { "-macosx", 0, 85, 0 },
1746 { "-NSHost", 0, 85, 1 },
1748 /* These have the same priority as ordinary file name args,
1749 so they are not reordered with respect to those. */
1750 { "-L", "--directory", 0, 1 },
1751 { "-directory", 0, 0, 1 },
1752 { "-l", "--load", 0, 1 },
1753 { "-load", 0, 0, 1 },
1754 /* This has no longname, because using --scriptload confuses sort_args,
1755 because then the --script long option seems to match twice; ie
1756 you can't have a long option which is a prefix of another long
1757 option. In any case, this is entirely an internal option. */
1758 { "-scriptload", NULL
, 0, 1 },
1759 { "-f", "--funcall", 0, 1 },
1760 { "-funcall", 0, 0, 1 },
1761 { "-eval", "--eval", 0, 1 },
1762 { "-execute", "--execute", 0, 1 },
1763 { "-find-file", "--find-file", 0, 1 },
1764 { "-visit", "--visit", 0, 1 },
1765 { "-file", "--file", 0, 1 },
1766 { "-insert", "--insert", 0, 1 },
1768 { "-NXOpen", 0, 0, 1 },
1769 { "-NXOpenTemp", 0, 0, 1 },
1770 { "-NSOpen", 0, 0, 1 },
1771 { "-NSOpenTemp", 0, 0, 1 },
1772 { "-GSFilePath", 0, 0, 1 },
1774 /* This should be processed after ordinary file name args and the like. */
1775 { "-kill", "--kill", -10, 0 },
1778 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1779 so that the highest priority ones come first.
1780 Do not change the order of elements of equal priority.
1781 If an option takes an argument, keep it and its argument together.
1783 If an option that takes no argument appears more
1784 than once, eliminate all but one copy of it. */
1787 sort_args (int argc
, char **argv
)
1789 char **new = xmalloc (argc
* sizeof *new);
1790 /* For each element of argv,
1791 the corresponding element of options is:
1792 0 for an option that takes no arguments,
1793 1 for an option that takes one argument, etc.
1794 -1 for an ordinary non-option argument. */
1795 int *options
= xnmalloc (argc
, sizeof *options
);
1796 int *priority
= xnmalloc (argc
, sizeof *priority
);
1798 int incoming_used
= 1;
1802 /* Categorize all the options,
1803 and figure out which argv elts are option arguments. */
1804 for (from
= 1; from
< argc
; from
++)
1808 if (argv
[from
][0] == '-')
1812 /* If we have found "--", don't consider
1813 any more arguments as options. */
1814 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1816 /* Leave the "--", and everything following it, at the end. */
1817 for (; from
< argc
; from
++)
1819 priority
[from
] = -100;
1825 /* Look for a match with a known old-fashioned option. */
1826 for (i
= 0; i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1827 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1829 options
[from
] = standard_args
[i
].nargs
;
1830 priority
[from
] = standard_args
[i
].priority
;
1831 if (from
+ standard_args
[i
].nargs
>= argc
)
1832 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1833 from
+= standard_args
[i
].nargs
;
1837 /* Look for a match with a known long option.
1838 MATCH is -1 if no match so far, -2 if two or more matches so far,
1839 >= 0 (the table index of the match) if just one match so far. */
1840 if (argv
[from
][1] == '-')
1842 char const *equals
= strchr (argv
[from
], '=');
1844 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1849 i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1850 if (standard_args
[i
].longname
1851 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1860 /* If we found exactly one match, use that. */
1863 options
[from
] = standard_args
[match
].nargs
;
1864 priority
[from
] = standard_args
[match
].priority
;
1865 /* If --OPTION=VALUE syntax is used,
1866 this option uses just one argv element. */
1869 if (from
+ options
[from
] >= argc
)
1870 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1871 from
+= options
[from
];
1873 /* FIXME When match < 0, shouldn't there be some error,
1874 or at least indication to the user that there was a
1881 /* Copy the arguments, in order of decreasing priority, to NEW. */
1883 while (incoming_used
< argc
)
1886 int best_priority
= -9999;
1888 /* Find the highest priority remaining option.
1889 If several have equal priority, take the first of them. */
1890 for (from
= 1; from
< argc
; from
++)
1892 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1894 best_priority
= priority
[from
];
1897 /* Skip option arguments--they are tied to the options. */
1898 if (options
[from
] > 0)
1899 from
+= options
[from
];
1905 /* Copy the highest priority remaining option, with its args, to NEW.
1906 Unless it is a duplicate of the previous one. */
1907 if (! (options
[best
] == 0
1908 && ! strcmp (new[to
- 1], argv
[best
])))
1910 new[to
++] = argv
[best
];
1911 for (i
= 0; i
< options
[best
]; i
++)
1912 new[to
++] = argv
[best
+ i
+ 1];
1915 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1917 /* Clear out this option in ARGV. */
1919 for (i
= 0; i
< options
[best
]; i
++)
1920 argv
[best
+ i
+ 1] = 0;
1923 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1927 memcpy (argv
, new, sizeof (char *) * argc
);
1934 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1935 doc
: /* Exit the Emacs job and kill it.
1936 If ARG is an integer, return ARG as the exit program code.
1937 If ARG is a string, stuff it as keyboard input.
1939 This function is called upon receipt of the signals SIGTERM
1940 or SIGHUP, and upon SIGINT in batch mode.
1942 The value of `kill-emacs-hook', if not void,
1943 is a list of functions (of no args),
1944 all of which are called before Emacs is actually killed. */)
1947 struct gcpro gcpro1
;
1956 hook
= intern ("kill-emacs-hook");
1957 Frun_hooks (1, &hook
);
1961 #ifdef HAVE_X_WINDOWS
1962 /* Transfer any clipboards we own to the clipboard manager. */
1963 x_clipboard_manager_save_all ();
1966 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1969 ns_release_autorelease_pool (ns_pool
);
1972 /* If we have an auto-save list file,
1973 kill it because we are exiting Emacs deliberately (not crashing).
1974 Do it after shut_down_emacs, which does an auto-save. */
1975 if (STRINGP (Vauto_save_list_file_name
))
1976 unlink (SSDATA (Vauto_save_list_file_name
));
1979 exit_code
= (XINT (arg
) < 0
1980 ? XINT (arg
) | INT_MIN
1981 : XINT (arg
) & INT_MAX
);
1982 else if (noninteractive
&& (fflush (stdout
) || ferror (stdout
)))
1983 exit_code
= EXIT_FAILURE
;
1985 exit_code
= EXIT_SUCCESS
;
1990 /* Perform an orderly shutdown of Emacs. Autosave any modified
1991 buffers, kill any child processes, clean up the terminal modes (if
1992 we're in the foreground), and other stuff like that. Don't perform
1993 any redisplay; this may be called when Emacs is shutting down in
1994 the background, or after its X connection has died.
1996 If SIG is a signal number, print a message for it.
1998 This is called by fatal signal handlers, X protocol error handlers,
2002 shut_down_emacs (int sig
, Lisp_Object stuff
)
2004 /* Prevent running of hooks from now on. */
2007 /* Don't update display from now on. */
2008 Vinhibit_redisplay
= Qt
;
2010 /* If we are controlling the terminal, reset terminal modes. */
2013 int pgrp
= EMACS_GETPGRP (0);
2014 int tpgrp
= tcgetpgrp (0);
2015 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2017 reset_all_sys_modes ();
2018 if (sig
&& sig
!= SIGTERM
)
2019 fprintf (stderr
, "Fatal error %d: %s", sig
, strsignal (sig
));
2024 reset_all_sys_modes ();
2027 stuff_buffered_input (stuff
);
2029 inhibit_sentinels
= 1;
2030 kill_buffer_processes (Qnil
);
2031 Fdo_auto_save (Qt
, Qnil
);
2033 #ifdef CLASH_DETECTION
2034 unlock_all_files ();
2037 /* There is a tendency for a SIGIO signal to arrive within exit,
2038 and cause a SIGHUP because the input descriptor is already closed. */
2046 /* Do this only if terminating normally, we want glyph matrices
2047 etc. in a core dump. */
2048 if (sig
== 0 || sig
== SIGTERM
)
2050 check_glyph_memory ();
2051 check_message_stack ();
2059 ns_term_shutdown (sig
);
2063 xml_cleanup_parser ();
2073 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2074 doc
: /* Dump current state of Emacs into executable file FILENAME.
2075 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2076 This is used in the file `loadup.el' when building Emacs.
2078 You must run Emacs in batch mode in order to dump it. */)
2079 (Lisp_Object filename
, Lisp_Object symfile
)
2083 ptrdiff_t count
= SPECPDL_INDEX ();
2087 if (! noninteractive
)
2088 error ("Dumping Emacs works only in batch mode");
2092 /* Warn if the gap between BSS end and heap start is larger than this. */
2093 # define MAX_HEAP_BSS_DIFF (1024*1024)
2095 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2097 fprintf (stderr
, "**************************************************\n");
2098 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2099 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2101 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2102 fprintf (stderr
, "fail because of this. See the section about\n");
2103 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2104 fprintf (stderr
, "**************************************************\n");
2106 #endif /* GNU_LINUX */
2108 /* Bind `command-line-processed' to nil before dumping,
2109 so that the dumped Emacs will process its command line
2110 and set up to work with X windows if appropriate. */
2111 symbol
= intern ("command-line-processed");
2112 specbind (symbol
, Qnil
);
2114 CHECK_STRING (filename
);
2115 filename
= Fexpand_file_name (filename
, Qnil
);
2116 if (!NILP (symfile
))
2118 CHECK_STRING (symfile
);
2119 if (SCHARS (symfile
))
2120 symfile
= Fexpand_file_name (symfile
, Qnil
);
2124 Vpurify_flag
= Qnil
;
2127 set_time_zone_rule (dump_tz
);
2128 #ifndef LOCALTIME_CACHE
2129 /* Force a tz reload, since set_time_zone_rule doesn't. */
2135 /* Tell malloc where start of impure now is. */
2136 /* Also arrange for warnings when nearly out of space. */
2137 #ifndef SYSTEM_MALLOC
2139 /* On Windows, this was done before dumping, and that once suffices.
2140 Meanwhile, my_edata is not valid on Windows. */
2142 extern char my_edata
[];
2143 memory_warnings (my_edata
, malloc_warning
);
2145 #endif /* not WINDOWSNT */
2146 #if defined (HAVE_PTHREAD) && !defined SYNC_INPUT
2147 /* Pthread may call malloc before main, and then we will get an endless
2148 loop, because pthread_self (see alloc.c) calls malloc the first time
2149 it is called on some systems. */
2150 reset_malloc_hooks ();
2152 #endif /* not SYSTEM_MALLOC */
2153 #ifdef DOUG_LEA_MALLOC
2154 malloc_state_ptr
= malloc_get_state ();
2157 #ifdef USE_MMAP_FOR_BUFFERS
2160 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2161 #ifdef USE_MMAP_FOR_BUFFERS
2164 #ifdef DOUG_LEA_MALLOC
2165 free (malloc_state_ptr
);
2170 return unbind_to (count
, Qnil
);
2173 #endif /* not CANNOT_DUMP */
2176 /* Recover from setlocale (LC_ALL, ""). */
2180 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2181 so that numbers are read and printed properly for Emacs Lisp. */
2182 setlocale (LC_NUMERIC
, "C");
2185 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2188 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2190 if (! EQ (*plocale
, desired_locale
))
2192 *plocale
= desired_locale
;
2193 setlocale (category
, (STRINGP (desired_locale
)
2194 ? SSDATA (desired_locale
)
2199 /* Set system time locale to match Vsystem_time_locale, if possible. */
2201 synchronize_system_time_locale (void)
2203 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2204 Vsystem_time_locale
);
2207 /* Set system messages locale to match Vsystem_messages_locale, if
2210 synchronize_system_messages_locale (void)
2213 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2214 Vsystem_messages_locale
);
2217 #endif /* HAVE_SETLOCALE */
2221 decode_env_path (const char *evarname
, const char *defalt
)
2223 const char *path
, *p
;
2224 Lisp_Object lpath
, element
, tem
;
2227 const char *emacs_dir
= egetenv ("emacs_dir");
2228 static const char *emacs_dir_env
= "%emacs_dir%/";
2229 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2232 /* It's okay to use getenv here, because this function is only used
2233 to initialize variables when Emacs starts up, and isn't called
2236 path
= getenv (evarname
);
2247 /* Ensure values from the environment use the proper directory separator. */
2250 char *path_copy
= alloca (strlen (path
) + 1);
2251 strcpy (path_copy
, path
);
2252 dostounix_filename (path_copy
);
2259 p
= strchr (path
, SEPCHAR
);
2261 p
= path
+ strlen (path
);
2262 element
= (p
- path
? make_string (path
, p
- path
)
2263 : build_string ("."));
2265 /* Relative file names in the default path are interpreted as
2266 being relative to $emacs_dir. */
2267 if (emacs_dir
&& defaulted
2268 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2269 element
= Fexpand_file_name (Fsubstring (element
,
2270 make_number (emacs_dir_len
),
2272 build_string (emacs_dir
));
2275 /* Add /: to the front of the name
2276 if it would otherwise be treated as magic. */
2277 tem
= Ffind_file_name_handler (element
, Qt
);
2279 /* However, if the handler says "I'm safe",
2280 don't bother adding /:. */
2284 prop
= Fget (tem
, intern ("safe-magic"));
2290 element
= concat2 (build_string ("/:"), element
);
2292 lpath
= Fcons (element
, lpath
);
2298 return Fnreverse (lpath
);
2301 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2302 doc
: /* Return non-nil if the current emacs process is a daemon.
2303 If the daemon was given a name argument, return that name. */)
2308 return build_string (daemon_name
);
2315 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2316 doc
: /* Mark the Emacs daemon as being initialized.
2317 This finishes the daemonization process by doing the other half of detaching
2318 from the parent process and its tty file descriptors. */)
2325 error ("This function can only be called if emacs is run as a daemon");
2327 if (daemon_pipe
[1] < 0)
2328 error ("The daemon has already been initialized");
2330 if (NILP (Vafter_init_time
))
2331 error ("This function can only be called after loading the init files");
2333 /* Get rid of stdin, stdout and stderr. */
2334 nfd
= open ("/dev/null", O_RDWR
);
2336 err
|= dup2 (nfd
, 0) < 0;
2337 err
|= dup2 (nfd
, 1) < 0;
2338 err
|= dup2 (nfd
, 2) < 0;
2339 err
|= close (nfd
) != 0;
2341 /* Closing the pipe will notify the parent that it can exit.
2342 FIXME: In case some other process inherited the pipe, closing it here
2343 won't notify the parent because it's still open elsewhere, so we
2344 additionally send a byte, just to make sure the parent really exits.
2345 Instead, we should probably close the pipe in start-process and
2346 call-process to make sure the pipe is never inherited by
2348 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2349 err
|= close (daemon_pipe
[1]) != 0;
2350 /* Set it to an invalid value so we know we've already run this function. */
2351 daemon_pipe
[1] = -1;
2354 error ("I/O error during daemon initialization");
2359 syms_of_emacs (void)
2361 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2362 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2363 DEFSYM (Qkill_emacs
, "kill-emacs");
2366 defsubr (&Sdump_emacs
);
2369 defsubr (&Skill_emacs
);
2371 defsubr (&Sinvocation_name
);
2372 defsubr (&Sinvocation_directory
);
2373 defsubr (&Sdaemonp
);
2374 defsubr (&Sdaemon_initialized
);
2376 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2377 doc
: /* Args passed by shell to Emacs, as a list of strings.
2378 Many arguments are deleted from the list as they are processed. */);
2380 DEFVAR_LISP ("system-type", Vsystem_type
,
2381 doc
: /* The value is a symbol indicating the type of operating system you are using.
2383 `gnu' compiled for a GNU Hurd system.
2384 `gnu/linux' compiled for a GNU/Linux system.
2385 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2386 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2387 `ms-dos' compiled as an MS-DOS application.
2388 `windows-nt' compiled as a native W32 application.
2389 `cygwin' compiled using the Cygwin library.
2390 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2391 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2392 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2393 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2395 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2396 doc
: /* Value is string indicating configuration Emacs was built for.
2397 On MS-Windows, the value reflects the OS flavor and version on which
2398 Emacs is running. */);
2399 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2401 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2402 doc
: /* String containing the configuration options Emacs was built with. */);
2403 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2405 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2406 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2408 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2409 doc
: /* Hook run when `kill-emacs' is called.
2410 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2411 in other similar situations), functions placed on this hook should not
2412 expect to be able to interact with the user. To ask for confirmation,
2413 see `kill-emacs-query-functions' instead.
2415 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2416 `noninteractive' was non-nil. */);
2417 Vkill_emacs_hook
= Qnil
;
2419 DEFVAR_LISP ("path-separator", Vpath_separator
,
2420 doc
: /* String containing the character that separates directories in
2421 search paths, such as PATH and other similar environment variables. */);
2424 Vpath_separator
= make_string (&c
, 1);
2427 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2428 doc
: /* The program name that was used to run Emacs.
2429 Any directory names are omitted. */);
2431 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2432 doc
: /* The directory in which the Emacs executable was found, to run it.
2433 The value is nil if that directory's name is not known. */);
2435 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2436 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2437 In an installed Emacs, this is normally nil. It is non-nil if
2438 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2439 within the variable `invocation-directory' or its parent. For example,
2440 this is the case when running an uninstalled Emacs executable from its
2441 build directory. */);
2442 Vinstallation_directory
= Qnil
;
2444 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2445 doc
: /* System locale for messages. */);
2446 Vsystem_messages_locale
= Qnil
;
2448 DEFVAR_LISP ("previous-system-messages-locale",
2449 Vprevious_system_messages_locale
,
2450 doc
: /* Most recently used system locale for messages. */);
2451 Vprevious_system_messages_locale
= Qnil
;
2453 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2454 doc
: /* System locale for time. */);
2455 Vsystem_time_locale
= Qnil
;
2457 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2458 doc
: /* Most recently used system locale for time. */);
2459 Vprevious_system_time_locale
= Qnil
;
2461 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2462 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2463 Vbefore_init_time
= Qnil
;
2465 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2466 doc
: /* Value of `current-time' after loading the init files.
2467 This is nil during initialization. */);
2468 Vafter_init_time
= Qnil
;
2470 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2471 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2472 inhibit_x_resources
= 0;
2474 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2475 doc
: /* Short copyright string for this version of Emacs. */);
2476 Vemacs_copyright
= build_string (emacs_copyright
);
2478 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2479 doc
: /* Version numbers of this version of Emacs. */);
2480 Vemacs_version
= build_string (emacs_version
);
2482 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2483 doc
: /* Alist of dynamic libraries vs external files implementing them.
2484 Each element is a list (LIBRARY FILE...), where the car is a symbol
2485 representing a supported external library, and the rest are strings giving
2486 alternate filenames for that library.
2488 Emacs tries to load the library from the files in the order they appear on
2489 the list; if none is loaded, the running session of Emacs won't have access
2492 Note that image types `pbm' and `xbm' do not need entries in this variable
2493 because they do not depend on external libraries and are always available.
2495 Also note that this is not a generic facility for accessing external
2496 libraries; only those already known by Emacs will be loaded. */);
2497 Vdynamic_library_alist
= Qnil
;
2498 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2500 /* Make sure IS_DAEMON starts up as false. */