lib/futimens.c

   1 /* Set the access and modification time of an open fd.
   2    Copyright (C) 2009-2024 Free Software Foundation, Inc.
   3
   4    This file is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU Lesser General Public License as
   6    published by the Free Software Foundation, either version 3 of the
   7    License, or (at your option) any later version.
   8
   9    This file 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 Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 /* written by Eric Blake */
  18
  19 #include <config.h>
  20
  21 #include <sys/stat.h>
  22
  23 #include "utimens.h"
  24
  25 /* Set the access and modification timestamps of FD to be
  26    TIMESPEC[0] and TIMESPEC[1], respectively.
  27    Fail with ENOSYS on systems without futimes (or equivalent).
  28    If TIMESPEC is null, set the timestamps to the current time.
  29    Return 0 on success, -1 (setting errno) on failure.  */
  30 int
  31 futimens (int fd, struct timespec const times[2])
  32 {
  33   /* fdutimens also works around bugs in native futimens, when running
  34      with glibc compiled against newer headers but on a Linux kernel
  35      older than 2.6.32.  */
  36   return fdutimens (fd, NULL, times);
  37 }