Simple Authentication Security Layer Library Functions
                                             saslseterror(3SASL)



NAME
     saslseterror - set the error string

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

     void saslseterror(saslconnt *conn, unsigned flags,
          const char *fmt, ...);


DESCRIPTION
     The saslseterror() interface sets  the  error  string  that
     will  be  returned  by saslerrdetail(3SASL). Use syslog(3C)
     style formatting, that is, use printf()-style with %m as the
     most recent errno error.


     The saslseterror() interface is primarily  used  by  server
     callback  functions and internal plug-ins, for example, with
     the saslauthorizet callback. The saslseterror() interface
     triggers a call to the SASL logging callback, if any, with a
     level of SASLOGFAIL, unless the SASLNOLOG flag is set.


     Make the message string sensitive to  the  current  language
     setting.  If  there is no SASLCBLANGUAGE callback, message
     strings must be i-default. Otherwise, UTF-8 is used. Use  of
     RFC 2482 for mixed-language text is encouraged.


     If the value of conn is NUL, the saslseterror()  interface
     fails.

PARAMETERS
     conn     The   saslconnt   for   which   the    call    to
              saslseterror() applies.


     flags    If set to SASLNOLOG, the call  to  saslseterror()
              is not logged.


     fmt      A syslog(3C) style format string.


RETURN VALUES
     saslseterror() has no return values.

ATRIBUTES




SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                             saslseterror(3SASL)



     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
     saslerrdetail(3SASL), syslog(3C), attributes(5)


     Whistler, K. and Adams, G. RFC  2482,  Language  Tagging  in
     Unicode Plain Text. Network Working Group. January 1999.
































SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                             saslseterror(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3