blob: c003bd3b031b0e88298f03b7dbb53ec2fc47244a [file] [log] [blame]
Willy Tarreaubaaee002006-06-26 02:48:02 +02001/*
Willy Tarreau0a3dd742012-05-08 19:47:01 +02002 * include/common/cfgparse.h
3 * Configuration parsing functions.
4 *
5 * Copyright (C) 2000-2012 Willy Tarreau - w@1wt.eu
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation, version 2.1
10 * exclusively.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
Willy Tarreaubaaee002006-06-26 02:48:02 +020021
Willy Tarreau2dd0d472006-06-29 17:53:05 +020022#ifndef _COMMON_CFGPARSE_H
23#define _COMMON_CFGPARSE_H
Willy Tarreaubaaee002006-06-26 02:48:02 +020024
Willy Tarreau5b2c3362008-07-09 19:39:06 +020025#include <common/compat.h>
Willy Tarreaue3ba5f02006-06-29 18:54:54 +020026#include <common/config.h>
Willy Tarreau5b2c3362008-07-09 19:39:06 +020027#include <common/mini-clist.h>
28
Willy Tarreau272adea2014-03-31 10:39:59 +020029#include <proto/log.h>
30#include <proto/proxy.h>
Willy Tarreaue3ba5f02006-06-29 18:54:54 +020031
Willy Tarreaubaaee002006-06-26 02:48:02 +020032/* configuration sections */
33#define CFG_NONE 0
34#define CFG_GLOBAL 1
35#define CFG_LISTEN 2
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +010036#define CFG_USERLIST 3
Emeric Brun32da3c42010-09-23 18:39:19 +020037#define CFG_PEERS 4
Willy Tarreaubaaee002006-06-26 02:48:02 +020038
Willy Tarreau5b2c3362008-07-09 19:39:06 +020039struct cfg_keyword {
40 int section; /* section type for this keyword */
41 const char *kw; /* the keyword itself */
Willy Tarreau39f23b62008-07-09 20:22:56 +020042 int (*parse)( /* 0=OK, <0=Alert, >0=Warning */
43 char **args, /* command line and arguments */
Willy Tarreau5b2c3362008-07-09 19:39:06 +020044 int section_type, /* current section CFG_{GLOBAL|LISTEN} */
45 struct proxy *curpx, /* current proxy (NULL in GLOBAL) */
46 struct proxy *defpx, /* default proxy (NULL in GLOBAL) */
Willy Tarreau28a47d62012-09-18 20:02:48 +020047 const char *file, /* config file name */
48 int line, /* config file line number */
Willy Tarreau0a3dd742012-05-08 19:47:01 +020049 char **err); /* error or warning message output pointer */
Willy Tarreau5b2c3362008-07-09 19:39:06 +020050};
51
52/* A keyword list. It is a NULL-terminated array of keywords. It embeds a
53 * struct list in order to be linked to other lists, allowing it to easily
54 * be declared where it is needed, and linked without duplicating data nor
55 * allocating memory.
56 */
57struct cfg_kw_list {
58 struct list list;
59 struct cfg_keyword kw[VAR_ARRAY];
60};
61
62
Willy Tarreaubaaee002006-06-26 02:48:02 +020063extern int cfg_maxpconn;
64extern int cfg_maxconn;
Christopher Faulet79bdef32016-11-04 22:36:15 +010065extern char *cfg_scope;
Willy Tarreaubaaee002006-06-26 02:48:02 +020066
Krzysztof Oledzki336d4752007-12-25 02:40:22 +010067int cfg_parse_global(const char *file, int linenum, char **args, int inv);
68int cfg_parse_listen(const char *file, int linenum, char **args, int inv);
Frédéric Lécaillea41d5312018-01-29 12:05:07 +010069int cfg_parse_track_sc_num(unsigned int *track_sc_num,
70 const char *arg, const char *end, char **err);
Willy Tarreaub17916e2006-10-15 15:17:57 +020071int readcfgfile(const char *file);
Willy Tarreau5b2c3362008-07-09 19:39:06 +020072void cfg_register_keywords(struct cfg_kw_list *kwl);
73void cfg_unregister_keywords(struct cfg_kw_list *kwl);
Willy Tarreau915e1eb2009-06-22 15:48:36 +020074void init_default_instance();
75int check_config_validity();
Willy Tarreau4fbb2282012-09-20 20:01:39 +020076int str2listener(char *str, struct proxy *curproxy, struct bind_conf *bind_conf, const char *file, int line, char **err);
Thierry FOURNIERfa45f1d2014-03-18 13:54:18 +010077int cfg_register_section(char *section_name,
William Lallemandd2ff56d2017-10-16 11:06:50 +020078 int (*section_parser)(const char *, int, char **, int),
79 int (*post_section_parser)());
William Lallemand48b4bb42017-10-23 14:36:34 +020080int cfg_register_postparser(char *name, int (*func)());
David Carlier845efb52015-09-25 11:49:18 +010081void cfg_unregister_sections(void);
Christopher Faulet7110b402016-10-26 11:09:44 +020082void cfg_backup_sections(struct list *backup_sections);
83void cfg_restore_sections(struct list *backup_sections);
Willy Tarreau3986b9c2014-09-16 15:39:51 +020084int warnif_misplaced_tcp_conn(struct proxy *proxy, const char *file, int line, const char *arg);
Willy Tarreau620408f2016-10-21 16:37:51 +020085int warnif_misplaced_tcp_sess(struct proxy *proxy, const char *file, int line, const char *arg);
Willy Tarreau3986b9c2014-09-16 15:39:51 +020086int warnif_misplaced_tcp_cont(struct proxy *proxy, const char *file, int line, const char *arg);
Willy Tarreauece9b072016-12-21 22:41:44 +010087int too_many_args_idx(int maxarg, int index, char **args, char **msg, int *err_code);
88int too_many_args(int maxarg, char **args, char **msg, int *err_code);
89int alertif_too_many_args_idx(int maxarg, int index, const char *file, int linenum, char **args, int *err_code);
90int alertif_too_many_args(int maxarg, const char *file, int linenum, char **args, int *err_code);
Christopher Faulet26028f62017-11-22 15:01:51 +010091int parse_process_number(const char *arg, unsigned long *proc, int *autoinc, char **err);
Willy Tarreaubaaee002006-06-26 02:48:02 +020092
Willy Tarreau272adea2014-03-31 10:39:59 +020093/*
94 * Sends a warning if proxy <proxy> does not have at least one of the
95 * capabilities in <cap>. An optionnal <hint> may be added at the end
96 * of the warning to help the user. Returns 1 if a warning was emitted
97 * or 0 if the condition is valid.
98 */
99static inline int warnifnotcap(struct proxy *proxy, int cap, const char *file, int line, const char *arg, const char *hint)
100{
101 char *msg;
102
103 switch (cap) {
104 case PR_CAP_BE: msg = "no backend"; break;
105 case PR_CAP_FE: msg = "no frontend"; break;
Willy Tarreau272adea2014-03-31 10:39:59 +0200106 case PR_CAP_BE|PR_CAP_FE: msg = "neither frontend nor backend"; break;
107 default: msg = "not enough"; break;
108 }
109
110 if (!(proxy->cap & cap)) {
Christopher Faulet767a84b2017-11-24 16:50:31 +0100111 ha_warning("parsing [%s:%d] : '%s' ignored because %s '%s' has %s capability.%s\n",
112 file, line, arg, proxy_type_str(proxy), proxy->id, msg, hint ? hint : "");
Willy Tarreau272adea2014-03-31 10:39:59 +0200113 return 1;
114 }
115 return 0;
116}
117
Willy Tarreau2dd0d472006-06-29 17:53:05 +0200118#endif /* _COMMON_CFGPARSE_H */
Willy Tarreaubaaee002006-06-26 02:48:02 +0200119
120/*
121 * Local variables:
122 * c-indent-level: 8
123 * c-basic-offset: 8
124 * End:
125 */