lustre/llite/lproc_llite.c

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  *  Copyright (C) 2002 Cluster File Systems, Inc.
   5  *
   6  *   This file is part of Lustre, http://www.lustre.org.
   7  *
   8  *   Lustre is free software; you can redistribute it and/or
   9  *   modify it under the terms of version 2 of the GNU General Public
  10  *   License as published by the Free Software Foundation.
  11  *
  12  *   Lustre is distributed in the hope that it will be useful,
  13  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *   GNU General Public License for more details.
  16  *
  17  *   You should have received a copy of the GNU General Public License
  18  *   along with Lustre; if not, write to the Free Software
  19  *   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20  *
  21  */
  22 #define DEBUG_SUBSYSTEM S_LLITE
  23
  24 #include <linux/version.h>
  25 #include <linux/lustre_lite.h>
  26 #include <linux/lprocfs_status.h>
  27 #include <linux/seq_file.h>
  28 #include <linux/obd_support.h>
  29
  30 #include "llite_internal.h"
  31
  32 /* /proc/lustre/llite mount point registration */
  33 struct proc_dir_entry *proc_lustre_fs_root;
  34 struct file_operations llite_dump_pgcache_fops;
  35
  36 #ifndef LPROCFS
  37 int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
  38                                 struct super_block *sb, char *osc, char *mdc)
  39 {
  40         return 0;
  41 }
  42 void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi){}
  43 #else
  44
  45 long long mnt_instance;
  46
  47 static int ll_rd_blksize(char *page, char **start, off_t off, int count,
  48                          int *eof, void *data)
  49 {
  50         struct super_block *sb = (struct super_block *)data;
  51         struct obd_statfs osfs;
  52         int rc;
  53
  54         LASSERT(sb != NULL);
  55         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
  56         if (!rc) {
  57               *eof = 1;
  58               rc = snprintf(page, count, "%u\n", osfs.os_bsize);
  59         }
  60
  61         return rc;
  62 }
  63
  64 static int ll_rd_kbytestotal(char *page, char **start, off_t off, int count,
  65                              int *eof, void *data)
  66 {
  67         struct super_block *sb = (struct super_block *)data;
  68         struct obd_statfs osfs;
  69         int rc;
  70
  71         LASSERT(sb != NULL);
  72         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
  73         if (!rc) {
  74                 __u32 blk_size = osfs.os_bsize >> 10;
  75                 __u64 result = osfs.os_blocks;
  76
  77                 while (blk_size >>= 1)
  78                         result <<= 1;
  79
  80                 *eof = 1;
  81                 rc = snprintf(page, count, LPU64"\n", result);
  82         }
  83         return rc;
  84
  85 }
  86
  87 static int ll_rd_kbytesfree(char *page, char **start, off_t off, int count,
  88                             int *eof, void *data)
  89 {
  90         struct super_block *sb = (struct super_block *)data;
  91         struct obd_statfs osfs;
  92         int rc;
  93
  94         LASSERT(sb != NULL);
  95         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
  96         if (!rc) {
  97                 __u32 blk_size = osfs.os_bsize >> 10;
  98                 __u64 result = osfs.os_bfree;
  99
 100                 while (blk_size >>= 1)
 101                         result <<= 1;
 102
 103                 *eof = 1;
 104                 rc = snprintf(page, count, LPU64"\n", result);
 105         }
 106         return rc;
 107 }
 108
 109 static int ll_rd_kbytesavail(char *page, char **start, off_t off, int count,
 110                              int *eof, void *data)
 111 {
 112         struct super_block *sb = (struct super_block *)data;
 113         struct obd_statfs osfs;
 114         int rc;
 115
 116         LASSERT(sb != NULL);
 117         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
 118         if (!rc) {
 119                 __u32 blk_size = osfs.os_bsize >> 10;
 120                 __u64 result = osfs.os_bavail;
 121
 122                 while (blk_size >>= 1)
 123                         result <<= 1;
 124
 125                 *eof = 1;
 126                 rc = snprintf(page, count, LPU64"\n", result);
 127         }
 128         return rc;
 129 }
 130
 131 static int ll_rd_filestotal(char *page, char **start, off_t off, int count,
 132                             int *eof, void *data)
 133 {
 134         struct super_block *sb = (struct super_block *)data;
 135         struct obd_statfs osfs;
 136         int rc;
 137
 138         LASSERT(sb != NULL);
 139         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
 140         if (!rc) {
 141                  *eof = 1;
 142                  rc = snprintf(page, count, LPU64"\n", osfs.os_files);
 143         }
 144         return rc;
 145 }
 146
 147 static int ll_rd_filesfree(char *page, char **start, off_t off, int count,
 148                            int *eof, void *data)
 149 {
 150         struct super_block *sb = (struct super_block *)data;
 151         struct obd_statfs osfs;
 152         int rc;
 153
 154         LASSERT(sb != NULL);
 155         rc = ll_statfs_internal(sb, &osfs, jiffies - HZ);
 156         if (!rc) {
 157                  *eof = 1;
 158                  rc = snprintf(page, count, LPU64"\n", osfs.os_ffree);
 159         }
 160         return rc;
 161
 162 }
 163
 164 static int ll_rd_fstype(char *page, char **start, off_t off, int count,
 165                         int *eof, void *data)
 166 {
 167         struct super_block *sb = (struct super_block*)data;
 168
 169         LASSERT(sb != NULL);
 170         *eof = 1;
 171         return snprintf(page, count, "%s\n", sb->s_type->name);
 172 }
 173
 174 static int ll_rd_sb_uuid(char *page, char **start, off_t off, int count,
 175                          int *eof, void *data)
 176 {
 177         struct super_block *sb = (struct super_block *)data;
 178
 179         LASSERT(sb != NULL);
 180         *eof = 1;
 181         return snprintf(page, count, "%s\n", ll_s2sbi(sb)->ll_sb_uuid.uuid);
 182 }
 183
 184 static int ll_rd_read_ahead(char *page, char **start, off_t off, int count,
 185                             int *eof, void *data)
 186 {
 187         struct super_block *sb = (struct super_block*)data;
 188         struct ll_sb_info *sbi = ll_s2sbi(sb);
 189         int val, rc;
 190         ENTRY;
 191
 192         *eof = 1;
 193         val = (sbi->ll_flags & LL_SBI_READAHEAD) ? 1 : 0;
 194         rc = snprintf(page, count, "%d\n", val);
 195         RETURN(rc);
 196 }
 197
 198 static int ll_wr_read_ahead(struct file *file, const char *buffer,
 199                             unsigned long count, void *data)
 200 {
 201         struct super_block *sb = (struct super_block*)data;
 202         struct ll_sb_info *sbi = ll_s2sbi(sb);
 203         int readahead;
 204         ENTRY;
 205
 206         if (1 != sscanf(buffer, "%d", &readahead))
 207                 RETURN(-EINVAL);
 208
 209         if (readahead)
 210                 sbi->ll_flags |= LL_SBI_READAHEAD;
 211         else
 212                 sbi->ll_flags &= ~LL_SBI_READAHEAD;
 213
 214         RETURN(count);
 215 }
 216
 217 static int ll_rd_max_read_ahead_mb(char *page, char **start, off_t off,
 218                                    int count, int *eof, void *data)
 219 {
 220         struct super_block *sb = data;
 221         struct ll_sb_info *sbi = ll_s2sbi(sb);
 222         unsigned val;
 223
 224         spin_lock(&sbi->ll_lock);
 225         val = (sbi->ll_max_read_ahead_pages << PAGE_CACHE_SHIFT) >> 20;
 226         spin_unlock(&sbi->ll_lock);
 227
 228         return snprintf(page, count, "%u\n", val);
 229 }
 230
 231 static int ll_wr_max_read_ahead_mb(struct file *file, const char *buffer,
 232                                    unsigned long count, void *data)
 233 {
 234         struct super_block *sb = data;
 235         struct ll_sb_info *sbi = ll_s2sbi(sb);
 236         int val, rc;
 237
 238         rc = lprocfs_write_helper(buffer, count, &val);
 239         if (rc)
 240                 return rc;
 241
 242         if (val < 0 || val > (num_physpages << PAGE_SHIFT) >> 20)
 243                 return -ERANGE;
 244
 245         spin_lock(&sbi->ll_lock);
 246         sbi->ll_max_read_ahead_pages = (val << 20) >> PAGE_CACHE_SHIFT;
 247         spin_unlock(&sbi->ll_lock);
 248
 249         return count;
 250 }
 251
 252 static struct lprocfs_vars lprocfs_obd_vars[] = {
 253         { "uuid",         ll_rd_sb_uuid,          0, 0 },
 254         //{ "mntpt_path",   ll_rd_path,             0, 0 },
 255         { "fstype",       ll_rd_fstype,           0, 0 },
 256         { "blocksize",    ll_rd_blksize,          0, 0 },
 257         { "kbytestotal",  ll_rd_kbytestotal,      0, 0 },
 258         { "kbytesfree",   ll_rd_kbytesfree,       0, 0 },
 259         { "kbytesavail",  ll_rd_kbytesavail,      0, 0 },
 260         { "filestotal",   ll_rd_filestotal,       0, 0 },
 261         { "filesfree",    ll_rd_filesfree,        0, 0 },
 262         //{ "filegroups",   lprocfs_rd_filegroups,  0, 0 },
 263         { "read_ahead",   ll_rd_read_ahead, ll_wr_read_ahead, 0 },
 264         { "max_read_ahead_mb",   ll_rd_max_read_ahead_mb,
 265                                  ll_wr_max_read_ahead_mb, 0 },
 266         { 0 }
 267 };
 268
 269 #define MAX_STRING_SIZE 128
 270
 271 struct llite_file_opcode {
 272         __u32       opcode;
 273         __u32       type;
 274         const char *opname;
 275 } llite_opcode_table[LPROC_LL_FILE_OPCODES] = {
 276         /* file operation */
 277         { LPROC_LL_DIRTY_HITS,     LPROCFS_TYPE_REGS, "dirty_pages_hits" },
 278         { LPROC_LL_DIRTY_MISSES,   LPROCFS_TYPE_REGS, "dirty_pages_misses" },
 279         { LPROC_LL_WB_WRITEPAGE,   LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 280                                    "writeback_from_writepage" },
 281         { LPROC_LL_WB_PRESSURE,    LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 282                                    "writeback_from_pressure" },
 283         { LPROC_LL_WB_OK,          LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 284                                    "writeback_ok_pages" },
 285         { LPROC_LL_WB_FAIL,        LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 286                                    "writeback_failed_pages" },
 287         { LPROC_LL_READ_BYTES,     LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_BYTES,
 288                                    "read_bytes" },
 289         { LPROC_LL_WRITE_BYTES,    LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_BYTES,
 290                                    "write_bytes" },
 291         { LPROC_LL_BRW_READ,       LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 292                                    "brw_read" },
 293         { LPROC_LL_BRW_WRITE,      LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 294                                    "brw_write" },
 295
 296         { LPROC_LL_IOCTL,          LPROCFS_TYPE_REGS, "ioctl" },
 297         { LPROC_LL_OPEN,           LPROCFS_TYPE_REGS, "open" },
 298         { LPROC_LL_RELEASE,        LPROCFS_TYPE_REGS, "close" },
 299         { LPROC_LL_MAP,            LPROCFS_TYPE_REGS, "mmap" },
 300         { LPROC_LL_LLSEEK,         LPROCFS_TYPE_REGS, "seek" },
 301         { LPROC_LL_FSYNC,          LPROCFS_TYPE_REGS, "fsync" },
 302         /* inode operation */
 303         { LPROC_LL_SETATTR,        LPROCFS_TYPE_REGS, "setattr" },
 304         { LPROC_LL_TRUNC,          LPROCFS_TYPE_REGS, "punch" },
 305 #if (LINUX_VERSION_CODE > KERNEL_VERSION(2,5,0))
 306         { LPROC_LL_GETATTR,        LPROCFS_TYPE_REGS, "getattr" },
 307 #else
 308         { LPROC_LL_REVALIDATE,     LPROCFS_TYPE_REGS, "getattr" },
 309 #endif
 310         /* special inode operation */
 311         { LPROC_LL_STAFS,          LPROCFS_TYPE_REGS, "statfs" },
 312         { LPROC_LL_ALLOC_INODE,    LPROCFS_TYPE_REGS, "alloc_inode" },
 313         { LPROC_LL_DIRECT_READ,    LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 314                                    "direct_read" },
 315         { LPROC_LL_DIRECT_WRITE,   LPROCFS_CNTR_AVGMINMAX|LPROCFS_TYPE_PAGES,
 316                                    "direct_write" },
 317
 318 };
 319
 320 int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
 321                                 struct super_block *sb, char *osc, char *mdc)
 322 {
 323         struct lprocfs_vars lvars[2];
 324         struct ll_sb_info *sbi = ll_s2sbi(sb);
 325         struct obd_device *obd;
 326         char name[MAX_STRING_SIZE + 1];
 327         int err, id;
 328         struct lprocfs_stats *svc_stats = NULL;
 329         struct proc_dir_entry *entry;
 330         ENTRY;
 331
 332         memset(lvars, 0, sizeof(lvars));
 333
 334         name[MAX_STRING_SIZE] = '\0';
 335         lvars[0].name = name;
 336
 337         LASSERT(sbi != NULL);
 338         LASSERT(mdc != NULL);
 339         LASSERT(osc != NULL);
 340
 341         /* Mount info */
 342         snprintf(name, MAX_STRING_SIZE, "fs%llu", mnt_instance);
 343
 344         mnt_instance++;
 345         sbi->ll_proc_root = lprocfs_register(name, parent, NULL, NULL);
 346         if (IS_ERR(sbi->ll_proc_root)) {
 347                 err = PTR_ERR(sbi->ll_proc_root);
 348                 sbi->ll_proc_root = NULL;
 349                 RETURN(err);
 350         }
 351
 352         entry = create_proc_entry("dump_page_cache", 0444, sbi->ll_proc_root);
 353         if (entry == NULL)
 354                 GOTO(out, err = -ENOMEM);
 355         entry->proc_fops = &llite_dump_pgcache_fops;
 356         entry->data = sbi;
 357
 358         svc_stats = lprocfs_alloc_stats(LPROC_LL_FILE_OPCODES);
 359         if (svc_stats == NULL) {
 360                 err = -ENOMEM;
 361                 goto out;
 362         }
 363         /* do counter init */
 364         for (id = 0; id < LPROC_LL_FILE_OPCODES; id++) {
 365                 __u32 type = llite_opcode_table[id].type;
 366                 void *ptr = NULL;
 367                 if (type & LPROCFS_TYPE_REGS)
 368                         ptr = "regs";
 369                 else {
 370                         if (type & LPROCFS_TYPE_BYTES)
 371                                 ptr = "bytes";
 372                         else {
 373                                 if (type & LPROCFS_TYPE_PAGES)
 374                                         ptr = "pages";
 375                         }
 376                 }
 377                 lprocfs_counter_init(svc_stats, llite_opcode_table[id].opcode,
 378                                      (type & LPROCFS_CNTR_AVGMINMAX),
 379                                      llite_opcode_table[id].opname, ptr);
 380         }
 381         err = lprocfs_register_stats(sbi->ll_proc_root, "stats", svc_stats);
 382         if (err)
 383                 goto out;
 384         else
 385                 sbi->ll_stats = svc_stats;
 386         /* need place to keep svc_stats */
 387
 388         /* Static configuration info */
 389         err = lprocfs_add_vars(sbi->ll_proc_root, lprocfs_obd_vars, sb);
 390         if (err)
 391                 goto out;
 392
 393         /* MDC info */
 394         obd = class_name2obd(mdc);
 395
 396         LASSERT(obd != NULL);
 397         LASSERT(obd->obd_type != NULL);
 398         LASSERT(obd->obd_type->typ_name != NULL);
 399
 400         snprintf(name, MAX_STRING_SIZE, "%s/common_name",
 401                  obd->obd_type->typ_name);
 402         lvars[0].read_fptr = lprocfs_rd_name;
 403         err = lprocfs_add_vars(sbi->ll_proc_root, lvars, obd);
 404         if (err)
 405                 goto out;
 406
 407         snprintf(name, MAX_STRING_SIZE, "%s/uuid", obd->obd_type->typ_name);
 408         lvars[0].read_fptr = lprocfs_rd_uuid;
 409         err = lprocfs_add_vars(sbi->ll_proc_root, lvars, obd);
 410         if (err)
 411                 goto out;
 412
 413         /* OSC */
 414         obd = class_name2obd(osc);
 415
 416         LASSERT(obd != NULL);
 417         LASSERT(obd->obd_type != NULL);
 418         LASSERT(obd->obd_type->typ_name != NULL);
 419
 420         snprintf(name, MAX_STRING_SIZE, "%s/common_name",
 421                  obd->obd_type->typ_name);
 422         lvars[0].read_fptr = lprocfs_rd_name;
 423         err = lprocfs_add_vars(sbi->ll_proc_root, lvars, obd);
 424         if (err)
 425                 goto out;
 426
 427         snprintf(name, MAX_STRING_SIZE, "%s/uuid", obd->obd_type->typ_name);
 428         lvars[0].read_fptr = lprocfs_rd_uuid;
 429         err = lprocfs_add_vars(sbi->ll_proc_root, lvars, obd);
 430 out:
 431         if (err) {
 432                 if (svc_stats)
 433                         lprocfs_free_stats(svc_stats);
 434                 if (sbi->ll_proc_root)
 435                         lprocfs_remove(sbi->ll_proc_root);
 436         }
 437         RETURN(err);
 438 }
 439
 440 void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi)
 441 {
 442         if (sbi->ll_proc_root) {
 443                 struct proc_dir_entry *file_stats =
 444                         lprocfs_srch(sbi->ll_proc_root, "stats");
 445
 446                 if (file_stats) {
 447                         lprocfs_free_stats(sbi->ll_stats);
 448                         lprocfs_remove(file_stats);
 449                 }
 450         }
 451 }
 452 #undef MAX_STRING_SIZE
 453
 454 static struct ll_async_page *llite_pglist_next_llap(struct ll_sb_info *sbi,
 455                                                     struct list_head *list)
 456 {
 457         struct ll_async_page *llap;
 458         struct list_head *pos;
 459
 460         list_for_each(pos, list) {
 461                 if (pos == &sbi->ll_pglist)
 462                         return NULL;
 463                 llap = list_entry(pos, struct ll_async_page, llap_proc_item);
 464                 if (llap->llap_page == NULL)
 465                         continue;
 466                 return llap;
 467         }
 468         LBUG();
 469         return NULL;
 470 }
 471
 472 #define seq_page_flag(seq, page, flag, has_flags) do {                  \
 473                 if (test_bit(PG_##flag, &(page)->flags)) {              \
 474                         if (!has_flags)                                 \
 475                                 has_flags = 1;                          \
 476                         else                                            \
 477                                 seq_putc(seq, '|');                     \
 478                         seq_puts(seq, #flag);                           \
 479                 }                                                       \
 480         } while(0);
 481
 482 static int llite_dump_pgcache_seq_show(struct seq_file *seq, void *v)
 483 {
 484         struct ll_async_page *llap, *dummy_llap = seq->private;
 485         struct ll_sb_info *sbi = dummy_llap->llap_cookie;
 486
 487         /* 2.4 doesn't seem to have SEQ_START_TOKEN, so we implement
 488          * it in our own state */
 489         if (dummy_llap->llap_magic == 0) {
 490                 seq_printf(seq, "generation | llap .cookie | page ");
 491                 seq_printf(seq, "inode .index [ page flags ]\n");
 492                 return 0;
 493         }
 494
 495         spin_lock(&sbi->ll_lock);
 496
 497         llap = llite_pglist_next_llap(sbi, &dummy_llap->llap_proc_item);
 498         if (llap != NULL)  {
 499                 int has_flags = 0;
 500                 struct page *page = llap->llap_page;
 501
 502                 seq_printf(seq, "%lu | %p %p | %p %p %lu [",
 503                                 sbi->ll_pglist_gen,
 504                                 llap, llap->llap_cookie,
 505                                 page, page->mapping->host, page->index);
 506                 seq_page_flag(seq, page, locked, has_flags);
 507                 seq_page_flag(seq, page, error, has_flags);
 508                 seq_page_flag(seq, page, referenced, has_flags);
 509                 seq_page_flag(seq, page, uptodate, has_flags);
 510                 seq_page_flag(seq, page, dirty, has_flags);
 511                 seq_page_flag(seq, page, highmem, has_flags);
 512                 if (!has_flags)
 513                         seq_puts(seq, "-]\n");
 514                 else
 515                         seq_puts(seq, "]\n");
 516         }
 517
 518         spin_unlock(&sbi->ll_lock);
 519
 520         return 0;
 521 }
 522
 523 static void *llite_dump_pgcache_seq_start(struct seq_file *seq, loff_t *pos)
 524 {
 525         struct ll_async_page *llap = seq->private;
 526
 527         if (llap->llap_magic == 2)
 528                 return NULL;
 529
 530         return (void *)1;
 531 }
 532
 533 static void *llite_dump_pgcache_seq_next(struct seq_file *seq, void *v,
 534                                          loff_t *pos)
 535 {
 536         struct ll_async_page *llap, *dummy_llap = seq->private;
 537         struct ll_sb_info *sbi = dummy_llap->llap_cookie;
 538
 539         /* bail if we just displayed the banner */
 540         if (dummy_llap->llap_magic == 0) {
 541                 dummy_llap->llap_magic = 1;
 542                 return dummy_llap;
 543         }
 544
 545         /* we've just displayed the llap that is after us in the list.
 546          * we advance to a position beyond it, returning null if there
 547          * isn't another llap in the list beyond that new position. */
 548         spin_lock(&sbi->ll_lock);
 549         llap = llite_pglist_next_llap(sbi, &dummy_llap->llap_proc_item);
 550         list_del_init(&dummy_llap->llap_proc_item);
 551         if (llap) {
 552                 list_add(&dummy_llap->llap_proc_item, &llap->llap_proc_item);
 553                 llap = llite_pglist_next_llap(sbi, &dummy_llap->llap_proc_item);
 554         }
 555         spin_unlock(&sbi->ll_lock);
 556
 557         ++*pos;
 558         if (llap == NULL) {
 559                 dummy_llap->llap_magic = 2;
 560                 return NULL;
 561         }
 562         return dummy_llap;
 563 }
 564
 565 static void llite_dump_pgcache_seq_stop(struct seq_file *seq, void *v)
 566 {
 567 }
 568
 569 struct seq_operations llite_dump_pgcache_seq_sops = {
 570         .start = llite_dump_pgcache_seq_start,
 571         .stop = llite_dump_pgcache_seq_stop,
 572         .next = llite_dump_pgcache_seq_next,
 573         .show = llite_dump_pgcache_seq_show,
 574 };
 575
 576 /* we're displaying llaps in a list_head list.  we don't want to hold a lock
 577  * while we walk the entire list, and we don't want to have to seek into
 578  * the right position in the list as an app advances with many syscalls.  we
 579  * allocate a dummy llap and hang it off file->private.  its position in
 580  * the list records where the app is currently displaying.  this way our
 581  * seq .start and .stop don't actually do anything.  .next returns null
 582  * when the dummy hits the end of the list which eventually leads to .release
 583  * where we tear down.  this kind of displaying is super-racey, so we put
 584  * a generation counter on the list so the output shows when the list
 585  * changes between reads.
 586  */
 587 static int llite_dump_pgcache_seq_open(struct inode *inode, struct file *file)
 588 {
 589         struct proc_dir_entry *dp = PDE(inode);
 590         struct ll_async_page *llap;
 591         struct seq_file *seq;
 592         struct ll_sb_info *sbi = dp->data;
 593         int rc;
 594
 595         OBD_ALLOC_GFP(llap, sizeof(*llap), GFP_KERNEL);
 596         if (llap == NULL)
 597                 return -ENOMEM;
 598         llap->llap_page = NULL;
 599         llap->llap_cookie = sbi;
 600         llap->llap_magic = 0;
 601
 602         rc = seq_open(file, &llite_dump_pgcache_seq_sops);
 603         if (rc) {
 604                 OBD_FREE(llap, sizeof(*llap));
 605                 return rc;
 606         }
 607         seq = file->private_data;
 608         seq->private = llap;
 609
 610         spin_lock(&sbi->ll_lock);
 611         list_add(&llap->llap_proc_item, &sbi->ll_pglist);
 612         spin_unlock(&sbi->ll_lock);
 613
 614         return 0;
 615 }
 616
 617 static int llite_dump_pgcache_seq_release(struct inode *inode,
 618                                           struct file *file)
 619 {
 620         struct seq_file *seq = file->private_data;
 621         struct ll_async_page *llap = seq->private;
 622         struct ll_sb_info *sbi = llap->llap_cookie;
 623
 624         spin_lock(&sbi->ll_lock);
 625         if (!list_empty(&llap->llap_proc_item))
 626                 list_del_init(&llap->llap_proc_item);
 627         spin_unlock(&sbi->ll_lock);
 628         OBD_FREE(llap, sizeof(*llap));
 629
 630         return seq_release(inode, file);
 631 }
 632
 633 struct file_operations llite_dump_pgcache_fops = {
 634         .owner   = THIS_MODULE,
 635         .open    = llite_dump_pgcache_seq_open,
 636         .read    = seq_read,
 637         .release = llite_dump_pgcache_seq_release,
 638 };
 639
 640 #endif /* LPROCFS */