ansitape.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ANSITAPE(1M) ANSITAPE(1M)

NAME

ansitape - ANSI-standard magtape label program

SYNOPSIS

ansitape txrcpuA[vqfaei3][mt=device][

vo=volume-name][wo=output_ﬁle]

[

rs= [r|recordsize]] [

bs=blocksize][rf=[v|f]] [cc=[i|f|

e]] ﬁlename1 ﬁlename2 ...

DESCRIPTION

Ansitape reads, writes, and creates magtapes conforming to the ANSI standard for magtape labelling.

Primarily, this is useful to exchange tapes with VAX/VMS, which makes this kind of tape by default.

Ansitape is controlled by a function key letter (

t, x, c,orr). Various options modify the format of the

output tape.

Writing ANSI Tapes

The list of ﬁles on the command line is written to the tape. A full Unix pathname may be speciﬁed, how-

ever, only the last pathname component (everything after the last

/) is used as the ﬁlename on the tape.

Normally, regular text ﬁles are to be exchanged.

ansitape reads the ﬁles one line at a time and

transfers them to the tape. The newline character at the end of each line is removed, and the ﬁle is writ-

ten in a variable-length record format. Variable-format ﬁles have the length of the longest record

speciﬁed in a ﬁle header. Therefore,

ansitape will read each input ﬁle from disk before it goes on to

tape, to determine the maximum record size. The read is skipped if the ﬁle is more than 100,000 bytes

long. The default carriage control (implied) instructs the other host to restore the newline character

before printing the record.

ansitape thinks that the input ﬁle is a Unix text ﬁle (Fortran or implied carriage control), it will

automatically strip the the Unix newline from the end of each record. No strip is done with embedded

carriage control ﬁles, or with any ﬁle using a ﬁxed-length record format.

For binary ﬁles, ﬁxed-length records should be used. VAX/VMS normally uses a record length of 512

bytes for things like directories and executable ﬁles, but data ﬁles may have any record length. Binary

ﬁles should be ﬂagged for embedded (rf=e) carriage control.

Reading ANSI Tapes

When reading, the input ﬁle list is presumed to be the names of ﬁles to be extracted from the tape. The

shell wildcard characters asterisk (*) and question-mark (

?) may be used. Of course, they must be

quoted to prevent the shell from interpreting them before

ansitape sees them.

None of the options for record format or carriage control need be speciﬁed when reading ﬁles.

Ansi-

tape will automatically pick up this information from the header records on the tape, and do the right

thing. If you can’t get just what you want from ansitape, the resulting ﬁles may be run through dd(1).

FUNCTION LETTERS

These function letters describe the overall operation desired. One of them must be speciﬁed in the ﬁrst

argument to

ansitape. For lexically rigorous Unix fans, a minus sign (-) is allowed, but optional, to

introduce the ﬁrst keyword option set.

r Write the named ﬁles on the end of the tape. This requires that the tape have been previously ini-

tialized with an ANSI volume header.

c Create a new magtape. The tape is initialized with a new ANSI volume header. All ﬁles previ-

ously on the tape are destroyed. This option implies r.

p This option is used with option c or r to create ANSI labels for Ignite-UX recovery tape only. It

requires a non rewind tape device ﬁle.

x Extract all ﬁles from the tape. Files are placed in the current directory. Protection is r/w to every-

one, modiﬁed by the current umask(2).

t List all of the names on the tape.

u This option is used to write an ANSI label UHL3EFIAUX header for an Ignite-UX recovery tape.

A This option is used to create an Ignite-UX recovery tape archive label.

MODIFIER KEY LETTERS

These key letters are part of the ﬁrst argument to

ansitape.

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
ANSITAPE(1M) ANSITAPE(1M) NAME ansitape - ANSI-standard magtape label program SYNOPSIS ansitape txrcpuA[vqfaei3] [mt=device] [vo=volume-name] [wo=output_file] [rs= [r|recordsize]] [bs=blocksize] [rf=[v|f]] [cc=[i|f|e]] filename1 filename2 ... DESCRIPTION Ansitape reads, writes, and creates magtapes conforming to the ANSI standard for magtape labelling. Primarily, this is useful to exchange tapes with VAX/VMS, which makes this kind of tape by default.
PAGE 2
ANSITAPE(1M) ANSITAPE(1M) v Normally ansitape does its work silently; the v (verbose) option displays the name of each file ansitape treats, preceded by the function letter. It also displays the volume name of each tape as it is mounted. When used with the t option, ansitape displays the number of tape blocks used by each file, the record format, and the carriage control option. q Query before writing anything. On write (c or r options), this causes ansitape to ask before writing to the tape.
PAGE 3
ANSITAPE(1M) ANSITAPE(1M) bs=blocksize Specify the output blocksize , in bytes. As many records as will fit are crammed into each physical tape block. ANSI standards limit this to 2048 bytes (the default), but you may specify more or less. Be advised that specifying more may prevent some systems from reading the tape. rf=v Record format is variable-length. In other words, they are text files. This is the default, and should be left alone unless you really know what you’re doing.
PAGE 4
(Notes) 4 Hewlett-Packard Company (Notes) −1− HP-UX 11i Version 3: March 2012