xref: /freebsd/usr.bin/brandelf/brandelf.1 (revision 315ee00f)
1.\" Copyright 1997 John-Mark Gurney.  All rights reserved.
2.\"
3.\" Redistribution and use in source and binary forms, with or without
4.\" modification, are permitted provided that the following conditions
5.\" are met:
6.\" 1. Redistributions of source code must retain the above copyright
7.\"    notice, this list of conditions and the following disclaimer.
8.\" 2. Redistributions in binary form must reproduce the above copyright
9.\"    notice, this list of conditions and the following disclaimer in the
10.\"    documentation and/or other materials provided with the distribution.
11.\"
12.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS''
13.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22.\" SUCH DAMAGE.
23.\"
24.Dd March 25, 2014
25.Dt BRANDELF 1
26.Os
27.Sh NAME
28.Nm brandelf
29.Nd mark an ELF binary for a specific ABI
30.Sh SYNOPSIS
31.Nm
32.Op Fl lv
33.Op Fl f Ar ELF_ABI_number
34.Op Fl t Ar string
35.Ar
36.Sh DESCRIPTION
37The
38.Nm
39utility marks an ELF binary to be run under a certain ABI for
40.Fx .
41.Pp
42The options are as follows:
43.Bl -tag -width indent
44.It Fl f Ar ELF_ABI_number
45Forces branding with the supplied ELF ABI number.
46Incompatible with the
47.Fl t
48option.
49These values are assigned by SCO/USL.
50.It Fl l
51Writes the list of all known ELF types to the standard error.
52.It Fl v
53Turns on verbose output.
54.It Fl t Ar string
55Brands the given ELF binaries to be of the
56.Ar string
57ABI type.
58Currently supported ABIs are
59.Dq Li FreeBSD ,
60.Dq Li Linux ,
61and
62.Dq Li SVR4 .
63.It Ar file
64If
65.Fl t Ar string
66is given it will brand
67.Ar file
68to be of type
69.Ar string ,
70otherwise it will simply display the branding of
71.Ar file .
72.El
73.Sh EXIT STATUS
74Exit status is 0 on success, and 1 if the command
75fails if a file does not exist, is too short, fails to brand properly,
76or the brand requested is not one of the known types and the
77.Fl f
78option is not set.
79.Sh EXAMPLES
80The following is an example of a typical usage
81of the
82.Nm
83command:
84.Bd -literal -offset indent
85brandelf file
86brandelf -t Linux file
87.Ed
88.Sh SEE ALSO
89.Rs
90.%A The Santa Cruz Operation, Inc.
91.%T System V Application Binary Interface
92.%D April 29, 1998 (DRAFT)
93.%U http://www.sco.com/developers/devspecs/
94.Re
95.Sh HISTORY
96The
97.Nm
98manual page first appeared in
99.Fx 2.2 .
100.Sh AUTHORS
101This manual page was written by
102.An John-Mark Gurney Aq Mt jmg@FreeBSD.org .
103