11a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 21a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Copyright (C) 2008 The Android Open Source Project 31a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 41a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Licensed under the Apache License, Version 2.0 (the "License"); 51a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * you may not use this file except in compliance with the License. 61a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * You may obtain a copy of the License at 71a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 81a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * http://www.apache.org/licenses/LICENSE-2.0 91a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 101a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Unless required by applicable law or agreed to in writing, software 111a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * distributed under the License is distributed on an "AS IS" BASIS, 121a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 131a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * See the License for the specific language governing permissions and 141a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * limitations under the License. 151a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 161a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 171a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 181a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * System utilities. 191a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 201a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#ifndef LIBDEX_SYSUTIL_H_ 211a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#define LIBDEX_SYSUTIL_H_ 221a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 231a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#include <sys/types.h> 241a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 251a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 261a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * System page size. Normally you're expected to get this from 271a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * sysconf(_SC_PAGESIZE) or some system-specific define (usually PAGESIZE 281a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * or PAGE_SIZE). If we use a simple #define the compiler can generate 291a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * appropriate masks directly, so we define it here and verify it as the 301a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * VM is starting up. 311a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 321a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Must be a power of 2. 331a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 341a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#ifdef PAGE_SHIFT 351a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#define SYSTEM_PAGE_SIZE (1<<PAGE_SHIFT) 361a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#else 371a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#define SYSTEM_PAGE_SIZE 4096 381a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#endif 391a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 401a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 411a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Use this to keep track of mapped segments. 421a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 431a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikstruct MemMapping { 441a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik void* addr; /* start of data */ 451a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik size_t length; /* length of data */ 461a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 471a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik void* baseAddr; /* page-aligned base address */ 481a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik size_t baseLength; /* length of mapping */ 491a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik}; 501a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 511a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 521a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Copy a map. 531a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 541a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikvoid sysCopyMap(MemMapping* dst, const MemMapping* src); 551a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 561a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 571a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Map a file (from fd's current offset) into a shared, read-only memory 581a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * segment that can be made writable. (In some cases, such as when 591a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * mapping a file on a FAT filesystem, the result may be fully writable.) 601a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 611a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * On success, "pMap" is filled in, and zero is returned. 621a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 631a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysMapFileInShmemWritableReadOnly(int fd, MemMapping* pMap); 641a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 651a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 661a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Map part of a file into a shared, read-only memory segment. 671a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 681a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * On success, "pMap" is filled in, and zero is returned. 691a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 701a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysMapFileSegmentInShmem(int fd, off_t start, size_t length, 711a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik MemMapping* pMap); 721a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 731a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 741a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Create a private anonymous mapping, useful for large allocations. 751a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 761a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * On success, "pMap" is filled in, and zero is returned. 771a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 781a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysCreatePrivateMap(size_t length, MemMapping* pMap); 791a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 801a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 811a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Change the access rights on one or more pages. If "wantReadWrite" is 821a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * zero, the pages will be made read-only; otherwise they will be read-write. 831a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 841a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Returns 0 on success. 851a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 861a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysChangeMapAccess(void* addr, size_t length, int wantReadWrite, 871a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik MemMapping* pmap); 881a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 891a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 901a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Release the pages associated with a shared memory segment. 911a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 921a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * This does not free "pMap"; it just releases the memory. 931a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 941a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikvoid sysReleaseShmem(MemMapping* pMap); 951a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 961a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 971a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Write until all bytes have been written. 981a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 991a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Returns 0 on success, or an errno value on failure. 1001a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 1011a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysWriteFully(int fd, const void* buf, size_t count, const char* logMsg); 1021a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 1031a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik/* 1041a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * Copy the given number of bytes from one fd to another. Returns 1051a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik * 0 on success, -1 on failure. 1061a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik */ 1071a65052468068a4e9a859d185860510aa1d8cfd4Aart Bikint sysCopyFileToFile(int outFd, int inFd, size_t count); 1081a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik 1091a65052468068a4e9a859d185860510aa1d8cfd4Aart Bik#endif // LIBDEX_SYSUTIL_H_ 110