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

   1 '\" te
   2 .\" Copyright (c) 2007, 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 HEXTOALABEL 1M "Jul 20, 2007"
   7 .SH NAME
   8 hextoalabel \- convert an internal text label to its human readable equivalent
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/hextoalabel\fR [\fIinternal-text-sensitivity-label\fR]
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fB/usr/sbin/hextoalabel\fR \fB-c\fR [\fIinternal-text-clearance\fR]
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 \fBhextoalabel\fR converts an internal text label into its human readable
  24 equivalent and writes the result to the standard output file. This internal
  25 form is often hexadecimal. If no option is supplied, the label is assumed to be
  26 a sensitivity label.
  27 .sp
  28 .LP
  29 If no internal text label is specified, the label is read from the standard
  30 input file. The expected use of this command is emergency repair of labels that
  31 are stored in internal databases.
  32 .SH OPTIONS
  33 .sp
  34 .ne 2
  35 .na
  36 \fB\fB-c\fR\fR
  37 .ad
  38 .RS 6n
  39 Identifies the internal text label as a clearance.
  40 .RE
  41
  42 .SH EXIT STATUS
  43 .sp
  44 .LP
  45 The following exit values are returned:
  46 .sp
  47 .ne 2
  48 .na
  49 \fB\fB0\fR\fR
  50 .ad
  51 .RS 5n
  52 On success.
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB1\fR\fR
  59 .ad
  60 .RS 5n
  61 On failure, and writes diagnostics to the standard error file.
  62 .RE
  63
  64 .SH ATTRIBUTES
  65 .sp
  66 .LP
  67 See \fBattributes\fR(5) for descriptions of the following attributes:
  68 .sp
  69
  70 .sp
  71 .TS
  72 box;
  73 c | c
  74 l | l .
  75 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  76 _
  77 Interface Stability     See below.
  78 .TE
  79
  80 .sp
  81 .LP
  82 The command output is Committed for systems with the same \fBlabel_encodings\fR
  83 file. The command invocation is Committed for systems that implement the DIA
  84 MAC policy.
  85 .SH FILES
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB/etc/security/tsol/label_encodings\fR\fR
  90 .ad
  91 .sp .6
  92 .RS 4n
  93 The label encodings file contains the classification names, words, constraints,
  94 and values for the defined labels of this system.
  95 .RE
  96
  97 .SH SEE ALSO
  98 .sp
  99 .LP
 100 \fBatohexlabel\fR(1M), \fBlabel_to_str\fR(3TSOL), \fBstr_to_label\fR(3TSOL),
 101 \fBlabel_encodings\fR(4), \fBattributes\fR(5)
 102 .sp
 103 .LP
 104 \fIHow to Get a Readable Label From Its Hexadecimal Form\fR in \fISolaris
 105 Trusted Extensions Administrator\&'s Procedures\fR
 106 .SH NOTES
 107 .sp
 108 .LP
 109 The functionality described on this manual page is available only if the system
 110 is configured with Trusted Extensions.
 111 .sp
 112 .LP
 113 This file is part of the Defense Intelligence Agency (DIA) Mandatory Access
 114 Control (MAC) policy. This file might not be applicable to other MAC policies
 115 that might be developed for future releases of Solaris Trusted Extensions
 116 software.