xref: /netbsd-src/share/man/man4/man4.i386/elanpex.4 (revision 274254cdae52594c1aa480a736aef78313d15c9c)
1.\"	$NetBSD: elanpex.4,v 1.3 2008/04/08 20:30:16 dyoung Exp $
2.\"
3.\"
4.\" Copyright (c) 2008 David Young.  All rights reserved.
5.\"
6.\" Written by David Young.
7.\"
8.\" Redistribution and use in source and binary forms, with or
9.\" without modification, are permitted provided that the following
10.\" conditions are met:
11.\" 1. Redistributions of source code must retain the above copyright
12.\"    notice, this list of conditions and the following disclaimer.
13.\" 2. Redistributions in binary form must reproduce the above
14.\"    copyright notice, this list of conditions and the following
15.\"    disclaimer in the documentation and/or other materials
16.\"    provided with the distribution.
17.\" 3. David Young's name may not be used to endorse or promote
18.\"    products derived from this software without specific prior
19.\"    written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY DAVID YOUNG ``AS IS'' AND ANY
22.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
23.\" THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
24.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL DAVID
25.\" YOUNG BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26.\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
27.\" TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
29.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32.\" POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd January 10, 2008
35.Dt elanpex 4 i386
36.Os
37.Sh NAME
38.Nm elanpex
39.Nd AMD Elan SC520 PCI Exception Instrumentation
40.Sh SYNOPSIS
41.Cd "elansc* at mainbus? bus ?"
42.Cd "elanpex* at elansc?"
43.Sh DESCRIPTION
44The
45.Nm
46driver supports the PCI exception-reporting facilities of the AMD
47Elan SC520 microcontroller's integrated PCI host controller.
48.Sh DIAGNOSTICS
49.Bl -ohang
50.It Em PCI master exceptions
51.Pp
52The host controller may originate a transaction of type
53.Em %s
54on bus address
55.Em %x
56that fails for the following reasons:
57.Bl -diag
58.It elanpex0: %s %x master retry timeout
59.It elanpex0: %s %x master target abort
60.It elanpex0: %s %x master abort
61.It elanpex0: %s %x master system error
62.It elanpex0: %s %x master received parity error
63.It elanpex0: %s %x master detected parity error
64.El
65.Pp
66Transaction types include
67.Bl -diag
68.It i/o read
69.It i/o write
70.It memory rd
71.It memory wr
72.It cfg rd
73.It cfg wr
74.El
75.It Em PCI target exceptions
76.Pp
77The host controller may be the target of a failed transaction of type
78.Em %s
79at bus address
80.Em %x .
81Failures may occur for the following reasons:
82.Bl -diag
83.It elanpex0: %s %x target delayed txn timeout
84.It elanpex0: %s %x target address parity
85.It elanpex0: %s %x target data parity
86.El
87.Pp
88Transaction types are alike to failed master exceptions.
89.El
90.Sh SEE ALSO
91.Xr dmesg 8 ,
92.Xr elanpar 4 ,
93.Xr elansc 4 ,
94.Xr syslogd 8 .
95.Sh HISTORY
96The
97.Nm
98device first appeared in
99.Nx 5.0 .
100.Sh AUTHORS
101The
102.Nm
103driver was written by
104.An David Young Aq dyoung@NetBSD.org .
105