1 /* /proc interface for AFS
3 * Copyright (C) 2002 Red Hat, Inc. All Rights Reserved.
4 * Written by David Howells (dhowells@redhat.com)
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
);