vitalif
/
e2fsprogs
mirror of https://github.com/vitalif/e2fsprogs
1
0
Fork 0
Code Issues Releases Wiki Activity
e2fsprogs/misc/badblocks.8.in

100 lines
2.2 KiB
Groff
Raw Normal View History

Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.\" -*- nroff -*-
Many files: Checkin of e2fsprogs 1.02.
1997-04-26 18:37:06 +04:00
.TH BADBLOCKS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.SH NAME
badblocks \- search a device for bad blocks
.SH SYNOPSIS
.B badblocks
[
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.B \-svwn
]
[
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.B \-b
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.I block-size
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
]
[
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.B \-c
.I blocks_at_once
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
]
[
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.B \-i
.I input_file
Many files: resize2fs.h: If EXT2_FLAT_INCLUDES is defined, then assume all of the ext2-specific header files are in a flat directory. ext2_block_move.c, ext2_inode_move.c, extent.c, resize2fs.c, resize2fs.h: Rename variables named "new" to "new_block", "new_inode", or "new_loc" to avoid C++ reserved word clash. ext2_block_move.c, ext2_inode_move.c, extent.c, resize2fs.c, sim_progress.c: Use ext2fs_get_memory(), ext2fs_free_memory(), et. al., instead of malloc() and free(). ext2_block_move.c, ext2_inode_move.c, extent.c: Explicitly cast all assignments from void * to be compatible with C++. banalysis.c, banalysis.h, ext2_inode_move.c, ext2_block_move.c: Change private to priv_data to avoid C++ namespace clash. ChangeLog, badblocks.8.in: badblocks.8.in: Add documentation for the -s option.
1998-01-19 17:55:24 +03:00
]
[
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.B \-o
.I output_file
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
]
[
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.B \-p
.I num_passes
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
]
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.I device
.IR blocks-count [ start-block ]
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.SH DESCRIPTION
.B badblocks
is used to search for bad blocks on a device (usually a disk partition).
.I device
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
is the special file corresponding to the device (e.g
.IR /dev/hdc1 ).
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.I blocks-count
is the number of blocks on the device.
.SH OPTIONS
.TP
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.BI \-b " block-size"
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
Specify the size of blocks in bytes.
.TP
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.BI \-c " number of blocks"
is the number of blocks which are tested at a time. The default is 16.
.TP
.BI \-i " input_file"
Read a list of already existing known bad blocks. Badblocks will skip
testing these blocks since they are known bad.
.TP
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.BI \-o " output_file"
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
Write the list of bad blocks to the specified file. Without this option,
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.B badblocks
ChangeLog, badblocks.8.in, mke2fs.c: badblocks.8: Update documentation to note that output format of badblocks is suitable for use with e2fsck -l or mke2fs -l. mke2fs.c (handle_bad_blocks): Fix bug so that all groups with bad superblock backup blocks are printed (not just the first one).
1998-02-17 01:29:34 +03:00
displays the list on its standard output. The format of this file is suitable
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
for use by the
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.B \-l
option in
ChangeLog, badblocks.8.in, mke2fs.c: badblocks.8: Update documentation to note that output format of badblocks is suitable for use with e2fsck -l or mke2fs -l. mke2fs.c (handle_bad_blocks): Fix bug so that all groups with bad superblock backup blocks are printed (not just the first one).
1998-02-17 01:29:34 +03:00
.BR e2fsck (8)
or
.BR mke2fs (8).
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.TP
ChangeLog, badblocks.8.in, badblocks.c: badblocks.c: Fix non-destructive read/write patches from David Beattie. Non-standard variable-length automatic arrays removed. Non-destrutive write test fixed so that logic is clearer and more provably correct. (I believe the old code had a bug where the disk data wasn't restored if it was interrupted at the wrong time.) badblocks.8.in: Document new options in man page.
2000-02-07 02:57:07 +03:00
.BI \-p " num_passes"
Repeat scanning the disk until there are no new blocks discovered after
num_passes scans of the disk.
.TP
.B \-n
Use non-destructive read-write mode.
.TP
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.B \-s
Many files: resize2fs.h: If EXT2_FLAT_INCLUDES is defined, then assume all of the ext2-specific header files are in a flat directory. ext2_block_move.c, ext2_inode_move.c, extent.c, resize2fs.c, resize2fs.h: Rename variables named "new" to "new_block", "new_inode", or "new_loc" to avoid C++ reserved word clash. ext2_block_move.c, ext2_inode_move.c, extent.c, resize2fs.c, sim_progress.c: Use ext2fs_get_memory(), ext2fs_free_memory(), et. al., instead of malloc() and free(). ext2_block_move.c, ext2_inode_move.c, extent.c: Explicitly cast all assignments from void * to be compatible with C++. banalysis.c, banalysis.h, ext2_inode_move.c, ext2_block_move.c: Change private to priv_data to avoid C++ namespace clash. ChangeLog, badblocks.8.in: badblocks.8.in: Add documentation for the -s option.
1998-01-19 17:55:24 +03:00
Show the progress of the scan by writing out the block numbers as they
are checked.
.TP
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.B \-v
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
Verbose mode.
.TP
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
.B \-w
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
Use write-mode test. With this option,
.B badblocks
scans for bad blocks by writing some patterns (0xaa, 0x55, 0xff, 0x00) on
every block of the device, reading every block and comparing the contents.
.SH WARNING
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in, fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in, tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, e2fsck.8.in: e2fsck.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca) ChangeLog, uuid_generate.3.in: uuid_generate.8.in: Update man page to use a more standard format (bold option flags and italicized variables), as suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
Never use the
.B \-w
option on an device containing an existing file system.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
This option erases data!
.SH AUTHOR
.B badblocks
Many files: badblocks.8.in, chattr.1.in, dumpe2fs.8.in, lsattr.1.in, mklost+found.8.in, tune2fs.8.in: Update Remy Card's e-mail address. chattr.1.in: Update which attributes aren't supported.
2000-04-03 17:27:41 +04:00
was written by Remy Card <Remy.Card@linux.org>. Current maintainer is
Theodore Ts'o <tytso@alum.mit.edu>. Non-destructive read/write test
implemented by David Beattie <dbeattie@usa.net>.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.SH AVAILABILITY
.B badblocks
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 05:20:55 +04:00
is part of the e2fsprogs package and is available for anonymous
ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 17:21:57 +04:00
.SH SEE ALSO
.BR e2fsck (8),
.BR mke2fs (8)