File: README

package info (click to toggle)
libapreq2 2.17-8
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,164 kB
  • sloc: ansic: 8,283; perl: 5,451; sh: 4,627; cpp: 380; makefile: 270; javascript: 186
file content (231 lines) | stat: -rw-r--r-- 4,010 bytes parent folder | download | duplicates (14)
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
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
To parse the libapreq headers into xsbuilder/tables:

        % perl ../../build/xsbuilder.pl run

To build the xs/ directory and configure the tests:

        % perl Makefile.PL -apxs /path/to/apache2/bin/apxs        

To run the test suite:

        % make test




DEVELOPER NOTES

APR::Request::* should be a simple translation of the apreq C API:

apreq_handle_t -> APR::Request-derived instance.
apreq_module_t -> APR::Request-derived class.
apreq_param_t  -> APR::Request::Param
apreq_cookie_t -> APR::Request::Cookie
apreq_parser_t -> APR::Request::Parser (todo)
apreq_hook_t   -> APR::Request::Hook (todo)


--------------------------------------------------
Current APR:: module breakdown
--------------------------------------------------

APR::Request

  subs:
    encode
    decode

  methods:
    parse
    read_limit
    brigade_limit
    temp_dir
    header_in
    header_out
    jar_status
    args_status
    body_status
    param_status
    disable_uploads

  missing:
    add_hook (requires APR::Request::Hook)
    parser (requires APR::Request::Parser)

==================================================

APR::Request::CGI @ISA=(APR::Request)

  method:
    param

  ctor:
    new

==================================================

APR::Request::Apache2 @ISA=(APR::Request)

  method:
    param

  ctor:
    new

==================================================

APR::Request::Error  @ISA=(APR::Error, APR::Request)

  subs:
    strerror

==================================================

APR::Request::Cookie

  provides:
    APR::Request::jar()
    APR::Request::Cookie::Table
      methods:
        get, FETCH
        FIRSTKEY, NEXTKEY
        cookie_class
      missing:
        rest of const apr_table_t * API (do, etc)

  methods:
    name
    value
    secure
    version
    is_tainted
    as_string
    bake
    bake2
    expires
    path
    domain
    port
    comment
    commentURL

    freeze
    thaw

    bind_handle

  ctor:
    new

==================================================

APR::Request::Param

  provides:
    APR::Request::args()
    APR::Request::body()
    APR::Request::param()
    APR::Request::params()

    APR::Request::Param::Table
      methods:
        get, FETCH
        FIRSTKEY, NEXTKEY
        param_class
        uploads
        do
      missing:
        rest of const apr_table_t * API

    APR::Request::Brigade
      methods:
        TIEHANDLE, new
        READ
        READLINE
    APR::Request::Brigade::IO
        read
        readline

  methods:
    name
    value
    info
    upload
    upload_link
    upload_slurp
    upload_size
    upload_type
    upload_tempname
    upload_io
    upload_fh

--------------------------------------------------
Current (pure-perl) Apache2:: module breakdown
--------------------------------------------------

Apache2::Request @ISA=(Apache2::RequestRec, APR::Request::Apache2)

  ctor:
    new

  methods:
    instance           (deprecated, ok to remove this)
    disable_uploads

  missing:
    hook_data
    upload_hook

  2.04-deltas:
    env() removed
    params() method inherited from APR::Request; not deprecated anymore.
    parms() removed
    status() removed.
    args() needs to become Apache2::RequestRec::args!!!
    The args() change probably deserves a runtime warning in 2.05-dev.

==================================================

Apache2::Cookie @ISA=(APR::Request::Cookie)

  provides:
    Apache2::Cookie::Jar @ISA=(APR::Request::Apache2)
      methods:
        cookies
        status

  subs:
    encode
    decode

  methods:
    new
    fetch
    set_attr
    freeze
    thaw
    value

  2.04-deltas:
    env() removed

==================================================

Apache2::Upload @ISA=(APR::Request::Param)

  provides:
    Apache2::Request::upload

  methods:
    slurp
    type
    size
    link
    tempname
    fh
    io
    filename
    bb          (need to deprecate this)

  2.04-deltas:
    Apache::Upload::Brigade is now APR::Request::Brigade.