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)