OpenCores
URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [gnu-src/] [gdb-6.8/] [libiberty/] [functions.texi] - Diff between revs 157 and 225

Go to most recent revision | Show entire file | Details | Blame | View Log

Rev 157 Rev 225
Line 156... Line 156...
This function is provided for backwards compatibility only.  Its use is
This function is provided for backwards compatibility only.  Its use is
not recommended.
not recommended.
 
 
@end deftypefn
@end deftypefn
 
 
@c make-temp-file.c:87
@c make-temp-file.c:95
@deftypefn Replacement char* choose_tmpdir ()
@deftypefn Replacement char* choose_tmpdir ()
 
 
Returns a pointer to a directory path suitable for creating temporary
Returns a pointer to a directory path suitable for creating temporary
files in.
files in.
 
 
Line 183... Line 183...
available.  The argument list is terminated by the first @code{NULL}
available.  The argument list is terminated by the first @code{NULL}
pointer encountered.  Pointers to empty strings are ignored.
pointer encountered.  Pointers to empty strings are ignored.
 
 
@end deftypefn
@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
 
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}.
 
 
 
@end deftypefn
 
 
@c argv.c:52
@c argv.c:52
@deftypefn Extension char** dupargv (char **@var{vector})
@deftypefn Extension char** dupargv (char **@var{vector})
 
 
Duplicate an argument vector.  Simply scans through @var{vector},
Duplicate an argument vector.  Simply scans through @var{vector},
duplicating each argument until the terminating @code{NULL} is found.
duplicating each argument until the terminating @code{NULL} is found.
Line 600... Line 615...
The return value is normally allocated via @code{malloc}.  If no
The return value is normally allocated via @code{malloc}.  If no
relative prefix can be found, return @code{NULL}.
relative prefix can be found, return @code{NULL}.
 
 
@end deftypefn
@end deftypefn
 
 
@c make-temp-file.c:137
@c make-temp-file.c:163
@deftypefn Replacement char* make_temp_file (const char *@var{suffix})
@deftypefn Replacement char* make_temp_file (const char *@var{suffix})
 
 
Return a temporary file name (as a string) or @code{NULL} if unable to
Return a temporary file name (as a string) or @code{NULL} if unable to
create one.  @var{suffix} is a suffix to append to the file name.  The
create one.  @var{suffix} is a suffix to append to the file name.  The
string is @code{malloc}ed, and the temporary file has been created.
string is @code{malloc}ed, and the temporary file has been created.
Line 641... Line 656...
Copies @var{length} bytes from memory region @var{in} to region
Copies @var{length} bytes from memory region @var{in} to region
@var{out}.  Returns a pointer to @var{out}.
@var{out}.  Returns a pointer to @var{out}.
 
 
@end deftypefn
@end deftypefn
 
 
 
@c memmem.c:20
 
@deftypefn Supplemental void* memmem (const void *@var{haystack}, size_t @var{haystack_len} const void *@var{needle}, size_t @var{needle_len})
 
 
 
Returns a pointer to the first occurrence of @var{needle} (length
 
@var{needle_len}) in @var{haystack} (length @var{haystack_len}).
 
Returns @code{NULL} if not found.
 
 
 
@end deftypefn
 
 
@c memmove.c:6
@c memmove.c:6
@deftypefn Supplemental void* memmove (void *@var{from}, const void *@var{to}, size_t @var{count})
@deftypefn Supplemental void* memmove (void *@var{from}, const void *@var{to}, size_t @var{count})
 
 
Copies @var{count} bytes from memory area @var{from} to memory area
Copies @var{count} bytes from memory area @var{from} to memory area
@var{to}, returning a pointer to @var{to}.
@var{to}, returning a pointer to @var{to}.
Line 686... Line 710...
@end deftypefn
@end deftypefn
 
 
@c pexecute.txh:266
@c pexecute.txh:266
@deftypefn Extension void pex_free (struct pex_obj @var{obj})
@deftypefn Extension void pex_free (struct pex_obj @var{obj})
 
 
Clean up and free all data associated with @var{obj}.
Clean up and free all data associated with @var{obj}.  If you have not
 
