Manpage logo

PR_SET_VMA - set an attribute for virtual memory areas

NAME  LIBRARY  SYNOPSIS  DESCRIPTION  RETURN VALUE  ERRORS  STANDARDS  HISTORY  SEE ALSO 

NAME

PR_SET_VMA − set an attribute for virtual memory areas

LIBRARY

Standard C library (libc−lc)

SYNOPSIS

#include <linux/prctl.h> /* Definition of PR_* constants */
#include <sys/prctl.h>

int prctl(PR_SET_VMA, long attr, unsigned long addr, unsigned long size,
const char *_Nullable
val);

DESCRIPTION

Sets an attribute specified in attr for virtual memory areas starting from the address specified in addr and spanning the size specified in size. val specifies the value of the attribute to be set.

Note that assigning an attribute to a virtual memory area might prevent it from being merged with adjacent virtual memory areas due to the difference in that attribute’s value.

Currently, attr must be one of:
PR_SET_VMA_ANON_NAME

Set a name for anonymous virtual memory areas. val should be a pointer to a null-terminated string containing the name. The name length including null byte cannot exceed 80 bytes. If val is NULL, the name of the appropriate anonymous virtual memory areas will be reset. The name can contain only printable ascii characters (isprint(3)), except '[', ']', '\', '$', and '`'.

RETURN VALUE

On success, 0 is returned. On error, −1 is returned, and errno is set to indicate the error.

ERRORS

EINVAL

attr is not a valid attribute.

EINVAL

addr is an invalid address.

STANDARDS

Linux.

HISTORY

Linux 5.17.

SEE ALSO

prctl(2)


Updated 2026-06-01 - jenkler.se | uex.se