[thirdparty/xfsprogs-dev.git] / scrub / common.h

// SPDX-License-Identifier: GPL-2.0+
/*
 * Copyright (C) 2018 Oracle.  All Rights Reserved.
 * Author: Darrick J. Wong <darrick.wong@oracle.com>
 */
#ifndef XFS_SCRUB_COMMON_H_
#define XFS_SCRUB_COMMON_H_

/*
 * When reporting a defective metadata object to the console, this
 * is the size of the buffer to use to store the description of that
 * item.
 */
#define DESCR_BUFSZ	256

bool xfs_scrub_excessive_errors(struct scrub_ctx *ctx);

enum error_level {
	S_ERROR	= 0,
	S_WARN,
	S_REPAIR,
	S_INFO,
	S_PREEN,
};

void __str_out(struct scrub_ctx *ctx, const char *descr, enum error_level level,
	       int error, const char *file, int line, const char *format, ...);

#define str_errno(ctx, str) \
	__str_out(ctx, str, S_ERROR,	errno,	__FILE__, __LINE__, NULL)
#define str_liberror(ctx, error, str) \
	__str_out(ctx, str, S_ERROR,	error,	__FILE__, __LINE__, NULL)
#define str_error(ctx, str, ...) \
	__str_out(ctx, str, S_ERROR,	0,	__FILE__, __LINE__, __VA_ARGS__)
#define str_warn(ctx, str, ...) \
	__str_out(ctx, str, S_WARN,	0,	__FILE__, __LINE__, __VA_ARGS__)
#define str_info(ctx, str, ...) \
	__str_out(ctx, str, S_INFO,	0,	__FILE__, __LINE__, __VA_ARGS__)
#define record_repair(ctx, str, ...) \
	__str_out(ctx, str, S_REPAIR,	0,	__FILE__, __LINE__, __VA_ARGS__)
#define record_preen(ctx, str, ...) \
	__str_out(ctx, str, S_PREEN,	0,	__FILE__, __LINE__, __VA_ARGS__)

#define dbg_printf(fmt, ...) \
	do {if (debug > 1) {printf(fmt, __VA_ARGS__);}} while (0)

void __str_log(struct scrub_ctx *ctx, enum error_level level,
		const char *format, ...);

#define log_info(ctx, ...) \
	__str_log(ctx, S_INFO,	__VA_ARGS__)
#define log_warn(ctx, ...) \
	__str_log(ctx, S_WARN,	__VA_ARGS__)
#define log_err(ctx, ...) \
	__str_log(ctx, S_ERROR,	__VA_ARGS__)

/* Is this debug tweak enabled? */
static inline bool
debug_tweak_on(
	const char		*name)
{
	return debug && getenv(name) != NULL;
}

double timeval_subtract(struct timeval *tv1, struct timeval *tv2);
double auto_space_units(unsigned long long kilobytes, char **units);
double auto_units(unsigned long long number, char **units, int *precision);
unsigned int scrub_nproc(struct scrub_ctx *ctx);
unsigned int scrub_nproc_workqueue(struct scrub_ctx *ctx);

#ifndef HAVE_SYNCFS
static inline int syncfs(int fd)
{
	sync();
	return 0;
}
#endif

void background_sleep(void);
char *string_escape(const char *in);

#define TOO_MANY_NAME_WARNINGS	10000
bool should_warn_about_name(struct scrub_ctx *ctx);

bool within_range(struct scrub_ctx *ctx, unsigned long long value,
		unsigned long long desired, unsigned long long abs_threshold,
		unsigned int n, unsigned int d, const char *descr);

int scrub_render_ino_descr(const struct scrub_ctx *ctx, char *buf,
		size_t buflen, uint64_t ino, uint32_t gen,
		const char *format, ...);

#endif /* XFS_SCRUB_COMMON_H_ */
Commit	Line	Data
959ef981	1	// SPDX-License-Identifier: GPL-2.0+
95b1e505 DW	2	/*
95b1e505 DW	3	* Copyright (C) 2018 Oracle. All Rights Reserved.
95b1e505	4	* Author: Darrick J. Wong <darrick.wong@oracle.com>
95b1e505 DW	5	*/
	6	#ifndef XFS_SCRUB_COMMON_H_
	7	#define XFS_SCRUB_COMMON_H_
	8
