NAME
Sub::Spec::Clause::drops_privilege - Add spec clause 'drops_privilege'
VERSION
version 0.03
SYNOPSIS
# in your sub spec
drops_privilege => 1DESCRIPTION
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
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.