gsasl_client_callback_pin_set(3)

📦 version 1.10.0, in ubuntu jammy

✨ gsasl_client_callback_pin_set — API function ✨

okay bestie, so this page lives in the gsasl manual (that's the GNU SASL manual, iykyk) 💅 and it's all about one lil function. let's get into it 🫶

🌸 SYNOPSIS 🌸

#include <gsasl.h>

void gsasl_client_callback_pin_set(Gsasl * ctx,
Gsasl_client_callback_pin cb);

🎀 ARGUMENTS 🎀

  • Gsasl * ctx — the libgsasl handle. your whole vibe container, basically 💜
  • Gsasl_client_callback_pin cb — the callback function. yes that's the whole description, she's mysterious, she's lowkey iconic 🌈

💖 DESCRIPTION 💖

So what this does: it lets you specify the callback function to use in the client, and that callback's whole job is to choose a new pin — possibly one the server suggested — for the SECURID mechanism 🔐✨

And the tea is: this is not normally invoked, fr fr. it only fires when the server specifically requests it. so like, don't expect it to be out here doing the most every single time 🙈

Later on you can grab that function back again using gsasl_client_callback_pin_get(). cute little round trip, obsessed 💫

💀 DEPRECATED 💀

not me having to tell you this is the old callback interface 😭 it's giving legacy, it's giving vintage, but bestie — vintage is not always the flex you want.

The new interface does it like this:

  • use gsasl_callback_set() to set the application callback 👑
  • use gsasl_callback() or gsasl_property_get() to invoke the callback for certain properties ✨

so yeah, this function still exists, but she's retired-ish. periodt.

🐛 REPORTING BUGS 🐛

found a bug? spill it, but like, officially:

Copyright © 2002-2021 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 bestie, share it freely, just keep the receipts 💖)

🌈 SEE ALSO 🌈

The full documentation for gsasl is maintained as a Texinfo manual. If the info and gsasl programs are properly installed at your site, the command

info gsasl

should give you access to the complete manual. 📖✨

As an alternative you may obtain the manual from:

http://www.gnu.org/software/gsasl/manual/

and that's the whole page, bestie!! 🦋 this one's from the gsasl manual, version 1.10.0 — go forth and callback responsibly 💅🎀💜

📦 where this page comes from