Overview of CyCopy

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

Overview of CyCopy

CyCopy is the out-of-process copy and move worker for Blueprint. CyFiler starts it for transfers that would otherwise stall the file manager's own event loop.

Open this book from Help Books as "CyCopy", or:

cyhelp --book CyCopy --topic overview

The Applications page lists it as: Copy and move.

What It Does

cycopy copies or moves SOURCE paths into an existing DEST directory. The command line follows the usual shape: options first, sources next, destination last. Copy is the default; --move selects move (rename on the same device, otherwise copy then remove).

Progress uses phased CyProgress thermometers: metadata first, then operation percent and data percent, with Pause and Cancel. Jobs whose total regular-file size is under 5 MiB suppress the GUI even when DISPLAY is set.

Directory sources require --recursive. Without it, directories are omitted rather than silently descended. CyFiler always passes --recursive.

What It Is Not

• Not a replacement for cp(1) / mv(1) on a headless box (use those when you do not want a progress window)
• Not a sync or mirror tool (no delete-extraneous, no rsync model)
• Not an archive / compress utility
• Not something that creates DEST; the destination directory must exist

In This Book

• Using CyCopy -- when CyFiler calls it, conflicts, cancel
• Command Line -- modes, lists, conflict policy, throttle
• Copyright