Content-type: text/html Man page of sizeof_proplist_entry

sizeof_proplist_entry

Section: C Library Functions (3)
Index Return to Main Contents
 

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 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 initialize 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 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); buffer_size += sizeof_proplist_entry("secondary_name", 13);

.
.
.
 

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.  

RELATED INFORMATION

Functions: add_proplist_entry(3), delproplist(3), fdelproplist(3), fgetproplist(3), fsetproplist(3), get_proplist_entry(3), getproplist(3), setproplist(3), sizeof_proplist_entry(3).

Files: proplist(4), sys/proplist.h.

delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
EXAMPLES
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:36 GMT, October 02, 2010