yet called @code{pex_get_times} or @code{pex_get_status}, this will
 
try to kill the subprocesses.
 
 
@end deftypefn
@end deftypefn
 
 
@c pexecute.txh:241
@c pexecute.txh:241
@deftypefn Extension int pex_get_status (struct pex_obj *@var{obj}, int @var{count}, int *@var{vector})
@deftypefn Extension int pex_get_status (struct pex_obj *@var{obj}, int @var{count}, int *@var{vector})
Line 812... Line 838...
 
 
@end itemize
@end itemize
 
 
@end deftypefn
@end deftypefn
 
 
@c pexecute.txh:272
@c pexecute.txh:274
@deftypefn Extension {const char *} pex_one (int @var{flags}, const char *@var{executable}, char * const *@var{argv}, const char *@var{pname}, const char *@var{outname}, const char *@var{errname}, int *@var{status}, int *@var{err})
@deftypefn Extension {const char *} pex_one (int @var{flags}, const char *@var{executable}, char * const *@var{argv}, const char *@var{pname}, const char *@var{outname}, const char *@var{errname}, int *@var{status}, int *@var{err})
 
 
An interface to permit the easy execution of a
An interface to permit the easy execution of a
single program.  The return value and most of the parameters are as
single program.  The return value and most of the parameters are as
for a call to @code{pex_run}.  @var{flags} is restricted to a
for a call to @code{pex_run}.  @var{flags} is restricted to a
Line 975... Line 1001...
form @code{VAR=VALUE}, with the exception of the last element that must be
form @code{VAR=VALUE}, with the exception of the last element that must be
@code{NULL}.
@code{NULL}.
 
 
@end deftypefn
@end deftypefn
 
 
@c pexecute.txh:284
@c pexecute.txh:286
@deftypefn Extension int pexecute (const char *@var{program}, char * const *@var{argv}, const char *@var{this_pname}, const char *@var{temp_base}, char **@var{errmsg_fmt}, char **@var{errmsg_arg}, int @var{flags})
@deftypefn Extension int pexecute (const char *@var{program}, char * const *@var{argv}, const char *@var{this_pname}, const char *@var{temp_base}, char **@var{errmsg_fmt}, char **@var{errmsg_arg}, int @var{flags})
 
 
This is the old interface to execute one or more programs.  It is
This is the old interface to execute one or more programs.  It is
still supported for compatibility purposes, but is no longer
still supported for compatibility purposes, but is no longer
documented.
documented.
 
 
@end deftypefn
@end deftypefn
 
 
@c strsignal.c:539
@c strsignal.c:541
@deftypefn Supplemental void psignal (int @var{signo}, char *@var{message})
@deftypefn Supplemental void psignal (int @var{signo}, char *@var{message})
 
 
Print @var{message} to the standard error, followed by a colon,
Print @var{message} to the standard error, followed by a colon,
followed by the description of the signal specified by @var{signo},
followed by the description of the signal specified by @var{signo},
followed by a newline.
followed by a newline.
Line 1003... Line 1029...
@samp{name=value} the string is added; if no @samp{=} is present the
@samp{name=value} the string is added; if no @samp{=} is present the
name is unset/removed.
name is unset/removed.
 
 
@end deftypefn
@end deftypefn
 
 
@c pexecute.txh:292
@c pexecute.txh:294
@deftypefn Extension int pwait (int @var{pid}, int *@var{status}, int @var{flags})
@deftypefn Extension int pwait (int @var{pid}, int *@var{status}, int @var{flags})
 
 
Another part of the old execution interface.
Another part of the old execution interface.
 
 
@end deftypefn
@end deftypefn
Line 1098... Line 1124...
@end deftypefn
@end deftypefn
 
 
@c snprintf.c:28
@c snprintf.c:28
@deftypefn Supplemental int snprintf (char *@var{buf}, size_t @var{n}, const char *@var{format}, ...)
@deftypefn Supplemental int snprintf (char *@var{buf}, size_t @var{n}, const char *@var{format}, ...)
 
 
This function is similar to sprintf, but it will print at most @var{n}
This function is similar to @code{sprintf}, but it will write to
characters.  On error the return value is -1, otherwise it returns the
@var{buf} at most @code{@var{n}-1} bytes of text, followed by a
number of characters that would have been printed had @var{n} been
terminating null byte, for a total of @var{n} bytes.
sufficiently large, regardless of the actual value of @var{n}.  Note
On error the return value is -1, otherwise it returns the number of
some pre-C99 system libraries do not implement this correctly so users
bytes, not including the terminating null byte, that would have been
cannot generally rely on the return value if the system version of
written had @var{n} been sufficiently large, regardless of the actual
this function is used.
value of @var{n}.  Note some pre-C99 system libraries do not implement
 
