utime(2)                      System Calls Manual                     utime(2)

NUME
       utime, utimes - modifica ultima ora de acces <?>i de modificare a
       fi<?>ierelor

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <utime.h>

       int utime(const char *path,
                 const struct utimbuf *_Nullable times);

       #include <sys/time.h>

       int utimes(const char *path,
                 const struct timeval times[_Nullable 2]);

DESCRIERE
       Nota: aplica<?>iile moderne pot prefera sa utilizeze interfe<?>ele
       descrise in utimensat(2).

       Apelul de sistem utime() modifica timpii de acces <?>i de modificare ai
       nodului-i specificat de path in campurile actime <?>i, respectiv,
       modtime din times. Timpul de modificare a starii (ctime) va fi stabilit
       la ora curenta, chiar daca celelalte marcaje de timp nu se modifica
       efectiv.

       Daca times este NULL, atunci orele de acces <?>i de modificare a
       fi<?>ierului sunt stabilite la ora curenta.

       Modificarea marcajelor temporale este permisa atunci cand: fie procesul
       are privilegiile corespunzatoare, fie ID-ul efectiv al utilizatorului
       este egal cu ID-ul utilizatorului din fi<?>ier, fie times este NULL
       <?>i procesul are permisiunea de scriere pentru fi<?>ier.

       Structura utimbuf este:

           struct utimbuf {
               time_t actime;       /* ora <?>i data accesului */
               time_t modtime;      /* ora <?>i data modificarii */
           };

       Apelul de sistem utime() permite specificarea marcajelor de timp cu o
       rezolu<?>ie de 1 secunda.

       Apelul de sistem utimes() este similar, dar argumentul times se refera
       la un matrice in loc de o structura. Elementele acestei matrice sunt
       structuri timeval, care permit o precizie de 1 microsecunda pentru
       specificarea marcajelor de timp. Structura timeval este:

           struct timeval {
               long tv_sec;        /* secunde */
               long tv_usec;       /* microsecunde */
           };

       times[0] specifica noul timp de acces, iar times[1] specifica noul timp
       de modificare. Daca times este NULL, atunci, in mod analog cu utime(),
       orele de acces <?>i de modificare ale fi<?>ierului sunt stabilite la
       ora curenta.

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

ERORI-IE<?>IRE
       EACCES Permisiunea de cautare este refuzata pentru unul dintre
              directoarele din prefixul de ruta path (a se vedea, de asemenea,
              path_resolution(7).)

       EACCES times este NULL, ID-ul de utilizator efectiv al apelantului nu
              se potrive<?>te cu cel al proprietarului fi<?>ierului, apelantul
              nu are acces de scriere la fi<?>ier, iar apelantul nu este
              privilegiat (Linux: nu are capacitatea CAP_DAC_OVERRIDE sau
              CAP_FOWNER).

       EFAULT path indica catre o adresa nevalida.

       ENOENT path nu exista.

       EPERM  times nu este NULL, UID-ul efectiv al apelantului nu se
              potrive<?>te cu cel al proprietarului fi<?>ierului, iar
              apelantul nu este privilegiat (Linux: nu are capacitatea
              CAP_FOWNER).

       EROFS  path se afla pe un sistem de fi<?>iere numai-pentru-citire.

STANDARDE
       POSIX.1-2008.

ISTORIC
       utime()
              SVr4, POSIX.1-2001.  POSIX.1-2008 marks it as obsolete.

       utimes()
              4.3BSD, POSIX.1-2001.

NOTE
       Linux nu permite modificarea marcajelor de timp intr-un fi<?>ier
       imuabil sau stabilirea marcajelor de timp la o alta valoare decat ora
       curenta intr-un fi<?>ier de tip ,,doar-adaugare".

CONSULTA<?>I <?>I
       chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3),
       futimes(3), inode(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.15    17 mai 2025                         utime(2)