← Back to StaxPing Index

Flags & Options

StaxPing includes a small set of command‑line flags designed to keep the interface predictable and easy to use.
This page explains each flag, its purpose, and how it affects StaxPing’s behavior.

---

–trace

Enables the traceroute module.

Example:

staxping example.com --trace

When enabled, StaxPing performs:

1. DNS lookup
2. ICMP ping
3. HTTP health check
4. Traceroute (hop‑by‑hop routing)

If traceroute is not supported on the system, StaxPing provides a clear fallback message without exiting unexpectedly.

---

–advanced (Reserved)

The --advanced flag is reserved for future diagnostic features.

Current behavior:

• The flag is accepted
• It does not modify output
• It ensures forward compatibility for upcoming modules

Example:

staxping example.com --advanced

Future versions may introduce extended diagnostics under this flag.

---

–help

Displays the help screen, including usage, flags, and argument descriptions.

Example:

staxping --help

The help output follows a clean, aligned format for readability.

---

Future Flags

StaxPing is designed to grow over time.
Planned or potential future flags may include:

• extended diagnostics
• output formatting controls
• module‑specific toggles
• JSON or machine‑readable output
• timeout or retry controls

These features will be documented as they are introduced.

---

Examples

Basic usage

staxping google.com

With traceroute

staxping google.com --trace

With reserved advanced mode

staxping google.com --advanced

Help

staxping --help

---

StaxPing keeps its flag system intentionally small and predictable, ensuring a clean and consistent CLI experience.

---