aaru-dps/Aaru
1
0
Fork 0
mirror of https://github.com/aaru-dps/Aaru.git synced 2025-12-16 19:24:25 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
5863664dbf626677591c4d5280feb7ec925eed8d
Aaru/Aaru.Archives/Symbian/Info.cs

390 lines
15 KiB
C#
Raw Blame History

// /***************************************************************************
// Aaru Data Preservation Suite
// ----------------------------------------------------------------------------
//
// Filename : Symbian.cs
// Author(s) : Natalia Portillo <claunia@claunia.com>
//
// Component : Symbian plugin.
//
// --[ Description ] ----------------------------------------------------------
//
// Identifies Symbian installer (.sis) packages and shows information.
//
// --[ License ] --------------------------------------------------------------
//
// 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 <http://www.gnu.org/licenses/>.
//
// ----------------------------------------------------------------------------
// Copyright © 2011-2025 Natalia Portillo
// ****************************************************************************/
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Runtime.InteropServices;
using System.Text;
using Aaru.CommonTypes.Interfaces;
using Aaru.Console;
using Aaru.Helpers;
using Marshal = Aaru.Helpers.Marshal;
namespace Aaru.Archives;
public sealed partial class Symbian
{
#region IArchive Members
/// <inheritdoc />
public bool Identify(IFilter filter)
{
if(filter.DataForkLength < Marshal.SizeOf<SymbianHeader>()) return false;
Stream stream = filter.GetDataForkStream();
var hdr = new byte[Marshal.SizeOf<SymbianHeader>()];
stream.EnsureRead(hdr, 0, hdr.Length);
SymbianHeader header = Marshal.ByteArrayToStructureLittleEndian<SymbianHeader>(hdr);
if(header.uid1 == SYMBIAN9_MAGIC) return true;
if(header.uid3 != SYMBIAN_MAGIC) return false;
return header.uid2 is EPOC_MAGIC or EPOC6_MAGIC;
}
public void GetInformation(IFilter filter, Encoding encoding, out string information)
{
information = "";
var description = new StringBuilder();
var languages = new List<string>();
var capabilities = new Dictionary<uint, uint>();
Stream stream = filter.GetDataForkStream();
if(stream.Length < Marshal.SizeOf<SymbianHeader>()) return;
var buffer = new byte[Marshal.SizeOf<SymbianHeader>()];
stream.Seek(0, SeekOrigin.Begin);
stream.EnsureRead(buffer, 0, buffer.Length);
SymbianHeader sh = Marshal.ByteArrayToStructureLittleEndian<SymbianHeader>(buffer);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.uid1 = {0}", sh.uid1);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.uid2 = {0}", sh.uid2);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.uid3 = {0}", sh.uid3);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.uid4 = {0}", sh.uid4);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.crc16 = {0}", sh.crc16);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.languages = {0}", sh.languages);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.files = {0}", sh.files);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.requisites = {0}", sh.requisites);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.inst_lang = {0}", sh.inst_lang);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.inst_files = {0}", sh.inst_files);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.inst_drive = {0}", sh.inst_drive);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.capabilities = {0}", sh.capabilities);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.inst_version = {0}", sh.inst_version);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.options = {0}", sh.options);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.type = {0}", sh.type);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.major = {0}", sh.major);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.minor = {0}", sh.minor);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.variant = {0}", sh.variant);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.lang_ptr = {0}", sh.lang_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.files_ptr = {0}", sh.files_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.reqs_ptr = {0}", sh.reqs_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.certs_ptr = {0}", sh.certs_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.comp_ptr = {0}", sh.comp_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.sig_ptr = {0}", sh.sig_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.caps_ptr = {0}", sh.caps_ptr);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.instspace = {0}", sh.instspace);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.maxinsspc = {0}", sh.maxinsspc);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.reserved1 = {0}", sh.reserved1);
AaruConsole.DebugWriteLine(MODULE_NAME, "sh.reserved2 = {0}", sh.reserved2);
_release6 = false;
if(sh.uid1 == SYMBIAN9_MAGIC)
{
description.AppendLine(Localization.Symbian_Installation_File);
description.AppendLine(Localization.Symbian_9_1_or_later);
description.AppendFormat(Localization.Application_ID_0, sh.uid3).AppendLine();
_release6 = true;
description.AppendLine();
description.AppendLine("This file format is not yet implemented, no more information can be decoded.");
information = description.ToString();
return;
}
if(sh.uid3 == SYMBIAN_MAGIC)
{
description.AppendLine(Localization.Symbian_Installation_File);
switch(sh.uid2)
{
case EPOC_MAGIC:
description.AppendLine(Localization.Symbian_3_or_later);
break;
case EPOC6_MAGIC:
description.AppendLine(Localization.Symbian_6_or_later);
_release6 = true;
break;
default:
description.AppendFormat(Localization.Unknown_EPOC_magic_0, sh.uid2).AppendLine();
break;
}
description.AppendFormat(Localization.Application_ID_0, sh.uid1).AppendLine();
}
if(sh.options.HasFlag(SymbianOptions.IsUnicode))
_encoding = Encoding.Unicode;
else
_encoding = encoding ?? Encoding.GetEncoding("windows-1252");
var br = new BinaryReader(stream);
// Go to enumerate languages
br.BaseStream.Seek(sh.lang_ptr, SeekOrigin.Begin);
for(var i = 0; i < sh.languages; i++) languages.Add(((LanguageCodes)br.ReadUInt16()).ToString("G"));
// Go to component record
br.BaseStream.Seek(sh.comp_ptr, SeekOrigin.Begin);
var componentRecord = new ComponentRecord
{
names = new string[languages.Count]
};
buffer = new byte[sizeof(uint) * languages.Count];
// Read the component string lenghts
stream.EnsureRead(buffer, 0, buffer.Length);
ReadOnlySpan<byte> span = buffer;
componentRecord.namesLengths = MemoryMarshal.Cast<byte, uint>(span)[..languages.Count].ToArray();
// Read the component string pointers
stream.EnsureRead(buffer, 0, buffer.Length);
span = buffer;
componentRecord.namesPointers = MemoryMarshal.Cast<byte, uint>(span)[..languages.Count].ToArray();
for(var i = 0; i < sh.languages; i++)
{
AaruConsole.DebugWriteLine(MODULE_NAME,
"Found component name for language {0} at {1} with a length of {2} bytes",
languages[i],
componentRecord.namesPointers[i],
componentRecord.namesLengths[i]);
br.BaseStream.Seek(componentRecord.namesPointers[i], SeekOrigin.Begin);
buffer = br.ReadBytes((int)componentRecord.namesLengths[i]);
componentRecord.names[i] = _encoding.GetString(buffer);
}
// Go to capabilities (???)
br.BaseStream.Seek(sh.caps_ptr, SeekOrigin.Begin);
for(var i = 0; i < sh.capabilities; i++)
{
uint cap_Key = br.ReadUInt32();
uint cap_Value = br.ReadUInt32();
capabilities.Add(cap_Key, cap_Value);
}
description.AppendFormat(Localization.UIDs_checksum_0, sh.uid4).AppendLine();
description.AppendFormat(Localization.Archive_options_0, sh.options).AppendLine();
description.AppendFormat(Localization.CRC16_of_header_0, sh.crc16).AppendLine();
description.AppendLine();
switch(sh.type)
{
case SymbianType.Application:
description.AppendLine(Localization.SIS_contains_an_application);
break;
}
description.AppendFormat(Localization.Component_version_0_1, sh.major, sh.minor).AppendLine();
description.AppendLine();
description.AppendFormat(Localization.File_contains_0_languages, sh.languages).AppendLine();
for(var i = 0; i < languages.Count; i++)
{
if(i > 0) description.Append(", ");
description.Append($"{languages[i]}");
}
description.AppendLine();
description.AppendLine();
for(var i = 0; i < languages.Count; i++)
{
description.AppendFormat(Localization.Component_name_for_language_with_code_0_1,
languages[i],
componentRecord.names[i])
.AppendLine();
}
description.AppendLine();
description.AppendFormat(Localization.File_contains_0_files_pointer_1, sh.files, sh.files_ptr).AppendLine();
description.AppendFormat(Localization.File_contains_0_requisites, sh.requisites).AppendLine();
uint offset = sh.reqs_ptr;
if(sh.requisites > 0)
{
for(var r = 0; r < sh.requisites; r++)
{
br.BaseStream.Seek(offset, SeekOrigin.Begin);
var requisiteRecord = new RequisiteRecord
{
uid = br.ReadUInt32(),
majorVersion = br.ReadUInt16(),
minorVersion = br.ReadUInt16(),
variant = br.ReadUInt32()
};
buffer = br.ReadBytes(sizeof(uint) * languages.Count);
span = buffer;
requisiteRecord.namesLengths = MemoryMarshal.Cast<byte, uint>(span)[..languages.Count].ToArray();
buffer = br.ReadBytes(sizeof(uint) * languages.Count);
span = buffer;
requisiteRecord.namesPointers = MemoryMarshal.Cast<byte, uint>(span)[..languages.Count].ToArray();
description.AppendFormat(Localization.Requisite_0, r).AppendLine();
description.AppendFormat("\t" + Localization.Required_UID_0_version_1_2,
DecodePlatformUid(requisiteRecord.uid),
requisiteRecord.majorVersion,
requisiteRecord.minorVersion)
.AppendLine();
description.AppendFormat("\t" + Localization.Required_variant_0, requisiteRecord.variant).AppendLine();
offset = (uint)br.BaseStream.Position;
for(var i = 0; i < languages.Count; i++)
{
br.BaseStream.Seek(requisiteRecord.namesPointers[i], SeekOrigin.Begin);
buffer = br.ReadBytes((int)requisiteRecord.namesLengths[i]);
description.AppendFormat("\t" + Localization.Requisite_for_language_0_1,
languages[i],
_encoding.GetString(buffer))
.AppendLine();
}
description.AppendLine();
}
}
// description.AppendLine(Localization.Capabilities);
// foreach(KeyValuePair<uint, uint> kvp in capabilities)
// description.AppendFormat("{0} = {1}", kvp.Key, kvp.Value).AppendLine();
// Set instance values
_files = [];
_conditions = [];
uint currentFile = 0;
offset = sh.files_ptr;
var conditionLevel = 0;
_options = [];
// Get only the options records
do
{
Parse(br, ref offset, ref currentFile, sh.files, languages, ref conditionLevel, true);
} while(currentFile < sh.files);
// Get all other records
offset = sh.files_ptr;
currentFile = 0;
conditionLevel = 0;
do
{
Parse(br, ref offset, ref currentFile, sh.files, languages, ref conditionLevel, false);
} while(currentFile < sh.files);
description.AppendLine();
// Files appear on .sis in the reverse order they should be processed
_files.Reverse();
// Conditions do as well
_conditions.Reverse();
if(_files.Any(t => t.language is null))
{
description.AppendLine(Localization.Files_for_all_languages);
foreach(DecodedFileRecord file in _files.Where(t => t.language is null))
description.AppendLine($"{file.destinationName}");
description.AppendLine();
}
foreach(string lang in languages)
{
if(_files.All(t => t.language != lang)) continue;
description.AppendFormat(Localization.Files_for_0_language, lang).AppendLine();
foreach(DecodedFileRecord file in _files.Where(t => t.language == lang))
description.AppendLine($"{file.destinationName}");
description.AppendLine();
}
if(_options.Count > 0)
{
for(var i = 0; i < _options.Count; i++)
{
OptionRecord option = _options[i];
description.AppendFormat(Localization.Option_0, i + 1).AppendLine();
foreach(KeyValuePair<string, string> kvp in option.names)
{
description.AppendFormat("\t" + Localization.Name_for_language_0_1, kvp.Key, kvp.Value)
.AppendLine();
}
}
description.AppendLine();
}
if(_conditions.Count > 0)
{
description.AppendLine("Conditions:");
foreach(string condition in _conditions) description.AppendLine(condition);
}
information = description.ToString();
}
#endregion
}
Reference in New Issue View Git Blame Copy Permalink