/**
* virAdmServerGetThreadPoolParameters:
* @srv: a valid server object reference
* @params: pointer to a list of typed parameters which will be allocated
* to store all returned parameters
* @nparams: pointer which will hold the number of params returned in @params
* @flags: extra flags; not used yet, so callers should always pass 0
*
* Retrieves threadpool parameters from @srv. Upon successful completion,
* @params will be allocated automatically to hold all returned data, setting
* @nparams accordingly.
* When extracting parameters from @params, following search keys are
* supported:
* VIR_THREADPOOL_WORKERS_MIN
* VIR_THREADPOOL_WORKERS_MAX
* VIR_THREADPOOL_WORKERS_PRIORITY
* VIR_THREADPOOL_WORKERS_FREE
* VIR_THREADPOOL_WORKERS_CURRENT
*
* Returns 0 on success, -1 in case of an error.
*/
int
virAdmServerGetThreadPoolParameters(virAdmServerPtr srv,
virTypedParameterPtr *params,
int *nparams,
unsigned int flags)
{
int ret = -1;
VIR_DEBUG("srv=%p, params=%p, nparams=%p, flags=%x",
srv, params, nparams, flags);
virResetLastError();
virCheckAdmServerReturn(srv, -1);
virCheckNonNullArgGoto(params, error);
if ((ret = remoteAdminServerGetThreadPoolParameters(srv, params, nparams,
flags)) < 0)
goto error;
return ret;
error:
virDispatchError(NULL);
return -1;
}
/**
* virAdmServerGetName:
* @srv: a server object
*
* Get the public name for specified server
*
* Returns a pointer to the name or NULL. The string doesn't need to be
* deallocated since its lifetime will be the same as the server object.
*/
const char *
virAdmServerGetName(virAdmServerPtr srv)
{
VIR_DEBUG("server=%p", srv);
virResetLastError();
virCheckAdmServerReturn(srv, NULL);
return srv->name;
}
/**
* virAdmServerFree:
* @srv: server object
*
* Release the server object. The running instance is kept alive.
* The data structure is freed and should not be used thereafter.
*
* Returns 0 on success, -1 on failure.
*/
int virAdmServerFree(virAdmServerPtr srv)
{
VIR_DEBUG("server=%p", srv);
virResetLastError();
virCheckAdmServerReturn(srv, -1);
virObjectUnref(srv);
return 0;
}
/**
* virAdmServerListClients:
* @srv: a valid server object reference
* @clients: pointer to a list to store an array containing objects or NULL
* if the list is not required (number of clients only)
* @flags: extra flags; not used yet, so callers should always pass 0
*
* Collect list of all clients connected to daemon on server @srv.
*
* Returns the number of clients connected to daemon on server @srv -1 in case
* of a failure, setting @clients to NULL. There is a guaranteed extra element
* set to NULL in the @clients list returned to make the iteration easier,
* excluding this extra element from the final count.
* Caller is responsible to call virAdmClientFree() on each list element,
* followed by freeing @clients.
*/
int
virAdmServerListClients(virAdmServerPtr srv,
virAdmClientPtr **clients,
unsigned int flags)
{
int ret = -1;
VIR_DEBUG("srv=%p, clients=%p, flags=%x", srv, clients, flags);
virResetLastError();
if (clients)
*clients = NULL;
virCheckAdmServerReturn(srv, -1);
if ((ret = remoteAdminServerListClients(srv, clients, flags)) < 0)
goto error;
return ret;
error:
virDispatchError(NULL);
return -1;
}
/**
* virAdmServerSetThreadPoolParameters:
* @srv: a valid server object reference
* @params: pointer to threadpool typed parameter objects
* @nparams: number of parameters in @params
* @flags: extra flags; not used yet, so callers should always pass 0
*
* Change server threadpool parameters according to @params. Note that some
* tunables are read-only, thus any attempt to set them will result in a
* failure.
*
* Returns 0 on success, -1 in case of an error.
*/
int
virAdmServerSetThreadPoolParameters(virAdmServerPtr srv,
virTypedParameterPtr params,
int nparams,
unsigned int flags)
{
VIR_DEBUG("srv=%p, params=%p, nparams=%x, flags=%x",
srv, params, nparams, flags);
virResetLastError();
virCheckAdmServerReturn(srv, -1);
virCheckNonNullArgGoto(params, error);
virCheckNonNegativeArgGoto(nparams, error);
if (remoteAdminServerSetThreadPoolParameters(srv, params,
nparams, flags) < 0)
goto error;
return 0;
error:
virDispatchError(NULL);
return -1;
}