f0585fce DW	9	/*
	10	* When reporting a defective metadata object to the console, this
	11	* is the size of the buffer to use to store the description of that
	12	* item.
	13	*/
	14	#define DESCR_BUFSZ 256
	15
	16	bool xfs_scrub_excessive_errors(struct scrub_ctx *ctx);
	17
	18	enum error_level {
	19	S_ERROR = 0,
	20	S_WARN,
19852474	21	S_REPAIR,
f0585fce	22	S_INFO,
19852474	23	S_PREEN,
f0585fce DW	24	};
	25
	26	void __str_out(struct scrub_ctx ctx, const char descr, enum error_level level,
	27	int error, const char file, int line, const char format, ...);
	28
	29	#define str_errno(ctx, str) \
	30	__str_out(ctx, str, S_ERROR, errno, __FILE__, __LINE__, NULL)
9612817d DW	31	#define str_liberror(ctx, error, str) \
9612817d DW	32	__str_out(ctx, str, S_ERROR, error, __FILE__, __LINE__, NULL)
f0585fce DW	33	#define str_error(ctx, str, ...) \
	34	__str_out(ctx, str, S_ERROR, 0, __FILE__, __LINE__, __VA_ARGS__)
	35	#define str_warn(ctx, str, ...) \
	36	__str_out(ctx, str, S_WARN, 0, __FILE__, __LINE__, __VA_ARGS__)
	37	#define str_info(ctx, str, ...) \
	38	__str_out(ctx, str, S_INFO, 0, __FILE__, __LINE__, __VA_ARGS__)
19852474 DW	39	#define record_repair(ctx, str, ...) \
	40	__str_out(ctx, str, S_REPAIR, 0, __FILE__, __LINE__, __VA_ARGS__)
	41	#define record_preen(ctx, str, ...) \
	42	__str_out(ctx, str, S_PREEN, 0, __FILE__, __LINE__, __VA_ARGS__)
f0585fce DW	43
	44	#define dbg_printf(fmt, ...) \
	45	do {if (debug > 1) {printf(fmt, __VA_ARGS__);}} while (0)
	46
7c309151 DW	47	void __str_log(struct scrub_ctx *ctx, enum error_level level,
	48	const char *format, ...);
	49
	50	#define log_info(ctx, ...) \
	51	__str_log(ctx, S_INFO, __VA_ARGS__)
	52	#define log_warn(ctx, ...) \
	53	__str_log(ctx, S_WARN, __VA_ARGS__)
	54	#define log_err(ctx, ...) \
	55	__str_log(ctx, S_ERROR, __VA_ARGS__)
	56
828105d1 DW	57	/* Is this debug tweak enabled? */
	58	static inline bool
	59	debug_tweak_on(
	60	const char *name)
	61	{
	62	return debug && getenv(name) != NULL;
	63	}
	64
173a0283 DW	65	double timeval_subtract(struct timeval tv1, struct timeval tv2);
173a0283 DW	66	double auto_space_units(unsigned long long kilobytes, char **units);
058f45da	67	double auto_units(unsigned long long number, char *units, int precision);
e031d90f DW	68	unsigned int scrub_nproc(struct scrub_ctx *ctx);
e031d90f DW	69	unsigned int scrub_nproc_workqueue(struct scrub_ctx *ctx);
173a0283	70
50a573a7 DW	71	#ifndef HAVE_SYNCFS
	72	static inline int syncfs(int fd)
	73	{
	74	sync();
	75	return 0;
	76	}
	77	#endif
	78
fd7d73c0	79	void background_sleep(void);
396cd022 DW	80	char string_escape(const char in);
	81
	82	#define TOO_MANY_NAME_WARNINGS 10000
	83	bool should_warn_about_name(struct scrub_ctx *ctx);
50a573a7	84
698c6c7c DW	85	bool within_range(struct scrub_ctx *ctx, unsigned long long value,
	86	unsigned long long desired, unsigned long long abs_threshold,
	87	unsigned int n, unsigned int d, const char *descr);
	88
15589f0a DW	89	int scrub_render_ino_descr(const struct scrub_ctx ctx, char buf,
	90	size_t buflen, uint64_t ino, uint32_t gen,
	91	const char *format, ...);
	92
95b1e505	93	#endif /* XFS_SCRUB_COMMON_H_ */