Merge master.kernel.org:/pub/scm/linux/kernel/git/davej/agpgart
[linux-2.6] / fs / afs / proc.c
1 /* proc.c: /proc interface for AFS
2  *
3  * Copyright (C) 2002 Red Hat, Inc. All Rights Reserved.
4  * Written by David Howells (dhowells@redhat.com)
5  *
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.
10  */
11
12 #include <linux/slab.h>
13 #include <linux/module.h>
14 #include <linux/proc_fs.h>
15 #include <linux/seq_file.h>
16 #include "cell.h"
17 #include "volume.h"
18 #include <asm/uaccess.h>
19 #include "internal.h"
20
21 static struct proc_dir_entry *proc_afs;
22
23
24 static int afs_proc_cells_open(struct inode *inode, struct file *file);
25 static void *afs_proc_cells_start(struct seq_file *p, loff_t *pos);
26 static void *afs_proc_cells_next(struct seq_file *p, void *v, loff_t *pos);
27 static void afs_proc_cells_stop(struct seq_file *p, void *v);
28 static int afs_proc_cells_show(struct seq_file *m, void *v);
29 static ssize_t afs_proc_cells_write(struct file *file, const char __user *buf,
30                                     size_t size, loff_t *_pos);
31
32 static struct seq_operations afs_proc_cells_ops = {
33         .start  = afs_proc_cells_start,
34         .next   = afs_proc_cells_next,
35         .stop   = afs_proc_cells_stop,
36         .show   = afs_proc_cells_show,
37 };
38
39 static const struct file_operations afs_proc_cells_fops = {
40         .open           = afs_proc_cells_open,
41         .read           = seq_read,
42         .write          = afs_proc_cells_write,
43         .llseek         = seq_lseek,
44         .release        = seq_release,
45 };
46
47 static int afs_proc_rootcell_open(struct inode *inode, struct file *file);
48 static int afs_proc_rootcell_release(struct inode *inode, struct file *file);
49 static ssize_t afs_proc_rootcell_read(struct file *file, char __user *buf,
50                                       size_t size, loff_t *_pos);
51 static ssize_t afs_proc_rootcell_write(struct file *file,
52                                        const char __user *buf,
53                                        size_t size, loff_t *_pos);
54
55 static const struct file_operations afs_proc_rootcell_fops = {
56         .open           = afs_proc_rootcell_open,
57         .read           = afs_proc_rootcell_read,
58         .write          = afs_proc_rootcell_write,
59         .llseek         = no_llseek,
60         .release        = afs_proc_rootcell_release
61 };
62
63 static int afs_proc_cell_volumes_open(struct inode *inode, struct file *file);
64 static int afs_proc_cell_volumes_release(struct inode *inode,
65                                          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,
68                                         loff_t *pos);
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);
71
72 static 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,
77 };
78
79 static const struct file_operations afs_proc_cell_volumes_fops = {
80         .open           = afs_proc_cell_volumes_open,
81         .read           = seq_read,
82         .llseek         = seq_lseek,
83         .release        = afs_proc_cell_volumes_release,
84 };
85
86 static int afs_proc_cell_vlservers_open(struct inode *inode,
87                                         struct file *file);
88 static int afs_proc_cell_vlservers_release(struct inode *inode,
89                                            struct file *file);
90 static void *afs_proc_cell_vlservers_start(struct seq_file *p, loff_t *pos);
91 static void *afs_proc_cell_vlservers_next(struct seq_file *p, void *v,
92                                           loff_t *pos);
93 static void afs_proc_cell_vlservers_stop(struct seq_file *p, void *v);
94 static int afs_proc_cell_vlservers_show(struct seq_file *m, void *v);
95
96 static struct seq_operations afs_proc_cell_vlservers_ops = {
97         .start  = afs_proc_cell_vlservers_start,
98         .next   = afs_proc_cell_vlservers_next,
99         .stop   = afs_proc_cell_vlservers_stop,
100         .show   = afs_proc_cell_vlservers_show,
101 };
102
103 static const struct file_operations afs_proc_cell_vlservers_fops = {
104         .open           = afs_proc_cell_vlservers_open,
105         .read           = seq_read,
106         .llseek         = seq_lseek,
107         .release        = afs_proc_cell_vlservers_release,
108 };
109
110 static int afs_proc_cell_servers_open(struct inode *inode, struct file *file);
111 static int afs_proc_cell_servers_release(struct inode *inode,
112                                          struct file *file);
113 static void *afs_proc_cell_servers_start(struct seq_file *p, loff_t *pos);
114 static void *afs_proc_cell_servers_next(struct seq_file *p, void *v,
115                                         loff_t *pos);
116 static void afs_proc_cell_servers_stop(struct seq_file *p, void *v);
117 static int afs_proc_cell_servers_show(struct seq_file *m, void *v);
118
119 static struct seq_operations afs_proc_cell_servers_ops = {
120         .start  = afs_proc_cell_servers_start,
121         .next   = afs_proc_cell_servers_next,
122         .stop   = afs_proc_cell_servers_stop,
123         .show   = afs_proc_cell_servers_show,
124 };
125
126 static const struct file_operations afs_proc_cell_servers_fops = {
127         .open           = afs_proc_cell_servers_open,
128         .read           = seq_read,
129         .llseek         = seq_lseek,
130         .release        = afs_proc_cell_servers_release,
131 };
132
133 /*****************************************************************************/
134 /*
135  * initialise the /proc/fs/afs/ directory
136  */
137 int afs_proc_init(void)
138 {
139         struct proc_dir_entry *p;
140
141         _enter("");
142
143         proc_afs = proc_mkdir("fs/afs", NULL);
144         if (!proc_afs)
145                 goto error;
146         proc_afs->owner = THIS_MODULE;
147
148         p = create_proc_entry("cells", 0, proc_afs);
149         if (!p)
150                 goto error_proc;
151         p->proc_fops = &afs_proc_cells_fops;
152         p->owner = THIS_MODULE;
153
154         p = create_proc_entry("rootcell", 0, proc_afs);
155         if (!p)
156                 goto error_cells;
157         p->proc_fops = &afs_proc_rootcell_fops;
158         p->owner = THIS_MODULE;
159
160         _leave(" = 0");
161         return 0;
162
163  error_cells:
164         remove_proc_entry("cells", proc_afs);
165  error_proc:
166         remove_proc_entry("fs/afs", NULL);
167  error:
168         _leave(" = -ENOMEM");
169         return -ENOMEM;
170
171 } /* end afs_proc_init() */
172
173 /*****************************************************************************/
174 /*
175  * clean up the /proc/fs/afs/ directory
176  */
177 void afs_proc_cleanup(void)
178 {
179         remove_proc_entry("cells", proc_afs);
180
181         remove_proc_entry("fs/afs", NULL);
182
183 } /* end afs_proc_cleanup() */
184
185 /*****************************************************************************/
186 /*
187  * open "/proc/fs/afs/cells" which provides a summary of extant cells
188  */
189 static int afs_proc_cells_open(struct inode *inode, struct file *file)
190 {
191         struct seq_file *m;
192         int ret;
193
194         ret = seq_open(file, &afs_proc_cells_ops);
195         if (ret < 0)
196                 return ret;
197
198         m = file->private_data;
199         m->private = PDE(inode)->data;
200
201         return 0;
202 } /* end afs_proc_cells_open() */
203
204 /*****************************************************************************/
205 /*
206  * set up the iterator to start reading from the cells list and return the
207  * first item
208  */
209 static void *afs_proc_cells_start(struct seq_file *m, loff_t *_pos)
210 {
211         struct list_head *_p;
212         loff_t pos = *_pos;
213
214         /* lock the list against modification */
215         down_read(&afs_proc_cells_sem);
216
217         /* allow for the header line */
218         if (!pos)
219                 return (void *) 1;
220         pos--;
221
222         /* find the n'th element in the list */
223         list_for_each(_p, &afs_proc_cells)
224                 if (!pos--)
225                         break;
226
227         return _p != &afs_proc_cells ? _p : NULL;
228 } /* end afs_proc_cells_start() */
229
230 /*****************************************************************************/
231 /*
232  * move to next cell in cells list
233  */
234 static void *afs_proc_cells_next(struct seq_file *p, void *v, loff_t *pos)
235 {
236         struct list_head *_p;
237
238         (*pos)++;
239
240         _p = v;
241         _p = v == (void *) 1 ? afs_proc_cells.next : _p->next;
242
243         return _p != &afs_proc_cells ? _p : NULL;
244 } /* end afs_proc_cells_next() */
245
246 /*****************************************************************************/
247 /*
248  * clean up after reading from the cells list
249  */
250 static void afs_proc_cells_stop(struct seq_file *p, void *v)
251 {
252         up_read(&afs_proc_cells_sem);
253
254 } /* end afs_proc_cells_stop() */
255
256 /*****************************************************************************/
257 /*
258  * display a header line followed by a load of cell lines
259  */
260 static int afs_proc_cells_show(struct seq_file *m, void *v)
261 {
262         struct afs_cell *cell = list_entry(v, struct afs_cell, proc_link);
263
264         /* display header on line 1 */
265         if (v == (void *) 1) {
266                 seq_puts(m, "USE NAME\n");
267                 return 0;
268         }
269
270         /* display one cell per line on subsequent lines */
271         seq_printf(m, "%3d %s\n", atomic_read(&cell->usage), cell->name);
272
273         return 0;
274 } /* end afs_proc_cells_show() */
275
276 /*****************************************************************************/
277 /*
278  * handle writes to /proc/fs/afs/cells
279  * - to add cells: echo "add <cellname> <IP>[:<IP>][:<IP>]"
280  */
281 static ssize_t afs_proc_cells_write(struct file *file, const char __user *buf,
282                                     size_t size, loff_t *_pos)
283 {
284         char *kbuf, *name, *args;
285         int ret;
286
287         /* start by dragging the command into memory */
288         if (size <= 1 || size >= PAGE_SIZE)
289                 return -EINVAL;
290
291         kbuf = kmalloc(size + 1, GFP_KERNEL);
292         if (!kbuf)
293                 return -ENOMEM;
294
295         ret = -EFAULT;
296         if (copy_from_user(kbuf, buf, size) != 0)
297                 goto done;
298         kbuf[size] = 0;
299
300         /* trim to first NL */
301         name = memchr(kbuf, '\n', size);
302         if (name)
303                 *name = 0;
304
305         /* split into command, name and argslist */
306         name = strchr(kbuf, ' ');
307         if (!name)
308                 goto inval;
309         do {
310                 *name++ = 0;
311         } while(*name == ' ');
312         if (!*name)
313                 goto inval;
314
315         args = strchr(name, ' ');
316         if (!args)
317                 goto inval;
318         do {
319                 *args++ = 0;
320         } while(*args == ' ');
321         if (!*args)
322                 goto inval;
323
324         /* determine command to perform */
325         _debug("cmd=%s name=%s args=%s", kbuf, name, args);
326
327         if (strcmp(kbuf, "add") == 0) {
328                 struct afs_cell *cell;
329                 ret = afs_cell_create(name, args, &cell);
330                 if (ret < 0)
331                         goto done;
332
333                 printk("kAFS: Added new cell '%s'\n", name);
334         }
335         else {
336                 goto inval;
337         }
338
339         ret = size;
340
341  done:
342         kfree(kbuf);
343         _leave(" = %d", ret);
344         return ret;
345
346  inval:
347         ret = -EINVAL;
348         printk("kAFS: Invalid Command on /proc/fs/afs/cells file\n");
349         goto done;
350 } /* end afs_proc_cells_write() */
351
352 /*****************************************************************************/
353 /*
354  * Stubs for /proc/fs/afs/rootcell
355  */
356 static int afs_proc_rootcell_open(struct inode *inode, struct file *file)
357 {
358         return 0;
359 }
360
361 static int afs_proc_rootcell_release(struct inode *inode, struct file *file)
362 {
363         return 0;
364 }
365
366 static ssize_t afs_proc_rootcell_read(struct file *file, char __user *buf,
367                                       size_t size, loff_t *_pos)
368 {
369         return 0;
370 }
371
372 /*****************************************************************************/
373 /*
374  * handle writes to /proc/fs/afs/rootcell
375  * - to initialize rootcell: echo "cell.name:192.168.231.14"
376  */
377 static ssize_t afs_proc_rootcell_write(struct file *file,
378                                        const char __user *buf,
379                                        size_t size, loff_t *_pos)
380 {
381         char *kbuf, *s;
382         int ret;
383
384         /* start by dragging the command into memory */
385         if (size <= 1 || size >= PAGE_SIZE)
386                 return -EINVAL;
387
388         ret = -ENOMEM;
389         kbuf = kmalloc(size + 1, GFP_KERNEL);
390         if (!kbuf)
391                 goto nomem;
392
393         ret = -EFAULT;
394         if (copy_from_user(kbuf, buf, size) != 0)
395                 goto infault;
396         kbuf[size] = 0;
397
398         /* trim to first NL */
399         s = memchr(kbuf, '\n', size);
400         if (s)
401                 *s = 0;
402
403         /* determine command to perform */
404         _debug("rootcell=%s", kbuf);
405
406         ret = afs_cell_init(kbuf);
407         if (ret >= 0)
408                 ret = size;     /* consume everything, always */
409
410  infault:
411         kfree(kbuf);
412  nomem:
413         _leave(" = %d", ret);
414         return ret;
415 } /* end afs_proc_rootcell_write() */
416
417 /*****************************************************************************/
418 /*
419  * initialise /proc/fs/afs/<cell>/
420  */
421 int afs_proc_cell_setup(struct afs_cell *cell)
422 {
423         struct proc_dir_entry *p;
424
425         _enter("%p{%s}", cell, cell->name);
426
427         cell->proc_dir = proc_mkdir(cell->name, proc_afs);
428         if (!cell->proc_dir)
429                 return -ENOMEM;
430
431         p = create_proc_entry("servers", 0, cell->proc_dir);
432         if (!p)
433                 goto error_proc;
434         p->proc_fops = &afs_proc_cell_servers_fops;
435         p->owner = THIS_MODULE;
436         p->data = cell;
437
438         p = create_proc_entry("vlservers", 0, cell->proc_dir);
439         if (!p)
440                 goto error_servers;
441         p->proc_fops = &afs_proc_cell_vlservers_fops;
442         p->owner = THIS_MODULE;
443         p->data = cell;
444
445         p = create_proc_entry("volumes", 0, cell->proc_dir);
446         if (!p)
447                 goto error_vlservers;
448         p->proc_fops = &afs_proc_cell_volumes_fops;
449         p->owner = THIS_MODULE;
450         p->data = cell;
451
452         _leave(" = 0");
453         return 0;
454
455  error_vlservers:
456         remove_proc_entry("vlservers", cell->proc_dir);
457  error_servers:
458         remove_proc_entry("servers", cell->proc_dir);
459  error_proc:
460         remove_proc_entry(cell->name, proc_afs);
461         _leave(" = -ENOMEM");
462         return -ENOMEM;
463 } /* end afs_proc_cell_setup() */
464
465 /*****************************************************************************/
466 /*
467  * remove /proc/fs/afs/<cell>/
468  */
469 void afs_proc_cell_remove(struct afs_cell *cell)
470 {
471         _enter("");
472
473         remove_proc_entry("volumes", cell->proc_dir);
474         remove_proc_entry("vlservers", cell->proc_dir);
475         remove_proc_entry("servers", cell->proc_dir);
476         remove_proc_entry(cell->name, proc_afs);
477
478         _leave("");
479 } /* end afs_proc_cell_remove() */
480
481 /*****************************************************************************/
482 /*
483  * open "/proc/fs/afs/<cell>/volumes" which provides a summary of extant cells
484  */
485 static int afs_proc_cell_volumes_open(struct inode *inode, struct file *file)
486 {
487         struct afs_cell *cell;
488         struct seq_file *m;
489         int ret;
490
491         cell = afs_get_cell_maybe((struct afs_cell **) &PDE(inode)->data);
492         if (!cell)
493                 return -ENOENT;
494
495         ret = seq_open(file, &afs_proc_cell_volumes_ops);
496         if (ret < 0)
497                 return ret;
498
499         m = file->private_data;
500         m->private = cell;
501
502         return 0;
503 } /* end afs_proc_cell_volumes_open() */
504
505 /*****************************************************************************/
506 /*
507  * close the file and release the ref to the cell
508  */
509 static int afs_proc_cell_volumes_release(struct inode *inode, struct file *file)
510 {
511         struct afs_cell *cell = PDE(inode)->data;
512         int ret;
513
514         ret = seq_release(inode,file);
515
516         afs_put_cell(cell);
517
518         return ret;
519 } /* end afs_proc_cell_volumes_release() */
520
521 /*****************************************************************************/
522 /*
523  * set up the iterator to start reading from the cells list and return the
524  * first item
525  */
526 static void *afs_proc_cell_volumes_start(struct seq_file *m, loff_t *_pos)
527 {
528         struct list_head *_p;
529         struct afs_cell *cell = m->private;
530         loff_t pos = *_pos;
531
532         _enter("cell=%p pos=%Ld", cell, *_pos);
533
534         /* lock the list against modification */
535         down_read(&cell->vl_sem);
536
537         /* allow for the header line */
538         if (!pos)
539                 return (void *) 1;
540         pos--;
541
542         /* find the n'th element in the list */
543         list_for_each(_p, &cell->vl_list)
544                 if (!pos--)
545                         break;
546
547         return _p != &cell->vl_list ? _p : NULL;
548 } /* end afs_proc_cell_volumes_start() */
549
550 /*****************************************************************************/
551 /*
552  * move to next cell in cells list
553  */
554 static void *afs_proc_cell_volumes_next(struct seq_file *p, void *v,
555                                         loff_t *_pos)
556 {
557         struct list_head *_p;
558         struct afs_cell *cell = p->private;
559
560         _enter("cell=%p pos=%Ld", cell, *_pos);
561
562         (*_pos)++;
563
564         _p = v;
565         _p = v == (void *) 1 ? cell->vl_list.next : _p->next;
566
567         return _p != &cell->vl_list ? _p : NULL;
568 } /* end afs_proc_cell_volumes_next() */
569
570 /*****************************************************************************/
571 /*
572  * clean up after reading from the cells list
573  */
574 static void afs_proc_cell_volumes_stop(struct seq_file *p, void *v)
575 {
576         struct afs_cell *cell = p->private;
577
578         up_read(&cell->vl_sem);
579
580 } /* end afs_proc_cell_volumes_stop() */
581
582 /*****************************************************************************/
583 /*
584  * display a header line followed by a load of volume lines
585  */
586 static int afs_proc_cell_volumes_show(struct seq_file *m, void *v)
587 {
588         struct afs_vlocation *vlocation =
589                 list_entry(v, struct afs_vlocation, link);
590
591         /* display header on line 1 */
592         if (v == (void *) 1) {
593                 seq_puts(m, "USE VLID[0]  VLID[1]  VLID[2]  NAME\n");
594                 return 0;
595         }
596
597         /* display one cell per line on subsequent lines */
598         seq_printf(m, "%3d %08x %08x %08x %s\n",
599                    atomic_read(&vlocation->usage),
600                    vlocation->vldb.vid[0],
601                    vlocation->vldb.vid[1],
602                    vlocation->vldb.vid[2],
603                    vlocation->vldb.name
604                    );
605
606         return 0;
607 } /* end afs_proc_cell_volumes_show() */
608
609 /*****************************************************************************/
610 /*
611  * open "/proc/fs/afs/<cell>/vlservers" which provides a list of volume
612  * location server
613  */
614 static int afs_proc_cell_vlservers_open(struct inode *inode, struct file *file)
615 {
616         struct afs_cell *cell;
617         struct seq_file *m;
618         int ret;
619
620         cell = afs_get_cell_maybe((struct afs_cell**)&PDE(inode)->data);
621         if (!cell)
622                 return -ENOENT;
623
624         ret = seq_open(file,&afs_proc_cell_vlservers_ops);
625         if (ret<0)
626                 return ret;
627
628         m = file->private_data;
629         m->private = cell;
630
631         return 0;
632 } /* end afs_proc_cell_vlservers_open() */
633
634 /*****************************************************************************/
635 /*
636  * close the file and release the ref to the cell
637  */
638 static int afs_proc_cell_vlservers_release(struct inode *inode,
639                                            struct file *file)
640 {
641         struct afs_cell *cell = PDE(inode)->data;
642         int ret;
643
644         ret = seq_release(inode,file);
645
646         afs_put_cell(cell);
647
648         return ret;
649 } /* end afs_proc_cell_vlservers_release() */
650
651 /*****************************************************************************/
652 /*
653  * set up the iterator to start reading from the cells list and return the
654  * first item
655  */
656 static void *afs_proc_cell_vlservers_start(struct seq_file *m, loff_t *_pos)
657 {
658         struct afs_cell *cell = m->private;
659         loff_t pos = *_pos;
660
661         _enter("cell=%p pos=%Ld", cell, *_pos);
662
663         /* lock the list against modification */
664         down_read(&cell->vl_sem);
665
666         /* allow for the header line */
667         if (!pos)
668                 return (void *) 1;
669         pos--;
670
671         if (pos >= cell->vl_naddrs)
672                 return NULL;
673
674         return &cell->vl_addrs[pos];
675 } /* end afs_proc_cell_vlservers_start() */
676
677 /*****************************************************************************/
678 /*
679  * move to next cell in cells list
680  */
681 static void *afs_proc_cell_vlservers_next(struct seq_file *p, void *v,
682                                           loff_t *_pos)
683 {
684         struct afs_cell *cell = p->private;
685         loff_t pos;
686
687         _enter("cell=%p{nad=%u} pos=%Ld", cell, cell->vl_naddrs, *_pos);
688
689         pos = *_pos;
690         (*_pos)++;
691         if (pos >= cell->vl_naddrs)
692                 return NULL;
693
694         return &cell->vl_addrs[pos];
695 } /* end afs_proc_cell_vlservers_next() */
696
697 /*****************************************************************************/
698 /*
699  * clean up after reading from the cells list
700  */
701 static void afs_proc_cell_vlservers_stop(struct seq_file *p, void *v)
702 {
703         struct afs_cell *cell = p->private;
704
705         up_read(&cell->vl_sem);
706
707 } /* end afs_proc_cell_vlservers_stop() */
708
709 /*****************************************************************************/
710 /*
711  * display a header line followed by a load of volume lines
712  */
713 static int afs_proc_cell_vlservers_show(struct seq_file *m, void *v)
714 {
715         struct in_addr *addr = v;
716
717         /* display header on line 1 */
718         if (v == (struct in_addr *) 1) {
719                 seq_puts(m, "ADDRESS\n");
720                 return 0;
721         }
722
723         /* display one cell per line on subsequent lines */
724         seq_printf(m, "%u.%u.%u.%u\n", NIPQUAD(addr->s_addr));
725
726         return 0;
727 } /* end afs_proc_cell_vlservers_show() */
728
729 /*****************************************************************************/
730 /*
731  * open "/proc/fs/afs/<cell>/servers" which provides a summary of active
732  * servers
733  */
734 static int afs_proc_cell_servers_open(struct inode *inode, struct file *file)
735 {
736         struct afs_cell *cell;
737         struct seq_file *m;
738         int ret;
739
740         cell = afs_get_cell_maybe((struct afs_cell **) &PDE(inode)->data);
741         if (!cell)
742                 return -ENOENT;
743
744         ret = seq_open(file, &afs_proc_cell_servers_ops);
745         if (ret < 0)
746                 return ret;
747
748         m = file->private_data;
749         m->private = cell;
750
751         return 0;
752 } /* end afs_proc_cell_servers_open() */
753
754 /*****************************************************************************/
755 /*
756  * close the file and release the ref to the cell
757  */
758 static int afs_proc_cell_servers_release(struct inode *inode,
759                                          struct file *file)
760 {
761         struct afs_cell *cell = PDE(inode)->data;
762         int ret;
763
764         ret = seq_release(inode, file);
765
766         afs_put_cell(cell);
767
768         return ret;
769 } /* end afs_proc_cell_servers_release() */
770
771 /*****************************************************************************/
772 /*
773  * set up the iterator to start reading from the cells list and return the
774  * first item
775  */
776 static void *afs_proc_cell_servers_start(struct seq_file *m, loff_t *_pos)
777         __acquires(m->private->sv_lock)
778 {
779         struct list_head *_p;
780         struct afs_cell *cell = m->private;
781         loff_t pos = *_pos;
782
783         _enter("cell=%p pos=%Ld", cell, *_pos);
784
785         /* lock the list against modification */
786         read_lock(&cell->sv_lock);
787
788         /* allow for the header line */
789         if (!pos)
790                 return (void *) 1;
791         pos--;
792
793         /* find the n'th element in the list */
794         list_for_each(_p, &cell->sv_list)
795                 if (!pos--)
796                         break;
797
798         return _p != &cell->sv_list ? _p : NULL;
799 } /* end afs_proc_cell_servers_start() */
800
801 /*****************************************************************************/
802 /*
803  * move to next cell in cells list
804  */
805 static void *afs_proc_cell_servers_next(struct seq_file *p, void *v,
806                                         loff_t *_pos)
807 {
808         struct list_head *_p;
809         struct afs_cell *cell = p->private;
810
811         _enter("cell=%p pos=%Ld", cell, *_pos);
812
813         (*_pos)++;
814
815         _p = v;
816         _p = v == (void *) 1 ? cell->sv_list.next : _p->next;
817
818         return _p != &cell->sv_list ? _p : NULL;
819 } /* end afs_proc_cell_servers_next() */
820
821 /*****************************************************************************/
822 /*
823  * clean up after reading from the cells list
824  */
825 static void afs_proc_cell_servers_stop(struct seq_file *p, void *v)
826         __releases(p->private->sv_lock)
827 {
828         struct afs_cell *cell = p->private;
829
830         read_unlock(&cell->sv_lock);
831
832 } /* end afs_proc_cell_servers_stop() */
833
834 /*****************************************************************************/
835 /*
836  * display a header line followed by a load of volume lines
837  */
838 static int afs_proc_cell_servers_show(struct seq_file *m, void *v)
839 {
840         struct afs_server *server = list_entry(v, struct afs_server, link);
841         char ipaddr[20];
842
843         /* display header on line 1 */
844         if (v == (void *) 1) {
845                 seq_puts(m, "USE ADDR            STATE\n");
846                 return 0;
847         }
848
849         /* display one cell per line on subsequent lines */
850         sprintf(ipaddr, "%u.%u.%u.%u", NIPQUAD(server->addr));
851         seq_printf(m, "%3d %-15.15s %5d\n",
852                    atomic_read(&server->usage),
853                    ipaddr,
854                    server->fs_state
855                    );
856
857         return 0;
858 } /* end afs_proc_cell_servers_show() */