summaryrefslogtreecommitdiffstats
path: root/doc/doxyout/hx509/man/man3/hx509_error.3
blob: 838aaeb74c0ea9703f81acbd412caa56ac3270fb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
.TH "hx509 error functions" 3 "30 Sep 2011" "Version 1.5.1" "Heimdalx509library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
hx509 error functions \- 
.SS "Functions"

.in +1c
.ti -1c
.RI "void \fBhx509_clear_error_string\fP (hx509_context context)"
.br
.ti -1c
.RI "void \fBhx509_set_error_stringv\fP (hx509_context context, int flags, int code, const char *fmt, va_list ap)"
.br
.ti -1c
.RI "void \fBhx509_set_error_string\fP (hx509_context context, int flags, int code, const char *fmt,...)"
.br
.ti -1c
.RI "char * \fBhx509_get_error_string\fP (hx509_context context, int error_code)"
.br
.ti -1c
.RI "void \fBhx509_free_error_string\fP (char *str)"
.br
.ti -1c
.RI "void \fBhx509_err\fP (hx509_context context, int exit_code, int error_code, const char *fmt,...)"
.br
.in -1c
.SH "Detailed Description"
.PP 
See the \fBHx509 error reporting functions\fP for description and examples. 
.SH "Function Documentation"
.PP 
.SS "void hx509_clear_error_string (hx509_context context)"
.PP
Resets the error strings the hx509 context.
.PP
\fBParameters:\fP
.RS 4
\fIcontext\fP A hx509 context. 
.RE
.PP

.SS "void hx509_err (hx509_context context, int exit_code, int error_code, const char * fmt,  ...)"
.PP
Print error message and fatally exit from error code
.PP
\fBParameters:\fP
.RS 4
\fIcontext\fP A hx509 context. 
.br
\fIexit_code\fP exit() code from process. 
.br
\fIerror_code\fP Error code for the reason to exit. 
.br
\fIfmt\fP format string with the exit message. 
.br
\fI...\fP argument to format string. 
.RE
.PP

.SS "void hx509_free_error_string (char * str)"
.PP
Free error string returned by \fBhx509_get_error_string()\fP.
.PP
\fBParameters:\fP
.RS 4
\fIstr\fP error string to free. 
.RE
.PP

.SS "char* hx509_get_error_string (hx509_context context, int error_code)"
.PP
Get an error string from context associated with error_code.
.PP
\fBParameters:\fP
.RS 4
\fIcontext\fP A hx509 context. 
.br
\fIerror_code\fP Get error message for this error code.
.RE
.PP
\fBReturns:\fP
.RS 4
error string, free with \fBhx509_free_error_string()\fP. 
.RE
.PP

.SS "void hx509_set_error_string (hx509_context context, int flags, int code, const char * fmt,  ...)"
.PP
See \fBhx509_set_error_stringv()\fP.
.PP
\fBParameters:\fP
.RS 4
\fIcontext\fP A hx509 context. 
.br
\fIflags\fP 
.IP "\(bu" 2
HX509_ERROR_APPEND appends the error string to the old messages (code is updated). 
.PP
.br
\fIcode\fP error code related to error message 
.br
\fIfmt\fP error message format 
.br
\fI...\fP arguments to error message format 
.RE
.PP

.SS "void hx509_set_error_stringv (hx509_context context, int flags, int code, const char * fmt, va_list ap)"
.PP
Add an error message to the hx509 context.
.PP
\fBParameters:\fP
.RS 4
\fIcontext\fP A hx509 context. 
.br
\fIflags\fP 
.IP "\(bu" 2
HX509_ERROR_APPEND appends the error string to the old messages (code is updated). 
.PP
.br
\fIcode\fP error code related to error message 
.br
\fIfmt\fP error message format 
.br
\fIap\fP arguments to error message format 
.RE
.PP

OpenPOWER on IntegriCloud