aspera-cli 4.14.0 → 4.15.0

data/lib/aspera/fasp/management.rb

@@ -0,0 +1,244 @@
+# frozen_string_literal: true
+
+module Aspera
+  module Fasp
+    # executes a local "ascp", connects mgt port, equivalent of "Fasp Manager"
+    class Management
+      # cspell: disable
+      OPERATIONS = %w[
+        NOP
+        START
+        QUERY
+        QUERYRSP
+        STATS
+        STOP
+        ERROR
+        CANCEL
+        DONE
+        RATE
+        FILEERROR
+        SESSION
+        NOTIFICATION
+        INIT
+        VLINK
+        NOTIFICATION
+        PUT
+        WRITE
+        CLOSE
+        SKIP
+        ARGSTOP
+      ]
+
+      PARAMETERS = %w[
+        Type
+        File
+        Size
+        Written
+        Bytescont
+        Rate
+        Loss
+        Query
+        Code
+        Password
+        Progress
+        Remaining
+        Elapsed
+        RexInfo
+        BlockInfo
+        DiskInfo
+        RateInfo
+        MinRate
+        Description
+        Elapsedusec
+        ServiceLevel
+        SessionId
+        User
+        Host
+        Encryption
+        Adaptive
+        Direction
+        Remote
+        Port
+        UserStr
+        CommandId
+        StartByte
+        EndByte
+        Token
+        Cookie
+        QueryResponse
+        Source
+        Destination
+        BWMeasurement
+        BWInfo
+        PMTU
+        TransferBytes
+        FileBytes
+        Operation
+        Delay
+        PreTransferFiles
+        PreTransferDirs
+        PreTransferSpecial
+        PreTransferFailed
+        PartialPreTransferBytes
+        PreTransferBytes
+        Priority
+        Transport
+        VlinkID
+        VlinkOn
+        VlinkCapIn
+        VlinkCapOut
+        ManifestFile
+        ArgScansAttempted
+        ArgScansCompleted
+        PathScansAttempted
+        PathScansFailed
+        PathScansIrregular
+        PathScansExcluded
+        DirScansCompleted
+        FileScansCompleted
+        DirCreatesAttempted
+        DirCreatesFailed
+        DirCreatesPassed
+        TransfersAttempted
+        TransfersFailed
+        TransfersPassed
+        TransfersSkipped
+        FallbackProtocol
+        RetryTimeout
+        PreTransferExcluded
+        XferId
+        XferRetry
+        Tags
+        FaspFileArgIndex
+        ArgTransfersStatus
+        ArgTransfersAttempted
+        ArgTransfersFailed
+        ArgTransfersPassed
+        ArgTransfersSkipped
+        FaspFileID
+        RateCap
+        MinRateCap
+        PolicyCap
+        PriorityCap
+        RateLock
+        MinRateLock
+        PolicyLock
+        FileChecksum
+        ServerHostname
+        ServerNodeId
+        ClientNodeId
+        ServerClusterId
+        ClientClusterId
+        FileChecksumType
+        ServerDocroot
+        ClientDocroot
+        NodeUser
+        ClientUser
+        SourcePrefix
+        RemoteAddress
+        TCPPort
+        Cipher
+        ResumePolicy
+        CreatePolicy
+        ManifestPolicy
+        Precalc
+        OverwritePolicy
+        RTTAutocorrect
+        TimePolicy
+        ManifestPath
+        ManifestInprogress
+        PartialFiles
+        FilesEncrypt
+        FilesDecrypt
+        DatagramSize
+        PrepostCommand
+        XoptFlags
+        VLinkVersion
+        PeerVLinkVersion
+        VLinkLocalEnabled
+        VLinkLocalId
+        VLinkLocalCL
+        VLinkRemoteEnabled
+        VLinkRemoteId
+        VLRemoteCL
+        DSPipelineDepth
+        PeerDSPipelineDepth
+        LocalIP
+        SourceBase
+        ReadBlockSize
+        WriteBlockSize
+        ClusterNumNodes
+        ClusterNodeId
+        MoveRange
+        MoveRangeLow
+        MoveRangeHigh
+        Keepalive
+        TestLogin
+        UseProxy
+        ProxyIP
+        RateControlAlgorithm
+        ClientMacAddress
+        Offset
+        ChunkSize
+        PostTransferValidation
+        OverwritePolicyCap
+        ExtraCreatePolicy]
+      # Management port start message
+      MGT_HEADER = 'FASPMGR 2'
+      # fields description for JSON generation
+      # spellchecker: disable
+      INTEGER_FIELDS = %w[Bytescont FaspFileArgIndex StartByte Rate MinRate Port Priority RateCap MinRateCap TCPPort CreatePolicy TimePolicy
+                          DatagramSize XoptFlags VLinkVersion PeerVLinkVersion DSPipelineDepth PeerDSPipelineDepth ReadBlockSize WriteBlockSize
+                          ClusterNumNodes ClusterNodeId Size Written Loss FileBytes PreTransferBytes TransferBytes PMTU Elapsedusec ArgScansAttempted
+                          ArgScansCompleted PathScansAttempted FileScansCompleted TransfersAttempted TransfersPassed Delay].freeze
+      BOOLEAN_FIELDS = %w[Encryption Remote RateLock MinRateLock PolicyLock FilesEncrypt FilesDecrypt VLinkLocalEnabled VLinkRemoteEnabled
+                          MoveRange Keepalive TestLogin UseProxy Precalc RTTAutocorrect].freeze
+      # cspell: enable
+
+      class << self
+        # translates legacy event into enhanced (JSON) event
+        def enhanced_event_format(event)
+          return event.keys.each_with_object({}) do |e, h|
+            # capital_to_snake_case
+            new_name = e
+                .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+                .gsub(/([a-z\d])(usec)$/, '\1_\2')
+                .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+                .downcase
+            value = event[e]
+            value = value.to_i if INTEGER_FIELDS.include?(e)
+            value = value.eql?('Yes') if BOOLEAN_FIELDS.include?(e)
+            h[new_name] = value
+          end
+        end
+      end # class << self
+
+      def initialize
+        @event_build = nil
+        @last_event = nil
+      end
+      attr_reader :last_event
+
+      def process_line(line)
+        # Log.log.debug{"line=[#{line}]"}
+        case line
+        when MGT_HEADER
+          # begin event
+          @event_build = {}
+        when /^([^:]+): (.*)$/
+          # event field
+          @event_build[Regexp.last_match(1)] = Regexp.last_match(2)
+        when ''
+          # empty line is separator to end event information
+          raise 'unexpected empty line' if @event_build.nil?
+          @last_event = @event_build
+          @event_build = nil
+          return @last_event
+        else
+          raise "unexpected line:[#{line}]"
+        end # case
+        return nil
+      end
+    end
+  end
+end

