NAME
    Sub::Spec::Clause::drops_privilege - Add spec clause 'drops_privilege'

VERSION
    version 0.03

SYNOPSIS
     # in your sub spec
     drops_privilege => 1

DESCRIPTION
    NOTICE: The Sub::Spec specification is deprecated as of Jan 2012. Rinci
    is the new specification to replace Sub::Spec, it is about 95%
    compatible with Sub::Spec, but corrects a few issues and is more
    generic. Perinci:: is the family of Perl modules that implement the
    Rinci specification. Many of its modules can handle existing Sub::Spec
    sub specs. Rinci::function::property::drops_privilege is the replacement
    for this module.

    Argument: BOOL

    This module adds 'drops_privilege' clause to sub spec. If set to 1, it
    specifies that sub drops OS privileges when doing its job. Usually this
    is for tasks that run as root/administrator.

    This module adds a wrapper code to make sure that OS privilege is
    restored. A sub might die in the middle of execution and haven't
    restored OS privileges yet.

SEE ALSO
    Sub::Spec

    Sub::Spec::Wrapper

AUTHOR
    Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Steven Haryanto.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.