.
[coreutils.git] / src / touch.c
blob881f1d0d4490ffb3977731cc21a617b1ec29ea8c
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)
7 any later version.
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. */
18 /* Options:
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.
22 -f Ignored.
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,
33 and Randy Smith. */
35 #include <config.h>
36 #include <stdio.h>
37 #include <getopt.h>
38 #include <sys/types.h>
40 #include "system.h"
41 #include "closeout.h"
42 #include "error.h"
43 #include "argmatch.h"
45 #ifndef STDC_HEADERS
46 time_t time ();
47 #endif
49 time_t get_date ();
50 time_t posixtime ();
51 int safe_read ();
52 int full_write ();
53 void invalid_arg ();
55 #ifndef HAVE_UTIME_NULL
56 static int utime_now ();
57 #endif
59 /* Bitmasks for `change_times'. */
60 #define CH_ATIME 1
61 #define CH_MTIME 2
63 /* The name by which this program was run. */
64 char *program_name;
66 /* Which timestamps to change. */
67 static int change_times;
69 /* (-c) If nonzero, don't create if not already there. */
70 static int no_create;
72 /* (-d) If nonzero, date supplied on command line in get_date formats. */
73 static int flexible_date;
75 /* (-r) If nonzero, use times from a reference file. */
76 static int use_ref;
78 /* (-t) If nonzero, date supplied on command line in POSIX format. */
79 static int posix_date;
81 /* If nonzero, the only thing we have to do is change both the
82 modification and access time to the current time, so we don't
83 have to own the file, just be able to read and write it. */
84 static int amtime_now;
86 /* New time to use when setting time. */
87 static time_t newtime;
89 /* File to use for -r. */
90 static char *ref_file;
92 /* Info about the reference file. */
93 static struct stat ref_stats;
95 /* If nonzero, display usage information and exit. */
96 static int show_help;
98 /* If nonzero, print the version on standard output and exit. */
99 static int show_version;
101 static struct option const longopts[] =
103 {"time", required_argument, 0, 130},
104 {"no-create", no_argument, 0, 'c'},
105 {"date", required_argument, 0, 'd'},
106 {"file", required_argument, 0, 'r'},
107 {"reference", required_argument, 0, 'r'},
108 {"help", no_argument, &show_help, 1},
109 {"version", no_argument, &show_version, 1},
110 {0, 0, 0, 0}
113 /* Valid arguments to the `--time' option. */
114 static char const* const time_args[] =
116 "atime", "access", "use", "mtime", "modify", 0
119 /* The bits in `change_times' that those arguments set. */
120 static int const time_masks[] =
122 CH_ATIME, CH_ATIME, CH_ATIME, CH_MTIME, CH_MTIME
125 /* Update the time of file FILE according to the options given.
126 Return 0 if successful, 1 if an error occurs. */
128 static int
129 touch (char *file)
131 int status;
132 struct stat sbuf;
133 int fd;
135 if (stat (file, &sbuf))
137 if (errno != ENOENT)
139 error (0, errno, "%s", file);
140 return 1;
142 if (no_create)
143 return 0;
144 fd = creat (file, 0666);
145 if (fd == -1)
147 error (0, errno, "%s", file);
148 return 1;
150 if (amtime_now)
152 if (close (fd) < 0)
154 error (0, errno, "%s", file);
155 return 1;
157 return 0; /* We've done all we have to. */
159 if (fstat (fd, &sbuf))
161 error (0, errno, "%s", file);
162 close (fd);
163 return 1;
165 if (close (fd) < 0)
167 error (0, errno, "%s", file);
168 return 1;
172 if (amtime_now)
174 #ifndef HAVE_UTIME_NULL
175 status = utime_now (file, sbuf.st_size);
176 #else
177 /* Pass NULL to utime so it will not fail if we just have
178 write access to the file, but don't own it. */
179 status = utime (file, NULL);
180 #endif
182 else
184 struct utimbuf utb;
186 if (use_ref)
188 utb.actime = ref_stats.st_atime;
189 utb.modtime = ref_stats.st_mtime;
191 else
192 utb.actime = utb.modtime = newtime;
194 if (!(change_times & CH_ATIME))
195 utb.actime = sbuf.st_atime;
197 if (!(change_times & CH_MTIME))
198 utb.modtime = sbuf.st_mtime;
200 status = utime (file, &utb);
203 if (status)
205 error (0, errno, "%s", file);
206 return 1;
209 return 0;
212 #ifndef HAVE_UTIME_NULL
213 /* Emulate utime (file, NULL) for systems (like 4.3BSD) that do not
214 interpret it to set the access and modification times of FILE to
215 the current time. FILESIZE is the correct size of FILE, used to
216 make sure empty files are not lengthened to 1 byte.
217 Return 0 if successful, -1 if not. */
219 static int
220 utime_now (const char *file, off_t filesize)
222 int fd;
223 char c;
224 int status = 0;
226 fd = open (file, O_RDWR, 0666);
227 if (fd < 0
228 || safe_read (fd, &c, sizeof (char)) < 0
229 || lseek (fd, (off_t) 0, SEEK_SET) < 0
230 || full_write (fd, &c, sizeof (char)) < 0
231 || ftruncate (fd, filesize) < 0
232 || close (fd) < 0)
233 status = -1;
234 return status;
236 #endif
238 static void
239 usage (int status)
241 if (status != 0)
242 fprintf (stderr, _("Try `%s --help' for more information.\n"),
243 program_name);
244 else
246 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name);
247 printf (_("\
248 Update the access and modification times of each FILE to the current time.\n\
250 -a change only the access time\n\
251 -c do not create any files\n\
252 -d, --date=STRING parse STRING and use it instead of current time\n\
253 -f (ignored)\n\
254 -m change only the modification time\n\
255 -r, --reference=FILE use this file's times instead of current time\n\
256 -t STAMP use MMDDhhmm[[CC]YY][.ss] instead of current time\n\
257 --time=WORD access -a, atime -a, mtime -m, modify -m, use -a\n\
258 --help display this help and exit\n\
259 --version output version information and exit\n\
261 STAMP may be used without -t if none of -drt, nor --, are used.\n\
262 "));
263 puts (_("\nReport bugs to <fileutils-bugs@gnu.org>."));
264 close_stdout ();
266 exit (status);
270 main (int argc, char **argv)
272 int c, i;
273 int date_set = 0;
274 int err = 0;
276 program_name = argv[0];
277 setlocale (LC_ALL, "");
278 bindtextdomain (PACKAGE, LOCALEDIR);
279 textdomain (PACKAGE);
281 change_times = no_create = use_ref = posix_date = flexible_date = 0;
282 newtime = (time_t) -1;
284 while ((c = getopt_long (argc, argv, "acd:fmr:t:", longopts, NULL)) != -1)
286 switch (c)
288 case 0:
289 break;
291 case 'a':
292 change_times |= CH_ATIME;
293 break;
295 case 'c':
296 no_create++;
297 break;
299 case 'd':
300 flexible_date++;
301 newtime = get_date (optarg, NULL);
302 if (newtime == (time_t) -1)
303 error (1, 0, _("invalid date format `%s'"), optarg);
304 date_set++;
305 break;
307 case 'f':
308 break;
310 case 'm':
311 change_times |= CH_MTIME;
312 break;
314 case 'r':
315 use_ref++;
316 ref_file = optarg;
317 break;
319 case 't':
320 posix_date++;
321 newtime = posixtime (optarg);
322 if (newtime == (time_t) -1)
323 error (1, 0, _("invalid date format `%s'"), optarg);
324 date_set++;
325 break;
327 case 130:
328 i = argmatch (optarg, time_args);
329 if (i < 0)
331 invalid_arg (_("time selector"), optarg, i);
332 usage (1);
334 change_times |= time_masks[i];
335 break;
337 default:
338 usage (1);
342 if (show_version)
344 printf ("touch (%s) %s\n", GNU_PACKAGE, VERSION);
345 close_stdout ();
346 exit (0);
349 if (show_help)
350 usage (0);
352 if (change_times == 0)
353 change_times = CH_ATIME | CH_MTIME;
355 if ((use_ref && (posix_date || flexible_date))
356 || (posix_date && flexible_date))
358 error (0, 0, _("cannot specify times from more than one source"));
359 usage (1);
362 if (use_ref)
364 if (stat (ref_file, &ref_stats))
365 error (1, errno, "%s", ref_file);
366 date_set++;
369 if (!date_set && optind < argc && strcmp (argv[optind - 1], "--"))
371 newtime = posixtime (argv[optind]);
372 if (newtime != (time_t) -1)
374 optind++;
375 date_set++;
378 if (!date_set)
380 if ((change_times & (CH_ATIME | CH_MTIME)) == (CH_ATIME | CH_MTIME))
381 amtime_now = 1;
382 else
383 time (&newtime);
386 if (optind == argc)
388 error (0, 0, _("file arguments missing"));
389 usage (1);
392 for (; optind < argc; ++optind)
393 err += touch (argv[optind]);
395 exit (err != 0);