pskc_get_device_devicebinding(3)

📦
version 2.6.15 · 5 versions
, in arch rolling

💅 pskc_get_device_devicebinding — a libpskc classic (section 3 of the manual, bestie)

okay so real talk, this one lives in libpskc, and it's the function that pulls the DeviceBinding value out of your KeyPackage's DeviceInfo. it's giving "small function, big security energy" 🎀

🌸 NAME 🌸

pskc_get_device_devicebinding — the API function that fetches the DeviceInfo DeviceBinding string for you. no cap, that's the whole name.

✨ SYNOPSIS ✨

#include <pskc.h>

const char * pskc_get_device_devicebinding(pskc_key_t * key);

like, one include, one call, zero drama 🦋

🫶 ARGUMENTS 🫶

  • pskc_key_t * key — a pskc_key_t handle, and you get it from pskc_get_keypackage(). that's the plug, that's where it comes from, don't just make one up 💀

💖 DESCRIPTION 💖

So this gets the PSKC KeyPackage DeviceInfo DeviceBinding value. say it with me: DeviceInfo → DeviceBinding. iconic path, no notes.

And what does it do, you ask? bestie it's actually so cool — this element lets a provisioning server make sure the key is only going to be loaded into the device that the key provisioning request was approved for. literally a vibe check for hardware 🔥

The device gets bound to the request using a device identifier — for example an International Mobile Equipment Identity (IMEI) for the phone 📱 — or an identifier for a class of identifiers, for example those for which the keys are protected by a Trusted Platform Module (TPM). so either one specific device or a whole squad of devices, iykyk 🧚

👑 RETURNS 👑

  • a constant string holding the content — and must not be deallocated, like do NOT free it, I am begging you 😭 🙈
  • or NULL if it's not set. that's it, that's the return.

💀 REPORTING BUGS 💀

Found a bug? spill it to <oath-toolkit-help@nongnu.org> 🍓

Copyright © 2009-2026 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. slay, and also legally binding 💅

✨ that's the whole page ✨ — this was libpskc version 2.6.15 bringing you pskc_get_device_devicebinding(3), mwah, go forth and bind your devices responsibly 🎀💜

📦 where this page comes from