pegasus/src/Pegasus/Common/Thread.cpp - diff

Return to Thread.cpp CVS log

Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/Thread.cpp between version 1.1.2.15 and 1.90.2.9

version 1.1.2.15, 2001/11/13 18:57:02

version 1.90.2.9, 2006/07/29 15:54:07

Line 1

//%/////////////////////////////////////////////////////////////////////////////

//%2006////////////////////////////////////////////////////////////////////////

// Compaq Computer Corporation

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

Line 25

Line 33

// Modified By: Rudy Schuet (rudy.schuet@compaq.com) 11/12/01

// added nsk platform support

// Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com)

// Amit K Arora, IBM (amita@in.ibm.com) for PEP#101

// Sean Keenan, Hewlett-Packard Company (sean.keenan@hp.com)

// David Dillard, VERITAS Software Corp.

// (david.dillard@veritas.com)

//%/////////////////////////////////////////////////////////////////////////////

#include "Thread.h"

#include <Pegasus/Common/IPC.h>

#include <exception>

#include <Pegasus/Common/Tracer.h>

#include "Time.h"

#if defined(PEGASUS_OS_TYPE_WINDOWS)

PEGASUS_USING_STD;

# include "ThreadWindows.cpp"

#elif defined(PEGASUS_OS_TYPE_UNIX)

# include "ThreadUnix.cpp"

#elif defined(PEGASUS_OS_TYPE_NSK)

# include "ThreadNsk.cpp"

#else

# error "Unsupported platform"

#endif

PEGASUS_NAMESPACE_BEGIN

void thread_data::default_delete(void * data)

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

{

if( data != NULL)

// POSIX Threads Implementation:

::operator delete(data);

}

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

Boolean Thread::_signals_blocked = false;

#if defined(PEGASUS_HAVE_PTHREADS)

// for non-native implementations

struct StartWrapperArg

#ifndef PEGASUS_THREAD_CLEANUP_NATIVE

void Thread::cleanup_push( void (*routine)(void *), void *parm) throw(IPCException)

{

cleanup_handler *cu = new cleanup_handler(routine, parm);

void *(PEGASUS_THREAD_CDECL * start) (void *);

try

void *arg;

};

extern "C" void *_start_wrapper(void *arg_)

{

_cleanup.insert_first(cu);

StartWrapperArg *arg = (StartWrapperArg *) arg_;

void *return_value = (*arg->start) (arg->arg);

delete arg;

return return_value;

}

catch(IPCException& e)

void Thread::cancel()

{

delete cu;

_cancelled = true;

throw;

pthread_cancel(_handle.thid.tt_handle());

}

return;

}

void Thread::cleanup_pop(Boolean execute) throw(IPCException)

void Thread::test_cancel()

{

cleanup_handler *cu ;

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

try

pthread_testintr();

#else

pthread_testcancel();

#endif

}

Boolean Thread::is_cancelled(void)

{

cu = _cleanup.remove_first() ;

return _cancelled;

}

catch(IPCException& e)

void Thread::thread_switch()

{

PEGASUS_ASSERT(0);

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

pthread_yield(NULL);

#else

sched_yield();

#endif

}

if(execute == true)

cu->execute();

delete cu;

ATTN: why are these missing on other platforms?

#if defined(PEGASUS_PLATFORM_LINUX_GENERIC_GNU)

void Thread::suspend()

{

pthread_kill(_handle.thid.tt_handle(), SIGSTOP);

}

void Thread::resume()

{

pthread_kill(_handle.thid.tt_handle(), SIGCONT);

}

#endif

void Thread::sleep(Uint32 msec)

{

Threads::sleep(msec);

}

//thread_data *Thread::put_tsd(Sint8 *key, void (*delete_func)(void *), Uint32 size, void *value) throw(IPCException)

void Thread::join(void)

{

if (!_is_detached && Threads::id(_handle.thid) != 0)

pthread_join(_handle.thid.tt_handle(), &_exit_code);

Threads::clear(_handle.thid);

}

#ifndef PEGASUS_THREAD_EXIT_NATIVE

