bookmark-add - Create a bookmark to an endpoint and path


bookmark-add -n NAME -t ENDPOINT/PATH


bookmark-add creates a new bookmark. A bookmark is linked to an endpoint and path.

The following commands accept bookmarks: ls, mkdir, rename, rm, transfer, delete, endpoint-activate, endpoint-deactivate, bookmark-add, endpoint-add --sharing.

The new bookmark has a name NAME which may be up to 128 characters long. A bookmark named NAME must not already exist for the current user.

Bookmarks are only visible and usable for the user who created them. If the target endpoint is private or deleted, the bookmark is unusable.

PATH is assumed to be URL-encoded. PATH must be a directory and end with "/".

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".



The name of the new bookmark


The target endpoint and path. If ENDPOINT is another bookmark, its target endpoint is used and its target path is prepended to PATH.


$ bookmark-add -n "My bookmark" -t go#ep1/~/projects/123/

© 2010- The University of Chicago Legal