[[PageOutline(2-5,Contents,pullout)]]

= Check if host/port is open

== Description

This is a macro to check if a given host/port is open. The macro needs to be added to your Trac wiki page, see below for an example. It supports basic caching with a timeout. It does not support ICMP pings.

To use:
{{{
[[ServerDown(host, port, timeout)]]
}}}

== Bugs/Feature Requests

Existing bugs and feature requests for ServerDownMacro are 
[report:9?COMPONENT=ServerDownMacro here].

If you have any issues, create a 
[/newticket?component=ServerDownMacro new ticket].

[[TicketQuery(component=ServerDownMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:serverdownmacro here].

There is also a version on [pypi:TracServerDownMacro PyPi].

== Source

You can check out ServerDownMacro from [/svn/serverdownmacro here] using Subversion, or [source:serverdownmacro browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

To enable add the following to your `trac.ini` file:
{{{#!ini
[components]
serverdownmacro.* = enabled
}}}

== Recent Changes

[[ChangeLog(serverdownmacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:coderanger] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''