A computation within the environment of the data (music or file) stored on a CD. The options for affecting that environment from within are limited by design, as this library is intended for reading discs rather than authoring them.

Associates a well-typed error with human-readable context information.

Potential situations which may cause a computation to fail.

Metadata about the session in the form of (often freeform) text, providing a type-safe index to getArg. Note that not every driver type supports every item.

The key "access-mode" is handled separately by getAccessMode, to better reflect its restricted outputs.

Which instruction set should be used to communicate with the driver, providing a type-safe input for session initialization. Note that not every driver type supports every item.

A Version represents the version of a software entity.

An instance of Eq is provided, which implements exact equality modulo reordering of the tags in the versionTags field.

An instance of Ord is also provided, which gives lexicographic ordering on the versionBranch fields (i.e. 2.1 > 2.0, 1.2.3 > 1.2.2, etc.). This is expected to be sufficient for many uses, but note that you may need to use a more specific ordering for your versioning scheme. For example, some versioning schemes may include pre-releases which have tags "pre1", "pre2", and so on, and these would need to be taken into account when determining ordering. In some cases, date ordering may be more appropriate, so the application would have to look for date tags in the versionTags field and compare those. The bottom line is, don't always assume that compare and other Ord operations are the right thing for every Version.

Similarly, concrete representations of versions may differ. One possible concrete representation is provided (see showVersion and parseVersion), but depending on the application a different concrete representation may be more appropriate.

Construct tag-less Version

Since: base-4.8.0.0

Open a session to read data from the disc drive/image at the given location. If passed Nothing instead, uses the path considered "default"; on operating systems with a concept of numbered devices (e.g., Window's D: drive, FreeBSD's /dev/cd0) will usually return the first such device found to be suitable.

Open a session to read data from the disc drive/image at the given location, using a specific instruction set. If passed Nothing instead, uses the path considered "default"; on operating systems with a concept of numbered devices (e.g., Window's D: drive, FreeBSD's /dev/cd0) will usually return the first such device found to be suitable.

Use a C-style Foreign.Libcdio.Cdio object as the base to run a Haskell-style Sound.Libcdio.Cdio computation.

Note that some invariants of the monadic interface may not work as expected when used with the mutable objects.

Retrieve the session value associated with the given key. The particular case of "access-mode" is instead handled by getAccessMode.

Check what instruction set is in use for reading the disc. Other session values are handled by getArg.

The value of the preprocessor macro CDIO_VERSION, listing both the SemVar-style version of libcdio and the full architecture of the system which compiled it (e.g. 2.0.0 x86_64-pc-linux-gnu).

The value of the preprocessor macro LIBCDIO_VERSION_NUM, containing a numeric representation of the version suitable for arithmetic testing.

The value of the preprocessor macro CDIO_API_VERSION, containing a single, monotonically increasing constant representing changes to the public interface. However, as it's somewhat unclear what changes warrant bumping this number, it is typically better to use libcdioVersionNum instead.