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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/******************************************************************
* $Id: nanohttp-error.h,v 1.3 2006/12/03 17:30:57 m0gg Exp $
*
* CSOAP Project: A http client/server library in C
* Copyright (C) 2003-2004 Ferhat Ayaz
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*
* Email: ferhatayaz@yahoo.com
******************************************************************/
#ifndef __nanohttp_error_h
#define __nanohttp_error_h
/** @file
*
* nanoHTTP error handling
*
* Almost all function will return a "herror_t" object. If the function returns
* with success this object is H_OK. Another herror_t object will be returned
* otherwise. Following functions can be used with a returned herror_t object:
*
* - herror_code() - Returns the error code
* - herror_func() - Returns the function name, where the error occured
* - herror_message() - Returns the human readable error message
* - herror_release() - Frees the herror_t object.
*
* Example:
*
* herror_t err;
*
* if ((err = soap_client_invoke(...)) != H_OK)
* {
* printf("Message: %s\n", herror_message(err));
* printf("Error code: %d\n", herror_code(err));
* printf("In function: %s\n", herror_func(err));
* herror_release(err);
* }
*
* Note that you "must" call herror_release() to free the resources.
*
*/
/**
*
* Success flag
*
*/
#define H_OK 0
/**
*
* XXX: Move this to nanohttp-url.h
*
* URL errors
*
*/
#define URL_ERROR 1100
#define URL_ERROR_UNKNOWN_PROTOCOL (URL_ERROR + 1)
#define URL_ERROR_NO_PROTOCOL (URL_ERROR + 2)
#define URL_ERROR_NO_HOST (URL_ERROR + 3)
/**
*
* General errors
*
*/
#define GENERAL_ERROR 1400
#define GENERAL_INVALID_PARAM (GENERAL_ERROR + 1)
#define GENERAL_HEADER_PARSE_ERROR (GENERAL_ERROR + 2)
/**
*
* Thread errors
*
*/
#define THREAD_ERROR 1500
#define THREAD_BEGIN_ERROR (THREAD_ERROR)
/**
*
* File errors
*
*/
#define FILE_ERROR 8000
#define FILE_ERROR_OPEN (FILE_ERROR + 1)
#define FILE_ERROR_READ (FILE_ERROR + 2)
/**
*
* XXX: Remove me.
*
* Dummy deklaration to hide the implementation.
*
*/
typedef void *herror_t;
#ifdef __cplusplus
extern "C" {
#endif
/**
*
* Creates a new error structure.
*
* @see printf
*
*/
extern herror_t herror_new(const char *func, int errcode, const char *format, ...);
/**
*
* Returns the code of the error.
*
*/
extern int herror_code(herror_t err);
/**
*
* Returns the name of the function, where the error was produced.
*
*/
extern const char *herror_func(herror_t err);
/**
*
* Returns the error message.
*
*/
extern const char *herror_message(herror_t err);
/**
*
* Frees the error structure.
*
*/
extern void herror_release(herror_t err);
#ifdef __cplusplus
}
#endif
#endif
|
