mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 18:25:35 -04:00
Matthew Stanley
fe42da2744
Keeps both lines: master's PGXP session, draw-distance clamps, masked rejects and saturated-winding NCLIP; the release's render-pass kit additions, verified media/disc extents, timeline/present rings, cull-scale sites. Overlay ABI v30. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
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 */
|