Here's a quick description of what they are and a link to the relevant man pages:
"An argz vector is a pointer to a character buffer together with a length. The intended interpretation of the character buffer is array of strings, where the strings are separated by NUL bytes. If the length is nonzero, the last byte of the buffer must be a NUL."
"An envz vector is a special argz vector, namely one where the strings have the form "name=value". Everything after the first '=' is considered to be the value. If there is no '=', the value is taken to be NULL. (While the value in case of a trailing '=' is the empty string "".) "
http://www.gnu.org/manual/glibc-2.2.5/html_node/Argz-Functions.html http://www.gnu.org/manual/glibc-2.2.5/html_node/Envz-Functions.html
Since no-one bothered to document the functions for the newlib manual, I suggest that we just add the relevant manpages from the linux manpages project, since the implementation is compatible. I'll see about contributing proper source documentation in the future so that they get documented in the newlib info pages.
So as you've probably gathered, these functions are an invention of Glibc, but they have been ported to BSD. They are also used in quite a few gnu packages, if available on the host system. I find them useful and good for glibc interoperability, costing very little in terms of overhead.
I was required to make the symbol alias because some configure programs look for functions with a "__" prefix, others look for functions without the prefix. Either way, it seems relatively innocuous to make the alias, so that's the reasoning behind that.
Can this be considered for last-minute submission to 1.5.1? Thanks!
Cheers, Nicholas
BTW- I have ported some more widechar (wcsxfrm) and common functions (i.e. basename & dirname) to newlib, and will submit these patches once my copyright assignment is processed.
2003-07-27 Nicholas Wourms <[EMAIL PROTECTED]>
* cygwin.din: Export argz_add argz_add_sep argz_append argz_count
argz_create argz_create_sep argz_delete argz_extract argz_insert
argz_next argz_replace argz_stringify envz_add envz_entry envz_get
envz_merge envz_remove envz_strip
* include/cygwin/version.h: Bump api minor number.
Index: cygwin.din
===================================================================
RCS file: /cvs/src/src/winsup/cygwin/cygwin.din,v
retrieving revision 1.92
diff -u -3 -p -r1.92 cygwin.din
--- cygwin.din 25 Jul 2003 16:13:11 -0000 1.92
+++ cygwin.din 27 Jul 2003 23:08:12 -0000
@@ -141,6 +141,30 @@ alarm
_alarm = alarm
alphasort
_alphasort = alphasort
+argz_add
+__argz_add = argz_add
+argz_add_sep
+__argz_add_sep = argz_add_sep
+argz_append
+__argz_append = argz_append
+argz_count
+__argz_count = argz_count
+argz_create
+__argz_create = argz_create
+argz_create_sep
+__argz_create_sep = argz_create_sep
+argz_delete
+__argz_delete = argz_delete
+argz_extract
+__argz_extract = argz_extract
+argz_insert
+__argz_insert = argz_insert
+argz_next
+__argz_next = argz_next
+argz_replace
+__argz_replace = argz_replace
+argz_stringify
+__argz_stringify = argz_stringify
asctime
_asctime = asctime
asctime_r
@@ -362,6 +390,18 @@ endpwent
_endpwent = endpwent
endutent
_endutent = endutent
+envz_add
+__envz_add = envz_add
+envz_entry
+__envz_entry = envz_entry
+envz_get
+__envz_get = envz_get
+envz_merge
+__envz_merge = envz_merge
+envz_remove
+__envz_remove = envz_remove
+envz_strip
+__envz_strip = envz_strip
erand48
_erand48 = erand48
erf
Index: include/cygwin/version.h
===================================================================
RCS file: /cvs/src/src/winsup/cygwin/include/cygwin/version.h,v
retrieving revision 1.125
diff -u -3 -p -r1.125 version.h
--- include/cygwin/version.h 25 Jul 2003 16:13:12 -0000 1.125
+++ include/cygwin/version.h 27 Jul 2003 23:08:12 -0000
@@ -210,12 +210,17 @@ details. */
88: Export _getreent
89: Export __mempcpy
90: Export _fopen64
+ 91: Export argz_add argz_add_sep argz_append argz_count argz_create
+ argz_create_sep argz_delete argz_extract argz_insert
+ argz_next argz_replace argz_stringify envz_add envz_entry
+ envz_get envz_merge envz_remove envz_strip
+
*/
/* Note that we forgot to bump the api for ualarm, strtoll, strtoull */
#define CYGWIN_VERSION_API_MAJOR 0
-#define CYGWIN_VERSION_API_MINOR 90
+#define CYGWIN_VERSION_API_MINOR 91
/* There is also a compatibity version number associated with the
shared memory regions. It is incremented when incompatible
