Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

socket_getaddrinfo(1p) [debian man page]

SOCKET_GETADDRINFO(1p)					User Contributed Perl Documentation				    SOCKET_GETADDRINFO(1p)

NAME

       "socket_getaddrinfo" - command-line tool to "getaddrinfo(3)" resolver

SYNOPSIS

       socket_getaddrinfo [options...] host service

DESCRIPTION

       This tool provides a convenient command-line wrapper around the getaddrinfo(3) resolver function. It will perform a single lookup and print
       the returned results in a human-readable form. This is mainly useful when debugging address resolution problems, because it allows
       inspection of the getaddrinfo(3) behaviour itself, outside of any real program that is trying to use it.

OPTIONS

       --host, -H HOST
	       Hostname to resolve. If not supplied, will use the first positional argument

       --service, -S SERVICE
	       Service name or port number to resolve. If not supplied, will use the second positional argument.

       -4      Restrict to just "AF_INET" (IPv4) results

       -6      Restrict to just "AF_INET6" (IPv6) results

       --stream
	       Restrict to just "SOCK_STREAM" results

       --dgram Restrict to just "SOCK_DGRAM" results

       --proto PROTO
	       Restrict to just results of the given IP protocol

       --passive
	       Set the "AI_PASSIVE" hint; results will used to bind() and listen() rather than connect()

       --canonical
	       Retrive the canonical name for the requested host

       --help  Display a help summary and exit

OUTPUT FORMAT

       Each line of output will be given in a form that indicates the four result fields of "ai_family", "ai_socktype", "ai_protocol" and
       "ai_addr". The first three are printed in the form of a socket(2) call, either symbolically or numerically, and the latter is printed as a
       plain string following it. For example

	socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '127.0.0.1:80'

NOTE

       Upstream this script is known as "getaddrinfo", but was renamed on Debian.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.14.2							    2012-06-08						    SOCKET_GETADDRINFO(1p)

Check Out this Related Man Page

Socket::GetAddrInfo::Strict(3pm)			User Contributed Perl Documentation			  Socket::GetAddrInfo::Strict(3pm)

NAME

       "Socket::GetAddrInfo::Strict" - Provide Socket::GetAddrInfo functions which throw exceptions

SYNOPSIS

	use Socket qw( SOCK_STREAM );
	use Socket::GetAddrInfo::Strict qw( getaddrinfo getnameinfo );
	use IO::Socket;

	my $sock;

	my %hints = ( socktype => SOCK_STREAM );
	my @res = getaddrinfo( "www.google.com", "www", \%hints );

	while( my $ai = shift @res ) {

	   $sock = IO::Socket->new();
	   $sock->socket( $ai->{family}, $ai->{socktype}, $ai->{protocol} ) or
	      undef $sock, next;

	   $sock->connect( $ai->{addr} ) or undef $sock, next;

	   last;
	}

	if( $sock ) {
	   my ( $host, $service ) = getnameinfo( $sock->peername );
	   print "Connected to $host:$service
";
	}

DESCRIPTION

       Socket::GetAddrInfo provides the functions of "getaddrinfo" and "getnameinfo", which return lists whose first element is error value, or
       false indicating no error occured.

       This module wraps the functions provided by "Socket::GetAddrInfo" to check this error value, and throw an exception (using "die") if an
       error occured.  If not, then the remaining values are returned as normal. This can simplify the logic of a program which otherwise simply
       throws its own exception on failure anyway.

FUNCTIONS

   @res = getaddrinfo( $host, $service, $hints )
       After a successful lookup, returns the list of address structures, as documented in Socket::GetAddrInfo. If the lookup fails, an exception
       containing the string form of the error is thrown instead.

   ( $host, $service ) = getnameinfo( $addr, $flags, $xflags )
       After a successful lookup, returns the host and service name, as documented in Socket::GetAddrInfo. If the lookup fails, an exception
       containing the string form of the error is thrown instead.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.14.2							    2012-06-08					  Socket::GetAddrInfo::Strict(3pm)
Man Page