Services API

From Nintendo Switch Brew
Revision as of 01:06, 23 December 2025 by Yellows8 (talk | contribs) (→Service List)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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
Retrieved from "https://switchbrew.org/w/index.php?title=Services_API&oldid=14202"