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
12 #ifndef _UAPI_MD_U_H
13 #define _UAPI_MD_U_H
14
15 /*
16 * Different major versions are not compatible.
17 * Different minor versions are only downward compatible.
18 * Different patchlevel versions are downward and upward compatible.
19 */
20 #define MD_MAJOR_VERSION 0
21 #define MD_MINOR_VERSION 90
22 /*
23 * MD_PATCHLEVEL_VERSION indicates kernel functionality.
24 * >=1 means different superblock formats are selectable using SET_ARRAY_INFO
25 * and major_version/minor_version accordingly
26 * >=2 means that Internal bitmaps are supported by setting MD_SB_BITMAP_PRESENT
27 * in the super status byte
28 * >=3 means that bitmap superblock version 4 is supported, which uses
29 * little-ending representation rather than host-endian
30 */
31 #define MD_PATCHLEVEL_VERSION 3
32
33 /* ioctls */
34
35 /* status */
36 #define RAID_VERSION _IOR (MD_MAJOR, 0x10, mdu_version_t)
37 #define GET_ARRAY_INFO _IOR (MD_MAJOR, 0x11, mdu_array_info_t)
38 #define GET_DISK_INFO _IOR (MD_MAJOR, 0x12, mdu_disk_info_t)
39 #define RAID_AUTORUN _IO (MD_MAJOR, 0x14)
40 #define GET_BITMAP_FILE _IOR (MD_MAJOR, 0x15, mdu_bitmap_file_t)
41
42 /* configuration */
43 #define CLEAR_ARRAY _IO (MD_MAJOR, 0x20)
44 #define ADD_NEW_DISK _IOW (MD_MAJOR, 0x21, mdu_disk_info_t)
45 #define HOT_REMOVE_DISK _IO (MD_MAJOR, 0x22)
46 #define SET_ARRAY_INFO _IOW (MD_MAJOR, 0x23, mdu_array_info_t)
47 #define SET_DISK_INFO _IO (MD_MAJOR, 0x24)
48 #define WRITE_RAID_INFO _IO (MD_MAJOR, 0x25)
49 #define UNPROTECT_ARRAY _IO (MD_MAJOR, 0x26)
50 #define PROTECT_ARRAY _IO (MD_MAJOR, 0x27)
51 #define HOT_ADD_DISK _IO (MD_MAJOR, 0x28)
52 #define SET_DISK_FAULTY _IO (MD_MAJOR, 0x29)
53 #define HOT_GENERATE_ERROR _IO (MD_MAJOR, 0x2a)
54 #define SET_BITMAP_FILE _IOW (MD_MAJOR, 0x2b, int)
55
56 /* usage */
57 #define RUN_ARRAY _IOW (MD_MAJOR, 0x30, mdu_param_t)
58 /* 0x31 was START_ARRAY */
59 #define STOP_ARRAY _IO (MD_MAJOR, 0x32)
60 #define STOP_ARRAY_RO _IO (MD_MAJOR, 0x33)
61 #define RESTART_ARRAY_RW _IO (MD_MAJOR, 0x34)
62 #define CLUSTERED_DISK_NACK _IO (MD_MAJOR, 0x35)
63
64 /* 63 partitions with the alternate major number (mdp) */
65 #define MdpMinorShift 6
66
67 typedef struct mdu_version_s {
68 int major;
69 int minor;
70 int patchlevel;
71 } mdu_version_t;
72
73 typedef struct mdu_array_info_s {
74 /*
75 * Generic constant information
76 */
77 int major_version;
78 int minor_version;
79 int patch_version;
80 unsigned int ctime;
81 int level;
82 int size;
83 int nr_disks;
84 int raid_disks;
85 int md_minor;
86 int not_persistent;
87
88 /*
89 * Generic state information
90 */
91 unsigned int utime; /* 0 Superblock update time */
92 int state; /* 1 State bits (clean, ...) */
93 int active_disks; /* 2 Number of currently active disks */
94 int working_disks; /* 3 Number of working disks */
95 int failed_disks; /* 4 Number of failed disks */
96 int spare_disks; /* 5 Number of spare disks */
97
98 /*
99 * Personality information
100 */
101 int layout; /* 0 the array's physical layout */
102 int chunk_size; /* 1 chunk size in bytes */
103
104 } mdu_array_info_t;
105
106 /* we need a value for 'no level specified' and 0
107 * means 'raid0', so we need something else. This is
108 * for internal use only
109 */
110 #define LEVEL_NONE (-1000000)
111
112 typedef struct mdu_disk_info_s {
113 /*
114 * configuration/status of one particular disk
115 */
116 int number;
117 int major;
118 int minor;
119 int raid_disk;
120 int state;
121
122 } mdu_disk_info_t;
123
124 typedef struct mdu_start_info_s {
125 /*
126 * configuration/status of one particular disk
127 */
128 int major;
129 int minor;
130 int raid_disk;
131 int state;
132
133 } mdu_start_info_t;
134
135 typedef struct mdu_bitmap_file_s
136 {
137 char pathname[4096];
138 } mdu_bitmap_file_t;
139
140 typedef struct mdu_param_s
141 {
142 int personality; /* 1,2,3,4 */
143 int chunk_size; /* in bytes */
144 int max_fault; /* unused for now */
145 } mdu_param_t;
146
147 #endif /* _UAPI_MD_U_H */
148
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.