Entry Point

Functions for initializing and launching a yuno application.

Source: kernel/c/root-linux/src/entry_point.h, kernel/c/root-linux/src/manage_services.h, kernel/c/root-linux/src/yunetas_register.h

yuneta_setup()¶

Configures the yuneta runtime: persistent-attribute handlers, command / stats parsers, authentication / authorization callbacks, and memory allocator settings. Call once, before yuneta_entry_point().

int yuneta_setup(
    const persistent_attrs_t    *persistent_attrs,
    json_function_fn            command_parser,
    json_function_fn            stats_parser,
    authorization_checker_fn    authz_checker,
    authentication_parser_fn    authentication_parser,
    size_t                      mem_max_block,
    size_t                      mem_max_system_memory,
    BOOL                        use_own_system_memory,
    size_t                      mem_min_block,
    size_t                      mem_superblock
);

Parameters

Returns

0 on success.

yuneta_entry_point()¶

Main entry point for a yuno application. Parses command-line arguments, loads configuration, sets up the environment, creates the yuno GObj tree, and runs the event loop.

int yuneta_entry_point(
    int argc, char *argv[],
    const char *APP_NAME,
    const char *APP_VERSION,
    const char *APP_SUPPORT,
    const char *APP_DOC,
    const char *APP_DATETIME,
    const char *fixed_config,
    const char *variable_config,
    int (*register_yuno_and_more)(void),
    void (*cleaning_fn)(void)
);

Parameters

Returns

Process exit code.

A gclass of the yuno that gclass_create() refuses stops the yuno before it is created: “register_yuno_and_more() FAILED: a gclass of the yuno was refused, the yuno exits”, an ERROR, and exit(-1) (7.27.0+). Up to 7.26.9 the answer was added to the exit code and the yuno RAN: its services failed later with “gclass NOT FOUND”. So register_yuno_and_more() hands back what the registrations answer:

static int register_yuno_and_more(void)
{
    int result = 0;
    result += register_c_my_service();  // 0, or -1: refused, its ERROR logged
    result += register_c_my_child();
    return result;                      // < 0: the yuno exits
}

Command-line options

Parsed here, so every yuno accepts them — the agent, the brokers, your own citizen yunos, the test binaries:

set_auto_kill_time()¶

For testing: kills the yuno after a specified number of seconds. Only effective when the yuno is not running as a daemon.

void set_auto_kill_time(int seconds);

Parameters

Returns

This function does not return a value.

yuneta_is_daemon()¶

TRUE when the process was launched with --start, that is, it runs as a daemon under the ydaemon watcher. FALSE for a plain foreground process: a CLI utility, a test, a yuno run by hand. The signal policy depends on it (see the SIGTERM case in c_yuno.c).

BOOL yuneta_is_daemon(void);

Returns

TRUE under the watcher, FALSE in the foreground.

Example

if(!yuneta_is_daemon()) {
    /* run by hand: print to the terminal as well */
    gobj_log_add_handler("stdout", "stdout", LOG_OPT_ALL, 0);
}

yuneta_json_config()¶

Returns the currently loaded JSON configuration object.

json_t *yuneta_json_config(void);

Parameters

Returns

Pointer to the configuration json_t object. The pointer is not owned by the caller — do not modify or free it.

run_services()¶

Starts and plays services and the yuno in priority order. Calls gobj_start() on the yuno, starts autostart services, calls gobj_play() on the yuno if autoplay is enabled, and plays autoplay services.

void run_services(void);

Parameters

Returns

This function does not return a value.

stop_services()¶

Pauses and stops services and the yuno in reverse priority order (priority 9 down to 0).

void stop_services(void);

Parameters

Returns

This function does not return a value.

yuno_shutdown()¶

Stops the yuno by marking it as shutting down and stopping the event loop.

void yuno_shutdown(void);

Parameters

Returns

This function does not return a value.

Notes

• Calls gobj_set_shutdown() followed by yev_loop_reset_running().

yunetas_register_c_core()¶

Registers all built-in runtime GClasses in one call. This is the centralized registration point invoked during yuno startup.

int yunetas_register_c_core(void);

Parameters

Returns

0 on success, -1 when a gclass was refused or when it is called a second time (an ERROR logged in both cases).

Notes

• Internally calls every register_c_*() function listed in GClass Registration.

• yuneta_entry_point() calls it once, before the yuno’s register_yuno_and_more(). A yuno never calls it: its register_yuno_and_more() registers its OWN gclasses only.

• A second call registers nothing and returns -1 with an ERROR that says why (“yunetas_register_c_core() called twice: ...”). Made from register_yuno_and_more(), that -1 stops the yuno before it runs, as a refused gclass does. Up to 7.26.9 the second call returned -1 with no log, and the only line was the entry point’s, naming no cause.

static int register_yuno_and_more(void)
{
    int result = 0;
    result += register_c_my_service();      // the yuno's own gclasses
    // yunetas_register_c_core();           // NO: the entry point already did
    return result;
}