Services API

Services are system processes running in the background which wait for incoming requests. When a process wants to communicate with a service, it first needs to get a handle to the named service, and then it can communicate with the service via inter-process communication (each service has a name up to 8 characters).

Handles for services are retrieved from the service manager port, "sm:", and are released via svcCloseHandle or when a process is terminated or crashes. Manager service "sm:m" also exists. Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC. Services are also able to limit the number of handles given to other processes.

sm:

This is "nn::sm::detail::IUserInterface".

Cmd	Name
0	#RegisterClient
1	#GetServiceHandle
2	#RegisterService
3	#UnregisterService
4	[11.0.0-11.0.1] #DetachClient

RegisterClient

Takes a PID-descriptor and a reserved input u64.

GetServiceHandle

Takes a zero-padded service name encoded as an u64 integer. Returns a handle.

RegisterService

Takes a zero-padded service name encoded as an u64 integer, an u8 bool IsLight, and a s32 MaxSessions at the next word. Returns a handle.

[12.0.0+] This is only available with tipc.

UnregisterService

Takes a zero-padded service name encoded as an u64 integer.

[12.0.0+] This is only available with tipc.

DetachClient

Takes a PID-descriptor and a reserved input u64.

sm:m

This is "nn::sm::detail::IManagerInterface".

Cmd	Name
0	#RegisterProcess
1	#UnregisterProcess

RegisterProcess

Takes a PID and two type-0x5 input buffers with the ACID and ACI0 service lists. That data originates from NPDM.

UnregisterProcess

Takes a PID.

Service List

