/** * @file multidepend.c * @author Ambroz Bizjak * * @section LICENSE * * This file is part of BadVPN. * * BadVPN is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License version 2 * as published by the Free Software Foundation. * * BadVPN is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. * * @section DESCRIPTION * * Multiple-option dependencies module. * * Synopsis: multiprovide(string name) * Arguments: * name - provider identifier * * Synopsis: multidepend(list(string) names) * Arguments: * names - list of provider identifiers. The dependency is satisfied by any * provide statement with a provider identifier contained in this list. * The order of provider identifiers in the list specifies priority * (higher priority first). * Variables: Provides variables available from the corresponding provide, * ("modname.varname" or "modname"). */ #include #include #include #include #include #include #include #define ModuleLog(i, ...) NCDModuleInst_Backend_Log((i), BLOG_CURRENT_CHANNEL, __VA_ARGS__) struct provide { NCDModuleInst *i; char *name; LinkedList2Node provides_node; LinkedList2 depends; int dying; }; struct depend { NCDModuleInst *i; NCDValue *names; LinkedList2Node depends_node; struct provide *provide; LinkedList2Node provide_node; int provide_collapsing; }; static LinkedList2 provides; static LinkedList2 depends; static struct provide * find_provide (const char *name) { LinkedList2Iterator it; LinkedList2Iterator_InitForward(&it, &provides); LinkedList2Node *n; while (n = LinkedList2Iterator_Next(&it)) { struct provide *p = UPPER_OBJECT(n, struct provide, provides_node); if (!strcmp(p->name, name)) { LinkedList2Iterator_Free(&it); return p; } } return NULL; } static struct provide * depend_find_best_provide (struct depend *o) { NCDValue *e = NCDValue_ListFirst(o->names); while (e) { struct provide *p = find_provide(NCDValue_StringValue(e)); if (p && !p->dying) { return p; } e = NCDValue_ListNext(o->names, e); } return NULL; } static void depend_update (struct depend *o) { // if we're collapsing, do nothing if (o->provide && o->provide_collapsing) { return; } // find best provide struct provide *bp = depend_find_best_provide(o); ASSERT(!bp || !bp->dying) // has anything changed? if (bp == o->provide) { return; } if (o->provide) { // set collapsing o->provide_collapsing = 1; // signal down NCDModuleInst_Backend_Down(o->i); } else { // insert to provide's list LinkedList2_Append(&bp->depends, &o->provide_node); // set not collapsing o->provide_collapsing = 0; // set provide o->provide = bp; // signal up NCDModuleInst_Backend_Up(o->i); } } static int func_globalinit (struct NCDModuleInitParams params) { // init provides list LinkedList2_Init(&provides); // init depends list LinkedList2_Init(&depends); return 1; } static void provide_func_new (NCDModuleInst *i) { // allocate instance struct provide *o = malloc(sizeof(*o)); if (!o) { ModuleLog(i, BLOG_ERROR, "failed to allocate instance"); goto fail0; } NCDModuleInst_Backend_SetUser(i, o); // init arguments o->i = i; // read arguments NCDValue *name_arg; if (!NCDValue_ListRead(o->i->args, 1, &name_arg)) { ModuleLog(i, BLOG_ERROR, "wrong arity"); goto fail1; } if (NCDValue_Type(name_arg) != NCDVALUE_STRING) { ModuleLog(o->i, BLOG_ERROR, "wrong type"); goto fail1; } o->name = NCDValue_StringValue(name_arg); // check for existing provide with this name if (find_provide(o->name)) { ModuleLog(o->i, BLOG_ERROR, "a provide with this name already exists"); goto fail1; } // insert to provides list LinkedList2_Append(&provides, &o->provides_node); // init depends list LinkedList2_Init(&o->depends); // set not dying o->dying = 0; // signal up. // This comes above the loop which follows, so that effects on related depend statements are // computed before this process advances, avoiding problems like failed variable resolutions. NCDModuleInst_Backend_Up(o->i); // update depends LinkedList2Iterator it; LinkedList2Iterator_InitForward(&it, &depends); LinkedList2Node *n; while (n = LinkedList2Iterator_Next(&it)) { struct depend *d = UPPER_OBJECT(n, struct depend, depends_node); depend_update(d); } return; fail1: free(o); fail0: NCDModuleInst_Backend_SetError(i); NCDModuleInst_Backend_Dead(i); } static void provide_free (struct provide *o) { ASSERT(LinkedList2_IsEmpty(&o->depends)) NCDModuleInst *i = o->i; // remove from provides list LinkedList2_Remove(&provides, &o->provides_node); // free instance free(o); NCDModuleInst_Backend_Dead(i); } static void provide_func_die (void *vo) { struct provide *o = vo; ASSERT(!o->dying) // if we have no depends, die immediately if (LinkedList2_IsEmpty(&o->depends)) { provide_free(o); return; } // set dying o->dying = 1; // start collapsing our depends LinkedList2Iterator it; LinkedList2Iterator_InitForward(&it, &o->depends); LinkedList2Node *n; while (n = LinkedList2Iterator_Next(&it)) { struct depend *d = UPPER_OBJECT(n, struct depend, provide_node); ASSERT(d->provide == o) // update depend to make sure it is collapsing depend_update(d); } } static void depend_func_new (NCDModuleInst *i) { // allocate instance struct depend *o = malloc(sizeof(*o)); if (!o) { ModuleLog(i, BLOG_ERROR, "failed to allocate instance"); goto fail0; } NCDModuleInst_Backend_SetUser(i, o); // init arguments o->i = i; // read arguments NCDValue *names_arg; if (!NCDValue_ListRead(o->i->args, 1, &names_arg)) { ModuleLog(i, BLOG_ERROR, "wrong arity"); goto fail1; } if (NCDValue_Type(names_arg) != NCDVALUE_LIST) { ModuleLog(o->i, BLOG_ERROR, "wrong type"); goto fail1; } o->names = names_arg; // check names list NCDValue *e = NCDValue_ListFirst(o->names); while (e) { if (NCDValue_Type(e) != NCDVALUE_STRING) { ModuleLog(o->i, BLOG_ERROR, "wrong type"); goto fail1; } e = NCDValue_ListNext(o->names, e); } // insert to depends list LinkedList2_Append(&depends, &o->depends_node); // set no provide o->provide = NULL; // update depend_update(o); return; fail1: free(o); fail0: NCDModuleInst_Backend_SetError(i); NCDModuleInst_Backend_Dead(i); } static void depend_free (struct depend *o) { NCDModuleInst *i = o->i; if (o->provide) { // remove from provide's list LinkedList2_Remove(&o->provide->depends, &o->provide_node); // if provide is dying and is empty, let it die if (o->provide->dying && LinkedList2_IsEmpty(&o->provide->depends)) { provide_free(o->provide); } } // remove from depends list LinkedList2_Remove(&depends, &o->depends_node); // free instance free(o); NCDModuleInst_Backend_Dead(i); } static void depend_func_die (void *vo) { struct depend *o = vo; depend_free(o); } static void depend_func_clean (void *vo) { struct depend *o = vo; if (!(o->provide && o->provide_collapsing)) { return; } // remove from provide's list LinkedList2_Remove(&o->provide->depends, &o->provide_node); // if provide is dying and is empty, let it die if (o->provide->dying && LinkedList2_IsEmpty(&o->provide->depends)) { provide_free(o->provide); } // set no provide o->provide = NULL; // update depend_update(o); } static int depend_func_getvar (void *vo, const char *varname, NCDValue *out) { struct depend *o = vo; ASSERT(o->provide) ASSERT(!o->provide_collapsing) ASSERT(!o->provide->dying) return NCDModuleInst_Backend_GetVar(o->provide->i, varname, out); } static NCDModuleInst * depend_func_getobj (void *vo, const char *objname) { struct depend *o = vo; ASSERT(o->provide) ASSERT(!o->provide_collapsing) ASSERT(!o->provide->dying) return NCDModuleInst_Backend_GetObj(o->provide->i, objname); } static const struct NCDModule modules[] = { { .type = "multiprovide", .func_new = provide_func_new, .func_die = provide_func_die }, { .type = "multidepend", .func_new = depend_func_new, .func_die = depend_func_die, .func_clean = depend_func_clean, .func_getvar = depend_func_getvar, .func_getobj = depend_func_getobj }, { .type = NULL } }; const struct NCDModuleGroup ncdmodule_multidepend = { .func_globalinit = func_globalinit, .modules = modules };