Changeset View
Standalone View
sbin/devd/devd.conf.5
Show First 20 Lines • Show All 315 Lines • ▼ Show 20 Lines | ||||||||||
Type of notification, see below. | Type of notification, see below. | |||||||||
.It Li vendor | .It Li vendor | |||||||||
Vendor ID. | Vendor ID. | |||||||||
.El | .El | |||||||||
.Ss Notify matching | .Ss Notify matching | |||||||||
A partial list of systems, subsystems, and types used within the | A partial list of systems, subsystems, and types used within the | |||||||||
.Ic notify | .Ic notify | |||||||||
mechanism. | mechanism. | |||||||||
.\" | ||||||||||
.\" Please keep these tables sorted. Also, please use the same parameters | ||||||||||
.\" for each of the tables so that things line up in columns nicely. | ||||||||||
.\" Please do not omit the type column for notifiers that omit it. | ||||||||||
.Pp | .Pp | |||||||||
.Bl -tag -width ".Li coretemp" -compact | .Bl -column "System" "Subsystem" "1234567" -compact | |||||||||
.It Sy System | .Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | |||||||||
jhb: siginfo(3)/sigevent(3) use Sy (bold) rather than Em (italic) for column headings FWIW. | ||||||||||
Done Inline Actions+1, this might further improve navigating around the manual page. 0mp: +1, this might further improve navigating around the manual page. | ||||||||||
Done Inline ActionsSure. Easy enough. imp: Sure. Easy enough. | ||||||||||
.It Li ACPI | .It Li ACPI Ta Ta Ta | |||||||||
Events related to the ACPI subsystem. | Events related to the ACPI Sybsystem. | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | .It Li ACPI Ta Li ACAD Ta Ta | |||||||||
Done Inline Actions
It seems like '-compact' needs to come before the columns from mdoc(7)? For whatever reason, the pattern in siginfo.3 and sigevent.3 is also to omit the final column. jhb: It seems like '-compact' needs to come before the columns from mdoc(7)? For whatever reason… | ||||||||||
Done Inline ActionsThe manual list -type first (-column is the type) and -compact last in the synopsis. It gives no admonition that it must be first. A quick google search doesn't turn it up either. And none of the man pages in the source tree do that either. I don't see that either siginfo.3 or sigevent.3 use -compact... I'll keep it last... But I can get 2 more characters from Description if I remove trailing white space in System and Subsystem headings. I can get away w/o having the final column arg, so I'll do that. imp: The manual list -type first (-column is the type) and -compact last in the synopsis. It gives… | ||||||||||
Not Done Inline ActionsI was referring to this part of the mdoc(7) manual: Bl -type [-width val] [-offset val] [-compact] [col ...] Begin a list. Lists consist of items specified using the It macro, containing a head or a body or both. Clearly, the optional list of columns [col ...] comes after the optional -compact. I was worried that If the parser was like getopt(3) it would assuming all tokens after the first one that doesn't start with - are column widths, thus treating -compact as a column width. However, it seems like the parser doesn't work like that since it does seem to render the same both ways. jhb: I was referring to this part of the mdoc(7) manual:
```
Bl -type [-width val] [-offset… | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li ACAD | ||||||||||
AC line state ($notify=0x00 is offline, 0x01 is online). | AC line state ($notify=0x00 is offline, 0x01 is online). | |||||||||
.It Li Button | .It Li ACPI Ta Li Button Ta Ta | |||||||||
Button state ($notify=0x00 is power, 0x01 is sleep). | Button state ($notify=0x00 is power, 0x01 is sleep). | |||||||||
.It Li CMBAT | .It Li ACPI Ta Li CMBAT Ta Ta | |||||||||
Battery events. | Battery events. | |||||||||
.It Li Dock | .It Li ACPI Ta Li Dock Ta Ta | |||||||||
Dock state ($notify=0x00 is undocked, 0x01 is docked). | Dock state ($notify=0x00 is undocked, 0x01 is docked). | |||||||||
.It Li Lid | .It Li ACPI Ta Li Lid Ta Ta | |||||||||
Lid state ($notify=0x00 is closed, 0x01 is open). | Lid state ($notify=0x00 is closed, 0x01 is open). | |||||||||
.It Li PROCESSOR | .It Li ACPI Ta Li PROCESSOR Ta Ta | |||||||||
Processor state/configuration ($notify=0x81 is a change in available Cx states). | Processor state/configuration ($notify=0x81 is a change in available Cx states). | |||||||||
.It Li Resume | .It Li ACPI Ta Li Resume Ta Ta | |||||||||
Resume notification. | Resume notification. | |||||||||
.It Li Suspend | .It Li ACPI Ta Li Suspend Ta Ta | |||||||||
Suspend notification. | Suspend notification. | |||||||||
.It Li Thermal | .It Li ACPI Ta Li Thermal Ta Ta | |||||||||
Thermal zone events. | Thermal zone events. | |||||||||
.El | .El | |||||||||
.Pp | .Pp | |||||||||
.It Li CARP | .Bl -column "System" "Subsystem" "1234567" -compact | |||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li CAM Ta Ta Ta | ||||||||||
Events related to the | Events related to the | |||||||||
.Xr cam 4 | ||||||||||
system. | ||||||||||
.It Li CAM Ta Li periph Ta Ta | ||||||||||
Events related to peripheral devices. | ||||||||||
.It Li CAM Ta Li periph Ta Li error Ta | ||||||||||
Generic errors. | ||||||||||
.It Li CAM Ta Li periph Ta Li timeout Ta | ||||||||||
Command timeouts. | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li CARP Ta Ta Ta | ||||||||||
Events related to the | ||||||||||
.Xr carp 4 | .Xr carp 4 | |||||||||
protocol. | protocol. | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | .It CARP Ta Ar vhid@inet Ta Ta | |||||||||
.It Sy Subsystem | ||||||||||
.It Ar vhid@interface | ||||||||||
The | The | |||||||||
.Dq subsystem | .Dq subsystem | |||||||||
contains the actual CARP vhid and the name of the network interface | contains the actual CARP vhid and the name of the network interface | |||||||||
on which the event took place. | on which the event took place. | |||||||||
.Bl -tag -width ".Li MASTER" -compact | .It CARP Ta Ar vhid@inet Ta MASTER Ta | |||||||||
.It Sy Type | ||||||||||
.It Li MASTER | ||||||||||
Node become the master for a virtual host. | Node become the master for a virtual host. | |||||||||
.It Li BACKUP | .It CARP Ta Ar vhid@inet Ta BACKUP Ta | |||||||||
Node become the backup for a virtual host. | Node become the backup for a virtual host. | |||||||||
.El | .El | |||||||||
.Pp | ||||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li coretemp Ta Ta Ta | ||||||||||
Events related to the | ||||||||||
.Xr coretemp 4 | ||||||||||
device. | ||||||||||
.It Li coretemp Ta Li Thermal Ta Ta | ||||||||||
Notification that the CPU core has reached critical temperature. | ||||||||||
.It Li coretemp Ta Li Thermal Ta Li temperature Ta | ||||||||||
String containing the temperature of the core that has become too hot. | ||||||||||
.El | .El | |||||||||
.Pp | .Pp | |||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li IFNET | .It Li IFNET | |||||||||
Events related to the network subsystem. | .It Li IFNET Ta Ar inet Ta Ta | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Ar interface | ||||||||||
The | The | |||||||||
.Dq subsystem | .Dq subsystem | |||||||||
is the actual name of the network interface on which the event | is the actual name of the network interface on which the event | |||||||||
took place. | took place. | |||||||||
.Bl -tag -width ".Li LINK_DOWN" -compact | .It Li IFNET Ta Ar inet Ta Li LINK_UP Ta | |||||||||
.It Sy Type | ||||||||||
.It Li LINK_UP | ||||||||||
Carrier status changed to UP. | Carrier status changed to UP. | |||||||||
.It Li LINK_DOWN | .It Li IFNET Ta Ar inet Ta Li LINK_DOWN Ta | |||||||||
Carrier status changed to DOWN. | Carrier status changed to DOWN. | |||||||||
.It Li ATTACH | .It Li IFNET Ta Ar inet Ta Li ATTACH Ta | |||||||||
The network interface is attached to the system. | The network interface is attached to the system. | |||||||||
.It Li DETACH | .It Li IFNET Ta Ar inet Ta Li DETACH Ta | |||||||||
The network interface is detached from the system. | The network interface is detached from the system. | |||||||||
.El | .El | |||||||||
.El | ||||||||||
.Pp | .Pp | |||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li DEVFS | .It Li DEVFS | |||||||||
Events related to the | .It Li DEVFS Ta Li CDEV Ta Li CREATE Ta | |||||||||
.Xr devfs 5 | ||||||||||
filesystem. | ||||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li CDEV | ||||||||||
.Bl -tag -width ".Li DESTROY" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li CREATE | ||||||||||
The | The | |||||||||
.Xr devfs 5 | .Xr devfs 5 | |||||||||
node is created. | node is created. | |||||||||
.It Li DESTROY | .It Li DEVFS Ta Li CDEV Ta Li DESTROY Ta | |||||||||
The | The | |||||||||
.Xr devfs 5 | .Xr devfs 5 | |||||||||
node is destroyed. | node is destroyed. | |||||||||
.El | .El | |||||||||
.El | ||||||||||
.Pp | .Pp | |||||||||
.It Li GEOM | .Bl -column "System" "Subsystem" "1234567" -compact | |||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li GEOM Ta Ta Ta | ||||||||||
Events related to the | Events related to the | |||||||||
.Xr geom 4 | .Xr geom 4 | |||||||||
framework. | framework. | |||||||||
The difference compared to | The difference compared to | |||||||||
.Li DEVFS | .Li DEVFS | |||||||||
is that | is that | |||||||||
.Li GEOM | .Li GEOM | |||||||||
only includes disk-like devices. | only includes disk-like devices. | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | .It Li GEOM Ta Li DEV Ta Li CREATE Ta | |||||||||
.It Sy Subsystem | ||||||||||
.It Li DEV | ||||||||||
.Bl -tag -width ".Li MEDIACHANGE" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li CREATE | ||||||||||
A | A | |||||||||
.Xr geom 4 | .Xr geom 4 | |||||||||
provider is created. | provider is created. | |||||||||
.It Li DESTROY | .It Li GEOM Ta Li DEV Ta Li DESTROY Ta | |||||||||
A | A | |||||||||
.Xr geom 4 | .Xr geom 4 | |||||||||
provider is destroyed. | provider is destroyed. | |||||||||
.It Li GEOM::physpath | .It Li GEOM Ta Li DEV Ta Li GEOM::physpath Ta | |||||||||
The physical path of a device has changed. | The physical path of a device has changed. | |||||||||
.It Li MEDIACHANGE | .It Li GEOM Ta Li DEV Ta Li MEDIACHANGE Ta | |||||||||
Physical media has changed. | Physical media has changed. | |||||||||
.It Li SIZECHANGE | .It Li GEOM Ta Li DEV Ta Li SIZECHANGE Ta | |||||||||
A | A | |||||||||
.Xr geom 4 | .Xr geom 4 | |||||||||
provider size has changed. | provider size has changed. | |||||||||
.El | .El | |||||||||
.Pp | ||||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li kern Ta Li power Ta Li resume Ta | ||||||||||
Notification that the system has woken from the suspended state. | ||||||||||
.El | .El | |||||||||
.Pp | .Pp | |||||||||
.It Li RCTL | .Pp | |||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li kernel Ta Li signal Ta Li coredump Ta | ||||||||||
Notification that a process has crashed and dumped core. | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
.Bl -column "System" "Subsystem" "1234567" -compact | ||||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li RCTL Ta Ta Ta | ||||||||||
Events related to the | Events related to the | |||||||||
.Xr rctl 8 | .Xr rctl 8 | |||||||||
framework. | framework. | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | .It Li RCTL Ta Li rule Ta Li matched Ta | |||||||||
.It Sy Subsystem | ||||||||||
.It Li rule | ||||||||||
.Bl -tag -width ".Li matched" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li matched | ||||||||||
A rule with action specified as "devctl" was triggered. | A rule with action specified as "devctl" was triggered. | |||||||||
.El | .El | |||||||||
.El | ||||||||||
.Pp | .Pp | |||||||||
.It Li USB | .Bl -column "System" "Subsystem" "1234567" -compact | |||||||||
.Sy "System" Ta Sy "Subsystem" Ta Sy "Type" Ta Sy "Description" | ||||||||||
.It Li USB Ta Ta Ta | ||||||||||
Events related to the USB subsystem. | Events related to the USB subsystem. | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | .It Li USB Ta Li DEVICE Ta Li ATTACH Ta | |||||||||
.It Sy Subsystem | ||||||||||
.It Li DEVICE | ||||||||||
.Bl -tag -width ".Li DETACH" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li ATTACH | ||||||||||
USB device is attached to the system. | USB device is attached to the system. | |||||||||
.It Li DETACH | .It Li USB Ta Li DEVICE Ta Li DETACH Ta | |||||||||
USB device is detached from the system. | USB device is detached to the system. | |||||||||
.El | .It Li USB Ta Li INTERFACE Ta Li ATTACH Ta | |||||||||
.It Li INTERFACE | ||||||||||
.Bl -tag -width ".Li DETACH" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li ATTACH | ||||||||||
USB interface is attached to a device. | USB interface is attached to a device. | |||||||||
.It Li DETACH | .It Li USB Ta Li INTERFACE Ta Li DETACH Ta | |||||||||
USB interface is detached from a device. | USB interface is detached from a device. | |||||||||
.El | .El | |||||||||
.El | ||||||||||
.Pp | .Pp | |||||||||
.It Li coretemp | ||||||||||
Events related to the | .\" | |||||||||
.Xr coretemp 4 | .\" End of tables | |||||||||
device. | .\" | |||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li Thermal | ||||||||||
Notification that the CPU core has reached critical temperature. | ||||||||||
.Bl -tag -width ".Ar temperature" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Ar temperature | ||||||||||
String containing the temperature of the core that has become too hot. | ||||||||||
.El | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
.It Li kern | ||||||||||
Events related to the kernel. | ||||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li power | ||||||||||
.Bl -tag -width ".li resume" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li resume | ||||||||||
Notification that the system has woken from the suspended state. | ||||||||||
.El | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
.It Li kernel | ||||||||||
More events related to the kernel. | ||||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li signal | ||||||||||
.Bl -tag -width ".li resume" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li coredump | ||||||||||
Notification that a process has crashed and dumped core. | ||||||||||
.El | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
.It Li CAM | ||||||||||
Events related to the | ||||||||||
.Xr cam 4 | ||||||||||
system. | ||||||||||
.Bl -tag -width ".Sy Subsystem" -compact | ||||||||||
.It Sy Subsystem | ||||||||||
.It Li periph | ||||||||||
Events related to peripheral devices. | ||||||||||
.Bl -tag -width ".li timeout" -compact | ||||||||||
.It Sy Type | ||||||||||
.It Li error | ||||||||||
Generic errors. | ||||||||||
.It Li timeout | ||||||||||
Command timeouts. | ||||||||||
.El | ||||||||||
.El | ||||||||||
.El | ||||||||||
.Pp | ||||||||||
A link state change to UP on the interface | A link state change to UP on the interface | |||||||||
.Dq Li fxp0 | .Dq Li fxp0 | |||||||||
would result in the following notify event: | would result in the following notify event: | |||||||||
.Bd -literal -offset indent | .Bd -literal -offset indent | |||||||||
system=IFNET, subsystem=fxp0, type=LINK_UP | system=IFNET subsystem=fxp0 type=LINK_UP | |||||||||
.Ed | .Ed | |||||||||
.Pp | .Pp | |||||||||
An AC line state change to | An AC line state change to | |||||||||
.Dq offline | .Dq offline | |||||||||
would result in the following event: | would result in the following event: | |||||||||
.Bd -literal -offset indent | .Bd -literal -offset indent | |||||||||
system=ACPI, subsystem=ACAD, notify=0x00 | system=ACPI subsystem=ACAD notify=0x00 | |||||||||
Done Inline ActionsThis is a bug fix, right? 0mp: This is a bug fix, right? | ||||||||||
Done Inline ActionsYes. Added a comment to the commit message. imp: Yes. Added a comment to the commit message. | ||||||||||
.Ed | .Ed | |||||||||
.Ss Comments | .Ss Comments | |||||||||
Comments may appear anywhere that whitespace may appear in a | Comments may appear anywhere that whitespace may appear in a | |||||||||
configuration file. | configuration file. | |||||||||
To appeal to programmers of all kinds, they can | To appeal to programmers of all kinds, they can | |||||||||
be written in C, C++, or shell/Perl constructs. | be written in C, C++, or shell/Perl constructs. | |||||||||
.Pp | .Pp | |||||||||
C-style comments start with the two characters | C-style comments start with the two characters | |||||||||
▲ Show 20 Lines • Show All 109 Lines • Show Last 20 Lines |
siginfo(3)/sigevent(3) use Sy (bold) rather than Em (italic) for column headings FWIW.