devd: Add directory information

Devd searches /etc/devd and /usr/local/etc/devd by default (given the
default devd.conf file). Document that here.

Sponsored by: Netflix

devd: Document the nvme devd events

Nvme informs devd of smart and reset controller events. Document them.

Sponsored by: Netflix
Differential Revision: https://reviews.freebsd.org/D44212

Remove $FreeBSD$: two-line nroff pattern

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/

devd.conf.5: Fix a typo in the manual page

- s/deteted/detected/

MFC after: 5 days

newbus: Remove deprecated "kern" system name for resume events.

The new "kernel" system name is the one that's documented and has
been generated for a year now. Remove the old one now that 14.0
is getting close.

Sponsored by: Netflix
Reviewed by: bapt
Differential Revision: https://reviews.freebsd.org/D37582

Track removal of Tokenring and FDDI media types from devd.cc.

Fixes: eec02418d83b Remove support for FDDI and token ring media types in userland utilities.

Reviewed by: brooks, gjb, imp

Approved by: brooks (src), gjb (mentor, src), imp (src)

Differential Revision: https://reviews.freebsd.org/D36668

MFC after: 3 days

vt: fix git mismerge

I made a mistaking in merging the final commits for the devctl changes. This
adds the 'hushed' variable and has the correct dates for the manuals.

Pointy hat to: imp

vt: fix typo

Notifcation -> Notification

vt: Add devctl message for bells

Generate VT events when the bell beeps. When coupled with disabling the
bell,this allows custom bells to be rung when we'd otherwise beep.

Reviewed by: kevans
Differential Revision: https://reviews.freebsd.org/D32656

devctl: add ADDR_ADD and ADDR_DEL devctl event for IFNET

Add devd event on network iface address add/remove. Can be used to
automate actions on any address change.

Reviewed by: imp@ (and minor style tweaks)
Sponsored by: Netflix
Differential Revision: https://reviews.freebsd.org/D30840

devctl: add RENAME devctl event for IFNET

Add devd event on network iface rename.

Reviewed by: imp@,asomers@
Sponsored by: Netflix
Differential Revision: https://reviews.freebsd.org/D30839

devd.conf(5): Fix a mandoc related issue

- sections out of conventional order: Sh SEE ALSO

MFC after: 1 week

Prefer Em to Ar for emphasis

Em is better than Ar if all we want to do is underline the text.

Submitted by: yuripv@

Document the rather suprising behavior with ' inside action rules.

To prevent issues with odd shell characters appearing in, a surprising
shell feature is used. Document it and a workaround for it.

Differential Revision: https://reviews.freebsd.org/D26723

devd.conf(5): Bugfix for an issue reported by mandoc

- whitespace at end of input line

MFC after: 1 week

Sort IFNET alphabetically

Add documentation for ETHERNET events.

Change the resume notification event from 'kern' to 'kernel'

We have both a system of 'kern' and of 'kernel'. Prefer the latter and
convert this notification to use 'kernel' instead of 'kern'. As a
transition period, continue to also generate the 'kern' notification
until sometime after FreeBSD 13 is branched.

MFC After: 3 days

Document the VFS FS events

MOUNT notifies when a filesystem is mounted
REMOUNT notifies when a filesystem is mounted again
UNMOUNT notifies when a filesystem is unmounted

These events are asynchronous to the actual state of the event (though the data
is recorded at a time when it is stable). The mount event is reported after the
filesystem is mounted. However, in the interim it may be unmounted by another
agent. Likewise, umount is called just before the mountpoint is finished tearing
down. It may be remounted (or maybe if the process scheduling is wonky and devd
gets to run before the last few steps are complete).

Sponsored by: Netflix
Diffential Revision: https://reviews.freebsd.org/D25969

Three typos:
Amiga is a proper noun
Condition is traditionally spelled starting with 'c'
Some, but not all, of the over/under-voltage instances were hyphenated.
Since they are all adverb phrases, they all need to be hyphenated.

Pointy hat: imp

Fix two typos.

Submitted by: rpokala@
MFC After: 3 days

Document the ZFS events as best I can. These are not well documented.

MFC After: 3 days

Document the AEON subsystem for the Amiga's power button.

MFC After: 3 days

Document the PMU system

The pmu(4) and adb(4) drivers on powerpc generate PMU events. Document them.

The allwinner power modules also generate these events. Document those as well.

MFC After: 3 days

GEOM::rotation_rate changes are also signaled via devctl.

MFC After: 3 days

Move the possible event types into a column table to make it easier to read.

Sort system type alphabetically.
Remove some commas that aren't in the devd notification messages.

MFC After: 3 days
Reviewed by: 0mp (earlier versions), jhb (useful feedback on earlier versions)
Differential Revision: https://reviews.freebsd.org/D26105

Modernize a bit.

Remove PC Card specific information. It's of little value these days and on
the way out after most of its drivers have been removed.
Use iwn instead of wi device.

Regularize my copyright notice

o Remove All Rights Reserved from my notices
o imp@FreeBSD.org everywhere
o regularize punctiation, eliminate date ranges
o Make sure that it's clear that I don't claim All Rights reserved by listing
All Rights Reserved on same line as other copyright holders (but not
me). Other such holders are also listed last where it's clear.

acpi_dock(4): Notify devd(8) on dock status change.

PR: 238138
Submitted by: Muhammad Kaisar Arkhan <hi@yukiisbo.red>
MFC after: 2 weeks

Introduce new event SIZECHANGE within GEOM system to inform about GEOM
providers mediasize changes.

