Mercurial > hg > truffle

annotate truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleOptions.java @ 22111:8b72dfac5cc7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Allow selecting the TruffleRuntime using a system property
author Christian Wimmer <christian.wimmer@oracle.com>
date Wed, 26 Aug 2015 14:39:11 -0700
parents b960accdd9b5
children dc83cc1f94f2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
1 /*
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
2 * Copyright (c) 2012, 2012, Oracle and/or its affiliates. All rights reserved.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
4 *
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
11279
494b818b527c Adding "Classpath" exception to the classes in the com.oracle.truffle.api and the com.oracle.truffle.api.dsl package.
Thomas Wuerthinger <thomas.wuerthinger@oracle.com>
parents: 10690
diff changeset
7 * published by the Free Software Foundation. Oracle designates this
494b818b527c Adding "Classpath" exception to the classes in the com.oracle.truffle.api and the com.oracle.truffle.api.dsl package.
Thomas Wuerthinger <thomas.wuerthinger@oracle.com>
parents: 10690
diff changeset
8 * particular file as subject to the "Classpath" exception as provided
494b818b527c Adding "Classpath" exception to the classes in the com.oracle.truffle.api and the com.oracle.truffle.api.dsl package.
Thomas Wuerthinger <thomas.wuerthinger@oracle.com>
parents: 10690
diff changeset
9 * by Oracle in the LICENSE file that accompanied this code.
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
10 *
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
11 * This code is distributed in the hope that it will be useful, but WITHOUT
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
14 * version 2 for more details (a copy is included in the LICENSE file that
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
15 * accompanied this code).
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
16 *
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
17 * You should have received a copy of the GNU General Public License version
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
18 * 2 along with this work; if not, write to the Free Software Foundation,
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
20 *
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
22 * or visit www.oracle.com if you need additional information or have any
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
23 * questions.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
24 */
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
25 package com.oracle.truffle.api;
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
26
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
27 import java.security.*;
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
28
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
29 import com.oracle.truffle.api.nodes.*;
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
30
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
31 /**
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
32 * Class containing general Truffle options.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
33 */
22063
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
34 public final class TruffleOptions {
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
35 private TruffleOptions() {
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
36 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
37
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
38 /**
13874
c35d86f53ace fix Truffle JavaDoc
Christian Wirth <christian.wirth@oracle.com>
parents: 13685
diff changeset
39 * Enables/disables the rewriting of traces in the Truffle runtime to stdout.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
40 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
41 * Can be set with {@code -Dtruffle.TraceRewrites=true}.
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
42 */
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
43 public static final boolean TraceRewrites;
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
44
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
45 /**
10690
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
46 * Enables the generation of detailed rewrite reasons. Enabling this may introduce some overhead
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
47 * for rewriting nodes.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
48 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
49 * Can be set with {@code -Dtruffle.DetailedRewriteReasons=true}.
10690
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
50 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
51 public static final boolean DetailedRewriteReasons;
10690
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
52
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
53 /**
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
54 * Filters rewrites that do not contain the given string in the qualified name of the source or
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
55 * target class hierarchy.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
56 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
57 * Can be set with {@code -Dtruffle.TraceRewritesFilterClass=name}.
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
58 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
59 public static String TraceRewritesFilterClass;
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
60
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
61 /**
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
62 * Filters rewrites which does not contain the {@link NodeCost} in its source {@link NodeInfo}.
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
63 * If no {@link NodeInfo} is defined the element is filtered if the filter value is set.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
64 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
65 * Can be set with
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
66 * {@code -Dtruffle.TraceRewritesFilterFromCost=NONE|MONOMORPHIC|POLYMORPHIC|MEGAMORPHIC}.
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
67 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
68 public static NodeCost TraceRewritesFilterFromCost;
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
69
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
70 /**
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
71 * Filters rewrites which does not contain the {@link NodeCost} in its target {@link NodeInfo}.
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
72 * If no {@link NodeInfo} is defined the element is filtered if the filter value is set.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
73 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
74 * Can be set with
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
75 * {@code -Dtruffle.TraceRewritesFilterToKind=UNINITIALIZED|SPECIALIZED|POLYMORPHIC|GENERIC}.
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
76 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
77 public static NodeCost TraceRewritesFilterToCost;
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
78
16151
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
79 /**
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
80 * Enables the dumping of Node creations and AST rewrites in JSON format.
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
81 * <p>
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
82 * Can be set with {@code -Dtruffle.TraceASTJSON=true}.
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
83 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
84 public static final boolean TraceASTJSON;
16151
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
85
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
86 private static NodeCost parseNodeInfoKind(String kind) {
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
87 if (kind == null) {
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
88 return null;
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
89 }
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
90
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
91 return NodeCost.valueOf(kind);
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
92 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
93
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
94 static {
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
95 final boolean[] values = new boolean[3];
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
96 AccessController.doPrivileged(new PrivilegedAction<Void>() {
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
97 public Void run() {
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
98 values[0] = Boolean.getBoolean("truffle.TraceRewrites");
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
99 TraceRewritesFilterClass = System.getProperty("truffle.TraceRewritesFilterClass");
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
100 TraceRewritesFilterFromCost = parseNodeInfoKind(System.getProperty("truffle.TraceRewritesFilterFromCost"));
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
101 TraceRewritesFilterToCost = parseNodeInfoKind(System.getProperty("truffle.TraceRewritesFilterToCost"));
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
102 values[1] = Boolean.getBoolean("truffle.DetailedRewriteReasons");
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
103 values[2] = Boolean.getBoolean("truffle.TraceASTJSON");
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
104 return null;
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
105 }
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
106 });
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
107 TraceRewrites = values[0];
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
108 DetailedRewriteReasons = values[1];
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
109 TraceASTJSON = values[2];
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
110 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
111 }