1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2014 Free Software
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
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/>. */
21 #define INLINE EXTERN_INLINE
27 #include <sys/types.h>
31 #include <close-stream.h>
38 #include <sys/socket.h>
44 #if defined WINDOWSNT || defined HAVE_NTGUI
45 #include "w32select.h"
47 #include "w32common.h"
54 #ifdef HAVE_WINDOW_SYSTEM
56 #endif /* HAVE_WINDOW_SYSTEM */
58 #ifdef NS_IMPL_GNUSTEP
59 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
60 #include <GNUstepBase/GSConfig.h>
64 #include "intervals.h"
65 #include "character.h"
71 #include "blockinput.h"
72 #include "syssignal.h"
75 #include "termhooks.h"
80 #include "composite.h"
81 #include "dispextern.h"
89 #if (defined PROFILING \
90 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
91 # include <sys/gmon.h>
92 extern void moncontrol (int mode
);
100 #include <sys/time.h>
101 #include <sys/resource.h>
104 #ifdef HAVE_PERSONALITY_LINUX32
105 #include <sys/personality.h>
108 static const char emacs_version
[] = VERSION
;
109 static const char emacs_copyright
[] = COPYRIGHT
;
111 /* Empty lisp strings. To avoid having to build any others. */
112 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
115 /* Cache for externally loaded libraries. */
116 Lisp_Object Vlibrary_cache
;
119 /* Set after Emacs has started up the first time.
120 Prevents reinitialization of the Lisp world and keymaps
121 on subsequent starts. */
125 extern void unexec_init_emacs_zone (void);
128 #ifdef DOUG_LEA_MALLOC
129 /* Preserves a pointer to the memory allocated that copies that
130 static data inside glibc's malloc. */
131 static void *malloc_state_ptr
;
132 /* From glibc, a routine that returns a copy of the malloc internal state. */
133 extern void *malloc_get_state (void);
134 /* From glibc, a routine that overwrites the malloc internal state. */
135 extern int malloc_set_state (void*);
136 /* True if the MALLOC_CHECK_ environment variable was set while
137 dumping. Used to work around a bug in glibc's malloc. */
138 static bool malloc_using_checking
;
139 #elif defined HAVE_PTHREAD && !defined SYSTEM_MALLOC
140 extern void malloc_enable_thread (void);
143 Lisp_Object Qfile_name_handler_alist
;
145 Lisp_Object Qrisky_local_variable
;
147 Lisp_Object Qkill_emacs
;
148 static Lisp_Object Qkill_emacs_hook
;
150 /* If true, Emacs should not attempt to use a window-specific code,
151 but instead should use the virtual terminal under which it was started. */
152 bool inhibit_window_system
;
154 /* If true, a filter or a sentinel is running. Tested to save the match
155 data on the first attempt to change it inside asynchronous code. */
156 bool running_asynch_code
;
158 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
159 /* If true, -d was specified, meaning we're using some window system. */
163 /* An address near the bottom of the stack.
164 Tells GC how to save a copy of the stack. */
167 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
168 /* The address where the heap starts (from the first sbrk (0) call). */
169 static void *my_heap_start
;
173 /* The gap between BSS end and heap start as far as we can tell. */
174 static uprintmax_t heap_bss_diff
;
177 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
180 On Cocoa, CoreFoundation lib fails in forked process:
181 http://developer.apple.com/ReleaseNotes/
182 CoreFoundation/CoreFoundation.html)
184 On Windows, a Cygwin fork child cannot access the USER subsystem.
186 We mark being in the exec'd process by a daemon name argument of
187 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
188 NAME is the original daemon name, if any. */
189 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
190 # define DAEMON_MUST_EXEC
193 /* True means running Emacs without interactive terminal. */
196 /* True means remove site-lisp directories from load-path. */
199 /* Name for the server started by the daemon.*/
200 static char *daemon_name
;
202 /* Pipe used to send exit notification to the daemon parent at
206 /* Save argv and argc. */
210 static void sort_args (int argc
, char **argv
);
211 static void syms_of_emacs (void);
213 /* C89 needs each string be at most 509 characters, so the usage
214 strings below are split to not overflow this limit. */
215 static char const *const usage_message
[] =
218 Run Emacs, the extensible, customizable, self-documenting real-time\n\
219 display editor. The recommended way to start Emacs for normal editing\n\
220 is with no options at all.\n\
222 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
223 read the main documentation for these command-line arguments.\n\
225 Initialization options:\n\
229 --batch do not do interactive display; implies -q\n\
230 --chdir DIR change to directory DIR\n\
231 --daemon start a server in the background\n\
232 --debug-init enable Emacs Lisp debugger for init file\n\
233 --display, -d DISPLAY use X server DISPLAY\n\
236 --no-desktop do not load a saved desktop\n\
237 --no-init-file, -q load neither ~/.emacs nor default.el\n\
238 --no-shared-memory, -nl do not use shared memory\n\
239 --no-site-file do not load site-start.el\n\
240 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
241 --no-splash do not display a splash screen on startup\n\
242 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
245 --quick, -Q equivalent to:\n\
246 -q --no-site-file --no-site-lisp --no-splash\n\
247 --script FILE run FILE as an Emacs Lisp script\n\
248 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
249 --user, -u USER load ~USER/.emacs instead of your own\n\
255 FILE visit FILE using find-file\n\
256 +LINE go to line LINE in next FILE\n\
257 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
258 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
259 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
260 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
263 --file FILE visit FILE using find-file\n\
264 --find-file FILE visit FILE using find-file\n\
265 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
266 --insert FILE insert contents of FILE into current buffer\n\
267 --kill exit without asking for confirmation\n\
268 --load, -l FILE load Emacs Lisp FILE using the load function\n\
269 --visit FILE visit FILE using find-file\n\
275 --background-color, -bg COLOR window background color\n\
276 --basic-display, -D disable many display features;\n\
277 used for debugging Emacs\n\
278 --border-color, -bd COLOR main border color\n\
279 --border-width, -bw WIDTH width of main border\n\
282 --color, --color=MODE override color mode for character terminals;\n\
283 MODE defaults to `auto', and\n\
284 can also be `never', `always',\n\
285 or a mode name like `ansi8'\n\
286 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
287 --font, -fn FONT default font; must be fixed-width\n\
288 --foreground-color, -fg COLOR window foreground color\n\
291 --fullheight, -fh make the first frame high as the screen\n\
292 --fullscreen, -fs make the first frame fullscreen\n\
293 --fullwidth, -fw make the first frame wide as the screen\n\
294 --maximized, -mm make the first frame maximized\n\
295 --geometry, -g GEOMETRY window geometry\n\
298 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
299 --iconic start Emacs in iconified state\n\
300 --internal-border, -ib WIDTH width between text and main border\n\
301 --line-spacing, -lsp PIXELS additional space to put between lines\n\
302 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
303 --name NAME title for initial Emacs frame\n\
306 --no-blinking-cursor, -nbc disable blinking cursor\n\
307 --reverse-video, -r, -rv switch foreground and background\n\
308 --title, -T TITLE title for initial Emacs frame\n\
309 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
310 --xrm XRESOURCES set additional X resources\n\
311 --parent-id XID set parent window\n\
312 --help display this help and exit\n\
313 --version output version information and exit\n\
317 You can generally also specify long option names with a single -; for\n\
318 example, -batch as well as --batch. You can use any unambiguous\n\
319 abbreviation for a --option.\n\
321 Various environment variables and window system resources also affect\n\
322 the operation of Emacs. See the main documentation.\n\
324 Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs\n\
325 section of the Emacs manual or the file BUGS.\n"
329 /* True if handling a fatal error already. */
330 bool fatal_error_in_progress
;
333 /* NS autrelease pool, for memory management. */
334 static void *ns_pool
;
339 setlocale (int cat
, char const *locale
)
346 /* Report a fatal error due to signal SIG, output a backtrace of at
347 most BACKTRACE_LIMIT lines, and exit. */
349 terminate_due_to_signal (int sig
, int backtrace_limit
)
351 signal (sig
, SIG_DFL
);
352 totally_unblock_input ();
354 /* If fatal error occurs in code below, avoid infinite recursion. */
355 if (! fatal_error_in_progress
)
357 fatal_error_in_progress
= 1;
359 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
360 Fkill_emacs (make_number (sig
));
362 shut_down_emacs (sig
, Qnil
);
363 emacs_backtrace (backtrace_limit
);
366 /* Signal the same code; this time it will really be fatal.
367 Since we're in a signal handler, the signal is blocked, so we
368 have to unblock it if we want to really receive it. */
372 sigemptyset (&unblocked
);
373 sigaddset (&unblocked
, sig
);
374 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
380 /* This shouldn't be executed, but it prevents a warning. */
384 /* Code for dealing with Lisp access to the Unix command line. */
387 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
390 Lisp_Object name
, dir
, handler
;
391 ptrdiff_t count
= SPECPDL_INDEX ();
392 Lisp_Object raw_name
;
398 /* Must use argv[0] converted to UTF-8, as it begets many standard
399 file and directory names. */
401 char argv0
[MAX_UTF8_PATH
];
403 if (filename_from_ansi (argv
[0], argv0
) == 0)
404 raw_name
= build_unibyte_string (argv0
);
406 raw_name
= build_unibyte_string (argv
[0]);
409 raw_name
= build_unibyte_string (argv
[0]);
412 /* Add /: to the front of the name
413 if it would otherwise be treated as magic. */
414 handler
= Ffind_file_name_handler (raw_name
, Qt
);
415 if (! NILP (handler
))
416 raw_name
= concat2 (build_string ("/:"), raw_name
);
418 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
419 Vinvocation_directory
= Ffile_name_directory (raw_name
);
421 /* If we got no directory in argv[0], search PATH to find where
422 Emacs actually came from. */
423 if (NILP (Vinvocation_directory
))
426 int yes
= openp (Vexec_path
, Vinvocation_name
,
427 Vexec_suffixes
, &found
, make_number (X_OK
), false);
430 /* Add /: to the front of the name
431 if it would otherwise be treated as magic. */
432 handler
= Ffind_file_name_handler (found
, Qt
);
433 if (! NILP (handler
))
434 found
= concat2 (build_string ("/:"), found
);
435 Vinvocation_directory
= Ffile_name_directory (found
);
439 if (!NILP (Vinvocation_directory
)
440 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
441 /* Emacs was started with relative path, like ./emacs.
445 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
447 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
450 Vinstallation_directory
= Qnil
;
452 if (!NILP (Vinvocation_directory
))
454 dir
= Vinvocation_directory
;
456 /* If we are running from the build directory, set DIR to the
457 src subdirectory of the Emacs tree, like on Posix
459 if (SBYTES (dir
) > sizeof ("/i386/") - 1
460 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
462 dir
= Fexpand_file_name (build_string ("../.."), dir
);
463 #else /* !WINDOWSNT */
465 name
= Fexpand_file_name (Vinvocation_name
, dir
);
468 Lisp_Object tem
, lib_src_exists
;
469 Lisp_Object etc_exists
, info_exists
;
471 /* See if dir contains subdirs for use by Emacs.
472 Check for the ones that would exist in a build directory,
473 not including lisp and info. */
474 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
475 lib_src_exists
= Ffile_exists_p (tem
);
478 /* MSDOS installations frequently remove lib-src, but we still
479 must set installation-directory, or else info won't find
480 its files (it uses the value of installation-directory). */
481 tem
= Fexpand_file_name (build_string ("info"), dir
);
482 info_exists
= Ffile_exists_p (tem
);
487 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
489 tem
= Fexpand_file_name (build_string ("etc"), dir
);
490 etc_exists
= Ffile_exists_p (tem
);
491 if (!NILP (etc_exists
))
493 Vinstallation_directory
494 = Ffile_name_as_directory (dir
);
499 /* See if dir's parent contains those subdirs. */
500 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
501 lib_src_exists
= Ffile_exists_p (tem
);
505 /* See the MSDOS commentary above. */
506 tem
= Fexpand_file_name (build_string ("../info"), dir
);
507 info_exists
= Ffile_exists_p (tem
);
512 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
514 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
515 etc_exists
= Ffile_exists_p (tem
);
516 if (!NILP (etc_exists
))
518 tem
= Fexpand_file_name (build_string (".."), dir
);
519 Vinstallation_directory
520 = Ffile_name_as_directory (tem
);
525 /* If the Emacs executable is actually a link,
526 next try the dir that the link points into. */
527 tem
= Ffile_symlink_p (name
);
530 name
= Fexpand_file_name (tem
, dir
);
531 dir
= Ffile_name_directory (name
);
538 Vcommand_line_args
= Qnil
;
540 for (i
= argc
- 1; i
>= 0; i
--)
542 if (i
== 0 || i
> skip_args
)
543 /* For the moment, we keep arguments as is in unibyte strings.
544 They are decoded in the function command-line after we know
545 locale-coding-system. */
547 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
550 unbind_to (count
, Qnil
);
553 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
554 doc
: /* Return the program name that was used to run Emacs.
555 Any directory names are omitted. */)
558 return Fcopy_sequence (Vinvocation_name
);
561 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
563 doc
: /* Return the directory name in which the Emacs executable was located. */)
566 return Fcopy_sequence (Vinvocation_directory
);
571 /* A valid but unlikely value for the TZ environment value.
572 It is OK (though a bit slower) if the user actually chooses this value. */
573 static char const dump_tz
[] = "UtC0";
576 /* Test whether the next argument in ARGV matches SSTR or a prefix of
577 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
578 (the argument is supposed to have a value) store in *VALPTR either
579 the next argument or the portion of this one after the equal sign.
580 ARGV is read starting at position *SKIPPTR; this index is advanced
581 by the number of arguments used.
583 Too bad we can't just use getopt for all of this, but we don't have
584 enough information to do it right. */
587 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
588 int minlen
, char **valptr
, int *skipptr
)
594 /* Don't access argv[argc]; give up in advance. */
595 if (argc
<= *skipptr
+ 1)
598 arg
= argv
[*skipptr
+1];
601 if (strcmp (arg
, sstr
) == 0)
605 *valptr
= argv
[*skipptr
+2];
612 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
613 ? p
- arg
: strlen (arg
));
614 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
616 else if (valptr
== NULL
)
627 else if (argv
[*skipptr
+2] != NULL
)
629 *valptr
= argv
[*skipptr
+2];
639 #ifdef DOUG_LEA_MALLOC
641 /* malloc can be invoked even before main (e.g. by the dynamic
642 linker), so the dumped malloc state must be restored as early as
643 possible using this special hook. */
646 malloc_initialize_hook (void)
650 if (!malloc_using_checking
)
651 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
652 ignored if the heap to be restored was constructed without
653 malloc checking. Can't use unsetenv, since that calls malloc. */
657 for (p
= environ
; p
&& *p
; p
++)
658 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
667 malloc_set_state (malloc_state_ptr
);
668 #ifndef XMALLOC_OVERRUN_CHECK
669 free (malloc_state_ptr
);
674 if (my_heap_start
== 0)
675 my_heap_start
= sbrk (0);
676 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
680 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
682 #endif /* DOUG_LEA_MALLOC */
684 /* Close standard output and standard error, reporting any write
685 errors as best we can. This is intended for use with atexit. */
687 close_output_streams (void)
689 if (close_stream (stdout
) != 0)
691 emacs_perror ("Write error to standard output");
692 _exit (EXIT_FAILURE
);
695 if (close_stream (stderr
) != 0)
696 _exit (EXIT_FAILURE
);
701 main (int argc
, char **argv
)
706 char stack_bottom_variable
;
707 bool do_initial_setlocale
;
710 #ifdef HAVE_SETRLIMIT
716 #ifdef DAEMON_MUST_EXEC
721 /* If we use --chdir, this records the original directory. */
722 char *original_pwd
= 0;
728 #ifdef G_SLICE_ALWAYS_MALLOC
729 /* This is used by the Cygwin build. It's not needed starting with
730 cygwin-1.7.24, but it doesn't do any harm. */
731 xputenv ("G_SLICE=always-malloc");
737 extern char my_endbss
[];
738 extern char *my_endbss_static
;
740 if (my_heap_start
== 0)
741 my_heap_start
= sbrk (0);
743 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
747 #if defined WINDOWSNT || defined HAVE_NTGUI
748 /* Set global variables used to detect Windows version. Do this as
749 early as possible. (unexw32.c calls this function as well, but
750 the additional call here is harmless.) */
751 cache_system_info ();
754 #ifdef RUN_TIME_REMAP
756 run_time_remap (argv
[0]);
759 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
762 unexec_init_emacs_zone ();
765 atexit (close_output_streams
);
767 sort_args (argc
, argv
);
769 while (argv
[argc
]) argc
++;
771 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
773 const char *version
, *copyright
;
776 Lisp_Object tem
, tem2
;
777 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
778 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
781 fprintf (stderr
, "Invalid value of `emacs-version'\n");
786 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
791 version
= SSDATA (tem
);
792 copyright
= SSDATA (tem2
);
797 version
= emacs_version
;
798 copyright
= emacs_copyright
;
800 printf ("GNU Emacs %s\n", version
);
801 printf ("%s\n", copyright
);
802 printf ("GNU Emacs comes with ABSOLUTELY NO WARRANTY.\n");
803 printf ("You may redistribute copies of Emacs\n");
804 printf ("under the terms of the GNU General Public License.\n");
805 printf ("For more information about these matters, ");
806 printf ("see the file named COPYING.\n");
810 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
813 /* argv[] array is kept in its original ANSI codepage encoding,
814 we need to convert to UTF-8, for chdir to work. */
815 char newdir
[MAX_UTF8_PATH
];
817 filename_from_ansi (ch_to_dir
, newdir
);
820 original_pwd
= get_current_dir_name ();
821 if (chdir (ch_to_dir
) != 0)
823 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
824 argv
[0], ch_to_dir
, strerror (errno
));
829 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
830 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
832 #ifdef HAVE_PERSONALITY_LINUX32
833 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
835 /* Set this so we only do this once. */
836 xputenv ("EMACS_HEAP_EXEC=true");
838 /* A flag to turn off address randomization which is introduced
839 in linux kernel shipped with fedora core 4 */
840 #define ADD_NO_RANDOMIZE 0x0040000
841 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
842 #undef ADD_NO_RANDOMIZE
844 execvp (argv
[0], argv
);
846 /* If the exec fails, try to dump anyway. */
847 emacs_perror (argv
[0]);
849 #endif /* HAVE_PERSONALITY_LINUX32 */
851 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
852 /* Extend the stack space available.
853 Don't do that if dumping, since some systems (e.g. DJGPP)
854 might define a smaller stack limit at that time. */
857 && (!noninteractive
|| initialized
)
859 && !getrlimit (RLIMIT_STACK
, &rlim
))
862 extern size_t re_max_failures
;
863 /* Approximate the amount regex.c needs per unit of re_max_failures. */
864 int ratio
= 20 * sizeof (char *);
865 /* Then add 33% to cover the size of the smaller stacks that regex.c
866 successively allocates and discards, on its way to the maximum. */
868 /* Add in some extra to cover
869 what we're likely to use for other reasons. */
870 newlim
= re_max_failures
* ratio
+ 200000;
872 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
873 stack allocation routine for new process that the allocation
874 fails if stack limit is not on page boundary. So, round up the
875 new limit to page boundary. */
876 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
878 if (newlim
> rlim
.rlim_max
)
880 newlim
= rlim
.rlim_max
;
881 /* Don't let regex.c overflow the stack we have. */
882 re_max_failures
= (newlim
- 200000) / ratio
;
884 if (rlim
.rlim_cur
< newlim
)
885 rlim
.rlim_cur
= newlim
;
887 setrlimit (RLIMIT_STACK
, &rlim
);
889 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
891 /* Record (approximately) where the stack begins. */
892 stack_bottom
= &stack_bottom_variable
;
896 #ifndef SYSTEM_MALLOC
897 /* Arrange to get warning messages as memory fills up. */
898 memory_warnings (0, malloc_warning
);
900 /* Call malloc at least once, to run malloc_initialize_hook.
901 Also call realloc and free for consistency. */
902 free (realloc (malloc (4), 4));
904 #endif /* not SYSTEM_MALLOC */
906 #if defined (MSDOS) || defined (WINDOWSNT)
907 /* We do all file input/output as binary files. When we need to translate
908 newlines, we do that manually. */
910 #endif /* MSDOS || WINDOWSNT */
913 if (!isatty (fileno (stdin
)))
914 setmode (fileno (stdin
), O_BINARY
);
915 if (!isatty (fileno (stdout
)))
918 setmode (fileno (stdout
), O_BINARY
);
922 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
923 The build procedure uses this while dumping, to ensure that the
924 dumped Emacs does not have its system locale tables initialized,
925 as that might cause screwups when the dumped Emacs starts up. */
927 char *lc_all
= getenv ("LC_ALL");
928 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
931 /* Set locale now, so that initial error messages are localized properly.
932 fixup_locale must wait until later, since it builds strings. */
933 if (do_initial_setlocale
)
934 setlocale (LC_ALL
, "");
936 inhibit_window_system
= 0;
938 /* Handle the -t switch, which specifies filename to use as terminal. */
942 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
947 result
= emacs_open (term
, O_RDWR
, 0);
948 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
950 char *errstring
= strerror (errno
);
951 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
956 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
959 fprintf (stderr
, "Using %s\n", term
);
960 #ifdef HAVE_WINDOW_SYSTEM
961 inhibit_window_system
= 1; /* -t => -nw */
968 /* Command line option --no-windows is deprecated and thus not mentioned
969 in the manual and usage information. */
970 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
971 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
972 inhibit_window_system
= 1;
974 /* Handle the -batch switch, which means don't do interactive display. */
976 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
979 Vundo_outer_limit
= Qnil
;
981 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
983 noninteractive
= 1; /* Set batch mode. */
984 /* Convert --script to -scriptload, un-skip it, and sort again
985 so that it will be handled in proper sequence. */
986 /* FIXME broken for --script=FILE - is that supposed to work? */
987 argv
[skip_args
- 1] = (char *) "-scriptload";
989 sort_args (argc
, argv
);
992 /* Handle the --help option, which gives a usage message. */
993 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
996 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
997 for (i
= 0; i
< sizeof usage_message
/ sizeof *usage_message
; i
++)
998 fputs (usage_message
[i
], stdout
);
1002 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1003 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1008 /* Start as a daemon: fork a new child process which will run the
1009 rest of the initialization code, then exit.
1011 Detaching a daemon requires the following steps:
1015 - close the tty file-descriptors
1017 We only want to do the last 2 steps once the daemon is ready to
1018 serve requests, i.e. after loading .emacs (initialization).
1019 OTOH initialization may start subprocesses (e.g. ispell) and these
1020 should be run from the proper process (the one that will end up
1021 running as daemon) and with the proper "session id" in order for
1022 them to keep working after detaching, so fork and setsid need to be
1023 performed before initialization.
1025 We want to avoid exiting before the server socket is ready, so
1026 use a pipe for synchronization. The parent waits for the child
1027 to close its end of the pipe (using `daemon-initialized')
1029 if (emacs_pipe (daemon_pipe
) != 0)
1031 fprintf (stderr
, "Cannot pipe!\n");
1035 #ifndef DAEMON_MUST_EXEC
1037 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1038 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1039 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1040 #endif /* USE_GTK */
1042 #else /* DAEMON_MUST_EXEC */
1043 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1044 f
= fork (); /* in orig */
1046 f
= 0; /* in exec'd */
1047 #endif /* !DAEMON_MUST_EXEC */
1053 /* Close unused writing end of the pipe. */
1054 emacs_close (daemon_pipe
[1]);
1056 /* Just wait for the child to close its end of the pipe. */
1059 retval
= read (daemon_pipe
[0], &buf
, 1);
1061 while (retval
== -1 && errno
== EINTR
);
1065 fprintf (stderr
, "Error reading status from child\n");
1068 else if (retval
== 0)
1070 fprintf (stderr
, "Error: server did not start correctly\n");
1074 emacs_close (daemon_pipe
[0]);
1079 emacs_perror ("fork");
1080 exit (EXIT_CANCELED
);
1083 #ifdef DAEMON_MUST_EXEC
1085 /* In orig process, forked as child, OR in exec'd. */
1086 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1087 { /* In orig, child: now exec w/special daemon name. */
1090 snprintf (fdStr
, sizeof fdStr
,
1091 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1092 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1094 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1096 fprintf (stderr
, "daemon: child name too long\n");
1097 exit (EXIT_CANNOT_INVOKE
);
1100 argv
[skip_args
] = fdStr
;
1102 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1103 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1104 execvp (argv
[0], argv
);
1105 emacs_perror (argv
[0]);
1106 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1109 /* In exec'd: parse special dname into pipe and name info. */
1110 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1111 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1113 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1114 exit (EXIT_CANNOT_INVOKE
);
1116 dname_arg2
[0] = '\0';
1117 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1119 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1120 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1122 #endif /* DAEMON_MUST_EXEC */
1125 daemon_name
= xstrdup (dname_arg
);
1126 /* Close unused reading end of the pipe. */
1127 emacs_close (daemon_pipe
[0]);
1131 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1136 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC && !defined DOUG_LEA_MALLOC
1137 # ifndef CANNOT_DUMP
1138 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1139 that causes an infinite recursive loop with FreeBSD. But do make
1140 it thread-safe when creating emacs, otherwise bootstrap-emacs
1141 fails on Cygwin. See Bug#14569. */
1142 if (!noninteractive
|| initialized
)
1144 malloc_enable_thread ();
1147 init_signals (dumping
);
1149 noninteractive1
= noninteractive
;
1151 /* Perform basic initializations (not merely interning symbols). */
1158 init_charset_once ();
1159 init_coding_once ();
1160 init_syntax_once (); /* Create standard syntax table. */
1161 init_category_once (); /* Create standard category table. */
1162 init_casetab_once (); /* Must be done before init_buffer_once. */
1163 init_buffer_once (); /* Create buffer table and some buffers. */
1164 init_minibuf_once (); /* Create list of minibuffers. */
1165 /* Must precede init_window_once. */
1167 /* Call syms_of_xfaces before init_window_once because that
1168 function creates Vterminal_frame. Termcap frames now use
1169 faces, and the face implementation uses some symbols as
1172 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1173 be better to arrange things not to have this dependency. */
1175 /* Call syms_of_keyboard before init_window_once because
1176 keyboard sets up symbols that include some face names that
1177 the X support will want to use. This can happen when
1178 CANNOT_DUMP is defined. */
1179 syms_of_keyboard ();
1181 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1183 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1185 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1187 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1189 /* Before syms_of_coding because it initializes Qcharsetp. */
1191 /* Before init_window_once, because it sets up the
1192 Vcoding_system_hash_table. */
1193 syms_of_coding (); /* This should be after syms_of_fileio. */
1195 init_window_once (); /* Init the window system. */
1196 #ifdef HAVE_WINDOW_SYSTEM
1197 init_fringe_once (); /* Swap bitmaps if necessary. */
1198 #endif /* HAVE_WINDOW_SYSTEM */
1203 if (do_initial_setlocale
)
1206 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1207 Vsystem_time_locale
= Vprevious_system_time_locale
;
1212 running_asynch_code
= 0;
1216 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1219 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1222 ns_pool
= ns_alloc_autorelease_pool ();
1223 #ifdef NS_IMPL_GNUSTEP
1224 /* GNUStep stupidly resets our locale settings after we made them. */
1228 if (!noninteractive
)
1230 #ifdef NS_IMPL_COCOA
1231 /* Started from GUI? */
1232 /* FIXME: Do the right thing if getenv returns NULL, or if
1234 if (! inhibit_window_system
&& ! isatty (0))
1235 chdir (getenv ("HOME"));
1236 if (skip_args
< argc
)
1238 if (!strncmp (argv
[skip_args
], "-psn", 4))
1241 chdir (getenv ("HOME"));
1243 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1246 chdir (getenv ("HOME"));
1251 #endif /* HAVE_NS */
1253 #ifdef HAVE_X_WINDOWS
1254 /* Stupid kludge to catch command-line display spec. We can't
1255 handle this argument entirely in window system dependent code
1256 because we don't even know which window system dependent code
1257 to run until we've recognized this argument. */
1259 char *displayname
= 0;
1260 int count_before
= skip_args
;
1262 /* Skip any number of -d options, but only use the last one. */
1265 int count_before_this
= skip_args
;
1267 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1269 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1274 count_before
= count_before_this
;
1277 /* If we have the form --display=NAME,
1278 convert it into -d name.
1279 This requires inserting a new element into argv. */
1280 if (displayname
&& count_before
< skip_args
)
1282 if (skip_args
== count_before
+ 1)
1284 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1285 (argc
- (count_before
+ 2)) * sizeof *argv
);
1286 argv
[count_before
+ 2] = displayname
;
1289 argv
[count_before
+ 1] = (char *) "-d";
1294 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1295 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1299 /* Don't actually discard this arg. */
1300 skip_args
= count_before
;
1302 #else /* !HAVE_X_WINDOWS */
1305 int count_before
= skip_args
;
1307 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1308 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1311 skip_args
= count_before
;
1315 /* argmatch must not be used after here,
1316 except when building temacs
1317 because the -d argument has not been skipped in skip_args. */
1320 /* Call early 'cause init_environment needs it. */
1322 /* Set defaults for several environment variables. */
1324 init_environment (argc
, argv
, skip_args
);
1329 #ifdef HAVE_GFILENOTIFY
1330 globals_of_gfilenotify ();
1335 #ifdef HAVE_W32NOTIFY
1336 globals_of_w32notify ();
1338 /* Initialize environment from registry settings. */
1339 init_environment (argv
);
1340 init_ntproc (dumping
); /* must precede init_editfns. */
1343 /* Initialize and GC-protect Vinitial_environment and
1344 Vprocess_environment before set_initial_environment fills them
1347 syms_of_callproc ();
1348 /* egetenv is a pretty low-level facility, which may get called in
1349 many circumstances; it seems flimsy to put off initializing it
1350 until calling init_callproc. Do not do it when dumping. */
1352 set_initial_environment ();
1354 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1355 if this is not done. Do it after set_global_environment so that we
1356 don't pollute Vglobal_environment. */
1357 /* Setting LANG here will defeat the startup locale processing... */
1362 init_buffer (); /* Init default directory of main buffer. */
1364 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1366 /* Must precede init_lread. */
1367 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1371 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1372 Lisp_Object old_log_max
;
1373 old_log_max
= Vmessage_log_max
;
1374 XSETFASTINT (Vmessage_log_max
, 0);
1375 message_dolog ("", 0, 1, 0);
1376 Vmessage_log_max
= old_log_max
;
1379 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1383 /* Check to see if Emacs has been installed correctly. */
1384 check_windows_init_file ();
1387 /* Intern the names of all standard functions and variables;
1388 define standard keys. */
1392 /* The basic levels of Lisp must come first. Note that
1393 syms_of_data and some others have already been called. */
1398 syms_of_floatfns ();
1401 syms_of_bytecode ();
1403 syms_of_casefiddle ();
1405 syms_of_category ();
1407 syms_of_character ();
1414 syms_of_filelock ();
1417 /* syms_of_keymap (); */
1425 syms_of_terminal ();
1431 syms_of_textprop ();
1432 syms_of_composite ();
1435 #endif /* WINDOWSNT */
1442 #ifdef HAVE_WINDOW_SYSTEM
1445 #endif /* HAVE_WINDOW_SYSTEM */
1446 #ifdef HAVE_X_WINDOWS
1451 syms_of_xsettings ();
1458 #endif /* HAVE_X_WINDOWS */
1465 syms_of_decompress ();
1475 #endif /* HAVE_NTGUI */
1477 #if defined WINDOWSNT || defined HAVE_NTGUI
1478 syms_of_w32select ();
1485 syms_of_win16select ();
1492 syms_of_nsselect ();
1494 #endif /* HAVE_NS */
1500 #ifdef HAVE_GFILENOTIFY
1501 syms_of_gfilenotify ();
1502 #endif /* HAVE_GFILENOTIFY */
1506 #endif /* HAVE_INOTIFY */
1509 syms_of_dbusbind ();
1510 #endif /* HAVE_DBUS */
1514 #ifdef HAVE_W32NOTIFY
1515 syms_of_w32notify ();
1516 #endif /* HAVE_W32NOTIFY */
1517 #endif /* WINDOWSNT */
1519 syms_of_profiler ();
1521 keys_of_casefiddle ();
1524 keys_of_keyboard ();
1530 /* Initialization that must be done even if the global variable
1531 initialized is non zero. */
1533 globals_of_w32font ();
1534 globals_of_w32fns ();
1535 globals_of_w32menu ();
1536 #endif /* HAVE_NTGUI */
1538 #if defined WINDOWSNT || defined HAVE_NTGUI
1539 globals_of_w32select ();
1545 init_editfns (); /* init_process_emacs uses Voperating_system_release. */
1546 init_process_emacs (); /* init_display uses add_keyboard_wait_descriptor. */
1547 init_keyboard (); /* This too must precede init_sys_modes. */
1548 if (!noninteractive
)
1549 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1552 init_crit (); /* w32notify.c needs this in batch mode. */
1553 #endif /* HAVE_W32NOTIFY */
1555 #ifdef HAVE_WINDOW_SYSTEM
1557 #endif /* HAVE_WINDOW_SYSTEM */
1565 /* Handle -l loadup, args passed by Makefile. */
1566 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1569 char file_utf8
[MAX_UTF8_PATH
];
1571 if (filename_from_ansi (file
, file_utf8
) == 0)
1574 Vtop_level
= list2 (intern_c_string ("load"),
1575 build_unibyte_string (file
));
1577 /* Unless next switch is -nl, load "loadup.el" first thing. */
1579 Vtop_level
= list2 (intern_c_string ("load"),
1580 build_string ("loadup.el"));
1587 /* If the execution TZ happens to be the same as the dump TZ,
1588 change it to some other value and then change it back,
1589 to force the underlying implementation to reload the TZ info.
1590 This is needed on implementations that load TZ info from files,
1591 since the TZ file contents may differ between dump and execution. */
1592 char *tz
= getenv ("TZ");
1593 if (tz
&& !strcmp (tz
, dump_tz
))
1603 /* Set up for profiling. This is known to work on FreeBSD,
1604 GNU/Linux and MinGW. It might work on some other systems too.
1605 Give it a try and tell us if it works on your system. To compile
1606 for profiling, use the configure option --enable-profiling. */
1607 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1612 extern unsigned char etext
asm ("etext");
1618 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1627 #ifdef LOCALTIME_CACHE
1628 /* Some versions of localtime have a bug. They cache the value of the time
1629 zone rather than looking it up every time. Since localtime() is
1630 called to bolt the undumping time into the undumped emacs, this
1631 results in localtime ignoring the TZ environment variable.
1632 This flushes the new TZ value into localtime. */
1634 #endif /* defined (LOCALTIME_CACHE) */
1636 /* Enter editor command loop. This never returns. */
1642 /* Sort the args so we can find the most important ones
1643 at the beginning of argv. */
1645 /* First, here's a table of all the standard options. */
1647 struct standard_args
1650 const char *longname
;
1655 static const struct standard_args standard_args
[] =
1657 { "-version", "--version", 150, 0 },
1658 { "-chdir", "--chdir", 130, 1 },
1659 { "-t", "--terminal", 120, 1 },
1660 { "-nw", "--no-window-system", 110, 0 },
1661 { "-nw", "--no-windows", 110, 0 },
1662 { "-batch", "--batch", 100, 0 },
1663 { "-script", "--script", 100, 1 },
1664 { "-daemon", "--daemon", 99, 0 },
1665 { "-help", "--help", 90, 0 },
1666 { "-nl", "--no-loadup", 70, 0 },
1667 { "-nsl", "--no-site-lisp", 65, 0 },
1668 /* -d must come last before the options handled in startup.el. */
1669 { "-d", "--display", 60, 1 },
1670 { "-display", 0, 60, 1 },
1671 /* Now for the options handled in `command-line' (startup.el). */
1672 /* (Note that to imply -nsl, -Q is partially handled here.) */
1673 { "-Q", "--quick", 55, 0 },
1674 { "-quick", 0, 55, 0 },
1675 { "-q", "--no-init-file", 50, 0 },
1676 { "-no-init-file", 0, 50, 0 },
1677 { "-no-site-file", "--no-site-file", 40, 0 },
1678 { "-u", "--user", 30, 1 },
1679 { "-user", 0, 30, 1 },
1680 { "-debug-init", "--debug-init", 20, 0 },
1681 { "-iconic", "--iconic", 15, 0 },
1682 { "-D", "--basic-display", 12, 0},
1683 { "-basic-display", 0, 12, 0},
1684 { "-nbc", "--no-blinking-cursor", 12, 0 },
1685 /* Now for the options handled in `command-line-1' (startup.el). */
1686 { "-nbi", "--no-bitmap-icon", 10, 0 },
1687 { "-bg", "--background-color", 10, 1 },
1688 { "-background", 0, 10, 1 },
1689 { "-fg", "--foreground-color", 10, 1 },
1690 { "-foreground", 0, 10, 1 },
1691 { "-bd", "--border-color", 10, 1 },
1692 { "-bw", "--border-width", 10, 1 },
1693 { "-ib", "--internal-border", 10, 1 },
1694 { "-ms", "--mouse-color", 10, 1 },
1695 { "-cr", "--cursor-color", 10, 1 },
1696 { "-fn", "--font", 10, 1 },
1697 { "-font", 0, 10, 1 },
1698 { "-fs", "--fullscreen", 10, 0 },
1699 { "-fw", "--fullwidth", 10, 0 },
1700 { "-fh", "--fullheight", 10, 0 },
1701 { "-mm", "--maximized", 10, 0 },
1702 { "-g", "--geometry", 10, 1 },
1703 { "-geometry", 0, 10, 1 },
1704 { "-T", "--title", 10, 1 },
1705 { "-title", 0, 10, 1 },
1706 { "-name", "--name", 10, 1 },
1707 { "-xrm", "--xrm", 10, 1 },
1708 { "-parent-id", "--parent-id", 10, 1 },
1709 { "-r", "--reverse-video", 5, 0 },
1711 { "-reverse", 0, 5, 0 },
1712 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1713 { "-vb", "--vertical-scroll-bars", 5, 0 },
1714 { "-color", "--color", 5, 0},
1715 { "-no-splash", "--no-splash", 3, 0 },
1716 { "-no-desktop", "--no-desktop", 3, 0 },
1718 { "-NSAutoLaunch", 0, 5, 1 },
1719 { "-NXAutoLaunch", 0, 5, 1 },
1720 { "-_NSMachLaunch", 0, 85, 1 },
1721 { "-MachLaunch", 0, 85, 1 },
1722 { "-macosx", 0, 85, 0 },
1723 { "-NSHost", 0, 85, 1 },
1725 /* These have the same priority as ordinary file name args,
1726 so they are not reordered with respect to those. */
1727 { "-L", "--directory", 0, 1 },
1728 { "-directory", 0, 0, 1 },
1729 { "-l", "--load", 0, 1 },
1730 { "-load", 0, 0, 1 },
1731 /* This has no longname, because using --scriptload confuses sort_args,
1732 because then the --script long option seems to match twice; ie
1733 you can't have a long option which is a prefix of another long
1734 option. In any case, this is entirely an internal option. */
1735 { "-scriptload", NULL
, 0, 1 },
1736 { "-f", "--funcall", 0, 1 },
1737 { "-funcall", 0, 0, 1 },
1738 { "-eval", "--eval", 0, 1 },
1739 { "-execute", "--execute", 0, 1 },
1740 { "-find-file", "--find-file", 0, 1 },
1741 { "-visit", "--visit", 0, 1 },
1742 { "-file", "--file", 0, 1 },
1743 { "-insert", "--insert", 0, 1 },
1745 { "-NXOpen", 0, 0, 1 },
1746 { "-NXOpenTemp", 0, 0, 1 },
1747 { "-NSOpen", 0, 0, 1 },
1748 { "-NSOpenTemp", 0, 0, 1 },
1749 { "-GSFilePath", 0, 0, 1 },
1751 /* This should be processed after ordinary file name args and the like. */
1752 { "-kill", "--kill", -10, 0 },
1755 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1756 so that the highest priority ones come first.
1757 Do not change the order of elements of equal priority.
1758 If an option takes an argument, keep it and its argument together.
1760 If an option that takes no argument appears more
1761 than once, eliminate all but one copy of it. */
1764 sort_args (int argc
, char **argv
)
1766 char **new = xmalloc (argc
* sizeof *new);
1767 /* For each element of argv,
1768 the corresponding element of options is:
1769 0 for an option that takes no arguments,
1770 1 for an option that takes one argument, etc.
1771 -1 for an ordinary non-option argument. */
1772 int *options
= xnmalloc (argc
, sizeof *options
);
1773 int *priority
= xnmalloc (argc
, sizeof *priority
);
1775 int incoming_used
= 1;
1779 /* Categorize all the options,
1780 and figure out which argv elts are option arguments. */
1781 for (from
= 1; from
< argc
; from
++)
1785 if (argv
[from
][0] == '-')
1789 /* If we have found "--", don't consider
1790 any more arguments as options. */
1791 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1793 /* Leave the "--", and everything following it, at the end. */
1794 for (; from
< argc
; from
++)
1796 priority
[from
] = -100;
1802 /* Look for a match with a known old-fashioned option. */
1803 for (i
= 0; i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1804 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1806 options
[from
] = standard_args
[i
].nargs
;
1807 priority
[from
] = standard_args
[i
].priority
;
1808 if (from
+ standard_args
[i
].nargs
>= argc
)
1809 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1810 from
+= standard_args
[i
].nargs
;
1814 /* Look for a match with a known long option.
1815 MATCH is -1 if no match so far, -2 if two or more matches so far,
1816 >= 0 (the table index of the match) if just one match so far. */
1817 if (argv
[from
][1] == '-')
1819 char const *equals
= strchr (argv
[from
], '=');
1821 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1826 i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1827 if (standard_args
[i
].longname
1828 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1837 /* If we found exactly one match, use that. */
1840 options
[from
] = standard_args
[match
].nargs
;
1841 priority
[from
] = standard_args
[match
].priority
;
1842 /* If --OPTION=VALUE syntax is used,
1843 this option uses just one argv element. */
1846 if (from
+ options
[from
] >= argc
)
1847 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1848 from
+= options
[from
];
1850 /* FIXME When match < 0, shouldn't there be some error,
1851 or at least indication to the user that there was a
1858 /* Copy the arguments, in order of decreasing priority, to NEW. */
1860 while (incoming_used
< argc
)
1863 int best_priority
= -9999;
1865 /* Find the highest priority remaining option.
1866 If several have equal priority, take the first of them. */
1867 for (from
= 1; from
< argc
; from
++)
1869 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1871 best_priority
= priority
[from
];
1874 /* Skip option arguments--they are tied to the options. */
1875 if (options
[from
] > 0)
1876 from
+= options
[from
];
1882 /* Copy the highest priority remaining option, with its args, to NEW.
1883 Unless it is a duplicate of the previous one. */
1884 if (! (options
[best
] == 0
1885 && ! strcmp (new[to
- 1], argv
[best
])))
1887 new[to
++] = argv
[best
];
1888 for (i
= 0; i
< options
[best
]; i
++)
1889 new[to
++] = argv
[best
+ i
+ 1];
1892 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1894 /* Clear out this option in ARGV. */
1896 for (i
= 0; i
< options
[best
]; i
++)
1897 argv
[best
+ i
+ 1] = 0;
1900 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1904 memcpy (argv
, new, sizeof (char *) * argc
);
1911 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1912 doc
: /* Exit the Emacs job and kill it.
1913 If ARG is an integer, return ARG as the exit program code.
1914 If ARG is a string, stuff it as keyboard input.
1916 This function is called upon receipt of the signals SIGTERM
1917 or SIGHUP, and upon SIGINT in batch mode.
1919 The value of `kill-emacs-hook', if not void,
1920 is a list of functions (of no args),
1921 all of which are called before Emacs is actually killed. */)
1924 struct gcpro gcpro1
;
1932 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1934 waiting_for_input
= 0;
1935 Frun_hooks (1, &Qkill_emacs_hook
);
1938 #ifdef HAVE_X_WINDOWS
1939 /* Transfer any clipboards we own to the clipboard manager. */
1940 x_clipboard_manager_save_all ();
1943 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1946 ns_release_autorelease_pool (ns_pool
);
1949 /* If we have an auto-save list file,
1950 kill it because we are exiting Emacs deliberately (not crashing).
1951 Do it after shut_down_emacs, which does an auto-save. */
1952 if (STRINGP (Vauto_save_list_file_name
))
1954 Lisp_Object listfile
;
1955 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1956 unlink (SSDATA (listfile
));
1960 exit_code
= (XINT (arg
) < 0
1961 ? XINT (arg
) | INT_MIN
1962 : XINT (arg
) & INT_MAX
);
1964 exit_code
= EXIT_SUCCESS
;
1969 /* Perform an orderly shutdown of Emacs. Autosave any modified
1970 buffers, kill any child processes, clean up the terminal modes (if
1971 we're in the foreground), and other stuff like that. Don't perform
1972 any redisplay; this may be called when Emacs is shutting down in
1973 the background, or after its X connection has died.
1975 If SIG is a signal number, print a message for it.
1977 This is called by fatal signal handlers, X protocol error handlers,
1981 shut_down_emacs (int sig
, Lisp_Object stuff
)
1983 /* Prevent running of hooks from now on. */
1986 /* Don't update display from now on. */
1987 Vinhibit_redisplay
= Qt
;
1989 /* If we are controlling the terminal, reset terminal modes. */
1992 pid_t pgrp
= getpgrp ();
1993 pid_t tpgrp
= tcgetpgrp (0);
1994 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1996 reset_all_sys_modes ();
1997 if (sig
&& sig
!= SIGTERM
)
1999 static char const format
[] = "Fatal error %d: ";
2000 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2001 int buflen
= sprintf (buf
, format
, sig
);
2002 char const *sig_desc
= safe_strsignal (sig
);
2003 emacs_write (STDERR_FILENO
, buf
, buflen
);
2004 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2010 reset_all_sys_modes ();
2013 stuff_buffered_input (stuff
);
2015 inhibit_sentinels
= 1;
2016 kill_buffer_processes (Qnil
);
2017 Fdo_auto_save (Qt
, Qnil
);
2019 #ifdef CLASH_DETECTION
2020 unlock_all_files ();
2023 /* There is a tendency for a SIGIO signal to arrive within exit,
2024 and cause a SIGHUP because the input descriptor is already closed. */
2028 /* Do this only if terminating normally, we want glyph matrices
2029 etc. in a core dump. */
2030 if (sig
== 0 || sig
== SIGTERM
)
2032 check_glyph_memory ();
2033 check_message_stack ();
2041 ns_term_shutdown (sig
);
2045 xml_cleanup_parser ();
2059 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2060 doc
: /* Dump current state of Emacs into executable file FILENAME.
2061 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2062 This is used in the file `loadup.el' when building Emacs.
2064 You must run Emacs in batch mode in order to dump it. */)
2065 (Lisp_Object filename
, Lisp_Object symfile
)
2069 ptrdiff_t count
= SPECPDL_INDEX ();
2073 if (! noninteractive
)
2074 error ("Dumping Emacs works only in batch mode");
2078 /* Warn if the gap between BSS end and heap start is larger than this. */
2079 # define MAX_HEAP_BSS_DIFF (1024*1024)
2081 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2083 fprintf (stderr
, "**************************************************\n");
2084 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2085 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2087 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2088 fprintf (stderr
, "fail because of this. See the section about\n");
2089 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2090 fprintf (stderr
, "**************************************************\n");
2092 #endif /* GNU_LINUX */
2094 /* Bind `command-line-processed' to nil before dumping,
2095 so that the dumped Emacs will process its command line
2096 and set up to work with X windows if appropriate. */
2097 symbol
= intern ("command-line-processed");
2098 specbind (symbol
, Qnil
);
2100 CHECK_STRING (filename
);
2101 filename
= Fexpand_file_name (filename
, Qnil
);
2102 filename
= ENCODE_FILE (filename
);
2103 if (!NILP (symfile
))
2105 CHECK_STRING (symfile
);
2106 if (SCHARS (symfile
))
2108 symfile
= Fexpand_file_name (symfile
, Qnil
);
2109 symfile
= ENCODE_FILE (symfile
);
2114 Vpurify_flag
= Qnil
;
2117 set_time_zone_rule (dump_tz
);
2118 #ifndef LOCALTIME_CACHE
2119 /* Force a tz reload, since set_time_zone_rule doesn't. */
2125 /* Tell malloc where start of impure now is. */
2126 /* Also arrange for warnings when nearly out of space. */
2127 #ifndef SYSTEM_MALLOC
2129 /* On Windows, this was done before dumping, and that once suffices.
2130 Meanwhile, my_edata is not valid on Windows. */
2132 extern char my_edata
[];
2133 memory_warnings (my_edata
, malloc_warning
);
2135 #endif /* not WINDOWSNT */
2136 #endif /* not SYSTEM_MALLOC */
2137 #ifdef DOUG_LEA_MALLOC
2138 malloc_state_ptr
= malloc_get_state ();
2141 #ifdef USE_MMAP_FOR_BUFFERS
2144 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2145 #ifdef USE_MMAP_FOR_BUFFERS
2148 #ifdef DOUG_LEA_MALLOC
2149 free (malloc_state_ptr
);
2153 Vlibrary_cache
= Qnil
;
2155 #ifdef HAVE_WINDOW_SYSTEM
2156 reset_image_types ();
2161 return unbind_to (count
, Qnil
);
2164 #endif /* not CANNOT_DUMP */
2167 /* Recover from setlocale (LC_ALL, ""). */
2171 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2172 so that numbers are read and printed properly for Emacs Lisp. */
2173 setlocale (LC_NUMERIC
, "C");
2176 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2179 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2181 if (! EQ (*plocale
, desired_locale
))
2183 *plocale
= desired_locale
;
2184 setlocale (category
, (STRINGP (desired_locale
)
2185 ? SSDATA (desired_locale
)
2190 /* Set system time locale to match Vsystem_time_locale, if possible. */
2192 synchronize_system_time_locale (void)
2194 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2195 Vsystem_time_locale
);
2198 /* Set system messages locale to match Vsystem_messages_locale, if
2201 synchronize_system_messages_locale (void)
2204 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2205 Vsystem_messages_locale
);
2208 #endif /* HAVE_SETLOCALE */
2212 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2214 const char *path
, *p
;
2215 Lisp_Object lpath
, element
, tem
;
2216 /* Default is to use "." for empty path elements.
2217 But if argument EMPTY is true, use nil instead. */
2218 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2221 static const char *emacs_dir_env
= "%emacs_dir%/";
2222 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2223 const char *edir
= egetenv ("emacs_dir");
2224 char emacs_dir
[MAX_UTF8_PATH
];
2226 /* egetenv looks in process-environment, which holds the variables
2227 in their original system-locale encoding. We need emacs_dir to
2230 filename_from_ansi (edir
, emacs_dir
);
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. */
2254 char *path_utf8
, *q
, *d
;
2257 /* Convert each element of PATH to UTF-8. */
2258 p
= path_copy
= alloca (strlen (path
) + 1);
2259 strcpy (path_copy
, path
);
2260 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2263 q
= _mbschr (p
, SEPCHAR
);
2266 cnv_result
= filename_from_ansi (p
, d
);
2271 /* If conversion of this PATH elements fails, make sure
2272 destination pointer will stay put, thus effectively
2273 ignoring the offending element. */
2274 if (cnv_result
== 0)
2280 else if (cnv_result
!= 0 && d
> path_utf8
)
2281 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2283 path_copy
= path_utf8
;
2285 path_copy
= alloca (strlen (path
) + 1);
2286 strcpy (path_copy
, path
);
2288 dostounix_filename (path_copy
);
2295 p
= strchr (path
, SEPCHAR
);
2297 p
= path
+ strlen (path
);
2298 element
= (p
- path
? make_unibyte_string (path
, p
- path
)
2300 if (! NILP (element
))
2303 /* Relative file names in the default path are interpreted as
2304 being relative to $emacs_dir. */
2305 if (edir
&& defaulted
2306 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2307 element
= Fexpand_file_name (Fsubstring
2309 make_number (emacs_dir_len
),
2311 build_unibyte_string (emacs_dir
));
2314 /* Add /: to the front of the name
2315 if it would otherwise be treated as magic. */
2316 tem
= Ffind_file_name_handler (element
, Qt
);
2318 /* However, if the handler says "I'm safe",
2319 don't bother adding /:. */
2323 prop
= Fget (tem
, intern ("safe-magic"));
2329 element
= concat2 (build_string ("/:"), element
);
2330 } /* !NILP (element) */
2332 lpath
= Fcons (element
, lpath
);
2338 return Fnreverse (lpath
);
2341 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2342 doc
: /* Return non-nil if the current emacs process is a daemon.
2343 If the daemon was given a name argument, return that name. */)
2348 return build_string (daemon_name
);
2355 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2356 doc
: /* Mark the Emacs daemon as being initialized.
2357 This finishes the daemonization process by doing the other half of detaching
2358 from the parent process and its tty file descriptors. */)
2365 error ("This function can only be called if emacs is run as a daemon");
2367 if (daemon_pipe
[1] < 0)
2368 error ("The daemon has already been initialized");
2370 if (NILP (Vafter_init_time
))
2371 error ("This function can only be called after loading the init files");
2373 /* Get rid of stdin, stdout and stderr. */
2374 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2376 err
|= dup2 (nfd
, 0) < 0;
2377 err
|= dup2 (nfd
, 1) < 0;
2378 err
|= dup2 (nfd
, 2) < 0;
2379 err
|= emacs_close (nfd
) != 0;
2381 /* Closing the pipe will notify the parent that it can exit.
2382 FIXME: In case some other process inherited the pipe, closing it here
2383 won't notify the parent because it's still open elsewhere, so we
2384 additionally send a byte, just to make sure the parent really exits.
2385 Instead, we should probably close the pipe in start-process and
2386 call-process to make sure the pipe is never inherited by
2388 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2389 err
|= emacs_close (daemon_pipe
[1]) != 0;
2390 /* Set it to an invalid value so we know we've already run this function. */
2391 daemon_pipe
[1] = -1;
2394 error ("I/O error during daemon initialization");
2399 syms_of_emacs (void)
2401 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2402 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2403 DEFSYM (Qkill_emacs
, "kill-emacs");
2404 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2407 defsubr (&Sdump_emacs
);
2410 defsubr (&Skill_emacs
);
2412 defsubr (&Sinvocation_name
);
2413 defsubr (&Sinvocation_directory
);
2414 defsubr (&Sdaemonp
);
2415 defsubr (&Sdaemon_initialized
);
2417 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2418 doc
: /* Args passed by shell to Emacs, as a list of strings.
2419 Many arguments are deleted from the list as they are processed. */);
2421 DEFVAR_LISP ("system-type", Vsystem_type
,
2422 doc
: /* The value is a symbol indicating the type of operating system you are using.
2424 `gnu' compiled for a GNU Hurd system.
2425 `gnu/linux' compiled for a GNU/Linux system.
2426 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2427 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2428 `ms-dos' compiled as an MS-DOS application.
2429 `windows-nt' compiled as a native W32 application.
2430 `cygwin' compiled using the Cygwin library.
2431 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2432 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2433 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2434 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2436 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2437 doc
: /* Value is string indicating configuration Emacs was built for.
2438 On MS-Windows, the value reflects the OS flavor and version on which
2439 Emacs is running. */);
2440 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2442 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2443 doc
: /* String containing the configuration options Emacs was built with. */);
2444 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2446 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2447 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2449 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2450 doc
: /* Hook run when `kill-emacs' is called.
2451 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2452 in other similar situations), functions placed on this hook should not
2453 expect to be able to interact with the user. To ask for confirmation,
2454 see `kill-emacs-query-functions' instead.
2456 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2457 `noninteractive' was non-nil. */);
2458 Vkill_emacs_hook
= Qnil
;
2460 DEFVAR_LISP ("path-separator", Vpath_separator
,
2461 doc
: /* String containing the character that separates directories in
2462 search paths, such as PATH and other similar environment variables. */);
2465 Vpath_separator
= make_string (&c
, 1);
2468 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2469 doc
: /* The program name that was used to run Emacs.
2470 Any directory names are omitted. */);
2472 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2473 doc
: /* The directory in which the Emacs executable was found, to run it.
2474 The value is nil if that directory's name is not known. */);
2476 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2477 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2478 In an installed Emacs, this is normally nil. It is non-nil if
2479 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2480 within the variable `invocation-directory' or its parent. For example,
2481 this is the case when running an uninstalled Emacs executable from its
2482 build directory. */);
2483 Vinstallation_directory
= Qnil
;
2485 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2486 doc
: /* System locale for messages. */);
2487 Vsystem_messages_locale
= Qnil
;
2489 DEFVAR_LISP ("previous-system-messages-locale",
2490 Vprevious_system_messages_locale
,
2491 doc
: /* Most recently used system locale for messages. */);
2492 Vprevious_system_messages_locale
= Qnil
;
2494 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2495 doc
: /* System locale for time. */);
2496 Vsystem_time_locale
= Qnil
;
2498 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2499 doc
: /* Most recently used system locale for time. */);
2500 Vprevious_system_time_locale
= Qnil
;
2502 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2503 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2504 Vbefore_init_time
= Qnil
;
2506 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2507 doc
: /* Value of `current-time' after loading the init files.
2508 This is nil during initialization. */);
2509 Vafter_init_time
= Qnil
;
2511 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2512 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2513 inhibit_x_resources
= 0;
2515 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2516 doc
: /* Short copyright string for this version of Emacs. */);
2517 Vemacs_copyright
= build_string (emacs_copyright
);
2519 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2520 doc
: /* Version numbers of this version of Emacs. */);
2521 Vemacs_version
= build_string (emacs_version
);
2523 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2524 doc
: /* Alist of dynamic libraries vs external files implementing them.
2525 Each element is a list (LIBRARY FILE...), where the car is a symbol
2526 representing a supported external library, and the rest are strings giving
2527 alternate filenames for that library.
2529 Emacs tries to load the library from the files in the order they appear on
2530 the list; if none is loaded, the running session of Emacs won't have access
2533 Note that image types `pbm' and `xbm' do not need entries in this variable
2534 because they do not depend on external libraries and are always available.
2536 Also note that this is not a generic facility for accessing external
2537 libraries; only those already known by Emacs will be loaded. */);
2538 Vdynamic_library_alist
= Qnil
;
2539 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2542 Vlibrary_cache
= Qnil
;
2543 staticpro (&Vlibrary_cache
);
2546 /* Make sure IS_DAEMON starts up as false. */