2 * In-kernel rpcbind client supporting versions 2, 3, and 4 of the rpcbind
5 * Based on RFC 1833: "Binding Protocols for ONC RPC Version 2" and
6 * RFC 3530: "Network File System (NFS) version 4 Protocol"
8 * Original: Gilles Quillard, Bull Open Source, 2005 <gilles.quillard@bull.net>
9 * Updated: Chuck Lever, Oracle Corporation, 2007 <chuck.lever@oracle.com>
11 * Descended from net/sunrpc/pmap_clnt.c,
12 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
15 #include <linux/module.h>
17 #include <linux/types.h>
18 #include <linux/socket.h>
20 #include <linux/in6.h>
21 #include <linux/kernel.h>
22 #include <linux/errno.h>
24 #include <linux/sunrpc/clnt.h>
25 #include <linux/sunrpc/sched.h>
26 #include <linux/sunrpc/xprtsock.h>
29 # define RPCDBG_FACILITY RPCDBG_BIND
32 #define RPCBIND_PROGRAM (100000u)
33 #define RPCBIND_PORT (111u)
40 RPCBPROC_GETADDR = 3, /* alias for GETPORT */
43 RPCBPROC_BCAST = 5, /* alias for CALLIT */
53 #define RPCB_HIGHPROC_2 RPCBPROC_CALLIT
54 #define RPCB_HIGHPROC_3 RPCBPROC_TADDR2UADDR
55 #define RPCB_HIGHPROC_4 RPCBPROC_GETSTAT
60 * Quoting RFC 3530, section 2.2:
62 * For TCP over IPv4 and for UDP over IPv4, the format of r_addr is the
67 * The prefix, "h1.h2.h3.h4", is the standard textual form for
68 * representing an IPv4 address, which is always four octets long.
69 * Assuming big-endian ordering, h1, h2, h3, and h4, are respectively,
70 * the first through fourth octets each converted to ASCII-decimal.
71 * Assuming big-endian ordering, p1 and p2 are, respectively, the first
72 * and second octets each converted to ASCII-decimal. For example, if a
73 * host, in big-endian order, has an address of 0x0A010307 and there is
74 * a service listening on, in big endian order, port 0x020F (decimal
75 * 527), then the complete universal address is "10.1.3.7.2.15".
79 * For TCP over IPv6 and for UDP over IPv6, the format of r_addr is the
82 * x1:x2:x3:x4:x5:x6:x7:x8.p1.p2
84 * The suffix "p1.p2" is the service port, and is computed the same way
85 * as with universal addresses for TCP and UDP over IPv4. The prefix,
86 * "x1:x2:x3:x4:x5:x6:x7:x8", is the standard textual form for
87 * representing an IPv6 address as defined in Section 2.2 of [RFC2373].
88 * Additionally, the two alternative forms specified in Section 2.2 of
89 * [RFC2373] are also acceptable.
91 * XXX: Currently this implementation does not explicitly convert the
92 * stored address to US-ASCII on non-ASCII systems.
94 #define RPCB_MAXADDRLEN (128u)
99 * The "owner" is allowed to unset a service in the rpcbind database.
100 * We always use the following (arbitrary) fixed string.
102 #define RPCB_OWNER_STRING "rpcb"
103 #define RPCB_MAXOWNERLEN sizeof(RPCB_OWNER_STRING)
105 static void rpcb_getport_done(struct rpc_task *, void *);
106 extern struct rpc_program rpcb_program;
108 struct rpcbind_args {
109 struct rpc_xprt * r_xprt;
114 unsigned short r_port;
116 char r_addr[RPCB_MAXADDRLEN];
120 static struct rpc_procinfo rpcb_procedures2[];
121 static struct rpc_procinfo rpcb_procedures3[];
125 struct rpc_procinfo * rpc_proc;
128 static struct rpcb_info rpcb_next_version[];
129 static struct rpcb_info rpcb_next_version6[];
131 static void rpcb_getport_prepare(struct rpc_task *task, void *calldata)
133 struct rpcbind_args *map = calldata;
134 struct rpc_xprt *xprt = map->r_xprt;
135 struct rpc_message msg = {
136 .rpc_proc = rpcb_next_version[xprt->bind_index].rpc_proc,
138 .rpc_resp = &map->r_port,
141 rpc_call_setup(task, &msg, 0);
144 static void rpcb_map_release(void *data)
146 struct rpcbind_args *map = data;
148 xprt_put(map->r_xprt);
152 static const struct rpc_call_ops rpcb_getport_ops = {
153 .rpc_call_prepare = rpcb_getport_prepare,
154 .rpc_call_done = rpcb_getport_done,
155 .rpc_release = rpcb_map_release,
158 static void rpcb_wake_rpcbind_waiters(struct rpc_xprt *xprt, int status)
160 xprt_clear_binding(xprt);
161 rpc_wake_up_status(&xprt->binding, status);
164 static struct rpc_clnt *rpcb_create(char *hostname, struct sockaddr *srvaddr,
165 int proto, int version, int privileged)
167 struct rpc_create_args args = {
170 .addrsize = sizeof(struct sockaddr_in),
171 .servername = hostname,
172 .program = &rpcb_program,
174 .authflavor = RPC_AUTH_UNIX,
175 .flags = (RPC_CLNT_CREATE_NOPING |
176 RPC_CLNT_CREATE_INTR),
179 switch (srvaddr->sa_family) {
181 ((struct sockaddr_in *)srvaddr)->sin_port = htons(RPCBIND_PORT);
184 ((struct sockaddr_in6 *)srvaddr)->sin6_port = htons(RPCBIND_PORT);
191 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
192 return rpc_create(&args);
196 * rpcb_register - set or unset a port registration with the local rpcbind svc
197 * @prog: RPC program number to bind
198 * @vers: RPC version number to bind
199 * @prot: transport protocol to use to make this request
200 * @port: port value to register
203 * port == 0 means unregister, port != 0 means register.
205 * This routine supports only rpcbind version 2.
207 int rpcb_register(u32 prog, u32 vers, int prot, unsigned short port, int *okay)
209 struct sockaddr_in sin = {
210 .sin_family = AF_INET,
211 .sin_addr.s_addr = htonl(INADDR_LOOPBACK),
213 struct rpcbind_args map = {
219 struct rpc_message msg = {
220 .rpc_proc = &rpcb_procedures2[port ?
221 RPCBPROC_SET : RPCBPROC_UNSET],
225 struct rpc_clnt *rpcb_clnt;
228 dprintk("RPC: %sregistering (%u, %u, %d, %u) with local "
229 "rpcbind\n", (port ? "" : "un"),
230 prog, vers, prot, port);
232 rpcb_clnt = rpcb_create("localhost", (struct sockaddr *) &sin,
233 XPRT_TRANSPORT_UDP, 2, 1);
234 if (IS_ERR(rpcb_clnt))
235 return PTR_ERR(rpcb_clnt);
237 error = rpc_call_sync(rpcb_clnt, &msg, 0);
239 rpc_shutdown_client(rpcb_clnt);
241 printk(KERN_WARNING "RPC: failed to contact local rpcbind "
242 "server (errno %d).\n", -error);
243 dprintk("RPC: registration status %d/%d\n", error, *okay);
249 * rpcb_getport_sync - obtain the port for an RPC service on a given host
250 * @sin: address of remote peer
251 * @prog: RPC program number to bind
252 * @vers: RPC version number to bind
253 * @prot: transport protocol to use to make this request
255 * Called from outside the RPC client in a synchronous task context.
256 * Uses default timeout parameters specified by underlying transport.
258 * XXX: Needs to support IPv6, and rpcbind versions 3 and 4
260 int rpcb_getport_sync(struct sockaddr_in *sin, __u32 prog,
261 __u32 vers, int prot)
263 struct rpcbind_args map = {
269 struct rpc_message msg = {
270 .rpc_proc = &rpcb_procedures2[RPCBPROC_GETPORT],
272 .rpc_resp = &map.r_port,
274 struct rpc_clnt *rpcb_clnt;
278 dprintk("RPC: %s(" NIPQUAD_FMT ", %u, %u, %d)\n",
279 __FUNCTION__, NIPQUAD(sin->sin_addr.s_addr), prog, vers, prot);
281 sprintf(hostname, NIPQUAD_FMT, NIPQUAD(sin->sin_addr.s_addr));
282 rpcb_clnt = rpcb_create(hostname, (struct sockaddr *)sin, prot, 2, 0);
283 if (IS_ERR(rpcb_clnt))
284 return PTR_ERR(rpcb_clnt);
286 status = rpc_call_sync(rpcb_clnt, &msg, 0);
287 rpc_shutdown_client(rpcb_clnt);
296 EXPORT_SYMBOL_GPL(rpcb_getport_sync);
299 * rpcb_getport_async - obtain the port for a given RPC service on a given host
300 * @task: task that is waiting for portmapper request
302 * This one can be called for an ongoing RPC request, and can be used in
303 * an async (rpciod) context.
305 void rpcb_getport_async(struct rpc_task *task)
307 struct rpc_clnt *clnt = task->tk_client;
309 struct rpc_xprt *xprt = task->tk_xprt;
310 struct rpc_clnt *rpcb_clnt;
311 static struct rpcbind_args *map;
312 struct rpc_task *child;
313 struct sockaddr addr;
315 struct rpcb_info *info;
317 dprintk("RPC: %5u %s(%s, %u, %u, %d)\n",
318 task->tk_pid, __FUNCTION__,
319 clnt->cl_server, clnt->cl_prog, clnt->cl_vers, xprt->prot);
321 /* Autobind on cloned rpc clients is discouraged */
322 BUG_ON(clnt->cl_parent != clnt);
324 if (xprt_test_and_set_binding(xprt)) {
325 status = -EAGAIN; /* tell caller to check again */
326 dprintk("RPC: %5u %s: waiting for another binder\n",
327 task->tk_pid, __FUNCTION__);
331 /* Put self on queue before sending rpcbind request, in case
332 * rpcb_getport_done completes before we return from rpc_run_task */
333 rpc_sleep_on(&xprt->binding, task, NULL, NULL);
335 /* Someone else may have bound if we slept */
336 if (xprt_bound(xprt)) {
338 dprintk("RPC: %5u %s: already bound\n",
339 task->tk_pid, __FUNCTION__);
343 rpc_peeraddr(clnt, (void *)&addr, sizeof(addr));
345 /* Don't ever use rpcbind v2 for AF_INET6 requests */
346 switch (addr.sa_family) {
348 info = rpcb_next_version;
351 info = rpcb_next_version6;
354 status = -EAFNOSUPPORT;
355 dprintk("RPC: %5u %s: bad address family\n",
356 task->tk_pid, __FUNCTION__);
359 if (info[xprt->bind_index].rpc_proc == NULL) {
360 xprt->bind_index = 0;
361 status = -EPFNOSUPPORT;
362 dprintk("RPC: %5u %s: no more getport versions available\n",
363 task->tk_pid, __FUNCTION__);
366 bind_version = info[xprt->bind_index].rpc_vers;
368 dprintk("RPC: %5u %s: trying rpcbind version %u\n",
369 task->tk_pid, __FUNCTION__, bind_version);
371 rpcb_clnt = rpcb_create(clnt->cl_server, &addr, xprt->prot,
373 if (IS_ERR(rpcb_clnt)) {
374 status = PTR_ERR(rpcb_clnt);
375 dprintk("RPC: %5u %s: rpcb_create failed, error %ld\n",
376 task->tk_pid, __FUNCTION__, PTR_ERR(rpcb_clnt));
380 map = kzalloc(sizeof(struct rpcbind_args), GFP_ATOMIC);
383 dprintk("RPC: %5u %s: no memory available\n",
384 task->tk_pid, __FUNCTION__);
387 map->r_prog = clnt->cl_prog;
388 map->r_vers = clnt->cl_vers;
389 map->r_prot = xprt->prot;
391 map->r_xprt = xprt_get(xprt);
392 map->r_netid = rpc_peeraddr2str(clnt, RPC_DISPLAY_NETID);
394 rpc_peeraddr2str(rpcb_clnt, RPC_DISPLAY_UNIVERSAL_ADDR),
395 sizeof(map->r_addr));
396 map->r_owner = RPCB_OWNER_STRING; /* ignored for GETADDR */
398 child = rpc_run_task(rpcb_clnt, RPC_TASK_ASYNC, &rpcb_getport_ops, map);
399 rpc_release_client(rpcb_clnt);
402 dprintk("RPC: %5u %s: rpc_run_task failed\n",
403 task->tk_pid, __FUNCTION__);
408 task->tk_xprt->stat.bind_count++;
415 rpcb_wake_rpcbind_waiters(xprt, status);
417 task->tk_status = status;
419 EXPORT_SYMBOL_GPL(rpcb_getport_async);
422 * Rpcbind child task calls this callback via tk_exit.
424 static void rpcb_getport_done(struct rpc_task *child, void *data)
426 struct rpcbind_args *map = data;
427 struct rpc_xprt *xprt = map->r_xprt;
428 int status = child->tk_status;
430 /* Garbage reply: retry with a lesser rpcbind version */
432 status = -EPROTONOSUPPORT;
434 /* rpcbind server doesn't support this rpcbind protocol version */
435 if (status == -EPROTONOSUPPORT)
439 /* rpcbind server not available on remote host? */
440 xprt->ops->set_port(xprt, 0);
441 } else if (map->r_port == 0) {
442 /* Requested RPC service wasn't registered on remote host */
443 xprt->ops->set_port(xprt, 0);
447 xprt->ops->set_port(xprt, map->r_port);
448 xprt_set_bound(xprt);
452 dprintk("RPC: %5u rpcb_getport_done(status %d, port %u)\n",
453 child->tk_pid, status, map->r_port);
455 rpcb_wake_rpcbind_waiters(xprt, status);
458 static int rpcb_encode_mapping(struct rpc_rqst *req, __be32 *p,
459 struct rpcbind_args *rpcb)
461 dprintk("RPC: rpcb_encode_mapping(%u, %u, %d, %u)\n",
462 rpcb->r_prog, rpcb->r_vers, rpcb->r_prot, rpcb->r_port);
463 *p++ = htonl(rpcb->r_prog);
464 *p++ = htonl(rpcb->r_vers);
465 *p++ = htonl(rpcb->r_prot);
466 *p++ = htonl(rpcb->r_port);
468 req->rq_slen = xdr_adjust_iovec(req->rq_svec, p);
472 static int rpcb_decode_getport(struct rpc_rqst *req, __be32 *p,
473 unsigned short *portp)
475 *portp = (unsigned short) ntohl(*p++);
476 dprintk("RPC: rpcb_decode_getport result %u\n",
481 static int rpcb_decode_set(struct rpc_rqst *req, __be32 *p,
484 *boolp = (unsigned int) ntohl(*p++);
485 dprintk("RPC: rpcb_decode_set result %u\n",
490 static int rpcb_encode_getaddr(struct rpc_rqst *req, __be32 *p,
491 struct rpcbind_args *rpcb)
493 dprintk("RPC: rpcb_encode_getaddr(%u, %u, %s)\n",
494 rpcb->r_prog, rpcb->r_vers, rpcb->r_addr);
495 *p++ = htonl(rpcb->r_prog);
496 *p++ = htonl(rpcb->r_vers);
498 p = xdr_encode_string(p, rpcb->r_netid);
499 p = xdr_encode_string(p, rpcb->r_addr);
500 p = xdr_encode_string(p, rpcb->r_owner);
502 req->rq_slen = xdr_adjust_iovec(req->rq_svec, p);
507 static int rpcb_decode_getaddr(struct rpc_rqst *req, __be32 *p,
508 unsigned short *portp)
512 int c, i, f, first, val;
515 addr_len = ntohl(*p++);
518 * Simple sanity check. The smallest possible universal
519 * address is an IPv4 address string containing 11 bytes.
521 if (addr_len < 11 || addr_len > RPCB_MAXADDRLEN)
525 * Start at the end and walk backwards until the first dot
526 * is encountered. When the second dot is found, we have
527 * both parts of the port number.
533 for (i = addr_len - 1; i > 0; i--) {
535 if (c >= '0' && c <= '9') {
536 val += (c - '0') * f;
538 } else if (c == '.') {
544 *portp |= (val << 8);
551 * Simple sanity check. If we never saw a dot in the reply,
552 * then this was probably just garbage.
557 dprintk("RPC: rpcb_decode_getaddr port=%u\n", *portp);
561 dprintk("RPC: rpcbind server returned malformed reply\n");
565 #define RPCB_program_sz (1u)
566 #define RPCB_version_sz (1u)
567 #define RPCB_protocol_sz (1u)
568 #define RPCB_port_sz (1u)
569 #define RPCB_boolean_sz (1u)
571 #define RPCB_netid_sz (1+XDR_QUADLEN(RPCBIND_MAXNETIDLEN))
572 #define RPCB_addr_sz (1+XDR_QUADLEN(RPCB_MAXADDRLEN))
573 #define RPCB_ownerstring_sz (1+XDR_QUADLEN(RPCB_MAXOWNERLEN))
575 #define RPCB_mappingargs_sz RPCB_program_sz+RPCB_version_sz+ \
576 RPCB_protocol_sz+RPCB_port_sz
577 #define RPCB_getaddrargs_sz RPCB_program_sz+RPCB_version_sz+ \
578 RPCB_netid_sz+RPCB_addr_sz+ \
581 #define RPCB_setres_sz RPCB_boolean_sz
582 #define RPCB_getportres_sz RPCB_port_sz
585 * Note that RFC 1833 does not put any size restrictions on the
586 * address string returned by the remote rpcbind database.
588 #define RPCB_getaddrres_sz RPCB_addr_sz
590 #define PROC(proc, argtype, restype) \
591 [RPCBPROC_##proc] = { \
592 .p_proc = RPCBPROC_##proc, \
593 .p_encode = (kxdrproc_t) rpcb_encode_##argtype, \
594 .p_decode = (kxdrproc_t) rpcb_decode_##restype, \
595 .p_arglen = RPCB_##argtype##args_sz, \
596 .p_replen = RPCB_##restype##res_sz, \
597 .p_statidx = RPCBPROC_##proc, \
603 * Not all rpcbind procedures described in RFC 1833 are implemented
604 * since the Linux kernel RPC code requires only these.
606 static struct rpc_procinfo rpcb_procedures2[] = {
607 PROC(SET, mapping, set),
608 PROC(UNSET, mapping, set),
609 PROC(GETADDR, mapping, getport),
612 static struct rpc_procinfo rpcb_procedures3[] = {
613 PROC(SET, mapping, set),
614 PROC(UNSET, mapping, set),
615 PROC(GETADDR, getaddr, getaddr),
618 static struct rpc_procinfo rpcb_procedures4[] = {
619 PROC(SET, mapping, set),
620 PROC(UNSET, mapping, set),
621 PROC(GETVERSADDR, getaddr, getaddr),
624 static struct rpcb_info rpcb_next_version[] = {
625 #ifdef CONFIG_SUNRPC_BIND34
626 { 4, &rpcb_procedures4[RPCBPROC_GETVERSADDR] },
627 { 3, &rpcb_procedures3[RPCBPROC_GETADDR] },
629 { 2, &rpcb_procedures2[RPCBPROC_GETPORT] },
633 static struct rpcb_info rpcb_next_version6[] = {
634 #ifdef CONFIG_SUNRPC_BIND34
635 { 4, &rpcb_procedures4[RPCBPROC_GETVERSADDR] },
636 { 3, &rpcb_procedures3[RPCBPROC_GETADDR] },
641 static struct rpc_version rpcb_version2 = {
643 .nrprocs = RPCB_HIGHPROC_2,
644 .procs = rpcb_procedures2
647 static struct rpc_version rpcb_version3 = {
649 .nrprocs = RPCB_HIGHPROC_3,
650 .procs = rpcb_procedures3
653 static struct rpc_version rpcb_version4 = {
655 .nrprocs = RPCB_HIGHPROC_4,
656 .procs = rpcb_procedures4
659 static struct rpc_version *rpcb_version[] = {
667 static struct rpc_stat rpcb_stats;
669 struct rpc_program rpcb_program = {
671 .number = RPCBIND_PROGRAM,
672 .nrvers = ARRAY_SIZE(rpcb_version),
673 .version = rpcb_version,
674 .stats = &rpcb_stats,