pmdsky-debug-py 10.2.25__py3-none-any.whl → 10.2.26__py3-none-any.whl

pmdsky_debug_py/na.py

@@ -13699,7 +13699,23 @@ class NaLibsFunctions:
         None,
     )
 
-    Crypto_RC4Init = Symbol([0x9648], [0x2075720], None, "Crypto_RC4Init", "", None)
+    Crypto_RC4Init = Symbol(
+        [0x9648],
+        [0x2075720],
+        None,
+        "Crypto_RC4Init",
+        "Initializes an RC4 context.\n\nr0: context\nr1: key\nr2: key length (clamped down to a maximum of 16)",
+        None,
+    )
+
+    Crypto_RC4Encrypt = Symbol(
+        [0x96D8],
+        [0x20757B0],
+        None,
+        "Crypto_RC4Encrypt",
+        "Encrypts/decrypts a buffer using an RC4 context.\n\nr0: context\nr1: src\nr2: size\nr3: dest",
+        None,
+    )
 
     Mtx_LookAt = Symbol([0x9750], [0x2075828], None, "Mtx_LookAt", "", None)
 
@@ -14369,6 +14385,33 @@ class NaLibsFunctions:
         None,
     )
 
+    MD5_Init = Symbol(
+        [0x14024],
+        [0x20800FC],
+        None,
+        "MD5_Init",
+        "Initializes an MD5 context.\n\nr0: context",
+        None,
+    )
+
+    MD5_Update = Symbol(
+        [0x14064],
+        [0x208013C],
+        None,
+        "MD5_Update",
+        "Updates an MD5 context using a buffer's bytes.\n\nr0: context\nr1: buffer\nr2: size of buffer",
+        None,
+    )
+
+    MD5_Digest = Symbol(
+        [0x1412C],
+        [0x2080204],
+        None,
+        "MD5_Digest",
+        "Calculates and stores an MD5 hash into a destination buffer. The MD5 context is zeroed-out after this operation.\n\nr0: [output] hash buffer (16 bytes)\nr1: context",
+        None,
+    )
+
     PM_ForceToPowerOff = Symbol(
         [0x15F34],
         [0x208200C],
@@ -17856,6 +17899,249 @@ class NaOverlay0Functions:
         None,
     )
 
