dbus-dataslot.h 3.76 KB
Newer Older
1
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 3 4 5
/* dbus-dataslot.h  storing data on objects
 *
 * Copyright (C) 2003 Red Hat, Inc.
 *
6
 * Licensed under the Academic Free License version 2.1
7 8 9 10 11 12 13 14 15 16 17 18 19
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
20
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
21 22 23 24 25 26 27
 *
 */
#ifndef DBUS_DATASLOT_H
#define DBUS_DATASLOT_H

#include <dbus/dbus-internals.h>

28
DBUS_BEGIN_DECLS
29 30 31 32 33 34 35 36 37 38 39 40 41

typedef struct DBusDataSlotAllocator DBusDataSlotAllocator;
typedef struct DBusDataSlotList DBusDataSlotList;

/** Opaque typedef for DBusDataSlot */
typedef struct DBusDataSlot DBusDataSlot;
/** DBusDataSlot is used to store application data on the connection */
struct DBusDataSlot
{
  void *data;                      /**< The application data */
  DBusFreeFunction free_data_func; /**< Free the application data */
};

42
typedef struct DBusAllocatedSlot DBusAllocatedSlot;
43 44 45

/** An allocated slot for storing data
 */
46 47 48 49 50 51
struct DBusAllocatedSlot
{
  dbus_int32_t slot_id;  /**< ID of this slot */
  int          refcount; /**< Number of uses of the slot */
};

52 53 54
/**
 * An allocator that tracks a set of slot IDs.
 */
55 56
struct DBusDataSlotAllocator
{
57
  DBusAllocatedSlot *allocated_slots; /**< Allocated slots */
58 59
  int  n_allocated_slots; /**< number of slots malloc'd */
  int  n_used_slots;      /**< number of slots used */
60
  DBusGlobalLock lock;    /**< index of thread lock */
61 62
};

63 64
#define _DBUS_DATA_SLOT_ALLOCATOR_INIT(x) { NULL, 0, 0, x }

65 66 67 68
/**
 * Data structure that stores the actual user data set at a given
 * slot.
 */
69 70 71 72 73 74
struct DBusDataSlotList
{
  DBusDataSlot *slots;   /**< Data slots */
  int           n_slots; /**< Slots we have storage for in data_slots */
};

75 76
dbus_bool_t _dbus_data_slot_allocator_init  (DBusDataSlotAllocator  *allocator,
                                             DBusGlobalLock          lock);
77 78
dbus_bool_t _dbus_data_slot_allocator_alloc (DBusDataSlotAllocator  *allocator,
                                             int                    *slot_id_p);
79
void        _dbus_data_slot_allocator_free  (DBusDataSlotAllocator  *allocator,
80
                                             int                    *slot_id_p);
81 82 83 84 85 86 87 88 89 90 91
void        _dbus_data_slot_list_init       (DBusDataSlotList       *list);
dbus_bool_t _dbus_data_slot_list_set        (DBusDataSlotAllocator  *allocator,
                                             DBusDataSlotList       *list,
                                             int                     slot,
                                             void                   *data,
                                             DBusFreeFunction        free_data_func,
                                             DBusFreeFunction       *old_free_func,
                                             void                  **old_data);
void*       _dbus_data_slot_list_get        (DBusDataSlotAllocator  *allocator,
                                             DBusDataSlotList       *list,
                                             int                     slot);
92
void        _dbus_data_slot_list_clear      (DBusDataSlotList       *list);
93
void        _dbus_data_slot_list_free       (DBusDataSlotList       *list);
94 95


96
DBUS_END_DECLS
97 98

#endif /* DBUS_DATASLOT_H */