gemstash 2.2.2 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 883f183c2cf5a6ca30759bfab7d7c7365690582c638245fe2f41a7c0b9983664
-  data.tar.gz: a569afac24f8d256b663e01094ca66b5c60692e0496234ddbf4b61c15feac901
+  metadata.gz: bd46773c2778aa8664f4972184d669f2c92a6b8c5a2bef94353e86f86f407a4d
+  data.tar.gz: 4aa4859b8283f044b335e009ad6264538ff980c1b7c1be8279e3fd084d9cf1f3
 SHA512:
-  metadata.gz: 3d51cbb59194b727c963e67fbdadbe013cea2e5edea651c10d0564eb21ee231023d0ca0c3c45f74b0550eee0474a7218b83fd72d51da425557ee375f062fe03d
-  data.tar.gz: d2dfaa9aed272d9685a96d17429b3e68ba1ac6328f4fc6175ebaff490176dfcecb44658cec69105e9ba8dc41ab5b30fd152035f874bd57d83b60195fc65922ba
+  metadata.gz: 5a8754257c4884e036c475621ebd6e2ca80033031494ca4f744ac4683cdabf5fba8c58e9ec9c5221f28d98fa5d4e699d400b7c3a80acb720e4fd939a6ba72671
+  data.tar.gz: 42f293520533a0681bbf558209c10748052938664dd51bb598f28e4bf8f52d49a781a0644b1ac4f65d6b76989fb7a2865f230eb5b5b9d50889ca4579ed02f795

data/CHANGELOG.md

