Skip to content

Commit 75a5e1e

Browse files
aeroyorchaeroyorch
committed
docs: document and align the blocking post-transfer and shutdown waits
1 parent 1a712e5 commit 75a5e1e

2 files changed

Lines changed: 11 additions & 1 deletion

File tree

‎docs/TODO.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -170,10 +170,16 @@ Make sure we do not ever loop because of non-blocking sockets returning
170170
- TELNET transfers
171171
- GSSAPI authentication for FTP transfers
172172
- The "DONE" operation (post transfer protocol-specific actions) for the
173-
protocols SFTP, SMTP, FTP. Fixing `multi_done()` for this is a worthy task.
173+
protocols SFTP, SCP, SMTP, IMAP, FTP. Fixing `multi_done()` for this is a
174+
worthy task.
175+
- The protocol disconnect handlers for FTP, IMAP, POP3, SMTP, SCP and SFTP,
176+
when a connection is closed instead of kept for reuse.
174177
- `curl_multi_remove_handle()` for any of the above.
175178
- Calling `curl_ws_send()` from a callback
176179

180+
Several of these are also documented in the BLOCKING section
181+
of [`libcurl-multi`](https://curl.se/libcurl/c/libcurl-multi.html).
182+
177183
## Better support for same name resolves
178184

179185
If a name resolve has been initiated for a given name and a second easy handle

‎docs/libcurl/libcurl-multi.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,3 +178,7 @@ the future, you should be aware of the following current restrictions:
178178
- Name resolves unless the c-ares or threaded-resolver backends are used
179179
- `file://` transfers
180180
- TELNET transfers
181+
- FTP, IMAP, SMTP, SCP and SFTP wait for the final server response before the
182+
transfer is reported as done
183+
- FTP, IMAP, POP3, SMTP, SCP and SFTP can block during protocol-specific
184+
shutdown when a connection is closed instead of kept for reuse

0 commit comments

Comments
 (0)