Open the tape device and try to determine whether is is a floppy tape.
Arguments |
| ||||||||||||
Return Value
|
The function returns | ||||||||||||
Side effects
|
In case of an error an error string is generated and remembered. Also, a
string identifying the drive type is remembered. Both can be retrieved
by a call to | ||||||||||||
Diagnostics
|
The following error messages are generated by
| ||||||||||||
Example
|
|
Rewind the cartridge and close the tape device.
Arguments |
| ||||
Return Value
|
The function returns | ||||
Side effects
|
The tape cartridge is rewound. In case of an error an error string is
generated and remembered. It can be retrieved by a call to
| ||||
Diagnostics
|
The following error messages are generated by
| ||||
Example
|
|
Read the header segment.
Arguments |
| |||||
Return Value
|
The format code of the tape, or | |||||
Side effects
|
In case of an error an error string is generated and remembered. It can be
retrieved by a call to | |||||
Diagnostics
|
The following error messages are generated by
|
Read the volume table.
Arguments |
| ||||||||||
Return Value
|
The number of volumes found in the volume table segment, or | ||||||||||
Side effects
|
The internal variable
In case of an error an error string is generated and remebered. It can be
retrieved by a call to | ||||||||||
Diagnostics
|
The following error messages are generated by
| ||||||||||
Ioctl error reading volume table: ERROR
|
The | ||||||||||
Error reading volume table: ERROR
|
The | ||||||||||
Warning: Short read() reading volume table: BYTES.
| |||||||||||
Continuing, but you can use only MAX volumes (instead of 232)
|
The volume table has been read in, but the size of the segment holding the volume table is smaller than expected. This is only a warning. |
Read the volume table. This function first reads the header segment of the tape cartridge by calling ftvt_read_header_segment() and then attempts to read the volume table segment by calling ftvt_read_vtbl().
Arguments |
| |||||||
Return Value
|
The number of volumes found in the volume table segment, or | |||||||
Side effects
|
The internal variable
In case of an error an error string is generated and remembered. It can
be retrieved by a call to | |||||||
Diagnostics
|
The following error messages are generated by
| |||||||
Example
|
|
Flush the volume table to tape. Note that we try to preserve as much of
the original volume table as possible. For this reason, BUFFER
must be a pointer to the area previously filled by
ftvt_read()
. Only those entries are copied from VOLUMES to
BUFFER which have been modified by the library. If no entry has
been modified, the volume table isn't written back to tape
unless DO_WRITE is set to 1
.
Arguments |
| ||||||||||
Return Value
|
| ||||||||||
Side Effects
|
The tape is rewound after trying to write the volume table.
In case of an error an error string is generated and remembered. It can
be retrieved by a call to | ||||||||||
Diagnostics
|
The following error messages are generated by
| ||||||||||
Example
|
|
![]() |
Use these buttons to jump to the top menu |