Command line directory or file listing

This subsection discusses file listing specifics in SecureTransport and also supplies examples and usage details.

The ls -l command is the standard file/directory listing command that returns all files and directories contained in the directory where you run it. You can also specify a subdirectory listing, using ls -l <directory_name> or a file listing, using ls -l <file_name>.

The returned output contains all contained files and directories is in the following format:

[Permissions] [ST_nlink] [UID] [GID] [File_Size] [Date] [File_Name]

The following table includes the descriptions and specifics of each output parameter:

Utility file Description

Permissions

The read-write-execute permissions for the current file.

ST_nlink

Represents the number of hard links to the file.

Output of ls -l <file_name>, returns either as '0' or '?' for the ST_nlink value. This behavior applies to deployments on any supported OS.

UID

 The User ID. When listing (file and folder) performed over SFTP on Windows, this value is always presented as a 0.

GID

 The Group ID. When listing (file and folder) performed over SFTP on Windows, this value is always presented as a 0.

File_Size

The size of a file.

Use the Stfs.Encryption.ListDecryptedSize server configuration option to specify which file size, the original (decrypted) or the encrypted file size, to be reported for encrypted files. The option is available in both SecureTransport Server and Edge, and should be set to the same value on both. The default value is false, meaning the encrypted file size is displayed. When the option is set to true, the original file size (taken from the STFS attribute) is reported. Due to the STFS attribute checks, performance degradation may occur.

Date

 For a file, the returned value when that file was last modified; for a directory, it is the returned value for when that directory was created.

File_Name

 The name and extension of the respective file.

A valid return line would look like this:

rw-rr--r-- 1 100 1001 1024 Aug 19 08:46 samplelog.txt

 

Related Links