1.\" 2.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3.\" 4.\" Copyright (c) [year] [your name] 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25.\" SUCH DAMAGE. 26.\" 27.\" Note: The date here should be updated whenever a non-trivial 28.\" change is made to the manual page. 29.Dd July 31, 2015 30.Dt EXAMPLE 4 i386 31.Os 32.Sh NAME 33.Nm example 34.Nd "example device driver manual page" 35.Sh SYNOPSIS 36To compile the driver into the kernel, 37place the following lines in the 38kernel configuration file: 39.Bd -ragged -offset indent 40.Cd "device example" 41.Cd "options EXAMPLE_DEBUG" 42.Ed 43.Pp 44Alternatively, to load the driver as a 45module at boot time, place the following line in 46.Xr loader.conf 5 : 47.Bd -literal -offset indent 48example_load="YES" 49.Ed 50.Sh DESCRIPTION 51This is an example device driver manual page for the 52.Nm 53driver. 54It is intended that this example can be used as a template 55when writing a new manual page. 56.Pp 57The 58.Nm 59driver supports the following ioctls: 60.Bl -tag -width "EIOCNULL" 61.It Dv EIOCEX 62Example ioctl. 63.It Dv EIOCNULL 64Example ioctl. 65.El 66.Pp 67If the kernel is compiled with the 68.Dv EXAMPLE_DEBUG 69option, then additional debugging messages will be displayed. 70.Sh HARDWARE 71The 72.Nm 73driver supports the following example hardware: 74.Pp 75.Bl -bullet -compact 76.It 77Example device 4201 78.It 79Example device 4202 80.El 81.Sh FILES 82.Bl -tag -width "/dev/null" -compact 83.It Pa /dev/null 84Example of a file in the 85.Sx FILES 86section. 87.El 88.Sh DIAGNOSTICS 89.Bl -diag 90.It "example%d: example diagnostic message." 91An example of a diagnostic message. 92.It "example%d: another example diagnostic message." 93Self explanatory. 94.El 95.Sh SEE ALSO 96.Xr example 1 , 97.Xr example 3 , 98.Xr mdoc 7 , 99.Xr example 9 100.Sh HISTORY 101The 102.Nm 103device driver first appeared in 104.Fx 2.2 . 105.Pp 106Some other common 107.Sx HISTORY 108section examples are: 109.Pp 110The 111.Nm 112manual page example first appeared in 113.Bx 4.4 . 114.Pp 115The 116.Nm 117manual page example first appeared in 118.At v6 . 119.Sh AUTHORS 120This manual page was written by 121.An Mike Pritchard Aq Mt mpp@FreeBSD.org . 122.Sh BUGS 123The actual code for this device driver is vaporware. 124