aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
Diffstat (limited to 'include')
-rw-r--r--include/slibc/features.h12
-rw-r--r--include/strings.h57
2 files changed, 69 insertions, 0 deletions
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 <http://www.gnu.org/licenses/>.
+ */
+#ifndef _STRINGS_H
+#define _STRINGS_H
+#include <slibc/version.h>
+
+
+#include <slibc/features.h>
+
+
+
+#define __NEED_size_t
+
+#include <bits/types.h>
+
+
+
+/**
+ * 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
+