Update the twe manpage to correspond with the latest source changes.

Submitted by:	msmith

1 files changed, 89 insertions, 15 deletions

diff --git a/share/man/man4/twe.4 b/share/man/man4/twe.4
index ae2bfce..64af5d3 100644
--- a/share/man/man4/twe.4
+++ b/share/man/man4/twe.4
@@ -79,24 +79,80 @@ and the driver will not attach to this controller.
 .Pp
 Fetching the list of attached units failed; initialisation has failed.
 .It twe%d: error fetching capacity for unit %d
+.It twe%d: error fetching state for unit %d
+.It twe%d: error fetching descriptor size for unit %d
+.It twe%d: error fetching descriptor for unit %d
 .It twe%d: device_add_child failed
 .It twe%d: bus_generic_attach returned %d
 .Pp
-Creation of the disk devices failed;
+Creation of the disk devices failed, either due to communications
+problems with the adapter or due to resource shortage;
 attachment of one or more units may have been aborted.
-.It twe%d: command failed - 0x%x
-.It twe%d: command failed - controller wedged
+.Ss Operational phase
+.Bl -diag
+.It twe%d: command completed - %s
+.El
 .Pp
-A command was reported as failed by the controller,
-or could not be delivered to the controller.
-.It twe%d: host interrupt
+A command was reported completed with a warning by the controller.
+The warning may be one of:
+.Bl -diag
+.It redundant/inconsequential request ignored
+.It failed to write zeroes to LBA 0
+.It failed to profile TwinStor zones
+.El
+.Bl -diag
+.It twe%d: command failed - %s
+.El
 .Pp
-The controller has signalled a host interrupt.
-This serves an unknown purpose and is ignored.
-.It twe%d: command interrupt
+A command was reported as failed by the controller.
+The failure message may be one of:
+.Bl -diag
+.It aborted due to system command or reconfiguration
+.It aborted
+.It access error
+.It access violation
+.It device failure
+.It controller error
+.It timed out
+.It invalid unit number
+.It unit not available
+.It undefined opcode
+.It request incompatible with unit
+.It invalid request
+.It firmware error, reset requested
 .Pp
-The controller has signalled a command interrupt.
-This is not used, and will be disabled.
+The command will be returned to the operating system after a
+fatal error.
+.El
+.Bl -diag
+.It twe%d: command failed submission - controller wedged
+.Pp
+A command could not be delivered to the controller because
+the controller is unresponsive.
+.It twe%d: AEN: <%s>
+.El
+.Pp
+The controller has reported a change in status using an AEN
+(Asynchronous Event Notification).  The following AENs may be 
+reported:
+.Bl -diag
+.It queue empty
+.It soft reset
+.It degraded mirror
+.It controller error
+.It rebuild fail
+.It rebuild done
+.It incomplete unit
+.It initialisation done
+.It unclean shutdown detected
+.It drive timeout
+.It drive error
+.It rebuild started
+.It aen queue full
+.Pp
+AENs are also queued internally for use by management tools.
+.El
+.Bl -diag
 .It twe%d: error polling for signalled AENs
 .Pp
 The controller has reported
@@ -106,16 +162,34 @@ but attempting to fetch one of these has returned an error.
 .Pp
 A status message was retrieved from the controller,
 but there is no more room to queue it in the driver.
-The message is lost.
+The message is lost (but will be printed to the console).
 .It twe%d: missing expected status bits %s
 .It twe%d: unexpected status bits %s
 .Pp
 A check of the controller's status bits
 indicates an unexpected condition.
-.Sh BUGS
-Much of the controller's status cannot currently be interpreted,
-due to lack of information from 3ware.
+.It twe%d: host interrupt
+.Pp
+The controller has signalled a host interrupt.
+This serves an unknown purpose and is ignored.
+.It twe%d: command interrupt
+.Pp
+The controller has signalled a command interrupt.
+This is not used, and will be disabled.
+.It twe%d: controller reset in progress...
 .Pp
+The controller is being reset by the driver.
+Typically this is done when the driver has determined that the
+controller is in an unrecoverable state.
+.It twe%d: can't reset controller, giving up
+.Pp
+The driver has given up on resetting the controller.
+No further I/O will be handled.
+.It controller reset done, %d commands restarted
+.Pp
+The controller was successfully reset, 
+and outstanding commands were restarted.
+.Sh BUGS
 The controller cannot handle I/O transfers
 that are not aligned to a 512-byte boundary.
 In order to support raw device access from user-space,