NUME¶

msync - sincronizează un fișier cu o hartă din memorie

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

REZUMAT¶

#include <sys/mman.h>

int msync(void addr[.length], size_t length, int flags);

DESCRIERE¶

msync() trimite înapoi în sistemul de fișiere modificările aduse copiei din nucleu a unui fișier care a fost cartografiat în memorie utilizând mmap(2). Fără utilizarea acestui apel, nu există nicio garanție că modificările sunt scrise înapoi înainte de apelarea munmap(2). Pentru a fi mai precis, partea din fișier care corespunde zonei de memorie care începe la addr și are lungimea length este actualizată.

Argumentul flags trebuie să specifice exact unul dintre MS_ASYNC și MS_SYNC și poate include în plus bitul MS_INVALIDATE. Acești biți au următoarele semnificații:

MS_ASYNC

Precizează că o actualizare este planificată, dar apelul se întoarce imediat.

MS_SYNC

Solicită o actualizare și așteaptă ca aceasta să fie finalizată.

MS_INVALIDATE

Solicită invalidarea altor hărți ale aceluiași fișier (astfel încât acestea să poată fi actualizate cu valorile noi care tocmai au fost scrise).

VALOAREA RETURNATö

În caz de succes, se returnează zero. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI¶

EBUSY

MS_INVALIDATE a fost specificat în flags și există o blocare a memoriei pentru intervalul de adrese specificat.

EINVAL

addr nu este un multiplu de PAGESIZE; sau orice alt bit decât MS_ASYNC | MS_INVALIDATE | MS_SYNC este definit în flags; sau atât MS_SYNC cât și MS_ASYNC sunt definite în flags.

ENOMEM

Memoria indicată (sau o parte a acesteia) nu a fost cartografiată.

STANDARDE¶

POSIX.1-2001, POSIX.1-2008.

Acest apel a fost introdus în Linux 1.3.21, iar atunci se folosea EFAULT în loc de ENOMEM. În Linux 2.4.19, aceasta a fost schimbată cu valoarea POSIX ENOMEM.

Pe sistemele POSIX pe care este disponibil msync(), atât _POSIX_MAPPED_FILES, cât și _POSIX_SYNCHRONIZED_IO sunt definite în <unistd.h> la o valoare mai mare decât 0. (A se vedea, de asemenea, sysconf(3).)

NOTE¶

În conformitate cu POSIX, fie MS_SYNC, fie MS_ASYNC trebuie să fie specificat în flags și, într-adevăr, dacă nu se include unul dintre aceste fanioane, msync() va eșua pe unele sisteme. Cu toate acestea, Linux permite un apel la msync() care nu specifică niciunul dintre acești indicatori, cu o semantică care este (în prezent) echivalentă cu specificarea MS_ASYNC. (Începând cu Linux 2.6.19, MS_ASYNC este, de fapt, o non-opțiune, deoarece nucleul urmărește în mod corespunzător paginile modificate și le elimină din memorie în funcție de necesități). În pofida comportamentului Linux, aplicațiile portabile și cu perspective de viitor ar trebui să se asigure că specifică fie MS_SYNC, fie MS_ASYNC în flags.

CONSULTAȚI ȘI¶

mmap(2)

B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128–129 și 389–391.

TRADUCERE¶

Traducerea în limba română a acestui manual a fost creată de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă Nicio RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.