Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the fast-http Reference Manual, version 0.2.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Wed Mar 25 18:03:26 2020 GMT+0.
| • Introduction | What fast-http is all about | |
| • Systems | The systems documentation | |
| • Modules | The modules documentation | |
| • Files | The files documentation | |
| • Packages | The packages documentation | |
| • Definitions | The symbols documentation | |
| • Indexes | Concepts, functions, variables and data types |
This is a fast HTTP request/response protocol parser for Common Lisp.
The API is quite similar to http-parse, although there's some differences.
http, http-request and http-response are structure classes, not standard classes.http doesn't have :force-stream option. (always streaming)http doesn't have :store-body option because it can consume much memory.body-callback for make-parser doesn't take a flag body-complete-p.
finish-callback to know if the parsing is finished.body-callback for make-parser takes pointers start and end.multipart-callback for make-parser has been deleted.
make-multipart-parser and body-callback by yourself.:callback of make-multipart-parser takes a stream, not a body octet vector at the 4th argument.fast-http-error as you needed.Base structure class extended by http-request and http-response.
NOTE: Don't use this class directly unless you're intended to use low-level APIs of fast-http.
(make-http)
;=> #S(FAST-HTTP.HTTP:HTTP
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0)
http-method: Returns a HTTP request method in a keyword (such like :GET, :POST or :HEAD).http-major-version: Returns a HTTP protocol major version in an integer (such like 1 or 0).http-minor-version: Returns a HTTP protocol minor version in an integer (such like 1 or 0).http-version: Returns a HTTP protocol version in a float (such like 1.0 or 1.1).http-status: Returns a HTTP response status code in an integer (such like 200 or 302).http-content-length: Returns a value of Content-Length header in an integer. If the header doesn't exist, it returns NIL.http-chunked-p: Returns T if the value of Transfer-Encoding header is chunked. If the header doesn't exist, it returns NIL.http-upgrade-p: Returns T if Upgrade header exists.http-headers: Returns a hash-table which represents HTTP headers. Note all hash keys are lower-cased and all values are string except Set-Cookie header, whose value is a list of strings. (Content-Length -> "content-length").Structure class holds values specific to an HTTP request.
(make-http-request)
;=> #S(FAST-HTTP.HTTP:HTTP-REQUEST
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0
; :RESOURCE NIL)
http-resource: Returns an URI string.Structure class holds values specific to an HTTP response.
(make-http-response)
;=> #S(FAST-HTTP.HTTP:HTTP-RESPONSE
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0
; :STATUS-TEXT NIL)
http-status-text: Returns an response status text (such like Continue, OK or Bad Request).Makes a parser closure and returns it.
(let ((http (make-http-request)))
(make-parser http
:body-callback
(lambda (data start end)
(write-to-buffer data start end))
:finish-callback
(lambda ()
(handle-response http))))
;=> #<CLOSURE (LAMBDA (DATA &KEY (START 0) END)
; :IN
; FAST-HTTP.PARSER:MAKE-PARSER) {10090BDD0B}>
The closure takes one required argument data, that is a simple byte vector and two keyword arguments start and end.
first-line-callback (): This callback function will be called when the first line is parsed.header-callback (headers-hash-table): This callback function will be called when the header lines are parsed. This function is the same object to the http object holds.body-callback (data-byte-vector): This callback function will be called whenever it gets a chunk of HTTP body. Which means this can be called multiple times.finish-callback (): This callback function will be called when the HTTP message ends.NOTE: If the HTTP request/response has multiple messages (like HTTP/1.1 pipelining), all these functions can be called multiple times.
Makes a multipart/form-data parser closure and returns it.
This takes 2 arguments, content-type (such like "multipart/form-data; boundary=--AsB03x") and callback. The callback is a function which takes exact 4 arguments -- a field name, field headers, field meta data and body bytes.
The following functions are intended to be used for internally. These APIs are likely to change in the future.
Most of functions are declared as (optimize (speed 3) (safety 0)) which means it won't check the type of arguments.
Structure class holds callback functions. The callbacks are similar to make-parser's, but don't correspond to them directly.
message-begin (http): This will be called when a new HTTP message begins.url (http data start end): This will be called when an URL part of the HTTP request parsed.first-line (http): This will be called when the first line of the HTTP request/response parsed.status (http data start end): This will be called when the status text (not code) of the HTTP response parsed.header-field (http data start end): This will be called when a header field parsed.header-value (http data start end): This will be called when a header value parsed. This function can be called multiple times when the header value is folded onto multiple lines.headers-complete (http): This will be called when all headers parsed.body (http data start end): This will be called whenever the parser gets a chunk of HTTP body.message-complete (http): This will be called when the HTTP message ends.Parses data as an HTTP request, sets values to http and invokes callbacks in callbacks.
This takes a http object, a callbacks object, and a simple byte vector data and two pointers -- start and end. If end is nil, the length of data will be used.
Parses data as an HTTP response, sets values to http and invokes callbacks in callbacks.
Takes a http object, a callbacks object, and a simple byte vector data and two pointers -- start and end. If end is nil, the length of data will be used.
Will be raised when the data ends in the middle of parsing.
(ql:quickload :fast-http)
(asdf:test-system :fast-http)
In this benchmark, fast-http is 1.25 times faster than http-parser, a C equivalent.
| http-parser (C) | fast-http | | ---------------:| ---------:| | 0.108s | 0.086s |
You can see the latest result at Travis CI.
(ql:quickload :fast-http-test)
(fast-http-test.benchmark:run-ll-benchmark)
Evaluation took:
0.086 seconds of real time
0.085897 seconds of total run time (0.084763 user, 0.001134 system)
100.00% CPU
257,140,751 processor cycles
0 bytes consed
#include "http_parser.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include <time.h>
static http_parser *parser;
static http_parser_settings settings_null =
{.on_message_begin = 0
,.on_header_field = 0
,.on_header_value = 0
,.on_url = 0
,.on_status = 0
,.on_body = 0
,.on_headers_complete = 0
,.on_message_complete = 0
};
int
main (void)
{
const char *buf;
int i;
float start, end;
size_t parsed;
parser = malloc(sizeof(http_parser));
buf = "GET /cookies HTTP/1.1\r\nHost: 127.0.0.1:8090\r\nConnection: keep-alive\r\nCache-Control: max-age=0\r\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\r\nUser-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.17 (KHTML, like Gecko) Chrome/24.0.1312.56 Safari/537.17\r\nAccept-Encoding: gzip,deflate,sdch\r\nAccept-Language: en-US,en;q=0.8\r\nAccept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3\r\nCookie: name=wookie\r\n\r\n";
start = (float)clock()/CLOCKS_PER_SEC;
for (i = 0; i < 100000; i++) {
http_parser_init(parser, HTTP_REQUEST);
parsed = http_parser_execute(parser, &settings_null, buf, strlen(buf));
}
end = (float)clock()/CLOCKS_PER_SEC;
free(parser);
parser = NULL;
printf("Elapsed %f seconds.\n", (end - start));
return 0;
}
$ make http_parser.o
$ gcc -Wall -Wextra -Werror -Wno-error=unused-but-set-variable -O3 http_parser.o mybench.c -o mybench
$ mybench
Elapsed 0.108815 seconds.
Copyright (c) 2014 Eitaro Fukamachi
Licensed under the MIT License.
Next: Modules, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
| • The fast-http system |
Eitaro Fukamachi
MIT
A fast HTTP protocol parser in Common Lisp
# fast-http
[](https://travis-ci.org/fukamachi/fast-http)
This is a fast HTTP request/response protocol parser for Common Lisp.
## Features
* Parses both HTTP requests and responses.
* Handles persistent streams (keep-alive).
* Decodes chunked encoding.
* Exports low-level APIs which don’t any memory allocations during parsing.
## API differences from http-parse
The API is quite similar to [http-parse](https://github.com/orthecreedence/http-parse), although there’s some differences.
* ‘http‘, ‘http-request‘ and ‘http-response‘ are structure classes, not standard classes.
* ‘http‘ doesn’t have ‘:force-stream‘ option. (always streaming)
* ‘http‘ doesn’t have ‘:store-body‘ option because it can consume much memory.
* ‘body-callback‘ for ‘make-parser‘ doesn’t take a flag ‘body-complete-p‘.
* Use ‘finish-callback‘ to know if the parsing is finished.
* ‘body-callback‘ for ‘make-parser‘ takes pointers ‘start‘ and ‘end‘.
* ‘multipart-callback‘ for ‘make-parser‘ has been deleted.
* Use ‘make-multipart-parser‘ and ‘body-callback‘ by yourself.
* ‘:callback‘ of ‘make-multipart-parser‘ takes a stream, not a body octet vector at the 4th argument.
* Raises errors aggressively while parsing.
* Handle ‘fast-http-error‘ as you needed.
* Doesn’t use a property list as a representation of HTTP headers. (See [issue #1](https://github.com/fukamachi/fast-http/issues/1))
## APIs
### \[Structure] http
Base structure class extended by ‘http-request‘ and ‘http-response‘.
**NOTE**: Don’t use this class directly unless you’re intended to use low-level APIs of fast-http.
“‘common-lisp
(make-http)
;=> #S(FAST-HTTP.HTTP:HTTP
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0)
“‘
#### Methods
- ‘http-method‘: Returns a HTTP request method in a keyword (such like ‘:GET‘, ‘:POST‘ or ‘:HEAD‘).
- ‘http-major-version‘: Returns a HTTP protocol major version in an integer (such like ‘1‘ or ‘0‘).
- ‘http-minor-version‘: Returns a HTTP protocol minor version in an integer (such like ‘1‘ or ‘0‘).
- ‘http-version‘: Returns a HTTP protocol version in a float (such like ‘1.0‘ or ‘1.1‘).
- ‘http-status‘: Returns a HTTP response status code in an integer (such like ‘200‘ or ‘302‘).
- ‘http-content-length‘: Returns a value of ‘Content-Length‘ header in an integer. If the header doesn’t exist, it returns ‘NIL‘.
- ‘http-chunked-p‘: Returns ‘T‘ if the value of ‘Transfer-Encoding‘ header is ‘chunked‘. If the header doesn’t exist, it returns ‘NIL‘.
- ‘http-upgrade-p‘: Returns ‘T‘ if ‘Upgrade‘ header exists.
- ‘http-headers‘: Returns a hash-table which represents HTTP headers. Note all hash keys are lower-cased and all values are string except ‘Set-Cookie‘ header, whose value is a list of strings. (‘Content-Length‘ -> ‘"content-length"‘).
### \[Structure] http-request (extends http)
Structure class holds values specific to an HTTP request.
“‘common-lisp
(make-http-request)
;=> #S(FAST-HTTP.HTTP:HTTP-REQUEST
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0
; :RESOURCE NIL)
“‘
#### Methods
- ‘http-resource‘: Returns an URI string.
### \[Structure] http-response (extends http)
Structure class holds values specific to an HTTP response.
“‘common-lisp
(make-http-response)
;=> #S(FAST-HTTP.HTTP:HTTP-RESPONSE
; :METHOD NIL
; :MAJOR-VERSION 0
; :MINOR-VERSION 9
; :STATUS 0
; :CONTENT-LENGTH NIL
; :CHUNKED-P NIL
; :UPGRADE-P NIL
; :HEADERS NIL
; :HEADER-READ 0
; :MARK -1
; :STATE 0
; :STATUS-TEXT NIL)
“‘
#### Methods
- ‘http-status-text‘: Returns an response status text (such like ‘Continue‘, ‘OK‘ or ‘Bad Request‘).
### \[Function] make-parser (http &key first-line-callback header-callback body-callback finish-callback)
Makes a parser closure and returns it.
“‘common-lisp
(let ((http (make-http-request)))
(make-parser http
:body-callback
(lambda (data start end)
(write-to-buffer data start end))
:finish-callback
(lambda ()
(handle-response http))))
;=> #<CLOSURE (LAMBDA (DATA &KEY (START 0) END)
; :IN
; FAST-HTTP.PARSER:MAKE-PARSER) {10090BDD0B}>
“‘
The closure takes one required argument ‘data‘, that is a simple byte vector and two keyword arguments ‘start‘ and ‘end‘.
#### Callbacks
- ‘first-line-callback‘ (): This callback function will be called when the first line is parsed.
- ‘header-callback‘ (headers-hash-table): This callback function will be called when the header lines are parsed. This function is the same object to the ‘http‘ object holds.
- ‘body-callback‘ (data-byte-vector): This callback function will be called whenever it gets a chunk of HTTP body. Which means this can be called multiple times.
- ‘finish-callback‘ (): This callback function will be called when the HTTP message ends.
NOTE: If the HTTP request/response has multiple messages (like HTTP/1.1 pipelining), all these functions can be called multiple times.
### \[Function] make-multipart-parser (content-type callback)
Makes a multipart/form-data parser closure and returns it.
This takes 2 arguments, ‘content-type‘ (such like ‘"multipart/form-data; boundary=–AsB03x"‘) and ‘callback‘. The ‘callback‘ is a function which takes exact 4 arguments – a field name, field headers, field meta data and body bytes.
## Low-level APIs
The following functions are intended to be used for internally. These APIs are likely to change in the future.
Most of functions are declared as ‘(optimize (speed 3) (safety 0))‘ which means it won’t check the type of arguments.
### \[Structure] callbacks
Structure class holds callback functions. The callbacks are similar to ‘make-parser‘’s, but don’t correspond to them directly.
#### Slots
- ‘message-begin‘ (http): This will be called when a new HTTP message begins.
- ‘url‘ (http data start end): This will be called when an URL part of the HTTP request parsed.
- ‘first-line‘ (http): This will be called when the first line of the HTTP request/response parsed.
- ‘status‘ (http data start end): This will be called when the status text (not code) of the HTTP response parsed.
- ‘header-field‘ (http data start end): This will be called when a header field parsed.
- ‘header-value‘ (http data start end): This will be called when a header value parsed. This function can be called multiple times when the header value is folded onto multiple lines.
- ‘headers-complete‘ (http): This will be called when all headers parsed.
- ‘body‘ (http data start end): This will be called whenever the parser gets a chunk of HTTP body.
- ‘message-complete‘ (http): This will be called when the HTTP message ends.
### \[Function] parse-request (http callbacks data &key (start 0) end)
Parses ‘data‘ as an HTTP request, sets values to ‘http‘ and invokes callbacks in ‘callbacks‘.
This takes a ‘http‘ object, a ‘callbacks‘ object, and a simple byte vector ‘data‘ and two pointers – ‘start‘ and ‘end‘. If ‘end‘ is ‘nil‘, the length of ‘data‘ will be used.
### \[Function] parse-response (http callbacks data &key (start 0) end)
Parses ‘data‘ as an HTTP response, sets values to ‘http‘ and invokes callbacks in ‘callbacks‘.
Takes a ‘http‘ object, a ‘callbacks‘ object, and a simple byte vector ‘data‘ and two pointers – ‘start‘ and ‘end‘. If ‘end‘ is ‘nil‘, the length of ‘data‘ will be used.
### \[Condition] eof
Will be raised when the ‘data‘ ends in the middle of parsing.
## Installation
“‘common-lisp
(ql:quickload :fast-http)
“‘
## Running tests
“‘common-lisp
(asdf:test-system :fast-http)
“‘
## Benchmark
- Parsing an HTTP request header 100000 times.
In this benchmark, fast-http is **1.25 times faster** than [http-parser](https://github.com/joyent/http-parser), a C equivalent.
| http-parser (C) | fast-http |
| —————:| ———:|
| 0.108s | 0.086s |
### Environment
* Travis CI
* SBCL 1.2.6
You can see the latest result at [Travis CI](https://travis-ci.org/fukamachi/fast-http).
### fast-http (Common Lisp)
“‘common-lisp
(ql:quickload :fast-http-test)
(fast-http-test.benchmark:run-ll-benchmark)
“‘
“‘
Evaluation took:
0.086 seconds of real time
0.085897 seconds of total run time (0.084763 user, 0.001134 system)
100.00% CPU
257,140,751 processor cycles
0 bytes consed
“‘
### http-parser (C)
“‘c
#include "http_parser.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include <time.h>
static http_parser *parser;
static http_parser_settings settings_null =
{.on_message_begin = 0
,.on_header_field = 0
,.on_header_value = 0
,.on_url = 0
,.on_status = 0
,.on_body = 0
,.on_headers_complete = 0
,.on_message_complete = 0
};
int
main (void)
{
const char *buf;
int i;
float start, end;
size_t parsed;
parser = malloc(sizeof(http_parser));
buf = "GET /cookies HTTP/1.1\r\nHost: 127.0.0.1:8090\r\nConnection: keep-alive\r\nCache-Control: max-age=0\r\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\r\nUser-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.17 (KHTML, like Gecko) Chrome/24.0.1312.56 Safari/537.17\r\nAccept-Encoding: gzip,deflate,sdch\r\nAccept-Language: en-US,en;q=0.8\r\nAccept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3\r\nCookie: name=wookie\r\n\r\n";
start = (float)clock()/CLOCKS_PER_SEC;
for (i = 0; i < 100000; i++) {
http_parser_init(parser, HTTP_REQUEST);
parsed = http_parser_execute(parser, &settings_null, buf, strlen(buf));
}
end = (float)clock()/CLOCKS_PER_SEC;
free(parser);
parser = NULL;
printf("Elapsed %f seconds.\n", (end - start));
return 0;
}
“‘
“‘
$ make http_parser.o
$ gcc -Wall -Wextra -Werror -Wno-error=unused-but-set-variable -O3 http_parser.o mybench.c -o mybench
$ mybench
Elapsed 0.108815 seconds.
“‘
## Author
* Eitaro Fukamachi (e.arrows@gmail.com)
## Copyright
Copyright (c) 2014 Eitaro Fukamachi
## License
Licensed under the MIT License.
0.2.0
fast-http.asd (file)
src (module)
Modules are listed depth-first from the system components tree.
| • The fast-http/src module |
fast-http (system)
src/
Files are sorted by type and then listed depth-first from the systems components trees.
| • Lisp files |
Next: The fast-http/src/fast-http․lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
fast-http.asd
fast-http (system)
Next: The fast-http/src/http․lisp file, Previous: The fast-http․asd file, Up: Lisp files [Contents][Index]
src (module)
src/fast-http.lisp
find-boundary (function)
Next: The fast-http/src/parser․lisp file, Previous: The fast-http/src/fast-http․lisp file, Up: Lisp files [Contents][Index]
src (module)
src/http.lisp
Next: The fast-http/src/multipart-parser․lisp file, Previous: The fast-http/src/http․lisp file, Up: Lisp files [Contents][Index]
src (module)
src/parser.lisp
Next: The fast-http/src/byte-vector․lisp file, Previous: The fast-http/src/parser․lisp file, Up: Lisp files [Contents][Index]
src (module)
src/multipart-parser.lisp
Next: The fast-http/src/error․lisp file, Previous: The fast-http/src/multipart-parser․lisp file, Up: Lisp files [Contents][Index]
src (module)
src/byte-vector.lisp
byte-to-ascii-lower (function)
Next: The fast-http/src/util․lisp file, Previous: The fast-http/src/byte-vector․lisp file, Up: Lisp files [Contents][Index]
src (module)
src/error.lisp
Previous: The fast-http/src/error․lisp file, Up: Lisp files [Contents][Index]
error.lisp (file)
src (module)
src/util.lisp
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
Next: The fast-http package, Previous: Packages, Up: Packages [Contents][Index]
fast-http.asd
Next: The fast-http․http package, Previous: The fast-http-asd package, Up: Packages [Contents][Index]
fast-http.lisp (file)
find-boundary (function)
Next: The fast-http․parser package, Previous: The fast-http package, Up: Packages [Contents][Index]
http.lisp (file)
common-lisp
Next: The fast-http․multipart-parser package, Previous: The fast-http․http package, Up: Packages [Contents][Index]
parser.lisp (file)
Next: The fast-http․byte-vector package, Previous: The fast-http․parser package, Up: Packages [Contents][Index]
multipart-parser.lisp (file)
Next: The fast-http․error package, Previous: The fast-http․multipart-parser package, Up: Packages [Contents][Index]
byte-vector.lisp (file)
common-lisp
byte-to-ascii-lower (function)
Next: The fast-http․util package, Previous: The fast-http․byte-vector package, Up: Packages [Contents][Index]
error.lisp (file)
common-lisp
Previous: The fast-http․error package, Up: Packages [Contents][Index]
util.lisp (file)
common-lisp
Definitions are sorted by export status, category, package, and then by lexicographic order.
| • Exported definitions | ||
| • Internal definitions |
Next: Internal definitions, Previous: Definitions, Up: Definitions [Contents][Index]
| • Exported constants | ||
| • Exported macros | ||
| • Exported functions | ||
| • Exported conditions | ||
| • Exported structures | ||
| • Exported types |
Next: Exported macros, Previous: Exported definitions, Up: Exported definitions [Contents][Index]
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
byte-vector.lisp (file)
Next: Exported functions, Previous: Exported constants, Up: Exported definitions [Contents][Index]
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
util.lisp (file)
Next: Exported conditions, Previous: Exported macros, Up: Exported definitions [Contents][Index]
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
byte-vector.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
multipart-parser.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
multipart-parser.lisp (file)
parser.lisp (file)
util.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
multipart-parser.lisp (file)
fast-http.lisp (file)
fast-http.lisp (file)
byte-vector.lisp (file)
util.lisp (file)
parser.lisp (file)
parser.lisp (file)
Next: Exported structures, Previous: Exported functions, Up: Exported definitions [Contents][Index]
error.lisp (file)
fast-http-error (condition)
:error
(quote nil)
error.lisp (file)
callback-error (condition)
(quote "the body callback failed")
error.lisp (file)
callback-error (condition)
(quote "the first line callback failed")
error.lisp (file)
callback-error (condition)
(quote "the header-field callback failed")
error.lisp (file)
callback-error (condition)
(quote "the header-value callback failed")
error.lisp (file)
callback-error (condition)
(quote "the headers-complete callback failed")
error.lisp (file)
callback-error (condition)
(quote "the message-begin callback failed")
error.lisp (file)
callback-error (condition)
(quote "the message-complete callback failed")
error.lisp (file)
callback-error (condition)
(quote "the status callback failed")
error.lisp (file)
callback-error (condition)
(quote "the url callback failed")
error.lisp (file)
parsing-error (condition)
(quote "data received after completed connection: close message")
parser.lisp (file)
condition (condition)
error.lisp (file)
simple-error (condition)
error.lisp (file)
parsing-error (condition)
(quote "too many header bytes seen; overflow detected")
error.lisp (file)
multipart-parsing-error (condition)
error.lisp (file)
multipart-parsing-error (condition)
(quote "invalid boundary")
error.lisp (file)
parsing-error (condition)
(quote "invalid character in chunk size header")
error.lisp (file)
parsing-error (condition)
(quote "invalid constant string")
error.lisp (file)
parsing-error (condition)
(quote "invalid character in content-length header")
error.lisp (file)
parsing-error (condition)
(quote "stream ended at an unexpected time")
error.lisp (file)
parsing-error (condition)
(quote "invalid fragment")
error.lisp (file)
parsing-error (condition)
(quote "invalid character in header")
error.lisp (file)
header-value-parsing-error (condition)
(quote "invalid header value")
error.lisp (file)
parsing-error (condition)
(quote "invalid host")
error.lisp (file)
parsing-error (condition)
(quote "encountered unexpected internal state")
:code
error.lisp (file)
parsing-error (condition)
(quote "invalid http method")
error.lisp (file)
multipart-parsing-error (condition)
(quote "invalid multipart body")
error.lisp (file)
header-value-parsing-error (condition)
(quote "invalid parameter key")
error.lisp (file)
header-value-parsing-error (condition)
(quote "invalid parameter value")
error.lisp (file)
parsing-error (condition)
(quote "invalid path")
error.lisp (file)
parsing-error (condition)
(quote "invalid port")
error.lisp (file)
parsing-error (condition)
(quote "invalid query string")
error.lisp (file)
parsing-error (condition)
(quote "invalid http status code")
:status-code
(quote nil)
error.lisp (file)
parsing-error (condition)
(quote "invalid url")
error.lisp (file)
parsing-error (condition)
(quote "invalid http version")
error.lisp (file)
parsing-error (condition)
(quote "lf character expected")
error.lisp (file)
fast-http-error (condition)
error.lisp (file)
fast-http-error (condition)
error.lisp (file)
parsing-error (condition)
(quote "parser is paused")
error.lisp (file)
parsing-error (condition)
(quote "strict mode assertion failed")
:form
error.lisp (file)
parsing-error (condition)
(quote "an unknown error occured")
Next: Exported types, Previous: Exported conditions, Up: Exported definitions [Contents][Index]
parser.lisp (file)
structure-object (structure)
(or null function)
callbacks-message-begin (function)
(setf callbacks-message-begin) (function)
(or null function)
callbacks-url (function)
(setf callbacks-url) (function)
(or null function)
callbacks-first-line (function)
(setf callbacks-first-line) (function)
(or null function)
callbacks-status (function)
(setf callbacks-status) (function)
(or null function)
callbacks-header-field (function)
(setf callbacks-header-field) (function)
(or null function)
callbacks-header-value (function)
(setf callbacks-header-value) (function)
(or null function)
callbacks-headers-complete (function)
(setf callbacks-headers-complete) (function)
(or null function)
callbacks-body (function)
(setf callbacks-body) (function)
(or null function)
callbacks-message-complete (function)
(setf callbacks-message-complete) (function)
http.lisp (file)
structure-object (structure)
symbol
http-method (function)
(setf http-method) (function)
fixnum
0
http-major-version (function)
(setf http-major-version) (function)
fixnum
9
http-minor-version (function)
(setf http-minor-version) (function)
fast-http.http:status-code
0
http-status (function)
(setf http-status) (function)
(or null integer)
http-content-length (function)
(setf http-content-length) (function)
boolean
http-chunked-p (function)
(setf http-chunked-p) (function)
boolean
http-upgrade-p (function)
(setf http-upgrade-p) (function)
http-headers (function)
(setf http-headers) (function)
fixnum
0
http-header-read (function)
(setf http-header-read) (function)
fixnum
-1
http-mark (function)
(setf http-mark) (function)
fixnum
fast-http.http:+state-first-line+
http-state (function)
(setf http-state) (function)
http.lisp (file)
http (structure)
http-resource (function)
(setf http-resource) (function)
http.lisp (file)
http (structure)
http-status-text (function)
(setf http-status-text) (function)
multipart-parser.lisp (file)
structure-object (structure)
fixnum
0
ll-multipart-parser-state (function)
(setf ll-multipart-parser-state) (function)
ll-multipart-parser-header-parser (function)
(setf ll-multipart-parser-header-parser) (function)
ll-multipart-parser-boundary (function)
(setf ll-multipart-parser-boundary) (function)
ll-multipart-parser-body-mark (function)
(setf ll-multipart-parser-body-mark) (function)
ll-multipart-parser-body-buffer (function)
(setf ll-multipart-parser-body-buffer) (function)
ll-multipart-parser-boundary-mark (function)
(setf ll-multipart-parser-boundary-mark) (function)
ll-multipart-parser-boundary-buffer (function)
(setf ll-multipart-parser-boundary-buffer) (function)
Previous: Exported structures, Up: Exported definitions [Contents][Index]
parser.lisp (file)
byte-vector.lisp (file)
http.lisp (file)
Previous: Exported definitions, Up: Definitions [Contents][Index]
| • Internal constants | ||
| • Internal special variables | ||
| • Internal macros | ||
| • Internal functions | ||
| • Internal conditions |
Next: Internal special variables, Previous: Internal definitions, Up: Internal definitions [Contents][Index]
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
Maximum number of header lines allowed.
This restriction is for protecting users’ application against denial-of-service attacks where the attacker feeds us a never-ending header that the application keeps buffering.
parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
Next: Internal macros, Previous: Internal constants, Up: Internal definitions [Contents][Index]
util.lisp (file)
util.lisp (file)
util.lisp (file)
Next: Internal functions, Previous: Internal special variables, Up: Internal definitions [Contents][Index]
parser.lisp (file)
parser.lisp (file)
Next: Internal conditions, Previous: Internal macros, Up: Internal definitions [Contents][Index]
util.lisp (file)
byte-vector.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
http.lisp (file)
http.lisp (file)
http.lisp (file)
multipart-parser.lisp (file)
fast-http.lisp (file)
parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
multipart-parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
parser.lisp (file)
util.lisp (file)
parser.lisp (file)
parser.lisp (file)
Previous: Internal functions, Up: Internal definitions [Contents][Index]
parser.lisp (file)
parsing-error (condition)
(quote "expect failed")
Previous: Definitions, Up: Top [Contents][Index]
| • Concept index | ||
| • Function index | ||
| • Variable index | ||
| • Data type index |
Next: Function index, Previous: Indexes, Up: Indexes [Contents][Index]
| Jump to: | F L M |
|---|
| Jump to: | F L M |
|---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
| Jump to: | %
(
A B C D F H L M N P R T U |
|---|
| Jump to: | %
(
A B C D F H L M N P R T U |
|---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
| Jump to: | *
+
B C D E F H M R S U |
|---|
| Jump to: | *
+
B C D E F H M R S U |
|---|
Previous: Variable index, Up: Indexes [Contents][Index]
| Jump to: | C E F H I L M P S T U |
|---|
| Jump to: | C E F H I L M P S T U |
|---|