Differential D21350 Diff 61624 head/lib/geom/part/gpart.8

Changeset View

Standalone View

head/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 June 17, 2018			.Dd September 3, 2019
	.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 20 Lines • Show All 1,166 Lines • ▼ Show 20 Lines
	.Sh SYSCTL VARIABLES			.Sh SYSCTL VARIABLES
	The following			The following
	.Xr sysctl 8			.Xr sysctl 8
	variables can be used to control the behavior of the			variables can be used to control the behavior of the
	.Nm PART			.Nm PART
	GEOM class.			GEOM class.
	The default value is shown next to each variable.			The default value is shown next to each variable.
	.Bl -tag -width indent			.Bl -tag -width indent
				.It Va kern.geom.part.allow_nesting : No 0
				By default, some schemes (currently BSD, BSD64 and VTOC8) do not permit
				further nested partitioning.
				This variable overrides this restriction and allows arbitrary nesting (except
				within partitions created at offset 0).
				Some schemes have their own separate checks, for which see below.
	.It Va kern.geom.part.auto_resize: No 1			.It Va kern.geom.part.auto_resize : No 1
	This variable controls automatic resize behavior of			This variable controls automatic resize behavior of
	.Nm			.Nm
	GEOM class.			GEOM class.
	When this variable is enable and new size of provider is detected, the schema			When this variable is enable and new size of provider is detected, the schema
	metadata is resized but all changes are not saved to disk, until			metadata is resized but all changes are not saved to disk, until
	.Cm gpart commit			.Cm gpart commit
	is run to confirm changes.			is run to confirm changes.
	This behavior is also reported with diagnostic message:			This behavior is also reported with diagnostic message:
	.Sy "GEOM_PART: (provider) was automatically resized."			.Sy "GEOM_PART: (provider) was automatically resized."
	.Sy "Use `gpart commit (provider)` to save changes or `gpart undo (provider)`"			.Sy "Use `gpart commit (provider)` to save changes or `gpart undo (provider)`"
	.Sy "to revert them."			.Sy "to revert them."
	.It Va kern.geom.part.check_integrity : No 1			.It Va kern.geom.part.check_integrity : No 1
	This variable controls the behaviour of metadata integrity checks.			This variable controls the behaviour of metadata integrity checks.
	When integrity checks are enabled, the			When integrity checks are enabled, the
	.Nm PART			.Nm PART
	GEOM class verifies all generic partition parameters obtained from the			GEOM class verifies all generic partition parameters obtained from the
	disk metadata.			disk metadata.
	If some inconsistency is detected, the partition table will be			If some inconsistency is detected, the partition table will be
	rejected with a diagnostic message:			rejected with a diagnostic message:
	.Sy "GEOM_PART: Integrity check failed (provider, scheme)" .			.Sy "GEOM_PART: Integrity check failed (provider, scheme)" .
				.It Va kern.geom.part.gpt.allow_nesting : No 0
				By default the GPT scheme is allowed only at the outermost nesting level.
				This variable allows this restriction to be removed.
	.It Va kern.geom.part.ldm.debug : No 0			.It Va kern.geom.part.ldm.debug : No 0
	Debug level of the Logical Disk Manager (LDM) module.			Debug level of the Logical Disk Manager (LDM) module.
	This can be set to a number between 0 and 2 inclusive.			This can be set to a number between 0 and 2 inclusive.
	If set to 0 minimal debug information is printed,			If set to 0 minimal debug information is printed,
	and if set to 2 the maximum amount of debug information is printed.			and if set to 2 the maximum amount of debug information is printed.
	.It Va kern.geom.part.ldm.show_mirrors : No 0			.It Va kern.geom.part.ldm.show_mirrors : No 0
	This variable controls how the Logical Disk Manager (LDM) module handles			This variable controls how the Logical Disk Manager (LDM) module handles
	mirrored volumes.			mirrored volumes.
	▲ Show 20 Lines • Show All 212 Lines • Show Last 20 Lines