aspera-cli 4.6.0 → 4.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (96) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +427 -300
  3. data/bin/ascli +2 -1
  4. data/bin/asession +1 -0
  5. data/docs/test_env.conf +2 -0
  6. data/examples/aoc.rb +4 -3
  7. data/examples/faspex4.rb +21 -19
  8. data/examples/proxy.pac +1 -1
  9. data/examples/transfer.rb +15 -15
  10. data/lib/aspera/aoc.rb +135 -124
  11. data/lib/aspera/ascmd.rb +85 -75
  12. data/lib/aspera/ats_api.rb +11 -10
  13. data/lib/aspera/cli/basic_auth_plugin.rb +13 -14
  14. data/lib/aspera/cli/extended_value.rb +42 -33
  15. data/lib/aspera/cli/formater.rb +138 -111
  16. data/lib/aspera/cli/info.rb +17 -0
  17. data/lib/aspera/cli/listener/line_dump.rb +3 -2
  18. data/lib/aspera/cli/listener/logger.rb +2 -1
  19. data/lib/aspera/cli/listener/progress.rb +16 -18
  20. data/lib/aspera/cli/listener/progress_multi.rb +13 -16
  21. data/lib/aspera/cli/main.rb +122 -130
  22. data/lib/aspera/cli/manager.rb +146 -154
  23. data/lib/aspera/cli/plugin.rb +38 -34
  24. data/lib/aspera/cli/plugins/alee.rb +6 -6
  25. data/lib/aspera/cli/plugins/aoc.rb +273 -276
  26. data/lib/aspera/cli/plugins/ats.rb +82 -76
  27. data/lib/aspera/cli/plugins/bss.rb +14 -16
  28. data/lib/aspera/cli/plugins/config.rb +350 -306
  29. data/lib/aspera/cli/plugins/console.rb +23 -19
  30. data/lib/aspera/cli/plugins/cos.rb +18 -18
  31. data/lib/aspera/cli/plugins/faspex.rb +180 -159
  32. data/lib/aspera/cli/plugins/faspex5.rb +64 -54
  33. data/lib/aspera/cli/plugins/node.rb +147 -140
  34. data/lib/aspera/cli/plugins/orchestrator.rb +68 -66
  35. data/lib/aspera/cli/plugins/preview.rb +92 -96
  36. data/lib/aspera/cli/plugins/server.rb +79 -75
  37. data/lib/aspera/cli/plugins/shares.rb +23 -24
  38. data/lib/aspera/cli/plugins/sync.rb +20 -22
  39. data/lib/aspera/cli/transfer_agent.rb +40 -39
  40. data/lib/aspera/cli/version.rb +2 -1
  41. data/lib/aspera/colors.rb +35 -27
  42. data/lib/aspera/command_line_builder.rb +48 -34
  43. data/lib/aspera/cos_node.rb +29 -21
  44. data/lib/aspera/data_repository.rb +3 -2
  45. data/lib/aspera/environment.rb +50 -45
  46. data/lib/aspera/fasp/agent_base.rb +22 -20
  47. data/lib/aspera/fasp/agent_connect.rb +13 -11
  48. data/lib/aspera/fasp/agent_direct.rb +48 -59
  49. data/lib/aspera/fasp/agent_httpgw.rb +33 -39
  50. data/lib/aspera/fasp/agent_node.rb +15 -13
  51. data/lib/aspera/fasp/agent_trsdk.rb +12 -14
  52. data/lib/aspera/fasp/error.rb +2 -1
  53. data/lib/aspera/fasp/error_info.rb +68 -52
  54. data/lib/aspera/fasp/installation.rb +106 -94
  55. data/lib/aspera/fasp/listener.rb +1 -0
  56. data/lib/aspera/fasp/parameters.rb +83 -92
  57. data/lib/aspera/fasp/parameters.yaml +305 -249
  58. data/lib/aspera/fasp/resume_policy.rb +11 -14
  59. data/lib/aspera/fasp/transfer_spec.rb +26 -0
  60. data/lib/aspera/fasp/uri.rb +22 -21
  61. data/lib/aspera/faspex_gw.rb +55 -90
  62. data/lib/aspera/hash_ext.rb +4 -3
  63. data/lib/aspera/id_generator.rb +8 -7
  64. data/lib/aspera/keychain/encrypted_hash.rb +17 -16
  65. data/lib/aspera/keychain/macos_security.rb +6 -10
  66. data/lib/aspera/log.rb +25 -20
  67. data/lib/aspera/nagios.rb +13 -12
  68. data/lib/aspera/node.rb +30 -22
  69. data/lib/aspera/oauth.rb +175 -226
  70. data/lib/aspera/open_application.rb +4 -3
  71. data/lib/aspera/persistency_action_once.rb +6 -6
  72. data/lib/aspera/persistency_folder.rb +5 -9
  73. data/lib/aspera/preview/file_types.rb +6 -5
  74. data/lib/aspera/preview/generator.rb +25 -24
  75. data/lib/aspera/preview/options.rb +16 -14
  76. data/lib/aspera/preview/utils.rb +98 -98
  77. data/lib/aspera/{proxy_auto_config.erb.js → proxy_auto_config.js} +23 -31
  78. data/lib/aspera/proxy_auto_config.rb +111 -20
  79. data/lib/aspera/rest.rb +115 -113
  80. data/lib/aspera/rest_call_error.rb +2 -2
  81. data/lib/aspera/rest_error_analyzer.rb +23 -25
  82. data/lib/aspera/rest_errors_aspera.rb +15 -14
  83. data/lib/aspera/ssh.rb +12 -10
  84. data/lib/aspera/sync.rb +42 -41
  85. data/lib/aspera/temp_file_manager.rb +18 -14
  86. data/lib/aspera/timer_limiter.rb +2 -1
  87. data/lib/aspera/uri_reader.rb +7 -5
  88. data/lib/aspera/web_auth.rb +79 -76
  89. metadata +64 -21
  90. data/docs/Makefile +0 -65
  91. data/docs/README.erb.md +0 -4424
  92. data/docs/README.md +0 -13
  93. data/docs/diagrams.txt +0 -49
  94. data/docs/doc_tools.rb +0 -58
  95. data/lib/aspera/cli/plugins/shares2.rb +0 -114
  96. data/lib/aspera/fasp/default.rb +0 -17
