11dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project/* 21dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 31dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * All rights reserved. 41dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * 51dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * Redistribution and use in source and binary forms, with or without 61dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * modification, are permitted provided that the following conditions 71dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * are met: 81dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * * Redistributions of source code must retain the above copyright 91dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * notice, this list of conditions and the following disclaimer. 101dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * * Redistributions in binary form must reproduce the above copyright 111dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * notice, this list of conditions and the following disclaimer in 121dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * the documentation and/or other materials provided with the 131dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * distribution. 141dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * 151dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 161dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 171dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 181dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 191dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 201dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 211dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 221dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 231dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 241dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 251dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 261dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * SUCH DAMAGE. 271dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project */ 281dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 291dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#ifndef _INCLUDE_SYS_SYSTEM_PROPERTIES_H 301dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#define _INCLUDE_SYS_SYSTEM_PROPERTIES_H 311dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 3249f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner#include <sys/cdefs.h> 3341a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov#include <stdbool.h> 3416b2a4de143a026b8d467b7d242126adcf67242bDimitry Ivanov#include <stddef.h> 35a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes#include <stdint.h> 3649f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner 3749f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner__BEGIN_DECLS 3849f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner 391dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projecttypedef struct prop_info prop_info; 401dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 411dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#define PROP_VALUE_MAX 92 421dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 43a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* 44a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Sets system property `key` to `value`, creating the system property if it doesn't already exist. 45a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes */ 4646b44160e9e4c466be0faf1bb8d6ec70ecc83273Josh Gaoint __system_property_set(const char* key, const char* value) __INTRODUCED_IN(12); 474399df8f2ebd797e45bec81e6f22e4911b2c5686Brad Fitzpatrick 48a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* 49a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Returns a `prop_info` corresponding system property `name`, or nullptr if it doesn't exist. 50a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Use __system_property_read_callback to query the current value. 51a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * 52a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Property lookup is expensive, so it can be useful to cache the result of this function. 53a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes */ 54a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughesconst prop_info* __system_property_find(const char* name); 551dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 56a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* 57a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Calls `callback` with a consistent trio of name, value, and serial number for property `pi`. 58a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes */ 5916b2a4de143a026b8d467b7d242126adcf67242bDimitry Ivanovvoid __system_property_read_callback(const prop_info *pi, 60a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes void (*callback)(void* cookie, const char *name, const char *value, uint32_t serial), 61cb302f932a3532f1484e1e70894e9b1199384283Josh Gao void* cookie) __INTRODUCED_IN(26); 62577418403d68e663fb33c7b0c8a90d862d9c00cfGreg Hackmann 63a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* 64a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * Passes a `prop_info` for each system property to the provided 65a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * callback. Use __system_property_read_callback() to read the value. 66a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * 67a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes * This method is for inspecting and debugging the property system, and not generally useful. 68a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes */ 6914adff1cfa06a3d4d3281a9bf7848b556d84c20dJosh Gaoint __system_property_foreach(void (*propfn)(const prop_info* pi, void* cookie), void* cookie) 7046b44160e9e4c466be0faf1bb8d6ec70ecc83273Josh Gao __INTRODUCED_IN(19); 711dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 7241a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov/* 7341a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * Waits for the specific system property identified by `pi` to be updated 7441a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * past `old_serial`. Waits no longer than `relative_timeout`, or forever 7541a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * if `relaive_timeout` is null. 7641a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * 7741a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * If `pi` is null, waits for the global serial number instead. 7841a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * 7941a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * If you don't know the current serial, use 0. 8041a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * 8141a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * Returns true and updates `*new_serial_ptr` on success, or false if the call 8241a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov * timed out. 8341a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov */ 8441a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanovstruct timespec; 8541a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanovbool __system_property_wait(const prop_info* pi, 8641a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov uint32_t old_serial, 8741a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov uint32_t* new_serial_ptr, 8841a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov const struct timespec* relative_timeout) 89cb302f932a3532f1484e1e70894e9b1199384283Josh Gao __INTRODUCED_IN(26); 9041a3a6f3cf36d626bb8ae474291bda58fc10aba2Dimitry Ivanov 91a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* Deprecated. In Android O and above, there's no limit on property name length. */ 92a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes#define PROP_NAME_MAX 32 93a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* Deprecated. Use __system_property_read_callback instead. */ 94a0e5d06c80c4c7cd8ae96e75d6b17c696a97a21dElliott Hughesint __system_property_read(const prop_info* pi, char* name, char* value); 95a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes/* Deprecated. Use __system_property_read_callback instead. */ 96a0e5d06c80c4c7cd8ae96e75d6b17c696a97a21dElliott Hughesint __system_property_get(const char* name, char* value); 97a0e5d06c80c4c7cd8ae96e75d6b17c696a97a21dElliott Hughes/* Deprecated. Use __system_property_foreach instead. */ 98a0e5d06c80c4c7cd8ae96e75d6b17c696a97a21dElliott Hughesconst prop_info* __system_property_find_nth(unsigned n); 99a0d374d587ec18d437d0dd15ba1332aceaa188afElliott Hughes 10049f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner__END_DECLS 10149f0a8f23bba188466c6ee3652858ef4da228c6fDavid 'Digit' Turner 1021dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#endif 103