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. The two line-number columns refer to before and after.

doc/man/bitcoind.1 CHANGED
@@ -1,14 +1,14 @@
1
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"
2
+ .TH BITCOIND "1" "October 2026" "bitcoind v30.3-roots.1" "User Commands"
3
3
  .SH NAME
4
- bitcoind \- manual page for bitcoind v30.3.0
4
+ bitcoind \- manual page for bitcoind v30.3-roots.1
5
5
  .SH SYNOPSIS
6
6
  .B bitcoind
7
7
  [\fI\,options\/\fR]
8
8
  .SH DESCRIPTION
9
- Bitcoin Core daemon version v30.3.0 bitcoind
9
+ Bitcoin Roots daemon version v30.3\-roots.1 bitcoind
10
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.
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
12
  .PP
13
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
14
  .PP
@@ -54,7 +54,13 @@ block hash)
54
54
  \fB\-blockreconstructionextratxn=\fR<n>
55
55
  .IP
56
56
  Extra transactions to keep in memory for compact block reconstructions
57
- (default: 100)
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)
58
64
  .HP
59
65
  \fB\-blocksdir=\fR<dir>
60
66
  .IP
@@ -84,6 +90,12 @@ Specify path to read\-only configuration file. Relative paths will be
84
90
  prefixed by datadir location (only useable from command line, not
85
91
  configuration file) (default: bitcoin.conf)
86
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
87
99
  \fB\-daemon\fR
88
100
  .IP
89
101
  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
363
  .HP
352
364
  \fB\-peerbloomfilters\fR
353
365
  .IP
354
- Support filtering of blocks and transaction with bloom filters (default:
355
- 0)
366
+ Support filtering of blocks and transactions with bloom filters
367
+ (default: localhost only)
356
368
  .HP
357
369
  \fB\-port=\fR<port>
358
370
  .IP
@@ -405,14 +417,17 @@ Support v2 transport (default: 1)
405
417
  Bind to the given address and add permission flags to the peers
406
418
  connecting to it. Use [host]:port notation for IPv6. Allowed
407
419
  permissions: bloomfilter (allow requesting BIP37 filtered blocks
408
- and transactions), noban (do not ban for misbehavior; implies
420
+ and transactions), blockfilters (serve compact block filters to
421
+ peers per BIP157), noban (do not ban for misbehavior; implies
409
422
  download), forcerelay (relay transactions that are already in the
410
423
  mempool; implies relay), relay (relay even in \fB\-blocksonly\fR mode,
411
424
  and unlimited transaction announcements), mempool (allow
412
425
  requesting BIP35 mempool contents), download (allow getheaders
413
426
  during IBD, no disconnect after maxuploadtarget limit), addr
414
427
  (responses to GETADDR avoid hitting the cache and contain random
415
- records with the most up\-to\-date info). Specify multiple
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
416
431
  permissions separated by commas (default:
417
432
  download,noban,mempool,relay). Can be specified multiple times.
418
433
  .HP
@@ -541,50 +556,6 @@ to invoke the command.
541
556
  .IP
542
557
  Send transactions with full\-RBF opt\-in enabled (RPC only, default: 1)
543
558
  .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
559
  Debugging/Testing options:
589
560
  .HP
590
561
  \fB\-debug=\fR<category>
@@ -645,7 +616,7 @@ logging to file, set \fB\-nodebuglogfile\fR)
645
616
  .HP
646
617
  \fB\-shrinkdebugfile\fR
647
618
  .IP
648
- Shrink debug.log file on client startup (default: 1 when no \fB\-debug\fR)
619
+ Shrink debug log file on client startup (default: 1 when no \fB\-debug\fR)
649
620
  .HP
650
621
  \fB\-uacomment=\fR<cmt>
651
622
  .IP
@@ -688,29 +659,118 @@ Use the testnet4 chain. Equivalent to \fB\-chain\fR=\fI\,testnet4\/\fR.
688
659
  .PP
689
660
  Node relay options:
690
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
691
671
  \fB\-bytespersigop\fR
692
672
  .IP
693
673
  Equivalent bytes per sigop in transactions for relay and mining
694
674
  (default: 20)
695
675
  .HP
676
+ \fB\-bytespersigopstrict\fR
677
+ .IP
678
+ Minimum bytes per sigop in transactions we relay and mine (default: 20)
679
+ .HP
696
680
  \fB\-datacarrier\fR
697
681
  .IP
698
682
  Relay and mine data carrier transactions (default: 1)
699
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
700
689
  \fB\-datacarriersize\fR
701
690
  .IP
702
691
  Relay and mine transactions whose data\-carrying raw scriptPubKeys in
703
692
  aggregate are of this size or less, allowing multiple outputs
704
- (default: 100000)
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)
705
732
  .HP
706
733
  \fB\-minrelaytxfee=\fR<amt>
707
734
  .IP
708
735
  Fees (in BTC/kvB) smaller than this are considered zero fee for
709
- relaying, mining and transaction creation (default: 0.000001)
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)
710
745
  .HP
711
746
  \fB\-permitbaremultisig\fR
712
747
  .IP
713
- Relay transactions creating non\-P2SH multisig outputs (default: 1)
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)
714
774
  .HP
715
775
  \fB\-whitelistforcerelay\fR
716
776
  .IP
@@ -726,10 +786,23 @@ transactions (default: 1)
726
786
  .PP
727
787
  Block creation options:
728
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
729
797
  \fB\-blockmintxfee=\fR<amt>
730
798
  .IP
731
799
  Set lowest fee rate (in BTC/kvB) for transactions to be included in
732
- block creation. (default: 0.00000001)
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)
733
806
  .HP
734
807
  \fB\-blockreservedweight=\fR<n>
735
808
  .IP
@@ -817,11 +890,14 @@ subject to empty whitelists.
817
890
  .IP
818
891
  Accept command line and JSON\-RPC commands
819
892
  .SH COPYRIGHT
893
+ Copyright (C) 2009-2026 The Bitcoin Roots developers
820
894
  Copyright (C) 2009-2026 The Bitcoin Core developers
821
895
 
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>.
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>.
825
901
 
826
902
  This is experimental software.
827
903
  Distributed under the MIT software license, see the accompanying file COPYING