367 lines
6.5 KiB
Groff
367 lines
6.5 KiB
Groff
'\" t
|
|
.\" Title: nvme
|
|
.\" Author: [see the "Authors" section]
|
|
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
|
|
.\" Date: 12/01/2020
|
|
.\" Manual: NVMe Manual
|
|
.\" Source: NVMe
|
|
.\" Language: English
|
|
.\"
|
|
.TH "NVME" "1" "12/01/2020" "NVMe" "NVMe Manual"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
nvme \- the NVMe storage command line interface utility (nvme\-cli)
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
built\-in plugin:
|
|
.sp
|
|
.nf
|
|
\fInvme\fR <command> <device> [<args>]
|
|
.fi
|
|
.sp
|
|
extension plugins:
|
|
.sp
|
|
.nf
|
|
\fInvme\fR <plugin> <command> <device> [<args>]
|
|
.fi
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
NVM\-Express is a fast, scalable host controller interface designed to address the needs for not only PCI Express based solid state drives, but also NVMe\-oF(over fabrics)\&.
|
|
.sp
|
|
This \fInvme\fR program is a user space utility to provide standards compliant tooling for NVM\-Express drives\&. It was made specifically for Linux as it relies on the IOCTLs defined by the mainline kernel driver\&.
|
|
.SH "NVME COMMANDS"
|
|
.sp
|
|
The utility has sub\-commands for all admin and io commands defined in the specification and for displaying controller registers\&. There is also an option to submit completely arbitrary commands\&. For a list of commands available, run "nvme help"\&.
|
|
.SH "NVME CLI SUB\-COMMANDS"
|
|
.SS "Main commands"
|
|
.PP
|
|
\fBnvme-admin-passthru\fR(1)
|
|
.RS 4
|
|
Admin Passthrough Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-compare\fR(1)
|
|
.RS 4
|
|
IO Compare
|
|
.RE
|
|
.PP
|
|
\fBnvme-error-log\fR(1)
|
|
.RS 4
|
|
Retrieve error logs
|
|
.RE
|
|
.PP
|
|
\fBnvme-flush\fR(1)
|
|
.RS 4
|
|
Submit flush
|
|
.RE
|
|
.PP
|
|
\fBnvme-dms\fR(1)
|
|
.RS 4
|
|
Submit Data Set Management
|
|
.RE
|
|
.PP
|
|
\fBnvme-format\fR(1)
|
|
.RS 4
|
|
Format namespace(s)
|
|
.RE
|
|
.PP
|
|
\fBnvme-fw-activate\fR(1)
|
|
.RS 4
|
|
F/W Activate (in old version < 1\&.2)
|
|
.RE
|
|
.PP
|
|
\fBnvme-fw-commit\fR(1)
|
|
.RS 4
|
|
F/W Commit (in > 1\&.2)
|
|
.RE
|
|
.PP
|
|
\fBnvme-fw-download\fR(1)
|
|
.RS 4
|
|
F/W Download
|
|
.RE
|
|
.PP
|
|
\fBnvme-fw-log\fR(1)
|
|
.RS 4
|
|
Retrieve f/w log
|
|
.RE
|
|
.PP
|
|
\fBnvme-get-feature\fR(1)
|
|
.RS 4
|
|
Get Features
|
|
.RE
|
|
.PP
|
|
\fBnvme-get-log\fR(1)
|
|
.RS 4
|
|
Generic Get Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-telemetry-log\fR(1)
|
|
.RS 4
|
|
Telemetry Host\-Initiated Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-changed-ns-list-log\fR(1)
|
|
.RS 4
|
|
Retrieve Changed Namespace List Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-smart-log\fR(1)
|
|
.RS 4
|
|
Retrieve Smart Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-ana-log\fR(1)
|
|
.RS 4
|
|
Retreive ANA(Asymmetric Namespace Access) Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-endurance-log\fR(1)
|
|
.RS 4
|
|
Retrieve endurance Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-effects-log\fR(1)
|
|
.RS 4
|
|
Retrieve effects Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-self-test-log\fR(1)
|
|
.RS 4
|
|
Retrieve Device Self\-test Log
|
|
.RE
|
|
.PP
|
|
\fBnvme-get-ns-id\fR(1)
|
|
.RS 4
|
|
Retrieve namespace identifier
|
|
.RE
|
|
.PP
|
|
\fBnvme-help\fR(1)
|
|
.RS 4
|
|
NVMe CLI Help
|
|
.RE
|
|
.PP
|
|
\fBnvme-id-ctrl\fR(1)
|
|
.RS 4
|
|
Identify Controller
|
|
.RE
|
|
.PP
|
|
\fBnvme-id-ns\fR(1)
|
|
.RS 4
|
|
Identify Namespace
|
|
.RE
|
|
.PP
|
|
\fBnvme-id-nvmset\fR(1)
|
|
.RS 4
|
|
Identify NVM Set List
|
|
.RE
|
|
.PP
|
|
\fBnvme-id-iocs\fR(1)
|
|
.RS 4
|
|
Identify I/O Command Set
|
|
.RE
|
|
.PP
|
|
\fBnvme-create-ns\fR(1)
|
|
.RS 4
|
|
Create a new namespace
|
|
.RE
|
|
.PP
|
|
\fBnvme-delete-ns\fR(1)
|
|
.RS 4
|
|
Delete existing namespace
|
|
.RE
|
|
.PP
|
|
\fBnvme-attach-ns\fR(1)
|
|
.RS 4
|
|
Attach namespace
|
|
.RE
|
|
.PP
|
|
\fBnvme-detach-ns\fR(1)
|
|
.RS 4
|
|
Detach namespace
|
|
.RE
|
|
.PP
|
|
\fBnvme-io-passthru\fR(1)
|
|
.RS 4
|
|
IO Passthrough Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-list-ns\fR(1)
|
|
.RS 4
|
|
List all nvme namespaces
|
|
.RE
|
|
.PP
|
|
\fBnvme-ns-descs\fR(1)
|
|
.RS 4
|
|
Identify Namespace Identification Descriptor
|
|
.RE
|
|
.PP
|
|
\fBnvme-list\fR(1)
|
|
.RS 4
|
|
List all nvme controllers
|
|
.RE
|
|
.PP
|
|
\fBnvme-list-ctrl\fR(1)
|
|
.RS 4
|
|
List controller in NVMe subsystem
|
|
.RE
|
|
.PP
|
|
\fBnvme-list-subsys\fR(1)
|
|
.RS 4
|
|
List NVMe subsystems
|
|
.RE
|
|
.PP
|
|
\fBnvme-reset\fR(1)
|
|
.RS 4
|
|
Reset a NVMe controller
|
|
.RE
|
|
.PP
|
|
\fBnvme-device-self-test\fR(1)
|
|
.RS 4
|
|
Issue Device Self\-test Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-read\fR(1)
|
|
.RS 4
|
|
Issue IO Read Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-write\fR(1)
|
|
.RS 4
|
|
Issue IO Write Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-write-zeroes\fR(1)
|
|
.RS 4
|
|
Issue IO Write Zeroes Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-write-uncor\fR(1)
|
|
.RS 4
|
|
Issue IO Write Uncorrectable Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-resv-acquire\fR(1)
|
|
.RS 4
|
|
Acquire Namespace Reservation
|
|
.RE
|
|
.PP
|
|
\fBnvme-resv-register\fR(1)
|
|
.RS 4
|
|
Register Namespace Reservation
|
|
.RE
|
|
.PP
|
|
\fBnvme-resv-release\fR(1)
|
|
.RS 4
|
|
Release Namespace Reservation
|
|
.RE
|
|
.PP
|
|
\fBnvme-resv-report\fR(1)
|
|
.RS 4
|
|
Report Reservation Capabilities
|
|
.RE
|
|
.PP
|
|
\fBnvme-security-recv\fR(1)
|
|
.RS 4
|
|
Security Receive
|
|
.RE
|
|
.PP
|
|
\fBnvme-security-send\fR(1)
|
|
.RS 4
|
|
Security Send
|
|
.RE
|
|
.PP
|
|
\fBnvme-dsm\fR(1)
|
|
.RS 4
|
|
Issue Data Set Management Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-copy\fR(1)
|
|
.RS 4
|
|
Issue Simple Copy Command
|
|
.RE
|
|
.PP
|
|
\fBnvme-set-feature\fR(1)
|
|
.RS 4
|
|
Set Feature
|
|
.RE
|
|
.PP
|
|
\fBnvme-show-regs\fR(1)
|
|
.RS 4
|
|
Show NVMe Controller Registers
|
|
.RE
|
|
.PP
|
|
\fBnvme-discover\fR(1)
|
|
.RS 4
|
|
Send Get Log Page request to Discovery Controller
|
|
.RE
|
|
.PP
|
|
\fBnvme-connect-all\fR(1)
|
|
.RS 4
|
|
Discover and connect to all NVMe\-over\-Fabrics subsystems
|
|
.RE
|
|
.PP
|
|
\fBnvme-connect\fR(1)
|
|
.RS 4
|
|
Connect to an NVMe\-over\-Fabrics subsystem
|
|
.RE
|
|
.PP
|
|
\fBnvme-disconnect\fR(1)
|
|
.RS 4
|
|
Disconnect from an NVMe\-over\-Fabrics subsystem
|
|
.RE
|
|
.PP
|
|
\fBnvme-disconnect-all\fR(1)
|
|
.RS 4
|
|
Disconnect from all NVMe\-over\-Fabrics subsystems
|
|
.RE
|
|
.PP
|
|
\fBnvme-get-property\fR(1)
|
|
.RS 4
|
|
Reads and shows NVMe\-over\-Fabrics controller property
|
|
.RE
|
|
.SH "FURTHER DOCUMENTATION"
|
|
.sp
|
|
See the freely available references on the \m[blue]\fBOfficial NVM\-Express Site\fR\m[]\&\s-2\u[1]\d\s+2\&.
|
|
.SH "AUTHORS"
|
|
.sp
|
|
This is written and maintained by \m[blue]\fBKeith Busch\fR\m[]\&\s-2\u[2]\d\s+2\&.
|
|
.SH "REPORTING BUGS"
|
|
.sp
|
|
Patches and issues may be submitted to the official repository at \m[blue]\fBhttps://github\&.com/linux\-nvme/nvme\-cli\fR\m[] or the Linux NVMe mailing list \m[blue]\fBlinux\-nvme\fR\m[]\&\s-2\u[3]\d\s+2
|
|
.SH "NVME"
|
|
.sp
|
|
Part of the nvme suite
|
|
.SH "NOTES"
|
|
.IP " 1." 4
|
|
Official NVM-Express Site
|
|
.RS 4
|
|
\%http://nvmexpress.org
|
|
.RE
|
|
.IP " 2." 4
|
|
Keith Busch
|
|
.RS 4
|
|
\%mailto:kbusch@kernel.org
|
|
.RE
|
|
.IP " 3." 4
|
|
linux-nvme
|
|
.RS 4
|
|
\%mailto:linux-nvme@lists.infradead.org
|
|
.RE
|