Revert "Fix various mistakes (s/it were/it was/) in manual pages."

This reverts commit e4adeac153e9f588eff22befbf196d2fd3444bc3.

kernel/clock_getres: Improve CPU clock ID sanity checking.

clock_settime(2): Return EINVAL if tv_sec < 0

The same argument check is also done in nanosleep(2)/clock_nanosleep(2),
and FreeBSD also does this check.

Use 'sysmsg_result' macro for consistency

Don't directly use the 'sm_result' union member in 'struct sysmsg',
consistent with other kernel code.

<sys/sysmsg.h>: Remove a deprecated and duplicate union member

In 'union sm_result', the 'int result' member is deprecated and replaced
by the 'int iresult' member.  So remove the 'result' one and change the
'sysmsg_result' macro accordingly.

<sys/sysmsg.h>: Remove unused forward declarations

syscall.9: Add some missing info and fix outdated contents

* Update the syscall decleration (in syscalls.master) and generated
  prototype (in sysproto.h) examples to match the current syntax.
* Fix 'uap->sysmsg_result' to 'sysmsg->sysmsg_result', and be explicit
  that the function need to return 0 when the default 'sysmsg_result' is
  updated.
* Don't mention the 'SCARG' macro (to extract syscall argument) since
  it's now seldomly used in our codebase.  (Syscall argument can be
  intuitively extracted by 'uap->arg'.)
* Add a paragraph to describe the symbol exportation in libc via the
  'libc/sys/Symbol.map' file.
* Mention the syscall entry point in the kernel a bit.
* Add 'sys/sys/sysmsg.h' and 'sys/sys/sysunion.h' to the FILES section,
  while remove the obsolete 'sys/kern/syscalls.conf' (already folded
  into makesyscalls.sh).
* Some minor formatting and wording tweaks.

Reviewed-by: swildner

nanosleep.2: List clock_nanosleep() in the NAME section.

<sys/sysmsg.h>: Add missing copyright and license header

Implement clock_nanosleep(2) system call

* Extend the nanosleep1() function in kern_time.c to support the
  clock_nanosleep(2) system call.  Add {kern,sys}_clock_nanosleep()
  functions and update kern_nanosleep() accordingly.

* Add clock_nanosleep() syscall to syscalls.master and regenerate
  syscall-related files.

* Update libc symbols with the new syscall.

* Add clock_nanosleep() warpper in libthread_xu.

* Update nanosleep.2 man page to describe clock_nanosleep().

* Update <time.h> and bump __DragonFly_version.

This work is loosely based on the FreeBSD implementation:
https://reviews.freebsd.org/rS315526

This clock_nanosleep(2) syscall passed all tests in the Open POSIX Test
Suite [0]:

conformance/interfaces/clock_nanosleep/1-1: execution: PASS
conformance/interfaces/clock_nanosleep/1-2: execution: PASS
conformance/interfaces/clock_nanosleep/1-3: execution: PASS
conformance/interfaces/clock_nanosleep/1-4: execution: PASS
conformance/interfaces/clock_nanosleep/1-5: execution: PASS
conformance/interfaces/clock_nanosleep/2-1: execution: PASS
conformance/interfaces/clock_nanosleep/2-2: execution: PASS
conformance/interfaces/clock_nanosleep/2-3: execution: PASS
conformance/interfaces/clock_nanosleep/3-1: execution: PASS
conformance/interfaces/clock_nanosleep/4-1: execution: PASS
conformance/interfaces/clock_nanosleep/5-1: execution: PASS
conformance/interfaces/clock_nanosleep/6-1: execution: PASS
conformance/interfaces/clock_nanosleep/9-1: execution: PASS
conformance/interfaces/clock_nanosleep/8-1: execution: PASS
conformance/interfaces/clock_nanosleep/10-1: execution: PASS
conformance/interfaces/clock_nanosleep/11-1: execution: PASS
conformance/interfaces/clock_nanosleep/13-1: execution: PASS
conformance/interfaces/clock_nanosleep/15-1: execution: PASS

