Nvmetools: Difference between revisions

From Omnia
Jump to navigation Jump to search
(Created page with "== Epic NVMe Tools == Linux or Windows NVMe CLI tools! https://www.nvmetools.com/ == Pipy == Install on Linux or Windows: pip install nvmetools == Github == https://github.com/jtjones1001/nvmetools git clone git@github.com:jtjones1001/nvmetools.git # git clone https://github.com/jtjones1001/nvmetools.git == Usage == Online documentation: https://nvmetools.readthedocs.io/en/latest/ === listnvme === listnvme === readnvme === Show basic stats: readnvme...")
 
Line 22: Line 22:
Online documentation:
Online documentation:
  https://nvmetools.readthedocs.io/en/latest/
  https://nvmetools.readthedocs.io/en/latest/
All console commands return a 0 on pass and non-zero on fail.


=== listnvme ===
=== listnvme ===


  listnvme
  listnvme
Description: Console command that lists the NVMe drives in the system.
* Displays the NVMe drives in the system. Each drive has a unique ‘NVMe number’ that identifies that specific NVMe. The other console commands require this number to know which NVMe drive to read or test.


=== readnvme ===
=== readnvme ===
Line 34: Line 39:
Show all stats:
Show all stats:
  readnvme -n 0 -a
  readnvme -n 0 -a
Description: Console command that displays and logs NVMe drive information.
* Reads NVMe drive information using the Admin Commands: Get Log Page, Get Feature, Identify Controller, and Identify Namespace. A few parameters, such as PCIe location and link info, are read from the OS.


=== checknvme ===
=== checknvme ===
Report simple PASS / FAIL status. Also generates html report.


Show health and wear:
Show health and wear:
  checknvme -n 0
  checknvme -n 0
Description: Console command that checks the health of NVMe drive then displays information in html format.
* Verifies the NVMe drive health by running the short self-test diagnostic, checking the SMART attributes for errors and log page 6 for prior self-test failures.
* If nvme is not specified then all NVMe drives are checked.
=== viewnvme ===
Generate html report:
viewnvme -n 0
Description: Console command that displays NVMe drive information in html format.
* Reads NVMe drive information using the Admin Commands: Get Log Page, Get Feature, Identify Controller, and Identify Namespace. A few parameters, such as PCIe location and link info, are read from the OS.

Revision as of 23:32, 13 May 2024

Epic NVMe Tools

Linux or Windows NVMe CLI tools!

https://www.nvmetools.com/

Pipy

Install on Linux or Windows:

pip install nvmetools

Github

https://github.com/jtjones1001/nvmetools
git clone git@github.com:jtjones1001/nvmetools.git
#
git clone https://github.com/jtjones1001/nvmetools.git

Usage

Online documentation:

https://nvmetools.readthedocs.io/en/latest/

All console commands return a 0 on pass and non-zero on fail.

listnvme

listnvme

Description: Console command that lists the NVMe drives in the system.

  • Displays the NVMe drives in the system. Each drive has a unique ‘NVMe number’ that identifies that specific NVMe. The other console commands require this number to know which NVMe drive to read or test.

readnvme

Show basic stats:

readnvme -n 0

Show all stats:

readnvme -n 0 -a

Description: Console command that displays and logs NVMe drive information.

  • Reads NVMe drive information using the Admin Commands: Get Log Page, Get Feature, Identify Controller, and Identify Namespace. A few parameters, such as PCIe location and link info, are read from the OS.

checknvme

Report simple PASS / FAIL status. Also generates html report.

Show health and wear:

checknvme -n 0

Description: Console command that checks the health of NVMe drive then displays information in html format.

  • Verifies the NVMe drive health by running the short self-test diagnostic, checking the SMART attributes for errors and log page 6 for prior self-test failures.
  • If nvme is not specified then all NVMe drives are checked.

viewnvme

Generate html report:

viewnvme -n 0

Description: Console command that displays NVMe drive information in html format.

  • Reads NVMe drive information using the Admin Commands: Get Log Page, Get Feature, Identify Controller, and Identify Namespace. A few parameters, such as PCIe location and link info, are read from the OS.