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