Skip to content

Commit 271fd20

Browse files
luke-jrluke-jr
committed
Update manpages, bash completion, and example bitcoin.conf
1 parent 59dd80e commit 271fd20

File tree

8 files changed

+813
-170
lines changed

8 files changed

+813
-170
lines changed

‎contrib/completions/bash/bitcoin-cli.bash‎

Lines changed: 25 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
1-
# bash programmable completion for bitcoin-cli(1)
2-
# Copyright (c) 2012-2022 The Bitcoin Core developers
1+
# Dynamic bash programmable completion for bitcoin-cli(1)
2+
# DO NOT EDIT THIS FILE BY HAND -- THIS WILL FAIL THE FUNCTIONAL TEST tool_cli_completion
3+
# This file is auto-generated by the functional test tool_cli_completion.
4+
# If you want to modify this file, modify test/functional/tool_cli_completion.py and re-autogenerate
5+
# this file via the --overwrite test flag.
6+
7+
# Copyright (c) 2012-2024 The Bitcoin Core developers
38
# Distributed under the MIT software license, see the accompanying
49
# file COPYING or http://www.opensource.org/licenses/mit-license.php.
510

@@ -30,65 +35,63 @@ _bitcoin_cli() {
3035

3136
if ((cword > 5)); then
3237
case ${words[cword-5]} in
33-
sendtoaddress)
34-
COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
38+
descriptorprocesspsbt)
39+
COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
3540
return 0
3641
;;
3742
esac
3843
fi
3944

4045
if ((cword > 4)); then
4146
case ${words[cword-4]} in
42-
importaddress|listtransactions|setban)
43-
COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
47+
createpsbt|createrawtransaction|descriptorprocesspsbt|setban)
48+
COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
4449
return 0
4550
;;
46-
signrawtransactionwithkey|signrawtransactionwithwallet)
47-
COMPREPLY=( $( compgen -W "ALL NONE SINGLE ALL|ANYONECANPAY NONE|ANYONECANPAY SINGLE|ANYONECANPAY" -- "$cur" ) )
51+
signrawtransactionwithkey)
52+
COMPREPLY=( $( compgen -W "ALL ALL|ANYONECANPAY NONE NONE|ANYONECANPAY SINGLE SINGLE|ANYONECANPAY" -- "$cur" ) )
4853
return 0
4954
;;
5055
esac
5156
fi
5257

5358
if ((cword > 3)); then
5459
case ${words[cword-3]} in
55-
addmultisigaddress)
56-
return 0
57-
;;
58-
getbalance|gettxout|importaddress|importpubkey|importprivkey|listreceivedbyaddress|listsinceblock)
59-
COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
60+
addnode|converttopsbt|getdescriptoractivity|gettxout|gettxoutsetinfo)
61+
COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
6062
return 0
6163
;;
6264
esac
6365
fi
6466

6567
if ((cword > 2)); then
6668
case ${words[cword-2]} in
69+
converttopsbt|decoderawtransaction|finalizepsbt|getblockheader|getmempoolancestors|getmempooldescendants|getrawmempool|listmempooltransactions)
70+
COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
71+
return 0
72+
;;
6773
addnode)
68-
COMPREPLY=( $( compgen -W "add remove onetry" -- "$cur" ) )
74+
COMPREPLY=( $( compgen -W "add onetry remove" -- "$cur" ) )
6975
return 0
7076
;;
7177
setban)
7278
COMPREPLY=( $( compgen -W "add remove" -- "$cur" ) )
7379
return 0
7480
;;
75-
fundrawtransaction|getblock|getblockheader|getmempoolancestors|getmempooldescendants|getrawtransaction|gettransaction|listreceivedbyaddress|sendrawtransaction)
76-
COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
81+
estimatesmartfee)
82+
COMPREPLY=( $( compgen -W "CONSERVATIVE ECONOMICAL UNSET" -- "$cur" ) )
7783
return 0
7884
;;
7985
esac
8086
fi
8187

8288
case "$prev" in
83-
backupwallet|dumpwallet|importwallet)
89+
dumptxoutset|importmempool|loadtxoutset)
8490
_filedir
8591
return 0
8692
;;
87-
getaddednodeinfo|getrawmempool|lockunspent)
88-
COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
89-
return 0
90-
;;
91-
getbalance|getnewaddress|listtransactions|sendmany)
93+
getrawmempool|setnetworkactive|setscriptthreadsenabled)
94+
COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
9295
return 0
9396
;;
9497
esac

