/** \file afs.c audio file sending functions
*
- * This contains the audio sending part of para_server which is independent
- * of the current audio format, database tool and of the activated senders.
+ * This contains the audio sending part of para_server which is independent of
+ * the current audio format, audio file selector and of the activated senders.
*/
#include <sys/time.h> /* gettimeofday */
"mallinfo: %d\n"
"connections (active/accepted/total): %u/%u/%u\n"
"current loglevel: %i\n"
- "supported database tools: %s\n"
+ "supported audio file selectors: %s\n"
"supported audio formats: %s\n"
"supported senders: %s\n"
"%s",
/* not found, look for commands supported by the current selector */
mmd_lock();
if (handler)
- *handler = make_message("the %s database tool", dblist[mmd->dbt_num].name);
+ *handler = make_message("the %s selector", dblist[mmd->dbt_num].name);
cmd = dblist[mmd->dbt_num].cmd_list;
mmd_unlock();
for (; cmd->name; cmd++)
*/
-/** \file db.c functions common to all database tools. */
+/** \file db.c functions common to all audio file selectors */
#include "server.cmdline.h"
#include "server.h"
int find_audio_files(const char *dirname, int (*f)(const char *, const char *));
/**
- * describes one of para_server's supported database tools
+ * describes one supported audio file selector
*
- * There is exactly one such struct for each supported database tool. During
- * the startup part of para_server the \a init() function of the activated
- * database tool gets called which fills in the other members.
+ * There is one such struct for each supported selector. During the startup
+ * part of para_server the \a init() function of the activated selector gets
+ * called which fills in all other function pointers.
*
*
*/
struct audio_file_selector {
/**
- * name name of this database tool
+ * name name of this selector
*/
const char *name;
/**
- * the database init routine
+ * the init routine of the selector
*
* It should check its command line options and do all necessary initialization
* like connecting to a database server.
*
* A negative return value indicates an initialization error and means that
- * this database tool should be ignored for now (it may later be activated
- * again via the cdt command).
+ * this selector should be ignored for now (it may later be activated again via
+ * the chs command).
*
* If \a init() returns success (non-negative return value), it must have
* initialized in all non-optional function pointers of the given selector
* struct. Moreover, \a cmd_list must point to a NULL-terminated array which
- * holds the list of all commands that are supported by this database tool.
+ * holds the list of all commands that are supported by this selector.
*/
int (*init)(struct audio_file_selector *self);
/**
void (*update_audio_file)(char *audio_file);
/**
*
- * shutdown this database tool and free all resources
+ * shutdown this selector and free all resources
*
- * This gets called whenever the database tool changes (via the cdt command),
- * or when para_server receives the HUP signal, or when para_server shuts down.
- * It is assumed to succeed.
+ * This gets called whenever the audio file selector changes. The reason for
+ * this change might be that some user sent the chs command, that para_server
+ * receives the HUP signal, or that para_server shuts down. It is assumed to
+ * succeed.
*/
void (*shutdown)(void);
/**
*
* add file descriptors to fd_sets
*
- * The pre_select function of the activated database tool gets called just
- * before para_server enters its main select loop. The selector may add its own
- * file descriptors to the \a rfds or the \a wfds set.
+ * The pre_select function of the activated selector gets called just before
+ * para_server enters its main select loop. The selector may add its own file
+ * descriptors to the \a rfds or the \a wfds set.
*
* If a file descriptor was added, \a max_fileno must be increased by
* this function, if neccessary.
"\tCreate database name containing the initial columns for basic\n"
"\tinteroperation with server. This command has to be used only once\n"
-"\twhen you use the mysql database tool for the very first time.\n"
+"\twhen you use the mysql audio file selector for the very first time.\n"
"\n"
"\tThe optional name defaults to 'paraslash' if not given.\n"
.help =
"\tIf pattern was not given, print list of all audio files known\n"
-"\tto the mysql database tool. See the documentation of mysql\n"
+"\tto the mysql selector. See the documentation of mysql\n"
"\tfor the definition of LIKE patterns.\n"
},
}
/**
- * the init function of the mysql-based database tool
+ * the init function of the mysql-based audio file selector
*
* Check the command line options and initialize all function pointers of \a db.
* Connect to the mysql server and initialize the dbinfo string.
static int com_lpl(int, int, char **);
extern struct misc_meta_data *mmd;
-/* array of commands that are supported by this database tool */
+/* array of supported commands */
static struct server_command cmds[] = {
{
.name = "ppl",
.name = "random_info",
.handler = com_random_info,
.perms = 0,
-.description = "about the random database tool",
+.description = "about the random audio file selector",
.synopsis = "random_info",
.help =
#define DBINFO "dbinfo1:database info? You're kidding. I'm still dopey!\ndbinfo2:\ndbinfo3:\n"
/**
- * the init function for the random database tool
+ * the init function for the random audio file selector
*
* Init all function pointers of \a db, init the dbinfo text and seed the
* PRNG.
unsigned int active_connections;
/** the process id of para_server */
pid_t server_pid;
-/** a string that gets filled in by the current database tool */
+/** a string that gets filled in by the current audio file selector */
char dbinfo[MMD_INFO_SIZE];
/** the number if the current database tool */
int dbt_num;