1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2015 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"
55 #include <binary-io.h>
58 #ifdef HAVE_WINDOW_SYSTEM
60 #endif /* HAVE_WINDOW_SYSTEM */
62 #ifdef NS_IMPL_GNUSTEP
63 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
64 #include <GNUstepBase/GSConfig.h>
68 #include "intervals.h"
69 #include "character.h"
78 #include "blockinput.h"
79 #include "syssignal.h"
82 #include "termhooks.h"
87 #include "composite.h"
88 #include "dispextern.h"
91 #include "sysselect.h"
96 #if (defined PROFILING \
97 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
98 # include <sys/gmon.h>
99 extern void moncontrol (int mode
);
102 #ifdef HAVE_SETLOCALE
106 #ifdef HAVE_SETRLIMIT
107 #include <sys/time.h>
108 #include <sys/resource.h>
111 #ifdef HAVE_PERSONALITY_LINUX32
112 #include <sys/personality.h>
115 static const char emacs_version
[] = PACKAGE_VERSION
;
116 static const char emacs_copyright
[] = COPYRIGHT
;
117 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
119 /* Empty lisp strings. To avoid having to build any others. */
120 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
123 /* Cache for externally loaded libraries. */
124 Lisp_Object Vlibrary_cache
;
127 /* Set after Emacs has started up the first time.
128 Prevents reinitialization of the Lisp world and keymaps
129 on subsequent starts. */
132 /* Set to true if this instance of Emacs might dump. */
136 extern void unexec_init_emacs_zone (void);
139 #ifdef DOUG_LEA_MALLOC
140 /* Preserves a pointer to the memory allocated that copies that
141 static data inside glibc's malloc. */
142 static void *malloc_state_ptr
;
143 /* From glibc, a routine that returns a copy of the malloc internal state. */
144 extern void *malloc_get_state (void);
145 /* From glibc, a routine that overwrites the malloc internal state. */
146 extern int malloc_set_state (void *);
147 /* True if the MALLOC_CHECK_ environment variable was set while
148 dumping. Used to work around a bug in glibc's malloc. */
149 static bool malloc_using_checking
;
150 #elif defined HAVE_PTHREAD && !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
151 extern void malloc_enable_thread (void);
154 Lisp_Object Qfile_name_handler_alist
;
156 Lisp_Object Qrisky_local_variable
;
158 Lisp_Object Qkill_emacs
;
159 static Lisp_Object Qkill_emacs_hook
;
161 /* If true, Emacs should not attempt to use a window-specific code,
162 but instead should use the virtual terminal under which it was started. */
163 bool inhibit_window_system
;
165 /* If true, a filter or a sentinel is running. Tested to save the match
166 data on the first attempt to change it inside asynchronous code. */
167 bool running_asynch_code
;
169 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
170 /* If true, -d was specified, meaning we're using some window system. */
174 /* An address near the bottom of the stack.
175 Tells GC how to save a copy of the stack. */
178 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
179 /* The address where the heap starts (from the first sbrk (0) call). */
180 static void *my_heap_start
;
184 /* The gap between BSS end and heap start as far as we can tell. */
185 static uprintmax_t heap_bss_diff
;
188 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
191 On Cocoa, CoreFoundation lib fails in forked process:
192 http://developer.apple.com/ReleaseNotes/
193 CoreFoundation/CoreFoundation.html)
195 On Windows, a Cygwin fork child cannot access the USER subsystem.
197 We mark being in the exec'd process by a daemon name argument of
198 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
199 NAME is the original daemon name, if any. */
200 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
201 # define DAEMON_MUST_EXEC
204 /* True means running Emacs without interactive terminal. */
207 /* True means remove site-lisp directories from load-path. */
210 /* Name for the server started by the daemon.*/
211 static char *daemon_name
;
213 /* Pipe used to send exit notification to the daemon parent at
217 /* Save argv and argc. */
221 static void sort_args (int argc
, char **argv
);
222 static void syms_of_emacs (void);
224 /* C99 needs each string to be at most 4095 characters, and the usage
225 strings below are split to not overflow this limit. */
226 static char const *const usage_message
[] =
229 Run Emacs, the extensible, customizable, self-documenting real-time\n\
230 display editor. The recommended way to start Emacs for normal editing\n\
231 is with no options at all.\n\
233 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
234 read the main documentation for these command-line arguments.\n\
236 Initialization options:\n\
240 --batch do not do interactive display; implies -q\n\
241 --chdir DIR change to directory DIR\n\
242 --daemon start a server in the background\n\
243 --debug-init enable Emacs Lisp debugger for init file\n\
244 --display, -d DISPLAY use X server DISPLAY\n\
247 --no-desktop do not load a saved desktop\n\
248 --no-init-file, -q load neither ~/.emacs nor default.el\n\
249 --no-shared-memory, -nl do not use shared memory\n\
250 --no-site-file do not load site-start.el\n\
251 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
252 --no-splash do not display a splash screen on startup\n\
253 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
256 --quick, -Q equivalent to:\n\
257 -q --no-site-file --no-site-lisp --no-splash\n\
258 --script FILE run FILE as an Emacs Lisp script\n\
259 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
260 --user, -u USER load ~USER/.emacs instead of your own\n\
266 FILE visit FILE using find-file\n\
267 +LINE go to line LINE in next FILE\n\
268 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
269 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
270 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
271 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
274 --file FILE visit FILE using find-file\n\
275 --find-file FILE visit FILE using find-file\n\
276 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
277 --insert FILE insert contents of FILE into current buffer\n\
278 --kill exit without asking for confirmation\n\
279 --load, -l FILE load Emacs Lisp FILE using the load function\n\
280 --visit FILE visit FILE using find-file\n\
286 --background-color, -bg COLOR window background color\n\
287 --basic-display, -D disable many display features;\n\
288 used for debugging Emacs\n\
289 --border-color, -bd COLOR main border color\n\
290 --border-width, -bw WIDTH width of main border\n\
293 --color, --color=MODE override color mode for character terminals;\n\
294 MODE defaults to `auto', and\n\
295 can also be `never', `always',\n\
296 or a mode name like `ansi8'\n\
297 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
298 --font, -fn FONT default font; must be fixed-width\n\
299 --foreground-color, -fg COLOR window foreground color\n\
302 --fullheight, -fh make the first frame high as the screen\n\
303 --fullscreen, -fs make the first frame fullscreen\n\
304 --fullwidth, -fw make the first frame wide as the screen\n\
305 --maximized, -mm make the first frame maximized\n\
306 --geometry, -g GEOMETRY window geometry\n\
309 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
310 --iconic start Emacs in iconified state\n\
311 --internal-border, -ib WIDTH width between text and main border\n\
312 --line-spacing, -lsp PIXELS additional space to put between lines\n\
313 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
314 --name NAME title for initial Emacs frame\n\
317 --no-blinking-cursor, -nbc disable blinking cursor\n\
318 --reverse-video, -r, -rv switch foreground and background\n\
319 --title, -T TITLE title for initial Emacs frame\n\
320 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
321 --xrm XRESOURCES set additional X resources\n\
322 --parent-id XID set parent window\n\
323 --help display this help and exit\n\
324 --version output version information and exit\n\
328 You can generally also specify long option names with a single -; for\n\
329 example, -batch as well as --batch. You can use any unambiguous\n\
330 abbreviation for a --option.\n\
332 Various environment variables and window system resources also affect\n\
333 the operation of Emacs. See the main documentation.\n\
335 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
336 section of the Emacs manual or the file BUGS.\n"
340 /* True if handling a fatal error already. */
341 bool fatal_error_in_progress
;
344 /* NS autrelease pool, for memory management. */
345 static void *ns_pool
;
350 setlocale (int cat
, char const *locale
)
357 /* Report a fatal error due to signal SIG, output a backtrace of at
358 most BACKTRACE_LIMIT lines, and exit. */
360 terminate_due_to_signal (int sig
, int backtrace_limit
)
362 signal (sig
, SIG_DFL
);
363 totally_unblock_input ();
365 /* If fatal error occurs in code below, avoid infinite recursion. */
366 if (! fatal_error_in_progress
)
368 fatal_error_in_progress
= 1;
370 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
371 Fkill_emacs (make_number (sig
));
373 shut_down_emacs (sig
, Qnil
);
374 emacs_backtrace (backtrace_limit
);
377 /* Signal the same code; this time it will really be fatal.
378 Since we're in a signal handler, the signal is blocked, so we
379 have to unblock it if we want to really receive it. */
383 sigemptyset (&unblocked
);
384 sigaddset (&unblocked
, sig
);
385 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
391 /* This shouldn't be executed, but it prevents a warning. */
395 /* Code for dealing with Lisp access to the Unix command line. */
398 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
401 Lisp_Object name
, dir
, handler
;
402 ptrdiff_t count
= SPECPDL_INDEX ();
403 Lisp_Object raw_name
;
404 AUTO_STRING (slash_colon
, "/:");
410 /* Must use argv[0] converted to UTF-8, as it begets many standard
411 file and directory names. */
413 char argv0
[MAX_UTF8_PATH
];
415 if (filename_from_ansi (argv
[0], argv0
) == 0)
416 raw_name
= build_unibyte_string (argv0
);
418 raw_name
= build_unibyte_string (argv
[0]);
421 raw_name
= build_unibyte_string (argv
[0]);
424 /* Add /: to the front of the name
425 if it would otherwise be treated as magic. */
426 handler
= Ffind_file_name_handler (raw_name
, Qt
);
427 if (! NILP (handler
))
428 raw_name
= concat2 (slash_colon
, raw_name
);
430 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
431 Vinvocation_directory
= Ffile_name_directory (raw_name
);
433 /* If we got no directory in argv[0], search PATH to find where
434 Emacs actually came from. */
435 if (NILP (Vinvocation_directory
))
438 int yes
= openp (Vexec_path
, Vinvocation_name
,
439 Vexec_suffixes
, &found
, make_number (X_OK
), false);
442 /* Add /: to the front of the name
443 if it would otherwise be treated as magic. */
444 handler
= Ffind_file_name_handler (found
, Qt
);
445 if (! NILP (handler
))
446 found
= concat2 (slash_colon
, found
);
447 Vinvocation_directory
= Ffile_name_directory (found
);
451 if (!NILP (Vinvocation_directory
)
452 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
453 /* Emacs was started with relative path, like ./emacs.
457 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
459 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
462 Vinstallation_directory
= Qnil
;
464 if (!NILP (Vinvocation_directory
))
466 dir
= Vinvocation_directory
;
468 /* If we are running from the build directory, set DIR to the
469 src subdirectory of the Emacs tree, like on Posix
471 if (SBYTES (dir
) > sizeof ("/i386/") - 1
472 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
474 dir
= Fexpand_file_name (build_string ("../.."), dir
);
475 #else /* !WINDOWSNT */
477 name
= Fexpand_file_name (Vinvocation_name
, dir
);
480 Lisp_Object tem
, lib_src_exists
;
481 Lisp_Object etc_exists
, info_exists
;
483 /* See if dir contains subdirs for use by Emacs.
484 Check for the ones that would exist in a build directory,
485 not including lisp and info. */
486 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
487 lib_src_exists
= Ffile_exists_p (tem
);
490 /* MSDOS installations frequently remove lib-src, but we still
491 must set installation-directory, or else info won't find
492 its files (it uses the value of installation-directory). */
493 tem
= Fexpand_file_name (build_string ("info"), dir
);
494 info_exists
= Ffile_exists_p (tem
);
499 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
501 tem
= Fexpand_file_name (build_string ("etc"), dir
);
502 etc_exists
= Ffile_exists_p (tem
);
503 if (!NILP (etc_exists
))
505 Vinstallation_directory
506 = Ffile_name_as_directory (dir
);
511 /* See if dir's parent contains those subdirs. */
512 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
513 lib_src_exists
= Ffile_exists_p (tem
);
517 /* See the MSDOS commentary above. */
518 tem
= Fexpand_file_name (build_string ("../info"), dir
);
519 info_exists
= Ffile_exists_p (tem
);
524 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
526 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
527 etc_exists
= Ffile_exists_p (tem
);
528 if (!NILP (etc_exists
))
530 tem
= Fexpand_file_name (build_string (".."), dir
);
531 Vinstallation_directory
532 = Ffile_name_as_directory (tem
);
537 /* If the Emacs executable is actually a link,
538 next try the dir that the link points into. */
539 tem
= Ffile_symlink_p (name
);
542 name
= Fexpand_file_name (tem
, dir
);
543 dir
= Ffile_name_directory (name
);
550 Vcommand_line_args
= Qnil
;
552 for (i
= argc
- 1; i
>= 0; i
--)
554 if (i
== 0 || i
> skip_args
)
555 /* For the moment, we keep arguments as is in unibyte strings.
556 They are decoded in the function command-line after we know
557 locale-coding-system. */
559 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
562 unbind_to (count
, Qnil
);
565 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
566 doc
: /* Return the program name that was used to run Emacs.
567 Any directory names are omitted. */)
570 return Fcopy_sequence (Vinvocation_name
);
573 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
575 doc
: /* Return the directory name in which the Emacs executable was located. */)
578 return Fcopy_sequence (Vinvocation_directory
);
582 /* Test whether the next argument in ARGV matches SSTR or a prefix of
583 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
584 (the argument is supposed to have a value) store in *VALPTR either
585 the next argument or the portion of this one after the equal sign.
586 ARGV is read starting at position *SKIPPTR; this index is advanced
587 by the number of arguments used.
589 Too bad we can't just use getopt for all of this, but we don't have
590 enough information to do it right. */
593 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
594 int minlen
, char **valptr
, int *skipptr
)
600 /* Don't access argv[argc]; give up in advance. */
601 if (argc
<= *skipptr
+ 1)
604 arg
= argv
[*skipptr
+1];
607 if (strcmp (arg
, sstr
) == 0)
611 *valptr
= argv
[*skipptr
+2];
618 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
619 ? p
- arg
: strlen (arg
));
620 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
622 else if (valptr
== NULL
)
633 else if (argv
[*skipptr
+2] != NULL
)
635 *valptr
= argv
[*skipptr
+2];
645 #ifdef DOUG_LEA_MALLOC
647 /* malloc can be invoked even before main (e.g. by the dynamic
648 linker), so the dumped malloc state must be restored as early as
649 possible using this special hook. */
652 malloc_initialize_hook (void)
656 if (!malloc_using_checking
)
657 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
658 ignored if the heap to be restored was constructed without
659 malloc checking. Can't use unsetenv, since that calls malloc. */
663 for (p
= environ
; p
&& *p
; p
++)
664 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
673 malloc_set_state (malloc_state_ptr
);
674 #ifndef XMALLOC_OVERRUN_CHECK
675 free (malloc_state_ptr
);
680 if (my_heap_start
== 0)
681 my_heap_start
= sbrk (0);
682 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
686 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
688 #endif /* DOUG_LEA_MALLOC */
690 /* Close standard output and standard error, reporting any write
691 errors as best we can. This is intended for use with atexit. */
693 close_output_streams (void)
695 if (close_stream (stdout
) != 0)
697 emacs_perror ("Write error to standard output");
698 _exit (EXIT_FAILURE
);
701 if (close_stream (stderr
) != 0)
702 _exit (EXIT_FAILURE
);
707 main (int argc
, char **argv
)
712 char stack_bottom_variable
;
713 bool do_initial_setlocale
;
716 #ifdef HAVE_SETRLIMIT
722 #ifdef DAEMON_MUST_EXEC
727 /* If we use --chdir, this records the original directory. */
728 char *original_pwd
= 0;
735 might_dump
= !initialized
;
741 if (my_heap_start
== 0)
742 my_heap_start
= sbrk (0);
744 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
748 #if defined WINDOWSNT || defined HAVE_NTGUI
749 /* Set global variables used to detect Windows version. Do this as
750 early as possible. (unexw32.c calls this function as well, but
751 the additional call here is harmless.) */
752 cache_system_info ();
754 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
755 to have non-stub implementations of APIs we need to convert file
756 names between UTF-8 and the system's ANSI codepage. */
757 maybe_load_unicows_dll ();
761 #ifdef RUN_TIME_REMAP
763 run_time_remap (argv
[0]);
766 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
769 unexec_init_emacs_zone ();
772 atexit (close_output_streams
);
774 sort_args (argc
, argv
);
776 while (argv
[argc
]) argc
++;
778 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
780 const char *version
, *copyright
;
783 Lisp_Object tem
, tem2
;
784 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
785 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
788 fprintf (stderr
, "Invalid value of `emacs-version'\n");
793 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
798 version
= SSDATA (tem
);
799 copyright
= SSDATA (tem2
);
804 version
= emacs_version
;
805 copyright
= emacs_copyright
;
807 printf ("%s %s\n", PACKAGE_NAME
, version
);
808 printf ("%s\n", copyright
);
809 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
810 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
811 printf ("under the terms of the GNU General Public License.\n");
812 printf ("For more information about these matters, ");
813 printf ("see the file named COPYING.\n");
817 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
820 /* argv[] array is kept in its original ANSI codepage encoding,
821 we need to convert to UTF-8, for chdir to work. */
822 char newdir
[MAX_UTF8_PATH
];
824 filename_from_ansi (ch_to_dir
, newdir
);
827 original_pwd
= get_current_dir_name ();
828 if (chdir (ch_to_dir
) != 0)
830 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
831 argv
[0], ch_to_dir
, strerror (errno
));
836 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
837 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
839 #ifdef HAVE_PERSONALITY_LINUX32
840 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
842 /* Set this so we only do this once. */
843 xputenv ("EMACS_HEAP_EXEC=true");
845 /* A flag to turn off address randomization which is introduced
846 in linux kernel shipped with fedora core 4 */
847 #define ADD_NO_RANDOMIZE 0x0040000
848 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
849 #undef ADD_NO_RANDOMIZE
851 execvp (argv
[0], argv
);
853 /* If the exec fails, try to dump anyway. */
854 emacs_perror (argv
[0]);
856 #endif /* HAVE_PERSONALITY_LINUX32 */
858 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
859 /* Extend the stack space available.
860 Don't do that if dumping, since some systems (e.g. DJGPP)
861 might define a smaller stack limit at that time. */
864 && (!noninteractive
|| initialized
)
866 && !getrlimit (RLIMIT_STACK
, &rlim
))
869 /* Approximate the amount regex.c needs per unit of re_max_failures. */
870 int ratio
= 20 * sizeof (char *);
871 /* Then add 33% to cover the size of the smaller stacks that regex.c
872 successively allocates and discards, on its way to the maximum. */
874 /* Add in some extra to cover
875 what we're likely to use for other reasons. */
876 newlim
= re_max_failures
* ratio
+ 200000;
878 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
879 stack allocation routine for new process that the allocation
880 fails if stack limit is not on page boundary. So, round up the
881 new limit to page boundary. */
882 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
884 if (newlim
> rlim
.rlim_max
)
886 newlim
= rlim
.rlim_max
;
887 /* Don't let regex.c overflow the stack we have. */
888 re_max_failures
= (newlim
- 200000) / ratio
;
890 if (rlim
.rlim_cur
< newlim
)
891 rlim
.rlim_cur
= newlim
;
893 setrlimit (RLIMIT_STACK
, &rlim
);
895 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
897 /* Record (approximately) where the stack begins. */
898 stack_bottom
= &stack_bottom_variable
;
902 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
903 /* Arrange to get warning messages as memory fills up. */
904 memory_warnings (0, malloc_warning
);
906 /* Call malloc at least once, to run malloc_initialize_hook.
907 Also call realloc and free for consistency. */
908 free (realloc (malloc (4), 4));
910 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
913 SET_BINARY (fileno (stdin
));
915 SET_BINARY (fileno (stdout
));
918 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
919 The build procedure uses this while dumping, to ensure that the
920 dumped Emacs does not have its system locale tables initialized,
921 as that might cause screwups when the dumped Emacs starts up. */
923 char *lc_all
= getenv ("LC_ALL");
924 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
927 /* Set locale now, so that initial error messages are localized properly.
928 fixup_locale must wait until later, since it builds strings. */
929 if (do_initial_setlocale
)
930 setlocale (LC_ALL
, "");
932 inhibit_window_system
= 0;
934 /* Handle the -t switch, which specifies filename to use as terminal. */
938 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
943 result
= emacs_open (term
, O_RDWR
, 0);
944 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
946 char *errstring
= strerror (errno
);
947 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
952 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
955 fprintf (stderr
, "Using %s\n", term
);
956 #ifdef HAVE_WINDOW_SYSTEM
957 inhibit_window_system
= 1; /* -t => -nw */
964 /* Command line option --no-windows is deprecated and thus not mentioned
965 in the manual and usage information. */
966 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
967 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
968 inhibit_window_system
= 1;
970 /* Handle the -batch switch, which means don't do interactive display. */
972 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
975 Vundo_outer_limit
= Qnil
;
977 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
979 noninteractive
= 1; /* Set batch mode. */
980 /* Convert --script to -scriptload, un-skip it, and sort again
981 so that it will be handled in proper sequence. */
982 /* FIXME broken for --script=FILE - is that supposed to work? */
983 argv
[skip_args
- 1] = (char *) "-scriptload";
985 sort_args (argc
, argv
);
988 /* Handle the --help option, which gives a usage message. */
989 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
992 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
993 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
994 fputs (usage_message
[i
], stdout
);
998 /* Make sure IS_DAEMON starts up as false. */
1001 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1002 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1007 /* Start as a daemon: fork a new child process which will run the
1008 rest of the initialization code, then exit.
1010 Detaching a daemon requires the following steps:
1014 - close the tty file-descriptors
1016 We only want to do the last 2 steps once the daemon is ready to
1017 serve requests, i.e. after loading .emacs (initialization).
1018 OTOH initialization may start subprocesses (e.g. ispell) and these
1019 should be run from the proper process (the one that will end up
1020 running as daemon) and with the proper "session id" in order for
1021 them to keep working after detaching, so fork and setsid need to be
1022 performed before initialization.
1024 We want to avoid exiting before the server socket is ready, so
1025 use a pipe for synchronization. The parent waits for the child
1026 to close its end of the pipe (using `daemon-initialized')
1028 if (emacs_pipe (daemon_pipe
) != 0)
1030 fprintf (stderr
, "Cannot pipe!\n");
1034 #ifndef DAEMON_MUST_EXEC
1036 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1037 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1038 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1039 #endif /* USE_GTK */
1041 #else /* DAEMON_MUST_EXEC */
1042 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1043 f
= fork (); /* in orig */
1045 f
= 0; /* in exec'd */
1046 #endif /* !DAEMON_MUST_EXEC */
1052 /* Close unused writing end of the pipe. */
1053 emacs_close (daemon_pipe
[1]);
1055 /* Just wait for the child to close its end of the pipe. */
1058 retval
= read (daemon_pipe
[0], &buf
, 1);
1060 while (retval
== -1 && errno
== EINTR
);
1064 fprintf (stderr
, "Error reading status from child\n");
1067 else if (retval
== 0)
1069 fprintf (stderr
, "Error: server did not start correctly\n");
1073 emacs_close (daemon_pipe
[0]);
1078 emacs_perror ("fork");
1079 exit (EXIT_CANCELED
);
1082 #ifdef DAEMON_MUST_EXEC
1084 /* In orig process, forked as child, OR in exec'd. */
1085 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1086 { /* In orig, child: now exec w/special daemon name. */
1089 snprintf (fdStr
, sizeof fdStr
,
1090 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1091 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1093 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1095 fprintf (stderr
, "daemon: child name too long\n");
1096 exit (EXIT_CANNOT_INVOKE
);
1099 argv
[skip_args
] = fdStr
;
1101 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1102 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1103 execvp (argv
[0], argv
);
1104 emacs_perror (argv
[0]);
1105 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1108 /* In exec'd: parse special dname into pipe and name info. */
1109 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1110 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1112 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1113 exit (EXIT_CANNOT_INVOKE
);
1115 dname_arg2
[0] = '\0';
1116 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1118 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1119 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1121 #endif /* DAEMON_MUST_EXEC */
1124 daemon_name
= xstrdup (dname_arg
);
1125 /* Close unused reading end of the pipe. */
1126 emacs_close (daemon_pipe
[0]);
1130 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1135 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1136 && !defined DOUG_LEA_MALLOC && !defined HYBRID_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. See
1140 Bug#14569. The part of this bug involving Cygwin is no longer
1141 relevant, now that Cygwin defines HYBRID_MALLOC. */
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) && ! ch_to_dir
)
1235 chdir (getenv ("HOME"));
1236 if (skip_args
< argc
)
1238 if (!strncmp (argv
[skip_args
], "-psn", 4))
1241 if (! ch_to_dir
) chdir (getenv ("HOME"));
1243 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1246 if (! ch_to_dir
) 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 storage and default directory of main buffer. */
1363 init_buffer (initialized
);
1365 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1367 /* Must precede init_lread. */
1368 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1372 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1373 Lisp_Object old_log_max
;
1374 old_log_max
= Vmessage_log_max
;
1375 XSETFASTINT (Vmessage_log_max
, 0);
1376 message_dolog ("", 0, 1, 0);
1377 Vmessage_log_max
= old_log_max
;
1380 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1384 /* Check to see if Emacs has been installed correctly. */
1385 check_windows_init_file ();
1388 /* Intern the names of all standard functions and variables;
1389 define standard keys. */
1393 /* The basic levels of Lisp must come first. Note that
1394 syms_of_data and some others have already been called. */
1399 syms_of_floatfns ();
1402 syms_of_bytecode ();
1404 syms_of_casefiddle ();
1406 syms_of_category ();
1408 syms_of_character ();
1415 syms_of_filelock ();
1418 /* syms_of_keymap (); */
1426 syms_of_terminal ();
1432 syms_of_textprop ();
1433 syms_of_composite ();
1436 #endif /* WINDOWSNT */
1443 #ifdef HAVE_WINDOW_SYSTEM
1446 #endif /* HAVE_WINDOW_SYSTEM */
1447 #ifdef HAVE_X_WINDOWS
1452 #ifdef HAVE_XWIDGETS
1455 syms_of_xsettings ();
1462 #endif /* HAVE_X_WINDOWS */
1469 syms_of_decompress ();
1479 #endif /* HAVE_NTGUI */
1481 #if defined WINDOWSNT || defined HAVE_NTGUI
1482 syms_of_w32select ();
1489 syms_of_win16select ();
1496 syms_of_nsselect ();
1498 #endif /* HAVE_NS */
1502 #ifdef HAVE_GFILENOTIFY
1503 syms_of_gfilenotify ();
1504 #endif /* HAVE_GFILENOTIFY */
1508 #endif /* HAVE_INOTIFY */
1511 syms_of_dbusbind ();
1512 #endif /* HAVE_DBUS */
1516 #ifdef HAVE_W32NOTIFY
1517 syms_of_w32notify ();
1518 #endif /* HAVE_W32NOTIFY */
1519 #endif /* WINDOWSNT */
1521 syms_of_profiler ();
1523 keys_of_casefiddle ();
1526 keys_of_keyboard ();
1532 /* Initialization that must be done even if the global variable
1533 initialized is non zero. */
1535 globals_of_w32font ();
1536 globals_of_w32fns ();
1537 globals_of_w32menu ();
1538 #endif /* HAVE_NTGUI */
1540 #if defined WINDOWSNT || defined HAVE_NTGUI
1541 globals_of_w32select ();
1547 /* This calls putenv and so must precede init_process_emacs. Also,
1548 it sets Voperating_system_release, which init_process_emacs uses. */
1551 /* These two call putenv. */
1559 /* This can create a thread that may call getenv, so it must follow
1560 all calls to putenv and setenv. Also, this sets up
1561 add_keyboard_wait_descriptor, which init_display uses. */
1562 init_process_emacs ();
1564 init_keyboard (); /* This too must precede init_sys_modes. */
1565 if (!noninteractive
)
1566 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1569 init_crit (); /* w32notify.c needs this in batch mode. */
1570 #endif /* HAVE_W32NOTIFY */
1572 #ifdef HAVE_WINDOW_SYSTEM
1574 #endif /* HAVE_WINDOW_SYSTEM */
1582 /* Handle -l loadup, args passed by Makefile. */
1583 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1586 char file_utf8
[MAX_UTF8_PATH
];
1588 if (filename_from_ansi (file
, file_utf8
) == 0)
1591 Vtop_level
= list2 (intern_c_string ("load"),
1592 build_unibyte_string (file
));
1594 /* Unless next switch is -nl, load "loadup.el" first thing. */
1596 Vtop_level
= list2 (intern_c_string ("load"),
1597 build_string ("loadup.el"));
1600 /* Set up for profiling. This is known to work on FreeBSD,
1601 GNU/Linux and MinGW. It might work on some other systems too.
1602 Give it a try and tell us if it works on your system. To compile
1603 for profiling, use the configure option --enable-profiling. */
1604 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1609 extern unsigned char etext
asm ("etext");
1615 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1624 /* Enter editor command loop. This never returns. */
1630 /* Sort the args so we can find the most important ones
1631 at the beginning of argv. */
1633 /* First, here's a table of all the standard options. */
1635 struct standard_args
1638 const char *longname
;
1643 static const struct standard_args standard_args
[] =
1645 { "-version", "--version", 150, 0 },
1646 { "-chdir", "--chdir", 130, 1 },
1647 { "-t", "--terminal", 120, 1 },
1648 { "-nw", "--no-window-system", 110, 0 },
1649 { "-nw", "--no-windows", 110, 0 },
1650 { "-batch", "--batch", 100, 0 },
1651 { "-script", "--script", 100, 1 },
1652 { "-daemon", "--daemon", 99, 0 },
1653 { "-help", "--help", 90, 0 },
1654 { "-nl", "--no-loadup", 70, 0 },
1655 { "-nsl", "--no-site-lisp", 65, 0 },
1656 /* -d must come last before the options handled in startup.el. */
1657 { "-d", "--display", 60, 1 },
1658 { "-display", 0, 60, 1 },
1659 /* Now for the options handled in `command-line' (startup.el). */
1660 /* (Note that to imply -nsl, -Q is partially handled here.) */
1661 { "-Q", "--quick", 55, 0 },
1662 { "-quick", 0, 55, 0 },
1663 { "-q", "--no-init-file", 50, 0 },
1664 { "-no-init-file", 0, 50, 0 },
1665 { "-no-site-file", "--no-site-file", 40, 0 },
1666 { "-u", "--user", 30, 1 },
1667 { "-user", 0, 30, 1 },
1668 { "-debug-init", "--debug-init", 20, 0 },
1669 { "-iconic", "--iconic", 15, 0 },
1670 { "-D", "--basic-display", 12, 0},
1671 { "-basic-display", 0, 12, 0},
1672 { "-nbc", "--no-blinking-cursor", 12, 0 },
1673 /* Now for the options handled in `command-line-1' (startup.el). */
1674 { "-nbi", "--no-bitmap-icon", 10, 0 },
1675 { "-bg", "--background-color", 10, 1 },
1676 { "-background", 0, 10, 1 },
1677 { "-fg", "--foreground-color", 10, 1 },
1678 { "-foreground", 0, 10, 1 },
1679 { "-bd", "--border-color", 10, 1 },
1680 { "-bw", "--border-width", 10, 1 },
1681 { "-ib", "--internal-border", 10, 1 },
1682 { "-ms", "--mouse-color", 10, 1 },
1683 { "-cr", "--cursor-color", 10, 1 },
1684 { "-fn", "--font", 10, 1 },
1685 { "-font", 0, 10, 1 },
1686 { "-fs", "--fullscreen", 10, 0 },
1687 { "-fw", "--fullwidth", 10, 0 },
1688 { "-fh", "--fullheight", 10, 0 },
1689 { "-mm", "--maximized", 10, 0 },
1690 { "-g", "--geometry", 10, 1 },
1691 { "-geometry", 0, 10, 1 },
1692 { "-T", "--title", 10, 1 },
1693 { "-title", 0, 10, 1 },
1694 { "-name", "--name", 10, 1 },
1695 { "-xrm", "--xrm", 10, 1 },
1696 { "-parent-id", "--parent-id", 10, 1 },
1697 { "-r", "--reverse-video", 5, 0 },
1699 { "-reverse", 0, 5, 0 },
1700 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1701 { "-vb", "--vertical-scroll-bars", 5, 0 },
1702 { "-color", "--color", 5, 0},
1703 { "-no-splash", "--no-splash", 3, 0 },
1704 { "-no-desktop", "--no-desktop", 3, 0 },
1706 { "-NSAutoLaunch", 0, 5, 1 },
1707 { "-NXAutoLaunch", 0, 5, 1 },
1708 { "-_NSMachLaunch", 0, 85, 1 },
1709 { "-MachLaunch", 0, 85, 1 },
1710 { "-macosx", 0, 85, 0 },
1711 { "-NSHost", 0, 85, 1 },
1713 /* These have the same priority as ordinary file name args,
1714 so they are not reordered with respect to those. */
1715 { "-L", "--directory", 0, 1 },
1716 { "-directory", 0, 0, 1 },
1717 { "-l", "--load", 0, 1 },
1718 { "-load", 0, 0, 1 },
1719 /* This has no longname, because using --scriptload confuses sort_args,
1720 because then the --script long option seems to match twice; ie
1721 you can't have a long option which is a prefix of another long
1722 option. In any case, this is entirely an internal option. */
1723 { "-scriptload", NULL
, 0, 1 },
1724 { "-f", "--funcall", 0, 1 },
1725 { "-funcall", 0, 0, 1 },
1726 { "-eval", "--eval", 0, 1 },
1727 { "-execute", "--execute", 0, 1 },
1728 { "-find-file", "--find-file", 0, 1 },
1729 { "-visit", "--visit", 0, 1 },
1730 { "-file", "--file", 0, 1 },
1731 { "-insert", "--insert", 0, 1 },
1733 { "-NXOpen", 0, 0, 1 },
1734 { "-NXOpenTemp", 0, 0, 1 },
1735 { "-NSOpen", 0, 0, 1 },
1736 { "-NSOpenTemp", 0, 0, 1 },
1737 { "-GSFilePath", 0, 0, 1 },
1739 /* This should be processed after ordinary file name args and the like. */
1740 { "-kill", "--kill", -10, 0 },
1743 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1744 so that the highest priority ones come first.
1745 Do not change the order of elements of equal priority.
1746 If an option takes an argument, keep it and its argument together.
1748 If an option that takes no argument appears more
1749 than once, eliminate all but one copy of it. */
1752 sort_args (int argc
, char **argv
)
1754 char **new = xmalloc (argc
* sizeof *new);
1755 /* For each element of argv,
1756 the corresponding element of options is:
1757 0 for an option that takes no arguments,
1758 1 for an option that takes one argument, etc.
1759 -1 for an ordinary non-option argument. */
1760 int *options
= xnmalloc (argc
, sizeof *options
);
1761 int *priority
= xnmalloc (argc
, sizeof *priority
);
1763 int incoming_used
= 1;
1767 /* Categorize all the options,
1768 and figure out which argv elts are option arguments. */
1769 for (from
= 1; from
< argc
; from
++)
1773 if (argv
[from
][0] == '-')
1777 /* If we have found "--", don't consider
1778 any more arguments as options. */
1779 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1781 /* Leave the "--", and everything following it, at the end. */
1782 for (; from
< argc
; from
++)
1784 priority
[from
] = -100;
1790 /* Look for a match with a known old-fashioned option. */
1791 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1792 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1794 options
[from
] = standard_args
[i
].nargs
;
1795 priority
[from
] = standard_args
[i
].priority
;
1796 if (from
+ standard_args
[i
].nargs
>= argc
)
1797 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1798 from
+= standard_args
[i
].nargs
;
1802 /* Look for a match with a known long option.
1803 MATCH is -1 if no match so far, -2 if two or more matches so far,
1804 >= 0 (the table index of the match) if just one match so far. */
1805 if (argv
[from
][1] == '-')
1807 char const *equals
= strchr (argv
[from
], '=');
1809 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1813 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1814 if (standard_args
[i
].longname
1815 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1824 /* If we found exactly one match, use that. */
1827 options
[from
] = standard_args
[match
].nargs
;
1828 priority
[from
] = standard_args
[match
].priority
;
1829 /* If --OPTION=VALUE syntax is used,
1830 this option uses just one argv element. */
1833 if (from
+ options
[from
] >= argc
)
1834 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1835 from
+= options
[from
];
1837 /* FIXME When match < 0, shouldn't there be some error,
1838 or at least indication to the user that there was a
1845 /* Copy the arguments, in order of decreasing priority, to NEW. */
1847 while (incoming_used
< argc
)
1850 int best_priority
= -9999;
1852 /* Find the highest priority remaining option.
1853 If several have equal priority, take the first of them. */
1854 for (from
= 1; from
< argc
; from
++)
1856 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1858 best_priority
= priority
[from
];
1861 /* Skip option arguments--they are tied to the options. */
1862 if (options
[from
] > 0)
1863 from
+= options
[from
];
1869 /* Copy the highest priority remaining option, with its args, to NEW.
1870 Unless it is a duplicate of the previous one. */
1871 if (! (options
[best
] == 0
1872 && ! strcmp (new[to
- 1], argv
[best
])))
1874 new[to
++] = argv
[best
];
1875 for (i
= 0; i
< options
[best
]; i
++)
1876 new[to
++] = argv
[best
+ i
+ 1];
1879 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1881 /* Clear out this option in ARGV. */
1883 for (i
= 0; i
< options
[best
]; i
++)
1884 argv
[best
+ i
+ 1] = 0;
1887 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1891 memcpy (argv
, new, sizeof (char *) * argc
);
1898 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1899 doc
: /* Exit the Emacs job and kill it.
1900 If ARG is an integer, return ARG as the exit program code.
1901 If ARG is a string, stuff it as keyboard input.
1903 This function is called upon receipt of the signals SIGTERM
1904 or SIGHUP, and upon SIGINT in batch mode.
1906 The value of `kill-emacs-hook', if not void,
1907 is a list of functions (of no args),
1908 all of which are called before Emacs is actually killed. */)
1911 struct gcpro gcpro1
;
1919 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1921 waiting_for_input
= 0;
1922 Frun_hooks (1, &Qkill_emacs_hook
);
1925 #ifdef HAVE_X_WINDOWS
1926 /* Transfer any clipboards we own to the clipboard manager. */
1927 x_clipboard_manager_save_all ();
1930 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1933 ns_release_autorelease_pool (ns_pool
);
1936 /* If we have an auto-save list file,
1937 kill it because we are exiting Emacs deliberately (not crashing).
1938 Do it after shut_down_emacs, which does an auto-save. */
1939 if (STRINGP (Vauto_save_list_file_name
))
1941 Lisp_Object listfile
;
1942 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1943 unlink (SSDATA (listfile
));
1947 exit_code
= (XINT (arg
) < 0
1948 ? XINT (arg
) | INT_MIN
1949 : XINT (arg
) & INT_MAX
);
1951 exit_code
= EXIT_SUCCESS
;
1956 /* Perform an orderly shutdown of Emacs. Autosave any modified
1957 buffers, kill any child processes, clean up the terminal modes (if
1958 we're in the foreground), and other stuff like that. Don't perform
1959 any redisplay; this may be called when Emacs is shutting down in
1960 the background, or after its X connection has died.
1962 If SIG is a signal number, print a message for it.
1964 This is called by fatal signal handlers, X protocol error handlers,
1968 shut_down_emacs (int sig
, Lisp_Object stuff
)
1970 /* Prevent running of hooks from now on. */
1973 /* Don't update display from now on. */
1974 Vinhibit_redisplay
= Qt
;
1976 /* If we are controlling the terminal, reset terminal modes. */
1979 pid_t pgrp
= getpgrp ();
1980 pid_t tpgrp
= tcgetpgrp (0);
1981 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1983 reset_all_sys_modes ();
1984 if (sig
&& sig
!= SIGTERM
)
1986 static char const format
[] = "Fatal error %d: ";
1987 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1988 int buflen
= sprintf (buf
, format
, sig
);
1989 char const *sig_desc
= safe_strsignal (sig
);
1990 emacs_write (STDERR_FILENO
, buf
, buflen
);
1991 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1997 reset_all_sys_modes ();
2000 stuff_buffered_input (stuff
);
2002 inhibit_sentinels
= 1;
2003 kill_buffer_processes (Qnil
);
2004 Fdo_auto_save (Qt
, Qnil
);
2006 unlock_all_files ();
2008 /* There is a tendency for a SIGIO signal to arrive within exit,
2009 and cause a SIGHUP because the input descriptor is already closed. */
2013 /* Do this only if terminating normally, we want glyph matrices
2014 etc. in a core dump. */
2015 if (sig
== 0 || sig
== SIGTERM
)
2017 check_glyph_memory ();
2018 check_message_stack ();
2026 ns_term_shutdown (sig
);
2030 xml_cleanup_parser ();
2044 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2045 doc
: /* Dump current state of Emacs into executable file FILENAME.
2046 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2047 This is used in the file `loadup.el' when building Emacs.
2049 You must run Emacs in batch mode in order to dump it. */)
2050 (Lisp_Object filename
, Lisp_Object symfile
)
2054 ptrdiff_t count
= SPECPDL_INDEX ();
2058 if (! noninteractive
)
2059 error ("Dumping Emacs works only in batch mode");
2062 error ("Emacs can be dumped only once");
2066 /* Warn if the gap between BSS end and heap start is larger than this. */
2067 # define MAX_HEAP_BSS_DIFF (1024*1024)
2069 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2071 fprintf (stderr
, "**************************************************\n");
2072 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2073 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2075 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2076 fprintf (stderr
, "fail because of this. See the section about\n");
2077 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2078 fprintf (stderr
, "**************************************************\n");
2080 #endif /* GNU_LINUX */
2082 /* Bind `command-line-processed' to nil before dumping,
2083 so that the dumped Emacs will process its command line
2084 and set up to work with X windows if appropriate. */
2085 symbol
= intern ("command-line-processed");
2086 specbind (symbol
, Qnil
);
2088 CHECK_STRING (filename
);
2089 filename
= Fexpand_file_name (filename
, Qnil
);
2090 filename
= ENCODE_FILE (filename
);
2091 if (!NILP (symfile
))
2093 CHECK_STRING (symfile
);
2094 if (SCHARS (symfile
))
2096 symfile
= Fexpand_file_name (symfile
, Qnil
);
2097 symfile
= ENCODE_FILE (symfile
);
2102 Vpurify_flag
= Qnil
;
2105 /* Tell malloc where start of impure now is. */
2106 /* Also arrange for warnings when nearly out of space. */
2107 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2109 /* On Windows, this was done before dumping, and that once suffices.
2110 Meanwhile, my_edata is not valid on Windows. */
2111 memory_warnings (my_edata
, malloc_warning
);
2112 #endif /* not WINDOWSNT */
2113 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2114 #ifdef DOUG_LEA_MALLOC
2115 malloc_state_ptr
= malloc_get_state ();
2118 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2120 #ifdef DOUG_LEA_MALLOC
2121 free (malloc_state_ptr
);
2125 Vlibrary_cache
= Qnil
;
2127 #ifdef HAVE_WINDOW_SYSTEM
2128 reset_image_types ();
2133 return unbind_to (count
, Qnil
);
2136 #endif /* not CANNOT_DUMP */
2139 /* Recover from setlocale (LC_ALL, ""). */
2143 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2144 so that numbers are read and printed properly for Emacs Lisp. */
2145 setlocale (LC_NUMERIC
, "C");
2148 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2151 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2153 if (! EQ (*plocale
, desired_locale
))
2155 *plocale
= desired_locale
;
2156 setlocale (category
, (STRINGP (desired_locale
)
2157 ? SSDATA (desired_locale
)
2162 /* Set system time locale to match Vsystem_time_locale, if possible. */
2164 synchronize_system_time_locale (void)
2166 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2167 Vsystem_time_locale
);
2170 /* Set system messages locale to match Vsystem_messages_locale, if
2173 synchronize_system_messages_locale (void)
2176 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2177 Vsystem_messages_locale
);
2180 #endif /* HAVE_SETLOCALE */
2184 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2186 const char *path
, *p
;
2187 Lisp_Object lpath
, element
, tem
;
2188 /* Default is to use "." for empty path elements.
2189 But if argument EMPTY is true, use nil instead. */
2190 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2193 static const char *emacs_dir_env
= "%emacs_dir%/";
2194 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2195 const char *edir
= egetenv ("emacs_dir");
2196 char emacs_dir
[MAX_UTF8_PATH
];
2198 /* egetenv looks in process-environment, which holds the variables
2199 in their original system-locale encoding. We need emacs_dir to
2202 filename_from_ansi (edir
, emacs_dir
);
2205 /* It's okay to use getenv here, because this function is only used
2206 to initialize variables when Emacs starts up, and isn't called
2209 path
= getenv (evarname
);
2220 /* Ensure values from the environment use the proper directory separator. */
2226 char *path_utf8
, *q
, *d
;
2229 /* Convert each element of PATH to UTF-8. */
2230 p
= path_copy
= alloca (strlen (path
) + 1);
2231 strcpy (path_copy
, path
);
2232 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2235 q
= _mbschr (p
, SEPCHAR
);
2238 cnv_result
= filename_from_ansi (p
, d
);
2243 /* If conversion of this PATH elements fails, make sure
2244 destination pointer will stay put, thus effectively
2245 ignoring the offending element. */
2246 if (cnv_result
== 0)
2252 else if (cnv_result
!= 0 && d
> path_utf8
)
2253 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2255 path_copy
= path_utf8
;
2257 path_copy
= alloca (strlen (path
) + 1);
2258 strcpy (path_copy
, path
);
2260 dostounix_filename (path_copy
);
2267 p
= strchr (path
, SEPCHAR
);
2269 p
= path
+ strlen (path
);
2270 element
= (p
- path
? make_unibyte_string (path
, p
- path
)
2272 if (! NILP (element
))
2275 /* Relative file names in the default path are interpreted as
2276 being relative to $emacs_dir. */
2277 if (edir
&& defaulted
2278 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2279 element
= Fexpand_file_name (Fsubstring
2281 make_number (emacs_dir_len
),
2283 build_unibyte_string (emacs_dir
));
2286 /* Add /: to the front of the name
2287 if it would otherwise be treated as magic. */
2288 tem
= Ffind_file_name_handler (element
, Qt
);
2290 /* However, if the handler says "I'm safe",
2291 don't bother adding /:. */
2295 prop
= Fget (tem
, intern ("safe-magic"));
2302 AUTO_STRING (slash_colon
, "/:");
2303 element
= concat2 (slash_colon
, element
);
2305 } /* !NILP (element) */
2307 lpath
= Fcons (element
, lpath
);
2313 return Fnreverse (lpath
);
2316 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2317 doc
: /* Return non-nil if the current emacs process is a daemon.
2318 If the daemon was given a name argument, return that name. */)
2323 return build_string (daemon_name
);
2330 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2331 doc
: /* Mark the Emacs daemon as being initialized.
2332 This finishes the daemonization process by doing the other half of detaching
2333 from the parent process and its tty file descriptors. */)
2340 error ("This function can only be called if emacs is run as a daemon");
2342 if (daemon_pipe
[1] < 0)
2343 error ("The daemon has already been initialized");
2345 if (NILP (Vafter_init_time
))
2346 error ("This function can only be called after loading the init files");
2348 /* Get rid of stdin, stdout and stderr. */
2349 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2351 err
|= dup2 (nfd
, 0) < 0;
2352 err
|= dup2 (nfd
, 1) < 0;
2353 err
|= dup2 (nfd
, 2) < 0;
2354 err
|= emacs_close (nfd
) != 0;
2356 /* Closing the pipe will notify the parent that it can exit.
2357 FIXME: In case some other process inherited the pipe, closing it here
2358 won't notify the parent because it's still open elsewhere, so we
2359 additionally send a byte, just to make sure the parent really exits.
2360 Instead, we should probably close the pipe in start-process and
2361 call-process to make sure the pipe is never inherited by
2363 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2364 err
|= emacs_close (daemon_pipe
[1]) != 0;
2365 /* Set it to an invalid value so we know we've already run this function. */
2366 daemon_pipe
[1] = -1;
2369 error ("I/O error during daemon initialization");
2374 syms_of_emacs (void)
2376 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2377 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2378 DEFSYM (Qkill_emacs
, "kill-emacs");
2379 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2382 defsubr (&Sdump_emacs
);
2385 defsubr (&Skill_emacs
);
2387 defsubr (&Sinvocation_name
);
2388 defsubr (&Sinvocation_directory
);
2389 defsubr (&Sdaemonp
);
2390 defsubr (&Sdaemon_initialized
);
2392 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2393 doc
: /* Args passed by shell to Emacs, as a list of strings.
2394 Many arguments are deleted from the list as they are processed. */);
2396 DEFVAR_LISP ("system-type", Vsystem_type
,
2397 doc
: /* The value is a symbol indicating the type of operating system you are using.
2399 `gnu' compiled for a GNU Hurd system.
2400 `gnu/linux' compiled for a GNU/Linux system.
2401 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2402 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2403 `ms-dos' compiled as an MS-DOS application.
2404 `windows-nt' compiled as a native W32 application.
2405 `cygwin' compiled using the Cygwin library.
2406 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2407 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2408 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2409 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2411 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2412 doc
: /* Value is string indicating configuration Emacs was built for.
2413 On MS-Windows, the value reflects the OS flavor and version on which
2414 Emacs is running. */);
2415 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2417 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2418 doc
: /* String containing the configuration options Emacs was built with. */);
2419 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2421 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2422 doc
: /* String listing some of the main features this Emacs was compiled with.
2423 An element of the form \"FOO\" generally means that HAVE_FOO was
2424 defined during the build. */);
2425 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2427 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2428 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2430 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2431 doc
: /* Hook run when `kill-emacs' is called.
2432 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2433 in other similar situations), functions placed on this hook should not
2434 expect to be able to interact with the user. To ask for confirmation,
2435 see `kill-emacs-query-functions' instead.
2437 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2438 `noninteractive' was non-nil. */);
2439 Vkill_emacs_hook
= Qnil
;
2441 DEFVAR_LISP ("path-separator", Vpath_separator
,
2442 doc
: /* String containing the character that separates directories in
2443 search paths, such as PATH and other similar environment variables. */);
2446 Vpath_separator
= make_string (&c
, 1);
2449 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2450 doc
: /* The program name that was used to run Emacs.
2451 Any directory names are omitted. */);
2453 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2454 doc
: /* The directory in which the Emacs executable was found, to run it.
2455 The value is nil if that directory's name is not known. */);
2457 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2458 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2459 In an installed Emacs, this is normally nil. It is non-nil if
2460 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2461 within the variable `invocation-directory' or its parent. For example,
2462 this is the case when running an uninstalled Emacs executable from its
2463 build directory. */);
2464 Vinstallation_directory
= Qnil
;
2466 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2467 doc
: /* System locale for messages. */);
2468 Vsystem_messages_locale
= Qnil
;
2470 DEFVAR_LISP ("previous-system-messages-locale",
2471 Vprevious_system_messages_locale
,
2472 doc
: /* Most recently used system locale for messages. */);
2473 Vprevious_system_messages_locale
= Qnil
;
2475 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2476 doc
: /* System locale for time. */);
2477 Vsystem_time_locale
= Qnil
;
2479 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2480 doc
: /* Most recently used system locale for time. */);
2481 Vprevious_system_time_locale
= Qnil
;
2483 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2484 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2485 Vbefore_init_time
= Qnil
;
2487 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2488 doc
: /* Value of `current-time' after loading the init files.
2489 This is nil during initialization. */);
2490 Vafter_init_time
= Qnil
;
2492 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2493 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2494 inhibit_x_resources
= 0;
2496 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2497 doc
: /* Short copyright string for this version of Emacs. */);
2498 Vemacs_copyright
= build_string (emacs_copyright
);
2500 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2501 doc
: /* Version numbers of this version of Emacs. */);
2502 Vemacs_version
= build_string (emacs_version
);
2504 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2505 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2506 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2508 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2509 doc
: /* Alist of dynamic libraries vs external files implementing them.
2510 Each element is a list (LIBRARY FILE...), where the car is a symbol
2511 representing a supported external library, and the rest are strings giving
2512 alternate filenames for that library.
2514 Emacs tries to load the library from the files in the order they appear on
2515 the list; if none is loaded, the running session of Emacs won't have access
2518 Note that image types `pbm' and `xbm' do not need entries in this variable
2519 because they do not depend on external libraries and are always available.
2521 Also note that this is not a generic facility for accessing external
2522 libraries; only those already known by Emacs will be loaded. */);
2523 Vdynamic_library_alist
= Qnil
;
2524 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2527 Vlibrary_cache
= Qnil
;
2528 staticpro (&Vlibrary_cache
);