data/lib/aspera/fasp/parameters.rb

@@ -4,6 +4,9 @@ require 'aspera/log'
 require 'aspera/command_line_builder'
 require 'aspera/temp_file_manager'
 require 'aspera/fasp/error'
+require 'aspera/fasp/installation'
+require 'aspera/cli/formatter'
+require 'aspera/rest'
 require 'securerandom'
 require 'base64'
 require 'json'
@@ -16,11 +19,11 @@ module Aspera
     # translate transfer specification to ascp parameter list
     class Parameters
       # Agents shown in manual for parameters (sub list)
-      SUPPORTED_AGENTS = %i[direct node connect].freeze
+      SUPPORTED_AGENTS = %i[direct node connect trsdk httpgw].freeze
       # Short names of columns in manual
       SUPPORTED_AGENTS_SHORT = SUPPORTED_AGENTS.map{|a|a.to_s[0].to_sym}
       FILE_LIST_OPTIONS = ['--file-list', '--file-pair-list'].freeze
-      SUPPORTED_OPTIONS = %i[ascp_args wss].freeze
+      SUPPORTED_OPTIONS = %i[ascp_args wss check_ignore quiet].freeze
 
       private_constant :SUPPORTED_AGENTS, :FILE_LIST_OPTIONS
 
@@ -28,7 +31,7 @@ module Aspera
         # Temp folder for file lists, must contain only file lists
         # because of garbage collection takes any file there
         # this could be refined, as , for instance, on macos, temp folder is already user specific
-        @file_list_folder = TempFileManager.instance.new_file_path_global('asession_filelists')
+        @file_list_folder = TempFileManager.instance.new_file_path_global('asession_filelists') # cspell:disable-line
         @param_description_cache = nil
         # @return normalized description of transfer spec parameters, direct from yaml
         def description
