3 Header file for the GNU Emacs server and client C code.
5 This file is part of GNU Emacs.
7 Copying is permitted under those conditions described by the GNU
8 General Public License.
10 Copyright (C) 1989 Free Software Foundation, Inc.
12 Author: Andy Norman (ange@hplb.hpl.hp.com), based on
13 'etc/server.c' and 'etc/emacsclient.c' from the 18.52 GNU
16 Please mail bugs and suggestions to the author at the above address.
20 * 11-Nov-1990 bristor@simba
25 * This file incorporates new features added by Bob Weiner <weiner@mot.com>,
26 * Darrell Kindred <dkindred@cmu.edu> and Arup Mukherjee <arup@cmu.edu>.
27 * Please see the note at the end of the README file for details.
29 * (If gnuserv came bundled with your emacs, the README file is probably
30 * ../etc/gnuserv.README relative to the directory containing this file)
33 #define GNUSERV_VERSION "3.12"
35 /* Note: this setting can cause client-server connection failure if the
36 * value of TMPDIR is not shared by client and server at run-time.
43 /* gnuserv should not be compiled using SOCKS */
44 #define DO_NOT_SOCKSIFY
45 #define DONT_ENCAPSULATE
49 /* Define the communication method between server and clients:
50 * You can have either or both kinds of sockets, but you can't mix
51 * sockets with sysv ipc
55 #define INTERNET_DOMAIN_SOCKETS
57 #define UNIX_DOMAIN_SOCKETS
58 /* #define SYSV_IPC */
62 * Define additional authentication protocols to be used. These methods will
63 * be tried before falling back to the default gnuserv protocol (based on
64 * the GNU_SECURE environment variable). Currently, only MIT-MAGIC-COOKIE-1
67 * Comment out the next line(s) if you don't want to enable the
68 * appropriate authentication protocol.
71 #if defined (HAVE_XAUTH)
72 #define AUTH_MAGIC_COOKIE
73 #endif /* HAVE_XAUTH */
76 * stuff related to supporting MIT-MAGIC-COOKIE-1
79 #define MCOOKIE_SCREEN "999" /* screen # to use as the gnuserv cookie */
80 #define MCOOKIE_NAME "MAGIC-1" /* authentication protocol name */
81 #define MCOOKIE_X_NAME "MIT-MAGIC-COOKIE-1" /* as needed by X */
84 #define DEFAUTH_NAME "GNU-SECURE" /* name of default auth protocol */
85 #define AUTH_TIMEOUT 15 /* # seconds to wait for auth data */
86 #define AUTH_NAMESZ 15 /* max allows auth protocol name size */
90 * Pick a default communication scheme, if none was specified.
93 #if !defined(SYSV_IPC) && !defined(UNIX_DOMAIN_SOCKETS) && !defined(INTERNET_DOMAIN_SOCKETS)
96 #define SYSV_IPC /* SYSV systems use SYSV IPC by default */
97 #endif /* HAVE_SYSVIPC */
100 #define UNIX_DOMAIN_SOCKETS /* BSD systems use Unix Domain sockets by default */
103 #endif /* No communication method pre-defined */
105 #include <sys/types.h>
106 #include <sys/param.h>
107 #include <sys/stat.h>
118 #ifdef HAVE_SYS_TIME_H
119 #include <sys/time.h>
123 * If you are using SYSV_IPC, you might want to make the buffer size bigger
124 * since it limits the size of requests and responses. Don't make it bigger
125 * than your system's max message size though (usually a couple of k) or else
126 * msgsend will start failing. For sockets, using the system BUFSIZ is usually
130 # define GSERV_BUFSZ BUFSIZ
137 #define send_string(s,str) \
138 if (strlen(msgp->mtext) + strlen(str) < GSERV_BUFSZ) \
139 strcat(msgp->mtext,str); \
142 fprintf(stderr,"%s: not enough message buffer space\n",progname); \
146 #endif /* SYSV_IPC */
148 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
149 #include <sys/socket.h>
150 #endif /* INTERNET_DOMAIN_SOCKETS || UNIX_DOMAIN_SOCKETS */
152 #ifdef INTERNET_DOMAIN_SOCKETS
154 #include <netinet/in.h>
155 #include <arpa/inet.h>
156 #define TABLE_SIZE 101 /* The number of entries in the hash table */
157 #define HASH(host) host /* Rather simplistic hash function */
158 #define DEFAULT_PORT 21490 /* default port number to use is
159 * DEFAULT_PORT + uid */
160 #endif /* INTERNET_DOMAIN_SOCKETS */
162 #ifdef UNIX_DOMAIN_SOCKETS
164 #define HIDE_UNIX_SOCKET /* put the unix socket in a protected dir */
165 #endif /* UNIX_DOMAIN_SOCKETS */
167 /* On some platforms, we need to do the equivalent of "stty litout" to get
168 * characters like ^D to pass through to emacs. This problem has only
169 * been observed under emacs18; fsf19 and lemacs are probably okay without it.
171 #ifndef DONT_USE_LITOUT
172 #if !defined(HAVE_TERMIO) && !defined(HAVE_TERMIOS) && !defined(VMS)
180 #define HOSTNAMSZ 255 /* max size of a hostname */
181 #define REPLYSIZ 300 /* max size of reply from server to client */
189 extern char *progname;
192 /* The casts shut Sun's compiler up and are safe in the context these
193 are actually used. */
194 #define max2(x,y) (((int) (x) > (int) (y)) ? (x) : (y))
195 #define min2(x,y) (((int) (x) < (int) (y)) ? (x) : (y))
197 #ifndef _NFILE /* rough guess at maximum number of open files */
201 #define EOT_STR "\004"
202 #define EOT_CHR '\004'
204 /* connection types */
206 #define CONN_INTERNET 1
209 /* function declarations */
210 int make_connection (char *hostarg, int portarg, int *s);
212 void disconnect_from_ipc_server();
214 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
215 void send_string (int s, const char *msg);
216 void disconnect_from_server (int s, int echo);
217 int read_line (int s, char *dest);
219 #ifdef INTERNET_DOMAIN_SOCKETS
220 int internet_addr (char *host);