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)