include/rpcsvc/yp_prot.h

   1 /*
   2  * Copyright (c) 1992/3 Theo de Raadt <deraadt@fsa.ca>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. The name of the author may not be used to endorse or promote
  14  *    products derived from this software without specific prior written
  15  *    permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
  18  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  21  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27  * SUCH DAMAGE.
  28  *
  29  * $FreeBSD: src/include/rpcsvc/yp_prot.h,v 1.10.2.1 2002/02/15 00:46:53 des Exp $
  30  * $DragonFly: src/include/rpcsvc/yp_prot.h,v 1.3 2004/12/15 09:44:47 dillon Exp $
  31  */
  32
  33 #ifndef _RPCSVC_YP_PROT_H_
  34 #define _RPCSVC_YP_PROT_H_
  35
  36 /*
  37  * YPSERV PROTOCOL:
  38  *
  39  * ypserv supports the following procedures:
  40  *
  41  * YPPROC_NULL          takes (void), returns (void).
  42  *                      called to check if server is alive.
  43  * YPPROC_DOMAIN        takes (char *), returns (bool_t).
  44  *                      true if ypserv serves the named domain.
  45  * YPPROC_DOMAIN_NOACK  takes (char *), returns (bool_t).
  46  *                      true if ypserv serves the named domain.
  47  *                      used for broadcasts, does not ack if ypserv
  48  *                      doesn't handle named domain.
  49  * YPPROC_MATCH         takes (struct ypreq_key), returns (struct ypresp_val)
  50  *                      does a lookup.
  51  * YPPROC_FIRST         takes (struct ypreq_nokey) returns (ypresp_key_val).
  52  *                      gets the first key/datum from the map.
  53  * YPPROC_NEXT          takes (struct ypreq_key) returns (ypresp_key_val).
  54  *                      gets the next key/datum from the map.
  55  * YPPROC_XFR           takes (struct ypreq_xfr), returns (void).
  56  *                      tells ypserv to check if there is a new version of
  57  *                      the map.
  58  * YPPROC_CLEAR         takes (void), returns (void).
  59  *                      tells ypserv to flush it's file cache, so that
  60  *                      newly transferred files will get read.
  61  * YPPROC_ALL           takes (struct ypreq_nokey), returns (bool_t and
  62  *                      struct ypresp_key_val).
  63  *                      returns an array of data, with the bool_t being
  64  *                      false on the last datum. read the source, it's
  65  *                      convoluted.
  66  * YPPROC_MASTER        takes (struct ypreq_nokey), returns (ypresp_master).
  67  * YPPROC_ORDER         takes (struct ypreq_nokey), returns (ypresp_order).
  68  * YPPROC_MAPLIST       takes (char *), returns (struct ypmaplist *).
  69  */
  70
  71 /* Program and version symbols, magic numbers */
  72
  73 #define YPPROG          ((u_long)100004)
  74 #define YPVERS          ((u_long)2)
  75 #define YPVERS_ORIG     ((u_long)1)
  76 #define YPMAXRECORD     ((u_long)1024)
  77 #define YPMAXDOMAIN     ((u_long)64)
  78 #define YPMAXMAP        ((u_long)64)
  79 #define YPMAXPEER       ((u_long)256)
  80
  81 /*
  82  * I don't know if anything of sun's depends on this, or if they
  83  * simply defined it so that their own code wouldn't try to send
  84  * packets over the ethernet MTU. This YP code doesn't use it.
  85  */
  86 #define YPMSGSZ         1600
  87
  88 #ifndef DATUM
  89 typedef struct {
  90         char    *dptr;
  91         int     dsize;
  92 } datum;
  93 #define DATUM
  94 #endif
  95
  96 struct ypmap_parms {
  97         char *domain;
  98         char *map;
  99         u_long ordernum;
 100         char *owner;
 101 };
 102
 103 struct ypreq_key {
 104         char *domain;
 105         char *map;
 106         datum keydat;
 107 };
 108
 109 struct ypreq_nokey {
 110         char *domain;
 111         char *map;
 112 };
 113
 114 struct ypreq_xfr {
 115         struct ypmap_parms map_parms;
 116         u_long transid;
 117         u_long proto;
 118         u_short port;
 119 };
 120 #define ypxfr_domain    map_parms.domain
 121 #define ypxfr_map       map_parms.map
 122 #define ypxfr_ordernum  map_parms.ordernum
 123 #define ypxfr_owner     map_parms.owner
 124
 125 struct ypresp_val {
 126         u_long status;
 127         datum valdat;
 128 };
 129
 130 struct ypresp_key_val {
 131         u_long status;
 132         datum keydat;
 133         datum valdat;
 134 };
 135
 136 struct ypresp_master {
 137         u_long status;
 138         char *master;
 139 };
 140
 141 struct ypresp_order {
 142         u_long status;
 143         u_long ordernum;
 144 };
 145
 146 struct ypmaplist {
 147         char ypml_name[YPMAXMAP + 1];
 148         struct ypmaplist *ypml_next;
 149 };
 150
 151 struct ypresp_maplist {
 152         u_long status;
 153         struct ypmaplist *list;
 154 };
 155
 156 /* ypserv procedure numbers */
 157 #define YPPROC_NULL             ((u_long)0)
 158 #define YPPROC_DOMAIN           ((u_long)1)
 159 #define YPPROC_DOMAIN_NONACK    ((u_long)2)
 160 #define YPPROC_MATCH            ((u_long)3)
 161 #define YPPROC_FIRST            ((u_long)4)
 162 #define YPPROC_NEXT             ((u_long)5)
 163 #define YPPROC_XFR              ((u_long)6)
 164 #define YPPROC_CLEAR            ((u_long)7)
 165 #define YPPROC_ALL              ((u_long)8)
 166 #define YPPROC_MASTER           ((u_long)9)
 167 #define YPPROC_ORDER            ((u_long)10)
 168 #define YPPROC_MAPLIST          ((u_long)11)
 169
 170 /* ypserv procedure return status values */
 171 #define YP_TRUE         ((long)1)       /* general purpose success code */
 172 #define YP_NOMORE       ((long)2)       /* no more entries in map */
 173 #define YP_FALSE        ((long)0)       /* general purpose failure code */
 174 #define YP_NOMAP        ((long)-1)      /* no such map in domain */
 175 #define YP_NODOM        ((long)-2)      /* domain not supported */
 176 #define YP_NOKEY        ((long)-3)      /* no such key in map */
 177 #define YP_BADOP        ((long)-4)      /* invalid operation */
 178 #define YP_BADDB        ((long)-5)      /* server data base is bad */
 179 #define YP_YPERR        ((long)-6)      /* YP server error */
 180 #define YP_BADARGS      ((long)-7)      /* request arguments bad */
 181 #define YP_VERS         ((long)-8)      /* YP server version mismatch */
 182
 183 /*
 184  * Sun's header file says:
 185  * "Domain binding data structure, used by ypclnt package and ypserv modules.
 186  * Users of the ypclnt package (or of this protocol) don't HAVE to know about
 187  * it, but it must be available to users because _yp_dobind is a public
 188  * interface."
 189  *
 190  * This is totally bogus! Nowhere else does Sun state that _yp_dobind() is
 191  * a public interface, and I don't know any reason anyone would want to call
 192  * it. But, just in case anyone does actually expect it to be available..
 193  * we provide this.. exactly as Sun wants it.
 194  */
 195 struct dom_binding {
 196         struct dom_binding *dom_pnext;
 197         char dom_domain[YPMAXDOMAIN + 1];
 198         struct sockaddr_in dom_server_addr;
 199         u_short dom_server_port;
 200         int dom_socket;
 201         CLIENT *dom_client;
 202         u_short dom_local_port;
 203         long dom_vers;
 204 };
 205
 206 /*
 207  * YPBIND PROTOCOL:
 208  *
 209  * ypbind supports the following procedures:
 210  *
 211  * YPBINDPROC_NULL      takes (void), returns (void).
 212  *                      to check if ypbind is running.
 213  * YPBINDPROC_DOMAIN    takes (char *), returns (struct ypbind_resp).
 214  *                      requests that ypbind start to serve the
 215  *                      named domain (if it doesn't already)
 216  * YPBINDPROC_SETDOM    takes (struct ypbind_setdom), returns (void).
 217  *                      used by ypset.
 218  */
 219
 220 #define YPBINDPROG              ((u_long)100007)
 221 #define YPBINDVERS              ((u_long)2)
 222 #define YPBINDVERS_ORIG         ((u_long)1)
 223
 224 /* ypbind procedure numbers */
 225 #define YPBINDPROC_NULL         ((u_long)0)
 226 #define YPBINDPROC_DOMAIN       ((u_long)1)
 227 #define YPBINDPROC_SETDOM       ((u_long)2)
 228
 229 /* error code in ypbind_resp.ypbind_status */
 230 enum ypbind_resptype {
 231         YPBIND_SUCC_VAL = 1,
 232         YPBIND_FAIL_VAL = 2
 233 };
 234
 235 /* network order, of course */
 236 struct ypbind_binding {
 237         struct in_addr  ypbind_binding_addr;
 238         u_short         ypbind_binding_port;
 239 };
 240
 241 struct ypbind_resp {
 242         enum ypbind_resptype    ypbind_status;
 243         union {
 244                 u_long                  ypbind_error;
 245                 struct ypbind_binding   ypbind_bindinfo;
 246         } ypbind_respbody;
 247 };
 248
 249 /* error code in ypbind_resp.ypbind_respbody.ypbind_error */
 250 #define YPBIND_ERR_ERR          1       /* internal error */
 251 #define YPBIND_ERR_NOSERV       2       /* no bound server for passed domain */
 252 #define YPBIND_ERR_RESC         3       /* system resource allocation failure */
 253
 254 /*
 255  * Request data structure for ypbind "Set domain" procedure.
 256  */
 257 struct ypbind_setdom {
 258         char ypsetdom_domain[YPMAXDOMAIN + 1];
 259         struct ypbind_binding ypsetdom_binding;
 260         u_short ypsetdom_vers;
 261 };
 262 #define ypsetdom_addr ypsetdom_binding.ypbind_binding_addr
 263 #define ypsetdom_port ypsetdom_binding.ypbind_binding_port
 264
 265 /*
 266  * YPPUSH PROTOCOL:
 267  *
 268  * Sun says:
 269  * "Protocol between clients (ypxfr, only) and yppush
 270  *  yppush speaks a protocol in the transient range, which
 271  *  is supplied to ypxfr as a command-line parameter when it
 272  *  is activated by ypserv."
 273  *
 274  * This protocol is not implemented, naturally, because this YP
 275  * implementation only does the client side.
 276  */
 277 #define YPPUSHVERS              ((u_long)1)
 278 #define YPPUSHVERS_ORIG         ((u_long)1)
 279
 280 /* yppush procedure numbers */
 281 #define YPPUSHPROC_NULL         ((u_long)0)
 282 #define YPPUSHPROC_XFRRESP      ((u_long)1)
 283
 284 struct yppushresp_xfr {
 285         u_long  transid;
 286         u_long  status;
 287 };
 288
 289 /* yppush status value in yppushresp_xfr.status */
 290 #define YPPUSH_SUCC     ((long)1)       /* Success */
 291 #define YPPUSH_AGE      ((long)2)       /* Master's version not newer */
 292 #define YPPUSH_NOMAP    ((long)-1)      /* Can't find server for map */
 293 #define YPPUSH_NODOM    ((long)-2)      /* Domain not supported */
 294 #define YPPUSH_RSRC     ((long)-3)      /* Local resource alloc failure */
 295 #define YPPUSH_RPC      ((long)-4)      /* RPC failure talking to server */
 296 #define YPPUSH_MADDR    ((long)-5)      /* Can't get master address */
 297 #define YPPUSH_YPERR    ((long)-6)      /* YP server/map db error */
 298 #define YPPUSH_BADARGS  ((long)-7)      /* Request arguments bad */
 299 #define YPPUSH_DBM      ((long)-8)      /* Local dbm operation failed */
 300 #define YPPUSH_FILE     ((long)-9)      /* Local file I/O operation failed */
 301 #define YPPUSH_SKEW     ((long)-10)     /* Map version skew during transfer */
 302 #define YPPUSH_CLEAR    ((long)-11)     /* Can't send "Clear" req to local ypserv */
 303 #define YPPUSH_FORCE    ((long)-12)     /* No local order number in map - use -f */
 304 #define YPPUSH_XFRERR   ((long)-13)     /* ypxfr error */
 305 #define YPPUSH_REFUSED  ((long)-14)     /* Transfer request refused by ypserv */
 306
 307 struct inaddr;
 308 __BEGIN_DECLS
 309 bool_t  xdr_datum(XDR *, datum *);
 310 bool_t  xdr_ypreq_key(XDR *, struct ypreq_key *);
 311 bool_t  xdr_ypreq_nokey(XDR *, struct ypreq_nokey *);
 312 bool_t  xdr_ypreq_xfr(XDR *, struct ypreq_xfr *);
 313 bool_t  xdr_ypresp_val(XDR *, struct ypresp_val *);
 314 bool_t  xdr_ypresp_key_val(XDR *, struct ypresp_key_val *);
 315 bool_t  xdr_ypbind_resp(XDR *, struct ypbind_resp *);
 316 bool_t  xdr_ypbind_setdom(XDR *, struct ypbind_setdom *);
 317 bool_t  xdr_yp_inaddr(XDR *, struct inaddr *);
 318 bool_t  xdr_ypmap_parms(XDR *, struct ypmap_parms *);
 319 bool_t  xdr_yppushresp_xfr(XDR *, struct yppushresp_xfr *);
 320 bool_t  xdr_ypresp_order(XDR *, struct ypresp_order *);
 321 bool_t  xdr_ypresp_master(XDR *, struct ypresp_master *);
 322 bool_t  xdr_ypresp_maplist(XDR *, struct ypresp_maplist *);
 323 __END_DECLS
 324
 325 #endif /* _RPCSVC_YP_PROT_H_ */