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 */