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.
Prerequisites
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.
Installation
Once Syndicate is installed, type:
apt-get install syndicate-ug-tools
Available Commands
Syndicate UG Tools offers following commands:
| Command (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 |
Run
An example command displaying content of /subdir1 directory is:
syndicate-ls -u $SYNDICATE_USER -v $SYNDICATE_VOLUME -g $SYNDICATE_GATEWAY /subdir1
More examples are available in the man pages.
Options
Following options are common for all commands.
-d$DEBUG_LEVEL: set a debug level. For example,-d3will set the debug level to 3 (very verbose).-u $SYNDICATE_USER: set a user. Foranonymousaccess, useANONYMOUS.-v $SYNDICATE_VOLUME: set a volume.-g $SYNDICATE_GATEWAY: set a gateway.