[0] Open POSIX Test Suite: http://posixtest.sourceforge.net/

Reviewed-by: swildner, dillon, tuxillo, zach

nanosleep(2): Return EINVAL if tv_sec < 0 (POSIX-compliant)

When the requested sleep interval is negative, return EINVAL.  This
behavior is the same as Linux and makes our nanosleep(2) pass all tests
in the Open POSIX Test Suite [0].

conformance/interfaces/nanosleep/1-1: execution: PASS
conformance/interfaces/nanosleep/1-2: execution: PASS
conformance/interfaces/nanosleep/1-3: execution: PASS
conformance/interfaces/nanosleep/2-1: execution: PASS
conformance/interfaces/nanosleep/3-1: execution: PASS
conformance/interfaces/nanosleep/3-2: execution: PASS
conformance/interfaces/nanosleep/4-1: execution: PASS
conformance/interfaces/nanosleep/5-1: execution: PASS
conformance/interfaces/nanosleep/5-2: execution: PASS
conformance/interfaces/nanosleep/6-1: execution: PASS
conformance/interfaces/nanosleep/7-1: execution: PASS
conformance/interfaces/nanosleep/7-2: execution: PASS
conformance/interfaces/nanosleep/10000-1: execution: PASS

[0] Open POSIX Test Suite: http://posixtest.sourceforge.net/

nanosleep(2): Plug a memory disclourse and be POSIX-compliant

The nanosleep1() called by sys_nanosleep() would only update rmt on
EINTR, but it can also return other errors, such as EINVAL.  And in that
case, sys_nanosleep() would update the user-space rmtp by copying
garbage from its stack frame.  This is not only a kernel memory
disclourse, but also not POSIX-compliant.

Fix sys_nanosleep() to update rmtp only on EINTR.  In addition, zero the
kernel rmt variable for double safety.

Obtained-from: FreeBSD (r315510)
Reviewd-by: dillon

kern/makesyscalls.sh: Revert change to '#endif' comment

Well, I misread the '#ifdef _KERNEL' with '#ifndef', so the comment of
'#endif' is right.  Revert the recent change to this part ;)

Reported-by: swildner

<sys/sysproto.h>: Regenerate after 'makesyscalls.sh' update

kern/makesyscalls.sh: Better place #undef and fix #endif comments

* Move the placement of '#undef PAD_' so it just follows the end of
  syscall argument section.

* Fix the comments of '#endif', so that the '_SYS_SYSPROTO_H_' and
  '_KERNEL' hierachies are now correct.

test/vmm: Refactor Makefile by using <bsd.prog.mk>

Use ${} instead of $() in various makefiles

Also use ${.TARGET} and ${.ALLSRC] wherever impossible.

Minor style adjustment in at(1)'s makefiles.

Fix various mistakes (s/it were/it was/) in manual pages.

libutil/setusercontext: Apply FreeBSD's b149798e50fac1113a7.

FBSD commit msg:

Fix a clang 3.5 warning about abs(3) being given an argument of type
quad_t in setusercontext().  While here, sanitize the clamping of the
priority value, and use the correct type for the return value of
login_getcapnum().

usr.sbin/fstyp: Fix exfat detection

from FreeBSD ddf61156132b610915325769cbb93ea11be0d433

Add a smbfs(5) manual page (taken from FreeBSD).

libc/citrus: Cleanup the DFprivate_1.0 section of the Symbol.map.

None of these symbols were ever in our libc.

libc/citrus: Remove two unused header files.

talkd: Find users in more than one talk request.

talkd was written to use `utmpentry` from `who`, which
caches the results of read the `utmpx` file.  However,
talkd is usually invoked from inetd `wait` mode; it's
possible that a user might login after `talkd` starts;
with the cached utmpx data, one can't `talk` to that
user.

Further, consumption of the utmp data nulls it out for
subsequent requests.  The result is that the first talk
succeeds, but subsequent requests fail.

