Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WHOIS(1)		FreeBSD	General	Commands Manual		      WHOIS(1)

NAME
     whois -- Internet domain name and network number directory	service

SYNOPSIS
     whois [-aAbfgiIklmPQrRS] [-c TLD |	-h host] [-p port] [--]	name ...

DESCRIPTION
     The whois utility looks up	records	in the databases maintained by several
     Network Information Centers (NICs).

     By	default	whois starts by	querying the Internet Assigned Numbers Author-
     ity (IANA)	whois server, and follows referrals to whois servers that have
     more specific details about the query name.  The IANA whois server	knows
     about IP address and AS numbers as	well as	domain names.

     There are a few special cases where referrals do not work,	so whois goes
     directly to the appropriate server.  These	include	point-of-contact han-
     dles for ARIN, nic.at, NORID, and RIPE, and domain	names under ac.uk.

     The options are as	follows:

     -a	     Use the American Registry for Internet Numbers (ARIN) database.
	     It	contains network numbers used in those parts of	the world cov-
	     ered neither by APNIC, AfriNIC, LACNIC, nor by RIPE.  The query
	     syntax is documented at
	     https://www.arin.net/resources/whoisrws/whois_api.html#nicname

     -A	     Use the Asia/Pacific Network Information Center (APNIC) database.
	     It	contains network numbers used in East Asia, Australia, New
	     Zealand, and the Pacific islands.	Get query syntax documentation
	     using whois -A help

     -b	     Use the Network Abuse Clearinghouse database.  It contains	ad-
	     dresses to	which network abuse should be reported,	indexed	by do-
	     main name.

     -c	TLD  This is the equivalent of using the -h option with	an argument of
	     "TLD.whois-servers.net".  This can	be helpful for locating	coun-
	     try-class TLD whois servers.

     -f	     Use the African Network Information Centre	(AfriNIC) database.
	     It	contains network numbers used in Africa	and the	islands	of the
	     western Indian Ocean.  Get	query syntax documentation using whois
	     -f	help

     -g	     Use the US	non-military federal government	database, which	con-
	     tains points of contact for subdomains of .GOV.

     -h	host
	     Use the specified host instead of the default.  Either a host
	     name or an	IP address may be specified.

     -i	     Use the traditional Network Information Center (InterNIC)
	     (whois.internic.net) database.  This now contains only registra-
	     tions for domain names under .COM,	.NET, .EDU.  You can specify
	     the type of object	to search for like whois -i 'type name'	where
	     type can be domain, nameserver, registrar.	 The name can contain
	     * wildcards.

     -I	     Use the Internet Assigned Numbers Authority (IANA)	database.

     -k	     Use the National Internet Development Agency of Korea's (KRNIC)
	     database.	It contains network numbers and	domain contact infor-
	     mation for	Korea.

     -l	     Use the Latin American and	Caribbean IP address Regional Registry
	     (LACNIC) database.	 It contains network numbers used in much of
	     Latin America and the Caribbean.

     -m	     Use the Route Arbiter Database (RADB) database.  It contains
	     route policy specifications for a large number of operators' net-
	     works.

     -p	port
	     Connect to	the whois server on port.  If this option is not spec-
	     ified, whois defaults to port 43.

     -P	     Use the PeeringDB database	of AS numbers.	It contains details
	     about presence at internet	peering	points for many	network	opera-
	     tors.

     -Q	     Do	a quick	lookup;	whois will not attempt to follow referrals to
	     other whois servers.  This	is the default if a server is explic-
	     itly specified using one of the other options or in an environ-
	     ment variable.  See also the -R option.

     -r	     Use the R'eseaux IP Europ'eens (RIPE) database.  It contains net-
	     work numbers and domain contact information for Europe.  Get
	     query syntax documentation	using whois -r help

     -R	     Do	a recursive lookup; whois will attempt to follow referrals to
	     other whois servers.  This	is the default if no server is explic-
	     itly specified.  See also the -Q option.

     -S	     By	default	whois adjusts simple queries (without spaces) to pro-
	     duce more useful output from certain whois	servers, and it	sup-
	     presses some uninformative	output.	 With the -S option, whois
	     sends the query and prints	the output verbatim.

     The operands specified to whois are treated independently and may be used
     as	queries	on different whois servers.

ENVIRONMENT
     WHOIS_SERVER  The primary default whois server.  If this is unset,	whois
		   uses	the RA_SERVER environment variable.

     RA_SERVER	   The secondary default whois server.	If this	is unset,
		   whois will use whois.iana.org.

EXIT STATUS
     The whois utility exits 0 on success, and >0 if an	error occurs.

EXAMPLES
     To	obtain contact information about an administrator located in the Rus-
     sian TLD domain "RU", use the -c option as	shown in the following exam-
     ple, where	CONTACT-ID is substituted with the actual contact identifier.

	   whois -c RU CONTACT-ID

     (Note: This example is specific to	the TLD	"RU", but other	TLDs can be
     queried by	using a	similar	syntax.)

     The following example demonstrates	how to query a whois server using a
     non-standard port,	where "query-data" is the query	to be sent to
     "whois.example.com" on port "rwhois" (written numerically as 4321).

	   whois -h whois.example.com -p rwhois	query-data

     Some whois	servers	support	complex	queries	with dash-letter options.  You
     can use the -- option to separate whois command options from whois	server
     query options.  A query containing	spaces must be quoted as one argument
     to	the whois command.  The	following example asks the RIPE	whois server
     to	return a brief description of its "domain" object type:

	   whois -r -- '-t domain'

STANDARDS
     K.	Harrenstien, M.	Stahl, and E. Feinler, NICNAME/WHOIS, RFC 954, October
     1985.

     L.	Daigle,	WHOIS Protocol Specification, RFC 3912,	September 2004.

HISTORY
     The whois command appeared	in 4.3BSD.

FreeBSD	13.0			August 1, 2019			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXIT STATUS | EXAMPLES | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=whois&sektion=1&manpath=FreeBSD+13.2-RELEASE>

home | help