From b1e426a681f68cd037df41e3814d40cb4e90033e Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Wed, 26 Sep 2007 21:01:16 +0000 Subject: [PATCH] Add documentation for AHC_DEBUG, AHC_DEBUG_OPTS and AHC_REG_PRETTY_PRINT. Modeled after ahd(4). --- share/man/man4/ahc.4 | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4 index b259e66502..b53854391a 100644 --- a/share/man/man4/ahc.4 +++ b/share/man/man4/ahc.4 @@ -25,9 +25,9 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/ahc.4,v 1.38.2.1 2006/06/05 19:30:28 brueffer Exp $ -.\" $DragonFly: src/share/man/man4/ahc.4,v 1.5 2007/07/07 18:31:59 swildner Exp $ +.\" $DragonFly: src/share/man/man4/ahc.4,v 1.6 2007/09/26 21:01:16 swildner Exp $ .\" -.Dd July 7, 2007 +.Dd September 26, 2007 .Dt AHC 4 .Os .Sh NAME @@ -50,6 +50,11 @@ For one or more PCI cards: To allow PCI adapters to use memory mapped I/O if enabled: .Cd options AHC_ALLOW_MEMIO .Pp +To compile in debugging code: +.Cd options AHC_DEBUG +.Cd options AHC_DEBUG_OPTS= +.Cd options AHC_REG_PRETTY_PRINT +.Pp To configure one or more controllers to assume the target role: .Cd options AHC_TMODE_ENABLE .Ed @@ -87,6 +92,35 @@ is attempted. Most modern motherboards perform the initialization correctly and work fine with this option enabled. .Pp +The +.Dv AHC_DEBUG_OPTS +option is used to control which diagnostic messages are printed to the +console when +.Dv AHC_DEBUG +is enabled. +Logically OR the following bits together: +.Bl -column -offset indent Value Function +.Em "Value Function" +0x0001 Show miscellaneous information +0x0002 Show sense data +0x0004 Show Serial EEPROM contents +0x0008 Show bus termination settings +0x0010 Show host memory usage +0x0020 Show SCSI protocol messages +.\"0x0040 XXX: AHC_SHOW_DV +0x0080 Show selection timeouts +0x0200 Show Queue Full status +0x0400 Show SCB queue status +0x0800 Show inbound packet information +.\"0x1000 XXX: AHC_SHOW_MASKED_ERRORS +0x2000 Enable extra diagnostic code in the firmware +.El +.Pp +The +.Dv AHC_REG_PRETTY_PRINT +option compiles in support for human-readable bit definitions for each register +that is printed by the debugging code. +.Pp Individual controllers may be configured to operate in the target role through the .Dq Dv AHC_TMODE_ENABLE -- 2.11.4.GIT