Command Line

Documentation / CyCopy

• Overview of CyCopy
  • What It Does
  • What It Is Not
• Using CyCopy
  • When The Window Appears
  • Conflicts
  • Lists Of Sources
  • Owner And Speed Caps
  • Exit Status
• Command Line
  • Mode
  • Sources From A List
  • Conflicts And Ownership
  • Progress Window
  • Exit Status
• Copyright

Command Line

cycopy copies or moves SOURCE paths into DEST (an existing directory). Options first, sources next, destination last -- same shape as cp/mv.

cycopy [options] SOURCE... DEST
cycopy [options] --from-list=FILE DEST
cycopy --move [options] SOURCE... DEST

Mode

• (default) / -c, --copy -- copy
• -m, --move -- move (rename; copy+remove across devices)
• -r, -R, --recursive -- recurse into directory sources
• -h, --help / -V, --version -- usage or version string
• --selftest -- headless checks

Without --recursive, directory sources are omitted. CyFiler always passes --recursive.

Sources From A List

• -f, --from-list=FILE -- sources from FILE (- = stdin); DEST still last
• -0, --null -- NUL-separated list paths

cycopy --from-list=/tmp/list /tmp/out
cycopy -0 --from-list=- /tmp/out < paths.null

Conflicts And Ownership

• --on-conflict=POL -- rename (default), overwrite, skip, or ask
• --preserve-owner -- chown when privileged (default off)

ask uses a GUI CyNotice. --quiet rejects ask.

Progress Window

• -q, --quiet, --no-gui -- no progress window
• -v, --verbose -- headless progress on stderr
• --title=TEXT -- window title override
• --throttle=RATE -- cap copy speed for testing (500K, 2M, 100, ...)

RATE units: K/KB = KiB/s, M/MB = MiB/s; a bare number is KiB/s. Tiny jobs (bytes_total under 5 MiB) suppress the GUI automatically.

Exit Status

• 0 -- ok
• 1 -- cancel
• 2 -- usage or preflight
• 3 -- partial failure

Examples

cycopy file.txt /tmp/out
cycopy -r dir1 dir2 /tmp/out
cycopy --move a.txt b.txt /tmp/out
cycopy --from-list=/tmp/list /tmp/out
cycopy --throttle=512K big.bin /tmp/out
cycopy --on-conflict=skip -r tree /backup/tree

See Also

• Using CyCopy
• Overview of CyCopy