[MPlayer-DOCS] documenting environment variables

[Giacomo Comes]

On Tue, Nov 29, 2005 at 08:57:00PM +0100, Diego Biurrun wrote:
> .IP DVDCSS_CACHE
> Directory where libdvdcss caches CSS keys.
> 
> .IP DVDCSS_METHOD
> 
> .IP DVDCSS_RAW_DEVICE
> 
> .IP DVDCSS_VERBOSE
> 
> .IP DVDREAD_NOKEYS
> 
> .IP HOME

Cut and paste from libdvdcss docs:

Some environment variables can be used to change the behaviour of libdvdcss without having to modify the program which uses it. These variables are:

    * DVDCSS_VERBOSE: sets the verbosity level.
          o 0 outputs no messages at all.
          o 1 outputs error messages to stderr.
          o 2 outputs error messages and debug messages to stderr.

    * DVDCSS_METHOD: sets the authentication and decryption method that libdvdcss will use to read scrambled discs. Can be one of title, key or disc.
          o key is the default method. libdvdcss will use a set of calculated player keys to try and get the disc key. This can fail if the drive does not recognize any of the player keys.
          o disc is a fallback method when key has failed. Instead of using player keys, libdvdcss will crack the disc key using a brute force algorithm. This process is CPU intensive and requires 64 MB of memory to store temporary data.
          o title is the fallback when all other methods have failed. It does not rely on a key exchange with the DVD drive, but rather uses a crypto attack to guess the title key. On rare cases this may fail because there is not enough encrypted data on the disc to perform a statistical attack, but in the other hand it is the only way to decrypt a DVD stored on a hard disc, or a DVD with the wrong region on an RPC2 drive.

    * DVDCSS_RAW_DEVICE: specify the raw device to use. Exact usage will depend on your operating system, the Linux utility to set up raw devices is raw(8) for instance. Please note that on most operating systems, using a raw device requires highly aligned buffers: Linux requires a 2048 bytes alignment (which is the size of a DVD sector).

    * DVDCSS_CACHE: specify a directory in which to store title key values. This will speed up descrambling of DVDs which are in the cache. The DVDCSS_CACHE directory is created if it does not exist, and a subdirectory is created named after the DVD's title or manufacturing date. If DVDCSS_CACHE is not set or is empty, libdvdcss will use the default value which is "${HOME}/.dvdcss/" under Unix and "C:\Documents and Settings\$USER\Application Data\dvdcss\" under Win32. The special value "off" disables caching.



DVDREAD_NOKEYS is MPlayer specific, but currently is not used. In the file 
libmpdvdkit2/dvd_reader.c DVDREAD_NOKEYS is used in the funcion initAllCSSKeys,
but the only place where this function is called is commented.

Giacomo