changeset 42:671d8c70a84c

author Thomas Preud'homme <>
date Sat, 04 Jun 2011 19:44:36 +0200
parents b54e5a4102da
children 2e3add4b4f19
files gcp.1
diffstat 1 files changed, 111 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/gcp.1	Sat Jun 04 19:44:36 2011 +0200
@@ -0,0 +1,111 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH GCP 1 "November 22, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+gcp \- Advanced command-line file copier
+.B gcp
+.B gcp
+.RI [ FILE2 ... ]
+This manual page documents briefly the
+.B gcp
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+\fBgcp\fP is a file copier, loosely inspired by cp, but with high level functionalities like:
+ \- transfer progression indication
+ \- continuous copying when there is an issue: it skips the problematic file and goes on
+ \- copy status logging: which files were effectively copied
+ \- name mangling to handle target filesystem limitations (e.g. removing incompatible chars like "?" or "*" on vfat)
+ \- forced copy serialization: new files to copy are added to a global queue to avoid hard drive head seeks
+ \- transfer list management: gcp can save a list of files to copy and reuse it later
+ \- approximate option compatibility with cp (approximate because the behaviour is not exactly the same, see below)
+These programs follow the usual GNU command line syntax, with long
+options starting with two dashes (`-').
+By default, calling gcp is equivalent to calling gcp \-\-preserve=mode,ownership,timestamps.
+A summary of options is included below.
+.SS "General options"
+.B \-\-version
+Show version of program and exit.
+.B \-h, \-\-help
+Show summary of options.
+.B \-r, \-\-recursive
+Copy directories recursively.
+.B \-f, \-\-force
+Overwrite existing files.
+.B \-\-preserve=PRESERVE
+Keep specified attributes. Attributes can be mode, ownership and timestamps.
+When several attributes are passed, they need to be separated by commas. Note
+that timestamps preservation has some limits, see section LIMITS.
+.B \-\-no\-fs\-fix
+Don't fix file system naming incompatibilities.
+.B \-\-no\-progress
+Disable progress bar.
+.B \-v, \-\-verbose
+Display what is being done.
+.SS "Sources saving"
+.B \-\-sources\-save=SOURCES_SAVE
+Save the list of source files in a list named SOURCES_SAVE.
+.B \-\-sources\-replace=SOURCES_REPLACE
+Save the list of source files in a list named SOURCES_REPLACE and
+replace it if it already exists.
+.B \-\-sources\-load=SOURCES_LOAD
+Reuse the list of source file named SOURCES_LOAD.
+.B \-\-sources\-del=SOURCES_DEL
+Delete the list of source files named SOURCES_DEL.
+.B \-\-sources\-list
+List the names of source file lists.
+.B \-\-sources\-full\-list
+List the names of source file lists, including their content.
+Timestamps preservation with \-\-preserve option is limited by the os python
+module on POSIX systems. Currently, python only returns timestamps in float
+format, which is a smaller precision than what POSIX provides. Progress on this
+issue can be seen at
+.BR cp (1).
+gcp was written by Jérôme Poisson <>.
+This manual page was written by Thomas Preud'homme <>,
+for the Debian project (and may be used by others).