.TH g.copy 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBg.copy\fR\fR  - Copies available data files in the user's current mapset search path and location to the appropriate element directories under the user's current mapset.
.SH KEYWORDS
general, map management
.SH SYNOPSIS
\fBg.copy\fR
.br
\fBg.copy help\fR
.br
\fBg.copy\fR  [\fBrast\fR=\fIfrom,to\fR]   [\fBrast3d\fR=\fIfrom,to\fR]   [\fBvect\fR=\fIfrom,to\fR]   [\fBoldvect\fR=\fIfrom,to\fR]   [\fBasciivect\fR=\fIfrom,to\fR]   [\fBicon\fR=\fIfrom,to\fR]   [\fBlabels\fR=\fIfrom,to\fR]   [\fBsites\fR=\fIfrom,to\fR]   [\fBregion\fR=\fIfrom,to\fR]   [\fBregion3d\fR=\fIfrom,to\fR]   [\fBgroup\fR=\fIfrom,to\fR]   [\fB3dview\fR=\fIfrom,to\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Parameters:
.IP "\fBrast\fR=\fIfrom,to\fR" 4m
.br
rast file(s) to be copied
.IP "\fBrast3d\fR=\fIfrom,to\fR" 4m
.br
rast3d file(s) to be copied
.IP "\fBvect\fR=\fIfrom,to\fR" 4m
.br
vect file(s) to be copied
.IP "\fBoldvect\fR=\fIfrom,to\fR" 4m
.br
oldvect file(s) to be copied
.IP "\fBasciivect\fR=\fIfrom,to\fR" 4m
.br
asciivect file(s) to be copied
.IP "\fBicon\fR=\fIfrom,to\fR" 4m
.br
icon file(s) to be copied
.IP "\fBlabels\fR=\fIfrom,to\fR" 4m
.br
labels file(s) to be copied
.IP "\fBsites\fR=\fIfrom,to\fR" 4m
.br
sites file(s) to be copied
.IP "\fBregion\fR=\fIfrom,to\fR" 4m
.br
region file(s) to be copied
.IP "\fBregion3d\fR=\fIfrom,to\fR" 4m
.br
region3d file(s) to be copied
.IP "\fBgroup\fR=\fIfrom,to\fR" 4m
.br
group file(s) to be copied
.IP "\fB3dview\fR=\fIfrom,to\fR" 4m
.br
3dview file(s) to be copied
.PP
.SH DESCRIPTION
A user may access data stored under the other mapsets
listed in his mapset search path.  However, the user may
only modify data stored under his own current mapset.
\fIg.copy\fR allows the user to copy existing data files
\fIfrom\fR other mapsets \fIto\fR the user's current
mapset ($MAPSET).  The files to be copied must exist in the
user's current mapset search path and location; output is
sent to the relevant data element directory(ies) under the
user's current mapset.
.SH EXAMPLES
If the user wished to copy the existing raster
file \fIsoils\fR to a file called \fIsoils.ph\fR and
to copy an existing vector map \fIroads\fR to a file
called \fIrds.old\fR, the user could type:
.PP
\fC
.DS
.br
g.copy rast=soils,soils.ph vect=roads,rds.old
.br
.DE
\fR
.PP
Data files can also be specified by their mapsets.  For
example, the below command copies the raster map named
\fIsoils\fR from the mapset \fIwilson\fR to a new
file called \fIsoils\fR to be placed under the user's
current mapset:
.PP
\fC
.DS
.br
g.copy rast='soils@wilson',soils
.br
.DE
\fR
.PP
If no mapset name is specified, \fIg.copy\fR searches
for the named \fIfrom\fR map in each of the mapset
directories listed in the user's current mapset search path
in the order in which mapsets are listed there (see 
\fIg.mapsets\fR).
.SH NOTES
If the user does not enter parameter values but instead
types only \fBg.copy\fR on the command line the program
will prompt the user for a data type, the name of a file of
this data type to copy, and the name of a new file to hold
the copy.  After both file names have been entered, the
copy is created and the user is again prompted for a data
element to be copied, until the user hits RETURN.  When
prompted for file names, the user may enter 'list' to see a
list of existing files, or hit RETURN to end the file
listing.
.PP
If a file has support files (e.g., as do raster data
files), these support files will also be copied.
.SH SEE ALSO
\fIg.access\fR
.br
\fIg.list\fR
.br
\fIg.mapsets\fR
.br
\fIg.remove\fR
.br
\fIg.rename\fR
.SH AUTHOR
Michael Shapiro,
U.S.Army Construction Engineering 
Research Laboratory
.PP
\fILast changed: $Date: 2009-01-05 23:08:26 +0100 (Mon, 05 Jan 2009) $\fR
.PP
.PP
Full index
.PP
© 2003-2014 GRASS Development Team