1*053f45beSAndroid Build Coastguard Worker // SPDX-License-Identifier: GPL-2.0
2*053f45beSAndroid Build Coastguard Worker /*
3*053f45beSAndroid Build Coastguard Worker * hugepage-shm:
4*053f45beSAndroid Build Coastguard Worker *
5*053f45beSAndroid Build Coastguard Worker * Example of using huge page memory in a user application using Sys V shared
6*053f45beSAndroid Build Coastguard Worker * memory system calls. In this example the app is requesting 256MB of
7*053f45beSAndroid Build Coastguard Worker * memory that is backed by huge pages. The application uses the flag
8*053f45beSAndroid Build Coastguard Worker * SHM_HUGETLB in the shmget system call to inform the kernel that it is
9*053f45beSAndroid Build Coastguard Worker * requesting huge pages.
10*053f45beSAndroid Build Coastguard Worker *
11*053f45beSAndroid Build Coastguard Worker * For the ia64 architecture, the Linux kernel reserves Region number 4 for
12*053f45beSAndroid Build Coastguard Worker * huge pages. That means that if one requires a fixed address, a huge page
13*053f45beSAndroid Build Coastguard Worker * aligned address starting with 0x800000... will be required. If a fixed
14*053f45beSAndroid Build Coastguard Worker * address is not required, the kernel will select an address in the proper
15*053f45beSAndroid Build Coastguard Worker * range.
16*053f45beSAndroid Build Coastguard Worker * Other architectures, such as ppc64, i386 or x86_64 are not so constrained.
17*053f45beSAndroid Build Coastguard Worker *
18*053f45beSAndroid Build Coastguard Worker * Note: The default shared memory limit is quite low on many kernels,
19*053f45beSAndroid Build Coastguard Worker * you may need to increase it via:
20*053f45beSAndroid Build Coastguard Worker *
21*053f45beSAndroid Build Coastguard Worker * echo 268435456 > /proc/sys/kernel/shmmax
22*053f45beSAndroid Build Coastguard Worker *
23*053f45beSAndroid Build Coastguard Worker * This will increase the maximum size per shared memory segment to 256MB.
24*053f45beSAndroid Build Coastguard Worker * The other limit that you will hit eventually is shmall which is the
25*053f45beSAndroid Build Coastguard Worker * total amount of shared memory in pages. To set it to 16GB on a system
26*053f45beSAndroid Build Coastguard Worker * with a 4kB pagesize do:
27*053f45beSAndroid Build Coastguard Worker *
28*053f45beSAndroid Build Coastguard Worker * echo 4194304 > /proc/sys/kernel/shmall
29*053f45beSAndroid Build Coastguard Worker */
30*053f45beSAndroid Build Coastguard Worker
31*053f45beSAndroid Build Coastguard Worker #include <stdlib.h>
32*053f45beSAndroid Build Coastguard Worker #include <stdio.h>
33*053f45beSAndroid Build Coastguard Worker #include <sys/types.h>
34*053f45beSAndroid Build Coastguard Worker #include <sys/ipc.h>
35*053f45beSAndroid Build Coastguard Worker #include <sys/shm.h>
36*053f45beSAndroid Build Coastguard Worker #include <sys/mman.h>
37*053f45beSAndroid Build Coastguard Worker
38*053f45beSAndroid Build Coastguard Worker #ifndef SHM_HUGETLB
39*053f45beSAndroid Build Coastguard Worker #define SHM_HUGETLB 04000
40*053f45beSAndroid Build Coastguard Worker #endif
41*053f45beSAndroid Build Coastguard Worker
42*053f45beSAndroid Build Coastguard Worker #define LENGTH (256UL*1024*1024)
43*053f45beSAndroid Build Coastguard Worker
44*053f45beSAndroid Build Coastguard Worker #define dprintf(x) printf(x)
45*053f45beSAndroid Build Coastguard Worker
46*053f45beSAndroid Build Coastguard Worker /* Only ia64 requires this */
47*053f45beSAndroid Build Coastguard Worker #ifdef __ia64__
48*053f45beSAndroid Build Coastguard Worker #define ADDR (void *)(0x8000000000000000UL)
49*053f45beSAndroid Build Coastguard Worker #define SHMAT_FLAGS (SHM_RND)
50*053f45beSAndroid Build Coastguard Worker #else
51*053f45beSAndroid Build Coastguard Worker #define ADDR (void *)(0x0UL)
52*053f45beSAndroid Build Coastguard Worker #define SHMAT_FLAGS (0)
53*053f45beSAndroid Build Coastguard Worker #endif
54*053f45beSAndroid Build Coastguard Worker
main(void)55*053f45beSAndroid Build Coastguard Worker int main(void)
56*053f45beSAndroid Build Coastguard Worker {
57*053f45beSAndroid Build Coastguard Worker int shmid;
58*053f45beSAndroid Build Coastguard Worker unsigned long i;
59*053f45beSAndroid Build Coastguard Worker char *shmaddr;
60*053f45beSAndroid Build Coastguard Worker
61*053f45beSAndroid Build Coastguard Worker shmid = shmget(2, LENGTH, SHM_HUGETLB | IPC_CREAT | SHM_R | SHM_W);
62*053f45beSAndroid Build Coastguard Worker if (shmid < 0) {
63*053f45beSAndroid Build Coastguard Worker perror("shmget");
64*053f45beSAndroid Build Coastguard Worker exit(1);
65*053f45beSAndroid Build Coastguard Worker }
66*053f45beSAndroid Build Coastguard Worker printf("shmid: 0x%x\n", shmid);
67*053f45beSAndroid Build Coastguard Worker
68*053f45beSAndroid Build Coastguard Worker shmaddr = shmat(shmid, ADDR, SHMAT_FLAGS);
69*053f45beSAndroid Build Coastguard Worker if (shmaddr == (char *)-1) {
70*053f45beSAndroid Build Coastguard Worker perror("Shared memory attach failure");
71*053f45beSAndroid Build Coastguard Worker shmctl(shmid, IPC_RMID, NULL);
72*053f45beSAndroid Build Coastguard Worker exit(2);
73*053f45beSAndroid Build Coastguard Worker }
74*053f45beSAndroid Build Coastguard Worker printf("shmaddr: %p\n", shmaddr);
75*053f45beSAndroid Build Coastguard Worker
76*053f45beSAndroid Build Coastguard Worker dprintf("Starting the writes:\n");
77*053f45beSAndroid Build Coastguard Worker for (i = 0; i < LENGTH; i++) {
78*053f45beSAndroid Build Coastguard Worker shmaddr[i] = (char)(i);
79*053f45beSAndroid Build Coastguard Worker if (!(i % (1024 * 1024)))
80*053f45beSAndroid Build Coastguard Worker dprintf(".");
81*053f45beSAndroid Build Coastguard Worker }
82*053f45beSAndroid Build Coastguard Worker dprintf("\n");
83*053f45beSAndroid Build Coastguard Worker
84*053f45beSAndroid Build Coastguard Worker dprintf("Starting the Check...");
85*053f45beSAndroid Build Coastguard Worker for (i = 0; i < LENGTH; i++)
86*053f45beSAndroid Build Coastguard Worker if (shmaddr[i] != (char)i) {
87*053f45beSAndroid Build Coastguard Worker printf("\nIndex %lu mismatched\n", i);
88*053f45beSAndroid Build Coastguard Worker exit(3);
89*053f45beSAndroid Build Coastguard Worker }
90*053f45beSAndroid Build Coastguard Worker dprintf("Done.\n");
91*053f45beSAndroid Build Coastguard Worker
92*053f45beSAndroid Build Coastguard Worker if (shmdt((const void *)shmaddr) != 0) {
93*053f45beSAndroid Build Coastguard Worker perror("Detach failure");
94*053f45beSAndroid Build Coastguard Worker shmctl(shmid, IPC_RMID, NULL);
95*053f45beSAndroid Build Coastguard Worker exit(4);
96*053f45beSAndroid Build Coastguard Worker }
97*053f45beSAndroid Build Coastguard Worker
98*053f45beSAndroid Build Coastguard Worker shmctl(shmid, IPC_RMID, NULL);
99*053f45beSAndroid Build Coastguard Worker
100*053f45beSAndroid Build Coastguard Worker return 0;
101*053f45beSAndroid Build Coastguard Worker }
102