Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.\" Copyright (c) 2004 Pawel Jakub Dawidek <pjd@FreeBSD.org>
|
|
|
|
.\" All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" 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
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" $FreeBSD$
|
|
|
|
.\"
|
|
|
|
.Dd Jul 2, 2004
|
|
|
|
.Dt GLABEL 8
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm glabel
|
|
|
|
.Nd "disk labelization control utility"
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
|
|
|
.Cm create
|
|
|
|
.Op Fl v
|
|
|
|
.Ar name
|
|
|
|
.Ar dev
|
|
|
|
.Nm
|
2004-07-05 21:16:37 +00:00
|
|
|
.Cm destroy
|
|
|
|
.Op Fl fv
|
|
|
|
.Ar name
|
|
|
|
.Op Ar name Op Ar ...
|
|
|
|
.Nm
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Cm label
|
|
|
|
.Op Fl v
|
|
|
|
.Ar name
|
|
|
|
.Ar dev
|
|
|
|
.Nm
|
2004-07-05 21:16:37 +00:00
|
|
|
.Cm stop
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Op Fl fv
|
|
|
|
.Ar name
|
|
|
|
.Op Ar name Op Ar ...
|
|
|
|
.Nm
|
|
|
|
.Cm clear
|
|
|
|
.Op Fl v
|
|
|
|
.Ar dev
|
|
|
|
.Op Ar dev Op Ar ...
|
|
|
|
.Nm
|
|
|
|
.Cm list
|
|
|
|
.Op Ar prov Op Ar ...
|
|
|
|
.Nm
|
|
|
|
.Cm load
|
|
|
|
.Op Fl v
|
|
|
|
.Nm
|
|
|
|
.Cm unload
|
|
|
|
.Op Fl v
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility is used for GEOM providers labelization.
|
|
|
|
A label can be setup on a GEOM provider in two ways:
|
|
|
|
.Dq manual
|
|
|
|
or
|
|
|
|
.Dq automatic .
|
|
|
|
When using the
|
|
|
|
.Dq manual
|
|
|
|
method, no metadata are stored on the devices, so a label has to be configured
|
|
|
|
by hand every time it is needed.
|
|
|
|
The
|
|
|
|
.Dq automatic
|
2004-07-03 08:36:09 +00:00
|
|
|
method uses on-disk metadata to store the label and detect it automatically in
|
|
|
|
the future.
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Pp
|
2004-07-03 08:36:09 +00:00
|
|
|
This class also provides volume label detection for file systems.
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
Those labels cannot be set with
|
|
|
|
.Nm ,
|
|
|
|
but must be set with the appropriate file system utility, e.g. for UFS
|
|
|
|
the file system label is set with
|
|
|
|
.Xr tunefs 8 .
|
|
|
|
Currently supported file systems are:
|
|
|
|
.Pp
|
|
|
|
.Bl -bullet -offset indent -compact
|
|
|
|
.It
|
|
|
|
UFS1 (directory
|
|
|
|
.Pa /dev/ufs/ ) .
|
|
|
|
.It
|
|
|
|
UFS2 (directory
|
|
|
|
.Pa /dev/ufs/ ) .
|
|
|
|
.It
|
|
|
|
MSDOSFS (FAT12, FAT16, FAT32) (directory
|
|
|
|
.Pa /dev/msdosfs/ ) .
|
|
|
|
.It
|
|
|
|
CD ISO9660 (directory
|
|
|
|
.Pa /dev/iso9660/ ) .
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
Non file-system labels are created in the directory
|
|
|
|
.Pa /dev/label/ .
|
|
|
|
.Pp
|
|
|
|
The first argument to
|
|
|
|
.Nm
|
|
|
|
indicates an action to be performed:
|
|
|
|
.Bl -tag -width ".Cm destroy"
|
|
|
|
.It Cm create
|
|
|
|
Create temporary label
|
|
|
|
.Ar name
|
|
|
|
for the given provider.
|
|
|
|
This is the
|
|
|
|
.Dq manual
|
|
|
|
method.
|
|
|
|
The kernel module
|
|
|
|
.Pa geom_label.ko
|
|
|
|
will be loaded if it is not loaded already.
|
|
|
|
.It Cm label
|
|
|
|
Setup a label
|
|
|
|
.Ar name
|
|
|
|
for the given provider.
|
|
|
|
This is the
|
|
|
|
.Dq automatic
|
2004-07-03 08:36:09 +00:00
|
|
|
method, where metadata is stored in provider's last sector.
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
The kernel module
|
|
|
|
.Pa geom_label.ko
|
|
|
|
will be loaded if it is not loaded already.
|
2004-07-05 21:16:37 +00:00
|
|
|
.It Cm stop
|
|
|
|
Turn off the given label by its
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Ar name .
|
2004-07-05 21:16:37 +00:00
|
|
|
This command doesn't touch on-disk metadata!
|
|
|
|
.It Cm destroy
|
|
|
|
Same as
|
|
|
|
.Cm stop .
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.It Cm clear
|
|
|
|
Clear metadata on the given devices.
|
|
|
|
.It Cm list
|
|
|
|
List all currently configured devices, or list the given devices.
|
|
|
|
.It Cm load
|
|
|
|
Load
|
|
|
|
.Pa geom_label.ko
|
|
|
|
kernel module.
|
|
|
|
.It Cm unload
|
|
|
|
Unload
|
|
|
|
.Pa geom_label.ko
|
|
|
|
kernel module.
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
Additional options:
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl f
|
|
|
|
Force the removal of the specified labels.
|
|
|
|
.It Fl v
|
|
|
|
Be more verbose.
|
|
|
|
.El
|
|
|
|
.Sh EXAMPLES
|
|
|
|
The following example shows how to setup a label for disk da2,
|
|
|
|
create a file system on it, and mount it:
|
|
|
|
.Bd -literal -offset indent
|
|
|
|
glabel label -v usr /dev/da2
|
|
|
|
newfs /dev/label/usr
|
|
|
|
mount /dev/label/usr /usr
|
2004-07-05 21:16:37 +00:00
|
|
|
[...]
|
|
|
|
umount /usr
|
|
|
|
glabel stop usr
|
|
|
|
glabel unload
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Ed
|
|
|
|
.Pp
|
|
|
|
The next example shows how to setup a label for a UFS file system:
|
|
|
|
.Bd -literal -offset indent
|
|
|
|
tunefs -L data /dev/da4s1a
|
|
|
|
mount /dev/ufs/data /mnt/data
|
|
|
|
.Ed
|
|
|
|
.Sh DIAGNOSTICS
|
|
|
|
Exit status is 0 on success, and 1 if the command fails.
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr geom 4 ,
|
|
|
|
.Xr geom 8 ,
|
|
|
|
.Xr mount 8 ,
|
|
|
|
.Xr newfs 8 ,
|
2004-07-05 21:16:37 +00:00
|
|
|
.Xr tunefs 8 ,
|
|
|
|
.Xr umount 8
|
Introduce GEOM_LABEL class.
This class is used for detecting volume labels on file systems:
UFS, MSDOSFS (FAT12, FAT16, FAT32) and ISO9660.
It also provide native labelization (there is no need for file system).
g_label_ufs.c is based on geom_vol_ffs from Gordon Tetlow.
g_label_msdos.c and g_label_iso9660.c are probably hacks, I just found
where volume labels are stored and I use those offsets here,
but with this class it should be easy to do it as it should be done by
someone who know how.
Implementing volume labels detection for other file systems also should
be trivial.
New providers are created in those directories:
/dev/ufs/ (UFS1, UFS2)
/dev/msdosfs/ (FAT12, FAT16, FAT32)
/dev/iso9660/ (ISO9660)
/dev/label/ (native labels, configured with glabel(8))
Manual page cleanups and some comments inside were submitted by
Simon L. Nielsen, who was, as always, very helpful. Thanks!
2004-07-02 19:40:36 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility appeared in
|
|
|
|
.Fx 5.3 .
|
|
|
|
.Sh AUTHORS
|
|
|
|
.An Pawel Jakub Dawidek Aq pjd@FreeBSD.org
|