Sync usage with man page.
[netbsd-mini2440.git] / share / man / man4 / man4.evbppc / intro_pmppc.4
blobc748b56cab7710faf2fcf2f67f0614f6f0fe9357
1 .\"     $NetBSD: intro_pmppc.4,v 1.2 2007/10/17 23:36:56 garbled Exp $
2 .\"
3 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
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 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 .\" POSSIBILITY OF SUCH DAMAGE.
26 .\"
27 .Dd October 15, 2007
28 .Dt INTRO_PMPPC 4 evbppc
29 .Os
30 .Sh NAME
31 .Nm intro_pmppc
32 .Nd introduction to pmppc special files and hardware support
33 .Sh DESCRIPTION
34 This section describes the special files, related driver functions,
35 and networking support available in the system.
36 In this part of the manual, the
37 .Tn SYNOPSIS
38 section of each configurable device gives a sample specification
39 for use in constructing a system description for the
40 .Xr config 1
41 program.
42 The
43 .Tn DIAGNOSTICS
44 section lists messages which may appear on the console
45 and/or in the system error log
46 .Pa /var/log/messages
47 due to errors in device operation;
48 see
49 .Xr syslogd 8
50 for more information.
51 .Pp
52 This section contains both devices
53 which may be configured into the system
54 and network related information.
55 The networking support is introduced in
56 .Xr netintro 4 .
57 .Sh PMPPC DEVICE SUPPORT
58 This section describes the hardware supported on the
59 .Tn Artesyn PM/PPC
60 card.
61 Software support for these devices comes in two forms.
62 A hardware device may be supported with a character or block
63 .Em device driver ,
64 or it may be used within the networking subsystem and have a
65 .Em network interface driver .
66 Block and character devices are accessed through files in the file
67 system of a special type; see
68 .Xr mknod 8 .
69 Network interfaces are indirectly accessed through the interprocess
70 communication facilities provided by the system; see
71 .Xr socket 2 .
72 .Pp
73 A hardware device is identified to the system at configuration time
74 and the appropriate device or network interface driver is then compiled
75 into the system.
76 When the resultant system is booted, the
77 autoconfiguration facilities in the system probe for the device
78 and, if found, enable the software support for it.
79 If a device does not respond at autoconfiguration
80 time it is not accessible at any time afterwards.
81 To enable a device which did not autoconfigure,
82 the system will have to be rebooted.
83 .Pp
84 The autoconfiguration system is described in
85 .Xr autoconf 4 .
86 A list of the supported devices is given below.
87 .Sh SEE ALSO
88 .Xr config 1 ,
89 .Xr autoconf 4 ,
90 .Xr cpc 4 ,
91 .Xr cs 4 ,
92 .Xr rtc 4
93 .Sh HISTORY
94 The
95 .Tn evbppc
96 .Nm intro_pmppc
97 man page first appeared in
98 .Nx 5.0 .
99 .Sh LIST OF DEVICES
100 The devices listed below are supported in this incarnation of
101 the system.
102 Devices are indicated by their functional interface.
103 Not all supported devices are listed.
105 PCI devices are supported through the
106 .Xr pci 4
107 bus and associated devices.
109 USB devices are supported through the
110 .Xr usb 4
111 bus and associated devices.
113 Additionally, the following specific devices are supported:
114 .Bl -tag -width "xxxxxxxx" -compact -offset indent
115 .It Em com
116 serial ports in the CPC700
117 .It Em cpc
118 PCI host controller CPC700
119 .It Em cs
120 Ethernet driver
121 .It Em rtc
122 Real Time Clock driver