oracular (8) cdemu-daemon.8.gz

Provided by: cdemu-daemon_3.2.6-3_amd64 bug

NAME

       cdemud - The CDEmu daemon

SYNOPSIS

       cdemu-daemon [options]

DESCRIPTION

       This is CDEmu daemon, the userspace part of the cdemu suite, a free, GPL CD/DVD-ROM device
       emulator for linux.

       It receives SCSI commands from kernel module and processes  them,  passing  the  requested
       data  back  to  the  kernel. Daemon implements the actual virtual device; one instance per
       each device registered by kernel module. It uses libMirage, an image access  library  that
       is part of the cdemu suite, for the image access (e.g. sector reading).

       The  daemon  registers  itself  on  D-BUS' system or session bus (depending on the options
       passed to it) where it exposes an interface that can be used by clients to control it.

OPTIONS

       --config-file=filename
              Configuration file to load. See Configuration file section for details.

       -n --num-devices=N
              Number of devices. Specifies the number of  virtual  devices  the  daemon  instance
              should  register  with  kernel  module and control. By default, 1 virtual device is
              created.

       -c --ctl-device=path
              Control device. Specifies the control device path. Control device  is  a  character
              device  provided  by kernel module; it is used for communication between kernel and
              userspace part of CDEmu suite. By default, /dev/vhba_ctl is used.

       -a --audio-driver=driver
              Audio driver. Specifies audio driver to be used by  virtual  devices'  audio  play.
              Since  libao  is  used for audio playback, any valid libao driver can be specified.
              If default is used as a driver, then libao's default driver is used.  Few  examples
              of  valid  libao  drivers  are  alsa, oss, pulse or null.  For all drivers, default
              device is used. By default, if audio driver is not explicitly  specified  via  this
              option, null is used.

       -b --bus=bus_type
              Bus  type.  Valid  options  are system or session. By default, session bus is used.
              (Please note that  the  running  of  CDEmu  daemon  on  system  bus  is  considered
              deprecated and is discouraged for security reasons).

       -l --logfile=logfile
              Log  file to write logging output into. By default, use of log file is disabled and
              messages are written to stdout.

       --default-cdemu-debug-mask=mask
              Default debug mask for  CDEmu  devices  (at  CDEmu  daemon  implementation  level).
              Default value is 0.

       --default-mirage-debug-mask=mask
              Default  debug mask for CDEmu devices (at libMirage implementation level).  Default
              value is 0.

       -? --help
              Display the help message.

EXAMPLES

       Running daemon on default bus with PulseAudio audio driver and 4 virtual devices:
              cdemu-daemon --num-devices=4 --audio-driver=pulse

       Running daemon on system bus with 2 virtual devices and logging redirected to a file:
              cdemu-daemon --num-devices=2 --bus=system --logfile=/tmp/cdemu-daemon.log

CONFIGURATION FILE

       The daemon's settings can be collected in a configuration file, which  is  passed  to  the
       daemon  via  --config-file  option.  Configuration  file contains key=value pairs that are
       contained in a single [settings] section. The keys in configuration file correspond to the
       long names of command-line switches.

       If an option is specified in both configuration file and on command-line, the latter takes
       precedence.

       If the specified configuration file does not  exist,  it  is  silently  ignored.   If  the
       specified  configuration  file is invalid (e.g., has invalid syntax, or does not contain a
       section), an error is raised.

       Example

       Saving the following configuration to a file and passing it to the  daemon  via  --config-
       file is equivalent to passing --num-devices=2 --audio-driver=pulse directly to the daemon:

              [settings]
              num-devices=2
              audio-driver=pulse

AUTHORS

       Rok Mandeljc <rok.mandeljc@gmail.com>

       CDEmu project's web page: http://cdemu.sourceforge.net

       CDEmu project's mailing list: cdemu-devel@lists.sourceforge.net

                                           Apr 5, 2021                            CDEMU-DAEMON(8)