Provided by:
manpages-es_1.55-8_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Ó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)