From 29e232356b58c678f69097e170850d6652561209 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Wed, 12 May 2010 23:33:18 +0200 Subject: system/atarisio: Added to 12.2 repository --- system/atarisio/999-atarisio.rules.in | 1 + system/atarisio/README | 32 +++++ system/atarisio/README.Slackware | 49 ++++++++ system/atarisio/atarisio.SlackBuild | 87 +++++++++++++ system/atarisio/atarisio.info | 8 ++ system/atarisio/doinst.sh | 13 ++ system/atarisio/man/adir.1 | 55 ++++++++ system/atarisio/man/ataricom.1 | 41 ++++++ system/atarisio/man/atariserver.1 | 230 ++++++++++++++++++++++++++++++++++ system/atarisio/man/atarixfer.1 | 52 ++++++++ system/atarisio/man/atpdump.1 | 18 +++ system/atarisio/man/atr2atp.1 | 19 +++ system/atarisio/man/casinfo.1 | 24 ++++ system/atarisio/man/dir2atr.1 | 150 ++++++++++++++++++++++ system/atarisio/slack-desc | 19 +++ 15 files changed, 798 insertions(+) create mode 100644 system/atarisio/999-atarisio.rules.in create mode 100644 system/atarisio/README create mode 100644 system/atarisio/README.Slackware create mode 100644 system/atarisio/atarisio.SlackBuild create mode 100644 system/atarisio/atarisio.info create mode 100644 system/atarisio/doinst.sh create mode 100644 system/atarisio/man/adir.1 create mode 100644 system/atarisio/man/ataricom.1 create mode 100644 system/atarisio/man/atariserver.1 create mode 100644 system/atarisio/man/atarixfer.1 create mode 100644 system/atarisio/man/atpdump.1 create mode 100644 system/atarisio/man/atr2atp.1 create mode 100644 system/atarisio/man/casinfo.1 create mode 100644 system/atarisio/man/dir2atr.1 create mode 100644 system/atarisio/slack-desc diff --git a/system/atarisio/999-atarisio.rules.in b/system/atarisio/999-atarisio.rules.in new file mode 100644 index 0000000000..fe39ef930e --- /dev/null +++ b/system/atarisio/999-atarisio.rules.in @@ -0,0 +1 @@ +KERNEL=="atarisio*", MODE="0660", GROUP="@GROUP@" diff --git a/system/atarisio/README b/system/atarisio/README new file mode 100644 index 0000000000..61deb9faed --- /dev/null +++ b/system/atarisio/README @@ -0,0 +1,32 @@ +atarisio (disk emulator for use with Atari 8-bit computer and SIO2PC) + +AtariSIO allows a Linux system to act as one or more disk drives, +a printer, and/or a cassette drive for an Atari 8-bit (400/800/XL/XE) +computer, using an SIO2PC cable. + +Even without SIO2PC or a real Atari, this package includes some utilities +that are useful for manipulating and examining Atari disk, tape, and +executable images. + +A real 16550A UART (or close derivative) is required. In particular, +atarisio does NOT work with USB to RS232 adaptors. + +======================================================================== += READ README.Slackware about the SETUID and GROUP variables = += before building the package! = +======================================================================== + +Before you can run atariserver or atarixfer, you will need the atarisio +kernel module loaded. If you're dedicating a serial port for use with +atariserver, you can add the following line to /etc/rc.d/rc.modules or +rc.local (as you prefer): + +/sbin/modprobe atarisio port=/dev/ttyS0 + +(Replace ttyS0 if you're using a different serial port, of course) + +If you need to use your serial port for other purposes, it's a little +less cut-and-dried. You will have to either manually modprobe and rmmod +the module as needed, or write yourself a script to do the job (possibly +also starting up agetty when the module is unloaded, or SLIP mode if +you're using FujiChat on your Atari, etc etc). diff --git a/system/atarisio/README.Slackware b/system/atarisio/README.Slackware new file mode 100644 index 0000000000..4cda49fe00 --- /dev/null +++ b/system/atarisio/README.Slackware @@ -0,0 +1,49 @@ +Before you can run atariserver or atarixfer, you will need the atarisio +kernel module loaded. If you're dedicating a serial port for use with +atariserver, you can add the following line to /etc/rc.d/rc.modules or +rc.local (as you prefer): + +/sbin/modprobe atarisio port=/dev/ttyS0 + +(Replace ttyS0 if you're using a different serial port, of course) + +If you need to use your serial port for other purposes, it's a little +less cut-and-dried. You will have to either manually modprobe and rmmod +the module as needed, or write yourself a script to do the job (possibly +also starting up agetty when the module is unloaded, or SLIP mode if +you're using FujiChat on your Atari, etc etc). + +#### READ THIS! #### + +# By default, atariserver and atarixfer are installed setuid root, +# group owner "users". This is done for two reasons: (a) so the programs +# can access the /dev/atarisio* devices, and (b) so they can set POSIX +# realtime scheduling mode, which prevents timing issues that can cause +# SIO frames to be retransmitted or (on a loaded system) dropped. + +# If run setuid root, atariserver and atarixfer will drop their root +# privileges after setting realtime mode and opening the device. +# There are no currently known exploits against atarisio, but the code +# hasn't exactly been audited by the NSA either. + +# You have several options here: + +# 1. The default. Simply run this script. On a single-user system, this +# is reasonable, though it's the least secure. atariserver and atarixfer +# will be setuid root, and runnable by anyone in the users group. + +# 2. Run atariserver and atarixfer setuid root, but restrict access to +# some group other than "users". To do this, run the script as: +# SETUID=yes GROUP=wheel ./atarisio.SlackBuild +# (replace "wheel" with any other group, as you prefer). +# This option is more secure than option 1 and outperforms option 3. + +# 3. Run atariserver and atarixfer as a normal user. This can cause +# performance problems, but on most setups it works OK. To do this, +# run the script as: +# SETUID=no ./atarisio.SlackBuild +# This should be more secure than 1 or 2. + +# 4. Same as 3, but extra paranoid: use a group other than "users" (I like +# "wheel"), and be very picky about who you add to the group. +# SETUID=no GROUP=wheel ./atarisio.SlackBuild diff --git a/system/atarisio/atarisio.SlackBuild b/system/atarisio/atarisio.SlackBuild new file mode 100644 index 0000000000..9d96a861c6 --- /dev/null +++ b/system/atarisio/atarisio.SlackBuild @@ -0,0 +1,87 @@ +#!/bin/sh + +# Slackware build script for atarisio + +# Written by B. Watson (yalhcru@gmail.com) +# Modified by the SlackBuilds.org project. + +PRGNAM=atarisio +VERSION=20080714 +ARCH=${ARCH:-i486} +BUILD=${BUILD:-1} +TAG=${TAG:-_SBo} + +CWD=$(pwd) +TMP=${TMP:-/tmp/SBo} +PKG=$TMP/package-$PRGNAM +OUTPUT=${OUTPUT:-/tmp} + +KERNEL=${KERNEL:-$(uname -r)} +KERNELPATH=${KERNELPATH:-/lib/modules/$KERNEL/build} +PKG_VERS=${VERSION}_$(echo $KERNEL | tr - _) + +SRCVER=${SRCVER:-080714} + +SETUID=${SETUID:-yes} +GROUP=${GROUP:-users} + +if [ "$ARCH" = "i486" ]; then + SLKCFLAGS="-O2 -march=i486 -mtune=i686" +elif [ "$ARCH" = "i686" ]; then + SLKCFLAGS="-O2 -march=i686 -mtune=i686" +elif [ "$ARCH" = "x86_64" ]; then + SLKCFLAGS="-O2 -fPIC" +fi + +set -e + +rm -rf $PKG +mkdir -p $TMP $PKG $OUTPUT +cd $TMP +rm -rf $PRGNAM-$SRCVER +tar xvf $CWD/$PRGNAM-$SRCVER.tar.gz +cd $PRGNAM-$SRCVER +chown -R root:root . +chmod -R a-s,u+w,go+r-w . + +sed -i "s/^\\(C.*FLAGS *= *\\)-g/\1$SLKCFLAGS/" Makefile + +make +mkdir -p $PKG/usr/{include,bin} $PKG/lib/modules/$KERNEL/misc +make install INST_DIR=$PKG/usr MDIR=$PKG/lib/modules/$KERNEL/misc + +# Hias forgot to add a couple of useful tools to his "make install" rule: +cp tools/{ataricom,atpdump,atr2atp,casinfo} $PKG/usr/bin + +strip $PKG/usr/bin/* +chown -R root:root $PKG/usr/bin + +if [ "$SETUID" = "yes" ]; then + chown root:$GROUP $PKG/usr/bin/{atariserver,atarixfer} + chmod 4710 $PKG/usr/bin/{atariserver,atarixfer} +else + chmod 0755 $PKG/usr/bin/{atariserver,atarixfer} +fi + + +# Doing it this way allows this script to work on 12.0 and 12.1 also. +mkdir -p $PKG/etc/udev/rules.d +sed 's/@GROUP@/'$GROUP'/g' < $CWD/999-$PRGNAM.rules.in > $PKG/etc/udev/rules.d/999-$PRGNAM.rules + +mkdir -p $PKG/usr/man/man1 +( cd $CWD/man + for i in *.1; do + gzip -9c $i > $PKG/usr/man/man1/$i.gz + done +) + +mkdir -p $PKG/usr/doc/$PRGNAM-$PKG_VERS +cp $CWD/README.Slackware README LICENSE Changelog $PKG/usr/doc/$PRGNAM-$PKG_VERS +cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$PKG_VERS/$PRGNAM.SlackBuild + +mkdir -p $PKG/install +cat $CWD/doinst.sh > $PKG/install/doinst.sh +cat $CWD/slack-desc > $PKG/install/slack-desc + +cd $PKG +/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$PKG_VERS-$ARCH-$BUILD$TAG.tgz diff --git a/system/atarisio/atarisio.info b/system/atarisio/atarisio.info new file mode 100644 index 0000000000..5d11206990 --- /dev/null +++ b/system/atarisio/atarisio.info @@ -0,0 +1,8 @@ +PRGNAM="atarisio" +VERSION="20080714" +HOMEPAGE="http://www.horus.com/~hias/atari/" +DOWNLOAD="http://www.horus.com/~hias/atari/atarisio/atarisio-080714.tar.gz" +MD5SUM="b2005038734f48a843796a75c57df528" +MAINTAINER="B. Watson" +EMAIL="yalhcru@gmail.com" +APPROVED="dsomero" diff --git a/system/atarisio/doinst.sh b/system/atarisio/doinst.sh new file mode 100644 index 0000000000..df3b7f1024 --- /dev/null +++ b/system/atarisio/doinst.sh @@ -0,0 +1,13 @@ +#!/bin/sh + +chroot . /sbin/depmod -a + +# Ensure that udevd knows what's up with the atarisio device(s)... +# Redirect stderr to /dev/null to avoid Slack 12.2 warning: +# Older (Slack 12.0/12.1) udevadm doesn't recognize the new form +# (--reload-rules is an error). For now, I want the package to +# work on at least 12.1 and 12.2. + +if [ -x sbin/udevadm ]; then + sbin/udevadm control --reload_rules 2>/dev/null +fi diff --git a/system/atarisio/man/adir.1 b/system/atarisio/man/adir.1 new file mode 100644 index 0000000000..9dbb2286d9 --- /dev/null +++ b/system/atarisio/man/adir.1 @@ -0,0 +1,55 @@ +.TH ADIR "1" "April 2007" "adir (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +adir \- print the directory of an Atari DOS floppy disk image + +.SH SYNOPSIS +.B adir +[\fB\-\fR\fI\fR] [\fB\-r\fR] [\fB\-t\fR] \fIimage-filename\fR [\fI...\fR] + +.SH DESCRIPTION +adir prints the directory of one or more DOS 2.x or MyDOS floppy images +(ATR, XFD, or DCM (DiskComm) format). Output resembles the output of the Atari DOS +\fBA\fR command. Single, enhanced 1050, double, and high-capacity +(hard disk) images are supported. + +.SH OPTIONS +.TP +\fB\-\fR\fI\fR +Number of columns for output format. Default is \fB\-4\fR. This option is +ignored if \fB\-r\fR is given. +.TP +\fB\-r\fR +Raw format: list the contents of all directory entries that have been used, +including those containing deleted files. Output consists of 6 columns: +.sp 1 +.PD 0 +.RS +.IP "File number" +.IP "Status flags (in hex)" +.IP "File name (8 characters)" +.IP "File extension (3 characters)" +.IP "Starting sector" +.IP "File size in sectors" +.RE +.PD 1 +. +.TP +\fB-t\fR +Recursively print directory tree of image. Only useful for MyDOS-formatted +disk images. +.TP +\fIimage-filename\fR [\fI...\fR] +One or more Atari DOS or MyDOS-compatible disk image files +(ATR, XFD, or DCM format). SpartaDOS-formatted images are \fBnot\fR supported. + +.SH +AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> + +.SH +SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIatarixfer\fR\|(1), \&\fIdir2atr\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/ataricom.1 b/system/atarisio/man/ataricom.1 new file mode 100644 index 0000000000..45a4a98604 --- /dev/null +++ b/system/atarisio/man/ataricom.1 @@ -0,0 +1,41 @@ +.TH ATARICOM "1" "April 2009" "ataricom (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +ataricom \- utility for manipulating Atari 8\-bit executable files +.SH SYNOPSIS +ataricom [\fIoptions\fR]... file [outfile] +.SH DESCRIPTION +ataricom performs various useful operations on Atari 8\-bit executable +files. These files are also known as binary load files, or COM, BIN, XEX, OBJ, OBX, et al. These +are only names; there is only one Atari 8\-bit executable file format. +.SH OPTIONS +.TP +\fB\-c\fR address +create COM file from raw data file +.TP +\fB\-r\fR address +add RUN block with specified address at end of file +.TP +\fB\-i\fR address +add INIT block with specified address at end of file +.TP +\fB\-b\fR start[\-end] +only process specified blocks +.TP +\fB\-x\fR start[\-end] +exclude specified blocks +.TP +\fB\-m\fR start\-end +merge specified blocks +.HP +\fB\-s\fR block,adr... split block at given addresses +.TP +\fB\-n\fR +write raw data blocks (no COM headers) +.SH AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> +.SH SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/atariserver.1 b/system/atarisio/man/atariserver.1 new file mode 100644 index 0000000000..6226bb55c7 --- /dev/null +++ b/system/atarisio/man/atariserver.1 @@ -0,0 +1,230 @@ +.TH ATARISERVER "1" "April 2007" "atariserver (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH +NAME +\fBatariserver\fR \- SIO server (peripheral emulator) for Atari 8\-bit computers, for use with an SIO2PC cable + +.SH +SYNOPSIS +.B atariserver +[\fB\-h\fR] +[\fB\-f\fR \fIdevice\fR] +[\fB\-c\fR] +[\fB\-C\fR] +[\fB\-m\fR] +[\fB\-o\fR \fIfile\fR] +[\fB\-p\fR] +[\fB\-s\fR] +[\fB\-S\fR] +[\fB\-X\fR] +[\fB\-t\fR] +[\fB\-<1-8>\fR] +[\fB\-V\fR \fIdensity\fR \fIdir\fR] +[\fB\-P\fR \fIconv\fR \fIpath\fR] +[\fBfilename\fR] +[\fI...\fR] + +.SH +DESCRIPTION +\fBatariserver\fR emulates Atari 8\-bit peripherals using the \fBSIO\fR +protocol, including disk drives, printers, and cassette tape decks. + +This manual page only documents the command\-line options to +\fBatariserver\fR. For more information, including a description of +the user interface and the command set +for remote command support, see the \fBREADME\fR +file for AtariSIO, possibly located in /usr/doc/atarisio or +/usr/share/doc/atarisio. + +.SH +OPTIONS +Most options can be set from within \fBatariserver\fR's curses\-based +user interface while the program is running. +.TP +\fB\-h\fR +Displays command line help message +.TP +\fB-f\fR \fIdevice\fR +Sets the AtariSIO device. This option is only needed if you +configured the kernel driver to support more than one interface. +.IP +\fINote:\fR this must be the very first command line option, otherwise +it will be ignored! +.IP +Without this option, \fBatariserver\fR will check if the environment +variable \fBATARISERVER_DEVICE\fR is set. If not, the default device +\fB/dev/atarisio0\fR will be used. + +.TP +\fB\-c\fR +Tells AtariSIO that your Atari is connected via an alternative +SIO2PC cable. The standard SIO2PC cable uses the RI pin for +command line input. Some Windows SIO emulators use a slightly +modified SIO2PC cable, using DSR instead of RI. If you are not +sure what kind of SIO2PC cable you have, just try starting +atariserver with and without the \fB\-c\fR switch and test if your +Atari can boot from atariserver. +.IP +\fINote:\fR there's no performance benefit using the DSR line instead +of the RI line; both cables work identically with AtariSIO. + +.TP +\fB\-C\fR +Similar to \fB\-c\fR except that the CTS pin is used. This is +quite useful for testing purposes: connect two PCs with a +nullmodem\-cable, start \fBatariserver\fR with \fB\-C\fR on one machine +and \fBatarixfer\fR with \fB\-p\fR on the other. + +.TP +\fB\-m\fR +Monochrome mode: disable colors, even if your terminal +reports color support. + +.TP +\fB\-o\fR \fIfile\fR +Set trace file: all output displayed in the log window will +also be saved to the specified file. + +.TP +\fB\-p\fR +Loads the next image with "write protect" enabled. This +option is only valid for the next image; if you want to load +multiple write protected images, you have to specify this +options before each filename. + +.TP +\fB\-s\fR +Disables high speed (57600 bit/sec) SIO support. It sets +the baudrate to fixed 19200 bit/sec and also disables several +special commands like "get ultraspeed byte" or "flush disk" +that are only supported by high-speed drives like the +1050 speedy. Read the list of SIO commands at the end of the +README for more details. + +.TP +\fB\-S\fR +High speed (57600 bit/sec) mode with pauses between bytes. +This is needed for some high speed SIO routines which are too +slow to handle sustained 57600 bit/sec transfers. The effective +speed will be approx. 48000 bit/sec. + +.TP +\fB\-X\fR +Enable XF551 compatibility mode. In XF551 mode \fBatariserver\fR +reacts to commands with the 7th bit set and automatically +switches to 38400 bit/sec transfer mode. Additionally, the +GetStatus command sets both bit 7 and 6 in case of an QD +(double sided, double density, 1440 sectors) disk, just like +the XF551. + +.TP +\fB\-t\fR +Increases the trace level. You may use this option up to +three times if you want more output. + +.TP +\fB\-1\fR \fIthrough\fR \fB\-8\fR +Set the drive number for the next image file. The default is 1 for the +first image, and is incremented for each subsequent image. See \fBNOTES\fR +below for an example. + +.TP +\fB\-V\fR \fIdensity\fR \fIdir\fR +Create virtual device of given density, using files from directory \fIdir\fR. +\fIdensity\fR is one of: +.IP +\fBs\fR (single density, 720 sectors), +.IP +\fBd\fR (double density, 720 sectors), +.IP +\fBe\fR (1050 "enhanced" density, 1040 sectors), +.IP +\fInumber\fR\fBs\fR (single density, \fInumber\fR sectors, e.g. \fB1440s\fR), +.IP +\fInumber\fR\fBd\fR (double density, \fInumber\fR sectors, e.g. \fB1440d\fR), +.IP +\fBS\fR (single density, the number of sectors needed to store all files is automatically calculated) +.IP +\fBD\fR (double density, like \fBS\fR) +.TP +\fB\-P\fR \fIconv\fR \fIpath\fR +Install printer handler. +.IP +\fIconv\fR is EOL conversion: \fBr\fR=raw(no conversion), \fBl\fR=LF (UN*X), \fBc\fR=CR+LF (DOS/Windows) +.IP +\fIpath\fR is either a filename or \fI|print-command\fR, eg \fB|lpr\fR +.IP +\fINote:\fR Most shells require you to quote \fIpath\fR if it contains a pipe (|) character. To use the standard unix print service, use: \fB-P l "|lpr"\fR + +.TP +\fIfilename\fR +One or more image files, which should be either ATR or XFD format Atari +8\-bit disk images. Image filenames may be interleaved with \fB\-[1\-8]\fR +and/or \fB-p\fR options. Images may be in any Atari\-compatible DOS or +boot disk format; \fBatariserver\fR simply serves them to the Atari, +without interpreting the contents. + +.SH +NOTES +To load several images you could start atariserver with +the following options (for example): + +.br +atariserver dos.atr -3 -p data1.atr -V d filedir +.br + +This will load dos.atr into D1:, data1.atr into D3: and create +a virtual drive in double density (720 sectors) out of the +directory filedir. Furthermore, D1: and D4: will be writable, +whereas D3: will be write protected. + +If you set the environment variable ATRPATH, \fBatariserver\fR will look +for image files in the specified (colon separated) directories +if the image can't be found in the current working directory. +ATRPATH works both on the command line and in the user interface. +For example: + +export ATRPATH=/home/atari/dos:/data/xl/magazines + +or (for csh users): +setenv ATRPATH /home/atari/dos:/data/xl/magazines + +.SH +KERNEL SUPPORT + +\fBatariserver\fR requires the \fBatarisio\fR kernel module (driver) to +be loaded. If you receive an "error opening /dev/atarisio0" message, +try loading the module (as \fBroot\fR): + +.br +/sbin/modprobe atarisio port=/dev/ttyS0 +.PP +Replace ttyS0 with whichever serial port has the SIO2PC cable attached. +If the module refuses to load, you may have to "modprobe 8250" first. + +.SH +SUPPORTED HARDWARE + +\fBatariserver\fR works with most common one-chip RS232 (serial port) +SIO2PC designs, including the AtariMax "smart" SIO2PC by Steven Tucker, +and designs based on the 1489/14C89 and Max232/233 chips. +.PP +The USB SIO2PC (sometimes incorrectly called SIO2USB) from AtariMax is +\fBNOT\fR supported, though support is planned for future versions +of AtariSIO/atariserver. +.PP +The old two-chip SIO2PC interface (with a MAX232 and an LS368) +is NOT supported, and probably never will be. +.PP +All Atari 8\-bit computers (400/800, XL, and XE series) are supported. + +.SH +AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> + +.SH +SEE ALSO +\&\fIatarixfer\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/atarixfer.1 b/system/atarisio/man/atarixfer.1 new file mode 100644 index 0000000000..61e13bd4da --- /dev/null +++ b/system/atarisio/man/atarixfer.1 @@ -0,0 +1,52 @@ +.TH ATARIXFER "1" "April 2007" "atarixfer (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +\fBatarixfer\fR \- read or write from an Atari disk drive, via 1050-2-PC or APE ProSystem cable + +.SH SYNOPSIS +.B atarixfer +[\fB\-f\fR \fIdevice\fR] [\fB\-p\fR] [\fB\-r\fR \fIimagefile\fR] [\fB\-w\fR \fIimagefile\fR] [\fB\-d\fR] [\fB\-\fR<\fIdrive\fR>] + +.SH DESCRIPTION +\fBatarixfer\fR can either write a disk image file to a real Atari disk drive, +or read a disk from an Atari drive and write its contents to an image file. +A 1050-2-PC or APE ProSystem cable is required. +.PP +\fBatarixfer\fR only supports whole-disk transfers, to or from a +disk image file. Reading/writing single files or individual sectors +is not possible. + +.SH OPTIONS +.TP +\fB-f\fR \fIdevice\fR +Use alternative AtariSIO device (default: \fI/dev/atarisio0\fR) +.TP +\fB-p\fR +Use APE ProSystem cable (default: 1050-2-PC cable) +.TP +\fB-r\fR \fIimagefile\fR +Read from Atari disk and create an image of its contents. The type of +image to create is decided by looking at the filename, which should end +in \fI.atr\fR, \fI.xfd\fR, or \fI.dcm\fR (case-insensitive). If the +filename doesn't match any of these, ATR image format is assumed. +.TP +\fB-r\fR \fIimagefile\fR +Write a disk image to the drive. +.TP +\fB-d\fR +Enable debugging output. +.TP +[\fB\-\fR<\fIdrive\fR>] +Use drive number (1..8). Default is \fB-1\fR. The drive number must +match the drive number switches on the Atari drive. + +.SH +AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> + +.SH +SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/atpdump.1 b/system/atarisio/man/atpdump.1 new file mode 100644 index 0000000000..e993fad673 --- /dev/null +++ b/system/atarisio/man/atpdump.1 @@ -0,0 +1,18 @@ +.TH ATPDUMP "1" "April 2009" "atpdump (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +atpdump \- Display the structure of an ATP format Atari 8\-bit disk image. +.SH SYNOPSIS +atpdump [file] +.SH DESCRIPTION +The ATP format is intended as an open source replacement for the proprietary +APE PRO and VAPI formats. Currently, ATP is very limited in its capabilities. +atpdump is primarily useful for testing, and for development of the ATP +format itself. +.SH AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> +.SH SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1), \&\fIatr2atp\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/atr2atp.1 b/system/atarisio/man/atr2atp.1 new file mode 100644 index 0000000000..57d0d9090a --- /dev/null +++ b/system/atarisio/man/atr2atp.1 @@ -0,0 +1,19 @@ +.TH ATR2ATP "1" "April 2009" "atr2atp (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +atr2atp \- converts a ATR\-format Atari 8\-bit disk image to the experimental +ATP format supported by atariserver. +.SH SYNOPSIS +atr2atp [input-file] [output-file] +.SH DESCRIPTION +The ATP format is intended as an open source replacement for the proprietary +APE PRO and VAPI formats. Currently, ATP is very limited in its capabilities. +atr2atp is primarily useful for testing, and for development of the ATP +format itself. +.SH AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> +.SH SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1), \&\fIatpdump\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/casinfo.1 b/system/atarisio/man/casinfo.1 new file mode 100644 index 0000000000..73ec5de856 --- /dev/null +++ b/system/atarisio/man/casinfo.1 @@ -0,0 +1,24 @@ +.TH CASINFO "1" "April 2009" "casinfo (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +casinfo \- Get information on an Atari 8\-bit cassette image file +.SH SYNOPSIS +casinfo file [file] ... +.SH DESCRIPTION +For each valid cassette image (CAS file) on the command line, casinfo +will display the description (if any), the number of parts (aka load +stages), the number of blocks, and the block header information for +each block in the file. +.PP +casinfo takes no options. +.PP +For a complete specification of the CAS file format, see the documentation +for \fBcas2wav\fR, \fBwav2cas\fR, and/or \fBcassio\fR, all available +at a web browser near you... +.SH AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> +.SH SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIdir2atr\fR\|(1), \&\fIadir\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/man/dir2atr.1 b/system/atarisio/man/dir2atr.1 new file mode 100644 index 0000000000..b4e352cedc --- /dev/null +++ b/system/atarisio/man/dir2atr.1 @@ -0,0 +1,150 @@ +.TH DIR2ATR "1" "April 2007" "dir2atr (atarisio 0.30)" "HiassofT Atari 8-bit Tools" +.SH NAME +dir2atr \- create an Atari disk image from a directory of files + +.SH SYNOPSIS +.B dir2atr +[\fB\-d\fR] [\fB\-m\fR] [\fB\-p\fR] [\fB\-b\fR \fIDOS\fR] [\fBsectors\fR] \fIimage\-filename\fR \fIdirectory\fR + +.SH DESCRIPTION +\fBdir2atr\fR creates an Atari DOS 2.x or MyDOS compatible disk image, +containing the files from \fIdirectory\fR (or a blank disk, if the +supplied \fIdirectory\fR does not exist). Despite the name, dir2atr is +capable of creating ATR, XFD, or DCM format images. + +.SH OPTIONS +.TP +\fB\-d\fR +Create double\-density (256 bytes/sector) disk image. Without this option, +the default is to create a single\-density (128 bytes/sector) image. +.TP +\fB\-m\fR +Use MyDOS format (VTOC; see \fB\-b\fR for boot sector type). Without this +option, \fBdir2atr\fR may still create a MyDOS format image: If the +number of sectors is not supplied, or if using double density (\fB\-d\fR), +or if the number of sectors supplied in single density mode is anything +other than 720 or 1040, then MyDOS format will be used. +.sp +.RS +Another way of saying this is that DOS 2.x format will only be used if the +number of sectors is supplied, and if it is equal to either 720 (DOS 2.0 +format) or 1040 (DOS 2.5 enhanced density format). +.sp +SpartaDOS\-formatted images are \fBnot\fR supported. +.RE +.TP +\fB\-p\fR +Create \fBPICONAME.TXT\fR file in disk image, containing long filename +information (will be used by MyPicoDOS when displaying filenames). +.TP +\fB\-b\fR \fIDOS\fR +Create bootable disk for specified DOS. The directory must already +contain the \fBDOS.SYS\fR or equivalent for the specified DOS, unless +creating a MyPicoDOS image (in which case, \fBPICODOS.SYS\fR will be +created and added to the image). +.sp +Supported DOS choices (case\-insensitive): +.br +Dos20, Dos25, MyDos453, TurboDos21, TurboDos21HS, MyPicoDos403, MyPicoDos403HS +.TP +\fBsectors\fR +Number of sectors in the created image. Standard floppy\-sized images +generally contain 720 sectors (single\- or double\-density, 90K or 180K +capacity) or 1040 sectors (1050/DOS 2.5 enhanced density, 127K capacity). +.sp +Some Atari drives and DOSes support larger floppy disks (e.g. 1440 +double\-density sectors for a DS/DD XF551 disk, 360K capacity; or +2880 DD sectors for a PC-style 720K floppy drive). +.sp +Hard disk images may contain up to 65535 double\-density sectors. This +limitation is imposed by the ATR file format (16 megabytes is pretty +big for an 8-bit Atari disk, though). Most Atari DOSes won't support +physical disk partitions bigger than this, anyway. Theoretically, +the XFD "format" could be of unlimited size (since it's just a raw +dump of the sectors, with no structure), but \fBdir2atr\fR imposes +the same size limit for XFD as for ATR. +.sp +Actually, the distinction between "hard disk" and "floppy disk" images +doesn't really exist in the ATR file format: any image that fits on +an actual floppy disk (one that's actually supported by an actual +Atari DOS) is by definition a floppy image, and anything +larger than that must be considered a hard disk image. +.sp +If \fBsectors\fR is omitted, \fBdir2atr\fR will create a MyDOS\-format +image with as many sectors as needed to contain the all the files +in \fIdirectory\fR, unless this is less than 720 sectors (in which +case, a 720\-sector image is created, with some free sectors). +.sp +If \fBsectors\fR is given, it must be between 720 and 65535. No +Atari\-compatible disk may contain fewer than 720 sectors. When +creating a DCM (DiskComm) image, the only supported image sizes +are 90K (720 single\-density sectors), 127K (1040 single\-density +sectors, aka 1050 enhanced density), and 180K (720 double\-density +sectors). +.sp +If you specify a number of sectors too small for the files in +\fIdirectory\fR, you will get an error message, but the image will +still be created. It will contain whatever files were copied before +running out of space (which might be none, if the first file is too +big to fit). +.TP +\fIimage\-filename\fR +Disk image file to create. The image type is determined by the +filename "extension", which should be \fI.atr\fR, \fI.xfd\fR, or \fI.dcm\fR. +The extension is treated case\-insensitively, and the default image type +is ATR if the extension is missing or not recognized. +.TP +\fIdirectory\fR +Directory of files to be copied to the image. The files are copied in +case-sensitive alphabetical order. \fIdirectory\fR may contain +subdirectories, which will be skipped if creating a DOS 2.x image, or +included (recursively) as MyDOS subdirectories if creating a MyDOS image. +While the image is being created, each filename in \fIdirectory\fR is +printed to standard error output after it's copied. +.sp +\fBNOTE:\fR Empty subdirectories will \fBnot\fR be copied to the image. +.sp +Atari DOS and MyDOS (and any other compatible DOS for the Atari) suffer +from a limit of 64 files per directory. For Atari DOS, this means 64 +files per disk, since subdirectories are not supported. For MyDOS, +it means 64 files/subdirectories per directory. In either case, +\fBdir2atr\fR will copy the first 64 files in the directory or +subdirectory, then issue a warning to let you know that it had to +skip the rest of the files. +.sp +To create a blank disk, you may create and use an empty directory. A +blank disk is also created if the specified \fIdirectory\fR is not +a directory (e.g. if it's a regular file), or if it does not exist +at all! No error messages are given for non\-directories or non\-existent +files. This is probably not the author's original intent, but it can +be considered useful behaviour (except when it's confusing: if you make +a typo in the \fIdirectory\fR, you'll end up with a blank image instead +of the expected error message. The careful user will notice that no +"Added file" messages get printed in this case). +.sp +Although Atari DOS and MyDOS only support uppercase "8.3" names, +filenames within \fIdirectory\fR are not required to conform to this +limitation. \fBdir2atr\fR will transform the filenames so that they +match the Atari limitations, although care should be taken to avoid +filenames within \fIdirectory\fR that differ only in case (e.g. +\fBFOO\fR and \fBfoo\fR). If this happens, some of the resulting Atari +filenames will contain spaces, which is incompatible with most +(all?) Atari DOSes. Also, \fBdir2atr\fR will allow filenames inside +the image to start with a digit, which is incompatible with most Atari +DOSes as well. +.sp +If the \fB\-p\fR option is used, the filenames will still be transformed +as necessary, but the original filenames will be recorded in the +\fBPICONAME.TXT\fR file. If creating a MyPicoDOS image, the MyPicoDOS +menu will actually display the full, original filenames. +.SH +AUTHOR +Matthias Reichl <\fBhias@horus.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fB> + +.SH +SEE ALSO +\&\fIatariserver\fR\|(1), \&\fIatarixfer\fR\|(1), \&\fIadir\fR\|(1). +.PP +AtariSIO home page: \fBhttp://www.horus.com/~hias/atari/\fR diff --git a/system/atarisio/slack-desc b/system/atarisio/slack-desc new file mode 100644 index 0000000000..c7077bd711 --- /dev/null +++ b/system/atarisio/slack-desc @@ -0,0 +1,19 @@ +# HOW TO EDIT THIS FILE: +# The "handy ruler" below makes it easier to edit a package description. Line +# up the first '|' above the ':' following the base package name, and the '|' +# on the right side marks the last column you can put a character in. You must +# make exactly 11 lines for the formatting to be correct. It's also +# customary to leave one space after the ':'. + + |-----handy-ruler------------------------------------------------------| +atarisio: atarisio (disk emulator for use with Atari 8-bit computer and SIO2PC) +atarisio: +atarisio: AtariSIO allows a Linux system to act as one or more disk drives, +atarisio: a printer, and/or a cassette drive for an Atari 8-bit (400/800/XL/XE) +atarisio: computer, using an SIO2PC cable. +atarisio: +atarisio: Even without SIO2PC or a real Atari, this package includes some +atarisio: utilities that are useful for manipulating and examining Atari disk, +atarisio: tape, and executable images. +atarisio: +atarisio: -- cgit v1.2.3