X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/763d5e6ad88ef3ba1cd1d7742d060e4f1e54c6b8..b0b15b7ced28b3c6ddfcd4b0a7e46ee6432a243c:/lib/configuration.h diff --git a/lib/configuration.h b/lib/configuration.h index 4af3cad..cc7e1e3 100644 --- a/lib/configuration.h +++ b/lib/configuration.h @@ -1,6 +1,7 @@ + /* * This file is part of DisOrder. - * Copyright (C) 2004, 2005, 2006 Richard Kettlewell + * Copyright (C) 2004-2008 Richard Kettlewell * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -17,40 +18,59 @@ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA */ +/** @file lib/configuration.h + * @brief Configuration file support + */ #ifndef CONFIGURATION_H #define CONFIGURATION_H -struct real_pcre; +#include + +#include "speaker-protocol.h" +#include "rights.h" /* Configuration is kept in a @struct config@; the live configuration * is always pointed to by @config@. Values in @config@ are UTF-8 encoded. */ +/** @brief A list of strings */ struct stringlist { + /** @brief Number of strings */ int n; + /** @brief Array of strings */ char **s; }; +/** @brief A list of list of strings */ struct stringlistlist { + /** @brief Number of string lists */ int n; + /** @brief Array of string lists */ struct stringlist *s; }; +/** @brief A collection of tracks */ struct collection { + /** @brief Module that supports this collection */ char *module; + /** @brief Filename encoding */ char *encoding; + /** @brief Root directory */ char *root; }; +/** @brief A list of collections */ struct collectionlist { + /** @brief Number of collections */ int n; + /** @brief Array of collections */ struct collection *s; }; struct namepart { char *part; /* part */ - struct real_pcre *re; /* regexp */ + pcre *re; /* regexp */ char *replace; /* replacement string */ char *context; /* context glob */ unsigned reflags; /* regexp flags */ @@ -65,7 +85,7 @@ struct transform { char *type; /* track or dir */ char *context; /* sort or choose */ char *replace; /* substitution string */ - struct real_pcre *re; /* compiled re */ + pcre *re; /* compiled re */ unsigned flags; /* regexp flags */ }; @@ -74,56 +94,220 @@ struct transformlist { struct transform *t; }; +/** @brief System configuration */ struct config { /* server config */ - struct stringlistlist player; /* players */ - struct stringlistlist allow; /* allowed users */ - struct stringlist scratch; /* scratch tracks */ - long gap; /* gap between tracks */ - long history; /* length of history */ - struct stringlist trust; /* trusted users */ - const char *user; /* user to run as */ - long nice_rescan; /* rescan subprocess niceness */ - struct stringlist plugins; /* plugin path */ - struct stringlist stopword; /* stopwords for track search */ - struct collectionlist collection; /* track collections */ + + /** @brief Authorization algorithm */ + char *authorization_algorithm; + + /** @brief All players */ + struct stringlistlist player; + + /** @brief All tracklength plugins */ + struct stringlistlist tracklength; + + /** @brief Allowed users */ + struct stringlistlist allow; + + /** @brief Scratch tracks */ + struct stringlist scratch; + + /** @brief Gap between tracks in seconds */ + long gap; + + /** @brief Maximum number of recent tracks to record in history */ + long history; + + /** @brief Expiry limit for noticed.db */ + long noticed_history; + + /** @brief Trusted users */ + struct stringlist trust; + + /** @brief User for server to run as */ + const char *user; + + /** @brief Nice value for rescan subprocess */ + long nice_rescan; + + /** @brief Paths to search for plugins */ + struct stringlist plugins; + + /** @brief List of stopwords */ + struct stringlist stopword; + + /** @brief List of collections */ + struct collectionlist collection; + + /** @brief Database checkpoint byte limit */ long checkpoint_kbyte; + + /** @brief Databsase checkpoint minimum */ long checkpoint_min; - char *mixer; /* mixer device file */ - char *channel; /* mixer channel */ - long prefsync; /* preflog sync intreval */ - struct stringlist listen; /* secondary listen address */ - const char *alias; /* alias format */ - int lock; /* server takes a lock */ - long nice_server; /* nice value for server */ - long nice_speaker; /* nice value for speaker */ - /* shared client/server config */ - const char *home; /* home directory for state files */ - /* client config */ - const char *username, *password; /* our own username and password */ - struct stringlist connect; /* connect address */ - /* web config */ - struct stringlist templates; /* template path */ - const char *url; /* canonical URL */ - long refresh; /* maximum refresh period */ + + /** @brief Path to mixer device */ + char *mixer; + + /** @brief Mixer channel to use */ + char *channel; + + long prefsync; /* preflog sync interval */ + + /** @brief Secondary listen address */ + struct stringlist listen; + + /** @brief Alias format string */ + const char *alias; + + /** @brief Enable server locking */ + int lock; + + /** @brief Nice value for server */ + long nice_server; + + /** @brief Nice value for speaker */ + long nice_speaker; + + /** @brief Command execute by speaker to play audio */ + const char *speaker_command; + + /** @brief Target sample format */ + struct stream_header sample_format; + + /** @brief Sox syntax generation */ + long sox_generation; + + /** @brief API used to play sound + * + * Choices are @ref BACKEND_ALSA, @ref BACKEND_COMMAND or @ref + * BACKEND_NETWORK. + */ + int api; + +/* These values had better be non-negative */ +#define BACKEND_ALSA 0 /**< Use ALSA (Linux only) */ +#define BACKEND_COMMAND 1 /**< Execute a command */ +#define BACKEND_NETWORK 2 /**< Transmit RTP */ +#define BACKEND_COREAUDIO 3 /**< Use Core Audio (Mac only) */ +#define BACKEND_OSS 4 /**< Use OSS */ + +#if HAVE_ALSA_ASOUNDLIB_H +# define DEFAULT_BACKEND BACKEND_ALSA +#elif HAVE_SYS_SOUNDCARD_H || EMPEG_HOST +# define DEFAULT_BACKEND BACKEND_OSS +#elif HAVE_COREAUDIO_AUDIOHARDWARE_H +# define DEFAULT_BACKEND BACKEND_COREAUDIO +#else +# error Cannot choose a default backend +#endif + + /** @brief Home directory for state files */ + const char *home; + + /** @brief Login username */ + const char *username; + + /** @brief Login password */ + const char *password; + + /** @brief Address to connect to */ + struct stringlist connect; + + /** @brief Directories to search for web templates */ + struct stringlist templates; + + /** @brief Canonical URL of web interface */ + char *url; + + /** @brief Short display limit */ + long short_display; + + /** @brief Maximum refresh interval for web interface (seconds) */ + long refresh; + + /** @brief Facilities restricted to trusted users + * + * A bitmap of @ref RESTRICT_SCRATCH, @ref RESTRICT_REMOVE and @ref + * RESTRICT_MOVE. + */ unsigned restrictions; /* restrictions */ -#define RESTRICT_SCRATCH 1 -#define RESTRICT_REMOVE 2 -#define RESTRICT_MOVE 4 +#define RESTRICT_SCRATCH 1 /**< Restrict scratching */ +#define RESTRICT_REMOVE 2 /**< Restrict removal */ +#define RESTRICT_MOVE 4 /**< Restrict rearrangement */ + + /** @brief Target queue length */ + long queue_pad; + + /** @brief Minimum time between a track being played again */ + long replay_min; + struct namepartlist namepart; /* transformations */ - int signal; /* termination signal */ - const char *device; /* ALSA output device */ + + /** @brief Termination signal for subprocesses */ + int signal; + + /** @brief ALSA output device */ + const char *device; struct transformlist transform; /* path name transformations */ + /** @brief Address to send audio data to */ + struct stringlist broadcast; + + /** @brief Source address for network audio transmission */ + struct stringlist broadcast_from; + + /** @brief TTL for multicast packets */ + long multicast_ttl; + + /** @brief Whether to loop back multicast packets */ + int multicast_loop; + + /** @brief Login lifetime in seconds */ + long cookie_login_lifetime; + + /** @brief Signing key lifetime in seconds */ + long cookie_key_lifetime; + + /** @brief Default rights for a new user */ + char *default_rights; + + /** @brief Path to sendmail executable */ + char *sendmail; + + /** @brief SMTP server for sending mail */ + char *smtp_server; + + /** @brief Origin address for outbound mail */ + char *mail_sender; + + /** @brief Maximum number of tracks in response to 'new' */ + long new_max; + + /** @brief Minimum interval between password reminder emails */ + long reminder_interval; + + /** @brief Whether to allow user management over TCP */ + int remote_userman; + + /** @brief Maximum age of biased-up tracks */ + long new_bias_age; + + /** @brief Maximum bias */ + long new_bias; + /* derived values: */ int nparts; /* number of distinct name parts */ char **parts; /* name part list */ + + /* undocumented, for testing only */ + long dbversion; }; extern struct config *config; /* the current configuration */ -int config_read(void); +int config_read(int server); /* re-read config, return 0 on success or non-0 on error. * Only updates @config@ if the new configuration is valid. */ @@ -143,6 +327,7 @@ char *config_private(void); /* get the private config file */ extern char *configfile; +extern int config_per_user; #endif /* CONFIGURATION_H */