OS Manuals

/usr/bin/sg_xcopy

SCSI utilities for Linux, Unix and Windows

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

Usage: sg_xcopy [app=0|1] [bpt=BPT] [bs=BS] [cat=0|1] [conv=CONV]
                [count=COUNT] [dc=0|1] [ibs=BS]
                [id_usage=hold|discard|disable] [if=IFILE] [iflag=FLAGS]
                [list_id=ID] [obs=BS] [of=OFILE] [oflag=FLAGS] [prio=PRIO]
                [seek=SEEK] [skip=SKIP] [time=0|1] [verbose=VERB]
                [--help] [--on_dst|--on_src] [--verbose] [--version]

  where:
    app         if argument is 1 then open OFILE in append mode
    bpt         is blocks_per_transfer (default: 128)
    bs          block size (default is 512)
    cat         xcopy segment descriptor CAT bit (default: 0)
    conv        ignored
    count       number of blocks to copy (def: device size)
    dc          xcopy segment descriptor DC bit (default: 0)
    fco         xcopy segment descriptor FCO bit (default: 0)
    ibs         input block size (if given must be same as 'bs=')
    id_usage    sets list_id_usage field to hold (0), discard (2) or
                disable (3)
    if          file or device to read from (def: stdin)
    iflag       comma separated list of flags applying to IFILE
    list_id     sets list_id field to ID (default: 1 or 0)
    obs         output block size (if given must be same as 'bs=')
    of          file or device to write to (def: stdout), OFILE of '.'
                treated as /dev/null
    oflag       comma separated list of flags applying to OFILE
    prio        set xcopy priority field to PRIO (def: 1)
    seek        block position to start writing to OFILE
    skip        block position to start reading from IFILE
    time        0->no timing(def), 1->time plus calculate throughput
    verbose     0->quiet(def), 1->some noise, 2->more noise, etc
    --help|-h   print out this usage message then exit
    --on_dst    send XCOPY command to OFILE
    --on_src    send XCOPY command to IFILE
    --verbose|-v   same action as verbose=1
    --version|-V   print version information then exit

Copy from IFILE to OFILE, similar to dd command; but using the SCSI
EXTENDED COPY (XCOPY(LID1)) command. For list of flags, use '-hh'.
Options (5)
OptionDescriptionSource
--on_dstsend the XCOPY command to the output file/device (i.e. OFILE).help + man
--on_srcsend the XCOPY command to the input file/device (i.e. IFILE).help + man
-h, --helpoutputs usage message and exits. (in the manual page but not in --help)man
-v, --verboseequivalent to verbose=1. (in the manual page but not in --help)man
-V, --versionoutputs version number information and exits. (in the manual page but not in --help)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.