.\" -*- coding: UTF-8 -*- .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH brk 2 "17 Mayo 2025" "Páginas de Manual de Linux 6.15" .SH NOMBRE brk, sbrk \- cambia el tamaño del segmento de datos .SH BIBLIOTECA Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBint brk(void *\fP\fIdireccón\fP\fB);\fP \fBvoid *sbrk(intptr_t \fP\fIincremento\fP\fB);\fP .fi .P .RS -4 Requisitos de Macros de Prueba de Características para glibc (véase \fBfeature_test_macros\fP(7)): .RE .P \fBbrk\fP(), \fBsbrk\fP(): .nf .\" (_XOPEN_SOURCE >= 500 || .\" _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) && .\" (_XOPEN_SOURCE >= 500 || .\" _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) && .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED A partir de glibc 2.19: _DEFAULT_SOURCE || ((_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200112L)) Desde glibc 2.12 hasta glibc 2.19: _BSD_SOURCE || _SVID_SOURCE || ((_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200112L)) Antes de glibc 2.12: _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 .fi .SH DESCRIPCIÓN \fBbrk\fP() y \fBsbrk\fP() cambian la ubicación de la \fIinterrupción del programa\fP, que define el final del segmento de datos del proceso (es decir, la interrupción del programa es la primera ubicación después del final del segmento de datos no inicializado). Si se aumenta la interrupción del programa, se asignará memoria al proceso; si se disminuye, se liberará. .P \fBbrk\fP() establece el final del segmento de datos al valor especificado por \fIaddr\fP, cuando este valor es razonable, el sistema dispone de suficiente memoria y el proceso no excede su límite máximo para datos (véase \fBsetrlimit\fP(2)). .P \fBsbrk\fP() aumenta el espacio de datos del programa en \fIincrement\fP bytes. Se puede llamar a \fBsbrk\fP() con un \fIincrement\fP de 0 para averiguar la dirección actual del comienzo de la zona de memoria dinámica del segumento de datos. .SH "VALOR DEVUELTO" En caso de éxito, \fBbrk\fP() retorna cero. En caso de error se devuelve \-1, y \fIerrno\fP se define como \fBENOMEM\fP. .P En caso de éxito, \fBsbrk\fP() devuelve la interrupción del programa anterior. (Si se aumentó la interrupción, este valor es un puntero al inicio de la memoria recién asignada). En caso de error, se devuelve \fI(void\ *)\ \-1\fP y \fIerrno\fP se establece en \fBENOMEM\fP. .SH ESTÁNDARES Ninguno. .SH HISTORIAL .\" .\" .BR brk () .\" and .\" .BR sbrk () .\" are not defined in the C Standard and are deliberately excluded from the .\" POSIX.1-1990 standard (see paragraphs B.1.1.1.3 and B.8.3.3). 4.3BSD; SUSv1, marcado a extinguir en SUSv2, eliminado en POSIX.1\-2001. .SH NOTAS Evite usar \fBbrk\fP() y \fBsbrk\fP(): el paquete de asignación de memoria \fBmalloc\fP(3) es la forma más cómoda y portable de asignar memoria. .P .\" One sees .\" \f[I]int\f[] (e.g., XPGv4, DU 4.0, HP-UX 11, FreeBSD 4.0, OpenBSD 3.2), .\" \f[I]ssize_t\f[] (OSF1 2.0, Irix 5.3, 6.5), .\" \f[I]ptrdiff_t\f[] (libc4, libc5, ulibc, glibc 2.0, 2.1), .\" \f[I]intptr_t\f[] (e.g., XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6, .\" Tru64 5.1, glibc2.2). Varios sistemas utilizan distintos tipos para el argumento de \fBsbrk\fP(). Los valores comunes son \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP e \fIintptr_t\fP. .SS "Diferencias núcleo / biblioteca C" El valor de retorno descrito anteriormente para \fBbrk\fP() es el comportamiento proporcionado por la función contenedora de glibc para la llamada al sistema \fBbrk\fP() de Linux. (En la mayoría de las demás implementaciones, el valor de retorno de \fBbrk\fP() es el mismo; este valor de retorno también se especificó en SUSv2). Sin embargo, la llamada al sistema de Linux devuelve la nueva interrupción del programa en caso de éxito. En caso de error, la llamada al sistema devuelve la interrupción actual. La función contenedora de glibc realiza una tarea (es decir, comprueba si la nueva interrupción es menor que \fIaddr\fP) para proporcionar los valores de retorno 0 y \-1 descritos anteriormente. .P En Linux, \fBsbrk\fP() se implementa como una función de biblioteca que utiliza la llamada al sistema \fBbrk\fP() y realiza la contabilidad interna para poder devolver el valor de interrupción anterior. .SH "VÉASE TAMBIÉN" \fBexecve\fP(2), \fBgetrlimit\fP(2), \fBend\fP(3), \fBmalloc\fP(3) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Miguel Angel Sepulveda , Gerardo Aburruzaga García , Miguel Pérez Ibars y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .