snd_hda_lock_devices(9)
β¨ snd_hda_lock_devices β bestie edition β¨
okay so we're looking at snd_hda_lock_devices(9) from the Kernel API Manual, and honestly? it's a tiny little function with one specific job π let's get into it.
π NAME π
snd_hda_lock_devices β pseudo device locking. that's it. that's the whole vibe. locking, but make it pseudo π
πΈ SYNOPSIS πΈ
int snd_hda_lock_devices (struct hda_bus *bus );
returns an int, takes one struct hda_bus * pointer. immaculate little signature, no notes π«Ά
π¦ ARGUMENTS π¦
busβ the BUS. yes, it's literally just described as "the BUS", capital letters and all. that's the whole argument, bestie, it's the bus π
π DESCRIPTION π
so what does it actually do? it toggles card->shutdown to allow or disallow device access (as a hack) π₯
yes, you read that right β as a hack. the manpage said it, not me. it's flipping card->shutdown around so devices either get to touch stuff or they don't. iconic behavior, slightly unhinged, we respect it π
π SEE ALSO π
this is the part where the manpage goes absolutely feral. it lives in the kernel file ./sound/hda/common/codec.c, and it's bringing the entire friend group. like, all of them. every single one. no cap π
snd_hda_sequence_write(9)snd_hda_get_conn_list(9)snd_hda_get_connections(9)snd_hda_override_conn_list(9)snd_hda_get_conn_index(9)snd_hda_get_num_devices(9)snd_hda_get_devices(9)snd_hda_get_dev_select(9)snd_hda_set_dev_select(9)snd_hda_codec_set_pincfg(9)snd_hda_codec_get_pincfg(9)snd_hda_codec_set_pin_target(9)snd_hda_codec_get_pin_target(9)snd_hda_shutup_pins(9)snd_hda_codec_cleanup_for_unbind(9)snd_hda_codec_register(9)snd_hda_codec_unregister(9)snd_hda_codec_device_init(9)snd_hda_codec_new(9)snd_hda_codec_update_widgets(9)snd_hda_codec_setup_stream(9)__snd_hda_codec_cleanup_stream(9)query_amp_caps(9)snd_hda_check_amp_caps(9)snd_hda_override_amp_caps(9)snd_hda_codec_amp_update(9)snd_hda_codec_amp_stereo(9)snd_hda_codec_amp_init(9)snd_hda_codec_amp_init_stereo(9)snd_hda_mixer_amp_volume_info(9)snd_hda_mixer_amp_volume_get(9)snd_hda_mixer_amp_volume_put(9)snd_hda_mixer_amp_tlv(9)snd_hda_set_vmaster_tlv(9)snd_hda_find_mixer_ctl(9)snd_hda_ctl_add(9)snd_hda_ctls_clear(9)snd_hda_unlock_devices(9)snd_hda_codec_reset(9)__snd_hda_add_vmaster(9)snd_hda_add_vmaster_hook(9)snd_hda_sync_vmaster_hook(9)snd_hda_mixer_amp_switch_info(9)snd_hda_mixer_amp_switch_get(9)snd_hda_mixer_amp_switch_put(9)snd_hda_create_dig_out_ctls(9)snd_hda_spdif_out_of_nid(9)snd_hda_spdif_ctls_unassign(9)snd_hda_spdif_ctls_assign(9)snd_hda_create_spdif_share_sw(9)snd_hda_create_spdif_in_ctls(9)snd_hda_codec_set_power_to_all(9)snd_hda_codec_eapd_power_filter(9)snd_hda_codec_prepare(9)snd_hda_codec_cleanup(9)snd_hda_add_new_ctls(9)snd_hda_codec_set_power_save(9)snd_hda_set_power_save(9)snd_hda_check_amp_list_power(9)snd_hda_input_mux_info(9)snd_hda_input_mux_put(9)snd_hda_enum_helper_info(9)snd_hda_multi_out_dig_open(9)snd_hda_multi_out_dig_prepare(9)snd_hda_multi_out_dig_cleanup(9)snd_hda_multi_out_dig_close(9)snd_hda_multi_out_analog_open(9)snd_hda_multi_out_analog_prepare(9)snd_hda_multi_out_analog_cleanup(9)snd_hda_get_default_vref(9)snd_hda_correct_pin_ctl(9)_snd_hda_set_pin_ctl(9)snd_hda_add_imux_item(9)snd_hda_bus_reset_codecs(9)snd_hda_codec_set_gpio(9)snd_print_pcm_bits(9)
like I said. everyone showed up to the party π
also worth shouting out the directory it all hangs out in: ./sound/hda/common π§
ngl the "as a hack" note is doing so much heavy lifting here β the manpage is fully aware this is not the elegant solution and it's choosing to be honest about it π
and that's the whole page, bestie! short and sweet, one argument, one card->shutdown toggle, and a SEE ALSO section longer than my entire contact list. this one's from ./sound/hda/common, dated October 2026 β mwah, 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