      Known problems with bitstreamout plugin for VDR
      ===============================================

* Required is shm support.  Note: all Linux system should have this
  support already in the kernel.  If your kernel does not provide
  shm you have to activate shared memory filesystem in the kernel.
  Don't to forget to reboot the system.  If shm is available, execute

	mount -v -t tmpfs tmpfs /dev/shm

  and you should see a line like this:

	tmpfs on /dev/shm type shm (rw)

  Add the mount line below the line of activating swap (swapon)
  within your boot scripts if you system boot script not already
  do this.

* Do NEVER use the `-a' option of VDR in combination
  with the bitstreamout plugin.  NEVER, because
  both try to open the S/P-DIF of your sound card
  and the first block the other.

* If you're using the configuration `Nonlinear' for the option
  `Mp2Out' and your hear nothing or your speakers are very noisy
  you may switch your A/V receiver into Mpeg Audio mode or, if
  your A/V receiver does not support Mpeg Audio you should use
  `Dither' for the option `Mp2Out'.

* If you've problems with the command

        make plugins

  in the main directory of VDR you should set a
  symbolic link in the directory PLUGINS/src/

        ln -sf bitstreamout-<version> bitstreamout

  with e.g. <version>=0.45b -> see PLUGINS.html.

* Please use VDR 1.2.6 and higher together with
  DVB driver 2003-08-23 and higher.  For any user
  of DVB cards from TT and similar, please load the
  module dvb-ttpci(.o) with the option hw_sections=0
  to switch off the scan of the EPG data on the card
  its self. This because this will be done by VDR.

* Best results currently (2003/11/24) with DVB driver
  2003-10-14 and VDR 1.2.6

* This plugin for VDR 1.2.6 and higher requires ALSA
  0.9.0 and higher. For MP2 Audio replay functionality you may
  apply the patch for VDR 1.2.6 (vdr-1.2.6-mp2PlayAudio-v4.diff).
  The other patch (vdr-1.2.6-audio.dif) reduces the load caused
  by the EPG scanning thread and add some compile optimizations.
  Note that some parts of this patch can be already done in
  newer VDR versions. Don't patch without checking before!

* Some other plugins (old teletext plugin?) ar known to cause
  problems with audio synch loose or dropouts due to missing
  ringbuffer feature and/or time consuming scanner in the
  Receive() part instead of returning as fast as possible.

* Some older ALSA 0.9.0 beta versions have problems
  with their symbol checking if a plugin linked with
  libasound.so.2.  To avoid this a simple patch in
  plugin.c of VDR may help:

------------------------------------------------------------
--- plugin.c
+++ plugin.c	Fri Jan 17 11:52:06 2003
@@ -153,7 +153,7 @@
      esyslog("attempt to load plugin '%s' twice!", fileName);
      return false;
      }
-  handle = dlopen(fileName, RTLD_NOW);
+  handle = dlopen(fileName, RTLD_NOW|RTLD_GLOBAL);
   const char *error = dlerror();
   if (!error) {
      void *(*creator)(void);
------------------------------------------------------------

  just for completeness a patch for alsa-lib is part of
  the source tar ball.  Note that some parts of this patch
  can be already done in your alsa-lib version. Don't
  patch without checking before!

* It should be possible to do the `AC3 warpped into PCM'
  within the DVB driver (even for Live TV!) because the
  full featured cards provide a S/P-DIF out.
