← 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/XtAppEM.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/XtAppEM.man
 
1
.\" $Xorg: XtAppEM.man,v 1.3 2000/08/17 19:41:58 cpqbld Exp $
 
2
.\"
 
3
.\" Copyright 1993 X Consortium
 
4
.\"
 
5
.\" Permission is hereby granted, free of charge, to any person obtaining
 
6
.\" a copy of this software and associated documentation files (the
 
7
.\" "Software"), to deal in the Software without restriction, including
 
8
.\" without limitation the rights to use, copy, modify, merge, publish,
 
9
.\" distribute, sublicense, and/or sell copies of the Software, and to
 
10
.\" permit persons to whom the Software is furnished to do so, subject to
 
11
.\" the following conditions:
 
12
.\"
 
13
.\" The above copyright notice and this permission notice shall be
 
14
.\" included in all copies or substantial portions of the Software.
 
15
.\"
 
16
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 
17
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
18
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
19
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
 
20
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 
21
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 
22
.\" OTHER DEALINGS IN THE SOFTWARE.
 
23
.\"
 
24
.\" Except as contained in this notice, the name of the X Consortium shall
 
25
.\" not be used in advertising or otherwise to promote the sale, use or
 
26
.\" other dealings in this Software without prior written authorization
 
27
.\" from the X Consortium.
 
28
.\"
 
29
.\" $XFree86: xc/doc/man/Xt/XtAppEM.man,v 1.3 2001/02/09 03:47:49 tsi Exp $
 
30
.\"
 
31
.ds tk X Toolkit
 
32
.ds xT X Toolkit Intrinsics \- C Language Interface
 
33
.ds xI Intrinsics
 
34
.ds xW X Toolkit Athena Widgets \- C Language Interface
 
35
.ds xL Xlib \- C Language X Interface
 
36
.ds xC Inter-Client Communication Conventions Manual
 
37
.ds Rn 3
 
38
.ds Vn 2.2
 
39
.hw XtApp-Error-Msg XtApp-Set-Error-Msg-Handler XtApp-Set-Warning-Msg-Handler XtApp-Warning-Msg wid-get
 
40
.na
 
41
.de Ds
 
42
.nf
 
43
.\\$1D \\$2 \\$1
 
44
.ft 1
 