void Thread::thread_init(void)

void Thread::exit_self(PEGASUS_THREAD_RETURN exit_code)

{

// execute the cleanup stack and then return

while( _cleanup.count() )

{

try

{

cleanup_pop(true);

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

pthread_setintr(PTHREAD_INTR_ENABLE);

pthread_setintrtype(PTHREAD_INTR_ASYNCHRONOUS);

#else

pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);

pthread_setcanceltype(PTHREAD_CANCEL_DEFERRED, NULL);

#endif

_cancel_enabled = true;

}

catch(IPCException& e)

void Thread::detach(void)

{

PEGASUS_ASSERT(0);

_is_detached = true;

break;

pthread_detach(_handle.thid.tt_handle());

}

_exit_code = exit_code;

exit_thread(exit_code);

}

ThreadStatus Thread::run()

{

StartWrapperArg *arg = new StartWrapperArg;

arg->start = _start;

arg->arg = this;

#endif

Threads::Type type = _is_detached ? Threads::DETACHED : Threads::JOINABLE;

int rc = Threads::create(_handle.thid, type, _start_wrapper, arg);

// On Linux distributions released prior 2005, the implementation of

// Native POSIX Thread Library returns ENOMEM instead of EAGAIN when

// there

// are no insufficient memory. Hence we are checking for both. See bug

// 386.

ThreadPool::ThreadPool(Sint16 initial_size,

if ((rc == EAGAIN) || (rc == ENOMEM))

Sint8 *key,

Sint16 min,

Sint16 max,

struct timeval & alloc_wait,

struct timeval & dealloc_wait,

struct timeval & deadlock_detect)

: _max_threads(max), _min_threads(min),

_current_threads(0), _waiters(initial_size),

_pool_sem(0), _pool(true), _running(true),

_dead(true), _dying(0)

{

_allocate_wait.tv_sec = alloc_wait.tv_sec;

Threads::clear(_handle.thid);

_allocate_wait.tv_usec = alloc_wait.tv_usec;

delete arg;

_deallocate_wait.tv_sec = dealloc_wait.tv_sec;

return PEGASUS_THREAD_INSUFFICIENT_RESOURCES;

_deallocate_wait.tv_usec = dealloc_wait.tv_usec;

}

_deadlock_detect.tv_sec = deadlock_detect.tv_sec;

else if (rc != 0)

_deadlock_detect.tv_usec = deadlock_detect.tv_usec;

memset(_key, 0x00, 17);

if(key != 0)

strncpy(_key, key, 16);

if(_max_threads < initial_size)

_max_threads = initial_size;

if(_min_threads > initial_size)

_min_threads = initial_size;

int i;

for(i = 0; i < initial_size; i++)

{

_link_pool(_init_thread());

Threads::clear(_handle.thid);

delete arg;

return PEGASUS_THREAD_SETUP_FAILURE;

}

return PEGASUS_THREAD_OK;

}

static sigset_t *block_signal_mask(sigset_t * sig)

ThreadPool::~ThreadPool(void)

