usr/src/man/man4/sel_config.4

   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 SEL_CONFIG 4 "Jul 20, 2007"
   7 .SH NAME
   8 sel_config \- selection rules for copy, cut, paste, drag and drop operations
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/dt/config/sel_config\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBsel_config\fR file specifies how a system that is configured with
  19 Trusted Extensions behaves when a user transfers data between windows that have
  20 different labels. Transfer operations include cut-and-paste, copy-and-paste,
  21 and drag-and-drop. There are two types of entries in this file: automatic
  22 confirmation and automatic reply.
  23 .SS "Automatic Confirmation"
  24 .sp
  25 .LP
  26 This type of entry specifies whether a confirmation window, the selection
  27 confirmer, displays. Each entry has the form:
  28 .sp
  29 .in +2
  30 .nf
  31 \fIrelationship\fR: \fIconfirmation\fR
  32 .fi
  33 .in -2
  34 .sp
  35
  36 .sp
  37 .LP
  38 \fIrelationship\fR identifies the result of comparing the selected data's
  39 source and destination windows' labels. There are three allowed values:
  40 .sp
  41 .ne 2
  42 .na
  43 \fB\fBupgradesl\fR\fR
  44 .ad
  45 .RS 20n
  46 The source window's label is less than the destination window's label.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fBdowngradesl\fR\fR
  53 .ad
  54 .RS 20n
  55 The source window's label is higher than the destination window's label.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fBdisjointsl\fR\fR
  62 .ad
  63 .RS 20n
  64 The source and destination windows' labels are disjoint. Neither label
  65 dominates the other.
  66 .RE
  67
  68 .sp
  69 .LP
  70 \fIconfirmation\fR specifies whether to perform automatic confirmation. Allowed
  71 values are:
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fBn\fR\fR
  76 .ad
  77 .RS 5n
  78 Use manual confirmation, that is, display the selection confirmer window. This
  79 is the default.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fBy\fR\fR
  86 .ad
  87 .RS 5n
  88 Use automatic confirmation, that is, do not display the selection confirmer
  89 window.
  90 .RE
  91
  92 .SS "Automatic Reply"
  93 .sp
  94 .LP
  95 A single user operation can involve several flows of information between the
  96 source and destination windows. The automatic reply set of entries provides a
  97 means to reduce the number of confirmations that are required of the user.
  98 .sp
  99 .LP
 100 There must be one entry of this form:
 101 .sp
 102 .in +2
 103 .nf
 104 autoreply: \fIvalue\fR
 105 .fi
 106 .in -2
 107 .sp
 108
 109 .sp
 110 .LP
 111 If \fIvalue\fR is \fBy\fR (for yes), then the remaining entries of the set are
 112 used as attributes for the selection data (rather than the actual contents) to
 113 complete the operation without confirmation. If \fIvalue\fR is \fBn\fR (for
 114 no), then the remaining entries are ignored.
 115 .sp
 116 .LP
 117 Defaults can be specified for any \fItype\fR field that appears in the
 118 Confirmer window. Below are some sample entries for defaults.
 119 .sp
 120 .in +2
 121 .nf
 122 replytype: TARGETS
 123 replytype: Pixel Sets
 124 replytype: LENGTH
 125 replytype: Type Of Monitor
 126 .fi
 127 .in -2
 128 .sp
 129
 130 .sp
 131 .LP
 132 The \fBTARGETS\fR entry, when used, returns the list of target atoms that are
 133 supported by the source window. The \fBPixel Sets\fR and \fBType Of Monitor\fR
 134 entries are used for animation during a drag-and-drop operation. The
 135 \fBLENGTH\fR entry specifies the number of bytes in the selection.
 136 .SH ATTRIBUTES
 137 .sp
 138 .LP
 139 See \fBattributes\fR(5) for descriptions of the following attributes:
 140 .sp
 141
 142 .sp
 143 .TS
 144 box;
 145 c | c
 146 l | l .
 147 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 148 _
 149 Interface Stability     Committed
 150 .TE
 151
 152 .SH SEE ALSO
 153 .sp
 154 .LP
 155 \fBattributes\fR(5)
 156 .sp
 157 .LP
 158 \fIRules When Changing the Level of Security for Data\fR in \fISolaris Trusted
 159 Extensions Administrator\&'s Procedures\fR
 160 .SH NOTES
 161 .sp
 162 .LP
 163 The functionality described on this manual page is available only if the system
 164 is configured with Trusted Extensions.