Almost all subsystem provide a function to allocate a new cache of some form. The function usually looks like this:
These functions allocate a new cache for the own object type, initializes it properly and updates it to represent the current state of their master, e.g. a link cache would include all links currently configured in the kernel.
Some of the allocation functions may take additional arguments to further specify what will be part of the cache.
All such functions return a newly allocated cache or NULL in case of an error.
All attribute functions avaiable for assigning addresses to objects take a struct nl_addr argument. The provided address object is validated against the address family of the object if known already. The assignment fails if the address families mismatch. In case the address family has not been specified yet, the address family of the new address is elected to be the new requirement.
The function will acquire a new reference on the address object before assignment, the caller is NOT responsible for this.
All functions return 0 on success or a negative error code.
All functions converting a set of flags to a character string follow the same principles, therefore, the following information applies to all functions convertings flags to a character string and vice versa.
char *<object name>_flags2str(int flags, char *buf, size_t len)
Converts the specified flags to a character string separated by commas and stores it in the specified destination buffer.
int <object name>_str2flags(const char *name)
Converts the provided character string specifying a flag to the corresponding numeric value.
char *<object name>_<type>2str(int type, char *buf, size_t len)
Converts an identifier (type) to a character string and stores it in the specified destination buffer.
int <object name>_str2<type>(const char *name)
Converts the provided character string specifying a identifier to the corresponding numeric value.