Index: llvm/trunk/docs/CommandGuide/llvm-objcopy.rst =================================================================== --- llvm/trunk/docs/CommandGuide/llvm-objcopy.rst +++ llvm/trunk/docs/CommandGuide/llvm-objcopy.rst @@ -457,8 +457,23 @@ - `elf32-sparc` - `elf32-sparcel` -Additionally, all targets except ``binary`` and ``ihex`` can have ``-freebsd`` -as a suffix. +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 -----------