2 ''' $RCSfile$$Revision$$Date$
20 .ie \\n(.$>=3 .ne \\$3
36 ''' Set up \*(-- to give an unbreakable dash;
37 ''' string Tr holds user defined translation string.
38 ''' Bell System Logo is used as a dummy character.
44 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
48 ''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49 ''' \*(L" and \*(R", except that they are used on ".xx" lines,
50 ''' such as .IP and .SH, which do another additional levels of
51 ''' double-quote interpretation
80 .\" If the F register is turned on, we'll generate
81 .\" index entries out stderr for the following things:
86 .\" X<> Xref (embedded
87 .\" Of course, you have to process the output yourself
88 .\" in some meaninful fashion.
91 .tm Index:\\$1\t\\n%\t"\\$2"
96 .TH ERR_get_error 3 "0.9.7d" "2/Sep/2004" "OpenSSL"
100 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101 .de CQ \" put $1 in typewriter font
107 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111 . \" AM - accent mark definitions
113 . \" fudge factors for nroff and troff
122 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
128 . \" simple accents for nroff and troff
141 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146 . ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147 . ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149 . ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
151 . \" troff and (daisy-wheel) nroff accents
152 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
154 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
158 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163 .ds ae a\h'-(\w'a'u*4/10)'e
164 .ds Ae A\h'-(\w'A'u*4/10)'E
165 .ds oe o\h'-(\w'o'u*4/10)'e
166 .ds Oe O\h'-(\w'O'u*4/10)'E
167 . \" corrections for vroff
168 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
170 . \" for low resolution devices (crt and lpr)
171 .if \n(.H>23 .if \n(.V>19 \
175 . ds v \h'-1'\o'\(aa\(ga'
191 ERR_get_error, ERR_peek_error, ERR_peek_last_error,
192 ERR_get_error_line, ERR_peek_error_line, ERR_peek_last_error_line,
193 ERR_get_error_line_data, ERR_peek_error_line_data,
194 ERR_peek_last_error_line_data \- obtain error code and data
198 \& #include <openssl/err.h>
201 \& unsigned long ERR_get_error(void);
202 \& unsigned long ERR_peek_error(void);
203 \& unsigned long ERR_peek_last_error(void);
206 \& unsigned long ERR_get_error_line(const char **file, int *line);
207 \& unsigned long ERR_peek_error_line(const char **file, int *line);
208 \& unsigned long ERR_peek_last_error_line(const char **file, int *line);
211 \& unsigned long ERR_get_error_line_data(const char **file, int *line,
212 \& const char **data, int *flags);
213 \& unsigned long ERR_peek_error_line_data(const char **file, int *line,
214 \& const char **data, int *flags);
215 \& unsigned long ERR_peek_last_error_line_data(const char **file, int *line,
216 \& const char **data, int *flags);
219 \fIERR_get_error()\fR returns the earliest error code from the thread's error
220 queue and removes the entry. This function can be called repeatedly
221 until there are no more error codes to return.
223 \fIERR_peek_error()\fR returns the earliest error code from the thread's
224 error queue without modifying it.
226 \fIERR_peek_last_error()\fR returns the latest error code from the thread's
227 error queue without modifying it.
229 See ERR_GET_LIB(3) for obtaining information about
230 location and reason of the error, and
231 ERR_error_string(3) for human-readable error
234 \fIERR_get_error_line()\fR, \fIERR_peek_error_line()\fR and
235 \fIERR_peek_last_error_line()\fR are the same as the above, but they
236 additionally store the file name and line number where
237 the error occurred in *\fBfile\fR and *\fBline\fR, unless these are \fBNULL\fR.
239 \fIERR_get_error_line_data()\fR, \fIERR_peek_error_line_data()\fR and
240 \fIERR_get_last_error_line_data()\fR store additional data and flags
241 associated with the error code in *\fBdata\fR
242 and *\fBflags\fR, unless these are \fBNULL\fR. *\fBdata\fR contains a string
243 if *\fBflags\fR&\fBERR_TXT_STRING\fR. If it has been allocated by \fIOPENSSL_malloc()\fR,
244 *\fBflags\fR&\fBERR_TXT_MALLOCED\fR is true.
246 The error code, or 0 if there is no error in the queue.
248 err(3), ERR_error_string(3),
251 \fIERR_get_error()\fR, \fIERR_peek_error()\fR, \fIERR_get_error_line()\fR and
252 \fIERR_peek_error_line()\fR are available in all versions of SSLeay and
253 OpenSSL. \fIERR_get_error_line_data()\fR and \fIERR_peek_error_line_data()\fR
254 were added in SSLeay 0.9.0.
255 \fIERR_peek_last_error()\fR, \fIERR_peek_last_error_line()\fR and
256 \fIERR_peek_last_error_line_data()\fR were added in OpenSSL 0.9.7.
259 .IX Title "ERR_get_error 3"
260 .IX Name "ERR_get_error, ERR_peek_error, ERR_peek_last_error,
261 ERR_get_error_line, ERR_peek_error_line, ERR_peek_last_error_line,
262 ERR_get_error_line_data, ERR_peek_error_line_data,
263 ERR_peek_last_error_line_data - obtain error code and data"
267 .IX Header "SYNOPSIS"
269 .IX Header "DESCRIPTION"
271 .IX Header "RETURN VALUES"
273 .IX Header "SEE ALSO"