home | help
RUNAT(1)		     General Commands Manual			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  cur-
     rent  working directory into the named attribute directory for the file ar-
     gument 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 ex-
     ists 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 ex-
     ist 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.

FreeBSD 15.1			 April 15, 2025 			RUNAT(1)

home | help