aboutsummaryrefslogtreecommitdiff
path: root/libiberty/functions.texi
diff options
context:
space:
mode:
authorAlan Modra <amodra@gmail.com>2019-04-07 20:41:49 +0930
committerAlan Modra <amodra@gmail.com>2019-04-07 20:49:49 +0930
commit07ffcfecac22d21774a110db0f65f0387c8f1102 (patch)
tree120cc0b18f95144c1b03367a36ba6753db81e777 /libiberty/functions.texi
parent5f60cccf9db8b5f4aa4303f8e4ccc246f723fbe5 (diff)
downloadgdb-07ffcfecac22d21774a110db0f65f0387c8f1102.zip
gdb-07ffcfecac22d21774a110db0f65f0387c8f1102.tar.gz
gdb-07ffcfecac22d21774a110db0f65f0387c8f1102.tar.bz2
Merge libiberty from gcc
Diffstat (limited to 'libiberty/functions.texi')
-rw-r--r--libiberty/functions.texi57
1 files changed, 30 insertions, 27 deletions
diff --git a/libiberty/functions.texi b/libiberty/functions.texi
index 24dcc37..1784ae7 100644
--- a/libiberty/functions.texi
+++ b/libiberty/functions.texi
@@ -84,7 +84,7 @@ is respectively less than, matching, or greater than the array member.
@end deftypefn
-@c argv.c:135
+@c argv.c:138
@deftypefn Extension char** buildargv (char *@var{sp})
Given a pointer to a string, parse the string extracting fields
@@ -148,7 +148,7 @@ not recommended.
@end deftypefn
-@c make-temp-file.c:96
+@c make-temp-file.c:95
@deftypefn Replacement const char* choose_tmpdir ()
Returns a pointer to a directory path suitable for creating temporary
@@ -175,7 +175,7 @@ Concatenate zero or more of strings and return the result in freshly
@end deftypefn
-@c argv.c:470
+@c argv.c:487
@deftypefn Extension int countargv (char * const *@var{argv})
Return the number of elements in @var{argv}.
@@ -183,7 +183,7 @@ Returns zero if @var{argv} is NULL.
@end deftypefn
-@c crc32.c:141
+@c crc32.c:140
@deftypefn Extension {unsigned int} crc32 (const unsigned char *@var{buf}, @
int @var{len}, unsigned int @var{init})
@@ -192,10 +192,9 @@ starting value is @var{init}; this may be used to compute the CRC of
data split across multiple buffers by passing the return value of each
call as the @var{init} parameter of the next.
-This is intended to match the CRC used by the @command{gdb} remote
-protocol for the @samp{qCRC} command. In order to get the same
-results as gdb for a block of data, you must pass the first CRC
-parameter as @code{0xffffffff}.
+This is used by the @command{gdb} remote protocol for the @samp{qCRC}
+command. In order to get the same results as gdb for a block of data,
+you must pass the first CRC parameter as @code{0xffffffff}.
This CRC can be specified as:
@@ -212,7 +211,7 @@ make it easy to compose the values of multiple blocks.
@end deftypefn
-@c argv.c:52
+@c argv.c:59
@deftypefn Extension char** dupargv (char * const *@var{vector})
Duplicate an argument vector. Simply scans through @var{vector},
@@ -223,7 +222,7 @@ argument vector.
@end deftypefn
-@c strerror.c:567
+@c strerror.c:572
@deftypefn Extension int errno_max (void)
Returns the maximum @code{errno} value for which a corresponding
@@ -241,7 +240,7 @@ symbolic name or message.
@end deftypefn
-@c argv.c:341
+@c argv.c:344
@deftypefn Extension void expandargv (int *@var{argcp}, char ***@var{argvp})
The @var{argcp} and @code{argvp} arguments are pointers to the usual
@@ -410,7 +409,7 @@ unchanged.
@end deftypefn
-@c argv.c:90
+@c argv.c:93
@deftypefn Extension void freeargv (char **@var{vector})
Free an argument vector that was built using @code{buildargv}. Simply
@@ -431,7 +430,7 @@ unchanged.
@end deftypefn
-@c getruntime.c:82
+@c getruntime.c:86
@deftypefn Replacement long get_run_time (void)
Returns the time used so far, in microseconds. If possible, this is
@@ -515,7 +514,7 @@ systems.
@end deftypefn
-@c safe-ctype.c:25
+@c safe-ctype.c:24
@defvr Extension HOST_CHARSET
This macro indicates the basic character set and encoding used by the
host: more precisely, the encoding used for character constants in
@@ -537,7 +536,7 @@ nineteen EBCDIC varying characters is tested; exercise caution.)
@end ftable
@end defvr
-@c hashtab.c:328
+@c hashtab.c:327
@deftypefn Supplemental htab_t htab_create_typed_alloc (size_t @var{size}, @
htab_hash @var{hash_f}, htab_eq @var{eq_f}, htab_del @var{del_f}, @
htab_alloc @var{alloc_tab_f}, htab_alloc @var{alloc_f}, @
@@ -586,7 +585,7 @@ struct qelem @{
@end deftypefn
-@c safe-ctype.c:46
+@c safe-ctype.c:45
@deffn Extension ISALPHA (@var{c})
@deffnx Extension ISALNUM (@var{c})
@deffnx Extension ISBLANK (@var{c})
@@ -636,7 +635,7 @@ false for characters with numeric values from 128 to 255.
@end itemize
@end deffn
-@c safe-ctype.c:95
+@c safe-ctype.c:94
@deffn Extension ISIDNUM (@var{c})
@deffnx Extension ISIDST (@var{c})
@deffnx Extension IS_VSPACE (@var{c})
@@ -684,7 +683,7 @@ components will be simplified. The returned value will be allocated using
@end deftypefn
-@c make-relative-prefix.c:24
+@c make-relative-prefix.c:23
@deftypefn Extension {const char*} make_relative_prefix (const char *@var{progname}, @
const char *@var{bin_prefix}, const char *@var{prefix})
@@ -710,7 +709,7 @@ relative prefix can be found, return @code{NULL}.
@end deftypefn
-@c make-temp-file.c:174
+@c make-temp-file.c:173
@deftypefn Replacement char* make_temp_file (const char *@var{suffix})
Return a temporary file name (as a string) or @code{NULL} if unable to
@@ -791,7 +790,7 @@ Sets the first @var{count} bytes of @var{s} to the constant byte
@end deftypefn
-@c mkstemps.c:58
+@c mkstemps.c:60
@deftypefn Replacement int mkstemps (char *@var{pattern}, int @var{suffix_len})
Generate a unique temporary file name from @var{pattern}.
@@ -1204,7 +1203,7 @@ deprecated in new programs in favor of @code{strrchr}.
@end deftypefn
-@c setenv.c:23
+@c setenv.c:22
@deftypefn Supplemental int setenv (const char *@var{name}, @
const char *@var{value}, int @var{overwrite})
@deftypefnx Supplemental void unsetenv (const char *@var{name})
@@ -1478,7 +1477,7 @@ valid until at least the next call.
@end deftypefn
-@c splay-tree.c:303
+@c splay-tree.c:305
@deftypefn Supplemental splay_tree splay_tree_new_with_typed_alloc @
(splay_tree_compare_fn @var{compare_fn}, @
splay_tree_delete_key_fn @var{delete_key_fn}, @
@@ -1495,7 +1494,11 @@ different types need to be allocated with different allocators.
The splay tree will use @var{compare_fn} to compare nodes,
@var{delete_key_fn} to deallocate keys, and @var{delete_value_fn} to
-deallocate values.
+deallocate values. Keys and values will be deallocated when the
+tree is deleted using splay_tree_delete or when a node is removed
+using splay_tree_remove. splay_tree_insert will release the previously
+inserted key and value using @var{delete_key_fn} and @var{delete_value_fn}
+if the inserted key is already found in the tree.
@end deftypefn
@@ -1549,7 +1552,7 @@ Returns a pointer to a copy of @var{s} in memory obtained from
@end deftypefn
-@c strerror.c:670
+@c strerror.c:675
@deftypefn Replacement {const char*} strerrno (int @var{errnum})
Given an error number returned from a system call (typically returned
@@ -1569,7 +1572,7 @@ valid until the next call to @code{strerrno}.
@end deftypefn
-@c strerror.c:603
+@c strerror.c:608
@deftypefn Supplemental char* strerror (int @var{errnoval})
Maps an @code{errno} number to an error message string, the contents
@@ -1698,7 +1701,7 @@ the location referenced by @var{endptr}.
@end deftypefn
-@c strerror.c:729
+@c strerror.c:734
@deftypefn Extension int strtoerrno (const char *@var{name})
Given the symbolic name of a error number (e.g., @code{EACCES}), map it
@@ -1914,7 +1917,7 @@ does the return value. The third argument is unused in @libib{}.
@end deftypefn
-@c argv.c:286
+@c argv.c:289
@deftypefn Extension int writeargv (char * const *@var{argv}, FILE *@var{file})
Write each member of ARGV, handling all necessary quoting, to the file