MFC r326276:

various: general adoption of SPDX licensing ID tags.

Mainly focus on files that use BSD 2-Clause license, however the tool I
was using misidentified many licenses so this was mostly a manual - error
prone - task.

The Software Package Data Exchange (SPDX) group provides a specification
to make it easier for automated tools to detect and summarize well known
opensource licenses. We are gradually adopting the specification, noting
that the tags are considered only advisory and do not, in any way,
superceed or replace the license texts.

No functional change intended.

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

Use strlcpy() when the string is expected to be nul-terminated.

MFC after: 2 weeks

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

Convert usr.sbin to LIBADD
Reduce overlinking

Replace all uses of libncurses and libtermcap with their wide character
variants. This allows usable file system images (i.e. those with both a
shell and an editor) to be created with only one copy of the curses library.

Exp-run: antoine
PR: 189842
Discussed with: bapt
Sponsored by: DARPA, AFRL

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

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

watch: Do not mess up the tty modes on early error.

Record the initial state earlier, so it is always safe to restore it.

One way this happens is if watch(8) is started by a user that does not have
access to /dev/snp. The result is "staircase effect" during later commands.

PR: bin/153052
MFC after: 1 week

Perform even more style changes.

- Remove unneeded whitespace for function calls.
- Add empty line at the top of functions without local variables.
- Change while (1) to for (;;).

MFC after: 1 week

Fix whitespace.

MFC after: 1 week

Convert the snp(4) driver to use cdevpriv.

Now we have a single /dev/snp device node, which can be opened by
watch(8) multiple times. Even though snp(4) will be dead as of next
week, it's nice having this in SVN, because:

- We may want to MFC it to RELENG_7.
- By the time we fix snp(4) again, it's already there, existing watch(8)
binaries should already work.

Just like bpf(4), I'm adding a symlink from snp0 to snp to remain binary
compatible.

Allow watch(8) to use more than 10 snp* devices. This limitation was purely
due to the way watch(8) looks for available snoop devices.

PR: bin/118286
Submitted by: Mykola Zubach <zuborg@advancedhosters.com>
Reviewed by: rwatson, csjp, imp (all a long time ago)
Approved by: imp (mentor) (long time ago)
MFC after: 1 week

Close the tty file descriptor once we're done with it.
Use O_NONBLOCK when opening the tty device.

Suggested by: bde
Submitted by: ru

Restore the ability to detach from a tty via SIOCSTTY and document
recent changes in a manpage.

Reviewed by: cognet

Open the tty device and pass the fd for SNPSTTY.

MFC after: 3 days

Sort sections.

By default, the watch utility will attempt to open /dev/snp0, if
another process already has /dev/snp0 open, the snp(4) will return
EBUSY, in which case watch will try to open /dev/snp1..9. Currently
watch does not check errno to see if the failure was a result of EBUSY.

This results in watch making futile attempts to open snp0..snp9 even
though devices may not exist or the caller does not have permissions
to access the device.

In addition to this, it attempts to setup the screen for snooping even
though it may not ever get an snp device.

So this patch does two things
1) Checks errno for EBUSY, if open(2) fails for another reason
print that reason and exit.
2) setup the terminal for snooping after the snp descriptor has
been obtained.

Approved by: bmilekic (mentor)

Eliminated double whitespace.

Mechanically kill hard sentence breaks.

Remove constant which makes the assumption that the length of
_PATH_DEV will never change. In the un-likely event that _PATH_DEV
should ever change, watch(8) would have broke because of a
mis-generated device name.

Approved by: bmilekic (mentor)
Pointed out by: Yvan Boily

Userland signed char fixes for PPC build. Problems were using a char
return for getopt() and comparing to -1, ditto with fgetc() and EOF,
and using the kg_nice value from <sys/user.h>

Submitted by: Stefan Farfeleder <stefan@fafoe.narf.at>
Reviewed by: obrien, bde (a while back)
Tested lightly on: ppc, i386, make universe

Use __FBSDID over rcsid[]. Protect copyright[] where needed.

style.Makefile(5)

Fix typos, mostly s/ an / a / where appropriate and a few s/an/and/
Add FreeBSD Id tag where missing.

The FIONREAD sysctl operates on an int *, not a size_t *.

Reviewed by: dd

Add break's to case blocks.

PR: bin/41511
Submitted by: Daniel Hagan <dhagan@acm.vt.edu>

The .Nm utility

