[thirdparty/git.git] / trace2 / tr2_dst.h

#ifndef TR2_DST_H
#define TR2_DST_H

struct strbuf;
#include "trace2/tr2_sysenv.h"

struct tr2_dst {
	enum tr2_sysenv_variable sysenv_var;
	int fd;
	unsigned int initialized : 1;
	unsigned int need_close : 1;
	unsigned int too_many_files : 1;
};

/*
 * Disable TRACE2 on the destination.  In TRACE2 a destination (DST)
 * wraps a file descriptor; it is associated with a TARGET which
 * defines the formatting.
 */
void tr2_dst_trace_disable(struct tr2_dst *dst);

/*
 * Return the file descriptor for the DST.
 * If 0, the dst is closed or disabled.
 */
int tr2_dst_get_trace_fd(struct tr2_dst *dst);

/*
 * Return true if the DST is opened for writing.
 */
int tr2_dst_trace_want(struct tr2_dst *dst);

/*
 * Write a single line/message to the trace file.
 */
void tr2_dst_write_line(struct tr2_dst *dst, struct strbuf *buf_line);

#endif /* TR2_DST_H */
Commit	Line	Data
ee4512ed JH	1	#ifndef TR2_DST_H
	2	#define TR2_DST_H
	3
	4	struct strbuf;
bce9db6d	5	#include "trace2/tr2_sysenv.h"
ee4512ed JH	6
ee4512ed JH	7	struct tr2_dst {
bce9db6d	8	enum tr2_sysenv_variable sysenv_var;
ee4512ed JH	9	int fd;
	10	unsigned int initialized : 1;
	11	unsigned int need_close : 1;
87db61a4	12	unsigned int too_many_files : 1;
ee4512ed JH	13	};
	14
	15	/*
	16	* Disable TRACE2 on the destination. In TRACE2 a destination (DST)
	17	* wraps a file descriptor; it is associated with a TARGET which
	18	* defines the formatting.
	19	*/
	20	void tr2_dst_trace_disable(struct tr2_dst *dst);
	21
	22	/*
	23	* Return the file descriptor for the DST.
	24	* If 0, the dst is closed or disabled.
	25	*/
	26	int tr2_dst_get_trace_fd(struct tr2_dst *dst);
	27
	28	/*
	29	* Return true if the DST is opened for writing.
	30	*/
	31	int tr2_dst_trace_want(struct tr2_dst *dst);
	32
	33	/*
	34	* Write a single line/message to the trace file.
	35	*/
	36	void tr2_dst_write_line(struct tr2_dst dst, struct strbuf buf_line);
	37
	38	#endif /* TR2_DST_H */