Skip to content

Conversation

@maflcko
Copy link
Member

@maflcko maflcko commented Jun 6, 2020

Moving the documentation of each flag form the already over-large init.cpp into the net permissions module should clean up the code a bit. Moreover, making the documentation available is also required for an (currently imaginary) setnetpermissions RPC.

@maflcko maflcko added the Docs label Jun 6, 2020
@maflcko
Copy link
Member Author

maflcko commented Jun 6, 2020

Can be tested by calling ./contrib/devtools/gen-manpages.sh before and after and observing the difference.

@DrahtBot
Copy link
Contributor

DrahtBot commented Jun 7, 2020

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Conflicts

Reviewers, this pull request conflicts with the following ones:

If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

@Sjors
Copy link
Member

Sjors commented Jun 8, 2020

tACK faeb4f4fd4ba07063213e5a7fda797b2c53cc29f

@maflcko maflcko force-pushed the 2006-docNetPerm branch from faeb4f4 to fa2c2b5 Compare June 8, 2020 10:59
@maflcko
Copy link
Member Author

maflcko commented Jun 8, 2020

Rebased to solve merge conflict and reduce diff by +1-1

Copy link
Member

@jonatack jonatack left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK faeb4f4fd4ba07063213e5a7fda797b2c53cc29f

$ bitcoind -regtest -h | grep -A8 whitebind
  -whitebind=<[permissions@]addr>
       Bind to given address and whitelist peers connecting to it. Use
       [host]:port notation for IPv6. Allowed permissions: bloomfilter
       (allow requesting BIP37 filtered blocks and transactions), noban
       (do not ban for misbehavior), forcerelay (relay transactions that
       are already in the mempool; implies relay), relay (relay even in
       -blocksonly mode), mempool (allow requesting BIP35 mempool
       contents). Specify multiple permissions separated by commas
       (default: noban,mempool,relay). Can be specified multiple times.
--

It might be helpful to append an example at the end of the help.

@maflcko
Copy link
Member Author

maflcko commented Jun 8, 2020

It might be helpful to append an example at the end of the help.

I'll keep it as is for now to minimize the rendered diff. If deemed important, this can be done in a follow-up, but I think -whitebind=<[permissions@]addr>, with the (default: noban,mempool,relay) already serve as a good example.

@Sjors
Copy link
Member

Sjors commented Jun 8, 2020

re-utACK fa2c2b5

@maflcko maflcko merged commit 41fb694 into bitcoin:master Jun 8, 2020
@jonatack
Copy link
Member

jonatack commented Jun 8, 2020

re-ACK fa2c2b5

@maflcko maflcko deleted the 2006-docNetPerm branch June 8, 2020 11:29
maflcko pushed a commit to maflcko/bitcoin-core that referenced this pull request Jan 5, 2021
deadalnix pushed a commit to Bitcoin-ABC/bitcoin-abc that referenced this pull request Mar 22, 2021
Summary:
```
Moving the documentation of each flag form the already over-large
init.cpp into the net permissions module should clean up the code a bit.
Moreover, making the documentation available is also required for an
(currently imaginary) setnetpermissions RPC.
```

Backport of [[bitcoin/bitcoin#19192 | core#19192]].

Test Plan:
  bitcoind -help
Check the -whitebind option is unchanged.

Reviewers: #bitcoin_abc, majcosta

Reviewed By: #bitcoin_abc, majcosta

Differential Revision: https://reviews.bitcoinabc.org/D9325
@bitcoin bitcoin locked as resolved and limited conversation to collaborators Feb 15, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants