include/rpcsvc/pmap_prot.x

   1 %/*
   2 % * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
   3 % * unrestricted use provided that this legend is included on all tape
   4 % * media and as a part of the software program in whole or part.  Users
   5 % * may copy or modify Sun RPC without charge, but are not authorized
   6 % * to license or distribute it to anyone else except as part of a product or
   7 % * program developed by the user.
   8 % *
   9 % * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  10 % * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  11 % * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  12 % *
  13 % * Sun RPC is provided with no support and without any obligation on the
  14 % * part of Sun Microsystems, Inc. to assist in its use, correction,
  15 % * modification or enhancement.
  16 % *
  17 % * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  18 % * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
  19 % * OR ANY PART THEREOF.
  20 % *
  21 % * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  22 % * or profits or other special, indirect and consequential damages, even if
  23 % * Sun has been advised of the possibility of such damages.
  24 % *
  25 % * Sun Microsystems, Inc.
  26 % * 2550 Garcia Avenue
  27 % * Mountain View, California  94043
  28 % *
  29 % * @(#)pmap_prot.x     1.6     94/04/29 SMI
  30 % * $DragonFly: src/include/rpcsvc/pmap_prot.x,v 1.2 2003/06/17 04:25:58 dillon Exp $
  31 % */
  32 %/*
  33 % * Copyright (c) 1984,1989 by Sun Microsystems, Inc.
  34 % */
  35
  36 %/* from pmap_prot.x */
  37
  38 #ifdef RPC_HDR
  39 %
  40 %#ifndef _KERNEL
  41 %
  42 #endif
  43
  44 /*
  45  * Port Mapper Protocol Specification (in RPC Language)
  46  * derived from RFC 1057
  47  */
  48
  49 %/*
  50 % * Protocol for the local binder service, or pmap.
  51 % *
  52 % * Copyright (C) 1984, Sun Microsystems, Inc.
  53 % *
  54 % * The following procedures are supported by the protocol:
  55 % *
  56 % * PMAPPROC_NULL() returns ()
  57 % *     takes nothing, returns nothing
  58 % *
  59 % * PMAPPROC_SET(struct pmap) returns (bool_t)
  60 % *     TRUE is success, FALSE is failure.  Registers the tuple
  61 % *     [prog, vers, prot, port].
  62 % *
  63 % * PMAPPROC_UNSET(struct pmap) returns (bool_t)
  64 % *     TRUE is success, FALSE is failure.  Un-registers pair
  65 % *     [prog, vers].  prot and port are ignored.
  66 % *
  67 % * PMAPPROC_GETPORT(struct pmap) returns (long unsigned).
  68 % *     0 is failure.  Otherwise returns the port number where the pair
  69 % *     [prog, vers] is registered.  It may lie!
  70 % *
  71 % * PMAPPROC_DUMP() RETURNS (struct pmaplist_ptr)
  72 % *
  73 % * PMAPPROC_CALLIT(unsigned, unsigned, unsigned, string<>)
  74 % *     RETURNS (port, string<>);
  75 % * usage: encapsulatedresults = PMAPPROC_CALLIT(prog, vers, proc,
  76 % *                                             encapsulatedargs);
  77 % *     Calls the procedure on the local machine.  If it is not registered,
  78 % *     this procedure is quite; ie it does not return error information!!!
  79 % *     This procedure only is supported on rpc/udp and calls via
  80 % *     rpc/udp.  This routine only passes null authentication parameters.
  81 % *     This file has no interface to xdr routines for PMAPPROC_CALLIT.
  82 % *
  83 % * The service supports remote procedure calls on udp/ip or tcp/ip socket 111.
  84 % */
  85 %
  86 const PMAPPORT = 111;   /* portmapper port number */
  87 %
  88 %
  89 %/*
  90 % * A mapping of (program, version, protocol) to port number
  91 % */
  92
  93 struct pmap {
  94         unsigned long pm_prog;
  95         unsigned long pm_vers;
  96         unsigned long pm_prot;
  97         unsigned long pm_port;
  98 };
  99 #ifdef RPC_HDR
 100 %
 101 %typedef pmap PMAP;
 102 %
 103 #endif
 104 %
 105 %/*
 106 % * Supported values for the "prot" field
 107 % */
 108 %
 109 const PMAP_IPPROTO_TCP = 6;     /* protocol number for TCP/IP */
 110 const PMAP_IPPROTO_UDP = 17;    /* protocol number for UDP/IP */
 111 %
 112 %
 113 %/*
 114 % * A list of mappings
 115 % *
 116 % * Below are two definitions for the pmaplist structure.  This is done because
 117 % * xdr_pmaplist() is specified to take a struct pmaplist **, rather than a
 118 % * struct pmaplist * that rpcgen would produce.  One version of the pmaplist
 119 % * structure (actually called pm__list) is used with rpcgen, and the other is
 120 % * defined only in the header file for compatibility with the specified
 121 % * interface.
 122 % */
 123
 124 struct pm__list {
 125         pmap pml_map;
 126         struct pm__list *pml_next;
 127 };
 128
 129 typedef pm__list *pmaplist_ptr;         /* results of PMAPPROC_DUMP */
 130
 131 #ifdef RPC_HDR
 132 %
 133 %typedef struct pm__list pmaplist;
 134 %typedef struct pm__list PMAPLIST;
 135 %
 136 %#ifndef __cplusplus
 137 %struct pmaplist {
 138 %       PMAP pml_map;
 139 %       struct pmaplist *pml_next;
 140 %};
 141 %#endif
 142 %
 143 %#ifdef __cplusplus
 144 %extern "C" {
 145 %#endif
 146 %#ifdef __STDC__
 147 %extern  bool_t xdr_pmaplist(XDR *, pmaplist**);
 148 %#else /* K&R C */
 149 %bool_t xdr_pmaplist();
 150 %#endif
 151 %#ifdef __cplusplus
 152 %}
 153 %#endif
 154 %
 155 #endif
 156
 157 %
 158 %/*
 159 % * Arguments to callit
 160 % */
 161
 162 struct rmtcallargs {
 163         unsigned long prog;
 164         unsigned long vers;
 165         unsigned long proc;
 166         opaque args<>;
 167 };
 168 #ifdef RPC_HDR
 169 %
 170 %/*
 171 % * Client-side only representation of rmtcallargs structure.
 172 % *
 173 % * The routine that XDRs the rmtcallargs structure must deal with the
 174 % * opaque arguments in the "args" structure.  xdr_rmtcall_args() needs to be
 175 % * passed the XDR routine that knows the args' structure.  This routine
 176 % * doesn't need to go over-the-wire (and it wouldn't make sense anyway) since
 177 % * the application being called knows the args structure already.  So we use a
 178 % * different "XDR" structure on the client side, p_rmtcallargs, which includes
 179 % * the args' XDR routine.
 180 % */
 181 %struct p_rmtcallargs {
 182 %       u_long prog;
 183 %       u_long vers;
 184 %       u_long proc;
 185 %       struct {
 186 %               u_int args_len;
 187 %               char *args_val;
 188 %       } args;
 189 %       xdrproc_t       xdr_args;       /* encodes args */
 190 %};
 191 %
 192 #endif  /* def RPC_HDR */
 193 %
 194 %
 195 %/*
 196 % * Results of callit
 197 % */
 198
 199 struct rmtcallres {
 200         unsigned long port;
 201         opaque res<>;
 202 };
 203 #ifdef RPC_HDR
 204 %
 205 %/*
 206 % * Client-side only representation of rmtcallres structure.
 207 % */
 208 %struct p_rmtcallres {
 209 %       u_long port;
 210 %       struct {
 211 %               u_int res_len;
 212 %               char *res_val;
 213 %       } res;
 214 %       xdrproc_t       xdr_res;        /* decodes res */
 215 %};
 216 %
 217 #endif  /* def RPC_HDR */
 218
 219 /*
 220  * Port mapper procedures
 221  */
 222
 223 program PMAPPROG {
 224    version PMAPVERS {
 225         void
 226         PMAPPROC_NULL(void)     = 0;
 227
 228         bool
 229         PMAPPROC_SET(pmap)      = 1;
 230
 231         bool
 232         PMAPPROC_UNSET(pmap)    = 2;
 233
 234         unsigned long
 235         PMAPPROC_GETPORT(pmap)  = 3;
 236
 237         pmaplist_ptr
 238         PMAPPROC_DUMP(void)     = 4;
 239
 240         rmtcallres
 241         PMAPPROC_CALLIT(rmtcallargs)  = 5;
 242    } = 2;
 243 } = 100000;
 244 %
 245 #ifdef RPC_HDR
 246 %#define PMAPVERS_PROTO         ((u_long)2)
 247 %#define PMAPVERS_ORIG          ((u_long)1)
 248 %
 249 %#else          /* ndef _KERNEL */
 250 %
 251 %#include <rpc/pmap_rmt.h>
 252 %
 253 %#ifdef __cplusplus
 254 %extern "C" {
 255 %#endif
 256 %
 257 %#define        PMAPPORT 111
 258 %
 259 %struct pmap {
 260 %       long unsigned pm_prog;
 261 %       long unsigned pm_vers;
 262 %       long unsigned pm_prot;
 263 %       long unsigned pm_port;
 264 %};
 265 %typedef struct pmap PMAP;
 266 %#ifdef __STDC__
 267 %extern bool_t xdr_pmap (XDR *, struct pmap *);
 268 %#else
 269 %extern bool_t xdr_pmap ();
 270 %#endif
 271 %
 272 %struct pmaplist {
 273 %       struct pmap pml_map;
 274 %       struct pmaplist *pml_next;
 275 %};
 276 %typedef struct pmaplist PMAPLIST;
 277 %typedef struct pmaplist *pmaplist_ptr;
 278 %
 279 %
 280 %#ifdef __cplusplus
 281 %}
 282 %#endif
 283 %
 284 %#endif         /* ndef _KERNEL */
 285 #endif
 286