xref: /illumos-gate/usr/src/uts/common/sys/efi_partition.h (revision a386cc11a86ecb60f5a48078d22c1500e2ad003e)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2012 Nexenta Systems, Inc.  All rights reserved.
24  */
25 
26 #ifndef	_SYS_EFI_PARTITION_H
27 #define	_SYS_EFI_PARTITION_H
28 
29 #include <sys/uuid.h>
30 
31 #ifdef	__cplusplus
32 extern "C" {
33 #endif
34 
35 /*
36  * GUID Partition Table Header
37  */
38 
39 #define	EFI_LABEL_SIZE	512
40 #define	LEN_EFI_PAD	(EFI_LABEL_SIZE - \
41 			    ((5 * sizeof (diskaddr_t)) + \
42 			    (7 * sizeof (uint_t)) + \
43 			    (8 * sizeof (char)) + \
44 			    (1 * (sizeof (struct uuid)))))
45 
46 #define	EFI_SIGNATURE	0x5452415020494645ULL
47 
48 /* EFI Guid Partition Table Header -- little endian on-disk format */
49 typedef struct efi_gpt {
50 	uint64_t	efi_gpt_Signature;
51 	uint_t		efi_gpt_Revision;
52 	uint_t		efi_gpt_HeaderSize;
53 	uint_t		efi_gpt_HeaderCRC32;
54 	uint_t		efi_gpt_Reserved1;
55 	diskaddr_t	efi_gpt_MyLBA;
56 	diskaddr_t	efi_gpt_AlternateLBA;
57 	diskaddr_t	efi_gpt_FirstUsableLBA;
58 	diskaddr_t	efi_gpt_LastUsableLBA;
59 	struct uuid	efi_gpt_DiskGUID;
60 	diskaddr_t	efi_gpt_PartitionEntryLBA;
61 	uint_t		efi_gpt_NumberOfPartitionEntries;
62 	uint_t		efi_gpt_SizeOfPartitionEntry;
63 	uint_t		efi_gpt_PartitionEntryArrayCRC32;
64 	char		efi_gpt_Reserved2[LEN_EFI_PAD];
65 } efi_gpt_t;
66 
67 /* EFI Guid Partition Entry Attributes -- little endian format */
68 typedef struct efi_gpe_Attrs {
69 	uint32_t	PartitionAttrs		:16,
70 			Reserved2		:16;
71 	uint32_t	Reserved1		:31,
72 			RequiredPartition	:1;
73 } efi_gpe_Attrs_t;
74 
75 /*
76  * 6a96237f-1dd2-11b2-99a6-080020736631	V_UNASSIGNED (not used as such)
77  * 6a82cb45-1dd2-11b2-99a6-080020736631	V_BOOT
78  * 6a85cf4d-1dd2-11b2-99a6-080020736631	V_ROOT
79  * 6a87c46f-1dd2-11b2-99a6-080020736631	V_SWAP
80  * 6a898cc3-1dd2-11b2-99a6-080020736631	V_USR
81  * 6a8b642b-1dd2-11b2-99a6-080020736631	V_BACKUP
82  * 6a8d2ac7-1dd2-11b2-99a6-080020736631	V_STAND (not used)
83  * 6a8ef2e9-1dd2-11b2-99a6-080020736631	V_VAR
84  * 6a90ba39-1dd2-11b2-99a6-080020736631	V_HOME
85  * 6a9283a5-1dd2-11b2-99a6-080020736631	V_ALTSCTR
86  * 6a945a3b-1dd2-11b2-99a6-080020736631	V_CACHE
87  */
88 
89 #define	EFI_UNUSED		{ 0x00000000, 0x0000, 0x0000, 0x00, 0x00, \
90 				    { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 } }
91 #define	EFI_RESV1		{ 0x6a96237f, 0x1dd2, 0x11b2, 0x99, 0xa6, \
92 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
93 #define	EFI_BOOT		{ 0x6a82cb45, 0x1dd2, 0x11b2, 0x99, 0xa6, \
94 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
95 #define	EFI_ROOT		{ 0x6a85cf4d, 0x1dd2, 0x11b2, 0x99, 0xa6, \
96 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
97 #define	EFI_SWAP		{ 0x6a87c46f, 0x1dd2, 0x11b2, 0x99, 0xa6, \
98 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
99 #define	EFI_USR			{ 0x6a898cc3, 0x1dd2, 0x11b2, 0x99, 0xa6, \
100 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
101 #define	EFI_BACKUP		{ 0x6a8b642b, 0x1dd2, 0x11b2, 0x99, 0xa6, \
102 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
103 #define	EFI_RESV2		{ 0x6a8d2ac7, 0x1dd2, 0x11b2, 0x99, 0xa6, \
104 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
105 #define	EFI_VAR			{ 0x6a8ef2e9, 0x1dd2, 0x11b2, 0x99, 0xa6, \
106 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
107 #define	EFI_HOME		{ 0x6a90ba39, 0x1dd2, 0x11b2, 0x99, 0xa6, \
108 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
109 #define	EFI_ALTSCTR		{ 0x6a9283a5, 0x1dd2, 0x11b2, 0x99, 0xa6, \
110 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
111 #define	EFI_RESERVED		{ 0x6a945a3b, 0x1dd2, 0x11b2, 0x99, 0xa6, \
112 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
113 #define	EFI_SYSTEM		{ 0xC12A7328, 0xF81F, 0x11d2, 0xBA, 0x4B, \
114 				    { 0x00, 0xA0, 0xC9, 0x3E, 0xC9, 0x3B } }
115 #define	EFI_LEGACY_MBR		{ 0x024DEE41, 0x33E7, 0x11d3, 0x9D, 0x69, \
116 				    { 0x00, 0x08, 0xC7, 0x81, 0xF3, 0x9F } }
117 #define	EFI_SYMC_PUB		{ 0x6a9630d1, 0x1dd2, 0x11b2, 0x99, 0xa6, \
118 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
119 #define	EFI_SYMC_CDS		{ 0x6a980767, 0x1dd2, 0x11b2, 0x99, 0xa6, \
120 				    { 0x08, 0x00, 0x20, 0x73, 0x66, 0x31 } }
121 #define	EFI_MSFT_RESV		{ 0xE3C9E316, 0x0B5C, 0x4DB8, 0x81, 0x7D, \
122 				    { 0xF9, 0x2D, 0xF0, 0x02, 0x15, 0xAE } }
123 #define	EFI_DELL_BASIC		{ 0xebd0a0a2, 0xb9e5, 0x4433, 0x87, 0xc0, \
124 				    { 0x68, 0xb6, 0xb7, 0x26, 0x99, 0xc7 } }
125 #define	EFI_DELL_RAID		{ 0xa19d880f, 0x05fc, 0x4d3b, 0xa0, 0x06, \
126 				    { 0x74, 0x3f, 0x0f, 0x84, 0x91, 0x1e } }
127 #define	EFI_DELL_SWAP		{ 0x0657fd6d, 0xa4ab, 0x43c4, 0x84, 0xe5, \
128 				    { 0x09, 0x33, 0xc8, 0x4b, 0x4f, 0x4f } }
129 #define	EFI_DELL_LVM		{ 0xe6d6d379, 0xf507, 0x44c2, 0xa2, 0x3c, \
130 				    { 0x23, 0x8f, 0x2a, 0x3d, 0xf9, 0x28 } }
131 #define	EFI_DELL_RESV		{ 0x8da63339, 0x0007, 0x60c0, 0xc4, 0x36, \
132 				    { 0x08, 0x3a, 0xc8, 0x23, 0x09, 0x08 } }
133 #define	EFI_AAPL_HFS		{ 0x48465300, 0x0000, 0x11aa, 0xaa, 0x11, \
134 				    { 0x00, 0x30, 0x65, 0x43, 0xec, 0xac } }
135 #define	EFI_AAPL_UFS		{ 0x55465300, 0x0000, 0x11aa, 0xaa, 0x11, \
136 				    { 0x00, 0x30, 0x65, 0x43, 0xec, 0xac } }
137 #define	EFI_FREEBSD_BOOT	{ 0x83bd6b9d, 0x7f41, 0x11dc, 0xbe, 0x0b, \
138 				    { 0x00, 0x15, 0x60, 0xb8, 0x4f, 0x0f } }
139 #define	EFI_FREEBSD_SWAP	{ 0x516e7cb5, 0x6ecf, 0x11d6, 0x8f, 0xf8, \
140 				    { 0x00, 0x02, 0x2d, 0x09, 0x71, 0x2b } }
141 #define	EFI_FREEBSD_UFS		{ 0x516e7cb6, 0x6ecf, 0x11d6, 0x8f, 0xf8, \
142 				    { 0x00, 0x02, 0x2d, 0x09, 0x71, 0x2b } }
143 #define	EFI_FREEBSD_VINUM	{ 0x516e7cb8, 0x6ecf, 0x11d6, 0x8f, 0xf8, \
144 				    { 0x00, 0x02, 0x2d, 0x09, 0x71, 0x2b } }
145 #define	EFI_FREEBSD_ZFS		{ 0x516e7cba, 0x6ecf, 0x11d6, 0x8f, 0xf8, \
146 				    { 0x00, 0x02, 0x2d, 0x09, 0x71, 0x2b } }
147 
148 /* minimum # of bytes for partition table entires, per EFI spec */
149 #define	EFI_MIN_ARRAY_SIZE	(16 * 1024)
150 
151 #define	EFI_PART_NAME_LEN	36
152 
153 /* size of the "reserved" partition, in blocks */
154 #define	EFI_MIN_RESV_SIZE	(16 * 1024)
155 
156 /* EFI Guid Partition Entry */
157 typedef struct efi_gpe {
158 	struct uuid	efi_gpe_PartitionTypeGUID;
159 	struct uuid	efi_gpe_UniquePartitionGUID;
160 	diskaddr_t	efi_gpe_StartingLBA;
161 	diskaddr_t	efi_gpe_EndingLBA;
162 	efi_gpe_Attrs_t	efi_gpe_Attributes;
163 	ushort_t	efi_gpe_PartitionName[EFI_PART_NAME_LEN];
164 } efi_gpe_t;
165 
166 /*
167  * passed to the useful (we hope) routines (efi_alloc_and_read and
168  * efi_write) that take this VTOC-like struct.  These routines handle
169  * converting this struct into the EFI struct, generate UUIDs and
170  * checksums, and perform any necessary byte-swapping to the on-disk
171  * format.
172  */
173 /* Solaris library abstraction for EFI partitons */
174 typedef struct dk_part	{
175 	diskaddr_t	p_start;	/* starting LBA */
176 	diskaddr_t	p_size;		/* size in blocks */
177 	struct uuid	p_guid;		/* partion type GUID */
178 	ushort_t	p_tag;		/* converted to part'n type GUID */
179 	ushort_t	p_flag;		/* attributes */
180 	char		p_name[EFI_PART_NAME_LEN]; /* partition name */
181 	struct uuid	p_uguid;	/* unique partition GUID */
182 	uint_t		p_resv[8];	/* future use - set to zero */
183 } dk_part_t;
184 
185 /* Solaris library abstraction for an EFI GPT */
186 #define	EFI_VERSION102		0x00010002
187 #define	EFI_VERSION100		0x00010000
188 #define	EFI_VERSION_CURRENT	EFI_VERSION100
189 typedef struct dk_gpt {
190 	uint_t		efi_version;	/* set to EFI_VERSION_CURRENT */
191 	uint_t		efi_nparts;	/* number of partitions below */
192 	uint_t		efi_part_size;	/* size of each partition entry */
193 					/* efi_part_size is unused */
194 	uint_t		efi_lbasize;	/* size of block in bytes */
195 	diskaddr_t	efi_last_lba;	/* last block on the disk */
196 	diskaddr_t	efi_first_u_lba; /* first block after labels */
197 	diskaddr_t	efi_last_u_lba;	/* last block before backup labels */
198 	struct uuid	efi_disk_uguid;	/* unique disk GUID */
199 	uint_t		efi_flags;
200 	uint_t		efi_reserved1;	/* future use - set to zero */
201 	diskaddr_t	efi_altern_lba;	/* lba of alternate GPT header */
202 	uint_t		efi_reserved[12]; /* future use - set to zero */
203 	struct dk_part	efi_parts[1];	/* array of partitions */
204 } dk_gpt_t;
205 
206 /* possible values for "efi_flags" */
207 #define	EFI_GPT_PRIMARY_CORRUPT	0x1	/* primary label corrupt */
208 
209 /* the private ioctl between libefi and the driver */
210 typedef struct dk_efi {
211 	diskaddr_t	 dki_lba;	/* starting block */
212 	len_t		 dki_length;	/* length in bytes */
213 	union {
214 		efi_gpt_t 	*_dki_data;
215 		uint64_t	_dki_data_64;
216 	} dki_un;
217 #define	dki_data	dki_un._dki_data
218 #define	dki_data_64	dki_un._dki_data_64
219 } dk_efi_t;
220 
221 struct partition64 {
222 	struct uuid	p_type;
223 	uint_t		p_partno;
224 	uint_t		p_resv1;
225 	diskaddr_t	p_start;
226 	diskaddr_t	p_size;
227 };
228 
229 /*
230  * Number of EFI partitions
231  */
232 #define	EFI_NUMPAR	9
233 
234 #ifndef _KERNEL
235 extern	int	efi_alloc_and_init(int, uint32_t, struct dk_gpt **);
236 extern	int	efi_alloc_and_read(int, struct dk_gpt **);
237 extern	int	efi_write(int, struct dk_gpt *);
238 extern	void	efi_free(struct dk_gpt *);
239 extern	int	efi_type(int);
240 extern	void	efi_err_check(struct dk_gpt *);
241 extern	int	efi_auto_sense(int fd, struct dk_gpt **);
242 extern	int	efi_use_whole_disk(int fd);
243 #endif
244 
245 #ifdef __cplusplus
246 }
247 #endif
248 
249 #endif /* _SYS_EFI_PARTITION_H */
250