NOMBRE

       swapon, swapoff - arranca/para el intercambio al fichero/dispositivo

SINOPSIS

       #include <unistd.h>
       #include <asm/page.h> /* para encontrar PAGE_SIZE */
       #include <sys/swap.h>

       int swapon(const char *camino, int swapflags);
       int swapoff(const char *camino);

DESCRIPCIÓN

       swapon  establece  como  área  de  trasiego  el fichero o dispositivo de bloques especificado por camino.
       swapoff para el trasiego al fichero o dispositivo de bloque especificado por camino.

       swapon toma un argumento swapflags.  Si swapflags tiene el bit SWAP_FLAG_PREFER activado, la  nueva  área
       de trasiego tendrá una prioridad más alta que la predeterminada. La prioridad se codifica como:

           (prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

       Estas funciones sólo pueden ser empleadas por el súper-usuario.

PRIORIDAD

       Cada  área de trasiego tiene una prioridad, alta o baja.  La prioridad predeterminada es la baja.  Dentro
       de las áreas de baja prioridad, las áreas nuevas tienen prioridad aún más baja que las áreas antiguas.

       Todas las prioridades puestas con swapflags son de alta prioridad, más alta que la predeterminada.  Peden
       tener  cualquier  valor  no negativo escogido por el que llama a la función. Números más altos significan
       prioridades mayores.

       Las páginas de trasiego se cogen de las áreas en orden de prioridad,  primero  las  de  mayor  prioridad.
       Para  áreas  con  prioridades  diferentes,  un  área de prioridad más alta se gasta por completo antes de
       emplear una de prioridad más baja.  Si dos o más áreas tienen la  misma  prioridad,  y  es  la  más  alta
       disponible, las páginas se asignan según un algoritmo de asignación en rueda entre ellas.

       En Linux 1.3.6, el núcleo seguía usualmente estas reglas, pero había excepciones.

VALOR DEVUELTO

       En caso de éxito, se devuelve 0. En caso de error, se devuelve -1 y se pone en errno un valor apropiado.

ERRORES

       Muchos otros errores pueden ocurrir si camino no es válido.

       EPERM  El  usuario  no es el súper-usuario, o están en uso más de MAX_SWAPFILES (definido como 8 en Linux
              1.3.6) áreas de trasiego.

       EINVAL se devuelve si camino existe, pero no es ni un camino de fichero  regular  ni  un  dispositivo  de
              bloques.

       ENOENT se devuelve si camino no existe.

       ENOMEM se devuelve si no hay bastante memoria como para iniciar el trasiego.

CONFORME A

       Estas   funciones   son  específicas  de  Linux  y  no  deberían  emplearse  en  programas  supuestamente
       transportables.  El segundo argumento, `swapflags', fue introducido en Linux 1.3.2.

OBSERVACIONES

       La partición o camino debe ser preparada con mkswap(8).

VÉASE TAMBIÉN

       mkswap(8), swapon(8), swapoff(8)