Newsgroups: comp.os.linux.announce,comp.os.linux.help From: ftape@mic.dth.dk (Linux ftape-HOWTO maintainer) Subject: Linux Ftape HOWTO Keywords: ftape HOWTO FAQ RTFM hardware-compability Summary: The document answers many of the Frequently Asked Questions on the newsgroups and describes which ftape drives are known to work (and which are known *not* to work) with the ftape driver. Approved: linux-announce@tc.cornell.edu (Matt Welsh) Archive-name: linux/howto/ftape Last-modified: 8 Jan 1994 This is the `Frequently Asked Questions' (FAQ) / HOWTO document for the ftape driver (ftape-HOWTO). Please read this document *to the very end*, before you post a question to a newgroup / Linux-TAPE channel / the maintainer. This will take off the peak of questions, and releases us all to more constructive work (like improving the ftape driver :-) This HOWTO is written and maintained by: Kai Harrekilde-Petersen Last update: January 8, 1994 17:53, for ftape 0.9.9 Email's concerning the HOWTO should be directed to: ======================================================================== CONTENTS Section 1: The preliminaries ---------------------------- Q1.1 What's the newest version of ftape - and where can I get it? Q1.2 Where can I follow the development? Q1.3 Which drives are supported? Q1.4 Which drives are *NOT* supported? Q1.5 How do I install it? Q1.6 Where can I get the kernel sources? Q1.7 Can I format my tapes under Linux? Q1.8 Which formatting programs can I use under DOS? Section 2: Backing up and restoring data and other FAQ's -------------------------------------------------------- Q2.1 How do I write backups to the tape? Q2.2 ... and how do I read them back? Q2.3 I want to check the archive I've made ... how? Q2.4 How can I put more than one tar file on a tape? Q2.5 Can I append files to an archive? Q2.6 How do I mount/unmount a tape? Q2.7 Can I exchange tapes with someone using DOS? Q2.8 How do I `....' with tar? Section 3: Frequently Asked Questions ------------------------------------- Q3.1 ftape DMA transfers gives ECC errors Section 4: Debugging the ftape driver ------------------------------------- Q4.1 ftape crashes on me when I do `...' - is that a bug? Q4.2 ftape keep saying `... new tape', what do I do? Q4.3 OK, it's a bug^H^H^H feature - How do I submit a report? Q4.4 How do I change the trace-level? Q4.5 When I use /dev/nftape, I get garbage Section 5: Supporting the development of ftape ---------------------------------------------- Q5.1 I just *LOVE* this ftape driver, how can I support the developers? Q5.2 I wanna help developing a `....' Who should I contact? ======================================================================== Section 1: The preliminaries ============================ Q1.1 What's the newest version of ftape - and where can I get it? -------------------------------------------------------------------- The newest version of the ftape driver is ftape-0.9.9, and can be fetched from the following sites: tsx-11.mit.edu [18.172.1.2]: /pub/linux/ALPHA/QIC-80/ sunsite.unc.edu [152.2.22.81]: /pub/Linux/kernel/tapes/ ftp.funet.fi [128.214.248.6]: /pub/OS/Linux/BETA/QIC-80/ You should get the files: ftape-0.9.9.tar.gz and ftape-0.9.9.lsm. The tar.gz file is the ftape driver proper, while the .lsm file is a Linux Software Map (LSM) file (for the LSM project). Q1.2 How can I follow the development? ----------------------------------------- If you want to follow the development of the ftape driver, you should consider subscribing to the TAPE channel on Linux-activists. To subscribe, you send a mail to , with the *FIRST LINE* saying `X-Mn-Admin: add TAPE' If you send an empty mail (or the automagical mail-response system chokes on your mail), you are sent a HOWTO mail. To submit a real mail to the mailing lists, send a mail to , and remember that the first line should read `X-Mn-Key: TAPE'. Q1.3 Which drives are supported? ----------------------------------- All drives that are both QIC-117 compatible *AND* either QIC-40 or QIC-80 compatible should work. Currently, the list of drives that's *positively* known to work with ftape is: * Colorado DJ-10 / DJ-20 (aka: Jumbo 120 / Jumbo 250) * Archive 5580i / XL9250i, * Insight 80Mb, * Conner C250MQ, * Wangtek 3080F, * Iomega 250, * Escom / Archive 31250Q, * Summit SE 150 / SE 250, * Mountain FS8000. NOTE: If you have a drive that works fine, but isn't listed here, please send a mail to the HOWTO maintainer (ftape@mic.dth.dk). Q1.4 Which drives are *NOT* supported? ----------------------------------------- * All drives that connect to the parallel port (eg: Colorado Trakker) * High-Speed controller's. (eg: Colorado TJ-10) * Irwin AX250L / Accutrak 250. (not a QIC-80 drive) * COREtape light Generally, *ALL* drives that connect to the parallel port are *NOT* supported. This is because these drives uses (different) proprietary interfaces, that are very much different from the QIC-117 standard. The Colorado TJ-10 High-Speed controller (and the likes) aren't supported. They may be so in the future, though. IRWIN AX250L doesn't work the ftape. This is because it only supports QIC-117, but not the QIC-80 standard (it uses Irwin's proprietary (Rhomat) format). The COREtape light doesn't work (yet). We have some info on it, but we haven't got it accepting the initialisation data. Q1.5 How do I install it? ---------------------------- There is included an installation guide (the file INSTALL) in the ftape distribution. Q1.6 Where can I get the kernel sources? ------------------------------------------- You can get the kernel sources from the same place as you got the ftape sources. The sources are kept at the following sites (and many mirror-sites) tsx-11.mit.edu [18.172.1.2]: /pub/linux/sources/system/ sunsite.unc.edu [152.2.22.81]: /pub/Linux/kernel/ ftp.funet.fi [128.214.248.6]: /pub/OS/Linux/PEOPLE/Linus/ funet carries the so-called ALPHA versions too. These are typically more advanced than the `standard' versions, but are less stable. New versions may be introduced to fix a bug within days, but they may also introduce new bugs. Q1.7 Can I format my tapes under Linux? ------------------------------------------ At the moment, no! We haven't had the time to develop a formatting utility for Linux. Instead you'll have to use MS-D*S (arghhh!) instead or buy preformatted tapes. However, some of the preformatted tapes are *not* checked for bad sectors!. If the ftape driver enocunters a tape with no bad blocks, it'll issue a warning. Q1.8 Which formatting programs can I use under DOS? ------------------------------------------------------ These are known to work: * Colorado Memory System's software (tape.exe) * Norton Backup These programs are known to be more or less buggy: * CONNOR's Dos software (Windoze version is fine!) * CP Backup will wastes tape space, but is OK apart from that. In fact, most software under DOS should work. CONNOR's program (the dos version) has a parameter off-by-one (someone couldn't read the QIC-80 specs right!), while their Windoze version works fine. Central Point Backup can be used, but it wastes precious tape spaces when it encounters a bad spot on the tape. NOTE: If you are running a formatting software under DOS, which isn't mentioned here, please mail the maintainer (ftape@mic.dth.dk) the relevant info, so we can update the HOWTO. Section 2: Backing up and restoring data ======================================== Q2.1 How do I write backups to the tape? ------------------------------------------- You can use tar, dd and cpio. For a start I'd recommend tar, as it can archive lots of directories and let's you pick out seperate files from an archive. To make a backup of your kernel source tree, do this (assuming you have the source in /usr/src/linux): cd /usr/src tar cf /dev/ftape linux This won't compress the files, but gives you a smoother tape run. If you want the compression (and you've got tar 1.11.2), you just include the -z flag(*), eg: `tar czf /dev/ftape linux' For further instructions on how to use tar, dd and look at the man pages and the texinfo files that comes with the respective distributions. (*) tar assumes that the first argument is options, so the `-' isn't necessary. Ie: these two commands are the same: `tar xzf /dev/ftape' and `tar -xzf /dev/ftape' Q2.2 ... and how do I read them back? ---------------------------------------- OK, let's restore the backup of the kernel source you made in Q2.1 To do this you simply say tar xf /dev/ftape If you used compression, you'll have to say tar xzf /dev/ftape When you use compression, gzip will complaint about trailing garbage after the very end of the archive (and this will lead to a `broken pipe' message). This can be safely ignored. For the other utilities, read the man page. Q2.3 I want to check the archive I've made ... how? ------------------------------------------------------ tar has an option (-d) for detecting differences between two archives. To test your backup of the kernel source say tar df /dev/ftape If you don't have the man page for tar, you're not lost (yet). tar has a builtin option list: try `tar --help | more' Q2.4 How can I put more than one tar file on a tape? ------------------------------------------------------- "If I understand, tar -cf /dev/ftape stuff will only allow one tar file / tape. Does the trick of using DD via a pipe allow more than one file?" By using the nftape device (nope, it doesn't work yet), you should be able to use `mt' to position the tape the correct place. (`mt /dev/nftape fsf 2' means go to tar file number 2) "I hate to say, but it appears (could be wrong) that the CMS software has more capability than tar -- at least it can put two archives on one tape." It depends on how you look at it: tar generates a single Tape ARchive (that's why it's called `tar'). If you want more than one backup on a single tape, you must use tar in conjunction with another tool, eg: `mt'. There exists a `QIC-80 logical format', which is what the CMS software conforms to. I'm going to look at it when I'm done with my thesis (ie: i'm start working on the QIC-80 logical format in feb '94 at the earliest) Truly, that's the way it goes, when you start using something that's still in it's infancy :-/ Q2.5 Can I append files to an archive? -------------------------------------------- "Is there a way to extend an archive -- put a file on the tape, then later, add more to the tape?" No. The tar documentation will tell you to use `tar -Ar', but it doesn't work. This is a limitation of the current ftape driver. Q2.6 How do I mount/unmount a tape? -------------------------------------- You don't! -- Since a tape doesn't have a "filesystem" on it, you don't mount / unmount the tape. To backup, you just insert the tape and run your `tar' command (or whatever you use to access the tape with). "Is there an explicit (dis)mount command for the tape?" Nope. The ftape device is a `character device', and they can't be [u]mount'ed. It's only block devices that get's mounted Q2.7 Can I exchange tapes with someone using DOS? ---------------------------------------------------- Nope. This is one of my pet-projects, so maybe in the future (any help is welcome). Q2.8 How do I `....' with tar? --------------------------------- These are really tar questions: Read the man page and the info page. If you haven't got either, DO try `tar --help | more'. If your tar is v1.11.1 or earlier, consider upgrading to v1.11.2 - This version can call GNU zip directly (ie: it supports the -z option) and has an elaborate help included. Also, it compiles right out of the box on Linux. Section 3: Frequently Asked Questions ===================================== Q3.1 ftape DMA transfers gives ECC errors -------------------------------------------- Sadly to say there are some SVGA cards and ethernet cards that do not decode their addresses correct. This typically happens when the ftape buffers are in the range 0x1a0000 to 0x1c0000. Somehow, the DMA write cycles get clobbered and every other byte written gets a bad value (0xff). These problems are reported to happen with both SVGA and ethernet cards. We know of at least one (bad?) ATI 16bit VGA card that caused this. The easiest solution is to put the card in an 8bit slot (it's often not good enough to reconfigure the card to 8bit transfers). Moving the ftape buffer away from the VGA range is only a partial solution; All DMA buffers used in Linux can have this problem! Let's make this clear: This has nothing to do with the ftape software :-) Section 4: Debugging the ftape driver ===================================== Q4.1 ftape crashes on me when I do `...' - is that a bug? ------------------------------------------------------------- No, that's a feature ;-) Seriously, reliable sofware don't crash. Especially kernel's do not or rather should not crash. If the kernel crashes upon you when you're running ftape, and you *can prove* that it's ftape that's messing things up, regard it as a Bug that Should Be Fixed. Mail the details to the developers (see Q4.3 below). Q4.2 ftape keep saying `... new tape', what do I do? ------------------------------------------------------- To get rid of this, do this (blindfold): login as root and say `rmmod driver'. ftape should choke a few times, give three segmentation violations (or so), and give up life. Check the activity LED on your floppy drive (you do have one, don't you?). If it's constantly lit, you've turned the cable upside down somewhere. Check your cable between controller, tape drive _and_ floppy drive. Usually, one (or more) of the cables have been turned upside down, such that pin 1 in one end connects to pin 34 in the other end. (All the even-numbered pins are grounded, so you won't be able to use your floppy either) Q4.3 OK, it's a bug^H^H^H feature - How do I submit a report? ---------------------------------------------------------------- First, make sure you can reproduce the problem. Spurious errors are a pain in the ass, since they're just about impossible to hunt down. This is a quick check list: * Kernel version, and patches applied (even ftape patches) * ftape version * tape drive model / manufacturer * What you did to expose the problem * A log of the run with tracing level set to 8 (the max) * What went wrong on your system. * Don't delete the kernel and driver.o file. We may want you run try some patches out or run a different test on your system. Increase the tracing level to 8 (maximum tracing) and run the offending command again. Get the tracing data from the kernel log or /proc/kmsg, depending on where you harvest your error messages. Don't try to `trim' the kernel log. You might consider something irrelevant, which is essential to the investigator of the bug. State exactly what you did, and what happened on your system. We might not see the error because we use a different tape drive or another version of the kernel! Q4.4 How do I change the trace-level? ---------------------------------------- You can do this two ways: either change the default trace-level (the var `tracing' in file `ftape-rw.c') and recompile or say mt /dev/ftape fsf The use of the fsf command in mt is a *hack*, and will disappear in time. Q4.5 When I use /dev/nftape, I get garbage...? ------------------------------------------------- The non-rewinding /dev/nftape device is not supported yet, but Bas is working on it at the moment. You don't *need* to have it, but we've included it for completeness. For now: Don't use it! Section 5: Supporting the development of ftape ---------------------------------------------- Q5.1 I just *LOVE* this ftape driver, how can I support the developers? -------------------------------------------------------------------------- [Just send me a >1Gb scsi-2 disk, that'll suffice ;-] [satirical entry, to be removed, lest Bas wants it there with a serious content, --khp] You can support us by answering other users questinos on the newsgroups. There are many mew users (newbies), that just needs a simple answer to a question, for a reference to where they can get this HOWTO. This is about the best support you can give us besides testing the driver and writing good error-reports. Q5.2 I wanna help developing a `....' Who should I contact? -------------------------------------------------------------- Below is a list of the developers. If there's already someone working on a similar / identical project, contact that person directly. If you have an program / feature that no-one is working on, contact me (NOT Bas, he's already over-burdened by work and has little time to reply to questions) Formatting program: Kai Harrekilde-Petersen, khp@mic.dth.dk (from February '94) Cesare Mastroianni, cece@dist.dist.unige.it ftape driver proper: Bas Laarhoven, bas@vimec.nl ECC code: (don't join in, we're enough already) David Mosberger-Tang, davidm@cs.arizona.edu Ning Mosberger-Tang, tn@cs.arizona.edu Kai Harrekilde-Petersen, khp@mic.dth.dk Bas Laarhoven, bas@vimec.nl ftape-HOWTO: Kai Harrekilde-Petersen, ftape@mic.dth.dk QIC-80 logical format (r/w of DOS compatible backups, starts Feb '94): Kai Harrekilde-Petersen, khp@mic.dth.dk /**************** T H E E N D O F f t a p e - H O W T O ***************/ Kai -- Kai Harrekilde-Petersen / ftape@mic.dth.dk / Linux ftape-HOWTO maintainer Inside every little problem there's a BIG problem, struggling to get out.