.\" -*- coding: UTF-8 -*-
.\" Copyright 2003 Andries E. Brouwer (aeb@cwi.nl)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH alloc_hugepages 2 "4 Diciembre 2022" "Páginas de manual de Linux 6.03" 
.SH NOMBRE
alloc_hugepages, free_hugepages \- asigna o libera páginas de gran tamaño
.SH SINOPSIS
.nf
.\" asmlinkage unsigned long sys_alloc_hugepages(int key, unsigned long addr,
.\" unsigned long len, int prot, int flag);
.\" asmlinkage int sys_free_hugepages(unsigned long addr);
\fBvoid *syscall(SYS_alloc_hugepages, int \fP\fIkey\fP\fB, void \fP\fIaddr\fP\fB[.\fP\fIlen\fP\fB], size_t \fP\fIlen\fP\fB,\fP
\fB              int \fP\fIprot\fP\fB, int \fP\fIflag\fP\fB);\fP
\fBint syscall(SYS_free_hugepages, void *\fP\fIaddr\fP\fB);\fP
.fi
.PP
\fINote\fP: glibc provides no wrappers for these system calls, necessitating
the use of \fBsyscall\fP(2).
.SH DESCRIPCIÓN
Las llamadas al sistema \fBalloc_hugepages\fP() y \fBfree_hugepages\fP() fueron
introducidas en Linux 2.5.36 y eliminadas de nuevo en la versión
2.5.54. Existían sólo para arquitecturas i386 e ia64 (cuando se compilaba
con la opción \fBCONFIG_HUGETLB_PAGE\fP). En Linux 2.4.20 existen los números
de las llamadas al sistemas, pero las llamadas devuelven \fBENOSYS\fP.
.PP
En la arquitectura i386 el hardware de gestión de la memoria maneja páginas
ordinarias (4\ KiB) y páginas grandes (2 o 4\ MiB). De manera similar, la
arquitectura ia64 maneja páginas grandes de distintos tamaños. Estas
llamadas al sistema sirven para ubicar páginas de gran tamaño en la memoria
del proceso o para liberarlas. Las páginas grandes están fijas en memoria, y
no son intercambiadas (swapped).
.PP
El argumento \fIkey\fP es un identificador. Cuando es cero las páginas son
privadas, y no son heredadas por los hijos. Cuando es positivo las páginas
son compartidas con otras aplicaciones usando el mismo identificador \fIkey\fP,
y heredadas por los procesos hijo.
.PP
The \fIaddr\fP argument of \fBfree_hugepages\fP()  tells which page is being
freed: it was the return value of a call to \fBalloc_hugepages\fP().  (The
memory is first actually freed when all users have released it.)  The
\fIaddr\fP argument of \fBalloc_hugepages\fP()  is a hint, that the kernel may or
may not follow.  Addresses must be properly aligned.
.PP
El parámetro \fIlen\fP es la longitud del segmento requerido. Debe ser un
múltiplo del tamaño de la página gigante.
.PP
El parámetro \fIprot\fP especifica la protección de memoria del segmento. Puede
ser \fBPROT_READ\fP, \fBPROT_WRITE\fP o bien \fBPROT_EXEC\fP.
.PP
The \fIflag\fP argument is ignored, unless \fIkey\fP is positive.  In that case,
if \fIflag\fP is \fBIPC_CREAT\fP, then a new huge page segment is created when
none with the given key existed.  If this flag is not set, then \fBENOENT\fP is
returned when no segment with the given key exists.
.SH "VALOR DEVUELTO"
En caso de éxito, \fBalloc_hugepages\fP() devuelve la dirección virtual
asignada, y \fBfree_hugepages\fP() devuelve cero. En caso de error, se devuelve
\-1, y se define \fIerrno\fP para indicar el tipo de error.
.SH ERRORES
.TP 
\fBENOSYS\fP
La llamada al sistema no está soportada por este núcleo.
.SH ARCHIVOS
.TP 
\fI/proc/sys/vm/nr_hugepages\fP
Número de páginas hugetlb configuradas. Puede ser leído y escrito.
.TP 
\fI/proc/meminfo\fP
Proporciona información del número de páginas hugetlb configuradas y de su
tamaño en las tres variables HugePages_Total, HugePages_Free, Hugepagesize.
.SH ESTÁNDARES
These extinct system calls were specific to Linux on Intel processors.
.SH NOTAS
These system calls are gone; they existed only in Linux 2.5.36 through to
Linux 2.5.54.  Now the hugetlbfs filesystem can be used instead.  Memory
backed by huge pages (if the CPU supports them) is obtained by using
\fBmmap\fP(2)  to map files in this virtual filesystem.
.PP
El número máximo de páginas grandes puede especificarse usando el parámetro
\fBhugepages=\fP en el arranque.
.\".PP
.\" requires CONFIG_HUGETLB_PAGE (under "Processor type and features")
.\" and CONFIG_HUGETLBFS (under "Filesystems").
.\" mount \-t hugetlbfs hugetlbfs /huge
.\" SHM_HUGETLB
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Miguel Pérez Ibars <mpi79470@alu.um.es>
y
Marcos Fouces <marcos@debian.org>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .