.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (C) Markus Kuhn, 1996
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" 1995-11-26  Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de>
.\"      First version written
.\" Translation revised Sat Jan  8 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH MLOCK 2 "26 noviembre 1995" "Linux 1.3.43" "Manual del Programador de Linux"
.SH NOMBRE
mlock \- desactiva la paginación para algunas zonas de memoria
.SH SINOPSIS
.nf
.B #include <sys/mman.h>
.sp
\fBint mlock(const void *\fIaddr\fB, size_t \fIlen\fB);
.fi
.SH DESCRIPCIÓN
.B mlock
desactiva la paginación para la memoria en el grupo de direcciones que
comienza en la dirección
.I addr
con longitud
.I len
bytes. Se garantiza que todas las páginas que contienen algunas de esas
direcciones estarán residentes en RAM cuando la llamada al sistema
.B mlock
termine sin error y permanecerán en RAM hasta que dichas páginas sean
desbloquedadas con
.B munlock
o
.BR munlockall ,
hasta que las páginas sean desalojadas vía
.BR munmap,
o hasta que termine el proceso o comience otro programa con
.BR exec .
Los procesos hijos creados mediante 
.BR fork
no heredan los bloqueos de páginas.

El bloqueo de memoria tiene dos aplicaciones fundamentales: algoritmos en
tiempo real y procesado de datos de alta seguridad. Las aplicaciones en
tiempo real requieren una temporización determinista, y la paginación es una
de las causas principales de retardos inesperados en la ejecución de programas,
junto con la planificación (scheduling). Las aplicaciones en tiempo real suelen
conmutar a un planificador en tiempo real con
.BR sched_setscheduler .
El software de seguridad criptográfico a menudo trabaja con bytes críticos
tales como contraseñas o claves secretas. Como resultado de la paginación,
estos secretos pueden ser transferidos a un medio de almacenamiento de
intercambio persistente, donde podría ser leído por el enemigo mucho después
de que el programa de seguridad haya borrado los secretos de la RAM y
terminado.

Los bloqueos de memoria no son acumulativos, es decir, si una página ha sido
bloqueda varias veces mediante llamadas a 
.B mlock
o
.B mlockall
será desbloqueada con una simple llamada a
.B munlock
para el rango correspondiente o con
.BR munlockall .
Las páginas que son asociadas a varias zonas o a varios procesos permanecen
bloqueadas en RAM mientras lo estén por alguna zona o proceso.

En los sistemas POSIX con
.B mlock
y
.B munlock
disponibles, se define
.B _POSIX_MEMLOCK_RANGE
en <unistd.h> y el valor de
.B PAGESIZE
de <limits.h> indica el número de bytes por página.
.SH OBSERVACIONES
Con la llamada al sistema de Linux, 
.I addr
se redondea hacia abajo automáticamente hacia el límite de página más cercano.
Sin embargo, POSIX 1003.1-2001 permite una implementación que requiere que
.I addr
esté en situado un límite de página, por lo que las aplicaciones deberían asegurar este requisito.
.SH VALOR DEVUELTO
En caso de éxito,
.B mlock
devuelve cero. Si hay error, se devuelve \-1,
.I errno
se activa convenientemente y no se realiza ningún cambio en ningún bloqueo
en el espacio de direcciones del proceso.
.SH ERRORES
.TP
.B ENOMEM
Alguna parte del rango de direcciones no corresponde a páginas
asociadas en el espacio de direcciones del proceso o el proceso intentó
exceder el número máximo de páginas bloqueadas permitido.
.TP
.B EPERM
El proceso invocador no tiene los privilegios necesarios. Sólo se permite
bloquear páginas a los procesos del superusuario.
.TP
.B EINVAL
.I len
no era un número positivo.
.SH "CONFORME A"
POSIX.1b, SVr4.  SVr4 añade un código de error adicional (EAGAIN).
.SH "VÉASE TAMBIÉN"
.BR mlockall (2),
.BR munlock (2),
.BR munlockall (2),
.BR munmap (2),
.BR setrlimit (2)