40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
|
connmgr
|
||
|
|
=======
|
||
|
|
|
||
|
|
[]
|
||
|
|
(https://travis-ci.org/btcsuite/btcd) [![ISC License]
|
||
|
|
(http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)
|
||
|
|
[]
|
||
|
|
(http://godoc.org/github.com/btcsuite/btcd/connmgr)
|
||
|
|
|
||
|
|
Package connmgr implements a generic Bitcoin network connection manager.
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
Connection Manager handles all the general connection concerns such as
|
||
|
|
maintaining a set number of outbound connections, sourcing peers, banning,
|
||
|
|
limiting max connections, tor lookup, etc.
|
||
|
|
|
||
|
|
The package provides a generic connection manager which is able to accept
|
||
|
|
connection requests from a source or a set of given addresses, dial them and
|
||
|
|
notify the caller on connections. The main intended use is to initialize a pool
|
||
|
|
of active connections and maintain them to remain connected to the P2P network.
|
||
|
|
|
||
|
|
In addition the connection manager provides the following utilities:
|
||
|
|
|
||
|
|
- Notifications on connections or disconnections
|
||
|
|
- Handle failures and retry new addresses from the source
|
||
|
|
- Connect only to specified addresses
|
||
|
|
- Permanent connections with increasing backoff retry timers
|
||
|
|
- Disconnect or Remove an established connection
|
||
|
|
|
||
|
|
## Installation and Updating
|
||
|
|
|
||
|
|
```bash
|
||
|
|
$ go get -u github.com/btcsuite/btcd/connmgr
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
Package connmgr is licensed under the [copyfree](http://copyfree.org) ISC License.
|