sizeof_proplist_entry(3)sizeof_proplist_entry(3)NAMEsizeof_proplist_entry - determines space necessary to store an Extended
File Attribute
SYNOPSIS
#include <sys/proplist.h>
int sizeof_proplist_entry(
char *name,
int value_size );
PARAMETERS
A null terminated ASCII string, pointing to the Extended File Attribute
name. Specifies the size, in bytes, of the Extended File Attribute
value.
DESCRIPTION
The sizeof_proplist_entry() function determines the minimum size of the
Extended File Attribute buffer required to store an Extended File
Attribute, specified by the *name and value_size parameters. An
Extended File Attribute is a name and value pair that is contained in a
variable-sized structure called a Property List. A Property List is
part of a file's metadata and can contain abstract name and value pairs
(Extended File Attributes) that can be set either by the operating sys‐
tem (for example, ACLs and privileges) or by a user-level application
(for example, PC File Attributes).
Although not a requirement, you should use the sizeof_proplist_entry(3)
and add_proplist_entry(3) functions to initialize the Extended File
Attribute buffer passed to setproplist(3) and fsetproplist(3).
RETURN VALUES
If successful, the function returns the minimum number of bytes
required to store the specified name and value pair in an Extended File
Attribute buffer.
EXAMPLES
#include <sys/proplist.h> main() { char *ptr, *buf, *name, *value; int
*value_len, *options, buffer_size, min_buffer_size, ret, nbytes; struct
proplistname_args; static char *names[] = {
"primary_name",
"secondary_name",
"" };
/*
* How big a buffer do I need to store my name and value
* pair in a property list ?
*/ buffer_size = sizeof_proplist_entry("primary_name", 18); buf‐
fer_size += sizeof_proplist_entry("secondary_name", 13);
SEE ALSO
Functions: add_proplist_entry(3), delproplist(3), fdelproplist(3),
fgetproplist(3), fsetproplist(3), get_proplist_entry(3), getpro‐
plist(3), setproplist(3), sizeof_proplist_entry(3)
Files: proplist(4), sys/proplist.h
sizeof_proplist_entry(3)