The fix is to avoid using the `utmpentry` machinery,
and just read `utmp` directly every time we need to.

Signed-off-by: Dan Cross <cross@gajendra.net>

talk: talk into account sa_len field in sockaddr.

`osockaddr` predates the introduction of the sa_len
field in `struct sockaddr`.  The family has moved to
the second field in the structure, but `talk` didn't
account for this when it constructs a `sockaddr_in`
to send data to another system.

The failure case was kind of odd: one could `talk`
to a user on, say, a Linux machine, the remote user
could respond, and things would work as expected.
However, the inverse case, where a user on Linux
tried to `talk` to a user on Dragonfly failed: the
talk announcement would be made, but an attempt to
respond would fail with a protocol error since the
`sin_family` field would be zero.

Signed-off-by: Dan Cross <cross@gajendra.net>

Update the pciconf(8) database.

January 11, 2021 snapshot from https://pci-ids.ucw.cz

Sync cmp(1) with FreeBSD. Mainly for 80445b7a3f738e0b which fixes a bug.

Reported-by: William Ahern <william@25thandclement.com>

hexdump.1/operator.7: Use Ta instead of literal tabs.

kernel - Fix atime field for PTYs

* Fix the atime field for PTYs.  A calculation in the shortcut code
  that avoids having to update the timestamp on every read() or
  write() was reversed.

Reported-by: dancrossnyc

finger - Take into account terminal session ID

* The 'w' command tries to figure out what process is running on a TTY
  line and emit that as part of its output. Update its heuristics to
  select the "most interesting" process.

Reported-by: dancrossnyc
Bug-report: #3260

finger - Remove -T option

* This doesn't appear to work against anything, so remove it. FreeBSD
  apparently removed this option in 2007.

Reported-by: dancrossnyc
Bug-report: #3258

finger - Fix 'lastlogx' logic

* finger(1) was simply incorrect in how it was trying to access
  the `lastlogx` database; fix it to use the correct interface.

Reported-by: dancrossnyc
Bug-report: #3257

finger - Reduce printed Login name field width so line fits 80 cols

* With the TTY field expanded, reduce the Login name field width
  so the output still fits in 80 cols.

finger - Widen TTY field to avoid truncation

* Widen the printed TTY field to deal with
  longer tty names.

Reported-by: dancrossnyc
Bug-report: #3256

usr.sbin/fstyp: Sync with NetBSD

sys/vfs/ext2fs: Fix comment on htree dirent (disabled) issue on DragonFly

This sounded like ext3 on Linux had a similar problem, which is not true.

usr.sbin/fstyp: Minor fix for HAMMER2

usr.sbin/fstyp: Don't assert(0) for invalid HAMMER1/2 ondisk

Given purpose of fstyp, don't kill the process for invalid ondisk.
Just fail HAMMER1/2 detection.

sys/vfs/hammer2: Add hammer2_print_uuid_mismatch()

md5.1: Remove dead references from SEE ALSO.

Reported-by: aly

libc/citrus: Fix some typos in DFprivate_1.0 in the Symbol.map.

kernel - Remove MAP_VPAGETABLE

* This will break vkernel support for now, but after a lot of mulling
  there's just no other way forward.  MAP_VPAGETABLE was basically a
  software page-table feature for mmap()s that allowed the vkernel
  to implement page tables without needing hardware virtualization support.

* The basic problem is that the VM system is moving to an extent-based
  mechanism for tracking VM pages entered into PMAPs and is no longer
  indexing individual terminal PTEs with pv_entry's.

  This means that the VM system is no longer able to get an exact list of
  PTEs in PMAPs that a particular vm_page is using.  It just has a
  flag 'this page is in at least one pmap' or 'this page is not in any
  pmaps'.  To track down the PTEs, the VM system must run through the
  extents via the vm_map_backing structures hanging off the related
  VM object.

  This mechanism does not work with MAP_VPAGETABLE.  Short of scanning
  the entire real pmap, the kernel has no way to reverse-index a page
  that might be indirected through MAP_VPAGETABLE.

