VENTI(1)                                                 VENTI(1)

     NAME
          read, write, copy - simple Venti clients

     SYNOPSIS
          venti/read [ -h host ] [ -t type ] score
          venti/write [ -z ] [ -h host ] [ -t type ]
          venti/copy [ -fir ] [ -t type ] srchost dsthost score [ type
          ]

     DESCRIPTION
          Venti is a SHA1-addressed block storage server.  See
          venti(6) for a full introduction.

          Read reads a block with the given score and numeric type
          from the server host and prints the block to standard out-
          put.  If the -h option is omitted, read consults the envi-
          ronment variable $venti for the name of the Venti server.
          If the -t option is omitted, read will try each type, one at
          a time, until it finds one that works.  It prints the corre-
          sponding read -t command to standard error to indicate the
          type of the block.

          Write writes at most 56 kilobytes of data from standard
          input to the server host and prints the resulting score to
          standard output.  If the -t option is omitted, write uses
          type 0, denoting a data block.  If the -z option is given,
          write zero truncates the block before writing it to the
          server.

          Copy expects score to be the score of a VtRoot block.  It
          copies the entire tree of blocks reachable from the root
          block from the server srchost to the server dsthost.

          The -f option causes copy to run in `fast' mode, assuming
          that if a block already exists on the destination Venti
          server, all its children also exist and need not be checked.

          The -i and -r options control copy's reaction to errors
          reading from srchost. Copy always prints information to
          standard error about each read error.  By default, copy
          exits after printing the first error.  If the -i option is
          given, read errors are ignored.  This is dangerous behavior
          because it breaks the assumption made by `fast' mode.  If
          the -r option is given, copy replaces pointers to unreadable
          blocks with pointers to the zero block.  It writes the new
          root score to standard output.

     SOURCE
          /sys/src/cmd/venti

     Page 1                       Plan 9            (printed 11/18/24)

     VENTI(1)                                                 VENTI(1)

     SEE ALSO
          vac(1), venti(2), vacfs(4), venti(6), venti(8), venti-
          backup(8), venti-fmt(8)

     BUGS
          There should be programs to read and write venti files and
          directories.

     Page 2                       Plan 9            (printed 11/18/24)