#include <aaru.h>
#include <aaruformat.h>
#include <stdio.h>
#include <stdlib.h>
#include <time.h>

Functions
int32_t	aaruf_get_media_tag_type_for_datatype (const int32_t type)
	Converts an image data type to an Aaru media tag type.
int32_t	aaruf_get_datatype_for_media_tag_type (const int32_t tag_type)
	Converts an Aaru media tag type to an image data type.
int32_t	aaruf_get_xml_mediatype (const int32_t type)
int	compare_extents (const void a, const void b)
	Comparison function for sorting DumpExtent arrays by start sector.
void	generate_random_bytes (uint8_t *buffer, size_t length)
	Generates cryptographically strong random bytes.

Function Documentation

◆ aaruf_get_datatype_for_media_tag_type()

int32_t aaruf_get_datatype_for_media_tag_type ( const int32_t tag_type )

Converts an Aaru media tag type to an image data type.

Maps the given Aaru media tag type to the corresponding image data type. This is the inverse function of aaruf_get_media_tag_type_for_datatype.

Parameters

tag_type Aaru media tag type identifier.

Returns: Corresponding image data type, or -1 if not found.

Definition at line 223 of file helpers.c.

References AARU_CALL, AARU_LOCAL, aaruf_get_datatype_for_media_tag_type(), kDataTypeAacsDataKeys, kDataTypeAacsLbaExtents, kDataTypeAacsMediaIdentifier, kDataTypeAacsMediaKey, kDataTypeAacsMkb, kDataTypeAacsSerialNumber, kDataTypeAacsVolumeIdentifier, kDataTypeAacsVolumeUniqueKey, kDataTypeAtaIdentify, kDataTypeAtapiIdentify, kDataTypeBlurayBca, kDataTypeBlurayCartridgeStatus, kDataTypeBlurayDds, kDataTypeBlurayDi, kDataTypeBluraySpareArea, kDataTypeCdAtip, kDataTypeCdFirstTrackPregap, kDataTypeCdLeadIn, kDataTypeCdLeadOut, kDataTypeCdMcn, kDataTypeCdPma, kDataTypeCdText, kDataTypeCdToc, kDataTypeCprmMkb, kDataTypeDiscControlBlock, kDataTypeDvdAdip, kDataTypeDvdBca, kDataTypeDvdCmi, kDataTypeDvdDiscKey, kDataTypeDvdDiscKeyDecrypted, kDataTypeDvddlJumpIntervalSize, kDataTypeDvddlLayerCapacity, kDataTypeDvddlManualLayerJumpLba, kDataTypeDvddlMiddleZoneAddress, kDataTypeDvdDmi, kDataTypeDvdMediaIdentifier, kDataTypeDvdMkb, kDataTypeDvdPfi, kDataTypeDvdPfi2ndLayer, kDataTypeDvdRamDds, kDataTypeDvdRamMediumStatus, kDataTypeDvdRamSpareArea, kDataTypeDvdrMediaIdentifier, kDataTypeDvdrPfi, kDataTypeDvdrPreRecordedInfo, kDataTypeDvdrRmd, kDataTypeExtendedCsd, kDataTypeFloppyLeadOut, kDataTypeFloppyWriteProtect, kDataTypeFullToc, kDataTypeHddvdCpi, kDataTypeHddvdMediumStatus, kDataTypeHybridRecognizedLayers, kDataTypeMmcCid, kDataTypeMmcCsd, kDataTypeMmcDiscInformation, kDataTypeMmcOcr, kDataTypeMmcPowResourcesInformation, kDataTypeMmcTrackResourcesInformation, kDataTypeMmcWriteProtection, kDataTypeNgcwJunkMap, kDataTypePcmciaCis, kDataTypePs3Data1, kDataTypePs3Data2, kDataTypePs3DiscKey, kDataTypePs3EncryptionMap, kDataTypePs3Pic, kDataTypeScsiInquiry, kDataTypeScsiModePage2A, kDataTypeScsiModeSense10, kDataTypeScsiModeSense6, kDataTypeSdCid, kDataTypeSdCsd, kDataTypeSdOcr, kDataTypeSdScr, kDataTypeSessionInfo, kDataTypeUsbDescriptors, kDataTypeWiiPartitionKeyMap, kDataTypeWiiUDiscKey, kDataTypeWiiUPartitionKeyMap, kDataTypeXboxDmi, kDataTypeXboxPfi, kDataTypeXboxSecuritySector, kMediaTagAacsDataKeys, kMediaTagAacsLbaExtents, kMediaTagAacsMediaIdentifier, kMediaTagAacsMediaKey, kMediaTagAacsMkb, kMediaTagAacsSerialNumber, kMediaTagAacsVolumeIdentifier, kMediaTagAacsVolumeUniqueKey, kMediaTagAtaIdentify, kMediaTagAtapiIdentify, kMediaTagBlurayBca, kMediaTagBlurayCartridgeStatus, kMediaTagBlurayDds, kMediaTagBlurayDi, kMediaTagBluraySpareArea, kMediaTagCdAtip, kMediaTagCdFirstTrackPregap, kMediaTagCdLeadIn, kMediaTagCdLeadOut, kMediaTagCdMcn, kMediaTagCdPma, kMediaTagCdText, kMediaTagCdToc, kMediaTagCprmMkb, kMediaTagDiscControlBlock, kMediaTagDvdAdip, kMediaTagDvdBca, kMediaTagDvdCmi, kMediaTagDvdDiscKey, kMediaTagDvdDiscKeyDecrypted, kMediaTagDvddlJumpIntervalSize, kMediaTagDvddlLayerCapacity, kMediaTagDvddlManualLayerJumpLba, kMediaTagDvddlMiddleZoneAddress, kMediaTagDvdDmi, kMediaTagDvdMediaIdentifier, kMediaTagDvdMkb, kMediaTagDvdPfi, kMediaTagDvdPfi2ndLayer, kMediaTagDvdRamDds, kMediaTagDvdRamMediumStatus, kMediaTagDvdRamSpareArea, kMediaTagDvdrMediaIdentifier, kMediaTagDvdrPfi, kMediaTagDvdrPreRecordedInfo, kMediaTagDvdrRmd, kMediaTagExtendedCsd, kMediaTagFloppyLeadOut, kMediaTagFloppyWriteProtect, kMediaTagFullToc, kMediaTagHddvdCpi, kMediaTagHddvdMediumStatus, kMediaTagHybridRecognizedLayers, kMediaTagMmcCid, kMediaTagMmcCsd, kMediaTagMmcDiscInformation, kMediaTagMmcOcr, kMediaTagMmcPowResourcesInformation, kMediaTagMmcTrackResourcesInformation, kMediaTagMmcWriteProtection, kMediaTagNgcwJunkMap, kMediaTagPcmciaCis, kMediaTagPs3Data1, kMediaTagPs3Data2, kMediaTagPs3DiscKey, kMediaTagPs3EncryptionMap, kMediaTagPs3Pic, kMediaTagScsiInquiry, kMediaTagScsiModePage2A, kMediaTagScsiModeSense10, kMediaTagScsiModeSense6, kMediaTagSdCid, kMediaTagSdCsd, kMediaTagSdOcr, kMediaTagSdScr, kMediaTagSessionInfo, kMediaTagUsbDescriptors, kMediaTagWiiPartitionKeyMap, kMediaTagWiiUDiscKey, kMediaTagWiiUPartitionKeyMap, kMediaTagXboxDmi, kMediaTagXboxPfi, and kMediaTagXboxSecuritySector.

