read_tape - Reads volume dumps from a backup tape to a file

       Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>

       This  documentation  is  covered by the BSD License as written in the doc/LICENSE file. This man page was
       written by Jason Edgecombe for OpenAFS.

OpenAFS                                            2025-03-21                                       READ_TAPE(8)

read_tape reads an OpenAFS backup tape and prompts for each dump file to save.  This command does not
       require any OpenAFS infrastructure.  This command does not need an OpenAFS client or server to be
       available, which is not the case with the backup(8) command.

       The dump files will be named for the Read/Write name of the volume restored.  After saving each dump
       file, vosrestore or restorevol can be used to restore the volume into AFS and non-AFS space
       respectively.

       read_tape reads the tape while skipping the specified number of volumes.  After that, it restores the
       specified number of volumes.  read_tape doesn't rewind the tape so that it may be used multiple times in
       succession.

       The following command will read the third through fifth volumes from the tape  device  /dev/tape  without
       prompting:

          % read_tape -tape /dev/tape -skip 2 -restore 3 -noask

       read_tape - Reads volume dumps from a backup tape to a file

-tape <tapedevice>
           Specifies the tape device from which to restore.

       -restore <#ofvolumestorestore>
           Specifies the number of volumes to restore from tape.

       -skip <#ofvolumestoskip>
           Specifies the number of volumes to skip before starting the restore.

       -file <filename>
           Specifies  an  alternate name for the restored volume dump file rather than the default of the volume
           name.

       -scan
           Scans the tape.

       -noask
           Doesn't prompt for each volume.

       -label
           Displays the full dump label.

       -vheaders
           Displays the full volume headers.

       -verbose
           Produces on the standard output stream a detailed trace of the command's execution.  If this argument
           is omitted, only warnings and error messages appear.

       -help
           Prints the online help for this command. All other valid options are ignored.

       The issuer must have access to read and write to the specified tape device.

backup(8), restorevol(1), vos_restore(1)

read_tape-tape <tapedevice>
          -restore <#ofvolumestorestore>
          -skip <#ofvolumestoskip>
          -file <filename> [-scan] [-noask] [-label]
          [-vheaders] [-verbose] [-help]