1 .\" $FreeBSD: src/sbin/i386/fdisk/fdisk.8,v 1.17.2.11 2002/04/25 16:25:12 trhodes Exp $
2 .\" $DragonFly: src/sbin/i386/fdisk/fdisk.8,v 1.11 2007/03/13 09:42:20 swildner Exp $
9 .Nd PC slice table maintenance program
22 In order for the BIOS to boot the kernel,
23 certain conventions must be adhered to.
24 Sector 0 of the disk must contain boot code,
27 BIOS slices can be used to break the disk up into several pieces.
28 The BIOS brings in sector 0 and verifies the magic number. The sector
29 0 boot code then searches the slice table to determine which
32 This boot code then brings in the bootstrap from the
34 slice and, if marked bootable, runs it.
36 you can have one or more slices with one
40 program can be used to divide space on the disk into slices and set one
47 serves a similar purpose to the DOS program. The first form is used to
48 display slice information or to interactively edit the slice
49 table. The second is used to write a slice table using a
51 and is designed to be used by other scripts/programs.
54 .Bl -tag -width indent
56 Change the active slice only. Ignored if
60 Get the boot code from the file
65 The disk image is specified as a normal file instead of as a device,
66 which is useful when building emulated disks for vmware, bochs, etc.
68 Reinitialize the boot code contained in sector 0 of the disk. Ignored
73 Normally if the CHS fields for a partition are set to all 1's if they
74 would otherwise wrap. This typically causes BIOSes to properly detect
75 that the disk should be put in Large mode. If this option is specified
76 the CHS fields will be set to wrapped values instead. This option may
77 be needed on very old PCs.
78 .It Fl f Ar configfile
79 Set slice values using the file
83 always modifies existing slices, unless
85 is also given, in which case all existing slices are deleted (marked
86 as "unused") before the
90 can be "-", in which case
93 .Sx CONFIGURATION FILE ,
94 below, for file syntax.
99 is used, you are not asked if you really want to write the slices
100 table (as you are in the interactive mode). Use with caution!
102 Initialize sector 0 of the disk. This implies
108 Initialize the contents of sector 0
111 slice covering the entire disk.
113 Print a summary of all slices on the disk and exit.
114 All other options will be ignored.
116 Test mode; do not write slice values. Generally used with the
118 option to see what would be written to the slice table. Implies
121 Is used for updating (editing) sector 0 of the disk. Ignored if
129 prints out the slice table that is written to the disk.
131 Operate on a single fdisk entry only. Ignored if
136 The final disk name can be provided as a
138 disk name only, e.g.\&
140 or as a fully qualified device node under
142 If omitted, the disks
147 are searched in that order, until one is found to respond.
149 When called without options,
151 prints the sector 0 slice table.
154 ******* Working on device /dev/ad0 *******
155 parameters extracted from in-core disklabel are:
156 cylinders=769 heads=15 sectors/track=33 (495 blks/cyl)
158 parameters to be used for BIOS calculations are:
159 cylinders=769 heads=15 sectors/track=33 (495 blks/cyl)
161 Warning: BIOS sector numbering starts with sector 1
162 Information from DOS bootblock is:
163 The data for partition 1 is:
164 sysid 165,(DragonFly/FreeBSD/NetBSD/386BSD)
165 start 495, size 380160 (185 Meg), flag 0
166 beg: cyl 1/ sector 1/ head 0;
167 end: cyl 768/ sector 33/ head 14
168 The data for partition 2 is:
170 start 378180, size 2475 (1 Meg), flag 0
171 beg: cyl 764/ sector 1/ head 0;
172 end: cyl 768/ sector 33/ head 14
173 The data for partition 3 is:
175 The data for partition 4 is:
176 sysid 99,(ISC UNIX, other System V/386, GNU HURD or Mach)
177 start 380656, size 224234 (109 Meg), flag 80
178 beg: cyl 769/ sector 2/ head 0;
179 end: cyl 197/ sector 33/ head 14
182 The disk is divided into three slices that happen to fill the disk.
183 The second slice overlaps the end of the first.
184 (Used for debugging purposes.)
185 .Bl -tag -width "cyl, sector and head"
187 is used to label the slice.
190 magic number 165 decimal (A5 in hex).
191 .It Em start No and Em size
192 fields provide the start address
193 and size of a slice in sectors.
195 specifies that this is the active slice.
196 .It Em cyl , sector No and Em head
197 fields are used to specify the beginning and end addresses of the slice.
199 these numbers are calculated using BIOS's understanding of the disk geometry
200 and saved in the bootblock.
207 flags are used to indicate that the slice data is to be updated.
210 option is also given,
212 will enter a conversational mode.
213 In this mode, no changes will be written to disk unless you explicitly tell
218 will display each slice and ask whether you want to edit it.
221 will step through each field, show you the old value,
222 and ask you for a new one.
223 When you are done with the slice,
225 will display it and ask you whether it is correct.
227 will then proceed to the next entry.
233 fields correct is tricky, so by default,
234 they will be calculated for you;
235 you can specify them if you choose to though.
237 After all the slices are processed,
238 you are given the option to change the
241 Finally, when all the new data for sector 0 has been accumulated,
242 you are asked to confirm whether you really want to rewrite it.
244 The difference between the
251 flag just edits (updates) the fields as they appear on the disk,
254 flag is used to "initialize" sector 0;
255 it will set up the last BIOS slice to use the whole disk for
259 The automatic calculation of starting cylinder etc. uses
260 a set of figures that represent what the BIOS thinks the
261 geometry of the drive is.
262 These figures are taken from the in-core disklabel by default,
265 initially gives you an opportunity to change them.
266 This allows you to create a bootblock that can work with drives
267 that use geometry translation under the BIOS.
269 If you hand craft your disk layout,
270 please make sure that the
272 slice starts on a cylinder boundary.
273 A number of decisions made later may assume this.
274 (This might not be necessary later.)
276 Editing an existing slice will most likely result in the loss of
277 all data in that slice.
281 interactively once or twice to see how it works.
282 This is completely safe as long as you answer the last question
283 in the negative. There are subtleties that
285 detects that are not fully explained in this manual page.
286 .Sh CONFIGURATION FILE
289 option is given, a disk's slice table can be written using values
292 The syntax of this file is very simple;
293 each line is either a comment or a specification, as follows:
299 Lines beginning with a "#" are comments and are ignored.
306 Set the BIOS geometry used in slice calculations. There must be
307 three values specified, with a letter preceding each number:
312 Set the number of cylinders to
317 Set the number of heads to
322 Set the number of sectors/track to
326 These specs can occur in any order, as the leading letter determines
327 which value is which; however, all three must be specified.
329 This line must occur before any lines that specify slice
332 It is an error if the following is not true:
333 .Bd -literal -offset indent
334 1 \(<= number of cylinders
335 1 \(<= number of heads \(<= 256
336 1 \(<= number of sectors/track < 64
339 The number of cylinders should be less than or equal to 1024, but this
340 is not enforced, although a warning will be printed. Note that bootable
342 slices (the "/" filesystem) must lie completely within the
343 first 1024 cylinders; if this is not true, booting may fail.
344 Non-bootable slices do not have this restriction.
346 Example (all of these are equivalent), for a disk with 1019 cylinders,
347 39 heads, and 63 sectors:
348 .Bd -literal -offset indent
360 Set the slice given by
370 Only those slices explicitly mentioned by these lines are modified;
371 any slice not referenced by a "p" line will not be modified.
372 However, if an invalid slice table is present, or the
374 option is specified, all existing slice entries will be cleared
375 (marked as unused), and these "p" lines will have to be used to
376 explicitly set slice information. If multiple slices need to be
377 set, multiple "p" lines must be specified; one for each slice.
379 These slice lines must occur after any geometry specification lines,
386 slices. Specifying a slice type of zero is
387 the same as clearing the slice and marking it as unused; however,
388 dummy values (such as "0") must still be specified for
393 Note: the start offset will be rounded upwards to a head boundary if
394 necessary, and the end offset will be rounded downwards to a cylinder
395 boundary if necessary.
397 Example: to clear slice 4 and mark it as unused:
398 .Bd -literal -offset indent
402 Example: to set slice 1 to a
404 slice, starting at sector 1
405 for 2503871 sectors (note: these numbers will be rounded upwards and
406 downwards to correspond to head and cylinder boundaries):
408 .Bd -literal -offset indent
418 the active slice. Can occur anywhere in the config file, but only
422 line is present, all slices of the disk are made inactive.
424 Example: to make slice 1 the active slice:
425 .Bd -literal -offset indent
430 .Bl -tag -width /boot/mbr -compact
432 The default boot code
439 The default boot code will not necessarily handle all slice types
440 correctly, in particular those introduced since MS-DOS 6.x.
442 The entire program should be made more user-friendly.
446 do not understand the difference between
450 causing difficulty to adjust.
452 You cannot use this command to completely dedicate a disk to
456 command must be used for this.