@@ -48,7 +51,7 @@ module Aspera
             param = {name: name, type: [options[:accepted_types]].flatten.join(','), description: options[:desc]}
             # add flags for supported agents in doc
             SUPPORTED_AGENTS.each do |a|
-              param[a.to_s[0].to_sym] = options[:agents].nil? || options[:agents].include?(a) ? 'Y' : ''
+              param[a.to_s[0].to_sym] = Cli::Formatter.tick(options[:agents].nil? || options[:agents].include?(a))
             end
             # only keep lines that are usable in supported agents
             next if SUPPORTED_AGENTS_SHORT.inject(true){|m, j|m && param[j].empty?}
@@ -66,9 +69,12 @@ module Aspera
                 else
                   raise "error: #{param}"
                 end.map{|n|"{#{n}}"}.join('|')
-                conv = options[:cli].key?(:convert) ? '(conversion)' : ''
-                "#{options[:cli][:switch]} #{conv}#{values}"
-              else ''
+                conversion_tag = options[:cli].key?(:convert) ? '(conversion)' : ''
+                "#{options[:cli][:switch]} #{conversion_tag}#{values}"
+              when :special then Cli::Formatter.special('special')
+              when :ignore then Cli::Formatter.special('ignored')
+              else
+                param[:d].eql?(tick_yes) ? '' : 'n/a'
               end
             if options.key?(:enum)
               param[:description] += "\nAllowed values: #{options[:enum].join(', ')}"
@@ -121,11 +127,12 @@ module Aspera
       def initialize(job_spec, options)
         @job_spec = job_spec
         # check necessary options
-        raise 'Internal: missing options' unless (SUPPORTED_OPTIONS - options.keys).empty?
+        missing_options = SUPPORTED_OPTIONS - options.keys
+        raise "Internal: missing options: #{missing_options.join(', ')}" unless missing_options.empty?
         @options = SUPPORTED_OPTIONS.each_with_object({}){|o, h| h[o] = options[o]}
-        Log.dump(:options, @options)
-        raise 'ascp args must be an Array' unless @options[:ascp_args].is_a?(Array)
-        raise 'ascp args must be an Array of String' if @options[:ascp_args].any?{|i|!i.is_a?(String)}
+        Log.log.debug{Log.dump(:parameters_options, @options)}
+        raise 'ascp arguments must be an Array' unless @options[:ascp_args].is_a?(Array)
+        raise 'ascp arguments must be an Array of String' if @options[:ascp_args].any?{|i|!i.is_a?(String)}
         @builder = Aspera::CommandLineBuilder.new(@job_spec, self.class.description)
       end
 
@@ -133,7 +140,7 @@ module Aspera
         # is the file list provided through EX_ parameters?
         ascp_file_list_provided = self.class.ts_has_ascp_file_list(@job_spec, @options[:ascp_args])
         # set if paths is mandatory in ts
-        @builder.params_definition['paths'][:mandatory] = !@job_spec.key?('keepalive') && !ascp_file_list_provided
+        @builder.params_definition['paths'][:mandatory] = !@job_spec.key?('keepalive') && !ascp_file_list_provided # cspell:words keepalive
         # get paths in transfer spec (after setting if it is mandatory)
         ts_paths_array = @builder.read_param('paths')
         if ascp_file_list_provided && !ts_paths_array.nil?
@@ -160,13 +167,14 @@ module Aspera
               # if there is one destination in paths, then use file-pair-list
               if is_pair_list
                 option = '--file-pair-list'
-                lines = ts_paths_array.each_with_object([]){|e, m|m.push(e['source'], e['destination'] || e['source']); }
+                lines = ts_paths_array.each_with_object([]){|e, m|m.push(e['source'], e['destination'] || e['source']) }
               else
                 option = '--file-list'
                 lines = ts_paths_array.map{|i|i['source']}
               end
               file_list_file = Aspera::TempFileManager.instance.new_file_path_in_folder(self.class.file_list_folder)
-              File.write(file_list_file, lines.join("\n"))
+              Log.log.debug{Log.dump(:file_list, lines)}
+              File.write(file_list_file, lines.join("\n"), encoding: 'UTF-8')
               Log.log.debug{"#{option}=\n#{File.read(file_list_file)}".red}
             end
           end
@@ -184,17 +192,14 @@ module Aspera
           env:          {},
           ascp_version: :ascp
         }
