17ffbbd98SJohn-Mark Gurney.\" Copyright 1997 John-Mark Gurney. All rights reserved. 2b5b54135SJoerg Wunsch.\" 3b5b54135SJoerg Wunsch.\" Redistribution and use in source and binary forms, with or without 4b5b54135SJoerg Wunsch.\" modification, are permitted provided that the following conditions 5b5b54135SJoerg Wunsch.\" are met: 6b5b54135SJoerg Wunsch.\" 1. Redistributions of source code must retain the above copyright 7b5b54135SJoerg Wunsch.\" notice, this list of conditions and the following disclaimer. 8b5b54135SJoerg Wunsch.\" 2. Redistributions in binary form must reproduce the above copyright 9b5b54135SJoerg Wunsch.\" notice, this list of conditions and the following disclaimer in the 10b5b54135SJoerg Wunsch.\" documentation and/or other materials provided with the distribution. 11b5b54135SJoerg Wunsch.\" 12ad6fe9faSEd Maste.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' 13b5b54135SJoerg Wunsch.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 14b5b54135SJoerg Wunsch.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 15b5b54135SJoerg Wunsch.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 16b5b54135SJoerg Wunsch.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 17b5b54135SJoerg Wunsch.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 18b5b54135SJoerg Wunsch.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 19b5b54135SJoerg Wunsch.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 20b5b54135SJoerg Wunsch.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 21b5b54135SJoerg Wunsch.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 22b5b54135SJoerg Wunsch.\" SUCH DAMAGE. 23b5b54135SJoerg Wunsch.\" 240740b812SJohn-Mark Gurney.Dd March 25, 2014 25b5b54135SJoerg Wunsch.Dt BRANDELF 1 2662500372SRuslan Ermilov.Os 27b5b54135SJoerg Wunsch.Sh NAME 28b5b54135SJoerg Wunsch.Nm brandelf 29b5b54135SJoerg Wunsch.Nd mark an ELF binary for a specific ABI 30b5b54135SJoerg Wunsch.Sh SYNOPSIS 31b40ac1b5SDavid E. O'Brien.Nm 32b40ac1b5SDavid E. O'Brien.Op Fl lv 33b40ac1b5SDavid E. O'Brien.Op Fl f Ar ELF_ABI_number 34b5b54135SJoerg Wunsch.Op Fl t Ar string 35b40ac1b5SDavid E. O'Brien.Ar 36b5b54135SJoerg Wunsch.Sh DESCRIPTION 37087d64deSRuslan ErmilovThe 38087d64deSRuslan Ermilov.Nm 39087d64deSRuslan Ermilovutility marks an ELF binary to be run under a certain ABI for 40b5c508fbSRuslan Ermilov.Fx . 41b5b54135SJoerg Wunsch.Pp 42b5b54135SJoerg WunschThe options are as follows: 43087d64deSRuslan Ermilov.Bl -tag -width indent 44b40ac1b5SDavid E. O'Brien.It Fl f Ar ELF_ABI_number 45087d64deSRuslan ErmilovForces branding with the supplied ELF ABI number. 46b40ac1b5SDavid E. O'BrienIncompatible with the 47b40ac1b5SDavid E. O'Brien.Fl t 48b40ac1b5SDavid E. O'Brienoption. 49b40ac1b5SDavid E. O'BrienThese values are assigned by SCO/USL. 50b5ce857bSWes Peters.It Fl l 51087d64deSRuslan ErmilovWrites the list of all known ELF types to the standard error. 52b5b54135SJoerg Wunsch.It Fl v 53087d64deSRuslan ErmilovTurns on verbose output. 54b5b54135SJoerg Wunsch.It Fl t Ar string 55c815a20cSDavid E. O'BrienBrands the given ELF binaries to be of the 56b5b54135SJoerg Wunsch.Ar string 57b40ac1b5SDavid E. O'BrienABI type. 58b40ac1b5SDavid E. O'BrienCurrently supported ABIs are 59087d64deSRuslan Ermilov.Dq Li FreeBSD , 60087d64deSRuslan Ermilov.Dq Li Linux , 61b5b54135SJoerg Wunschand 62087d64deSRuslan Ermilov.Dq Li SVR4 . 63b5b54135SJoerg Wunsch.It Ar file 64b5b54135SJoerg WunschIf 65b5b54135SJoerg Wunsch.Fl t Ar string 66b5b54135SJoerg Wunschis given it will brand 67b5b54135SJoerg Wunsch.Ar file 68c815a20cSDavid E. O'Briento be of type 69b5b54135SJoerg Wunsch.Ar string , 70b5b54135SJoerg Wunschotherwise it will simply display the branding of 71b5b54135SJoerg Wunsch.Ar file . 72b5b54135SJoerg Wunsch.El 736c7216dfSRuslan Ermilov.Sh EXIT STATUS 746c7216dfSRuslan ErmilovExit status is 0 on success, and 1 if the command 756c7216dfSRuslan Ermilovfails if a file does not exist, is too short, fails to brand properly, 766c7216dfSRuslan Ermilovor the brand requested is not one of the known types and the 776c7216dfSRuslan Ermilov.Fl f 786c7216dfSRuslan Ermilovoption is not set. 79b5b54135SJoerg Wunsch.Sh EXAMPLES 80b5b54135SJoerg WunschThe following is an example of a typical usage 81b5b54135SJoerg Wunschof the 82b5b54135SJoerg Wunsch.Nm 83b5b54135SJoerg Wunschcommand: 84087d64deSRuslan Ermilov.Bd -literal -offset indent 85087d64deSRuslan Ermilovbrandelf file 86087d64deSRuslan Ermilovbrandelf -t Linux file 87087d64deSRuslan Ermilov.Ed 88c815a20cSDavid E. O'Brien.Sh SEE ALSO 89c815a20cSDavid E. O'Brien.Rs 90b40ac1b5SDavid E. O'Brien.%A The Santa Cruz Operation, Inc. 91c815a20cSDavid E. O'Brien.%T System V Application Binary Interface 92c815a20cSDavid E. O'Brien.%D April 29, 1998 (DRAFT) 93*153dd4baSWolfram Schneider.%U http://www.sco.com/developers/devspecs/ 94c815a20cSDavid E. O'Brien.Re 95b5b54135SJoerg Wunsch.Sh HISTORY 96b5b54135SJoerg WunschThe 97b5b54135SJoerg Wunsch.Nm 98b5b54135SJoerg Wunschmanual page first appeared in 99aae45304SJohn-Mark Gurney.Fx 2.2 . 100306005e7SPhilippe Charnier.Sh AUTHORS 101306005e7SPhilippe CharnierThis manual page was written by 1022b7af31cSBaptiste Daroussin.An John-Mark Gurney Aq Mt jmg@FreeBSD.org . 103