04228afa84
No, not really. There are just a couple of long-standing bogosities here that I feel compelled to fix. :) There are two small changes here: 1) yp.x actually contains _three_ protocol definitions: YPPROG (standard NIS client/server procedures), YPPUSH_XFRRESPPROG (callback handler for the YPPROC_XFR service, aka ypxfr/yppush) and YPBINDPROG (for ypbind, ypset & friends). The problem is that when you run yp.x through rpcgen(1), it generates client and server stubs with hooks for all three services. This makes it impossible to actually use the rpcgen-erated code in a program that only deals with _one_ of these services (ypserv, ypbind, etc...) without manually removing the unneeded stubs (either by hand editing or by committing unspeakable horrors with sed). This defeats the whole purpose of using rpcgen and is generally annoying. What I've done is to insert a few #ifndefs and #endifs to allow a programmer to selectively blot out those functions that aren't needed for a particular program. For instance, if you do 'rpcgen -DYPSERV_ONLY', you'll get only the necessary client/server stubs to implement the standard yp client and server functions. If you do 'rpcgen -DYPBIND_ONLY', you get only what you need for ypbind. If you don't #define anything, you get the whole mess, just like before, so existing programs won't notice the difference. (Note that the -D flag is not supported by our existing crufty version of rpcgen, but I intend to update it soon.) 2) The definition for the ypresp_key_val structure is actually incorrect with respect to reality: the key and val members are specified in the wrong order. It should be val/key rather than key/val. For whatever the reason, Sun's actual NIS implementation contradicts the protocol definition in this case. Again, accounting for this bogosity here is cleaner and easier than mangling the output from rpcgen.
302 lines
6.4 KiB
Plaintext
302 lines
6.4 KiB
Plaintext
/*
|
|
* Sun RPC is a product of Sun Microsystems, Inc. and is provided for
|
|
* unrestricted use provided that this legend is included on all tape
|
|
* media and as a part of the software program in whole or part. Users
|
|
* may copy or modify Sun RPC without charge, but are not authorized
|
|
* to license or distribute it to anyone else except as part of a product or
|
|
* program developed by the user.
|
|
*
|
|
* SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
|
|
* WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
|
|
*
|
|
* Sun RPC is provided with no support and without any obligation on the
|
|
* part of Sun Microsystems, Inc. to assist in its use, correction,
|
|
* modification or enhancement.
|
|
*
|
|
* SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
|
|
* INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
|
|
* OR ANY PART THEREOF.
|
|
*
|
|
* In no event will Sun Microsystems, Inc. be liable for any lost revenue
|
|
* or profits or other special, indirect and consequential damages, even if
|
|
* Sun has been advised of the possibility of such damages.
|
|
*
|
|
* Sun Microsystems, Inc.
|
|
* 2550 Garcia Avenue
|
|
* Mountain View, California 94043
|
|
*/
|
|
|
|
/*
|
|
* Protocol description file for the Yellow Pages Service
|
|
*/
|
|
|
|
#ifndef RPC_HDR
|
|
%#ifndef lint
|
|
%/*static char sccsid[] = "from: @(#)yp.x 2.1 88/08/01 4.0 RPCSRC";*/
|
|
%static char rcsid[] = "$Id$";
|
|
%#endif /* not lint */
|
|
#endif
|
|
|
|
const YPMAXRECORD = 1024;
|
|
const YPMAXDOMAIN = 64;
|
|
const YPMAXMAP = 64;
|
|
const YPMAXPEER = 64;
|
|
|
|
|
|
enum ypstat {
|
|
YP_TRUE = 1,
|
|
YP_NOMORE = 2,
|
|
YP_FALSE = 0,
|
|
YP_NOMAP = -1,
|
|
YP_NODOM = -2,
|
|
YP_NOKEY = -3,
|
|
YP_BADOP = -4,
|
|
YP_BADDB = -5,
|
|
YP_YPERR = -6,
|
|
YP_BADARGS = -7,
|
|
YP_VERS = -8
|
|
};
|
|
|
|
|
|
enum ypxfrstat {
|
|
YPXFR_SUCC = 1,
|
|
YPXFR_AGE = 2,
|
|
YPXFR_NOMAP = -1,
|
|
YPXFR_NODOM = -2,
|
|
YPXFR_RSRC = -3,
|
|
YPXFR_RPC = -4,
|
|
YPXFR_MADDR = -5,
|
|
YPXFR_YPERR = -6,
|
|
YPXFR_BADARGS = -7,
|
|
YPXFR_DBM = -8,
|
|
YPXFR_FILE = -9,
|
|
YPXFR_SKEW = -10,
|
|
YPXFR_CLEAR = -11,
|
|
YPXFR_FORCE = -12,
|
|
YPXFR_XFRERR = -13,
|
|
YPXFR_REFUSED = -14
|
|
};
|
|
|
|
|
|
typedef string domainname<YPMAXDOMAIN>;
|
|
typedef string mapname<YPMAXMAP>;
|
|
typedef string peername<YPMAXPEER>;
|
|
typedef opaque keydat<YPMAXRECORD>;
|
|
typedef opaque valdat<YPMAXRECORD>;
|
|
|
|
|
|
struct ypmap_parms {
|
|
domainname domain;
|
|
mapname map;
|
|
unsigned int ordernum;
|
|
peername peer;
|
|
};
|
|
|
|
struct ypreq_key {
|
|
domainname domain;
|
|
mapname map;
|
|
keydat key;
|
|
};
|
|
|
|
struct ypreq_nokey {
|
|
domainname domain;
|
|
mapname map;
|
|
};
|
|
|
|
struct ypreq_xfr {
|
|
ypmap_parms map_parms;
|
|
unsigned int transid;
|
|
unsigned int prog;
|
|
unsigned int port;
|
|
};
|
|
|
|
|
|
struct ypresp_val {
|
|
ypstat stat;
|
|
valdat val;
|
|
};
|
|
|
|
struct ypresp_key_val {
|
|
ypstat stat;
|
|
#ifdef STUPID_SUN_BUG /* These are backwards */
|
|
keydat key;
|
|
valdat val;
|
|
#else
|
|
valdat val;
|
|
keydat key;
|
|
#endif
|
|
};
|
|
|
|
|
|
struct ypresp_master {
|
|
ypstat stat;
|
|
peername peer;
|
|
};
|
|
|
|
struct ypresp_order {
|
|
ypstat stat;
|
|
unsigned int ordernum;
|
|
};
|
|
|
|
union ypresp_all switch (bool more) {
|
|
case TRUE:
|
|
ypresp_key_val val;
|
|
case FALSE:
|
|
void;
|
|
};
|
|
|
|
struct ypresp_xfr {
|
|
unsigned int transid;
|
|
ypxfrstat xfrstat;
|
|
};
|
|
|
|
struct ypmaplist {
|
|
mapname map;
|
|
ypmaplist *next;
|
|
};
|
|
|
|
struct ypresp_maplist {
|
|
ypstat stat;
|
|
ypmaplist *maps;
|
|
};
|
|
|
|
enum yppush_status {
|
|
YPPUSH_SUCC = 1, /* Success */
|
|
YPPUSH_AGE = 2, /* Master's version not newer */
|
|
YPPUSH_NOMAP = -1, /* Can't find server for map */
|
|
YPPUSH_NODOM = -2, /* Domain not supported */
|
|
YPPUSH_RSRC = -3, /* Local resource alloc failure */
|
|
YPPUSH_RPC = -4, /* RPC failure talking to server */
|
|
YPPUSH_MADDR = -5, /* Can't get master address */
|
|
YPPUSH_YPERR = -6, /* YP server/map db error */
|
|
YPPUSH_BADARGS = -7, /* Request arguments bad */
|
|
YPPUSH_DBM = -8, /* Local dbm operation failed */
|
|
YPPUSH_FILE = -9, /* Local file I/O operation failed */
|
|
YPPUSH_SKEW = -10, /* Map version skew during transfer */
|
|
YPPUSH_CLEAR = -11, /* Can't send "Clear" req to local ypserv */
|
|
YPPUSH_FORCE = -12, /* No local order number in map use -f flag. */
|
|
YPPUSH_XFRERR = -13, /* ypxfr error */
|
|
YPPUSH_REFUSED = -14 /* Transfer request refused by ypserv */
|
|
};
|
|
|
|
struct yppushresp_xfr {
|
|
unsigned transid;
|
|
yppush_status status;
|
|
};
|
|
|
|
/*
|
|
* Response structure and overall result status codes. Success and failure
|
|
* represent two separate response message types.
|
|
*/
|
|
|
|
enum ypbind_resptype {
|
|
YPBIND_SUCC_VAL = 1,
|
|
YPBIND_FAIL_VAL = 2
|
|
};
|
|
|
|
struct ypbind_binding {
|
|
opaque ypbind_binding_addr[4]; /* In network order */
|
|
opaque ypbind_binding_port[2]; /* In network order */
|
|
};
|
|
|
|
union ypbind_resp switch (ypbind_resptype ypbind_status) {
|
|
case YPBIND_FAIL_VAL:
|
|
unsigned ypbind_error;
|
|
case YPBIND_SUCC_VAL:
|
|
ypbind_binding ypbind_bindinfo;
|
|
};
|
|
|
|
/* Detailed failure reason codes for response field ypbind_error*/
|
|
|
|
const YPBIND_ERR_ERR = 1; /* Internal error */
|
|
const YPBIND_ERR_NOSERV = 2; /* No bound server for passed domain */
|
|
const YPBIND_ERR_RESC = 3; /* System resource allocation failure */
|
|
|
|
|
|
/*
|
|
* Request data structure for ypbind "Set domain" procedure.
|
|
*/
|
|
struct ypbind_setdom {
|
|
domainname ypsetdom_domain;
|
|
ypbind_binding ypsetdom_binding;
|
|
unsigned ypsetdom_vers;
|
|
};
|
|
|
|
#if !defined(YPBIND_ONLY) && !defined(YPPUSH_ONLY)
|
|
/*
|
|
* YP access protocol
|
|
*/
|
|
program YPPROG {
|
|
version YPVERS {
|
|
void
|
|
YPPROC_NULL(void) = 0;
|
|
|
|
bool
|
|
YPPROC_DOMAIN(domainname) = 1;
|
|
|
|
bool
|
|
YPPROC_DOMAIN_NONACK(domainname) = 2;
|
|
|
|
ypresp_val
|
|
YPPROC_MATCH(ypreq_key) = 3;
|
|
|
|
ypresp_key_val
|
|
YPPROC_FIRST(ypreq_key) = 4;
|
|
|
|
ypresp_key_val
|
|
YPPROC_NEXT(ypreq_key) = 5;
|
|
|
|
ypresp_xfr
|
|
YPPROC_XFR(ypreq_xfr) = 6;
|
|
|
|
void
|
|
YPPROC_CLEAR(void) = 7;
|
|
|
|
ypresp_all
|
|
YPPROC_ALL(ypreq_nokey) = 8;
|
|
|
|
ypresp_master
|
|
YPPROC_MASTER(ypreq_nokey) = 9;
|
|
|
|
ypresp_order
|
|
YPPROC_ORDER(ypreq_nokey) = 10;
|
|
|
|
ypresp_maplist
|
|
YPPROC_MAPLIST(domainname) = 11;
|
|
} = 2;
|
|
} = 100004;
|
|
#endif
|
|
#if !defined(YPSERV_ONLY) && !defined(YPBIND_ONLY)
|
|
/*
|
|
* YPPUSHPROC_XFRRESP is the callback routine for result of YPPROC_XFR
|
|
*/
|
|
program YPPUSH_XFRRESPPROG {
|
|
version YPPUSH_XFRRESPVERS {
|
|
void
|
|
YPPUSHPROC_NULL(void) = 0;
|
|
|
|
yppushresp_xfr
|
|
YPPUSHPROC_XFRRESP(void) = 1;
|
|
} = 1;
|
|
} = 0x40000000; /* transient: could be anything up to 0x5fffffff */
|
|
#endif
|
|
#if !defined(YPSERV_ONLY) && !defined(YPPUSH_ONLY)
|
|
/*
|
|
* YP binding protocol
|
|
*/
|
|
program YPBINDPROG {
|
|
version YPBINDVERS {
|
|
void
|
|
YPBINDPROC_NULL(void) = 0;
|
|
|
|
ypbind_resp
|
|
YPBINDPROC_DOMAIN(domainname) = 1;
|
|
|
|
void
|
|
YPBINDPROC_SETDOM(ypbind_setdom) = 2;
|
|
} = 2;
|
|
} = 100007;
|
|
|
|
#endif
|