Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
getdns_list(3)			    getdns			getdns_list(3)

NAME
       getdns_list, getdns_list_create,	getdns_list_create_with_extended_mem-
       ory_functions, getdns_list_create_with_memory_functions,
       getdns_list_destroy -- getdns list create and destroy routines

LIBRARY
       DNS Resolver library (libgetdns,	-lgetdns)

SYNOPSIS
       #include	<getdns.h>

       getdns_list *
       getdns_list_create ()

       getdns_list *
       getdns_list_create_with_extended_memory_functions
	  (void	*userarg,
	  void *(*malloc)(void *userarg, size_t	sz),
	  void *(*realloc)(void	*userarg, void *buf, size_t sz),
	  void (*free)(void *userarg, void *buf)

getdns_list *
getdns_list_create_with_memory_functions
   (void *userarg,
   void	*(*malloc)(size_t sz),
   void	*(*realloc)(void *buf, size_t sz),
   void	(*free)(void *buf)

void
getdns_list_destroy (getdns_list *this_dict)

DESCRIPTION
       The  getdns_list	 type  is  used	 to manage heterogeneous indexed lists
       name/value pairs	in which the data types	of the values include
	  getdns_bindata
	  getdns_dict
	  getdns_list
	  uint32_t

       The destroy function performs a "deep" destroy, freeing storage for all
       of the members of the list before destroying the	 list.	 There	are  a
       number  of helper functions that	provide	access to the list object, see
       their respective	man pages.

       userarg pass this argument to  the  user	 specified  memory  management
       functions  for  operations on lists created using extended memory func-
       tions

       this_list the list to destroy

RETURN VALUES
       Upon successful completion the getdns_list_create  function  returns  a
       valid  (empty)  list  structure	that  should  be  freed	 via a call to
       getdns_list_destroy.  If	a parameter in invalid or in the event of some
       error getdns_list_create	returns	NULL.

EXAMPLES
       TBD

SEE ALSO
       libgetdns(3), getdns_dict(3), getdns_list_get(3), getdns_list_set(3)

getdns 1.5.2			 December 2015			getdns_list(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getdns_list&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help