-        # some ssh credentials are required to avoid interactive password input
-        if !@job_spec.key?('remote_password') &&
-            !@job_spec.key?('ssh_private_key') &&
-            !@job_spec.key?('EX_ssh_key_paths')
-          raise Fasp::Error, 'required: password or ssh key (value or path)'
-        end
 
         # special cases
         @job_spec.delete('source_root') if @job_spec.key?('source_root') && @job_spec['source_root'].empty?
 
-        # use web socket session initiation ?
+        # notify multi-session was already used, anyway it was deleted by agent direct
+        raise 'internal error' if @builder.read_param('multi_session')
+
+        # use web socket secure for session ?
         if @builder.read_param('wss_enabled') && (@options[:wss] || !@job_spec.key?('fasp_port'))
           # by default use web socket session if available, unless removed by user
           @builder.add_command_line_options(['--ws-connect'])
@@ -204,12 +209,30 @@ module Aspera
           @job_spec.delete('fasp_port')
           @job_spec.delete('EX_ssh_key_paths')
           @job_spec.delete('sshfp')
-          # set location for CA bundle to be the one of Ruby, see env var SSL_CERT_FILE / SSL_CERT_DIR
-          @job_spec['EX_ssh_key_paths'] = [OpenSSL::X509::DEFAULT_CERT_FILE]
-          Log.log.debug('CA certs: EX_ssh_key_paths <- DEFAULT_CERT_FILE from openssl')
+          if @options[:check_ignore]&.call(@job_spec['remote_host'], @job_spec['wss_port'])
+            http_session = Rest.start_http_session("https://#{@job_spec['remote_host']}:#{@job_spec['wss_port']}")
+            # wss_api = Rest.new(base_url: "/v1/transfer")
+            # wss_api.read('start') rescue nil
+            wss_cert_file = TempFileManager.instance.new_file_path_global('wss_cert')
+            File.write(wss_cert_file, http_session.peer_cert.to_pem)
+            http_session.finish
+            env_args[:args].unshift('-i', wss_cert_file)
+            Log.log.debug{"CA certs for wss: remote cert: #{wss_cert_file}"}
+          else
+            # set location for CA bundle to be the one of Ruby, see env var SSL_CERT_FILE / SSL_CERT_DIR
+            @options[:trusted_certs].each do |file|
+              env_args[:args].unshift('-i', file)
+              Log.log.debug{"trusted certs for wss: #{file}"}
+            end
+          end
         else
           # remove unused parameter (avoid warning)
           @job_spec.delete('wss_port')
+          # add SSH bypass keys when authentication is token and no auth is provided
+          if @job_spec.key?('token') && !@job_spec.key?('remote_password')
+            # @job_spec['remote_password'] = Installation.instance.ssh_cert_uuid # not used: no passphrase
+            Installation.instance.aspera_token_ssh_key_paths.each { |key| env_args[:args].unshift('-i', key) }
+          end
         end
 
         # process parameters as specified in table
@@ -225,7 +248,7 @@ module Aspera
         end
         # get list of files to transfer and build arg for ascp
         process_file_list
-        # optional args, at the end to override previous ones (to allow override)
+        # optional arguments, at the end to override previous ones (to allow override)
         @builder.add_command_line_options(@builder.read_param('EX_ascp_args'))
         @builder.add_command_line_options(@options[:ascp_args])
         # process destination folder
@@ -235,7 +258,17 @@ module Aspera
         # destination MUST be last command line argument to ascp
         @builder.add_command_line_options([destination_folder])
 
-        @builder.add_env_args(env_args[:env], env_args[:args])
+        Log.log.debug{"ascp args: #{env_args}"}
+
+        @builder.add_env_args(env_args)
+
+        env_args[:args].unshift('-q') if @options[:quiet]
+
+        # add fallback cert and key as arguments if needed
+        if ['1', 1, true, 'force'].include?(@job_spec['http_fallback'])
+          env_args[:args].unshift('-Y', Installation.instance.path(:fallback_private_key))
+          env_args[:args].unshift('-I', Installation.instance.path(:fallback_certificate))
+        end
 
         return env_args
       end

data/lib/aspera/fasp/parameters.yaml

@@ -2,13 +2,13 @@
 # accepted_types : accepted types for non-enum
 # default        : default value if not specified
 # enum           : set with list of values for enum types accepted in transfer spec
