OS Manuals

/usr/bin/sg_sat_read_gplog

SCSI utilities for Linux, Unix and Windows

From sg3-utils 1.49-r3 (enterprise-packages), captured 2026-11-08 by running sg_sat_read_gplog --help (exit 0). permalink

Usage: sg_sat_read_gplog [--address=LA_L] [--ck_cond] [--count=CO] [--dma]
                         [--help] [--hex] [--len=CDB_LEN] [--log=LA_L]
                         [--ppt=PPT] [--readonly] [--smart] [--verbose]
                         [--version] DEVICE
  where:
    --address=LA_L | -a LA_L    same as --log=LA_L option below
    --ck_cond | -C          set ck_cond field in pass-through (def: 0)
    --count=CO | -c CO      count of page numbers to fetch (def: 1)
    --dma | -d              Use READ LOG DMA EXT (def: READ LOG EXT)
    --help | -h             output this usage message
    --hex | -H              output response in hex bytes, -HH yields hex
                            words + ASCII (def), -HHH hex words only
    --len=CDB_LEN | -l CDB_LEN    cdb length: 12, 16 or 32 bytes (def: 16)
    --log=LA_L | -L LA_L    Log address, log address range or list of ...
                            See below for syntax
    --page=PN|-p PN         Log page number within address (def: 0)
    --ppt=PPT|-P PPT        pages per transfer (def: 64)
    --readonly | -r         open DEVICE read-only (def: read-write)
    --smart | -s            send the ATA SMART READ LOG command instead
    --verbose | -v          increase verbosity
                            recommended if DEVICE is ATA disk
    --version | -V          print version string and exit

Sends an ATA READ LOG (DMA) EXT or a SMART READ LOG command via a SAT
pass-through to fetch one or more General Purpose (GP) or SMART log pages.
Each page is accessed via a log address (LA) and then a page number
within that address. Multiple log addresses can be given in the LA_L
argument to the --address= and --log= options. It may contain a comma
separated list with each element either being a single LA or a range with
this format: 'lo:hi'. LA_R syntax summary: lo:hi,lo2:hi2,lo3:hi3,...
Options (14)
OptionDescriptionSource
--address, -a LA_Lwhere LA_L is as single "log address", a range of log addresses, or a list of (ranges of) log addresses.help + man
--ck_cond, -Csets the CK_COND bit in the ATA PASS-THROUGH SCSI cdb.help + man
--count, -c COthe number CO is placed in the "count" field in the ATA READ LOG EXT command.help + man
--dma, -duse the ATA READ LOG DMA EXT command instead of ATA READ LOG EXT command.help + man
--help, -houtputs the usage message summarizing command line options then exits.help + man
--hex, -Houtput response in hex bytes, -HH yields hex words + ASCII (def), -HHH hex words onlyhelp + man
--len, -l CDB_LENwhere CMD_LEN is the command (cdb) length of the SCSI ATA PASS-THROUGH command that is used to tunnel ATA commands.help + man
--log, -L LA_LLog address, log address range or list of ...help + man
--page, -p PN|-pthe number PN is the page number (within the log address) and is placed in bits 32:16 of the "lba" field of the ATA READ LOG (DMA) EXT command.help + man
--ppt, -P PPT|-Pwhere PPT is the number of pages to transfer from the DEVICE per ATA READ LOG EXT or an ATA READ LOG DMA EX command invocation.help + man
--readonly, -rcauses the DEVICE to be opened with the read-only flag (O_RDONLY in Unix).help + man
--smart, -sin the ATA SMART feature set, "SMART" log pages have been present for a long time and pre-date the later addition of the "general purpose" log pages.help + man
--verbose, -vincrease verbosity recommended if DEVICE is ATA diskhelp + man
--version, -Vprint version string and exithelp + man
Exit status (1) from the manual page
0it is successful

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.