Services API

From Nintendo Switch Brew
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

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