hvc_iucv_path_pending(9)

okay so bestie, welcome to hvc_iucv_path_pending(9) from the Kernel API Manual — this is the IUCV handler page, and it’s lowkey giving “connection request bouncer” energy 💅✨

🎀 NAME 🎀

hvc_iucv_path_pending — IUCV handler to process a connection request.

✨ SYNOPSIS ✨

       int hvc_iucv_path_pending (struct iucv_path *path , u8 *ipvmid , u8
       *ipuser );

🫶 ARGUMENTS 🫶

• path — the pending path (struct iucv_path) — yes, that’s the whole vibe.
• ipvmid — the z/VM system identifier of originator 🖥️
• ipuser — user specified data for this path (AF_IUCV: port/service name and originator port) 🎀

💖 DESCRIPTION 💖

The function uses the ipuser data to determine if the pending path belongs to a terminal managed by this device driver. It’s basically doing a vibe check on the pending path to see if it’s ours 👑

If the path belongs to this driver, ensure that the terminal is not accessed multiple times — only one connection to a terminal is allowed, periodt. If the terminal is not yet connected, the pending path is accepted and is associated to the appropriate struct hvc_iucv_private instance. Slay, path accepted 💖

Returns 0 if path belongs to a terminal managed by this device driver; otherwise returns -ENODEV in order to dispatch this path to other handlers. Not ours? Not today. Byeee 👋

Locking: struct hvc_iucv_private->lock 🔐

🌈 SEE ALSO 🌈

Kernel file ./drivers/tty/hvc/hvc_iucv.c — and the whole friend group is right here: 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_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), hvc_iucv_setup_filter(9), param_set_vmidfilter(9), param_get_vmidfilter(9), hvc_iucv_init(9), hvc_iucv_config(9) 🦋

made with 💜 from the Kernel API Manual — source/version: ./drivers/tty/hvc; date: October 2026; page: hvc_iucv_path_pending(9). byeee bestie 🫶🌸