]> git.proxmox.com Git - proxmox-backup.git/blobdiff - src/bin/proxmox-backup-client.rs
src/bin/proxmox-backup-client.rs: implement chunk-size completion
[proxmox-backup.git] / src / bin / proxmox-backup-client.rs
index f008b3764a8ae9d0f937a6c13c8f463a30d629b0..73ab8e8a77d0e0e2ae1bf3cd84400502eea95301 100644 (file)
@@ -2,11 +2,11 @@ extern crate proxmox_backup;
 
 use failure::*;
 //use std::os::unix::io::AsRawFd;
-use chrono::{DateTime, Local, Utc, TimeZone};
-use std::path::Path;
+use chrono::{DateTime, Local, TimeZone};
+use std::path::{Path, PathBuf};
+use std::collections::HashMap;
 
 use proxmox_backup::tools;
-use proxmox_backup::flog;
 use proxmox_backup::cli::*;
 use proxmox_backup::api_schema::*;
 use proxmox_backup::api_schema::router::*;
@@ -21,11 +21,87 @@ use serde_json::{json, Value};
 use hyper::Body;
 use std::sync::Arc;
 use regex::Regex;
+use xdg::BaseDirectories;
 
 use lazy_static::lazy_static;
 
 lazy_static! {
-    static ref BACKUPSPEC_REGEX: Regex = Regex::new(r"^([a-zA-Z0-9_-]+):(.+)$").unwrap();
+    static ref BACKUPSPEC_REGEX: Regex = Regex::new(r"^([a-zA-Z0-9_-]+\.(?:catar|raw)):(.+)$").unwrap();
+}
+
+
+fn record_repository(repo: &BackupRepository) {
+
+    let base = match BaseDirectories::with_prefix("proxmox-backup") {
+        Ok(v) => v,
+        _ => return,
+    };
+
+    // usually $HOME/.cache/proxmox-backup/repo-list
+    let path = match base.place_cache_file("repo-list") {
+        Ok(v) => v,
+        _ => return,
+    };
+
+    let mut data = tools::file_get_json(&path).unwrap_or(json!({}));
+
+    let repo = repo.to_string();
+
+    data[&repo] = json!{ data[&repo].as_i64().unwrap_or(0) + 1 };
+
+    let mut map = serde_json::map::Map::new();
+
+    loop {
+        let mut max_used = 0;
+        let mut max_repo = None;
+        for (repo, count) in data.as_object().unwrap() {
+            if map.contains_key(repo) { continue; }
+            if let Some(count) = count.as_i64() {
+                if count > max_used {
+                    max_used = count;
+                    max_repo = Some(repo);
+                }
+            }
+        }
+        if let Some(repo) = max_repo {
+            map.insert(repo.to_owned(), json!(max_used));
+        } else {
+            break;
+        }
+        if map.len() > 10 { // store max. 10 repos
+            break;
+        }
+    }
+
+    let new_data = json!(map);
+
+    let _ = tools::file_set_contents(path, new_data.to_string().as_bytes(), None);
+}
+
+fn complete_repository(_arg: &str, _param: &HashMap<String, String>) -> Vec<String> {
+
+    let mut result = vec![];
+
+    let base = match BaseDirectories::with_prefix("proxmox-backup") {
+        Ok(v) => v,
+        _ => return result,
+    };
+
+    // usually $HOME/.cache/proxmox-backup/repo-list
+    let path = match base.place_cache_file("repo-list") {
+        Ok(v) => v,
+        _ => return result,
+    };
+
+    let data = tools::file_get_json(&path).unwrap_or(json!({}));
+
+    if let Some(map) = data.as_object() {
+        for (repo, _count) in map {
+            result.push(repo.to_owned());
+        }
+    }
+
+    result
 }
 
 fn backup_directory<P: AsRef<Path>>(
@@ -33,15 +109,18 @@ fn backup_directory<P: AsRef<Path>>(
     repo: &BackupRepository,
     dir_path: P,
     archive_name: &str,
-    backup_time: DateTime<Utc>,
+    backup_id: &str,
+    backup_time: DateTime<Local>,
     chunk_size: Option<u64>,
+    all_file_systems: bool,
+    verbose: bool,
 ) -> Result<(), Error> {
 
     let mut param = json!({
         "archive-name": archive_name,
-        "type": "host",
-        "id": &tools::nodename(),
-        "time": backup_time.timestamp(),
+        "backup-type": "host",
+        "backup-id": backup_id,
+        "backup-time": backup_time.timestamp(),
     });
 
     if let Some(size) = chunk_size {
@@ -50,9 +129,9 @@ fn backup_directory<P: AsRef<Path>>(
 
     let query = tools::json_object_to_query(param)?;
 
-    let path = format!("api2/json/admin/datastore/{}/catar?{}", repo.store, query);
+    let path = format!("api2/json/admin/datastore/{}/catar?{}", repo.store(), query);
 
-    let stream = CaTarBackupStream::open(dir_path.as_ref())?;
+    let stream = CaTarBackupStream::open(dir_path.as_ref(), all_file_systems, verbose)?;
 
     let body = Body::wrap_stream(stream);
 
@@ -87,6 +166,23 @@ fn backup_image(datastore: &DataStore, file: &std::fs::File, size: usize, target
 }
 */
 
+fn strip_chunked_file_expenstions(list: Vec<String>) -> Vec<String> {
+
+    let mut result = vec![];
+
+    for file in list.into_iter() {
+        if file.ends_with(".didx") {
+            result.push(file[..file.len()-5].to_owned());
+        } else if file.ends_with(".fidx") {
+            result.push(file[..file.len()-5].to_owned());
+        } else {
+            result.push(file); // should not happen
+        }
+    }
+
+    result
+}
+
 fn list_backups(
     param: Value,
     _info: &ApiMethod,
@@ -94,14 +190,16 @@ fn list_backups(
 ) -> Result<Value, Error> {
 
     let repo_url = tools::required_string_param(&param, "repository")?;
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
-    let path = format!("api2/json/admin/datastore/{}/backups", repo.store);
+    let path = format!("api2/json/admin/datastore/{}/backups", repo.store());
 
     let result = client.get(&path)?;
 
+    record_repository(&repo);
+
     // fixme: implement and use output formatter instead ..
     let list = result["data"].as_array().unwrap();
 
@@ -110,23 +208,15 @@ fn list_backups(
         let id = item["backup-id"].as_str().unwrap();
         let btype = item["backup-type"].as_str().unwrap();
         let epoch = item["backup-time"].as_i64().unwrap();
-        let backup_time = Local.timestamp(epoch, 0);
-
-        let backup_dir = BackupDir {
-            group: BackupGroup {
-                backup_type: btype.to_string(),
-                backup_id: id.to_string(),
-            },
-            backup_time
-        };
 
-        let files = item["files"].as_array().unwrap().iter().map(|v| v.as_str().unwrap().to_owned()).collect();
+        let backup_dir = BackupDir::new(btype, id, epoch);
 
-        let info = BackupInfo { backup_dir, files };
+        let files = item["files"].as_array().unwrap().iter().map(|v| v.as_str().unwrap().to_owned()).collect();
+        let files = strip_chunked_file_expenstions(files);
 
-        for filename in info.files {
-            let path = info.backup_dir.relative_path().to_str().unwrap().to_owned();
-            println!("{} | {}/{}", backup_time.format("%c"), path, filename);
+        for filename in files {
+            let path = backup_dir.relative_path().to_str().unwrap().to_owned();
+            println!("{} | {}/{}", backup_dir.backup_time().format("%c"), path, filename);
         }
     }
 
@@ -141,16 +231,32 @@ fn list_backup_groups(
 ) -> Result<Value, Error> {
 
     let repo_url = tools::required_string_param(&param, "repository")?;
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
-    let path = format!("api2/json/admin/datastore/{}/groups", repo.store);
+    let path = format!("api2/json/admin/datastore/{}/groups", repo.store());
 
-    let result = client.get(&path)?;
+    let mut result = client.get(&path)?;
+
+    record_repository(&repo);
 
     // fixme: implement and use output formatter instead ..
-    let list = result["data"].as_array().unwrap();
+    let list = result["data"].as_array_mut().unwrap();
+
+    list.sort_unstable_by(|a, b| {
+        let a_id = a["backup-id"].as_str().unwrap();
+        let a_backup_type = a["backup-type"].as_str().unwrap();
+        let b_id = b["backup-id"].as_str().unwrap();
+        let b_backup_type = b["backup-type"].as_str().unwrap();
+
+        let type_order = a_backup_type.cmp(b_backup_type);
+        if type_order == std::cmp::Ordering::Equal {
+            a_id.cmp(b_id)
+        } else {
+            type_order
+        }
+    });
 
     for item in list {
 
@@ -160,19 +266,14 @@ fn list_backup_groups(
         let last_backup = Local.timestamp(epoch, 0);
         let backup_count = item["backup-count"].as_u64().unwrap();
 
-        let group = BackupGroup {
-            backup_type: btype.to_string(),
-            backup_id: id.to_string(),
-        };
+        let group = BackupGroup::new(btype, id);
 
         let path = group.group_path().to_str().unwrap().to_owned();
 
-        let files = item["files"].as_array().unwrap().iter()
-            .map(|v| {
-                v.as_str().unwrap().to_owned()
-            }).collect();
+        let files = item["files"].as_array().unwrap().iter().map(|v| v.as_str().unwrap().to_owned()).collect();
+        let files = strip_chunked_file_expenstions(files);
 
-        println!("{} | {} | {} | {}", path, last_backup.format("%c"),
+        println!("{:20} | {} | {:5} | {}", path, last_backup.format("%c"),
                  backup_count, tools::join(&files, ' '));
     }
 
@@ -187,23 +288,25 @@ fn list_snapshots(
 ) -> Result<Value, Error> {
 
     let repo_url = tools::required_string_param(&param, "repository")?;
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
 
     let path = tools::required_string_param(&param, "group")?;
     let group = BackupGroup::parse(path)?;
 
     let query = tools::json_object_to_query(json!({
-        "backup-type": &group.backup_type,
-        "backup-id": &group.backup_id,
+        "backup-type": group.backup_type(),
+        "backup-id": group.backup_id(),
     }))?;
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
-    let path = format!("api2/json/admin/datastore/{}/snapshots?{}", repo.store, query);
+    let path = format!("api2/json/admin/datastore/{}/snapshots?{}", repo.store(), query);
 
     // fixme: params
     let result = client.get(&path)?;
 
+    record_repository(&repo);
+
     // fixme: implement and use output formatter instead ..
     let list = result["data"].as_array().unwrap();
 
@@ -212,29 +315,49 @@ fn list_snapshots(
         let id = item["backup-id"].as_str().unwrap();
         let btype = item["backup-type"].as_str().unwrap();
         let epoch = item["backup-time"].as_i64().unwrap();
-        let backup_time = Local.timestamp(epoch, 0);
-
-        let snapshot = BackupDir {
-            group: BackupGroup {
-                backup_type: btype.to_string(),
-                backup_id: id.to_string(),
-            },
-            backup_time,
-        };
+
+        let snapshot = BackupDir::new(btype, id, epoch);
 
         let path = snapshot.relative_path().to_str().unwrap().to_owned();
 
-        let files = item["files"].as_array().unwrap().iter()
-            .map(|v| {
-                v.as_str().unwrap().to_owned()
-            }).collect();
+        let files = item["files"].as_array().unwrap().iter().map(|v| v.as_str().unwrap().to_owned()).collect();
+        let files = strip_chunked_file_expenstions(files);
 
-        println!("{} | {} | {}", path, backup_time.format("%c"), tools::join(&files, ' '));
+        println!("{} | {} | {}", path, snapshot.backup_time().format("%c"), tools::join(&files, ' '));
     }
 
     Ok(Value::Null)
 }
 
+fn forget_snapshots(
+    param: Value,
+    _info: &ApiMethod,
+    _rpcenv: &mut RpcEnvironment,
+) -> Result<Value, Error> {
+
+    let repo_url = tools::required_string_param(&param, "repository")?;
+    let repo: BackupRepository = repo_url.parse()?;
+
+    let path = tools::required_string_param(&param, "snapshot")?;
+    let snapshot = BackupDir::parse(path)?;
+
+    let query = tools::json_object_to_query(json!({
+        "backup-type": snapshot.group().backup_type(),
+        "backup-id": snapshot.group().backup_id(),
+        "backup-time": snapshot.backup_time().timestamp(),
+    }))?;
+
+    let mut client = HttpClient::new(repo.host(), repo.user());
+
+    let path = format!("api2/json/admin/datastore/{}/snapshots?{}", repo.store(), query);
+
+    let result = client.delete(&path)?;
+
+    record_repository(&repo);
+
+    Ok(result)
+}
+
 fn start_garbage_collection(
     param: Value,
     _info: &ApiMethod,
@@ -242,14 +365,16 @@ fn start_garbage_collection(
 ) -> Result<Value, Error> {
 
     let repo_url = tools::required_string_param(&param, "repository")?;
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
-    let path = format!("api2/json/admin/datastore/{}/gc", repo.store);
+    let path = format!("api2/json/admin/datastore/{}/gc", repo.store());
 
     let result = client.post(&path)?;
 
+    record_repository(&repo);
+
     Ok(result)
 }
 
@@ -271,7 +396,11 @@ fn create_backup(
 
     let backupspec_list = tools::required_array_param(&param, "backupspec")?;
 
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
+
+    let all_file_systems = param["all-file-systems"].as_bool().unwrap_or(false);
+
+    let verbose = param["verbose"].as_bool().unwrap_or(false);
 
     let chunk_size_opt = param["chunk-size"].as_u64().map(|v| v*1024);
 
@@ -279,6 +408,8 @@ fn create_backup(
         verify_chunk_size(size)?;
     }
 
+    let backup_id = param["host-id"].as_str().unwrap_or(&tools::nodename());
+
     let mut upload_list = vec![];
 
     for backupspec in backupspec_list {
@@ -291,9 +422,7 @@ fn create_backup(
 
         if (stat.st_mode & libc::S_IFDIR) != 0 {
 
-            let target = format!("{}.catar", target);
-
-            upload_list.push((filename.to_owned(), target));
+            upload_list.push((filename.to_owned(), target.to_owned()));
 
         } else if (stat.st_mode & (libc::S_IFREG|libc::S_IFBLK)) != 0 {
             if stat.st_size <= 0 { bail!("got strange file size '{}'", stat.st_size); }
@@ -311,45 +440,46 @@ fn create_backup(
         }
     }
 
-    let backup_time = Utc::now();
+    let backup_time = Local.timestamp(Local::now().timestamp(), 0);
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
     client.login()?; // login before starting backup
 
-    let log_file_name = format!("backup-log-{}.log", backup_time.format("%Y-%m-%dT%H:%M:%S"));
+    record_repository(&repo);
 
-    let mut log = tools::FileLogger::new(&log_file_name, true)?;
-
-    flog!(log, "Starting backup");
-    flog!(log, "Client name: {}", tools::nodename());
-    flog!(log, "UTC Start Time: {}", Utc::now().format("%c"));
+    println!("Starting backup");
+    println!("Client name: {}", tools::nodename());
+    println!("Start Time: {}", backup_time.to_rfc3339());
 
     for (filename, target) in upload_list {
-        flog!(log, "Upload '{}' to '{:?}' as {}", filename, repo, target);
-        backup_directory(&mut client, &repo, &filename, &target, backup_time, chunk_size_opt)?;
+        println!("Upload '{}' to '{:?}' as {}", filename, repo, target);
+        backup_directory(&mut client, &repo, &filename, &target, backup_id, backup_time,
+                         chunk_size_opt, all_file_systems, verbose)?;
     }
 
-    flog!(log, "Upload backup log");
-    // fixme: impl upload log
-
-    flog!(log, "UTC End Time: {}", Utc::now().format("%c"));
+    let end_time = Local.timestamp(Local::now().timestamp(), 0);
+    let elapsed = end_time.signed_duration_since(backup_time);
+    println!("Duration: {}", elapsed);
 
-    //datastore.garbage_collection()?;
+    println!("End Time: {}", end_time.to_rfc3339());
 
     Ok(Value::Null)
-
 }
 
-pub fn complete_backup_source(arg: &str) -> Vec<String> {
+fn complete_backup_source(arg: &str, param: &HashMap<String, String>) -> Vec<String> {
 
     let mut result = vec![];
 
     let data: Vec<&str> = arg.splitn(2, ':').collect();
 
-    if data.len() != 2 { return result; }
+    if data.len() != 2 {
+        result.push(String::from("root.catar:/"));
+        result.push(String::from("etc.catar:/etc"));
+        return result;
+    }
 
-    let files = tools::complete_file_name(data[1]);
+    let files = tools::complete_file_name(data[1], param);
 
     for file in files {
         result.push(format!("{}:{}", data[0], file));
@@ -358,6 +488,77 @@ pub fn complete_backup_source(arg: &str) -> Vec<String> {
     result
 }
 
+fn restore(
+    param: Value,
+    _info: &ApiMethod,
+    _rpcenv: &mut RpcEnvironment,
+) -> Result<Value, Error> {
+
+    let repo_url = tools::required_string_param(&param, "repository")?;
+    let repo: BackupRepository = repo_url.parse()?;
+
+    let archive_name = tools::required_string_param(&param, "archive-name")?;
+
+    let mut client = HttpClient::new(repo.host(), repo.user());
+
+    client.login()?; // login before starting
+
+    record_repository(&repo);
+
+    let path = tools::required_string_param(&param, "snapshot")?;
+
+    let query;
+
+    if path.matches('/').count() == 1 {
+        let group = BackupGroup::parse(path)?;
+
+        let subquery = tools::json_object_to_query(json!({
+            "backup-type": group.backup_type(),
+            "backup-id": group.backup_id(),
+        }))?;
+
+        let path = format!("api2/json/admin/datastore/{}/snapshots?{}", repo.store(), subquery);
+        let result = client.get(&path)?;
+
+        let list = result["data"].as_array().unwrap();
+        if list.len() == 0 {
+            bail!("backup group '{}' does not contain any snapshots:", path);
+        }
+
+        query = tools::json_object_to_query(json!({
+            "backup-type": group.backup_type(),
+            "backup-id": group.backup_id(),
+            "backup-time": list[0]["backup-time"].as_i64().unwrap(),
+            "archive-name": archive_name,
+        }))?;
+    } else {
+        let snapshot = BackupDir::parse(path)?;
+
+        query = tools::json_object_to_query(json!({
+            "backup-type": snapshot.group().backup_type(),
+            "backup-id": snapshot.group().backup_id(),
+            "backup-time": snapshot.backup_time().timestamp(),
+            "archive-name": archive_name,
+        }))?;
+    }
+
+    let target = tools::required_string_param(&param, "target")?;
+
+    if archive_name.ends_with(".catar") {
+        let path = format!("api2/json/admin/datastore/{}/catar?{}", repo.store(), query);
+
+        println!("DOWNLOAD FILE {} to {}", path, target);
+
+        let target = PathBuf::from(target);
+        let writer = CaTarBackupWriter::new(&target, true)?;
+        client.download(&path, Box::new(writer))?;
+    } else {
+        bail!("unknown file extensions - unable to download '{}'", archive_name);
+    }
+
+    Ok(Value::Null)
+}
+
 fn prune(
     mut param: Value,
     _info: &ApiMethod,
@@ -365,19 +566,71 @@ fn prune(
 ) -> Result<Value, Error> {
 
     let repo_url = tools::required_string_param(&param, "repository")?;
-    let repo = BackupRepository::parse(repo_url)?;
+    let repo: BackupRepository = repo_url.parse()?;
 
-    let mut client = HttpClient::new(&repo.host, &repo.user);
+    let mut client = HttpClient::new(repo.host(), repo.user());
 
-    let path = format!("api2/json/admin/datastore/{}/prune", repo.store);
+    let path = format!("api2/json/admin/datastore/{}/prune", repo.store());
 
     param.as_object_mut().unwrap().remove("repository");
 
     let result = client.post_json(&path, param)?;
 
+    record_repository(&repo);
+
     Ok(result)
 }
 
+fn complete_backup_group(_arg: &str, param: &HashMap<String, String>) -> Vec<String> {
+
+    let mut result = vec![];
+
+    let repo_url = match param.get("repository") {
+        Some(v) => v,
+        _ => return result,
+    };
+
+    let repo: BackupRepository = match repo_url.parse() {
+        Ok(v) => v,
+        _ => return result,
+    };
+
+    let mut client = HttpClient::new(repo.host(), repo.user());
+
+    let path = format!("api2/json/admin/datastore/{}/groups", repo.store());
+
+    let resp = match client.try_get(&path) {
+        Ok(v) => v,
+        _ => return result,
+    };
+
+    if let Some(list) = resp["data"].as_array() {
+        for item in list {
+            if let (Some(backup_id), Some(backup_type)) =
+                (item["backup-id"].as_str(), item["backup-type"].as_str())
+            {
+                result.push(format!("{}/{}", backup_type, backup_id));
+            }
+        }
+    }
+
+    result
+}
+
+fn complete_chunk_size(_arg: &str, _param: &HashMap<String, String>) -> Vec<String> {
+
+    let mut result = vec![];
+
+    let mut size = 64;
+    loop {
+        result.push(size.to_string());
+        size = size * 2;
+        if size > 4096 { break; }
+    }
+
+    result
+}
+
 fn main() {
 
     let repo_url_schema: Arc<Schema> = Arc::new(
@@ -393,18 +646,24 @@ fn main() {
             .into()
     );
 
-    let create_cmd_def = CliCommand::new(
+    let backup_cmd_def = CliCommand::new(
         ApiMethod::new(
             create_backup,
-            ObjectSchema::new("Create backup.")
+            ObjectSchema::new("Create (host) backup.")
                 .required("repository", repo_url_schema.clone())
                 .required(
                     "backupspec",
                     ArraySchema::new(
-                        "List of backup source specifications ([<label>:<path>] ...)",
+                        "List of backup source specifications ([<label.ext>:<path>] ...)",
                         backup_source_schema,
                     ).min_length(1)
                 )
+                .optional(
+                    "verbose",
+                    BooleanSchema::new("Verbose output.").default(false))
+                .optional(
+                    "host-id",
+                    StringSchema::new("Use specified ID for the backup group name ('host/<id>'). The default is the system hostname."))
                 .optional(
                     "chunk-size",
                     IntegerSchema::new("Chunk size in KB. Must be a power of 2.")
@@ -414,7 +673,9 @@ fn main() {
                 )
         ))
         .arg_param(vec!["repository", "backupspec"])
-        .completion_cb("backupspec", complete_backup_source);
+        .completion_cb("repository", complete_repository)
+        .completion_cb("backupspec", complete_backup_source)
+        .completion_cb("chunk-size", complete_chunk_size);
 
     let list_cmd_def = CliCommand::new(
         ApiMethod::new(
@@ -422,7 +683,8 @@ fn main() {
             ObjectSchema::new("List backup groups.")
                 .required("repository", repo_url_schema.clone())
         ))
-        .arg_param(vec!["repository"]);
+        .arg_param(vec!["repository"])
+        .completion_cb("repository", complete_repository);
 
     let snapshots_cmd_def = CliCommand::new(
         ApiMethod::new(
@@ -431,7 +693,19 @@ fn main() {
                 .required("repository", repo_url_schema.clone())
                 .required("group", StringSchema::new("Backup group."))
         ))
-        .arg_param(vec!["repository", "group"]);
+        .arg_param(vec!["repository", "group"])
+        .completion_cb("group", complete_backup_group)
+        .completion_cb("repository", complete_repository);
+
+    let forget_cmd_def = CliCommand::new(
+        ApiMethod::new(
+            forget_snapshots,
+            ObjectSchema::new("Forget (remove) backup snapshots.")
+                .required("repository", repo_url_schema.clone())
+                .required("snapshot", StringSchema::new("Snapshot path."))
+        ))
+        .arg_param(vec!["repository", "snapshot"])
+        .completion_cb("repository", complete_repository);
 
     let garbage_collect_cmd_def = CliCommand::new(
         ApiMethod::new(
@@ -439,7 +713,20 @@ fn main() {
             ObjectSchema::new("Start garbage collection for a specific repository.")
                 .required("repository", repo_url_schema.clone())
         ))
-        .arg_param(vec!["repository"]);
+        .arg_param(vec!["repository"])
+        .completion_cb("repository", complete_repository);
+
+    let restore_cmd_def = CliCommand::new(
+        ApiMethod::new(
+            restore,
+            ObjectSchema::new("Restore backup repository.")
+                .required("repository", repo_url_schema.clone())
+                .required("snapshot", StringSchema::new("Group/Snapshot path."))
+                .required("archive-name", StringSchema::new("Backup archive name."))
+                .required("target", StringSchema::new("Target directory path."))
+        ))
+        .arg_param(vec!["repository", "snapshot", "archive-name", "target"])
+        .completion_cb("repository", complete_repository);
 
     let prune_cmd_def = CliCommand::new(
         ApiMethod::new(
@@ -449,13 +736,18 @@ fn main() {
                     .required("repository", repo_url_schema.clone())
             )
         ))
-        .arg_param(vec!["repository"]);
+        .arg_param(vec!["repository"])
+        .completion_cb("repository", complete_repository);
+
     let cmd_def = CliCommandMap::new()
-        .insert("create".to_owned(), create_cmd_def.into())
+        .insert("backup".to_owned(), backup_cmd_def.into())
+        .insert("forget".to_owned(), forget_cmd_def.into())
         .insert("garbage-collect".to_owned(), garbage_collect_cmd_def.into())
         .insert("list".to_owned(), list_cmd_def.into())
         .insert("prune".to_owned(), prune_cmd_def.into())
+        .insert("restore".to_owned(), restore_cmd_def.into())
         .insert("snapshots".to_owned(), snapshots_cmd_def.into());
 
     run_cli_command(cmd_def.into());
+
 }