de __P
ANSI functions
minor knf

#include <time.h> for the definition of time functions instead of
depending on namespace pollution 2 layers deep in <sys/stat.h>.

Talk about what the user needs to do to get the snp devices, and how
watch(8) will try to help them by loading the module.

PR: 25420

Change 'superuser' to 'user' which was forgotten in the previous
delta. Remove fake SCCS id while I'm here.

Remove the sentence about only root being able to run watch(8). It
was never technically true (it's snp(4) that required root, not
watch(8)), and after snp.c 1.64, isn't even effectively true, since
who can run watch(8) depends on the permissions of the snp device(s).

Sort options in SYNOPSIS and DESCRIPTION while I'm here.

Add an -f option which allows one to specify a snp device to use.
Previously, watch would always use the first device it could
successfully open, but this isn't always desired. Specifically, it
may not be desired during debugging (of snp), or if a particular snp
device has different permissions (which makes since after snp.c 1.64).

o When "-n" is used with watch, it disables the use of <control-X> to
change terminals being watched. This change makes watch pass the
<control-X> through to the terminal if it's not being intercepted--
previously, the keypress would simply be dropped.

Automatically load the "snp" module if it isn't already present.

Back out WARNS commenting - local fault

Unbreak world - comment out WARNS=2 - deadly warning on tgetstr

Perform a major cleanup of the usr.sbin Makefiles.
These are not perfectly in agreement with each other style-wise, but they
are orders of orders of magnitude more consistent style-wise than before.

Add prototypes, staticize, constify, don't shadow global variables and
functions, remove an unused function, and silence other assorted
warnings.

Set WARNS=2.

Replace an instance of the "watch" word with the ".Nm" macro: it is used to
specify the command name.

- Backout botched attempt to introduce MANSECT feature.
- MAN[1-9] -> MAN.

o Strip BINMODE from Makefile. Installing watch with 0500 provides no
added security benefit, as it doesn't provide extra privilege.
Protection against inappropriate snooping is done by protecting
/dev/snp* properly.

Set the default manual section for usr.sbin/ to 8.

Add `_PATH_DEVZERO'.
Use _PATH_* where where possible.

mdoc(7) police: use the new features of the Nm macro.

Add missing .El.
-Wall cleaning.

``tty'' is not required parameter

Fix warning: return type of `main' is not `int'

$Id$ -> $FreeBSD$

Add $Id$, to make it simpler for members of the translation teams to
track.

The Id line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde

.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.

Use err(3).

compare return value from getopt against -1 rather than EOF, per the final
posix standard on the topic.

Removed old bogus prerequisite <sys/select.h>. Cleaned up #include mess.

1. change tty handling from sgttyb to termios,
2. fix a potential buffer oflow,
3. makes watch(8) conform to sysexits(3).

Not a strong 2.2 candidate even if it would be nice.

Reviewed by: joerg, imp

Revert $FreeBSD$ to $Id$

Sort cross references.

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Remove breakage of 1.8.2.2, choose slightly better character for quit.

Use RAW, not CBREAK

Fix a typo in the man page (the "-n" flag was added to the synopsis in
a comment).

I have added a '-n' flag to the watch(8) command. This option
disables the ability to interactively select a new tty. I have also
removed a check for uid == 0 because it gets in the way of using suid
mode based access control. Watch (8)is only runnable by root, so this
does not really change things much.

Closes PR#2131

Submitted-By: adrian@virginia.edu

Set ${DPADD}, use +=, add $Id$

Use the .Fx macro where appropriate.

Properly save and restore the terminal characters!

Fix a bunch of spelling errors in a bunch of man pages.

Map ^C and ^\ (INTR and QUIT) to ^Q so that you can actually send these
guys to a watched process. Useful if you're monitoring someone who's
started doing something you'd really like them to stop immediately. :)
Suggested by: Phillip White <philw@megasoft.tic.ab.ca>

Add setlocale LC_TIME

Add missing ospeed initialization

Remove trailing whitespace.

same

Update to use new calling conventions

Fix(it was 1 character actually:)

Rewrite manual page to use mandoc correctly and fix english grammar.

Remove bogus reference to snp.4. Somebody kinda screwed up their move! :)

Manpage for snoop device itself.

Add manpage to makefile

Watch fresh-made manpage..

This is watch - programm to work with /dev/snp,
it still lacks manpage-i will commit it today later.
For now to test try: watch [ttyname] :)