version 1.39, 2015/12/01 09:05:33 |
version 1.40, 2015/12/01 22:49:25 |
|
|
.Op Fl s Ar sectorsize |
.Op Fl s Ar sectorsize |
.Ar command |
.Ar command |
.Op Ar command_options |
.Op Ar command_options |
.Ar device ... |
.Ar device |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
Line 104 There is no formalized definition of the |
|
Line 104 There is no formalized definition of the |
|
.\" ==== add ==== |
.\" ==== add ==== |
.It Nm Ic add Oo Fl a Ar alignment Oc Oo Fl b Ar blocknr Oc \ |
.It Nm Ic add Oo Fl a Ar alignment Oc Oo Fl b Ar blocknr Oc \ |
Oo Fl i Ar index Oc Oo Fl l Ar label Oc Oo Fl s Ar size Oc \ |
Oo Fl i Ar index Oc Oo Fl l Ar label Oc Oo Fl s Ar size Oc \ |
Oo Fl t Ar type Oc Ar device ... |
Oo Fl t Ar type Oc |
The |
The |
.Ic add |
.Ic add |
command allows the user to add a new partition to an existing table. |
command allows the user to add a new partition to an existing table. |
|
|
.El |
.El |
as aliases for the most commonly used partition types. |
as aliases for the most commonly used partition types. |
.\" ==== backup ==== |
.\" ==== backup ==== |
.It Nm Ic backup Ar device ... |
.It Nm Ic backup |
The |
The |
.Ic backup |
.Ic backup |
command dumps the MBR or (PMBR) and GPT partition tables to standard |
command dumps the MBR or (PMBR) and GPT partition tables to standard |
Line 210 The format is a plist. |
|
Line 210 The format is a plist. |
|
It should not be modified. |
It should not be modified. |
.\" ==== biosboot ==== |
.\" ==== biosboot ==== |
.It Nm Ic biosboot Oo Fl c Ar bootcode Oc Oo Fl i Ar index Oc \ |
.It Nm Ic biosboot Oo Fl c Ar bootcode Oc Oo Fl i Ar index Oc \ |
Oo Fl L Ar label Oc Ar device ... |
Oo Fl L Ar label Oc |
The |
The |
.Ic biosboot |
.Ic biosboot |
command allows the user to configure the partition that contains the |
command allows the user to configure the partition that contains the |
Line 236 option selects the partition by label. |
|
Line 236 option selects the partition by label. |
|
If there are multiple partitions with the same label, it will use the |
If there are multiple partitions with the same label, it will use the |
first one found. |
first one found. |
.\" ==== create ==== |
.\" ==== create ==== |
.It Nm Ic create Oo Fl fP Oc Oo Fl p Ar partitions Oc Ar device ... |
.It Nm Ic create Oo Fl fP Oc Oo Fl p Ar partitions Oc |
The |
The |
.Ic create |
.Ic create |
command allows the user to create a new (empty) GPT. |
command allows the user to create a new (empty) GPT. |
|
|
.Nm |
.Nm |
utility will create space for 128 partitions (or 32 sectors of 512 bytes). |
utility will create space for 128 partitions (or 32 sectors of 512 bytes). |
.\" ==== destroy ==== |
.\" ==== destroy ==== |
.It Nm Ic destroy Oo Fl r Oc Ar device ... |
.It Nm Ic destroy Oo Fl r Oc |
The |
The |
.Ic destroy |
.Ic destroy |
command allows the user to destroy an existing, possibly not empty GPT. |
command allows the user to destroy an existing, possibly not empty GPT. |
Line 276 option instructs |
|
Line 276 option instructs |
|
.Nm |
.Nm |
to destroy the table in a way that it can be recovered. |
to destroy the table in a way that it can be recovered. |
.\" ==== header ==== |
.\" ==== header ==== |
.It Nm Ic header Ar device ... |
.It Nm Ic header |
The |
The |
.Ic header |
.Ic header |
command displays size information about the media and information from the |
command displays size information about the media and information from the |
GPT header if it exists. |
GPT header if it exists. |
.\" ==== label ==== |
.\" ==== label ==== |
.It Nm Ic label Oo Fl a Oc Ao Fl f Ar file | Fl l Ar label Ac Ar device ... |
.It Nm Ic label Oo Fl a Oc Ao Fl f Ar file | Fl l Ar label Ac |
.It Nm Ic label Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
.It Nm Ic label Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc \ |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc \ |
Ao Fl f Ar file | Fl l Ar label Ac Ar device ... |
Ao Fl f Ar file | Fl l Ar label Ac |
The |
The |
.Ic label |
.Ic label |
command allows the user to label any partitions that match the selection. |
command allows the user to label any partitions that match the selection. |
|
|
option is used to specify the label in the command line. |
option is used to specify the label in the command line. |
The label is assumed to be encoded in UTF-8. |
The label is assumed to be encoded in UTF-8. |
.\" ==== migrate ==== |
.\" ==== migrate ==== |
.It Nm Ic migrate Oo Fl fs Oc Oo Fl p Ar partitions Oc Ar device ... |
.It Nm Ic migrate Oo Fl fs Oc Oo Fl p Ar partitions Oc |
The |
The |
.Ic migrate |
.Ic migrate |
command allows the user to migrate an MBR-based disk partitioning into a |
command allows the user to migrate an MBR-based disk partitioning into a |
Line 393 beginning of the device, but don't have |
|
Line 393 beginning of the device, but don't have |
|
For the default GPT partition table size on a 512 byte sector size device, |
For the default GPT partition table size on a 512 byte sector size device, |
33 sectors at the end of the device would need to be freed. |
33 sectors at the end of the device would need to be freed. |
.\" ==== recover ==== |
.\" ==== recover ==== |
.It Nm Ic recover Ar device ... |
.It Nm Ic recover |
The |
The |
.Ic recover |
.Ic recover |
command tries to restore the GPT partition label from the backup |
command tries to restore the GPT partition label from the backup |
near the end of the disk. |
near the end of the disk. |
It is very useful in case the primary label was deleted. |
It is very useful in case the primary label was deleted. |
.\" ==== remove ==== |
.\" ==== remove ==== |
.It Nm Ic remove Oo Fl a Oc Ar device ... |
.It Nm Ic remove Oo Fl a Oc |
.It Nm Ic remove Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
.It Nm Ic remove Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc Ar device ... |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc |
The |
The |
.Ic remove |
.Ic remove |
command allows the user to remove any and all partitions that match the |
command allows the user to remove any and all partitions that match the |
Line 415 Partitions are removed by clearing the p |
|
Line 415 Partitions are removed by clearing the p |
|
No other information is changed. |
No other information is changed. |
.\" ==== resize ==== |
.\" ==== resize ==== |
.It Nm Ic resize Fl i Ar index Oo Fl a Ar alignment Oc \ |
.It Nm Ic resize Fl i Ar index Oo Fl a Ar alignment Oc \ |
Oo Fl s Ar size Oc Ar device ... |
Oo Fl s Ar size Oc |
The |
The |
.Ic resize |
.Ic resize |
command allows the user to resize a partition. |
command allows the user to resize a partition. |
|
|
option is specified then the size will be adjusted to be a multiple of |
option is specified then the size will be adjusted to be a multiple of |
alignment if possible. |
alignment if possible. |
.\" ==== resizedisk ==== |
.\" ==== resizedisk ==== |
.It Nm Ic resizedisk Oo Fl s Ar size Oc Ar device ... |
.It Nm Ic resizedisk Oo Fl s Ar size Oc |
The |
The |
.Ic resizedisk |
.Ic resizedisk |
command allows the user to resize a disk. |
command allows the user to resize a disk. |
|
|
option allows you to move the backup copy prior to resizing the medium. |
option allows you to move the backup copy prior to resizing the medium. |
This is primarily useful when shrinking the medium. |
This is primarily useful when shrinking the medium. |
.\" ==== restore ==== |
.\" ==== restore ==== |
.It Nm Ic restore Oo Fl F Oc Ar device ... |
.It Nm Ic restore Oo Fl F Oc |
The |
The |
.Ic restore |
.Ic restore |
command restores a partition table that was previously saved using the |
command restores a partition table that was previously saved using the |
Line 483 the partitions fit, as |
|
Line 483 the partitions fit, as |
|
will automatically adjust. |
will automatically adjust. |
However, the new disk must use the same sector size as the old disk. |
However, the new disk must use the same sector size as the old disk. |
.\" ==== set ==== |
.\" ==== set ==== |
.It Nm Ic set Fl a Ar attribute Fl i Ar index Ar device ... |
.It Nm Ic set Fl a Ar attribute Fl i Ar index |
The |
The |
.Ic set |
.Ic set |
command sets various partition attributes. |
command sets various partition attributes. |
Line 512 They may be used by |
|
Line 512 They may be used by |
|
.Nx |
.Nx |
code in the future. |
code in the future. |
.\" ==== show ==== |
.\" ==== show ==== |
.It Nm Ic show Oo Fl glu Oc Oo Fl i Ar index Oc Ar device ... |
.It Nm Ic show Oo Fl glu Oc Oo Fl i Ar index Oc |
The |
The |
.Ic show |
.Ic show |
command displays the current partitioning on the listed devices and gives |
command displays the current partitioning on the listed devices and gives |
Line 540 The order of precedence for the options |
|
Line 540 The order of precedence for the options |
|
.Fl g , |
.Fl g , |
.Fl u . |
.Fl u . |
.\" ==== type ==== |
.\" ==== type ==== |
.It Nm Ic type Oo Fl a Oc Fl T Ar newtype Ar device ... |
.It Nm Ic type Oo Fl a Oc Fl T Ar newtype |
.It Nm Ic type Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
.It Nm Ic type Oo Fl b Ar blocknr Oc Oo Fl i Ar index Oc \ |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc \ |
Oo Fl L Ar label Oc Oo Fl s Ar sectors Oc Oo Fl t Ar type Oc \ |
Fl T Ar newtype Ar device ... |
Fl T Ar newtype |
The |
The |
.Ic type |
.Ic type |
command allows the user to change the type of any and all partitions |
command allows the user to change the type of any and all partitions |
Line 553 It uses the same selection options as th |
|
Line 553 It uses the same selection options as th |
|
command. |
command. |
See above for a description of these options. |
See above for a description of these options. |
.\" ==== unset ==== |
.\" ==== unset ==== |
.It Nm Ic unset Fl a Ar attribute Fl i Ar index Ar device ... |
.It Nm Ic unset Fl a Ar attribute Fl i Ar index |
The |
The |
.Ic unset |
.Ic unset |
command unsets various partition attributes. |
command unsets various partition attributes. |
Line 649 one thinks one does not make mistakes. |
|
Line 649 one thinks one does not make mistakes. |
|
It is expected that the basic usage model does not change, but it is |
It is expected that the basic usage model does not change, but it is |
possible that future versions will not be compatible in the strictest sense |
possible that future versions will not be compatible in the strictest sense |
of the word. |
of the word. |
For example, the |
|
.Fl p Ar partitions |
|
option may be changed to a command option rather than a generic option. |
|
There are only two commands that use it so there is a chance that the natural |
|
tendency for people is to use it as a command option. |
|
Also, options primarily intended for diagnostic or debug purposes may be |
Also, options primarily intended for diagnostic or debug purposes may be |
removed in future versions. |
removed in future versions. |
.Pp |
.Pp |