pskc_set_key_data_timedrift(3)

πŸ’… pskc_set_key_data_timedrift β€” the libpskc girlies' time-drift setter ✨

okay so bestie, real talk: this is a libpskc man page. Yes that libpskc. It's a little setter function and it's honestly iconic for what it does. Let's get into it 🫢


🌸 NAME 🌸

pskc_set_key_data_timedrift β€” literally the API function, that's her whole job, no notes ✨


πŸŽ€ SYNOPSIS πŸŽ€

#include <pskc.h>

void pskc_set_key_data_timedrift(pskc_key_t * key, uint32_t timedrift);

look at her. void return, two args, clean. we stan a low-maintenance queen πŸ‘‘


πŸ¦‹ ARGUMENTS πŸ¦‹

  • pskc_key_t * key β€” a pskc_key_t handle, bestie. and where do you get one of those? from pskc_get_keypackage(), obviously. that's the plug πŸ’…
  • uint32_t timedrift β€” the time drift value you want to set. it's a uint32_t. it's the number. that's it, that's the vibe πŸ“

✨ DESCRIPTION ✨

So what this does: it sets the PSKC KeyPackage Key Data TimeDrift value. Say it with me β€” TimeDrift 🌈

This element holds the device clock drift value for time-based OTP algorithms. Not me explaining clock drift in a man page... but okay the way that this matters is: it's the integer value (positive or negative drift, both are valid, we don't judge πŸ’œ) that says how many time intervals the validation server has established the device clock drifted β€” and specifically, after the last successful authentication.

The example that ate, fr fr: if the last successful authentication established a device time value of 8 intervals from a specific start date, but the validation server determines the time value at 9 intervals β€” then the server SHOULD record the drift as -1. Yeah. Nine minus... it's -1. That's the whole bit, don't overthink it, the server has it handled 😭

ngl that capital-S SHOULD is doing a lot of heavy lifting in that sentence. it's a standards SHOULD, so like... behave accordingly 🧚

⭐ SINCE ⭐

2.2.0 β€” she's been here since 2.2.0, an absolute veteran, a main character of the changelog πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

Found a bug? Don't suffer in silence, bestie, report it to <oath-toolkit-help@nongnu.org>. 🫢

like genuinely, go tell them. they want to know. iykyk πŸ’€


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.

(yes that's the real license text, it's giving generous, it's giving "take the page, just keep the receipts" πŸ’– keep the copyright notice and this notice, periodt.)


and that's the page!! mwah πŸ’‹ this lil writeup is from libpskc, version 2.6.15, for the pskc_set_key_data_timedrift(3) page β€” go forth and set those drifts, bestie βœ¨πŸ’…πŸ¦‹

πŸ“¦ where this page comes from