Skip to content
Bitcoin Roots

v30.3-roots.1 · Commit 7: [PATCH 07/68] build: adapt Roots maintenance and assurance to Core 30.3

doc/man/bitcoind.1

Before: doc/man/bitcoind.1 · After: doc/man/bitcoind.1

File metadata
index 8fcaeef7fbb78638349d515ec4e3a773c17b245a..d9275e4406e24da65dfc19e6908b3ec59f7c7485 100644

Download original patch · Release notes

Diff rows 1–293 of 293. Line numbers refer to the original before/after files.

+ Added− RemovedUnmarked lines are context.

Scroll the code area horizontally to read long lines. Before is on the left; after is on the right. Unified view fits narrow screens more easily.

doc/man/bitcoind.1 CHANGED
@@ -1,14 +1,14 @@
1
  .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2
- .TH BITCOIND "1" "July 2026" "bitcoind v30.3.0" "User Commands"
3
  .SH NAME
4
- bitcoind \- manual page for bitcoind v30.3.0
5
  .SH SYNOPSIS
6
  .B bitcoind
7
  [\fI\,options\/\fR]
8
  .SH DESCRIPTION
9
- Bitcoin Core daemon version v30.3.0 bitcoind
10
  .PP
11
- The Bitcoin Core daemon (bitcoind) is a headless program that connects to the Bitcoin network to validate and relay transactions and blocks, as well as relaying addresses.
12
  .PP
13
  It provides the backbone of the Bitcoin network and its RPC, REST and ZMQ services can provide various transaction, block and address\-related services.
14
  .PP
@@ -54,7 +54,13 @@ block hash)
54
  \fB\-blockreconstructionextratxn=\fR<n>
55
  .IP
56
  Extra transactions to keep in memory for compact block reconstructions
57
- (default: 100)
 
 
 
 
 
 
58
  .HP
59
  \fB\-blocksdir=\fR<dir>
60
  .IP
@@ -84,6 +90,12 @@ Specify path to read\-only configuration file. Relative paths will be
84
  prefixed by datadir location (only useable from command line, not
85
  configuration file) (default: bitcoin.conf)
86
  .HP
 
 
 
 
 
 
87
  \fB\-daemon\fR
88
  .IP
89
  Run in the background as a daemon and accept commands (default: 0)
@@ -351,8 +363,8 @@ Serve compact block filters to peers per BIP 157 (default: 0)
351
  .HP
352
  \fB\-peerbloomfilters\fR
353
  .IP
354
- Support filtering of blocks and transaction with bloom filters (default:
355
- 0)
356
  .HP
357
  \fB\-port=\fR<port>
358
  .IP
@@ -405,14 +417,17 @@ Support v2 transport (default: 1)
405
  Bind to the given address and add permission flags to the peers
406
  connecting to it. Use [host]:port notation for IPv6. Allowed
407
  permissions: bloomfilter (allow requesting BIP37 filtered blocks
408
- and transactions), noban (do not ban for misbehavior; implies
 
409
  download), forcerelay (relay transactions that are already in the
410
  mempool; implies relay), relay (relay even in \fB\-blocksonly\fR mode,
411
  and unlimited transaction announcements), mempool (allow
412
  requesting BIP35 mempool contents), download (allow getheaders
413
  during IBD, no disconnect after maxuploadtarget limit), addr
414
  (responses to GETADDR avoid hitting the cache and contain random
415
- records with the most up\-to\-date info). Specify multiple
 
 
416
  permissions separated by commas (default:
417
  download,noban,mempool,relay). Can be specified multiple times.
418
  .HP
@@ -541,50 +556,6 @@ to invoke the command.
541
  .IP
542
  Send transactions with full\-RBF opt\-in enabled (RPC only, default: 1)
543
  .PP
544
- ZeroMQ notification options:
545
- .HP
546
- \fB\-zmqpubhashblock=\fR<address>
547
- .IP
548
- Enable publish hash block in <address>
549
- .HP
550
- \fB\-zmqpubhashblockhwm=\fR<n>
551
- .IP
552
- Set publish hash block outbound message high water mark (default: 1000)
553
- .HP
554
- \fB\-zmqpubhashtx=\fR<address>
555
- .IP
556
- Enable publish hash transaction in <address>
557
- .HP
558
- \fB\-zmqpubhashtxhwm=\fR<n>
559
- .IP
560
- Set publish hash transaction outbound message high water mark (default:
561
- 1000)
562
- .HP
563
- \fB\-zmqpubrawblock=\fR<address>
564
- .IP
565
- Enable publish raw block in <address>
566
- .HP
567
- \fB\-zmqpubrawblockhwm=\fR<n>
568
- .IP
569
- Set publish raw block outbound message high water mark (default: 1000)
570
- .HP
571
- \fB\-zmqpubrawtx=\fR<address>
572
- .IP
573
- Enable publish raw transaction in <address>
574
- .HP
575
- \fB\-zmqpubrawtxhwm=\fR<n>
576
- .IP
577
- Set publish raw transaction outbound message high water mark (default:
578
- 1000)
579
- .HP
580
- \fB\-zmqpubsequence=\fR<address>
581
- .IP
582
- Enable publish hash block and tx sequence in <address>
583
- .HP
584
- \fB\-zmqpubsequencehwm=\fR<n>
585
- .IP
586
- Set publish hash sequence message high water mark (default: 1000)
587
- .PP
588
  Debugging/Testing options:
