2016-12-09 07:18:27 +00:00
|
|
|
/* Common extra functions.
|
2020-01-01 00:14:33 +00:00
|
|
|
Copyright (C) 2016-2020 Free Software Foundation, Inc.
|
2016-12-09 07:18:27 +00:00
|
|
|
This file is part of the GNU C Library.
|
|
|
|
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
|
|
modify it under the terms of the GNU Lesser General Public
|
|
|
|
License as published by the Free Software Foundation; either
|
|
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
Lesser General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
|
|
License along with the GNU C Library; if not, see
|
Prefer https to http for gnu.org and fsf.org URLs
Also, change sources.redhat.com to sourceware.org.
This patch was automatically generated by running the following shell
script, which uses GNU sed, and which avoids modifying files imported
from upstream:
sed -ri '
s,(http|ftp)(://(.*\.)?(gnu|fsf|sourceware)\.org($|[^.]|\.[^a-z])),https\2,g
s,(http|ftp)(://(.*\.)?)sources\.redhat\.com($|[^.]|\.[^a-z]),https\2sourceware.org\4,g
' \
$(find $(git ls-files) -prune -type f \
! -name '*.po' \
! -name 'ChangeLog*' \
! -path COPYING ! -path COPYING.LIB \
! -path manual/fdl-1.3.texi ! -path manual/lgpl-2.1.texi \
! -path manual/texinfo.tex ! -path scripts/config.guess \
! -path scripts/config.sub ! -path scripts/install-sh \
! -path scripts/mkinstalldirs ! -path scripts/move-if-change \
! -path INSTALL ! -path locale/programs/charmap-kw.h \
! -path po/libc.pot ! -path sysdeps/gnu/errlist.c \
! '(' -name configure \
-execdir test -f configure.ac -o -f configure.in ';' ')' \
! '(' -name preconfigure \
-execdir test -f preconfigure.ac ';' ')' \
-print)
and then by running 'make dist-prepare' to regenerate files built
from the altered files, and then executing the following to cleanup:
chmod a+x sysdeps/unix/sysv/linux/riscv/configure
# Omit irrelevant whitespace and comment-only changes,
# perhaps from a slightly-different Autoconf version.
git checkout -f \
sysdeps/csky/configure \
sysdeps/hppa/configure \
sysdeps/riscv/configure \
sysdeps/unix/sysv/linux/csky/configure
# Omit changes that caused a pre-commit check to fail like this:
# remote: *** error: sysdeps/powerpc/powerpc64/ppc-mcount.S: trailing lines
git checkout -f \
sysdeps/powerpc/powerpc64/ppc-mcount.S \
sysdeps/unix/sysv/linux/s390/s390-64/syscall.S
# Omit change that caused a pre-commit check to fail like this:
# remote: *** error: sysdeps/sparc/sparc64/multiarch/memcpy-ultra3.S: last line does not end in newline
git checkout -f sysdeps/sparc/sparc64/multiarch/memcpy-ultra3.S
2019-09-07 05:40:42 +00:00
|
|
|
<https://www.gnu.org/licenses/>. */
|
2016-12-09 07:18:27 +00:00
|
|
|
|
|
|
|
/* This header file should only contain definitions compatible with
|
|
|
|
C90. (Using __attribute__ is fine because <features.h> provides a
|
|
|
|
fallback.) */
|
|
|
|
|
|
|
|
#ifndef SUPPORT_H
|
|
|
|
#define SUPPORT_H
|
|
|
|
|
|
|
|
#include <stddef.h>
|
|
|
|
#include <sys/cdefs.h>
|
2018-07-06 05:10:41 +00:00
|
|
|
/* For mode_t. */
|
|
|
|
#include <sys/stat.h>
|
2018-08-31 20:07:47 +00:00
|
|
|
/* For ssize_t and off64_t. */
|
|
|
|
#include <sys/types.h>
|
2016-12-09 07:18:27 +00:00
|
|
|
|
|
|
|
__BEGIN_DECLS
|
|
|
|
|
|
|
|
/* Write a message to standard output. Can be used in signal
|
|
|
|
handlers. */
|
|
|
|
void write_message (const char *message) __attribute__ ((nonnull (1)));
|
|
|
|
|
|
|
|
/* Avoid all the buffer overflow messages on stderr. */
|
|
|
|
void ignore_stderr (void);
|
|
|
|
|
|
|
|
/* Set fortification error handler. Used when tests want to verify that bad
|
|
|
|
code is caught by the library. */
|
|
|
|
void set_fortify_handler (void (*handler) (int sig));
|
|
|
|
|
|
|
|
/* Report an out-of-memory error for the allocation of SIZE bytes in
|
|
|
|
FUNCTION, terminating the process. */
|
|
|
|
void oom_error (const char *function, size_t size)
|
|
|
|
__attribute__ ((nonnull (1)));
|
|
|
|
|
2017-06-02 13:50:36 +00:00
|
|
|
/* Return a pointer to a memory region of SIZE bytes. The memory is
|
|
|
|
initialized to zero and will be shared with subprocesses (across
|
|
|
|
fork). The returned pointer must be freed using
|
|
|
|
support_shared_free; it is not compatible with the malloc
|
|
|
|
functions. */
|
|
|
|
void *support_shared_allocate (size_t size);
|
|
|
|
|
|
|
|
/* Deallocate a pointer returned by support_shared_allocate. */
|
|
|
|
void support_shared_free (void *);
|
|
|
|
|
|
|
|
/* Write CONTENTS to the file PATH. Create or truncate the file as
|
|
|
|
needed. The file mode is 0666 masked by the umask. Terminate the
|
|
|
|
process on error. */
|
|
|
|
void support_write_file_string (const char *path, const char *contents);
|
|
|
|
|
2018-05-16 15:00:35 +00:00
|
|
|
/* Quote the contents of the byte array starting at BLOB, of LENGTH
|
|
|
|
bytes, in such a way that the result string can be included in a C
|
|
|
|
literal (in single/double quotes, without putting the quotes into
|
|
|
|
the result). */
|
|
|
|
char *support_quote_blob (const void *blob, size_t length);
|
|
|
|
|
2018-11-28 06:00:48 +00:00
|
|
|
/* Quote the contents of the string, in such a way that the result
|
2018-11-27 20:35:56 +00:00
|
|
|
string can be included in a C literal (in single/double quotes,
|
|
|
|
without putting the quotes into the result). */
|
2018-11-28 06:00:48 +00:00
|
|
|
char *support_quote_string (const char *);
|
2018-11-27 20:35:56 +00:00
|
|
|
|
2018-08-21 10:56:53 +00:00
|
|
|
/* Returns non-zero if the file descriptor is a regular file on a file
|
|
|
|
system which supports holes (that is, seeking and writing does not
|
|
|
|
allocate storage for the range of zeros). FD must refer to a
|
|
|
|
regular file open for writing, and initially empty. */
|
|
|
|
int support_descriptor_supports_holes (int fd);
|
|
|
|
|
2016-12-09 07:18:27 +00:00
|
|
|
/* Error-checking wrapper functions which terminate the process on
|
|
|
|
error. */
|
|
|
|
|
|
|
|
void *xmalloc (size_t) __attribute__ ((malloc));
|
|
|
|
void *xcalloc (size_t n, size_t s) __attribute__ ((malloc));
|
|
|
|
void *xrealloc (void *p, size_t n);
|
2019-02-06 08:06:34 +00:00
|
|
|
void *xposix_memalign (size_t alignment, size_t n);
|
2016-12-09 07:18:27 +00:00
|
|
|
char *xasprintf (const char *format, ...)
|
|
|
|
__attribute__ ((format (printf, 1, 2), malloc));
|
2016-12-31 13:06:16 +00:00
|
|
|
char *xstrdup (const char *);
|
2017-11-12 08:53:06 +00:00
|
|
|
char *xstrndup (const char *, size_t);
|
2019-11-11 13:57:23 +00:00
|
|
|
char *xsetlocale (int category, const char *locale);
|
2016-12-09 07:18:27 +00:00
|
|
|
|
2018-07-06 05:10:41 +00:00
|
|
|
/* These point to the TOP of the source/build tree, not your (or
|
|
|
|
support's) subdirectory. */
|
|
|
|
extern const char support_srcdir_root[];
|
|
|
|
extern const char support_objdir_root[];
|
|
|
|
|
2018-10-04 11:07:29 +00:00
|
|
|
/* Corresponds to the path to the runtime linker used by the testsuite,
|
|
|
|
e.g. OBJDIR_PATH/elf/ld-linux-x86-64.so.2 */
|
|
|
|
extern const char support_objdir_elf_ldso[];
|
|
|
|
|
2018-07-06 05:10:41 +00:00
|
|
|
/* Corresponds to the --prefix= passed to configure. */
|
|
|
|
extern const char support_install_prefix[];
|
|
|
|
/* Corresponds to the install's lib/ or lib64/ directory. */
|
|
|
|
extern const char support_libdir_prefix[];
|
2019-05-13 16:57:37 +00:00
|
|
|
/* Corresponds to the install's bin/ directory. */
|
|
|
|
extern const char support_bindir_prefix[];
|
2019-05-13 17:31:53 +00:00
|
|
|
/* Corresponds to the install's sbin/ directory. */
|
2019-05-20 19:08:40 +00:00
|
|
|
extern const char support_sbindir_prefix[];
|
|
|
|
/* Corresponds to the install's sbin/ directory (without prefix). */
|
2019-05-13 17:31:53 +00:00
|
|
|
extern const char support_install_rootsbindir[];
|
2018-07-06 05:10:41 +00:00
|
|
|
|
2018-08-31 20:07:47 +00:00
|
|
|
extern ssize_t support_copy_file_range (int, off64_t *, int, off64_t *,
|
|
|
|
size_t, unsigned int);
|
|
|
|
|
2016-12-09 07:18:27 +00:00
|
|
|
__END_DECLS
|
|
|
|
|
|
|
|
#endif /* SUPPORT_H */
|