Naut/include/naut/event.h
ookami125 2178d6a70c Initial commit: Naut-Torrent — from-scratch 10 GbE BitTorrent client
A maintainable, extensible BitTorrent client (C11, Linux/io_uring) targeting
10 GbE saturation. All torrent functionality is built from scratch; liburing
is the only linked third-party dependency on the data path.

Implements Phases 1-7 of the roadmap:
- core: page-aligned buffer pool, MPMC/Treiber queues, bitfields, worker pool
- crypto: SHA-1/256 (SHA-NI + scalar), Merkle (BEP-52), RC4 (MSE)
- bencode/metainfo: zero-copy parser, v1/v2/hybrid .torrent + magnet
- peer: sans-IO wire codec, MSE/PE handshake state machine, BEP-10, ut_metadata, PEX
- piece/storage: block-level multi-peer engine, rarest-first + endgame,
  per-file completion events + single-file relocate (move-as-you-finish)
- tracker/dht: HTTP + UDP (BEP-15) trackers, BEP-5 KRPC iterative lookup
- platform: io_uring reactor (SQPOLL, registered buffers, SEND_ZC)
- surface: versioned RPC, native plugin ABI, sandboxed Lua scripting, nautd/nautctl

Verified against libtorrent (single/multi/hybrid, MSE, magnet-via-DHT, swarm);
unit + interop tests green; ASan/UBSan/TSan clean. Scripting reference in
docs/scripting.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 12:12:00 -04:00

42 lines
1.3 KiB
C

/* event.h - control-plane event bus, never called from byte-processing workers. */
#ifndef NAUT_EVENT_H
#define NAUT_EVENT_H
#include "naut/common.h"
typedef enum {
NAUT_EVENT_TORRENT_ADDED,
NAUT_EVENT_PIECE_COMPLETE,
NAUT_EVENT_FILE_COMPLETE,
NAUT_EVENT_TORRENT_FINISHED,
NAUT_EVENT_PEER_CONNECTED,
NAUT_EVENT_ALERT,
} naut_event_type;
typedef struct {
naut_event_type type;
uint64_t torrent_id;
uint32_t index;
const char *message;
const char *path;
} naut_event;
typedef void (*naut_event_cb)(void *context, const naut_event *event);
typedef struct naut_event_bus naut_event_bus;
naut_event_bus *naut_event_bus_create(void);
void naut_event_bus_destroy(naut_event_bus *bus);
/* Subscribe/unsubscribe are control-thread operations. emit snapshots the
* subscriber list, allowing callbacks to register work without holding a bus
* lock. */
naut_err naut_event_subscribe(naut_event_bus *bus, naut_event_cb callback,
void *context, uint64_t *subscription_id);
void naut_event_unsubscribe(naut_event_bus *bus, uint64_t subscription_id);
void naut_event_emit(naut_event_bus *bus, const naut_event *event);
const char *naut_event_type_name(naut_event_type type);
bool naut_event_type_parse(const char *name, naut_event_type *type);
#endif /* NAUT_EVENT_H */