589
  .HP
590
  \fB\-debug=\fR<category>
@@ -645,7 +616,7 @@ logging to file, set \fB\-nodebuglogfile\fR)
645
  .HP
646
  \fB\-shrinkdebugfile\fR
647
  .IP
648
- Shrink debug.log file on client startup (default: 1 when no \fB\-debug\fR)
649
  .HP
650
  \fB\-uacomment=\fR<cmt>
651
  .IP
@@ -688,29 +659,118 @@ Use the testnet4 chain. Equivalent to \fB\-chain\fR=\fI\,testnet4\/\fR.
688
  .PP
689
  Node relay options:
690
  .HP
 
 
 
 
 
 
 
 
 
691
  \fB\-bytespersigop\fR
692
  .IP
693
  Equivalent bytes per sigop in transactions for relay and mining
694
  (default: 20)
695
  .HP
 
 
 
 
696
  \fB\-datacarrier\fR
697
  .IP
698
  Relay and mine data carrier transactions (default: 1)
699
  .HP
 
 
 
 
 
700
  \fB\-datacarriersize\fR
701
  .IP
702
  Relay and mine transactions whose data\-carrying raw scriptPubKeys in
703
  aggregate are of this size or less, allowing multiple outputs
704
- (default: 100000)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
705
  .HP
706
  \fB\-minrelaytxfee=\fR<amt>
707
  .IP
708
  Fees (in BTC/kvB) smaller than this are considered zero fee for
709
- relaying, mining and transaction creation (default: 0.000001)
 
 
 
 
 
 
 
 
710
  .HP
711
  \fB\-permitbaremultisig\fR
712
  .IP
713
- Relay transactions creating non\-P2SH multisig outputs (default: 1)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
714
  .HP
715
  \fB\-whitelistforcerelay\fR
716
  .IP
@@ -726,10 +786,23 @@ transactions (default: 1)
726
  .PP
727
  Block creation options:
728
  .HP
 
 
 
 
 
 
 
 
729
  \fB\-blockmintxfee=\fR<amt>
730
  .IP
731
  Set lowest fee rate (in BTC/kvB) for transactions to be included in
732
- block creation. (default: 0.00000001)
 
 
 
 
 
733
  .HP
734
  \fB\-blockreservedweight=\fR<n>
735
  .IP
@@ -817,11 +890,14 @@ subject to empty whitelists.
817
  .IP
818
  Accept command line and JSON\-RPC commands
819
  .SH COPYRIGHT
 
820
  Copyright (C) 2009-2026 The Bitcoin Core developers
821
 
822
- Please contribute if you find Bitcoin Core useful. Visit
823
- <https://bitcoincore.org/> for further information about the software.
824
- The source code is available from <https://github.com/bitcoin/bitcoin>.
 
 
825
 
826
  This is experimental software.
827
  Distributed under the MIT software license, see the accompanying file COPYING
 
1
  .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2
+ .TH BITCOIND "1" "October 2026" "bitcoind v30.3-roots.1" "User Commands"
3
  .SH NAME
4
+ bitcoind \- manual page for bitcoind v30.3-roots.1
5
  .SH SYNOPSIS
6
  .B bitcoind
7
  [\fI\,options\/\fR]
8
  .SH DESCRIPTION
9
+ Bitcoin Roots daemon version v30.3\-roots.1 bitcoind
10
  .PP
11
+ The Bitcoin Roots daemon (bitcoind) is a headless program that connects to the Bitcoin network to validate and relay transactions and blocks, as well as relaying addresses.
12
  .PP
13
  It provides the backbone of the Bitcoin network and its RPC, REST and ZMQ services can provide various transaction, block and address\-related services.
14
  .PP
 
54
  \fB\-blockreconstructionextratxn=\fR<n>
55
  .IP
