diff options
Diffstat (limited to 'system/bbf')
| -rw-r--r-- | system/bbf/README | 9 | ||||
| -rw-r--r-- | system/bbf/bbf.8 | 416 | ||||
| -rw-r--r-- | system/bbf/bbf.SlackBuild | 73 | ||||
| -rw-r--r-- | system/bbf/bbf.info | 10 | ||||
| -rw-r--r-- | system/bbf/bbf.rst | 320 | ||||
| -rw-r--r-- | system/bbf/git2tarxz.sh | 42 | ||||
| -rw-r--r-- | system/bbf/slack-desc | 19 |
7 files changed, 889 insertions, 0 deletions
diff --git a/system/bbf/README b/system/bbf/README new file mode 100644 index 0000000000..16efd290b3 --- /dev/null +++ b/system/bbf/README @@ -0,0 +1,9 @@ +bbf (bad block finder) + +bbf is a safer and more featureful tool for dealing with bad blocks +on hard drives. It's built around the workflow of dealing with hard +drive bad blocks. It has a number of features to limit risk in using +the tool and provides features to more easily track down what files +are affected by the bad blocks found. It also gives you the ability +to manually mark blocks as corrupted in cases where a block isn't +technically bad, but is causing issues. diff --git a/system/bbf/bbf.8 b/system/bbf/bbf.8 new file mode 100644 index 0000000000..b523dfb2e6 --- /dev/null +++ b/system/bbf/bbf.8 @@ -0,0 +1,416 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "BBF" 8 "2023-03-27" "20220524_0e90e04" "SlackBuilds.org" +.SH NAME +bbf \- bad block finder +.\" RST source for bbf(1) man page. Convert with: +. +.\" rst2man.py bbf.rst > bbf.8 +. +.SH SYNOPSIS +.sp +bbf [\fIoptions\fP] \fIinstruction\fP \fIpath\fP +.SH DESCRIPTION +.sp +\fBbbf\fP is a safer and more featureful tool for dealing with bad +blocks on hard drives. It\(aqs built around the workflow of dealing with +hard drive bad blocks. It has a number of features to limit risk in +using the tool and provides features to more easily track down what +files are affected by the bad blocks found. It also gives you the +ability to manually mark blocks as corrupted in cases where a block +isn\(aqt technically bad, but is causing issues. +.SH FEATURES +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.IP \(bu 2 +readonly scanning of bad blocks +.IP \(bu 2 +safe \(aqfix\(aq mode which won\(aqt overwrite good blocks +.IP \(bu 2 +burnin mode for checking new drives +.IP \(bu 2 +manual marking blocks as corrupted +.IP \(bu 2 +find files given list of blocks +.IP \(bu 2 +dump list of files and associated block ranges +.IP \(bu 2 +dump list of blocks used by a file +.IP \(bu 2 +issue secure drive erasure +.IP \(bu 2 +filesystem stressing +.UNINDENT +.UNINDENT +.UNINDENT +.SH OPTIONS +.SS Arguments +.INDENT 0.0 +.TP +.B \-f\fP,\fB \-\-force +override checking if drive is in use when trying to perform destructive actions +.UNINDENT +.INDENT 0.0 +.TP +.B \-t, \-\-rwtype \fIos|ata\fP +select between OS or ATA reads and writes (default: os) +.UNINDENT +.INDENT 0.0 +.TP +.B \-q\fP,\fB \-\-quiet +redirects stdout to /dev/null or otherwise limits output +.UNINDENT +.INDENT 0.0 +.TP +.B \-s, \-\-start\-block \fIlba\fP +block to start from (default: 0) +.TP +.B \-e, \-\-end\-block \fIlba\fP +block to stop at (default: last block) +.TP +.B \-S, \-\-stepping \fIn\fP +number of logical blocks to read at a time (default: physical / logical) +.TP +.B \-o, \-\-output \fIfile\fP +file to write bad block list to (default: $HOME/badblocks.*captcha*) +.TP +.B \-i, \-\-input \fIfile\fP +file to read bad block list from (default: $HOME/badblocks.*captcha*) +.TP +.B \-r, \-\-retries \fIcount\fP +number of retries on certain reads & writes +.TP +.B \-c, \-\-captcha \fIcaptcha\fP +needed when performing destructive operations +.TP +.B \-M, \-\-maxerrors \fIn\fP +max r/w errors before exiting (default: 1024) +.UNINDENT +.SS Instructions +.sp +\fBinfo\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Prints out details about the block device. +.UNINDENT +.UNINDENT +.sp +\fBcaptcha\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Prints out captcha needed for certain instructions. +.UNINDENT +.UNINDENT +.sp +\fBscan\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. A read\-only scan of the block device for +bad blocks. \fIrwtype=ata\fP will be slower but may catch more. +.sp +Relevant options: rwtype, start block, end block, stepping, max errors, input file, output file. +.UNINDENT +.UNINDENT +.sp +\fBfix\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Writes to bad blocks in an attempt to +force the drive to reallocate the block. Attempts to read the block +first and will write the read data if successful otherwise it will +write zeros. This means it is pretty safe to use even if the blocks +\(aqfixed\(aq aren\(aqt in fact damaged. +.UNINDENT +.UNINDENT +.sp +\fIrwtype=ata\fP will work better. +.INDENT 0.0 +.INDENT 3.5 +Requires captcha. +.sp +Relevant options: captcha, rwtype, force, input file. +.UNINDENT +.UNINDENT +.sp +\fBfix\-file\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a file. Gets the list of blocks that a file uses and then +goes through each block reading what is there and then writing it +back which will force reallocation if a block is bad. +.sp +\fIrwtype=ata\fP will work better. +.sp +Requires captcha. +.sp +Relevant options: captcha, rwtype, retries. +.UNINDENT +.UNINDENT +.sp +\fBburnin\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Iterates through the blocks of the device performing the following: +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.IP 1. 3 +Read block data (zero out on failure) +.IP 2. 3 +Write 0x00\(aqs and read back to confirm data integrity. +.IP 3. 3 +Write 0x55\(aqs and read back to confirm data integrity. +.IP 4. 3 +Write 0xAA\(aqs and read back to confirm data integrity. +.IP 5. 3 +Write 0xFF\(aqs and read back to confirm data integrity. +.IP 6. 3 +Write back originally read data. +.UNINDENT +.UNINDENT +.UNINDENT +.sp +Requires captcha. +.sp +Relevant options: rwtype, start block, end block, stepping, max +errors, retries, input file, output file. +.UNINDENT +.UNINDENT +.sp +\fBfsthrash\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a directory. Spawns a number of threads to hammer the +filesystem using a number of functions to stress the filesystem and +underlying device. Functions include: create, open, mkdir, unlink, +rmdir, write, read, close, readdir, stat, chmod, chown, link, +symlink. Cleans up after itself on exit but does consume storage and +inodes as it runs. +.sp +Use \fI\-\-quiet\fP to keep it from printing out what it is doing and improve performance. +.UNINDENT +.UNINDENT +.sp +\fBfilethrash\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a non\-existent file. Creates a file, expands it to fill +up the rest of the filesystem, and spawns a thread per core which +writes 1MB blocks to the file at random offsets to stress the +filesystem and unerlying device. +.UNINDENT +.UNINDENT +.sp +\fBfind\-files\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a filesystem mount point. Attempts to find the +files associated with any blocks listed in the bad block input +file. Useful after running \fIscan\fP to find the files with bad blocks. +.sp +Relevant options: input file. +.UNINDENT +.UNINDENT +.sp +\fBdump\-files\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a filesystem. Scans the filesystem and dumps a list of the files with the blocks on the device it occupies. +.UNINDENT +.UNINDENT +.sp +\fBfile\-blocks\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is an existing file. Prints out a list of all logical blocks the file uses. +.UNINDENT +.UNINDENT +.sp +\fBwrite\-pseudo\-uncorrectable\-wl\fP +.sp +\fBwrite\-pseudo\-uncorrectable\-wol\fP +.sp +\fBwrite\-flagged\-uncorrectable\-wl\fP +.sp +\fBwrite\-flagged\-uncorrectable\-wol\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Marks blocks listed in the bad block input +file as \(aqpseudo\(aq or \(aqflagged\(aq uncorrectable. Blocks marked \(aqpseudo\(aq, +when read, cause the drive to perform normal error recovery and +return errors if necessary. Blocks marked \(aqflagged\(aq, when read, +will simply return errors indicating it is bad. \(aqwl\(aq means \(aqwith +logging\(aq and if read will result in failed reads being stored in +SMART logs. \(aqwol\(aq means \(aqwithout logging\(aq and will not log any read +failures in the SMART log. +.sp +Relevant options: input file. +.UNINDENT +.UNINDENT +.sp +\fBsecurity\-erase\fP +.INDENT 0.0 +.INDENT 3.5 +\fIpath\fP is a block device. Issues an ATA Security Erase command to +the device. What this means specifically is device specific but +generally it is supposed to be like a low\-level format. Use with +care. +.sp +Requires captcha. +.sp +Relevant options: captcha. +.UNINDENT +.UNINDENT +.sp +\fBenhanced\-security\-erase\fP +.INDENT 0.0 +.INDENT 3.5 +Theoretically a more thorough version of the standard ATA Security +Erase command. Similarly its function depends on the device and may +be the same as the regular security erase. +.sp +Requires captcha. +.sp +Relevant options: captcha. +.UNINDENT +.UNINDENT +.SH EXAMPLES +.nf +# bbf info /dev/sdb +/dev/sdi: +.in +2 +\- serial_number: XXXXXXXX +\- firmware_revision: SC61 +\- model_number: ST8000VN0022\-2EL112 +\- RPM: 7200 +\- features: +.in +2 +\- form_factor: 3.5" +\- write_uncorrectable: 1 +\- smart_supported: 1 +\- smart_enabled: 1 +\- security_supported: 1 +\- security_enabled: 0 +\- security_locked: 0 +\- security_frozen: 0 +\- security_count_expired: 0 +\- security_enhanced_erase_supported: 1 +\- security_normal_erase_time: 698 +\- security_enhanced_erase_time: 698 +\- block_erase: 0 +\- overwrite: 1 +\- crypto_scramble: 0 +\- sanitize: 1 +\- supports_sata_gen1: 1 +\- supports_sata_gen2: 1 +\- supports_sata_gen3: 1 +\- trim_supported: 0 +.in -2 +\- block_size: +.in +2 +\- physical: 4096 +\- logical: 512 +\- stepping: 8 +.in -2 +\- block_count: +.in +2 +\- physical: 1953506646 +\- logical: 15628053168 +.in -2 +\- size: +.in +2 +\- bytes: 8001563222016 +\- human: +.in +2 +\- base2: 7.28TB +\- base10: 8.00TiB + +.in -2 +.in -2 +.in -2 +.fi +.sp +.nf +# bbf \-S 256 \-t ata scan /dev/sdb +start block: 0 +end block: 15628053168 +stepping: 256 +logical block size: 512 +physical block size: 4096 +read size: 131072 +Scanning: 0 \- 15628053168 +Current: 2425512192 (15.52%); bps: 179384.74; eta: 20:26:39; bad: 0 + +.fi +.sp +.nf +# bbf captcha /dev/sdb +Z8400VR0 + +.fi +.sp +.nf +# bbf \-i ~/badblocks.Z8400VR0 \-c Z8400VR0 fix /dev/sdb + +.fi +.sp +.nf +# bbf \-q fsthrash /mnt/mydrive0 +CTRL\-C to exit... +^CCleaning up... + +.fi +.sp +.nf +# bbf filethrash /mnt/mydrive0/test +Creating file: /mnt/mydrive0/test +Expanding file to fill drive: 200209731584 bytes +Spawning thrashing threads: 4 (one per core) +CTRL\-C to exit... +.fi +.sp +.SH COPYRIGHT +.sp +See the file /usr/doc/bbf\-20220524_0e90e04/LICENSE for license information. +.SH AUTHORS +.sp +\fBbbf\fP was written by Antonio SJ Musumeci <\fI\%trapexit@spawn.link\fP>. +.sp +This man page created for the SlackBuilds.org project by +B. Watson. Since it\(aqs just copy/pasted from README.md, the man page is +licensed the same as \fBbbf\fP itself. +.SH SEE ALSO +.sp +\fBbadblocks\fP(8), \fBsmartctl\fP(8), \fBfsck\fP(8) +.sp +The \fBbbf\fP homepage: \fI\%https://github.com/trapexit/bbf\fP +.\" Generated by docutils manpage writer. +. diff --git a/system/bbf/bbf.SlackBuild b/system/bbf/bbf.SlackBuild new file mode 100644 index 0000000000..b3313d7b63 --- /dev/null +++ b/system/bbf/bbf.SlackBuild @@ -0,0 +1,73 @@ +#!/bin/bash + +# Slackware build script for bbf + +# Written by B. Watson (urchlay@slackware.uk) + +# Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details. + +cd $(dirname $0) ; CWD=$(pwd) + +PRGNAM=bbf +VERSION=${VERSION:-20220524_0e90e04} +BUILD=${BUILD:-1} +TAG=${TAG:-_SBo} +PKGTYPE=${PKGTYPE:-tgz} + +if [ -z "$ARCH" ]; then + case "$( uname -m )" in + i?86) ARCH=i586 ;; + arm*) ARCH=arm ;; + *) ARCH=$( uname -m ) ;; + esac +fi + +if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then + echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE" + exit 0 +fi + +TMP=${TMP:-/tmp/SBo} +PKG=$TMP/package-$PRGNAM +OUTPUT=${OUTPUT:-/tmp} + +if [ "$ARCH" = "i586" ]; then + SLKCFLAGS="-O2 -march=i586 -mtune=i686" +elif [ "$ARCH" = "i686" ]; then + SLKCFLAGS="-O2 -march=i686 -mtune=i686" +elif [ "$ARCH" = "x86_64" ]; then + SLKCFLAGS="-O2 -fPIC" +else + SLKCFLAGS="-O2" +fi + +set -e + +rm -rf $PKG +mkdir -p $TMP $PKG $OUTPUT +cd $TMP +rm -rf $PRGNAM-$VERSION +tar xvf $CWD/$PRGNAM-$VERSION.tar.xz +cd $PRGNAM-$VERSION +chown -R root:root . +find -L . -perm /111 -a \! -perm 755 -a -exec chmod 755 {} \+ -o \ + \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} \+ + +make CFLAGS="$SLKCFLAGS" +install -s -D $PRGNAM $PKG/usr/sbin/$PRGNAM + +# man page is copypasta from README.md, with nice formatting and +# a few grammar/spelling fixes. +mkdir -p $PKG/usr/man/man8 +gzip -9c < $CWD/$PRGNAM.8 > $PKG/usr/man/man8/$PRGNAM.8.gz + +PKGDOC=$PKG/usr/doc/$PRGNAM-$VERSION +mkdir -p $PKGDOC +cp -a *.md LICENSE $PKGDOC +cat $CWD/$PRGNAM.SlackBuild > $PKGDOC/$PRGNAM.SlackBuild + +mkdir -p $PKG/install +cat $CWD/slack-desc > $PKG/install/slack-desc + +cd $PKG +/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE diff --git a/system/bbf/bbf.info b/system/bbf/bbf.info new file mode 100644 index 0000000000..0730843445 --- /dev/null +++ b/system/bbf/bbf.info @@ -0,0 +1,10 @@ +PRGNAM="bbf" +VERSION="20220524_0e90e04" +HOMEPAGE="https://github.com/trapexit/bbf" +DOWNLOAD="https://slackware.uk/~urchlay/src/bbf-20220524_0e90e04.tar.xz" +MD5SUM="2e269c80c916bdb840489535e1044afe" +DOWNLOAD_x86_64="" +MD5SUM_x86_64="" +REQUIRES="" +MAINTAINER="B. Watson" +EMAIL="urchlay@slackware.uk" diff --git a/system/bbf/bbf.rst b/system/bbf/bbf.rst new file mode 100644 index 0000000000..20a7a1d3a8 --- /dev/null +++ b/system/bbf/bbf.rst @@ -0,0 +1,320 @@ +.. RST source for bbf(1) man page. Convert with: +.. rst2man.py bbf.rst > bbf.8 + +.. |version| replace:: 20220524_0e90e04 +.. |date| date:: + +=== +bbf +=== + +---------------- +bad block finder +---------------- + +:Manual section: 8 +:Manual group: SlackBuilds.org +:Date: |date| +:Version: |version| + +SYNOPSIS +======== + +bbf [*options*] *instruction* *path* + +DESCRIPTION +=========== + +**bbf** is a safer and more featureful tool for dealing with bad +blocks on hard drives. It's built around the workflow of dealing with +hard drive bad blocks. It has a number of features to limit risk in +using the tool and provides features to more easily track down what +files are affected by the bad blocks found. It also gives you the +ability to manually mark blocks as corrupted in cases where a block +isn't technically bad, but is causing issues. + +FEATURES +======== + + * readonly scanning of bad blocks + * safe 'fix' mode which won't overwrite good blocks + * burnin mode for checking new drives + * manual marking blocks as corrupted + * find files given list of blocks + * dump list of files and associated block ranges + * dump list of blocks used by a file + * issue secure drive erasure + * filesystem stressing + + +OPTIONS +======= + +Arguments +--------- + +-f, --force + override checking if drive is in use when trying to perform destructive actions + +-t, --rwtype *os|ata* + select between OS or ATA reads and writes (default: os) + +-q, --quiet + redirects stdout to /dev/null or otherwise limits output + +-s, --start-block *lba* + block to start from (default: 0) + +-e, --end-block *lba* + block to stop at (default: last block) + +-S, --stepping *n* + number of logical blocks to read at a time (default: physical / logical) + +-o, --output *file* + file to write bad block list to (default: $HOME/badblocks.*captcha*) + +-i, --input *file* + file to read bad block list from (default: $HOME/badblocks.*captcha*) + +-r, --retries *count* + number of retries on certain reads & writes + +-c, --captcha *captcha* + needed when performing destructive operations + +-M, --maxerrors *n* + max r/w errors before exiting (default: 1024) + +Instructions +------------ + +**info** + + *path* is a block device. Prints out details about the block device. + +**captcha** + + *path* is a block device. Prints out captcha needed for certain instructions. + +**scan** + + *path* is a block device. A read-only scan of the block device for + bad blocks. *rwtype=ata* will be slower but may catch more. + + Relevant options: rwtype, start block, end block, stepping, max errors, input file, output file. + +**fix** + + *path* is a block device. Writes to bad blocks in an attempt to + force the drive to reallocate the block. Attempts to read the block + first and will write the read data if successful otherwise it will + write zeros. This means it is pretty safe to use even if the blocks + 'fixed' aren't in fact damaged. + +*rwtype=ata* will work better. + + Requires captcha. + + Relevant options: captcha, rwtype, force, input file. + +**fix-file** + + *path* is a file. Gets the list of blocks that a file uses and then + goes through each block reading what is there and then writing it + back which will force reallocation if a block is bad. + + *rwtype=ata* will work better. + + Requires captcha. + + Relevant options: captcha, rwtype, retries. + +**burnin** + + *path* is a block device. Iterates through the blocks of the device performing the following: + + 1) Read block data (zero out on failure) + + 2) Write 0x00's and read back to confirm data integrity. + + 3) Write 0x55's and read back to confirm data integrity. + + 4) Write 0xAA's and read back to confirm data integrity. + + 5) Write 0xFF's and read back to confirm data integrity. + + 6) Write back originally read data. + + Requires captcha. + + Relevant options: rwtype, start block, end block, stepping, max + errors, retries, input file, output file. + +**fsthrash** + + *path* is a directory. Spawns a number of threads to hammer the + filesystem using a number of functions to stress the filesystem and + underlying device. Functions include: create, open, mkdir, unlink, + rmdir, write, read, close, readdir, stat, chmod, chown, link, + symlink. Cleans up after itself on exit but does consume storage and + inodes as it runs. + + Use *--quiet* to keep it from printing out what it is doing and improve performance. + +**filethrash** + + *path* is a non-existent file. Creates a file, expands it to fill + up the rest of the filesystem, and spawns a thread per core which + writes 1MB blocks to the file at random offsets to stress the + filesystem and unerlying device. + +**find-files** + + *path* is a filesystem mount point. Attempts to find the + files associated with any blocks listed in the bad block input + file. Useful after running *scan* to find the files with bad blocks. + + Relevant options: input file. + +**dump-files** + + *path* is a filesystem. Scans the filesystem and dumps a list of the files with the blocks on the device it occupies. + +**file-blocks** + + *path* is an existing file. Prints out a list of all logical blocks the file uses. + +**write-pseudo-uncorrectable-wl** + +**write-pseudo-uncorrectable-wol** + +**write-flagged-uncorrectable-wl** + +**write-flagged-uncorrectable-wol** + + *path* is a block device. Marks blocks listed in the bad block input + file as 'pseudo' or 'flagged' uncorrectable. Blocks marked 'pseudo', + when read, cause the drive to perform normal error recovery and + return errors if necessary. Blocks marked 'flagged', when read, + will simply return errors indicating it is bad. 'wl' means 'with + logging' and if read will result in failed reads being stored in + SMART logs. 'wol' means 'without logging' and will not log any read + failures in the SMART log. + + Relevant options: input file. + +**security-erase** + + *path* is a block device. Issues an ATA Security Erase command to + the device. What this means specifically is device specific but + generally it is supposed to be like a low-level format. Use with + care. + + Requires captcha. + + Relevant options: captcha. + +**enhanced-security-erase** + + Theoretically a more thorough version of the standard ATA Security + Erase command. Similarly its function depends on the device and may + be the same as the regular security erase. + + Requires captcha. + + Relevant options: captcha. + +EXAMPLES +======== + +| # bbf info /dev/sdb +| /dev/sdi: +| - serial_number: XXXXXXXX +| - firmware_revision: SC61 +| - model_number: ST8000VN0022-2EL112 +| - RPM: 7200 +| - features: +| - form_factor: 3.5" +| - write_uncorrectable: 1 +| - smart_supported: 1 +| - smart_enabled: 1 +| - security_supported: 1 +| - security_enabled: 0 +| - security_locked: 0 +| - security_frozen: 0 +| - security_count_expired: 0 +| - security_enhanced_erase_supported: 1 +| - security_normal_erase_time: 698 +| - security_enhanced_erase_time: 698 +| - block_erase: 0 +| - overwrite: 1 +| - crypto_scramble: 0 +| - sanitize: 1 +| - supports_sata_gen1: 1 +| - supports_sata_gen2: 1 +| - supports_sata_gen3: 1 +| - trim_supported: 0 +| - block_size: +| - physical: 4096 +| - logical: 512 +| - stepping: 8 +| - block_count: +| - physical: 1953506646 +| - logical: 15628053168 +| - size: +| - bytes: 8001563222016 +| - human: +| - base2: 7.28TB +| - base10: 8.00TiB +| + +| # bbf -S 256 -t ata scan /dev/sdb +| start block: 0 +| end block: 15628053168 +| stepping: 256 +| logical block size: 512 +| physical block size: 4096 +| read size: 131072 +| Scanning: 0 - 15628053168 +| Current: 2425512192 (15.52%); bps: 179384.74; eta: 20:26:39; bad: 0 +| + +| # bbf captcha /dev/sdb +| Z8400VR0 +| + +| # bbf -i ~/badblocks.Z8400VR0 -c Z8400VR0 fix /dev/sdb +| + +| # bbf -q fsthrash /mnt/mydrive0 +| CTRL-C to exit... +| ^CCleaning up... +| + +| # bbf filethrash /mnt/mydrive0/test +| Creating file: /mnt/mydrive0/test +| Expanding file to fill drive: 200209731584 bytes +| Spawning thrashing threads: 4 (one per core) +| CTRL-C to exit... + +COPYRIGHT +========= + +See the file /usr/doc/bbf-|version|/LICENSE for license information. + +AUTHORS +======= + +**bbf** was written by Antonio SJ Musumeci <trapexit@spawn.link>. + +This man page created for the SlackBuilds.org project by +B. Watson. Since it's just copy/pasted from README.md, the man page is +licensed the same as **bbf** itself. + +SEE ALSO +======== + +**badblocks**\(8), **smartctl**\(8), **fsck**\(8) + +The **bbf** homepage: https://github.com/trapexit/bbf diff --git a/system/bbf/git2tarxz.sh b/system/bbf/git2tarxz.sh new file mode 100644 index 0000000000..9c21b0defc --- /dev/null +++ b/system/bbf/git2tarxz.sh @@ -0,0 +1,42 @@ +#!/bin/sh + +# Create source tarball from git repo + +# Note that this script doesn't need to be run as root. It does need to +# be able to write to the current directory it's run from. + +# Takes one optional argument, which is the commit or tag to create a +# tarball of. With no arg, HEAD is used. + +PRGNAM=bbf +CLONE_URL=https://github.com/trapexit/bbf + +set -e + +GITDIR=$( mktemp -dt $PRGNAM.git.XXXXXX ) +rm -rf $GITDIR +git clone $CLONE_URL $GITDIR + +CWD="$( pwd )" +cd $GITDIR + +if [ "$1" != "" ]; then + git reset --hard "$1" || exit 1 +fi + +GIT_SHA=$( git rev-parse --short HEAD ) + +DATE=$( git log --date=format:%Y%m%d --format=%cd | head -1 ) + +VERSION=${DATE}_${GIT_SHA} + +find . -name .git\* -print0 | xargs -0 rm -rf + +cd "$CWD" +rm -rf $PRGNAM-$VERSION $PRGNAM-$VERSION.tar.xz +mv $GITDIR $PRGNAM-$VERSION +tar cvfJ $PRGNAM-$VERSION.tar.xz $PRGNAM-$VERSION + +echo +echo "Created tarball: $PRGNAM-$VERSION.tar.xz" +echo "VERSION=$VERSION" diff --git a/system/bbf/slack-desc b/system/bbf/slack-desc new file mode 100644 index 0000000000..281878c235 --- /dev/null +++ b/system/bbf/slack-desc @@ -0,0 +1,19 @@ +# HOW TO EDIT THIS FILE: +# The "handy ruler" below makes it easier to edit a package description. +# Line up the first '|' above the ':' following the base package name, and +# the '|' on the right side marks the last column you can put a character in. +# You must make exactly 11 lines for the formatting to be correct. It's also +# customary to leave one space after the ':' except on otherwise blank lines. + + |-----handy-ruler------------------------------------------------------| +bbf: bbf (bad block finder) +bbf: +bbf: bbf is a safer and more featureful tool for dealing with bad blocks +bbf: on hard drives. It's built around the workflow of dealing with hard +bbf: drive bad blocks. It has a number of features to limit risk in using +bbf: the tool and provides features to more easily track down what files +bbf: are affected by the bad blocks found. It also gives you the ability +bbf: to manually mark blocks as corrupted in cases where a block isn't +bbf: technically bad, but is causing issues. +bbf: +bbf: |