Debian Bug report logs - #620746
lutimes.3: please warn about possibility of ENOSYS

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Jonathan Nieder <jrnieder@gmail.com>

To: submit@bugs.debian.org

Subject: lutimes.3: please warn about possibility of ENOSYS

Date: Sun, 3 Apr 2011 14:45:31 -0500

Package: manpages-dev
Version: 3.27-1
Severity: minor
Tags: upstream
Justification: http://bugs.debian.org/620679

Hi,

The lutimes(3) manpage explains:

	Errors are as for utimes(2), with the following additions for
	futimes():

	EBADF	fd is not a valid file descriptor.

	ENOSYS	The /proc file system could not be accessed.

where for reference, the list of errors in utimes(2) is below[1].  But
it never mentions a certain, more common error:

	ENOSYS	(Linux: the kernel version is below 2.6.22.)

Assuming I can trust utimensat(2), it might also be good to mention

	EACCES	times is NULL, and the file is marked immutable (see
		chattr(1).

	EFAULT	times points to an invalid address, or filename is
		NULL or an invalid address

	EINVAL	invalid value in one of the tv_nsec fields (see
		utimensat(2)), or an invalid value in one of the
		tv_sec fields

	ELOOP	too many symbolic links were encountered in resolving
		filename

	ENAMETOOLONG	filename is too long

	ENOENT	a component of filename does not refer to an existing
		directory or file, or filename is an empty string

	ENOTDIR	one of the prefix components of filename is not a
		directory

	EPERM	attempting to change a time but the file is marked
		append-only (see chattr(1))

	ESRCH	search permission is denied for one of the prefix
		components of filename

though I'm not sure such detail is warranted --- maybe
path_resolution.7 could mention the errors it can produce, and
the error section in utimensat.2 and futimes.3 could just say
something like

	EACCES, ESRCH, ENAMETOOLONG, ENOTDIR, ELOOP
		see path_resolution(7)

to cover that part.

Hope that helps.

[1]
EACCES	Search permission is denied for one of the directories
	in the path prefix of path (see also path_resolution(7)).

EACCES	times is NULL, the caller's effective user ID does not
	match the owner of the file, the caller does not have
	write access to the file, and the caller is not
	privileged (Linux: does not have either the
	CAP_DAC_OVERRIDE or the CAP_FOWNER capability).

ENOENT	filename does not exist.

EPERM	times is not NULL, the caller's effective UID does not
	match the owner of the file, and the caller is not
	privileged (Linux: does not have the CAP_FOWNER
	capability).

EROFS	path resides on a read-only file system.

Message #10 received at 620746@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>

To: Jonathan Nieder <jrnieder@gmail.com>, 620746@bugs.debian.org

Cc: control@bugs.debian.org

Subject: Re: Bug#620746: lutimes.3: please warn about possibility of ENOSYS

Date: Thu, 14 Mar 2013 11:33:47 +0100

tags 620746 fixed-upstream
thanks

Jonathan,

I have applied a patch for man-pages-3.50. Thanks for the report.

Cheers,

Michael


On Sun, Apr 3, 2011 at 9:45 PM, Jonathan Nieder <jrnieder@gmail.com> wrote:
> Package: manpages-dev
> Version: 3.27-1
> Severity: minor
> Tags: upstream
> Justification: http://bugs.debian.org/620679
>
> Hi,
>
> The lutimes(3) manpage explains:
>
>        Errors are as for utimes(2), with the following additions for
>        futimes():
>
>        EBADF   fd is not a valid file descriptor.
>
>        ENOSYS  The /proc file system could not be accessed.
>
> where for reference, the list of errors in utimes(2) is below[1].  But
> it never mentions a certain, more common error:
>
>        ENOSYS  (Linux: the kernel version is below 2.6.22.)
>
> Assuming I can trust utimensat(2), it might also be good to mention
>
>        EACCES  times is NULL, and the file is marked immutable (see
>                chattr(1).
>
>        EFAULT  times points to an invalid address, or filename is
>                NULL or an invalid address
>
>        EINVAL  invalid value in one of the tv_nsec fields (see
>                utimensat(2)), or an invalid value in one of the
>                tv_sec fields
>
>        ELOOP   too many symbolic links were encountered in resolving
>                filename
>
>        ENAMETOOLONG    filename is too long
>
>        ENOENT  a component of filename does not refer to an existing
>                directory or file, or filename is an empty string
>
>        ENOTDIR one of the prefix components of filename is not a
>                directory
>
>        EPERM   attempting to change a time but the file is marked
>                append-only (see chattr(1))
>
>        ESRCH   search permission is denied for one of the prefix
>                components of filename
>
> though I'm not sure such detail is warranted --- maybe
> path_resolution.7 could mention the errors it can produce, and
> the error section in utimensat.2 and futimes.3 could just say
> something like
>
>        EACCES, ESRCH, ENAMETOOLONG, ENOTDIR, ELOOP
>                see path_resolution(7)
>
> to cover that part.
>
> Hope that helps.
>
> [1]
> EACCES  Search permission is denied for one of the directories
>        in the path prefix of path (see also path_resolution(7)).
>
> EACCES  times is NULL, the caller's effective user ID does not
>        match the owner of the file, the caller does not have
>        write access to the file, and the caller is not
>        privileged (Linux: does not have either the
>        CAP_DAC_OVERRIDE or the CAP_FOWNER capability).
>
> ENOENT  filename does not exist.
>
> EPERM   times is not NULL, the caller's effective UID does not
>        match the owner of the file, and the caller is not
>        privileged (Linux: does not have the CAP_FOWNER
>        capability).
>
> EROFS   path resides on a read-only file system.
>
>
>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/

Message #19 received at 620746-close@bugs.debian.org (full text, mbox, reply):

From: Simon Paillard <spaillard@debian.org>

To: 620746-close@bugs.debian.org

Subject: Bug#620746: fixed in manpages 3.51-1

Date: Thu, 23 May 2013 22:48:40 +0000

Source: manpages
Source-Version: 3.51-1

We believe that the bug you reported is fixed in the latest version of
manpages, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 620746@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Simon Paillard <spaillard@debian.org> (supplier of updated manpages package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Thu, 23 May 2013 23:05:10 +0200
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 3.51-1
Distribution: unstable
Urgency: low
Maintainer: Martin Schulze <joey@debian.org>
Changed-By: Simon Paillard <spaillard@debian.org>
Description: 
 manpages   - Manual pages about using a GNU/Linux system
 manpages-dev - Manual pages about using GNU/Linux for development
Closes: 182014 235967 533232 542601 553413 575077 578178 620746 674034 676264 692136 699387 700529 704787 705293
Changes: 
 manpages (3.51-1) unstable; urgency=low
 .
   * Imported Upstream version 3.51:
     . new manpages: kcmp.3 s390_runtime_instr.2 if_freenameindex.3
       if_indextoname.3 if_nameindex.3 if_nametoindex.3 (Closes: #235967)
       perf_event_open.2 getcontext.3 getdtablesize.3 pthread_getname_np.3
       pthread_setname_np.3 setcontext.3 sln.8
       fattach.2 fdetach.2 getmsg.2 getunwind.2 isastream.2
       perfmonctl.2 putmsg.2 nss.5
     . ttyname.3: Fix confused text in ERRORS (Closes: #676264)
     . proc.5: Add field numbers for (Closes: #553413)
     . read.2: Remove crufty text about O_NONBLOCK on files (Closes: #700529)
     . read.2: Clarify interaction of count==0 and error check (Closes: #533232)
     . getpeername.2: Clarify semantics of getpeername() for datagram
       sockets (Closes: #674034)
     . mmap.2: Some 'flags' values require a feature test macro to be
       defined (Closes: #542601)
     . resolver.3, resolv.conf.5: RES_DEBUG is only available if glibc is
       compiled with debug support (Closes: #692136)
     . stdarg.3: Describe va_copy() (Closes: #575077)
     . futimes.3: ERRORS: Add ENOSYS for lutimes() (Closes: #620746)
     . units.7: units should use an actual µ (Closes: #704787)
     . access.2: Clarify RETURN VALUE for F_OK (Closes: #705293)
     . resolv.conf.5: Document "single-request-reopen" option (Closes: #699387)
     . bootparam.7: Document 'rootfstype' option (Closes: #182014)
     . ioperm.2: Linux 2.6.8 lifted the port limit to 65,536 (Closes: #578178)
   * d/rules: build-{arch,indep} as required by policy 3.9.4
   * lintian overrides: FSSTND-dir-in-manual-page are alternate path
Checksums-Sha1: 
 f277d33dc4ae2e2824fd7f2d747ec18f272a0d59 1907 manpages_3.51-1.dsc
 96c93e69f4e5db0952361b25db3eb3c19504ac1f 1828168 manpages_3.51.orig.tar.gz
 beaf9204e88e4406e7afd7d6014e7ea7af620e2f 47215 manpages_3.51-1.diff.gz
 db917de30d91a0382c32b8a71a57331eb0da7d40 823120 manpages_3.51-1_all.deb
 3d8a2bba0b3c9cb0ef8e4ab545eb37b5b1bf1974 1803556 manpages-dev_3.51-1_all.deb
Checksums-Sha256: 
 bf5b05f49b85e86052694c2c80fc1a9119437c88b60f0606d786b301b1c6f07b 1907 manpages_3.51-1.dsc
 f6639351a6a9e7fd9a82bae7dbefa8cb73557794e04a5d6a05bf8f64b8457bad 1828168 manpages_3.51.orig.tar.gz
 0151dd7c6eeeae5f3e764b5a5ac03fa6a48e3c36eeaa19e550de2ccbf0cfb337 47215 manpages_3.51-1.diff.gz
 fd60606aecff76039e414d9930b528900c90916f226ab61e24a1ce782de85916 823120 manpages_3.51-1_all.deb
 ebf111927854d749bfe4b1b510fe4ac49b965ed3466795a0456c144de3e5311f 1803556 manpages-dev_3.51-1_all.deb
Files: 
 233eff29953c78f8c1257fda9f31a6d2 1907 doc important manpages_3.51-1.dsc
 bed1627674356ec85492c5e94619b23d 1828168 doc important manpages_3.51.orig.tar.gz
 3144b81732373b7f027c071c58f6c230 47215 doc important manpages_3.51-1.diff.gz
 4df5993a51d7985a0a271d0a4bf19d79 823120 doc important manpages_3.51-1_all.deb
 075aa05d2cae81593bf807ad5b56585f 1803556 doc optional manpages-dev_3.51-1_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQIcBAEBCAAGBQJRnplOAAoJEN/3OMLRbPuiX0EP/0++s6v9aB7OtKEXos4RnFbQ
SAOyHWgLaBJ7ui/nb0OfUHWhZ3DxfgkGQmcDw0EU86pvr5FAJinMKV0rJ7s4YacY
VxL5Ryw0VlvnTBWt017c2GgRxFtMUZFY3wvuvB4hJRCnjFujR3e8ARvDjmYTGr/0
xIP/5dMqEXJIKKFBdg3PDI1p+MqG5xapINBX2kegRI6bAWmEXq356JkIvGy2QuLU
OKkrFeKijgaij8ZPuwDqrq2Wax3wsB8Qn4RKM64zRZpilEDvRZZHBBHwpdDFl8rr
iIlFuXeC0fePVMefJ1u7T8X640hoFMNBcYU5lJdT4rHKPlqDJFIU+C9SlRH1kxYX
+0x4EgzOxzLZfXmP0FoQpeCC4kOqpLOteFHylLHFr9RItKHmFdvBiPCGTjuAb71c
dtPJLx+LgXoHagvOI9wc1aS6AAsVove1PRJtAaj7jNK5SJX+o0chT2rWXkw2HHYy
sJMLb5ePdwP15IsuUwkN8XDyWsnEfPyM+hIgoPByyNZolEsrzXKlpAl62I5cCI/D
8LHgLmAhKEsRwbvvy9EhgzV5+qAS5ABL6T1BB55ZRKZ8omkMq5AXeHGhgYwISeYp
AdM4DTI0kWZ7yNgrJxsIMtewPgR2pI1Cgf+B7xzZHfP94+ogSKEq/jdvgJEml9St
INgTr6jypYWrNIjoJenf
=cbGv
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.