snapshot_read_next(9)

📦 version 7.3.1, in nixpkgs unstable

okay so bestie, buckle up, we're reading a manpage from the Kernel API Manual and honestly? it's lowkey iconic. this one's all about snapshot_read_next 💅

✨ NAME ✨

snapshot_read_next — get the address to read the next image page from. that's it, that's the vibe 🎀

🌸 SYNOPSIS 🌸

int snapshot_read_next (struct snapshot_handle *handle );

🦋 ARGUMENTS 🦋

  • handle — the snapshot handle you're using for the reading, bestie. that's the one 🫶

🔥 DESCRIPTION 🔥

okay so on the first call, handle should point to a zeroed snapshot_handle structure. it gets populated right then and there, and after that you pass a pointer to it to this function every next time. no cap, that's the whole ritual ✨

on success, the function returns a positive number. and then? the caller is allowed to read up to that returned number of bytes from the memory location computed by the data_of macro. slay, that's your read budget 💖

the function returns 0 to indicate the end of the data stream condition, and negative numbers are returned on errors. if that happens, the structure pointed to by handle is not updated and should not be used any more. like, it's done, don't touch it, periodt 💀

ngl this is the part where you pay attention: error means the handle is stale and you gotta walk away gracefully 🙈

👑 SEE ALSO 👑

kernel file ./kernel/power/snapshot.c, plus the whole friend group: get_image_page(9), free_image_page(9), alloc_rtree_node(9), free_mem_extents(9), create_mem_extents(9), memory_bm_next_pfn(9), mark_nosave_pages(9), create_basic_memory_bitmaps(9), free_basic_memory_bitmaps(9), snapshot_additional_pages(9), count_free_highmem_pages(9), count_highmem_pages(9), count_data_pages(9), swsusp_free(9), preallocate_image_pages(9), free_unnecessary_pages(9), minimum_image_size(9), hibernate_preallocate_memory(9), pack_pfns(9), unpack_orig_pfns(9), count_highmem_image_pages(9), prepare_highmem_image(9), copy_last_highmem_page(9), prepare_image(9), snapshot_write_next(9), restore_highmem(9)

and that's the whole page, bestie 🧚 this lil gem lives in ./kernel/power and it's dated October 2026 — screenshot it, cite it, live your truth ⭐

📦 where this page comes from