---
name: "val_getnameinfo"
section: "3"
platform: "linux"
package: "libval-dev"
version: "2.0-1.1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/val_getaddrinfo"
---

# val\_getnameinfo(3)

get DNSSEC-validated network address and service translation

Part of [val\_getaddrinfo(3)](/val_getaddrinfo/3.md).

## NAME

val\_getaddrinfo() - get DNSSEC-validated network address and service translation

## SYNOPSIS

```
  #include <validator.h>
  int val_getaddrinfo(const struct val_context *ctx,
                      const char *nodename,
                      const char *servname,
                      const struct addrinfo *hints,
                      struct addrinfo **res,
                      val_status_t * val_status);
  int val_getnameinfo(val_context_t * ctx,
                      const struct sockaddr *sa,
                      socklen_t salen,
                      char *host,
                      size_t hostlen,
                      char *serv,
                      size_t servlen,
                      int flags,
                      val_status_t * val_status);
```

## DESCRIPTION

*val\_getaddrinfo()* and *val\_getnameinfo* perform DNSSEC validation of DNS queries.  They are intended to be DNSSEC-aware replacements for *[getaddrinfo(3)](/getaddrinfo/3.md)* and *[getnameinfo(3)](/getnameinfo/3.md)*.

*val\_getaddrinfo()*  returns a network address value of type *struct* *addrinfo* in the *res* parameter.  *val\_getnameinfo* is used to convert a *sockaddr* structure to a pair of host name and service strings.

*val\_status* gives the combined validation status value for all answers returned by the each of the functions.  *val\_istrusted()* and *val\_isvalidated()* can be used to determine the trustworthiness of data and *p\_val\_status()* can be used to display the status value to the user in ASCII format (See *[libval(3)](/libval/3.md)* more for information).

The *ctx* parameter specifies the validation context, which can be set to NULL for default values (see *[libval(3)](/libval/3.md)* and *dnsval.conf* for more details on validation contexts and validation policy).

The *nodename*, *servname*, and *hints* parameters have similar syntax and semantics as the corresponding parameters for the original *getaddrinfo()* function.  The *res* parameter is similar to the *res* parameter for *getaddrinfo()*.  Please see the manual page for *[getaddrinfo(3)](/getaddrinfo/3.md)* for more details about these parameters.

## RETURN VALUES

The *val\_getaddrinfo()* function returns 0 on success and a non-zero error code on failure.  *\*res* will point to a dynamically allocated linked list of *addrinfo* structures on success and will be NULL if no answer was available.

The *val\_status* parameter gives an indication for trustworthiness of data. If *\*res* is NULL, this value gives an indication of whether the non-existence of data can be trusted or not.

## EXAMPLE

```
 #include <stdio.h>
 #include <stdlib.h>
 #include <validator.h>
 int main(int argc, char *argv[])
 {
          struct addrinfo *ainfo = NULL;
          int retval;
          if (argc < 2) {
                  printf("Usage: %s <hostname>\n", argv[0]);
                  exit(1);
          }
          retval = val_getaddrinfo(NULL, argv[1], NULL, NULL, &ainfo);
          if ((retval == 0) && (ainfo != NULL)) {
                  printf("Validation Status = %d [%s]\n",
                         ainfo->ai_val_status,
                         p_val_status(ainfo->ai_val_status));
                  val_freeaddrinfo(ainfo);
          }
          return 0;
 }
```

## COPYRIGHT

Copyright 2004-2013 SPARTA, Inc.  All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

## AUTHORS

Abhijit Hayatnagarkar, Michael Baer

## SEE ALSO

*[getaddrinfo(3)](/getaddrinfo/3.md)*

*[val\_gethostbyname(3)](/val_gethostbyname/3.md)*, *[val\_res\_query(3)](/val_res_query/3.md)*

*[libval(3)](/libval/3.md)*

http://www.dnssec-tools.org