{

_dying++;

Thread *th = _pool.remove_first();

while(th != 0)

{

Semaphore *sleep_sem = (Semaphore *)th->reference_tsd("sleep sem");

sigemptyset(sig);

// should not be used for main()

sigaddset(sig, SIGHUP);

sigaddset(sig, SIGINT);

// maybe useless, since KILL can't be blocked according to POSIX

sigaddset(sig, SIGKILL);

if(sleep_sem == 0)

sigaddset(sig, SIGABRT);

{

sigaddset(sig, SIGALRM);

th->dereference_tsd();

sigaddset(sig, SIGPIPE);

throw NullPointer();

}

sleep_sem->signal();

th->dereference_tsd();

// signal the thread's sleep semaphore

th->cancel();

th->join();

th->empty_tsd();

delete th;

th = _pool.remove_first();

}

th = _running.remove_first();

// Note: older versions of the linux pthreads library use SIGUSR1 and SIGUSR2

while(th != 0)

// internally to stop and start threads that are blocking, the newer ones

{

// implement this through the kernel's real time signals

// signal the thread's sleep semaphore

// since SIGSTOP/CONT can handle suspend()/resume() on Linux

th->cancel();

// block them

th->join();

// #if defined(PEGASUS_PLATFORM_LINUX_IX86_GNU)

th->empty_tsd();

// sigaddset(sig, SIGUSR1);

delete th;

// sigaddset(sig, SIGUSR2);

th = _running.remove_first();

// #endif

#ifndef PEGASUS_PLATFORM_ZOS_ZSERIES_IBM

pthread_sigmask(SIG_BLOCK, sig, NULL);

#else

sigprocmask(SIG_BLOCK, sig, NULL);

#endif

return sig;

}

th = _dead.remove_first();

Thread::Thread(ThreadReturnType(PEGASUS_THREAD_CDECL * start) (void *), void *parameter, Boolean detached):_is_detached(detached),

while(th != 0)

_cancel_enabled(true),

_cancelled(false),

_start(start), _cleanup(), _tsd(), _thread_parm(parameter), _exit_code(0)

{

// signal the thread's sleep semaphore

Threads::clear(_handle.thid);

th->cancel();

th->join();

th->empty_tsd();

delete th;

th = _dead.remove_first();

}

// make this static to the class

Thread::~Thread()

PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL ThreadPool::_loop(void *parm)

{

Thread *myself = (Thread *)parm;

if(myself == 0)

throw NullPointer();

ThreadPool *pool = (ThreadPool *)myself->get_parm();

if(pool == 0 )

throw NullPointer();

Semaphore *sleep_sem;

struct timeval *deadlock_timer;

try

{

sleep_sem = (Semaphore *)myself->reference_tsd("sleep sem");

join();

myself->dereference_tsd();

empty_tsd();

deadlock_timer = (struct timeval *)myself->reference_tsd("deadlock timer");

myself->dereference_tsd();

}

catch(IPCException & e)

catch(...)

{

myself->exit_self(0);

// Do not allow the destructor to throw an exception

}

if(sleep_sem == 0 || deadlock_timer == 0)

throw NullPointer();

while(pool->_dying < 1)

#endif /* PEGASUS_HAVE_PTHREADS */

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

// Windows Threads Implementation:

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

#if defined(PEGASUS_HAVE_WINDOWS_THREADS)

ThreadStatus Thread::run(void)

{

sleep_sem->wait();

// Note: A Win32 thread ID is not the same thing as a pthread ID.

// when we awaken we reside on the running queue, not the pool queue

// Win32 threads have both a thread ID and a handle. The handle

if(pool->_dying > 0)

// is used in the wait functions, etc.

break;

// So _handle.thid is actually the thread handle.

gettimeofday(deadlock_timer, NULL);

PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *_work)(void *);

unsigned threadid = 0;

void *parm;

try

ThreadType tt;

tt.handle = (HANDLE) _beginthreadex(NULL, 0, _start, this, 0, &threadid);

_handle.thid = tt;

if (Threads::id(_handle.thid) == 0)

{

if (errno == EAGAIN)

{

_work = (PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *)(void *)) \

return PEGASUS_THREAD_INSUFFICIENT_RESOURCES;

myself->reference_tsd("work func");

myself->dereference_tsd();

parm = myself->reference_tsd("work parm");

myself->dereference_tsd();

}

catch(IPCException & e)

else

{

myself->exit_self(0);

return PEGASUS_THREAD_SETUP_FAILURE;

}

return PEGASUS_THREAD_OK;

}

if(_work == 0)

void Thread::cancel(void)

throw NullPointer();

_work(parm);

// put myself back onto the available list

try

{

pool->_running.remove((void *)myself);

_cancelled = true;

pool->_link_pool(myself);

}

catch(IPCException & e)

void Thread::test_cancel(void)

{

myself->exit_self(0);

if (_cancel_enabled && _cancelled)

}

{

exit_self(0);

}

// wait to be awakend by the thread pool destructor

sleep_sem->wait();

myself->test_cancel();

myself->exit_self(0);

return((PEGASUS_THREAD_RETURN)0);

}

