X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=src%2Fconfigfile.h;h=8a34e7e96f31f6b3358a5ab5b0ae1584b033cf7e;hb=ed3b4a8fe6377817e1dadfbc713c4cc5c0bc4444;hp=0802ba5ad60070e2081bf619f65763f91d4ce6b0;hpb=c1e47ad7b5e5e889fb86250f714b299e4bf8819f;p=collectd.git diff --git a/src/configfile.h b/src/configfile.h index 0802ba5a..8a34e7e9 100644 --- a/src/configfile.h +++ b/src/configfile.h @@ -37,7 +37,7 @@ void cf_unregister (char *type); * DESCRIPTION * `cf_register' is called by plugins that wish to receive config keys. The * plugin will then receive all keys it registered for if they're found in a - * `' section. + * `' section. * * PARAMETERS * `type' Name of the plugin (must be the same as passed to @@ -61,12 +61,32 @@ void cf_register (char *type, int (*callback) (char *, char *), char **keys, int keys_num); +/* + * DESCRIPTION + * `cf_get_option' returns various general options. + * + * PARAMETERS + * `key' Name of the option to query. + * `def' Pointer to return as default value. + * + * RETURN VALUE + * The pointer returned is part of an internal structure and may not be + * changed. If the option is not found for whatever reason (wrong key, option + * not allowed for currently selected mode, ...) `NULL' is returned. + */ +char *cf_get_option (const char *key, char *def); + /* * DESCRIPTION * `cf_read' reads the config file `filename' and dispatches the read * information to functions/variables. Most important: Is calls `plugin_load' * to load specific plugins, depending on the current mode of operation. * + * PARAMETERS + * `filename' An additional filename to look for. This function calls + * `lc_process' which already searches many standard locations.. + * If set to NULL will use the `CONFIGFILE' define. + * * RETURN VALUE * Returns zero upon success and non-zero otherwise. A error-message will have * been printed in this case.