/usr/bin/sg_persist --help — Chainguard OS Manuals

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

Usage: sg_persist [OPTIONS] [DEVICE]
  where the main OPTIONS are:
    --clear|-C                 PR Out: Clear
    --help|-h                  print usage message, twice for more
    --in|-i                    request PR In command (default)
    --out|-o                   request PR Out command
    --param-rk=RK|-K RK        PR Out parameter reservation key
                               (RK is in hex)
    --param-sark=SARK|-S SARK    PR Out parameter service action
                                 reservation key (SARK is in hex)
    --preempt|-P               PR Out: Preempt
    --preempt-abort|-A         PR Out: Preempt and Abort
    --prout-type=TYPE|-T TYPE    PR Out type field (see '-hh')
    --read-full-status|-s      PR In: Read Full Status
    --read-keys|-k             PR In: Read Keys (default)
    --read-reservation|-r      PR In: Read Reservation
    --read-status|-s           PR In: Read Full Status
    --register|-G              PR Out: Register
    --register-ignore|-I       PR Out: Register and Ignore
    --register-move|-M         PR Out: Register and Move
                               for '--register-move'
    --release|-L               PR Out: Release
    --replace-lost|-x          PR Out: Replace Lost Reservation
    --report-capabilities|-c   PR In: Report Capabilities
    --reserve|-R               PR Out: Reserve
    --unreg|-U                 optional with PR Out Register and Move

Performs a SCSI PERSISTENT RESERVE (IN or OUT) command. Invoking
'sg_persist DEVICE' will do a PR In Read Keys command. Use '-hh'
for more options and TYPE meanings.

Options (33)

Option	Description	Source
`--param-rk, -K` RK\|-K	specify the reservation key found in the parameter block of the PROUT command.	help + man
`--param-sark, -S` SARK\|-S	specify the service action reservation key found in the parameter block of the PROUT command.	help + man
`--prout-type, -T` TYPE\|-T	specify the PROUT command's 'type' argument.	help + man
`-l, --alloc-length` LEN	specify the allocation length of the PRIN command. (in the manual page but not in --help)	man
`-C, --clear`	Clear is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-d, --device` DEVICE	DEVICE to send SCSI commands to. (in the manual page but not in --help)	man
`-h, --help`	output a usage message showing main options. (in the manual page but not in --help)	man
`-H, --hex`	the response to a valid PRIN sub-command will be output in hexadecimal. (in the manual page but not in --help)	man
`-i, --in`	specify that a SCSI PERSISTENT RESERVE IN command is required. (in the manual page but not in --help)	man
`-m, --maxlen` LEN	LEN is used as the ALLOCATION LENGTH field of the PRIN command. (in the manual page but not in --help)	man
`-n, --no-inquiry`	the default action is to do a standard SCSI INQUIRY command and output make, product and revision strings plus the peripheral device type prior to executing a PRIN or PROUT command. (in the manual page but not in --help)	man
`-o, --out`	specify that a SCSI PERSISTENT RESERVE OUT command is required. (in the manual page but not in --help)	man
`-Y, --param-alltgpt`	set the 'all target ports' (ALL_TG_PT) flag in the parameter block of the PROUT command. (in the manual page but not in --help)	man
`-Z, --param-aptpl`	set the 'activate persist through power loss' (APTPL) flag in the parameter block of the PROUT command. (in the manual page but not in --help)	man
`-P, --preempt`	Preempt is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-A, --preempt-abort`	Preempt and Abort is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-s, --read-full-status`	Read Full Status is a sub-command of the PRIN command. (in the manual page but not in --help)	man
`-k, --read-keys`	Read Keys is a sub-command of the PRIN command. (in the manual page but not in --help)	man
`-y, --readonly`	Open DEVICE read-only. (in the manual page but not in --help)	man
`-r, --read-reservation`	Read Reservation is a sub-command of the PRIN command. (in the manual page but not in --help)	man
`-G, --register`	Register is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-I, --register-ignore`	Register and Ignore Existing Key is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-M, --register-move`	register (another initiator) and move (the reservation held by the current initiator to that other initiator) is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-Q, --relative-target-port` RTPI	relative target port identifier that reservation is to be moved to by PROUT 'register and move' sub-command. (in the manual page but not in --help)	man
`-L, --release`	Release is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-z, --replace-lost`	Replace Lost Reservation is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-c, --report-capabilities`	Report Capabilities is a sub-command of the PRIN command. (in the manual page but not in --help)	man
`-R, --reserve`	Reserve is a sub-command of the PROUT command. (in the manual page but not in --help)	man
`-X, --transport-id` TIDS	The TIDS argument can take one of several forms. (in the manual page but not in --help)	man
`-U, --unreg`	optional when the PROUT register and move sub-command is invoked. (in the manual page but not in --help)	man
`-v, --verbose`	print out cdb of issued commands prior to execution. (in the manual page but not in --help)	man
`-V, --version`	print out version string. (in the manual page but not in --help)	man
`-?`	output usage message. (in the manual page but not in --help)	man

Exit status (1) from the manual page

`0`	it 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.