| 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)
|
