summaryrefslogtreecommitdiff
path: root/json-rpc-shell.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'json-rpc-shell.adoc')
-rw-r--r--json-rpc-shell.adoc44
1 files changed, 19 insertions, 25 deletions
diff --git a/json-rpc-shell.adoc b/json-rpc-shell.adoc
index 20b1f8c..c7dab10 100644
--- a/json-rpc-shell.adoc
+++ b/json-rpc-shell.adoc
@@ -1,8 +1,8 @@
json-rpc-shell(1)
=================
:doctype: manpage
-:man manual: json-rpc-shell Manual
-:man source: json-rpc-shell {release-version}
+:manmanual: json-rpc-shell Manual
+:mansource: json-rpc-shell {release-version}
Name
----
@@ -15,7 +15,7 @@ Synopsis
Description
-----------
The _ENDPOINT_ must be either an HTTP or a WebSocket URL, with or without TLS
-(i.e. one of the _http://_, _https://_, _ws://_, _wss://_ schemas).
+(i.e. one of the _+++http+++://_, _+++https+++://_, _ws://_, _wss://_ schemas).
*json-rpc-shell* will use it to send any JSON-RPC 2.0 requests you enter on its
command line. The server's response will be parsed and validated, stripping it
@@ -133,40 +133,34 @@ distribution of this program (public services are hard to find):
Pretty-printing and Manual IDs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-```
-$ json-rpc-shell -p ws://localhost:1234
-json-rpc> date 1
-{
- "year": 2020,
- "month": 9,
- "day": 5,
- "hours": 2,
- "minutes": 23,
- "seconds": 51
-}
-```
+ $ json-rpc-shell -p ws://localhost:1234
+ json-rpc> date 1
+ {
+ "year": 2020,
+ "month": 9,
+ "day": 5,
+ "hours": 2,
+ "minutes": 23,
+ "seconds": 51
+ }
Notification With a Parameter
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Notifications never produce a response, not even when the method is not known
to the server:
-```
-$ json-rpc-shell ws://localhost:1234
-json-rpc> notify {"events": ["conquest", "war", "famine", "death"]}
-[Notification]
-```
+ $ json-rpc-shell ws://localhost:1234
+ json-rpc> notify {"events": ["conquest", "war", "famine", "death"]}
+ [Notification]
Piping In and Out
~~~~~~~~~~~~~~~~~
GNU Readline always repeats the prompt, which makes this a bit less useful
for invoking from other programs:
-```
-$ echo 'ping | jq ascii_upcase' | json-rpc-shell -a ws://localhost:1234
-json-rpc> ping | jq ascii_upcase
-"PONG"
-```
+ $ echo 'ping | jq ascii_upcase' | json-rpc-shell -a ws://localhost:1234
+ json-rpc> ping | jq ascii_upcase
+ "PONG"
Reporting Bugs
--------------