* We will need actual hardware mmu virtualization to get the vkernel
  working again.

Sync ACPICA with Intel's version 20210105.

iasl: Remove support for obsolete tables

Also, update copyrights.

For detailed list, please see sys/contrib/dev/acpica/changes.txt.

timeout.1: Use .Fx

sockaddr_snprintf.3: Use .Er for errno values.

timeout(1): Add -v/--verbose option to show diagnosis info

The -v/--verbose option enables this utility to show diagnosis info to
stderr about any signal sent on timeout.

This implementation refers to GNU coreutils's timeout(1).

timeout(1): Reduce some duplicate code

Merge the 'sig_alrm' and 'sig_term' conditionals, and thus reduce some
duplicate code.

timeout(1): Some minor tweaks and improvements

* Define exit status and macros and use them
* Improve the second kill logic by setting 'do_second_kill = false'
  after configuring the second kill
* Minor style tweaks
* Reorder options in the man page, as well as the usage help
* Reorder the exit status in the man page
* Enhance the HISTORY section in the man page (obtained from NetBSD)

timeout(1): Port to DragonFly

Our procctl(2) is different from FreeBSD's procctl(2), so need to adjust
its usage.

Also hook into our build system and update the man page.

Import timeout(1) from FreeBSD

The timeout(1) utility runs a command with a time limit.  It has also
been imported into NetBSD.  This utility first appeared in GNU
coreutils.

This is a verbatim copy of FreeBSD's version.  Necessary modifications
and updates will follow.

Fix some -Wjump_misses_init warnings (found by clang).

netstat(1): Clean up struct nlist array.

getaddrinfo(1): Actually hook into the build and remove unneeded headers.

The <sys/cdefs.h> should be removed along with the __FBSDID and we
include either <sys/types.h> or <sys/param.h> but not both.

Import getaddrinfo(1) from FreeBSD

The getaddrinfo(1) utility resolves host and service names to socket
addresses with getaddrinfo(3) and prints them in a user-friendly format.

Obtained from FreeBSD, which obtained it from NetBSD.

The examples in the man page has been adjusted to use
'www.dragonflybsd.org' instead of NetBSD ones :D

Thank swildner for bringing in sockaddr_snprintf(3) to libutil from
NetBSD, which is required by this utility.

libutil: Add sockaddr_snprintf() (taken from NetBSD).

The man page has been adjusted a bit since we don't support Apple Talk
protocol.

setbuf.3: Mention stdbuf(1) and update HISTORY & BUGS sections

Obtained-from: FreeBSD
Reported-by: swildner

Import stdbuf(1) together with libstdbuf(3) from FreeBSD

The stdbuf(1) is a utility to change the initial buffering of stdin,
stdout and stderr streams for a given command.  It achieves this
functionality by preloading the libstdbuf(3) library and configuring the
needed environment variables.  Under the hood, libstdbuf(3) library
calls setvbuf(3) to do the actual work.

Changes from FreeBSD:
* Removed 32bit i386 code from stdbuf(1)
* Fix typos and update HISTORY section in libstdbuf.3 man page
* Update the example to actually work on DragonFly

mandoc.db.5: Adjust a bit to DragonFly.

newvers.sh: Simplify a bit more.

Remove /usr/share/examples/etc/bsd-style-copyright.

/usr/share/examples/etc is supposed to hold the contents of an
unchanged /etc directory only. Also, our template is in
/COPYRIGHT so there is no point to keep a different one. Examples
of n-clause BSD licenses are widely available online, when needed.

Clean up newvers.sh, which was using the file for vers.c generation.
There is no need to put a license on generated files, let alone such
simple ones.

<unistd.h>: chroot_kernel() is DragonFly specific only.

Its prototype was put into the wrong #if/#endif section in 72f12c5b169.

libc/gen/devname.c: No need to include <paths.h>

