rclone/vendor/github.com/djherbis/times/README.md

times

Usage

File Times for #golang

Go has a hidden time functions for most platforms, this repo makes them accessible.

package main

import (
  "log"

  "github.com/djherbis/times"
)

func main() {
  t, err := times.Stat("myfile")
  if err != nil {
    log.Fatal(err.Error())
  }

  log.Println(t.AccessTime())
  log.Println(t.ModTime())

  if t.HasChangeTime() {
    log.Println(t.ChangeTime())
  }

  if t.HasBirthTime() {
    log.Println(t.BirthTime())
  }
}

Supported Times

	windows	linux	solaris	dragonfly	nacl	freebsd	darwin	netbsd	openbsd	plan9
atime	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
mtime	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
ctime	✓*	✓	✓	✓	✓	✓	✓	✓	✓
btime	✓					✓	✓	✓

• Windows XP does not have ChangeTime so HasChangeTime = false,
  however Vista onward does have ChangeTime so Timespec.HasChangeTime() will
  only return false on those platforms when the syscall used to obtain them fails.
• Also note, Get(FileInfo) will now only return values available in FileInfo.Sys(), this means Stat() is required to get ChangeTime on Windows

Installation

go get github.com/djherbis/times