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
72struct 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
173struct 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
183struct 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