117 lines
3.5 KiB
Groff
117 lines
3.5 KiB
Groff
.\" Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
|
|
.\"
|
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
.\" file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
.\"
|
|
.hy 0
|
|
.ad l
|
|
'\" t
|
|
.\" Title: lwres_config
|
|
.\" Author:
|
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
|
.\" Date: 2007-06-18
|
|
.\" Manual: BIND9
|
|
.\" Source: ISC
|
|
.\" Language: English
|
|
.\"
|
|
.TH "LWRES_CONFIG" "3" "2007\-06\-18" "ISC" "BIND9"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get \- lightweight resolver configuration
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
.ft B
|
|
.nf
|
|
#include <lwres/lwres\&.h>
|
|
.fi
|
|
.ft
|
|
.HP \w'void\ lwres_conf_init('u
|
|
.BI "void lwres_conf_init(lwres_context_t\ *" "ctx" ");"
|
|
.HP \w'void\ lwres_conf_clear('u
|
|
.BI "void lwres_conf_clear(lwres_context_t\ *" "ctx" ");"
|
|
.HP \w'lwres_result_t\ lwres_conf_parse('u
|
|
.BI "lwres_result_t lwres_conf_parse(lwres_context_t\ *" "ctx" ", const\ char\ *" "filename" ");"
|
|
.HP \w'lwres_result_t\ lwres_conf_print('u
|
|
.BI "lwres_result_t lwres_conf_print(lwres_context_t\ *" "ctx" ", FILE\ *" "fp" ");"
|
|
.HP \w'lwres_conf_t\ *\ lwres_conf_get('u
|
|
.BI "lwres_conf_t * lwres_conf_get(lwres_context_t\ *" "ctx" ");"
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
\fBlwres_conf_init()\fR
|
|
creates an empty
|
|
\fBlwres_conf_t\fR
|
|
structure for lightweight resolver context
|
|
\fIctx\fR\&.
|
|
.PP
|
|
\fBlwres_conf_clear()\fR
|
|
frees up all the internal memory used by that
|
|
\fBlwres_conf_t\fR
|
|
structure in resolver context
|
|
\fIctx\fR\&.
|
|
.PP
|
|
\fBlwres_conf_parse()\fR
|
|
opens the file
|
|
\fIfilename\fR
|
|
and parses it to initialise the resolver context
|
|
\fIctx\fR\*(Aqs
|
|
\fBlwres_conf_t\fR
|
|
structure\&.
|
|
.PP
|
|
\fBlwres_conf_print()\fR
|
|
prints the
|
|
\fBlwres_conf_t\fR
|
|
structure for resolver context
|
|
\fIctx\fR
|
|
to the
|
|
\fBFILE\fR\fIfp\fR\&.
|
|
.SH "RETURN VALUES"
|
|
.PP
|
|
\fBlwres_conf_parse()\fR
|
|
returns
|
|
\fBLWRES_R_SUCCESS\fR
|
|
if it successfully read and parsed
|
|
\fIfilename\fR\&. It returns
|
|
\fBLWRES_R_FAILURE\fR
|
|
if
|
|
\fIfilename\fR
|
|
could not be opened or contained incorrect resolver statements\&.
|
|
.PP
|
|
\fBlwres_conf_print()\fR
|
|
returns
|
|
\fBLWRES_R_SUCCESS\fR
|
|
unless an error occurred when converting the network addresses to a numeric host address string\&. If this happens, the function returns
|
|
\fBLWRES_R_FAILURE\fR\&.
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBstdio\fR(3),
|
|
\fBresolver\fR(5)\&.
|
|
.SH "FILES"
|
|
.PP
|
|
/etc/resolv\&.conf
|
|
.SH "AUTHOR"
|
|
.PP
|
|
\fBInternet Systems Consortium, Inc\&.\fR
|
|
.SH "COPYRIGHT"
|
|
.br
|
|
Copyright \(co 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
|
|
.br
|