src/library/base/man/Sys.setFileTime.Rd

% File src/library/base/man/Sys.setFileTime.Rd
% Part of the R package, https://www.R-project.org
% Copyright 2011-2018 R Core Team
% Distributed under GPL 2 or later

\name{Sys.setFileTime}
\alias{Sys.setFileTime}
\title{
  Set File Time
}
\description{
  Uses system calls to set the times on a file or directory.
}
\usage{
Sys.setFileTime(path, time)
}

\arguments{
  \item{path}{
    A character vector containing file or directory paths.
  }
  \item{time}{
    A date-time of class \code{"\link{POSIXct}"} or an object which can be
    coerced to one.  Fractions of a second may be ignored.  Recycled along
    \code{paths}.
  }
}
\details{
  This attempts sets the file time to the value specified.

  On a Unix-alike it uses the system call \code{utimensat} if that is
  available, otherwise \code{utimes} or \code{utime}.  On a POSIX file
  system it sets both the last-access and modification times.
  Fractional seconds will set as from \R 3.4.0 on OSes with the
  requisite system calls and suitable filesystems.

  On Windows it uses the system call \code{SetFileTime} to set the
  \sQuote{last write time}.  Some Windows file systems only record the
  time at a resolution of two seconds.

  \code{Sys.setFileTime} has been vectorized in \R 3.6.0.  Earlier versions
  of \R required \code{path} and \code{time} to be vectors of length one.
}
\value{
  A logical vector indicating if the operation succeeded for each of the
  files and directories attempted, returned invisibly.
}
\keyword{file}