SocketTools .NET Edition

FileTransfer.FtpFeatures Enumeration

Specifies the server features that are available for the current client session.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

[Visual Basic]
<Flags>
Public Enum FileTransfer.FtpFeatures
[C#]
[Flags]
public enum FileTransfer.FtpFeatures

Remarks

When a client connection is first established, all features are enabled by default. However, as the client issues commands to the server, if the server reports that the command is unrecognized that feature will automatically be disabled in the client.

For example, the first time an application calls the GetFileSize method to determine the size of a file, the class library will try to use the SIZE command. If the server reports that the SIZE command is not available, that feature will be disabled and the class will not use the command again during the session unless it is explicitly re-enabled. This is designed to prevent the class from repeatedly sending invalid commands to a server, which may result in the server aborting the connection.

Members

Member Name Description Value
featureSIZE The server supports the SIZE command to determine the size of a file. If this feature is not enabled, the library will attempt to use the STAT command to determine the file size. 1
featureSTAT The server supports using the STAT command to return information about a specific file. If this feature is not enabled, the client may not be able to obtain information about a specific file such as its size, permissions or modification time. 2
featureMDTM The server supports the MDTM command to obtain information about the modification time for a specific file. This command may also be used to set the file time on the server. 4
featureREST The server supports restarting file transfers using the REST command. If this feature is not enabled, the client will not be able to restart file transfers and must upload or download the complete file. 8
featureSITE The server supports site specific commands using the SITE command. If this feature is not enabled, no site specific commands will be sent to the server. 16
featureIDLE The server supports setting the idle timeout period using the SITE IDLE command to specify the number of seconds that the client may idle before the server terminates the connection. 32
featureCHMOD The server supports modifying the permissions of a specific file using the SITE CHMOD command. If this feature is not enabled, the client will not be able to set the permissions for a file. 64
featureAUTH The server supports explicit TLS sessions using the AUTH command. If this feature is not enabled, the client will only be able to connect to a secure server that uses implicit TLS connections. Changing this feature has no effect on standard, non-secure connections. 128
featurePBSZ The server supports the PBSZ command which specifies the buffer size used with secure data connections. If this feature is disabled, it may prevent the client from changing the protection level on the data channel. Changing this feature has no effect on standard, non-secure connections. 256
featurePROT The server supports the PROT command which specifies the protection level for the data channel. If this feature is disabled, the client will be unable to change the protection level on the data channel. Changing this feature has no effect on standard, non-secure connections. 512
featureCCC The server supports the CCC command which returns the command channel to a non-secure mode. Changing this feature has no effect on standard, non-secure connections. 1024
featureHOST The server supports the HOST command which enables a client to specify the hostname after establishing a connection with a server that supports virtual hosting. 2048
featureMLST The server supports the MLST command which returns status information for files. If this feature is enabled, the MLST command will be used instead of the STAT command. 4096
featureMFMT The server supports the MFMT command which is used to change the last modification time for a file. If this command is supported, it is used instead of the MDTM command to change the modification time for a file. 8192
featureXCRC The server supports the XCRC command which returns the CRC32 checksum for the contents of a specified file. This command is used for file verification. 16384
featureXMD5 The server supports the XMD5 command which returns an MD5 hash for the contents of a specified file. This command is used for file verification. 32768
featureLANG The server supports the LANG command which sets the language used for the current client session. Command responses and file naming conventions will use the specified language. 65536
featureUTF8 The server supports the OPTS UTF-8 command which specifies UTF-8 encoding when specifying filenames. This feature is typically used in conjunction with setting the default language for the client session. 131072
featureXQUOTA The server supports the XQUOTA command which returns quota information for the current client session. 262144
featureUTIME The server supports the UTIME command which is used to change the last modification time for a specified file. 524288

Requirements

Namespace: SocketTools

Assembly: SocketTools.FileTransfer (in SocketTools.FileTransfer.dll)

See Also

SocketTools Namespace