|
Packit Service |
724aca |
.\"
|
|
Packit Service |
724aca |
.\" Copyright (C) 2014 - 2019 Intel Corporation.
|
|
Packit Service |
724aca |
.\" All rights reserved.
|
|
Packit Service |
724aca |
.\"
|
|
Packit Service |
724aca |
.\" Redistribution and use in source and binary forms, with or without
|
|
Packit Service |
724aca |
.\" modification, are permitted provided that the following conditions are met:
|
|
Packit Service |
724aca |
.\" 1. Redistributions of source code must retain the above copyright notice(s),
|
|
Packit Service |
724aca |
.\" this list of conditions and the following disclaimer.
|
|
Packit Service |
724aca |
.\" 2. Redistributions in binary form must reproduce the above copyright notice(s),
|
|
Packit Service |
724aca |
.\" this list of conditions and the following disclaimer in the documentation
|
|
Packit Service |
724aca |
.\" and/or other materials provided with the distribution.
|
|
Packit Service |
724aca |
.\"
|
|
Packit Service |
724aca |
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY EXPRESS
|
|
Packit Service |
724aca |
.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
Packit Service |
724aca |
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
Packit Service |
724aca |
.\" EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
Packit Service |
724aca |
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
Packit Service |
724aca |
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
Packit Service |
724aca |
.\" PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
Packit Service |
724aca |
.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
|
|
Packit Service |
724aca |
.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
Packit Service |
724aca |
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
Packit Service |
724aca |
.\"
|
|
Packit Service |
724aca |
.TH "MEMKIND_HUGETLB" 3 "2015-04-21" "Intel Corporation" "MEMKIND_HUGETLB" \" -*- nroff -*-
|
|
Packit Service |
724aca |
.SH "NAME"
|
|
Packit Service |
724aca |
memkind_hugetlb \- hugetlb memory memkind operations.
|
|
Packit Service |
724aca |
.br
|
|
Packit Service |
724aca |
.BR Note:
|
|
Packit Service |
724aca |
This is EXPERIMENTAL API. The functionality and the header file itself can be changed (including non-backward compatible changes) or removed.
|
|
Packit Service |
724aca |
.SH "SYNOPSIS"
|
|
Packit Service |
724aca |
.sp
|
|
Packit Service |
724aca |
.BI "int memkind_hugetlb_check_available_2mb(struct memkind " "*kind" );
|
|
Packit Service |
724aca |
.br
|
|
Packit Service |
724aca |
.BI "int memkind_hugetlb_get_mmap_flags(struct memkind " "*kind" ", int " "*flags" );
|
|
Packit Service |
724aca |
.br
|
|
Packit Service |
724aca |
.BI "void memkind_hugetlb_init_once(void);"
|
|
Packit Service |
724aca |
.br
|
|
Packit Service |
724aca |
|
|
Packit Service |
724aca |
.SH DESCRIPTION
|
|
Packit Service |
724aca |
.PP
|
|
Packit Service |
724aca |
The hugetlb memory memkind operations enable memory kinds which use
|
|
Packit Service |
724aca |
the Linux hugetlbfs file system. For more information about the
|
|
Packit Service |
724aca |
hugetlbfs see link below.
|
|
Packit Service |
724aca |
.br
|
|
Packit Service |
724aca |
.UR https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt
|
|
Packit Service |
724aca |
.UE
|
|
Packit Service |
724aca |
.PP
|
|
Packit Service |
724aca |
.BR memkind_hugetlb_check_available_2mb ()
|
|
Packit Service |
724aca |
check if there are 2MB pages reserved in the default hugetlbfs. If
|
|
Packit Service |
724aca |
the kind implements
|
|
Packit Service |
724aca |
.BR ops.get_mbind_nodemask (),
|
|
Packit Service |
724aca |
then only the NUMA nodes
|
|
Packit Service |
724aca |
set by the nodemask are checked, otherwise every NUMA node is checked.
|
|
Packit Service |
724aca |
.PP
|
|
Packit Service |
724aca |
.BR memkind_hugetlb_get_mmap_flags ()
|
|
Packit Service |
724aca |
sets the flags for the
|
|
Packit Service |
724aca |
.BR mmap ()
|
|
Packit Service |
724aca |
system call such that the hugetlbfs is utilized for allocations.
|
|
Packit Service |
724aca |
.PP
|
|
Packit Service |
724aca |
.BR memkind_hugetlb_init_once ()
|
|
Packit Service |
724aca |
this function initializes
|
|
Packit Service |
724aca |
.B MEMKIND_HUGETLB
|
|
Packit Service |
724aca |
kind and it should not be called more than once.
|
|
Packit Service |
724aca |
.BR Note:
|
|
Packit Service |
724aca |
.BR memkind_hugetlb_init_once ()
|
|
Packit Service |
724aca |
may reserve some extra memory.
|
|
Packit Service |
724aca |
.SH "COPYRIGHT"
|
|
Packit Service |
724aca |
Copyright (C) 2014 - 2019 Intel Corporation. All rights reserved.
|
|
Packit Service |
724aca |
.SH "SEE ALSO"
|
|
Packit Service |
724aca |
.BR memkind (3),
|
|
Packit Service |
724aca |
.BR memkind_arena (3),
|
|
Packit Service |
724aca |
.BR memkind_default (3),
|
|
Packit Service |
724aca |
.BR memkind_hbw (3),
|
|
Packit Service |
724aca |
.BR memkind_pmem (3),
|
|
Packit Service |
724aca |
.BR jemalloc (3),
|
|
Packit Service |
724aca |
.BR mbind (2),
|
|
Packit Service |
724aca |
.BR mmap (2)
|