NAME disorderd - DisOrder jukebox daemon SYNOPSIS disorderd [OPTIONS] DESCRIPTION disorderd is a daemon which plays audio files and services requests from users concerning what is to be played. OPTIONS --config PATH, -c PATH Set the configuration file. The default is /etc/disorder/con- fig. See disorder_config(5) for further information. --pidfile PATH, -P PATH Write a pidfile. --foreground, -f Run in the foreground. (By default, disorderd detaches from its terminal and runs in the background.) --syslog, -s Log to syslog. This is the default if DisOrder runs in the background. --debug, -d Enable debugging. --help, -h Display a usage message. --version, -V Display version number. NOTES For configuration file documentation, see disorder_config(5). Startup The first time a new install of DisOrder is started it will run disor- der-rescan to pick up new tracks. On subsequent server restarts it will NOT do this automatically; if you want a rescan at every restart you must arrange that manually. There is however an automatic rescan once every 24 hours. A root login is automatically created on startup if it does not exist. If disorder(1) is run as root on the same machine as the server it is capable of extracting the password from the database directly. Therefore it is immediately possible to create other users with disor- der adduser as root on the server machine. However it is likely to be preferable to get users to register themselves via the web interface; see setup-guest in disorder(1) for more details on this. Logging In its usual configuration, DisOrder logs to daemon.* via syslog(3). Exactly where this ends up depends on the contents of /etc/syslog.conf. Locales disorderd is locale-aware. If you do not set the locale correctly then it may not handle non-ASCII data properly. Filenames and the configuration file are assumed to be encoded using the current locale. Internally (within the server, in the database and in communication between client and server) the UTF-8 encoding is used. Backups DisOrder uses Berkeley DB but currently discards log files that are no longer in use. This means that DB's catastrophic recovery cannot be used (normal recovery can be used, and indeed the server does this automatically on startup). It is suggested that instead you just back up the output of disor- der-dump(8), which saves only the parts of the database that cannot be regenerated automatically, and thus has relatively modest storage requirements. SIGNALS SIGHUP Re-read the configuration file. Not all configuration options can be modified during the life- time of the server; of those that can't, some will just be ignored if they change while others will cause the new configu- ration to be rejected. See disorder_config(5) for details. SIGTERM Terminate the daemon gracefully. SIGINT Terminate the daemon gracefully. It may be more convenient to perform these operations from the client disorder(1). FILES Configuration Files /etc/disorder/config Global configuration file. See disorder_config(5). /etc/disorder/config.private Private configuration (now largely obsolete). ~/.disorder/passwd Per-user password file. Communication /var/lib/disorder/socket Communication socket for disorder(1). See disorder_protocol(5) for protocol documentation. Internal State Don't modify these files, especially not while the server is running. /var/lib/disorder/queue Saved copy of queue. /var/lib/disorder/recent Saved copy of recently played track list. /var/lib/disorder/global.db Global preferences database. /var/lib/disorder/noticed.db Records recently added tracks. /var/lib/disorder/prefs.db Preferences database. /var/lib/disorder/schedule.db Database of scheduled tasks. /var/lib/disorder/search.db Search lookup database. /var/lib/disorder/tags.db Tag lookup database. /var/lib/disorder/tracks.db Tracks database. /var/lib/disorder/users.db User database. /var/lib/disorder/DB_CONFIG Berkeley DB configuration file. This may be used to override database settings without recompiling DisOrder. See the Berke- ley DB documention for further details. /var/lib/disorder/log.* and /var/lib/disorder/__db.* Database internal files. /var/lib/disorder/speaker/socket Socket for communication with disorder-speaker(8). /var/lib/disorder/lock Lockfile. This prevents multiple instances of DisOrder running simultaneously. ENVIRONMENT LC_ALL, LANG, etc Current locale. See locale(7). SEE ALSO disorder(1), disorder_config(5), disorder-dump(8), disorder.cgi(8)