ctf: Import ctf.h from OpenBSD

[markj]

Summary

Use it instead of the existing ctf.h from OpenSolaris. This makes it
easier to use CTF in the core kernel, and to extend the CTF format to
support wider type IDs.

The imported ctf.h is modified to depend only on _types.h, and also to
provide macros which use the "parent" bit of a type ID to refer to types
in a parent CTF container.

No functional change intended.

[emaste]

sys/sys/ctf.h

5

I presume your changes in this file are trivial and do not warrant a copyright statement.

We should perhaps add an SPDX tag though.

tools/build/Makefile

266

sort alphabetically?

[domagoj.stolfa_gmail.com]

The original CTF header has a bunch of useful comments describing the format. Perhaps these things should be included in this header too? While I appreciate that this is an import, those comments have helped me quite a bit when dealing with CTF and IMO should be included.

[markj]

In D34358#778319, @domagoj.stolfa_gmail.com wrote:

The original CTF header has a bunch of useful comments describing the format. Perhaps these things should be included in this header too? While I appreciate that this is an import, those comments have helped me quite a bit when dealing with CTF and IMO should be included.

There is a ctf.5 man page that describes the format in much more detail than the comments did. I haven't updated it yet for v3 but will do so. Do you think it is sufficient to reference the man page here?

[emaste]

IMO it's best to avoid duplicating the documentation in multiple places and just referencing (an updated) ctf.5 here is sensible.

[domagoj.stolfa_gmail.com]

In D34358#778329, @markj wrote:

In D34358#778319, @domagoj.stolfa_gmail.com wrote:

The original CTF header has a bunch of useful comments describing the format. Perhaps these things should be included in this header too? While I appreciate that this is an import, those comments have helped me quite a bit when dealing with CTF and IMO should be included.

There is a ctf.5 man page that describes the format in much more detail than the comments did. I haven't updated it yet for v3 but will do so. Do you think it is sufficient to reference the man page here?

Yes, that sounds good to me. ctf.5 is fairly detailed, so if extended with ctfv3 and simply referencing the man page in the header would suffice IMO. Thanks!

[markj]

• Add an SPDX identifier.
• Reference the ctf(5) man page.