Zabbix

/*

** Copyright (C) 2001-2025 Zabbix SIA

**

** This program is free software: you can redistribute it and/or modify it under the terms of

** the GNU Affero General Public License as published by the Free Software Foundation, version 3.

**

** This program 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 Affero General Public License for more details.

**

** You should have received a copy of the GNU Affero General Public License along with this program.

** If not, see <https://www.gnu.org/licenses/>.

**/

​

#ifndef ZABBIX_MODULE_H

#define ZABBIX_MODULE_H

​

#include "zbxtypes.h"

​

#define ZBX_MODULE_OK   0

#define ZBX_MODULE_FAIL -1

​

/* zbx_module_api_version() MUST return this constant */

#define ZBX_MODULE_API_VERSION  2

​

/* old name alias is kept for source compatibility only, SHOULD NOT be used */

#define ZBX_MODULE_API_VERSION_ONE  ZBX_MODULE_API_VERSION

​

/* HINT: For conditional compilation with different module.h versions modules can use: */

/* #if ZBX_MODULE_API_VERSION == X                                                     */

/*         ...                                                                         */

/* #endif                                                                              */

​

#define get_rkey(request)       (request)->key

#define get_rparams_num(request)    (request)->nparam

#define get_rparam(request, num)    ((request)->nparam > num ? (request)->params[num] : NULL)

#define get_rparam_type(request, num)   ((request)->nparam > num ? (request)->types[num] : \

        REQUEST_PARAMETER_TYPE_UNDEFINED)

​

/* flags for command */

#define CF_HAVEPARAMS       0x01    /* item accepts either optional or mandatory parameters */

#define CF_MODULE       0x02    /* item is defined in a loadable module */

#define CF_USERPARAMETER    0x04    /* item is defined as user parameter */

​

typedef enum

{

    REQUEST_PARAMETER_TYPE_UNDEFINED = 0,

    REQUEST_PARAMETER_TYPE_STRING,

    REQUEST_PARAMETER_TYPE_ARRAY

}

zbx_request_parameter_type_t;

​

/* agent request structure */

typedef struct

{

    char                *key;

    int             nparam;

    char                **params;

    zbx_uint64_t            lastlogsize;

    int             mtime;

    zbx_request_parameter_type_t    *types;

    int             timeout;

}

AGENT_REQUEST;

​

typedef struct

{

    char        *value;

    char        *source;

    int     timestamp;

    int     severity;

    int     logeventid;

}

zbx_log_t;

​

/* agent result types */

#define AR_UINT64   0x01

#define AR_DOUBLE   0x02

#define AR_STRING   0x04

#define AR_TEXT     0x08

#define AR_LOG      0x10

#define AR_MESSAGE  0x20

#define AR_META     0x40

#define AR_BIN      0x80

​

/* Agent return structure.                                       */

/* Need to preserve the compatibility with previous versions,    */

/* so new fields must be added at the end of the struct.         */

typedef struct

{

    zbx_uint64_t    lastlogsize;    /* meta information */