@@ -1,121 +1,160 @@
1
+ # desc : description
2
+ # accepted_types : accepted types for non-enum
3
+ # default : default value if not specified
4
+ # enum : set with list of values for enum types accepted in transfer spec
5
+ # tragents : supported agents (for doc only)
6
+ # required : optional, default: false
7
+ # cltype : ascp: type of parameter
8
+ # clswitch : ascp: switch for ascp command line
9
+ # clconvert : ascp: transform value: either a Hash with conversion values, or name of class
10
+ # clvarname : ascp: name of env var
1
11
  ---
2
12
  cipher:
3
- :cltype: :opt_with_arg
4
- :option_switch: "-c"
13
+ :desc: "In transit encryption type."
5
14
  :enum:
6
- - aes128
7
- - aes192
8
- - aes256
9
- - aes128cfb
10
- - aes192cfb
11
- - aes256cfb
12
- - aes128gcm
13
- - aes192gcm
14
- - aes256gcm
15
- :encode: Aspera::Fasp::Parameters
15
+ - none
16
+ - aes-128
17
+ - aes-192
18
+ - aes-256
19
+ - aes-128-cfb
20
+ - aes-192-cfb
21
+ - aes-256-cfb
22
+ - aes-128-gcm
23
+ - aes-192-gcm
24
+ - aes-256-gcm
16
25
  :default: none
17
- :desc: "In transit encryption type.\nnone, aes-128, aes-256"
26
+ :cltype: :opt_with_arg
27
+ :clswitch: "-c"
28
+ :clconvert: Aspera::Fasp::Parameters.clconv_remove_hyphen
18
29
  content_protection:
19
- :cltype: :ignore
20
- :option_switch: "--file-crypt"
30
+ :desc: Enable client-side encryption at rest. (CSEAR, content protection)
21
31
  :enum:
22
32
  - encrypt
23
33
  - decrypt
24
- :desc: Enable client-side content protection. (encryption at rest)
34
+ :cltype: :opt_with_arg
35
+ :clswitch: "--file-crypt"
25
36
  content_protection_password:
37
+ :desc: "Specifies CSEAR password. (content protection)"
26
38
  :accepted_types: :string
27
- :desc: "Specifies CSEAR password."
39
+ :cltype: :envvar
40
+ :clvarname: ASPERA_SCP_FILEPASS
28
41
  cookie:
42
+ :desc: Metadata for transfer specified by application
43
+ :accepted_types: :string
29
44
  :cltype: :envvar
30
45
  :clvarname: ASPERA_SCP_COOKIE
31
- :desc: Metadata for transfer (older,string)
32
46
  create_dir:
33
- :cltype: :opt_without_arg
34
- :option_switch: "-d"
35
- :accepted_types: :bool
36
47
  :desc: Specifies whether to create new directories.
48
+ :accepted_types: :bool
49
+ :cltype: :opt_without_arg
50
+ :clswitch: "-d"
37
51
  delete_before_transfer:
