krb5: Import MIT 1.21.3 - src - FreeBSD source tree

diff options


context:
space:
mode:

author	Cy Schubert <cy@FreeBSD.org>	2025-03-19 22:12:25 +0000
committer	Cy Schubert <cy@FreeBSD.org>	2025-03-19 22:12:25 +0000
commit	8f7d3ef26dec89a92ec0665de84a5936310a5574 (patch)
tree	9a465418bd4056bf0d369751320a414eaed29fa4 /doc/html/basic/date_format.html
parent	1a79b20663ca26acc2998b90ea2ff2aefd8af5b1 (diff)

Diffstat (limited to 'doc/html/basic/date_format.html')

-rw-r--r--

doc/html/basic/date_format.html

232

1 files changed, 113 insertions, 119 deletions

diff --git a/doc/html/basic/date_format.html b/doc/html/basic/date_format.html
index 5c53c359914b..a32cb472515b 100644
--- a/doc/html/basic/date_format.html
+++ b/doc/html/basic/date_format.html

@@ -1,35 +1,26 @@

-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

+<!DOCTYPE html>

-<html xmlns="http://www.w3.org/1999/xhtml">

+<html>

<head>

- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

+ <meta charset="utf-8" />

+ <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

<title>Supported date and time formats — MIT Kerberos Documentation</title>

- <link rel="stylesheet" href="../_static/agogo.css" type="text/css" />

- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />

- <link rel="stylesheet" href="../_static/kerb.css" type="text/css" />

- <script type="text/javascript">

- var DOCUMENTATION_OPTIONS = {

- URL_ROOT: '../',

- VERSION: '1.21.2',

- COLLAPSE_INDEX: false,

- FILE_SUFFIX: '.html',

- HAS_SOURCE: true,

- SOURCELINK_SUFFIX: '.txt'

- };

- </script>

- <script type="text/javascript" src="../_static/jquery.js"></script>

- <script type="text/javascript" src="../_static/underscore.js"></script>

- <script type="text/javascript" src="../_static/doctools.js"></script>

+ <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />

+ <link rel="stylesheet" type="text/css" href="../_static/agogo.css" />

+ <link rel="stylesheet" type="text/css" href="../_static/kerb.css" />

+ <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>

+ <script src="../_static/jquery.js"></script>

+ <script src="../_static/underscore.js"></script>

+ <script src="../_static/doctools.js"></script>

- </head>

- <body>

+ </head><body>

@@ -61,35 +52,35 @@

- <div class="section" id="supported-date-and-time-formats">

+ <section id="supported-date-and-time-formats">

<span id="datetime"></span><h1>Supported date and time formats<a class="headerlink" href="#supported-date-and-time-formats" title="Permalink to this headline">¶</a></h1>

-<div class="section" id="time-duration">

+<section id="time-duration">

<span id="duration"></span><h2>Time duration<a class="headerlink" href="#time-duration" title="Permalink to this headline">¶</a></h2>

<p>This format is used to express a time duration in the Kerberos

configuration files and user commands. The allowed formats are:</p>

-<div><table border="1" class="docutils">

+<div><table class="docutils align-default">

-<col width="40%" />

-<col width="25%" />

-<col width="35%" />

+<col style="width: 40%" />

+<col style="width: 25%" />

+<col style="width: 35%" />

</colgroup>

-<tbody valign="top">

-<tr class="row-odd"><td>Format</td>

-<td>Example</td>

-<td>Value</td>

+<tbody>

+<tr class="row-odd"><td><p>Format</p></td>

+<td><p>Example</p></td>

+<td><p>Value</p></td>

</tr>

-<tr class="row-even"><td>h:m[:s]</td>

-<td>36:00</td>

-<td>36 hours</td>

+<tr class="row-even"><td><p>h:m[:s]</p></td>

+<td><p>36:00</p></td>

+<td><p>36 hours</p></td>

</tr>

-<tr class="row-odd"><td>NdNhNmNs</td>

-<td>8h30s</td>

-<td>8 hours 30 seconds</td>

+<tr class="row-odd"><td><p>NdNhNmNs</p></td>

