summaryrefslogtreecommitdiffstats
path: root/nanohttp/nanohttp-server.h
blob: be48005a8e3739425df2437904d664d9497aa110 (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
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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
/******************************************************************
 *  $Id: nanohttp-server.h,v 1.24 2006/11/23 15:27:33 m0gg Exp $
 *
 * CSOAP Project:  A http client/server library in C
 * Copyright (C) 2003  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_server_h
#define __nanohttp_server_h

/**
 *
 * nanohttp command line flags
 *
 */
#define NHTTPD_ARG_PORT		"-NHTTPport"
#define NHTTPD_ARG_TERMSIG	"-NHTTPtsig"
#define NHTTPD_ARG_MAXCONN	"-NHTTPmaxconn"
#define NHTTPD_ARG_TIMEOUT	"-NHTTPtimeout"

typedef struct httpd_conn
{
  struct hsocket_t *sock;
  char content_type[25];
  struct http_output_stream_t *out;
  hpair_t *header;
}
httpd_conn_t;

/**
 *
 * Service callback function for a nanoHTTP service.
 *
 */
typedef void (*httpd_service) (httpd_conn_t *conn, struct hrequest_t *req);

/**
 *
 * Authentication callback function for a nanoHTTP service.
 *
 */
typedef int (*httpd_auth) (struct hrequest_t *req, const char *user, const char *pass);

#ifdef __NHTTP_INTERNAL
/**
 *
 * Service statistics per nanoHTTP service.
 *
 */
struct service_statistics
{
  unsigned long requests;
  unsigned long bytes_transmitted;
  unsigned long bytes_received;
  struct timeval time;
  pthread_rwlock_t lock;
};
#endif

/**
 *
 * Service representation object
 *
 */
typedef struct tag_hservice
{
  char ctx[255];
  httpd_service func;
  httpd_auth auth;
  struct tag_hservice *next;
  struct service_statistics *statistics;
}
hservice_t;

#ifdef __cplusplus
extern "C"
{
#endif


/*
  Begin  httpd_* function set
 */
  extern herror_t httpd_init(int argc, char *argv[]);
  extern void httpd_destroy(void);

  extern herror_t httpd_run(void);

  extern herror_t httpd_register(const char *ctx, httpd_service service);
  extern herror_t httpd_register_secure(const char *ctx, httpd_service service, httpd_auth auth);

  extern herror_t httpd_register_default(const char *ctx, httpd_service service);
  extern herror_t httpd_register_default_secure(const char *ctx, httpd_service service, httpd_auth auth);

  extern short httpd_get_port(void);
  extern int httpd_get_timeout(void);
  extern void httpd_set_timeout(int t);

  extern const char *httpd_get_protocol(void);
  extern int httpd_get_conncount(void);

  extern hservice_t *httpd_get_services(void);
  extern hservice_t *httpd_find_service(const char *name);

  extern herror_t httpd_send_header(httpd_conn_t * res, int code, const char *text);

  extern int httpd_set_header(httpd_conn_t * conn, const char *key, const char *value);
  extern void httpd_set_headers(httpd_conn_t * conn, hpair_t * header);

  extern int httpd_add_header(httpd_conn_t * conn, const char *key, const char *value);
  extern void httpd_add_headers(httpd_conn_t * conn, const hpair_t * values);

/* --------------------------------------------------------------
 MIME RELATED FUNCTIONS
 ---------------------------------------------------------------*/
/*
  MIME support httpd_mime_* function set
*/

/**
  Begin MIME multipart/related POST 
  Returns: HSOCKET_OK  or error flag
*/
  extern herror_t httpd_mime_send_header(httpd_conn_t * conn,
                                  const char *related_start,
                                  const char *related_start_info,
                                  const char *related_type, int code,
                                  const char *text);

/**
  Send boundary and part header and continue 
  with next part
*/
  extern herror_t httpd_mime_next(httpd_conn_t * conn,
                           const char *content_id,
                           const char *content_type,
                           const char *transfer_encoding);

/**
  Send boundary and part header and continue 
  with next part
*/
  extern herror_t httpd_mime_send_file(httpd_conn_t * conn,
                                const char *content_id,
                                const char *content_type,
                                const char *transfer_encoding,
                                const char *filename);

/**
  Finish MIME request 
  Returns: HSOCKET_OK  or error flag
*/
  extern herror_t httpd_mime_end(httpd_conn_t * conn);


#ifdef __cplusplus
}
#endif

#endif