1 '\" te

     2 .\" Copyright (C) 1998-2003, Carnegie Mellon Univeristy.  All Rights Reserved.

     3 .\" Portions Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved

     4 .TH sasl_decode64 3SASL "16 Sep 2003" "SunOS 5.12" "Simple Authentication Security Layer Library Functions"

     5 .SH NAME

     6 sasl_decode64 \- decode base64 string

     7 .SH SYNOPSIS

     8 .LP

     9 .nf

    10 \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lsasl\fR   [ \fIlibrary\fR ... ]

    11 #include <sasl/saslutil.h>

    12 

    13 \fBint\fR \fBsasl_decode64\fR(\fBconst char *\fR\fIin\fR, \fBunsigned\fR \fIinlen\fR, \fBchar *\fR\fIout\fR,

    14      \fBunsigned\fR \fIoutmax\fR,\fBunsigned *\fR\fIoutlen\fR);

    15 .fi

    16 

    17 .SH DESCRIPTION

    18 .sp

    19 .LP

    20 Use the \fBsasl_decode64()\fR interface to decode a base64 encoded buffer.

    21 .SH PARAMETERS

    22 .sp

    23 .ne 2

    24 .mk

    25 .na

    26 \fB\fIin\fR\fR

    27 .ad

    28 .RS 10n

    29 .rt  

    30 Input data.

    31 .RE

    32 

    33 .sp

    34 .ne 2

    35 .mk

    36 .na

    37 \fB\fIinlen\fR\fR

    38 .ad

    39 .RS 10n

    40 .rt  

    41 The length of the input data.

    42 .RE

    43 

    44 .sp

    45 .ne 2

    46 .mk

    47 .na

    48 \fB\fIout\fR\fR

    49 .ad

    50 .RS 10n

    51 .rt  

    52 The output data. The value of \fIout\fR can be the same as \fIin\fR. However, there must be enough space.

    53 .RE

    54 

    55 .sp

    56 .ne 2

    57 .mk

    58 .na

    59 \fB\fIoutlen\fR\fR

    60 .ad

    61 .RS 10n

    62 .rt  

    63 The length of the actual output.

    64 .RE

    65 

    66 .sp

    67 .ne 2

    68 .mk

    69 .na

    70 \fB\fIoutmax\fR\fR

    71 .ad

    72 .RS 10n

    73 .rt  

    74 The maximum size of the output buffer.

    75 .RE

    76 

    77 .SH RETURN VALUES

    78 .sp

    79 .LP

    80 \fBsasl_decode64()\fR returns an integer that corresponds to a SASL error code.

    81 .SH ERRORS

    82 .sp

    83 .ne 2

    84 .mk

    85 .na

    86 \fB\fBSASL_OK\fR\fR

    87 .ad

    88 .RS 11n

    89 .rt  

    90 The call to \fBsasl_decode64()\fR was successful.

    91 .RE

    92 

    93 .sp

    94 .LP

    95 See \fBsasl_errors\fR(3SASL) for information on SASL error codes.

    96 .SH ATTRIBUTES

    97 .sp

    98 .LP

    99 See \fBattributes\fR(5) for descriptions of the following attributes:

   100 .sp

   101 

   102 .sp

   103 .TS

   104 tab() box;

   105 cw(2.75i) |cw(2.75i) 

   106 lw(2.75i) |lw(2.75i) 

   107 .

   108 ATTRIBUTE TYPEATTRIBUTE VALUE

   109 _

   110 Availabilitysystem/library/security/libsasl

   111 _

   112 Interface StabilityCommitted

   113 _

   114 MT-LevelMT-Safe

   115 .TE

   116 

   117 .SH SEE ALSO

   118 .sp

   119 .LP

   120 \fBsasl_errors\fR(3SASL), \fBattributes\fR(5)