Services API

Services API

Nintendo provides application developers with an API, which communicate with certain services. Services, in this sense, 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 interprocess communication. Each service has a name up to 8 characters, for example “nim:u”.

Handles for services are retrieved from the service manager port, “srv:”. Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC.

For a description of how commands and arguments are passed to services, see IPC Command Structure.

List of services (grouped by the process which provides them):

Old3dsServicesService names

Notes

Yes

Filesystem servicesfs:USER, fs:LDR, fs:REGUSER: normal applications and system modules, LDR: loader, REG: register

Yes

Process Servicesps:ps

Yes

PXI ServicesPxiFS0, PxiFS1, PxiFSB, PxiFSR, PxiPM, pxi:am9, pxi:dev, pxi:mc, pxi:ps9

Yes

Application Manager Servicesam:app, am:net, am:u, am:sys, am:pipeapp: am for applications, net: network installation (nim), u: local installation, sys: am for system titles, pipe: not an actual port (internally used to represent the FSFile-like interface)

Yes

Process Manager Servicespm:app, pm:dbgapp: launching titles, dbg: launching titles with debugging enabled

Yes

NIM Servicesnim:aoc, nim:ndm, nim:s, nim:uaoc: DLC, ndm: for ndm, s: for eShop, u: for updater

Yes

Config Servicescfg:u, cfg:s, cfg:i, cfg:noru: for user, s: for system, i: for initialization/formatting, nor: accesses wifi SPI flash

Yes

NS and APT Servicesns:s, ns:p, ns:c, APT:A, APT:S, APT:Uns:s: for system, ns:p: power (shutdown/reboot), ns:c: ?, APT:A: application, APT:S: system, APT:U: user

Yes

RO Servicesldr:ro

Yes

NDM Servicesndm:u

Yes

CSND Servicescsnd:SND

Yes

Camera Servicescam:u, y2r:u, cam:s, cam:c, cam:q (New3DS only)

Yes

Codec Servicescdc:HID, cdc:MIC, cdc:CSN, cdc:DSP, cdc:LGY, cdc:CHKHID: human interface device, MIC: microphone, CSN: for csnd?, DSP: for dsp?, LGY: legacy (some kind of backwards compat?), CHK: ?

Yes

DLP Servicesdlp:CLNT, dlp:FKCL, dlp:SRVRCLNT: client, FKCL: fake client, SRVR: server

Yes

DSP Servicesdsp::DSP

Yes

GSP Servicesgsp::Lcd, gsp::GpuLcd: LCD control, Gpu: GPU control

Yes

BOSS Servicesboss:U, boss:P, boss:MU: user, P: privileged, M: for ndm

Yes

CECD Servicescecd:u, cecd:s, cecd:ndmu: user, s: system, ndm: for ndm

Yes

IR Servicesir:u, ir:USER, ir:rst

Yes

I2C Servicesi2c::MCU, i2c::CAM, i2c::LCD, i2c::DEB, i2c::HID, i2c::IR, i2c::EEP, i2c::NFC, i2c::QTM

Yes

GPIO Servicesgpio:CDC, gpio:MCU, gpio:HID, gpio:NWM, gpio:IR, gpio:NFC, gpio:QTM

Yes

HID Serviceshid:NFC, hid:QTM, hid:SPVR, hid:USERNFC: near-field communication (amiibo), QTM: head tracking device (related to QTM Services)?, SPVR: system privileged?

Yes

PTM Servicesptm:gets, ptm:play, ptm:s, ptm:sets, ptm:sysm, ptm:ugets: get system time, play: play history, s: system, sets: set system time, sysm: system menu (homemenu/testmenu), u: user

Yes

NWM Servicesnwm::CEC, nwm::EXT, nwm::INF, nwm::SAP, nwm::SOC, nwm::TST, nwm::UDSCEC: streetpass, EXT: ?, INF: infrastructure, SAP: ?, SOC: socket, UDS: local WLAN, TST: ?

Yes

HTTP Serviceshttp:CC: connection

Yes

SSL Servicesssl:CC: connection

Yes

Socket Servicessoc:P, soc:UP: privileged, U: user

Yes

AC Servicesac:i, ac:ui: internal, u: user

Yes

Friend Servicesfrd:a, frd:n, frd:ua: admin, n: for ndm, u: user

Yes

News Services:news:s, :news:us: system, u:user

Yes

PDN Servicespdn:s, pdn:d, pdn:i, pdn:g, pdn:c

Yes

SPI ServicesSPI::NOR, SPI::CD2, SPI::CS2, SPI::CS3, SPI::DEF

Yes

Loader ServicesLoader

Yes

MCU Servicesmcu::CAM, mcu::GPU, mcu::HID, mcu::RTC, mcu::SND, mcu::NWM, mcu::HWC, mcu::PLS, mcu::CDC

Yes

MIC Servicesmic:u

Yes

ACT Servicesact:a, act:ua: admin, u: user

Yes

MP Servicesmp:u

Yes

NFC Servicesnfc:dev, nfc:m, nfc:p, nfc:r, nfc:s, nfc:udev: developer, m: ? p: passthrough?, r: raw?, s: system, u: user

No

MVD Services

No

QTM Services

List of PXI services:

List of ports:

See Error codes.