|
Packit |
5e46da |
/*
|
|
Packit |
5e46da |
* This file is part of libbluray
|
|
Packit |
5e46da |
* Copyright (C) 2013 Petri Hintukainen <phintuka@users.sourceforge.net>
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* This library is free software; you can redistribute it and/or
|
|
Packit |
5e46da |
* modify it under the terms of the GNU Lesser General Public
|
|
Packit |
5e46da |
* License as published by the Free Software Foundation; either
|
|
Packit |
5e46da |
* version 2.1 of the License, or (at your option) any later version.
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* This library is distributed in the hope that it will be useful,
|
|
Packit |
5e46da |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
5e46da |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Packit |
5e46da |
* Lesser General Public License for more details.
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* You should have received a copy of the GNU Lesser General Public
|
|
Packit |
5e46da |
* License along with this library. If not, see
|
|
Packit |
5e46da |
* <http://www.gnu.org/licenses/>.
|
|
Packit |
5e46da |
*/
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#ifndef BD_REFCNT_H_
|
|
Packit |
5e46da |
#define BD_REFCNT_H_
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#ifdef __cplusplus
|
|
Packit |
5e46da |
extern "C" {
|
|
Packit |
5e46da |
#endif
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#include "attributes.h"
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#include <stddef.h>
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#ifdef MACRO_H_
|
|
Packit |
5e46da |
# error macro.h included before refcnt.h
|
|
Packit |
5e46da |
#endif
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
/*
|
|
Packit |
5e46da |
* Reference-counted memory blocks.
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* - Object must be allocated with refcnt_realloc(NULL, size).
|
|
Packit |
5e46da |
* Returned object has reference count of 1.
|
|
Packit |
5e46da |
* - Object can be re-allocated with refcnt_realloc(obj, size)
|
|
Packit |
5e46da |
* as long as bd_refcnt_inc() has not been called.
|
|
Packit |
5e46da |
* - Object must be freed with bd_refcnt_dec().
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* by default, reference counting is not used (use count = 1).
|
|
Packit |
5e46da |
* Reference counting is initialized during first call to bd_refcnt_inc().
|
|
Packit |
5e46da |
* This results in reference count = 2.
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
* This is thread-safe as long as first bd_refcnt_inc() is done from the
|
|
Packit |
5e46da |
* same thread that owns the object initially.
|
|
Packit |
5e46da |
*
|
|
Packit |
5e46da |
*/
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
BD_PRIVATE void *refcnt_realloc(void *obj, size_t sz);
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#ifndef BD_OVERLAY_INTERFACE_VERSION
|
|
Packit |
5e46da |
void bd_refcnt_inc(const void *obj);
|
|
Packit |
5e46da |
void bd_refcnt_dec(const void *obj);
|
|
Packit |
5e46da |
#endif
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#ifdef __cplusplus
|
|
Packit |
5e46da |
}
|
|
Packit |
5e46da |
#endif
|
|
Packit |
5e46da |
|
|
Packit |
5e46da |
#endif // BD_REFCNT_H_
|