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 __BEGIN_DECLS
  39
  40 typedef bool_t (*resultproc_t)();
  41
  42 /*
  43  * Usage:
  44  *      success = pmap_set(program, version, protocol, port);
  45  *      success = pmap_unset(program, version);
  46  *      port = pmap_getport(address, program, version, protocol);
  47  *      head = pmap_getmaps(address);
  48  *      clnt_stat = pmap_rmtcall(address, program, version, procedure,
  49  *              xdrargs, argsp, xdrres, resp, tout, port_ptr)
  50  *              (works for udp only.)
  51  *      clnt_stat = clnt_broadcast(program, version, procedure,
  52  *              xdrargs, argsp, xdrres, resp, eachresult)
  53  *              (like pmap_rmtcall, except the call is broadcasted to all
  54  *              locally connected nets.  For each valid response received,
  55  *              the procedure eachresult is called.  Its form is:
  56  *      done = eachresult(resp, raddr)
  57  *              bool_t done;
  58  *              caddr_t resp;
  59  *              struct sockaddr_in raddr;
  60  *              where resp points to the results of the call and raddr is the
  61  *              address if the responder to the broadcast.
  62  */
  63
  64 extern bool_t pmap_set __P ((u_long __program, u_long __version,
  65                              int __protocol, u_short __port));
  66
  67 extern bool_t pmap_unset __P ((u_long __program, u_long __version));
  68
  69 extern struct pmaplist *pmap_getmaps __P ((struct sockaddr_in *__address));
  70
  71 extern enum clnt_stat pmap_rmtcall __P ((struct sockaddr_in *__addr,
  72                                          u_long __prog, u_long __vers,
  73                                          u_long __proc, xdrproc_t __xdrargs,
  74                                          caddr_t __argsp, xdrproc_t __xdrres,
  75                                          caddr_t __resp, struct timeval __tout,
  76                                          u_long *__port_ptr));
  77
  78 extern enum clnt_stat clnt_broadcast __P ((u_long __prog, u_long __vers,
  79                                            u_long __proc, xdrproc_t __xargs,
  80                                            caddr_t __argsp,
  81                                            xdrproc_t __xresults,
  82                                            caddr_t __resultsp,
  83                                            resultproc_t __eachresult));
  84
  85 extern u_short pmap_getport __P ((struct sockaddr_in *__address,
  86                                   u_long __program, u_long __version,
  87                                   u_int __protocol));
  88
  89 __END_DECLS
  90
  91 #endif /* rpc/pmap_clnt.h */