GDB 7.6.50

libiberty/functions.texi

 @c Automatically generated from *.c and others (the comments before
 @c each entry tell you which file and where in that file).  DO NOT EDIT!
 @c Edit the *.c files, configure with --enable-maintainer-mode,
 @c run 'make stamp-functions' and gather-docs will build a new copy.
 
 @c alloca.c:26
 @deftypefn Replacement void* alloca (size_t @var{size})
 
 This function allocates memory which will be automatically reclaimed
 after the procedure exits.  The @libib{} implementation does not free
@@ skipping 66 matching lines @@
 @var{base} for a member that matches the object pointed to by @var{key}.
 The size of each member is specified by @var{size}.  The array contents
 should be sorted in ascending order according to the @var{compar}
 comparison function.  This routine should take two arguments pointing to
 the @var{key} and to an array member, in that order, and should return an
 integer less than, equal to, or greater than zero if the @var{key} object
 is respectively less than, matching, or greater than the array member.
 
 @end deftypefn
 
-@c argv.c:142
+@c argv.c:135
 @deftypefn Extension char** buildargv (char *@var{sp})
 
 Given a pointer to a string, parse the string extracting fields
 separated by whitespace and optionally enclosed within either single
 or double quotes (which are stripped off), and build a vector of
 pointers to copies of the string for each field.  The input string
 remains unchanged.  The last element of the vector is followed by a
 @code{NULL} element.
 
 All of the memory for the pointer array and copies of the string
-is obtained from @code{malloc}.  All of the memory can be returned to the
+is obtained from @code{xmalloc}.  All of the memory can be returned to the
 system with the single function call @code{freeargv}, which takes the
 returned result of @code{buildargv}, as it's argument.
 
 Returns a pointer to the argument vector if successful.  Returns
 @code{NULL} if @var{sp} is @code{NULL} or if there is insufficient
 memory to complete building the argument vector.
 
 If the input is a null string (as opposed to a @code{NULL} pointer),
 then buildarg returns an argument vector that has one arg, a null
 string.
@@ skipping 50 matching lines @@
 @deftypefn Extension char* concat (const char *@var{s1}, const char *@var{s2}, @
   @dots{}, @code{NULL})
 
 Concatenate zero or more of strings and return the result in freshly
 @code{xmalloc}ed memory.  Returns @code{NULL} if insufficient memory is
 available.  The argument list is terminated by the first @code{NULL}
 pointer encountered.  Pointers to empty strings are ignored.
 
 @end deftypefn
 
+@c argv.c:470
+@deftypefn Extension int countargv (char **@var{argv})
+
+Return the number of elements in @var{argv}.
+Returns zero if @var{argv} is NULL.
+
+@end deftypefn
+
 @c crc32.c:141
 @deftypefn Extension {unsigned int} crc32 (const unsigned char *@var{buf}, @
   int @var{len}, unsigned int @var{init})
 
 Compute the 32-bit CRC of @var{buf} which has length @var{len}.  The
 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
@@ skipping 38 matching lines @@
 should check the size of the table (@code{sys_nerr}) before indexing
 it, since new error codes may be added to the system before they are
 added to the table.  Thus @code{sys_nerr} might be smaller than value
 implied by the largest @code{errno} value defined in @code{<errno.h>}.
 
 We return the maximum value that can be used to obtain a meaningful
 symbolic name or message.
 
 @end deftypefn
 
-@c argv.c:361
+@c argv.c:341
 @deftypefn Extension void expandargv (int *@var{argcp}, char ***@var{argvp})
 
 The @var{argcp} and @code{argvp} arguments are pointers to the usual
 @code{argc} and @code{argv} arguments to @code{main}.  This function
 looks for arguments that begin with the character @samp{@@}.  Any such
 arguments are interpreted as ``response files''.  The contents of the
 response file are interpreted as additional command line options.  In
 particular, the file is separated into whitespace-separated strings;
 each such string is taken as a command-line option.  The new options
 are inserted in place of the option naming the response file, and
@@ skipping 51 matching lines @@
 @var{s2}.
 
 This function does not normalize file names.  As a result, this function
 will treat filenames that are spelled differently as different even in
 the case when the two filenames point to the same underlying file.
 However, it does handle the fact that on DOS-like file systems, forward
 and backward slashes are equal.
 
 @end deftypefn
 
-@c filename_cmp.c:81
+@c filename_cmp.c:178
+@deftypefn Extension int filename_eq (const void *@var{s1}, const void *@var{s2})
+
+Return non-zero if file names @var{s1} and @var{s2} are equivalent.
+This function is for use with hashtab.c hash tables.
+
+@end deftypefn
+
+@c filename_cmp.c:147
+@deftypefn Extension hashval_t filename_hash (const void *@var{s})
+
+Return the hash value for file name @var{s} that will be compared
+using filename_cmp.
+This function is for use with hashtab.c hash tables.
+
+@end deftypefn
+
+@c filename_cmp.c:89
 @deftypefn Extension int filename_ncmp (const char *@var{s1}, const char *@var{s2}, size_t @var{n})
 
 Return zero if the two file names @var{s1} and @var{s2} are equivalent
 in range @var{n}.
 If not equivalent, the returned value is similar to what @code{strncmp}
 would return.  In other words, it returns a negative value if @var{s1}
 is less than @var{s2}, or a positive value if @var{s2} is greater than
 @var{s2}.
 
 This function does not normalize file names.  As a result, this function
