//! Tools and utilities //! //! This is a collection of small and useful tools. use anyhow::{bail, Error}; use proxmox_http::{client::Client, HttpOptions, ProxyConfig}; pub mod config; pub mod disks; pub mod fs; mod shared_rate_limiter; pub use shared_rate_limiter::SharedRateLimiter; pub mod statistics; pub mod systemd; pub mod ticket; pub mod parallel_handler; pub fn assert_if_modified(digest1: &str, digest2: &str) -> Result<(), Error> { if digest1 != digest2 { bail!("detected modified configuration - file changed by other user? Try again."); } Ok(()) } /// Detect modified configuration files /// /// This function fails with a reasonable error message if checksums do not match. pub fn detect_modified_configuration_file( digest1: &[u8; 32], digest2: &[u8; 32], ) -> Result<(), Error> { if digest1 != digest2 { bail!("detected modified configuration - file changed by other user? Try again."); } Ok(()) } /// The default 2 hours are far too long for PBS pub const PROXMOX_BACKUP_TCP_KEEPALIVE_TIME: u32 = 120; pub const DEFAULT_USER_AGENT_STRING: &str = "proxmox-backup-client/1.0"; /// Returns a new instance of [`Client`] configured for PBS usage. pub fn pbs_simple_http(proxy_config: Option) -> Client { let options = HttpOptions { proxy_config, user_agent: Some(DEFAULT_USER_AGENT_STRING.to_string()), tcp_keepalive: Some(PROXMOX_BACKUP_TCP_KEEPALIVE_TIME), }; Client::with_options(options) } pub fn setup_safe_path_env() { std::env::set_var("PATH", "/sbin:/bin:/usr/sbin:/usr/bin"); // Make %ENV safer - as suggested by https://perldoc.perl.org/perlsec.html for name in &["IFS", "CDPATH", "ENV", "BASH_ENV"] { std::env::remove_var(name); } }