Provided by: manpages-es_1.55-10_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'ON

       swapon  establece  como  area  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  area  de  trasiego  tendra  una
       prioridad  mas  alta  que  la  predeterminada. La prioridad se codifica
       como:

           (prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

       Estas funciones solo pueden ser empleadas por el super-usuario.

PRIORIDAD

       Cada area de trasiego tiene una prioridad, alta o baja.   La  prioridad
       predeterminada  es la baja.  Dentro de las areas de baja prioridad, las
       areas nuevas tienen prioridad aun mas baja que las areas antiguas.

       Todas las prioridades puestas con swapflags son de alta prioridad,  mas
       alta  que  la  predeterminada.  Peden tener cualquier valor no negativo
       escogido por el que llama a la funcion. Numeros  mas  altos  significan
       prioridades mayores.

       Las  paginas  de  trasiego se cogen de las areas en orden de prioridad,
       primero las de mayor prioridad.  Para areas con prioridades diferentes,
       un  area  de  prioridad mas alta se gasta por completo antes de emplear
       una de prioridad mas  baja.   Si  dos  o  mas  areas  tienen  la  misma
       prioridad, y es la mas alta disponible, las paginas se asignan segun un
       algoritmo de asignacion en rueda entre ellas.

       En Linux 1.3.6, el nucleo seguia usualmente estas  reglas,  pero  habia
       excepciones.

VALOR DEVUELTO

       En  caso de exito, 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 valido.

       EPERM  El usuario no es  el  super-usuario,  o  estan  en  uso  mas  de
              MAX_SWAPFILES   (definido  como  8  en  Linux  1.3.6)  areas  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 especificas de Linux y  no  deberian  emplearse  en
       programas   supuestamente   transportables.    El   segundo  argumento,
       `swapflags', fue introducido en Linux 1.3.2.

OBSERVACIONES

       La particion o camino debe ser preparada con mkswap(8).

V'EASE TAMBI'EN

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