Boolean Thread::is_cancelled(void)

{

return _cancelled;

}

void ThreadPool::allocate_and_awaken(void *parm,

void Thread::thread_switch(void)

PEGASUS_THREAD_RETURN \

(PEGASUS_THREAD_CDECL *work)(void *))

throw(IPCException)

{

struct timeval start;

Sleep(0);

gettimeofday(&start, NULL);

}

Thread *th = _pool.remove_first();

void Thread::sleep(Uint32 milliseconds)

{

Sleep(milliseconds);

}

while (th == 0 && _dying < 1)

void Thread::join(void)

{

try // we couldn't get a free thread from the pool

if (Threads::id(_handle.thid) != 0)

{

// wait for the right interval and try again

if (!_is_detached)

while(th == 0 && _dying < 1)

{

_check_deadlock(&start);

if (!_cancelled)

Uint32 interval = _allocate_wait.tv_sec * 1000;

{

if(_allocate_wait.tv_usec > 0)

// Emulate the unix join api. Caller sleeps until thread is

interval += (_deallocate_wait.tv_usec / 1000);

// done.

// will throw a timeout if no thread comes free

WaitForSingleObject(_handle.thid.handle, INFINITE);

_pool_sem.time_wait(interval);

th = _pool.remove_first();

}

catch(TimeOut & to)

else

{

if(_current_threads < _max_threads)

// Currently this is the only way to ensure this code does

// not

// hang forever.

if (WaitForSingleObject(_handle.thid.handle, 10000) ==

WAIT_TIMEOUT)

{

th = _init_thread();

TerminateThread(_handle.thid.handle, 0);

break;

}

// will throw a Deadlock Exception before falling out of the loop

_check_deadlock(&start);

DWORD exit_code = 0;

GetExitCodeThread(_handle.thid.handle, &exit_code);

_exit_code = (ThreadReturnType) exit_code;

}

} // while th == null

CloseHandle(_handle.thid.handle);

Threads::clear(_handle.thid);

}

if(_dying < 1)

void Thread::thread_init(void)

{

// initialize the thread data with the work function and parameters

_cancel_enabled = true;

th->remove_tsd("work func");

}

th->put_tsd("work func", NULL,

sizeof( PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *)(void *)),

(void *)work);

th->remove_tsd("work parm");

th->put_tsd("work parm", NULL, sizeof(void *), parm);

// put the thread on the running list

_running.insert_first(th);

// signal the thread's sleep semaphore to awaken it

void Thread::detach(void)

Semaphore *sleep_sem = (Semaphore *)th->reference_tsd("sleep sem");

{

_is_detached = true;

}

if(sleep_sem == 0)

Thread::Thread(ThreadReturnType(PEGASUS_THREAD_CDECL * start) (void *),

void *parameter,

Boolean detached):_is_detached(detached),

_cancel_enabled(true),

_cancelled(false),

_start(start), _cleanup(), _tsd(), _thread_parm(parameter), _exit_code(0)

{

th->dereference_tsd();

Threads::clear(_handle.thid);

throw NullPointer();

}

sleep_sem->signal();

Thread::~Thread()

th->dereference_tsd();

{

try

{

join();

empty_tsd();

}

catch(...)

{

}

else

_pool.insert_first(th);

}

// caller is responsible for only calling this routine during slack periods

#endif /* PEGASUS_HAVE_WINDOWS_THREADS */

// but should call it at least once per _deadlock_detect with the running q

// and at least once per _deallocate_wait for the pool q

void ThreadPool::kill_dead_threads(void)

throw(IPCException)

{

struct timeval now;

gettimeofday(&now, NULL);

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

// Common implementation:

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

// first go thread the dead q and clean it up as much as possible

void thread_data::default_delete(void *data)

while(_dead.count() > 0)

{

Thread *dead = _dead.remove_first();

if (data != NULL)

if(dead == 0)

::operator delete(data);

throw NullPointer();

}

if(dead->_handle.thid != 0)

void language_delete(void *data)

{

destroy_thread(dead->_handle.thid, 0);

if (data != NULL)

while(dead->_cleanup.count() )

{

dead->cleanup_pop(true);

AutoPtr < AcceptLanguageList > al(static_cast <

}

AcceptLanguageList * >(data));

}

delete dead;

}

