hvc_iucv_setup_filter(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… 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 the const char *val from 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 πŸ™ˆ:

  • 0 means success β€” slay, we ate πŸ’…
  • -EINVAL if the filter is syntactically incorrect β€” the string did not pass the vibe check 😭
  • -ENOMEM if there was not enough memory to allocate the filter list array β€” the RAM said "no ❀️"
  • -ENOSPC if 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 πŸ‘‘πŸ’œ:

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