libunbound.3 (256281) | libunbound.3 (269257) |
---|---|
1.TH "libunbound" "3" "Mar 21, 2013" "NLnet Labs" "unbound 1.4.20" | 1.TH "libunbound" "3" "Mar 12, 2014" "NLnet Labs" "unbound 1.4.22" |
2.\" 3.\" libunbound.3 -- unbound library functions manual 4.\" 5.\" Copyright (c) 2007, NLnet Labs. All rights reserved. 6.\" 7.\" See LICENSE for the license. 8.\" 9.\" --- 27 unchanged lines hidden (view full) --- 37.B ub_cancel, 38.B ub_resolve_free, 39.B ub_strerror, 40.B ub_ctx_print_local_zones, 41.B ub_ctx_zone_add, 42.B ub_ctx_zone_remove, 43.B ub_ctx_data_add, 44.B ub_ctx_data_remove | 2.\" 3.\" libunbound.3 -- unbound library functions manual 4.\" 5.\" Copyright (c) 2007, NLnet Labs. All rights reserved. 6.\" 7.\" See LICENSE for the license. 8.\" 9.\" --- 27 unchanged lines hidden (view full) --- 37.B ub_cancel, 38.B ub_resolve_free, 39.B ub_strerror, 40.B ub_ctx_print_local_zones, 41.B ub_ctx_zone_add, 42.B ub_ctx_zone_remove, 43.B ub_ctx_data_add, 44.B ub_ctx_data_remove |
45\- Unbound DNS validating resolver 1.4.20 functions. | 45\- Unbound DNS validating resolver 1.4.22 functions. |
46.SH "SYNOPSIS" 47.LP 48.B #include <unbound.h> 49.LP 50\fIstruct ub_ctx *\fR 51\fBub_ctx_create\fR(\fIvoid\fR); 52.LP 53\fIvoid\fR --- 112 unchanged lines hidden (view full) --- 166.B ub_ctx_create 167Create a new context, initialised with defaults. 168The information from /etc/resolv.conf and /etc/hosts is not utilised 169by default. Use 170.B ub_ctx_resolvconf 171and 172.B ub_ctx_hosts 173to read them. | 46.SH "SYNOPSIS" 47.LP 48.B #include <unbound.h> 49.LP 50\fIstruct ub_ctx *\fR 51\fBub_ctx_create\fR(\fIvoid\fR); 52.LP 53\fIvoid\fR --- 112 unchanged lines hidden (view full) --- 166.B ub_ctx_create 167Create a new context, initialised with defaults. 168The information from /etc/resolv.conf and /etc/hosts is not utilised 169by default. Use 170.B ub_ctx_resolvconf 171and 172.B ub_ctx_hosts 173to read them. |
174Before you call this, use the openssl functions CRYPTO_set_id_callback and 175CRYPTO_set_locking_callback to set up asyncronous operation if you use 176lib openssl (the application calls these functions once for initialisation). |
|
174.TP 175.B ub_ctx_delete 176Delete validation context and free associated resources. 177Outstanding async queries are killed and callbacks are not called for them. 178.TP 179.B ub_ctx_set_option 180A power\-user interface that lets you specify one of the options from the 181config file format, see \fIunbound.conf\fR(5). Not all options are --- 177 unchanged lines hidden (view full) --- 359 int secure; /* true if result is secure */ 360 int bogus; /* true if a security failure happened */ 361 char* why_bogus; /* string with error if bogus */ 362 int ttl; /* number of seconds the result is valid */ 363 }; 364.fi 365.P 366If both secure and bogus are false, security was not enabled for the | 177.TP 178.B ub_ctx_delete 179Delete validation context and free associated resources. 180Outstanding async queries are killed and callbacks are not called for them. 181.TP 182.B ub_ctx_set_option 183A power\-user interface that lets you specify one of the options from the 184config file format, see \fIunbound.conf\fR(5). Not all options are --- 177 unchanged lines hidden (view full) --- 362 int secure; /* true if result is secure */ 363 int bogus; /* true if a security failure happened */ 364 char* why_bogus; /* string with error if bogus */ 365 int ttl; /* number of seconds the result is valid */ 366 }; 367.fi 368.P 369If both secure and bogus are false, security was not enabled for the |
367domain of the query. | 370domain of the query. Else, they are not both true, one of them is true. |
368.SH "RETURN VALUES" 369Many routines return an error code. The value 0 (zero) denotes no error 370happened. Other values can be passed to 371.B ub_strerror 372to obtain a readable error string. 373.B ub_strerror 374returns a zero terminated string. 375.B ub_ctx_create 376returns NULL on an error (a malloc failure). 377.B ub_poll 378returns true if some information may be available, false otherwise. 379.B ub_fd 380returns a file descriptor or \-1 on error. 381.SH "SEE ALSO" 382\fIunbound.conf\fR(5), 383\fIunbound\fR(8). 384.SH "AUTHORS" 385.B Unbound 386developers are mentioned in the CREDITS file in the distribution. | 371.SH "RETURN VALUES" 372Many routines return an error code. The value 0 (zero) denotes no error 373happened. Other values can be passed to 374.B ub_strerror 375to obtain a readable error string. 376.B ub_strerror 377returns a zero terminated string. 378.B ub_ctx_create 379returns NULL on an error (a malloc failure). 380.B ub_poll 381returns true if some information may be available, false otherwise. 382.B ub_fd 383returns a file descriptor or \-1 on error. 384.SH "SEE ALSO" 385\fIunbound.conf\fR(5), 386\fIunbound\fR(8). 387.SH "AUTHORS" 388.B Unbound 389developers are mentioned in the CREDITS file in the distribution. |