58ea4eba27
1. Added #ifdef extern "C" to public header files. 2. Changed variables that are key words in c++, to different names (like ns instead of namespace). 3. Changed char* to const char* for constant strings.
318 lines
12 KiB
C
318 lines
12 KiB
C
/*
|
|
*
|
|
***** BEGIN LICENSE BLOCK *****
|
|
|
|
Copyright (C) 2009-2019 Olof Hagsand and Benny Holmgren
|
|
Copyright (C) 2020 Olof Hagsand and Rubicon Communications, LLC(Netgate)
|
|
|
|
This file is part of CLIXON.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
Alternatively, the contents of this file may be used under the terms of
|
|
the GNU General Public License Version 3 or later (the "GPL"),
|
|
in which case the provisions of the GPL are applicable instead
|
|
of those above. If you wish to allow use of your version of this file only
|
|
under the terms of the GPL, and not to allow others to
|
|
use your version of this file under the terms of Apache License version 2,
|
|
indicate your decision by deleting the provisions above and replace them with
|
|
the notice and other provisions required by the GPL. If you do not delete
|
|
the provisions above, a recipient may use your version of this file under
|
|
the terms of any one of the Apache License version 2 or the GPL.
|
|
|
|
***** END LICENSE BLOCK *****
|
|
*/
|
|
/*
|
|
* Internal prototypes, not accessed by plugin client code
|
|
*/
|
|
|
|
#ifndef _CLIXON_PLUGIN_H_
|
|
#define _CLIXON_PLUGIN_H_
|
|
|
|
/*
|
|
* Constants
|
|
*/
|
|
/* Hardcoded plugin symbol. Must exist in all plugins to kickstart
|
|
* @see clixon_plugin_init
|
|
*/
|
|
#define CLIXON_PLUGIN_INIT "clixon_plugin_init"
|
|
|
|
/*
|
|
* Types
|
|
*/
|
|
|
|
/*! Registered RPC callback function
|
|
* @param[in] h Clicon handle
|
|
* @param[in] xn Request: <rpc><xn></rpc>
|
|
* @param[out] cbret Return xml tree, eg <rpc-reply>..., <rpc-error..
|
|
* @param[in] arg Domain specific arg, ec client-entry or FCGX_Request
|
|
* @param[in] regarg User argument given at rpc_callback_register()
|
|
* @retval 0 OK
|
|
* @retval -1 Error
|
|
*/
|
|
typedef int (*clicon_rpc_cb)(
|
|
clicon_handle h,
|
|
cxobj *xn,
|
|
cbuf *cbret,
|
|
void *arg,
|
|
void *regarg
|
|
);
|
|
|
|
/*! Registered Upgrade callback function
|
|
* @param[in] h Clicon handle
|
|
* @param[in] xn XML tree to be updated
|
|
* @param[in] ns Namespace of module
|
|
* @param[in] op One of XML_FLAG_ADD, _DEL, _CHANGE
|
|
* @param[in] from From revision on the form YYYYMMDD (if DEL or CHANGE)
|
|
* @param[in] to To revision on the form YYYYMMDD (if ADD or CHANGE)
|
|
* @param[in] arg User argument given at rpc_callback_register()
|
|
* @param[out] cbret Return xml tree, eg <rpc-reply>..., <rpc-error.. (if retval = 0)
|
|
* @retval 1 OK
|
|
* @retval 0 Invalid
|
|
* @retval -1 Error
|
|
*/
|
|
typedef int (*clicon_upgrade_cb)(
|
|
clicon_handle h,
|
|
cxobj *xn,
|
|
char *ns,
|
|
uint16_t op,
|
|
uint32_t from,
|
|
uint32_t to,
|
|
void *arg,
|
|
cbuf *cbret
|
|
);
|
|
|
|
/*
|
|
* Prototypes
|
|
*/
|
|
/* Common plugin function names, function types and signatures.
|
|
* This plugin code is exytended by backend, cli, netconf, restconf plugins
|
|
* Cli see cli_plugin.c
|
|
* Backend see config_plugin.c
|
|
*/
|
|
|
|
/* Called when application is "started", (almost) all initialization is complete
|
|
* Backend: daemon is in the background. If daemon privileges are dropped
|
|
* this callback is called *before* privileges are dropped.
|
|
*/
|
|
typedef int (plgstart_t)(clicon_handle); /* Plugin start */
|
|
|
|
/* Called just after a server has "daemonized", ie put in background.
|
|
* Backend: If daemon privileges are dropped this callback is called *before* privileges are dropped.
|
|
* If daemon is started in foreground (-F) it is still called.
|
|
*/
|
|
typedef int (plgdaemon_t)(clicon_handle); /* Plugin daemonized */
|
|
|
|
/* Called just before plugin unloaded.
|
|
*/
|
|
typedef int (plgexit_t)(clicon_handle); /* Plugin exit */
|
|
|
|
/* For yang extension handling.
|
|
* Called at parsing of yang module containing a statement of an extension.
|
|
* A plugin may identify the extension by its name, and perform actions
|
|
* on the yang statement, such as transforming the yang.
|
|
* A callback is made for every statement, which means that several calls per
|
|
* extension can be made.
|
|
* @param[in] h Clixon handle
|
|
* @param[in] yext Yang node of extension
|
|
* @param[in] ys Yang node of (unknown) statement belonging to extension
|
|
* @retval 0 OK, all callbacks executed OK
|
|
* @retval -1 Error in one callback
|
|
*/
|
|
typedef int (plgextension_t)(clicon_handle h, yang_stmt *yext, yang_stmt *ys);
|
|
|
|
/*! Called by restconf to check credentials and return username
|
|
*/
|
|
|
|
/* Plugin authorization. Set username option (or not)
|
|
* @param[in] Clicon handle
|
|
* @param[in] void*, eg Fastcgihandle request restconf
|
|
* @retval -1 Fatal error
|
|
* @retval 0 Credential not OK
|
|
* @retval 1 Credential OK
|
|
*/
|
|
typedef int (plgauth_t)(clicon_handle, void *);
|
|
|
|
typedef int (plgreset_t)(clicon_handle h, const char *db); /* Reset system status */
|
|
|
|
/* Plugin statedata
|
|
* @param[in] Clicon handle
|
|
* @param[in] xpath Part of state requested
|
|
* @param[in] nsc XPATH namespace context.
|
|
* @param[in] xtop XML tree where statedata is added
|
|
* @retval -1 Fatal error
|
|
* @retval 0 OK
|
|
*/
|
|
typedef int (plgstatedata_t)(clicon_handle h, cvec *nsc, char *xpath, cxobj *xtop);
|
|
|
|
typedef void *transaction_data;
|
|
|
|
/* Transaction callback */
|
|
typedef int (trans_cb_t)(clicon_handle h, transaction_data td);
|
|
|
|
/*! Hook to override default prompt with explicit function
|
|
* Format prompt before each getline
|
|
* @param[in] h Clicon handle
|
|
* @param[in] mode Cligen syntax mode
|
|
* @retval prompt Prompt to prepend all CLigen command lines
|
|
*/
|
|
typedef char *(cli_prompthook_t)(clicon_handle, char *mode);
|
|
|
|
/*! General-purpose datastore upgrade callback called once on startupo
|
|
*
|
|
* Gets called on startup after initial XML parsing, but before module-specific upgrades
|
|
* and before validation.
|
|
* @param[in] h Clicon handle
|
|
* @param[in] db Name of datastore, eg "running", "startup" or "tmp"
|
|
* @param[in] xt XML tree. Upgrade this "in place"
|
|
* @param[in] msd Info on datastore module-state, if any
|
|
* @retval -1 Error
|
|
* @retval 0 OK
|
|
*/
|
|
typedef int (datastore_upgrade_t)(clicon_handle h, char *db, cxobj *xt, modstate_diff_t *msd);
|
|
|
|
/*! Startup status for use in startup-callback
|
|
* Note that for STARTUP_ERR and _INVALID, running runs in failsafe mode
|
|
* and startup contains the erroneous or invalid database.
|
|
* The user should repair the startup and
|
|
* (1) restart the backend
|
|
* (2) copy startup to candidate and commit.
|
|
*/
|
|
enum startup_status{
|
|
STARTUP_ERR, /* XML/JSON syntax error */
|
|
STARTUP_INVALID, /* XML/JSON OK, but (yang) validation fails */
|
|
STARTUP_OK /* Everything OK (may still be modules-mismatch) */
|
|
};
|
|
|
|
/* plugin init struct for the api
|
|
* Note: Implicit init function
|
|
*/
|
|
struct clixon_plugin_api;
|
|
typedef struct clixon_plugin_api* (plginit2_t)(clicon_handle); /* Clixon plugin Init */
|
|
|
|
struct clixon_plugin_api{
|
|
/*--- Common fields. ---*/
|
|
char ca_name[MAXPATHLEN]; /* Name of plugin (given by plugin) */
|
|
plginit2_t *ca_init; /* Clixon plugin Init (implicit) */
|
|
plgstart_t *ca_start; /* Plugin start */
|
|
plgexit_t *ca_exit; /* Plugin exit */
|
|
plgextension_t *ca_extension; /* Yang extension handler */
|
|
union {
|
|
struct { /* cli-specific */
|
|
cli_prompthook_t *ci_prompt; /* Prompt hook */
|
|
cligen_susp_cb_t *ci_suspend; /* Ctrl-Z hook, see cligen getline */
|
|
cligen_interrupt_cb_t *ci_interrupt; /* Ctrl-C, see cligen getline */
|
|
} cau_cli;
|
|
struct { /* restconf-specific */
|
|
plgauth_t *cr_auth; /* Auth credentials */
|
|
} cau_restconf;
|
|
struct { /* netconf-specific */
|
|
} cau_netconf;
|
|
struct { /* backend-specific */
|
|
plgdaemon_t *cb_daemon; /* Plugin daemonized */
|
|
plgreset_t *cb_reset; /* Reset system status */
|
|
plgstatedata_t *cb_statedata; /* Get state data from plugin (backend only) */
|
|
trans_cb_t *cb_trans_begin; /* Transaction start */
|
|
trans_cb_t *cb_trans_validate; /* Transaction validation */
|
|
trans_cb_t *cb_trans_complete; /* Transaction validation complete */
|
|
trans_cb_t *cb_trans_commit; /* Transaction commit */
|
|
trans_cb_t *cb_trans_commit_done; /* Transaction when commit done */
|
|
trans_cb_t *cb_trans_revert; /* Transaction revert */
|
|
trans_cb_t *cb_trans_end; /* Transaction completed */
|
|
trans_cb_t *cb_trans_abort; /* Transaction aborted */
|
|
datastore_upgrade_t *cb_datastore_upgrade; /* General-purpose datastore upgrade */
|
|
} cau_backend;
|
|
} u;
|
|
};
|
|
/* Access fields */
|
|
#define ca_prompt u.cau_cli.ci_prompt
|
|
#define ca_suspend u.cau_cli.ci_suspend
|
|
#define ca_interrupt u.cau_cli.ci_interrupt
|
|
#define ca_auth u.cau_restconf.cr_auth
|
|
#define ca_daemon u.cau_backend.cb_daemon
|
|
#define ca_reset u.cau_backend.cb_reset
|
|
#define ca_statedata u.cau_backend.cb_statedata
|
|
#define ca_trans_begin u.cau_backend.cb_trans_begin
|
|
#define ca_trans_validate u.cau_backend.cb_trans_validate
|
|
#define ca_trans_complete u.cau_backend.cb_trans_complete
|
|
#define ca_trans_commit u.cau_backend.cb_trans_commit
|
|
#define ca_trans_commit_done u.cau_backend.cb_trans_commit_done
|
|
#define ca_trans_revert u.cau_backend.cb_trans_revert
|
|
#define ca_trans_end u.cau_backend.cb_trans_end
|
|
#define ca_trans_abort u.cau_backend.cb_trans_abort
|
|
#define ca_datastore_upgrade u.cau_backend.cb_datastore_upgrade
|
|
|
|
/*
|
|
* Macros
|
|
*/
|
|
#define upgrade_callback_register(h, cb, ns, arg) upgrade_callback_reg_fn((h), (cb), #cb, (ns), (arg))
|
|
|
|
typedef struct clixon_plugin_api clixon_plugin_api;
|
|
|
|
/* Internal plugin structure with dlopen() handle and plugin_api
|
|
*/
|
|
struct clixon_plugin{
|
|
char cp_name[MAXPATHLEN]; /* Plugin filename. Note api ca_name is given by plugin itself */
|
|
plghndl_t cp_handle; /* Handle to plugin using dlopen(3) */
|
|
clixon_plugin_api cp_api;
|
|
};
|
|
typedef struct clixon_plugin clixon_plugin;
|
|
|
|
/*
|
|
* Prototypes
|
|
*/
|
|
|
|
/*! Plugin initialization function. Must appear in all plugins, not a clixon system function
|
|
* @param[in] h Clixon handle
|
|
* @retval api Pointer to API struct
|
|
* @retval NULL Failure (if clixon_err() called), module disabled otherwise.
|
|
* @see CLIXON_PLUGIN_INIT default symbol
|
|
*/
|
|
clixon_plugin_api *clixon_plugin_init(clicon_handle h);
|
|
|
|
clixon_plugin *clixon_plugin_each(clicon_handle h, clixon_plugin *cpprev);
|
|
|
|
clixon_plugin *clixon_plugin_each_revert(clicon_handle h, clixon_plugin *cpprev, int nr);
|
|
|
|
clixon_plugin *clixon_plugin_find(clicon_handle h, char *name);
|
|
|
|
int clixon_plugins_load(clicon_handle h, char *function, char *dir, char *regexp);
|
|
|
|
int clixon_pseudo_plugin(clicon_handle h, char *name, clixon_plugin **cpp);
|
|
|
|
int clixon_plugin_start_one(clixon_plugin *cp, clicon_handle h);
|
|
int clixon_plugin_start_all(clicon_handle h);
|
|
|
|
int clixon_plugin_exit_one(clixon_plugin *cp, clicon_handle h);
|
|
int clixon_plugin_exit_all(clicon_handle h);
|
|
|
|
int clixon_plugin_auth_one(clixon_plugin *cp, clicon_handle h, void *arg);
|
|
int clixon_plugin_auth_all(clicon_handle h, void *arg);
|
|
|
|
int clixon_plugin_extension_one(clixon_plugin *cp, clicon_handle h, yang_stmt *yext, yang_stmt *ys);
|
|
int clixon_plugin_extension_all(clicon_handle h, yang_stmt *yext, yang_stmt *ys);
|
|
|
|
int clixon_plugin_datastore_upgrade_one(clixon_plugin *cp, clicon_handle h, char *db, cxobj *xt, modstate_diff_t *msd);
|
|
int clixon_plugin_datastore_upgrade_all(clicon_handle h, char *db, cxobj *xt, modstate_diff_t *msd);
|
|
|
|
/* rpc callback API */
|
|
int rpc_callback_register(clicon_handle h, clicon_rpc_cb cb, void *arg, char *ns, char *name);
|
|
int rpc_callback_delete_all(clicon_handle h);
|
|
int rpc_callback_call(clicon_handle h, cxobj *xe, cbuf *cbret, void *arg);
|
|
|
|
/* upgrade callback API */
|
|
int upgrade_callback_reg_fn(clicon_handle h, clicon_upgrade_cb cb, const char *strfn, char *ns, void *arg);
|
|
int upgrade_callback_delete_all(clicon_handle h);
|
|
int upgrade_callback_call(clicon_handle h, cxobj *xt, char *ns, uint16_t op, uint32_t from, uint32_t to, cbuf *cbret);
|
|
|
|
#endif /* _CLIXON_PLUGIN_H_ */
|