mirror of
https://github.com/citra-emu/citra-canary.git
synced 2024-10-01 13:41:21 +00:00
410 lines
11 KiB
C++
410 lines
11 KiB
C++
// Copyright 2015 Citra Emulator Project
|
|
// Licensed under GPLv2 or any later version
|
|
// Refer to the license.txt file included.
|
|
|
|
#pragma once
|
|
|
|
#include <string>
|
|
#include "common/common_types.h"
|
|
|
|
namespace Service {
|
|
namespace FS {
|
|
enum class MediaType : u32;
|
|
}
|
|
}
|
|
|
|
namespace Service {
|
|
|
|
class Interface;
|
|
|
|
namespace AM {
|
|
|
|
namespace ErrCodes {
|
|
enum {
|
|
CIACurrentlyInstalling = 4,
|
|
InvalidTID = 31,
|
|
EmptyCIA = 32,
|
|
InvalidTIDInList = 60,
|
|
InvalidCIAHeader = 104,
|
|
};
|
|
} // namespace ErrCodes
|
|
|
|
enum class CIAInstallState : u32 {
|
|
InstallStarted,
|
|
HeaderLoaded,
|
|
CertLoaded,
|
|
TicketLoaded,
|
|
TMDLoaded,
|
|
ContentWritten,
|
|
};
|
|
|
|
/**
|
|
* Get the .tmd path for a title
|
|
* @param media_type the media the title exists on
|
|
* @param tid the title ID to get
|
|
* @param update set true if the incoming TMD should be used instead of the current TMD
|
|
* @returns string path to the .tmd file if it exists, otherwise a path to create one is given.
|
|
*/
|
|
std::string GetTitleMetadataPath(Service::FS::MediaType media_type, u64 tid, bool update = false);
|
|
|
|
/**
|
|
* Get the .app path for a title's installed content index.
|
|
* @param media_type the media the title exists on
|
|
* @param tid the title ID to get
|
|
* @param index the content index to get
|
|
* @param update set true if the incoming TMD should be used instead of the current TMD
|
|
* @returns string path to the .app file
|
|
*/
|
|
std::string GetTitleContentPath(Service::FS::MediaType media_type, u64 tid, u16 index = 0,
|
|
bool update = false);
|
|
|
|
/**
|
|
* Get the folder for a title's installed content.
|
|
* @param media_type the media the title exists on
|
|
* @param tid the title ID to get
|
|
* @returns string path to the title folder
|
|
*/
|
|
std::string GetTitlePath(Service::FS::MediaType media_type, u64 tid);
|
|
|
|
/**
|
|
* Get the title/ folder for a storage medium.
|
|
* @param media_type the storage medium to get the path for
|
|
* @returns string path to the folder
|
|
*/
|
|
std::string GetMediaTitlePath(Service::FS::MediaType media_type);
|
|
|
|
/**
|
|
* Scans the for titles in a storage medium for listing.
|
|
* @param media_type the storage medium to scan
|
|
*/
|
|
void ScanForTitles(Service::FS::MediaType media_type);
|
|
|
|
/**
|
|
* Scans all storage mediums for titles for listing.
|
|
*/
|
|
void ScanForAllTitles();
|
|
|
|
/**
|
|
* AM::GetNumPrograms service function
|
|
* Gets the number of installed titles in the requested media type
|
|
* Inputs:
|
|
* 0 : Command header (0x00010040)
|
|
* 1 : Media type to load the titles from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : The number of titles in the requested media type
|
|
*/
|
|
void GetNumPrograms(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::FindDLCContentInfos service function
|
|
* Explicitly checks that TID high value is 0004008C or an error is returned.
|
|
* Inputs:
|
|
* 1 : MediaType
|
|
* 2-3 : u64, Title ID
|
|
* 4 : Content count
|
|
* 6 : Content IDs pointer
|
|
* 8 : Content Infos pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void FindDLCContentInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::ListDLCContentInfos service function
|
|
* Explicitly checks that TID high value is 0004008C or an error is returned.
|
|
* Inputs:
|
|
* 1 : Content count
|
|
* 2 : MediaType
|
|
* 3-4 : u64, Title ID
|
|
* 5 : Start Index
|
|
* 7 : Content Infos pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Number of content infos returned
|
|
*/
|
|
void ListDLCContentInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::DeleteContents service function
|
|
* Inputs:
|
|
* 1 : MediaType
|
|
* 2-3 : u64, Title ID
|
|
* 4 : Content count
|
|
* 6 : Content IDs pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void DeleteContents(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetProgramList service function
|
|
* Loads information about the desired number of titles from the desired media type into an array
|
|
* Inputs:
|
|
* 1 : Title count
|
|
* 2 : Media type to load the titles from
|
|
* 4 : Title IDs output pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : The number of titles loaded from the requested media type
|
|
*/
|
|
void GetProgramList(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetProgramInfos service function
|
|
* Inputs:
|
|
* 1 : u8 Mediatype
|
|
* 2 : Total titles
|
|
* 4 : TitleIDList pointer
|
|
* 6 : TitleList pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void GetProgramInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetDLCTitleInfos service function
|
|
* Wrapper for AM::GetProgramInfos, explicitly checks that TID high value is 0004008C.
|
|
* Inputs:
|
|
* 1 : u8 Mediatype
|
|
* 2 : Total titles
|
|
* 4 : TitleIDList pointer
|
|
* 6 : TitleList pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void GetDLCTitleInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetPatchTitleInfos service function
|
|
* Wrapper for AM::GetProgramInfos, explicitly checks that TID high value is 0004000E.
|
|
* Inputs:
|
|
* 1 : u8 Mediatype
|
|
* 2 : Total titles
|
|
* 4 : TitleIDList input pointer
|
|
* 6 : TitleList output pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : TitleIDList input pointer
|
|
* 4 : TitleList output pointer
|
|
*/
|
|
void GetPatchTitleInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::ListDataTitleTicketInfos service function
|
|
* Inputs:
|
|
* 1 : Ticket count
|
|
* 2-3 : u64, Title ID
|
|
* 4 : Start Index?
|
|
* 5 : (TicketCount * 24) << 8 | 0x4
|
|
* 6 : Ticket Infos pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Number of ticket infos returned
|
|
*/
|
|
void ListDataTitleTicketInfos(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetDLCContentInfoCount service function
|
|
* Explicitly checks that TID high value is 0004008C or an error is returned.
|
|
* Inputs:
|
|
* 0 : Command header (0x100100C0)
|
|
* 1 : MediaType
|
|
* 2-3 : u64, Title ID
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Number of content infos plus one
|
|
*/
|
|
void GetDLCContentInfoCount(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::DeleteTicket service function
|
|
* Inputs:
|
|
* 1-2 : u64, Title ID
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void DeleteTicket(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetNumTickets service function
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Number of tickets
|
|
*/
|
|
void GetNumTickets(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetTicketList service function
|
|
* Inputs:
|
|
* 1 : Number of TicketList
|
|
* 2 : Number to skip
|
|
* 4 : TicketList pointer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Total TicketList
|
|
*/
|
|
void GetTicketList(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::QueryAvailableTitleDatabase service function
|
|
* Inputs:
|
|
* 1 : Media Type
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Boolean, database availability
|
|
*/
|
|
void QueryAvailableTitleDatabase(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::CheckContentRights service function
|
|
* Inputs:
|
|
* 1-2 : Title ID
|
|
* 3 : Content Index
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Boolean, whether we have rights to this content
|
|
*/
|
|
void CheckContentRights(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::CheckContentRightsIgnorePlatform service function
|
|
* Inputs:
|
|
* 1-2 : Title ID
|
|
* 3 : Content Index
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Boolean, whether we have rights to this content
|
|
*/
|
|
void CheckContentRightsIgnorePlatform(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::BeginImportProgram service function
|
|
* Begin importing from a CTR Installable Archive
|
|
* Inputs:
|
|
* 0 : Command header (0x04020040)
|
|
* 1 : Media type to install title to
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2-3 : CIAFile handle for application to write to
|
|
*/
|
|
void BeginImportProgram(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::EndImportProgram service function
|
|
* Finish importing from a CTR Installable Archive
|
|
* Inputs:
|
|
* 0 : Command header (0x04050002)
|
|
* 1-2 : CIAFile handle application wrote to
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void EndImportProgram(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetProgramInfoFromCia service function
|
|
* Get TitleInfo from a CIA file handle
|
|
* Inputs:
|
|
* 0 : Command header (0x04080042)
|
|
* 1 : Media type of the title
|
|
* 2-3 : File handle CIA data can be read from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2-8: TitleInfo structure
|
|
*/
|
|
void GetProgramInfoFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetSystemMenuDataFromCia service function
|
|
* Loads a CIA file's SMDH data into a specified buffer
|
|
* Inputs:
|
|
* 0 : Command header (0x04090004)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* 3-4 : Output buffer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void GetSystemMenuDataFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetDependencyListFromCia service function
|
|
* Loads a CIA's dependency list into a specified buffer
|
|
* Inputs:
|
|
* 0 : Command header (0x040A0002)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* 64-65 : Output buffer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void GetDependencyListFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetTransferSizeFromCia service function
|
|
* Returns the total expected transfer size up to the CIA meta offset from a CIA
|
|
* Inputs:
|
|
* 0 : Command header (0x040B0002)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2-3 : Transfer size
|
|
*/
|
|
void GetTransferSizeFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetCoreVersionFromCia service function
|
|
* Returns the core version from a CIA
|
|
* Inputs:
|
|
* 0 : Command header (0x040C0002)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Core version
|
|
*/
|
|
void GetCoreVersionFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetRequiredSizeFromCia service function
|
|
* Returns the required amount of free space required to install a given CIA file
|
|
* Inputs:
|
|
* 0 : Command header (0x040D0042)
|
|
* 1 : Media type to install title to
|
|
* 2-3 : File handle CIA data can be read from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2-3 : Required free space for CIA
|
|
*/
|
|
void GetRequiredSizeFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetMetaSizeFromCia service function
|
|
* Returns the size of a given CIA's meta section
|
|
* Inputs:
|
|
* 0 : Command header (0x04130002)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
* 2 : Meta section size
|
|
*/
|
|
void GetMetaSizeFromCia(Service::Interface* self);
|
|
|
|
/**
|
|
* AM::GetMetaDataFromCia service function
|
|
* Loads meta section data from a CIA file into a given buffer
|
|
* Inputs:
|
|
* 0 : Command header (0x04140044)
|
|
* 1-2 : File handle CIA data can be read from
|
|
* 3-4 : Output buffer
|
|
* Outputs:
|
|
* 1 : Result, 0 on success, otherwise error code
|
|
*/
|
|
void GetMetaDataFromCia(Service::Interface* self);
|
|
|
|
/// Initialize AM service
|
|
void Init();
|
|
|
|
/// Shutdown AM service
|
|
void Shutdown();
|
|
|
|
} // namespace AM
|
|
} // namespace Service
|