Skip to content

Commit

Permalink
lib: add flag to have libyang load internal ietf-yang-library module
Browse files Browse the repository at this point in the history
Mgmtd makes use of libyang's internal ietf-yang-library module to add
support for said module to FRR management. Previously, mgmtd was loading
this module explicitly; however, that required that libyang's
`ietf-yang-library.yang` module definition file be co-located with FRR's
yang files so that it (and ietf-datastore.yang) would be found when
searched for by libyang using FRRs search path. This isn't always the
case depending on how the user compiles and installs libyang so mgmtd
was failing to run in some cases.

Instead of doing it the above way we simply tell libyang to load it's
internal version of ietf-yang-library when we initialize the libyang
context.

This required adding a boolean to a couple of the init functions which
is why so many files are touched (although all the changes are minimal).

Signed-off-by: Christian Hopps <[email protected]>
  • Loading branch information
choppsv1 committed Oct 7, 2024
1 parent 28a614d commit e8648a0
Show file tree
Hide file tree
Showing 19 changed files with 40 additions and 30 deletions.
2 changes: 1 addition & 1 deletion lib/grammar_sandbox_main.c
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ int main(int argc, char **argv)

vty_init(master, true);
lib_cmd_init();
nb_init(master, NULL, 0, false);
nb_init(master, NULL, 0, false, false);

vty_stdio(vty_do_exit);

Expand Down
3 changes: 2 additions & 1 deletion lib/libfrr.c
Original file line number Diff line number Diff line change
Expand Up @@ -820,7 +820,8 @@ struct event_loop *frr_init(void)
log_ref_vty_init();
lib_error_init();

