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

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

MFC r296653: Allow standard commands for "unknown" classes in RESCUE mode.

For example, it allows quite useful `geom disk list` command.

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

More -Wmissing-variable-declarations fixes.

In addition to adding `static' where possible:

- bin/date: Move `retval' into extern.h to make it visible to date.c.
- bin/ed: Move globally used variables into ed.h.
- sbin/camcontrol: Move `verbose' into camcontrol.h and fix shadow warnings.
- usr.bin/calendar: Remove unneeded variables.
- usr.bin/chat: Make `line' local instead of global.
- usr.bin/elfdump: Comment out unneeded function.
- usr.bin/rlogin: Use _Noreturn instead of __dead2.
- usr.bin/tset: Pull `Ospeed' into extern.h.
- usr.sbin/mfiutil: Put global variables in mfiutil.h.
- usr.sbin/pkg: Remove unused `os_corres'.
- usr.sbin/quotaon, usr.sbin/repquota: Remove unused `qfname'.

MFgraid/head r217014:
Make `geom XXX list` and `geom XXX status` outputs more consistent:
Add -a options to print all geoms, not only ones with providers.
Add -g option for `status` to report geom's names, not provider's.
Make `status` by default report provider's status (if present), not geom's.
Make `status` report consumer's statuses, not only "synchronized" field.

Rename the generic "CLASS" to the more specific "GEOM_CLASS".
While I'm here remove redundancy and inconsistencies.

Obtained from: Juniper Networks

Remove dead code.

Remove now unused G_TYPE_ASCNUM.

Remove dot which shouldn't be here, as err(3) will attach error message
at the end of the string.

Introduce special G_VAL_OPTIONAL define, which when given in value field
tells geom(8) to ignore it when it is not given and don't try to obtain
default value.

Add G_TYPE_MULTI flag, which when set for the given option, will
allow the option to be specified multiple times. This will help to
implement things like passing multiple keyfiles to geli(8) instead of
cat(1)ing them all into stdin and reading from there using one '-k -'
option.

- Remove gc_argname field. It was introduced for gpart(8), but if I
understand everything correctly, we don't really need it.
- Provide default numeric value as strings. This allows to simplify
a lot of code.
- Bump version number.

- Allow to specify value as const pointers.
- Make optional string values always an empty string.

o List MOUNTVER and SCHED classes. X-ref gsched(8). Bump Dd.

PR: docs/149925
Submitted by: arundel

expand_number(3) takes a uint64_t * now; intmax_t was never correct
except by accident.

MFC after: 3 weeks

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>

Fix typos and spelling mistakes.

Remove G_TYPE_ASCLBA type and replace it with G_TYPE_STRING in gpart.
Move code that converts params from humanized numbers to sectors count
to subr.c and adjust comment.
Add post-processing for "size" and "start offset" params in gpart,
now they are properly converted to sectors count with known sector size
that can be greater that 512 bytes.
Also replace "unsigned long long" type to "off_t" for unify code since
it used for medium size in libgeom(3) and DIOCGMEDIASIZE ioctl.

PR: bin/146277
Reviewed by: marcel (previous version)
Approved by: kib (mentor)
MFC after: 1 month

Also output stripeoffset for consumer even if stripesize is zero, while
stripeoffset is non-zero.

Pointed out by: mav

Stripe offset may be usable even without stripe size known,
so give the output when either is non-zero.

Suggested by: mav

Expose stripe offset and stripe size through libgeom and geom(8) userland
utilities.

Reviewed by: pjd, mav (earlier version)

Add gmountver, disk mount verification GEOM class.

Note that due to e.g. write throttling ('wdrain'), it can stall all the disk
I/O instead of just the device it's configured for. Using it for removable
media is therefore not a good idea.

Reviewed by: pjd (earlier version)

Add manual page for gcache(8).

Update copyright years.

For any given subcommand allow to specify multi-line usage (separated by \n).

Submitted by: Mel Flynn

Allow humanized numbers for LBAs, as well as partition indices for
gpart(8). LBAs in particular are ugly. The ganularity is a sector,
but users expect byte granularity when specifying the size or offset
with a SI unit. Handle LBAs specially to deal with this.

Add links to libgeom(3) where appropriate.

- Use a separate pointer to the allocated memory for freeing, as strsep may
modify the pointer argument passed to it. This triggered an assert in malloc
when a geom command being run under the livefs environment.

PR: bin/130632
Submitted by: Dimitry Andric <dimitry -at- andric.com>
Pointy hat to: me
MFC after: 2 days

Replace checks for RESCUE in sources with checks for STATIC_GEOM_CLASSES
and define STATIC_GEOM_CLASSES when building the rescue binary. This way
geom can more easily be part of other crunched binaries, as it requires
only a Makefile change.

Make it possible to build glabel into rescue geom(8) utility.

Ok'ed by: marcel
No objection: -current@

Add info about few missing GEOM classes that use geom(8).

- Update geom(8) to explain that GEOM_LIBRARY_PATH can take a comma-separated
list of paths.

Approved by: pjd (mentor)
MFC after: 2 days

- Make geom commands handle multiple library paths in the GEOM_LIBRARY_PATH
environment variable using ':' as a separator.

Approved by: pjd (mentor)
MFC after: 3 days

Allow building of a special rescue version of geom that
has a subset of the classes compiled-in.

Bring in the GEOM Virtualisation class, which allows to create huge GEOM
providers with limited physical storage and add physical storage as
needed.

Submitted by: Ivan Voras
Sponsored by: Google Summer of Code 2006
Approved by: re (kensmith)

For arguments declared as numbers always use expand_number(3).
This allows to use numbers in human-readable form in many geom(8)
utilities. Such a simple change and makes live so much nicer.
Some examples:

gstripe label -s 16k
gmirror label -s 4k
gnop create -o 1g -s 128m -S 2k
gjournal label -s 2g
geli label -i 128k -s 4k

Approved by: re (kensmith)

Use 'val' function argument instead of 'optarg' global variable.
This doesn't fix any real bug, because in those tw ocases we always
passed 'optarg' as 'val'.

Approved by: re (kensmith)

Fix the construction of the gctl_req that got broken by my
previous commit and that introduced optional parameters.
Existing classes (like geli(8)) use empty strings by default
and expect the parameter to be passed to the kernel as such.
Also, the default value of a string argument can be NULL.
Fix both cases by making the optional parameter conditional
upon gc_argname being set and making sure to test for NULL
before dereferencing the pointer.

Reported by: brueffer@

Bump G_LIB_VERSION to reflect the ABI change.

Pointed out by: pjd@

Add gpart(8).

In order to support gpart(8), geom(8) needs to support a named
argument. Also, optional string parameters are a requirement.
Both have been added to the infrastructure. The former required
all existing classes to be adjusted.

Exit status should be 1 on error.

PR: bin/110705
Reported by: Tom Judge
MFC after: 2 weeks

MFp4:

- Print proper error message when argument is specified twice.
Before the change it was detected properly, because of how
G_OPT_DONE() macro worked.
- Use err(3) functions where appropriate.
- Add some assertions.
- Bump version number, because G_TYPE_BOOL addition breaks API and ABI.

Changes: 98721,98722,98723,101360,106985

Allocate memory for NUL-termination as well.

MFC after: 2 days

Remove trailing spaces.

Add a reference to geli(8).

MFC after: 3 days

- The geom(8) utility only uses three types of arguments: string (char *),
value (intmax_t) and boolean (int).
Based on that provide three functions:
- gctl_get_ascii()
- gctl_get_int()
- gctl_get_intmax()
- Hide gctl_get_param() function, as it is only used internally in
subr.c.
- Allow to provide argument name as (fmt, ...).
- Assert geom(8) bugs (missing argument is a geom(8) bug).

- Clean-up and simplify the code by using new functions and assumtions
(no more checking for missing argument).

Tested by: regression tests

Unfortunately dlerror(3) returns string, so there is no clean way to
ignore "no such file" errors only, which I wanted to do.
Because of this I ignored all other errors on dlopen(3) failure as well,
which isn't good.
Fix this situation by calling access(2) on library file first and ignore
only ENOENT error. This allows to report all the rest of dlopen(3) errors.

MFC after: 3 days

Remove trailing spaces.

Empty error buffer is not an error.

MFC after: 3 weeks

Fix use of uninitialized buf[0].

Reported by: stefanf
MFC after: 3 days

Be sure that class name storaed in 'class_name' is lower case.

MFC after: 1 week

- Add gc_usage field to g_command structure. This will allow to define
usage for a subcommand, so no 'usage' function has to be implemented
in class library.
- Bump version number as it breaks ABI, but don't provide backward
compatibility, because there are probably no external consumers of this
geom(8).
This allows to print more precise usage for standard commands and simplify
class libraries a bit.

MFC after: 1 week

Document subcommands' arguments.

MFC after: 1 week

Document '-s' option of 'status' subcommand.

MFC after: 1 week

Add '-s' option to 'status' subcommand. It produces script-friendly output:

# gmirror status
Name Status Components
mirror/root COMPLETE ad0s1a
ad2s1a
mirror/data DEGRADED da0
da1 (76%)
da2
# gmirror status -s
Name Status Components
mirror/root COMPLETE ad0s1a
mirror/root COMPLETE ad2s1a
mirror/data DEGRADED da0
mirror/data DEGRADED da1 (76%)
mirror/data DEGRADED da2

MFC after: 1 week

Use int instead of size_t (%*s needs int).

MFC after: 1 week

printf(3) expects that %*s having an int parameter, which generates
warning on 64-bit platforms. Explicitly cast these values to int
to work around this issue, as these values are tend to be small.

Spotted by: ia64 tinderbox

- Document 'status' subcommand.
- Update copyrights.

MFC after: 1 week

Add 'status' command which prints general information about devices.
For example:

# gmirror status
Name Status Components
mirror/root COMPLETE ad0s1a
ad2s1a
mirror/data DEGRADED da0
da1 (76%)
da2

MFC after: 1 week

Update copyrights.

Change function names related to 'list' command from 'show_one_*' to
'list_one_*'.

MFC after: 1 week

When listing all devices (geoms) from the given class, skip geoms without
providers.
This prevents from listing geoms like <name>.sync which can be confusing.
It still allows to show details about it by giving its name when listing.

MFC after: 1 week

- Add GEOM_LIBRARY_PATH environment variable which allows to specify an
alternative to /lib/geom/ path where shared libraries are stored.
- Improve debugging.

MFC after: 3 days

Add SHSEC class to the list of geom(8)-aware classes.

MFC after: 3 days

Add a missing comma.

Sort sections.

Added the EXIT STATUS section where appropriate.

Connect SHSEC GEOM class to the build.

Detect if class name is '-h' or 'help' and if it is, show general help
message, i.e.:
geom: usage: geom <class> <command> [options]

PR: bin/71537
Submitted by: bugghy <bugghy@phenix.rootshell.be>
MFC after: 5 days

NOSHARED -> NO_SHARED

Grammatical and spelling improvements.

Reviewed by: pjd

- Show all commands in usage, even if those commands are not available.
- When command is not available, just say it, instead of says, that command
is unknown. Old behaviour seems to be too confusing.

- If error string begins with "warning: ", don't exit, treat it as a warning
only.
- Use getprogname() function when informing about versions problem.

Add missing GEOM classes, which are aware of geom(8).

Submitted by: kuriyama

- Add a manual page for graid3(8) utility.
- Connect it to the build.
- Inform geom(8) about it.

- Add a manual page for gmirror(8) utility.
- Connect it to the build.
- Inform geom(8) manual page about it.

Reviewed by: trhodes

The geom(8) utility needs dynamic linker functionality to work, so it can't
be staticaly linked.
This fixes problems on systems compiled with NO_DYNAMICROOT.

Don't use version number in library name. The library version is checked
after dlopen() anyway, so we should be safe.

Suggested by: ru

After changing LIBDIR to SHLIBDIR, because of dependencies problems,
new problem shows up: symblic links (<libname>.so) are created under
/usr/lib/ now, instead of under /lib/geom/ where geom(8) looks for them.
Introduce a workaround to fix this by teaching geom(8) to open libraries
via /lib/geom/<libname>.so.<major_number> instead of /lib/geom/<libname>.so.

Improve geom(8)'s 'list' command to show geoms and their providers and
consumers. Teach STRIPE, CONCAT and NOP classes about this improvement.

Add a reference to glabel(8).

Slight markup and grammar fixes.

Connect geom(8) to the build.

Reminded by: des

Fix order.

Print provider's size in human-readable form as well.

Add manual page for geom(8) utility.

Supported by: Wheel - Open Technologies - http://www.wheel.pl

Add standard command "help" to print usage.

Various style.Makefile(5) improvements.

Inspired by: ru

Fix supposed compilation problem, using LIBDIR here can confuse core/
compilation.

Bring in geom(8) utility. It is an universal utility for operating on
GEOM classes. It works by loading a shared library via dlopen(3) mechanism
with class-specific code, it is also responsible for communicating with
GEOM via libgeom(3).
Per-class shared libraries are going to be stored in /lib/geom/ directory.
It provides also few standard commands like 'list', 'load' and 'unload'
for existing classes which aren't aware of geom(8).
More info will be send on freebsd-current@ mailing list.

Supported by: Wheel - Open Technologies - http://www.wheel.pl