Autor Tema: SdparmV1.03 für Coolstream HD1 (Leído 1682 veces)

Perfil · Registrado: 17/01/2008 Gracias: 144/3190 Mensajes 20498

SdparmV1.03 für Coolstream HD1

NAME
sdparm - access SCSI modes pages; read VPD pages; send simple SCSI commands.

SYNOPSIS
sdparm [--all] [--clear=STR] [--command=CMD] [--dbd] [--defaults] [--dummy] [--flexible] [--get=STR] [--help] [--hex] [--inquiry] [--long] [--num-desc]
[--page=PG[,SPG]] [--quiet] [--save] [--set=STR] [--six] [--transport=TN] [--vendor=VN] [--verbose] [--version] DEVICE

sdparm --enumerate [--all] [--inquiry] [--long] [--page=PG[,SPG]] [--transport=TN] [--vendor=VN]

sdparm --wscan [--verbose]

DESCRIPTION
This utility fetches and potentially changes SCSI device (e.g. disk) mode pages. Inquiry data including Vital Product Data (VPD) pages can also be displayed. Com‐
mands associated with starting and stopping the medium; loading and unloading the medium; and other housekeeping function may also be issued by this utility.

Of the three invocations shown in the synopsis, the first is the most general. The second variant that uses --enumerate is for dumping information held in sdparm’s
internal tables. The last variant is for Windows only and lists the available device names; see the OPTIONS entry for --wscan.

If no options (other than DEVICE) are given then a selection of common mode page fields for that device are listed. If the --long option is also given then a
description of the fields is placed on the right of each line. If the --all option is given then all known mode page fields for that device are listed. Individual
fields can be displayed with the --get=STR option (e.g. ’--get=WCE’ to fetch the state of the Writeback Cache Enable field).

By default this utility shows mode pages that are common to all transport protocols. These are termed as "generic" mode pages. If there is no match on a generic
mode page name or field then those pages specific to the SAS transport are checked. Transport protocol specific mode pages are selected with the --transport=TN
option. See the TRANSPORT section below. Vendor specific mode pages are selected with the --vendor=VN option. See the VENDORS section below.

Although originally for SCSI disks (or storage devices that appear to the OS as SCSI disks) many of the mode pages are for other SCSI device types. These include
CD/DVD players that use the ATAPI (or any other) transport, SCSI tapes drives and SCSI enclosures.

When the --inquiry option is given without a page number then the Device Identification VPD page (page number 0x83) is requested and if found it is decoded and out‐
put. If no page number is given and the --all option is given then a list of VPD page names (but not their contents) supported by the DEVICE is output. When both the
--inquiry and --page=PG options are given then the VPD page can be specified as an abbreviation (e.g. "sp" for the SCSI ports VPD page) or numerically (e.g. "0x88").
If a VPD page is returned by the DEVICE but sdparm cannot decode it or the --hex option is given then it is output in hex.

This utility completes with an exit status of 0 when successful. For other values see the EXIT STATUS section below.

OPTIONS
Mandatory arguments to long options are mandatory for short options as well. If an option takes a numeric argument then that argument is assumed to be decimal
unless otherwise indicated (e.g. with a leading "0x" or a trailing "h"). The options are in alphabetical order, based on the long option name.

-a, --all
output all recognized fields for the device type (e.g. disk) of the DEVICE. Without this option (or the --page=PG[,SPG] option) the default action is to out‐
put a relatively small number of commonly used fields from different pages. When a specific (mode) page number is given with the --page=PG[,SPG] option then
all the fields of that page are output (irrespective of the setting of this option). For this option’s action when used with the --enumerate option see the
ENUMERATE section below.

-c, --clear=STR
In its simplest form STR contains a field acronym_name or a field numerical descriptor. In the absence of an explicit value argument (e.g. ’--clear=WCE=1’),
the field has its value cleared to zero. See the PARAMETERS section below.

-C, --command=CMD
Perform given CMD. See section below on COMMANDS. To enumerate supported commands use ’-e -C x’ (using any CMD name, valid or otherwise).

-B, --dbd
disable block descriptors. This is a bit in MODE SENSE cdbs that rarely needs to be set. One known case is a MODE SENSE 6 issued to a Reduced Block Commands
(RBC) device where the RBC standard says it shall be set.

-D, --defaults
sets the given mode page to its default values. Requires the --page=PG[,SPG] option to be given to specify the mode page. To make the default mode page values
also the saved mode page values, use the --save option as well.

-d, --dummy
when set inhibits changes being placed in the DEVICE’s mode page. Instead the mode data that would have been sent to a MODE SELECT command, is output in
ASCII hex to the console. This option is mainly for testing.

-e, --enumerate
lists out descriptive information about the pages and fields known to this utility. Ignores the DEVICE argument and other options apart from the --all,
--inquiry, --long, --page=PG[,SPG], --transport=TN and --vendor=VN. If --enumerate is given without other options then the known (generic) mode pages are
listed. See the ENUMERATE section below.

-f, --flexible
Some devices, bridges and/or drivers attempt crude transformations between mode sense 6 and 10 byte commands without correctly rebuilding the response. This
will cause the response to be mis-interpreted (usually with an error saying the response is malformed). With this option, the length of the response is
checked, and if it looks wrong, various corrections are attempted. This option will also allow mode pages that don’t belong to the current device’s peripheral
type to be listed.

-g, --get=STR
In its simplest form STR contains a field acronym_name or a field numerical descriptor. The field is fetched from mode page. See the PARAMETERS section below.
The --long and --hex options effect the output format. Also if a value of "1" is given (e.g. ’--get=WCE=1’) only the current value is output (i.e. not the
change mask, the default value and the saved value).

-h, --help
output the usage message then exit.

-H, --hex
rather than trying to decode mode (or VPD) pages, print them out in hex. When used with the --get=STR option the corresponding current, changeable, default
and saved values are output in hex, prefixed by "0x" and space separated. If a value of "1" is given with the --get=STR option (e.g. ’--get=WCE=1’) then only
the current value is output in hex, prefixed by "0x". If a value of "2" is given with the --get=STR option then only the current value is output as a (signed)
integer. This option can be used multiple times (e.g. ’-HH’). Useful with the ATA Information VPD page which usually outputs its IDENTIFY (PACKET) DEVICE
response in 16 bit hex words; with ’-HH’ outputs that response in hex bytes; with ’-HHH’ outputs the same response in a format suitable for ’hdparm --Istdin’
to decode.

-i, --inquiry
output INQUIRY VPD pages. In the absence of this option the default action is to output mode pages. If the --inquiry option is given without the
--page=PG[,SPG] option then the device identification VPD page (0x83) is decoded and output. If this option and the --all option are given then the supported
VPD pages page (0x0) is decoded and output.