API compatibility documentation change

Corinna Vinschen corinna-cygwin@cygwin.com
Wed Jun 20 14:54:00 GMT 2007


On Jun 20 07:33, Eric Blake wrote:
> According to Corinna Vinschen on 6/5/2007 4:15 AM:
> 
> Sorry for the long delay (and yay to have my cable back up)...

So soon? ;)

> > The new layout only mentions the variables and functions in relation to
> > the standards they conform to, and for every standard the APIs are
> > listed in alphabetical order.  Every section is related to another
> > standard.
> 
> Looks nice!

I'm glad to read that.

> > As soon as SUSv4 is out (whenever this will happen), this document
> > should be reworked to list SUSv4 instead of SUSv3.  I'm pretty sure this
> > won't be such a lot of work anymore.
> 
> Here's the list of functions being added by the next revision of POSIX,
> which I'm sure will feed SUSv4...

Cool!  Thanks for this preparatory work.  It will help a lot when
it's time to change the document.  A couple of comments related to
the availability of the functions:

> faccessat - missing, but gnulib has an emulation
> fchmodat - missing, but gnulib has an emulation
> fchownat - missing, but gnulib has an emulation

For all ...at functions, Windows NT is capable of this functionality
since it's possible to open files related to a directory HANDLE.  The
problem is that this requires a couple of changes to the path handling
in Cygwin.  Right now paths are usually converted to full paths before
opening files.  path_conv will need to get an optional directory handle
to do all path handling relative to this directory.  That's some
work.

> fdopendir - missing, but gnulib has an emulation
> fexecve - missing

Both should be quite easy to implement.

> fmemopen - missing, but I'm working on it in newlib
> open_memstream - missing, but I'm working on it in newlib

How are you going to implement that?  mmap?  shm_open?

> stpcpy - missing, but gnulib has an emulation
> stpncpy - missing, but gnulib has an emulation

Shouldn't be too difficult.

> > Please, have a look into the new posix.sgml and give some feedback.  If
> > you have patches, even better.  Additional implementation notes would be
> > double plus good.
> 
> I'll keep that in mind when I post a patch that adds APIs to cygwin.din.

Thanks,
Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat



More information about the Cygwin-developers mailing list