Short:        Reliable file copy VERIFY/UPDATE/BUFFER
Author:       Nowee@beamreactor.com
Uploader:     Nowee beamreactor com
Type:         util/cli
Version:      1.4
Replaces:     SaferCopy1.2.lha
Requires:     AmigaOS 2.04+ (V37), 68000+
Architecture: m68k-amigaos >= 2.0.4

SaferCopy 1.4 - A reliable replacement for AmigaDOS Copy 47.7

BACKGROUND

Copy 47.7 shipped with AmigaOS 3.2.3 silently ignores the VERIFY, DATES
and BUF/BUFFER keywords documented in the AmigaDOS 3.2.3 manual.
Hence this version.

FEATURES:
- Lets you copy only the missing, uncomplete or older files with the
  "update" option.
- Partial write detection: checks Write() return value on every call.
  Silently truncated files are caught, logged, and the destination is
  replaced.
- Locale : fully localised via locale.library. Machine translated
  catalogs are included for 18 languages. Reverts to English if
  locale.library is absent or no catalog is found.
- Path handling: destination directories are created recursively
  (equivalent of mkdir -p).
- Error buffering, errors gets printed both immediately AND are
  summarised at the end. No need to watch the terminal for ages.

TESTED (MD5, etc) on Amiga 4000, 3000T, WinUAE, over a tremendous amount
of files. And again.

It works for me, but I can't garantee it won't burn down your house to
the ground so please make a copy of it first... Uhh wait.. :D
It comes with no garantee whatsoever.

It's been fixed with the help of Claude Opus 4.8

USAGE:
*** Please use stack 32768 ***

BUF/BUFFER : actually uses the specified buffer size (default 512KB).
DATES : actually calls SetFileDate() when specified alone, without
requiring CLONE.
VERIFY : actually re-reads the destination after every write and
compares byte-for-byte with the source. Corrupted files are replaced
immediately.
UPDATE : skips files where destination exists with identical size and
datestamp. Re-copies if destination is smaller (previous interrupted
copy) or older than source. Reports "[dest incomplete: X/Y bytes]" for
visibility.
NDATE : with UPDATE, compare size only (ignore datestamp). Useful when
a previous backup was done without DATES/CLONE and destination files
have the wrong date.
VERBOSE : shows skipped (up-to-date) files. By default only active
copies and errors are displayed.
MAXERR/K/N : abort after N errors. Useful for unattended large copies
over unreliable media. Default 0 = no limit.
FORCE : strips write-protection from destination before copying.
CHECK : audit mode - no files are copied. For each source file,
compares size against destination and reports Missing or SizeDiff.
Combine with NDATE for a fast size-only scan. Useful before a resume
to see what actually needs attention.

Example: SaferCopy FROM Work: TO Backup: ALL CHECK NDATE

TEMPLATE
FROM/M,TO/A,ALL/S,QUIET/S,BUF=BUFFER/K/N,CLONE/S,DATES/S,
NOPRO/S,VERIFY/S,NOREQ/S,UPDATE/S,FORCE/S,MAXERR/K/N,NDATE/S,VERBOSE/S,
CHECK/S

Type "SaferCopy ?" for an interactive argument prompt.

EXAMPLES

Full backup with verification, preserve dates, 1MB buffer
SaferCopy FROM Work: TO DH1:Backup/ ALL CLONE VERIFY BUF=1048576 NOREQ

Incremental update, abort after 50 errors
SaferCopy FROM Work: TO DH1:Backup/ ALL UPDATE VERIFY BUF=1048576 MAXERR=50

USB to HD, big buffer
SaferCopy FROM USB0:data/ TO DH1:data/ ALL CLONE VERIFY BUF=2097152 NOREQ

Catch up after a backup done without DATES (ignore datestamp differences)
SaferCopy FROM sys: TO Multimedia:SYSBACKUP/ ALL UPDATE NDATE CLONE
  VERIFY NOREQ

LANGUAGES

The catalogs are LLM translated. Please report in case of impediments...

Catalogs are included for: english, francais, deutsch, espanol,
nederlands, dansk, norsk, polski, czech, slovensko, portugues, catala,
euskara, turkce, srpski, russian, greek, roman.

Install: copy catalogs/$LANGUAGE/SaferCopy.catalog to
LOCALE:Catalogs/$LANGUAGE/SaferCopy.catalog

COMPILATION

GCC : m68k-amigaos-gcc -O2 -m68000 -noixemul -resident -Wall -o SaferCopy
SaferCopy.c

SASC: sc SaferCopy.c LINK RESIDENT MATH=SOFT NOSTKCHK OPT IDIR=Include:
IDIR=NDK3.2:Include

The -resident / RESIDENT options produce a pure (re-entrant) binary that
can be made resident with the Shell RESIDENT command.

SOURCES

Available on GitHub, https://github.com/Nowomeister/safercopy/

TODO:
Test on OS 2.04, 3.0, 3.1.

HISTORY

1.4 - Fixed a stack smash in the error logger: error messages for paths
      longer than ~350 characters overflowed a fixed 384-byte buffer
      (NOSTKCHK + no MMU = silent corruption, delayed lockup on long
      unattended copies). Error formatting is now bounded and uses
      static buffers (less stack at maximum recursion depth). The
      AnchorPath is now zeroed between the two MatchFirst passes as
      required by the dos.library autodoc (stale AChain state could
      leak memory progressively). NOREQ no longer leaves the Shell
      process with requesters permanently disabled after exit
      (pr_WindowPtr is restored even when the original value was NULL).
      Binaries are now pure/residentable (GCC -resident, SAS/C RESIDENT
      + cres.o).

1.3 - Fixed lockup on directory names containing AmigaDOS pattern
      special characters (& ~ # ? ( ) [ ] | %). Added CHECK/S audit
      mode (size comparison, no copy).

1.2 - Added locale catalog support (18 languages), $VER string,
      minimum OS version check (V37 / AmigaOS 2.04+).

1.1 - Added NDATE, VERBOSE, recursive mkdir, fixed sys: path handling,
      fixed Shell window not closing after exit.

1.0 - Initial release.