A NOTE has been added to this issue. 
====================================================================== 
http://austingroupbugs.net/view.php?id=1280 
====================================================================== 
Reported By:                dalias
Assigned To:                
====================================================================== 
Project:                    1003.1(2016)/Issue7+TC2
Issue ID:                   1280
Category:                   System Interfaces
Type:                       Clarification Requested
Severity:                   Editorial
Priority:                   normal
Status:                     New
Name:                       Rich Felker 
Organization:               musl libc 
User Reference:              
Section:                    utimensat/futimens 
Page Number:                ? 
Line Number:                ? 
Interp Status:              --- 
Final Accepted Text:         
====================================================================== 
Date Submitted:             2019-08-16 22:45 UTC
Last Modified:              2019-08-19 08:51 UTC
====================================================================== 
Summary:                    Error requirements with UTIME_OMIT
====================================================================== 

---------------------------------------------------------------------- 
 (0004529) geoffclare (manager) - 2019-08-19 08:51
 http://austingroupbugs.net/view.php?id=1280#c4529 
---------------------------------------------------------------------- 
I believe the intention was to allow implementations to notice that both
times specify UTIME_OMIT and return straight away without making any use of
the path or fd. So the "may" in the DESCRIPTION is right and the ERRORS
section needs updating.

Rather than having to repeat most errors in "shall fail" and "may fail"
forms, perhaps we can do something like this in the intro to each set of
errors that are currently "shall fail":
<blockquote>The <i>utimes</i>() function shall fail, the <i>futimens</i>()
and <i>utimensat</i>() functions shall fail in the case that the
<i>times</i> argument does not have both <i>tv_nsec</i> fields set to
UTIME_OMIT, and the <i>futimens</i>() and <i>utimensat</i>() functions may
fail in the case that the <i>times</i> argument has both <i>tv_nsec</i>
fields set to UTIME_OMIT, if:</blockquote> 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2019-08-16 22:45 dalias         New Issue                                    
2019-08-16 22:45 dalias         Name                      => Rich Felker     
2019-08-16 22:45 dalias         Organization              => musl libc       
2019-08-16 22:45 dalias         Section                   => utimensat/futimens
2019-08-16 22:45 dalias         Page Number               => ?               
2019-08-16 22:45 dalias         Line Number               => ?               
2019-08-19 08:51 geoffclare     Note Added: 0004529                          
======================================================================


Reply via email to