support "F" variants of operations (on file descriptors) (#36)

In unix, there is a possibility to create files without a path, for
example by using O_TMPFILE flag in open(2).

This change adds a set of "F" variants to all functions that accepts
a file descriptor instead of a path.

The change is only implemented for Linux, all other platforms use Name()
call on a file to get its path.
6 files changed
tree: 018726e754745d27df7a9840ae74d7311fcc83cf
  1. .gitignore
  2. .travis.sh
  3. .travis.yml
  4. go.mod
  5. LICENSE
  6. README.md
  7. xattr.go
  8. xattr_darwin.go
  9. xattr_flags_test.go
  10. xattr_freebsd.go
  11. xattr_linux.go
  12. xattr_test.go
README.md

GoDoc Go Report Card Build Status Version Codecov

xattr

Extended attribute support for Go (linux + darwin + freebsd).

“Extended attributes are name:value pairs associated permanently with files and directories, similar to the environment strings associated with a process. An attribute may be defined or undefined. If it is defined, its value may be empty or non-empty.” See more...

SetWithFlags allows to additionally pass system flags to be forwarded to the underlying calls, FreeBSD does not support this and the parameter will be ignored.

The L variants of all functions (LGet/LSet/...) are identical to Get/Set/... except that they do not reference a symlink that appears at the end of a path. See GoDoc for details.

Example

  const path = "/tmp/myfile"
  const prefix = "user."

  if err := xattr.Set(path, prefix+"test", []byte("test-attr-value")); err != nil {
  	log.Fatal(err)
  }

  var list []string
  if list, err = xattr.List(path); err != nil {
  	log.Fatal(err)
  }

  var data []byte
  if data, err = xattr.Get(path, prefix+"test"); err != nil {
  	log.Fatal(err)
  }

  if err = xattr.Remove(path, prefix+"test"); err != nil {
  	log.Fatal(err)
  }

  // One can also specify the flags parameter to be passed to the OS.
  if err := xattr.SetWithFlags(path, prefix+"test", []byte("test-attr-value"), xattr.XATTR_CREATE); err != nil {
  	log.Fatal(err)
  }