lustre/llite/llite_internal.h

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 only,
  10  * as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License version 2 for more details (a copy is included
  16  * in the LICENSE file that accompanied this code).
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * version 2 along with this program; If not, see
  20  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  21  *
  22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  23  * CA 95054 USA or visit www.sun.com if you need additional information or
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright  2008 Sun Microsystems, Inc. All rights reserved
  30  * Use is subject to license terms.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  */
  36
  37 #ifndef LLITE_INTERNAL_H
  38 #define LLITE_INTERNAL_H
  39
  40 #include <lustre_acl.h>
  41
  42 #include <lustre_debug.h>
  43 #include <lustre_ver.h>
  44 #include <lustre_disk.h>  /* for s2sbi */
  45 #include <lustre_eacl.h>
  46
  47 /* for struct cl_lock_descr and struct cl_io */
  48 #include <cl_object.h>
  49 #include <lclient.h>
  50
  51 #ifndef FMODE_EXEC
  52 #define FMODE_EXEC 0
  53 #endif
  54
  55 #ifndef DCACHE_LUSTRE_INVALID
  56 #define DCACHE_LUSTRE_INVALID 0x100
  57 #endif
  58
  59 #define LL_IT2STR(it) ((it) ? ldlm_it2str((it)->it_op) : "0")
  60 #define LUSTRE_FPRIVATE(file) ((file)->private_data)
  61
  62 #ifdef HAVE_VFS_INTENT_PATCHES
  63 static inline struct lookup_intent *ll_nd2it(struct nameidata *nd)
  64 {
  65         return &nd->intent;
  66 }
  67 #endif
  68
  69 struct ll_dentry_data {
  70         int                      lld_cwd_count;
  71         int                      lld_mnt_count;
  72         struct obd_client_handle lld_cwd_och;
  73         struct obd_client_handle lld_mnt_och;
  74 #ifndef HAVE_VFS_INTENT_PATCHES
  75         struct lookup_intent    *lld_it;
  76 #endif
  77         unsigned int             lld_sa_generation;
  78 };
  79
  80 #define ll_d2d(de) ((struct ll_dentry_data*)((de)->d_fsdata))
  81
  82 extern struct file_operations ll_pgcache_seq_fops;
  83
  84 #define LLI_INODE_MAGIC                 0x111d0de5
  85 #define LLI_INODE_DEAD                  0xdeadd00d
  86
  87 /* remote client permission cache */
  88 #define REMOTE_PERM_HASHSIZE 16
  89
  90 /* llite setxid/access permission for user on remote client */
  91 struct ll_remote_perm {
  92         cfs_hlist_node_t        lrp_list;
  93         uid_t                   lrp_uid;
  94         gid_t                   lrp_gid;
  95         uid_t                   lrp_fsuid;
  96         gid_t                   lrp_fsgid;
  97         int                     lrp_access_perm; /* MAY_READ/WRITE/EXEC, this
  98                                                     is access permission with
  99                                                     lrp_fsuid/lrp_fsgid. */
 100 };
 101
 102 enum lli_flags {
 103         /* MDS has an authority for the Size-on-MDS attributes. */
 104         LLIF_MDS_SIZE_LOCK      = (1 << 0),
 105         /* Epoch close is postponed. */
 106         LLIF_EPOCH_PENDING      = (1 << 1),
 107         /* DONE WRITING is allowed. */
 108         LLIF_DONE_WRITING       = (1 << 2),
 109         /* Sizeon-on-MDS attributes are changed. An attribute update needs to
 110          * be sent to MDS. */
 111         LLIF_SOM_DIRTY          = (1 << 3),
 112         /* File is contented */
 113         LLIF_CONTENDED         = (1 << 4),
 114         /* Truncate uses server lock for this file */
 115         LLIF_SRVLOCK           = (1 << 5)
 116
 117 };
 118
 119 struct ll_inode_info {
 120         int                     lli_inode_magic;
 121         cfs_semaphore_t         lli_size_sem;           /* protect open and change size */
 122         void                   *lli_size_sem_owner;
 123         cfs_semaphore_t         lli_write_sem;
 124         cfs_semaphore_t         lli_trunc_sem;
 125         char                   *lli_symlink_name;
 126         __u64                   lli_maxbytes;
 127         __u64                   lli_ioepoch;
 128         unsigned long           lli_flags;
 129         cfs_time_t              lli_contention_time;
 130
 131         /* this lock protects posix_acl, pending_write_llaps, mmap_cnt */
 132         cfs_spinlock_t          lli_lock;
 133         cfs_list_t              lli_close_list;
 134         /* handle is to be sent to MDS later on done_writing and setattr.
 135          * Open handle data are needed for the recovery to reconstruct
 136          * the inode state on the MDS. XXX: recovery is not ready yet. */
 137         struct obd_client_handle *lli_pending_och;
 138
 139         /* for writepage() only to communicate to fsync */
 140         int                     lli_async_rc;
 141
 142         struct posix_acl       *lli_posix_acl;
 143
 144         /* remote permission hash */
 145         cfs_hlist_head_t       *lli_remote_perms;
 146         unsigned long           lli_rmtperm_utime;
 147         cfs_semaphore_t         lli_rmtperm_sem;
 148
 149         cfs_list_t              lli_dead_list;
 150
 151         cfs_semaphore_t         lli_och_sem; /* Protects access to och pointers
 152                                                 and their usage counters, also
 153                                                 atomicity of check-update of
 154                                                 lli_smd */
 155         /* We need all three because every inode may be opened in different
 156            modes */
 157         struct obd_client_handle *lli_mds_read_och;
 158         __u64                   lli_open_fd_read_count;
 159         struct obd_client_handle *lli_mds_write_och;
 160         __u64                   lli_open_fd_write_count;
 161         struct obd_client_handle *lli_mds_exec_och;
 162         __u64                   lli_open_fd_exec_count;
 163
 164         struct inode            lli_vfs_inode;
 165
 166         /* identifying fields for both metadata and data stacks. */
 167         struct lu_fid           lli_fid;
 168         struct lov_stripe_md   *lli_smd;
 169
 170         /* fid capability */
 171         /* open count currently used by capability only, indicate whether
 172          * capability needs renewal */
 173         cfs_atomic_t            lli_open_count;
 174         struct obd_capa        *lli_mds_capa;
 175         cfs_list_t              lli_oss_capas;
 176
 177         /* metadata stat-ahead */
 178         /*
 179          * "opendir_pid" is the token when lookup/revalid -- I am the owner of
 180          * dir statahead.
 181          */
 182         pid_t                   lli_opendir_pid;
 183         /*
 184          * since parent-child threads can share the same @file struct,
 185          * "opendir_key" is the token when dir close for case of parent exit
 186          * before child -- it is me should cleanup the dir readahead. */
 187         void                   *lli_opendir_key;
 188         struct ll_statahead_info *lli_sai;
 189         struct cl_object       *lli_clob;
 190 };
 191
 192 /*
 193  * Locking to guarantee consistency of non-atomic updates to long long i_size,
 194  * consistency between file size and KMS, and consistency within
 195  * ->lli_smd->lsm_oinfo[]'s.
 196  *
 197  * Implemented by ->lli_size_sem and ->lsm_sem, nested in that order.
 198  */
 199
 200 void ll_inode_size_lock(struct inode *inode, int lock_lsm);
 201 void ll_inode_size_unlock(struct inode *inode, int unlock_lsm);
 202
 203 // FIXME: replace the name of this with LL_I to conform to kernel stuff
 204 // static inline struct ll_inode_info *LL_I(struct inode *inode)
 205 static inline struct ll_inode_info *ll_i2info(struct inode *inode)
 206 {
 207         return container_of(inode, struct ll_inode_info, lli_vfs_inode);
 208 }
 209
 210 /* default to about 40meg of readahead on a given system.  That much tied
 211  * up in 512k readahead requests serviced at 40ms each is about 1GB/s. */
 212 #define SBI_DEFAULT_READAHEAD_MAX (40UL << (20 - CFS_PAGE_SHIFT))
 213
 214 /* default to read-ahead full files smaller than 2MB on the second read */
 215 #define SBI_DEFAULT_READAHEAD_WHOLE_MAX (2UL << (20 - CFS_PAGE_SHIFT))
 216
 217 enum ra_stat {
 218         RA_STAT_HIT = 0,
 219         RA_STAT_MISS,
 220         RA_STAT_DISTANT_READPAGE,
 221         RA_STAT_MISS_IN_WINDOW,
 222         RA_STAT_FAILED_GRAB_PAGE,
 223         RA_STAT_FAILED_MATCH,
 224         RA_STAT_DISCARDED,
 225         RA_STAT_ZERO_LEN,
 226         RA_STAT_ZERO_WINDOW,
 227         RA_STAT_EOF,
 228         RA_STAT_MAX_IN_FLIGHT,
 229         RA_STAT_WRONG_GRAB_PAGE,
 230         _NR_RA_STAT,
 231 };
 232
 233 struct ll_ra_info {
 234         cfs_atomic_t              ra_cur_pages;
 235         unsigned long             ra_max_pages;
 236         unsigned long             ra_max_pages_per_file;
 237         unsigned long             ra_max_read_ahead_whole_pages;
 238 };
 239
 240 /* ra_io_arg will be filled in the beginning of ll_readahead with
 241  * ras_lock, then the following ll_read_ahead_pages will read RA
 242  * pages according to this arg, all the items in this structure are
 243  * counted by page index.
 244  */
 245 struct ra_io_arg {
 246         unsigned long ria_start;  /* start offset of read-ahead*/
 247         unsigned long ria_end;    /* end offset of read-ahead*/
 248         /* If stride read pattern is detected, ria_stoff means where
 249          * stride read is started. Note: for normal read-ahead, the
 250          * value here is meaningless, and also it will not be accessed*/
 251         pgoff_t ria_stoff;
 252         /* ria_length and ria_pages are the length and pages length in the
 253          * stride I/O mode. And they will also be used to check whether
 254          * it is stride I/O read-ahead in the read-ahead pages*/
 255         unsigned long ria_length;
 256         unsigned long ria_pages;
 257 };
 258
 259 /* LL_HIST_MAX=32 causes an overflow */
 260 #define LL_HIST_MAX 28
 261 #define LL_HIST_START 12 /* buckets start at 2^12 = 4k */
 262 #define LL_PROCESS_HIST_MAX 10
 263 struct per_process_info {
 264         pid_t pid;
 265         struct obd_histogram pp_r_hist;
 266         struct obd_histogram pp_w_hist;
 267 };
 268
 269 /* pp_extents[LL_PROCESS_HIST_MAX] will hold the combined process info */
 270 struct ll_rw_extents_info {
 271         struct per_process_info pp_extents[LL_PROCESS_HIST_MAX + 1];
 272 };
 273
 274 #define LL_OFFSET_HIST_MAX 100
 275 struct ll_rw_process_info {
 276         pid_t                     rw_pid;
 277         int                       rw_op;
 278         loff_t                    rw_range_start;
 279         loff_t                    rw_range_end;
 280         loff_t                    rw_last_file_pos;
 281         loff_t                    rw_offset;
 282         size_t                    rw_smallest_extent;
 283         size_t                    rw_largest_extent;
 284         struct ll_file_data      *rw_last_file;
 285 };
 286
 287 enum stats_track_type {
 288         STATS_TRACK_ALL = 0,  /* track all processes */
 289         STATS_TRACK_PID,      /* track process with this pid */
 290         STATS_TRACK_PPID,     /* track processes with this ppid */
 291         STATS_TRACK_GID,      /* track processes with this gid */
 292         STATS_TRACK_LAST,
 293 };
 294
 295 /* flags for sbi->ll_flags */
 296 #define LL_SBI_NOLCK             0x01 /* DLM locking disabled (directio-only) */
 297 #define LL_SBI_CHECKSUM          0x02 /* checksum each page as it's written */
 298 #define LL_SBI_FLOCK             0x04
 299 #define LL_SBI_USER_XATTR        0x08 /* support user xattr */
 300 #define LL_SBI_ACL               0x10 /* support ACL */
 301 #define LL_SBI_RMT_CLIENT        0x40 /* remote client */
 302 #define LL_SBI_MDS_CAPA          0x80 /* support mds capa */
 303 #define LL_SBI_OSS_CAPA         0x100 /* support oss capa */
 304 #define LL_SBI_LOCALFLOCK       0x200 /* Local flocks support by kernel */
 305 #define LL_SBI_LRU_RESIZE       0x400 /* lru resize support */
 306 #define LL_SBI_LAZYSTATFS       0x800 /* lazystatfs mount option */
 307
 308 /* default value for ll_sb_info->contention_time */
 309 #define SBI_DEFAULT_CONTENTION_SECONDS     60
 310 /* default value for lockless_truncate_enable */
 311 #define SBI_DEFAULT_LOCKLESS_TRUNCATE_ENABLE 1
 312 #define RCE_HASHES      32
 313
 314 struct rmtacl_ctl_entry {
 315         cfs_list_t       rce_list;
 316         pid_t            rce_key; /* hash key */
 317         int              rce_ops; /* acl operation type */
 318 };
 319
 320 struct rmtacl_ctl_table {
 321         cfs_spinlock_t   rct_lock;
 322         cfs_list_t       rct_entries[RCE_HASHES];
 323 };
 324
 325 #define EE_HASHES       32
 326
 327 struct eacl_entry {
 328         cfs_list_t            ee_list;
 329         pid_t                 ee_key; /* hash key */
 330         struct lu_fid         ee_fid;
 331         int                   ee_type; /* ACL type for ACCESS or DEFAULT */
 332         ext_acl_xattr_header *ee_acl;
 333 };
 334
 335 struct eacl_table {
 336         cfs_spinlock_t   et_lock;
 337         cfs_list_t       et_entries[EE_HASHES];
 338 };
 339
 340 struct ll_sb_info {
 341         cfs_list_t                ll_list;
 342         /* this protects pglist and ra_info.  It isn't safe to
 343          * grab from interrupt contexts */
 344         cfs_spinlock_t            ll_lock;
 345         cfs_spinlock_t            ll_pp_extent_lock; /* Lock for pp_extent entries */
 346         cfs_spinlock_t            ll_process_lock; /* Lock for ll_rw_process_info */
 347         struct obd_uuid           ll_sb_uuid;
 348         struct obd_export        *ll_md_exp;
 349         struct obd_export        *ll_dt_exp;
 350         struct proc_dir_entry*    ll_proc_root;
 351         struct lu_fid             ll_root_fid; /* root object fid */
 352
 353         int                       ll_flags;
 354         cfs_list_t                ll_conn_chain; /* per-conn chain of SBs */
 355         struct lustre_client_ocd  ll_lco;
 356
 357         cfs_list_t                ll_orphan_dentry_list; /*please don't ask -p*/
 358         struct ll_close_queue    *ll_lcq;
 359
 360         struct lprocfs_stats     *ll_stats; /* lprocfs stats counter */
 361
 362         unsigned long             ll_async_page_max;
 363         unsigned long             ll_async_page_count;
 364
 365         struct lprocfs_stats     *ll_ra_stats;
 366
 367         struct ll_ra_info         ll_ra_info;
 368         unsigned int              ll_namelen;
 369         struct file_operations   *ll_fop;
 370
 371 #ifdef HAVE_EXPORT___IGET
 372         cfs_list_t                ll_deathrow;/*inodes to be destroyed (b1443)*/
 373         cfs_spinlock_t            ll_deathrow_lock;
 374 #endif
 375         /* =0 - hold lock over whole read/write
 376          * >0 - max. chunk to be read/written w/o lock re-acquiring */
 377         unsigned long             ll_max_rw_chunk;
 378
 379         struct lu_site           *ll_site;
 380         struct cl_device         *ll_cl;
 381         /* Statistics */
 382         struct ll_rw_extents_info ll_rw_extents_info;
 383         int                       ll_extent_process_count;
 384         struct ll_rw_process_info ll_rw_process_info[LL_PROCESS_HIST_MAX];
 385         unsigned int              ll_offset_process_count;
 386         struct ll_rw_process_info ll_rw_offset_info[LL_OFFSET_HIST_MAX];
 387         unsigned int              ll_rw_offset_entry_count;
 388         enum stats_track_type     ll_stats_track_type;
 389         int                       ll_stats_track_id;
 390         int                       ll_rw_stats_on;
 391
 392         /* metadata stat-ahead */
 393         unsigned int              ll_sa_max;     /* max statahead RPCs */
 394         atomic_t                  ll_sa_total;   /* statahead thread started
 395                                                   * count */
 396         atomic_t                  ll_sa_wrong;   /* statahead thread stopped for
 397                                                   * low hit ratio */
 398
 399         dev_t                     ll_sdev_orig; /* save s_dev before assign for
 400                                                  * clustred nfs */
 401         struct rmtacl_ctl_table   ll_rct;
 402         struct eacl_table         ll_et;
 403 };
 404
 405 #define LL_DEFAULT_MAX_RW_CHUNK      (32 * 1024 * 1024)
 406
 407 struct ll_ra_read {
 408         pgoff_t             lrr_start;
 409         pgoff_t             lrr_count;
 410         struct task_struct *lrr_reader;
 411         cfs_list_t          lrr_linkage;
 412 };
 413
 414 /*
 415  * per file-descriptor read-ahead data.
 416  */
 417 struct ll_readahead_state {
 418         cfs_spinlock_t  ras_lock;
 419         /*
 420          * index of the last page that read(2) needed and that wasn't in the
 421          * cache. Used by ras_update() to detect seeks.
 422          *
 423          * XXX nikita: if access seeks into cached region, Lustre doesn't see
 424          * this.
 425          */
 426         unsigned long   ras_last_readpage;
 427         /*
 428          * number of pages read after last read-ahead window reset. As window
 429          * is reset on each seek, this is effectively a number of consecutive
 430          * accesses. Maybe ->ras_accessed_in_window is better name.
 431          *
 432          * XXX nikita: window is also reset (by ras_update()) when Lustre
 433          * believes that memory pressure evicts read-ahead pages. In that
 434          * case, it probably doesn't make sense to expand window to
 435          * PTLRPC_MAX_BRW_PAGES on the third access.
 436          */
 437         unsigned long   ras_consecutive_pages;
 438         /*
 439          * number of read requests after the last read-ahead window reset
 440          * As window is reset on each seek, this is effectively the number
 441          * on consecutive read request and is used to trigger read-ahead.
 442          */
 443         unsigned long   ras_consecutive_requests;
 444         /*
 445          * Parameters of current read-ahead window. Handled by
 446          * ras_update(). On the initial access to the file or after a seek,
 447          * window is reset to 0. After 3 consecutive accesses, window is
 448          * expanded to PTLRPC_MAX_BRW_PAGES. Afterwards, window is enlarged by
 449          * PTLRPC_MAX_BRW_PAGES chunks up to ->ra_max_pages.
 450          */
 451         unsigned long   ras_window_start, ras_window_len;
 452         /*
 453          * Where next read-ahead should start at. This lies within read-ahead
 454          * window. Read-ahead window is read in pieces rather than at once
 455          * because: 1. lustre limits total number of pages under read-ahead by
 456          * ->ra_max_pages (see ll_ra_count_get()), 2. client cannot read pages
 457          * not covered by DLM lock.
 458          */
 459         unsigned long   ras_next_readahead;
 460         /*
 461          * Total number of ll_file_read requests issued, reads originating
 462          * due to mmap are not counted in this total.  This value is used to
 463          * trigger full file read-ahead after multiple reads to a small file.
 464          */
 465         unsigned long   ras_requests;
 466         /*
 467          * Page index with respect to the current request, these value
 468          * will not be accurate when dealing with reads issued via mmap.
 469          */
 470         unsigned long   ras_request_index;
 471         /*
 472          * list of struct ll_ra_read's one per read(2) call current in
 473          * progress against this file descriptor. Used by read-ahead code,
 474          * protected by ->ras_lock.
 475          */
 476         cfs_list_t      ras_read_beads;
 477         /*
 478          * The following 3 items are used for detecting the stride I/O
 479          * mode.
 480          * In stride I/O mode,
 481          * ...............|-----data-----|****gap*****|--------|******|....
 482          *    offset      |-stride_pages-|-stride_gap-|
 483          * ras_stride_offset = offset;
 484          * ras_stride_length = stride_pages + stride_gap;
 485          * ras_stride_pages = stride_pages;
 486          * Note: all these three items are counted by pages.
 487          */
 488         unsigned long   ras_stride_length;
 489         unsigned long   ras_stride_pages;
 490         pgoff_t         ras_stride_offset;
 491         /*
 492          * number of consecutive stride request count, and it is similar as
 493          * ras_consecutive_requests, but used for stride I/O mode.
 494          * Note: only more than 2 consecutive stride request are detected,
 495          * stride read-ahead will be enable
 496          */
 497         unsigned long   ras_consecutive_stride_requests;
 498 };
 499
 500 struct ll_file_dir {
 501 };
 502
 503 extern cfs_mem_cache_t *ll_file_data_slab;
 504 struct lustre_handle;
 505 struct ll_file_data {
 506         struct ll_readahead_state fd_ras;
 507         int fd_omode;
 508         struct ccc_grouplock fd_grouplock;
 509         struct ll_file_dir fd_dir;
 510         __u32 fd_flags;
 511         struct file *fd_file;
 512 };
 513
 514 struct lov_stripe_md;
 515
 516 extern cfs_spinlock_t inode_lock;
 517
 518 extern struct proc_dir_entry *proc_lustre_fs_root;
 519
 520 static inline struct inode *ll_info2i(struct ll_inode_info *lli)
 521 {
 522         return &lli->lli_vfs_inode;
 523 }
 524
 525 struct it_cb_data {
 526         struct inode *icbd_parent;
 527         struct dentry **icbd_childp;
 528         obd_id hash;
 529 };
 530
 531 __u32 ll_i2suppgid(struct inode *i);
 532 void ll_i2gids(__u32 *suppgids, struct inode *i1,struct inode *i2);
 533
 534 #define LLAP_MAGIC 98764321
 535
 536 extern cfs_mem_cache_t *ll_async_page_slab;
 537 extern size_t ll_async_page_slab_size;
 538
 539 void ll_ra_read_in(struct file *f, struct ll_ra_read *rar);
 540 void ll_ra_read_ex(struct file *f, struct ll_ra_read *rar);
 541 struct ll_ra_read *ll_ra_read_get(struct file *f);
 542
 543 /* llite/lproc_llite.c */
 544 #ifdef LPROCFS
 545 int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
 546                                 struct super_block *sb, char *osc, char *mdc);
 547 void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi);
 548 void ll_stats_ops_tally(struct ll_sb_info *sbi, int op, int count);
 549 void lprocfs_llite_init_vars(struct lprocfs_static_vars *lvars);
 550 #else
 551 static inline int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
 552                         struct super_block *sb, char *osc, char *mdc){return 0;}
 553 static inline void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi) {}
 554 static void ll_stats_ops_tally(struct ll_sb_info *sbi, int op, int count) {}
 555 static void lprocfs_llite_init_vars(struct lprocfs_static_vars *lvars)
 556 {
 557         memset(lvars, 0, sizeof(*lvars));
 558 }
 559 #endif
 560
 561
 562 /* llite/dir.c */
 563 static inline void ll_put_page(struct page *page)
 564 {
 565         kunmap(page);
 566         page_cache_release(page);
 567 }
 568
 569 extern struct file_operations ll_dir_operations;
 570 extern struct inode_operations ll_dir_inode_operations;
 571 struct page *ll_get_dir_page(struct inode *dir, __u64 hash, int exact,
 572                              struct ll_dir_chain *chain);
 573
 574 int ll_get_mdt_idx(struct inode *inode);
 575 /* llite/namei.c */
 576 int ll_objects_destroy(struct ptlrpc_request *request,
 577                        struct inode *dir);
 578 struct inode *ll_iget(struct super_block *sb, ino_t hash,
 579                       struct lustre_md *lic);
 580 int ll_md_blocking_ast(struct ldlm_lock *, struct ldlm_lock_desc *,
 581                        void *data, int flag);
 582 #ifndef HAVE_VFS_INTENT_PATCHES
 583 struct lookup_intent *ll_convert_intent(struct open_intent *oit,
 584                                         int lookup_flags);
 585 #endif
 586 void ll_lookup_it_alias(struct dentry **de, struct inode *inode, __u32 bits);
 587 int ll_lookup_it_finish(struct ptlrpc_request *request,
 588                         struct lookup_intent *it, void *data,
 589                         struct inode **alias);
 590
 591 /* llite/rw.c */
 592 int ll_prepare_write(struct file *, struct page *, unsigned from, unsigned to);
 593 int ll_commit_write(struct file *, struct page *, unsigned from, unsigned to);
 594 int ll_writepage(struct page *page, struct writeback_control *wbc);
 595 void ll_removepage(struct page *page);
 596 int ll_readpage(struct file *file, struct page *page);
 597 void ll_readahead_init(struct inode *inode, struct ll_readahead_state *ras);
 598 void ll_truncate(struct inode *inode);
 599 int ll_file_punch(struct inode *, loff_t, int);
 600 ssize_t ll_file_lockless_io(struct file *, char *, size_t, loff_t *, int);
 601 void ll_clear_file_contended(struct inode*);
 602 int ll_sync_page_range(struct inode *, struct address_space *, loff_t, size_t);
 603 int ll_readahead(const struct lu_env *env, struct cl_io *io, struct ll_readahead_state *ras,
 604                  struct address_space *mapping, struct cl_page_list *queue, int flags);
 605
 606 /* llite/file.c */
 607 extern struct file_operations ll_file_operations;
 608 extern struct file_operations ll_file_operations_flock;
 609 extern struct file_operations ll_file_operations_noflock;
 610 extern struct inode_operations ll_file_inode_operations;
 611 extern int ll_inode_revalidate_it(struct dentry *, struct lookup_intent *);
 612 extern int ll_have_md_lock(struct inode *inode, __u64 bits);
 613 extern ldlm_mode_t ll_take_md_lock(struct inode *inode, __u64 bits,
 614                                    struct lustre_handle *lockh);
 615 int __ll_inode_revalidate_it(struct dentry *, struct lookup_intent *,  __u64 bits);
 616 int ll_revalidate_nd(struct dentry *dentry, struct nameidata *nd);
 617 int ll_file_open(struct inode *inode, struct file *file);
 618 int ll_file_release(struct inode *inode, struct file *file);
 619 int ll_glimpse_ioctl(struct ll_sb_info *sbi,
 620                      struct lov_stripe_md *lsm, lstat_t *st);
 621 void ll_ioepoch_open(struct ll_inode_info *lli, __u64 ioepoch);
 622 int ll_local_open(struct file *file,
 623                   struct lookup_intent *it, struct ll_file_data *fd,
 624                   struct obd_client_handle *och);
 625 int ll_release_openhandle(struct dentry *, struct lookup_intent *);
 626 int ll_md_close(struct obd_export *md_exp, struct inode *inode,
 627                 struct file *file);
 628 int ll_md_real_close(struct inode *inode, int flags);
 629 void ll_ioepoch_close(struct inode *inode, struct md_op_data *op_data,
 630                       struct obd_client_handle **och, unsigned long flags);
 631 void ll_done_writing_attr(struct inode *inode, struct md_op_data *op_data);
 632 int ll_som_update(struct inode *inode, struct md_op_data *op_data);
 633 int ll_inode_getattr(struct inode *inode, struct obdo *obdo,
 634                      __u64 ioepoch, int sync);
 635 int ll_md_setattr(struct inode *inode, struct md_op_data *op_data,
 636                   struct md_open_data **mod);
 637 void ll_pack_inode2opdata(struct inode *inode, struct md_op_data *op_data,
 638                           struct lustre_handle *fh);
 639 extern void ll_rw_stats_tally(struct ll_sb_info *sbi, pid_t pid,
 640                               struct ll_file_data *file, loff_t pos,
 641                               size_t count, int rw);
 642 int ll_getattr_it(struct vfsmount *mnt, struct dentry *de,
 643                struct lookup_intent *it, struct kstat *stat);
 644 int ll_getattr(struct vfsmount *mnt, struct dentry *de, struct kstat *stat);
 645 struct ll_file_data *ll_file_data_get(void);
 646 #ifndef HAVE_INODE_PERMISION_2ARGS
 647 int ll_inode_permission(struct inode *inode, int mask, struct nameidata *nd);
 648 #else
 649 int ll_inode_permission(struct inode *inode, int mask);
 650 #endif
 651 int ll_lov_setstripe_ea_info(struct inode *inode, struct file *file,
 652                              int flags, struct lov_user_md *lum,
 653                              int lum_size);
 654 int ll_lov_getstripe_ea_info(struct inode *inode, const char *filename,
 655                              struct lov_mds_md **lmm, int *lmm_size,
 656                              struct ptlrpc_request **request);
 657 int ll_dir_setstripe(struct inode *inode, struct lov_user_md *lump,
 658                      int set_default);
 659 int ll_dir_getstripe(struct inode *inode, struct lov_mds_md **lmm,
 660                      int *lmm_size, struct ptlrpc_request **request);
 661 int ll_fsync(struct file *file, struct dentry *dentry, int data);
 662 int ll_do_fiemap(struct inode *inode, struct ll_user_fiemap *fiemap,
 663               int num_bytes);
 664 int ll_merge_lvb(struct inode *inode);
 665 int ll_get_grouplock(struct inode *inode, struct file *file, unsigned long arg);
 666 int ll_put_grouplock(struct inode *inode, struct file *file, unsigned long arg);
 667 int ll_fid2path(struct obd_export *exp, void *arg);
 668
 669 /* llite/dcache.c */
 670 /* llite/namei.c */
 671 /**
 672  * protect race ll_find_aliases vs ll_revalidate_it vs ll_unhash_aliases
 673  */
 674 extern cfs_spinlock_t ll_lookup_lock;
 675 extern struct dentry_operations ll_d_ops;
 676 void ll_intent_drop_lock(struct lookup_intent *);
 677 void ll_intent_release(struct lookup_intent *);
 678 int ll_drop_dentry(struct dentry *dentry);
 679 extern void ll_set_dd(struct dentry *de);
 680 int ll_drop_dentry(struct dentry *dentry);
 681 void ll_unhash_aliases(struct inode *);
 682 void ll_frob_intent(struct lookup_intent **itp, struct lookup_intent *deft);
 683 void ll_lookup_finish_locks(struct lookup_intent *it, struct dentry *dentry);
 684 int ll_dcompare(struct dentry *parent, struct qstr *d_name, struct qstr *name);
 685 int ll_revalidate_it_finish(struct ptlrpc_request *request,
 686                             struct lookup_intent *it, struct dentry *de);
 687
 688 /* llite/llite_lib.c */
 689 extern struct super_operations lustre_super_operations;
 690
 691 char *ll_read_opt(const char *opt, char *data);
 692 void ll_lli_init(struct ll_inode_info *lli);
 693 int ll_fill_super(struct super_block *sb);
 694 void ll_put_super(struct super_block *sb);
 695 void ll_kill_super(struct super_block *sb);
 696 int ll_shrink_cache(int nr_to_scan, gfp_t gfp_mask);
 697 struct inode *ll_inode_from_lock(struct ldlm_lock *lock);
 698 void ll_clear_inode(struct inode *inode);
 699 int ll_setattr_raw(struct inode *inode, struct iattr *attr);
 700 int ll_setattr(struct dentry *de, struct iattr *attr);
 701 #ifndef HAVE_STATFS_DENTRY_PARAM
 702 int ll_statfs(struct super_block *sb, struct kstatfs *sfs);
 703 #else
 704 int ll_statfs(struct dentry *de, struct kstatfs *sfs);
 705 #endif
 706 int ll_statfs_internal(struct super_block *sb, struct obd_statfs *osfs,
 707                        __u64 max_age, __u32 flags);
 708 void ll_update_inode(struct inode *inode, struct lustre_md *md);
 709 void ll_read_inode2(struct inode *inode, void *opaque);
 710 void ll_delete_inode(struct inode *inode);
 711 int ll_iocontrol(struct inode *inode, struct file *file,
 712                  unsigned int cmd, unsigned long arg);
 713 int ll_flush_ctx(struct inode *inode);
 714 #ifdef HAVE_UMOUNTBEGIN_VFSMOUNT
 715 void ll_umount_begin(struct vfsmount *vfsmnt, int flags);
 716 #else
 717 void ll_umount_begin(struct super_block *sb);
 718 #endif
 719 int ll_remount_fs(struct super_block *sb, int *flags, char *data);
 720 int ll_show_options(struct seq_file *seq, struct vfsmount *vfs);
 721 int ll_prep_inode(struct inode **inode, struct ptlrpc_request *req,
 722                   struct super_block *);
 723 void lustre_dump_dentry(struct dentry *, int recur);
 724 void lustre_dump_inode(struct inode *);
 725 int ll_obd_statfs(struct inode *inode, void *arg);
 726 int ll_get_max_mdsize(struct ll_sb_info *sbi, int *max_mdsize);
 727 int ll_process_config(struct lustre_cfg *lcfg);
 728 struct md_op_data *ll_prep_md_op_data(struct md_op_data *op_data,
 729                                       struct inode *i1, struct inode *i2,
 730                                       const char *name, int namelen,
 731                                       int mode, __u32 opc, void *data);
 732 void ll_finish_md_op_data(struct md_op_data *op_data);
 733
 734 /* llite/llite_nfs.c */
 735 extern struct export_operations lustre_export_operations;
 736 __u32 get_uuid2int(const char *name, int len);
 737
 738 /* llite/special.c */
 739 extern struct inode_operations ll_special_inode_operations;
 740 extern struct file_operations ll_special_chr_inode_fops;
 741 extern struct file_operations ll_special_chr_file_fops;
 742 extern struct file_operations ll_special_blk_inode_fops;
 743 extern struct file_operations ll_special_fifo_inode_fops;
 744 extern struct file_operations ll_special_fifo_file_fops;
 745 extern struct file_operations ll_special_sock_inode_fops;
 746
 747 /* llite/symlink.c */
 748 extern struct inode_operations ll_fast_symlink_inode_operations;
 749
 750 /* llite/llite_close.c */
 751 struct ll_close_queue {
 752         cfs_spinlock_t          lcq_lock;
 753         cfs_list_t              lcq_head;
 754         cfs_waitq_t             lcq_waitq;
 755         cfs_completion_t        lcq_comp;
 756         cfs_atomic_t            lcq_stop;
 757 };
 758
 759 struct ccc_object *cl_inode2ccc(struct inode *inode);
 760
 761
 762 void vvp_write_pending (struct ccc_object *club, struct ccc_page *page);
 763 void vvp_write_complete(struct ccc_object *club, struct ccc_page *page);
 764
 765 /* specific achitecture can implement only part of this list */
 766 enum vvp_io_subtype {
 767         /** normal IO */
 768         IO_NORMAL,
 769         /** io called from .sendfile */
 770         IO_SENDFILE,
 771         /** io started from splice_{read|write} */
 772         IO_SPLICE
 773 };
 774
 775 /* IO subtypes */
 776 struct vvp_io {
 777         /** io subtype */
 778         enum vvp_io_subtype    cui_io_subtype;
 779
 780         union {
 781                 struct {
 782                         read_actor_t      cui_actor;
 783                         void             *cui_target;
 784                 } sendfile;
 785                 struct {
 786                         struct pipe_inode_info *cui_pipe;
 787                         unsigned int            cui_flags;
 788                 } splice;
 789                 struct vvp_fault_io {
 790                         /**
 791                          * Inode modification time that is checked across DLM
 792                          * lock request.
 793                          */
 794                         time_t                 ft_mtime;
 795                         struct vm_area_struct *ft_vma;
 796                         /**
 797                          *  locked page returned from vvp_io
 798                          */
 799                         cfs_page_t            *ft_vmpage;
 800 #ifndef HAVE_VM_OP_FAULT
 801                         struct vm_nopage_api {
 802                                 /**
 803                                  * Virtual address at which fault occurred.
 804                                  */
 805                                 unsigned long   ft_address;
 806                                 /**
 807                                  * Fault type, as to be supplied to
 808                                  * filemap_nopage().
 809                                  */
 810                                 int             *ft_type;
 811                         } nopage;
 812 #else
 813                         struct vm_fault_api {
 814                                 /**
 815                                  * kernel fault info
 816                                  */
 817                                 struct vm_fault *ft_vmf;
 818                                 /**
 819                                  * fault API used bitflags for return code.
 820                                  */
 821                                 unsigned int    ft_flags;
 822                         } fault;
 823 #endif
 824                 } fault;
 825         } u;
 826         /**
 827          * Read-ahead state used by read and page-fault IO contexts.
 828          */
 829         struct ll_ra_read    cui_bead;
 830         /**
 831          * Set when cui_bead has been initialized.
 832          */
 833         int                  cui_ra_window_set;
 834         /**
 835          * Partially truncated page, that vvp_io_trunc_start() keeps locked
 836          * across truncate.
 837          */
 838         struct cl_page      *cui_partpage;
 839 };
 840
 841 /**
 842  * IO arguments for various VFS I/O interfaces.
 843  */
 844 struct vvp_io_args {
 845         /** normal/sendfile/splice */
 846         enum vvp_io_subtype via_io_subtype;
 847
 848         union {
 849                 struct {
 850 #ifndef HAVE_FILE_WRITEV
 851                         struct kiocb      *via_iocb;
 852 #endif
 853                         struct iovec      *via_iov;
 854                         unsigned long      via_nrsegs;
 855                 } normal;
 856                 struct {
 857                         read_actor_t       via_actor;
 858                         void              *via_target;
 859                 } sendfile;
 860                 struct {
 861                         struct pipe_inode_info  *via_pipe;
 862                         unsigned int       via_flags;
 863                 } splice;
 864         } u;
 865 };
 866
 867 struct ll_cl_context {
 868         void           *lcc_cookie;
 869         struct cl_io   *lcc_io;
 870         struct cl_page *lcc_page;
 871         struct lu_env  *lcc_env;
 872         int             lcc_refcheck;
 873         int             lcc_created;
 874 };
 875
 876 struct vvp_thread_info {
 877         struct ost_lvb       vti_lvb;
 878         struct cl_2queue     vti_queue;
 879         struct iovec         vti_local_iov;
 880         struct vvp_io_args   vti_args;
 881         struct ra_io_arg     vti_ria;
 882         struct kiocb         vti_kiocb;
 883         struct ll_cl_context vti_io_ctx;
 884 };
 885
 886 static inline struct vvp_thread_info *vvp_env_info(const struct lu_env *env)
 887 {
 888         extern struct lu_context_key vvp_key;
 889         struct vvp_thread_info      *info;
 890
 891         info = lu_context_key_get(&env->le_ctx, &vvp_key);
 892         LASSERT(info != NULL);
 893         return info;
 894 }
 895
 896 static inline struct vvp_io_args *vvp_env_args(const struct lu_env *env,
 897                                                enum vvp_io_subtype type)
 898 {
 899         struct vvp_io_args *ret = &vvp_env_info(env)->vti_args;
 900
 901         ret->via_io_subtype = type;
 902
 903         return ret;
 904 }
 905
 906 struct vvp_session {
 907         struct vvp_io         vs_ios;
 908 };
 909
 910 static inline struct vvp_session *vvp_env_session(const struct lu_env *env)
 911 {
 912         extern struct lu_context_key vvp_session_key;
 913         struct vvp_session *ses;
 914
 915         ses = lu_context_key_get(env->le_ses, &vvp_session_key);
 916         LASSERT(ses != NULL);
 917         return ses;
 918 }
 919
 920 static inline struct vvp_io *vvp_env_io(const struct lu_env *env)
 921 {
 922         return &vvp_env_session(env)->vs_ios;
 923 }
 924
 925 void ll_queue_done_writing(struct inode *inode, unsigned long flags);
 926 void ll_close_thread_shutdown(struct ll_close_queue *lcq);
 927 int ll_close_thread_start(struct ll_close_queue **lcq_ret);
 928
 929 /* llite/llite_mmap.c */
 930 typedef struct rb_root  rb_root_t;
 931 typedef struct rb_node  rb_node_t;
 932
 933 struct ll_lock_tree_node;
 934 struct ll_lock_tree {
 935         rb_root_t                       lt_root;
 936         cfs_list_t                      lt_locked_list;
 937         struct ll_file_data            *lt_fd;
 938 };
 939
 940 int ll_teardown_mmaps(struct address_space *mapping, __u64 first, __u64 last);
 941 int ll_file_mmap(struct file * file, struct vm_area_struct * vma);
 942 struct ll_lock_tree_node * ll_node_from_inode(struct inode *inode, __u64 start,
 943                                               __u64 end, ldlm_mode_t mode);
 944 void policy_from_vma(ldlm_policy_data_t *policy,
 945                 struct vm_area_struct *vma, unsigned long addr, size_t count);
 946 struct vm_area_struct *our_vma(unsigned long addr, size_t count);
 947
 948 #define    ll_s2sbi(sb)        (s2lsi(sb)->lsi_llsbi)
 949
 950 static inline __u64 ll_ts2u64(struct timespec *time)
 951 {
 952         __u64 t = time->tv_sec;
 953         return t;
 954 }
 955
 956 /* don't need an addref as the sb_info should be holding one */
 957 static inline struct obd_export *ll_s2dtexp(struct super_block *sb)
 958 {
 959         return ll_s2sbi(sb)->ll_dt_exp;
 960 }
 961
 962 /* don't need an addref as the sb_info should be holding one */
 963 static inline struct obd_export *ll_s2mdexp(struct super_block *sb)
 964 {
 965         return ll_s2sbi(sb)->ll_md_exp;
 966 }
 967
 968 static inline struct client_obd *sbi2mdc(struct ll_sb_info *sbi)
 969 {
 970         struct obd_device *obd = sbi->ll_md_exp->exp_obd;
 971         if (obd == NULL)
 972                 LBUG();
 973         return &obd->u.cli;
 974 }
 975
 976 // FIXME: replace the name of this with LL_SB to conform to kernel stuff
 977 static inline struct ll_sb_info *ll_i2sbi(struct inode *inode)
 978 {
 979         return ll_s2sbi(inode->i_sb);
 980 }
 981
 982 static inline struct obd_export *ll_i2dtexp(struct inode *inode)
 983 {
 984         return ll_s2dtexp(inode->i_sb);
 985 }
 986
 987 static inline struct obd_export *ll_i2mdexp(struct inode *inode)
 988 {
 989         return ll_s2mdexp(inode->i_sb);
 990 }
 991
 992 static inline struct lu_fid *ll_inode2fid(struct inode *inode)
 993 {
 994         struct lu_fid *fid;
 995         LASSERT(inode != NULL);
 996         fid = &ll_i2info(inode)->lli_fid;
 997         LASSERT(fid_is_igif(fid) || fid_ver(fid) == 0);
 998         return fid;
 999 }
