Debian Codegraph @

upstream/debian-unstable/man2/PR_SVE_GET_VL.2const

raw
1 .\" Copyright 2020, Michael Kerrisk <[email protected]>
2 .\" Copyright, the authors of the Linux man-pages project
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .TH PR_SVE_GET_VL 2const 2026-02-08 "Linux man-pages 6.18"
7 .SH NAME
8 PR_SVE_GET_VL
9 \-
10 get the thread's SVE vector length
11 .SH LIBRARY
12 Standard C library
13 .RI ( libc ,\~ \-lc )
14 .SH SYNOPSIS
15 .nf
16 .BR "#include <linux/prctl.h>" " /* Definition of " PR_* " constants */"
17 .B #include <sys/prctl.h>
18 .P
19 .B int prctl(PR_SVE_GET_VL);
20 .fi
21 .SH DESCRIPTION
22 Get the thread's current SVE vector length configuration.
23 .P
24 This operation returns
25 a nonnegative value that describes the
26 .I current
27 configuration.
28 The bits corresponding to
29 .B PR_SVE_VL_LEN_MASK
30 contain the currently configured vector length in bytes.
31 The bit corresponding to
32 .B PR_SVE_VL_INHERIT
33 indicates whether the vector length will be inherited
34 across
35 .BR execve (2).
36 .SH RETURN VALUE
37 On success,
38 .BR PR_SVE_GET_VL ,
39 return the nonnegative values described above.
40 On error, \-1 is returned, and
41 .I errno
42 is set to indicate the error.
43 .SH ERRORS
44 .TP
45 .B EINVAL
46 SVE is not available on this platform.
47 .SH STANDARDS
48 Linux.
49 arm64 only.
50 .SH HISTORY
51 Linux 4.15 (arm64).
52 .SH CAVEATS
53 There is no way to determine whether there is
54 a pending vector length change that has not yet taken effect.
55 .SH SEE ALSO
56 .BR prctl (2),
57 .BR PR_SVE_SET_VL (2const)
58 .P
59 For more information, see the kernel source file
60 .IR Documentation/arch/arm64/sve.rst .