git-market/curl-curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-04-11 12:01:42 +08:00
Code Issues Actions 14 Packages Projects Releases Wiki Activity

docs: CURLOPT_LOGIN_OPTIONS is a login property

Browse Source 
Test case 1982 verifies this
This commit is contained in:
Daniel Stenberg 2026-04-04 11:21:37 +02:00
parent e96cb8b1d8
commit ff35e6b2dc
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
3 changed files with 63 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/libcurl/opts/CURLOPT_LOGIN_OPTIONS.md
View File

@ -51,6 +51,15 @@ option.
Using this option multiple times makes the last set string override the
previous ones. Set it to NULL to disable its use again.
CURLOPT_LOGIN_OPTIONS(3) is a *login property*, it does not change the
security context. This means that this option changes how the login happens
when a connection is created, but it does not affect which connections libcurl
can reuse. libcurl may reuse a connection that was set up with a different
options string; a different options string does not by itself prevent reuse.
Connection reuse still depends on other connection properties matching, such
as the protocol, hostname, port number, credentials and other settings that
affect the connection.
# DEFAULT
NULL

2
tests/data/Makefile.am
View File

@ -241,7 +241,7 @@ test1941 test1942 test1943 test1944 test1945 test1946 test1947 test1948 \
test1955 test1956 test1957 test1958 test1959 test1960 test1964 test1965 \
\
test1970 test1971 test1972 test1973 test1974 test1975 test1976 test1977 \
test1978 test1979 test1980 test1981 \
test1978 test1979 test1980 test1981 test1982 \
\
test2000 test2001 test2002 test2003 test2004 test2005 test2006 test2007 \
test2008 \

53
tests/data/test1982 Normal file
View File

@ -0,0 +1,53 @@
<?xml version="1.0" encoding="US-ASCII"?>
<testcase>
<info>
<keywords>
IMAP
Clear Text
FETCH
connection reuse
options
</keywords>
</info>
# Server-side
<reply>
<servercmd>
REPLY "LOGIN user.one secret" A002 OK LOGIN completed
</servercmd>
<data crlf="yes">
From: me@somewhere
To: fake@nowhere
body
--
yours sincerely
</data>
</reply>
# Client-side
<client>
<server>
imap
</server>
<name>
IMAP two requests, change options for the second
</name>
<command>
'imap://user.one:secret@%HOSTIP:%IMAPPORT/%TESTNUMBER/;MAILINDEX=1' 'imap://user.one:secret;AUTH=XOAUTH2@%HOSTIP:%IMAPPORT/%TESTNUMBER/;UID=2'
</command>
</client>
# Verify data after the test has been "shot"
<verify>
<protocol crlf="yes">
A001 CAPABILITY
A002 LOGIN user.one secret
A003 SELECT %TESTNUMBER
A004 FETCH 1 BODY[]
A005 UID FETCH 2 BODY[]
A006 LOGOUT
</protocol>
</verify>
</testcase>