-// $Id: settings.c,v 1.2 2007-03-28 04:33:41 quinn Exp $
-// This module implements a generic system of settings (attribute-value) that can
-// be associated with search targets. The system supports both default values,
-// per-target overrides, and per-user settings.
-//
+/* This file is part of Pazpar2.
+ Copyright (C) 2006-2008 Index Data
+
+Pazpar2 is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free
+Software Foundation; either version 2, or (at your option) any later
+version.
+
+Pazpar2 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 St, Fifth Floor, Boston, MA 02110-1301 USA
+
+*/
+
+
+// This module implements a generic system of settings
+// (attribute-value) that can be associated with search targets. The
+// system supports both default values, per-target overrides, and
+// per-user settings.
#include <string.h>
#include <stdio.h>
#include <yaz/nmem.h>
#include <yaz/log.h>
-static NMEM nmem = 0;
+#include "pazpar2.h"
+#include "database.h"
+#include "settings.h"
-#define PZ_PIGGYBACK 0
-#define PZ_ELEMENTS 1
-#define PZ_SYNTAX 2
+static NMEM nmem = 0;
+// Used for initializing setting_dictionary with pazpar2-specific settings
static char *hard_settings[] = {
"pz:piggyback",
"pz:elements",
- "pz::syntax",
+ "pz:requestsyntax",
+ "pz:cclmap:",
+ "pz:xslt",
+ "pz:nativesyntax",
+ "pz:authentication",
+ "pz:allow",
+ "pz:maxrecs",
+ "pz:id",
+ "pz:name",
+ "pz:queryencoding",
+ "pz:ip",
+ "pz:zproxy",
+ "pz:apdulog",
0
};
-struct setting
-{
- char *target;
- char *name;
- char *value;
- char *user;
-};
-
struct setting_dictionary
{
char **dict;
int num;
};
+static struct setting_dictionary *dictionary = 0;
+
+// This establishes the precedence of wildcard expressions
+#define SETTING_WILDCARD_NO 0 // No wildcard
+#define SETTING_WILDCARD_DB 1 // Database wildcard 'host:port/*'
+#define SETTING_WILDCARD_YES 2 // Complete wildcard '*'
+
+// Returns size of settings directory
+int settings_num(void)
+{
+ return dictionary->num;
+}
+
+int settings_offset(const char *name)
+{
+ int i;
+
+ if (!name)
+ name = "";
+ for (i = 0; i < dictionary->num; i++)
+ if (!strcmp(name, dictionary->dict[i]))
+ return i;
+ return -1;
+}
+
+// Ignores everything after second colon, if present
+// A bit of a hack to support the pz:cclmap: scheme (and more to come?)
+int settings_offset_cprefix(const char *name)
+{
+ const char *p;
+ int maxlen = 100;
+ int i;
+
+ if (!strncmp("pz:", name, 3) && (p = strchr(name + 3, ':')))
+ maxlen = (p - name) + 1;
+ for (i = 0; i < dictionary->num; i++)
+ if (!strncmp(name, dictionary->dict[i], maxlen))
+ return i;
+ return -1;
+}
+
+char *settings_name(int offset)
+{
+ return dictionary->dict[offset];
+}
+
static int isdir(const char *path)
{
struct stat st;
return st.st_mode & S_IFDIR;
}
-static void read_settings_file(const char *path, void *context,
- void (*fun)(void *context, struct setting *set))
+// Read settings from an XML file, calling handler function for each setting
+static void read_settings_file(const char *path,
+ void (*fun)(struct setting *set))
{
xmlDoc *doc = xmlParseFile(path);
xmlNode *n;
- //xmlChar *namea, *targeta, *valuea, *usera;
+ xmlChar *namea, *targeta, *valuea, *usera, *precedencea;
if (!doc)
{
exit(1);
}
n = xmlDocGetRootElement(doc);
-
+ namea = xmlGetProp(n, (xmlChar *) "name");
+ targeta = xmlGetProp(n, (xmlChar *) "target");
+ valuea = xmlGetProp(n, (xmlChar *) "value");
+ usera = xmlGetProp(n, (xmlChar *) "user");
+ precedencea = xmlGetProp(n, (xmlChar *) "precedence");
for (n = n->children; n; n = n->next)
{
- fprintf(stderr, "Node name: %s\n", n->name);
+ if (n->type != XML_ELEMENT_NODE)
+ continue;
+ if (!strcmp((const char *) n->name, "set"))
+ {
+ char *name, *target, *value, *user, *precedence;
+
+ name = (char *) xmlGetProp(n, (xmlChar *) "name");
+ target = (char *) xmlGetProp(n, (xmlChar *) "target");
+ value = (char *) xmlGetProp(n, (xmlChar *) "value");
+ user = (char *) xmlGetProp(n, (xmlChar *) "user");
+ precedence = (char *) xmlGetProp(n, (xmlChar *) "precedence");
+
+ if ((!name && !namea) || (!value && !valuea) || (!target && !targeta))
+ {
+ yaz_log(YLOG_FATAL, "set must specify name, value, and target");
+ exit(1);
+ }
+ else
+ {
+ struct setting set;
+ char nameb[1024];
+ char targetb[1024];
+ char valueb[1024];
+
+ // Copy everything into a temporary buffer -- we decide
+ // later if we are keeping it.
+ if (precedence)
+ set.precedence = atoi((char *) precedence);
+ else if (precedencea)
+ set.precedence = atoi((char *) precedencea);
+ else
+ set.precedence = 0;
+ if (target)
+ strcpy(targetb, target);
+ else
+ strcpy(targetb, (const char *) targeta);
+ set.target = targetb;
+ if (name)
+ strcpy(nameb, name);
+ else
+ strcpy(nameb, (const char *) namea);
+ set.name = nameb;
+ if (value)
+ strcpy(valueb, value);
+ else
+ strcpy(valueb, (const char *) valuea);
+ set.value = valueb;
+ set.next = 0;
+ (*fun)(&set);
+ }
+ xmlFree(name);
+ xmlFree(precedence);
+ xmlFree(value);
+ xmlFree(user);
+ xmlFree(target);
+ }
+ else
+ {
+ yaz_log(YLOG_FATAL, "Unknown element %s in settings file", (char*) n->name);
+ exit(1);
+ }
}
+ xmlFree(namea);
+ xmlFree(precedencea);
+ xmlFree(valuea);
+ xmlFree(usera);
+ xmlFree(targeta);
+
+ xmlFreeDoc(doc);
}
-// Recursively read files in a directory structure, calling
-static void read_settings(const char *path, void *context,
- void (*fun)(void *context, struct setting *set))
+// Recursively read files or directories, invoking a
+// callback for each one
+static void read_settings(const char *path,
+ void (*fun)(struct setting *set))
{
DIR *d;
struct dirent *de;
+ char *dot;
- if (!(d = opendir(path)))
+ if (isdir(path))
{
- yaz_log(YLOG_FATAL|YLOG_ERRNO, "%s", path);
- exit(1);
- }
- while ((de = readdir(d)))
- {
- char tmp[1024];
- if (*de->d_name == '.' || !strcmp(de->d_name, "CVS"))
- continue;
- sprintf(tmp, "%s/%s", path, de->d_name);
- if (isdir(tmp))
- read_settings(tmp, context, fun);
- else
+ if (!(d = opendir(path)))
{
- char *dot;
- if ((dot = rindex(de->d_name, '.')) && !strcmp(dot + 1, "xml"))
- read_settings_file(tmp, context, fun);
+ yaz_log(YLOG_FATAL|YLOG_ERRNO, "%s", path);
+ exit(1);
}
+ while ((de = readdir(d)))
+ {
+ char tmp[1024];
+ if (*de->d_name == '.' || !strcmp(de->d_name, "CVS"))
+ continue;
+ sprintf(tmp, "%s/%s", path, de->d_name);
+ read_settings(tmp, fun);
+ }
+ closedir(d);
}
- closedir(d);
+ else if ((dot = rindex(path, '.')) && !strcmp(dot + 1, "xml"))
+ read_settings_file(path, fun);
+}
+
+// Determines if a ZURL is a wildcard, and what kind
+static int zurl_wildcard(const char *zurl)
+{
+ if (!zurl)
+ return SETTING_WILDCARD_NO;
+ if (*zurl == '*')
+ return SETTING_WILDCARD_YES;
+ else if (*(zurl + strlen(zurl) - 1) == '*')
+ return SETTING_WILDCARD_DB;
+ else
+ return SETTING_WILDCARD_NO;
}
// Callback. Adds a new entry to the dictionary if necessary
// This is used in pass 1 to determine layout of dictionary
-static void prepare_dictionary(void *context, struct setting *set)
+// and to load any databases mentioned
+static void prepare_dictionary(struct setting *set)
{
- struct setting_dictionary *dict = (struct setting_dictionary *) context;
int i;
+ char *p;
+
+ // If target address is not wildcard, add the database
+ if (*set->target && !zurl_wildcard(set->target))
+ find_database(set->target, 0);
- for (i = 0; i < dict->num; i++)
- if (!strcmp(set->name, set->name))
+ // Determine if we already have a dictionary entry
+ if (!strncmp(set->name, "pz:", 3) && (p = strchr(set->name + 3, ':')))
+ *(p + 1) = '\0';
+ for (i = 0; i < dictionary->num; i++)
+ if (!strcmp(dictionary->dict[i], set->name))
return;
+
+ if (!strncmp(set->name, "pz:", 3)) // Probably a typo in config file
+ {
+ yaz_log(YLOG_FATAL, "Unknown pz: setting '%s'", set->name);
+ exit(1);
+ }
+
// Create a new dictionary entry
// Grow dictionary if necessary
- if (!dict->size)
- dict->dict = nmem_malloc(nmem, (dict->size = 50) * sizeof(char*));
- else if (dict->num + 1 > dict->size)
+ if (!dictionary->size)
+ dictionary->dict = nmem_malloc(nmem, (dictionary->size = 50) * sizeof(char*));
+ else if (dictionary->num + 1 > dictionary->size)
+ {
+ char **tmp = nmem_malloc(nmem, dictionary->size * 2 * sizeof(char*));
+ memcpy(tmp, dictionary->dict, dictionary->size * sizeof(char*));
+ dictionary->dict = tmp;
+ dictionary->size *= 2;
+ }
+ dictionary->dict[dictionary->num++] = nmem_strdup(nmem, set->name);
+}
+
+// This is called from grep_databases -- adds/overrides setting for a target
+// This is also where the rules for precedence of settings are implemented
+static void update_database(void *context, struct database *db)
+{
+ struct setting *set = (struct setting *) context;
+ struct setting *s, **sp;
+ int offset;
+
+ // Is this the right database?
+ if (!match_zurl(db->url, set->target))
+ return;
+
+ if ((offset = settings_offset_cprefix(set->name)) < 0)
+ abort(); // Should never get here
+
+ // First we determine if this setting is overriding any existing settings
+ // with the same name.
+ for (s = db->settings[offset], sp = &db->settings[offset]; s;
+ sp = &s->next, s = s->next)
+ if (!strcmp(s->name, set->name))
+ {
+ if (s->precedence < set->precedence)
+ // We discard the value (nmem keeps track of the space)
+ *sp = (*sp)->next; // unlink value from existing setting
+ else if (s->precedence > set->precedence)
+ // Db contains a higher-priority setting. Abort search
+ break;
+ if (zurl_wildcard(s->target) > zurl_wildcard(set->target))
+ // target-specific value trumps wildcard. Delete.
+ *sp = (*sp)->next; // unlink.....
+ else if (!zurl_wildcard(s->target))
+ // Db already contains higher-priority setting. Abort search
+ break;
+ }
+ if (!s) // s will be null when there are no higher-priority settings -- we add one
{
- char **tmp = nmem_malloc(nmem, dict->size * 2 * sizeof(char*));
- memcpy(tmp, dict->dict, dict->size * sizeof(char*));
- dict->dict = tmp;
- dict->size *= 2;
+ struct setting *new = nmem_malloc(nmem, sizeof(*new));
+
+ memset(new, 0, sizeof(*new));
+ new->precedence = set->precedence;
+ new->target = nmem_strdup(nmem, set->target);
+ new->name = nmem_strdup(nmem, set->name);
+ new->value = nmem_strdup(nmem, set->value);
+ new->next = db->settings[offset];
+ db->settings[offset] = new;
}
- dict->dict[dict->num++] = nmem_strdup(nmem, set->name);
}
-#ifdef GAGA
// Callback -- updates database records with dictionary entries as appropriate
-static void update_databases(void *context, struct setting *set)
+// This is used in pass 2 to assign name/value pairs to databases
+static void update_databases(struct setting *set)
{
+ predef_grep_databases(set, 0, update_database);
}
-#endif
// This simply copies the 'hard' (application-specific) settings
// to the settings dictionary.
dict->num = dict->size;
}
+// Read any settings names introduced in service definition (config) and add to dictionary
+// This is done now to avoid errors if user settings are declared in session overrides
+static void initialize_soft_settings()
+{
+ struct conf_service *service = config->servers->service;
+ int i;
+
+ for (i = 0; i < service->num_metadata; i++)
+ {
+ struct setting set;
+ struct conf_metadata *md = &service->metadata[i];
+
+ if (md->setting == Metadata_setting_no)
+ continue;
+
+ set.precedence = 0;
+ set.target = "";
+ set.name = md->name;
+ set.value = "";
+ set.next = 0;
+ prepare_dictionary(&set);
+ }
+}
+
// If we ever decide we need to be able to specify multiple settings directories,
// the two calls to read_settings must be split -- so the dictionary is prepared
// for the contents of every directory before the databases are updated.
void settings_read(const char *path)
{
+ read_settings(path, prepare_dictionary);
+ read_settings(path, update_databases);
+}
+
+void init_settings(void)
+{
struct setting_dictionary *new;
if (!nmem)
nmem = nmem_create();
else
nmem_reset(nmem);
new = nmem_malloc(nmem, sizeof(*new));
+ memset(new, 0, sizeof(*new));
initialize_hard_settings(new);
- memset(new, sizeof(*new), 0);
- read_settings(path, new, prepare_dictionary);
- //read_settings(path, new, update_databases);
+ dictionary = new;
+ initialize_soft_settings();
}
/*
projects / pazpar2-moved-to-github.git / blobdiff