NAME
    HTTP::Parser::XS - a fast, primitive HTTP request parser

SYNOPSIS
      use HTTP::Parser::XS qw(parse_http_request);
  
      my $ret = parse_http_request(
          "GET / HTTP/1.0\r\nHost: ...\r\n\r\n",
          \%env,
      );
      if ($ret == -2) {
          # request is incomplete
          ...
      } elsif ($ret == -1) {
          # request is broken
          ...
      } else {
          # $ret includes the size of the request, %env now contains a PSGI
          # request, if it is a POST / PUT request, read request content by
          # yourself
          ...
      }

DESCRIPTION
    HTTP::Parser::XS is a fast, primitive HTTP request parser that can be
    used either for writing a synchronous HTTP server or a event-driven
    server.

METHODS
    parse_http_request($request_string, \%env)
        Tries to parse given request string, and if successful, inserts
        variables into %env. For the name of the variables inserted, please
        refer to the PSGI specification. The return values are:

        >=0     length of the request (request line and the request
                headers), in bytes

        -1      given request is corrupt

        -2      given request is incomplete

COPYRIGHT
    Copyright 2009- Kazuho Oku

AUTHOR
    Kazuho Oku

THANKS TO
    nothingmuch charsbar

SEE ALSO
    HTTP::Parser HTTP::HeaderParser::XS

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.