Vincent, > On 2007-07-26 10:16:07 +0200, Michael Kerrisk wrote: > > > No, this seems to have been fixed in the 2004 edition of POSIX (Issue > > > 6). See > > > > > > http://www.opengroup.org/onlinepubs/009695399/functions/utimes.html > > > > > > It only uses the term "null pointer". Since it is the standard > > > wording, the man pages should be fixed too. > > > > How do you deduce that it is the "standard: wording? Because > > it uses that terminology that on one page? > > The following pages also use the term "null pointer": > http://www.opengroup.org/onlinepubs/009695399/functions/malloc.html > http://www.opengroup.org/onlinepubs/009695399/functions/fopen.html > http://www.opengroup.org/onlinepubs/009695399/functions/free.html > > http://www.opengroup.org/onlinepubs/009695399/functions/xsh_chap02_01.html > for instance (and I didn't find any other wording).
Well, I find numerous other wordings... > > The wording of this particular spec may have changed (I'll > > take your word for it), > > This is not a particular spec. (By "particular spec", I meant the specification of utimes(); I'm not sure if that was clear...) > > but that doesn't change the point that the terms that I mentioned > > above are used throughout the standard (even in the POSIX.1 revision > > that is currently in progress.. I sere no problem with them. > > This is wrong. The current revision (P1003.1 Draft 3, 15 June 2007) > uses the term "null pointer" (defined in 3.243). Of course it uses that term. But it *ALSO* uses other terminology. Frequently. See below. Cheers, Michael $ grep 'is NULL' austin-d3r.txt | sed 's/ */ /' 16320 is NULL, the behavior shall be as if the thread were created with the detachstate attribute set to 19353 asynchronous I/O control block for a particular request to be canceled. If aiocbp is NULL, then 22205 resolution of the specified clock shall be stored in the location pointed to by res. If res is NULL, 22362 the rmtp argument is NULL, the remaining time is not returned. The absolute clock_nanosleep( ) 23634 current controlling terminal for the current process. If s is NULL, the return value of ctermid( ) is 34008 terminated string. If the node argument is NULL or the nodelen argument is zero, the node name 34014 as a null-terminated string. If the service argument is NULL or the servicelen argument is zero, 39621 sig is NULL, then no asynchronous notification shall occur. If sig is not NULL, asynchronous 42871 If notification is NULL and the process is currently registered for notification by the specified 42888 [EINVAL] The notification argument is NULL and the process is currently not registered. 42962 unspecified. If attr is NULL, the message queue shall be created with 43914 point to the same object. If the rmtp argument is NULL, the remaining time is not returned. 45858 If the value of the attrp pointer is NULL, then the default values are used. 47256 call. If the argument attr is NULL, the default attributes shall be used. The attr attributes object 50014 attributes referenced by attr. If attr is NULL, the default condition variable attributes shall be 50545 process. If attr is NULL, the default attributes shall be used. If the attributes specified by attr are 51432 specified by attr. If attr is NULL, the default mutex attributes are used; the effect shall be the 52668 attr. If attr is NULL, the default read-write lock attributes shall be used; the effect is the same as 60897 argument is NULL, so the POSIX Threads Extension sigwait( ) function can be implemented as a 64135 when command is NULL. 64204 It was explicitly decided that when command is NULL, system( ) should not be required to check 65322 463) when the timer expires. If the evp argument is NULL, the effect is as if the evp argument 119126 lock attributes object is NULL. In cases where the default attributes are appropriate, the $ grep 'NULL pointer' austin-d3r.txt | sed 's/ */ /' 19672 NULL pointers, which are ignored. If this array contains pointers that refer to aiocb structures 33312 suggested for the size of this buffer. A NULL pointer shall be returned at the location pointed to | 33437 value suggested for the size of this buffer. A NULL pointer is returned at the location pointed to | 34603 suggested for the size of this buffer. A NULL pointer shall be returned at the location pointed to | 34733 suggested for the size of this buffer. A NULL pointer shall be returned at the location pointed to | 36251 NULL pointer and set errno to indicate the error. 36282 An array of structures identifying local interfaces. A NULL pointer is returned upon an error, 39653 If sig->sigev_notify is SIGEV_THREAD and sig->sigev_notify_attributes is a non-NULL pointer 58473 NULL pointer as the locale. The NULL pointer is a special directive to setlocale( ) that tells it to 58494 If the string does not correspond to a valid locale, setlocale( ) shall return a NULL pointer 60828 MON immediately with an error. If timeout is the NULL pointer, the behavior is unspecified. If the 60904 with a NULL pointer for timeout. 67541 receive a non-NULL pointer to a siginfo_t structure that describes a child process for $ grep 'is not NULL' austin-d3r.txt | sed 's/ */ /' 19361 If aiocbp is not NULL, then if fildes does not have the same value as the file descriptor with which 19665 function, or, if timeout is not NULL, until the time interval specified by timeout has passed. If any 22204 implementation-defined and cannot be set by a process. If the argument res is not NULL, the 39621 sig is NULL, then no asynchronous notification shall occur. If sig is not NULL, asynchronous 42864 If the argument notification is not NULL, this function shall register the calling process to be 42991 [EINVAL] O_CREAT was specified in oflag, the value of attr is not NULL, and either 43053 If the argument msg_prio is not NULL, the priority of the selected message shall be stored in the 45797 If file_actions is not NULL, then the file descriptors open in the child process shall be those open 45896 If the file_actions argument is not NULL, and specifies any close, dup2, or open actions to be 65338 TSA If evp->sigev_sigev_notify is SIGEV_THREAD and sev->sigev_notify_attributes is not NULL, if the 65507 If the argument ovalue is not NULL, the timer_settime( ) function shall store, in the location $ grep 'non-NULL' austin-d3r.txt | sed 's/ */ /' 17513 any) associated with thread-specific data keys for which the thread has non-NULL values will 22360 argument is non-NULL, the timespec structure referenced by it shall be updated to contain the 23601 functions, it shall ensure that the ctermid( ) function is called with a non-NULL parameter. 34006 If the node argument is non-NULL and the nodelen argument is non-zero, then the node argument 34012 If the service argument is non-NULL and the servicelen argument is non-zero, then the service 39653 If sig->sigev_notify is SIGEV_THREAD and sig->sigev_notify_attributes is a non-NULL pointer 42963 implementation-defined default message queue attributes. If attr is non-NULL 42967 non-NULL, but the calling process does not have the appropriate privilege on 43233 If omqstat is non-NULL, the mq_setattr( ) function shall store, in the location referenced by 43911 value of -1 and set errno to indicate the interruption. If the rmtp argument is non-NULL, the 45868 child process to the parent process, in the variable pointed to by a non-NULL pid argument, and 45870 value stored into the variable pointed to by a non-NULL pid is unspecified, and an error number 51011 [ENOMEM] Insufficient memory exists to associate the non-NULL value with the key. 51037 to ``to associate the non-NULL value with the key''. 51050 pthread_join( ) call with a non-NULL value_ptr argument, the value passed to pthread_exit( ) by 51153 value has a non-NULL destructor pointer, and the thread has a non-NULL value associated with 51157 If, after all the destructors have been called for all non-NULL values with associated destructors, 51158 there are still some non-NULL values with associated destructors, then the process is repeated. 51160 outstanding non-NULL values, there are still some non-NULL values with associated 51162 destructors until no non-NULL values with associated destructors exist, even though this might 51312 threads with non-NULL data and potentially keep them from creating more thread- 60838 NULL. If the info argument is non-NULL, the sigwaitinfo( ) function shall be equivalent to 60841 signal, the first such queued value shall be dequeued and, if the info argument is non-NULL, the 65320 The evp argument, if non-NULL, points to a sigevent structure. This structure, allocated by the 65783 tmpnam( ) function is called with a non-NULL parameter. 67541 receive a non-NULL pointer to a siginfo_t structure that describes a child process for 67710 functions, the application shall ensure that the wcrtomb( ) function is called with a non-NULL ps 68356 functions, the application shall ensure that the wcsrtombs( ) function is called with a non-NULL 119328 applications when their arguments are non-NULL. -- Michael Kerrisk maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 Want to help with man page maintenance? Grab the latest tarball at http://www.kernel.org/pub/linux/docs/manpages , read the HOWTOHELP file and grep the source files for 'FIXME'. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
