(fortran-break-before-delimiters): Doc fix.
[emacs.git] / lib-src / emacsclient.c
blob3ae33f72a18a3da765d7522ce7d6536ec52a6edd
1 /* Client process that communicates with GNU Emacs acting as server.
2 Copyright (C) 1986, 1987, 1994, 1999, 2000, 2001, 2003, 2004
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 /* If non-NULL, the filename of the UNIX socket. */
71 char *socket_name = NULL;
73 void print_help_and_exit ();
75 struct option longopts[] =
77 { "no-wait", no_argument, NULL, 'n' },
78 { "eval", no_argument, NULL, 'e' },
79 { "help", no_argument, NULL, 'H' },
80 { "version", no_argument, NULL, 'V' },
81 { "alternate-editor", required_argument, NULL, 'a' },
82 { "socket-name", required_argument, NULL, 's' },
83 { "display", required_argument, NULL, 'd' },
84 { 0, 0, 0, 0 }
87 /* Decode the options from argv and argc.
88 The global variable `optind' will say how many arguments we used up. */
90 void
91 decode_options (argc, argv)
92 int argc;
93 char **argv;
95 while (1)
97 int opt = getopt_long (argc, argv,
98 "VHnea:s:d:", longopts, 0);
100 if (opt == EOF)
101 break;
103 alternate_editor = getenv ("ALTERNATE_EDITOR");
105 switch (opt)
107 case 0:
108 /* If getopt returns 0, then it has already processed a
109 long-named option. We should do nothing. */
110 break;
112 case 'a':
113 alternate_editor = optarg;
114 break;
116 case 's':
117 socket_name = optarg;
118 break;
120 case 'd':
121 display = optarg;
122 break;
124 case 'n':
125 nowait = 1;
126 break;
128 case 'e':
129 eval = 1;
130 break;
132 case 'V':
133 printf ("emacsclient %s\n", VERSION);
134 exit (0);
135 break;
137 case 'H':
138 print_help_and_exit ();
139 break;
141 default:
142 fprintf (stderr, "Try `%s --help' for more information\n", progname);
143 exit (1);
144 break;
149 void
150 print_help_and_exit ()
152 printf (
153 "Usage: %s [OPTIONS] FILE...\n\
154 Tell the Emacs server to visit the specified files.\n\
155 Every FILE can be either just a FILENAME or [+LINE[:COLUMN]] FILENAME.\n\
157 The following OPTIONS are accepted:\n\
158 -V, --version Just print a version info and return\n\
159 -H, --help Print this usage information message\n\
160 -n, --no-wait Don't wait for the server to return\n\
161 -e, --eval Evaluate the FILE arguments as ELisp expressions\n\
162 -d, --display=DISPLAY Visit the file in the given display\n\
163 -s, --socket-name=FILENAME\n\
164 Set the filename of the UNIX socket for communication\n\
165 -a, --alternate-editor=EDITOR\n\
166 Editor to fallback to if the server is not running\n\
168 Report bugs to bug-gnu-emacs@gnu.org.\n", progname);
169 exit (0);
172 /* In NAME, insert a & before each &, each space, each newline, and
173 any initial -. Change spaces to underscores, too, so that the
174 return value never contains a space. */
176 void
177 quote_file_name (name, stream)
178 char *name;
179 FILE *stream;
181 char *copy = (char *) malloc (strlen (name) * 2 + 1);
182 char *p, *q;
184 p = name;
185 q = copy;
186 while (*p)
188 if (*p == ' ')
190 *q++ = '&';
191 *q++ = '_';
192 p++;
194 else if (*p == '\n')
196 *q++ = '&';
197 *q++ = 'n';
198 p++;
200 else
202 if (*p == '&' || (*p == '-' && p == name))
203 *q++ = '&';
204 *q++ = *p++;
207 *q++ = 0;
209 fprintf (stream, copy);
211 free (copy);
214 /* Like malloc but get fatal error if memory is exhausted. */
216 long *
217 xmalloc (size)
218 unsigned int size;
220 long *result = (long *) malloc (size);
221 if (result == NULL)
223 perror ("malloc");
224 exit (1);
226 return result;
230 Try to run a different command, or --if no alternate editor is
231 defined-- exit with an errorcode.
233 void
234 fail (argc, argv)
235 int argc;
236 char **argv;
238 if (alternate_editor)
240 int i = optind - 1;
241 execvp (alternate_editor, argv + i);
242 return;
244 else
246 exit (1);
252 #if !defined (HAVE_SOCKETS) || defined (NO_SOCKETS_IN_FILE_SYSTEM)
255 main (argc, argv)
256 int argc;
257 char **argv;
259 fprintf (stderr, "%s: Sorry, the Emacs server is supported only\n",
260 argv[0]);
261 fprintf (stderr, "on systems with Berkeley sockets.\n");
263 fail (argc, argv);
266 #else /* HAVE_SOCKETS */
268 #include <sys/types.h>
269 #include <sys/socket.h>
270 #include <sys/un.h>
271 #include <sys/stat.h>
272 #include <errno.h>
274 extern char *strerror ();
275 extern int errno;
277 /* Three possibilities:
278 2 - can't be `stat'ed (sets errno)
279 1 - isn't owned by us
280 0 - success: none of the above */
282 static int
283 socket_status (socket_name)
284 char *socket_name;
286 struct stat statbfr;
288 if (stat (socket_name, &statbfr) == -1)
289 return 2;
291 if (statbfr.st_uid != geteuid ())
292 return 1;
294 return 0;
298 main (argc, argv)
299 int argc;
300 char **argv;
302 char *system_name;
303 int system_name_length;
304 int s, i, needlf = 0;
305 FILE *out, *in;
306 struct sockaddr_un server;
307 char *cwd, *str;
308 char string[BUFSIZ];
310 progname = argv[0];
312 /* Process options. */
313 decode_options (argc, argv);
315 if ((argc - optind < 1) && !eval)
317 fprintf (stderr, "%s: file name or argument required\n", progname);
318 fprintf (stderr, "Try `%s --help' for more information\n", progname);
319 exit (1);
323 * Open up an AF_UNIX socket in this person's home directory
326 if ((s = socket (AF_UNIX, SOCK_STREAM, 0)) < 0)
328 fprintf (stderr, "%s: ", argv[0]);
329 perror ("socket");
330 fail (argc, argv);
333 server.sun_family = AF_UNIX;
336 char *dot;
337 system_name_length = 32;
339 while (1)
341 system_name = (char *) xmalloc (system_name_length + 1);
343 /* system_name must be null-terminated string. */
344 system_name[system_name_length] = '\0';
346 if (gethostname (system_name, system_name_length) == 0)
347 break;
349 free (system_name);
350 system_name_length *= 2;
353 /* We always use the non-dotted host name, for simplicity. */
354 dot = index (system_name, '.');
355 if (dot)
356 *dot = '\0';
360 int sock_status = 0;
361 int default_sock = !socket_name;
362 int saved_errno;
364 if (default_sock)
366 socket_name = alloca (system_name_length + 100);
367 sprintf (socket_name, "/tmp/emacs%d-%s/server",
368 (int) geteuid (), system_name);
371 if (strlen (socket_name) < sizeof (server.sun_path))
372 strcpy (server.sun_path, socket_name);
373 else
375 fprintf (stderr, "%s: socket-name %s too long",
376 argv[0], socket_name);
377 exit (1);
380 /* See if the socket exists, and if it's owned by us. */
381 sock_status = socket_status (server.sun_path);
382 saved_errno = errno;
383 if (sock_status && default_sock)
385 /* Failing that, see if LOGNAME or USER exist and differ from
386 our euid. If so, look for a socket based on the UID
387 associated with the name. This is reminiscent of the logic
388 that init_editfns uses to set the global Vuser_full_name. */
390 char *user_name = (char *) getenv ("LOGNAME");
392 if (!user_name)
393 user_name = (char *) getenv ("USER");
395 if (user_name)
397 struct passwd *pw = getpwnam (user_name);
399 if (pw && (pw->pw_uid != geteuid ()))
401 /* We're running under su, apparently. */
402 sprintf (socket_name, "/tmp/emacs%d-%s/server",
403 (int) pw->pw_uid, system_name);
405 if (strlen (socket_name) < sizeof (server.sun_path))
406 strcpy (server.sun_path, socket_name);
407 else
409 fprintf (stderr, "%s: socket-name %s too long",
410 argv[0], socket_name);
411 exit (1);
414 sock_status = socket_status (server.sun_path);
415 saved_errno = errno;
417 else
418 errno = saved_errno;
422 switch (sock_status)
424 case 1:
425 /* There's a socket, but it isn't owned by us. This is OK if
426 we are root. */
427 if (0 != geteuid ())
429 fprintf (stderr, "%s: Invalid socket owner\n", argv[0]);
430 fail (argc, argv);
432 break;
434 case 2:
435 /* `stat' failed */
436 if (saved_errno == ENOENT)
437 fprintf (stderr,
438 "%s: can't find socket; have you started the server?\n\
439 To start the server in Emacs, type \"M-x server-start\".\n",
440 argv[0]);
441 else
442 fprintf (stderr, "%s: can't stat %s: %s\n",
443 argv[0], server.sun_path, strerror (saved_errno));
444 fail (argc, argv);
445 break;
449 if (connect (s, (struct sockaddr *) &server, strlen (server.sun_path) + 2)
450 < 0)
452 fprintf (stderr, "%s: ", argv[0]);
453 perror ("connect");
454 fail (argc, argv);
457 /* We use the stream OUT to send our command to the server. */
458 if ((out = fdopen (s, "r+")) == NULL)
460 fprintf (stderr, "%s: ", argv[0]);
461 perror ("fdopen");
462 fail (argc, argv);
465 /* We use the stream IN to read the response.
466 We used to use just one stream for both output and input
467 on the socket, but reversing direction works nonportably:
468 on some systems, the output appears as the first input;
469 on other systems it does not. */
470 if ((in = fdopen (s, "r+")) == NULL)
472 fprintf (stderr, "%s: ", argv[0]);
473 perror ("fdopen");
474 fail (argc, argv);
477 #ifdef HAVE_GETCWD
478 cwd = getcwd (string, sizeof string);
479 #else
480 cwd = getwd (string);
481 #endif
482 if (cwd == 0)
484 /* getwd puts message in STRING if it fails. */
486 #ifdef HAVE_GETCWD
487 fprintf (stderr, "%s: %s (%s)\n", argv[0],
488 "Cannot get current working directory", strerror (errno));
489 #else
490 fprintf (stderr, "%s: %s (%s)\n", argv[0], string, strerror (errno));
491 #endif
492 fail (argc, argv);
495 if (nowait)
496 fprintf (out, "-nowait ");
498 if (eval)
499 fprintf (out, "-eval ");
501 if (display)
503 fprintf (out, "-display ");
504 quote_file_name (display, out);
505 fprintf (out, " ");
508 if ((argc - optind > 0))
510 for (i = optind; i < argc; i++)
512 if (eval)
513 ; /* Don't prepend any cwd or anything like that. */
514 else if (*argv[i] == '+')
516 char *p = argv[i] + 1;
517 while (isdigit ((unsigned char) *p) || *p == ':') p++;
518 if (*p != 0)
520 quote_file_name (cwd, out);
521 fprintf (out, "/");
524 else if (*argv[i] != '/')
526 quote_file_name (cwd, out);
527 fprintf (out, "/");
530 quote_file_name (argv[i], out);
531 fprintf (out, " ");
534 else
536 while ((str = fgets (string, BUFSIZ, stdin)))
538 quote_file_name (str, out);
540 fprintf (out, " ");
543 fprintf (out, "\n");
544 fflush (out);
546 /* Maybe wait for an answer. */
547 if (nowait)
548 return 0;
550 if (!eval)
552 printf ("Waiting for Emacs...");
553 needlf = 2;
555 fflush (stdout);
557 /* Now, wait for an answer and print any messages. */
558 while ((str = fgets (string, BUFSIZ, in)))
560 if (needlf == 2)
561 printf ("\n");
562 printf ("%s", str);
563 needlf = str[0] == '\0' ? needlf : str[strlen (str) - 1] != '\n';
566 if (needlf)
567 printf ("\n");
568 fflush (stdout);
570 return 0;
573 #endif /* HAVE_SOCKETS */
575 #ifndef HAVE_STRERROR
576 char *
577 strerror (errnum)
578 int errnum;
580 extern char *sys_errlist[];
581 extern int sys_nerr;
583 if (errnum >= 0 && errnum < sys_nerr)
584 return sys_errlist[errnum];
585 return (char *) "Unknown error";
588 #endif /* ! HAVE_STRERROR */
590 /* arch-tag: f39bb9c4-73eb-477e-896d-50832e2ca9a7
591 (do not change this comment) */