gnutls_x509_crt_check_hostname2 man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

gnutls_x509_crt_check_hostname2(3)  gnutls  gnutls_x509_crt_check_hostname2(3)

NAME
       gnutls_x509_crt_check_hostname2 - API function

SYNOPSIS
       #include <gnutls/x509.h>

       int  gnutls_x509_crt_check_hostname2(gnutls_x509_crt_t cert, const char
       * hostname, unsigned int flags);

ARGUMENTS
       gnutls_x509_crt_t cert
		   should contain an gnutls_x509_crt_t structure

       const char * hostname
		   A null terminated string that contains a DNS name

       unsigned int flags
		   gnutls_certificate_verify_flags

DESCRIPTION
       This function will check if the given certificate's subject matches the
       given  hostname.	  This	is  a  basic  implementation  of  the matching
       described in  RFC6125,  and  takes  into	 account  wildcards,  and  the
       DNSName/IPAddress subject alternative name PKIX extension.

       IPv4 addresses are accepted by this function in the dotted-decimal for‐
       mat (e.g, ddd.ddd.ddd.ddd),  and	 IPv6  addresses  in  the  hexadecimal
       x:x:x:x:x:x:x:x format. For them the IPAddress subject alternative name
       extension is consulted, as well as the DNSNames in case of a non-match.
       The  latter  fallback  exists  due  to misconfiguration of many servers
       which place an IPAddress inside the DNSName extension.

       The comparison of dns names may have false-negatives as it is done byte
       by byte in non-ascii names.

       When  the  flag	GNUTLS_VERIFY_DO_NOT_ALLOW_WILDCARDS  is  specified no
       wildcards are considered. Otherwise they are  only  considered  if  the
       domain  name  consists  of  three  components or more, and the wildcard
       starts at the leftmost position.

RETURNS
       non-zero for a successful match, and zero on failure.

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT
       Copyright © 2001-2014 Free Software Foundation, Inc..
       Copying and distribution of this file, with  or	without	 modification,
       are  permitted  in  any	medium	without royalty provided the copyright
       notice and this notice are preserved.

SEE ALSO
       The full documentation for gnutls is maintained as  a  Texinfo  manual.
       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
       visit

       http://www.gnutls.org/manual/

gnutls				    3.3.17  gnutls_x509_crt_check_hostname2(3)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net