1bup-tag(1)                                                          bup-tag(1)
2
3
4

NAME

6       bup-tag - tag a commit in the bup repository
7

SYNOPSIS

9       bup tag
10
11       bup tag [-f] <tag name> <committish>
12
13       bup tag -d [-f] <tag name>
14

DESCRIPTION

16       bup tag lists, creates or deletes a tag in the bup repository.
17
18       A  tag is an easy way to retrieve a specific commit.  It can be used to
19       mark a specific backup for easier retrieval later.
20
21       When called without any arguments, the command lists all tags that  can
22       be  found  in the repository.  When called with a tag name and a commit
23       ID or ref name, it creates a new tag with the given name, if it doesn't
24       already  exist, that points to the commit given in the second argument.
25       When called with `-d' and a tag name, it removes the given tag,  if  it
26       exists.
27
28       bup  exposes the contents of backups with current tags, via any command
29       that lists or shows backups.  They can be found under the /.tag  direc‐
30       tory.   For  example,  the `ftp' command will show the tag named `tag1'
31       under /.tag/tag1.
32

OPTIONS

34       -d, --delete
35              delete a tag
36
37       -f, --force
38              Overwrite the named tag even if it  already  exists.   With  -f,
39              don't report a missing tag as an error.
40

EXAMPLES

42              $ bup tag new-puppet-version hostx-backup
43
44              $ bup tag
45              new-puppet-version
46
47              $ bup ftp "ls /.tag/new-puppet-version"
48              files..
49
50              $ bup tag -d new-puppet-version
51

SEE ALSO

53       bup-save(1), bup-split(1), bup-ftp(1), bup-fuse(1), bup-web(1)
54

BUP

56       Part of the bup(1) suite.
57

AUTHORS

59       Gabriel Filion <lelutin@gmail.com>.
60
61
62
63Bup 0.29.1                        2017-03-26                        bup-tag(1)