ls - List files and directories on an endpoint
ls [OPTIONS] ENDPOINT/PATH
The ls command lists files and subdirectories on an endpoint.
User relative paths may be specified as "
/~otheruser/path/". Absolute paths are specified as "
Files and directories are printed with one entry per line in alphabetical order. Directories are always displayed with a trailing "/".
The PATH may have a shell-compatible wild card pattern in its final component. Type man glob for details.
Automatic Endpoint Activation
If an endpoint is not activated, this command will attempt to auto-activate it. Otherwise, the command will fail, and direct the user to run endpoint-activate and/or display a web URL for OAuth activation.
This command supports the following endpoint identification formats:
"^test_bookmark". The bookmark name must be prepended with a
"^"character. The bookmark name may have URL-escaped characters. If the bookmark name contains a "/", it must be URL-escaped as "%2F".
"bob#test_endpoint". This contains the user who owns the endpoint and the endpoint legacy name.
Unqualified Legacy Name:
"test_endpoint". The user name defaults to the current logged in user.
File and directory path(s) given as input are assumed to be URL-encoded. For example, "%20" is equivalent to a space (" "). A literal "%" character must be encoded as "%25".
Show all files and directories, including those that start with a "." character.
Use long listing format. This is similar to UNIX ls except that the link count column is not displayed. Dates and times are displayed in UTC time.
List your home directory in long format:
$ ls -l go#ep1/~/
List all files matching a pattern:
$ ls -l go#ep1/~/*.txt
ls returns a non zero exit code if a network failure occured, authentication failed, or the requested file or directory does not exist on the target server.