doc/tor-resolve.1.txt

   1 // Copyright (c) The Tor Project, Inc.
   2 // See LICENSE for licensing information
   3 // This is an asciidoc file used to generate the manpage/html reference.
   4 // Learn asciidoc on http://www.methods.co.nz/asciidoc/userguide.html
   5 :man source:   Tor
   6 :man manual:   Tor Manual
   7 tor-resolve(1)
   8 ==============
   9 Peter Palfrader
  10
  11 NAME
  12 ----
  13 tor-resolve - resolve a hostname to an IP address via tor
  14
  15 SYNOPSIS
  16 --------
  17 **tor-resolve** [-4|-5] [-v] [-x] [-p __socksport__] __hostname__ [__sockshost__[:__socksport__]]
  18
  19 DESCRIPTION
  20 -----------
  21 **tor-resolve** is a simple script to connect to a SOCKS proxy that knows about
  22 the SOCKS RESOLVE command, hand it a hostname, and return an IP address.
  23
  24 By default, **tor-resolve** uses the Tor server running on 127.0.0.1 on SOCKS
  25 port 9050.  If this isn't what you want, you should specify an explicit
  26 __sockshost__ and/or __socksport__ on the command line.
  27
  28 OPTIONS
  29 -------
  30 **-v**::
  31     Display verbose output.
  32
  33 **-x**::
  34     Perform a reverse lookup: get the PTR record for an IPv4 address.
  35
  36 **-5**::
  37     Use the SOCKS5 protocol. (Default)
  38
  39 **-4**::
  40     Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't
  41     support reverse DNS.
  42
  43 **-p** __socksport__::
  44     Override the default SOCKS port without setting the hostname.
  45
  46 SEE ALSO
  47 --------
  48 **tor**(1), **torify**(1). +
  49
  50 For protocol details, see: https://spec.torproject.org/socks-extensions
  51
  52 AUTHORS
  53 -------
  54 Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.