xref: /illumos-gate/usr/src/man/man8/labelit.8 (revision bbf21555)
te
Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved
Copyright 1989 AT&T
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
LABELIT 8 "Oct 31, 2000"
NAME
labelit - list or provide labels for file systems
SYNOPSIS

labelit [-F FSType] [-V] [-o FSType-specific-options] special
 [operands]
DESCRIPTION

The labelit utility is used to write or display labels on unmounted disk file systems.

OPTIONS

The following options are supported: -F FSType

Specify the FSType on which to operate. The FSType should either be specified here or be determinable from /etc/vfstab by matching the special with an entry in the table. If no matching entry is found, the default file system type specified in /etc/default/fs will be used.

-V

Echo complete command line. This option may be used to verify and validate the command line. Additional information obtained using a /etc/vfstab lookup is included in the output. The command is not executed.

-o

Specify FSType-specific options. See the manual page for the labelit module specific to the file system type.

OPERANDS

The following operands are supported. If no operands are specified, labelit will display the value of the labels. special

The disk partition (for example, /dev/rdsk/c0t3d0s6). The device may not be on a remote machine.

operands

FSType-specific operands. Consult the manual page of the FSType-specific labelit command for detailed descriptions.

USAGE

See largefile(7) for the description of the behavior of labelit when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

EXIT STATUS

The following exit values are returned: 0

Write or display of labels was successful.

non-zero

An error occurred.

FILES
/etc/vfstab

List of default parameters for each file system.

/etc/default/fs

Default local file system type. Default values can be set for the following flags in /etc/default/fs. For example: LOCAL=ufs

LOCAL

The default partition for a command if no FSType is specified.

SEE ALSO

vfstab (5), attributes (7), largefile (7), labelit_hsfs (8), labelit_udfs (8), labelit_ufs (8), volcopy (8)

NOTES

This utility may not be supported for all FSTypes.