0store(1)

10STORE(1)                                                            0STORE(1)
2
3
4

NAME

6       0store - manage the implementation cache
7
8

SYNOPSIS

10       0store add DIGEST DIRECTORY
11
12       0store add DIGEST ARCHIVE [ EXTRACT ]
13
14       0store copy DIRECTORY [ DIRECTORY ]
15
16       0store find DIGEST
17
18       0store list
19
20       0store manifest DIRECTORY [ ALGORITHM ]
21
22       0store optimise [ CACHE ]
23
24       0store verify ( DIGEST | DIRECTORY )
25
26

DESCRIPTION

28       0store provides access to the low-level implementation cache. Normally,
29       the cache is updated automatically using 0launch(1).
30
31

ADD

33       To add a directory to the store (makes a copy):
34
35       0store add sha1=XXX directory
36
37
38       To add an archive to the store:
39
40       0store add sha1=XXX archive.tgz
41
42
43       To add a subdirectory of an archive to the store:
44
45       0store add sha1=XXX archive.tgz subdir
46
47
48       The actual digest is calculated and compared to the given one. If  they
49       don't match, the operation is rejected.
50
51

COPY

53       To  copy  an implementation (a directory with a name in the form "algo‐
54       rithm=value"), use the copy function. This is similar to  performing  a
55       normal  recursive  directory  copy followed by a 0store verify to check
56       that the name matches the contents. E.g.:
57
58       0store  copy   ~someuser/.cache/0install.net/implementations/sha256=XXX
59       /var/cache/0install.net/implementations/
60
61

FIND

63       To find the path of a stored item:
64
65       0store find sha1=XXX
66
67

LIST

69       See the list of implementation caches currently configured:
70
71       0store list
72
73       To add directories to this list, add them to your 'implementation-dirs'
74       configuration file.
75
76

MANIFEST

78       To generate the manifest for a directory structure:
79
80       0store manifest DIRECTORY [ALGORITHM]
81
82
83       The manifest lists every file and directory in the tree, along with the
84       digest  of  each file, thus uniquely identifying that particular set of
85       files.  After the manifest, the last line gives the digest of the mani‐
86       fest itself.
87
88
89       This  value is needed when creating interface files. However, the 0pub‐
90       lish command will automatically calculate the required digest  for  you
91       and  add  it to an interface file. See the packager's guide on the Zero
92       Install web site for details.
93
94       Supported algorithms are 'sha1' (supported by all versions),  'sha1new'
95       (requires  injector 0.20 or later) and 'sha256' (requires injector 0.20
96       or later AND the Python hashlib module).
97
98

OPTIMISE

100       To hard-link duplicate files together to save space:
101
102       0store optimise [CACHE]
103
104
105       This  reads  in  all  the  manifest  files  in  the   cache   directory
106       (~/.cache/0install.net/implementations by default) and looks for dupli‐
107       cates (files with the same permissions, modification time and  digest).
108       When  it finds a pair, it deletes one and replaces it (atomically) with
109       a hard-link to the other.
110
111
112       Implementations using the old 'sha1' algorithm are not optimised.
113
114

VERIFY

116       To check that an item is stored correctly:
117
118       0store verify /path/to/sha1=XXX
119
120       This calculates the manifest of  the  directory  and  checks  that  its
121       digest matches the directory's name. It also checks that it matches the
122       digest of the .manifest file inside the  directory.  If  the  .manifest
123       doesn't  correspond to the current tree, it displays a list of the dif‐
124       ferences (in unified diff format).
125
126

COMMAND-LINE OPTIONS

128       -h, --help
129              Show the built-in help text.
130
131
132       -v, --verbose
133              More verbose output. Use twice for even more verbose output.
134
135
136       -V, --version
137              Display version information.
138
139

FILES

141       ~/.cache/0install.net/implementations
142              Cached implementations, indexed by manifest digest.
143
144
145       ~/.config/0install.net/injector/implementation-dirs
146              List of system cache directories, one per line.
147
148

LICENSE

150       Copyright (C) 2006 Thomas Leonard.
151
152
153       You may redistribute copies of this program under the terms of the  GNU
154       Lesser General Public License.
155
156

BUGS

158       Please report bugs to the developer mailing list:
159
160       http://0install.net/support.html
161
162

AUTHOR

164       The Zero Install Injector was created by Thomas Leonard.
165
166