summaryrefslogtreecommitdiff
path: root/contrib/libcdio/cdio.c
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/libcdio/cdio.c')
-rw-r--r--contrib/libcdio/cdio.c1125
1 files changed, 1125 insertions, 0 deletions
diff --git a/contrib/libcdio/cdio.c b/contrib/libcdio/cdio.c
new file mode 100644
index 000000000..fc18add91
--- /dev/null
+++ b/contrib/libcdio/cdio.c
@@ -0,0 +1,1125 @@
+/*
+ $Id: cdio.c,v 1.3 2005/01/01 02:43:57 rockyb Exp $
+
+ Copyright (C) 2003, 2004 Rocky Bernstein <rocky@panix.com>
+ Copyright (C) 2001 Herbert Valerio Riedel <hvr@gnu.org>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+*/
+
+
+#ifdef HAVE_CONFIG_H
+# include "config.h"
+#endif
+
+#include <sys/types.h>
+#include <sys/stat.h>
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+#include <errno.h>
+#include <string.h>
+
+#include "cdio_assert.h"
+#include <cdio/cdio.h>
+#include <cdio/cd_types.h>
+#include <cdio/util.h>
+#include <cdio/logging.h>
+#include "cdio_private.h"
+
+static const char _rcsid[] = "$Id: cdio.c,v 1.3 2005/01/01 02:43:57 rockyb Exp $";
+
+
+const char *track_format2str[6] =
+ {
+ "audio", "CD-i", "XA", "data", "PSX", "error"
+ };
+
+/* Must match discmode enumeration */
+const char *discmode2str[] = {
+ "CD-DA",
+ "CD-DATA Form 1",
+ "CD DATA Form 2",
+ "CD-ROM Mixed",
+ "DVD-ROM",
+ "DVD-RAM",
+ "DVD-R",
+ "DVD-RW",
+ "DVD+R",
+ "DVD+RW",
+ "Unknown/unclassified DVD",
+ "No information",
+ "Error in getting information"
+};
+
+
+/* The below array gives of the drivers that are currently available for
+ on a particular host. */
+
+CdIo_driver_t CdIo_driver[CDIO_MAX_DRIVER] = { {0} };
+
+/* The last valid entry of Cdio_driver.
+ -1 or (CDIO_DRIVER_UNINIT) means uninitialzed.
+ -2 means some sort of error.
+*/
+
+#define CDIO_DRIVER_UNINIT -1
+int CdIo_last_driver = CDIO_DRIVER_UNINIT;
+
+#ifdef HAVE_BSDI_CDROM
+const driver_id_t cdio_os_driver = DRIVER_BSDI;
+#elif HAVE_FREEBSD_CDROM
+const driver_id_t cdio_os_driver = DRIVER_FREEBSD;
+#elif HAVE_LINUX_CDROM
+const driver_id_t cdio_os_driver = DRIVER_LINUX;
+#elif HAVE_DARWIN_CDROM
+const driver_id_t cdio_os_driver = DRIVER_OSX;
+#elif HAVE_DARWIN_SOLARIS
+const driver_id_t cdio_os_driver = DRIVER_SOLARIS;
+#elif HAVE_DARWIN_WIN32
+const driver_id_t cdio_os_driver = DRIVER_WIN32;
+#else
+const driver_id_t cdio_os_driver = DRIVER_UNKNOWN;
+#endif
+
+static bool
+cdio_have_false(void)
+{
+ return false;
+}
+
+/* The below array gives all drivers that can possibly appear.
+ on a particular host. */
+
+CdIo_driver_t CdIo_all_drivers[CDIO_MAX_DRIVER+1] = {
+ {DRIVER_UNKNOWN,
+ 0,
+ "Unknown",
+ "No driver",
+ &cdio_have_false,
+ NULL,
+ NULL,
+ NULL,
+ NULL,
+ NULL
+ },
+
+ {DRIVER_BSDI,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK|CDIO_SRC_IS_SCSI_MASK,
+ "BSDI",
+ "BSDI ATAPI and SCSI driver",
+ &cdio_have_bsdi,
+ &cdio_open_bsdi,
+ &cdio_open_am_bsdi,
+ &cdio_get_default_device_bsdi,
+ &cdio_is_device_generic,
+ &cdio_get_devices_bsdi
+ },
+
+ {DRIVER_FREEBSD,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK|CDIO_SRC_IS_SCSI_MASK,
+ "FreeBSD",
+ "FreeBSD driver",
+ &cdio_have_freebsd,
+ &cdio_open_freebsd,
+ &cdio_open_am_freebsd,
+ &cdio_get_default_device_freebsd,
+ &cdio_is_device_generic,
+ NULL
+ },
+
+ {DRIVER_LINUX,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK,
+ "GNU/Linux",
+ "GNU/Linux ioctl and MMC driver",
+ &cdio_have_linux,
+ &cdio_open_linux,
+ &cdio_open_am_linux,
+ &cdio_get_default_device_linux,
+ &cdio_is_device_generic,
+ &cdio_get_devices_linux
+ },
+
+ {DRIVER_SOLARIS,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK|CDIO_SRC_IS_SCSI_MASK,
+ "Solaris",
+ "Solaris ATAPI and SCSI driver",
+ &cdio_have_solaris,
+ &cdio_open_solaris,
+ &cdio_open_am_solaris,
+ &cdio_get_default_device_solaris,
+ &cdio_is_device_generic,
+ &cdio_get_devices_solaris
+ },
+
+ {DRIVER_OSX,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK|CDIO_SRC_IS_SCSI_MASK,
+ "OS X",
+ "Apple Darwin OS X driver",
+ &cdio_have_osx,
+ &cdio_open_osx,
+ &cdio_open_am_osx,
+ &cdio_get_default_device_osx,
+ &cdio_is_device_generic,
+ &cdio_get_devices_osx
+ },
+
+ {DRIVER_WIN32,
+ CDIO_SRC_IS_DEVICE_MASK|CDIO_SRC_IS_NATIVE_MASK|CDIO_SRC_IS_SCSI_MASK,
+ "WIN32",
+ "MS Windows ASPI and ioctl driver",
+ &cdio_have_win32,
+ &cdio_open_win32,
+ &cdio_open_am_win32,
+ &cdio_get_default_device_win32,
+ &cdio_is_device_win32,
+ &cdio_get_devices_win32
+ },
+
+ {DRIVER_CDRDAO,
+ CDIO_SRC_IS_DISK_IMAGE_MASK,
+ "CDRDAO",
+ "cdrdao (TOC) disk image driver",
+ &cdio_have_cdrdao,
+ &cdio_open_cdrdao,
+ &cdio_open_am_cdrdao,
+ &cdio_get_default_device_cdrdao,
+ NULL,
+ &cdio_get_devices_cdrdao
+ },
+
+ {DRIVER_BINCUE,
+ CDIO_SRC_IS_DISK_IMAGE_MASK,
+ "BIN/CUE",
+ "bin/cuesheet disk image driver",
+ &cdio_have_bincue,
+ &cdio_open_bincue,
+ &cdio_open_am_bincue,
+ &cdio_get_default_device_bincue,
+ NULL,
+ &cdio_get_devices_bincue
+ },
+
+ {DRIVER_NRG,
+ CDIO_SRC_IS_DISK_IMAGE_MASK,
+ "NRG",
+ "Nero NRG disk image driver",
+ &cdio_have_nrg,
+ &cdio_open_nrg,
+ &cdio_open_am_nrg,
+ &cdio_get_default_device_nrg,
+ NULL,
+ &cdio_get_devices_nrg
+ }
+
+};
+
+static CdIo *
+scan_for_driver(driver_id_t start, driver_id_t end,
+ const char *psz_source, const char *access_mode)
+{
+ driver_id_t driver_id;
+
+ for (driver_id=start; driver_id<=end; driver_id++) {
+ if ((*CdIo_all_drivers[driver_id].have_driver)()) {
+ CdIo *ret=
+ (*CdIo_all_drivers[driver_id].driver_open_am)(psz_source, access_mode);
+ if (ret != NULL) {
+ ret->driver_id = driver_id;
+ return ret;
+ }
+ }
+ }
+ return NULL;
+}
+
+const char *
+cdio_driver_describe(driver_id_t driver_id)
+{
+ return CdIo_all_drivers[driver_id].describe;
+}
+
+/*!
+ Eject media in CD drive if there is a routine to do so.
+ Return 0 if success and 1 for failure, and 2 if no routine.
+ If the CD is ejected *obj is freed and obj set to NULL.
+ */
+int
+cdio_eject_media (CdIo **obj)
+{
+
+ if ((obj == NULL) || (*obj == NULL)) return 1;
+
+ if ((*obj)->op.eject_media) {
+ int ret = (*obj)->op.eject_media ((*obj)->env);
+ if (0 == ret) {
+ cdio_destroy(*obj);
+ *obj = NULL;
+ }
+ return ret;
+ } else {
+ cdio_destroy(*obj);
+ *obj = NULL;
+ return 2;
+ }
+}
+
+/*!
+ Free device list returned by cdio_get_devices or
+ cdio_get_devices_with_cap.
+*/
+void cdio_free_device_list (char * device_list[])
+{
+ if (NULL == device_list) return;
+ for ( ; *device_list != NULL ; device_list++ )
+ free(*device_list);
+}
+
+
+/*!
+ Return the value associatied with key. NULL is returned if obj is NULL
+ or "key" does not exist.
+ */
+const char *
+cdio_get_arg (const CdIo *obj, const char key[])
+{
+ if (obj == NULL) return NULL;
+
+ if (obj->op.get_arg) {
+ return obj->op.get_arg (obj->env, key);
+ } else {
+ return NULL;
+ }
+}
+
+/*!
+ Get cdtext information for a CdIo object .
+
+ @param obj the CD object that may contain CD-TEXT information.
+ @return the CD-TEXT object or NULL if obj is NULL
+ or CD-TEXT information does not exist.
+*/
+const cdtext_t *
+cdio_get_cdtext (CdIo *obj, track_t i_track)
+{
+ if (obj == NULL) return NULL;
+
+ if (obj->op.get_cdtext) {
+ return obj->op.get_cdtext (obj->env, i_track);
+ } else {
+ return NULL;
+ }
+}
+
+/*!
+ Return a string containing the default CD device if none is specified.
+ if CdIo is NULL (we haven't initialized a specific device driver),
+ then find a suitable one and return the default device for that.
+
+ NULL is returned if we couldn't get a default device.
+ */
+char *
+cdio_get_default_device (const CdIo *obj)
+{
+ if (obj == NULL) {
+ driver_id_t driver_id;
+ /* Scan for driver */
+ for (driver_id=DRIVER_UNKNOWN; driver_id<=CDIO_MAX_DRIVER; driver_id++) {
+ if ( (*CdIo_all_drivers[driver_id].have_driver)() &&
+ *CdIo_all_drivers[driver_id].get_default_device ) {
+ return (*CdIo_all_drivers[driver_id].get_default_device)();
+ }
+ }
+ return NULL;
+ }
+
+ if (obj->op.get_default_device) {
+ return obj->op.get_default_device ();
+ } else {
+ return NULL;
+ }
+}
+
+/*!Return an array of device names. If you want a specific
+ devices, dor a driver give that device, if you want hardware
+ devices, give DRIVER_DEVICE and if you want all possible devices,
+ image drivers and hardware drivers give DRIVER_UNKNOWN.
+
+ NULL is returned if we couldn't return a list of devices.
+*/
+char **
+cdio_get_devices (driver_id_t driver_id)
+{
+ /* Probably could get away with &driver_id below. */
+ driver_id_t driver_id_temp = driver_id;
+ return cdio_get_devices_ret (&driver_id_temp);
+}
+
+char **
+cdio_get_devices_ret (/*in/out*/ driver_id_t *p_driver_id)
+{
+ CdIo *p_cdio;
+
+ switch (*p_driver_id) {
+ /* FIXME: spit out unknown to give image drivers as well. */
+ case DRIVER_UNKNOWN:
+ case DRIVER_DEVICE:
+ p_cdio = scan_for_driver(DRIVER_UNKNOWN, CDIO_MAX_DRIVER, NULL, NULL);
+ *p_driver_id = cdio_get_driver_id(p_cdio);
+ break;
+ default:
+ return (*CdIo_all_drivers[*p_driver_id].get_devices)();
+ }
+
+ if (p_cdio == NULL) return NULL;
+ if (p_cdio->op.get_devices) {
+ char **devices = p_cdio->op.get_devices ();
+ cdio_destroy(p_cdio);
+ return devices;
+ } else {
+ return NULL;
+ }
+}
+
+/*!
+ Return an array of device names in search_devices that have at
+ least the capabilities listed by cap. If search_devices is NULL,
+ then we'll search all possible CD drives.
+
+ If "any" is set false then every capability listed in the extended
+ portion of capabilities (i.e. not the basic filesystem) must be
+ satisified. If "any" is set true, then if any of the capabilities
+ matches, we call that a success.
+
+ To find a CD-drive of any type, use the mask CDIO_FS_MATCH_ALL.
+
+ NULL is returned if we couldn't get a default device.
+ It is also possible to return a non NULL but after dereferencing the
+ the value is NULL. This also means nothing was found.
+*/
+char **
+cdio_get_devices_with_cap (/*out*/ char* search_devices[],
+ cdio_fs_anal_t capabilities, bool any)
+{
+ driver_id_t p_driver_id;
+ return cdio_get_devices_with_cap_ret (search_devices, capabilities, any,
+ &p_driver_id);
+}
+
+char **
+cdio_get_devices_with_cap_ret (/*out*/ char* search_devices[],
+ cdio_fs_anal_t capabilities, bool any,
+ /*out*/ driver_id_t *p_driver_id)
+{
+ char **drives=search_devices;
+ char **drives_ret=NULL;
+ unsigned int i_drives=0;
+
+ *p_driver_id = DRIVER_DEVICE;
+
+ if (NULL == drives) drives=cdio_get_devices_ret(p_driver_id);
+ if (NULL == drives) return NULL;
+
+ if (capabilities == CDIO_FS_MATCH_ALL) {
+ /* Duplicate drives into drives_ret. */
+ char **d = drives;
+
+ for( ; *d != NULL; d++ ) {
+ cdio_add_device_list(&drives_ret, *d, &i_drives);
+ }
+ } else {
+ cdio_fs_anal_t got_fs=0;
+ cdio_fs_anal_t need_fs = CDIO_FSTYPE(capabilities);
+ cdio_fs_anal_t need_fs_ext;
+ char **d = drives;
+ need_fs_ext = capabilities & ~CDIO_FS_MASK;
+
+ for( ; *d != NULL; d++ ) {
+ CdIo *cdio = cdio_open(*d, *p_driver_id);
+
+ if (NULL != cdio) {
+ track_t first_track = cdio_get_first_track_num(cdio);
+ cdio_iso_analysis_t cdio_iso_analysis;
+ got_fs = cdio_guess_cd_type(cdio, 0, first_track,
+ &cdio_iso_analysis);
+ /* Match on fs and add */
+ if ( (CDIO_FS_UNKNOWN == need_fs || CDIO_FSTYPE(got_fs) == need_fs) )
+ {
+ bool doit = any
+ ? (got_fs & need_fs_ext) != 0
+ : (got_fs | ~need_fs_ext) == -1;
+ if (doit)
+ cdio_add_device_list(&drives_ret, *d, &i_drives);
+ }
+
+ cdio_destroy(cdio);
+ }
+ }
+ }
+ cdio_add_device_list(&drives_ret, NULL, &i_drives);
+ cdio_free_device_list(drives);
+ free(drives);
+ return drives_ret;
+}
+
+/*!
+ Get medium associated with cd_obj.
+*/
+discmode_t
+cdio_get_discmode (CdIo *cd_obj)
+{
+ if (cd_obj == NULL) return CDIO_DISC_MODE_ERROR;
+
+ if (cd_obj->op.get_discmode) {
+ return cd_obj->op.get_discmode (cd_obj->env);
+ } else {
+ return CDIO_DISC_MODE_NO_INFO;
+ }
+}
+
+/*!
+ Return the the kind of drive capabilities of device.
+
+ Note: string is malloc'd so caller should free() then returned
+ string when done with it.
+
+ */
+void
+cdio_get_drive_cap (const CdIo *p_cdio,
+ cdio_drive_read_cap_t *p_read_cap,
+ cdio_drive_write_cap_t *p_write_cap,
+ cdio_drive_misc_cap_t *p_misc_cap)
+{
+ /* This seems like a safe bet. */
+ *p_read_cap = CDIO_DRIVE_CAP_UNKNOWN;
+ *p_write_cap = CDIO_DRIVE_CAP_UNKNOWN;
+ *p_misc_cap = CDIO_DRIVE_CAP_UNKNOWN;
+
+ if (p_cdio && p_cdio->op.get_drive_cap) {
+ p_cdio->op.get_drive_cap(p_cdio->env, p_read_cap, p_write_cap, p_misc_cap);
+ }
+}
+
+/*!
+ Return the the kind of drive capabilities of device.
+
+ Note: string is malloc'd so caller should free() then returned
+ string when done with it.
+
+ */
+void
+cdio_get_drive_cap_dev (const char *device,
+ cdio_drive_read_cap_t *p_read_cap,
+ cdio_drive_write_cap_t *p_write_cap,
+ cdio_drive_misc_cap_t *p_misc_cap)
+{
+ /* This seems like a safe bet. */
+ CdIo *cdio=scan_for_driver(CDIO_MIN_DRIVER, CDIO_MAX_DRIVER,
+ device, NULL);
+ if (cdio) {
+ cdio_get_drive_cap(cdio, p_read_cap, p_write_cap, p_misc_cap);
+ cdio_destroy(cdio);
+ } else {
+ *p_read_cap = CDIO_DRIVE_CAP_UNKNOWN;
+ *p_write_cap = CDIO_DRIVE_CAP_UNKNOWN;
+ *p_misc_cap = CDIO_DRIVE_CAP_UNKNOWN;
+ }
+}
+
+
+/*!
+ Return a string containing the name of the driver in use.
+ if CdIo is NULL (we haven't initialized a specific device driver),
+ then return NULL.
+*/
+const char *
+cdio_get_driver_name (const CdIo *cdio)
+{
+ if (NULL==cdio) return NULL;
+ return CdIo_all_drivers[cdio->driver_id].name;
+}
+
+ /*!
+ Return the driver id.
+ if CdIo is NULL (we haven't initialized a specific device driver),
+ then return DRIVER_UNKNOWN.
+ */
+driver_id_t
+cdio_get_driver_id (const CdIo *cdio)
+{
+ if (NULL==cdio) return DRIVER_UNKNOWN;
+ return cdio->driver_id;
+}
+
+
+/*!
+ Return the number of the first track.
+ CDIO_INVALID_TRACK is returned on error.
+*/
+track_t
+cdio_get_first_track_num (const CdIo *p_cdio)
+{
+ if (NULL == p_cdio) return CDIO_INVALID_TRACK;
+
+ if (p_cdio->op.get_first_track_num) {
+ return p_cdio->op.get_first_track_num (p_cdio->env);
+ } else {
+ return CDIO_INVALID_TRACK;
+ }
+}
+
+/*!
+ Return a string containing the name of the driver in use.
+ if CdIo is NULL (we haven't initialized a specific device driver),
+ then return NULL.
+*/
+bool
+cdio_get_hwinfo (const CdIo *p_cdio, cdio_hwinfo_t *hw_info)
+{
+ if (!p_cdio) return false;
+ if (p_cdio->op.get_hwinfo) {
+ return p_cdio->op.get_hwinfo (p_cdio, hw_info);
+ } else {
+ /* Perhaps driver forgot to initialize. We are no worse off Using
+ scsi_mmc than returning false here. */
+ return scsi_mmc_get_hwinfo(p_cdio, hw_info);
+ }
+}
+
+/*!
+ Return a string containing the name of the driver in use.
+ if CdIo is NULL (we haven't initialized a specific device driver),
+ then return NULL.
+*/
+char *
+cdio_get_mcn (const CdIo *p_cdio)
+{
+ if (p_cdio->op.get_mcn) {
+ return p_cdio->op.get_mcn (p_cdio->env);
+ } else {
+ return NULL;
+ }
+}
+
+/*!
+ Return the number of tracks in the current medium.
+ CDIO_INVALID_TRACK is returned on error.
+*/
+track_t
+cdio_get_num_tracks (const CdIo *p_cdio)
+{
+ if (p_cdio == NULL) return CDIO_INVALID_TRACK;
+
+ if (p_cdio->op.get_num_tracks) {
+ return p_cdio->op.get_num_tracks (p_cdio->env);
+ } else {
+ return CDIO_INVALID_TRACK;
+ }
+}
+
+/*!
+ Get format of track.
+*/
+track_format_t
+cdio_get_track_format(const CdIo *p_cdio, track_t i_track)
+{
+ cdio_assert (p_cdio != NULL);
+
+ if (p_cdio->op.get_track_format) {
+ return p_cdio->op.get_track_format (p_cdio->env, i_track);
+ } else {
+ return TRACK_FORMAT_ERROR;
+ }
+}
+
+/*!
+ Return true if we have XA data (green, mode2 form1) or
+ XA data (green, mode2 form2). That is track begins:
+ sync - header - subheader
+ 12 4 - 8
+
+ FIXME: there's gotta be a better design for this and get_track_format?
+*/
+bool
+cdio_get_track_green(const CdIo *cdio, track_t track_num)
+{
+ cdio_assert (cdio != NULL);
+
+ if (cdio->op.get_track_green) {
+ return cdio->op.get_track_green (cdio->env, track_num);
+ } else {
+ return false;
+ }
+}
+
+/*!
+ Return the starting LBA for track number
+ track_num in cdio. Tracks numbers start at 1.
+ The "leadout" track is specified either by
+ using track_num LEADOUT_TRACK or the total tracks+1.
+ CDIO_INVALID_LBA is returned on error.
+*/
+lba_t
+cdio_get_track_lba(const CdIo *cdio, track_t track_num)
+{
+ if (cdio == NULL) return CDIO_INVALID_LBA;
+
+ if (cdio->op.get_track_lba) {
+ return cdio->op.get_track_lba (cdio->env, track_num);
+ } else {
+ msf_t msf;
+ if (cdio->op.get_track_msf)
+ if (cdio_get_track_msf(cdio, track_num, &msf))
+ return cdio_msf_to_lba(&msf);
+ return CDIO_INVALID_LBA;
+ }
+}
+
+/*!
+ Return the starting LSN for track number
+ track_num in cdio. Tracks numbers start at 1.
+ The "leadout" track is specified either by
+ using track_num LEADOUT_TRACK or the total tracks+1.
+ CDIO_INVALID_LBA is returned on error.
+*/
+lsn_t
+cdio_get_track_lsn(const CdIo *cdio, track_t track_num)
+{
+ if (cdio == NULL) return CDIO_INVALID_LBA;
+
+ if (cdio->op.get_track_lba) {
+ return cdio_lba_to_lsn(cdio->op.get_track_lba (cdio->env, track_num));
+ } else {
+ msf_t msf;
+ if (cdio_get_track_msf(cdio, track_num, &msf))
+ return cdio_msf_to_lsn(&msf);
+ return CDIO_INVALID_LSN;
+ }
+}
+
+/*!
+ Return the starting MSF (minutes/secs/frames) for track number
+ track_num in cdio. Track numbers start at 1.
+ The "leadout" track is specified either by
+ using track_num LEADOUT_TRACK or the total tracks+1.
+ False is returned if there is no track entry.
+*/
+bool
+cdio_get_track_msf(const CdIo *cdio, track_t track_num, /*out*/ msf_t *msf)
+{
+ cdio_assert (cdio != NULL);
+
+ if (cdio->op.get_track_msf) {
+ return cdio->op.get_track_msf (cdio->env, track_num, msf);
+ } else if (cdio->op.get_track_lba) {
+ lba_t lba = cdio->op.get_track_lba (cdio->env, track_num);
+ if (lba == CDIO_INVALID_LBA) return false;
+ cdio_lba_to_msf(lba, msf);
+ return true;
+ } else {
+ return false;
+ }
+}
+
+/*!
+ Return the number of sectors between this track an the next. This
+ includes any pregap sectors before the start of the next track.
+ Tracks start at 1.
+ 0 is returned if there is an error.
+*/
+unsigned int
+cdio_get_track_sec_count(const CdIo *cdio, track_t track_num)
+{
+ track_t num_tracks = cdio_get_num_tracks(cdio);
+
+ if (track_num >=1 && track_num <= num_tracks)
+ return ( cdio_get_track_lba(cdio, track_num+1)
+ - cdio_get_track_lba(cdio, track_num) );
+ return 0;
+}
+
+bool
+cdio_have_driver(driver_id_t driver_id)
+{
+ return (*CdIo_all_drivers[driver_id].have_driver)();
+}
+
+/*!
+ Return the Joliet level recognized for p_cdio.
+*/
+uint8_t
+cdio_get_joliet_level(const CdIo *p_cdio)
+{
+ if (!p_cdio) return 0;
+ {
+ const generic_img_private_t *p_env
+ = (generic_img_private_t *) (p_cdio->env);
+ return p_env->i_joliet_level;
+ }
+}
+
+bool
+cdio_is_device(const char *psz_source, driver_id_t driver_id)
+{
+ if (CdIo_all_drivers[driver_id].is_device == NULL) return false;
+ return (*CdIo_all_drivers[driver_id].is_device)(psz_source);
+}
+
+
+/*!
+ Initialize CD Reading and control routines. Should be called first.
+ May be implicitly called by other routines if not called first.
+*/
+bool
+cdio_init(void)
+{
+
+ CdIo_driver_t *all_dp;
+ CdIo_driver_t *dp = CdIo_driver;
+ driver_id_t driver_id;
+
+ if (CdIo_last_driver != CDIO_DRIVER_UNINIT) {
+ cdio_warn ("Init routine called more than once.");
+ return false;
+ }
+
+ for (driver_id=DRIVER_UNKNOWN; driver_id<=CDIO_MAX_DRIVER; driver_id++) {
+ all_dp = &CdIo_all_drivers[driver_id];
+ if ((*CdIo_all_drivers[driver_id].have_driver)()) {
+ *dp++ = *all_dp;
+ CdIo_last_driver++;
+ }
+ }
+
+ return true;
+}
+
+CdIo *
+cdio_new (generic_img_private_t *p_env, cdio_funcs *p_funcs)
+{
+ CdIo *p_new_cdio = _cdio_malloc (sizeof (CdIo));
+
+ if (NULL == p_new_cdio) return NULL;
+
+ p_new_cdio->env = p_env; /* This is the private "environment" that
+ driver-dependent routines use. */
+ p_new_cdio->op = *p_funcs;
+ p_env->cdio = p_new_cdio; /* A way for the driver-dependent routines
+ to access the higher-level general cdio
+ object. */
+ return p_new_cdio;
+}
+
+/*!
+ Free any resources associated with cdio.
+*/
+void
+cdio_destroy (CdIo *cdio)
+{
+ CdIo_last_driver = CDIO_DRIVER_UNINIT;
+ if (cdio == NULL) return;
+
+ if (cdio->op.free != NULL)
+ cdio->op.free (cdio->env);
+ free (cdio);
+}
+
+/*!
+ lseek - reposition read/write file offset
+ Returns (off_t) -1 on error.
+ Similar to (if not the same as) libc's lseek()
+*/
+off_t
+cdio_lseek (const CdIo *cdio, off_t offset, int whence)
+{
+ if (cdio == NULL) return -1;
+
+ if (cdio->op.lseek)
+ return cdio->op.lseek (cdio->env, offset, whence);
+ return -1;
+}
+
+/*!
+ Reads into buf the next size bytes.
+ Returns -1 on error.
+ Similar to (if not the same as) libc's read()
+*/
+ssize_t
+cdio_read (const CdIo *p_cdio, void *buf, size_t size)
+{
+ if (p_cdio == NULL) return -1;
+
+ if (p_cdio->op.read)
+ return p_cdio->op.read (p_cdio->env, buf, size);
+ return -1;
+}
+
+/*!
+ Reads an audio sector from cd device into data starting
+ from lsn. Returns 0 if no error.
+*/
+int
+cdio_read_audio_sector (const CdIo *p_cdio, void *buf, lsn_t lsn)
+{
+
+ if (NULL == p_cdio || NULL == buf || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ if (p_cdio->op.read_audio_sectors != NULL)
+ return p_cdio->op.read_audio_sectors (p_cdio->env, buf, lsn, 1);
+ return -1;
+}
+
+/*!
+ Reads audio sectors from cd device into data starting
+ from lsn. Returns 0 if no error.
+*/
+int
+cdio_read_audio_sectors (const CdIo *p_cdio, void *buf, lsn_t lsn,
+ unsigned int nblocks)
+{
+ if ( NULL == p_cdio || NULL == buf || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ if (p_cdio->op.read_audio_sectors != NULL)
+ return p_cdio->op.read_audio_sectors (p_cdio->env, buf, lsn, nblocks);
+ return -1;
+}
+
+#ifndef SEEK_SET
+#define SEEK_SET 0
+#endif
+
+/*!
+ Reads a single mode1 form1 or form2 sector from cd device
+ into data starting from lsn. Returns 0 if no error.
+ */
+int
+cdio_read_mode1_sector (const CdIo *p_cdio, void *data, lsn_t lsn,
+ bool b_form2)
+{
+ uint32_t size = b_form2 ? M2RAW_SECTOR_SIZE : CDIO_CD_FRAMESIZE ;
+
+ if (NULL == p_cdio || NULL == data || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ if (p_cdio->op.read_mode1_sector) {
+ return p_cdio->op.read_mode1_sector(p_cdio->env, data, lsn, b_form2);
+ } else if (p_cdio->op.lseek && p_cdio->op.read) {
+ char buf[CDIO_CD_FRAMESIZE] = { 0, };
+ if (0 > cdio_lseek(p_cdio, CDIO_CD_FRAMESIZE*lsn, SEEK_SET))
+ return -1;
+ if (0 > cdio_read(p_cdio, buf, CDIO_CD_FRAMESIZE))
+ return -1;
+ memcpy (data, buf, size);
+ return 0;
+ }
+
+ return 1;
+
+}
+
+int
+cdio_read_mode1_sectors (const CdIo *cdio, void *buf, lsn_t lsn,
+ bool b_form2, unsigned int num_sectors)
+{
+
+ if (NULL == cdio || NULL == buf || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ cdio_assert (cdio->op.read_mode1_sectors != NULL);
+
+ return cdio->op.read_mode1_sectors (cdio->env, buf, lsn, b_form2,
+ num_sectors);
+}
+
+/*!
+ Reads a single mode2 sector from cd device into data starting
+ from lsn. Returns 0 if no error.
+ */
+int
+cdio_read_mode2_sector (const CdIo *cdio, void *buf, lsn_t lsn,
+ bool b_form2)
+{
+ if (NULL == cdio || NULL == buf || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ cdio_assert (cdio->op.read_mode2_sector != NULL
+ || cdio->op.read_mode2_sectors != NULL);
+
+ if (cdio->op.read_mode2_sector)
+ return cdio->op.read_mode2_sector (cdio->env, buf, lsn, b_form2);
+
+ /* fallback */
+ if (cdio->op.read_mode2_sectors != NULL)
+ return cdio_read_mode2_sectors (cdio, buf, lsn, b_form2, 1);
+ return 1;
+}
+
+int
+cdio_read_mode2_sectors (const CdIo *cdio, void *buf, lsn_t lsn,
+ bool b_form2, unsigned int num_sectors)
+{
+
+ if (NULL == cdio || NULL == buf || CDIO_INVALID_LSN == lsn )
+ return 0;
+
+ cdio_assert (cdio->op.read_mode2_sectors != NULL);
+
+ return cdio->op.read_mode2_sectors (cdio->env, buf, lsn,
+ b_form2, num_sectors);
+}
+
+uint32_t
+cdio_stat_size (const CdIo *cdio)
+{
+ cdio_assert (cdio != NULL);
+
+ return cdio->op.stat_size (cdio->env);
+}
+
+/*!
+ Set the arg "key" with "value" in the source device.
+*/
+int
+cdio_set_arg (CdIo *cdio, const char key[], const char value[])
+{
+ cdio_assert (cdio != NULL);
+ cdio_assert (cdio->op.set_arg != NULL);
+ cdio_assert (key != NULL);
+
+ return cdio->op.set_arg (cdio->env, key, value);
+}
+
+/*! Sets up to read from place specified by source_name and
+ driver_id. This should be called before using any other routine,
+ except cdio_init. This will call cdio_init, if that hasn't been
+ done previously.
+
+ NULL is returned on error.
+*/
+CdIo *
+cdio_open (const char *orig_source_name, driver_id_t driver_id)
+{
+ return cdio_open_am(orig_source_name, driver_id, NULL);
+}
+
+/*! Sets up to read from place specified by source_name and
+ driver_id. This should be called before using any other routine,
+ except cdio_init. This will call cdio_init, if that hasn't been
+ done previously.
+
+ NULL is returned on error.
+*/
+CdIo *
+cdio_open_am (const char *psz_orig_source, driver_id_t driver_id,
+ const char *psz_access_mode)
+{
+ char *psz_source;
+
+ if (CdIo_last_driver == -1) cdio_init();
+
+ if (NULL == psz_orig_source || strlen(psz_orig_source)==0)
+ psz_source = cdio_get_default_device(NULL);
+ else
+ psz_source = strdup(psz_orig_source);
+
+ switch (driver_id) {
+ case DRIVER_UNKNOWN:
+ {
+ CdIo *cdio=scan_for_driver(CDIO_MIN_DRIVER, CDIO_MAX_DRIVER,
+ psz_source, psz_access_mode);
+ free(psz_source);
+ return cdio;
+ }
+ case DRIVER_DEVICE:
+ {
+ /* Scan for a driver. */
+ CdIo *ret = cdio_open_am_cd(psz_source, psz_access_mode);
+ free(psz_source);
+ return ret;
+ }
+ break;
+ case DRIVER_BSDI:
+ case DRIVER_FREEBSD:
+ case DRIVER_LINUX:
+ case DRIVER_SOLARIS:
+ case DRIVER_WIN32:
+ case DRIVER_OSX:
+ case DRIVER_NRG:
+ case DRIVER_BINCUE:
+ case DRIVER_CDRDAO:
+ if ((*CdIo_all_drivers[driver_id].have_driver)()) {
+ CdIo *ret =
+ (*CdIo_all_drivers[driver_id].driver_open_am)(psz_source,
+ psz_access_mode);
+ if (ret) ret->driver_id = driver_id;
+ free(psz_source);
+ return ret;
+ }
+ }
+
+ free(psz_source);
+ return NULL;
+}
+
+
+/*!
+ Set up CD-ROM for reading. The device_name is
+ the some sort of device name.
+
+ @return the cdio object for subsequent operations.
+ NULL on error or there is no driver for a some sort of hardware CD-ROM.
+*/
+CdIo *
+cdio_open_cd (const char *psz_source)
+{
+ return cdio_open_am_cd(psz_source, NULL);
+}
+
+/*!
+ Set up CD-ROM for reading. The device_name is
+ the some sort of device name.
+
+ @return the cdio object for subsequent operations.
+ NULL on error or there is no driver for a some sort of hardware CD-ROM.
+*/
+/* In the future we'll have more complicated code to allow selection
+ of an I/O routine as well as code to find an appropriate default
+ routine among the "registered" routines. Possibly classes too
+ disk-based, SCSI-based, native-based, vendor (e.g. Sony, or
+ Plextor) based
+
+ For now though, we'll start more simply...
+*/
+CdIo *
+cdio_open_am_cd (const char *psz_source, const char *psz_access_mode)
+{
+ if (CdIo_last_driver == -1) cdio_init();
+
+ /* Scan for a driver. */
+ return scan_for_driver(CDIO_MIN_DEVICE_DRIVER, CDIO_MAX_DEVICE_DRIVER,
+ psz_source, psz_access_mode);
+}
+
+
+
+/*
+ * Local variables:
+ * c-file-style: "gnu"
+ * tab-width: 8
+ * indent-tabs-mode: nil
+ * End:
+ */