diff options
author | Bart Van Assche <bvanassche@google.com> | 2022-11-23 19:28:34 +0000 |
---|---|---|
committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | 2022-11-23 19:28:34 +0000 |
commit | 3c61bd9e26bf930f865e28e7eef48856653d1c98 (patch) | |
tree | 207cdb23f8257e270a30143fde23d2033901581f /README.tru64 | |
parent | 8718296061e35ba33bf88847e7498f3d7e38f8f1 (diff) | |
parent | d39ef9054452737cc87f7b0427873174814e02da (diff) | |
download | sg3_utils-3c61bd9e26bf930f865e28e7eef48856653d1c98.tar.gz |
Merge remote-tracking branch 'aosp/upstream-main' into HEAD am: 448b67b18a am: d39ef90544
Original change: https://android-review.googlesource.com/c/platform/external/sg3_utils/+/2312210
Change-Id: I9250fb56011665ad3b048ba8a96607e09670ad17
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
Diffstat (limited to 'README.tru64')
-rw-r--r-- | README.tru64 | 97 |
1 files changed, 97 insertions, 0 deletions
diff --git a/README.tru64 b/README.tru64 new file mode 100644 index 00000000..13c57e47 --- /dev/null +++ b/README.tru64 @@ -0,0 +1,97 @@ +Introduction +============ +The Tru64 port of sg3_utils contains those utilities that are _not_ +specific to Linux. In some cases a utility could be ported but +requires more work. An example is sg_dd which needs more work +beyond the SCSI command pass through mechanism. + +Supported Utilities +=================== +Here is a list of utilities that have been ported: + sg_compare_and_write + sg_decode_sense + sg_format + sg_get_config + sg_get_lba_status + sg_ident + sg_inq [dropped ATA IDENTIFY DEVICE capability] + sg_logs + sg_luns + sg_modes + sg_opcodes + sg_persist + sg_prevent + sg_raw + sg_rdac + sg_read_block_limits + sg_read_buffer + sg_read_long + sg_readcap + sg_reassign + sg_referrals + sg_requests + sg_rmsn + sg_rtpg + sg_safte + sg_sanitize + sg_sat_identify + sg_sat_phy_event + sg_sat_set_features + sg_senddiag + sg_ses + sg_start + sg_stpg + sg_sync + sg_turs + sg_unmap + sg_verify + sg_vpd + sg_wr_mode + sg_write_buffer + sg_write_long + sg_write_same + +Most utility names are indicative of the main SCSI command +that they execute. Some utilities are slightly higher level, for +example sg_ses fetches SCSI Enclosure Services (SES) status pages and +can send control pages. Each utility has a man page (placed in +section 8). An overview of sg3_utils can be found at: +https://sg.danny.cz/sg/sg3_utils.html . +A copy of the "sg3_utils.html" file is in the "doc" subdirectory. + +This package uses autotools infrastructure with the now common +"./configure ; make ; make install" sequence needed to build and install +from the source found in the tarball. If the "./configure" sequence +fails try using the ./autogen.sh prior to that sequence. + +Some man pages have examples which use Linux device names which hopefully +will not confuse Tru64 users. + + +Details +======= +Most of the ported utilities listed above use SCSI command functions +declared in sg_cmds_*.h headers . Those SCSI command functions are +implemented in the corresponding ".c" files. The ".c" files pass SCSI +commands to the host operating system via an interface declared in sg_pt.h . +There are currently five implementations of that interface depending on +the host operating system: +system: + - sg_pt_linux.c + - sg_pt_osf1.c [Tru64] + - sg_pt_freebsd.c + - sg_pt_solaris.c + - sg_pt_win32.c + +The sg_pt_osf1.c file uses the Tru64 CAM SCSI pass through mechanism. + +Tru64 does not have general library support for "long" options +(e.g. "--verbose") which are used extensively by most of the +utilities in this package. Rather than change all the utilities +and their man/web pages a local implementation of the missing +function "getopt_long()" has been placed in the "getopt_long" +subdirectory. Currently only the Tru64 port uses it. + + +Douglas Gilbert +14th January 2013 |