conv(1) — A/UX 3.0.1




conv(1)                                                   conv(1)



NAME
     conv - swaps bytes in COFF files

SYNOPSIS
     conv [-] [-a] [-o] [-p] [-s] -ttarget file...

ARGUMENTS
     -    Reads files from standard input.

     -a   Produces the output file in the old archive format, if
          the input file is an archive.

     file Specifies the converted file.

     -o   Produces the output file in the UNIX 6.0 (Version 6)
          portable archive format, if the input file is an
          archive.

     -p   Specifies the UNIX V.0 random access archive format.
          This is the default.

     -s   Byte-swaps all bytes in object file.  This is useful
          only for 3B20 object files which are to be swab-dumped
          from a DEC machine to a 3B20.

     -ttarget
          Converts 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, i86, x86,
          b16, n3b, m32, and m68k.

DESCRIPTION
     conv converts object files from their current format to the
     format of the target machine.  The converted file is written
     to file.v.

     The conv command can be used to convert all object files in
     common object file format.  It can be used on either the
     source (sending) or target (receiving) machine.

     The conv command is meant to ease the problems created by a
     multihost 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 UNIX pre-V.0 format, the V.0 random
     access format, and the 6.0 portable ASCII.






January 1992                                                    1




conv(1)                                                   conv(1)



EXAMPLES
     The following shows how this command is used:

        echo *.out | conv - -t m68k


STATUS MESSAGES AND VALUES
     All messages for the conv command are intended to be self-
     explanatory.  Fatal messages on the command lines cause
     termination.  Fatal messages on an input file cause the
     program to continue to the next input file.

WARNINGS
     The conv command does not convert archives from one format
     to another if both the source and target machines have the
     same byte ordering.

FILES
     /bin/conv
          Executable file



































2                                                    January 1992

Museum