mhd_opt_matrix.h

Go to the documentation of this file.

/*
     This file is part of GNU libmicrohttpd
     Copyright (C) 2026 Christian Grothoff
 
     GNU libmicrohttpd 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; either
     version 2.1 of the License, or (at your option) any later version.
 
     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 GNU libmicrohttpd.
     If not, see <http://www.gnu.org/licenses/>.
*/
 
#ifndef MHD_OPT_MATRIX_H
#define MHD_OPT_MATRIX_H 1
 
#include <stddef.h>
#include <microhttpd.h>
 
#define MHD_OPT_MATRIX_PROFILE_ENV "MHD_TEST_PROFILE"
 
#define MHD_OPT_MATRIX_MEM_ENV "MHD_TEST_MEM_LIMIT"
 
#define MHD_OPT_MATRIX_DISCP_ENV "MHD_TEST_DISCIPLINE"
 
#define MHD_OPT_MATRIX_STRICT_ENV "MHD_TEST_STRICT_FOR_CLIENT"
 
#define MHD_OPT_MATRIX_THREADING_ENV "MHD_TEST_THREADING"
 
#define MHD_OPT_MATRIX_POLL_ENV "MHD_TEST_POLL"
 
enum MHD_OptMatrixThreading
{
  MHD_OPT_MATRIX_THR_EXTERNAL = 0,
 
  MHD_OPT_MATRIX_THR_INTERNAL = 1,
 
  MHD_OPT_MATRIX_THR_PER_CONNECTION = 2,
 
  MHD_OPT_MATRIX_THR_POOL = 3
};
 
 
enum MHD_OptMatrixPoll
{
  MHD_OPT_MATRIX_POLL_SELECT = 0,
 
  MHD_OPT_MATRIX_POLL_POLL = 1,
 
  MHD_OPT_MATRIX_POLL_EPOLL = 2
};
 
 
struct MHD_OptMatrixProfile
{
  const char *name;
 
  size_t mem_limit;
 
  int discipline_lvl;
 
  int use_legacy_strict;
 
  enum MHD_OptMatrixThreading threading;
 
  enum MHD_OptMatrixPoll poll_backend;
 
  unsigned int thread_pool_size;
};
 
 
unsigned int
mhd_opt_matrix_num_profiles (void);
 
 
const struct MHD_OptMatrixProfile *
mhd_opt_matrix_profile (unsigned int idx);
 
 
const struct MHD_OptMatrixProfile *
mhd_opt_matrix_lookup (const char *name_or_idx);
 
 
const struct MHD_OptMatrixProfile *
mhd_opt_matrix_from_env (void);
 
 
int
mhd_opt_matrix_effective_discipline (const struct MHD_OptMatrixProfile *prof);
 
 
int
mhd_opt_matrix_profile_supported (const struct MHD_OptMatrixProfile *prof);
 
 
const char *
mhd_opt_matrix_describe (const struct MHD_OptMatrixProfile *prof,
                         char *buf,
                         size_t buf_size);
 
 
unsigned int
mhd_opt_matrix_fill_options (const struct MHD_OptMatrixProfile *prof,
                             struct MHD_OptionItem *ops,
                             unsigned int max_ops);
 
 
unsigned int
mhd_opt_matrix_daemon_flags (const struct MHD_OptMatrixProfile *prof,
                             unsigned int base_flags,
                             int allow_external);
 
 
int
mhd_opt_matrix_is_external (const struct MHD_OptMatrixProfile *prof);
 
 
int
mhd_opt_matrix_raise_mem_limit (struct MHD_OptMatrixProfile *prof,
                                size_t min_limit);
 
 
void
mhd_opt_matrix_print_notice (const char *test_name);
 
 
#endif /* MHD_OPT_MATRIX_H */