RULI Simple API

Under construction...

This section explains how to use the high-level API for SRV records.

Such API is the RULI's standard interface for querying SRV resource records. It works in an event-driven fashion, based on function callback registration.

This document is supposed to provide sufficient information about the high-level, standard API. If anything is not clear enough, please post the issue to RULI's support site at Savannah.

1. Create event source
2. Create resolver context
3. Run event source
4. Submit query
5. Handle query answer
6. Scan query result
7. Delete query
8. Delete resolver
9. Delete event source

• Sample program
• Compiling

Create event source

Create resolver context

Run event source

Submit query

Handle query answer

Scan query result

Delete query

Delete resolver

Delete event source

Sample program

For a small example program which uses this API, please see the following file shipped with RULI source distribution:

sample/srvsearch.c

See below how to use such sample program in the command line:

$ echo _smtp._tcp.vanrein.org | ./srvsearch
_smtp._tcp.vanrein.org target=phantom.vanrein.org. port=25 addresses=212.120.81.221
_smtp._tcp.vanrein.org target=sitemail.everyone.net. port=25 addresses=216.200.145.35
$

Compiling

In order to compile your own application, add the following headers to the source file:

#include <oop.h>
#include <ruli.h>

And link the program against liboop and libruli, by using the following linker options:

-loop -lruli