TMA services - Revision history

Hexkyz at 22:43, 11 November 2025

2025-11-11T21:43:32Z

@@ Line 41: / Line 41: @@
 |-
 | 14 || [9.0.0+] RunOnHostResults
 |-
 | 21 || [19.0.0+] BeginUpdateBridge
@@ Line 49: / Line 61: @@
 |-
 | 24 || [19.0.0+] GetBridgeType
 |}

Hexkyz: /* htc */

2024-10-08T18:03:44Z

htc

← Older revision		Revision as of 22:03, 8 October 2024
Line 42:		Line 42:
	\| 14 \|\| [9.0.0+] RunOnHostResults		\| 14 \|\| [9.0.0+] RunOnHostResults
	\|-		\|-
	\| 21 \|\| [19.0.0+]		\| 21 \|\| [19.0.0+] BeginUpdateBridge
	\|-		\|-
	\| 22 \|\| [19.0.0+]		\| 22 \|\| [19.0.0+] ContinueUpdateBridge
	\|-		\|-
	\| 23 \|\| [19.0.0+]		\| 23 \|\| [19.0.0+] EndUpdateBridge
	\|-		\|-
	\| 24 \|\| [19.0.0+]		\| 24 \|\| [19.0.0+] GetBridgeType
	\|}		\|}

Hexkyz at 19:27, 8 October 2024

2024-10-08T17:27:51Z

← Older revision		Revision as of 21:27, 8 October 2024
Line 41:		Line 41:
	\|-		\|-
	\| 14 \|\| [9.0.0+] RunOnHostResults		\| 14 \|\| [9.0.0+] RunOnHostResults
			\|-
			\| 21 \|\| [19.0.0+]
			\|-
			\| 22 \|\| [19.0.0+]
			\|-
			\| 23 \|\| [19.0.0+]
			\|-
			\| 24 \|\| [19.0.0+]
	\|}		\|}

Hexkyz at 21:45, 7 August 2023

2023-08-07T19:45:33Z

