xref: /freebsd/sys/geom/part/g_part.h (revision 1f4bcc459a76b7aa664f3fd557684cd0ba6da352)
1 /*-
2  * Copyright (c) 2006-2008 Marcel Moolenaar
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _GEOM_PART_H_
30 #define	_GEOM_PART_H_
31 
32 #define	G_PART_TRACE(args)	g_trace args
33 
34 #define G_PART_PROBE_PRI_LOW	-10
35 #define	G_PART_PROBE_PRI_NORM	-5
36 #define	G_PART_PROBE_PRI_HIGH	0
37 
38 enum g_part_alias {
39 	G_PART_ALIAS_APPLE_BOOT,	/* An Apple boot partition entry. */
40 	G_PART_ALIAS_APPLE_CORE_STORAGE,/* An Apple Core Storage partition. */
41 	G_PART_ALIAS_APPLE_HFS,		/* An HFS+ file system entry. */
42 	G_PART_ALIAS_APPLE_LABEL,	/* An Apple label partition entry. */
43 	G_PART_ALIAS_APPLE_RAID,	/* An Apple RAID partition entry. */
44 	G_PART_ALIAS_APPLE_RAID_OFFLINE,/* An Apple RAID (offline) part entry.*/
45 	G_PART_ALIAS_APPLE_TV_RECOVERY,	/* An Apple TV recovery part entry. */
46 	G_PART_ALIAS_APPLE_UFS,		/* An Apple UFS partition entry. */
47 	G_PART_ALIAS_BIOS_BOOT,		/* A GRUB 2 boot partition entry. */
48 	G_PART_ALIAS_CHROMEOS_FIRMWARE,	/* A ChromeOS firmware part. entry. */
49 	G_PART_ALIAS_CHROMEOS_KERNEL,	/* A ChromeOS Kernel part. entry. */
50 	G_PART_ALIAS_CHROMEOS_RESERVED,	/* ChromeOS. Reserved for future use. */
51 	G_PART_ALIAS_CHROMEOS_ROOT,	/* A ChromeOS root part. entry. */
52 	G_PART_ALIAS_DFBSD,		/* A DfBSD label32 partition entry */
53 	G_PART_ALIAS_DFBSD64,		/* A DfBSD label64 partition entry */
54 	G_PART_ALIAS_DFBSD_CCD,		/* A DfBSD CCD partition entry */
55 	G_PART_ALIAS_DFBSD_HAMMER,	/* A DfBSD HAMMER FS partition entry */
56 	G_PART_ALIAS_DFBSD_HAMMER2,	/* A DfBSD HAMMER2 FS partition entry */
57 	G_PART_ALIAS_DFBSD_LEGACY,	/* A DfBSD legacy partition entry */
58 	G_PART_ALIAS_DFBSD_SWAP,	/* A DfBSD swap partition entry */
59 	G_PART_ALIAS_DFBSD_UFS,		/* A DfBSD UFS partition entry */
60 	G_PART_ALIAS_DFBSD_VINUM,	/* A DfBSD Vinum partition entry */
61 	G_PART_ALIAS_EBR,		/* A EBR partition entry. */
62 	G_PART_ALIAS_EFI,		/* A EFI system partition entry. */
63 	G_PART_ALIAS_FREEBSD,		/* A BSD labeled partition entry. */
64 	G_PART_ALIAS_FREEBSD_BOOT,	/* A FreeBSD boot partition entry. */
65 	G_PART_ALIAS_FREEBSD_NANDFS,	/* A FreeBSD nandfs partition entry. */
66 	G_PART_ALIAS_FREEBSD_SWAP,	/* A swap partition entry. */
67 	G_PART_ALIAS_FREEBSD_UFS,	/* A UFS/UFS2 file system entry. */
68 	G_PART_ALIAS_FREEBSD_VINUM,	/* A Vinum partition entry. */
69 	G_PART_ALIAS_FREEBSD_ZFS,	/* A ZFS file system entry. */
70 	G_PART_ALIAS_LINUX_DATA,	/* A Linux data partition entry. */
71 	G_PART_ALIAS_LINUX_LVM,		/* A Linux LVM partition entry. */
72 	G_PART_ALIAS_LINUX_RAID,	/* A Linux RAID partition entry. */
73 	G_PART_ALIAS_LINUX_SWAP,	/* A Linux swap partition entry. */
74 	G_PART_ALIAS_MBR,		/* A MBR (extended) partition entry. */
75 	G_PART_ALIAS_MS_BASIC_DATA,	/* A Microsoft Data part. entry. */
76 	G_PART_ALIAS_MS_FAT16,		/* A Microsoft FAT16 partition entry. */
77 	G_PART_ALIAS_MS_FAT32,		/* A Microsoft FAT32 partition entry. */
78 	G_PART_ALIAS_MS_LDM_DATA,	/* A Microsoft LDM Data part. entry. */
79 	G_PART_ALIAS_MS_LDM_METADATA,	/* A Microsoft LDM Metadata entry. */
80 	G_PART_ALIAS_MS_NTFS,		/* A Microsoft NTFS partition entry */
81 	G_PART_ALIAS_MS_RECOVERY,	/* A Microsoft recovery part. entry. */
82 	G_PART_ALIAS_MS_RESERVED,	/* A Microsoft Reserved part. entry. */
83 	G_PART_ALIAS_MS_SPACES,		/* A Microsoft Spaces part. entry. */
84 	G_PART_ALIAS_NETBSD_CCD,	/* A NetBSD CCD partition entry. */
85 	G_PART_ALIAS_NETBSD_CGD,	/* A NetBSD CGD partition entry. */
86 	G_PART_ALIAS_NETBSD_FFS,	/* A NetBSD FFS partition entry. */
87 	G_PART_ALIAS_NETBSD_LFS,	/* A NetBSD LFS partition entry. */
88 	G_PART_ALIAS_NETBSD_RAID,	/* A NetBSD RAID partition entry. */
89 	G_PART_ALIAS_NETBSD_SWAP,	/* A NetBSD swap partition entry. */
90 	G_PART_ALIAS_OPENBSD_DATA,	/* An OpenBSD data partition entry. */
91 	G_PART_ALIAS_PREP_BOOT,		/* A PREP/CHRP boot partition entry. */
92 	G_PART_ALIAS_VMFS,		/* A VMware VMFS partition entry */
93 	G_PART_ALIAS_VMKDIAG,		/* A VMware vmkDiagnostic partition entry */
94 	G_PART_ALIAS_VMRESERVED,	/* A VMware reserved partition entry */
95 	G_PART_ALIAS_VMVSANHDR,		/* A VMware vSAN header partition entry */
96 	/* Keep the following last */
97 	G_PART_ALIAS_COUNT
98 };
99 
100 const char *g_part_alias_name(enum g_part_alias);
101 
102 /* G_PART scheme (KOBJ class). */
103 struct g_part_scheme {
104 	KOBJ_CLASS_FIELDS;
105 	size_t		gps_entrysz;
106 	int		gps_minent;
107 	int		gps_maxent;
108 	int		gps_bootcodesz;
109 	TAILQ_ENTRY(g_part_scheme) scheme_list;
110 };
111 
112 struct g_part_entry {
113 	LIST_ENTRY(g_part_entry) gpe_entry;
114 	struct g_provider *gpe_pp;	/* Corresponding provider. */
115 	off_t		gpe_offset;	/* Byte offset. */
116 	quad_t		gpe_start;	/* First LBA of partition. */
117 	quad_t		gpe_end;	/* Last LBA of partition. */
118 	int		gpe_index;
119 	int		gpe_created:1;	/* Entry is newly created. */
120 	int		gpe_deleted:1;	/* Entry has been deleted. */
121 	int		gpe_modified:1;	/* Entry has been modified. */
122 	int		gpe_internal:1;	/* Entry is not a used entry. */
123 };
124 
125 /* G_PART table (KOBJ instance). */
126 struct g_part_table {
127 	KOBJ_FIELDS;
128 	struct g_part_scheme *gpt_scheme;
129 	struct g_geom	*gpt_gp;
130 	LIST_HEAD(, g_part_entry) gpt_entry;
131 	quad_t		gpt_first;	/* First allocatable LBA */
132 	quad_t		gpt_last;	/* Last allocatable LBA */
133 	int		gpt_entries;
134 	/*
135 	 * gpt_smhead and gpt_smtail are bitmaps representing the first
136 	 * 32 sectors on the disk (gpt_smhead) and the last 32 sectors
137 	 * on the disk (gpt_smtail). These maps are used by the commit
138 	 * verb to clear sectors previously used by a scheme after the
139 	 * partitioning scheme has been destroyed.
140 	 */
141 	uint32_t	gpt_smhead;
142 	uint32_t	gpt_smtail;
143 	/*
144 	 * gpt_sectors and gpt_heads are the fixed or synchesized number
145 	 * of sectors per track and heads (resp) that make up a disks
146 	 * geometry. This is to support partitioning schemes as well as
147 	 * file systems that work on a geometry. The MBR scheme and the
148 	 * MS-DOS (FAT) file system come to mind.
149 	 * We keep track of whether the geometry is fixed or synchesized
150 	 * so that a partitioning scheme can correct the synthesized
151 	 * geometry, based on the on-disk metadata.
152 	 */
153 	uint32_t	gpt_sectors;
154 	uint32_t	gpt_heads;
155 
156 	int		gpt_depth;	/* Sub-partitioning level. */
157 	int		gpt_isleaf:1;	/* Cannot be sub-partitioned. */
158 	int		gpt_created:1;	/* Newly created. */
159 	int		gpt_modified:1;	/* Table changes have been made. */
160 	int		gpt_opened:1;	/* Permissions obtained. */
161 	int		gpt_fixgeom:1;	/* Geometry is fixed. */
162 	int		gpt_corrupt:1;	/* Table is corrupt. */
163 };
164 
165 struct g_part_entry *g_part_new_entry(struct g_part_table *, int, quad_t,
166     quad_t);
167 
168 enum g_part_ctl {
169 	G_PART_CTL_NONE,
170 	G_PART_CTL_ADD,
171 	G_PART_CTL_BOOTCODE,
172 	G_PART_CTL_COMMIT,
173 	G_PART_CTL_CREATE,
174 	G_PART_CTL_DELETE,
175 	G_PART_CTL_DESTROY,
176 	G_PART_CTL_MODIFY,
177 	G_PART_CTL_MOVE,
178 	G_PART_CTL_RECOVER,
179 	G_PART_CTL_RESIZE,
180 	G_PART_CTL_SET,
181 	G_PART_CTL_UNDO,
182 	G_PART_CTL_UNSET
183 };
184 
185 /* G_PART ctlreq parameters. */
186 #define	G_PART_PARM_ENTRIES	0x0001
187 #define	G_PART_PARM_FLAGS	0x0002
188 #define	G_PART_PARM_GEOM	0x0004
189 #define	G_PART_PARM_INDEX	0x0008
190 #define	G_PART_PARM_LABEL	0x0010
191 #define	G_PART_PARM_OUTPUT	0x0020
192 #define	G_PART_PARM_PROVIDER	0x0040
193 #define	G_PART_PARM_SCHEME	0x0080
194 #define	G_PART_PARM_SIZE	0x0100
195 #define	G_PART_PARM_START	0x0200
196 #define	G_PART_PARM_TYPE	0x0400
197 #define	G_PART_PARM_VERSION	0x0800
198 #define	G_PART_PARM_BOOTCODE	0x1000
199 #define	G_PART_PARM_ATTRIB	0x2000
200 #define	G_PART_PARM_FORCE	0x4000
201 
202 struct g_part_parms {
203 	unsigned int	gpp_parms;
204 	unsigned int	gpp_entries;
205 	const char	*gpp_flags;
206 	struct g_geom	*gpp_geom;
207 	unsigned int	gpp_index;
208 	const char	*gpp_label;
209 	struct g_provider *gpp_provider;
210 	struct g_part_scheme *gpp_scheme;
211 	quad_t		gpp_size;
212 	quad_t		gpp_start;
213 	const char	*gpp_type;
214 	unsigned int	gpp_version;
215 	const void	*gpp_codeptr;
216 	unsigned int	gpp_codesize;
217 	const char	*gpp_attrib;
218 	unsigned int	gpp_force;
219 };
220 
221 void g_part_geometry_heads(off_t, u_int, off_t *, u_int *);
222 
223 int g_part_modevent(module_t, int, struct g_part_scheme *);
224 
225 #define	G_PART_SCHEME_DECLARE(name)				\
226     static int name##_modevent(module_t mod, int tp, void *d)	\
227     {								\
228 	return (g_part_modevent(mod, tp, d));			\
229     }								\
230     static moduledata_t name##_mod = {				\
231 	#name,							\
232 	name##_modevent,					\
233 	&name##_scheme						\
234     };								\
235     DECLARE_MODULE(name, name##_mod, SI_SUB_DRIVERS, SI_ORDER_ANY); \
236     MODULE_DEPEND(name, g_part, 0, 0, 0)
237 
238 #endif /* !_GEOM_PART_H_ */
239