rpmutil.h File Reference

Miscellaneous utility macros: More...

#include <unistd.h>

Go to the source code of this file.

Macros
#define	RPM_GNUC_EXTENSION
#define	RPM_GNUC_PURE
#define	RPM_GNUC_MALLOC
#define	RPM_GNUC_ALLOC_SIZE(x)
#define	RPM_GNUC_ALLOC_SIZE2(x, y)
#define	RPM_GNUC_NULL_TERMINATED
#define	RPM_GNUC_PRINTF(format_idx, arg_idx)
#define	RPM_GNUC_SCANF(format_idx, arg_idx)
#define	RPM_GNUC_FORMAT(arg_idx)
#define	RPM_GNUC_NORETURN
#define	RPM_GNUC_CONST
#define	RPM_GNUC_UNUSED
#define	RPM_GNUC_NO_INSTRUMENT
#define	RPM_GNUC_DEPRECATED
#define	RPM_GNUC_MAY_ALIAS
#define	RPM_GNUC_NONNULL(...)
#define	RPM_GNUC_WARN_UNUSED_RESULT
#define	RPM_GNUC_INTERNAL
#define	RPM_BEGIN_DECLS
#define	RPM_END_DECLS

Typedefs
typedef void *(*	rpmMemFailFunc) (size_t size, void *data)
	Memory allocation failure callback prototype.

Functions
void *	rmalloc (size_t size)
void *	rcalloc (size_t nmemb, size_t size)
void *	rrealloc (void *ptr, size_t size)
char *	rstrdup (const char *str)
char *	rstrndup (const char *str, size_t n)
void *	rfree (void *ptr)
rpmMemFailFunc	rpmSetMemFail (rpmMemFailFunc func, void *data)
	Set memory allocation failure callback.

Detailed Description

Miscellaneous utility macros:

• portability wrappers for various gcc extensions like attribute()
• ...

Copied from glib, names replaced to avoid clashing with glib.

Definition in file rpmutil.h.

Macro Definition Documentation

RPM_BEGIN_DECLS

#define RPM_BEGIN_DECLS

Definition at line 112 of file rpmutil.h.

RPM_END_DECLS

#define RPM_END_DECLS

Definition at line 113 of file rpmutil.h.

RPM_GNUC_ALLOC_SIZE

#define RPM_GNUC_ALLOC_SIZE

(

x

)

Definition at line 42 of file rpmutil.h.

Referenced by rcalloc().

RPM_GNUC_ALLOC_SIZE2

#define RPM_GNUC_ALLOC_SIZE2	(		x,
			y )

Definition at line 43 of file rpmutil.h.

Referenced by rmalloc().

RPM_GNUC_CONST

#define RPM_GNUC_CONST

Definition at line 72 of file rpmutil.h.

RPM_GNUC_DEPRECATED

#define RPM_GNUC_DEPRECATED

Definition at line 81 of file rpmutil.h.

Referenced by headerCopy(), headerLoad(), headerSizeof(), and rpmfcCreate().

RPM_GNUC_EXTENSION

#define RPM_GNUC_EXTENSION

Definition at line 23 of file rpmutil.h.

RPM_GNUC_FORMAT

#define RPM_GNUC_FORMAT

(

arg_idx

)

Definition at line 70 of file rpmutil.h.

RPM_GNUC_INTERNAL

#define RPM_GNUC_INTERNAL

Definition at line 103 of file rpmutil.h.

RPM_GNUC_MALLOC

#define RPM_GNUC_MALLOC

Definition at line 35 of file rpmutil.h.

Referenced by rmalloc().

RPM_GNUC_MAY_ALIAS

#define RPM_GNUC_MAY_ALIAS

Definition at line 89 of file rpmutil.h.

RPM_GNUC_NO_INSTRUMENT

#define RPM_GNUC_NO_INSTRUMENT

Definition at line 74 of file rpmutil.h.

RPM_GNUC_NONNULL

#define RPM_GNUC_NONNULL

(

...

)

Definition at line 90 of file rpmutil.h.

RPM_GNUC_NORETURN

#define RPM_GNUC_NORETURN

Definition at line 71 of file rpmutil.h.

RPM_GNUC_NULL_TERMINATED

#define RPM_GNUC_NULL_TERMINATED

Definition at line 49 of file rpmutil.h.

Referenced by rpmExpand(), rpmGetPath(), and rstrscat().

RPM_GNUC_PRINTF

#define RPM_GNUC_PRINTF	(		format_idx,
			arg_idx )

Definition at line 68 of file rpmutil.h.

Referenced by rasprintf(), and rpmlog().

RPM_GNUC_PURE

#define RPM_GNUC_PURE

Definition at line 34 of file rpmutil.h.

Referenced by rstrcasecmp(), and rstrlcpy().

RPM_GNUC_SCANF

#define RPM_GNUC_SCANF	(		format_idx,
			arg_idx )

Definition at line 69 of file rpmutil.h.

RPM_GNUC_UNUSED

#define RPM_GNUC_UNUSED

Definition at line 73 of file rpmutil.h.

RPM_GNUC_WARN_UNUSED_RESULT

#define RPM_GNUC_WARN_UNUSED_RESULT

Definition at line 97 of file rpmutil.h.

Typedef Documentation

rpmMemFailFunc

typedef void *(* rpmMemFailFunc) (size_t size, void *data)

Memory allocation failure callback prototype.

When registered through rpmSetMemFail(), this gets called if memory allocation through rmalloc() and friends fails. If the application can somehow recover memory here, it can return a newly allocated memory block of requested size, otherwise it must return NULL after performing it's own shutdown deeds or terminate itself.

Parameters

size	Size of allocation request in bytes
data	User data (or NULL)

Returns

Allocated memory block of requested size or NULL

Definition at line 148 of file rpmutil.h.

Function Documentation

rcalloc()

void * rcalloc	(	size_t	nmemb,
		size_t	size )

References rcalloc(), and RPM_GNUC_ALLOC_SIZE.

Referenced by rcalloc().

rfree()

void * rfree

(

void *

ptr

)

References rfree().

Referenced by rfree().

rmalloc()

void * rmalloc

(

size_t

size

)

References rmalloc(), RPM_GNUC_ALLOC_SIZE2, and RPM_GNUC_MALLOC.

Referenced by rmalloc().

rpmSetMemFail()

rpmMemFailFunc rpmSetMemFail	(	rpmMemFailFunc	func,
		void *	data )

Set memory allocation failure callback.

Parameters

func	Allocation failure callback function
data	User data (or NULL)

Returns

Previous callback function

References rpmSetMemFail().

Referenced by rpmSetMemFail().

rrealloc()

void * rrealloc	(	void *	ptr,
		size_t	size )

References rrealloc().

Referenced by rrealloc().

rstrdup()

char * rstrdup

(

const char *

str

)

References rstrdup().

Referenced by rstrdup().

rstrndup()

char * rstrndup	(	const char *	str,
		size_t	n )

References rstrndup().

Referenced by rstrndup().