1backintime(1)                    USER COMMANDS                   backintime(1)
2
3
4

NAME

6       backintime - a simple backup tool for Linux.
7
8       This  is  command line tool.  The graphical tools are: backintime-gnome
9       and backintime-kde4.
10

SYNOPSIS

12       backintime [ --backup  |  --backup-job  |  --snapshots-path  |  --snap‐
13       shots-list  |  --snapshots-list-path  |  --last-snapshot | --last-snap‐
14       shot-path | --help | --version | --license ]
15

DESCRIPTION

17       Back In Time is a simple backup tool for Linux. The backup is  done  by
18       taking snapshots of a specified set of folders.
19
20       All  you have to do is configure: where to save snapshots, what folders
21       to backup.  You can also specify a backup schedule: disabled,  every  5
22       minutes,  every  10  minutes,  every hour, every day, every week, every
23       month. To configure it use one of the  graphical  interfaces  available
24       (backintime-gnome or backintime-kde4).
25
26       It  acts  as  a  'user  mode'  backup  tool.  This  means  that you can
27       backup/restore only folders you have write access to (actually you  can
28       backup read-only folders, but you can't restore them).
29
30       If you want to run it as root you need to use 'su'.
31
32       A  new  snapshot  is  created  only if something changed since the last
33       snapshot (if any).
34
35       A snapshot contains all the files from the selected folders (except for
36       exclude patterns).  In order to reduce disk space it use hard-links (if
37       possible) between snapshots for unchanged files. This  way  a  file  of
38       10Mb, unchanged for 10 snapshots, will use only 10Mb on the disk.
39
40       When you restore a file 'A', if it already exists on the file system it
41       will be renamed to 'A.backup.currentdate'.
42
43       For automatic backup it use 'cron' so there is no need  for  a  daemon,
44       but 'cron' must be running.
45
46   user-callback
47       During  backup process the application can call a user callback at dif‐
48       ferent steps.  This callback is "$XDG_CONFIG_HOME/backintime/user-call‐
49       back" (by default $XDG_CONFIG_HOME is ~/.config).
50
51       The first argument is the progile id (1=Main Profile, ...).
52
53       The second argument is the progile name.
54
55       The third argument is the reason:
56
57              1      Backup process begins.
58
59              2      Backup process ends.
60
61              3      A  new  snapshot was taken. The extra arguments are snap‐
62                     shot ID and snapshot path.
63
64              4      There was an error. The  second  argument  is  the  error
65                     code.
66                     Error codes:
67
68                     1      The application is not configured.
69
70                     2      A "take snapshot" process is already running.
71
72                     3      Can't  find snapshots folder (is it on a removable
73                            drive ?).
74
75                     4      A snapshot for "now" already exist.
76

OPTIONS

78       -b, --backup
79              take a snapshot now (if needed)
80
81       --backup-job
82              take a snapshot (if needed) depending on  schedule  rules  (used
83              for cron jobs)
84
85       --snapshots-path
86              display path where is saves the snapshots (if configured)
87
88       --snapshots-list
89              display the list of snapshot IDs (if any)
90
91       --snapshots-list-path
92              display the paths to snapshots (if any)
93
94       --last-snapshot
95              display last snapshot ID (if any)
96
97       --last-snapshot-path
98              display the path to the last snapshot (if any)
99
100       -h, --help
101              display a short help
102
103       -v, --version
104              show version
105
106       --license
107              show license
108

SEE ALSO

110       backintime-gnome, backintime-kde4.
111
112       Back In Time also has a website: http://backintime.le-web.org
113

AUTHOR

115       This  manual  page  was  written  by  BIT Team (<bit-team@lists.launch‐
116       pad.net>).
117
118
119
120version 1.0.6                      Mars 2009                     backintime(1)
Impressum