Remove obsolete dev_mkdb(8)

The devname(3) has long been updated to determine the device name via
the 'kern.devname' sysctl provided by devfs(5).  The dev.db created by
dev_mkdb(8) is thus unused and obsolete.  So remove dev_mkdb(8) as well
and update relevant parts.

devname.3: Add a little example

Obtained from FreeBSD but with some updates.

devname(3): Remove obsolete code that queries dev.db

In the old days of static /dev, devname(3) would get the name by
querying the /var/run/dev.db created by dev_mkdb(8).  Now that we have
dynamic /dev provided by devfs(5), the device name is provided by the
'kern.devname' sysctl, thus obsoleting the db query code.

I've tested to verify that the db query code isn't being used now.  So
it's safe to remove this obsolete code.  Cleanups to dev_mkdb(8) and
related code would follow.

Meanwhile, update the man page to reflect the current code.

Discussed-with: swildner

Bump copyrights. Good riddance 2020

Remove <sys/types.h> from <ftw.h>.

Clean up the POSIX namespace of <iconv.h>, <dirent.h>, and <sys/stat.h>.

Some small residue in <sys/stat.h> remains for older specs, due to the
kind of bumpy history of that header between issues 6 and 7. Namely,
struct timespec should not be defined in these cases. But this is good
enough for now.

Thanks to zrj for testing with a full dports bulk.

Keep /etc/regdomain.xml in sync with our tree.

It's not a file that might have system specific changes.

netproto/802_11: Sync some channel definitions from FreeBSD

Some of these channel definitions are required by the last commit as
they're being used in 'regdomain.c'.

Also update 'wlan/ieee80211.c' a bit so that it builds fine.

ifconfig(8): Update regdomain.[ch] to support new regdomain.xml

The '/etc/regdomain.xml' has been updated in
dbe4ac417a2b77e29fd0326277263c3bbccf7ebe.  However, ifconfig(8) has not
been updated to support the new netbands (e.g., 11ac) and thus
ifconfig(8) emits some warnings like:

```
ifconfig: unknown netband mode "11ac" at line 114
ifconfig: ignore "band" of unknown netband at line 115
ifconfig: ignore "freqband" of unknown netband at line 116
ifconfig: ignore "maxpower" of unknown netband at line 117
ifconfig: unexpected XML token "maxpower" data "17" at line 117
ifconfig: ignore "flags" of unknown netband at line 118
ifconfig: flags without freqband or netband at line 118 ignored
```

Update 'regdomain.[ch]' from FreeBSD to support the new regdomain.xml,
together with minor fixes.

Obtained-from: FreeBSD

ifconfig(8): Fix regdomain.xml parsing issue

The original regdomain.[ch] code can't handle unknown netbands in
regdomain.xml, mainly because it didn't distinguish the following two
cases:

* <netband><band><freqband ref="xxx">...
* <freqband id="xxx">...

Therefore, it tried to strdup(id) but with 'id = NULL' and thus caused
segfault errors with the new regdomain.xml, like:

```
ifconfig: unknown mode "11ac" at line 114
ifconfig: band without enclosing netband at line 115
[1]    326065 segmentation fault (core dumped)  ifconfig
```

This commit fixes the above segfault error by ignoring unknown netbands.
Although ifconfig(8) emits some warnings about unknown/unexpected
elements, it works as expected :D

Reported-by: Gonzalo Nemmi (noob237 on IRC)

Add <endian.h>, which for now only includes <sys/endian.h>.

An <endian.h> header was recently approved by The Austin Group:
https://www.austingroupbugs.net/view.php?id=162

Add one now, mainly for dports. It will be further POSIXized later.

etc/Makefile: Install 'group' and 'passwd' to examples/etc

Add back installation of 'group' to '/usr/share/examples/etc'.  In
addition, also install 'master.passwd' there.

The point is that '/usr/share/examples/etc' should have all config files
that the initial '/etc' have.

Suggested-by: swildner

