usr/src/man/man1/getlabel.1

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH GETLABEL 1 "Jul 11, 2008"
   7 .SH NAME
   8 getlabel \- display the label of files
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/bin/getlabel\fR  [\fB-sS\fR] \fIfilename\fR...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBgetlabel\fR displays the label that is associated with each \fIfilename\fR.
  19 When options are not specified, the output format of the label is displayed in
  20 default format.
  21 .SH OPTIONS
  22 .sp
  23 .ne 2
  24 .na
  25 \fB\fB-s\fR\fR
  26 .ad
  27 .RS 6n
  28 Display the label that is associated with \fIfilename\fR in short form.
  29 .RE
  30
  31 .sp
  32 .ne 2
  33 .na
  34 \fB\fB-S\fR\fR
  35 .ad
  36 .RS 6n
  37 Display the label that is associated with \fIfilename\fR in long form.
  38 .RE
  39
  40 .SH EXIT STATUS
  41 .sp
  42 .LP
  43 \fBgetlabel\fR exits with one of the following values:
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB0\fR\fR
  48 .ad
  49 .RS 5n
  50 Successful completion.
  51 .RE
  52
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fB1\fR\fR
  57 .ad
  58 .RS 5n
  59 Unsuccessful completion due to usage error.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB2\fR\fR
  66 .ad
  67 .RS 5n
  68 Unable to translate label.
  69 .RE
  70
  71 .SH ATTRIBUTES
  72 .sp
  73 .LP
  74 See \fBattributes\fR(5) for descriptions of the following attributes:
  75 .sp
  76
  77 .sp
  78 .TS
  79 box;
  80 c | c
  81 l | l .
  82 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  83 _
  84 Interface Stability     See below.
  85 .TE
  86
  87 .sp
  88 .LP
  89 The command line is Committed. The output is Not-an-Interface.
  90 .SH SEE ALSO
  91 .sp
  92 .LP
  93 \fBsetlabel\fR(1), \fBm_label\fR(3TSOL), \fBlabel_encodings\fR(4),
  94 \fBattributes\fR(5)
  95 .SH NOTES
  96 .sp
  97 .LP
  98 The functionality described on this manual page is available only if the system
  99 is configured with Trusted Extensions.