56
  Extra transactions to keep in memory for compact block reconstructions
57
+ (default: 32768)
58
+ .HP
59
+ \fB\-blockreconstructionextratxnsize=\fR<n>
60
+ .IP
61
+ Upper limit of memory usage (in megabytes) for keeping extra
62
+ transactions in memory for compact block reconstructions
63
+ (default: 10)
64
  .HP
65
  \fB\-blocksdir=\fR<dir>
66
  .IP
 
90
  prefixed by datadir location (only useable from command line, not
91
  configuration file) (default: bitcoin.conf)
92
  .HP
93
+ \fB\-confrw=\fR<file>
94
+ .IP
95
+ Specify read/write configuration file. Relative paths will be prefixed
96
+ by the network\-specific datadir location (default:
97
+ bitcoin_rw.conf)
98
+ .HP
99
  \fB\-daemon\fR
100
  .IP
101
  Run in the background as a daemon and accept commands (default: 0)
 
363
  .HP
364
  \fB\-peerbloomfilters\fR
365
  .IP
366
+ Support filtering of blocks and transactions with bloom filters
367
+ (default: localhost only)
368
  .HP
369
  \fB\-port=\fR<port>
370
  .IP
 
417
  Bind to the given address and add permission flags to the peers
418
  connecting to it. Use [host]:port notation for IPv6. Allowed
419
  permissions: bloomfilter (allow requesting BIP37 filtered blocks
420
+ and transactions), blockfilters (serve compact block filters to
421
+ peers per BIP157), noban (do not ban for misbehavior; implies
422
  download), forcerelay (relay transactions that are already in the
423
  mempool; implies relay), relay (relay even in \fB\-blocksonly\fR mode,
424
  and unlimited transaction announcements), mempool (allow
425
  requesting BIP35 mempool contents), download (allow getheaders
426
  during IBD, no disconnect after maxuploadtarget limit), addr
427
  (responses to GETADDR avoid hitting the cache and contain random
428
+ records with the most up\-to\-date info), forceinbound (when
429
+ connections are full, attempt to evict a random unprotected
430
+ inbound peer to open a slot; implies noban). Specify multiple
431
  permissions separated by commas (default:
432
  download,noban,mempool,relay). Can be specified multiple times.
433
  .HP
 
556
  .IP
557
  Send transactions with full\-RBF opt\-in enabled (RPC only, default: 1)
558
  .PP
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
559
  Debugging/Testing options:
560
  .HP
561
  \fB\-debug=\fR<category>
 
616
  .HP
617
  \fB\-shrinkdebugfile\fR
618
  .IP
619
+ Shrink debug log file on client startup (default: 1 when no \fB\-debug\fR)
620
  .HP
621
  \fB\-uacomment=\fR<cmt>
622
  .IP
 
659
  .PP
660
  Node relay options:
661
  .HP
662
+ \fB\-acceptnonstddatacarrier\fR
663
+ .IP
664
+ Relay nonstandard data carrier outputs (default: 0)
665
+ .HP
666
+ \fB\-acceptunknownwitness\fR
667
+ .IP
668
+ Relay transactions sending to unknown or future witness script versions
669
+ (default: 1)
670
+ .HP
671
  \fB\-bytespersigop\fR
672
  .IP
673
  Equivalent bytes per sigop in transactions for relay and mining
674
  (default: 20)
675
  .HP
676
+ \fB\-bytespersigopstrict\fR
677
+ .IP
678
+ Minimum bytes per sigop in transactions we relay and mine (default: 20)
679
+ .HP
680
  \fB\-datacarrier\fR
681
  .IP
682
  Relay and mine data carrier transactions (default: 1)
683
  .HP
684
+ \fB\-datacarriercost=\fR<n>
685
+ .IP
686
+ Treat data carrier bytes as at least N vbytes each (nonnegative;
687
+ default: 1)
688
+ .HP
689
  \fB\-datacarriersize\fR
690
  .IP
691
  Relay and mine transactions whose data\-carrying raw scriptPubKeys in
692
  aggregate are of this size or less, allowing multiple outputs
