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)
34 static char header_rcsid [] = "!Header: gnuserv.h,v 2.4 95/02/16 11:58:11 arup alpha !";
42 /* gnuserv should not be compiled using SOCKS */
43 #define DO_NOT_SOCKSIFY
44 #define DONT_ENCAPSULATE
48 /* Define the communication method between server and clients:
49 * You can have either or both kinds of sockets, but you can't mix
50 * sockets with sysv ipc
54 #define INTERNET_DOMAIN_SOCKETS
56 #define UNIX_DOMAIN_SOCKETS
57 /* #define SYSV_IPC */
61 * Define additional authentication protocols to be used. These methods will
62 * be tried before falling back to the default gnuserv protocol (based on
63 * the GNU_SECURE environment variable). Currently, only MIT-MAGIC-COOKIE-1
66 * Comment out the next line(s) if you don't want to enable the
67 * appropriate authentication protocol.
70 #if defined (HAVE_XAUTH)
71 #define AUTH_MAGIC_COOKIE
72 #endif /* HAVE_XAUTH */
75 * stuff related to supporting MIT-MAGIC-COOKIE-1
78 #define MCOOKIE_SCREEN "999" /* screen # to use as the gnuserv cookie */
79 #define MCOOKIE_NAME "MAGIC-1" /* authentication protocol name */
80 #define MCOOKIE_X_NAME "MIT-MAGIC-COOKIE-1" /* as needed by X */
83 #define DEFAUTH_NAME "GNU-SECURE" /* name of default auth protocol */
84 #define AUTH_TIMEOUT 15 /* # seconds to wait for auth data */
85 #define AUTH_NAMESZ 15 /* max allows auth protocol name size */
89 * Pick a default communication scheme, if none was specified.
92 #if !defined(SYSV_IPC) && !defined(UNIX_DOMAIN_SOCKETS) && !defined(INTERNET_DOMAIN_SOCKETS)
95 #define SYSV_IPC /* SYSV systems use SYSV IPC by default */
96 #endif /* HAVE_SYSVIPC */
99 #define UNIX_DOMAIN_SOCKETS /* BSD systems use Unix Domain sockets by default */
102 #endif /* No communication method pre-defined */
104 #include <sys/types.h>
105 #include <sys/param.h>
106 #include <sys/stat.h>
117 #ifdef HAVE_SYS_TIME_H
118 #include <sys/time.h>
122 * If you are using SYSV_IPC, you might want to make the buffer size bigger
123 * since it limits the size of requests and responses. Don't make it bigger
124 * than your system's max message size though (usually a couple of k) or else
125 * msgsend will start failing. For sockets, using the system BUFSIZ is usually
129 # define GSERV_BUFSZ BUFSIZ
136 #define send_string(s,str) \
137 if (strlen(msgp->mtext) + strlen(str) < GSERV_BUFSZ) \
138 strcat(msgp->mtext,str); \
141 fprintf(stderr,"%s: not enough message buffer space\n",progname); \
145 #endif /* SYSV_IPC */
147 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
148 #include <sys/socket.h>
149 #endif /* INTERNET_DOMAIN_SOCKETS || UNIX_DOMAIN_SOCKETS */
151 #ifdef INTERNET_DOMAIN_SOCKETS
153 #include <netinet/in.h>
154 #include <arpa/inet.h>
155 #define TABLE_SIZE 101 /* The number of entries in the hash table */
156 #define HASH(host) host /* Rather simplistic hash function */
157 #define DEFAULT_PORT 21490 /* default port number to use is
158 * DEFAULT_PORT + uid */
159 #endif /* INTERNET_DOMAIN_SOCKETS */
161 #ifdef UNIX_DOMAIN_SOCKETS
163 #define HIDE_UNIX_SOCKET /* put the unix socket in a protected dir */
164 #endif /* UNIX_DOMAIN_SOCKETS */
166 /* On some platforms, we need to do the equivalent of "stty litout" to get
167 * characters like ^D to pass through to emacs. This problem has only
168 * been observed under emacs18; fsf19 and lemacs are probably okay without it.
170 #ifndef DONT_USE_LITOUT
171 #if !defined(HAVE_TERMIO) && !defined(HAVE_TERMIOS) && !defined(VMS)
179 #define HOSTNAMSZ 255 /* max size of a hostname */
180 #define REPLYSIZ 300 /* max size of reply from server to client */
188 extern char *progname;
191 /* The casts shut Sun's compiler up and are safe in the context these
192 are actually used. */
193 #define max2(x,y) (((int) (x) > (int) (y)) ? (x) : (y))
194 #define min2(x,y) (((int) (x) < (int) (y)) ? (x) : (y))
196 #ifndef _NFILE /* rough guess at maximum number of open files */
200 #define EOT_STR "\004"
201 #define EOT_CHR '\004'
203 /* connection types */
205 #define CONN_INTERNET 1
208 /* function declarations */
209 int make_connection (char *hostarg, int portarg, int *s);
211 void disconnect_from_ipc_server();
213 #if defined(INTERNET_DOMAIN_SOCKETS) || defined(UNIX_DOMAIN_SOCKETS)
214 void send_string (int s, const char *msg);
215 void disconnect_from_server (int s, int echo);
216 int read_line (int s, char *dest);
218 #ifdef INTERNET_DOMAIN_SOCKETS
219 int internet_addr (char *host);