From 16ae5ca1c6b411bcbd2d9a1cd79db1e66ed1cfaa Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 30 Aug 2015 14:47:16 +0200 Subject: add bzero and explicit_bzero MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- include/slibc/features.h | 12 ++++++++++ include/strings.h | 57 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 69 insertions(+) create mode 100644 include/strings.h (limited to 'include') diff --git a/include/slibc/features.h b/include/slibc/features.h index 0cbc326..f62f5cb 100644 --- a/include/slibc/features.h +++ b/include/slibc/features.h @@ -68,6 +68,18 @@ #endif +/** + * Mark a function, variable or type as deprecated, + * with a message that tells the user why the the + * function is deprecated, or functions to use instead. + */ +#if !defined(_SLIBC_SUPPRESS_WARNINGS) +# define __deprecated(msg) __GCC_ONLY(__attribute__((deprecated(msg)))) +#else +# define __deprecated(msg) /* ignore */ +#endif + + #endif diff --git a/include/strings.h b/include/strings.h new file mode 100644 index 0000000..6186b1a --- /dev/null +++ b/include/strings.h @@ -0,0 +1,57 @@ +/** + * slibc — Yet another C library + * Copyright © 2015 Mattias Andrée (maandree@member.fsf.org) + * + * 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 _STRINGS_H +#define _STRINGS_H +#include + + +#include + + + +#define __NEED_size_t + +#include + + + +/** + * Override a memory segment with zeroes. + * + * @param segment The memory segment to override. + * @param size The size of the memory segment. + */ +void bzero(void*, size_t) __deprecated("Use 'memset', 'explicit_bzero' or 'secure_free' instead."); + +#if !defined(_PORTABLE_SOURCE) && (defined(_SLIBC_SOURCE) || defined(_BSD_SOURCE)) +/** + * Override a memory segment with zeroes. + * + * Unlike `bzero` and `memset`, calls to this function + * cannot be removed, as an optimisation, by the compiler. + * + * @param segment The memory segment to override. + * @param size The size of the memory segment. + */ +void explicit_bzero(void*, size_t); +#endif + + + +#endif + -- cgit v1.2.3-70-g09d2