OS Manuals

/usr/bin/sg_seek

SCSI utilities for Linux, Unix and Windows

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

Usage: sg_seek  [--10] [--count=NC] [--grpnum=GN] [--help] [--immed]
                [--lba=LBA] [--num-blocks=NUM] [--pre-fetch] [--readonly]
                [--skip=SB] [--time] [--verbose] [--version]
                [--wrap-offset=WO] DEVICE
  where:
    --10|-T             do PRE-FETCH(10) command (def: SEEK(10), or
                        PRE-FETCH(16) if --pre-fetch also given)
    --count=NC|-c NC    NC is number of commands to execute (def: 1)
    --grpnum=GN|-g GN    GN is group number to place in PRE-FETCH
                         cdb; 0 to 63 (def: 0)
    --help|-h           print out usage message
    --immed|-i          set IMMED bit in PRE-FETCH command
    --lba=LBA|-l LBA    starting Logical Block Address (LBA) (def: 0)
    --num-blocks=NUM|-n NUM    number of blocks to cache (for PRE-FETCH)
                               (def: 1). Ignored by SEEK(10)
    --pre-fetch|-p     do PRE-FETCH command, 16 byte variant if --10 not
                       given (def: do SEEK(10))
    --readonly|-r      open DEVICE read-only (if supported)
    --skip=SB|-s SB    when NC>1 skip SB blocks to next LBA (def: 1)
    --time|-t          time the command(s) and if NC>1 show usecs/command
                       (def: don't time)
    --verbose|-v       increase verbosity
    --version|-V       print version string and exit
    --wrap-offset=WO|-w WO    if SB>0 and WO>0 then if LBAn>LBA+WO
                       then reset LBAn back to LBA (def: 0)

Performs SCSI SEEK(10), PRE-FETCH(10) or PRE-FETCH(16) command(s).If no
options are given does one SEEK(10) command with an LBA of 0 . If NC>1
then a tally is kept of successes, 'condition-met's and errors that is
printed on completion. 'condition-met' is from PRE-FETCH when NUM blocks
fit in the DEVICE's cache.
Options (14)
OptionDescriptionSource
--count, -c NC|-cNC is the number of commands (one of SEEK(10), PRE-FETCH(10) or PRE-FETCH(16)) that will be executed.help + man
--grpnum, -g GN|-gGN is the group number, a value between 0 and 63 (in hex: 0x3f).help + man
--lba, -l LBA|-lLBA is the starting logical block address that is placed in the command descriptor block (cdb) of the selected command.help + man
--num-blocks, -n NUM|-nNUM is the number of blocks, starting at and including LBA, to place in the DEVICE's cache.help + man
--skip, -s SB|-sSB is the number of logical block addresses to skip, between repeated commands when NC is greater than 1.help + man
--wrap-offset, -w WO|-wWO is the number of blocks, relative to LBA, that when exceeded, set the next command's logical block address back to LBA.help + man
-T, --10use a 10 byte cdb command, either SEEK(10) or PRE-FETCH(10) command. (in the manual page but not in --help)man
-h, --helpoutput the usage message then exit. (in the manual page but not in --help)man
-i, --immedthis option only applies to PRE-FETCH(10) and PRE-FETCH(16), setting the IMMED bit. (in the manual page but not in --help)man
-p, --pre-fetchthis option selects either PRE-FETCH(10) or PRE-FETCH(16) commands. (in the manual page but not in --help)man
-r, --readonlythis option sets a 'read-only' flag when the underlying operating system opens the given DEVICE. (in the manual page but not in --help)man
-t, --timeif given the elapsed time to execute NC commands is recorded. (in the manual page but not in --help)man
-v, --verboseincrease the level of verbosity, (i.e. debug output). (in the manual page but not in --help)man
-V, --versionprint the version string and then exit. (in the manual page but not in --help)man

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