1 /* 2 * This file and its contents are supplied under the terms of the 3 * Common Development and Distribution License ("CDDL"), version 1.0. 4 * You may only use this file in accordance with the terms of version 5 * 1.0 of the CDDL. 6 * 7 * A full copy of the text of the CDDL should have accompanied this 8 * source. A copy of the CDDL is also available via the Internet at 9 * http://www.illumos.org/license/CDDL. 10 */ 11 12 /* 13 * Copyright 2021 Oxide Computer Company 14 * Copyright 2022 Tintri by DDN, Inc. All rights reserved. 15 */ 16 17 #ifndef _NVMEADM_H 18 #define _NVMEADM_H 19 20 #include <stdio.h> 21 #include <libdevinfo.h> 22 #include <sys/nvme.h> 23 #include <nvme_reg.h> 24 #include <ofmt.h> 25 26 #ifdef __cplusplus 27 extern "C" { 28 #endif 29 30 extern int verbose; 31 extern int debug; 32 33 /* Common structures */ 34 typedef struct nvme_process_arg nvme_process_arg_t; 35 typedef struct nvme_feature nvme_feature_t; 36 typedef struct nvmeadm_cmd nvmeadm_cmd_t; 37 38 struct nvme_process_arg { 39 int npa_argc; 40 char **npa_argv; 41 char *npa_name; 42 char *npa_nsid; 43 char *npa_eui64; 44 char *npa_nguid; 45 int npa_found; 46 boolean_t npa_excl; 47 boolean_t npa_isns; 48 boolean_t npa_interactive; 49 uint32_t npa_cmdflags; 50 const nvmeadm_cmd_t *npa_cmd; 51 di_node_t npa_node; 52 di_minor_t npa_minor; 53 char *npa_dsk; 54 uint32_t npa_ns_state; 55 nvme_identify_ctrl_t *npa_idctl; 56 nvme_identify_nsid_t *npa_idns; 57 nvme_identify_nsid_list_t *npa_idnslist; 58 nvme_version_t *npa_version; 59 ofmt_handle_t npa_ofmt; 60 }; 61 62 /* Version checking */ 63 extern boolean_t nvme_version_check(nvme_version_t *, uint_t, uint_t); 64 65 /* printing functions */ 66 extern int nvme_strlen(const char *, int); 67 extern void nvme_print(int, const char *, int, const char *, ...); 68 extern void nvme_print_ctrl_summary(nvme_identify_ctrl_t *, nvme_version_t *); 69 extern void nvme_print_nsid_summary(nvme_identify_nsid_t *); 70 extern void nvme_print_identify_ctrl(nvme_identify_ctrl_t *, 71 nvme_capabilities_t *, nvme_version_t *); 72 extern void nvme_print_identify_nsid(nvme_identify_nsid_t *, nvme_version_t *); 73 extern void nvme_print_identify_nsid_list(const char *, 74 nvme_identify_nsid_list_t *); 75 extern void nvme_print_identify_nsid_desc(void *); 76 extern void nvme_print_identify_ctrl_list(const char *, 77 nvme_identify_ctrl_list_t *); 78 extern void nvme_print_error_log(int, nvme_error_log_entry_t *, 79 nvme_version_t *); 80 extern void nvme_print_health_log(nvme_health_log_t *, nvme_identify_ctrl_t *, 81 nvme_version_t *); 82 extern void nvme_print_fwslot_log(nvme_fwslot_log_t *, nvme_identify_ctrl_t *); 83 84 extern void nvme_print_feat_arbitration(uint64_t, void *, size_t, 85 nvme_identify_ctrl_t *, nvme_version_t *); 86 extern void nvme_print_feat_power_mgmt(uint64_t, void *, size_t, 87 nvme_identify_ctrl_t *, nvme_version_t *); 88 extern void nvme_print_feat_lba_range(uint64_t, void *, size_t, 89 nvme_identify_ctrl_t *, nvme_version_t *); 90 extern void nvme_print_feat_temperature(uint64_t, void *, size_t, 91 nvme_identify_ctrl_t *, nvme_version_t *); 92 extern void nvme_print_feat_error(uint64_t, void *, size_t, 93 nvme_identify_ctrl_t *, nvme_version_t *); 94 extern void nvme_print_feat_write_cache(uint64_t, void *, size_t, 95 nvme_identify_ctrl_t *, nvme_version_t *); 96 extern void nvme_print_feat_nqueues(uint64_t, void *, size_t, 97 nvme_identify_ctrl_t *, nvme_version_t *); 98 extern void nvme_print_feat_intr_coal(uint64_t, void *, size_t, 99 nvme_identify_ctrl_t *, nvme_version_t *); 100 extern void nvme_print_feat_intr_vect(uint64_t, void *, size_t, 101 nvme_identify_ctrl_t *, nvme_version_t *); 102 extern void nvme_print_feat_write_atom(uint64_t, void *, size_t, 103 nvme_identify_ctrl_t *, nvme_version_t *); 104 extern void nvme_print_feat_async_event(uint64_t, void *, size_t, 105 nvme_identify_ctrl_t *, nvme_version_t *); 106 extern void nvme_print_feat_auto_pst(uint64_t, void *, size_t, 107 nvme_identify_ctrl_t *, nvme_version_t *); 108 extern void nvme_print_feat_progress(uint64_t, void *, size_t, 109 nvme_identify_ctrl_t *, nvme_version_t *); 110 extern const char *nvme_fw_error(int, int); 111 112 /* device node functions */ 113 extern int nvme_open(di_minor_t, boolean_t); 114 extern void nvme_close(int); 115 extern nvme_version_t *nvme_version(int); 116 extern nvme_capabilities_t *nvme_capabilities(int); 117 extern void *nvme_identify(int, uint8_t); 118 extern void *nvme_get_logpage(int, uint8_t, size_t *); 119 extern boolean_t nvme_get_feature(int, uint8_t, uint32_t, uint64_t *, size_t *, 120 void **); 121 extern int nvme_intr_cnt(int); 122 extern boolean_t nvme_format_nvm(int, uint8_t, uint8_t); 123 extern boolean_t nvme_detach(int); 124 extern boolean_t nvme_attach(int); 125 extern boolean_t nvme_firmware_load(int, void *, size_t, offset_t, uint16_t *); 126 extern boolean_t nvme_firmware_commit(int, int, int, uint16_t *); 127 extern boolean_t nvme_namespace_state(int); 128 129 /* 130 * ofmt related 131 */ 132 extern const ofmt_field_t nvme_list_ofmt[]; 133 134 #ifdef __cplusplus 135 } 136 #endif 137 138 #endif /* _NVMEADM_H */ 139