


TOUCH(1L)						TOUCH(1L)


NNAAMMEE
       touch - change file timestamps

SSYYNNOOPPSSIISS
       ttoouucchh	[-acfm]    [-r	reference-file]    [-t    MMD-
       Dhhmm[[CC]YY][.ss]]		[-d		time]
       [--time={atime,access,use,mtime,modify}]	[--date=time]
       [--file=reference-file] [--no-create] [--help] [--version]
       file...

DDEESSCCRRIIPPTTIIOONN
       This  manual  page  documents  the  GNU	version of ttoouucchh.
       ttoouucchh changes the access and modification  times	of  each
       given  file  to the current time.  Files that do not exist
       are created empty.  If the first file name given would  be
       a  valid	argument  to  the  _-_t option and no timestamp is
       given with any of the _-_d, _-_r, or _-_t  options  and  the  _-_-
       argument is not given, that argument is interpreted as the
       time for the other files instead of as a filename.

       If changing both the access and modification times to  the
       current	time,  ttoouucchh  can change the timestamps for files
       that the user running it does not own but has  write  per-
       mission for.  Otherwise, the user must own the files.

   OOPPTTIIOONNSS
       _-_a_, _-_-_t_i_m_e_=_a_t_i_m_e_, _-_-_t_i_m_e_=_a_c_c_e_s_s_, _-_-_t_i_m_e_=_u_s_e
	      Change the access time only.

       _-_c_, _-_-_n_o_-_c_r_e_a_t_e
	      Do not create files that do not exist.

       _-_d_, _-_-_d_a_t_e _t_i_m_e
	      Use  _t_i_m_e	(which can be in various common formats)
	      instead of the current time.  It can contain  month
	      names, timezones, `am' and `pm', etc.

       _-_f     Ignored;	for  compatibility  with  BSD versions of
	      ttoouucchh.

       _-_m_, _-_-_t_i_m_e_=_m_t_i_m_e_, _-_-_t_i_m_e_=_m_o_d_i_f_y
	      Change the modification time only.

       _-_r_, _-_-_f_i_l_e _r_e_f_e_r_e_n_c_e_-_f_i_l_e
	      Use the times of _r_e_f_e_r_e_n_c_e_-_f_i_l_e instead of the cur-
	      rent time.

       _-_t _M_M_D_D_h_h_m_m_[_[_C_C_]_Y_Y_]_[_._s_s_]
	      Use  the	argument  (months,  days, hours, minutes,
	      optional	century	and  years,  optional	seconds)
	      instead of the current time.

       _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
	      tus.



FSF			GNU File Utilities			1





TOUCH(1L)						TOUCH(1L)


       _-_-_v_e_r_s_i_o_n
	      Print version information on  standard  error  then
	      exit.






















































FSF			GNU File Utilities			2