52
+ :desc: "Before transfer, delete files that exist at the destination but not at the source. The source and destination arguments must be directories that have matching names. Objects on the destination that have the same name but different type or size as objects on the source are not deleted."
38
53
  :cltype: :opt_without_arg
39
- delete_source:
54
+ delete_source: # duplicate of remove_after_transfer ?
55
+ :desc: Remove SRC files after transfer success
40
56
  :accepted_types: :bool
41
- :context:
57
+ :tragents:
42
58
  - :node
43
- :desc: Remove SRC files after transfer success
59
+ - :direct
60
+ :cltype: :opt_without_arg
61
+ :clswitch: "--remove-after-transfer"
62
+ destination_root:
63
+ :desc: Destination root directory.
64
+ :required: true
65
+ :cltype: :defer
44
66
  destination_root_id:
45
- :cltype: :ignore
67
+ :desc: The file ID of the destination root directory. Required when using Bearer token auth for the destination node.
46
68
  :accepted_types: :string
47
- :context:
69
+ :tragents:
48
70
  - :sdk
71
+ :cltype: :ignore
49
72
  direction:
50
- :cltype: :opt_with_arg
51
- :option_switch: "--mode"
73
+ :desc: 'Direction of transfer (on client side)'
74
+ :required: true
52
75
  :enum:
53
76
  - send
54
77
  - receive
55
- :translate_values:
78
+ :cltype: :opt_with_arg
79
+ :clswitch: "--mode"
80
+ :clconvert:
56
81
  receive: recv
57
82
  send: send
58
- :required: true
59
- :desc: 'Direction of transfer (on client side)'
60
83
  exclude_newer_than:
61
- :cltype: :opt_with_arg
84
+ :desc: skip src files with mtime > arg
62
85
  :accepted_types: :int
63
- :context:
86
+ :tragents:
64
87
  - :direct
65
- :desc: skip src files with mtime > arg
66
- exclude_older_than:
67
88
  :cltype: :opt_with_arg
89
+ exclude_older_than:
90
+ :desc: skip src files with mtime < arg
68
91
  :accepted_types: :int
69
- :context:
92
+ :tragents:
70
93
  - :direct
71
- :desc: skip src files with mtime < arg
72
- fasp_port:
73
94
  :cltype: :opt_with_arg
74
- :option_switch: "-O"
95
+ fasp_port:
96
+ :desc: Specifies fasp (UDP) port.
75
97
  :accepted_types: :int
76
98
  :default: 33001
77
- :desc: Specifies fasp (UDP) port.
78
- http_fallback:
79
99
  :cltype: :opt_with_arg
80
- :option_switch: "-y"
100
+ :clswitch: "-O"
101
+ file_checksum:
102
+ :desc: "Enable checksum reporting for transferred files by specifying the hash to use."
103
+ :enum:
104
+ - sha-512
105
+ - sha-384
106
+ - sha-256
107
+ - sha1
108
+ - md5
109
+ - none
110
+ :default: none
111
+ :tragents:
112
+ - :sdk
113
+ - :node
114
+ - :direct
115
+ :cltype: :ignore
116
+ :clswitch: "--checksum-type"
117
+ http_fallback:
118
+ :desc: When true(1), attempts to perform an HTTP transfer if a FASP transfer cannot be performed.
81
119
  :accepted_types:
82
- - :string
83
120
  - :bool
84
- :translate_values:
121
+ - :string
122
+ :cltype: :opt_with_arg
123
+ :clswitch: "-y"
124
+ :clconvert:
85
125
  force: F
86
126
  true: 1
87
127
  false: 0
88
- :desc: When true(1), attempts to perform an HTTP transfer if a fasp transfer cannot
89
- be performed.
90
128
  http_fallback_port:
91
- :cltype: :opt_with_arg
92
- :option_switch: "-t"
129
+ :desc: Specifies http port when no cipher is used
93
130
  :accepted_types: :int
94
- :context:
131
+ :tragents:
95
132
  - :direct
96
- :desc: Specifies http port.
133
+ :cltype: :opt_with_arg
134
+ :clswitch: "-t"
97
135
  https_fallback_port:
98
- :cltype: :ignore
136
+ :desc: Specifies https port when cipher is used
99
137
  :accepted_types: :int
100
- :desc: Specifies https port.
138
+ :cltype: :opt_with_arg
139
+ :clswitch: "-t"
101
140
  move_after_transfer:
102
141
  :cltype: :opt_with_arg
103
142
  multi_session:
104
- :cltype: :ignore
105
- :option_switch: "-C"
106
- :accepted_types: :int
107
143
  :desc: "Use multi-session transfer. max 128.\n
108
144
  Each participant on one host needs an independent UDP (-O) port.\n
109
145
  Large files are split between sessions only when transferring with resume_policy=none."
