cosmos 4.4.2 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 118c33651e0616201ed73bde1566f2e1d645ef30d06fe558e9d6585602e912e7
-  data.tar.gz: eaf90fcf26d5313349cd0f11c05fdfce4c24ee3de2a9d73d222dd349eae10af7
+  metadata.gz: 59047da4090004297591f443b9e77596f9bf961be49624ff2f8f164a0866f723
+  data.tar.gz: e3b59eaff1ed3381bf9b6befaf6651073cd95fc2f7ebf62a119a8680503ae065
 SHA512:
-  metadata.gz: 38a5ee8dd5fc1d4b5c1a2e97c3ecfe6e5e944150da861f9fa0a32db9c69c1896019e804f021fdbc4da5f7a47874d614d385cb246f76adb3542fa55a7101ea0c1
-  data.tar.gz: 20503f8f9121ab812625cc778b911feda6ca9b3d9b7e699f44b3d6676e5691551b3734893a5bee0ab6a2ff5eda7ed45f62fc1ddaca65a3d16b385e27d349ec2f
+  metadata.gz: e03e1726b97758e8e86702832f4838fd700daad9e3248832eb8583b1307d6746d4e5223e56549b93455dbab1da82b5534b48767744124ad4833eb785c4a78220
+  data.tar.gz: 40c5ae08da8b346230612f3ccfb2d0c23d40c93ab9188e4c9d27a152c2c36c52ed1f051bce9443f4ab817aa5c8a705473f7aa85732c9f72da4b1a0e30ff4810d

data/Dockerfile

@@ -49,16 +49,20 @@ RUN cd /opt \
   && tar xvf jruby.tar.gz \
   && mv jruby-9.2.9.0 jruby
 
+ARG COSMOS_REPO=https://github.com/BallAerospace/COSMOS.git
+
 # Download and setup COSMOS devel area
 RUN gem install bundler --no-document
 RUN cd /devel \
-  && git clone https://github.com/BallAerospace/COSMOS.git \
+  && git clone ${COSMOS_REPO} COSMOS \
   && cd /devel/COSMOS \
   && bundle install
 
+ARG COSMOS_DOCKER_REPO=https://github.com/BallAerospace/cosmos-docker.git
+
 # Download COSMOS docker files to support docker release
 RUN cd /devel \
-  && git clone https://github.com/BallAerospace/cosmos-docker.git
+  && git clone ${COSMOS_DOCKER_REPO}
   
 ENV COSMOS_DEVEL /devel/COSMOS
 WORKDIR /devel/COSMOS

data/Manifest.txt

@@ -694,6 +694,29 @@ ext/cosmos/ext/tabbed_plots_config/tabbed_plots_config.c
 ext/cosmos/ext/telemetry/extconf.rb
 ext/cosmos/ext/telemetry/telemetry.c
 ext/mkrf_conf.rb
+extensions/vscode/.gitignore
+extensions/vscode/.vscode/launch.json
+extensions/vscode/.vscode/settings.json
+extensions/vscode/.vscode/tasks.json
+extensions/vscode/License.txt
+extensions/vscode/README.md
+extensions/vscode/client/License.txt
+extensions/vscode/client/README.md
+extensions/vscode/client/cosmos.configuration.json
+extensions/vscode/client/images/icon.png
+extensions/vscode/client/package-lock.json
+extensions/vscode/client/package.json
+extensions/vscode/client/src/extension.ts
+extensions/vscode/client/src/screen_preview.rb
+extensions/vscode/client/syntaxes/cosmos.tmLanguage.json
+extensions/vscode/client/tsconfig.json
+extensions/vscode/package-lock.json
+extensions/vscode/package.json
+extensions/vscode/server/License.txt
+extensions/vscode/server/package-lock.json
+extensions/vscode/server/package.json
+extensions/vscode/server/src/server.ts
+extensions/vscode/server/tsconfig.json
 install/Gemfile
 install/Launcher
 install/Launcher.bat
@@ -1454,8 +1477,10 @@ spec/interfaces/udp_interface_spec.rb
 spec/io/buffered_file_spec.rb
 spec/io/io_multiplexer_spec.rb
 spec/io/json_drb_object_spec.rb
+spec/io/json_drb_rack_spec.rb
 spec/io/json_drb_spec.rb
 spec/io/json_rpc_spec.rb
