xref: /linux-6.15/fs/afs/server.c (revision e38f299e)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* AFS server record management
3  *
4  * Copyright (C) 2002, 2007 Red Hat, Inc. All Rights Reserved.
5  * Written by David Howells ([email protected])
6  */
7 
8 #include <linux/sched.h>
9 #include <linux/slab.h>
10 #include "afs_fs.h"
11 #include "internal.h"
12 #include "protocol_yfs.h"
13 
14 static unsigned afs_server_gc_delay = 10;	/* Server record timeout in seconds */
15 static atomic_t afs_server_debug_id;
16 
17 static struct afs_server *afs_maybe_use_server(struct afs_server *,
18 					       enum afs_server_trace);
19 static void __afs_put_server(struct afs_net *, struct afs_server *);
20 
21 /*
22  * Find a server by one of its addresses.
23  */
24 struct afs_server *afs_find_server(struct afs_net *net, const struct rxrpc_peer *peer)
25 {
26 	const struct afs_addr_list *alist;
27 	struct afs_server *server = NULL;
28 	unsigned int i;
29 	int seq = 1;
30 
31 	rcu_read_lock();
32 
33 	do {
34 		if (server)
35 			afs_unuse_server_notime(net, server, afs_server_trace_put_find_rsq);
36 		server = NULL;
37 		seq++; /* 2 on the 1st/lockless path, otherwise odd */
38 		read_seqbegin_or_lock(&net->fs_addr_lock, &seq);
39 
40 		hlist_for_each_entry_rcu(server, &net->fs_addresses6, addr6_link) {
41 			alist = rcu_dereference(server->addresses);
42 			for (i = 0; i < alist->nr_addrs; i++)
43 				if (alist->addrs[i].peer == peer)
44 					goto found;
45 		}
46 
47 		server = NULL;
48 		continue;
49 	found:
50 		server = afs_maybe_use_server(server, afs_server_trace_get_by_addr);
51 
52 	} while (need_seqretry(&net->fs_addr_lock, seq));
53 
54 	done_seqretry(&net->fs_addr_lock, seq);
55 
56 	rcu_read_unlock();
57 	return server;
58 }
59 
60 /*
61  * Look up a server by its UUID and mark it active.
62  */
63 struct afs_server *afs_find_server_by_uuid(struct afs_net *net, const uuid_t *uuid)
64 {
65 	struct afs_server *server = NULL;
66 	struct rb_node *p;
67 	int diff, seq = 1;
68 
69 	_enter("%pU", uuid);
70 
71 	do {
72 		/* Unfortunately, rbtree walking doesn't give reliable results
73 		 * under just the RCU read lock, so we have to check for
74 		 * changes.
75 		 */
76 		if (server)
77 			afs_unuse_server(net, server, afs_server_trace_put_uuid_rsq);
78 		server = NULL;
79 		seq++; /* 2 on the 1st/lockless path, otherwise odd */
80 		read_seqbegin_or_lock(&net->fs_lock, &seq);
81 
82 		p = net->fs_servers.rb_node;
83 		while (p) {
84 			server = rb_entry(p, struct afs_server, uuid_rb);
85 
86 			diff = memcmp(uuid, &server->uuid, sizeof(*uuid));
87 			if (diff < 0) {
88 				p = p->rb_left;
89 			} else if (diff > 0) {
90 				p = p->rb_right;
91 			} else {
92 				afs_use_server(server, afs_server_trace_get_by_uuid);
93 				break;
94 			}
95 
96 			server = NULL;
97 		}
98 	} while (need_seqretry(&net->fs_lock, seq));
99 
100 	done_seqretry(&net->fs_lock, seq);
101 
102 	_leave(" = %p", server);
103 	return server;
104 }
105 
106 /*
107  * Install a server record in the namespace tree.  If there's a clash, we stick
108  * it into a list anchored on whichever afs_server struct is actually in the
109  * tree.
110  */
111 static struct afs_server *afs_install_server(struct afs_cell *cell,
112 					     struct afs_server *candidate)
113 {
114 	const struct afs_addr_list *alist;
115 	struct afs_server *server, *next;
116 	struct afs_net *net = cell->net;
117 	struct rb_node **pp, *p;
118 	int diff;
119 
120 	_enter("%p", candidate);
121 
122 	write_seqlock(&net->fs_lock);
123 
124 	/* Firstly install the server in the UUID lookup tree */
125 	pp = &net->fs_servers.rb_node;
126 	p = NULL;
127 	while (*pp) {
128 		p = *pp;
129 		_debug("- consider %p", p);
130 		server = rb_entry(p, struct afs_server, uuid_rb);
131 		diff = memcmp(&candidate->uuid, &server->uuid, sizeof(uuid_t));
132 		if (diff < 0) {
133 			pp = &(*pp)->rb_left;
134 		} else if (diff > 0) {
135 			pp = &(*pp)->rb_right;
136 		} else {
137 			if (server->cell == cell)
138 				goto exists;
139 
140 			/* We have the same UUID representing servers in
141 			 * different cells.  Append the new server to the list.
142 			 */
143 			for (;;) {
144 				next = rcu_dereference_protected(
145 					server->uuid_next,
146 					lockdep_is_held(&net->fs_lock.lock));
147 				if (!next)
148 					break;
149 				server = next;
150 			}
151 			rcu_assign_pointer(server->uuid_next, candidate);
152 			candidate->uuid_prev = server;
153 			server = candidate;
154 			goto added_dup;
155 		}
156 	}
157 
158 	server = candidate;
159 	rb_link_node(&server->uuid_rb, p, pp);
160 	rb_insert_color(&server->uuid_rb, &net->fs_servers);
161 	hlist_add_head_rcu(&server->proc_link, &net->fs_proc);
162 
163 added_dup:
164 	write_seqlock(&net->fs_addr_lock);
165 	alist = rcu_dereference_protected(server->addresses,
166 					  lockdep_is_held(&net->fs_addr_lock.lock));
167 
168 	/* Secondly, if the server has any IPv4 and/or IPv6 addresses, install
169 	 * it in the IPv4 and/or IPv6 reverse-map lists.
170 	 *
171 	 * TODO: For speed we want to use something other than a flat list
172 	 * here; even sorting the list in terms of lowest address would help a
173 	 * bit, but anything we might want to do gets messy and memory
174 	 * intensive.
175 	 */
176 	if (alist->nr_ipv4 > 0)
177 		hlist_add_head_rcu(&server->addr4_link, &net->fs_addresses4);
178 	if (alist->nr_addrs > alist->nr_ipv4)
179 		hlist_add_head_rcu(&server->addr6_link, &net->fs_addresses6);
180 
181 	write_sequnlock(&net->fs_addr_lock);
182 
183 exists:
184 	afs_get_server(server, afs_server_trace_get_install);
185 	write_sequnlock(&net->fs_lock);
186 	return server;
187 }
188 
189 /*
190  * Allocate a new server record and mark it active.
191  */
192 static struct afs_server *afs_alloc_server(struct afs_cell *cell,
193 					   const uuid_t *uuid,
194 					   struct afs_addr_list *alist)
195 {
196 	struct afs_server *server;
197 	struct afs_net *net = cell->net;
198 
199 	_enter("");
200 
201 	server = kzalloc(sizeof(struct afs_server), GFP_KERNEL);
202 	if (!server)
203 		goto enomem;
204 
205 	refcount_set(&server->ref, 1);
206 	atomic_set(&server->active, 1);
207 	server->debug_id = atomic_inc_return(&afs_server_debug_id);
208 	RCU_INIT_POINTER(server->addresses, alist);
209 	server->addr_version = alist->version;
210 	server->uuid = *uuid;
211 	rwlock_init(&server->fs_lock);
212 	INIT_WORK(&server->initcb_work, afs_server_init_callback_work);
213 	init_waitqueue_head(&server->probe_wq);
214 	INIT_LIST_HEAD(&server->probe_link);
215 	spin_lock_init(&server->probe_lock);
216 	server->cell = cell;
217 	server->rtt = UINT_MAX;
218 	server->service_id = FS_SERVICE;
219 
220 	afs_inc_servers_outstanding(net);
221 	trace_afs_server(server->debug_id, 1, 1, afs_server_trace_alloc);
222 	_leave(" = %p", server);
223 	return server;
224 
225 enomem:
226 	_leave(" = NULL [nomem]");
227 	return NULL;
228 }
229 
230 /*
231  * Look up an address record for a server
232  */
233 static struct afs_addr_list *afs_vl_lookup_addrs(struct afs_cell *cell,
234 						 struct key *key, const uuid_t *uuid)
235 {
236 	struct afs_vl_cursor vc;
237 	struct afs_addr_list *alist = NULL;
238 	int ret;
239 
240 	ret = -ERESTARTSYS;
241 	if (afs_begin_vlserver_operation(&vc, cell, key)) {
242 		while (afs_select_vlserver(&vc)) {
243 			if (test_bit(AFS_VLSERVER_FL_IS_YFS, &vc.server->flags))
244 				alist = afs_yfsvl_get_endpoints(&vc, uuid);
245 			else
246 				alist = afs_vl_get_addrs_u(&vc, uuid);
247 		}
248 
249 		ret = afs_end_vlserver_operation(&vc);
250 	}
251 
252 	return ret < 0 ? ERR_PTR(ret) : alist;
253 }
254 
255 /*
256  * Get or create a fileserver record.
257  */
258 struct afs_server *afs_lookup_server(struct afs_cell *cell, struct key *key,
259 				     const uuid_t *uuid, u32 addr_version)
260 {
261 	struct afs_addr_list *alist;
262 	struct afs_server *server, *candidate;
263 
264 	_enter("%p,%pU", cell->net, uuid);
265 
266 	server = afs_find_server_by_uuid(cell->net, uuid);
267 	if (server) {
268 		if (server->addr_version != addr_version)
269 			set_bit(AFS_SERVER_FL_NEEDS_UPDATE, &server->flags);
270 		return server;
271 	}
272 
273 	alist = afs_vl_lookup_addrs(cell, key, uuid);
274 	if (IS_ERR(alist))
275 		return ERR_CAST(alist);
276 
277 	candidate = afs_alloc_server(cell, uuid, alist);
278 	if (!candidate) {
279 		afs_put_addrlist(alist, afs_alist_trace_put_server_oom);
280 		return ERR_PTR(-ENOMEM);
281 	}
282 
283 	server = afs_install_server(cell, candidate);
284 	if (server != candidate) {
285 		afs_put_addrlist(alist, afs_alist_trace_put_server_dup);
286 		kfree(candidate);
287 	} else {
288 		/* Immediately dispatch an asynchronous probe to each interface
289 		 * on the fileserver.  This will make sure the repeat-probing
290 		 * service is started.
291 		 */
292 		afs_fs_probe_fileserver(cell->net, server, key, true);
293 	}
294 
295 	return server;
296 }
297 
298 /*
299  * Set the server timer to fire after a given delay, assuming it's not already
300  * set for an earlier time.
301  */
302 static void afs_set_server_timer(struct afs_net *net, time64_t delay)
303 {
304 	if (net->live) {
305 		afs_inc_servers_outstanding(net);
306 		if (timer_reduce(&net->fs_timer, jiffies + delay * HZ))
307 			afs_dec_servers_outstanding(net);
308 	}
309 }
310 
311 /*
312  * Server management timer.  We have an increment on fs_outstanding that we
313  * need to pass along to the work item.
314  */
315 void afs_servers_timer(struct timer_list *timer)
316 {
317 	struct afs_net *net = container_of(timer, struct afs_net, fs_timer);
318 
319 	_enter("");
320 	if (!queue_work(afs_wq, &net->fs_manager))
321 		afs_dec_servers_outstanding(net);
322 }
323 
324 /*
325  * Get a reference on a server object.
326  */
327 struct afs_server *afs_get_server(struct afs_server *server,
328 				  enum afs_server_trace reason)
329 {
330 	unsigned int a;
331 	int r;
332 
333 	__refcount_inc(&server->ref, &r);
334 	a = atomic_read(&server->active);
335 	trace_afs_server(server->debug_id, r + 1, a, reason);
336 	return server;
337 }
338 
339 /*
340  * Try to get a reference on a server object.
341  */
342 static struct afs_server *afs_maybe_use_server(struct afs_server *server,
343 					       enum afs_server_trace reason)
344 {
345 	unsigned int a;
346 	int r;
347 
348 	if (!__refcount_inc_not_zero(&server->ref, &r))
349 		return NULL;
350 
351 	a = atomic_inc_return(&server->active);
352 	trace_afs_server(server->debug_id, r + 1, a, reason);
353 	return server;
354 }
355 
356 /*
357  * Get an active count on a server object.
358  */
359 struct afs_server *afs_use_server(struct afs_server *server, enum afs_server_trace reason)
360 {
361 	unsigned int a;
362 	int r;
363 
364 	__refcount_inc(&server->ref, &r);
365 	a = atomic_inc_return(&server->active);
366 
367 	trace_afs_server(server->debug_id, r + 1, a, reason);
368 	return server;
369 }
370 
371 /*
372  * Release a reference on a server record.
373  */
374 void afs_put_server(struct afs_net *net, struct afs_server *server,
375 		    enum afs_server_trace reason)
376 {
377 	unsigned int a, debug_id = server->debug_id;
378 	bool zero;
379 	int r;
380 
381 	if (!server)
382 		return;
383 
384 	a = atomic_read(&server->active);
385 	zero = __refcount_dec_and_test(&server->ref, &r);
386 	trace_afs_server(debug_id, r - 1, a, reason);
387 	if (unlikely(zero))
388 		__afs_put_server(net, server);
389 }
390 
391 /*
392  * Drop an active count on a server object without updating the last-unused
393  * time.
394  */
395 void afs_unuse_server_notime(struct afs_net *net, struct afs_server *server,
396 			     enum afs_server_trace reason)
397 {
398 	if (server) {
399 		unsigned int active = atomic_dec_return(&server->active);
400 
401 		if (active == 0)
402 			afs_set_server_timer(net, afs_server_gc_delay);
403 		afs_put_server(net, server, reason);
404 	}
405 }
406 
407 /*
408  * Drop an active count on a server object.
409  */
410 void afs_unuse_server(struct afs_net *net, struct afs_server *server,
411 		      enum afs_server_trace reason)
412 {
413 	if (server) {
414 		server->unuse_time = ktime_get_real_seconds();
415 		afs_unuse_server_notime(net, server, reason);
416 	}
417 }
418 
419 static void afs_server_rcu(struct rcu_head *rcu)
420 {
421 	struct afs_server *server = container_of(rcu, struct afs_server, rcu);
422 
423 	trace_afs_server(server->debug_id, refcount_read(&server->ref),
424 			 atomic_read(&server->active), afs_server_trace_free);
425 	afs_put_addrlist(rcu_access_pointer(server->addresses),
426 			 afs_alist_trace_put_server);
427 	kfree(server);
428 }
429 
430 static void __afs_put_server(struct afs_net *net, struct afs_server *server)
431 {
432 	call_rcu(&server->rcu, afs_server_rcu);
433 	afs_dec_servers_outstanding(net);
434 }
435 
436 static void afs_give_up_callbacks(struct afs_net *net, struct afs_server *server)
437 {
438 	struct afs_addr_list *alist = rcu_access_pointer(server->addresses);
439 	struct afs_addr_cursor ac = {
440 		.alist	= alist,
441 		.index	= alist->preferred,
442 	};
443 
444 	afs_fs_give_up_all_callbacks(net, server, &ac, NULL);
445 }
446 
447 /*
448  * destroy a dead server
449  */
450 static void afs_destroy_server(struct afs_net *net, struct afs_server *server)
451 {
452 	if (test_bit(AFS_SERVER_FL_MAY_HAVE_CB, &server->flags))
453 		afs_give_up_callbacks(net, server);
454 
455 	flush_work(&server->initcb_work);
456 	afs_put_server(net, server, afs_server_trace_destroy);
457 }
458 
459 /*
460  * Garbage collect any expired servers.
461  */
462 static void afs_gc_servers(struct afs_net *net, struct afs_server *gc_list)
463 {
464 	struct afs_server *server, *next, *prev;
465 	int active;
466 
467 	while ((server = gc_list)) {
468 		gc_list = server->gc_next;
469 
470 		write_seqlock(&net->fs_lock);
471 
472 		active = atomic_read(&server->active);
473 		if (active == 0) {
474 			trace_afs_server(server->debug_id, refcount_read(&server->ref),
475 					 active, afs_server_trace_gc);
476 			next = rcu_dereference_protected(
477 				server->uuid_next, lockdep_is_held(&net->fs_lock.lock));
478 			prev = server->uuid_prev;
479 			if (!prev) {
480 				/* The one at the front is in the tree */
481 				if (!next) {
482 					rb_erase(&server->uuid_rb, &net->fs_servers);
483 				} else {
484 					rb_replace_node_rcu(&server->uuid_rb,
485 							    &next->uuid_rb,
486 							    &net->fs_servers);
487 					next->uuid_prev = NULL;
488 				}
489 			} else {
490 				/* This server is not at the front */
491 				rcu_assign_pointer(prev->uuid_next, next);
492 				if (next)
493 					next->uuid_prev = prev;
494 			}
495 
496 			list_del(&server->probe_link);
497 			hlist_del_rcu(&server->proc_link);
498 			if (!hlist_unhashed(&server->addr4_link))
499 				hlist_del_rcu(&server->addr4_link);
500 			if (!hlist_unhashed(&server->addr6_link))
501 				hlist_del_rcu(&server->addr6_link);
502 		}
503 		write_sequnlock(&net->fs_lock);
504 
505 		if (active == 0)
506 			afs_destroy_server(net, server);
507 	}
508 }
509 
510 /*
511  * Manage the records of servers known to be within a network namespace.  This
512  * includes garbage collecting unused servers.
513  *
514  * Note also that we were given an increment on net->servers_outstanding by
515  * whoever queued us that we need to deal with before returning.
516  */
517 void afs_manage_servers(struct work_struct *work)
518 {
519 	struct afs_net *net = container_of(work, struct afs_net, fs_manager);
520 	struct afs_server *gc_list = NULL;
521 	struct rb_node *cursor;
522 	time64_t now = ktime_get_real_seconds(), next_manage = TIME64_MAX;
523 	bool purging = !net->live;
524 
525 	_enter("");
526 
527 	/* Trawl the server list looking for servers that have expired from
528 	 * lack of use.
529 	 */
530 	read_seqlock_excl(&net->fs_lock);
531 
532 	for (cursor = rb_first(&net->fs_servers); cursor; cursor = rb_next(cursor)) {
533 		struct afs_server *server =
534 			rb_entry(cursor, struct afs_server, uuid_rb);
535 		int active = atomic_read(&server->active);
536 
537 		_debug("manage %pU %u", &server->uuid, active);
538 
539 		if (purging) {
540 			trace_afs_server(server->debug_id, refcount_read(&server->ref),
541 					 active, afs_server_trace_purging);
542 			if (active != 0)
543 				pr_notice("Can't purge s=%08x\n", server->debug_id);
544 		}
545 
546 		if (active == 0) {
547 			time64_t expire_at = server->unuse_time;
548 
549 			if (!test_bit(AFS_SERVER_FL_VL_FAIL, &server->flags) &&
550 			    !test_bit(AFS_SERVER_FL_NOT_FOUND, &server->flags))
551 				expire_at += afs_server_gc_delay;
552 			if (purging || expire_at <= now) {
553 				server->gc_next = gc_list;
554 				gc_list = server;
555 			} else if (expire_at < next_manage) {
556 				next_manage = expire_at;
557 			}
558 		}
559 	}
560 
561 	read_sequnlock_excl(&net->fs_lock);
562 
563 	/* Update the timer on the way out.  We have to pass an increment on
564 	 * servers_outstanding in the namespace that we are in to the timer or
565 	 * the work scheduler.
566 	 */
567 	if (!purging && next_manage < TIME64_MAX) {
568 		now = ktime_get_real_seconds();
569 
570 		if (next_manage - now <= 0) {
571 			if (queue_work(afs_wq, &net->fs_manager))
572 				afs_inc_servers_outstanding(net);
573 		} else {
574 			afs_set_server_timer(net, next_manage - now);
575 		}
576 	}
577 
578 	afs_gc_servers(net, gc_list);
579 
580 	afs_dec_servers_outstanding(net);
581 	_leave(" [%d]", atomic_read(&net->servers_outstanding));
582 }
583 
584 static void afs_queue_server_manager(struct afs_net *net)
585 {
586 	afs_inc_servers_outstanding(net);
587 	if (!queue_work(afs_wq, &net->fs_manager))
588 		afs_dec_servers_outstanding(net);
589 }
590 
591 /*
592  * Purge list of servers.
593  */
594 void afs_purge_servers(struct afs_net *net)
595 {
596 	_enter("");
597 
598 	if (del_timer_sync(&net->fs_timer))
599 		afs_dec_servers_outstanding(net);
600 
601 	afs_queue_server_manager(net);
602 
603 	_debug("wait");
604 	atomic_dec(&net->servers_outstanding);
605 	wait_var_event(&net->servers_outstanding,
606 		       !atomic_read(&net->servers_outstanding));
607 	_leave("");
608 }
609 
610 /*
611  * Get an update for a server's address list.
612  */
613 static noinline bool afs_update_server_record(struct afs_operation *op,
614 					      struct afs_server *server)
615 {
616 	struct afs_addr_list *alist, *discard;
617 
618 	_enter("");
619 
620 	trace_afs_server(server->debug_id, refcount_read(&server->ref),
621 			 atomic_read(&server->active),
622 			 afs_server_trace_update);
623 
624 	alist = afs_vl_lookup_addrs(op->volume->cell, op->key, &server->uuid);
625 	if (IS_ERR(alist)) {
626 		if ((PTR_ERR(alist) == -ERESTARTSYS ||
627 		     PTR_ERR(alist) == -EINTR) &&
628 		    (op->flags & AFS_OPERATION_UNINTR) &&
629 		    server->addresses) {
630 			_leave(" = t [intr]");
631 			return true;
632 		}
633 		afs_op_set_error(op, PTR_ERR(alist));
634 		_leave(" = f [%d]", afs_op_error(op));
635 		return false;
636 	}
637 
638 	discard = alist;
639 	if (server->addr_version != alist->version) {
640 		write_lock(&server->fs_lock);
641 		discard = rcu_dereference_protected(server->addresses,
642 						    lockdep_is_held(&server->fs_lock));
643 		rcu_assign_pointer(server->addresses, alist);
644 		server->addr_version = alist->version;
645 		write_unlock(&server->fs_lock);
646 	}
647 
648 	afs_put_addrlist(discard, afs_alist_trace_put_server_update);
649 	_leave(" = t");
650 	return true;
651 }
652 
653 /*
654  * See if a server's address list needs updating.
655  */
656 bool afs_check_server_record(struct afs_operation *op, struct afs_server *server)
657 {
658 	bool success;
659 	int ret, retries = 0;
660 
661 	_enter("");
662 
663 	ASSERT(server);
664 
665 retry:
666 	if (test_bit(AFS_SERVER_FL_UPDATING, &server->flags))
667 		goto wait;
668 	if (test_bit(AFS_SERVER_FL_NEEDS_UPDATE, &server->flags))
669 		goto update;
670 	_leave(" = t [good]");
671 	return true;
672 
673 update:
674 	if (!test_and_set_bit_lock(AFS_SERVER_FL_UPDATING, &server->flags)) {
675 		clear_bit(AFS_SERVER_FL_NEEDS_UPDATE, &server->flags);
676 		success = afs_update_server_record(op, server);
677 		clear_bit_unlock(AFS_SERVER_FL_UPDATING, &server->flags);
678 		wake_up_bit(&server->flags, AFS_SERVER_FL_UPDATING);
679 		_leave(" = %d", success);
680 		return success;
681 	}
682 
683 wait:
684 	ret = wait_on_bit(&server->flags, AFS_SERVER_FL_UPDATING,
685 			  (op->flags & AFS_OPERATION_UNINTR) ?
686 			  TASK_UNINTERRUPTIBLE : TASK_INTERRUPTIBLE);
687 	if (ret == -ERESTARTSYS) {
688 		afs_op_set_error(op, ret);
689 		_leave(" = f [intr]");
690 		return false;
691 	}
692 
693 	retries++;
694 	if (retries == 4) {
695 		_leave(" = f [stale]");
696 		ret = -ESTALE;
697 		return false;
698 	}
699 	goto retry;
700 }
701