gcp has the ability to modify the destination file name if the target file
system would not accept the original file name.
Offending characters will be replaced with similar-looking ones.
.IP
This option accept the following values:
.RS
.TP
\fIauto\fP (default)
gcp will attempt to be smart, i.e. detect incompatibilities and fix them as-needed.
.TP
\fIforce\fP
Always fix file names that could cause problems on any known filesystem or OS.
This is useful e.g. with NTFS, see \fINOTE ON NTFS\fP below.
.TP
\fIno\fP
Renaming is disabled entirely.
.RE
.IP
Currently, gcp is only aware of FAT incompatibilities:
\'\\\', \':\', \'*\', \'?\', \'"\', \'<\', \'>\' and \'|\'.
.TP
.B\-\-no\-fs\-fix(DEPRECATED)
Same as \fB\-\-fix\-filenames=no\fP.
This option will be removed in a future release.
.TP
.B\-\-no\-progress
Disable progress bar.
.SSSourcessaving
.TP
.B\-\-sources\-save=SOURCES_SAVE
Save the list of source files in a list named SOURCES_SAVE.
.B\-\-sources\-save=\fISOURCES\fP
Save the list of source files in a list named \fISOURCES\fP.
.TP
.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\-replace=\fISOURCES\fP
Save the list of source files in a list named \fISOURCES\fP;
the file is overwritten it already exists.
.TP
.B\-\-sources\-load=SOURCES_LOAD
Reuse the list of source file named SOURCES_LOAD.
.B\-\-sources\-load=\fISOURCES\fP
Use the list of source files named \fISOURCES\fP.
.TP
.B\-\-sources\-del=SOURCES_DEL
Delete the list of source files named SOURCES_DEL.
.B\-\-sources\-del=\fISOURCES\fP
Delete the list of source files named \fISOURCES\fP.
.TP
.B\-\-sources\-list
List the names of source file lists.
@ -108,21 +143,33 @@ List the names of source file lists, including their content.
@@ -108,21 +143,33 @@ List the names of source file lists, including their content.
.SHEXITSTATUS
The exit status can be:
.IP\[bu]2
\fB0\fP if files have been copied correctly or if another instance of gcp is already running and will do the copy.
\fB0\fP if files have been copied correctly or if another instance of gcp is
already running and will do the copy.
.IP\[bu]
\fB1\fP if at least one file has not been copied, or if something went wrong.
.IP\[bu]
\fB2\fP if all files have been copied but with some issues
.SHLIMITATIONS
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 http://bugs.python.org/issue11457.
Timestamps preservation with \fB\-\-preserve\fP option is limited by the
\fIos\fP 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
http://bugs.python.org/issue11457.
.PP
The \fB\-\-preserve\fP option cannot currently be used without an attribute
list (\fBgcp \-\-preserve foo bar\fP will behave as \fBgcp \-\-preserve=foo
bar\fP). Use the \fB\-p\fP switch instead.
.SHNOTEONNTFS
NTFS will not enforce the same file name limitations than FAT, but files that
would not be accepted on a FAT filesystem will still cause problems on Windows.
Hence, it is recommended to use \-\-fix-filenames=force when copying to NTFS
(when Windows compatibility is desired, anyway).
.SHSEEALSO
.BRcp(1).
.br
.SHAUTHOR
gcp was written by Jérôme Poisson <goffi@goffi.org>.
It is currently maintained by Matteo Cypriani <mcy@lm7.fr>.
.PP
This manual page was written by Thomas Preud'homme <robotux@celest.fr>,
for the Debian project (and may be used by others).
This manual page was initially written by Thomas Preud'homme
<robotux@celest.fr> for the Debian project (and may be used by others).