commit	ac4e0500320b96343a2abcc13d3676700543bc1c	[log] [tgz]
author	Inna Palant <ipalant@google.com>	Tue Apr 30 04:15:01 2024 +0000
committer	Inna Palant <ipalant@google.com>	Tue Apr 30 04:15:01 2024 +0000
tree	1d95e8f9f08ad1483121682723aab38da093091e
parent	4e3c319beb6e8ca494af88edd922399a3df2a578 [diff]
parent	fb0d10608a0a3543719dc14978e379c5e694da93 [diff]

tree: 1d95e8f9f08ad1483121682723aab38da093091e

README.md

xattr

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

“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 and NetBSD do 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)
  }