summaryrefslogtreecommitdiff
path: root/doc/html/appdev/y2038.html
diff options
context:
space:
mode:
authorCy Schubert <cy@FreeBSD.org>2025-03-19 22:12:25 +0000
committerCy Schubert <cy@FreeBSD.org>2025-03-19 22:12:25 +0000
commit8f7d3ef26dec89a92ec0665de84a5936310a5574 (patch)
tree9a465418bd4056bf0d369751320a414eaed29fa4 /doc/html/appdev/y2038.html
parent1a79b20663ca26acc2998b90ea2ff2aefd8af5b1 (diff)
Diffstat (limited to 'doc/html/appdev/y2038.html')
-rw-r--r--doc/html/appdev/y2038.html50
1 files changed, 22 insertions, 28 deletions
diff --git a/doc/html/appdev/y2038.html b/doc/html/appdev/y2038.html
index 36b4b93ecd58..f0be8657a3cc 100644
--- a/doc/html/appdev/y2038.html
+++ b/doc/html/appdev/y2038.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>Year 2038 considerations for uses of krb5_timestamp &#8212; 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>
<link rel="author" title="About these documents" href="../about.html" />
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="copyright" title="Copyright" href="../copyright.html" />
<link rel="next" title="Differences between Heimdal and MIT Kerberos API" href="h5l_mit_apidiff.html" />
<link rel="prev" title="Developing with GSSAPI" href="gssapi.html" />
- </head>
- <body>
+ </head><body>
<div class="header-wrapper">
<div class="header">
@@ -61,7 +52,7 @@
<div class="bodywrapper">
<div class="body" role="main">
- <div class="section" id="year-2038-considerations-for-uses-of-krb5-timestamp">
+ <section id="year-2038-considerations-for-uses-of-krb5-timestamp">
<h1>Year 2038 considerations for uses of krb5_timestamp<a class="headerlink" href="#year-2038-considerations-for-uses-of-krb5-timestamp" title="Permalink to this headline">ΒΆ</a></h1>
<p>POSIX time values, which measure the number of seconds since January 1
1970, will exceed the maximum value representable in a signed 32-bit
@@ -69,12 +60,12 @@ integer in January 2038. This documentation describes considerations
for consumers of the MIT krb5 libraries.</p>
<p>Applications or libraries which use libkrb5 and consume the timestamps
included in credentials or other structures make use of the
-<a class="reference internal" href="refs/types/krb5_timestamp.html#c.krb5_timestamp" title="krb5_timestamp"><code class="xref c c-type docutils literal"><span class="pre">krb5_timestamp</span></code></a> type. For historical reasons, krb5_timestamp
+<a class="reference internal" href="refs/types/krb5_timestamp.html#c.krb5_timestamp" title="krb5_timestamp"><code class="xref c c-type docutils literal notranslate"><span class="pre">krb5_timestamp</span></code></a> type. For historical reasons, krb5_timestamp
is a signed 32-bit integer, even on platforms where a larger type is
natively used to represent time values. To behave properly for time
values after January 2038, calling code should cast krb5_timestamp
values to uint32_t, and then to time_t:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="p">(</span><span class="n">time_t</span><span class="p">)(</span><span class="n">uint32_t</span><span class="p">)</span><span class="n">timestamp</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">(</span><span class="n">time_t</span><span class="p">)(</span><span class="n">uint32_t</span><span class="p">)</span><span class="n">timestamp</span>
</pre></div>
</div>
<p>Used in this way, krb5_timestamp values can represent time values up
@@ -86,14 +77,16 @@ integer.</p>
times. Callers of the GSSAPI should require no changes to behave
correctly after January 2038, provided that they use MIT krb5 release
1.16 or later.</p>
-</div>
+</section>
+ <div class="clearer"></div>
</div>
</div>
</div>
</div>
<div class="sidebar">
+
<h2>On this page</h2>
<ul>
<li><a class="reference internal" href="#">Year 2038 considerations for uses of krb5_timestamp</a></li>
@@ -132,6 +125,7 @@ correctly after January 2038, provided that they use MIT krb5 release
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
+
</div>
<div class="clearer"></div>
</div>
@@ -139,8 +133,8 @@ correctly after January 2038, provided that they use MIT krb5 release
<div class="footer-wrapper">
<div class="footer" >
- <div class="right" ><i>Release: 1.21.2</i><br />
- &copy; <a href="../copyright.html">Copyright</a> 1985-2023, MIT.
+ <div class="right" ><i>Release: 1.21.3</i><br />
+ &copy; <a href="../copyright.html">Copyright</a> 1985-2024, MIT.
</div>
<div class="left">