146
+ :accepted_types: :int
147
+ :cltype: :ignore
148
+ :clswitch: "-C"
110
149
  multi_session_threshold:
111
- :cltype: :opt_with_arg
150
+ :desc: Split files across multiple ascp sessions if their size in bytes is greater than or equal to the specified value. (0=no file is split)
112
151
  :accepted_types: :int
113
- :context:
152
+ :tragents:
114
153
  - :direct
115
154
  - :node
116
- :desc: in bytes
117
- overwrite:
118
155
  :cltype: :opt_with_arg
156
+ overwrite:
157
+ :desc: "Overwrite destination files with the source files of the same name."
119
158
  :default: diff
120
159
  :enum:
121
160
  - never
@@ -123,11 +162,12 @@ overwrite:
123
162
  - diff
124
163
  - older
125
164
  - diff+older
126
- :desc: "Overwrite destination files with the source files of the same name."
165
+ :cltype: :opt_with_arg
127
166
  paths:
128
- :cltype: :defer
167
+ :desc: Array of path to the source (required) and a path to the destination (optional).
168
+ :required: true
129
169
  :accepted_types: :array
130
- :desc: Required. Contains a path to the source (required) and a path to the destination.
170
+ :cltype: :defer
131
171
  precalculate_job_size:
132
172
  :cltype: :opt_without_arg
133
173
  :accepted_types: :bool
@@ -141,391 +181,407 @@ preserve_modification_time:
141
181
  preserve_times:
142
182
  :cltype: :opt_without_arg
143
183
  rate_policy:
144
- :cltype: :opt_with_arg
145
- :option_switch: "--policy"
184
+ :desc: The transfer rate policy to use when sharing bandwidth.
146
185
  :enum:
147
186
  - low
148
187
  - fair
149
188
  - high
150
189
  - fixed
151
- :desc: The transfer rate policy to use when sharing bandwidth.
190
+ :cltype: :opt_with_arg
191
+ :clswitch: "--policy"
152
192
  remote_access_key:
193
+ :desc: The access key ID of the access key that was used to construct the bearer token that is used to authenticate to the remote node.
153
194
  :accepted_types: :string
154
- :desc: Node only?
195
+ :tragents:
196
+ - :sdk
197
+ :cltype: :ignore
155
198
  remote_host:
156
- :cltype: :opt_with_arg
157
- :option_switch: "--host"
158
- :required: true
159
199
  :desc: IP or fully qualified domain name of the remote server
160
- remote_user:
161
- :cltype: :opt_with_arg
162
- :option_switch: "--user"
163
200
  :required: true
201
+ :cltype: :opt_with_arg
202
+ :clswitch: "--host"
203
+ remote_user:
164
204
  :desc: Remote user. Default value is "xfer" on node or connect.
205
+ :required: true
206
+ :cltype: :opt_with_arg
207
+ :clswitch: "--user"
165
208
  remote_password:
209
+ :desc: SSH session password
166
210
  :cltype: :envvar
167
211
  :clvarname: ASPERA_SCP_PASS
168
- :desc: SSH session password
169
212
  remove_after_transfer:
170
- :cltype: :opt_without_arg
213
+ :desc: Remove SRC files after transfer success
171
214
  :accepted_types: :bool
172
- :context:
215
+ :tragents:
173
216
  - :direct
174
217
  - :node
175
- :desc: Remove SRC files after transfer success
176
- remove_empty_directories:
177
218
  :cltype: :opt_without_arg
219
+ remove_empty_directories:
220
+ :desc: Specifies whether to remove empty directories.
178
221
  :accepted_types: :bool
179
- :context:
222
+ :tragents:
180
223
  - :direct
181
224
  - :node
182
- :desc: Specifies whether to remove empty directories.
225
+ :cltype: :opt_without_arg
183
226
  remove_skipped:
184
- :cltype: :ignore
227
+ :desc: Must also have remove_after_transfer set to true, Defaults to false, if true, skipped files will be removed as well.
185
228
  :accepted_types: :bool
186
- :context:
187
- - :sdk
188
- proxy:
189
- :cltype: :opt_with_arg
190
- :context:
229
+ :tragents:
191
230
  - :direct
231
+ - :connect
192
232
  - :sdk
233
+ - :node
234
+ :cltype: :opt_without_arg
235
+ proxy:
193
236
  :desc: "Specify the address of the Aspera high-speed proxy server.\n
194
237
  dnat(s)://[user[:password]@]server:port\n
195
238
  Default ports for DNAT and DNATS protocols are 9091 and 9092.\n
196
239
  Password, if specified here, overrides the value of environment variable ASPERA_PROXY_PASS."
197
- resume_policy:
240
+ :tragents:
241
+ - :direct
242
+ - :sdk
198
243
  :cltype: :opt_with_arg
