]>
git.ipfire.org Git - thirdparty/openssl.git/blob - apps/include/http_server.h
2 * Copyright 1995-2020 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
10 #ifndef OSSL_HTTP_SERVER_H
11 # define OSSL_HTTP_SERVER_H
16 # if defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_WINDOWS)
29 # if !defined(NO_FORK) && !defined(OPENSSL_NO_SOCK) \
30 && !defined(OPENSSL_NO_POSIX_IO)
32 # include <sys/types.h>
33 # include <sys/wait.h>
36 # define MAXERRLEN 1000 /* limit error text sent to syslog to 1000 bytes */
42 # define LOG_WARNING 1
47 * Log a message to syslog if multi-threaded HTTP_DAEMON, else to bio_err
48 * prog: the name of the current app
49 * level: the severity of the message, e.g., LOG_ERR
50 * fmt: message with potential extra parameters like with printf()
53 void log_message(const char *prog
, int level
, const char *fmt
, ...);
55 # ifndef OPENSSL_NO_SOCK
57 * Initialize an HTTP server by setting up its listening BIO
58 * prog: the name of the current app
59 * port: the port to listen on
60 * returns a BIO for accepting requests, NULL on error
62 BIO
*http_server_init_bio(const char *prog
, const char *port
);
64 * Accept an ASN.1-formatted HTTP request
65 * it: the expected request ASN.1 type
66 * preq: pointer to variable where to place the parsed request
67 * pcbio: pointer to variable where to place the BIO for sending the response to
68 * acbio: the listening bio (typically as returned by http_server_init_bio())
69 * prog: the name of the current app
70 * accept_get: wheter to accept GET requests (in addition to POST requests)
71 * timeout: connection timeout (in seconds), or 0 for none/infinite
72 * returns 0 in case caller should retry, then *preq == *pcbio == NULL
73 * returns -1 on fatal error; also in this case *preq == *pcbio == NULL
74 * returns 1 otherwise. In this case it is guaranteed that *pcbio != NULL
75 * while *preq == NULL if and only if request is invalid
77 int http_server_get_asn1_req(const ASN1_ITEM
*it
, ASN1_VALUE
**preq
,
78 BIO
**pcbio
, BIO
*acbio
,
79 const char *prog
, int accept_get
, int timeout
);
81 * Send an ASN.1-formatted HTTP response
82 * cbio: destination BIO (typically as returned by http_server_get_asn1_req())
83 * note: cbio should not do an encoding that changes the output length
84 * content_type: string identifying the type of the response
85 * it: the response ASN.1 type
86 * valit: the response ASN.1 type
87 * resp: the response to send
88 * returns 1 on success, 0 on failure
90 int http_server_send_asn1_resp(BIO
*cbio
, const char *content_type
,
91 const ASN1_ITEM
*it
, const ASN1_VALUE
*resp
);
98 void socket_timeout(int signum
);
99 void spawn_loop(const char *prog
);