n_http2_server.h

Go to the documentation of this file.

/*
 * Nilorea Library
 * Copyright (C) 2005-2026 Castagnier Mickael
 *
 * 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.
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef __NILOREA_HTTP2_SERVER_HEADER
#define __NILOREA_HTTP2_SERVER_HEADER
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "n_http2.h"
 
#include <stddef.h>
#include <stdint.h>
#include <sys/types.h>

#define N_H2_SRV_MAX_HEADERS 128
#define N_H2_SRV_MAX_BODY (16 * 1024 * 1024)
#define N_H2_SRV_MAX_STREAMS 128
#define N_H2_SRV_READ_CHUNK 16384

#define N_H2_ERR_NO_ERROR 0x0            
#define N_H2_ERR_PROTOCOL_ERROR 0x1      
#define N_H2_ERR_INTERNAL_ERROR 0x2      
#define N_H2_ERR_FLOW_CONTROL_ERROR 0x3  
#define N_H2_ERR_SETTINGS_TIMEOUT 0x4    
#define N_H2_ERR_STREAM_CLOSED 0x5       
#define N_H2_ERR_FRAME_SIZE_ERROR 0x6    
#define N_H2_ERR_REFUSED_STREAM 0x7      
#define N_H2_ERR_CANCEL 0x8              
#define N_H2_ERR_COMPRESSION_ERROR 0x9   
#define N_H2_ERR_CONNECT_ERROR 0xa       
#define N_H2_ERR_ENHANCE_YOUR_CALM 0xb   
#define N_H2_ERR_INADEQUATE_SECURITY 0xc 
#define N_H2_ERR_HTTP_1_1_REQUIRED 0xd   

typedef ssize_t (*n_h2_srv_read_fn)(void* io, void* buf, size_t len);

typedef ssize_t (*n_h2_srv_write_fn)(void* io, const void* buf, size_t len);

typedef struct N_H2_SERVER N_H2_SERVER;

typedef struct N_H2_REQUEST {
    uint32_t stream_id;        
    N_H2_HEADER* headers;      
    size_t nheaders;           
    const char* method;        
    const char* scheme;        
    const char* authority;     
    const char* path;          
    const unsigned char* body; 
    size_t body_len;           
} N_H2_REQUEST;

typedef int (*n_h2_srv_request_cb)(void* user_data, N_H2_SERVER* srv, const N_H2_REQUEST* req);

N_H2_SERVER* n_http2_server_new(void* io, n_h2_srv_read_fn rd, n_h2_srv_write_fn wr);

void n_http2_server_free(N_H2_SERVER** srv);

int n_http2_server_handshake(N_H2_SERVER* srv);

int n_http2_server_run(N_H2_SERVER* srv, n_h2_srv_request_cb cb, void* user_data);

int n_http2_server_respond(N_H2_SERVER* srv, uint32_t stream_id, const N_H2_HEADER* headers, size_t nheaders, const unsigned char* body, size_t body_len);

int n_http2_server_rst_stream(N_H2_SERVER* srv, uint32_t stream_id, uint32_t error_code);

int n_http2_server_goaway(N_H2_SERVER* srv, uint32_t error_code);

const char* n_http2_server_error(const N_H2_SERVER* srv);

size_t n_http2_server_request_count(const N_H2_SERVER* srv);
 
#ifdef __cplusplus
}
#endif
 
#endif /* __NILOREA_HTTP2_SERVER_HEADER */