Configuring the sftp Transfer Method (ASCII or Binary)

SFTP supports two transfer methods: ASCII and binary. In ASCII mode individual letters, numbers, and characters are transferred using their ASCII character code, and the receiving computer saves these in the correct text format for that system. During ASCII transfers between UNIX and Windows computers, newline characters are converted as appropriate for each system. (You can also manually configure newline character conversion if necessary.) In binary transfers, data is transferred to the server byte-by-byte with no data conversion.

Reflection for Secure IT also provides a smart transfer option called auto. In auto mode, the transfer method is determined by file extension. Files with specified file extensions use ASCII transfer; all other files use binary transfer. The default list of ASCII file types is txt, htm*, pl, php*. To modify this list for a given sftp session, use the setext command. To change the default file extension list, use the client keyword FileCopyAsciiExtensions.

sftp command

Effect

ascii -s

Displays the current transfer mode.

binary

Sets the current transfer mode to binary (the default).

auto

Sets the current transfer mode to auto. Files specified in FileCopyAsciiExtensions use ASCII transfer.

getext

Displays the current list of file extensions that use ASCII file transfer when auto mode is enabled.

setext

Specifies the current list of file extensions that use ASCII file transfer when auto mode is enabled. To specify multiple extensions, use a comma or space-separated list; this command is not cumulative. Wildcard (zsh-glob) characters are supported. Don't precede file extensions with a period. To specify extensions containing spaces, use quotation marks around the extension or use a backslash as an escape character.

ascii

Sets the current transfer mode to ASCII. When no remote newline is explicitly stated, the client attempts to retrieve the newline convention from the server. If the server does not support this functionality, the client sets the remote newline to CRLF.

ascii dos

Sets the remote newline to CRLF.

ascii unix

Sets the remote newline to LF.

Client keyword

Effect

FileCopyAsciiExtensions

Specifies the default list of file types for ASCII file transfer when auto mode transfer is enabled. The default is 'txt, htm*, pl, php*'.