Annotation of 43BSDReno/share/doc/smm/05.fsck/4.t, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1982 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)4.t 4.5 (Berkeley) 7/8/88
                      6: .\"
                      7: .ds RH Appendix A \- Fsck Error Conditions
                      8: .NH
                      9: Appendix A \- Fsck Error Conditions
                     10: .NH 2 
                     11: Conventions
                     12: .PP
                     13: .I Fsck
                     14: is
                     15: a multi-pass file system check program.
                     16: Each file system pass invokes a different Phase of the
                     17: .I fsck
                     18: program.
                     19: After the initial setup,
                     20: .I fsck
                     21: performs successive Phases over each file system,
                     22: checking blocks and sizes,
                     23: path-names,
                     24: connectivity,
                     25: reference counts,
                     26: and the map of free blocks,
                     27: (possibly rebuilding it),
                     28: and performs some cleanup.
                     29: .LP
                     30: Normally
                     31: .I fsck
                     32: is run non-interactively to
                     33: .I preen
                     34: the file systems after an unclean halt.
                     35: While preen'ing a file system,
                     36: it will only fix corruptions that are expected
                     37: to occur from an unclean halt.
                     38: These actions are a proper subset of the actions that 
                     39: .I fsck
                     40: will take when it is running interactively.
                     41: Throughout this appendix many errors have several options
                     42: that the operator can take.
                     43: When an inconsistency is detected,
                     44: .I fsck
                     45: reports the error condition to the operator.
                     46: If a response is required,
                     47: .I fsck
                     48: prints a prompt message and
                     49: waits for a response.
                     50: When preen'ing most errors are fatal.
                     51: For those that are expected,
                     52: the response taken is noted.
                     53: This appendix explains the meaning of each error condition,
                     54: the possible responses, and the related error conditions.
                     55: .LP
                     56: The error conditions are organized by the
                     57: .I Phase
                     58: of the
                     59: .I fsck
                     60: program in which they can occur.
                     61: The error conditions that may occur
                     62: in more than one Phase
                     63: will be discussed in initialization.
                     64: .NH 2 
                     65: Initialization
                     66: .PP
                     67: Before a file system check can be performed, certain
                     68: tables have to be set up and certain files opened.
                     69: This section concerns itself with the opening of files and
                     70: the initialization of tables.
                     71: This section lists error conditions resulting from
                     72: command line options,
                     73: memory requests,
                     74: opening of files,
                     75: status of files,
                     76: file system size checks,
                     77: and creation of the scratch file.
                     78: All the initialization errors are fatal
                     79: when the file system is being preen'ed.
                     80: .sp
                     81: .LP
                     82: .B "\fIC\fP option?"
                     83: .br
                     84: \fIC\fP is not a legal option to
                     85: .I fsck ;
                     86: legal options are \-b, \-c, \-y, \-n, and \-p.
                     87: .I Fsck
                     88: terminates on this error condition.
                     89: See the
                     90: .I fsck (8)
                     91: manual entry for further detail.
                     92: .sp
                     93: .LP
                     94: .B "cannot alloc NNN bytes for blockmap"
                     95: .br
                     96: .B "cannot alloc NNN bytes for freemap"
                     97: .br
                     98: .B "cannot alloc NNN bytes for statemap"
                     99: .br
                    100: .B "cannot alloc NNN bytes for lncntp"
                    101: .br
                    102: .I Fsck 's
                    103: request for memory for its virtual
                    104: memory tables failed.
                    105: This should never happen.
                    106: .I Fsck
                    107: terminates on this error condition.
                    108: See a guru.
                    109: .sp
                    110: .LP
                    111: .B "Can't open checklist file: \fIF\fP"
                    112: .br
                    113: The file system checklist file
                    114: \fIF\fP (usually
                    115: .I /etc/fstab )
                    116: can not be opened for reading.
                    117: .I Fsck
                    118: terminates on this error condition.
                    119: Check access modes of \fIF\fP.
                    120: .sp
                    121: .LP
                    122: .B "Can't stat root"
                    123: .br
                    124: .I Fsck 's
                    125: request for statistics about the root directory ``/'' failed.
                    126: This should never happen.
                    127: .I Fsck
                    128: terminates on this error condition.
                    129: See a guru.
                    130: .sp
                    131: .LP
                    132: .B "Can't stat \fIF\fP"
                    133: .br
                    134: .B "Can't make sense out of name \fIF\fP"
                    135: .br
                    136: .I Fsck 's
                    137: request for statistics about the file system \fIF\fP failed.
                    138: When running manually,
                    139: it ignores this file system
                    140: and continues checking the next file system given.
                    141: Check access modes of \fIF\fP.
                    142: .sp
                    143: .LP
                    144: .B "Can't open \fIF\fP"
                    145: .br
                    146: .I Fsck 's
                    147: request attempt to open the file system \fIF\fP failed.
                    148: When running manually, it ignores this file system
                    149: and continues checking the next file system given.
                    150: Check access modes of \fIF\fP.
                    151: .sp
                    152: .LP
                    153: .B "\fIF\fP: (NO WRITE)"
                    154: .br
                    155: Either the \-n flag was specified or
                    156: .I fsck 's
                    157: attempt to open the file system \fIF\fP for writing failed.
                    158: When running manually,
                    159: all the diagnostics are printed out,
                    160: but no modifications are attempted to fix them.
                    161: .sp
                    162: .LP
                    163: .B "file is not a block or character device; OK"
                    164: .br
                    165: You have given
                    166: .I fsck
                    167: a regular file name by mistake.
                    168: Check the type of the file specified.
                    169: .LP
                    170: Possible responses to the OK prompt are:
                    171: .IP YES
                    172: ignore this error condition.
                    173: .IP NO
                    174: ignore this file system and continues checking
                    175: the next file system given.
                    176: .sp
                    177: .LP
                    178: .B "UNDEFINED OPTIMIZATION IN SUPERBLOCK (SET TO DEFAULT)"
                    179: .br
                    180: The superblock optimization parameter is neither OPT_TIME
                    181: nor OPT_SPACE.
                    182: .LP
                    183: Possible responses to the SET TO DEFAULT prompt are:
                    184: .IP YES
                    185: The superblock is set to request optimization to minimize
                    186: running time of the system.
                    187: (If optimization to minimize disk space utilization is
                    188: desired, it can be set using \fItunefs\fP(8).)
                    189: .IP NO
                    190: ignore this error condition.
                    191: .sp
                    192: .LP
                    193: .B "IMPOSSIBLE MINFREE=\fID\fP IN SUPERBLOCK (SET TO DEFAULT)"
                    194: .br
                    195: The superblock minimum space percentage is greater than 99%
                    196: or less then 0%.
                    197: .LP
                    198: Possible responses to the SET TO DEFAULT prompt are:
                    199: .IP YES
                    200: The minfree parameter is set to 10%.
                    201: (If some other percentage is desired,
                    202: it can be set using \fItunefs\fP(8).)
                    203: .IP NO
                    204: ignore this error condition.
                    205: .sp
                    206: .LP
                    207: .B "IMPOSSIBLE INTERLEAVE=\fID\fP IN SUPERBLOCK (SET TO DEFAULT)"
                    208: .br
                    209: The file system interleave is less than or equal to zero.
                    210: .LP
                    211: Possible responses to the SET TO DEFAULT prompt are:
                    212: .IP YES
                    213: The interleave parameter is set to 1.
                    214: .IP NO
                    215: ignore this error condition.
                    216: .sp
                    217: .LP
                    218: .B "IMPOSSIBLE NPSECT=\fID\fP IN SUPERBLOCK (SET TO DEFAULT)"
                    219: .br
                    220: The number of physical sectors per track is less than the number
                    221: of usable sectors per track.
                    222: .LP
                    223: Possible responses to the SET TO DEFAULT prompt are:
                    224: .IP YES
                    225: The npsect parameter is set to the number of usable sectors per track.
                    226: .IP NO
                    227: ignore this error condition.
                    228: .sp
                    229: .LP
                    230: One of the following messages will appear:
                    231: .br
                    232: .B "MAGIC NUMBER WRONG"
                    233: .br
                    234: .B "NCG OUT OF RANGE"
                    235: .br
                    236: .B "CPG OUT OF RANGE"
                    237: .br
                    238: .B "NCYL DOES NOT JIVE WITH NCG*CPG"
                    239: .br
                    240: .B "SIZE PREPOSTEROUSLY LARGE"
                    241: .br
                    242: .B "TRASHED VALUES IN SUPER BLOCK"
                    243: .br
                    244: and will be followed by the message:
                    245: .br
                    246: .B "\fIF\fP: BAD SUPER BLOCK: \fIB\fP"
                    247: .br
                    248: .B "USE -b OPTION TO FSCK TO SPECIFY LOCATION OF AN ALTERNATE"
                    249: .br
                    250: .B "SUPER-BLOCK TO SUPPLY NEEDED INFORMATION; SEE fsck(8)."
                    251: .br
                    252: The super block has been corrupted. 
                    253: An alternative super block must be selected from among those
                    254: listed by
                    255: .I newfs
                    256: (8) when the file system was created.
                    257: For file systems with a blocksize less than 32K,
                    258: specifying \-b 32 is a good first choice.
                    259: .sp
                    260: .LP
                    261: .B "INTERNAL INCONSISTENCY: \fIM\fP"
                    262: .br
                    263: .I Fsck 's
                    264: has had an internal panic, whose message is specified as \fIM\fP.
                    265: This should never happen.
                    266: See a guru.
                    267: .sp
                    268: .LP
                    269: .B "CAN NOT SEEK: BLK \fIB\fP (CONTINUE)"
                    270: .br
                    271: .I Fsck 's
                    272: request for moving to a specified block number \fIB\fP in
                    273: the file system failed.
                    274: This should never happen.
                    275: See a guru.
                    276: .LP
                    277: Possible responses to the CONTINUE prompt are:
                    278: .IP YES
                    279: attempt to continue to run the file system check.
                    280: Often,
                    281: however the problem will persist.
                    282: This error condition will not allow a complete check of the file system.
                    283: A second run of
                    284: .I fsck
                    285: should be made to re-check this file system.
                    286: If the block was part of the virtual memory buffer
                    287: cache,
                    288: .I fsck
                    289: will terminate with the message ``Fatal I/O error''.
                    290: .IP NO
                    291: terminate the program.
                    292: .sp
                    293: .LP
                    294: .B "CAN NOT READ: BLK \fIB\fP (CONTINUE)"
                    295: .br
                    296: .I Fsck 's
                    297: request for reading a specified block number \fIB\fP in
                    298: the file system failed.
                    299: This should never happen.
                    300: See a guru.
                    301: .LP
                    302: Possible responses to the CONTINUE prompt are:
                    303: .IP YES
                    304: attempt to continue to run the file system check.
                    305: It will retry the read and print out the message:
                    306: .br
                    307: .B "THE FOLLOWING SECTORS COULD NOT BE READ: \fIN\fP"
                    308: .br
                    309: where \fIN\fP indicates the sectors that could not be read.
                    310: If 
                    311: .I fsck
                    312: ever tries to write back one of the blocks on which the read failed
                    313: it will print the message:
                    314: .br
                    315: .B "WRITING ZERO'ED BLOCK \fIN\fP TO DISK"
                    316: .br
                    317: where \fIN\fP indicates the sector that was written with zero's.
                    318: If the disk is experiencing hardware problems, the problem will persist.
                    319: This error condition will not allow a complete check of the file system.
                    320: A second run of
                    321: .I fsck
                    322: should be made to re-check this file system.
                    323: If the block was part of the virtual memory buffer
                    324: cache,
                    325: .I fsck
                    326: will terminate with the message ``Fatal I/O error''.
                    327: .IP NO
                    328: terminate the program.
                    329: .sp
                    330: .LP
                    331: .B "CAN NOT WRITE: BLK \fIB\fP (CONTINUE)"
                    332: .br
                    333: .I Fsck 's
                    334: request for writing a specified block number \fIB\fP
                    335: in the file system failed.
                    336: The disk is write-protected;
                    337: check the write protect lock on the drive.
                    338: If that is not the problem, see a guru.
                    339: .LP
                    340: Possible responses to the CONTINUE prompt are:
                    341: .IP YES
                    342: attempt to continue to run the file system check.
                    343: The write operation will be retried with the failed blocks
                    344: indicated by the message:
                    345: .br
                    346: .B "THE FOLLOWING SECTORS COULD NOT BE WRITTEN: \fIN\fP"
                    347: .br
                    348: where \fIN\fP indicates the sectors that could not be written.
                    349: If the disk is experiencing hardware problems, the problem will persist.
                    350: This error condition will not allow a complete check of the file system.
                    351: A second run of
                    352: .I fsck
                    353: should be made to re-check this file system.
                    354: If the block was part of the virtual memory buffer
                    355: cache,
                    356: .I fsck
                    357: will terminate with the message ``Fatal I/O error''.
                    358: .IP NO
                    359: terminate the program.
                    360: .sp
                    361: .LP
                    362: .B "bad inode number DDD to ginode"
                    363: .br
                    364: An internal error has attempted to read non-existent inode \fIDDD\fP.
                    365: This error causes 
                    366: .I fsck
                    367: to exit.
                    368: See a guru.
                    369: .NH 2 
                    370: Phase 1 \- Check Blocks and Sizes
                    371: .PP
                    372: This phase concerns itself with
                    373: the inode list.
                    374: This section lists error conditions resulting from
                    375: checking inode types,
                    376: setting up the zero-link-count table,
                    377: examining inode block numbers for bad or duplicate blocks,
                    378: checking inode size,
                    379: and checking inode format.
                    380: All errors in this phase except
                    381: .B "INCORRECT BLOCK COUNT"
                    382: and
                    383: .B "PARTIALLY TRUNCATED INODE"
                    384: are fatal if the file system is being preen'ed.
                    385: .sp
                    386: .LP
                    387: .B "UNKNOWN FILE TYPE I=\fII\fP (CLEAR)"
                    388: .br
                    389: The mode word of the inode \fII\fP indicates that the inode is not a
                    390: special block inode, special character inode, socket inode, regular inode,
                    391: symbolic link, or directory inode.
                    392: .LP
                    393: Possible responses to the CLEAR prompt are:
                    394: .IP YES
                    395: de-allocate inode \fII\fP by zeroing its contents.
                    396: This will always invoke the UNALLOCATED error condition in Phase 2
                    397: for each directory entry pointing to this inode.
                    398: .IP NO
                    399: ignore this error condition.
                    400: .sp
                    401: .LP
                    402: .B "PARTIALLY TRUNCATED INODE I=\fII\fP (SALVAGE)"
                    403: .br
                    404: .I Fsck
                    405: has found inode \fII\fP whose size is shorter than the number of
                    406: blocks allocated to it.
                    407: This condition should only occur if the system crashes while in the
                    408: midst of truncating a file.
                    409: When preen'ing the file system, 
                    410: .I fsck
                    411: completes the truncation to the specified size.
                    412: .LP
                    413: Possible responses to SALVAGE are:
                    414: .IP YES
                    415: complete the truncation to the size specified in the inode.
                    416: .IP NO
                    417: ignore this error condition.
                    418: .sp
                    419: .LP
                    420: .B "LINK COUNT TABLE OVERFLOW (CONTINUE)"
                    421: .br
                    422: An internal table for
                    423: .I fsck
                    424: containing allocated inodes with a link count of
                    425: zero cannot allocate more memory.
                    426: Increase the virtual memory for
                    427: .I fsck .
                    428: .LP
                    429: Possible responses to the CONTINUE prompt are:
                    430: .IP YES
                    431: continue with the program.
                    432: This error condition will not allow a complete check of the file system.
                    433: A second run of
                    434: .I fsck
                    435: should be made to re-check this file system.
                    436: If another allocated inode with a zero link count is found,
                    437: this error condition is repeated.
                    438: .IP NO
                    439: terminate the program.
                    440: .sp
                    441: .LP
                    442: .B "\fIB\fP BAD I=\fII\fP"
                    443: .br
                    444: Inode \fII\fP contains block number \fIB\fP with a number
                    445: lower than the number of the first data block in the file system or
                    446: greater than the number of the last block
                    447: in the file system.
                    448: This error condition may invoke the
                    449: .B "EXCESSIVE BAD BLKS"
                    450: error condition in Phase 1 (see next paragraph) if
                    451: inode \fII\fP has too many block numbers outside the file system range.
                    452: This error condition will always invoke the
                    453: .B "BAD/DUP"
                    454: error condition in Phase 2 and Phase 4.
                    455: .sp
                    456: .LP
                    457: .B "EXCESSIVE BAD BLKS I=\fII\fP (CONTINUE)"
                    458: .br
                    459: There is more than a tolerable number (usually 10) of blocks with a number
                    460: lower than the number of the first data block in the file system or greater than
                    461: the number of last block in the file system associated with inode \fII\fP.
                    462: .LP
                    463: Possible responses to the CONTINUE prompt are:
                    464: .IP YES
                    465: ignore the rest of the blocks in this inode
                    466: and continue checking with the next inode in the file system.
                    467: This error condition will not allow a complete check of the file system.
                    468: A second run of
                    469: .I fsck
                    470: should be made to re-check this file system.
                    471: .IP NO
                    472: terminate the program.
                    473: .sp
                    474: .LP
                    475: .B "BAD STATE DDD TO BLKERR"
                    476: .br
                    477: An internal error has scrambled 
                    478: .I fsck 's
                    479: state map to have the impossible value \fIDDD\fP.
                    480: .I Fsck
                    481: exits immediately. 
                    482: See a guru.
                    483: .sp
                    484: .LP
                    485: .B "\fIB\fP DUP I=\fII\fP"
                    486: .br
                    487: Inode \fII\fP contains block number \fIB\fP that is already claimed by
                    488: another inode.
                    489: This error condition may invoke the
                    490: .B "EXCESSIVE DUP BLKS"
                    491: error condition in Phase 1 if
                    492: inode \fII\fP has too many block numbers claimed by other inodes.
                    493: This error condition will always invoke Phase 1b and the
                    494: .B "BAD/DUP"
                    495: error condition in Phase 2 and Phase 4.
                    496: .sp
                    497: .LP
                    498: .B "EXCESSIVE DUP BLKS I=\fII\fP (CONTINUE)"
                    499: .br
                    500: There is more than a tolerable number (usually 10) of blocks claimed by other
                    501: inodes.
                    502: .LP
                    503: Possible responses to the CONTINUE prompt are:
                    504: .IP YES
                    505: ignore the rest of the blocks in this inode
                    506: and continue checking with the next inode in the file system.
                    507: This error condition will not allow a complete check of the file system.
                    508: A second run of
                    509: .I fsck
                    510: should be made to re-check this file system.
                    511: .IP NO
                    512: terminate the program.
                    513: .sp
                    514: .LP
                    515: .B "DUP TABLE OVERFLOW (CONTINUE)"
                    516: .br
                    517: An internal table in
                    518: .I fsck
                    519: containing duplicate block numbers cannot allocate any more space.
                    520: Increase the amount of virtual memory available to
                    521: .I fsck .
                    522: .LP
                    523: Possible responses to the CONTINUE prompt are:
                    524: .IP YES
                    525: continue with the program.
                    526: This error condition will not allow a complete check of the file system.
                    527: A second run of
                    528: .I fsck
                    529: should be made to re-check this file system.
                    530: If another duplicate block is found, this error condition will repeat.
                    531: .IP NO
                    532: terminate the program.
                    533: .sp
                    534: .LP
                    535: .B "PARTIALLY ALLOCATED INODE I=\fII\fP (CLEAR)"
                    536: .br
                    537: Inode \fII\fP is neither allocated nor unallocated.
                    538: .LP
                    539: Possible responses to the CLEAR prompt are:
                    540: .IP YES
                    541: de-allocate inode \fII\fP by zeroing its contents.
                    542: .IP NO
                    543: ignore this error condition.
                    544: .sp
                    545: .LP
                    546: .B "INCORRECT BLOCK COUNT I=\fII\fP (\fIX\fP should be \fIY\fP) (CORRECT)"
                    547: .br
                    548: The block count for inode \fII\fP is \fIX\fP blocks,
                    549: but should be \fIY\fP blocks.
                    550: When preen'ing the count is corrected.
                    551: .LP
                    552: Possible responses to the CORRECT prompt are:
                    553: .IP YES
                    554: replace the block count of inode \fII\fP with \fIY\fP.
                    555: .IP NO
                    556: ignore this error condition.
                    557: .NH 2 
                    558: Phase 1B: Rescan for More Dups
                    559: .PP
                    560: When a duplicate block is found in the file system, the file system is
                    561: rescanned to find the inode that previously claimed that block.
                    562: This section lists the error condition when the duplicate block is found.
                    563: .sp
                    564: .LP
                    565: .B "\fIB\fP DUP I=\fII\fP"
                    566: .br
                    567: Inode \fII\fP contains block number \fIB\fP that
                    568: is already claimed by another inode.
                    569: This error condition will always invoke the
                    570: .B "BAD/DUP"
                    571: error condition in Phase 2.
                    572: You can determine which inodes have overlapping blocks by examining
                    573: this error condition and the DUP error condition in Phase 1.
                    574: .NH 2 
                    575: Phase 2 \- Check Pathnames
                    576: .PP
                    577: This phase concerns itself with removing directory entries
                    578: pointing to
                    579: error conditioned inodes
                    580: from Phase 1 and Phase 1b.
                    581: This section lists error conditions resulting from
                    582: root inode mode and status,
                    583: directory inode pointers in range,
                    584: and directory entries pointing to bad inodes,
                    585: and directory integrity checks.
                    586: All errors in this phase are fatal if the file system is being preen'ed,
                    587: except for directories not being a multiple of the blocks size
                    588: and extraneous hard links.
                    589: .sp
                    590: .LP
                    591: .B "ROOT INODE UNALLOCATED (ALLOCATE)"
                    592: .br
                    593: The root inode (usually inode number 2) has no allocate mode bits.
                    594: This should never happen.
                    595: .LP
                    596: Possible responses to the ALLOCATE prompt are:
                    597: .IP YES
                    598: allocate inode 2 as the root inode.
                    599: The files and directories usually found in the root will be recovered
                    600: in Phase 3 and put into
                    601: .I lost+found .
                    602: If the attempt to allocate the root fails,
                    603: .I fsck
                    604: will exit with the message:
                    605: .br
                    606: .B "CANNOT ALLOCATE ROOT INODE" .
                    607: .IP NO
                    608: .I fsck
                    609: will exit.
                    610: .sp
                    611: .LP
                    612: .B "ROOT INODE NOT DIRECTORY (REALLOCATE)"
                    613: .br
                    614: The root inode (usually inode number 2)
                    615: is not directory inode type.
                    616: .LP
                    617: Possible responses to the REALLOCATE prompt are:
                    618: .IP YES
                    619: clear the existing contents of the root inode
                    620: and reallocate it.
                    621: The files and directories usually found in the root will be recovered
                    622: in Phase 3 and put into
                    623: .I lost+found .
                    624: If the attempt to allocate the root fails,
                    625: .I fsck
                    626: will exit with the message:
                    627: .br
                    628: .B "CANNOT ALLOCATE ROOT INODE" .
                    629: .IP NO
                    630: .I fsck
                    631: will then prompt with
                    632: .B "FIX"
                    633: .LP
                    634: Possible responses to the FIX prompt are:
                    635: .IP YES
                    636: replace the root inode's type to be a directory.
                    637: If the root inode's data blocks are not directory blocks,
                    638: many error conditions will be produced.
                    639: .IP NO
                    640: terminate the program.
                    641: .sp
                    642: .LP
                    643: .B "DUPS/BAD IN ROOT INODE (REALLOCATE)"
                    644: .br
                    645: Phase 1 or Phase 1b have found duplicate blocks
                    646: or bad blocks in the root inode (usually inode number 2) for the file system.
                    647: .LP
                    648: Possible responses to the REALLOCATE prompt are:
                    649: .IP YES
                    650: clear the existing contents of the root inode
                    651: and reallocate it.
                    652: The files and directories usually found in the root will be recovered
                    653: in Phase 3 and put into
                    654: .I lost+found .
                    655: If the attempt to allocate the root fails,
                    656: .I fsck
                    657: will exit with the message:
                    658: .br
                    659: .B "CANNOT ALLOCATE ROOT INODE" .
                    660: .IP NO
                    661: .I fsck
                    662: will then prompt with
                    663: .B "CONTINUE" .
                    664: .LP
                    665: Possible responses to the CONTINUE prompt are:
                    666: .IP YES
                    667: ignore the
                    668: .B "DUPS/BAD"
                    669: error condition in the root inode and
                    670: attempt to continue to run the file system check.
                    671: If the root inode is not correct,
                    672: then this may result in many other error conditions.
                    673: .IP NO
                    674: terminate the program.
                    675: .sp
                    676: .LP
                    677: .B "NAME TOO LONG \fIF\fP"
                    678: .br
                    679: An excessively long path name has been found.
                    680: This usually indicates loops in the file system name space.
                    681: This can occur if the super user has made circular links to directories.
                    682: The offending links must be removed (by a guru).
                    683: .sp
                    684: .LP
                    685: .B "I OUT OF RANGE I=\fII\fP NAME=\fIF\fP (REMOVE)"
                    686: .br
                    687: A directory entry \fIF\fP has an inode number \fII\fP that is greater than
                    688: the end of the inode list.
                    689: .LP
                    690: Possible responses to the REMOVE prompt are:
                    691: .IP YES
                    692: the directory entry \fIF\fP is removed.
                    693: .IP NO
                    694: ignore this error condition.
                    695: .sp
                    696: .LP
                    697: .B "UNALLOCATED I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP \fItype\fP=\fIF\fP (REMOVE)"
                    698: .br
                    699: A directory or file entry \fIF\fP points to an unallocated inode \fII\fP.
                    700: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, modify time \fIT\fP,
                    701: and name \fIF\fP are printed.
                    702: .LP
                    703: Possible responses to the REMOVE prompt are:
                    704: .IP YES
                    705: the directory entry \fIF\fP is removed.
                    706: .IP NO
                    707: ignore this error condition.
                    708: .sp
                    709: .LP
                    710: .B "DUP/BAD I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP \fItype\fP=\fIF\fP (REMOVE)"
                    711: .br
                    712: Phase 1 or Phase 1b have found duplicate blocks or bad blocks
                    713: associated with directory or file entry \fIF\fP, inode \fII\fP.
                    714: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, modify time \fIT\fP,
                    715: and directory name \fIF\fP are printed.
                    716: .LP
                    717: Possible responses to the REMOVE prompt are:
                    718: .IP YES
                    719: the directory entry \fIF\fP is removed.
                    720: .IP NO
                    721: ignore this error condition.
                    722: .sp
                    723: .LP
                    724: .B "ZERO LENGTH DIRECTORY I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (REMOVE)"
                    725: .br
                    726: A directory entry \fIF\fP has a size \fIS\fP that is zero.
                    727: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, modify time \fIT\fP,
                    728: and directory name \fIF\fP are printed.
                    729: .LP
                    730: Possible responses to the REMOVE prompt are:
                    731: .IP YES
                    732: the directory entry \fIF\fP is removed;
                    733: this will always invoke the BAD/DUP error condition in Phase 4.
                    734: .IP NO
                    735: ignore this error condition.
                    736: .sp
                    737: .LP
                    738: .B "DIRECTORY TOO SHORT I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    739: .br
                    740: A directory \fIF\fP has been found whose size \fIS\fP
                    741: is less than the minimum size directory.
                    742: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, modify time \fIT\fP,
                    743: and directory name \fIF\fP are printed.
                    744: .LP
                    745: Possible responses to the FIX prompt are:
                    746: .IP YES
                    747: increase the size of the directory to the minimum directory size.
                    748: .IP NO
                    749: ignore this directory.
                    750: .sp
                    751: .LP
                    752: .B "DIRECTORY \fIF\fP LENGTH \fIS\fP NOT MULTIPLE OF \fIB\fP (ADJUST)
                    753: .br
                    754: A directory \fIF\fP has been found with size \fIS\fP that is not
                    755: a multiple of the directory blocksize \fIB\fP.
                    756: .LP
                    757: Possible responses to the ADJUST prompt are:
                    758: .IP YES
                    759: the length is rounded up to the appropriate block size.
                    760: This error can occur on 4.2BSD file systems.
                    761: Thus when preen'ing the file system only a warning is printed
                    762: and the directory is adjusted.
                    763: .IP NO
                    764: ignore the error condition.
                    765: .sp
                    766: .LP
                    767: .B "DIRECTORY CORRUPTED I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (SALVAGE)"
                    768: .br
                    769: A directory with an inconsistent internal state has been found.
                    770: .LP
                    771: Possible responses to the FIX prompt are:
                    772: .IP YES
                    773: throw away all entries up to the next directory boundary (usually 512-byte)
                    774: boundary.
                    775: This drastic action can throw away up to 42 entries,
                    776: and should be taken only after other recovery efforts have failed.
                    777: .IP NO
                    778: skip up to the next directory boundary and resume reading,
                    779: but do not modify the directory.
                    780: .sp
                    781: .LP
                    782: .B "BAD INODE NUMBER FOR `.' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    783: .br
                    784: A directory \fII\fP has been found whose inode number for `.' does
                    785: does not equal \fII\fP.
                    786: .LP
                    787: Possible responses to the FIX prompt are:
                    788: .IP YES
                    789: change the inode number for `.' to be equal to \fII\fP.
                    790: .IP NO
                    791: leave the inode number for `.' unchanged.
                    792: .sp
                    793: .LP
                    794: .B "MISSING `.' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    795: .br
                    796: A directory \fII\fP has been found whose first entry is unallocated.
                    797: .LP
                    798: Possible responses to the FIX prompt are:
                    799: .IP YES
                    800: build an entry for `.' with inode number equal to \fII\fP.
                    801: .IP NO
                    802: leave the directory unchanged.
                    803: .sp
                    804: .LP
                    805: .B "MISSING `.' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP"
                    806: .br
                    807: .B "CANNOT FIX, FIRST ENTRY IN DIRECTORY CONTAINS \fIF\fP"
                    808: .br
                    809: A directory \fII\fP has been found whose first entry is \fIF\fP.
                    810: .I Fsck
                    811: cannot resolve this problem. 
                    812: The file system should be mounted and the offending entry \fIF\fP
                    813: moved elsewhere.
                    814: The file system should then be unmounted and
                    815: .I fsck
                    816: should be run again.
                    817: .sp
                    818: .LP
                    819: .B "MISSING `.' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP"
                    820: .br
                    821: .B "CANNOT FIX, INSUFFICIENT SPACE TO ADD `.'"
                    822: .br
                    823: A directory \fII\fP has been found whose first entry is not `.'.
                    824: .I Fsck
                    825: cannot resolve this problem as it should never happen.
                    826: See a guru.
                    827: .sp
                    828: .LP
                    829: .B "EXTRA `.' ENTRY I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    830: .br
                    831: A directory \fII\fP has been found that has more than one entry for `.'.
                    832: .LP
                    833: Possible responses to the FIX prompt are:
                    834: .IP YES
                    835: remove the extra entry for `.'.
                    836: .IP NO
                    837: leave the directory unchanged.
                    838: .sp
                    839: .LP
                    840: .B "BAD INODE NUMBER FOR `..' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    841: .br
                    842: A directory \fII\fP has been found whose inode number for `..' does
                    843: does not equal the parent of \fII\fP.
                    844: .LP
                    845: Possible responses to the FIX prompt are:
                    846: .IP YES
                    847: change the inode number for `..' to be equal to the parent of \fII\fP
                    848: (``\fB..\fP'' in the root inode points to itself).
                    849: .IP NO
                    850: leave the inode number for `..' unchanged.
                    851: .sp
                    852: .LP
                    853: .B "MISSING `..' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    854: .br
                    855: A directory \fII\fP has been found whose second entry is unallocated.
                    856: .LP
                    857: Possible responses to the FIX prompt are:
                    858: .IP YES
                    859: build an entry for `..' with inode number equal to the parent of \fII\fP
                    860: (``\fB..\fP'' in the root inode points to itself).
                    861: .IP NO
                    862: leave the directory unchanged.
                    863: .sp
                    864: .LP
                    865: .B "MISSING `..' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP"
                    866: .br
                    867: .B "CANNOT FIX, SECOND ENTRY IN DIRECTORY CONTAINS \fIF\fP"
                    868: .br
                    869: A directory \fII\fP has been found whose second entry is \fIF\fP.
                    870: .I Fsck
                    871: cannot resolve this problem. 
                    872: The file system should be mounted and the offending entry \fIF\fP
                    873: moved elsewhere.
                    874: The file system should then be unmounted and
                    875: .I fsck
                    876: should be run again.
                    877: .sp
                    878: .LP
                    879: .B "MISSING `..' I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP"
                    880: .br
                    881: .B "CANNOT FIX, INSUFFICIENT SPACE TO ADD `..'"
                    882: .br
                    883: A directory \fII\fP has been found whose second entry is not `..'.
                    884: .I Fsck
                    885: cannot resolve this problem.
                    886: The file system should be mounted and the second entry in the directory
                    887: moved elsewhere.
                    888: The file system should then be unmounted and
                    889: .I fsck
                    890: should be run again.
                    891: .sp
                    892: .LP
                    893: .B "EXTRA `..' ENTRY I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP DIR=\fIF\fP (FIX)"
                    894: .br
                    895: A directory \fII\fP has been found that has more than one entry for `..'.
                    896: .LP
                    897: Possible responses to the FIX prompt are:
                    898: .IP YES
                    899: remove the extra entry for `..'.
                    900: .IP NO
                    901: leave the directory unchanged.
                    902: .sp
                    903: .LP
                    904: .B "\fIN\fP IS AN EXTRANEOUS HARD LINK TO A DIRECTORY \fID\fP (REMOVE)
                    905: .br
                    906: .I Fsck
                    907: has found a hard link, \fIN\fP, to a directory, \fID\fP.
                    908: When preen'ing the extraneous links are ignored.
                    909: .LP
                    910: Possible responses to the REMOVE prompt are:
                    911: .IP YES
                    912: delete the extraneous entry, \fIN\fP.
                    913: .IP NO
                    914: ignore the error condition.
                    915: .sp
                    916: .LP
                    917: .B "BAD INODE \fIS\fP TO DESCEND"
                    918: .br
                    919: An internal error has caused an impossible state \fIS\fP to be passed to the
                    920: routine that descends the file system directory structure.
                    921: .I Fsck
                    922: exits.
                    923: See a guru.
                    924: .sp
                    925: .LP
                    926: .B "BAD RETURN STATE \fIS\fP FROM DESCEND"
                    927: .br
                    928: An internal error has caused an impossible state \fIS\fP to be returned
                    929: from the routine that descends the file system directory structure.
                    930: .I Fsck
                    931: exits.
                    932: See a guru.
                    933: .sp
                    934: .LP
                    935: .B "BAD STATE \fIS\fP FOR ROOT INODE"
                    936: .br
                    937: An internal error has caused an impossible state \fIS\fP to be assigned
                    938: to the root inode.
                    939: .I Fsck
                    940: exits.
                    941: See a guru.
                    942: .NH 2 
                    943: Phase 3 \- Check Connectivity
                    944: .PP
                    945: This phase concerns itself with the directory connectivity seen in
                    946: Phase 2.
                    947: This section lists error conditions resulting from
                    948: unreferenced directories,
                    949: and missing or full
                    950: .I lost+found
                    951: directories.
                    952: .sp
                    953: .LP
                    954: .B "UNREF DIR I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP (RECONNECT)"
                    955: .br
                    956: The directory inode \fII\fP was not connected to a directory entry
                    957: when the file system was traversed.
                    958: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, and
                    959: modify time \fIT\fP of directory inode \fII\fP are printed.
                    960: When preen'ing, the directory is reconnected if its size is non-zero,
                    961: otherwise it is cleared.
                    962: .LP
                    963: Possible responses to the RECONNECT prompt are:
                    964: .IP YES
                    965: reconnect directory inode \fII\fP to the file system in the
                    966: directory for lost files (usually \fIlost+found\fP).
                    967: This may invoke the
                    968: .I lost+found
                    969: error condition in Phase 3
                    970: if there are problems connecting directory inode \fII\fP to \fIlost+found\fP.
                    971: This may also invoke the CONNECTED error condition in Phase 3 if the link
                    972: was successful.
                    973: .IP NO
                    974: ignore this error condition.
                    975: This will always invoke the UNREF error condition in Phase 4.
                    976: .sp
                    977: .LP
                    978: .B "NO lost+found DIRECTORY (CREATE)"
                    979: .br
                    980: There is no
                    981: .I lost+found
                    982: directory in the root directory of the file system;
                    983: When preen'ing
                    984: .I fsck
                    985: tries to create a \fIlost+found\fP directory.
                    986: .LP
                    987: Possible responses to the CREATE prompt are:
                    988: .IP YES
                    989: create a \fIlost+found\fP directory in the root of the file system.
                    990: This may raise the message:
                    991: .br
                    992: .B "NO SPACE LEFT IN / (EXPAND)"
                    993: .br
                    994: See below for the possible responses.
                    995: Inability to create a \fIlost+found\fP directory generates the message:
                    996: .br
                    997: .B "SORRY. CANNOT CREATE lost+found DIRECTORY"
                    998: .br
                    999: and aborts the attempt to linkup the lost inode.
                   1000: This will always invoke the UNREF error condition in Phase 4.
                   1001: .IP NO
                   1002: abort the attempt to linkup the lost inode.
                   1003: This will always invoke the UNREF error condition in Phase 4.
                   1004: .sp
                   1005: .LP
                   1006: .B "lost+found IS NOT A DIRECTORY (REALLOCATE)"
                   1007: .br
                   1008: The entry for
                   1009: .I lost+found
                   1010: is not a directory.
                   1011: .LP
                   1012: Possible responses to the REALLOCATE prompt are:
                   1013: .IP YES
                   1014: allocate a directory inode, and change \fIlost+found\fP to reference it.
                   1015: The previous inode reference by the \fIlost+found\fP name is not cleared.
                   1016: Thus it will either be reclaimed as an UNREF'ed inode or have its
                   1017: link count ADJUST'ed later in this Phase.
                   1018: Inability to create a \fIlost+found\fP directory generates the message:
                   1019: .br
                   1020: .B "SORRY. CANNOT CREATE lost+found DIRECTORY"
                   1021: .br
                   1022: and aborts the attempt to linkup the lost inode.
                   1023: This will always invoke the UNREF error condition in Phase 4.
                   1024: .IP NO
                   1025: abort the attempt to linkup the lost inode.
                   1026: This will always invoke the UNREF error condition in Phase 4.
                   1027: .sp
                   1028: .LP
                   1029: .B "NO SPACE LEFT IN /lost+found (EXPAND)"
                   1030: .br
                   1031: There is no space to add another entry to the
                   1032: .I lost+found
                   1033: directory in the root directory
                   1034: of the file system.
                   1035: When preen'ing the 
                   1036: .I lost+found
                   1037: directory is expanded.
                   1038: .LP
                   1039: Possible responses to the EXPAND prompt are:
                   1040: .IP YES
                   1041: the 
                   1042: .I lost+found
                   1043: directory is expanded to make room for the new entry.
                   1044: If the attempted expansion fails
                   1045: .I fsck
                   1046: prints the message:
                   1047: .br
                   1048: .B "SORRY. NO SPACE IN lost+found DIRECTORY"
                   1049: .br
                   1050: and aborts the attempt to linkup the lost inode.
                   1051: This will always invoke the UNREF error condition in Phase 4.
                   1052: Clean out unnecessary entries in
                   1053: .I lost+found .
                   1054: This error is fatal if the file system is being preen'ed.
                   1055: .IP NO
                   1056: abort the attempt to linkup the lost inode.
                   1057: This will always invoke the UNREF error condition in Phase 4.
                   1058: .sp
                   1059: .LP
                   1060: .B "DIR I=\fII1\fP CONNECTED. PARENT WAS I=\fII2\fP"
                   1061: .br
                   1062: This is an advisory message indicating a directory inode \fII1\fP was
                   1063: successfully connected to the
                   1064: .I lost+found
                   1065: directory.
                   1066: The parent inode \fII2\fP of the directory inode \fII1\fP is
                   1067: replaced by the inode number of the
                   1068: .I lost+found
                   1069: directory.
                   1070: .sp
                   1071: .LP
                   1072: .B "DIRECTORY \fIF\fP LENGTH \fIS\fP NOT MULTIPLE OF \fIB\fP (ADJUST)
                   1073: .br
                   1074: A directory \fIF\fP has been found with size \fIS\fP that is not
                   1075: a multiple of the directory blocksize \fIB\fP
                   1076: (this can reoccur in Phase 3 if it is not adjusted in Phase 2).
                   1077: .LP
                   1078: Possible responses to the ADJUST prompt are:
                   1079: .IP YES
                   1080: the length is rounded up to the appropriate block size.
                   1081: This error can occur on 4.2BSD file systems.
                   1082: Thus when preen'ing the file system only a warning is printed
                   1083: and the directory is adjusted.
                   1084: .IP NO
                   1085: ignore the error condition.
                   1086: .sp
                   1087: .LP
                   1088: .B "BAD INODE \fIS\fP TO DESCEND"
                   1089: .br
                   1090: An internal error has caused an impossible state \fIS\fP to be passed to the
                   1091: routine that descends the file system directory structure.
                   1092: .I Fsck
                   1093: exits.
                   1094: See a guru.
                   1095: .NH 2 
                   1096: Phase 4 \- Check Reference Counts
                   1097: .PP
                   1098: This phase concerns itself with the link count information
                   1099: seen in Phase 2 and Phase 3.
                   1100: This section lists error conditions resulting from
                   1101: unreferenced files,
                   1102: missing or full
                   1103: .I lost+found
                   1104: directory,
                   1105: incorrect link counts for files, directories, symbolic links, or special files,
                   1106: unreferenced files, symbolic links, and directories,
                   1107: and bad or duplicate blocks in files, symbolic links, and directories.
                   1108: All errors in this phase are correctable if the file system is being preen'ed
                   1109: except running out of space in the \fIlost+found\fP directory.
                   1110: .sp
                   1111: .LP
                   1112: .B "UNREF FILE I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP (RECONNECT)"
                   1113: .br
                   1114: Inode \fII\fP was not connected to a directory entry
                   1115: when the file system was traversed.
                   1116: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, and
                   1117: modify time \fIT\fP of inode \fII\fP are printed.
                   1118: When preen'ing the file is cleared if either its size or its
                   1119: link count is zero,
                   1120: otherwise it is reconnected.
                   1121: .LP
                   1122: Possible responses to the RECONNECT prompt are:
                   1123: .IP YES
                   1124: reconnect inode \fII\fP to the file system in the directory for
                   1125: lost files (usually \fIlost+found\fP).
                   1126: This may invoke the
                   1127: .I lost+found
                   1128: error condition in Phase 4
                   1129: if there are problems connecting inode \fII\fP to
                   1130: .I lost+found .
                   1131: .IP NO
                   1132: ignore this error condition.
                   1133: This will always invoke the CLEAR error condition in Phase 4.
                   1134: .sp
                   1135: .LP
                   1136: .B "(CLEAR)"
                   1137: .br
                   1138: The inode mentioned in the immediately previous error condition can not be
                   1139: reconnected.
                   1140: This cannot occur if the file system is being preen'ed,
                   1141: since lack of space to reconnect files is a fatal error.
                   1142: .LP
                   1143: Possible responses to the CLEAR prompt are:
                   1144: .IP YES
                   1145: de-allocate the inode mentioned in the immediately previous error condition by zeroing its contents.
                   1146: .IP NO
                   1147: ignore this error condition.
                   1148: .sp
                   1149: .LP
                   1150: .B "NO lost+found DIRECTORY (CREATE)"
                   1151: .br
                   1152: There is no
                   1153: .I lost+found
                   1154: directory in the root directory of the file system;
                   1155: When preen'ing
                   1156: .I fsck
                   1157: tries to create a \fIlost+found\fP directory.
                   1158: .LP
                   1159: Possible responses to the CREATE prompt are:
                   1160: .IP YES
                   1161: create a \fIlost+found\fP directory in the root of the file system.
                   1162: This may raise the message:
                   1163: .br
                   1164: .B "NO SPACE LEFT IN / (EXPAND)"
                   1165: .br
                   1166: See below for the possible responses.
                   1167: Inability to create a \fIlost+found\fP directory generates the message:
                   1168: .br
                   1169: .B "SORRY. CANNOT CREATE lost+found DIRECTORY"
                   1170: .br
                   1171: and aborts the attempt to linkup the lost inode.
                   1172: This will always invoke the UNREF error condition in Phase 4.
                   1173: .IP NO
                   1174: abort the attempt to linkup the lost inode.
                   1175: This will always invoke the UNREF error condition in Phase 4.
                   1176: .sp
                   1177: .LP
                   1178: .B "lost+found IS NOT A DIRECTORY (REALLOCATE)"
                   1179: .br
                   1180: The entry for
                   1181: .I lost+found
                   1182: is not a directory.
                   1183: .LP
                   1184: Possible responses to the REALLOCATE prompt are:
                   1185: .IP YES
                   1186: allocate a directory inode, and change \fIlost+found\fP to reference it.
                   1187: The previous inode reference by the \fIlost+found\fP name is not cleared.
                   1188: Thus it will either be reclaimed as an UNREF'ed inode or have its
                   1189: link count ADJUST'ed later in this Phase.
                   1190: Inability to create a \fIlost+found\fP directory generates the message:
                   1191: .br
                   1192: .B "SORRY. CANNOT CREATE lost+found DIRECTORY"
                   1193: .br
                   1194: and aborts the attempt to linkup the lost inode.
                   1195: This will always invoke the UNREF error condition in Phase 4.
                   1196: .IP NO
                   1197: abort the attempt to linkup the lost inode.
                   1198: This will always invoke the UNREF error condition in Phase 4.
                   1199: .sp
                   1200: .LP
                   1201: .B "NO SPACE LEFT IN /lost+found (EXPAND)"
                   1202: .br
                   1203: There is no space to add another entry to the
                   1204: .I lost+found
                   1205: directory in the root directory
                   1206: of the file system.
                   1207: When preen'ing the 
                   1208: .I lost+found
                   1209: directory is expanded.
                   1210: .LP
                   1211: Possible responses to the EXPAND prompt are:
                   1212: .IP YES
                   1213: the 
                   1214: .I lost+found
                   1215: directory is expanded to make room for the new entry.
                   1216: If the attempted expansion fails
                   1217: .I fsck
                   1218: prints the message:
                   1219: .br
                   1220: .B "SORRY. NO SPACE IN lost+found DIRECTORY"
                   1221: .br
                   1222: and aborts the attempt to linkup the lost inode.
                   1223: This will always invoke the UNREF error condition in Phase 4.
                   1224: Clean out unnecessary entries in
                   1225: .I lost+found .
                   1226: This error is fatal if the file system is being preen'ed.
                   1227: .IP NO
                   1228: abort the attempt to linkup the lost inode.
                   1229: This will always invoke the UNREF error condition in Phase 4.
                   1230: .sp
                   1231: .LP
                   1232: .B "LINK COUNT \fItype\fP I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP COUNT=\fIX\fP SHOULD BE \fIY\fP (ADJUST)"
                   1233: .br
                   1234: The link count for inode \fII\fP,
                   1235: is \fIX\fP but should be \fIY\fP.
                   1236: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP, and modify time \fIT\fP
                   1237: are printed.
                   1238: When preen'ing the link count is adjusted unless the number of references
                   1239: is increasing, a condition that should never occur unless precipitated
                   1240: by a hardware failure.
                   1241: When the number of references is increasing under preen mode,
                   1242: .I fsck
                   1243: exits with the message:
                   1244: .br
                   1245: .B "LINK COUNT INCREASING"
                   1246: .LP
                   1247: Possible responses to the ADJUST prompt are:
                   1248: .IP YES
                   1249: replace the link count of file inode \fII\fP with \fIY\fP.
                   1250: .IP NO
                   1251: ignore this error condition.
                   1252: .sp
                   1253: .LP
                   1254: .B "UNREF \fItype\fP I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP (CLEAR)"
                   1255: .br
                   1256: Inode \fII\fP, was not connected to a directory entry when the
                   1257: file system was traversed.
                   1258: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP,
                   1259: and modify time \fIT\fP of inode \fII\fP
                   1260: are printed.
                   1261: When preen'ing,
                   1262: this is a file that was not connected because its size or link count was zero,
                   1263: hence it is cleared.
                   1264: .LP
                   1265: Possible responses to the CLEAR prompt are:
                   1266: .IP YES
                   1267: de-allocate inode \fII\fP by zeroing its contents.
                   1268: .IP NO
                   1269: ignore this error condition.
                   1270: .sp
                   1271: .LP
                   1272: .B "BAD/DUP \fItype\fP I=\fII\fP OWNER=\fIO\fP MODE=\fIM\fP SIZE=\fIS\fP MTIME=\fIT\fP (CLEAR)"
                   1273: .br
                   1274: Phase 1 or Phase 1b have found duplicate blocks
                   1275: or bad blocks associated with
                   1276: inode \fII\fP.
                   1277: The owner \fIO\fP, mode \fIM\fP, size \fIS\fP,
                   1278: and modify time \fIT\fP of inode \fII\fP
                   1279: are printed.
                   1280: This error cannot arise when the file system is being preen'ed,
                   1281: as it would have caused a fatal error earlier.
                   1282: .LP
                   1283: Possible responses to the CLEAR prompt are:
                   1284: .IP YES
                   1285: de-allocate inode \fII\fP by zeroing its contents.
                   1286: .IP NO
                   1287: ignore this error condition.
                   1288: .NH 2 
                   1289: Phase 5 - Check Cyl groups
                   1290: .PP
                   1291: This phase concerns itself with the free-block and used-inode maps.
                   1292: This section lists error conditions resulting from
                   1293: allocated blocks in the free-block maps,
                   1294: free blocks missing from free-block maps,
                   1295: and the total free-block count incorrect.
                   1296: It also lists error conditions resulting from
                   1297: free inodes in the used-inode maps,
                   1298: allocated inodes missing from used-inode maps,
                   1299: and the total used-inode count incorrect.
                   1300: .sp
                   1301: .LP
                   1302: .B "CG \fIC\fP: BAD MAGIC NUMBER"
                   1303: .br
                   1304: The magic number of cylinder group \fIC\fP is wrong.
                   1305: This usually indicates that the cylinder group maps have been destroyed.
                   1306: When running manually the cylinder group is marked as needing
                   1307: to be reconstructed.
                   1308: This error is fatal if the file system is being preen'ed.
                   1309: .sp
                   1310: .LP
                   1311: .B "BLK(S) MISSING IN BIT MAPS (SALVAGE)"
                   1312: .br
                   1313: A cylinder group block map is missing some free blocks.
                   1314: During preen'ing the maps are reconstructed.
                   1315: .LP
                   1316: Possible responses to the SALVAGE prompt are:
                   1317: .IP YES
                   1318: reconstruct the free block map.
                   1319: .IP NO
                   1320: ignore this error condition.
                   1321: .sp
                   1322: .LP
                   1323: .B "SUMMARY INFORMATION BAD (SALVAGE)"
                   1324: .br
                   1325: The summary information was found to be incorrect.
                   1326: When preen'ing,
                   1327: the summary information is recomputed.
                   1328: .LP
                   1329: Possible responses to the SALVAGE prompt are:
                   1330: .IP YES
                   1331: reconstruct the summary information.
                   1332: .IP NO
                   1333: ignore this error condition.
                   1334: .sp
                   1335: .LP
                   1336: .B "FREE BLK COUNT(S) WRONG IN SUPERBLOCK (SALVAGE)"
                   1337: .br
                   1338: The superblock free block information was found to be incorrect.
                   1339: When preen'ing,
                   1340: the superblock free block information is recomputed.
                   1341: .LP
                   1342: Possible responses to the SALVAGE prompt are:
                   1343: .IP YES
                   1344: reconstruct the superblock free block information.
                   1345: .IP NO
                   1346: ignore this error condition.
                   1347: .NH 2 
                   1348: Cleanup
                   1349: .PP
                   1350: Once a file system has been checked, a few cleanup functions are performed.
                   1351: This section lists advisory messages about
                   1352: the file system
                   1353: and modify status of the file system.
                   1354: .sp
                   1355: .LP
                   1356: .B "\fIV\fP files, \fIW\fP used, \fIX\fP free (\fIY\fP frags, \fIZ\fP blocks)"
                   1357: .br
                   1358: This is an advisory message indicating that
                   1359: the file system checked contained
                   1360: \fIV\fP files using
                   1361: \fIW\fP fragment sized blocks leaving
                   1362: \fIX\fP fragment sized blocks free in the file system.
                   1363: The numbers in parenthesis breaks the free count down into
                   1364: \fIY\fP free fragments and
                   1365: \fIZ\fP free full sized blocks.
                   1366: .sp
                   1367: .LP
                   1368: .B "***** REBOOT UNIX *****"
                   1369: .br
                   1370: This is an advisory message indicating that
                   1371: the root file system has been modified by
                   1372: .I fsck.
                   1373: If UNIX is not rebooted immediately,
                   1374: the work done by
                   1375: .I fsck
                   1376: may be undone by the in-core copies of tables
                   1377: UNIX keeps.
                   1378: When preen'ing,
                   1379: .I fsck
                   1380: will exit with a code of 4.
                   1381: The standard auto-reboot script distributed with 4.3BSD 
                   1382: interprets an exit code of 4 by issuing a reboot system call.
                   1383: .sp
                   1384: .LP
                   1385: .B "***** FILE SYSTEM WAS MODIFIED *****"
                   1386: .br
                   1387: This is an advisory message indicating that
                   1388: the current file system was modified by
                   1389: .I fsck.
                   1390: If this file system is mounted or is the current root file system,
                   1391: .I fsck
                   1392: should be halted and UNIX rebooted.
                   1393: If UNIX is not rebooted immediately,
                   1394: the work done by
                   1395: .I fsck
                   1396: may be undone by the in-core copies of tables
                   1397: UNIX keeps.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.