Sync zoneinfo database with tzdata2020f from ftp://ftp.iana.org/tz/releases

Nothing to see, just a fix in the upstream build infrastructure.

For a detailed list of changes, see share/zoneinfo/NEWS.

libc/gen/gen_private.h: Include <sys/types.h> for off_t.

Do not rely on the including file to bring it in.

kernel: Staticize a few variables.

libc/fmtcheck: Sync with FreeBSD (only comments).

<machine/smp.h>: Remove some prototypes of non-existent functions.

Reported-by: zrj

etc/Makefile: Improve update of _dhcp user and dhcpcd files

* Update the 'master.passwd' file to set the new home for the '_dhcp'
  user, and then the 'pw-update.sh' script will update it to system.
* Simplify the dhcpcd files move logic a bit.

tools/pw-update.sh: No need to invoke pwd_mkdb(8)

The pw(8) utility already handles the database update, so no need to
manually invoke the pwd_mkdb(8).

tools/pw-update.sh: Improve to update user/group

Before this change, this script would only add new users and/or groups,
but wouldn't modify existing users/groups.  This change add this
ability.

Remove last remains of FSMID support from userland.

The kernel side was added in 2005 (7d15906a7a159575b1983f7c1fadde4b)
and removed again in 2009 (d98152a8b8a4b368ca0e08b84302f2f2).

Approved-by: dillon

dhcpcd: update README.DRAGONFLY

Merge branch 'vendor/DHCPCD'

Update to dhcpcd-9.4.0 with the following changes:

 * DHCP: For anonymous, just use a generic ClientID
 * link: Split hardware address randomisation out of anonymous option
 * link: Only report hardware changes for active interfaces
 * link: Report errors obtaining recv buffer size on overflow
 * hooks: Add NOCARRIER_ROAMING reason
 * hooks: interface_order now reflects priorities again

Sync zoneinfo database with tzdata2020e from ftp://ftp.iana.org/tz/releases

* Volgograd switched to Moscow time on 2020-12-27 at 02:00.

* Correct many pre-1986 transitions.

For a detailed list of changes, see share/zoneinfo/NEWS.

openresolv: update README.DRAGONFLY

openresolv: build avahi-daemon and mdnsd subscribers

Merge branch 'vendor/OPENRESOLV'

openresolv: Update to version 3.12.0 with the following changes:

 * Default support for WireGuard interfaces
 * Add allow_interfaces and deny_interfaces configuration knobs

 * notify avahi-daemon of resolv.conf being changed
 * notify mdsnd of resolv.conf being changed

 * Allow configurations to be marked as Deprecated and Acivtated
 * Harden resolvconf lock detection

devname.3: Update man page to align wht the code

Add nsmb.conf.5 man page

Obtained-from: FreeBSD

etc/Makefile: Minor style tweaks

etc/Makefile: No need to try to install 'group' file

Similar to the 'master.passwd', no need to try to install the 'group'
file, because its update has already been handled by the 'pw-update.sh'
script.

etc/Makefile: Use 'pw-update.sh' to add users and groups

After this change, if we want to add a new user/group, just add it to
the 'master.passwd' and/or 'group' files.  No need to add ad-hoc pw(8)
commands in this Makefile.

tools: Add pw-update.sh to add new users and groups

This script is derived my 'dfly-update' tool [1], and will be used in
'make upgrade' to help add new users and groups.

[1] https://github.com/liweitianux/dfly-update

tools: Update commit-msg script a bit

kernel - Fix callout structural corruption bug

* _callout_cancel_quick() was not properly testing whether
  the callout being canceled matched sc->next, resulting
  it occassional kernel panics under certain circumstances.

* Could be triggered during dsynth runs.

* Fixed by adding the proper test.

Reported-by: zrj

sys/vfs/hammer2: Add initial multi-volumes support for HAMMER2

This commit adds initial multi-volumes support for HAMMER2. Maximum
supported volumes is 64. The feature and implementation is similar to
multi-volumes support in HAMMER1.