+    close = Symbol(
+        [0x11E54],
+        [0x22CE8D4],
+        None,
+        "close",
+        "Closes a file descriptor.\n\nr0: file descriptor\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    socket = Symbol(
+        [0x1272C],
+        [0x22CF1AC],
+        None,
+        "socket",
+        "Creates a socket file descriptor for network activity.\n\nr0: domain\nr1: family\nr2: protocol\nreturn: socket file descriptor on success, negative value indicating error otherwise",
+        None,
+    )
+
+    bind = Symbol(
+        [0x12758],
+        [0x22CF1D8],
+        None,
+        "bind",
+        "Binds a socket to an address.\n\nr0: socket file descriptor\nr1: address\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    connect = Symbol(
+        [0x12784],
+        [0x22CF204],
+        None,
+        "connect",
+        "Connects a socket to an address.\n\nr0: socket file descriptor\nr1: address\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    recv = Symbol(
+        [0x127E0],
+        [0x22CF260],
+        None,
+        "recv",
+        "Receives a message from a connected socket.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes read, or a negative value representing an error",
+        None,
+    )
+
+    recvfrom = Symbol(
+        [0x12804],
+        [0x22CF284],
+        None,
+        "recvfrom",
+        "Receives a message from a connectionless socket, also returning the source address that sent data.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nstack[0]: destination address; can be NULL\nstack[1]: length of destination address\nreturn: number of bytes read, or a negative value representing an error",
+        None,
+    )
+
+    send = Symbol(
+        [0x12894],
+        [0x22CF314],
+        None,
+        "send",
+        "Sends a message to a connected socket.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes sent, or a negative value representing an error",
+        None,
+    )
+
+    sendto = Symbol(
+        [0x128B8],
+        [0x22CF338],
+        None,
+        "sendto",
+        "Sends a message to a connectionless socket.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nstack[0]: target address\nstack[1]: length of target address\nreturn: number of bytes sent, or a negative value representing an error",
+        None,
+    )
+
+    CloseVeneer = Symbol(
+        [0x12948],
+        [0x22CF3C8],
+        None,
+        "CloseVeneer",
+        "Likely a linker-generated veneer for close.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: file descriptor\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    fcntl = Symbol(
+        [0x12B4C],
+        [0x22CF5CC],
+        None,
+        "fcntl",
+        "Performs an operation on a file descriptor.\n\nr0: file descriptor\nr1: operation\nr2: operation-specific argument\nreturn: operation-specific value",
+        None,
+    )
+
+    InitWfc = Symbol(
+        [0x1AD14],
+        [0x22D7794],
+        None,
+        "InitWfc",
+        "Just a guess. Repeatedly calling this eventually results in a DNS query for conntest.nintendowifi.net and allows for use of the socket functions.\n\nreturn: status?",
+        None,
+    )
+
+    SocketCastError = Symbol(
+        [0x38508],
+        [0x22F4F88],
+        None,
+        "SocketCastError",
+        "Casts a value to a new value, if it is negative. Mostly used in socket functions to cast any potential errors to -1.\n\nr0: original value\nr1: new value to cast an error as, if original value is negative\nreturn: original value if non-negative, new value otherwise",
+        None,
+    )
+
+    SocketCreate = Symbol(
+        [0x38520],
+        [0x22F4FA0],
+        None,
+        "SocketCreate",
+        "A wrapper for socket, casting any errors to -1.\n\nr0: domain\nr1: family\nr2: protocol\nreturn: socket file descriptor on success, -1 on an error",
+        None,
+    )
+
+    SocketClose = Symbol(
+        [0x38534],
+        [0x22F4FB4],
+        None,
+        "SocketClose",
+        "A wrapper for close, casting any errors to -1.\n\nr0: file descriptor\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketBind = Symbol(
+        [0x3855C],
+        [0x22F4FDC],
+        None,
+        "SocketBind",
+        "A wrapper for bind, casting any errors to -1.\n\nr0: socket file descriptor\nr1: address\nr2: length of address\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketConnect = Symbol(
+        [0x385BC],
+        [0x22F503C],
+        None,
+        "SocketConnect",
+        "A wrapper for connect, casting any errors to -1.\n\nr0: socket file descriptor\nr1: address\nr2: length of address\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketRecv = Symbol(
+        [0x38608],
+        [0x22F5088],
+        None,
+        "SocketRecv",
+        "A wrapper for recv, casting any errors to -1.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes read, or -1 on an error",
+        None,
+    )
+
+    SocketRecvFrom = Symbol(
+        [0x3861C],
+        [0x22F509C],
+        None,
+        "SocketRecvFrom",
+        "A wrapper for recvfrom, casting any errors to -1.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nstack[0]: destination address; can be NULL\nstack[1]: length of destination address\nreturn: number of bytes read, or -1 on an error",
+        None,
+    )
+
+    SocketSend = Symbol(
+        [0x3864C],
+        [0x22F50CC],
+        None,
+        "SocketSend",
+        "A wrapper for send, casting any errors to -1.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes sent, or -1 on an error",
+        None,
+    )
+
+    SocketSendTo = Symbol(
+        [0x38660],
+        [0x22F50E0],
+        None,
+        "SocketSendTo",
+        "A wrapper for sendto, casting any errors to -1.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nstack[0]: target address\nstack[1]: length of target address\nreturn: number of bytes sent, or -1 on an error",
+        None,
+    )
+
+    SocketSetBlocking = Symbol(
+        [0x3881C],
+        [0x22F529C],
+        None,
+        "SocketSetBlocking",
+        "Sets a socket to be blocking or non-blocking.\n\nr0: socket file descriptor\nr1: blocking flag\nreturn: success",
+        None,
+    )
+
+    DoRand = Symbol(
+        [0x38B78],
+        [0x22F55F8],
+        None,
+        "DoRand",
+        "Generates a pseudorandom integer provided a parameter.\n\nr0: ctx\nreturn: pseudorandom integer",
+        None,
+    )
+
+    rand = Symbol(
+        [0x38BC4],
+        [0x22F5644],
+        None,
+        "rand",
+        "Generates a new pseudorandom integer from the current PRNG sequence number and updates it.\n\nreturn: psuedorandom integer",
+        None,
+    )
+
+    srand = Symbol(
+        [0x38BE4],
+        [0x22F5664],
+        None,
+        "srand",
+        "Seeds a PRNG sequence number used by rand.\n\nr0: seed",
+        None,
+    )
+
+    RandRangeOverlay0 = Symbol(
+        [0x38C00],
+        [0x22F5680],
+        None,
+        "RandRangeOverlay0",
+        "Generates a new pseudorandom integer by performing (rand() % (y - x) + x).\n\nr0: x\nr1: y\nreturn: pseudorandom integer on the interval [x, y - 1]",
+        None,
+    )
+
+    ResolveAvailableNintendoWifi = Symbol(
+        [0x39178],
+        [0x22F5BF8],
+        None,
+        "ResolveAvailableNintendoWifi",
+        "Seemingly resolves the IP of 'pokedungeonds.available.gs.nintendowifi.net', in which 'pokedungeonds' is provided as the first parameter.\n\nr0: string",
+        None,
+    )
+
+    PasswordEncryptString = Symbol(
+        [0x4F260],
+        [0x230BCE0],
+        None,
+        "PasswordEncryptString",
+        "Performs XOR encryption/decryption on a string, the keystream derived from srand(0x79707367) and repeatedly calling randrange(0x0, 0xFF).\n\nSeemingly called mostly for the 'passenc' field in DWC messages.\n\nr0: src\nr1: dest",
+        None,
+    )
+
 
 class NaOverlay0Data:
 
