g.copy(1)	       Grass User's Manual		g.copy(1)



NNAAMMEE
       gg..ccooppyy	-  Copies available data files in the user's cur-
       rent mapset search path and location  to  the  appropriate
       element directories under the user's current mapset.
       _(_G_R_A_S_S _F_i_l_e _M_a_n_a_g_e_m_e_n_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       gg..ccooppyy
       gg..ccooppyy hheellpp
       gg..ccooppyy	 [rraasstt==_f_r_o_m_,_t_o]   [vveecctt==_f_r_o_m_,_t_o]   [iiccoonn==_f_r_o_m_,_t_o]
       [llaabbeellss==_f_r_o_m_,_t_o]     [ssiitteess==_f_r_o_m_,_t_o]	 [rreeggiioonn==_f_r_o_m_,_t_o]
       [ggrroouupp==_f_r_o_m_,_t_o]

DDEESSCCRRIIPPTTIIOONN
       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.
       _g_._c_o_p_y allows the user to copy existing	data  files  _f_r_o_m
       other mapsets _t_o 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.

OOPPTTIIOONNSS
       The  user specifies the type(s) of data files he wishes to
       copy (raster, vector, etc.), the name of the existing file
       to  be  copied (i.e., the _f_r_o_m file name), and the name of
       the new file copy to  be  placed  in  the  user's  current
       mapset  (the _t_o file name).  This information can be given
       either (non-interactively) on the command line, or entered
       in  response  to  program  prompts  given via the standard
       _p_a_r_s_e_r interface.


       Information can be entered on the command line in the fol-
       lowing	format:   gg..ccooppyy   [rraasstt==_f_r_o_m_,_t_o]  [vveecctt==_f_r_o_m_,_t_o]
       [iiccoonn==_f_r_o_m_,_t_o]	   [llaabbeellss==_f_r_o_m_,_t_o]	  [ssiitteess==_f_r_o_m_,_t_o]
       [rreeggiioonn==_f_r_o_m_,_t_o] [ggrroouupp==_f_r_o_m_,_t_o]



       For  example,  if  the  user  wished  to copy the existing
       raster file _s_o_i_l_s to a file called _s_o_i_l_s_._p_h and to copy an
       existing  vector  file _r_o_a_d_s to a file called _r_d_s_._o_l_d, the
       user    could	 type:	   gg..ccooppyy     rraasstt==_s_o_i_l_s_,_s_o_i_l_s_._p_h
       vveecctt==_r_o_a_d_s_,_r_d_s_._o_l_d

       Data  files  can  also be specified by their mapsets.  For
       example, the below command copies the  raster  file  named
       _s_o_i_l_s from the mapset _w_i_l_s_o_n to a new file called _s_o_i_l_s to
       be  placed  under  the  user's  current	 mapset:   gg..ccooppyy
       rraasstt==_'_s_o_i_l_s_@_w_i_l_s_o_n_'_,_s_o_i_l_s

       If  no  mapset  name is specified, _g_._c_o_p_y searches for the
       named _f_r_o_m 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 _g_._m_a_p_s_e_t_s).


       If the user does not enter parameter  values  but  instead
       types  only  gg..ccooppyy  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.

   PPaarraammeetteerrss::
       33ddvviieeww==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is an existing 3d options file, and _t_o
	      is the name given to the copy.

       rraasstt==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing raster map  layer  to  be
	      copied, and _t_o is the name given to the copy.

       vveecctt==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is an existing binary vector map layer
	      to be copied, and _t_o is the name given to the copy.

       iiccoonn==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is  an  existing paint icon file to be
	      copied, and _t_o is the name given to the copy.

       llaabbeellss==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing /paint/labels file to  be
	      copied, and _t_o is the name given to the copy.

       ssiitteess==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is  an  existing site_lists file to be
	      copied, and _t_o is the name given to the copy.

       rreeggiioonn==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing region	definition  (_w_i_n_-
	      _d_o_w_s)  file  to be copied, and _t_o is the name given
	      to the copy.

       ggrroouupp==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing imagery group file to  be
	      copied, and _t_o is the name given to the copy.


NNOOTTEE
       If  a  file  has  support  files  (e.g., as do raster data
       files), these support files will also be copied.

SSEEEE AALLSSOO
       _g_._a_c_c_e_s_s

       _g_._l_i_s_t

       _g_._m_a_p_s_e_t_s

       _g_._r_e_m_o_v_e

       _g_._r_e_n_a_m_e

       _p_a_r_s_e_r

AAUUTTHHOORR
       Michael	 Shapiro,   U.S.Army   Construction   Engineering
       Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