@@ -1,29 +1,81 @@
+## 2.7.1 (2023-10-12)
+
+### Fixes
+
+  - Reinstate NOOP --daemonize and --no-daemonize that warn about them doing nothing. ([#381](https://github.com/rubygems/gemstash/pull/381) [@olleolleolle](https://github.com/olleolleolle))
+
+## 2.7.0 (2023-10-08)
+
+### Fixes
+
+  - Fix uninitialized constant error when using Redis cache ([#375](https://github.com/rubygems/gemstash/pull/375), [@chris72205](https://github.com/chris72205))
+  - Remove --daemonize option, no longer supported by Puma. ([#359](https://github.com/rubygems/gemstash/issues/359) [@olleolleolle](https://github.com/olleolleolle))
+
+## 2.6.0 (2023-09-30)
+
+### Changes
+
+  - Support `GEMSTASH_CONFIG` environment variable ([#369](https://github.com/rubygems/gemstash/pull/369), [@kyrofa](https://github.com/kyrofa))
+
+## 2.5.0 (2023-09-28)
+
+### Changes
+
+  - Add support for upstream auth with ENV variables ([#339](https://github.com/rubygems/gemstash/pull/339), [@CiTroNaK](https://github.com/CiTroNaK))
+
+## 2.4.0 (2023-09-27)
+
+### Changes
+
+  - Support naming and listing authorizations ([#365](https://github.com/rubygems/gemstash/pull/365), [@kyrofa](https://github.com/kyrofa))
+
+## 2.3.2 (2023-09-14)
+
+### Fixes
+
+  - Require a now-needed file for Puma 6. Thanks, @ktreis! ([#362](https://github.com/rubygems/gemstash/pull/362), [@olleolleolle](https://github.com/olleolleolle))
+
+## 2.3.1 (2023-09-05)
+
+### Fixes
+
+  - Reinstate Ruby Central in README. ([#353](https://github.com/rubygems/gemstash/pull/353), [@olleolleolle](https://github.com/olleolleolle))
+  - Implement Puma 5-required logger method `#sync` ([#355](https://github.com/rubygems/gemstash/pull/355), [@ball-hayden](https://github.com/ball-hayden))
+
+## 2.3.0 (2023-08-30)
+
+### Changes
+
+  - Support Puma 6. ([#335](https://github.com/rubygems/gemstash/pull/335), [@MSP-Greg](https://github.com/MSP-Greg))
+  - Make UpstreamSource intermediate specs from upstream. ([#337](https://github.com/rubygems/gemstash/pull/337), [@tedgarb](https://github.com/tedgarb))
+  - Mention RubyCentral. ([#338](https://github.com/rubygems/gemstash/pull/338), [@adarsh](https://github.com/adarsh))
+  - Configure Dependabot. ([#341](https://github.com/rubygems/gemstash/pull/341), [@olleolleolle](https://github.com/olleolleolle))
+
 ## 2.2.2 (2023-03-03)
 
 ### Changes
 
-- Allow newer versions of the `activesupport` dependency ([#332](https://github.com/rubygems/gemstash/pull/332), [@kyrofa][])
+  - Allow newer versions of the `activesupport` dependency ([#332](https://github.com/rubygems/gemstash/pull/332), [@kyrofa](https://github.com/kyrofa))
 
 ## 2.2.1 (2023-02-09)
 
 ### Bugfixes
 
-- Add permitted classes to a `YAML.load` in cache ([#329](https://github.com/rubygems/gemstash/pull/329), [@SocalNick][])
+  - Add permitted classes to a `YAML.load` in cache ([#329](https://github.com/rubygems/gemstash/pull/329), [@SocalNick](https://github.com/SocialNick))
 
 ## 2.2.0 (2023-01-27)
 
 ### Bugfixes
 
-- Respect auth set in upstream host uri ([#317](https://github.com/rubygems/gemstash/pull/317), [@jebentier][])
-- Change the response code for "/versions" from 403 to 404 ([#326](https://github.com/rubygems/gemstash/pull/326), [@hendric-dev][])
+  - Respect auth set in upstream host uri ([#317](https://github.com/rubygems/gemstash/pull/317), [@jebentier](https://github.com/jbentier))
+  - Change the response code for "/versions" from 403 to 404 ([#326](https://github.com/rubygems/gemstash/pull/326), [@hendric-dev](https://github.com/hendric-dev))
 
 ### Changes
 
-- Support Ruby 3 ([#312](https://github.com/rubygems/gemstash/pull/312), [@tonytonyjan][])
-- Drop support for EOL Ruby versions 2.4, 2.5, 2.6 ([#328](https://github.com/rubygems/gemstash/pull/328), [@indirect][])
-- Update `dalli` dependency ([#324](https://github.com/rubygems/gemstash/pull/324), [@indirect][])
-
-Also thanks to: [@indirect][] and [@hsbt][] who fixed CI issues and lint warnings.
+  - Support Ruby 3 ([#312](https://github.com/rubygems/gemstash/pull/312), [@tonytonyjan](https://github.com/tonytonyjan))
+  - Drop support for EOL Ruby versions 2.4, 2.5, 2.6 ([#328](https://github.com/rubygems/gemstash/pull/328), [@indirect](https://github.com/indirect))
+  - Update `dalli` dependency ([#324](https://github.com/rubygems/gemstash/pull/324), [@indirect](https://github.com/indirect))
+  - Also thanks to: [@indirect][] and [@hsbt][] who fixed CI issues and lint warnings.
 
 ## 2.1.0 (2020-02-26)
 
@@ -262,11 +314,3 @@ Also thanks to: [@indirect][] and [@hsbt][] who fixed CI issues and lint warning
   - Various fixes 2 ([#47](https://github.com/bundler/gemstash/pull/47), [@smellsblue](https://github.com/smellsblue))
   - Various fixes 3 ([#49](https://github.com/bundler/gemstash/pull/49), [@smellsblue](https://github.com/smellsblue))
   - Add Gemtash logo ([#50](https://github.com/bundler/gemstash/pull/50), [@jonathanrieta](https://github.com/jonathanrieta))
-
-[@SocalNick]:  https://github.com/SocalNick
-[@hendric-dev]: https://github.com/hendric-dev
-[@hsbt]: https://github.com/hsbt
-[@indirect]: https://github.com/indirect
-[@jebentier]: https://github.com/jebentier
-[@kyrofa]: https://github.com/kyrofa
-[@tonytonyjan]: https://github.com/tonytonyjan

data/lib/gemstash/authorization.rb

@@ -13,7 +13,9 @@ module Gemstash
     extend Gemstash::Logging
     VALID_PERMISSIONS = %w[push yank fetch].freeze
 
-    def self.authorize(auth_key, permissions)
+    attr_reader :name
+
+    def self.authorize(auth_key, permissions, name = nil)
       raise "Authorization key is required!" if auth_key.to_s.strip.empty?
       raise "Permissions are required!" if permissions.to_s.empty?
 
@@ -25,7 +27,7 @@ module Gemstash
         permissions = permissions.join(",")
       end
 
-      Gemstash::DB::Authorization.insert_or_update(auth_key, permissions)
+      Gemstash::DB::Authorization.insert_or_update(auth_key, permissions, name)
       gemstash_env.cache.invalidate_authorization(auth_key)
       log.info "Authorization '#{auth_key}' updated with access to '#{permissions}'"
     end
@@ -62,6 +64,7 @@ module Gemstash
 
     def initialize(record)
       @auth_key = record.auth_key
+      @name = record.name
       @all = record.permissions == "all"
       @permissions = Set.new(record.permissions.split(","))
     end

data/lib/gemstash/cli/authorize.rb

@@ -2,6 +2,7 @@
 
 require "gemstash"
 require "securerandom"
+require "terminal-table"
 
 module Gemstash
   class CLI
@@ -12,8 +13,13 @@ module Gemstash
         prepare
         setup_logging
 
+        # Catch invalid option combinations
+        raise Gemstash::CLI::Error.new(@cli, "--remove and --list cannot both be used") if @cli.options[:remove] && @cli.options[:list]
+
         if @cli.options[:remove]
           remove_authorization
+        elsif @cli.options[:list]
+          list_authorizations
         else
           save_authorization
         end
@@ -26,6 +32,8 @@ module Gemstash
       end
 
       def remove_authorization
+        raise Gemstash::CLI::Error.new(@cli, "--name cannot be used with --remove") if @cli.options[:remove] && @cli.options[:name]
+
         unless @args.empty?
           raise Gemstash::CLI::Error.new(@cli, "To remove individual permissions, you do not need --remove
 Instead just authorize with the new set of permissions")
@@ -43,7 +51,24 @@ Instead just authorize with the new set of permissions")
           end
         end
 
-        Gemstash::Authorization.authorize(auth_key, permissions)
+        begin
+          name = @cli.options[:name]
+          Gemstash::Authorization.authorize(auth_key, permissions, name)
+        rescue Sequel::UniqueConstraintViolation => e
+          raise unless name && e.message.include?("authorizations.name")
+
+          raise Gemstash::CLI::Error.new(@cli, "Authorization with name '#{name}' already exists")
+        end
+      end
+
+      def list_authorizations
+        raise Gemstash::CLI::Error.new(@cli, "--key and --name cannot both be used with --list") if @cli.options[:name] && @cli.options[:key]
+
+        rows = map_authorizations(@cli.options[:key], @cli.options[:name]) do |authorization|
+          [authorization.name, authorization.auth_key, authorization.permissions]
+        end
+
+        @cli.say Terminal::Table.new :headings => %w[Name Key Permissions], :rows => rows
       end
 
       def auth_key(allow_generate: true)
@@ -66,6 +91,22 @@ Instead just authorize with the new set of permissions")
           @args
         end
       end
+
+      def map_authorizations(key = nil, name = nil, &block)
+        return Gemstash::DB::Authorization.map(&block) unless name || key
+
+        authorization = if name
+          Gemstash::DB::Authorization[name: name].tap do |authorization|
+            raise Gemstash::CLI::Error.new(@cli, "No authorization named '#{name}'") unless authorization
+          end
+        else
+          Gemstash::DB::Authorization[auth_key: key].tap do |authorization|
+            raise Gemstash::CLI::Error.new(@cli, "No authorization with key '#{key}'") unless authorization
+          end
+        end
+
+        [yield(authorization)]
+      end
     end
   end
 end

data/lib/gemstash/cli/setup.rb

@@ -90,8 +90,8 @@ module Gemstash
 
       def ask_redis_details
         say_current_config(:redis_servers, "Current Redis servers")
-        servers = @cli.ask "What is the comma-separated list of Redis servers? [localhost:6379]"
-        servers = "localhost:6379" if servers.empty?
+        servers = @cli.ask "What is the comma-separated list of Redis servers? [redis://localhost:6379]"
+        servers = "redis://localhost:6379" if servers.empty?
         @config[:redis_servers] = servers
       end
 

data/lib/gemstash/cli/start.rb

@@ -10,47 +10,27 @@ module Gemstash
     class Start < Gemstash::CLI::Base
       def run
         prepare
-        setup_logging
-        store_daemonized
         @cli.say("Starting gemstash!", :green)
+        case @cli.options[:daemonize]
+        when false then warn "The --no-daemonize option was removed and has no effect."
+        when true then warn "The --daemonize option was removed and has no effect."
+        end
         Puma::CLI.new(args, Gemstash::Logging::StreamLogger.puma_events).run
       end
 
     private
 
-      def setup_logging
-        return unless daemonize?
-
-        Gemstash::Logging.setup_logger(gemstash_env.log_file)
-      end
-
-      def store_daemonized
-        Gemstash::Env.daemonized = daemonize?
-      end
-
-      def daemonize?
-        @cli.options[:daemonize]
-      end
-
       def puma_config
         File.expand_path("../puma.rb", __dir__)
       end
 
       def args
-        config_args + pidfile_args + daemonize_args
+        config_args + pidfile_args
       end
 
       def config_args
         ["--config", puma_config]
       end
-
-      def daemonize_args
-        if daemonize?
-          ["--daemon"]
-        else
-          []
-        end
-      end
     end
   end
 end

data/lib/gemstash/cli.rb

@@ -51,10 +51,14 @@ module Gemstash
     desc "authorize [PERMISSIONS...]", "Add authorizations to push/yank private gems"
     method_option :remove, :type => :boolean, :default => false, :desc =>
       "Remove an authorization key"
+    method_option :list, :type => :boolean, :default => false, :desc =>
+      "List existing authorization keys"
     method_option :config_file, :type => :string, :desc =>
       "Config file to save to"
     method_option :key, :type => :string, :desc =>
       "Authorization key to create/update/delete (optional unless deleting)"
+    method_option :name, :type => :string, :desc =>
+      "Name of the key (optional)"
     def authorize(*args)
       Gemstash::CLI::Authorize.new(self, *args).run
     end
@@ -71,8 +75,8 @@ module Gemstash
     end
 
     desc "start", "Starts your gemstash server"
-    method_option :daemonize, :type => :boolean, :default => true, :desc =>
-      "Daemonize the server"
+    method_option :daemonize, :type => :boolean, :default => nil, :desc =>
+       "No effect - functionality removed, option kept for compatibility"
     method_option :config_file, :type => :string, :desc =>
       "Config file to load when starting"
     def start

data/lib/gemstash/config.ru

@@ -6,8 +6,6 @@ require "puma/commonlogger"
 use Rack::Deflater
 use Gemstash::Logging::RackMiddleware
 
-use Puma::CommonLogger, Gemstash::Logging::StreamLogger.for_stdout if Gemstash::Env.daemonized?
-
 use Gemstash::Env::RackMiddleware, Gemstash::Env.current
 use Gemstash::GemSource::RackMiddleware
 use Gemstash::Health::RackMiddleware

data/lib/gemstash/configuration.rb

@@ -75,6 +75,11 @@ module Gemstash
   private
 
     def default_file
+      # Support the config file being specified via environment variable
+      gemstash_config = ENV["GEMSTASH_CONFIG"]
+      return gemstash_config if gemstash_config
+
+      # If no environment variable is used, fall back to the normal defaults
       File.exist?("#{DEFAULT_FILE}.erb") ? "#{DEFAULT_FILE}.erb" : DEFAULT_FILE
     end
 

data/lib/gemstash/db/authorization.rb

@@ -6,14 +6,14 @@ module Gemstash
   module DB
     # Sequel model for authorizations table.
     class Authorization < Sequel::Model
-      def self.insert_or_update(auth_key, permissions)
+      def self.insert_or_update(auth_key, permissions, name = nil)
         db.transaction do
           record = self[auth_key: auth_key]
 
           if record
-            record.update(permissions: permissions)
+            record.update(permissions: permissions, name: name)
           else
-            create(auth_key: auth_key, permissions: permissions)
+            create(auth_key: auth_key, permissions: permissions, name: name)
           end
         end
       end

data/lib/gemstash/env.rb

@@ -59,17 +59,6 @@ module Gemstash
       Thread.current[:gemstash_env] = value
     end
 
-    def self.daemonized?
-      raise "Daemonized hasn't been set yet!" if @daemonized.nil?
-
-      @daemonized
-    end
-
-    def self.daemonized=(value)
-      value = false if value.nil?
-      @daemonized = value
-    end
-
     def config
       @config ||= Gemstash::Configuration.new
     end

data/lib/gemstash/gem_source/upstream_source.rb

@@ -128,6 +128,21 @@ module Gemstash
         serve_cached(id, :gem)
       end
 
+      def serve_latest_specs
+        http_client = http_client_for(upstream)
+        http_client.get("latest_specs.4.8.gz")
+      end
+
+      def serve_prerelease_specs
+        http_client = http_client_for(upstream)
+        http_client.get("prerelease_specs.4.8.gz")
+      end
+
+      def serve_specs
+        http_client = http_client_for(upstream)
+        http_client.get("specs.4.8.gz")
+      end
+
     private
 
       def serve_cached(id, resource_type)

data/lib/gemstash/logging.rb

@@ -1,7 +1,13 @@
 # frozen_string_literal: true
 
 require "logger"
-require "puma/events"
+
+begin
+  require "puma/detect"
+  require "puma/log_writer" # Puma 6
+rescue LoadError
+  require "puma/events"
+end
 
 module Gemstash
   # :nodoc:
@@ -62,7 +68,9 @@ module Gemstash
     # Logger that looks like a stream, for Puma and Rack to log to.
     class StreamLogger
       def self.puma_events
-        Puma::Events.new(for_stdout, for_stderr)
+        # Puma 6 removed logging from Events and placed it in LogWriter
+        klass = Puma.const_defined?(:LogWriter) ? Puma::LogWriter : Puma::Events
+        klass.new(for_stdout, for_stderr)
       end
 
       def self.for_stdout
@@ -81,6 +89,10 @@ module Gemstash
 
       def sync=(_value); end
 
+      def sync
+        false
+      end
+
       def write(message)
         Gemstash::Logging.logger.add(@level, message)
       end

data/lib/gemstash/man/gemstash-authorize.1

@@ -1,66 +1,54 @@
 <!-- Automatically generated by Pandoc -->
-.\" Automatically generated by Pandoc 3.1
+.\" Automatically generated by Pandoc 3.1.8
 .\"
-.\" Define V font for inline verbatim, using C font in formats
-.\" that render this, and otherwise B font.
-.ie "\f[CB]x\f[]"x" \{\
-. ftr V B
-. ftr VI BI
-. ftr VB B
-. ftr VBI BI
-.\}
-.el \{\
-. ftr V CR
-. ftr VI CI
-. ftr VB CB
-. ftr VBI CBI
-.\}
 .TH "gemstash-authorize" "1" "October 9, 2015" "" ""
-.hy
 .SH Name
-.PP
 gemstash-authorize - Adds or removes authorization to interact with
 privately stored gems
 .SH Synopsis
-.PP
-\f[V]gemstash authorize [permissions] [--remove] [--key SECURE_KEY] [--config-file FILE]\f[R]
+\f[CR]gemstash authorize [permissions] [--remove] [--list] [--key SECURE_KEY] [--name NAME] [--config-file FILE]\f[R]
 .SH Description
-.PP
 Adds or removes authorization to interact with privately stored gems.
 .PP
 Any arguments will be used as specific permissions.
-Valid permissions include \f[V]push\f[R], \f[V]yank\f[R], and
-\f[V]fetch\f[R].
+Valid permissions include \f[CR]push\f[R], \f[CR]yank\f[R], and
+\f[CR]fetch\f[R].
 If no permissions are provided, then all permissions will be granted
 (including any that may be added in future versions of Gemstash).
 .SS Usage
 .IP
-.nf
-\f[C]
+.EX
 gemstash authorize
 gemstash authorize push yank
+gemstash authorize push --name my-auth
 gemstash authorize yank --key <secure-key>
 gemstash authorize --remove --key <secure-key>
-\f[R]
-.fi
+gemstash authorize --list
+.EE
 .SH Options
 .IP \[bu] 2
-\f[V]--config-file FILE\f[R]: Specify the config file to use.
+\f[CR]--config-file FILE\f[R]: Specify the config file to use.
 If you aren\[cq]t using the default config file at
-\f[V]\[ti]/.gemstash/config.yml\f[R] or
-\f[V]\[ti]/.gemstash/config.yml.erb\f[R], then you must specify the
+\f[CR]\[ti]/.gemstash/config.yml\f[R] or
+\f[CR]\[ti]/.gemstash/config.yml.erb\f[R], then you must specify the
 config file via this option.
 .IP \[bu] 2
-\f[V]--key SECURE_KEY\f[R]: Specify the API key to affect.
+\f[CR]--key SECURE_KEY\f[R]: Specify the API key to affect.
 This should be the actual key value, not a name.
-This option is required when using \f[V]--remove\f[R] but is optional
+This option is required when using \f[CR]--remove\f[R] but is optional
 otherwise.
 If adding an authorization, using this will either create or update the
 permissions for the specified API key.
 If missing, a new API key will always be generated.
 Note that a key can only have a maximum length of 255 chars.
 .IP \[bu] 2
-\f[V]--remove\f[R]: Remove an authorization rather than add or update
+\f[CR]--name\f[R]: Name of the authorization.
+Purely for ease of identification, not required.
+.IP \[bu] 2
+\f[CR]--remove\f[R]: Remove an authorization rather than add or update
 one.
 When removing, permission values are not allowed.
-The \f[V]--key <secure-key>\f[R] option is required.
+The \f[CR]--key <secure-key>\f[R] option is required.
+.IP \[bu] 2
+\f[CR]--list\f[R]: List current authorizations.
+Provide \f[CR]--name\f[R] or \f[CR]--key\f[R] to show only one result.

data/lib/gemstash/man/gemstash-authorize.1.txt

@@ -1,6 +1,4 @@
-gemstash-authorize(1)					 gemstash-authorize(1)
-
-
+4mgemstash-authorize24m(1)				      4mgemstash-authorize24m(1)
 
 <!-- Automatically generated by Pandoc -->
 
@@ -9,40 +7,46 @@ gemstash-authorize(1)					 gemstash-authorize(1)
        privately stored gems
 
 1mSynopsis0m
-       1mgemstash authorize [permissions] [--remove] [--key SECURE_KEY]  [--con-0m
-       1mfig-file FILE]0m
+       gemstash authorize [permissions] [--remove] [--list] [--key SECURE_KEY]
+       [--name NAME] [--config-file FILE]
 
 1mDescription0m
        Adds or removes authorization to interact with privately stored gems.
 
-       Any  arguments will be used as specific permissions.  Valid permissions
-       include 1mpush22m, 1myank22m, and 1mfetch22m.  If no permissions  are  provided,  then
+       Any arguments will be used as specific permissions.  Valid  permissions
+       include	push,  yank,  and fetch.  If no permissions are provided, then
        all permissions will be granted (including any that may be added in fu-
        ture versions of Gemstash).
 
    1mUsage0m
 	      gemstash authorize
 	      gemstash authorize push yank
+	      gemstash authorize push --name my-auth
 	      gemstash authorize yank --key <secure-key>
 	      gemstash authorize --remove --key <secure-key>
+	      gemstash authorize --list
 
 1mOptions0m
-       o 1m--config-file FILE22m: Specify the config file to use.   If	you  aren't
-	 using	the  default  config file at 1m~/.gemstash/config.yml 22mor 1m~/.gem-0m
-	 1mstash/config.yml.erb22m, then you must specify the config file via  this
+       o --config-file FILE: Specify the config file to use.   If  you	aren't
+	 using	the  default  config file at ~/.gemstash/config.yml or ~/.gem-
+	 stash/config.yml.erb, then you must specify the config file via  this
 	 option.
 
-       o 1m--key  SECURE_KEY22m: Specify the API key to affect.  This should be the
+       o --key	SECURE_KEY: Specify the API key to affect.  This should be the
 	 actual key value, not a name.	This option  is  required  when  using
-	 1m--remove  22mbut is optional otherwise.  If adding an authorization, us-
+	 --remove  but is optional otherwise.  If adding an authorization, us-
 	 ing this will either create or update the permissions for the	speci-
 	 fied  API  key.   If missing, a new API key will always be generated.
 	 Note that a key can only have a maximum length of 255 chars.
 
-       o 1m--remove22m: Remove an authorization rather	than  add  or  update  one.
-	 When removing, permission values are not allowed.  The 1m--key <secure-0m
-	 1mkey> 22moption is required.
+       o --name: Name of the authorization.  Purely for  ease  of  identifica-
+	 tion, not required.
 
+       o --remove:  Remove  an	authorization  rather  than add or update one.
+	 When removing, permission values are not allowed.  The --key <secure-
+	 key> option is required.
 
+       o --list: List current authorizations.  Provide --name or --key to show
+	 only one result.
 
-				October 9, 2015 	 gemstash-authorize(1)
+				October 9, 2015 	 4mgemstash-authorize24m(1)