"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "libisoburn/libisoburn.h" between
libisoburn-1.5.0.tar.gz and libisoburn-1.5.2.tar.gz

About: libisoburn is a frontend for the libraries libburn and libisofs which enables creation and expansion of ISO-9660 filesystems on all media and file types supported by libburn. It implements the API and command interpreter of program xorriso, and installs this program as small dynamically linked binary. xorriso is suitable for incremental data backup and for production of bootable ISO 9660 images. A statically linked version is available as GNU xorriso.

libisoburn.h  (libisoburn-1.5.0):libisoburn.h  (libisoburn-1.5.2)
#ifndef LIBISOBURN_LIBISOBURN_H_ #ifndef LIBISOBURN_LIBISOBURN_H_
#define LIBISOBURN_LIBISOBURN_H_ #define LIBISOBURN_LIBISOBURN_H_
/* /*
Lower level API definition of libisoburn. Lower level API definition of libisoburn.
Copyright 2007-2018 Vreixo Formoso Lopes <metalpain2002@yahoo.es> Copyright 2007-2009 Vreixo Formoso Lopes <metalpain2002@yahoo.es>
and Thomas Schmitt <scdbackup@gmx.net> Copyright 2007-2019 Thomas Schmitt <scdbackup@gmx.net>
Provided under GPL version 2 or later. Provided under GPL version 2 or later.
*/ */
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
/** Overview /** Overview
libisoburn is a frontend for libraries libburn and libisofs which enables libisoburn is a frontend for libraries libburn and libisofs which enables
skipping to change at line 241 skipping to change at line 241
@return 1 success, <=0 might in future become an error indication @return 1 success, <=0 might in future become an error indication
*/ */
void isoburn_version(int *major, int *minor, int *micro); void isoburn_version(int *major, int *minor, int *micro);
/** The minimum version of libisofs to be used with this version of libisoburn /** The minimum version of libisofs to be used with this version of libisoburn
at compile time. at compile time.
@since 0.1.0 @since 0.1.0
*/ */
#define isoburn_libisofs_req_major 1 #define isoburn_libisofs_req_major 1
#define isoburn_libisofs_req_minor 5 #define isoburn_libisofs_req_minor 5
#define isoburn_libisofs_req_micro 0 #define isoburn_libisofs_req_micro 2
/** The minimum version of libburn to be used with this version of libisoburn /** The minimum version of libburn to be used with this version of libisoburn
at compile time. at compile time.
@since 0.1.0 @since 0.1.0
*/ */
#define isoburn_libburn_req_major 1 #define isoburn_libburn_req_major 1
#define isoburn_libburn_req_minor 5 #define isoburn_libburn_req_minor 5
#define isoburn_libburn_req_micro 0 #define isoburn_libburn_req_micro 2
/** The minimum compile time requirements of libisoburn towards libjte are /** The minimum compile time requirements of libisoburn towards libjte are
the same as of a suitable libisofs towards libjte. the same as of a suitable libisofs towards libjte.
So use these macros from libisofs.h : So use these macros from libisofs.h :
iso_libjte_req_major iso_libjte_req_major
iso_libjte_req_minor iso_libjte_req_minor
iso_libjte_req_micro iso_libjte_req_micro
@since 0.6.4 @since 0.6.4
*/ */
skipping to change at line 301 skipping to change at line 301
*/ */
int isoburn_libburn_req(int *major, int *minor, int *micro); int isoburn_libburn_req(int *major, int *minor, int *micro);
/** These three release version numbers tell the revision of this header file /** These three release version numbers tell the revision of this header file
and of the API it describes. They are memorized by applications at build and of the API it describes. They are memorized by applications at build
time. time.
@since 0.1.0 @since 0.1.0
*/ */
#define isoburn_header_version_major 1 #define isoburn_header_version_major 1
#define isoburn_header_version_minor 5 #define isoburn_header_version_minor 5
#define isoburn_header_version_micro 0 #define isoburn_header_version_micro 2
/** Note: /** Note:
Above version numbers are also recorded in configure.ac because libtool Above version numbers are also recorded in configure.ac because libtool
wants them as parameters at build time. wants them as parameters at build time.
For the library compatibility check, ISOBURN_*_VERSION in configure.ac For the library compatibility check, ISOBURN_*_VERSION in configure.ac
are not decisive. Only the three numbers here do matter. are not decisive. Only the three numbers here do matter.
*/ */
/** Usage discussion: /** Usage discussion:
Some developers of the libburnia project have differing Some developers of the libburnia project have differing
opinions how to ensure the compatibility of libaries opinions how to ensure the compatibility of libaries
skipping to change at line 1866 skipping to change at line 1866
@param opts @param opts
The option set to be inquired. The option set to be inquired.
@param gpt @param gpt
Returns the current value. Returns the current value.
@return @return
<=0 = error, 1 = success <=0 = error, 1 = success
*/ */
int isoburn_igopt_get_appended_as_gpt(struct isoburn_imgen_opts *opts, int isoburn_igopt_get_appended_as_gpt(struct isoburn_imgen_opts *opts,
int *gpt); int *gpt);
/** Set the GPT Type GUID for a partition defined by
isoburn_igopt_set_partition_img().
@since 1.5.2
@param opts
The option set to be manipulated.
@param partition_number
Depicts the partition table entry which shall get the Type GUID.
@param guid
16 bytes of user supplied GUID. Readily byte-swapped from the text
form as prescribed by UEFI specs:
4 byte, 2 byte, 2 byte as little-endian.
2 byte, 6 byte as big-endian.
@param valid
Set to 1 to make this Type GUID valid.
Set to 0 in order to invalidate a previously made setting. In this
case MBR type 0xEF will become the EFI Type GUID. All others will
become the Basic Data Partition Type GUID.
@return
<=0 = error, 1 = success
*/
int isoburn_igopt_set_part_type_guid(struct isoburn_imgen_opts *opts,
int partition_number, uint8_t guid[16],
int valid);
/** Inquire the current settings made by isoburn_igopt_set_part_type_guid().
@since 1.5.2
@param opts
The option set to be inquired.
@param num_entries
Number of array elements in part_flags[].
@param type_guids
The array elements 0 to num_entries - 1 will get filled by the
16 flag bits of the images of the corresponding partition.
@param valids
The array elements 0 to num_entries - 1 will get filled by 1 or 0
to indicate whether the corresponding type_guids elemet is valid.
@return
<0 = error
0 = no partition image set
>0 highest used partition number
*/
int isoburn_igopt_get_part_type_guid(struct isoburn_imgen_opts *opts,
int num_entries, uint8_t guids[][16],
int valids[]);
/** Control whether partitions created by iso_write_opts_set_partition_img() /** Control whether partitions created by iso_write_opts_set_partition_img()
are to be represented in Apple Partition Map. are to be represented in Apple Partition Map.
@since 1.4.4 @since 1.4.4
@param opts @param opts
The option set to be manipulated. The option set to be manipulated.
@param apm @param apm
0= do not represent appended partitions in APM 0= do not represent appended partitions in APM
1= represent in APM, even if not 1= represent in APM, even if not
iso_write_opts_set_part_like_isohybrid() enables it and no iso_write_opts_set_part_like_isohybrid() enables it and no
other APM partitions emerge. other APM partitions emerge.
skipping to change at line 1953 skipping to change at line 1998
@param opts @param opts
The option set to be inquired. The option set to be inquired.
@param part_type @param part_type
Returns the current value: -1, 0x00 to 0xff. Returns the current value: -1, 0x00 to 0xff.
@return @return
<=0 = error, 1 = success <=0 = error, 1 = success
*/ */
int isoburn_igopt_get_iso_mbr_part_type(struct isoburn_imgen_opts *opts, int isoburn_igopt_get_iso_mbr_part_type(struct isoburn_imgen_opts *opts,
int *part_type); int *part_type);
/** Set the GPT Type GUID for the partition which represents the ISO 9660
filesystem, if such a partition emerges in GPT.
@since 1.5.2
@param opts
The option set to be manipulated.
@param guid
16 bytes of user supplied GUID. Readily byte-swapped from the text
form as prescribed by UEFI specs:
4 byte, 2 byte, 2 byte as little-endian.
2 byte, 6 byte as big-endian.
@param valid
Set to 1 to make this Type GUID valid.
Set to 0 in order to invalidate a previously made setting. In this
case the setting of isoburn_igopt_set_iso_mbr_part_type() or its
default gets into effect.
@return
<=0 = error, 1 = success
*/
int isoburn_igopt_set_iso_type_guid(struct isoburn_imgen_opts *opts,
uint8_t guid[16], int valid);
/** Inquire the current setting of isoburn_igopt_set_iso_type_guid().
@since 1.5.2
@param opts
The option set to be inquired.
@param guid
Gets filled with the 16 bytes of GUID.
@return
<= error, 0= guid is invalid, 1 = guid is valid
*/
int isoburn_igopt_get_iso_type_guid(struct isoburn_imgen_opts *opts,
uint8_t guid[16]);
/** Control whether the emerging GPT gets a pseudo-randomly generated disk GUID /** Control whether the emerging GPT gets a pseudo-randomly generated disk GUID
or whether it gets a user supplied GUID. or whether it gets a user supplied GUID.
The partition GUIDs will be generated in a reproducible way by exoring a The partition GUIDs will be generated in a reproducible way by exoring a
little-endian 32 bit counter with the disk GUID beginning at byte offset 9. little-endian 32 bit counter with the disk GUID beginning at byte offset 9.
@since 1.4.6 @since 1.4.6
@param opts @param opts
The option set to be manipulated. The option set to be manipulated.
@param guid @param guid
16 bytes of user supplied GUID. 16 bytes of user supplied GUID. Readily byte-swapped from the text
form as prescribed by UEFI specs:
4 byte, 2 byte, 2 byte as little-endian.
2 byte, 6 byte as big-endian.
The upper 4 bit of guid[6] and guid[7] should bear the value 4 to The upper 4 bit of guid[6] and guid[7] should bear the value 4 to
express the version 4 in both endiannesses. Bit 7 of byte[8] should express the version 4 in both endiannesses. Bit 7 of byte[8] should
be set to 1 and bit 6 be set to 0, in order to express the RFC 4122 be set to 1 and bit 6 be set to 0, in order to express the RFC 4122
variant of GUID, where version 4 means "random". variant of GUID, where version 4 means "random".
@param mode @param mode
0 = ignore parameter guid and produce the GPT disk GUID by a 0 = ignore parameter guid and produce the GPT disk GUID by a
pseudo-random algorithm. This is the default setting. pseudo-random algorithm. This is the default setting.
1 = use parameter guid as GPT disk GUID 1 = use parameter guid as GPT disk GUID
2 = ignore parameter guid and derive the GPT disk GUID from 2 = ignore parameter guid and derive the GPT disk GUID from
parameter uuid of isoburn_igopt_set_pvd_times(). parameter uuid of isoburn_igopt_set_pvd_times().
 End of changes. 7 change blocks. 
6 lines changed or deleted 87 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)