NAME

       ori - Ori File System command line interface

SYNOPSIS

       ori COMMAND [ARGUMENTS...]

DESCRIPTION

       This  tool provides the command line interface to the Ori distributed file system.  Provides useful tools
       for accessing, manipulating, and repairing Ori repositories without the use of  FUSE.   It  can  be  used
       alone  without  FUSE  to  checkout a snapshot of a tree and commit changes to one.  This tool is also the
       main daemon used by the SSH push/pull interface.

       This command line tool also controls the Ori FUSE driver if run inside a mounted file system rather  than
       a  repository.  Only certain commands are supported at the moment and the list is documented in the orifs
       man page.

       N.B. This project is still in flux and repository layouts may not be compatible  between  releases.   You
       may  be  required  to  copy  files  from  one  repository  to another manually and the history may not be
       preserved.

REPOSITORY COMMANDS

       This list contains commands that will operate on your  local  instance  of  the  repository.   These  may
       callout to remote repositories for data if this was an InstaCloned repository.

       checkout [--force] COMMIT-HASH
              Checkout  a  revision  of the repository.  By default this applies the current modified files onto
              the specified revision, but for most users the merge command is a safer alternative.  The  --force
              flag is used to discard current changes and checkout the revision specified.

       log    Display a log of changes made to the repository.

       merge COMMIT-HASH
              Merges the specified change with the current HEAD.

       newfs FS-NAME
              Create a file system with the given name.

       removefs FS-NAME
              Remove the specified file system.

       show   Show repository information.

       snapshot [-m MESSAGE] [SNAPSHOT-NAME]
              Take a snapshot of the repository.  You may optionally supply a message to be included and a name.

       snapshots
              List all snapshots in this repository.

       status Show a list of currently modified files and directories in the repository.

       tip    Print the commit hash for the HEAD revision.

REMOTE MANAGEMENT COMMANDS

       This  section  lists  commands  used  to  clone  repositories,  pull changes, and manage a list of remote
       repositories to interact with.  The special remote repository named origin is used  as  the  default  for
       certain operations that take an optional remote name. At the moment an InstaCloned repository can only be
       created with orifs.

       replicate [--ondemand] SOURCE-PATH
              Clone a remote or local repository into a new directory.

       pull [PATH|REMOTE-NAME]
              Pulls  changes from a repository. The user can specify a path to another repository or the name of
              a previously registered repository. By default the command pulls from the origin.

       remote Display a list of the remote nodes.

       remote add NAME PATH
              Add a remote repository given a path

       remote remove NAME
              Remove a remote repository by name

ADVANCED COMMANDS

       This section lists a few commands that are for advanced users only.  They either provide access to  lower
       level  functionality  or  are  experimental.  The verify command is useful to all users to check that the
       repository has not been corrupted.

       filelog
              Displays a log of relevant commits made to the specified file.

       findheads
              Searches for detached heads that are not referenced by a branch.

       gc     Garbage collect any deleted objects that have not been reclaimed.  This will repack the pack files
              that contain deleted objects.

       graft  Experimental command to graft changes from one repository into another.

       purgecommit COMMIT-HASH
              Deletes a commit. Use this command with caution as it's experimental as certain  commands  may  no
              longer work after.

       verify Verify that the repository is consistent.

OTHER COMMANDS

       help   Display a list of commands and their purpose.

       SEE ALSO
              orifs(1), orisync(1), ori_httpd(1)

Ori Project                                      September 2013                                           ORI(1)