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