NAME¶
elfrc — a resource compiler for ELF systems
SYNOPSIS¶
elfrc [
-o filename] [-h filename]
[ -v ]
DESCRIPTION¶
This manual page documents briefly the
elfrc command.
This manual page was written for the
Debian distribution because the
original program does not have a manual page.
elfrc is a program which can turn arbitrary files into ELF object files
which can then be linked into your program directly and accessed via simple,
user-defined symbol names.
For instance, it's possible to embed even huge (16MB+) files directly into the
executable and then access the data in constant time without making the
compiler or linker eat loads of memory.
OPTIONS¶
Here's what the arguments do:
- -o filename
- Store resulting ELF object in filename. If not given, no ELF object
will be generated.
- -h filename
- Store C header file which can be used to access the resource data in
filename. If not given, no header file will be generated.
- -v
- Be a little verbose about what's going on.
In any case, the most important argument is
resfile - the path to a
resource file which can be parsed by elfrc. If no resource file is given, or
if "-" (a dash) is given, the resources will be read from the
standard input.
A resource file is just a plain text file, each line in the file describing a
resource to be compiled into the ELF output. Each line is expected to three
fields, separated by tab characters: the type of the resource (can be either
'binary' or 'text'), the symbol name (this should be a valid C identifier) and
the path to the file to be compiled in.
AUTHOR¶
This manual page was written by Kumar Appaiah akumar@ee.iitm.ac.in for the
Debian system (but may be used by others). Permission is granted to
copy, distribute and/or modify this document under the terms of the GNU
General Public License, Version 2 any later version published by the Free
Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be
found in /usr/share/common-licenses/GPL.