DQueue<Thread> * map[2] =

Boolean Thread::_signals_blocked = false;

{

#ifndef PEGASUS_OS_ZOS

&_pool, &_running

TSDKeyType Thread::_platform_thread_key = TSDKeyType(-1);

};

#else

TSDKeyType Thread::_platform_thread_key;

#endif

DQueue<Thread> *q = 0;

Boolean Thread::_key_initialized = false;

int i = 0;

Boolean Thread::_key_error = false;

AtomicInt needed(0);

for( q = map[i] ; i < 2; i++, q = map[i])

void Thread::cleanup_push(void (*routine) (void *), void *parm)

{

if(q->count() > 0 )

AutoPtr < cleanup_handler > cu(new cleanup_handler(routine, parm));

_cleanup.insert_front(cu.get());

cu.release();

return;

}

void Thread::cleanup_pop(Boolean execute)

{

AutoPtr < cleanup_handler > cu;

try

{

q->try_lock();

cu.reset(_cleanup.remove_front());

}

catch(AlreadyLocked & a)

catch(IPCException &)

{

q++;

PEGASUS_ASSERT(0);

continue;

}

if (execute == true)

cu->execute();

}

//thread_data *Thread::put_tsd(const Sint8 *key, void (*delete_func)(void *), Uint32 size, void *value)

struct timeval dt = { 0, 0 };

struct timeval *dtp;

void Thread::exit_self(ThreadReturnType exit_code)

Thread *th = 0;

{

th = q->next(th);

#if defined(PEGASUS_PLATFORM_HPUX_ACC) || \

while (th != 0 )

defined(PEGASUS_PLATFORM_LINUX_GENERIC_GNU)

// NOTE: pthread_exit exhibits unusual behavior on RHEL 3 U2, as

// documented in Bugzilla 3836. Where feasible, it may be advantageous

// to avoid using this function.

pthread_exit(exit_code);

#else

// execute the cleanup stack and then return

while (_cleanup.size())

{

try

{

dtp = (struct timeval *)th->try_reference_tsd("deadlock timer");

cleanup_pop(true);

}

catch(AlreadyLocked & a)

catch(IPCException &)

{

th = q->next(th);

PEGASUS_ASSERT(0);

continue;

break;

}

_exit_code = exit_code;

Threads::exit(exit_code);

Threads::clear(_handle.thid);

#endif

}

if(dtp != 0)

Sint8 Thread::initializeKey()

{

memcpy(&dt, dtp, sizeof(struct timeval));

PEG_METHOD_ENTER(TRC_THREAD, "Thread::initializeKey");

if (!Thread::_key_initialized)

}

th->dereference_tsd();

struct timeval deadlock_timeout;

if( true == check_time(&dt, get_deadlock_detect(&deadlock_timeout) ))

{

// if we are deallocating from the pool, escape if we are

if (Thread::_key_error)

// down to the minimum thread count

if( _current_threads.value() <= (Uint32)_min_threads )

{

if( i == 1)

Tracer::trace(TRC_THREAD, Tracer::LEVEL4,

"Thread: ERROR - thread key error");

return -1;

}

if (TSDKey::create(&Thread::_platform_thread_key) == 0)

{

th = q->next(th);

Tracer::trace(TRC_THREAD, Tracer::LEVEL4,

continue;

"Thread: able to create a thread key");

Thread::_key_initialized = true;

}

else

{

// we are killing a hung thread and we will drop below the

Tracer::trace(TRC_THREAD, Tracer::LEVEL4,

// minimum. create another thread to make up for the one

"Thread: ERROR - unable to create a thread key");

// we are about to kill

Thread::_key_error = true;

needed++;

return -1;

}

th = q->remove_no_lock((void *)th);

PEG_METHOD_EXIT();

return 0;

}

if(th != 0)

Thread *Thread::getCurrent()

{

th->remove_tsd("work func");

PEG_METHOD_ENTER(TRC_THREAD, "Thread::getCurrent");

th->put_tsd("work func", NULL,

if (Thread::initializeKey() != 0)

sizeof( PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *)(void *)),

(void *)&_undertaker);

th->remove_tsd("work parm");

th->put_tsd("work parm", NULL, sizeof(void *), th);

// signal the thread's sleep semaphore to awaken it

Semaphore *sleep_sem = (Semaphore *)th->reference_tsd("sleep sem");

if(sleep_sem == 0)

{

th->dereference_tsd();

return NULL;

throw NullPointer();

}

// put the thread on the dead list

_dead.insert_first(th);

sleep_sem->signal();

th->dereference_tsd();

th = 0;

}

