Return to mc68conv.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/mc68conv.1, revision 1.1

1.1     ! root        1: .SA 1
        !             2: .ds ZZ DEVELOPMENT PACKAGE
        !             3: .TH MC68CONV 1 "630 MTG"
        !             4: .SH NAME
        !             5: mc68conv \- \*N MC68000 object file converter
        !             6: .SH SYNOPSIS
        !             7: .B mc68conv
        !             8: .RB [ \- ]
        !             9: .RB [ \-a ]
        !            10: .RB [ \-o ]
        !            11: .RB [ \-p ]
        !            12: .RB [ \-s ]
        !            13: .B -t
        !            14: target files
        !            15: .SH DESCRIPTION
        !            16: The
        !            17: .I mc68conv
        !            18: command
        !            19: converts \*N object files from their current format to the format
        !            20: of the
        !            21: .I target
        !            22: machine.
        !            23: Mc68conv can read an archive file in any of three formats:
        !            24: the
        !            25: .SM UNIX
        !            26: pre-5.0 format, the 5.0 random access format, and the
        !            27: 6.0 portable
        !            28: .SM ASCII
        !            29: format.
        !            30: It produces a file in the format specified
        !            31: .RB ( -a ,
        !            32: .BR -o ,
        !            33: or
        !            34: .BR -p ).
        !            35: The converted file is written to
        !            36: file\c
        !            37: .I .v\c
        !            38: \&.
        !            39: .PP
        !            40: Command line options are:
        !            41: .PP
        !            42: .TP 12
        !            43: .BR \-
        !            44: indicates 
        !            45: .I files
        !            46: should be read from
        !            47: .I stdin\c
        !            48: \&.
        !            49: .PP
        !            50: .TP 12
        !            51: .B \-a
        !            52: If the input file is an archive, produces the ouput file in the
        !            53: 6.0 portable ASCII archive format.
        !            54: .PP
        !            55: .TP 12
        !            56: .B \-o
        !            57: If the input file is an archive, produces
        !            58: the output file in the UNIX pre-5.0 format.
        !            59: .PP
        !            60: .TP 12
        !            61: .BR \-p
        !            62: If the input file is an archive, produces the ouput file in the
        !            63: UNIX 5.0 random access archive format.
        !            64: This is the default.
        !            65: .PP
        !            66: .TP 12
        !            67: .BR \-s
        !            68: Functions exactly as 3bswab, i.e. "preswab"
        !            69: all characters in the object file.  This is useful only for AT&T
        !            70: 3B20 Computer object files which are to be "swab-dumped" from a DEC machine
        !            71: to a 3B20 Computer.
        !            72: .PP
        !            73: .TP 12
        !            74: .BR \-t " target"
        !            75: Converts the object file to the byte ordering of the 
        !            76: machine (\f2target\f1) to which the object file is being shipped.  This
        !            77: may be another host or a target machine.  Legal values for
        !            78: .I target
        !            79: are: pdp, vax, ibm, i80, x86, b16, n3b, m32, and mc68.
        !            80: .PP
        !            81: Mc68conv can be used to convert all object files in common object file
        !            82: format. It can be used on either
        !            83: the source ("sending") or target ("receiving") machine.
        !            84: .PP
        !            85: Mc68conv is meant to ease the problems created
        !            86: by a multi-host cross-compilation development environment. Mc68conv is best
        !            87: used within a procedure for shipping object files from one machine to
        !            88: another.
        !            89: .SH "EXAMPLE"
        !            90: .nf
        !            91: # ship object files from pdp11 to ibm
        !            92: $echo \(**.out | mc68conv -t ibm -$OFC\/foo.o
        !            93: $uucp \(**.v my370!~\/rje\/
        !            94: .fi
        !            95: .SH "DIAGNOSTICS"
        !            96: All diagnostics are
        !            97: intended to be self-explanatory. Fatal diagnostics on the command
        !            98: lines cause termination. Fatal diagnostics on an input file cause the
        !            99: program to continue to the next input file.
        !           100: .bp
        !           101: .SH "WARNINGS"
        !           102: .PP
        !           103: Mc68conv will not convert archives from one format to another if
        !           104: both the source and target machines have the same byte ordering.
        !           105: The
        !           106: .SM UNIX
        !           107: tool
        !           108: .IR convert (1)
        !           109: should be used for this purpose.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.