693
+ (default: 83)
694
+ .HP
695
+ \fB\-dustdynamic\fR=\fI\,off\/\fR|[<multiplier>*]target:<blocks>|[<multiplier>*]mempool:<kvB>
696
+ .IP
697
+ Automatically raise dustrelayfee based on either the expected fee to be
698
+ mined within <blocks> blocks, or to be within the best <kvB> kvB
699
+ of this node's mempool. If unspecified, multiplier is 3.
700
+ (default: off)
701
+ .HP
702
+ \fB\-maxscriptsize=\fR<n>
703
+ .IP
704
+ Maximum size of scripts (including the witness stack) we relay and mine
705
+ (default: 1650)
706
+ .HP
707
+ \fB\-maxtxlegacysigops\fR
708
+ .IP
709
+ Maximum legacy sigops in transactions we relay and mine (default: 2500)
710
+ .HP
711
+ \fB\-mempoolfullrbf\fR
712
+ .IP
713
+ Accept transaction replace\-by\-fee without requiring replaceability
714
+ signaling (default: 1)
715
+ .HP
716
+ \fB\-mempoolreplacement\fR
717
+ .IP
718
+ Set RBF policy: 0 disables, fee,optin honors signaling, and fee,\-optin
719
+ enables full RBF (default: fee,\-optin)
720
+ .HP
721
+ \fB\-mempooltruc\fR
722
+ .IP
723
+ Set TRUC policy: reject, accept, or enforce (default: enforce)
724
+ .HP
725
+ \fB\-minrelaycoinblocks=\fR<n>
726
+ .IP
727
+ Minimum coin blocks a transaction must spend to be relayed (default: 0)
728
+ .HP
729
+ \fB\-minrelaymaturity=\fR<n>
730
+ .IP
731
+ Minimum input maturity before relay (default: 0)
732
  .HP
733
  \fB\-minrelaytxfee=\fR<amt>
734
  .IP
735
  Fees (in BTC/kvB) smaller than this are considered zero fee for
736
+ relaying, mining and transaction creation (default: 0.00001)
737
+ .HP
738
+ \fB\-permitbareanchor\fR
739
+ .IP
740
+ Relay transactions that only have ephemeral anchor outputs (default: 1)
741
+ .HP
742
+ \fB\-permitbaredatacarrier\fR
743
+ .IP
744
+ Relay data carrier outputs without OP_RETURN (default: 0)
745
  .HP
746
  \fB\-permitbaremultisig\fR
747
  .IP
748
+ Relay transactions creating non\-P2SH multisig outputs (default: 0)
749
+ .HP
750
+ \fB\-permitbarepubkey\fR
751
+ .IP
752
+ Relay legacy pubkey outputs (default: 0)
753
+ .HP
754
+ \fB\-permitephemeral\fR
755
+ .IP
756
+ Permit ephemeral policy exceptions: send, dust, and anchor
757
+ .HP
758
+ \fB\-rejectparasites\fR
759
+ .IP
760
+ Refuse to relay or mine parasitic overlay protocols (default: 1)
761
+ .HP
762
+ \fB\-rejecttokens\fR
763
+ .IP
764
+ Refuse to relay or mine transactions involving non\-bitcoin tokens
765
+ (default: 0)
766
+ .HP
767
+ \fB\-spkreuse=\fR<policy>
768
+ .IP
769
+ Set script reuse policy: allow or conflict (default: allow)
770
+ .HP
771
+ \fB\-subdustfeepenalty\fR
772
+ .IP
773
+ Apply the sub\-dust fee penalty to relay policy (default: 1)
774
  .HP
775
  \fB\-whitelistforcerelay\fR
776
  .IP
 
786
  .PP
787
  Block creation options:
788
  .HP
789
+ \fB\-blockmaxsize=\fR<n>
790
+ .IP
791
+ Set maximum block size in bytes (default: 300000)
792
+ .HP
793
+ \fB\-blockmaxweight=\fR<n>
794
+ .IP
795
+ Set maximum BIP141 block weight (default: 1200000)
796
+ .HP
797
  \fB\-blockmintxfee=\fR<amt>
798
  .IP
799
  Set lowest fee rate (in BTC/kvB) for transactions to be included in
800
+ block creation. (default: 0.00001)
801
+ .HP
802
+ \fB\-blockprioritysize=\fR<n>
803
+ .IP
804
+ Set maximum size of high\-priority/low\-fee transactions in bytes
805
+ (default: 100000)
806
  .HP
807
  \fB\-blockreservedweight=\fR<n>
808
  .IP
 
890
  .IP
891
  Accept command line and JSON\-RPC commands
892
  .SH COPYRIGHT
893
+ Copyright (C) 2009-2026 The Bitcoin Roots developers
894
  Copyright (C) 2009-2026 The Bitcoin Core developers
895
 
896
+ Please contribute if you find Bitcoin Roots useful. Visit
897
+ <https://plan-b.foundation/bitcoin-roots/> for further information about the
898
+ software.
899
+ The source code is available from
900
+ <https://github.com/luganoplanb/bitcoin-roots>.
901
 
902
  This is experimental software.
903
  Distributed under the MIT software license, see the accompanying file COPYING