# ping - ping a host

Pings a host to make sure it’s up. Uses a Python ping module instead of calling out to an external app, but needs to be run as root.

host
  Type:

    string

  Required:

    true

  the hostname or IP to ping

timeout
  Type:

    int

  Required:

    false

  Default:

    `5`

  the timeout for the ping in seconds

count
  Type:

    int

  Required:

    false

  Default:

    `1`

  the number of pings to send