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