mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-28 00:25:23 +00:00
f8ec7c842d
This wires up support for using the new virt-ssh-helper binary with the ssh, libssh and libssh2 protocols. The new binary will be used preferentially if it is available in $PATH, otherwise we fall back to traditional netcat. The "proxy" URI parameter can be used to force use of netcat e.g. qemu+ssh://host/system?proxy=netcat or the disable fallback e.g. qemu+ssh://host/system?proxy=native With use of virt-ssh-helper, we can now support remote session URIs qemu+ssh://host/session and this will only use virt-ssh-helper, with no fallback. This also lets the libvirtd process be auto-started, and connect directly to the modular daemons, avoiding use of virtproxyd back-compat tunnelling. Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
165 lines
6.4 KiB
C
165 lines
6.4 KiB
C
/*
|
|
* virnetclient.h: generic network RPC client
|
|
*
|
|
* Copyright (C) 2006-2012 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/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "virnettlscontext.h"
|
|
#include "virnetmessage.h"
|
|
#ifdef WITH_SASL
|
|
# include "virnetsaslcontext.h"
|
|
#endif
|
|
#include "virnetclientprogram.h"
|
|
#include "virnetclientstream.h"
|
|
#include "virobject.h"
|
|
#include "viruri.h"
|
|
|
|
typedef enum {
|
|
VIR_NET_CLIENT_PROXY_AUTO,
|
|
VIR_NET_CLIENT_PROXY_NETCAT,
|
|
VIR_NET_CLIENT_PROXY_NATIVE,
|
|
|
|
VIR_NET_CLIENT_PROXY_LAST,
|
|
} virNetClientProxy;
|
|
|
|
VIR_ENUM_DECL(virNetClientProxy);
|
|
|
|
char *
|
|
virNetClientSSHHelperCommand(virNetClientProxy proxy,
|
|
const char *netcatPath,
|
|
const char *socketPath,
|
|
const char *driverURI,
|
|
bool readonly);
|
|
|
|
virNetClientPtr virNetClientNewUNIX(const char *path,
|
|
bool spawnDaemon,
|
|
const char *binary);
|
|
|
|
virNetClientPtr virNetClientNewTCP(const char *nodename,
|
|
const char *service,
|
|
int family);
|
|
|
|
virNetClientPtr virNetClientNewSSH(const char *nodename,
|
|
const char *service,
|
|
const char *binary,
|
|
const char *username,
|
|
bool noTTY,
|
|
bool noVerify,
|
|
const char *keyfile,
|
|
virNetClientProxy proxy,
|
|
const char *netcatPath,
|
|
const char *socketPath,
|
|
const char *driverURI,
|
|
bool readonly);
|
|
|
|
virNetClientPtr virNetClientNewLibSSH2(const char *host,
|
|
const char *port,
|
|
int family,
|
|
const char *username,
|
|
const char *privkeyPath,
|
|
const char *knownHostsPath,
|
|
const char *knownHostsVerify,
|
|
const char *authMethods,
|
|
virNetClientProxy proxy,
|
|
const char *netcatPath,
|
|
const char *socketPath,
|
|
const char *driverURI,
|
|
bool readonly,
|
|
virConnectAuthPtr authPtr,
|
|
virURIPtr uri);
|
|
|
|
virNetClientPtr virNetClientNewLibssh(const char *host,
|
|
const char *port,
|
|
int family,
|
|
const char *username,
|
|
const char *privkeyPath,
|
|
const char *knownHostsPath,
|
|
const char *knownHostsVerify,
|
|
const char *authMethods,
|
|
virNetClientProxy proxy,
|
|
const char *netcatPath,
|
|
const char *socketPath,
|
|
const char *driverURI,
|
|
bool readonly,
|
|
virConnectAuthPtr authPtr,
|
|
virURIPtr uri);
|
|
|
|
virNetClientPtr virNetClientNewExternal(const char **cmdargv);
|
|
|
|
int virNetClientRegisterAsyncIO(virNetClientPtr client);
|
|
int virNetClientRegisterKeepAlive(virNetClientPtr client);
|
|
|
|
typedef void (*virNetClientCloseFunc)(virNetClientPtr client,
|
|
int reason,
|
|
void *opaque);
|
|
|
|
void virNetClientSetCloseCallback(virNetClientPtr client,
|
|
virNetClientCloseFunc cb,
|
|
void *opaque,
|
|
virFreeCallback ff);
|
|
|
|
int virNetClientGetFD(virNetClientPtr client);
|
|
int virNetClientDupFD(virNetClientPtr client, bool cloexec);
|
|
|
|
bool virNetClientHasPassFD(virNetClientPtr client);
|
|
|
|
int virNetClientAddProgram(virNetClientPtr client,
|
|
virNetClientProgramPtr prog);
|
|
|
|
int virNetClientAddStream(virNetClientPtr client,
|
|
virNetClientStreamPtr st);
|
|
|
|
void virNetClientRemoveStream(virNetClientPtr client,
|
|
virNetClientStreamPtr st);
|
|
|
|
int virNetClientSendWithReply(virNetClientPtr client,
|
|
virNetMessagePtr msg);
|
|
|
|
int virNetClientSendNonBlock(virNetClientPtr client,
|
|
virNetMessagePtr msg);
|
|
|
|
int virNetClientSendStream(virNetClientPtr client,
|
|
virNetMessagePtr msg,
|
|
virNetClientStreamPtr st);
|
|
|
|
#ifdef WITH_SASL
|
|
void virNetClientSetSASLSession(virNetClientPtr client,
|
|
virNetSASLSessionPtr sasl);
|
|
#endif
|
|
|
|
int virNetClientSetTLSSession(virNetClientPtr client,
|
|
virNetTLSContextPtr tls);
|
|
|
|
bool virNetClientIsEncrypted(virNetClientPtr client);
|
|
bool virNetClientIsOpen(virNetClientPtr client);
|
|
|
|
const char *virNetClientLocalAddrStringSASL(virNetClientPtr client);
|
|
const char *virNetClientRemoteAddrStringSASL(virNetClientPtr client);
|
|
|
|
int virNetClientGetTLSKeySize(virNetClientPtr client);
|
|
|
|
void virNetClientClose(virNetClientPtr client);
|
|
|
|
bool virNetClientKeepAliveIsSupported(virNetClientPtr client);
|
|
int virNetClientKeepAliveStart(virNetClientPtr client,
|
|
int interval,
|
|
unsigned int count);
|
|
|
|
void virNetClientKeepAliveStop(virNetClientPtr client);
|