1 /* Client process that communicates with GNU Emacs acting as server.
3 Copyright (C) 1986-1987, 1994, 1999-2017 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 */
88 #define VERSION "unspecified"
93 #define EXIT_SUCCESS 0
97 #define EXIT_FAILURE 1
100 /* Additional space when allocating buffers for filenames, etc. */
101 #define EXTRA_SPACE 100
106 #define min(x, y) (((x) < (y)) ? (x) : (y))
109 /* Name used to invoke this program. */
110 const char *progname
;
112 /* The second argument to main. */
115 /* Nonzero means don't wait for a response from Emacs. --no-wait. */
118 /* Nonzero means don't print messages for successful operations. --quiet. */
121 /* Nonzero means don't print values returned from emacs. --suppress-output. */
122 int suppress_output
= 0;
124 /* Nonzero means args are expressions to be evaluated. --eval. */
127 /* Nonzero means don't open a new frame. Inverse of --create-frame. */
128 int current_frame
= 1;
130 /* The display on which Emacs should work. --display. */
131 const char *display
= NULL
;
133 /* The alternate display we should try if Emacs does not support display. */
134 const char *alt_display
= NULL
;
136 /* The parent window ID, if we are opening a frame via XEmbed. */
137 char *parent_id
= NULL
;
139 /* Nonzero means open a new Emacs frame on the current terminal. */
142 /* If non-NULL, the name of an editor to fallback to if the server
143 is not running. --alternate-editor. */
144 const char *alternate_editor
= NULL
;
146 /* If non-NULL, the filename of the UNIX socket. */
147 const char *socket_name
= NULL
;
149 /* If non-NULL, the filename of the authentication file. */
150 const char *server_file
= NULL
;
152 /* If non-NULL, the tramp prefix emacs must use to find the files. */
153 const char *tramp_prefix
= NULL
;
155 /* PID of the Emacs server process. */
158 /* If non-NULL, a string that should form a frame parameter alist to
159 be used for the new frame. */
160 const char *frame_parameters
= NULL
;
162 static _Noreturn
void print_help_and_exit (void);
165 struct option longopts
[] =
167 { "no-wait", no_argument
, NULL
, 'n' },
168 { "quiet", no_argument
, NULL
, 'q' },
169 { "suppress-output", no_argument
, NULL
, 'u' },
170 { "eval", no_argument
, NULL
, 'e' },
171 { "help", no_argument
, NULL
, 'H' },
172 { "version", no_argument
, NULL
, 'V' },
173 { "tty", no_argument
, NULL
, 't' },
174 { "nw", no_argument
, NULL
, 't' },
175 { "create-frame", no_argument
, NULL
, 'c' },
176 { "alternate-editor", required_argument
, NULL
, 'a' },
177 { "frame-parameters", required_argument
, NULL
, 'F' },
178 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
179 { "socket-name", required_argument
, NULL
, 's' },
181 { "server-file", required_argument
, NULL
, 'f' },
182 { "display", required_argument
, NULL
, 'd' },
183 { "parent-id", required_argument
, NULL
, 'p' },
184 { "tramp", required_argument
, NULL
, 'T' },
189 /* Like malloc but get fatal error if memory is exhausted. */
192 xmalloc (size_t size
)
194 void *result
= malloc (size
);
204 #if !defined (HAVE_GET_CURRENT_DIR_NAME) || defined (BROKEN_GET_CURRENT_DIR_NAME)
206 char *get_current_dir_name (void);
208 /* Return the current working directory. Returns NULL on errors.
209 Any other returned value must be freed with free. This is used
210 only when get_current_dir_name is not defined on the system. */
212 get_current_dir_name (void)
216 struct stat dotstat
, pwdstat
;
217 /* If PWD is accurate, use it instead of calling getcwd. PWD is
218 sometimes a nicer name, and using it may avoid a fatal error if a
219 parent directory is searchable but not readable. */
220 if ((pwd
= egetenv ("PWD")) != 0
221 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
222 && stat (pwd
, &pwdstat
) == 0
223 && stat (".", &dotstat
) == 0
224 && dotstat
.st_ino
== pwdstat
.st_ino
225 && dotstat
.st_dev
== pwdstat
.st_dev
227 && strlen (pwd
) < MAXPATHLEN
231 buf
= (char *) xmalloc (strlen (pwd
) + 1);
236 size_t buf_size
= 1024;
240 buf
= malloc (buf_size
);
243 if (getcwd (buf
, buf_size
) == buf
)
247 if (tmp_errno
!= ERANGE
)
266 /* Like strdup but get a fatal error if memory is exhausted. */
267 char *xstrdup (const char *);
270 xstrdup (const char *s
)
272 char *result
= strdup (s
);
281 #define REG_ROOT "SOFTWARE\\GNU\\Emacs"
283 char *w32_get_resource (HKEY
, const char *, LPDWORD
);
285 /* Retrieve an environment variable from the Emacs subkeys of the registry.
286 Return NULL if the variable was not found, or it was empty.
287 This code is based on w32_get_resource (w32.c). */
289 w32_get_resource (HKEY predefined
, const char *key
, LPDWORD type
)
291 HKEY hrootkey
= NULL
;
295 if (RegOpenKeyEx (predefined
, REG_ROOT
, 0, KEY_READ
, &hrootkey
) == ERROR_SUCCESS
)
297 if (RegQueryValueEx (hrootkey
, key
, NULL
, NULL
, NULL
, &cbData
) == ERROR_SUCCESS
)
299 result
= (char *) xmalloc (cbData
);
301 if ((RegQueryValueEx (hrootkey
, key
, NULL
, type
, (LPBYTE
)result
, &cbData
) != ERROR_SUCCESS
)
309 RegCloseKey (hrootkey
);
316 getenv wrapper for Windows
318 Value is allocated on the heap, and can be free'd.
320 This is needed to duplicate Emacs's behavior, which is to look for
321 environment variables in the registry if they don't appear in the
324 w32_getenv (const char *envvar
)
329 if ((value
= getenv (envvar
)))
330 /* Found in the environment. strdup it, because values returned
331 by getenv cannot be free'd. */
332 return xstrdup (value
);
334 if (! (value
= w32_get_resource (HKEY_CURRENT_USER
, envvar
, &dwType
)) &&
335 ! (value
= w32_get_resource (HKEY_LOCAL_MACHINE
, envvar
, &dwType
)))
337 /* "w32console" is what Emacs on Windows uses for tty-type under -nw. */
338 if (strcmp (envvar
, "TERM") == 0)
339 return xstrdup ("w32console");
340 /* Found neither in the environment nor in the registry. */
344 if (dwType
== REG_SZ
)
345 /* Registry; no need to expand. */
348 if (dwType
== REG_EXPAND_SZ
)
352 if ((size
= ExpandEnvironmentStrings (value
, NULL
, 0)))
354 char *buffer
= (char *) xmalloc (size
);
355 if (ExpandEnvironmentStrings (value
, buffer
, size
))
357 /* Found and expanded. */
362 /* Error expanding. */
367 /* Not the right type, or not correctly expanded. */
372 int w32_window_app (void);
375 w32_window_app (void)
377 static int window_app
= -1;
378 char szTitle
[MAX_PATH
];
382 /* Checking for STDOUT does not work; it's a valid handle also in
383 nonconsole apps. Testing for the console title seems to work. */
384 window_app
= (GetConsoleTitleA (szTitle
, MAX_PATH
) == 0);
386 InitCommonControls ();
392 /* execvp wrapper for Windows. Quotes arguments with embedded spaces.
394 This is necessary due to the broken implementation of exec* routines in
395 the Microsoft libraries: they concatenate the arguments together without
396 quoting special characters, and pass the result to CreateProcess, with
397 predictably bad results. By contrast, POSIX execvp passes the arguments
398 directly into the argv array of the child process. */
400 int w32_execvp (const char *, char **);
403 w32_execvp (const char *path
, char **argv
)
407 /* Required to allow a .BAT script as alternate editor. */
408 argv
[0] = (char *) alternate_editor
;
410 for (i
= 0; argv
[i
]; i
++)
411 if (strchr (argv
[i
], ' '))
413 char *quoted
= alloca (strlen (argv
[i
]) + 3);
414 sprintf (quoted
, "\"%s\"", argv
[i
]);
418 return execvp (path
, argv
);
422 #define execvp w32_execvp
424 /* Emulation of ttyname for Windows. */
425 const char *ttyname (int);
432 #endif /* WINDOWSNT */
434 /* Display a normal or error message.
435 On Windows, use a message box if compiled as a Windows app. */
436 static void message (bool, const char *, ...) ATTRIBUTE_FORMAT_PRINTF (2, 3);
438 message (bool is_error
, const char *format
, ...)
442 va_start (args
, format
);
445 if (w32_window_app ())
448 vsnprintf (msg
, sizeof msg
, format
, args
);
449 msg
[sizeof msg
- 1] = '\0';
452 MessageBox (NULL
, msg
, "Emacsclient ERROR", MB_ICONERROR
);
454 MessageBox (NULL
, msg
, "Emacsclient", MB_ICONINFORMATION
);
459 FILE *f
= is_error
? stderr
: stdout
;
461 vfprintf (f
, format
, args
);
468 /* Decode the options from argv and argc.
469 The global variable `optind' will say how many arguments we used up. */
472 decode_options (int argc
, char **argv
)
474 alternate_editor
= egetenv ("ALTERNATE_EDITOR");
475 tramp_prefix
= egetenv ("EMACSCLIENT_TRAMP");
479 int opt
= getopt_long_only (argc
, argv
,
480 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
481 "VHnequa:s:f:d:F:tcT:",
483 "VHnequa:f:d:F:tcT:",
493 /* If getopt returns 0, then it has already processed a
494 long-named option. We should do nothing. */
498 alternate_editor
= optarg
;
501 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
503 socket_name
= optarg
;
508 server_file
= optarg
;
511 /* We used to disallow this argument in w32, but it seems better
512 to allow it, for the occasional case where the user is
513 connecting with a w32 client to a server compiled with X11
536 message (false, "emacsclient %s\n", VERSION
);
555 print_help_and_exit ();
559 frame_parameters
= optarg
;
563 tramp_prefix
= optarg
;
567 message (true, "Try '%s --help' for more information\n", progname
);
573 /* If the -c option is used (without -t) and no --display argument
574 is provided, try $DISPLAY.
575 Without the -c option, we used to set `display' to $DISPLAY by
576 default, but this changed the default behavior and is sometimes
577 inconvenient. So we force users to use "--display $DISPLAY" if
578 they want Emacs to connect to their current display.
580 Some window systems have a notion of default display not
581 reflected in the DISPLAY variable. If the user didn't give us an
582 explicit display, try this platform-specific after trying the
583 display in DISPLAY (if any). */
584 if (!current_frame
&& !tty
&& !display
)
586 /* Set these here so we use a default_display only when the user
587 didn't give us an explicit display. */
588 #if defined (NS_IMPL_COCOA)
590 #elif defined (HAVE_NTGUI)
594 display
= egetenv ("DISPLAY");
599 display
= alt_display
;
603 /* A null-string display is invalid. */
604 if (display
&& strlen (display
) == 0)
607 /* If no display is available, new frames are tty frames. */
608 if (!current_frame
&& !display
)
612 /* Emacs on Windows does not support graphical and text terminal
613 frames in the same instance. So, treat the -t and -c options as
614 equivalent, and open a new frame on the server's terminal.
615 Ideally, we would only set tty = 1 when the serve is running in a
616 console, but alas we don't know that. As a workaround, always
617 ask for a tty frame, and let server.el figure it out. */
623 #endif /* WINDOWSNT */
627 static _Noreturn
void
628 print_help_and_exit (void)
630 /* Spaces and tabs are significant in this message; they're chosen so the
631 message aligns properly both in a tty and in a Windows message box.
632 Please try to preserve them; otherwise the output is very hard to read
633 when using emacsclientw. */
635 "Usage: %s [OPTIONS] FILE...\n%s%s%s", progname
, "\
636 Tell the Emacs server to visit the specified files.\n\
637 Every FILE can be either just a FILENAME or [+LINE[:COLUMN]] FILENAME.\n\
639 The following OPTIONS are accepted:\n\
640 -V, --version Just print version info and return\n\
641 -H, --help Print this usage information message\n\
642 -nw, -t, --tty Open a new Emacs frame on the current terminal\n\
643 -c, --create-frame Create a new frame instead of trying to\n\
644 use the current Emacs frame\n\
646 -F ALIST, --frame-parameters=ALIST\n\
647 Set the parameters of a new frame\n\
648 -e, --eval Evaluate the FILE arguments as ELisp expressions\n\
649 -n, --no-wait Don't wait for the server to return\n\
650 -q, --quiet Don't display messages on success\n\
651 -u, --suppress-output Don't display return values from the server\n\
652 -d DISPLAY, --display=DISPLAY\n\
653 Visit the file in the given display\n\
655 --parent-id=ID Open in parent window ID, via XEmbed\n"
656 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
657 "-s SOCKET, --socket-name=SOCKET\n\
658 Set filename of the UNIX socket for communication\n"
660 "-f SERVER, --server-file=SERVER\n\
661 Set filename of the TCP authentication file\n\
662 -a EDITOR, --alternate-editor=EDITOR\n\
663 Editor to fallback to if the server is not running\n"
664 " If EDITOR is the empty string, start Emacs in daemon\n\
665 mode and try connecting again\n"
666 "-T PREFIX, --tramp=PREFIX\n\
667 PREFIX to prepend to filenames sent by emacsclient\n\
668 for locating files remotely via Tramp\n"
670 Report bugs with M-x report-emacs-bug.\n");
674 /* Try to run a different command, or --if no alternate editor is
675 defined-- exit with an errorcode.
676 Uses argv, but gets it from the global variable main_argv. */
678 static _Noreturn
void
681 if (alternate_editor
)
685 execvp (alternate_editor
, main_argv
+ i
);
686 message (true, "%s: error executing alternate editor \"%s\"\n",
687 progname
, alternate_editor
);
693 #if !defined (HAVE_SOCKETS) || !defined (HAVE_INET_SOCKETS)
696 main (int argc
, char **argv
)
700 message (true, "%s: Sorry, the Emacs server is supported only\n"
701 "on systems with Berkeley sockets.\n",
706 #else /* HAVE_SOCKETS && HAVE_INET_SOCKETS */
708 #define AUTH_KEY_LENGTH 64
709 #define SEND_BUFFER_SIZE 4096
711 /* Buffer to accumulate data to send in TCP connections. */
712 char send_buffer
[SEND_BUFFER_SIZE
+ 1];
713 int sblen
= 0; /* Fill pointer for the send buffer. */
714 /* Socket used to communicate with the Emacs server process. */
715 HSOCKET emacs_socket
= 0;
717 /* On Windows, the socket library was historically separate from the
718 standard C library, so errors are handled differently. */
721 sock_err_message (const char *function_name
)
726 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
727 | FORMAT_MESSAGE_ALLOCATE_BUFFER
728 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
729 NULL
, WSAGetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
731 message (true, "%s: %s: %s\n", progname
, function_name
, msg
);
735 message (true, "%s: %s: %s\n", progname
, function_name
, strerror (errno
));
740 /* Let's send the data to Emacs when either
741 - the data ends in "\n", or
742 - the buffer is full (but this shouldn't happen)
743 Otherwise, we just accumulate it. */
745 send_to_emacs (HSOCKET s
, const char *data
)
752 dlen
= strlen (data
);
755 size_t part
= min (dlen
, SEND_BUFFER_SIZE
- sblen
);
756 memcpy (&send_buffer
[sblen
], data
, part
);
760 if (sblen
== SEND_BUFFER_SIZE
761 || (sblen
> 0 && send_buffer
[sblen
-1] == '\n'))
763 int sent
= send (s
, send_buffer
, sblen
, 0);
766 message (true, "%s: failed to send %d bytes to socket: %s\n",
767 progname
, sblen
, strerror (errno
));
771 memmove (send_buffer
, &send_buffer
[sent
], sblen
- sent
);
780 /* In STR, insert a & before each &, each space, each newline, and
781 any initial -. Change spaces to underscores, too, so that the
782 return value never contains a space.
784 Does not change the string. Outputs the result to S. */
786 quote_argument (HSOCKET s
, const char *str
)
788 char *copy
= (char *) xmalloc (strlen (str
) * 2 + 1);
810 if (*p
== '&' || (*p
== '-' && p
== str
))
817 send_to_emacs (s
, copy
);
823 /* The inverse of quote_argument. Removes quoting in string STR by
824 modifying the string in place. Returns STR. */
827 unquote_argument (char *str
)
858 file_name_absolute_p (const char *filename
)
860 /* Sanity check, it shouldn't happen. */
861 if (! filename
) return false;
863 /* /xxx is always an absolute path. */
864 if (filename
[0] == '/') return true;
866 /* Empty filenames (which shouldn't happen) are relative. */
867 if (filename
[0] == '\0') return false;
870 /* X:\xxx is always absolute. */
871 if (isalpha ((unsigned char) filename
[0])
872 && filename
[1] == ':' && (filename
[2] == '\\' || filename
[2] == '/'))
875 /* Both \xxx and \\xxx\yyy are absolute. */
876 if (filename
[0] == '\\') return true;
883 /* Wrapper to make WSACleanup a cdecl, as required by atexit. */
884 void __cdecl
close_winsock (void);
891 /* Initialize the WinSock2 library. */
892 void initialize_sockets (void);
894 initialize_sockets (void)
898 if (WSAStartup (MAKEWORD (2, 0), &wsaData
))
900 message (true, "%s: error initializing WinSock2\n", progname
);
904 atexit (close_winsock
);
906 #endif /* WINDOWSNT */
909 /* Read the information needed to set up a TCP comm channel with
910 the Emacs server: host, port, and authentication string. */
913 get_server_config (const char *config_file
, struct sockaddr_in
*server
,
914 char *authentication
)
920 if (file_name_absolute_p (config_file
))
921 config
= fopen (config_file
, "rb");
924 const char *home
= egetenv ("HOME");
928 char *path
= xmalloc (strlen (home
) + strlen (config_file
)
930 char *z
= stpcpy (path
, home
);
931 z
= stpcpy (z
, "/.emacs.d/server/");
932 strcpy (z
, config_file
);
933 config
= fopen (path
, "rb");
937 if (!config
&& (home
= egetenv ("APPDATA")))
939 char *path
= xmalloc (strlen (home
) + strlen (config_file
)
941 char *z
= stpcpy (path
, home
);
942 z
= stpcpy (z
, "/.emacs.d/server/");
943 strcpy (z
, config_file
);
944 config
= fopen (path
, "rb");
953 if (fgets (dotted
, sizeof dotted
, config
)
954 && (port
= strchr (dotted
, ':')))
958 message (true, "%s: invalid configuration info\n", progname
);
962 server
->sin_family
= AF_INET
;
963 server
->sin_addr
.s_addr
= inet_addr (dotted
);
964 server
->sin_port
= htons (atoi (port
));
966 if (! fread (authentication
, AUTH_KEY_LENGTH
, 1, config
))
968 message (true, "%s: cannot read authentication info\n", progname
);
978 set_tcp_socket (const char *local_server_file
)
981 struct sockaddr_in server
;
982 struct linger l_arg
= {1, 1};
983 char auth_string
[AUTH_KEY_LENGTH
+ 1];
985 if (! get_server_config (local_server_file
, &server
, auth_string
))
986 return INVALID_SOCKET
;
988 if (server
.sin_addr
.s_addr
!= inet_addr ("127.0.0.1") && !quiet
)
989 message (false, "%s: connected to remote socket at %s\n",
990 progname
, inet_ntoa (server
.sin_addr
));
992 /* Open up an AF_INET socket. */
993 if ((s
= socket (AF_INET
, SOCK_STREAM
, IPPROTO_TCP
)) < 0)
995 /* Since we have an alternate to try out, this is not an error
996 yet; popping out a modal dialog at this stage would make -a
997 option totally useless for emacsclientw -- the user will
998 still get an error message if the alternate editor fails. */
1000 if(!(w32_window_app () && alternate_editor
))
1002 sock_err_message ("socket");
1003 return INVALID_SOCKET
;
1006 /* Set up the socket. */
1007 if (connect (s
, (struct sockaddr
*) &server
, sizeof server
) < 0)
1010 if(!(w32_window_app () && alternate_editor
))
1012 sock_err_message ("connect");
1013 return INVALID_SOCKET
;
1016 setsockopt (s
, SOL_SOCKET
, SO_LINGER
, (char *) &l_arg
, sizeof l_arg
);
1018 /* Send the authentication. */
1019 auth_string
[AUTH_KEY_LENGTH
] = '\0';
1021 send_to_emacs (s
, "-auth ");
1022 send_to_emacs (s
, auth_string
);
1023 send_to_emacs (s
, " ");
1029 /* Returns 1 if PREFIX is a prefix of STRING. */
1031 strprefix (const char *prefix
, const char *string
)
1033 return !strncmp (prefix
, string
, strlen (prefix
));
1036 /* Get tty name and type. If successful, return the type in TTY_TYPE
1037 and the name in TTY_NAME, and return 1. Otherwise, fail if NOABORT
1038 is zero, or return 0 if NOABORT is non-zero. */
1041 find_tty (const char **tty_type
, const char **tty_name
, int noabort
)
1043 const char *type
= egetenv ("TERM");
1044 const char *name
= ttyname (fileno (stdout
));
1052 message (true, "%s: could not get terminal name\n", progname
);
1063 message (true, "%s: please set the TERM variable to your terminal type\n",
1069 if (strcmp (type
, "eterm") == 0)
1075 /* This causes nasty, MULTI_KBOARD-related input lockouts. */
1076 message (true, "%s: opening a frame in an Emacs term buffer"
1077 " is not supported\n", progname
);
1088 #if !defined (NO_SOCKETS_IN_FILE_SYSTEM)
1090 /* Three possibilities:
1091 2 - can't be `stat'ed (sets errno)
1092 1 - isn't owned by us
1093 0 - success: none of the above */
1096 socket_status (const char *name
)
1098 struct stat statbfr
;
1100 if (stat (name
, &statbfr
) == -1)
1103 if (statbfr
.st_uid
!= geteuid ())
1110 /* A signal handler that passes the signal to the Emacs process.
1111 Useful for SIGWINCH. */
1114 pass_signal_to_emacs (int signalnum
)
1116 int old_errno
= errno
;
1119 kill (emacs_pid
, signalnum
);
1121 signal (signalnum
, pass_signal_to_emacs
);
1125 /* Signal handler for SIGCONT; notify the Emacs process that it can
1126 now resume our tty frame. */
1129 handle_sigcont (int signalnum
)
1131 int old_errno
= errno
;
1132 pid_t pgrp
= getpgrp ();
1133 pid_t tcpgrp
= tcgetpgrp (1);
1137 /* We are in the foreground. */
1138 send_to_emacs (emacs_socket
, "-resume \n");
1140 else if (0 <= tcpgrp
&& tty
)
1142 /* We are in the background; cancel the continue. */
1143 kill (-pgrp
, SIGTTIN
);
1146 signal (signalnum
, handle_sigcont
);
1150 /* Signal handler for SIGTSTP; notify the Emacs process that we are
1151 going to sleep. Normally the suspend is initiated by Emacs via
1152 server-handle-suspend-tty, but if the server gets out of sync with
1153 reality, we may get a SIGTSTP on C-z. Handling this signal and
1154 notifying Emacs about it should get things under control again. */
1157 handle_sigtstp (int signalnum
)
1159 int old_errno
= errno
;
1163 send_to_emacs (emacs_socket
, "-suspend \n");
1165 /* Unblock this signal and call the default handler by temporarily
1166 changing the handler and resignaling. */
1167 sigprocmask (SIG_BLOCK
, NULL
, &set
);
1168 sigdelset (&set
, signalnum
);
1169 signal (signalnum
, SIG_DFL
);
1171 sigprocmask (SIG_SETMASK
, &set
, NULL
); /* Let's the above signal through. */
1172 signal (signalnum
, handle_sigtstp
);
1178 /* Set up signal handlers before opening a frame on the current tty. */
1183 /* Set up signal handlers. */
1184 signal (SIGWINCH
, pass_signal_to_emacs
);
1186 /* Don't pass SIGINT and SIGQUIT to Emacs, because it has no way of
1187 deciding which terminal the signal came from. C-g is now a
1188 normal input event on secondary terminals. */
1190 signal (SIGINT
, pass_signal_to_emacs
);
1191 signal (SIGQUIT
, pass_signal_to_emacs
);
1194 signal (SIGCONT
, handle_sigcont
);
1195 signal (SIGTSTP
, handle_sigtstp
);
1196 signal (SIGTTOU
, handle_sigtstp
);
1201 set_local_socket (const char *local_socket_name
)
1204 struct sockaddr_un server
;
1206 /* Open up an AF_UNIX socket in this person's home directory. */
1207 if ((s
= socket (AF_UNIX
, SOCK_STREAM
, 0)) < 0)
1209 message (true, "%s: socket: %s\n", progname
, strerror (errno
));
1210 return INVALID_SOCKET
;
1213 server
.sun_family
= AF_UNIX
;
1218 const char *server_name
= local_socket_name
;
1219 const char *tmpdir
= NULL
;
1220 char *tmpdir_storage
= NULL
;
1221 char *socket_name_storage
= NULL
;
1223 if (!strchr (local_socket_name
, '/') && !strchr (local_socket_name
, '\\'))
1225 /* socket_name is a file name component. */
1226 long uid
= geteuid ();
1227 tmpdir
= egetenv ("TMPDIR");
1231 #ifndef _CS_DARWIN_USER_TEMP_DIR
1232 #define _CS_DARWIN_USER_TEMP_DIR 65537
1234 size_t n
= confstr (_CS_DARWIN_USER_TEMP_DIR
, NULL
, (size_t) 0);
1237 tmpdir
= tmpdir_storage
= xmalloc (n
);
1238 confstr (_CS_DARWIN_USER_TEMP_DIR
, tmpdir_storage
, n
);
1244 socket_name_storage
=
1245 xmalloc (strlen (tmpdir
) + strlen (server_name
) + EXTRA_SPACE
);
1246 char *z
= stpcpy (socket_name_storage
, tmpdir
);
1247 z
+= sprintf (z
, "/emacs%ld/", uid
);
1248 strcpy (z
, server_name
);
1249 local_socket_name
= socket_name_storage
;
1252 if (strlen (local_socket_name
) < sizeof (server
.sun_path
))
1253 strcpy (server
.sun_path
, local_socket_name
);
1256 message (true, "%s: socket-name %s too long\n",
1257 progname
, local_socket_name
);
1261 /* See if the socket exists, and if it's owned by us. */
1262 sock_status
= socket_status (server
.sun_path
);
1263 saved_errno
= errno
;
1264 if (sock_status
&& tmpdir
)
1266 /* Failing that, see if LOGNAME or USER exist and differ from
1267 our euid. If so, look for a socket based on the UID
1268 associated with the name. This is reminiscent of the logic
1269 that init_editfns uses to set the global Vuser_full_name. */
1271 const char *user_name
= egetenv ("LOGNAME");
1274 user_name
= egetenv ("USER");
1278 struct passwd
*pw
= getpwnam (user_name
);
1280 if (pw
&& (pw
->pw_uid
!= geteuid ()))
1282 /* We're running under su, apparently. */
1283 long uid
= pw
->pw_uid
;
1284 char *user_socket_name
1285 = xmalloc (strlen (tmpdir
) + strlen (server_name
)
1287 char *z
= stpcpy (user_socket_name
, tmpdir
);
1288 z
+= sprintf (z
, "/emacs%ld/", uid
);
1289 strcpy (z
, server_name
);
1291 if (strlen (user_socket_name
) < sizeof (server
.sun_path
))
1292 strcpy (server
.sun_path
, user_socket_name
);
1295 message (true, "%s: socket-name %s too long\n",
1296 progname
, user_socket_name
);
1297 exit (EXIT_FAILURE
);
1299 free (user_socket_name
);
1301 sock_status
= socket_status (server
.sun_path
);
1302 saved_errno
= errno
;
1305 errno
= saved_errno
;
1309 free (socket_name_storage
);
1310 free (tmpdir_storage
);
1312 switch (sock_status
)
1315 /* There's a socket, but it isn't owned by us. This is OK if
1317 if (0 != geteuid ())
1319 message (true, "%s: Invalid socket owner\n", progname
);
1320 return INVALID_SOCKET
;
1326 if (saved_errno
== ENOENT
)
1328 "%s: can't find socket; have you started the server?\n\
1329 To start the server in Emacs, type \"M-x server-start\".\n",
1332 message (true, "%s: can't stat %s: %s\n",
1333 progname
, server
.sun_path
, strerror (saved_errno
));
1334 return INVALID_SOCKET
;
1338 if (connect (s
, (struct sockaddr
*) &server
, strlen (server
.sun_path
) + 2)
1341 message (true, "%s: connect: %s\n", progname
, strerror (errno
));
1342 return INVALID_SOCKET
;
1347 #endif /* ! NO_SOCKETS_IN_FILE_SYSTEM */
1350 set_socket (int no_exit_if_error
)
1353 const char *local_server_file
= server_file
;
1357 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1358 /* Explicit --socket-name argument. */
1361 s
= set_local_socket (socket_name
);
1362 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1364 message (true, "%s: error accessing socket \"%s\"\n",
1365 progname
, socket_name
);
1366 exit (EXIT_FAILURE
);
1370 /* Explicit --server-file arg or EMACS_SERVER_FILE variable. */
1371 if (!local_server_file
)
1372 local_server_file
= egetenv ("EMACS_SERVER_FILE");
1374 if (local_server_file
)
1376 s
= set_tcp_socket (local_server_file
);
1377 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1380 message (true, "%s: error accessing server file \"%s\"\n",
1381 progname
, local_server_file
);
1382 exit (EXIT_FAILURE
);
1385 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1386 /* Implicit local socket. */
1387 s
= set_local_socket ("server");
1388 if (s
!= INVALID_SOCKET
)
1392 /* Implicit server file. */
1393 s
= set_tcp_socket ("server");
1394 if ((s
!= INVALID_SOCKET
) || no_exit_if_error
)
1397 /* No implicit or explicit socket, and no alternate editor. */
1398 message (true, "%s: No socket or alternate editor. Please use:\n\n"
1399 #ifndef NO_SOCKETS_IN_FILE_SYSTEM
1402 "\t--server-file (or environment variable EMACS_SERVER_FILE)\n\
1403 \t--alternate-editor (or environment variable ALTERNATE_EDITOR)\n",
1405 exit (EXIT_FAILURE
);
1409 FARPROC set_fg
; /* Pointer to AllowSetForegroundWindow. */
1410 FARPROC get_wc
; /* Pointer to RealGetWindowClassA. */
1412 void w32_set_user_model_id (void);
1415 w32_set_user_model_id (void)
1418 HRESULT (WINAPI
* set_user_model
) (const wchar_t * id
);
1420 /* On Windows 7 and later, we need to set the user model ID
1421 to associate emacsclient launched files with Emacs frames
1423 shell
= LoadLibrary ("shell32.dll");
1427 = (void *) GetProcAddress (shell
,
1428 "SetCurrentProcessExplicitAppUserModelID");
1429 /* If the function is defined, then we are running on Windows 7
1430 or newer, and the UI uses this to group related windows
1431 together. Since emacs, runemacs, emacsclient are related, we
1432 want them grouped even though the executables are different,
1433 so we need to set a consistent ID between them. */
1435 set_user_model (L
"GNU.Emacs");
1437 FreeLibrary (shell
);
1441 BOOL CALLBACK
w32_find_emacs_process (HWND
, LPARAM
);
1444 w32_find_emacs_process (HWND hWnd
, LPARAM lParam
)
1449 /* Reject any window not of class "Emacs". */
1450 if (! get_wc (hWnd
, class, sizeof (class))
1451 || strcmp (class, "Emacs"))
1454 /* We only need the process id, not the thread id. */
1455 (void) GetWindowThreadProcessId (hWnd
, &pid
);
1457 /* Not the one we're looking for. */
1458 if (pid
!= (DWORD
) emacs_pid
) return TRUE
;
1460 /* OK, let's raise it. */
1463 /* Stop enumeration. */
1467 /* Search for a window of class "Emacs" and owned by a process with
1468 process id = emacs_pid. If found, allow it to grab the focus. */
1469 void w32_give_focus (void);
1472 w32_give_focus (void)
1476 /* It shouldn't happen when dealing with TCP sockets. */
1477 if (!emacs_pid
) return;
1479 user32
= GetModuleHandle ("user32.dll");
1484 /* Modern Windows restrict which processes can set the foreground window.
1485 emacsclient can allow Emacs to grab the focus by calling the function
1486 AllowSetForegroundWindow. Unfortunately, older Windows (W95, W98 and
1487 NT) lack this function, so we have to check its availability. */
1488 if ((set_fg
= GetProcAddress (user32
, "AllowSetForegroundWindow"))
1489 && (get_wc
= GetProcAddress (user32
, "RealGetWindowClassA")))
1490 EnumWindows (w32_find_emacs_process
, (LPARAM
) 0);
1492 #endif /* HAVE_NTGUI */
1494 /* Start the emacs daemon and try to connect to it. */
1497 start_daemon_and_retry_set_socket (void)
1508 w
= waitpid (dpid
, &status
, WUNTRACED
| WCONTINUED
);
1510 if ((w
== -1) || !WIFEXITED (status
) || WEXITSTATUS (status
))
1512 message (true, "Error: Could not start the Emacs daemon\n");
1513 exit (EXIT_FAILURE
);
1516 /* Try connecting, the daemon should have started by now. */
1517 message (true, "Emacs daemon should have started, trying to connect again\n");
1518 if ((emacs_socket
= set_socket (1)) == INVALID_SOCKET
)
1520 message (true, "Error: Cannot connect even after starting the Emacs daemon\n");
1521 exit (EXIT_FAILURE
);
1526 fprintf (stderr
, "Error: Cannot fork!\n");
1527 exit (EXIT_FAILURE
);
1531 char emacs
[] = "emacs";
1532 char daemon_option
[] = "--daemon";
1535 d_argv
[1] = daemon_option
;
1537 if (socket_name
!= NULL
)
1539 /* Pass --daemon=socket_name as argument. */
1540 const char *deq
= "--daemon=";
1541 char *daemon_arg
= xmalloc (strlen (deq
)
1542 + strlen (socket_name
) + 1);
1543 strcpy (stpcpy (daemon_arg
, deq
), socket_name
);
1544 d_argv
[1] = daemon_arg
;
1546 execvp ("emacs", d_argv
);
1547 message (true, "%s: error starting emacs daemon\n", progname
);
1549 #else /* WINDOWSNT */
1551 HANDLE w32_daemon_event
;
1553 PROCESS_INFORMATION pi
;
1555 ZeroMemory (&si
, sizeof si
);
1557 ZeroMemory (&pi
, sizeof pi
);
1559 /* We start Emacs in daemon mode, and then wait for it to signal us
1560 it is ready to accept client connections, by asserting an event
1561 whose name is known to the daemon (defined by nt/inc/ms-w32.h). */
1563 if (!CreateProcess (NULL
, (LPSTR
)"emacs --daemon", NULL
, NULL
, FALSE
,
1564 CREATE_NO_WINDOW
, NULL
, NULL
, &si
, &pi
))
1568 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
1569 | FORMAT_MESSAGE_ALLOCATE_BUFFER
1570 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
1571 NULL
, GetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
1572 message (true, "%s: error starting emacs daemon (%s)\n", progname
, msg
);
1573 exit (EXIT_FAILURE
);
1576 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1577 if (w32_daemon_event
== NULL
)
1579 message (true, "Couldn't create Windows daemon event");
1580 exit (EXIT_FAILURE
);
1582 if ((wait_result
= WaitForSingleObject (w32_daemon_event
, INFINITE
))
1585 const char *msg
= NULL
;
1587 switch (wait_result
)
1589 case WAIT_ABANDONED
:
1590 msg
= "The daemon exited unexpectedly";
1593 /* Can't happen due to INFINITE. */
1596 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM
1597 | FORMAT_MESSAGE_ALLOCATE_BUFFER
1598 | FORMAT_MESSAGE_ARGUMENT_ARRAY
,
1599 NULL
, GetLastError (), 0, (LPTSTR
)&msg
, 0, NULL
);
1602 message (true, "Error: Could not start the Emacs daemon: %s\n", msg
);
1603 exit (EXIT_FAILURE
);
1605 CloseHandle (w32_daemon_event
);
1607 /* Try connecting, the daemon should have started by now. */
1608 /* It's just a progress message, so don't pop a dialog if this is
1610 if (!w32_window_app ())
1612 "Emacs daemon should have started, trying to connect again\n");
1613 if ((emacs_socket
= set_socket (1)) == INVALID_SOCKET
)
1616 "Error: Cannot connect even after starting the Emacs daemon\n");
1617 exit (EXIT_FAILURE
);
1619 #endif /* WINDOWSNT */
1623 main (int argc
, char **argv
)
1625 int rl
= 0, needlf
= 0;
1627 char string
[BUFSIZ
+1];
1628 int start_daemon_if_needed
;
1629 int exit_status
= EXIT_SUCCESS
;
1635 /* On Windows 7 and later, we need to explicitly associate
1636 emacsclient with emacs so the UI behaves sensibly. This
1637 association does no harm if we're not actually connecting to an
1638 Emacs using a window display. */
1639 w32_set_user_model_id ();
1640 #endif /* HAVE_NTGUI */
1642 /* Process options. */
1643 decode_options (argc
, argv
);
1645 if ((argc
- optind
< 1) && !eval
&& current_frame
)
1647 message (true, "%s: file name or argument required\n"
1648 "Try '%s --help' for more information\n",
1649 progname
, progname
);
1650 exit (EXIT_FAILURE
);
1656 pid_t pgrp
= getpgrp ();
1657 pid_t tcpgrp
= tcgetpgrp (1);
1658 if (0 <= tcpgrp
&& tcpgrp
!= pgrp
)
1659 kill (-pgrp
, SIGTTIN
);
1661 #endif /* !WINDOWSNT */
1663 /* If alternate_editor is the empty string, start the emacs daemon
1664 in case of failure to connect. */
1665 start_daemon_if_needed
= (alternate_editor
1666 && (alternate_editor
[0] == '\0'));
1668 emacs_socket
= set_socket (alternate_editor
|| start_daemon_if_needed
);
1669 if (emacs_socket
== INVALID_SOCKET
)
1671 if (! start_daemon_if_needed
)
1674 start_daemon_and_retry_set_socket ();
1677 cwd
= get_current_dir_name ();
1680 message (true, "%s: %s\n", progname
,
1681 "Cannot get current working directory");
1686 if (display
&& !strcmp (display
, "w32"))
1688 #endif /* HAVE_NTGUI */
1690 /* Send over our environment and current directory. */
1694 for (i
= 0; environ
[i
]; i
++)
1696 send_to_emacs (emacs_socket
, "-env ");
1697 quote_argument (emacs_socket
, environ
[i
]);
1698 send_to_emacs (emacs_socket
, " ");
1701 send_to_emacs (emacs_socket
, "-dir ");
1703 quote_argument (emacs_socket
, tramp_prefix
);
1704 quote_argument (emacs_socket
, cwd
);
1706 send_to_emacs (emacs_socket
, "/");
1707 send_to_emacs (emacs_socket
, " ");
1711 send_to_emacs (emacs_socket
, "-nowait ");
1714 send_to_emacs (emacs_socket
, "-current-frame ");
1718 send_to_emacs (emacs_socket
, "-display ");
1719 quote_argument (emacs_socket
, display
);
1720 send_to_emacs (emacs_socket
, " ");
1725 send_to_emacs (emacs_socket
, "-parent-id ");
1726 quote_argument (emacs_socket
, parent_id
);
1727 send_to_emacs (emacs_socket
, " ");
1730 if (frame_parameters
&& !current_frame
)
1732 send_to_emacs (emacs_socket
, "-frame-parameters ");
1733 quote_argument (emacs_socket
, frame_parameters
);
1734 send_to_emacs (emacs_socket
, " ");
1737 /* Unless we are certain we don't want to occupy the tty, send our
1738 tty information to Emacs. For example, in daemon mode Emacs may
1739 need to occupy this tty if no other frame is available. */
1740 if (!current_frame
|| !eval
)
1742 const char *tty_type
, *tty_name
;
1744 if (find_tty (&tty_type
, &tty_name
, !tty
))
1746 #if !defined (NO_SOCKETS_IN_FILE_SYSTEM)
1749 send_to_emacs (emacs_socket
, "-tty ");
1750 quote_argument (emacs_socket
, tty_name
);
1751 send_to_emacs (emacs_socket
, " ");
1752 quote_argument (emacs_socket
, tty_type
);
1753 send_to_emacs (emacs_socket
, " ");
1757 if (!current_frame
&& !tty
)
1758 send_to_emacs (emacs_socket
, "-window-system ");
1760 if ((argc
- optind
> 0))
1763 for (i
= optind
; i
< argc
; i
++)
1768 /* Don't prepend cwd or anything like that. */
1769 send_to_emacs (emacs_socket
, "-eval ");
1770 quote_argument (emacs_socket
, argv
[i
]);
1771 send_to_emacs (emacs_socket
, " ");
1775 if (*argv
[i
] == '+')
1777 char *p
= argv
[i
] + 1;
1778 while (isdigit ((unsigned char) *p
) || *p
== ':') p
++;
1781 send_to_emacs (emacs_socket
, "-position ");
1782 quote_argument (emacs_socket
, argv
[i
]);
1783 send_to_emacs (emacs_socket
, " ");
1788 else if (! file_name_absolute_p (argv
[i
])
1789 && (isalpha (argv
[i
][0]) && argv
[i
][1] == ':'))
1790 /* Windows can have a different default directory for each
1791 drive, so the cwd passed via "-dir" is not sufficient
1792 to account for that.
1793 If the user uses <drive>:<relpath>, we hence need to be
1794 careful to expand <relpath> with the default directory
1795 corresponding to <drive>. */
1797 char *filename
= (char *) xmalloc (MAX_PATH
);
1800 size
= GetFullPathName (argv
[i
], MAX_PATH
, filename
, NULL
);
1801 if (size
> 0 && size
< MAX_PATH
)
1808 send_to_emacs (emacs_socket
, "-file ");
1809 if (tramp_prefix
&& file_name_absolute_p (argv
[i
]))
1810 quote_argument (emacs_socket
, tramp_prefix
);
1811 quote_argument (emacs_socket
, argv
[i
]);
1812 send_to_emacs (emacs_socket
, " ");
1817 /* Read expressions interactively. */
1818 while ((str
= fgets (string
, BUFSIZ
, stdin
)))
1820 send_to_emacs (emacs_socket
, "-eval ");
1821 quote_argument (emacs_socket
, str
);
1823 send_to_emacs (emacs_socket
, " ");
1826 send_to_emacs (emacs_socket
, "\n");
1828 /* Wait for an answer. */
1829 if (!eval
&& !tty
&& !nowait
&& !quiet
)
1831 printf ("Waiting for Emacs...");
1835 while (fdatasync (1) != 0 && errno
== EINTR
)
1838 /* Now, wait for an answer and print any messages. */
1839 while (exit_status
== EXIT_SUCCESS
)
1845 rl
= recv (emacs_socket
, string
, BUFSIZ
, 0);
1847 /* If we receive a signal (e.g. SIGWINCH, which we pass
1848 through to Emacs), on some OSes we get EINTR and must retry. */
1849 while (rl
< 0 && errno
== EINTR
);
1856 /* Loop over all NL-terminated messages. */
1857 for (end_p
= p
= string
; end_p
!= NULL
&& *end_p
!= '\0'; p
= end_p
)
1859 end_p
= strchr (p
, '\n');
1863 if (strprefix ("-emacs-pid ", p
))
1865 /* -emacs-pid PID: The process id of the Emacs process. */
1866 emacs_pid
= strtol (p
+ strlen ("-emacs-pid"), NULL
, 10);
1868 else if (strprefix ("-window-system-unsupported ", p
))
1870 /* -window-system-unsupported: Emacs was compiled without support
1871 for whatever window system we tried. Try the alternate
1872 display, or, failing that, try the terminal. */
1875 display
= alt_display
;
1886 else if (strprefix ("-print ", p
))
1888 /* -print STRING: Print STRING on the terminal. */
1889 if (!suppress_output
)
1891 str
= unquote_argument (p
+ strlen ("-print "));
1895 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1898 else if (strprefix ("-print-nonl ", p
))
1900 /* -print-nonl STRING: Print STRING on the terminal.
1901 Used to continue a preceding -print command. */
1902 if (!suppress_output
)
1904 str
= unquote_argument (p
+ strlen ("-print-nonl "));
1906 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1909 else if (strprefix ("-error ", p
))
1911 /* -error DESCRIPTION: Signal an error on the terminal. */
1912 str
= unquote_argument (p
+ strlen ("-error "));
1915 fprintf (stderr
, "*ERROR*: %s", str
);
1916 needlf
= str
[0] == '\0' ? needlf
: str
[strlen (str
) - 1] != '\n';
1917 exit_status
= EXIT_FAILURE
;
1920 else if (strprefix ("-suspend ", p
))
1922 /* -suspend: Suspend this terminal, i.e., stop the process. */
1931 /* Unknown command. */
1935 printf ("*ERROR*: Unknown message: %s\n", p
);
1943 while (fdatasync (1) != 0 && errno
== EINTR
)
1947 exit_status
= EXIT_FAILURE
;
1949 CLOSE_SOCKET (emacs_socket
);
1953 #endif /* HAVE_SOCKETS && HAVE_INET_SOCKETS */