brk(2)

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
Niciunul.

ISTORIC
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.