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)