Name
       wdat - read DAT tapes in Adonis format

Synopsis
       wdat [-d device] [-h] [-nr] [-l]
            [-l= file] [-fits] [-log]
            [-e= file] [-e MASK] [-s= file]
            [-s= MASK] [-q]

Description
       wdat  reads  DAT tapes written in Adonis format. The Unix tar format is
       almost universal, but is not that convenient. It is especially delicate
       to get anything out of a tape which had a problem. To prevent this, the
       Adonis format uses separate files for each data cube. In case  of  tape
       damage,  it  is most likely that just one file would be lost instead of
       all files after the damaged location. Another nice thing is that  files
       can be read on the fly and thus deliver information to the user as soon
       as it is read.

       wdat accepts many options on command-line. Use them to  indicate  which
       device you read the tape from, which files you want to include/exclude,
       if you only want to get a list of files, if you  want  to  be  notified
       before downloading a file, etc. Check below.

Options
       -d device
              where device is the Unix name of the DAT reader on your machine.
              It is most often something like /dev/nrst0 or the like.  Default
              value is the content of the TAPE environment variable.

       -h     Gives help about wdat

       -nr    Does not rewind the tape before first access.

       -l     list option, only lists DAT contents on terminal.

       -l= listfile
              list option, only lists DAT contents to file ’listfile’.

       -fits  Skips files if they are not FITS files.

       -log   Automatically translates logfiles (.LOG) from OS-9.

       -e= exfile
              exclude  option,  will  exclude from downloading all files which
              name has been matched in exfile.

       -e MASK
              will exclude all files matching the mask. A  mask  is  a  simple
              character  string, all file names containing this string will be
              excluded.

       -s= selfile
              select option, will select for downloading all files which  name
              has been matched in selfile.

       -s MASK
              will  load all files matching the mask. A mask is a simple char-
              acter string, only file names containing  this  string  will  be
              loaded.

       -q     query option, will request user confirmation before any download
              of a file.

Files
       Selected/excluded files are simple plain ASCII  files  containing  file
       names  you  want  to  select/exclude in the following format: names are
       written plainly in ASCII, and are separated by carriage returns  (other
       normal separators would work as well).

Example
       First,  get  the  list  of  all  files  on the tape from a device named
       /dev/nrst0:
       wdat -d /dev/nrst0 -l= mylistfile
       Then edit the file to download only the files you  wish  to,  with  any
       text  editor.  Extra white spaces are not important. The selection file
       shall look like:

       ADONISFILE_0001.FITS
       ADONISFILE_0002.FITS
       ...

       Then, to download only these:
       wdat -d /dev/nrst0 -s= mylistfile

Bugs
       To be reported as soon as possible to the author:
       Francois Lacombe, Observatoire de Paris-Meudon.
       e-mail : Francois.Lacombe@obspm.fr