*** UNIX MANUAL PAGE BROWSER ***

sizeof_proplist_entry(3) Library Functions Manual sizeof_proplist_entry(3) NAME sizeof_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 At- tribute, specified by the *name and value_size parameters. An Extended File Attribute is a name and value pair that is contained in a vari- able-sized structure called a Property List. A Property List is part of a file's metadata and can contain abstract name and value pairs (Ex- tended File Attributes) that can be set either by the operating system (for example, ACLs and privileges) or by a user-level application (for example, PC File Attributes). Although not a requirement, Digital recommends that you use the sizeof_proplist_entry(3) and add_proplist_entry(3) functions to ini- tialize the Extended File Attribute buffer passed to setproplist(3) and fsetproplist(3). EXAMPLES #include <sys/proplist.h> main() { char *ptr, *buf, *name, *value; int *value_len, *flags, buffer_size, min_buffer_size, ret, nbytes; struct pro- plistname_args; static char *names[] = { "primary_name", "sec- ondary_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); buffer_size += sizeof_proplist_entry("secondary_name", 13); . . . RETURN VALUES If successful, the function returns the minimum number of bytes re- quired to store the specified name and value pair in an Extended File Attribute buffer. RELATED INFORMATION 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. delim off sizeof_proplist_entry(3)