this correctly so users cannot generally rely on the return value if
 
the system version of this function is used.
 
 
@end deftypefn
@end deftypefn
 
 
@c spaces.c:22
@c spaces.c:22
@deftypefn Extension char* spaces (int @var{count})
@deftypefn Extension char* spaces (int @var{count})
Line 1254... Line 1282...
The returned string is only guaranteed to be valid only until the next
The returned string is only guaranteed to be valid only until the next
call to @code{strsignal}.
call to @code{strsignal}.
 
 
@end deftypefn
@end deftypefn
 
 
@c strsignal.c:446
@c strsignal.c:448
@deftypefn Extension {const char*} strsigno (int @var{signo})
@deftypefn Extension {const char*} strsigno (int @var{signo})
 
 
Given an signal number, returns a pointer to a string containing the
Given an signal number, returns a pointer to a string containing the
symbolic name of that signal number, as found in @code{<signal.h>}.
symbolic name of that signal number, as found in @code{<signal.h>}.
 
 
Line 1320... Line 1348...
@code{strtod} above.  The @code{strtoul} function is the same, except
@code{strtod} above.  The @code{strtoul} function is the same, except
that the converted value is unsigned.
that the converted value is unsigned.
 
 
@end deftypefn
@end deftypefn
 
 
@c strsignal.c:500
@c strsignal.c:502
@deftypefn Extension int strtosigno (const char *@var{name})
@deftypefn Extension int strtosigno (const char *@var{name})
 
 
Given the symbolic name of a signal, map it to a signal number.  If no
Given the symbolic name of a signal, map it to a signal number.  If no
translation is found, returns 0.
translation is found, returns 0.
 
 
Line 1451... Line 1479...
@end deftypefn
@end deftypefn
 
 
@c vsnprintf.c:28
@c vsnprintf.c:28
@deftypefn Supplemental int vsnprintf (char *@var{buf}, size_t @var{n}, const char *@var{format}, va_list @var{ap})
@deftypefn Supplemental int vsnprintf (char *@var{buf}, size_t @var{n}, const char *@var{format}, va_list @var{ap})
 
 
This function is similar to vsprintf, but it will print at most
This function is similar to @code{vsprintf}, but it will write to
@var{n} characters.  On error the return value is -1, otherwise it
@var{buf} at most @code{@var{n}-1} bytes of text, followed by a
returns the number of characters that would have been printed had
terminating null byte, for a total of @var{n} bytes.  On error the
@var{n} been sufficiently large, regardless of the actual value of
return value is -1, otherwise it returns the number of characters that
@var{n}.  Note some pre-C99 system libraries do not implement this
would have been printed had @var{n} been sufficiently large,
correctly so users cannot generally rely on the return value if the
regardless of the actual value of @var{n}.  Note some pre-C99 system
system version of this function is used.
libraries do not implement this correctly so users cannot generally
 
rely on the return value if the system version of this function is
 
used.
 
 
@end deftypefn
@end deftypefn
 
 
@c waitpid.c:3
@c waitpid.c:3
@deftypefn Supplemental int waitpid (int @var{pid}, int *@var{status}, int)
@deftypefn Supplemental int waitpid (int @var{pid}, int *@var{status}, int)

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.