Name
|
| #include <accdb.h> struct accdb_module *accdb_load(char *module); void accdb_unload(struct accdb_module *mp); |
accdb_load() opens a back-end module (module.so and/or module.dll), acquires all necessary symbols and returns them in a malloc()ed struct accdb_module, which is then to be freed with accdb_unload(). In most cases, module will be just be an asterisk, which says to use the default ACCDB back-end, defined in ./vetc/libaccdb/accdb or /etc/libaccdb/accdb, variable DEFAULT_BACKEND.
On failure, accdb_load() returns NULL and sets errno to the ones set by system calls, plus EFAULT if no q_open() function in the ACCDB module could be found. ENOENT is returned if no default module was defined.
| struct accdb_module *res = accdb_load("*"); |
The back-end interface is discussed in its own chapter.
Configuration file parsing 
While developing the Vitalnix Suite, I came to a point where I realized I had common used code duplicated in nearly every file that used ACCDB in some way, so I decided to move that code part to ACCDB since it is a central place.
Configuration files are based on the key=value scheme, and lines beginning with a hash mark (#) are ignored, as are empty lines and unrecognized keys:
| # From vetc/autouid # Minimum / maximum values for automatic UID selection UID_MIN=100 UID_MAX=65000 # Minimum / maximum values for automatic GID selection GID_MIN=100 GID_MAX=65000 |
ACCDB provides two (one) function to deal with configuration files. The second is just for handling multiple configuration files at once.
| // From accdb.h struct rconfig_opt { const char *key; char type; void *ptr; int (*callback)(const char *, char, void *); }; enum { RCONFIG_ONE = 1 << 0, }; int accdb_rconfig(char *file, struct rconfig_opt *table); int accdb_rconfig_pv(const char **pv, char *file, struct rconfig_opt *table, unsigned long flags); |
accdb_rconfig() will return >0 to indicate success, or <0 (= errno) to signal an error. accdb_rconfig_pv() will return the number of files successfully parsed. Types for rconfig_opt.type can be:
| .type | typeof(.ptr) | Expected input |
| RCONF_BYTE | byte */unsigned char * | a single byte (any further bytes in the value are ignored) |
| RCONF_UCHAR | unsigned char * | a number (range 0 to 255) |
| RCONF_CHAR | char * | a number (range -128 to 127) |
| RCONF_USHORT | unsigned short * | a number (range 0 to 65535) |
| RCONF_SHORT | short * | a number (range -32768 to 32767) |
| RCONF_UINT | unsigned int * | a number (range dependent on size) |
| RCONF_INT | int * | a number |
| RCONF_ULONG | unsigned long * | a number (range 0 to 4294967295) |
| RCONF_LONG | long * | a number (range -2147483648 to 2147483647) |
| RCONF_FLOAT | float * | a floating point number |
| RCONF_DOUBLE | double * | a double precision floating point number |
| RCONF_BOOL | byte * | "yes", "no", or "1", "0" |
| RCONF_IBOOL | int * | "yes", "no", or "1", "0" |
| RCONF_STRING | char ** | any number of chars (string is automatically allocated) |
.callback is called when the corresponding option has been parsed and .callback is not NULL. Since the options can be arranged in any order in the configuration file, you should take care when assuming that other keys/ptrs have already been filled.
To start parsing a file, call the accdb_rconfig() function with the corresponding parameters. If you want to read configuration files from different paths, i.e. to build up on default values, you can use accdb_rconfig_pv() like the next code example. (pv = path vector)
|
struct rconfig_opt table[] = { {"UID_MIN", RCONF_LONG, &uid_min, NULL}, {"UID_MAX", RCONF_LONG, &uid_max, NULL}, {NULL}, }; const char *pv_a[] = {"/etc", "/usr/local/etc", NULL}, *pv_b[] = {".", "/etc", NULL}; // Will parse /etc/configfile accdb_rconfig("/etc/configfile", table); // Will parse /etc/configfile and /usr/local/etc/configfile accdb_rconfig_pv(pv_a, "configfile", table, 0); // Will only parse the first successful file accdb_rconfig_pv(pv_b, "configfile", table, RCONFIG_ONE); |
The call to accdb_rconfig() will either return 1 for success, 0 for no success (actually 0 is never returned) and -errno for an error. The next call, with pv_a will parse /etc/configfile, etc. (pv from left to right). No value is returned. The call with pv_b will only read the first successful opened file, i.e. if you have both ./configfile and /etc/configfile, only the former is read if it can be opened.
Password generation
Password generation is currently limited to create plain text passwords only, filling in the crypted field is currently not available.
| #include <accdb.h> int accdb_genpw(char *plain, char **crypted, size_t len, unsigned long meth, unsigned long flags); |
accdb_genpw() generates a random password. Depending on flags, it might even produce one to be easily memorized by humans, but still being pronounceable. The method and flags fields are:
| enum accdb_genpw_meth { PW_DES = 0, PW_MD5, PW_BLOWFISH, }; enum { PW_PHONEMIC = 1 << 0, PW_ONE_DIGIT = 1 << 1, PW_ONE_CASE = 1 << 2, }; |
| December 24 2003 | http://vitalnix.sf.net/ |