12.1 How to Trigger File System Access Errors
This chapter outlines methods of triggering specific errors when accessing save data or other files, in order to check whether the application is handling these errors properly.
12.1.1 Card-Based Applications
When Mounting CARD1 Save Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFormatted |
Perform the following steps.
|
nn::fs::ResultBadFormat |
Perform the following steps.
|
nn::fs::ResultVerificationFailed |
Perform the following steps.
|
Unexpected Error | (Under investigation) |
When Mounting CARD2 Save Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFormatted | (Under investigation) |
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultVerificationFailed |
Perform the following steps.
|
Unexpected Error | (Under investigation) |
When Mounting Save Data Archives of Other Applications
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound |
Perform any of the following:
|
When Mounting Extra Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound |
Perform any of the following:
|
nn::fs::ResultMediaNotFound |
Perform any of the following:
|
nn::fs::ResultNotFormatted |
Insert an SD card containing the application’s extra data into a computer. Delete the following directory or file on the SD Card.
|
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultVerificationFailed |
Insert an SD card containing the extra data into a computer. Open the following file on the SD card in a hex editor, and tamper with the first 4 KB of data.
|
nn::fs::ResultOperationDenied |
Insert an SD card containing the application’s extra data into a computer. Set the following directory or file on the SD card to read-only.
|
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Make the amount of free space on the SD card extremely low (TBD bytes or less available). |
Unexpected Error | (Under investigation) |
When Mounting Write-Only sdmc Archives
Error | Trigger Method |
---|---|
nn::fs::ResultMediaNotFound |
Perform any of the following:
|
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultWriteProtected | This error does not occur. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Save Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound |
Perform the following steps.
|
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultVerificationFailed |
Use the SaveDataFiler tool to tamper with save data and cause an nn::fs::ResultVerificationFailed error to be returned during file and directory operations. Note: Depending on the state of the save data itself, it might not be possible to corrupt it using the SaveDataFiler tool. |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | (Under investigation) |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Extra Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound | Use SaveDataFiler to delete the file. |
nn::fs::ResultMediaNotFound | There is no way to reliably trigger this error. |
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultVerificationFailed |
Insert an SD card containing the extra data into a computer. Open the following file on the SD card in a hex editor, and tamper with the first 4 KB of data.
|
nn::fs::ResultArchiveInvalidated | Remove the SD card. |
nn::fs::ResultOperationDenied |
Insert an SD card containing the application’s extra data into a computer. Set the following directory or file on the SD card to read-only.
|
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Reduce the amount of free space on the SD card until it is less than the size of the file you are attempting to write. |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Write-Only sdmc Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound | (Under investigation) |
nn::fs::ResultMediaNotFound |
Perform any of the following:
|
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultArchiveInvalidated | Remove the SD card. |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Reduce the amount of free space on the SD card until it is less than the size of the file you are attempting to write. |
Unexpected Error | (Under investigation) |
12.1.2 Downloadable Applications
When Mounting Save Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFormatted | Use SaveDataFiler to delete the save data archive. |
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultVerificationFailed |
Insert an SD Card with the application into a computer. Open the following file on the SD Card in a hex editor and tamper with the first 4 KB of data.
|
Unexpected Error | (Under investigation) |
When Mounting Save Data Archives of Other Applications
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound |
Perform any of the following:
|
When Mounting Extra Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound | Delete the extra data archive. |
nn::fs::ResultMediaNotFound | (Under investigation) |
nn::fs::ResultNotFormatted |
Insert an SD card containing the application’s extra data into a computer. Delete the following directory or file on the SD Card.
|
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultVerificationFailed |
Insert an SD card containing the extra data into a computer. Open the following file on the SD card in a hex editor, and tamper with the first 4 KB of data.
|
nn::fs::ResultOperationDenied |
Insert an SD card containing the application’s extra data into a computer. Set the following directory or file on the SD card to read-only.
|
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Make the amount of free space on the SD card extremely low (TBD bytes or less available). |
Unexpected Error | (Under investigation) |
When Mounting Write-Only sdmc Archives
Error | Trigger Method |
---|---|
nn::fs::ResultMediaNotFound | (Under investigation) |
nn::fs::ResultBadFormat | (Under investigation) |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultWriteProtected | This error does not occur. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Save Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound |
Perform the following steps.
|
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultVerificationFailed |
Use the SaveDataFiler tool to tamper with save data and cause an nn::fs::ResultVerificationFailed error to be returned during file and directory operations. Note: Depending on the state of the save data itself, it might not be possible to corrupt it using the SaveDataFiler tool. |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | (Under investigation) |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Extra Data Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound | Use SaveDataFiler to delete the file. |
nn::fs::ResultMediaNotFound | There is no way to reliably trigger this error. |
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultVerificationFailed |
Insert an SD card containing the extra data into a computer. Open the following file on the SD card in a hex editor, and tamper with the first 4 KB of data.
|
nn::fs::ResultArchiveInvalidated | (Under investigation) |
nn::fs::ResultOperationDenied |
Insert an SD card containing the application’s extra data into a computer. Set the following directory or file on the SD card to read-only.
|
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Reduce the amount of free space on the SD card until it is less than the size of the file you are attempting to write. |
Unexpected Error | (Under investigation) |
When Operating on Files or Directories in Write-Only sdmc Archives
Error | Trigger Method |
---|---|
nn::fs::ResultNotFound | (Under investigation) |
nn::fs::ResultMediaNotFound | (Under investigation) |
nn::fs::ResultAlreadyExists | (Under investigation) |
nn::fs::ResultArchiveInvalidated | (Under investigation) |
nn::fs::ResultOperationDenied | (Under investigation) |
nn::fs::ResultWriteProtected | Slide the write-prevention tab on the SD card to "lock" the card. |
nn::fs::ResultMediaAccessError | This error occurs when hardware is the cause, such as when the media is making bad contact, but there is no way to reliably trigger it. |
nn::fs::ResultNotEnoughSpace | Reduce the amount of free space on the SD card until it is less than the size of the file you are attempting to write. |
Unexpected Error | (Under investigation) |