use std::sync::atomic::{AtomicUsize, Ordering}; use anyhow::{bail, Error}; use proxmox::api::schema::{ApiStringFormat, Schema, StringSchema}; use proxmox::const_regex; use proxmox::sys::linux::procfs; use crate::api2::types::Userid; /// Unique Process/Task Identifier /// /// We use this to uniquely identify worker task. UPIDs have a short /// string repesentaion, which gives additional information about the /// type of the task. for example: /// ```text /// UPID:{node}:{pid}:{pstart}:{task_id}:{starttime}:{worker_type}:{worker_id}:{userid}: /// UPID:elsa:00004F37:0039E469:00000000:5CA78B83:garbage_collection::root@pam: /// ``` /// Please note that we use tokio, so a single thread can run multiple /// tasks. // #[api] - manually implemented API type #[derive(Debug, Clone)] pub struct UPID { /// The Unix PID pub pid: libc::pid_t, /// The Unix process start time from `/proc/pid/stat` pub pstart: u64, /// The task start time (Epoch) pub starttime: i64, /// The task ID (inside the process/thread) pub task_id: usize, /// Worker type (arbitrary ASCII string) pub worker_type: String, /// Worker ID (arbitrary ASCII string) pub worker_id: Option, /// The user who started the task pub userid: Userid, /// The node name. pub node: String, } proxmox::forward_serialize_to_display!(UPID); proxmox::forward_deserialize_to_from_str!(UPID); const_regex! { pub PROXMOX_UPID_REGEX = concat!( r"^UPID:(?P[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?):(?P[0-9A-Fa-f]{8}):", r"(?P[0-9A-Fa-f]{8,9}):(?P[0-9A-Fa-f]{8,16}):(?P[0-9A-Fa-f]{8}):", r"(?P[^:\s]+):(?P[^:\s]*):(?P[^:\s]+):$" ); } pub const PROXMOX_UPID_FORMAT: ApiStringFormat = ApiStringFormat::Pattern(&PROXMOX_UPID_REGEX); impl UPID { pub const API_SCHEMA: Schema = StringSchema::new("Unique Process/Task Identifier") .min_length("UPID:N:12345678:12345678:12345678:::".len()) .max_length(128) // arbitrary .format(&PROXMOX_UPID_FORMAT) .schema(); /// Create a new UPID pub fn new( worker_type: &str, worker_id: Option, userid: Userid, ) -> Result { let pid = unsafe { libc::getpid() }; let bad: &[_] = &['/', ':', ' ']; if worker_type.contains(bad) { bail!("illegal characters in worker type '{}'", worker_type); } static WORKER_TASK_NEXT_ID: AtomicUsize = AtomicUsize::new(0); let task_id = WORKER_TASK_NEXT_ID.fetch_add(1, Ordering::SeqCst); Ok(UPID { pid, pstart: procfs::PidStat::read_from_pid(nix::unistd::Pid::from_raw(pid))?.starttime, starttime: proxmox::tools::time::epoch_i64(), task_id, worker_type: worker_type.to_owned(), worker_id, userid, node: proxmox::tools::nodename().to_owned(), }) } /// Returns the absolute path to the task log file pub fn log_path(&self) -> std::path::PathBuf { let mut path = std::path::PathBuf::from(super::PROXMOX_BACKUP_TASK_DIR); path.push(format!("{:02X}", self.pstart % 256)); path.push(self.to_string()); path } } impl std::str::FromStr for UPID { type Err = Error; fn from_str(s: &str) -> Result { if let Some(cap) = PROXMOX_UPID_REGEX.captures(s) { let worker_id = if cap["wid"].is_empty() { None } else { let wid = crate::tools::systemd::unescape_unit(&cap["wid"])?; Some(wid) }; Ok(UPID { pid: i32::from_str_radix(&cap["pid"], 16).unwrap(), pstart: u64::from_str_radix(&cap["pstart"], 16).unwrap(), starttime: i64::from_str_radix(&cap["starttime"], 16).unwrap(), task_id: usize::from_str_radix(&cap["task_id"], 16).unwrap(), worker_type: cap["wtype"].to_string(), worker_id, userid: cap["userid"].parse()?, node: cap["node"].to_string(), }) } else { bail!("unable to parse UPID '{}'", s); } } } impl std::fmt::Display for UPID { fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { let wid = if let Some(ref id) = self.worker_id { crate::tools::systemd::escape_unit(id, false) } else { String::new() }; // Note: pstart can be > 32bit if uptime > 497 days, so this can result in // more that 8 characters for pstart write!(f, "UPID:{}:{:08X}:{:08X}:{:08X}:{:08X}:{}:{}:{}:", self.node, self.pid, self.pstart, self.task_id, self.starttime, self.worker_type, wid, self.userid) } }