Referenced by aaruf_get_datatype_for_media_tag_type(), and write_media_tags().

◆ aaruf_get_media_tag_type_for_datatype()

int32_t aaruf_get_media_tag_type_for_datatype ( const int32_t type )

Converts an image data type to an Aaru media tag type.

Maps the given image data type to the corresponding Aaru media tag type.

Parameters

type	Image data type identifier.

Returns: Corresponding Aaru media tag type, or -1 if not found.

Definition at line 39 of file helpers.c.

References AARU_CALL, AARU_LOCAL, aaruf_get_media_tag_type_for_datatype(), kDataTypeAacsDataKeys, kDataTypeAacsLbaExtents, kDataTypeAacsMediaIdentifier, kDataTypeAacsMediaKey, kDataTypeAacsMkb, kDataTypeAacsSerialNumber, kDataTypeAacsVolumeIdentifier, kDataTypeAacsVolumeUniqueKey, kDataTypeAtaIdentify, kDataTypeAtapiIdentify, kDataTypeBlurayBca, kDataTypeBlurayCartridgeStatus, kDataTypeBlurayDds, kDataTypeBlurayDi, kDataTypeBluraySpareArea, kDataTypeCdAtip, kDataTypeCdFirstTrackPregap, kDataTypeCdLeadIn, kDataTypeCdLeadOut, kDataTypeCdMcn, kDataTypeCdPma, kDataTypeCdText, kDataTypeCdToc, kDataTypeCprmMkb, kDataTypeDiscControlBlock, kDataTypeDvdAdip, kDataTypeDvdBca, kDataTypeDvdCmi, kDataTypeDvdDiscKey, kDataTypeDvdDiscKeyDecrypted, kDataTypeDvddlJumpIntervalSize, kDataTypeDvddlLayerCapacity, kDataTypeDvddlManualLayerJumpLba, kDataTypeDvddlMiddleZoneAddress, kDataTypeDvdDmi, kDataTypeDvdMediaIdentifier, kDataTypeDvdMkb, kDataTypeDvdPfi, kDataTypeDvdPfi2ndLayer, kDataTypeDvdRamDds, kDataTypeDvdRamMediumStatus, kDataTypeDvdRamSpareArea, kDataTypeDvdrMediaIdentifier, kDataTypeDvdrPfi, kDataTypeDvdrPreRecordedInfo, kDataTypeDvdrRmd, kDataTypeExtendedCsd, kDataTypeFloppyLeadOut, kDataTypeFloppyWriteProtect, kDataTypeFullToc, kDataTypeHddvdCpi, kDataTypeHddvdMediumStatus, kDataTypeHybridRecognizedLayers, kDataTypeMmcCid, kDataTypeMmcCsd, kDataTypeMmcDiscInformation, kDataTypeMmcOcr, kDataTypeMmcPowResourcesInformation, kDataTypeMmcTrackResourcesInformation, kDataTypeMmcWriteProtection, kDataTypeNgcwJunkMap, kDataTypePcmciaCis, kDataTypePs3Data1, kDataTypePs3Data2, kDataTypePs3DiscKey, kDataTypePs3EncryptionMap, kDataTypePs3Pic, kDataTypeScsiInquiry, kDataTypeScsiModePage2A, kDataTypeScsiModeSense10, kDataTypeScsiModeSense6, kDataTypeSdCid, kDataTypeSdCsd, kDataTypeSdOcr, kDataTypeSdScr, kDataTypeSessionInfo, kDataTypeUsbDescriptors, kDataTypeWiiPartitionKeyMap, kDataTypeWiiUDiscKey, kDataTypeWiiUPartitionKeyMap, kDataTypeXboxDmi, kDataTypeXboxPfi, kDataTypeXboxSecuritySector, kMediaTagAacsDataKeys, kMediaTagAacsLbaExtents, kMediaTagAacsMediaIdentifier, kMediaTagAacsMediaKey, kMediaTagAacsMkb, kMediaTagAacsSerialNumber, kMediaTagAacsVolumeIdentifier, kMediaTagAacsVolumeUniqueKey, kMediaTagAtaIdentify, kMediaTagAtapiIdentify, kMediaTagBlurayBca, kMediaTagBlurayCartridgeStatus, kMediaTagBlurayDds, kMediaTagBlurayDi, kMediaTagBluraySpareArea, kMediaTagCdAtip, kMediaTagCdFirstTrackPregap, kMediaTagCdLeadIn, kMediaTagCdLeadOut, kMediaTagCdMcn, kMediaTagCdPma, kMediaTagCdText, kMediaTagCdToc, kMediaTagCprmMkb, kMediaTagDiscControlBlock, kMediaTagDvdAdip, kMediaTagDvdBca, kMediaTagDvdCmi, kMediaTagDvdDiscKey, kMediaTagDvdDiscKeyDecrypted, kMediaTagDvddlJumpIntervalSize, kMediaTagDvddlLayerCapacity, kMediaTagDvddlManualLayerJumpLba, kMediaTagDvddlMiddleZoneAddress, kMediaTagDvdDmi, kMediaTagDvdMediaIdentifier, kMediaTagDvdMkb, kMediaTagDvdPfi, kMediaTagDvdPfi2ndLayer, kMediaTagDvdRamDds, kMediaTagDvdRamMediumStatus, kMediaTagDvdRamSpareArea, kMediaTagDvdrMediaIdentifier, kMediaTagDvdrPfi, kMediaTagDvdrPreRecordedInfo, kMediaTagDvdrRmd, kMediaTagExtendedCsd, kMediaTagFloppyLeadOut, kMediaTagFloppyWriteProtect, kMediaTagFullToc, kMediaTagHddvdCpi, kMediaTagHddvdMediumStatus, kMediaTagHybridRecognizedLayers, kMediaTagMmcCid, kMediaTagMmcCsd, kMediaTagMmcDiscInformation, kMediaTagMmcOcr, kMediaTagMmcPowResourcesInformation, kMediaTagMmcTrackResourcesInformation, kMediaTagMmcWriteProtection, kMediaTagNgcwJunkMap, kMediaTagPcmciaCis, kMediaTagPs3Data1, kMediaTagPs3Data2, kMediaTagPs3DiscKey, kMediaTagPs3EncryptionMap, kMediaTagPs3Pic, kMediaTagScsiInquiry, kMediaTagScsiModePage2A, kMediaTagScsiModeSense10, kMediaTagScsiModeSense6, kMediaTagSdCid, kMediaTagSdCsd, kMediaTagSdOcr, kMediaTagSdScr, kMediaTagSessionInfo, kMediaTagUsbDescriptors, kMediaTagWiiPartitionKeyMap, kMediaTagWiiUDiscKey, kMediaTagWiiUPartitionKeyMap, kMediaTagXboxDmi, kMediaTagXboxPfi, and kMediaTagXboxSecuritySector.