-# agents         : supported agents (for doc only)
+# agents         : supported agents (for doc only), if not specified: all
 # required       : optional, default: false
 # cli.type       : ascp: type of parameter, one of CLI_OPTION_TYPES
 # cli.switch     : ascp: switch for ascp command line
 # cli.convert    : ascp: transform value: either a Hash with conversion values, or name of class
 # cli.variable   : ascp: name of env var
-# cspell:words dgram
+# cspell:words dgram dnat dnats faspmgr asperanoded xattrs keepalive datagram
 ---
 cipher:
   :desc: "In transit encryption type."
@@ -79,7 +79,11 @@ destination_root:
   :cli:
     :type: :special
 destination_root_id:
-  :desc: The file ID of the destination root directory. Required when using Bearer token auth for the destination node.
+  :desc: |-
+    The file ID of the destination root directory.
+    Required when using Bearer token auth for the destination node.
+
+
   :accepted_types: :string
   :agents:
   - :sdk
@@ -177,7 +181,7 @@ multi_session:
 
   :accepted_types: :int
   :cli:
-    :type: :ignore
+    :type: :special
     :switch: "-C"
 multi_session_threshold:
   :desc: |-
@@ -227,15 +231,37 @@ precalculate_job_size:
   :cli:
     :type: :opt_without_arg
 preserve_access_time:
+  :desc: |-
+    Preserve the source-file access timestamps at the destination.
+    Because source access times are updated by the transfer operation,
+    the timestamp that is preserved is the one just before to the transfer.
+
+
   :cli:
     :type: :opt_without_arg
 preserve_creation_time:
+  :desc: |-
+    (Windows only) Preserve source-file creation timestamps at the destination.
+    Only Windows systems retain information about creation time.
+    If the destination is not a Windows computer, this option is ignored.
+
+
   :cli:
     :type: :opt_without_arg
 preserve_modification_time:
+  :desc: |-
+    Set the modification time, the last time a file or directory was modified (written), of a transferred file
+    to the modification of the source file or directory.
+    Preserve source-file modification timestamps at the destination.
+
+
   :cli:
     :type: :opt_without_arg
 preserve_times:
+  :desc: Preserve file timestamps. 
+  :agents:
+  - :sdk
+  - :node
   :cli:
     :type: :opt_without_arg
 rate_policy:
@@ -437,6 +463,7 @@ use_ascp4:
   :cli:
     :type: :special
 use_system_ssh:
+  :desc: TODO, comment...
   :accepted_types: :string
   :agents:
   - :sdk
@@ -454,22 +481,46 @@ source_root:
     :switch: "--source-prefix64"
     :convert: Aspera::Fasp::Parameters.convert_base64
 min_rate_cap_kbps:
+  :desc: |-
+    The highest minimum rate that an incoming transfer can request, in kilobits per second.
+    Client minimum rate requests that exceed the minimum rate cap are ignored.
+    The default value of unlimited applies no cap to the minimum rate. (Default: 0)
+
+
   :accepted_types: :int
   :cli:
     :type: :ignore
 lock_rate_policy:
+  :desc: If true, lock the rate policy to the default value.
   :accepted_types: :bool
+  :agents:
+  - :sdk
+  - :connect
   :cli:
     :type: :ignore
 lock_target_rate_kbps:
+  :desc: |-
+    If true, lock the target transfer rate to the default value set for target_rate_kbps.
+    If false, users can adjust the transfer rate up to the value set for target_rate_cap_kbps.
+
+
   :accepted_types: :bool
   :cli:
     :type: :ignore
 lock_min_rate_kbps:
+  :desc: |-
+    If true, lock the minimum transfer rate to the value set for min_rate_kbps.
+    If false, users can adjust the transfer rate up to the value set for target_rate_cap_kbps.
+
+
   :accepted_types: :bool
+  :agents:
+  - :sdk
+  - :connect
   :cli:
     :type: :ignore
 apply_local_docroot:
+  :desc: Apply local docroot to source paths.
   :agents:
   - :direct
   - :sdk
@@ -561,7 +612,7 @@ remove_empty_source_directory:
     :type: :opt_without_arg
 EX_at_rest_password:
   :desc: Content protection password