@@ skipping 59 matching lines @@
 @deftypefn Extension {FILE *} fopen_unlocked (const char *@var{path}, @
   const char * @var{mode})
 
 Opens and returns a @code{FILE} pointer via @code{fopen}.  If the
 operating system supports it, ensure that the stream is setup to avoid
 any multi-threaded locking.  Otherwise return the @code{FILE} pointer
 unchanged.
 
 @end deftypefn
 
-@c argv.c:97
+@c argv.c:90
 @deftypefn Extension void freeargv (char **@var{vector})
 
 Free an argument vector that was built using @code{buildargv}.  Simply
 scans through @var{vector}, freeing the memory for each argument until
 the terminating @code{NULL} is found, and then frees @var{vector}
 itself.
 
 @end deftypefn
 
 @c fopen_unlocked.c:59
@@ skipping 1068 matching lines @@
 @var{tree_allocate_fn} and @var{node_allocate_fn} to use for allocating the
 tree itself and its nodes respectively.  This is useful when variables of
 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.
 
 @end deftypefn
 
+@c stack-limit.c:28
+@deftypefn Extension void stack_limit_increase (unsigned long @var{pref})
+
+Attempt to increase stack size limit to @var{pref} bytes if possible.
+
+@end deftypefn
+
 @c stpcpy.c:23
 @deftypefn Supplemental char* stpcpy (char *@var{dst}, const char *@var{src})
 
 Copies the string @var{src} into @var{dst}.  Returns a pointer to
 @var{dst} + strlen(@var{src}).
 
 @end deftypefn
 
 @c stpncpy.c:23
 @deftypefn Supplemental char* stpncpy (char *@var{dst}, const char *@var{src}, @
@@ skipping 89 matching lines @@
 
 @c strndup.c:23
 @deftypefn Extension char* strndup (const char *@var{s}, size_t @var{n})
 
 Returns a pointer to a copy of @var{s} with at most @var{n} characters
 in memory obtained from @code{malloc}, or @code{NULL} if insufficient
 memory was available.  The result is always NUL terminated.
 
 @end deftypefn
 
+@c strnlen.c:6
+@deftypefn Supplemental size_t strnlen (const char *@var{s}, size_t @var{maxlen})
+
+Returns the length of @var{s}, as with @code{strlen}, but never looks
+past the first @var{maxlen} characters in the string.  If there is no
+'\0' character in the first @var{maxlen} characters, returns
+@var{maxlen}.
+
+@end deftypefn
+
 @c strrchr.c:6
 @deftypefn Supplemental char* strrchr (const char *@var{s}, int @var{c})
 
 Returns a pointer to the last occurrence of the character @var{c} in
 the string @var{s}, or @code{NULL} if not found.  If @var{c} is itself the
 null character, the results are undefined.
 
 @end deftypefn
 
 @c strsignal.c:383
@@ skipping 134 matching lines @@
 strverscmp ("part1_f012", "part1_f01")
     @result{} >0   // @r{two fractional parts.}
 strverscmp ("foo.009", "foo.0")
     @result{} <0   // @r{idem, but with leading zeroes only.}
 @end smallexample
 
 This function is especially useful when dealing with filename sorting,
 because filenames frequently hold indices/version numbers.
 @end deftypefun
 
+@c timeval-utils.c:43
+@deftypefn Extension void timeval_add (struct timeval *@var{a}, @
+  struct timeval *@var{b}, struct timeval *@var{result})
+
+Adds @var{a} to @var{b} and stores the result in @var{result}.
+
+@end deftypefn
+
+@c timeval-utils.c:67
+@deftypefn Extension void timeval_sub (struct timeval *@var{a}, @
+  struct timeval *@var{b}, struct timeval *@var{result})
+
+Subtracts @var{b} from @var{a} and stores the result in @var{result}.
+
+@end deftypefn
+
 @c tmpnam.c:3
 @deftypefn Supplemental char* tmpnam (char *@var{s})
 
 This function attempts to create a name for a temporary file, which
 will be a valid file name yet not exist when @code{tmpnam} checks for
 it.  @var{s} must point to a buffer of at least @code{L_tmpnam} bytes,
 or be @code{NULL}.  Use of this function creates a security risk, and it must
 not be used in new projects.  Use @code{mkstemp} instead.
 
 @end deftypefn
@@ skipping 81 matching lines @@
 
 @c waitpid.c:3
 @deftypefn Supplemental int waitpid (int @var{pid}, int *@var{status}, int)
 
 This is a wrapper around the @code{wait} function.  Any ``special''
 values of @var{pid} depend on your implementation of @code{wait}, as
 does the return value.  The third argument is unused in @libib{}.
 
 @end deftypefn
 
-@c argv.c:306
+@c argv.c:286
 @deftypefn Extension int writeargv (const char **@var{argv}, FILE *@var{file})
 
 Write each member of ARGV, handling all necessary quoting, to the file
 named by FILE, separated by whitespace.  Return 0 on success, non-zero
 if an error occurred while writing to FILE.
 
 @end deftypefn
 
 @c xatexit.c:11
 @deftypefun int xatexit (void (*@var{fn}) (void))
@@ skipping 88 matching lines @@
 @c xstrndup.c:23
 @deftypefn Replacement char* xstrndup (const char *@var{s}, size_t @var{n})
 
 Returns a pointer to a copy of @var{s} with at most @var{n} characters
 without fail, using @code{xmalloc} to obtain memory.  The result is
 always NUL terminated.
 
 @end deftypefn