tmux_identity
Observe a Linux process incarnation using its PID, boot ID and start ticks.
Source and package
- Qualified name
-
tmux_identity - Package
- libtmux_erlang
- Source
- apps/libtmux_erlang/src/tmux_identity.erl
- tmux_identity
-
Description#
A successful check is an observation. It neither reserves a PID nor pins a tmux connection, and it never authorizes signalling a process. Endpoint owners in
tmux_servercompare the PID returned by the current connection as well. A server can still change between this check and a later one-shot command.Use
fingerprint/1to compare captured incarnations across endpoint handles or persist that comparison in a plan. It performs no process observation; the key grants neither liveness nor permission to act.Examples#
1> Pid = list_to_integer(os:getpid()), ok.ok2> {ok, Identity} = tmux_identity:observe(Pid), ok.ok3> tmux_identity:check(Identity, Pid).ok
Members5#
Common operations1#
- fingerprint/1 function Derive a portable
fingerprint/0from a captured identity without I/O.
Other members4#
- check/2 function Re-observe the PID and compare its incarnation token. A successful result is a momentary observation, not ownership, permission to signal, or a same-connection guarantee.
- fingerprint/0 typealias Versioned SHA-256 comparison key for a captured Linux process incarnation. The linux-v1 prefix identifies the canonical encoding, independent of Erlang term serialization. Keys compare identity observations, not endpoint ownership or current liveness. They are identifiers, not authentication tokens.
- observe/1 function Observe a Linux PID incarnation without signalling it. Returns a tagged error if the process cannot be identified; this performs local operating-system I/O.
- t/0 typealias Observed Linux PID, boot identity and process-start token. It does not pin a connection.
Guides#
Pages that discuss tmux_identity.