CONV(1)       (Software Generation System Utilities)      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
       written 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.


  Page 1                                                   May 1989

  CONV(1)       (Software Generation System Utilities)      CONV(1)



       The conv command will recognize and produce archive files in
       three formats:  the pre-UNIX System V format, the UNIX
       System 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.

  EXAMPLE
       To ship object files from a VAX to a 3B2 Computer, execute
       the following commands:

            conv -t m32 *.out

            uucp *.out.v my3b2!~/rje/

  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.  You should use convert(1) for this
       purpose.

  SEE ALSO
       ar(1), convert(1), ar(4), a.out(4).






  Page 2                                                   May 1989