Command-line client for 4Suite repository access This command is a client that provides access to a 4Suite repository and RDF model from the command line. The repository must exist and must be accessible via a 4Suite RPC server. `show detailed help message` `show system command tree` `Set properties on a resource in a repository This command sets properties, such as access permissions or arbitrary user data, for a resource in a 4Suite repository. A subcommand specifying which type of property to set is required. See the help message for a subcommand for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Set the owner of a resource in a repository This command sets the owner of a resource in a 4Suite repository. The new owner must be an existing User. If necessary, you will be prompted first for credentials and access info to connect to the repository. username /repo/path/to/doc.xml `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` path of the resource name of the User to set as the new owner` `Set custom data associated with a User in a repository This command sets one custom name-value data pair associated with a User resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. michael age 26 `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the name of the User the key (name part) of a name-value pair the value for a name-value pair; no value means delete the key` `In a repository, flag a stylesheet to be executed at regular intervals This command adds an XSLT Stylesheet resource in a 4Suite repository to a list of stylesheets that will be automatically executed against an empty source document at regular intervals. /repo/path/to/cron.xslt `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` path of stylesheet to set for the strobe` `Set access control info for a resource in a repository This command sets access control info for a resource in a 4Suite repository. It will prompts for specific permissions to add or modify. Requires write access on the resource. If necessary, you will be prompted first for credentials and access info to connect to the repository. /path/to/doc.xml `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the path of the resource`` `Perform an XSLT transformation using documents in a repository This command will use 4xslt to render a source document with an XSLT stylesheet. Both the source and stylesheet must exist in a 4Suite repository, although the source document can be a virtual document such as the metadata XML for any resource in the repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. /fourthought.com `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Bind a top-level parameter` the path of the source document the path of the stylesheet` `Set the password for a User in a repository This command sets a 4Suite repository User's password. It will first prompt for the new password to set. Then it will attempt to connect to the repository and change the password, prompting first for credentials and access info if necessary. The user accessing the repository must have write access on the User resource for which the password is being modified. molson `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` User for which to change the password` `Create a resource in a repository This command will create a resource in a 4Suite repository. It requires a subcommand specifying which type of resource to create. See the help message for one of the subcommands for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Create a new Container in a 4Suite repository This command creates a new Container resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. /documents `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Recursively build all parent containers to complete the path.` The name (repo path) of container to create` `Create a new URI Reference in a repository This command creates a new URI Reference resource in a 4Suite repository. A URI Reference resource is like a Raw File but its content is always obtained on demand by dereferencing the stored URI. The first dereference operation occurs when this command is run, so the resource identified by the URI must be retrievable at that time. Resource metadata (size, etc.) from the last dereference operation is stored in the repository. Media type information is not obtained automatically; if a media type is not given on the command line, it will default to text/plain. If necessary, you will be prompted first for credentials and access info to connect to the repository. --imt=text/html /testref.html http://4suite.org/ `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The referenced resource's Internet Media Type. Default: text/plain.` The repo path of the new UriReference resource The URI to reference` `Create a new server definition in a 4Suite repository This command creates a new Server definiiton resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. /documents `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to`` `Create a new Alias for an existing resource in a repository This command creates a new Alias resource for an existing resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. Prior to 4Suite 1.0b1, this command was known as '4ss add alias'. /path/to/docAlias.rdf /path/to/actualDoc.rdf `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` The full repository path of the new alias. The path to the resource being aliased.` `Create a new User and sets its password in a repository This command creates a new User resource in the 4Suite repository. It will first prompt for a password for the new User. Then it will attempt to connect to the repository to create the user, prompting first for credentials and access info if necessary. The user accessing the repository must have sufficient permissions in order to create the new User, and the new User must not already exist. michael `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The container in which to create the user (default: '/ftss/users')` The name of the user to create.` `Create a new Raw File in a repository This command creates a new Raw File resource in a 4Suite repository. A Raw File is used to store non-XML based data in the repository. If you are storing XML data, please see the '4ss create document' command. If necessary, you will be prompted first for credentials and access info to connect to the repository. --imt=image/jpeg /images/4suite.jpg /local/path/to/4Suite.jpg `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The file's Internet Media Type. Default: text/plain.` The repo path of the Raw File to create The URI to read the file's content from, or '-' for stdin Additional aliases to assign to the new file.` `Create a new Group in a repository This command creates a new Group resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. developers `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The container in which to create the group (default: '/ftss/groups')` The name of the group to create` `Create a new XML Document in a repository This command creates a new XML Document resource in a 4Suite repository. An XML Document resource is used to store XML-based data in the repository. If you are storing non-XML data, see the '4ss create rawfile' command. If necessary, you will be prompted first for credentials and access info to connect to the repository. /repo/path/to/dummy.xml dummy.xml `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The document's Internet Media Type. Default: text/xml` `The path of a Document Definition (already in the repo) to use, if RDF statements are to be derived from the document` `The 4SS document type. If none specified, then the type is inferred from the document's content generic XML Document (this is the default) XSLT Document Schematron Document RDF Document Container User XPath Document Definition XSLT Document Definition Group Alias Server definition` The repo path of the document to create The URI to read the document's content from, or '-' for stdin Additional aliases to assign to the new document`` `List certain types of resources in a repository This command lists information about sets of certain types of resources in a 4Suite repository. A subcommand specifying which type of resource to list is required. See the help message for a subcommand for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `List all Document Definitions in a repository This command lists all Document Definition resources in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to`` `List all Users in a repository This command lists all User resources in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `list full paths instead of user names`` `List all Groups in a repository This command lists all Group resources in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `list full paths instead of group names``` `Update the content of a resource in a repository This command will replace the content of an existing resource in a 4Suite repository, reading in the new content from a file on the local filesystem, for example. A subcommand specifying which type of resource to update is required. See the help message for a subcommand for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Update the content of an XML Document in a repository This command updates the content of an existing XML Document resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. /repo/path/to/dummy.xml dummy.xml `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The internet media type to assign to the document. If not specified it is left unchanged.` `The new document definition for this document` `remove the current doc def` The repo path of the existing document in the repository. The URI to read the source from (Use '-' to read it from standard input)` `Reload an extension module in a repository This command reloads an extension module in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. Ft.Share.ExtensionModules.SomeModule `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` The Python module name` `Update the content of a Raw File in a repository This command updates the content of an existing Raw File resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. /images/4suite.jpg /local/path/to/4Suite.jpg `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The file's Internet Media Type. Default: no change.` The repo path of the file The URI to read the file's content from, or '-' for stdin`` `Spawn a subshell that knows authentication defaults This command will set a default username, password hash, hostname and port in an environment variable in a new shell so that you do not need to provide this info for subsequent invocations of 4ss command-line scripts. The username and password must be valid for the repository server on the given host and port. This command is an alternative to the login command. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` name of shell to execute (default is system specific)` `Relate two resources in a repository (e.g., add a User to a Group) This command is used to create a certain type of relationship between two objects in a 4Suite repository. See the help message for one of the subcommands for details. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Add a User to a Group in a repository This command adds a User to a Group in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. developers michael `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` The name (not path) of the Group The name (not path) of the User`` `Perform basic operations on an RDF model in a repository This command allows one to perform basic operations on the 4Suite RDF model. It requires a subcommand specifying what operation is desired. See the help message for each subcommand for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Add RDF statements to a given scope Adds statements to the user RDF model associated with a 4Suite repository. A single statement can be given via command-line arguments, or multiple statements can be given in an RDF XML file that will be deserialized. If necessary, you will be prompted first for credentials and access info to connect to the repository. --document=spam.rdf /my/scope/path `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Add statements deserialized from the given document` `When adding a single statement, create a virtual RDF document representing the scope, if it doesn't already exist` `When creating a virtual RDF document, the Internet Media Type (default: text/xml) to set` `When adding a single statement, the type of the object, either 'resource' or 'literal' (default: literal)` The scope into which the statements are to be added The subject of the new statement The predicate of the new statement The object of the new statement The URI of the new statement.` `Perform a Versa query This command performs a query on the combined user and system RDF models, using the Versa query language for RDF. If necessary, you will be prompted first for credentials and access info to connect to the repository. --query-file= `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Present no output except for errors or any result` `A file with the Versa query` `Do not use the user's namespace mapping file` `a scope to restrict the query` The query to perform. Required if --file is not specified` `Perform an RDF complete This command performs an RDF "complete": a query that returns, by default, all RDF statements from the combined system and user models in a 4Suite repository. The query can be constrained to return only those statements with a certain subject, predicate, object, scope, or statement URI, in any combination. If necessary, you will be prompted first for credentials and access info to connect to the repository. --subject=urn:uuid1234456 `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `The subject for the complete` `The predicate for the complete` `The object for the complete` `The URI of the statement to fetch` `The scope of statements to fetch` `Generate Serialized RDF in XML format` `Do not show the results sorted by scope`` `Remove RDF statements from a given scope This command removes statements from the user RDF model in a 4Suite repository. A single statement can be given via command-line arguments, or multiple statements can be given in an RDF XML file that will be deserialized. If necessary, you will be prompted first for credentials and access info to connect to the repository. --document=spam.rdf /my/scope/path `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Remove statements deserialized from the given document` `The subject of statements selected to be deleted` `The predicate of statements selected to be deleted` `The object of statements selected to be deleted` `The subject string is a regular expression to match` `The predicate string is a regular expression to match` `The object string is a regular expression to match` The scope from which the statements are to be removed`` `Export an application from a repository to the filesystem This command will export an application from a 4Suite repository, creating a setup.xml file and a mirror of the application's resources as files on the local filesystem. The application is assumed to be all resources in a particular container (including descendant containers). The user doing the export must have read access to all of the files in the container. If necessary, you will be prompted first for credentials and access info to connect to the repository. --version="0.0a1" --title="GuestBook" --description="a guest book demo" /ftss/demos/GuestBook `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `directory to export to (must already exist)` `set version of exported application` `set description of exported application` `set title of exported application` `archive the exported data (options are platform-dependent) gzip'ed tar-file compressed tar file bzip2'ed tar-file ZIP file uncompressed tar file` the base path (in the repo) of the application to export (default: /)` `Unrelate two resources in a repository (e.g., remove a User from a Group) This command is used to delete a certain type of relationship between two objects in a 4Suite repository. See the help message for one of the subcommands for details. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Remove a User from a Group in a repository This command removes a User from a Group in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. developers michael `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` The name (not path) of the Group The name (not path) of the User`` `Install, update, or remove a repository application This command reads a 4Suite repository application's setup XML file from the local filesystem and uses it to install, update or remove the application in a repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. GuestBook `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `install the 4Suite repository demo applications` `install the 4Suite repository Dashboard applicaiton` `delete an installed repository application` `base path (in the repo) where the application should be installed` `don't display what is happening` `don't sync ACL (install faster)` the location of the setup XML file on the local filesystem; if not given, then you must provide the --demo flag` `Associate a default password, host, port with a username This command will associate a password hash, hostname and port with a username, storing the info in a password file on the local filesystem. Subsequent invocations of 4ss command-line scripts can then automatically look up access info for connecting to a repository. The location of the password file is determined by the FTSS_PASSWORD_FILE environment variable. If not set, then the location is assumed to be a file named '.4ss.passwd' in the directory determined by the environment variable HOME (on Unix) or HOMEPATH (on Windows), or the environment variable WINDIR (on Windows) (one must be set). If the password file does not exist, it will be created when the first entry is stored. The location must be writable by the user invoking the command. At this time, this command does NOT verify that the username, password hash, hostname and port combination is valid; no repository connection is made. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` User for which to set defaults` `Retrieve a resource from the repository This command retrieves the content of a resource from a 4Suite repository. It requires a subcommand specifying which type of resource to fetch. See the help message for one of the subcommands for specific usage info. `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Print general info about a resource in a repository This command prints a summary of the metadata for a resource in a 4Suite repository. Metadata includes the resource type, creation date, last modified date, Internet Media Type, size, owner, and ACL. If necessary, you will be prompted first for credentials and access info to connect to the repository. /ftss/data/identity.xslt `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the path of the resource` `Print information about a Group in a repository This command prints information about a Group resource in a 4Suite repository. It lists the group's members and summarizes its ACL. If necessary, you will be prompted first for credentials and access info to connect to the repository. developers `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the name of the Group` `List custom data associated with a User in a repository This command lists the custom name-value data pairs associated with a User resource in a 4Suite repository. If necessary, you will be prompted first for credentials and access info to connect to the repository. root `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the name of the User the key (name part) of a name-value pair; if none are given, all data will be listed` `Print info about a Document Definition in a repository This command produces a summary of the information in a Document Definition resource ("DocDef") in a 4Suite repository. For XSLT based DocDefs, fetches the XSLT document. For XPath based DocDefs, provides a formatted summary. If necessary, you will be prompted first for credentials and access info to connect to the repository. BASE_XML `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the path of the Document Definition` `Print information about a User in a repository This command prints information about a User resource in the 4Suite repository. Lists the user's password hash, ACL, and group membership. If necessary, you will be prompted first for credentials and access info to connect to the repository. root `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the name of the User` `Print raw content of a resource in a repository This command prints the raw content of a resource in a 4Suite repository, without additional interpretation. The resource type must be a Raw File or a subclass thereof (most resource types are). If necessary, you will be prompted first for credentials and access info to connect to the repository. /ftss/data/4SSPowered.jpg > localfile.jpg `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Don't preface output with informational header` the path of the Raw File` `List contents of a Container in a repository This command produces a directory-like listing of the resources that are the children of a Container in a 4Suite repository. Columns in the listing include: Internet Media Type, size in bytes, date last modified, and resource's relative name. If necessary, you will be prompted first for credentials and access info to connect to the repository. /ftss/data `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` the path of the Container (default: /)` `Print content of an XML-based document in a repository This command prints the content of an XML-based document (e.g. an XML Document or XSLT Document) in a 4Suite repository. Currently, the output is the same as for '4ss fetch rawfile', but it may eventually be interpreted as if processed by a repository-aware version of '4xml'. If necessary, you will be prompted first for credentials and access info to connect to the repository. /ftss/demos/index.html `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `Don't preface output with informational header` the path of the Document`` `Delete a resource from a repository This command will delete from a 4Suite repository all resources with paths matching a given pattern. The pattern may contain shell-style wildcards as supported by Python's fnmatch module (but you probably have to escape them from being matched by your own shell first). If necessary, you will be prompted first for credentials and access info to connect to the repository. Aliases are normally traversed, so in order to delete an Alias, use the --no-traverse option. /fourthought.com `show detailed help message` `connect using the given user name` `connect as anonymous user` `connect using the given password` `the port to connect to` `the host to connect to` `don't traverse aliases` `prompt for confirmation before deleting` the path of the resource to delete; can be a regular expression`