PEG_METHOD_EXIT();

return (Thread *) TSDKey::get_thread_specific(_platform_thread_key);

}

th = q->next(th);

void Thread::setCurrent(Thread * thrd)

{

PEG_METHOD_ENTER(TRC_THREAD, "Thread::setCurrent");

if (Thread::initializeKey() == 0)

{

if (TSDKey::

set_thread_specific(Thread::_platform_thread_key,

(void *) thrd) == 0)

{

Tracer::trace(TRC_THREAD, Tracer::LEVEL4,

"Successful set Thread * into thread specific storage");

}

q->unlock();

else

while (needed.value() > 0)

{

_link_pool(_init_thread());

Tracer::trace(TRC_THREAD, Tracer::LEVEL4,

needed--;

"ERROR: error setting Thread * into thread specific storage");

}

PEG_METHOD_EXIT();

}

AcceptLanguageList *Thread::getLanguages()

{

PEG_METHOD_ENTER(TRC_THREAD, "Thread::getLanguages");

return;

Thread *curThrd = Thread::getCurrent();

if (curThrd == NULL)

return NULL;

AcceptLanguageList *acceptLangs =

(AcceptLanguageList *) curThrd->reference_tsd("acceptLanguages");

curThrd->dereference_tsd();

PEG_METHOD_EXIT();

return acceptLangs;

}

Boolean ThreadPool::check_time(struct timeval *start, struct timeval *interval)

void Thread::setLanguages(AcceptLanguageList * langs) // l10n

{

struct timeval now;

PEG_METHOD_ENTER(TRC_THREAD, "Thread::setLanguages");

gettimeofday(&now, NULL);

if( (now.tv_sec - start->tv_sec) > interval->tv_sec ||

Thread *currentThrd = Thread::getCurrent();

(((now.tv_sec - start->tv_sec) == interval->tv_sec) &&

if (currentThrd != NULL)

((now.tv_usec - start->tv_usec) >= interval->tv_usec ) ) )

{

return true;

// deletes the old tsd and creates a new one

else

currentThrd->put_tsd("acceptLanguages",

return false;

language_delete,

sizeof (AcceptLanguageList *), langs);

}

PEG_METHOD_EXIT();

}

PEGASUS_THREAD_RETURN ThreadPool::_undertaker( void *parm )

void Thread::clearLanguages() // l10n

{

Thread *myself = reinterpret_cast<Thread *>(parm);

PEG_METHOD_ENTER(TRC_THREAD, "Thread::clearLanguages");

if(myself != 0)

Thread *currentThrd = Thread::getCurrent();

if (currentThrd != NULL)

{

myself->detach();

// deletes the old tsd

myself->_handle.thid = 0;

currentThrd->delete_tsd("acceptLanguages");

myself->cancel();

myself->test_cancel();

myself->exit_self(0);

}

return((PEGASUS_THREAD_RETURN)0);

PEG_METHOD_EXIT();

}

// ATTN: not sure where to put this!

#ifdef PEGASUS_ZOS_SECURITY

bool isEnhancedSecurity = 99;

#endif

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.1.2.15
changed lines
	Added in v.1.90.2.9

No CVS admin address has been configured