misc/badblocks.8.in

   1 .\" -*- nroff -*-
   2 .TH BADBLOCKS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
   3 .SH NAME
   4 badblocks \- search a device for bad blocks
   5 .SH SYNOPSIS
   6 .B badblocks
   7 [
   8 .B \-b
   9 .I block-size
  10 ]
  11 [
  12 .B \-o
  13 .I output_file
  14 ]
  15 [
  16 .B \-s
  17 ]
  18 [
  19 .B \-v
  20 ]
  21 [
  22 .B \-w
  23 ]
  24 .I device
  25 .IR blocks-count [ start-block ]
  26 .SH DESCRIPTION
  27 .B badblocks
  28 is used to search for bad blocks on a device (usually a disk partition).
  29 .I device
  30 is the special file corresponding to the device (e.g
  31 .IR /dev/hdc1 ).
  32 .I blocks-count
  33 is the number of blocks on the device.
  34 .SH OPTIONS
  35 .TP
  36 .BI \-b " block-size"
  37 Specify the size of blocks in bytes.
  38 .TP
  39 .BI \-o " output_file"
  40 Write the list of bad blocks to the specified file. Without this option,
  41 .B badblocks
  42 displays the list on its standard output.  The format of this file is suitable
  43 for use by the
  44 .B \-l
  45 option in
  46 .BR e2fsck (8)
  47 or
  48 .BR mke2fs (8).
  49 .TP
  50 .B \-s
  51 Show the progress of the scan by writing out the block numbers as they
  52 are checked.
  53 .TP
  54 .B \-v
  55 Verbose mode.
  56 .TP
  57 .B \-w
  58 Use write-mode test. With this option,
  59 .B badblocks
  60 scans for bad blocks by writing some patterns (0xaa, 0x55, 0xff, 0x00) on
  61 every block of the device, reading every block and comparing the contents.
  62 .SH WARNING
  63 Never use the
  64 .B \-w
  65 option on an device containing an existing file system.
  66 This option erases data!
  67 .SH AUTHOR
  68 .B badblocks
  69 was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
  70 of the ext2 fs.
  71 .SH BUGS
  72 I had no chance to make real tests of this program since I use IDE drives,
  73 which remap bad blocks. I only made some tests on floppies.
  74 .SH AVAILABILITY
  75 .B badblocks
  76 is part of the e2fsprogs package and is available for anonymous
  77 ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
  78 .SH SEE ALSO
  79 .BR e2fsck (8),
  80 .BR mke2fs (8)