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

   1 '\" te
   2 .\" Copyright (c) 2006, 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 TNCHKDB 1M "Jul 20, 2007"
   7 .SH NAME
   8 tnchkdb \- check file syntax of trusted network databases
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/tnchkdb\fR  [\fB-h\fR \fIpath\fR] [\fB-t\fR \fIpath\fR] [\fB-z\fR \fIpath\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBtnchkdb\fR checks the syntax of the \fBtnrhtp\fR, \fBtnrhdb\fR, and
  19 \fBtnzonecfg\fR databases. By default, the \fIpath\fR for each file is:
  20 .RS +4
  21 .TP
  22 .ie t \(bu
  23 .el o
  24 \fB/etc/security/tsol/tnrhtp\fR
  25 .RE
  26 .RS +4
  27 .TP
  28 .ie t \(bu
  29 .el o
  30 \fB/etc/security/tsol/tnrhdb\fR
  31 .RE
  32 .RS +4
  33 .TP
  34 .ie t \(bu
  35 .el o
  36 \fB/etc/security/tsol/tnzonecfg\fR
  37 .RE
  38 .sp
  39 .LP
  40 You can specify an alternate path for any or all of the files by specifying
  41 that path on the command line by using the \fB-h\fR (\fBtnrhdb\fR), \fB-t\fR
  42 (\fBtnrhtp\fR) and \fB-z\fR (\fBtnzonecfg\fR) options. The options are useful
  43 when testing a set of modified files before installing the files as new system
  44 databases.
  45 .sp
  46 .LP
  47 All three database files are checked for integrity. \fBtnchkdb\fR returns an
  48 exit status of \fB0\fR if all of the files are syntactically and, to the extent
  49 possible, semantically correct. If one or more files have errors, then an exit
  50 status of \fB1\fR is returned. If there are command line problems, such as an
  51 unreadable file, an exit status of \fB2\fR is returned. Errors are written to
  52 standard error.
  53 .sp
  54 .LP
  55 To avoid cascading errors, when there are errors in \fBtnrhtp\fR, the template
  56 names in \fBtnrhdb\fR are not validated.
  57 .sp
  58 .LP
  59 \fBtnchkdb\fR can be run at any label, but the standard
  60 \fB/etc/security/tsol\fR files are visible only in the global zone.
  61 .SH OPTIONS
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB-h\fR [ \fIpath\fR ]\fR
  66 .ad
  67 .RS 15n
  68 Check \fIpath\fR for proper \fBtnrhdb\fR syntax. If \fIpath\fR is not
  69 specified, then check \fB/etc/security/tsol/tnrhdb\fR.
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB-t\fR [ \fIpath\fR ]\fR
  76 .ad
  77 .RS 15n
  78 Check \fIpath\fR for proper \fBtnrhtp\fR syntax. If \fIpath\fR is not
  79 specified, then check \fB/etc/security/tsol/tnrhtp\fR.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB-z\fR [ \fIpath\fR ]\fR
  86 .ad
  87 .RS 15n
  88 Check \fIpath\fR for proper \fBtnzonecfg\fR syntax. If \fIpath\fR is not
  89 specified, then check \fB/etc/security/tsol/tnzonecfg\fR.
  90 .RE
  91
  92 .SH EXAMPLES
  93 .LP
  94 \fBExample 1 \fRSample Error Message
  95 .sp
  96 .LP
  97 The \fBtnchkdb\fR command checks for CIPSO errors. In this example, the
  98 \fBadmin_low\fR template has an incorrect value of \fBADMIN_HIGH\fR for its
  99 default label.
 100
 101 .sp
 102 .in +2
 103 .nf
 104 # \fBtnchkdb\fR
 105 checking /etc/security/tsol/tnrhtp ...
 106 tnchkdb: def_label classification 7fff is invalid for cipso labels:
 107 line 14 entry admin_low
 108 tnchkdb: def_label compartments 241-256 must be zero for cipso labels:
 109 line 14 entry admin_low
 110 checking /etc/security/tsol/tnrhdb ...
 111 checking /etc/security/tsol/tnzonecfg ...
 112 .fi
 113 .in -2
 114 .sp
 115
 116 .SH FILES
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fB/etc/security/tsol/tnrhdb\fR\fR
 121 .ad
 122 .sp .6
 123 .RS 4n
 124 Trusted network remote-host database
 125 .RE
 126
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB/etc/security/tsol/tnrhtp\fR\fR
 131 .ad
 132 .sp .6
 133 .RS 4n
 134 Trusted network remote-host templates
 135 .RE
 136
 137 .sp
 138 .ne 2
 139 .na
 140 \fB\fB/etc/security/tsol/tnzonecfg\fR\fR
 141 .ad
 142 .sp .6
 143 .RS 4n
 144 Trusted zone configuration database
 145 .RE
 146
 147 .SH ATTRIBUTES
 148 .sp
 149 .LP
 150 See \fBattributes\fR(5) for descriptions of the following attributes:
 151 .sp
 152
 153 .sp
 154 .TS
 155 box;
 156 c | c
 157 l | l .
 158 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 159 _
 160 Interface Stability     See below.
 161 .TE
 162
 163 .sp
 164 .LP
 165 The command line is Committed. The output is Uncommitted.
 166 .SH SEE ALSO
 167 .sp
 168 .LP
 169 \fBtnd\fR(1M), \fBtnctl\fR(1M), \fBattributes\fR(5)
 170 .sp
 171 .LP
 172 \fIHow to Check the Syntax of Trusted Network Databases\fR in \fISolaris
 173 Trusted Extensions Administrator\&'s Procedures\fR
 174 .SH NOTES
 175 .sp
 176 .LP
 177 The functionality described on this manual page is available only if the system
 178 is configured with Trusted Extensions.
 179 .sp
 180 .LP
 181 It is possible to have inconsistent but valid configurations of \fBtnrhtp\fR
 182 and \fBtnrhdb\fR when \fBLDAP\fR is used to supply missing templates.