/* * This file is part of the Aaru Data Preservation Suite. * Copyright (c) 2019-2025 Natalia Portillo. * * This library is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of the * License, or (at your option) any later version. * * This library 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see . */ #include #include #include #include #include #include #include "internal.h" #include "log.h" #include "utarray.h" /** * @brief Opens an existing AaruFormat image file. * * Opens the specified image file and returns a pointer to the initialized aaruformat context. * * @param filepath Path to the image file to open. * @return Pointer to the opened aaruformat context, or NULL on failure. */ void *aaruf_open(const char *filepath) { aaruformatContext *ctx = NULL; int errorNo = 0; size_t readBytes = 0; long pos = 0; int i = 0; uint32_t signature = 0; UT_array *index_entries = NULL; #ifdef USE_SLOG #include "slog.h" slog_init("aaruformat.log", SLOG_FLAGS_ALL, 0); #endif TRACE("Logging initialized"); TRACE("Entering aaruf_open(%s)", filepath); TRACE("Allocating memory for context"); ctx = (aaruformatContext *)malloc(sizeof(aaruformatContext)); memset(ctx, 0, sizeof(aaruformatContext)); if(ctx == NULL) { FATAL("Not enough memory to create context"); errno = AARUF_ERROR_NOT_ENOUGH_MEMORY; TRACE("Exiting aaruf_open() = NULL"); return NULL; } TRACE("Opening file %s", filepath); ctx->imageStream = fopen(filepath, "rb"); if(ctx->imageStream == NULL) { FATAL("Error %d opening file %s for reading", errno, filepath); errorNo = errno; free(ctx); errno = errorNo; TRACE("Exiting aaruf_open() = NULL"); return NULL; } TRACE("Reading header at position 0"); fseek(ctx->imageStream, 0, SEEK_SET); readBytes = fread(&ctx->header, 1, sizeof(AaruHeader), ctx->imageStream); if(readBytes != sizeof(AaruHeader)) { FATAL("Could not read header"); free(ctx); errno = AARUF_ERROR_FILE_TOO_SMALL; TRACE("Exiting aaruf_open() = NULL"); return NULL; } if(ctx->header.identifier != DIC_MAGIC && ctx->header.identifier != AARU_MAGIC) { FATAL("Incorrect identifier for AaruFormat file: %8.8s", (char *)&ctx->header.identifier); free(ctx); errno = AARUF_ERROR_NOT_AARUFORMAT; TRACE("Exiting aaruf_open() = NULL"); return NULL; } // Read new header version if(ctx->header.imageMajorVersion >= AARUF_VERSION_V2) { TRACE("Reading new header version at position 0"); fseek(ctx->imageStream, 0, SEEK_SET); readBytes = fread(&ctx->header, 1, sizeof(AaruHeaderV2), ctx->imageStream); if(readBytes != sizeof(AaruHeaderV2)) { free(ctx); errno = AARUF_ERROR_FILE_TOO_SMALL; return NULL; } } if(ctx->header.imageMajorVersion > AARUF_VERSION) { FATAL("Incompatible AaruFormat version %d.%d found, maximum supported is %d.%d", ctx->header.imageMajorVersion, ctx->header.imageMinorVersion, AARUF_VERSION_V2, 0); free(ctx); errno = AARUF_ERROR_INCOMPATIBLE_VERSION; TRACE("Exiting aaruf_open() = NULL"); return NULL; } TRACE("Opening image version %d.%d", ctx->header.imageMajorVersion, ctx->header.imageMinorVersion); TRACE("Allocating memory for readable sector tags bitmap"); ctx->readableSectorTags = (bool *)malloc(sizeof(bool) * MaxSectorTag); if(ctx->readableSectorTags == NULL) { FATAL("Could not allocate memory for readable sector tags bitmap"); free(ctx); errno = AARUF_ERROR_NOT_ENOUGH_MEMORY; TRACE("Exiting aaruf_open() = NULL"); return NULL; } memset(ctx->readableSectorTags, 0, sizeof(bool) * MaxSectorTag); TRACE("Setting up image info"); ctx->imageInfo.Application = ctx->header.application; ctx->imageInfo.ApplicationVersion = (uint8_t *)malloc(32); if(ctx->imageInfo.ApplicationVersion != NULL) { memset(ctx->imageInfo.ApplicationVersion, 0, 32); sprintf((char *)ctx->imageInfo.ApplicationVersion, "%d.%d", ctx->header.applicationMajorVersion, ctx->header.applicationMinorVersion); } ctx->imageInfo.Version = (uint8_t *)malloc(32); if(ctx->imageInfo.Version != NULL) { memset(ctx->imageInfo.Version, 0, 32); sprintf((char *)ctx->imageInfo.Version, "%d.%d", ctx->header.imageMajorVersion, ctx->header.imageMinorVersion); } ctx->imageInfo.MediaType = ctx->header.mediaType; // Read the index header TRACE("Reading index header at position %" PRIu64, ctx->header.indexOffset); pos = fseek(ctx->imageStream, ctx->header.indexOffset, SEEK_SET); if(pos < 0) { free(ctx); errno = AARUF_ERROR_CANNOT_READ_INDEX; return NULL; } pos = ftell(ctx->imageStream); if(pos != ctx->header.indexOffset) { free(ctx); errno = AARUF_ERROR_CANNOT_READ_INDEX; return NULL; } readBytes = fread(&signature, 1, sizeof(uint32_t), ctx->imageStream); if(readBytes != sizeof(uint32_t) || (signature != IndexBlock && signature != IndexBlock2 && signature != IndexBlock3)) { FATAL("Could not read index header or incorrect identifier %4.4s", (char *)&signature); free(ctx); errno = AARUF_ERROR_CANNOT_READ_INDEX; TRACE("Exiting aaruf_open() = NULL"); return NULL; } if(signature == IndexBlock) index_entries = process_index_v1(ctx); else if(signature == IndexBlock2) index_entries = process_index_v2(ctx); else if(signature == IndexBlock3) index_entries = process_index_v3(ctx); if(index_entries == NULL) { FATAL("Could not process index."); utarray_free(index_entries); free(ctx); errno = AARUF_ERROR_CANNOT_READ_INDEX; TRACE("Exiting aaruf_open() = NULL"); return NULL; } TRACE("Index at %" PRIu64 " contains %d entries", ctx->header.indexOffset, utarray_len(index_entries)); for(i = 0; i < utarray_len(index_entries); i++) { IndexEntry *entry = (IndexEntry *)utarray_eltptr(index_entries, i); TRACE("Block type %4.4s with data type %d is indexed to be at %" PRIu64 "", (char *)&entry->blockType, entry->dataType, entry->offset); } bool foundUserDataDdt = false; ctx->imageInfo.ImageSize = 0; for(i = 0; i < utarray_len(index_entries); i++) { IndexEntry *entry = (IndexEntry *)utarray_eltptr(index_entries, i); pos = fseek(ctx->imageStream, entry->offset, SEEK_SET); if(pos < 0 || ftell(ctx->imageStream) != entry->offset) { TRACE("Could not seek to %" PRIu64 " as indicated by index entry %d, continuing...", entry->offset, i); continue; } TRACE("Processing block type %4.4s with data type %d at position %" PRIu64 "", (char *)&entry->blockType, entry->dataType, entry->offset); switch(entry->blockType) { case DataBlock: errorNo = process_data_block(ctx, entry); if(errorNo != AARUF_STATUS_OK) { utarray_free(index_entries); free(ctx); errno = errorNo; return NULL; } break; case DeDuplicationTable: errorNo = process_ddt_v1(ctx, entry, &foundUserDataDdt); if(errorNo != AARUF_STATUS_OK) { utarray_free(index_entries); free(ctx); errno = errorNo; return NULL; } break; case DeDuplicationTable2: errorNo = process_ddt_v2(ctx, entry, &foundUserDataDdt); if(errorNo != AARUF_STATUS_OK) { utarray_free(index_entries); free(ctx); errno = errorNo; return NULL; } break; case GeometryBlock: process_geometry_block(ctx, entry); break; case MetadataBlock: process_metadata_block(ctx, entry); break; case TracksBlock: process_tracks_block(ctx, entry); break; case CicmBlock: process_cicm_block(ctx, entry); break; // Dump hardware block case DumpHardwareBlock: process_dumphw_block(ctx, entry); break; case ChecksumBlock: process_checksum_block(ctx, entry); break; default: TRACE("Unhandled block type %4.4s with data type %d is indexed to be at %" PRIu64 "", (char *)&entry->blockType, entry->dataType, entry->offset); break; } } utarray_free(index_entries); if(!foundUserDataDdt) { FATAL("Could not find user data deduplication table, aborting..."); aaruf_close(ctx); TRACE("Exiting aaruf_open() = NULL"); return NULL; } ctx->imageInfo.CreationTime = ctx->header.creationTime; ctx->imageInfo.LastModificationTime = ctx->header.lastWrittenTime; ctx->imageInfo.XmlMediaType = aaruf_get_xml_mediatype(ctx->header.mediaType); if(ctx->geometryBlock.identifier != GeometryBlock && ctx->imageInfo.XmlMediaType == BlockMedia) { ctx->imageInfo.Cylinders = (uint32_t)(ctx->imageInfo.Sectors / 16 / 63); ctx->imageInfo.Heads = 16; ctx->imageInfo.SectorsPerTrack = 63; } // Initialize caches TRACE("Initializing caches"); ctx->blockHeaderCache.cache = NULL; ctx->blockHeaderCache.max_items = MAX_CACHE_SIZE / (ctx->imageInfo.SectorSize * (1 << ctx->shift)); ctx->blockCache.cache = NULL; ctx->blockCache.max_items = ctx->blockHeaderCache.max_items; // TODO: Cache tracks and sessions? // Initialize ECC for Compact Disc TRACE("Initializing ECC for Compact Disc"); ctx->eccCdContext = (CdEccContext *)aaruf_ecc_cd_init(); ctx->magic = AARU_MAGIC; ctx->libraryMajorVersion = LIBAARUFORMAT_MAJOR_VERSION; ctx->libraryMinorVersion = LIBAARUFORMAT_MINOR_VERSION; TRACE("Exiting aaruf_open() = %p", ctx); return ctx; }