annotate vendor/golang.org/x/sys/unix/timestruct.go @ 68:4b79810863f6 draft

Ready to release 0.6.0 Signed-off-by: Izuru Yakumo <yakumo.izuru@chaotic.ninja>
author yakumo.izuru
date Wed, 13 Sep 2023 10:49:50 +0000
parents 787b5ee0289d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
1 // Copyright 2017 The Go Authors. All rights reserved.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
2 // Use of this source code is governed by a BSD-style
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
3 // license that can be found in the LICENSE file.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
4
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
5 //go:build aix || darwin || dragonfly || freebsd || linux || netbsd || openbsd || solaris || zos
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
6 // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris zos
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
7
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
8 package unix
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
10 import "time"
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
11
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
12 // TimespecToNSec returns the time stored in ts as nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
13 func TimespecToNsec(ts Timespec) int64 { return ts.Nano() }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
14
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
15 // NsecToTimespec converts a number of nanoseconds into a Timespec.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
16 func NsecToTimespec(nsec int64) Timespec {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
17 sec := nsec / 1e9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
18 nsec = nsec % 1e9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
19 if nsec < 0 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
20 nsec += 1e9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
21 sec--
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
22 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
23 return setTimespec(sec, nsec)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
24 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
25
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
26 // TimeToTimespec converts t into a Timespec.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
27 // On some 32-bit systems the range of valid Timespec values are smaller
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
28 // than that of time.Time values. So if t is out of the valid range of
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
29 // Timespec, it returns a zero Timespec and ERANGE.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
30 func TimeToTimespec(t time.Time) (Timespec, error) {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
31 sec := t.Unix()
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
32 nsec := int64(t.Nanosecond())
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
33 ts := setTimespec(sec, nsec)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
34
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
35 // Currently all targets have either int32 or int64 for Timespec.Sec.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
36 // If there were a new target with floating point type for it, we have
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
37 // to consider the rounding error.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
38 if int64(ts.Sec) != sec {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
39 return Timespec{}, ERANGE
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
40 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
41 return ts, nil
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
42 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
43
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
44 // TimevalToNsec returns the time stored in tv as nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
45 func TimevalToNsec(tv Timeval) int64 { return tv.Nano() }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
46
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
47 // NsecToTimeval converts a number of nanoseconds into a Timeval.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
48 func NsecToTimeval(nsec int64) Timeval {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
49 nsec += 999 // round up to microsecond
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
50 usec := nsec % 1e9 / 1e3
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
51 sec := nsec / 1e9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
52 if usec < 0 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
53 usec += 1e6
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
54 sec--
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
55 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
56 return setTimeval(sec, usec)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
57 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
58
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
59 // Unix returns the time stored in ts as seconds plus nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
60 func (ts *Timespec) Unix() (sec int64, nsec int64) {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
61 return int64(ts.Sec), int64(ts.Nsec)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
62 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
63
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
64 // Unix returns the time stored in tv as seconds plus nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
65 func (tv *Timeval) Unix() (sec int64, nsec int64) {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
66 return int64(tv.Sec), int64(tv.Usec) * 1000
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
67 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
68
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
69 // Nano returns the time stored in ts as nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
70 func (ts *Timespec) Nano() int64 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
71 return int64(ts.Sec)*1e9 + int64(ts.Nsec)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
72 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
73
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
74 // Nano returns the time stored in tv as nanoseconds.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
75 func (tv *Timeval) Nano() int64 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
76 return int64(tv.Sec)*1e9 + int64(tv.Usec)*1000
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
77 }