blkpr - Man Page
run persistent reservations command on a device
Examples (TL;DR)
- Register (command) a new reservation with a given key on a given device:
blkpr -c|--command register -k|--key reservation_key path/to/device
- Set the type of an existing reservation to exclusive access:
blkpr -c reserve -k|--key reservation_key -t|--type exclusive-access path/to/device
- Preempt the existing reservation with a given key and replace it with a new reservation:
blkpr -c preempt -K|--oldkey old_key -k|--key new_key -t|--type write-exclusive path/to/device
- Release a reservation with a given key and type on a given device:
blkpr -c release -k|--key reservation_key -t|--type reservation_type path/to/device
- Clear all reservations from a given device:
blkpr -c clear -k|--key key path/to/device
Synopsis
blkpr [options] device
Description
blkpr is used to run persistent reservations command on device that supports Persistent Reservations feature.
The device argument is the pathname of the block device.
Options
- -c, --command command
The command of persistent reservations, supported commands are register, reserve, release, preempt, preempt-abort, and clear.
- -k, --key key
The key the command should operate on.
- -K, --oldkey oldkey
The old key the command should operate on.
- -f, --flag flag
Supported flag is ignore-key.
- -t, --type type
Supported types are write-exclusive, exclusive-access, write-exclusive-reg-only, exclusive-access-reg-only, write-exclusive-all-regs, and exclusive-access-all-regs.
- -V, --version
Display version information and exit.
- -h, --help
Display help text and exit.
Authors
See Also
Linux documentation at: https://docs.kernel.org/block/pr.html iSCSI specification at: https://datatracker.ietf.org/doc/html/rfc3720 NVMe-oF specification at: https://nvmexpress.org/nvme-over-fabrics-part-two/
Reporting Bugs
For bug reports, use the issue tracker at https://github.com/util-linux/util-linux/issues.
Availability
The blkpr command is part of the util-linux package which can be downloaded from Linux Kernel Archive.