File Manager

003 File Manager

Current Path: /usr/src/contrib/subversion/subversion/include/private

usr / src / contrib / subversion / subversion / include / private /

📁 ..
📄 README(241 B)
📄 ra_svn_sasl.h(2.63 KB)
📄 ra_svn_wrapped_sasl.h(3.89 KB)
📄 svn_adler32.h(1.47 KB)
📄 svn_atomic.h(4.83 KB)
📄 svn_auth_private.h(11.32 KB)
📄 svn_branch.h(22.98 KB)
📄 svn_branch_compat.h(10.78 KB)
📄 svn_branch_impl.h(5.67 KB)
📄 svn_branch_nested.h(7.55 KB)
📄 svn_branch_repos.h(3.47 KB)
📄 svn_cache.h(22.67 KB)
📄 svn_cert.h(2.27 KB)
📄 svn_client_mtcc.h(7.8 KB)
📄 svn_client_private.h(22.85 KB)
📄 svn_client_shelf.h(16.26 KB)
📄 svn_client_shelf2.h(15.27 KB)
📄 svn_cmdline_private.h(10.52 KB)
📄 svn_config_private.h(4.26 KB)
📄 svn_dav_protocol.h(2.56 KB)
📄 svn_debug.h(3.35 KB)
📄 svn_delta_private.h(4.91 KB)
📄 svn_dep_compat.h(6.64 KB)
📄 svn_diff_private.h(6 KB)
📄 svn_diff_tree.h(14.32 KB)
📄 svn_dirent_uri_private.h(1.85 KB)
📄 svn_doxygen.h(1.27 KB)
📄 svn_editor.h(43.09 KB)
📄 svn_element.h(12.83 KB)
📄 svn_eol_private.h(3.18 KB)
📄 svn_error_private.h(1.67 KB)
📄 svn_fs_fs_private.h(11.08 KB)
📄 svn_fs_private.h(8.36 KB)
📄 svn_fs_util.h(11.11 KB)
📄 svn_fspath.h(5.36 KB)
📄 svn_io_private.h(6.47 KB)
📄 svn_log.h(6.96 KB)
📄 svn_magic.h(2.36 KB)
📄 svn_mergeinfo_private.h(12.71 KB)
📄 svn_mutex.h(4.3 KB)
📄 svn_object_pool.h(4.53 KB)
📄 svn_opt_private.h(5.73 KB)
📄 svn_packed_data.h(9.39 KB)
📄 svn_ra_private.h(12.07 KB)
📄 svn_ra_svn_private.h(38.63 KB)
📄 svn_repos_private.h(15.45 KB)
📄 svn_skel.h(8.46 KB)
📄 svn_sorts_private.h(7.66 KB)
📄 svn_sqlite.h(23.22 KB)
📄 svn_string_private.h(11.05 KB)
📄 svn_subr_private.h(24.43 KB)
📄 svn_temp_serializer.h(8.75 KB)
📄 svn_token.h(3.11 KB)
📄 svn_utf_private.h(11.18 KB)
📄 svn_wc_private.h(93.26 KB)

Editing: svn_temp_serializer.h

/**
 * @copyright
 * ====================================================================
 *    Licensed to the Apache Software Foundation (ASF) under one
 *    or more contributor license agreements.  See the NOTICE file
 *    distributed with this work for additional information
 *    regarding copyright ownership.  The ASF licenses this file
 *    to you under the Apache License, Version 2.0 (the
 *    "License"); you may not use this file except in compliance
 *    with the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing,
 *    software distributed under the License is distributed on an
 *    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 *    KIND, either express or implied.  See the License for the
 *    specific language governing permissions and limitations
 *    under the License.
 * ====================================================================
 * @endcopyright
 *
 * @file svn_temp_serializer.h
 * @brief Helper API for serializing _temporarily_ data structures.
 *
 * @note This API is intended for efficient serialization and duplication
 *       of temporary, e.g. cached, data structures ONLY. It is not
 *       suitable for persistent data.
 */

#ifndef SVN_TEMP_SERIALIZER_H
#define SVN_TEMP_SERIALIZER_H

#include "svn_string.h"

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

/* forward declaration */
struct svn_stringbuf_t;

/**
 * The amount of extra memory allocated by #svn_temp_serializer__init for
 * the internal buffer in addition to its suggested_buffer_size parameter.
 * To allocate a 512 buffer, including overhead, just specify a size of
 * 512 - SVN_TEMP_SERIALIZER__OVERHEAD.
 */
#define SVN_TEMP_SERIALIZER__OVERHEAD (sizeof(svn_stringbuf_t) + 1)

/**
 * Opaque structure controlling the serialization process and holding the
 * intermediate as well as final results.
 */
typedef struct svn_temp_serializer__context_t svn_temp_serializer__context_t;

/**
 * Begin the serialization process for the @a source_struct and all objects
 * referenced from it. @a struct_size must match the result of @c sizeof()
 * of the actual structure. Due to the generic nature of the init function
 * we can't determine the structure size as part of the function.
 *
 * It is possible to specify a @c NULL source_struct in which case the first
 * call to svn_temp_serializer__push() will provide the root struct.
 * Alternatively, one may even call svn_temp_serializer__add_string()
 * but there is generally no point in doing so because the result will be
 * simple string object in a #svn_stringbuf_t.
 *
 * You may suggest a larger initial buffer size in @a suggested_buffer_size
 * to minimize the number of internal buffer re-allocations during the
 * serialization process. All allocations will be made from @a pool.
 *
 * Pointers within the structure will be replaced by their serialized
 * representation when the respective strings or sub-structures get
 * serialized. This scheme allows only for tree-like, i.e. non-circular
 * data structures.
 *
 * @return the serialization context.
 */
