sunrpc/rpc/pmap_clnt.h

   1 /* @(#)pmap_clnt.h      2.1 88/07/29 4.0 RPCSRC; from 1.11 88/02/08 SMI */
   2 /*
   3  * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
   4  * unrestricted use provided that this legend is included on all tape
   5  * media and as a part of the software program in whole or part.  Users
   6  * may copy or modify Sun RPC without charge, but are not authorized
   7  * to license or distribute it to anyone else except as part of a product or
   8  * program developed by the user.
   9  *
  10  * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  11  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  12  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  13  *
  14  * Sun RPC is provided with no support and without any obligation on the
  15  * part of Sun Microsystems, Inc. to assist in its use, correction,
  16  * modification or enhancement.
  17  *
  18  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  19  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
  20  * OR ANY PART THEREOF.
  21  *
  22  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  23  * or profits or other special, indirect and consequential damages, even if
  24  * Sun has been advised of the possibility of such damages.
  25  *
  26  * Sun Microsystems, Inc.
  27  * 2550 Garcia Avenue
  28  * Mountain View, California  94043
  29  */
  30
  31 /*
  32  * pmap_clnt.h
  33  * Supplies C routines to get to portmap services.
  34  *
  35  * Copyright (C) 1984, Sun Microsystems, Inc.
  36  */
  37
  38 #ifndef _RPC_PMAP_CLNT_H
  39 #define _RPC_PMAP_CLNT_H        1
  40 #include <features.h>
  41 #include <rpc/types.h>
  42 #include <rpc/xdr.h>
  43
  44 __BEGIN_DECLS
  45
  46 typedef bool_t (*resultproc_t) __P ((caddr_t resp, struct sockaddr_in *raddr));
  47
  48 /*
  49  * Usage:
  50  *      success = pmap_set(program, version, protocol, port);
  51  *      success = pmap_unset(program, version);
  52  *      port = pmap_getport(address, program, version, protocol);
  53  *      head = pmap_getmaps(address);
  54  *      clnt_stat = pmap_rmtcall(address, program, version, procedure,
  55  *              xdrargs, argsp, xdrres, resp, tout, port_ptr)
  56  *              (works for udp only.)
  57  *      clnt_stat = clnt_broadcast(program, version, procedure,
  58  *              xdrargs, argsp, xdrres, resp, eachresult)
  59  *              (like pmap_rmtcall, except the call is broadcasted to all
  60  *              locally connected nets.  For each valid response received,
  61  *              the procedure eachresult is called.  Its form is:
  62  *      done = eachresult(resp, raddr)
  63  *              bool_t done;
  64  *              caddr_t resp;
  65  *              struct sockaddr_in raddr;
  66  *              where resp points to the results of the call and raddr is the
  67  *              address if the responder to the broadcast.
  68  */
  69
  70 extern bool_t pmap_set __P ((__const u_long __program, __const u_long __vers,
  71                              int __protocol, u_short __port));
  72 extern bool_t pmap_unset __P ((__const u_long __program, __const u_long __vers));
  73 extern struct pmaplist *pmap_getmaps __P ((struct sockaddr_in *__address));
  74 extern enum clnt_stat pmap_rmtcall __P ((struct sockaddr_in *__addr,
  75                                          __const u_long __prog,
  76                                          __const u_long __vers,
  77                                          __const u_long __proc,
  78                                          xdrproc_t __xdrargs,
  79                                          caddr_t __argsp, xdrproc_t __xdrres,
  80                                          caddr_t __resp, struct timeval __tout,
  81                                          u_long *__port_ptr));
  82 extern enum clnt_stat clnt_broadcast __P ((__const u_long __prog,
  83                                            __const u_long __vers,
  84                                            __const u_long __proc,
  85                                            xdrproc_t __xargs,
  86                                            caddr_t __argsp,
  87                                            xdrproc_t __xresults,
  88                                            caddr_t __resultsp,
  89                                            resultproc_t __eachresult));
  90 extern u_short pmap_getport __P ((struct sockaddr_in *__address,
  91                                   __const u_long __program,
  92                                   __const u_long __version,
  93                                   u_int __protocol));
  94
  95 __END_DECLS
  96
  97 #endif /* rpc/pmap_clnt.h */