Changeset View
Changeset View
Standalone View
Standalone View
lib/geom/part/gpart.8
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd August 17, 2020 | .Dd November 29, 2021 | ||||
.Dt GPART 8 | .Dt GPART 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm gpart | .Nm gpart | ||||
.Nd "control utility for the disk partitioning GEOM class" | .Nd "control utility for the disk partitioning GEOM class" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.\" ==== ADD ==== | .\" ==== ADD ==== | ||||
.Nm | .Nm | ||||
Show All 23 Lines | |||||
.Cm commit | .Cm commit | ||||
.Ar geom | .Ar geom | ||||
.\" ==== CREATE ==== | .\" ==== CREATE ==== | ||||
.Nm | .Nm | ||||
.Cm create | .Cm create | ||||
.Fl s Ar scheme | .Fl s Ar scheme | ||||
.Op Fl n Ar entries | .Op Fl n Ar entries | ||||
.Op Fl f Ar flags | .Op Fl f Ar flags | ||||
.Op Fl l Ar pritbl | |||||
.Op Fl L Ar sectbl | |||||
0mp: It would be great to sort those flags while we are here: f, L, l, n. | |||||
.Ar provider | .Ar provider | ||||
.\" ==== DELETE ==== | .\" ==== DELETE ==== | ||||
.Nm | .Nm | ||||
.Cm delete | .Cm delete | ||||
.Fl i Ar index | .Fl i Ar index | ||||
.Op Fl f Ar flags | .Op Fl f Ar flags | ||||
.Ar geom | .Ar geom | ||||
.\" ==== DESTROY ==== | .\" ==== DESTROY ==== | ||||
▲ Show 20 Lines • Show All 221 Lines • ▼ Show 20 Lines | |||||
Some schemes have a maximum equal to the minimum and some schemes have | Some schemes have a maximum equal to the minimum and some schemes have | ||||
a maximum large enough to be considered unlimited. | a maximum large enough to be considered unlimited. | ||||
By default, partition tables are created with the minimum number of | By default, partition tables are created with the minimum number of | ||||
entries. | entries. | ||||
.It Fl s Ar scheme | .It Fl s Ar scheme | ||||
Specify the partitioning scheme to use. | Specify the partitioning scheme to use. | ||||
The kernel must have support for a particular scheme before | The kernel must have support for a particular scheme before | ||||
that scheme can be used to partition a disk. | that scheme can be used to partition a disk. | ||||
.El | |||||
.Pp | |||||
In addition the | |||||
.Cd GPT scheme | |||||
0mpUnsubmitted Not Done Inline ActionsCd is for kernel configuration (see man mdoc). If necessary, we could use Sy or Em to make this fragment stand out more. From what I see, however, GPT scheme is not emphasized in other parts of this manual. I'd just drop the extra style macro from this line but if you see it's needed, then Sy or Em are more appropriate. Tip: if you want to have live-preview a manual in your tmux session as you are working on a manual page, then check out textproc/mantra. 0mp: Cd is for kernel configuration (see `man mdoc`). If necessary, we could use Sy or Em to make… | |||||
accepts the following options to the | |||||
.Cm create | |||||
command: | |||||
.Bl -tag -width 10n | |||||
.It Fl l Ar pritbl | |||||
The offset in bytes where the primary GPT partition table will begin. | |||||
This can be useful for embedded devices which want to place firmware | |||||
in the low blocks but still allow the first two disk sectors to be used | |||||
for the pmbr and the primary GPT partition header. | |||||
An SI unit suffix is not allowed. | |||||
.It Fl L Ar sectbl | |||||
0mpUnsubmitted Not Done Inline ActionsL should go before l. 0mp: L should go before l. | |||||
The offset in bytes where the secondary GPT partition table will begin | |||||
(growing backwards). | |||||
An SI unit suffix is not allowed. | |||||
pauamma_gundo.comUnsubmitted Not Done Inline ActionsIf it's growing backwards, isn't that the offset where that table ends, rather then begins? Needs clarification and disambiguation. (I can't read the code well enough to figure out what it should say.) pauamma_gundo.com: If it's growing backwards, isn't that the offset where that table ends, rather then begins? | |||||
.El | .El | ||||
.\" ==== DELETE ==== | .\" ==== DELETE ==== | ||||
.It Cm delete | .It Cm delete | ||||
Delete a partition from geom | Delete a partition from geom | ||||
.Ar geom | .Ar geom | ||||
and further identified by the | and further identified by the | ||||
.Fl i Ar index | .Fl i Ar index | ||||
option. | option. | ||||
▲ Show 20 Lines • Show All 1,211 Lines • Show Last 20 Lines |
It would be great to sort those flags while we are here: f, L, l, n.