1 /* /proc interface for AFS
3 * Copyright (C) 2002 Red Hat, Inc. 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 License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
12 #include <linux/slab.h>
13 #include <linux/module.h>
14 #include <linux/proc_fs.h>
15 #include <linux/seq_file.h>
16 #include <linux/sched.h>
17 #include <linux/uaccess.h>
20 static inline struct afs_net *afs_proc2net(struct file *f)
25 static inline struct afs_net *afs_seq2net(struct seq_file *m)
27 return &__afs_net; // TODO: use seq_file_net(m)
30 static int afs_proc_cells_open(struct inode *inode, struct file *file);
31 static void *afs_proc_cells_start(struct seq_file *p, loff_t *pos);
32 static void *afs_proc_cells_next(struct seq_file *p, void *v, loff_t *pos);
33 static void afs_proc_cells_stop(struct seq_file *p, void *v);
34 static int afs_proc_cells_show(struct seq_file *m, void *v);
35 static ssize_t afs_proc_cells_write(struct file *file, const char __user *buf,
36 size_t size, loff_t *_pos);
38 static const struct seq_operations afs_proc_cells_ops = {
39 .start = afs_proc_cells_start,
40 .next = afs_proc_cells_next,
41 .stop = afs_proc_cells_stop,
42 .show = afs_proc_cells_show,
45 static const struct file_operations afs_proc_cells_fops = {
46 .open = afs_proc_cells_open,
48 .write = afs_proc_cells_write,
50 .release = seq_release,
53 static ssize_t afs_proc_rootcell_read(struct file *file, char __user *buf,
54 size_t size, loff_t *_pos);
55 static ssize_t afs_proc_rootcell_write(struct file *file,
56 const char __user *buf,
57 size_t size, loff_t *_pos);
59 static const struct file_operations afs_proc_rootcell_fops = {
60 .read = afs_proc_rootcell_read,
61 .write = afs_proc_rootcell_write,
65 static int afs_proc_cell_volumes_open(struct inode *inode, struct file *file);
66 static void *afs_proc_cell_volumes_start(struct seq_file *p, loff_t *pos);
67 static void *afs_proc_cell_volumes_next(struct seq_file *p, void *v,
69 static void afs_proc_cell_volumes_stop(struct seq_file *p, void *v);
70 static int afs_proc_cell_volumes_show(struct seq_file *m, void *v);
72 static const struct seq_operations afs_proc_cell_volumes_ops = {
73 .start = afs_proc_cell_volumes_start,
74 .next = afs_proc_cell_volumes_next,
75 .stop = afs_proc_cell_volumes_stop,
76 .show = afs_proc_cell_volumes_show,
79 static const struct file_operations afs_proc_cell_volumes_fops = {
80 .open = afs_proc_cell_volumes_open,
83 .release = seq_release,
86 static int afs_proc_cell_vlservers_open(struct inode *inode,
88 static void *afs_proc_cell_vlservers_start(struct seq_file *p, loff_t *pos);
89 static void *afs_proc_cell_vlservers_next(struct seq_file *p, void *v,
91 static void afs_proc_cell_vlservers_stop(struct seq_file *p, void *v);
92 static int afs_proc_cell_vlservers_show(struct seq_file *m, void *v);
94 static const struct seq_operations afs_proc_cell_vlservers_ops = {
95 .start = afs_proc_cell_vlservers_start,
96 .next = afs_proc_cell_vlservers_next,
97 .stop = afs_proc_cell_vlservers_stop,
98 .show = afs_proc_cell_vlservers_show,
101 static const struct file_operations afs_proc_cell_vlservers_fops = {
102 .open = afs_proc_cell_vlservers_open,
105 .release = seq_release,
108 static int afs_proc_servers_open(struct inode *inode, struct file *file);
109 static void *afs_proc_servers_start(struct seq_file *p, loff_t *pos);
110 static void *afs_proc_servers_next(struct seq_file *p, void *v,
112 static void afs_proc_servers_stop(struct seq_file *p, void *v);
113 static int afs_proc_servers_show(struct seq_file *m, void *v);
115 static const struct seq_operations afs_proc_servers_ops = {
116 .start = afs_proc_servers_start,
117 .next = afs_proc_servers_next,
118 .stop = afs_proc_servers_stop,
119 .show = afs_proc_servers_show,
122 static const struct file_operations afs_proc_servers_fops = {
123 .open = afs_proc_servers_open,
126 .release = seq_release,
130 * initialise the /proc/fs/afs/ directory
132 int afs_proc_init(struct afs_net *net)
136 net->proc_afs = proc_mkdir("fs/afs", NULL);
140 if (!proc_create("cells", 0644, net->proc_afs, &afs_proc_cells_fops) ||
141 !proc_create("rootcell", 0644, net->proc_afs, &afs_proc_rootcell_fops) ||
142 !proc_create("servers", 0644, net->proc_afs, &afs_proc_servers_fops))
149 proc_remove(net->proc_afs);
151 _leave(" = -ENOMEM");
156 * clean up the /proc/fs/afs/ directory
158 void afs_proc_cleanup(struct afs_net *net)
160 proc_remove(net->proc_afs);
161 net->proc_afs = NULL;
165 * open "/proc/fs/afs/cells" which provides a summary of extant cells
167 static int afs_proc_cells_open(struct inode *inode, struct file *file)
172 ret = seq_open(file, &afs_proc_cells_ops);
176 m = file->private_data;
177 m->private = PDE_DATA(inode);
182 * set up the iterator to start reading from the cells list and return the
185 static void *afs_proc_cells_start(struct seq_file *m, loff_t *_pos)
187 struct afs_net *net = afs_seq2net(m);
190 return seq_list_start_head(&net->proc_cells, *_pos);
194 * move to next cell in cells list
196 static void *afs_proc_cells_next(struct seq_file *m, void *v, loff_t *pos)
198 struct afs_net *net = afs_seq2net(m);
200 return seq_list_next(v, &net->proc_cells, pos);
204 * clean up after reading from the cells list
206 static void afs_proc_cells_stop(struct seq_file *m, void *v)
212 * display a header line followed by a load of cell lines
214 static int afs_proc_cells_show(struct seq_file *m, void *v)
216 struct afs_cell *cell = list_entry(v, struct afs_cell, proc_link);
217 struct afs_net *net = afs_seq2net(m);
219 if (v == &net->proc_cells) {
220 /* display header on line 1 */
221 seq_puts(m, "USE NAME\n");
225 /* display one cell per line on subsequent lines */
226 seq_printf(m, "%3u %s\n", atomic_read(&cell->usage), cell->name);
231 * handle writes to /proc/fs/afs/cells
232 * - to add cells: echo "add <cellname> <IP>[:<IP>][:<IP>]"
234 static ssize_t afs_proc_cells_write(struct file *file, const char __user *buf,
235 size_t size, loff_t *_pos)
237 struct afs_net *net = afs_proc2net(file);
238 char *kbuf, *name, *args;
241 /* start by dragging the command into memory */
242 if (size <= 1 || size >= PAGE_SIZE)
245 kbuf = memdup_user_nul(buf, size);
247 return PTR_ERR(kbuf);
249 /* trim to first NL */
250 name = memchr(kbuf, '\n', size);
254 /* split into command, name and argslist */
255 name = strchr(kbuf, ' ');
260 } while(*name == ' ');
264 args = strchr(name, ' ');
269 } while(*args == ' ');
273 /* determine command to perform */
274 _debug("cmd=%s name=%s args=%s", kbuf, name, args);
276 if (strcmp(kbuf, "add") == 0) {
277 struct afs_cell *cell;
279 cell = afs_lookup_cell(net, name, strlen(name), args, true);
285 set_bit(AFS_CELL_FL_NO_GC, &cell->flags);
286 printk("kAFS: Added new cell '%s'\n", name);
295 _leave(" = %d", ret);
300 printk("kAFS: Invalid Command on /proc/fs/afs/cells file\n");
304 static ssize_t afs_proc_rootcell_read(struct file *file, char __user *buf,
305 size_t size, loff_t *_pos)
311 * handle writes to /proc/fs/afs/rootcell
312 * - to initialize rootcell: echo "cell.name:192.168.231.14"
314 static ssize_t afs_proc_rootcell_write(struct file *file,
315 const char __user *buf,
316 size_t size, loff_t *_pos)
318 struct afs_net *net = afs_proc2net(file);
322 /* start by dragging the command into memory */
323 if (size <= 1 || size >= PAGE_SIZE)
326 kbuf = memdup_user_nul(buf, size);
328 return PTR_ERR(kbuf);
330 /* trim to first NL */
331 s = memchr(kbuf, '\n', size);
335 /* determine command to perform */
336 _debug("rootcell=%s", kbuf);
338 ret = afs_cell_init(net, kbuf);
340 ret = size; /* consume everything, always */
343 _leave(" = %d", ret);
348 * initialise /proc/fs/afs/<cell>/
350 int afs_proc_cell_setup(struct afs_net *net, struct afs_cell *cell)
352 struct proc_dir_entry *dir;
354 _enter("%p{%s},%p", cell, cell->name, net->proc_afs);
356 dir = proc_mkdir(cell->name, net->proc_afs);
360 if (!proc_create_data("vlservers", 0, dir,
361 &afs_proc_cell_vlservers_fops, cell) ||
362 !proc_create_data("volumes", 0, dir,
363 &afs_proc_cell_volumes_fops, cell))
370 remove_proc_subtree(cell->name, net->proc_afs);
372 _leave(" = -ENOMEM");
377 * remove /proc/fs/afs/<cell>/
379 void afs_proc_cell_remove(struct afs_net *net, struct afs_cell *cell)
383 remove_proc_subtree(cell->name, net->proc_afs);
389 * open "/proc/fs/afs/<cell>/volumes" which provides a summary of extant cells
391 static int afs_proc_cell_volumes_open(struct inode *inode, struct file *file)
393 struct afs_cell *cell;
397 cell = PDE_DATA(inode);
401 ret = seq_open(file, &afs_proc_cell_volumes_ops);
405 m = file->private_data;
412 * set up the iterator to start reading from the cells list and return the
415 static void *afs_proc_cell_volumes_start(struct seq_file *m, loff_t *_pos)
417 struct afs_cell *cell = m->private;
419 _enter("cell=%p pos=%Ld", cell, *_pos);
421 read_lock(&cell->proc_lock);
422 return seq_list_start_head(&cell->proc_volumes, *_pos);
426 * move to next cell in cells list
428 static void *afs_proc_cell_volumes_next(struct seq_file *p, void *v,
431 struct afs_cell *cell = p->private;
433 _enter("cell=%p pos=%Ld", cell, *_pos);
434 return seq_list_next(v, &cell->proc_volumes, _pos);
438 * clean up after reading from the cells list
440 static void afs_proc_cell_volumes_stop(struct seq_file *p, void *v)
442 struct afs_cell *cell = p->private;
444 read_unlock(&cell->proc_lock);
447 static const char afs_vol_types[3][3] = {
448 [AFSVL_RWVOL] = "RW",
449 [AFSVL_ROVOL] = "RO",
450 [AFSVL_BACKVOL] = "BK",
454 * display a header line followed by a load of volume lines
456 static int afs_proc_cell_volumes_show(struct seq_file *m, void *v)
458 struct afs_cell *cell = m->private;
459 struct afs_volume *vol = list_entry(v, struct afs_volume, proc_link);
461 /* Display header on line 1 */
462 if (v == &cell->proc_volumes) {
463 seq_puts(m, "USE VID TY\n");
467 seq_printf(m, "%3d %08x %s\n",
468 atomic_read(&vol->usage), vol->vid,
469 afs_vol_types[vol->type]);
475 * open "/proc/fs/afs/<cell>/vlservers" which provides a list of volume
478 static int afs_proc_cell_vlservers_open(struct inode *inode, struct file *file)
480 struct afs_cell *cell;
484 cell = PDE_DATA(inode);
488 ret = seq_open(file, &afs_proc_cell_vlservers_ops);
492 m = file->private_data;
499 * set up the iterator to start reading from the cells list and return the
502 static void *afs_proc_cell_vlservers_start(struct seq_file *m, loff_t *_pos)
504 struct afs_addr_list *alist;
505 struct afs_cell *cell = m->private;
510 alist = rcu_dereference(cell->vl_addrs);
512 /* allow for the header line */
517 if (!alist || pos >= alist->nr_addrs)
520 return alist->addrs + pos;
524 * move to next cell in cells list
526 static void *afs_proc_cell_vlservers_next(struct seq_file *p, void *v,
529 struct afs_addr_list *alist;
530 struct afs_cell *cell = p->private;
533 alist = rcu_dereference(cell->vl_addrs);
537 if (!alist || pos >= alist->nr_addrs)
540 return alist->addrs + pos;
544 * clean up after reading from the cells list
546 static void afs_proc_cell_vlservers_stop(struct seq_file *p, void *v)
552 * display a header line followed by a load of volume lines
554 static int afs_proc_cell_vlservers_show(struct seq_file *m, void *v)
556 struct sockaddr_rxrpc *addr = v;
558 /* display header on line 1 */
559 if (v == (void *)1) {
560 seq_puts(m, "ADDRESS\n");
564 /* display one cell per line on subsequent lines */
565 seq_printf(m, "%pISp\n", &addr->transport);
570 * open "/proc/fs/afs/servers" which provides a summary of active
573 static int afs_proc_servers_open(struct inode *inode, struct file *file)
575 return seq_open(file, &afs_proc_servers_ops);
579 * Set up the iterator to start reading from the server list and return the
582 static void *afs_proc_servers_start(struct seq_file *m, loff_t *_pos)
584 struct afs_net *net = afs_seq2net(m);
587 return seq_hlist_start_head_rcu(&net->fs_proc, *_pos);
591 * move to next cell in cells list
593 static void *afs_proc_servers_next(struct seq_file *m, void *v, loff_t *_pos)
595 struct afs_net *net = afs_seq2net(m);
597 return seq_hlist_next_rcu(v, &net->fs_proc, _pos);
601 * clean up after reading from the cells list
603 static void afs_proc_servers_stop(struct seq_file *p, void *v)
609 * display a header line followed by a load of volume lines
611 static int afs_proc_servers_show(struct seq_file *m, void *v)
613 struct afs_server *server;
614 struct afs_addr_list *alist;
616 if (v == SEQ_START_TOKEN) {
617 seq_puts(m, "UUID USE ADDR\n");
621 server = list_entry(v, struct afs_server, proc_link);
622 alist = rcu_dereference(server->addresses);
623 seq_printf(m, "%pU %3d %pISp\n",
625 atomic_read(&server->usage),
626 &alist->addrs[alist->index].transport);