Mentioned the need to define uint32_t when including libisoburn.h

This commit is contained in:
Thomas Schmitt 2011-05-19 11:13:07 +00:00
parent 7bffde57fa
commit 30e97c7e7a
2 changed files with 32 additions and 6 deletions

View File

@ -136,15 +136,33 @@ file itself: libisoburn/libisoburn.h .
They shall link with -lisofs -lburn -lisoburn or with the .o files emerging They shall link with -lisofs -lburn -lisoburn or with the .o files emerging
from building those libraries from their sources. from building those libraries from their sources.
Applications must use 64 bit off_t, e.g. on 32-bit GNU/Linux by defining Applications must use 64 bit off_t.
E.g. on 32-bit GNU/Linux by defining
#define _LARGEFILE_SOURCE #define _LARGEFILE_SOURCE
#define _FILE_OFFSET_BITS 64 #define _FILE_OFFSET_BITS 64
or take special precautions to interface with the library by 64 bit integers The minimum requirement is to interface with the library by 64 bit signed
where above .h files prescribe off_t. Not to use 64 bit file i/o will keep integers where libisofs.h or libisoburn.h prescribe off_t.
the application from producing and processing ISO images of more than 2 GB Failure to do so may result in surprising malfunction or memory faults.
size.
Application files which include libisofs/libisofs.h or libisoburn/libisoburn.h
must provide definitions for uint32_t and uint8_t.
This can be achieved either:
- by using autotools which will define HAVE_STDINT_H or HAVE_INTTYPES_H
according to its ./configure tests,
- or by defining the macros HAVE_STDINT_H resp. HAVE_INTTYPES_H according
to the local situation,
- or by appropriately defining uint32_t and uint8_t by other means,
e.g. by including inttypes.h before including libisofs.h and libisoburn.h
*/ */
#ifdef HAVE_STDINT_H
#include <stdint.h>
#else
#ifdef HAVE_INTTYPES_H
#include <inttypes.h>
#endif
#endif
/* Important: If you add a public API function then add its name to file /* Important: If you add a public API function then add its name to file
libisoburn/libisoburn.ver libisoburn/libisoburn.ver
@ -878,6 +896,14 @@ int isoburn_ropt_set_displacement(struct isoburn_read_opts *o,
int isoburn_ropt_get_displacement(struct isoburn_read_opts *o, int isoburn_ropt_get_displacement(struct isoburn_read_opts *o,
uint32_t *displacement, int *displacement_sign); uint32_t *displacement, int *displacement_sign);
/* If you get here because of a compilation error like
/usr/include/libisoburn/libisoburn.h:895: error:
expected declaration specifiers or '...' before 'uint32_t'
then see above paragraph "Application Constraints" about the definition
of uint32_t.
*/
/** After calling function isoburn_read_image() there are informations /** After calling function isoburn_read_image() there are informations

View File

@ -1 +1 @@
#define Xorriso_timestamP "2011.05.18.063511" #define Xorriso_timestamP "2011.05.19.111229"