dbus-internals.c revision f1ca9b89e92de4d876dc5e7e85710c4d2dc87638
1954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/* -*- mode: C; c-file-style: "gnu" -*- */ 27652304bff969afb3969603149bb385efe861fe8John (J/* dbus-internals.c random utility stuff (internal to D-Bus implementation) 3954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 429560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington * Copyright (C) 2002, 2003 Red Hat, Inc. 5954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 643605a6f4e78a8c28afb4b1e924dff0301e0e95cHavoc Pennington * Licensed under the Academic Free License version 2.1 7954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 8954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * This program is free software; you can redistribute it and/or modify 9954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * it under the terms of the GNU General Public License as published by 10954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * the Free Software Foundation; either version 2 of the License, or 11954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * (at your option) any later version. 12954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 13954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * This program is distributed in the hope that it will be useful, 14954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * but WITHOUT ANY WARRANTY; without even the implied warranty of 15954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * GNU General Public License for more details. 17954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 18954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * You should have received a copy of the GNU General Public License 19954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * along with this program; if not, write to the Free Software 20954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 21954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 22954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 23954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington#include "dbus-internals.h" 241f23ea99b37bfc8197f1c6a376f9afe08037f0f6Anders Carlsson#include "dbus-protocol.h" 25993be1059afcb0e9a5b67f5287fb1122d6c48ce6Havoc Pennington#include "dbus-test.h" 26954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington#include <stdio.h> 27954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington#include <stdarg.h> 28041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington#include <string.h> 29993be1059afcb0e9a5b67f5287fb1122d6c48ce6Havoc Pennington#include <stdlib.h> 30954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 31954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 327652304bff969afb3969603149bb385efe861fe8John (J * @defgroup DBusInternals D-Bus internal implementation details 337652304bff969afb3969603149bb385efe861fe8John (J * @brief Documentation useful when developing or debugging D-Bus itself. 34954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 35954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 36954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 37954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 38041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * @defgroup DBusInternalsUtils Utilities and portability 39954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @ingroup DBusInternals 40954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @brief Utility functions (_dbus_assert(), _dbus_warn(), etc.) 41954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @{ 42954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 43954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 44954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 45954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @def _dbus_assert 46954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 47954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Aborts with an error message if the condition is false. 48954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 49954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param condition condition which must be true. 50954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 51954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 52954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 53954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @def _dbus_assert_not_reached 54954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 55954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Aborts with an error message if called. 56954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * The given explanation will be printed. 57954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 58954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param explanation explanation of what happened if the code was reached. 59954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 60954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 61954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 62954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @def _DBUS_N_ELEMENTS 63954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 64954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Computes the number of elements in a fixed-size array using 65954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * sizeof(). 66954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 67954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param array the array to count elements in. 68954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 69954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 70954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 71954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @def _DBUS_POINTER_TO_INT 72954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 73954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Safely casts a void* to an integer; should only be used on void* 74954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * that actually contain integers, for example one created with 75954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * _DBUS_INT_TO_POINTER. Only guaranteed to preserve 32 bits. 76954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * (i.e. it's used to store 32-bit ints in pointers, but 77954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * can't be used to store 64-bit pointers in ints.) 78954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 79954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param pointer pointer to extract an integer from. 80954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 81954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 82954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @def _DBUS_INT_TO_POINTER 83954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 84954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Safely stuffs an integer into a pointer, to be extracted later with 85954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * _DBUS_POINTER_TO_INT. Only guaranteed to preserve 32 bits. 86954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 87954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param integer the integer to stuff into a pointer. 88954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 89041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington/** 90041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * @def _DBUS_ZERO 91041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * 92041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * Sets all bits in an object to zero. 93041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * 94041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * @param object the object to be zeroed. 95041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington */ 96954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 973ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_INT16_MIN 983ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 993ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Minimum value of type "int16" 1003ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1013ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1023ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_INT16_MAX 1033ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1043ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Maximum value of type "int16" 1053ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1063ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1073ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_UINT16_MAX 1083ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1093ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Maximum value of type "uint16" 1103ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1113ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington 1123ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1133ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_INT32_MIN 1143ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1153ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Minimum value of type "int32" 1163ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1173ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1183ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_INT32_MAX 1193ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1203ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Maximum value of type "int32" 1213ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1223ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1233ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_UINT32_MAX 1243ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1253ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Maximum value of type "uint32" 1263ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 1273ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington 1283ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 129576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * @def _DBUS_INT_MIN 130576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * 131576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * Minimum value of type "int" 132576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington */ 133576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington/** 134576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * @def _DBUS_INT_MAX 135576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * 136576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington * Maximum value of type "int" 137576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington */ 1383ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington/** 1393ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * @def _DBUS_UINT_MAX 1403ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * 1413ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington * Maximum value of type "uint" 1423ed9db546e1143bc9aa2d83a6f423fdd81227352Havoc Pennington */ 143041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington 144041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington/** 145041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * @typedef DBusForeachFunction 146041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * 147041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * Used to iterate over each item in a collection, such as 148041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * a DBusList. 149041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington */ 150576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington 151576cdb6e0b1274e9fa5276e01337aef330dd4e8cHavoc Pennington/** 152c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * @def _DBUS_LOCK_NAME 153c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * 154c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * Expands to name of a global lock variable. 155c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington */ 156c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington 157c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington/** 158c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * @def _DBUS_DEFINE_GLOBAL_LOCK 159c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * 160c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * Defines a global lock variable with the given name. 161c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * The lock must be added to the list to initialize 162c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * in dbus_threads_init(). 163c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington */ 164c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington 165c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington/** 166c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * @def _DBUS_DECLARE_GLOBAL_LOCK 167c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * 168c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * Expands to declaration of a global lock defined 169c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * with _DBUS_DEFINE_GLOBAL_LOCK. 170c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * The lock must be added to the list to initialize 171c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * in dbus_threads_init(). 172c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington */ 173c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington 174c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington/** 175c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * @def _DBUS_LOCK 176c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * 177c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * Locks a global lock 178c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington */ 179c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington 180c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington/** 181c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * @def _DBUS_UNLOCK 182c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * 183c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington * Unlocks a global lock 184c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington */ 185c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington 186c3af5ccdbc22e8990d04ec2f89ad1f2e053655e9Havoc Pennington/** 18729560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington * Fixed "out of memory" error message, just to avoid 18829560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington * making up a different string every time and wasting 18929560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington * space. 19029560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington */ 19129560adcc79a259a0be3511c056ee7453aa26c04Havoc Penningtonconst char _dbus_no_memory_message[] = "Not enough memory"; 19229560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington 193a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Penningtonstatic dbus_bool_t warn_initted = FALSE; 194a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Penningtonstatic dbus_bool_t fatal_warnings = FALSE; 195f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Penningtonstatic dbus_bool_t fatal_warnings_on_check_failed = TRUE; 196f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 197f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Penningtonstatic void 198f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Penningtoninit_warnings(void) 199f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington{ 200f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (!warn_initted) 201f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 202f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington const char *s; 203f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington s = _dbus_getenv ("DBUS_FATAL_WARNINGS"); 204f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (s && *s) 205f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 206f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (*s == '0') 207f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 208f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fatal_warnings = FALSE; 209f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fatal_warnings_on_check_failed = FALSE; 210f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington } 211f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington else if (*s == '1') 212f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 213f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fatal_warnings = TRUE; 214f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fatal_warnings_on_check_failed = TRUE; 215f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington } 216f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington else 217f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 218f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fprintf(stderr, "DBUS_FATAL_WARNINGS should be set to 0 or 1 if set, not '%s'", 219f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington s); 220f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington } 221f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington } 222f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 223f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington warn_initted = TRUE; 224f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington } 225f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington} 226a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington 22729560adcc79a259a0be3511c056ee7453aa26c04Havoc Pennington/** 228f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * Prints a warning message to stderr. Can optionally be made to exit 229f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * fatally by setting DBUS_FATAL_WARNINGS, but this is rarely 230f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * used. This function should be considered pretty much equivalent to 231f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * fprintf(stderr). _dbus_warn_check_failed() on the other hand is 232f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * suitable for use when a programming mistake has been made. 233954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 234954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param format printf-style format string. 235954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 236954c4c7550879bd80315811b8548adfcb415766eHavoc Penningtonvoid 237954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington_dbus_warn (const char *format, 238954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington ...) 239954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington{ 240954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington va_list args; 241954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 242a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington if (!warn_initted) 243f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington init_warnings (); 244f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 245f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington va_start (args, format); 246f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington vfprintf (stderr, format, args); 247f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington va_end (args); 248a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington 249f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (fatal_warnings) 250f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington { 251f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fflush (stderr); 252f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington _dbus_abort (); 253a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington } 254f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington} 255f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 256f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington/** 257f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * Prints a "critical" warning to stderr when an assertion fails; 258f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * differs from _dbus_warn primarily in that it prefixes the pid and 259f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * defaults to fatal. This should be used only when a programming 260f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * error has been detected. (NOT for unavoidable errors that an app 261f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * might handle - those should be returned as DBusError.) Calling this 262f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington * means "there is a bug" 263f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington */ 264f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Penningtonvoid 265f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington_dbus_warn_check_failed(const char *format, 266f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington ...) 267f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington{ 268f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington va_list args; 269f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 270f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (!warn_initted) 271f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington init_warnings (); 272f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington 273f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington fprintf (stderr, "process %lu: ", _dbus_getpid ()); 274a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington 275954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington va_start (args, format); 276954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington vfprintf (stderr, format, args); 277954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington va_end (args); 278a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington 279f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington if (fatal_warnings_on_check_failed) 280a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington { 281a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington fflush (stderr); 282a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington _dbus_abort (); 283a2129f7cccaf0265fffe0da79ca0510b6e01131bHavoc Pennington } 284954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington} 285954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 2867bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington#ifdef DBUS_ENABLE_VERBOSE_MODE 2877bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington 288eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Penningtonstatic dbus_bool_t verbose_initted = FALSE; 28905d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (Jstatic dbus_bool_t verbose = TRUE; 290eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington 291be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#define PTHREAD_IN_VERBOSE 0 292be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#if PTHREAD_IN_VERBOSE 2937f2973c8d1e124f4744af0bee73679607511f3a4Havoc Pennington#include <pthread.h> 294be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#endif 295be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington 29605d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (Jstatic inline void 29705d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J_dbus_verbose_init (void) 29805d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J{ 29905d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J if (!verbose_initted) 30005d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J { 30105d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J const char *p = _dbus_getenv ("DBUS_VERBOSE"); 30205d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J verbose = p != NULL && *p == '1'; 30305d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J verbose_initted = TRUE; 30405d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J } 30505d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J} 30605d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J 30705d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (Jdbus_bool_t 30805d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J_dbus_is_verbose_real (void) 30905d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J{ 31005d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J _dbus_verbose_init (); 31105d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J return verbose; 31205d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J} 31305d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J 314954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** 315041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * Prints a warning message to stderr 316041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * if the user has enabled verbose mode. 3176ac750b03fb32591769d0a6ece8840932622feadHavoc Pennington * This is the real function implementation, 3186ac750b03fb32591769d0a6ece8840932622feadHavoc Pennington * use _dbus_verbose() macro in code. 319041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * 320041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington * @param format printf-style format string. 321041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington */ 322041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Penningtonvoid 3236ac750b03fb32591769d0a6ece8840932622feadHavoc Pennington_dbus_verbose_real (const char *format, 3246ac750b03fb32591769d0a6ece8840932622feadHavoc Pennington ...) 325041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington{ 326041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington va_list args; 3276a109938f7a4fc726997985b6de66cf573961986Havoc Pennington static dbus_bool_t need_pid = TRUE; 328dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington int len; 3291708094c0e00ab433bb0a51981f8b77d24aee256Havoc Pennington 3304a74f8fcaba1b9d7ff962fd3c5655e57c2c32c81Havoc Pennington /* things are written a bit oddly here so that 3314a74f8fcaba1b9d7ff962fd3c5655e57c2c32c81Havoc Pennington * in the non-verbose case we just have the one 3324a74f8fcaba1b9d7ff962fd3c5655e57c2c32c81Havoc Pennington * conditional and return immediately. 3334a74f8fcaba1b9d7ff962fd3c5655e57c2c32c81Havoc Pennington */ 33405d90f4f20c1fbbb6c532b5f62531c97ced7d63eJohn (J if (!_dbus_is_verbose_real()) 335041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington return; 3361708094c0e00ab433bb0a51981f8b77d24aee256Havoc Pennington 337dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington /* Print out pid before the line */ 3386a109938f7a4fc726997985b6de66cf573961986Havoc Pennington if (need_pid) 339be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington { 340be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#if PTHREAD_IN_VERBOSE 341be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington fprintf (stderr, "%lu: 0x%lx: ", _dbus_getpid (), pthread_self ()); 342be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#else 343be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington fprintf (stderr, "%lu: ", _dbus_getpid ()); 344be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington#endif 345be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington } 346be672187a56300d5aa15b1e5b3bfa5dc0fe48818Havoc Pennington 347dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington 348dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington /* Only print pid again if the next line is a new line */ 349dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington len = strlen (format); 350dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington if (format[len-1] == '\n') 351dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington need_pid = TRUE; 352dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington else 353dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington need_pid = FALSE; 354041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington 355041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington va_start (args, format); 356041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington vfprintf (stderr, format, args); 357041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington va_end (args); 358d6e1b2adb3d8e51ce1bb47295cef12d9fe1a15a8Havoc Pennington 359d6e1b2adb3d8e51ce1bb47295cef12d9fe1a15a8Havoc Pennington fflush (stderr); 360041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington} 361041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington 362041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington/** 363eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington * Reinitializes the verbose logging code, used 364eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington * as a hack in dbus-spawn.c so that a child 365eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington * process re-reads its pid 366eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington * 367eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington */ 368eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Penningtonvoid 369eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington_dbus_verbose_reset_real (void) 370eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington{ 371eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington verbose_initted = FALSE; 372eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington} 373eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington 3747bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington#endif /* DBUS_ENABLE_VERBOSE_MODE */ 3757bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington 376eb63ba5039c8afe61210cf2b217ec75b4a86356eHavoc Pennington/** 377954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * Duplicates a string. Result must be freed with 378954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * dbus_free(). Returns #NULL if memory allocation fails. 379954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * If the string to be duplicated is #NULL, returns #NULL. 380954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * 381954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @param str string to duplicate. 382954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington * @returns newly-allocated copy. 383954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington */ 384954c4c7550879bd80315811b8548adfcb415766eHavoc Penningtonchar* 385954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington_dbus_strdup (const char *str) 386954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington{ 387cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington size_t len; 388954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington char *copy; 389954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 390954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington if (str == NULL) 391954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington return NULL; 392954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 393954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington len = strlen (str); 394954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 395954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington copy = dbus_malloc (len + 1); 396954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington if (copy == NULL) 397954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington return NULL; 398954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 399954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington memcpy (copy, str, len + 1); 400954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 401954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington return copy; 402954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington} 403954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington 404cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington/** 405cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * Duplicates a block of memory. Returns 406cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * #NULL on failure. 407cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * 408cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * @param mem memory to copy 409cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * @param n_bytes number of bytes to copy 410cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington * @returns the copy 411cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington */ 412cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Penningtonvoid* 413cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington_dbus_memdup (const void *mem, 414cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington size_t n_bytes) 415cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington{ 416cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington void *copy; 417cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington 418cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington copy = dbus_malloc (n_bytes); 419cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington if (copy == NULL) 420cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington return NULL; 421cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington 422cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington memcpy (copy, mem, n_bytes); 423cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington 424cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington return copy; 425cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington} 426cefb84edc5f84011c5a171e5d052e37c56c55d27Havoc Pennington 427041b0767b284034aee09e9a0de2a3844b8cc546aHavoc Pennington/** 42844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * Duplicates a string array. Result may be freed with 42944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * dbus_free_string_array(). Returns #NULL if memory allocation fails. 43044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * If the array to be duplicated is #NULL, returns #NULL. 43144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * 43244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * @param array array to duplicate. 43344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * @returns newly-allocated copy. 43444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington */ 43544ed933284589134603913b05f55ca55e8c5a566Havoc Penningtonchar** 43644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington_dbus_dup_string_array (const char **array) 43744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington{ 43844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington int len; 43944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington int i; 44044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington char **copy; 44144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 44244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington if (array == NULL) 44344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return NULL; 44444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 44544ed933284589134603913b05f55ca55e8c5a566Havoc Pennington for (len = 0; array[len] != NULL; ++len) 44644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington ; 44744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 44844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington copy = dbus_new0 (char*, len + 1); 44944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington if (copy == NULL) 45044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return NULL; 45144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 45244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington i = 0; 45344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington while (i < len) 45444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington { 45544ed933284589134603913b05f55ca55e8c5a566Havoc Pennington copy[i] = _dbus_strdup (array[i]); 45644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington if (copy[i] == NULL) 45744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington { 45844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington dbus_free_string_array (copy); 45944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return NULL; 46044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington } 46144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 46244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington ++i; 46344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington } 46444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 46544ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return copy; 46644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington} 46744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 46844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington/** 46944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * Checks whether a string array contains the given string. 47044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * 47144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * @param array array to search. 47244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * @param str string to look for 47344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington * @returns #TRUE if array contains string 47444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington */ 47544ed933284589134603913b05f55ca55e8c5a566Havoc Penningtondbus_bool_t 47644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington_dbus_string_array_contains (const char **array, 47744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington const char *str) 47844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington{ 47944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington int i; 48044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 48144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington i = 0; 48244ed933284589134603913b05f55ca55e8c5a566Havoc Pennington while (array[i] != NULL) 48344ed933284589134603913b05f55ca55e8c5a566Havoc Pennington { 48444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington if (strcmp (array[i], str) == 0) 48544ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return TRUE; 48644ed933284589134603913b05f55ca55e8c5a566Havoc Pennington ++i; 48744ed933284589134603913b05f55ca55e8c5a566Havoc Pennington } 48844ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 48944ed933284589134603913b05f55ca55e8c5a566Havoc Pennington return FALSE; 49044ed933284589134603913b05f55ca55e8c5a566Havoc Pennington} 49144ed933284589134603913b05f55ca55e8c5a566Havoc Pennington 492d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington/** 493d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * Generates a new UUID. If you change how this is done, 494d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * there's some text about it in the spec that should also change. 495d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * 496d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param uuid the uuid to initialize 497d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 498d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtonvoid 499d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_generate_uuid (DBusGUID *uuid) 500d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 501d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington long now; 502d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington char *p; 503d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington int ts_size; 504d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 505d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_get_current_time (&now, NULL); 506d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 507d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington uuid->as_uint32s[0] = now; 508d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 509d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington ts_size = sizeof (uuid->as_uint32s[0]); 510d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington p = ((char*)uuid->as_bytes) + ts_size; 511d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 512d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_generate_random_bytes_buffer (p, 513d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington sizeof (uuid->as_bytes) - ts_size); 514d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 515d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 516d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington/** 517d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * Hex-encode a UUID. 518d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * 519d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param uuid the uuid 520d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param encoded string to append hex uuid to 521d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @returns #FALSE if no memory 522d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 523d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtondbus_bool_t 524d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_uuid_encode (const DBusGUID *uuid, 525d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusString *encoded) 526d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 527d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusString binary; 528d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_init_const_len (&binary, uuid->as_bytes, DBUS_UUID_LENGTH_BYTES); 529d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return _dbus_string_hex_encode (&binary, 0, encoded, _dbus_string_get_length (encoded)); 530d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 531d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 532d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtonstatic dbus_bool_t 533d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_read_uuid_file_without_creating (const DBusString *filename, 534d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusGUID *uuid, 535d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusError *error) 536d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 537d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusString contents; 538d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusString decoded; 539d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington int end; 540d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 541d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_init (&contents); 542d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_init (&decoded); 543d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 544d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_file_get_contents (&contents, filename, error)) 545d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 546d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 547d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_chop_white (&contents); 548d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 549d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (_dbus_string_get_length (&contents) != DBUS_UUID_LENGTH_HEX) 550d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 551d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_set_error (error, DBUS_ERROR_INVALID_FILE_CONTENT, 552d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington "UUID file '%s' should contain a hex string of length %d, not length %d, with no other text", 553d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_get_const_data (filename), 554d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBUS_UUID_LENGTH_HEX, 555d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_get_length (&contents)); 556d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 557d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 558d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 559d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_string_hex_decode (&contents, 0, &end, &decoded, 0)) 560d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 561d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_SET_OOM (error); 562d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 563d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 564d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 565d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (end == 0) 566d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 567d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_set_error (error, DBUS_ERROR_INVALID_FILE_CONTENT, 568d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington "UUID file '%s' contains invalid hex data", 569d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_get_const_data (filename)); 570d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 571d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 572d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 573d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (_dbus_string_get_length (&decoded) != DBUS_UUID_LENGTH_BYTES) 574d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 575d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_set_error (error, DBUS_ERROR_INVALID_FILE_CONTENT, 576d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington "UUID file '%s' contains %d bytes of hex-encoded data instead of %d", 577d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_get_const_data (filename), 578d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_get_length (&decoded), 579d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBUS_UUID_LENGTH_BYTES); 580d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 581d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 582d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 583d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_copy_to_buffer (&decoded, uuid->as_bytes, DBUS_UUID_LENGTH_BYTES); 584d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 585d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&decoded); 586d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&contents); 587d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 588d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_ASSERT_ERROR_IS_CLEAR (error); 589d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 590d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return TRUE; 591d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 592d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington error: 593d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_ASSERT_ERROR_IS_SET (error); 594d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&contents); 595d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&decoded); 596d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return FALSE; 597d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 598d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 599d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtonstatic dbus_bool_t 600d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_create_uuid_file_exclusively (const DBusString *filename, 601d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusGUID *uuid, 602d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusError *error) 603d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 604d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusString encoded; 605d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 606d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_init (&encoded); 607d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 608d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_generate_uuid (uuid); 609d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 610d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_uuid_encode (uuid, &encoded)) 611d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 612d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_SET_OOM (error); 613d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 614d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 615d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 616d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington /* FIXME this is racy; we need a save_file_exclusively 617d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * function. But in practice this should be fine for now. 618d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * 619d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * - first be sure we can create the file and it 620d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * doesn't exist by creating it empty with O_EXCL 621d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * - then create it by creating a temporary file and 622d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * overwriting atomically with rename() 623d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 624d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_create_file_exclusively (filename, error)) 625d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 626d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 627d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_string_append_byte (&encoded, '\n')) 628d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 629d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_SET_OOM (error); 630d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 631d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 632d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 633d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_string_save_to_file (&encoded, filename, error)) 634d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington goto error; 635d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 636d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 637d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&encoded); 638d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 639d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_ASSERT_ERROR_IS_CLEAR (error); 640d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return TRUE; 641d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 642d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington error: 643d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_ASSERT_ERROR_IS_SET (error); 644d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_string_free (&encoded); 645d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return FALSE; 646d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 647d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 648d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington/** 649d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * Reads (and optionally writes) a uuid to a file. Initializes the uuid 650d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * unless an error is returned. 651d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * 652d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param filename the name of the file 653d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param uuid uuid to be initialized with the loaded uuid 654d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param create_if_not_found #TRUE to create a new uuid and save it if the file doesn't exist 655d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param error the error return 656d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @returns #FALSE if the error is set 657d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 658d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtondbus_bool_t 659d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_read_uuid_file (const DBusString *filename, 660d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusGUID *uuid, 661d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_bool_t create_if_not_found, 662d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusError *error) 663d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 664d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusError read_error; 665d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 666d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_error_init (&read_error); 667d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 668d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (_dbus_read_uuid_file_without_creating (filename, uuid, &read_error)) 669d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return TRUE; 670d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 671d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!create_if_not_found) 672d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 673d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_move_error (&read_error, error); 674d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return FALSE; 675d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 676d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 677d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington /* If the file exists and contains junk, we want to keep that error 678d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * message instead of overwriting it with a "file exists" error 679d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * message when we try to write 680d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 681d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (dbus_error_has_name (&read_error, DBUS_ERROR_INVALID_FILE_CONTENT)) 682d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 683d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_move_error (&read_error, error); 684d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return FALSE; 685d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 686d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington else 687d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 688d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_error_free (&read_error); 689d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return _dbus_create_uuid_file_exclusively (filename, uuid, error); 690d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 691d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 692d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 693d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_DBUS_DEFINE_GLOBAL_LOCK (machine_uuid); 694d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtonstatic int machine_uuid_initialized_generation = 0; 695d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtonstatic DBusGUID machine_uuid; 696d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 697d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington/** 698d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * Gets the hex-encoded UUID of the machine this function is 699d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * executed on. This UUID is guaranteed to be the same for a given 700d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * machine at least until it next reboots, though it also 701d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * makes some effort to be the same forever, it may change if the 702d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * machine is reconfigured or its hardware is modified. 703d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * 704d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @param uuid_str string to append hex-encoded machine uuid to 705d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * @returns #FALSE if no memory 706d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 707d8155bf51bf6484a94e734601526bf211053a5e1Havoc Penningtondbus_bool_t 708d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington_dbus_get_local_machine_uuid_encoded (DBusString *uuid_str) 709d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington{ 710d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_bool_t ok; 711d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 712d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_LOCK (machine_uuid); 713d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (machine_uuid_initialized_generation != _dbus_current_generation) 714d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 715d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington DBusError error; 716d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_error_init (&error); 717d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington if (!_dbus_read_local_machine_uuid (&machine_uuid, FALSE, 718d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington &error)) 719d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington { 720d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington#ifndef DBUS_BUILD_TESTS 721d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington /* For the test suite, we may not be installed so just continue silently 722d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * here. But in a production build, we want to be nice and loud about 723d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington * this. 724d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington */ 725f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington _dbus_warn_check_failed ("D-Bus library appears to be incorrectly set up; failed to read machine uuid: %s\n" 726f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington "See the manual page for dbus-uuidgen to correct this issue.\n", 727f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington error.message); 728d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington#endif 729d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 730d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington dbus_error_free (&error); 731d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 732d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _dbus_generate_uuid (&machine_uuid); 733d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 734d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington } 735d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 736d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington ok = _dbus_uuid_encode (&machine_uuid, uuid_str); 737d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 738d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington _DBUS_UNLOCK (machine_uuid); 739d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 740d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington return ok; 741d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington} 742d8155bf51bf6484a94e734601526bf211053a5e1Havoc Pennington 7437bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington#ifdef DBUS_BUILD_TESTS 74444ed933284589134603913b05f55ca55e8c5a566Havoc Pennington/** 745daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin * Returns a string describing the given name. 746daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin * 747daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin * @param header_field the field to describe 748daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin * @returns a constant string describing the field 749daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin */ 750daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlinconst char * 751daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin_dbus_header_field_to_string (int header_field) 752daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin{ 753daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin switch (header_field) 754daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin { 755daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_INVALID: 756daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "invalid"; 757daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_PATH: 758daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "path"; 759daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_INTERFACE: 760daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "interface"; 761daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_MEMBER: 762daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "member"; 763daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_ERROR_NAME: 764daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "error-name"; 765daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin case DBUS_HEADER_FIELD_REPLY_SERIAL: 766daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "reply-serial"; 767c24e6e11a6f9cabfd0311242f8388c8d82e840dcJohn (J case DBUS_HEADER_FIELD_DESTINATION: 768c24e6e11a6f9cabfd0311242f8388c8d82e840dcJohn (J return "destination"; 769c24e6e11a6f9cabfd0311242f8388c8d82e840dcJohn (J case DBUS_HEADER_FIELD_SENDER: 770c24e6e11a6f9cabfd0311242f8388c8d82e840dcJohn (J return "sender"; 771dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington case DBUS_HEADER_FIELD_SIGNATURE: 772dbdea921b5967ed25b24a9e5af5d6a3db54c5ec7Havoc Pennington return "signature"; 773daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin default: 774daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin return "unknown"; 775daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin } 776daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin} 7777bf62e31a3c820852271768fafc04ba95c31a19fHavoc Pennington#endif /* DBUS_BUILD_TESTS */ 778daf8d6579e1ae0ea748810b63180bd5eea2ab9c4Mark McLoughlin 779c9cd648f115759176d35508e9007dc5520a0dd3fHavoc Pennington#ifndef DBUS_DISABLE_CHECKS 78085ab0327d82e4945ad16630e583d8cc68df25a90Havoc Pennington/** String used in _dbus_return_if_fail macro */ 781c9cd648f115759176d35508e9007dc5520a0dd3fHavoc Penningtonconst char _dbus_return_if_fail_warning_format[] = 782f1ca9b89e92de4d876dc5e7e85710c4d2dc87638Havoc Pennington"arguments to %s() were incorrect, assertion \"%s\" failed in file %s line %d.\n" 7837652304bff969afb3969603149bb385efe861fe8John (J"This is normally a bug in some application using the D-Bus library.\n"; 784c9cd648f115759176d35508e9007dc5520a0dd3fHavoc Pennington#endif 785c9cd648f115759176d35508e9007dc5520a0dd3fHavoc Pennington 7862f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington#ifndef DBUS_DISABLE_ASSERT 7872f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington/** 7882f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * Internals of _dbus_assert(); it's a function 7892f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * rather than a macro with the inline code so 7902f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * that the assertion failure blocks don't show up 7912f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * in test suite coverage, and to shrink code size. 7922f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * 7932f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param condition TRUE if assertion succeeded 7942f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param condition_text condition as a string 7952f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param file file the assertion is in 7962f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param line line the assertion is in 797aad6fa897f85486386b030847151cb09943c97c0Havoc Pennington * @param func function the assertion is in 7982f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington */ 7992f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Penningtonvoid 8002f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington_dbus_real_assert (dbus_bool_t condition, 8012f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington const char *condition_text, 8022f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington const char *file, 803aad6fa897f85486386b030847151cb09943c97c0Havoc Pennington int line, 804aad6fa897f85486386b030847151cb09943c97c0Havoc Pennington const char *func) 8052f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington{ 80675742242000e782719bc1656f0a7da72b059e88eHavoc Pennington if (_DBUS_UNLIKELY (!condition)) 8072f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington { 808aad6fa897f85486386b030847151cb09943c97c0Havoc Pennington _dbus_warn ("%lu: assertion failed \"%s\" file \"%s\" line %d function %s\n", 809aad6fa897f85486386b030847151cb09943c97c0Havoc Pennington _dbus_getpid (), condition_text, file, line, func); 8102f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington _dbus_abort (); 8112f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington } 8122f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington} 8132f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington 8142f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington/** 8152f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * Internals of _dbus_assert_not_reached(); it's a function 8162f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * rather than a macro with the inline code so 8172f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * that the assertion failure blocks don't show up 8182f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * in test suite coverage, and to shrink code size. 8192f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * 8202f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param explanation what was reached that shouldn't have been 8212f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param file file the assertion is in 8222f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington * @param line line the assertion is in 8232f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington */ 8242f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Penningtonvoid 8252f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington_dbus_real_assert_not_reached (const char *explanation, 8262f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington const char *file, 8272f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington int line) 8282f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington{ 82951781f541094a4936d47119cd62682e0431c41e9Havoc Pennington _dbus_warn ("File \"%s\" line %d process %lu should not have been reached: %s\n", 83051781f541094a4936d47119cd62682e0431c41e9Havoc Pennington file, line, _dbus_getpid (), explanation); 8312f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington _dbus_abort (); 8322f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington} 8332f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington#endif /* DBUS_DISABLE_ASSERT */ 8342f3fbd451d2bed1737052c672974e3dc31ad015fHavoc Pennington 83518c470cd2c7245f33f5d924d23972e95e3d347a0Havoc Pennington#ifdef DBUS_BUILD_TESTS 836bf99381351b802fb3348a24037898222aae631e2Havoc Penningtonstatic dbus_bool_t 837bf99381351b802fb3348a24037898222aae631e2Havoc Penningtonrun_failing_each_malloc (int n_mallocs, 838bf99381351b802fb3348a24037898222aae631e2Havoc Pennington const char *description, 839bf99381351b802fb3348a24037898222aae631e2Havoc Pennington DBusTestMemoryFunction func, 840bf99381351b802fb3348a24037898222aae631e2Havoc Pennington void *data) 841bf99381351b802fb3348a24037898222aae631e2Havoc Pennington{ 842bf99381351b802fb3348a24037898222aae631e2Havoc Pennington n_mallocs += 10; /* fudge factor to ensure reallocs etc. are covered */ 843bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 844bf99381351b802fb3348a24037898222aae631e2Havoc Pennington while (n_mallocs >= 0) 845bf99381351b802fb3348a24037898222aae631e2Havoc Pennington { 846bf99381351b802fb3348a24037898222aae631e2Havoc Pennington _dbus_set_fail_alloc_counter (n_mallocs); 847bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 848bf99381351b802fb3348a24037898222aae631e2Havoc Pennington _dbus_verbose ("\n===\n%s: (will fail malloc %d with %d failures)\n===\n", 849bf99381351b802fb3348a24037898222aae631e2Havoc Pennington description, n_mallocs, 850bf99381351b802fb3348a24037898222aae631e2Havoc Pennington _dbus_get_fail_alloc_failures ()); 851bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 852bf99381351b802fb3348a24037898222aae631e2Havoc Pennington if (!(* func) (data)) 853bf99381351b802fb3348a24037898222aae631e2Havoc Pennington return FALSE; 854bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 855bf99381351b802fb3348a24037898222aae631e2Havoc Pennington n_mallocs -= 1; 856bf99381351b802fb3348a24037898222aae631e2Havoc Pennington } 857bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 858bf99381351b802fb3348a24037898222aae631e2Havoc Pennington _dbus_set_fail_alloc_counter (_DBUS_INT_MAX); 859bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 860bf99381351b802fb3348a24037898222aae631e2Havoc Pennington return TRUE; 861bf99381351b802fb3348a24037898222aae631e2Havoc Pennington} 862bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 863bf99381351b802fb3348a24037898222aae631e2Havoc Pennington/** 864bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * Tests how well the given function responds to out-of-memory 865bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * situations. Calls the function repeatedly, failing a different 866bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * call to malloc() each time. If the function ever returns #FALSE, 867bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * the test fails. The function should return #TRUE whenever something 868bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * valid (such as returning an error, or succeeding) occurs, and #FALSE 869bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * if it gets confused in some way. 870bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * 871bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * @param description description of the test used in verbose output 872bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * @param func function to call 873bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * @param data data to pass to function 874bf99381351b802fb3348a24037898222aae631e2Havoc Pennington * @returns #TRUE if the function never returns FALSE 875bf99381351b802fb3348a24037898222aae631e2Havoc Pennington */ 876bf99381351b802fb3348a24037898222aae631e2Havoc Penningtondbus_bool_t 877bf99381351b802fb3348a24037898222aae631e2Havoc Pennington_dbus_test_oom_handling (const char *description, 878bf99381351b802fb3348a24037898222aae631e2Havoc Pennington DBusTestMemoryFunction func, 879bf99381351b802fb3348a24037898222aae631e2Havoc Pennington void *data) 880bf99381351b802fb3348a24037898222aae631e2Havoc Pennington{ 881bf99381351b802fb3348a24037898222aae631e2Havoc Pennington int approx_mallocs; 8829c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington const char *setting; 8839c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington int max_failures_to_try; 8849c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington int i; 885bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 886bf99381351b802fb3348a24037898222aae631e2Havoc Pennington /* Run once to see about how many mallocs are involved */ 887bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 888bf99381351b802fb3348a24037898222aae631e2Havoc Pennington _dbus_set_fail_alloc_counter (_DBUS_INT_MAX); 889bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 89051781f541094a4936d47119cd62682e0431c41e9Havoc Pennington _dbus_verbose ("Running once to count mallocs\n"); 89151781f541094a4936d47119cd62682e0431c41e9Havoc Pennington 892bf99381351b802fb3348a24037898222aae631e2Havoc Pennington if (!(* func) (data)) 893bf99381351b802fb3348a24037898222aae631e2Havoc Pennington return FALSE; 894bc86794f23fa538a405813fb61b531c2eacc9ae1Havoc Pennington 895bf99381351b802fb3348a24037898222aae631e2Havoc Pennington approx_mallocs = _DBUS_INT_MAX - _dbus_get_fail_alloc_counter (); 896bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 89751781f541094a4936d47119cd62682e0431c41e9Havoc Pennington _dbus_verbose ("\n=================\n%s: about %d mallocs total\n=================\n", 898bf99381351b802fb3348a24037898222aae631e2Havoc Pennington description, approx_mallocs); 899bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 9009c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington setting = _dbus_getenv ("DBUS_TEST_MALLOC_FAILURES"); 9019c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington if (setting != NULL) 9029c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington { 9039c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington DBusString str; 9049c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington long v; 9059c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington _dbus_string_init_const (&str, setting); 9069c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington v = 4; 9079c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington if (!_dbus_string_parse_int (&str, 0, &v, NULL)) 9089c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington _dbus_warn ("couldn't parse '%s' as integer\n", setting); 9099c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington max_failures_to_try = v; 9109c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington } 9119c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington else 9129c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington { 9139c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington max_failures_to_try = 4; 9149c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington } 915bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 9169c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington i = setting ? max_failures_to_try - 1 : 1; 9179c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington while (i < max_failures_to_try) 9189c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington { 9199c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington _dbus_set_fail_alloc_failures (i); 9209c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington if (!run_failing_each_malloc (approx_mallocs, description, func, data)) 9219c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington return FALSE; 9229c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington ++i; 9239c3d566e95c9080f6040c64531b0ccae22bd5d74Havoc Pennington } 924bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 92551781f541094a4936d47119cd62682e0431c41e9Havoc Pennington _dbus_verbose ("\n=================\n%s: all iterations passed\n=================\n", 926bf99381351b802fb3348a24037898222aae631e2Havoc Pennington description); 927bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 928bf99381351b802fb3348a24037898222aae631e2Havoc Pennington return TRUE; 929bf99381351b802fb3348a24037898222aae631e2Havoc Pennington} 93018c470cd2c7245f33f5d924d23972e95e3d347a0Havoc Pennington#endif /* DBUS_BUILD_TESTS */ 931bf99381351b802fb3348a24037898222aae631e2Havoc Pennington 932954c4c7550879bd80315811b8548adfcb415766eHavoc Pennington/** @} */ 933