199
- :option_switch: "-k"
244
+ resume_policy:
245
+ :desc: If a transfer is interrupted or fails to finish, resume without re-transferring the whole files.
200
246
  :default: faspmgr:none;other:sparse_csum
201
247
  :enum:
202
248
  - none
203
249
  - attrs
204
250
  - sparse_csum
205
251
  - full_csum
206
- :translate_values:
252
+ :cltype: :opt_with_arg
253
+ :clswitch: "-k"
254
+ :clconvert:
207
255
  none: 0
208
256
  attrs: 1
209
257
  sparse_csum: 2
210
258
  full_csum: 3
211
- :desc: If a transfer is interrupted or fails to finish, resume without re-transferring the whole files.
212
259
  retry_duration:
260
+ :desc: Specifies how long to wait before retrying transfer. (e.g. "5min")
213
261
  :accepted_types:
214
262
  - :string
215
263
  - :int
216
- :context:
264
+ :tragents:
217
265
  - :node
218
266
  - :connect
219
267
  - :sdk
220
- :desc: Specifies how long to wait before retrying transfer. (e.g. "5min")
221
- source_root_id:
222
268
  :cltype: :ignore
269
+ source_root_id:
270
+ :desc: The file ID of the source root directory. Required when using Bearer token auth for the source node.
223
271
  :accepted_types: :string
224
- :context:
272
+ :tragents:
225
273
  - :sdk
274
+ - :node
275
+ :cltype: :ignore
226
276
  ssh_port:
227
- :cltype: :opt_with_arg
228
- :option_switch: "-P"
277
+ :desc: "Specifies SSH (TCP) port. Default: local:22, other:33001"
229
278
  :accepted_types: :int
230
- :desc: "Specifies ssh (TCP) port. Default: local:22, other:33001"
279
+ :cltype: :opt_with_arg
280
+ :clswitch: "-P"
231
281
  ssh_private_key:
232
- :cltype: :envvar
233
- :clvarname: ASPERA_SCP_KEY
234
- :context:
235
- - :direct
236
- - :sdk
237
282
  :desc: "Private key used for SSH authentication.\n
238
- Shall look like: -----BEGIN RSA PRIVATE KEY-----\\nMII...\n
283
+ Shall look like: -----BEGIN RSA PRIV4TE KEY-----\\nMII...\n
239
284
  Note the JSON encoding: \\n for newlines."
285
+ :tragents:
286
+ - :direct
287
+ - :sdk
288
+ :cltype: :envvar
289
+ :clvarname: ASPERA_SCP_KEY
240
290
  ssh_private_key_passphrase:
241
- :cltype: :ignore
291
+ :desc: The passphrase associated with the transfer user's SSH private key. Available as of 3.7.2.
242
292
  :accepted_types: :string
243
- :context:
293
+ :tragents:
244
294
  - :sdk
295
+ - :direct
296
+ :cltype: :envvar
297
+ :clvarname: ASPERA_SCP_PASS
245
298
  ssh_args:
246
- :cltype: :ignore
299
+ :desc: Array of arguments to pass to SSH. Use with caution.
247
300
  :accepted_types: :string
248
- :context:
301
+ :tragents:
249
302
  - :sdk
303
+ :cltype: :ignore
250
304
  symlink_policy:
251
- :cltype: :opt_with_arg
252
- :option_switch: "--symbolic-links"
253
- :default: follow
305
+ :desc: "Handle source side symbolic links"
254
306
  :enum:
255
307
  - follow
256
308
  - copy
257
309
  - copy+force
258
310
  - skip
259
- :desc: "Handle source side symbolic links by:\n
260
- following the link (follow),\n
261
- copying the link itself (copy),\n
262
- skipping (skip),\n
263
- or forcibly copying the link itself (copy+force).\n
264
- Default: follow"
265
- checksum_type:
266
- :cltype: :ignore
267
- :accepted_types: :string
268
- :context:
269
- - :sdk
270
- :desc: "Enable checksum reporting for transferred files by specifying the hash to use.\n
271
- Allowable values: sha-512, sha-384, sha-256, sha1, md5. (Default: none)"
272
- file_checksum:
273
- :cltype: :ignore
274
- :accepted_types: :string
275
- :context:
276
- - :sdk
277
- tags:
311
+ :default: follow
278
312
  :cltype: :opt_with_arg
279
- :option_switch: "--tags64"
313
+ :clswitch: "--symbolic-links"
314
+ tags:
315
+ :desc: Metadata for transfer as JSON
280
316
  :accepted_types: :hash