While here, use GEOM nomenclature to describe providers instead of calling
them device nodes.

Obtained from: Fudo Security
Tested in: AWS

Document kernel/signal/crashdump devd(8) notification.

Discussed with: kib@
MFC after: 2 weeks
Sponsored by: DARPA, AFRL
Differential Revision: https://reviews.freebsd.org/D16323

Consistently use full stops.

MFC after: 2 weeks
Sponsored by: DARPA, AFRL

Sort SEE ALSO section sequentially.
Highlighted by mandoc -Tlint

PR: 212440
Approved by: imp
MFC after: 5 days
Differential Revision: https://reviews.freebsd.org/D8192

Add GEOM::physpath documentation to devd.conf(5)

Suggested by: trasz
Reviewed by: trasz
MFC after: 4 weeks
Sponsored by: Spectra Logic Corp
Differential Revision: https://reviews.freebsd.org/D6063

Update the devd.conf man page to describe the new CAM/periph system/subsystem.

MFC after: 3 days
Sponsored by: Netflix

Add a timestamp variable to the environment. This is when the event
was read from the kernel by devd.

Sometimes, it's useful to export the entire line to an external
program without listening to the devd socket for all events. Define
two new pseudo variables $*, the entire event from devctl and $_,
the entire event without the type character, since it might be easier
to use in some circumstances.

carp(8) -> carp(4)

MFC after: 1 month
Sponsored by: The FreeBSD Foundation

Document suspend/resume notification in devd.conf(5).

MFC after: 2 weeks
Sponsored by: The FreeBSD Foundation

Add CARP events description to devd.conf(5).

MFC after: 2 weeks
Sponsored by: The FreeBSD Foundation

Document RCTL events in devd.conf(5).

MFC after: 1 month
Sponsored by: The FreeBSD Foundation

Add devd(8) notifications for creation and destruction of GEOM devices.

Differential Revision: https://reviews.freebsd.org/D1211
MFC after: 1 month
Sponsored by: The FreeBSD Foundation

Reflect CARP media-type departure.

X-MFC after: never

Separate items in the list of System values with .Pp to ease readability.

document acpi_cpu devd notification about _CST change

Based on prodding and a submission by Lars Engels <lars.engels@0x20.net>.

MFC after: 5 days

o Sort .Xrs.

Xref re_format(7) in devd.conf(5), not in devd(8).

Pointy hat to: glebius

- Add support for a "!" character in regex matching in devd(8). It inverts
the logic (true/false) of the matching.

- Add "!usbus[0-9]+" to IFNET ATTACH notification handler in the default
devd.conf to prevent rc.d/netif from running when usbus[0-9]+ is attached.

Reviewed by: imp

Typo. For USB devices, 'serial' should be 'sernum'.
See sys/dev/usb/usb_device.c for what devctl_notify() gets.

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

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>

MFC r207020, r207027, r207072.

Change usb devd events from fake attach to a notify. The ugen device is not a
proper device_t so it faked the devctl event to appear like one, this is now a
notify which allows more information to be passed.

We notify for both the device attach/detach and for each usb interface. A devd
rule can now match on the interface properties, including composite devices
which may have a uvideo interface and also usound and possibly uhid too.

An example to match a umass device with a scsi subclass and BBB protocol would be

notify 100 {
match "system" "USB";
match "subsystem" "INTERFACE";
match "type" "ATTACH";
match "intclass" "0x08";
match "intsubclass" "0x06";
match "intprotocol" "0x50";
action ...
};

The old attach devctl event has been retained for the moment to make merging to
8.1 easier. This was never compatible with 7.x or earlier due to the ugen regex
change needed.

Document the new USB notification types.

Document the new USB notification types.

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.

o Spell. Sort .Xrs.

Document several notifications, among them are DEVFS, update to ifneti,
coretemp and kern.

The asmc(4) and zfs(5) are still not documented.

Based on the patch by Roland Smith <rsmith xs4all nl>.
MFC after: 1 week

Clarify that configuration files must be named '*.conf'

- Import the HEAD csup code which is the basis for the cvsmode work.

Fix the description of "media-type".

Revise the markup, sort sections, fix some grammar bugs.
Not fixed: the description of media-type is completely bogus.

flesh out the devd.conf man page... Mostly from the PR, but did a couple
gramatical tweaks along w/ sorting the list, and adding that serial is
available for USB....

PR: 85097
Submitted by: Fredrik Lindberg
MFC after: 1 week

mdoc(7) police: Revision.

The bugs section hasn't been true since before 5.0-R

devd not devdd

submitted by: joe

english(4) police.

MFp4 (imp_freebsd branch): snapshot of devd work:
o improve parsing and lexing
o create data structures based on the parsed file now.
o Still need to rewrite main loop and add regex (still uses hard coded
devd-generic)
o minor man page updates.

# There should be one more commit before rc2

Approved by: re (blanket)

Fixup FILES section to use proper width and to use a cross-reference to
devd(8).

Add BUGS section and note departure of actual implementation from what
is documented so the pioneers will know why it works the way it does.

devd. A daemon that hooks into the kernel's /dev/devctl to produce
arbitrary commands when devices come and go in the device tree (which is
different than the /dev directory).

This is an initial version. Much of the planned power isn't here.
Instead of doing the full matching, we always run /etc/devd-generic.
/etc/devd.generic will go away at some point, I think.

I'm committing it in this early state so I can start getting feedback
from early adapters.

Approved by: re