0store.1

   1 .TH 0STORE 1 "2005" "Thomas Leonard" ""
   2 .SH NAME
   3 0store \- manage the implementation cache
   4
   5 .SH SYNOPSIS
   6
   7 .B 0store clean
   8 \fBINTERFACE\fP
   9
  10 .B 0store manifest
  11 \fBDIRECTORY\fP
  12
  13 .B 0store delete
  14 (\fBDIGEST\fP | \fBDIRECTORY\fP)
  15
  16 .B 0store store
  17 \fBDIGEST\fP \fBDIRECTORY\fP
  18
  19 .B 0store verify
  20 (\fBDIGEST\fP | \fBDIRECTORY\fP)
  21
  22 .SH DESCRIPTION
  23 .PP
  24 0store provides access to the low-level implementation cache. Normally, the
  25 cache updated automatically using 0launch(1).
  26
  27 .SH LIST
  28
  29 .PP
  30 See the list of implementation caches currently configured:
  31
  32 .B 0store list
  33
  34 .SH MANIFEST
  35 .PP
  36 To generate the manifest for a directory structure:
  37
  38 .B 0store manifest DIRECTORY
  39
  40 .PP
  41 The manifest lists every file and directory in the tree, along with the SHA1
  42 digest of each file, thus uniquely identifying that particular set of files.
  43 After the manifest, the last line gives the SHA1 digest of the manifest itself.
  44 This value is needed when creating interface files. See the packager's guide on
  45 the Zero Install web site for details.
  46
  47 .SH FIND
  48 .PP
  49 To find the path of a stored item:
  50
  51 .B 0store find sha1=XXX
  52
  53 .SH STORE
  54 .PP
  55 To add a directory to the store (makes a copy):
  56
  57 .B 0store add sha1=XXX directory
  58
  59 .PP
  60 To add an archive to the store:
  61
  62 .B 0store add sha1=XXX archive.tgz
  63
  64 .PP
  65 To add a subdirectory of an archive to the store:
  66
  67 .B 0store add sha1=XXX archive.tgz subdir
  68
  69 .PP
  70 The actual digest is calculated and compared to the given one. If they don't
  71 match, the operation is rejected.
  72
  73 .SH VERIFY
  74 .PP
  75 To check that an item is stored correctly:
  76
  77 .B 0store verify /path/to/sha1=XXX
  78
  79 This calculates the manifest of the directory and checks that its digest matches
  80 the directory's name. It also checks that it matches the digest of the .manifest
  81 file inside the directory. If the .manifest doesn't correspond to the current
  82 tree, it displays a list of the differences (in unified diff format).
  83
  84 .SH COMMAND-LINE OPTIONS
  85
  86 .TP
  87 \fB-h\fP, \fB--help\fP
  88 Show the built-in help text.
  89
  90 .TP
  91 \fB-v\fP, \fB--verbose\fP
  92 More verbose output. Use twice for even more verbose output.
  93
  94 .TP
  95 \fB-V\fP, \fB--version\fP
  96 Display version information.
  97
  98 .SH FILES
  99
 100 .IP "~/.cache/0install.net/implementations"
 101 Cached implementations, indexed by manifest digest.
 102
 103 .SH LICENSE
 104 .PP
 105 Copyright (C) 2005 Thomas Leonard.
 106
 107 .PP
 108 You may redistribute copies of this program under the terms of the GNU General Public License.
 109
 110 .SH BUGS
 111 .PP
 112 Please report bugs to the developer mailing list:
 113
 114 http://0install.net/support.html
 115
 116 .SH AUTHOR
 117 .PP
 118 The Zero Install Injector was created by Thomas Leonard.
 119
 120 .SH SEE ALSO
 121 0alias(1), 0launch(1)
 122 .PP
 123 The Zero Install web-site:
 124
 125 .B http://0install.net