8a3efffa5b
In order for the interface to become more thread safe, the error
handling was revised to no longer depend on a static errno and
error string buffer.
This patch converts all error paths to return a libnl specific
error code which can be translated to a error message using
nl_geterror(int error). The functions nl_error() and
nl_get_errno() are therefore obsolete.
This change required various sets of function prototypes to be
changed in order to return an error code, the most prominent
are:
struct nl_cache *foo_alloc_cache(...);
changed to:
int foo_alloc_cache(..., struct nl_cache **);
struct nl_msg *foo_build_request(...);
changed to:
int foo_build_request(..., struct nl_msg **);
struct foo *foo_parse(...);
changed to:
int foo_parse(..., struct foo **);
This pretty much only leaves trivial allocation functions to
still return a pointer object which can still return NULL to
signal out of memory.
This change is a serious API and ABI breaker, sorry!
65 lines
1.9 KiB
C
65 lines
1.9 KiB
C
/*
|
|
* netlink/object.c Generic Cacheable Object
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation version 2.1
|
|
* of the License.
|
|
*
|
|
* Copyright (c) 2003-2008 Thomas Graf <tgraf@suug.ch>
|
|
*/
|
|
|
|
#ifndef NETLINK_OBJECT_H_
|
|
#define NETLINK_OBJECT_H_
|
|
|
|
#include <netlink/netlink.h>
|
|
#include <netlink/utils.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct nl_cache;
|
|
struct nl_object;
|
|
struct nl_object_ops;
|
|
|
|
#define OBJ_CAST(ptr) ((struct nl_object *) (ptr))
|
|
|
|
/* General */
|
|
extern struct nl_object * nl_object_alloc(struct nl_object_ops *);
|
|
extern int nl_object_alloc_name(const char *,
|
|
struct nl_object **);
|
|
extern void nl_object_free(struct nl_object *);
|
|
extern struct nl_object * nl_object_clone(struct nl_object *obj);
|
|
extern void nl_object_get(struct nl_object *);
|
|
extern void nl_object_put(struct nl_object *);
|
|
extern int nl_object_shared(struct nl_object *);
|
|
extern void nl_object_dump(struct nl_object *,
|
|
struct nl_dump_params *);
|
|
extern int nl_object_identical(struct nl_object *,
|
|
struct nl_object *);
|
|
extern uint32_t nl_object_diff(struct nl_object *,
|
|
struct nl_object *);
|
|
extern int nl_object_match_filter(struct nl_object *,
|
|
struct nl_object *);
|
|
extern char * nl_object_attrs2str(struct nl_object *,
|
|
uint32_t attrs, char *buf,
|
|
size_t);
|
|
extern char * nl_object_attr_list(struct nl_object *,
|
|
char *, size_t);
|
|
|
|
/* Marks */
|
|
extern void nl_object_mark(struct nl_object *);
|
|
extern void nl_object_unmark(struct nl_object *);
|
|
extern int nl_object_is_marked(struct nl_object *);
|
|
|
|
/* Access Functions */
|
|
extern int nl_object_get_refcnt(struct nl_object *);
|
|
extern struct nl_cache * nl_object_get_cache(struct nl_object *);
|
|
extern inline void * nl_object_priv(struct nl_object *);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|