dash/doc
unsystemizer 3421e74601 Clarify listenonion
> This new feature is enabled by default if Bitcoin Core is listening, and a connection to Tor can be made. It can be configured with the -listenonion, -torcontrol and -torpassword settings. To show verbose debugging information, pass -debug=tor.

But it is correct to say that the feature is enabled *regardless* of whether a connection to Tor can be made.

I propose to clarify that so that users can eliminate these in their logs (when `listen=1` and no Tor).
And I think it's okay to clarify about the `listen` option, because on several occasions when I read this before I always assumed `listening` meant `server=1` which cost me a lot of time in troubleshooting.

```
2016-10-24 06:19:22.551029 tor: Error connecting to Tor control socket
2016-10-24 06:19:22.551700 tor: Not connected to Tor control port 127.0.0.1:9051, trying to reconnect
```

### What version of bitcoin-core are you using?
0.12.1
2016-10-24 15:49:46 +08:00
..
gitian-building [doc] Increase recommended memory in gitian build guide 2016-08-01 09:30:32 +08:00
man regenerated all manpages with commit tag stripped, also add bitcoin-tx 2016-09-01 16:36:38 +02:00
release-notes trivial: update 0.13.0 release note info on linux arm builds 2016-10-18 09:58:20 -04:00
assets-attribution.md [doc] Merge doc/assets-attribution.md into contrib/debian/copyright 2015-09-18 18:14:42 +02:00
benchmarking.md [Doc] Add benchmarking notes 2016-05-29 17:56:34 +08:00
bips.md Update implemented bips for 0.13.1 2016-10-17 17:09:38 +02:00
bitcoin_logo_doxygen.png
build-openbsd.md doc: Update build-openbsd for 0.13.0+ and OpenBSD 5.9 2016-08-28 16:12:10 +02:00
build-osx.md [Doc] Target protobuf 2.6 in OS X build notes. 2016-09-18 19:53:02 +08:00
build-unix.md Merge #8965: Mention that PPA doesn't support Debian 2016-10-18 22:11:37 +02:00
build-windows.md Documentation for Building on Windows with WSL 2016-10-17 00:08:33 -04:00
developer-notes.md [trivial][doc] Mention ++i as preferred to i++ in dev notes 2016-08-26 19:40:24 +08:00
dnsseed-policy.md Correct spelling mistakes in doc folder 2015-10-18 06:25:43 +10:00
Doxyfile [Doc] Update Doxygen configuration file 2016-10-05 12:59:44 +08:00
files.md doc: update docs for Tor listening 2015-11-12 18:08:50 +01:00
gitian-building.md Mention Gitian building script in doc. 2016-09-30 20:32:10 +02:00
init.md Merge pull request #6621 2015-10-26 17:42:00 +01:00
README_osx.md Merge #8617: Include instructions to extract Mac OS X SDK on Linux using 7zip and SleuthKit 2016-08-29 16:17:36 +02:00
README_windows.txt build: bump version to 0.13.99 2016-07-18 12:22:18 +02:00
README.md [doc] Rework docs 2016-10-04 13:27:38 +02:00
reduce-traffic.md Remove maxuploadtargets recommended minimum 2016-09-13 18:08:17 +02:00
release-notes.md RPC: Chainparams: Remove Chainparams::fTestnetToBeDeprecatedFieldRPC 2016-10-18 13:17:38 +02:00
release-process.md [doc] Rework docs 2016-10-04 13:27:38 +02:00
REST-interface.md Add default port numbers to REST doc 2016-08-24 08:41:42 +12:00
shared-libraries.md Add NULLDUMMY verify flag in bitcoinconsensus.h 2016-09-30 23:09:19 +08:00
tor.md Clarify listenonion 2016-10-24 15:49:46 +08:00
translation_process.md Trivial: Fix typo 2016-09-19 21:17:27 -05:00
translation_strings_policy.md Init: Cleanup error and warning strings 2015-10-28 22:11:43 +01:00
travis-ci.md [doc] Rework docs 2016-10-04 13:27:38 +02:00
unit-tests.md [doc] Minor markdown fixes 2015-11-30 16:33:15 +01:00
zmq.md [qa] Switch to py3 2016-05-05 15:43:37 +02:00

Bitcoin Core 0.13.99

Setup

Bitcoin Core is the original Bitcoin client and it builds the backbone of the network. However, it downloads and stores the entire history of Bitcoin transactions (which is currently several GBs); depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to a day or more.

To download Bitcoin Core, visit bitcoincore.org.

Running

The following are some helpful notes on how to run Bitcoin on your native platform.

Unix

Unpack the files into a directory and run:

  • bin/bitcoin-qt (GUI) or
  • bin/bitcoind (headless)

Windows

Unpack the files into a directory, and then run bitcoin-qt.exe.

OS X

Drag Bitcoin-Core to your applications folder, and then run Bitcoin-Core.

Need Help?

Building

The following are developer notes on how to build Bitcoin on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.

Development

The Bitcoin repo's root README contains relevant information on the development process and automated testing.

Resources

Miscellaneous

License

Distributed under the MIT software license. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com), and UPnP software written by Thomas Bernard.