xref: /openbsd-src/share/man/man4/man4.amd64/intro.4 (revision a28daedfc357b214be5c701aa8ba8adb29a7f1c2)
1.\"	$OpenBSD: intro.4,v 1.34 2007/10/09 15:01:40 jmc Exp $
2.\"
3.\" Copyright (c) 1994 Christopher G. Demetriou
4.\" All rights reserved.
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.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"      This product includes software developed by Christopher G. Demetriou.
17.\" 3. The name of the author may not be used to endorse or promote products
18.\"    derived from this software without specific prior written permission
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30.\"
31.Dd $Mdocdate: October 9 2007 $
32.Dt INTRO 4 amd64
33.Os
34.Sh NAME
35.Nm intro
36.Nd introduction to special files and hardware support
37.Sh DESCRIPTION
38The manual pages in section 4 describe the special files,
39related driver functions, and networking support
40available in the system.
41In this part of the manual, the
42.Sx SYNOPSIS
43section of
44each configurable device gives a sample specification
45for use in constructing a system description for the
46.Xr config 8
47program.
48The
49.Sx DIAGNOSTICS
50section lists messages which may appear on the console
51and/or in the system error log
52.Pa /var/log/messages
53due to errors in device operation;
54see
55.Xr syslogd 8
56for more information.
57.Pp
58This section contains both devices
59which may be configured into the system
60and network related information.
61The networking support is introduced in
62.Xr netintro 4 .
63.Sh DEVICE SUPPORT
64This section describes the hardware supported on the amd64 platform.
65Software support for these devices comes in two forms.
66A hardware device may be supported with a character or block
67.Em device driver ,
68or it may be used within the networking subsystem and have a
69.Em network interface driver .
70Block and character devices are accessed through files in the file
71system of a special type; see
72.Xr mknod 8 .
73Network interfaces are indirectly accessed through the interprocess
74communication facilities provided by the system; see
75.Xr socket 2 .
76.Pp
77A hardware device is identified to the system at configuration time
78and the appropriate device or network interface driver is then compiled
79into the system.
80When the resultant system is booted, the autoconfiguration facilities
81in the system probe for the device and, if found, enable the software
82support for it.
83If a device does not respond at autoconfiguration
84time it is not accessible at any time afterwards.
85To enable a device which did not autoconfigure,
86the system will have to be rebooted.
87.Pp
88The autoconfiguration system is described in
89.Xr autoconf 4 .
90.Sh LIST OF DEVICES
91A complete list of available devices is contained within the pages
92describing the system buses and controllers.
93For example, a PCI device would be listed in the
94.Xr pci 4
95man page.
96The following buses and controllers list these devices:
97.Pp
98.Bl -tag -width "cardbus(4)XX" -offset 3n -compact
99.It Xr cardbus 4
100introduction to CardBus support
101.It Xr eisa 4
102introduction to EISA bus support
103.It Xr iic 4
104Inter IC (I2C) bus
105.It Xr isa 4
106introduction to ISA bus support
107.It Xr isapnp 4
108introduction to ISA Plug-and-Play support
109.It Xr onewire 4
1101-Wire bus
111.It Xr pci 4
112introduction to PCI bus support
113.It Xr pcmcia 4
114introduction to PCMCIA (PC Card) support
115.It Xr usb 4
116introduction to Universal Serial Bus support
117.El
118.Sh SEE ALSO
119.Xr autoconf 4 ,
120.Xr cpu 4 ,
121.Xr config 8
122.Sh HISTORY
123The
124amd64
125.Nm intro
126first appeared in
127.Ox 3.5 .
128