Fix some stuff in the stats page + add NID guesses by GrayJack

artart78 · artart78 · commit cf928236b157 · 2026-01-03T21:06:30.000+01:00
diff --git a/PSPLibDoc/kd/impose_01g.csv b/PSPLibDoc/kd/impose_01g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,10818334,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,5179444F,sceAudioRoutingGetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,DE26E31E,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,ED5795F1,sceAudioRoutingGetMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_02g.csv b/PSPLibDoc/kd/impose_02g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,10818334,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,5179444F,sceAudioRoutingGetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,DE26E31E,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,ED5795F1,sceAudioRoutingGetMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_03g.csv b/PSPLibDoc/kd/impose_03g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,10818334,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,5179444F,sceAudioRoutingGetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,DE26E31E,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,ED5795F1,sceAudioRoutingGetMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_04g.csv b/PSPLibDoc/kd/impose_04g.csv
@@ -2,10 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
-sceAudioRouting_driver,fun,051E312A,sceAudioRouting_driver_051E312A,
-sceAudioRouting_driver,fun,1A4BE166,sceAudioRouting_driver_1A4BE166,
-sceAudioRouting_driver,fun,40AE4390,sceAudioRouting_driver_40AE4390,
-sceAudioRouting_driver,fun,800B51A0,sceAudioRouting_driver_800B51A0,
+sceAudioRouting_driver,fun,051E312A,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,1A4BE166,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,40AE4390,sceAudioRoutingGetMode,name of the userland alias
+sceAudioRouting_driver,fun,800B51A0,sceAudioRoutingGetVolumeMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
 sceImpose,fun,36AA6E91,sceImposeSetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_05g.csv b/PSPLibDoc/kd/impose_05g.csv
@@ -2,10 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
-sceAudioRouting_driver,fun,051E312A,sceAudioRouting_driver_051E312A,
-sceAudioRouting_driver,fun,1A4BE166,sceAudioRouting_driver_1A4BE166,
-sceAudioRouting_driver,fun,40AE4390,sceAudioRouting_driver_40AE4390,
-sceAudioRouting_driver,fun,800B51A0,sceAudioRouting_driver_800B51A0,
+sceAudioRouting_driver,fun,051E312A,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,1A4BE166,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,40AE4390,sceAudioRoutingGetMode,name of the userland alias
+sceAudioRouting_driver,fun,800B51A0,sceAudioRoutingGetVolumeMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
 sceImpose,fun,36AA6E91,sceImposeSetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_07g.csv b/PSPLibDoc/kd/impose_07g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,0758D3D3,sceAudioRoutingGetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,1A61C31F,sceAudioRoutingGetMode,name of the userland alias
+sceAudioRouting_driver,fun,2EAFCDB3,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,DE1B32A8,sceAudioRoutingSetMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_09g.csv b/PSPLibDoc/kd/impose_09g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,0758D3D3,sceAudioRoutingGetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,1A61C31F,sceAudioRoutingGetMode,name of the userland alias
+sceAudioRouting_driver,fun,2EAFCDB3,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,DE1B32A8,sceAudioRoutingSetMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/impose_11g.csv b/PSPLibDoc/kd/impose_11g.csv
@@ -2,6 +2,10 @@ sceAudioRouting,fun,28235C56,sceAudioRoutingGetVolumeMode,matching
 sceAudioRouting,fun,36FD8AA9,sceAudioRoutingSetMode,matching
 sceAudioRouting,fun,39240E7D,sceAudioRoutingGetMode,matching
 sceAudioRouting,fun,BB548475,sceAudioRoutingSetVolumeMode,matching
+sceAudioRouting_driver,fun,18B6F449,sceAudioRoutingSetMode,name of the userland alias
+sceAudioRouting_driver,fun,44B384EF,sceAudioRoutingSetVolumeMode,name of the userland alias
+sceAudioRouting_driver,fun,931ABEF5,sceAudioRoutingGetMode,name of the userland alias
+sceAudioRouting_driver,fun,D82D02FD,sceAudioRoutingGetVolumeMode,name of the userland alias
 sceImpose,fun,0F341BE4,sceImposeGetHomePopup,matching
 sceImpose,fun,133636DD,sceImpose_133636DD,
 sceImpose,fun,24FD7BCF,sceImposeGetLanguageMode,matching
