aboutsummaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorGarrett Wollman <wollman@FreeBSD.org>1999-01-03 01:07:41 +0000
committerGarrett Wollman <wollman@FreeBSD.org>1999-01-03 01:07:41 +0000
commit600c04ff9365534b1a118e4ade6251151585285d (patch)
tree56e125b4399c8b61b400a2a7e7d1ab03e3f36c76 /lib
parent2af878cba4f89fbca4dfc370e19f6199e9cdc520 (diff)
downloadsrc-600c04ff9365534b1a118e4ade6251151585285d.tar.gz
src-600c04ff9365534b1a118e4ade6251151585285d.zip
Add STANDARDS section.
s/bytes/characters/g to be consistent with Standard C terminology. Update date and add RCS Id.
Notes
Notes: svn path=/head/; revision=42259
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/stdtime/ctime.343
1 files changed, 37 insertions, 6 deletions
diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3
index fe52adbcfda0..2b8ca3e45adc 100644
--- a/lib/libc/stdtime/ctime.3
+++ b/lib/libc/stdtime/ctime.3
@@ -31,14 +31,15 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)ctime.3 8.1 (Berkeley) 6/4/93
+.\" From: @(#)ctime.3 8.1 (Berkeley) 6/4/93
+.\" $Id$
.\"
-.Dd June 4, 1993
+.Dd January 2, 1999
.Dt CTIME 3
.Os BSD 4.3
.Sh NAME
.Nm asctime ,
-.Nm asctime_r,
+.Nm asctime_r ,
.Nm ctime ,
.Nm ctime_r ,
.Nm difftime ,
@@ -142,7 +143,7 @@ provides the same functionality as
.Fn ctime
except the caller must provide the output buffer
.Fa buf
-to store the result, which must be at least 26 bytes long.
+to store the result, which must be at least 26 characters long.
.Fn localtime_r
and
.Fn gmtime_r
@@ -168,7 +169,7 @@ provides the same functionality as
.Fn asctime
except the caller provide the output buffer
.Fa buf
-to store the result, which must be at least 26 bytes long.
+to store the result, which must be at least 26 characters long.
.Pp
The functions
.Fn mktime
@@ -275,6 +276,33 @@ values indicating east of the Prime Meridian.
.Xr time 3 ,
.Xr tzset 3 ,
.Xr tzfile 5
+.Sh STANDARDS
+The
+.Fn asctime ,
+.Fn ctime ,
+.Fn difftime ,
+.Fn gmtime ,
+.Fn localtime ,
+and
+.Fn mktime
+functions conform to
+.St -isoC ,
+and conform to
+.St -p1003.1
+provided the selected local timezone does not contain a leap-second table
+(see
+.Xr zic 8 ) .
+.Pp
+The
+.Fn asctime_r ,
+.Fn ctime_r ,
+.Fn gmtime_r ,
+and
+.Fn localtime_r
+functions are expected to conform to
+.St -iso9945-1
+(again provided the selected local timezone does not contain a leap-second
+table).
.Sh HISTORY
This manual page is derived from
the time package contributed to Berkeley by
@@ -294,7 +322,10 @@ function will modify the same object.
The C Standard provides no mechanism for a program to modify its current
local timezone setting, and the
.Tn POSIX Ns No \&-standard
-method is not reentrant.
+method is not reentrant. (However, thread-safe implementations are provided
+in the
+.Tn POSIX
+threaded environment.)
.Pp
The
.Fa tm_zone