Changeset View
Changeset View
Standalone View
Standalone View
lib/geom/label/glabel.8
Show All 16 Lines | |||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | ||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | ||||
.\" 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. | ||||
.\" | .\" | ||||
.Dd March 12, 2017 | .Dd September 27, 2023 | ||||
.Dt GLABEL 8 | .Dt GLABEL 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm glabel | .Nm glabel | ||||
.Nd "disk labelization control utility" | .Nd "disk labelization control utility" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Cm create | .Cm create | ||||
▲ Show 20 Lines • Show All 102 Lines • ▼ Show 20 Lines | |||||
e.g. | e.g. | ||||
.Pa /dev/diskid/DISK-6QG3Z026 . | .Pa /dev/diskid/DISK-6QG3Z026 . | ||||
.Pp | .Pp | ||||
Generic labels created and managed solely by | Generic labels created and managed solely by | ||||
.Xr glabel 8 | .Xr glabel 8 | ||||
are created in the | are created in the | ||||
.Pa /dev/label/ | .Pa /dev/label/ | ||||
directory. | directory. | ||||
Note that generic, automatic labels occupy some space on the device | |||||
and thus should not be added to a device already containing a file system. | |||||
allanjude: should only be used when ...
reads much better | |||||
In particular, | |||||
.Nm | |||||
reserves the last sector of the device to store the label information. | |||||
If the device already contains a file system, | |||||
Done Inline Actions"should not" as in, "you can but really shouldn't"? pauamma_gundo.com: "should not" as in, "you can but really shouldn't"? | |||||
Done Inline Actions
Right. It'll work, but we'll be in a situation where both the filesystem and geom_label think they "own" the last sector of the provider. Eventually they'll step on each other. markj: > "should not" as in, "you can but really shouldn't"?
Right. It'll work, but we'll be in a… | |||||
Done Inline ActionsIt might be best to add an additional sentence here explaining why: .Nm allanjude: It might be best to add an additional sentence here explaining why:
.Nm
reserves the last… | |||||
.Nm | |||||
will overwrite the last sector, possibly damaging the file system, and the | |||||
file system may later overwrite the label sector. | |||||
Instead, create a label before initializing the file system, and initialize | |||||
that file system on the device created by | |||||
.Nm | |||||
under the | |||||
.Pa /dev/label/ | |||||
Not Done Inline ActionsDo you want to note something about the size changing here? Isn't that the real problem? imp: Do you want to note something about the size changing here? Isn't that the real problem? | |||||
directory. | |||||
Then the file system will correctly account for the space occupied by the | |||||
generic label, | |||||
since the | |||||
.Nm | |||||
device will be one sector smaller than the device from which it was created. | |||||
.Pp | .Pp | ||||
Note that for all label types, nested GEOM classes will cause additional | Note that for all label types, nested GEOM classes will cause additional | ||||
device nodes to be created, with context-specific data appended to their | device nodes to be created, with context-specific data appended to their | ||||
names. E.g. for every node like | names. E.g. for every node like | ||||
.Pa /dev/label/bigdisk | .Pa /dev/label/bigdisk | ||||
there will be additional entries for any partitions which the device | there will be additional entries for any partitions which the device | ||||
contains, like | contains, like | ||||
.Pa /dev/label/bigdiskp1 | .Pa /dev/label/bigdiskp1 | ||||
▲ Show 20 Lines • Show All 127 Lines • Show Last 20 Lines |
should only be used when ...
reads much better