Vyacheslav Matyukhin > Ubic-1.51 > Ubic::AccessGuard

Download:
Ubic-1.51.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.51   Source   Latest Release: Ubic-1.57_01

NAME ^

Ubic::AccessGuard - guard for operations with temporarily different effective uid

VERSION ^

version 1.51

SYNOPSIS ^

    use Ubic::AccessGuard;

    # change effective uid and effective gid to $credentials
    $guard = Ubic::AccessGuard->new($credentials);

    # change them back
    undef $guard;

DESCRIPTION ^

Ubic::AccessGuard temporarily changes effective uid and gid, and restore it back on destruction.

It's usage is limited, because when effective uid is not equal to real uid, perl automatically turns on tainted mode. Because of this, only tainted-safe code should be called when AccessGuard is active. Ubic doesn't start services under this guard, but uses it when acquiring locks and writing service status files.

INTERFACE SUPPORT ^

This is considered to be a non-public class. Its interface is subject to change without notice.

METHODS ^

new($credentials)

Construct new access guard object.

User and group will be changed into given $credentials. It will be changed back on guard's desctruction.

AUTHOR ^

Vyacheslav Matyukhin <mmcleric@yandex-team.ru>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 by Yandex LLC.

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

syntax highlighting: