2 * Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
3 * Copyright (C) 2004-2008 Red Hat, Inc. All rights reserved.
5 * This copyrighted material is made available to anyone wishing to use,
6 * modify, copy, or redistribute it subject to the terms and conditions
7 * of the GNU General Public License version 2.
10 #ifndef __INCORE_DOT_H__
11 #define __INCORE_DOT_H__
14 #include <linux/kobject.h>
15 #include <linux/workqueue.h>
16 #include <linux/dlm.h>
17 #include <linux/buffer_head.h>
18 #include <linux/rcupdate.h>
19 #include <linux/rculist_bl.h>
20 #include <linux/completion.h>
21 #include <linux/rbtree.h>
22 #include <linux/ktime.h>
23 #include <linux/percpu.h>
25 #define DIO_WAIT 0x00000010
26 #define DIO_METADATA 0x00000020
28 struct gfs2_log_operations;
32 struct gfs2_quota_data;
39 typedef void (*gfs2_glop_bh_t) (struct gfs2_glock *gl, unsigned int ret);
41 struct gfs2_log_header_host {
42 u64 lh_sequence; /* Sequence number of this transaction */
43 u32 lh_flags; /* GFS2_LOG_HEAD_... */
44 u32 lh_tail; /* Block number of log tail */
50 * Structure of operations that are associated with each
51 * type of element in the log.
54 struct gfs2_log_operations {
55 void (*lo_add) (struct gfs2_sbd *sdp, struct gfs2_bufdata *bd);
56 void (*lo_before_commit) (struct gfs2_sbd *sdp);
57 void (*lo_after_commit) (struct gfs2_sbd *sdp, struct gfs2_ail *ai);
58 void (*lo_before_scan) (struct gfs2_jdesc *jd,
59 struct gfs2_log_header_host *head, int pass);
60 int (*lo_scan_elements) (struct gfs2_jdesc *jd, unsigned int start,
61 struct gfs2_log_descriptor *ld, __be64 *ptr,
63 void (*lo_after_scan) (struct gfs2_jdesc *jd, int error, int pass);
70 struct buffer_head *bi_bh;
72 unsigned long bi_flags;
79 struct rb_node rd_node; /* Link with superblock */
80 struct gfs2_glock *rd_gl; /* Glock for this rgrp */
81 u64 rd_addr; /* grp block disk address */
82 u64 rd_data0; /* first data location */
83 u32 rd_length; /* length of rgrp header in fs blocks */
84 u32 rd_data; /* num of data blocks in rgrp */
85 u32 rd_bitbytes; /* number of bytes in data bitmaps */
87 u32 rd_reserved; /* number of blocks reserved */
91 struct gfs2_bitmap *rd_bits;
92 struct gfs2_sbd *rd_sbd;
93 struct gfs2_rgrp_lvb *rd_rgl;
96 #define GFS2_RDF_CHECK 0x10000000 /* check for unlinked inodes */
97 #define GFS2_RDF_UPTODATE 0x20000000 /* rg is up to date */
98 #define GFS2_RDF_ERROR 0x40000000 /* error in rg */
99 #define GFS2_RDF_MASK 0xf0000000 /* mask for internal flags */
100 spinlock_t rd_rsspin; /* protects reservation related vars */
101 struct rb_root rd_rstree; /* multi-block reservation tree */
105 struct gfs2_rgrpd *rgd;
106 struct gfs2_bitmap *bi; /* Bitmap must belong to the rgd */
107 u32 offset; /* The offset is bitmap relative */
110 static inline u64 gfs2_rbm_to_block(const struct gfs2_rbm *rbm)
112 return rbm->rgd->rd_data0 + (rbm->bi->bi_start * GFS2_NBBY) + rbm->offset;
115 static inline bool gfs2_rbm_eq(const struct gfs2_rbm *rbm1,
116 const struct gfs2_rbm *rbm2)
118 return (rbm1->rgd == rbm2->rgd) && (rbm1->bi == rbm2->bi) &&
119 (rbm1->offset == rbm2->offset);
122 enum gfs2_state_bits {
123 BH_Pinned = BH_PrivateStart,
124 BH_Escaped = BH_PrivateStart + 1,
125 BH_Zeronew = BH_PrivateStart + 2,
128 BUFFER_FNS(Pinned, pinned)
129 TAS_BUFFER_FNS(Pinned, pinned)
130 BUFFER_FNS(Escaped, escaped)
131 TAS_BUFFER_FNS(Escaped, escaped)
132 BUFFER_FNS(Zeronew, zeronew)
133 TAS_BUFFER_FNS(Zeronew, zeronew)
135 struct gfs2_bufdata {
136 struct buffer_head *bd_bh;
137 struct gfs2_glock *bd_gl;
140 struct list_head bd_list;
141 const struct gfs2_log_operations *bd_ops;
143 struct gfs2_ail *bd_ail;
144 struct list_head bd_ail_st_list;
145 struct list_head bd_ail_gl_list;
149 * Internally, we prefix things with gdlm_ and GDLM_ (for gfs-dlm) since a
150 * prefix of lock_dlm_ gets awkward.
153 #define GDLM_STRNAME_BYTES 25
154 #define GDLM_LVB_SIZE 32
159 * DFL_BLOCK_LOCKS: dlm is in recovery and will grant locks that had been
160 * held by failed nodes whose journals need recovery. Those locks should
161 * only be used for journal recovery until the journal recovery is done.
162 * This is set by the dlm recover_prep callback and cleared by the
163 * gfs2_control thread when journal recovery is complete. To avoid
164 * races between recover_prep setting and gfs2_control clearing, recover_spin
165 * is held while changing this bit and reading/writing recover_block
168 * DFL_NO_DLM_OPS: dlm lockspace ops/callbacks are not being used.
170 * DFL_FIRST_MOUNT: this node is the first to mount this fs and is doing
171 * recovery of all journals before allowing other nodes to mount the fs.
172 * This is cleared when FIRST_MOUNT_DONE is set.
174 * DFL_FIRST_MOUNT_DONE: this node was the first mounter, and has finished
175 * recovery of all journals, and now allows other nodes to mount the fs.
177 * DFL_MOUNT_DONE: gdlm_mount has completed successfully and cleared
178 * BLOCK_LOCKS for the first time. The gfs2_control thread should now
179 * control clearing BLOCK_LOCKS for further recoveries.
181 * DFL_UNMOUNT: gdlm_unmount sets to keep sdp off gfs2_control_wq.
183 * DFL_DLM_RECOVERY: set while dlm is in recovery, between recover_prep()
184 * and recover_done(), i.e. set while recover_block == recover_start.
191 DFL_FIRST_MOUNT_DONE = 3,
194 DFL_DLM_RECOVERY = 6,
199 unsigned int ln_type;
202 #define lm_name_equal(name1, name2) \
203 (((name1)->ln_number == (name2)->ln_number) && \
204 ((name1)->ln_type == (name2)->ln_type))
207 struct gfs2_glock_operations {
208 void (*go_sync) (struct gfs2_glock *gl);
209 int (*go_xmote_bh) (struct gfs2_glock *gl, struct gfs2_holder *gh);
210 void (*go_inval) (struct gfs2_glock *gl, int flags);
211 int (*go_demote_ok) (const struct gfs2_glock *gl);
212 int (*go_lock) (struct gfs2_holder *gh);
213 void (*go_unlock) (struct gfs2_holder *gh);
214 int (*go_dump)(struct seq_file *seq, const struct gfs2_glock *gl);
215 void (*go_callback) (struct gfs2_glock *gl);
217 const unsigned long go_flags;
218 #define GLOF_ASPACE 1
223 GFS2_LKS_SRTT = 0, /* Non blocking smoothed round trip time */
224 GFS2_LKS_SRTTVAR = 1, /* Non blocking smoothed variance */
225 GFS2_LKS_SRTTB = 2, /* Blocking smoothed round trip time */
226 GFS2_LKS_SRTTVARB = 3, /* Blocking smoothed variance */
227 GFS2_LKS_SIRT = 4, /* Smoothed Inter-request time */
228 GFS2_LKS_SIRTVAR = 5, /* Smoothed Inter-request variance */
229 GFS2_LKS_DCOUNT = 6, /* Count of dlm requests */
230 GFS2_LKS_QCOUNT = 7, /* Count of gfs2_holder queues */
234 struct gfs2_lkstats {
235 s64 stats[GFS2_NR_LKSTATS];
240 HIF_HOLDER = 6, /* Set for gh that "holds" the glock */
246 struct list_head gh_list;
248 struct gfs2_glock *gh_gl;
249 struct pid *gh_owner_pid;
250 unsigned int gh_state;
254 unsigned long gh_iflags; /* HIF_... */
258 /* Resource group multi-block reservation, in order of appearance:
260 Step 1. Function prepares to write, allocates a mb, sets the size hint.
261 Step 2. User calls inplace_reserve to target an rgrp, sets the rgrp info
262 Step 3. Function get_local_rgrp locks the rgrp, determines which bits to use
263 Step 4. Bits are assigned from the rgrp based on either the reservation
267 struct gfs2_blkreserv {
268 /* components used during write (step 1): */
269 atomic_t rs_sizehint; /* hint of the write size */
271 struct gfs2_holder rs_rgd_gh; /* Filled in by get_local_rgrp */
272 struct rb_node rs_node; /* link to other block reservations */
273 struct gfs2_rbm rs_rbm; /* Start of reservation */
274 u32 rs_free; /* how many blocks are still free */
275 u64 rs_inum; /* Inode number for reservation */
277 /* ancillary quota stuff */
278 struct gfs2_quota_data *rs_qa_qd[2 * MAXQUOTAS];
279 struct gfs2_holder rs_qa_qd_ghs[2 * MAXQUOTAS];
280 unsigned int rs_qa_qd_num;
286 GLF_PENDING_DEMOTE = 4,
287 GLF_DEMOTE_IN_PROGRESS = 5,
290 GLF_INVALIDATE_IN_PROGRESS = 8,
291 GLF_REPLY_PENDING = 9,
296 GLF_OBJECT = 14, /* Used only for tracing */
301 struct hlist_bl_node gl_list;
302 struct gfs2_sbd *gl_sbd;
303 unsigned long gl_flags; /* GLF_... */
304 struct lm_lockname gl_name;
309 /* State fields protected by gl_spin */
310 unsigned int gl_state:2, /* Current state */
311 gl_target:2, /* Target state */
312 gl_demote_state:2, /* State requested by remote node */
313 gl_req:2, /* State in last dlm request */
314 gl_reply:8; /* Last reply from the dlm */
316 unsigned int gl_hash;
317 unsigned long gl_demote_time; /* time of first demote request */
319 struct list_head gl_holders;
321 const struct gfs2_glock_operations *gl_ops;
323 struct gfs2_lkstats gl_stats;
324 struct dlm_lksb gl_lksb;
325 unsigned long gl_tchange;
328 struct list_head gl_lru;
329 struct list_head gl_ail_list;
330 atomic_t gl_ail_count;
332 struct delayed_work gl_work;
333 struct work_struct gl_delete;
334 struct rcu_head gl_rcu;
337 #define GFS2_MIN_LVB_SIZE 32 /* Min size of LVB that gfs2 supports */
342 GIF_ALLOC_FAILED = 2,
347 struct inode i_inode;
352 unsigned long i_flags; /* GIF_... */
353 struct gfs2_glock *i_gl; /* Move into i_gh? */
354 struct gfs2_holder i_iopen_gh;
355 struct gfs2_holder i_gh; /* for prepare/commit_write only */
356 struct gfs2_blkreserv *i_res; /* rgrp multi-block reservation */
357 struct gfs2_rgrpd *i_rgd;
358 u64 i_goal; /* goal block for allocations */
359 struct rw_semaphore i_rw_mutex;
360 struct list_head i_trunc_list;
361 __be64 *i_hash_cache;
369 * Since i_inode is the first element of struct gfs2_inode,
370 * this is effectively a cast.
372 static inline struct gfs2_inode *GFS2_I(struct inode *inode)
374 return container_of(inode, struct gfs2_inode, i_inode);
377 static inline struct gfs2_sbd *GFS2_SB(const struct inode *inode)
379 return inode->i_sb->s_fs_info;
383 struct mutex f_fl_mutex;
384 struct gfs2_holder f_fl_gh;
387 struct gfs2_revoke_replay {
388 struct list_head rr_list;
390 unsigned int rr_where;
400 struct gfs2_quota_data {
401 struct list_head qd_list;
402 struct list_head qd_reclaim;
407 unsigned long qd_flags; /* QDF_... */
412 unsigned int qd_slot;
413 unsigned int qd_slot_count;
415 struct buffer_head *qd_bh;
416 struct gfs2_quota_change *qd_bh_qc;
417 unsigned int qd_bh_count;
419 struct gfs2_glock *qd_gl;
420 struct gfs2_quota_lvb qd_qb;
423 unsigned long qd_last_warn;
429 unsigned int tr_blocks;
430 unsigned int tr_revokes;
431 unsigned int tr_reserved;
433 struct gfs2_holder tr_t_gh;
437 unsigned int tr_num_buf_new;
438 unsigned int tr_num_databuf_new;
439 unsigned int tr_num_buf_rm;
440 unsigned int tr_num_databuf_rm;
441 unsigned int tr_num_revoke;
442 unsigned int tr_num_revoke_rm;
446 struct list_head ai_list;
448 unsigned int ai_first;
449 struct list_head ai_ail1_list;
450 struct list_head ai_ail2_list;
453 struct gfs2_journal_extent {
454 struct list_head extent_list;
456 unsigned int lblock; /* First logical block */
457 u64 dblock; /* First disk block */
462 struct list_head jd_list;
463 struct list_head extent_list;
464 struct work_struct jd_work;
465 struct inode *jd_inode;
466 unsigned long jd_flags;
467 #define JDF_RECOVERY 1
469 unsigned int jd_blocks;
470 int jd_recover_error;
473 struct gfs2_statfs_change_host {
479 #define GFS2_QUOTA_DEFAULT GFS2_QUOTA_OFF
480 #define GFS2_QUOTA_OFF 0
481 #define GFS2_QUOTA_ACCOUNT 1
482 #define GFS2_QUOTA_ON 2
484 #define GFS2_DATA_DEFAULT GFS2_DATA_ORDERED
485 #define GFS2_DATA_WRITEBACK 1
486 #define GFS2_DATA_ORDERED 2
488 #define GFS2_ERRORS_DEFAULT GFS2_ERRORS_WITHDRAW
489 #define GFS2_ERRORS_WITHDRAW 0
490 #define GFS2_ERRORS_CONTINUE 1 /* place holder for future feature */
491 #define GFS2_ERRORS_RO 2 /* place holder for future feature */
492 #define GFS2_ERRORS_PANIC 3
495 char ar_lockproto[GFS2_LOCKNAME_LEN]; /* Name of the Lock Protocol */
496 char ar_locktable[GFS2_LOCKNAME_LEN]; /* Name of the Lock Table */
497 char ar_hostdata[GFS2_LOCKNAME_LEN]; /* Host specific data */
498 unsigned int ar_spectator:1; /* Don't get a journal */
499 unsigned int ar_localflocks:1; /* Let the VFS do flock|fcntl */
500 unsigned int ar_debug:1; /* Oops on errors */
501 unsigned int ar_posix_acl:1; /* Enable posix acls */
502 unsigned int ar_quota:2; /* off/account/on */
503 unsigned int ar_suiddir:1; /* suiddir support */
504 unsigned int ar_data:2; /* ordered/writeback */
505 unsigned int ar_meta:1; /* mount metafs */
506 unsigned int ar_discard:1; /* discard requests */
507 unsigned int ar_errors:2; /* errors=withdraw | panic */
508 unsigned int ar_nobarrier:1; /* do not send barriers */
509 unsigned int ar_rgrplvb:1; /* use lvbs for rgrp info */
510 int ar_commit; /* Commit interval */
511 int ar_statfs_quantum; /* The fast statfs interval */
512 int ar_quota_quantum; /* The quota interval */
513 int ar_statfs_percent; /* The % change to force sync */
519 unsigned int gt_logd_secs;
521 unsigned int gt_quota_simul_sync; /* Max quotavals to sync at once */
522 unsigned int gt_quota_warn_period; /* Secs between quota warn msgs */
523 unsigned int gt_quota_scale_num; /* Numerator */
524 unsigned int gt_quota_scale_den; /* Denominator */
525 unsigned int gt_quota_quantum; /* Secs between syncs to quota file */
526 unsigned int gt_new_files_jdata;
527 unsigned int gt_max_readahead; /* Max bytes to read-ahead from disk */
528 unsigned int gt_complain_secs;
529 unsigned int gt_statfs_quantum;
530 unsigned int gt_statfs_slow;
534 SDF_JOURNAL_CHECKED = 0,
535 SDF_JOURNAL_LIVE = 1,
541 SDF_RORECOVERY = 7, /* read only recovery */
542 SDF_SKIP_DLM_UNLOCK = 8,
545 #define GFS2_FSNAME_LEN 256
547 struct gfs2_inum_host {
552 struct gfs2_sb_host {
558 u32 sb_multihost_format;
562 struct gfs2_inum_host sb_master_dir;
563 struct gfs2_inum_host sb_root_dir;
565 char sb_lockproto[GFS2_LOCKNAME_LEN];
566 char sb_locktable[GFS2_LOCKNAME_LEN];
570 * lm_mount() return values
572 * ls_jid - the journal ID this node should use
573 * ls_first - this node is the first to mount the file system
574 * ls_lockspace - lock module's context for this file system
575 * ls_ops - lock module's functions
578 struct lm_lockstruct {
580 unsigned int ls_first;
581 const struct lm_lockops *ls_ops;
582 dlm_lockspace_t *ls_dlm;
584 int ls_recover_jid_done; /* These two are deprecated, */
585 int ls_recover_jid_status; /* used previously by gfs_controld */
587 struct dlm_lksb ls_mounted_lksb; /* mounted_lock */
588 struct dlm_lksb ls_control_lksb; /* control_lock */
589 char ls_control_lvb[GDLM_LVB_SIZE]; /* control_lock lvb */
590 struct completion ls_sync_wait; /* {control,mounted}_{lock,unlock} */
592 spinlock_t ls_recover_spin; /* protects following fields */
593 unsigned long ls_recover_flags; /* DFL_ */
594 uint32_t ls_recover_mount; /* gen in first recover_done cb */
595 uint32_t ls_recover_start; /* gen in last recover_done cb */
596 uint32_t ls_recover_block; /* copy recover_start in last recover_prep */
597 uint32_t ls_recover_size; /* size of recover_submit, recover_result */
598 uint32_t *ls_recover_submit; /* gen in last recover_slot cb per jid */
599 uint32_t *ls_recover_result; /* result of last jid recovery */
602 struct gfs2_pcpu_lkstats {
603 /* One struct for each glock type */
604 struct gfs2_lkstats lkstats[10];
608 struct super_block *sd_vfs;
609 struct gfs2_pcpu_lkstats __percpu *sd_lkstats;
610 struct kobject sd_kobj;
611 unsigned long sd_flags; /* SDF_... */
612 struct gfs2_sb_host sd_sb;
614 /* Constants computed on mount */
618 u32 sd_diptrs; /* Number of pointers in a dinode */
619 u32 sd_inptrs; /* Number of pointers in a indirect block */
620 u32 sd_jbsize; /* Size of a journaled data block */
621 u32 sd_hash_bsize; /* sizeof(exhash block) */
622 u32 sd_hash_bsize_shift;
623 u32 sd_hash_ptrs; /* Number of pointers in a hash block */
625 u32 sd_blocks_per_bitmap;
626 u32 sd_max_dirres; /* Max blocks needed to add a directory entry */
627 u32 sd_max_height; /* Max height of a file's metadata tree */
628 u64 sd_heightsize[GFS2_MAX_META_HEIGHT + 1];
629 u32 sd_max_jheight; /* Max height of journaled file's meta tree */
630 u64 sd_jheightsize[GFS2_MAX_META_HEIGHT + 1];
632 struct gfs2_args sd_args; /* Mount arguments */
633 struct gfs2_tune sd_tune; /* Filesystem tuning structure */
637 struct lm_lockstruct sd_lockstruct;
638 struct gfs2_holder sd_live_gh;
639 struct gfs2_glock *sd_rename_gl;
640 struct gfs2_glock *sd_trans_gl;
641 wait_queue_head_t sd_glock_wait;
642 atomic_t sd_glock_disposal;
643 struct completion sd_locking_init;
644 struct delayed_work sd_control_work;
648 struct dentry *sd_master_dir;
649 struct dentry *sd_root_dir;
651 struct inode *sd_jindex;
652 struct inode *sd_statfs_inode;
653 struct inode *sd_sc_inode;
654 struct inode *sd_qc_inode;
655 struct inode *sd_rindex;
656 struct inode *sd_quota_inode;
660 spinlock_t sd_statfs_spin;
661 struct gfs2_statfs_change_host sd_statfs_master;
662 struct gfs2_statfs_change_host sd_statfs_local;
663 int sd_statfs_force_sync;
665 /* Resource group stuff */
667 int sd_rindex_uptodate;
668 spinlock_t sd_rindex_spin;
669 struct rb_root sd_rindex_tree;
670 unsigned int sd_rgrps;
671 unsigned int sd_max_rg_data;
673 /* Journal index stuff */
675 struct list_head sd_jindex_list;
676 spinlock_t sd_jindex_spin;
677 struct mutex sd_jindex_mutex;
678 unsigned int sd_journals;
680 struct gfs2_jdesc *sd_jdesc;
681 struct gfs2_holder sd_journal_gh;
682 struct gfs2_holder sd_jinode_gh;
684 struct gfs2_holder sd_sc_gh;
685 struct gfs2_holder sd_qc_gh;
689 struct task_struct *sd_logd_process;
690 struct task_struct *sd_quotad_process;
694 struct list_head sd_quota_list;
695 atomic_t sd_quota_count;
696 struct mutex sd_quota_mutex;
697 wait_queue_head_t sd_quota_wait;
698 struct list_head sd_trunc_list;
699 spinlock_t sd_trunc_lock;
701 unsigned int sd_quota_slots;
702 unsigned int sd_quota_chunks;
703 unsigned char **sd_quota_bitmap;
705 u64 sd_quota_sync_gen;
709 spinlock_t sd_log_lock;
711 unsigned int sd_log_blks_reserved;
712 unsigned int sd_log_commited_buf;
713 unsigned int sd_log_commited_databuf;
714 int sd_log_commited_revoke;
716 atomic_t sd_log_pinned;
717 unsigned int sd_log_num_buf;
718 unsigned int sd_log_num_revoke;
719 unsigned int sd_log_num_rg;
720 unsigned int sd_log_num_databuf;
722 struct list_head sd_log_le_buf;
723 struct list_head sd_log_le_revoke;
724 struct list_head sd_log_le_databuf;
725 struct list_head sd_log_le_ordered;
727 atomic_t sd_log_thresh1;
728 atomic_t sd_log_thresh2;
729 atomic_t sd_log_blks_free;
730 wait_queue_head_t sd_log_waitq;
731 wait_queue_head_t sd_logd_waitq;
734 unsigned int sd_log_head;
735 unsigned int sd_log_tail;
738 struct rw_semaphore sd_log_flush_lock;
739 atomic_t sd_log_in_flight;
740 struct bio *sd_log_bio;
741 wait_queue_head_t sd_log_flush_wait;
744 unsigned int sd_log_flush_head;
745 u64 sd_log_flush_wrapped;
747 spinlock_t sd_ail_lock;
748 struct list_head sd_ail1_list;
749 struct list_head sd_ail2_list;
753 struct list_head sd_revoke_list;
754 unsigned int sd_replay_tail;
756 unsigned int sd_found_blocks;
757 unsigned int sd_found_revokes;
758 unsigned int sd_replayed_blocks;
760 /* For quiescing the filesystem */
762 struct gfs2_holder sd_freeze_gh;
763 struct mutex sd_freeze_lock;
764 unsigned int sd_freeze_count;
766 char sd_fsname[GFS2_FSNAME_LEN];
767 char sd_table_name[GFS2_FSNAME_LEN];
768 char sd_proto_name[GFS2_FSNAME_LEN];
772 unsigned long sd_last_warning;
773 struct dentry *debugfs_dir; /* debugfs directory */
774 struct dentry *debugfs_dentry_glocks;
775 struct dentry *debugfs_dentry_glstats;
776 struct dentry *debugfs_dentry_sbstats;
779 static inline void gfs2_glstats_inc(struct gfs2_glock *gl, int which)
781 gl->gl_stats.stats[which]++;
784 static inline void gfs2_sbstats_inc(const struct gfs2_glock *gl, int which)
786 const struct gfs2_sbd *sdp = gl->gl_sbd;
788 this_cpu_ptr(sdp->sd_lkstats)->lkstats[gl->gl_name.ln_type].stats[which]++;
792 #endif /* __INCORE_DOT_H__ */