@@ -17871,7 +18157,7 @@ class NaOverlay0Data:
 
 class NaOverlay0Section:
     name = "overlay0"
-    description = "Likely contains supporting data and code related to the top menu.\n\nThis is loaded together with overlay 1 while in the top menu. Since it's in overlay group 2 (together with overlay 10, which is another 'data' overlay), this overlay probably plays a similar role. It mentions several files from the BACK folder that are known backgrounds for the top menu."
+    description = "Contains supporting data and code related to the Top Menu, as well as core networking functions.\n\nThis is loaded together with overlay 1 while in the Top Menu. Since it's in overlay group 2 (together with overlay 10, which is another 'data' overlay), this overlay probably plays a similar role. It mentions several files from the BACK folder that are known backgrounds for the Top Menu."
     loadaddress = 0x22BCA80
     length = 0x609A0
     functions = NaOverlay0Functions

pmdsky_debug_py/na_itcm.py

@@ -13512,7 +13512,23 @@ class NaItcmLibsFunctions:
         None,
     )
 
-    Crypto_RC4Init = Symbol(None, None, None, "Crypto_RC4Init", "", None)
+    Crypto_RC4Init = Symbol(
+        None,
+        None,
+        None,
+        "Crypto_RC4Init",
+        "Initializes an RC4 context.\n\nr0: context\nr1: key\nr2: key length (clamped down to a maximum of 16)",
+        None,
+    )
+
+    Crypto_RC4Encrypt = Symbol(
+        None,
+        None,
+        None,
+        "Crypto_RC4Encrypt",
+        "Encrypts/decrypts a buffer using an RC4 context.\n\nr0: context\nr1: src\nr2: size\nr3: dest",
+        None,
+    )
 
     Mtx_LookAt = Symbol(None, None, None, "Mtx_LookAt", "", None)
 
@@ -14128,6 +14144,28 @@ class NaItcmLibsFunctions:
         None,
     )
 
+    MD5_Init = Symbol(
+        None, None, None, "MD5_Init", "Initializes an MD5 context.\n\nr0: context", None
+    )
+
+    MD5_Update = Symbol(
+        None,
+        None,
+        None,
+        "MD5_Update",
+        "Updates an MD5 context using a buffer's bytes.\n\nr0: context\nr1: buffer\nr2: size of buffer",
+        None,
+    )
+
+    MD5_Digest = Symbol(
+        None,
+        None,
+        None,
+        "MD5_Digest",
+        "Calculates and stores an MD5 hash into a destination buffer. The MD5 context is zeroed-out after this operation.\n\nr0: [output] hash buffer (16 bytes)\nr1: context",
+        None,
+    )
+
     PM_ForceToPowerOff = Symbol(
         None,
         None,
@@ -17615,6 +17653,249 @@ class NaItcmOverlay0Functions:
         None,
     )
 
