a7bf63be69
While very useful by itself, it also makes `nvmecontrol` not depend on hardcoded device names parsing, that in its turn makes simple to take nvdX (and potentially any other) device names as arguments. Also added IOCTL bypass from nvdX to respective nvmeYnsZ makes them interchangeable for management purposes. MFC after: 2 weeks Sponsored by: iXsystems, Inc.
490 lines
14 KiB
C
490 lines
14 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
|
|
*
|
|
* Copyright (c) 2013 EMC Corp.
|
|
* All rights reserved.
|
|
*
|
|
* Copyright (C) 2012-2013 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.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, 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 DAMAGE.
|
|
*/
|
|
|
|
#include <sys/cdefs.h>
|
|
__FBSDID("$FreeBSD$");
|
|
|
|
#include <sys/param.h>
|
|
#include <sys/ioccom.h>
|
|
|
|
#include <ctype.h>
|
|
#include <err.h>
|
|
#include <fcntl.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <unistd.h>
|
|
#include <sys/endian.h>
|
|
|
|
#include "nvmecontrol.h"
|
|
|
|
/* Tables for command line parsing */
|
|
|
|
static cmd_fn_t logpage;
|
|
|
|
#define NONE 0xffffffffu
|
|
static struct options {
|
|
bool binary;
|
|
bool hex;
|
|
uint32_t page;
|
|
const char *vendor;
|
|
const char *dev;
|
|
} opt = {
|
|
.binary = false,
|
|
.hex = false,
|
|
.page = NONE,
|
|
.vendor = NULL,
|
|
.dev = NULL,
|
|
};
|
|
|
|
static const struct opts logpage_opts[] = {
|
|
#define OPT(l, s, t, opt, addr, desc) { l, s, t, &opt.addr, desc }
|
|
OPT("binary", 'b', arg_none, opt, binary,
|
|
"Dump the log page as binary"),
|
|
OPT("hex", 'x', arg_none, opt, hex,
|
|
"Dump the log page as hex"),
|
|
OPT("page", 'p', arg_uint32, opt, page,
|
|
"Page to dump"),
|
|
OPT("vendor", 'v', arg_string, opt, vendor,
|
|
"Vendor specific formatting"),
|
|
{ NULL, 0, arg_none, NULL, NULL }
|
|
};
|
|
#undef OPT
|
|
|
|
static const struct args logpage_args[] = {
|
|
{ arg_string, &opt.dev, "<controller id|namespace id>" },
|
|
{ arg_none, NULL, NULL },
|
|
};
|
|
|
|
static struct cmd logpage_cmd = {
|
|
.name = "logpage",
|
|
.fn = logpage,
|
|
.descr = "Print logpages in human-readable form",
|
|
.ctx_size = sizeof(opt),
|
|
.opts = logpage_opts,
|
|
.args = logpage_args,
|
|
};
|
|
|
|
CMD_COMMAND(logpage_cmd);
|
|
|
|
/* End of tables for command line parsing */
|
|
|
|
#define MAX_FW_SLOTS (7)
|
|
|
|
static SLIST_HEAD(,logpage_function) logpages;
|
|
|
|
void
|
|
logpage_register(struct logpage_function *p)
|
|
{
|
|
|
|
SLIST_INSERT_HEAD(&logpages, p, link);
|
|
}
|
|
|
|
const char *
|
|
kv_lookup(const struct kv_name *kv, size_t kv_count, uint32_t key)
|
|
{
|
|
static char bad[32];
|
|
size_t i;
|
|
|
|
for (i = 0; i < kv_count; i++, kv++)
|
|
if (kv->key == key)
|
|
return kv->name;
|
|
snprintf(bad, sizeof(bad), "Attribute %#x", key);
|
|
return bad;
|
|
}
|
|
|
|
static void
|
|
print_log_hex(const struct nvme_controller_data *cdata __unused, void *data, uint32_t length)
|
|
{
|
|
|
|
print_hex(data, length);
|
|
}
|
|
|
|
static void
|
|
print_bin(const struct nvme_controller_data *cdata __unused, void *data, uint32_t length)
|
|
{
|
|
|
|
write(STDOUT_FILENO, data, length);
|
|
}
|
|
|
|
static void *
|
|
get_log_buffer(uint32_t size)
|
|
{
|
|
void *buf;
|
|
|
|
if ((buf = malloc(size)) == NULL)
|
|
errx(1, "unable to malloc %u bytes", size);
|
|
|
|
memset(buf, 0, size);
|
|
return (buf);
|
|
}
|
|
|
|
void
|
|
read_logpage(int fd, uint8_t log_page, uint32_t nsid, void *payload,
|
|
uint32_t payload_size)
|
|
{
|
|
struct nvme_pt_command pt;
|
|
struct nvme_error_information_entry *err_entry;
|
|
int i, err_pages;
|
|
|
|
memset(&pt, 0, sizeof(pt));
|
|
pt.cmd.opc = NVME_OPC_GET_LOG_PAGE;
|
|
pt.cmd.nsid = htole32(nsid);
|
|
pt.cmd.cdw10 = ((payload_size/sizeof(uint32_t)) - 1) << 16;
|
|
pt.cmd.cdw10 |= log_page;
|
|
pt.cmd.cdw10 = htole32(pt.cmd.cdw10);
|
|
pt.buf = payload;
|
|
pt.len = payload_size;
|
|
pt.is_read = 1;
|
|
|
|
if (ioctl(fd, NVME_PASSTHROUGH_CMD, &pt) < 0)
|
|
err(1, "get log page request failed");
|
|
|
|
/* Convert data to host endian */
|
|
switch (log_page) {
|
|
case NVME_LOG_ERROR:
|
|
err_entry = (struct nvme_error_information_entry *)payload;
|
|
err_pages = payload_size / sizeof(struct nvme_error_information_entry);
|
|
for (i = 0; i < err_pages; i++)
|
|
nvme_error_information_entry_swapbytes(err_entry++);
|
|
break;
|
|
case NVME_LOG_HEALTH_INFORMATION:
|
|
nvme_health_information_page_swapbytes(
|
|
(struct nvme_health_information_page *)payload);
|
|
break;
|
|
case NVME_LOG_FIRMWARE_SLOT:
|
|
nvme_firmware_page_swapbytes(
|
|
(struct nvme_firmware_page *)payload);
|
|
break;
|
|
case INTEL_LOG_TEMP_STATS:
|
|
intel_log_temp_stats_swapbytes(
|
|
(struct intel_log_temp_stats *)payload);
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
if (nvme_completion_is_error(&pt.cpl))
|
|
errx(1, "get log page request returned error");
|
|
}
|
|
|
|
static void
|
|
print_log_error(const struct nvme_controller_data *cdata __unused, void *buf, uint32_t size)
|
|
{
|
|
int i, nentries;
|
|
uint16_t status;
|
|
uint8_t p, sc, sct, m, dnr;
|
|
struct nvme_error_information_entry *entry = buf;
|
|
|
|
printf("Error Information Log\n");
|
|
printf("=====================\n");
|
|
|
|
if (entry->error_count == 0) {
|
|
printf("No error entries found\n");
|
|
return;
|
|
}
|
|
|
|
nentries = size/sizeof(struct nvme_error_information_entry);
|
|
for (i = 0; i < nentries; i++, entry++) {
|
|
if (entry->error_count == 0)
|
|
break;
|
|
|
|
status = entry->status;
|
|
|
|
p = NVME_STATUS_GET_P(status);
|
|
sc = NVME_STATUS_GET_SC(status);
|
|
sct = NVME_STATUS_GET_SCT(status);
|
|
m = NVME_STATUS_GET_M(status);
|
|
dnr = NVME_STATUS_GET_DNR(status);
|
|
|
|
printf("Entry %02d\n", i + 1);
|
|
printf("=========\n");
|
|
printf(" Error count: %ju\n", entry->error_count);
|
|
printf(" Submission queue ID: %u\n", entry->sqid);
|
|
printf(" Command ID: %u\n", entry->cid);
|
|
/* TODO: Export nvme_status_string structures from kernel? */
|
|
printf(" Status:\n");
|
|
printf(" Phase tag: %d\n", p);
|
|
printf(" Status code: %d\n", sc);
|
|
printf(" Status code type: %d\n", sct);
|
|
printf(" More: %d\n", m);
|
|
printf(" DNR: %d\n", dnr);
|
|
printf(" Error location: %u\n", entry->error_location);
|
|
printf(" LBA: %ju\n", entry->lba);
|
|
printf(" Namespace ID: %u\n", entry->nsid);
|
|
printf(" Vendor specific info: %u\n", entry->vendor_specific);
|
|
}
|
|
}
|
|
|
|
void
|
|
print_temp(uint16_t t)
|
|
{
|
|
printf("%u K, %2.2f C, %3.2f F\n", t, (float)t - 273.15, (float)t * 9 / 5 - 459.67);
|
|
}
|
|
|
|
|
|
static void
|
|
print_log_health(const struct nvme_controller_data *cdata __unused, void *buf, uint32_t size __unused)
|
|
{
|
|
struct nvme_health_information_page *health = buf;
|
|
char cbuf[UINT128_DIG + 1];
|
|
uint8_t warning;
|
|
int i;
|
|
|
|
warning = health->critical_warning;
|
|
|
|
printf("SMART/Health Information Log\n");
|
|
printf("============================\n");
|
|
|
|
printf("Critical Warning State: 0x%02x\n", warning);
|
|
printf(" Available spare: %d\n",
|
|
!!(warning & NVME_CRIT_WARN_ST_AVAILABLE_SPARE));
|
|
printf(" Temperature: %d\n",
|
|
!!(warning & NVME_CRIT_WARN_ST_TEMPERATURE));
|
|
printf(" Device reliability: %d\n",
|
|
!!(warning & NVME_CRIT_WARN_ST_DEVICE_RELIABILITY));
|
|
printf(" Read only: %d\n",
|
|
!!(warning & NVME_CRIT_WARN_ST_READ_ONLY));
|
|
printf(" Volatile memory backup: %d\n",
|
|
!!(warning & NVME_CRIT_WARN_ST_VOLATILE_MEMORY_BACKUP));
|
|
printf("Temperature: ");
|
|
print_temp(health->temperature);
|
|
printf("Available spare: %u\n",
|
|
health->available_spare);
|
|
printf("Available spare threshold: %u\n",
|
|
health->available_spare_threshold);
|
|
printf("Percentage used: %u\n",
|
|
health->percentage_used);
|
|
|
|
printf("Data units (512,000 byte) read: %s\n",
|
|
uint128_to_str(to128(health->data_units_read), cbuf, sizeof(cbuf)));
|
|
printf("Data units written: %s\n",
|
|
uint128_to_str(to128(health->data_units_written), cbuf, sizeof(cbuf)));
|
|
printf("Host read commands: %s\n",
|
|
uint128_to_str(to128(health->host_read_commands), cbuf, sizeof(cbuf)));
|
|
printf("Host write commands: %s\n",
|
|
uint128_to_str(to128(health->host_write_commands), cbuf, sizeof(cbuf)));
|
|
printf("Controller busy time (minutes): %s\n",
|
|
uint128_to_str(to128(health->controller_busy_time), cbuf, sizeof(cbuf)));
|
|
printf("Power cycles: %s\n",
|
|
uint128_to_str(to128(health->power_cycles), cbuf, sizeof(cbuf)));
|
|
printf("Power on hours: %s\n",
|
|
uint128_to_str(to128(health->power_on_hours), cbuf, sizeof(cbuf)));
|
|
printf("Unsafe shutdowns: %s\n",
|
|
uint128_to_str(to128(health->unsafe_shutdowns), cbuf, sizeof(cbuf)));
|
|
printf("Media errors: %s\n",
|
|
uint128_to_str(to128(health->media_errors), cbuf, sizeof(cbuf)));
|
|
printf("No. error info log entries: %s\n",
|
|
uint128_to_str(to128(health->num_error_info_log_entries), cbuf, sizeof(cbuf)));
|
|
|
|
printf("Warning Temp Composite Time: %d\n", health->warning_temp_time);
|
|
printf("Error Temp Composite Time: %d\n", health->error_temp_time);
|
|
for (i = 0; i < 8; i++) {
|
|
if (health->temp_sensor[i] == 0)
|
|
continue;
|
|
printf("Temperature Sensor %d: ", i + 1);
|
|
print_temp(health->temp_sensor[i]);
|
|
}
|
|
}
|
|
|
|
static void
|
|
print_log_firmware(const struct nvme_controller_data *cdata, void *buf, uint32_t size __unused)
|
|
{
|
|
int i, slots;
|
|
const char *status;
|
|
struct nvme_firmware_page *fw = buf;
|
|
uint8_t afi_slot;
|
|
uint16_t oacs_fw;
|
|
uint8_t fw_num_slots;
|
|
|
|
afi_slot = fw->afi >> NVME_FIRMWARE_PAGE_AFI_SLOT_SHIFT;
|
|
afi_slot &= NVME_FIRMWARE_PAGE_AFI_SLOT_MASK;
|
|
|
|
oacs_fw = (cdata->oacs >> NVME_CTRLR_DATA_OACS_FIRMWARE_SHIFT) &
|
|
NVME_CTRLR_DATA_OACS_FIRMWARE_MASK;
|
|
fw_num_slots = (cdata->frmw >> NVME_CTRLR_DATA_FRMW_NUM_SLOTS_SHIFT) &
|
|
NVME_CTRLR_DATA_FRMW_NUM_SLOTS_MASK;
|
|
|
|
printf("Firmware Slot Log\n");
|
|
printf("=================\n");
|
|
|
|
if (oacs_fw == 0)
|
|
slots = 1;
|
|
else
|
|
slots = MIN(fw_num_slots, MAX_FW_SLOTS);
|
|
|
|
for (i = 0; i < slots; i++) {
|
|
printf("Slot %d: ", i + 1);
|
|
if (afi_slot == i + 1)
|
|
status = " Active";
|
|
else
|
|
status = "Inactive";
|
|
|
|
if (fw->revision[i] == 0LLU)
|
|
printf("Empty\n");
|
|
else
|
|
if (isprint(*(char *)&fw->revision[i]))
|
|
printf("[%s] %.8s\n", status,
|
|
(char *)&fw->revision[i]);
|
|
else
|
|
printf("[%s] %016jx\n", status,
|
|
fw->revision[i]);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Table of log page printer / sizing.
|
|
*
|
|
* Make sure you keep all the pages of one vendor together so -v help
|
|
* lists all the vendors pages.
|
|
*/
|
|
NVME_LOGPAGE(error,
|
|
NVME_LOG_ERROR, NULL, "Drive Error Log",
|
|
print_log_error, 0);
|
|
NVME_LOGPAGE(health,
|
|
NVME_LOG_HEALTH_INFORMATION, NULL, "Health/SMART Data",
|
|
print_log_health, sizeof(struct nvme_health_information_page));
|
|
NVME_LOGPAGE(fw,
|
|
NVME_LOG_FIRMWARE_SLOT, NULL, "Firmware Information",
|
|
print_log_firmware, sizeof(struct nvme_firmware_page));
|
|
|
|
static void
|
|
logpage_help(void)
|
|
{
|
|
const struct logpage_function *f;
|
|
const char *v;
|
|
|
|
fprintf(stderr, "\n");
|
|
fprintf(stderr, "%-8s %-10s %s\n", "Page", "Vendor","Page Name");
|
|
fprintf(stderr, "-------- ---------- ----------\n");
|
|
SLIST_FOREACH(f, &logpages, link) {
|
|
v = f->vendor == NULL ? "-" : f->vendor;
|
|
fprintf(stderr, "0x%02x %-10s %s\n", f->log_page, v, f->name);
|
|
}
|
|
|
|
exit(1);
|
|
}
|
|
|
|
static void
|
|
logpage(const struct cmd *f, int argc, char *argv[])
|
|
{
|
|
int fd;
|
|
char *path;
|
|
uint32_t nsid, size;
|
|
void *buf;
|
|
const struct logpage_function *lpf;
|
|
struct nvme_controller_data cdata;
|
|
print_fn_t print_fn;
|
|
uint8_t ns_smart;
|
|
|
|
if (arg_parse(argc, argv, f))
|
|
return;
|
|
if (opt.hex && opt.binary) {
|
|
fprintf(stderr,
|
|
"Can't specify both binary and hex\n");
|
|
arg_help(argc, argv, f);
|
|
}
|
|
if (opt.vendor != NULL && strcmp(opt.vendor, "help") == 0)
|
|
logpage_help();
|
|
if (opt.page == NONE) {
|
|
fprintf(stderr, "Missing page_id (-p).\n");
|
|
arg_help(argc, argv, f);
|
|
}
|
|
open_dev(opt.dev, &fd, 1, 1);
|
|
get_nsid(fd, &path, &nsid);
|
|
if (nsid == 0) {
|
|
nsid = NVME_GLOBAL_NAMESPACE_TAG;
|
|
} else {
|
|
close(fd);
|
|
open_dev(path, &fd, 1, 1);
|
|
}
|
|
free(path);
|
|
|
|
read_controller_data(fd, &cdata);
|
|
|
|
ns_smart = (cdata.lpa >> NVME_CTRLR_DATA_LPA_NS_SMART_SHIFT) &
|
|
NVME_CTRLR_DATA_LPA_NS_SMART_MASK;
|
|
|
|
/*
|
|
* The log page attribtues indicate whether or not the controller
|
|
* supports the SMART/Health information log page on a per
|
|
* namespace basis.
|
|
*/
|
|
if (nsid != NVME_GLOBAL_NAMESPACE_TAG) {
|
|
if (opt.page != NVME_LOG_HEALTH_INFORMATION)
|
|
errx(1, "log page %d valid only at controller level",
|
|
opt.page);
|
|
if (ns_smart == 0)
|
|
errx(1,
|
|
"controller does not support per namespace "
|
|
"smart/health information");
|
|
}
|
|
|
|
print_fn = print_log_hex;
|
|
size = DEFAULT_SIZE;
|
|
if (opt.binary)
|
|
print_fn = print_bin;
|
|
if (!opt.binary && !opt.hex) {
|
|
/*
|
|
* See if there is a pretty print function for the specified log
|
|
* page. If one isn't found, we just revert to the default
|
|
* (print_hex). If there was a vendor specified by the user, and
|
|
* the page is vendor specific, don't match the print function
|
|
* unless the vendors match.
|
|
*/
|
|
SLIST_FOREACH(lpf, &logpages, link) {
|
|
if (lpf->vendor != NULL && opt.vendor != NULL &&
|
|
strcmp(lpf->vendor, opt.vendor) != 0)
|
|
continue;
|
|
if (opt.page != lpf->log_page)
|
|
continue;
|
|
print_fn = lpf->print_fn;
|
|
size = lpf->size;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (opt.page == NVME_LOG_ERROR) {
|
|
size = sizeof(struct nvme_error_information_entry);
|
|
size *= (cdata.elpe + 1);
|
|
}
|
|
|
|
/* Read the log page */
|
|
buf = get_log_buffer(size);
|
|
read_logpage(fd, opt.page, nsid, buf, size);
|
|
print_fn(&cdata, buf, size);
|
|
|
|
close(fd);
|
|
exit(0);
|
|
}
|