]> git.proxmox.com Git - proxmox-backup.git/blame - src/bin/proxmox-backup-client.rs
src/bin/proxmox-backup-client.rs: fix typo in property description
[proxmox-backup.git] / src / bin / proxmox-backup-client.rs
CommitLineData
ff5d3707 1use failure::*;
70235f72
CE
2use nix::unistd::{fork, ForkResult, pipe};
3use std::os::unix::io::RawFd;
27c9affb 4use chrono::{Local, DateTime, Utc, TimeZone};
e9c9409a 5use std::path::{Path, PathBuf};
2eeaacb9 6use std::collections::{HashSet, HashMap};
70235f72 7use std::ffi::OsStr;
bb19af73 8use std::io::{Write, Seek, SeekFrom};
2761d6a4
DM
9use std::os::unix::fs::OpenOptionsExt;
10
552c2259 11use proxmox::{sortable, identity};
feaa1ad3 12use proxmox::tools::fs::{file_get_contents, file_get_json, replace_file, CreateOptions, image_size};
a47a02ae 13use proxmox::api::{ApiHandler, ApiMethod, RpcEnvironment};
3d482025 14use proxmox::api::schema::*;
7eea56ca 15use proxmox::api::cli::*;
5830c205 16use proxmox::api::api;
ff5d3707 17
fe0e04c6 18use proxmox_backup::tools;
bbf9e7e9 19use proxmox_backup::api2::types::*;
151c6ce2 20use proxmox_backup::client::*;
247cdbce 21use proxmox_backup::backup::*;
7926a3a1 22use proxmox_backup::pxar::{ self, catalog::* };
86eda3eb 23
fe0e04c6
DM
24//use proxmox_backup::backup::image_index::*;
25//use proxmox_backup::config::datastore;
8968258b 26//use proxmox_backup::pxar::encoder::*;
728797d0 27//use proxmox_backup::backup::datastore::*;
23bb8780 28
f5f13ebc 29use serde_json::{json, Value};
1c0472e8 30//use hyper::Body;
2761d6a4 31use std::sync::{Arc, Mutex};
255f378a 32//use regex::Regex;
d0a03d40 33use xdg::BaseDirectories;
ae0be2dd 34
5a2df000 35use futures::*;
c4ff3dce 36use tokio::sync::mpsc;
ae0be2dd 37
9ea4bce4 38proxmox::const_regex! {
255f378a 39 BACKUPSPEC_REGEX = r"^([a-zA-Z0-9_-]+\.(?:pxar|img|conf|log)):(.+)$";
ae0be2dd 40}
33d64b81 41
255f378a
DM
42const REPO_URL_SCHEMA: Schema = StringSchema::new("Repository URL.")
43 .format(&BACKUP_REPO_URL)
44 .max_length(256)
45 .schema();
d0a03d40 46
a47a02ae
DM
47const BACKUP_SOURCE_SCHEMA: Schema = StringSchema::new(
48 "Backup source specification ([<label>:<path>]).")
49 .format(&ApiStringFormat::Pattern(&BACKUPSPEC_REGEX))
50 .schema();
51
52const KEYFILE_SCHEMA: Schema = StringSchema::new(
53 "Path to encryption key. All data will be encrypted using this key.")
54 .schema();
55
56const CHUNK_SIZE_SCHEMA: Schema = IntegerSchema::new(
57 "Chunk size in KB. Must be a power of 2.")
58 .minimum(64)
59 .maximum(4096)
60 .default(4096)
61 .schema();
62
2665cef7
DM
63fn get_default_repository() -> Option<String> {
64 std::env::var("PBS_REPOSITORY").ok()
65}
66
67fn extract_repository_from_value(
68 param: &Value,
69) -> Result<BackupRepository, Error> {
70
71 let repo_url = param["repository"]
72 .as_str()
73 .map(String::from)
74 .or_else(get_default_repository)
75 .ok_or_else(|| format_err!("unable to get (default) repository"))?;
76
77 let repo: BackupRepository = repo_url.parse()?;
78
79 Ok(repo)
80}
81
82fn extract_repository_from_map(
83 param: &HashMap<String, String>,
84) -> Option<BackupRepository> {
85
86 param.get("repository")
87 .map(String::from)
88 .or_else(get_default_repository)
89 .and_then(|repo_url| repo_url.parse::<BackupRepository>().ok())
90}
91
d0a03d40
DM
92fn record_repository(repo: &BackupRepository) {
93
94 let base = match BaseDirectories::with_prefix("proxmox-backup") {
95 Ok(v) => v,
96 _ => return,
97 };
98
99 // usually $HOME/.cache/proxmox-backup/repo-list
100 let path = match base.place_cache_file("repo-list") {
101 Ok(v) => v,
102 _ => return,
103 };
104
11377a47 105 let mut data = file_get_json(&path, None).unwrap_or_else(|_| json!({}));
d0a03d40
DM
106
107 let repo = repo.to_string();
108
109 data[&repo] = json!{ data[&repo].as_i64().unwrap_or(0) + 1 };
110
111 let mut map = serde_json::map::Map::new();
112
113 loop {
114 let mut max_used = 0;
115 let mut max_repo = None;
116 for (repo, count) in data.as_object().unwrap() {
117 if map.contains_key(repo) { continue; }
118 if let Some(count) = count.as_i64() {
119 if count > max_used {
120 max_used = count;
121 max_repo = Some(repo);
122 }
123 }
124 }
125 if let Some(repo) = max_repo {
126 map.insert(repo.to_owned(), json!(max_used));
127 } else {
128 break;
129 }
130 if map.len() > 10 { // store max. 10 repos
131 break;
132 }
133 }
134
135 let new_data = json!(map);
136
feaa1ad3 137 let _ = replace_file(path, new_data.to_string().as_bytes(), CreateOptions::new());
d0a03d40
DM
138}
139
49811347 140fn complete_repository(_arg: &str, _param: &HashMap<String, String>) -> Vec<String> {
d0a03d40
DM
141
142 let mut result = vec![];
143
144 let base = match BaseDirectories::with_prefix("proxmox-backup") {
145 Ok(v) => v,
146 _ => return result,
147 };
148
149 // usually $HOME/.cache/proxmox-backup/repo-list
150 let path = match base.place_cache_file("repo-list") {
151 Ok(v) => v,
152 _ => return result,
153 };
154
11377a47 155 let data = file_get_json(&path, None).unwrap_or_else(|_| json!({}));
d0a03d40
DM
156
157 if let Some(map) = data.as_object() {
49811347 158 for (repo, _count) in map {
d0a03d40
DM
159 result.push(repo.to_owned());
160 }
161 }
162
163 result
164}
165
d105176f
DM
166async fn view_task_result(
167 client: HttpClient,
168 result: Value,
169 output_format: &str,
170) -> Result<(), Error> {
171 let data = &result["data"];
172 if output_format == "text" {
173 if let Some(upid) = data.as_str() {
174 display_task_log(client, upid, true).await?;
175 }
176 } else {
177 format_and_print_result(&data, &output_format);
178 }
179
180 Ok(())
181}
182
42af4b8f
DM
183async fn api_datastore_list_snapshots(
184 client: &HttpClient,
185 store: &str,
186 group: Option<BackupGroup>,
187) -> Result<Vec<SnapshotListItem>, Error> {
188
189 let path = format!("api2/json/admin/datastore/{}/snapshots", store);
190
191 let mut args = json!({});
192 if let Some(group) = group {
193 args["backup-type"] = group.backup_type().into();
194 args["backup-id"] = group.backup_id().into();
195 }
196
197 let mut result = client.get(&path, Some(args)).await?;
198
199 let list: Vec<SnapshotListItem> = serde_json::from_value(result["data"].take())?;
200
201 Ok(list)
202}
203
27c9affb
DM
204async fn api_datastore_latest_snapshot(
205 client: &HttpClient,
206 store: &str,
207 group: BackupGroup,
208) -> Result<(String, String, DateTime<Utc>), Error> {
209
210 let mut list = api_datastore_list_snapshots(client, store, Some(group.clone())).await?;
211
212 if list.is_empty() {
213 bail!("backup group {:?} does not contain any snapshots.", group.group_path());
214 }
215
216 list.sort_unstable_by(|a, b| b.backup_time.cmp(&a.backup_time));
217
218 let backup_time = Utc.timestamp(list[0].backup_time, 0);
219
220 Ok((group.backup_type().to_owned(), group.backup_id().to_owned(), backup_time))
221}
222
223
e9722f8b 224async fn backup_directory<P: AsRef<Path>>(
cf9271e2 225 client: &BackupWriter,
17d6979a 226 dir_path: P,
247cdbce 227 archive_name: &str,
36898ffc 228 chunk_size: Option<usize>,
2eeaacb9 229 device_set: Option<HashSet<u64>>,
219ef0e6 230 verbose: bool,
5b72c9b4 231 skip_lost_and_found: bool,
f98ac774 232 crypt_config: Option<Arc<CryptConfig>>,
f1d99e3f 233 catalog: Arc<Mutex<CatalogWriter<crate::tools::StdChannelWriter>>>,
6fc053ed 234 entries_max: usize,
2c3891d1 235) -> Result<BackupStats, Error> {
33d64b81 236
6fc053ed
CE
237 let pxar_stream = PxarBackupStream::open(
238 dir_path.as_ref(),
239 device_set,
240 verbose,
241 skip_lost_and_found,
242 catalog,
243 entries_max,
244 )?;
e9722f8b 245 let mut chunk_stream = ChunkStream::new(pxar_stream, chunk_size);
ff3d3100 246
e9722f8b 247 let (mut tx, rx) = mpsc::channel(10); // allow to buffer 10 chunks
5e7a09be 248
c4ff3dce 249 let stream = rx
e9722f8b 250 .map_err(Error::from);
17d6979a 251
c4ff3dce 252 // spawn chunker inside a separate task so that it can run parallel
e9722f8b 253 tokio::spawn(async move {
db0cb9ce
WB
254 while let Some(v) = chunk_stream.next().await {
255 let _ = tx.send(v).await;
256 }
e9722f8b 257 });
17d6979a 258
e9722f8b
WB
259 let stats = client
260 .upload_stream(archive_name, stream, "dynamic", None, crypt_config)
261 .await?;
bcd879cf 262
2c3891d1 263 Ok(stats)
bcd879cf
DM
264}
265
e9722f8b 266async fn backup_image<P: AsRef<Path>>(
cf9271e2 267 client: &BackupWriter,
6af905c1
DM
268 image_path: P,
269 archive_name: &str,
270 image_size: u64,
36898ffc 271 chunk_size: Option<usize>,
1c0472e8 272 _verbose: bool,
f98ac774 273 crypt_config: Option<Arc<CryptConfig>>,
2c3891d1 274) -> Result<BackupStats, Error> {
6af905c1 275
6af905c1
DM
276 let path = image_path.as_ref().to_owned();
277
e9722f8b 278 let file = tokio::fs::File::open(path).await?;
6af905c1 279
db0cb9ce 280 let stream = tokio_util::codec::FramedRead::new(file, tokio_util::codec::BytesCodec::new())
6af905c1
DM
281 .map_err(Error::from);
282
36898ffc 283 let stream = FixedChunkStream::new(stream, chunk_size.unwrap_or(4*1024*1024));
6af905c1 284
e9722f8b
WB
285 let stats = client
286 .upload_stream(archive_name, stream, "fixed", Some(image_size), crypt_config)
287 .await?;
6af905c1 288
2c3891d1 289 Ok(stats)
6af905c1
DM
290}
291
52c171e4
DM
292fn strip_server_file_expenstion(name: &str) -> String {
293
11377a47
DM
294 if name.ends_with(".didx") || name.ends_with(".fidx") || name.ends_with(".blob") {
295 name[..name.len()-5].to_owned()
52c171e4 296 } else {
11377a47 297 name.to_owned() // should not happen
8e39232a 298 }
8e39232a
DM
299}
300
a47a02ae
DM
301#[api(
302 input: {
303 properties: {
304 repository: {
305 schema: REPO_URL_SCHEMA,
306 optional: true,
307 },
308 "output-format": {
309 schema: OUTPUT_FORMAT,
310 optional: true,
311 },
312 }
313 }
314)]
315/// List backup groups.
316async fn list_backup_groups(param: Value) -> Result<Value, Error> {
812c6f87 317
2665cef7 318 let repo = extract_repository_from_value(&param)?;
812c6f87 319
cc2ce4a9 320 let client = HttpClient::new(repo.host(), repo.user(), None)?;
812c6f87 321
d0a03d40 322 let path = format!("api2/json/admin/datastore/{}/groups", repo.store());
812c6f87 323
8a8a4703 324 let mut result = client.get(&path, None).await?;
812c6f87 325
d0a03d40
DM
326 record_repository(&repo);
327
812c6f87 328 // fixme: implement and use output formatter instead ..
80822b95
DM
329 let list = result["data"].as_array_mut().unwrap();
330
331 list.sort_unstable_by(|a, b| {
332 let a_id = a["backup-id"].as_str().unwrap();
333 let a_backup_type = a["backup-type"].as_str().unwrap();
334 let b_id = b["backup-id"].as_str().unwrap();
335 let b_backup_type = b["backup-type"].as_str().unwrap();
336
337 let type_order = a_backup_type.cmp(b_backup_type);
338 if type_order == std::cmp::Ordering::Equal {
339 a_id.cmp(b_id)
340 } else {
341 type_order
342 }
343 });
812c6f87 344
34a816cc
DM
345 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
346
347 let mut result = vec![];
348
812c6f87
DM
349 for item in list {
350
ad20d198
DM
351 let id = item["backup-id"].as_str().unwrap();
352 let btype = item["backup-type"].as_str().unwrap();
353 let epoch = item["last-backup"].as_i64().unwrap();
fa5d6977 354 let last_backup = Utc.timestamp(epoch, 0);
ad20d198 355 let backup_count = item["backup-count"].as_u64().unwrap();
812c6f87 356
1e9a94e5 357 let group = BackupGroup::new(btype, id);
812c6f87
DM
358
359 let path = group.group_path().to_str().unwrap().to_owned();
ad20d198 360
52c171e4
DM
361 let files = item["files"].as_array().unwrap().iter()
362 .map(|v| strip_server_file_expenstion(v.as_str().unwrap())).collect();
ad20d198 363
34a816cc 364 if output_format == "text" {
fa5d6977
DM
365 println!(
366 "{:20} | {} | {:5} | {}",
367 path,
368 BackupDir::backup_time_to_string(last_backup),
369 backup_count,
370 tools::join(&files, ' '),
371 );
34a816cc
DM
372 } else {
373 result.push(json!({
374 "backup-type": btype,
375 "backup-id": id,
376 "last-backup": epoch,
377 "backup-count": backup_count,
378 "files": files,
379 }));
380 }
812c6f87
DM
381 }
382
9aa3f682 383 if output_format != "text" { format_and_print_result(&result.into(), &output_format); }
34a816cc 384
812c6f87
DM
385 Ok(Value::Null)
386}
387
a47a02ae
DM
388#[api(
389 input: {
390 properties: {
391 repository: {
392 schema: REPO_URL_SCHEMA,
393 optional: true,
394 },
395 group: {
396 type: String,
397 description: "Backup group.",
398 optional: true,
399 },
400 "output-format": {
401 schema: OUTPUT_FORMAT,
402 optional: true,
403 },
404 }
405 }
406)]
407/// List backup snapshots.
408async fn list_snapshots(param: Value) -> Result<Value, Error> {
184f17af 409
2665cef7 410 let repo = extract_repository_from_value(&param)?;
184f17af 411
34a816cc
DM
412 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
413
cc2ce4a9 414 let client = HttpClient::new(repo.host(), repo.user(), None)?;
184f17af 415
42af4b8f
DM
416 let group = if let Some(path) = param["group"].as_str() {
417 Some(BackupGroup::parse(path)?)
418 } else {
419 None
420 };
184f17af 421
42af4b8f 422 let mut list = api_datastore_list_snapshots(&client, repo.store(), group).await?;
15c847f1 423
42af4b8f 424 list.sort_unstable_by(|a, b| a.backup_time.cmp(&b.backup_time));
184f17af 425
d0a03d40
DM
426 record_repository(&repo);
427
af9d4afc 428 if output_format != "text" {
42af4b8f 429 format_and_print_result(&serde_json::to_value(list)?, &output_format);
af9d4afc
DM
430 return Ok(Value::Null);
431 }
184f17af
DM
432
433 for item in list {
434
af9d4afc 435 let snapshot = BackupDir::new(item.backup_type, item.backup_id, item.backup_time);
184f17af
DM
436
437 let path = snapshot.relative_path().to_str().unwrap().to_owned();
438
af9d4afc
DM
439 let files = item.files.iter()
440 .map(|v| strip_server_file_expenstion(&v))
441 .collect();
184f17af 442
af9d4afc
DM
443 let size_str = if let Some(size) = item.size {
444 size.to_string()
34a816cc 445 } else {
af9d4afc
DM
446 String::from("-")
447 };
448 println!("{} | {} | {}", path, size_str, tools::join(&files, ' '));
184f17af
DM
449 }
450
451 Ok(Value::Null)
452}
453
a47a02ae
DM
454#[api(
455 input: {
456 properties: {
457 repository: {
458 schema: REPO_URL_SCHEMA,
459 optional: true,
460 },
461 snapshot: {
462 type: String,
463 description: "Snapshot path.",
464 },
465 }
466 }
467)]
468/// Forget (remove) backup snapshots.
469async fn forget_snapshots(param: Value) -> Result<Value, Error> {
6f62c924 470
2665cef7 471 let repo = extract_repository_from_value(&param)?;
6f62c924
DM
472
473 let path = tools::required_string_param(&param, "snapshot")?;
474 let snapshot = BackupDir::parse(path)?;
475
cc2ce4a9 476 let mut client = HttpClient::new(repo.host(), repo.user(), None)?;
6f62c924 477
9e391bb7 478 let path = format!("api2/json/admin/datastore/{}/snapshots", repo.store());
6f62c924 479
8a8a4703
DM
480 let result = client.delete(&path, Some(json!({
481 "backup-type": snapshot.group().backup_type(),
482 "backup-id": snapshot.group().backup_id(),
483 "backup-time": snapshot.backup_time().timestamp(),
484 }))).await?;
6f62c924 485
d0a03d40
DM
486 record_repository(&repo);
487
6f62c924
DM
488 Ok(result)
489}
490
a47a02ae
DM
491#[api(
492 input: {
493 properties: {
494 repository: {
495 schema: REPO_URL_SCHEMA,
496 optional: true,
497 },
498 }
499 }
500)]
501/// Try to login. If successful, store ticket.
502async fn api_login(param: Value) -> Result<Value, Error> {
e240d8be
DM
503
504 let repo = extract_repository_from_value(&param)?;
505
cc2ce4a9 506 let client = HttpClient::new(repo.host(), repo.user(), None)?;
8a8a4703 507 client.login().await?;
e240d8be
DM
508
509 record_repository(&repo);
510
511 Ok(Value::Null)
512}
513
a47a02ae
DM
514#[api(
515 input: {
516 properties: {
517 repository: {
518 schema: REPO_URL_SCHEMA,
519 optional: true,
520 },
521 }
522 }
523)]
524/// Logout (delete stored ticket).
525fn api_logout(param: Value) -> Result<Value, Error> {
e240d8be
DM
526
527 let repo = extract_repository_from_value(&param)?;
528
529 delete_ticket_info(repo.host(), repo.user())?;
530
531 Ok(Value::Null)
532}
533
a47a02ae
DM
534#[api(
535 input: {
536 properties: {
537 repository: {
538 schema: REPO_URL_SCHEMA,
539 optional: true,
540 },
541 snapshot: {
542 type: String,
543 description: "Snapshot path.",
544 },
545 }
546 }
547)]
548/// Dump catalog.
549async fn dump_catalog(param: Value) -> Result<Value, Error> {
9049a8cf
DM
550
551 let repo = extract_repository_from_value(&param)?;
552
553 let path = tools::required_string_param(&param, "snapshot")?;
554 let snapshot = BackupDir::parse(path)?;
555
11377a47 556 let keyfile = param["keyfile"].as_str().map(PathBuf::from);
9049a8cf
DM
557
558 let crypt_config = match keyfile {
559 None => None,
560 Some(path) => {
6d20a29d 561 let (key, _) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
9025312a 562 Some(Arc::new(CryptConfig::new(key)?))
9049a8cf
DM
563 }
564 };
565
cc2ce4a9 566 let client = HttpClient::new(repo.host(), repo.user(), None)?;
9049a8cf 567
8a8a4703
DM
568 let client = BackupReader::start(
569 client,
570 crypt_config.clone(),
571 repo.store(),
572 &snapshot.group().backup_type(),
573 &snapshot.group().backup_id(),
574 snapshot.backup_time(),
575 true,
576 ).await?;
9049a8cf 577
8a8a4703 578 let manifest = client.download_manifest().await?;
d2267b11 579
8a8a4703 580 let index = client.download_dynamic_index(&manifest, CATALOG_NAME).await?;
bf6e3217 581
8a8a4703 582 let most_used = index.find_most_used_chunks(8);
bf6e3217 583
8a8a4703 584 let chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config, most_used);
bf6e3217 585
8a8a4703 586 let mut reader = BufferedDynamicReader::new(index, chunk_reader);
9049a8cf 587
8a8a4703
DM
588 let mut catalogfile = std::fs::OpenOptions::new()
589 .write(true)
590 .read(true)
591 .custom_flags(libc::O_TMPFILE)
592 .open("/tmp")?;
d2267b11 593
8a8a4703
DM
594 std::io::copy(&mut reader, &mut catalogfile)
595 .map_err(|err| format_err!("unable to download catalog - {}", err))?;
a84ef4c2 596
8a8a4703 597 catalogfile.seek(SeekFrom::Start(0))?;
9049a8cf 598
8a8a4703 599 let mut catalog_reader = CatalogReader::new(catalogfile);
9049a8cf 600
8a8a4703 601 catalog_reader.dump()?;
e9722f8b 602
8a8a4703 603 record_repository(&repo);
9049a8cf
DM
604
605 Ok(Value::Null)
606}
607
a47a02ae
DM
608#[api(
609 input: {
610 properties: {
611 repository: {
612 schema: REPO_URL_SCHEMA,
613 optional: true,
614 },
615 snapshot: {
616 type: String,
617 description: "Snapshot path.",
618 },
619 "output-format": {
620 schema: OUTPUT_FORMAT,
621 optional: true,
622 },
623 }
624 }
625)]
626/// List snapshot files.
627async fn list_snapshot_files(param: Value) -> Result<Value, Error> {
52c171e4
DM
628
629 let repo = extract_repository_from_value(&param)?;
630
631 let path = tools::required_string_param(&param, "snapshot")?;
632 let snapshot = BackupDir::parse(path)?;
633
634 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
635
cc2ce4a9 636 let client = HttpClient::new(repo.host(), repo.user(), None)?;
52c171e4
DM
637
638 let path = format!("api2/json/admin/datastore/{}/files", repo.store());
639
8a8a4703
DM
640 let mut result = client.get(&path, Some(json!({
641 "backup-type": snapshot.group().backup_type(),
642 "backup-id": snapshot.group().backup_id(),
643 "backup-time": snapshot.backup_time().timestamp(),
644 }))).await?;
52c171e4
DM
645
646 record_repository(&repo);
647
8c70e3eb 648 let list: Value = result["data"].take();
52c171e4
DM
649
650 if output_format == "text" {
8c70e3eb
DM
651 for item in list.as_array().unwrap().iter() {
652 println!(
653 "{} {}",
654 strip_server_file_expenstion(item["filename"].as_str().unwrap()),
655 item["size"].as_u64().unwrap_or(0),
656 );
52c171e4
DM
657 }
658 } else {
8c70e3eb 659 format_and_print_result(&list, &output_format);
52c171e4
DM
660 }
661
662 Ok(Value::Null)
663}
664
a47a02ae 665#[api(
94913f35 666 input: {
a47a02ae
DM
667 properties: {
668 repository: {
669 schema: REPO_URL_SCHEMA,
670 optional: true,
671 },
94913f35
DM
672 "output-format": {
673 schema: OUTPUT_FORMAT,
674 optional: true,
675 },
676 },
677 },
a47a02ae
DM
678)]
679/// Start garbage collection for a specific repository.
680async fn start_garbage_collection(param: Value) -> Result<Value, Error> {
8cc0d6af 681
2665cef7 682 let repo = extract_repository_from_value(&param)?;
e5f7def4 683 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
8cc0d6af 684
cc2ce4a9 685 let mut client = HttpClient::new(repo.host(), repo.user(), None)?;
8cc0d6af 686
d0a03d40 687 let path = format!("api2/json/admin/datastore/{}/gc", repo.store());
8cc0d6af 688
8a8a4703 689 let result = client.post(&path, None).await?;
8cc0d6af 690
8a8a4703 691 record_repository(&repo);
d0a03d40 692
8a8a4703 693 view_task_result(client, result, &output_format).await?;
e5f7def4 694
e5f7def4 695 Ok(Value::Null)
8cc0d6af 696}
33d64b81 697
ae0be2dd
DM
698fn parse_backupspec(value: &str) -> Result<(&str, &str), Error> {
699
255f378a 700 if let Some(caps) = (BACKUPSPEC_REGEX.regex_obj)().captures(value) {
ae0be2dd
DM
701 return Ok((caps.get(1).unwrap().as_str(), caps.get(2).unwrap().as_str()));
702 }
703 bail!("unable to parse directory specification '{}'", value);
704}
705
bf6e3217
DM
706fn spawn_catalog_upload(
707 client: Arc<BackupWriter>,
708 crypt_config: Option<Arc<CryptConfig>>,
709) -> Result<
710 (
f1d99e3f 711 Arc<Mutex<CatalogWriter<crate::tools::StdChannelWriter>>>,
bf6e3217
DM
712 tokio::sync::oneshot::Receiver<Result<BackupStats, Error>>
713 ), Error>
714{
f1d99e3f
DM
715 let (catalog_tx, catalog_rx) = std::sync::mpsc::sync_channel(10); // allow to buffer 10 writes
716 let catalog_stream = crate::tools::StdChannelStream(catalog_rx);
bf6e3217
DM
717 let catalog_chunk_size = 512*1024;
718 let catalog_chunk_stream = ChunkStream::new(catalog_stream, Some(catalog_chunk_size));
719
f1d99e3f 720 let catalog = Arc::new(Mutex::new(CatalogWriter::new(crate::tools::StdChannelWriter::new(catalog_tx))?));
bf6e3217
DM
721
722 let (catalog_result_tx, catalog_result_rx) = tokio::sync::oneshot::channel();
723
724 tokio::spawn(async move {
725 let catalog_upload_result = client
726 .upload_stream(CATALOG_NAME, catalog_chunk_stream, "dynamic", None, crypt_config)
727 .await;
728
729 if let Err(ref err) = catalog_upload_result {
730 eprintln!("catalog upload error - {}", err);
731 client.cancel();
732 }
733
734 let _ = catalog_result_tx.send(catalog_upload_result);
735 });
736
737 Ok((catalog, catalog_result_rx))
738}
739
a47a02ae
DM
740#[api(
741 input: {
742 properties: {
743 backupspec: {
744 type: Array,
745 description: "List of backup source specifications ([<label.ext>:<path>] ...)",
746 items: {
747 schema: BACKUP_SOURCE_SCHEMA,
748 }
749 },
750 repository: {
751 schema: REPO_URL_SCHEMA,
752 optional: true,
753 },
754 "include-dev": {
755 description: "Include mountpoints with same st_dev number (see ``man fstat``) as specified files.",
756 optional: true,
757 items: {
758 type: String,
759 description: "Path to file.",
760 }
761 },
762 keyfile: {
763 schema: KEYFILE_SCHEMA,
764 optional: true,
765 },
766 "skip-lost-and-found": {
767 type: Boolean,
768 description: "Skip lost+found directory.",
769 optional: true,
770 },
771 "backup-type": {
772 schema: BACKUP_TYPE_SCHEMA,
773 optional: true,
774 },
775 "backup-id": {
776 schema: BACKUP_ID_SCHEMA,
777 optional: true,
778 },
779 "backup-time": {
780 schema: BACKUP_TIME_SCHEMA,
781 optional: true,
782 },
783 "chunk-size": {
784 schema: CHUNK_SIZE_SCHEMA,
785 optional: true,
786 },
6fc053ed
CE
787 "entries-max": {
788 type: Integer,
789 description: "Max number of entries to hold in memory.",
790 optional: true,
791 default: pxar::ENCODER_MAX_ENTRIES as isize,
792 },
a47a02ae
DM
793 }
794 }
795)]
796/// Create (host) backup.
797async fn create_backup(
6049b71f
DM
798 param: Value,
799 _info: &ApiMethod,
dd5495d6 800 _rpcenv: &mut dyn RpcEnvironment,
6049b71f 801) -> Result<Value, Error> {
ff5d3707 802
2665cef7 803 let repo = extract_repository_from_value(&param)?;
ae0be2dd
DM
804
805 let backupspec_list = tools::required_array_param(&param, "backupspec")?;
a914a774 806
eed6db39
DM
807 let all_file_systems = param["all-file-systems"].as_bool().unwrap_or(false);
808
5b72c9b4
DM
809 let skip_lost_and_found = param["skip-lost-and-found"].as_bool().unwrap_or(false);
810
219ef0e6
DM
811 let verbose = param["verbose"].as_bool().unwrap_or(false);
812
ca5d0b61
DM
813 let backup_time_opt = param["backup-time"].as_i64();
814
36898ffc 815 let chunk_size_opt = param["chunk-size"].as_u64().map(|v| (v*1024) as usize);
2d9d143a 816
247cdbce
DM
817 if let Some(size) = chunk_size_opt {
818 verify_chunk_size(size)?;
2d9d143a
DM
819 }
820
11377a47 821 let keyfile = param["keyfile"].as_str().map(PathBuf::from);
6d0983db 822
f69adc81 823 let backup_id = param["backup-id"].as_str().unwrap_or(&proxmox::tools::nodename());
fba30411 824
bbf9e7e9 825 let backup_type = param["backup-type"].as_str().unwrap_or("host");
ca5d0b61 826
2eeaacb9
DM
827 let include_dev = param["include-dev"].as_array();
828
6fc053ed
CE
829 let entries_max = param["entries-max"].as_u64().unwrap_or(pxar::ENCODER_MAX_ENTRIES as u64);
830
2eeaacb9
DM
831 let mut devices = if all_file_systems { None } else { Some(HashSet::new()) };
832
833 if let Some(include_dev) = include_dev {
834 if all_file_systems {
835 bail!("option 'all-file-systems' conflicts with option 'include-dev'");
836 }
837
838 let mut set = HashSet::new();
839 for path in include_dev {
840 let path = path.as_str().unwrap();
841 let stat = nix::sys::stat::stat(path)
842 .map_err(|err| format_err!("fstat {:?} failed - {}", path, err))?;
843 set.insert(stat.st_dev);
844 }
845 devices = Some(set);
846 }
847
ae0be2dd 848 let mut upload_list = vec![];
a914a774 849
79679c2d 850 enum BackupType { PXAR, IMAGE, CONFIG, LOGFILE };
6af905c1 851
bf6e3217
DM
852 let mut upload_catalog = false;
853
ae0be2dd
DM
854 for backupspec in backupspec_list {
855 let (target, filename) = parse_backupspec(backupspec.as_str().unwrap())?;
bcd879cf 856
eb1804c5
DM
857 use std::os::unix::fs::FileTypeExt;
858
3fa71727
CE
859 let metadata = std::fs::metadata(filename)
860 .map_err(|err| format_err!("unable to access '{}' - {}", filename, err))?;
eb1804c5 861 let file_type = metadata.file_type();
23bb8780 862
4af0ee05 863 let extension = target.rsplit('.').next()
11377a47 864 .ok_or_else(|| format_err!("missing target file extenion '{}'", target))?;
bcd879cf 865
ec8a9bb9
DM
866 match extension {
867 "pxar" => {
868 if !file_type.is_dir() {
869 bail!("got unexpected file type (expected directory)");
870 }
4af0ee05 871 upload_list.push((BackupType::PXAR, filename.to_owned(), format!("{}.didx", target), 0));
bf6e3217 872 upload_catalog = true;
ec8a9bb9
DM
873 }
874 "img" => {
eb1804c5 875
ec8a9bb9
DM
876 if !(file_type.is_file() || file_type.is_block_device()) {
877 bail!("got unexpected file type (expected file or block device)");
878 }
eb1804c5 879
e18a6c9e 880 let size = image_size(&PathBuf::from(filename))?;
23bb8780 881
ec8a9bb9 882 if size == 0 { bail!("got zero-sized file '{}'", filename); }
ae0be2dd 883
4af0ee05 884 upload_list.push((BackupType::IMAGE, filename.to_owned(), format!("{}.fidx", target), size));
ec8a9bb9
DM
885 }
886 "conf" => {
887 if !file_type.is_file() {
888 bail!("got unexpected file type (expected regular file)");
889 }
4af0ee05 890 upload_list.push((BackupType::CONFIG, filename.to_owned(), format!("{}.blob", target), metadata.len()));
ec8a9bb9 891 }
79679c2d
DM
892 "log" => {
893 if !file_type.is_file() {
894 bail!("got unexpected file type (expected regular file)");
895 }
4af0ee05 896 upload_list.push((BackupType::LOGFILE, filename.to_owned(), format!("{}.blob", target), metadata.len()));
79679c2d 897 }
ec8a9bb9
DM
898 _ => {
899 bail!("got unknown archive extension '{}'", extension);
900 }
ae0be2dd
DM
901 }
902 }
903
11377a47 904 let backup_time = Utc.timestamp(backup_time_opt.unwrap_or_else(|| Utc::now().timestamp()), 0);
ae0be2dd 905
cc2ce4a9 906 let client = HttpClient::new(repo.host(), repo.user(), None)?;
d0a03d40
DM
907 record_repository(&repo);
908
ca5d0b61
DM
909 println!("Starting backup: {}/{}/{}", backup_type, backup_id, BackupDir::backup_time_to_string(backup_time));
910
f69adc81 911 println!("Client name: {}", proxmox::tools::nodename());
ca5d0b61
DM
912
913 let start_time = Local::now();
914
7a6cfbd9 915 println!("Starting protocol: {}", start_time.to_rfc3339_opts(chrono::SecondsFormat::Secs, false));
51144821 916
bb823140
DM
917 let (crypt_config, rsa_encrypted_key) = match keyfile {
918 None => (None, None),
6d0983db 919 Some(path) => {
6d20a29d 920 let (key, created) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
bb823140
DM
921
922 let crypt_config = CryptConfig::new(key)?;
923
924 let path = master_pubkey_path()?;
925 if path.exists() {
e18a6c9e 926 let pem_data = file_get_contents(&path)?;
bb823140
DM
927 let rsa = openssl::rsa::Rsa::public_key_from_pem(&pem_data)?;
928 let enc_key = crypt_config.generate_rsa_encoded_key(rsa, created)?;
929 (Some(Arc::new(crypt_config)), Some(enc_key))
930 } else {
931 (Some(Arc::new(crypt_config)), None)
932 }
6d0983db
DM
933 }
934 };
f98ac774 935
8a8a4703
DM
936 let client = BackupWriter::start(
937 client,
938 repo.store(),
939 backup_type,
940 &backup_id,
941 backup_time,
942 verbose,
943 ).await?;
944
945 let snapshot = BackupDir::new(backup_type, backup_id, backup_time.timestamp());
946 let mut manifest = BackupManifest::new(snapshot);
947
948 let (catalog, catalog_result_rx) = spawn_catalog_upload(client.clone(), crypt_config.clone())?;
949
950 for (backup_type, filename, target, size) in upload_list {
951 match backup_type {
952 BackupType::CONFIG => {
953 println!("Upload config file '{}' to '{:?}' as {}", filename, repo, target);
954 let stats = client
955 .upload_blob_from_file(&filename, &target, crypt_config.clone(), true)
956 .await?;
1e8da0a7 957 manifest.add_file(target, stats.size, stats.csum)?;
8a8a4703
DM
958 }
959 BackupType::LOGFILE => { // fixme: remove - not needed anymore ?
960 println!("Upload log file '{}' to '{:?}' as {}", filename, repo, target);
961 let stats = client
962 .upload_blob_from_file(&filename, &target, crypt_config.clone(), true)
963 .await?;
1e8da0a7 964 manifest.add_file(target, stats.size, stats.csum)?;
8a8a4703
DM
965 }
966 BackupType::PXAR => {
967 println!("Upload directory '{}' to '{:?}' as {}", filename, repo, target);
968 catalog.lock().unwrap().start_directory(std::ffi::CString::new(target.as_str())?.as_c_str())?;
969 let stats = backup_directory(
970 &client,
971 &filename,
972 &target,
973 chunk_size_opt,
974 devices.clone(),
975 verbose,
976 skip_lost_and_found,
977 crypt_config.clone(),
978 catalog.clone(),
6fc053ed 979 entries_max as usize,
8a8a4703 980 ).await?;
1e8da0a7 981 manifest.add_file(target, stats.size, stats.csum)?;
8a8a4703
DM
982 catalog.lock().unwrap().end_directory()?;
983 }
984 BackupType::IMAGE => {
985 println!("Upload image '{}' to '{:?}' as {}", filename, repo, target);
986 let stats = backup_image(
987 &client,
988 &filename,
989 &target,
990 size,
991 chunk_size_opt,
992 verbose,
993 crypt_config.clone(),
994 ).await?;
1e8da0a7 995 manifest.add_file(target, stats.size, stats.csum)?;
6af905c1
DM
996 }
997 }
8a8a4703 998 }
4818c8b6 999
8a8a4703
DM
1000 // finalize and upload catalog
1001 if upload_catalog {
1002 let mutex = Arc::try_unwrap(catalog)
1003 .map_err(|_| format_err!("unable to get catalog (still used)"))?;
1004 let mut catalog = mutex.into_inner().unwrap();
bf6e3217 1005
8a8a4703 1006 catalog.finish()?;
2761d6a4 1007
8a8a4703 1008 drop(catalog); // close upload stream
2761d6a4 1009
8a8a4703 1010 let stats = catalog_result_rx.await??;
9d135fe6 1011
1e8da0a7 1012 manifest.add_file(CATALOG_NAME.to_owned(), stats.size, stats.csum)?;
8a8a4703 1013 }
2761d6a4 1014
8a8a4703
DM
1015 if let Some(rsa_encrypted_key) = rsa_encrypted_key {
1016 let target = "rsa-encrypted.key";
1017 println!("Upload RSA encoded key to '{:?}' as {}", repo, target);
1018 let stats = client
1019 .upload_blob_from_data(rsa_encrypted_key, target, None, false, false)
1020 .await?;
1e8da0a7 1021 manifest.add_file(format!("{}.blob", target), stats.size, stats.csum)?;
8a8a4703
DM
1022
1023 // openssl rsautl -decrypt -inkey master-private.pem -in rsa-encrypted.key -out t
1024 /*
1025 let mut buffer2 = vec![0u8; rsa.size() as usize];
1026 let pem_data = file_get_contents("master-private.pem")?;
1027 let rsa = openssl::rsa::Rsa::private_key_from_pem(&pem_data)?;
1028 let len = rsa.private_decrypt(&buffer, &mut buffer2, openssl::rsa::Padding::PKCS1)?;
1029 println!("TEST {} {:?}", len, buffer2);
1030 */
1031 }
9f46c7de 1032
8a8a4703
DM
1033 // create manifest (index.json)
1034 let manifest = manifest.into_json();
2c3891d1 1035
8a8a4703
DM
1036 println!("Upload index.json to '{:?}'", repo);
1037 let manifest = serde_json::to_string_pretty(&manifest)?.into();
1038 client
1039 .upload_blob_from_data(manifest, MANIFEST_BLOB_NAME, crypt_config.clone(), true, true)
1040 .await?;
2c3891d1 1041
8a8a4703 1042 client.finish().await?;
c4ff3dce 1043
8a8a4703
DM
1044 let end_time = Local::now();
1045 let elapsed = end_time.signed_duration_since(start_time);
1046 println!("Duration: {}", elapsed);
3ec3ec3f 1047
8a8a4703 1048 println!("End Time: {}", end_time.to_rfc3339_opts(chrono::SecondsFormat::Secs, false));
3d5c11e5 1049
8a8a4703 1050 Ok(Value::Null)
f98ea63d
DM
1051}
1052
d0a03d40 1053fn complete_backup_source(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
f98ea63d
DM
1054
1055 let mut result = vec![];
1056
1057 let data: Vec<&str> = arg.splitn(2, ':').collect();
1058
bff11030 1059 if data.len() != 2 {
8968258b
DM
1060 result.push(String::from("root.pxar:/"));
1061 result.push(String::from("etc.pxar:/etc"));
bff11030
DM
1062 return result;
1063 }
f98ea63d 1064
496a6784 1065 let files = tools::complete_file_name(data[1], param);
f98ea63d
DM
1066
1067 for file in files {
1068 result.push(format!("{}:{}", data[0], file));
1069 }
1070
1071 result
ff5d3707 1072}
1073
88892ea8
DM
1074fn dump_image<W: Write>(
1075 client: Arc<BackupReader>,
1076 crypt_config: Option<Arc<CryptConfig>>,
1077 index: FixedIndexReader,
1078 mut writer: W,
fd04ca7a 1079 verbose: bool,
88892ea8
DM
1080) -> Result<(), Error> {
1081
1082 let most_used = index.find_most_used_chunks(8);
1083
1084 let mut chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config, most_used);
1085
1086 // Note: we avoid using BufferedFixedReader, because that add an additional buffer/copy
1087 // and thus slows down reading. Instead, directly use RemoteChunkReader
fd04ca7a
DM
1088 let mut per = 0;
1089 let mut bytes = 0;
1090 let start_time = std::time::Instant::now();
1091
88892ea8
DM
1092 for pos in 0..index.index_count() {
1093 let digest = index.index_digest(pos).unwrap();
1094 let raw_data = chunk_reader.read_chunk(&digest)?;
1095 writer.write_all(&raw_data)?;
fd04ca7a
DM
1096 bytes += raw_data.len();
1097 if verbose {
1098 let next_per = ((pos+1)*100)/index.index_count();
1099 if per != next_per {
1100 eprintln!("progress {}% (read {} bytes, duration {} sec)",
1101 next_per, bytes, start_time.elapsed().as_secs());
1102 per = next_per;
1103 }
1104 }
88892ea8
DM
1105 }
1106
fd04ca7a
DM
1107 let end_time = std::time::Instant::now();
1108 let elapsed = end_time.duration_since(start_time);
1109 eprintln!("restore image complete (bytes={}, duration={:.2}s, speed={:.2}MB/s)",
1110 bytes,
1111 elapsed.as_secs_f64(),
1112 bytes as f64/(1024.0*1024.0*elapsed.as_secs_f64())
1113 );
1114
1115
88892ea8
DM
1116 Ok(())
1117}
1118
a47a02ae
DM
1119#[api(
1120 input: {
1121 properties: {
1122 repository: {
1123 schema: REPO_URL_SCHEMA,
1124 optional: true,
1125 },
1126 snapshot: {
1127 type: String,
1128 description: "Group/Snapshot path.",
1129 },
1130 "archive-name": {
1131 description: "Backup archive name.",
1132 type: String,
1133 },
1134 target: {
1135 type: String,
1136 description: r###"Target directory path. Use '-' to write to stdandard output.
8a8a4703 1137
5eee6d89 1138We do not extraxt '.pxar' archives when writing to standard output.
8a8a4703 1139
a47a02ae
DM
1140"###
1141 },
1142 "allow-existing-dirs": {
1143 type: Boolean,
1144 description: "Do not fail if directories already exists.",
1145 optional: true,
1146 },
1147 keyfile: {
1148 schema: KEYFILE_SCHEMA,
1149 optional: true,
1150 },
1151 }
1152 }
1153)]
1154/// Restore backup repository.
1155async fn restore(param: Value) -> Result<Value, Error> {
2665cef7 1156 let repo = extract_repository_from_value(&param)?;
9f912493 1157
86eda3eb
DM
1158 let verbose = param["verbose"].as_bool().unwrap_or(false);
1159
46d5aa0a
DM
1160 let allow_existing_dirs = param["allow-existing-dirs"].as_bool().unwrap_or(false);
1161
d5c34d98
DM
1162 let archive_name = tools::required_string_param(&param, "archive-name")?;
1163
cc2ce4a9 1164 let client = HttpClient::new(repo.host(), repo.user(), None)?;
d0a03d40 1165
d0a03d40 1166 record_repository(&repo);
d5c34d98 1167
9f912493 1168 let path = tools::required_string_param(&param, "snapshot")?;
9f912493 1169
86eda3eb 1170 let (backup_type, backup_id, backup_time) = if path.matches('/').count() == 1 {
d5c34d98 1171 let group = BackupGroup::parse(path)?;
27c9affb 1172 api_datastore_latest_snapshot(&client, repo.store(), group).await?
d5c34d98
DM
1173 } else {
1174 let snapshot = BackupDir::parse(path)?;
86eda3eb
DM
1175 (snapshot.group().backup_type().to_owned(), snapshot.group().backup_id().to_owned(), snapshot.backup_time())
1176 };
9f912493 1177
d5c34d98 1178 let target = tools::required_string_param(&param, "target")?;
bf125261 1179 let target = if target == "-" { None } else { Some(target) };
2ae7d196 1180
11377a47 1181 let keyfile = param["keyfile"].as_str().map(PathBuf::from);
2ae7d196 1182
86eda3eb
DM
1183 let crypt_config = match keyfile {
1184 None => None,
1185 Some(path) => {
6d20a29d 1186 let (key, _) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
86eda3eb
DM
1187 Some(Arc::new(CryptConfig::new(key)?))
1188 }
1189 };
d5c34d98 1190
afb4cd28
DM
1191 let server_archive_name = if archive_name.ends_with(".pxar") {
1192 format!("{}.didx", archive_name)
1193 } else if archive_name.ends_with(".img") {
1194 format!("{}.fidx", archive_name)
1195 } else {
f8100e96 1196 format!("{}.blob", archive_name)
afb4cd28 1197 };
9f912493 1198
296c50ba
DM
1199 let client = BackupReader::start(
1200 client,
1201 crypt_config.clone(),
1202 repo.store(),
1203 &backup_type,
1204 &backup_id,
1205 backup_time,
1206 true,
1207 ).await?;
86eda3eb 1208
f06b820a 1209 let manifest = client.download_manifest().await?;
02fcf372 1210
ad6e5a6f 1211 if server_archive_name == MANIFEST_BLOB_NAME {
f06b820a 1212 let backup_index_data = manifest.into_json().to_string();
02fcf372 1213 if let Some(target) = target {
feaa1ad3 1214 replace_file(target, backup_index_data.as_bytes(), CreateOptions::new())?;
02fcf372
DM
1215 } else {
1216 let stdout = std::io::stdout();
1217 let mut writer = stdout.lock();
296c50ba 1218 writer.write_all(backup_index_data.as_bytes())
02fcf372
DM
1219 .map_err(|err| format_err!("unable to pipe data - {}", err))?;
1220 }
1221
1222 } else if server_archive_name.ends_with(".blob") {
d2267b11 1223
bb19af73 1224 let mut reader = client.download_blob(&manifest, &server_archive_name).await?;
f8100e96 1225
bf125261 1226 if let Some(target) = target {
0d986280
DM
1227 let mut writer = std::fs::OpenOptions::new()
1228 .write(true)
1229 .create(true)
1230 .create_new(true)
1231 .open(target)
1232 .map_err(|err| format_err!("unable to create target file {:?} - {}", target, err))?;
1233 std::io::copy(&mut reader, &mut writer)?;
bf125261
DM
1234 } else {
1235 let stdout = std::io::stdout();
1236 let mut writer = stdout.lock();
0d986280 1237 std::io::copy(&mut reader, &mut writer)
bf125261
DM
1238 .map_err(|err| format_err!("unable to pipe data - {}", err))?;
1239 }
f8100e96
DM
1240
1241 } else if server_archive_name.ends_with(".didx") {
86eda3eb 1242
c3d84a22 1243 let index = client.download_dynamic_index(&manifest, &server_archive_name).await?;
df65bd3d 1244
f4bf7dfc
DM
1245 let most_used = index.find_most_used_chunks(8);
1246
1247 let chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config, most_used);
1248
afb4cd28 1249 let mut reader = BufferedDynamicReader::new(index, chunk_reader);
86eda3eb 1250
bf125261 1251 if let Some(target) = target {
86eda3eb 1252
47651f95 1253 let feature_flags = pxar::flags::DEFAULT;
f701d033
DM
1254 let mut decoder = pxar::SequentialDecoder::new(&mut reader, feature_flags);
1255 decoder.set_callback(move |path| {
bf125261 1256 if verbose {
fd04ca7a 1257 eprintln!("{:?}", path);
bf125261
DM
1258 }
1259 Ok(())
1260 });
6a879109
CE
1261 decoder.set_allow_existing_dirs(allow_existing_dirs);
1262
fa7e957c 1263 decoder.restore(Path::new(target), &Vec::new())?;
bf125261 1264 } else {
88892ea8
DM
1265 let mut writer = std::fs::OpenOptions::new()
1266 .write(true)
1267 .open("/dev/stdout")
1268 .map_err(|err| format_err!("unable to open /dev/stdout - {}", err))?;
afb4cd28 1269
bf125261
DM
1270 std::io::copy(&mut reader, &mut writer)
1271 .map_err(|err| format_err!("unable to pipe data - {}", err))?;
1272 }
afb4cd28 1273 } else if server_archive_name.ends_with(".fidx") {
afb4cd28 1274
72050500 1275 let index = client.download_fixed_index(&manifest, &server_archive_name).await?;
df65bd3d 1276
88892ea8
DM
1277 let mut writer = if let Some(target) = target {
1278 std::fs::OpenOptions::new()
bf125261
DM
1279 .write(true)
1280 .create(true)
1281 .create_new(true)
1282 .open(target)
88892ea8 1283 .map_err(|err| format_err!("unable to create target file {:?} - {}", target, err))?
bf125261 1284 } else {
88892ea8
DM
1285 std::fs::OpenOptions::new()
1286 .write(true)
1287 .open("/dev/stdout")
1288 .map_err(|err| format_err!("unable to open /dev/stdout - {}", err))?
1289 };
afb4cd28 1290
fd04ca7a 1291 dump_image(client.clone(), crypt_config.clone(), index, &mut writer, verbose)?;
88892ea8
DM
1292
1293 } else {
f8100e96 1294 bail!("unknown archive file extension (expected .pxar of .img)");
3031e44c 1295 }
fef44d4f
DM
1296
1297 Ok(Value::Null)
45db6f89
DM
1298}
1299
a47a02ae
DM
1300#[api(
1301 input: {
1302 properties: {
1303 repository: {
1304 schema: REPO_URL_SCHEMA,
1305 optional: true,
1306 },
1307 snapshot: {
1308 type: String,
1309 description: "Group/Snapshot path.",
1310 },
1311 logfile: {
1312 type: String,
1313 description: "The path to the log file you want to upload.",
1314 },
1315 keyfile: {
1316 schema: KEYFILE_SCHEMA,
1317 optional: true,
1318 },
1319 }
1320 }
1321)]
1322/// Upload backup log file.
1323async fn upload_log(param: Value) -> Result<Value, Error> {
ec34f7eb
DM
1324
1325 let logfile = tools::required_string_param(&param, "logfile")?;
1326 let repo = extract_repository_from_value(&param)?;
1327
1328 let snapshot = tools::required_string_param(&param, "snapshot")?;
1329 let snapshot = BackupDir::parse(snapshot)?;
1330
cc2ce4a9 1331 let mut client = HttpClient::new(repo.host(), repo.user(), None)?;
ec34f7eb 1332
11377a47 1333 let keyfile = param["keyfile"].as_str().map(PathBuf::from);
ec34f7eb
DM
1334
1335 let crypt_config = match keyfile {
1336 None => None,
1337 Some(path) => {
6d20a29d 1338 let (key, _created) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
ec34f7eb 1339 let crypt_config = CryptConfig::new(key)?;
9025312a 1340 Some(Arc::new(crypt_config))
ec34f7eb
DM
1341 }
1342 };
1343
e18a6c9e 1344 let data = file_get_contents(logfile)?;
ec34f7eb 1345
7123ff7d 1346 let blob = DataBlob::encode(&data, crypt_config.as_ref().map(Arc::as_ref), true)?;
ec34f7eb
DM
1347
1348 let raw_data = blob.into_inner();
1349
1350 let path = format!("api2/json/admin/datastore/{}/upload-backup-log", repo.store());
1351
1352 let args = json!({
1353 "backup-type": snapshot.group().backup_type(),
1354 "backup-id": snapshot.group().backup_id(),
1355 "backup-time": snapshot.backup_time().timestamp(),
1356 });
1357
1358 let body = hyper::Body::from(raw_data);
1359
8a8a4703 1360 client.upload("application/octet-stream", body, &path, Some(args)).await
ec34f7eb
DM
1361}
1362
a47a02ae
DM
1363#[api(
1364 input: {
1365 properties: {
1366 repository: {
1367 schema: REPO_URL_SCHEMA,
1368 optional: true,
1369 },
1370 group: {
1371 type: String,
1372 description: "Backup group.",
1373 },
1374 "output-format": {
1375 schema: OUTPUT_FORMAT,
1376 optional: true,
1377 },
1378 "dry-run": {
1379 type: Boolean,
1380 description: "Just show what prune would do, but do not delete anything.",
1381 optional: true,
1382 },
1383 }
1384 }
1385)]
1386/// Prune a backup repository.
1387async fn prune(mut param: Value) -> Result<Value, Error> {
83b7db02 1388
2665cef7 1389 let repo = extract_repository_from_value(&param)?;
83b7db02 1390
cc2ce4a9 1391 let mut client = HttpClient::new(repo.host(), repo.user(), None)?;
83b7db02 1392
d0a03d40 1393 let path = format!("api2/json/admin/datastore/{}/prune", repo.store());
83b7db02 1394
9fdc3ef4
DM
1395 let group = tools::required_string_param(&param, "group")?;
1396 let group = BackupGroup::parse(group)?;
163e9bbe 1397 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
9fdc3ef4 1398
ea7a7ef2
DM
1399 param.as_object_mut().unwrap().remove("repository");
1400 param.as_object_mut().unwrap().remove("group");
163e9bbe 1401 param.as_object_mut().unwrap().remove("output-format");
ea7a7ef2
DM
1402
1403 param["backup-type"] = group.backup_type().into();
1404 param["backup-id"] = group.backup_id().into();
83b7db02 1405
87c42375 1406 let result = client.post(&path, Some(param)).await?;
74fa81b8 1407
87c42375 1408 record_repository(&repo);
3b03abfe 1409
87c42375 1410 view_task_result(client, result, &output_format).await?;
d0a03d40 1411
43a406fd 1412 Ok(Value::Null)
83b7db02
DM
1413}
1414
a47a02ae
DM
1415#[api(
1416 input: {
1417 properties: {
1418 repository: {
1419 schema: REPO_URL_SCHEMA,
1420 optional: true,
1421 },
1422 "output-format": {
1423 schema: OUTPUT_FORMAT,
1424 optional: true,
1425 },
1426 }
1427 }
1428)]
1429/// Get repository status.
1430async fn status(param: Value) -> Result<Value, Error> {
34a816cc
DM
1431
1432 let repo = extract_repository_from_value(&param)?;
1433
1434 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
1435
cc2ce4a9 1436 let client = HttpClient::new(repo.host(), repo.user(), None)?;
34a816cc
DM
1437
1438 let path = format!("api2/json/admin/datastore/{}/status", repo.store());
1439
1dc117bb 1440 let mut result = client.get(&path, None).await?;
34a816cc
DM
1441
1442 record_repository(&repo);
1443
1444 if output_format == "text" {
1dc117bb
DM
1445 let result: StorageStatus = serde_json::from_value(result["data"].take())?;
1446
1447 let roundup = result.total/200;
34a816cc
DM
1448
1449 println!(
1450 "total: {} used: {} ({} %) available: {}",
1dc117bb
DM
1451 result.total,
1452 result.used,
1453 ((result.used+roundup)*100)/result.total,
1454 result.avail,
34a816cc
DM
1455 );
1456 } else {
1dc117bb 1457 format_and_print_result(&result["data"], &output_format);
34a816cc
DM
1458 }
1459
1460 Ok(Value::Null)
1461}
1462
5a2df000 1463// like get, but simply ignore errors and return Null instead
e9722f8b 1464async fn try_get(repo: &BackupRepository, url: &str) -> Value {
024f11bb 1465
cc2ce4a9 1466 let client = match HttpClient::new(repo.host(), repo.user(), None) {
45cdce06
DM
1467 Ok(v) => v,
1468 _ => return Value::Null,
1469 };
b2388518 1470
e9722f8b 1471 let mut resp = match client.get(url, None).await {
b2388518
DM
1472 Ok(v) => v,
1473 _ => return Value::Null,
1474 };
1475
1476 if let Some(map) = resp.as_object_mut() {
1477 if let Some(data) = map.remove("data") {
1478 return data;
1479 }
1480 }
1481 Value::Null
1482}
1483
b2388518 1484fn complete_backup_group(_arg: &str, param: &HashMap<String, String>) -> Vec<String> {
3f06d6fb 1485 proxmox_backup::tools::runtime::main(async { complete_backup_group_do(param).await })
e9722f8b
WB
1486}
1487
1488async fn complete_backup_group_do(param: &HashMap<String, String>) -> Vec<String> {
024f11bb 1489
b2388518
DM
1490 let mut result = vec![];
1491
2665cef7 1492 let repo = match extract_repository_from_map(param) {
b2388518 1493 Some(v) => v,
024f11bb
DM
1494 _ => return result,
1495 };
1496
b2388518
DM
1497 let path = format!("api2/json/admin/datastore/{}/groups", repo.store());
1498
e9722f8b 1499 let data = try_get(&repo, &path).await;
b2388518
DM
1500
1501 if let Some(list) = data.as_array() {
024f11bb 1502 for item in list {
98f0b972
DM
1503 if let (Some(backup_id), Some(backup_type)) =
1504 (item["backup-id"].as_str(), item["backup-type"].as_str())
1505 {
1506 result.push(format!("{}/{}", backup_type, backup_id));
024f11bb
DM
1507 }
1508 }
1509 }
1510
1511 result
1512}
1513
b2388518 1514fn complete_group_or_snapshot(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
3f06d6fb 1515 proxmox_backup::tools::runtime::main(async { complete_group_or_snapshot_do(arg, param).await })
e9722f8b
WB
1516}
1517
1518async fn complete_group_or_snapshot_do(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
b2388518 1519
b2388518 1520 if arg.matches('/').count() < 2 {
e9722f8b 1521 let groups = complete_backup_group_do(param).await;
543a260f 1522 let mut result = vec![];
b2388518
DM
1523 for group in groups {
1524 result.push(group.to_string());
1525 result.push(format!("{}/", group));
1526 }
1527 return result;
1528 }
1529
e9722f8b 1530 complete_backup_snapshot_do(param).await
543a260f 1531}
b2388518 1532
3fb53e07 1533fn complete_backup_snapshot(_arg: &str, param: &HashMap<String, String>) -> Vec<String> {
3f06d6fb 1534 proxmox_backup::tools::runtime::main(async { complete_backup_snapshot_do(param).await })
e9722f8b
WB
1535}
1536
1537async fn complete_backup_snapshot_do(param: &HashMap<String, String>) -> Vec<String> {
543a260f
DM
1538
1539 let mut result = vec![];
1540
1541 let repo = match extract_repository_from_map(param) {
1542 Some(v) => v,
1543 _ => return result,
1544 };
1545
1546 let path = format!("api2/json/admin/datastore/{}/snapshots", repo.store());
b2388518 1547
e9722f8b 1548 let data = try_get(&repo, &path).await;
b2388518
DM
1549
1550 if let Some(list) = data.as_array() {
1551 for item in list {
1552 if let (Some(backup_id), Some(backup_type), Some(backup_time)) =
1553 (item["backup-id"].as_str(), item["backup-type"].as_str(), item["backup-time"].as_i64())
1554 {
1555 let snapshot = BackupDir::new(backup_type, backup_id, backup_time);
1556 result.push(snapshot.relative_path().to_str().unwrap().to_owned());
1557 }
1558 }
1559 }
1560
1561 result
1562}
1563
45db6f89 1564fn complete_server_file_name(_arg: &str, param: &HashMap<String, String>) -> Vec<String> {
3f06d6fb 1565 proxmox_backup::tools::runtime::main(async { complete_server_file_name_do(param).await })
e9722f8b
WB
1566}
1567
1568async fn complete_server_file_name_do(param: &HashMap<String, String>) -> Vec<String> {
08dc340a
DM
1569
1570 let mut result = vec![];
1571
2665cef7 1572 let repo = match extract_repository_from_map(param) {
08dc340a
DM
1573 Some(v) => v,
1574 _ => return result,
1575 };
1576
1577 let snapshot = match param.get("snapshot") {
1578 Some(path) => {
1579 match BackupDir::parse(path) {
1580 Ok(v) => v,
1581 _ => return result,
1582 }
1583 }
1584 _ => return result,
1585 };
1586
1587 let query = tools::json_object_to_query(json!({
1588 "backup-type": snapshot.group().backup_type(),
1589 "backup-id": snapshot.group().backup_id(),
1590 "backup-time": snapshot.backup_time().timestamp(),
1591 })).unwrap();
1592
1593 let path = format!("api2/json/admin/datastore/{}/files?{}", repo.store(), query);
1594
e9722f8b 1595 let data = try_get(&repo, &path).await;
08dc340a
DM
1596
1597 if let Some(list) = data.as_array() {
1598 for item in list {
c4f025eb 1599 if let Some(filename) = item["filename"].as_str() {
08dc340a
DM
1600 result.push(filename.to_owned());
1601 }
1602 }
1603 }
1604
45db6f89
DM
1605 result
1606}
1607
1608fn complete_archive_name(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
52c171e4 1609 complete_server_file_name(arg, param)
e9722f8b
WB
1610 .iter()
1611 .map(|v| strip_server_file_expenstion(&v))
1612 .collect()
08dc340a
DM
1613}
1614
0ec9e1b0
DM
1615fn complete_pxar_archive_name(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
1616 complete_server_file_name(arg, param)
1617 .iter()
1618 .filter_map(|v| {
1619 let name = strip_server_file_expenstion(&v);
1620 if name.ends_with(".pxar") {
1621 Some(name)
1622 } else {
1623 None
1624 }
1625 })
1626 .collect()
1627}
1628
49811347
DM
1629fn complete_chunk_size(_arg: &str, _param: &HashMap<String, String>) -> Vec<String> {
1630
1631 let mut result = vec![];
1632
1633 let mut size = 64;
1634 loop {
1635 result.push(size.to_string());
11377a47 1636 size *= 2;
49811347
DM
1637 if size > 4096 { break; }
1638 }
1639
1640 result
1641}
1642
826f309b 1643fn get_encryption_key_password() -> Result<Vec<u8>, Error> {
ff5d3707 1644
f2401311
DM
1645 // fixme: implement other input methods
1646
1647 use std::env::VarError::*;
1648 match std::env::var("PBS_ENCRYPTION_PASSWORD") {
826f309b 1649 Ok(p) => return Ok(p.as_bytes().to_vec()),
f2401311
DM
1650 Err(NotUnicode(_)) => bail!("PBS_ENCRYPTION_PASSWORD contains bad characters"),
1651 Err(NotPresent) => {
1652 // Try another method
1653 }
1654 }
1655
1656 // If we're on a TTY, query the user for a password
1657 if crate::tools::tty::stdin_isatty() {
826f309b 1658 return Ok(crate::tools::tty::read_password("Encryption Key Password: ")?);
f2401311
DM
1659 }
1660
1661 bail!("no password input mechanism available");
1662}
1663
ac716234
DM
1664fn key_create(
1665 param: Value,
1666 _info: &ApiMethod,
1667 _rpcenv: &mut dyn RpcEnvironment,
1668) -> Result<Value, Error> {
1669
9b06db45
DM
1670 let path = tools::required_string_param(&param, "path")?;
1671 let path = PathBuf::from(path);
ac716234 1672
181f097a 1673 let kdf = param["kdf"].as_str().unwrap_or("scrypt");
ac716234
DM
1674
1675 let key = proxmox::sys::linux::random_data(32)?;
1676
181f097a
DM
1677 if kdf == "scrypt" {
1678 // always read passphrase from tty
1679 if !crate::tools::tty::stdin_isatty() {
1680 bail!("unable to read passphrase - no tty");
1681 }
ac716234 1682
cbe01dc5 1683 let password = crate::tools::tty::read_and_verify_password("Encryption Key Password: ")?;
181f097a 1684
ab44acff 1685 let key_config = encrypt_key_with_passphrase(&key, &password)?;
37c5a175 1686
ab44acff 1687 store_key_config(&path, false, key_config)?;
181f097a
DM
1688
1689 Ok(Value::Null)
1690 } else if kdf == "none" {
1691 let created = Local.timestamp(Local::now().timestamp(), 0);
1692
1693 store_key_config(&path, false, KeyConfig {
1694 kdf: None,
1695 created,
ab44acff 1696 modified: created,
181f097a
DM
1697 data: key,
1698 })?;
1699
1700 Ok(Value::Null)
1701 } else {
1702 unreachable!();
1703 }
ac716234
DM
1704}
1705
9f46c7de
DM
1706fn master_pubkey_path() -> Result<PathBuf, Error> {
1707 let base = BaseDirectories::with_prefix("proxmox-backup")?;
1708
1709 // usually $HOME/.config/proxmox-backup/master-public.pem
1710 let path = base.place_config_file("master-public.pem")?;
1711
1712 Ok(path)
1713}
1714
3ea8bfc9
DM
1715fn key_import_master_pubkey(
1716 param: Value,
1717 _info: &ApiMethod,
1718 _rpcenv: &mut dyn RpcEnvironment,
1719) -> Result<Value, Error> {
1720
1721 let path = tools::required_string_param(&param, "path")?;
1722 let path = PathBuf::from(path);
1723
e18a6c9e 1724 let pem_data = file_get_contents(&path)?;
3ea8bfc9
DM
1725
1726 if let Err(err) = openssl::pkey::PKey::public_key_from_pem(&pem_data) {
1727 bail!("Unable to decode PEM data - {}", err);
1728 }
1729
9f46c7de 1730 let target_path = master_pubkey_path()?;
3ea8bfc9 1731
feaa1ad3 1732 replace_file(&target_path, &pem_data, CreateOptions::new())?;
3ea8bfc9
DM
1733
1734 println!("Imported public master key to {:?}", target_path);
1735
1736 Ok(Value::Null)
1737}
1738
37c5a175
DM
1739fn key_create_master_key(
1740 _param: Value,
1741 _info: &ApiMethod,
1742 _rpcenv: &mut dyn RpcEnvironment,
1743) -> Result<Value, Error> {
1744
1745 // we need a TTY to query the new password
1746 if !crate::tools::tty::stdin_isatty() {
1747 bail!("unable to create master key - no tty");
1748 }
1749
1750 let rsa = openssl::rsa::Rsa::generate(4096)?;
1751 let pkey = openssl::pkey::PKey::from_rsa(rsa)?;
1752
37c5a175 1753
cbe01dc5 1754 let password = String::from_utf8(crate::tools::tty::read_and_verify_password("Master Key Password: ")?)?;
37c5a175
DM
1755
1756 let pub_key: Vec<u8> = pkey.public_key_to_pem()?;
1757 let filename_pub = "master-public.pem";
1758 println!("Writing public master key to {}", filename_pub);
feaa1ad3 1759 replace_file(filename_pub, pub_key.as_slice(), CreateOptions::new())?;
37c5a175
DM
1760
1761 let cipher = openssl::symm::Cipher::aes_256_cbc();
cbe01dc5 1762 let priv_key: Vec<u8> = pkey.private_key_to_pem_pkcs8_passphrase(cipher, password.as_bytes())?;
37c5a175
DM
1763
1764 let filename_priv = "master-private.pem";
1765 println!("Writing private master key to {}", filename_priv);
feaa1ad3 1766 replace_file(filename_priv, priv_key.as_slice(), CreateOptions::new())?;
37c5a175
DM
1767
1768 Ok(Value::Null)
1769}
ac716234
DM
1770
1771fn key_change_passphrase(
1772 param: Value,
1773 _info: &ApiMethod,
1774 _rpcenv: &mut dyn RpcEnvironment,
1775) -> Result<Value, Error> {
1776
9b06db45
DM
1777 let path = tools::required_string_param(&param, "path")?;
1778 let path = PathBuf::from(path);
ac716234 1779
181f097a
DM
1780 let kdf = param["kdf"].as_str().unwrap_or("scrypt");
1781
ac716234
DM
1782 // we need a TTY to query the new password
1783 if !crate::tools::tty::stdin_isatty() {
1784 bail!("unable to change passphrase - no tty");
1785 }
1786
6d20a29d 1787 let (key, created) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
ac716234 1788
181f097a 1789 if kdf == "scrypt" {
ac716234 1790
cbe01dc5 1791 let password = crate::tools::tty::read_and_verify_password("New Password: ")?;
ac716234 1792
cbe01dc5 1793 let mut new_key_config = encrypt_key_with_passphrase(&key, &password)?;
ab44acff
DM
1794 new_key_config.created = created; // keep original value
1795
1796 store_key_config(&path, true, new_key_config)?;
ac716234 1797
181f097a
DM
1798 Ok(Value::Null)
1799 } else if kdf == "none" {
ab44acff 1800 let modified = Local.timestamp(Local::now().timestamp(), 0);
181f097a
DM
1801
1802 store_key_config(&path, true, KeyConfig {
1803 kdf: None,
ab44acff
DM
1804 created, // keep original value
1805 modified,
6d0983db 1806 data: key.to_vec(),
181f097a
DM
1807 })?;
1808
1809 Ok(Value::Null)
1810 } else {
1811 unreachable!();
1812 }
f2401311
DM
1813}
1814
1815fn key_mgmt_cli() -> CliCommandMap {
1816
255f378a 1817 const KDF_SCHEMA: Schema =
181f097a 1818 StringSchema::new("Key derivation function. Choose 'none' to store the key unecrypted.")
255f378a
DM
1819 .format(&ApiStringFormat::Enum(&["scrypt", "none"]))
1820 .default("scrypt")
1821 .schema();
1822
552c2259 1823 #[sortable]
255f378a
DM
1824 const API_METHOD_KEY_CREATE: ApiMethod = ApiMethod::new(
1825 &ApiHandler::Sync(&key_create),
1826 &ObjectSchema::new(
1827 "Create a new encryption key.",
552c2259 1828 &sorted!([
255f378a
DM
1829 ("path", false, &StringSchema::new("File system path.").schema()),
1830 ("kdf", true, &KDF_SCHEMA),
552c2259 1831 ]),
255f378a 1832 )
181f097a 1833 );
7074a0b3 1834
255f378a 1835 let key_create_cmd_def = CliCommand::new(&API_METHOD_KEY_CREATE)
49fddd98 1836 .arg_param(&["path"])
9b06db45 1837 .completion_cb("path", tools::complete_file_name);
f2401311 1838
552c2259 1839 #[sortable]
255f378a
DM
1840 const API_METHOD_KEY_CHANGE_PASSPHRASE: ApiMethod = ApiMethod::new(
1841 &ApiHandler::Sync(&key_change_passphrase),
1842 &ObjectSchema::new(
1843 "Change the passphrase required to decrypt the key.",
552c2259 1844 &sorted!([
255f378a
DM
1845 ("path", false, &StringSchema::new("File system path.").schema()),
1846 ("kdf", true, &KDF_SCHEMA),
552c2259 1847 ]),
255f378a
DM
1848 )
1849 );
7074a0b3 1850
255f378a 1851 let key_change_passphrase_cmd_def = CliCommand::new(&API_METHOD_KEY_CHANGE_PASSPHRASE)
49fddd98 1852 .arg_param(&["path"])
9b06db45 1853 .completion_cb("path", tools::complete_file_name);
ac716234 1854
255f378a
DM
1855 const API_METHOD_KEY_CREATE_MASTER_KEY: ApiMethod = ApiMethod::new(
1856 &ApiHandler::Sync(&key_create_master_key),
1857 &ObjectSchema::new("Create a new 4096 bit RSA master pub/priv key pair.", &[])
1858 );
7074a0b3 1859
255f378a
DM
1860 let key_create_master_key_cmd_def = CliCommand::new(&API_METHOD_KEY_CREATE_MASTER_KEY);
1861
552c2259 1862 #[sortable]
255f378a
DM
1863 const API_METHOD_KEY_IMPORT_MASTER_PUBKEY: ApiMethod = ApiMethod::new(
1864 &ApiHandler::Sync(&key_import_master_pubkey),
1865 &ObjectSchema::new(
1866 "Import a new RSA public key and use it as master key. The key is expected to be in '.pem' format.",
552c2259 1867 &sorted!([ ("path", false, &StringSchema::new("File system path.").schema()) ]),
255f378a
DM
1868 )
1869 );
7074a0b3 1870
255f378a 1871 let key_import_master_pubkey_cmd_def = CliCommand::new(&API_METHOD_KEY_IMPORT_MASTER_PUBKEY)
49fddd98 1872 .arg_param(&["path"])
3ea8bfc9
DM
1873 .completion_cb("path", tools::complete_file_name);
1874
11377a47 1875 CliCommandMap::new()
48ef3c33
DM
1876 .insert("create", key_create_cmd_def)
1877 .insert("create-master-key", key_create_master_key_cmd_def)
1878 .insert("import-master-pubkey", key_import_master_pubkey_cmd_def)
1879 .insert("change-passphrase", key_change_passphrase_cmd_def)
f2401311
DM
1880}
1881
70235f72
CE
1882fn mount(
1883 param: Value,
1884 _info: &ApiMethod,
1885 _rpcenv: &mut dyn RpcEnvironment,
1886) -> Result<Value, Error> {
1887 let verbose = param["verbose"].as_bool().unwrap_or(false);
1888 if verbose {
1889 // This will stay in foreground with debug output enabled as None is
1890 // passed for the RawFd.
3f06d6fb 1891 return proxmox_backup::tools::runtime::main(mount_do(param, None));
70235f72
CE
1892 }
1893
1894 // Process should be deamonized.
1895 // Make sure to fork before the async runtime is instantiated to avoid troubles.
1896 let pipe = pipe()?;
1897 match fork() {
11377a47 1898 Ok(ForkResult::Parent { .. }) => {
70235f72
CE
1899 nix::unistd::close(pipe.1).unwrap();
1900 // Blocks the parent process until we are ready to go in the child
1901 let _res = nix::unistd::read(pipe.0, &mut [0]).unwrap();
1902 Ok(Value::Null)
1903 }
1904 Ok(ForkResult::Child) => {
1905 nix::unistd::close(pipe.0).unwrap();
1906 nix::unistd::setsid().unwrap();
3f06d6fb 1907 proxmox_backup::tools::runtime::main(mount_do(param, Some(pipe.1)))
70235f72
CE
1908 }
1909 Err(_) => bail!("failed to daemonize process"),
1910 }
1911}
1912
1913async fn mount_do(param: Value, pipe: Option<RawFd>) -> Result<Value, Error> {
1914 let repo = extract_repository_from_value(&param)?;
1915 let archive_name = tools::required_string_param(&param, "archive-name")?;
1916 let target = tools::required_string_param(&param, "target")?;
1917 let client = HttpClient::new(repo.host(), repo.user(), None)?;
1918
1919 record_repository(&repo);
1920
1921 let path = tools::required_string_param(&param, "snapshot")?;
1922 let (backup_type, backup_id, backup_time) = if path.matches('/').count() == 1 {
1923 let group = BackupGroup::parse(path)?;
27c9affb 1924 api_datastore_latest_snapshot(&client, repo.store(), group).await?
70235f72
CE
1925 } else {
1926 let snapshot = BackupDir::parse(path)?;
1927 (snapshot.group().backup_type().to_owned(), snapshot.group().backup_id().to_owned(), snapshot.backup_time())
1928 };
1929
11377a47 1930 let keyfile = param["keyfile"].as_str().map(PathBuf::from);
70235f72
CE
1931 let crypt_config = match keyfile {
1932 None => None,
1933 Some(path) => {
6d20a29d 1934 let (key, _) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
70235f72
CE
1935 Some(Arc::new(CryptConfig::new(key)?))
1936 }
1937 };
1938
1939 let server_archive_name = if archive_name.ends_with(".pxar") {
1940 format!("{}.didx", archive_name)
1941 } else {
1942 bail!("Can only mount pxar archives.");
1943 };
1944
296c50ba
DM
1945 let client = BackupReader::start(
1946 client,
1947 crypt_config.clone(),
1948 repo.store(),
1949 &backup_type,
1950 &backup_id,
1951 backup_time,
1952 true,
1953 ).await?;
70235f72 1954
f06b820a 1955 let manifest = client.download_manifest().await?;
296c50ba 1956
70235f72 1957 if server_archive_name.ends_with(".didx") {
c3d84a22 1958 let index = client.download_dynamic_index(&manifest, &server_archive_name).await?;
70235f72
CE
1959 let most_used = index.find_most_used_chunks(8);
1960 let chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config, most_used);
1961 let reader = BufferedDynamicReader::new(index, chunk_reader);
f701d033 1962 let decoder = pxar::Decoder::new(reader)?;
70235f72 1963 let options = OsStr::new("ro,default_permissions");
2a111910 1964 let mut session = pxar::fuse::Session::new(decoder, &options, pipe.is_none())
70235f72
CE
1965 .map_err(|err| format_err!("pxar mount failed: {}", err))?;
1966
1967 // Mount the session but not call fuse deamonize as this will cause
1968 // issues with the runtime after the fork
1969 let deamonize = false;
1970 session.mount(&Path::new(target), deamonize)?;
1971
1972 if let Some(pipe) = pipe {
1973 nix::unistd::chdir(Path::new("/")).unwrap();
1974 // Finish creation of deamon by redirecting filedescriptors.
1975 let nullfd = nix::fcntl::open(
1976 "/dev/null",
1977 nix::fcntl::OFlag::O_RDWR,
1978 nix::sys::stat::Mode::empty(),
1979 ).unwrap();
1980 nix::unistd::dup2(nullfd, 0).unwrap();
1981 nix::unistd::dup2(nullfd, 1).unwrap();
1982 nix::unistd::dup2(nullfd, 2).unwrap();
1983 if nullfd > 2 {
1984 nix::unistd::close(nullfd).unwrap();
1985 }
1986 // Signal the parent process that we are done with the setup and it can
1987 // terminate.
11377a47 1988 nix::unistd::write(pipe, &[0u8])?;
70235f72
CE
1989 nix::unistd::close(pipe).unwrap();
1990 }
1991
1992 let multithreaded = true;
1993 session.run_loop(multithreaded)?;
1994 } else {
1995 bail!("unknown archive file extension (expected .pxar)");
1996 }
1997
1998 Ok(Value::Null)
1999}
2000
78d54360
WB
2001#[api(
2002 input: {
2003 properties: {
2004 "snapshot": {
2005 type: String,
2006 description: "Group/Snapshot path.",
2007 },
2008 "archive-name": {
2009 type: String,
2010 description: "Backup archive name.",
2011 },
2012 "repository": {
2013 optional: true,
2014 schema: REPO_URL_SCHEMA,
2015 },
2016 "keyfile": {
2017 optional: true,
2018 type: String,
2019 description: "Path to encryption key.",
2020 },
2021 },
2022 },
2023)]
2024/// Shell to interactively inspect and restore snapshots.
2025async fn catalog_shell(param: Value) -> Result<(), Error> {
3cf73c4e
CE
2026 let repo = extract_repository_from_value(&param)?;
2027 let client = HttpClient::new(repo.host(), repo.user(), None)?;
2028 let path = tools::required_string_param(&param, "snapshot")?;
2029 let archive_name = tools::required_string_param(&param, "archive-name")?;
2030
2031 let (backup_type, backup_id, backup_time) = if path.matches('/').count() == 1 {
2032 let group = BackupGroup::parse(path)?;
27c9affb 2033 api_datastore_latest_snapshot(&client, repo.store(), group).await?
3cf73c4e
CE
2034 } else {
2035 let snapshot = BackupDir::parse(path)?;
2036 (snapshot.group().backup_type().to_owned(), snapshot.group().backup_id().to_owned(), snapshot.backup_time())
2037 };
2038
2039 let keyfile = param["keyfile"].as_str().map(|p| PathBuf::from(p));
2040 let crypt_config = match keyfile {
2041 None => None,
2042 Some(path) => {
6d20a29d 2043 let (key, _) = load_and_decrypt_key(&path, &get_encryption_key_password)?;
3cf73c4e
CE
2044 Some(Arc::new(CryptConfig::new(key)?))
2045 }
2046 };
2047
2048 let server_archive_name = if archive_name.ends_with(".pxar") {
2049 format!("{}.didx", archive_name)
2050 } else {
2051 bail!("Can only mount pxar archives.");
2052 };
2053
2054 let client = BackupReader::start(
2055 client,
2056 crypt_config.clone(),
2057 repo.store(),
2058 &backup_type,
2059 &backup_id,
2060 backup_time,
2061 true,
2062 ).await?;
2063
2064 let tmpfile = std::fs::OpenOptions::new()
2065 .write(true)
2066 .read(true)
2067 .custom_flags(libc::O_TMPFILE)
2068 .open("/tmp")?;
2069
2070 let manifest = client.download_manifest().await?;
2071
2072 let index = client.download_dynamic_index(&manifest, &server_archive_name).await?;
2073 let most_used = index.find_most_used_chunks(8);
2074 let chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config.clone(), most_used);
2075 let reader = BufferedDynamicReader::new(index, chunk_reader);
f701d033
DM
2076 let mut decoder = pxar::Decoder::new(reader)?;
2077 decoder.set_callback(|path| {
2078 println!("{:?}", path);
2079 Ok(())
2080 });
3cf73c4e
CE
2081
2082 let tmpfile = client.download(CATALOG_NAME, tmpfile).await?;
2083 let index = DynamicIndexReader::new(tmpfile)
2084 .map_err(|err| format_err!("unable to read catalog index - {}", err))?;
2085
2086 // Note: do not use values stored in index (not trusted) - instead, computed them again
2087 let (csum, size) = index.compute_csum();
2088 manifest.verify_file(CATALOG_NAME, &csum, size)?;
2089
2090 let most_used = index.find_most_used_chunks(8);
2091 let chunk_reader = RemoteChunkReader::new(client.clone(), crypt_config, most_used);
2092 let mut reader = BufferedDynamicReader::new(index, chunk_reader);
2093 let mut catalogfile = std::fs::OpenOptions::new()
2094 .write(true)
2095 .read(true)
2096 .custom_flags(libc::O_TMPFILE)
2097 .open("/tmp")?;
2098
2099 std::io::copy(&mut reader, &mut catalogfile)
2100 .map_err(|err| format_err!("unable to download catalog - {}", err))?;
2101
2102 catalogfile.seek(SeekFrom::Start(0))?;
2103 let catalog_reader = CatalogReader::new(catalogfile);
2104 let state = Shell::new(
2105 catalog_reader,
2106 &server_archive_name,
2107 decoder,
2108 )?;
2109
2110 println!("Starting interactive shell");
2111 state.shell()?;
2112
2113 record_repository(&repo);
2114
78d54360 2115 Ok(())
3cf73c4e
CE
2116}
2117
1c6ad6ef 2118fn catalog_mgmt_cli() -> CliCommandMap {
78d54360 2119 let catalog_shell_cmd_def = CliCommand::new(&API_METHOD_CATALOG_SHELL)
1c6ad6ef
DM
2120 .arg_param(&["snapshot", "archive-name"])
2121 .completion_cb("repository", complete_repository)
0ec9e1b0 2122 .completion_cb("archive-name", complete_pxar_archive_name)
1c6ad6ef
DM
2123 .completion_cb("snapshot", complete_group_or_snapshot);
2124
1c6ad6ef
DM
2125 let catalog_dump_cmd_def = CliCommand::new(&API_METHOD_DUMP_CATALOG)
2126 .arg_param(&["snapshot"])
2127 .completion_cb("repository", complete_repository)
2128 .completion_cb("snapshot", complete_backup_snapshot);
2129
2130 CliCommandMap::new()
48ef3c33
DM
2131 .insert("dump", catalog_dump_cmd_def)
2132 .insert("shell", catalog_shell_cmd_def)
1c6ad6ef
DM
2133}
2134
5830c205
DM
2135#[api(
2136 input: {
2137 properties: {
2138 repository: {
2139 schema: REPO_URL_SCHEMA,
2140 optional: true,
2141 },
2142 limit: {
2143 description: "The maximal number of tasks to list.",
2144 type: Integer,
2145 optional: true,
2146 minimum: 1,
2147 maximum: 1000,
2148 default: 50,
2149 },
2150 "output-format": {
2151 schema: OUTPUT_FORMAT,
2152 optional: true,
2153 },
2154 }
2155 }
2156)]
2157/// List running server tasks for this repo user
d6c4a119 2158async fn task_list(param: Value) -> Result<Value, Error> {
5830c205 2159
d6c4a119
DM
2160 let output_format = param["output-format"].as_str().unwrap_or("text").to_owned();
2161 let repo = extract_repository_from_value(&param)?;
2162 let client = HttpClient::new(repo.host(), repo.user(), None)?;
5830c205 2163
d6c4a119 2164 let limit = param["limit"].as_u64().unwrap_or(50) as usize;
5830c205 2165
d6c4a119
DM
2166 let args = json!({
2167 "running": true,
2168 "start": 0,
2169 "limit": limit,
2170 "userfilter": repo.user(),
2171 "store": repo.store(),
2172 });
2173 let result = client.get("api2/json/nodes/localhost/tasks", Some(args)).await?;
5830c205 2174
d6c4a119 2175 let data = &result["data"];
5830c205 2176
d6c4a119
DM
2177 if output_format == "text" {
2178 for item in data.as_array().unwrap() {
2179 println!(
2180 "{} {}",
2181 item["upid"].as_str().unwrap(),
2182 item["status"].as_str().unwrap_or("running"),
2183 );
5830c205 2184 }
d6c4a119
DM
2185 } else {
2186 format_and_print_result(data, &output_format);
2187 }
5830c205
DM
2188
2189 Ok(Value::Null)
2190}
2191
2192#[api(
2193 input: {
2194 properties: {
2195 repository: {
2196 schema: REPO_URL_SCHEMA,
2197 optional: true,
2198 },
2199 upid: {
2200 schema: UPID_SCHEMA,
2201 },
2202 }
2203 }
2204)]
2205/// Display the task log.
d6c4a119 2206async fn task_log(param: Value) -> Result<Value, Error> {
5830c205 2207
d6c4a119
DM
2208 let repo = extract_repository_from_value(&param)?;
2209 let upid = tools::required_string_param(&param, "upid")?;
5830c205 2210
d6c4a119 2211 let client = HttpClient::new(repo.host(), repo.user(), None)?;
5830c205 2212
d6c4a119 2213 display_task_log(client, upid, true).await?;
5830c205
DM
2214
2215 Ok(Value::Null)
2216}
2217
3f1020b7
DM
2218#[api(
2219 input: {
2220 properties: {
2221 repository: {
2222 schema: REPO_URL_SCHEMA,
2223 optional: true,
2224 },
2225 upid: {
2226 schema: UPID_SCHEMA,
2227 },
2228 }
2229 }
2230)]
2231/// Try to stop a specific task.
d6c4a119 2232async fn task_stop(param: Value) -> Result<Value, Error> {
3f1020b7 2233
d6c4a119
DM
2234 let repo = extract_repository_from_value(&param)?;
2235 let upid_str = tools::required_string_param(&param, "upid")?;
3f1020b7 2236
d6c4a119 2237 let mut client = HttpClient::new(repo.host(), repo.user(), None)?;
3f1020b7 2238
d6c4a119
DM
2239 let path = format!("api2/json/nodes/localhost/tasks/{}", upid_str);
2240 let _ = client.delete(&path, None).await?;
3f1020b7
DM
2241
2242 Ok(Value::Null)
2243}
2244
5830c205
DM
2245fn task_mgmt_cli() -> CliCommandMap {
2246
2247 let task_list_cmd_def = CliCommand::new(&API_METHOD_TASK_LIST)
2248 .completion_cb("repository", complete_repository);
2249
2250 let task_log_cmd_def = CliCommand::new(&API_METHOD_TASK_LOG)
2251 .arg_param(&["upid"]);
2252
3f1020b7
DM
2253 let task_stop_cmd_def = CliCommand::new(&API_METHOD_TASK_STOP)
2254 .arg_param(&["upid"]);
2255
5830c205
DM
2256 CliCommandMap::new()
2257 .insert("log", task_log_cmd_def)
2258 .insert("list", task_list_cmd_def)
3f1020b7 2259 .insert("stop", task_stop_cmd_def)
5830c205 2260}
1c6ad6ef 2261
f2401311 2262fn main() {
33d64b81 2263
255f378a 2264 let backup_cmd_def = CliCommand::new(&API_METHOD_CREATE_BACKUP)
49fddd98 2265 .arg_param(&["backupspec"])
d0a03d40 2266 .completion_cb("repository", complete_repository)
49811347 2267 .completion_cb("backupspec", complete_backup_source)
6d0983db 2268 .completion_cb("keyfile", tools::complete_file_name)
49811347 2269 .completion_cb("chunk-size", complete_chunk_size);
f8838fe9 2270
255f378a 2271 let upload_log_cmd_def = CliCommand::new(&API_METHOD_UPLOAD_LOG)
49fddd98 2272 .arg_param(&["snapshot", "logfile"])
543a260f 2273 .completion_cb("snapshot", complete_backup_snapshot)
ec34f7eb
DM
2274 .completion_cb("logfile", tools::complete_file_name)
2275 .completion_cb("keyfile", tools::complete_file_name)
2276 .completion_cb("repository", complete_repository);
2277
255f378a 2278 let list_cmd_def = CliCommand::new(&API_METHOD_LIST_BACKUP_GROUPS)
d0a03d40 2279 .completion_cb("repository", complete_repository);
41c039e1 2280
255f378a 2281 let snapshots_cmd_def = CliCommand::new(&API_METHOD_LIST_SNAPSHOTS)
49fddd98 2282 .arg_param(&["group"])
024f11bb 2283 .completion_cb("group", complete_backup_group)
d0a03d40 2284 .completion_cb("repository", complete_repository);
184f17af 2285
255f378a 2286 let forget_cmd_def = CliCommand::new(&API_METHOD_FORGET_SNAPSHOTS)
49fddd98 2287 .arg_param(&["snapshot"])
b2388518 2288 .completion_cb("repository", complete_repository)
543a260f 2289 .completion_cb("snapshot", complete_backup_snapshot);
6f62c924 2290
255f378a 2291 let garbage_collect_cmd_def = CliCommand::new(&API_METHOD_START_GARBAGE_COLLECTION)
d0a03d40 2292 .completion_cb("repository", complete_repository);
8cc0d6af 2293
255f378a 2294 let restore_cmd_def = CliCommand::new(&API_METHOD_RESTORE)
49fddd98 2295 .arg_param(&["snapshot", "archive-name", "target"])
b2388518 2296 .completion_cb("repository", complete_repository)
08dc340a
DM
2297 .completion_cb("snapshot", complete_group_or_snapshot)
2298 .completion_cb("archive-name", complete_archive_name)
2299 .completion_cb("target", tools::complete_file_name);
9f912493 2300
255f378a 2301 let files_cmd_def = CliCommand::new(&API_METHOD_LIST_SNAPSHOT_FILES)
49fddd98 2302 .arg_param(&["snapshot"])
52c171e4 2303 .completion_cb("repository", complete_repository)
543a260f 2304 .completion_cb("snapshot", complete_backup_snapshot);
52c171e4 2305
255f378a 2306 let prune_cmd_def = CliCommand::new(&API_METHOD_PRUNE)
49fddd98 2307 .arg_param(&["group"])
9fdc3ef4 2308 .completion_cb("group", complete_backup_group)
d0a03d40 2309 .completion_cb("repository", complete_repository);
9f912493 2310
255f378a 2311 let status_cmd_def = CliCommand::new(&API_METHOD_STATUS)
34a816cc
DM
2312 .completion_cb("repository", complete_repository);
2313
255f378a 2314 let login_cmd_def = CliCommand::new(&API_METHOD_API_LOGIN)
e240d8be
DM
2315 .completion_cb("repository", complete_repository);
2316
255f378a 2317 let logout_cmd_def = CliCommand::new(&API_METHOD_API_LOGOUT)
e240d8be 2318 .completion_cb("repository", complete_repository);
32efac1c 2319
552c2259 2320 #[sortable]
255f378a
DM
2321 const API_METHOD_MOUNT: ApiMethod = ApiMethod::new(
2322 &ApiHandler::Sync(&mount),
2323 &ObjectSchema::new(
2324 "Mount pxar archive.",
552c2259 2325 &sorted!([
255f378a
DM
2326 ("snapshot", false, &StringSchema::new("Group/Snapshot path.").schema()),
2327 ("archive-name", false, &StringSchema::new("Backup archive name.").schema()),
2328 ("target", false, &StringSchema::new("Target directory path.").schema()),
2329 ("repository", true, &REPO_URL_SCHEMA),
2330 ("keyfile", true, &StringSchema::new("Path to encryption key.").schema()),
2331 ("verbose", true, &BooleanSchema::new("Verbose output.").default(false).schema()),
552c2259 2332 ]),
255f378a
DM
2333 )
2334 );
7074a0b3 2335
255f378a 2336 let mount_cmd_def = CliCommand::new(&API_METHOD_MOUNT)
49fddd98 2337 .arg_param(&["snapshot", "archive-name", "target"])
70235f72
CE
2338 .completion_cb("repository", complete_repository)
2339 .completion_cb("snapshot", complete_group_or_snapshot)
0ec9e1b0 2340 .completion_cb("archive-name", complete_pxar_archive_name)
70235f72 2341 .completion_cb("target", tools::complete_file_name);
e240d8be 2342
3cf73c4e 2343
41c039e1 2344 let cmd_def = CliCommandMap::new()
48ef3c33
DM
2345 .insert("backup", backup_cmd_def)
2346 .insert("upload-log", upload_log_cmd_def)
2347 .insert("forget", forget_cmd_def)
2348 .insert("garbage-collect", garbage_collect_cmd_def)
2349 .insert("list", list_cmd_def)
2350 .insert("login", login_cmd_def)
2351 .insert("logout", logout_cmd_def)
2352 .insert("prune", prune_cmd_def)
2353 .insert("restore", restore_cmd_def)
2354 .insert("snapshots", snapshots_cmd_def)
2355 .insert("files", files_cmd_def)
2356 .insert("status", status_cmd_def)
2357 .insert("key", key_mgmt_cli())
2358 .insert("mount", mount_cmd_def)
5830c205
DM
2359 .insert("catalog", catalog_mgmt_cli())
2360 .insert("task", task_mgmt_cli());
48ef3c33 2361
3f06d6fb 2362 proxmox_backup::tools::runtime::main(run_cli_command(cmd_def));
ff5d3707 2363}