GDP

.Dd September 18, 2015

.Dt LOG-EXISTS 1

.Os Swarm-GDP

.Sh NAME

.Nm log-exists

.Nd test to see if a log exists

.Sh SYNOPSIS

.Nm

.Op Fl D Ar debug-spec

.Op Fl G Ar router-ip

.Ar log-name

.Sh DESCRIPTION

.Nm

tests to see if the given

.Ar log-name

can be opened and returns an appropriate exit status.

It never prints anything.

.Nm

is only useful in shell scripts.

.Sh OPTIONS

.Bl -tag

.It Fl D Ar debug-spec

Turns on debugging flags using the libep-style format.

Useful only with the code in hand.

.It Fl G Ar router-ip

Contact the given IP address (which may be a DNS name)

to get a connection to the GDP routing layer.

This will be replaced by automatic discovery

(for example, using Zeroconf)

soon.

The address may have an optional port number after a colon.

If this is not specified,

the names listed in the

.Va swarm.gdp.routers

runtime administrative parameter

are searched.

.El

.Sh EXIT STATUS

.Bl -tag

.It Li EX_UNAVAILABLE

There was some failure during startup.

.It Li EX_USAGE

Command line parameters are incorrect.

.It Li EX_OK

The log exists.

.It Li EX_NOINPUT

The log does not exist.

.El

.\".Sh ADMINISTRATIVE PARAMETERS

.\".Sh ENVIRONMENT

.\".Sh FILES

.\".Sh SEE ALSO

.\".Xr gdp 7 ,

.\".Xr gdplogd 8

.\".Sh EXAMPLES

.\".Sh BUGS