-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathsnaps.8
70 lines (70 loc) · 1.59 KB
/
snaps.8
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
.Dd May 22, 2018
.Dt SNAPS 8
.Os
.Sh NAME
.Nm snaps
.Nd easy and secure remote snapshots
.Sh SYNOPSIS
.Nm
.Op Fl fhnqvV
.Op Fl c Pa configfile
.Op Fl s Ar filter
.Sh DESCRIPTION
The
.Nm
utility takes snapshots of remote locations using
.Xr ssh 1
and
.Xr hrsync 1 ,
which is a hardened version of rsync. Each location is being isolated from other
locations that are being backed up in order to mitigate against a compromised
remote host.
.Pp
The following arguments are supported:
.Bl -tag -width Ds
.It Fl f
Force taking a new snapshot, even if the last snapshot has not yet expired.
.It Fl h
Print the synopsis of
.Nm .
.It Fl n
Only check the syntax of the config file and exit.
.It Fl q
Be quiet, except for errors.
.It Fl v
Be more verbose.
Multiple occurrences increase the verbosity level.
.It Fl V
Print the current version of
.Nm
and exit.
.It Fl c Ar configfile
Use an alternate configuration file.
The default config file used is /etc/snaps.conf.
.It Fl s Ar filter
Only backup locations in the config file that match
.Ar filter .
Each configured location is canonicalized to user@host:path and can
be filtered on any substring.
This option can be passed multiple times so that more locations are matched.
.El
.Pp
.Nm
runs as an unprivileged user.
This user must have access to a public/private key pair that is used by
.Xr ssh 1
to login to each remote location.
.Sh FILES
.Bl -tag -width "/etc/snaps.conf" -compact
.It Pa /etc/snaps.conf
Default configuration file.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr hrsync 1 ,
.Xr ssh 1 ,
.Xr snaps.conf 5
.Sh AUTHORS
.An -nosplit
.An Tim Kuijsten Aq Mt [email protected]