281
- :encode: Aspera::Fasp::Parameters
282
- :desc: Metadata for transfer
317
+ :cltype: :opt_with_arg
318
+ :clswitch: "--tags64"
319
+ :clconvert: Aspera::Fasp::Parameters.clconv_json64
283
320
  target_rate_cap_kbps:
284
- :cltype: :ignore
321
+ :desc: Returned by upload/download_setup node API.
285
322
  :accepted_types: :int
286
- :context:
323
+ :tragents:
287
324
  - :connect
288
- :desc: Returned by upload/download_setup node api.
325
+ :cltype: :ignore
289
326
  target_rate_kbps:
290
- :cltype: :opt_with_arg
291
- :option_switch: "-l"
292
- :accepted_types: :int
293
327
  :desc: Specifies desired speed for the transfer.
328
+ :accepted_types: :int
329
+ :cltype: :opt_with_arg
330
+ :clswitch: "-l"
294
331
  title:
332
+ :desc: Title of the transfer
295
333
  :accepted_types: :string
296
- :context:
334
+ :tragents:
297
335
  - :node
298
336
  - :connect
299
- :desc: Title of the transfer
337
+ - :sdk
300
338
  token:
339
+ :desc: 'Authorization token: Bearer, Basic or ATM (Also arg -W)'
301
340
  :cltype: :envvar
302
341
  :clvarname: ASPERA_SCP_TOKEN
303
- :desc: 'Authorization token: Bearer, Basic or ATM (Also arg -W)'
304
342
  use_ascp4:
305
- :cltype: :defer
343
+ :desc: specify version of protocol
306
344
  :accepted_types: :bool
307
345
  :default: false
308
- :context:
346
+ :tragents:
309
347
  - :direct
310
348
  - :node
311
349
  - :sdk
312
- :desc: specify version of protocol
350
+ :cltype: :defer
313
351
  use_system_ssh:
314
- :cltype: :ignore
315
- :option_switch: "-SSH"
316
352
  :accepted_types: :string
317
- :context:
353
+ :tragents:
318
354
  - :sdk
319
- destination_root:
320
- :cltype: :defer
321
- :required: true
322
- :desc: Destination root directory.
355
+ :cltype: :ignore
356
+ :clswitch: "-SSH"
323
357
  source_root:
324
- :cltype: :opt_with_arg
325
- :option_switch: "--source-prefix64"
326
- :encode: Aspera::Fasp::Parameters
327
358
  :desc: "Path to be prepended to each source path.\n
328
359
  This is either a conventional path or it can be a URI but only if there is no root defined."
360
+ :cltype: :opt_with_arg
361
+ :clswitch: "--source-prefix64"
362
+ :clconvert: Aspera::Fasp::Parameters.clconv_base64
329
363
  min_rate_cap_kbps:
330
- :cltype: :ignore
331
364
  :accepted_types: :int
332
- lock_rate_policy:
333
365
  :cltype: :ignore
366
+ lock_rate_policy:
334
367
  :accepted_types: :bool
335
- lock_target_rate_kbps:
336
368
  :cltype: :ignore
369
+ lock_target_rate_kbps:
337
370
  :accepted_types: :bool
371
+ :cltype: :ignore
338
372
  lock_min_rate_kbps:
339
373
  :cltype: :ignore
340
374
  :accepted_types: :bool
341
375
  apply_local_docroot:
342
- :cltype: :opt_without_arg
343
- :context:
376
+ :tragents:
344
377
  - :direct
345
378
  - :sdk
379
+ :cltype: :opt_without_arg
346
380
  preserve_acls:
347
- :cltype: :opt_with_arg
348
- :context:
381
+ :desc: "Preserve access control lists."
382
+ :enum:
383
+ - none
384
+ - native
385
+ - metafile
386
+ :default: none
387
+ :tragents:
349
388
  - :direct
350
389
  - :sdk
351
- :desc: "Preserve access control lists.\nAllowable values: none, native, metafile"
390
+ :cltype: :opt_with_arg
352
391
  preserve_remote_acls:
353
- :cltype: :ignore
354
- :accepted_types: :string
355
- :context:
392
+ :desc: "Preserve remote access control lists."
393
+ :enum:
394
+ - none
395
+ - native
396
+ - metafile
397
+ :default: none
398
+ :tragents:
356
399
  - :sdk
357
- :desc: "Preserve remote access control lists.\n
358
- Allowable values: none, native, metafile"
400
+ - :direct
401
+ :cltype: :opt_with_arg
402
+ :clswitch: "--remote-preserve-acls"
359
403
  preserve_file_owner_uid:
360
- :cltype: :ignore
404
+ :desc: Preserve the user ID for a file owner
361
405
  :accepted_types: :bool
362
- :context:
406
+ :tragents:
363
407
  - :sdk
