mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2025-12-26 03:51:41 +01:00
1bdf6e884a
sink_find_early() is a convenient function that can be used instead of sink_find() during parsing time in order to try to find a matching sink even if the sink is not defined yet. Indeed, if the sink is not defined, sink_find_early() will try to create it and mark it as forward-declared. It will also save informations from the caller to better identify it in case of errors. If the sink happens to be found in the config, it will transition from forward-declared type to its final type. Else, it means that the sink was not found in the config, in this case, during postresolve, we raise an error to indicate that the sink was not found in the configuration. It should help solve postresolving issue with rings, because for now only log targets implement proper ring postresolving.. but rings may be used at different places in the code, such as debug() converter or in "traces" section.
82 lines
3.0 KiB
C
82 lines
3.0 KiB
C
/*
|
|
* include/haproxy/sink-t.h
|
|
* This file provides definitions for event sinks
|
|
*
|
|
* Copyright (C) 2000-2019 Willy Tarreau - w@1wt.eu
|
|
*
|
|
* This library 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, version 2.1
|
|
* exclusively.
|
|
*
|
|
* 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 this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef _HAPROXY_SINK_T_H
|
|
#define _HAPROXY_SINK_T_H
|
|
|
|
#include <import/ist.h>
|
|
#include <haproxy/api-t.h>
|
|
#include <haproxy/log-t.h>
|
|
|
|
/* A sink may be of 4 distinct types :
|
|
* - file descriptor (such as stdout)
|
|
* - ring buffer, readable from CLI
|
|
*/
|
|
enum sink_type {
|
|
SINK_TYPE_FORWARD_DECLARED, // was searched using sink_find_early(), is expected to exist by some component
|
|
SINK_TYPE_NEW, // not yet initialized
|
|
SINK_TYPE_FD, // events sent to a file descriptor
|
|
SINK_TYPE_BUFFER, // events sent to a ring buffer
|
|
};
|
|
|
|
struct sink_forward_target {
|
|
struct server *srv; // used server
|
|
struct appctx *appctx; // appctx of current session
|
|
size_t ofs; // ring buffer reader offset
|
|
size_t e_processed; // processed events
|
|
struct sink *sink; // the associated sink
|
|
struct sink_forward_target *next;
|
|
__decl_thread(HA_SPINLOCK_T lock); // lock to protect current struct
|
|
};
|
|
|
|
/* describes the configuration and current state of an event sink */
|
|
struct sink {
|
|
struct list sink_list; // position in the sink list
|
|
char *name; // sink name
|
|
char *desc; /* sink description:
|
|
* when forward-declared, holds info about where the
|
|
* sink was first forward declared, else holds actual
|
|
* sink description
|
|
*/
|
|
char *store; // backing-store file when buffer
|
|
enum log_fmt fmt; // format expected by the sink
|
|
enum sink_type type; // type of storage
|
|
uint32_t maxlen; // max message length (truncated above)
|
|
struct proxy* forward_px; // internal proxy used to forward (only set when exclusive to sink)
|
|
struct sink_forward_target *sft; // sink forward targets
|
|
struct task *forward_task; // task to handle forward targets conns
|
|
struct sig_handler *forward_sighandler; /* signal handler */
|
|
struct {
|
|
struct ring *ring; // used by ring buffer and STRM sender
|
|
unsigned int dropped; // 2*dropped events since last one + 1 for purge in progress.
|
|
int fd; // fd num for FD type sink
|
|
} ctx;
|
|
};
|
|
|
|
#endif /* _HAPROXY_SINK_T_H */
|
|
|
|
/*
|
|
* Local variables:
|
|
* c-indent-level: 8
|
|
* c-basic-offset: 8
|
|
* End:
|
|
*/
|