.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "BLINKENLIGHTS.CONF 5"
.TH BLINKENLIGHTS.CONF 5 "2012-06-18" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
.Vb 2
\&    blinkenlights.conf \- Configuration file for the DNSSEC\-Tools B<blinkenlights>
\&program.
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This file contains configuration information for the DNSSEC-Tools
\&\fBblinkenlights\fR program.  These configuration data are used as default
values The \fBconf.pm\fR module is used to parse this configuration file.
.PP
A line in this file contains either a comment or a configuration
entry.  Comment lines start with either a '#' character or a ';' character.
Comment lines and blank lines are ignored by the DNSSEC-Tools programs.
.PP
Configuration entries are in a \fIkeyword/value\fR format.  The keyword is a
character string that contains no whitespace.  The value is a tokenized list
of the remaining character groups, with each token separated by a single space.
.PP
True/false flags must be given a true or false value.
True values are:  1, \*(L"yes\*(R", \*(L"on\*(R".
False values are:  0, \*(L"no\*(R", \*(L"off\*(R".
.SH "Configuration Records"
.IX Header "Configuration Records"
The following records are recognized by \fBblinkenlights\fR.
.IP "colors" 4
.IX Item "colors"
Toggle indicating whether or not to use different background colors for
\&\fBblinkenlights\fR zone stripes.
If on, different colors will be used.
If off, the \fIskipcolor\fR value will be used.
.IP "fontsize" 4
.IX Item "fontsize"
The font size used to display information in the \fBblinkenlights\fR window.
If this is not specified, the default font size is 18.
.IP "modify" 4
.IX Item "modify"
Toggle indicating whether or not to allow access to \fBblinkenlights\fR'
zone-modification commands.  These commands are the \s-1GUI\s0's front-end to
some of \fBrollerd\fR's commands.
If on, the commands are enabled.
If off, the commands are disabled.
.IP "shading" 4
.IX Item "shading"
Toggle indicating whether or not to use color shading in \fBblinkenlights\fR'
status column.
If on, shading is enabled.
If off, shading is disabled.
.IP "showskip" 4
.IX Item "showskip"
Toggle indicating whether or not to display skipped zones in \fBblinkenlights\fR'
window.
If on, skipped zones are displayed.
If off, skipped zones are not displayed.
.IP "skipcolor" 4
.IX Item "skipcolor"
The background color to use in displaying skipped zones.
If this is not specified, the default color is grey.
.SH "Example File"
.IX Header "Example File"
The following is an example \fBblinkenlights.conf\fR configuration file.
.PP
.Vb 10
\&    #
\&    # DNSSEC\-Tools configuration file for blinkenlights
\&    #
\&    #   Recognized values:
\&    #           colors          use different colors for stripes (toggle)
\&    #           fontsize        size of demo output font
\&    #           modify          allow modification commands (toggle)
\&    #           shading         shade the status columns (toggle)
\&    #           showskip        show skipped zones (toggle)
\&    #           skipcolor       color to use for skip records
\&
\&    fontsize            24
\&    modify              no
\&
\&    colors              on
\&    skipcolor           orange
\&    showskip            1
\&    shading             yes
.Ve
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright 2006\-2012 \s-1SPARTA\s0, Inc.  All rights reserved.
See the \s-1COPYING\s0 file included with the DNSSEC-Tools package for details.
.SH "AUTHOR"
.IX Header "AUTHOR"
Wayne Morrison, tewok@tislabs.com
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fB\f(BIblinkenlights\fB\|(8)\fR,
\&\fB\f(BIrollerd\fB\|(8)\fR
.PP
\&\fB\f(BINet::DNS::SEC::Tools::conf.pm\fB\|(3)\fR