+spec/io/posix_serial_driver_spec.rb
 spec/io/raw_logger_pair_spec.rb
 spec/io/raw_logger_spec.rb
 spec/io/serial_driver_spec.rb

data/README.md

@@ -105,6 +105,10 @@ Before any contributions can be incorporated we do require all contributors to s
 
 This protects both you and us and you retain full rights to any code you write.
 
+## Vulnerability Disclosure
+
+If you discover a security vulnerability in COSMOS, please do not disclose to any public forum or our Github tickets system.  Please email the vulnerability details to COSMOS@ball.com, and give us 90 days to incorporate any needed changes. Also please also let us know how how you would like to be reffered to for attribution when we post the fix. Thanks!
+
 ## Code Status
 
 * [![Travis Build Status](https://travis-ci.org/BallAerospace/COSMOS.svg?branch=master)](https://travis-ci.org/BallAerospace/COSMOS)

data/Rakefile

@@ -312,7 +312,7 @@ end
 task :docker_run do
   STDOUT.puts "Note, this is not automated on purpose to ensure each step is successful (with user entry of credentials for github/rubygems.org)"
   STDOUT.puts "Steps to perform a COSMOS release:"
-  STDOUT.puts "1. git config --global user.name \"First Last\""
+  STDOUT.puts "1. git config --global user.name \"Last, First\""
   STDOUT.puts "2. git config --global user.email \"me@ball.com\""
   STDOUT.puts "3. git pull"
   STDOUT.puts "4. export VERSION=X.X.X"
@@ -324,17 +324,12 @@ task :docker_run do
   STDOUT.puts "10. /usr/bin/gem push cosmos-X.X.X-java.gem"
   STDOUT.puts "11. cd /devel/cosmos-docker"
   STDOUT.puts "12. git pull"
-  STDOUT.puts "13. Update COSMOS_VERSION in all Dockerfiles"
+  STDOUT.puts "13. Update COSMOS_VERSION in all Dockerfiles. Also update README.md"
   STDOUT.puts "14. git commit -a -m \"Release COSMOS vX.X.X\""
   STDOUT.puts "15. git push"
   STDOUT.puts "16. git checkout -b vX.X.X"
   STDOUT.puts "17. git push --set-upstream origin vX.X.X"
   STDOUT.puts "18. Update release notes on github.com and cosmosrb.com"
   
-  _, platform, *_ = RUBY_PLATFORM.split("-")
-  if (platform == 'mswin32' or platform == 'mingw32') and which('winpty')
-    system('winpty docker run -it --rm cosmos-dev')
-  else
-    system('docker run -it --rm cosmos-dev')
-  end  
+  system('docker run -it --rm cosmos-dev')
 end

data/bin/rubysloc

@@ -13,25 +13,72 @@
 # Blank lines and comment lines are ignored.  All other
 # lines count as one line.
 
-files = []
-if ARGV.length == 0
-  require 'find'
+require 'ostruct'
+require 'optparse'
+
+options = OpenStruct.new
+options.filename = nil
+options.sort_column = nil
 
-  #Find all .rb and .rbw files from the current directory
-  Find.find('.') do |path|
-    Find.prune if FileTest.directory?(path) and File.basename(path) == 'pkg'
-    extension = File.extname(path)
-    files << path if extension.to_s =~ /\.rb/i
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: rubysloc"
+  opts.separator ""
+  opts.separator "Recursively calculate SLOC for all ruby files (*.rb) sorted by filename"
+  opts.separator ""
+  opts.on("-h", "--help", "Show this message") do
+    puts opts
+    exit
   end
-else
-  if ARGV[0] == '--infile' or ARGV[0] == '-i'
-    File.open(ARGV[1], 'r') {|file| file.each_line {|line| files << line.chomp.strip}}
+  opts.on("-i DIRECTORY/FILENAME", "--input DIRECTORY/FILENAME",
+    "Parse only the specified directory/filename (relative or absolute path)") do |arg|
+    options.filename = arg
+  end
+  opts.on("-s SORT", "--sort SORT", "Sort by the specified column. Must be one of LINES, COMMENTS, SLOC, or RATIO.") do |arg|
+    case arg
+    when 'LINES'
+      options.sort_column = 1
+    when 'COMMENTS'
+      options.sort_column = 2
+    when 'SLOC'
+      options.sort_column = 3
+    when 'RATIO'
+      options.sort_column = 4
+    else
+      puts opts
+      exit
+    end
+  end
+end
+
+begin
+  opts.parse!(ARGV)
+rescue => err
+  puts err
+  puts opts
+  exit
+end
+
+files = []
+if options.filename
+  options.filename = File.join(Dir.pwd, options.filename) unless File.exist?(options.filename)
+  if File.exist?(options.filename)
+    if File.directory?(options.filename)
+      # Dir only works with unix paths so swap backslashes
+      files = Dir[File.join(options.filename.gsub('\\','/'), '**', '*.rb')]
+    else
+      files << options.filename
+    end
   else
-    files = ARGV
+    puts "File #{options.filename} not found."
+    puts opts
+    exit
   end
+else
+  files = Dir['**/*.rb']
 end
 
 # Build results over all found ruby files
+longest_path = 1
 results = []
 files.each do |full_filename|
   filename = File.basename(full_filename)
@@ -43,21 +90,20 @@ files.each do |full_filename|
       lines += 1
       split_line = line.split
       if split_line[0].nil?
-        #Blank Line - Do Nothing
-        #puts "NOT COUNTED - #{line.chomp}"
+        # Blank Line - Do Nothing
       elsif split_line[0].to_s[0..0] == '#'
-        #Comment Line
-        #puts "COMMENT LINE - #{line.chomp}"
         comments += 1
       else
-        #puts "COUNTED - #{line.chomp}"
         slocs += 1
       end
     end
-    results << [filename, lines, comments, slocs, comments.to_f / slocs.to_f]
+    results << [full_filename, lines, comments, slocs, comments.to_f / slocs.to_f]
+    longest_path = full_filename.length if full_filename.length > longest_path
   end
 end
 
+results.sort_by! {|col| col[options.sort_column].finite? ? col[options.sort_column] : -1 } if options.sort_column
+
 # Print results to STDOUT
 total_files    = 0
 total_lines    = 0
@@ -65,12 +111,12 @@ total_comments = 0
 total_slocs    = 0
 total_ratio    = 0
 
-puts "|-----------------------------------|----------|----------|----------|--------|"
-puts "| Filename                          |  Lines   | Comments |  SLOCs   |  Ratio |"
-puts "|-----------------------------------|----------|----------|----------|--------|"
+puts sprintf("|-%-#{longest_path}s-|----------|----------|----------|--------|", "-"*longest_path)
+puts sprintf("| %-#{longest_path}s |  Lines   | Comments |  SLOCs   |  Ratio |", "Filename")
+puts sprintf("|-%-#{longest_path}s-|----------|----------|----------|--------|", "-"*longest_path)
 results.each do |filename, lines, comments, slocs, ratio|
-  filename = filename[0..32] if filename.length > 33
-  puts sprintf("| %-33s | %8d | %8d | %8d | %6.2f |",
+  # filename = filename[0..32] if filename.length > 33
+  puts sprintf("| %-#{longest_path}s | %8d | %8d | %8d | %6.2f |",
                filename, lines, comments, slocs, ratio)
   total_files    += 1
   total_lines    += lines
@@ -78,8 +124,7 @@ results.each do |filename, lines, comments, slocs, ratio|
   total_slocs    += slocs
 end
 total_ratio = total_comments.to_f / total_slocs.to_f if total_slocs != 0
-puts "|-----------------------------------|----------|----------|----------|--------|"
-puts sprintf("| Totals - %3d Files                | %8d | %8d | %8d | %6.2f |",
-             total_files, total_lines, total_comments, total_slocs, total_ratio)
-
-puts "|-----------------------------------|----------|----------|----------|--------|"
+puts sprintf("|-%-#{longest_path}s-|----------|----------|----------|--------|", "-"*longest_path)
+puts sprintf("| %-#{longest_path}s | %8d | %8d | %8d | %6.2f |",
+  "Totals - #{total_files} Files", total_lines, total_comments, total_slocs, total_ratio)
+puts sprintf("|-%-#{longest_path}s-|----------|----------|----------|--------|", "-"*longest_path)

data/cosmos.gemspec

@@ -113,7 +113,7 @@ spec = Gem::Specification.new do |s|
   s.add_development_dependency 'guard-rspec', '~> 4.0'
   s.add_development_dependency 'simplecov', '~> 0.15'
   s.add_development_dependency 'codecov', '~> 0.1'
-  s.add_development_dependency 'benchmark-ips', '~> 2.0'
+  s.add_development_dependency 'benchmark-ips', '= 2.7.2'
   s.add_development_dependency 'ruby-prof', ['~> 1.0', '< 1.3'] if RUBY_ENGINE == 'ruby' # MRI Only
 
   s.post_install_message = "Thanks for installing Ball Aerospace COSMOS!\nStart your first project with: cosmos demo demo\n"

data/data/config/interface_modifiers.yaml

@@ -84,8 +84,9 @@ OPTION:
     - name: Name
       required: true
       description: The option to set. COSMOS defines several options on the core provided
-        interfaces. The SerialInterface defines FLOW_CONTROL which can be NONE (default) or RTSCTS
-        and DATA_BITS which changes the data bits of the serial interface.
+        interfaces. The SerialInterface defines FLOW_CONTROL which can be NONE (default) or RTSCTS,
+        STRUCT to directly set fields in the Windows DCB or POSIX structure and it defines
+        DATA_BITS which changes the data bits of the serial interface.
         The TcpipServerInterface defines LISTEN_ADDRESS which is the IP address to accept
         connections on (default 0.0.0.0) and AUTO_SYSTEM_META which will automatically send
         SYSTEM META when the interface connects (default false).

data/data/config/system.yaml

@@ -1,7 +1,8 @@
 ---
 AUTO_DECLARE_TARGETS:
   summary: Automatically load all the target folders under config/targets into the system
-  description: When automatically discovering target folders the COSMOS naming convention
+  description:
+    When automatically discovering target folders the COSMOS naming convention
     must be followed. Target folders must be uppercase and be named according to how
     COSMOS will access them. For example, if you create a config/targets/INST directory,
     COSMOS will create a target named 'INST' which is how it will be referenced.
@@ -9,7 +10,8 @@ AUTO_DECLARE_TARGETS:
     DECLARE_TARGET keyword.
 DECLARE_TARGET:
   summary: Declare a COSMOS target and name it
-  description: Declare target is used in place of AUTO_DECLARE_TARGETS to give more
+  description:
+    Declare target is used in place of AUTO_DECLARE_TARGETS to give more
     fine grained control over how the target folder is loaded and named within COSMOS.
     This is required if AUTO_DECLARE_TARGET is not present.
   example: DECLARE_TARGET INST INST2 inst.txt
@@ -26,7 +28,8 @@ DECLARE_TARGET:
         the target name will be the directory name given above.
     - name: Target Filename
       required: false
-      description: The name of the file in the target directory which contains the
+      description:
+        The name of the file in the target directory which contains the
         configuration information for the target. By default this is 'target.txt'
         but if you want to rename this you need to set this parameter.
 DECLARE_GEM_TARGET:
@@ -38,7 +41,8 @@ DECLARE_GEM_TARGET:
   parameters:
     - name: Gem Name
       required: true
-      description: The COSMOS gem name which must be cosmos-<gem-name> where <gem-name>
+      description:
+        The COSMOS gem name which must be cosmos-<gem-name> where <gem-name>
         is the descriptive gem name. In the above example, the target will be named
         'GEM-NAME' (note the cosmos- prefix is stripped off).
       values: .+
@@ -49,7 +53,8 @@ DECLARE_GEM_TARGET:
         the target name will be the gem name as described above.
     - name: Target Filename
       required: false
-      description: The name of the file in the target directory which contains the
+      description:
+        The name of the file in the target directory which contains the
         configuration information for the target. By default this is 'target.txt'
         but if you want to rename this you need to set this parameter.
 DECLARE_GEM_MULTI_TARGET:
@@ -64,7 +69,8 @@ DECLARE_GEM_MULTI_TARGET:
   parameters:
     - name: Gem Name
       required: true
-      description: The COSMOS gem name which must be cosmos-<gem-name> where <gem-name>
+      description:
+        The COSMOS gem name which must be cosmos-<gem-name> where <gem-name>
         is the descriptive gem name. In the above example, the target will be named
         'GEM-NAME' (note the cosmos- prefix is stripped off).
       values: .+
@@ -80,12 +86,14 @@ DECLARE_GEM_MULTI_TARGET:
         the target name will be the gem name as described above.
     - name: Target Filename
       required: false
-      description: The name of the file in the target directory which contains the
+      description:
+        The name of the file in the target directory which contains the
         configuration information for the target. By default this is 'target.txt'
         but if you want to rename this you need to set this parameter.
 PORT:
   summary: Set a Server Port
-  description: Port is used to set the default ports used by the Command and Telemetry Server.
+  description:
+    Port is used to set the default ports used by the Command and Telemetry Server.
     It is not necessary to set this option unless you wish to override the defaults
     (given in the example usage). Overriding ports is necessary if you want to run
     two Command and Telemetry Servers on the same computer simultaneously.
@@ -96,7 +104,8 @@ PORT:
   parameters:
     - name: Port Name
       required: true
-      description: CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
+      description:
+        CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
         TLMVIEWER_API - This port is used to remotely open and close telemetry screens in Telemetry Viewer.
         CTS_PREIDENTIFIED - This port provides access to a preidentified stream of all telemetry packets
         in the system. This is currently used by Telemetry Grapher and can be used to chain Command
@@ -114,7 +123,8 @@ LISTEN_HOST:
   parameters:
     - name: Host Port Name
       required: true
-      description: CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
+      description:
+        CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
         TLMVIEWER_API - This port is used to remotely open and close telemetry screens in Telemetry Viewer.
         CTS_PREIDENTIFIED - This port provides access to a preidentified stream of all telemetry packets
         in the system. This is currently used by Telemetry Grapher and can be used to chain Command
@@ -124,7 +134,8 @@ LISTEN_HOST:
       values: <%= %w(CTS_API TLMVIEWER_API CTS_PREIDENTIFIED CTS_CMD_ROUTER) %>
     - name: Host Value
       required: true
-      description: The IP address or host name to bind the Host Port Name to. By default,
+      description:
+        The IP address or host name to bind the Host Port Name to. By default,
         the CTS_API and TLMVIEWER_API are bound to localhost meaning that only tools
         on the same machine can connect. By default, CTS_PREIDENTIFIED and CTS_CMD_ROUTER
         are bound to '0.0.0.0' to allow for tools on any machines to connect. This
@@ -136,7 +147,8 @@ CONNECT_HOST:
   parameters:
     - name: Host Port Name
       required: true
-      description: CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
+      description:
+        CTS_API - This port is what tools connect to to communicate with the COSMOS Scripting API.
         TLMVIEWER_API - This port is used to remotely open and close telemetry screens in Telemetry Viewer.
         CTS_PREIDENTIFIED - This port provides access to a preidentified stream of all telemetry packets
         in the system. This is currently used by Telemetry Grapher and can be used to chain Command
@@ -146,15 +158,18 @@ CONNECT_HOST:
       values: <%= %w(CTS_API TLMVIEWER_API CTS_PREIDENTIFIED CTS_CMD_ROUTER) %>
     - name: Host Value
       required: true
-      description: The IP address or host name to connect tools to. By default all
+      description:
+        The IP address or host name to connect tools to. By default all
         ports are bound to localhost so all tools connect to the local machine.
       values: .+
 PATH:
   summary: Set a Server Path
-  description: Path is used to set the default paths used by the Command and Telemetry Server
+  description:
+    Path is used to set the default paths used by the Command and Telemetry Server
     to access or create files. It is not necessary to set this option unless you wish to
     override the defaults (given in the example usage).
-  warning: The PROCEDURES path must be set for Script Runner and Test Runner to locate your
+  warning:
+    The PROCEDURES path must be set for Script Runner and Test Runner to locate your
     procedure files. You can add multiple 'PATH PROCEDURES' lines to your configuration file
     to set multiple locations.
   example: |
@@ -205,7 +220,8 @@ DEFAULT_PACKET_LOG_READER:
       since: 4.0.0
 STALENESS_SECONDS:
   summary: Number of seconds before marking the packet stale
-  description: A stale packet is identified in telemetry screens by all the telemetry
+  description:
+    A stale packet is identified in telemetry screens by all the telemetry
     items in the stale packet being colored purple..
   example: STALENESS_SECONDS 30 # Default
   parameters:
@@ -227,7 +243,8 @@ DISABLE_DNS:
     As of COSMOS 3.5.0 the default is to not use DNS
 ENABLE_SOUND:
   summary: Enable audible sounds when popups occur
-  description: Enable sound makes any prompts that occur in ScriptRunner/TestRunner
+  description:
+    Enable sound makes any prompts that occur in ScriptRunner/TestRunner
     make an audible sound when they popup to alert the operator of needed input.
   since: 3.5.0
 ALLOW_ACCESS:
@@ -236,12 +253,14 @@ ALLOW_ACCESS:
   parameters:
     - name: Name or IP Address
       required: true
-      description: Machine name to allow access or you can specify 'ALL' to allow
+      description:
+        Machine name to allow access or you can specify 'ALL' to allow
         all machines access
       values: .+
 META_INIT:
   summary: Specify a file to initialize the SYSTEM META packet
-  description: Filename should be a text file with key value pairs where the keyword
+  description:
+    Filename should be a text file with key value pairs where the keyword
     matches an item in the SYSTEM META packet. Note you do not have to specify ALL
     the items in the SYSTEM META packet.
   since: 4.0.0
@@ -252,7 +271,8 @@ META_INIT:
       values: .+
 TIME_ZONE_UTC:
   summary: Report all times as UTC
-  description: COSMOS will report all times as UTC time. If this keyword is not used,
+  description:
+    COSMOS will report all times as UTC time. If this keyword is not used,
     COSMOS will report all times as local times, where the local time zone is determined
     automatically by Ruby based upon the operating system time settings. This setting
     affects packet receive times, timestamped log filenames, message logs,
@@ -260,7 +280,8 @@ TIME_ZONE_UTC:
   since: 3.10.0
 ADD_HASH_FILE:
   summary: Add a file to the hashing sum calculation
-  description: Adds a file to the set of files used in marshal file hashing sum calculation.
+  description:
+    Adds a file to the set of files used in marshal file hashing sum calculation.
     Upon startup, COSMOS calculates a hashing sum over the command/telemetry definition files
     for all targets. After the definitions have been processed, COSMOS saves the resulting
     objects as marshal files in a folder with the hashing sum as part of the name.
@@ -288,11 +309,11 @@ CLASSIFICATION:
     - name: Display Text
       required: true
       description: The text to display in the classification banner
-      values: '.*'
+      values: ".*"
     - name: Color Name | Red Hex
       required: true
       description: The color name or the red value of a RGB triplet
-      values: '.*'
+      values: ".*"
     - name: Green Hex
       required: false
       description: The green value of a RGB triplet
@@ -303,7 +324,8 @@ CLASSIFICATION:
       values: '\d+'
 HASHING_ALGORITHM:
   summary: Specify which Ruby Digest hashing algorithm to use
-  description: Set the hashing algorithm used for config hashing, tlm_viewer hashing, and
+  description:
+    Set the hashing algorithm used for config hashing, tlm_viewer hashing, and
     script hashing. COSMOS will truncate the resulting hash string down to 32 characters
   since: 4.4.0
   example: HASHING_ALGORITHM SHA256
@@ -312,3 +334,38 @@ HASHING_ALGORITHM:
       required: true
       description: Digest algorithm, one of MD5, RMD160, SHA1, SHA256, SHA384, SHA512
       values: .+
+ALLOW_ROUTER_COMMANDING:
+  summary: Allow routers to receive and forward commands to interfaces
+  since: 4.5.0
+  example: ALLOW_ROUTER_COMMANDING
+X_CSRF_TOKEN:
+  summary: Secret token passed with API calls
+  since: 4.5.0
+  example: X_CSRF_TOKEN Secret
+  parameters:
+    - name: token
+      required: true
+      description: Token passed with api calls
+      values: .+
+ALLOW_ORIGIN:
+  summary: Allow a specific HTTP Origin header in Api calls
+  description: This keyword should only be used if COSMOS needs to be commanded from a web server.
+  since: 4.5.0
+  example: ALLOW_ORIGIN 1.2.4.4:8080
+  parameters:
+    - name: origin
+      required: true
+      description: Hostname colon port of origin
+      values: .+
+ALLOW_HOST:
+  summary: Allow a specific HTTP Host header in Api calls
+  description:
+    By default includes ['127.0.0.1:7777', '127.0.0.1:7778', '127.0.0.1:7877', '127.0.0.1:8779', '127.0.0.1:8780'].
+    API Ports changed by a PORT line will also be added automatically.  If you need external connections you must add your ip and
+    these ports to allow external access to work for apis
+  example: ALLOW_HOST 1.2.4.4:7777
+  parameters:
+    - name: host
+      required: true
+      description: Hostname colon port of host
+      values: .+