1b5b54135SJoerg Wunsch.\" Copyright (c) 1997 2b5b54135SJoerg Wunsch.\" John-Mark Gurney. All rights reserved. 3b5b54135SJoerg Wunsch.\" 4b5b54135SJoerg Wunsch.\" Redistribution and use in source and binary forms, with or without 5b5b54135SJoerg Wunsch.\" modification, are permitted provided that the following conditions 6b5b54135SJoerg Wunsch.\" are met: 7b5b54135SJoerg Wunsch.\" 1. Redistributions of source code must retain the above copyright 8b5b54135SJoerg Wunsch.\" notice, this list of conditions and the following disclaimer. 9b5b54135SJoerg Wunsch.\" 2. Redistributions in binary form must reproduce the above copyright 10b5b54135SJoerg Wunsch.\" notice, this list of conditions and the following disclaimer in the 11b5b54135SJoerg Wunsch.\" documentation and/or other materials provided with the distribution. 12b5b54135SJoerg Wunsch.\" 3. Neither the name of the author nor the names of any co-contributors 13b5b54135SJoerg Wunsch.\" may be used to endorse or promote products derived from this software 14b5b54135SJoerg Wunsch.\" without specific prior written permission. 15b5b54135SJoerg Wunsch.\" 16b5b54135SJoerg Wunsch.\" THIS SOFTWARE IS PROVIDED BY John-Mark Gurney AND CONTRIBUTORS ``AS IS'' 17b5b54135SJoerg Wunsch.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18b5b54135SJoerg Wunsch.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19b5b54135SJoerg Wunsch.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20b5b54135SJoerg Wunsch.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21b5b54135SJoerg Wunsch.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22b5b54135SJoerg Wunsch.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23b5b54135SJoerg Wunsch.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24b5b54135SJoerg Wunsch.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25b5b54135SJoerg Wunsch.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26b5b54135SJoerg Wunsch.\" SUCH DAMAGE. 27b5b54135SJoerg Wunsch.\" 28c3aac50fSPeter Wemm.\" $FreeBSD$ 29b5b54135SJoerg Wunsch.\" 30b5b54135SJoerg Wunsch.Dd February 6, 1997 31b5b54135SJoerg Wunsch.Dt BRANDELF 1 32b5b54135SJoerg Wunsch.Os FreeBSD 33b5b54135SJoerg Wunsch.Sh NAME 34b5b54135SJoerg Wunsch.Nm brandelf 35b5b54135SJoerg Wunsch.Nd mark an ELF binary for a specific ABI 36b5b54135SJoerg Wunsch.Sh SYNOPSIS 37b40ac1b5SDavid E. O'Brien.Nm 38b40ac1b5SDavid E. O'Brien.Op Fl lv 39b40ac1b5SDavid E. O'Brien.Op Fl f Ar ELF_ABI_number 40b5b54135SJoerg Wunsch.Op Fl t Ar string 41b40ac1b5SDavid E. O'Brien.Ar 42b5b54135SJoerg Wunsch.Sh DESCRIPTION 431ffa2a8eSMike PritchardThis command marks an ELF binary to be run under a certain ABI for 441ffa2a8eSMike Pritchard.Tn FreeBSD . 45b5b54135SJoerg Wunsch.Pp 46b5b54135SJoerg WunschThe options are as follows: 47b5b54135SJoerg Wunsch.Bl -tag -width Fl 48b40ac1b5SDavid E. O'Brien.It Fl f Ar ELF_ABI_number 49b40ac1b5SDavid E. O'Brienforces branding with the supplied ELF ABI number. 50b40ac1b5SDavid E. O'BrienIncompatible with the 51b40ac1b5SDavid E. O'Brien.Fl t 52b40ac1b5SDavid E. O'Brienoption. 53b40ac1b5SDavid E. O'BrienThese values are assigned by SCO/USL. 54b5ce857bSWes Peters.It Fl l 55b5ce857bSWes Peterslists all known ELF types on the standard error channel. 56b5b54135SJoerg Wunsch.It Fl v 57b40ac1b5SDavid E. O'Brienturns on verbose reporting. 58b5b54135SJoerg Wunsch.It Fl t Ar string 59c815a20cSDavid E. O'BrienBrands the given ELF binaries to be of the 60b5b54135SJoerg Wunsch.Ar string 61b40ac1b5SDavid E. O'BrienABI type. 62b40ac1b5SDavid E. O'BrienCurrently supported ABIs are 63987170f7SJeroen Ruigrok van der Werven.Dq Tn FreeBSD , 64987170f7SJeroen Ruigrok van der Werven.Dq Tn Linux , 65b5b54135SJoerg Wunschand 66987170f7SJeroen Ruigrok van der Werven.Dq Tn SVR4 . 67b5b54135SJoerg Wunsch.It Ar file 68b5b54135SJoerg WunschIf 69b5b54135SJoerg Wunsch.Fl t Ar string 70b5b54135SJoerg Wunschis given it will brand 71b5b54135SJoerg Wunsch.Ar file 72c815a20cSDavid E. O'Briento be of type 73b5b54135SJoerg Wunsch.Ar string , 74b5b54135SJoerg Wunschotherwise it will simply display the branding of 75b5b54135SJoerg Wunsch.Ar file . 76b5b54135SJoerg Wunsch.El 77b5b54135SJoerg Wunsch.Sh EXAMPLES 78b5b54135SJoerg WunschThe following is an example of a typical usage 79b5b54135SJoerg Wunschof the 80b5b54135SJoerg Wunsch.Nm 81b5b54135SJoerg Wunschcommand: 82b5b54135SJoerg Wunsch.Pp 83b5b54135SJoerg Wunsch.Dl % brandelf file 84b5b54135SJoerg Wunsch.Dl % brandelf -t Linux file 85b5b54135SJoerg Wunsch.Sh DIAGNOSTICS 86a29f1d23SMike PritchardExit status is 0 on success, and 1 if the command 87b40ac1b5SDavid E. O'Brienfails if a file does not exist, is too short, fails to brand properly, 88b5ce857bSWes Petersor the brand requested is not one of the known types and the 89e3e9c8eeSEivind Eklund.Fl f 90e3e9c8eeSEivind Eklundoption is not set. 91c815a20cSDavid E. O'Brien.Sh SEE ALSO 92c815a20cSDavid E. O'Brien.Rs 93b40ac1b5SDavid E. O'Brien.%A The Santa Cruz Operation, Inc. 94c815a20cSDavid E. O'Brien.%T System V Application Binary Interface 95c815a20cSDavid E. O'Brien.%D April 29, 1998 (DRAFT) 96c815a20cSDavid E. O'Brien.%O http://www.sco.com/developer/devspecs/ 97c815a20cSDavid E. O'Brien.Re 98b5b54135SJoerg Wunsch.Sh HISTORY 99b5b54135SJoerg WunschThe 100b5b54135SJoerg Wunsch.Nm 101b5b54135SJoerg Wunschmanual page first appeared in 102aae45304SJohn-Mark Gurney.Fx 2.2 . 103306005e7SPhilippe Charnier.Sh AUTHORS 104306005e7SPhilippe CharnierThis manual page was written by 105306005e7SPhilippe Charnier.An John-Mark Gurney Aq gurney_j@efn.org . 106