xenial (1) elfrc.1.gz

Provided by: elfrc_0.7-2_amd64 bug

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)