blob: 13e21d122bd1ddd2946e34c4a6b46a97ea23692a (
plain)
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
|
.TH "BST ARTIFACT" "1" "2020-04-23" "" "bst artifact Manual"
.SH NAME
bst\-artifact \- Manipulate cached artifacts.
.SH SYNOPSIS
.B bst artifact
[OPTIONS] COMMAND [ARGS]...
.SH DESCRIPTION
Manipulate cached artifacts
.PP
Some subcommands take artifact references as arguments. Artifacts
can be specified in two ways:
.PP
- artifact refs: triples of the form <project name>/<element name>/<cache key>
- element paths
.PP
When elements are given, the artifact corresponding to the element is used.
.PP
The commands also support shell-style wildcard expansion: `?` matches a
single character, and `*` matches zero or more. The patterns are matched
against artifact refs by default. If the pattern ends with `.bst` then
it matches element paths instead. Some example arguments are:
.PP
- `myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f`
- `myproject/he*/827637*`
- `*.bst` (all elements)
- `myproject/*` (all artifacts from myproject)
.SH COMMANDS
.PP
\fBshow\fP
Show the cached state of artifacts
See \fBbst artifact-show(1)\fP for full documentation on the \fBshow\fP command.
.PP
\fBcheckout\fP
Checkout contents of an artifact
See \fBbst artifact-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
.PP
\fBpull\fP
Pull a built artifact
See \fBbst artifact-pull(1)\fP for full documentation on the \fBpull\fP command.
.PP
\fBpush\fP
Push a built artifact
See \fBbst artifact-push(1)\fP for full documentation on the \fBpush\fP command.
.PP
\fBlog\fP
Show logs of artifacts
See \fBbst artifact-log(1)\fP for full documentation on the \fBlog\fP command.
.PP
\fBlist-contents\fP
List the contents of an artifact
See \fBbst artifact-list-contents(1)\fP for full documentation on the \fBlist-contents\fP command.
.PP
\fBdelete\fP
Remove artifacts from the local cache
See \fBbst artifact-delete(1)\fP for full documentation on the \fBdelete\fP command.
|
