getcpu(2)                     System Calls Manual                    getcpu(2)

NUME
       getcpu - determina CPU-ul <?>i nodul NUMA pe care ruleaza firul apelant

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #define _GNU_SOURCE             /* Consulta<?>i feature_test_macros(7) */
       #include <sched.h>

       int getcpu(unsigned int *_Nullable cpu, unsigned int *_Nullable node);

DESCRIERE
       Apelul de sistem getcpu() identifica procesorul <?>i nodul pe care se
       executa in prezent firul sau procesul apelant <?>i le scrie in numerele
       intregi indicate de argumentele cpu <?>i nod.  Procesorul este un numar
       intreg mic <?>i unic care identifica un procesor.  Nodul este un
       identificator mic unic care identifica un nod NUMA.  Atunci cand cpu
       sau nod este NULL, nu se scrie nimic in indicatorul respectiv.

       Informa<?>iile plasate in cpu sunt garantate a fi actuale doar in
       momentul apelului: daca afinitatea procesorului nu a fost fixata
       folosind sched_setaffinity(2), nucleul poate schimba procesorul in
       orice moment; (in mod normal, acest lucru nu se intampla, deoarece
       planificatorul incearca sa minimizeze mi<?>carile intre CPU-uri pentru
       a men<?>ine memoria cache in func<?>iune, dar este posibil). Apelantul
       trebuie sa ia in considerare posibilitatea ca informa<?>iile returnate
       in cpu <?>i node sa nu mai fie actuale in momentul in care apelul
       returneaza.

VALOAREA RETURNATA
       In caz de succes, se returneaza 0. In caz de eroare, se returneaza -1,
       iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EFAULT Argumentele indica in afara spa<?>iului de adrese al procesului
              apelant.

STANDARDE
       Linux.

ISTORIC
       Linux 2.6.19 (x86-64 <?>i i386), glibc 2.29.

   Diferen<?>e intre biblioteca C <?>i nucleu
       Apelul de sistem al nucleului are un al treilea argument:

           int getcpu(unsigned int *cpu, unsigned int *node,
                      struct getcpu_cache *tcache);

       Argumentul tcache este nefolosit incepand cu Linux 2.6.24 <?>i (atunci
       cand se invoca direct apelul de sistem) ar trebui sa fie specificat ca
       NULL, cu excep<?>ia cazului in care este necesara portabilitatea la
       Linux 2.6.23 sau la o versiune anterioara.

       In Linux 2.6.23 <?>i versiunile anterioare, daca argumentul tcache nu
       era NULL, atunci acesta specifica un indicator catre o memorie tampon
       alocata de apelant in memoria locala a firului de execu<?>ie care era
       utilizata pentru a furniza un mecanism de stocare in cache pentru
       getcpu(). Utilizarea cache-ului putea accelera apelurile getcpu(), cu
       pre<?>ul ca exista o <?>ansa foarte mica ca informa<?>iile returnate sa
       nu mai fie actualizate. S-a considerat ca mecanismul de stocare in
       cache ar putea cauza probleme la migrarea firelor de execu<?>ie intre
       CPU-uri, astfel ca argumentul este acum ignorat.

NOTE
       Linux depune toate eforturile pentru a efectua acest apel cat mai
       repede posibil; (pe unele arhitecturi, acest lucru se face prin
       intermediul unei implementari in vdso(7)). Inten<?>ia lui getcpu() este
       de a permite programelor sa faca optimizari cu date per-CPU sau pentru
       optimizarea NUMA.

CONSULTA<?>I <?>I
       mbind(2), sched_setaffinity(2), set_mempolicy(2), sched_getcpu(3),
       cpuset(7), vdso(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                     getcpu(2)