1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2 /* 3 md_u.h : user <=> kernel API between Linux raidtools and RAID drivers 4 Copyright (C) 1998 Ingo Molnar 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 2, or (at your option) 9 any later version. 10 11 You should have received a copy of the GNU General Public License 12 (for example /usr/src/linux/COPYING); if not, write to the Free 13 Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 14 */ 15 16 #ifndef _UAPI_MD_U_H 17 #define _UAPI_MD_U_H 18 19 /* 20 * Different major versions are not compatible. 21 * Different minor versions are only downward compatible. 22 * Different patchlevel versions are downward and upward compatible. 23 */ 24 #define MD_MAJOR_VERSION 0 25 #define MD_MINOR_VERSION 90 26 /* 27 * MD_PATCHLEVEL_VERSION indicates kernel functionality. 28 * >=1 means different superblock formats are selectable using SET_ARRAY_INFO 29 * and major_version/minor_version accordingly 30 * >=2 means that Internal bitmaps are supported by setting MD_SB_BITMAP_PRESENT 31 * in the super status byte 32 * >=3 means that bitmap superblock version 4 is supported, which uses 33 * little-ending representation rather than host-endian 34 */ 35 #define MD_PATCHLEVEL_VERSION 3 36 37 /* ioctls */ 38 39 /* status */ 40 #define RAID_VERSION _IOR (MD_MAJOR, 0x10, mdu_version_t) 41 #define GET_ARRAY_INFO _IOR (MD_MAJOR, 0x11, mdu_array_info_t) 42 #define GET_DISK_INFO _IOR (MD_MAJOR, 0x12, mdu_disk_info_t) 43 #define RAID_AUTORUN _IO (MD_MAJOR, 0x14) 44 #define GET_BITMAP_FILE _IOR (MD_MAJOR, 0x15, mdu_bitmap_file_t) 45 46 /* configuration */ 47 #define CLEAR_ARRAY _IO (MD_MAJOR, 0x20) 48 #define ADD_NEW_DISK _IOW (MD_MAJOR, 0x21, mdu_disk_info_t) 49 #define HOT_REMOVE_DISK _IO (MD_MAJOR, 0x22) 50 #define SET_ARRAY_INFO _IOW (MD_MAJOR, 0x23, mdu_array_info_t) 51 #define SET_DISK_INFO _IO (MD_MAJOR, 0x24) 52 #define WRITE_RAID_INFO _IO (MD_MAJOR, 0x25) 53 #define UNPROTECT_ARRAY _IO (MD_MAJOR, 0x26) 54 #define PROTECT_ARRAY _IO (MD_MAJOR, 0x27) 55 #define HOT_ADD_DISK _IO (MD_MAJOR, 0x28) 56 #define SET_DISK_FAULTY _IO (MD_MAJOR, 0x29) 57 #define HOT_GENERATE_ERROR _IO (MD_MAJOR, 0x2a) 58 #define SET_BITMAP_FILE _IOW (MD_MAJOR, 0x2b, int) 59 60 /* usage */ 61 #define RUN_ARRAY _IOW (MD_MAJOR, 0x30, mdu_param_t) 62 /* 0x31 was START_ARRAY */ 63 #define STOP_ARRAY _IO (MD_MAJOR, 0x32) 64 #define STOP_ARRAY_RO _IO (MD_MAJOR, 0x33) 65 #define RESTART_ARRAY_RW _IO (MD_MAJOR, 0x34) 66 #define CLUSTERED_DISK_NACK _IO (MD_MAJOR, 0x35) 67 68 /* 63 partitions with the alternate major number (mdp) */ 69 #define MdpMinorShift 6 70 71 typedef struct mdu_version_s { 72 int major; 73 int minor; 74 int patchlevel; 75 } mdu_version_t; 76 77 typedef struct mdu_array_info_s { 78 /* 79 * Generic constant information 80 */ 81 int major_version; 82 int minor_version; 83 int patch_version; 84 unsigned int ctime; 85 int level; 86 int size; 87 int nr_disks; 88 int raid_disks; 89 int md_minor; 90 int not_persistent; 91 92 /* 93 * Generic state information 94 */ 95 unsigned int utime; /* 0 Superblock update time */ 96 int state; /* 1 State bits (clean, ...) */ 97 int active_disks; /* 2 Number of currently active disks */ 98 int working_disks; /* 3 Number of working disks */ 99 int failed_disks; /* 4 Number of failed disks */ 100 int spare_disks; /* 5 Number of spare disks */ 101 102 /* 103 * Personality information 104 */ 105 int layout; /* 0 the array's physical layout */ 106 int chunk_size; /* 1 chunk size in bytes */ 107 108 } mdu_array_info_t; 109 110 /* non-obvious values for 'level' */ 111 #define LEVEL_MULTIPATH (-4) 112 #define LEVEL_LINEAR (-1) 113 #define LEVEL_FAULTY (-5) 114 115 /* we need a value for 'no level specified' and 0 116 * means 'raid0', so we need something else. This is 117 * for internal use only 118 */ 119 #define LEVEL_NONE (-1000000) 120 121 typedef struct mdu_disk_info_s { 122 /* 123 * configuration/status of one particular disk 124 */ 125 int number; 126 int major; 127 int minor; 128 int raid_disk; 129 int state; 130 131 } mdu_disk_info_t; 132 133 typedef struct mdu_start_info_s { 134 /* 135 * configuration/status of one particular disk 136 */ 137 int major; 138 int minor; 139 int raid_disk; 140 int state; 141 142 } mdu_start_info_t; 143 144 typedef struct mdu_bitmap_file_s 145 { 146 char pathname[4096]; 147 } mdu_bitmap_file_t; 148 149 typedef struct mdu_param_s 150 { 151 int personality; /* 1,2,3,4 */ 152 int chunk_size; /* in bytes */ 153 int max_fault; /* unused for now */ 154 } mdu_param_t; 155 156 #endif /* _UAPI_MD_U_H */ 157