Module daemon 

Daemon implementation

Modules

grid 🔒

Spatial grid model of the client windows.

workspace 🔒

Structs

Client 🔒

Representation of a client

Clients 🔒

Collection of Clients maintaining insertion order and a PID-indexed lookup table.

Daemon 🔒

The daemon is responsible to launch a client for each host, positioning the client windows, forwarding input records to all clients and handling control mode.

HWNDWrapper 🔒

Hacky wrapper around a window handle.

Enums

ControlModeAction 🔒

Top-level control-mode action a keystroke classifies into.

ControlModeState 🔒

Enum of all possible control mode states.

EnableDisableSubmenuAction 🔒

Enable/disable-submenu action a keystroke classifies into.

NavigationDirection 🔒

Direction of a navigation keystroke inside the enable/disable submenu.

Constants

MODIFIER_MASK 🔒

Bits in KEY_EVENT_RECORD::dwControlKeyState that represent “real” modifier keys (Ctrl / Alt / Shift) as opposed to lock toggles (CAPSLOCK_ON, NUMLOCK_ON, SCROLLLOCK_ON) or the ENHANCED_KEY flag.

SENDER_CAPACITY 🔒

The capacity of the broadcast channel used to send the input records read from the console input buffer to the named pipe servers connected to each client in parallel.

Functions

arrange_client_window 🔒

Re-sizes and re-positions the given client window based on the total number of clients, the size of the daemon console window and its index relative to the other client windows.

build_client_grid 🔒

Build a ClientGrid from clients and workspace_area using the same aspect-ratio expression the tiler uses.

classify_control_mode_key 🔒

Classifies a top-level control-mode keystroke.

classify_enable_disable_submenu_key 🔒

Classifies an enable/disable-submenu keystroke.

defer_windows 🔒

Move all given windows to the foreground.

determine_client_spatial_attributes 🔒

Calculates the position and dimensions for a client window given its index, the total number of clients and the aspect_ratio_adjustment daemon configuration.

ensure_client_z_order_in_sync_with_daemon 🔒

Spawns a background thread that ensures the z-order of all client windows is in sync with the daemon window. I.e. if the daemon window is focussed, all clients should be moved to the foreground.

expand_hosts

Resolve cluster tags in hosts and expand brace expressions (e.g. host{1..3}.local) in each resulting hostname.

get_console_rect 🔒

Transform the position and dimensions of a console window based on the workspace area.

get_console_window_wrapper 🔒

Returns a window handle to the current console window.

get_foreground_window_wrapper 🔒

Returns a window handle to the foreground window.

launch_client_console 🔒

Launchs a client console process with its own window with the given CLI arguments/options: host, username, port, debug.

launch_clients 🔒

Launches a client console for each given host and waits for the client windows to exist before returning their handles.

main

The entrypoint for the daemon subcommand.

named_pipe_server_routine 🔒

Correlate the connecting client by PID, then multiplex input records, ClientState updates, and keep-alives onto the named pipe.

next_submenu_selection 🔒

Compute the next submenu selection given a grid step.

probe_pipe_alive 🔒

Best-effort, non-blocking probe of the named pipe.

read_client_pid 🔒

Read the connecting client’s 4 byte little-endian process id from the pipe.

resolve_cluster_tags

Resolve cluster tags into hostnames

restore_if_minimized 🔒

Restore window_handle if its current placement reports minimized.

toggle_processed_input_mode 🔒

The processed console input mode controls whether special key combinations such as Ctrl + c or Ctrl + BREAK receive special handling or are treated as simple key presses.

workspace_aspect_ratio 🔒

Return the workspace area’s aspect ratio (width / height) including the frame padding the tiler accounts for.

write_framed_message 🔒

Write all of frame to the named pipe server, retrying partial writes and WouldBlock results until the buffer is fully drained.