Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ (2) — Plan9 4th Edition

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

cputime(2)

cons(3)

TIME(2)

NAME

time, nsec − time in seconds and nanoseconds since epoch

SYNOPSIS

­#include <u.h>
­#include <libc.h>

long time(long ∗tp)

vlong nsec(void)

DESCRIPTION

Both ­time and ­nsec return the time since the epoch 00:00:00 GMT, Jan. 1, 1970.  The return value of the former is in seconds and the latter in nanoseconds.  For time, if ­tp is not zero then ∗tp is also set to the answer. 

Times from ­time should be stored in and treated as ulongs; this extends the range of valid times into the year 2106. 

­Time simply calls ­nsec and returns the value divided by 1000000000. 

­Nsec is a system call.  Previous implementations read /dev/bintime, opening that file when first called, and maintaining a static file descriptor; however, the maintenance of file descriptors in the face of process forks is overly complex and prone to error. 

SOURCE

­/sys/src/libc/9sys/time.c
­/sys/src/libc/9syscall

SEE ALSO

cputime(2), cons(3)

DIAGNOSTICS

Sets errstr.

Plan 9  —  May 14, 2014

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026