1000
1001 static inline int ll_mds_max_easize(struct super_block *sb)
1002 {
1003         return sbi2mdc(ll_s2sbi(sb))->cl_max_mds_easize;
1004 }
1005
1006 static inline __u64 ll_file_maxbytes(struct inode *inode)
1007 {
1008         return ll_i2info(inode)->lli_maxbytes;
1009 }
1010
1011 /* llite/xattr.c */
1012 int ll_setxattr(struct dentry *dentry, const char *name,
1013                 const void *value, size_t size, int flags);
1014 ssize_t ll_getxattr(struct dentry *dentry, const char *name,
1015                     void *buffer, size_t size);
1016 ssize_t ll_listxattr(struct dentry *dentry, char *buffer, size_t size);
1017 int ll_removexattr(struct dentry *dentry, const char *name);
1018
1019 /* llite/remote_perm.c */
1020 extern cfs_mem_cache_t *ll_remote_perm_cachep;
1021 extern cfs_mem_cache_t *ll_rmtperm_hash_cachep;
1022
1023 cfs_hlist_head_t *alloc_rmtperm_hash(void);
1024 void free_rmtperm_hash(cfs_hlist_head_t *hash);
1025 int ll_update_remote_perm(struct inode *inode, struct mdt_remote_perm *perm);
1026 int lustre_check_remote_perm(struct inode *inode, int mask);
1027
1028 /* llite/llite_capa.c */
1029 extern cfs_timer_t ll_capa_timer;
1030
1031 int ll_capa_thread_start(void);
1032 void ll_capa_thread_stop(void);
1033 void ll_capa_timer_callback(unsigned long unused);
1034
1035 struct obd_capa *ll_add_capa(struct inode *inode, struct obd_capa *ocapa);
1036 int ll_update_capa(struct obd_capa *ocapa, struct lustre_capa *capa);
1037
1038 void ll_capa_open(struct inode *inode);
1039 void ll_capa_close(struct inode *inode);
1040
1041 struct obd_capa *ll_mdscapa_get(struct inode *inode);
1042 struct obd_capa *ll_osscapa_get(struct inode *inode, __u64 opc);
1043
1044 void ll_truncate_free_capa(struct obd_capa *ocapa);
1045 void ll_clear_inode_capas(struct inode *inode);
1046 void ll_print_capa_stat(struct ll_sb_info *sbi);
1047
1048 /* llite/llite_cl.c */
1049 extern struct lu_device_type vvp_device_type;
1050
1051 /**
1052  * Common IO arguments for various VFS I/O interfaces.
1053  */
1054
1055 int cl_sb_init(struct super_block *sb);
1056 int cl_sb_fini(struct super_block *sb);
1057 int cl_inode_init(struct inode *inode, struct lustre_md *md);
1058 void cl_inode_fini(struct inode *inode);
1059
1060 enum cl_lock_mode  vvp_mode_from_vma(struct vm_area_struct *vma);
1061 void ll_io_init(struct cl_io *io, const struct file *file, int write);
1062
1063 void ras_update(struct ll_sb_info *sbi, struct inode *inode,
1064                 struct ll_readahead_state *ras, unsigned long index,
1065                 unsigned hit);
1066 void ll_ra_count_put(struct ll_sb_info *sbi, unsigned long len);
1067 int ll_is_file_contended(struct file *file);
1068 void ll_ra_stats_inc(struct address_space *mapping, enum ra_stat which);
1069
1070 /* llite/llite_rmtacl.c */
1071 #ifdef CONFIG_FS_POSIX_ACL
1072 obd_valid rce_ops2valid(int ops);
1073 struct rmtacl_ctl_entry *rct_search(struct rmtacl_ctl_table *rct, pid_t key);
1074 int rct_add(struct rmtacl_ctl_table *rct, pid_t key, int ops);
1075 int rct_del(struct rmtacl_ctl_table *rct, pid_t key);
1076 void rct_init(struct rmtacl_ctl_table *rct);
1077 void rct_fini(struct rmtacl_ctl_table *rct);
1078
1079 void ee_free(struct eacl_entry *ee);
1080 int ee_add(struct eacl_table *et, pid_t key, struct lu_fid *fid, int type,
1081            ext_acl_xattr_header *header);
1082 struct eacl_entry *et_search_del(struct eacl_table *et, pid_t key,
1083                                  struct lu_fid *fid, int type);
1084 void et_search_free(struct eacl_table *et, pid_t key);
1085 void et_init(struct eacl_table *et);
1086 void et_fini(struct eacl_table *et);
1087 #endif
1088
1089 /* statahead.c */
1090
1091 #define LL_SA_RPC_MIN   2
1092 #define LL_SA_RPC_DEF   32
1093 #define LL_SA_RPC_MAX   8192
1094
1095 /* per inode struct, for dir only */
1096 struct ll_statahead_info {
1097         struct inode           *sai_inode;
1098         unsigned int            sai_generation; /* generation for statahead */
1099         cfs_atomic_t            sai_refcount;   /* when access this struct, hold
1100                                                  * refcount */
1101         unsigned int            sai_sent;       /* stat requests sent count */
1102         unsigned int            sai_replied;    /* stat requests which received
1103                                                  * reply */
1104         unsigned int            sai_max;        /* max ahead of lookup */
1105         unsigned int            sai_index;      /* index of statahead entry */
1106         unsigned int            sai_index_next; /* index for the next statahead
1107                                                  * entry to be stated */
1108         unsigned int            sai_hit;        /* hit count */
1109         unsigned int            sai_miss;       /* miss count:
1110                                                  * for "ls -al" case, it includes
1111                                                  * hidden dentry miss;
1112                                                  * for "ls -l" case, it does not
1113                                                  * include hidden dentry miss.
1114                                                  * "sai_miss_hidden" is used for
1115                                                  * the later case.
1116                                                  */
1117         unsigned int            sai_consecutive_miss; /* consecutive miss */
1118         unsigned int            sai_miss_hidden;/* "ls -al", but first dentry
1119                                                  * is not a hidden one */
1120         unsigned int            sai_skip_hidden;/* skipped hidden dentry count */
1121         unsigned int            sai_ls_all:1;   /* "ls -al", do stat-ahead for
1122                                                  * hidden entries */
1123         cfs_waitq_t             sai_waitq;      /* stat-ahead wait queue */
1124         struct ptlrpc_thread    sai_thread;     /* stat-ahead thread */
1125         cfs_list_t              sai_entries_sent;     /* entries sent out */
1126         cfs_list_t              sai_entries_received; /* entries returned */
1127         cfs_list_t              sai_entries_stated;   /* entries stated */
1128 };
1129
1130 int do_statahead_enter(struct inode *dir, struct dentry **dentry, int lookup);
1131 void ll_statahead_exit(struct inode *dir, struct dentry *dentry, int result);
1132 void ll_stop_statahead(struct inode *inode, void *key);
1133
1134 static inline
1135 void ll_statahead_mark(struct inode *dir, struct dentry *dentry)
1136 {
1137         struct ll_inode_info  *lli;
1138         struct ll_dentry_data *ldd = ll_d2d(dentry);
1139
1140         /* dentry has been move to other directory, no need mark */
1141         if (unlikely(dir != dentry->d_parent->d_inode))
1142                 return;
1143
1144         lli = ll_i2info(dir);
1145         /* not the same process, don't mark */
1146         if (lli->lli_opendir_pid != cfs_curproc_pid())
1147                 return;
1148
1149         cfs_spin_lock(&lli->lli_lock);
1150         if (likely(lli->lli_sai != NULL && ldd != NULL))
1151                 ldd->lld_sa_generation = lli->lli_sai->sai_generation;
1152         cfs_spin_unlock(&lli->lli_lock);
1153 }
1154
1155 static inline
1156 int ll_statahead_enter(struct inode *dir, struct dentry **dentryp, int lookup)
1157 {
1158         struct ll_inode_info  *lli;
1159         struct ll_dentry_data *ldd = ll_d2d(*dentryp);
1160
1161         if (unlikely(dir == NULL))
1162                 return -EAGAIN;
1163
1164         if (ll_i2sbi(dir)->ll_sa_max == 0)
1165                 return -ENOTSUPP;
1166
1167         lli = ll_i2info(dir);
1168         /* not the same process, don't statahead */
1169         if (lli->lli_opendir_pid != cfs_curproc_pid())
1170                 return -EAGAIN;
1171
1172         /*
1173          * When "ls" a dentry, the system trigger more than once "revalidate" or
1174          * "lookup", for "getattr", for "getxattr", and maybe for others.
1175          * Under patchless client mode, the operation intent is not accurate,
1176          * it maybe misguide the statahead thread. For example:
1177          * The "revalidate" call for "getattr" and "getxattr" of a dentry maybe
1178          * have the same operation intent -- "IT_GETATTR".
1179          * In fact, one dentry should has only one chance to interact with the
1180          * statahead thread, otherwise the statahead windows will be confused.
1181          * The solution is as following:
1182          * Assign "lld_sa_generation" with "sai_generation" when a dentry
1183          * "IT_GETATTR" for the first time, and the subsequent "IT_GETATTR"
1184          * will bypass interacting with statahead thread for checking:
1185          * "lld_sa_generation == lli_sai->sai_generation"
1186          */
1187         if (ldd && lli->lli_sai &&
1188             ldd->lld_sa_generation == lli->lli_sai->sai_generation)
1189                 return -EAGAIN;
1190
1191         return do_statahead_enter(dir, dentryp, lookup);
1192 }
1193
1194 static void inline ll_dops_init(struct dentry *de, int block)
1195 {
1196         struct ll_dentry_data *lld = ll_d2d(de);
1197
1198         if (lld == NULL && block != 0) {
1199                 ll_set_dd(de);
1200                 lld = ll_d2d(de);
1201         }
1202
1203         if (lld != NULL)
1204                 lld->lld_sa_generation = 0;
1205
1206         de->d_op = &ll_d_ops;
1207 }
1208
1209 /* llite ioctl register support rountine */
1210 #ifdef __KERNEL__
1211 enum llioc_iter {
1212         LLIOC_CONT = 0,
1213         LLIOC_STOP
1214 };
1215
1216 #define LLIOC_MAX_CMD           256
1217
1218 /*
1219  * Rules to write a callback function:
1220  *
1221  * Parameters:
1222  *  @magic: Dynamic ioctl call routine will feed this vaule with the pointer
1223  *      returned to ll_iocontrol_register.  Callback functions should use this
1224  *      data to check the potential collasion of ioctl cmd. If collasion is
1225  *      found, callback function should return LLIOC_CONT.
1226  *  @rcp: The result of ioctl command.
1227  *
1228  *  Return values:
1229  *      If @magic matches the pointer returned by ll_iocontrol_data, the
1230  *      callback should return LLIOC_STOP; return LLIOC_STOP otherwise.
1231  */
1232 typedef enum llioc_iter (*llioc_callback_t)(struct inode *inode,
1233                 struct file *file, unsigned int cmd, unsigned long arg,
1234                 void *magic, int *rcp);
1235
1236 enum llioc_iter ll_iocontrol_call(struct inode *inode, struct file *file,
1237                 unsigned int cmd, unsigned long arg, int *rcp);
1238
1239 /* export functions */
1240 /* Register ioctl block dynamatically for a regular file.
1241  *
1242  * @cmd: the array of ioctl command set
1243  * @count: number of commands in the @cmd
1244  * @cb: callback function, it will be called if an ioctl command is found to
1245  *      belong to the command list @cmd.
1246  *
1247  * Return vaule:
1248  *      A magic pointer will be returned if success;
1249  *      otherwise, NULL will be returned.
1250  * */
1251 void *ll_iocontrol_register(llioc_callback_t cb, int count, unsigned int *cmd);
1252 void ll_iocontrol_unregister(void *magic);
1253
1254 #endif
1255
1256 /* lclient compat stuff */
1257 #define cl_inode_info ll_inode_info
1258 #define cl_i2info(info) ll_i2info(info)
1259 #define cl_inode_mode(inode) ((inode)->i_mode)
1260 #define cl_i2sbi ll_i2sbi
1261
1262 static inline void cl_isize_lock(struct inode *inode, int lsmlock)
1263 {
1264         ll_inode_size_lock(inode, lsmlock);
1265 }
1266
1267 static inline void cl_isize_unlock(struct inode *inode, int lsmlock)
1268 {
1269         ll_inode_size_unlock(inode, lsmlock);
1270 }
1271
1272 static inline void cl_isize_write_nolock(struct inode *inode, loff_t kms)
1273 {
1274         LASSERT_SEM_LOCKED(&ll_i2info(inode)->lli_size_sem);
1275         i_size_write(inode, kms);
1276 }
1277
1278 static inline void cl_isize_write(struct inode *inode, loff_t kms)
1279 {
1280         ll_inode_size_lock(inode, 0);
1281         i_size_write(inode, kms);
1282         ll_inode_size_unlock(inode, 0);
1283 }
1284
1285 #define cl_isize_read(inode)             i_size_read(inode)
1286
1287 static inline int cl_merge_lvb(struct inode *inode)
1288 {
1289         return ll_merge_lvb(inode);
1290 }
1291
1292 #define cl_inode_atime(inode) LTIME_S((inode)->i_atime)
1293 #define cl_inode_ctime(inode) LTIME_S((inode)->i_ctime)
1294 #define cl_inode_mtime(inode) LTIME_S((inode)->i_mtime)
1295
1296 struct obd_capa *cl_capa_lookup(struct inode *inode, enum cl_req_type crt);
1297
1298 /** direct write pages */
1299 struct ll_dio_pages {
1300         /** page array to be written. we don't support
1301          * partial pages except the last one. */
1302         struct page **ldp_pages;
1303         /* offset of each page */
1304         loff_t       *ldp_offsets;
1305         /** if ldp_offsets is NULL, it means a sequential
1306          * pages to be written, then this is the file offset
1307          * of the * first page. */
1308         loff_t        ldp_start_offset;
1309         /** how many bytes are to be written. */
1310         size_t        ldp_size;
1311         /** # of pages in the array. */
1312         int           ldp_nr;
1313 };
1314
1315 extern ssize_t ll_direct_rw_pages(const struct lu_env *env, struct cl_io *io,
1316                                   int rw, struct inode *inode,
1317                                   struct ll_dio_pages *pv);
1318
1319 static inline int ll_file_nolock(const struct file *file)
1320 {
1321         struct ll_file_data *fd = LUSTRE_FPRIVATE(file);
1322         struct inode *inode = file->f_dentry->d_inode;
1323
1324         LASSERT(fd != NULL);
1325         return ((fd->fd_flags & LL_FILE_IGNORE_LOCK) ||
1326                 (ll_i2sbi(inode)->ll_flags & LL_SBI_NOLCK));
1327 }
1328 #endif /* LLITE_INTERNAL_H */