source: source/ariba/communication/modules/transport/protlib/setuid.h@ 5638

/// ----------------------------------------*- mode: C++; -*--

/// @file setuid.h

/// Change effective user ID in a thread-safe way

/// ----------------------------------------------------------

/// $Id: setuid.h 2549 2007-04-02 22:17:37Z bless $

/// $HeadURL: https://svn.ipv6.tm.uka.de/nsis/protlib/trunk/include/setuid.h $

// ===========================================================

//                      

// Copyright (C) 2005-2007, all rights reserved by

// - Institute of Telematics, Universitaet Karlsruhe (TH)

//

// More information and contact:

// https://projekte.tm.uka.de/trac/NSIS

//                      

// This program is free software; you can redistribute it and/or modify

// it under the terms of the GNU General Public License as published by

// the Free Software Foundation; version 2 of the License

//

// This program is distributed in the hope that it will be useful,

// but WITHOUT ANY WARRANTY; without even the implied warranty of

// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

// GNU General Public License for more details.

//

// You should have received a copy of the GNU General Public License along

// with this program; if not, write to the Free Software Foundation, Inc.,

// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

//

// ===========================================================

/** @ingroup tssetuid

 *

 * Thread-safe setuid support for linux. 

 * Change effective user ID in a thread-safe way.

 *

 * tsdb::init() must be called before calling setuid::init().

 */



#ifndef THREADSAFE_SETUID_H

#define THREADSAFE_SETUID_H



#include <sys/types.h>

#include <pthread.h>

#include <string>



#include "protlib_types.h"

#include "cleanuphandler.h"



namespace protlib { 



/** @addtogroup tssetuid Thread-safe setuid program support

 * @{

 */



/// Thread-safe setuid

/** This class provieds class methods for changing the effective user ID of

 * the current process.

 */

class setuid {

public:

        /// initialize setuid 

        static void init();

        /// cleanup setuid resources

        static void end();

        /// turn on setuid mode

        static void on();

        /// turn off setuid mode

        static void off();

private:

        /// init state

        static bool is_init;

        /// setuid mutex

        static pthread_mutex_t mutex;

        /// setuid counter

        static uint32 count;

        /// file user ID

        static uid_t file_userid;

        /// file user name

        static string file_username;

        /// real user ID

        static uid_t real_userid;

        /// real user name

        static string real_username;

        /// are we using setuid?

        static bool is_setuid;

}; // end class setuid



/// Turn on setuid mode and install cleanup handler.

#define BEGIN_SETUID_MODE protlib::setuid::on(); install_cleanup(call_void_fun,protlib::setuid::off)

#define END_SETUID_MODE uninstall_cleanup(1)



//@}



} // end namespace protlib



#endif