Referenced by aaruf_get_media_tag_type_for_datatype(), and process_data_block().

◆ aaruf_get_xml_mediatype()

int32_t aaruf_get_xml_mediatype ( const int32_t type )

Definition at line 399 of file helpers.c.

References AARU_CALL, AARU_LOCAL, aaruf_get_xml_mediatype(), BDR, BDRE, BDREXL, BDROM, BDRXL, BlockMedia, CBHD, CD, CD32, CDDA, CDEG, CDG, CDI, CDIREADY, CDMIDI, CDMO, CDMRW, CDPLUS, CDR, CDROM, CDROMXA, CDRW, CDTV, CDV, DDCD, DDCDR, DDCDRW, DTSCD, DVDDownload, DVDPR, DVDPRDL, DVDPRW, DVDPRWDL, DVDR, DVDRAM, DVDRDL, DVDROM, DVDRW, DVDRWDL, EVD, FDDVD, FMTOWNS, FVD, GDR, GDROM, GOD, HDDVDR, HDDVDRAM, HDDVDRDL, HDDVDROM, HDDVDRW, HDDVDRWDL, HDVMD, HVD, JaguarCD, LD, LDROM, LDROM2, LVROM, MEGACD, MegaLD, MilCD, NeoGeoCD, Nuon, OpticalDisc, PCD, PCFX, Pippin, Playdia, PS1CD, PS2CD, PS2DVD, PS3BD, PS3DVD, PS4BD, PS5BD, SACD, SATURNCD, SuperCDROM2, SVCD, SVOD, ThreeDO, UHDBD, UMD, VCD, VCDHD, VideoNow, VideoNowColor, VideoNowXp, WOD, WUOD, XGD, XGD2, XGD3, and XGD4.

