@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
27
27
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
28
.in \\n[ rst2man-indent\\n[ rst2man-indent-level ] ]u
29
29
..
30
- .TH "BORG-CREATE" 1 "2024-09-09 " "" "borg backup tool"
30
+ .TH "BORG-CREATE" 1 "2024-09-26 " "" "borg backup tool"
31
31
.SH NAME
32
32
borg-create \- Create new archive
33
33
.SH SYNOPSIS
@@ -53,7 +53,9 @@ stdin\fP below for details.
53
53
The archive will consume almost no disk space for files or parts of files that
54
54
have already been stored in other archives.
55
55
.sp
56
- The archive name needs to be unique.
56
+ The archive name does NOT need to be unique, you can and should use the same
57
+ name for a series of archives. The unique archive identifier is its ID (hash)
58
+ and you can abbreviate the ID as long as it is unique.
57
59
.sp
58
60
In the archive name, you may use the following placeholders:
59
61
{now}, {utcnow}, {fqdn}, {hostname}, {user} and some others.
@@ -153,9 +155,6 @@ only display items with the given status characters (see description)
153
155
.B \-\- json
154
156
output stats as JSON. Implies \fB \-\- stats \fP \& .
155
157
.TP
156
- .B \-\- prefer\- adhoc\- cache
157
- experimental: prefer AdHocCache (w/o files cache) over AdHocWithFilesCache (with files cache).
158
- .TP
159
158
.BI \-\- stdin\- name \ NAME
160
159
use NAME in archive for stdin data (default: \(aq stdin\(aq )
161
160
.TP
@@ -283,18 +282,18 @@ $ borg create my\-files \e
283
282
# /home/<one directory>/.thumbnails is excluded, not /home/*/*/.thumbnails etc.)
284
283
$ borg create my\- files /home \-\- exclude \(aq sh:home/*/.thumbnails\(aq
285
284
286
- # Backup the root filesystem into an archive named \(dq root\- YYYY \- MM \- DD \(dq
285
+ # Backup the root filesystem into an archive named \(dq root\- archive \(dq
287
286
# use zlib compression (good, but slow) \- default is lz4 (fast, low compression ratio)
288
- $ borg create \- C zlib,6 \-\- one\- file\- system root\- {now:%Y \- %m \- %d} /
287
+ $ borg create \- C zlib,6 \-\- one\- file\- system root\- archive /
289
288
290
- # Backup into an archive name like FQDN\- root\- TIMESTAMP
291
- $ borg create \(aq {fqdn}\- root\- {now} \ (aq /
289
+ # Backup into an archive name like FQDN\- root
290
+ $ borg create \(aq {fqdn}\- root\(aq /
292
291
293
292
# Backup a remote host locally (\(dq pull\(dq style) using sshfs
294
293
$ mkdir sshfs\- mount
295
294
$ sshfs
[email protected] :/ sshfs
\- mount
296
295
$ cd sshfs\- mount
297
- $ borg create example.com\- root\- {now:%Y \- %m \- %d} .
296
+ $ borg create example.com\- root .
298
297
$ cd ..
299
298
$ fusermount \- u sshfs\- mount
300
299
@@ -323,17 +322,13 @@ $ borg create \-\-compression lzma,N arch ~
323
322
# Only compress compressible data with lzma,N (N = 0..9)
324
323
$ borg create \-\- compression auto,lzma,N arch ~
325
324
326
- # Use short hostname, user name and current time in archive name
327
- $ borg create \(aq {hostname}\- {user}\- {now}\(aq ~
328
- # Similar, use the same datetime format that is default as of borg 1.1
329
- $ borg create \(aq {hostname}\- {user}\- {now:%Y\- %m\- %dT%H:%M:%S}\(aq ~
330
- # As above, but add nanoseconds
331
- $ borg create \(aq {hostname}\- {user}\- {now:%Y\- %m\- %dT%H:%M:%S.%f}\(aq ~
325
+ # Use short hostname and user name as archive name
326
+ $ borg create \(aq {hostname}\- {user}\(aq ~
332
327
333
328
# Backing up relative paths by moving into the correct directory first
334
329
$ cd /home/user/Documents
335
330
# The root directory of the archive will be \(dq projectA\(dq
336
- $ borg create \(aq daily\- projectA\- {now:%Y \- %m \- %d} \ (aq projectA
331
+ $ borg create \(aq daily\- projectA\(aq projectA
337
332
338
333
# Use external command to determine files to archive
339
334
# Use \-\- paths\- from\- stdin with find to back up only files less than 1MB in size
0 commit comments