SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from RedHat EL 7 bar-0.21-193.1.x86_64.rpm

bar

Section: Linux User's Manual (7)
Updated: 14 October 2017
Index 

NAME

bar - backup archiver program 

SYNOPSIS

bar [<options>] [--] <archive name> [<file>|<device>...]bar [<options>] --generate-keys [--] <key file name>Archive name:  file://<file name>               ftp:// [<login name>[:<password>]@]<host name>]/<file name>               scp:// [<login name>[:<password>]@]<host name>[:<port>]/<file name>               sftp:// [<login name>[:<password>]@]<host name>[:<port>]/<file name>               webdav:// [<login name>[:<password>]@]<host name>/<file name>               cd:// [<device name>:]<file name>               dvd:// [<device name>:]<file name>               bd:// [<device name>:]<file name>               device:// [<device name>:]<file name>
 

DESCRIPTION

BAR is a backup archiver program for files and disk images to create compressed,encrypted and splitted archive files which can be stored on a local hard disk,via network on a server or (with additional external tools) an optical mediumlike a CD, DVD, or BD. It can create full and incremental/differential archives.

Archive files can be created, the content can be listed, tested, compared andextracted. Individual archive files can be read independent. Listing the contents ofan archive is fast, even when the content is compressed and encrypted. The contentcan be compressed with either zip(1), bzip2(1), lzma(1), lzo(1), lz4(1), andadditionally xdelta(1). For encryption several encryption algorithms from thelibcrypt project like AES or TWOFISH can be used. Public key encryption (RSA) isalso supported.

CDs, DVDs, BDs with archive files can be created when the external toolsgrowisofs(1) and mkisofs(1) are installed. If the tool dvdisaster(1) isavailable CDs and DVDs with additional error correction codes can be created.

BAR can be executed as a daemon and can created backups in the background viathe integrated scheduler. The BAR daemon can be controlled via a networkconnection (either plain or SSL encrypted) with the graphical front endbarcontrol(3). 

OPTIONS

