aboutsummaryrefslogtreecommitdiffstats
path: root/src/plugins/http_static/http_static.api
blob: dd4f513a420b270b5c8b3e5a5cb26c88128729bb (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
/** \file
    This file defines static http server control-plane API messages
*/

option version = "2.2.0";

/** \brief Configure and enable the static http server
    @param client_index - opaque cookie to identify the sender
    @param context - sender context, to match reply w/ request
    @param fifo_size - size (in bytes) of the session FIFOs
    @param cache_size_limit - size (in bytes) of the in-memory file data cache
    @param prealloc_fifos - number of preallocated fifos (usually 0)
    @param private_segment_size - fifo segment size (usually 0)
    @param www_root - html root path
    @param uri - bind URI, defaults to "tcp://0.0.0.0/80"
*/

autoreply define http_static_enable {
    option deprecated;

    /* Client identifier, set from api_main.my_client_index */
    u32 client_index;

    /* Arbitrary context, so client can match reply to request */
    u32 context;
    /* Typical options */
    u32 fifo_size;
    u32 cache_size_limit;
    /* Unusual options */
    u32 prealloc_fifos;
    u32 private_segment_size;

    /* Root of the html path */
    string www_root[256];
    /* The bind URI */
    string uri[256];
};

/** \brief Configure and enable the static http server
    @param client_index - opaque cookie to identify the sender
    @param context - sender context, to match reply w/ request
    @param fifo_size - size (in bytes) of the session FIFOs
    @param cache_size_limit - size (in bytes) of the in-memory file data cache
    @param max_age - how long a response is considered fresh (in seconds)
    @param prealloc_fifos - number of preallocated fifos (usually 0)
    @param private_segment_size - fifo segment size (usually 0)
    @param www_root - html root path
    @param uri - bind URI, defaults to "tcp://0.0.0.0/80"
*/

autoreply define http_static_enable_v2 {
    /* Client identifier, set from api_main.my_client_index */
    u32 client_index;

    /* Arbitrary context, so client can match reply to request */
    u32 context;
    /* Typical options */
    u32 fifo_size;
    u32 cache_size_limit;
    u32 max_age [default=600];
    /* Unusual options */
    u32 prealloc_fifos;
    u32 private_segment_size;

    /* Root of the html path */
    string www_root[256];
    /* The bind URI */
    string uri[256];
};