logpage.c revision 328719
1/*-
2 * Copyright (c) 2013 EMC Corp.
3 * All rights reserved.
4 *
5 * Copyright (C) 2012-2013 Intel Corporation
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 *    notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 *    notice, this list of conditions and the following disclaimer in the
15 *    documentation and/or other materials provided with the distribution.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
28 */
29
30#include <sys/cdefs.h>
31__FBSDID("$FreeBSD: stable/11/sbin/nvmecontrol/logpage.c 328719 2018-02-01 19:39:29Z mav $");
32
33#include <sys/param.h>
34#include <sys/ioccom.h>
35
36#include <ctype.h>
37#include <err.h>
38#include <fcntl.h>
39#include <stdbool.h>
40#include <stddef.h>
41#include <stdio.h>
42#include <stdlib.h>
43#include <string.h>
44#include <unistd.h>
45#include <sys/endian.h>
46
47#if _BYTE_ORDER != _LITTLE_ENDIAN
48#error "Code only works on little endian machines"
49#endif
50
51#include "nvmecontrol.h"
52
53#define DEFAULT_SIZE	(4096)
54#define MAX_FW_SLOTS	(7)
55
56typedef void (*print_fn_t)(void *buf, uint32_t size);
57
58struct kv_name
59{
60	uint32_t key;
61	const char *name;
62};
63
64static const char *
65kv_lookup(const struct kv_name *kv, size_t kv_count, uint32_t key)
66{
67	static char bad[32];
68	size_t i;
69
70	for (i = 0; i < kv_count; i++, kv++)
71		if (kv->key == key)
72			return kv->name;
73	snprintf(bad, sizeof(bad), "Attribute %#x", key);
74	return bad;
75}
76
77/*
78 * 128-bit integer augments to standard values. On i386 this
79 * doesn't exist, so we use 64-bit values. The 128-bit counters
80 * are crazy anyway, since for this purpose, you'd need a
81 * billion IOPs for billions of seconds to overflow them.
82 * So, on 32-bit i386, you'll get truncated values.
83 */
84#define UINT128_DIG	39
85#ifdef __i386__
86typedef uint64_t uint128_t;
87#else
88typedef __uint128_t uint128_t;
89#endif
90
91static inline uint128_t
92to128(void *p)
93{
94	return *(uint128_t *)p;
95}
96
97static char *
98uint128_to_str(uint128_t u, char *buf, size_t buflen)
99{
100	char *end = buf + buflen - 1;
101
102	*end-- = '\0';
103	if (u == 0)
104		*end-- = '0';
105	while (u && end >= buf) {
106		*end-- = u % 10 + '0';
107		u /= 10;
108	}
109	end++;
110	if (u != 0)
111		return NULL;
112
113	return end;
114}
115
116/* "Missing" from endian.h */
117static __inline uint64_t
118le48dec(const void *pp)
119{
120	uint8_t const *p = (uint8_t const *)pp;
121
122	return (((uint64_t)le16dec(p + 4) << 32) | le32dec(p));
123}
124
125static void *
126get_log_buffer(uint32_t size)
127{
128	void	*buf;
129
130	if ((buf = malloc(size)) == NULL)
131		errx(1, "unable to malloc %u bytes", size);
132
133	memset(buf, 0, size);
134	return (buf);
135}
136
137void
138read_logpage(int fd, uint8_t log_page, int nsid, void *payload,
139    uint32_t payload_size)
140{
141	struct nvme_pt_command	pt;
142
143	memset(&pt, 0, sizeof(pt));
144	pt.cmd.opc = NVME_OPC_GET_LOG_PAGE;
145	pt.cmd.nsid = nsid;
146	pt.cmd.cdw10 = ((payload_size/sizeof(uint32_t)) - 1) << 16;
147	pt.cmd.cdw10 |= log_page;
148	pt.buf = payload;
149	pt.len = payload_size;
150	pt.is_read = 1;
151
152	if (ioctl(fd, NVME_PASSTHROUGH_CMD, &pt) < 0)
153		err(1, "get log page request failed");
154
155	if (nvme_completion_is_error(&pt.cpl))
156		errx(1, "get log page request returned error");
157}
158
159static void
160print_log_error(void *buf, uint32_t size)
161{
162	int					i, nentries;
163	struct nvme_error_information_entry	*entry = buf;
164	struct nvme_status			*status;
165
166	printf("Error Information Log\n");
167	printf("=====================\n");
168
169	if (entry->error_count == 0) {
170		printf("No error entries found\n");
171		return;
172	}
173
174	nentries = size/sizeof(struct nvme_error_information_entry);
175	for (i = 0; i < nentries; i++, entry++) {
176		if (entry->error_count == 0)
177			break;
178
179		status = &entry->status;
180		printf("Entry %02d\n", i + 1);
181		printf("=========\n");
182		printf(" Error count:          %ju\n", entry->error_count);
183		printf(" Submission queue ID:  %u\n", entry->sqid);
184		printf(" Command ID:           %u\n", entry->cid);
185		/* TODO: Export nvme_status_string structures from kernel? */
186		printf(" Status:\n");
187		printf("  Phase tag:           %d\n", status->p);
188		printf("  Status code:         %d\n", status->sc);
189		printf("  Status code type:    %d\n", status->sct);
190		printf("  More:                %d\n", status->m);
191		printf("  DNR:                 %d\n", status->dnr);
192		printf(" Error location:       %u\n", entry->error_location);
193		printf(" LBA:                  %ju\n", entry->lba);
194		printf(" Namespace ID:         %u\n", entry->nsid);
195		printf(" Vendor specific info: %u\n", entry->vendor_specific);
196	}
197}
198
199static void
200print_temp(uint16_t t)
201{
202	printf("%u K, %2.2f C, %3.2f F\n", t, (float)t - 273.15, (float)t * 9 / 5 - 459.67);
203}
204
205
206static void
207print_log_health(void *buf, uint32_t size __unused)
208{
209	struct nvme_health_information_page *health = buf;
210	char cbuf[UINT128_DIG + 1];
211	int i;
212
213	printf("SMART/Health Information Log\n");
214	printf("============================\n");
215
216	printf("Critical Warning State:         0x%02x\n",
217	    health->critical_warning.raw);
218	printf(" Available spare:               %d\n",
219	    health->critical_warning.bits.available_spare);
220	printf(" Temperature:                   %d\n",
221	    health->critical_warning.bits.temperature);
222	printf(" Device reliability:            %d\n",
223	    health->critical_warning.bits.device_reliability);
224	printf(" Read only:                     %d\n",
225	    health->critical_warning.bits.read_only);
226	printf(" Volatile memory backup:        %d\n",
227	    health->critical_warning.bits.volatile_memory_backup);
228	printf("Temperature:                    ");
229	print_temp(health->temperature);
230	printf("Available spare:                %u\n",
231	    health->available_spare);
232	printf("Available spare threshold:      %u\n",
233	    health->available_spare_threshold);
234	printf("Percentage used:                %u\n",
235	    health->percentage_used);
236
237	printf("Data units (512,000 byte) read: %s\n",
238	    uint128_to_str(to128(health->data_units_read), cbuf, sizeof(cbuf)));
239	printf("Data units written:             %s\n",
240	    uint128_to_str(to128(health->data_units_written), cbuf, sizeof(cbuf)));
241	printf("Host read commands:             %s\n",
242	    uint128_to_str(to128(health->host_read_commands), cbuf, sizeof(cbuf)));
243	printf("Host write commands:            %s\n",
244	    uint128_to_str(to128(health->host_write_commands), cbuf, sizeof(cbuf)));
245	printf("Controller busy time (minutes): %s\n",
246	    uint128_to_str(to128(health->controller_busy_time), cbuf, sizeof(cbuf)));
247	printf("Power cycles:                   %s\n",
248	    uint128_to_str(to128(health->power_cycles), cbuf, sizeof(cbuf)));
249	printf("Power on hours:                 %s\n",
250	    uint128_to_str(to128(health->power_on_hours), cbuf, sizeof(cbuf)));
251	printf("Unsafe shutdowns:               %s\n",
252	    uint128_to_str(to128(health->unsafe_shutdowns), cbuf, sizeof(cbuf)));
253	printf("Media errors:                   %s\n",
254	    uint128_to_str(to128(health->media_errors), cbuf, sizeof(cbuf)));
255	printf("No. error info log entries:     %s\n",
256	    uint128_to_str(to128(health->num_error_info_log_entries), cbuf, sizeof(cbuf)));
257
258	printf("Warning Temp Composite Time:    %d\n", health->warning_temp_time);
259	printf("Error Temp Composite Time:      %d\n", health->error_temp_time);
260	for (i = 0; i < 7; i++) {
261		if (health->temp_sensor[i] == 0)
262			continue;
263		printf("Temperature Sensor %d:           ", i + 1);
264		print_temp(health->temp_sensor[i]);
265	}
266}
267
268static void
269print_log_firmware(void *buf, uint32_t size __unused)
270{
271	int				i;
272	const char			*status;
273	struct nvme_firmware_page	*fw = buf;
274
275	printf("Firmware Slot Log\n");
276	printf("=================\n");
277
278	for (i = 0; i < MAX_FW_SLOTS; i++) {
279		printf("Slot %d: ", i + 1);
280		if (fw->afi.slot == i + 1)
281			status = "  Active";
282		else
283			status = "Inactive";
284
285		if (fw->revision[i] == 0LLU)
286			printf("Empty\n");
287		else
288			if (isprint(*(char *)&fw->revision[i]))
289				printf("[%s] %.8s\n", status,
290				    (char *)&fw->revision[i]);
291			else
292				printf("[%s] %016jx\n", status,
293				    fw->revision[i]);
294	}
295}
296
297/*
298 * Intel specific log pages from
299 * http://www.intel.com/content/dam/www/public/us/en/documents/product-specifications/ssd-dc-p3700-spec.pdf
300 *
301 * Though the version as of this date has a typo for the size of log page 0xca,
302 * offset 147: it is only 1 byte, not 6.
303 */
304static void
305print_intel_temp_stats(void *buf, uint32_t size __unused)
306{
307	struct intel_log_temp_stats	*temp = buf;
308
309	printf("Intel Temperature Log\n");
310	printf("=====================\n");
311
312	printf("Current:                        ");
313	print_temp(temp->current);
314	printf("Overtemp Last Flags             %#jx\n", (uintmax_t)temp->overtemp_flag_last);
315	printf("Overtemp Lifetime Flags         %#jx\n", (uintmax_t)temp->overtemp_flag_life);
316	printf("Max Temperature                 ");
317	print_temp(temp->max_temp);
318	printf("Min Temperature                 ");
319	print_temp(temp->min_temp);
320	printf("Max Operating Temperature       ");
321	print_temp(temp->max_oper_temp);
322	printf("Min Operating Temperature       ");
323	print_temp(temp->min_oper_temp);
324	printf("Estimated Temperature Offset:   %ju C/K\n", (uintmax_t)temp->est_offset);
325}
326
327/*
328 * Format from Table 22, section 5.7 IO Command Latency Statistics.
329 * Read and write stats pages have identical encoding.
330 */
331static void
332print_intel_read_write_lat_log(void *buf, uint32_t size __unused)
333{
334	const char *walker = buf;
335	int i;
336
337	printf("Major:                         %d\n", le16dec(walker + 0));
338	printf("Minor:                         %d\n", le16dec(walker + 2));
339	for (i = 0; i < 32; i++)
340		printf("%4dus-%4dus:                 %ju\n", i * 32, (i + 1) * 32, (uintmax_t)le32dec(walker + 4 + i * 4));
341	for (i = 1; i < 32; i++)
342		printf("%4dms-%4dms:                 %ju\n", i, i + 1, (uintmax_t)le32dec(walker + 132 + i * 4));
343	for (i = 1; i < 32; i++)
344		printf("%4dms-%4dms:                 %ju\n", i * 32, (i + 1) * 32, (uintmax_t)le32dec(walker + 256 + i * 4));
345}
346
347static void
348print_intel_read_lat_log(void *buf, uint32_t size)
349{
350
351	printf("Intel Read Latency Log\n");
352	printf("======================\n");
353	print_intel_read_write_lat_log(buf, size);
354}
355
356static void
357print_intel_write_lat_log(void *buf, uint32_t size)
358{
359
360	printf("Intel Write Latency Log\n");
361	printf("=======================\n");
362	print_intel_read_write_lat_log(buf, size);
363}
364
365/*
366 * Table 19. 5.4 SMART Attributes
367 */
368static void
369print_intel_add_smart(void *buf, uint32_t size __unused)
370{
371	uint8_t *walker = buf;
372	uint8_t *end = walker + 150;
373	const char *name;
374	uint64_t raw;
375	uint8_t normalized;
376
377	static struct kv_name kv[] =
378	{
379		{ 0xab, "Program Fail Count" },
380		{ 0xac, "Erase Fail Count" },
381		{ 0xad, "Wear Leveling Count" },
382		{ 0xb8, "End to End Error Count" },
383		{ 0xc7, "CRC Error Count" },
384		{ 0xe2, "Timed: Media Wear" },
385		{ 0xe3, "Timed: Host Read %" },
386		{ 0xe4, "Timed: Elapsed Time" },
387		{ 0xea, "Thermal Throttle Status" },
388		{ 0xf0, "Retry Buffer Overflows" },
389		{ 0xf3, "PLL Lock Loss Count" },
390		{ 0xf4, "NAND Bytes Written" },
391		{ 0xf5, "Host Bytes Written" },
392	};
393
394	printf("Additional SMART Data Log\n");
395	printf("=========================\n");
396	/*
397	 * walker[0] = Key
398	 * walker[1,2] = reserved
399	 * walker[3] = Normalized Value
400	 * walker[4] = reserved
401	 * walker[5..10] = Little Endian Raw value
402	 *	(or other represenations)
403	 * walker[11] = reserved
404	 */
405	while (walker < end) {
406		name = kv_lookup(kv, nitems(kv), *walker);
407		normalized = walker[3];
408		raw = le48dec(walker + 5);
409		switch (*walker){
410		case 0:
411			break;
412		case 0xad:
413			printf("%-32s: %3d min: %u max: %u ave: %u\n", name, normalized,
414			    le16dec(walker + 5), le16dec(walker + 7), le16dec(walker + 9));
415			break;
416		case 0xe2:
417			printf("%-32s: %3d %.3f%%\n", name, normalized, raw / 1024.0);
418			break;
419		case 0xea:
420			printf("%-32s: %3d %d%% %d times\n", name, normalized, walker[5], le32dec(walker+6));
421			break;
422		default:
423			printf("%-32s: %3d %ju\n", name, normalized, (uintmax_t)raw);
424			break;
425		}
426		walker += 12;
427	}
428}
429
430/*
431 * HGST's 0xc1 page. This is a grab bag of additional data. Please see
432 * https://www.hgst.com/sites/default/files/resources/US_SN150_ProdManual.pdf
433 * https://www.hgst.com/sites/default/files/resources/US_SN100_ProdManual.pdf
434 * Appendix A for details
435 */
436
437typedef void (*subprint_fn_t)(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
438
439struct subpage_print
440{
441	uint16_t key;
442	subprint_fn_t fn;
443};
444
445static void print_hgst_info_write_errors(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
446static void print_hgst_info_read_errors(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
447static void print_hgst_info_verify_errors(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
448static void print_hgst_info_self_test(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
449static void print_hgst_info_background_scan(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
450static void print_hgst_info_erase_errors(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
451static void print_hgst_info_erase_counts(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
452static void print_hgst_info_temp_history(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
453static void print_hgst_info_ssd_perf(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
454static void print_hgst_info_firmware_load(void *buf, uint16_t subtype, uint8_t res, uint32_t size);
455
456static struct subpage_print hgst_subpage[] = {
457	{ 0x02, print_hgst_info_write_errors },
458	{ 0x03, print_hgst_info_read_errors },
459	{ 0x05, print_hgst_info_verify_errors },
460	{ 0x10, print_hgst_info_self_test },
461	{ 0x15, print_hgst_info_background_scan },
462	{ 0x30, print_hgst_info_erase_errors },
463	{ 0x31, print_hgst_info_erase_counts },
464	{ 0x32, print_hgst_info_temp_history },
465	{ 0x37, print_hgst_info_ssd_perf },
466	{ 0x38, print_hgst_info_firmware_load },
467};
468
469/* Print a subpage that is basically just key value pairs */
470static void
471print_hgst_info_subpage_gen(void *buf, uint16_t subtype __unused, uint32_t size,
472    const struct kv_name *kv, size_t kv_count)
473{
474	uint8_t *wsp, *esp;
475	uint16_t ptype;
476	uint8_t plen;
477	uint64_t param;
478	int i;
479
480	wsp = buf;
481	esp = wsp + size;
482	while (wsp < esp) {
483		ptype = le16dec(wsp);
484		wsp += 2;
485		wsp++;			/* Flags, just ignore */
486		plen = *wsp++;
487		param = 0;
488		for (i = 0; i < plen; i++)
489			param |= (uint64_t)*wsp++ << (i * 8);
490		printf("  %-30s: %jd\n", kv_lookup(kv, kv_count, ptype), (uintmax_t)param);
491	}
492}
493
494static void
495print_hgst_info_write_errors(void *buf, uint16_t subtype, uint8_t res __unused, uint32_t size)
496{
497	static struct kv_name kv[] =
498	{
499		{ 0x0000, "Corrected Without Delay" },
500		{ 0x0001, "Corrected Maybe Delayed" },
501		{ 0x0002, "Re-Writes" },
502		{ 0x0003, "Errors Corrected" },
503		{ 0x0004, "Correct Algorithm Used" },
504		{ 0x0005, "Bytes Processed" },
505		{ 0x0006, "Uncorrected Errors" },
506		{ 0x8000, "Flash Write Commands" },
507		{ 0x8001, "HGST Special" },
508	};
509
510	printf("Write Errors Subpage:\n");
511	print_hgst_info_subpage_gen(buf, subtype, size, kv, nitems(kv));
512}
513
514static void
515print_hgst_info_read_errors(void *buf, uint16_t subtype, uint8_t res __unused, uint32_t size)
516{
517	static struct kv_name kv[] =
518	{
519		{ 0x0000, "Corrected Without Delay" },
520		{ 0x0001, "Corrected Maybe Delayed" },
521		{ 0x0002, "Re-Reads" },
522		{ 0x0003, "Errors Corrected" },
523		{ 0x0004, "Correct Algorithm Used" },
524		{ 0x0005, "Bytes Processed" },
525		{ 0x0006, "Uncorrected Errors" },
526		{ 0x8000, "Flash Read Commands" },
527		{ 0x8001, "XOR Recovered" },
528		{ 0x8002, "Total Corrected Bits" },
529	};
530
531	printf("Read Errors Subpage:\n");
532	print_hgst_info_subpage_gen(buf, subtype, size, kv, nitems(kv));
533}
534
535static void
536print_hgst_info_verify_errors(void *buf, uint16_t subtype, uint8_t res __unused, uint32_t size)
537{
538	static struct kv_name kv[] =
539	{
540		{ 0x0000, "Corrected Without Delay" },
541		{ 0x0001, "Corrected Maybe Delayed" },
542		{ 0x0002, "Re-Reads" },
543		{ 0x0003, "Errors Corrected" },
544		{ 0x0004, "Correct Algorithm Used" },
545		{ 0x0005, "Bytes Processed" },
546		{ 0x0006, "Uncorrected Errors" },
547		{ 0x8000, "Commands Processed" },
548	};
549
550	printf("Verify Errors Subpage:\n");
551	print_hgst_info_subpage_gen(buf, subtype, size, kv, nitems(kv));
552}
553
554static void
555print_hgst_info_self_test(void *buf, uint16_t subtype __unused, uint8_t res __unused, uint32_t size)
556{
557	size_t i;
558	uint8_t *walker = buf;
559	uint16_t code, hrs;
560	uint32_t lba;
561
562	printf("Self Test Subpage:\n");
563	for (i = 0; i < size / 20; i++) {	/* Each entry is 20 bytes */
564		code = le16dec(walker);
565		walker += 2;
566		walker++;			/* Ignore fixed flags */
567		if (*walker == 0)		/* Last entry is zero length */
568			break;
569		if (*walker++ != 0x10) {
570			printf("Bad length for self test report\n");
571			return;
572		}
573		printf("  %-30s: %d\n", "Recent Test", code);
574		printf("    %-28s: %#x\n", "Self-Test Results", *walker & 0xf);
575		printf("    %-28s: %#x\n", "Self-Test Code", (*walker >> 5) & 0x7);
576		walker++;
577		printf("    %-28s: %#x\n", "Self-Test Number", *walker++);
578		hrs = le16dec(walker);
579		walker += 2;
580		lba = le32dec(walker);
581		walker += 4;
582		printf("    %-28s: %u\n", "Total Power On Hrs", hrs);
583		printf("    %-28s: %#jx (%jd)\n", "LBA", (uintmax_t)lba, (uintmax_t)lba);
584		printf("    %-28s: %#x\n", "Sense Key", *walker++ & 0xf);
585		printf("    %-28s: %#x\n", "Additional Sense Code", *walker++);
586		printf("    %-28s: %#x\n", "Additional Sense Qualifier", *walker++);
587		printf("    %-28s: %#x\n", "Vendor Specific Detail", *walker++);
588	}
589}
590
591static void
592print_hgst_info_background_scan(void *buf, uint16_t subtype __unused, uint8_t res __unused, uint32_t size)
593{
594	uint8_t *walker = buf;
595	uint8_t status;
596	uint16_t code, nscan, progress;
597	uint32_t pom, nand;
598
599	printf("Background Media Scan Subpage:\n");
600	/* Decode the header */
601	code = le16dec(walker);
602	walker += 2;
603	walker++;			/* Ignore fixed flags */
604	if (*walker++ != 0x10) {
605		printf("Bad length for background scan header\n");
606		return;
607	}
608	if (code != 0) {
609		printf("Expceted code 0, found code %#x\n", code);
610		return;
611	}
612	pom = le32dec(walker);
613	walker += 4;
614	walker++;			/* Reserved */
615	status = *walker++;
616	nscan = le16dec(walker);
617	walker += 2;
618	progress = le16dec(walker);
619	walker += 2;
620	walker += 6;			/* Reserved */
621	printf("  %-30s: %d\n", "Power On Minutes", pom);
622	printf("  %-30s: %x (%s)\n", "BMS Status", status,
623	    status == 0 ? "idle" : (status == 1 ? "active" : (status == 8 ? "suspended" : "unknown")));
624	printf("  %-30s: %d\n", "Number of BMS", nscan);
625	printf("  %-30s: %d\n", "Progress Current BMS", progress);
626	/* Report retirements */
627	if (walker - (uint8_t *)buf != 20) {
628		printf("Coding error, offset not 20\n");
629		return;
630	}
631	size -= 20;
632	printf("  %-30s: %d\n", "BMS retirements", size / 0x18);
633	while (size > 0) {
634		code = le16dec(walker);
635		walker += 2;
636		walker++;
637		if (*walker++ != 0x14) {
638			printf("Bad length parameter\n");
639			return;
640		}
641		pom = le32dec(walker);
642		walker += 4;
643		/*
644		 * Spec sheet says the following are hard coded, if true, just
645		 * print the NAND retirement.
646		 */
647		if (walker[0] == 0x41 &&
648		    walker[1] == 0x0b &&
649		    walker[2] == 0x01 &&
650		    walker[3] == 0x00 &&
651		    walker[4] == 0x00 &&
652		    walker[5] == 0x00 &&
653		    walker[6] == 0x00 &&
654		    walker[7] == 0x00) {
655			walker += 8;
656			walker += 4;	/* Skip reserved */
657			nand = le32dec(walker);
658			walker += 4;
659			printf("  %-30s: %d\n", "Retirement number", code);
660			printf("    %-28s: %#x\n", "NAND (C/T)BBBPPP", nand);
661		} else {
662			printf("Parameter %#x entry corrupt\n", code);
663			walker += 16;
664		}
665	}
666}
667
668static void
669print_hgst_info_erase_errors(void *buf, uint16_t subtype __unused, uint8_t res __unused, uint32_t size)
670{
671	static struct kv_name kv[] =
672	{
673		{ 0x0000, "Corrected Without Delay" },
674		{ 0x0001, "Corrected Maybe Delayed" },
675		{ 0x0002, "Re-Erase" },
676		{ 0x0003, "Errors Corrected" },
677		{ 0x0004, "Correct Algorithm Used" },
678		{ 0x0005, "Bytes Processed" },
679		{ 0x0006, "Uncorrected Errors" },
680		{ 0x8000, "Flash Erase Commands" },
681		{ 0x8001, "Mfg Defect Count" },
682		{ 0x8002, "Grown Defect Count" },
683		{ 0x8003, "Erase Count -- User" },
684		{ 0x8004, "Erase Count -- System" },
685	};
686
687	printf("Erase Errors Subpage:\n");
688	print_hgst_info_subpage_gen(buf, subtype, size, kv, nitems(kv));
689}
690
691static void
692print_hgst_info_erase_counts(void *buf, uint16_t subtype, uint8_t res __unused, uint32_t size)
693{
694	/* My drive doesn't export this -- so not coding up */
695	printf("XXX: Erase counts subpage: %p, %#x %d\n", buf, subtype, size);
696}
697
698static void
699print_hgst_info_temp_history(void *buf, uint16_t subtype __unused, uint8_t res __unused, uint32_t size __unused)
700{
701	uint8_t *walker = buf;
702	uint32_t min;
703
704	printf("Temperature History:\n");
705	printf("  %-30s: %d C\n", "Current Temperature", *walker++);
706	printf("  %-30s: %d C\n", "Reference Temperature", *walker++);
707	printf("  %-30s: %d C\n", "Maximum Temperature", *walker++);
708	printf("  %-30s: %d C\n", "Minimum Temperature", *walker++);
709	min = le32dec(walker);
710	walker += 4;
711	printf("  %-30s: %d:%02d:00\n", "Max Temperture Time", min / 60, min % 60);
712	min = le32dec(walker);
713	walker += 4;
714	printf("  %-30s: %d:%02d:00\n", "Over Temperture Duration", min / 60, min % 60);
715	min = le32dec(walker);
716	walker += 4;
717	printf("  %-30s: %d:%02d:00\n", "Min Temperture Time", min / 60, min % 60);
718}
719
720static void
721print_hgst_info_ssd_perf(void *buf, uint16_t subtype __unused, uint8_t res, uint32_t size __unused)
722{
723	uint8_t *walker = buf;
724	uint64_t val;
725
726	printf("SSD Performance Subpage Type %d:\n", res);
727	val = le64dec(walker);
728	walker += 8;
729	printf("  %-30s: %ju\n", "Host Read Commands", val);
730	val = le64dec(walker);
731	walker += 8;
732	printf("  %-30s: %ju\n", "Host Read Blocks", val);
733	val = le64dec(walker);
734	walker += 8;
735	printf("  %-30s: %ju\n", "Host Cache Read Hits Commands", val);
736	val = le64dec(walker);
737	walker += 8;
738	printf("  %-30s: %ju\n", "Host Cache Read Hits Blocks", val);
739	val = le64dec(walker);
740	walker += 8;
741	printf("  %-30s: %ju\n", "Host Read Commands Stalled", val);
742	val = le64dec(walker);
743	walker += 8;
744	printf("  %-30s: %ju\n", "Host Write Commands", val);
745	val = le64dec(walker);
746	walker += 8;
747	printf("  %-30s: %ju\n", "Host Write Blocks", val);
748	val = le64dec(walker);
749	walker += 8;
750	printf("  %-30s: %ju\n", "Host Write Odd Start Commands", val);
751	val = le64dec(walker);
752	walker += 8;
753	printf("  %-30s: %ju\n", "Host Write Odd End Commands", val);
754	val = le64dec(walker);
755	walker += 8;
756	printf("  %-30s: %ju\n", "Host Write Commands Stalled", val);
757	val = le64dec(walker);
758	walker += 8;
759	printf("  %-30s: %ju\n", "NAND Read Commands", val);
760	val = le64dec(walker);
761	walker += 8;
762	printf("  %-30s: %ju\n", "NAND Read Blocks", val);
763	val = le64dec(walker);
764	walker += 8;
765	printf("  %-30s: %ju\n", "NAND Write Commands", val);
766	val = le64dec(walker);
767	walker += 8;
768	printf("  %-30s: %ju\n", "NAND Write Blocks", val);
769	val = le64dec(walker);
770	walker += 8;
771	printf("  %-30s: %ju\n", "NAND Read Before Writes", val);
772}
773
774static void
775print_hgst_info_firmware_load(void *buf, uint16_t subtype __unused, uint8_t res __unused, uint32_t size __unused)
776{
777	uint8_t *walker = buf;
778
779	printf("Firmware Load Subpage:\n");
780	printf("  %-30s: %d\n", "Firmware Downloads", le32dec(walker));
781}
782
783static void
784kv_indirect(void *buf, uint32_t subtype, uint8_t res, uint32_t size, struct subpage_print *sp, size_t nsp)
785{
786	size_t i;
787
788	for (i = 0; i < nsp; i++, sp++) {
789		if (sp->key == subtype) {
790			sp->fn(buf, subtype, res, size);
791			return;
792		}
793	}
794	printf("No handler for page type %x\n", subtype);
795}
796
797static void
798print_hgst_info_log(void *buf, uint32_t size __unused)
799{
800	uint8_t	*walker, *end, *subpage;
801	int pages;
802	uint16_t len;
803	uint8_t subtype, res;
804
805	printf("HGST Extra Info Log\n");
806	printf("===================\n");
807
808	walker = buf;
809	pages = *walker++;
810	walker++;
811	len = le16dec(walker);
812	walker += 2;
813	end = walker + len;		/* Length is exclusive of this header */
814
815	while (walker < end) {
816		subpage = walker + 4;
817		subtype = *walker++ & 0x3f;	/* subtype */
818		res = *walker++;		/* Reserved */
819		len = le16dec(walker);
820		walker += len + 2;		/* Length, not incl header */
821		if (walker > end) {
822			printf("Ooops! Off the end of the list\n");
823			break;
824		}
825		kv_indirect(subpage, subtype, res, len, hgst_subpage, nitems(hgst_subpage));
826	}
827}
828
829/*
830 * Table of log page printer / sizing.
831 *
832 * This includes Intel specific pages that are widely implemented. Not
833 * sure how best to switch between different vendors.
834 */
835static struct logpage_function {
836	uint8_t		log_page;
837	const char     *vendor;
838	print_fn_t	print_fn;
839	size_t		size;
840} logfuncs[] = {
841	{NVME_LOG_ERROR,		NULL,	print_log_error,
842	 0},
843	{NVME_LOG_HEALTH_INFORMATION,	NULL,	print_log_health,
844	 sizeof(struct nvme_health_information_page)},
845	{NVME_LOG_FIRMWARE_SLOT,	NULL,	print_log_firmware,
846	 sizeof(struct nvme_firmware_page)},
847	{HGST_INFO_LOG,			"hgst",	print_hgst_info_log,
848	 DEFAULT_SIZE},
849	{HGST_INFO_LOG,			"wdc",	print_hgst_info_log,
850	 DEFAULT_SIZE},
851	{INTEL_LOG_TEMP_STATS,		"intel", print_intel_temp_stats,
852	 sizeof(struct intel_log_temp_stats)},
853	{INTEL_LOG_READ_LAT_LOG,	"intel", print_intel_read_lat_log,
854	 DEFAULT_SIZE},
855	{INTEL_LOG_WRITE_LAT_LOG,	"intel", print_intel_write_lat_log,
856	 DEFAULT_SIZE},
857	{INTEL_LOG_ADD_SMART,		"intel", print_intel_add_smart,
858	 DEFAULT_SIZE},
859	{0,				NULL,	NULL,	 0},
860};
861
862static void
863logpage_usage(void)
864{
865	fprintf(stderr, "usage:\n");
866	fprintf(stderr, LOGPAGE_USAGE);
867	exit(1);
868}
869
870void
871logpage(int argc, char *argv[])
872{
873	int				fd, nsid;
874	int				log_page = 0, pageflag = false;
875	int				hexflag = false, ns_specified;
876	char				ch, *p;
877	char				cname[64];
878	uint32_t			size;
879	void				*buf;
880	const char			*vendor = NULL;
881	struct logpage_function		*f;
882	struct nvme_controller_data	cdata;
883	print_fn_t			print_fn;
884
885	while ((ch = getopt(argc, argv, "p:xv:")) != -1) {
886		switch (ch) {
887		case 'p':
888			/* TODO: Add human-readable ASCII page IDs */
889			log_page = strtol(optarg, &p, 0);
890			if (p != NULL && *p != '\0') {
891				fprintf(stderr,
892				    "\"%s\" not valid log page id.\n",
893				    optarg);
894				logpage_usage();
895			}
896			pageflag = true;
897			break;
898		case 'x':
899			hexflag = true;
900			break;
901		case 'v':
902			vendor = optarg;
903			break;
904		}
905	}
906
907	if (!pageflag) {
908		printf("Missing page_id (-p).\n");
909		logpage_usage();
910	}
911
912	/* Check that a controller and/or namespace was specified. */
913	if (optind >= argc)
914		logpage_usage();
915
916	if (strstr(argv[optind], NVME_NS_PREFIX) != NULL) {
917		ns_specified = true;
918		parse_ns_str(argv[optind], cname, &nsid);
919		open_dev(cname, &fd, 1, 1);
920	} else {
921		ns_specified = false;
922		nsid = NVME_GLOBAL_NAMESPACE_TAG;
923		open_dev(argv[optind], &fd, 1, 1);
924	}
925
926	read_controller_data(fd, &cdata);
927
928	/*
929	 * The log page attribtues indicate whether or not the controller
930	 * supports the SMART/Health information log page on a per
931	 * namespace basis.
932	 */
933	if (ns_specified) {
934		if (log_page != NVME_LOG_HEALTH_INFORMATION)
935			errx(1, "log page %d valid only at controller level",
936			    log_page);
937		if (cdata.lpa.ns_smart == 0)
938			errx(1,
939			    "controller does not support per namespace "
940			    "smart/health information");
941	}
942
943	print_fn = print_hex;
944	size = DEFAULT_SIZE;
945	if (!hexflag) {
946		/*
947		 * See if there is a pretty print function for the specified log
948		 * page.  If one isn't found, we just revert to the default
949		 * (print_hex). If there was a vendor specified bt the user, and
950		 * the page is vendor specific, don't match the print function
951		 * unless the vendors match.
952		 */
953		for (f = logfuncs; f->log_page > 0; f++) {
954			if (f->vendor != NULL && vendor != NULL &&
955			    strcmp(f->vendor, vendor) != 0)
956				continue;
957			if (log_page != f->log_page)
958				continue;
959			print_fn = f->print_fn;
960			size = f->size;
961			break;
962		}
963	}
964
965	if (log_page == NVME_LOG_ERROR) {
966		size = sizeof(struct nvme_error_information_entry);
967		size *= (cdata.elpe + 1);
968	}
969
970	/* Read the log page */
971	buf = get_log_buffer(size);
972	read_logpage(fd, log_page, nsid, buf, size);
973	print_fn(buf, size);
974
975	close(fd);
976	exit(0);
977}
978