www.delorie.com/gnu/docs/gdb/gdbint_73.html

search

	Buy the book!

GDB Internals

9.11 Converting an existing Target Architecture to Multi-arch

This section describes the current accepted best practice for converting an existing target architecture to the multi-arch framework.

The process consists of generating, testing, posting and committing a sequence of patches. Each patch must contain a single change, for instance:

• Directly convert a group of functions into macros (the conversion does not change the behavior of any of the functions).

• Replace a non-multi-arch with a multi-arch mechanism (e.g., FRAME_INFO).

• Enable multi-arch level one.

• Delete one or more files.

There isn't a size limit on a patch, however, a developer is strongly encouraged to keep the patch size down.

Since each patch is well defined, and since each change has been tested and shows no regressions, the patches are considered fairly obvious. Such patches, when submitted by developers listed in the `MAINTAINERS' file, do not need approval. Occasional steps in the process may be more complicated and less clear. The developer is expected to use their judgment and is encouraged to seek advice as needed.