MFC r343871:
recoverdisk(1): fclose() file supplied via '-r readlist' parameter when
it's no longer needed

PR: 204952
Reported by: David Binderman <dcb314@hotmail.com>

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

sbin: ake use of our rounddown() macro when sys/param.h is available.

No functional change.

Merge the projects/release-pkg branch to head.

This allows packaging the base system with pkg(8), including
but not limited to providing the ability to provide upstream
binary update possibilities for non-tier-1 architectures.

This merge is a requirement of the 11.0-RELEASE, and as such,
thank you to everyone that has tested the project branch.

Documentation in build(7) etc. is still somewhat sparse, but
updates to those parts will follow.

Sponsored by: The FreeBSD Foundation

Add META_MODE support.

Off by default, build behaves normally.
WITH_META_MODE we get auto objdir creation, the ability to
start build from anywhere in the tree.

Still need to add real targets under targets/ to build packages.

Differential Revision: D2796
Reviewed by: brooks imp

use .Mt to mark up email addresses consistently (part1)

PR: 191174
Submitted by: Franco Fichtner <franco@lastsummer.de>

Sweep man pages replacing ad -> ada.

Approved by: re (blackend)
MFC after: 1 week
X-MFC note: stable/9 only

Fix 'SEE ALSO' list.

Correct type for DIOCGSTRIPESIZE. Without this there
would be a stack overflow which will crash the program
later.

PR: bin/176953
Submitted by: r4721 tormail org
MFC after: 3 days

Use stripesize as smallest block size if it's available.

MFC after: 2 weeks

Fix mdoc date from previous commit.

Document the detrimental effect of kern.cam.XX.retry_count for recoverdisk(1)

recoverdisk(1) wants to know about read errors when doing the 1MB/64k
reads as fast as possible so it can continue and retry them later with
smaller reads (down to sector size). Any retries by lower layers will
only slow it down.

Prodded by: arundel

Add missing static keywords for global variables to tools in sbin/.

These tools declare global variables without using the static keyword,
even though their use is limited to a single C-file, or without placing
an extern declaration of them in the proper header file.

recoverdisk(8): treat output file consistently and abort on EINVAL

This improves usability a little as we no longer require using touch.
Also reword the manpage wrt. parameters and fix usage() [1]

With no media in a cd(4) drive, the reads will loop producing EINVAL,
abort in that case [2].

Document the shortcoming of sectorsize and MAXPHYS (a quick solution
to this might be having MAXPHYS as the "bigsize", in short testing it
didn't make a difference on throughput).

Submitted by: arundel [1]
PR: bin/154528 [2]

Switch the default WARNS level for sbin/ to 6.

Submitted by: Ulrich Spörlein

Save (empty) worklist at successful completion

Also use %zu to print the allocation size when malloc(3) fails.

Discussed with: phk

Fix printf warnings on amd64 etc.

One Pp is more than enough.

Says: brueffer

Some improvements to recoverdisk

Bail on ENXIO, you won't get any further any way.

Submitted by: tobez

Improve reporting in recoverdisk a good deal.

Submitted by: Ulrich Spoerlein <uspoerlein@gmail.com>
PR: 111630

Revise markup.

Make recoverdisk compile on amd64 and possibly other 64bit archs.
Bump WARNS to 6.

PR: amd64/97566
Reviewed by: phk@
MFC after: 3 days

o Take an account a media sectorsize for medium and bigsize calculation.
o Introduce -r and -w keys which allow to load and save a worklist.
o Replace README by man page.

PR: bin/96677
Submitted by: Ulrich Spoerlein
Approved by: phk
MFC after: 1 month

Extend utility to allow recovering single file from the deffective
media.

MFC after: 2 weeks

Start the dreaded NOFOO -> NO_FOO conversion.

OK'ed by: core

For variables that are only checked with defined(), don't provide
any fake value.

Use %zu to format size_t instead of %jd and an intmax_t cast.

Approved by: hamlet

Stop amd64 warnings.

Only print progress statistics once per second.

This is a small tool which will read an entire disk(partition) using
1M blocks and optionally write the read data to a file or disk.

If a read error happens, the 1M block gets put on the end of the worklist
and will be retried with 64k blocksize.

If a read error happens again, the 64k block gets put at the end of the
worklist and will be retried with single sector reads.

The program keeps trying until you stop it.

You can refresh a disk:

recoverdisk /dev/ad1 /dev/ad1

or salvage a floppy:

recoverdisk /dev/fd0 myfloppy.flp