-c|--create
create new files archive
-m|--image
create new images archive
-l|--list
list contents of archive
-t|--test
test contents of archive
-d|--compare
compare contents of archive with files and images
-x|--extract
restore archive
--generate-keys
generate new public/private key pair
--generate-keys-bits=<n>[K]
key bits (default: 1K)
--job=<name>
execute job
--normal
create normal archive (no incremental list file)
-f|--full
create full archive and incremental list file
-i|--incremental
create incremental archive
-I|--incremental-list-file=<file name>
incremental list file name (default: <archive name>.bid)
--differential
create differential archive
--pattern-type=<name>
select pattern type
glob
glob patterns: * and ? (default)
regex
regular expression pattern matching
extended
extended regular expression pattern matching
-#|--include=<pattern>
include pattern
--include-file-command=<command>
include file pattern command
--include-image-command=<command>
include image pattern command
-!|--exclude=<pattern>
exclude pattern
--exclude-command=<command>
exclude pattern command
--mount=<name>
mount device
--delta-source=<pattern>
source pattern
--config=<file name>
configuration file
--tmp-directory=<path>
temporary directory (default: /tmp)
--max-tmp-size=<n>[T|G|M|K]
max. size of temporary files
-s|--archive-part-size=<n>[T|G|M|K]
approximated archive part size
-p|--directory-strip=<n>
number of directories to strip on extract
--destination=<path>
destination to restore entries (default: )
--owner=<user:group>
user and group of restored files
-z|--compress-algorithm=<algorithm|xdelta+algorithm>
select compress algorithms to use
none
no compression (default)
zip0..zip9
ZIP compression level 0..9
bzip1..bzip9
BZIP2 compression level 1..9
lzma1..lzma9
LZMA compression level 1..9
lzo1..lzo5
LZO compression level 1..5
lz4-0..lz4-16
LZ4 compression level 0..16additional select with '+':xdelta1..xdelta9: XDELTA compression level 1..9
--compress-min-size=<n>[T|G|M|K]
minimal size of file for compression (default: 32)
--compress-exclude=<pattern>
exclude compression pattern
-y|--crypt-algorithm=<name>
select crypt algorithm to use
none
no encryption (default)
3DES
3DES cipher
CAST5
CAST5 cipher
BLOWFISH
Blowfish cipher
AES128
AES cipher 128bit
AES192
AES cipher 192bit
AES256
AES cipher 256bit
TWOFISH128
Twofish cipher 128bit
TWOFISH256
Twofish cipher 256bit
SERPENT128
Serpent cipher 128bit
SERPENT192
Serpent cipher 192bit
SERPENT256
Serpent cipher 256bit
CAMELLIA128
Camellia cipher 128bit
CAMELLIA192
Camellia cipher 192bit
CAMELLIA256
Camellia cipher 256bit
--crypt-type=<name>
select crypt type
symmetric
symmetric (default)
asymmetric
asymmetric
--crypt-password=<password>
crypt password (use with care!)
--crypt-public-key=<file name>
public key for encryption
--crypt-private-key=<file name>
private key for decryption
--ftp-login-name=<name>
ftp login name
--ftp-password=<password>
ftp password (use with care!)
--ftp-max-connections=<n>
max. number of concurrent ftp connections
--ssh-port=<n>
ssh port (default: 22)
--ssh-login-name=<name>
ssh login name
--ssh-password=<password>
ssh password (use with care!)
--ssh-public-key=<file name>
ssh public key file name
--ssh-private-key=<file name>
ssh private key file name
--ssh-max-connections=<n>
max. number of concurrent ssh connections
--webdav-login-name=<name>
WebDAV login name
--webdav-password=<password>
WebDAV password (use with care!)
--webdav-max-connections=<n>
max. number of concurrent WebDAV connections
--daemon
run in daemon mode
-D|--no-detach
do not detach in daemon mode
--server-port=<n>
server port (default: 38523)
--server-tls-port=<n>
TLS (SSL) server port (default: 38524)
--server-ca-file=<file name>
TLS (SSL) server certificate authority file (CA file)
--server-cert-file=<file name>
TLS (SSL) server certificate file
--server-key-file=<file name>
TLS (SSL) server key file
--server-password=<password>
server password (use with care!)
--server-max-connections=<n>
max. concurrent connections to server (default: 8)
--server-jobs-directory=<path name>
server job directory (default: /etc/bar/jobs)
--nice-level=<n>
general nice level of processes/threads
--max-threads=<n>
max. number of concurrent compress/encryption threads
--max-band-width=<number or file name>
max. network band width to use [bits/s]
--remote-bar-executable=<file name>
remote BAR executable
--pre-command=<command>
pre-process command
--post-command=<command>
post-process command
--file-write-pre-command=<command>
write file pre-process command
--file-write-post-command=<command>
write file post-process command
--ftp-write-pre-command=<command>
write FTP pre-process command
--ftp-write-post-command=<command>
write FTP post-process command
--scp-write-pre-command=<command>
write SCP pre-process command
--scp-write-post-command=<command>
write SCP post-process command
--sftp-write-pre-command=<command>
write SFTP pre-process command
--sftp-write-post-command=<command>
write SFTP post-process command
--webdav-write-pre-command=<command>
write WebDAV pre-process command
--webdav-write-post-command=<command>
write WebDAV post-process command
--cd-device=<device name>
default CD device (default: /dev/cdrw)
--cd-request-volume-command=<command>
request new CD volume command
--cd-unload-volume-command=<command>
unload CD volume command (default: eject %device)
--cd-load-volume-command=<command>
load CD volume command (default: eject -t %device)
--cd-volume-size=<n>[T|G|M|K]
CD volume size
--cd-image-pre-command=<command>
make CD image pre-process command
--cd-image-post-command=<command>
make CD image post-process command
--cd-image-command=<command>
make CD image command (default: nice mkisofs -V Backup -volset %number -r -o %image %directory)
--cd-ecc-pre-command=<command>
make CD error-correction codes pre-process command
--cd-ecc-post-command=<command>
make CD error-correction codes post-process command
--cd-ecc-command=<command>
make CD error-correction codes command (default: nice dvdisaster -mRS02 -n cd -c -i %image -v)
--cd-blank-command=<command>
blank CD medium command (default: nice dvd+rw-format -blank %device)
--cd-write-pre-command=<command>
write CD pre-process command
--cd-write-post-command=<command>
write CD post-process command
--cd-write-command=<command>
write CD command (default: nice sh -c 'mkisofs -V Backup -volset %number -r -o %image %directory && cdrecord dev=%device %image')
--cd-write-image-command=<command>
write CD image command (default: nice cdrecord dev=%device %image)
--dvd-device=<device name>
default DVD device (default: /dev/dvd)
--dvd-request-volume-command=<command>
request new DVD volume command
--dvd-unload-volume-command=<command>
unload DVD volume command (default: eject %device)
--dvd-load-volume-command=<command>
load DVD volume command (default: eject -t %device)
--dvd-volume-size=<n>[T|G|M|K]
DVD volume size
--dvd-image-pre-command=<command>
make DVD image pre-process command
--dvd-image-post-command=<command>
make DVD image post-process command
--dvd-image-command=<command>
make DVD image command (default: nice mkisofs -V Backup -volset %number -r -o %image %directory)
--dvd-ecc-pre-command=<command>
make DVD error-correction codes pre-process command
--dvd-ecc-post-command=<command>
make DVD error-correction codes post-process command
--dvd-ecc-command=<command>
make DVD error-correction codes command (default: nice dvdisaster -mRS02 -n dvd -c -i %image -v)
--dvd-blank-command=<command>
blank DVD mediumcommand (default: nice dvd+rw-format -blank %device)
--dvd-write-pre-command=<command>
write DVD pre-process command
--dvd-write-post-command=<command>
write DVD post-process command
--dvd-write-command=<command>
write DVD command (default: nice growisofs -Z %device -A BAR -V Backup -volset %number -r %directory)
--dvd-write-image-command=<command>
write DVD image command (default: nice growisofs -Z %device=%image -use-the-force-luke=dao -dvd-compat -use-the-force-luke=noload)
--bd-device=<device name>
default BD device (default: /dev/bd)
--bd-request-volume-command=<command>
request new BD volume command
--bd-unload-volume-command=<command>
unload BD volume command (default: eject %device)
--bd-load-volume-command=<command>
load BD volume command (default: eject -t %device)
--bd-volume-size=<n>[T|G|M|K]
BD volume size
--bd-image-pre-command=<command>
make BD image pre-process command
--bd-image-post-command=<command>
make BD image post-process command
--bd-image-command=<command>
make BD image command (default: nice mkisofs -V Backup -volset %number -r -o %image %directory)
--bd-ecc-pre-command=<command>
make BD error-correction codes pre-process command
--bd-ecc-post-command=<command>
make BD error-correction codes post-process command
--bd-ecc-command=<command>
make BD error-correction codes command (default: nice dvdisaster -mRS02 -n bd -c -i %image -v)
--bd-blank-command=<command>
blank BD medium command (default: nice dvd+rw-format -blank %device)
--bd-write-pre-command=<command>
write BD pre-process command
--bd-write-post-command=<command>
write BD post-process command
--bd-write-command=<command>
write BD command (default: nice growisofs -Z %device -A BAR -V Backup -volset %number -r %directory)
--bd-write-image-command=<command>
write BD image command (default: nice growisofs -Z %device=%image -use-the-force-luke=dao -dvd-compat -use-the-force-luke=noload)
--device=<device name>
default device
--device-request-volume-command=<command>
request new volume command
--device-load-volume-command=<command>
load volume command
--device-unload-volume-command=<command>
unload volume command
--device-volume-size=<n>[T|G|M|K]
volume size
--device-image-pre-command=<command>
make image pre-process command
--device-image-post-command=<command>
make image post-process command
--device-image-command=<command>
make image command
--device-ecc-pre-command=<command>
make error-correction codes pre-process command
--device-ecc-post-command=<command>
make error-correction codes post-process command
--device-ecc-command=<command>
make error-correction codes command
--device-blank-command=<command>
blank device medium command
--device-write-pre-command=<command>
write device pre-process command
--device-write-post-command=<command>
write device post-process command
--device-write-command=<command>
write device command
--max-storage-size=<n>[T|G|M|K]
max. storage size
--volume-size=<n>[T|G|M|K]
volume size
--ecc
add error-correction codes with 'dvdisaster' tool
--always-create-image
always create image for CD/DVD/BD/device
--blank
blank medium before writing
--continuous-max-size=<n>[T|G|M|K]
max. continuous size
--index-database=<file name>
index database file name
--index-database-auto-update
enabled automatic update index database
--index-database-max-band-width=<number or file name>
max. band width to use for index updates [bis/s]--index-database-keep-time=<n>[weeks|week|days|day|h|m|s] time to keep index data of not existing storages (default: 86400)
--log=<name>[,<name>...]
log types
none
no logging (default)
errors
log errors
warnings
log warnings
ok
log stored/restored files
unknown
log unknown files
skipped
log skipped files
missing
log missing files
incomplete
log incomplete files
excluded
log excluded files
storage
log storage
index
index database
continuous
continuous backup
all
log everything
--log-file=<file name>
log file name
--log-format=<format>
log format (default: %Y-%m-%d %H:%M:%S)
--log-post-command=<command>
log file post-process command
--pid-file=<file name>
process id file name
-g|--group
group files in list
--all
show all files
-L|--long-format
list in long format
-H|--human-format
list in human readable format
--numeric-uid-gid
print numeric user/group ids
--numeric-permission
print numeric file/directory permissions
--no-header-footer
output no header/footer in list
--delete-old-archive-files
delete old archive files after creating new files
--ignore-no-backup-file
ignore .nobackup/.NOBACKUP file
--ignore-no-dump
ignore 'no dump' attribute of files
--skip-unreadable
skip unreadable files
--force-delta-compression
force delta compression of files. Stop on error
--raw-images
store raw images (store all image blocks)
--no-fragments-check
do not check completeness of file fragments
--no-index-database
do not store index database for archives
--archive-file-mode=<name>
select archive files write mode
stop
stop if archive file exists (default)
append
append to existing archive files
overwrite
overwrite existing archive files
-o|--overwrite-archive-files
overwrite existing archive files
--overwrite-files
overwrite existing entries
--wait-first-volume
wait for first volume
--dry-run
do dry-run (skip storage/restore, incremental data, index database)
--no-storage
do not store archives (skip storage, index database)
--no-bar-on-medium
do not store a copy of BAR on medium
--no-stop-on-error
do not immediately stop on error
--no-default-config
do not read configuration files /etc/bar/bar.cfg and ~/.bar/bar.cfg
--quiet
suppress any output
--version
output version
-h|--help
output this help
--xhelp
output help to extended options
--help-internal
output help to internal options
 

