ps3_encryption_map.h

Go to the documentation of this file.

/*
 * This file is part of the Aaru Data Preservation Suite.
 * Copyright (c) 2019-2026 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; version 2.1 of the License.
 *
 * 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
 * <https://www.gnu.org/licenses/>.
 *
 * PS3 encryption map: plaintext region parsing, serialization, and lookup.
 */
 
#ifndef LIBAARUFORMAT_PS3_ENCRYPTION_MAP_H
#define LIBAARUFORMAT_PS3_ENCRYPTION_MAP_H
 
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C"
{
#endif

typedef struct Ps3PlaintextRegion
{
    uint32_t start_sector; 
    uint32_t end_sector;   
} Ps3PlaintextRegion;
 
#define PS3_MAX_PLAINTEXT_REGIONS 64

int32_t ps3_parse_encryption_map(const uint8_t *sector0, uint32_t length, Ps3PlaintextRegion **regions,
                                 uint32_t *count);

int32_t ps3_serialize_encryption_map(const Ps3PlaintextRegion *regions, uint32_t count, uint8_t **out_data,
                                     uint32_t *out_length);

int32_t ps3_deserialize_encryption_map(const uint8_t *data, uint32_t length, Ps3PlaintextRegion **regions,
                                       uint32_t *count);

bool ps3_is_sector_encrypted(const Ps3PlaintextRegion *plaintext_regions, uint32_t region_count,
                             uint64_t sector_address);
 
#ifdef __cplusplus
}
#endif
 
#endif /* LIBAARUFORMAT_PS3_ENCRYPTION_MAP_H */