RUNAT(1)                FreeBSD 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
     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.

FreeBSD 15.1-STABLE-HBSD        April 15, 2025                        RUNAT(1)