ls - List files and directories on an endpoint




The ls command lists files and subdirectories on an endpoint.

User relative paths may be specified as "/~/", "/~/path/", or "/~otheruser/path/". Absolute paths are specified as "/path/".

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.

Endpoint Naming

This command supports the following endpoint identification formats:

  • UUID: "7865988a-aeb3-4e55-b8cd-938c258e7854"

  • Bookmark: "^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".

    Note:When a bookmark is used, the bookmark’s path is prepended to the input path.
  • Legacy Name: "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.

Path Escaping

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.

© 2010- The University of Chicago Legal