hvc_iucv_setup_filter(9)
π hvc_iucv_setup_filter(9) π
okay bestie, welcome to the Kernel API Manual page for hvc_iucv_setup_filter β yes, that's a real function name, no I did not make it up, and yes it's lowkey iconic π So sit down, grab your strawberry drink π, and let's get into it.
β¨ NAME β¨
hvc_iucv_setup_filter β Set up z/VM user ID filter
Like, the whole entire job: it sets up the z/VM user ID filter. That's it. That's the vibe. π
πΈ SYNOPSIS πΈ
int hvc_iucv_setup_filter (const char *val );
It returns an int, it takes a const char *val, and it's giving "small function, big responsibilities" energy fr fr π₯
π¦ ARGUMENTS π¦
valβ okay so the original docs literally just say-- undescribed --here π like, the manpage authors said "not me writing an argument description" and left. So that's all we have, no cap. It's theconst char *valfrom the synopsis, and that's the whole story. undescribed era, periodt π
π DESCRIPTION π
So what does it actually do, you ask? π«Ά
The function parses the filter string and creates an array containing the list of z/VM user ID filter entries. Parses the string, builds the array, main character energy the entire time β¨
And now the return codes, because these matter, bestie, do not skip them π:
0means success β slay, we ate π-EINVALif the filter is syntactically incorrect β the string did not pass the vibe check π-ENOMEMif there was not enough memory to allocate the filter list array β the RAM said "no β€οΈ"-ENOSPCif too many z/VM user IDs have been specified β bestie you cannot just keep adding IDs, there is a limit ππ«Ά
ngl these are all super normal kernel return codes, but if you see -EINVAL it's your string's fault and I need you to know that before you @ me πΈ
π SEE ALSO π
Okay this list is long and honestly highkey impressive, the iucv gang showed up in full force ππ:
- Kernel file
./drivers/tty/hvc/hvc_iucv.c hvc_iucv_get_private(9)alloc_tty_buffer(9)destroy_tty_buffer(9)destroy_tty_buffer_list(9)hvc_iucv_write(9)hvc_iucv_get_chars(9)hvc_iucv_queue(9)hvc_iucv_send(9)hvc_iucv_sndbuf_work(9)hvc_iucv_put_chars(9)hvc_iucv_notifier_add(9)hvc_iucv_cleanup(9)tty_outqueue_empty(9)flush_sndbuf_sync(9)hvc_iucv_hangup(9)hvc_iucv_notifier_hangup(9)hvc_iucv_dtr_rts(9)hvc_iucv_notifier_del(9)hvc_iucv_filter_connreq(9)hvc_iucv_path_pending(9)hvc_iucv_path_severed(9)hvc_iucv_msg_pending(9)hvc_iucv_msg_complete(9)hvc_iucv_alloc(9)hvc_iucv_destroy(9)hvc_iucv_parse_filter(9)param_set_vmidfilter(9)param_get_vmidfilter(9)hvc_iucv_init(9)hvc_iucv_config(9)
like, that's the whole friend group right there π«Άβ¨ iykyk.
π and that's the page!! sourced from ./drivers/tty/hvc, dated October 2026, and honestly? a moment. mwah π thanks for reading bestie, go read some source code, ily, bye π¦π
π¦ 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