Index: docs/CommandGuide/llvm-objcopy.rst =================================================================== --- docs/CommandGuide/llvm-objcopy.rst +++ docs/CommandGuide/llvm-objcopy.rst @@ -460,6 +460,21 @@ Additionally, all targets except ``binary`` and ``ihex`` can have ``-freebsd`` as a suffix. +BINARY INPUT AND OUTPUT +----------------------- + +If ``binary`` is used as the value for :option:`--input-target`, the input file +will be embedded as a data section in an ELF relocatable object, with symbols +``_binary__start``, ``_binary__end``, and +``_binary__size`` representing the start, end and size of the data, +where ```` is the path of the input file as specified on the command +line with non-alphanumeric characters converted to ``_``. + +If ``binary`` is used as the value for :option:`--output-target`, the output +file will be a raw binary file, containing the memory image of the input file. +Symbols and relocation information will be discarded. The image will start at +the address of the first loadable section in the output. + EXIT STATUS -----------