You copied the Doc URL to your clipboard.

21.46 INCBIN

The INCBIN directive includes a file within the file being assembled. The file is included as it is, without being assembled.


INCBIN filename



is the name of the file to be included in the assembly.The assembler accepts pathnames in either UNIX or MS-DOS format.


You can use INCBIN to include executablefiles, literals, or any arbitrary data. The contents of the fileare added to the current ELF section, byte for byte, without beinginterpreted in any way. Assembly continues at the line followingthe INCBIN directive.

By default, the assembler searches the current place for included files. The current place is the directory where the calling file is located. Use the -i assembler command-line option to add directories to the search path. File names and directory names containing spaces must not be enclosed in double quotes ( " " ).


     AREA    Example, CODE, READONLY     INCBIN  file1.dat              ; Includes file1 if it exists in the current place     INCBIN  c:\project\file2.txt   ; Includes file2.
Was this page helpful? Yes No