* thread.cc: Update comment listing cancellation points per POSIX.

winsup/cygwin/ChangeLog

@@ -1,3 +1,7 @@
+2011-04-29  Corinna Vinschen  <corinna@vinschen.de>
+
+	* thread.cc: Update comment listing cancellation points per POSIX.
+
 2011-04-29  Corinna Vinschen  <corinna@vinschen.de>
 
 	* advapi32.cc: Add comment.

winsup/cygwin/thread.cc

@@ -562,27 +562,42 @@ pthread::cancel ()
   ResumeThread (win32_obj_id);
 
   return 0;
-/*
+}
-  TODO: insert  pthread_testcancel into the required functions
+
-  the required function list is: *indicates done, X indicates not present in cygwin.
+/* TODO: Insert pthread_testcancel into the required functions.
+
+   Here are the lists of required and optional functions per POSIX.1-2001
+   and POSIX.1-2008. A start (*) indicates that the Cygwin function already
+   is a cancellation point (aka "calls pthread_testcancel").
+
+   Required cancellation points:
+
+      accept ()
       aio_suspend ()
+      clock_nanosleep ()
     * close ()
+      connect ()
     * creat ()
-fcntl ()
+      fcntl () F_SETLKW
+      fdatasync ()
       fsync ()
       getmsg ()
       getpmsg ()
-lockf ()
+      lockf () F_LOCK
-mq_receive ()
+    * mq_receive ()
-mq_send ()
+    * mq_send ()
+    * mq_timedreceive ()
+    * mq_timedsend ()
       msgrcv ()
       msgsnd ()
       msync ()
       nanosleep ()
       open ()
+      openat ()
     * pause ()
       poll ()
       pread ()
+      pselect ()
     * pthread_cond_timedwait ()
     * pthread_cond_wait ()
     * pthread_join ()
@@ -592,8 +607,15 @@ putpmsg ()
       pwrite ()
       read ()
       readv ()
+      recv ()
+      recvfrom ()
+      recvmsg ()
       select ()
+    * sem_timedwait ()
     * sem_wait ()
+      send ()
+      sendmsg ()
+      sendto ()
     * sigpause ()
     * sigsuspend ()
       sigtimedwait ()
@@ -610,13 +632,21 @@ waitid ()
       write ()
       writev ()
 
-the optional list is:
+   Optional cancellation points:
+
+      access ()
+      asctime ()
+      asctime_r ()
       catclose ()
       catgets ()
       catopen ()
+      chmod ()
+      chown ()
       closedir ()
       closelog ()
       ctermid ()
+      ctime ()
+      ctime_r ()
       dbm_close ()
       dbm_delete ()
       dbm_fetch ()
@@ -625,18 +655,30 @@ dbm_open ()
       dbm_store ()
       dlclose ()
       dlopen ()
+      dprintf ()
       endgrent ()
+      endhostent ()
+      endnetent ()
+      endprotoent ()
       endpwent ()
+      endservent ()
       endutxent ()
+      faccessat ()
+      fchmod ()
+      fchmodat ()
+      fchown ()
+      fchownat ()
       fclose ()
-fcntl ()
+      fcntl () (any value)
       fflush ()
       fgetc ()
       fgetpos ()
       fgets ()
       fgetwc ()
       fgetws ()
+      fmtmsg ()
       fopen ()
+      fpathconf ()
       fprintf ()
       fputc ()
       fputs ()
@@ -648,35 +690,56 @@ fscanf ()
       fseek ()
       fseeko ()
       fsetpos ()
+      fstat ()
+      fstatat ()
       ftell ()
       ftello ()
       ftw ()
+      futimens ()
       fwprintf ()
       fwrite ()
       fwscanf ()
+      getaddrinfo ()
       getc ()
       getc_unlocked ()
       getchar ()
       getchar_unlocked ()
       getcwd ()
       getdate ()
+      getdelim ()
       getgrent ()
       getgrgid ()
       getgrgid_r ()
       getgrnam ()
       getgrnam_r ()
+      gethostbyaddr ()
+      gethostbyname ()
+      gethostent ()
+      gethostid ()
+      gethostname ()
+      getline ()
       getlogin ()
       getlogin_r ()
+      getnameinfo ()
+      getnetbyaddr ()
+      getnetbyname ()
+      getnetent ()
+      getopt () (if opterr is nonzero)
+      getprotobyname ()
+      getprotobynumber ()
+      getprotoent ()
       getpwent ()
     * getpwnam ()
     * getpwnam_r ()
     * getpwuid ()
     * getpwuid_r ()
       gets ()
+      getservbyname ()
+      getservbyport ()
+      getservent ()
       getutxent ()
       getutxid ()
       getutxline ()
-getw ()
       getwc ()
       getwchar ()
       getwd ()
@@ -684,58 +747,123 @@ glob ()
       iconv_close ()
       iconv_open ()
       ioctl ()
+      link ()
+      linkat ()
+      lio_listio ()
+      localtime ()
+      localtime_r ()
+      lockf ()
       lseek ()
+      lstat ()
+      mkdir ()
+      mkdirat ()
+      mkdtemp ()
+      mkfifo ()
+      mkfifoat ()
+      mknod ()
+      mknodat ()
       mkstemp ()
+      mktime ()
       nftw ()
       opendir ()
       openlog ()
+      pathconf ()
       pclose ()
       perror ()
       popen ()
+      posix_fadvise ()
+      posix_fallocate ()
+      posix_madvise ()
+      posix_openpt ()
+      posix_spawn ()
+      posix_spawnp ()
+      posix_trace_clear ()
+      posix_trace_close ()
+      posix_trace_create ()
+      posix_trace_create_withlog ()
+      posix_trace_eventtypelist_getnext_id ()
+      posix_trace_eventtypelist_rewind ()
+      posix_trace_flush ()
+      posix_trace_get_attr ()
+      posix_trace_get_filter ()
+      posix_trace_get_status ()
+      posix_trace_getnext_event ()
+      posix_trace_open ()
+      posix_trace_rewind ()
+      posix_trace_set_filter ()
+      posix_trace_shutdown ()
+      posix_trace_timedgetnext_event ()
+      posix_typed_mem_open ()
       printf ()
+      psiginfo ()
+      psignal ()
+      pthread_rwlock_rdlock ()
+      pthread_rwlock_timedrdlock ()
+      pthread_rwlock_timedwrlock ()
+      pthread_rwlock_wrlock ()
       putc ()
       putc_unlocked ()
       putchar ()
       putchar_unlocked ()
       puts ()
       pututxline ()
-putw ()
       putwc ()
       putwchar ()
       readdir ()
       readdir_r ()
+      readlink ()
+      readlinkat ()
       remove ()
       rename ()
+      renameat ()
       rewind ()
       rewinddir ()
+      scandir ()
       scanf ()
       seekdir ()
       semop ()
       setgrent ()
+      sethostent ()
+      setnetent ()
+      setprotoent ()
       setpwent ()
+      setservent ()
       setutxent ()
+      sigpause ()
+      stat ()
       strerror ()
+      strerror_r ()
+      strftime ()
+      symlink ()
+      symlinkat ()
+      sync ()
       syslog ()
       tmpfile ()
       tmpnam ()
       ttyname ()
       ttyname_r ()
+      tzset ()
       ungetc ()
       ungetwc ()
       unlink ()
+      unlinkat ()
+      utime ()
+      utimensat ()
+      utimes ()
+      vdprintf ()
       vfprintf ()
       vfwprintf ()
       vprintf ()
       vwprintf ()
+      wcsftime ()
+      wordexp ()
       wprintf ()
       wscanf ()
 
-Note, that for fcntl (), for any value of the cmd argument.
+   An implementation may also mark other functions not specified in the
-
+   standard as cancellation points.  In particular, an implementation is
-And we must not introduce cancellation points anywhere else that's part of the posix or
+   likely to mark any nonstandard function that may block as a
-opengroup specs.
+   cancellation point. */
- */
-}
 
 void
 pthread::testcancel ()