SysUtil.h revision 650177ee24fbe07cdd9ad9d8913fbf44cf44be13
1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * you may not use this file except in compliance with the License. 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * You may obtain a copy of the License at 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 1699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * System utilities. 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifndef _LIBDEX_SYSUTIL 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define _LIBDEX_SYSUTIL 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#include <sys/types.h> 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2696516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * System page size. Normally you're expected to get this from 2796516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * sysconf(_SC_PAGESIZE) or some system-specific define (usually PAGESIZE 2896516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * or PAGE_SIZE). If we use a simple #define the compiler can generate 2996516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * appropriate masks directly, so we define it here and verify it as the 3096516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * VM is starting up. 3196516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * 3296516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * Must be a power of 2. 3396516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden */ 3496516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden#define SYSTEM_PAGE_SIZE 4096 3596516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden 3696516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden/* 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Use this to keep track of mapped segments. 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projecttypedef struct MemMapping { 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project void* addr; /* start of data */ 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project size_t length; /* length of data */ 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project void* baseAddr; /* page-aligned base address */ 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project size_t baseLength; /* length of mapping */ 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} MemMapping; 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copy a map. 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid sysCopyMap(MemMapping* dst, const MemMapping* src); 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Load a file into a new shared memory segment. All data from the current 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * offset to the end of the file is pulled in. 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The segment is read-write, allowing VM fixups. (It should be modified 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * to support .gz/.zip compressed data.) 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * On success, "pMap" is filled in, and zero is returned. 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectint sysLoadFileInShmem(int fd, MemMapping* pMap); 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Map a file (from fd's current offset) into a shared, 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * read-only memory segment. 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * On success, "pMap" is filled in, and zero is returned. 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 69b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFaddenint sysMapFileInShmemReadOnly(int fd, MemMapping* pMap); 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 72b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * Map a file (from fd's current offset) into a shared, read-only memory 73b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * segment that can be made writable. (In some cases, such as when 74b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * mapping a file on a FAT filesystem, the result may be fully writable.) 75b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * 76b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * On success, "pMap" is filled in, and zero is returned. 77b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden */ 78b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFaddenint sysMapFileInShmemWritableReadOnly(int fd, MemMapping* pMap); 79b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden 80b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden/* 81b5ebe47515c9750c7347557075d3714ba7671aa9Andy McFadden * Like sysMapFileInShmemReadOnly, but on only part of a file. 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 8380a4e2497c3b5ef24fe1408c678053fbc6cd4b25Andy McFaddenint sysMapFileSegmentInShmem(int fd, off_t start, size_t length, 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project MemMapping* pMap); 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 8799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * Create a private anonymous mapping, useful for large allocations. 8899409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * 8999409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * On success, "pMap" is filled in, and zero is returned. 9099409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project */ 9199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Projectint sysCreatePrivateMap(size_t length, MemMapping* pMap); 9299409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project 9399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project/* 9496516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * Change the access rights on one or more pages. If "wantReadWrite" is 9596516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * zero, the pages will be made read-only; otherwise they will be read-write. 9696516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * 9796516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden * Returns 0 on success. 9896516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden */ 9996516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFaddenint sysChangeMapAccess(void* addr, size_t length, int wantReadWrite, 10096516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden MemMapping* pmap); 10196516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden 10296516932f1557d8f48a8b2dbbb885af01a11ef6eAndy McFadden/* 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Release the pages associated with a shared memory segment. 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * This does not free "pMap"; it just releases the memory. 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid sysReleaseShmem(MemMapping* pMap); 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 109fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom/* 110fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom * Write until all bytes have been written. 111fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom * 112fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom * Returns 0 on success, or an errno value on failure. 113fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom */ 114fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstromint sysWriteFully(int fd, const void* buf, size_t count, const char* logMsg); 115fbdcfb9ea9e2a78f295834424c3f24986ea45dacBrian Carlstrom 116650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornstein/* 117650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornstein * Copy the given number of bytes from one fd to another. Returns 118650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornstein * 0 on success, -1 on failure. 119650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornstein */ 120650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornsteinint sysCopyFileToFile(int outFd, int inFd, size_t count); 121650177ee24fbe07cdd9ad9d8913fbf44cf44be13Dan Bornstein 122f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif /*_DALVIK_SYSUTIL*/ 123