whois

README

Whois

Whois is a simple Go module for domain and ip whois information query.

Overview

All of domain, IP include IPv4 and IPv6, ASN are supported.

You can directly using the binary distributions whois, follow whois release tool.

Or you can do development by using this golang module as below.

Installation

go get -u github.com/likexian/whois

Importing

import (
    "github.com/likexian/whois"
)

Documentation

Visit the docs on GoDoc

Example

whois query for domain

result, err := whois.Whois("likexian.com")
if err == nil {
    fmt.Println(result)
}

whois query for IPv6

result, err := whois.Whois("2001:dc7::1")
if err == nil {
    fmt.Println(result)
}

whois query for IPv4

result, err := whois.Whois("1.1.1.1")
if err == nil {
    fmt.Println(result)
}

whois query for ASN

// or whois.Whois("AS60614")
result, err := whois.Whois("60614")
if err == nil {
    fmt.Println(result)
}

Whois information parsing

Please refer to whois-parser

License

Copyright 2014-2024 Li Kexian

Licensed under the Apache License 2.0

Donation

If this project is helpful, please share it with friends.

If you want to thank me, you can give me a cup of coffee.

Documentation

Index

• Variables
• func Author() string
• func IsASN(s string) bool
• func License() string
• func Version() string
• func Whois(domain string, servers ...string) (result string, err error)
• type Client
  • func NewClient() *Client
  • func (c *Client) SetDialer(dialer proxy.Dialer) *Client
  • func (c *Client) SetDisableReferral(disabled bool) *Client
  • func (c *Client) SetDisableReferralChain(disabled bool) *Client
  • func (c *Client) SetDisableStats(disabled bool) *Client
  • func (c *Client) SetTimeout(timeout time.Duration) *Client
  • func (c *Client) Whois(domain string, servers ...string) (result string, err error)

Variables

var (
	// ErrDomainEmpty is domain is an empty string
	ErrDomainEmpty = errors.New("whois: domain is empty")

	// ErrWhoisServerNotFound is no whois server found
	ErrWhoisServerNotFound = errors.New("whois: no whois server found for domain")
)

var DefaultClient = NewClient()

DefaultClient is default whois client

Functions

func Author

func Author() string

Author returns package author

func IsASN

func IsASN(s string) bool

IsASN returns if s is ASN

func License

func License() string

License returns package license

func Version

func Version() string

Version returns package version

func Whois

func Whois(domain string, servers ...string) (result string, err error)

Whois do the whois query and returns whois information

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is whois client

func NewClient

func NewClient() *Client

NewClient returns new whois client

func (*Client) SetDialer

func (c *Client) SetDialer(dialer proxy.Dialer) *Client

SetDialer set query net dialer

func (*Client) SetDisableReferral

func (c *Client) SetDisableReferral(disabled bool) *Client

SetDisableReferral if set to true, will not query the referral server.

func (*Client) SetDisableReferralChain

func (c *Client) SetDisableReferralChain(disabled bool) *Client

SetDisableReferralChain controls whether to keep all WHOIS responses in the output

func (*Client) SetDisableStats

func (c *Client) SetDisableStats(disabled bool) *Client

SetDisableStats set disable stats

func (*Client) SetTimeout

func (c *Client) SetTimeout(timeout time.Duration) *Client

SetTimeout set query timeout

func (*Client) Whois

func (c *Client) Whois(domain string, servers ...string) (result string, err error)

Whois do the whois query and returns whois information