claunia/libcdio-osx
Archived
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

Changes to make doxygen doc better.

Browse Source
This commit is contained in:
rocky
2004-09-04 23:49:47 +00:00
parent 40332db672
commit d9c63df6ce
7 changed files with 424 additions and 278 deletions
Download Patch File Download Diff File Expand all files Collapse all files

133
include/cdio/cdio.h
View File

@@ -1,5 +1,5 @@
/* -*- c -*-
$Id: cdio.h,v 1.64 2004/08/27 11:53:38 rocky Exp $
$Id: cdio.h,v 1.65 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2001 Herbert Valerio Riedel <hvr@gnu.org>
Copyright (C) 2003, 2004 Rocky Bernstein <rocky@panix.com>
@@ -60,7 +60,8 @@ extern "C" {
#define CDIO_MMC_HW_MODEL_LEN 16 /**< length of model field */
#define CDIO_MMC_HW_REVISION_LEN 4 /**< length of revision field */
/*! Structure to return data given by the INQUIRY command */
/*! \brief Structure to return CD vendor, model, and revision-level
strings obtained via the INQUIRY command */
typedef struct cdio_hwinfo
{
char psz_vendor [CDIO_MMC_HW_VENDOR_LEN+1];
@@ -71,7 +72,7 @@ extern "C" {
/** This is an opaque structure for the CD object. */
typedef struct _CdIo CdIo;
/** This is an opaque structure for the CDTEXT object. */
/** This is an opaque structure for the CD-Text object. */
typedef struct cdtext cdtext_t;
/** The driver_id_t enumerations may be used to tag a specific driver
@@ -88,19 +89,21 @@ extern "C" {
*
*/
typedef enum {
DRIVER_UNKNOWN,
DRIVER_UNKNOWN, /**< Used as input when we don't care what kind
of driver to use. */
DRIVER_BSDI, /**< BSDI driver */
DRIVER_FREEBSD, /**< FreeBSD driver */
DRIVER_FREEBSD, /**< FreeBSD driver - includes CAM and ioctl access */
DRIVER_LINUX, /**< GNU/Linux Driver */
DRIVER_SOLARIS, /**< Sun Solaris Driver */
DRIVER_OSX, /**< Apple OSX Driver */
DRIVER_WIN32, /**< Microsoft Windows Driver */
DRIVER_WIN32, /**< Microsoft Windows Driver. Includes ASPI and
ioctl acces. */
DRIVER_CDRDAO, /**< cdrdao format CD image. This is listed
before BINCUE, to make the code prefer cdrdao
over BINCUE when both exist. */
before BIN/CUE, to make the code prefer cdrdao
over BIN/CUE when both exist. */
DRIVER_BINCUE, /**< CDRWIN BIN/CUE format CD image. This is
listed before NRG, to make the code prefer
BINCUE over NRG when both exist. */
BIN/CUE over NRG when both exist. */
DRIVER_NRG, /**< Nero NRG format CD image. */
DRIVER_DEVICE /**< Is really a set of the above; should come last */
} driver_id_t;
@@ -141,17 +144,17 @@ extern "C" {
/*!
Eject media in CD drive if there is a routine to do so.
@param cd_obj the CD object to be acted upon.
@param p_cdio the CD object to be acted upon.
@return 0 if success and 1 for failure, and 2 if no routine.
If the CD is ejected *cd_obj is freed and cd_obj set to NULL.
If the CD is ejected *p_cdio is freed and p_cdio set to NULL.
*/
int cdio_eject_media (CdIo **cd_obj);
int cdio_eject_media (CdIo **p_cdio);
/*!
Free any resources associated with cd_obj. Call this when done using cd_obj
Free any resources associated with p_cdio. Call this when done using p_cdio
and using CD reading/control operations.
@param cd_obj the CD object to eliminated.
@param p_cdio the CD object to eliminated.
*/
void cdio_destroy (CdIo *p_cdio);
@@ -170,34 +173,35 @@ extern "C" {
/*!
Get the value associatied with key.
@param cd_obj the CD object queried
@param p_cdio the CD object queried
@param key the key to retrieve
@return the value associatd with "key" or NULL if cd_obj is NULL
@return the value associatd with "key" or NULL if p_cdio is NULL
or "key" does not exist.
*/
const char * cdio_get_arg (const CdIo *cd_obj, const char key[]);
const char * cdio_get_arg (const CdIo *p_cdio, const char key[]);
/*!
Get cdtext information for a CdIo object.
Get CD-Text information for a CdIo object.
@param cd_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.
@param p_cdio the CD object that may contain CD-Text information.
@param i_track track for which we are requesting CD-Text information.
@return the CD-Text object or NULL if obj is NULL
or CD-Text information does not exist.
If i_track is 0 or CDIO_CDROM_LEADOUT_TRACK the track returned
is the information assocated with the CD.
*/
const cdtext_t *cdio_get_cdtext (CdIo *cd_obj, track_t i_track);
const cdtext_t *cdio_get_cdtext (CdIo *p_cdio, track_t i_track);
/*!
Get 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.
Get an array of device names in search_devices that have at least
the capabilities listed by the capabities parameter. 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.
If "b_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.
@@ -207,7 +211,7 @@ extern "C" {
was found.
*/
char ** cdio_get_devices_with_cap (char* ppsz_search_devices[],
cdio_fs_anal_t capabilities, bool any);
cdio_fs_anal_t capabilities, bool b_any);
/*!
Like cdio_get_devices_with_cap but we return the driver we found
@@ -216,7 +220,8 @@ extern "C" {
and speeds things up for libcdio as well.
*/
char ** cdio_get_devices_with_cap_ret (/*out*/ char* ppsz_search_devices[],
cdio_fs_anal_t capabilities, bool any,
cdio_fs_anal_t capabilities,
bool b_any,
/*out*/ driver_id_t *p_driver_id);
/*! Return an array of device names. If you want a specific
@@ -243,10 +248,10 @@ extern "C" {
/*!
Get the default CD device.
if cd_obj is NULL (we haven't initialized a specific device driver),
if p_cdio is NULL (we haven't initialized a specific device driver),
then find a suitable one and return the default device for that.
@param cd_obj the CD object queried
@param p_cdio the CD object queried
@return a string containing the default CD device or NULL is
if we couldn't get a default device.
@@ -259,8 +264,10 @@ extern "C" {
/*!
Get the what kind of device we've got.
@param cd_obj the CD object queried
@return a list of device capabilities.
@param p_cdio the CD object queried
@param p_read_cap pointer to return read capabilities
@param p_write_cap pointer to return write capabilities
@param p_misc_cap pointer to return miscellaneous other capabilities
In some situations of drivers or OS's we can't find a CD device if
there is no media in it and it is possible for this routine to return
@@ -362,35 +369,35 @@ extern "C" {
/*!
Get the starting LBA for track number
i_track in cd_obj. Track numbers usually start at something
i_track in p_cdio. Track numbers usually start at something
greater than 0, usually 1.
The "leadout" track is specified either by
using i_track CDIO_CDROM_LEADOUT_TRACK or the total tracks+1.
@param cd_obj object to get information from
@param p_cdio object to get information from
@param i_track the track number we want the LSN for
@return the starting LBA or CDIO_INVALID_LBA on error.
*/
lba_t cdio_get_track_lba(const CdIo *cd_obj, track_t i_track);
lba_t cdio_get_track_lba(const CdIo *p_cdio, track_t i_track);
/*!
Return the starting MSF (minutes/secs/frames) for track number
i_track in cd_obj. Track numbers usually start at something
i_track in p_cdio. Track numbers usually start at something
greater than 0, usually 1.
The "leadout" track is specified either by
using i_track CDIO_CDROM_LEADOUT_TRACK or the total tracks+1.
@param obj object to get information from
@param p_cdio object to get information from
@param i_track the track number we want the LSN for
@return the starting LSN or CDIO_INVALID_LSN on error.
*/
lsn_t cdio_get_track_lsn(const CdIo *cd_obj, track_t i_track);
lsn_t cdio_get_track_lsn(const CdIo *p_cdio, track_t i_track);
/*!
Return the starting MSF (minutes/secs/frames) for track number
i_track in cd_obj. Track numbers usually start at something
i_track in p_cdio. Track numbers usually start at something
greater than 0, usually 1.
The "leadout" track is specified either by
@@ -398,7 +405,7 @@ extern "C" {
@return true if things worked or false if there is no track entry.
*/
bool cdio_get_track_msf(const CdIo *cd_obj, track_t i_track,
bool cdio_get_track_msf(const CdIo *p_cdio, track_t i_track,
/*out*/ msf_t *msf);
/*!
@@ -409,19 +416,19 @@ extern "C" {
@return the number of sectors or 0 if there is an error.
*/
unsigned int cdio_get_track_sec_count(const CdIo *cd_obj, track_t i_track);
unsigned int cdio_get_track_sec_count(const CdIo *p_cdio, track_t i_track);
/*!
Reposition read offset
Similar to (if not the same as) libc's lseek()
@param cd_obj object to get information from
@param p_cdio object to get information from
@param offset amount to seek
@param whence like corresponding parameter in libc's lseek, e.g.
SEEK_SET or SEEK_END.
@return (off_t) -1 on error.
*/
off_t cdio_lseek(const CdIo *cd_obj, off_t offset, int whence);
off_t cdio_lseek(const CdIo *p_cdio, off_t offset, int whence);
/*!
Reads into buf the next size bytes.
@@ -429,36 +436,36 @@ extern "C" {
@return (ssize_t) -1 on error.
*/
ssize_t cdio_read(const CdIo *cd_obj, void *buf, size_t size);
ssize_t cdio_read(const CdIo *p_cdio, void *buf, size_t size);
/*!
Read an audio sector
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_audio_sector (const CdIo *cd_obj, void *buf, lsn_t lsn);
int cdio_read_audio_sector (const CdIo *p_cdio, void *buf, lsn_t lsn);
/*!
Reads audio sectors
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@param i_sectors number of sectors to read
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_audio_sectors (const CdIo *cd_obj, void *buf, lsn_t lsn,
int cdio_read_audio_sectors (const CdIo *p_cdio, void *buf, lsn_t lsn,
unsigned int i_sectors);
/*!
Reads a mode1 sector
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@param b_form2 true for reading mode1 form2 sectors or false for
@@ -466,13 +473,13 @@ extern "C" {
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_mode1_sector (const CdIo *cd_obj, void *buf, lsn_t lsn,
int cdio_read_mode1_sector (const CdIo *p_cdio, void *buf, lsn_t lsn,
bool b_form2);
/*!
Reads mode1 sectors
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@param b_form2 true for reading mode1 form2 sectors or false for
@@ -481,13 +488,13 @@ extern "C" {
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_mode1_sectors (const CdIo *cd_obj, void *buf, lsn_t lsn,
int cdio_read_mode1_sectors (const CdIo *p_cdio, void *buf, lsn_t lsn,
bool b_form2, unsigned int i_sectors);
/*!
Reads a mode1 sector
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@param b_form2 true for reading mode1 form2 sectors or false for
@@ -495,13 +502,13 @@ extern "C" {
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_mode2_sector (const CdIo *cd_obj, void *buf, lsn_t lsn,
int cdio_read_mode2_sector (const CdIo *p_cdio, void *buf, lsn_t lsn,
bool b_form2);
/*!
Reads mode2 sectors
@param cd_obj object to read from
@param p_cdio object to read from
@param buf place to read data into
@param lsn sector to read
@param b_form2 true for reading mode1 form2 sectors or false for
@@ -510,26 +517,26 @@ extern "C" {
@return 0 if no error, nonzero otherwise.
*/
int cdio_read_mode2_sectors (const CdIo *cd_obj, void *buf, lsn_t lsn,
int cdio_read_mode2_sectors (const CdIo *p_cdio, void *buf, lsn_t lsn,
bool b_form2, unsigned int i_sectors);
/*!
Set the arg "key" with "value" in "obj".
@param cd_obj the CD object to set
@param p_cdio the CD object to set
@param key the key to set
@param value the value to assocaiate with key
@return 0 if no error was found, and nonzero otherwise.
*/
int cdio_set_arg (CdIo *cd_obj, const char key[], const char value[]);
int cdio_set_arg (CdIo *p_cdio, const char key[], const char value[]);
/*!
Get the size of the CD in logical block address (LBA) units.
@param cd_obj the CD object queried
@param p_cdio the CD object queried
@return the size
*/
uint32_t cdio_stat_size (const CdIo *cd_obj);
uint32_t cdio_stat_size (const CdIo *p_cdio);
/*!
Initialize CD Reading and control routines. Should be called first.

8
include/cdio/cdtext.h
View File

@@ -1,5 +1,5 @@
/*
$Id: cdtext.h,v 1.6 2004/07/17 02:18:27 rocky Exp $
$Id: cdtext.h,v 1.7 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2004 Rocky Bernstein <rocky@panix.com>
adapted from cuetools
@@ -21,7 +21,7 @@
*/
/*!
* \file cdtext.h
* \brief Header CDTEXT information
* \brief Header CD-Text information
*/
@@ -36,6 +36,10 @@ extern "C" {
#define MAX_CDTEXT_FIELDS 13
/*! \brief structure for holding CD-Text information
@see cdtext_init, cdtext_destroy, cdtext_get, and cdtext_set.
*/
struct cdtext {
char *field[MAX_CDTEXT_FIELDS];
};

4
include/cdio/dvd.h
View File

@@ -1,5 +1,5 @@
/*
$Id: dvd.h,v 1.3 2004/07/28 01:09:59 rocky Exp $
$Id: dvd.h,v 1.4 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2004 Rocky Bernstein <rocky@panix.com>
Modeled after GNU/Linux definitions in linux/cdrom.h
@@ -20,7 +20,7 @@
*/
/*!
\file scsi_mmc.h
\file dvd.h
\brief Definitions for DVD access.
*/

46
include/cdio/iso9660.h
View File

@@ -1,5 +1,5 @@
/*
$Id: iso9660.h,v 1.45 2004/06/29 02:01:24 rocky Exp $
$Id: iso9660.h,v 1.46 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2000 Herbert Valerio Riedel <hvr@gnu.org>
Copyright (C) 2003, 2004 Rocky Bernstein <rocky@panix.com>
@@ -56,32 +56,35 @@
= 38 chars
\endverbatim
*/
#define LEN_ISONAME 31
#define MAX_ISONAME 37
/*! size in bytes of the filename portion + null byte */
#define LEN_ISONAME 31
/*! Max # characters in the entire ISO 9660 filename. */
#define MAX_ISONAME 37
/*! Max # characters in the entire ISO 9660 filename. */
#define MAX_ISOPATHNAME 255
/*! \def Max # characters in an perparer id. */
/*! Max # characters in an perparer id. */
#define ISO_MAX_PREPARER_ID 128
/*! \def Max # characters in an publisher id. */
/*! Max # characters in an publisher id. */
#define ISO_MAX_PUBLISHER_ID 128
/*! \def Max # characters in an application id. */
/*! Max # characters in an application id. */
#define ISO_MAX_APPLICATION_ID 128
/*! \def Max # characters in an system id. */
/*! Max # characters in an system id. */
#define ISO_MAX_SYSTEM_ID 32
/*! \def Max # characters in an volume id. */
/*! Max # characters in an volume id. */
#define ISO_MAX_VOLUME_ID 32
/*! \def Max # characters in an volumeset id. */
/*! Max # characters in an volume-set id. */
#define ISO_MAX_VOLUMESET_ID 128
/*
* ISO 9660 directory flags.
*/
/**! ISO 9660 directory flags. */
#define ISO_FILE 0 /**< Not really a flag... */
#define ISO_EXISTENCE 1 /**< Do not make existence known (hidden) */
#define ISO_DIRECTORY 2 /**< This file is a directory */
@@ -92,18 +95,23 @@
#define ISO_DRESERVED2 64 /**< Reserved bit 6 */
#define ISO_MULTIEXTENT 128 /**< Not final entry of a mult. ext. file */
/* Volume descriptor types */
/**! Volume descriptor types */
#define ISO_VD_PRIMARY 1
#define ISO_VD_SUPPLEMENTARY 2 /**< Used by Joliet */
#define ISO_VD_END 255
#define ISO_PVD_SECTOR 16 /**< Sector of Primary Volume Descriptor */
#define ISO_EVD_SECTOR 17 /**< Sector of End Volume Descriptor */
/*! Sector of Primary Volume Descriptor */
#define ISO_PVD_SECTOR 16
#define ISO_STANDARD_ID "CD001" /**< String inside track identifying an
ISO 9660 filesystem. */
#define ISO_BLOCKSIZE 2048 /**< Number of bytes in an ISO
9660 block */
/*! Sector of End Volume Descriptor */
#define ISO_EVD_SECTOR 17
/*! String inside track identifying an ISO 9660 filesystem. */
#define ISO_STANDARD_ID "CD001"
/*! Number of bytes in an ISO 9660 block */
#define ISO_BLOCKSIZE 2048
#ifdef __cplusplus
extern "C" {

4
include/cdio/logging.h
View File

@@ -1,5 +1,5 @@
/*
$Id: logging.h,v 1.8 2004/05/05 02:47:18 rocky Exp $
$Id: logging.h,v 1.9 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2000, Herbert Valerio Riedel <hvr@gnu.org>
Copyright (C) 2003, Rocky Bernstein <rocky@panix.com>
@@ -75,7 +75,7 @@ typedef void (*cdio_log_handler_t) (cdio_log_level_t level,
cdio_log_handler_t cdio_log_set_handler (cdio_log_handler_t new_handler);
/**
* Handle an message with the given log level
* Handle an message with the given log level.
*
* @see cdio_debug
* @see cdio_info

7
include/cdio/scsi_mmc.h
View File

@@ -1,5 +1,5 @@
/*
$Id: scsi_mmc.h,v 1.32 2004/08/27 02:50:13 rocky Exp $
$Id: scsi_mmc.h,v 1.33 2004/09/04 23:49:47 rocky Exp $
Copyright (C) 2003, 2004 Rocky Bernstein <rocky@panix.com>
@@ -264,13 +264,16 @@
*/
#define MAX_CDB_LEN 12
/*! A Command Descriptor Buffer (CDB) used in sending SCSI MMC
/*! \brief A Command Descriptor Buffer (CDB) used in sending SCSI MMC
commands.
*/
typedef struct scsi_mmc_cdb {
uint8_t field[MAX_CDB_LEN];
} scsi_mmc_cdb_t;
/*! \brief Format of header block in data returned from a SCSI-MMC
GET_CONFIGURATION command.
*/
typedef struct scsi_mmc_feature_list_header {
unsigned char length_msb;
unsigned char length_1sb;