Return to elf2olf.1 CVS log

Up to [local] / src / usr.bin / elf2olf

Annotation of src/usr.bin/elf2olf/elf2olf.1, Revision 1.1

1.1     ! etheisen    1: .\"    $OpenBSD$
        !             2: .\"
        !             3: .\" Copyright (c) 1996 Erik Theisen.  All rights reserved.
        !             4: .\" Redistribution and use in source and binary forms, with or without
        !             5: .\" modification, are permitted provided that the following conditions
        !             6: .\" are met:
        !             7: .\" 1. Redistributions of source code must retain the above copyright
        !             8: .\"    notice, this list of conditions and the following disclaimer.
        !             9: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            10: .\"    notice, this list of conditions and the following disclaimer in the
        !            11: .\"    documentation and/or other materials provided with the distribution.
        !            12: .\" 3. The name of the author may not be used to endorse or promote products
        !            13: .\"    derived from this software without specific prior written permission
        !            14: .\"
        !            15: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
        !            16: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        !            17: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
        !            18: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
        !            19: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
        !            20: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
        !            21: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
        !            22: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
        !            23: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
        !            24: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        !            25: .\"
        !            26: .\"     @(#)$Id$
        !            27: .\"
        !            28: .Dd November 24, 1996
        !            29: .Dt ELF2OLF 1
        !            30: .Os OpenBSD 2.0
        !            31: .Sh NAME
        !            32: .Nm elf2olf ,
        !            33: .Nm olf2elf
        !            34: .Nd convert between ELF and OLF object module format
        !            35: .Sh SYNOPSIS
        !            36: .Nm elf2olf
        !            37: .Op Fl v
        !            38: .Op Fl o Ar opsys
        !            39: .Ar module ...
        !            40: .Nm olf2elf
        !            41: .Op Fl v
        !            42: .Ar file ...
        !            43: .Sh DESCRIPTION
        !            44: The
        !            45: .Nm elf2olf
        !            46: utility reads the specified
        !            47: .Em ELF
        !            48: version 1 module operands and converts them to the default operating system's
        !            49: .Em OLF
        !            50: object module format.
        !            51: The
        !            52: .Nm olf2elf
        !            53: utility reverses the process.
        !            54: The
        !            55: .Ar module
        !            56: operands are processed in command line order.
        !            57: .Sh OPTIONS
        !            58: The options are as follows:
        !            59: .Bl -tag -width Ds
        !            60: .It Fl v
        !            61: Operate in verbose mode.
        !            62: .It Fl o Ar opsys
        !            63: Specifies the operating system
        !            64: .Em OLF
        !            65: tag
        !            66: .Em "opsys"
        !            67: as follows:
        !            68: .Bl -tag -width Ds
        !            69: .It Ta Pa "openbsd" Ta "OpenBSD"
        !            70: .It Ta Pa "netbsd" Ta "NetBSD"
        !            71: .It Ta Pa "freebsd" Ta "FreeBSD"
        !            72: .It Ta Pa "44bsd" Ta "4.4BSD"
        !            73: .It Ta Pa "linux" Ta "Linux"
        !            74: .It Ta Pa "mach" Ta "Mach"
        !            75: .It Ta Pa "svr4" Ta "AT&T System V Release 4"
        !            76: .It Ta Pa "esix" Ta "esix UNIX"
        !            77: .It Ta Pa "solaris" Ta "SunSoft Solaris"
        !            78: .It Ta Pa "irix" Ta "SGI IRIX"
        !            79: .It Ta Pa "sco " Ta "SCO UNIX"
        !            80: .It Ta Pa "dell" Ta "DELL SVR4"
        !            81: .El
        !            82: .Pp
        !            83: The
        !            84: .Nm elf2olf
        !            85: and
        !            86: .Nm olf2elf
        !            87: utilities exit 0 on success, and >0 if an error occurs.
        !            88: .Sh BUGS
        !            89: The
        !            90: .Em ELF
        !            91: version 1 object module format lacks any real method to determine the native
        !            92: operating system for any given binary thus mandating the existance of these
        !            93: tools.
        !            94: The converted binaries created by
        !            95: .Nm elf2olf
        !            96: will no longer execute on their native operating system, only on OLF
        !            97: enabled platforms, although
        !            98: .Nm olf2elf
        !            99: will undo the damage.
        !           100: .Sh SEE ALSO
        !           101: .Xr elf 5 ,
        !           102: .Xr olf 5
        !           103: .Sh AUTHOR
        !           104: Erik Theisen
        !           105: .Sh HISTORY
        !           106: The
        !           107: .Nm elf2olf
        !           108: and
        !           109: .Nm olf2elf
        !           110: utility first appeared in OpenBSD 2.0.