+    close = Symbol(
+        None,
+        None,
+        None,
+        "close",
+        "Closes a file descriptor.\n\nr0: file descriptor\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    socket = Symbol(
+        None,
+        None,
+        None,
+        "socket",
+        "Creates a socket file descriptor for network activity.\n\nr0: domain\nr1: family\nr2: protocol\nreturn: socket file descriptor on success, negative value indicating error otherwise",
+        None,
+    )
+
+    bind = Symbol(
+        None,
+        None,
+        None,
+        "bind",
+        "Binds a socket to an address.\n\nr0: socket file descriptor\nr1: address\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    connect = Symbol(
+        None,
+        None,
+        None,
+        "connect",
+        "Connects a socket to an address.\n\nr0: socket file descriptor\nr1: address\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    recv = Symbol(
+        None,
+        None,
+        None,
+        "recv",
+        "Receives a message from a connected socket.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes read, or a negative value representing an error",
+        None,
+    )
+
+    recvfrom = Symbol(
+        None,
+        None,
+        None,
+        "recvfrom",
+        "Receives a message from a connectionless socket, also returning the source address that sent data.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nstack[0]: destination address; can be NULL\nstack[1]: length of destination address\nreturn: number of bytes read, or a negative value representing an error",
+        None,
+    )
+
+    send = Symbol(
+        None,
+        None,
+        None,
+        "send",
+        "Sends a message to a connected socket.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes sent, or a negative value representing an error",
+        None,
+    )
+
+    sendto = Symbol(
+        None,
+        None,
+        None,
+        "sendto",
+        "Sends a message to a connectionless socket.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nstack[0]: target address\nstack[1]: length of target address\nreturn: number of bytes sent, or a negative value representing an error",
+        None,
+    )
+
+    CloseVeneer = Symbol(
+        None,
+        None,
+        None,
+        "CloseVeneer",
+        "Likely a linker-generated veneer for close.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: file descriptor\nreturn: 0 on success, or a negative value representing an error",
+        None,
+    )
+
+    fcntl = Symbol(
+        None,
+        None,
+        None,
+        "fcntl",
+        "Performs an operation on a file descriptor.\n\nr0: file descriptor\nr1: operation\nr2: operation-specific argument\nreturn: operation-specific value",
+        None,
+    )
+
+    InitWfc = Symbol(
+        None,
+        None,
+        None,
+        "InitWfc",
+        "Just a guess. Repeatedly calling this eventually results in a DNS query for conntest.nintendowifi.net and allows for use of the socket functions.\n\nreturn: status?",
+        None,
+    )
+
+    SocketCastError = Symbol(
+        None,
+        None,
+        None,
+        "SocketCastError",
+        "Casts a value to a new value, if it is negative. Mostly used in socket functions to cast any potential errors to -1.\n\nr0: original value\nr1: new value to cast an error as, if original value is negative\nreturn: original value if non-negative, new value otherwise",
+        None,
+    )
+
+    SocketCreate = Symbol(
+        None,
+        None,
+        None,
+        "SocketCreate",
+        "A wrapper for socket, casting any errors to -1.\n\nr0: domain\nr1: family\nr2: protocol\nreturn: socket file descriptor on success, -1 on an error",
+        None,
+    )
+
+    SocketClose = Symbol(
+        None,
+        None,
+        None,
+        "SocketClose",
+        "A wrapper for close, casting any errors to -1.\n\nr0: file descriptor\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketBind = Symbol(
+        None,
+        None,
+        None,
+        "SocketBind",
+        "A wrapper for bind, casting any errors to -1.\n\nr0: socket file descriptor\nr1: address\nr2: length of address\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketConnect = Symbol(
+        None,
+        None,
+        None,
+        "SocketConnect",
+        "A wrapper for connect, casting any errors to -1.\n\nr0: socket file descriptor\nr1: address\nr2: length of address\nreturn: 0 on success, -1 on an error",
+        None,
+    )
+
+    SocketRecv = Symbol(
+        None,
+        None,
+        None,
+        "SocketRecv",
+        "A wrapper for recv, casting any errors to -1.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes read, or -1 on an error",
+        None,
+    )
+
+    SocketRecvFrom = Symbol(
+        None,
+        None,
+        None,
+        "SocketRecvFrom",
+        "A wrapper for recvfrom, casting any errors to -1.\n\nr0: socket file descriptor\nr1: destination buffer\nr2: size of buffer\nr3: flags\nstack[0]: destination address; can be NULL\nstack[1]: length of destination address\nreturn: number of bytes read, or -1 on an error",
+        None,
+    )
+
+    SocketSend = Symbol(
+        None,
+        None,
+        None,
+        "SocketSend",
+        "A wrapper for send, casting any errors to -1.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nreturn: number of bytes sent, or -1 on an error",
+        None,
+    )
+
+    SocketSendTo = Symbol(
+        None,
+        None,
+        None,
+        "SocketSendTo",
+        "A wrapper for sendto, casting any errors to -1.\n\nr0: socket file descriptor\nr1: source buffer\nr2: size of buffer\nr3: flags\nstack[0]: target address\nstack[1]: length of target address\nreturn: number of bytes sent, or -1 on an error",
+        None,
+    )
+
+    SocketSetBlocking = Symbol(
+        None,
+        None,
+        None,
+        "SocketSetBlocking",
+        "Sets a socket to be blocking or non-blocking.\n\nr0: socket file descriptor\nr1: blocking flag\nreturn: success",
+        None,
+    )
+
+    DoRand = Symbol(
+        None,
+        None,
+        None,
+        "DoRand",
+        "Generates a pseudorandom integer provided a parameter.\n\nr0: ctx\nreturn: pseudorandom integer",
+        None,
+    )
+
+    rand = Symbol(
+        None,
+        None,
+        None,
+        "rand",
+        "Generates a new pseudorandom integer from the current PRNG sequence number and updates it.\n\nreturn: psuedorandom integer",
+        None,
+    )
+
+    srand = Symbol(
+        None,
+        None,
+        None,
+        "srand",
+        "Seeds a PRNG sequence number used by rand.\n\nr0: seed",
+        None,
+    )
+
+    RandRangeOverlay0 = Symbol(
+        None,
+        None,
+        None,
+        "RandRangeOverlay0",
+        "Generates a new pseudorandom integer by performing (rand() % (y - x) + x).\n\nr0: x\nr1: y\nreturn: pseudorandom integer on the interval [x, y - 1]",
+        None,
+    )
+
+    ResolveAvailableNintendoWifi = Symbol(
+        None,
+        None,
+        None,
+        "ResolveAvailableNintendoWifi",
+        "Seemingly resolves the IP of 'pokedungeonds.available.gs.nintendowifi.net', in which 'pokedungeonds' is provided as the first parameter.\n\nr0: string",
+        None,
+    )
+
+    PasswordEncryptString = Symbol(
+        None,
+        None,
+        None,
+        "PasswordEncryptString",
+        "Performs XOR encryption/decryption on a string, the keystream derived from srand(0x79707367) and repeatedly calling randrange(0x0, 0xFF).\n\nSeemingly called mostly for the 'passenc' field in DWC messages.\n\nr0: src\nr1: dest",
+        None,
+    )
+
 
 class NaItcmOverlay0Data:
 
@@ -17630,7 +17911,7 @@ class NaItcmOverlay0Data:
 
 class NaItcmOverlay0Section:
     name = "overlay0"
-    description = "Likely contains supporting data and code related to the top menu.\n\nThis is loaded together with overlay 1 while in the top menu. Since it's in overlay group 2 (together with overlay 10, which is another 'data' overlay), this overlay probably plays a similar role. It mentions several files from the BACK folder that are known backgrounds for the top menu."
+    description = "Contains supporting data and code related to the Top Menu, as well as core networking functions.\n\nThis is loaded together with overlay 1 while in the Top Menu. Since it's in overlay group 2 (together with overlay 10, which is another 'data' overlay), this overlay probably plays a similar role. It mentions several files from the BACK folder that are known backgrounds for the Top Menu."
     loadaddress = None
     length = None
     functions = NaItcmOverlay0Functions