mirror of
https://github.com/shadps4-emu/shadPS4.git
synced 2025-07-22 10:04:39 +00:00
Created III. Guide of＜Critical＞log (markdown)
Hermite
parent
61fbc73960
commit
7b22718640
54
III.-Guide-of＜Critical＞log.md
Normal file
54
III.-Guide-of＜Critical＞log.md
Normal file
@ -0,0 +1,54 @@
|
||||
## Explanation of ＜Critical＞ ?
|
||||
A**＜Critical＞**error in shadPS4 is a major failure that prevents a game from running. These errors happen when shadPS4 cannot properly emulate essential game functions, causing crashes or freezes. Until the issue is fixed, the game cannot be launched or played.
|
||||
|
||||
***
|
||||
|
||||
## Assertion Failed (AF) - Detailed Explanation
|
||||
An **Assertion Failed (AF)** occurs when the program encounters an unexpected situation that violates an internal assumption. Assertions are used in the code to check for conditions that should always be true. When an assertion fails, it indicates that something went wrong, and the emulator cannot proceed further due to the violation of expected behavior.
|
||||
|
||||
This can happen in various parts of the emulator, such as memory handling, GPU operations, or shader processing. For example, if the emulator tries to access invalid memory or encounters a corrupted data structure, the assertion will fail, causing an error. These issues are often platform-specific and depend on the underlying hardware and software assumptions that the emulator relies on.
|
||||
|
||||
| Label | Description | Number of issues |
|
||||
|-----------------------------------|-------------------------------------------------------------------------------------------------|-----------------|
|
||||
| **AF:address_space** | These are usually platform-specific memory issues. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aaddress_space%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aaddress_space%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:ajm_at9** | Atrac9 audio decoding failed in libSceAjm. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aajm_at9%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aajm_at9%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:decode** | Issues related to decoding process. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Adecode%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Adecode%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:emit_spirv_context_get_set** | Issues related to emitting SPIR-V context get/set operations. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aemit_spirv_context_get_set%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aemit_spirv_context_get_set%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:equeue** | A critical error occurred in our libkernel event queues emulation. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aequeue%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aequeue%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:gnmdriver** | A critical error occurred in libSceGnmDriver. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Agnmdriver%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Agnmdriver%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:image** | Image-related issues or errors. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aimage%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aimage%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:memory** | A critical error occurred in our libkernel memory emulation. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Amemory%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Amemory%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:page_manager** | A critical error occurred in our GPU memory handling. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Apage_manager%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Apage_manager%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:resource_tracking_pass** | Issues related to resource tracking pass. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Aresource_tracking_pass%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Aresource_tracking_pass%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:semaphore** | A critical error occurred in our pthread semaphore emulation. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Asemaphore%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Asemaphore%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:structured_control_flow** | A game is using unimplemented shader opcodes. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Astructured_control_flow%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Astructured_control_flow%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:texture_cache** | Issues with texture cache handling. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Atexture_cache%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Atexture_cache%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:tile_manager** | Problems related to tile manager. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Atile_manager%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Atile_manager%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:tls** | A critical error occurred while preparing thread-local storage. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Atls%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Atls%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vector_alu** | Issues related to vector ALU operations. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avector_alu%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avector_alu%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vector_memory** | A critical error occurred in our emulation of buffer and image shader opcodes. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avector_memory%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avector_memory%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:video_out** | A critical error occurred in our libSceVideoOut emulation. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avideo_out%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avideo_out%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vk_compute_pipeline** | Issues with the Vulkan compute pipeline. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avk_compute_pipeline%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avk_compute_pipeline%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vk_graphics_pipeline** | A critical error occurred while trying to render graphics. These are usually GPU vendor-specific. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avk_graphics_pipeline%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avk_graphics_pipeline%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vk_presenter** | Issues related to Vulkan presenter. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avk_presenter%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avk_presenter%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vk_rasterizer** | A critical error occurred while trying to render graphics. These are usually GPU vendor-specific. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avk_rasterizer%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avk_rasterizer%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **AF:vk_scheduler** | A critical error occurred in the user's GPU driver. These are usually GPU vendor-specific. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22AF%3Avk_scheduler%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22AF%3Avk_scheduler%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
|
||||
***
|
||||
|
||||
|
||||
## Unreachable Code (UC) - Detailed Explanation
|
||||
An **Unreachable Code (UC)** error occurs when the program encounters a piece of code that cannot be executed under any circumstance. This might be caused by logic flaws in the emulator or issues in the code that prevent certain sections from being reached, like incorrect branching or missing implementation for a specific scenario. Unreachable code in an emulator often indicates incomplete emulation or a misinterpretation of the PS4’s architecture.
|
||||
|
||||
In the context of emulators, unreachable code errors can occur when a game makes a request or call that isn't yet supported by the emulator, or the code path has never been properly implemented. It’s typically a result of the emulator not recognizing or handling certain game instructions properly, which leads to code paths being skipped over entirely.
|
||||
|
||||
| Label | Description | Number of issues |
|
||||
|-------------------------------|-------------------------------------------------------------------|-----------------|
|
||||
| **UC:ajm_instance** | A critical error occurred in our libSceAjm implementation. This is usually an unimplemented codec. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Aajm_instance%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Aajm_instance%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:exception** | The game threw an exception, usually as a result of internal error. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Aexception%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Aexception%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:image_info** | Issues with image information | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Aimage_info%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Aimage_info%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:liverpool_to_vk** | A critical error occurred while translating PS4 GPU behaviors to Vulkan. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Aliverpool_to_vk%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Aliverpool_to_vk%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:liverpool** | A critical error occurred while reading PM4 packets sent by the game. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Aliverpool%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Aliverpool%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:scalar_memory** | A game is using unimplemented behavior in our S_LOAD_DWORD shader opcode emulation. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Ascalar_memory%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Ascalar_memory%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:signals** | Some form of critical exception occurred. | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Asignals%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Asignals%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
| **UC:translate** | Issues related to translation | <a href="https://github.com/shadps4-emu/shadps4-game-compatibility/issues?q=label%3A%22UC%3Atranslate%22"><img src="https://img.shields.io/github/issues-search/shadps4-emu/shadps4-game-compatibility?query=label%3A%22UC%3Atranslate%22&style=for-the-badge&color=FF5C1A&label=Games%20affected:" /></a> |
|
||||
Loading…
Reference in New Issue
Block a user