saslgetrealmt(10 July 2001) saslgetrealmt(10 July 2001)

NAME
       saslgetrealmt - Realm Acquisition Callback


SYNOPSIS
       ##iinncclluuddee <>


       iinntt ssaassllggeettrreeaallmmtt((vvooiidd *context,, iinntt id,,
                       ccoonnsstt cchhaarr **availrealms,,
                           ccoonnsstt cchhaarr **result))


DESCRIPTION
       ssaassllggeettrreeaallmmtt   is   used   when   there   is   an  interaction  with
       SASLCBGETREALM as the type.

       If a mechanism would use this callback, but it is not present, then the
       first  realm  listed is automatically selected.  (Note that a mechanism
       may  still  force   the   existance   of   a   getrealm   callback   by
       SASLCBGETREALM to its requiredprompts list).

       context context from the callback record

       id callback ID (SASLCBGETREALM)

       availrealms  A  string  list of the available realms.  NULL terminated,
       may be empty.

       result The chosen realm. (a NUL terminated string)


RREETTUURRNN VVAALLUUEE
       SASL callback functions should return SASL return codes. See sasl.h for
       a complete list. SASLOK indicates success.


SEE ALSO
       sasl(3), saslcallbacks(3)



SASL man pages                       SASL        saslgetrealmt(10 July 2001)