This is an archive of the discontinued LLVM Phabricator instance.

[clang][Fuchsia] Support __attribute__((availability)) on Fuchsia
ClosedPublic

Authored by haowei on Aug 23 2021, 3:41 PM.

Details

Summary

Also in this patch:

  • Control the fuchsia version via a new flag (-ffuchsia-api-level).
  • Add a warning that triggers when a non-zero minor/subminor are used for the fuchsia version.

Diff Detail

Event Timeline

leonardchan created this revision.Aug 23 2021, 3:41 PM
leonardchan requested review of this revision.Aug 23 2021, 3:41 PM
leonardchan planned changes to this revision.Aug 23 2021, 3:43 PM

Some extra comments/open questions:

  • This patch supports using N.0.0 as a version number. Do we want to just only accept N and disallow any number for minor/subminor, or will zeros be allowed?
  • This currently will only work if the major number is provided via the target triple (x86_64-unknown-fuchsia16). Do we have a concept of a default version number for fuchsia we can fall back to if this is not provided?
leonardchan edited the summary of this revision. (Show Details)
leonardchan retitled this revision from [WIP][clang][Fuchsia] Support __attribute__((availability)) on Fuchsia to [clang][Fuchsia] Support __attribute__((availability)) on Fuchsia.Aug 24 2021, 12:04 PM
phosek added inline comments.Sep 9 2021, 10:59 AM
clang/include/clang/Basic/LangOptions.def
431

This is more consistent with other options.

clang/lib/Basic/Targets/OSTargets.h
888

We also want to define a __FUCHSIA_VERSION__ so the version can be read at compile time.

clang/test/Frontend/attr-availability-fuchsia.c
4

Would this also set the availability attribute? Can we test it? If not then this isn't particularly useful.

aaron.ballman added inline comments.Sep 9 2021, 11:49 AM
clang/test/Frontend/attr-availability-fuchsia.c
2

Is |& intentional? I think that's causing shell parse errors on Windows (same for the other test).

Also should this test be in Driver instead as it's testing the driver functionality?

haowei commandeered this revision.Oct 5 2021, 4:50 PM
haowei added a reviewer: leonardchan.
haowei added a subscriber: haowei.

I am commandeering this work as original author stopped working this project.

haowei updated this revision to Diff 377389.Oct 5 2021, 4:51 PM
haowei edited the summary of this revision. (Show Details)
aaron.ballman added inline comments.Oct 6 2021, 4:45 AM
clang/include/clang/Basic/DiagnosticSemaKinds.td
3547
clang/lib/Basic/Targets/OSTargets.h
888

I think this macro should be using a reserved name, as suggested by @phosek.

clang/test/Frontend/attr-availability-fuchsia.c
2

This test should be in Driver, right?

3

Can you also add a test that shows how we handle -ffuchsia-api-level=16.0.0?

clang/test/Sema/attr-availability-fuchsia.c
15

FWIW, this surprises me. I would have expected that 16, 16.0, and 16.0.0 were all equivalent and the issue was with specifying a nonzero value for those. I've suggested new wording for the diagnostic that might make it more clear.

phosek added inline comments.Oct 6 2021, 12:20 PM
clang/lib/Basic/Targets/OSTargets.h
888

@aaron.ballman Do you have any thoughts on the letter case? I think that __Fuchsia_API_level__ might be a better match for __Fuchsia__. Upper case is perhaps more usual, but other platforms like *BSD also use mixed case.

haowei updated this revision to Diff 377726.Oct 6 2021, 5:48 PM
haowei marked an inline comment as done.
haowei marked an inline comment as done.Oct 6 2021, 5:51 PM
haowei added inline comments.
clang/lib/Basic/Targets/OSTargets.h
888

I changed it to "Fuchsia_API_level" for now.

clang/test/Frontend/attr-availability-fuchsia.c
3

I did. But it does not fail. I will look into it to see if I can add the same constraint like the attributes tomorrow.

4

Do you mean the macros? I can add one.

aaron.ballman added inline comments.Oct 7 2021, 8:40 AM
clang/lib/Basic/Targets/OSTargets.h
888

I don't have strong opinions so long as the identifier is reserved (and it is). I would note that the current capitalization might be a bit annoying for users to remember because it's Fuchsia, API, and level, all with different casing styles.

haowei updated this revision to Diff 378052.Oct 7 2021, 5:51 PM

I added unit test for macros. I am still working on adding error checks on --ffuchsia-api-level flags but the rest is pretty much done.

clang/test/Frontend/attr-availability-fuchsia.c
4

@phosek I added unit test for macros. Could you confirm it is what you suggested in the previous comments? Thanks.

haowei updated this revision to Diff 378324.Oct 8 2021, 11:49 AM

Added unit test when "-ffuchsia-api-level" is supplied with a non integer value.

phosek accepted this revision.Oct 8 2021, 2:20 PM

LGTM

clang/include/clang/Basic/LangOptions.def
431
clang/include/clang/Driver/Options.td
3140
clang/test/Driver/attr-availability-fuchsia.c
2–25 ↗(On Diff #378324)

Can you reorder this so CHECK always follows the corresponding RUN and separate each case by an empty line? I find it more readable.

This revision is now accepted and ready to land.Oct 8 2021, 2:20 PM
haowei updated this revision to Diff 378780.Oct 11 2021, 1:22 PM

Fix test failures on Windows.

haowei updated this revision to Diff 378784.Oct 11 2021, 1:41 PM

Address review comments.

This revision was automatically updated to reflect the committed changes.