45
.ps \\n(PS
 
46
.\".if \\n(VS>=40 .vs \\n(VSu
 
47
.\".if \\n(VS<=39 .vs \\n(VSp
 
48
..
 
49
.de De
 
50
.ce 0
 
51
.if \\n(BD .DF
 
52
.nr BD 0
 
53
.in \\n(OIu
 
54
.if \\n(TM .ls 2
 
55
.sp \\n(DDu
 
56
.fi
 
57
..
 
58
.de FD
 
59
.LP
 
60
.KS
 
61
.TA .5i 3i
 
62
.ta .5i 3i
 
63
.nf
 
64
..
 
65
.de FN
 
66
.fi
 
67
.KE
 
68
.LP
 
69
..
 
70
.de IN          \" send an index entry to the stderr
 
71
..
 
72
.de C{
 
73
.KS
 
74
.nf
 
75
.D
 
76
.\"
 
77
.\"     choose appropriate monospace font
 
78
.\"     the imagen conditional, 480,
 
79
.\"     may be changed to L if LB is too
 
80
.\"     heavy for your eyes...
 
81
.\"
 
82
.ie "\\*(.T"480" .ft L
 
83
.el .ie "\\*(.T"300" .ft L
 
84
.el .ie "\\*(.T"202" .ft PO
 
85
.el .ie "\\*(.T"aps" .ft CW
 
86
.el .ft R
 
87
.ps \\n(PS
 
88
.ie \\n(VS>40 .vs \\n(VSu
 
89
.el .vs \\n(VSp
 
90
..
 
91
.de C}
 
92
.DE
 
93
.R
 
94
..
 
95
.de Pn
 
96
.ie t \\$1\fB\^\\$2\^\fR\\$3
 
97
.el \\$1\fI\^\\$2\^\fP\\$3
 
98
..
 
99
.de ZN
 
100
.ie t \fB\^\\$1\^\fR\\$2
 
101
.el \fI\^\\$1\^\fP\\$2
 
102
..
 
103
.de NT
 
104
.ne 7
 
105
.ds NO Note
 
106
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
 
107
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
 
108
.ie n .sp
 
109
.el .sp 10p
 
110
.TB
 
111
.ce
 
112
\\*(NO
 
113
.ie n .sp
 
114
.el .sp 5p
 
115
.if '\\$1'C' .ce 99
 
116
.if '\\$2'C' .ce 99
 
117
.in +5n
 
118
.ll -5n
 
119
.R
 
120
..
 
121
.               \" Note End -- doug kraft 3/85
 
122
.de NE
 
123
.ce 0
 
124
.in -5n
 
125
.ll +5n
 
126
.ie n .sp
 
127
.el .sp 10p
 
128
..
 
129
.ny0
 
130
.TH XtAppErrorMsg 3Xt __xorgversion__ "XT FUNCTIONS"
 
131
.SH NAME
 
132
XtAppErrorMsg, XtAppSetErrorMsgHandler, XtAppSetWarningMsgHandler, XtAppWarningMsg \- high-level error handlers
 
133
.SH SYNTAX
 
134
void XtAppErrorMsg(\fIapp_context\fP, \fIname\fP, \fItype\fP, \fIclass\fP,
 
135
\fIdefault\fP, \ \fIparams\fP, \fInum_params\fP)
 
136
.br
 
137
    XtAppContext \fIapp_context\fP;
 
138
.br
 
139
    String \fIname\fP;
 
140
.br
 
141
    String \fItype\fP;
 
142
.br
 
143
    String \fIclass\fP;
 
144
.br
 
145
    String \fIdefault\fP;
 
146
.br
 
147
    String *\fIparams\fP;
 
148
.br
 
149
    Cardinal *\fInum_params\fP;
 
150
.LP
 
151
void XtAppSetErrorMsgHandler(\fIapp_context\fP, \fImsg_handler\fP)
 
152
.br
 
153
      XtAppContext \fIapp_context\fP;
 
154
.br
 
155
      XtErrorMsgHandler \fImsg_handler\fP;
 
156
.LP
 
157
void XtAppSetWarningMsgHandler(\fIapp_context\fP, \fImsg_handler\fP)
 
158
.br
 
159
      XtAppContext \fIapp_context\fP;
 
160
.br
 
161
      XtErrorMsgHandler \fImsg_handler\fP;
 
162
.LP
 
163
void XtAppWarningMsg(\fIapp_context\fP, \fIname\fP, \fItype\fP, \fIclass\fP, \fIdefault\fP, \fIparams\fP, \fInum_params\fP)
 
164
.br
 
165
    XtAppContext \fIapp_context\fP;
 
166
.br
 
167
    String \fIname\fP;
 
168
.br
 
169
    String \fItype\fP;
 
170
.br
 
171
    String \fIclass\fP;
 
172
.br
 
173
    String \fIdefault\fP;
 
174
.br
 
175
    String *\fIparams\fP;
 
176
.br
 
177
    Cardinal *\fInum_params\fP;
 
178
.SH ARGUMENTS
 
179
.IP \fIapp_context\fP 1i
 
180
Specifies the application context.
 
181
.ds Cl
 
182
.IP \fIclass\fP 1i
 
183
Specifies the resource class\*(Cl.
 
184
.IP \fIdefault\fP 1i
 
185
Specifies the default message to use\*(Dm.
 
186
.IP \fIname\fP 1i
 
187
Specifies the general kind of error.
 
188
.IP \fItype\fP 1i
 
189
Specifies the detailed name of the error.
 
190
.ds Mh fatal error procedure, which should not return
 
191
or the nonfatal error procedure, which usually returns
 
192
.IP \fImsg_handler\fP 1i
 
193
Specifies the new \*(Mh.
 
194
.IP \fInum_params\fP 1i
 
195
Specifies the number of values in the parameter list.
 
196
.IP \fIparams\fP 1i
 
197
Specifies a pointer to a list of values to be stored in the message.
 
198
.SH DESCRIPTION
 
199
The
 
200
.ZN XtAppErrorMsg
 
201
function calls the high-level error handler and passes the specified
 
202
information.
 
203
.LP
 
204
The
 
205
.ZN XtAppSetErrorMsgHandler
 
206
function registers the specified  procedure,
 
207
which is called when a fatal error occurs.
 
208
.LP
 
209
The
 
210
.ZN XtAppSetWarningMsgHandler
 
211
function registers the specified procedure,
 
212
which is called when a nonfatal error condition occurs.
 
213
.LP
 
214
The
 
215
.ZN XtAppWarningMsg
 
216
function calls the high-level error handler and passes the specified
 
217
information.
 
218
.SH "SEE ALSO"
 
219
XtAppGetErrorDatabase(3Xt),
 
220
XtAppError(3Xt)
 
221
.br
 
222
\fI\*(xT\fP
 
223
.br
 
224
\fI\*(xL\fP