1.\" $NetBSD: elanpar.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 elanpar 4 i386 36.Os 37.Sh NAME 38.Nm elanpar 39.Nd AMD Elan SC520 Programmable Address Regions 40.Sh SYNOPSIS 41.Cd "elansc* at mainbus? bus ?" 42.Cd "elanpar* at elansc?" 43.Sh DESCRIPTION 44The 45.Nm 46driver supports the write-protect feature of the AMD 47Elan SC520 microcontroller's integrated Programmable Address Regions. 48Currently, 49.Nm 50protects the kernel text from being overwritten by the CPU or errant DMA. 51.Sh DIAGNOSTICS 52.Bl -diag 53.It elanpar0: cpu violated write-protect window %u 54.It elanpar0: gp violated write-protect window %u 55.It elanpar0: pci violated write-protect window %u 56.El 57.Pp 58A Programmable Address Region stopped 59either the CPU, the general-purpose bus 60.Pq gp , 61or a PCI bus master from writing to the indicated window of 62write-protected memory. 63.Bl -diag 64.It elanpar0: %u bytes of kernel text are unprotected 65.El 66.Pp 67.Nm 68has not write-protected 69.Em %u 70bytes of the kernel text. 71.Sh SEE ALSO 72.Xr dmesg 8 , 73.Xr elanpex 4 , 74.Xr elansc 4 , 75.Xr syslogd 8 . 76.Sh BUGS 77.Pp 78.Nm 79leaves as many as 65535 bytes unprotected at the beginning and 80end of kernel text. 81Also, 82.Nm 83is not compatible with setting breakpoints 84using 85.Xr ddb 4 . 86Disable 87.Nm 88using 89.Ic drvctl Fl d Ar elanpar0 90before setting a breakpoint with 91.Xr ddb 4 . 92.Sh HISTORY 93The 94.Nm 95device first appeared in 96.Nx 5.0 . 97.Sh AUTHORS 98The 99.Nm 100driver was written by 101.An David Young Aq dyoung@NetBSD.org . 102