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

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/Xt/XtGetClExt.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:
 
1
.\" $Xorg: XtGetClExt.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/XtGetClExt.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 XtGet-Class-Extension 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 XtGetClassExtension 3Xt __xorgversion__ "XT FUNCTIONS"
 
130
.SH NAME
 
131
XtGetClassExtension \- locate a class extension record
 
132
.SH SYNTAX
 
133
XtPointer XtGetClassExtension(\fIobject_class\fP, \fIbyte_offset\fP
 
134
\fItype\fP, \fIversion\fP, \fIrecord_size\fP)
 
135
.br
 
136
      WidgetClass \fIobject_class\fP;
 
137
.br
 
138
      Cardinal \fIbyte_offset\fP;
 
139
.br
 
140
      XrmQuark \fItype\fP;
 
141
.br
 
142
      long \fIversion\fP;
 
143
.br
 
144
      Cardinal \fIrecord_size\fP;
 
145
.LP
 
146
.SH ARGUMENTS
 
147
.IP \fIobject_class\fP 1i
 
148
Specifies the widget class containing the extension list to be searched.
 
149
.IP \fIbyte_offset\fP 1i
 
150
Specifies the offset in bytes form the base of the widget class of the
 
151
extension field to be searched.
 
152
.IP \fItype\fP 1i
 
153
Specifies the name of the class extension to be located.
 
154
.IP \fIversion\fP 1i
 
155
Specifies the minimum acceptable version of the class extension
 
156
required for a match.
 
157
.IP \fIrecord_size\fP 1i
 
158
Specifies the minimum acceptable length of the class extension record
 
159
required for match, or 0.
 
160
.SH DESCRIPTION
 
161
The list of extension records at the specified offset in the specified
 
162
\fIwidget_class\fP will be searched for a match on the specified 
 
163
\fItype\fP, a version greater than or equal to the specified \fIversion\fP, 
 
164
and a record size greater than or equal the specified \fIrecord_size\fP 
 
165
if it is nonzero.
 
166
.ZN XtGetClassExtension
 
167
returns a pointer to a matching extension record or NULL if no match
 
168
is found. The returned extension record is owned by the widget class
 
169
and must not be modified or freed by the caller, except possibly to
 
170
be modified by the widget class owner.
 
171
.SH "SEE ALSO"
 
172
.br
 
173
\fI\*(xT\fP
 
174
.br
 
175
\fI\*(xL\fP