← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/Xt/XtGetSP.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/doc/man/Xt/XtGetSP.man
 
1
.\" $Xorg: XtGetSP.man,v 1.3 2000/08/17 19:42:00 cpqbld Exp $
 
2
.\"
 
3
.\" Copyright (c) 1993, 1994  X Consortium
 
4
.\" 
 
5
.\" Permission is hereby granted, free of charge, to any person obtaining a
 
6
.\" copy of this software and associated documentation files (the "Software"), 
 
7
.\" to deal in the Software without restriction, including without limitation 
 
8
.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, 
 
9
.\" and/or sell copies of the Software, and to permit persons to whom the 
 
10
.\" Software furnished to do so, subject to the following conditions:
 
11
.\" 
 
12
.\" The above copyright notice and this permission notice shall be included in
 
13
.\" all copies or substantial portions of the Software.
 
14
.\" 
 
15
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 
16
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 
17
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL 
 
18
.\" THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
 
19
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF 
 
20
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 
 
21
.\" SOFTWARE.
 
22
.\" 
 
23
.\" Except as contained in this notice, the name of the X Consortium shall not 
 
24
.\" be used in advertising or otherwise to promote the sale, use or other 
 
25
.\" dealing in this Software without prior written authorization from the 
 
26
.\" X Consortium.
 
27
.\"
 
28
.\" $XFree86: xc/doc/man/Xt/XtGetSP.man,v 1.3 2001/02/09 03:47:51 tsi Exp $
 
29
.\"
 
30
.ds tk X Toolkit
 
31
.ds xT X Toolkit Intrinsics \- C Language Interface
 
32
.ds xI Intrinsics
 
33
.ds xW X Toolkit Athena Widgets \- C Language Interface
 
34
.ds xL Xlib \- C Language X Interface
 
35
.ds xC Inter-Client Communication Conventions Manual
 
36
.ds Rn 3
 
37
.ds Vn 2.2
 
38
.hw XtSet-Selection-Parameters XtGet-Selection-Parameters wid-get
 
39
.na
 
40
.de Ds
 
41
.nf
 
42
.\\$1D \\$2 \\$1
 
43
.ft 1
 
44
.ps \\n(PS
 
45
.\".if \\n(VS>=40 .vs \\n(VSu
 
46
.\".if \\n(VS<=39 .vs \\n(VSp
 
47
..
 
48
.de De
 
49
.ce 0
 
50
.if \\n(BD .DF
 
51
.nr BD 0
 
52
.in \\n(OIu
 
53
.if \\n(TM .ls 2
 
54
.sp \\n(DDu
 
55
.fi
 
56
..
 
57
.de FD
 
58
.LP
 
59
.KS
 
60
.TA .5i 3i
 
61
.ta .5i 3i
 
62
.nf
 
63
..
 
64
.de FN
 
65
.fi
 
66
.KE
 
67
.LP
 
68
..
 
69
.de IN          \" send an index entry to the stderr
 
70
..
 
71
.de C{
 
72
.KS
 
73
.nf
 
74
.D
 
75
.\"
 
76
.\"     choose appropriate monospace font
 
77
.\"     the imagen conditional, 480,
 
78
.\"     may be changed to L if LB is too
 
79
.\"     heavy for your eyes...
 
80
.\"
 
81
.ie "\\*(.T"480" .ft L
 
82
.el .ie "\\*(.T"300" .ft L
 
83
.el .ie "\\*(.T"202" .ft PO
 
84
.el .ie "\\*(.T"aps" .ft CW
 
85
.el .ft R
 
86
.ps \\n(PS
 
87
.ie \\n(VS>40 .vs \\n(VSu
 
88
.el .vs \\n(VSp
 
89
..
 
90
.de C}
 
91
.DE
 
92
.R
 
93
..
 
94
.de Pn
 
95
.ie t \\$1\fB\^\\$2\^\fR\\$3
 
96
.el \\$1\fI\^\\$2\^\fP\\$3
 
97
..
 
98
.de ZN
 
99
.ie t \fB\^\\$1\^\fR\\$2
 
100
.el \fI\^\\$1\^\fP\\$2
 
101
..
 
102
.de NT
 
103
.ne 7
 
104
.ds NO Note
 
105
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
 
106
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
 
107
.ie n .sp
 
108
.el .sp 10p
 
109
.TB
 
110
.ce
 
111
\\*(NO
 
112
.ie n .sp
 
113
.el .sp 5p
 
114
.if '\\$1'C' .ce 99
 
115
.if '\\$2'C' .ce 99
 
116
.in +5n
 
117
.ll -5n
 
118
.R
 
119
..
 
120
.               \" Note End -- doug kraft 3/85
 
121
.de NE
 
122
.ce 0
 
123
.in -5n
 
124
.ll +5n
 
125
.ie n .sp
 
126
.el .sp 10p
 
127
..
 
128
.ny0
 
129
.TH XtGetSelectionParameters 3Xt __xorgversion__ "XT FUNCTIONS"
 
130
.SH NAME
 
131
XtGetSelectionParameters \- retrieve target parameters for a selection request with a single target
 
132
.SH SYNTAX
 
133
void XtGetSelectionParameters(\fIowner\fP, \fIselection\fP, \fIrequest_id\fP,
 
134
\fItype_return\fP, \fIvalue_return\fP, \fIlength_return\fP, \fIformat_return\fP)
 
135
.br
 
136
      Widget \fIowner\fP;
 
137
.br
 
138
      Atom \fIselection\fP;
 
139
.br
 
140
      XtRequestId \fIrequest_id\fP;
 
141
.br
 
142
      Atom* \fItype_return\fP;
 
143
.br
 
144
      XtPointer* \fIvalue_return\fP;
 
145
.br
 
146
      unsigned long* \fIlength_return\fP;
 
147
.br
 
148
      int* \fIformat_return\fP;
 
149
.SH ARGUMENTS
 
150
.IP \fIowner\fP 1i
 
151
Specifies the widget that owns the specified selection.
 
152
.IP \fIselection\fP 1i
 
153
Specifies the selection being processed.
 
154
.IP \fIrequest_id\fP 1i
 
155
Specifies the requestor id in the case of incremental selections, or NULL
 
156
in the case of atomic transfers.
 
157
.IP \fItype_return\fP 1i
 
158
Specifies a pointer to an atom in whcih the property type of the
 
159
parameters will be stored.
 
160
.IP \fIvalue_return\fP 1i
 
161
Specifies a pointer into which a pointer to the parameters are to be
 
162
stored. A NULL will be stored if no parameters accompany the request.
 
163
.IP \fIlength_return\fP 1i
 
164
Specifies a pointer into which the number of data elements in 
 
165
\fIvalue_return\fP of size indicated by \fIformat_return\fP will be
 
166
stored.
 
167
.IP \fIformat_return\fP 1i
 
168
Specifies a pointer into which the size in bits of the parameter data
 
169
in the elements of \fIvalue_return\fP will be stored.
 
170
.SH DESCRIPTION
 
171
.ZN XtGetSelectionParameters
 
172
may only be called from within an
 
173
.ZN XtConvertSelectionProc
 
174
or from within the last call to an
 
175
.ZN XtConvertSelectionIncrProc
 
176
with a new request_id.
 
177
.SH "SEE ALSO"
 
178
XtSetSelectionParameters(3Xt)
 
179
.br
 
180
\fI\*(xT\fP
 
181
.br
 
182
\fI\*(xL\fP