OBJ2COFF(1)                     Domain/OS SysV                     OBJ2COFF(1)




NAME
     obj2coff - convert OBJ format modules to COFF format modules

SYNOPSIS
     obj2coff [-A cpu,a88k] objmodule coffmodule

DESCRIPTION
     The obj2coff command converts OBJ files created under SR9.5 or later
     versions of Domain/OS to COFF files.  obj2coff can convert individual
     modules or complete bound programs.

     OBJ is the format used by all object files produced before SR10.  Object
     files produced under SR10 and later versions of Domain/OS are in the COFF
     format. OBJ files will run under SR10, but many Apollo tools, including
     the linkers bind and ld, accept only COFF files as input.

     With the -A cpu,a88k option, obj2coff marks the COFF output file as
     executable on Series 10000 workstations.  Use this option only on data
     modules, not on modules containing code.  obj2coff will not convert
     MC680x0 instructions to PRISM instructions.

     The obj2coff command cannot convert object module libraries.  See
     lbr2ar(1) for that purpose.

WARNINGS
     If obj2coff encounters an object module stamped with an SR8 systype
     (sys3, bsd4.1, or any SR8), it converts the module to COFF and issues the
     following warning:

     module is stamped with obsolete systype 'systype_name'

     The .sri section of the COFF file will specify the obsolete systype.

     obj2coff uses System V Release 3 and 4.3BSD semantics for all UNIX system
     calls.  Some UNIX system calls may behave differently between Sys3 and
     SysV or between 4.1BSD and 4.3BSD, however.  If you are converting a Sys3
     or 4.1BSD object module to COFF, examine your source code carefully to
     avoid errors due to differences in call semantics.

     OBJ files use stream 2 for error input and stream 3 for error output.
     COFF files use stream 2 for error output and have no automatically
     assigned stream for error input.  A file converted from OBJ to COFF,
     therefore, may fail in an attempt to read error input and may generate
     the following error in writing error output:

     operation attempted on unopened stream


SEE ALSO
     lbr2ar(1)