Differences
This shows you the differences between the selected revisions of the page.
| ui_login_connection 2017-02-02 | ui_login_connection 2024-02-15 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Connection Page (Advanced Site Settings dialog) ====== | + | ====== The Connection Page (Advanced Site Settings dialog) ====== |
| The //Connection page// on the [[ui_login_advanced|Advanced Site Settings dialog]] allows you to configure general protocol-independent options for the connection. | The //Connection page// on the [[ui_login_advanced|Advanced Site Settings dialog]] allows you to configure general protocol-independent options for the connection. | ||
| Line 11: | Line 11: | ||
| &toc_title_page_sections | &toc_title_page_sections | ||
| - | ===== Connection ===== | + | ===== [[connection]] Connection ===== |
| - | Use //Passive mode// to toggle between //passive// and //active// [[ftp_modes|FTP connection mode]]. //Passive// mode is selected by default. The option is supported only with FTP protocol. | + | Use //Passive mode// to toggle between //passive// and //active// [[ftp_modes|FTP connection mode]]. //Passive// mode is selected by default. WinSCP will try the other mode, if the selected mode does not work. The option is supported only with FTP protocol. |
| - | The //Optimize connection buffer size// enables optimization of socket buffer size. It greatly improves transfer speed. Disable it only when experiencing problems. The option is not available with [[webdav|WebDAV protocol]]. | + | The //Optimize connection buffer size// enables optimization of socket buffer size. It greatly improves transfer speed. Disable it only when experiencing problems. The option is not available with [[webdav|WebDAV]] protocol. |
| ===== [[timeout]] Timeouts ===== | ===== [[timeout]] Timeouts ===== | ||
| Line 24: | Line 24: | ||
| Some servers (and also firewalls and routers on the way between the client and the server) disconnect clients if they do not receive any data from it within a defined period. In the //Keepalives// box, you may order WinSCP to send some dummy data in regular periods to avoid being disconnected. This period is defined with //Seconds between keepalives//. | Some servers (and also firewalls and routers on the way between the client and the server) disconnect clients if they do not receive any data from it within a defined period. In the //Keepalives// box, you may order WinSCP to send some dummy data in regular periods to avoid being disconnected. This period is defined with //Seconds between keepalives//. | ||
| - | WinSCP implements two methods for keepalives. For SFTP and SCP, the basic option is to send SSH-level keepalives implemented by null %%SSH%% packets (%%SSH%% ignore messages). Some servers may be configured not to count these packets as data and thus they will still disconnect clients sending them. | + | For SFTP and SCP, WinSCP implements two methods for keepalives. The basic option is //Sending of null SSH packets// (%%SSH%% ignore messages). Some servers may be configured not to count these packets as data and thus they will still disconnect clients sending them. As an alternative WinSCP can improve the keepalives by //Executing dummy protocol commands// instead. For %%SFTP%% it is implemented as canonization of path ''/''. For %%SCP%% it is implemented as ''echo'' command.((With %%SCP%% this keepalive method does not work while WinSCP waits for user prompt in the middle of file transfer.)) |
| - | As an alternative WinSCP can send dummy commands of the transfer protocol instead. For %%SFTP%% it is implemented as canonization of path ''/''. For %%SCP%% it is implemented as ''echo'' command.((With %%SCP%% this keepalive method does not work while WinSCP waits for user prompt in the middle of file transfer.)) For FTP it is the only option and is implemented as randomly selected %%FTP%% protocol command with no effect. | + | For FTP, the basic option is to keep the session alive by //Executing dummy protocol commands//. As an alternative, WinSCP can improve the keeplives by //Additionally reading the current directory//. |
| - | The option is not available with [[webdav|WebDAV protocol]]. | + | The keepalives are not available with [[webdav|WebDAV]] and [[s3|S3]] protocols, as those are stateless protocols. |
| - | Note that keepalives are not always helpful. They help if you have a firewall which drops your connection after an idle period; but if the network between you and the server suffers from breaks in connectivity then keepalives can actually make things worse. If a session is idle, and connectivity is temporarily lost between the endpoints, but the connectivity is restored before either side tries to send anything, then there will be no problem - neither endpoint will notice that anything was wrong. However, if one side does send something during the break, it will repeatedly try to re-send, and eventually give up and abandon the connection. Then when connectivity is restored, the other side will find that the first side doesn't believe there is an open connection any more. Keepalives can make this sort of problem worse, because they increase the probability that WinSCP will attempt to send data during a break in connectivity. (Other types of periodic network activity can cause this behavior; in particular, [[ui_login_kex|SSH-2 re-keys]] can have this effect.) | + | Note that keepalives are not always helpful. They help if you have a firewall which drops your connection after an idle period; but if the network between you and the server suffers from breaks in connectivity then keepalives can actually make things worse. If a session is idle, and connectivity is temporarily lost between the endpoints, but the connectivity is restored before either side tries to send anything, then there will be no problem -- neither endpoint will notice that anything was wrong. However, if one side does send something during the break, it will repeatedly try to re-send, and eventually give up and abandon the connection. Then when connectivity is restored, the other side will find that the first side doesn't believe there is an open connection any more. Keepalives can make this sort of problem worse, because they increase the probability that WinSCP will attempt to send data during a break in connectivity. (Other types of periodic network activity can cause this behavior; in particular, [[ui_login_kex|re-keys]] can have this effect.) |
| Therefore, you might find that keepalives help connection loss, or you might find they make it worse, depending on what kind of network problems you have between you and the server.((&puttydoccite)) | Therefore, you might find that keepalives help connection loss, or you might find they make it worse, depending on what kind of network problems you have between you and the server.((&puttydoccite)) | ||
| Line 40: | Line 40: | ||
| explicitly set this to //IPv4// or //%%IPv6%%//. ((&puttydoccite)) | explicitly set this to //IPv4// or //%%IPv6%%//. ((&puttydoccite)) | ||
| - | The option is not available with [[webdav|WebDAV protocol]]. | + | The //Auto// setting is available with SFTP and SCP protocols only, it is not available with FTP protocol. Whole option is not available with [[webdav|WebDAV]] and [[s3|S3]] protocols. |
| ===== Further Reading ===== | ===== Further Reading ===== | ||
| Read more about [[ui_login|Login dialog]] and [[ui_login_advanced|Advanced Site Settings dialog]]. | Read more about [[ui_login|Login dialog]] and [[ui_login_advanced|Advanced Site Settings dialog]]. | ||