Clarify and clean up some language, and add an explicit example.

Sponsored by:	iXsystems
Differential Revision:	https://reviews.freebsd.org/D12336
This commit is contained in:
Warren Block 2018-03-02 19:07:32 +00:00
parent d3e9ec3085
commit 21b386d516
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=330291

View File

@ -24,7 +24,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd February 10, 2018 .Dd March 2, 2018
.Dt GPART 8 .Dt GPART 8
.Os .Os
.Sh NAME .Sh NAME
@ -1327,16 +1327,16 @@ After creating all required partitions, embed bootstrap code into them:
.Bd -literal -offset indent .Bd -literal -offset indent
/sbin/gpart bootcode -p /boot/boot1 da0 /sbin/gpart bootcode -p /boot/boot1 da0
.Ed .Ed
.Ss Deleting partitions and partitioning scheme .Ss Deleting Partitions and Destroying the Partitioning Scheme
If you get a If a
.Em "Device busy" .Em "Device busy"
error when trying to destroy a partition table, remember that you must error is shown when trying to destroy a partition table, remember that
delete all its partitions first with the all of the partitions must be deleted first with the
.Cm delete .Cm delete
action. action.
In this example, assume we have In this example,
.Pa da0 .Pa da0
with three partitions: has three partitions:
.Bd -literal -offset indent .Bd -literal -offset indent
/sbin/gpart delete -i 3 da0 /sbin/gpart delete -i 3 da0
/sbin/gpart delete -i 2 da0 /sbin/gpart delete -i 2 da0
@ -1344,11 +1344,15 @@ with three partitions:
/sbin/gpart destroy da0 /sbin/gpart destroy da0
.Ed .Ed
.Pp .Pp
Alternatively, you can invoke the Rather than deleting each partition and then destroying the partitioning
.Cm destroy scheme, the
action with the
.Fl F .Fl F
flag. option can be given with
.Cm destroy
to delete all of the partitions before destroying the partitioning scheme.
This is equivalent to the previous example:
.Bd -literal -offset indent
/sbin/gpart destroy -F da0
.Ed .Ed
.Ss Backup and Restore .Ss Backup and Restore
.Pp .Pp