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" "Description" -compact | ||||||||
jhb: It seems like '-compact' needs to come before the columns from mdoc(7)? For whatever reason… | |||||||||
impAuthorUnsubmitted 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… | |||||||||
jhbUnsubmitted 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 System | .Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "Description" | ||||||||
jhbUnsubmitted Done Inline Actions
siginfo(3)/sigevent(3) use Sy (bold) rather than Em (italic) for column headings FWIW. jhb: siginfo(3)/sigevent(3) use Sy (bold) rather than Em (italic) for column headings FWIW. | |||||||||
0mpUnsubmitted Done Inline Actions+1, this might further improve navigating around the manual page. 0mp: +1, this might further improve navigating around the manual page. | |||||||||
impAuthorUnsubmitted 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 | ||||||||
.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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | ||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | |||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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" "Description" -compact | ||||||||
.Em "System" Ta Em "Subsystem" Ta Em "Type" Ta Em "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 | ||||||||
0mpUnsubmitted Done Inline ActionsThis is a bug fix, right? 0mp: This is a bug fix, right? | |||||||||
impAuthorUnsubmitted 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 |
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.