.. zsh-module-meta::
   :name: zsh/cap
   :summary: Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

The ``zsh/cap`` module is used for manipulating POSIX.1e (POSIX.6) capability
sets.  If the operating system does not support this interface, the
builtins defined by this module will do nothing.
The builtins in this module are:

.. index:: single: cap; Function

.. index:: single: capabilities, setting; Command

``cap`` [ :var:`capabilities` ]
    
    Change the shell's process capability sets to the specified :var:`capabilities`,
    otherwise display the shell's current capabilities.
    

.. index:: single: getcap; Function

.. index:: single: capabilities, getting from files; Command

``getcap`` :var:`filename` ...
    
    This is a built-in implementation of the POSIX standard utility.  It displays
    the capability sets on each specified :var:`filename`.
    

.. index:: single: setcap; Function

.. index:: single: capabilities, setting on files; Command

``setcap`` :var:`capabilities` :var:`filename` ...
    
    This is a built-in implementation of the POSIX standard utility.  It sets
    the capability sets on each specified :var:`filename` to the specified
    :var:`capabilities`.
    

