TU58FS - The command line

Parent Category: Tools Category: TU58FS - file sharing with a DECtape II emulator Written by Administrator

tu58fs has a rich commandline interface. When called with out any options, it dumps out it's manual.

Be aware: tu58fs is beta at the moment!

tu58fs - DEC TU58 tape emulator with file sharing v1.0.0
(compile Feb 7 2017 16:23:09)
(C) 2017 Joerg Hoppe <This email address is being protected from spambots. You need JavaScript enabled to view it.,
(C) 2005-2017 Don North <This email address is being protected from spambots. You need JavaScript enabled to view it.,
(C) 1984 Dan Ts'o <Rockefeller University>

See also www.retrocmp.com/tools/tu58fs

Command line summary:

tu58fs  --help --version --debug --verbose --mrsp --nosync --vax --background
          --timing --baudrate --stopbits
          --port --xxdp --rt11 --size
          --device
          --shareddevice
          --synctimeout --unpack
          --pack

-?   | --help
          Print help.
-V   | --version
          Output version string.
-dbg | --debug
          Enable debug output to console.
-v   | --verbose
          Enable verbose output to terminal.
-m   | --mrsp
          Disable sending INIT at initial startup.
-n   | --nosync
          enable standard MRSP mode (byte-level handshake).
-x   | --vax
          Remove delays for aggressive timeouts of VAX console.
-bk  | --background
          Run in background mode, no console I/O except errors.
-t   | --timing
          timing 1: add timing delays to spoof diagnostic into passing.
          timing 2: add timing delays to mimic a real TU58.
-b   | --baudrate
          Set serial line speed to 1200..3000000 baud. Default: "38400"
-sb  | --stopbits
          Set 1 or 2 stop bits. Default: "1"
-p   | --port
          Select serial port: "COM:" or is a node like "/dev/ttyS1"
           Default: "1"
-xx  | --xxdp
          Select XXDP file system for following --device or --shareddevice options.
          New image files are create with an empty XXDP file system.
-rt  | --rt11
          Same as --xxdp, but RT11 file system is selected.
-s   | --size
          Override size of TU58 imagefile.
          is number of bytes; suffix "K": * 1024, suffix "M": * K * K.
          Smaller images are enlarged, greater are trunc'd if possible.
          Devices and file system try to adapt.
          For TU58 patched DD.SYS drivers are needed then for
          DEC operating systems.
          Simple example:  -s 10M
              image is 10 Megabytes = RL02 sized.
-d   | --device
          Open image file for a TU58 drive
          : File is mounted in this drive (0..7).
          : "r" = device is read-only, "w" = writable,
          "c" = writable and file is created if not existant.
          Also the --xxdp, --rt11 and --size options are evaluated.
          A missing file is created and initialized with 0s or empty XXDP or RT11 filesystem.
          Simple example:  -d 0 r 11XXDP.DSK
              mount image file XXDP.DSK into slot #0.
-sd  | --shareddevice
          same as --device, but image is filled with files from a host directory.
          -xxdp or -rt11 must be specified. must be writable and
must not contain subdirs, it is created only with "c" option.
          Simple example:  -sd 1 w /home/user/tu58/data.dir
              fill image with files in a directory.
-st  | --synctimeout
          An image changed by PDP is written to disk after this idle period.
           Default: "3"
-up  | --unpack
          Read a binary disk/tape image, and extract files into directory
          Read files from a directory and pack into binary disk/tape image
          can specify a different device geometry for the image,
allowed: TU58,RP0456,RK035,RL01,RL02,RK067,RM03,RS034,TU56,RX01,RX02
pk  | --pack
          Read a binary disk/tape image, and extract files into directory
          Read files from a directory and pack into binary disk/tape image
          can specify a different device geometry for the image,
allowed: TU58,RP0456,RK035,RL01,RL02,RK067,RM03,RS034,TU56,RX01,RX02

Option names are case sensitive.

Some examples:

sudo ./tu58fs -p /dev/ttyS1 -b 38400 -d 0 r 11XXDP.DSK

    Define device #0:
    Access to serial line requires "sudo". Image is readonly.
    If it not exist, an error is signaled.

tu58fs <serial params> -d 0 c 11XXDP.DSK

    Same. If "11XXDP.DSK" does not exists, an unformatted 0-filled image file is created.

tu58fs <serial params> -rt11 -sd 1 w tinyrt11

    Shared device image for device #1, "tinyrt11" is a directory:
    Image is constructed from file content, to a max size of 256kb, else error.
    Can be accessed with "DD1:"

tu58fs <serial params> --size 10M -rt11 -d 1 w bigrt11
    Same, but device image is automatically enlarged to 10MBytes, max 32MB.
    A modified DD.SYS driver must be used on the RT11 system.

tu58fs <serial params> -xxdp -d 0 r 11XXDP.DSK -d 1 w data.dsk -sd 7 w shared.dir
    Define device #0:
    Standard 256kb image, loaded from file "11XXDP.DSK", not created.
    Device #1:
    If "data.dsk" does not exist, a file is create and formatted as empty XXDP
    If "data.dsk" exists, it is opened for read/write
    Device #7:
    contains the files in a sub directory "shared.dir" on the host.
    Can be accessed with "DD0:", "DD1:", "DD7:"

tu58fs -xxdp --unpack 11XXDP.DSK 11xxdp.dir TU58
    Extracts all files from an TU58 image into a directory.
    If image is bootable, pseudofiles for bootloader and monitor are generated.
    The directory is then bootable too.

tu58fs <serial params> -xxdp -sd 0 w 11xxdp.dir
    Define device #0:
    Standard 256kb image, loaded from file "11xxdp.dir", not created.
    Dir is bootable, if it contains the pseudo files for monitor and boot block.
    A bootable dir is can be created by unpacking a bootable image file.

tu58fs <serial params> -rt11 -unpack RT11V53.DSK rt11v53.imgdir TU58 -sd 0 w rt11v53.imgdir
    Combination of exmaples before:
    Extract content of image into shared directory, then run TU58 emulator on that directory.
    Dir is bootable, if the image is bootable.