1. ondisk changes
=================
This commit bumps volume header version from 1 to 2, and adds four new
volume header fields using reserved fields in version 1. Other ondisk
structures are unchanged.
* "volu_id" - volume id from 0 to 63, where 0 represents root volume.
* "nvolumes" - number of volumes. All volumes have same the same value.
* "total_size" - sum of "volu_size" in volumes. All volumes have the
  same value.
* "volu_loff[HAMMER2_MAX_VOLUMES]" - A 512 bytes table which contains
  start offset of max 64 volumes within "total_size". All volumes have
  the same value.

Version 1 volume header has 0 for above fields, so HAMMER2 internally
treats "nvolumes" as 1, and "total_size" as "volu_size" to be able to
handle version 1 and 2 transparently.

All volumes have 4 headers, but only root volume ones are relevant.
Non-root volume headers have their own unique "volu_id" and "volu_size",
but other fields are unimportant and never used. Non-root volume headers
have sroot blockset[i] whose type is HAMMER2_BREF_TYPE_INVALID. Non-root
volume headers don't have boot/aux area, so freemap area start from
offset 0. Non-root volume headers are readonly and never updated after
creation. This means non-root volumes are just extra storage to extend
fs size and internally make up a single virtual volume whose size is
"total_size".

It currently doesn't automatically upgrade an existing version 1 fs to
version 2. Only newly created fs becomes version 2 for now.

2. volumes layout
=================
Basically similar to HAMMER1. A first block device argument provided for
newfs_hammer2(8) becomes the root volume, and if specified remaining
devices extend "total_size" as non-root volumes. All volumes except for
the last one have 1GiB (freemap level1) aligned "volu_size".

This means each volume's start offset within "total_size" is also 1GiB
(freemap level1) aligned. The start offsets of volumes are stored in
volu_loff[HAMMER2_MAX_VOLUMES]. Each volu_loff[n] (0 <= n < nvolumes)
represents start offset of volume n within "total_size". Unused volumes
have -1 for volu_loff[n].
e.g. If a fs consists of 1 volume, volu_loff[0] has 0 and rests have -1.
e.g. If a fs consists of 3 volumes, x GiB root volume, y GiB volume,
  and z GiB volume, volu_loff[0] has 0, volu_loff[1] has x, volu_loff[2]
  has x+y, and rests have -1.

Low level I/O function in HAMMER2 uses this linear offsets table to
determine a device vnode to use and relative offset within the device
vnode, for a given blockref's "data_off". This is different from HAMMER1
where logical offset had embedded volume id bits (i.e. there were holes
in logical address space). HAMMER2 needs this table to support multi-
volumes without changing current logical offset mechanism.

Unless all volumes are specified and mountable, mount_hammer2(8) fails
like it failed in HAMMER1. This also applies to other userspace commands
which require volumes specification, except for fstyp(8).

3. userspace commands
=====================
Basically same as or similar to HAMMER1.
* newfs_hammer2(8) takes a list of block device paths as argv[].
* mount_hammer2(8) takes block device paths or names in "a:b:c:..."
  format.
* hammer2(8) takes block device paths or names in "a:b:c:..." format for
  directives which require volumes specification. This commit also adds
  "volume-list" directive and an ioctl command HAMMER2IOC_VOLUME_LIST,
  which are similar to the one in HAMMER1.
* fsck_hammer2(8) takes device paths or names in "a:b:c:..." format.
* fstyp(8) takes device paths in "path1:path2:path3:..." format.

4. limitations
==============
* hammer2(8) "info" directive ignores multi-volumes block devices.
* hammer2(8) "growfs" directive doesn't support multi-volumes fs.
* fstyp(8) is unable to find PFS label via -l option if the PFS inode or
  its parent indirect blocks are located beyond root volume.
* hammer2(8) doesn't support "volume-add" and "volume-del" directives
  which existed in HAMMER1, and there is currently no plan to support.