common.h

   1 /*
   2  * userv - common.h
   3  * definitions shared between client and daemon
   4  *
   5  * Copyright (C)1996-1997 Ian Jackson
   6  *
   7  * This is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with userv; if not, write to the Free Software
  19  * Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  20  */
  21
  22 #ifndef COMMON_H
  23 #define COMMON_H
  24
  25 #define PCSUMSIZE 16
  26
  27 static const unsigned char protocolchecksumversion[PCSUMSIZE]= {
  28 #include "pcsum.h"
  29 };
  30
  31 #ifndef VARDIR
  32 # define VARDIR "/var/run/userv"
  33 #endif
  34
  35 #ifndef RENDEZVOUS
  36 # define RENDEZVOUS "socket"
  37 #endif
  38
  39 #ifndef RENDEZVOUSPATH
  40 # define RENDEZVOUSPATH VARDIR "/" RENDEZVOUS
  41 #endif
  42
  43 #ifndef PIPEFORMAT
  44 # define PIPEFORMAT "%lx.%lx.%x"
  45 # define PIPEPATTERN "[0-9a-f]*.[0-9a-f]*.*[0-9a-f]"
  46 # define PIPEFORMATEXTEND (sizeof(long)*2*2+sizeof(int)*2+1)
  47 # define PIPEMAXLEN (sizeof(PIPEFORMAT)+PIPEFORMATEXTEND)
  48 #endif
  49
  50 #ifndef PIPEPATHFORMAT
  51 # define PIPEPATHFORMAT VARDIR "/" PIPEFORMAT
  52 # define PIPEPATHMAXLEN (sizeof(PIPEPATHFORMAT)+PIPEFORMATEXTEND)
  53 #endif
  54
  55 #define MAX_ALLOW_FD 1024
  56 #define MAX_GENERAL_STRING (1024*1024)
  57 #define MAX_OVERRIDE_LEN MAX_GENERAL_STRING
  58 #define MAX_ARGSDEFVAR 4096
  59 #define MAX_GIDS 1024
  60
  61 #ifdef DEBUG
  62 # define BASE_MAGIC 0x5deb7567UL /* "\x5d\xebug" */
  63 #else
  64 # define BASE_MAGIC 0x755e7276UL /* "u\x5erv" */
  65 #endif
  66
  67 enum {
  68   OPENING_MAGIC= BASE_MAGIC+1,
  69   REQUEST_MAGIC,
  70   REQUEST_END_MAGIC,
  71   PROGRESS_MAGIC,
  72   PROGRESS_ERRMSG_END_MAGIC,
  73   EVENT_MAGIC
  74 };
  75
  76 struct opening_msg {
  77   unsigned long magic;
  78   unsigned char protocolchecksumversion[PCSUMSIZE];
  79   pid_t serverpid;
  80 };
  81
  82 struct request_msg {
  83   unsigned long magic;
  84   pid_t clientpid;
  85   int serviceuserlen;
  86   int servicelen;
  87   int lognamelen;
  88   int cwdlen;
  89   uid_t callinguid;
  90   int ngids, nreadfds, nwritefds, nargs, nvars, overridelen;
  91   /* Followed by:
  92    *   serviceuserlen bytes for the service user (unterminated)
  93    *   servicelen bytes for the service (unterminated)
  94    *   lognamelen bytes for the login name (unterminated)
  95    *   cwdlen bytes for the cwd (unterminated)
  96    *   ngids gid_ts for the primary group and supplementary groups
  97    *   nreadfds and then nwritefds ints for the file descriptors
  98    *   for each of the nargs arguments
  99    *    an int for the string length
 100    *    that many characters (unterminated)
 101    *   for each for the nvars variable keys
 102    *    an int for the key length
 103    *    that many characters (unterminated)
 104    *    an int for the value length
 105    *    that many characters (unterminated)
 106    *   one unsigned long, endmagic;
 107    */
 108 };
 109
 110 struct progress_msg {
 111   unsigned long magic;
 112   enum { pt_ok, pt_errmsg, pt_failed, pt_terminated } type;
 113   union {
 114     struct { int messagelen; } errmsg;
 115     struct { int status; } terminated;
 116   } data;
 117   /* follwed by variable-length part:
 118    *  for ok: nothing
 119    *  for errmsg: messagelen bytes for the error message (unterminated)
 120    *              unsigned long PROGRESS_MAGIC
 121    *  for terminated: nothing
 122    */
 123 };
 124
 125 struct event_msg {
 126   unsigned long magic;
 127   enum { et_confirm, et_closereadfd, et_disconnect } type;
 128   union {
 129     struct { int fd; } closereadfd;
 130   } data;
 131 };
 132
 133 #endif