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