Provided by:
manpages-es_1.55-10_all 
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)