Mercurial > hg > truffle

annotate truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/TruffleOptions.java @ 22157:dc83cc1f94f2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Using fully qualified imports
author Jaroslav Tulach <jaroslav.tulach@oracle.com>
date Wed, 16 Sep 2015 11:33:22 +0200
parents 8b72dfac5cc7
children 4db968103a7c
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
22157
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22111
diff changeset
27 import com.oracle.truffle.api.nodes.NodeCost;
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22111
diff changeset
28 import com.oracle.truffle.api.nodes.NodeInfo;
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22111
diff changeset
29 import java.security.AccessController;
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22111
diff changeset
30 import java.security.PrivilegedAction;
10590
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 /**
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
33 * Class containing general Truffle options.
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
34 */
22063
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
35 public final class TruffleOptions {
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
36 private TruffleOptions() {
b960accdd9b5 No instances of TruffleOptions
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 21951
diff changeset
37 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
38
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
39 /**
13874
c35d86f53ace fix Truffle JavaDoc
Christian Wirth <christian.wirth@oracle.com>
parents: 13685
diff changeset
40 * 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
41 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
42 * 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
43 */
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
44 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
45
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
46 /**
10690
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
47 * 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
48 * for rewriting nodes.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
49 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
50 * 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
51 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
52 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
53
a0309f88306c Added truffle option to enable detailed rewrite messages. Disabled by default.
Christian Humer <christian.humer@gmail.com>
parents: 10676
diff changeset
54 /**
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
55 * 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
56 * target class hierarchy.
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
57 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
58 * 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
59 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
60 public static String TraceRewritesFilterClass;
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
61
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
62 /**
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
63 * 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
64 * 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
65 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
66 * 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
67 * {@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
68 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
69 public static NodeCost TraceRewritesFilterFromCost;
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
70
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
71 /**
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
72 * 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
73 * 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
74 * <p>
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
75 * Can be set with
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
76 * {@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
77 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
78 public static NodeCost TraceRewritesFilterToCost;
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
79
16151
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
80 /**
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
81 * 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
82 * <p>
76895499bc88 Add facility to create JSON dump of AST creation/rewriting
Christian Wirth <christian.wirth@oracle.com>
parents: 14564
diff changeset
83 * 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
84 */
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
85 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
86
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
87 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
88 if (kind == null) {
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
89 return null;
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
90 }
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
91
14564
5d1308c78ddc Truffle: Introduced NodeCost as a replacement for NodeInfo.Kind.
Christian Humer <christian.humer@gmail.com>
parents: 13874
diff changeset
92 return NodeCost.valueOf(kind);
13685
29a6cb0783de Allow TruffleOptions to be set using system properties.
Chris Seaton <chris.seaton@oracle.com>
parents: 11279
diff changeset
93 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
94
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
95 static {
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
96 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
97 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
98 public Void run() {
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
99 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
100 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
101 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
102 TraceRewritesFilterToCost = parseNodeInfoKind(System.getProperty("truffle.TraceRewritesFilterToCost"));
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
103 values[1] = Boolean.getBoolean("truffle.DetailedRewriteReasons");
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
104 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
105 return null;
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
106 }
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
107 });
19358
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
108 TraceRewrites = values[0];
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
109 DetailedRewriteReasons = values[1];
5ea169a3bf81 make various fields final
Lukas Stadler <lukas.stadler@oracle.com>
parents: 18961
diff changeset
110 TraceASTJSON = values[2];
16779
e52ad0d3b7d6 put some security sensitive actions into a privileged action
Doug Simon <doug.simon@oracle.com>
parents: 16151
diff changeset
111 }
10590
6eb8d63cea34 Added a feature to trace rewrites of truffle nodes.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
112 }