mirror of
https://git.proxmox.com/git/proxmox
synced 2025-05-23 06:14:02 +00:00
use UPID and systemd helpers from proxmox 0.13.4
This commit is contained in:
parent
ecb6b64f18
commit
59c7c360e8
@ -14,7 +14,7 @@ openssl = "0.10"
|
|||||||
regex = "1.2"
|
regex = "1.2"
|
||||||
serde = { version = "1.0", features = ["derive"] }
|
serde = { version = "1.0", features = ["derive"] }
|
||||||
|
|
||||||
proxmox = { version = "0.13.3", default-features = false, features = [ "api-macro" ] }
|
proxmox = { version = "0.13.4", default-features = false, features = [ "api-macro" ] }
|
||||||
|
|
||||||
proxmox-systemd = { path = "../proxmox-systemd" }
|
proxmox-systemd = { path = "../proxmox-systemd" }
|
||||||
pbs-tools = { path = "../pbs-tools" }
|
pbs-tools = { path = "../pbs-tools" }
|
||||||
|
@ -4,7 +4,7 @@ use serde::{Deserialize, Serialize};
|
|||||||
use anyhow::bail;
|
use anyhow::bail;
|
||||||
|
|
||||||
use proxmox::api::api;
|
use proxmox::api::api;
|
||||||
use proxmox::api::schema::{ApiStringFormat, ArraySchema, Schema, StringSchema};
|
use proxmox::api::schema::{ApiStringFormat, ApiType, ArraySchema, Schema, StringSchema, ReturnType};
|
||||||
use proxmox::const_regex;
|
use proxmox::const_regex;
|
||||||
use proxmox::{IPRE, IPRE_BRACKET, IPV4OCTET, IPV4RE, IPV6H16, IPV6LS32, IPV6RE};
|
use proxmox::{IPRE, IPRE_BRACKET, IPV4OCTET, IPV4RE, IPV6H16, IPV6LS32, IPV6RE};
|
||||||
|
|
||||||
@ -60,8 +60,7 @@ pub use userid::{PROXMOX_GROUP_ID_SCHEMA, PROXMOX_TOKEN_ID_SCHEMA, PROXMOX_TOKEN
|
|||||||
mod user;
|
mod user;
|
||||||
pub use user::*;
|
pub use user::*;
|
||||||
|
|
||||||
pub mod upid;
|
pub use proxmox::api::upid::*;
|
||||||
pub use upid::*;
|
|
||||||
|
|
||||||
mod crypto;
|
mod crypto;
|
||||||
pub use crypto::{CryptMode, Fingerprint};
|
pub use crypto::{CryptMode, Fingerprint};
|
||||||
@ -397,3 +396,57 @@ pub enum NodePowerCommand {
|
|||||||
/// Shutdown the server
|
/// Shutdown the server
|
||||||
Shutdown,
|
Shutdown,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
#[api()]
|
||||||
|
#[derive(Eq, PartialEq, Debug, Serialize, Deserialize)]
|
||||||
|
#[serde(rename_all = "lowercase")]
|
||||||
|
pub enum TaskStateType {
|
||||||
|
/// Ok
|
||||||
|
OK,
|
||||||
|
/// Warning
|
||||||
|
Warning,
|
||||||
|
/// Error
|
||||||
|
Error,
|
||||||
|
/// Unknown
|
||||||
|
Unknown,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[api(
|
||||||
|
properties: {
|
||||||
|
upid: { schema: UPID::API_SCHEMA },
|
||||||
|
},
|
||||||
|
)]
|
||||||
|
#[derive(Serialize, Deserialize)]
|
||||||
|
/// Task properties.
|
||||||
|
pub struct TaskListItem {
|
||||||
|
pub upid: String,
|
||||||
|
/// The node name where the task is running on.
|
||||||
|
pub node: String,
|
||||||
|
/// The Unix PID
|
||||||
|
pub pid: i64,
|
||||||
|
/// The task start time (Epoch)
|
||||||
|
pub pstart: u64,
|
||||||
|
/// The task start time (Epoch)
|
||||||
|
pub starttime: i64,
|
||||||
|
/// Worker type (arbitrary ASCII string)
|
||||||
|
pub worker_type: String,
|
||||||
|
/// Worker ID (arbitrary ASCII string)
|
||||||
|
pub worker_id: Option<String>,
|
||||||
|
/// The authenticated entity who started the task
|
||||||
|
pub user: String,
|
||||||
|
/// The task end time (Epoch)
|
||||||
|
#[serde(skip_serializing_if="Option::is_none")]
|
||||||
|
pub endtime: Option<i64>,
|
||||||
|
/// Task end status
|
||||||
|
#[serde(skip_serializing_if="Option::is_none")]
|
||||||
|
pub status: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
pub const NODE_TASKS_LIST_TASKS_RETURN_TYPE: ReturnType = ReturnType {
|
||||||
|
optional: false,
|
||||||
|
schema: &ArraySchema::new(
|
||||||
|
"A list of tasks.",
|
||||||
|
&TaskListItem::API_SCHEMA,
|
||||||
|
).schema(),
|
||||||
|
};
|
||||||
|
@ -1,204 +0,0 @@
|
|||||||
use std::sync::atomic::{AtomicUsize, Ordering};
|
|
||||||
|
|
||||||
use anyhow::{bail, Error};
|
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
use proxmox::api::api;
|
|
||||||
use proxmox::api::schema::{ApiStringFormat, ApiType, Schema, StringSchema, ArraySchema, ReturnType};
|
|
||||||
use proxmox::const_regex;
|
|
||||||
use proxmox::sys::linux::procfs;
|
|
||||||
|
|
||||||
/// 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<String>,
|
|
||||||
/// The authenticated entity who started the task
|
|
||||||
pub auth_id: String,
|
|
||||||
/// 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<node>[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?):(?P<pid>[0-9A-Fa-f]{8}):",
|
|
||||||
r"(?P<pstart>[0-9A-Fa-f]{8,9}):(?P<task_id>[0-9A-Fa-f]{8,16}):(?P<starttime>[0-9A-Fa-f]{8}):",
|
|
||||||
r"(?P<wtype>[^:\s]+):(?P<wid>[^:\s]*):(?P<authid>[^:\s]+):$"
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
pub const PROXMOX_UPID_FORMAT: ApiStringFormat =
|
|
||||||
ApiStringFormat::Pattern(&PROXMOX_UPID_REGEX);
|
|
||||||
|
|
||||||
pub const UPID_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();
|
|
||||||
|
|
||||||
impl ApiType for UPID {
|
|
||||||
const API_SCHEMA: Schema = UPID_SCHEMA;
|
|
||||||
}
|
|
||||||
|
|
||||||
impl UPID {
|
|
||||||
/// Create a new UPID
|
|
||||||
pub fn new(
|
|
||||||
worker_type: &str,
|
|
||||||
worker_id: Option<String>,
|
|
||||||
auth_id: String,
|
|
||||||
) -> Result<Self, Error> {
|
|
||||||
|
|
||||||
let pid = unsafe { libc::getpid() };
|
|
||||||
|
|
||||||
let bad: &[_] = &['/', ':', ' '];
|
|
||||||
|
|
||||||
if worker_type.contains(bad) {
|
|
||||||
bail!("illegal characters in worker type '{}'", worker_type);
|
|
||||||
}
|
|
||||||
|
|
||||||
if auth_id.contains(bad) {
|
|
||||||
bail!("illegal characters in auth_id '{}'", auth_id);
|
|
||||||
}
|
|
||||||
|
|
||||||
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,
|
|
||||||
auth_id,
|
|
||||||
node: proxmox::tools::nodename().to_owned(),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
impl std::str::FromStr for UPID {
|
|
||||||
type Err = Error;
|
|
||||||
|
|
||||||
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
|
||||||
if let Some(cap) = PROXMOX_UPID_REGEX.captures(s) {
|
|
||||||
|
|
||||||
let worker_id = if cap["wid"].is_empty() {
|
|
||||||
None
|
|
||||||
} else {
|
|
||||||
let wid = proxmox_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,
|
|
||||||
auth_id: cap["authid"].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 {
|
|
||||||
proxmox_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.auth_id)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[api()]
|
|
||||||
#[derive(Eq, PartialEq, Debug, Serialize, Deserialize)]
|
|
||||||
#[serde(rename_all = "lowercase")]
|
|
||||||
pub enum TaskStateType {
|
|
||||||
/// Ok
|
|
||||||
OK,
|
|
||||||
/// Warning
|
|
||||||
Warning,
|
|
||||||
/// Error
|
|
||||||
Error,
|
|
||||||
/// Unknown
|
|
||||||
Unknown,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[api(
|
|
||||||
properties: {
|
|
||||||
upid: { schema: UPID::API_SCHEMA },
|
|
||||||
},
|
|
||||||
)]
|
|
||||||
#[derive(Serialize, Deserialize)]
|
|
||||||
/// Task properties.
|
|
||||||
pub struct TaskListItem {
|
|
||||||
pub upid: String,
|
|
||||||
/// The node name where the task is running on.
|
|
||||||
pub node: String,
|
|
||||||
/// The Unix PID
|
|
||||||
pub pid: i64,
|
|
||||||
/// The task start time (Epoch)
|
|
||||||
pub pstart: u64,
|
|
||||||
/// The task start time (Epoch)
|
|
||||||
pub starttime: i64,
|
|
||||||
/// Worker type (arbitrary ASCII string)
|
|
||||||
pub worker_type: String,
|
|
||||||
/// Worker ID (arbitrary ASCII string)
|
|
||||||
pub worker_id: Option<String>,
|
|
||||||
/// The authenticated entity who started the task
|
|
||||||
pub user: String,
|
|
||||||
/// The task end time (Epoch)
|
|
||||||
#[serde(skip_serializing_if="Option::is_none")]
|
|
||||||
pub endtime: Option<i64>,
|
|
||||||
/// Task end status
|
|
||||||
#[serde(skip_serializing_if="Option::is_none")]
|
|
||||||
pub status: Option<String>,
|
|
||||||
}
|
|
||||||
|
|
||||||
pub const NODE_TASKS_LIST_TASKS_RETURN_TYPE: ReturnType = ReturnType {
|
|
||||||
optional: false,
|
|
||||||
schema: &ArraySchema::new(
|
|
||||||
"A list of tasks.",
|
|
||||||
&TaskListItem::API_SCHEMA,
|
|
||||||
).schema(),
|
|
||||||
};
|
|
Loading…
Reference in New Issue
Block a user