EXAMPLES

Create an archive:

  bar -c home.bar /home  bar -c home.bar /home --compress-algorithm=lzma9  bar -c file://home.bar /home --compress-algorithm=xdelta9+lzma9 --delta-source=home-previous.bar
List contents of an archive:

  bar *.bar  bar -l home*.bar  bar -L home*.bar
Test archive:

  bar -t home*.bar
Compare contents of an archive with files:

  bar -d home*.bar
Find most recent file in all archives:

  bar -g -# '*/foo' *.bar
Restore contents of an archive:

  bar -x home*.bar
 

DIAGNOSTICS

Exit code is zero if no error occurred. Errors result in a non-zero exitcode and a error message on standard error. 

FILES

/etc/bar/bar.cfg

  system wide bar configuration
/etc/bar/bar.jks

  private key for SSL connection with bar daemon
/etc/bar/jobs

  jobs directory
$HOME/.bar/bar.cfg

  user specific configuration
/etc/ssl/certs/bar-ca.pem, /etc/ssl/certs/bar-server-cert.pem

  BAR TLS/SSL certificates and public keys
/etc/ssl/private/bar-server-key.pem

  BAR TLS/SSL server private key
 

NOTES

See manual file bar.pdf for further information and details. 

BUGS

Please report bugs to torsten.ruppAATTgmx.net. If possible use bar-debug orcompile BAR with debugging enabled (configure option --enable-debug) andinclude a C stack trace in the bug report.

 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
DIAGNOSTICS
FILES
NOTES
BUGS
This document was created byman2html,using the manual pages.