NVME-FEAT-LBA-RAN(1)

NAME
nvme-feat-lba-range-type - Get and set lba range type feature

SYNOPSIS

nvme [<global-options>] feat lba-range-type <device>
                        [--nsid=<nsid> | -n <nsid>] [--num=<num> | -N <num>]
                        [--types=<type-list,> | -t <type-list,>]
                        [--lbaros=<lbaro-list,> | -l <lbaro-list,>]
                        [--hlbars=<hlbar-list,> | -h <hlbar-list,>]
                        [--slbas=<slba-list,> | -s <slba-list,>]
                        [--nlbs=<nlb-list,> | -b <nlb-list,>]
                        [--guids=<guid-list,> | -g <guid-list,>]
                        [--sel=<select> | -S <select>] [--save | -s]

DESCRIPTION

Get and set lba range type feature.

The <device> parameter is mandatory and may be either the NVMe character device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1). If the character device is given, the '--nsid' option is mandatory, otherwise it will use the ns-id of the namespace for the block device you opened. For block devices, the ns-id used can be overridden with the same option.

On success it returns 0, error code otherwise.

OPTIONS

-n <nsid>, --nsid=<nsid>
    Sends the command with the requested nsid. This is required for the character devices, or overrides the block nsid if given.

-N <num>, --num=<num>
    zeroes based LBA ranges number.

-t <type-list,>, --types=<type-list,>
    LBA range type list.

-l <type-list,>, --lbaros=<lbaro-list,>
    LBA range overwriteable list.

-h <hlbar-list,>, --hlbars=<hlbar-list,>
    hide LBA range list.

-s <slba-list,>, --slbas=<slba-list,>
    starting LBA list.

-b <nlb-list,>, --nlbs=<nlb-list,>
    zeroes based logical blocks number list.

-g <guid-list,>, --guids=<guid-list,>
    unique identifier list. Only supported with __int128 available.

-S <select>, --sel=<select>
    Select (SEL): This field specifies which value of the attributes to return in the provided data:

-s, --save
    Save the attribute so that it persists through all power states and resets.

GLOBAL OPTIONS

The following options are defined at the top-level nvme command and are available to this subcommand:

--dry-run
    Print the command that would be executed, but do not actually execute it.

--no-ioctl-probing
    Disable probing for 64-bit IOCTL support.

--no-retries
    Disable retry logic on transient errors.

-o <fmt>, --output-format=<fmt>
    Set the reporting format to normal, tabular, 'json, or binary. Only one output format may be used at a time.

--output-format-version=<version>
    Select the output format version. Version 1 uses the original field naming, while version 2 (default) provides more consistent and script-friendly field names.

--timeout=<ms>
    Set the timeout for the command in milliseconds.

-v, --verbose
    Increase the level of detail in the output. May be specified multiple times to further increase verbosity.

These options can also be set as machine-wide defaults in nvme-cli.conf(5). A command-line flag always overrides the file.

EXAMPLES

    • Has the program issue a feat lba-range-type to get

        # nvme feat lba-range-type /dev/nvme0 -n 1

    • Has the program issue a ocp feat lba-range-type with LBA ranges to set

        # nvme feat lba-range-type /dev/nvme0n1 --num=1 -t 0,1 -l 0,1 -h 1,0 -b 7,7 -s 0,4096 -g 1234,5678

NVME

Part of the nvme-user suite.