nb_init(master, di->yang_modules, di->n_yang_modules, true);
nb_init(master, di->yang_modules, di->n_yang_modules, true,
(di->flags & FRR_LOAD_YANG_LIBRARY) != 0);
if (nb_db_init() != NB_OK)
flog_warn(EC_LIB_NB_DATABASE,
"%s: failed to initialize northbound database",
Expand Down
5 changes: 5 additions & 0 deletions lib/libfrr.h
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,11 @@ extern "C" {
* is responsible for calling frr_vty_serv() itself.
*/
#define FRR_MANUAL_VTY_START (1 << 7)
/* If FRR_LOAD_YANG_LIBRARY is set then libyang will be told to load and
* implement it's internal ietf-yang-library implementation. This should
* normally only be done from mgmtd.
*/
#define FRR_LOAD_YANG_LIBRARY (1 << 8)

PREDECL_DLIST(log_args);
struct log_arg {
Expand Down
4 changes: 2 additions & 2 deletions lib/northbound.c
Original file line number Diff line number Diff line change
Expand Up @@ -2701,7 +2701,7 @@ void nb_validate_callbacks(void)

void nb_init(struct event_loop *tm,
const struct frr_yang_module_info *const modules[],
size_t nmodules, bool db_enabled)
size_t nmodules, bool db_enabled, bool load_library)
{
struct yang_module *loaded[nmodules], **loadedp = loaded;

Expand All @@ -2717,7 +2717,7 @@ void nb_init(struct event_loop *tm,

nb_db_enabled = db_enabled;

yang_init(true, explicit_compile);
yang_init(true, explicit_compile, load_library);

/* Load YANG modules and their corresponding northbound callbacks. */
for (size_t i = 0; i < nmodules; i++) {
Expand Down
8 changes: 5 additions & 3 deletions lib/northbound.h
Original file line number Diff line number Diff line change
Expand Up @@ -1703,10 +1703,12 @@ void nb_validate_callbacks(void);
*
* db_enabled
* Set this to record the transactions in the transaction log.
*
* load_library
* Set this to have libyang to load/implement the ietf-yang-library.
*/
extern void nb_init(struct event_loop *tm,
const struct frr_yang_module_info *const modules[],
size_t nmodules, bool db_enabled);
extern void nb_init(struct event_loop *tm, const struct frr_yang_module_info *const modules[],
size_t nmodules, bool db_enabled, bool load_library);

/*
* Finish the northbound layer gracefully. Should be called only when the daemon
Expand Down
10 changes: 6 additions & 4 deletions lib/yang.c
Original file line number Diff line number Diff line change
Expand Up @@ -976,7 +976,7 @@ void yang_debugging_set(bool enable)
}
}

struct ly_ctx *yang_ctx_new_setup(bool embedded_modules, bool explicit_compile)
struct ly_ctx *yang_ctx_new_setup(bool embedded_modules, bool explicit_compile, bool load_library)
{
struct ly_ctx *ctx = NULL;
const char *yang_models_path = YANG_MODELS_PATH;
Expand All @@ -994,7 +994,9 @@ struct ly_ctx *yang_ctx_new_setup(bool embedded_modules, bool explicit_compile)
YANG_MODELS_PATH);
}

options = LY_CTX_NO_YANGLIBRARY | LY_CTX_DISABLE_SEARCHDIR_CWD;
options = LY_CTX_DISABLE_SEARCHDIR_CWD;
if (!load_library)
options |= LY_CTX_NO_YANGLIBRARY;
if (explicit_compile)
options |= LY_CTX_EXPLICIT_COMPILE;
err = ly_ctx_new(yang_models_path, options, &ctx);
Expand All @@ -1007,7 +1009,7 @@ struct ly_ctx *yang_ctx_new_setup(bool embedded_modules, bool explicit_compile)
return ctx;
}

void yang_init(bool embedded_modules, bool defer_compile)
void yang_init(bool embedded_modules, bool defer_compile, bool load_library)
{
/* Initialize libyang global parameters that affect all containers. */
ly_set_log_clb(ly_zlog_cb
Expand All @@ -1019,7 +1021,7 @@ void yang_init(bool embedded_modules, bool defer_compile)
ly_log_options(LY_LOLOG | LY_LOSTORE);

/* Initialize libyang container for native models. */
ly_native_ctx = yang_ctx_new_setup(embedded_modules, defer_compile);
ly_native_ctx = yang_ctx_new_setup(embedded_modules, defer_compile, load_library);
if (!ly_native_ctx) {
flog_err(EC_LIB_LIBYANG, "%s: ly_ctx_new() failed", __func__);
exit(1);
Expand Down
10 changes: 7 additions & 3 deletions lib/yang.h
Original file line number Diff line number Diff line change
Expand Up @@ -607,9 +607,11 @@ extern struct yang_data *yang_data_list_find(const struct list *list,
* explicit_compile
* True if the caller will later call ly_ctx_compile to compile all loaded
* modules at once.
* load_library
* Set this to have libyang to load/implement the ietf-yang-library.
*/
extern struct ly_ctx *yang_ctx_new_setup(bool embedded_modules,
bool explicit_compile);
extern struct ly_ctx *yang_ctx_new_setup(bool embedded_modules, bool explicit_compile,
bool load_library);

/*
* Enable or disable libyang verbose debugging.
Expand Down Expand Up @@ -727,8 +729,10 @@ extern const char *yang_print_errors(struct ly_ctx *ly_ctx, char *buf,
* Specify whether libyang should attempt to look for embedded YANG modules.
* defer_compile
* Hold off on compiling modules until yang_init_loading_complete is called.
* load_library
* Set this to have libyang to load/implement the ietf-yang-library.
*/
extern void yang_init(bool embedded_modules, bool defer_compile);
extern void yang_init(bool embedded_modules, bool defer_compile, bool load_library);

/*
* Should be called after yang_init and all yang_module_load()s have been done,
Expand Down
4 changes: 2 additions & 2 deletions lib/yang_translator.c
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ struct yang_translator *yang_translator_load(const char *path)
RB_INSERT(yang_translators, &yang_translators, translator);

/* Initialize the translator libyang context. */
translator->ly_ctx = yang_ctx_new_setup(false, false);
translator->ly_ctx = yang_ctx_new_setup(false, false, false);
if (!translator->ly_ctx) {
flog_warn(EC_LIB_LIBYANG, "%s: ly_ctx_new() failed", __func__);
goto error;
Expand Down Expand Up @@ -512,7 +512,7 @@ static unsigned int yang_module_nodes_count(const struct lys_module *module)

void yang_translator_init(void)
{
ly_translator_ctx = yang_ctx_new_setup(true, false);
ly_translator_ctx = yang_ctx_new_setup(true, false, false);
if (!ly_translator_ctx) {
flog_err(EC_LIB_LIBYANG, "%s: ly_ctx_new() failed", __func__);
exit(1);
Expand Down
3 changes: 0 additions & 3 deletions mgmtd/mgmt.c
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,6 @@ void mgmt_init(void)
/* Initialize MGMTD Transaction module */
mgmt_txn_init(mm, mm->master);

/* Add yang-library module */
yang_module_load("ietf-yang-library", NULL);

/* Initialize the MGMTD Frontend Adapter Module */
mgmt_fe_adapter_init(mm->master);

Expand Down
2 changes: 1 addition & 1 deletion mgmtd/mgmt_main.c
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@ FRR_DAEMON_INFO(mgmtd, MGMTD,
.n_yang_modules = array_size(mgmt_yang_modules),

/* avoid libfrr trying to read our config file for us */
.flags = FRR_MANUAL_VTY_START | FRR_NO_SPLIT_CONFIG,
.flags = FRR_MANUAL_VTY_START | FRR_NO_SPLIT_CONFIG | FRR_LOAD_YANG_LIBRARY,
);
/* clang-format on */

Expand Down
2 changes: 1 addition & 1 deletion tests/bgpd/test_peer_attr.c
Original file line number Diff line number Diff line change
Expand Up @@ -1355,7 +1355,7 @@ static void bgp_startup(void)
zprivs_init(&bgpd_privs);

master = event_master_create(NULL);
nb_init(master, NULL, 0, false);
nb_init(master, NULL, 0, false, false);
bgp_master_init(master, BGP_SOCKET_SNDBUF_SIZE, list_new());
bgp_option_set(BGP_OPT_NO_LISTEN);
vrf_init(NULL, NULL, NULL, NULL);
Expand Down
2 changes: 1 addition & 1 deletion tests/helpers/c/main.c
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ int main(int argc, char **argv)
vty_init(master, false);
lib_cmd_init();
debug_init();
nb_init(master, NULL, 0, false);
nb_init(master, NULL, 0, false, false);

/* OSPF vty inits. */
test_vty_init();
Expand Down
2 changes: 1 addition & 1 deletion tests/isisd/test_isis_spf.c
Original file line number Diff line number Diff line change
Expand Up @@ -546,7 +546,7 @@ int main(int argc, char **argv)
cmd_init(1);
cmd_hostname_set("test");
vty_init(master, false);
yang_init(true, false);
yang_init(true, false, false);
if (debug)
zlog_aux_init("NONE: ", LOG_DEBUG);
else
Expand Down
2 changes: 1 addition & 1 deletion tests/lib/cli/common_cli.c
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ int main(int argc, char **argv)
for (yangcount = 0; test_yang_modules && test_yang_modules[yangcount];
yangcount++)
;
nb_init(master, test_yang_modules, yangcount, false);
nb_init(master, test_yang_modules, yangcount, false, false);

test_init(argc, argv);

Expand Down
2 changes: 1 addition & 1 deletion tests/lib/cli/test_commands.c
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,7 @@ static void test_init(void)

cmd_init(1);
debug_init();
nb_init(master, NULL, 0, false);
nb_init(master, NULL, 0, false, false);

install_node(&bgp_node);
install_node(&rip_node);
Expand Down
2 changes: 1 addition & 1 deletion tests/lib/northbound/test_oper_data.c
Original file line number Diff line number Diff line change
Expand Up @@ -461,7 +461,7 @@ int main(int argc, char **argv)
vty_init(master, false);
lib_cmd_init();
debug_init();
nb_init(master, modules, array_size(modules), false);
nb_init(master, modules, array_size(modules), false, false);

install_element(ENABLE_NODE, &test_rpc_cmd);

Expand Down
3 changes: 1 addition & 2 deletions tests/lib/test_grpc.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -111,8 +111,7 @@ static void static_startup(void)
static_debug_init();

master = event_master_create(NULL);
nb_init(master, staticd_yang_modules, array_size(staticd_yang_modules),
false);
nb_init(master, staticd_yang_modules, array_size(staticd_yang_modules), false, false);

static_zebra_init();
vty_init(master, true);
Expand Down
2 changes: 1 addition & 1 deletion tools/gen_northbound_callbacks.c
Original file line number Diff line number Diff line change
Expand Up @@ -448,7 +448,7 @@ int main(int argc, char *argv[])
if (argc != 1)
usage(EXIT_FAILURE);

yang_init(false, true);
yang_init(false, true, false);

if (search_path)
ly_ctx_set_searchdir(ly_native_ctx, search_path);
Expand Down
2 changes: 1 addition & 1 deletion tools/gen_yang_deviations.c
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ int main(int argc, char *argv[])
if (argc != 1)
usage(EXIT_FAILURE);

yang_init(false, false);
yang_init(false, false, false);

/* Load YANG module. */
module = yang_module_load(argv[0], NULL);
Expand Down

0 comments on commit e8648a0

Please sign in to comment.