Glossary

bool¶

BOOL

#ifndef BOOL
# define BOOL   bool
#endif

false¶

FALSE

#ifndef FALSE
# define FALSE  false
#endif

true¶

TRUE

#ifndef TRUE
# define TRUE   true
#endif

private¶

PRIVATE — Defines a static function or variable with file scope.

#define PRIVATE static

public¶

PUBLIC — Defines a function or variable with external linkage.

#define PUBLIC

min¶

MIN — Returns the smaller of a and b.

#ifndef MIN
# define MIN(a,b) (((a) < (b)) ? (a) : (b))
#endif

max¶

MAX — Returns the larger of a and b.

#ifndef MAX
# define MAX(a,b) (((a) > (b)) ? (a) : (b))
#endif

array_size¶

ARRAY_SIZE — Returns the number of elements in array a.

#ifndef ARRAY_SIZE
#define ARRAY_SIZE(a) (sizeof(a)/sizeof((a)[0]))
#endif

gobj_define_gclass¶

GOBJ_DEFINE_GCLASS — Define a variable in the .c file.

#define GOBJ_DEFINE_GCLASS(id) gclass_name_t id = #id

gobj_declare_gclass¶

GOBJ_DECLARE_GCLASS — Declare a variable in the .h file.

#define GOBJ_DECLARE_GCLASS(id) extern gclass_name_t id

json_t¶

The json_t type is part of the Jansson library, used for representing JSON data in C. It provides a flexible way to work with JSON objects, arrays, and primitives such as strings and numbers.

json_function_fn¶

The json_function_fn is a function pointer type used for processing JSON objects in global command or stats parsers. It takes in JSON data and optional parameters to perform custom parsing or processing tasks.

typedef json_t *(*json_function_fn)(
    void *param1,
    const char *something,
    json_t *kw, // Owned
    void *param2
);

Parameters

• param1: A generic parameter for user-defined data.

• something: A string input for specific parsing.

• kw: A JSON object (owned by the function).

• param2: Another generic parameter for user-defined data.

Return Value

• Returns a json_t object as the result of the processing.

check_log_result¶

Internal function.

data_type_t¶

Internal type.

_rotatory¶

Internal data.

_duplicate_array¶

Internal function.

_log_jnbf¶

Internal function.

_build_stats¶

Internal function.

match_record¶

Internal function.

_duplicate_object¶

Internal function.

gobj_lmethod_t¶

Unique pointer that exposes local methods names, defined as:

In C:

typedef const char *gobj_lmethod_t;

hgclass¶

Handler of a gclass, defined as:

In C:

typedef void *hgclass;

hgobj¶

Handler of a gobj, defined as:

In C:

typedef void *hgobj;

ev_action_t¶

In C:

typedef struct {
    gobj_event_t event;
    gobj_action_fn action;
    gobj_state_t next_state;
} ev_action_t;

gobj_action_fn¶

In C:

typedef int (*gobj_action_fn)(
    hgobj gobj,
    gobj_event_t event,
    json_t *kw,
    hgobj src
);

authorization_checker_fn¶

The authorization_checker_fn is a function pointer type used for checking authorization rules. It evaluates whether a given operation is authorized based on the provided parameters.

typedef BOOL (*authorization_checker_fn)(
    hgobj gobj,
    const char *authz,
    json_t *kw,
    hgobj src
);

Parameters

• gobj: The GObj that is being authorized.

• authz: The authorization string to evaluate.

• kw: A JSON object containing additional parameters for the check.

• src: The source GObj requesting the authorization.

Return Value

• Returns TRUE if the operation is authorized, otherwise FALSE.

authentication_parser_fn¶

The authentication_parser_fn is a function pointer type used for parsing and handling authentication requests. It validates user credentials and provides a response in JSON format.

typedef json_t *(*authentication_parser_fn)(
    hgobj gobj,
    json_t *kw,
    hgobj src
);

Parameters

• gobj: The GObj handling the authentication.

• kw: A JSON object containing the authentication data.

• src: The source GObj making the authentication request.

Return Value

• Returns a JSON object with the authentication result, typically including a success status and user details.

re-launch¶

In Yuneta, all yunos inherently support running as daemons. When operating in daemon mode, they are protected against unexpected termination through an internal mechanism:

1. Watcher-Worker Mechanism

• In the ps output, you will see two PIDs associated with a yuno:

  • Watcher: This process monitors the main yuno process.

  • Worker: The actual yuno performing the primary tasks.

2. Re-launch Behavior

• If the worker process dies unexpectedly, the watcher process automatically re-launches it to ensure high availability.

• This mechanism guarantees resilience, except when the yuno exits explicitly with exit(0).

3. No External Dependencies

• You don’t need systemd! Yuneta’s internal re-launch mechanism eliminates the need for external service managers, as the watcher process fully handles restarts.

4. Purpose

• The re-launch feature enhances reliability, ensuring that the yuno remains operational even in the event of failures or crashes.

Yunos running as daemons are highly robust, self-healing, and independent of external service management systems.

istream_h¶

typedef void *istream_h;