/* * 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 "aaruformat.h" #include "internal.h" #include "log.h" void *aaruf_create(const char *filepath, uint32_t mediaType, uint32_t sectorSize, uint64_t userSectors, uint64_t negativeSectors, uint64_t overflowSectors, const char *options, const uint8_t *applicationName, uint8_t applicationNameLength, uint8_t applicationMajorVersion, uint8_t applicationMinorVersion) { TRACE("Entering aaruf_create(%s, %u, %u, %llu, %llu, %llu, %s, %s, %u, %u, %u)", filepath, mediaType, sectorSize, userSectors, negativeSectors, overflowSectors, options, applicationName ? (const char *)applicationName : "NULL", applicationNameLength, applicationMajorVersion, applicationMinorVersion); // Parse the options TRACE("Parsing options"); aaru_options parsedOptions = parse_options(options); // Allocate context TRACE("Allocating memory for context"); aaruformatContext *ctx = malloc(sizeof(aaruformatContext)); if(ctx == NULL) { FATAL("Not enough memory to create context"); errno = AARUF_ERROR_NOT_ENOUGH_MEMORY; TRACE("Exiting aaruf_create() = NULL"); return NULL; } memset(ctx, 0, sizeof(aaruformatContext)); // Create the image file TRACE("Creating image file %s", filepath); ctx->imageStream = fopen(filepath, "wb+"); if(ctx->imageStream == NULL) { FATAL("Error %d opening file %s for writing", errno, filepath); free(ctx); errno = AARUF_ERROR_CANNOT_CREATE_FILE; TRACE("Exiting aaruf_create() = NULL"); return NULL; } if(applicationNameLength > AARU_HEADER_APP_NAME_LEN) { FATAL("Application name too long (%u bytes, maximum %u bytes)", applicationNameLength, AARU_HEADER_APP_NAME_LEN); free(ctx); errno = AARUF_ERROR_INVALID_APP_NAME_LENGTH; TRACE("Exiting aaruf_create() = NULL"); return NULL; } // Initialize header TRACE("Initializing header"); ctx->header.identifier = AARU_MAGIC; memcpy(ctx->header.application, applicationName, applicationNameLength); ctx->header.imageMajorVersion = AARUF_VERSION_V2; ctx->header.imageMinorVersion = 0; ctx->header.applicationMajorVersion = applicationMajorVersion; ctx->header.applicationMinorVersion = applicationMinorVersion; ctx->header.mediaType = mediaType; ctx->header.indexOffset = 0; ctx->header.creationTime = get_filetime_uint64(); ctx->header.lastWrittenTime = get_filetime_uint64(); ctx->readableSectorTags = (bool *)malloc(sizeof(bool) * MaxSectorTag); if(ctx->readableSectorTags == NULL) { free(ctx); errno = AARUF_ERROR_NOT_ENOUGH_MEMORY; return NULL; } memset(ctx->readableSectorTags, 0, sizeof(bool) * MaxSectorTag); // Initialize image info TRACE("Initializing 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; ctx->imageInfo.ImageSize = 0; ctx->imageInfo.CreationTime = ctx->header.creationTime; ctx->imageInfo.LastModificationTime = ctx->header.lastWrittenTime; ctx->imageInfo.XmlMediaType = aaruf_get_xml_mediatype(ctx->header.mediaType); ctx->imageInfo.SectorSize = sectorSize; // 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 Compact Disc ECC"); ctx->eccCdContext = (CdEccContext *)aaruf_ecc_cd_init(); ctx->magic = AARU_MAGIC; ctx->libraryMajorVersion = LIBAARUFORMAT_MAJOR_VERSION; ctx->libraryMinorVersion = LIBAARUFORMAT_MINOR_VERSION; // Initialize DDT2 TRACE("Initializing DDT2"); ctx->inMemoryDdt = true; ctx->userDataDdtHeader.identifier = DeDuplicationTable2; ctx->userDataDdtHeader.type = UserData; ctx->userDataDdtHeader.compression = None; ctx->userDataDdtHeader.levels = 2; ctx->userDataDdtHeader.tableLevel = 0; ctx->userDataDdtHeader.previousLevelOffset = 0; ctx->userDataDdtHeader.negative = negativeSectors; ctx->userDataDdtHeader.blocks = userSectors + overflowSectors + negativeSectors; ctx->userDataDdtHeader.overflow = overflowSectors; ctx->userDataDdtHeader.start = 0; ctx->userDataDdtHeader.blockAlignmentShift = parsedOptions.block_alignment; ctx->userDataDdtHeader.dataShift = parsedOptions.data_shift; ctx->userDataDdtHeader.tableShift = parsedOptions.table_shift; ctx->userDataDdtHeader.sizeType = 1; ctx->userDataDdtHeader.entries = ctx->userDataDdtHeader.blocks / (1 << ctx->userDataDdtHeader.tableShift); if(ctx->userDataDdtHeader.blocks % (1 << ctx->userDataDdtHeader.tableShift) != 0) ctx->userDataDdtHeader.entries++; TRACE("Initializing primary/single DDT"); if(ctx->userDataDdtHeader.sizeType == SmallDdtSizeType) ctx->userDataDdtMini = (uint16_t *)calloc(ctx->userDataDdtHeader.entries, sizeof(uint16_t)); // All entries to zero else if(ctx->userDataDdtHeader.sizeType == BigDdtSizeType) ctx->userDataDdtBig = (uint32_t *)calloc(ctx->userDataDdtHeader.entries, sizeof(uint32_t)); // All entries to zero // Set the primary DDT offset (just after the header, block aligned) ctx->primaryDdtOffset = sizeof(AaruHeaderV2); // Start just after the header uint64_t alignmentMask = (1ULL << ctx->userDataDdtHeader.blockAlignmentShift) - 1; ctx->primaryDdtOffset = (ctx->primaryDdtOffset + alignmentMask) & ~alignmentMask; TRACE("Primary DDT will be placed at offset %" PRIu64, ctx->primaryDdtOffset); // Calculate size of primary DDT table uint64_t primaryTableSize = ctx->userDataDdtHeader.sizeType == SmallDdtSizeType ? ctx->userDataDdtHeader.entries * sizeof(uint16_t) : ctx->userDataDdtHeader.entries * sizeof(uint32_t); // Calculate where data blocks can start (after primary DDT + header) uint64_t dataStartPosition = ctx->primaryDdtOffset + sizeof(DdtHeader2) + primaryTableSize; ctx->nextBlockPosition = (dataStartPosition + alignmentMask) & ~alignmentMask; TRACE("Data blocks will start at position %" PRIu64, ctx->nextBlockPosition); // Position file pointer at the data start position if(fseek(ctx->imageStream, (long)ctx->nextBlockPosition, SEEK_SET) != 0) { FATAL("Could not seek to data start position"); free(ctx->readableSectorTags); if(ctx->userDataDdtMini) free(ctx->userDataDdtMini); if(ctx->userDataDdtBig) free(ctx->userDataDdtBig); utarray_free(ctx->indexEntries); free(ctx); errno = AARUF_ERROR_CANNOT_CREATE_FILE; return NULL; } // Initialize index entries array TRACE("Initializing index entries array"); UT_icd index_entry_icd = {sizeof(IndexEntry), NULL, NULL, NULL}; utarray_new(ctx->indexEntries, &index_entry_icd); if(ctx->indexEntries == NULL) { FATAL("Not enough memory to create index entries array"); free(ctx->readableSectorTags); free(ctx); errno = AARUF_ERROR_NOT_ENOUGH_MEMORY; TRACE("Exiting aaruf_create() = NULL"); return NULL; } // Is writing ctx->isWriting = true; TRACE("Exiting aaruf_create() = %p", ctx); // Return context return ctx; }