Announcing "xtoz"

Keith Williamson (keith@PrimeNet.Com)
Fri, 27 Jan 95 16:13 PST

Fellow Zoomies,

I have written a utility to allow you to do file management/transfer
from UNIX machines. The utility, xtoz (uniX TO Zoomer), is ftp like
in look and feel. It uses the File Transfer feature (pccom) of the
Zoomer since that protocol had a fairly decent description in the
GEOS-SDK.

I am going to be offering this source as freeware. I wrote xtoz
because I come across documentation on the Web when I'm at work that
I want to suck into my Zoomer to read at my leisure. Since I work
exclusively on UNIX machines, I had to note the URL and then get back
to it from my PC from where I could move it into my Zoomer.

I wrote xtoz for SVR4 but have ported and tested it with AIX, SunOS,
and DG/UX. I am contemplating ports to Solaris, HPUX, Linux and
others. I would like to determine if there is any interest in this
utility and if so, for what OS. This will guide me in my porting
effort (which I do in my own spare time).

I haven't decided when to release xtoz or exactly how. I thought I
might ask for permission to upload it to ftp.biostat.washington.edu.
I also haven't quite decided what format to upload it in. The basic
upload would consist of the source (xtoz.c), the makefile (xtoz.mk)
and a README. Since some Zoomies out there might be users on UNIX
hosts but not have the capability to do source builds, I may include
binaries for various platforms. In any case, the upload will have to
be an archive (tar or cpio perhaps?). I am open to any and all
suggestions re: the above.

Below I have trapped the screen output from xtoz so that you can get
a feel for the features/user interface. The # lines are annotations
that I have added to explain the commands. These lines are not printed
by the utility.

Best regards,

keith@primenet.com

=========================================================================
xtoz demo
=========================================================================

# List of all commands (and aliases). Optional params in square brackets.
xtoz> help
Commands:

about - display version info, etc.
ascii - set file transfer type to ascii
binary - set file transfer type to binary
cd [drive:][dir] - change remote drive/directory
close - restore and close tty to zoomer
cls - clear the zoomer screen
cp srcpath destpath - copy remote src to remote dest
del (or rm) rmtpath - delete file on the zoomer
dir (or ls) - list content of current remote dir
exit (or quit or q) - exit xtoz
get rmtpath [localpath] - get remote file to current local dir
help (or h or ?) - this screen
lcd [dir] - change local directory
mkdir (or md) dirname - create directory on the zoomer
mv srcpath destpath - move remote src to remote dest
open device,rate - open and init tty to zoomer
pld - print current local directory
put localpath [rmtpath] - put local file to current remote dir
pwd - print current remote directory
rmdir (or rd) dirname - delete directory on the zoomer
stop - stop pccom on zoomer (reboot)
type [binary|ascii] - set/inquire file transfer type

# The "about" command gives you the current version plus the usual
# disclaimers.
xtoz> about
X X TTTTT OO ZZZZZ
X X T O O Z
X T O O Z
X X T O O Z
X X T OO ZZZZZ

The uniX TO Zoomer File Management Utility

V1.0

Written by keith@primenet.com - Legion of Zoom Software ;^}

This source code is freeware. Feel free to copy it, change it,
translate it to a foreign language, whatever. If you have a bug
fix or an enhancement that you would like to see distributed in
the ``official'' source, please send it to keith@primenet.com.

This source code is provided ``as is'' and without any express
or implied warranties, including, without limitation, the implied
warranties of merchantibility and fitness for a particular purpose.
Use it at your own risk.

# Current directory on the zoomer.
xtoz> pwd
B:\GEOWORKS

# Change drive on zoomer.
xtoz> cd c:
C:\GEOWORKS\DOCUMENT

# You can also use "ls".
xtoz> dir

<DIR> 01-04-95 9:04p
. <DIR> 01-04-95 9:04p
@DIRNAME.000 256 01-04-95 9:04p
GEOPUB.TXT 20971 05-31-94 8:53a
TALK.TXT 14516 01-28-94 1:14a
WSARCHIE.TXT 3485 07-12-94 11:20p
WINVNFAQ.TXT 34428 01-05-95 9:16p
WVDOC_10.TXT 245207 01-05-95 9:13p
HANGEASY.DAT 46 10-23-94 9:09p
IZL.TXT 10351 07-18-94 12:26a
CALC.IZL 1531 07-18-94 12:38a
HANGMAN.IZL 2949 07-18-94 1:43a
HOT.IZL 720 06-23-94 12:22a
PRIMES.IZL 729 06-23-94 12:24a
TECHDOCS <DIR> 01-10-95 11:14p
HANGMAN3.IZL 6081 10-02-94 9:31a
MAGIC.IZL 3876 10-23-94 9:08p

# With no arguments, prints the current transfer type.
xtoz> type
Current transfer type is binary.

# Short form of "type ascii". With this transfer type I will do CR/NL ->
# NL mapping (and vice/versa as appropriate).
xtoz> ascii
File transfer type set to ascii.

# Get a file from the zoomer. You can optionally specify the filename you
# want used on the UNIX box. The dots are "warm fuzzies" that appear after
# each successfully received 1K block.
xtoz> get winvnfaq.txt
.................................
File transfer complete.

# Obvious
xtoz> cd ..
C:\GEOWORKS

# Make a directory on the zoomer. "md" also works.
xtoz> mkdir temp
Directory Made

#
xtoz> cd temp
C:\GEOWORKS\TEMP

# Print current working directory on the UNIX host.
xtoz> pld
/home/keith/c

# Switch to binary mode (clean byte for byte transfer).
# Short for "type binary".
xtoz> binary
File transfer type set to binary.

# Put a file from the UNIX host to the zoomer.
# Note the rename during transfer. See the "get" example above for the
# meaning of the dots.
xtoz> put xtoz.o xtoz.bin
..............................
File transfer complete.

# Same as "dir".
xtoz> ls

<DIR> 01-27-95 2:11p
. <DIR> 01-27-95 2:11p
XTOZ.BIN 30208 01-27-95 2:13p

# Renames the file on the zoomer.
xtoz> mv xtoz.bin test.bin
File Renamed

xtoz> dir

<DIR> 01-27-95 2:11p
. <DIR> 01-27-95 2:11p
TEST.BIN 30208 01-27-95 2:13p

# Removes the file from the zoomer. Same as "del".
xtoz> rm test.bin
File Removed

xtoz> cd ..
C:\GEOWORKS

# Remove the directory on the zoomer.
xtoz> rmdir temp
Directory Removed

# Clear the zoomer screen.
xtoz> cls
Clearing Zoomer screen..

# Reboot the zoomer (exit pccom).
xtoz> stop
Stopping Zoomer...

# Exit xtoz (or q or exit)
xtoz> quit
Quitting..