haproxy/include/common/fcgi.h
Willy Tarreau 4c7e4b7738 REORG: include: update all files to use haproxy/api.h or api-t.h if needed
All files that were including one of the following include files have
been updated to only include haproxy/api.h or haproxy/api-t.h once instead:

  - common/config.h
  - common/compat.h
  - common/compiler.h
  - common/defaults.h
  - common/initcall.h
  - common/tools.h

The choice is simple: if the file only requires type definitions, it includes
api-t.h, otherwise it includes the full api.h.

In addition, in these files, explicit includes for inttypes.h and limits.h
were dropped since these are now covered by api.h and api-t.h.

No other change was performed, given that this patch is large and
affects 201 files. At least one (tools.h) was already freestanding and
didn't get the new one added.
2020-06-11 10:18:42 +02:00

136 lines
3.7 KiB
C

/*
* include/common/fcgi.h
* This file contains FastCGI protocol definitions.
*
* Copyright (C) 2019 HAProxy Technologies, Christopher Faulet <cfaulet@haproxy.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation, version 2.1
* exclusively.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef _COMMON_FCGI_H
#define _COMMON_FCGI_H
#include <stdio.h>
#include <haproxy/api.h>
#include <common/standard.h>
#include <common/buf.h>
#include <common/ist.h>
/* FCGI protocol version */
#define FCGI_VERSION 0x1
/* flags for FCGI_BEGIN_REQUEST records */
#define FCGI_KEEP_CONN 0x01
/* FCGI record's type */
enum fcgi_record_type {
FCGI_BEGIN_REQUEST = 1,
FCGI_ABORT_REQUEST = 2,
FCGI_END_REQUEST = 3,
FCGI_PARAMS = 4,
FCGI_STDIN = 5,
FCGI_STDOUT = 6,
FCGI_STDERR = 7,
FCGI_DATA = 8,
FCGI_GET_VALUES = 9,
FCGI_GET_VALUES_RESULT = 10,
FCGI_UNKNOWN_TYPE = 11,
FCGI_ENTRIES
} __attribute__((packed));
enum fcgi_role {
FCGI_RESPONDER = 1,
FCGI_AUTHORIZER = 2, /* Unsupported */
FCGI_FILTER = 3, /* Unsupported */
} __attribute__((packed));
/* Protocol status */
enum fcgi_proto_status {
FCGI_PS_REQUEST_COMPLETE = 0,
FCGI_PS_CANT_MPX_CONN = 1,
FCGI_PS_OVERLOADED = 2,
FCGI_PS_UNKNOWN_ROLE = 3,
FCGI_PS_ENTRIES,
} __attribute__((packed));
struct fcgi_header {
uint8_t vsn;
uint8_t type;
uint16_t id;
uint16_t len;
uint8_t padding;
uint8_t rsv;
};
struct fcgi_param {
struct ist n;
struct ist v;
};
struct fcgi_begin_request {
enum fcgi_role role;
uint8_t flags;
};
struct fcgi_end_request {
uint32_t status;
uint8_t errcode;
};
struct fcgi_unknown_type {
uint8_t type;
};
static inline const char *fcgi_rt_str(int type)
{
switch (type) {
case FCGI_BEGIN_REQUEST : return "BEGIN_REQUEST";
case FCGI_ABORT_REQUEST : return "ABORT_REQUEST";
case FCGI_END_REQUEST : return "END_REQUEST";
case FCGI_PARAMS : return "PARAMS";
case FCGI_STDIN : return "STDIN";
case FCGI_STDOUT : return "STDOUT";
case FCGI_STDERR : return "STDERR";
case FCGI_DATA : return "DATA";
case FCGI_GET_VALUES : return "GET_VALUES";
case FCGI_GET_VALUES_RESULT : return "GET_VALUES_RESULT";
case FCGI_UNKNOWN_TYPE : return "UNKNOWN_TYPE";
default : return "_UNKNOWN_";
}
}
int fcgi_encode_record_hdr(struct buffer *out, const struct fcgi_header *h);
size_t fcgi_decode_record_hdr(const struct buffer *in, size_t o, struct fcgi_header *h);
int fcgi_encode_begin_request(struct buffer *out, const struct fcgi_begin_request *r);
int fcgi_encode_param(struct buffer *out, const struct fcgi_param *p);
size_t fcgi_decode_param(const struct buffer *in, size_t o, struct fcgi_param *p);
size_t fcgi_aligned_decode_param(const struct buffer *in, size_t o, struct fcgi_param *p);
size_t fcgi_decode_end_request(const struct buffer *in, size_t o, struct fcgi_end_request *r);
#endif /* _COMMON_FCGI_H */
/*
* Local variables:
* c-indent-level: 8
* c-basic-offset: 8
* End:
*/