2 * nfsrpc.h -- RPC client APIs provided by support/nfs
4 * Copyright (C) 2008 Oracle Corporation. All rights reserved.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public
17 * License along with this program; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 021110-1307, USA.
23 #ifndef __NFS_UTILS_NFSRPC_H
24 #define __NFS_UTILS_NFSRPC_H
26 #include <rpc/types.h>
30 * Conventional RPC program numbers
33 #define RPCBPROG ((rpcprog_t)100000)
36 #define PMAPPROG ((rpcprog_t)100000)
40 #define NFSPROG ((rpcprog_t)100003)
43 #define MOUNTPROG ((rpcprog_t)100005)
46 #define NLMPROG ((rpcprog_t)100021)
49 #define NSMPROG ((rpcprog_t)100024)
53 * Look up an RPC program name in /etc/rpc
55 extern rpcprog_t nfs_getrpcbyname(const rpcprog_t, const char *table[]);
58 * Acquire an RPC CLIENT * with an ephemeral source port
60 extern CLIENT *nfs_get_rpcclient(const struct sockaddr *,
61 const socklen_t, const unsigned short,
62 const rpcprog_t, const rpcvers_t,
66 * Acquire an RPC CLIENT * with a privileged source port
68 extern CLIENT *nfs_get_priv_rpcclient( const struct sockaddr *,
69 const socklen_t, const unsigned short,
70 const rpcprog_t, const rpcvers_t,
74 * Convert a socket address to a universal address
76 extern char *nfs_sockaddr2universal(const struct sockaddr *);
79 * Extract port number from a universal address
81 extern int nfs_universal2port(const char *);
84 * Generic function that maps an RPC service tuple to an IP port
85 * number of the service on a remote post, and sends a NULL
86 * request to determine if the service is responding to requests
88 extern int nfs_getport_ping(struct sockaddr *sap,
89 const socklen_t salen,
90 const rpcprog_t program,
91 const rpcvers_t version,
92 const unsigned short protocol);
95 * Generic function that maps an RPC service tuple to an IP port
96 * number of the service on a remote host
98 extern unsigned short nfs_getport(const struct sockaddr *,
99 const socklen_t, const rpcprog_t,
100 const rpcvers_t, const unsigned short);
103 * Generic function that maps an RPC service tuple to an IP port
104 * number of the service on the local host
106 extern unsigned short nfs_getlocalport(const rpcprot_t,
107 const rpcvers_t, const unsigned short);
110 * Function to invoke an rpcbind v3/v4 GETADDR request
112 extern unsigned short nfs_rpcb_getaddr(const struct sockaddr *,
114 const unsigned short,
115 const struct sockaddr *,
118 const unsigned short,
119 const struct timeval *);
122 * Function to invoke a portmap GETPORT request
124 extern unsigned long nfs_pmap_getport(const struct sockaddr_in *,
125 const unsigned short,
129 const struct timeval *);
132 * Contact a remote RPC service to discover whether it is responding
135 extern int nfs_rpc_ping(const struct sockaddr *sap,
136 const socklen_t salen,
137 const rpcprog_t program,
138 const rpcvers_t version,
139 const unsigned short protocol,
140 const struct timeval *timeout);
142 #endif /* __NFS_UTILS_NFSRPC_H */