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