| Server IP : 185.124.137.96 / Your IP : 216.73.217.121 Web Server : LiteSpeed System : Linux id-dci-web1986.main-hosting.eu 5.14.0-611.26.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jan 29 05:24:47 EST 2026 x86_64 User : u686484674 ( 686484674) PHP Version : 8.0.30 Disable Function : system, exec, shell_exec, passthru, mysql_list_dbs, ini_alter, dl, symlink, link, chgrp, leak, popen, apache_child_terminate, virtual, mb_send_mail MySQL : OFF | cURL : ON | WGET : ON | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /proc/self/root/./opt/alt/curlssl11/usr/share/man/man3/ |
Upload File : |
.\" generated by cd2nroff 0.1 from CURLOPT_SASL_AUTHZID.md
.TH CURLOPT_SASL_AUTHZID 3 "2025-06-06" libcurl
.SH NAME
CURLOPT_SASL_AUTHZID \- authorization identity (identity to act as)
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_AUTHZID, char *authzid);
.fi
.SH DESCRIPTION
Pass a char pointer as parameter, which should be pointing to the
null\-terminated authorization identity (\fIauthzid\fP) for the transfer. Only
applicable to the PLAIN SASL authentication mechanism where it is optional.
When not specified only the authentication identity (\fIauthcid\fP) as specified
by the username is sent to the server, along with the password. The server
derives a \fIauthzid\fP from the \fIauthcid\fP when not provided, which it then uses
internally.
When the \fIauthzid\fP is specified, the use of which is server dependent, it can
be used to access another user\(aqs inbox, that the user has been granted access
to, or a shared mailbox for example.
The application does not have to keep the string around after setting this
option.
Using this option multiple times makes the last set string override the
previous ones. Set it to NULL to disable its use again.
.SH DEFAULT
blank
.SH PROTOCOLS
This functionality affects imap only
.SH EXAMPLE
.nf
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "imap://example.com/");
curl_easy_setopt(curl, CURLOPT_USERNAME, "Kurt");
curl_easy_setopt(curl, CURLOPT_PASSWORD, "xipj3plmq");
curl_easy_setopt(curl, CURLOPT_SASL_AUTHZID, "Ursel");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
}
.fi
.SH AVAILABILITY
Added in curl 7.66.0
.SH RETURN VALUE
\fIcurl_easy_setopt(3)\fP returns a CURLcode indicating success or error.
CURLE_OK (0) means everything was OK, non\-zero means an error occurred, see
\fIlibcurl\-errors(3)\fP.
.SH SEE ALSO
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_USERPWD (3)