apr::bucketalloc(3) [osx man page]

apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::APR:UserkContributed Peapache_mod_perl-108~358::mod_perl-2.0.7::docs::api::APR::BucketAlloc(3)

NAME

       APR::BucketAlloc - Perl API for Bucket Allocation

Synopsis
	 use APR::BucketAlloc ();
	 $ba = APR::BucketAlloc->new($pool);
	 $ba->destroy;

Description
       "APR::BucketAlloc" is used for bucket allocation.

   "new"
       Create an "APR::BucketAlloc" object:

	 $ba = APR::BucketAlloc->new($pool);

       class: "APR::BucketAlloc"
       arg1: $pool ( "APR::Pool object" )
	   The pool used to create this object.

       ret: $ba ( "APR::BucketAlloc object" )
	   The new object.

       since: 2.0.00

       This bucket allocation list (freelist) is used to create new buckets (via "APR::Bucket->new") and bucket brigades (via
       "APR::Brigade->new").

       You only need to use this method if you aren't running under httpd.  If you are running under mod_perl, you already have a bucket
       allocation available via "$c->bucket_alloc" and "$bb->bucket_alloc".

       Example:

	 use APR::BucketAlloc ();
	 use APR::Pool ();
	 my $ba = APR::BucketAlloc->(APR::Pool->pool);
	 my $eos_b = APR::Bucket::eos_create($ba);

   "destroy"
       Destroy an "APR::BucketAlloc object":

	 $ba->destroy;

       arg1: $ba ( "APR::BucketAlloc object" )
	   The freelist to destroy.

       ret: no return value
       since: 2.0.00

       Once destroyed this object may not be used again.

       You need to destroy $ba only if you have created it via "APR::BucketAlloc->new". If you try to destroy an allocation not created by this
       method, you will get a segmentation fault.

       Moreover normally it is not necessary to destroy allocators, since the pool which created them will destroy them during that pool's cleanup
       phase.

See Also
       mod_perl 2.0 documentation.

Copyright
       mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors
       The mod_perl development team and numerous contributors.

perl v5.16.2							    2011-02apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::APR::BucketAlloc(3)

Parser(3pm)						User Contributed Perl Documentation					       Parser(3pm)

NAME

       APR::Request::Parser - wrapper for libapreq2's parser API.

SYNOPSIS

	 use APR::Request::Parser;

DESCRIPTION

       This manpage documents version 2.13 of the APR::Request::Parser package.

METHODS

       APR::Request::Parser

   generic
	   APR::Request::Parser->generic($pool, $ba, $ct)
	   APR::Request::Parser->generic($pool, $ba, $ct, $blim)
	   APR::Request::Parser->generic($pool, $ba, $ct, $blim, $tdir)
	   APR::Request::Parser->generic($pool, $ba, $ct, $blim, $tdir, $hook)

       Noop-parser that collects everything into a single, internal parameter.	Here $pool is an APR::Pool object, $ba is an APR::BucketAlloc
       object, and $ct is the Content-Type header of the request.  Optionally $blim is the brigade in-memory limit, $tdir is the path to the
       temporary directory, and $hook is an APR::Request::Hook object.

   headers
	   APR::Request::Parser->headers($pool, $ba, $ct)
	   APR::Request::Parser->headers($pool, $ba, $ct, $blim)
	   APR::Request::Parser->headers($pool, $ba, $ct, $blim, $tdir)
	   APR::Request::Parser->headers($pool, $ba, $ct, $blim, $tdir, $hook)

       RFC 822 header parser.  Here $pool is an APR::Pool object, $ba is an APR::BucketAlloc object, and $ct is the Content-Type header of the
       request.  Optionally $blim is the brigade in-memory limit, $tdir is the path to the temporary directory, and $hook is an APR::Request::Hook
       object.

   urlencoded
	   APR::Request::Parser->urlencoded($pool, $ba, $ct)
	   APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim)
	   APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim, $tdir)
	   APR::Request::Parser->urlencoded($pool, $ba, $ct, $blim, $tdir, $hook)

       x-www-form-urlencoded parser.  Here $pool is an APR::Pool object, $ba is an APR::BucketAlloc object, and $ct is the Content-Type header of
       the request.  Optionally $blim is the brigade in-memory limit, $tdir is the path to the temporary directory, and $hook is an
       APR::Request::Hook object.

   multipart
	   APR::Request::Parser->multipart($pool, $ba, $ct)
	   APR::Request::Parser->multipart($pool, $ba, $ct, $blim)
	   APR::Request::Parser->multipart($pool, $ba, $ct, $blim, $tdir)
	   APR::Request::Parser->multipart($pool, $ba, $ct, $blim, $tdir, $hook)

       Multipart parser.  Here $pool is an APR::Pool object, $ba is an APR::BucketAlloc object, and $ct is the Content-Type header of the request.
       Optionally $blim is the brigade in-memory limit, $tdir is the path to the temporary directory, and $hook is an APR::Request::Hook object.

   default
	   APR::Request::Parser->default($pool, $ba, $ct)
	   APR::Request::Parser->default($pool, $ba, $ct, $blim)
	   APR::Request::Parser->default($pool, $ba, $ct, $blim, $tdir)
	   APR::Request::Parser->default($pool, $ba, $ct, $blim, $tdir, $hook)

       Default parser.	Here $pool is an APR::Pool object, $ba is an APR::BucketAlloc object, and $ct is the Content-Type header of the request.
       Optionally $blim is the brigade in-memory limit, $tdir is the path to the temporary directory, and $hook is an APR::Request::Hook object.

SEE ALSO

       APR::Request, APR::Request::Hook

COPYRIGHT

	 Licensed to the Apache Software Foundation (ASF) under one or more
	 contributor license agreements.  See the NOTICE file distributed with
	 this work for additional information regarding copyright ownership.
	 The ASF licenses this file to You under the Apache License, Version 2.0
	 (the "License"); you may not use this file except in compliance with
	 the License.  You may obtain a copy of the License at

	     http://www.apache.org/licenses/LICENSE-2.0

	 Unless required by applicable law or agreed to in writing, software
	 distributed under the License is distributed on an "AS IS" BASIS,
	 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	 See the License for the specific language governing permissions and
	 limitations under the License.

perl v5.10.1							    2011-02-28							       Parser(3pm)