aboutsummaryrefslogtreecommitdiff
path: root/src/request.h
blob: e556125ea1a0624410a3b651dabe784b97c7130f (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
#ifndef MAGI_INCLUDED_REQUEST
#define MAGI_INCLUDED_REQUEST

#include "cookie.h"
#include "field.h"
#include "param.h"


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Request
 *
 * Can be generated via CGI handler (magi_cgi_request) or
 * as session in Fast CGI (magi_fcgi_request).
 *
 *     Example:     http://example.com/cgi-bin/script/foo/bar?var2=url%20enc
 * method:          get
 * uri:             /cgi-bin/script/foo/bar?var2=url%20enc
 * document_root:   { absolute path to root directory of domain }
 * document_uri:    /cgi-bin/script/foo/bar
 * script_name:     /cgi-bin/script
 * script_filename: { absolute path to script on server machine }
 * remote_addr:     { client IP }
 * remote_port:     { client port }
 * server_addr:     { server IP }
 * server_name:     example.com
 *  (^ Better to use http_params["HTTP_HOST"] -- server_name can be IP too.)
 * server_port:     80
 * server_protocol: http/1.1
 * server_software: { name of web server software }
 * path_info:       /foo/bar
 */
struct magi_request {
    struct magi_field_list *  fields;
    struct magi_cookie_list * cookies;
    char *                    method;
    char *                    uri;
    char *                    document_root;
    char *                    document_uri;
    char *                    script_name;
    char *                    script_filename;
    char *                    remote_addr;
    char *                    remote_port;
    char *                    server_addr;
    char *                    server_name;
    char *                    server_port;
    char *                    server_protocol;
    char *                    server_software;
    char *                    path_info;
    struct magi_param_list *  http_params;
    struct magi_error *       error;
};


/*
 * Destroys request; request is not valid after destruction.
 */
void magi_request_destroy(struct magi_request * request);


#endif