components/cyrus-sasl/Solaris/usr/share/man/man3/sasl_client_add_plugin.3
author Jan Parcel <jan.parcel@oracle.com>
Thu, 09 Jun 2016 13:52:17 -0700
changeset 6316 351665422d31
parent 5769 6303cfed086b
permissions -rw-r--r--
21773883 Adjust libsasl2 man pages for consistency and to send upstream
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     1
'\" te
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     2
.\" Copyright (C) 1998-2003, Carnegie Mellon Univeristy.  All Rights Reserved.
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     3
.\" Portions Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
     4
.TH sasl_client_add_plugin 3sasl "12 Sep 2003" SASL "SASL man pages"
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     5
.SH NAME
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     6
sasl_client_add_plugin \- add a SASL client plug-in
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
     7
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     8
.SH SYNOPSIS
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
     9
.nf
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    10
cc [ flag ... ] file ... -lsasl   [ library ... ]
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    11
.B #include <sasl/saslplug.h>
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    12
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    13
.BI " int sasl_client_add_plugin(const char *" plugname ", "
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    14
.BI "				 sasl_client_plug_init_t *" cplugfunc "); "
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    15
.fi
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    16
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    17
.SH DESCRIPTION
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    18
Use the 
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    19
.B sasl_client_add_plugin()
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    20
interface to add a client plug-in to the current in-memory list of client plug-ins in the SASL library.
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    21
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    22
.SH PARAMETERS
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    23
.I plugname
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    24
The name of the client plug-in.
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    25
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    26
.I cplugfunc
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    27
The value of cplugfunc is filled in by the sasl_client_plug_init_t structure.
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    28
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    29
.SH "RETURN VALUES"
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    30
sasl_client_add_plugin() returns an integer that corresponds to a SASL error code.
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    31
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    32
.SH ERRORS
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    33
.TP 0.8i
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    34
.B SASL_OK
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    35
The call to sasl_client_add_plugin() was successful.
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    36
.TP 0.8i
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    37
.B SASL_BADVERS
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    38
Version mismatch with plug-in.
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    39
.TP 0.8i
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    40
.B SASL_NOMEM
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    41
Memory shortage failure.
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    42
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    43
.TP 0.8i
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    44
See sasl_errors(3SASL) for information on other SASL error codes.
5055
9daf220c1a9a PSARC/2015/194 libsasl ON to Userland migration and update
Jan Parcel <jan.parcel@oracle.com>
parents:
diff changeset
    45
6316
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    46
.SH "SEE ALSO"
351665422d31 21773883 Adjust libsasl2 man pages for consistency and to send upstream
Jan Parcel <jan.parcel@oracle.com>
parents: 5769
diff changeset
    47
sasl_errors(3SASL)