Application Manager Services: Difference between revisions

From 3dbrew
Jump to navigation Jump to search
← Older edit
ElementW (talk | contribs)
164 edits
m Add am:pipe anchor
 
(32 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Services]]
__TOC__
 
{{Anchor|AM}}
= Application Manager services "am:sys", "am:u", "am:net" =
= Application Manager services "am:sys", "am:u", "am:net" =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 131: Line 131:
|-
|-
| 0x002A00C0
| 0x002A00C0
| [[AM:GetNumExistingContentInfosSystem|GetNumExistingContentInfosSystem]]
| [[AM:GetNumExistingContentInfos|GetNumExistingContentInfos]]
|-
|-
| 0x002B0142
| 0x002B0142
| [[AM:ListExistingContentInfosSystem|ListExistingContentInfosSystem]]
| [[AM:ListExistingContentInfos|ListExistingContentInfos]]
|-
|-
| 0x002C0084
| 0x002C0084
Line 225: Line 225:
|}
|}


{{Anchor|AMAPP}}{{Anchor|am:app}}
= Application Manager service "am:app" =
= Application Manager service "am:app" =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 232: Line 233:
|-
|-
| 0x100100C0
| 0x100100C0
| [[AM:GetNumContentInfos|GetNumContentInfos]]
| [[AM:GetDLCContentInfoCount|GetDLCContentInfoCount]]
|-
|-
| 0x10020104
| 0x10020104
| [[AM:FindContentInfos|FindContentInfos]]
| [[AM:FindDLCContentInfos|FindDLCContentInfos]]
|-
|-
| 0x10030142
| 0x10030142
| [[AM:ListContentInfos|ListContentInfos]]
| [[AM:ListDLCContentInfos|ListDLCContentInfos]]
|-
|-
| 0x10040102
| 0x10040102
| [[AM:DeleteContents|DeleteContents]]
| [[AM:DeleteDLCContents|DeleteDLCContents]]
|-
|-
| 0x10050084
| 0x10050084
| [[AM:GetDataTitleInfos|GetDataTitleInfos]]
| [[AM:GetDLCTitleInfos|GetDLCTitleInfos]]
|-
|-
| 0x10060080
| 0x10060080
| [[AM:GetNumDataTitleTickets|GetNumDataTitleTickets]]
| [[AM:GetDLCOrLicenseNumTickets|GetDLCOrLicenseNumTickets]]
|-
|-
| 0x10070102
| 0x10070102
| [[AM:ListDataTitleTicketInfos|ListDataTitleTicketInfos]]
| [[AM:ListDLCOrLicenseTicketInfos|ListDLCOrLicenseTicketInfos]]
|-
|-
| 0x100801C2
| 0x100801C2
| [[AM:GetItemRights|GetItemRights]]
| [[AM:GetDLCOrLicenseItemRights|GetDLCOrLicenseItemRights]]
|-
|-
| 0x100900C0
| 0x100900C0
| [[AM:IsDataTitleInUse|IsDataTitleInUse]]
| [[AM:IsDLCTitleInUse|IsDLCTitleInUse]]
|-
|-
| 0x100A0000
| 0x100A0000
| [[AM:IsExternalTitleDatabaseInitialized|IsExternalTitleDatabaseInitialized]]
| [[AM:ReloadSDTitleDatabase|ReloadSDTitleDatabase]]
|-
|-
| 0x100B00C0
| 0x100B00C0
| [[AM:GetNumExistingContentInfos|GetNumExistingContentInfos]]
| [[AM:GetNumDLCExistingContentInfos|GetNumDLCExistingContentInfos]]
|-
|-
| 0x100C0142
| 0x100C0142
| [[AM:ListExistingContentInfos|ListExistingContentInfos]]
| [[AM:ListDLCExistingContentInfos|ListDLCExistingContentInfos]]
|-
|-
| 0x100D0084
| 0x100D0084
Line 271: Line 272:
|}
|}


