1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  * linux/include/linux/edd.h
4  *  Copyright (C) 2002, 2003, 2004 Dell Inc.
5  *  by Matt Domsch <Matt_Domsch@dell.com>
6  *
7  * structures and definitions for the int 13h, ax={41,48}h
8  * BIOS Enhanced Disk Drive Services
9  * This is based on the T13 group document D1572 Revision 0 (August 14 2002)
10  * available at http://www.t13.org/docs2002/d1572r0.pdf.  It is
11  * very similar to D1484 Revision 3 http://www.t13.org/docs2002/d1484r3.pdf
12  *
13  * In a nutshell, arch/{i386,x86_64}/boot/setup.S populates a scratch
14  * table in the boot_params that contains a list of BIOS-enumerated
15  * boot devices.
16  * In arch/{i386,x86_64}/kernel/setup.c, this information is
17  * transferred into the edd structure, and in drivers/firmware/edd.c, that
18  * information is used to identify BIOS boot disk.  The code in setup.S
19  * is very sensitive to the size of these structures.
20  *
21  * This program is free software; you can redistribute it and/or modify
22  * it under the terms of the GNU General Public License v2.0 as published by
23  * the Free Software Foundation
24  *
25  * This program is distributed in the hope that it will be useful,
26  * but WITHOUT ANY WARRANTY; without even the implied warranty of
27  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
28  * GNU General Public License for more details.
29  *
30  */
31 #ifndef _UAPI_LINUX_EDD_H
32 #define _UAPI_LINUX_EDD_H
33 
34 #include <linux/types.h>
35 
36 #define EDDNR 0x1e9		/* addr of number of edd_info structs at EDDBUF
37 				   in boot_params - treat this as 1 byte  */
38 #define EDDBUF	0xd00		/* addr of edd_info structs in boot_params */
39 #define EDDMAXNR 6		/* number of edd_info structs starting at EDDBUF  */
40 #define EDDEXTSIZE 8		/* change these if you muck with the structures */
41 #define EDDPARMSIZE 74
42 #define CHECKEXTENSIONSPRESENT 0x41
43 #define GETDEVICEPARAMETERS 0x48
44 #define LEGACYGETDEVICEPARAMETERS 0x08
45 #define EDDMAGIC1 0x55AA
46 #define EDDMAGIC2 0xAA55
47 
48 
49 #define READ_SECTORS 0x02         /* int13 AH=0x02 is READ_SECTORS command */
50 #define EDD_MBR_SIG_OFFSET 0x1B8  /* offset of signature in the MBR */
51 #define EDD_MBR_SIG_BUF    0x290  /* addr in boot params */
52 #define EDD_MBR_SIG_MAX 16        /* max number of signatures to store */
53 #define EDD_MBR_SIG_NR_BUF 0x1ea  /* addr of number of MBR signtaures at EDD_MBR_SIG_BUF
54 				     in boot_params - treat this as 1 byte  */
55 
56 #ifndef __ASSEMBLY__
57 
58 #define EDD_EXT_FIXED_DISK_ACCESS           (1 << 0)
59 #define EDD_EXT_DEVICE_LOCKING_AND_EJECTING (1 << 1)
60 #define EDD_EXT_ENHANCED_DISK_DRIVE_SUPPORT (1 << 2)
61 #define EDD_EXT_64BIT_EXTENSIONS            (1 << 3)
62 
63 #define EDD_INFO_DMA_BOUNDARY_ERROR_TRANSPARENT (1 << 0)
64 #define EDD_INFO_GEOMETRY_VALID                (1 << 1)
65 #define EDD_INFO_REMOVABLE                     (1 << 2)
66 #define EDD_INFO_WRITE_VERIFY                  (1 << 3)
67 #define EDD_INFO_MEDIA_CHANGE_NOTIFICATION     (1 << 4)
68 #define EDD_INFO_LOCKABLE                      (1 << 5)
69 #define EDD_INFO_NO_MEDIA_PRESENT              (1 << 6)
70 #define EDD_INFO_USE_INT13_FN50                (1 << 7)
71 
72 struct edd_device_params {
73 	__u16 length;
74 	__u16 info_flags;
75 	__u32 num_default_cylinders;
76 	__u32 num_default_heads;
77 	__u32 sectors_per_track;
78 	__u64 number_of_sectors;
79 	__u16 bytes_per_sector;
80 	__u32 dpte_ptr;		/* 0xFFFFFFFF for our purposes */
81 	__u16 key;		/* = 0xBEDD */
82 	__u8 device_path_info_length;	/* = 44 */
83 	__u8 reserved2;
84 	__u16 reserved3;
85 	__u8 host_bus_type[4];
86 	__u8 interface_type[8];
87 	union {
88 		struct {
89 			__u16 base_address;
90 			__u16 reserved1;
91 			__u32 reserved2;
92 		} __attribute__ ((packed)) isa;
93 		struct {
94 			__u8 bus;
95 			__u8 slot;
96 			__u8 function;
97 			__u8 channel;
98 			__u32 reserved;
99 		} __attribute__ ((packed)) pci;
100 		/* pcix is same as pci */
101 		struct {
102 			__u64 reserved;
103 		} __attribute__ ((packed)) ibnd;
104 		struct {
105 			__u64 reserved;
106 		} __attribute__ ((packed)) xprs;
107 		struct {
108 			__u64 reserved;
109 		} __attribute__ ((packed)) htpt;
110 		struct {
111 			__u64 reserved;
112 		} __attribute__ ((packed)) unknown;
113 	} interface_path;
114 	union {
115 		struct {
116 			__u8 device;
117 			__u8 reserved1;
118 			__u16 reserved2;
119 			__u32 reserved3;
120 			__u64 reserved4;
121 		} __attribute__ ((packed)) ata;
122 		struct {
123 			__u8 device;
124 			__u8 lun;
125 			__u8 reserved1;
126 			__u8 reserved2;
127 			__u32 reserved3;
128 			__u64 reserved4;
129 		} __attribute__ ((packed)) atapi;
130 		struct {
131 			__u16 id;
132 			__u64 lun;
133 			__u16 reserved1;
134 			__u32 reserved2;
135 		} __attribute__ ((packed)) scsi;
136 		struct {
137 			__u64 serial_number;
138 			__u64 reserved;
139 		} __attribute__ ((packed)) usb;
140 		struct {
141 			__u64 eui;
142 			__u64 reserved;
143 		} __attribute__ ((packed)) i1394;
144 		struct {
145 			__u64 wwid;
146 			__u64 lun;
147 		} __attribute__ ((packed)) fibre;
148 		struct {
149 			__u64 identity_tag;
150 			__u64 reserved;
151 		} __attribute__ ((packed)) i2o;
152 		struct {
153 			__u32 array_number;
154 			__u32 reserved1;
155 			__u64 reserved2;
156 		} __attribute__ ((packed)) raid;
157 		struct {
158 			__u8 device;
159 			__u8 reserved1;
160 			__u16 reserved2;
161 			__u32 reserved3;
162 			__u64 reserved4;
163 		} __attribute__ ((packed)) sata;
164 		struct {
165 			__u64 reserved1;
166 			__u64 reserved2;
167 		} __attribute__ ((packed)) unknown;
168 	} device_path;
169 	__u8 reserved4;
170 	__u8 checksum;
171 } __attribute__ ((packed));
172 
173 struct edd_info {
174 	__u8 device;
175 	__u8 version;
176 	__u16 interface_support;
177 	__u16 legacy_max_cylinder;
178 	__u8 legacy_max_head;
179 	__u8 legacy_sectors_per_track;
180 	struct edd_device_params params;
181 } __attribute__ ((packed));
182 
183 struct edd {
184 	unsigned int mbr_signature[EDD_MBR_SIG_MAX];
185 	struct edd_info edd_info[EDDMAXNR];
186 	unsigned char mbr_signature_nr;
187 	unsigned char edd_info_nr;
188 };
189 
190 #endif				/*!__ASSEMBLY__ */
191 
192 #endif /* _UAPI_LINUX_EDD_H */
193