Referenced by aaruf_create(), aaruf_get_xml_mediatype(), and aaruf_open().

◆ compare_extents()

int compare_extents	(	const void *	a,
		const void *	b )

Comparison function for sorting DumpExtent arrays by start sector.

This function is used by qsort() to order dump extents in ascending order based on their start sector values. Extents with lower start sectors will appear first in the sorted array. This ordering is important for efficient extent lookup and validation during image operations.

Parameters

a	Pointer to the first DumpExtent to compare.
b	Pointer to the second DumpExtent to compare.

Returns: Negative value if a->start < b->start, zero if equal, positive if a->start > b->start.

Definition at line 513 of file helpers.c.

References compare_extents(), and DumpExtent::start.

Referenced by aaruf_set_dumphw(), compare_extents(), and process_dumphw_block().

◆ generate_random_bytes()

void generate_random_bytes	(	uint8_t *	buffer,
		size_t	length )

Generates cryptographically strong random bytes.

This function fills the provided buffer with random bytes using platform-appropriate cryptographic random number generators. On Unix-like systems (including macOS and Linux), it reads from /dev/urandom. On Windows, it uses CryptGenRandom. If the platform-specific methods fail, it falls back to a time-seeded pseudo-random generator.

Parameters

buffer	Pointer to the buffer to fill with random bytes.
length	Number of random bytes to generate.

Definition at line 534 of file helpers.c.

References generate_random_bytes().

Referenced by aaruf_create(), and generate_random_bytes().

Functions

Function Documentation

◆ aaruf_get_datatype_for_media_tag_type()

◆ aaruf_get_media_tag_type_for_datatype()

◆ aaruf_get_xml_mediatype()

◆ compare_extents()

◆ generate_random_bytes()