1 /* Fully extensible Emacs, running on Unix, intended for GNU.
2 Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 1998, 1999,
3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
4 2010 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
27 #include <sys/types.h>
37 #include <windows.h> /* just for w32.h */
39 #include "w32heap.h" /* for prototype of sbrk */
42 #ifdef NS_IMPL_GNUSTEP
43 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
44 #include <GNUstepBase/GSConfig.h>
49 #include "intervals.h"
54 #include "blockinput.h"
55 #include "syssignal.h"
58 #include "termhooks.h"
76 #include <sys/resource.h>
79 #ifdef HAVE_PERSONALITY_LINUX32
80 #include <sys/personality.h>
90 #define setpgrp setpgid
94 /* If you change the following line, remember to update
95 msdos/mainmake.v2 which gleans the Emacs version from it! */
96 static const char emacs_copyright
[] = "Copyright (C) 2010 Free Software Foundation, Inc.";
97 static const char emacs_version
[] = "24.0.50";
99 /* Make these values available in GDB, which doesn't see macros. */
106 #ifndef USE_LISP_UNION_TYPE
107 int gdb_use_union
= 0;
109 int gdb_use_union
= 1;
111 EMACS_INT gdb_valbits
= VALBITS
;
112 EMACS_INT gdb_gctypebits
= GCTYPEBITS
;
113 #if defined (DATA_SEG_BITS) && ! defined (USE_LSB_TAG)
114 EMACS_INT gdb_data_seg_bits
= DATA_SEG_BITS
;
116 EMACS_INT gdb_data_seg_bits
= 0;
118 EMACS_INT PVEC_FLAG
= PSEUDOVECTOR_FLAG
;
119 EMACS_INT gdb_array_mark_flag
= ARRAY_MARK_FLAG
;
120 /* GDB might say "No enum type named pvec_type" if we don't have at
121 least one symbol with that type, and then xbacktrace could fail. */
122 enum pvec_type gdb_pvec_type
= PVEC_TYPE_MASK
;
124 /* Command line args from shell, as list of strings. */
125 Lisp_Object Vcommand_line_args
;
127 /* The name under which Emacs was invoked, with any leading directory
129 Lisp_Object Vinvocation_name
;
131 /* The directory name from which Emacs was invoked. */
132 Lisp_Object Vinvocation_directory
;
134 /* The directory name in which to find subdirs such as lisp and etc.
135 nil means get them only from PATH_LOADSEARCH. */
136 Lisp_Object Vinstallation_directory
;
138 /* The values of `current-time' before and after Emacs initialization. */
139 Lisp_Object Vbefore_init_time
, Vafter_init_time
;
141 /* Hook run by `kill-emacs' before it does really anything. */
142 Lisp_Object Vkill_emacs_hook
;
144 /* Empty lisp strings. To avoid having to build any others. */
145 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
147 /* Search path separator. */
148 Lisp_Object Vpath_separator
;
150 /* Set nonzero after Emacs has started up the first time.
151 Prevents reinitialization of the Lisp world and keymaps
152 on subsequent starts. */
155 #ifdef DOUG_LEA_MALLOC
156 /* Preserves a pointer to the memory allocated that copies that
157 static data inside glibc's malloc. */
158 void *malloc_state_ptr
;
159 /* From glibc, a routine that returns a copy of the malloc internal state. */
160 extern void *malloc_get_state (void);
161 /* From glibc, a routine that overwrites the malloc internal state. */
162 extern int malloc_set_state (void*);
163 /* Non-zero if the MALLOC_CHECK_ environment variable was set while
164 dumping. Used to work around a bug in glibc's malloc. */
165 int malloc_using_checking
;
168 /* Variable whose value is symbol giving operating system type. */
169 Lisp_Object Vsystem_type
;
171 /* Variable whose value is string giving configuration built for. */
172 Lisp_Object Vsystem_configuration
;
174 /* Variable whose value is string giving configuration options,
175 for use when reporting bugs. */
176 Lisp_Object Vsystem_configuration_options
;
178 Lisp_Object Qfile_name_handler_alist
;
180 /* Current and previous system locales for messages and time. */
181 Lisp_Object Vsystem_messages_locale
;
182 Lisp_Object Vprevious_system_messages_locale
;
183 Lisp_Object Vsystem_time_locale
;
184 Lisp_Object Vprevious_system_time_locale
;
186 /* Copyright and version info. The version number may be updated by
188 Lisp_Object Vemacs_copyright
, Vemacs_version
;
190 /* If non-zero, emacs should not attempt to use a window-specific code,
191 but instead should use the virtual terminal under which it was started. */
192 int inhibit_window_system
;
194 /* If nonzero, set Emacs to run at this priority. This is also used
195 in child_setup and sys_suspend to make sure subshells run at normal
196 priority; those functions have their own extern declaration. */
197 EMACS_INT emacs_priority
;
199 /* If non-zero, a filter or a sentinel is running. Tested to save the match
200 data on the first attempt to change it inside asynchronous code. */
201 int running_asynch_code
;
203 #if defined(HAVE_X_WINDOWS) || defined(HAVE_NS)
204 /* If non-zero, -d was specified, meaning we're using some window system. */
208 /* An address near the bottom of the stack.
209 Tells GC how to save a copy of the stack. */
212 /* The address where the heap starts (from the first sbrk (0) call). */
213 static void *my_heap_start
;
215 /* The gap between BSS end and heap start as far as we can tell. */
216 static unsigned long heap_bss_diff
;
218 /* If the gap between BSS end and heap start is larger than this
219 output a warning in dump-emacs. */
220 #define MAX_HEAP_BSS_DIFF (1024*1024)
222 /* Nonzero means running Emacs without interactive terminal. */
226 /* Value of Lisp variable `noninteractive'.
227 Normally same as C variable `noninteractive'
228 but nothing terrible happens if user sets this one. */
232 /* Nonzero means Emacs was run in --quick mode. */
233 int inhibit_x_resources
;
235 /* Name for the server started by the daemon.*/
236 static char *daemon_name
;
238 /* Pipe used to send exit notification to the daemon parent at
242 /* Save argv and argc. */
246 static void sort_args (int argc
, char **argv
);
247 void syms_of_emacs (void);
249 /* MSVC needs each string be shorter than 2048 bytes, so the usage
250 strings below are split to not overflow this limit. */
252 Usage: %s [OPTION-OR-FILENAME]...\n\
254 Run Emacs, the extensible, customizable, self-documenting real-time\n\
255 display editor. The recommended way to start Emacs for normal editing\n\
256 is with no options at all.\n\
258 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
259 read the main documentation for these command-line arguments.\n\
261 Initialization options:\n\
263 --batch do not do interactive display; implies -q\n\
264 --chdir DIR change to directory DIR\n\
265 --daemon start a server in the background\n\
266 --debug-init enable Emacs Lisp debugger for init file\n\
267 --display, -d DISPLAY use X server DISPLAY\n\
268 --no-desktop do not load a saved desktop\n\
269 --no-init-file, -q load neither ~/.emacs nor default.el\n\
270 --no-shared-memory, -nl do not use shared memory\n\
271 --no-site-file do not load site-start.el\n\
272 --no-splash do not display a splash screen on startup\n\
273 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
274 --quick, -Q equivalent to -q --no-site-file --no-splash\n\
275 --script FILE run FILE as an Emacs Lisp script\n\
276 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
277 --user, -u USER load ~USER/.emacs instead of your own\n\
283 FILE visit FILE using find-file\n\
284 +LINE go to line LINE in next FILE\n\
285 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
286 --directory, -L DIR add DIR to variable load-path\n\
287 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
288 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
289 --file FILE visit FILE using find-file\n\
290 --find-file FILE visit FILE using find-file\n\
291 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
292 --insert FILE insert contents of FILE into current buffer\n\
293 --kill exit without asking for confirmation\n\
294 --load, -l FILE load Emacs Lisp FILE using the load function\n\
295 --visit FILE visit FILE using find-file\n\
301 --background-color, -bg COLOR window background color\n\
302 --basic-display, -D disable many display features;\n\
303 used for debugging Emacs\n\
304 --border-color, -bd COLOR main border color\n\
305 --border-width, -bw WIDTH width of main border\n\
306 --color, --color=MODE override color mode for character terminals;\n\
307 MODE defaults to `auto', and can also\n\
308 be `never', `auto', `always',\n\
309 or a mode name like `ansi8'\n\
310 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
311 --font, -fn FONT default font; must be fixed-width\n\
312 --foreground-color, -fg COLOR window foreground color\n\
313 --fullheight, -fh make the first frame high as the screen\n\
314 --fullscreen, -fs make first frame fullscreen\n\
315 --fullwidth, -fw make the first frame wide as the screen\n\
316 --maximized, -mm make the first frame maximized\n\
317 --geometry, -g GEOMETRY window geometry\n\
318 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
319 --iconic start Emacs in iconified state\n\
320 --internal-border, -ib WIDTH width between text and main border\n\
321 --line-spacing, -lsp PIXELS additional space to put between lines\n\
322 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
323 --name NAME title for initial Emacs frame\n\
324 --no-blinking-cursor, -nbc disable blinking cursor\n\
325 --reverse-video, -r, -rv switch foreground and background\n\
326 --title, -T TITLE title for initial Emacs frame\n\
327 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
328 --xrm XRESOURCES set additional X resources\n\
329 --parent-id XID set parent window\n\
330 --help display this help and exit\n\
331 --version output version information and exit\n\
335 You can generally also specify long option names with a single -; for\n\
336 example, -batch as well as --batch. You can use any unambiguous\n\
337 abbreviation for a --option.\n\
339 Various environment variables and window system resources also affect\n\
340 Emacs' operation. See the main documentation.\n\
342 Report bugs to bug-gnu-emacs@gnu.org. First, please see the Bugs\n\
343 section of the Emacs manual or the file BUGS.\n"
346 /* Signal code for the fatal signal that was received. */
347 int fatal_error_code
;
349 /* Nonzero if handling a fatal error already. */
350 int fatal_error_in_progress
;
352 /* If non-null, call this function from fatal_error_signal before
353 committing suicide. */
355 void (*fatal_error_signal_hook
) (void);
357 #ifdef FORWARD_SIGNAL_TO_MAIN_THREAD
358 /* When compiled with GTK and running under Gnome,
359 multiple threads may be created. Keep track of our main
360 thread to make sure signals are delivered to it (see syssignal.h). */
362 pthread_t main_thread
;
366 /* Handle bus errors, invalid instruction, etc. */
368 fatal_error_signal (int sig
)
370 SIGNAL_THREAD_CHECK (sig
);
371 fatal_error_code
= sig
;
372 signal (sig
, SIG_DFL
);
374 TOTALLY_UNBLOCK_INPUT
;
376 /* If fatal error occurs in code below, avoid infinite recursion. */
377 if (! fatal_error_in_progress
)
379 fatal_error_in_progress
= 1;
381 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
382 Fkill_emacs (make_number (sig
));
384 shut_down_emacs (sig
, 0, Qnil
);
387 /* Signal the same code; this time it will really be fatal.
388 Remember that since we're in a signal handler, the signal we're
389 going to send is probably blocked, so we have to unblock it if we
390 want to really receive it. */
392 sigunblock (sigmask (fatal_error_code
));
395 if (fatal_error_signal_hook
)
396 fatal_error_signal_hook ();
398 kill (getpid (), fatal_error_code
);
403 /* Handler for SIGDANGER. */
405 memory_warning_signal (sig
)
408 signal (sig
, memory_warning_signal
);
409 SIGNAL_THREAD_CHECK (sig
);
411 malloc_warning ("Operating system warns that virtual memory is running low.\n");
413 /* It might be unsafe to call do_auto_save now. */
414 force_auto_save_soon ();
418 /* We define abort, rather than using it from the library,
419 so that GDB can return from a breakpoint here.
420 MSDOS has its own definition in msdos.c. */
422 #if ! defined (DOS_NT) && ! defined (NO_ABORT)
427 kill (getpid (), SIGABRT
);
428 /* This shouldn't be executed, but it prevents a warning. */
434 /* Code for dealing with Lisp access to the Unix command line. */
437 init_cmdargs (int argc
, char **argv
, int skip_args
)
440 Lisp_Object name
, dir
, tem
;
441 int count
= SPECPDL_INDEX ();
442 Lisp_Object raw_name
;
447 raw_name
= build_string (argv
[0]);
449 /* Add /: to the front of the name
450 if it would otherwise be treated as magic. */
451 tem
= Ffind_file_name_handler (raw_name
, Qt
);
453 raw_name
= concat2 (build_string ("/:"), raw_name
);
455 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
456 Vinvocation_directory
= Ffile_name_directory (raw_name
);
458 /* If we got no directory in argv[0], search PATH to find where
459 Emacs actually came from. */
460 if (NILP (Vinvocation_directory
))
463 int yes
= openp (Vexec_path
, Vinvocation_name
,
464 Vexec_suffixes
, &found
, make_number (X_OK
));
467 /* Add /: to the front of the name
468 if it would otherwise be treated as magic. */
469 tem
= Ffind_file_name_handler (found
, Qt
);
471 found
= concat2 (build_string ("/:"), found
);
472 Vinvocation_directory
= Ffile_name_directory (found
);
476 if (!NILP (Vinvocation_directory
)
477 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
478 /* Emacs was started with relative path, like ./emacs.
480 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, Qnil
);
482 Vinstallation_directory
= Qnil
;
484 if (!NILP (Vinvocation_directory
))
486 dir
= Vinvocation_directory
;
487 name
= Fexpand_file_name (Vinvocation_name
, dir
);
490 Lisp_Object tem
, lib_src_exists
;
491 Lisp_Object etc_exists
, info_exists
;
493 /* See if dir contains subdirs for use by Emacs.
494 Check for the ones that would exist in a build directory,
495 not including lisp and info. */
496 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
497 lib_src_exists
= Ffile_exists_p (tem
);
500 /* MSDOS installations frequently remove lib-src, but we still
501 must set installation-directory, or else info won't find
502 its files (it uses the value of installation-directory). */
503 tem
= Fexpand_file_name (build_string ("info"), dir
);
504 info_exists
= Ffile_exists_p (tem
);
509 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
511 tem
= Fexpand_file_name (build_string ("etc"), dir
);
512 etc_exists
= Ffile_exists_p (tem
);
513 if (!NILP (etc_exists
))
515 Vinstallation_directory
516 = Ffile_name_as_directory (dir
);
521 /* See if dir's parent contains those subdirs. */
522 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
523 lib_src_exists
= Ffile_exists_p (tem
);
527 /* See the MSDOS commentary above. */
528 tem
= Fexpand_file_name (build_string ("../info"), dir
);
529 info_exists
= Ffile_exists_p (tem
);
534 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
536 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
537 etc_exists
= Ffile_exists_p (tem
);
538 if (!NILP (etc_exists
))
540 tem
= Fexpand_file_name (build_string (".."), dir
);
541 Vinstallation_directory
542 = Ffile_name_as_directory (tem
);
547 /* If the Emacs executable is actually a link,
548 next try the dir that the link points into. */
549 tem
= Ffile_symlink_p (name
);
552 name
= Fexpand_file_name (tem
, dir
);
553 dir
= Ffile_name_directory (name
);
560 Vcommand_line_args
= Qnil
;
562 for (i
= argc
- 1; i
>= 0; i
--)
564 if (i
== 0 || i
> skip_args
)
565 /* For the moment, we keep arguments as is in unibyte strings.
566 They are decoded in the function command-line after we know
567 locale-coding-system. */
569 = Fcons (make_unibyte_string (argv
[i
], strlen (argv
[i
])),
573 unbind_to (count
, Qnil
);
576 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
577 doc
: /* Return the program name that was used to run Emacs.
578 Any directory names are omitted. */)
581 return Fcopy_sequence (Vinvocation_name
);
584 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
586 doc
: /* Return the directory name in which the Emacs executable was located. */)
589 return Fcopy_sequence (Vinvocation_directory
);
594 /* A valid but unlikely value for the TZ environment value.
595 It is OK (though a bit slower) if the user actually chooses this value. */
596 static char dump_tz
[] = "UtC0";
599 #ifndef ORDINARY_LINK
600 /* We don't include crtbegin.o and crtend.o in the link,
601 so these functions and variables might be missed.
602 Provide dummy definitions to avoid error.
603 (We don't have any real constructors or destructors.) */
605 #ifndef GCC_CTORS_IN_LIBC
606 void __do_global_ctors (void)
608 void __do_global_ctors_aux (void)
610 void __do_global_dtors (void)
612 /* GNU/Linux has a bug in its library; avoid an error. */
614 char * __CTOR_LIST__
[2] = { (char *) (-1), 0 };
616 char * __DTOR_LIST__
[2] = { (char *) (-1), 0 };
617 #endif /* GCC_CTORS_IN_LIBC */
620 #endif /* __GNUC__ */
621 #endif /* ORDINARY_LINK */
623 /* Test whether the next argument in ARGV matches SSTR or a prefix of
624 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
625 (the argument is supposed to have a value) store in *VALPTR either
626 the next argument or the portion of this one after the equal sign.
627 ARGV is read starting at position *SKIPPTR; this index is advanced
628 by the number of arguments used.
630 Too bad we can't just use getopt for all of this, but we don't have
631 enough information to do it right. */
634 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
, int minlen
, char **valptr
, int *skipptr
)
640 /* Don't access argv[argc]; give up in advance. */
641 if (argc
<= *skipptr
+ 1)
644 arg
= argv
[*skipptr
+1];
647 if (strcmp (arg
, sstr
) == 0)
651 *valptr
= argv
[*skipptr
+2];
658 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
659 ? p
- arg
: strlen (arg
));
660 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
662 else if (valptr
== NULL
)
673 else if (argv
[*skipptr
+2] != NULL
)
675 *valptr
= argv
[*skipptr
+2];
685 #ifdef DOUG_LEA_MALLOC
687 /* malloc can be invoked even before main (e.g. by the dynamic
688 linker), so the dumped malloc state must be restored as early as
689 possible using this special hook. */
692 malloc_initialize_hook (void)
695 extern char **environ
;
700 if (!malloc_using_checking
)
701 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
702 ignored if the heap to be restored was constructed without
703 malloc checking. Can't use unsetenv, since that calls malloc. */
707 for (p
= environ
; p
&& *p
; p
++)
708 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
717 malloc_set_state (malloc_state_ptr
);
718 #ifndef XMALLOC_OVERRUN_CHECK
719 free (malloc_state_ptr
);
724 if (my_heap_start
== 0)
725 my_heap_start
= sbrk (0);
726 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
730 void (*__malloc_initialize_hook
) (void) = malloc_initialize_hook
;
732 #endif /* DOUG_LEA_MALLOC */
737 main (int argc
, char **argv
)
742 char stack_bottom_variable
;
743 int do_initial_setlocale
;
745 #ifdef HAVE_SETRLIMIT
760 #if defined (USE_GTK) && defined (G_SLICE_ALWAYS_MALLOC)
761 /* This is used by the Cygwin build. */
762 setenv ("G_SLICE", "always-malloc", 1);
767 extern char my_endbss
[];
768 extern char *my_endbss_static
;
770 if (my_heap_start
== 0)
771 my_heap_start
= sbrk (0);
773 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
776 #ifdef RUN_TIME_REMAP
778 run_time_remap (argv
[0]);
781 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
784 unexec_init_emacs_zone ();
787 sort_args (argc
, argv
);
789 while (argv
[argc
]) argc
++;
791 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
793 const char *version
, *copyright
;
796 Lisp_Object tem
, tem2
;
797 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
798 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
801 fprintf (stderr
, "Invalid value of `emacs-version'\n");
806 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
811 version
= SDATA (tem
);
812 copyright
= SDATA (tem2
);
817 version
= emacs_version
;
818 copyright
= emacs_copyright
;
820 printf ("GNU Emacs %s\n", version
);
821 printf ("%s\n", copyright
);
822 printf ("GNU Emacs comes with ABSOLUTELY NO WARRANTY.\n");
823 printf ("You may redistribute copies of Emacs\n");
824 printf ("under the terms of the GNU General Public License.\n");
825 printf ("For more information about these matters, ");
826 printf ("see the file named COPYING.\n");
829 if (argmatch (argv
, argc
, "-chdir", "--chdir", 2, &ch_to_dir
, &skip_args
))
830 if (chdir (ch_to_dir
) == -1)
832 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
833 argv
[0], ch_to_dir
, strerror (errno
));
838 #ifdef HAVE_PERSONALITY_LINUX32
840 && (strcmp (argv
[argc
-1], "dump") == 0
841 || strcmp (argv
[argc
-1], "bootstrap") == 0)
842 && ! getenv ("EMACS_HEAP_EXEC"))
844 static char heapexec
[] = "EMACS_HEAP_EXEC=true";
845 /* Set this so we only do this once. */
848 /* A flag to turn off address randomization which is introduced
849 in linux kernel shipped with fedora core 4 */
850 #define ADD_NO_RANDOMIZE 0x0040000
851 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
852 #undef ADD_NO_RANDOMIZE
854 execvp (argv
[0], argv
);
856 /* If the exec fails, try to dump anyway. */
859 #endif /* HAVE_PERSONALITY_LINUX32 */
861 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
862 /* Extend the stack space available.
863 Don't do that if dumping, since some systems (e.g. DJGPP)
864 might define a smaller stack limit at that time. */
867 && (!noninteractive
|| initialized
)
869 && !getrlimit (RLIMIT_STACK
, &rlim
))
872 extern size_t re_max_failures
;
873 /* Approximate the amount regex.c needs per unit of re_max_failures. */
874 int ratio
= 20 * sizeof (char *);
875 /* Then add 33% to cover the size of the smaller stacks that regex.c
876 successively allocates and discards, on its way to the maximum. */
878 /* Add in some extra to cover
879 what we're likely to use for other reasons. */
880 newlim
= re_max_failures
* ratio
+ 200000;
882 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
883 stack allocation routine for new process that the allocation
884 fails if stack limit is not on page boundary. So, round up the
885 new limit to page boundary. */
886 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize();
888 if (newlim
> rlim
.rlim_max
)
890 newlim
= rlim
.rlim_max
;
891 /* Don't let regex.c overflow the stack we have. */
892 re_max_failures
= (newlim
- 200000) / ratio
;
894 if (rlim
.rlim_cur
< newlim
)
895 rlim
.rlim_cur
= newlim
;
897 setrlimit (RLIMIT_STACK
, &rlim
);
899 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
901 /* Record (approximately) where the stack begins. */
902 stack_bottom
= &stack_bottom_variable
;
906 #ifndef SYSTEM_MALLOC
907 /* Arrange to get warning messages as memory fills up. */
908 memory_warnings (0, malloc_warning
);
910 /* Call malloc at least once, to run the initial __malloc_hook.
911 Also call realloc and free for consistency. */
912 free (realloc (malloc (4), 4));
915 /* Arrange to disable interrupt input inside malloc etc. */
916 uninterrupt_malloc ();
917 # endif /* not SYNC_INPUT */
918 #endif /* not SYSTEM_MALLOC */
920 #ifdef FORWARD_SIGNAL_TO_MAIN_THREAD
921 main_thread
= pthread_self ();
922 #endif /* FORWARD_SIGNAL_TO_MAIN_THREAD */
924 #if defined (MSDOS) || defined (WINDOWSNT)
925 /* We do all file input/output as binary files. When we need to translate
926 newlines, we do that manually. */
928 #endif /* MSDOS || WINDOWSNT */
931 if (!isatty (fileno (stdin
)))
932 setmode (fileno (stdin
), O_BINARY
);
933 if (!isatty (fileno (stdout
)))
936 setmode (fileno (stdout
), O_BINARY
);
940 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
941 The build procedure uses this while dumping, to ensure that the
942 dumped Emacs does not have its system locale tables initialized,
943 as that might cause screwups when the dumped Emacs starts up. */
945 char *lc_all
= getenv ("LC_ALL");
946 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
949 /* Set locale now, so that initial error messages are localized properly.
950 fixup_locale must wait until later, since it builds strings. */
951 if (do_initial_setlocale
)
952 setlocale (LC_ALL
, "");
954 inhibit_window_system
= 0;
956 /* Handle the -t switch, which specifies filename to use as terminal. */
960 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
965 result
= emacs_open (term
, O_RDWR
, 0);
968 char *errstring
= strerror (errno
);
969 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
975 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
978 fprintf (stderr
, "Using %s\n", term
);
979 #ifdef HAVE_WINDOW_SYSTEM
980 inhibit_window_system
= 1; /* -t => -nw */
987 /* Command line option --no-windows is deprecated and thus not mentioned
988 in the manual and usage informations. */
989 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
990 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
991 inhibit_window_system
= 1;
993 /* Handle the -batch switch, which means don't do interactive display. */
995 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
998 Vundo_outer_limit
= Qnil
;
1000 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
1002 noninteractive
= 1; /* Set batch mode. */
1003 /* Convert --script to -scriptload, un-skip it, and sort again
1004 so that it will be handled in proper sequence. */
1005 /* FIXME broken for --script=FILE - is that supposed to work? */
1006 argv
[skip_args
- 1] = "-scriptload";
1008 sort_args (argc
, argv
);
1011 /* Handle the --help option, which gives a usage message. */
1012 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
1014 printf (USAGE1
, argv
[0], USAGE2
);
1020 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1021 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1026 /* Start as a daemon: fork a new child process which will run the
1027 rest of the initialization code, then exit.
1029 Detaching a daemon requires the following steps:
1033 - close the tty file-descriptors
1035 We only want to do the last 2 steps once the daemon is ready to
1036 serve requests, i.e. after loading .emacs (initialization).
1037 OTOH initialization may start subprocesses (e.g. ispell) and these
1038 should be run from the proper process (the one that will end up
1039 running as daemon) and with the proper "session id" in order for
1040 them to keep working after detaching, so fork and setsid need to be
1041 performed before initialization.
1043 We want to avoid exiting before the server socket is ready, so
1044 use a pipe for synchronization. The parent waits for the child
1045 to close its end of the pipe (using `daemon-initialized')
1047 if (pipe (daemon_pipe
) == -1)
1049 fprintf (stderr
, "Cannot pipe!\n");
1053 #ifndef NS_IMPL_COCOA
1055 #else /* NS_IMPL_COCOA */
1056 /* Under Cocoa we must do fork+exec as CoreFoundation lib fails in
1057 forked process: http://developer.apple.com/ReleaseNotes/
1058 CoreFoundation/CoreFoundation.html)
1059 We mark being in the exec'd process by a daemon name argument of
1060 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
1061 NAME is the original daemon name, if any. */
1062 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1063 f
= fork (); /* in orig */
1065 f
= 0; /* in exec'd */
1066 #endif /* NS_IMPL_COCOA */
1072 /* Close unused writing end of the pipe. */
1073 close (daemon_pipe
[1]);
1075 /* Just wait for the child to close its end of the pipe. */
1078 retval
= read (daemon_pipe
[0], &buf
, 1);
1080 while (retval
== -1 && errno
== EINTR
);
1084 fprintf (stderr
, "Error reading status from child\n");
1087 else if (retval
== 0)
1089 fprintf (stderr
, "Error: server did not start correctly\n");
1093 close (daemon_pipe
[0]);
1098 fprintf (stderr
, "Cannot fork!\n");
1102 #ifdef NS_IMPL_COCOA
1104 /* In orig process, forked as child, OR in exec'd. */
1105 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1106 { /* In orig, child: now exec w/special daemon name. */
1109 if (dname_arg
&& strlen (dname_arg
) > 70)
1111 fprintf (stderr
, "daemon: child name too long\n");
1115 sprintf (fdStr
, "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1116 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1117 argv
[skip_args
] = fdStr
;
1119 execv (argv
[0], argv
);
1120 fprintf (stderr
, "emacs daemon: exec failed: %d\n", errno
);
1124 /* In exec'd: parse special dname into pipe and name info. */
1125 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1126 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1128 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1131 dname_arg2
[0] = '\0';
1132 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1134 dname_arg
= strlen (dname_arg2
) ? dname_arg2
: NULL
;
1136 #endif /* NS_IMPL_COCOA */
1139 daemon_name
= xstrdup (dname_arg
);
1140 /* Close unused reading end of the pipe. */
1141 close (daemon_pipe
[0]);
1142 /* Make sure that the used end of the pipe is closed on exec, so
1143 that it is not accessible to programs started from .emacs. */
1144 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1150 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1155 if (! noninteractive
)
1157 #if defined (USG5) && defined (INTERRUPT_INPUT)
1160 #if defined (HAVE_GTK_AND_PTHREAD) && !defined (SYSTEM_MALLOC) && !defined (DOUG_LEA_MALLOC)
1162 extern void malloc_enable_thread (void);
1164 malloc_enable_thread ();
1171 /* Don't catch SIGHUP if dumping. */
1178 sigblock (sigmask (SIGHUP
));
1179 /* In --batch mode, don't catch SIGHUP if already ignored.
1180 That makes nohup work. */
1181 if (! noninteractive
1182 || signal (SIGHUP
, SIG_IGN
) != SIG_IGN
)
1183 signal (SIGHUP
, fatal_error_signal
);
1184 sigunblock (sigmask (SIGHUP
));
1189 ! noninteractive
|| initialized
1195 /* Don't catch these signals in batch mode if dumping.
1196 On some machines, this sets static data that would make
1197 signal fail to work right when the dumped Emacs is run. */
1198 signal (SIGQUIT
, fatal_error_signal
);
1199 signal (SIGILL
, fatal_error_signal
);
1200 signal (SIGTRAP
, fatal_error_signal
);
1202 add_user_signal (SIGUSR1
, "sigusr1");
1205 add_user_signal (SIGUSR2
, "sigusr2");
1208 signal (SIGABRT
, fatal_error_signal
);
1211 signal (SIGHWE
, fatal_error_signal
);
1214 signal (SIGPRE
, fatal_error_signal
);
1217 signal (SIGORE
, fatal_error_signal
);
1220 signal (SIGUME
, fatal_error_signal
);
1223 signal (SIGDLK
, fatal_error_signal
);
1226 signal (SIGCPULIM
, fatal_error_signal
);
1229 /* This is missing on some systems - OS/2, for example. */
1230 signal (SIGIOT
, fatal_error_signal
);
1233 signal (SIGEMT
, fatal_error_signal
);
1235 signal (SIGFPE
, fatal_error_signal
);
1237 signal (SIGBUS
, fatal_error_signal
);
1239 signal (SIGSEGV
, fatal_error_signal
);
1241 signal (SIGSYS
, fatal_error_signal
);
1243 /* May need special treatment on MS-Windows. See
1244 http://lists.gnu.org/archive/html/emacs-devel/2010-09/msg01062.html
1245 Please update the doc of kill-emacs, kill-emacs-hook, and
1246 NEWS if you change this.
1248 if (noninteractive
) signal (SIGINT
, fatal_error_signal
);
1249 signal (SIGTERM
, fatal_error_signal
);
1251 signal (SIGXCPU
, fatal_error_signal
);
1254 signal (SIGXFSZ
, fatal_error_signal
);
1255 #endif /* SIGXFSZ */
1258 /* This just means available memory is getting low. */
1259 signal (SIGDANGER
, memory_warning_signal
);
1263 /* 20 is SIGCHLD, 21 is SIGTTIN, 22 is SIGTTOU. */
1264 signal (SIGXCPU
, fatal_error_signal
);
1265 signal (SIGIOINT
, fatal_error_signal
);
1266 signal (SIGGRANT
, fatal_error_signal
);
1267 signal (SIGRETRACT
, fatal_error_signal
);
1268 signal (SIGSOUND
, fatal_error_signal
);
1269 signal (SIGMSG
, fatal_error_signal
);
1273 noninteractive1
= noninteractive
;
1275 /* Perform basic initializations (not merely interning symbols). */
1282 init_character_once ();
1283 init_charset_once ();
1284 init_coding_once ();
1285 init_syntax_once (); /* Create standard syntax table. */
1286 init_category_once (); /* Create standard category table. */
1287 /* Must be done before init_buffer. */
1288 init_casetab_once ();
1289 init_buffer_once (); /* Create buffer table and some buffers. */
1290 init_minibuf_once (); /* Create list of minibuffers. */
1291 /* Must precede init_window_once. */
1293 /* Call syms_of_xfaces before init_window_once because that
1294 function creates Vterminal_frame. Termcap frames now use
1295 faces, and the face implementation uses some symbols as
1298 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1299 be better to arrange things not to have this dependency. */
1301 /* Call syms_of_keyboard before init_window_once because
1302 keyboard sets up symbols that include some face names that
1303 the X support will want to use. This can happen when
1304 CANNOT_DUMP is defined. */
1305 syms_of_keyboard ();
1307 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1310 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1312 /* Before syms_of_coding because it initializes Qcharsetp. */
1314 /* Before init_window_once, because it sets up the
1315 Vcoding_system_hash_table. */
1316 syms_of_coding (); /* This should be after syms_of_fileio. */
1318 init_window_once (); /* Init the window system. */
1319 #ifdef HAVE_WINDOW_SYSTEM
1320 init_fringe_once (); /* Swap bitmaps if necessary. */
1321 #endif /* HAVE_WINDOW_SYSTEM */
1326 if (do_initial_setlocale
)
1329 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1330 Vsystem_time_locale
= Vprevious_system_time_locale
;
1335 #ifdef CLASH_DETECTION
1339 running_asynch_code
= 0;
1342 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1345 ns_alloc_autorelease_pool();
1346 if (!noninteractive
)
1348 #ifdef NS_IMPL_COCOA
1349 if (skip_args
< argc
)
1351 if (!strncmp(argv
[skip_args
], "-psn", 4))
1354 chdir (getenv ("HOME"));
1356 else if (skip_args
+1 < argc
&& !strncmp(argv
[skip_args
+1], "-psn", 4))
1359 chdir (getenv ("HOME"));
1364 #endif /* HAVE_NS */
1366 #ifdef HAVE_X_WINDOWS
1367 /* Stupid kludge to catch command-line display spec. We can't
1368 handle this argument entirely in window system dependent code
1369 because we don't even know which window system dependent code
1370 to run until we've recognized this argument. */
1372 char *displayname
= 0;
1373 int count_before
= skip_args
;
1375 /* Skip any number of -d options, but only use the last one. */
1378 int count_before_this
= skip_args
;
1380 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1382 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1387 count_before
= count_before_this
;
1390 /* If we have the form --display=NAME,
1391 convert it into -d name.
1392 This requires inserting a new element into argv. */
1393 if (displayname
!= 0 && skip_args
- count_before
== 1)
1395 char **new = (char **) xmalloc (sizeof (char *) * (argc
+ 2));
1398 for (j
= 0; j
< count_before
+ 1; j
++)
1400 new[count_before
+ 1] = "-d";
1401 new[count_before
+ 2] = displayname
;
1402 for (j
= count_before
+ 2; j
<argc
; j
++)
1403 new[j
+ 1] = argv
[j
];
1407 /* Change --display to -d, when its arg is separate. */
1408 else if (displayname
!= 0 && skip_args
> count_before
1409 && argv
[count_before
+ 1][1] == '-')
1410 argv
[count_before
+ 1] = "-d";
1412 /* Don't actually discard this arg. */
1413 skip_args
= count_before
;
1417 /* argmatch must not be used after here,
1418 except when bulding temacs
1419 because the -d argument has not been skipped in skip_args. */
1422 /* Call early 'cause init_environment needs it. */
1424 /* Set defaults for several environment variables. */
1426 init_environment (argc
, argv
, skip_args
);
1433 /* Initialize environment from registry settings. */
1434 init_environment (argv
);
1435 init_ntproc (); /* must precede init_editfns. */
1445 /* Initialize and GC-protect Vinitial_environment and
1446 Vprocess_environment before set_initial_environment fills them
1449 syms_of_callproc ();
1450 /* egetenv is a pretty low-level facility, which may get called in
1451 many circumstances; it seems flimsy to put off initializing it
1452 until calling init_callproc. */
1453 set_initial_environment ();
1454 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1455 if this is not done. Do it after set_global_environment so that we
1456 don't pollute Vglobal_environment. */
1457 /* Setting LANG here will defeat the startup locale processing... */
1462 init_buffer (); /* Init default directory of main buffer. */
1464 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1465 init_cmdargs (argc
, argv
, skip_args
); /* Must precede init_lread. */
1469 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1470 Lisp_Object old_log_max
;
1471 old_log_max
= Vmessage_log_max
;
1472 XSETFASTINT (Vmessage_log_max
, 0);
1473 message_dolog ("", 0, 1, 0);
1474 Vmessage_log_max
= old_log_max
;
1477 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1480 /* Intern the names of all standard functions and variables;
1481 define standard keys. */
1485 /* The basic levels of Lisp must come first. Note that
1486 syms_of_data and some others have already been called. */
1492 syms_of_floatfns ();
1495 syms_of_bytecode ();
1497 syms_of_casefiddle ();
1499 syms_of_category ();
1501 syms_of_character ();
1508 #ifdef CLASH_DETECTION
1509 syms_of_filelock ();
1510 #endif /* CLASH_DETECTION */
1513 /* syms_of_keymap (); */
1521 syms_of_terminal ();
1527 syms_of_textprop ();
1528 syms_of_composite ();
1531 #endif /* WINDOWSNT */
1535 #ifdef HAVE_WINDOW_SYSTEM
1538 #endif /* HAVE_WINDOW_SYSTEM */
1539 #ifdef HAVE_X_WINDOWS
1544 syms_of_xsettings ();
1551 #endif /* HAVE_X_WINDOWS */
1562 syms_of_w32select ();
1565 #endif /* HAVE_NTGUI */
1571 syms_of_win16select();
1578 syms_of_nsselect ();
1580 #endif /* HAVE_NS */
1587 syms_of_dbusbind ();
1588 #endif /* HAVE_DBUS */
1592 #endif /* WINDOWSNT */
1594 keys_of_casefiddle ();
1597 keys_of_keyboard ();
1603 /* Initialization that must be done even if the global variable
1604 initialized is non zero. */
1606 globals_of_w32fns ();
1607 globals_of_w32menu ();
1608 globals_of_w32select ();
1609 #endif /* HAVE_NTGUI */
1614 init_editfns (); /* init_process uses Voperating_system_release. */
1615 init_process (); /* init_display uses add_keyboard_wait_descriptor. */
1616 init_keyboard (); /* This too must precede init_sys_modes. */
1617 if (!noninteractive
)
1618 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1621 #ifdef HAVE_WINDOW_SYSTEM
1624 #endif /* HAVE_WINDOW_SYSTEM */
1636 /* Handle -l loadup, args passed by Makefile. */
1637 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1638 Vtop_level
= Fcons (intern_c_string ("load"),
1639 Fcons (build_string (file
), Qnil
));
1640 /* Unless next switch is -nl, load "loadup.el" first thing. */
1642 Vtop_level
= Fcons (intern_c_string ("load"),
1643 Fcons (build_string ("loadup.el"), Qnil
));
1650 /* If the execution TZ happens to be the same as the dump TZ,
1651 change it to some other value and then change it back,
1652 to force the underlying implementation to reload the TZ info.
1653 This is needed on implementations that load TZ info from files,
1654 since the TZ file contents may differ between dump and execution. */
1655 char *tz
= getenv ("TZ");
1656 if (tz
&& !strcmp (tz
, dump_tz
))
1666 /* Set up for profiling. This is known to work on FreeBSD,
1667 GNU/Linux and MinGW. It might work on some other systems too.
1668 Give it a try and tell us if it works on your system. To compile
1669 for profiling, use the configure option --enable-profiling. */
1670 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined(__MINGW32__)
1674 extern void _mcleanup ();
1676 extern unsigned char etext
asm ("etext");
1680 #ifdef HAVE___EXECUTABLE_START
1681 /* This symbol is defined by GNU ld to the start of the text
1683 extern char __executable_start
[];
1685 extern void safe_bcopy ();
1689 #ifdef HAVE___EXECUTABLE_START
1690 monstartup (__executable_start
, &etext
);
1692 /* This uses safe_bcopy because that function comes first in the
1693 Emacs executable. It might be better to use something that
1694 gives the start of the text segment, but start_of_text is not
1695 defined on all systems now. */
1696 /* FIXME: Does not work on architectures with function
1698 monstartup (safe_bcopy
, &etext
);
1708 #ifdef LOCALTIME_CACHE
1709 /* Some versions of localtime have a bug. They cache the value of the time
1710 zone rather than looking it up every time. Since localtime() is
1711 called to bolt the undumping time into the undumped emacs, this
1712 results in localtime ignoring the TZ environment variable.
1713 This flushes the new TZ value into localtime. */
1715 #endif /* defined (LOCALTIME_CACHE) */
1717 /* Enter editor command loop. This never returns. */
1723 /* Sort the args so we can find the most important ones
1724 at the beginning of argv. */
1726 /* First, here's a table of all the standard options. */
1728 struct standard_args
1731 const char *longname
;
1736 const struct standard_args standard_args
[] =
1738 { "-version", "--version", 150, 0 },
1739 { "-chdir", "--chdir", 130, 1 },
1740 { "-t", "--terminal", 120, 1 },
1741 { "-nw", "--no-window-system", 110, 0 },
1742 { "-nw", "--no-windows", 110, 0 },
1743 { "-batch", "--batch", 100, 0 },
1744 { "-script", "--script", 100, 1 },
1745 { "-daemon", "--daemon", 99, 0 },
1746 { "-help", "--help", 90, 0 },
1747 { "-nl", "--no-loadup", 70, 0 },
1748 /* -d must come last before the options handled in startup.el. */
1749 { "-d", "--display", 60, 1 },
1750 { "-display", 0, 60, 1 },
1751 /* Now for the options handled in `command-line' (startup.el). */
1752 { "-Q", "--quick", 55, 0 },
1753 { "-quick", 0, 55, 0 },
1754 { "-q", "--no-init-file", 50, 0 },
1755 { "-no-init-file", 0, 50, 0 },
1756 { "-no-site-file", "--no-site-file", 40, 0 },
1757 { "-u", "--user", 30, 1 },
1758 { "-user", 0, 30, 1 },
1759 { "-debug-init", "--debug-init", 20, 0 },
1760 { "-iconic", "--iconic", 15, 0 },
1761 { "-D", "--basic-display", 12, 0},
1762 { "-basic-display", 0, 12, 0},
1763 { "-nbc", "--no-blinking-cursor", 12, 0 },
1764 /* Now for the options handled in `command-line-1' (startup.el). */
1765 { "-nbi", "--no-bitmap-icon", 10, 0 },
1766 { "-bg", "--background-color", 10, 1 },
1767 { "-background", 0, 10, 1 },
1768 { "-fg", "--foreground-color", 10, 1 },
1769 { "-foreground", 0, 10, 1 },
1770 { "-bd", "--border-color", 10, 1 },
1771 { "-bw", "--border-width", 10, 1 },
1772 { "-ib", "--internal-border", 10, 1 },
1773 { "-ms", "--mouse-color", 10, 1 },
1774 { "-cr", "--cursor-color", 10, 1 },
1775 { "-fn", "--font", 10, 1 },
1776 { "-font", 0, 10, 1 },
1777 { "-fs", "--fullscreen", 10, 0 },
1778 { "-fw", "--fullwidth", 10, 0 },
1779 { "-fh", "--fullheight", 10, 0 },
1780 { "-mm", "--maximized", 10, 0 },
1781 { "-g", "--geometry", 10, 1 },
1782 { "-geometry", 0, 10, 1 },
1783 { "-T", "--title", 10, 1 },
1784 { "-title", 0, 10, 1 },
1785 { "-name", "--name", 10, 1 },
1786 { "-xrm", "--xrm", 10, 1 },
1787 { "-parent-id", "--parent-id", 10, 1 },
1788 { "-r", "--reverse-video", 5, 0 },
1790 { "-reverse", 0, 5, 0 },
1791 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1792 { "-vb", "--vertical-scroll-bars", 5, 0 },
1793 { "-color", "--color", 5, 0},
1794 { "-no-splash", "--no-splash", 3, 0 },
1795 { "-no-desktop", "--no-desktop", 3, 0 },
1797 { "-NSAutoLaunch", 0, 5, 1 },
1798 { "-NXAutoLaunch", 0, 5, 1 },
1799 { "-disable-font-backend", "--disable-font-backend", 65, 0 },
1800 { "-_NSMachLaunch", 0, 85, 1 },
1801 { "-MachLaunch", 0, 85, 1 },
1802 { "-macosx", 0, 85, 0 },
1803 { "-NSHost", 0, 85, 1 },
1805 /* These have the same priority as ordinary file name args,
1806 so they are not reordered with respect to those. */
1807 { "-L", "--directory", 0, 1 },
1808 { "-directory", 0, 0, 1 },
1809 { "-l", "--load", 0, 1 },
1810 { "-load", 0, 0, 1 },
1811 /* This has no longname, because using --scriptload confuses sort_args,
1812 because then the --script long option seems to match twice; ie
1813 you can't have a long option which is a prefix of another long
1814 option. In any case, this is entirely an internal option. */
1815 { "-scriptload", NULL
, 0, 1 },
1816 { "-f", "--funcall", 0, 1 },
1817 { "-funcall", 0, 0, 1 },
1818 { "-eval", "--eval", 0, 1 },
1819 { "-execute", "--execute", 0, 1 },
1820 { "-find-file", "--find-file", 0, 1 },
1821 { "-visit", "--visit", 0, 1 },
1822 { "-file", "--file", 0, 1 },
1823 { "-insert", "--insert", 0, 1 },
1825 { "-NXOpen", 0, 0, 1 },
1826 { "-NXOpenTemp", 0, 0, 1 },
1827 { "-NSOpen", 0, 0, 1 },
1828 { "-NSOpenTemp", 0, 0, 1 },
1829 { "-GSFilePath", 0, 0, 1 },
1831 /* This should be processed after ordinary file name args and the like. */
1832 { "-kill", "--kill", -10, 0 },
1835 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1836 so that the highest priority ones come first.
1837 Do not change the order of elements of equal priority.
1838 If an option takes an argument, keep it and its argument together.
1840 If an option that takes no argument appears more
1841 than once, eliminate all but one copy of it. */
1844 sort_args (int argc
, char **argv
)
1846 char **new = (char **) xmalloc (sizeof (char *) * argc
);
1847 /* For each element of argv,
1848 the corresponding element of options is:
1849 0 for an option that takes no arguments,
1850 1 for an option that takes one argument, etc.
1851 -1 for an ordinary non-option argument. */
1852 int *options
= (int *) xmalloc (sizeof (int) * argc
);
1853 int *priority
= (int *) xmalloc (sizeof (int) * argc
);
1855 int incoming_used
= 1;
1859 /* Categorize all the options,
1860 and figure out which argv elts are option arguments. */
1861 for (from
= 1; from
< argc
; from
++)
1865 if (argv
[from
][0] == '-')
1870 /* If we have found "--", don't consider
1871 any more arguments as options. */
1872 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1874 /* Leave the "--", and everything following it, at the end. */
1875 for (; from
< argc
; from
++)
1877 priority
[from
] = -100;
1883 /* Look for a match with a known old-fashioned option. */
1884 for (i
= 0; i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1885 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1887 options
[from
] = standard_args
[i
].nargs
;
1888 priority
[from
] = standard_args
[i
].priority
;
1889 if (from
+ standard_args
[i
].nargs
>= argc
)
1890 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1891 from
+= standard_args
[i
].nargs
;
1895 /* Look for a match with a known long option.
1896 MATCH is -1 if no match so far, -2 if two or more matches so far,
1897 >= 0 (the table index of the match) if just one match so far. */
1898 if (argv
[from
][1] == '-')
1901 thislen
= strlen (argv
[from
]);
1902 equals
= strchr (argv
[from
], '=');
1904 thislen
= equals
- argv
[from
];
1907 i
< sizeof (standard_args
) / sizeof (standard_args
[0]); i
++)
1908 if (standard_args
[i
].longname
1909 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1918 /* If we found exactly one match, use that. */
1921 options
[from
] = standard_args
[match
].nargs
;
1922 priority
[from
] = standard_args
[match
].priority
;
1923 /* If --OPTION=VALUE syntax is used,
1924 this option uses just one argv element. */
1927 if (from
+ options
[from
] >= argc
)
1928 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1929 from
+= options
[from
];
1931 /* FIXME When match < 0, shouldn't there be some error,
1932 or at least indication to the user that there was a
1939 /* Copy the arguments, in order of decreasing priority, to NEW. */
1941 while (incoming_used
< argc
)
1944 int best_priority
= -9999;
1946 /* Find the highest priority remaining option.
1947 If several have equal priority, take the first of them. */
1948 for (from
= 1; from
< argc
; from
++)
1950 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1952 best_priority
= priority
[from
];
1955 /* Skip option arguments--they are tied to the options. */
1956 if (options
[from
] > 0)
1957 from
+= options
[from
];
1963 /* Copy the highest priority remaining option, with its args, to NEW.
1964 Unless it is a duplicate of the previous one. */
1965 if (! (options
[best
] == 0
1966 && ! strcmp (new[to
- 1], argv
[best
])))
1968 new[to
++] = argv
[best
];
1969 for (i
= 0; i
< options
[best
]; i
++)
1970 new[to
++] = argv
[best
+ i
+ 1];
1973 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1975 /* Clear out this option in ARGV. */
1977 for (i
= 0; i
< options
[best
]; i
++)
1978 argv
[best
+ i
+ 1] = 0;
1981 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1985 memcpy (argv
, new, sizeof (char *) * argc
);
1992 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1993 doc
: /* Exit the Emacs job and kill it.
1994 If ARG is an integer, return ARG as the exit program code.
1995 If ARG is a string, stuff it as keyboard input.
1997 This function is called upon receipt of the signals SIGTERM
1998 or SIGHUP, and upon SIGINT in batch mode.
2000 The value of `kill-emacs-hook', if not void,
2001 is a list of functions (of no args),
2002 all of which are called before Emacs is actually killed. */)
2005 struct gcpro gcpro1
;
2012 if (!NILP (Vrun_hooks
))
2013 call1 (Vrun_hooks
, intern ("kill-emacs-hook"));
2017 shut_down_emacs (0, 0, STRINGP (arg
) ? arg
: Qnil
);
2019 /* If we have an auto-save list file,
2020 kill it because we are exiting Emacs deliberately (not crashing).
2021 Do it after shut_down_emacs, which does an auto-save. */
2022 if (STRINGP (Vauto_save_list_file_name
))
2023 unlink (SDATA (Vauto_save_list_file_name
));
2025 exit (INTEGERP (arg
) ? XINT (arg
) : EXIT_SUCCESS
);
2029 /* Perform an orderly shutdown of Emacs. Autosave any modified
2030 buffers, kill any child processes, clean up the terminal modes (if
2031 we're in the foreground), and other stuff like that. Don't perform
2032 any redisplay; this may be called when Emacs is shutting down in
2033 the background, or after its X connection has died.
2035 If SIG is a signal number, print a message for it.
2037 This is called by fatal signal handlers, X protocol error handlers,
2041 shut_down_emacs (int sig
, int no_x
, Lisp_Object stuff
)
2043 /* Prevent running of hooks from now on. */
2046 /* Don't update display from now on. */
2047 Vinhibit_redisplay
= Qt
;
2049 /* If we are controlling the terminal, reset terminal modes. */
2052 int pgrp
= EMACS_GETPGRP (0);
2055 if (EMACS_GET_TTY_PGRP (0, &tpgrp
) != -1
2058 reset_all_sys_modes ();
2059 if (sig
&& sig
!= SIGTERM
)
2060 fprintf (stderr
, "Fatal error (%d)", sig
);
2065 reset_all_sys_modes ();
2068 stuff_buffered_input (stuff
);
2070 inhibit_sentinels
= 1;
2071 kill_buffer_processes (Qnil
);
2072 Fdo_auto_save (Qt
, Qnil
);
2074 #ifdef CLASH_DETECTION
2075 unlock_all_files ();
2078 #if 0 /* This triggers a bug in XCloseDisplay and is not needed. */
2079 #ifdef HAVE_X_WINDOWS
2080 /* It's not safe to call intern here. Maybe we are crashing. */
2081 if (!noninteractive
&& SYMBOLP (Vinitial_window_system
)
2082 && SCHARS (SYMBOL_NAME (Vinitial_window_system
)) == 1
2083 && SREF (SYMBOL_NAME (Vinitial_window_system
), 0) == 'x'
2085 Fx_close_current_connection ();
2086 #endif /* HAVE_X_WINDOWS */
2090 /* There is a tendency for a SIGIO signal to arrive within exit,
2091 and cause a SIGHUP because the input descriptor is already closed. */
2093 signal (SIGIO
, SIG_IGN
);
2100 /* Do this only if terminating normally, we want glyph matrices
2101 etc. in a core dump. */
2102 if (sig
== 0 || sig
== SIGTERM
)
2104 check_glyph_memory ();
2105 check_message_stack ();
2113 ns_term_shutdown (sig
);
2121 /* FIXME: maybe this should go into header file, config.h seems the
2122 only one appropriate. */
2123 extern int unexec (const char *, const char *);
2125 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2126 doc
: /* Dump current state of Emacs into executable file FILENAME.
2127 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2128 This is used in the file `loadup.el' when building Emacs.
2130 You must run Emacs in batch mode in order to dump it. */)
2131 (Lisp_Object filename
, Lisp_Object symfile
)
2133 extern char my_edata
[];
2136 int count
= SPECPDL_INDEX ();
2140 if (! noninteractive
)
2141 error ("Dumping Emacs works only in batch mode");
2144 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2146 fprintf (stderr
, "**************************************************\n");
2147 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2148 fprintf (stderr
, "heap (%lu bytes). This usually means that exec-shield\n",
2150 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2151 fprintf (stderr
, "fail because of this. See the section about\n");
2152 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2153 fprintf (stderr
, "**************************************************\n");
2155 #endif /* GNU_LINUX */
2157 /* Bind `command-line-processed' to nil before dumping,
2158 so that the dumped Emacs will process its command line
2159 and set up to work with X windows if appropriate. */
2160 symbol
= intern ("command-line-processed");
2161 specbind (symbol
, Qnil
);
2163 CHECK_STRING (filename
);
2164 filename
= Fexpand_file_name (filename
, Qnil
);
2165 if (!NILP (symfile
))
2167 CHECK_STRING (symfile
);
2168 if (SCHARS (symfile
))
2169 symfile
= Fexpand_file_name (symfile
, Qnil
);
2173 Vpurify_flag
= Qnil
;
2176 set_time_zone_rule (dump_tz
);
2177 #ifndef LOCALTIME_CACHE
2178 /* Force a tz reload, since set_time_zone_rule doesn't. */
2184 /* Tell malloc where start of impure now is. */
2185 /* Also arrange for warnings when nearly out of space. */
2186 #ifndef SYSTEM_MALLOC
2188 /* On Windows, this was done before dumping, and that once suffices.
2189 Meanwhile, my_edata is not valid on Windows. */
2190 memory_warnings (my_edata
, malloc_warning
);
2191 #endif /* not WINDOWSNT */
2192 #if defined (HAVE_GTK_AND_PTHREAD) && !defined SYNC_INPUT
2193 /* Pthread may call malloc before main, and then we will get an endless
2194 loop, because pthread_self (see alloc.c) calls malloc the first time
2195 it is called on some systems. */
2196 reset_malloc_hooks ();
2198 #endif /* not SYSTEM_MALLOC */
2199 #ifdef DOUG_LEA_MALLOC
2200 malloc_state_ptr
= malloc_get_state ();
2203 #ifdef USE_MMAP_FOR_BUFFERS
2206 unexec (SDATA (filename
), !NILP (symfile
) ? SDATA (symfile
) : 0);
2207 #ifdef USE_MMAP_FOR_BUFFERS
2210 #ifdef DOUG_LEA_MALLOC
2211 free (malloc_state_ptr
);
2216 return unbind_to (count
, Qnil
);
2219 #endif /* not CANNOT_DUMP */
2222 /* Recover from setlocale (LC_ALL, ""). */
2226 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2227 so that numbers are read and printed properly for Emacs Lisp. */
2228 setlocale (LC_NUMERIC
, "C");
2231 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2234 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2236 if (! EQ (*plocale
, desired_locale
))
2238 *plocale
= desired_locale
;
2239 setlocale (category
, (STRINGP (desired_locale
)
2240 ? (char *) SDATA (desired_locale
)
2245 /* Set system time locale to match Vsystem_time_locale, if possible. */
2247 synchronize_system_time_locale (void)
2249 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2250 Vsystem_time_locale
);
2253 /* Set system messages locale to match Vsystem_messages_locale, if
2256 synchronize_system_messages_locale (void)
2259 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2260 Vsystem_messages_locale
);
2263 #endif /* HAVE_SETLOCALE */
2270 decode_env_path (const char *evarname
, const char *defalt
)
2272 const char *path
, *p
;
2273 Lisp_Object lpath
, element
, tem
;
2275 /* It's okay to use getenv here, because this function is only used
2276 to initialize variables when Emacs starts up, and isn't called
2279 path
= getenv (evarname
);
2285 /* Ensure values from the environment use the proper directory separator. */
2288 char *path_copy
= alloca (strlen (path
) + 1);
2289 strcpy (path_copy
, path
);
2290 dostounix_filename (path_copy
);
2297 p
= strchr (path
, SEPCHAR
);
2299 p
= path
+ strlen (path
);
2300 element
= (p
- path
? make_string (path
, p
- path
)
2301 : build_string ("."));
2303 /* Add /: to the front of the name
2304 if it would otherwise be treated as magic. */
2305 tem
= Ffind_file_name_handler (element
, Qt
);
2307 /* However, if the handler says "I'm safe",
2308 don't bother adding /:. */
2312 prop
= Fget (tem
, intern ("safe-magic"));
2318 element
= concat2 (build_string ("/:"), element
);
2320 lpath
= Fcons (element
, lpath
);
2326 return Fnreverse (lpath
);
2329 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2330 doc
: /* Return non-nil if the current emacs process is a daemon.
2331 If the daemon was given a name argument, return that name. */)
2336 return build_string (daemon_name
);
2343 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2344 doc
: /* Mark the Emacs daemon as being initialized.
2345 This finishes the daemonization process by doing the other half of detaching
2346 from the parent process and its tty file descriptors. */)
2352 error ("This function can only be called if emacs is run as a daemon");
2354 if (daemon_pipe
[1] < 0)
2355 error ("The daemon has already been initialized");
2357 if (NILP (Vafter_init_time
))
2358 error ("This function can only be called after loading the init files");
2360 /* Get rid of stdin, stdout and stderr. */
2361 nfd
= open ("/dev/null", O_RDWR
);
2367 /* Closing the pipe will notify the parent that it can exit.
2368 FIXME: In case some other process inherited the pipe, closing it here
2369 won't notify the parent because it's still open elsewhere, so we
2370 additionally send a byte, just to make sure the parent really exits.
2371 Instead, we should probably close the pipe in start-process and
2372 call-process to make sure the pipe is never inherited by
2374 write (daemon_pipe
[1], "\n", 1);
2375 close (daemon_pipe
[1]);
2376 /* Set it to an invalid value so we know we've already run this function. */
2377 daemon_pipe
[1] = -1;
2382 syms_of_emacs (void)
2384 Qfile_name_handler_alist
= intern_c_string ("file-name-handler-alist");
2385 staticpro (&Qfile_name_handler_alist
);
2388 defsubr (&Sdump_emacs
);
2391 defsubr (&Skill_emacs
);
2393 defsubr (&Sinvocation_name
);
2394 defsubr (&Sinvocation_directory
);
2395 defsubr (&Sdaemonp
);
2396 defsubr (&Sdaemon_initialized
);
2398 DEFVAR_LISP ("command-line-args", &Vcommand_line_args
,
2399 doc
: /* Args passed by shell to Emacs, as a list of strings.
2400 Many arguments are deleted from the list as they are processed. */);
2402 DEFVAR_LISP ("system-type", &Vsystem_type
,
2403 doc
: /* The value is a symbol indicating the type of operating system you are using.
2405 `gnu' compiled for a GNU Hurd system.
2406 `gnu/linux' compiled for a GNU/Linux system.
2407 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2408 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2409 `ms-dos' compiled as an MS-DOS application.
2410 `windows-nt' compiled as a native W32 application.
2411 `cygwin' compiled using the Cygwin library.
2412 Anything else (in Emacs 23.1, the possibilities are: aix, berkeley-unix,
2413 hpux, irix, lynxos 3.0.1, usg-unix-v) indicates some sort of Unix system. */);
2414 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2416 DEFVAR_LISP ("system-configuration", &Vsystem_configuration
,
2417 doc
: /* Value is string indicating configuration Emacs was built for.
2418 On MS-Windows, the value reflects the OS flavor and version on which
2419 Emacs is running. */);
2420 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2422 DEFVAR_LISP ("system-configuration-options", &Vsystem_configuration_options
,
2423 doc
: /* String containing the configuration options Emacs was built with. */);
2424 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2426 DEFVAR_BOOL ("noninteractive", &noninteractive1
,
2427 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2429 DEFVAR_LISP ("kill-emacs-hook", &Vkill_emacs_hook
,
2430 doc
: /* Hook to be run when `kill-emacs' is called.
2431 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2432 in other similar situations), functions placed on this hook should not
2433 expect to be able to interact with the user. To ask for confirmation,
2434 see `kill-emacs-query-functions' instead.
2436 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2437 `noninteractive' was non-nil. */);
2438 Vkill_emacs_hook
= Qnil
;
2440 DEFVAR_INT ("emacs-priority", &emacs_priority
,
2441 doc
: /* Priority for Emacs to run at.
2442 This value is effective only if set before Emacs is dumped,
2443 and only if the Emacs executable is installed with setuid to permit
2444 it to change priority. (Emacs sets its uid back to the real uid.)
2445 Currently, you need to define SET_EMACS_PRIORITY in `config.h'
2446 before you compile Emacs, to enable the code for this feature. */);
2449 DEFVAR_LISP ("path-separator", &Vpath_separator
,
2450 doc
: /* String containing the character that separates directories in
2451 search paths, such as PATH and other similar environment variables. */);
2454 Vpath_separator
= make_string (&c
, 1);
2457 DEFVAR_LISP ("invocation-name", &Vinvocation_name
,
2458 doc
: /* The program name that was used to run Emacs.
2459 Any directory names are omitted. */);
2461 DEFVAR_LISP ("invocation-directory", &Vinvocation_directory
,
2462 doc
: /* The directory in which the Emacs executable was found, to run it.
2463 The value is nil if that directory's name is not known. */);
2465 DEFVAR_LISP ("installation-directory", &Vinstallation_directory
,
2466 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2467 This is non-nil when we can't find those directories in their standard
2468 installed locations, but we can find them near where the Emacs executable
2470 Vinstallation_directory
= Qnil
;
2472 DEFVAR_LISP ("system-messages-locale", &Vsystem_messages_locale
,
2473 doc
: /* System locale for messages. */);
2474 Vsystem_messages_locale
= Qnil
;
2476 DEFVAR_LISP ("previous-system-messages-locale",
2477 &Vprevious_system_messages_locale
,
2478 doc
: /* Most recently used system locale for messages. */);
2479 Vprevious_system_messages_locale
= Qnil
;
2481 DEFVAR_LISP ("system-time-locale", &Vsystem_time_locale
,
2482 doc
: /* System locale for time. */);
2483 Vsystem_time_locale
= Qnil
;
2485 DEFVAR_LISP ("previous-system-time-locale", &Vprevious_system_time_locale
,
2486 doc
: /* Most recently used system locale for time. */);
2487 Vprevious_system_time_locale
= Qnil
;
2489 DEFVAR_LISP ("before-init-time", &Vbefore_init_time
,
2490 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2491 Vbefore_init_time
= Qnil
;
2493 DEFVAR_LISP ("after-init-time", &Vafter_init_time
,
2494 doc
: /* Value of `current-time' after loading the init files.
2495 This is nil during initialization. */);
2496 Vafter_init_time
= Qnil
;
2498 DEFVAR_BOOL ("inhibit-x-resources", &inhibit_x_resources
,
2499 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2500 inhibit_x_resources
= 0;
2502 DEFVAR_LISP ("emacs-copyright", &Vemacs_copyright
,
2503 doc
: /* Short copyright string for this version of Emacs. */);
2504 Vemacs_copyright
= build_string (emacs_copyright
);
2506 DEFVAR_LISP ("emacs-version", &Vemacs_version
,
2507 doc
: /* Version numbers of this version of Emacs. */);
2508 Vemacs_version
= build_string (emacs_version
);
2510 /* Make sure IS_DAEMON starts up as false. */
2514 /* arch-tag: 7bfd356a-c720-4612-8ab6-aa4222931c2e
2515 (do not change this comment) */