NAME

Net::FastCGI::Protocol - Provides functions to build and parse FastCGI messages.

SYNOPSIS

# FCGI_Header
$octets = build_header($type, $request_id, $content_length, $padding_length);
@values = parse_header($octets);

# FCGI_BeginRequestBody
$octets = build_begin_request_body($role, $flags);
@values = parse_begin_request_body($octets);

# FCGI_EndRequestBody
$octets = build_end_request_body($application_status, $protocol_status);
@values = parse_end_request_body($octets);

# FCGI_UnknownTypeBody
$octets = build_unknown_type_body($type);
@values = parse_unknown_type_body($octets);

# FCGI_BeginRequestRecord
$octets = build_begin_request_record($request_id, $role, $flags);

# FCGI_EndRequestRecord
$octets = build_end_request_record($request_id, $application_status, $protocol_status);

# FCGI_UnknownTypeRecord
$octets = build_unknown_type_record($type);

# FCGI_Record
$octets = build_record($type, $request_id);
$octets = build_record($type, $request_id, $content);

# FCGI_NameValuePair's
$octets = build_params($params);
$params = parse_params($octets);

DESCRIPTION

Provides functions to build and parse FastCGI messages.

FUNCTIONS

build_begin_request_body

Builds a FCGI_BeginRequestBody.

Usage

$octets = build_begin_request_body($role, $flags);

Arguments

$role: An unsigned 16-bit integer.
$flags: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the body. String is 8 octets in length.

build_begin_request_record

Builds a FCGI_BeginRequestRecord.

Usage

$octets = build_begin_request_record($request_id, $role, $flags);

Arguments

$request_id: An unsigned 16-bit integer.
$role: An unsigned 16-bit integer.
$flags: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the record. String is 16 octets in length.

build_end_request_body

Builds a FCGI_EndRequestBody.

Usage

$octets = build_end_request_body($application_status, $protocol_status);

Arguments

$application_status: An unsigned 32-bit integer.
$protocol_status: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the body. String is 8 octets in length.

build_end_request_record

Builds a FCGI_EndRequestRecord.

Usage

$octets = build_end_request_record($request_id, $application_status, $protocol_status);

Arguments

$request_id: An unsigned 16-bit integer.
$application_status: An unsigned 32-bit integer.
$protocol_status: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the record. String is 16 octets in length.

build_header

Builds a FCGI_Header.

Usage

$octets = build_header($type, $request_id, $content_length, $padding_length);

Arguments

$type: An unsigned 8-bit integer.
$request_id: An unsigned 16-bit integer.
$content_length: An unsigned 16-bit integer.
$padding_length: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the header. String is 8 octets in length.

build_padding

Usage

$octets = build_padding($padding_length);

Arguments

$padding_length: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the padding.

build_params

Builds FCGI_NameValuePair's.

Usage

$octets = build_params($params);

Arguments

$params: A hash reference containing name/value pairs.

Returns

$octets

build_params_pair

Builds a FCGI_NameValuePair.

Usage

$octets = build_params_pair($name, $value);

Arguments

$name: A string of octets containing the name.
$value: A string of octets containing the value.

Returns

$octets: A string of octets containing the FCGI_NameValuePair.

build_params_pair_header

Builds FCGI_NameValuePair header.

Usage

$octets = build_params_pair_header($name_length, $value_length);

Arguments

$name_length: An unsigned 31-bit integer.
$value_length: An unsigned 31-bit integer.

Returns

$octets: A string of octets containing the FCGI_NameValuePair header.

build_record

Builds a FCGI_Record.

Usage

$octets = build_record($type, $request_id);
$octets = build_record($type, $request_id, $content);

Arguments

$type: An unsigned 8-bit integer.
$request_id: An unsigned 16-bit integer.
$content (optional): A string of octets containing the content, must be less than or equal to 65535 octets in length.

Returns

$octets: A string of octets containing the record.

build_unknown_type_body

Builds a FCGI_UnknownTypeBody.

Usage

