2012-01-31 01:40:22 +00:00
|
|
|
|
/*
|
2012-11-04 01:33:54 +00:00
|
|
|
|
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2008, 2012
|
2012-01-31 01:40:22 +00:00
|
|
|
|
Rocky Bernstein <rocky@gnu.org>
|
|
|
|
|
Copyright (C) 2000 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 3 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, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \file types.h
|
|
|
|
|
* \brief Common type definitions used pervasively in libcdio.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
2012-11-04 01:33:54 +00:00
|
|
|
|
#ifndef CDIO_TYPES_H_
|
|
|
|
|
#define CDIO_TYPES_H_
|
2012-01-31 01:40:22 +00:00
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
|
|
|
|
/* If <sys/types.h> is not available on your platform please
|
|
|
|
|
contact the libcdio mailing list so that we can fix it! */
|
|
|
|
|
#if !defined(ARE_THERE_STILL_ENVS_WITHOUT_SYS_TYPES)
|
|
|
|
|
#include <sys/types.h>
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#if defined(AMIGA)
|
|
|
|
|
typedef u_int8_t uint8_t;
|
|
|
|
|
typedef u_int16_t uint16_t;
|
|
|
|
|
typedef u_int32_t uint32_t;
|
|
|
|
|
typedef u_int64_t uint64_t;
|
|
|
|
|
#else
|
|
|
|
|
/* If <stdint.h> is not available on your platform please
|
|
|
|
|
contact the libcdio mailing list so that we can fix it!
|
|
|
|
|
For MSVC, you can find both a public domain stdint.h and
|
|
|
|
|
inttypes.h in the MSVC/missing directory of libcdio. */
|
|
|
|
|
#include <stdint.h>
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
typedef uint8_t ubyte;
|
|
|
|
|
|
|
|
|
|
/* MSVC does not define mode_t and ssize_t by default. The way
|
|
|
|
|
to compensate for missing UNIX types is to include a custom
|
|
|
|
|
unistd.h that defines them. Such a file is provided with
|
|
|
|
|
the libcdio source, in the MSVC/missing directory */
|
|
|
|
|
#if defined(_MSC_VER)
|
|
|
|
|
#include <unistd.h>
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/* default HP/UX macros are broken */
|
|
|
|
|
#if defined(__hpux__)
|
|
|
|
|
# undef UINT16_C
|
|
|
|
|
# undef UINT32_C
|
|
|
|
|
# undef UINT64_C
|
|
|
|
|
# undef INT64_C
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/* if it's still not defined, take a good guess... should work for
|
|
|
|
|
most 32bit and 64bit archs */
|
|
|
|
|
|
|
|
|
|
#ifndef UINT16_C
|
|
|
|
|
# define UINT16_C(c) c ## U
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef UINT32_C
|
|
|
|
|
# if defined (SIZEOF_INT) && SIZEOF_INT == 4
|
|
|
|
|
# define UINT32_C(c) c ## U
|
|
|
|
|
# elif defined (SIZEOF_LONG) && SIZEOF_LONG == 4
|
|
|
|
|
# define UINT32_C(c) c ## UL
|
|
|
|
|
# else
|
|
|
|
|
# define UINT32_C(c) c ## U
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef UINT64_C
|
|
|
|
|
# if defined (SIZEOF_LONG) && SIZEOF_LONG == 8
|
|
|
|
|
# define UINT64_C(c) c ## UL
|
|
|
|
|
# elif defined (SIZEOF_INT) && SIZEOF_INT == 8
|
|
|
|
|
# define UINT64_C(c) c ## U
|
|
|
|
|
# else
|
|
|
|
|
# define UINT64_C(c) c ## ULL
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef INT64_C
|
|
|
|
|
# if defined (SIZEOF_LONG) && SIZEOF_LONG == 8
|
|
|
|
|
# define INT64_C(c) c ## L
|
|
|
|
|
# elif defined (SIZEOF_INT) && SIZEOF_INT == 8
|
|
|
|
|
# define INT64_C(c) c
|
|
|
|
|
# else
|
|
|
|
|
# define INT64_C(c) c ## LL
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef __cplusplus
|
|
|
|
|
|
|
|
|
|
/* All the stdbool.h seem to define those */
|
|
|
|
|
#ifndef __bool_true_false_are_defined
|
|
|
|
|
#define __bool_true_false_are_defined 1
|
|
|
|
|
|
|
|
|
|
#undef bool
|
|
|
|
|
#undef true
|
|
|
|
|
#undef false
|
|
|
|
|
|
|
|
|
|
#ifdef _Bool
|
|
|
|
|
#define bool _Bool
|
|
|
|
|
#else
|
2012-11-04 01:33:54 +00:00
|
|
|
|
#define bool unsigned char
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#endif
|
|
|
|
|
#define true 1
|
|
|
|
|
#define false 0
|
|
|
|
|
|
|
|
|
|
#endif /* __bool_true_false_are_defined */
|
|
|
|
|
#endif /*C++*/
|
|
|
|
|
|
|
|
|
|
/* some GCC optimizations -- gcc 2.5+ */
|
|
|
|
|
|
|
|
|
|
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
|
|
|
|
|
#define GNUC_PRINTF( format_idx, arg_idx ) \
|
|
|
|
|
__attribute__((format (printf, format_idx, arg_idx)))
|
|
|
|
|
#define GNUC_SCANF( format_idx, arg_idx ) \
|
|
|
|
|
__attribute__((format (scanf, format_idx, arg_idx)))
|
|
|
|
|
#define GNUC_FORMAT( arg_idx ) \
|
|
|
|
|
__attribute__((format_arg (arg_idx)))
|
|
|
|
|
#define GNUC_NORETURN \
|
|
|
|
|
__attribute__((noreturn))
|
|
|
|
|
#define GNUC_CONST \
|
|
|
|
|
__attribute__((const))
|
|
|
|
|
#define GNUC_UNUSED \
|
|
|
|
|
__attribute__((unused))
|
|
|
|
|
#define GNUC_PACKED \
|
|
|
|
|
__attribute__((packed))
|
|
|
|
|
#else /* !__GNUC__ */
|
|
|
|
|
#define GNUC_PRINTF( format_idx, arg_idx )
|
|
|
|
|
#define GNUC_SCANF( format_idx, arg_idx )
|
|
|
|
|
#define GNUC_FORMAT( arg_idx )
|
|
|
|
|
#define GNUC_NORETURN
|
|
|
|
|
#define GNUC_CONST
|
|
|
|
|
#define GNUC_UNUSED
|
|
|
|
|
#define GNUC_PACKED
|
|
|
|
|
#endif /* !__GNUC__ */
|
|
|
|
|
|
2012-11-04 01:33:54 +00:00
|
|
|
|
#if defined(__MINGW32__)
|
|
|
|
|
# define PRAGMA_BEGIN_PACKED _Pragma("pack(push)") \
|
|
|
|
|
_Pragma("pack(1)")
|
|
|
|
|
# define PRAGMA_END_PACKED _Pragma("pack(pop)")
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901)
|
2012-11-04 01:33:54 +00:00
|
|
|
|
/* should work with most EDG-frontend based compilers */
|
|
|
|
|
# define PRAGMA_BEGIN_PACKED _Pragma("pack(1)")
|
|
|
|
|
# define PRAGMA_END_PACKED _Pragma("pack()")
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#elif defined(_MSC_VER)
|
2012-11-04 01:33:54 +00:00
|
|
|
|
# define PRAGMA_BEGIN_PACKED __pragma(pack(push, 1))
|
|
|
|
|
# define PRAGMA_END_PACKED __pragma(pack(pop))
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#else /* neither gcc nor _Pragma() available... */
|
2012-11-04 01:33:54 +00:00
|
|
|
|
/* ...so let's be naive and hope the regression testsuite is run... */
|
|
|
|
|
# define PRAGMA_BEGIN_PACKED
|
|
|
|
|
# define PRAGMA_END_PACKED
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* user directed static branch prediction gcc 2.96+
|
|
|
|
|
*/
|
|
|
|
|
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 95)
|
|
|
|
|
# define GNUC_LIKELY(x) __builtin_expect((x),true)
|
|
|
|
|
# define GNUC_UNLIKELY(x) __builtin_expect((x),false)
|
|
|
|
|
#else
|
|
|
|
|
# define GNUC_LIKELY(x) (x)
|
|
|
|
|
# define GNUC_UNLIKELY(x) (x)
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef NULL
|
|
|
|
|
# define NULL ((void*) 0)
|
|
|
|
|
#endif
|
2012-11-04 01:33:54 +00:00
|
|
|
|
|
|
|
|
|
/** Provide a notice for deprecated elements. Before gcc 4.5 'deprecated'
|
|
|
|
|
takes no arguments. */
|
|
|
|
|
#if defined(__GNUC__)
|
|
|
|
|
# if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ > 5)
|
|
|
|
|
# define LIBCDIO_DEPRECATED(object, notice) object __attribute__ ((deprecated(notice)))
|
|
|
|
|
# else
|
|
|
|
|
# define LIBCDIO_DEPRECATED(object, notice) object __attribute__ ((deprecated))
|
|
|
|
|
# endif
|
|
|
|
|
#elif defined(_MSC_VER)
|
|
|
|
|
#define LIBCDIO_DEPRECATED(object, notice) __declspec(deprecated(notice)) object
|
|
|
|
|
#else
|
|
|
|
|
#define LIBCDIO_DEPRECATED(object, notice)
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/** our own offsetof()-like macro */
|
2012-01-31 01:40:22 +00:00
|
|
|
|
#define __cd_offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER)
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
\brief MSF (minute/second/frame) structure
|
|
|
|
|
|
|
|
|
|
One CD-ROMs addressing scheme especially used in audio formats
|
|
|
|
|
(Red Book) is an address by minute, sector and frame which
|
|
|
|
|
BCD-encoded in three bytes. An alternative format is an lba_t.
|
|
|
|
|
|
|
|
|
|
Note: the fields in this structure are BCD encoded. Use
|
|
|
|
|
cdio_to_bcd8() or cdio_from_bcd8() to convert an integer into or
|
|
|
|
|
out of this format. The format specifier %x (not %d) can be used
|
|
|
|
|
if you need to format or print values in this structure.
|
|
|
|
|
|
|
|
|
|
@see lba_t
|
|
|
|
|
*/
|
|
|
|
|
PRAGMA_BEGIN_PACKED
|
|
|
|
|
struct msf_s {
|
|
|
|
|
uint8_t m, s, f; /* BCD encoded! */
|
|
|
|
|
} GNUC_PACKED;
|
|
|
|
|
PRAGMA_END_PACKED
|
|
|
|
|
|
|
|
|
|
typedef struct msf_s msf_t;
|
|
|
|
|
|
|
|
|
|
#define msf_t_SIZEOF 3
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
\brief UTF-8 char definition
|
|
|
|
|
|
|
|
|
|
Type to denote UTF-8 strings.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef char cdio_utf8_t;
|
|
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
|
nope = 0,
|
|
|
|
|
yep = 1,
|
|
|
|
|
dunno = 2
|
|
|
|
|
} bool_3way_t;
|
|
|
|
|
|
|
|
|
|
/* type used for bit-fields in structs (1 <= bits <= 8) */
|
|
|
|
|
#if defined(__GNUC__)
|
|
|
|
|
/* this is strict ISO C99 which allows only 'unsigned int', 'signed
|
|
|
|
|
int' and '_Bool' explicitly as bit-field type */
|
|
|
|
|
typedef unsigned int bitfield_t;
|
|
|
|
|
#else
|
|
|
|
|
/* other compilers might increase alignment requirements to match the
|
|
|
|
|
'unsigned int' type -- fixme: find out how unalignment accesses can
|
|
|
|
|
be pragma'ed on non-gcc compilers */
|
|
|
|
|
typedef uint8_t bitfield_t;
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/*! The type of a Logical Block Address. We allow for an lba to be
|
|
|
|
|
negative to be consistent with an lba, although I'm not sure this
|
|
|
|
|
this is possible.
|
|
|
|
|
|
|
|
|
|
*/
|
|
|
|
|
typedef int32_t lba_t;
|
|
|
|
|
|
|
|
|
|
/*! The type of a Logical Sector Number. Note that an lba can be negative
|
|
|
|
|
and the MMC3 specs allow for a conversion of a negative lba.
|
|
|
|
|
|
|
|
|
|
@see msf_t
|
|
|
|
|
*/
|
|
|
|
|
typedef int32_t lsn_t;
|
|
|
|
|
|
|
|
|
|
/* Address in either MSF or logical format */
|
2012-11-04 01:33:54 +00:00
|
|
|
|
union cdio_cdrom_addr
|
2012-01-31 01:40:22 +00:00
|
|
|
|
{
|
2012-11-04 01:33:54 +00:00
|
|
|
|
msf_t msf;
|
|
|
|
|
lba_t lba;
|
2012-01-31 01:40:22 +00:00
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/*! The type of a track number 0..99. */
|
|
|
|
|
typedef uint8_t track_t;
|
|
|
|
|
|
|
|
|
|
/*! The type of a session number 0..99. */
|
|
|
|
|
typedef uint8_t session_t;
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Constant for invalid session number
|
|
|
|
|
*/
|
|
|
|
|
#define CDIO_INVALID_SESSION 0xFF
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Constant for invalid LBA. It is 151 less than the most negative
|
|
|
|
|
LBA -45150. This provide slack for the 150-frame offset in
|
|
|
|
|
LBA to LSN 150 conversions
|
|
|
|
|
*/
|
|
|
|
|
#define CDIO_INVALID_LBA -45301
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Constant for invalid LSN
|
|
|
|
|
*/
|
|
|
|
|
#define CDIO_INVALID_LSN CDIO_INVALID_LBA
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Number of ASCII bytes in a media catalog number (MCN).
|
|
|
|
|
We include an extra 0 byte so these can be used as C strings.
|
|
|
|
|
*/
|
|
|
|
|
#define CDIO_MCN_SIZE 13
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Type to hold ASCII bytes in a media catalog number (MCN).
|
|
|
|
|
We include an extra 0 byte so these can be used as C strings.
|
|
|
|
|
*/
|
|
|
|
|
typedef char cdio_mcn_t[CDIO_MCN_SIZE+1];
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Number of ASCII bytes in International Standard Recording Codes (ISRC)
|
|
|
|
|
*/
|
|
|
|
|
#define CDIO_ISRC_SIZE 12
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
Type to hold ASCII bytes in a ISRC.
|
|
|
|
|
We include an extra 0 byte so these can be used as C strings.
|
|
|
|
|
*/
|
|
|
|
|
typedef char cdio_isrc_t[CDIO_ISRC_SIZE+1];
|
|
|
|
|
|
|
|
|
|
typedef int cdio_fs_anal_t;
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
|
|
track flags
|
|
|
|
|
Q Sub-channel Control Field (4.2.3.3)
|
|
|
|
|
*/
|
|
|
|
|
typedef enum {
|
2012-11-04 01:33:54 +00:00
|
|
|
|
CDIO_TRACK_FLAG_NONE = 0x00, /**< no flags set */
|
|
|
|
|
CDIO_TRACK_FLAG_PRE_EMPHASIS = 0x01, /**< audio track recorded with
|
2012-01-31 01:40:22 +00:00
|
|
|
|
pre-emphasis */
|
2012-11-04 01:33:54 +00:00
|
|
|
|
CDIO_TRACK_FLAG_COPY_PERMITTED = 0x02, /**< digital copy permitted */
|
|
|
|
|
CDIO_TRACK_FLAG_DATA = 0x04, /**< data track */
|
2012-01-31 01:40:22 +00:00
|
|
|
|
CDIO_TRACK_FLAG_FOUR_CHANNEL_AUDIO = 0x08, /**< 4 audio channels */
|
2012-11-04 01:33:54 +00:00
|
|
|
|
CDIO_TRACK_FLAG_SCMS = 0x10 /**< SCMS (5.29.2.7) */
|
2012-01-31 01:40:22 +00:00
|
|
|
|
} cdio_track_flag;
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
2012-11-04 01:33:54 +00:00
|
|
|
|
#endif /* CDIO_TYPES_H_ */
|
2012-01-31 01:40:22 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Local variables:
|
|
|
|
|
* c-file-style: "gnu"
|
|
|
|
|
* tab-width: 8
|
|
|
|
|
* indent-tabs-mode: nil
|
|
|
|
|
* End:
|
|
|
|
|
*/
|