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.

                                                                                         ELFRC(1)