$octets = build_unknown_type_body($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the body. String is 8 octets in length.

build_unknown_type_record

Builds a FCGI_UnknownTypRecord.

Usage

$octets = build_unknown_type_record($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$octets: A string of octets containing the record. String is 16 octets in length.

parse_begin_request_body

Parses a FCGI_BeginRequestBody.

Usage

($role, $flags) = parse_begin_request_body($octets);

Arguments

$octets: A string of octets containing the body, must be greater than or equal to 8 octets in length.

Returns

$role: An unsigned 16-bit integer.
$flags: An unsigned 8-bit integer.

parse_end_request_body

Parses a FCGI_EndRequestBody.

Usage

($application_status, $protocol_status) = parse_end_request_body($octets);

Arguments

$octets: A string of octets containing the body, must be greater than or equal to 8 octets in length.

Returns

$application_status: An unsigned 32-bit integer.
$flags: An unsigned 8-bit integer.

parse_header

Parses a FCGI_Header.

Usage

($type, $request_id, $content_length, $padding_length) = parse_header($octets);

Arguments

$octets: A string of octets containing the header, must be greater than or equal to 8 octets in length.

Returns

$type: An unsigned 8-bit integer.
$request_id: An unsigned 16-bit integer.
$content_length: An unsigned 16-bit integer.
$padding_length: An unsigned 8-bit integer.

parse_params

Parses FCGI_NameValuePair's.

Usage

$params = parse_params($octets);

Arguments

$octets: A string of octets containing FCGI_NameValuePair's.

Returns

$params: A hash reference containing name/value pairs.

parse_params_pair

Parses a FCGI_NameValuePair.

Usage

($name, $value, $pair_length) = parse_params_pair($octets);
($name, $value, $pair_length) = parse_params_pair($octets, $offset);

Arguments

$octets: $octets must be greater than or equal to 2 octets in length.
$offset (optional): An unsigned integer containing the offset in octets.

Returns

$name: Octets containing the name.
$value: Octets containing the value.
$pair_length: Length of FCGI_NameValuePair in octets.

parse_params_pair_header

Parses a FCGI_NameValuePair header.

Usage

($name_length, $value_length, $header_length) = parse_params_pair_header($octets);
($name_length, $value_length, $header_length) = parse_params_pair_header($octets, $offset);

Arguments

$octets: $octets must be greater than or equal to 2 octets in length.
$offset (optional): An unsigned integer containing the offset in octets.

Returns

$name_length: An unsigned 31-bit integer.
$value_length: An unsigned 31-bit integer.
$header_length: Length of FCGI_NameValuePair header in octets.

parse_unknown_type_body

Parses a FCGI_UnknownTypeBody.

Usage

$type = parse_unknown_type_body($octets);

Arguments

$octets: $octets must be greater than or equal to 8 octets in length.

Returns

$type: An unsigned 8-bit integer.

compute_padding_length

Usage

$length = compute_padding_length($content_length);

Arguments

$content_length: An unsigned 16-bit integer.

Returns

$length: Length of padding in octets. Length is between 0 and 7.

compute_params_length

Usage

$length = compute_params_length($params);

Arguments

$params: A hash reference containing name/value pairs.

Returns

$length: Length of params in octets.

compute_params_pair_length

Usage

$length = compute_params_pair_length($name, $value);

Arguments

$name: A string of octets containing the name.
$value: A string of octets containing the value.

Returns

$length: Length of FCGI_NameValuePair in octets.

compute_params_pair_header_length

Usage

$length = compute_params_pair_header_length($name_length, $value_length);

Arguments

$name_length: An unsigned 31-bit integer.
$value_length: An unsigned 31-bit integer.

Returns

$length: Length of FCGI_NameValuePair header in octets.

compute_record_length

Usage

$length = compute_record_length($content_length);

Arguments

$content_length: An unsigned 16-bit integer.

Returns

$length: Length of FCGI_Record in octets.

get_type_name

Usage

$name = get_type_name($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$name: A string containing the name of the type.

get_role_name

Usage

$name = get_role_name($type);

Arguments

$role: An unsigned 16-bit integer.

Returns

$name: A string containing the name of the role.

get_protocol_status_name

Usage

$name = get_protocol_status_name($protocol_status);

Arguments

$protocol_status: An unsigned 8-bit integer.

Returns

$name: A string containing the name of the protocol status.

is_known_type

Usage

$boolean = is_known_type($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$boolean: A boolean indicating whether or not $type is a known FastCGI v1 type.

is_management_type

Usage

$boolean = is_management_type($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$boolean: A boolean indicating whether or not $type is a management type.

is_discrete_type

Usage

$boolean = is_discrete_type($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$boolean: A boolean indicating whether or not $type is a discrete type.

is_stream_type

Usage

$boolean = is_stream_type($type);

Arguments

$type: An unsigned 8-bit integer.

Returns

$boolean: A boolean indicating whether or not $type is a stream type.

EXPORTS

None by default. All functions can be exported using the :all tag or individually.

DIAGNOSTICS

(F) Usage: %s
(F) Argument "%s" is not a hash reference
(F) Argument "%s" is not an unsigned integer
(F) Argument "%s" is not an unsigned %u-bit integer
(F) Argument "%s" must be greater than or equal to %u octets in length
(F) Argument "%s" must be less than or equal to %u octets in length
(F) Argument "%s" is outside of octets length
(F) Unexpected end of octets while parsing FCGI_NameValuePair header
(F) Unexpected end of octets while parsing FCGI_NameValuePair name
(F) Unexpected end of octets while parsing FCGI_NameValuePair value
(F) Unsupported FastCGI version: %u

AUTHOR

Christian Hansen chansen@cpan.org

COPYRIGHT

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

To install Net::FastCGI, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Net::FastCGI

CPAN shell

perl -MCPAN -e shell
install Net::FastCGI

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

SYNOPSIS

DESCRIPTION

FUNCTIONS

build_begin_request_body

build_begin_request_record

build_end_request_body

build_end_request_record

build_header

build_padding

build_params

build_params_pair

build_params_pair_header

build_record

build_unknown_type_body

build_unknown_type_record

parse_begin_request_body

parse_end_request_body

parse_header

parse_params

parse_params_pair

parse_params_pair_header

parse_unknown_type_body

compute_padding_length

compute_params_length

compute_params_pair_length

compute_params_pair_header_length

compute_record_length

get_type_name

get_role_name

get_protocol_status_name

is_known_type

is_management_type

is_discrete_type

is_stream_type

EXPORTS

DIAGNOSTICS

SEE ALSO

AUTHOR

COPYRIGHT

Module Install Instructions