← Older revision		Revision as of 23:45, 7 August 2023
Line 140:		Line 140:
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Cmd \|\| Name ~~\|\| Notes~~		! Cmd \|\| Name
	\|-		\|-
	\| 0 \|\| [[#OpenFile~~]] \|\| returns an [[#IFileAccessor~~]]		\| 0 \|\| [[#OpenFile]]
	\|-		\|-
	\| 1 \|\| [[#FileExists]] \|\|		\| 1 \|\| [[#FileExists]]
	\|-		\|-
	\| 2 \|\| [[#DeleteFile]] \|\|		\| 2 \|\| [[#DeleteFile]]
	\|-		\|-
	\| 3 \|\| [[#RenameFile]] \|\|		\| 3 \|\| [[#RenameFile]]
	\|-		\|-
	\| 4 \|\| [[#GetIOType]] \|\|		\| 4 \|\| [[#GetIOType]]
	\|-		\|-
	\| 5 \|\| [[#OpenDirectory~~]] \|\| returns an [[#IDirectoryAccessor~~]]		\| 5 \|\| [[#OpenDirectory]]
	\|-		\|-
	\| 6 \|\| [[#DirectoryExists]] \|\|		\| 6 \|\| [[#DirectoryExists]]
	\|-		\|-
	\| 7 \|\| [[#CreateDirectory]] \|\|		\| 7 \|\| [[#CreateDirectory]]
	\|-		\|-
	\| 8 \|\| [[#DeleteDirectory]]\|\|		\| 8 \|\| [[#DeleteDirectory]]
	\|-		\|-
	\| 9 \|\| [[#RenameDirectory]] \|\|		\| 9 \|\| [[#RenameDirectory]]
	\|-		\|-
	\| 10 \|\| [[#CreateFile]] \|\|		\| 10 \|\| [[#CreateFile]]
	\|-		\|-
	\| 11 \|\| [[#GetFileTimeStamp]] \|\|		\| 11 \|\| [[#GetFileTimeStamp]]
	\|-		\|-
	\| 12 \|\| GetCaseSensitivePath \|\|		\| 12 \|\| GetCaseSensitivePath
	\|}		\|}

SciresM: /* file_io */ parameter docs

2019-09-29T06:57:00Z

file_io: parameter docs

← Older revision		Revision as of 10:57, 29 September 2019
Line 142:		Line 142:
	! Cmd \|\| Name \|\| Notes		! Cmd \|\| Name \|\| Notes
	\|-		\|-
	\| 0 \|\| OpenFile \|\| returns an [[#IFileAccessor]]		\| 0 \|\| [[#OpenFile]] \|\| returns an [[#IFileAccessor]]
	\|-		\|-
	\| 1 \|\| FileExists \|\|		\| 1 \|\| [[#FileExists]] \|\|
	\|-		\|-
	\| 2 \|\| DeleteFile \|\|		\| 2 \|\| [[#DeleteFile]] \|\|
	\|-		\|-
	\| 3 \|\| RenameFile \|\|		\| 3 \|\| [[#RenameFile]] \|\|
	\|-		\|-
	\| 4 \|\| GetIOType \|\|		\| 4 \|\| [[#GetIOType]] \|\|
	\|-		\|-
	\| 5 \|\| OpenDirectory \|\| returns an [[#IDirectoryAccessor]]		\| 5 \|\| [[#OpenDirectory]] \|\| returns an [[#IDirectoryAccessor]]
	\|-		\|-
	\| 6 \|\| DirectoryExists \|\|		\| 6 \|\| [[#DirectoryExists]] \|\|
	\|-		\|-
	\| 7 \|\| CreateDirectory \|\|		\| 7 \|\| [[#CreateDirectory]] \|\|
	\|-		\|-
	\| 8 \|\| DeleteDirectory\|\|		\| 8 \|\| [[#DeleteDirectory]]\|\|
	\|-		\|-
	\| 9 \|\| RenameDirectory \|\|		\| 9 \|\| [[#RenameDirectory]] \|\|
	\|-		\|-
	\| 10 \|\| CreateFile \|\|		\| 10 \|\| [[#CreateFile]] \|\|
	\|-		\|-
	\| 11 \|\| GetFileTimeStamp \|\|		\| 11 \|\| [[#GetFileTimeStamp]] \|\|
	\|-		\|-
	\| 12 \|\| GetCaseSensitivePath \|\|		\| 12 \|\| GetCaseSensitivePath \|\|
	\|}		\|}

			=== OpenFile ===
			Takes in an input X descriptor "Path" and a u32 "OpenMode", returns a [[#IFileAccessor]] interface.

			=== FileExists ===
			Takes in an input X descriptor "Path", and returns an output bool.

			=== DeleteFile ===
			Takes in an input X descriptor "Path".

			=== RenameFile ===
			Takes in an input X descriptor "SrcPath" and an input X descriptor "DstPath".

			=== GetIOType ===
			Takes in an input X descriptor "Path", returns an output int "EntryType".

			=== OpenDirectory ===
			Takes in an input X descriptor "Path" and a u32 "OpenMode", returns a [[#IDirectoryAccessor]] interface.

			=== DirectoryExists ===
			Takes in an input X descriptor "Path", and returns an output bool.

			=== CreateDirectory ===
			Takes in an input X descriptor "Path".

			=== DeleteDirectory ===
			Takes in an input X descriptor "Path" and an input bool "IsRecursive".

			=== RenameDirectory ===
			Takes in an input X descriptor "SrcPath" and an input X descriptor "DstPath".

			=== CreateFile ===
			Takes in an input X descriptor "Path" and an input s64 "Size".

			=== GetFileTimeStamp ===
			Takes in an input X descriptor "Path", and returns 3 output u64s ("CreatedTime", "AccessedTime", "ModifiedTime").

	== IFileAccessor ==		== IFileAccessor ==
Line 190:		Line 226:
	\| 6 \|\| GetPriorityForFile		\| 6 \|\| GetPriorityForFile
	\|}		\|}

			=== ReadFile ===
			Takes in an input s64 "Offset", an input ReadOption, and a NonSecure B descriptor "OutBuffer", and returns a s64 "BytesRead".

			=== WriteFile ===
			Takes in an input s64 "Offset", an input WriteOption, and a NonSecure A descriptor "InBuffer".

			=== GetFileSize ===
			Takes no input, and returns a s64 "FileSize".

			=== SetFileSize ===
			Takes an s64 "FileSize".

			=== FlushFile ===
			Takes no input, returns no output.

			=== SetPriorityForFile ===
			Takes an input s32 "Priority".

			=== GetPriorityForFile ===
			Takes no input, returns an s32 "Priority".

	== IDirectoryAccessor ==		== IDirectoryAccessor ==
Line 198:		Line 255:
	! Cmd \|\| Name		! Cmd \|\| Name
	\|-		\|-
	\| 0 \|\| GetEntryCount		\| 0 \|\| [[#GetEntryCount]]
	\|-		\|-
	\| 1 \|\| ReadDirectory		\| 1 \|\| [[#ReadDirectory]]
	\|-		\|-
	\| 2 \|\| SetPriorityForDirectory		\| 2 \|\| [[#SetPriorityForDirectory]]
	\|-		\|-
	\| 3 \|\| GetPriorityForDirectory		\| 3 \|\| [[#GetPriorityForDirectory]]
	\|}		\|}

			=== GetEntryCount ===
			Takes no input, returns an s64 "EntryCount".

			=== ReadDirectory ===
			Takes an input B descriptor "OutEntryBuffer", returns an s64 "NumEntriesRead"

			=== SetPriorityForDirectory ===
			Takes an input s32 "Priority".

			=== GetPriorityForDirectory ===
			Takes no input, returns an s32 "Priority".


	[[Category:Services]]		[[Category:Services]]

SciresM: /* htc */

2019-09-29T06:42:03Z

htc

← Older revision		Revision as of 10:42, 29 September 2019
Line 28:		Line 28:
	\| 7 \|\| [3.0.0+] GetBridgePort		\| 7 \|\| [3.0.0+] GetBridgePort
	\|-		\|-
	\| 8 \|\| [3.0.0+] ~~SetUsbDetachedForDebug~~		\| 8 \|\| [3.0.0+] SetCradleAttached
	\|-		\|-
	\| 9 \|\| [4.0.0+] GetBridgeSubnetMask		\| 9 \|\| [4.0.0+] GetBridgeSubnetMask
Line 38:		Line 38:
	\| 12 \|\| [6.0.0+] GetWorkingDirectoryPathSize		\| 12 \|\| [6.0.0+] GetWorkingDirectoryPathSize
	\|-		\|-
	\| 13 \|\| [6.0.0+] ~~RunOnHost~~		\| 13 \|\| [6.0.0+] RunOnHostStart
	\|-		\|-
	\| 14 \|\| [9.0.0+]		\| 14 \|\| [9.0.0+] RunOnHostResults
	\|}		\|}

Hexkyz: /* htc */

2019-09-12T15:10:32Z

htc

← Older revision		Revision as of 19:10, 12 September 2019
Line 39:		Line 39:
	\|-		\|-
	\| 13 \|\| [6.0.0+] RunOnHost		\| 13 \|\| [6.0.0+] RunOnHost
			\|-
			\| 14 \|\| [9.0.0+]
	\|}		\|}

SciresM: lol

2018-12-12T23:02:58Z

lol

← Older revision		Revision as of 02:02, 13 December 2018
Line 3:		Line 3:
	These services are inaccessible on retail units. However, all [[Title_list#System_Applets\|System Applets]] have permission to access them (see [[NPDM#Service_Access_Control]]).		These services are inaccessible on retail units. However, all [[Title_list#System_Applets\|System Applets]] have permission to access them (see [[NPDM#Service_Access_Control]]).

	TMA makes a few sets of services available. One set (the "htc" family), is aimed around managing Host/Target Connections. "htc" allows orchestrating the switch<->pc connection, "htc:tenv" allows retrieving information about the target's environment from the host, and "htcs" provides an interface for managing sockets on PC from the Switch. htcs is used primarily to host services on PC ports with actual management code running on Switch. The other service ("file_io") manages HostIO, a mechanism by which the Switch can read files present on the Host PC. When a host is connected, FS will attempt to read data via file_io when @Host:/ content paths are used, or when fsp-srv->OpenHostFileSystem() is used to open an IFileSystem to the Host PC.		TMA makes a few sets of services available. One set (the "htc" family), is aimed around managing Host/Target Connections. "htc" allows orchestrating the switch<->pc connection, "htc:tenv" allows retrieving information about the target's environment from the host, and "htcs" provides an interface for managing sockets on PC from the Switch. htcs is used primarily to host services on PC ports with actual management code running on Switch. The other service ("file_io") manages HostIO, a mechanism by which the Switch can read files present on the Host PC. When a host is connected, FS will attempt to read data via file_io when @Host:/ content paths are used, or when fsp-srv->OpenHostFileSystem() is used to open an IFileSystem to the Host PC. Nintendo's implementation only supports Windows, and FS will explicitly check for the presence of a "C:/" drive to detect this.

	= htc =		= htc =

SciresM: summarize t m a

2018-12-12T23:02:20Z

summarize t m a

← Older revision		Revision as of 02:02, 13 December 2018
Line 1:		Line 1:
	TMA (Target Manager) acts as a debugging sysmodule for development kits. This system module is loaded in retail units, but remains unused.		TMA (Target Manager Agent) acts as a debugging sysmodule for development kits. This system module is loaded in retail units, but remains unused.

	These services are inaccessible on retail units. However, all [[Title_list#System_Applets\|System Applets]] have permission to access them (see [[NPDM#Service_Access_Control]]).		These services are inaccessible on retail units. However, all [[Title_list#System_Applets\|System Applets]] have permission to access them (see [[NPDM#Service_Access_Control]]).

			TMA makes a few sets of services available. One set (the "htc" family), is aimed around managing Host/Target Connections. "htc" allows orchestrating the switch<->pc connection, "htc:tenv" allows retrieving information about the target's environment from the host, and "htcs" provides an interface for managing sockets on PC from the Switch. htcs is used primarily to host services on PC ports with actual management code running on Switch. The other service ("file_io") manages HostIO, a mechanism by which the Switch can read files present on the Host PC. When a host is connected, FS will attempt to read data via file_io when @Host:/ content paths are used, or when fsp-srv->OpenHostFileSystem() is used to open an IFileSystem to the Host PC.

	= htc =		= htc =

SciresM: /* htcs */

2018-12-12T22:58:09Z

htcs

← Older revision		Revision as of 01:58, 13 December 2018
Line 46:		Line 46:
	! Cmd \|\| Name		! Cmd \|\| Name
	\|-		\|-
	\| 0 \|\|		\| 0 \|\| Socket
	\|-		\|-
	\| 1 \|\|		\| 1 \|\| Close
	\|-		\|-
	\| 2 \|\|		\| 2 \|\| Connect
	\|-		\|-
	\| 3 \|\|		\| 3 \|\| Bind
	\|-		\|-
	\| 4 \|\|		\| 4 \|\| Listen
	\|-		\|-
	\| 5 \|\|		\| 5 \|\| Accept
	\|-		\|-
	\| 6 \|\|		\| 6 \|\| Recv
	\|-		\|-
	\| 7 \|\|		\| 7 \|\| Send
	\|-		\|-
	\| 8 \|\|		\| 8 \|\| Shutdown
	\|-		\|-
	\| 9 \|\|		\| 9 \|\| Fcntl
	\|-		\|-
	\| 10 \|\| GetPeerNameAny		\| 10 \|\| GetPeerNameAny