sbrk()

Изменить размер адресного пространства процесса

Прототип:

#include <unistd.h>
void * sbrk( int increment );

Аргументы:

increment
Величина инкримента текущего значения прерывания. Может быть положительной или отрицательной.

Библиотека:

libc

Описание:

Значение прерывания - это адрес первого байта нераспределенной памяти. Когда программа начинает выполнение, значение прерывания помещается после кода и константных данных для программы. По мере выделения памяти этот указатель продвигается вперед, когда нет достаточно большого свободного блока, чтобы запрос на выделение был выполнен. Функция sbrk() устанавливает новое значение прерывания для программы, добавляя значение приращения increment к текущему значению прерывания. Недавно выделенная область будет обнулена.

Переменная _amblksiz (определенная в <stdlib.h>) содержит приращение по умолчанию. Это значение может быть изменено программой в любое время.

Возвращаемое значение:

Указатель на начало нового блока памяти. Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EAGAIN
Общий объем системной памяти, доступной для выделения этому процессу, временно недостаточен. Это может произойти даже при условии, что запрошенное пространство меньше максимального размера сегмента данных.
ENOMEM
Для запрошенного изменения выделено больше места, чем доступно, или был вызван конфликт выделения памяти.

Примеры:

#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#define alloc( x, y ) y = sbrk( x );
int main( void )
{
void *brk;
brk = sbrk( 0x3100 );
printf( "New break value after sbrk( 0x3100 ) \t%p\n", brk );
brk = sbrk( 0x0200 );
printf( "New break value after sbrk( 0x0200 ) \t%p\n", brk );
return (EXIT_SUCCESS);
}

Классификация:

Legacy Unix

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Предостережения:

Не рекомендуется использовать brk() и sbrk() с любыми другими функциями памяти (такими как malloc(), mmap() и free()). Функция brk() предполагает, что куча является непрерывной; в "Нейтрино" память возвращается системе из кучи, в результате чего куча становится разреженной. Функция malloc() основана на mmap(), а не на brk().

Функция sbrk() использовалась в особых случаях, когда никакая другая функция распределения памяти не предоставляла такую возможность. Вместо функции sbrk() необходимо использовать mmap(), потому что её можно переносимо использовать со всеми другими функциями распределения памяти и с любой функцией, которая использует другие функции распределения.

Значение аргумента sbrk() округляется в большую сторону для выравнивания с 8-байтовыми границами.

Тематические ссылки:

_amblksiz, brk(), _btext, calloc(), _edata, _end, errno, _etext, free(), malloc(), mmap(), realloc()




Предыдущий раздел: Описание API системной библиотеки