media_reque...ual_complete(9)
π media_request_manual_complete(9) β the Kernel API Manual, bestie edition π
Okay so this is a page from the Kernel API Manual, and the star of the show is media_request_manual_complete β yes the header up top gets all truncate-y and looks like media_reque...ual_complete(9), that's just the page header being dramatic, the real one is spelled out below. Let's get into it β¨
πΈ NAME πΈ
media_request_manual_complete β mark the request as completed, that's literally the whole gig π«Ά
β¨ SYNOPSIS β¨
void media_request_manual_complete (struct media_request *req );
π¦ ARGUMENTS π¦
reqβ the request. That's it, that's the arg π
π DESCRIPTION π
So here's the tea π: this function completes a request that was previously marked for manual completion β and "previously" means by an earlier call to media_request_mark_manual_completion. Like, that's the setup, and this is the payoff. When it runs, the request's manual_completion field gets reset to false. Clean slate, no cap β¨
Now, the important bit β all objects contained in the request must have been completed previously. Every single one. It is an error to call this function otherwise π
And if that error does happen? The function will WARN, and the object completion gets delayed until num_incomplete_objects is 0. So like, not the end of the world, but it's giving π so please complete your objects first, bestie, iykyk.
π SEE ALSO π
Over in the kernel file ./include/media/media-request.h, you'll find the whole friend group π―ββοΈ:
enum media_request_state(9)struct media_request(9)media_request_lock_for_access(9)media_request_unlock_for_access(9)media_request_lock_for_update(9)media_request_unlock_for_update(9)media_request_get(9)media_request_put(9)media_request_get_by_fd(9)media_request_alloc(9)media_request_mark_manual_completion(9)struct media_request_object_ops(9)struct media_request_object(9)media_request_object_get(9)media_request_object_put(9)media_request_object_find(9)media_request_object_init(9)media_request_object_bind(9)media_request_object_unbind(9)media_request_object_complete(9)
Like, the entire roster, no gatekeeping π₯
π That's the whole page, bestie. Now go complete those objects before you call this, mwah π
Sign-off time π§: this little masterpiece comes from ./include/media, dated October 2026, and it lives in the same media_reque...ual_complete(9) header/footer sandwich it started in. Slay. Periodt. π
β¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms