.\" and Copyright (C) 2002, 2006, 2008, 2012, 2013 Michael Kerrisk <mtk.manpages@gmail.com>
.\" and Copyright Guillem Jover <guillem@hadrons.org>
.\" and Copyright (C) 2014 Dave Hansen / Intel
+.\" and Copyright (c) 2020 Dave Martin <Dave.Martin@arm.com>
.\"
.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" commit 63f0c60379650d82250f22e4cf4137ef3dc4f43d
.TP
.BR PR_SET_TAGGED_ADDR_CTRL " (since Linux 5.4, only on arm64)"
-Controls support for passing tagged userspace addresses to the kernel
+Controls support for passing tagged user-space addresses to the kernel
(i.e., addresses where bits 56\(em63 are not all zero).
.IP
The level of support is selected by
.RE
.IP
The remaining arguments
-.IR arg3 ", " arg4 " and " arg5
+.IR arg3 ", " arg4 ", and " arg5
must all be zero.
.\" Enforcement added in
.\" commit 3e91ec89f527b9870fe42dcbdb74fd389d123a95
or if this feature is unsupported by the kernel
or disabled via
.IR /proc/sys/abi/tagged_addr_disabled ,
-the call fails with
+the call fails with the error
.BR EINVAL .
.IP
In particular, if
.BR prctl ( PR_SET_TAGGED_ADDR_CTRL ,
0, 0, 0, 0)
fails with
-.B EINVAL
+.BR EINVAL ,
then all addresses passed to the kernel must be untagged.
.IP
Irrespective of which mode is set,
addresses passed to certain interfaces
must always be untagged:
.RS
-.IP \(em
+.IP \(bu 2
.BR brk (2),
.BR mmap (2),
.BR shmat (2),
(Prior to Linux 5.6 these accepted tagged addresses,
but the behaviour may not be what you expect.
Don't rely on it.)
-.IP \(em
+.IP \(bu
\(oqpolymorphic\(cq interfaces
that accept pointers to arbitrary types cast to a
.I void *
A successful
.B PR_SET_TAGGED_ADDR_CTRL
call elsewhere may crash the calling process.
-The conditions for using it safely are complex and system-dependent;
+The conditions for using it safely are complex and system-dependent.
Don't use it unless you know what you are doing.
.\" prctl PR_GET_TAGGED_ADDR_CTRL
.\" commit 63f0c60379650d82250f22e4cf4137ef3dc4f43d
for the calling thread.
.IP
Arguments
-.IR arg2 ", " arg3 ", " arg4 " and " arg5
+.IR arg2 ", " arg3 ", " arg4 ", and " arg5
must all be zero.
.IP
If the arguments are invalid