Syndicate UG Tools

Syndicate UG Tools is a collection of commands that are used to access or manipulate Syndicate data. Each command is an Syndicate User Gateway (UG) and very similar to Unix utilities.


You must first Install Syndicate.

If you do not have a user certificate and a gateway certificate, follow Create a User and Create a gateway guide.


Once Syndicate is installed, type:

apt-get install syndicate-ug-tools

Available Commands

Syndicate UG Tools offers following commands:

(click to view Man Pages)
Corresponding UNIX command Description
syndicate-cat cat Show file content
syndicate-ls ls List directory content
syndicate-rename mv Rename a file/directory
syndicate-touch touch Create an empty file
syndicate-trunc truncate Truncate a file
syndicate-unlink rm Remove a file
syndicate-mkdir mkdir Make a directory
syndicate-rmdir rmdir Remove a directory
syndicate-stat stat Show status of a file/directory
syndicate-listxattr xattr List extended attributes of a file/directory
syndicate-getxattr xattr -p Show an extended attribute of a file/directory
syndicate-setxattr xattr -w Set an extended attribute to a file/directory
syndicate-removexattr xattr -d Remove an extended attribute of a file/directory
syndicate-coord None Show a coordinator Syndicate Gateway of a file/directory
syndicate-read None Read file content of arbitrary range
syndicate-write None Write file content
syndicate-get None Get a file and store to local (similar to _ftp_ get)
syndicate-put None Put a local file to a Syndicate Volume (similar to _ftp_ put)
syndicate-refresh None Refresh TTL of a file/directory
syndicate-repl None Replay a series of commands from a syndicate script
syndicate-vacuum None Remove unlinked blocks and manifests


An example command displaying content of /subdir1 directory is:


More examples are available in the man pages.


Following options are common for all commands.