[CMake] Can an option enforce a default, even if cache is present?
Mario Emmenlauer
mario at emmenlauer.de
Wed Nov 28 06:56:31 EST 2018
On 28.11.18 12:38, Petr Kmoch wrote:
> On Tue, 27 Nov 2018 at 21:42, frodak <frodak17 at gmail.com <mailto:frodak17 at gmail.com>> wrote:
>
> On Tue, Nov 27, 2018 at 3:15 PM Mario Emmenlauer <mario at emmenlauer.de <mailto:mario at emmenlauer.de>> wrote:
> >
> > On 27.11.18 17:13, Eric Noulard wrote:
> > > Le mar. 27 nov. 2018 à 14:50, Mario Emmenlauer <mario at emmenlauer.de <mailto:mario at emmenlauer.de>
> > > <mailto:mario at emmenlauer.de <mailto:mario at emmenlauer.de>>> a écrit :
> > > Dear all,
> > >
> > > I've just discovered that option() behaves differently than I anticipated.
> > > After reading the docs and searching with google I'm still confused how to
> > > achieve my desired behaviour.
> > >
> > > What I've just learned is that unspecified options take their cached value
> > > and do *not* go back to their default value, if a cache exists. I assumed
> > > that options take their default when not explicitly specified.
> > >
> > >
> > > The behavior of option() gained new behavior in CMake 3.13.
> > > May be it could help in your particular case:
> > > https://cmake.org/cmake/help/v3.13/policy/CMP0077.html#policy:CMP0077
> > >
> > > you'll depend on latest CMake though.
> > >
> > >
> > > Now my problem: I could not find a way to get the behaviour I'd like. Is it
> > > possible to enforce the default for an option when its not specified by the
> > > user, even if a cache exists?
> > >
> > >
> > > You mean you did not manage to force the cache value?
> > > You can:
> > > set(VAR "default_value" CACHE FORCE)
> > >
> > > or the problem is you cannot know whether if a value has been user-provided?
> >
> > Sorry, I was not very precise! Your last point is the problem. I fail to know
> > when the option was user-provided and when it was cache-provided.
> >
> > So here is what I'd like:
> >
> > #> grep MYOPT CMakeLists.txt
> > option(MYOPT "Description" OFF)
> > #> cmake # I want the option disabled, this works fine.
> > #> cmake -DMYOPT=ON # I want the option enabled, this works fine.
> > #> cmake # I want the option disabled (back to default),
> > # but I observe the option taken from cache, enabled.
> >
> > Is there some way to achieve my desired behaviour? I tried without success
> > unset(MYOPT), unset(MYOPT CACHE), and set(MYOPT OFF) before option(), but
> > they all lead to different behaviour.
> >
>
>
> You're forgetting one important aspect of CMake: that it can retrigger itself when a CMake source file changes. Such a run of CMake is indistinguishable from
> running it manually, and it's (a large part of) why the cache exists in the first place. Imagine the following scenario:
>
> User runs >cmake -DMYOPT=ON
> User edits a CMakeLists.txt (or even just a file processed by configure_file()).
> User runs >make
>
> As part of this make, CMake triggers to regenerate the buildsystem. If MYOPT exhibited the behaviour you request, it would silently get disabled again, even
> though this is most definitely not what the user expects. I addressed a similar point in this StackOverflow answer: https://stackoverflow.com/a/41361741/1782465
>
> Petr
>
>
>
> I've always used 'cmake -UMYOPT' to remove specific items from the
> cache (or edit the cache file directly).
> I don't think the notion of user-provided or cache-provided entries
> exist because all user defined variables go into the cache.
> Then you can test to see if MYOPT is set and then use the default
> value when recreating the cache entry.
> Also cmake cache variables are persistent between invocations so the
> user doesn't need to keep specifying them at the command line every
> time cmake needs to run.
>
> Best regards...
Both of you make perfectly valid remarks, thanks for the explanation!
And I understand now that this is currently build deeply into cmake,
and I do not think my request is important enough to change it!
Still, if this would be re-evaluated at some point, then my personal
vote would be to change this behaviour. My user story is a variable that
can enable and disable packaging with cpack. I configure cmake for build,
run the build, run tests, and only then I configure for packaging. When
some time later the next build runs, it will actually execute packaging,
not building!
This was *not* requested, but happens due to caching. Since I re-run
configuration, it was not intuitive to me that it would not use *only*
the options I give, but additionally the ones I omitted but gave before.
I do not think that other configuration systems do this. In my example
from yesterday, I expect a configuration system to give the same result
when I invoke (1) or (3), since they are the same call:
#> cmake # I want the option disabled, this works fine.
#> cmake -DMYOPT=ON # I want the option enabled, this works fine.
#> cmake # I want the option disabled (back to default).
All the best,
Mario Emmenlauer
More information about the CMake
mailing list