1 /* 2 * Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. 3 * Copyright (C) 2004-2008 Red Hat, Inc. All rights reserved. 4 * 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. 8 */ 9 10 #ifndef __INCORE_DOT_H__ 11 #define __INCORE_DOT_H__ 12 13 #include <linux/fs.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 22 #define DIO_WAIT 0x00000010 23 #define DIO_METADATA 0x00000020 24 25 struct gfs2_log_operations; 26 struct gfs2_log_element; 27 struct gfs2_holder; 28 struct gfs2_glock; 29 struct gfs2_quota_data; 30 struct gfs2_trans; 31 struct gfs2_ail; 32 struct gfs2_jdesc; 33 struct gfs2_sbd; 34 struct lm_lockops; 35 36 typedef void (*gfs2_glop_bh_t) (struct gfs2_glock *gl, unsigned int ret); 37 38 struct gfs2_log_header_host { 39 u64 lh_sequence; /* Sequence number of this transaction */ 40 u32 lh_flags; /* GFS2_LOG_HEAD_... */ 41 u32 lh_tail; /* Block number of log tail */ 42 u32 lh_blkno; 43 u32 lh_hash; 44 }; 45 46 /* 47 * Structure of operations that are associated with each 48 * type of element in the log. 49 */ 50 51 struct gfs2_log_operations { 52 void (*lo_add) (struct gfs2_sbd *sdp, struct gfs2_log_element *le); 53 void (*lo_before_commit) (struct gfs2_sbd *sdp); 54 void (*lo_after_commit) (struct gfs2_sbd *sdp, struct gfs2_ail *ai); 55 void (*lo_before_scan) (struct gfs2_jdesc *jd, 56 struct gfs2_log_header_host *head, int pass); 57 int (*lo_scan_elements) (struct gfs2_jdesc *jd, unsigned int start, 58 struct gfs2_log_descriptor *ld, __be64 *ptr, 59 int pass); 60 void (*lo_after_scan) (struct gfs2_jdesc *jd, int error, int pass); 61 const char *lo_name; 62 }; 63 64 struct gfs2_log_element { 65 struct list_head le_list; 66 const struct gfs2_log_operations *le_ops; 67 }; 68 69 #define GBF_FULL 1 70 71 struct gfs2_bitmap { 72 struct buffer_head *bi_bh; 73 char *bi_clone; 74 unsigned long bi_flags; 75 u32 bi_offset; 76 u32 bi_start; 77 u32 bi_len; 78 }; 79 80 struct gfs2_rgrpd { 81 struct list_head rd_list; /* Link with superblock */ 82 struct list_head rd_list_mru; 83 struct gfs2_glock *rd_gl; /* Glock for this rgrp */ 84 u64 rd_addr; /* grp block disk address */ 85 u64 rd_data0; /* first data location */ 86 u32 rd_length; /* length of rgrp header in fs blocks */ 87 u32 rd_data; /* num of data blocks in rgrp */ 88 u32 rd_bitbytes; /* number of bytes in data bitmaps */ 89 u32 rd_free; 90 u32 rd_free_clone; 91 u32 rd_dinodes; 92 u64 rd_igeneration; 93 struct gfs2_bitmap *rd_bits; 94 struct mutex rd_mutex; 95 struct gfs2_log_element rd_le; 96 struct gfs2_sbd *rd_sbd; 97 unsigned int rd_bh_count; 98 u32 rd_last_alloc; 99 u32 rd_flags; 100 #define GFS2_RDF_CHECK 0x10000000 /* check for unlinked inodes */ 101 #define GFS2_RDF_UPTODATE 0x20000000 /* rg is up to date */ 102 #define GFS2_RDF_ERROR 0x40000000 /* error in rg */ 103 #define GFS2_RDF_MASK 0xf0000000 /* mask for internal flags */ 104 }; 105 106 enum gfs2_state_bits { 107 BH_Pinned = BH_PrivateStart, 108 BH_Escaped = BH_PrivateStart + 1, 109 }; 110 111 BUFFER_FNS(Pinned, pinned) 112 TAS_BUFFER_FNS(Pinned, pinned) 113 BUFFER_FNS(Escaped, escaped) 114 TAS_BUFFER_FNS(Escaped, escaped) 115 116 struct gfs2_bufdata { 117 struct buffer_head *bd_bh; 118 struct gfs2_glock *bd_gl; 119 120 union { 121 struct list_head list_tr; 122 u64 blkno; 123 } u; 124 #define bd_list_tr u.list_tr 125 #define bd_blkno u.blkno 126 127 struct gfs2_log_element bd_le; 128 129 struct gfs2_ail *bd_ail; 130 struct list_head bd_ail_st_list; 131 struct list_head bd_ail_gl_list; 132 }; 133 134 /* 135 * Internally, we prefix things with gdlm_ and GDLM_ (for gfs-dlm) since a 136 * prefix of lock_dlm_ gets awkward. 137 */ 138 139 #define GDLM_STRNAME_BYTES 25 140 #define GDLM_LVB_SIZE 32 141 142 enum { 143 DFL_BLOCK_LOCKS = 0, 144 }; 145 146 struct lm_lockname { 147 u64 ln_number; 148 unsigned int ln_type; 149 }; 150 151 #define lm_name_equal(name1, name2) \ 152 (((name1)->ln_number == (name2)->ln_number) && \ 153 ((name1)->ln_type == (name2)->ln_type)) 154 155 156 struct gfs2_glock_operations { 157 void (*go_xmote_th) (struct gfs2_glock *gl); 158 int (*go_xmote_bh) (struct gfs2_glock *gl, struct gfs2_holder *gh); 159 void (*go_inval) (struct gfs2_glock *gl, int flags); 160 int (*go_demote_ok) (const struct gfs2_glock *gl); 161 int (*go_lock) (struct gfs2_holder *gh); 162 void (*go_unlock) (struct gfs2_holder *gh); 163 int (*go_dump)(struct seq_file *seq, const struct gfs2_glock *gl); 164 void (*go_callback) (struct gfs2_glock *gl); 165 const int go_type; 166 const unsigned long go_flags; 167 #define GLOF_ASPACE 1 168 }; 169 170 enum { 171 /* States */ 172 HIF_HOLDER = 6, /* Set for gh that "holds" the glock */ 173 HIF_FIRST = 7, 174 HIF_WAIT = 10, 175 }; 176 177 struct gfs2_holder { 178 struct list_head gh_list; 179 180 struct gfs2_glock *gh_gl; 181 struct pid *gh_owner_pid; 182 unsigned int gh_state; 183 unsigned gh_flags; 184 185 int gh_error; 186 unsigned long gh_iflags; /* HIF_... */ 187 unsigned long gh_ip; 188 }; 189 190 enum { 191 GLF_LOCK = 1, 192 GLF_DEMOTE = 3, 193 GLF_PENDING_DEMOTE = 4, 194 GLF_DEMOTE_IN_PROGRESS = 5, 195 GLF_DIRTY = 6, 196 GLF_LFLUSH = 7, 197 GLF_INVALIDATE_IN_PROGRESS = 8, 198 GLF_REPLY_PENDING = 9, 199 GLF_INITIAL = 10, 200 GLF_FROZEN = 11, 201 GLF_QUEUED = 12, 202 GLF_LRU = 13, 203 GLF_OBJECT = 14, /* Used only for tracing */ 204 }; 205 206 struct gfs2_glock { 207 struct hlist_bl_node gl_list; 208 unsigned long gl_flags; /* GLF_... */ 209 struct lm_lockname gl_name; 210 atomic_t gl_ref; 211 212 spinlock_t gl_spin; 213 214 /* State fields protected by gl_spin */ 215 unsigned int gl_state:2, /* Current state */ 216 gl_target:2, /* Target state */ 217 gl_demote_state:2, /* State requested by remote node */ 218 gl_req:2, /* State in last dlm request */ 219 gl_reply:8; /* Last reply from the dlm */ 220 221 unsigned int gl_hash; 222 unsigned long gl_demote_time; /* time of first demote request */ 223 long gl_hold_time; 224 struct list_head gl_holders; 225 226 const struct gfs2_glock_operations *gl_ops; 227 char gl_strname[GDLM_STRNAME_BYTES]; 228 struct dlm_lksb gl_lksb; 229 char gl_lvb[32]; 230 unsigned long gl_tchange; 231 void *gl_object; 232 233 struct list_head gl_lru; 234 235 struct gfs2_sbd *gl_sbd; 236 237 struct list_head gl_ail_list; 238 atomic_t gl_ail_count; 239 atomic_t gl_revokes; 240 struct delayed_work gl_work; 241 struct work_struct gl_delete; 242 struct rcu_head gl_rcu; 243 }; 244 245 #define GFS2_MIN_LVB_SIZE 32 /* Min size of LVB that gfs2 supports */ 246 247 struct gfs2_alloc { 248 /* Quota stuff */ 249 250 struct gfs2_quota_data *al_qd[2*MAXQUOTAS]; 251 struct gfs2_holder al_qd_ghs[2*MAXQUOTAS]; 252 unsigned int al_qd_num; 253 254 u32 al_requested; /* Filled in by caller of gfs2_inplace_reserve() */ 255 u32 al_alloced; /* Filled in by gfs2_alloc_*() */ 256 257 /* Filled in by gfs2_inplace_reserve() */ 258 259 unsigned int al_line; 260 char *al_file; 261 struct gfs2_holder al_ri_gh; 262 struct gfs2_holder al_rgd_gh; 263 struct gfs2_rgrpd *al_rgd; 264 265 }; 266 267 enum { 268 GIF_INVALID = 0, 269 GIF_QD_LOCKED = 1, 270 GIF_SW_PAGED = 3, 271 }; 272 273 274 struct gfs2_inode { 275 struct inode i_inode; 276 u64 i_no_addr; 277 u64 i_no_formal_ino; 278 u64 i_generation; 279 u64 i_eattr; 280 unsigned long i_flags; /* GIF_... */ 281 struct gfs2_glock *i_gl; /* Move into i_gh? */ 282 struct gfs2_holder i_iopen_gh; 283 struct gfs2_holder i_gh; /* for prepare/commit_write only */ 284 struct gfs2_alloc *i_alloc; 285 u64 i_goal; /* goal block for allocations */ 286 struct rw_semaphore i_rw_mutex; 287 struct list_head i_trunc_list; 288 __be64 *i_hash_cache; 289 u32 i_entries; 290 u32 i_diskflags; 291 u8 i_height; 292 u8 i_depth; 293 }; 294 295 /* 296 * Since i_inode is the first element of struct gfs2_inode, 297 * this is effectively a cast. 298 */ 299 static inline struct gfs2_inode *GFS2_I(struct inode *inode) 300 { 301 return container_of(inode, struct gfs2_inode, i_inode); 302 } 303 304 static inline struct gfs2_sbd *GFS2_SB(const struct inode *inode) 305 { 306 return inode->i_sb->s_fs_info; 307 } 308 309 struct gfs2_file { 310 struct mutex f_fl_mutex; 311 struct gfs2_holder f_fl_gh; 312 }; 313 314 struct gfs2_revoke_replay { 315 struct list_head rr_list; 316 u64 rr_blkno; 317 unsigned int rr_where; 318 }; 319 320 enum { 321 QDF_USER = 0, 322 QDF_CHANGE = 1, 323 QDF_LOCKED = 2, 324 QDF_REFRESH = 3, 325 }; 326 327 struct gfs2_quota_data { 328 struct list_head qd_list; 329 struct list_head qd_reclaim; 330 331 atomic_t qd_count; 332 333 u32 qd_id; 334 unsigned long qd_flags; /* QDF_... */ 335 336 s64 qd_change; 337 s64 qd_change_sync; 338 339 unsigned int qd_slot; 340 unsigned int qd_slot_count; 341 342 struct buffer_head *qd_bh; 343 struct gfs2_quota_change *qd_bh_qc; 344 unsigned int qd_bh_count; 345 346 struct gfs2_glock *qd_gl; 347 struct gfs2_quota_lvb qd_qb; 348 349 u64 qd_sync_gen; 350 unsigned long qd_last_warn; 351 }; 352 353 struct gfs2_trans { 354 unsigned long tr_ip; 355 356 unsigned int tr_blocks; 357 unsigned int tr_revokes; 358 unsigned int tr_reserved; 359 360 struct gfs2_holder tr_t_gh; 361 362 int tr_touched; 363 364 unsigned int tr_num_buf; 365 unsigned int tr_num_buf_new; 366 unsigned int tr_num_databuf_new; 367 unsigned int tr_num_buf_rm; 368 unsigned int tr_num_databuf_rm; 369 struct list_head tr_list_buf; 370 371 unsigned int tr_num_revoke; 372 unsigned int tr_num_revoke_rm; 373 }; 374 375 struct gfs2_ail { 376 struct list_head ai_list; 377 378 unsigned int ai_first; 379 struct list_head ai_ail1_list; 380 struct list_head ai_ail2_list; 381 }; 382 383 struct gfs2_journal_extent { 384 struct list_head extent_list; 385 386 unsigned int lblock; /* First logical block */ 387 u64 dblock; /* First disk block */ 388 u64 blocks; 389 }; 390 391 struct gfs2_jdesc { 392 struct list_head jd_list; 393 struct list_head extent_list; 394 struct work_struct jd_work; 395 struct inode *jd_inode; 396 unsigned long jd_flags; 397 #define JDF_RECOVERY 1 398 unsigned int jd_jid; 399 unsigned int jd_blocks; 400 }; 401 402 struct gfs2_statfs_change_host { 403 s64 sc_total; 404 s64 sc_free; 405 s64 sc_dinodes; 406 }; 407 408 #define GFS2_QUOTA_DEFAULT GFS2_QUOTA_OFF 409 #define GFS2_QUOTA_OFF 0 410 #define GFS2_QUOTA_ACCOUNT 1 411 #define GFS2_QUOTA_ON 2 412 413 #define GFS2_DATA_DEFAULT GFS2_DATA_ORDERED 414 #define GFS2_DATA_WRITEBACK 1 415 #define GFS2_DATA_ORDERED 2 416 417 #define GFS2_ERRORS_DEFAULT GFS2_ERRORS_WITHDRAW 418 #define GFS2_ERRORS_WITHDRAW 0 419 #define GFS2_ERRORS_CONTINUE 1 /* place holder for future feature */ 420 #define GFS2_ERRORS_RO 2 /* place holder for future feature */ 421 #define GFS2_ERRORS_PANIC 3 422 423 struct gfs2_args { 424 char ar_lockproto[GFS2_LOCKNAME_LEN]; /* Name of the Lock Protocol */ 425 char ar_locktable[GFS2_LOCKNAME_LEN]; /* Name of the Lock Table */ 426 char ar_hostdata[GFS2_LOCKNAME_LEN]; /* Host specific data */ 427 unsigned int ar_spectator:1; /* Don't get a journal */ 428 unsigned int ar_localflocks:1; /* Let the VFS do flock|fcntl */ 429 unsigned int ar_debug:1; /* Oops on errors */ 430 unsigned int ar_posix_acl:1; /* Enable posix acls */ 431 unsigned int ar_quota:2; /* off/account/on */ 432 unsigned int ar_suiddir:1; /* suiddir support */ 433 unsigned int ar_data:2; /* ordered/writeback */ 434 unsigned int ar_meta:1; /* mount metafs */ 435 unsigned int ar_discard:1; /* discard requests */ 436 unsigned int ar_errors:2; /* errors=withdraw | panic */ 437 unsigned int ar_nobarrier:1; /* do not send barriers */ 438 int ar_commit; /* Commit interval */ 439 int ar_statfs_quantum; /* The fast statfs interval */ 440 int ar_quota_quantum; /* The quota interval */ 441 int ar_statfs_percent; /* The % change to force sync */ 442 }; 443 444 struct gfs2_tune { 445 spinlock_t gt_spin; 446 447 unsigned int gt_logd_secs; 448 449 unsigned int gt_quota_simul_sync; /* Max quotavals to sync at once */ 450 unsigned int gt_quota_warn_period; /* Secs between quota warn msgs */ 451 unsigned int gt_quota_scale_num; /* Numerator */ 452 unsigned int gt_quota_scale_den; /* Denominator */ 453 unsigned int gt_quota_quantum; /* Secs between syncs to quota file */ 454 unsigned int gt_new_files_jdata; 455 unsigned int gt_max_readahead; /* Max bytes to read-ahead from disk */ 456 unsigned int gt_complain_secs; 457 unsigned int gt_statfs_quantum; 458 unsigned int gt_statfs_slow; 459 }; 460 461 enum { 462 SDF_JOURNAL_CHECKED = 0, 463 SDF_JOURNAL_LIVE = 1, 464 SDF_SHUTDOWN = 2, 465 SDF_NOBARRIERS = 3, 466 SDF_NORECOVERY = 4, 467 SDF_DEMOTE = 5, 468 SDF_NOJOURNALID = 6, 469 }; 470 471 #define GFS2_FSNAME_LEN 256 472 473 struct gfs2_inum_host { 474 u64 no_formal_ino; 475 u64 no_addr; 476 }; 477 478 struct gfs2_sb_host { 479 u32 sb_magic; 480 u32 sb_type; 481 u32 sb_format; 482 483 u32 sb_fs_format; 484 u32 sb_multihost_format; 485 u32 sb_bsize; 486 u32 sb_bsize_shift; 487 488 struct gfs2_inum_host sb_master_dir; 489 struct gfs2_inum_host sb_root_dir; 490 491 char sb_lockproto[GFS2_LOCKNAME_LEN]; 492 char sb_locktable[GFS2_LOCKNAME_LEN]; 493 }; 494 495 /* 496 * lm_mount() return values 497 * 498 * ls_jid - the journal ID this node should use 499 * ls_first - this node is the first to mount the file system 500 * ls_lockspace - lock module's context for this file system 501 * ls_ops - lock module's functions 502 */ 503 504 struct lm_lockstruct { 505 int ls_jid; 506 unsigned int ls_first; 507 unsigned int ls_first_done; 508 unsigned int ls_nodir; 509 const struct lm_lockops *ls_ops; 510 unsigned long ls_flags; 511 dlm_lockspace_t *ls_dlm; 512 513 int ls_recover_jid_done; 514 int ls_recover_jid_status; 515 }; 516 517 struct gfs2_sbd { 518 struct super_block *sd_vfs; 519 struct kobject sd_kobj; 520 unsigned long sd_flags; /* SDF_... */ 521 struct gfs2_sb_host sd_sb; 522 523 /* Constants computed on mount */ 524 525 u32 sd_fsb2bb; 526 u32 sd_fsb2bb_shift; 527 u32 sd_diptrs; /* Number of pointers in a dinode */ 528 u32 sd_inptrs; /* Number of pointers in a indirect block */ 529 u32 sd_jbsize; /* Size of a journaled data block */ 530 u32 sd_hash_bsize; /* sizeof(exhash block) */ 531 u32 sd_hash_bsize_shift; 532 u32 sd_hash_ptrs; /* Number of pointers in a hash block */ 533 u32 sd_qc_per_block; 534 u32 sd_max_dirres; /* Max blocks needed to add a directory entry */ 535 u32 sd_max_height; /* Max height of a file's metadata tree */ 536 u64 sd_heightsize[GFS2_MAX_META_HEIGHT + 1]; 537 u32 sd_max_jheight; /* Max height of journaled file's meta tree */ 538 u64 sd_jheightsize[GFS2_MAX_META_HEIGHT + 1]; 539 540 struct gfs2_args sd_args; /* Mount arguments */ 541 struct gfs2_tune sd_tune; /* Filesystem tuning structure */ 542 543 /* Lock Stuff */ 544 545 struct lm_lockstruct sd_lockstruct; 546 struct gfs2_holder sd_live_gh; 547 struct gfs2_glock *sd_rename_gl; 548 struct gfs2_glock *sd_trans_gl; 549 wait_queue_head_t sd_glock_wait; 550 atomic_t sd_glock_disposal; 551 struct completion sd_locking_init; 552 553 /* Inode Stuff */ 554 555 struct dentry *sd_master_dir; 556 struct dentry *sd_root_dir; 557 558 struct inode *sd_jindex; 559 struct inode *sd_statfs_inode; 560 struct inode *sd_sc_inode; 561 struct inode *sd_qc_inode; 562 struct inode *sd_rindex; 563 struct inode *sd_quota_inode; 564 565 /* StatFS stuff */ 566 567 spinlock_t sd_statfs_spin; 568 struct gfs2_statfs_change_host sd_statfs_master; 569 struct gfs2_statfs_change_host sd_statfs_local; 570 int sd_statfs_force_sync; 571 572 /* Resource group stuff */ 573 574 int sd_rindex_uptodate; 575 spinlock_t sd_rindex_spin; 576 struct mutex sd_rindex_mutex; 577 struct list_head sd_rindex_list; 578 struct list_head sd_rindex_mru_list; 579 struct gfs2_rgrpd *sd_rindex_forward; 580 unsigned int sd_rgrps; 581 unsigned int sd_max_rg_data; 582 583 /* Journal index stuff */ 584 585 struct list_head sd_jindex_list; 586 spinlock_t sd_jindex_spin; 587 struct mutex sd_jindex_mutex; 588 unsigned int sd_journals; 589 590 struct gfs2_jdesc *sd_jdesc; 591 struct gfs2_holder sd_journal_gh; 592 struct gfs2_holder sd_jinode_gh; 593 594 struct gfs2_holder sd_sc_gh; 595 struct gfs2_holder sd_qc_gh; 596 597 /* Daemon stuff */ 598 599 struct task_struct *sd_logd_process; 600 struct task_struct *sd_quotad_process; 601 602 /* Quota stuff */ 603 604 struct list_head sd_quota_list; 605 atomic_t sd_quota_count; 606 struct mutex sd_quota_mutex; 607 wait_queue_head_t sd_quota_wait; 608 struct list_head sd_trunc_list; 609 spinlock_t sd_trunc_lock; 610 611 unsigned int sd_quota_slots; 612 unsigned int sd_quota_chunks; 613 unsigned char **sd_quota_bitmap; 614 615 u64 sd_quota_sync_gen; 616 617 /* Log stuff */ 618 619 spinlock_t sd_log_lock; 620 621 unsigned int sd_log_blks_reserved; 622 unsigned int sd_log_commited_buf; 623 unsigned int sd_log_commited_databuf; 624 int sd_log_commited_revoke; 625 626 atomic_t sd_log_pinned; 627 unsigned int sd_log_num_buf; 628 unsigned int sd_log_num_revoke; 629 unsigned int sd_log_num_rg; 630 unsigned int sd_log_num_databuf; 631 632 struct list_head sd_log_le_buf; 633 struct list_head sd_log_le_revoke; 634 struct list_head sd_log_le_rg; 635 struct list_head sd_log_le_databuf; 636 struct list_head sd_log_le_ordered; 637 638 atomic_t sd_log_thresh1; 639 atomic_t sd_log_thresh2; 640 atomic_t sd_log_blks_free; 641 wait_queue_head_t sd_log_waitq; 642 wait_queue_head_t sd_logd_waitq; 643 644 u64 sd_log_sequence; 645 unsigned int sd_log_head; 646 unsigned int sd_log_tail; 647 int sd_log_idle; 648 649 struct rw_semaphore sd_log_flush_lock; 650 atomic_t sd_log_in_flight; 651 wait_queue_head_t sd_log_flush_wait; 652 653 unsigned int sd_log_flush_head; 654 u64 sd_log_flush_wrapped; 655 656 spinlock_t sd_ail_lock; 657 struct list_head sd_ail1_list; 658 struct list_head sd_ail2_list; 659 660 /* Replay stuff */ 661 662 struct list_head sd_revoke_list; 663 unsigned int sd_replay_tail; 664 665 unsigned int sd_found_blocks; 666 unsigned int sd_found_revokes; 667 unsigned int sd_replayed_blocks; 668 669 /* For quiescing the filesystem */ 670 671 struct gfs2_holder sd_freeze_gh; 672 struct mutex sd_freeze_lock; 673 unsigned int sd_freeze_count; 674 675 char sd_fsname[GFS2_FSNAME_LEN]; 676 char sd_table_name[GFS2_FSNAME_LEN]; 677 char sd_proto_name[GFS2_FSNAME_LEN]; 678 679 /* Debugging crud */ 680 681 unsigned long sd_last_warning; 682 struct dentry *debugfs_dir; /* debugfs directory */ 683 struct dentry *debugfs_dentry_glocks; /* for debugfs */ 684 }; 685 686 #endif /* __INCORE_DOT_H__ */ 687 688