h3_config.h¶

Structs¶

	Name
struct	h3_server_conf

Types¶

	Name
enum	h3_tri_flag
typedef struct h3_server_conf	h3_server_conf

Functions¶

	Name
apr_port_t	get_server_port(const server_rec * s)
void *	h3_create_server_config(apr_pool_t * p, server_rec * s)
void *	h3_merge_server_config(apr_pool_t * p, void * base_conf, void * new_conf)
void *	h3_create_dir_config(apr_pool_t * p, char * dir)
void *	h3_merge_dir_config(apr_pool_t * p, void * base, void * add)
int	h3_post_config(apr_pool_t * p, apr_pool_t * plog, apr_pool_t * ptemp, server_rec * s)

Attributes¶

	Name
const command_rec[]	h3_cmds

Types Documentation¶

enum h3_tri_flag¶

Enumerator	Value	Description
H3_FLAG_UNSET	0
H3_FLAG_ON
H3_FLAG_OFF

typedef h3_server_conf¶

typedef struct h3_server_conf h3_server_conf;

Functions Documentation¶

function get_server_port¶

apr_port_t get_server_port(
    const server_rec * s
)

Parameters:

s The server_rec.

Return: The TCP port, or 0 if undetermined.

Look up the TCP Listen port of a vhost by scanning its Port and Listen directive state.

function h3_create_server_config¶

void * h3_create_server_config(
    apr_pool_t * p,
    server_rec * s
)

Parameters:

p Pool used for the allocation.
s The vhost the config belongs to (unused).

Return: The new h3_server_conf.

ap_create_server_config callback: allocate a fresh zero-initialised h3_server_conf from p. All fields start as NULL/0.

function h3_merge_server_config¶

void * h3_merge_server_config(
    apr_pool_t * p,
    void * base_conf,
    void * new_conf
)

Parameters:

p Pool for the merged config.
base_conf Parent h3_server_conf.
new_conf Child h3_server_conf.

Return: The merged h3_server_conf.

ap_merge_server_config callback: produce a child vhost config that inherits each unset field from the parent. cert/key/h3_port use the new value if non-NULL/non-zero, else the base.

function h3_create_dir_config¶

void * h3_create_dir_config(
    apr_pool_t * p,
    char * dir
)

Parameters:

p Pool for the allocation.
dir The directory path (unused).

Return: A 1-byte zero-initialised block.

ap_create_dir_config callback. mod_http3 has no per-directory state; returns a 1-byte allocation so httpd takes ownership of a non-NULL pointer.

function h3_merge_dir_config¶

void * h3_merge_dir_config(
    apr_pool_t * p,
    void * base,
    void * add
)

Parameters:

p Pool for any allocation (unused).
base Base per-dir config.
add Per-dir config being merged in (unused).

Return: The base per-dir config.

ap_merge_dir_config callback. Identity merge: per-directory config is a no-op for mod_http3, so the base is returned unchanged.

function h3_post_config¶

int h3_post_config(
    apr_pool_t * p,
    apr_pool_t * plog,
    apr_pool_t * ptemp,
    server_rec * s
)

Parameters:

p Config pool (unused).
plog Log pool (unused).
ptemp Temp pool (unused).
s The first server_rec in the configuration.

Return: OK, or HTTP_INTERNAL_SERVER_ERROR if no vhost has both H3CertificatePath and H3CertificateKeyPath set.

ap_post_config hook: resolve cert/key/h3_port for the listening vhost and log the resolved values. No-op in AP_SQ_MS_CREATE_PRE_CONFIG (pre-config phase). Returns OK if a fully-configured vhost is found, HTTP_INTERNAL_SERVER_ERROR otherwise.

Attributes Documentation¶

variable h3_cmds¶

const command_rec[] h3_cmds;

Source code¶

/*
 * Copyright (c) 2026 The mod_http3 Project Authors. All rights reserved.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed 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.
 */

#ifndef H3_CONFIG_H
#define H3_CONFIG_H

#include <httpd.h>

#include <http_config.h>

extern const command_rec h3_cmds[];

typedef struct h3_server_conf h3_server_conf;

typedef enum
{
    H3_FLAG_UNSET = 0,
    H3_FLAG_ON,
    H3_FLAG_OFF
} h3_tri_flag;

struct h3_server_conf
{
    apr_port_t host_port;

    const char* h3_cert_path;
    const char* h3_key_path;
    const char* h3_quic_engine;
    apr_port_t h3_port;
    apr_uint32_t h3_max_concurrent_streams;
    apr_uint32_t h3_max_connections;
    apr_size_t h3_stream_buffer_size;
    apr_size_t h3_max_request_body_size;
    apr_size_t h3_max_response_body_size;
    h3_tri_flag h3_alt_svc;
    h3_tri_flag h3_address_validation;
    apr_uint32_t h3_alt_svc_max_age;
    apr_uint32_t h3_handshake_timeout;
    apr_uint32_t h3_idle_timeout;
};

apr_port_t get_server_port(const server_rec* s);

void* h3_create_server_config(apr_pool_t* p, server_rec* s);

void* h3_merge_server_config(apr_pool_t* p, void* base_conf, void* new_conf);

void* h3_create_dir_config(apr_pool_t* p, char* dir);

void* h3_merge_dir_config(apr_pool_t* p, void* base, void* add);

int h3_post_config(apr_pool_t* p, apr_pool_t* plog, apr_pool_t* ptemp, server_rec* s);

#endif /* H3_CONFIG_H */