#ifndef NET_STORE_H #define NET_STORE_H // NOTE: on disk audio cache + the download worker pool. // // files live at /audio/.mp3, while downloading they are // <...>.mp3.part and get renamed when complete. downloads resume from an existing .part. // // the decoder can play a track while it is still downloading: it reads up to bytes_done and // parks on store->progress until more arrives (see audio_decode.cpp). so pressing play on a // remote track starts within one network round trip instead of after the whole file. typedef enum TrackState { TRACK_REMOTE = 0, // not on disk TRACK_PARTIAL, // .part on disk, not being downloaded TRACK_QUEUED, TRACK_DOWNLOADING, TRACK_DONE, TRACK_FAILED, } TrackState; // NOTE: the state lives in its own array (TrackStore.states, one byte per track): "is it on disk" // scans then touch 20KB instead of 640KB. the rest is per download progress, written by one // worker at a time and network bound. typedef struct TrackEntry TrackEntry; struct TrackEntry { u32 padding0; u32 http_status; u64 bytes_done; u64 bytes_total; // 0 until the response headers arrived u32 retries; u32 padding; }; #define STORE_MAX_WORKERS 16 typedef struct DownloadWorker DownloadWorker; struct DownloadWorker { CacheAligned struct TrackStore *store; Thread thread; u32 index; u32 current_key; u64 last_wake_ns; u64 bytes_since_wake; }; typedef struct TrackStore TrackStore; struct TrackStore { Catalog *catalog; String8 audio_dir; TrackEntry *entries; u8 *states; // TrackState per key u32 entry_count; // NOTE: per qari "on disk" summary, kept current at every transition into / out of DONE so the // ui never has to scan the table for it u32 *qari_done; u64 *qari_done_bytes; u8 *qari_scanned; CacheAligned Signal progress; // bumped whenever bytes land or a track changes state JobQueue queue; DownloadWorker workers[STORE_MAX_WORKERS]; u32 worker_count; CacheAligned u64 bytes_downloaded; // total this session, for the speed readout u32 active; u32 completed; u32 failed; b32 quiet; // no ui wakeups (sync mode) }; internal void store_init(Arena *arena, TrackStore *store, Catalog *catalog, String8 data_dir); internal void store_start_workers(Arena *arena, TrackStore *store, u32 worker_count); internal void store_stop_workers(TrackStore *store); internal void store_scan_qari(TrackStore *store, u32 qari_index); internal void store_scan_disk(TrackStore *store); // every qari, via readdir internal b32 store_delete(TrackStore *store, u32 key); // remove the local file internal u32 store_disk_count(TrackStore *store, u32 qari_index); internal b32 store_on_disk(TrackStore *store, u32 key); internal b32 store_request(TrackStore *store, u32 key, b32 urgent); internal u32 store_request_qari(TrackStore *store, u32 qari_index); internal TrackEntry *store_entry(TrackStore *store, u32 key); internal void store_set_state(TrackStore *store, u32 key, TrackState state); #define TrackStatePtr(store, entry) (&(store)->states[(entry) - (store)->entries]) internal u32 store_track_path(TrackStore *store, u32 key, b32 partial, char *out, u32 out_size); #endif // NET_STORE_H