1 /*- 2 * SPDX-License-Identifier: BSD-3-Clause 3 * 4 * Copyright (c) 2008 Yahoo!, Inc. 5 * All rights reserved. 6 * Written by: John Baldwin <jhb@FreeBSD.org> 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 * 3. Neither the name of the author nor the names of any co-contributors 17 * may be used to endorse or promote products derived from this software 18 * without specific prior written permission. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30 * SUCH DAMAGE. 31 * 32 * $FreeBSD$ 33 */ 34 35 #ifndef __MPTUTIL_H__ 36 #define __MPTUTIL_H__ 37 38 #include <sys/cdefs.h> 39 #include <sys/linker_set.h> 40 41 #include <dev/mpt/mpilib/mpi_type.h> 42 #include <dev/mpt/mpilib/mpi.h> 43 #include <dev/mpt/mpilib/mpi_cnfg.h> 44 #include <dev/mpt/mpilib/mpi_raid.h> 45 46 #define IOC_STATUS_SUCCESS(status) \ 47 (((status) & MPI_IOCSTATUS_MASK) == MPI_IOCSTATUS_SUCCESS) 48 49 struct mpt_query_disk { 50 char devname[SPECNAMELEN + 1]; 51 }; 52 53 struct mpt_standalone_disk { 54 uint64_t maxlba; 55 char inqstring[64]; 56 char devname[SPECNAMELEN + 1]; 57 u_int bus; 58 u_int target; 59 }; 60 61 struct mpt_drive_list { 62 int ndrives; 63 CONFIG_PAGE_RAID_PHYS_DISK_0 *drives[0]; 64 }; 65 66 struct mptutil_command { 67 const char *name; 68 int (*handler)(int ac, char **av); 69 }; 70 71 #define MPT_DATASET(name) mptutil_ ## name ## _table 72 73 #define MPT_COMMAND(set, name, function) \ 74 static struct mptutil_command function ## _mptutil_command = \ 75 { #name, function }; \ 76 DATA_SET(MPT_DATASET(set), function ## _mptutil_command) 77 78 #define MPT_TABLE(set, name) \ 79 SET_DECLARE(MPT_DATASET(name), struct mptutil_command); \ 80 \ 81 static int \ 82 mptutil_ ## name ## _table_handler(int ac, char **av) \ 83 { \ 84 return (mpt_table_handler(SET_BEGIN(MPT_DATASET(name)), \ 85 SET_LIMIT(MPT_DATASET(name)), ac, av)); \ 86 } \ 87 MPT_COMMAND(set, name, mptutil_ ## name ## _table_handler) 88 89 extern int mpt_unit; 90 91 #ifdef DEBUG 92 void hexdump(const void *ptr, int length, const char *hdr, int flags); 93 #define HD_COLUMN_MASK 0xff 94 #define HD_DELIM_MASK 0xff00 95 #define HD_OMIT_COUNT (1 << 16) 96 #define HD_OMIT_HEX (1 << 17) 97 #define HD_OMIT_CHARS (1 << 18) 98 #endif 99 100 int mpt_table_handler(struct mptutil_command **start, 101 struct mptutil_command **end, int ac, char **av); 102 int mpt_read_config_page_header(int fd, U8 PageType, U8 PageNumber, 103 U32 PageAddress, CONFIG_PAGE_HEADER *header, U16 *IOCStatus); 104 void *mpt_read_config_page(int fd, U8 PageType, U8 PageNumber, 105 U32 PageAddress, U16 *IOCStatus); 106 void *mpt_read_extended_config_page(int fd, U8 ExtPageType, U8 PageVersion, 107 U8 PageNumber, U32 PageAddress, U16 *IOCStatus); 108 int mpt_write_config_page(int fd, void *buf, U16 *IOCStatus); 109 const char *mpt_ioc_status(U16 IOCStatus); 110 int mpt_raid_action(int fd, U8 Action, U8 VolumeBus, U8 VolumeID, 111 U8 PhysDiskNum, U32 ActionDataWord, void *buf, int len, 112 RAID_VOL0_STATUS *VolumeStatus, U32 *ActionData, int datalen, 113 U16 *IOCStatus, U16 *ActionStatus, int write); 114 const char *mpt_raid_status(U16 ActionStatus); 115 int mpt_open(int unit); 116 const char *mpt_raid_level(U8 VolumeType); 117 const char *mpt_volstate(U8 State); 118 const char *mpt_pdstate(CONFIG_PAGE_RAID_PHYS_DISK_0 *info); 119 const char *mpt_pd_inq_string(CONFIG_PAGE_RAID_PHYS_DISK_0 *pd_info); 120 struct mpt_drive_list *mpt_pd_list(int fd); 121 void mpt_free_pd_list(struct mpt_drive_list *list); 122 int mpt_query_disk(U8 VolumeBus, U8 VolumeID, struct mpt_query_disk *qd); 123 const char *mpt_volume_name(U8 VolumeBus, U8 VolumeID); 124 int mpt_fetch_disks(int fd, int *ndisks, 125 struct mpt_standalone_disk **disksp); 126 int mpt_lock_volume(U8 VolumeBus, U8 VolumeID); 127 int mpt_lookup_drive(struct mpt_drive_list *list, const char *drive, 128 U8 *PhysDiskNum); 129 int mpt_lookup_volume(int fd, const char *name, U8 *VolumeBus, 130 U8 *VolumeID); 131 int mpt_rescan_bus(int bus, int id); 132 133 static __inline void * 134 mpt_read_man_page(int fd, U8 PageNumber, U16 *IOCStatus) 135 { 136 137 return (mpt_read_config_page(fd, MPI_CONFIG_PAGETYPE_MANUFACTURING, 138 PageNumber, 0, IOCStatus)); 139 } 140 141 static __inline void * 142 mpt_read_ioc_page(int fd, U8 PageNumber, U16 *IOCStatus) 143 { 144 145 return (mpt_read_config_page(fd, MPI_CONFIG_PAGETYPE_IOC, PageNumber, 146 0, IOCStatus)); 147 } 148 149 static __inline U32 150 mpt_vol_pageaddr(U8 VolumeBus, U8 VolumeID) 151 { 152 153 return (VolumeBus << 8 | VolumeID); 154 } 155 156 static __inline CONFIG_PAGE_RAID_VOL_0 * 157 mpt_vol_info(int fd, U8 VolumeBus, U8 VolumeID, U16 *IOCStatus) 158 { 159 160 return (mpt_read_config_page(fd, MPI_CONFIG_PAGETYPE_RAID_VOLUME, 0, 161 mpt_vol_pageaddr(VolumeBus, VolumeID), IOCStatus)); 162 } 163 164 static __inline CONFIG_PAGE_RAID_VOL_1 * 165 mpt_vol_names(int fd, U8 VolumeBus, U8 VolumeID, U16 *IOCStatus) 166 { 167 168 return (mpt_read_config_page(fd, MPI_CONFIG_PAGETYPE_RAID_VOLUME, 1, 169 mpt_vol_pageaddr(VolumeBus, VolumeID), IOCStatus)); 170 } 171 172 static __inline CONFIG_PAGE_RAID_PHYS_DISK_0 * 173 mpt_pd_info(int fd, U8 PhysDiskNum, U16 *IOCStatus) 174 { 175 176 return (mpt_read_config_page(fd, MPI_CONFIG_PAGETYPE_RAID_PHYSDISK, 0, 177 PhysDiskNum, IOCStatus)); 178 } 179 180 #endif /* !__MPTUTIL_H__ */ 181