POSIX_MEMALIGN(3)

NOMBRE
posix_memalign, memalign, valloc - Asigna memoria alineada

SINOPSIS
#include <stdlib.h>

int posix_memalign(void **memptr, size_t alignment, size_t size);
void *memalign(size_t boundary, size_t size);
void *valloc(size_t size);

DESCRIPCIÓN
La función posix_memalign() asigna size bytes y deja la dirección de la memoria reservada en *memptr. La dirección de la memoria reservada será un múltiplo de alignment, que debe ser una potencia de dos y un múltiplo de sizeof(void *).

La función obsoleta memalign() asigna size bytes y devuelve un puntero a la memoria reservada. La dirección de memoria será un múltiplo de boundary, que debe ser una potencia de dos.

La función obsoleta valloc() asigna size bytes y devuelve un puntero a la memoria reservada. La dirección de memoria será un múltiplo del tamaño de página. Es equivalente a memalign(sysconf(_SC_PAGESIZE),size).

En todas estas rutinas, la memoria no se rellena con ceros.

VALOR DEVUELTO
memalign() y valloc() devuelven un puntero a la memoria reservada, o NULL si falla la petición.

posix_memalign() devuelve cero en caso de éxito, o uno de los códigos de error listados en la siguiente sección en caso de fallo. Observe que errno no se modifica.

ERRORES

EINVAL
    El parámetro alignment no es una potencia de dos, o no es un múltiplo de sizeof(void *).

ENOMEM
    No hay suficiente memoria para satisfacer la petición de reserva.

OBSERVACIONES

posix_memalign() verifica que alignment cumpla los requisitos detallados arriba. memalign() puede no comprobar que el parámetro boundary sea correcto.

POSIX exige que la memoria obtenida con posix_memalign() pueda ser liberada usando free(). Algunos sistemas no ofrecen ninguna manera de recuperar la memoria reservada con memalign() o valloc() (porque sólo se puede pasar a free() un puntero obtenido con malloc(), mientras p.e. memalign() llamaría a malloc() y después alinearía el valor obtenido). GNU libc permite que la memoria obtenida con cualquiera de estas rutinas sea recuperada con free().

La versión de malloc() de GNU libc siempre devuelve direcciones de memoria alineadas de 8 bytes, por lo que estas rutinas solamente se necesitan si requiere valores de alineamiento mayores.

AVAILABILITY
Las funciones memalign() y valloc() han estado disponibles en todas las bibliotecas libc de Linux. La función posix_memalign() está disponible desde glibc 2.1.91.

CONFORME A
La función valloc() apareció en 3.0 BSD. Está documentada como obsoleta en BSD 4.3, y como antigua en SUSv2. Ya no aparece en SUSv3. La función memalign() aparece en SunOS 4.1.3 pero no en BSD 4.4. La función posix_memalign() viene de POSIX 1003.1d.

VÉASE TAMBIÉN
malloc(3), free(3), getpagesize(2), brk(2)