408
+ - :direct
409
+ :cltype: :opt_without_arg
364
410
  preserve_file_owner_gid:
365
- :cltype: :ignore
411
+ :desc: Preserve the group ID for a file owner
366
412
  :accepted_types: :bool
367
- :context:
413
+ :tragents:
368
414
  - :sdk
415
+ - :direct
416
+ :cltype: :opt_without_arg
369
417
  preserve_extended_attrs:
370
- :cltype: :ignore
371
- :accepted_types: :string
372
- :context:
418
+ :desc: "Preserve the extended attributes."
419
+ :enum:
420
+ - none
421
+ - native
422
+ - metafile
423
+ :default: none
424
+ :tragents:
373
425
  - :sdk
374
- :desc: "Preserve the extended attributes.\n
375
- Allowable values: none, native, metafile"
426
+ :cltype: :opt_with_arg
427
+ :clswitch: "--preserve-xattrs"
376
428
  preserve_source_access_time:
377
- :cltype: :ignore
429
+ :desc: Preserve the time logged for when the source file was accessed
378
430
  :accepted_types: :bool
379
- :context:
431
+ :tragents:
380
432
  - :sdk
381
- remove_empty_source_directory:
433
+ - :direct
382
434
  :cltype: :opt_without_arg
383
- :context:
435
+ remove_empty_source_directory:
436
+ :desc: "Remove empty source subdirectories and remove the source directory itself, if empty"
437
+ :accepted_types: :bool
438
+ :tragents:
384
439
  - :direct
385
- :desc: "TODO: check node, sdk"
440
+ - :sdk
441
+ :cltype: :opt_without_arg
386
442
  EX_at_rest_password:
443
+ :desc: "Passphrase used for at rest encryption or decryption. Prefer to use standard: content_protection_password"
444
+ :tragents:
445
+ - :direct
387
446
  :cltype: :envvar
388
447
  :clvarname: ASPERA_SCP_FILEPASS
389
- :context:
390
- - :direct
391
- :desc: Passphrase used for at rest encryption or decryption
392
448
  EX_proxy_password:
393
- :cltype: :envvar
394
- :clvarname: ASPERA_PROXY_PASS
395
- :context:
396
- - :direct
397
449
  :desc: "Password used for Aspera proxy server authentication.\n
398
450
  May be overridden by password in URL EX_fasp_proxy_url."
451
+ :tragents:
452
+ - :direct
453
+ :cltype: :envvar
454
+ :clvarname: ASPERA_PROXY_PASS
399
455
  EX_license_text:
456
+ :desc: "License file text override.\nBy default ascp looks for license file near executable."
457
+ :tragents:
458
+ - :direct
400
459
  :cltype: :envvar
401
460
  :clvarname: ASPERA_SCP_LICENSE
402
- :context:
403
- - :direct
404
- :desc: "License file text override.\nBy default ascp looks for license file near executable."
405
461
  keepalive:
406
462
  :cltype: :opt_without_arg
407
- :context:
463
+ :tragents:
408
464
  - :none
409
465
  dgram_size:
410
- :cltype: :opt_with_arg
411
- :option_switch: "-Z"
466
+ :desc: UDP datagram size in bytes
412
467
  :accepted_types: :int
413
- :desc: in bytes
414
- min_rate_kbps:
415
468
  :cltype: :opt_with_arg
416
- :option_switch: "-m"
469
+ :clswitch: "-Z"
470
+ min_rate_kbps:
471
+ :desc: Set the minimum transfer rate in kilobits per second.
417
472
  :accepted_types: :int
418
473
  :default: 0
419
- :desc: Set the minimum transfer rate in kilobits per second.
420
- sshfp:
421
474
  :cltype: :opt_with_arg
422
- :option_switch: "--check-sshfp"
475
+ :clswitch: "-m"
476
+ sshfp:
423
477
  :desc: Check it against server SSH host key fingerprint
424
- EX_http_proxy_url:
425
478
  :cltype: :opt_with_arg
426
- :option_switch: "-x"
427
- :context:
428
- - :direct
479
+ :clswitch: "--check-sshfp"
480
+ EX_http_proxy_url:
429
481
  :desc: Specify the proxy server address used by HTTP Fallback
430
- EX_ssh_key_paths:
482
+ :tragents:
483
+ - :direct
431
484
  :cltype: :opt_with_arg
432
- :option_switch: "-i"
485
+ :clswitch: "-x"
486
+ EX_ssh_key_paths:
487
+ :desc: Use public key authentication for SSH and specify the private key file paths
433
488
  :accepted_types: :array
434
- :context:
489
+ :tragents:
435
490
  - :direct
436
- :desc: Use public key authentication for SSH and specify the private key file paths
437
- EX_http_transfer_jpeg:
438
491
  :cltype: :opt_with_arg
