time_namespaces(7)     Miscellaneous Information Manual     time_namespaces(7)

NUME
       time_namespaces - prezentare generala a spa<?>iilor de nume de timp
       Linux

DESCRIERE
       Spa<?>iile de nume de timp virtualizeaza valorile a doua ceasuri de
       sistem:

       o  CLOCK_MONOTONIC (<?>i, de asemenea, CLOCK_MONOTONIC_COARSE <?>i
          CLOCK_MONOTONIC_RAW), un ceas care nu poate fi reglat <?>i care
          reprezinta timpul monoton de la - a<?>a cum este descris de POSIX -
          ,,un punct nespecificat din trecut".

       o  CLOCK_BOOTTIME (<?>i, de asemenea, CLOCK_BOOTTIME_ALARM), un ceas
          nereglabil care este identic cu CLOCK_MONOTONIC, cu excep<?>ia
          faptului ca include, de asemenea, orice timp in care sistemul este
          suspendat.

       Astfel, procesele dintr-un spa<?>iu de nume de timp impart valorile
       pentru fiecare spa<?>iu de nume pentru aceste ceasuri. Acest lucru
       afecteaza diverse API-uri care masoara in func<?>ie de aceste ceasuri,
       inclusiv: clock_gettime(2), clock_nanosleep(2), nanosleep(2),
       timer_settime(2), timerfd_settime(2) <?>i /proc/uptime.

       In prezent, singura modalitate de a crea un spa<?>iu de nume de timp
       este prin apelarea unshare(2) cu fanionul CLONE_NEWTIME. Acest apel
       creeaza un nou spa<?>iu de nume de timp, dar nu plaseaza procesul
       apelant in noul spa<?>iu de nume. In schimb, copiii procesului de
       apelare crea<?>i ulterior sunt plasa<?>i in noul spa<?>iu de nume.
       Acest lucru permite ca decalajele de ceas (a se vedea mai jos) pentru
       noul spa<?>iu de nume sa fie stabilite inainte ca primul proces sa fie
       plasat in spa<?>iul de nume. Legatura simbolica
       /proc/pid/ns/time_for_children arata spa<?>iul de nume temporal in care
       vor fi crea<?>i copiii unui proces; (un proces poate utiliza un
       descriptor de fi<?>ier deschis pe aceasta legatura simbolica intr-un
       apel la setns(2) pentru a se muta in spa<?>iul de nume).

   /proc/pid/timens_offsets
       Fiecarui spa<?>iu de nume de timp ii sunt asociate decalaje, exprimate
       in raport cu spa<?>iul de nume de timp ini<?>ial, care definesc
       valorile ceasurilor monotonice <?>i de pornire din acel spa<?>iu de
       nume. Aceste decalaje sunt expuse prin intermediul fi<?>ierului
       /proc/pid/timens_offsets. In cadrul acestui fi<?>ier, decalajele sunt
       exprimate ca linii formate din trei campuri delimitate prin spa<?>ii:

           <clock-id> <offset-secs> <offset-nanosecs>

       clock-id este un <?>ir de caractere care identifica ceasul ale carui
       decalaje sunt afi<?>ate. Acest camp este fie monotonic, pentru
       CLOCK_MONOTONIC, fie boottime, pentru CLOCK_BOOTTIME. Campurile ramase
       exprima decalajul (secunde plus nanosecunde) pentru ceasul din acest
       spa<?>iu de nume de timp. Aceste decalaje sunt exprimate in raport cu
       valorile ceasului din spa<?>iul de nume de timp ini<?>ial. Valoarea
       offset-secs poate fi negativa, sub rezerva restric<?>iilor men<?>ionate
       mai jos; offset-nanosecs este o valoare fara semn.

       In spa<?>iul de nume al timpului ini<?>ial, con<?>inutul fi<?>ierului
       timens_offsets este urmatorul:

           $ cat /proc/self/timens_offsets
           monotonic           0         0
           boottime            0         0

       Intr-un nou spa<?>iu de nume de timp care nu a avut niciun proces
       membru, decalajele ceasului pot fi modificate prin scrierea de
       inregistrari cu termina<?>ie de linie noua de aceea<?>i forma in
       fi<?>ierul timens_offsets. Fi<?>ierul poate fi scris de mai multe ori,
       dar dupa ce primul proces a fost creat in spa<?>iul de nume sau a
       intrat in spa<?>iul de nume, scrierea write(2) pe acest fi<?>ier
       e<?>ueaza cu eroarea EACCES. Pentru a putea scrie in fi<?>ierul
       timens_offsets, un proces trebuie sa aiba capacitatea CAP_SYS_TIME in
       spa<?>iul de nume al utilizatorului care de<?>ine spa<?>iul de nume al
       timpului.

       Scrierile in fi<?>ierul timens_offsets pot e<?>ua cu urmatoarele erori:

       EINVAL O valoare offset-nanosecs este mai mare de 999,999,999.

       EINVAL O valoare clock-id nu este valida.

       EPERM  Apelantul nu dispune de capacitatea CAP_SYS_TIME.

       ERANGE O valoare offset-secs este in afara intervalului. In particular;

              o  offset-secs nu poate fi fixat la o valoare care ar face ca
                 ora curenta a ceasului corespunzator din interiorul
                 spa<?>iului de nume sa fie o valoare negativa; <?>i

              o  offset-secs nu poate fi fixat la o valoare astfel incat ora
                 ceasului corespunzator din interiorul spa<?>iului de nume sa
                 depa<?>easca jumatate din valoarea constantei KTIME_SEC_MAX a
                 nucleului (aceasta limiteaza valoarea ceasului la un maxim de
                 aproximativ 146 de ani).

       Intr-un nou spa<?>iu de nume de timp creat de unshare(2), con<?>inutul
       fi<?>ierului timens_offsets este mo<?>tenit de la spa<?>iul de nume de
       timp al procesului de creare.

