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"
40 /* gnuserv should not be compiled using SOCKS */
41 #define DO_NOT_SOCKSIFY
42 #define DONT_ENCAPSULATE
46 /* Define the communication method between server and clients:
47 * You can have either or both kinds of sockets, but you can't mix
48 * sockets with sysv ipc
52 #define INTERNET_DOMAIN_SOCKETS
54 #define UNIX_DOMAIN_SOCKETS
55 /* #define SYSV_IPC */
59 * Define additional authentication protocols to be used. These methods will
60 * be tried before falling back to the default gnuserv protocol (based on
61 * the GNU_SECURE environment variable). Currently, only MIT-MAGIC-COOKIE-1
64 * Comment out the next line(s) if you don't want to enable the
65 * appropriate authentication protocol.
68 #if defined (HAVE_XAUTH)
69 #define AUTH_MAGIC_COOKIE
70 #endif /* HAVE_XAUTH */
73 * stuff related to supporting MIT-MAGIC-COOKIE-1
76 #define MCOOKIE_SCREEN "999" /* screen # to use as the gnuserv cookie */
77 #define MCOOKIE_NAME "MAGIC-1" /* authentication protocol name */
78 #define MCOOKIE_X_NAME "MIT-MAGIC-COOKIE-1" /* as needed by X */
81 #define DEFAUTH_NAME "GNU-SECURE" /* name of default auth protocol */
82 #define AUTH_TIMEOUT 15 /* # seconds to wait for auth data */
83 #define AUTH_NAMESZ 15 /* max allows auth protocol name size */
87 * Pick a default communication scheme, if none was specified.
90 #if !defined(SYSV_IPC) && !defined(UNIX_DOMAIN_SOCKETS) && !defined(INTERNET_DOMAIN_SOCKETS)
93 #define SYSV_IPC /* SYSV systems use SYSV IPC by default */
94 #endif /* HAVE_SYSVIPC */
97 #define UNIX_DOMAIN_SOCKETS /* BSD systems use Unix Domain sockets by default */
100 #endif /* No communication method pre-defined */
102 #include <sys/types.h>
103 #include <sys/param.h>
104 #include <sys/stat.h>
115 #ifdef HAVE_SYS_TIME_H
116 #include <sys/time.h>
120 * If you are using SYSV_IPC, you might want to make the buffer size bigger
121 * since it limits the size of requests and responses. Don't make it bigger
122 * than your system's max message size though (usually a couple of k) or else
123 * msgsend will start failing. For sockets, using the system BUFSIZ is usually
127 # define GSERV_BUFSZ BUFSIZ
134 #define send_string(s,str) \
135 if (strlen(msgp->mtext) + strlen(str) < GSERV_BUFSZ) \
136 strcat(msgp->mtext,str); \
139 fprintf(stderr,"%s: not enough message buffer space\n",progname); \
143 #endif /* SYSV_IPC */
145 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
146 #include <sys/socket.h>
147 #endif /* INTERNET_DOMAIN_SOCKETS || UNIX_DOMAIN_SOCKETS */
149 #ifdef INTERNET_DOMAIN_SOCKETS
151 #include <netinet/in.h>
152 #include <arpa/inet.h>
153 #define TABLE_SIZE 101 /* The number of entries in the hash table */
154 #define HASH(host) host /* Rather simplistic hash function */
155 #define DEFAULT_PORT 21490 /* default port number to use is
156 * DEFAULT_PORT + uid */
157 #endif /* INTERNET_DOMAIN_SOCKETS */
159 #ifdef UNIX_DOMAIN_SOCKETS
161 #define HIDE_UNIX_SOCKET /* put the unix socket in a protected dir */
162 #endif /* UNIX_DOMAIN_SOCKETS */
164 /* On some platforms, we need to do the equivalent of "stty litout" to get
165 * characters like ^D to pass through to emacs. This problem has only
166 * been observed under emacs18; fsf19 and lemacs are probably okay without it.
168 #ifndef DONT_USE_LITOUT
169 #if !defined(HAVE_TERMIO) && !defined(HAVE_TERMIOS) && !defined(VMS)
177 #define HOSTNAMSZ 255 /* max size of a hostname */
178 #define REPLYSIZ 300 /* max size of reply from server to client */
186 extern char *progname;
189 /* The casts shut Sun's compiler up and are safe in the context these
190 are actually used. */
191 #define max2(x,y) (((int) (x) > (int) (y)) ? (x) : (y))
192 #define min2(x,y) (((int) (x) < (int) (y)) ? (x) : (y))
194 #ifndef _NFILE /* rough guess at maximum number of open files */
198 #define EOT_STR "\004"
199 #define EOT_CHR '\004'
201 /* connection types */
203 #define CONN_INTERNET 1
206 /* function declarations */
207 int make_connection (char *hostarg, int portarg, int *s);
209 void disconnect_from_ipc_server();
211 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
212 void send_string (int s, const char *msg);
213 void disconnect_from_server (int s, int echo);
214 int read_line (int s, char *dest);
216 #ifdef INTERNET_DOMAIN_SOCKETS
217 int internet_addr (char *host);