nn::boss::NsaDownloadAction Class

class NsaDownloadAction : public nn::boss::TaskAction

Class for representing NADL tasks. Use this to do such things as register NADL tasks. (* There are notes regarding use with SDK version 0.13.)

NADL tasks are tasks to download data via HTTP/HTTPS from a BOSS data server. You must register data to be downloaded by applications to a BOSS data server. Data registered to a BOSS data server is converted to the Nintendo archive (NS archive) proprietary format. NS archives can contain multiple data files, so register multiple files together to a BOSS server to have those files downloaded as a single task (such as application data, related notification data, and other files). The individual data files (NS data) included in an NS archive are all encrypted, signed, and hashed.

Downloaded data is unencrypted and verified by the BOSS library, and problem-free NS data is then passed on to the target applications. Applications that use NADL tasks to receive NS data must register BOSS storage (a memory region dedicated to BOSS data, created in the extended save data memory region). Applications can read the data delivered to BOSS storage via the BOSS library.

SDK 0.13 Notes
- When using NADL tasks with SDK 0.13, you must create a boss folder at the root of an SD Card. (Provisional measure until the file system fully supports BOSS storage. The boss daemon uses this folder as BOSS storage.)
- With this provisional measure, the boss folder on the SD Card is used as shared BOSS storage for all applications.
Consequently, when registering NADL tasks from multiple applications, you must use NS data serial IDs that are unique among all applications (in other words, make sure no NS data has duplicate serial IDs).
(Otherwise, data with duplicate serial IDs is viewed as the same data, and the download data for one application might be overwritten with the download data for another application. Once the file system fully supports BOSS storage, serial IDs must only be unique to each specific application. Different applications can then use the same serial IDs for NS data without causing problems.)

nn::boss::TaskActionBase
  nn::boss::TaskAction
    nn::boss::NsaDownloadAction

2010/09/16

Initial version.