| 1 | package App::FileSync::I18N::en; | ||
| 2 | |||
| 3 | # The English catalogue: every user-facing string in the distribution, by key. | ||
| 4 | # Placeholders are %{name}FMT (any sprintf conversion); see App::FileSync::I18N. | ||
| 5 | # Keys are grouped by the module that raises them. | ||
| 6 | |||
| 7 | 342 | ▶ | use strict; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 8 | 342 | ▶ | use warnings; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 9 | |||
| 10 | 342 | ▶ | use version; our $VERSION = version->declare('0.002.1'); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 11 | |||
| 12 | 342 | our %MESSAGES = ( | |
| 13 | # ---------------------------------------------------------- i18n itself | ||
| 14 | 'i18n.bad_language' => "Bad language code '%{language}s' (want two or three lower-case letters)", | ||
| 15 | 'i18n.bad_catalogue' => "The catalogue for '%{language}s' is not a hash", | ||
| 16 | |||
| 17 | # -------------------------------------------------------- arguments | ||
| 18 | 'args.invalid' => '%{routine}s: %{reason}s', | ||
| 19 | |||
| 20 | # ------------------------------------------------------- shared words | ||
| 21 | 'word.file' => { _by => 'count', one => '%{count}d file', other => '%{count}d files' }, | ||
| 22 | 'word.empty_dir' => { _by => 'count', one => '%{count}d empty dir', other => '%{count}d empty dirs' }, | ||
| 23 | 'word.snapshot' => { _by => 'count', one => 'snapshot', other => 'snapshots' }, | ||
| 24 | |||
| 25 | # ---------------------------------------------------- path validation | ||
| 26 | 'path.missing' => 'missing path', | ||
| 27 | 'path.not_text' => 'path is not text', | ||
| 28 | 'path.empty' => 'empty path', | ||
| 29 | 'path.too_long' => 'path is too long', | ||
| 30 | 'path.absolute' => 'absolute path', | ||
| 31 | 'path.drive' => 'drive-relative path', | ||
| 32 | 'path.backslash' => 'backslash in path', | ||
| 33 | 'path.nul' => 'NUL in path', | ||
| 34 | 'path.control' => 'control character in path', | ||
| 35 | 'path.empty_component' => 'empty path component', | ||
| 36 | 'path.dot_component' => 'dot path component', | ||
| 37 | 'path.parent_component' => 'parent path component', | ||
| 38 | 'path.component_too_long' => 'path component is too long', | ||
| 39 | 'path.unsafe' => "Unsafe path '%{path}s': %{reason}s", | ||
| 40 | |||
| 41 | # ------------------------------------------------------ id validation | ||
| 42 | 'id.repo_name' => 'repo name', | ||
| 43 | 'id.client_id' => 'client id', | ||
| 44 | 'id.missing' => 'missing %{what}s', | ||
| 45 | 'id.not_text' => '%{what}s is not text', | ||
| 46 | 'id.empty' => 'empty %{what}s', | ||
| 47 | 'id.too_long' => '%{what}s is too long', | ||
| 48 | 'id.bad' => "bad %{what}s '%{value}s'", | ||
| 49 | |||
| 50 | # ------------------------------------------------------- date parsing | ||
| 51 | 'when.bad' => "Bad %{option}s '%{value}s' (use YYYY-MM-DD or an epoch)", | ||
| 52 | |||
| 53 | # ------------------------------------------------------- file system | ||
| 54 | 'io.read' => 'Cannot read %{path}s: %{error}s', | ||
| 55 | 'io.write' => 'Cannot write %{path}s: %{error}s', | ||
| 56 | 'io.append' => 'Cannot append to %{path}s: %{error}s', | ||
| 57 | 'io.temp' => 'Cannot create a temporary file in %{path}s: %{error}s', | ||
| 58 | 'io.rename' => 'Cannot move %{from}s to %{to}s: %{error}s', | ||
| 59 | 'io.remove' => 'Cannot remove %{path}s: %{error}s', | ||
| 60 | 'io.replace_dir' => 'Cannot replace non-empty directory %{path}s', | ||
| 61 | 'io.copy' => 'Cannot copy %{from}s to %{to}s: %{error}s', | ||
| 62 | 'io.mkdir' => 'Cannot create directory %{path}s: %{error}s', | ||
| 63 | 'io.seek' => 'Cannot seek in %{path}s: %{error}s', | ||
| 64 | 'io.utime' => 'Cannot set the modification time of %{path}s: %{error}s', | ||
| 65 | 'io.short' => 'Unexpected end of %{path}s', | ||
| 66 | |||
| 67 | # ------------------------------------------------------- configuration | ||
| 68 | 'config.no_home' => 'Cannot determine your home directory; set FILESYNC_HOME', | ||
| 69 | 'config.parse' => 'Cannot parse %{path}s: %{error}s', | ||
| 70 | 'config.not_object' => '%{path}s is not a JSON object', | ||
| 71 | 'config.no_repo' => "No such repo '%{repo}s' under %{root}s (run filesync-admin repo create)", | ||
| 72 | |||
| 73 | # ------------------------------------------------------------ scanning | ||
| 74 | 'scan.unreadable' => 'cannot read: %{error}s', | ||
| 75 | 'scan.cannot_stat' => 'cannot stat: %{error}s', | ||
| 76 | 'scan.cannot_list' => 'cannot read directory: %{error}s', | ||
| 77 | 'scan.symlink' => 'symbolic link', | ||
| 78 | 'scan.special' => 'not a regular file', | ||
| 79 | |||
| 80 | # --------------------------------------------------------------- trash | ||
| 81 | 'trash.move' => 'Cannot move %{from}s to %{to}s: %{error}s', | ||
| 82 | 'trash.missing' => 'Trash: %{path}s is not there', | ||
| 83 | 'trash.exists' => 'Trash: refusing to overwrite %{path}s', | ||
| 84 | 'trash.cannot_stat' => 'Trash: cannot stat %{path}s: %{error}s', | ||
| 85 | 'trash.not_regular' => 'Trash: %{path}s is not a regular file', | ||
| 86 | |||
| 87 | # -------------------------------------------------------------- verify | ||
| 88 | 'verify.no_root' => 'Verify: %{root}s is not a directory', | ||
| 89 | 'verify.type_changed' => 'type changed', | ||
| 90 | |||
| 91 | # --------------------------------------------------------------- merge | ||
| 92 | 'merge.master' => 'master', | ||
| 93 | 'merge.deleted_changed' => '%{path}s: deleted on %{client}s but changed on the master; restored from the master', | ||
| 94 | 'merge.changed_deleted' => '%{path}s: changed on %{client}s but deleted on the master; restored to the master', | ||
| 95 | 'merge.conflict_copy' => '%{path}s: changed on both %{client}s and the master; %{kept}s version kept, %{other}s version saved as %{copy}s', | ||
| 96 | 'merge.conflict_dir' => '%{path}s: changed on both %{client}s and the master; %{kept}s version kept, the empty directory on the other side was discarded', | ||
| 97 | 'merge.replica_overwritten' => '%{path}s: changed on the replica; overwritten from the master', | ||
| 98 | 'merge.replica_removed' => '%{path}s: removed on the replica; not in the master', | ||
| 99 | 'merge.too_many' => 'refusing to delete %{count}d files (limit is %{max}d); rerun with --force if this is intended', | ||
| 100 | 'merge.too_many_percent' => 'refusing to delete %{count}d of %{known}d known files (limit is %{percent}s%%); rerun with --force if this is intended', | ||
| 101 | |||
| 102 | # --------------------------------------------------------------- delta | ||
| 103 | 'delta.bad_count' => 'Bad signature block count', | ||
| 104 | 'delta.bad_length' => 'Signature is %{length}d bytes, expected %{expected}d', | ||
| 105 | 'delta.no_output' => 'Delta: no output handle', | ||
| 106 | 'delta.no_block' => 'Delta: signature has no block length', | ||
| 107 | 'delta.write' => 'Cannot write the delta: %{error}s', | ||
| 108 | 'delta.read' => 'Cannot read the delta: %{error}s', | ||
| 109 | 'delta.bad_record' => "Bad delta record '%{type}s'", | ||
| 110 | 'delta.write_restored' => 'Cannot write the restored file: %{error}s', | ||
| 111 | |||
| 112 | # ------------------------------------------------------------ protocol | ||
| 113 | 'protocol.closed' => 'Protocol: connection is closed', | ||
| 114 | 'protocol.write_failed' => 'Protocol: cannot write to the connection: %{error}s', | ||
| 115 | 'protocol.malformed' => 'Protocol: malformed message from the peer: %{error}s', | ||
| 116 | 'protocol.not_object' => 'Protocol: message is not an object', | ||
| 117 | 'protocol.bad_length' => 'Protocol: bad payload length', | ||
| 118 | 'protocol.inflate' => 'Protocol: cannot decompress the payload', | ||
| 119 | 'protocol.corrupt' => 'Protocol: corrupt compressed payload', | ||
| 120 | 'protocol.too_large' => 'Protocol: compressed payload expands beyond the limit', | ||
| 121 | 'protocol.negative' => 'Protocol: negative payload length', | ||
| 122 | 'protocol.read_failed' => 'Protocol: read error: %{error}s', | ||
| 123 | 'protocol.eof' => 'Protocol: connection closed by the peer', | ||
| 124 | |||
| 125 | # --------------------------------------------------------------- store | ||
| 126 | 'store.bad_client' => 'Store: %{reason}s', | ||
| 127 | 'store.bad_repo' => 'Store: %{reason}s', | ||
| 128 | 'store.symlink' => 'Refusing to write through symlinked directory %{path}s', | ||
| 129 | 'store.no_master' => 'Master directory is missing: %{path}s', | ||
| 130 | |||
| 131 | 'admin.bad_repo' => 'Invalid repo name: %{reason}s', | ||
| 132 | 'admin.bad_client' => 'Invalid client id: %{reason}s', | ||
| 133 | 'admin.bad_role' => q{Invalid role '%{role}s' (want %{roles}s)}, | ||
| 134 | 'admin.repo_exists' => q{Repo '%{repo}s' already exists at %{path}s}, | ||
| 135 | 'admin.root_unwritable' => q{Server root '%{root}s' is not writable by this account (%{blocked}s); chown it to the account that runs filesync-admin and filesync-server, or use --root elsewhere}, | ||
| 136 | 'admin.locked' => q{Another sync session holds the lock for repo '%{repo}s'}, | ||
| 137 | 'admin.unsafe_path' => q{Unsafe path '%{path}s': %{reason}s}, | ||
| 138 | 'admin.no_versions' => q{No trashed version of '%{path}s' in repo '%{repo}s'}, | ||
| 139 | 'admin.bad_date' => q{Bad --date '%{date}s' (want YYYY-MM-DD)}, | ||
| 140 | 'admin.no_version_on' => q{No version of '%{path}s' in the trash for %{date}s}, | ||
| 141 | 'admin.not_dir' => 'Restore target %{path}s is not a directory', | ||
| 142 | 'admin.exists' => 'Refusing to overwrite %{path}s; move it aside first', | ||
| 143 | |||
| 144 | 'server.missing' => 'Server: no %{what}s given', | ||
| 145 | 'server.bad_role' => q{Server: bad role '%{role}s'}, | ||
| 146 | 'server.bad_id' => 'Server: %{reason}s', | ||
| 147 | 'server.no_connection' => 'Server: no connection', | ||
| 148 | 'server.locked' => q{Another sync session holds the lock for repo '%{repo}s'}, | ||
| 149 | 'server.unknown_error' => 'unknown server error', | ||
| 150 | 'server.journal_failed' => 'cannot journal the failed session: %{error}s', | ||
| 151 | 'server.not_allowed' => q{Client '%{client}s' is not allowed on repo '%{repo}s'}, | ||
| 152 | 'server.wrong_role' => q{Client '%{client}s' is registered as '%{registered}s', not '%{asked}s'}, | ||
| 153 | 'server.proto' => 'Unsupported protocol version', | ||
| 154 | 'server.pinned' => q{Session is pinned to %{field}s '%{expected}s' but the client asked for '%{given}s'}, | ||
| 155 | 'server.unknown' => q{Unknown command '%{command}s'}, | ||
| 156 | 'server.manifest_list' => 'Manifest is not a list', | ||
| 157 | 'server.manifest_entry' => 'Manifest entry is not an object', | ||
| 158 | 'server.manifest_path' => 'Manifest path rejected: %{reason}s', | ||
| 159 | 'server.manifest_field' => q{Bad manifest field '%{field}s' for %{path}s}, | ||
| 160 | 'server.refused' => '%{reason}s', | ||
| 161 | 'server.op.read' => 'Read', | ||
| 162 | 'server.op.write' => 'Write', | ||
| 163 | 'server.op.delta' => 'Delta write', | ||
| 164 | 'server.op.pull' => 'Signature upload', | ||
| 165 | 'server.op.mkdir' => 'Directory creation', | ||
| 166 | 'server.op.delete' => 'Deletion', | ||
| 167 | 'server.op.ack' => 'Ack', | ||
| 168 | 'server.unplanned' => q{%{what}s of unplanned path '%{path}s'}, | ||
| 169 | 'server.not_planned' => q{%{what}s of '%{path}s' is not in the plan}, | ||
| 170 | 'server.bad_field' => q{Bad '%{field}s' for '%{path}s'}, | ||
| 171 | 'server.conflict_name' => q{Conflict copy of '%{path}s' must be named '%{expected}s'}, | ||
| 172 | 'server.no_put' => q{Data for '%{path}s' without a put}, | ||
| 173 | 'server.too_large' => q{Chunk for '%{path}s' is too large}, | ||
| 174 | 'server.bad_copy' => q{Delta copy outside '%{path}s'}, | ||
| 175 | 'server.bad_signature' => q{Bad signature for '%{path}s'}, | ||
| 176 | 'server.no_signature' => q{Delta read for '%{path}s' without a signature}, | ||
| 177 | 'server.no_delta' => q{Delta data for '%{path}s' without a delta}, | ||
| 178 | 'server.bad_ack' => q{Ack for '%{path}s' does not match its planned action}, | ||
| 179 | 'server.conflict_unsafe' => 'Unsafe conflict name: %{reason}s', | ||
| 180 | 'server.conflict_same' => q{Conflict name for '%{path}s' is the same as the path}, | ||
| 181 | 'server.conflict_exists' => 'Conflict copy already exists: %{path}s', | ||
| 182 | 'server.conflict_move' => 'Cannot preserve %{path}s as %{to}s: %{error}s', | ||
| 183 | 'server.unfinished' => 'Session ended before all actions completed: %{paths}s', | ||
| 184 | 'server.busy' => q{Already receiving '%{path}s'}, | ||
| 185 | 'server.overflow' => q{Upload of '%{path}s' is larger than announced}, | ||
| 186 | 'server.hash_mismatch' => q{Hash mismatch for '%{path}s': expected %{expected}s, got %{got}s}, | ||
| 187 | 'server.size_mismatch' => q{Size mismatch for '%{path}s': expected %{expected}s, got %{got}s}, | ||
| 188 | 'server.cannot_stat' => 'Cannot stat %{path}s: %{error}s', | ||
| 189 | 'server.not_file' => q{Cannot send a directory for '%{path}s'}, | ||
| 190 | |||
| 191 | 'forced.program' => q{unexpected program '%{program}s' in the remote command}, | ||
| 192 | 'forced.argument' => q{unexpected argument '%{token}s' in the remote command}, | ||
| 193 | 'forced.no_value' => 'the remote command gives --%{flag}s without a value', | ||
| 194 | 'forced.flag' => 'the remote command may not set --%{flag}s', | ||
| 195 | 'forced.proto' => q{the remote command asks for protocol '%{proto}s'}, | ||
| 196 | 'forced.pinned' => q{the remote command asks for %{field}s '%{value}s' but this key is pinned to '%{expected}s'}, | ||
| 197 | |||
| 198 | 'client.no_config' => 'Client: no config', | ||
| 199 | 'client.bad_name' => 'Client: %{reason}s', | ||
| 200 | 'client.no_repo' => q{No repo '%{repo}s' in %{path}s}, | ||
| 201 | 'client.bad_root' => q{Sync root for '%{repo}s' is not a directory: %{root}s}, | ||
| 202 | 'client.no_marker' => 'Sync root %{root}s has no .filesync-root marker (unmounted drive?); refusing to sync', | ||
| 203 | 'client.locked' => q{Another filesync run holds the lock for '%{repo}s'}, | ||
| 204 | 'client.no_client_id' => 'No client_id in the client configuration', | ||
| 205 | 'client.refused' => 'Server refused the session: %{reason}s', | ||
| 206 | 'client.unknown_reason' => 'unknown error', | ||
| 207 | 'client.skipped' => '%{path}s: skipped (%{reason}s)', | ||
| 208 | 'client.verbose_action' => ' %{verb}s %{path}s', | ||
| 209 | 'client.unknown_action' => q{Unknown action '%{action}s' for %{path}s}, | ||
| 210 | 'client.req.plan' => '%{reason}s', | ||
| 211 | 'client.req.end' => 'Server did not accept the end of the session: %{reason}s', | ||
| 212 | 'client.req.manifest' => 'Server rejected the manifest: %{reason}s', | ||
| 213 | 'client.req.delete' => 'Cannot delete %{path}s on the server: %{reason}s', | ||
| 214 | 'client.req.ack_delete' => 'Server did not accept the deletion of %{path}s: %{reason}s', | ||
| 215 | 'client.req.ack_dir' => 'Server did not accept directory %{path}s: %{reason}s', | ||
| 216 | 'client.req.ack' => 'Server did not accept %{path}s: %{reason}s', | ||
| 217 | 'client.req.get' => 'Cannot read %{path}s from the server: %{reason}s', | ||
| 218 | 'client.req.mkdir' => 'Cannot create directory %{path}s on the server: %{reason}s', | ||
| 219 | 'client.req.put' => 'Server refused %{path}s: %{reason}s', | ||
| 220 | 'client.req.chunk' => 'Server rejected data for %{path}s: %{reason}s', | ||
| 221 | 'client.req.store' => 'Cannot store %{path}s on the server: %{reason}s', | ||
| 222 | 'client.req.signature' => 'Server refused the signature for %{path}s: %{reason}s', | ||
| 223 | 'client.req.delta' => 'Server refused the delta for %{path}s: %{reason}s', | ||
| 224 | 'client.req.delta_data' => 'Server rejected delta data for %{path}s: %{reason}s', | ||
| 225 | 'client.hash_mismatch' => 'Hash mismatch while copying %{path}s: expected %{expected}s, got %{got}s', | ||
| 226 | 'client.size_mismatch' => 'Size mismatch while copying %{path}s: expected %{expected}s, got %{got}s', | ||
| 227 | 'client.bad_copy' => 'Bad copy instruction for %{path}s', | ||
| 228 | 'client.bad_op' => 'Unknown delta instruction for %{path}s', | ||
| 229 | 'client.conflict_exists' => 'Conflict copy already exists: %{path}s', | ||
| 230 | 'client.conflict_move' => 'Cannot preserve %{path}s as %{to}s: %{error}s', | ||
| 231 | 'client.unsafe' => q{Unsafe path '%{path}s': %{reason}s}, | ||
| 232 | 'client.cannot_stat' => 'Cannot stat %{path}s: %{error}s', | ||
| 233 | 'client.need_server_root' => 'Repo %{repo}s needs a server_root for the local transport', | ||
| 234 | 'client.need_server' => 'Repo %{repo}s needs a server (user@host) for the ssh transport', | ||
| 235 | 'client.bad_transport' => q{Unknown transport '%{transport}s' for repo %{repo}s}, | ||
| 236 | 'client.record_failed' => 'cannot record this run in %{path}s: %{error}s', | ||
| 237 | 'client.no_versions' => q{No trashed version of '%{path}s' for repo '%{repo}s' in %{trash}s}, | ||
| 238 | 'client.not_dir' => 'Restore target %{path}s is not a directory', | ||
| 239 | 'client.exists' => 'Refusing to overwrite %{path}s; move it aside or use --to DIR', | ||
| 240 | 'client.not_replica' => q{Repo '%{repo}s' is a client, not a replica; only a replica keeps snapshots}, | ||
| 241 | |||
| 242 | 'transport.missing' => '%{transport}s transport: no %{what}s given', | ||
| 243 | 'transport.bad_value' => q{SSH transport: bad %{field}s '%{value}s'}, | ||
| 244 | 'transport.bad_id' => 'SSH transport: %{reason}s', | ||
| 245 | |||
| 246 | 'process.spawn' => q{Cannot start '%{program}s': %{error}s}, | ||
| 247 | 'process.inherit' => 'Cannot stop a child process inheriting a pipe: %{error}s', | ||
| 248 | |||
| 249 | 'cli.help.client' => <<'USAGE', | ||
| 250 | filesync - keep a directory in step with a master copy | ||
| 251 | |||
| 252 | filesync init --repo NAME --root DIR --server USER@HOST [--remote-repo NAME] | ||
| 253 | [--id ID] [--role client|replica] [--port N] [--identity FILE] | ||
| 254 | [--accept-host-key] [--known-hosts FILE] [--server-command PATH] | ||
| 255 | [--snapshot-mode hardlink|copy] | ||
| 256 | filesync init --repo NAME --root DIR --transport local --server-root DIR | ||
| 257 | [--remote-repo NAME] [--id ID] [--role client|replica] | ||
| 258 | filesync sync [--repo NAME]... [--dry-run] [--force] [--verbose] [--quiet] | ||
| 259 | [--json] [--no-prune] [--no-delta] | ||
| 260 | filesync status [--repo NAME] [--json] | ||
| 261 | filesync log [--repo NAME] [-n N] [--since YYYY-MM-DD|EPOCH] | ||
| 262 | [--until YYYY-MM-DD|EPOCH] [--exit N]... [--warnings] [--json] | ||
| 263 | filesync settings [--config FILE] [--json] | ||
| 264 | filesync verify [--repo NAME] [--deep] [--json] | ||
| 265 | filesync restore PATH [--repo NAME] [--to DIR] [--list] | ||
| 266 | filesync snapshot [--repo NAME] [--keep N] | ||
| 267 | filesync snapshot list [--repo NAME] | ||
| 268 | filesync snapshot restore DATE [PATH] [--repo NAME] [--to DIR] | ||
| 269 | filesync version | ||
| 270 | |||
| 271 | The sync root must contain the .filesync-root marker created by "filesync init". | ||
| 272 | Diagnostics go to stderr; settings are read from ~/.conf/app-filesync.json or | ||
| 273 | $FILESYNC_SETTINGS (log_level, log_format, log_file, ssh_identity, | ||
| 274 | ssh_known_hosts, server_command). "filesync settings" prints the effective | ||
| 275 | values and where each came from. Per-repo values from "filesync init" win; | ||
| 276 | port and host_key_checking exist per repo only and are marked [repo only]. | ||
| 277 | |||
| 278 | Exit codes: 0 ok, 1 fatal, 2 another run holds the lock, 3 completed with | ||
| 279 | warnings, 4 verification found drift. | ||
| 280 | |||
| 281 | "filesync init --help" explains the options init takes. | ||
| 282 | USAGE | ||
| 283 | 'cli.help.init' => <<'USAGE', | ||
| 284 | filesync init - register a directory in this client's configuration | ||
| 285 | |||
| 286 | filesync init --repo NAME --root DIR --server USER@HOST [options] | ||
| 287 | filesync init --repo NAME --root DIR --transport local --server-root DIR | ||
| 288 | |||
| 289 | --repo NAME the repo name, as the server knows it | ||
| 290 | --root DIR the local directory to keep in step (created if needed) | ||
| 291 | --server HOST the ssh server, as host or user@host | ||
| 292 | --server-root DIR the server root, for --transport local | ||
| 293 | --remote-repo NAME the repo name on the server, if it differs from --repo | ||
| 294 | --id ID the id the server knows this client by | ||
| 295 | |||
| 296 | The id defaults to this machine's host name. That is the name the server | ||
| 297 | keeps this client's base, journal entries and conflict copies under, and the | ||
| 298 | name "filesync-admin client allow" must list. Pass --id only to override it | ||
| 299 | - for two machines with the same host name, say. It is not a login, and it | ||
| 300 | does not divide the repo: every client of a repo syncs the whole tree. | ||
| 301 | |||
| 302 | --transport ssh|local how the server is reached; the default is ssh, or | ||
| 303 | local when --server-root is given | ||
| 304 | --role client|replica what this client may do; default client | ||
| 305 | --identity FILE ssh identity file | ||
| 306 | --known-hosts FILE ssh known_hosts file | ||
| 307 | --port N ssh port | ||
| 308 | --accept-host-key trust an unknown host key on first use | ||
| 309 | --server-command PATH the server program to run over ssh | ||
| 310 | --snapshot-mode MODE hardlink or copy, for "filesync snapshot" | ||
| 311 | --config FILE the client configuration file to write | ||
| 312 | |||
| 313 | Exit codes: 0 ok, 1 fatal. | ||
| 314 | USAGE | ||
| 315 | 'cli.help.admin' => <<'USAGE', | ||
| 316 | filesync-admin --root DIR <command> | ||
| 317 | |||
| 318 | repo create NAME [--trash-days N] [--max-deletes N] [--max-delete-percent N] | ||
| 319 | [--ignore PATTERN]... | ||
| 320 | repo list | ||
| 321 | repo show NAME | ||
| 322 | client allow ID --repo NAME [--role client|replica] | ||
| 323 | client list --repo NAME | ||
| 324 | client forget ID --repo NAME | ||
| 325 | reindex NAME [--dry-run] [--json] | ||
| 326 | verify NAME [--deep] [--sample N] [--json] | ||
| 327 | restore NAME PATH [--to DIR] [--list] [--date YYYY-MM-DD] | ||
| 328 | log NAME... [-n N] [--client ID] [--since YYYY-MM-DD|EPOCH] | ||
| 329 | [--until YYYY-MM-DD|EPOCH] [--exit N]... [--warnings] [--json] | ||
| 330 | |||
| 331 | Exit codes: 0 ok, 1 fatal, 4 verification found drift. | ||
| 332 | USAGE | ||
| 333 | |||
| 334 | 'cli.unknown_command' => q{Unknown command '%{command}s' (try: %{program}s help)}, | ||
| 335 | 'cli.usage' => 'Usage: %{usage}s', | ||
| 336 | 'cli.unexpected' => '%{command}s: unexpected arguments: %{args}s', | ||
| 337 | 'cli.required' => '%{command}s: %{what}s is required', | ||
| 338 | 'cli.positive' => '%{command}s: %{option}s must be positive', | ||
| 339 | 'cli.exit_range' => 'log: --exit must be between 0 and %{max}d', | ||
| 340 | 'cli.no_repos' => 'No repos configured; run filesync init first', | ||
| 341 | 'cli.no_repo' => q{No repo '%{repo}s' in the configuration}, | ||
| 342 | 'cli.need_repo' => '%{command}s: --repo is required when several repos are configured', | ||
| 343 | 'cli.unknown_snapshot' => q{Unknown snapshot command '%{verb}s' (try: filesync help)}, | ||
| 344 | 'cli.repo_error' => '%{repo}s: %{error}s', | ||
| 345 | 'cli.warning' => ' warning: %{warning}s', | ||
| 346 | 'cli.never' => 'never', | ||
| 347 | 'cli.version' => 'filesync %{version}s (protocol %{proto}d)', | ||
| 348 | |||
| 349 | 'cli.usage.server' => 'filesync-server [--root DIR] --repo NAME --client ID --role client|replica [--proto 2]', | ||
| 350 | 'cli.usage.init' => 'filesync init --repo NAME --root DIR ...', | ||
| 351 | 'cli.usage.sync' => 'filesync sync [--repo NAME] [--dry-run] [--force]', | ||
| 352 | 'cli.usage.status' => 'filesync status [--repo NAME] [--json]', | ||
| 353 | 'cli.usage.log' => 'filesync log [--repo NAME] [-n N] [--since DATE] [--until DATE] [--exit N] [--warnings] [--json]', | ||
| 354 | 'cli.usage.settings' => 'filesync settings [--config FILE] [--json]', | ||
| 355 | 'cli.usage.verify' => 'filesync verify [--repo NAME] [--deep] [--json]', | ||
| 356 | 'cli.usage.restore' => 'filesync restore PATH [--repo NAME] [--to DIR] [--list]', | ||
| 357 | 'cli.usage.snapshot' => 'filesync snapshot [--repo NAME] [--keep N]', | ||
| 358 | 'cli.usage.snapshot_list' => 'filesync snapshot list [--repo NAME]', | ||
| 359 | 'cli.usage.snapshot_restore' => 'filesync snapshot restore DATE [PATH] [--repo NAME] [--to DIR]', | ||
| 360 | 'cli.usage.repo_create' => 'filesync-admin repo create NAME [--trash-days N] ...', | ||
| 361 | 'cli.usage.admin_log' => 'filesync-admin log NAME... [-n N] [--client ID] [--since DATE] [--until DATE] [--exit N] [--warnings] [--json]', | ||
| 362 | 'cli.usage.reindex' => 'filesync-admin reindex NAME [--dry-run] [--json]', | ||
| 363 | 'cli.usage.admin_verify' => 'filesync-admin verify NAME [--deep] [--sample N] [--json]', | ||
| 364 | 'cli.usage.admin_restore' => 'filesync-admin restore NAME PATH [--to DIR] [--list] [--date YYYY-MM-DD]', | ||
| 365 | 'cli.usage.client_allow' => 'filesync-admin client allow ID --repo NAME [--role R]', | ||
| 366 | 'cli.usage.client_list' => 'filesync-admin client list --repo NAME', | ||
| 367 | 'cli.usage.client_forget' => 'filesync-admin client forget ID --repo NAME', | ||
| 368 | |||
| 369 | 'cli.server.bad_role' => q{filesync-server: bad role '%{role}s'}, | ||
| 370 | 'cli.server.proto' => q{filesync-server: unsupported protocol '%{proto}s'}, | ||
| 371 | 'cli.server.forced' => 'filesync-server: %{reason}s', | ||
| 372 | 'cli.server.tty' => 'filesync-server speaks the sync protocol on stdin and is not for interactive use; it is the forced command in authorized_keys', | ||
| 373 | |||
| 374 | 'cli.init.bad_id' => 'init: %{reason}s', | ||
| 375 | 'cli.init.bad_role' => q{init: bad role '%{role}s'}, | ||
| 376 | 'cli.init.bad_mode' => q{init: bad snapshot mode '%{mode}s' (want hardlink or copy)}, | ||
| 377 | 'cli.init.bad_transport' => q{init: unknown transport '%{transport}s'}, | ||
| 378 | 'cli.init.need_server_root' => 'init: the local transport needs --server-root', | ||
| 379 | 'cli.init.need_server' => 'init: the ssh transport needs --server', | ||
| 380 | 'cli.init.bad_server' => q{init: bad server '%{server}s' (want user@host or host)}, | ||
| 381 | 'cli.init.no_known_hosts' => 'init: --known-hosts does not exist: %{path}s', | ||
| 382 | 'cli.init.accept_ssh_only' => 'init: --accept-host-key only applies to the ssh transport', | ||
| 383 | 'cli.init.bad_root' => 'init: cannot use %{root}s as a sync root', | ||
| 384 | 'cli.init.done' => q{Initialised repo '%{repo}s'}, | ||
| 385 | 'cli.init.client_id' => ' client id: %{id}s', | ||
| 386 | 'cli.init.root' => ' root: %{root}s', | ||
| 387 | 'cli.init.transport' => ' transport: %{transport}s', | ||
| 388 | 'cli.init.server' => ' server: %{server}s', | ||
| 389 | 'cli.init.host_key_tofu' => ' host key: accept-new (trusted on first use)', | ||
| 390 | 'cli.init.host_key_strict' => ' host key: strict', | ||
| 391 | 'cli.init.config' => ' config: %{path}s', | ||
| 392 | |||
| 393 | 'cli.sync.would' => ' would %{verb}s %{path}s', | ||
| 394 | 'cli.sync.summary' => '%{repo}s%{dry}s: pulled %{pulled}d, pushed %{pushed}d, deleted %{deleted}d, conflicts %{conflicts}d', | ||
| 395 | 'cli.sync.dry_tag' => ' (dry run)', | ||
| 396 | 'cli.sync.transfer' => ' transfer: %{report}s', | ||
| 397 | |||
| 398 | 'cli.transfer.report' => 'sent %{sent}s, received %{received}s, %{files}s by delta%{detail}s', | ||
| 399 | 'cli.transfer.pulled' => '%{count}d pulled', | ||
| 400 | 'cli.transfer.pushed' => '%{count}d pushed', | ||
| 401 | 'cli.size.bytes' => '%{value}d B', | ||
| 402 | 'cli.size.scaled' => '%{value}.1f %{unit}s', | ||
| 403 | 'cli.size.exact' => '%{value}s B', | ||
| 404 | |||
| 405 | 'cli.status.repo' => '%{repo}s: %{root}s', | ||
| 406 | 'cli.status.transport' => ' transport: %{transport}s', | ||
| 407 | 'cli.status.last_run' => ' last run: %{last_run}s', | ||
| 408 | 'cli.status.transfer' => ' transfer: %{report}s', | ||
| 409 | 'cli.status.files' => ' files: %{files}d', | ||
| 410 | |||
| 411 | 'cli.log.none' => '%{repo}s: no runs recorded', | ||
| 412 | 'cli.log.error' => '%{repo}s %{ts}s exit %{exit}d %{message}s', | ||
| 413 | 'cli.log.run' => '%{repo}s %{ts}s exit %{exit}d pulled %{pulled}d, pushed %{pushed}d, deleted %{deleted}d, conflicts %{conflicts}d%{skipped}s%{transfer}s%{dry}s', | ||
| 414 | 'cli.log.skipped' => ', skipped %{count}d', | ||
| 415 | 'cli.log.dry_tag' => ' (dry run)', | ||
| 416 | 'cli.log.heading' => '%{repo}s:', | ||
| 417 | 'cli.log.no_events' => 'No journal entries for %{repo}s', | ||
| 418 | 'cli.log.event' => '%{indent}s%{ts}s %{client}-12s %{action}-12s %{detail}s', | ||
| 419 | |||
| 420 | 'cli.settings.file' => 'settings file: %{file}s', | ||
| 421 | 'cli.settings.no_file' => '(none)', | ||
| 422 | 'cli.settings.row' => ' %{key}-16s %{value}-40s %{source}s', | ||
| 423 | 'cli.settings.note' => "An empty ssh_identity or ssh_known_hosts means ssh's own default; an empty server_command means filesync-server.\nIn the repo sections, [repo only] marks port and host_key_checking, which have no process-wide default.", | ||
| 424 | 'cli.settings.repos' => 'repos:', | ||
| 425 | 'cli.settings.repo' => ' %{repo}s (%{transport}s%{server}s)', | ||
| 426 | 'cli.settings.local' => ' the local transport does not use the SSH settings', | ||
| 427 | 'cli.settings.repo_row' => ' %{key}-18s %{value}-38s %{source}s', | ||
| 428 | 'cli.settings.stderr' => '(stderr)', | ||
| 429 | 'cli.settings.ssh_default' => '(ssh default)', | ||
| 430 | 'cli.settings.server_default' => 'filesync-server', | ||
| 431 | 'cli.source.default' => '%{label}s', | ||
| 432 | 'cli.source.merged' => 'merged: %{label}s', | ||
| 433 | 'cli.source.env' => 'environment %{label}s', | ||
| 434 | 'cli.source.file' => 'file %{label}s', | ||
| 435 | 'cli.repo_source.repo' => 'repo (%{label}s)', | ||
| 436 | 'cli.repo_source.process' => 'process (%{label}s)', | ||
| 437 | 'cli.repo_source.default' => '%{label}s', | ||
| 438 | 'cli.source.repo_only' => '%{description}s [repo only]', | ||
| 439 | |||
| 440 | 'cli.verify.summary' => '%{repo}s: %{state}s (%{files}s, %{rehashed}d rehashed, %{trusted}d unchanged)', | ||
| 441 | 'cli.verify.clean' => 'clean', | ||
| 442 | 'cli.verify.drift' => 'drift detected', | ||
| 443 | 'cli.verify.no_base' => ' no cached base for this repo (it has not synced yet)', | ||
| 444 | 'cli.verify.modified' => ' modified: %{path}s%{reason}s', | ||
| 445 | 'cli.verify.missing' => ' missing: %{path}s', | ||
| 446 | 'cli.verify.extra' => ' extra: %{path}s', | ||
| 447 | |||
| 448 | 'cli.restore.no_versions' => q{No trashed versions of '%{path}s'}, | ||
| 449 | 'cli.restore.no_versions_in' => q{No trashed versions of '%{path}s' in %{repo}s}, | ||
| 450 | 'cli.restore.version' => '%{date}-12s %{size}10s %{mtime}s %{path}s', | ||
| 451 | 'cli.restore.done' => 'Restored %{path}s to %{to}s', | ||
| 452 | 'cli.restore.admin_done' => 'Restored %{repo}s:%{path}s from %{from}s to %{to}s', | ||
| 453 | 'cli.restore.the_trash' => 'the trash', | ||
| 454 | |||
| 455 | 'cli.snapshot.exists' => '%{repo}s: snapshot %{date}s already exists; left as it was', | ||
| 456 | 'cli.snapshot.taken' => '%{repo}s: snapshot %{date}s taken (%{files}s, %{size}s) in %{path}s', | ||
| 457 | 'cli.snapshot.pruned' => { | ||
| 458 | _by => 'count', | ||
| 459 | one => '%{repo}s: pruned %{count}d old snapshot (kept %{kept}d): %{dates}s', | ||
| 460 | other => '%{repo}s: pruned %{count}d old snapshots (kept %{kept}d): %{dates}s', | ||
| 461 | }, | ||
| 462 | 'cli.snapshot.none' => 'No snapshots for %{repo}s', | ||
| 463 | 'cli.snapshot.header' => '%{date}-12s %{files}8s %{size}10s %{path}s', | ||
| 464 | 'cli.snapshot.column.date' => 'DATE', | ||
| 465 | 'cli.snapshot.column.files' => 'FILES', | ||
| 466 | 'cli.snapshot.column.size' => 'SIZE', | ||
| 467 | 'cli.snapshot.column.path' => 'PATH', | ||
| 468 | 'cli.snapshot.row' => '%{date}-12s %{files}8d %{size}10s %{path}s', | ||
| 469 | 'cli.snapshot.restored' => '%{repo}s: restored %{what}s from snapshot %{date}s (%{files}s, %{size}s) to %{to}s', | ||
| 470 | 'cli.snapshot.whole_tree' => 'the whole tree', | ||
| 471 | 'cli.snapshot.into_root' => 'note: a replica mirrors the master again on the next sync; use --to DIR to keep an exported copy', | ||
| 472 | |||
| 473 | 'cli.admin.root_value' => 'filesync-admin: --root needs a value', | ||
| 474 | 'cli.admin.unknown_verb' => q{Unknown %{group}s command '%{verb}s'}, | ||
| 475 | 'cli.admin.empty_name' => 'log: NAME must not be empty', | ||
| 476 | |||
| 477 | 'cli.repo.created.name' => q{Created repo '%{repo}s'}, | ||
| 478 | 'cli.repo.created.master' => ' master: %{master}s', | ||
| 479 | 'cli.repo.created.config' => ' config: %{config}s', | ||
| 480 | 'cli.repo.none' => 'No repos under %{root}s', | ||
| 481 | 'cli.repo.no_clients' => '(none)', | ||
| 482 | 'cli.repo.show' => "name: %{name}s\nmaster: %{master}s\nmeta: %{meta}s\ntrash: %{trash_days}s days\nlimits: %{max_deletes}s files / %{max_delete_percent}s%%\nclients: %{clients}s", | ||
| 483 | |||
| 484 | 'cli.reindex.would' => '%{repo}s: would index %{files}s, %{dirs}s (%{size}s); index unchanged', | ||
| 485 | 'cli.reindex.done' => '%{repo}s: indexed %{files}s, %{dirs}s (%{size}s); master index written', | ||
| 486 | 'cli.reindex.skipped' => ' skipped: %{path}s (%{reason}s)', | ||
| 487 | |||
| 488 | 'cli.client.allowed' => 'Allowed %{client}s on %{repo}s as %{role}s', | ||
| 489 | 'cli.client.none' => 'No clients registered for %{repo}s', | ||
| 490 | 'cli.client.row' => '%{client}-24s %{role}-8s %{state}s', | ||
| 491 | 'cli.client.synced' => 'has synced', | ||
| 492 | 'cli.client.never' => 'never synced', | ||
| 493 | 'cli.client.forgot' => 'Forgot %{client}s (removed %{path}s)', | ||
| 494 | 'cli.client.nothing' => 'No stored state for %{client}s', | ||
| 495 | |||
| 496 | 'settings.bad_level' => q{Invalid log_level '%{level}s' (want %{valid}s)}, | ||
| 497 | |||
| 498 | 'snapshot.no_root' => 'Snapshot: no sync root given', | ||
| 499 | 'snapshot.not_dir' => 'Snapshot: %{path}s is not a directory', | ||
| 500 | 'snapshot.bad_date' => q{Snapshot: bad date '%{date}s' (want YYYY-MM-DD)}, | ||
| 501 | 'snapshot.bad_mode' => q{Snapshot: bad mode '%{mode}s' (want hardlink or copy)}, | ||
| 502 | 'snapshot.read' => 'Snapshot: cannot read %{path}s: %{error}s', | ||
| 503 | 'snapshot.failed' => 'Snapshot: cannot create %{path}s: %{error}s', | ||
| 504 | 'snapshot.remove' => 'Snapshot: cannot remove %{path}s (%{error}s)', | ||
| 505 | 'snapshot.need_date' => 'Snapshot: --date is required', | ||
| 506 | 'snapshot.none' => 'Snapshot: no snapshot for %{date}s under %{path}s', | ||
| 507 | 'snapshot.need_to' => 'Snapshot: no destination given', | ||
| 508 | 'snapshot.to_not_dir' => 'Snapshot: destination %{path}s is not a directory', | ||
| 509 | 'snapshot.unsafe' => q{Unsafe snapshot path '%{path}s': %{reason}s}, | ||
| 510 | 'snapshot.no_path' => q{Snapshot %{date}s has no path '%{path}s'}, | ||
| 511 | 'snapshot.cannot_stat' => 'Snapshot: cannot stat %{path}s: %{error}s', | ||
| 512 | 'snapshot.not_regular' => 'Snapshot: %{path}s is not a regular file', | ||
| 513 | 'snapshot.replace' => 'Snapshot: cannot replace %{path}s', | ||
| 514 | ); | ||
| 515 | |||
| 516 | 342 | 1; | |
| 517 | |||
| 518 | __END__ | ||