mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-03-07 17:28:15 +00:00
6dd7e42d89
As we need a client disconnect handler, we also need a mechanism to register such handlers for a client. This patch introduced both the close callbacks and also the client vshAdmCatchDisconnect handler to be registered with it. By registering the handler we still need to make sure the client can react to daemon's events like disconnect or keepalive, so asynchronous I/O event polling is necessary to be enabled too.
88 lines
2.7 KiB
C
88 lines
2.7 KiB
C
/*
|
|
* libvirt-admin.h: Admin interface for libvirt
|
|
* Summary: Interfaces for handling server-related tasks
|
|
* Description: Provides the interfaces of the libvirt library to operate
|
|
* with the server itself, not any hypervisors.
|
|
*
|
|
* Copyright (C) 2014-2015 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see
|
|
* <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Author: Martin Kletzander <mkletzan@redhat.com>
|
|
*/
|
|
|
|
#ifndef __VIR_ADMIN_H__
|
|
# define __VIR_ADMIN_H__
|
|
|
|
# ifdef __cplusplus
|
|
extern "C" {
|
|
# endif
|
|
|
|
# define __VIR_ADMIN_H_INCLUDES__
|
|
# include <libvirt/libvirt-common.h>
|
|
# undef __VIR_ADMIN_H_INCLUDES__
|
|
|
|
/**
|
|
* virAdmConnect:
|
|
*
|
|
* a virAdmConnect is a private structure representing a connection to
|
|
* libvirt daemon.
|
|
*/
|
|
typedef struct _virAdmConnect virAdmConnect;
|
|
|
|
/**
|
|
* virAdmConnectPtr:
|
|
*
|
|
* a virAdmConnectPtr is pointer to a virAdmConnect private structure,
|
|
* this is the type used to reference a connection to the daemon
|
|
* in the API.
|
|
*/
|
|
typedef virAdmConnect *virAdmConnectPtr;
|
|
|
|
virAdmConnectPtr virAdmConnectOpen(const char *name, unsigned int flags);
|
|
int virAdmConnectClose(virAdmConnectPtr conn);
|
|
|
|
int virAdmConnectRef(virAdmConnectPtr conn);
|
|
int virAdmConnectIsAlive(virAdmConnectPtr conn);
|
|
|
|
int virAdmGetVersion(unsigned long long *libVer);
|
|
|
|
char *virAdmConnectGetURI(virAdmConnectPtr conn);
|
|
|
|
/**
|
|
* virAdmConnectCloseFunc:
|
|
* @conn: virAdmConnect connection
|
|
* @reason: reason why the connection was closed (see virConnectCloseReason)
|
|
* @opaque: opaque client data
|
|
*
|
|
* A callback to be registered, in case a connection was closed.
|
|
*/
|
|
typedef void (*virAdmConnectCloseFunc)(virAdmConnectPtr conn,
|
|
int reason,
|
|
void *opaque);
|
|
|
|
int virAdmConnectRegisterCloseCallback(virAdmConnectPtr conn,
|
|
virAdmConnectCloseFunc cb,
|
|
void *opaque,
|
|
virFreeCallback freecb);
|
|
int virAdmConnectUnregisterCloseCallback(virAdmConnectPtr conn,
|
|
virAdmConnectCloseFunc cb);
|
|
|
|
# ifdef __cplusplus
|
|
}
|
|
# endif
|
|
|
|
#endif /* __VIR_ADMIN_H__ */
|