pmap_clnt.h 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. /*
  2. * pmap_clnt.h
  3. * Supplies C routines to get to portmap services.
  4. *
  5. * Copyright (c) 2010, Oracle America, Inc.
  6. *
  7. * Redistribution and use in source and binary forms, with or without
  8. * modification, are permitted provided that the following conditions are
  9. * met:
  10. *
  11. * * Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * * Redistributions in binary form must reproduce the above
  14. * copyright notice, this list of conditions and the following
  15. * disclaimer in the documentation and/or other materials
  16. * provided with the distribution.
  17. * * Neither the name of the "Oracle America, Inc." nor the names of its
  18. * contributors may be used to endorse or promote products derived
  19. * from this software without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24. * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  25. * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  26. * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
  28. * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  29. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  30. * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  31. * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  32. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33. */
  34. #ifndef _RPC_PMAP_CLNT_H
  35. #define _RPC_PMAP_CLNT_H 1
  36. #include <features.h>
  37. #include <rpc/types.h>
  38. #include <rpc/xdr.h>
  39. #include <rpc/clnt.h>
  40. __BEGIN_DECLS
  41. typedef bool_t (*resultproc_t) (caddr_t __resp, struct sockaddr_in *__raddr);
  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. extern bool_t pmap_set (const u_long __program, const u_long __vers,
  64. int __protocol, u_short __port) __THROW;
  65. extern bool_t pmap_unset (const u_long __program, const u_long __vers)
  66. __THROW;
  67. extern struct pmaplist *pmap_getmaps (struct sockaddr_in *__address) __THROW;
  68. extern enum clnt_stat pmap_rmtcall (struct sockaddr_in *__addr,
  69. const u_long __prog,
  70. const u_long __vers,
  71. const u_long __proc,
  72. xdrproc_t __xdrargs,
  73. caddr_t __argsp, xdrproc_t __xdrres,
  74. caddr_t __resp, struct timeval __tout,
  75. u_long *__port_ptr) __THROW;
  76. extern enum clnt_stat clnt_broadcast (const u_long __prog,
  77. const u_long __vers,
  78. const u_long __proc, xdrproc_t __xargs,
  79. caddr_t __argsp, xdrproc_t __xresults,
  80. caddr_t __resultsp,
  81. resultproc_t __eachresult) __THROW;
  82. extern u_short pmap_getport (struct sockaddr_in *__address,
  83. const u_long __program,
  84. const u_long __version, u_int __protocol)
  85. __THROW;
  86. __END_DECLS
  87. #endif /* rpc/pmap_clnt.h */