Display and manipulate extended attributes of one or more files, including directories and symbolic links.

   List attributes
      xattr [-lrsvx] file ...

   Print the value associated with the given attribute:
      xattr -p [-lrsvx] attr_name file ...

   Write a given attribute name with a value:
      xattr -w [-rsx] attr_name attr_value file ...

   Delete the given attribute from file:
      xattr -d [-rsv] attr_name file ...

   Clear all attributes including their associated values:
      xattr -c [-rsv] file ...

   Display help:
      xattr -h | --help

   -l  By default, the first two command forms either display just the attribute names or
       values, respectively. The -l option causes both the attribute names and corresponding
       values to be displayed. For hex display of values, the output is preceeded with the hex
       offset values and followed by ASCII display, enclosed by '|'.

   -r  If a file argument is a directory, act as if the entire contents of the directory
       recursively were also specified (so that every file in the directory tree is acted upon).

   -s  If a file argument is a symbolic link, act on the symbolic link itself, rather than
       the file that the symbolic link points at.

   -v  Force the the file name to be displayed, even for a single file.

   -x  Force the attribute value to be displayed in the hexadecimal representation.       

Extended attributes are arbitrary metadata stored with a file, but separate from the filesystem attributes (such as modification time or file size). The metadata is often a null-terminated UTF-8 string, but can also be arbitrary binary data.
One or more files may be specified on the command line.

In macOS, extended attributes are most often seen in the 'iPhoto Library' and 'Photo Booth Library' - these are folders with a bundle bit applied so that they appear in the Apple Finder as a single file, this is done to hide the files so that they can be managed by a single application.

For the first two forms of the command, if there is more than one file, the file name is displayed along with the actual results. When only one file is specified, the display of the file name is suppressed unless the -v option, is also specified.

In the first form of the command ( -w with no other mode option specified), the names of all extended attributes are listed.

In the second form, the -p option (print), the value associated with the given attribute name is displayed.

Attribute values are usually displayed as strings. However, if nils are detected in the data, the value is displayed in a hexadecimal representation.

The -w option normally assumes the input attribute value is a string. Specifying the -x option causes xattr to expect the input in hexadecimal (whitespace is ignored). The xxd command can be used to create hexadecimal representations from exising binary data, to pass to xattr.

As an alternative to xattr -w attribute names can also be displayed using ls -l@

To copy a file without it's Extended Attributes, use cp -X

xattr exits with zero status on success. On error, non-zero is returned, and a message is printed to standard error.


Remove the bundle bit from the MyApp folder and convert it back to a normal folder.

$ xattr -d com.apple.FinderInfo ~/MyApp

Remove all Extended Attributes from the 'example.txt' file:

$ xattr -c example.txt

Remove all Extended Attributes from all the files in a directory:

$ attr -rc /path/to/directory

Copy the com.apple.FinderInfo attribute from the /usr directory to the MyDir directory:

$ xattr -px com.apple.FinderInfo /usr
  00 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00
  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

$ xattr -l MyDir

$ xattr -wx com.apple.FinderInfo \
    "`xattr -px com.apple.FinderInfo /usr`" MyDir

$ xattr -l MyDir
  00000000  00 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00  |........@.......|
  00000010  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  |................|

“I think too much. I think ahead. I think behind. I think sideways. I think it all” ~ Winona Ryder


xattr man page - Apple.com
ls - List information about file(s)
apple.stackexchange.com - Editing iPhoto-specific metadata

Copyright © SS64.com 1999-2017
Some rights reserved