From 4f5791ebd03eaec1c7da0865a383175b05102712 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 19:47:29 +0200 Subject: Adding upstream version 2:4.17.12+dfsg. Signed-off-by: Daniel Baumann --- lib/util/talloc_keep_secret.h | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 lib/util/talloc_keep_secret.h (limited to 'lib/util/talloc_keep_secret.h') diff --git a/lib/util/talloc_keep_secret.h b/lib/util/talloc_keep_secret.h new file mode 100644 index 0000000..44a26ae --- /dev/null +++ b/lib/util/talloc_keep_secret.h @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2019 Andreas Schneider + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * 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 General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#ifndef _TALLOC_KEEP_SECRET_H +#define _TALLOC_KEEP_SECRET_H + +#ifdef DOXYGEN +/** + * @brief Keep the memory secret when freeing. + * + * This can be used to define memory as secret. For example memory which holds + * passwords or other secrets like session keys. The memory will be zeroed + * before is being freed. + * + * If you duplicate memory, e.g. using talloc_strdup() or talloc_asprintf() you + * need to call talloc_keep_secret() on the newly allocated memory too! + * + * @param[in] ptr The talloc chunk to mark as secure. + * + * @warning Do not use this in combination with talloc_realloc(). + */ +void talloc_keep_secret(const void *ptr); +#else +#define talloc_keep_secret(ptr) _talloc_keep_secret(ptr, #ptr); +void _talloc_keep_secret(void *ptr, const char *name); +#endif + +#endif /* _TALLOC_KEEP_SECRET_H */ -- cgit v1.2.3