doc: release notes update for rpcallowip syntax change

This commit is contained in:
Wladimir J. van der Laan 2014-10-23 13:24:58 +02:00
parent 25cc1cf8dc
commit c8a25189bc
No known key found for this signature in database
GPG Key ID: 74810B012346C9A6

View File

@ -34,29 +34,53 @@ confirmation times.
Prior releases used hard-coded fees (and priorities), and would Prior releases used hard-coded fees (and priorities), and would
sometimes create transactions that took a very long time to confirm. sometimes create transactions that took a very long time to confirm.
Statistics used to estimate fees and priorities are saved in the
data directory in the `fee_estimates.dat` file just before
program shutdown, and are read in at startup.
New Command Line Options New Command Line Options
======================== ---------------------------
-txconfirmtarget=n : create transactions that have enough fees (or priority) - `-txconfirmtarget=n` : create transactions that have enough fees (or priority)
so they are likely to confirm within n blocks (default: 1). This setting so they are likely to confirm within n blocks (default: 1). This setting
is over-ridden by the -paytxfee option. is over-ridden by the -paytxfee option.
New RPC methods New RPC methods
=============== ----------------
Fee/Priority estimation - `estimatefee nblocks` : Returns approximate fee-per-1,000-bytes needed for
-----------------------
estimatefee nblocks : Returns approximate fee-per-1,000-bytes needed for
a transaction to be confirmed within nblocks. Returns -1 if not enough a transaction to be confirmed within nblocks. Returns -1 if not enough
transactions have been observed to compute a good estimate. transactions have been observed to compute a good estimate.
estimatepriority nblocks : Returns approximate priority needed for - `estimatepriority nblocks` : Returns approximate priority needed for
a zero-fee transaction to confirm within nblocks. Returns -1 if not a zero-fee transaction to confirm within nblocks. Returns -1 if not
enough free transactions have been observed to compute a good enough free transactions have been observed to compute a good
estimate. estimate.
Statistics used to estimate fees and priorities are saved in the RPC access control changes
data directory in the 'fee_estimates.dat' file just before ==========================================
program shutdown, and are read in at startup.
Subnet matching for the purpose of access control is now done
by matching the binary network address, instead of with string wildcard matching.
For the user this means that `-rpcallowip` takes a subnet specification, which can be
- a single IP address (e.g. `1.2.3.4` or `fe80::0012:3456:789a:bcde`)
- a network/CIDR (e.g. `1.2.3.0/24` or `fe80::0000/64`)
- a network/netmask (e.g. `1.2.3.4/255.255.255.0` or `fe80::0012:3456:789a:bcde/ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff`)
An arbitrary number of `-rpcallow` arguments can be given. An incoming connection will be accepted if its origin address
matches one of them.
For example:
| 0.9.x and before | 0.10.x |
|--------------------------------------------|---------------------------------------|
| `-rpcallowip=192.168.1.1` | `-rpcallowip=192.168.1.1` (unchanged) |
| `-rpcallowip=192.168.1.*` | `-rpcallowip=192.168.1.0/24` |
| `-rpcallowip=192.168.*` | `-rpcallowip=192.168.0.0/16` |
| `-rpcallowip=*` (dangerous!) | `-rpcallowip=::/0` |
Using wildcards will result in the rule being rejected with the following error in debug.log:
Error: Invalid -rpcallowip subnet specification: *. Valid are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. 1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24).