Manual Pages for UNIX Operating System command usage for man sasl_getrealm_t

Simple Authentication Security Layer Library Functions
                                           sasl_getrealm_t(3SASL)



NAME
     sasl_getrealm_t - the realm acquisition callback function

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

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


DESCRIPTION
     Use the sasl_getrealm_t() functionwhen there is an  interac-
     tion with SASL_CB_GETREALM 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    SASL_CB_GETREALM    to    its
     required_prompts list.

PARAMETERS
     context        The context from the callback record


     id             The callback ID (SASL_CB_GETREALM)


     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,   sasl_getrealm_t()
     returns  an  integer  that corresponds to a SASL error code.
     See  for a complete list of SASL error codes.

ERRORS
     SASL_OK    The call to sasl_getrealm_t() was successful.



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





SunOS 5.11          Last change: 27 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                           sasl_getrealm_t(3SASL)



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



     _______________________________________________________________
    |       ATTRIBUTE TYPE        |         ATTRIBUTE VALUE        |
    |_____________________________|________________________________|
    | Availability                | system/library/security/libsasl|
    |_____________________________|________________________________|
    | Interface Stability         | Committed                      |
    |_____________________________|________________________________|
    | MT-Level                    | MT-Safe                        |
    |_____________________________|________________________________|


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



































SunOS 5.11          Last change: 27 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                           sasl_getrealm_t(3SASL)






















































SunOS 5.11          Last change: 27 Oct 2003                    3