2 * ----------------------------------------------------------------------------
3 * "THE BEER-WARE LICENSE" (Revision 42):
4 * <phk@login.dknet.dk> wrote this file. As long as you retain this notice you
5 * can do whatever you want with this stuff. If we meet some day, and you think
6 * this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
7 * ----------------------------------------------------------------------------
9 * $FreeBSD: src/lib/libdisk/libdisk.h,v 1.32.2.8 2002/01/07 07:53:29 dillon Exp $
10 * $DragonFly: src/lib/libdisk/Attic/libdisk.h,v 1.3 2004/07/11 20:28:15 drhodus Exp $
14 #define MAX_NO_DISKS 32
15 /* Max # of disks Disk_Names() will return */
17 #define MAX_SEC_SIZE 2048 /* maximum sector size that is supported */
18 #define MIN_SEC_SIZE 512 /* the sector size to end sensing at */
34 # define DISK_ON_TRACK 1
48 #if defined(__i386__) /* the i386 needs extra help... */
52 u_long sector_size; /* media sector size, a power of 2 */
67 /* Used during Fixup_Names() to avoid renaming more than
73 void (*private_free)(void*);
74 void *(*private_clone)(void*);
76 /* For data private to the application, and the management
77 * thereof. If the functions are not provided, no storage
78 * management is done, Cloning will just copy the pointer
79 * and freeing will just forget it.
86 * BSD_COMPAT - This chunk is in the BSD-compatibility, and has
87 * a short name too, ie wd0s4f -> wd0f
88 * ALIGN - This chunk should be aligned
89 * IS_ROOT - This 'part' is a rootfs, allocate 'a'
90 * ACTIVE - This is the active slice in the MBR
91 * FORCE_ALL - Force a dedicated disk for FreeBSD, bypassing
92 * all BIOS geometry considerations
93 * AUTO_SIZE - This chunk was auto-sized and can fill-out a
94 * following chunk if the following chunk is deleted.
95 * NEWFS - newfs pending, used to enable auto-resizing on
96 * delete (along with AUTO_SIZE).
99 #define CHUNK_BSD_COMPAT 0x0002
100 #define CHUNK_ALIGN 0x0008
101 #define CHUNK_IS_ROOT 0x0010
102 #define CHUNK_ACTIVE 0x0020
103 #define CHUNK_FORCE_ALL 0x0040
104 #define CHUNK_AUTO_SIZE 0x0080
105 #define CHUNK_NEWFS 0x0100
107 #define DELCHUNK_NORMAL 0x0000
108 #define DELCHUNK_RECOVER 0x0001
111 extern const char *chunk_n[];
114 slice_type_name( int type, int subtype );
115 /* "chunk_n" for subtypes too
119 Open_Disk(const char *devname);
120 /* Will open the named disk, and return populated tree.
124 Clone_Disk(struct disk *disk);
125 /* Clone a copy of a tree. Useful for "Undo" functionality
129 Free_Disk(struct disk *disk);
130 /* Free a tree made with Open_Disk() or Clone_Disk()
134 Debug_Disk(struct disk *disk);
135 /* Print the content of the tree to stdout
139 Set_Bios_Geom(struct disk *disk, u_long cyl, u_long heads, u_long sects);
140 /* Set the geometry the bios uses.
144 Sanitize_Bios_Geom(struct disk *disk);
145 /* Set the bios geometry to something sane
149 Delete_Chunk2(struct disk *disk, struct chunk *, int flags);
150 /* Free a chunk of disk_space modified by the passed
155 Delete_Chunk(struct disk *disk, struct chunk *);
156 /* Free a chunk of disk_space
160 Collapse_Disk(struct disk *disk);
161 /* Experimental, do not use.
164 Collapse_Chunk(struct disk *disk, struct chunk *chunk);
165 /* Experimental, do not use.
170 Create_Chunk(struct disk *disk, u_long offset, u_long size, chunk_e type,
171 int subtype, u_long flags, const char *);
173 Create_Chunk(struct disk *disk, u_long offset, u_long size, chunk_e type,
174 int subtype, u_long flags);
176 /* Create a chunk with the specified paramters
180 All_FreeBSD(struct disk *d, int force_all);
181 /* Make one FreeBSD chunk covering the entire disk;
182 * if force_all is set, bypass all BIOS geometry
187 CheckRules(struct disk *);
188 /* Return char* to warnings about broken design rules in this disklayout
193 /* Return char** with all disk's names (wd0, wd1 ...). You must free
194 * each pointer, as well as the array by hand
199 Set_Boot_Mgr(struct disk *d, const u_char *bootipl, const size_t bootipl_size,
200 const u_char *bootmenu, const size_t bootmenu_size);
203 Set_Boot_Mgr(struct disk *d, const u_char *bootmgr, const size_t bootmgr_size);
205 /* Use this boot-manager on this disk. Gets written when Write_Disk()
210 Set_Boot_Blocks(struct disk *d, const u_char *_boot1, const u_char *_boot2);
211 /* Use these boot-blocks on this disk. Gets written when Write_Disk()
212 * is called. Returns nonzero upon failure.
216 Write_Disk(struct disk *d);
217 /* Write all the MBRs, disklabels, bootblocks and boot managers
221 Cyl_Aligned(struct disk *d, u_long offset);
222 /* Check if offset is aligned on a cylinder according to the
227 Next_Cyl_Aligned(struct disk *d, u_long offset);
228 /* Round offset up to next cylinder according to the bios-geometry
232 Prev_Cyl_Aligned(struct disk *d, u_long offset);
233 /* Round offset down to previous cylinder according to the bios-
238 Track_Aligned(struct disk *d, u_long offset);
239 /* Check if offset is aligned on a track according to the
244 Next_Track_Aligned(struct disk *d, u_long offset);
245 /* Round offset up to next track according to the bios-geometry
249 Prev_Track_Aligned(struct disk *d, u_long offset);
250 /* Check if offset is aligned on a track according to the
255 Create_Chunk_DWIM(struct disk *d, struct chunk *parent , u_long size,
256 chunk_e type, int subtype, u_long flags);
257 /* This one creates a partition inside the given parent of the given
258 * size, and returns a pointer to it. The first unused chunk big
263 MakeDev(struct chunk *c, const char *path);
266 MakeDevDisk(struct disk *d, const char *path);
267 /* Make device nodes for all chunks on this disk */
270 ShowChunkFlags(struct chunk *c);
271 /* Return string to show flags. */
274 ChunkCanBeRoot(struct chunk *c);
275 /* Return NULL if chunk can be /, explanation otherwise */
278 * Implementation details >>> DO NOT USE <<<
281 void Debug_Chunk(struct chunk *);
282 void Free_Chunk(struct chunk *);
283 struct chunk * Clone_Chunk(struct chunk *);
285 int Add_Chunk(struct disk *, long, u_long, const char *, chunk_e, int, u_long, const char *);
287 int Add_Chunk(struct disk *, long, u_long, const char *, chunk_e, int, u_long);
289 void * read_block(int, daddr_t, u_long);
290 int write_block(int, daddr_t, void *, u_long);
291 struct disklabel * read_disklabel(int, daddr_t, u_long);
292 struct chunk * Find_Mother_Chunk(struct chunk *, u_long, u_long, chunk_e);
293 struct disk * Int_Open_Disk(const char *name, u_long size);
294 int Fixup_Names(struct disk *);
297 #define dprintf printf
301 * Need a error string mechanism from the functions instead of warn()
303 * Make sure only FreeBSD start at offset==0
305 * Collapse must align.
307 * Make Write_Disk(struct disk*)
309 * Consider booting from OnTrack'ed disks.
311 * Get Bios-geom, ST506 & OnTrack from driver (or otherwise)
313 * Make Create_DWIM().
315 * Make Is_Unchanged(struct disk *d1, struct chunk *c1)
317 * don't rename slices unless we have to
319 *Sample output from tst01:
321 * Debug_Disk(wd0) flags=0 bios_geom=0/0/0
322 * >> 0x3d040 0 1411200 1411199 wd0 0 whole 0 0
323 * >>>> 0x3d080 0 960120 960119 wd0s1 3 freebsd 0 8
324 * >>>>>> 0x3d100 0 40960 40959 wd0s1a 5 part 0 0
325 * >>>>>> 0x3d180 40960 131072 172031 wd0s1b 5 part 0 0
326 * >>>>>> 0x3d1c0 172032 409600 581631 wd0s1e 5 part 0 0
327 * >>>>>> 0x3d200 581632 378488 960119 wd0s1f 5 part 0 0
328 * >>>> 0x3d140 960120 5670 965789 wd0s2 4 extended 0 8
329 * >>>>>> 0x3d2c0 960120 63 960182 - 6 unused 0 0
330 * >>>>>> 0x3d0c0 960183 5607 965789 wd0s5 2 fat 0 8
331 * >>>> 0x3d280 965790 1890 967679 wd0s3 1 foo -2 8
332 * >>>> 0x3d300 967680 443520 1411199 wd0s4 3 freebsd 0 8
333 * >>>>>> 0x3d340 967680 443520 1411199 wd0s4a 5 part 0 0
335 * ^ ^ ^ ^ ^ ^ ^ ^ ^ ^
336 * level chunkptr start size end name type subtype flags
338 * Underlying data structure:
341 * <struct chunk> --> part
345 * <wd0> --> <wd0s1> --> <wd0s1a>
357 * <wd0s2> --> <unused>
366 * <wd0s4> --> <wd0s4a>