HEX
Server: LiteSpeed
System: Linux server.searchcove.com 4.18.0-513.24.1.lve.2.el8.x86_64 #1 SMP Fri May 24 12:42:50 UTC 2024 x86_64
User: lurax (1083)
PHP: 8.3.30
Disabled: exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname
Upload Files
File: //usr/include/dovecot/sieve/sieve-code.h
#ifndef SIEVE_CODE_H
#define SIEVE_CODE_H

#include "lib.h"
#include "buffer.h"
#include "mempool.h"
#include "array.h"

#include "sieve-common.h"
#include "sieve-runtime.h"
#include "sieve-runtime-trace.h"
#include "sieve-dump.h"

/*
 * Operand object
 */

struct sieve_operand_class {
	const char *name;
};

struct sieve_operand_def {
	const char *name;

	const struct sieve_extension_def *ext_def;
	unsigned int code;

	const struct sieve_operand_class *class;
	const void *interface;
};

struct sieve_operand {
	const struct sieve_operand_def *def;
	const struct sieve_extension *ext;
	sieve_size_t address;
	const char *field_name;
};

#define sieve_operand_name(opr) \
	((opr)->def == NULL ? "(NULL)" : (opr)->def->name)
#define sieve_operand_is(opr, definition) \
	((opr)->def == &(definition))

sieve_size_t
sieve_operand_emit(struct sieve_binary_block *sblock,
		   const struct sieve_extension *ext,
		   const struct sieve_operand_def *oprnd);
bool sieve_operand_read(struct sieve_binary_block *sblock,
			sieve_size_t *address, const char *field_name,
			struct sieve_operand *oprnd);

static inline int
sieve_operand_runtime_read(const struct sieve_runtime_env *renv,
			   sieve_size_t *address, const char *field_name,
			   struct sieve_operand *operand)
{
	if (!sieve_operand_read(renv->sblock, address, field_name, operand)) {
		sieve_runtime_trace_operand_error(renv, operand,
						  "invalid operand");
		return SIEVE_EXEC_BIN_CORRUPT;
	}
	return SIEVE_EXEC_OK;
}

/*
 * Optional operands
 */

int sieve_opr_optional_next(struct sieve_binary_block *sblock,
			    sieve_size_t *address, signed int *opt_code);

static inline int
sieve_opr_optional_dump(const struct sieve_dumptime_env *denv,
			sieve_size_t *address, signed int *opt_code)
{
	sieve_size_t pc = *address;
	int ret;

	if ((ret = sieve_opr_optional_next(denv->sblock, address,
					   opt_code)) <= 0)
		return ret;

	sieve_code_mark_specific(denv, pc);
	return ret;
}

static inline int
sieve_opr_optional_read(const struct sieve_runtime_env *renv,
			sieve_size_t *address, signed int *opt_code)
{
	int ret;

	if ((ret = sieve_opr_optional_next(renv->sblock, address,
					   opt_code)) < 0) {
		sieve_runtime_trace_error(
			renv, "invalid optional operand code");
	}
	return ret;
}

/*
 * Core operands
 */

/* Operand codes */

enum sieve_core_operand {
	SIEVE_OPERAND_OPTIONAL = 0x00,
	SIEVE_OPERAND_NUMBER,
	SIEVE_OPERAND_STRING,
	SIEVE_OPERAND_STRING_LIST,
	SIEVE_OPERAND_COMPARATOR,
	SIEVE_OPERAND_MATCH_TYPE,
	SIEVE_OPERAND_ADDRESS_PART,
	SIEVE_OPERAND_CATENATED_STRING,

	SIEVE_OPERAND_CUSTOM
};

/* Operand classes */

extern const struct sieve_operand_class number_class;
extern const struct sieve_operand_class string_class;
extern const struct sieve_operand_class stringlist_class;

/* Operand objects */

extern const struct sieve_operand_def omitted_operand;
extern const struct sieve_operand_def number_operand;
extern const struct sieve_operand_def string_operand;
extern const struct sieve_operand_def stringlist_operand;
extern const struct sieve_operand_def catenated_string_operand;