+<td><p>8h30s</p></td>

+<td><p>8 hours 30 seconds</p></td>

</tr>

-<tr class="row-even"><td>N (number of seconds)</td>

-<td>3600</td>

-<td>1 hour</td>

+<tr class="row-even"><td><p>N (number of seconds)</p></td>

+<td><p>3600</p></td>

+<td><p>1 hour</p></td>

</tr>

</tbody>

</table>

@@ -97,11 +88,11 @@ configuration files and user commands. The allowed formats are:</p>

<p>Here <em>N</em> denotes a number, <em>d</em> - days, <em>h</em> - hours, <em>m</em> - minutes,

<em>s</em> - seconds.</p>

-<p class="first admonition-title">Note</p>

-<p class="last">The time interval should not exceed 2147483647 seconds.</p>

+<p class="admonition-title">Note</p>

+<p>The time interval should not exceed 2147483647 seconds.</p>

</div>

<p>Examples:</p>

-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Request</span> <span class="n">a</span> <span class="n">ticket</span> <span class="n">valid</span> <span class="k">for</span> <span class="n">one</span> <span class="n">hour</span><span class="p">,</span> <span class="n">five</span> <span class="n">hours</span><span class="p">,</span> <span class="mi">30</span> <span class="n">minutes</span>

+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Request</span> <span class="n">a</span> <span class="n">ticket</span> <span class="n">valid</span> <span class="k">for</span> <span class="n">one</span> <span class="n">hour</span><span class="p">,</span> <span class="n">five</span> <span class="n">hours</span><span class="p">,</span> <span class="mi">30</span> <span class="n">minutes</span>

<span class="ow">and</span> <span class="mi">10</span> <span class="n">days</span> <span class="n">respectively</span><span class="p">:</span>

<span class="n">kinit</span> <span class="o">-</span><span class="n">l</span> <span class="mi">3600</span>

@@ -110,62 +101,62 @@ configuration files and user commands. The allowed formats are:</p>

<span class="n">kinit</span> <span class="o">-</span><span class="n">l</span> <span class="s2">"10d 0h 0m 0s"</span>

</pre></div>

</div>

-</div>

-<div class="section" id="getdate-time">

+</section>

+<section id="getdate-time">

<span id="getdate"></span><h2>getdate time<a class="headerlink" href="#getdate-time" title="Permalink to this headline">¶</a></h2>

<p>Some of the kadmin and kdb5_util commands take a date-time in a

human-readable format. Some of the acceptable date-time

strings are:</p>

-<div><table border="1" class="docutils">

+<div><table class="docutils align-default">

-<col width="24%" />

-<col width="39%" />

-<col width="37%" />

+<col style="width: 24%" />

+<col style="width: 39%" />

+<col style="width: 37%" />

</colgroup>

-<thead valign="bottom">

-<tr class="row-odd"><th class="head"> </th>

-<th class="head">Format</th>

-<th class="head">Example</th>

+<thead>

+<tr class="row-odd"><th class="head"></th>

+<th class="head"><p>Format</p></th>

+<th class="head"><p>Example</p></th>

</tr>

</thead>

-<tbody valign="top">

-<tr class="row-even"><td rowspan="3">Date</td>

-<td>mm/dd/yy</td>

-<td>07/27/12</td>

+<tbody>

+<tr class="row-even"><td rowspan="3"><p>Date</p></td>

+<td><p>mm/dd/yy</p></td>

+<td><p>07/27/12</p></td>

</tr>

-<tr class="row-odd"><td>month dd, yyyy</td>

-<td>Jul 27, 2012</td>

+<tr class="row-odd"><td><p>month dd, yyyy</p></td>

+<td><p>Jul 27, 2012</p></td>

</tr>

-<tr class="row-even"><td>yyyy-mm-dd</td>

-<td>2012-07-27</td>

+<tr class="row-even"><td><p>yyyy-mm-dd</p></td>

+<td><p>2012-07-27</p></td>

</tr>

-<tr class="row-odd"><td rowspan="2">Absolute

-time</td>

-<td>HH:mm[:ss]pp</td>

-<td>08:30 PM</td>

