MAN page from Other c-ares-1.3.0-4.sl5.x86_64.rpm

ARES_MKQUERY

Section: C Library Functions (3)
Updated: 4 January 2000
Index

NAME

ares_mkquery - Compose a single-question DNS query buffer

SYNOPSIS

#include <ares.h>int ares_mkquery(const char *name, int dnsclass, int type,

DESCRIPTION

Theares_mkqueryfunction composes a DNS query with a single question.The parameternamegives the query name as a NUL-terminated C string of period-separatedlabels optionally ending with a period; periods and backslashes withina label must be escaped with a backlash. The parametersdnsclassandtypegive the class and type of the query using the values defined in<arpa/nameser.h>.The parameteridgives a 16-bit identifier for the query. The parameterrdshould be nonzero if recursion is desired, zero if not. The querywill be placed in an allocated buffer, a pointer to which will bestored in the variable pointed to bybuf,and the length of which will be stored in the variable pointed to bybuflen.It is the caller's responsibility to free this buffer usingares_free_string(3) when it is no longer needed.

RETURN VALUES

ares_mkquerycan return any of the following values:

ARES_SUCCESS: Construction of the DNS query succeeded.
ARES_EBADNAME: The query namenamecould not be encoded as a domain name, either because it contained azero-length label or because it contained a label of more than 63characters.
ARES_ENOMEM: Memory was exhausted.

AUTHOR

Greg Hudson, MIT Information Systems
Copyright 1998, 2000 by the Massachusetts Institute of Technology.

This document was created byman2html,using the manual pages.