/* Utilities functions to name memory mappings.
Copyright (C) 2023-2025 Free Software Foundation, Inc.
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
. */
#include
#include
#include
#include
#include
static enum {
decorate_unknown = -1,
decorate_off,
decorate_on
} decorate_maps = decorate_unknown;
bool
__is_decorate_maps_enabled (void)
{
switch (atomic_load_relaxed (&decorate_maps))
{
case decorate_unknown:
if (TUNABLE_GET (glibc, mem, decorate_maps, int32_t, NULL) != 0)
{
atomic_store_relaxed (&decorate_maps, decorate_on);
return true;
}
atomic_store_relaxed (&decorate_maps, decorate_off);
return false;
case decorate_off:
return false;
case decorate_on:
return true;
}
__builtin_unreachable ();
}
/* If PR_SET_VMA_ANON_NAME is not supported by the kernel, prctl returns
EINVAL. However, it also returns the same error for invalid argument.
Since it is an internal-only API, it assumes well formatted input:
aligned START, with (START, START+LEN) being a valid memory range,
and NAME with a limit of 80 characters without invalid one ("\\`$[]"). */
void
__set_vma_name (void *start, size_t len, const char *name)
{
if (__is_decorate_maps_enabled ())
{
int r = INTERNAL_SYSCALL_CALL (prctl, PR_SET_VMA, PR_SET_VMA_ANON_NAME,
start, len, name);
/* Disable further attempts if not supported by the kernel. */
if (r == -EINVAL)
atomic_store_relaxed (&decorate_maps, decorate_off);
}
}