bionic (5) ods-timing.5.gz

Provided by: opendnssec-common_2.1.3-0.2build1_all bug

NAME

       ods-timing - OpenDNSSEC timing specification

SYNOPSIS

       /etc/opendnssec/conf.xml
       /etc/opendnssec/kasp.xml
       /etc/opendnssec/zonelist.xml

DESCRIPTION

       The  configuration  files  of  OpenDNSSEC  need  to have timing descriptions, notably for periods.  These
       descriptions follow ISO 8601 with exceptions for the duration of a month and a  year,  as  these  periods
       would be allowed to vary if ISO 8601 were strictly adhered to.

       Durations are represented by the format P[n]Y[n]M[n]DT[n]H[n]M[n]S.  In these representations, the [n] is
       replaced by the value for each of the date and time elements that follow the [n]. Leading zeros  are  not
       required.  The capital letters P, Y, M, W, D, T, H, M and S are designators for each of the date and time
       elements and are not replaced

       P      is the duration designator (historically called "period") placed at  the  start  of  the  duration
              representation.

       Y      is the year designator that follows the value for the number of years.

       M      is the month designator that follows the value for the number of months.

       W      is the week designator that follows the value for the number of weeks.

       D      is the day designator that follows the value for the number of days.

       T      is the time designator that precedes the time components of the representation.

       H      is the hour designator that follows the value for the number of hours.

       M      is the minute designator that follows the value for the number of minutes.

       S      is the second designator that follows the value for the number of seconds.

       For example, P3Y6M4DT12H30M5S represents a duration of "three years, six months, four days, twelve hours,
       thirty minutes, and five seconds". Date and time elements including their designator may  be  omitted  if
       their  value  is  zero,  and lower order elements may also be omitted for reduced precision. For example,
       P23DT23H and P4Y are both acceptable duration representations.

EXCEPTION

       A year or month vary in duration depending on the current date. For OpenDNSSEC, we assume fixed values.

       One month
              is assumed to be 31 days.

       One year
              is assumed to be 365 days.

       This exception may or may not change in future releases  of  OpenDNSSEC.   The  reason  for  making  this
       exception is to avoid complicating this software in a way that may not meet any practical need.

SEE ALSO

       ods-control(8),    ods-enforcerd(8),   ods-enforcer(8),   ods-signerd(8),   ods-signer(8),   ods-kasp(5),
       ods-kaspcheck(1),   ods-timing(5),   ods-hsmspeed(1),   ods-hsmutil(1),    opendnssec(7),    ISO    8601,
       http://www.opendnssec.org/

AUTHORS

       OpenDNSSEC was made by the OpenDNSSEC project, to be found on http://www.opendnssec.org/