X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=src%2Fcommon%2Fdynamic-buffer.h;h=d4813fa3919b6c3d43dc536d308368f8f186b837;hb=3afa94aeca5a0daae40fd7b6cc96b7e4c150c7d8;hp=d05356b73a2d8c2d002861011b1fb08d0dee4c6d;hpb=63557623eba8b58076e0454731a2d52e2ac5966b;p=lttng-tools.git diff --git a/src/common/dynamic-buffer.h b/src/common/dynamic-buffer.h index d05356b73..d4813fa39 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 @@ -20,6 +10,13 @@ #include #include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +struct lttng_buffer_view; struct lttng_dynamic_buffer { char *data; @@ -52,11 +49,19 @@ int lttng_dynamic_buffer_append(struct lttng_dynamic_buffer *buffer, * of "len". */ 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". + */ +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 @@ -74,7 +79,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. @@ -87,4 +92,12 @@ int lttng_dynamic_buffer_set_capacity(struct lttng_dynamic_buffer *buffer, /* Release any memory used by the dynamic buffer. */ void lttng_dynamic_buffer_reset(struct lttng_dynamic_buffer *buffer); +/* Get the space left in the buffer before a new resize is needed. */ +size_t lttng_dynamic_buffer_get_capacity_left( + struct lttng_dynamic_buffer *buffer); + +#ifdef __cplusplus +} +#endif + #endif /* LTTNG_DYNAMIC_BUFFER_H */