(defcustom): Doc fix.
[emacs.git] / lib-src / emacsclient.c
blobd06334eb8f329c22d99788ff6829ff7cbe87cada
1 /* Client process that communicates with GNU Emacs acting as server.
2 Copyright (C) 1986, 1987, 1994, 1999, 2000, 2001
3 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 2, or (at your option)
10 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; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #define NO_SHORTNAMES
25 #ifdef HAVE_CONFIG_H
26 #include <config.h>
27 #endif
29 #undef signal
31 #include <ctype.h>
32 #include <stdio.h>
33 #include <getopt.h>
34 #ifdef HAVE_UNISTD_H
35 #include <unistd.h>
36 #endif
38 #ifdef VMS
39 # include "vms-pwd.h"
40 #else
41 # include <pwd.h>
42 #endif /* not VMS */
44 char *getenv (), *getwd ();
45 char *getcwd ();
47 /* This is defined with -D from the compilation command,
48 which extracts it from ../lisp/version.el. */
50 #ifndef VERSION
51 #define VERSION "unspecified"
52 #endif
54 /* Name used to invoke this program. */
55 char *progname;
57 /* Nonzero means don't wait for a response from Emacs. --no-wait. */
58 int nowait = 0;
60 /* Nonzero means args are expressions to be evaluated. --eval. */
61 int eval = 0;
63 /* The display on which Emacs should work. --display. */
64 char *display = NULL;
66 /* If non-NULL, the name of an editor to fallback to if the server
67 is not running. --alternate-editor. */
68 const char * alternate_editor = NULL;
70 void print_help_and_exit ();
72 struct option longopts[] =
74 { "no-wait", no_argument, NULL, 'n' },
75 { "eval", no_argument, NULL, 'e' },
76 { "help", no_argument, NULL, 'H' },
77 { "version", no_argument, NULL, 'V' },
78 { "alternate-editor", required_argument, NULL, 'a' },
79 { "display", required_argument, NULL, 'd' },
80 { 0, 0, 0, 0 }
83 /* Decode the options from argv and argc.
84 The global variable `optind' will say how many arguments we used up. */
86 void
87 decode_options (argc, argv)
88 int argc;
89 char **argv;
91 while (1)
93 int opt = getopt_long (argc, argv,
94 "VHnea:d:", longopts, 0);
96 if (opt == EOF)
97 break;
99 alternate_editor = getenv ("ALTERNATE_EDITOR");
101 switch (opt)
103 case 0:
104 /* If getopt returns 0, then it has already processed a
105 long-named option. We should do nothing. */
106 break;
108 case 'a':
109 alternate_editor = optarg;
110 break;
112 case 'd':
113 display = optarg;
114 break;
116 case 'n':
117 nowait = 1;
118 break;
120 case 'e':
121 eval = 1;
122 break;
124 case 'V':
125 fprintf (stderr, "emacsclient %s\n", VERSION);
126 exit (1);
127 break;
129 case 'H':
130 default:
131 print_help_and_exit ();
136 void
137 print_help_and_exit ()
139 fprintf (stderr,
140 "Usage: %s [OPTIONS] FILE...\n\
141 Tell the Emacs server to visit the specified files.\n\
142 Every FILE can be either just a FILENAME or [+LINE[:COLUMN]] FILENAME.\n\
143 The following OPTIONS are accepted:\n\
144 -V, --version Just print a version info and return\n\
145 -H, --help Print this usage information message\n\
146 -n, --no-wait Don't wait for the server to return\n\
147 -e, --eval Evaluate the FILE arguments as ELisp expressions\n\
148 -d, --display=DISPLAY Visit the file in the given display\n\
149 -a, --alternate-editor=EDITOR\n\
150 Editor to fallback to if the server is not running\n\
151 Report bugs to bug-gnu-emacs@gnu.org.\n", progname);
152 exit (1);
155 /* Return a copy of NAME, inserting a &
156 before each &, each space, each newline, and any initial -.
157 Change spaces to underscores, too, so that the
158 return value never contains a space. */
160 char *
161 quote_file_name (name)
162 char *name;
164 char *copy = (char *) malloc (strlen (name) * 2 + 1);
165 char *p, *q;
167 p = name;
168 q = copy;
169 while (*p)
171 if (*p == ' ')
173 *q++ = '&';
174 *q++ = '_';
175 p++;
177 else if (*p == '\n')
179 *q++ = '&';
180 *q++ = 'n';
181 p++;
183 else
185 if (*p == '&' || (*p == '-' && p == name))
186 *q++ = '&';
187 *q++ = *p++;
190 *q++ = 0;
192 return copy;
195 /* Like malloc but get fatal error if memory is exhausted. */
197 long *
198 xmalloc (size)
199 unsigned int size;
201 long *result = (long *) malloc (size);
202 if (result == NULL)
204 perror ("malloc");
205 exit (1);
207 return result;
211 Try to run a different command, or --if no alternate editor is
212 defined-- exit with an errorcode.
214 void
215 fail (argc, argv)
216 int argc;
217 char **argv;
219 if (alternate_editor)
221 int i = optind - 1;
222 execvp (alternate_editor, argv + i);
223 return;
225 else
227 exit (1);
233 #if !defined (HAVE_SOCKETS) || defined (NO_SOCKETS_IN_FILE_SYSTEM)
236 main (argc, argv)
237 int argc;
238 char **argv;
240 fprintf (stderr, "%s: Sorry, the Emacs server is supported only\n",
241 argv[0]);
242 fprintf (stderr, "on systems with Berkeley sockets.\n");
244 fail (argc, argv);
247 #else /* HAVE_SOCKETS */
249 #include <sys/types.h>
250 #include <sys/socket.h>
251 #include <sys/un.h>
252 #include <sys/stat.h>
253 #include <errno.h>
255 extern char *strerror ();
256 extern int errno;
258 /* Three possibilities:
259 2 - can't be `stat'ed (sets errno)
260 1 - isn't owned by us
261 0 - success: none of the above */
263 static int
264 socket_status (socket_name)
265 char *socket_name;
267 struct stat statbfr;
269 if (stat (socket_name, &statbfr) == -1)
270 return 2;
272 if (statbfr.st_uid != geteuid ())
273 return 1;
275 return 0;
279 main (argc, argv)
280 int argc;
281 char **argv;
283 char *system_name;
284 int system_name_length;
285 int s, i, needlf = 0;
286 FILE *out, *in;
287 struct sockaddr_un server;
288 #ifdef SERVER_HOME_DIR
289 char *homedir;
290 #endif
291 char *cwd, *str;
292 char string[BUFSIZ];
294 progname = argv[0];
296 /* Process options. */
297 decode_options (argc, argv);
299 if (argc - optind < 1)
300 print_help_and_exit ();
303 * Open up an AF_UNIX socket in this person's home directory
306 if ((s = socket (AF_UNIX, SOCK_STREAM, 0)) < 0)
308 fprintf (stderr, "%s: ", argv[0]);
309 perror ("socket");
310 fail (argc, argv);
313 server.sun_family = AF_UNIX;
316 char *dot;
317 system_name_length = 32;
319 while (1)
321 system_name = (char *) xmalloc (system_name_length + 1);
323 /* system_name must be null-terminated string. */
324 system_name[system_name_length] = '\0';
326 if (gethostname (system_name, system_name_length) == 0)
327 break;
329 free (system_name);
330 system_name_length *= 2;
333 /* We always use the non-dotted host name, for simplicity. */
334 dot = index (system_name, '.');
335 if (dot)
336 *dot = '\0';
340 int sock_status = 0;
342 sprintf (server.sun_path, "/tmp/esrv%d-%s", (int) geteuid (), system_name);
344 /* See if the socket exists, and if it's owned by us. */
345 sock_status = socket_status (server.sun_path);
346 if (sock_status)
348 /* Failing that, see if LOGNAME or USER exist and differ from
349 our euid. If so, look for a socket based on the UID
350 associated with the name. This is reminiscent of the logic
351 that init_editfns uses to set the global Vuser_full_name. */
353 char *user_name = (char *) getenv ("LOGNAME");
354 if (!user_name)
355 user_name = (char *) getenv ("USER");
357 if (user_name)
359 struct passwd *pw = getpwnam (user_name);
360 if (pw && (pw->pw_uid != geteuid ()))
362 /* We're running under su, apparently. */
363 sprintf (server.sun_path, "/tmp/esrv%d-%s",
364 (int) pw->pw_uid, system_name);
365 sock_status = socket_status (server.sun_path);
370 switch (sock_status)
372 case 1:
373 /* There's a socket, but it isn't owned by us. This is OK if
374 we are root. */
375 if (0 != geteuid ())
377 fprintf (stderr, "%s: Invalid socket owner\n", argv[0]);
378 fail (argc, argv);
380 break;
382 case 2:
383 /* `stat' failed */
384 if (errno == ENOENT)
385 fprintf (stderr,
386 "%s: can't find socket; have you started the server?\n",
387 argv[0]);
388 else
389 fprintf (stderr, "%s: can't stat %s: %s\n",
390 argv[0], server.sun_path, strerror (errno));
391 fail (argc, argv);
392 break;
396 if (connect (s, (struct sockaddr *) &server, strlen (server.sun_path) + 2)
397 < 0)
399 fprintf (stderr, "%s: ", argv[0]);
400 perror ("connect");
401 fail (argc, argv);
404 /* We use the stream OUT to send our command to the server. */
405 if ((out = fdopen (s, "r+")) == NULL)
407 fprintf (stderr, "%s: ", argv[0]);
408 perror ("fdopen");
409 fail (argc, argv);
412 /* We use the stream IN to read the response.
413 We used to use just one stream for both output and input
414 on the socket, but reversing direction works nonportably:
415 on some systems, the output appears as the first input;
416 on other systems it does not. */
417 if ((in = fdopen (s, "r+")) == NULL)
419 fprintf (stderr, "%s: ", argv[0]);
420 perror ("fdopen");
421 fail (argc, argv);
424 #ifdef BSD_SYSTEM
425 cwd = getwd (string);
426 #else
427 cwd = getcwd (string, sizeof string);
428 #endif
429 if (cwd == 0)
431 /* getwd puts message in STRING if it fails. */
432 fprintf (stderr, "%s: %s (%s)\n", argv[0],
433 #ifdef BSD_SYSTEM
434 string,
435 #else
436 "Cannot get current working directory",
437 #endif
438 strerror (errno));
439 fail (argc, argv);
442 if (nowait)
443 fprintf (out, "-nowait ");
445 if (eval)
446 fprintf (out, "-eval ");
448 if (display)
449 fprintf (out, "-display %s ", quote_file_name (display));
451 for (i = optind; i < argc; i++)
453 if (eval)
454 ; /* Don't prepend any cwd or anything like that. */
455 else if (*argv[i] == '+')
457 char *p = argv[i] + 1;
458 while (isdigit ((unsigned char) *p) || *p == ':') p++;
459 if (*p != 0)
460 fprintf (out, "%s/", quote_file_name (cwd));
462 else if (*argv[i] != '/')
463 fprintf (out, "%s/", quote_file_name (cwd));
465 fprintf (out, "%s ", quote_file_name (argv[i]));
467 fprintf (out, "\n");
468 fflush (out);
470 /* Maybe wait for an answer. */
471 if (nowait)
472 return 0;
474 if (!eval)
476 printf ("Waiting for Emacs...");
477 needlf = 2;
479 fflush (stdout);
481 /* Now, wait for an answer and print any messages. */
482 while ((str = fgets (string, BUFSIZ, in)))
484 if (needlf == 2)
485 printf ("\n");
486 printf ("%s", str);
487 needlf = str[0] == '\0' ? needlf : str[strlen (str) - 1] != '\n';
490 if (needlf)
491 printf ("\n");
492 fflush (stdout);
494 return 0;
497 #endif /* HAVE_SOCKETS */
499 #ifndef HAVE_STRERROR
500 char *
501 strerror (errnum)
502 int errnum;
504 extern char *sys_errlist[];
505 extern int sys_nerr;
507 if (errnum >= 0 && errnum < sys_nerr)
508 return sys_errlist[errnum];
509 return (char *) "Unknown error";
512 #endif /* ! HAVE_STRERROR */