<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Network :: FirmwareCI</title><link>https://docs.firmware-ci.com/references/2_commands/network/index.html</link><description>Network connectivity and testing commands.
Ping</description><generator>Hugo</generator><language>en-us</language><atom:link href="https://docs.firmware-ci.com/references/2_commands/network/index.xml" rel="self" type="application/rss+xml"/><item><title>Ping</title><link>https://docs.firmware-ci.com/references/2_commands/network/ping/index.html</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.firmware-ci.com/references/2_commands/network/ping/index.html</guid><description>Run a ping on any host.
Attribute Type Required Default Description cmd const Yes ping Command Name name string Yes Name to uniquely identify the teststep. This name will show up in reports, logs and the WebUI options OptionsObject No Additional command options parameters PingOptions Yes Options passed into the ping cmd Ping Options Attribute Type Required Default Description host string Yes Hostname or IP address used for the ping. port integer No 22 Port to use for the ping. proxy PingProxyOptions No Optional proxy configuration for connecting through an intermediate host. expect PingExpectOptions No Expected result of the ping. Ping Proxy Options Attribute Type Required Default Description type string Yes Type of proxy to use. Currently only ssh is supported. host string Yes Hostname or IP address of the proxy server. port integer No 22 Port to connect to on the proxy server. ssh PingProxySSHOptions Yes (when type is ssh) SSH-specific proxy configuration. Ping Proxy SSH Options Attribute Type Required Default Description user string Yes Username for SSH authentication to the proxy. password string No Password for SSH authentication (optional if using key-based auth). identity_file string No Path to private key file for SSH authentication. timeout string No 30s Timeout for SSH connection (e.g., ’30s’, ‘5m’). Ping Expect Options Attribute Type Required Default Description should_fail boolean No false Expect the port to stay closed for the whole step timeout. The step fails at the first connection that the port accepts. Through a proxy that is never reachable, the state of the port is unknown, so the step fails. Ping Examples Basic Ping cmd: ping name: Wait for the device to become online. options: timeout: 4m parameters: host: "[[attributes.Host]]" Port stays closed options.timeout sets how long the port must stay closed:</description></item></channel></rss>