========================
translation.gcrootfinder
========================

* **name:** gcrootfinder

* **description:** Strategy for finding GC Roots (framework GCs only)

* **command-line:** --gcrootfinder

* **option type:** choice option

* **possible values:**

  + n/a

  + shadowstack

* **default:** shadowstack

* **requirements:**

  + value 'shadowstack' requires\:

    - `translation.gctransformer`_ to be set to 'framework'

.. _translation.gctransformer: translation.gctransformer.html





Choose the method used to find the roots in the GC.  This only
applies to our framework GCs.

- ``--gcrootfinder=shadowstack``: use a so-called "shadow
  stack", which is an explicitly maintained custom stack of
  root pointers.  This is the most portable solution, and also
  the only one available now.