-  :deprecation: "Use standard spec parameter: content_protection_password"
+  :deprecation: "(4.13) Use standard spec parameter: content_protection_password"
   :agents:
   - :direct
   :cli:
@@ -573,6 +624,7 @@ EX_proxy_password:
     May be overridden by password in URL provided in parameter: proxy.
 
 
+  :deprecation: (4.14) Use env var ASPERA_PROXY_PASS
   :agents:
   - :direct
   :cli:
@@ -580,14 +632,17 @@ EX_proxy_password:
     :variable: ASPERA_PROXY_PASS
 EX_license_text:
   :desc: "License file text override.\nBy default ascp looks for license file near executable."
+  :deprecation: (4.14) Use env var ASPERA_SCP_LICENSE
   :agents:
   - :direct
   :cli:
     :type: :envvar
     :variable: ASPERA_SCP_LICENSE
 keepalive:
+  :desc: The session is running in persistent session mode.
   :agents:
-  - :none
+  - :sdk
+  - :direct
   :cli:
     :type: :opt_without_arg
 dgram_size:
@@ -610,6 +665,7 @@ sshfp:
     :switch: "--check-sshfp"
 EX_http_proxy_url:
   :desc: Specify the proxy server address used by HTTP Fallback
+  :deprecation: (4.14) TODO, use proxy option ?
   :agents:
   - :direct
   :cli:
@@ -617,6 +673,7 @@ EX_http_proxy_url:
     :switch: "-x"
 EX_ssh_key_paths:
   :desc: Use public key authentication for SSH and specify the private key file paths
+  :deprecation: (4.14) Use option transfer_info.ascp_args
   :accepted_types: :array
   :agents:
   - :direct
@@ -625,6 +682,7 @@ EX_ssh_key_paths:
     :switch: "-i"
 EX_http_transfer_jpeg:
   :desc: HTTP transfers as JPEG file
+  :deprecation: (4.14) Use option transfer_info.ascp_args
   :accepted_types: :int
   :default: '0'
   :agents:
@@ -634,6 +692,7 @@ EX_http_transfer_jpeg:
     :switch: "-j"
 EX_no_read:
   :desc: no read source
+  :deprecation: (4.14) Use option transfer_info.ascp_args
   :agents:
   - :direct
   :cli:
@@ -641,12 +700,14 @@ EX_no_read:
     :switch: "--no-read"
 EX_no_write:
   :desc: no write on destination
+  :deprecation: (4.14) Use option transfer_info.ascp_args
   :agents:
   - :direct
   :cli:
     :type: :opt_without_arg
     :switch: "--no-write"
 target_rate_percentage:
+  :desc: "TODO: remove ?"
   :cli:
     :type: :ignore
 rate_policy_allowed:
@@ -661,15 +722,18 @@ rate_policy_allowed:
   :cli:
     :type: :ignore
 fasp_url:
+  :desc: Only used in Faspex.
   :agents:
   - :unknown
   :cli:
     :type: :ignore
 lock_min_rate:
+  :desc: "TODO: remove ?"
   :accepted_types: :bool
   :cli:
     :type: :ignore
 lock_target_rate:
+  :desc: "TODO: remove ?"
   :accepted_types: :bool
   :cli:
     :type: :ignore
@@ -684,13 +748,15 @@ cipher_allowed:
   :cli:
     :type: :ignore
 obfuscate_file_names:
+  :desc: HTTP Gateway obfuscates file names when set to true.
   :accepted_types: :bool
   :agents:
-  - :unknown
+  - :httpgw
   :cli:
     :type: :ignore
 EX_file_list:
   :desc: source file list
+  :deprecation: (4.14) Use command line file list, or option transfer_info.ascp_args
   :agents:
   - :direct
   :cli:
@@ -698,6 +764,7 @@ EX_file_list:
     :switch: "--file-list"
 EX_file_pair_list:
   :desc: source file pair list
+  :deprecation: (4.14) Use command line file pair list, or option transfer_info.ascp_args
   :agents:
   - :direct
   :cli:
@@ -705,7 +772,7 @@ EX_file_pair_list:
     :switch: "--file-pair-list"
 EX_ascp_args:
   :desc: Add native command line arguments to ascp
-  :deprecation: Use parameter ascp_args in option transfer_info
+  :deprecation: (4.13) Use option transfer_info.ascp_args
   :accepted_types: :array
   :agents:
   - :direct