xnu-4903.270.47.tar.gz

[apple/xnu.git] / bsd / man / man2 / utimes.2

diff --git a/bsd/man/man2/utimes.2 b/bsd/man/man2/utimes.2
index 94dabd258ade71880f9a6f26c3024423e824e176..cb650f1861fabd26879aac6fd276a0373ecde3f6 100644 (file)
--- a/bsd/man/man2/utimes.2
+++ b/bsd/man/man2/utimes.2
@@ -38,22 +38,28 @@
 .Dt UTIMES 2
 .Os
 .Sh NAME
 .Dt UTIMES 2
 .Os
 .Sh NAME

-.Nm utimes ,
-.Nm futimes
+.Nm futimes ,
+.Nm utimes

 .Nd set file access and modification times
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In sys/time.h
 .Ft int
 .Nd set file access and modification times
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In sys/time.h
 .Ft int

-.Fn utimes "const char *path" "const struct timeval *times"
+.Fo futimes
+.Fa "int fildes"
+.Fa "const struct timeval times[2]"
+.Fc

 .Ft int
 .Ft int

-.Fn futimes "int fd" "const struct timeval *times"
+.Fo utimes
+.Fa "const char *path"
+.Fa "const struct timeval times[2]"
+.Fc

 .Sh DESCRIPTION
 The access and modification times of the file named by
 .Fa path
 or referenced by
 .Sh DESCRIPTION
 The access and modification times of the file named by
 .Fa path
 or referenced by

-.Fa fd
+.Fa fildes

 are changed as specified by the argument
 .Fa times .
 .Pp
 are changed as specified by the argument
 .Fa times .
 .Pp


@@ -79,9 +85,11 @@ time.
 .Sh RETURN VALUES
 .Rv -std
 .Sh ERRORS
 .Sh RETURN VALUES
 .Rv -std
 .Sh ERRORS

+The

 .Fn utimes
 .Fn utimes

-will fail if:
+system call will fail if:

 .Bl -tag -width Er
 .Bl -tag -width Er

+.\" ===========

 .It Bq Er EACCES
 Search permission is denied for a component of the path prefix;
 or the
 .It Bq Er EACCES
 Search permission is denied for a component of the path prefix;
 or the


@@ -91,25 +99,33 @@ argument is
 and the effective user ID of the process does not
 match the owner of the file, and is not the super-user, and write
 access is denied.
 and the effective user ID of the process does not
 match the owner of the file, and is not the super-user, and write
 access is denied.

+.\" ===========

 .It Bq Er EFAULT
 .Fa path
 or
 .Fa times
 points outside the process's allocated address space.
 .It Bq Er EFAULT
 .Fa path
 or
 .Fa times
 points outside the process's allocated address space.

+.\" ===========

 .It Bq Er EIO
 .It Bq Er EIO

-An I/O error occurred while reading or writing the affected inode.
+An I/O error occurs while reading or writing the affected inode.
+.\" ===========

 .It Bq Er ELOOP
 .It Bq Er ELOOP

-Too many symbolic links were encountered in translating the pathname.
+Too many symbolic links are encountered in translating the pathname.
+This is taken to be indicative of a looping symbolic link.
+.\" ===========

 .It Bq Er ENAMETOOLONG
 .It Bq Er ENAMETOOLONG

-A component of a pathname exceeded
+A component of a pathname exceeds

 .Dv NAME_MAX
 characters, or an entire path name exceeded
 .Dv PATH_MAX
 characters.
 .Dv NAME_MAX
 characters, or an entire path name exceeded
 .Dv PATH_MAX
 characters.

+.\" ===========

 .It Bq Er ENOENT
 The named file does not exist.
 .It Bq Er ENOENT
 The named file does not exist.

+.\" ===========

 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.

+.\" ===========

 .It Bq Er EPERM
 The
 .Fa times
 .It Bq Er EPERM
 The
 .Fa times


@@ -117,20 +133,24 @@ argument is not
 .Dv NULL
 and the calling process's effective user ID
 does not match the owner of the file and is not the super-user.
 .Dv NULL
 and the calling process's effective user ID
 does not match the owner of the file and is not the super-user.

+.\" ===========

 .It Bq Er EROFS
 The file system containing the file is mounted read-only.
 .El
 .Pp
 .It Bq Er EROFS
 The file system containing the file is mounted read-only.
 .El
 .Pp

+The

 .Fn futimes
 .Fn futimes

-will fail if:
+system call will fail if:

 .Bl -tag -width Er
 .Bl -tag -width Er

+.\" ===========

 .It Bq Er EBADF
 .It Bq Er EBADF

-.Fa fd
+.Fa fildes

 does not refer to a valid descriptor.
 .El
 .Pp
 All of the functions will fail if:
 .Bl -tag -width Er
 does not refer to a valid descriptor.
 .El
 .Pp
 All of the functions will fail if:
 .Bl -tag -width Er

+.\" ===========

 .It Bq Er EACCES
 The
 .Fa times
 .It Bq Er EACCES
 The
 .Fa times


@@ -139,11 +159,14 @@ argument is
 and the effective user ID of the process does not
 match the owner of the file, and is not the super-user, and write
 access is denied.
 and the effective user ID of the process does not
 match the owner of the file, and is not the super-user, and write
 access is denied.

+.\" ===========

 .It Bq Er EFAULT
 .Fa times
 points outside the process's allocated address space.
 .It Bq Er EFAULT
 .Fa times
 points outside the process's allocated address space.

+.\" ===========

 .It Bq Er EIO
 An I/O error occurred while reading or writing the affected inode.
 .It Bq Er EIO
 An I/O error occurred while reading or writing the affected inode.

+.\" ===========

 .It Bq Er EPERM
 The
 .Fa times
 .It Bq Er EPERM
 The
 .Fa times


@@ -151,6 +174,7 @@ argument is not
 .Dv NULL
 and the calling process's effective user ID
 does not match the owner of the file and is not the super-user.
 .Dv NULL
 and the calling process's effective user ID
 does not match the owner of the file and is not the super-user.

+.\" ===========

 .It Bq Er EROFS
 The file system containing the file is mounted read-only.
 .El
 .It Bq Er EROFS
 The file system containing the file is mounted read-only.
 .El