NOMBRE¶

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 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¶

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 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¶

CONFORME A¶

VÉASE TAMBIÉN¶