libnl 1.1
Abstract Data
Utilities

General

struct nl_data * nl_data_alloc (void *buf, size_t size)
 Allocate a new abstract data object.
struct nl_data * nl_data_clone (struct nl_data *src)
 Clone an abstract data object.
int nl_data_append (struct nl_data *data, void *buf, size_t size)
 Append data to an abstract data object.
void nl_data_free (struct nl_data *data)
 Free an abstract data object.

Attribute Access

void * nl_data_get (struct nl_data *data)
 Get data buffer of abstract data object.
size_t nl_data_get_size (struct nl_data *data)
 Get size of data buffer of abstract data object.

Misc

int nl_data_cmp (struct nl_data *a, struct nl_data *b)
 Compare two abstract data objects.

Function Documentation

struct nl_data* nl_data_alloc ( void *  buf,
size_t  size 
) [read]
Parameters:
bufData buffer containing the actual data.
sizeSize of data buffer.

Allocates a new abstract data and copies the specified data buffer into the new handle.

Returns:
Newly allocated data handle or NULL

Definition at line 38 of file data.c.

Referenced by nl_data_clone(), and nla_get_data().

{
        struct nl_data *data;

        data = calloc(1, sizeof(*data));
        if (!data)
                goto errout;

        data->d_data = calloc(1, size);
        if (!data->d_data) {
                free(data);
                goto errout;
        }

        data->d_size = size;

        if (buf)
                memcpy(data->d_data, buf, size);

        return data;
errout:
        nl_errno(ENOMEM);
        return NULL;
}
struct nl_data* nl_data_clone ( struct nl_data *  src) [read]
Parameters:
srcAbstract data object
Returns:
Cloned object or NULL

Definition at line 69 of file data.c.

References nl_data_alloc().

{
        return nl_data_alloc(src->d_data, src->d_size);
}
int nl_data_append ( struct nl_data *  data,
void *  buf,
size_t  size 
)
Parameters:
dataAbstract data object.
bufData buffer containing the data to be appended.
sizeSize of data to be apppended.

Reallocates an abstract data and copies the specified data buffer into the new handle.

Returns:
0 on success or a negative error code

Definition at line 85 of file data.c.

Referenced by rtnl_u32_add_key().

{
        if (size < 0)
                BUG();

        if (size > 0) {
                data->d_data = realloc(data->d_data, data->d_size + size);
                if (!data->d_data)
                        return nl_errno(ENOMEM);

                if (buf)
                        memcpy(data->d_data + data->d_size, buf, size);
                else
                        memset(data->d_data + data->d_size, 0, size);

                data->d_size += size;
        }

        return 0;
}
void nl_data_free ( struct nl_data *  data)
Parameters:
dataAbstract data object.

Definition at line 110 of file data.c.

{
        if (data)
                free(data->d_data);

        free(data);
}
void* nl_data_get ( struct nl_data *  data)
Parameters:
dataAbstract data object.
Returns:
Data buffer or NULL if empty.

Definition at line 130 of file data.c.

Referenced by nl_data_cmp(), and nla_put_data().

{
        return data->d_size > 0 ? data->d_data : NULL;
}
size_t nl_data_get_size ( struct nl_data *  data)
Parameters:
dataAbstract data object.
Returns:
Size of data buffer.

Definition at line 140 of file data.c.

Referenced by nl_data_cmp(), and nla_put_data().

{
        return data->d_size;
}
int nl_data_cmp ( struct nl_data *  a,
struct nl_data *  b 
)
Parameters:
aAbstract data object.
bAnother abstract data object.
Returns:
An integer less than, equal to, or greater than zero if a is found, respectively, to be less than, to match, or be greater than b.

Definition at line 160 of file data.c.

References nl_data_get(), and nl_data_get_size().

{
        void *a_ = nl_data_get(a);
        void *b_ = nl_data_get(b);

        if (a_ && b_)
                return memcmp(a_, b_, nl_data_get_size(a));
        else
                return -1;
}