pthread_attr_setaffinity_np(3) Library Functions Manual BEZEICHNUNG pthread_attr_setaffinity_np, pthread_attr_getaffinity_np - CPU-Affinitatsattribut in Thread-Attributobjekt setzen/erhalten BIBLIOTHEK POSIX-Threads-Bibliothek (libpthread, -lpthread) UBERSICHT #define _GNU_SOURCE /* siehe feature_test_macros(7) */ #include int pthread_attr_setaffinity_np(pthread_attr_t *attr, size_t cpugruppengrosse, const cpu_set_t *cpugruppe); int pthread_attr_getaffinity_np(const pthread_attr_t *attr, size_t cpugruppengrosse, cpu_set_t *cpugruppe); BESCHREIBUNG Die Funktion pthread_attr_setaffinity_np() setzt das CPU-Affinitatsmaskenattribut des Thread-Attributobjekts, auf das sich attr bezieht, auf den in cpugruppe festgelegten Wert. Dieses Attribut bestimmt die CPU-Affinitatsmaske eines Threads, der mittels des Thread-Attributobjekts attr erzeugt wird. Die Funktion pthread_attr_getaffinity_np() liefert das CPU-Affinitatsmaskenattribut des Thread-Attributobjektes, auf das sich attr bezieht, in dem Puffer zuruck, auf den cpugruppe zeigt. Das Argument cpugruppengrosse ist die Lange (in Byte) des Puffers, auf den cpugruppe zeigt. Typischerweise wurde dieses Argument als sizeof(cpu_set_t) angegeben. Siehe sched_setaffinity(2) fur weitere Details zu CPU-Affinitatsmasken. Fur eine Beschreibung der Gruppe von Makros, die zur Veranderung und Untersuchung von CPU-Gruppen verwandt werden konnen, siehe CPU_SET(3). RUCKGABEWERT Bei Erfolg liefern diese Funktionen 0 zuruck. Bei einem Fehler wird eine von Null verschiedene Fehlernummer zuruckgeliefert. FEHLER EINVAL (pthread_attr_setaffinity_np()) cpugruppe spezifiziert eine CPU, die ausserhalb der vom Kernel unterstutzten Gruppe war. (Die Kernel-Konfigurationsoption CONFIG_NR_CPUS definiert den Bereich der Gruppe, die vom Kernel-Datentyp, der zur Darstellung von CPU-Gruppen verwandt wird, unterstutzt wird.) EINVAL (pthread_attr_getaffinity_np()) Eine CPU in der Affinitatsmaske des Thread-Attributobjekts, auf das sich attr bezieht, liegt ausserhalb des durch cpugruppengrosse festgelegten Bereichs (d.h. cpugruppe/cpugruppengrosse ist zu klein). ENOMEM (pthread_attr_setaffinity_np()) Speicher konnte nicht reserviert werden. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |pthread_attr_setaffinity_np(), | Multithread-Fahigkeit | MT-Sicher | |pthread_attr_getaffinity_np() | | | +--------------------------------+-------------------------+-----------+ STANDARDS GNU; daher die Endung >>_np<< (nicht portierbar) im Namen. GESCHICHTE Glibc 2.3.4. ANMERKUNGEN Nur in Glibc 2.3.3 wurden Versionen dieser Funktionen bereitgestellt, die kein Argument cpusetsize hatten. Stattdessen war die an zugrundeliegende Systemaufrufe ubergebene CPU-Menge immer sizeof(cpu_set_t). SIEHE AUCH sched_setaffinity(2), pthread_attr_init(3), pthread_setaffinity_np(3), cpuset(7), pthreads(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.9.1 2. Mai 2024 pthread_attr_setaffinity_np(3)