aboutsummaryrefslogtreecommitdiff
path: root/sbin/camcontrol/camcontrol.8
diff options
context:
space:
mode:
authorPhilippe Charnier <charnier@FreeBSD.org>2002-07-06 19:34:18 +0000
committerPhilippe Charnier <charnier@FreeBSD.org>2002-07-06 19:34:18 +0000
commite1205e80e5c937ac999f02f51edfb25d5b7a7ad6 (patch)
tree219860332a065e5cb6defc25dab58e4a8c7997cd /sbin/camcontrol/camcontrol.8
parent3f162cb85dafb6f4c8537b3e606c2ccdaa12a424 (diff)
downloadsrc-e1205e80e5c937ac999f02f51edfb25d5b7a7ad6.tar.gz
src-e1205e80e5c937ac999f02f51edfb25d5b7a7ad6.zip
The .Nm utility
Notes
Notes: svn path=/head/; revision=99501
Diffstat (limited to 'sbin/camcontrol/camcontrol.8')
-rw-r--r--sbin/camcontrol/camcontrol.823
1 files changed, 17 insertions, 6 deletions
diff --git a/sbin/camcontrol/camcontrol.8 b/sbin/camcontrol/camcontrol.8
index 060c1b7ce466..5d1c9b10827f 100644
--- a/sbin/camcontrol/camcontrol.8
+++ b/sbin/camcontrol/camcontrol.8
@@ -137,18 +137,22 @@
.Nm
.Ic help
.Sh DESCRIPTION
+The
.Nm
-is a utility designed to provide a way for users to access and control the
+utility is designed to provide a way for users to access and control the
.Fx
CAM subsystem.
.Pp
+The
.Nm
+utility
can cause a loss of data and/or system crashes if used improperly. Even
expert users are encouraged to exercise caution when using this command.
Novice users should stay away from this utility.
.Pp
+The
.Nm
-has a number of primary functions, many of which support an optional
+utility has a number of primary functions, many of which support an optional
device identifier. A device identifier can take one of three forms:
.Bl -tag -width 14n
.It deviceUNIT
@@ -222,8 +226,9 @@ List all peripheral drivers attached to a given physical device (logical
unit).
.It Ic tur
Send the SCSI test unit ready (0x00) command to the given device.
+The
.Nm
-will report whether the device is ready or not.
+utility will report whether the device is ready or not.
.It Ic inquiry
Send a SCSI inquiry command (0x12) to a device. By default,
.Nm
@@ -283,7 +288,9 @@ required. Most drives support the physical sector format. Some drives
support the logical block format. Many drives, if they don't support the
requested format, return the data in an alternate format, along with sense
information indicating that the requested data format isn't supported.
+The
.Nm
+utility
attempts to detect this, and print out whatever format the drive returns.
If the drive uses a non-standard sense code to report that it doesn't
support the requested format,
@@ -480,7 +487,9 @@ Show or negotiate various communication parameters. Some controllers may
not support setting or changing some of these values. For instance, the
Adaptec 174x controllers do not support changing a device's sync rate or
offset.
+The
.Nm
+utility
will not attempt to set the parameter if the controller indicates that it
does not support setting the parameter. To find out what the controller
supports, use the
@@ -632,8 +641,9 @@ fails.
.Dl camcontrol tur da0
.Pp
Send the SCSI test unit ready command to da0.
+The
.Nm
-will report whether the disk is ready, but will not display sense
+utility will report whether the disk is ready, but will not display sense
information if the command fails since the
.Fl v
switch was not specified.
@@ -648,8 +658,9 @@ printing (with the
.Fl v
flag) if the command fails. Since error recovery is turned on, the
disk will be spun up if it is not currently spinning.
+The
.Nm
-will report whether the disk is ready.
+utility will report whether the disk is ready.
.Bd -literal -offset indent
camcontrol cmd -n cd -u 1 -v -c "3C 00 00 00 00 00 00 00 0e 00" \e
-i 0xe "s1 i3 i1 i1 i1 i1 i1 i1 i1 i1 i1 i1"
@@ -716,7 +727,7 @@ Test Unit Ready command to make the settings take effect.
.Sh HISTORY
The
.Nm
-command first appeared in
+utility first appeared in
.Fx 3.0 .
.Pp
The mode page editing code and arbitrary SCSI command code are based upon