Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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	direc-
       tory 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 at-
       tribute	 exists	  for	the   file,   pathconf(2)   with   the	  name
       _PC_HAS_NAMEDATTR may be	used.  This will not create an empty named at-
       tribute 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.0			April 15, 2025			      RUNAT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=runat&sektion=1&manpath=FreeBSD+15.0-RELEASE+and+Ports>

home | help