reset_contr...al_exclusive(9)
π reset_control_bulk_get_optional_exclusive β like, the chill version of the exclusive bulk getter
okay so bestie, this is a page from the Kernel API Manual (the 9 section, kernel internals, iykyk) and it's about reset_control_bulk_get_optional_exclusive. Which, yes, is a whole mouthful β she's giving "the optional variant of reset_control_bulk_get_exclusive()" and honestly she ate. Let's get into it π
β¨ NAME β¨
reset_control_bulk_get_optional_exclusive β lowkey just reset_control_bulk_get_exclusive() but make it optional π¦
πΈ SYNOPSIS πΈ
int reset_control_bulk_get_optional_exclusive (struct device *dev , int
num_rstcs , struct reset_control_bulk_data *rstcs );
that's the whole signature, no cap. three args, one int coming back at you π«
π ARGUMENTS π
devβ the device that's gonna get reset by the controller. main character energy, fr.num_rstcsβ how many entries are chillin' in therstcsarray. like, the headcount.rstcsβ an array ofstruct reset_control_bulk_data, with the reset line names already set. not me making sure those names are set before calling π
π DESCRIPTION π
okay so here's the vibe: this is the optional variant of reset_control_bulk_get_exclusive. what does "optional" mean in this context? it means if any of the requested resets aren't specified in the device tree, this function doesn't throw a whole tantrum and return an error β instead it just sets them to NULL. graceful. iconic. π
like, no error, just NULL. she simply moves on. periodt.
and for more info, go read reset_control_bulk_get_exclusive β the original, the blueprint, the blueprint's blueprint β¨
π SEE ALSO π
the whole friend group π«Ά β every single one of these is (9) and every single one matters:
- Kernel file
./include/linux/reset.h struct reset_control_bulk_data(9)enum reset_control_flags(9)reset_control_get_exclusive(9)reset_control_bulk_get_exclusive(9)reset_control_get_exclusive_released(9)reset_control_bulk_get_exclusive_released(9)reset_control_bulk_get_optional_exclusive_released(9)reset_control_get_shared(9)reset_control_bulk_get_shared(9)reset_control_get_optional_exclusive(9)reset_control_get_optional_shared(9)reset_control_bulk_get_optional_shared(9)of_reset_control_get_exclusive(9)of_reset_control_get_optional_exclusive(9)of_reset_control_get_shared(9)of_reset_control_get_exclusive_by_index(9)of_reset_control_get_shared_by_index(9)devm_reset_control_get_exclusive(9)devm_reset_control_get_exclusive_deasserted(9)devm_reset_control_bulk_get_exclusive(9)devm_reset_control_get_exclusive_released(9)devm_reset_control_bulk_get_exclusive_released(9)devm_reset_control_get_optional_exclusive_released(9)devm_reset_control_bulk_get_optional_exclusive_released(9)devm_reset_control_get_shared(9)devm_reset_control_get_shared_deasserted(9)devm_reset_control_bulk_get_shared(9)devm_reset_control_bulk_get_shared_deasserted(9)devm_reset_control_get_optional_exclusive(9)devm_reset_control_get_optional_exclusive_deasserted(9)devm_reset_control_bulk_get_optional_exclusive(9)devm_reset_control_get_optional_shared(9)devm_reset_control_get_optional_shared_deasserted(9)devm_reset_control_bulk_get_optional_shared(9)devm_reset_control_get_exclusive_by_index(9)devm_reset_control_get_shared_by_index(9)
that's the whole page bestie, no crumbs left π and yeah β this little beauty lives in ./include/linux and the date on her birth certificate says October 2026. slay πβ¨
π¦ 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