Whamcloud - gitweb
b=15908
[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
5 #ifndef LLITE_INTERNAL_H
6 #define LLITE_INTERNAL_H
7
8 #include <linux/lustre_acl.h>
9
10 #ifdef CONFIG_FS_POSIX_ACL
11 # include <linux/fs.h>
12 #ifdef HAVE_XATTR_ACL
13 # include <linux/xattr_acl.h>
14 #endif /* HAVE_XATTR_ACL */
15 #ifdef HAVE_LINUX_POSIX_ACL_XATTR_H
16 # include <linux/posix_acl_xattr.h>
17 #endif /* HAVE_LINUX_POSIX_ACL_XATTR_H */
18 #endif /* CONFIG_FS_POSIX_ACL */
19
20 #include <lustre_debug.h>
21 #include <lustre_ver.h>
22 #include <lustre_disk.h>  /* for s2sbi */
23 #include <lustre_eacl.h>
24
25 #ifndef FMODE_EXEC
26 #define FMODE_EXEC 0
27 #endif
28
29 #define LL_IT2STR(it) ((it) ? ldlm_it2str((it)->it_op) : "0")
30 #define LUSTRE_FPRIVATE(file) ((file)->private_data)
31
32 #ifdef HAVE_VFS_INTENT_PATCHES
33 static inline struct lookup_intent *ll_nd2it(struct nameidata *nd)
34 {
35         return &nd->intent;
36 }
37 #endif
38
39 struct ll_dentry_data {
40         int                      lld_cwd_count;
41         int                      lld_mnt_count;
42         struct obd_client_handle lld_cwd_och;
43         struct obd_client_handle lld_mnt_och;
44 #ifndef HAVE_VFS_INTENT_PATCHES
45         struct lookup_intent    *lld_it;
46 #endif
47         unsigned int             lld_sa_generation;
48         cfs_waitq_t              lld_waitq;
49 };
50
51 #define ll_d2d(de) ((struct ll_dentry_data*)((de)->d_fsdata))
52
53 extern struct file_operations ll_pgcache_seq_fops;
54
55 #define LLI_INODE_MAGIC                 0x111d0de5
56 #define LLI_INODE_DEAD                  0xdeadd00d
57
58 /* remote client permission cache */
59 #define REMOTE_PERM_HASHSIZE 16
60
61 /* llite setxid/access permission for user on remote client */
62 struct ll_remote_perm {
63         struct hlist_node       lrp_list;
64         uid_t                   lrp_uid;
65         gid_t                   lrp_gid;
66         uid_t                   lrp_fsuid;
67         gid_t                   lrp_fsgid;
68         int                     lrp_access_perm; /* MAY_READ/WRITE/EXEC, this
69                                                     is access permission with
70                                                     lrp_fsuid/lrp_fsgid. */
71 };
72
73 enum lli_flags {
74         /* MDS has an authority for the Size-on-MDS attributes. */
75         LLIF_MDS_SIZE_LOCK      = (1 << 0),
76         /* Epoch close is postponed. */
77         LLIF_EPOCH_PENDING      = (1 << 1),
78         /* DONE WRITING is allowed. */
79         LLIF_DONE_WRITING       = (1 << 2),
80         /* Sizeon-on-MDS attributes are changed. An attribute update needs to
81          * be sent to MDS. */
82         LLIF_SOM_DIRTY          = (1 << 3),
83         /* File is contented */
84         LLIF_CONTENDED         = (1 << 4),
85         /* Truncate uses server lock for this file */
86         LLIF_SRVLOCK           = (1 << 5)
87
88 };
89
90 struct ll_inode_info {
91         int                     lli_inode_magic;
92         struct semaphore        lli_size_sem;           /* protect open and change size */
93         void                   *lli_size_sem_owner;
94         struct semaphore        lli_write_sem;
95         char                   *lli_symlink_name;
96         __u64                   lli_maxbytes;
97         __u64                   lli_ioepoch;
98         unsigned long           lli_flags;
99         cfs_time_t              lli_contention_time;
100
101         /* this lock protects posix_acl, pending_write_llaps, mmap_cnt */
102         spinlock_t              lli_lock;
103         struct list_head        lli_pending_write_llaps;
104         struct list_head        lli_close_list;
105         /* handle is to be sent to MDS later on done_writing and setattr.
106          * Open handle data are needed for the recovery to reconstruct
107          * the inode state on the MDS. XXX: recovery is not ready yet. */
108         struct obd_client_handle *lli_pending_och;
109         atomic_t                lli_mmap_cnt;
110
111         /* for writepage() only to communicate to fsync */
112         int                     lli_async_rc;
113
114         struct posix_acl       *lli_posix_acl;
115
116         /* remote permission hash */
117         struct hlist_head      *lli_remote_perms;
118         unsigned long           lli_rmtperm_utime;
119         struct semaphore        lli_rmtperm_sem;
120
121         struct list_head        lli_dead_list;
122
123         struct semaphore        lli_och_sem; /* Protects access to och pointers
124                                                 and their usage counters */
125         /* We need all three because every inode may be opened in different
126            modes */
127         struct obd_client_handle *lli_mds_read_och;
128         __u64                   lli_open_fd_read_count;
129         struct obd_client_handle *lli_mds_write_och;
130         __u64                   lli_open_fd_write_count;
131         struct obd_client_handle *lli_mds_exec_och;
132         __u64                   lli_open_fd_exec_count;
133
134         struct inode            lli_vfs_inode;
135
136         /* identifying fields for both metadata and data stacks. */
137         struct lu_fid           lli_fid;
138         struct lov_stripe_md   *lli_smd;
139
140         /* fid capability */
141         /* open count currently used by capability only, indicate whether
142          * capability needs renewal */
143         atomic_t                lli_open_count;
144         struct obd_capa        *lli_mds_capa;
145         struct list_head        lli_oss_capas;
146
147         /* metadata stat-ahead */
148         /*
149          * "opendir_pid" is the token when lookup/revalid -- I am the owner of
150          * dir statahead.
151          */
152         pid_t                   lli_opendir_pid;
153         /* 
154          * since parent-child threads can share the same @file struct,
155          * "opendir_key" is the token when dir close for case of parent exit
156          * before child -- it is me should cleanup the dir readahead. */
157         void                   *lli_opendir_key;
158         struct ll_statahead_info *lli_sai;
159 };
160
161 /*
162  * Locking to guarantee consistency of non-atomic updates to long long i_size,
163  * consistency between file size and KMS, and consistency within
164  * ->lli_smd->lsm_oinfo[]'s.
165  *
166  * Implemented by ->lli_size_sem and ->lsm_sem, nested in that order.
167  */
168
169 void ll_inode_size_lock(struct inode *inode, int lock_lsm);
170 void ll_inode_size_unlock(struct inode *inode, int unlock_lsm);
171
172 // FIXME: replace the name of this with LL_I to conform to kernel stuff
173 // static inline struct ll_inode_info *LL_I(struct inode *inode)
174 static inline struct ll_inode_info *ll_i2info(struct inode *inode)
175 {
176         return container_of(inode, struct ll_inode_info, lli_vfs_inode);
177 }
178
179 /* default to about 40meg of readahead on a given system.  That much tied
180  * up in 512k readahead requests serviced at 40ms each is about 1GB/s. */
181 #define SBI_DEFAULT_READAHEAD_MAX (40UL << (20 - CFS_PAGE_SHIFT))
182
183 /* default to read-ahead full files smaller than 2MB on the second read */
184 #define SBI_DEFAULT_READAHEAD_WHOLE_MAX (2UL << (20 - CFS_PAGE_SHIFT))
185
186 enum ra_stat {
187         RA_STAT_HIT = 0,
188         RA_STAT_MISS,
189         RA_STAT_DISTANT_READPAGE,
190         RA_STAT_MISS_IN_WINDOW,
191         RA_STAT_FAILED_GRAB_PAGE,
192         RA_STAT_FAILED_MATCH,
193         RA_STAT_DISCARDED,
194         RA_STAT_ZERO_LEN,
195         RA_STAT_ZERO_WINDOW,
196         RA_STAT_EOF,
197         RA_STAT_MAX_IN_FLIGHT,
198         RA_STAT_WRONG_GRAB_PAGE,
199         _NR_RA_STAT,
200 };
201
202 struct ll_ra_info {
203         unsigned long             ra_cur_pages;
204         unsigned long             ra_max_pages;
205         unsigned long             ra_max_read_ahead_whole_pages;
206         unsigned long             ra_stats[_NR_RA_STAT];
207 };
208
209 /* LL_HIST_MAX=32 causes an overflow */
210 #define LL_HIST_MAX 28
211 #define LL_HIST_START 12 /* buckets start at 2^12 = 4k */
212 #define LL_PROCESS_HIST_MAX 10
213 struct per_process_info {
214         pid_t pid;
215         struct obd_histogram pp_r_hist;
216         struct obd_histogram pp_w_hist;
217 };
218
219 /* pp_extents[LL_PROCESS_HIST_MAX] will hold the combined process info */
220 struct ll_rw_extents_info {
221         struct per_process_info pp_extents[LL_PROCESS_HIST_MAX + 1];
222 };
223
224 #define LL_OFFSET_HIST_MAX 100
225 struct ll_rw_process_info {
226         pid_t                     rw_pid;
227         int                       rw_op;
228         loff_t                    rw_range_start;
229         loff_t                    rw_range_end;
230         loff_t                    rw_last_file_pos;
231         loff_t                    rw_offset;
232         size_t                    rw_smallest_extent;
233         size_t                    rw_largest_extent;
234         struct file               *rw_last_file;
235 };
236
237 enum stats_track_type {
238         STATS_TRACK_ALL = 0,  /* track all processes */
239         STATS_TRACK_PID,      /* track process with this pid */
240         STATS_TRACK_PPID,     /* track processes with this ppid */
241         STATS_TRACK_GID,      /* track processes with this gid */
242         STATS_TRACK_LAST,
243 };
244
245 /* flags for sbi->ll_flags */
246 #define LL_SBI_NOLCK             0x01 /* DLM locking disabled (directio-only) */
247 #define LL_SBI_CHECKSUM          0x02 /* checksum each page as it's written */
248 #define LL_SBI_FLOCK             0x04
249 #define LL_SBI_USER_XATTR        0x08 /* support user xattr */
250 #define LL_SBI_ACL               0x10 /* support ACL */
251 #define LL_SBI_JOIN              0x20 /* support JOIN */
252 #define LL_SBI_RMT_CLIENT        0x40 /* remote client */
253 #define LL_SBI_MDS_CAPA          0x80 /* support mds capa */
254 #define LL_SBI_OSS_CAPA         0x100 /* support oss capa */
255 #define LL_SBI_LOCALFLOCK       0x200 /* Local flocks support by kernel */
256 #define LL_SBI_LRU_RESIZE       0x400 /* lru resize support */
257
258 /* default value for ll_sb_info->contention_time */
259 #define SBI_DEFAULT_CONTENTION_SECONDS     60
260 /* default value for lockless_truncate_enable */
261 #define SBI_DEFAULT_LOCKLESS_TRUNCATE_ENABLE 1
262 #define RCE_HASHES      32
263
264 struct rmtacl_ctl_entry {
265         struct list_head rce_list;
266         pid_t            rce_key; /* hash key */
267         int              rce_ops; /* acl operation type */
268 };
269
270 struct rmtacl_ctl_table {
271         spinlock_t       rct_lock;
272         struct list_head rct_entries[RCE_HASHES];
273 };
274
275 #define EE_HASHES       32
276
277 struct eacl_entry {
278         struct list_head      ee_list;
279         pid_t                 ee_key; /* hash key */
280         struct lu_fid         ee_fid;
281         int                   ee_type; /* ACL type for ACCESS or DEFAULT */
282         ext_acl_xattr_header *ee_acl;
283 };
284
285 struct eacl_table {
286         spinlock_t       et_lock;
287         struct list_head et_entries[EE_HASHES];
288 };
289
290 struct ll_sb_info {
291         struct list_head          ll_list;
292         /* this protects pglist and ra_info.  It isn't safe to
293          * grab from interrupt contexts */
294         spinlock_t                ll_lock;
295         spinlock_t                ll_pp_extent_lock; /* Lock for pp_extent entries */
296         spinlock_t                ll_process_lock; /* Lock for ll_rw_process_info */
297         struct obd_uuid           ll_sb_uuid;
298         struct obd_export        *ll_md_exp;
299         struct obd_export        *ll_dt_exp;
300         struct proc_dir_entry*    ll_proc_root;
301         struct lu_fid             ll_root_fid; /* root object fid */
302
303         int                       ll_flags;
304         struct list_head          ll_conn_chain; /* per-conn chain of SBs */
305         struct lustre_client_ocd  ll_lco;
306
307         struct list_head          ll_orphan_dentry_list; /*please don't ask -p*/
308         struct ll_close_queue    *ll_lcq;
309
310         struct lprocfs_stats     *ll_stats; /* lprocfs stats counter */
311
312         unsigned long             ll_async_page_max;
313         unsigned long             ll_async_page_count;
314         unsigned long             ll_pglist_gen;
315         struct list_head          ll_pglist; /* all pages (llap_pglist_item) */
316
317         unsigned                  ll_contention_time; /* seconds */
318         unsigned                  ll_lockless_truncate_enable; /* true/false */
319
320         struct ll_ra_info         ll_ra_info;
321         unsigned int              ll_namelen;
322         struct file_operations   *ll_fop;
323
324 #ifdef HAVE_EXPORT___IGET
325         struct list_head          ll_deathrow; /* inodes to be destroyed (b1443) */
326         spinlock_t                ll_deathrow_lock;
327 #endif
328         /* =0 - hold lock over whole read/write
329          * >0 - max. chunk to be read/written w/o lock re-acquiring */
330         unsigned long             ll_max_rw_chunk;
331
332         /* Statistics */
333         struct ll_rw_extents_info ll_rw_extents_info;
334         int                       ll_extent_process_count;
335         struct ll_rw_process_info ll_rw_process_info[LL_PROCESS_HIST_MAX];
336         unsigned int              ll_offset_process_count;
337         struct ll_rw_process_info ll_rw_offset_info[LL_OFFSET_HIST_MAX];
338         unsigned int              ll_rw_offset_entry_count;
339         enum stats_track_type     ll_stats_track_type;
340         int                       ll_stats_track_id;
341         int                       ll_rw_stats_on;
342
343         /* metadata stat-ahead */
344         unsigned int              ll_sa_max;     /* max statahead RPCs */
345         unsigned int              ll_sa_wrong;   /* statahead thread stopped for
346                                                   * low hit ratio */
347         unsigned int              ll_sa_total;   /* statahead thread started
348                                                   * count */
349         unsigned long long        ll_sa_blocked; /* ls count waiting for
350                                                   * statahead */
351         unsigned long long        ll_sa_cached;  /* ls count got in cache */
352         unsigned long long        ll_sa_hit;     /* hit count */
353         unsigned long long        ll_sa_miss;    /* miss count */
354
355         dev_t                     ll_sdev_orig; /* save s_dev before assign for
356                                                  * clustred nfs */
357         struct rmtacl_ctl_table   ll_rct;
358         struct eacl_table         ll_et;
359 };
360
361 #define LL_DEFAULT_MAX_RW_CHUNK         (32 * 1024 * 1024)
362
363 struct ll_ra_read {
364         pgoff_t             lrr_start;
365         pgoff_t             lrr_count;
366         struct task_struct *lrr_reader;
367         struct list_head    lrr_linkage;
368 };
369
370 /*
371  * per file-descriptor read-ahead data.
372  */
373 struct ll_readahead_state {
374         spinlock_t      ras_lock;
375         /*
376          * index of the last page that read(2) needed and that wasn't in the
377          * cache. Used by ras_update() to detect seeks.
378          *
379          * XXX nikita: if access seeks into cached region, Lustre doesn't see
380          * this.
381          */
382         unsigned long   ras_last_readpage;
383         /*
384          * number of pages read after last read-ahead window reset. As window
385          * is reset on each seek, this is effectively a number of consecutive
386          * accesses. Maybe ->ras_accessed_in_window is better name.
387          *
388          * XXX nikita: window is also reset (by ras_update()) when Lustre
389          * believes that memory pressure evicts read-ahead pages. In that
390          * case, it probably doesn't make sense to expand window to
391          * PTLRPC_MAX_BRW_PAGES on the third access.
392          */
393         unsigned long   ras_consecutive_pages;
394         /*
395          * number of read requests after the last read-ahead window reset
396          * As window is reset on each seek, this is effectively the number
397          * on consecutive read request and is used to trigger read-ahead.
398          */
399         unsigned long   ras_consecutive_requests;
400         /*
401          * Parameters of current read-ahead window. Handled by
402          * ras_update(). On the initial access to the file or after a seek,
403          * window is reset to 0. After 3 consecutive accesses, window is
404          * expanded to PTLRPC_MAX_BRW_PAGES. Afterwards, window is enlarged by
405          * PTLRPC_MAX_BRW_PAGES chunks up to ->ra_max_pages.
406          */
407         unsigned long   ras_window_start, ras_window_len;
408         /*
409          * Where next read-ahead should start at. This lies within read-ahead
410          * window. Read-ahead window is read in pieces rather than at once
411          * because: 1. lustre limits total number of pages under read-ahead by
412          * ->ra_max_pages (see ll_ra_count_get()), 2. client cannot read pages
413          * not covered by DLM lock.
414          */
415         unsigned long   ras_next_readahead;
416         /*
417          * Total number of ll_file_read requests issued, reads originating
418          * due to mmap are not counted in this total.  This value is used to
419          * trigger full file read-ahead after multiple reads to a small file.
420          */
421         unsigned long   ras_requests;
422         /*
423          * Page index with respect to the current request, these value
424          * will not be accurate when dealing with reads issued via mmap.
425          */
426         unsigned long   ras_request_index;
427         /*
428          * list of struct ll_ra_read's one per read(2) call current in
429          * progress against this file descriptor. Used by read-ahead code,
430          * protected by ->ras_lock.
431          */
432         struct list_head ras_read_beads;
433         /* 
434          * The following 3 items are used for detecting the stride I/O
435          * mode. 
436          * In stride I/O mode, 
437          * ...............|-----data-----|****gap*****|--------|******|.... 
438          *    offset      |-stride_pages-|-stride_gap-| 
439          * ras_stride_offset = offset;
440          * ras_stride_length = stride_pages + stride_gap;
441          * ras_stride_pages = stride_pages;
442          * Note: all these three items are counted by pages.
443          */
444         unsigned long ras_stride_length;
445         unsigned long ras_stride_pages;
446         pgoff_t ras_stride_offset;
447         /* 
448          * number of consecutive stride request count, and it is similar as
449          * ras_consecutive_requests, but used for stride I/O mode.
450          * Note: only more than 2 consecutive stride request are detected,
451          * stride read-ahead will be enable
452          */
453         unsigned long ras_consecutive_stride_requests;
454 };
455
456 struct ll_file_dir {
457 };
458
459 extern cfs_mem_cache_t *ll_file_data_slab;
460 struct lustre_handle;
461 struct ll_file_data {
462         struct ll_readahead_state fd_ras;
463         int fd_omode;
464         struct lustre_handle fd_cwlockh;
465         unsigned long fd_gid;
466         struct ll_file_dir fd_dir;
467         __u32 fd_flags;
468 };
469
470 struct lov_stripe_md;
471
472 extern spinlock_t inode_lock;
473
474 extern struct proc_dir_entry *proc_lustre_fs_root;
475
476 static inline struct inode *ll_info2i(struct ll_inode_info *lli)
477 {
478         return &lli->lli_vfs_inode;
479 }
480
481 struct it_cb_data {
482         struct inode *icbd_parent;
483         struct dentry **icbd_childp;
484         obd_id hash;
485 };
486
487 __u32 ll_i2suppgid(struct inode *i);
488 void ll_i2gids(__u32 *suppgids, struct inode *i1,struct inode *i2);
489
490 #define LLAP_MAGIC 98764321
491
492 extern cfs_mem_cache_t *ll_async_page_slab;
493 extern size_t ll_async_page_slab_size;
494 struct ll_async_page {
495         int              llap_magic;
496          /* only trust these if the page lock is providing exclusion */
497         unsigned int     llap_write_queued:1,
498                          llap_defer_uptodate:1,
499                          llap_origin:3,
500                          llap_ra_used:1,
501                          llap_ignore_quota:1,
502                          llap_lockless_io_page:1;
503         void            *llap_cookie;
504         struct page     *llap_page;
505         struct list_head llap_pending_write;
506         struct list_head llap_pglist_item;
507         /* checksum for paranoid I/O debugging */
508         __u32            llap_checksum;
509 };
510
511 /*
512  * enumeration of llap_from_page() call-sites. Used to export statistics in
513  * /proc/fs/lustre/llite/fsN/dump_page_cache.
514  */
515 enum {
516         LLAP_ORIGIN_UNKNOWN = 0,
517         LLAP_ORIGIN_READPAGE,
518         LLAP_ORIGIN_READAHEAD,
519         LLAP_ORIGIN_COMMIT_WRITE,
520         LLAP_ORIGIN_WRITEPAGE,
521         LLAP_ORIGIN_REMOVEPAGE,
522         LLAP_ORIGIN_LOCKLESS_IO,
523         LLAP__ORIGIN_MAX,
524 };
525 extern char *llap_origins[];
526
527 #ifdef HAVE_REGISTER_CACHE
528 #define ll_register_cache(cache) register_cache(cache)
529 #define ll_unregister_cache(cache) unregister_cache(cache)
530 #else
531 #define ll_register_cache(cache) do {} while (0)
532 #define ll_unregister_cache(cache) do {} while (0)
533 #endif
534
535 void ll_ra_read_in(struct file *f, struct ll_ra_read *rar);
536 void ll_ra_read_ex(struct file *f, struct ll_ra_read *rar);
537 struct ll_ra_read *ll_ra_read_get(struct file *f);
538
539 /* llite/lproc_llite.c */
540 #ifdef LPROCFS
541 int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
542                                 struct super_block *sb, char *osc, char *mdc);
543 void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi);
544 void ll_stats_ops_tally(struct ll_sb_info *sbi, int op, int count);
545 void lprocfs_llite_init_vars(struct lprocfs_static_vars *lvars);
546 #else
547 static inline int lprocfs_register_mountpoint(struct proc_dir_entry *parent,
548                         struct super_block *sb, char *osc, char *mdc){return 0;}
549 static inline void lprocfs_unregister_mountpoint(struct ll_sb_info *sbi) {}
550 static void ll_stats_ops_tally(struct ll_sb_info *sbi, int op, int count) {}
551 static void lprocfs_llite_init_vars(struct lprocfs_static_vars *lvars)
552 {
553         memset(lvars, 0, sizeof(*lvars));
554 }
555 #endif
556
557
558 /* llite/dir.c */
559 static inline void ll_put_page(struct page *page)
560 {
561         kunmap(page);
562         page_cache_release(page);
563 }
564
565 extern struct file_operations ll_dir_operations;
566 extern struct inode_operations ll_dir_inode_operations;
567 struct page *ll_get_dir_page(struct inode *dir, __u64 hash, int exact,
568                              struct ll_dir_chain *chain);
569 /* llite/namei.c */
570 int ll_objects_destroy(struct ptlrpc_request *request,
571                        struct inode *dir);
572 struct inode *ll_iget(struct super_block *sb, ino_t hash,
573                       struct lustre_md *lic);
574 int ll_md_blocking_ast(struct ldlm_lock *, struct ldlm_lock_desc *,
575                        void *data, int flag);
576 #ifndef HAVE_VFS_INTENT_PATCHES
577 struct lookup_intent *ll_convert_intent(struct open_intent *oit,
578                                         int lookup_flags);
579 #endif
580 int ll_lookup_it_finish(struct ptlrpc_request *request,
581                         struct lookup_intent *it, void *data);
582 void ll_lookup_finish_locks(struct lookup_intent *it, struct dentry *dentry);
583
584 /* llite/rw.c */
585 int ll_prepare_write(struct file *, struct page *, unsigned from, unsigned to);
586 int ll_commit_write(struct file *, struct page *, unsigned from, unsigned to);
587 int ll_writepage(struct page *page);
588 void ll_inode_fill_obdo(struct inode *inode, int cmd, struct obdo *oa);
589 int ll_ap_completion(void *data, int cmd, struct obdo *oa, int rc);
590 int llap_shrink_cache(struct ll_sb_info *sbi, int shrink_fraction);
591 struct ll_async_page *llap_from_page(struct page *page, unsigned origin);
592 extern struct cache_definition ll_cache_definition;
593 void ll_removepage(struct page *page);
594 int ll_readpage(struct file *file, struct page *page);
595 struct ll_async_page *llap_cast_private(struct page *page);
596 void ll_readahead_init(struct inode *inode, struct ll_readahead_state *ras);
597 void ll_ra_accounting(struct ll_async_page *llap,struct address_space *mapping);
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
604 /* llite/file.c */
605 extern struct file_operations ll_file_operations;
606 extern struct file_operations ll_file_operations_flock;
607 extern struct file_operations ll_file_operations_noflock;
608 extern struct inode_operations ll_file_inode_operations;
609 extern int ll_inode_revalidate_it(struct dentry *, struct lookup_intent *);
610 extern int ll_have_md_lock(struct inode *inode, __u64 bits);
611 extern ldlm_mode_t ll_take_md_lock(struct inode *inode, __u64 bits,
612                                    struct lustre_handle *lockh);
613 int ll_extent_lock(struct ll_file_data *, struct inode *,
614                    struct lov_stripe_md *, int mode, ldlm_policy_data_t *,
615                    struct lustre_handle *, int ast_flags);
616 int ll_extent_unlock(struct ll_file_data *, struct inode *,
617                      struct lov_stripe_md *, int mode, struct lustre_handle *);
618 int ll_file_open(struct inode *inode, struct file *file);
619 int ll_file_release(struct inode *inode, struct file *file);
620 int ll_lsm_getattr(struct obd_export *, struct lov_stripe_md *, struct obdo *);
621 int ll_local_size(struct inode *inode);
622 int ll_glimpse_ioctl(struct ll_sb_info *sbi,
623                      struct lov_stripe_md *lsm, lstat_t *st);
624 int ll_glimpse_size(struct inode *inode, int ast_flags);
625 int ll_local_open(struct file *file,
626                   struct lookup_intent *it, struct ll_file_data *fd,
627                   struct obd_client_handle *och);
628 int ll_release_openhandle(struct dentry *, struct lookup_intent *);
629 int ll_md_close(struct obd_export *md_exp, struct inode *inode,
630                 struct file *file);
631 int ll_md_real_close(struct inode *inode, int flags);
632 void ll_epoch_close(struct inode *inode, struct md_op_data *op_data,
633                     struct obd_client_handle **och, unsigned long flags);
634 int ll_sizeonmds_update(struct inode *inode, struct md_open_data *data,
635                         struct lustre_handle *fh, __u64 ioepoch);
636 int ll_inode_getattr(struct inode *inode, struct obdo *obdo);
637 int ll_md_setattr(struct inode *inode, struct md_op_data *op_data,
638                   struct md_open_data **mod);
639 void ll_pack_inode2opdata(struct inode *inode, struct md_op_data *op_data,
640                           struct lustre_handle *fh);
641 extern void ll_rw_stats_tally(struct ll_sb_info *sbi, pid_t pid, struct file
642                                *file, size_t count, int rw);
643 int ll_getattr_it(struct vfsmount *mnt, struct dentry *de,
644                struct lookup_intent *it, struct kstat *stat);
645 int ll_getattr(struct vfsmount *mnt, struct dentry *de, struct kstat *stat);
646 struct ll_file_data *ll_file_data_get(void);
647 int ll_inode_permission(struct inode *inode, int mask, struct nameidata *nd);
648 int ll_lov_setstripe_ea_info(struct inode *inode, struct file *file,
649                              int flags, struct lov_user_md *lum,
650                              int lum_size);
651 int ll_lov_getstripe_ea_info(struct inode *inode, const char *filename,
652                              struct lov_mds_md **lmm, int *lmm_size,
653                              struct ptlrpc_request **request);
654 int ll_dir_setstripe(struct inode *inode, struct lov_user_md *lump,
655                      int set_default);
656 int ll_dir_getstripe(struct inode *inode, struct lov_mds_md **lmm, 
657                      int *lmm_size, struct ptlrpc_request **request);
658
659 /* llite/dcache.c */
660 extern struct dentry_operations ll_init_d_ops;
661 extern struct dentry_operations ll_d_ops;
662 extern struct dentry_operations ll_fini_d_ops;
663 void ll_intent_drop_lock(struct lookup_intent *);
664 void ll_intent_release(struct lookup_intent *);
665 int ll_drop_dentry(struct dentry *dentry);
666 extern void ll_set_dd(struct dentry *de);
667 int ll_drop_dentry(struct dentry *dentry);
668 void ll_unhash_aliases(struct inode *);
669 void ll_frob_intent(struct lookup_intent **itp, struct lookup_intent *deft);
670 void ll_lookup_finish_locks(struct lookup_intent *it, struct dentry *dentry);
671 int ll_dcompare(struct dentry *parent, struct qstr *d_name, struct qstr *name);
672 int ll_revalidate_it_finish(struct ptlrpc_request *request,
673                             struct lookup_intent *it, struct dentry *de);
674
675 /* llite/llite_lib.c */
676 extern struct super_operations lustre_super_operations;
677
678 char *ll_read_opt(const char *opt, char *data);
679 void ll_lli_init(struct ll_inode_info *lli);
680 int ll_fill_super(struct super_block *sb);
681 void ll_put_super(struct super_block *sb);
682 void ll_kill_super(struct super_block *sb);
683 struct inode *ll_inode_from_lock(struct ldlm_lock *lock);
684 void ll_clear_inode(struct inode *inode);
685 int ll_setattr_raw(struct inode *inode, struct iattr *attr);
686 int ll_setattr(struct dentry *de, struct iattr *attr);
687 #ifndef HAVE_STATFS_DENTRY_PARAM
688 int ll_statfs(struct super_block *sb, struct kstatfs *sfs);
689 #else
690 int ll_statfs(struct dentry *de, struct kstatfs *sfs);
691 #endif
692 int ll_statfs_internal(struct super_block *sb, struct obd_statfs *osfs,
693                        __u64 max_age, __u32 flags);
694 void ll_update_inode(struct inode *inode, struct lustre_md *md);
695 void ll_read_inode2(struct inode *inode, void *opaque);
696 void ll_delete_inode(struct inode *inode);
697 int ll_iocontrol(struct inode *inode, struct file *file,
698                  unsigned int cmd, unsigned long arg);
699 int ll_flush_ctx(struct inode *inode);
700 #ifdef HAVE_UMOUNTBEGIN_VFSMOUNT
701 void ll_umount_begin(struct vfsmount *vfsmnt, int flags);
702 #else
703 void ll_umount_begin(struct super_block *sb);
704 #endif
705 int ll_remount_fs(struct super_block *sb, int *flags, char *data);
706 int ll_prep_inode(struct inode **inode, struct ptlrpc_request *req,
707                   struct super_block *);
708 void lustre_dump_dentry(struct dentry *, int recur);
709 void lustre_dump_inode(struct inode *);
710 struct ll_async_page *llite_pglist_next_llap(struct ll_sb_info *sbi,
711                                              struct list_head *list);
712 int ll_obd_statfs(struct inode *inode, void *arg);
713 int ll_get_max_mdsize(struct ll_sb_info *sbi, int *max_mdsize);
714 int ll_process_config(struct lustre_cfg *lcfg);
715 struct md_op_data *ll_prep_md_op_data(struct md_op_data *op_data,
716                                       struct inode *i1, struct inode *i2,
717                                       const char *name, int namelen,
718                                       int mode, __u32 opc, void *data);
719 void ll_finish_md_op_data(struct md_op_data *op_data);
720
721 /* llite/llite_nfs.c */
722 extern struct export_operations lustre_export_operations;
723 __u32 get_uuid2int(const char *name, int len);
724 struct dentry *ll_fh_to_dentry(struct super_block *sb, __u32 *data, int len,
725                                int fhtype, int parent);
726 int ll_dentry_to_fh(struct dentry *, __u32 *datap, int *lenp, int need_parent);
727
728 /* llite/special.c */
729 extern struct inode_operations ll_special_inode_operations;
730 extern struct file_operations ll_special_chr_inode_fops;
731 extern struct file_operations ll_special_chr_file_fops;
732 extern struct file_operations ll_special_blk_inode_fops;
733 extern struct file_operations ll_special_fifo_inode_fops;
734 extern struct file_operations ll_special_fifo_file_fops;
735 extern struct file_operations ll_special_sock_inode_fops;
736
737 /* llite/symlink.c */
738 extern struct inode_operations ll_fast_symlink_inode_operations;
739
740 /* llite/llite_close.c */
741 struct ll_close_queue {
742         spinlock_t              lcq_lock;
743         struct list_head        lcq_head;
744         wait_queue_head_t       lcq_waitq;
745         struct completion       lcq_comp;
746         atomic_t                lcq_stop;
747 };
748
749 void llap_write_pending(struct inode *inode, struct ll_async_page *llap);
750 int llap_write_complete(struct inode *inode, struct ll_async_page *llap);
751 int ll_inode_dirty(struct inode *inode, unsigned long flags);
752 void ll_queue_done_writing(struct inode *inode, unsigned long flags);
753 void ll_close_thread_shutdown(struct ll_close_queue *lcq);
754 int ll_close_thread_start(struct ll_close_queue **lcq_ret);
755
756 /* llite/llite_mmap.c */
757 typedef struct rb_root  rb_root_t;
758 typedef struct rb_node  rb_node_t;
759
760 struct ll_lock_tree_node;
761 struct ll_lock_tree {
762         rb_root_t                       lt_root;
763         struct list_head                lt_locked_list;
764         struct ll_file_data             *lt_fd;
765 };
766
767 int ll_teardown_mmaps(struct address_space *mapping, __u64 first, __u64 last);
768 int ll_file_mmap(struct file * file, struct vm_area_struct * vma);
769 struct ll_lock_tree_node * ll_node_from_inode(struct inode *inode, __u64 start,
770                                               __u64 end, ldlm_mode_t mode);
771 int ll_tree_lock(struct ll_lock_tree *tree,
772                  struct ll_lock_tree_node *first_node,
773                  const char *buf, size_t count, int ast_flags);
774 int ll_tree_unlock(struct ll_lock_tree *tree);
775
776 #define    ll_s2sbi(sb)        (s2lsi(sb)->lsi_llsbi)
777
778 static inline __u64 ll_ts2u64(struct timespec *time)
779 {
780         __u64 t = time->tv_sec;
781         return t;
782 }
783
784 /* don't need an addref as the sb_info should be holding one */
785 static inline struct obd_export *ll_s2dtexp(struct super_block *sb)
786 {
787         return ll_s2sbi(sb)->ll_dt_exp;
788 }
789
790 /* don't need an addref as the sb_info should be holding one */
791 static inline struct obd_export *ll_s2mdexp(struct super_block *sb)
792 {
793         return ll_s2sbi(sb)->ll_md_exp;
794 }
795
796 static inline struct client_obd *sbi2mdc(struct ll_sb_info *sbi)
797 {
798         struct obd_device *obd = sbi->ll_md_exp->exp_obd;
799         if (obd == NULL)
800                 LBUG();
801         return &obd->u.cli;
802 }
803
804 // FIXME: replace the name of this with LL_SB to conform to kernel stuff
805 static inline struct ll_sb_info *ll_i2sbi(struct inode *inode)
806 {
807         return ll_s2sbi(inode->i_sb);
808 }
809
810 static inline struct obd_export *ll_i2dtexp(struct inode *inode)
811 {
812         return ll_s2dtexp(inode->i_sb);
813 }
814
815 static inline struct obd_export *ll_i2mdexp(struct inode *inode)
816 {
817         return ll_s2mdexp(inode->i_sb);
818 }
819
820 static inline struct lu_fid *ll_inode2fid(struct inode *inode)
821 {
822         struct lu_fid *fid;
823         LASSERT(inode != NULL);
824         fid = &ll_i2info(inode)->lli_fid;
825         LASSERT(fid_is_igif(fid) || fid_ver(fid) == 0);
826         return fid;
827 }
828
829 static inline int ll_mds_max_easize(struct super_block *sb)
830 {
831         return sbi2mdc(ll_s2sbi(sb))->cl_max_mds_easize;
832 }
833
834 static inline __u64 ll_file_maxbytes(struct inode *inode)
835 {
836         return ll_i2info(inode)->lli_maxbytes;
837 }
838
839 /* llite/xattr.c */
840 int ll_setxattr(struct dentry *dentry, const char *name,
841                 const void *value, size_t size, int flags);
842 ssize_t ll_getxattr(struct dentry *dentry, const char *name,
843                     void *buffer, size_t size);
844 ssize_t ll_listxattr(struct dentry *dentry, char *buffer, size_t size);
845 int ll_removexattr(struct dentry *dentry, const char *name);
846
847 /* llite/remote_perm.c */
848 extern cfs_mem_cache_t *ll_remote_perm_cachep;
849 extern cfs_mem_cache_t *ll_rmtperm_hash_cachep;
850
851 struct hlist_head *alloc_rmtperm_hash(void);
852 void free_rmtperm_hash(struct hlist_head *hash);
853 int ll_update_remote_perm(struct inode *inode, struct mdt_remote_perm *perm);
854 int lustre_check_remote_perm(struct inode *inode, int mask);
855
856 /* llite/llite_fid.c */
857 ino_t ll_fid_build_ino(struct ll_sb_info *sbi, struct lu_fid *fid);
858
859 /* llite/llite_capa.c */
860 extern cfs_timer_t ll_capa_timer;
861
862 int ll_capa_thread_start(void);
863 void ll_capa_thread_stop(void);
864 void ll_capa_timer_callback(unsigned long unused);
865
866 struct obd_capa *ll_add_capa(struct inode *inode, struct obd_capa *ocapa);
867 int ll_update_capa(struct obd_capa *ocapa, struct lustre_capa *capa);
868
869 void ll_capa_open(struct inode *inode);
870 void ll_capa_close(struct inode *inode);
871
872 struct obd_capa *ll_mdscapa_get(struct inode *inode);
873 struct obd_capa *ll_osscapa_get(struct inode *inode, __u64 opc);
874
875 void ll_truncate_free_capa(struct obd_capa *ocapa);
876 void ll_clear_inode_capas(struct inode *inode);
877 void ll_print_capa_stat(struct ll_sb_info *sbi);
878
879 /* llite/llite_rmtacl.c */
880 #ifdef CONFIG_FS_POSIX_ACL
881 obd_valid rce_ops2valid(int ops);
882 struct rmtacl_ctl_entry *rct_search(struct rmtacl_ctl_table *rct, pid_t key);
883 int rct_add(struct rmtacl_ctl_table *rct, pid_t key, int ops);
884 int rct_del(struct rmtacl_ctl_table *rct, pid_t key);
885 void rct_init(struct rmtacl_ctl_table *rct);
886 void rct_fini(struct rmtacl_ctl_table *rct);
887
888 void ee_free(struct eacl_entry *ee);
889 int ee_add(struct eacl_table *et, pid_t key, struct lu_fid *fid, int type,
890            ext_acl_xattr_header *header);
891 struct eacl_entry *et_search_del(struct eacl_table *et, pid_t key,
892                                  struct lu_fid *fid, int type);
893 void et_search_free(struct eacl_table *et, pid_t key);
894 void et_init(struct eacl_table *et);
895 void et_fini(struct eacl_table *et);
896 #endif
897
898 /* statahead.c */
899
900 #define LL_SA_RPC_MIN   2
901 #define LL_SA_RPC_DEF   32
902 #define LL_SA_RPC_MAX   8192
903
904 /* per inode struct, for dir only */
905 struct ll_statahead_info {
906         struct inode           *sai_inode;
907         unsigned int            sai_generation; /* generation for statahead */
908         atomic_t                sai_refcount;   /* when access this struct, hold
909                                                  * refcount */
910         unsigned int            sai_sent;       /* stat requests sent count */
911         unsigned int            sai_replied;    /* stat requests which received
912                                                  * reply */
913         unsigned int            sai_max;        /* max ahead of lookup */
914         unsigned int            sai_index;      /* index of statahead entry */
915         unsigned int            sai_hit;        /* hit count */
916         unsigned int            sai_miss;       /* miss count:
917                                                  * for "ls -al" case, it includes
918                                                  * hidden dentry miss;
919                                                  * for "ls -l" case, it does not
920                                                  * include hidden dentry miss.
921                                                  * "sai_miss_hidden" is used for
922                                                  * the later case.
923                                                  */
924         unsigned int            sai_consecutive_miss; /* consecutive miss */
925         unsigned int            sai_miss_hidden;/* "ls -al", but first dentry
926                                                  * is not a hidden one */
927         unsigned int            sai_skip_hidden;/* skipped hidden dentry count */
928         unsigned int            sai_ls_all:1;   /* "ls -al", do stat-ahead for
929                                                  * hidden entries */
930         cfs_waitq_t             sai_waitq;      /* stat-ahead wait queue */
931         struct ptlrpc_thread    sai_thread;     /* stat-ahead thread */
932         struct list_head        sai_entries;    /* stat-ahead entries */
933 };
934
935 int do_statahead_enter(struct inode *dir, struct dentry **dentry, int lookup);
936 void ll_statahead_exit(struct dentry *dentry, int result);
937 void ll_stop_statahead(struct inode *inode, void *key);
938
939 static inline
940 void ll_d_wakeup(struct dentry *dentry)
941 {
942         struct ll_dentry_data *lld = ll_d2d(dentry);
943
944         LASSERT(dentry->d_op != &ll_init_d_ops);
945         if (lld != NULL)
946                 cfs_waitq_broadcast(&lld->lld_waitq);
947 }
948
949 static inline
950 int ll_statahead_enter(struct inode *dir, struct dentry **dentryp, int lookup)
951 {
952         struct ll_sb_info        *sbi = ll_i2sbi(dir);
953         struct ll_inode_info     *lli = ll_i2info(dir);
954         struct ll_dentry_data    *ldd = ll_d2d(*dentryp);
955
956         if (sbi->ll_sa_max == 0)
957                 return -ENOTSUPP;
958
959         /* not the same process, don't statahead */
960         if (lli->lli_opendir_pid != cfs_curproc_pid())
961                 return -EBADF;
962
963         /*
964          * When "ls" a dentry, the system trigger more than once "revalidate" or
965          * "lookup", for "getattr", for "getxattr", and maybe for others.
966          * Under patchless client mode, the operation intent is not accurate,
967          * it maybe misguide the statahead thread. For example:
968          * The "revalidate" call for "getattr" and "getxattr" of a dentry maybe
969          * have the same operation intent -- "IT_GETATTR".
970          * In fact, one dentry should has only one chance to interact with the
971          * statahead thread, otherwise the statahead windows will be confused.
972          * The solution is as following:
973          * Assign "lld_sa_generation" with "sai_generation" when a dentry
974          * "IT_GETATTR" for the first time, and the subsequent "IT_GETATTR"
975          * will bypass interacting with statahead thread for checking:
976          * "lld_sa_generation == lli_sai->sai_generation"
977          */ 
978         if (ldd && lli->lli_sai &&
979             ldd->lld_sa_generation == lli->lli_sai->sai_generation)
980                 return -EAGAIN;
981
982         return do_statahead_enter(dir, dentryp, lookup);
983 }
984
985 /* llite ioctl register support rountine */
986 #ifdef __KERNEL__
987 enum llioc_iter {
988         LLIOC_CONT = 0,
989         LLIOC_STOP
990 };
991
992 #define LLIOC_MAX_CMD           256
993
994 /*
995  * Rules to write a callback function:
996  *
997  * Parameters:
998  *  @magic: Dynamic ioctl call routine will feed this vaule with the pointer
999  *      returned to ll_iocontrol_register.  Callback functions should use this
1000  *      data to check the potential collasion of ioctl cmd. If collasion is 
1001  *      found, callback function should return LLIOC_CONT.
1002  *  @rcp: The result of ioctl command.
1003  *
1004  *  Return values:
1005  *      If @magic matches the pointer returned by ll_iocontrol_data, the 
1006  *      callback should return LLIOC_STOP; return LLIOC_STOP otherwise.
1007  */
1008 typedef enum llioc_iter (*llioc_callback_t)(struct inode *inode, 
1009                 struct file *file, unsigned int cmd, unsigned long arg,
1010                 void *magic, int *rcp);
1011
1012 enum llioc_iter ll_iocontrol_call(struct inode *inode, struct file *file, 
1013                 unsigned int cmd, unsigned long arg, int *rcp);
1014
1015 /* export functions */
1016 /* Register ioctl block dynamatically for a regular file. 
1017  *
1018  * @cmd: the array of ioctl command set
1019  * @count: number of commands in the @cmd
1020  * @cb: callback function, it will be called if an ioctl command is found to 
1021  *      belong to the command list @cmd.
1022  *
1023  * Return vaule:
1024  *      A magic pointer will be returned if success; 
1025  *      otherwise, NULL will be returned. 
1026  * */
1027 void *ll_iocontrol_register(llioc_callback_t cb, int count, unsigned int *cmd);
1028 void ll_iocontrol_unregister(void *magic);
1029
1030 #endif
1031
1032 #endif /* LLITE_INTERNAL_H */