aspera-cli 4.5.0 → 4.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +1 -0
- data/README.md +1894 -1574
- data/bin/ascli +21 -1
- data/bin/asession +38 -34
- data/docs/test_env.conf +14 -3
- data/examples/aoc.rb +17 -15
- data/examples/dascli +26 -0
- data/examples/faspex4.rb +42 -35
- data/examples/proxy.pac +1 -1
- data/examples/transfer.rb +38 -37
- data/lib/aspera/aoc.rb +245 -205
- data/lib/aspera/ascmd.rb +111 -90
- data/lib/aspera/ats_api.rb +16 -14
- data/lib/aspera/cli/basic_auth_plugin.rb +19 -18
- data/lib/aspera/cli/extended_value.rb +50 -39
- data/lib/aspera/cli/formater.rb +161 -135
- data/lib/aspera/cli/info.rb +18 -0
- data/lib/aspera/cli/listener/line_dump.rb +4 -2
- data/lib/aspera/cli/listener/logger.rb +3 -1
- data/lib/aspera/cli/listener/progress.rb +20 -21
- data/lib/aspera/cli/listener/progress_multi.rb +29 -31
- data/lib/aspera/cli/main.rb +194 -183
- data/lib/aspera/cli/manager.rb +213 -206
- data/lib/aspera/cli/plugin.rb +71 -49
- data/lib/aspera/cli/plugins/alee.rb +8 -7
- data/lib/aspera/cli/plugins/aoc.rb +675 -558
- data/lib/aspera/cli/plugins/ats.rb +116 -109
- data/lib/aspera/cli/plugins/bss.rb +35 -34
- data/lib/aspera/cli/plugins/config.rb +722 -542
- data/lib/aspera/cli/plugins/console.rb +28 -22
- data/lib/aspera/cli/plugins/cos.rb +28 -37
- data/lib/aspera/cli/plugins/faspex.rb +281 -227
- data/lib/aspera/cli/plugins/faspex5.rb +129 -84
- data/lib/aspera/cli/plugins/node.rb +426 -232
- data/lib/aspera/cli/plugins/orchestrator.rb +106 -98
- data/lib/aspera/cli/plugins/preview.rb +196 -191
- data/lib/aspera/cli/plugins/server.rb +131 -126
- data/lib/aspera/cli/plugins/shares.rb +49 -36
- data/lib/aspera/cli/plugins/sync.rb +27 -28
- data/lib/aspera/cli/transfer_agent.rb +84 -79
- data/lib/aspera/cli/version.rb +3 -1
- data/lib/aspera/colors.rb +37 -28
- data/lib/aspera/command_line_builder.rb +84 -63
- data/lib/aspera/cos_node.rb +68 -34
- data/lib/aspera/data_repository.rb +4 -2
- data/lib/aspera/environment.rb +61 -46
- data/lib/aspera/fasp/agent_base.rb +36 -31
- data/lib/aspera/fasp/agent_connect.rb +44 -37
- data/lib/aspera/fasp/agent_direct.rb +101 -104
- data/lib/aspera/fasp/agent_httpgw.rb +91 -90
- data/lib/aspera/fasp/agent_node.rb +36 -33
- data/lib/aspera/fasp/agent_trsdk.rb +28 -31
- data/lib/aspera/fasp/error.rb +3 -1
- data/lib/aspera/fasp/error_info.rb +81 -54
- data/lib/aspera/fasp/installation.rb +171 -151
- data/lib/aspera/fasp/listener.rb +2 -0
- data/lib/aspera/fasp/parameters.rb +105 -111
- data/lib/aspera/fasp/parameters.yaml +305 -249
- data/lib/aspera/fasp/resume_policy.rb +20 -20
- data/lib/aspera/fasp/transfer_spec.rb +27 -0
- data/lib/aspera/fasp/uri.rb +31 -29
- data/lib/aspera/faspex_gw.rb +95 -118
- data/lib/aspera/hash_ext.rb +12 -13
- data/lib/aspera/id_generator.rb +11 -9
- data/lib/aspera/keychain/encrypted_hash.rb +73 -57
- data/lib/aspera/keychain/macos_security.rb +27 -29
- data/lib/aspera/log.rb +40 -39
- data/lib/aspera/nagios.rb +24 -22
- data/lib/aspera/node.rb +38 -30
- data/lib/aspera/oauth.rb +217 -248
- data/lib/aspera/open_application.rb +9 -7
- data/lib/aspera/persistency_action_once.rb +15 -14
- data/lib/aspera/persistency_folder.rb +15 -18
- data/lib/aspera/preview/file_types.rb +266 -270
- data/lib/aspera/preview/generator.rb +94 -92
- data/lib/aspera/preview/image_error.png +0 -0
- data/lib/aspera/preview/options.rb +20 -17
- data/lib/aspera/preview/utils.rb +99 -102
- data/lib/aspera/preview/video_error.png +0 -0
- data/lib/aspera/{proxy_auto_config.erb.js → proxy_auto_config.js} +23 -31
- data/lib/aspera/proxy_auto_config.rb +114 -21
- data/lib/aspera/rest.rb +144 -142
- data/lib/aspera/rest_call_error.rb +3 -2
- data/lib/aspera/rest_error_analyzer.rb +31 -31
- data/lib/aspera/rest_errors_aspera.rb +18 -16
- data/lib/aspera/secret_hider.rb +68 -0
- data/lib/aspera/ssh.rb +20 -16
- data/lib/aspera/sync.rb +57 -54
- data/lib/aspera/temp_file_manager.rb +20 -14
- data/lib/aspera/timer_limiter.rb +10 -8
- data/lib/aspera/uri_reader.rb +14 -15
- data/lib/aspera/web_auth.rb +85 -80
- data.tar.gz.sig +0 -0
- metadata +169 -40
- metadata.gz.sig +2 -0
- data/bin/dascli +0 -13
- data/docs/Makefile +0 -63
- data/docs/README.erb.md +0 -4221
- data/docs/README.md +0 -13
- data/docs/diagrams.txt +0 -49
- data/docs/doc_tools.rb +0 -58
- data/lib/aspera/cli/plugins/shares2.rb +0 -114
- 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
|
-
:
|
4
|
-
:option_switch: "-c"
|
13
|
+
:desc: "In transit encryption type."
|
5
14
|
:enum:
|
6
|
-
-
|
7
|
-
-
|
8
|
-
-
|
9
|
-
-
|
10
|
-
-
|
11
|
-
-
|
12
|
-
-
|
13
|
-
-
|
14
|
-
-
|
15
|
-
|
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
|
-
:
|
26
|
+
:cltype: :opt_with_arg
|
27
|
+
:clswitch: "-c"
|
28
|
+
:clconvert: Aspera::Fasp::Parameters.clconv_remove_hyphen
|
18
29
|
content_protection:
|
19
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
57
|
+
:tragents:
|
42
58
|
- :node
|
43
|
-
:
|
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
|
-
:
|
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
|
-
:
|
69
|
+
:tragents:
|
48
70
|
- :sdk
|
71
|
+
:cltype: :ignore
|
49
72
|
direction:
|
50
|
-
:
|
51
|
-
:
|
73
|
+
:desc: 'Direction of transfer (on client side)'
|
74
|
+
:required: true
|
52
75
|
:enum:
|
53
76
|
- send
|
54
77
|
- receive
|
55
|
-
:
|
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
|
-
:
|
84
|
+
:desc: skip src files with mtime > arg
|
62
85
|
:accepted_types: :int
|
63
|
-
:
|
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
|
-
:
|
92
|
+
:tragents:
|
70
93
|
- :direct
|
71
|
-
:desc: skip src files with mtime < arg
|
72
|
-
fasp_port:
|
73
94
|
:cltype: :opt_with_arg
|
74
|
-
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
92
|
-
:option_switch: "-t"
|
129
|
+
:desc: Specifies http port when no cipher is used
|
93
130
|
:accepted_types: :int
|
94
|
-
:
|
131
|
+
:tragents:
|
95
132
|
- :direct
|
96
|
-
:
|
133
|
+
:cltype: :opt_with_arg
|
134
|
+
:clswitch: "-t"
|
97
135
|
https_fallback_port:
|
98
|
-
:
|
136
|
+
:desc: Specifies https port when cipher is used
|
99
137
|
:accepted_types: :int
|
100
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
165
|
+
:cltype: :opt_with_arg
|
127
166
|
paths:
|
128
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
213
|
+
:desc: Remove SRC files after transfer success
|
171
214
|
:accepted_types: :bool
|
172
|
-
:
|
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
|
-
:
|
222
|
+
:tragents:
|
180
223
|
- :direct
|
181
224
|
- :node
|
182
|
-
:
|
225
|
+
:cltype: :opt_without_arg
|
183
226
|
remove_skipped:
|
184
|
-
:
|
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
|
-
:
|
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
|
-
|
240
|
+
:tragents:
|
241
|
+
- :direct
|
242
|
+
- :sdk
|
198
243
|
:cltype: :opt_with_arg
|
199
|
-
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
272
|
+
:tragents:
|
225
273
|
- :sdk
|
274
|
+
- :node
|
275
|
+
:cltype: :ignore
|
226
276
|
ssh_port:
|
227
|
-
:
|
228
|
-
:option_switch: "-P"
|
277
|
+
:desc: "Specifies SSH (TCP) port. Default: local:22, other:33001"
|
229
278
|
:accepted_types: :int
|
230
|
-
:
|
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
|
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
|
-
:
|
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
|
-
:
|
293
|
+
:tragents:
|
244
294
|
- :sdk
|
295
|
+
- :direct
|
296
|
+
:cltype: :envvar
|
297
|
+
:clvarname: ASPERA_SCP_PASS
|
245
298
|
ssh_args:
|
246
|
-
:
|
299
|
+
:desc: Array of arguments to pass to SSH. Use with caution.
|
247
300
|
:accepted_types: :string
|
248
|
-
:
|
301
|
+
:tragents:
|
249
302
|
- :sdk
|
303
|
+
:cltype: :ignore
|
250
304
|
symlink_policy:
|
251
|
-
:
|
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
|
-
:
|
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
|
-
:
|
313
|
+
:clswitch: "--symbolic-links"
|
314
|
+
tags:
|
315
|
+
:desc: Metadata for transfer as JSON
|
280
316
|
:accepted_types: :hash
|
281
|
-
:
|
282
|
-
:
|
317
|
+
:cltype: :opt_with_arg
|
318
|
+
:clswitch: "--tags64"
|
319
|
+
:clconvert: Aspera::Fasp::Parameters.clconv_json64
|
283
320
|
target_rate_cap_kbps:
|
284
|
-
:
|
321
|
+
:desc: Returned by upload/download_setup node API.
|
285
322
|
:accepted_types: :int
|
286
|
-
:
|
323
|
+
:tragents:
|
287
324
|
- :connect
|
288
|
-
:
|
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
|
-
:
|
334
|
+
:tragents:
|
297
335
|
- :node
|
298
336
|
- :connect
|
299
|
-
:
|
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
|
-
:
|
343
|
+
:desc: specify version of protocol
|
306
344
|
:accepted_types: :bool
|
307
345
|
:default: false
|
308
|
-
:
|
346
|
+
:tragents:
|
309
347
|
- :direct
|
310
348
|
- :node
|
311
349
|
- :sdk
|
312
|
-
:
|
350
|
+
:cltype: :defer
|
313
351
|
use_system_ssh:
|
314
|
-
:cltype: :ignore
|
315
|
-
:option_switch: "-SSH"
|
316
352
|
:accepted_types: :string
|
317
|
-
:
|
353
|
+
:tragents:
|
318
354
|
- :sdk
|
319
|
-
|
320
|
-
:
|
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
|
-
:
|
343
|
-
:context:
|
376
|
+
:tragents:
|
344
377
|
- :direct
|
345
378
|
- :sdk
|
379
|
+
:cltype: :opt_without_arg
|
346
380
|
preserve_acls:
|
347
|
-
:
|
348
|
-
:
|
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
|
-
:
|
390
|
+
:cltype: :opt_with_arg
|
352
391
|
preserve_remote_acls:
|
353
|
-
:
|
354
|
-
:
|
355
|
-
|
392
|
+
:desc: "Preserve remote access control lists."
|
393
|
+
:enum:
|
394
|
+
- none
|
395
|
+
- native
|
396
|
+
- metafile
|
397
|
+
:default: none
|
398
|
+
:tragents:
|
356
399
|
- :sdk
|
357
|
-
:
|
358
|
-
|
400
|
+
- :direct
|
401
|
+
:cltype: :opt_with_arg
|
402
|
+
:clswitch: "--remote-preserve-acls"
|
359
403
|
preserve_file_owner_uid:
|
360
|
-
:
|
404
|
+
:desc: Preserve the user ID for a file owner
|
361
405
|
:accepted_types: :bool
|
362
|
-
:
|
406
|
+
:tragents:
|
363
407
|
- :sdk
|
408
|
+
- :direct
|
409
|
+
:cltype: :opt_without_arg
|
364
410
|
preserve_file_owner_gid:
|
365
|
-
:
|
411
|
+
:desc: Preserve the group ID for a file owner
|
366
412
|
:accepted_types: :bool
|
367
|
-
:
|
413
|
+
:tragents:
|
368
414
|
- :sdk
|
415
|
+
- :direct
|
416
|
+
:cltype: :opt_without_arg
|
369
417
|
preserve_extended_attrs:
|
370
|
-
:
|
371
|
-
:
|
372
|
-
|
418
|
+
:desc: "Preserve the extended attributes."
|
419
|
+
:enum:
|
420
|
+
- none
|
421
|
+
- native
|
422
|
+
- metafile
|
423
|
+
:default: none
|
424
|
+
:tragents:
|
373
425
|
- :sdk
|
374
|
-
:
|
375
|
-
|
426
|
+
:cltype: :opt_with_arg
|
427
|
+
:clswitch: "--preserve-xattrs"
|
376
428
|
preserve_source_access_time:
|
377
|
-
:
|
429
|
+
:desc: Preserve the time logged for when the source file was accessed
|
378
430
|
:accepted_types: :bool
|
379
|
-
:
|
431
|
+
:tragents:
|
380
432
|
- :sdk
|
381
|
-
|
433
|
+
- :direct
|
382
434
|
:cltype: :opt_without_arg
|
383
|
-
|
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
|
-
|
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
|
-
:
|
463
|
+
:tragents:
|
408
464
|
- :none
|
409
465
|
dgram_size:
|
410
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
427
|
-
|
428
|
-
- :direct
|
479
|
+
:clswitch: "--check-sshfp"
|
480
|
+
EX_http_proxy_url:
|
429
481
|
:desc: Specify the proxy server address used by HTTP Fallback
|
430
|
-
|
482
|
+
:tragents:
|
483
|
+
- :direct
|
431
484
|
:cltype: :opt_with_arg
|
432
|
-
:
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
497
|
+
:tragents:
|
443
498
|
- :direct
|
444
|
-
:
|
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
|
-
|
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
|
-
:
|
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
|
-
:
|
469
|
-
|
470
|
-
fasp_url:
|
522
|
+
:tragents:
|
523
|
+
- :connect
|
471
524
|
:cltype: :ignore
|
472
|
-
|
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
|
-
:
|
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
|
-
:
|
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
|
-
|
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
|
-
:
|
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
|
-
:
|
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
|
-
:
|
576
|
+
:tragents:
|
520
577
|
- :unknown
|
521
|
-
:desc: ascp4 only, 0 / 1?
|
522
578
|
read_threads:
|
523
579
|
:accepted_types: :int
|
524
|
-
:
|
580
|
+
:tragents:
|
525
581
|
- :unknown
|
526
582
|
:desc: ascp4 only
|
527
583
|
write_threads:
|
584
|
+
:desc: ascp4 only
|
528
585
|
:accepted_types: :int
|
529
|
-
:
|
586
|
+
:tragents:
|
530
587
|
- :unknown
|
531
|
-
:desc: ascp4 only
|