OS Manuals

/usr/bin/sg_bg_ctl

SCSI utilities for Linux, Unix and Windows

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

Usage: sg_bg_ctl  [--ctl=CTL] [--help] [--time=TN] [--verbose] [--version]
                  DEVICE
  where:
    --ctl=CTL|-c CTL    CTL is background operation control value
                        default: 0 -> don't change background operations
                        1 -> start; 2 -> stop
    --help|-h          print out usage message
    --time=TN|-t TN    TN (units 100 ms) is max time to perform background
                       operations (def: 0 -> no limit)
    --verbose|-v       increase verbosity
    --version|-V       print version string and exit

Performs a SCSI BACKGROUND CONTROL command. It can start or stop
'advanced background operations'. Operations started by this command
(i.e. when ctl=1) are termed as 'host initiated' and allow a resource or
thin provisioned device (disk) to perform garbage collection type operations.
These may degrade performance while they occur. Hence it is best to
perform this action while the computer is not too busy.
Options (5)
OptionDescriptionSource
--ctl, -c CTL|-cCTL is background operation control value default: 0 -> don't change background operations 1 -> start;help + man
--time, -t TN|-tTN is a maximum time (with a unit of 100 ms or 1/10 second) that advanced background operations can occur.help + man
-h, --helpoutput the usage message then exit. (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
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.