NAME

filesync - keep a directory in step with a master copy

SYNOPSIS

filesync sync --repo docs

Run filesync help for the full usage.

DESCRIPTION

See App::FileSync::CLI and App::FileSync.

OPTIONS

filesync sync takes these options; filesync help lists the options of the other commands.

--repo NAME

Sync this repo. Repeat it to sync several. Without it every repo in the client configuration is synced.

--dry-run

Print the planned actions without changing either side.

--force

Proceed despite the deletion limits that normally stop a suspicious run.

--no-prune

Do not prune this repo's local trash during the run.

--no-delta

Send whole files instead of block deltas.

--verbose

Raise the log level to debug for this run.

--quiet

Lower the log level to error and hide warnings. A repo where the sync did something still prints its summary; a repo where nothing happened (nothing planned, moved, deleted, conflicted or skipped, and no bytes sent) prints nothing, so a cron job that finds nothing to do is silent.

--json

Print one JSON document instead of text.

--config FILE

Read the client configuration from FILE.

EXIT STATUS

0 ok, 1 fatal error, 2 another run holds the lock, 3 completed with warnings, 4 verification found drift. When several repos are synced the most severe outcome wins: 1, then 3, then 2.

AUTHOR

Nigel Horne, <njh at nigelhorne.com>

LICENCE AND COPYRIGHT

Copyright 2026 Nigel Horne.

Usage is subject to the GPL2 licence terms. If you use it, please let me know.