S1	S2	Service Name	Hosted by	Notes
Yes	Yes	[1.0.0-12.1.0] acc:u0	Account services
Yes	Yes	[1.0.0-12.1.0] acc:u1	Account services
Yes	Yes	acc:aa	Account services
Yes	Yes	acc:su	Account services
Yes	Yes	[5.0.0+] dauth:0	Account services
Yes	Yes	[13.0.0+] acc:e	Account services
Yes	Yes	[13.0.0+] acc:e:u1	Account services
Yes	Yes	[13.0.0+] acc:e:u2	Account services
Yes	No	[1.0.0-8.1.0] ahid:cd	HID services
Yes	No	[1.0.0-8.1.0] ahid:hdr	HID services
Yes	Yes	hid	HID services
Yes	Yes	hid:dbg	HID services
Yes	Yes	hid:sys	HID services
Yes	Yes	irs	HID services
Yes	Yes	irs:sys	HID services
Yes	Yes	xcd:sys	HID services
Yes	No	[3.0.0-7.0.1] hid:tmp	HID services
Yes	Yes	[5.0.0+] hidbus	HID services
Yes	Yes	appletAE	Applet Manager services
Yes	Yes	appletOE	Applet Manager services
Yes	Yes	[1.0.0-13.2.1] idle:sys	Applet Manager services
Yes	Yes	[1.0.0-13.2.1] omm	Applet Manager services
Yes	Yes	[1.0.0-13.2.1] spsm	Applet Manager services
Yes	No	[5.0.0-10.2.0] tcap	Applet Manager services
Yes	Yes	[6.0.0+] caps:su	Applet Manager services
Yes	Yes	[8.0.0+] apm	Applet Manager services
No	Yes	adraw:a	Applet Manager services
No	Yes	adraw:m	Applet Manager services
Yes	Yes	[1.0.0-2.3.0] aoc:u	NS Services
Yes	Yes	mii:u	NS Services
Yes	Yes	mii:e	NS Services
Yes	No	ns:am	NS Services
Yes	Yes	ns:su	NS Services
Yes	Yes	ns:dev	NS Services
Yes	Yes	pl:u	NS Services
Yes	Yes	ovln:rcv	NS Services
Yes	Yes	ovln:snd	NS Services
Yes	Yes	pdm:ntfy	NS Services
Yes	Yes	pdm:qry	NS Services
Yes	Yes	[3.0.0+] aoc:u	NS Services
Yes	Yes	ns:am2	NS Services
Yes	Yes	ns:dev	NS Services
Yes	Yes	ns:ec	NS Services
Yes	Yes	ns:rid	NS Services
Yes	Yes	ns:rt	NS Services
Yes	Yes	ns:vm	NS Services
Yes	Yes	ns:web	NS Services
Yes	Yes	[1.0.0-7.0.1] ovln:rcv	NS Services
Yes	Yes	[1.0.0-7.0.1] ovln:snd	NS Services
Yes	Yes	[11.0.0+] ns:ro	NS Services
Yes	Yes	[13.0.0+] acc:su	NS Services
Yes	Yes	[13.0.0+] acc:u0	NS Services
Yes	Yes	[13.0.0+] acc:u1	NS Services
Yes	Yes	[15.0.0+] ns:sweb	NS Services
Yes	No	[1.0.0-8.1.0] apm:dbg	PPC services
Yes	Yes	[1.0.0-8.1.0] apm:sys	PPC services
Yes	No	[1.0.0] fgm:1	PPC services
Yes	No	fgm:2	PPC services
Yes	No	fgm:3	PPC services
Yes	No	fgm:4	PPC services
Yes	No	fgm:5	PPC services
Yes	No	fgm:6	PPC services
Yes	No	fgm:7	PPC services
Yes	Yes	[1.0.0-8.1.0] fgm	PPC services
Yes	No	[1.0.0-8.1.0] fgm:0	PPC services
Yes	No	[1.0.0-8.1.0] fgm:9	PPC services
Yes	No	[1.0.0-8.1.0] fgm:dbg	PPC services
Yes	Yes	[1.0.0-7.0.1] apm	PPC services
Yes	No	[1.0.0-7.0.1] apm:p	PPC services
Yes	Yes	[8.0.0-8.1.0] apm:am	PPC services
Yes	Yes	arp:r	Glue services
Yes	Yes	arp:w	Glue services
Yes	Yes	[2.0.0+] bgtc:t	Glue services
Yes	Yes	[2.0.0+] bgtc:sc	Glue services
Yes	Yes	[9.0.0+] time:a	Glue services
Yes	Yes	[9.0.0+] time:r	Glue services
Yes	Yes	[9.0.0+] time:u	Glue services
Yes	Yes	[9.0.0+] notif:a	Glue services
Yes	Yes	[9.0.0+] notif:s	Glue services
Yes	Yes	[11.0.0+] ectx:aw	Glue services
Yes	Yes	[11.0.0+] ectx:r	Glue services
Yes	Yes	[11.0.0+] ectx:w	Glue services
Yes	Yes	[16.0.0+] pl:u	Glue services
Yes	No	[1.0.0-10.2.0] audin:a	Audio services
Yes	No	[1.0.0-10.2.0] audin:d	Audio services
Yes	Yes	audin:u	Audio services
Yes	No	[1.0.0-10.2.0] audout:a	Audio services
Yes	No	[1.0.0-10.2.0] audout:d	Audio services
Yes	Yes	audout:u	Audio services
Yes	No	[1.0.0-10.2.0] audren:a	Audio services
Yes	No	[1.0.0-10.2.0] audren:d	Audio services
Yes	Yes	audren:u	Audio services
Yes	No	audrec:a	Audio services
Yes	No	audrec:d	Audio services
Yes	No	audrec:u	Audio services
Yes	Yes	audctl	Audio services
Yes	No	[1.0.0-2.3.0] codecctl	Audio services
Yes	Yes	hwopus	Audio services	[20.1.0+] Removed on Switch 2.
Yes	No	auddebug	Audio services
Yes	Yes	[6.0.0+] auddev	Audio services
Yes	Yes	[11.0.0+] aud:a	Audio services
Yes	Yes	[11.0.0+] aud:d	Audio services
No	Yes	aud:u	Audio services
No	Yes	auddmg:u	Audio services
No	Yes	auddmg:s	Audio services
No	Yes	audsmx:u	Audio services
No	Yes	audsmx:s	Audio services
Yes		banana	Profiler services	Not currently available on retail units.
Yes	Yes	[2.0.0+] bcat:a	BCAT services
Yes	Yes	[2.0.0+] bcat:u	BCAT services
Yes	Yes	[2.0.0+] bcat:m	BCAT services
Yes	Yes	[2.0.0+] bcat:s	BCAT services
Yes	Yes	news:a	BCAT services
Yes	Yes	news:c	BCAT services
Yes	Yes	news:m	BCAT services
Yes	Yes	news:p	BCAT services
Yes	Yes	news:v	BCAT services
Yes	Yes	prepo:u	BCAT services
Yes	Yes	prepo:s	BCAT services
Yes	Yes	prepo:m	BCAT services
Yes	No	[1.0.0-5.1.0] prepo:a	BCAT services
Yes	No	[1.0.0] prepo:d	BCAT services
Yes	Yes	[6.0.0+] prepo:a2	BCAT services
Yes	Yes	[13.0.0+] mnpp:app	BCAT services
Yes	Yes	[13.0.0+] mnpp:sys	BCAT services
Yes	Yes	[13.0.0+] mnpp:web	BCAT services
Yes	No	[1.0.0] bpc:c	PCV services
Yes	No	bpc:b	PCV services
Yes	No	bpc:r	PCV services
Yes	No	bpc:w	PCV services
Yes	No	pcv	PCV services
Yes	No	pcv:arb	PCV services
Yes	No	pcv:imm	PCV services
Yes	Yes	time:u	PCV services
Yes	Yes	time:a	PCV services
Yes	Yes	time:s	PCV services
Yes	Yes	[2.0.0+] bpc	PCV services
Yes	No	bpc:r	PCV services
Yes	No	pcv	PCV services
Yes	Yes	[2.0.0-8.1.0] time:u	PCV services
Yes	Yes	[2.0.0-8.1.0] time:a	PCV services
Yes	Yes	[2.0.0-8.1.0] time:s	PCV services
Yes	No	[1.0.0-7.0.1] pcv:arb	PCV services
Yes	No	[1.0.0-7.0.1] pcv:imm	PCV services
Yes	Yes	[8.0.0+] clkrst	PCV services
Yes	No	[8.0.0+] clkrst:a	PCV services
Yes	Yes	[8.0.0+] clkrst:i	PCV services
Yes	Yes	[8.0.0+] rgltr	PCV services
Yes	Yes	[8.0.0+] rtc	PCV services
Yes	Yes	bsd:u	Sockets services
Yes	Yes	bsd:s	Sockets services
Yes	Yes	[15.0.0+] bsd:nu	Sockets services
Yes	No	bsdcfg	Sockets services	Removed on Switch 2.
Yes	Yes	[17.0.0+] ifcfg	Sockets services
Yes	Yes	[18.0.0+] bsd:a	Sockets services
Yes	No	[1.0.0-14.1.2] ethc:c	Sockets services
Yes	No	[1.0.0-14.1.2] ethc:i	Sockets services
Yes	Yes	nsd:u	Sockets services
Yes	Yes	nsd:a	Sockets services
Yes	Yes	sfdnsres	Sockets services
Yes	Yes	[18.0.0+] dns:priv	Sockets services
Yes	No	btdrv	Bluetooth Driver services
Yes	Yes	[5.0.0+] bt	Bluetooth Driver services
Yes	No	btm	BTM services
Yes	No	btm:dbg	BTM services
Yes	No	btm:sys	BTM services
Yes	Yes	[5.0.0+] btm:u	BTM services
Yes	Yes	caps:a	Capture services
Yes	Yes	caps:c	Capture services
Yes	No	[1.0.0] mm:u	Capture services	Removed on Switch 2.
Yes	Yes	[5.0.0+] caps:u	Capture services
Yes	Yes	[2.0.0+] caps:sc	Display services
Yes	Yes	[2.0.0+] caps:ss	Display services
Yes	No	vi:m	Display services
Yes	No	vi:s	Display services
Yes	No	vi:u	Display services	Removed on Switch 2.
Yes	Yes	cec-mgr	Display services
Yes	No	[2.0.0+] mm:u	Display services	Removed on Switch 2.
Yes	Yes	[3.0.0-5.1.0] caps:su	Display services
Yes	Yes	[11.0.0+] lbl	Display services
Yes	No	dispdrv	Nvnflinger services
Yes		dmnt:-	Debug Monitor services	Not currently available on retail units.
Yes	Yes	erpt:c	Error Report services
Yes	Yes	erpt:r	Error Report services
Yes	Yes	[13.0.0+] sprof:bg	Error Report services
Yes	Yes	[13.0.0+] sprof:sp	Error Report services
Yes	Yes	eupld:c	Error Upload services
Yes	Yes	eupld:r	Error Upload services
Yes	Yes	es	ETicket services
Yes	Yes	[13.0.0+] ndrm:la	ETicket services
Yes	Yes	[13.0.0+] ndrm:lu	ETicket services
Yes	Yes	fan	PTM services
Yes	Yes	psm	PTM services
Yes	Yes	tc	PTM services
Yes	Yes	ts	PTM services
No	Yes	ts:emu	PTM services
Yes		pcm	PTM services	pcm is not available on retail units.
Yes	Yes	[9.0.0+] apm:sys	PTM services
Yes	Yes	[9.0.0+] fgm	PTM services
Yes	No	[9.0.0+] fgm:0	PTM services
Yes	No	[9.0.0+] fgm:9	PTM services
Yes	No	[9.0.0+] fgm:dbg	PTM services
Yes	Yes	[9.0.0+] apm:am	PTM services
Yes	Yes	[10.0.0-10.2.0] lbl	PTM services
Yes	Yes	fatal:u	Fatal services
Yes	Yes	fatal:p	Fatal services
Yes	Yes	friend:u	Friend services
Yes	Yes	friend:v	Friend services
Yes	Yes	friend:m	Friend services
Yes	Yes	friend:s	Friend services
Yes	Yes	friend:a	Friend services
Yes	No	[5.0.0-6.0.0] nd:app	Friend services
Yes	No	[5.0.0-6.0.0] nd:sys	Friend services
Yes	Yes	fsp-srv	Filesystem services
Yes	Yes	fsp-ldr	Filesystem services
Yes	Yes	fsp-pr	Filesystem services
Yes	Yes	gpio	Bus services
Yes	Yes	i2c	Bus services
Yes	No	i2c:pcv	Bus services
Yes	Yes	pinmux	Bus services
Yes	Yes	pwm	Bus services
Yes	Yes	uart	Bus services
Yes	Yes	[3.0.0+] sasbus	Bus services
Yes	No	[8.1.1+] led	Bus services
Yes		htc	TMA services
Yes		htcs	TMA services
Yes		htc:tenv	TMA services
Yes		file_io	TMA services
Yes		gds	TMA services
Yes		tma_log	TMA services
Yes		tmagent	TMA services
Yes	No	jit:u	JIT services
Yes	Yes	[1.0.0-9.2.0] lbl	Backlight services
Yes	Yes	ldn:m	LDN services
Yes	Yes	ldn:s	LDN services
Yes	Yes	ldn:u	LDN services
Yes	No	[5.0.0-6.0.0] ndd	LDN services
Yes	No	[9.0.0+] lp2p:app	LDN services
Yes	No	[9.0.0+] lp2p:sys	LDN services
Yes	No	[9.1.0+] lp2p:m	LDN services
Yes	Yes	[1.0.0+] ldr:pm	Loader services
Yes	Yes	ldr:ro	Loader services
Yes	Yes	ldr:shel	Loader services
Yes	Yes	ldr:dmnt	Loader services
Yes	Yes	[3.0.0+] ldr:pm	Loader services
Yes	Yes	ldr:shel	Loader services
Yes	Yes	ldr:dmnt	Loader services
Yes	Yes	lm	Log services
Yes	No	lm:get	Log services
Yes		manu	Manu Services	"Manufacturing". Present in factory firmware but not installed on retail systems.
Yes	Yes	lr	NCM services
Yes	Yes	ncm	NCM services
Yes	No	ncm:v	NCM services
Yes	Yes	nfc:am	NFC services
Yes	Yes	nfc:mf:u	NFC services
Yes	Yes	nfc:user	NFC services
Yes	Yes	nfc:sys	NFC services
Yes	Yes	nfp:user	NFC services
Yes	Yes	nfp:dbg	NFC services
Yes	Yes	nfp:sys	NFC services
Yes	Yes	nifm:u	Network Interface services
Yes	Yes	nifm:a	Network Interface services
Yes	Yes	nifm:s	Network Interface services
Yes	Yes	nim	NIM services
Yes	Yes	nim:shp	NIM services
Yes	Yes	ntc	NIM services
Yes	Yes	[5.0.0+] nim:eca	NIM services
Yes	Yes	[7.0.0+] nim:ecas	NIM services
Yes	Yes	npns:u	NPNS services
Yes	Yes	npns:s	NPNS services
Yes	No	nvdrv:a	NV services
Yes	Yes	nvdrv:s	NV services
Yes	Yes	nvdrv:t	NV services
No	Yes	nvdrv:v	NV services
Yes	No	nvdrv	NV services
Yes	Yes	nvdrvdbg	NV services
Yes	Yes	nvgem:c	NV services
Yes	Yes	nvgem:cd	NV services
Yes	No	nvmemp	NV services
Yes	Yes	[10.0.0+] nvdbg:d	NV services
Yes	Yes	pcie	PCIe services
Yes	Yes	[6.0.0+] pcie:log	PCIe services
Yes	Yes	pctl	Parental Control services
Yes	Yes	pctl:a	Parental Control services
Yes	Yes	pctl:s	Parental Control services
Yes	Yes	pctl:r	Parental Control services
Yes	Yes	pm:bm	Process Manager services
Yes	Yes	pm:info	Process Manager services
Yes	Yes	pm:shell	Process Manager services
Yes	Yes	psc:c	PSC services
Yes	Yes	psc:m	PSC services
Yes	Yes	[5.0.0+] srepo:u	PSC services
Yes	Yes	[5.0.0+] srepo:a	PSC services
Yes	Yes	[8.0.0+] ovln:rcv	PSC services
Yes	Yes	[8.0.0+] ovln:snd	PSC services
Yes	Yes	[9.0.0+] psc:l	PSC services
Yes	Yes	[9.0.0+] time:su	PSC services
Yes	Yes	[9.0.0+] time:s	PSC services
Yes	Yes	[9.0.0+] time:al	PSC services
Yes	Yes	[9.0.0+] time:m	PSC services
Yes	Yes	[9.0.0+] time:p	PSC services
Yes	Yes	[9.0.0+] ins:r	PSC services
Yes	Yes	[9.0.0+] ins:s	PSC services
Yes	Yes	[11.0.0+] hshl:set	PSC services
Yes	Yes	[11.0.0+] hshl:sys	PSC services
Yes	Yes	[3.0.0+] ldr:ro	RO services
Yes	Yes	ro:dmnt	RO services
Yes	Yes	[7.0.0+] ro:1	RO services
Yes	Yes	set	Settings services
Yes	No	set:fd	Settings services
Yes	Yes	set:cal	Settings services
Yes	Yes	set:sys	Settings services
Yes	Yes	[3.0.0+] mii:u	Shared Database services
Yes	Yes	[3.0.0+] mii:e	Shared Database services
Yes	Yes	[3.0.0+] pdm:ntfy	Shared Database services
Yes	Yes	[3.0.0+] pdm:qry	Shared Database services
Yes	Yes	[3.0.0-15.0.1] pl:u	Shared Database services
Yes	Yes	[5.0.0+] miiimg	Shared Database services
Yes	Yes	[6.0.0+] avm	Shared Database services
Yes	Yes	[9.0.0+] pl:s	Shared Database services
Yes	Yes	ssl	SSL services
Yes	Yes	[15.0.0+] ssl:s	SSL services
Yes	Yes	csrng	SPL services
Yes	Yes	spl:	SPL services
Yes	Yes	[4.0.0+] spl:mig	SPL services
Yes	Yes	[4.0.0+] spl:fs	SPL services
Yes	Yes	[4.0.0+] spl:ssl	SPL services
Yes	Yes	[4.0.0+] spl:es	SPL services
Yes	No	[5.0.0+] spl:manu	SPL services
No	Yes	spl:da	SPL services
No	Yes	spl:gc	SPL services
No	Yes	spl:nv	SPL services
No	Yes	spl:hid	SPL services
No	Yes	spl:ldn	SPL services
Yes	No	sf-uds		System debug applet "recovery" has access to this service but it doesn't appear to exist.
Yes	No	tspm		Applications on [1.0.0] used to have access to this service but it doesn't appear to be present on retail devices.
Yes	Yes	usb:ds	USB services
Yes	Yes	usb:hs	USB services
Yes	No	usb:pd	USB services
Yes	No	usb:pd:c	USB services
Yes	No	[1.0.0] usb:pd:m	USB services
Yes	Yes	usb:pm	USB services
Yes	No	[7.0.0+] usb:hs:a	USB services
Yes	No	[7.0.0+] usb:qdb	USB services
Yes	Yes	[8.0.0+] usb:obsv	USB services
No	Yes	usb:dock	USB services
Yes	No	[1.0.0-14.1.2] wlan:inf	WLAN services
Yes	No	[1.0.0-14.1.2] wlan:lcl	WLAN services
Yes	No	[1.0.0-14.1.2] wlan:lg	WLAN services
Yes	No	[1.0.0-14.1.2] wlan:lga	WLAN services
Yes	No	[1.0.0-14.1.2] wlan:sg	WLAN services
Yes	No	[1.0.0-14.1.2] wlan:soc	WLAN services
Yes	No	[6.0.0-14.1.2] wlan:dtc	WLAN services
Yes	Yes	[15.0.0+] wlan	WLAN services
Yes	Yes	[15.0.0+] wlan:nd	WLAN services
Yes	Yes	[15.0.0+] wlan:p	WLAN services
Yes	Yes	[4.0.0+] grc:c	GRC services
Yes	No	[6.0.0+] grc:d	GRC services
Yes	No	[4.0.0+] mig:usr	Migration services
Yes	Yes	[4.0.0+] caps:dc	Jpegdec services
Yes	Yes	[6.0.0+] olsc:s	OLSC services
Yes	Yes	[10.0.0+] olsc:u	OLSC services
Yes	Yes	[13.1.0+] spbg:sp	OLSC services
Yes	No	[9.0.0+] ngct:s	NGCT services
Yes	No	[9.0.0+] ngct:u	NGCT services
Yes	Yes	[10.0.0+] pgl	PGL services
Yes	Yes	[11.0.0+] capmtp	Capmtp services
Yes	Yes	[14.0.0+] omm	OMM services
Yes	No	[14.0.0+] ommdisp	OMM services
Yes	Yes	[14.0.0+] idle:sys	OMM services
Yes	Yes	[14.0.0+] spsm	OMM services
No	Yes	disp:s	OMM services
No	Yes	disp:ev	OMM services
No	Yes	disp:omm	OMM services
Yes	Yes	[15.0.0+] eth:nd	Ethernet services
Yes	Yes	[16.0.0+] ngc:u	NGC services
No	Yes	chat:ps	Chat services
No	Yes	chat:sp	Chat services
No	Yes	chat:dbg	Chat services
No	Yes	[20.1.0+] chat:wu	Chat services
No	Yes	imf
No	Yes	imf:fe
No	Yes	vi2:v
No	Yes	vi2:m1
No	Yes	vi2:m2
No	Yes	gsv:sv
No	Yes	gsv:s3
No	Yes	gsv:s4
No	Yes	gpuk:drv
No	Yes	gpuk:gsv
No	Yes	hdcp
No	Yes	vic:u
No	Yes	caps2:s
No	Yes	caps2:r
No	Yes	fs:stcfg
No	Yes	dt
No	Yes	spi