2 /* AFS volume management
15  * Insert a volume into a cell.  If there's an existing volume record, that is
19 						      struct afs_volume *volume)  in afs_insert_volume_into_cell()  argument
30 		if (p->vid < volume->vid) {  in afs_insert_volume_into_cell()
32 		} else if (p->vid > volume->vid) {  in afs_insert_volume_into_cell()
35 			volume = afs_get_volume(p, afs_volume_trace_get_cell_insert);  in afs_insert_volume_into_cell()
40 	rb_link_node_rcu(&volume->cell_node, parent, pp);  in afs_insert_volume_into_cell()
41 	rb_insert_color(&volume->cell_node, &cell->volumes);  in afs_insert_volume_into_cell()
42 	hlist_add_head_rcu(&volume->proc_link, &cell->proc_volumes);  in afs_insert_volume_into_cell()
46 	return volume;  in afs_insert_volume_into_cell()
50 static void afs_remove_volume_from_cell(struct afs_volume *volume)  in afs_remove_volume_from_cell()  argument
52 	struct afs_cell *cell = volume->cell;  in afs_remove_volume_from_cell()
54 	if (!hlist_unhashed(&volume->proc_link)) {  in afs_remove_volume_from_cell()
55 		trace_afs_volume(volume->vid, refcount_read(&cell->ref),  in afs_remove_volume_from_cell()
58 		hlist_del_rcu(&volume->proc_link);  in afs_remove_volume_from_cell()
59 		rb_erase(&volume->cell_node, &cell->volumes);  in afs_remove_volume_from_cell()
65  * Allocate a volume record and load it up from a vldb record.
72 	struct afs_volume *volume;  in afs_alloc_volume()  local
75 	volume = kzalloc(sizeof(struct afs_volume), GFP_KERNEL);  in afs_alloc_volume()
76 	if (!volume)  in afs_alloc_volume()
79 	volume->vid		= vldb->vid[params->type];  in afs_alloc_volume()
80 	volume->update_at	= ktime_get_real_seconds() + afs_volume_record_life;  in afs_alloc_volume()
81 	volume->cell		= afs_get_cell(params->cell, afs_cell_trace_get_vol);  in afs_alloc_volume()
82 	volume->type		= params->type;  in afs_alloc_volume()
83 	volume->type_force	= params->force;  in afs_alloc_volume()
84 	volume->name_len	= vldb->name_len;  in afs_alloc_volume()
86 	refcount_set(&volume->ref, 1);  in afs_alloc_volume()
87 	INIT_HLIST_NODE(&volume->proc_link);  in afs_alloc_volume()
88 	rwlock_init(&volume->servers_lock);  in afs_alloc_volume()
89 	rwlock_init(&volume->cb_v_break_lock);  in afs_alloc_volume()
90 	memcpy(volume->name, vldb->name, vldb->name_len + 1);  in afs_alloc_volume()
99 	rcu_assign_pointer(volume->servers, slist);  in afs_alloc_volume()
100 	trace_afs_volume(volume->vid, 1, afs_volume_trace_alloc);  in afs_alloc_volume()
101 	return volume;  in afs_alloc_volume()
104 	afs_put_cell(volume->cell, afs_cell_trace_put_vol);  in afs_alloc_volume()
105 	kfree(volume);  in afs_alloc_volume()
111  * Look up or allocate a volume record.
117 	struct afs_volume *candidate, *volume;  in afs_lookup_volume()  local
123 	volume = afs_insert_volume_into_cell(params->cell, candidate);  in afs_lookup_volume()
124 	if (volume != candidate)  in afs_lookup_volume()
126 	return volume;  in afs_lookup_volume()
130  * Look up a VLDB record for a volume.
153  * Look up a volume in the VL server and create a candidate volume record for
156  * The volume name can be one of the following:
157  *	"%[cell:]volume[.]"		R/W volume
158  *	"#[cell:]volume[.]"		R/O or R/W volume (rwparent=0),
159  *					 or R/W (rwparent=1) volume
160  *	"%[cell:]volume.readonly"	R/O volume
161  *	"#[cell:]volume.readonly"	R/O volume
162  *	"%[cell:]volume.backup"		Backup volume
163  *	"#[cell:]volume.backup"		Backup volume
171  * - Rule 2: If parent volume is R/O, then mount R/O volume by preference, R/W
173  * - Rule 3: If parent volume is R/W, then only mount R/W volume unless
179 	struct afs_volume *volume;  in afs_create_volume()  local
188 		volume = ERR_PTR(vldb->error);  in afs_create_volume()
193 	volume = ERR_PTR(-ENOMEDIUM);  in afs_create_volume()
206 	volume = afs_lookup_volume(params, vldb, type_mask);  in afs_create_volume()
210 	return volume;  in afs_create_volume()
214  * Destroy a volume record
216 static void afs_destroy_volume(struct afs_net *net, struct afs_volume *volume)  in afs_destroy_volume()  argument
218 	_enter("%p", volume);  in afs_destroy_volume()
221 	ASSERTCMP(volume->cache, ==, NULL);  in afs_destroy_volume()
224 	afs_remove_volume_from_cell(volume);  in afs_destroy_volume()
225 	afs_put_serverlist(net, rcu_access_pointer(volume->servers));  in afs_destroy_volume()
226 	afs_put_cell(volume->cell, afs_cell_trace_put_vol);  in afs_destroy_volume()
227 	trace_afs_volume(volume->vid, refcount_read(&volume->ref),  in afs_destroy_volume()
229 	kfree_rcu(volume, rcu);  in afs_destroy_volume()
235  * Get a reference on a volume record.
237 struct afs_volume *afs_get_volume(struct afs_volume *volume,  in afs_get_volume()  argument
240 	if (volume) {  in afs_get_volume()
243 		__refcount_inc(&volume->ref, &r);  in afs_get_volume()
244 		trace_afs_volume(volume->vid, r + 1, reason);  in afs_get_volume()
246 	return volume;  in afs_get_volume()
251  * Drop a reference on a volume record.
253 void afs_put_volume(struct afs_net *net, struct afs_volume *volume,  in afs_put_volume()  argument
256 	if (volume) {  in afs_put_volume()
257 		afs_volid_t vid = volume->vid;  in afs_put_volume()
261 		zero = __refcount_dec_and_test(&volume->ref, &r);  in afs_put_volume()
264 			afs_destroy_volume(net, volume);  in afs_put_volume()
269  * Activate a volume.
271 int afs_activate_volume(struct afs_volume *volume)  in afs_activate_volume()  argument
278 			 volume->cell->name, volume->vid);  in afs_activate_volume()
288 		pr_err("AFS: Cache volume key already in use (%s)\n", name);  in afs_activate_volume()
291 	volume->cache = vcookie;  in afs_activate_volume()
298  * Deactivate a volume.
300 void afs_deactivate_volume(struct afs_volume *volume)  in afs_deactivate_volume()  argument
302 	_enter("%s", volume->name);  in afs_deactivate_volume()
305 	fscache_relinquish_volume(volume->cache, NULL,  in afs_deactivate_volume()
306 				  test_bit(AFS_VOLUME_DELETED, &volume->flags));  in afs_deactivate_volume()
307 	volume->cache = NULL;  in afs_deactivate_volume()
314  * Query the VL service to update the volume status.
316 static int afs_update_volume_status(struct afs_volume *volume, struct key *key)  in afs_update_volume_status()  argument
328 	idsz = sprintf(idbuf, "%llu", volume->vid);  in afs_update_volume_status()
330 	vldb = afs_vl_lookup_vldb(volume->cell, key, idbuf, idsz);  in afs_update_volume_status()
336 	/* See if the volume got renamed. */  in afs_update_volume_status()
337 	if (vldb->name_len != volume->name_len ||  in afs_update_volume_status()
338 	    memcmp(vldb->name, volume->name, vldb->name_len) != 0) {  in afs_update_volume_status()
340 		memcpy(volume->name, vldb->name, AFS_MAXVOLNAME);  in afs_update_volume_status()
341 		volume->name_len = vldb->name_len;  in afs_update_volume_status()
344 	/* See if the volume's server list got updated. */  in afs_update_volume_status()
345 	new = afs_alloc_server_list(volume->cell, key,  in afs_update_volume_status()
346 				    vldb, (1 << volume->type));  in afs_update_volume_status()
352 	write_lock(&volume->servers_lock);  in afs_update_volume_status()
355 	old = rcu_dereference_protected(volume->servers,  in afs_update_volume_status()
356 					lockdep_is_held(&volume->servers_lock));  in afs_update_volume_status()
358 		new->seq = volume->servers_seq + 1;  in afs_update_volume_status()
359 		rcu_assign_pointer(volume->servers, new);  in afs_update_volume_status()
361 		volume->servers_seq++;  in afs_update_volume_status()
365 	volume->update_at = ktime_get_real_seconds() + afs_volume_record_life;  in afs_update_volume_status()
366 	write_unlock(&volume->servers_lock);  in afs_update_volume_status()
369 	afs_put_serverlist(volume->cell->net, discard);  in afs_update_volume_status()
378  * Make sure the volume record is up to date.
380 int afs_check_volume_status(struct afs_volume *volume, struct afs_operation *op)  in afs_check_volume_status()  argument
387 	if (test_bit(AFS_VOLUME_WAIT, &volume->flags))  in afs_check_volume_status()
389 	if (volume->update_at <= ktime_get_real_seconds() ||  in afs_check_volume_status()
390 	    test_bit(AFS_VOLUME_NEEDS_UPDATE, &volume->flags))  in afs_check_volume_status()
396 	if (!test_and_set_bit_lock(AFS_VOLUME_UPDATING, &volume->flags)) {  in afs_check_volume_status()
397 		clear_bit(AFS_VOLUME_NEEDS_UPDATE, &volume->flags);  in afs_check_volume_status()
398 		ret = afs_update_volume_status(volume, op->key);  in afs_check_volume_status()
400 			set_bit(AFS_VOLUME_NEEDS_UPDATE, &volume->flags);  in afs_check_volume_status()
401 		clear_bit_unlock(AFS_VOLUME_WAIT, &volume->flags);  in afs_check_volume_status()
402 		clear_bit_unlock(AFS_VOLUME_UPDATING, &volume->flags);  in afs_check_volume_status()
403 		wake_up_bit(&volume->flags, AFS_VOLUME_WAIT);  in afs_check_volume_status()
409 	if (!test_bit(AFS_VOLUME_WAIT, &volume->flags)) {  in afs_check_volume_status()
414 	ret = wait_on_bit(&volume->flags, AFS_VOLUME_WAIT,  in afs_check_volume_status()