dbus-internals.c revision aad6fa897f85486386b030847151cb09943c97c0
10d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/* -*- mode: C; c-file-style: "gnu" -*- */ 20d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/* dbus-internals.c random utility stuff (internal to D-BUS implementation) 30d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 40d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Copyright (C) 2002, 2003 Red Hat, Inc. 50d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 60d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Licensed under the Academic Free License version 2.1 70d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 80d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * This program is free software; you can redistribute it and/or modify 90d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * it under the terms of the GNU General Public License as published by 100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * the Free Software Foundation; either version 2 of the License, or 110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * (at your option) any later version. 120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * This program is distributed in the hope that it will be useful, 140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * but WITHOUT ANY WARRANTY; without even the implied warranty of 150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 160d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * GNU General Public License for more details. 170d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 180d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * You should have received a copy of the GNU General Public License 190d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * along with this program; if not, write to the Free Software 200d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 210d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 220d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 230d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include "dbus-internals.h" 240d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include "dbus-protocol.h" 250d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include "dbus-test.h" 260d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <stdio.h> 270d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <stdarg.h> 280d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <string.h> 290d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <sys/types.h> 300d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <errno.h> 310d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <unistd.h> 320d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <fcntl.h> 330d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#include <stdlib.h> 340d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 350d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 360d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @defgroup DBusInternals D-BUS internal implementation details 370d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @brief Documentation useful when developing or debugging D-BUS itself. 380d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 390d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 400d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 410d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 420d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @defgroup DBusInternalsUtils Utilities and portability 430d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @ingroup DBusInternals 440d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @brief Utility functions (_dbus_assert(), _dbus_warn(), etc.) 450d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @{ 460d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 470d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 480d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 490d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _dbus_assert 500d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 510d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Aborts with an error message if the condition is false. 520d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 530d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param condition condition which must be true. 540d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 550d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 560d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 570d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _dbus_assert_not_reached 580d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 590d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Aborts with an error message if called. 600d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * The given explanation will be printed. 610d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 620d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param explanation explanation of what happened if the code was reached. 630d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 640d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 650d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 660d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_N_ELEMENTS 670d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 680d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Computes the number of elements in a fixed-size array using 690d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * sizeof(). 700d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 710d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param array the array to count elements in. 720d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 730d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 740d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 750d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_POINTER_TO_INT 760d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 770d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Safely casts a void* to an integer; should only be used on void* 780d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * that actually contain integers, for example one created with 790d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * _DBUS_INT_TO_POINTER. Only guaranteed to preserve 32 bits. 800d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * (i.e. it's used to store 32-bit ints in pointers, but 810d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * can't be used to store 64-bit pointers in ints.) 820d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 830d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param pointer pointer to extract an integer from. 840d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 850d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 860d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_INT_TO_POINTER 870d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 880d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Safely stuffs an integer into a pointer, to be extracted later with 890d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * _DBUS_POINTER_TO_INT. Only guaranteed to preserve 32 bits. 900d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 910d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param integer the integer to stuff into a pointer. 920d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 930d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 940d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_ZERO 950d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 960d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Sets all bits in an object to zero. 970d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 980d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param object the object to be zeroed. 990d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1000d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1010d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_INT_MIN 1020d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1030d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Minimum value of type "int" 1040d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1050d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1060d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_INT_MAX 1070d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1080d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Maximum value of type "int" 1090d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @typedef DBusForeachFunction 1130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Used to iterate over each item in a collection, such as 1150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * a DBusList. 1160d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1170d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1180d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1190d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_LOCK_NAME 1200d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1210d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Expands to name of a global lock variable. 1220d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1230d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1240d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1250d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_DEFINE_GLOBAL_LOCK 1260d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1270d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Defines a global lock variable with the given name. 1280d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * The lock must be added to the list to initialize 1290d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * in dbus_threads_init(). 1300d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1310d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1320d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1330d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_DECLARE_GLOBAL_LOCK 1340d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1350d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Expands to declaration of a global lock defined 1360d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * with _DBUS_DEFINE_GLOBAL_LOCK. 1370d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * The lock must be added to the list to initialize 1380d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * in dbus_threads_init(). 1390d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1400d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1410d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1420d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_LOCK 1430d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1440d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Locks a global lock 1450d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1460d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1470d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1480d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @def _DBUS_UNLOCK 1490d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1500d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Unlocks a global lock 1510d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1520d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1530d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1540d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Fixed "out of memory" error message, just to avoid 1550d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * making up a different string every time and wasting 1560d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * space. 1570d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1580d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarconst char _dbus_no_memory_message[] = "Not enough memory"; 1590d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1600d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1610d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Prints a warning message to stderr. 1620d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1630d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param format printf-style format string. 1640d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1650d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid 1660d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_warn (const char *format, 1670d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar ...) 1680d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 1690d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar /* FIXME not portable enough? */ 1700d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_list args; 1710d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1720d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_start (args, format); 1730d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar vfprintf (stderr, format, args); 1740d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_end (args); 1750d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 1760d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1770d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarstatic dbus_bool_t verbose_initted = FALSE; 1780d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1790d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 1800d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Prints a warning message to stderr 1810d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * if the user has enabled verbose mode. 1820d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * This is the real function implementation, 1830d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * use _dbus_verbose() macro in code. 1840d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 1850d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param format printf-style format string. 1860d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 1870d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid 1880d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_verbose_real (const char *format, 1890d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar ...) 1900d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 1910d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_list args; 1920d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar static dbus_bool_t verbose = TRUE; 1930d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar static dbus_bool_t need_pid = TRUE; 1940d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int len; 1950d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 1960d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar /* things are written a bit oddly here so that 1970d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * in the non-verbose case we just have the one 1980d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * conditional and return immediately. 1990d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 2000d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (!verbose) 2010d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return; 2020d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2030d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (!verbose_initted) 2040d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 2050d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar verbose = _dbus_getenv ("DBUS_VERBOSE") != NULL; 2060d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar verbose_initted = TRUE; 2070d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (!verbose) 2080d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return; 2090d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 2100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar /* Print out pid before the line */ 2120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (need_pid) 2130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar fprintf (stderr, "%lu: ", _dbus_getpid ()); 2140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar /* Only print pid again if the next line is a new line */ 2160d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar len = strlen (format); 2170d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (format[len-1] == '\n') 2180d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar need_pid = TRUE; 2190d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar else 2200d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar need_pid = FALSE; 2210d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2220d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_start (args, format); 2230d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar vfprintf (stderr, format, args); 2240d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar va_end (args); 2250d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2260d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar fflush (stderr); 2270d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 2280d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2290d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 2300d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Reinitializes the verbose logging code, used 2310d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * as a hack in dbus-spawn.c so that a child 2320d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * process re-reads its pid 2330d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 2340d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 2350d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid 2360d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_verbose_reset_real (void) 2370d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 2380d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar verbose_initted = FALSE; 2390d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 2400d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2410d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 2420d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Duplicates a string. Result must be freed with 2430d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * dbus_free(). Returns #NULL if memory allocation fails. 2440d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * If the string to be duplicated is #NULL, returns #NULL. 2450d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 2460d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param str string to duplicate. 2470d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns newly-allocated copy. 2480d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 2490d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarchar* 2500d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_strdup (const char *str) 2510d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 2520d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar size_t len; 2530d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar char *copy; 2540d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2550d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (str == NULL) 2560d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 2570d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2580d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar len = strlen (str); 2590d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2600d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar copy = dbus_malloc (len + 1); 2610d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (copy == NULL) 2620d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 2630d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2640d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar memcpy (copy, str, len + 1); 2650d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2660d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return copy; 2670d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 2680d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2690d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 2700d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Duplicates a block of memory. Returns 2710d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * #NULL on failure. 2720d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 2730d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param mem memory to copy 2740d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param n_bytes number of bytes to copy 2750d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns the copy 2760d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 2770d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid* 2780d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_memdup (const void *mem, 2790d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar size_t n_bytes) 2800d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 2810d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar void *copy; 2820d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2830d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar copy = dbus_malloc (n_bytes); 2840d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (copy == NULL) 2850d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 2860d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2870d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar memcpy (copy, mem, n_bytes); 2880d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2890d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return copy; 2900d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 2910d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 2920d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 2930d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Duplicates a string array. Result may be freed with 2940d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * dbus_free_string_array(). Returns #NULL if memory allocation fails. 2950d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * If the array to be duplicated is #NULL, returns #NULL. 2960d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 2970d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param array array to duplicate. 2980d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns newly-allocated copy. 2990d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 3000d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarchar** 3010d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_dup_string_array (const char **array) 3020d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 3030d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int len; 3040d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int i; 3050d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar char **copy; 3060d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3070d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (array == NULL) 3080d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 3090d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar for (len = 0; array[len] != NULL; ++len) 3110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar ; 3120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar copy = dbus_new0 (char*, len + 1); 3140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (copy == NULL) 3150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 3160d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3170d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar i = 0; 3180d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar while (i < len) 3190d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 3200d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar copy[i] = _dbus_strdup (array[i]); 3210d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (copy[i] == NULL) 3220d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 3230d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar dbus_free_string_array (copy); 3240d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return NULL; 3250d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 3260d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3270d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar ++i; 3280d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 3290d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3300d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return copy; 3310d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 3320d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3330d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 3340d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Checks whether a string array contains the given string. 3350d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 3360d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param array array to search. 3370d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param str string to look for 3380d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns #TRUE if array contains string 3390d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 3400d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakardbus_bool_t 3410d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_string_array_contains (const char **array, 3420d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *str) 3430d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 3440d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int i; 3450d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3460d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar i = 0; 3470d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar while (array[i] != NULL) 3480d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 3490d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (strcmp (array[i], str) == 0) 3500d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return TRUE; 3510d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar ++i; 3520d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 3530d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3540d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return FALSE; 3550d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 3560d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3570d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 3580d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Returns a string describing the given name. 3590d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 3600d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param header_field the field to describe 3610d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns a constant string describing the field 3620d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 3630d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarconst char * 3640d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_header_field_to_string (int header_field) 3650d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 3660d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar switch (header_field) 3670d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 3680d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_INVALID: 3690d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "invalid"; 3700d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_PATH: 3710d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "path"; 3720d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_INTERFACE: 3730d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "interface"; 3740d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_MEMBER: 3750d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "member"; 3760d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_ERROR_NAME: 3770d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "error-name"; 3780d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_REPLY_SERIAL: 3790d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "reply-serial"; 3800d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_DESTINATION: 3810d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "destination"; 3820d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_SENDER: 3830d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "sender"; 3840d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar case DBUS_HEADER_FIELD_SIGNATURE: 3850d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "signature"; 3860d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar default: 3870d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return "unknown"; 3880d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 3890d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 3900d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3910d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#ifndef DBUS_DISABLE_CHECKS 3920d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** String used in _dbus_return_if_fail macro */ 3930d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarconst char _dbus_return_if_fail_warning_format[] = 3940d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar"%lu: arguments to %s() were incorrect, assertion \"%s\" failed in file %s line %d.\n" 3950d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar"This is normally a bug in some application using the D-BUS library.\n"; 3960d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#endif 3970d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 3980d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#ifndef DBUS_DISABLE_ASSERT 3990d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 4000d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Internals of _dbus_assert(); it's a function 4010d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * rather than a macro with the inline code so 4020d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * that the assertion failure blocks don't show up 4030d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * in test suite coverage, and to shrink code size. 4040d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 4050d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param condition TRUE if assertion succeeded 4060d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param condition_text condition as a string 4070d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param file file the assertion is in 4080d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param line line the assertion is in 4090d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param func function the assertion is in 4100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 4110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid 4120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_real_assert (dbus_bool_t condition, 4130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *condition_text, 4140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *file, 4150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int line, 4160d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *func) 4170d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 4180d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (_DBUS_UNLIKELY (!condition)) 4190d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 4200d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_warn ("%lu: assertion failed \"%s\" file \"%s\" line %d function %s\n", 4210d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_getpid (), condition_text, file, line, func); 4220d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_abort (); 4230d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 4240d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 4250d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4260d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 4270d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Internals of _dbus_assert_not_reached(); it's a function 4280d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * rather than a macro with the inline code so 4290d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * that the assertion failure blocks don't show up 4300d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * in test suite coverage, and to shrink code size. 4310d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 4320d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param explanation what was reached that shouldn't have been 4330d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param file file the assertion is in 4340d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param line line the assertion is in 4350d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 4360d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarvoid 4370d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_real_assert_not_reached (const char *explanation, 4380d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *file, 4390d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int line) 4400d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 4410d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_warn ("File \"%s\" line %d process %lu should not have been reached: %s\n", 4420d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar file, line, _dbus_getpid (), explanation); 4430d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_abort (); 4440d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 4450d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#endif /* DBUS_DISABLE_ASSERT */ 4460d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4470d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar#ifdef DBUS_BUILD_TESTS 4480d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarstatic dbus_bool_t 4490d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakarrun_failing_each_malloc (int n_mallocs, 4500d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *description, 4510d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar DBusTestMemoryFunction func, 4520d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar void *data) 4530d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 4540d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar n_mallocs += 10; /* fudge factor to ensure reallocs etc. are covered */ 4550d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4560d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar while (n_mallocs >= 0) 4570d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 4580d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_set_fail_alloc_counter (n_mallocs); 4590d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4600d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_verbose ("\n===\n%s: (will fail malloc %d with %d failures)\n===\n", 4610d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar description, n_mallocs, 4620d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_get_fail_alloc_failures ()); 4630d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4640d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (!(* func) (data)) 4650d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return FALSE; 4660d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4670d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar n_mallocs -= 1; 4680d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar } 4690d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4700d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_set_fail_alloc_counter (_DBUS_INT_MAX); 4710d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4720d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return TRUE; 4730d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar} 4740d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4750d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar/** 4760d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * Tests how well the given function responds to out-of-memory 4770d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * situations. Calls the function repeatedly, failing a different 4780d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * call to malloc() each time. If the function ever returns #FALSE, 4790d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * the test fails. The function should return #TRUE whenever something 4800d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * valid (such as returning an error, or succeeding) occurs, and #FALSE 4810d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * if it gets confused in some way. 4820d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * 4830d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param description description of the test used in verbose output 4840d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param func function to call 4850d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @param data data to pass to function 4860d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar * @returns #TRUE if the function never returns FALSE 4870d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar */ 4880d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakardbus_bool_t 4890d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar_dbus_test_oom_handling (const char *description, 4900d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar DBusTestMemoryFunction func, 4910d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar void *data) 4920d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar{ 4930d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int approx_mallocs; 4940d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar const char *setting; 4950d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int max_failures_to_try; 4960d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar int i; 4970d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 4980d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar /* Run once to see about how many mallocs are involved */ 4990d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5000d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_set_fail_alloc_counter (_DBUS_INT_MAX); 5010d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5020d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_verbose ("Running once to count mallocs\n"); 5030d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5040d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (!(* func) (data)) 5050d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar return FALSE; 5060d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5070d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar approx_mallocs = _DBUS_INT_MAX - _dbus_get_fail_alloc_counter (); 5080d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5090d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar _dbus_verbose ("\n=================\n%s: about %d mallocs total\n=================\n", 5100d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar description, approx_mallocs); 5110d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar 5120d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar setting = _dbus_getenv ("DBUS_TEST_MALLOC_FAILURES"); 5130d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar if (setting != NULL) 5140d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar { 5150d8951cef4b1a1dbf4ff5ba3e8796cf1d4503098Harish Mahendrakar DBusString str; 516 long v; 517 _dbus_string_init_const (&str, setting); 518 v = 4; 519 if (!_dbus_string_parse_int (&str, 0, &v, NULL)) 520 _dbus_warn ("couldn't parse '%s' as integer\n", setting); 521 max_failures_to_try = v; 522 } 523 else 524 { 525 max_failures_to_try = 4; 526 } 527 528 i = setting ? max_failures_to_try - 1 : 1; 529 while (i < max_failures_to_try) 530 { 531 _dbus_set_fail_alloc_failures (i); 532 if (!run_failing_each_malloc (approx_mallocs, description, func, data)) 533 return FALSE; 534 ++i; 535 } 536 537 _dbus_verbose ("\n=================\n%s: all iterations passed\n=================\n", 538 description); 539 540 return TRUE; 541} 542#endif /* DBUS_BUILD_TESTS */ 543 544/** @} */ 545