exports(5): mark up the list of groups to --maproot &c as optional

exports(5): Tiny punctuation fix in man page.

pick some nits

exports(5): improve mark up

exports(5): Substantially rewrite for clarity.

Hope this is an improvement over the turgid paragraphs all about
first/second/third cases of everything.

PR misc/58063

exports(5): Revert warning about `-ro' on read/write file systems.

Looks like the nfs server does enforce that after all, in spite of
the rather oblique commentary in the BUGS section about export
options being tied to local mount point options with which they must
be noncontradictory.

And there's no reason in principle it shouldn't enforce this -- it
just need to block various file system _operations_, rather than the
subtree issue where the criteria for evaluating whether operations
are allowed on particular _file handles_ are too painful to
contemplate.

PR misc/58063

exports(5), mountd(8): First pass at clarifying export semantics.

The exports(5) man page is full of walls of turgid prose that should
be itemized lists with syntax templates, and I'm itching to rewrite
it, but let's get the security-relevant warnings out of the way
first.

PR misc/58063

branches: 1.32.30; 1.32.38;
Remove unknown \*(tN and \*(sP macros.

ok wiz.

branches: 1.31.2;
Dots as macro arguments need quoting.
Bug reported by Paul Goyette.

branches: 1.30.40;
Fix a typo.

Document the -network=netname/prefixlength syntax. Requested in
PR 26891 by Arto Selonen.

Also some mdoc improvements.

Improve CAVEATS section. Based on mail by yamt@. Bump date.

Drop trailing space.

- discourage nfs re-exporting.
- bump date.

New sentence, new line. Use more, and more appropriate, mdoc macros.

mountd's -r option always was a dummy, don't advertize using it.
OK'd by fvdl.

branches: 1.23.6;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22366, verified by myself.

Sm off -> Sm on (Sm off...Sm off is not too smart).

Punctuation nits.

Xref inet 4, not 5.

branches: 1.19.2;
Tell people how to make the system re-read this file after changing it
Fixes PR 10398 by John Refling <refling@comet.lbl.gov>.

mountd(8) supports scoped IPv6 address properly (exports(5) requires
scope identifier). remove mention in BUGS section and add note on
scope identifier.

support IPv6 addresses start with hex digit or colon (like ::1).
in manpages, warn that scoped IPv6 addresses are not supported.

Make address handling in mountd more generic, to allow IPv6 mounting.
Add IPv6 example to exports manpage. Allow /prefix notation for
networks.

branches: 1.15.2;
Note that -kerb option is not implemented.

Explain what happens when there is no host set specified in the exports
line, or when a netgroup that has no host is in the set.

Add a warning about exporting a filesystem using WebNFS and also exporting
it the normal way, read/write to specific clients.

Document new options.

Split handling reserved port handling for NFS rpcs and mount rpcs up;
-noresport -> -noresvport, and new option: -noresvmnt

Include a warning in the exports manual page on how -alldirs does
not guarantee that all accesses from a client stay below the mounted
subdirectory.

Checking for the use reserved ports by clients (both for mount/umount
and individual NFS requests) now depends on the '-noresport' option
in the exports file. Checking for reserved ports is the default.

The -n option has become obsolete but is maintained for backwards
compatibility.

Bring in NFSv3 code by Rick Macklem (from Lite2)

convert to new RCS Id conventions; reduce my headache

Update from 4.4-Lite, with local changes.

allow mounting/exporting of NFS files (not just directories) for diskless
swap. thanks to <ws@TooLs.DE> and <roland@frob.com>

Allow exporting whole directory trees with -alldir option in /etc/exports

Add RCS indentifiers.

changed "Id" to "Header" for rcsids

added rcs ids to all files

branches: 1.1.1;
Initial revision