vchoi_fork

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

 * Copyright by The HDF Group.                                               *

 * Copyright by the Board of Trustees of the University of Illinois.         *

 * All rights reserved.                                                      *

 *                                                                           *

 * This file is part of HDF5.  The full HDF5 copyright notice, including     *

 * terms governing use, modification, and redistribution, is contained in    *

 * the files COPYING and Copyright.html.  COPYING can be found at the root   *

 * of the source code distribution tree; Copyright.html can be found at the  *

 * root level of an installed copy of the electronic HDF5 document set and   *

 * is linked from the top-level documents page.  It can also be found at     *

 * http://hdfgroup.org/HDF5/doc/Copyright.html.  If you do not have          *

 * access to either file, you may request a copy from help@hdfgroup.org.     *

 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

​

/*

 * Reference counting buffer algorithms.

 *

 * These are used for various internal buffers which are shared.

 *

 * The module used to be H5RC, but changed to H5UC because of 

 * conflicting requirement for the use of H5RC.

 *

 */

​

​

#include "H5Eprivate.h"     /* Error handling           */

#include "H5FLprivate.h"    /* Free lists                           */

#include "H5UCprivate.h"        /* Reference-counted buffers            */

​

/* Private typedefs & structs */

​

/* Declare a free list to manage the H5UC_t struct */

H5FL_DEFINE_STATIC(H5UC_t);

​

•

/*--------------------------------------------------------------------------

 NAME

    H5UC_create

 PURPOSE

    Create a reference counted object

 USAGE

    H5UC_t *H5UC_create(o,free)

        const void *o;          IN: Object to initialize ref-counted object with

        H5UC_free_func_t free;  IN: Function to call when ref-count drop to zero

​

 RETURNS

    Returns a pointer to a new ref-counted object on success, NULL on failure.

 DESCRIPTION

    Create a reference counted object.  The object is not duplicated, it is

    assumed to be owned by the reference counted object now and will be freed