mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 02:11:36 -04:00
Alexandros Mandravillis
c1a9e52894
A failed start printed "built without recomp-net, or bind/peer invalid" for every cause. A player whose system held the UDP port read first that the build had no netplay. The library answers a refused bind, a listen address it cannot read and a peer address it cannot use with the same -1. main.cpp now does those steps again (it reads the listen address as the library does, looks up a name, binds without address reuse) and reports the system's answer. The sentence names a cause only when the system does: address in use, access denied (a port range Windows keeps for Hyper-V or WSL, a port below 1024 elsewhere), address not available. Any other error gets the number and the system's text. The peer address is named only when the listen address opened and the peer address cannot be read. The build is named only when it has no netplay. The sentences are in netplay_exit_reason.c with unit cases; a source guard checks the wiring in main.cpp.
73 lines
3.6 KiB
C
73 lines
3.6 KiB
C
/* netplay_exit_reason.h — why a netplay match ended, in words.
|
|
*
|
|
* A match that ends early returns every player to the lobby. The runtime knew
|
|
* why (netplay_soft_exit's origin) but only printed it to stdout, so players
|
|
* saw the lobby again with no reason. These map an origin to one sentence for
|
|
* the launcher's status line, and decide when a boot-digest mismatch is final.
|
|
*/
|
|
#ifndef NETPLAY_EXIT_REASON_H
|
|
#define NETPLAY_EXIT_REASON_H
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* The player-facing sentence for a netplay_soft_exit origin, or NULL when the
|
|
* player ended the match themselves (window close, Escape) or the origin is
|
|
* unknown. */
|
|
const char *netplay_exit_reason_text(const char *origin);
|
|
|
|
/* The rollback boot digests of the two peers are both known and different.
|
|
* The peers booted differently, and waiting does not fix that; before this change
|
|
* only the generic 20 s admit-stall watchdog ended it. The mismatch is final
|
|
* once the same pair of digests has held for grace_ms (the short wait lets a
|
|
* stale peer digest be replaced, and the peer reach the same verdict).
|
|
* mismatch_since_ms is 0 when there is no mismatch. */
|
|
int netplay_boot_mismatch_final(uint32_t mismatch_since_ms, uint32_t now_ms,
|
|
uint32_t grace_ms);
|
|
|
|
#define NETPLAY_BOOT_MISMATCH_GRACE_MS 3000u
|
|
|
|
/* Why a netplay start failed, in one sentence. The start reported
|
|
* every failure as "built without recomp-net, or bind/peer invalid": a player
|
|
* whose system held the port read first that the build had no netplay.
|
|
* `start_rc` is psx_netplay_start's result, `has_netplay` whether the build
|
|
* has the netplay library. For a LAN start (-3) the caller does the library's
|
|
* steps again and passes what it found: `bind_probe` and, for a refused bind
|
|
* or socket, the system's error number and text. The sentence says a cause
|
|
* only when the system's answer names one:
|
|
* address in use (Windows 10048, Linux 98, macOS 48): another program or
|
|
* the system holds the port, choose another port;
|
|
* access denied (Windows 10013, POSIX 13): the system does not allow the
|
|
* port (a range Windows keeps for Hyper-V or WSL, a port below 1024
|
|
* elsewhere), choose another port;
|
|
* address not available (Windows 10049, Linux 99, macOS 49): the listen
|
|
* address is not one of this computer's, check the listen address;
|
|
* any other number: the number and the system's text, no cause.
|
|
* The peer address is named only when the listen address opened and the peer
|
|
* address cannot be read. The build is named only when it has no netplay.
|
|
* Every sentence fits the lobby client's last_error. */
|
|
enum {
|
|
NETPLAY_BIND_NOT_TRIED = -1, /* not a LAN start, or a build without the library */
|
|
NETPLAY_BIND_OK = 0, /* listen address opened, peer address reads well */
|
|
NETPLAY_BIND_FAILED = 1, /* the system refused the bind */
|
|
NETPLAY_BIND_BAD_ADDRESS = 2, /* the listen address is not "address:port", or its name is unknown */
|
|
NETPLAY_BIND_NO_SOCKET = 3, /* the system made no socket */
|
|
NETPLAY_BIND_PEER_BAD = 4 /* listen address opened; the peer address cannot be read */
|
|
};
|
|
#define NETPLAY_START_FAILURE_CAP 192
|
|
void netplay_start_failure_text(int start_rc, int has_netplay,
|
|
const char *bind_hostport,
|
|
const char *peer_hostport, int bind_probe,
|
|
int sys_error, const char *sys_text,
|
|
char *out, size_t cap);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* NETPLAY_EXIT_REASON_H */
|