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

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.