1//===--- OptParser.td - Common Option Parsing Interfaces ------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9//  This file defines the common interfaces used by the option parsing TableGen
10//  backend.
11//
12//===----------------------------------------------------------------------===//
13
14// Define the kinds of options.
15
16class OptionKind<string name, int precedence = 0, bit sentinel = 0> {
17  string Name = name;
18  // The kind precedence, kinds with lower precedence are matched first.
19  int Precedence = precedence;
20  // Indicate a sentinel option.
21  bit Sentinel = sentinel;
22}
23
24// An option group.
25def KIND_GROUP : OptionKind<"Group">;
26// The input option kind.
27def KIND_INPUT : OptionKind<"Input", 1, 1>;
28// The unknown option kind.
29def KIND_UNKNOWN : OptionKind<"Unknown", 2, 1>;
30// A flag with no values.
31def KIND_FLAG : OptionKind<"Flag">;
32// An option which prefixes its (single) value.
33def KIND_JOINED : OptionKind<"Joined", 1>;
34// An option which is followed by its value.
35def KIND_SEPARATE : OptionKind<"Separate">;
36// An option followed by its values, which are separated by commas.
37def KIND_COMMAJOINED : OptionKind<"CommaJoined">;
38// An option which is which takes multiple (separate) arguments.
39def KIND_MULTIARG : OptionKind<"MultiArg">;
40// An option which is either joined to its (non-empty) value, or followed by its
41// value.
42def KIND_JOINED_OR_SEPARATE : OptionKind<"JoinedOrSeparate">;
43// An option which is both joined to its (first) value, and followed by its
44// (second) value.
45def KIND_JOINED_AND_SEPARATE : OptionKind<"JoinedAndSeparate">;
46// An option which consumes all remaining arguments if there are any.
47def KIND_REMAINING_ARGS : OptionKind<"RemainingArgs">;
48// An option which consumes an optional joined argument and any other remaining
49// arguments.
50def KIND_REMAINING_ARGS_JOINED : OptionKind<"RemainingArgsJoined">;
51
52// Define the option flags.
53
54class OptionFlag {}
55
56// HelpHidden - The option should not be displayed in --help, even if it has
57// help text. Clients *can* use this in conjunction with the OptTable::PrintHelp
58// arguments to implement hidden help groups.
59def HelpHidden : OptionFlag;
60
61// RenderAsInput - The option should not render the name when rendered as an
62// input (i.e., the option is rendered as values).
63def RenderAsInput : OptionFlag;
64
65// RenderJoined - The option should be rendered joined, even if separate (only
66// sensible on single value separate options).
67def RenderJoined : OptionFlag;
68
69// RenderSeparate - The option should be rendered separately, even if joined
70// (only sensible on joined options).
71def RenderSeparate : OptionFlag;
72
73// Define the option group class.
74
75class OptionGroup<string name> {
76  string EnumName = ?; // Uses the def name if undefined.
77  string Name = name;
78  string HelpText = ?;
79  OptionGroup Group = ?;
80  list<OptionFlag> Flags = [];
81}
82
83// Define the option class.
84
85class Option<list<string> prefixes, string name, OptionKind kind> {
86  string EnumName = ?; // Uses the def name if undefined.
87  list<string> Prefixes = prefixes;
88  string Name = name;
89  OptionKind Kind = kind;
90  // Used by MultiArg option kind.
91  int NumArgs = 0;
92  string HelpText = ?;
93  string MetaVarName = ?;
94  string Values = ?;
95  code ValuesCode = ?;
96  list<OptionFlag> Flags = [];
97  OptionGroup Group = ?;
98  Option Alias = ?;
99  list<string> AliasArgs = [];
100}
101
102// Helpers for defining options.
103
104class Flag<list<string> prefixes, string name>
105  : Option<prefixes, name, KIND_FLAG>;
106class Joined<list<string> prefixes, string name>
107  : Option<prefixes, name, KIND_JOINED>;
108class Separate<list<string> prefixes, string name>
109  : Option<prefixes, name, KIND_SEPARATE>;
110class CommaJoined<list<string> prefixes, string name>
111  : Option<prefixes, name, KIND_COMMAJOINED>;
112class MultiArg<list<string> prefixes, string name, int numargs>
113  : Option<prefixes, name, KIND_MULTIARG> {
114  int NumArgs = numargs;
115}
116class JoinedOrSeparate<list<string> prefixes, string name>
117  : Option<prefixes, name, KIND_JOINED_OR_SEPARATE>;
118class JoinedAndSeparate<list<string> prefixes, string name>
119  : Option<prefixes, name, KIND_JOINED_AND_SEPARATE>;
120
121// Mix-ins for adding optional attributes.
122
123class Alias<Option alias> { Option Alias = alias; }
124class AliasArgs<list<string> aliasargs> { list<string> AliasArgs = aliasargs; }
125class EnumName<string name> { string EnumName = name; }
126class Flags<list<OptionFlag> flags> { list<OptionFlag> Flags = flags; }
127class Group<OptionGroup group> { OptionGroup Group = group; }
128class HelpText<string text> { string HelpText = text; }
129class MetaVarName<string name> { string MetaVarName = name; }
130class Values<string value> { string Values = value; }
131class ValuesCode<code valuecode> { code ValuesCode = valuecode; }
132
133// Predefined options.
134
135// FIXME: Have generator validate that these appear in correct position (and
136// aren't duplicated).
137def INPUT : Option<[], "<input>", KIND_INPUT>;
138def UNKNOWN : Option<[], "<unknown>", KIND_UNKNOWN>;
139