diff --git a/PSPLibDoc/kd/loadcore.csv b/PSPLibDoc/kd/loadcore.csv
@@ -40,10 +40,10 @@ LoadCoreForKernel,fun,5248A98F,sceKernelLoadModuleBootLoadCore,matching
 LoadCoreForKernel,fun,A6D40F56,sceKernelGetModuleGPByAddressForKernel,matching
 LoadCoreForKernel,fun,A8E2D53D,sceKernelMaskLibraryEntries,matching
 LoadCoreForKernel,fun,C0913394,sceKernelLinkLibraryEntriesWithModule,matching
-LoadCoreForKernel,fun,4440853B,sceKernelLoadCoreLock,
-LoadCoreForKernel,fun,FA3101A4,sceKernelLoadCoreUnlock,
-LoadCoreForKernel,fun,CDCAA8B2,sceKernelSegmentChecksum,
-LoadCoreForKernel,fun,EC20C661,sceKernelLoadRebootBin,
+LoadCoreForKernel,fun,4440853B,sceKernelLoadCoreLock,jigkick 5.02 loadcorei.prx symbols
+LoadCoreForKernel,fun,FA3101A4,sceKernelLoadCoreUnlock,jigkick 5.02 loadcorei.prx symbols
+LoadCoreForKernel,fun,CDCAA8B2,sceKernelSegmentChecksum,jigkick 5.02 loadcorei.prx symbols
+LoadCoreForKernel,fun,EC20C661,sceKernelLoadRebootBin,jigkick 5.02 loadcorei.prx symbols
 sceLoadCoreForUser,fun,DA1B09AA,sceKernelUnLinkLibraryEntries,matching
 syslib,fun,D3744BE0,module_bootstart,matching
 syslib,var,F01D73A7,module_info,matching
