xref: /freebsd/sys/geom/part/g_part.h (revision 282a3889ebf826db9839be296ff1dd903f6d6d6e)
1 /*-
2  * Copyright (c) 2006, 2007 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_EFI,		/* A EFI system partition entry. */
40 	G_PART_ALIAS_FREEBSD,		/* A BSD labeled partition entry. */
41 	G_PART_ALIAS_FREEBSD_SWAP,	/* A swap partition entry. */
42 	G_PART_ALIAS_FREEBSD_UFS,	/* A UFS/UFS2 file system entry. */
43 	G_PART_ALIAS_FREEBSD_VINUM,	/* A Vinum partition entry. */
44 	G_PART_ALIAS_MBR,		/* A MBR (extended) partition entry. */
45 	/* Keep the following last */
46 	G_PART_ALIAS_COUNT
47 };
48 
49 const char *g_part_alias_name(enum g_part_alias);
50 
51 /* G_PART scheme (KOBJ class). */
52 struct g_part_scheme {
53 	KOBJ_CLASS_FIELDS;
54 	size_t		gps_entrysz;
55 	int		gps_minent;
56 	int		gps_maxent;
57 };
58 #define	G_PART_SCHEME_DECLARE(s)	DATA_SET(g_part_scheme_set, s)
59 
60 struct g_part_entry {
61 	LIST_ENTRY(g_part_entry) gpe_entry;
62 	struct g_provider *gpe_pp;	/* Corresponding provider. */
63 	off_t		gpe_offset;	/* Byte offset. */
64 	quad_t		gpe_start;	/* First LBA of partition. */
65 	quad_t		gpe_end;	/* Last LBA of partition. */
66 	int		gpe_index;
67 	int		gpe_created:1;	/* Entry is newly created. */
68 	int		gpe_deleted:1;	/* Entry has been deleted. */
69 	int		gpe_modified:1;	/* Entry has been modified. */
70 };
71 
72 /* G_PART table (KOBJ instance). */
73 struct g_part_table {
74 	KOBJ_FIELDS;
75 	struct g_part_scheme *gpt_scheme;
76 	struct g_geom	*gpt_gp;
77 	LIST_HEAD(, g_part_entry) gpt_entry;
78 	quad_t		gpt_first;	/* First allocatable LBA */
79 	quad_t		gpt_last;	/* Last allocatable LBA */
80 	int		gpt_entries;
81 	/*
82 	 * gpt_smhead and gpt_smtail are bitmaps representing the first
83 	 * 32 sectors on the disk (gpt_smhead) and the last 32 sectors
84 	 * on the disk (gpt_smtail). These maps are used by the commit
85 	 * verb to clear sectors previously used by a scheme after the
86 	 * partitioning scheme has been destroyed.
87 	 */
88 	uint32_t	gpt_smhead;
89 	uint32_t	gpt_smtail;
90 	/*
91 	 * gpt_sectors and gpt_heads are the fixed or synchesized number
92 	 * of sectors per track and heads (resp) that make up a disks
93 	 * geometry. This is to support partitioning schemes as well as
94 	 * file systems that work on a geometry. The MBR scheme and the
95 	 * MS-DOS (FAT) file system come to mind.
96 	 * We keep track of whether the geometry is fixed or synchesized
97 	 * so that a partitioning scheme can correct the synthesized
98 	 * geometry, based on the on-disk metadata.
99 	 */
100 	uint32_t	gpt_sectors;
101 	uint32_t	gpt_heads;
102 
103 	int		gpt_depth;	/* Sub-partitioning level. */
104 	int		gpt_isleaf:1;	/* Cannot be sub-partitioned. */
105 	int		gpt_created:1;	/* Newly created. */
106 	int		gpt_modified:1;	/* Table changes have been made. */
107 	int		gpt_opened:1;	/* Permissions obtained. */
108 	int		gpt_fixgeom:1;	/* Geometry is fixed. */
109 };
110 
111 struct g_part_entry *g_part_new_entry(struct g_part_table *, int, quad_t,
112     quad_t);
113 
114 /* G_PART ctlreq parameters. */
115 #define	G_PART_PARM_ENTRIES	0x0001
116 #define	G_PART_PARM_FLAGS	0x0002
117 #define	G_PART_PARM_GEOM	0x0004
118 #define	G_PART_PARM_INDEX	0x0008
119 #define	G_PART_PARM_LABEL	0x0010
120 #define	G_PART_PARM_OUTPUT	0x0020
121 #define	G_PART_PARM_PROVIDER	0x0040
122 #define	G_PART_PARM_SCHEME	0x0080
123 #define	G_PART_PARM_SIZE	0x0100
124 #define	G_PART_PARM_START	0x0200
125 #define	G_PART_PARM_TYPE	0x0400
126 #define	G_PART_PARM_VERSION	0x0800
127 
128 struct g_part_parms {
129 	unsigned int	gpp_parms;
130 	unsigned int	gpp_entries;
131 	const char	*gpp_flags;
132 	struct g_geom	*gpp_geom;
133 	unsigned int	gpp_index;
134 	const char	*gpp_label;
135 	struct g_provider *gpp_provider;
136 	struct g_part_scheme *gpp_scheme;
137 	quad_t		gpp_size;
138 	quad_t		gpp_start;
139 	const char	*gpp_type;
140 	unsigned int	gpp_version;
141 };
142 
143 void g_part_geometry_heads(off_t, u_int, off_t *, u_int *);
144 
145 #endif /* !_GEOM_PART_H_ */
146