SFTP_UPLOAD_BUFFER_SIZE - UFTP configuration option
Description
The SFTP_UPLOAD_BUFFER_SIZE option specifies the size of the cURL upload buffer.
Usage
Method | Syntax | IBM i | HP NonStop | UNIX | Windows | z/OS |
|---|---|---|---|---|---|---|
Command Line, Short Form | n/a | |||||
Command Line, Long Form | -sftp_upload_buffer_size size [ unit ] |
|
|
| ||
Environment Variable | UFTPSFTPUPLOADBUFFERSIZE=size [ unit ] |
|
|
| ||
Configuration File Keyword | sftp_upload_buffer_size size [ unit ] |
|
|
|
Values
The size value specifies the requested size of the cURL upload buffer.
The size value is specified in units of unit. Possible unit values are:
Unit | Description |
|---|---|
| b | Bytes (the default) |
| k | Kilobytes (1024 bytes) |
| m | Megabytes (1048576 bytes) |
| g | Gigabytes (1073741824 bytes) |
The format of the value is 'nnnn[ b | k | m | g ]', where 'nnnn' is a numeric value and '[ b | k | m | g ]' is one of the unit specifiers listed above. The maximum allowable value for this option is 2097152 bytes, which
can be requested using a value of "2m", and the minimum allowable value for this option is 16384 bytes, which can be requested using a value of "16k".
The default value for this option is 65536 bytes, which can be requested using a value of "64k".
Command Usage
The SFTP_UPLOAD_BUFFER_SIZE option is primarily used to increase the speed of SFTP file transfers.
Notes
This option is considered an advanced option. The wrong value can have adverse effects on network or process performance.
This option is considered a request not a guarantee, the TCP stack will ultimately decide how big the buffer size will be.
This option only works on libcurl versions 7.62.0 (0x073E00) and above, as the earlier versions did not support these changes and caused failures on certain platforms.