gcp(1) [debian man page]
GCP(1) General Commands Manual GCP(1) NAME
gcp - Advanced command-line file copier SYNOPSIS
gcp [OPTIONS] FILE DEST gcp [OPTIONS] FILE1 [FILE2...] DEST-DIR DESCRIPTION
This manual page documents briefly the gcp command. gcp 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) OPTIONS
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. General options --version Show version of program and exit. -h, --help Show summary of options. -r, --recursive Copy directories recursively. -L, --dereference always follow symbolic links in sources -P, --no-dereference never follow symbolic links in sources -f, --force Overwrite existing files. --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. --no-fs-fix Don't fix file system naming incompatibilities. --no-progress Disable progress bar. -v, --verbose Display what is being done. Sources saving --sources-save=SOURCES_SAVE Save the list of source files in a list named SOURCES_SAVE. --sources-replace=SOURCES_REPLACE Save the list of source files in a list named SOURCES_REPLACE and replace it if it already exists. --sources-load=SOURCES_LOAD Reuse the list of source file named SOURCES_LOAD. --sources-del=SOURCES_DEL Delete the list of source files named SOURCES_DEL. --sources-list List the names of source file lists. --sources-full-list List the names of source file lists, including their content. EXIT STATUS
The exit status can be: o 0 if files have been copied correctly or if another instance of gcp is already running and will do the copy. o 1 if at least one file has not been copied, or if something went wrong. o 2 if all files have been copied but with some issues LIMITS
Timestamps preservation with --preserve option is limited by the os python module on POSIX systems. Currently, python only returns time- stamps 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. SEE ALSO
cp(1). AUTHOR
gcp was written by Jerome Poisson <goffi@goffi.org>. This manual page was written by Thomas Preud'homme <robotux@celest.fr>, for the Debian project (and may be used by others). June 04, 2011 GCP(1)
Check Out this Related Man Page
CP(1) FSF CP(1) NAME
cp - copy files and directories SYNOPSIS
cp [OPTION]... SOURCE DEST cp [OPTION]... SOURCE... DIRECTORY cp [OPTION]... --target-directory=DIRECTORY SOURCE... DESCRIPTION
Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY. Mandatory arguments to long options are mandatory for short options too. -a, --archive same as -dpR --backup[=CONTROL] make a backup of each existing destination file -b like --backup but does not accept an argument --copy-contents copy contents of special files when recursive -d same as --no-dereference --preserve=link --no-dereference never follow symbolic links -f, --force if an existing destination file cannot be opened, remove it and try again -i, --interactive prompt before overwrite -H follow command-line symbolic links -l, --link link files instead of copying -L, --dereference always follow symbolic links -p same as --preserve=mode,ownership,timestamps --preserve[=ATTR_LIST] preserve the specified attributes (default: mode,ownership,timestamps), if possible additional attributes: links, all --no-preserve=ATTR_LIST don't preserve the specified attributes --parents append source path to DIRECTORY -P same as `--no-dereference' -R, -r, --recursive copy directories recursively --remove-destination remove each existing destination file before attempting to open it (contrast with --force) --reply={yes,no,query} specify how to handle the prompt about an existing destination file --sparse=WHEN control creation of sparse files --strip-trailing-slashes remove any trailing slashes from each SOURCE argument -s, --symbolic-link make symbolic links instead of copying -S, --suffix=SUFFIX override the usual backup suffix --target-directory=DIRECTORY move all SOURCE arguments into DIRECTORY -u, --update copy only when the SOURCE file is newer than the destination file or when the destination file is missing -v, --verbose explain what is being done -x, --one-file-system stay on this file system --help display this help and exit --version output version information and exit By default, sparse SOURCE files are detected by a crude heuristic and the corresponding DEST file is made sparse as well. That is the behavior selected by --sparse=auto. Specify --sparse=always to create a sparse DEST file whenever the SOURCE file contains a long enough sequence of zero bytes. Use --sparse=never to inhibit creation of sparse files. The backup suffix is `~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX. The version control method may be selected via the --backup option or through the VERSION_CONTROL environment variable. Here are the values: none, off never make backups (even if --backup is given) numbered, t make numbered backups existing, nil numbered if numbered backups exist, simple otherwise simple, never always make simple backups As a special case, cp makes a backup of SOURCE when the force and backup options are given and SOURCE and DEST are the same name for an existing, regular file. AUTHOR
Written by Torbjorn Granlund, David MacKenzie, and Jim Meyering. REPORTING BUGS
Report bugs to <bug-coreutils@gnu.org>. COPYRIGHT
Copyright (C) 2002 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICU- LAR PURPOSE. SEE ALSO
The full documentation for cp is maintained as a Texinfo manual. If the info and cp programs are properly installed at your site, the com- mand info cp should give you access to the complete manual. cp (coreutils) 4.5.3 February 2003 CP(1)