*
* Allocates memory of `size' bytes and returns pointer to the allocated
* memory area. Free the memory by calling silc_free. Returns NULL on
- * error.
+ * error and sets silc_errno.
*
***/
void *silc_malloc(size_t size);
* Allocates memory of for an array of `items' elements of `size' bytes
* and returns pointer to the allocated memory area. The memory area is
* also zeroed. Free the memory by calling silc_free. Returns NULL on
- * error.
+ * error and sets silc_errno.
*
***/
void *silc_calloc(size_t items, size_t size);
***/
void *silc_memdup(const void *ptr, size_t size);
+/****f* silcutil/SilcMemoryAPI/silc_strdup
+ *
+ * SYNOPSIS
+ *
+ * char *silc_strdup(const char *str);
+ *
+ * DESCRIPTION
+ *
+ * Duplicates the string indicated by `str' and returns the duplicated
+ * string. Returns NULL on error and sets silc_errno.
+ *
+ ***/
+char *silc_strdup(const char *str);
+
#else
#ifndef SILC_DIST_TOOLKIT
#error "The stack trace is not supported in this distribution"
* size of `size' bytes. The contents of `ptr' will not be changed.
* If `ptr' is NULL the call is equivalent to silc_smalloc. If `size'
* is zero (0) error will occur. Returns NULL on error and the old
- * pointer remain intact.
+ * pointer remain intact. This may return different pointer from `ptr'
*
* NOTES
*
- * This function reallocates successfully only if the previous allocation
- * to `stack' was `ptr'. If there was another memory allocation between
- * allocating `ptr' and this call, this routine will return NULL. The
- * NULL is also returned if the `size' does not fit to current stack
- * and allocating new block would require slow copying of the data. It
- * is left to the caller to decide whether to allocate new pointer and
- * copy the old data in case this function returns NULL.
+ * If the reallocation from `stack' fails, this function will allocate
+ * new block of size of `size' bytes from `stack' and copy the data from
+ * `ptr' to the new memory block.
*
* If `stack' is NULL this function calls silc_realloc.
*