CONV(1) INTERACTIVE UNIX System CONV(1)
NAME
conv - common object file converter
SYNOPSIS
conv [-a] [-o] [-p] -t target [- | files]
DESCRIPTION
The conv command converts object files in the common object
file format from their current byte ordering to the byte
ordering of the target machine. The converted file is writ-
ten to file.v. The conv command can be used on either the
source (sending) or target (receiving) machine.
Command line options are:
- Indicates that the names of files should be read
from the standard input.
-a If the input file is an archive, produce the
output file in the UNIX System V Release 2.0
portable archive format.
-o If the input file is an archive, produce the
output file in the old (pre- UNIX System V)
archive format.
-p If the input file is an archive, produce the
output file in the UNIX System V Release 1.0
random access archive format.
-t target Convert the object file to the byte ordering of
the machine (target) to which the object file is
being shipped. This may be another host or a
target machine. Legal values for target are:
pdp, vax, ibm, x86, b16, n3b, mc68, and m32.
The conv command is meant to ease the problems created by a
multi-host, cross-compilation development environment. The
conv command is best used within a procedure for shipping
object files from one machine to another.
The conv command will recognize and produce archive files in
three formats: the pre- UNIX System V format, the UNIX Sys-
tem V Release 1.0 random access format, and the UNIX System
V Release 2.0 portable ASCII format. By default, conv will
create the output archive file in the same format as the
input file. To produce an output file in a different format
than the input file, use the -a, -o, or -p option. If the
output archive format is the same as the input format, the
archive symbol table will be converted, otherwise the symbol
table will be stripped from the archive. The ar(1) command
with its -t and -s options must be used on the target
machine to recreate the archive symbol table.
Rev. C Software Development Set Page 1
CONV(1) INTERACTIVE UNIX System CONV(1)
EXAMPLE
To ship object files from a VAX computer sytem to a 3B2 com-
puter, execute the following commands:
conv -t m32 *.out
uucp *.out.v my3b2!~/rje/
Rev. C Software Development Set Page 2
CONV(1) INTERACTIVE UNIX System CONV(1)
SEE ALSO
ar(1), convert(1), ar(4), a.out(4).
DIAGNOSTICS
The diagnostics are self-explanatory. Fatal diagnostics on
the command lines cause termination. Fatal diagnostics on
an input file cause the program to continue to the next
input file.
CAVEATS
The conv command will not convert archives from one format
to another if both the source and target machines have the
same byte ordering. The UNIX system tool convert(1) should
be used for this purpose.
Rev. C Software Development Set Page 3