d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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

Browse Source 
Submitted by:	msmith
This commit is contained in:
Jeroen Ruigrok van der Werven 2000-10-29 13:31:24 +00:00
parent e68aef6429
commit eae4fc8ef3
1 changed files with 89 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

104
share/man/man4/twe.4
View File

@ -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,