IPnom Home • Manuals • FreeBSD

 FreeBSD Man Pages

Man Sections:Commands (1)System Calls (2)Library Functions (3)Device Drivers (4)File Formats (5)Miscellaneous (7)System Utilities (8)
Keyword Live Search (10 results max):
 Type in part of a command in the search box.
 


property(3)

NAME

     properties_read, propery_find, properties_free -- functions to allow cre-
     ating simple property lists from ASCII file data


LIBRARY

     System Utilities Library (libutil, -lutil)


SYNOPSIS

     #include <sys/types.h>
     #include <libutil.h>

     properties
     properties_read(int fd);

     char *
     property_find(properties list, const char *name);

     void
     properties_free(properties list);


DESCRIPTION

     typedef struct _properties {
	     struct _properties *next;
	     char *name;
	     char *value;
     } *properties;

     The function properties_read() reads name = value pairs from the file
     descriptor passed in fd and returns the head of a new property list,
     assuming that the file's contents have been parsed properly, or NULL in
     case of error.

     The property_find() function returns the associated value string for the
     property named name if found, otherwise NULL.  The value returned may be
     up to PROPERTY_MAX_VALUE bytes in length.

     The properties_free() function is used to free the structure returned by
     properties_read() when it is no longer needed.


FILE FORMAT

     Each property in the file is assumed to have the format of name = value
     where name is an alphanumeric string (and any punctuation not including
     the `=' character) and value is an arbitary string of text terminated by
     a newline character.  If newlines are desired, the entire value should be
     enclosed in { } (curly-bracket) characters.  Any line beginning with a #
     or ; character is assumed to be a comment and will be ignored.


SEE ALSO

     auth_getval(3)


BUGS

     Simplistic.


AUTHORS

     Jordan Hubbard

FreeBSD 5.4			October 7, 1998 		   FreeBSD 5.4

SPONSORED LINKS




Man(1) output converted with man2html , sed , awk