The only commands accessible with this service are listed under this section.
{{Anchor|AMSYS}}{{Anchor|am:sys}}
= Application Manager service "am:sys" =
= Application Manager service "am:sys" =
This service only has access to the 0x00XX* commands listed above, and the "am:app" commands.


{{Anchor|AMU}}{{Anchor|am:u}}
= Application Manager service "am:u" =
= Application Manager service "am:u" =


= Application Manager service "am:pipe" =
{{Anchor|AMNET}}{{Anchor|am:net}}
= Application Manager network service "am:net" =
{| class="wikitable" border="1"
|-
!  Command Header
!  Available since system-version
!  Description
|-
| 0x0001....
|
| Stubbed. After validating the translate-paramater headers, this just returns error 0xE0C046F8.
|-
| 0x0401....
|
|
|-
| 0x0801....
|
|
|-
| 0x0802....
|
|
|-
| 0x0803....
|
|
|-
| 0x0804....
|
|
|-
| 0x0805....
|
|
|-
| 0x0806....
|
|
|}
 
There's no known retail titles which use this.
 
For handling each command that's actually implemented, the AM cmdhandler function calls a vtable funcptr.
 
= Application Manager network service "am:net" =
= Application Manager network service "am:net" =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 423: Line 385:
|-
|-
| 0x08210142
| 0x08210142
| [[AMNet:GetRightsOnlyTicketData|GetRightsOnlyTicketData]]
| [[AMNet:ExportLicenseTicket|ExportLicenseTicket]]
|-
|-
| 0x08220000
| 0x08220000
Line 445: Line 407:
| 0x082800C0
| 0x082800C0
| [[AMNet:BeginImportTitleForOverWrite|BeginImportTitleForOverWrite]]
| [[AMNet:BeginImportTitleForOverWrite|BeginImportTitleForOverWrite]]
|-
| 0x08290184
| [[AMNet:ExportTicketWrapped|ExportTicketWrapped]]
|}
|}