NOTE
       Utilizarea spa<?>iilor de nume de timp necesita un nucleu care este
       configurat cu op<?>iunea CONFIG_TIME_NS.

       Re<?>ine<?>i ca spa<?>iile de nume de timp nu virtualizeaza ceasul
       CLOCK_REALTIME. Virtualizarea acestui ceas a fost evitata din motive de
       complexitate <?>i de suprasolicitare in cadrul nucleului.

       Pentru compatibilitate cu implementarea ini<?>iala, atunci cand se
       scrie un clock-id in fi<?>ierul /proc/pid/timens_offsets, valorile
       numerice ale ID-urilor pot fi scrise in locul numelor simbolice
       prezentate mai sus; de exemplu, 1 in loc de monotonic <?>i 7 in loc de
       boottime. Pentru u<?>urin<?>a de citire, se prefera utilizarea numelor
       simbolice in locul celor numerice.

       Motiva<?>ia pentru adaugarea de spa<?>ii de nume de timp a fost aceea
       de a permite ceasurilor monotonice <?>i de pornire sa men<?>ina valori
       consecvente in timpul migrarii containerului <?>i al punctului de
       verificare/restaurare.

EXEMPLE
       Urmatoarea sesiune shell demonstreaza func<?>ionarea spa<?>iilor de
       nume de timp. Incepem prin afi<?>area numarului nodului-i al
       spa<?>iului de nume de timp al unui shell in spa<?>iul de nume de timp
       ini<?>ial:

           $ readlink /proc/$$/ns/time
           time:[4026531834]

       Continuand in spa<?>iul de nume al timpului ini<?>ial, vom afi<?>a
       timpul de func<?>ionare a sistemului folosind uptime(1) <?>i vom folosi
       programul de exemplu clock_times prezentat in clock_getres(2) pentru a
       afi<?>a valorile diferitelor ceasuri:

           $ uptime --pretty
           up 21 hours, 17 minutes
           $ ./clock_times
           CLOCK_REALTIME : 1585989401.971 (18356 days +  8h 36m 41s)
           CLOCK_TAI      : 1585989438.972 (18356 days +  8h 37m 18s)
           CLOCK_MONOTONIC:      56338.247 (15h 38m 58s)
           CLOCK_BOOTTIME :      76633.544 (21h 17m 13s)

       Apoi folosim unshare(1) pentru a crea un spa<?>iu de nume de timp <?>i
       pentru a executa un shell bash(1). Din noul shell, folosim comanda
       incorporata echo pentru a scrie inregistrari in fi<?>ierul
       timens_offsets, ajustand decalajul pentru ceasul CLOCK_MONOTONIC
       inainte cu 2 zile <?>i decalajul pentru ceasul CLOCK_BOOTTIME inainte
       cu 7 zile:

           $ PS1="ns2# " sudo unshare -T -- bash --norc
           ns2# echo "monotonic $((2*24*60*60)) 0" > /proc/$$/timens_offsets
           ns2# echo "boottime  $((7*24*60*60)) 0" > /proc/$$/timens_offsets

       Mai sus, am pornit shell-ul bash(1) cu op<?>iunea --norc, astfel incat
       sa nu fie executat niciun script de pornire. Acest lucru asigura faptul
       ca niciun proces-copil nu este creat din shell inainte de a avea
       <?>ansa de a actualiza fi<?>ierul timens_offsets.

       Apoi folosim cat(1) pentru a afi<?>a con<?>inutul fi<?>ierului
       timens_offsets. Executarea lui cat(1) creeaza primul proces in noul
       spa<?>iu de nume de timp, dupa care alte incercari de actualizare a
       fi<?>ierului timens_offsets produc o eroare.

           ns2# cat /proc/$$/timens_offsets
           monotonic      172800         0
           boottime       604800         0
           ns2# echo "boottime $((9*24*60*60)) 0" > /proc/$$/timens_offsets
           bash: echo: eroare de scriere: Permisiune refuzata

       Continuand in noul spa<?>iu de nume, vom executa uptime(1) <?>i
       programul de exemplu clock_times:

           ns2# uptime --pretty
           up 1 week, 21 hours, 18 minutes
           ns2# ./clock_times
           CLOCK_REALTIME : 1585989457.056 (18356 days +  8h 37m 37s)
           CLOCK_TAI      : 1585989494.057 (18356 days +  8h 38m 14s)
           CLOCK_MONOTONIC:     229193.332 (2 days + 15h 39m 53s)
           CLOCK_BOOTTIME :     681488.629 (7 days + 21h 18m  8s)

       Din rezultatul de mai sus, putem vedea ca ceasurile monotonic <?>i de
       pornire au valori diferite in noul spa<?>iu de nume al timpului.

       Examinand legaturile simbolice /proc/pid/ns/time <?>i
       /proc/pid/ns/time_for_children, vedem ca shell-ul este membru al
       spa<?>iului de nume timp ini<?>ial, dar copiii sai sunt crea<?>i in
       noul spa<?>iu de nume.

           ns2# readlink /proc/$$/ns/time
           time:[4026531834]
           ns2# readlink /proc/$$/ns/time_for_children
           time:[4026532900]
           ns2# readlink /proc/self/ns/time   # Creeaza un proces-copil
           time:[4026532900]

       Revenind la shell-ul din spa<?>iul de nume de timp ini<?>ial, vedem ca
       ceasurile monotonic <?>i de pornire nu sunt afectate de modificarile
       timens_offsets care au fost facute in celalalt spa<?>iu de nume de
       timp:

           $ uptime --pretty
           up 21 hours, 19 minutes
           $ ./clock_times
           CLOCK_REALTIME : 1585989401.971 (18356 days +  8h 38m 51s)
           CLOCK_TAI      : 1585989438.972 (18356 days +  8h 39m 28s)
           CLOCK_MONOTONIC:      56338.247 (15h 41m  8s)
           CLOCK_BOOTTIME :      76633.544 (21h 19m 23s)

CONSULTA<?>I <?>I
       nsenter(1), unshare(1), clock_settime(2), setns(2), unshare(2),
       namespaces(7), time(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.9.1   2 mai 2024                time_namespaces(7)