paranoia.h File Reference

The top-level header for libcdda_paranoia: a device- and OS- independent library for reading CD-DA with error tolerance and repair. Applications include this for paranoia access. More...

#include <cdio/cdda.h>

Go to the source code of this file.

Defines
#define	CD_FRAMEWORDS   (CDIO_CD_FRAMESIZE_RAW/2)
#define	PARANOIA_MODE_FULL   0xff
#define	PARANOIA_MODE_DISABLE   0
#define	PARANOIA_MODE_VERIFY   1
#define	PARANOIA_MODE_FRAGMENT   2
#define	PARANOIA_MODE_OVERLAP   4
#define	PARANOIA_MODE_SCRATCH   8
#define	PARANOIA_MODE_REPAIR   16
#define	PARANOIA_MODE_NEVERSKIP   32
#define	paranoia_init   cdio_paranoia_init
#define	paranoia_free   cdio_paranoia_free
#define	paranoia_modeset   cdio_paranoia_modeset
#define	paranoia_seek   cdio_paranoia_seek
#define	paranoia_read   cdio_paranoia_read
#define	paranoia_read_limited   cdio_paranoia_read_limited
#define	paranoia_overlapset   cdio_paranoia_overlapset
#define	paranoia_set_range   cdio_paranoia_read_overlapset
Enumerations
enum	paranoia_cb_mode_t {   PARANOIA_CB_READ, PARANOIA_CB_VERIFY, PARANOIA_CB_FIXUP_EDGE, PARANOIA_CB_FIXUP_ATOM,   PARANOIA_CB_SCRATCH, PARANOIA_CB_REPAIR, PARANOIA_CB_SKIP, PARANOIA_CB_DRIFT,   PARANOIA_CB_BACKOFF, PARANOIA_CB_OVERLAP, PARANOIA_CB_FIXUP_DROPPED, PARANOIA_CB_FIXUP_DUPED,   PARANOIA_CB_READERR }
Functions
cdrom_paranoia_t *	cdio_paranoia_init (cdrom_drive_t *d)
void	cdio_paranoia_free (cdrom_paranoia_t *p)
void	cdio_paranoia_modeset (cdrom_paranoia_t *p, int mode)
lsn_t	cdio_paranoia_seek (cdrom_paranoia_t *p, off_t seek, int whence)
int16_t *	cdio_paranoia_read (cdrom_paranoia_t *p, void(*callback)(long int, paranoia_cb_mode_t))
int16_t *	cdio_paranoia_read_limited (cdrom_paranoia_t *p, void(*callback)(long int, paranoia_cb_mode_t), int maxretries)
void	cdio_paranoia_overlapset (cdrom_paranoia_t *p, long overlap)
void	cdio_paranoia_set_range (cdrom_paranoia_t *p, long int start, long int end)
Variables
const char *	paranoia_cb_mode2str []

---

Detailed Description

The top-level header for libcdda_paranoia: a device- and OS- independent library for reading CD-DA with error tolerance and repair. Applications include this for paranoia access.

---

Define Documentation

#define CD_FRAMEWORDS   (CDIO_CD_FRAMESIZE_RAW/2)

Paranoia likes to work with 16-bit numbers rather than (possibly byte-swapped) bytes. So there are this many 16-bit numbers block (frame, or sector) read.

#define paranoia_free   cdio_paranoia_free

#define paranoia_init   cdio_paranoia_init

For compatibility with good ol' paranoia

#define PARANOIA_MODE_DISABLE   0

#define PARANOIA_MODE_FRAGMENT   2

#define PARANOIA_MODE_FULL   0xff

! Flags used in paranoia_modeset.

#define PARANOIA_MODE_NEVERSKIP   32

#define PARANOIA_MODE_OVERLAP   4

#define PARANOIA_MODE_REPAIR   16

#define PARANOIA_MODE_SCRATCH   8

#define PARANOIA_MODE_VERIFY   1

#define paranoia_modeset   cdio_paranoia_modeset

#define paranoia_overlapset   cdio_paranoia_overlapset

#define paranoia_read   cdio_paranoia_read

#define paranoia_read_limited   cdio_paranoia_read_limited

#define paranoia_seek   cdio_paranoia_seek

#define paranoia_set_range   cdio_paranoia_read_overlapset

---

Enumeration Type Documentation

enum paranoia_cb_mode_t

Enumerator: PARANOIA_CB_READ  PARANOIA_CB_VERIFY  PARANOIA_CB_FIXUP_EDGE  PARANOIA_CB_FIXUP_ATOM  PARANOIA_CB_SCRATCH  PARANOIA_CB_REPAIR  PARANOIA_CB_SKIP  PARANOIA_CB_DRIFT  PARANOIA_CB_BACKOFF  PARANOIA_CB_OVERLAP  PARANOIA_CB_FIXUP_DROPPED  PARANOIA_CB_FIXUP_DUPED  PARANOIA_CB_READERR

---

Function Documentation

void cdio_paranoia_free (  cdrom_paranoia_t *  p  )

Free any resources associated with obj. See also: paranoia_init.

cdrom_paranoia_t* cdio_paranoia_init (  cdrom_drive_t *  d  )

Get and initialize a new cdrom_paranoia object from cdrom_drive. Run this before calling any of the other paranoia routines below. Returns: new cdrom_paranoia object Call paranoia_free() when you are done with it

void cdio_paranoia_modeset (  cdrom_paranoia_t *  p, int  mode )

Set the kind of repair you want to on for reading. The modes are listed above

void cdio_paranoia_overlapset (  cdrom_paranoia_t *  p, long  overlap )

int16_t* cdio_paranoia_read (  cdrom_paranoia_t *  p, void(*)(long int, paranoia_cb_mode_t)  callback )

Returns: the audio data read CDIO_CD_FRAMESIZE_RAW bytes. This data is not freed by the caller, but will persist only until the next call.

int16_t* cdio_paranoia_read_limited (  cdrom_paranoia_t *  p, void(*)(long int, paranoia_cb_mode_t)  callback, int  maxretries )

The same as cdio_paranoia_read but the number of retries is set. Parameters: p  paranoia object. callback  callback routine which gets called with the status on each read. maxretries  number of times to try re-reading a block before failing. Returns: the block of CDIO_FRAMEIZE_RAW bytes (or CDIO_FRAMESIZE_RAW / 2 16-bit integers). Unless byte-swapping has been turned off the 16-bit integers Endian independent order. See also: cdio_paranoia_read.

lsn_t cdio_paranoia_seek (  cdrom_paranoia_t *  p, off_t  seek, int  whence )

reposition reading offset. Parameters: p  paranoia type seek  byte offset to seek to whence  like corresponding parameter in libc's lseek, e.g. SEEK_SET or SEEK_END.

void cdio_paranoia_set_range (  cdrom_paranoia_t *  p, long int  start, long int  end )

---

Variable Documentation

const char* paranoia_cb_mode2str[]

---