dkmem(3) - Linux man page

Name

dkmem - Dynamic memory allocation

Synopsis

#include <dkmem.h>

void *dkmem_alloc(size_t elsize, size_t nelem);
void  dkmem_free(void *ptr);
void  dkmem_res(void *ptr, size_t bytes);
void  dkmem_cpy(void *d, void *s, size_t n);
int   dkmem_cmp(void *s1, void *s2, size_t n);

#define dk_new(type,nelem) (t *)dkmem_alloc(sizeof(type, (size_t)nelem)
#define dk_delete(ptr) dkmem_free((void *)ptr)
#define DK_MEMRES(ptr,sz) ...
#define DK_MEMCPY(d,s,n)  ...
#define DK_MEMCMP(a,b,n)  ...

Description

dkmem_alloc() tries to allocate memory. The elsize argument specifies the size of one element in bytes, nelem is the number of elements. On success a pointer to the memory is returned. If this memory is not longer needed, it must be released using the dkmem_free() function.

dkmem_free() releases memory allocated by dkmem_alloc(). The ptr argument is the pointer returned by dkmem_alloc().

dkmem_res() resets memory by filling it with zero bytes. The ptr argument is the pointer to the start of the memory region, bytes is the number of zero bytes to write.

dkmem_cpy() copies a memory range from start address s to destination address d. The n parameter is the number of bytes.

dkmem_cmp() compares two memory regions specified by start adresses s1 and s2. The length of the regions is given by parameter n. If the first memory region is lexicographically "larger" than the second, the function result is > 0. If s1 is "smaller" than s2 the result is < 0. If both memory regions are equal the function result is 0.

The dk_new() and dk_delete() macros allow a more convenient use of the functions.

The DK_MEM ...() macros use native system functions (bzero/memset, bcopy/memcpy, bcmp/memcmp) if available, otherwise the fallback functions provided by the module itself.

It is recommended to use the macros instead of the functions.

Return Values

Functions returning pointers return a valid pointer on success, NULL on errors.

The return value of dkmem_cmp() depends on which of the memory regions is larger.

Author

Dirk Krause

Copyright And License

Copyright © 2001-2008, Dirk Krause All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above
  copyright notice, this list of conditions and the
  following disclaimer.

* Redistributions in binary form must reproduce the above
  copyright notice, this list of conditions and the following
  disclaimer in the documentation and/or other materials
  provided with the distribution.

* Neither the name of the Dirk Krause nor the names of
  contributors may be used to endorse or promote products
  derived from this software without specific prior written
  permission.

Referenced By