usr/src/man/man1m/labelit.1m

   1 '\" te
   2 .\" Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" Copyright 1989 AT&T
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH LABELIT 1M "Oct 31, 2000"
   8 .SH NAME
   9 labelit \- list or provide labels for file systems
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBlabelit\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] [\fB-o\fR \fIFSType-specific-options\fR] \fIspecial\fR
  14      [\fIoperands\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBlabelit\fR utility is used to write or display labels on unmounted disk
  21 file systems.
  22 .SH OPTIONS
  23 .sp
  24 .LP
  25 The following options are supported:
  26 .sp
  27 .ne 2
  28 .na
  29 \fB\fB-F\fR \fIFSType\fR\fR
  30 .ad
  31 .RS 13n
  32 Specify the \fIFSType\fR on which to operate. The \fIFSType\fR should either be
  33 specified here or be determinable from \fB/etc/vfstab\fR by matching the
  34 \fIspecial\fR with an entry in the table. If no matching entry is found, the
  35 default file system type specified in \fB/etc/default/fs\fR will be used.
  36 .RE
  37
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-V\fR\fR
  42 .ad
  43 .RS 13n
  44 Echo complete command line. This option may be used to verify and validate the
  45 command line. Additional information obtained using a \fB/etc/vfstab\fR lookup
  46 is included in the output. The command is not executed.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fB-o\fR\fR
  53 .ad
  54 .RS 13n
  55 Specify \fIFSType\fR-specific options. See the manual page for the
  56 \fBlabelit\fR module specific to the file system type.
  57 .RE
  58
  59 .SH OPERANDS
  60 .sp
  61 .LP
  62 The following operands are supported. If no operands are specified,
  63 \fBlabelit\fR will display the value of the labels.
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fIspecial\fR\fR
  68 .ad
  69 .RS 12n
  70 The disk partition (for example, \fB/dev/rdsk/c0t3d0s6\fR). The device may not
  71 be on a remote machine.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fIoperands\fR\fR
  78 .ad
  79 .RS 12n
  80 \fIFSType\fR-specific operands. Consult the manual page of the
  81 \fIFSType\fR-specific \fBlabelit\fR command for detailed descriptions.
  82 .RE
  83
  84 .SH USAGE
  85 .sp
  86 .LP
  87 See \fBlargefile\fR(5) for the description of the behavior of \fBlabelit\fR
  88 when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
  89 .SH EXIT STATUS
  90 .sp
  91 .LP
  92 The following exit values are returned:
  93 .sp
  94 .ne 2
  95 .na
  96 \fB\fB0\fR\fR
  97 .ad
  98 .RS 12n
  99 Write or display of labels was successful.
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fBnon-zero\fR
 106 .ad
 107 .RS 12n
 108 An error occurred.
 109 .RE
 110
 111 .SH FILES
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB/etc/vfstab\fR\fR
 116 .ad
 117 .RS 19n
 118 List of default parameters for each file system.
 119 .RE
 120
 121 .sp
 122 .ne 2
 123 .na
 124 \fB\fB/etc/default/fs\fR\fR
 125 .ad
 126 .RS 19n
 127 Default local file system type. Default values can be set for the following
 128 flags in \fB/etc/default/fs\fR. For example:
 129 .sp
 130 .ne 2
 131 .na
 132 \fB\fBLOCAL=ufs\fR\fR
 133 .ad
 134 .br
 135 .na
 136 \fB\fBLOCAL\fR\fR
 137 .ad
 138 .RS 13n
 139 The default partition for a command if no \fIFSType\fR is specified.
 140 .RE
 141
 142 .RE
 143
 144 .SH SEE ALSO
 145 .sp
 146 .LP
 147 \fBlabelit_hsfs\fR(1M), \fBlabelit_udfs\fR(1M), \fBlabelit_ufs\fR(1M),
 148 \fBvolcopy\fR(1M), \fBvfstab\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5)
 149 .SH NOTES
 150 .sp
 151 .LP
 152 This utility may not be supported for all \fIFSTypes\fR.