RUNAT(1)

NAME
runat - run a shell command on a named attribute directory

SYNOPSIS
runat [file] [shell command]

DESCRIPTION
The runat utility runs the shell command on the named attribute directory for the file argument. It does a fchdir(2) system call to change the current working directory into the named attribute directory for the file argument and then performs the shell command via sh(1).

If a named attribute directory does not exist for file, an empty one will be created. If an application needs to determine if a named attribute exists for the file, pathconf(2) with the name _PC_HAS_NAMEDATTR may be used. This will not create an empty named attribute directory if one does not exist for file.

EXAMPLES
For a file called “myfile”:

    $ runat myfile ls -l			# lists the attributes for myfile
    $ runat myfile cp /etc/hosts attrhosts	# creates attrhosts
    $ runat myfile cat attrhosts		# displays contents of attrhosts

SEE ALSO
sh(1), fchdir(2), pathconf(2), open(2), named_attribute(7)

HISTORY
The runat utility first appeared in FreeBSD 15.0.