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