‎doc/man/bitcoin-cli.1‎

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2-
.TH BITCOIN-CLI "1" "September 2025" "bitcoin-cli v29.1.0" "User Commands"
2+
.TH BITCOIN-CLI "1" "September 2025" "bitcoin-cli v29.1.0.knots20250903" "User Commands"
33
.SH NAME
4-
bitcoin-cli \- manual page for bitcoin-cli v29.1.0
4+
bitcoin-cli \- manual page for bitcoin-cli v29.1.0.knots20250903
55
.SH SYNOPSIS
66
.B bitcoin-cli
77
[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]
@@ -15,11 +15,11 @@ bitcoin-cli \- manual page for bitcoin-cli v29.1.0
1515
.B bitcoin-cli
1616
[\fI\,options\/\fR] \fI\,help <command>\/\fR
1717
.SH DESCRIPTION
18-
Bitcoin Core RPC client version v29.1.0
18+
Bitcoin Knots RPC client version v29.1.0.knots20250903
1919
.PP
20-
The bitcoin\-cli utility provides a command line interface to interact with a Bitcoin Core RPC server.
20+
The bitcoin\-cli utility provides a command line interface to interact with a Bitcoin Knots RPC server.
2121
.PP
22-
It can be used to query network information, manage wallets, create or broadcast transactions, and control the Bitcoin Core server.
22+
It can be used to query network information, manage wallets, create or broadcast transactions, and control the Bitcoin Knots server.
2323
.PP
2424
Use the "help" command to list all commands. Use "help <command>" to show help for that command.
2525
The \fB\-named\fR option allows you to specify parameters using the key=value format, eliminating the need to pass unused positional parameters.
@@ -37,6 +37,12 @@ and OS is not WIN32), never. Only applies to the output of
3737
Specify configuration file. Relative paths will be prefixed by datadir
3838
location. (default: bitcoin.conf)
3939
.HP
40+
\fB\-confrw=\fR<file>
41+
.IP
42+
Specify read/write configuration file. Relative paths will be prefixed
43+
by the network\-specific datadir location. (default:
44+
bitcoin_rw.conf)
45+
.HP
4046
\fB\-datadir=\fR<dir>
4147
.IP
4248
Specify data directory
@@ -131,6 +137,12 @@ testnet4, signet, regtest
131137
Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network
132138
is defined by the \fB\-signetchallenge\fR parameter
133139
.HP
140+
\fB\-signetblocktime\fR
141+
.IP
142+
Difficulty adjustment will target a block time of the given amount in
143+
seconds (only for custom signet networks, must have
144+
\fB\-signetchallenge\fR set; defaults to 10 minutes)
145+
.HP
134146
\fB\-signetchallenge\fR
135147
.IP
136148
Blocks must satisfy the given script to be considered valid (only for
@@ -173,11 +185,12 @@ nblocks and maxtries arguments. Example: bitcoin\-cli \fB\-generate\fR 4
173185
.HP
174186
\fB\-getinfo\fR
175187
.IP
176-
Get general information from the remote server. Note that unlike
177-
server\-side RPC calls, the output of \fB\-getinfo\fR is the result of
178-
multiple non\-atomic requests. Some entries in the output may
179-
represent results from different states (e.g. wallet balance may
180-
be as of a different block from the chain state reported)
188+
Get general information from the remote server, including the total
189+
balance and the balances of each loaded wallet when in
190+
multiwallet mode. Note that \fB\-getinfo\fR is the combined result of
191+
several RPCs (getnetworkinfo, getblockchaininfo, getwalletinfo,
192+
getbalances, and in multiwallet mode, listwallets), each with
193+
potentially different state.
181194
.HP
182195
\fB\-netinfo\fR
183196
.IP
@@ -188,14 +201,15 @@ additional "outonly" (or "o") argument can be passed to see
188201
outbound peers only. Pass "help" (or "h") for detailed help
189202
documentation.
190203
.SH COPYRIGHT
204+
Copyright (C) 2009-2025 The Bitcoin Knots developers
191205
Copyright (C) 2009-2025 The Bitcoin Core developers
192206

193-
Please contribute if you find Bitcoin Core useful. Visit
194-
<https://bitcoincore.org/> for further information about the software.
195-
The source code is available from <https://github.com/bitcoin/bitcoin>.
207+
Please contribute if you find Bitcoin Knots useful. Visit
208+
<https://bitcoinknots.org/> for further information about the software.
209+
The source code is available from <https://github.com/bitcoinknots/bitcoin>.
196210

197211
This is experimental software.
198212
Distributed under the MIT software license, see the accompanying file COPYING
199213
or <https://opensource.org/licenses/MIT>
200214
.SH "SEE ALSO"
201-
bitcoind(1), bitcoin-cli(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)
215+
bitcoind(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)

0 commit comments

Comments
 (0)