b846efd7ec
invoke it from nvmecontrol(8). Controller reset will be performed in cases where I/O are repeatedly timing out, the controller reports an unrecoverable condition, or when explicitly requested via IOCTL or an nvme consumer. Since the controller may be in such a state where it cannot even process queue deletion requests, we will perform a controller reset without trying to clean up anything on the controller first. Sponsored by: Intel Reviewed by: carl
95 lines
2.9 KiB
Groff
95 lines
2.9 KiB
Groff
.\"
|
|
.\" Copyright (c) 2012 Intel Corporation
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions, and the following disclaimer,
|
|
.\" without modification.
|
|
.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
.\" substantially similar to the "NO WARRANTY" disclaimer below
|
|
.\" ("Disclaimer") and any redistribution must be conditioned upon
|
|
.\" including a substantially similar Disclaimer requirement for further
|
|
.\" binary redistribution.
|
|
.\"
|
|
.\" NO WARRANTY
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
|
|
.\" A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
.\" HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGES.
|
|
.\"
|
|
.\" nvmecontrol man page.
|
|
.\"
|
|
.\" Author: Jim Harris <jimharris@FreeBSD.org>
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd March 26, 2013
|
|
.Dt NVMECONTROL 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm nvmecontrol
|
|
.Nd NVM Express control utility
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Ic devlist
|
|
.Nm
|
|
.Ic identify
|
|
.Op Fl v
|
|
.Op Fl x
|
|
.Aq device id
|
|
.Nm
|
|
.Ic perftest
|
|
.Aq Fl n Ar num_threads
|
|
.Aq Fl o Ar read|write
|
|
.Op Fl p
|
|
.Aq Fl s Ar size_in_bytes
|
|
.Aq Fl t Ar time_in_sec
|
|
.Aq namespace id
|
|
.Nm
|
|
.Ic reset
|
|
.Aq controller id
|
|
.Sh DESCRIPTION
|
|
NVM Express (NVMe) is a storage protocol standard, for SSDs and other
|
|
high-speed storage devices over PCI Express.
|
|
.Sh EXAMPLES
|
|
.Dl nvmecontrol devlist
|
|
.Pp
|
|
Display a list of NVMe controllers and namespaces along with their device nodes.
|
|
.Pp
|
|
.Dl nvmecontrol identify nvme0
|
|
.Pp
|
|
Display a human-readable summary of the nvme0 IDENTIFY_CONTROLLER data.
|
|
.Pp
|
|
.Dl nvmecontrol identify -x -v nvme0ns1
|
|
.Pp
|
|
Display a hexadecimal dump of the nvme0 IDENTIFY_NAMESPACE data for namespace
|
|
1.
|
|
.Pp
|
|
.Dl nvmecontrol perftest -n 32 -o read -s 512 -t 30 nvme0ns1
|
|
.Pp
|
|
Run a performance test on nvme0ns1 using 32 kernel threads for 30 seconds. Each
|
|
thread will issue a single 512 byte read command. Results are printed to
|
|
stdout when 30 seconds expires.
|
|
.Pp
|
|
.Dl nvmecontrol reset nvme0
|
|
.Pp
|
|
Perform a controller-level reset of the nvme0 controller.
|
|
.Sh AUTHORS
|
|
.An -nosplit
|
|
.Nm
|
|
was developed by Intel and originally written by
|
|
.An Jim Harris Aq jimharris@FreeBSD.org .
|
|
.Pp
|
|
This man page was written by
|
|
.An Jim Harris Aq jimharris@FreeBSD.org .
|