ice_ptp_create_clock(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_ptp_create_clock(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes that's the manual we're in, and yes this page is about one (1) little function that has main character energy despite being, like, twelve lines of docs 🎀

✨ NAME ✨

ice_ptp_create_clock — Create PTP clock device for userspace 👑

🌸 SYNOPSIS 🌸

long ice_ptp_create_clock (struct ice_pf *pf );

that's it. that's the whole vibe. one arg, one long coming back atcha 💖

🦋 ARGUMENTS 🦋

  • pf — the board private structure 💅 like, the whole board's personal diary. it's a struct ice_pf * and it's the only thing you're passing in, so don't overthink it.

🌈 DESCRIPTION 🌈

so what does it do?? it creates a new PTP clock device ✨ that's the whole job. gen z work ethic: do one thing, do it well, go home.

but here's the thing — it only creates one if we don't already have one 🙈 like it's not out here making duplicates, it has boundaries, it's secure in itself.

  • if it can't create one, it returns an error 😭
  • if we already have a device, it returns success 🫶 no drama, no fuss, just vibes

it should be used by ice_ptp_init to create the clock initially, and — this is the important part, bestie — it prevents global resets from creating new clock devices 🛑 like a bouncer at the club, checking IDs so random resets don't sneak in and start making clocks everywhere.

ngl this is a "don't recreate what already exists" function and honestly? relatable. iconic. no notes 💀✨

👑 SEE ALSO 👑

Kernel file ./drivers/net/ethernet/intel/ice/ice_ptp.c 🍓

and now, the friend group — literally the entire ice_ptp squad, present and accounted for 💜:

like okay go off, that's the whole extended friend group, iykyk 😭💖

and that's the page, bestie!! 🌟 this lil writeup lives in the source tree at ./drivers/net/ethernet/intel/ice and it's dated October 2026 — so like, future-coded of it honestly 💅🫶 go forth and create exactly zero duplicate clocks ✨🎀

📦 where this page comes from