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 */
63 #include "intervals.h"
64 #include "character.h"
70 #include "blockinput.h"
71 #include "syssignal.h"
74 #include "termhooks.h"
79 #include "composite.h"
80 #include "dispextern.h"
83 #include "sysselect.h"
88 #if (defined PROFILING \
89 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
90 # include <sys/gmon.h>
91 extern void moncontrol (int mode
);
100 #include <sys/resource.h>
103 #ifdef HAVE_PERSONALITY_LINUX32
104 #include <sys/personality.h>
107 static const char emacs_version
[] = PACKAGE_VERSION
;
108 static const char emacs_copyright
[] = COPYRIGHT
;
109 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
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. */
124 /* Set to true if this instance of Emacs might dump. */
128 extern void unexec_init_emacs_zone (void);
131 #ifdef DOUG_LEA_MALLOC
132 /* Preserves a pointer to the memory allocated that copies that
133 static data inside glibc's malloc. */
134 static void *malloc_state_ptr
;
135 /* From glibc, a routine that returns a copy of the malloc internal state. */
136 extern void *malloc_get_state (void);
137 /* From glibc, a routine that overwrites the malloc internal state. */
138 extern int malloc_set_state (void *);
139 /* True if the MALLOC_CHECK_ environment variable was set while
140 dumping. Used to work around a bug in glibc's malloc. */
141 static bool malloc_using_checking
;
142 #elif defined HAVE_PTHREAD && !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
143 extern void malloc_enable_thread (void);
146 /* If true, Emacs should not attempt to use a window-specific code,
147 but instead should use the virtual terminal under which it was started. */
148 bool inhibit_window_system
;
150 /* If true, a filter or a sentinel is running. Tested to save the match
151 data on the first attempt to change it inside asynchronous code. */
152 bool running_asynch_code
;
154 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
155 /* If true, -d was specified, meaning we're using some window system. */
159 /* An address near the bottom of the stack.
160 Tells GC how to save a copy of the stack. */
163 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
164 /* The address where the heap starts (from the first sbrk (0) call). */
165 static void *my_heap_start
;
169 /* The gap between BSS end and heap start as far as we can tell. */
170 static uprintmax_t heap_bss_diff
;
173 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
176 On Cocoa, CoreFoundation lib fails in forked process:
177 http://developer.apple.com/ReleaseNotes/
178 CoreFoundation/CoreFoundation.html)
180 On Windows, a Cygwin fork child cannot access the USER subsystem.
182 We mark being in the exec'd process by a daemon name argument of
183 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
184 NAME is the original daemon name, if any. */
185 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
186 # define DAEMON_MUST_EXEC
189 /* True means running Emacs without interactive terminal. */
192 /* True means remove site-lisp directories from load-path. */
195 /* Name for the server started by the daemon.*/
196 static char *daemon_name
;
199 /* Pipe used to send exit notification to the daemon parent at
203 HANDLE w32_daemon_event
;
206 /* Save argv and argc. */
210 static void sort_args (int argc
, char **argv
);
211 static void syms_of_emacs (void);
213 /* C99 needs each string to be at most 4095 characters, and 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-loadup, -nl do not load loadup.el into bare Emacs\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 " PACKAGE_BUGREPORT
". 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
);
353 /* If fatal error occurs in code below, avoid infinite recursion. */
354 if (! fatal_error_in_progress
)
356 fatal_error_in_progress
= 1;
358 totally_unblock_input ();
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
;
393 AUTO_STRING (slash_colon
, "/:");
399 /* Must use argv[0] converted to UTF-8, as it begets many standard
400 file and directory names. */
402 char argv0
[MAX_UTF8_PATH
];
404 if (filename_from_ansi (argv
[0], argv0
) == 0)
405 raw_name
= build_unibyte_string (argv0
);
407 raw_name
= build_unibyte_string (argv
[0]);
410 raw_name
= build_unibyte_string (argv
[0]);
413 /* Add /: to the front of the name
414 if it would otherwise be treated as magic. */
415 handler
= Ffind_file_name_handler (raw_name
, Qt
);
416 if (! NILP (handler
))
417 raw_name
= concat2 (slash_colon
, raw_name
);
419 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
420 Vinvocation_directory
= Ffile_name_directory (raw_name
);
422 /* If we got no directory in argv[0], search PATH to find where
423 Emacs actually came from. */
424 if (NILP (Vinvocation_directory
))
427 int yes
= openp (Vexec_path
, Vinvocation_name
,
428 Vexec_suffixes
, &found
, make_number (X_OK
), false);
431 /* Add /: to the front of the name
432 if it would otherwise be treated as magic. */
433 handler
= Ffind_file_name_handler (found
, Qt
);
434 if (! NILP (handler
))
435 found
= concat2 (slash_colon
, found
);
436 Vinvocation_directory
= Ffile_name_directory (found
);
440 if (!NILP (Vinvocation_directory
)
441 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
442 /* Emacs was started with relative path, like ./emacs.
446 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
448 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
451 Vinstallation_directory
= Qnil
;
453 if (!NILP (Vinvocation_directory
))
455 dir
= Vinvocation_directory
;
457 /* If we are running from the build directory, set DIR to the
458 src subdirectory of the Emacs tree, like on Posix
460 if (SBYTES (dir
) > sizeof ("/i386/") - 1
461 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
463 dir
= Fexpand_file_name (build_string ("../.."), dir
);
464 #else /* !WINDOWSNT */
466 name
= Fexpand_file_name (Vinvocation_name
, dir
);
469 Lisp_Object tem
, lib_src_exists
;
470 Lisp_Object etc_exists
, info_exists
;
472 /* See if dir contains subdirs for use by Emacs.
473 Check for the ones that would exist in a build directory,
474 not including lisp and info. */
475 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
476 lib_src_exists
= Ffile_exists_p (tem
);
479 /* MSDOS installations frequently remove lib-src, but we still
480 must set installation-directory, or else info won't find
481 its files (it uses the value of installation-directory). */
482 tem
= Fexpand_file_name (build_string ("info"), dir
);
483 info_exists
= Ffile_exists_p (tem
);
488 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
490 tem
= Fexpand_file_name (build_string ("etc"), dir
);
491 etc_exists
= Ffile_exists_p (tem
);
492 if (!NILP (etc_exists
))
494 Vinstallation_directory
495 = Ffile_name_as_directory (dir
);
500 /* See if dir's parent contains those subdirs. */
501 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
502 lib_src_exists
= Ffile_exists_p (tem
);
506 /* See the MSDOS commentary above. */
507 tem
= Fexpand_file_name (build_string ("../info"), dir
);
508 info_exists
= Ffile_exists_p (tem
);
513 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
515 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
516 etc_exists
= Ffile_exists_p (tem
);
517 if (!NILP (etc_exists
))
519 tem
= Fexpand_file_name (build_string (".."), dir
);
520 Vinstallation_directory
521 = Ffile_name_as_directory (tem
);
526 /* If the Emacs executable is actually a link,
527 next try the dir that the link points into. */
528 tem
= Ffile_symlink_p (name
);
531 name
= Fexpand_file_name (tem
, dir
);
532 dir
= Ffile_name_directory (name
);
539 Vcommand_line_args
= Qnil
;
541 for (i
= argc
- 1; i
>= 0; i
--)
543 if (i
== 0 || i
> skip_args
)
544 /* For the moment, we keep arguments as is in unibyte strings.
545 They are decoded in the function command-line after we know
546 locale-coding-system. */
548 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
551 unbind_to (count
, Qnil
);
554 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
555 doc
: /* Return the program name that was used to run Emacs.
556 Any directory names are omitted. */)
559 return Fcopy_sequence (Vinvocation_name
);
562 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
564 doc
: /* Return the directory name in which the Emacs executable was located. */)
567 return Fcopy_sequence (Vinvocation_directory
);
571 /* Test whether the next argument in ARGV matches SSTR or a prefix of
572 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
573 (the argument is supposed to have a value) store in *VALPTR either
574 the next argument or the portion of this one after the equal sign.
575 ARGV is read starting at position *SKIPPTR; this index is advanced
576 by the number of arguments used.
578 Too bad we can't just use getopt for all of this, but we don't have
579 enough information to do it right. */
582 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
583 int minlen
, char **valptr
, int *skipptr
)
589 /* Don't access argv[argc]; give up in advance. */
590 if (argc
<= *skipptr
+ 1)
593 arg
= argv
[*skipptr
+1];
596 if (strcmp (arg
, sstr
) == 0)
600 *valptr
= argv
[*skipptr
+2];
607 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
608 ? p
- arg
: strlen (arg
));
609 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
611 else if (valptr
== NULL
)
622 else if (argv
[*skipptr
+2] != NULL
)
624 *valptr
= argv
[*skipptr
+2];
634 #ifdef DOUG_LEA_MALLOC
636 /* malloc can be invoked even before main (e.g. by the dynamic
637 linker), so the dumped malloc state must be restored as early as
638 possible using this special hook. */
641 malloc_initialize_hook (void)
645 if (!malloc_using_checking
)
646 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
647 ignored if the heap to be restored was constructed without
648 malloc checking. Can't use unsetenv, since that calls malloc. */
652 for (p
= environ
; p
&& *p
; p
++)
653 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
662 malloc_set_state (malloc_state_ptr
);
663 #ifndef XMALLOC_OVERRUN_CHECK
664 free (malloc_state_ptr
);
669 if (my_heap_start
== 0)
670 my_heap_start
= sbrk (0);
671 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
675 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
677 #endif /* DOUG_LEA_MALLOC */
679 /* Close standard output and standard error, reporting any write
680 errors as best we can. This is intended for use with atexit. */
682 close_output_streams (void)
684 if (close_stream (stdout
) != 0)
686 emacs_perror ("Write error to standard output");
687 _exit (EXIT_FAILURE
);
690 if (close_stream (stderr
) != 0)
691 _exit (EXIT_FAILURE
);
696 main (int argc
, char **argv
)
701 char stack_bottom_variable
;
702 bool do_initial_setlocale
;
705 #ifdef HAVE_SETRLIMIT
711 #ifdef DAEMON_MUST_EXEC
716 /* If we use --chdir, this records the original directory. */
717 char *original_pwd
= 0;
724 might_dump
= !initialized
;
730 if (my_heap_start
== 0)
731 my_heap_start
= sbrk (0);
733 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
737 #if defined WINDOWSNT || defined HAVE_NTGUI
738 /* Set global variables used to detect Windows version. Do this as
739 early as possible. (unexw32.c calls this function as well, but
740 the additional call here is harmless.) */
741 cache_system_info ();
743 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
744 to have non-stub implementations of APIs we need to convert file
745 names between UTF-8 and the system's ANSI codepage. */
746 maybe_load_unicows_dll ();
750 #ifdef RUN_TIME_REMAP
752 run_time_remap (argv
[0]);
755 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
758 unexec_init_emacs_zone ();
761 atexit (close_output_streams
);
763 sort_args (argc
, argv
);
765 while (argv
[argc
]) argc
++;
767 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
769 const char *version
, *copyright
;
772 Lisp_Object tem
, tem2
;
773 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
774 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
777 fprintf (stderr
, "Invalid value of `emacs-version'\n");
782 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
787 version
= SSDATA (tem
);
788 copyright
= SSDATA (tem2
);
793 version
= emacs_version
;
794 copyright
= emacs_copyright
;
796 printf ("%s %s\n", PACKAGE_NAME
, version
);
797 printf ("%s\n", copyright
);
798 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
799 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
800 printf ("under the terms of the GNU General Public License.\n");
801 printf ("For more information about these matters, ");
802 printf ("see the file named COPYING.\n");
806 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
809 /* argv[] array is kept in its original ANSI codepage encoding,
810 we need to convert to UTF-8, for chdir to work. */
811 char newdir
[MAX_UTF8_PATH
];
813 filename_from_ansi (ch_to_dir
, newdir
);
816 original_pwd
= get_current_dir_name ();
817 if (chdir (ch_to_dir
) != 0)
819 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
820 argv
[0], ch_to_dir
, strerror (errno
));
825 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
826 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
828 #ifdef HAVE_PERSONALITY_LINUX32
829 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
831 /* Set this so we only do this once. */
832 xputenv ("EMACS_HEAP_EXEC=true");
834 /* A flag to turn off address randomization which is introduced
835 in linux kernel shipped with fedora core 4 */
836 #define ADD_NO_RANDOMIZE 0x0040000
837 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
838 #undef ADD_NO_RANDOMIZE
840 execvp (argv
[0], argv
);
842 /* If the exec fails, try to dump anyway. */
843 emacs_perror (argv
[0]);
845 #endif /* HAVE_PERSONALITY_LINUX32 */
847 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
848 /* Extend the stack space available.
849 Don't do that if dumping, since some systems (e.g. DJGPP)
850 might define a smaller stack limit at that time. */
853 && (!noninteractive
|| initialized
)
855 && !getrlimit (RLIMIT_STACK
, &rlim
))
858 /* Approximate the amount regex.c needs per unit of re_max_failures. */
859 int ratio
= 20 * sizeof (char *);
860 /* Then add 33% to cover the size of the smaller stacks that regex.c
861 successively allocates and discards, on its way to the maximum. */
863 /* Add in some extra to cover
864 what we're likely to use for other reasons. */
865 newlim
= re_max_failures
* ratio
+ 200000;
867 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
868 stack allocation routine for new process that the allocation
869 fails if stack limit is not on page boundary. So, round up the
870 new limit to page boundary. */
871 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
873 if (newlim
> rlim
.rlim_max
)
875 newlim
= rlim
.rlim_max
;
876 /* Don't let regex.c overflow the stack we have. */
877 re_max_failures
= (newlim
- 200000) / ratio
;
879 if (rlim
.rlim_cur
< newlim
)
880 rlim
.rlim_cur
= newlim
;
882 setrlimit (RLIMIT_STACK
, &rlim
);
884 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
886 /* Record (approximately) where the stack begins. */
887 stack_bottom
= &stack_bottom_variable
;
891 emacs_backtrace (-1);
893 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
894 /* Arrange to get warning messages as memory fills up. */
895 memory_warnings (0, malloc_warning
);
897 /* Call malloc at least once, to run malloc_initialize_hook.
898 Also call realloc and free for consistency. */
899 free (realloc (malloc (4), 4));
901 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
904 SET_BINARY (fileno (stdin
));
906 SET_BINARY (fileno (stdout
));
909 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
910 The build procedure uses this while dumping, to ensure that the
911 dumped Emacs does not have its system locale tables initialized,
912 as that might cause screwups when the dumped Emacs starts up. */
914 char *lc_all
= getenv ("LC_ALL");
915 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
918 /* Set locale now, so that initial error messages are localized properly.
919 fixup_locale must wait until later, since it builds strings. */
920 if (do_initial_setlocale
)
921 setlocale (LC_ALL
, "");
923 inhibit_window_system
= 0;
925 /* Handle the -t switch, which specifies filename to use as terminal. */
929 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
934 result
= emacs_open (term
, O_RDWR
, 0);
935 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
937 char *errstring
= strerror (errno
);
938 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
943 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
946 fprintf (stderr
, "Using %s\n", term
);
947 #ifdef HAVE_WINDOW_SYSTEM
948 inhibit_window_system
= 1; /* -t => -nw */
955 /* Command line option --no-windows is deprecated and thus not mentioned
956 in the manual and usage information. */
957 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
958 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
959 inhibit_window_system
= 1;
961 /* Handle the -batch switch, which means don't do interactive display. */
963 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
966 Vundo_outer_limit
= Qnil
;
968 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
970 noninteractive
= 1; /* Set batch mode. */
971 /* Convert --script to -scriptload, un-skip it, and sort again
972 so that it will be handled in proper sequence. */
973 /* FIXME broken for --script=FILE - is that supposed to work? */
974 argv
[skip_args
- 1] = (char *) "-scriptload";
976 sort_args (argc
, argv
);
979 /* Handle the --help option, which gives a usage message. */
980 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
983 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
984 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
985 fputs (usage_message
[i
], stdout
);
990 /* Make sure IS_DAEMON starts up as false. */
993 w32_daemon_event
= NULL
;
996 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
997 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1002 /* Start as a daemon: fork a new child process which will run the
1003 rest of the initialization code, then exit.
1005 Detaching a daemon requires the following steps:
1009 - close the tty file-descriptors
1011 We only want to do the last 2 steps once the daemon is ready to
1012 serve requests, i.e. after loading .emacs (initialization).
1013 OTOH initialization may start subprocesses (e.g. ispell) and these
1014 should be run from the proper process (the one that will end up
1015 running as daemon) and with the proper "session id" in order for
1016 them to keep working after detaching, so fork and setsid need to be
1017 performed before initialization.
1019 We want to avoid exiting before the server socket is ready, so
1020 use a pipe for synchronization. The parent waits for the child
1021 to close its end of the pipe (using `daemon-initialized')
1023 if (emacs_pipe (daemon_pipe
) != 0)
1025 fprintf (stderr
, "Cannot pipe!\n");
1029 #ifndef DAEMON_MUST_EXEC
1031 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1032 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1033 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1034 #endif /* USE_GTK */
1036 #else /* DAEMON_MUST_EXEC */
1037 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1038 f
= fork (); /* in orig */
1040 f
= 0; /* in exec'd */
1041 #endif /* !DAEMON_MUST_EXEC */
1047 /* Close unused writing end of the pipe. */
1048 emacs_close (daemon_pipe
[1]);
1050 /* Just wait for the child to close its end of the pipe. */
1053 retval
= read (daemon_pipe
[0], &buf
, 1);
1055 while (retval
== -1 && errno
== EINTR
);
1059 fprintf (stderr
, "Error reading status from child\n");
1062 else if (retval
== 0)
1064 fprintf (stderr
, "Error: server did not start correctly\n");
1068 emacs_close (daemon_pipe
[0]);
1073 emacs_perror ("fork");
1074 exit (EXIT_CANCELED
);
1077 #ifdef DAEMON_MUST_EXEC
1079 /* In orig process, forked as child, OR in exec'd. */
1080 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1081 { /* In orig, child: now exec w/special daemon name. */
1084 snprintf (fdStr
, sizeof fdStr
,
1085 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1086 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1088 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1090 fprintf (stderr
, "daemon: child name too long\n");
1091 exit (EXIT_CANNOT_INVOKE
);
1094 argv
[skip_args
] = fdStr
;
1096 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1097 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1098 execvp (argv
[0], argv
);
1099 emacs_perror (argv
[0]);
1100 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1103 /* In exec'd: parse special dname into pipe and name info. */
1104 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1105 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1107 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1108 exit (EXIT_CANNOT_INVOKE
);
1110 dname_arg2
[0] = '\0';
1111 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1113 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1114 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1116 #endif /* DAEMON_MUST_EXEC */
1118 /* Close unused reading end of the pipe. */
1119 emacs_close (daemon_pipe
[0]);
1122 #elif defined(WINDOWSNT)
1123 /* Indicate that we want daemon mode. */
1124 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1125 if (w32_daemon_event
== NULL
)
1127 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1132 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1136 daemon_name
= xstrdup (dname_arg
);
1139 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1140 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1141 # ifndef CANNOT_DUMP
1142 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1143 that causes an infinite recursive loop with FreeBSD. See
1144 Bug#14569. The part of this bug involving Cygwin is no longer
1145 relevant, now that Cygwin defines HYBRID_MALLOC. */
1146 if (!noninteractive
|| initialized
)
1148 malloc_enable_thread ();
1151 init_signals (dumping
);
1153 noninteractive1
= noninteractive
;
1155 /* Perform basic initializations (not merely interning symbols). */
1162 init_charset_once ();
1163 init_coding_once ();
1164 init_syntax_once (); /* Create standard syntax table. */
1165 init_category_once (); /* Create standard category table. */
1166 init_casetab_once (); /* Must be done before init_buffer_once. */
1167 init_buffer_once (); /* Create buffer table and some buffers. */
1168 init_minibuf_once (); /* Create list of minibuffers. */
1169 /* Must precede init_window_once. */
1171 /* Call syms_of_xfaces before init_window_once because that
1172 function creates Vterminal_frame. Termcap frames now use
1173 faces, and the face implementation uses some symbols as
1176 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1177 be better to arrange things not to have this dependency. */
1179 /* Call syms_of_keyboard before init_window_once because
1180 keyboard sets up symbols that include some face names that
1181 the X support will want to use. This can happen when
1182 CANNOT_DUMP is defined. */
1183 syms_of_keyboard ();
1185 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1187 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1189 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1191 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1193 /* Before syms_of_coding because it initializes Qcharsetp. */
1195 /* Before init_window_once, because it sets up the
1196 Vcoding_system_hash_table. */
1197 syms_of_coding (); /* This should be after syms_of_fileio. */
1199 init_window_once (); /* Init the window system. */
1200 #ifdef HAVE_WINDOW_SYSTEM
1201 init_fringe_once (); /* Swap bitmaps if necessary. */
1202 #endif /* HAVE_WINDOW_SYSTEM */
1207 if (do_initial_setlocale
)
1210 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1211 Vsystem_time_locale
= Vprevious_system_time_locale
;
1216 running_asynch_code
= 0;
1220 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1223 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1226 ns_pool
= ns_alloc_autorelease_pool ();
1227 #ifdef NS_IMPL_GNUSTEP
1228 /* GNUstep stupidly resets our locale settings after we made them. */
1232 if (!noninteractive
)
1234 #ifdef NS_IMPL_COCOA
1235 /* Started from GUI? */
1236 /* FIXME: Do the right thing if getenv returns NULL, or if
1238 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1239 chdir (getenv ("HOME"));
1240 if (skip_args
< argc
)
1242 if (!strncmp (argv
[skip_args
], "-psn", 4))
1245 if (! ch_to_dir
) chdir (getenv ("HOME"));
1247 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1250 if (! ch_to_dir
) chdir (getenv ("HOME"));
1255 #endif /* HAVE_NS */
1257 #ifdef HAVE_X_WINDOWS
1258 /* Stupid kludge to catch command-line display spec. We can't
1259 handle this argument entirely in window system dependent code
1260 because we don't even know which window system dependent code
1261 to run until we've recognized this argument. */
1263 char *displayname
= 0;
1264 int count_before
= skip_args
;
1266 /* Skip any number of -d options, but only use the last one. */
1269 int count_before_this
= skip_args
;
1271 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1273 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1278 count_before
= count_before_this
;
1281 /* If we have the form --display=NAME,
1282 convert it into -d name.
1283 This requires inserting a new element into argv. */
1284 if (displayname
&& count_before
< skip_args
)
1286 if (skip_args
== count_before
+ 1)
1288 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1289 (argc
- (count_before
+ 2)) * sizeof *argv
);
1290 argv
[count_before
+ 2] = displayname
;
1293 argv
[count_before
+ 1] = (char *) "-d";
1298 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1299 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1303 /* Don't actually discard this arg. */
1304 skip_args
= count_before
;
1306 #else /* !HAVE_X_WINDOWS */
1309 int count_before
= skip_args
;
1311 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1312 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1315 skip_args
= count_before
;
1319 /* argmatch must not be used after here,
1320 except when building temacs
1321 because the -d argument has not been skipped in skip_args. */
1324 /* Call early 'cause init_environment needs it. */
1326 /* Set defaults for several environment variables. */
1328 init_environment (argc
, argv
, skip_args
);
1333 #ifdef HAVE_GFILENOTIFY
1334 globals_of_gfilenotify ();
1339 #ifdef HAVE_W32NOTIFY
1340 globals_of_w32notify ();
1342 /* Initialize environment from registry settings. */
1343 init_environment (argv
);
1344 init_ntproc (dumping
); /* must precede init_editfns. */
1347 /* Initialize and GC-protect Vinitial_environment and
1348 Vprocess_environment before set_initial_environment fills them
1351 syms_of_callproc ();
1352 /* egetenv is a pretty low-level facility, which may get called in
1353 many circumstances; it seems flimsy to put off initializing it
1354 until calling init_callproc. Do not do it when dumping. */
1356 set_initial_environment ();
1358 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1359 if this is not done. Do it after set_global_environment so that we
1360 don't pollute Vglobal_environment. */
1361 /* Setting LANG here will defeat the startup locale processing... */
1366 /* Init buffer storage and default directory of main buffer. */
1367 init_buffer (initialized
);
1369 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1371 /* Must precede init_lread. */
1372 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1376 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1377 Lisp_Object old_log_max
;
1378 old_log_max
= Vmessage_log_max
;
1379 XSETFASTINT (Vmessage_log_max
, 0);
1380 message_dolog ("", 0, 1, 0);
1381 Vmessage_log_max
= old_log_max
;
1384 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1388 /* Check to see if Emacs has been installed correctly. */
1389 check_windows_init_file ();
1392 /* Intern the names of all standard functions and variables;
1393 define standard keys. */
1397 /* The basic levels of Lisp must come first. Note that
1398 syms_of_data and some others have already been called. */
1403 syms_of_floatfns ();
1406 syms_of_bytecode ();
1408 syms_of_casefiddle ();
1410 syms_of_category ();
1412 syms_of_character ();
1419 syms_of_filelock ();
1422 /* syms_of_keymap (); */
1430 syms_of_terminal ();
1436 syms_of_textprop ();
1437 syms_of_composite ();
1440 #endif /* WINDOWSNT */
1447 #ifdef HAVE_WINDOW_SYSTEM
1450 #endif /* HAVE_WINDOW_SYSTEM */
1451 #ifdef HAVE_X_WINDOWS
1456 syms_of_xsettings ();
1463 #endif /* HAVE_X_WINDOWS */
1470 syms_of_decompress ();
1480 #endif /* HAVE_NTGUI */
1482 #if defined WINDOWSNT || defined HAVE_NTGUI
1483 syms_of_w32select ();
1490 syms_of_win16select ();
1497 syms_of_nsselect ();
1499 #endif /* HAVE_NS */
1503 #ifdef HAVE_GFILENOTIFY
1504 syms_of_gfilenotify ();
1505 #endif /* HAVE_GFILENOTIFY */
1509 #endif /* HAVE_INOTIFY */
1512 syms_of_dbusbind ();
1513 #endif /* HAVE_DBUS */
1517 #ifdef HAVE_W32NOTIFY
1518 syms_of_w32notify ();
1519 #endif /* HAVE_W32NOTIFY */
1520 #endif /* WINDOWSNT */
1522 syms_of_profiler ();
1524 keys_of_casefiddle ();
1527 keys_of_keyboard ();
1533 /* Initialization that must be done even if the global variable
1534 initialized is non zero. */
1536 globals_of_w32font ();
1537 globals_of_w32fns ();
1538 globals_of_w32menu ();
1539 #endif /* HAVE_NTGUI */
1541 #if defined WINDOWSNT || defined HAVE_NTGUI
1542 globals_of_w32select ();
1548 /* This calls putenv and so must precede init_process_emacs. Also,
1549 it sets Voperating_system_release, which init_process_emacs uses. */
1552 /* These two call putenv. */
1560 /* This can create a thread that may call getenv, so it must follow
1561 all calls to putenv and setenv. Also, this sets up
1562 add_keyboard_wait_descriptor, which init_display uses. */
1563 init_process_emacs ();
1565 init_keyboard (); /* This too must precede init_sys_modes. */
1566 if (!noninteractive
)
1567 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1570 init_crit (); /* w32notify.c needs this in batch mode. */
1571 #endif /* HAVE_W32NOTIFY */
1573 #ifdef HAVE_WINDOW_SYSTEM
1575 #endif /* HAVE_WINDOW_SYSTEM */
1583 /* Handle -l loadup, args passed by Makefile. */
1584 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1587 char file_utf8
[MAX_UTF8_PATH
];
1589 if (filename_from_ansi (file
, file_utf8
) == 0)
1592 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1594 /* Unless next switch is -nl, load "loadup.el" first thing. */
1596 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1599 /* Set up for profiling. This is known to work on FreeBSD,
1600 GNU/Linux and MinGW. It might work on some other systems too.
1601 Give it a try and tell us if it works on your system. To compile
1602 for profiling, use the configure option --enable-profiling. */
1603 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1608 extern unsigned char etext
asm ("etext");
1614 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1623 /* Enter editor command loop. This never returns. */
1629 /* Sort the args so we can find the most important ones
1630 at the beginning of argv. */
1632 /* First, here's a table of all the standard options. */
1634 struct standard_args
1637 const char *longname
;
1642 static const struct standard_args standard_args
[] =
1644 { "-version", "--version", 150, 0 },
1645 { "-chdir", "--chdir", 130, 1 },
1646 { "-t", "--terminal", 120, 1 },
1647 { "-nw", "--no-window-system", 110, 0 },
1648 { "-nw", "--no-windows", 110, 0 },
1649 { "-batch", "--batch", 100, 0 },
1650 { "-script", "--script", 100, 1 },
1651 { "-daemon", "--daemon", 99, 0 },
1652 { "-help", "--help", 90, 0 },
1653 { "-nl", "--no-loadup", 70, 0 },
1654 { "-nsl", "--no-site-lisp", 65, 0 },
1655 /* -d must come last before the options handled in startup.el. */
1656 { "-d", "--display", 60, 1 },
1657 { "-display", 0, 60, 1 },
1658 /* Now for the options handled in `command-line' (startup.el). */
1659 /* (Note that to imply -nsl, -Q is partially handled here.) */
1660 { "-Q", "--quick", 55, 0 },
1661 { "-quick", 0, 55, 0 },
1662 { "-q", "--no-init-file", 50, 0 },
1663 { "-no-init-file", 0, 50, 0 },
1664 { "-no-site-file", "--no-site-file", 40, 0 },
1665 { "-u", "--user", 30, 1 },
1666 { "-user", 0, 30, 1 },
1667 { "-debug-init", "--debug-init", 20, 0 },
1668 { "-iconic", "--iconic", 15, 0 },
1669 { "-D", "--basic-display", 12, 0},
1670 { "-basic-display", 0, 12, 0},
1671 { "-nbc", "--no-blinking-cursor", 12, 0 },
1672 /* Now for the options handled in `command-line-1' (startup.el). */
1673 { "-nbi", "--no-bitmap-icon", 10, 0 },
1674 { "-bg", "--background-color", 10, 1 },
1675 { "-background", 0, 10, 1 },
1676 { "-fg", "--foreground-color", 10, 1 },
1677 { "-foreground", 0, 10, 1 },
1678 { "-bd", "--border-color", 10, 1 },
1679 { "-bw", "--border-width", 10, 1 },
1680 { "-ib", "--internal-border", 10, 1 },
1681 { "-ms", "--mouse-color", 10, 1 },
1682 { "-cr", "--cursor-color", 10, 1 },
1683 { "-fn", "--font", 10, 1 },
1684 { "-font", 0, 10, 1 },
1685 { "-fs", "--fullscreen", 10, 0 },
1686 { "-fw", "--fullwidth", 10, 0 },
1687 { "-fh", "--fullheight", 10, 0 },
1688 { "-mm", "--maximized", 10, 0 },
1689 { "-g", "--geometry", 10, 1 },
1690 { "-geometry", 0, 10, 1 },
1691 { "-T", "--title", 10, 1 },
1692 { "-title", 0, 10, 1 },
1693 { "-name", "--name", 10, 1 },
1694 { "-xrm", "--xrm", 10, 1 },
1695 { "-parent-id", "--parent-id", 10, 1 },
1696 { "-r", "--reverse-video", 5, 0 },
1698 { "-reverse", 0, 5, 0 },
1699 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1700 { "-vb", "--vertical-scroll-bars", 5, 0 },
1701 { "-color", "--color", 5, 0},
1702 { "-no-splash", "--no-splash", 3, 0 },
1703 { "-no-desktop", "--no-desktop", 3, 0 },
1705 { "-NSAutoLaunch", 0, 5, 1 },
1706 { "-NXAutoLaunch", 0, 5, 1 },
1707 { "-_NSMachLaunch", 0, 85, 1 },
1708 { "-MachLaunch", 0, 85, 1 },
1709 { "-macosx", 0, 85, 0 },
1710 { "-NSHost", 0, 85, 1 },
1712 /* These have the same priority as ordinary file name args,
1713 so they are not reordered with respect to those. */
1714 { "-L", "--directory", 0, 1 },
1715 { "-directory", 0, 0, 1 },
1716 { "-l", "--load", 0, 1 },
1717 { "-load", 0, 0, 1 },
1718 /* This has no longname, because using --scriptload confuses sort_args,
1719 because then the --script long option seems to match twice; ie
1720 you can't have a long option which is a prefix of another long
1721 option. In any case, this is entirely an internal option. */
1722 { "-scriptload", NULL
, 0, 1 },
1723 { "-f", "--funcall", 0, 1 },
1724 { "-funcall", 0, 0, 1 },
1725 { "-eval", "--eval", 0, 1 },
1726 { "-execute", "--execute", 0, 1 },
1727 { "-find-file", "--find-file", 0, 1 },
1728 { "-visit", "--visit", 0, 1 },
1729 { "-file", "--file", 0, 1 },
1730 { "-insert", "--insert", 0, 1 },
1732 { "-NXOpen", 0, 0, 1 },
1733 { "-NXOpenTemp", 0, 0, 1 },
1734 { "-NSOpen", 0, 0, 1 },
1735 { "-NSOpenTemp", 0, 0, 1 },
1736 { "-GSFilePath", 0, 0, 1 },
1738 /* This should be processed after ordinary file name args and the like. */
1739 { "-kill", "--kill", -10, 0 },
1742 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1743 so that the highest priority ones come first.
1744 Do not change the order of elements of equal priority.
1745 If an option takes an argument, keep it and its argument together.
1747 If an option that takes no argument appears more
1748 than once, eliminate all but one copy of it. */
1751 sort_args (int argc
, char **argv
)
1753 char **new = xmalloc (argc
* sizeof *new);
1754 /* For each element of argv,
1755 the corresponding element of options is:
1756 0 for an option that takes no arguments,
1757 1 for an option that takes one argument, etc.
1758 -1 for an ordinary non-option argument. */
1759 int *options
= xnmalloc (argc
, sizeof *options
);
1760 int *priority
= xnmalloc (argc
, sizeof *priority
);
1762 int incoming_used
= 1;
1766 /* Categorize all the options,
1767 and figure out which argv elts are option arguments. */
1768 for (from
= 1; from
< argc
; from
++)
1772 if (argv
[from
][0] == '-')
1776 /* If we have found "--", don't consider
1777 any more arguments as options. */
1778 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1780 /* Leave the "--", and everything following it, at the end. */
1781 for (; from
< argc
; from
++)
1783 priority
[from
] = -100;
1789 /* Look for a match with a known old-fashioned option. */
1790 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1791 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1793 options
[from
] = standard_args
[i
].nargs
;
1794 priority
[from
] = standard_args
[i
].priority
;
1795 if (from
+ standard_args
[i
].nargs
>= argc
)
1796 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1797 from
+= standard_args
[i
].nargs
;
1801 /* Look for a match with a known long option.
1802 MATCH is -1 if no match so far, -2 if two or more matches so far,
1803 >= 0 (the table index of the match) if just one match so far. */
1804 if (argv
[from
][1] == '-')
1806 char const *equals
= strchr (argv
[from
], '=');
1808 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1812 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1813 if (standard_args
[i
].longname
1814 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1823 /* If we found exactly one match, use that. */
1826 options
[from
] = standard_args
[match
].nargs
;
1827 priority
[from
] = standard_args
[match
].priority
;
1828 /* If --OPTION=VALUE syntax is used,
1829 this option uses just one argv element. */
1832 if (from
+ options
[from
] >= argc
)
1833 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1834 from
+= options
[from
];
1836 /* FIXME When match < 0, shouldn't there be some error,
1837 or at least indication to the user that there was a
1844 /* Copy the arguments, in order of decreasing priority, to NEW. */
1846 while (incoming_used
< argc
)
1849 int best_priority
= -9999;
1851 /* Find the highest priority remaining option.
1852 If several have equal priority, take the first of them. */
1853 for (from
= 1; from
< argc
; from
++)
1855 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1857 best_priority
= priority
[from
];
1860 /* Skip option arguments--they are tied to the options. */
1861 if (options
[from
] > 0)
1862 from
+= options
[from
];
1868 /* Copy the highest priority remaining option, with its args, to NEW.
1869 Unless it is a duplicate of the previous one. */
1870 if (! (options
[best
] == 0
1871 && ! strcmp (new[to
- 1], argv
[best
])))
1873 new[to
++] = argv
[best
];
1874 for (i
= 0; i
< options
[best
]; i
++)
1875 new[to
++] = argv
[best
+ i
+ 1];
1878 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1880 /* Clear out this option in ARGV. */
1882 for (i
= 0; i
< options
[best
]; i
++)
1883 argv
[best
+ i
+ 1] = 0;
1886 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1890 memcpy (argv
, new, sizeof (char *) * argc
);
1897 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1898 doc
: /* Exit the Emacs job and kill it.
1899 If ARG is an integer, return ARG as the exit program code.
1900 If ARG is a string, stuff it as keyboard input.
1902 This function is called upon receipt of the signals SIGTERM
1903 or SIGHUP, and upon SIGINT in batch mode.
1905 The value of `kill-emacs-hook', if not void,
1906 is a list of functions (of no args),
1907 all of which are called before Emacs is actually killed. */
1908 attributes
: noreturn
)
1911 struct gcpro gcpro1
;
1916 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1918 waiting_for_input
= 0;
1919 run_hook (Qkill_emacs_hook
);
1922 #ifdef HAVE_X_WINDOWS
1923 /* Transfer any clipboards we own to the clipboard manager. */
1924 x_clipboard_manager_save_all ();
1927 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1930 ns_release_autorelease_pool (ns_pool
);
1933 /* If we have an auto-save list file,
1934 kill it because we are exiting Emacs deliberately (not crashing).
1935 Do it after shut_down_emacs, which does an auto-save. */
1936 if (STRINGP (Vauto_save_list_file_name
))
1938 Lisp_Object listfile
;
1939 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1940 unlink (SSDATA (listfile
));
1944 exit_code
= (XINT (arg
) < 0
1945 ? XINT (arg
) | INT_MIN
1946 : XINT (arg
) & INT_MAX
);
1948 exit_code
= EXIT_SUCCESS
;
1953 /* Perform an orderly shutdown of Emacs. Autosave any modified
1954 buffers, kill any child processes, clean up the terminal modes (if
1955 we're in the foreground), and other stuff like that. Don't perform
1956 any redisplay; this may be called when Emacs is shutting down in
1957 the background, or after its X connection has died.
1959 If SIG is a signal number, print a message for it.
1961 This is called by fatal signal handlers, X protocol error handlers,
1965 shut_down_emacs (int sig
, Lisp_Object stuff
)
1967 /* Prevent running of hooks from now on. */
1970 /* Don't update display from now on. */
1971 Vinhibit_redisplay
= Qt
;
1973 /* If we are controlling the terminal, reset terminal modes. */
1976 pid_t pgrp
= getpgrp ();
1977 pid_t tpgrp
= tcgetpgrp (0);
1978 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1980 reset_all_sys_modes ();
1981 if (sig
&& sig
!= SIGTERM
)
1983 static char const format
[] = "Fatal error %d: ";
1984 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1985 int buflen
= sprintf (buf
, format
, sig
);
1986 char const *sig_desc
= safe_strsignal (sig
);
1987 emacs_write (STDERR_FILENO
, buf
, buflen
);
1988 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1994 reset_all_sys_modes ();
1997 stuff_buffered_input (stuff
);
1999 inhibit_sentinels
= 1;
2000 kill_buffer_processes (Qnil
);
2001 Fdo_auto_save (Qt
, Qnil
);
2003 unlock_all_files ();
2005 /* There is a tendency for a SIGIO signal to arrive within exit,
2006 and cause a SIGHUP because the input descriptor is already closed. */
2010 /* Do this only if terminating normally, we want glyph matrices
2011 etc. in a core dump. */
2012 if (sig
== 0 || sig
== SIGTERM
)
2014 check_glyph_memory ();
2015 check_message_stack ();
2023 ns_term_shutdown (sig
);
2027 xml_cleanup_parser ();
2041 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2042 doc
: /* Dump current state of Emacs into executable file FILENAME.
2043 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2044 This is used in the file `loadup.el' when building Emacs.
2046 You must run Emacs in batch mode in order to dump it. */)
2047 (Lisp_Object filename
, Lisp_Object symfile
)
2051 ptrdiff_t count
= SPECPDL_INDEX ();
2055 if (! noninteractive
)
2056 error ("Dumping Emacs works only in batch mode");
2059 error ("Emacs can be dumped only once");
2063 /* Warn if the gap between BSS end and heap start is larger than this. */
2064 # define MAX_HEAP_BSS_DIFF (1024*1024)
2066 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2068 fprintf (stderr
, "**************************************************\n");
2069 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2070 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2072 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2073 fprintf (stderr
, "fail because of this. See the section about\n");
2074 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2075 fprintf (stderr
, "**************************************************\n");
2077 #endif /* GNU_LINUX */
2079 /* Bind `command-line-processed' to nil before dumping,
2080 so that the dumped Emacs will process its command line
2081 and set up to work with X windows if appropriate. */
2082 symbol
= intern ("command-line-processed");
2083 specbind (symbol
, Qnil
);
2085 CHECK_STRING (filename
);
2086 filename
= Fexpand_file_name (filename
, Qnil
);
2087 filename
= ENCODE_FILE (filename
);
2088 if (!NILP (symfile
))
2090 CHECK_STRING (symfile
);
2091 if (SCHARS (symfile
))
2093 symfile
= Fexpand_file_name (symfile
, Qnil
);
2094 symfile
= ENCODE_FILE (symfile
);
2099 Vpurify_flag
= Qnil
;
2102 /* Tell malloc where start of impure now is. */
2103 /* Also arrange for warnings when nearly out of space. */
2104 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2106 /* On Windows, this was done before dumping, and that once suffices.
2107 Meanwhile, my_edata is not valid on Windows. */
2108 memory_warnings (my_edata
, malloc_warning
);
2109 #endif /* not WINDOWSNT */
2110 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2111 #ifdef DOUG_LEA_MALLOC
2112 malloc_state_ptr
= malloc_get_state ();
2115 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2117 #ifdef DOUG_LEA_MALLOC
2118 free (malloc_state_ptr
);
2122 Vlibrary_cache
= Qnil
;
2124 #ifdef HAVE_WINDOW_SYSTEM
2125 reset_image_types ();
2130 return unbind_to (count
, Qnil
);
2133 #endif /* not CANNOT_DUMP */
2136 /* Recover from setlocale (LC_ALL, ""). */
2140 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2141 so that numbers are read and printed properly for Emacs Lisp. */
2142 setlocale (LC_NUMERIC
, "C");
2145 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2148 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2150 if (! EQ (*plocale
, desired_locale
))
2152 *plocale
= desired_locale
;
2153 setlocale (category
, (STRINGP (desired_locale
)
2154 ? SSDATA (desired_locale
)
2159 /* Set system time locale to match Vsystem_time_locale, if possible. */
2161 synchronize_system_time_locale (void)
2163 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2164 Vsystem_time_locale
);
2167 /* Set system messages locale to match Vsystem_messages_locale, if
2170 synchronize_system_messages_locale (void)
2173 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2174 Vsystem_messages_locale
);
2177 #endif /* HAVE_SETLOCALE */
2181 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2183 const char *path
, *p
;
2184 Lisp_Object lpath
, element
, tem
;
2185 /* Default is to use "." for empty path elements.
2186 But if argument EMPTY is true, use nil instead. */
2187 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2190 static const char *emacs_dir_env
= "%emacs_dir%/";
2191 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2192 const char *edir
= egetenv ("emacs_dir");
2193 char emacs_dir
[MAX_UTF8_PATH
];
2195 /* egetenv looks in process-environment, which holds the variables
2196 in their original system-locale encoding. We need emacs_dir to
2199 filename_from_ansi (edir
, emacs_dir
);
2202 /* It's okay to use getenv here, because this function is only used
2203 to initialize variables when Emacs starts up, and isn't called
2206 path
= getenv (evarname
);
2217 /* Ensure values from the environment use the proper directory separator. */
2223 char *path_utf8
, *q
, *d
;
2226 /* Convert each element of PATH to UTF-8. */
2227 p
= path_copy
= alloca (strlen (path
) + 1);
2228 strcpy (path_copy
, path
);
2229 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2232 q
= _mbschr (p
, SEPCHAR
);
2235 cnv_result
= filename_from_ansi (p
, d
);
2240 /* If conversion of this PATH elements fails, make sure
2241 destination pointer will stay put, thus effectively
2242 ignoring the offending element. */
2243 if (cnv_result
== 0)
2249 else if (cnv_result
!= 0 && d
> path_utf8
)
2250 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2252 path_copy
= path_utf8
;
2254 path_copy
= alloca (strlen (path
) + 1);
2255 strcpy (path_copy
, path
);
2257 dostounix_filename (path_copy
);
2264 p
= strchr (path
, SEPCHAR
);
2266 p
= path
+ strlen (path
);
2267 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2269 if (! NILP (element
))
2272 /* Relative file names in the default path are interpreted as
2273 being relative to $emacs_dir. */
2274 if (edir
&& defaulted
2275 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2276 element
= Fexpand_file_name (Fsubstring
2278 make_number (emacs_dir_len
),
2280 build_unibyte_string (emacs_dir
));
2283 /* Add /: to the front of the name
2284 if it would otherwise be treated as magic. */
2285 tem
= Ffind_file_name_handler (element
, Qt
);
2287 /* However, if the handler says "I'm safe",
2288 don't bother adding /:. */
2292 prop
= Fget (tem
, intern ("safe-magic"));
2299 AUTO_STRING (slash_colon
, "/:");
2300 element
= concat2 (slash_colon
, element
);
2302 } /* !NILP (element) */
2304 lpath
= Fcons (element
, lpath
);
2310 return Fnreverse (lpath
);
2313 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2314 doc
: /* Return non-nil if the current emacs process is a daemon.
2315 If the daemon was given a name argument, return that name. */)
2320 return build_string (daemon_name
);
2327 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2328 doc
: /* Mark the Emacs daemon as being initialized.
2329 This finishes the daemonization process by doing the other half of detaching
2330 from the parent process and its tty file descriptors. */)
2336 error ("This function can only be called if emacs is run as a daemon");
2338 if (!DAEMON_RUNNING
)
2339 error ("The daemon has already been initialized");
2341 if (NILP (Vafter_init_time
))
2342 error ("This function can only be called after loading the init files");
2346 /* Get rid of stdin, stdout and stderr. */
2347 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2349 err
|= dup2 (nfd
, 0) < 0;
2350 err
|= dup2 (nfd
, 1) < 0;
2351 err
|= dup2 (nfd
, 2) < 0;
2352 err
|= emacs_close (nfd
) != 0;
2354 /* Closing the pipe will notify the parent that it can exit.
2355 FIXME: In case some other process inherited the pipe, closing it here
2356 won't notify the parent because it's still open elsewhere, so we
2357 additionally send a byte, just to make sure the parent really exits.
2358 Instead, we should probably close the pipe in start-process and
2359 call-process to make sure the pipe is never inherited by
2361 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2362 err
|= emacs_close (daemon_pipe
[1]) != 0;
2363 /* Set it to an invalid value so we know we've already run this function. */
2364 daemon_pipe
[1] = -1;
2365 #else /* WINDOWSNT */
2366 /* Signal the waiting emacsclient process. */
2367 err
|= SetEvent (w32_daemon_event
) == 0;
2368 err
|= CloseHandle (w32_daemon_event
) == 0;
2369 /* Set it to an invalid value so we know we've already run this function. */
2370 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2374 error ("I/O error during daemon initialization");
2379 syms_of_emacs (void)
2381 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2382 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2383 DEFSYM (Qkill_emacs
, "kill-emacs");
2384 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2387 defsubr (&Sdump_emacs
);
2390 defsubr (&Skill_emacs
);
2392 defsubr (&Sinvocation_name
);
2393 defsubr (&Sinvocation_directory
);
2394 defsubr (&Sdaemonp
);
2395 defsubr (&Sdaemon_initialized
);
2397 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2398 doc
: /* Args passed by shell to Emacs, as a list of strings.
2399 Many arguments are deleted from the list as they are processed. */);
2401 DEFVAR_LISP ("system-type", Vsystem_type
,
2402 doc
: /* The value is a symbol indicating the type of operating system you are using.
2404 `gnu' compiled for a GNU Hurd system.
2405 `gnu/linux' compiled for a GNU/Linux system.
2406 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2407 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2408 `ms-dos' compiled as an MS-DOS application.
2409 `windows-nt' compiled as a native W32 application.
2410 `cygwin' compiled using the Cygwin library.
2411 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2412 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2413 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2414 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2416 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2417 doc
: /* Value is string indicating configuration Emacs was built for. */);
2418 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2420 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2421 doc
: /* String containing the configuration options Emacs was built with. */);
2422 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2424 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2425 doc
: /* String listing some of the main features this Emacs was compiled with.
2426 An element of the form \"FOO\" generally means that HAVE_FOO was
2427 defined during the build. */);
2428 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2430 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2431 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2433 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2434 doc
: /* Hook run when `kill-emacs' is called.
2435 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2436 in other similar situations), functions placed on this hook should not
2437 expect to be able to interact with the user. To ask for confirmation,
2438 see `kill-emacs-query-functions' instead.
2440 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2441 `noninteractive' was non-nil. */);
2442 Vkill_emacs_hook
= Qnil
;
2444 DEFVAR_LISP ("path-separator", Vpath_separator
,
2445 doc
: /* String containing the character that separates directories in
2446 search paths, such as PATH and other similar environment variables. */);
2449 Vpath_separator
= make_string (&c
, 1);
2452 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2453 doc
: /* The program name that was used to run Emacs.
2454 Any directory names are omitted. */);
2456 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2457 doc
: /* The directory in which the Emacs executable was found, to run it.
2458 The value is nil if that directory's name is not known. */);
2460 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2461 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2462 In an installed Emacs, this is normally nil. It is non-nil if
2463 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2464 within the variable `invocation-directory' or its parent. For example,
2465 this is the case when running an uninstalled Emacs executable from its
2466 build directory. */);
2467 Vinstallation_directory
= Qnil
;
2469 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2470 doc
: /* System locale for messages. */);
2471 Vsystem_messages_locale
= Qnil
;
2473 DEFVAR_LISP ("previous-system-messages-locale",
2474 Vprevious_system_messages_locale
,
2475 doc
: /* Most recently used system locale for messages. */);
2476 Vprevious_system_messages_locale
= Qnil
;
2478 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2479 doc
: /* System locale for time. */);
2480 Vsystem_time_locale
= Qnil
;
2482 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2483 doc
: /* Most recently used system locale for time. */);
2484 Vprevious_system_time_locale
= Qnil
;
2486 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2487 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2488 Vbefore_init_time
= Qnil
;
2490 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2491 doc
: /* Value of `current-time' after loading the init files.
2492 This is nil during initialization. */);
2493 Vafter_init_time
= Qnil
;
2495 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2496 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2497 inhibit_x_resources
= 0;
2499 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2500 doc
: /* Short copyright string for this version of Emacs. */);
2501 Vemacs_copyright
= build_string (emacs_copyright
);
2503 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2504 doc
: /* Version numbers of this version of Emacs. */);
2505 Vemacs_version
= build_string (emacs_version
);
2507 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2508 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2509 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2511 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2512 doc
: /* Alist of dynamic libraries vs external files implementing them.
2513 Each element is a list (LIBRARY FILE...), where the car is a symbol
2514 representing a supported external library, and the rest are strings giving
2515 alternate filenames for that library.
2517 Emacs tries to load the library from the files in the order they appear on
2518 the list; if none is loaded, the running session of Emacs won't have access
2521 Note that image types `pbm' and `xbm' do not need entries in this variable
2522 because they do not depend on external libraries and are always available.
2524 Also note that this is not a generic facility for accessing external
2525 libraries; only those already known by Emacs will be loaded. */);
2526 Vdynamic_library_alist
= Qnil
;
2527 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2530 Vlibrary_cache
= Qnil
;
2531 staticpro (&Vlibrary_cache
);