kvm_s390_gisc_register(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… kvm_s390_gisc_register(9) πŸ’…

okay so bestie, welcome to the Kernel API Manual ✨ β€” yes we're deep in the kernel, yes it's s390 flavoured, and yes this page is basically the origin story of registering a guest ISC. buckle up πŸŽ€


🌸 NAME 🌸

kvm_s390_gisc_register β€” register a guest ISC. that's it, that's the function, she's iconic and she does exactly one (1) thing πŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

int kvm_s390_gisc_register (struct kvm *kvm , u32 gisc );

literally the whole signature, no cap. kvm and gisc, that's the cast of the show πŸ”₯


πŸŽ€ ARGUMENTS πŸŽ€

  • kvm β€” the kernel vm you wanna work with 🫢 your main character, the vm in question.
  • gisc β€” the guest interruption sub class you're registering πŸ’« yes it's a u32, yes it matters.

⭐ DESCRIPTION ⭐

okay so here's the tea β˜• β€” this function extends the vm specific alert mask to use. that's the vibe, that's the job.

and like, the effective IAM mask in the GISA gets updated too β€” but only in the case where the GISA is not part of the GIB alert list πŸ‘€. if it's already part of the list, no update needed, we move on, we don't do extra work.

worst case scenario? it will be updated latest when the IAM gets restored by gisa_get_ipm_or_restore_iam πŸ’… so either way it lands, just maybe not right this second, iykyk.


πŸ’œ RETURN πŸ’œ

so what do you get back, bestie? πŸ₯

  • the nonspecific ISC (NISC) that the gib alert mechanism has registered with the channel subsystem ✨ that's the good ending, that's the win.
  • -ENODEV β€” in case the vm uses no GISA 😭 like, there's no GISA to speak of, so, yeah.
  • -ERANGE β€” in case the guest ISC is invalid πŸ’€ range error, the ISC did not pass the vibe check.

🌈 SEE ALSO 🌈


ngl, if you're reading this page you're probably in the middle of some deeply s390 interrupt machinery, and honestly? respect. go off, queen πŸ‘‘

and that's the page, periodt πŸŽ€ this gem lives under ./arch/s390/kvm/s390, and she's dated October 2026 β€” mark your calendars bestie, this manual page ate and left no crumbs βœ¨πŸ’–πŸŒΈ

πŸ“¦ where this page comes from