439
- :option_switch: "-j"
492
+ :clswitch: "-i"
493
+ EX_http_transfer_jpeg:
494
+ :desc: HTTP transfers as JPEG file
440
495
  :accepted_types: :int
441
496
  :default: '0'
442
- :context:
497
+ :tragents:
443
498
  - :direct
444
- :desc: HTTP transfers as JPEG file
499
+ :cltype: :opt_with_arg
500
+ :clswitch: "-j"
445
501
  EX_no_read:
446
- :cltype: :opt_without_arg
447
- :option_switch: "--no-read"
448
- :context:
449
- - :direct
450
502
  :desc: no read source
451
- EX_no_write:
452
- :cltype: :opt_without_arg
453
- :option_switch: "--no-write"
454
- :context:
503
+ :tragents:
455
504
  - :direct
505
+ :cltype: :opt_without_arg
506
+ :clswitch: "--no-read"
507
+ EX_no_write:
456
508
  :desc: no write on destination
509
+ :tragents:
510
+ - :direct
511
+ :cltype: :opt_without_arg
512
+ :clswitch: "--no-write"
457
513
  target_rate_percentage:
458
514
  :cltype: :ignore
459
515
  rate_policy_allowed:
460
- :cltype: :ignore
461
- :context:
462
- - :connect
516
+ :desc: "Specifies most aggressive rate policy that is allowed.\nReturned by node API."
463
517
  :enum:
464
518
  - low
465
519
  - fair
466
520
  - high
467
521
  - fixed
468
- :desc: "Specifies most aggressive rate policy that is allowed.\n
469
- Returned by node API."
470
- fasp_url:
522
+ :tragents:
523
+ - :connect
471
524
  :cltype: :ignore
472
- :context:
525
+ fasp_url:
526
+ :tragents:
473
527
  - :unknown
474
- lock_min_rate:
475
528
  :cltype: :ignore
529
+ lock_min_rate:
476
530
  :accepted_types: :bool
477
- lock_target_rate:
478
531
  :cltype: :ignore
532
+ lock_target_rate:
479
533
  :accepted_types: :bool
534
+ :cltype: :ignore
480
535
  authentication:
536
+ :desc: 'value=token for SSH bypass keys, else password asked if not provided.'
481
537
  :cltype: :ignore
482
- :context:
538
+ :tragents:
483
539
  - :connect
484
- :desc: 'value=token for SSH bypass keys, else password asked if not provided.'
485
540
  cipher_allowed:
486
- :cltype: :ignore
487
541
  :desc: returned by node API. Valid literals include "aes-128" and "none".
488
- obfuscate_file_names:
489
542
  :cltype: :ignore
543
+ obfuscate_file_names:
490
544
  :accepted_types: :bool
491
- :context:
545
+ :tragents:
492
546
  - :unknown
547
+ :cltype: :ignore
493
548
  EX_file_list:
494
- :cltype: :defer
495
- :option_switch: "--file-list"
496
- :context:
497
- - :direct
498
549
  :desc: source file list
499
- EX_file_pair_list:
500
- :cltype: :defer
501
- :option_switch: "--file-pair-list"
502
- :context:
550
+ :tragents:
503
551
  - :direct
552
+ :cltype: :defer
553
+ :clswitch: "--file-list"
554
+ EX_file_pair_list:
504
555
  :desc: source file pair list
556
+ :tragents:
557
+ - :direct
558
+ :cltype: :defer
559
+ :clswitch: "--file-pair-list"
505
560
  EX_ascp_args:
561
+ :desc: Add native command line arguments to ascp
506
562
  :cltype: :defer
507
563
  :accepted_types: :array
508
- :context:
564
+ :tragents:
509
565
  - :direct
510
- :desc: Add command line arguments to ascp
511
566
  wss_enabled:
512
567
  :cltype: :defer
513
568
  :accepted_types: :bool
514
569
  wss_port:
515
- :cltype: :defer
570
+ :desc: TCP port used for websocket service feed.
516
571
  :accepted_types: :int
572
+ :cltype: :defer
517
573
  compression:
574
+ :desc: ascp4 only, 0 / 1?
518
575
  :accepted_types: :int
519
- :context:
576
+ :tragents:
520
577
  - :unknown
521
- :desc: ascp4 only, 0 / 1?
522
578
  read_threads:
523
579
  :accepted_types: :int
524
- :context:
580
+ :tragents:
525
581
  - :unknown
526
582
  :desc: ascp4 only
527
583
  write_threads:
584
+ :desc: ascp4 only
528
585
  :accepted_types: :int
529
- :context:
586
+ :tragents:
530
587
  - :unknown
531
- :desc: ascp4 only