NUME

       brk, sbrk - modifică dimensiunea segmentului de date

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

REZUMAT

       #include <unistd.h>

       int brk(void *addr);
       void *sbrk(intptr_t increment);

   Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

       brk(), sbrk():
           Începând cu glibc 2.19:
               _DEFAULT_SOURCE
                   || ((_XOPEN_SOURCE >= 500) &&
                       ! (_POSIX_C_SOURCE >= 200112L))
           De la glibc 2.12 la glibc 2.19:
               _BSD_SOURCE || _SVID_SOURCE
                   || ((_XOPEN_SOURCE >= 500) &&
                       ! (_POSIX_C_SOURCE >= 200112L))
           Înainte de glibc 2.12:
               _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500

DESCRIERE

       brk()  și  sbrk()  modifică  locația  lui  program break, care definește sfârșitul segmentului de date al
       procesului (de exemplu,  pauza  de  program  este  prima  locație  după  sfârșitul  segmentului  de  date
       neinițializat).  Creșterea  întreruperii  de  program  are  ca  efect  alocarea de memorie pentru proces;
       scăderea întreruperii are ca efect eliberarea de memorie.

       brk() stabilește sfârșitul segmentului de date la valoarea  specificată  de  addr,  atunci  când  această
       valoare  este rezonabilă, sistemul are suficientă memorie, iar procesul nu depășește dimensiunea maximă a
       datelor (a se vedea setrlimit(2)).

       sbrk() mărește spațiul de date al programului cu increment octeți.  Apelarea sbrk() cu un increment de  0
       poate fi utilizată pentru a găsi locația curentă a întreruperii programului.

VALOAREA RETURNATĂ

       În  caz de succes, brk() returnează zero. În caz de eroare, se returnează -1, iar errno este stabilită la
       ENOMEM.

       În caz de succes, sbrk() returnează întreruperea anterioară a programului  (dacă  pauza  a  fost  mărită,
       atunci  această  valoare  este  un  indicator  la  începutul  memoriei nou alocate). În caz de eroare, se
       returnează (void *) -1, iar errno este stabilită la ENOMEM.

STANDARDE

       4.3BSD; SUSv1, marcată ca „LEGACY” în SUSv2, eliminată în POSIX.1-2001.

NOTE

       Evitați utilizarea brk() și sbrk(): pachetul de alocare a  memoriei  malloc(3)  este  modul  portabil  și
       confortabil de alocare a memoriei.

       Diferite  sisteme  utilizează  diferite  tipuri  pentru argumentul lui sbrk().  Cele mai comune sunt int,
       ssize_t, ptrdiff_t, intr_t.

   Diferențe între biblioteca C și nucleu
       Valoarea de retur descrisă mai sus pentru brk() este comportamentul oferit de funcția de învăluire  glibc
       pentru apelul de sistem Linux brk(); (în majoritatea celorlalte implementări, valoarea de returnare de la
       brk() este aceeași; această valoare de returnare a fost, de asemenea, specificată  în  SUSv2).  Cu  toate
       acestea,  apelul  de  sistem Linux efectiv returnează noua întrerupere a programului în caz de succes. În
       caz de eșec, apelul de sistem returnează întreruperea curentă. Funcția de învăluire glibc face o  anumită
       muncă  (de exemplu, verifică dacă noua întrerupere este mai mică decât addr) pentru a furniza valorile de
       returnare 0 și -1 descrise mai sus.

       În Linux, sbrk() este implementată ca o funcție de bibliotecă care utilizează apelul de sistem  brk()  și
       face o anumită contabilitate internă pentru a putea returna vechea valoare de întrerupere.

CONSULTAȚI ȘI

       execve(2), getrlimit(2), end(3), malloc(3)

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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.