.\" -*- coding: UTF-8 -*- .\" Copyright 2020, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PR_SVE_SET_VL 2const "8. Februar 2026" "Linux man\-pages 6.17" .SH BEZEICHNUNG PR_SVE_SET_VL \- Setzt die SVE\-Vektorlänge des Threads .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP /* Definition der \fBPR_*\fP\-Konstanten */ \fB#include \fP .P \fBint prctl(PR_SVE_SET_VL, unsigned long \fP\fIWert\fP\fB);\fP .fi .SH BESCHREIBUNG Konfiguriert die SVE\-Vektorlänge des Threads wie in \fIWert\fP angegeben. .P Die Bits in \fIWert\fP, die \fBPR_SVE_VL_LEN_MASK\fP entsprechen, müssen auf die gewünschte Vektorlänge in Byte gesetzt werden. Dies wird als obere Grenze interpretiert: der Kernel wird die größte verfügbare Vektorlänge auswählen, die den angegebenen Wert nicht überschreitet. Insbesondere fordert die Angabe von \fBSVE_VL_MAX\fP (in \fI\fP definiert) für die Bits \fBPR_SVE_VL_LEN_MASK\fP die maximale unterstützte Vektorlänge an. .P Zusätzlich müssen die anderen Bits in \fIWert\fP auf eine der folgenden Kombinationen der Werte von Schalter gesetzt werden: .TP \fB0L\fP Die Änderung sofort ausführen. Beim nächsten \fBexecve\fP(2) in dem Thread wird die Vektorlänge auf den in \fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP konfigurierten Wert zurückgesetzt. .TP \fBPR_SVE_VL_INHERIT\fP Die Änderung sofort ausführen. Nachfolgende Aufrufe von \fBexecve\fP(2) werden die neue Vektorlänge beibehalten. .TP \fBPR_SVE_SET_VL_ONEXEC\fP Die Änderung zurückstellen, so dass sie beim nächsten \fBexecve\fP(2) im Thread ausgeführt wird. Weitere Aufrufe von \fBexecve\fP(2) setzen die Vektorlänge auf den in \fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP konfigurierten Wert zurück. .TP \fBPR_SVE_SET_VL_ONEXEC | PR_SVE_VL_INHERIT\fP Die Änderung zurückstellen, so dass sie beim nächsten \fBexecve\fP(2) im Thread ausgeführt wird. Weitere Aufrufe von \fBexecve\fP(2) behalten die neue Vektorlänge bei. .P In allen Fällen werden die anhängenden zurückgestellten Änderungen abgebrochen. .P Im Erfolgsfall wird ein nicht negativer Wert zurückgegeben, der die \fIausgewählte\fP Konfiguration beschreibt. Falls \fBPR_SVE_SET_VL_ONEXEC\fP Teil von \fIWert\fP ist, dann wird die im Rückgabewert beschriebene Konfiguration beim nächsten \fBexecve\fP(2) wirksam werden. Andernfalls ist die Konfiguration bereits wirksam, wenn der Aufruf \fBPR_SVE_SET_VL\fP zurückkehrt. In jedem Fall wird der Wert auf die gleiche Art wie der Rückgabewert von \fBPR_SVE_GET_VL\fP kodiert. Beachten Sie, dass es keinen expliziten Schalter im Rückgabewert gibt, der \fBPR_SVE_SET_VL_ONEXEC\fP entspricht. .P Die Konfiguration (einschließlich aller anhängigen zurückgestellten Änderungen) wird über \fBfork\fP(2) und \fBclone\fP(2) hinweg vererbt. .SH RÜCKGABEWERT Im Erfolgsfall liefert \fBPR_SVE_SET_VL\fP den oben beschriebenen, nicht negativen Wert zurück. Im Fehlerfall wird \-1 zurückgeliefert und \fIerrno\fP gesetzt, um den Fehler anzuzeigen. .SH FEHLER .TP \fBEINVAL\fP SVE ist auf dieser Plattform nicht verfügbar. .TP \fBEINVAL\fP Der Wert in den Bits von \fIWert\fP, der \fBPR_SVE_VL_LEN_MASK\fP entspricht, ist außerhalb des Bereichs [\fBSVE_VL_MIN\fP, \fBSVE_VL_MAX\fP] oder ist kein Vielfaches von 16. .TP \fBEINVAL\fP Die anderen Bits von \fIWert\fP sind ungültig oder werden nicht unterstützt. .SH DATEIEN .TP \fI/proc/\:sys/\:abi/\:sve_default_vector_length\fP .SH STANDARDS Linux. Nur Arm64. .SH GESCHICHTE .\" commit 2d2123bc7c7f843aa9db87720de159a049839862 .\" linux-5.6/Documentation/arm64/sve.rst Linux 4.15 (Arm64). .SH WARNUNGEN Da der Compiler oder die Laufzeitumgebung SVE nutzen könnte, könnte die Verwendung des Aufrufs ohne den Schalter \fBPR_SVE_SET_VL_ONEXEC\fP zum Absturz des aufrufenden Prozesses führen. Die Bedingungen, um ihn sicher zu verwenden, sind komplex und systemabhängig. Verwenden Sie ihn nur, wenn Sie genau wissen, was Sie tun. .SH "SIEHE AUCH" \fBprctl\fP(2), \fBPR_SVE_GET_VL\fP(2const) .P Weitere Informationen finden Sie in der Kernelquelldatei \fIDocumentation/arch/arm64/sve.rst\fP. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: .MT debian-l10n-german@lists.debian.org .ME .