xref: /freebsd/usr.bin/brandelf/brandelf.1 (revision 6c7216df785592bb069469113f556dfd1946ed5d)
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
3262500372SRuslan Ermilov.Os
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
44b5c508fbSRuslan Ermilov.Fx .
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
63b5c508fbSRuslan Ermilov.Dq Fx ,
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
776c7216dfSRuslan Ermilov.Sh EXIT STATUS
786c7216dfSRuslan ErmilovExit status is 0 on success, and 1 if the command
796c7216dfSRuslan Ermilovfails if a file does not exist, is too short, fails to brand properly,
806c7216dfSRuslan Ermilovor the brand requested is not one of the known types and the
816c7216dfSRuslan Ermilov.Fl f
826c7216dfSRuslan Ermilovoption is not set.
83b5b54135SJoerg Wunsch.Sh EXAMPLES
84b5b54135SJoerg WunschThe following is an example of a typical usage
85b5b54135SJoerg Wunschof the
86b5b54135SJoerg Wunsch.Nm
87b5b54135SJoerg Wunschcommand:
88b5b54135SJoerg Wunsch.Pp
89b5b54135SJoerg Wunsch.Dl % brandelf file
90b5b54135SJoerg Wunsch.Dl % brandelf -t Linux file
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