Arcv

ARCV(8) System Administration Utilities ARCV(8)

NAME
Arcv - arcv

SYNOPSIS
arcv [OPTIONS] [COMMAND]

COMMAND:

log Shows the revision logs from most recent to the oldest.

diff [REVISION] Makes a char diff with the last archive using git diff tool

pub Creates a new release by tagging the current version with the content of the VERSION.txt file.

check Tells whether there are uncommited modifications

meld [REVISION] Makes a char diff with the last archive using meld diff tool

co FILENAME or REVISION File to checkout from head version

rev Displays head revision number

tarball
[REVISION] Creates a tarball of a versioned image

export REVISION Exports a release image in a git repo.

OPTIONS:

-f, --config =FILE
Arcv configuration filename

--verbose
Verbose mode

-o, --output =DIRECTORY Output folder for checkouts

-y Assume 'Yes' when prompted for confirmation

-n Assume 'No' when prompted for confirmation

--subproc
Indicates the app is called by another instance of it

DESCRIPTION
Arcv enables to make a backup of a folder.

Let folder be F. By default, successive versions of the backups of F folder are stored below a folder named "F.archive" below a top 'Archive' directory in the user's home directory.

A custom top archive directory can be passed on the script via the second argument.

PLATFORMS

Arcv is a bash script primarly developed and tested under Ubuntu 20 and later at the moment.

SYSTEM PRIVILEDGES

Only the user priviledges are required.

SYSTEM DEPENDENCIES

Arcv automatically handles dependencies toward external system packages, i.e. it attempts to install all required system packages, e.g. veracrypt-console for Vera volumes.

COMMAND DETAILS:

log

Shows the revision logs from most recent to the oldest.

diff [<arg>]

Makes a char diff with the last archive using git diff tool

pub

Creates a new release by tagging the current version with the content of the VERSION.txt file. Then it prompts the user for the next version and updates VERSION.txt accordingly.

check

Tells whether there are uncommited modifications. Return 0 when so, 1 otherwise.

meld [<arg>]

Makes a char diff with the last archive using meld diff tool

co <arg>

File to checkout from head version

rev

Displays head revision number

tarball [<arg>]

Creates a tarball of a versioned image. Without value, creates a tarball for the current image, i.e. the current working directory. With value 'head', creates a tarball for the cur‐
rent head of In both cases, the current working directory must be the root of the versioned folder. Creates a tarball of the current image

export <arg>

Exports a release image into the matching git repo located below the project archive folder.

OPTIONS DETAILS:

-f,--config <arg>

Arcv operational configuration filename, if different of the default one coming along with the app, modified or not.

--verbose

Verbose mode

-o,--output <arg>

Output folder for checkouts

-y

Assume 'Yes' answer for any confirmation request

-n

Assume 'No' answer for any confirmation request

--subproc

Indicates the app is called by another instance of it

EXAMPLES
# Unmounting from volume label:

arcv ~/mytool ~/Archive

AUTHOR
Written by Michel Mehl

REPORTING BUGS
Report bugs to <michel.mehl@slashetc.fr>

License terms written down in file LICENSE.txt Les termes de la licence sont détaillés dans le fichier LICENSE.txt

Arcv 1.0.1 May 2026 ARCV(8)