aboutsummaryrefslogtreecommitdiff
path: root/doc/man/tor-resolve.1.txt
diff options
context:
space:
mode:
authorDavid Goulet <dgoulet@torproject.org>2020-07-14 09:02:03 -0400
committerDavid Goulet <dgoulet@torproject.org>2020-07-14 09:02:03 -0400
commit456be93956d1f0acfa50dc3bc19ac6e2b9d2d77a (patch)
treeac12639e1687e915df8330aa0584887f2725efad /doc/man/tor-resolve.1.txt
parent29a474294c968218576ec6d912a94b8187a1e47b (diff)
downloadtor-456be93956d1f0acfa50dc3bc19ac6e2b9d2d77a.tar.gz
tor-456be93956d1f0acfa50dc3bc19ac6e2b9d2d77a.zip
doc: Move manpages into doc/man/
Closes #40044 Signed-off-by: David Goulet <dgoulet@torproject.org>
Diffstat (limited to 'doc/man/tor-resolve.1.txt')
-rw-r--r--doc/man/tor-resolve.1.txt54
1 files changed, 54 insertions, 0 deletions
diff --git a/doc/man/tor-resolve.1.txt b/doc/man/tor-resolve.1.txt
new file mode 100644
index 0000000000..17a77e482f
--- /dev/null
+++ b/doc/man/tor-resolve.1.txt
@@ -0,0 +1,54 @@
+// Copyright (c) The Tor Project, Inc.
+// See LICENSE for licensing information
+// This is an asciidoc file used to generate the manpage/html reference.
+// Learn asciidoc on https://www.methods.co.nz/asciidoc/userguide.html
+:man source: Tor
+:man manual: Tor Manual
+tor-resolve(1)
+==============
+Peter Palfrader
+
+NAME
+----
+tor-resolve - resolve a hostname to an IP address via tor
+
+SYNOPSIS
+--------
+**tor-resolve** [-4|-5] [-v] [-x] [-p __socksport__] __hostname__ [__sockshost__[:__socksport__]]
+
+DESCRIPTION
+-----------
+**tor-resolve** is a simple script to connect to a SOCKS proxy that knows about
+the SOCKS RESOLVE command, hand it a hostname, and return an IP address.
+
+By default, **tor-resolve** uses the Tor server running on 127.0.0.1 on SOCKS
+port 9050. If this isn't what you want, you should specify an explicit
+__sockshost__ and/or __socksport__ on the command line.
+
+OPTIONS
+-------
+**-v**::
+ Display verbose output.
+
+**-x**::
+ Perform a reverse lookup: get the PTR record for an IPv4 address.
+
+**-5**::
+ Use the SOCKS5 protocol. (Default)
+
+**-4**::
+ Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't
+ support reverse DNS.
+
+**-p** __socksport__::
+ Override the default SOCKS port without setting the hostname.
+
+SEE ALSO
+--------
+**tor**(1), **torify**(1). +
+
+For protocol details, see: https://spec.torproject.org/socks-extensions
+
+AUTHORS
+-------
+Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.