X-Git-Url: http://git.efficios.com/?p=lttng-tools.git;a=blobdiff_plain;f=src%2Fcommon%2Fdynamic-buffer.h;h=3435c846c3bf60054a86339383d96aa8ccb42a97;hp=d42a6a61df8401ba62732d3a79a8b8f3ea44b875;hb=2aa28610e2bff8b40ad2810cbf0c7ea3b79e106d;hpb=c90647fe68da8a767a2c03dc0135d4a09992af16 diff --git a/src/common/dynamic-buffer.h b/src/common/dynamic-buffer.h index d42a6a61d..3435c846c 100644 --- a/src/common/dynamic-buffer.h +++ b/src/common/dynamic-buffer.h @@ -1,18 +1,8 @@ /* - * Copyright (C) 2017 - Jérémie Galarneau + * Copyright (C) 2017 Jérémie Galarneau * - * This program is free software; you can redistribute it and/or modify it - * under the terms of the GNU Lesser General Public License, version 2.1 only, - * as published by the Free Software Foundation. + * SPDX-License-Identifier: LGPL-2.1-only * - * 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 Lesser General Public License - * for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this program; if not, write to the Free Software Foundation, - * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #ifndef LTTNG_DYNAMIC_BUFFER_H @@ -22,6 +12,8 @@ #include #include +struct lttng_buffer_view; + struct lttng_dynamic_buffer { char *data; /* size is the buffer's currently used capacity. */ @@ -56,11 +48,20 @@ int lttng_dynamic_buffer_append(struct lttng_dynamic_buffer *buffer, */ LTTNG_HIDDEN int lttng_dynamic_buffer_append_buffer(struct lttng_dynamic_buffer *dst_buffer, - struct lttng_dynamic_buffer *src_buffer); + const struct lttng_dynamic_buffer *src_buffer); + +/* + * Performs the same action as lttng_dynamic_buffer_append(), but using a + * buffer view as the source buffer. The source buffer's size is used in lieu + * of "len". + */ +LTTNG_HIDDEN +int lttng_dynamic_buffer_append_view(struct lttng_dynamic_buffer *buffer, + const struct lttng_buffer_view *view); /* * Set the buffer's size to new_size. The capacity of the buffer will - * be expanded (if necessary) to accomodate new_size. Areas acquired by + * be expanded (if necessary) to accommodates new_size. Areas acquired by * a size increase will be zeroed. * * Be careful to expand the buffer's size _before_ calling out external @@ -79,7 +80,7 @@ int lttng_dynamic_buffer_set_size(struct lttng_dynamic_buffer *buffer, size_t new_size); /* - * Set the buffer's capacity to accomodate the new_capacity, allocating memory + * Set the buffer's capacity to accommodates the new_capacity, allocating memory * as necessary. The buffer's content is preserved. Setting a buffer's capacity * is meant as a _hint_ to the underlying buffer and is only optimization; no * guarantee is offered that subsequent calls to append or set_size will succeed. @@ -94,4 +95,9 @@ int lttng_dynamic_buffer_set_capacity(struct lttng_dynamic_buffer *buffer, LTTNG_HIDDEN void lttng_dynamic_buffer_reset(struct lttng_dynamic_buffer *buffer); +/* Get the space left in the buffer before a new resize is needed. */ +LTTNG_HIDDEN +size_t lttng_dynamic_buffer_get_capacity_left( + struct lttng_dynamic_buffer *buffer); + #endif /* LTTNG_DYNAMIC_BUFFER_H */