diff --git a/README.md b/README.md
@@ -6,8 +6,16 @@ Page with the current NID status for each library can be found [here](https://ps
 ## Usage
 ### How to contribute
 Just edit the CSV files in PSPLibDoc/ and submit a pull request.
+There is one CSV file per PRX file (module) and the columns are:
+- library name
+- fun/var (function or variable export)
+- NID
+- name
+- source of the NID: "matching" is reserved for names whose hash actually matches the NID; otherwise it can be any indication where or why that name was guessed.
 
-You can update the CSV files using the psp_libdoc.py script (see below).
+By convention, unknown names will be specified as `<library>_<NID>` (eg `LoadCoreForKernel_4440853B`).
+
+You can also update the CSV files using the psp_libdoc.py script (see below).
 
 If you are motivated enough to rebuild the XML files (which is the common psplibdoc format used by various tools), run the `build_xml_from_csv.sh` script (it takes some time to run). Otherwise the XMLs will be updated later.
 
@@ -88,5 +96,5 @@ A big thanks goes to
  - All original PSPLibDoc contributers
  - All PPSSPP contributers for additional user library symbols
  - All uOFW contributors for updated 6.60 and 6.61 symbols
- - artart78, Draan, efonte, GrapheneCt, sajattack, SilverSpring, zecoxao, Spenon-Dev for additional symbol sources and NIDs
+ - artart78, Draan, efonte, GrapheneCt, sajattack, SilverSpring, zecoxao, Spenon-Dev, GrayJack for additional symbol sources and NIDs
  - Spenon-Dev for the original repo [here](https://github.com/Spenon-dev/PSPLibDoc)
diff --git a/build_stats_pages.py b/build_stats_pages.py
@@ -13,12 +13,12 @@
 # List of colors & descriptions for each "category" of NID
 HTML_STATUS = [
     # for both obfuscated and non-obfuscated
-    ("known", "green", "matching the name hash"),
+    ("guess", "yellow", "guessed"),
     # for non-obfuscated
+    ("known", "green", "matching the name hash"),
     ("unknown", "orange", "unknown"),
-    ("wrong", "red", "not matching the name hash"),
     # for obfuscated
-    ("obf_ok", "yellow", "obfuscated but matching a previously known name"),
+    ("obf_ok", "yellow", "obfuscated but matching a previously known or guessed name"),
     ("obf_unk", "orange", "unknown but non-obfuscated in a previous version"),
     ("obf_new", "grey", "present only as obfuscated")
 ]
@@ -74,19 +74,16 @@ def html_library(module, lib, stats_byver, versions):
             if status == "total" or status == "is_obf":
                 continue
             for cur_nid in stats_byver[ver][status]:
-                status_bynid[cur_nid["nid"]] = status
+                if cur_nid["nid"] not in status_bynid:
+                    status_bynid[cur_nid["nid"]] = status
     cnt = Counter(status_bynid.values())
-    both_stats = []
-    nonobf_ok = cnt["known"]
-    nonobf_total = nonobf_ok + cnt["wrong"] + cnt["unknown_nonobf"] + cnt["unknown"]
-    obf_ok = cnt["nok_from_previous"] + cnt["nok_dubious"]
-    obf_total = obf_ok + cnt["unknown_obf"]
-    if nonobf_total != 0:
-        both_stats.append("%.1f%% (%d/%d)" % (nonobf_ok / nonobf_total * 100, nonobf_ok, nonobf_total))
-    if obf_total != 0:
-        both_stats.append("%.1f%% (%d/%d)" % (obf_ok / obf_total * 100, obf_ok, obf_total))
-    agg_stats = " / ".join(both_stats)
-    output += f"""<td style="white-space: nowrap;">{agg_stats}</td>"""
+    ok = cnt["known"] + cnt["guess"]
+    nok = cnt["unknown"] + cnt["obf_new"]
+    total = ok + nok
+    if total == 0:
+        total = cnt["obf_unk"]
+    stat = "%.1f%% (%d/%d)" % (ok / total * 100, ok, total)
+    output += f"""<td style="white-space: nowrap;">{stat}</td>"""
 
     # Make a column for each firmware version
     for ver in versions:
@@ -177,22 +174,25 @@ def html_single_library(module, lib, stats_bynid, versions):
 # Build the statistics for a given library at a given version.
 def make_stats(module, lib, version, cur_nids, nid_names, obfuscation_pairs):
     unk_nids = []
-    nok_nids = []
     ok_nids = []
     obf_ok_nids = []
     obf_unk_nids = []
     obf_new_nids = []
+    guess_nids = []
     is_obf = False
-    # Sort NIDs by category: unknown (name ends with the NID), ok (NID matches the hash) and nok (NID doesn't match the hash)
     for cur_nid in cur_nids:
         fullname = lib + '_' + cur_nid
-        # TODO: handle guesses
+        # If name is in the CSV, sort NIDs by category: ok (NID matches the hash), unknown (uses default name, ends with the NID) and guesses (the rest)
         if fullname in nid_names:
+            nid_obj = {"nid": cur_nid, "name": nid_names[fullname][0], "source": nid_names[fullname][1]}
             if nid_names[fullname][1] == 'matching':
-                ok_nids.append({"nid": cur_nid, "name": nid_names[fullname][0], "source": nid_names[fullname][1]})
+                ok_nids.append(nid_obj)
+            elif nid_names[fullname][0].endswith(cur_nid):
+                unk_nids.append(nid_obj)
             else:
-                unk_nids.append({"nid": cur_nid, "name": nid_names[fullname][0], "source": nid_names[fullname][1]})
+                guess_nids.append(nid_obj)
         else:
+            # Otherwise, name is obfuscated, sort by category: obf_matching (matches a previous function) or obf_new (new function)
             is_obf = True
             oldername = fullname
             cycle_detect = [oldername]
@@ -205,14 +205,14 @@ def make_stats(module, lib, version, cur_nids, nid_names, obfuscation_pairs):
                     exit(1)
             oldest_nid = oldername.split('_')[-1]
             if oldername in nid_names:
-                if nid_names[oldername][1] == 'matching':
+                if not nid_names[oldername][0].endswith(oldername.split('_')[-1]): # check if name ends with NID (ie default name, no guess or match)
                     obf_ok_nids.append({"nid": oldest_nid, "name": fullname, "source": "obf_matching"})
                 else:
                     obf_unk_nids.append({"nid": oldest_nid, "name": fullname, "source": "obf_unknown"})
             else:
                 obf_new_nids.append({"nid": oldest_nid, "name": fullname, "source": "obf_new"})
 
-    stats = {"known": ok_nids, "unknown": unk_nids, "wrong": nok_nids, "obf_ok": obf_ok_nids, "obf_unk": obf_unk_nids, "obf_new": obf_new_nids}
+    stats = {"known": ok_nids, "unknown": unk_nids, "guess": guess_nids, "obf_ok": obf_ok_nids, "obf_unk": obf_unk_nids, "obf_new": obf_new_nids}
 
     stats['total'] = len(cur_nids)
     stats['is_obf'] = is_obf
