Module binaries 

Provides the binaries module.

Examples

use pharos_native::binaries;

Related

• crate::artifact_server for the packaged artifact HTTP surface.
• crate::runtime for the host runtime entrypoints those binaries expose.

Enums

BinaryTarget

Public enum BinaryTarget used by this module.

Constants

BINARY_TARGETS

Public constant BINARY_TARGETS exposed by this module.

MODULE_STATUS

Public constant MODULE_STATUS exposed by this module.

Functions

accept_http_request

Accepts one bounded TCP connection from a listener.

add_runtime_app

Adds an app to a runtime stack while rejecting duplicate app identifiers.

app_ops_backend

Resolves the configured app-ops backend without inventing a default.

app_root_has_finalized_artifact

Confirms that a finalized artifact manifest exists below an app root.

app_runtime_conf_required_present

Confirms that the app runtime configuration contract is present.

app_runtime_report_id

Returns the stable app runtime report identifier.

build_known_website

Builds a deterministic known-website descriptor.

build_migrate_operation_report_json

Builds a migration report from a resolved app runtime.

build_worker_context

Builds the bounded worker context copied into request workers.

clamp_size_value

Clamps one size to an explicit inclusive range.

cleanup_active_listener

Closes an active listener by consuming its owned handle.

clear_listener_cleanup_registration

Clears a listener cleanup registration after the listener has been consumed.

conf_positive_size_value

Returns a positive configured size, bounded to the native worker limits.

declared_binary_targets

Returns the declared binary targets owned by this crate.

default_work_queue_capacity

Returns the default bounded request queue capacity.

default_worker_count

Returns the default worker count for a runtime configuration.

detect_physical_memory_bytes

Returns physical memory when an in-process platform provider exposes it.

emit_report_json

Encodes one report value as bounded JSON text.

emit_runtime_path_helper_json

Emits a runtime path helper report.

emit_text_file_to_stdout

Writes a bounded text file to stdout as a string result.

emit_website_status

Emits website status as a bounded JSON report.

executable_dir_from_argv0

Returns the current executable directory for an argv0-style input.

executable_path

Returns the path to the launcher binary for a configured executable.

explicit_binary_dir_override

Returns a validated explicit binary-directory override.

explicit_repo_root_override

Returns a validated explicit repository-root override.

export_relational_state_for_app_ops

Exports relational state for app operations through the native adapter.

find_repo_root

Finds the repository root containing the canonical app and script directories.

find_serve_handler

Returns whether one argument sequence names a serve handler.

free_worker_context

Releases an owned worker context.

handle_app_or_runtime_request

Routes one request to a matched app or framework builtin handler.

handle_backup_restore_ops_command

Handles operational commands through validated runtime arguments.

handle_deploy_check_ops_command

Handles deploy check ops command.

handle_drift_check_ops_command

Handles drift check ops command.

handle_framework_builtin_request

Handles framework-owned health/version endpoints directly.

handle_helper_command

Handles helper commands without invoking a shell.

handle_integrations_command

Handles the integrations command family through the persisted state report.

handle_job_command

Handles one job command for a persisted state root.

handle_jobs_command

Handles the jobs command family through the persisted state report.

handle_migrate_command

Handles the migration command using the resolved app configuration.

handle_noindex_command

Handles noindex marker creation through the native filesystem implementation.

handle_ops_command

Handles ops command.

handle_runtime_app_command

Dispatches an app-scoped runtime command.

handle_runtime_command

Dispatches a runtime command against the direct Rust runtime implementation.

handle_serve

Dispatches the direct serve boundary for app or shared runtime targets.

handle_website_command

Handles website commands without shell or C fallback behavior.

http_parse_error_body

Extracts a bounded HTTP error body from a response document.

http_parse_reason_phrase

Returns a stable HTTP reason phrase for a status code.

import_relational_state_for_app_ops

Imports relational state for app operations through the native adapter.

install_signal_handlers

Installs no process-global signal handlers; callers use explicit shutdown tokens.

known_website_supported

Reports whether a website identifier is one of the supported declarative roots.

load_app_runtime_for_single_app

Loads one app runtime from its packaged artifact directory.

load_runtime_stack

Loads the shared runtime stack through the native runtime loader.

maybe_seed_app_state

Seeds a missing state file only when the caller explicitly requests seeding.

option_value

Returns one exact command-line option value.

parse_app_ops_config

Parses an app-ops JSON configuration document.

parse_positive_size_value

Parses a positive size with a safe default and upper bound.

prepare_app_ops

Validates app-ops prerequisites without mutating app state.

prepare_finalized_app_from_config

Prepares a finalized app runtime from a resolved app directory and config.

print_help

Returns the stable native help text used by the primary launcher.

print_version

Returns the package version exposed by the primary launcher.

process_single_stream_app_request

Processes one app request using the direct static artifact server.

process_single_stream_runtime_request

Processes one shared-runtime request through the selected app stack.

process_worker_context

Writes an explicit process-context report without signal-handler side effects.

register_listener_cleanup

Registers a listener cleanup token with its bound endpoint.

resolve_launcher_binary_dir

Resolves the directory containing the current Rust launcher binary.

resolve_runtime_socket_path

Resolves a Unix socket path for a runtime target.

resolve_value_or_default

Returns a non-empty runtime value or a supplied default.

resolve_website_root

Resolves the website root below a trusted repository root.

resolved_work_queue_capacity

Resolves a configured queue capacity from the runtime environment.

resolved_worker_count

Resolves a configured worker count from the runtime environment.

runtime_app_directory_matches_id

Confirms that an app directory manifest identifies the expected app.

runtime_stack_probe_ready

Returns whether the shared runtime stack has enough state for readiness.

runtime_verb_supported

Exposes the requested runtime verb set for binary dispatch.

send_worker_pool_overload_response

Returns an overload response body without writing unbounded data.

serve_static_file

Serves one validated static request from a packaged artifact root.

serve_static_root

Serves a static root using the bounded direct listener.

serve_website_target

Performs serve website target.

trace_wasm_argv_if_requested

Traces argv only when explicitly requested, without interpreting WASI behavior.

wasi_single_stream_mode_enabled

Returns whether the WASI guest should process a single request stream.

wasi_stdio_mode_enabled

Returns whether WASI stdio mode has been explicitly enabled.

website_verb_mode

Returns the stable website mode for a supported website verb.