svn_temp_serializer__context_t *
svn_temp_serializer__init(const void *source_struct,
                          apr_size_t struct_size,
                          apr_size_t suggested_buffer_size,
                          apr_pool_t *pool);

/**
 * Continue the serialization process of the @a source_struct that has
 * already been serialized to @a buffer but contains references to new
 * objects yet to serialize. I.e. this function allows you to append
 * data to serialized structures returned by svn_temp_serializer__get().
 *
 * The current size of the serialized data is given in @a currently_used.
 * If the allocated data buffer is actually larger, you may specifiy that
 * size in @a currently_allocated to prevent unnecessary re-allocations.
 * Otherwise, set it to 0.
 *
 * All allocations will be made from @a pool.
 *
 * Please note that only sub-structures of @a source_struct may be added.
 * To add item referenced from other parts of the buffer, serialize from
 * @a source_struct first, get the result from svn_temp_serializer__get()
 * and call svn_temp_serializer__init_append for the next part.
 *
 * @return the serialization context.
 */
svn_temp_serializer__context_t *
svn_temp_serializer__init_append(void *buffer,
                                 void *source_struct,
                                 apr_size_t currently_used,
                                 apr_size_t currently_allocated,
                                 apr_pool_t *pool);

/**
 * Begin serialization of a referenced sub-structure within the
 * serialization @a context. @a source_struct must be a reference to the
 * pointer in the original parent structure so that the correspondence in
 * the serialized structure can be established. @a struct_size must match
 * the result of @c sizeof() of the actual structure.
 *
 * Only in case that svn_temp_serializer__init() has not been provided
 * with a root structure and this is the first call after the initialization,
 * @a source_struct will point to a reference to the root structure instead
 * of being related to some other.
 *
 * Sub-structures and strings will be added in a FIFO fashion. If you need
 * add further sub-structures on the same level, you need to call
 * svn_serializer__pop() to realign the serialization context.
 */
void
svn_temp_serializer__push(svn_temp_serializer__context_t *context,
                          const void * const * source_struct,
                          apr_size_t struct_size);

/**
 * End the serialization of the current sub-structure. The serialization
 * @a context will be focused back on the parent structure. You may then
 * add further sub-structures starting from that level.
 *
 * It is not necessary to call this function just for symmetry at the end
 * of the serialization process.
 */
void
svn_temp_serializer__pop(svn_temp_serializer__context_t *context);

/**
 * Serialize a referenced sub-structure within the serialization
 * @a context.  @a source_struct must be a reference to the
 * pointer in the original parent structure so that the correspondence in
 * the serialized structure can be established. @a struct_size must match
 * the result of @c sizeof() of the actual structure.
 *
 * This function is equivalent but more efficient than calling
 * #svn_temp_serializer__push() immediately followed by
 * #svn_temp_serializer__pop().
 */
void
svn_temp_serializer__add_leaf(svn_temp_serializer__context_t *context,
                              const void * const * source_struct,
                              apr_size_t struct_size);

/**
 * Serialize a string referenced from the current structure within the
 * serialization @a context. @a s must be a reference to the @c char*
 * pointer in the original structure so that the correspondence in the
 * serialized structure can be established.
 *
 * Only in case that svn_temp_serializer__init() has not been provided
 * with a root structure and this is the first call after the initialization,
 * @a s will not be related to some struct.
 */
void
svn_temp_serializer__add_string(svn_temp_serializer__context_t *context,
                                const char * const * s);

/**
 * Set the serialized representation of the pointer @a ptr inside the
 * current structure within the serialization @a context to @c NULL.
 * This is particularly useful if the pointer is not @c NULL in the
 * source structure.
 */
void
svn_temp_serializer__set_null(svn_temp_serializer__context_t *context,
                              const void * const * ptr);

/**
 * @return the number of bytes currently used in the serialization buffer
 * of the given serialization @a context.
 */
apr_size_t
svn_temp_serializer__get_length(svn_temp_serializer__context_t *context);

/**
 * @return a reference to the data buffer containing the data serialialized
 * so far in the given serialization @a context.
 */
struct svn_stringbuf_t *
svn_temp_serializer__get(svn_temp_serializer__context_t *context);

/**
 * Deserialization is straightforward: just copy the serialized buffer to
 * a natively aligned memory location (APR pools will take care of that
 * automatically) and resolve all pointers to sub-structures.
 *
 * To do the latter, call this function for each of these pointers, giving
 * the start address of the copied buffer in @a buffer and a reference to
 * the pointer to resolve in @a ptr.
 */
void
svn_temp_deserializer__resolve(const void *buffer, void **ptr);

/**
 * Similar to svn_temp_deserializer__resolve() but instead of modifying
 * the buffer content, the resulting pointer is passed back to the caller
 * as the return value.
 */
const void *
svn_temp_deserializer__ptr(const void *buffer, const void *const *ptr);

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* SVN_TEMP_SERIALIZER_H */

003 File Manager

Editing: svn_temp_serializer.h

Upload File

Create Folder