10.2;obj2coff, revision 1.0, 88/04/20
obj2coff - convert OBJ format modules to COFF format modules
usage: obj2coff 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
More information is available. Type
help lbr2ar
for information on converting lbr libraries to SR10 archive libraries.