Man pages sections > man1 > elfrc

elfrc — a resource compiler for ELF systems

ELFRC(1) General Commands Manual ELFRC(1)

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.
 
Debian Sid