437 lines
10 KiB
C
437 lines
10 KiB
C
/*
|
|
* Copyright (C) 2013 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_RDP_SETTINGS_H
|
|
#define __GUAC_RDP_SETTINGS_H
|
|
|
|
#include "config.h"
|
|
|
|
#include "rdp_keymap.h"
|
|
|
|
#include <freerdp/freerdp.h>
|
|
|
|
/**
|
|
* The maximum number of bytes in the client hostname claimed during
|
|
* connection.
|
|
*/
|
|
#define RDP_CLIENT_HOSTNAME_SIZE 32
|
|
|
|
/**
|
|
* The default RDP port.
|
|
*/
|
|
#define RDP_DEFAULT_PORT 3389
|
|
|
|
/**
|
|
* Default screen width, in pixels.
|
|
*/
|
|
#define RDP_DEFAULT_WIDTH 1024
|
|
|
|
/**
|
|
* Default screen height, in pixels.
|
|
*/
|
|
#define RDP_DEFAULT_HEIGHT 768
|
|
|
|
/**
|
|
* Default color depth, in bits.
|
|
*/
|
|
#define RDP_DEFAULT_DEPTH 16
|
|
|
|
/**
|
|
* The filename to use for the screen recording, if not specified.
|
|
*/
|
|
#define GUAC_RDP_DEFAULT_RECORDING_NAME "recording"
|
|
|
|
/**
|
|
* All supported combinations of security types.
|
|
*/
|
|
typedef enum guac_rdp_security {
|
|
|
|
/**
|
|
* Standard RDP encryption.
|
|
*/
|
|
GUAC_SECURITY_RDP,
|
|
|
|
/**
|
|
* TLS encryption.
|
|
*/
|
|
GUAC_SECURITY_TLS,
|
|
|
|
/**
|
|
* Network level authentication.
|
|
*/
|
|
GUAC_SECURITY_NLA,
|
|
|
|
/**
|
|
* Any method supported by the server.
|
|
*/
|
|
GUAC_SECURITY_ANY
|
|
|
|
} guac_rdp_security;
|
|
|
|
/**
|
|
* All settings supported by the Guacamole RDP client.
|
|
*/
|
|
typedef struct guac_rdp_settings {
|
|
|
|
/**
|
|
* The hostname to connect to.
|
|
*/
|
|
char* hostname;
|
|
|
|
/**
|
|
* The port to connect to.
|
|
*/
|
|
int port;
|
|
|
|
/**
|
|
* The domain of the user logging in.
|
|
*/
|
|
char* domain;
|
|
|
|
/**
|
|
* The username of the user logging in.
|
|
*/
|
|
char* username;
|
|
|
|
/**
|
|
* The password of the user logging in.
|
|
*/
|
|
char* password;
|
|
|
|
/**
|
|
* The color depth of the display to request, in bits.
|
|
*/
|
|
int color_depth;
|
|
|
|
/**
|
|
* The width of the display to request, in pixels.
|
|
*/
|
|
int width;
|
|
|
|
/**
|
|
* The height of the display to request, in pixels.
|
|
*/
|
|
int height;
|
|
|
|
/**
|
|
* The DPI of the remote display to assume when converting between
|
|
* client pixels and remote pixels.
|
|
*/
|
|
int resolution;
|
|
|
|
/**
|
|
* Whether audio is enabled.
|
|
*/
|
|
int audio_enabled;
|
|
|
|
/**
|
|
* Whether printing is enabled.
|
|
*/
|
|
int printing_enabled;
|
|
|
|
/**
|
|
* Whether the virtual drive is enabled.
|
|
*/
|
|
int drive_enabled;
|
|
|
|
/**
|
|
* The local system path which will be used to persist the
|
|
* virtual drive.
|
|
*/
|
|
char* drive_path;
|
|
|
|
/**
|
|
* Whether to automatically create the local system path if it does not
|
|
* exist.
|
|
*/
|
|
int create_drive_path;
|
|
|
|
/**
|
|
* Whether this session is a console session.
|
|
*/
|
|
int console;
|
|
|
|
/**
|
|
* Whether to allow audio in the console session.
|
|
*/
|
|
int console_audio;
|
|
|
|
/**
|
|
* The keymap chosen as the layout of the server.
|
|
*/
|
|
const guac_rdp_keymap* server_layout;
|
|
|
|
/**
|
|
* The initial program to run, if any.
|
|
*/
|
|
char* initial_program;
|
|
|
|
/**
|
|
* The name of the client to submit to the RDP server upon connection, or
|
|
* NULL if the name is not specified.
|
|
*/
|
|
char* client_name;
|
|
|
|
/**
|
|
* The type of security to use for the connection.
|
|
*/
|
|
guac_rdp_security security_mode;
|
|
|
|
/**
|
|
* Whether bad server certificates should be ignored.
|
|
*/
|
|
int ignore_certificate;
|
|
|
|
/**
|
|
* Whether authentication should be disabled. This is different from the
|
|
* authentication that takes place when a user provides their username
|
|
* and password. Authentication is required by definition for NLA.
|
|
*/
|
|
int disable_authentication;
|
|
|
|
/**
|
|
* The application to launch, if RemoteApp is in use.
|
|
*/
|
|
char* remote_app;
|
|
|
|
/**
|
|
* The working directory of the remote application, if RemoteApp is in use.
|
|
*/
|
|
char* remote_app_dir;
|
|
|
|
/**
|
|
* The arguments to pass to the remote application, if RemoteApp is in use.
|
|
*/
|
|
char* remote_app_args;
|
|
|
|
/**
|
|
* NULL-terminated list of all static virtual channel names, or NULL if
|
|
* no channels whatsoever.
|
|
*/
|
|
char** svc_names;
|
|
|
|
/**
|
|
* Whether the desktop wallpaper should be visible. If unset, the desktop
|
|
* wallpaper will be hidden, reducing the amount of bandwidth required.
|
|
*/
|
|
int wallpaper_enabled;
|
|
|
|
/**
|
|
* Whether desktop and window theming should be allowed. If unset, theming
|
|
* is temporarily disabled on the desktop of the RDP server for the sake of
|
|
* performance, reducing the amount of bandwidth required.
|
|
*/
|
|
int theming_enabled;
|
|
|
|
/**
|
|
* Whether glyphs should be smoothed with antialiasing (ClearType). If
|
|
* unset, glyphs will be rendered with sharp edges and using single colors,
|
|
* effectively 1-bit images, reducing the amount of bandwidth required.
|
|
*/
|
|
int font_smoothing_enabled;
|
|
|
|
/**
|
|
* Whether windows contents should be shown as they are moved. If unset,
|
|
* only a window border will be shown during window move operations,
|
|
* reducing the amount of bandwidth required.
|
|
*/
|
|
int full_window_drag_enabled;
|
|
|
|
/**
|
|
* Whether desktop composition (Aero) should be enabled during the session.
|
|
* As desktop composition provides alpha blending and other special
|
|
* effects, this increases the amount of bandwidth used. If unset, desktop
|
|
* composition will be disabled.
|
|
*/
|
|
int desktop_composition_enabled;
|
|
|
|
/**
|
|
* Whether menu animations should be shown. If unset, menus will not be
|
|
* animated, reducing the amount of bandwidth required.
|
|
*/
|
|
int menu_animations_enabled;
|
|
|
|
/**
|
|
* The preconnection ID to send within the preconnection PDU when
|
|
* initiating an RDP connection, if any. If no preconnection ID is
|
|
* specified, this will be -1.
|
|
*/
|
|
int preconnection_id;
|
|
|
|
/**
|
|
* The preconnection BLOB (PCB) to send to the RDP server prior to full RDP
|
|
* connection negotiation. This value is used by Hyper-V to select the
|
|
* destination VM.
|
|
*/
|
|
char* preconnection_blob;
|
|
|
|
#ifdef ENABLE_COMMON_SSH
|
|
/**
|
|
* Whether SFTP should be enabled for the VNC connection.
|
|
*/
|
|
int enable_sftp;
|
|
|
|
/**
|
|
* The hostname of the SSH server to connect to for SFTP.
|
|
*/
|
|
char* sftp_hostname;
|
|
|
|
/**
|
|
* The port of the SSH server to connect to for SFTP.
|
|
*/
|
|
char* sftp_port;
|
|
|
|
/**
|
|
* The username to provide when authenticating with the SSH server for
|
|
* SFTP.
|
|
*/
|
|
char* sftp_username;
|
|
|
|
/**
|
|
* The password to provide when authenticating with the SSH server for
|
|
* SFTP (if not using a private key).
|
|
*/
|
|
char* sftp_password;
|
|
|
|
/**
|
|
* The base64-encoded private key to use when authenticating with the SSH
|
|
* server for SFTP (if not using a password).
|
|
*/
|
|
char* sftp_private_key;
|
|
|
|
/**
|
|
* The passphrase to use to decrypt the provided base64-encoded private
|
|
* key.
|
|
*/
|
|
char* sftp_passphrase;
|
|
|
|
/**
|
|
* The default location for file uploads within the SSH server. This will
|
|
* apply only to uploads which do not use the filesystem guac_object (where
|
|
* the destination directory is otherwise ambiguous).
|
|
*/
|
|
char* sftp_directory;
|
|
#endif
|
|
|
|
/**
|
|
* The path in which the screen recording should be saved, if enabled. If
|
|
* no screen recording should be saved, this will be NULL.
|
|
*/
|
|
char* recording_path;
|
|
|
|
/**
|
|
* The filename to use for the screen recording, if enabled.
|
|
*/
|
|
char* recording_name;
|
|
|
|
/**
|
|
* Whether the screen recording path should be automatically created if it
|
|
* does not already exist.
|
|
*/
|
|
int create_recording_path;
|
|
|
|
} guac_rdp_settings;
|
|
|
|
/**
|
|
* Parses all given args, storing them in a newly-allocated settings object. If
|
|
* the args fail to parse, NULL is returned.
|
|
*
|
|
* @param user
|
|
* The user who submitted the given arguments while joining the
|
|
* connection.
|
|
*
|
|
* @param argc
|
|
* The number of arguments within the argv array.
|
|
*
|
|
* @param argv
|
|
* The values of all arguments provided by the user.
|
|
*
|
|
* @return
|
|
* A newly-allocated settings object which must be freed with
|
|
* guac_rdp_settings_free() when no longer needed. If the arguments fail
|
|
* to parse, NULL is returned.
|
|
*/
|
|
guac_rdp_settings* guac_rdp_parse_args(guac_user* user,
|
|
int argc, const char** argv);
|
|
|
|
/**
|
|
* Frees the given guac_rdp_settings object, having been previously allocated
|
|
* via guac_rdp_parse_args().
|
|
*
|
|
* @param settings
|
|
* The settings object to free.
|
|
*/
|
|
void guac_rdp_settings_free(guac_rdp_settings* settings);
|
|
|
|
/**
|
|
* NULL-terminated array of accepted client args.
|
|
*/
|
|
extern const char* GUAC_RDP_CLIENT_ARGS[];
|
|
|
|
/**
|
|
* Save all given settings to the given freerdp instance.
|
|
*
|
|
* @param guac_settings
|
|
* The guac_rdp_settings object to save.
|
|
*
|
|
* @param rdp
|
|
* The RDP instance to save settings to.
|
|
*/
|
|
void guac_rdp_push_settings(guac_rdp_settings* guac_settings, freerdp* rdp);
|
|
|
|
/**
|
|
* Returns the width of the RDP session display.
|
|
*
|
|
* @param rdp
|
|
* The RDP instance to retrieve the width from.
|
|
*
|
|
* @return
|
|
* The current width of the RDP display, in pixels.
|
|
*/
|
|
int guac_rdp_get_width(freerdp* rdp);
|
|
|
|
/**
|
|
* Returns the height of the RDP session display.
|
|
*
|
|
* @param rdp
|
|
* The RDP instance to retrieve the height from.
|
|
*
|
|
* @return
|
|
* The current height of the RDP display, in pixels.
|
|
*/
|
|
int guac_rdp_get_height(freerdp* rdp);
|
|
|
|
/**
|
|
* Returns the depth of the RDP session display.
|
|
*
|
|
* @param rdp
|
|
* The RDP instance to retrieve the depth from.
|
|
*
|
|
* @return
|
|
* The current depth of the RDP display, in bits per pixel.
|
|
*/
|
|
int guac_rdp_get_depth(freerdp* rdp);
|
|
|
|
#endif
|
|
|