xref: /freebsd/sys/rpc/clnt_rc.c (revision 5861f9665471e98e544f6fa3ce73c4912229ff82)
1 /*-
2  * Copyright (c) 2008 Isilon Inc http://www.isilon.com/
3  * Authors: Doug Rabson <dfr@rabson.org>
4  * Developed with Red Inc: Alfred Perlstein <alfred@freebsd.org>
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 
28 #include <sys/cdefs.h>
29 __FBSDID("$FreeBSD$");
30 
31 #include <sys/param.h>
32 #include <sys/systm.h>
33 #include <sys/kernel.h>
34 #include <sys/limits.h>
35 #include <sys/lock.h>
36 #include <sys/malloc.h>
37 #include <sys/mbuf.h>
38 #include <sys/mutex.h>
39 #include <sys/pcpu.h>
40 #include <sys/proc.h>
41 #include <sys/socket.h>
42 #include <sys/socketvar.h>
43 #include <sys/time.h>
44 #include <sys/uio.h>
45 
46 #include <rpc/rpc.h>
47 #include <rpc/rpc_com.h>
48 
49 static enum clnt_stat clnt_reconnect_call(CLIENT *, struct rpc_callextra *,
50     rpcproc_t, struct mbuf *, struct mbuf **, struct timeval);
51 static void clnt_reconnect_geterr(CLIENT *, struct rpc_err *);
52 static bool_t clnt_reconnect_freeres(CLIENT *, xdrproc_t, void *);
53 static void clnt_reconnect_abort(CLIENT *);
54 static bool_t clnt_reconnect_control(CLIENT *, u_int, void *);
55 static void clnt_reconnect_close(CLIENT *);
56 static void clnt_reconnect_destroy(CLIENT *);
57 
58 static struct clnt_ops clnt_reconnect_ops = {
59 	.cl_call =	clnt_reconnect_call,
60 	.cl_abort =	clnt_reconnect_abort,
61 	.cl_geterr =	clnt_reconnect_geterr,
62 	.cl_freeres =	clnt_reconnect_freeres,
63 	.cl_close =	clnt_reconnect_close,
64 	.cl_destroy =	clnt_reconnect_destroy,
65 	.cl_control =	clnt_reconnect_control
66 };
67 
68 static int	fake_wchan;
69 
70 struct rc_data {
71 	struct mtx		rc_lock;
72 	struct sockaddr_storage	rc_addr; /* server address */
73 	struct netconfig*	rc_nconf; /* network type */
74 	rpcprog_t		rc_prog;  /* program number */
75 	rpcvers_t		rc_vers;  /* version number */
76 	size_t			rc_sendsz;
77 	size_t			rc_recvsz;
78 	struct timeval		rc_timeout;
79 	struct timeval		rc_retry;
80 	int			rc_retries;
81 	int			rc_privport;
82 	char			*rc_waitchan;
83 	int			rc_intr;
84 	int			rc_connecting;
85 	int			rc_closed;
86 	struct ucred		*rc_ucred;
87 	CLIENT*			rc_client; /* underlying RPC client */
88 	struct rpc_err		rc_err;
89 };
90 
91 CLIENT *
92 clnt_reconnect_create(
93 	struct netconfig *nconf,	/* network type */
94 	struct sockaddr *svcaddr,	/* servers address */
95 	rpcprog_t program,		/* program number */
96 	rpcvers_t version,		/* version number */
97 	size_t sendsz,			/* buffer recv size */
98 	size_t recvsz)			/* buffer send size */
99 {
100 	CLIENT *cl = NULL;		/* client handle */
101 	struct rc_data *rc = NULL;	/* private data */
102 
103 	if (svcaddr == NULL) {
104 		rpc_createerr.cf_stat = RPC_UNKNOWNADDR;
105 		return (NULL);
106 	}
107 
108 	cl = mem_alloc(sizeof (CLIENT));
109 	rc = mem_alloc(sizeof (*rc));
110 	mtx_init(&rc->rc_lock, "rc->rc_lock", NULL, MTX_DEF);
111 	(void) memcpy(&rc->rc_addr, svcaddr, (size_t)svcaddr->sa_len);
112 	rc->rc_nconf = nconf;
113 	rc->rc_prog = program;
114 	rc->rc_vers = version;
115 	rc->rc_sendsz = sendsz;
116 	rc->rc_recvsz = recvsz;
117 	rc->rc_timeout.tv_sec = -1;
118 	rc->rc_timeout.tv_usec = -1;
119 	rc->rc_retry.tv_sec = 3;
120 	rc->rc_retry.tv_usec = 0;
121 	rc->rc_retries = INT_MAX;
122 	rc->rc_privport = FALSE;
123 	rc->rc_waitchan = "rpcrecv";
124 	rc->rc_intr = 0;
125 	rc->rc_connecting = FALSE;
126 	rc->rc_closed = FALSE;
127 	rc->rc_ucred = crdup(curthread->td_ucred);
128 	rc->rc_client = NULL;
129 
130 	cl->cl_refs = 1;
131 	cl->cl_ops = &clnt_reconnect_ops;
132 	cl->cl_private = (caddr_t)(void *)rc;
133 	cl->cl_auth = authnone_create();
134 	cl->cl_tp = NULL;
135 	cl->cl_netid = NULL;
136 	return (cl);
137 }
138 
139 static enum clnt_stat
140 clnt_reconnect_connect(CLIENT *cl)
141 {
142 	struct thread *td = curthread;
143 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
144 	struct socket *so;
145 	enum clnt_stat stat;
146 	int error;
147 	int one = 1;
148 	struct ucred *oldcred;
149 	CLIENT *newclient = NULL;
150 
151 	mtx_lock(&rc->rc_lock);
152 	while (rc->rc_connecting) {
153 		error = msleep(rc, &rc->rc_lock,
154 		    rc->rc_intr ? PCATCH : 0, "rpcrecon", 0);
155 		if (error) {
156 			mtx_unlock(&rc->rc_lock);
157 			return (RPC_INTR);
158 		}
159 	}
160 	if (rc->rc_closed) {
161 		mtx_unlock(&rc->rc_lock);
162 		return (RPC_CANTSEND);
163 	}
164 	if (rc->rc_client) {
165 		mtx_unlock(&rc->rc_lock);
166 		return (RPC_SUCCESS);
167 	}
168 
169 	/*
170 	 * My turn to attempt a connect. The rc_connecting variable
171 	 * serializes the following code sequence, so it is guaranteed
172 	 * that rc_client will still be NULL after it is re-locked below,
173 	 * since that is the only place it is set non-NULL.
174 	 */
175 	rc->rc_connecting = TRUE;
176 	mtx_unlock(&rc->rc_lock);
177 
178 	so = __rpc_nconf2socket(rc->rc_nconf);
179 	if (!so) {
180 		stat = rpc_createerr.cf_stat = RPC_TLIERROR;
181 		rpc_createerr.cf_error.re_errno = 0;
182 		goto out;
183 	}
184 
185 	oldcred = td->td_ucred;
186 	td->td_ucred = rc->rc_ucred;
187 	if (rc->rc_privport)
188 		bindresvport(so, NULL);
189 
190 	if (rc->rc_nconf->nc_semantics == NC_TPI_CLTS)
191 		newclient = clnt_dg_create(so,
192 		    (struct sockaddr *) &rc->rc_addr, rc->rc_prog, rc->rc_vers,
193 		    rc->rc_sendsz, rc->rc_recvsz);
194 	else
195 		newclient = clnt_vc_create(so,
196 		    (struct sockaddr *) &rc->rc_addr, rc->rc_prog, rc->rc_vers,
197 		    rc->rc_sendsz, rc->rc_recvsz);
198 	td->td_ucred = oldcred;
199 
200 	if (!newclient) {
201 		soclose(so);
202 		rc->rc_err = rpc_createerr.cf_error;
203 		stat = rpc_createerr.cf_stat;
204 		goto out;
205 	}
206 
207 	CLNT_CONTROL(newclient, CLSET_FD_CLOSE, 0);
208 	CLNT_CONTROL(newclient, CLSET_CONNECT, &one);
209 	CLNT_CONTROL(newclient, CLSET_TIMEOUT, &rc->rc_timeout);
210 	CLNT_CONTROL(newclient, CLSET_RETRY_TIMEOUT, &rc->rc_retry);
211 	CLNT_CONTROL(newclient, CLSET_WAITCHAN, rc->rc_waitchan);
212 	CLNT_CONTROL(newclient, CLSET_INTERRUPTIBLE, &rc->rc_intr);
213 	stat = RPC_SUCCESS;
214 
215 out:
216 	mtx_lock(&rc->rc_lock);
217 	KASSERT(rc->rc_client == NULL, ("rc_client not null"));
218 	if (!rc->rc_closed) {
219 		rc->rc_client = newclient;
220 		newclient = NULL;
221 	}
222 	rc->rc_connecting = FALSE;
223 	wakeup(rc);
224 	mtx_unlock(&rc->rc_lock);
225 
226 	if (newclient) {
227 		/*
228 		 * It has been closed, so discard the new client.
229 		 * nb: clnt_[dg|vc]_close()/clnt_[dg|vc]_destroy() cannot
230 		 * be called with the rc_lock mutex held, since they may
231 		 * msleep() while holding a different mutex.
232 		 */
233 		CLNT_CLOSE(newclient);
234 		CLNT_RELEASE(newclient);
235 	}
236 
237 	return (stat);
238 }
239 
240 static enum clnt_stat
241 clnt_reconnect_call(
242 	CLIENT		*cl,		/* client handle */
243 	struct rpc_callextra *ext,	/* call metadata */
244 	rpcproc_t	proc,		/* procedure number */
245 	struct mbuf	*args,		/* pointer to args */
246 	struct mbuf	**resultsp,	/* pointer to results */
247 	struct timeval	utimeout)
248 {
249 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
250 	CLIENT *client;
251 	enum clnt_stat stat;
252 	int tries, error;
253 
254 	tries = 0;
255 	do {
256 		mtx_lock(&rc->rc_lock);
257 		if (rc->rc_closed) {
258 			mtx_unlock(&rc->rc_lock);
259 			return (RPC_CANTSEND);
260 		}
261 
262 		if (!rc->rc_client) {
263 			mtx_unlock(&rc->rc_lock);
264 			stat = clnt_reconnect_connect(cl);
265 			if (stat == RPC_SYSTEMERROR) {
266 				error = tsleep(&fake_wchan,
267 				    rc->rc_intr ? PCATCH : 0, "rpccon", hz);
268 				if (error == EINTR || error == ERESTART)
269 					return (RPC_INTR);
270 				tries++;
271 				if (tries >= rc->rc_retries)
272 					return (stat);
273 				continue;
274 			}
275 			if (stat != RPC_SUCCESS)
276 				return (stat);
277 			mtx_lock(&rc->rc_lock);
278 		}
279 
280 		if (!rc->rc_client) {
281 			mtx_unlock(&rc->rc_lock);
282 			stat = RPC_FAILED;
283 			continue;
284 		}
285 		CLNT_ACQUIRE(rc->rc_client);
286 		client = rc->rc_client;
287 		mtx_unlock(&rc->rc_lock);
288 		stat = CLNT_CALL_MBUF(client, ext, proc, args,
289 		    resultsp, utimeout);
290 
291 		if (stat != RPC_SUCCESS) {
292 			if (!ext)
293 				CLNT_GETERR(client, &rc->rc_err);
294 		}
295 
296 		if (stat == RPC_TIMEDOUT) {
297 			/*
298 			 * Check for async send misfeature for NLM
299 			 * protocol.
300 			 */
301 			if ((rc->rc_timeout.tv_sec == 0
302 				&& rc->rc_timeout.tv_usec == 0)
303 			    || (rc->rc_timeout.tv_sec == -1
304 				&& utimeout.tv_sec == 0
305 				&& utimeout.tv_usec == 0)) {
306 				CLNT_RELEASE(client);
307 				break;
308 			}
309 		}
310 
311 		if (stat == RPC_TIMEDOUT || stat == RPC_CANTSEND
312 		    || stat == RPC_CANTRECV) {
313 			tries++;
314 			if (tries >= rc->rc_retries) {
315 				CLNT_RELEASE(client);
316 				break;
317 			}
318 
319 			if (ext && ext->rc_feedback)
320 				ext->rc_feedback(FEEDBACK_RECONNECT, proc,
321 				    ext->rc_feedback_arg);
322 
323 			mtx_lock(&rc->rc_lock);
324 			/*
325 			 * Make sure that someone else hasn't already
326 			 * reconnected by checking if rc_client has changed.
327 			 * If not, we are done with the client and must
328 			 * do CLNT_RELEASE(client) twice to dispose of it,
329 			 * because there is both an initial refcnt and one
330 			 * acquired by CLNT_ACQUIRE() above.
331 			 */
332 			if (rc->rc_client == client) {
333 				rc->rc_client = NULL;
334 				mtx_unlock(&rc->rc_lock);
335 				CLNT_RELEASE(client);
336 			} else {
337 				mtx_unlock(&rc->rc_lock);
338 			}
339 			CLNT_RELEASE(client);
340 		} else {
341 			CLNT_RELEASE(client);
342 			break;
343 		}
344 	} while (stat != RPC_SUCCESS);
345 
346 	KASSERT(stat != RPC_SUCCESS || *resultsp,
347 	    ("RPC_SUCCESS without reply"));
348 
349 	return (stat);
350 }
351 
352 static void
353 clnt_reconnect_geterr(CLIENT *cl, struct rpc_err *errp)
354 {
355 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
356 
357 	*errp = rc->rc_err;
358 }
359 
360 /*
361  * Since this function requires that rc_client be valid, it can
362  * only be called when that is guaranteed to be the case.
363  */
364 static bool_t
365 clnt_reconnect_freeres(CLIENT *cl, xdrproc_t xdr_res, void *res_ptr)
366 {
367 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
368 
369 	return (CLNT_FREERES(rc->rc_client, xdr_res, res_ptr));
370 }
371 
372 /*ARGSUSED*/
373 static void
374 clnt_reconnect_abort(CLIENT *h)
375 {
376 }
377 
378 /*
379  * CLNT_CONTROL() on the client returned by clnt_reconnect_create() must
380  * always be called before CLNT_CALL_MBUF() by a single thread only.
381  */
382 static bool_t
383 clnt_reconnect_control(CLIENT *cl, u_int request, void *info)
384 {
385 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
386 
387 	if (info == NULL) {
388 		return (FALSE);
389 	}
390 	switch (request) {
391 	case CLSET_TIMEOUT:
392 		rc->rc_timeout = *(struct timeval *)info;
393 		if (rc->rc_client)
394 			CLNT_CONTROL(rc->rc_client, request, info);
395 		break;
396 
397 	case CLGET_TIMEOUT:
398 		*(struct timeval *)info = rc->rc_timeout;
399 		break;
400 
401 	case CLSET_RETRY_TIMEOUT:
402 		rc->rc_retry = *(struct timeval *)info;
403 		if (rc->rc_client)
404 			CLNT_CONTROL(rc->rc_client, request, info);
405 		break;
406 
407 	case CLGET_RETRY_TIMEOUT:
408 		*(struct timeval *)info = rc->rc_retry;
409 		break;
410 
411 	case CLGET_VERS:
412 		*(uint32_t *)info = rc->rc_vers;
413 		break;
414 
415 	case CLSET_VERS:
416 		rc->rc_vers = *(uint32_t *) info;
417 		if (rc->rc_client)
418 			CLNT_CONTROL(rc->rc_client, CLSET_VERS, info);
419 		break;
420 
421 	case CLGET_PROG:
422 		*(uint32_t *)info = rc->rc_prog;
423 		break;
424 
425 	case CLSET_PROG:
426 		rc->rc_prog = *(uint32_t *) info;
427 		if (rc->rc_client)
428 			CLNT_CONTROL(rc->rc_client, request, info);
429 		break;
430 
431 	case CLSET_WAITCHAN:
432 		rc->rc_waitchan = (char *)info;
433 		if (rc->rc_client)
434 			CLNT_CONTROL(rc->rc_client, request, info);
435 		break;
436 
437 	case CLGET_WAITCHAN:
438 		*(const char **) info = rc->rc_waitchan;
439 		break;
440 
441 	case CLSET_INTERRUPTIBLE:
442 		rc->rc_intr = *(int *) info;
443 		if (rc->rc_client)
444 			CLNT_CONTROL(rc->rc_client, request, info);
445 		break;
446 
447 	case CLGET_INTERRUPTIBLE:
448 		*(int *) info = rc->rc_intr;
449 		break;
450 
451 	case CLSET_RETRIES:
452 		rc->rc_retries = *(int *) info;
453 		break;
454 
455 	case CLGET_RETRIES:
456 		*(int *) info = rc->rc_retries;
457 		break;
458 
459 	case CLSET_PRIVPORT:
460 		rc->rc_privport = *(int *) info;
461 		break;
462 
463 	case CLGET_PRIVPORT:
464 		*(int *) info = rc->rc_privport;
465 		break;
466 
467 	default:
468 		return (FALSE);
469 	}
470 
471 	return (TRUE);
472 }
473 
474 static void
475 clnt_reconnect_close(CLIENT *cl)
476 {
477 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
478 	CLIENT *client;
479 
480 	mtx_lock(&rc->rc_lock);
481 
482 	if (rc->rc_closed) {
483 		mtx_unlock(&rc->rc_lock);
484 		return;
485 	}
486 
487 	rc->rc_closed = TRUE;
488 	client = rc->rc_client;
489 	rc->rc_client = NULL;
490 
491 	mtx_unlock(&rc->rc_lock);
492 
493 	if (client) {
494 		CLNT_CLOSE(client);
495 		CLNT_RELEASE(client);
496 	}
497 }
498 
499 static void
500 clnt_reconnect_destroy(CLIENT *cl)
501 {
502 	struct rc_data *rc = (struct rc_data *)cl->cl_private;
503 
504 	if (rc->rc_client)
505 		CLNT_DESTROY(rc->rc_client);
506 	crfree(rc->rc_ucred);
507 	mtx_destroy(&rc->rc_lock);
508 	mem_free(rc, sizeof(*rc));
509 	mem_free(cl, sizeof (CLIENT));
510 }
511