connections Element for ftpServer for site for sites [IIS Settings Schema]
Note
For more information about the connections element, see the following topic on the Microsoft IIS.net Web site: FTP Connections <connections>.
Specifies the connection-related settings for FTP sites.
Syntax
Attributes and Elements
The following sections describe attributes, child elements, and parent elements for this section.
Attributes
Attribute |
Description |
|---|---|
controlChannelTimeout |
Optional int attribute. Specifies the timeout, in seconds, when a connection will be timed out because of inactivity on the control channel. Note The FTP service will disconnect the session when this timeout is reached. The default value is 120. |
dataChannelTimeout |
Optional int attribute. Specifies the timeout, in seconds, when a connection will be timed out because of inactivity on the data channel. Note The FTP service will only disconnect the data channel when this timeout is reached. The default value is 30. |
disableSocketPooling |
Optional Boolean attribute. true if socket pooling is disabled; otherwise, false. The disableSocketPooling attribute specifies whether socket pooling is used for sites that are distinguished by IP address rather than port number or host name. If disableSocketPooling is set to false, then socket pooling is enabled and sockets are shared between sites that use the same socket number but different IP addresses. In this situation, the FTP service becomes the exclusive owner of the port on each address that is bound to the server. For example, if socket pooling is enabled on a server that has two IP addresses, 10.0.0.1 and 10.0.0.2, and an FTP site is bound to address 10.0.0.1 on port 21, the FTP service will also own port 21 on the 10.0.0.2 address. If disableSocketPooling is set to true, then there is no socket sharing for sites based on IP address. The default value is false. |
maxBandwidth |
Unused uint attribute. Note This attribute is not implemented for FTP 7. |
maxConnections |
Optional unit attribute. Specifies the maximum number of simultaneous connections for an FTP site. Note Use the maxClientsMessage attribute of the messages element to specify a message that the FTP service will return to clients when the maximum number of simultaneous connections has been exceeded. The default value is 4294967295 (unlimited.) |
minBytesPerSecond |
Optional int attribute. Specifies the minimum bandwidth requirements for data transfers. Note The FTP service will disconnect the data channel when the minimum bandwidth is not met. The default value is 240. |
resetOnMaxConnections |
Optional Boolean attribute. true if the FTP service should quickly disconnect an FTP session instead of sending a maximum connections response; otherwise false. Note The resetOnMaxConnections attribute optimizes the overhead when processing connections that are not allowed to connect because maxConnection limit was reached. The default value is false. |
serverListenBacklog |
Optional int attribute. Specifies the number of outstanding sockets that can be queued. The default value is 60. |
unauthenticatedTimeout |
Optional int attribute. Specifies the idle time-out, in seconds, between when a new connection is made and authentication succeeds. If the client does not successfully authenticate within the specified time period, the FTP service will disconnect the session. The default value is 30. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the root element in every configuration file that is used by IIS 7. |
system.applicationHost |
Specifies the root element for configuring Web process settings. |
sites |
Defines all sites on the server, and all applications and virtual directories in those sites. |
site |
Specifies configuration settings for a site. |
ftpServer |
Specifies the site-level settings for FTP features for FTP sites. |
Remarks
For more information about the connections element, see the following topic on the Microsoft IIS.net Web site: FTP Connections <connections>.
Default Configuration
None.
Element Information
Configuration locations |
ApplicationHost.config |
Requirements |
IIS 7 |