+<tr class="row-odd"><td rowspan="2"><p>Absolute

+time</p></td>

+<td><p>HH:mm[:ss]pp</p></td>

+<td><p>08:30 PM</p></td>

</tr>

-<tr class="row-even"><td>hh:mm[:ss]</td>

-<td>20:30</td>

+<tr class="row-even"><td><p>hh:mm[:ss]</p></td>

+<td><p>20:30</p></td>

</tr>

-<tr class="row-odd"><td>Relative

-time</td>

-<td>N tt</td>

-<td>30 sec</td>

+<tr class="row-odd"><td><p>Relative

+time</p></td>

+<td><p>N tt</p></td>

+<td><p>30 sec</p></td>

</tr>

-<tr class="row-even"><td rowspan="2">Time zone</td>

-<td>Z</td>

-<td>EST</td>

+<tr class="row-even"><td rowspan="2"><p>Time zone</p></td>

+<td><p>Z</p></td>

+<td><p>EST</p></td>

</tr>

-<tr class="row-odd"><td>z</td>

-<td>-0400</td>

+<tr class="row-odd"><td><p>z</p></td>

+<td><p>-0400</p></td>

</tr>

</tbody>

</table>

</div></blockquote>

<p>(See <a class="reference internal" href="#abbreviation"><span class="std std-ref">Abbreviations used in this document</span></a>.)</p>

<p>Examples:</p>

-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Create</span> <span class="n">a</span> <span class="n">principal</span> <span class="n">that</span> <span class="n">expires</span> <span class="n">on</span> <span class="n">the</span> <span class="n">date</span> <span class="n">indicated</span><span class="p">:</span>

+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Create</span> <span class="n">a</span> <span class="n">principal</span> <span class="n">that</span> <span class="n">expires</span> <span class="n">on</span> <span class="n">the</span> <span class="n">date</span> <span class="n">indicated</span><span class="p">:</span>

<span class="n">addprinc</span> <span class="n">test1</span> <span class="o">-</span><span class="n">expire</span> <span class="s2">"3/27/12 10:00:07 EST"</span>

<span class="n">addprinc</span> <span class="n">test2</span> <span class="o">-</span><span class="n">expire</span> <span class="s2">"January 23, 2015 10:05pm"</span>

<span class="n">addprinc</span> <span class="n">test3</span> <span class="o">-</span><span class="n">expire</span> <span class="s2">"22:00 GMT"</span>

@@ -173,60 +164,60 @@ time</td>

<span class="n">addprinc</span> <span class="n">test4</span> <span class="o">-</span><span class="n">expire</span> <span class="s2">"30 minutes"</span>

</pre></div>

</div>

-</div>

-<div class="section" id="absolute-time">

+</section>

+<section id="absolute-time">

<span id="abstime"></span><h2>Absolute time<a class="headerlink" href="#absolute-time" title="Permalink to this headline">¶</a></h2>

<p>This rarely used date-time format can be noted in one of the

following ways:</p>

-<div><table border="1" class="docutils">

+<div><table class="docutils align-default">

-<col width="40%" />

-<col width="37%" />

-<col width="23%" />

+<col style="width: 40%" />

+<col style="width: 37%" />

+<col style="width: 23%" />

</colgroup>

-<thead valign="bottom">

-<tr class="row-odd"><th class="head">Format</th>

-<th class="head">Example</th>

-<th class="head">Value</th>

+<thead>

+<tr class="row-odd"><th class="head"><p>Format</p></th>

+<th class="head"><p>Example</p></th>

+<th class="head"><p>Value</p></th>

</tr>

</thead>

-<tbody valign="top">

-<tr class="row-even"><td>yyyymmddhhmmss</td>

-<td>20141231235900</td>

-<td rowspan="5">One minute

-before 2015</td>

+<tbody>

+<tr class="row-even"><td><p>yyyymmddhhmmss</p></td>

+<td><p>20141231235900</p></td>

+<td rowspan="5"><p>One minute

+before 2015</p></td>

</tr>

-<tr class="row-odd"><td>yyyy.mm.dd.hh.mm.ss</td>

-<td>2014.12.31.23.59.00</td>

