disorderd - DisOrder jukebox daemon

       disorderd [OPTIONS]

       disorderd  is  a  daemon  which plays audio files and services requests
       from users concerning what is to be played.

       --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

       --debug, -d
              Enable debugging.

       --help, -h
              Display a usage message.

       --version, -V
              Display version number.

       For configuration file documentation, see disorder_config(5).

       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.

       In  its  usual  configuration, DisOrder logs to daemon.* via syslog(3).
       Exactly where this ends up depends on the contents of /etc/syslog.conf.

       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.

       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

       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

   Configuration Files
              Global configuration file.  See disorder_config(5).

              Private configuration (now largely obsolete).

              Per-user password file.

              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.

              Saved copy of queue.

              Saved copy of recently played track list.

              Global preferences database.

              Records recently added tracks.

              Preferences database.

              Database of scheduled tasks.

              Search lookup database.

              Tag lookup database.

              Tracks database.

              User database.

              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.

              Socket for communication with disorder-speaker(8).

              Lockfile.  This prevents multiple instances of DisOrder  running

       LC_ALL, LANG, etc
              Current locale.  See locale(7).

       disorder(1), disorder_config(5), disorder-dump(8), disorder.cgi(8)