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+] Added 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	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
No	Yes	bt:sys	Bluetooth Driver services
No	Yes	bt:dbg	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
No	Yes	fgm:test	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	Yes	htc	TMA services
Yes	Yes	htcs	TMA services
Yes	Yes	htc:tenv	TMA services
Yes		file_io	TMA services
Yes		gds	TMA services
Yes		tma_log	TMA services
Yes		tmagent	TMA services
Yes		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		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		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		[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:a	Chat services
No	Yes	chat:u	Chat 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	IMF services
No	Yes	imf:fe	IMF services
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
No	Yes	btp:dbg
No	Yes	syncpt:s
No	Yes	host1x
No	Yes	batlog
No	Yes	bpmpmr:c
No	Yes	bpmpmr:d
No	Yes	bpmpmr:i
No	Yes	bpmpmr:m
No	Yes	bpmpmr:u