sizeof_proplist_entry(3)			      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
       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)

Vote for polarhome