1 /* Client process that communicates with GNU Emacs acting as server.
3 Copyright (C) 1986-1987, 1994, 1999-2016 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or (at
10 your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
25 /* ms-w32.h defines these, which disables sockets altogether! */
32 # include <commctrl.h>
34 # include <winsock2.h>
36 # define NO_SOCKETS_IN_FILE_SYSTEM
38 # define HSOCKET SOCKET
39 # define CLOSE_SOCKET closesocket
40 # define INITIALIZE() (initialize_sockets ())
42 char *w32_getenv (const char *);
43 #define egetenv(VAR) w32_getenv(VAR)
45 #else /* !WINDOWSNT */
49 # endif /* HAVE_NTGUI */
53 # ifdef HAVE_INET_SOCKETS
54 # include <netinet/in.h>
56 # include <sys/types.h>
57 # include <sys/socket.h>
59 # endif /* HAVE_SOCKETS */
61 # include <arpa/inet.h>
63 # define INVALID_SOCKET -1
65 # define CLOSE_SOCKET close
68 #define egetenv(VAR) getenv(VAR)
70 #endif /* !WINDOWSNT */
86 #define VERSION "unspecified"
91 #define EXIT_SUCCESS 0
95 #define EXIT_FAILURE 1
98 /* Additional space when allocating buffers for filenames, etc. */
99 #define EXTRA_SPACE 100
104 #define min(x, y) (((x) < (y)) ? (x) : (y))
107 /* Name used to invoke this program. */
108 const char *progname
;
110 /* The second argument to main. */
113 /* Nonzero means don't wait for a response from Emacs. --no-wait. */
116 /* Nonzero means don't print messages for successful operations. --quiet. */
119 /* Nonzero means args are expressions to be evaluated. --eval. */
122 /* Nonzero means don't open a new frame. Inverse of --create-frame. */
123 int current_frame
= 1;
125 /* The display on which Emacs should work. --display. */
126 const char *display
= NULL
;
128 /* The alternate display we should try if Emacs does not support display. */
129 const char *alt_display
= NULL
;
131 /* The parent window ID, if we are opening a frame via XEmbed. */
132 char *parent_id
= NULL
;
134 /* Nonzero means open a new Emacs frame on the current terminal. */
137 /* If non-NULL, the name of an editor to fallback to if the server
138 is not running. --alternate-editor. */
139 const char *alternate_editor
= NULL
;
141 /* If non-NULL, the filename of the UNIX socket. */
142 const char *socket_name
= NULL
;
144 /* If non-NULL, the filename of the authentication file. */
145 const char *server_file
= NULL
;
147 /* PID of the Emacs server process. */
150 /* If non-NULL, a string that should form a frame parameter alist to
151 be used for the new frame. */
152 const char *frame_parameters
= NULL
;
154 static _Noreturn
void print_help_and_exit (void);
157 struct option longopts
[] =
159 { "no-wait", no_argument
, NULL
, 'n' },
160 { "quiet", no_argument
, NULL
, 'q' },
161 { "eval", no_argument
, NULL
, 'e' },
162 { "help", no_argument
, NULL
, 'H' },
163 { "version", no_argument
, NULL
, 'V' },
164 { "tty", no_argument
, NULL
, 't' },
165 { "nw", no_argument
, NULL
, 't' },
166 { "create-frame", no_argument
, NULL
, 'c' },
167 { "alternate-editor", required_argument
, NULL
, 'a' },
168 { "frame-parameters", required_argument
, NULL
, 'F' },
169 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
170 { "socket-name", required_argument
, NULL
, 's' },
172 { "server-file", required_argument
, NULL
, 'f' },
173 { "display", required_argument
, NULL
, 'd' },
174 { "parent-id", required_argument
, NULL
, 'p' },
179 /* Like malloc but get fatal error if memory is exhausted. */
182 xmalloc (size_t size
)
184 void *result
= malloc (size
);
194 #if !defined (HAVE_GET_CURRENT_DIR_NAME) || defined (BROKEN_GET_CURRENT_DIR_NAME)
196 char *get_current_dir_name (void);
198 /* Return the current working directory. Returns NULL on errors.
199 Any other returned value must be freed with free. This is used
200 only when get_current_dir_name is not defined on the system. */
202 get_current_dir_name (void)
206 struct stat dotstat
, pwdstat
;
207 /* If PWD is accurate, use it instead of calling getcwd. PWD is
208 sometimes a nicer name, and using it may avoid a fatal error if a
209 parent directory is searchable but not readable. */
210 if ((pwd
= egetenv ("PWD")) != 0
211 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
212 && stat (pwd
, &pwdstat
) == 0
213 && stat (".", &dotstat
) == 0
214 && dotstat
.st_ino
== pwdstat
.st_ino
215 && dotstat
.st_dev
== pwdstat
.st_dev
217 && strlen (pwd
) < MAXPATHLEN
221 buf
= (char *) xmalloc (strlen (pwd
) + 1);
226 size_t buf_size
= 1024;
230 buf
= malloc (buf_size
);
233 if (getcwd (buf
, buf_size
) == buf
)
237 if (tmp_errno
!= ERANGE
)
256 /* Like strdup but get a fatal error if memory is exhausted. */
257 char *xstrdup (const char *);
260 xstrdup (const char *s
)
262 char *result
= strdup (s
);
271 #define REG_ROOT "SOFTWARE\\GNU\\Emacs"
273 char *w32_get_resource (HKEY
, const char *, LPDWORD
);
275 /* Retrieve an environment variable from the Emacs subkeys of the registry.
276 Return NULL if the variable was not found, or it was empty.
277 This code is based on w32_get_resource (w32.c). */
279 w32_get_resource (HKEY predefined
, const char *key
, LPDWORD type
)
281 HKEY hrootkey
= NULL
;
285 if (RegOpenKeyEx (predefined
, REG_ROOT
, 0, KEY_READ
, &hrootkey
) == ERROR_SUCCESS
)
287 if (RegQueryValueEx (hrootkey
, key
, NULL
, NULL
, NULL
, &cbData
) == ERROR_SUCCESS
)
289 result
= (char *) xmalloc (cbData
);
291 if ((RegQueryValueEx (hrootkey
, key
, NULL
, type
, (LPBYTE
)result
, &cbData
) != ERROR_SUCCESS
)
299 RegCloseKey (hrootkey
);
306 getenv wrapper for Windows
308 Value is allocated on the heap, and can be free'd.
310 This is needed to duplicate Emacs's behavior, which is to look for
311 environment variables in the registry if they don't appear in the
314 w32_getenv (const char *envvar
)
319 if ((value
= getenv (envvar
)))
320 /* Found in the environment. strdup it, because values returned
321 by getenv cannot be free'd. */
322 return xstrdup (value
);
324 if (! (value
= w32_get_resource (HKEY_CURRENT_USER
, envvar
, &dwType
)) &&
325 ! (value
= w32_get_resource (HKEY_LOCAL_MACHINE
, envvar
, &dwType
)))
327 /* "w32console" is what Emacs on Windows uses for tty-type under -nw. */
328 if (strcmp (envvar
, "TERM") == 0)
329 return xstrdup ("w32console");
330 /* Found neither in the environment nor in the registry. */
334 if (dwType
== REG_SZ
)
335 /* Registry; no need to expand. */
338 if (dwType
== REG_EXPAND_SZ
)
342 if ((size
= ExpandEnvironmentStrings (value
, NULL
, 0)))
344 char *buffer
= (char *) xmalloc (size
);
345 if (ExpandEnvironmentStrings (value
, buffer
, size
))
347 /* Found and expanded. */
352 /* Error expanding. */
357 /* Not the right type, or not correctly expanded. */
362 int w32_window_app (void);
365 w32_window_app (void)
367 static int window_app
= -1;
368 char szTitle
[MAX_PATH
];
372 /* Checking for STDOUT does not work; it's a valid handle also in
373 nonconsole apps. Testing for the console title seems to work. */
374 window_app
= (GetConsoleTitleA (szTitle
, MAX_PATH
) == 0);
376 InitCommonControls ();
382 /* execvp wrapper for Windows. Quotes arguments with embedded spaces.
384 This is necessary due to the broken implementation of exec* routines in
385 the Microsoft libraries: they concatenate the arguments together without
386 quoting special characters, and pass the result to CreateProcess, with
387 predictably bad results. By contrast, POSIX execvp passes the arguments
388 directly into the argv array of the child process. */
390 int w32_execvp (const char *, char **);
393 w32_execvp (const char *path
, char **argv
)
397 /* Required to allow a .BAT script as alternate editor. */
398 argv
[0] = (char *) alternate_editor
;
400 for (i
= 0; argv
[i
]; i
++)
401 if (strchr (argv
[i
], ' '))
403 char *quoted
= alloca (strlen (argv
[i
]) + 3);
404 sprintf (quoted
, "\"%s\"", argv
[i
]);
408 return execvp (path
, argv
);
412 #define execvp w32_execvp
414 /* Emulation of ttyname for Windows. */
415 const char *ttyname (int);
422 #endif /* WINDOWSNT */
424 /* Display a normal or error message.
425 On Windows, use a message box if compiled as a Windows app. */
426 static void message (bool, const char *, ...) ATTRIBUTE_FORMAT_PRINTF (2, 3);
428 message (bool is_error
, const char *format
, ...)
432 va_start (args
, format
);
435 if (w32_window_app ())
438 vsnprintf (msg
, sizeof msg
, format
, args
);
439 msg
[sizeof msg
- 1] = '\0';
442 MessageBox (NULL
, msg
, "Emacsclient ERROR", MB_ICONERROR
);
444 MessageBox (NULL
, msg
, "Emacsclient", MB_ICONINFORMATION
);
449 FILE *f
= is_error
? stderr
: stdout
;
451 vfprintf (f
, format
, args
);
458 /* Decode the options from argv and argc.
459 The global variable `optind' will say how many arguments we used up. */
462 decode_options (int argc
, char **argv
)
464 alternate_editor
= egetenv ("ALTERNATE_EDITOR");
468 int opt
= getopt_long_only (argc
, argv
,
469 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
482 /* If getopt returns 0, then it has already processed a
483 long-named option. We should do nothing. */
487 alternate_editor
= optarg
;
490 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
492 socket_name
= optarg
;
497 server_file
= optarg
;
500 /* We used to disallow this argument in w32, but it seems better
501 to allow it, for the occasional case where the user is
502 connecting with a w32 client to a server compiled with X11
521 message (false, "emacsclient %s\n", VERSION
);
540 print_help_and_exit ();
544 frame_parameters
= optarg
;
548 message (true, "Try '%s --help' for more information\n", progname
);
554 /* If the -c option is used (without -t) and no --display argument
555 is provided, try $DISPLAY.
556 Without the -c option, we used to set `display' to $DISPLAY by
557 default, but this changed the default behavior and is sometimes
558 inconvenient. So we force users to use "--display $DISPLAY" if
559 they want Emacs to connect to their current display.
561 Some window systems have a notion of default display not
562 reflected in the DISPLAY variable. If the user didn't give us an
563 explicit display, try this platform-specific after trying the
564 display in DISPLAY (if any). */
565 if (!current_frame
&& !tty
&& !display
)
567 /* Set these here so we use a default_display only when the user
568 didn't give us an explicit display. */
569 #if defined (NS_IMPL_COCOA)
571 #elif defined (HAVE_NTGUI)
575 display
= egetenv ("DISPLAY");
580 display
= alt_display
;
584 /* A null-string display is invalid. */
585 if (display
&& strlen (display
) == 0)
588 /* If no display is available, new frames are tty frames. */
589 if (!current_frame
&& !display
)
593 /* Emacs on Windows does not support graphical and text terminal
594 frames in the same instance. So, treat the -t and -c options as
595 equivalent, and open a new frame on the server's terminal.
596 Ideally, we would only set tty = 1 when the serve is running in a
597 console, but alas we don't know that. As a workaround, always
598 ask for a tty frame, and let server.el figure it out. */
604 #endif /* WINDOWSNT */
608 static _Noreturn
void
609 print_help_and_exit (void)
611 /* Spaces and tabs are significant in this message; they're chosen so the
612 message aligns properly both in a tty and in a Windows message box.
613 Please try to preserve them; otherwise the output is very hard to read
614 when using emacsclientw. */
616 "Usage: %s [OPTIONS] FILE...\n%s%s%s", progname
, "\
617 Tell the Emacs server to visit the specified files.\n\
618 Every FILE can be either just a FILENAME or [+LINE[:COLUMN]] FILENAME.\n\
620 The following OPTIONS are accepted:\n\
621 -V, --version Just print version info and return\n\
622 -H, --help Print this usage information message\n\
623 -nw, -t, --tty Open a new Emacs frame on the current terminal\n\
624 -c, --create-frame Create a new frame instead of trying to\n\
625 use the current Emacs frame\n\
627 -F ALIST, --frame-parameters=ALIST\n\
628 Set the parameters of a new frame\n\
629 -e, --eval Evaluate the FILE arguments as ELisp expressions\n\
630 -n, --no-wait Don't wait for the server to return\n\
631 -q, --quiet Don't display messages on success\n\
632 -d DISPLAY, --display=DISPLAY\n\
633 Visit the file in the given display\n\
635 --parent-id=ID Open in parent window ID, via XEmbed\n"
636 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
637 "-s SOCKET, --socket-name=SOCKET\n\
638 Set filename of the UNIX socket for communication\n"
640 "-f SERVER, --server-file=SERVER\n\
641 Set filename of the TCP authentication file\n\
642 -a EDITOR, --alternate-editor=EDITOR\n\
643 Editor to fallback to if the server is not running\n"
644 " If EDITOR is the empty string, start Emacs in daemon\n\
645 mode and try connecting again\n"
647 Report bugs with M-x report-emacs-bug.\n");
651 /* Try to run a different command, or --if no alternate editor is
652 defined-- exit with an errorcode.
653 Uses argv, but gets it from the global variable main_argv. */
655 static _Noreturn
void
658 if (alternate_editor
)
662 execvp (alternate_editor
, main_argv
+ i
);
663 message (true, "%s: error executing alternate editor \"%s\"\n",
664 progname
, alternate_editor
);
670 #if !defined (HAVE_SOCKETS) || !defined (HAVE_INET_SOCKETS)
673 main (int argc
, char **argv
)
677 message (true, "%s: Sorry, the Emacs server is supported only\n"
678 "on systems with Berkeley sockets.\n",
683 #else /* HAVE_SOCKETS && HAVE_INET_SOCKETS */
685 #define AUTH_KEY_LENGTH 64
686 #define SEND_BUFFER_SIZE 4096
688 /* Buffer to accumulate data to send in TCP connections. */
689 char send_buffer
[SEND_BUFFER_SIZE
+ 1];
690 int sblen
= 0; /* Fill pointer for the send buffer. */
691 /* Socket used to communicate with the Emacs server process. */
692 HSOCKET emacs_socket
= 0;
694 /* On Windows, the socket library was historically separate from the
695 standard C library, so errors are handled differently. */
698 sock_err_message (const char *function_name
)
703 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
704 | FORMAT_MESSAGE_ALLOCATE_BUFFER
705 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
706 NULL
, WSAGetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
708 message (true, "%s: %s: %s\n", progname
, function_name
, msg
);
712 message (true, "%s: %s: %s\n", progname
, function_name
, strerror (errno
));
717 /* Let's send the data to Emacs when either
718 - the data ends in "\n", or
719 - the buffer is full (but this shouldn't happen)
720 Otherwise, we just accumulate it. */
722 send_to_emacs (HSOCKET s
, const char *data
)
729 dlen
= strlen (data
);
732 size_t part
= min (dlen
, SEND_BUFFER_SIZE
- sblen
);
733 memcpy (&send_buffer
[sblen
], data
, part
);
737 if (sblen
== SEND_BUFFER_SIZE
738 || (sblen
> 0 && send_buffer
[sblen
-1] == '\n'))
740 int sent
= send (s
, send_buffer
, sblen
, 0);
743 message (true, "%s: failed to send %d bytes to socket: %s\n",
744 progname
, sblen
, strerror (errno
));
748 memmove (send_buffer
, &send_buffer
[sent
], sblen
- sent
);
757 /* In STR, insert a & before each &, each space, each newline, and
758 any initial -. Change spaces to underscores, too, so that the
759 return value never contains a space.
761 Does not change the string. Outputs the result to S. */
763 quote_argument (HSOCKET s
, const char *str
)
765 char *copy
= (char *) xmalloc (strlen (str
) * 2 + 1);
787 if (*p
== '&' || (*p
== '-' && p
== str
))
794 send_to_emacs (s
, copy
);
800 /* The inverse of quote_argument. Removes quoting in string STR by
801 modifying the string in place. Returns STR. */
804 unquote_argument (char *str
)
835 file_name_absolute_p (const char *filename
)
837 /* Sanity check, it shouldn't happen. */
838 if (! filename
) return false;
840 /* /xxx is always an absolute path. */
841 if (filename
[0] == '/') return true;
843 /* Empty filenames (which shouldn't happen) are relative. */
844 if (filename
[0] == '\0') return false;
847 /* X:\xxx is always absolute. */
848 if (isalpha ((unsigned char) filename
[0])
849 && filename
[1] == ':' && (filename
[2] == '\\' || filename
[2] == '/'))
852 /* Both \xxx and \\xxx\yyy are absolute. */
853 if (filename
[0] == '\\') return true;
860 /* Wrapper to make WSACleanup a cdecl, as required by atexit. */
861 void __cdecl
close_winsock (void);
868 /* Initialize the WinSock2 library. */
869 void initialize_sockets (void);
871 initialize_sockets (void)
875 if (WSAStartup (MAKEWORD (2, 0), &wsaData
))
877 message (true, "%s: error initializing WinSock2\n", progname
);
881 atexit (close_winsock
);
883 #endif /* WINDOWSNT */
886 /* Read the information needed to set up a TCP comm channel with
887 the Emacs server: host, port, and authentication string. */
890 get_server_config (const char *config_file
, struct sockaddr_in
*server
,
891 char *authentication
)
897 if (file_name_absolute_p (config_file
))
898 config
= fopen (config_file
, "rb");
901 const char *home
= egetenv ("HOME");
905 char *path
= xmalloc (strlen (home
) + strlen (config_file
)
907 char *z
= stpcpy (path
, home
);
908 z
= stpcpy (z
, "/.emacs.d/server/");
909 strcpy (z
, config_file
);
910 config
= fopen (path
, "rb");
914 if (!config
&& (home
= egetenv ("APPDATA")))
916 char *path
= xmalloc (strlen (home
) + strlen (config_file
)
918 char *z
= stpcpy (path
, home
);
919 z
= stpcpy (z
, "/.emacs.d/server/");
920 strcpy (z
, config_file
);
921 config
= fopen (path
, "rb");
930 if (fgets (dotted
, sizeof dotted
, config
)
931 && (port
= strchr (dotted
, ':')))
935 message (true, "%s: invalid configuration info\n", progname
);
939 server
->sin_family
= AF_INET
;
940 server
->sin_addr
.s_addr
= inet_addr (dotted
);
941 server
->sin_port
= htons (atoi (port
));
943 if (! fread (authentication
, AUTH_KEY_LENGTH
, 1, config
))
945 message (true, "%s: cannot read authentication info\n", progname
);
955 set_tcp_socket (const char *local_server_file
)
958 struct sockaddr_in server
;
959 struct linger l_arg
= {1, 1};
960 char auth_string
[AUTH_KEY_LENGTH
+ 1];
962 if (! get_server_config (local_server_file
, &server
, auth_string
))
963 return INVALID_SOCKET
;
965 if (server
.sin_addr
.s_addr
!= inet_addr ("127.0.0.1") && !quiet
)
966 message (false, "%s: connected to remote socket at %s\n",
967 progname
, inet_ntoa (server
.sin_addr
));
969 /* Open up an AF_INET socket. */
970 if ((s
= socket (AF_INET
, SOCK_STREAM
, IPPROTO_TCP
)) < 0)
972 /* Since we have an alternate to try out, this is not an error
973 yet; popping out a modal dialog at this stage would make -a
974 option totally useless for emacsclientw -- the user will
975 still get an error message if the alternate editor fails. */
977 if(!(w32_window_app () && alternate_editor
))
979 sock_err_message ("socket");
980 return INVALID_SOCKET
;
983 /* Set up the socket. */
984 if (connect (s
, (struct sockaddr
*) &server
, sizeof server
) < 0)
987 if(!(w32_window_app () && alternate_editor
))
989 sock_err_message ("connect");
990 return INVALID_SOCKET
;
993 setsockopt (s
, SOL_SOCKET
, SO_LINGER
, (char *) &l_arg
, sizeof l_arg
);
995 /* Send the authentication. */
996 auth_string
[AUTH_KEY_LENGTH
] = '\0';
998 send_to_emacs (s
, "-auth ");
999 send_to_emacs (s
, auth_string
);
1000 send_to_emacs (s
, " ");
1006 /* Returns 1 if PREFIX is a prefix of STRING. */
1008 strprefix (const char *prefix
, const char *string
)
1010 return !strncmp (prefix
, string
, strlen (prefix
));
1013 /* Get tty name and type. If successful, return the type in TTY_TYPE
1014 and the name in TTY_NAME, and return 1. Otherwise, fail if NOABORT
1015 is zero, or return 0 if NOABORT is non-zero. */
1018 find_tty (const char **tty_type
, const char **tty_name
, int noabort
)
1020 const char *type
= egetenv ("TERM");
1021 const char *name
= ttyname (fileno (stdout
));
1029 message (true, "%s: could not get terminal name\n", progname
);
1040 message (true, "%s: please set the TERM variable to your terminal type\n",
1046 if (strcmp (type
, "eterm") == 0)
1052 /* This causes nasty, MULTI_KBOARD-related input lockouts. */
1053 message (true, "%s: opening a frame in an Emacs term buffer"
1054 " is not supported\n", progname
);
1065 #if !defined (NO_SOCKETS_IN_FILE_SYSTEM)
1067 /* Three possibilities:
1068 2 - can't be `stat'ed (sets errno)
1069 1 - isn't owned by us
1070 0 - success: none of the above */
1073 socket_status (const char *name
)
1075 struct stat statbfr
;
1077 if (stat (name
, &statbfr
) == -1)
1080 if (statbfr
.st_uid
!= geteuid ())
1087 /* A signal handler that passes the signal to the Emacs process.
1088 Useful for SIGWINCH. */
1091 pass_signal_to_emacs (int signalnum
)
1093 int old_errno
= errno
;
1096 kill (emacs_pid
, signalnum
);
1098 signal (signalnum
, pass_signal_to_emacs
);
1102 /* Signal handler for SIGCONT; notify the Emacs process that it can
1103 now resume our tty frame. */
1106 handle_sigcont (int signalnum
)
1108 int old_errno
= errno
;
1109 pid_t pgrp
= getpgrp ();
1110 pid_t tcpgrp
= tcgetpgrp (1);
1114 /* We are in the foreground. */
1115 send_to_emacs (emacs_socket
, "-resume \n");
1117 else if (0 <= tcpgrp
&& tty
)
1119 /* We are in the background; cancel the continue. */
1120 kill (-pgrp
, SIGTTIN
);
1123 signal (signalnum
, handle_sigcont
);
1127 /* Signal handler for SIGTSTP; notify the Emacs process that we are
1128 going to sleep. Normally the suspend is initiated by Emacs via
1129 server-handle-suspend-tty, but if the server gets out of sync with
1130 reality, we may get a SIGTSTP on C-z. Handling this signal and
1131 notifying Emacs about it should get things under control again. */
1134 handle_sigtstp (int signalnum
)
1136 int old_errno
= errno
;
1140 send_to_emacs (emacs_socket
, "-suspend \n");
1142 /* Unblock this signal and call the default handler by temporarily
1143 changing the handler and resignaling. */
1144 sigprocmask (SIG_BLOCK
, NULL
, &set
);
1145 sigdelset (&set
, signalnum
);
1146 signal (signalnum
, SIG_DFL
);
1148 sigprocmask (SIG_SETMASK
, &set
, NULL
); /* Let's the above signal through. */
1149 signal (signalnum
, handle_sigtstp
);
1155 /* Set up signal handlers before opening a frame on the current tty. */
1160 /* Set up signal handlers. */
1161 signal (SIGWINCH
, pass_signal_to_emacs
);
1163 /* Don't pass SIGINT and SIGQUIT to Emacs, because it has no way of
1164 deciding which terminal the signal came from. C-g is now a
1165 normal input event on secondary terminals. */
1167 signal (SIGINT
, pass_signal_to_emacs
);
1168 signal (SIGQUIT
, pass_signal_to_emacs
);
1171 signal (SIGCONT
, handle_sigcont
);
1172 signal (SIGTSTP
, handle_sigtstp
);
1173 signal (SIGTTOU
, handle_sigtstp
);
1178 set_local_socket (const char *local_socket_name
)
1181 struct sockaddr_un server
;
1183 /* Open up an AF_UNIX socket in this person's home directory. */
1184 if ((s
= socket (AF_UNIX
, SOCK_STREAM
, 0)) < 0)
1186 message (true, "%s: socket: %s\n", progname
, strerror (errno
));
1187 return INVALID_SOCKET
;
1190 server
.sun_family
= AF_UNIX
;
1195 const char *server_name
= local_socket_name
;
1196 const char *tmpdir
= NULL
;
1197 char *tmpdir_storage
= NULL
;
1198 char *socket_name_storage
= NULL
;
1200 if (!strchr (local_socket_name
, '/') && !strchr (local_socket_name
, '\\'))
1202 /* socket_name is a file name component. */
1203 long uid
= geteuid ();
1204 tmpdir
= egetenv ("TMPDIR");
1208 #ifndef _CS_DARWIN_USER_TEMP_DIR
1209 #define _CS_DARWIN_USER_TEMP_DIR 65537
1211 size_t n
= confstr (_CS_DARWIN_USER_TEMP_DIR
, NULL
, (size_t) 0);
1214 tmpdir
= tmpdir_storage
= xmalloc (n
);
1215 confstr (_CS_DARWIN_USER_TEMP_DIR
, tmpdir_storage
, n
);
1221 socket_name_storage
=
1222 xmalloc (strlen (tmpdir
) + strlen (server_name
) + EXTRA_SPACE
);
1223 char *z
= stpcpy (socket_name_storage
, tmpdir
);
1224 z
+= sprintf (z
, "/emacs%ld/", uid
);
1225 strcpy (z
, server_name
);
1226 local_socket_name
= socket_name_storage
;
1229 if (strlen (local_socket_name
) < sizeof (server
.sun_path
))
1230 strcpy (server
.sun_path
, local_socket_name
);
1233 message (true, "%s: socket-name %s too long\n",
1234 progname
, local_socket_name
);
1238 /* See if the socket exists, and if it's owned by us. */
1239 sock_status
= socket_status (server
.sun_path
);
1240 saved_errno
= errno
;
1241 if (sock_status
&& tmpdir
)
1243 /* Failing that, see if LOGNAME or USER exist and differ from
1244 our euid. If so, look for a socket based on the UID
1245 associated with the name. This is reminiscent of the logic
1246 that init_editfns uses to set the global Vuser_full_name. */
1248 const char *user_name
= egetenv ("LOGNAME");
1251 user_name
= egetenv ("USER");
1255 struct passwd
*pw
= getpwnam (user_name
);
1257 if (pw
&& (pw
->pw_uid
!= geteuid ()))
1259 /* We're running under su, apparently. */
1260 long uid
= pw
->pw_uid
;
1261 char *user_socket_name
1262 = xmalloc (strlen (tmpdir
) + strlen (server_name
)
1264 char *z
= stpcpy (user_socket_name
, tmpdir
);
1265 z
+= sprintf (z
, "/emacs%ld/", uid
);
1266 strcpy (z
, server_name
);
1268 if (strlen (user_socket_name
) < sizeof (server
.sun_path
))
1269 strcpy (server
.sun_path
, user_socket_name
);
1272 message (true, "%s: socket-name %s too long\n",
1273 progname
, user_socket_name
);
1274 exit (EXIT_FAILURE
);
1276 free (user_socket_name
);
1278 sock_status
= socket_status (server
.sun_path
);
1279 saved_errno
= errno
;
1282 errno
= saved_errno
;
1286 free (socket_name_storage
);
1287 free (tmpdir_storage
);
1289 switch (sock_status
)
1292 /* There's a socket, but it isn't owned by us. This is OK if
1294 if (0 != geteuid ())
1296 message (true, "%s: Invalid socket owner\n", progname
);
1297 return INVALID_SOCKET
;
1303 if (saved_errno
== ENOENT
)
1305 "%s: can't find socket; have you started the server?\n\
1306 To start the server in Emacs, type \"M-x server-start\".\n",
1309 message (true, "%s: can't stat %s: %s\n",
1310 progname
, server
.sun_path
, strerror (saved_errno
));
1311 return INVALID_SOCKET
;
1315 if (connect (s
, (struct sockaddr
*) &server
, strlen (server
.sun_path
) + 2)
1318 message (true, "%s: connect: %s\n", progname
, strerror (errno
));
1319 return INVALID_SOCKET
;
1324 #endif /* ! NO_SOCKETS_IN_FILE_SYSTEM */
1327 set_socket (int no_exit_if_error
)
1330 const char *local_server_file
= server_file
;
1334 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1335 /* Explicit --socket-name argument. */
1338 s
= set_local_socket (socket_name
);
1339 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1341 message (true, "%s: error accessing socket \"%s\"\n",
1342 progname
, socket_name
);
1343 exit (EXIT_FAILURE
);
1347 /* Explicit --server-file arg or EMACS_SERVER_FILE variable. */
1348 if (!local_server_file
)
1349 local_server_file
= egetenv ("EMACS_SERVER_FILE");
1351 if (local_server_file
)
1353 s
= set_tcp_socket (local_server_file
);
1354 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1357 message (true, "%s: error accessing server file \"%s\"\n",
1358 progname
, local_server_file
);
1359 exit (EXIT_FAILURE
);
1362 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1363 /* Implicit local socket. */
1364 s
= set_local_socket ("server");
1365 if (s
!= INVALID_SOCKET
)
1369 /* Implicit server file. */
1370 s
= set_tcp_socket ("server");
1371 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1374 /* No implicit or explicit socket, and no alternate editor. */
1375 message (true, "%s: No socket or alternate editor. Please use:\n\n"
1376 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1379 "\t--server-file (or environment variable EMACS_SERVER_FILE)\n\
1380 \t--alternate-editor (or environment variable ALTERNATE_EDITOR)\n",
1382 exit (EXIT_FAILURE
);
1386 FARPROC set_fg
; /* Pointer to AllowSetForegroundWindow. */
1387 FARPROC get_wc
; /* Pointer to RealGetWindowClassA. */
1389 void w32_set_user_model_id (void);
1392 w32_set_user_model_id (void)
1395 HRESULT (WINAPI
* set_user_model
) (const wchar_t * id
);
1397 /* On Windows 7 and later, we need to set the user model ID
1398 to associate emacsclient launched files with Emacs frames
1400 shell
= LoadLibrary ("shell32.dll");
1404 = (void *) GetProcAddress (shell
,
1405 "SetCurrentProcessExplicitAppUserModelID");
1406 /* If the function is defined, then we are running on Windows 7
1407 or newer, and the UI uses this to group related windows
1408 together. Since emacs, runemacs, emacsclient are related, we
1409 want them grouped even though the executables are different,
1410 so we need to set a consistent ID between them. */
1412 set_user_model (L
"GNU.Emacs");
1414 FreeLibrary (shell
);
1418 BOOL CALLBACK
w32_find_emacs_process (HWND
, LPARAM
);
1421 w32_find_emacs_process (HWND hWnd
, LPARAM lParam
)
1426 /* Reject any window not of class "Emacs". */
1427 if (! get_wc (hWnd
, class, sizeof (class))
1428 || strcmp (class, "Emacs"))
1431 /* We only need the process id, not the thread id. */
1432 (void) GetWindowThreadProcessId (hWnd
, &pid
);
1434 /* Not the one we're looking for. */
1435 if (pid
!= (DWORD
) emacs_pid
) return TRUE
;
1437 /* OK, let's raise it. */
1440 /* Stop enumeration. */
1444 /* Search for a window of class "Emacs" and owned by a process with
1445 process id = emacs_pid. If found, allow it to grab the focus. */
1446 void w32_give_focus (void);
1449 w32_give_focus (void)
1453 /* It shouldn't happen when dealing with TCP sockets. */
1454 if (!emacs_pid
) return;
1456 user32
= GetModuleHandle ("user32.dll");
1461 /* Modern Windows restrict which processes can set the foreground window.
1462 emacsclient can allow Emacs to grab the focus by calling the function
1463 AllowSetForegroundWindow. Unfortunately, older Windows (W95, W98 and
1464 NT) lack this function, so we have to check its availability. */
1465 if ((set_fg
= GetProcAddress (user32
, "AllowSetForegroundWindow"))
1466 && (get_wc
= GetProcAddress (user32
, "RealGetWindowClassA")))
1467 EnumWindows (w32_find_emacs_process
, (LPARAM
) 0);
1469 #endif /* HAVE_NTGUI */
1471 /* Start the emacs daemon and try to connect to it. */
1474 start_daemon_and_retry_set_socket (void)
1485 w
= waitpid (dpid
, &status
, WUNTRACED
| WCONTINUED
);
1487 if ((w
== -1) || !WIFEXITED (status
) || WEXITSTATUS (status
))
1489 message (true, "Error: Could not start the Emacs daemon\n");
1490 exit (EXIT_FAILURE
);
1493 /* Try connecting, the daemon should have started by now. */
1494 message (true, "Emacs daemon should have started, trying to connect again\n");
1495 if ((emacs_socket
= set_socket (1)) == INVALID_SOCKET
)
1497 message (true, "Error: Cannot connect even after starting the Emacs daemon\n");
1498 exit (EXIT_FAILURE
);
1503 fprintf (stderr
, "Error: Cannot fork!\n");
1504 exit (EXIT_FAILURE
);
1508 char emacs
[] = "emacs";
1509 char daemon_option
[] = "--daemon";
1512 d_argv
[1] = daemon_option
;
1514 if (socket_name
!= NULL
)
1516 /* Pass --daemon=socket_name as argument. */
1517 const char *deq
= "--daemon=";
1518 char *daemon_arg
= xmalloc (strlen (deq
)
1519 + strlen (socket_name
) + 1);
1520 strcpy (stpcpy (daemon_arg
, deq
), socket_name
);
1521 d_argv
[1] = daemon_arg
;
1523 execvp ("emacs", d_argv
);
1524 message (true, "%s: error starting emacs daemon\n", progname
);
1526 #else /* WINDOWSNT */
1528 HANDLE w32_daemon_event
;
1530 PROCESS_INFORMATION pi
;
1532 ZeroMemory (&si
, sizeof si
);
1534 ZeroMemory (&pi
, sizeof pi
);
1536 /* We start Emacs in daemon mode, and then wait for it to signal us
1537 it is ready to accept client connections, by asserting an event
1538 whose name is known to the daemon (defined by nt/inc/ms-w32.h). */
1540 if (!CreateProcess (NULL
, (LPSTR
)"emacs --daemon", NULL
, NULL
, FALSE
,
1541 CREATE_NO_WINDOW
, NULL
, NULL
, &si
, &pi
))
1545 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
1546 | FORMAT_MESSAGE_ALLOCATE_BUFFER
1547 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
1548 NULL
, GetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
1549 message (true, "%s: error starting emacs daemon (%s)\n", progname
, msg
);
1550 exit (EXIT_FAILURE
);
1553 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1554 if (w32_daemon_event
== NULL
)
1556 message (true, "Couldn't create Windows daemon event");
1557 exit (EXIT_FAILURE
);
1559 if ((wait_result
= WaitForSingleObject (w32_daemon_event
, INFINITE
))
1562 const char *msg
= NULL
;
1564 switch (wait_result
)
1566 case WAIT_ABANDONED
:
1567 msg
= "The daemon exited unexpectedly";
1570 /* Can't happen due to INFINITE. */
1573 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
1574 | FORMAT_MESSAGE_ALLOCATE_BUFFER
1575 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
1576 NULL
, GetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
1579 message (true, "Error: Could not start the Emacs daemon: %s\n", msg
);
1580 exit (EXIT_FAILURE
);
1582 CloseHandle (w32_daemon_event
);
1584 /* Try connecting, the daemon should have started by now. */
1585 /* It's just a progress message, so don't pop a dialog if this is
1587 if (!w32_window_app ())
1589 "Emacs daemon should have started, trying to connect again\n");
1590 if ((emacs_socket
= set_socket (1)) == INVALID_SOCKET
)
1593 "Error: Cannot connect even after starting the Emacs daemon\n");
1594 exit (EXIT_FAILURE
);
1596 #endif /* WINDOWSNT */
1600 main (int argc
, char **argv
)
1602 int rl
= 0, needlf
= 0;
1604 char string
[BUFSIZ
+1];
1605 int start_daemon_if_needed
;
1606 int exit_status
= EXIT_SUCCESS
;
1612 /* On Windows 7 and later, we need to explicitly associate
1613 emacsclient with emacs so the UI behaves sensibly. This
1614 association does no harm if we're not actually connecting to an
1615 Emacs using a window display. */
1616 w32_set_user_model_id ();
1617 #endif /* HAVE_NTGUI */
1619 /* Process options. */
1620 decode_options (argc
, argv
);
1622 if ((argc
- optind
< 1) && !eval
&& current_frame
)
1624 message (true, "%s: file name or argument required\n"
1625 "Try '%s --help' for more information\n",
1626 progname
, progname
);
1627 exit (EXIT_FAILURE
);
1633 pid_t pgrp
= getpgrp ();
1634 pid_t tcpgrp
= tcgetpgrp (1);
1635 if (0 <= tcpgrp
&& tcpgrp
!= pgrp
)
1636 kill (-pgrp
, SIGTTIN
);
1638 #endif /* !WINDOWSNT */
1640 /* If alternate_editor is the empty string, start the emacs daemon
1641 in case of failure to connect. */
1642 start_daemon_if_needed
= (alternate_editor
1643 && (alternate_editor
[0] == '\0'));
1645 emacs_socket
= set_socket (alternate_editor
|| start_daemon_if_needed
);
1646 if (emacs_socket
== INVALID_SOCKET
)
1648 if (! start_daemon_if_needed
)
1651 start_daemon_and_retry_set_socket ();
1654 cwd
= get_current_dir_name ();
1657 message (true, "%s: %s\n", progname
,
1658 "Cannot get current working directory");
1663 if (display
&& !strcmp (display
, "w32"))
1665 #endif /* HAVE_NTGUI */
1667 /* Send over our environment and current directory. */
1671 for (i
= 0; environ
[i
]; i
++)
1673 send_to_emacs (emacs_socket
, "-env ");
1674 quote_argument (emacs_socket
, environ
[i
]);
1675 send_to_emacs (emacs_socket
, " ");
1678 send_to_emacs (emacs_socket
, "-dir ");
1679 quote_argument (emacs_socket
, cwd
);
1680 send_to_emacs (emacs_socket
, "/");
1681 send_to_emacs (emacs_socket
, " ");
1685 send_to_emacs (emacs_socket
, "-nowait ");
1688 send_to_emacs (emacs_socket
, "-current-frame ");
1692 send_to_emacs (emacs_socket
, "-display ");
1693 quote_argument (emacs_socket
, display
);
1694 send_to_emacs (emacs_socket
, " ");
1699 send_to_emacs (emacs_socket
, "-parent-id ");
1700 quote_argument (emacs_socket
, parent_id
);
1701 send_to_emacs (emacs_socket
, " ");
1704 if (frame_parameters
&& !current_frame
)
1706 send_to_emacs (emacs_socket
, "-frame-parameters ");
1707 quote_argument (emacs_socket
, frame_parameters
);
1708 send_to_emacs (emacs_socket
, " ");
1711 /* Unless we are certain we don't want to occupy the tty, send our
1712 tty information to Emacs. For example, in daemon mode Emacs may
1713 need to occupy this tty if no other frame is available. */
1714 if (!current_frame
|| !eval
)
1716 const char *tty_type
, *tty_name
;
1718 if (find_tty (&tty_type
, &tty_name
, !tty
))
1720 #if !defined (NO_SOCKETS_IN_FILE_SYSTEM)
1723 send_to_emacs (emacs_socket
, "-tty ");
1724 quote_argument (emacs_socket
, tty_name
);
1725 send_to_emacs (emacs_socket
, " ");
1726 quote_argument (emacs_socket
, tty_type
);
1727 send_to_emacs (emacs_socket
, " ");
1731 if (!current_frame
&& !tty
)
1732 send_to_emacs (emacs_socket
, "-window-system ");
1734 if ((argc
- optind
> 0))
1737 for (i
= optind
; i
< argc
; i
++)
1742 /* Don't prepend cwd or anything like that. */
1743 send_to_emacs (emacs_socket
, "-eval ");
1744 quote_argument (emacs_socket
, argv
[i
]);
1745 send_to_emacs (emacs_socket
, " ");
1749 if (*argv
[i
] == '+')
1751 char *p
= argv
[i
] + 1;
1752 while (isdigit ((unsigned char) *p
) || *p
== ':') p
++;
1755 send_to_emacs (emacs_socket
, "-position ");
1756 quote_argument (emacs_socket
, argv
[i
]);
1757 send_to_emacs (emacs_socket
, " ");
1762 else if (! file_name_absolute_p (argv
[i
])
1763 && (isalpha (argv
[i
][0]) && argv
[i
][1] == ':'))
1764 /* Windows can have a different default directory for each
1765 drive, so the cwd passed via "-dir" is not sufficient
1766 to account for that.
1767 If the user uses <drive>:<relpath>, we hence need to be
1768 careful to expand <relpath> with the default directory
1769 corresponding to <drive>. */
1771 char *filename
= (char *) xmalloc (MAX_PATH
);
1774 size
= GetFullPathName (argv
[i
], MAX_PATH
, filename
, NULL
);
1775 if (size
> 0 && size
< MAX_PATH
)
1782 send_to_emacs (emacs_socket
, "-file ");
1783 quote_argument (emacs_socket
, argv
[i
]);
1784 send_to_emacs (emacs_socket
, " ");
1789 /* Read expressions interactively. */
1790 while ((str
= fgets (string
, BUFSIZ
, stdin
)))
1792 send_to_emacs (emacs_socket
, "-eval ");
1793 quote_argument (emacs_socket
, str
);
1795 send_to_emacs (emacs_socket
, " ");
1798 send_to_emacs (emacs_socket
, "\n");
1800 /* Wait for an answer. */
1801 if (!eval
&& !tty
&& !nowait
&& !quiet
)
1803 printf ("Waiting for Emacs...");
1807 while (fdatasync (1) != 0 && errno
== EINTR
)
1810 /* Now, wait for an answer and print any messages. */
1811 while (exit_status
== EXIT_SUCCESS
)
1817 rl
= recv (emacs_socket
, string
, BUFSIZ
, 0);
1819 /* If we receive a signal (e.g. SIGWINCH, which we pass
1820 through to Emacs), on some OSes we get EINTR and must retry. */
1821 while (rl
< 0 && errno
== EINTR
);
1828 /* Loop over all NL-terminated messages. */
1829 for (end_p
= p
= string
; end_p
!= NULL
&& *end_p
!= '\0'; p
= end_p
)
1831 end_p
= strchr (p
, '\n');
1835 if (strprefix ("-emacs-pid ", p
))
1837 /* -emacs-pid PID: The process id of the Emacs process. */
1838 emacs_pid
= strtol (p
+ strlen ("-emacs-pid"), NULL
, 10);
1840 else if (strprefix ("-window-system-unsupported ", p
))
1842 /* -window-system-unsupported: Emacs was compiled without support
1843 for whatever window system we tried. Try the alternate
1844 display, or, failing that, try the terminal. */
1847 display
= alt_display
;
1858 else if (strprefix ("-print ", p
))
1860 /* -print STRING: Print STRING on the terminal. */
1861 str
= unquote_argument (p
+ strlen ("-print "));
1865 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1867 else if (strprefix ("-print-nonl ", p
))
1869 /* -print-nonl STRING: Print STRING on the terminal.
1870 Used to continue a preceding -print command. */
1871 str
= unquote_argument (p
+ strlen ("-print-nonl "));
1873 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1875 else if (strprefix ("-error ", p
))
1877 /* -error DESCRIPTION: Signal an error on the terminal. */
1878 str
= unquote_argument (p
+ strlen ("-error "));
1881 fprintf (stderr
, "*ERROR*: %s", str
);
1882 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1883 exit_status
= EXIT_FAILURE
;
1886 else if (strprefix ("-suspend ", p
))
1888 /* -suspend: Suspend this terminal, i.e., stop the process. */
1897 /* Unknown command. */
1901 printf ("*ERROR*: Unknown message: %s\n", p
);
1909 while (fdatasync (1) != 0 && errno
== EINTR
)
1913 exit_status
= EXIT_FAILURE
;
1915 CLOSE_SOCKET (emacs_socket
);
1919 #endif /* HAVE_SOCKETS && HAVE_INET_SOCKETS */