1 /* touch -- change modification and access times of files
2 Copyright (C) 87, 89, 90, 91, 95, 96, 97, 1998 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software Foundation,
16 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
19 -a, --time={atime,access,use} Change access time only.
20 -c, --no-create Do not create files that do not exist.
21 -d, --date=TIME Specify time and date in various formats.
23 -m, --time={mtime,modify} Change modification time only.
24 -r, --reference=FILE Use the time and date of reference file FILE.
25 -t TIME Specify time and date in the form
26 `MMDDhhmm[[CC]YY][.ss]'.
28 If no options are given, -am is the default, using the current time.
29 The -r, -t, and -d options are mutually exclusive. If a file does not
30 exist, create it unless -c is given.
32 Written by Paul Rubin, Arnold Robbins, Jim Kingdon, David MacKenzie,
38 #include <sys/types.h>
45 #include "safe-read.h"
55 /* Bitmasks for `change_times'. */
59 /* The name by which this program was run. */
62 /* Which timestamps to change. */
63 static int change_times;
65 /* (-c) If nonzero, don't create if not already there. */
68 /* (-d) If nonzero, date supplied on command line in get_date formats. */
69 static int flexible_date;
71 /* (-r) If nonzero, use times from a reference file. */
74 /* (-t) If nonzero, date supplied on command line in POSIX format. */
75 static int posix_date;
77 /* If nonzero, the only thing we have to do is change both the
78 modification and access time to the current time, so we don't
79 have to own the file, just be able to read and write it. */
80 static int amtime_now;
82 /* New time to use when setting time. */
83 static time_t newtime;
85 /* File to use for -r. */
86 static char *ref_file;
88 /* Info about the reference file. */
89 static struct stat ref_stats;
91 /* If nonzero, display usage information and exit. */
94 /* If nonzero, print the version on standard output and exit. */
95 static int show_version;
97 static struct option const longopts[] =
99 {"time", required_argument, 0, 130},
100 {"no-create", no_argument, 0, 'c'},
101 {"date", required_argument, 0, 'd'},
102 {"file", required_argument, 0, 'r'},
103 {"reference", required_argument, 0, 'r'},
104 {"help", no_argument, &show_help, 1},
105 {"version", no_argument, &show_version, 1},
109 /* Valid arguments to the `--time' option. */
110 static char const* const time_args[] =
112 "atime", "access", "use", "mtime", "modify", 0
115 /* The bits in `change_times' that those arguments set. */
116 static int const time_masks[] =
118 CH_ATIME, CH_ATIME, CH_ATIME, CH_MTIME, CH_MTIME
121 /* Update the time of file FILE according to the options given.
122 Return 0 if successful, 1 if an error occurs. */
131 if (stat (file, &sbuf))
135 error (0, errno, "%s", file);
140 fd = creat (file, 0666);
143 error (0, errno, "%s", file);
150 error (0, errno, "%s", file);
153 return 0; /* We've done all we have to. */
155 if (fstat (fd, &sbuf))
157 error (0, errno, "%s", file);
163 error (0, errno, "%s", file);
170 /* Pass NULL to utime so it will not fail if we just have
171 write access to the file, but don't own it. */
172 status = utime (file, NULL);
178 /* There's currently no interface to set file timestamps with
179 better than 1-second resolution, so discard any fractional
180 part of the source timestamp. */
184 utb.actime = ref_stats.st_atime;
185 utb.modtime = ref_stats.st_mtime;
188 utb.actime = utb.modtime = newtime;
190 if (!(change_times & CH_ATIME))
191 utb.actime = sbuf.st_atime;
193 if (!(change_times & CH_MTIME))
194 utb.modtime = sbuf.st_mtime;
196 status = utime (file, &utb);
201 error (0, errno, "%s", file);
212 fprintf (stderr, _("Try `%s --help' for more information.\n"),
216 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name);
218 Update the access and modification times of each FILE to the current time.\n\
220 -a change only the access time\n\
221 -c do not create any files\n\
222 -d, --date=STRING parse STRING and use it instead of current time\n\
224 -m change only the modification time\n\
225 -r, --reference=FILE use this file's times instead of current time\n\
226 -t STAMP use MMDDhhmm[[CC]YY][.ss] instead of current time\n\
227 --time=WORD access -a, atime -a, mtime -m, modify -m, use -a\n\
228 --help display this help and exit\n\
229 --version output version information and exit\n\
231 STAMP may be used without -t if none of -drt, nor --, are used.\n\
233 puts (_("\nReport bugs to <fileutils-bugs@gnu.org>."));
240 main (int argc, char **argv)
246 program_name = argv[0];
247 setlocale (LC_ALL, "");
248 bindtextdomain (PACKAGE, LOCALEDIR);
249 textdomain (PACKAGE);
251 change_times = no_create = use_ref = posix_date = flexible_date = 0;
252 newtime = (time_t) -1;
254 while ((c = getopt_long (argc, argv, "acd:fmr:t:", longopts, NULL)) != -1)
262 change_times |= CH_ATIME;
271 newtime = get_date (optarg, NULL);
272 if (newtime == (time_t) -1)
273 error (1, 0, _("invalid date format `%s'"), optarg);
281 change_times |= CH_MTIME;
291 newtime = posixtime (optarg);
292 if (newtime == (time_t) -1)
293 error (1, 0, _("invalid date format `%s'"), optarg);
298 i = argmatch (optarg, time_args);
301 invalid_arg (_("time selector"), optarg, i);
304 change_times |= time_masks[i];
314 printf ("touch (%s) %s\n", GNU_PACKAGE, VERSION);
322 if (change_times == 0)
323 change_times = CH_ATIME | CH_MTIME;
325 if ((use_ref && (posix_date || flexible_date))
326 || (posix_date && flexible_date))
328 error (0, 0, _("cannot specify times from more than one source"));
334 if (stat (ref_file, &ref_stats))
335 error (1, errno, "%s", ref_file);
339 if (!date_set && optind < argc && !STREQ (argv[optind - 1], "--"))
341 newtime = posixtime (argv[optind]);
342 if (newtime != (time_t) -1)
350 if ((change_times & (CH_ATIME | CH_MTIME)) == (CH_ATIME | CH_MTIME))
358 error (0, 0, _("file arguments missing"));
362 for (; optind < argc; ++optind)
363 err += touch (argv[optind]);