OS Manuals

/usr/bin/sg_ses_microcode

SCSI utilities for Linux, Unix and Windows

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

Usage: sg_ses_microcode [--bpw=CS] [--dry-run] [--ealsd] [--help] [--id=ID]
                        [--in=FILE] [--length=LEN] [--mode=MO] [--non]
                        [--offset=OFF] [--skip=SKIP] [--subenc=SEID]
                        [--tlength=TLEN] [--verbose] [--version]
                        DEVICE
  where:
    --bpw=CS|-b CS         CS is chunk size: bytes per send diagnostic
                           command (def: 0 -> as many as possible)
                           can append ',act' to do activate after last
    --dry-run|-d           skip SCSI commands, do everything else
    --ealsd|-e             exit after last Send Diagnostic command
    --help|-h              print out usage message then exit
    --id=ID|-i ID          buffer identifier (0 (default) to 255)
    --in=FILE|-I FILE      read from FILE ('-I -' read from stdin)
    --length=LEN|-l LEN    length in bytes to send (def: deduced from
                           FILE taking SKIP into account)
    --mode=MO|-m MO        download microcode mode, MO is number or
                           acronym (def: 0 -> 'dmc_status')
    --non|-N               non-standard: bypass all receive diagnostic
                           results commands except after check condition
    --offset=OFF|-o OFF    buffer offset (unit: bytes, def: 0);
                           ignored if --bpw=CS given
    --skip=SKIP|-s SKIP    bytes in file FILE to skip before reading
    --subenc=SEID|-S SEID     subenclosure identifier (def: 0 (primary))
    --tlength=TLEN|-t TLEN    total length of firmware in bytes
                              (def: 0). Only needed if TLEN>LEN
    --verbose|-v           increase verbosity
    --version|-V           print version string and exit

Does one or more SCSI SEND DIAGNOSTIC followed by RECEIVE DIAGNOSTIC
RESULTS command sequences in order to download microcode. Use '-m xxx'
to list available modes. With only DEVICE given, the Download Microcode
Status dpage is output.
Options (15)
OptionDescriptionSource
--bpw, -b CS|-bCS is chunk size: bytes per send diagnostic command (def: 0 -> as many as possible) can append ',act' to do activate after lasthelp + man
--id, -i ID|-ithis option sets the BUFFER ID field in the Download microcode control dpage.help + man
--in, -I FILE|-Iread data from file FILE that will be sent with the SEND DIAGNOSTIC command.help + man
--length, -l LEN|-llength in bytes to send (def: deduced from FILE taking SKIP into account)help + man
--mode, -m MO|-mdownload microcode mode, MO is number or acronym (def: 0 -> 'dmc_status')help + man
--offset, -o OFF|-othis option sets the BUFFER OFFSET field in the Download microcode control dpage.help + man
--skip, -s SKIP|-sthis option is only active when --in=FILE is given and FILE is a regular file, rather than stdin.help + man
--subenc, -S SEID|-Ssubenclosure identifier (def: 0 (primary))help + man
--tlength, -t TLEN|-tTLEN is the total length in bytes of the microcode to be (or being) downloaded.help + man
-d, --dry-runthe actual calls to perform SEND DIAGNOSTIC and RECEIVE DIAGNOSTIC RESULTS commands are skipped when this option is given. (in the manual page but not in --help)man
-e, --ealsdexit after last SEND DIAGNOSTIC 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
-N, --nonallow for non-standard implementations that reset their Download microcode engine after a RECEIVE DIAGNOSTIC RESULTS command with the Download microcode status dpage is sent. (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.