extern const struct sieve_operand_def *sieve_operands[];
extern const unsigned int sieve_operand_count;

/* Operand object interfaces */

struct sieve_opr_number_interface {
	bool (*dump)(const struct sieve_dumptime_env *denv,
		     const struct sieve_operand *oprnd, sieve_size_t *address);
	int (*read)(const struct sieve_runtime_env *renv,
		    const struct sieve_operand *oprnd, sieve_size_t *address,
		    sieve_number_t *number_r);
};

struct sieve_opr_string_interface {
	bool (*dump)(const struct sieve_dumptime_env *denv,
		     const struct sieve_operand *oprnd, sieve_size_t *address);
	int (*read)(const struct sieve_runtime_env *renv,
		    const struct sieve_operand *oprnd, sieve_size_t *address,
		    string_t **str_r);
};

struct sieve_opr_stringlist_interface {
	bool (*dump)(const struct sieve_dumptime_env *denv,
		     const struct sieve_operand *oprnd, sieve_size_t *address);
	int (*read)(const struct sieve_runtime_env *renv,
		    const struct sieve_operand *oprnd, sieve_size_t *address,
		    struct sieve_stringlist **strlist_r);
};

/*
 * Core operand functions
 */

/* Omitted */

void sieve_opr_omitted_emit(struct sieve_binary_block *sblock);

static inline bool
sieve_operand_is_omitted(const struct sieve_operand *operand)
{
	return (operand != NULL && operand->def != NULL &&
		operand->def == &omitted_operand);
}

/* Number */

void sieve_opr_number_emit(struct sieve_binary_block *sblock,
			   sieve_number_t number);
bool sieve_opr_number_dump_data(const struct sieve_dumptime_env *denv,
				struct sieve_operand *operand,
				sieve_size_t *address, const char *field_name);
bool sieve_opr_number_dump(const struct sieve_dumptime_env *denv,
			   sieve_size_t *address, const char *field_name);
int sieve_opr_number_read_data(const struct sieve_runtime_env *renv,
			       struct sieve_operand *operand,
			       sieve_size_t *address, const char *field_name,
			       sieve_number_t *number_r);
int sieve_opr_number_read(const struct sieve_runtime_env *renv,
			  sieve_size_t *address, const char *field_name,
			  sieve_number_t *number_r);

static inline bool sieve_operand_is_number(const struct sieve_operand *operand)
{
	return (operand != NULL && operand->def != NULL &&
		operand->def->class == &number_class);
}

/* String */

void sieve_opr_string_emit(struct sieve_binary_block *sblock, string_t *str);
bool sieve_opr_string_dump_data(const struct sieve_dumptime_env *denv,
				struct sieve_operand *operand,
				sieve_size_t *address, const char *field_name);
bool sieve_opr_string_dump(const struct sieve_dumptime_env *denv,
			   sieve_size_t *address, const char *field_name);
bool sieve_opr_string_dump_ex(const struct sieve_dumptime_env *denv,
			      sieve_size_t *address, const char *field_name,
			      const char *omitted_value);
int sieve_opr_string_read_data(const struct sieve_runtime_env *renv,
			       struct sieve_operand *operand,
			       sieve_size_t *address, const char *field_name,
			       string_t **str_r);
int sieve_opr_string_read(const struct sieve_runtime_env *renv,
			  sieve_size_t *address, const char *field_name,
			  string_t **str_r);
int sieve_opr_string_read_ex(const struct sieve_runtime_env *renv,
			     sieve_size_t *address, const char *field_name,
			     bool optional, string_t **str_r, bool *literal_r);

static inline bool
sieve_operand_is_string(const struct sieve_operand *operand)
{
	return (operand != NULL && operand->def != NULL &&
		operand->def->class == &string_class);
}

static inline bool
sieve_operand_is_string_literal(const struct sieve_operand *operand)
{
	return (operand != NULL && sieve_operand_is(operand, string_operand));
}

/* String list */

void sieve_opr_stringlist_emit_start(struct sieve_binary_block *sblock,
				     unsigned int listlen, void **context);
