GUAC-1171: Move SFTP functions to own header.

This commit is contained in:
Michael Jumper 2015-07-09 12:05:57 -07:00
parent fbcf8a1e0d
commit ed70281766
5 changed files with 110 additions and 51 deletions

View File

@ -26,9 +26,11 @@ ACLOCAL_AMFLAGS = -I m4
noinst_LTLIBRARIES = libguac_common_ssh.la noinst_LTLIBRARIES = libguac_common_ssh.la
libguac_common_ssh_la_SOURCES = \ libguac_common_ssh_la_SOURCES = \
guac_sftp.c \
guac_ssh.c guac_ssh.c
noinst_HEADERS = \ noinst_HEADERS = \
guac_sftp.h \
guac_ssh.h guac_ssh.h
libguac_common_ssh_la_CFLAGS = \ libguac_common_ssh_la_CFLAGS = \

View File

@ -0,0 +1,41 @@
/*
* Copyright (C) 2015 Glyptodon LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#include "guac_ssh.h"
#include <guacamole/client.h>
#include <guacamole/object.h>
#include <libssh2.h>
guac_object* guac_common_ssh_create_sftp_filesystem(guac_client* client,
const char* name, LIBSSH2_SESSION* session) {
/* STUB */
return NULL;
}
void guac_common_ssh_destroy_sftp_filesystem(guac_client* client,
guac_object* filesystem) {
/* STUB */
}

View File

@ -0,0 +1,67 @@
/*
* Copyright (C) 2015 Glyptodon LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#ifndef GUAC_COMMON_SSH_SFTP_H
#define GUAC_COMMON_SSH_SFTP_H
#include <guacamole/client.h>
#include <guacamole/object.h>
#include <libssh2.h>
/**
* Creates a new Guacamole filesystem object which provides access to files
* and directories via SFTP using the given SSH session. When the filesystem
* will no longer be used, it must be explicitly destroyed with
* guac_common_ssh_destroy_sftp_filesystem().
*
* @param client
* The Guacamole client which will be associated with the new filesystem
* object.
*
* @param name
* The name to send as the name of the filesystem.
*
* @param session
* The session to use to provide SFTP.
*
* @return
* A new Guacamole filesystem object, already configured to use SFTP for
* uploading and downloading files.
*/
guac_object* guac_common_ssh_create_sftp_filesystem(guac_client* client,
const char* name, LIBSSH2_SESSION* session);
/**
* Destroys the given filesystem object, disconnecting from SFTP and freeing
* and associated resources.
*
* @param client
* The client associated with the filesystem object.
*
* @param object
* The filesystem object to destroy.
*/
void guac_common_ssh_destroy_sftp_filesystem(guac_client* client,
guac_object* filesystem);
#endif

View File

@ -23,7 +23,6 @@
#include "guac_ssh.h" #include "guac_ssh.h"
#include <guacamole/client.h> #include <guacamole/client.h>
#include <guacamole/object.h>
#include <libssh2.h> #include <libssh2.h>
#ifdef LIBSSH2_USES_GCRYPT #ifdef LIBSSH2_USES_GCRYPT
@ -147,16 +146,3 @@ LIBSSH2_SESSION* guac_common_ssh_connect_private_key(const char* hostname,
} }
guac_object* guac_common_ssh_create_sftp_filesystem(guac_client* client,
const char* name, LIBSSH2_SESSION* session) {
/* STUB */
return NULL;
}
void guac_common_ssh_destroy_sftp_filesystem(guac_client* client,
guac_object* filesystem) {
/* STUB */
}

View File

@ -24,7 +24,6 @@
#define GUAC_COMMON_SSH_H #define GUAC_COMMON_SSH_H
#include <guacamole/client.h> #include <guacamole/client.h>
#include <guacamole/object.h>
#include <libssh2.h> #include <libssh2.h>
/** /**
@ -98,41 +97,5 @@ LIBSSH2_SESSION* guac_common_ssh_connect_private_key(const char* hostname,
int port, const char* username, const char* private_key, int port, const char* username, const char* private_key,
const char* passphrase); const char* passphrase);
/**
* Creates a new Guacamole filesystem object which provides access to files
* and directories via SFTP using the given SSH session. When the filesystem
* will no longer be used, it must be explicitly destroyed with
* guac_common_ssh_destroy_sftp_filesystem().
*
* @param client
* The Guacamole client which will be associated with the new filesystem
* object.
*
* @param name
* The name to send as the name of the filesystem.
*
* @param session
* The session to use to provide SFTP.
*
* @return
* A new Guacamole filesystem object, already configured to use SFTP for
* uploading and downloading files.
*/
guac_object* guac_common_ssh_create_sftp_filesystem(guac_client* client,
const char* name, LIBSSH2_SESSION* session);
/**
* Destroys the given filesystem object, disconnecting from SFTP and freeing
* and associated resources.
*
* @param client
* The client associated with the filesystem object.
*
* @param object
* The filesystem object to destroy.
*/
void guac_common_ssh_destroy_sftp_filesystem(guac_client* client,
guac_object* filesystem);
#endif #endif