Difference between revisions of "SD Filesystem"

From Nintendo Switch Brew
Jump to navigation Jump to search
(wiki editing is hard)
 
(4 intermediate revisions by 2 users not shown)
Line 9: Line 9:
  
 
== Album ==
 
== Album ==
Contains the screenshots: "YYYY/MM/DD/<hex>.jpg". These are [[Capture_services#Notes|MAC]]'d, contents with an invalid MAC will display an error on view.
+
Contains the screenshots: "YYYY/MM/DD/<[[Capture_services#AlbumFileDateTime|DateTime string]]>-<title-specific hex ID string>.jpg". These are [[Capture_services#Notes|MAC]]'d, contents with an invalid MAC will display an error on view.
 +
 
 +
When an Application recorded video via [[Applet_Manager_services#CreateMovieMaker|MovieMaker]], the "Extra" sub-directory contains the recorded Application videos: "/Extra/<title-specific hex ID string>/YYYY/MM/DD/<[[Capture_services#AlbumFileDateTime|DateTime string]]>-<ID string>.mp4".
 +
 
 +
"<title-specific hex ID string>" is the same for both screenshots and "Extra".
  
 
== save ==
 
== save ==
Line 19: Line 23:
  
 
== Contents ==
 
== Contents ==
It seems this directory didn't exist until [[2.0.0]].
+
Contains directories "placehld" and "registered", which didn't exist until [[2.0.0]].
  
Contains directories "placehld" and "registered".
+
Also contains file "private", which stores the 0x10 [[Filesystem_services#SetSdCardEncryptionSeed|sd card seed verification vector]].  
  
Also contains file "private", which stores the 0x10 [[Filesystem_services#SetSdCardEncryptionSeed|sd card seed verification vector]].  
+
[4.0.0+] Also contains file "private1", which stores 0x20 bytes with the last 0x10 being random.
  
===placehld and registered ===
+
=== placehld and registered ===
 
"placehld" and "registered" store game contents; contents are initially downloaded temporarily into the "placehld" folder, and then [[NCM_services#IContentStorage|moved into the registered folder]] when downloading is complete.  
 
"placehld" and "registered" store game contents; contents are initially downloaded temporarily into the "placehld" folder, and then [[NCM_services#IContentStorage|moved into the registered folder]] when downloading is complete.  
  
Line 32: Line 36:
 
No titleIDs are stored in any directories/filenames here.
 
No titleIDs are stored in any directories/filenames here.
  
All hex IDs(below 000000XX and NcaId) used here are unique per title/content. XX is calculated as the first byte from the output of SHA-256(NcaId).
+
All hex IDs (shown below as 000000XX and [[NCM_services#NcaID|NcaId]]) used here are unique per title/content. XX is calculated as the first byte from the output of the binary SHA-256(Nca directory).
  
 
Game contents are stored inside [[NAX0]] archives; due to the 4 GB filesize limit on FAT32, contents that are bigger than 4 GB have additional file contents automatically split into separate files. This automatic file-splitting occurs even on exFAT SD cards where it is not necessary.
 
Game contents are stored inside [[NAX0]] archives; due to the 4 GB filesize limit on FAT32, contents that are bigger than 4 GB have additional file contents automatically split into separate files. This automatic file-splitting occurs even on exFAT SD cards where it is not necessary.
Line 38: Line 42:
 
  <sub-directory under Contents>
 
  <sub-directory under Contents>
 
  └── <directories with upper-case hex: 000000XX>
 
  └── <directories with upper-case hex: 000000XX>
     └── <lowercase hex [[Content_Manager_services|NcaId]]>.nca
+
     └── <lower-case hex Nca directory>.nca
 
         └── 00 [[NAX0|actual file for data storage]]
 
         └── 00 [[NAX0|actual file for data storage]]
 
         └── 01 (storage for file data at +4GB in the actual NCA)
 
         └── 01 (storage for file data at +4GB in the actual NCA)
 
         └── {etc}
 
         └── {etc}

Latest revision as of 19:03, 17 March 2020

Overview

sd
└── Nintendo
    ├── Album
    ├── Contents
    └── save

All files stored under the Contents sub-directories and save/ use the NAX0 format.

Album

Contains the screenshots: "YYYY/MM/DD/<DateTime string>-<title-specific hex ID string>.jpg". These are MAC'd, contents with an invalid MAC will display an error on view.

When an Application recorded video via MovieMaker, the "Extra" sub-directory contains the recorded Application videos: "/Extra/<title-specific hex ID string>/YYYY/MM/DD/<DateTime string>-<ID string>.mp4".

"<title-specific hex ID string>" is the same for both screenshots and "Extra".

save

Contains system-only savedata "8000000000000000" and "8000000000000124".

8000000000000000 is a FS module save describing the other system savedata on the SD card (normally only 8000000000000124).

8000000000000124 is the NCM module save describing what contents are installed to the SD card.

Contents

Contains directories "placehld" and "registered", which didn't exist until 2.0.0.

Also contains file "private", which stores the 0x10 sd card seed verification vector.

[4.0.0+] Also contains file "private1", which stores 0x20 bytes with the last 0x10 being random.

placehld and registered

"placehld" and "registered" store game contents; contents are initially downloaded temporarily into the "placehld" folder, and then moved into the registered folder when downloading is complete.

Some of the "placehld/<hex>" directories are temp-only and don't get moved into "registered".

No titleIDs are stored in any directories/filenames here.

All hex IDs (shown below as 000000XX and NcaId) used here are unique per title/content. XX is calculated as the first byte from the output of the binary SHA-256(Nca directory).

Game contents are stored inside NAX0 archives; due to the 4 GB filesize limit on FAT32, contents that are bigger than 4 GB have additional file contents automatically split into separate files. This automatic file-splitting occurs even on exFAT SD cards where it is not necessary.

<sub-directory under Contents>
└── <directories with upper-case hex: 000000XX>
    └── <lower-case hex Nca directory>.nca
        └── 00 actual file for data storage
        └── 01 (storage for file data at +4GB in the actual NCA)
        └── {etc}