TuyaOS
httpd.h
浏览该文件的文档.
1
6/*
7 * Copyright (c) 2001-2003 Swedish Institute of Computer Science.
8 * All rights reserved.
9 *
10 * Redistribution and use in source and binary forms, with or without modification,
11 * are permitted provided that the following conditions are met:
12 *
13 * 1. Redistributions of source code must retain the above copyright notice,
14 * this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright notice,
16 * this list of conditions and the following disclaimer in the documentation
17 * and/or other materials provided with the distribution.
18 * 3. The name of the author may not be used to endorse or promote products
19 * derived from this software without specific prior written permission.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
22 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
23 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
24 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
26 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
29 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
30 * OF SUCH DAMAGE.
31 *
32 * This file is part of the lwIP TCP/IP stack.
33 *
34 * Author: Adam Dunkels <adam@sics.se>
35 *
36 * This version of the file has been modified by Texas Instruments to offer
37 * simple server-side-include (SSI) and Common Gateway Interface (CGI)
38 * capability.
39 */
40
41#ifndef LWIP_HDR_APPS_HTTPD_H
42#define LWIP_HDR_APPS_HTTPD_H
43
44#include "httpd_opts.h"
45#include "lwip/err.h"
46#include "lwip/pbuf.h"
47
48#ifdef __cplusplus
49extern "C" {
50#endif
51
52#if LWIP_HTTPD_CGI
53
84typedef const char *(*tCGIHandler)(int iIndex, int iNumParams, char *pcParam[],
85 char *pcValue[]);
86
92typedef struct
93{
94 const char *pcCGIName;
95 tCGIHandler pfnCGIHandler;
96} tCGI;
97
98void http_set_cgi_handlers(const tCGI *pCGIs, int iNumHandlers);
99
100#endif /* LWIP_HTTPD_CGI */
101
102#if LWIP_HTTPD_CGI || LWIP_HTTPD_CGI_SSI
103
104#if LWIP_HTTPD_CGI_SSI
105/* we have to prototype this struct here to make it available for the handler */
106struct fs_file;
107
114extern void httpd_cgi_handler(struct fs_file *file, const char* uri, int iNumParams,
115 char **pcParam, char **pcValue
117 , void *connection_state
118#endif /* LWIP_HTTPD_FILE_STATE */
119 );
120#endif /* LWIP_HTTPD_CGI_SSI */
121
122#endif /* LWIP_HTTPD_CGI || LWIP_HTTPD_CGI_SSI */
123
124#if LWIP_HTTPD_SSI
125
156typedef u16_t (*tSSIHandler)(
157#if LWIP_HTTPD_SSI_RAW
158 const char* ssi_tag_name,
159#else /* LWIP_HTTPD_SSI_RAW */
160 int iIndex,
161#endif /* LWIP_HTTPD_SSI_RAW */
162 char *pcInsert, int iInsertLen
163#if LWIP_HTTPD_SSI_MULTIPART
164 , u16_t current_tag_part, u16_t *next_tag_part
165#endif /* LWIP_HTTPD_SSI_MULTIPART */
166#if defined(LWIP_HTTPD_FILE_STATE) && LWIP_HTTPD_FILE_STATE
167 , void *connection_state
168#endif /* LWIP_HTTPD_FILE_STATE */
169 );
170
174void http_set_ssi_handler(tSSIHandler pfnSSIHandler,
175 const char **ppcTags, int iNumTags);
176
181#define HTTPD_SSI_TAG_UNKNOWN 0xFFFF
182
183#endif /* LWIP_HTTPD_SSI */
184
185#if LWIP_HTTPD_SUPPORT_POST
186
187/* These functions must be implemented by the application */
188
209err_t httpd_post_begin(void *connection, const char *uri, const char *http_request,
210 u16_t http_request_len, int content_len, char *response_uri,
211 u16_t response_uri_len, u8_t *post_auto_wnd);
212
223err_t httpd_post_receive_data(void *connection, struct pbuf *p);
224
236void httpd_post_finished(void *connection, char *response_uri, u16_t response_uri_len);
237
238#if LWIP_HTTPD_POST_MANUAL_WND
239void httpd_post_data_recved(void *connection, u16_t recved_len);
240#endif /* LWIP_HTTPD_POST_MANUAL_WND */
241
242#endif /* LWIP_HTTPD_SUPPORT_POST */
243
244void httpd_init(void);
245
246#if HTTPD_ENABLE_HTTPS
247struct altcp_tls_config;
248void httpd_inits(struct altcp_tls_config *conf);
249#endif
250
251#ifdef __cplusplus
252}
253#endif
254
255#endif /* LWIP_HDR_APPS_HTTPD_H */
#define LWIP_HTTPD_FILE_STATE
Definition: httpd_opts.h:365
s8_t err_t
Definition: err.h:96
Definition: fs.h:65
Definition: pbuf.h:186