From 26306849563351c58554377fe1aeef595781ba80 Mon Sep 17 00:00:00 2001
From: Lars Brinkhoff <lars@nocrew.org>
Date: Fri, 26 Jan 2018 21:48:34 +0100
Subject: [PATCH] Moving files with DUMP and itstar.

---
 README.md          |  1 +
 doc/DUMP-itstar.md | 59 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+)
 create mode 100644 doc/DUMP-itstar.md

diff --git a/README.md b/README.md
index d193385c..18a8396a 100644
--- a/README.md
+++ b/README.md
@@ -86,6 +86,7 @@ There are some short introductions for beginners:
 - [TECO survival guide](doc/TECO.md)
 - [DDT debugging newbie guide](doc/debugging.md)
 - [Hello MIDAS](doc/hello-midas.md)
+- [DUMP and itstar](doc/DUMP-itstar.md)
 
 A list of [known ITS machines](doc/machines.md).
 
diff --git a/doc/DUMP-itstar.md b/doc/DUMP-itstar.md
new file mode 100644
index 00000000..5a913295
--- /dev/null
+++ b/doc/DUMP-itstar.md
@@ -0,0 +1,59 @@
+# DUMP and itstar
+
+### Saving ITS files and extract them using itstar
+
+- Mount a tape image in the emulator.  For KLH10, type Control-\\, and
+  then
+
+       devmount mta0 files.tape create
+       continue
+
+  For SIMH, type Control-E, and then
+
+       attach tu0 files.tape
+       continue
+
+- In ITS, type `:dump`.  At the _ prompt, type `dump`.  The `FILE=`
+  prompt will accept directory and file names.  `*` can be used as a
+  wild card.  Finish with an empty line.  When DUMP has finished
+  writing the files, type `quit` to exit.
+
+- Unmount the tape image.  For KLH10, type Control-Z, and
+
+       devunmount mta0
+       continue
+
+  For SIMH, type Control-E, and then
+
+       detach tu0
+       continue
+
+- In the host, run itstar to extract the files:
+
+       itstar -xf files.tape
+
+### Moving host files to ITS
+
+- Create one or more directories, and put the files in them.  There
+  can not be directories inside directories.  For example, let's say
+  you created the directores foo and bar.
+
+- Run itstar to make a tape image:
+
+       itstar -cf files.tape foo bar
+
+- Mount the tape image in the emulator.  For KLH10, type Control-\\ and
+
+       devmount mta0 files.tape
+       continue
+
+  For SIMH, type Control-E, and then
+
+       attach tu0 files.tape
+       continue
+
+- In ITS, type `:dump`.  At the _ prompt, type `load`.  The `FILE=`
+  prompt will accept file names as above.  Finish with an empty line.
+  When DUMP has finished reading the files, type `quit` to exit.
+
+- Unmount the tape image as above.