Simple Authentication Security Layer Library Functions
                                           saslgetrealmt(3SASL)



NAME
     saslgetrealmt - the realm acquisition callback function

SYNOPSIS
     cc [ flag ... ] file ... -lsasl   [ library ... ]
     #include 

     int saslgetrealmt(void *context, int id, const char **availrealms,
          const char **result);


DESCRIPTION
     Use the saslgetrealmt() functionwhen there is an  interac-
     tion 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. A mechanism can still force  the  existence  of  a
     getrealm     callback    by    SASLCBGETREALM    to    its
     requiredprompts list.

PARAMETERS
     context        The context from the callback record


     id             The callback ID (SASLCBGETREALM)


     availrealms    A string list of the vailable realms.  avail-
                    realms is a null-terminated sting that can be
                    empty.


     result         The chosen realm. result is a null-terminated
                    string.


RETURN VALUES
     Like  other  SASL  callback   functions,   saslgetrealmt()
     returns  an  integer  that corresponds to a SASL error code.
     See  for a complete list of SASL error codes.

ERORS
     SASLOK    The call to saslgetrealmt() was successful.



     See saslerrors(3SASL) for information on SASL error codes.





SunOS 5.11          Last change: 27 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                           saslgetrealmt(3SASL)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     saslerrors(3SASL), attributes(5)



































SunOS 5.11          Last change: 27 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                           saslgetrealmt(3SASL)






















































SunOS 5.11          Last change: 27 Oct 2003                    3