+<tr class="row-odd"><td><p>yyyy.mm.dd.hh.mm.ss</p></td>

+<td><p>2014.12.31.23.59.00</p></td>

</tr>

-<tr class="row-even"><td>yymmddhhmmss</td>

-<td>141231235900</td>

+<tr class="row-even"><td><p>yymmddhhmmss</p></td>

+<td><p>141231235900</p></td>

</tr>

-<tr class="row-odd"><td>yy.mm.dd.hh.mm.ss</td>

-<td>14.12.31.23.59.00</td>

+<tr class="row-odd"><td><p>yy.mm.dd.hh.mm.ss</p></td>

+<td><p>14.12.31.23.59.00</p></td>

</tr>

-<tr class="row-even"><td>dd-month-yyyy:hh:mm:ss</td>

-<td>31-Dec-2014:23:59:00</td>

+<tr class="row-even"><td><p>dd-month-yyyy:hh:mm:ss</p></td>

+<td><p>31-Dec-2014:23:59:00</p></td>

</tr>

-<tr class="row-odd"><td>hh:mm:ss</td>

-<td>20:00:00</td>

-<td rowspan="2">8 o’clock in

-the evening</td>

+<tr class="row-odd"><td><p>hh:mm:ss</p></td>

+<td><p>20:00:00</p></td>

+<td rowspan="2"><p>8 o’clock in

+the evening</p></td>

</tr>

-<tr class="row-even"><td>hhmmss</td>

-<td>200000</td>

+<tr class="row-even"><td><p>hhmmss</p></td>

+<td><p>200000</p></td>

</tr>

</tbody>

</table>

</div></blockquote>

<p>(See <a class="reference internal" href="#abbreviation"><span class="std std-ref">Abbreviations used in this document</span></a>.)</p>

<p>Example:</p>

-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Set</span> <span class="n">the</span> <span class="n">default</span> <span class="n">expiration</span> <span class="n">date</span> <span class="n">to</span> <span class="n">July</span> <span class="mi">27</span><span class="p">,</span> <span class="mi">2012</span> <span class="n">at</span> <span class="mi">20</span><span class="p">:</span><span class="mi">30</span>

+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Set</span> <span class="n">the</span> <span class="n">default</span> <span class="n">expiration</span> <span class="n">date</span> <span class="n">to</span> <span class="n">July</span> <span class="mi">27</span><span class="p">,</span> <span class="mi">2012</span> <span class="n">at</span> <span class="mi">20</span><span class="p">:</span><span class="mi">30</span>

<span class="n">default_principal_expiration</span> <span class="o">=</span> <span class="mi">20120727203000</span>

</pre></div>

</div>

-<div class="section" id="abbreviations-used-in-this-document">

+<section id="abbreviations-used-in-this-document">

<span id="abbreviation"></span><h3>Abbreviations used in this document<a class="headerlink" href="#abbreviations-used-in-this-document" title="Permalink to this headline">¶</a></h3>

<div class="line"><em>month</em> : locale’s month name or its abbreviation;</div>

@@ -244,23 +235,25 @@ the evening</td>

<div class="line"><em>z</em> : numeric time zone;</div>

</div>

-<p class="first admonition-title">Note</p>

-<ul class="last simple">

-<li>If the date specification contains spaces, you may need to

-enclose it in double quotes;</li>

-<li>All keywords are case-insensitive.</li>

+<p class="admonition-title">Note</p>

+<ul class="simple">

+<li><p>If the date specification contains spaces, you may need to

+enclose it in double quotes;</p></li>

+<li><p>All keywords are case-insensitive.</p></li>

</ul>

</div>

-</div>

+</section>

+ <div class="clearer"></div>

</div>

<ul>

<li><a class="reference internal" href="#">Supported date and time formats</a><ul>

@@ -306,6 +299,7 @@ enclose it in double quotes;</li>

</form>

</div>

</div>

@@ -313,8 +307,8 @@ enclose it in double quotes;</li>

- <div class="right" ><i>Release: 1.21.2</i><br />

+ <div class="right" ><i>Release: 1.21.3</i><br />

</div>