NAME

rrr-news - list files added to the dataset

SYNOPSIS

rrr-news [options]

OPTIONS

--after=s

List all new files after this point in time. The format of the timestamp is the unix epoch in floating point notation as used by recentfiles in general.

--before=s

List all new files before this point in time. The format of the timestamp is the unix epoch in floating point notation as used by recentfiles in general.

--contains_epoch=s

List this file if the epoch is in the collection. Implies --max=1. Can be combined with the other contains_* options to form a logical AND.

--contains_path=s

List this file if the path is in the collection. Implies --max=1. Can be combined with the other contains_* options to form a logical AND.

--contains_type=s

List this file if the type is in the collection. Implies --max=1. Can be combined with the other contains_* options to form a logical AND.

--dry-run!

(TBD) Do not really run the command, ...

--help|h

Prints a brief message and exits.

--local=s

Specifies a local principal file. Nothing is mirrored, the list is constructed from local resources. Cannot be combined with the --remote option.

--localroot=s

Specifies the local root directory. --remote must also be specified and mirroring is happening implicitly. If missing, a temporary directory is created to hold the data before constructing the list (but this is inefficient in case the program is called again later because the temporary directory is not persistent).

--max=i

Limit the list to at max this many items.

--remote=s

Specifies the remote principal file in rsync notation. This implies that the necessary remote files will be mirrored before constructing the list.

--rsync_options|rsync=s@

Multiple options in the form of key=value pairs. E.g.

--rsync=compress=1 --rsync=links=1

The options are passed to the underlying File::Rsync objects.

--skip-deletes!

Boolean. If true then delete events are skipped.

--verbose|v+

More feedback.

DESCRIPTION

rersyncrecent is a project to get speedy rsync operation on large trees over multiple hosts. It maintains a collection of files with metadata (so called recentfiles) that represent adjacent overlapping timespans of file change events.

rrr-news extracts from the recentfiles the new files added or modified. The remote-principal-file is the rsync-notation for the remote recentfile. The second argument is the path to the local mirror directory. If you omit the second argument, a temporary directory is taken instead.