Provided by: manpages-es_1.55-8_all bug

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)