GCC Code Coverage Report
Directory: ./ Exec Total Coverage
File: node_options.h Lines: 35 37 94.6 %
Date: 2022-04-09 04:14:47 Branches: 8 10 80.0 %

Line Branch Exec Source
1
#ifndef SRC_NODE_OPTIONS_H_
2
#define SRC_NODE_OPTIONS_H_
3
4
#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
5
6
#include <memory>
7
#include <string>
8
#include <unordered_map>
9
#include <vector>
10
#include "node_constants.h"
11
#include "node_mutex.h"
12
#include "util.h"
13
14
#if HAVE_OPENSSL
15
#include "openssl/opensslv.h"
16
#endif
17
18
namespace node {
19
20
5594
class HostPort {
21
 public:
22
5417
  HostPort(const std::string& host_name, int port)
23
5417
      : host_name_(host_name), port_(port) {}
24
16794
  HostPort(const HostPort&) = default;
25
  HostPort& operator=(const HostPort&) = default;
26
  HostPort(HostPort&&) = default;
27
  HostPort& operator=(HostPort&&) = default;
28
29
  void set_host(const std::string& host) { host_name_ = host; }
30
31
96
  void set_port(int port) { port_ = port; }
32
33
6043
  const std::string& host() const { return host_name_; }
34
35
6190
  int port() const {
36
    // TODO(joyeecheung): make port a uint16_t
37
6190
    CHECK_GE(port_, 0);
38
6190
    return port_;
39
  }
40
41
100
  void Update(const HostPort& other) {
42
100
    if (!other.host_name_.empty()) host_name_ = other.host_name_;
43
100
    if (other.port_ >= 0) port_ = other.port_;
44
100
  }
45
46
 private:
47
  std::string host_name_;
48
  int port_;
49
};
50
51
class Options {
52
 public:
53
  virtual void CheckOptions(std::vector<std::string>* errors) {}
54
79834
  virtual ~Options() = default;
55
};
56
57
struct InspectPublishUid {
58
  bool console;
59
  bool http;
60
};
61
62
// These options are currently essentially per-Environment, but it can be nice
63
// to keep them separate since they are a group of options applying to a very
64
// specific part of Node. It might also make more sense for them to be
65
// per-Isolate, rather than per-Environment.
66
5594
class DebugOptions : public Options {
67
 public:
68
5317
  DebugOptions() = default;
69
11196
  DebugOptions(const DebugOptions&) = default;
70
  DebugOptions& operator=(const DebugOptions&) = default;
71
  DebugOptions(DebugOptions&&) = default;
72
  DebugOptions& operator=(DebugOptions&&) = default;
73
74
  // --inspect
75
  bool inspector_enabled = false;
76
  // --debug
77
  bool deprecated_debug = false;
78
  // --inspect-brk
79
  bool break_first_line = false;
80
  // --inspect-brk-node
81
  bool break_node_first_line = false;
82
  // --inspect-publish-uid
83
  std::string inspect_publish_uid_string = "stderr,http";
84
85
  InspectPublishUid inspect_publish_uid;
86
87
  enum { kDefaultInspectorPort = 9229 };
88
89
  HostPort host_port{"127.0.0.1", kDefaultInspectorPort};
90
91
  // Used to patch the options as if --inspect-brk is passed.
92
38
  void EnableBreakFirstLine() {
93
38
    inspector_enabled = true;
94
38
    break_first_line = true;
95
38
  }
96
97
5594
  bool wait_for_connect() const {
98

5594
    return break_first_line || break_node_first_line;
99
  }
100
101
  void CheckOptions(std::vector<std::string>* errors) override;
102
};
103
104
class EnvironmentOptions : public Options {
105
 public:
106
  bool abort_on_uncaught_exception = false;
107
  std::vector<std::string> conditions;
108
  std::string dns_result_order;
109
  bool enable_source_maps = false;
110
  bool experimental_fetch = true;
111
  bool experimental_global_web_crypto = false;
112
  bool experimental_https_modules = false;
113
  std::string experimental_specifier_resolution;
114
  bool experimental_wasm_modules = false;
115
  bool experimental_import_meta_resolve = false;
116
  std::string module_type;
117
  std::string experimental_policy;
118
  std::string experimental_policy_integrity;
119
  bool has_policy_integrity_string = false;
120
  bool experimental_repl_await = true;
121
  bool experimental_vm_modules = false;
122
  bool expose_internals = false;
123
  bool frozen_intrinsics = false;
124
  int64_t heap_snapshot_near_heap_limit = 0;
125
  std::string heap_snapshot_signal;
126
  uint64_t max_http_header_size = 16 * 1024;
127
  bool deprecation = true;
128
  bool force_async_hooks_checks = true;
129
  bool allow_native_addons = true;
130
  bool global_search_paths = true;
131
  bool warnings = true;
132
  bool force_context_aware = false;
133
  bool pending_deprecation = false;
134
  bool preserve_symlinks = false;
135
  bool preserve_symlinks_main = false;
136
  bool prof_process = false;
137
#if HAVE_INSPECTOR
138
  std::string cpu_prof_dir;
139
  static const uint64_t kDefaultCpuProfInterval = 1000;
140
  uint64_t cpu_prof_interval = kDefaultCpuProfInterval;
141
  std::string cpu_prof_name;
142
  bool cpu_prof = false;
143
  std::string heap_prof_dir;
144
  std::string heap_prof_name;
145
  static const uint64_t kDefaultHeapProfInterval = 512 * 1024;
146
  uint64_t heap_prof_interval = kDefaultHeapProfInterval;
147
  bool heap_prof = false;
148
#endif  // HAVE_INSPECTOR
149
  std::string redirect_warnings;
150
  std::string diagnostic_dir;
151
  bool test_only = false;
152
  bool test_udp_no_try_send = false;
153
  bool throw_deprecation = false;
154
  bool trace_atomics_wait = false;
155
  bool trace_deprecation = false;
156
  bool trace_exit = false;
157
  bool trace_sync_io = false;
158
  bool trace_tls = false;
159
  bool trace_uncaught = false;
160
  bool trace_warnings = false;
161
  bool extra_info_on_fatal_exception = true;
162
  std::string unhandled_rejections;
163
  std::string userland_loader;
164
  bool verify_base_objects =
165
#ifdef DEBUG
166
      true;
167
#else
168
      false;
169
#endif  // DEBUG
170
171
  bool syntax_check_only = false;
172
  bool has_eval_string = false;
173
  bool experimental_wasi = false;
174
  std::string eval_string;
175
  bool print_eval = false;
176
  bool force_repl = false;
177
178
  bool insecure_http_parser = false;
179
180
  bool tls_min_v1_0 = false;
181
  bool tls_min_v1_1 = false;
182
  bool tls_min_v1_2 = false;
183
  bool tls_min_v1_3 = false;
184
  bool tls_max_v1_2 = false;
185
  bool tls_max_v1_3 = false;
186
  std::string tls_keylog;
187
188
  std::vector<std::string> preload_modules;
189
190
  std::vector<std::string> user_argv;
191
192
41941
  inline DebugOptions* get_debug_options() { return &debug_options_; }
193
22380
  inline const DebugOptions& debug_options() const { return debug_options_; }
194
195
  void CheckOptions(std::vector<std::string>* errors) override;
196
197
 private:
198
  DebugOptions debug_options_;
199
};
200
201
class PerIsolateOptions : public Options {
202
 public:
203
  std::shared_ptr<EnvironmentOptions> per_env { new EnvironmentOptions() };
204
  bool track_heap_objects = false;
205
  bool node_snapshot = true;
206
  bool report_uncaught_exception = false;
207
  bool report_on_signal = false;
208
  bool experimental_top_level_await = true;
209
  std::string report_signal = "SIGUSR2";
210
  inline EnvironmentOptions* get_per_env_options();
211
  void CheckOptions(std::vector<std::string>* errors) override;
212
};
213
214
class PerProcessOptions : public Options {
215
 public:
216
  // Options shouldn't be here unless they affect the entire process scope, and
217
  // that should avoided when possible.
218
  //
219
  // When an option is used during process initialization, it does not need
220
  // protection, but any use after that will likely require synchronization
221
  // using the node::per_process::cli_options_mutex, typically:
222
  //
223
  //     Mutex::ScopedLock lock(node::per_process::cli_options_mutex);
224
  std::shared_ptr<PerIsolateOptions> per_isolate { new PerIsolateOptions() };
225
226
  std::string title;
227
  std::string trace_event_categories;
228
  std::string trace_event_file_pattern = "node_trace.${rotation}.log";
229
  int64_t v8_thread_pool_size = 4;
230
  bool zero_fill_all_buffers = false;
231
  bool debug_arraybuffer_allocations = false;
232
  std::string disable_proto;
233
  bool build_snapshot;
234
235
  std::vector<std::string> security_reverts;
236
  bool print_bash_completion = false;
237
  bool print_help = false;
238
  bool print_v8_help = false;
239
  bool print_version = false;
240
241
#ifdef NODE_HAVE_I18N_SUPPORT
242
  std::string icu_data_dir;
243
#endif
244
245
  // Per-process because they affect singleton OpenSSL shared library state,
246
  // or are used once during process initialization.
247
#if HAVE_OPENSSL
248
  std::string openssl_config;
249
  std::string tls_cipher_list = DEFAULT_CIPHER_LIST_CORE;
250
  int64_t secure_heap = 0;
251
  int64_t secure_heap_min = 2;
252
#ifdef NODE_OPENSSL_CERT_STORE
253
  bool ssl_openssl_cert_store = true;
254
#else
255
  bool ssl_openssl_cert_store = false;
256
#endif
257
  bool use_openssl_ca = false;
258
  bool use_bundled_ca = false;
259
  bool enable_fips_crypto = false;
260
  bool force_fips_crypto = false;
261
#endif
262
#if OPENSSL_VERSION_MAJOR >= 3
263
  bool openssl_legacy_provider = false;
264
#endif
265
266
  // Per-process because reports can be triggered outside a known V8 context.
267
  bool report_on_fatalerror = false;
268
  bool report_compact = false;
269
  std::string report_directory;
270
  std::string report_filename;
271
272
  // TODO(addaleax): Some of these could probably be per-Environment.
273
  std::string use_largepages = "off";
274
  bool trace_sigint = false;
275
  std::vector<std::string> cmdline;
276
277
  inline PerIsolateOptions* get_per_isolate_options();
278
  void CheckOptions(std::vector<std::string>* errors) override;
279
};
280
281
// The actual options parser, as opposed to the structs containing them:
282
283
namespace options_parser {
284
285
HostPort SplitHostPort(const std::string& arg,
286
    std::vector<std::string>* errors);
287
void GetOptions(const v8::FunctionCallbackInfo<v8::Value>& args);
288
std::string GetBashCompletion();
289
290
enum OptionType {
291
  kNoOp,
292
  kV8Option,
293
  kBoolean,
294
  kInteger,
295
  kUInteger,
296
  kString,
297
  kHostPort,
298
  kStringList,
299
};
300
301
template <typename Options>
302
class OptionsParser {
303
 public:
304
40392
  virtual ~OptionsParser() = default;
305
306
  typedef Options TargetType;
307
308
  struct NoOp {};
309
  struct V8Option {};
310
311
  // These methods add a single option to the parser. Optionally, it can be
312
  // specified whether the option should be allowed from environment variable
313
  // sources (i.e. NODE_OPTIONS).
314
  void AddOption(const char* name,
315
                 const char* help_text,
316
                 bool Options::* field,
317
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment,
318
                 bool default_is_true = false);
319
  void AddOption(const char* name,
320
                 const char* help_text,
321
                 uint64_t Options::* field,
322
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
323
  void AddOption(const char* name,
324
                 const char* help_text,
325
                 int64_t Options::* field,
326
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
327
  void AddOption(const char* name,
328
                 const char* help_text,
329
                 std::string Options::* field,
330
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
331
  void AddOption(const char* name,
332
                 const char* help_text,
333
                 std::vector<std::string> Options::* field,
334
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
335
  void AddOption(const char* name,
336
                 const char* help_text,
337
                 HostPort Options::* field,
338
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
339
  void AddOption(const char* name,
340
                 const char* help_text,
341
                 NoOp no_op_tag,
342
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
343
  void AddOption(const char* name,
344
                 const char* help_text,
345
                 V8Option v8_option_tag,
346
                 OptionEnvvarSettings env_setting = kDisallowedInEnvironment);
347
348
  // Adds aliases. An alias can be of the form "--option-a" -> "--option-b",
349
  // or have a more complex group expansion, like
350
  //   "--option-a" -> { "--option-b", "--harmony-foobar", "--eval", "42" }
351
  // If `from` has the form "--option-a=", the alias will only be expanded if
352
  // the option is presented in that form (i.e. with a '=').
353
  // If `from` has the form "--option-a <arg>", the alias will only be expanded
354
  // if the option has a non-option argument (not starting with -) following it.
355
  void AddAlias(const char* from, const char* to);
356
  void AddAlias(const char* from, const std::vector<std::string>& to);
357
  void AddAlias(const char* from,
358
                const std::initializer_list<std::string>& to);
359
360
  // Add implications from some arbitrary option to a boolean one, either
361
  // in a way that makes `from` set `to` to true or to false.
362
  void Implies(const char* from, const char* to);
363
  void ImpliesNot(const char* from, const char* to);
364
365
  // Insert options from another options parser into this one, along with
366
  // a method that yields the target options type from this parser's options
367
  // type.
368
  template <typename ChildOptions>
369
  void Insert(const OptionsParser<ChildOptions>& child_options_parser,
370
              ChildOptions* (Options::* get_child)());
371
372
  // Parse a sequence of options into an options struct, a list of
373
  // arguments that were parsed as options, a list of unknown/JS engine options,
374
  // and leave the remainder in the input `args` vector.
375
  //
376
  // For example, an `args` input of
377
  //
378
  //   node --foo --harmony-bar --fizzle=42 -- /path/to/cow moo
379
  //
380
  // expands as
381
  //
382
  // - `args` -> { "node", "/path/to/cow", "moo" }
383
  // - `exec_args` -> { "--foo", "--harmony-bar", "--fizzle=42" }
384
  // - `v8_args` -> `{ "node", "--harmony-bar" }
385
  // - `options->foo == true`, `options->fizzle == 42`.
386
  //
387
  // If `*error` is set, the result of the parsing should be discarded and the
388
  // contents of any of the argument vectors should be considered undefined.
389
  void Parse(std::vector<std::string>* const args,
390
             std::vector<std::string>* const exec_args,
391
             std::vector<std::string>* const v8_args,
392
             Options* const options,
393
             OptionEnvvarSettings required_env_settings,
394
             std::vector<std::string>* const errors) const;
395
396
 private:
397
  // We support the wide variety of different option types by remembering
398
  // how to access them, given a certain `Options` struct.
399
400
  // Represents a field within `Options`.
401
  class BaseOptionField {
402
   public:
403
3221262
    virtual ~BaseOptionField() = default;
404
    virtual void* LookupImpl(Options* options) const = 0;
405
406
    template <typename T>
407
1339390
    inline T* Lookup(Options* options) const {
408
1339390
      return static_cast<T*>(LookupImpl(options));
409
    }
410
  };
411
412
  // Represents a field of type T within `Options` that can be looked up
413
  // as a C++ member field.
414
  template <typename T>
415
  class SimpleOptionField : public BaseOptionField {
416
   public:
417
1130976
    explicit SimpleOptionField(T Options::* field) : field_(field) {}
418
669695
    void* LookupImpl(Options* options) const override {
419
1339390
      return static_cast<void*>(&(options->*field_));
420
    }
421
422
   private:
423
    T Options::* field_;
424
  };
425
426
  template <typename T>
427
1338702
  inline T* Lookup(std::shared_ptr<BaseOptionField> field,
428
                   Options* options) const {
429
1338702
    return field->template Lookup<T>(options);
430
  }
431
432
  // An option consists of:
433
  // - A type.
434
  // - A way to store/access the property value.
435
  // - The information of whether it may occur in an env var or not.
436
  struct OptionInfo {
437
    OptionType type;
438
    std::shared_ptr<BaseOptionField> field;
439
    OptionEnvvarSettings env_setting;
440
    std::string help_text;
441
    bool default_is_true = false;
442
  };
443
444
  // An implied option is composed of the information on where to store a
445
  // specific boolean value (if another specific option is encountered).
446
  struct Implication {
447
    OptionType type;
448
    std::string name;
449
    std::shared_ptr<BaseOptionField> target_field;
450
    bool target_value;
451
  };
452
453
  // These are helpers that make `Insert()` support properties of other
454
  // options structs, if we know how to access them.
455
  template <typename OriginalField, typename ChildOptions>
456
  static auto Convert(
457
      std::shared_ptr<OriginalField> original,
458
      ChildOptions* (Options::* get_child)());
459
  template <typename ChildOptions>
460
  static auto Convert(
461
      typename OptionsParser<ChildOptions>::OptionInfo original,
462
      ChildOptions* (Options::* get_child)());
463
  template <typename ChildOptions>
464
  static auto Convert(
465
      typename OptionsParser<ChildOptions>::Implication original,
466
      ChildOptions* (Options::* get_child)());
467
468
  std::unordered_map<std::string, OptionInfo> options_;
469
  std::unordered_map<std::string, std::vector<std::string>> aliases_;
470
  std::unordered_multimap<std::string, Implication> implications_;
471
472
  template <typename OtherOptions>
473
  friend class OptionsParser;
474
475
5960
  friend void GetCLIOptions(const v8::FunctionCallbackInfo<v8::Value>& args);
476
  friend std::string GetBashCompletion();
477
};
478
479
using StringVector = std::vector<std::string>;
480
template <class OptionsType, class = Options>
481
void Parse(
482
  StringVector* const args, StringVector* const exec_args,
483
  StringVector* const v8_args, OptionsType* const options,
484
  OptionEnvvarSettings required_env_settings, StringVector* const errors);
485
486
}  // namespace options_parser
487
488
namespace per_process {
489
490
extern Mutex cli_options_mutex;
491
extern std::shared_ptr<PerProcessOptions> cli_options;
492
493
}  // namespace per_process
494
495
void HandleEnvOptions(std::shared_ptr<EnvironmentOptions> env_options);
496
void HandleEnvOptions(std::shared_ptr<EnvironmentOptions> env_options,
497
                      std::function<std::string(const char*)> opt_getter);
498
499
std::vector<std::string> ParseNodeOptionsEnvVar(
500
    const std::string& node_options, std::vector<std::string>* errors);
501
}  // namespace node
502
503
#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
504
505
#endif  // SRC_NODE_OPTIONS_H_