void sieve_opr_stringlist_emit_item(struct sieve_binary_block *sblock,
				    void *context ATTR_UNUSED,
				    string_t *item);
void sieve_opr_stringlist_emit_end(struct sieve_binary_block *sblock,
				   void *context);

bool sieve_opr_stringlist_dump_data(const struct sieve_dumptime_env *denv,
				    struct sieve_operand *operand,
				    sieve_size_t *address,
				    const char *field_name);
bool sieve_opr_stringlist_dump(const struct sieve_dumptime_env *denv,
			       sieve_size_t *address, const char *field_name);
bool sieve_opr_stringlist_dump_ex(const struct sieve_dumptime_env *denv,
				  sieve_size_t *address,
				  const char *field_name,
				  const char *omitted_value);
int sieve_opr_stringlist_read_data(const struct sieve_runtime_env *renv,
				   struct sieve_operand *operand,
				   sieve_size_t *address,
				   const char *field_name,
				   struct sieve_stringlist **strlist_r);
int sieve_opr_stringlist_read(const struct sieve_runtime_env *renv,
			      sieve_size_t *address, const char *field_name,
			      struct sieve_stringlist **strlist_r);
int sieve_opr_stringlist_read_ex(const struct sieve_runtime_env *renv,
				 sieve_size_t *address, const char *field_name,
				 bool optional,
				 struct sieve_stringlist **strlist_r);

static inline bool
sieve_operand_is_stringlist(const struct sieve_operand *operand)
{
	return (operand != NULL && operand->def != NULL &&
		(operand->def->class == &stringlist_class ||
		 operand->def->class == &string_class));
}

/* Catenated string */

void sieve_opr_catenated_string_emit(struct sieve_binary_block *sblock,
				     unsigned int elements);

/*
 * Operation object
 */

struct sieve_operation_def {
	const char *mnemonic;

	const struct sieve_extension_def *ext_def;
	unsigned int code;

	bool (*dump)(const struct sieve_dumptime_env *denv,
		     sieve_size_t *address);
	int (*execute)(const struct sieve_runtime_env *renv,
		       sieve_size_t *address);
};

struct sieve_operation {
	const struct sieve_operation_def *def;
	const struct sieve_extension *ext;

	sieve_size_t address;
};

#define sieve_operation_is(oprtn, definition) \
	((oprtn)->def == &(definition))
#define sieve_operation_mnemonic(oprtn) \
	((oprtn)->def == NULL ? "(NULL)" : (oprtn)->def->mnemonic)

sieve_size_t sieve_operation_emit(struct sieve_binary_block *sblock,
				  const struct sieve_extension *ext,
				  const struct sieve_operation_def *op_def);
bool sieve_operation_read(struct sieve_binary_block *sblock,
			  sieve_size_t *address, struct sieve_operation *oprtn);
const char *
sieve_operation_read_string(struct sieve_binary_block *sblock,
			    sieve_size_t *address);

/*
 * Core operations
 */

/* Opcodes */

enum sieve_operation_code {
	SIEVE_OPERATION_INVALID,
	SIEVE_OPERATION_JMP,
	SIEVE_OPERATION_JMPTRUE,
	SIEVE_OPERATION_JMPFALSE,

	SIEVE_OPERATION_STOP,
	SIEVE_OPERATION_KEEP,
	SIEVE_OPERATION_DISCARD,
	SIEVE_OPERATION_REDIRECT,

	SIEVE_OPERATION_ADDRESS,
	SIEVE_OPERATION_HEADER,
	SIEVE_OPERATION_EXISTS,
	SIEVE_OPERATION_SIZE_OVER,
	SIEVE_OPERATION_SIZE_UNDER,

	SIEVE_OPERATION_CUSTOM
};

/* Operation objects */

extern const struct sieve_operation_def sieve_jmp_operation;
extern const struct sieve_operation_def sieve_jmptrue_operation;
extern const struct sieve_operation_def sieve_jmpfalse_operation;

extern const struct sieve_operation_def *sieve_operations[];
extern const unsigned int sieve_operations_count;

#endif