Line 451: Line 416:
|-
|-
!  Command Header
!  Command Header
!  Available since system-version
!  Description
!  Description
|-
|-
| 0x0001....
|
| Stubbed. After validating the translate-paramater headers, this just returns error 0xE0C046F8.
|-
| 0x040100C4
|
| [[AMFile:Control|Control]]
|-
| 0x08010100
|
| [[AMFile:OpenSubFile|OpenSubFile]]
|-
|-
| 0x080200C2
| 0x080200C2
|
| [[AMFile:Read|Read]]
| [[AMFile:Read|Read]]
|-
|-
| 0x08030102
| 0x08030102
|
| [[AMFile:Write|Write]]
| [[AMFile:Write|Write]]
|-
|-
| 0x08040000
| 0x08040000
|
| [[AMFile:GetSize|GetSize]]
| [[AMFile:GetSize|GetSize]]
|-
|-
| 0x08050080
| 0x08050080
|
| [[AMFile:SetSize|SetSize]]
| [[AMFile:SetSize|SetSize]]
|-
| 0x08060000
|
| [[AMFile:GetAttributes|GetAttributes]]
|-
| 0x08070000
|
| [[AMFile:SetAttributes|SetAttributes]]
|-
|-
| 0x08080000
| 0x08080000
|
| [[AMFile:Close|Close]]
| [[AMFile:Close|Close]]
|-
| 0x08090000
|
| [[AMFile:Flush|Flush]]
|-
| 0x080A0000
|
| This just returns 0.
|-
| 0x080B0000
|
| This just returns 0.
|-
| 0x080C0000
|
| This just returns 0.
|}
This is similar to [[Filesystem_services#File_service|FSFile]].
For handling each command that's actually implemented, the AM cmdhandler function calls a vtable funcptr.
{{Anchor|am:pipe}}
The private port for this seems to be referred to as "am:pipe", even though the "am:pipe" string isn't actually used.
=Types=
==TicketInfo==
{| class="wikitable" border="1"
|-
!  Offset
!  Length
!  Description
|-
| 0x0
| 0x8
| Title ID
|-
| 0x8
| 0x8
| Ticket ID
|-
| 0x10
| 0x2
| Version
|-
| 0x12
| 0x2
| Padding
|-
| 0x14
| 0x4
| Size
|}
==TitleInfo==
{| class="wikitable" border="1"
|-
!  Offset
!  Length
!  Description
|-
| 0x0
| 0x8
| Title ID
|-
| 0x8
| 0x8
| Size
|-
| 0x10
| 0x2
| Version
|-
| 0x12
| 0x2
| Padding
|-
| 0x14
| 0x4
| Type
|}
|}


These are identical to [[Filesystem_services#File_service|FSFile]].
==ContentInfo==
{| class="wikitable" border="1"
|-
!  Offset
!  Length
!  Description
|-
| 0x0
| 0x2
| Index
|-
| 0x2
| 0x2
| [[Title_metadata#Content_Type_flags|Content Type Flags]] from [[Title_metadata|TMD]]
|-
| 0x4
| 0x4
| Content ID
|-
| 0x8
| 0x8
| Size
|-
| 0x10
| 0x1
| Bit 0: Downloaded, Bit 1: Owned
|-
| 0x11
| 0x7
| Padding
|}
 
==ImportTitleContext==
{| class="wikitable" border="1"
|-
!  Offset
!  Length
!  Description
|-
| 0x0
| 0x8
| Title ID
|-
| 0x8
| 0x2
| Version
|-
| 0xA
| 0x2
| State
|-
| 0xC
| 0x4
| Type
|-
| 0x10
| 0x8
| Size
|}
 
===ImportTitleContextState===
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| None
|-
| 1
| Waiting for import
|-
| 2
| Resumable
|-
| 3
| Waiting for commit
|-
| 4
| Already exists
|-
| 5
| Deleting
|-
| 6
| Needs cleanup
|}
 
==ImportContentContext==
{| class="wikitable" border="1"
|-
!  Offset
!  Length
!  Description
|-
| 0x0
| 0x4
| Content ID
|-
| 0x4
| 0x2
| Index
|-
| 0x6
| 0x2
| Type
|-
| 0x8
| 0x8
| Size
|-
| 0x10
| 0x8
| Current Install Offset
|}
 
==TwlBackupInfo==
{| class="wikitable" border="1"
|-
! Offset
! Length
! Description
|-
| 0x0
| 0x8
| Title ID
|-
| 0x8
| 0x2
| Group ID
|-
| 0xA
| 0x2
| Title Version
|-
| 0xC
| 0x4
| public.sav size
|-
| 0x10
| 0x4
| private.sav size
|-
| 0x14
| 0x4
| Unused, padding.
|-
| 0x18
| 0x8
| u64, required space in bytes for installation (aligned to 0x4000, used to show amount of blocks in system settings)
|-
|}


=Errors=
=Errors=
See [[Application_Manager_Services_PXI|this]].
See [[Application_Manager_Services_PXI|this]].
[[Category:Services]]

Latest revision as of 11:34, 18 September 2024

Application Manager services "am:sys", "am:u", "am:net"

Command Header Description
0x00010040 GetNumPrograms
0x00020082 GetProgramList
0x00030084 GetProgramInfos
0x000400C0 DeleteUserProgram
0x000500C0 GetProductCode
0x000600C0 GetStorageId
0x00070080 DeleteTicket
0x00080000 GetNumTickets
0x00090082 GetTicketList
0x000A0000 GetDeviceId
0x000B0040 GetNumImportTitleContexts
0x000C0082 GetImportTitleContextList
0x000D0084 GetImportTitleContexts
0x000E00C0 DeleteImportTitleContext
0x000F00C0 GetNumImportContentContexts
0x00100102 GetImportContentContextList
0x00110104 GetImportContentContexts
0x00120102 DeleteImportContentContexts
0x00130040 NeedsCleanup
0x00140040 DoCleanup
0x00150040 DeleteAllImportContexts
0x00160000 DeleteAllTemporaryPrograms
0x00170044 ImportTwlBackupLegacy
0x00180080 InitializeTitleDatabase
0x00190040 QueryAvailableTitleDatabase
0x001A00C0 CalcTwlBackupSize
0x001B0144 ExportTwlBackup
0x001C0084 ImportTwlBackup
0x001D0000 DeleteAllTwlUserPrograms
0x001E00C8 ReadTwlBackupInfo
0x001F0040 DeleteAllExpiredUserPrograms
0x00200000 GetTwlArchiveResourceInfo
0x00210042 GetPersonalizedTicketInfoList
0x00220080 DeleteAllImportContextsFiltered
0x00230080 GetNumImportTitleContextsFiltered
0x002400C2 GetImportTitleContextListFiltered
0x002500C0 CheckContentRights
0x00260044 GetTicketLimitInfos
0x00270044 GetDemoLaunchInfos
0x00280108 ReadTwlBackupInfoEx
0x00290082 DeleteUserProgramsAtomically
0x002A00C0 GetNumExistingContentInfos
0x002B0142 ListExistingContentInfos
0x002C0084 GetProgramInfosIgnorePlatform
0x002D00C0 CheckContentRightsIgnorePlatform

Application Manager services "am:u" and "am:net"

Command Header Description
0x04010080 UpdateFirmwareTo
0x04020040 BeginImportProgram
0x04030000 BeginImportProgramTemporarily
0x04040002 CancelImportProgram
0x04050002 EndImportProgram
0x04060002 EndImportProgramWithoutCommit
0x040700C2 CommitImportPrograms
0x04080042 GetProgramInfoFromCia
0x04090004 GetSystemMenuDataFromCia
0x040A0002 GetDependencyListFromCia
0x040B0002 GetTransferSizeFromCia
0x040C0002 GetCoreVersionFromCia
0x040D0042 GetRequiredSizeFromCia
0x040E00C2 CommitImportProgramsAndUpdateFirmwareAuto
0x040F0000 UpdateFirmwareAuto
0x041000C0 DeleteProgram
0x04110044 GetTwlProgramListForReboot
0x04120000 GetSystemUpdaterMutex
0x04130002 GetMetaSizeFromCia
0x04140044 GetMetaDataFromCia
0x04150080 CheckDemoLaunchRights
0x041600C0 GetInternalTitleLocationInfo
0x041700C0 PerpetuateAgbSaveData
0x04180040 BeginImportProgramForOverWrite
0x04190000 BeginImportSystemProgram

Application Manager service "am:app"

Command Header Description
0x100100C0 GetDLCContentInfoCount
0x10020104 FindDLCContentInfos
0x10030142 ListDLCContentInfos
0x10040102 DeleteDLCContents
0x10050084 GetDLCTitleInfos
0x10060080 GetDLCOrLicenseNumTickets
0x10070102 ListDLCOrLicenseTicketInfos
0x100801C2 GetDLCOrLicenseItemRights
0x100900C0 IsDLCTitleInUse
0x100A0000 ReloadSDTitleDatabase
0x100B00C0 GetNumDLCExistingContentInfos
0x100C0142 ListDLCExistingContentInfos
0x100D0084 GetPatchTitleInfos

The only commands accessible with this service are listed under this section.

Application Manager service "am:sys"

This service only has access to the 0x00XX* commands listed above, and the "am:app" commands.

Application Manager service "am:u"

Application Manager network service "am:net"

Command Header Description
0x08010000 BeginImportTicket
0x08020002 CancelImportTicket
0x08030002 EndImportTicket
0x08040100 BeginImportTitle
0x08050000 StopImportTitle
0x080600C0 ResumeImportTitle
0x08070000 CancelImportTitle
0x08080000 EndImportTitle
0x080900C2 CommitImportTitles
0x080A0000 BeginImportTmd
0x080B0002 CancelImportTmd
0x080C0042 EndImportTmd
0x080D0042 CreateImportContentContexts
0x080E0040 BeginImportContent
0x080F0002 StopImportContent
0x08100040 ResumeImportContent
0x08110002 CancelImportContent
0x08120002 EndImportContent
0x08130000 GetNumCurrentImportContentContexts
0x08140042 GetCurrentImportContentContextList
0x08150044 GetCurrentImportContentContexts
0x08160146 Sign
0x08170146 Verify
0x08180042 GetDeviceCert
0x08190108 ImportCertificates
0x081A0042 ImportCertificate
0x081B00C2 CommitImportTitlesAndUpdateFirmwareAuto
0x081C0100 DeleteTicketId
0x081D0080 GetNumTicketIds
0x081E0102 GetTicketIdList
0x081F0080 GetNumTicketsOfProgram
0x08200102 ListTicketInfos
0x08210142 ExportLicenseTicket
0x08220000 GetNumCurrentContentInfos
0x08230044 FindCurrentContentInfos
0x08240082 ListCurrentContentInfos
0x08250102 CalculateContextRequiredSize
0x08260042 UpdateImportContentContexts
0x08270000 DeleteAllDemoLaunchInfos
0x082800C0 BeginImportTitleForOverWrite
0x08290184 ExportTicketWrapped

File service

Command Header Available since system-version Description
0x0001.... Stubbed. After validating the translate-paramater headers, this just returns error 0xE0C046F8.
0x040100C4 Control
0x08010100 OpenSubFile
0x080200C2 Read
0x08030102 Write
0x08040000 GetSize
0x08050080 SetSize
0x08060000 GetAttributes
0x08070000 SetAttributes
0x08080000 Close
0x08090000 Flush
0x080A0000 This just returns 0.
0x080B0000 This just returns 0.
0x080C0000 This just returns 0.

This is similar to FSFile.

For handling each command that's actually implemented, the AM cmdhandler function calls a vtable funcptr.

The private port for this seems to be referred to as "am:pipe", even though the "am:pipe" string isn't actually used.

Types

TicketInfo

Offset Length Description
0x0 0x8 Title ID
0x8 0x8 Ticket ID
0x10 0x2 Version
0x12 0x2 Padding
0x14 0x4 Size

TitleInfo

Offset Length Description
0x0 0x8 Title ID
0x8 0x8 Size
0x10 0x2 Version
0x12 0x2 Padding
0x14 0x4 Type

ContentInfo

Offset Length Description
0x0 0x2 Index
0x2 0x2 Content Type Flags from TMD
0x4 0x4 Content ID
0x8 0x8 Size
0x10 0x1 Bit 0: Downloaded, Bit 1: Owned
0x11 0x7 Padding

ImportTitleContext

Offset Length Description
0x0 0x8 Title ID
0x8 0x2 Version
0xA 0x2 State
0xC 0x4 Type
0x10 0x8 Size

ImportTitleContextState

Value Description
0 None
1 Waiting for import
2 Resumable
3 Waiting for commit
4 Already exists
5 Deleting
6 Needs cleanup

ImportContentContext

Offset Length Description
0x0 0x4 Content ID
0x4 0x2 Index
0x6 0x2 Type
0x8 0x8 Size
0x10 0x8 Current Install Offset

TwlBackupInfo

Offset Length Description
0x0 0x8 Title ID
0x8 0x2 Group ID
0xA 0x2 Title Version
0xC 0x4 public.sav size
0x10 0x4 private.sav size
0x14 0x4 Unused, padding.
0x18 0x8 u64, required space in bytes for installation (aligned to 0x4000, used to show amount of blocks in system settings)

Errors

See this.

Retrieved from "https://www.3dbrew.org/w/index.php?title=Application_Manager_Services&oldid=22716"