lwres_gnba.html revision 89da2a56413ba6294315bdde04f7547b9d71b062
2N/A<!--
2N/A - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
2N/A - Copyright (C) 2001 Internet Software Consortium.
2N/A -
2N/A - Permission to use, copy, modify, and distribute this software for any
2N/A - purpose with or without fee is hereby granted, provided that the above
2N/A - copyright notice and this permission notice appear in all copies.
2N/A -
2N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
2N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
2N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
2N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
2N/A - PERFORMANCE OF THIS SOFTWARE.
2N/A-->
2N/A
2N/A<!-- $Id: lwres_gnba.html,v 1.11 2005/04/03 03:31:37 marka Exp $ -->
2N/A
2N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2N/A<HTML
2N/A><HEAD
2N/A><TITLE
2N/A>lwres_gnba</TITLE
2N/A><META
2N/ANAME="GENERATOR"
2N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
2N/A><BODY
2N/ACLASS="REFENTRY"
2N/ABGCOLOR="#FFFFFF"
2N/ATEXT="#000000"
2N/ALINK="#0000FF"
2N/AVLINK="#840084"
2N/AALINK="#0000FF"
2N/A><H1
2N/A><A
2N/ANAME="AEN1"
2N/A></A
2N/A>lwres_gnba</H1
2N/A><DIV
2N/ACLASS="REFNAMEDIV"
2N/A><A
2N/ANAME="AEN8"
2N/A></A
2N/A><H2
2N/A>Name</H2
2N/A>lwres_gnbarequest_render, lwres_gnbaresponse_render, lwres_gnbarequest_parse, lwres_gnbaresponse_parse, lwres_gnbaresponse_free, lwres_gnbarequest_free&nbsp;--&nbsp;lightweight resolver getnamebyaddress message handling</DIV
2N/A><DIV
2N/ACLASS="REFSYNOPSISDIV"
2N/A><A
2N/ANAME="AEN16"
2N/A></A
2N/A><H2
2N/A>Synopsis</H2
2N/A><DIV
2N/ACLASS="FUNCSYNOPSIS"
2N/A><P
2N/A></P
2N/A><A
2N/ANAME="AEN17"
2N/A></A
2N/A><PRE
2N/ACLASS="FUNCSYNOPSISINFO"
2N/A>#include &lt;lwres/lwres.h&gt;</PRE
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>lwres_result_t
2N/Alwres_gnbarequest_render</CODE
2N/A>(lwres_context_t *ctx, lwres_gnbarequest_t *req, lwres_lwpacket_t *pkt, lwres_buffer_t *b);</CODE
2N/A></P
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>lwres_result_t
2N/Alwres_gnbaresponse_render</CODE
2N/A>(lwres_context_t *ctx, lwres_gnbaresponse_t *req, lwres_lwpacket_t *pkt, lwres_buffer_t *b);</CODE
2N/A></P
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>lwres_result_t
2N/Alwres_gnbarequest_parse</CODE
2N/A>(lwres_context_t *ctx, lwres_buffer_t *b, lwres_lwpacket_t *pkt, lwres_gnbarequest_t **structp);</CODE
2N/A></P
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>lwres_result_t
2N/Alwres_gnbaresponse_parse</CODE
2N/A>(lwres_context_t *ctx, lwres_buffer_t *b, lwres_lwpacket_t *pkt, lwres_gnbaresponse_t **structp);</CODE
2N/A></P
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>void
2N/Alwres_gnbaresponse_free</CODE
2N/A>(lwres_context_t *ctx, lwres_gnbaresponse_t **structp);</CODE
2N/A></P
2N/A><P
2N/A><CODE
2N/A><CODE
2N/ACLASS="FUNCDEF"
2N/A>void
2N/Alwres_gnbarequest_free</CODE
2N/A>(lwres_context_t *ctx, lwres_gnbarequest_t **structp);</CODE
2N/A></P
2N/A><P
2N/A></P
2N/A></DIV
2N/A></DIV
2N/A><DIV
2N/ACLASS="REFSECT1"
2N/A><A
2N/ANAME="AEN61"
2N/A></A
2N/A><H2
2N/A>DESCRIPTION</H2
2N/A><P
2N/A>These are low-level routines for creating and parsing
2N/Alightweight resolver address-to-name lookup request and
2N/Aresponse messages.</P
2N/A><P
2N/A>There are four main functions for the getnamebyaddr opcode.
2N/AOne render function converts a getnamebyaddr request structure &mdash;
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbarequest_t</SPAN
2N/A> &mdash;
2N/Ato the lightweight resolver's canonical format.
2N/AIt is complemented by a parse function that converts a packet in this
2N/Acanonical format to a getnamebyaddr request structure.
2N/AAnother render function converts the getnamebyaddr response structure &mdash;
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbaresponse_t</SPAN
2N/A>
2N/Ato the canonical format.
2N/AThis is complemented by a parse function which converts a packet in
2N/Acanonical format to a getnamebyaddr response structure.</P
2N/A><P
2N/A>These structures are defined in
2N/A<TT
2N/ACLASS="FILENAME"
2N/A>lwres/lwres.h</TT
2N/A>.
2N/AThey are shown below.
2N/A<PRE
2N/ACLASS="PROGRAMLISTING"
2N/A>#define LWRES_OPCODE_GETNAMEBYADDR 0x00010002U
2N/A
2N/Atypedef struct {
2N/A lwres_uint32_t flags;
2N/A lwres_addr_t addr;
2N/A} lwres_gnbarequest_t;
2N/A
2N/Atypedef struct {
2N/A lwres_uint32_t flags;
2N/A lwres_uint16_t naliases;
2N/A char *realname;
2N/A char **aliases;
2N/A lwres_uint16_t realnamelen;
2N/A lwres_uint16_t *aliaslen;
2N/A void *base;
2N/A size_t baselen;
2N/A} lwres_gnbaresponse_t;</PRE
2N/A></P
2N/A><P
2N/A><CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_render()</CODE
2N/A>
2N/Auses resolver context
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>ctx</CODE
2N/A>
2N/Ato convert getnamebyaddr request structure
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>req</CODE
2N/A>
2N/Ato canonical format.
2N/AThe packet header structure
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>pkt</CODE
2N/A>
2N/Ais initialised and transferred to
2N/Abuffer
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>b</CODE
2N/A>.
2N/AThe contents of
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>*req</CODE
2N/A>
2N/Aare then appended to the buffer in canonical format.
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_render()</CODE
2N/A>
2N/Aperforms the same task, except it converts a getnamebyaddr response structure
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbaresponse_t</SPAN
2N/A>
2N/Ato the lightweight resolver's canonical format.</P
2N/A><P
2N/A><CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_parse()</CODE
2N/A>
2N/Auses context
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>ctx</CODE
2N/A>
2N/Ato convert the contents of packet
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>pkt</CODE
2N/A>
2N/Ato a
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbarequest_t</SPAN
2N/A>
2N/Astructure.
2N/ABuffer
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>b</CODE
2N/A>
2N/Aprovides space to be used for storing this structure.
2N/AWhen the function succeeds, the resulting
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbarequest_t</SPAN
2N/A>
2N/Ais made available through
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>*structp</CODE
2N/A>.
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_parse()</CODE
2N/A>
2N/Aoffers the same semantics as
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_parse()</CODE
2N/A>
2N/Aexcept it yields a
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbaresponse_t</SPAN
2N/A>
2N/Astructure.</P
2N/A><P
2N/A><CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_free()</CODE
2N/A>
2N/Aand
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_free()</CODE
2N/A>
2N/Arelease the memory in resolver context
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>ctx</CODE
2N/A>
2N/Athat was allocated to the
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbaresponse_t</SPAN
2N/A>
2N/Aor
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbarequest_t</SPAN
2N/A>
2N/Astructures referenced via
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>structp</CODE
2N/A>.
2N/AAny memory associated with ancillary buffers and strings for those
2N/Astructures is also discarded.</P
2N/A></DIV
2N/A><DIV
2N/ACLASS="REFSECT1"
2N/A><A
2N/ANAME="AEN97"
2N/A></A
2N/A><H2
2N/A>RETURN VALUES</H2
2N/A><P
2N/A>The getnamebyaddr opcode functions
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_render()</CODE
2N/A>,
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_render()</CODE
2N/A>
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_parse()</CODE
2N/A>
2N/Aand
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_parse()</CODE
2N/A>
2N/Aall return
2N/A<SPAN
2N/ACLASS="ERRORCODE"
2N/A>LWRES_R_SUCCESS</SPAN
2N/A>
2N/Aon success.
2N/AThey return
2N/A<SPAN
2N/ACLASS="ERRORCODE"
2N/A>LWRES_R_NOMEMORY</SPAN
2N/A>
2N/Aif memory allocation fails.
2N/A<SPAN
2N/ACLASS="ERRORCODE"
2N/A>LWRES_R_UNEXPECTEDEND</SPAN
2N/A>
2N/Ais returned if the available space in the buffer
2N/A<CODE
2N/ACLASS="VARNAME"
2N/A>b</CODE
2N/A>
2N/Ais too small to accommodate the packet header or the
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbarequest_t</SPAN
2N/A>
2N/Aand
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_gnbaresponse_t</SPAN
2N/A>
2N/Astructures.
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbarequest_parse()</CODE
2N/A>
2N/Aand
2N/A<CODE
2N/ACLASS="FUNCTION"
2N/A>lwres_gnbaresponse_parse()</CODE
2N/A>
2N/Awill return
2N/A<SPAN
2N/ACLASS="ERRORCODE"
2N/A>LWRES_R_UNEXPECTEDEND</SPAN
2N/A>
2N/Aif the buffer is not empty after decoding the received packet.
2N/AThese functions will return
2N/A<SPAN
2N/ACLASS="ERRORCODE"
2N/A>LWRES_R_FAILURE</SPAN
2N/A>
2N/Aif
2N/A<CODE
2N/ACLASS="STRUCTFIELD"
2N/A>pktflags</CODE
2N/A>
2N/Ain the packet header structure
2N/A<SPAN
2N/ACLASS="TYPE"
2N/A>lwres_lwpacket_t</SPAN
2N/A>
2N/Aindicate that the packet is not a response to an earlier query.</P
2N/A></DIV
2N/A><DIV
2N/ACLASS="REFSECT1"
2N/A><A
2N/ANAME="AEN116"
2N/A></A
2N/A><H2
2N/A>SEE ALSO</H2
2N/A><P
2N/A><SPAN
2N/ACLASS="CITEREFENTRY"
2N/A><SPAN
2N/ACLASS="REFENTRYTITLE"
2N/A>lwres_packet</SPAN
2N/A>(3)</SPAN
2N/A>.</P
2N/A></DIV
2N/A></BODY
2N/A></HTML
2N/A>
2N/A