aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHarald Welte <laforge@osmocom.org>2021-04-08 20:34:13 +0200
committerHarald Welte <laforge@osmocom.org>2021-04-10 18:41:15 +0200
commit4145d3c4af42d1d37cc145acbb65178e59c325a0 (patch)
tree5a5816f1ff8a1f0fbe247dc9d04b37666f67ac27 /docs
parentfe8a74490a9ce509039f85c43f99c4b8adce28ca (diff)
shell: add edit_{record,binary}_decoded shell commands
This allows the user to edit the file/record contents in its JSON representation inside the standard system text editor. Change-Id: Icf6a6e8529e7664c5645519fb4bdd55b35f34664
Diffstat (limited to 'docs')
-rw-r--r--docs/shell.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/shell.rst b/docs/shell.rst
index 652e572..06e7f42 100644
--- a/docs/shell.rst
+++ b/docs/shell.rst
@@ -206,6 +206,24 @@ update_record_decoded
:func: LinFixedEF.ShellCommands.upd_rec_dec_parser
+edit_record_decoded
+~~~~~~~~~~~~~~~~~~~
+.. argparse::
+ :module: pySim.filesystem
+ :func: LinFixedEF.ShellCommands.edit_rec_dec_parser
+
+This command will read the selected record, decode it to its JSON representation, save
+that JSON to a temporary file on your computer, and launch your configured text editor.
+
+You may then perform whatever modifications to the JSON representation, save + leave your
+text editor.
+
+Afterwards, the modified JSON will be re-encoded to the binary format, and the result written
+back to the record on the SIM card.
+
+This allows for easy interactive modification of records.
+
+
Transparent EF commands
-----------------------
@@ -268,6 +286,19 @@ Th below example demonstrates this by modifying the ofm field within EF.AD:
}
+edit_binary_decoded
+~~~~~~~~~~~~~~~~~~~
+This command will read the selected binary EF, decode it to its JSON representation, save
+that JSON to a temporary file on your computer, and launch your configured text editor.
+
+You may then perform whatever modifications to the JSON representation, save + leave your
+text editor.
+
+Afterwards, the modified JSON will be re-encoded to the binary format, and the result written
+to the SIM card.
+
+This allows for easy interactive modification of file contents.
+
cmd2 settable parameters
------------------------