22#include <freerdp/config.h>
23#include <freerdp/utils/helpers.h>
28#include <winpr/assert.h>
29#include <winpr/string.h>
31#include <winpr/wlog.h>
32#include <winpr/path.h>
33#include <winpr/ncrypt.h>
34#include <winpr/environment.h>
35#include <winpr/timezone.h>
37#include <freerdp/freerdp.h>
38#include <freerdp/addin.h>
39#include <freerdp/settings.h>
40#include <freerdp/client.h>
41#include <freerdp/client/channels.h>
42#include <freerdp/channels/drdynvc.h>
43#include <freerdp/channels/cliprdr.h>
44#include <freerdp/channels/encomsp.h>
45#include <freerdp/channels/rdpear.h>
46#include <freerdp/channels/rdp2tcp.h>
47#include <freerdp/channels/remdesk.h>
48#include <freerdp/channels/rdpsnd.h>
49#include <freerdp/channels/disp.h>
50#include <freerdp/crypto/crypto.h>
51#include <freerdp/locale/keyboard.h>
52#include <freerdp/utils/passphrase.h>
53#include <freerdp/utils/proxy_utils.h>
54#include <freerdp/utils/string.h>
55#include <freerdp/channels/urbdrc.h>
56#include <freerdp/channels/rdpdr.h>
57#include <freerdp/locale/locale.h>
59#if defined(CHANNEL_AINPUT_CLIENT)
60#include <freerdp/channels/ainput.h>
63#include <freerdp/channels/audin.h>
64#include <freerdp/channels/echo.h>
66#include <freerdp/client/cmdline.h>
67#include <freerdp/version.h>
68#include <freerdp/client/utils/smartcard_cli.h>
70#include <openssl/tls1.h>
73#include <freerdp/log.h>
74#define TAG CLIENT_TAG("common.cmdline")
76static const char str_force[] =
"force";
78static const char* credential_args[] = {
"p",
"smartcard-logon",
79#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
82 "pth",
"reconnect-cookie",
85static const char* option_starts_with(
const char* what,
const char* val);
86static BOOL option_ends_with(
const char* str,
const char* ext);
87static BOOL option_equals(
const char* what,
const char* val);
89static BOOL freerdp_client_print_codepages(
const char* arg)
93 const char* filter = NULL;
98 filter = strchr(arg,
',');
104 pages = freerdp_keyboard_get_matching_codepages(column, filter, &count);
108 printf(
"%-10s %-8s %-60s %-36s %-48s\n",
"<id>",
"<locale>",
"<win langid>",
"<language>",
110 for (
size_t x = 0; x < count; x++)
113 char buffer[2048] = { 0 };
115 if (strnlen(page->subLanguageSymbol, ARRAYSIZE(page->subLanguageSymbol)) > 0)
116 (void)_snprintf(buffer,
sizeof(buffer),
"[%s|%s]", page->primaryLanguageSymbol,
117 page->subLanguageSymbol);
119 (
void)_snprintf(buffer,
sizeof(buffer),
"[%s]", page->primaryLanguageSymbol);
120 printf(
"id=0x%04" PRIx16
": [%-6s] %-60s %-36s %-48s\n", page->id, page->locale, buffer,
121 page->primaryLanguage, page->subLanguage);
123 freerdp_codepages_free(pages);
127static BOOL freerdp_path_valid(
const char* path, BOOL* special)
129 const char DynamicDrives[] =
"DynamicDrives";
136 (option_equals(
"*", path) || option_equals(DynamicDrives, path) || option_equals(
"%", path))
140 isPath = winpr_PathFileExists(path);
143 *special = isSpecial;
145 return isSpecial || isPath;
148static BOOL freerdp_sanitize_drive_name(
char* name,
const char* invalid,
const char* replacement)
150 if (!name || !invalid || !replacement)
152 if (strlen(invalid) != strlen(replacement))
155 while (*invalid !=
'\0')
157 const char what = *invalid++;
158 const char with = *replacement++;
161 while ((cur = strchr(cur, what)) != NULL)
167static char* name_from_path(
const char* path)
169 const char* name =
"NULL";
172 if (option_equals(
"%", path))
174 else if (option_equals(
"*", path))
175 name =
"hotplug-all";
176 else if (option_equals(
"DynamicDrives", path))
181 return _strdup(name);
184static BOOL freerdp_client_add_drive(rdpSettings* settings,
const char* path,
const char* name)
205 if (!skip && winpr_PathFileExists(name))
207 if (!winpr_PathFileExists(path) || (!PathIsRelativeA(name) && PathIsRelativeA(path)))
209 const char* tmp = path;
217 dname = _strdup(name);
219 dname = name_from_path(path);
221 if (freerdp_sanitize_drive_name(dname,
"\\/",
"__"))
223 const char* args[] = { dname, path };
224 device = freerdp_device_new(RDPDR_DTYP_FILESYSTEM, ARRAYSIZE(args), args);
234 BOOL isSpecial = FALSE;
235 BOOL isPath = freerdp_path_valid(path, &isSpecial);
237 if (!isPath && !isSpecial)
239 WLog_WARN(TAG,
"Invalid drive to redirect: '%s' does not exist, skipping.", path);
240 freerdp_device_free(device);
242 else if (!freerdp_device_collection_add(settings, device))
249 freerdp_device_free(device);
253static BOOL value_to_int(
const char* value, LONGLONG* result, LONGLONG min, LONGLONG max)
257 if (!value || !result)
261 rc = _strtoi64(value, NULL, 0);
266 if ((rc < min) || (rc > max))
273static BOOL value_to_uint(
const char* value, ULONGLONG* result, ULONGLONG min, ULONGLONG max)
275 unsigned long long rc = 0;
277 if (!value || !result)
281 rc = _strtoui64(value, NULL, 0);
286 if ((rc < min) || (rc > max))
293BOOL freerdp_client_print_version(
void)
295 printf(
"This is FreeRDP version %s (%s)\n", FREERDP_VERSION_FULL, FREERDP_GIT_REVISION);
299BOOL freerdp_client_print_version_ex(
int argc,
char** argv)
301 WINPR_ASSERT(argc >= 0);
302 WINPR_ASSERT(argv || (argc == 0));
303 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
304 printf(
"This is FreeRDP version [%s] %s (%s)\n", name, FREERDP_VERSION_FULL,
305 FREERDP_GIT_REVISION);
309BOOL freerdp_client_print_buildconfig(
void)
311 printf(
"%s", freerdp_get_build_config());
315BOOL freerdp_client_print_buildconfig_ex(
int argc,
char** argv)
317 WINPR_ASSERT(argc >= 0);
318 WINPR_ASSERT(argv || (argc == 0));
319 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
320 printf(
"[%s] %s", name, freerdp_get_build_config());
324static void freerdp_client_print_scancodes(
void)
326 printf(
"RDP scancodes and their name for use with /kbd:remap\n");
328 for (UINT32 x = 0; x < UINT16_MAX; x++)
330 const char* name = freerdp_keyboard_scancode_name(x);
332 printf(
"0x%04" PRIx32
" --> %s\n", x, name);
336static BOOL is_delimiter(
char c,
const char* delimiters)
339 while ((d = *delimiters++) !=
'\0')
347static const char* get_last(
const char* start,
size_t len,
const char* delimiters)
349 const char* last = NULL;
350 for (
size_t x = 0; x < len; x++)
353 if (is_delimiter(c, delimiters))
359static SSIZE_T next_delimiter(
const char* text,
size_t len,
size_t max,
const char* delimiters)
364 const char* last = get_last(text, max, delimiters);
368 return (SSIZE_T)(last - text);
371static SSIZE_T forced_newline_at(
const char* text,
size_t len,
size_t limit,
372 const char* force_newline)
375 while ((d = *force_newline++) !=
'\0')
377 const char* tok = strchr(text, d);
380 const size_t offset = WINPR_ASSERTING_INT_CAST(
size_t, tok - text);
381 if ((offset > len) || (offset > limit))
383 return (SSIZE_T)(offset);
389static BOOL print_align(
size_t start_offset,
size_t* current)
391 WINPR_ASSERT(current);
392 if (*current < start_offset)
394 const int rc = printf(
"%*c", (
int)(start_offset - *current),
' ');
397 *current += (size_t)rc;
402static char* print_token(
char* text,
size_t start_offset,
size_t* current,
size_t limit,
403 const char* delimiters,
const char* force_newline)
406 const size_t tlen = strnlen(text, limit);
408 const SSIZE_T force_at = forced_newline_at(text, len, limit - *current, force_newline);
409 BOOL isForce = (force_at >= 0);
412 len = MIN(len, (
size_t)force_at);
414 if (!print_align(start_offset, current))
417 const SSIZE_T delim = next_delimiter(text, len, limit - *current, delimiters);
418 const BOOL isDelim = delim > 0;
421 len = MIN(len, (
size_t)delim + 1);
424 rc = printf(
"%.*s", (
int)len, text);
428 if (isForce || isDelim)
433 const size_t offset = len + ((isForce && (force_at == 0)) ? 1 : 0);
434 return &text[offset];
437 *current += (size_t)rc;
439 if (tlen == (
size_t)rc)
441 return &text[(size_t)rc];
444static size_t print_optionals(
const char* text,
size_t start_offset,
size_t current)
446 const size_t limit = 80;
447 char* str = _strdup(text);
452 cur = print_token(cur, start_offset + 1, ¤t, limit,
"[], ",
"\r\n");
453 }
while (cur != NULL);
459static size_t print_description(
const char* text,
size_t start_offset,
size_t current)
461 const size_t limit = 80;
462 char* str = _strdup(text);
466 cur = print_token(cur, start_offset, ¤t, limit,
" ",
"\r\n");
469 const int rc = printf(
"\n");
472 const size_t src = WINPR_ASSERTING_INT_CAST(
size_t, rc);
473 WINPR_ASSERT(SIZE_MAX - src > current);
479static int cmp_cmdline_args(
const void* pva,
const void* pvb)
484 if (!a->Name && !b->Name)
490 return strcmp(a->Name, b->Name);
505 const size_t description_offset = 30 + 8;
507 if (arg->Flags & (COMMAND_LINE_VALUE_BOOL | COMMAND_LINE_VALUE_FLAG))
509 if ((arg->Flags & (uint32_t)~COMMAND_LINE_VALUE_BOOL) == 0)
510 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
511 else if ((arg->Flags & COMMAND_LINE_VALUE_OPTIONAL) != 0)
512 rc = printf(
" [%s|/]%s", arg->Default ?
"-" :
"+", arg->Name);
515 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
519 rc = printf(
" /%s", arg->Name);
525 if ((arg->Flags & COMMAND_LINE_VALUE_REQUIRED) ||
526 (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL))
530 if (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL)
536 pos = print_optionals(arg->Format, pos, pos);
548 pos = print_optionals(arg->Format, pos, pos);
551 if (pos > description_offset)
559 rc = printf(
"%*c", (
int)(description_offset - pos),
' ');
564 if (arg->Flags & COMMAND_LINE_VALUE_BOOL)
566 rc = printf(
"%s ", arg->Default ?
"Disable" :
"Enable");
572 print_description(arg->Text, description_offset, pos);
573 }
while ((arg = CommandLineFindNextArgumentA(arg)) != NULL);
576BOOL freerdp_client_print_command_line_help(
int argc,
char** argv)
578 return freerdp_client_print_command_line_help_ex(argc, argv, NULL);
582 SSIZE_T count,
size_t* pcount)
584 WINPR_ASSERT(pcount);
589 while (cur && cur->Name)
604 while (cur && cur->Name)
606 largs[lcount++] = *cur++;
609 cur = global_cmd_args;
610 while (cur && cur->Name)
612 largs[lcount++] = *cur++;
618BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
621 const char* name = freerdp_getApplicationDetailsString();
633 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
634 printf(
"See www.freerdp.com for more information\n");
636 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
639 printf(
" /flag (enables flag)\n");
640 printf(
" /option:<value> (specifies option with value)\n");
641 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
644 freerdp_client_print_command_line_args(largs, lcount);
648 printf(
"Examples:\n");
649 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
650 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
651 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
652 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
653 "/v:192.168.1.100\n",
655 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
656 printf(
"Use a generic pipe as transport:");
657 printf(
" %s /v:/path/to/pipe\n", name);
658 printf(
"Use a external socket:");
659 printf(
" %s /v:|:1234\n", name);
661 printf(
"Clipboard Redirection: +clipboard\n");
663 printf(
"Drive Redirection: /drive:home,/home/user\n");
664 printf(
"Smartcard Redirection: /smartcard:<device>\n");
665 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
667#if defined(CHANNEL_SERIAL_CLIENT)
668 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
669 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
671#if defined(CHANNEL_PARALLEL_CLIENT)
672 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
674 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
675 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
677 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
678 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
679 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
680 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
682 printf(
"Multimedia Redirection: /video\n");
683#ifdef CHANNEL_URBDRC_CLIENT
684 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
687 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
689 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
691 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
693 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
695 printf(
"More documentation is coming, in the meantime consult source files\n");
700static BOOL option_is_rdp_file(
const char* option)
702 WINPR_ASSERT(option);
704 if (option_ends_with(option,
".rdp"))
706 if (option_ends_with(option,
".rdpw"))
711static BOOL option_is_incident_file(
const char* option)
713 WINPR_ASSERT(option);
715 if (option_ends_with(option,
".msrcIncident"))
720static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
725 rdpSettings* settings = NULL;
730 length = strlen(argv[index]);
734 if (option_is_rdp_file(argv[index]))
736 settings = (rdpSettings*)context;
739 return COMMAND_LINE_ERROR_MEMORY;
747 if (option_is_incident_file(argv[index]))
749 settings = (rdpSettings*)context;
752 return COMMAND_LINE_ERROR_MEMORY;
762BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
763 const char*
const* params)
765 WINPR_ASSERT(settings);
766 WINPR_ASSERT(params);
767 WINPR_ASSERT(count > 0);
769 if (option_equals(params[0],
"drive"))
778 rc = freerdp_client_add_drive(settings, params[1], NULL);
780 rc = freerdp_client_add_drive(settings, params[2], params[1]);
784 else if (option_equals(params[0],
"printer"))
796 printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
800 if (!freerdp_device_collection_add(settings, printer))
802 freerdp_device_free(printer);
808 else if (option_equals(params[0],
"smartcard"))
820 smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
825 if (!freerdp_device_collection_add(settings, smartcard))
827 freerdp_device_free(smartcard);
833#if defined(CHANNEL_SERIAL_CLIENT)
834 else if (option_equals(params[0],
"serial"))
846 serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
851 if (!freerdp_device_collection_add(settings, serial))
853 freerdp_device_free(serial);
860 else if (option_equals(params[0],
"parallel"))
872 parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
877 if (!freerdp_device_collection_add(settings, parallel))
879 freerdp_device_free(parallel);
889BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
891 return freerdp_static_channel_collection_del(settings, name);
894BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
895 const char*
const* params)
899 if (!settings || !params || !params[0] || (count > INT_MAX))
902 if (freerdp_static_channel_collection_find(settings, params[0]))
905 _args = freerdp_addin_argv_new(count, params);
910 if (!freerdp_static_channel_collection_add(settings, _args))
915 freerdp_addin_argv_free(_args);
919BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
921 return freerdp_dynamic_channel_collection_del(settings, name);
924BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
925 const char*
const* params)
929 if (!settings || !params || !params[0] || (count > INT_MAX))
932 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
935 _args = freerdp_addin_argv_new(count, params);
940 if (!freerdp_dynamic_channel_collection_add(settings, _args))
946 freerdp_addin_argv_free(_args);
950static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
const char* file)
953 char* pem = crypto_read_pem(file, &length);
954 if (!pem || (length == 0))
968 CMDLINE_SUBOPTION_STRING,
969 CMDLINE_SUBOPTION_FILE,
970} CmdLineSubOptionType;
972typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
976 FreeRDP_Settings_Keys_String id;
977 CmdLineSubOptionType opttype;
978 CmdLineSubOptionCb cb;
981static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
986 for (
size_t xx = 0; xx < count; xx++)
988 const CmdLineSubOptions* opt = &opts[xx];
990 if (option_starts_with(opt->optname, arg))
992 const size_t optlen = strlen(opt->optname);
993 const char* val = &arg[optlen];
996 switch (opt->opttype)
998 case CMDLINE_SUBOPTION_STRING:
1001 case CMDLINE_SUBOPTION_FILE:
1002 status = read_pem_file(settings, opt->id, val);
1005 WLog_ERR(TAG,
"invalid subOption type");
1012 if (opt->cb && !opt->cb(val, settings))
1021 WLog_ERR(TAG,
"option %s not handled", arg);
1026#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1033 const DWORD level = WLOG_ERROR;
1034 wLog* log = WLog_Get(TAG);
1035 if (WLog_IsLevelActive(log, level))
1036 WLog_PrintTextMessage(log, level, line, file, fkt,
1037 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name,
1044 rdpSettings* settings = (rdpSettings*)context;
1045 int status = CHANNEL_RC_OK;
1046 BOOL enable = arg->Value ? TRUE : FALSE;
1048 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1051 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1053 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1054 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1056 status = COMMAND_LINE_ERROR;
1058 CommandLineParserFree(ptr);
1060 return fail_at(arg, status);
1062 CommandLineSwitchCase(arg,
"kerberos")
1066 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1069 const CmdLineSubOptions opts[] = {
1070 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING, NULL },
1071 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING, NULL },
1072 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING, NULL },
1073 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1074 CMDLINE_SUBOPTION_STRING, NULL },
1075 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING, NULL },
1076 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING, NULL },
1077 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING, NULL },
1078 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING, NULL }
1081 for (
size_t x = 1; x < count; x++)
1083 const char* cur = ptr[x];
1084 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1086 CommandLineParserFree(ptr);
1087 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1091 CommandLineParserFree(ptr);
1094 CommandLineSwitchCase(arg,
"vc")
1097 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1098 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1099 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1100 CommandLineParserFree(ptr);
1102 return fail_at(arg, status);
1104 CommandLineSwitchCase(arg,
"dvc")
1107 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1108 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1109 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1110 CommandLineParserFree(ptr);
1112 return fail_at(arg, status);
1114 CommandLineSwitchCase(arg,
"drive")
1117 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1118 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1119 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1120 CommandLineParserFree(ptr);
1122 return fail_at(arg, status);
1124#if defined(CHANNEL_SERIAL_CLIENT)
1125 CommandLineSwitchCase(arg,
"serial")
1128 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1129 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1130 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1131 CommandLineParserFree(ptr);
1133 return fail_at(arg, status);
1136#if defined(CHANNEL_PARALLEL_CLIENT)
1137 CommandLineSwitchCase(arg,
"parallel")
1140 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1141 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1142 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1143 CommandLineParserFree(ptr);
1145 return fail_at(arg, status);
1148 CommandLineSwitchCase(arg,
"smartcard")
1151 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1152 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1153 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1154 CommandLineParserFree(ptr);
1156 return fail_at(arg, status);
1158 CommandLineSwitchCase(arg,
"printer")
1161 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1162 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1163 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1164 CommandLineParserFree(ptr);
1166 return fail_at(arg, status);
1168 CommandLineSwitchCase(arg,
"usb")
1172 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1173 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1174 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1175 CommandLineParserFree(ptr);
1177 return fail_at(arg, status);
1179 CommandLineSwitchCase(arg,
"multitouch")
1182 return fail_at(arg, COMMAND_LINE_ERROR);
1184 CommandLineSwitchCase(arg,
"gestures")
1187 return fail_at(arg, COMMAND_LINE_ERROR);
1189 CommandLineSwitchCase(arg,
"echo")
1192 return fail_at(arg, COMMAND_LINE_ERROR);
1194 CommandLineSwitchCase(arg,
"ssh-agent")
1197 return fail_at(arg, COMMAND_LINE_ERROR);
1199 CommandLineSwitchCase(arg,
"disp")
1202 return fail_at(arg, COMMAND_LINE_ERROR);
1204 CommandLineSwitchCase(arg,
"geometry")
1207 return fail_at(arg, COMMAND_LINE_ERROR);
1209 CommandLineSwitchCase(arg,
"video")
1213 return fail_at(arg, COMMAND_LINE_ERROR);
1215 return fail_at(arg, COMMAND_LINE_ERROR);
1217 CommandLineSwitchCase(arg,
"sound")
1221 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1222 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1223 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1224 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1225 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1227 CommandLineParserFree(ptr);
1229 return fail_at(arg, status);
1231 CommandLineSwitchCase(arg,
"microphone")
1234 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1235 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1236 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1237 CommandLineParserFree(ptr);
1239 return fail_at(arg, status);
1241#if defined(CHANNEL_TSMF_CLIENT)
1242 CommandLineSwitchCase(arg,
"multimedia")
1245 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1246 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1247 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1248 CommandLineParserFree(ptr);
1250 return fail_at(arg, status);
1253 CommandLineSwitchCase(arg,
"heartbeat")
1256 return fail_at(arg, COMMAND_LINE_ERROR);
1258 CommandLineSwitchCase(arg,
"multitransport")
1261 return fail_at(arg, COMMAND_LINE_ERROR);
1266 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1269 return fail_at(arg, COMMAND_LINE_ERROR);
1271 CommandLineSwitchEnd(arg)
1278 int status = freerdp_client_command_line_post_filter_int(context, arg);
1279 return status == CHANNEL_RC_OK ? 1 : -1;
1282static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1283 const char** domain,
size_t* domainlen)
1286 WINPR_ASSERT(userlen);
1287 WINPR_ASSERT(domain);
1288 WINPR_ASSERT(domainlen);
1293 const char* p = strchr(username,
'\\');
1303 const size_t length = (size_t)(p - username);
1305 *userlen = strlen(*user);
1308 *domainlen = length;
1317 *userlen = strlen(username);
1323static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1324 FreeRDP_Settings_Keys_String userID,
1325 FreeRDP_Settings_Keys_String domainID)
1327 const char* user = NULL;
1328 const char* domain = NULL;
1330 size_t domainlen = 0;
1332 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1340BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1342 const char* user = NULL;
1343 const char* domain = NULL;
1345 size_t domainlen = 0;
1350 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1356 *puser = strndup(user, userlen);
1363 *pdomain = strndup(domain, domainlen);
1375BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1378 p = strrchr(hostname,
':');
1382 size_t length = (size_t)(p - hostname);
1385 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1388 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1393 CopyMemory(*host, hostname, length);
1394 (*host)[length] =
'\0';
1395 *port = (UINT16)val;
1399 *host = _strdup(hostname);
1410static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1412 struct network_settings
1414 FreeRDP_Settings_Keys_Bool id;
1417 const struct network_settings config[] = {
1418 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1419 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1420 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1421 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1422 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1423 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1428 case CONNECTION_TYPE_INVALID:
1431 case CONNECTION_TYPE_MODEM:
1432 case CONNECTION_TYPE_BROADBAND_LOW:
1433 case CONNECTION_TYPE_BROADBAND_HIGH:
1434 case CONNECTION_TYPE_SATELLITE:
1435 case CONNECTION_TYPE_WAN:
1436 case CONNECTION_TYPE_LAN:
1437 case CONNECTION_TYPE_AUTODETECT:
1440 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1444 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1446 const struct network_settings* cur = &config[x];
1453BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1461 case CONNECTION_TYPE_INVALID:
1462 case CONNECTION_TYPE_MODEM:
1463 case CONNECTION_TYPE_BROADBAND_LOW:
1464 case CONNECTION_TYPE_SATELLITE:
1465 case CONNECTION_TYPE_BROADBAND_HIGH:
1466 case CONNECTION_TYPE_WAN:
1467 case CONNECTION_TYPE_LAN:
1468 if (!freerdp_apply_connection_type(settings, type))
1471 case CONNECTION_TYPE_AUTODETECT:
1472 if (!freerdp_apply_connection_type(settings, type))
1486 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1493static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1498 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1500 if (!layouts || (count == 0))
1503 for (
size_t x = 0; x < count; x++)
1506 if (option_equals(layout->name, name))
1514 freerdp_keyboard_layouts_free(layouts, count);
1518static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1520 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1521 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1523 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1525 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1533static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1536 WINPR_UNUSED(context);
1543 length = strlen(argv[index]);
1547 if (option_is_rdp_file(argv[index]))
1555 if (option_is_incident_file(argv[index]))
1565static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1570 int detect_status = 0;
1573 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1575 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1576 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1580 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1585 CommandLineClearArgumentsA(largs);
1586 status = CommandLineParseArgumentsA(argc, argv, largs, flags, NULL,
1587 freerdp_detect_command_line_pre_filter, NULL);
1596 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1600 }
while ((arg = CommandLineFindNextArgumentA(arg)) != NULL);
1602 return detect_status;
1605static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1610 int detect_status = 0;
1613 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1615 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1616 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1617 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1621 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1626 CommandLineClearArgumentsA(largs);
1627 status = CommandLineParseArgumentsA(argc, argv, largs, flags, NULL,
1628 freerdp_detect_command_line_pre_filter, NULL);
1637 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1641 }
while ((arg = CommandLineFindNextArgumentA(arg)) != NULL);
1643 return detect_status;
1646static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1648 size_t posix_cli_count = 0;
1649 size_t windows_cli_count = 0;
1650 const BOOL ignoreUnknown = TRUE;
1651 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1652 argc, argv, &windows_cli_count, ignoreUnknown);
1653 const int posix_cli_status =
1654 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1657 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1658 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1659 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1661 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1665 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1666 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1668 windows_cli_count = 1;
1669 *flags = COMMAND_LINE_SEPARATOR_COLON;
1670 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1673 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1674 windows_cli_count, posix_cli_status, posix_cli_count);
1675 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1677 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1683int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1686 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv, NULL);
1689static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1693 layouts = freerdp_keyboard_get_layouts(type, &count);
1695 printf(
"\n%s\n", msg);
1697 for (
size_t x = 0; x < count; x++)
1700 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1703 freerdp_keyboard_layouts_free(layouts, count);
1706static void freerdp_client_print_keyboard_list(
void)
1708 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1709 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1710 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1711 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1712 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1715static void freerdp_client_print_timezone_list(
void)
1719 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1721 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = { 0 };
1723 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1724 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1725 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1729static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1733 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1741 case RDP_SETTINGS_TYPE_BOOL:
1742 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1747 case RDP_SETTINGS_TYPE_UINT16:
1748 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1751 case RDP_SETTINGS_TYPE_INT16:
1752 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1755 case RDP_SETTINGS_TYPE_UINT32:
1756 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1759 case RDP_SETTINGS_TYPE_INT32:
1760 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1763 case RDP_SETTINGS_TYPE_UINT64:
1764 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1767 case RDP_SETTINGS_TYPE_INT64:
1768 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1771 case RDP_SETTINGS_TYPE_STRING:
1772 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1777 case RDP_SETTINGS_TYPE_POINTER:
1778 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1790int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
1791 int argc,
char** argv,
1796 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1798 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
1800 freerdp_client_print_version();
1804 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
1806 freerdp_client_print_version_ex(argc, argv);
1807 freerdp_client_print_buildconfig_ex(argc, argv);
1810 else if (status == COMMAND_LINE_STATUS_PRINT)
1812 (void)CommandLineParseArgumentsA(argc, argv, largs, 0x112, NULL, NULL, NULL);
1814 arg = CommandLineFindArgumentA(largs,
"list");
1817 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1819 if (option_equals(
"timezones", arg->Value))
1820 freerdp_client_print_timezone_list();
1821 else if (option_equals(
"tune", arg->Value))
1822 freerdp_client_print_tune_list(settings);
1823 else if (option_equals(
"kbd", arg->Value))
1824 freerdp_client_print_keyboard_list();
1825 else if (option_starts_with(
"kbd-lang", arg->Value))
1827 const char* val = NULL;
1828 if (option_starts_with(
"kbd-lang:", arg->Value))
1829 val = &arg->Value[9];
1830 else if (!option_equals(
"kbd-lang", arg->Value))
1831 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1833 if (val && strchr(val,
','))
1834 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1835 freerdp_client_print_codepages(val);
1837 else if (option_equals(
"kbd-scancode", arg->Value))
1838 freerdp_client_print_scancodes();
1839 else if (option_equals(
"monitor", arg->Value))
1842 return COMMAND_LINE_ERROR;
1844 else if (option_starts_with(
"smartcard", arg->Value))
1847 if (option_starts_with(
"smartcard:", arg->Value))
1849 else if (!option_equals(
"smartcard", arg->Value))
1850 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1854 const char* sub = strchr(arg->Value,
':') + 1;
1855 const CmdLineSubOptions options[] = {
1856 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
1858 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING, NULL }
1863 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1865 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1868 CommandLineParserFree(ptr);
1869 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1872 for (
size_t x = 1; x < count; x++)
1874 const char* cur = ptr[x];
1875 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1877 CommandLineParserFree(ptr);
1878 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1882 CommandLineParserFree(ptr);
1885 freerdp_smartcard_list(settings);
1889 freerdp_client_print_command_line_help_ex(argc, argv, custom);
1890 return COMMAND_LINE_ERROR;
1893#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1894 arg = CommandLineFindArgumentA(largs,
"tune-list");
1897 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1899 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
1900 freerdp_client_print_tune_list(settings);
1903 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
1906 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1908 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
1909 freerdp_client_print_codepages(arg->Value);
1912 arg = CommandLineFindArgumentA(largs,
"kbd-list");
1915 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1917 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
1918 freerdp_client_print_keyboard_list();
1921 arg = CommandLineFindArgumentA(largs,
"monitor-list");
1924 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1926 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
1928 return COMMAND_LINE_ERROR;
1931 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
1934 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1936 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
1937 freerdp_smartcard_list(settings);
1940 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
1943 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1946 "Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
1947 freerdp_client_print_scancodes();
1953 else if (status < 0)
1955 freerdp_client_print_command_line_help_ex(argc, argv, custom);
1960 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
1973static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
1975 const char* xcharpos = NULL;
1976 char* endPtr = NULL;
1977 unsigned long v = 0;
1979 v = strtoul(input, &endPtr, 10);
1981 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
1987 xcharpos = strchr(input,
'x');
1989 if (!xcharpos || xcharpos != endPtr)
1993 v = strtoul(xcharpos + 1, &endPtr, 10);
1995 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
1998 if (*endPtr !=
'\0')
2010 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2011 WINPR_ASSERT(settings);
2017 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2019 const char* arg = arguments[x];
2021 if (p && (p->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
2025 return freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT);
2028static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2033const char* option_starts_with(
const char* what,
const char* val)
2037 const size_t wlen = strlen(what);
2039 if (_strnicmp(what, val, wlen) != 0)
2044BOOL option_ends_with(
const char* str,
const char* ext)
2048 const size_t strLen = strlen(str);
2049 const size_t extLen = strlen(ext);
2051 if (strLen < extLen)
2054 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2057BOOL option_equals(
const char* what,
const char* val)
2061 return _stricmp(what, val) == 0;
2070} PARSE_ON_OFF_RESULT;
2072static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2074 WINPR_ASSERT(value);
2075 const char* sep = strchr(value,
':');
2078 if (option_equals(
"on", &sep[1]))
2080 if (option_equals(
"off", &sep[1]))
2089 CLIP_DIR_PARSE_LOCAL,
2090 CLIP_DIR_PARSE_REMOTE,
2092} PARSE_CLIP_DIR_RESULT;
2094static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2096 WINPR_ASSERT(value);
2097 const char* sep = strchr(value,
':');
2099 return CLIP_DIR_PARSE_FAIL;
2100 if (option_equals(
"all", &sep[1]))
2101 return CLIP_DIR_PARSE_ALL;
2102 if (option_equals(
"off", &sep[1]))
2103 return CLIP_DIR_PARSE_OFF;
2104 if (option_equals(
"local", &sep[1]))
2105 return CLIP_DIR_PARSE_LOCAL;
2106 if (option_equals(
"remote", &sep[1]))
2107 return CLIP_DIR_PARSE_REMOTE;
2108 return CLIP_DIR_PARSE_FAIL;
2111static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2113 const char* ciphers = NULL;
2115 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2117 if (option_equals(Value,
"netmon"))
2119 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2121 else if (option_equals(Value,
"ma"))
2123 ciphers =
"AES128-SHA";
2131 return COMMAND_LINE_ERROR_MEMORY;
2135static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2139 if (!value_to_int(Value, &val, 0, 5))
2140 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2143 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2147static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2150 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2153 return COMMAND_LINE_ERROR_MEMORY;
2157static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2159 UINT16 version = TLS1_2_VERSION;
2168 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2169 {
"1.1", TLS1_1_VERSION },
2170 {
"1.2", TLS1_2_VERSION }
2171#if defined(TLS1_3_VERSION)
2173 {
"1.3", TLS1_3_VERSION }
2177 const struct map_t* found = NULL;
2178 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2180 const struct map_t* cur = &map[x];
2181 if (option_equals(cur->name, Value))
2189 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2190 version = found->version;
2195 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2201 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2202 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2204 if (option_starts_with(
"ciphers:", arg->Value))
2205 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2206 else if (option_starts_with(
"seclevel:", arg->Value))
2207 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2208 else if (option_starts_with(
"secrets-file:", arg->Value))
2209 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2210 else if (option_starts_with(
"enforce:", arg->Value))
2211 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2214#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2215 CommandLineSwitchCase(arg,
"tls-ciphers")
2217 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2218 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2220 CommandLineSwitchCase(arg,
"tls-seclevel")
2222 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2223 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2225 CommandLineSwitchCase(arg,
"tls-secrets-file")
2227 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2228 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2230 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2232 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2233 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2236 CommandLineSwitchDefault(arg)
2239 CommandLineSwitchEnd(arg)
2246 WINPR_ASSERT(settings);
2250 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2251 for (
size_t x = 0; x < count; x++)
2254 larg.Value = ptr[x];
2256 int rc = parse_tls_cipher_options(settings, &larg);
2259 CommandLineParserFree(ptr);
2263 CommandLineParserFree(ptr);
2269 WINPR_ASSERT(settings);
2273 return COMMAND_LINE_ERROR;
2277 int rc = CHANNEL_RC_OK;
2279 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2280 if (!ptr || (count == 0))
2281 rc = COMMAND_LINE_ERROR;
2284 BOOL GfxH264 = FALSE;
2285 BOOL GfxAVC444 = FALSE;
2286 BOOL RemoteFxCodec = FALSE;
2287 BOOL GfxProgressive = FALSE;
2288 BOOL codecSelected = FALSE;
2290 for (
size_t x = 0; x < count; x++)
2292 const char* val = ptr[x];
2294 if (option_starts_with(
"AVC444", val))
2296 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2297 if (bval == PARSE_FAIL)
2298 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2300 GfxAVC444 = bval != PARSE_OFF;
2301 codecSelected = TRUE;
2303 else if (option_starts_with(
"AVC420", val))
2305 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2306 if (bval == PARSE_FAIL)
2307 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2309 GfxH264 = bval != PARSE_OFF;
2310 codecSelected = TRUE;
2314 if (option_starts_with(
"RFX", val))
2316 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2317 if (bval == PARSE_FAIL)
2318 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2320 RemoteFxCodec = bval != PARSE_OFF;
2321 codecSelected = TRUE;
2323 else if (option_starts_with(
"progressive", val))
2325 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2326 if (bval == PARSE_FAIL)
2327 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2329 GfxProgressive = bval != PARSE_OFF;
2330 codecSelected = TRUE;
2332 else if (option_starts_with(
"mask:", val))
2335 const char* uv = &val[5];
2336 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2337 rc = COMMAND_LINE_ERROR;
2342 rc = COMMAND_LINE_ERROR;
2345 else if (option_starts_with(
"small-cache", val))
2347 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2348 if (bval == PARSE_FAIL)
2349 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2352 rc = COMMAND_LINE_ERROR;
2354 else if (option_starts_with(
"thin-client", val))
2356 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2357 if (bval == PARSE_FAIL)
2358 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2361 rc = COMMAND_LINE_ERROR;
2362 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2366 rc = COMMAND_LINE_ERROR;
2369 else if (option_starts_with(
"frame-ack", val))
2371 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2372 if (bval == PARSE_FAIL)
2373 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2376 rc = COMMAND_LINE_ERROR;
2379 rc = COMMAND_LINE_ERROR;
2382 if ((rc == CHANNEL_RC_OK) && codecSelected)
2385 rc = COMMAND_LINE_ERROR;
2387 rc = COMMAND_LINE_ERROR;
2389 rc = COMMAND_LINE_ERROR;
2391 rc = COMMAND_LINE_ERROR;
2393 rc = COMMAND_LINE_ERROR;
2396 CommandLineParserFree(ptr);
2397 if (rc != CHANNEL_RC_OK)
2400 return CHANNEL_RC_OK;
2403static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2405 WINPR_ASSERT(settings);
2406 WINPR_ASSERT(value);
2410 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2413 ival = freerdp_map_keyboard_layout_name_to_id(value);
2417 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2418 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2419 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2426 rc = COMMAND_LINE_ERROR;
2431#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2434 WINPR_ASSERT(settings);
2438 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2440 return COMMAND_LINE_ERROR;
2442 if (option_equals(arg->Value,
"rfx"))
2445 return COMMAND_LINE_ERROR;
2447 else if (option_equals(arg->Value,
"nsc"))
2450 return COMMAND_LINE_ERROR;
2453#if defined(WITH_JPEG)
2454 else if (option_equals(arg->Value,
"jpeg"))
2457 return COMMAND_LINE_ERROR;
2462 return COMMAND_LINE_ERROR;
2471static BOOL check_kbd_remap_valid(
const char* token)
2476 WINPR_ASSERT(token);
2478 if (strlen(token) > 10)
2481 if (!freerdp_extract_key_value(token, &key, &value))
2483 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2491 WINPR_ASSERT(settings);
2495 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2497 return COMMAND_LINE_ERROR_MEMORY;
2498 char* p = strchr(arg->Value,
'[');
2503 const char scheme[] =
"://";
2504 const char* val = strstr(arg->Value, scheme);
2506 val += strnlen(scheme,
sizeof(scheme));
2509 p = strchr(val,
':');
2516 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2517 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2519 length = (size_t)(p - arg->Value);
2521 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2524 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2529 return COMMAND_LINE_ERROR_MEMORY;
2535 char* p2 = strchr(arg->Value,
']');
2539 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2541 length = (size_t)(p2 - p);
2543 return COMMAND_LINE_ERROR_MEMORY;
2545 if (*(p2 + 1) ==
':')
2549 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2550 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2553 return COMMAND_LINE_ERROR;
2556 printf(
"hostname %s port %" PRIu32
"\n",
2565 WINPR_ASSERT(settings);
2569 char* cur = arg->Value;
2571 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2573 return COMMAND_LINE_ERROR;
2579 char* next = strchr(cur,
',');
2587 if (option_equals(
"fqdn", cur))
2589 else if (option_equals(
"ip", cur))
2591 else if (option_equals(
"netbios", cur))
2594 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2597 mask = (mask & 0x07);
2598 value |= mask << (count * 3);
2600 }
while (cur != NULL);
2603 return COMMAND_LINE_ERROR;
2606 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2610static int parse_prevent_session_lock_options(rdpSettings* settings,
2613 WINPR_ASSERT(settings);
2617 return COMMAND_LINE_ERROR_MEMORY;
2619 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2623 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2624 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2627 return COMMAND_LINE_ERROR_MEMORY;
2635 WINPR_ASSERT(settings);
2639 return COMMAND_LINE_ERROR;
2646 return COMMAND_LINE_ERROR;
2648 return COMMAND_LINE_ERROR;
2650 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2653 return COMMAND_LINE_ERROR;
2656 return COMMAND_LINE_ERROR_MEMORY;
2664 WINPR_ASSERT(settings);
2668 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2669 char* p = strchr(arg->Value,
'x');
2673 unsigned long w = 0;
2674 unsigned long h = 0;
2676 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2677 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2680 return COMMAND_LINE_ERROR;
2682 return COMMAND_LINE_ERROR;
2686 char* str = _strdup(arg->Value);
2688 return COMMAND_LINE_ERROR_MEMORY;
2690 p = strchr(str,
'%');
2694 BOOL partial = FALSE;
2696 status = COMMAND_LINE_ERROR;
2723 if (!value_to_int(str, &val, 0, 100))
2725 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2745 WINPR_ASSERT(settings);
2748 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2751 UINT32* MonitorIds = NULL;
2752 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2755 return COMMAND_LINE_ERROR_MEMORY;
2762 CommandLineParserFree(ptr);
2766 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
2767 for (UINT32 i = 0; i < count; i++)
2771 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
2772 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2774 MonitorIds[i] = (UINT32)val;
2777 CommandLineParserFree(ptr);
2783static int parse_dynamic_resolution_options(rdpSettings* settings,
2786 WINPR_ASSERT(settings);
2789 const BOOL val = arg->Value != 0;
2793 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2794 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2798 return COMMAND_LINE_ERROR;
2800 return COMMAND_LINE_ERROR;
2807 WINPR_ASSERT(settings);
2812 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2813 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2817 return COMMAND_LINE_ERROR;
2821 unsigned long w = 0;
2822 unsigned long h = 0;
2824 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2825 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2828 return COMMAND_LINE_ERROR;
2830 return COMMAND_LINE_ERROR;
2837 WINPR_ASSERT(settings);
2842 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
2843 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2853 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2857 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2864 WINPR_ASSERT(settings);
2867 int rc = CHANNEL_RC_OK;
2869 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2870 if (!ptr || (count == 0))
2871 rc = COMMAND_LINE_ERROR;
2874 for (
size_t x = 0; x < count; x++)
2876 const char* val = ptr[x];
2878 if (option_starts_with(
"remap:", val))
2881 char* now = _strdup(&val[6]);
2886 if (!check_kbd_remap_valid(now))
2887 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2890 const size_t olen = strlen(old);
2891 const size_t alen = strlen(now);
2892 const size_t tlen = olen + alen + 2;
2893 char* tmp = calloc(tlen,
sizeof(
char));
2895 rc = COMMAND_LINE_ERROR_MEMORY;
2897 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
2905 rc = COMMAND_LINE_ERROR;
2909 else if (option_starts_with(
"layout:", val))
2911 rc = parse_kbd_layout(settings, &val[7]);
2913 else if (option_starts_with(
"lang:", val))
2916 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
2918 ival = freerdp_get_locale_id_from_string(&val[5]);
2921 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2924 rc = COMMAND_LINE_ERROR;
2926 else if (option_starts_with(
"type:", val))
2929 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
2931 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2933 rc = COMMAND_LINE_ERROR;
2935 else if (option_starts_with(
"subtype:", val))
2938 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
2940 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2943 rc = COMMAND_LINE_ERROR;
2945 else if (option_starts_with(
"fn-key:", val))
2948 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
2950 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2953 rc = COMMAND_LINE_ERROR;
2955 else if (option_starts_with(
"unicode", val))
2957 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2958 if (bval == PARSE_FAIL)
2959 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2962 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2964 else if (option_starts_with(
"pipe:", val))
2967 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2969 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2971#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2972 else if (count == 1)
2975 rc = parse_kbd_layout(settings, val);
2979 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2985 CommandLineParserFree(ptr);
2991 WINPR_ASSERT(settings);
2996 return COMMAND_LINE_ERROR_MEMORY;
2998 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3000 const char* cur = arg->Value;
3003 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3005 if (!proxy_parse_uri(settings, cur))
3006 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3010 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3011 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3018 WINPR_ASSERT(settings);
3021 BOOL failed = FALSE;
3023 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3028 BOOL modernsyntax = FALSE;
3029 BOOL oldsyntax = FALSE;
3030 for (
size_t x = 0; (x < count) && !failed; x++)
3032 const char* carg = ptr[x];
3033 if (option_starts_with(
"file:", carg))
3035 const char* val = &carg[5];
3040 modernsyntax = TRUE;
3042 else if (option_equals(
"replay", carg))
3049 else if (option_equals(
"record", carg))
3056 else if (option_equals(
"nodelay", carg))
3063 modernsyntax = TRUE;
3078 if (oldsyntax && (count != 2))
3081 CommandLineParserFree(ptr);
3083 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3089 WINPR_ASSERT(settings);
3092 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3095 (arg->Value == BoolValueTrue)))
3096 return COMMAND_LINE_ERROR;
3102 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3103 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3105 const char* usesel =
"use-selection:";
3107 const char* cur = ptr[x];
3108 if (option_starts_with(usesel, cur))
3110 const char* val = &cur[strlen(usesel)];
3112 rc = COMMAND_LINE_ERROR_MEMORY;
3114 return COMMAND_LINE_ERROR;
3116 else if (option_starts_with(
"direction-to", cur))
3120 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3121 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3125 case CLIP_DIR_PARSE_ALL:
3126 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3128 case CLIP_DIR_PARSE_LOCAL:
3129 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3131 case CLIP_DIR_PARSE_REMOTE:
3132 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3134 case CLIP_DIR_PARSE_OFF:
3136 case CLIP_DIR_PARSE_FAIL:
3138 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3144 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3146 else if (option_starts_with(
"files-to", cur))
3150 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3151 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3152 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3156 case CLIP_DIR_PARSE_ALL:
3158 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3160 case CLIP_DIR_PARSE_LOCAL:
3161 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3163 case CLIP_DIR_PARSE_REMOTE:
3164 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3166 case CLIP_DIR_PARSE_OFF:
3168 case CLIP_DIR_PARSE_FAIL:
3170 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3176 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3179 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3181 CommandLineParserFree(ptr);
3191 WINPR_ASSERT(settings);
3196 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3197 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3201 case AUDIO_MODE_REDIRECT:
3203 return COMMAND_LINE_ERROR;
3206 case AUDIO_MODE_PLAY_ON_SERVER:
3208 return COMMAND_LINE_ERROR;
3211 case AUDIO_MODE_NONE:
3213 return COMMAND_LINE_ERROR;
3215 return COMMAND_LINE_ERROR;
3219 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3226 WINPR_ASSERT(settings);
3229 UINT32 type = CONNECTION_TYPE_INVALID;
3231 if (option_equals(arg->Value,
"invalid"))
3232 type = CONNECTION_TYPE_INVALID;
3233 else if (option_equals(arg->Value,
"modem"))
3234 type = CONNECTION_TYPE_MODEM;
3235 else if (option_equals(arg->Value,
"broadband"))
3236 type = CONNECTION_TYPE_BROADBAND_HIGH;
3237 else if (option_equals(arg->Value,
"broadband-low"))
3238 type = CONNECTION_TYPE_BROADBAND_LOW;
3239 else if (option_equals(arg->Value,
"broadband-high"))
3240 type = CONNECTION_TYPE_BROADBAND_HIGH;
3241 else if (option_equals(arg->Value,
"wan"))
3242 type = CONNECTION_TYPE_WAN;
3243 else if (option_equals(arg->Value,
"lan"))
3244 type = CONNECTION_TYPE_LAN;
3245 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3246 (option_equals(arg->Value,
"detect")))
3248 type = CONNECTION_TYPE_AUTODETECT;
3254 if (!value_to_int(arg->Value, &val, 0, 7))
3255 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3260 if (!freerdp_set_connection_type(settings, type))
3261 return COMMAND_LINE_ERROR;
3267 WINPR_ASSERT(settings);
3271 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3273 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3275 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3276 for (
size_t x = 0; x < count; x++)
3278 const char* cur = ptr[x];
3279 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3280 if (bval == PARSE_FAIL)
3282 CommandLineParserFree(ptr);
3283 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3286 const BOOL val = bval != PARSE_OFF;
3287 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3288 if (option_starts_with(
"rdp", cur))
3290 id = FreeRDP_RdpSecurity;
3292 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3294 else if (option_starts_with(
"tls", cur))
3295 id = FreeRDP_TlsSecurity;
3296 else if (option_starts_with(
"nla", cur))
3297 id = FreeRDP_NlaSecurity;
3298 else if (option_starts_with(
"ext", cur))
3299 id = FreeRDP_ExtSecurity;
3300 else if (option_equals(
"aad", cur))
3301 id = FreeRDP_AadSecurity;
3304 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3305 CommandLineParserFree(ptr);
3306 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3309 if ((bval == PARSE_NONE) && (count == 1))
3310 singleOptionWithoutOnOff = id;
3312 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3315 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3317 const FreeRDP_Settings_Keys_Bool options[] = { FreeRDP_AadSecurity,
3318 FreeRDP_UseRdpSecurityLayer,
3319 FreeRDP_RdpSecurity, FreeRDP_NlaSecurity,
3320 FreeRDP_TlsSecurity };
3322 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3325 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3329 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3330 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3333 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3336 CommandLineParserFree(ptr);
3340static int parse_encryption_methods_options(rdpSettings* settings,
3343 WINPR_ASSERT(settings);
3346 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3349 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3351 UINT32 EncryptionMethods = 0;
3352 for (UINT32 i = 0; i < count; i++)
3354 if (option_equals(ptr[i],
"40"))
3355 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3356 else if (option_equals(ptr[i],
"56"))
3357 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3358 else if (option_equals(ptr[i],
"128"))
3359 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3360 else if (option_equals(ptr[i],
"FIPS"))
3361 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3363 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3367 return COMMAND_LINE_ERROR;
3368 CommandLineParserFree(ptr);
3375 WINPR_ASSERT(settings);
3380 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3381 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3383 const char deny[] =
"deny";
3384 const char ignore[] =
"ignore";
3385 const char tofu[] =
"tofu";
3386 const char name[] =
"name:";
3387 const char fingerprints[] =
"fingerprint:";
3389 const char* cur = ptr[x];
3390 if (option_equals(deny, cur))
3393 return COMMAND_LINE_ERROR;
3395 else if (option_equals(ignore, cur))
3398 return COMMAND_LINE_ERROR;
3400 else if (option_equals(tofu, cur))
3403 return COMMAND_LINE_ERROR;
3405 else if (option_starts_with(name, cur))
3407 const char* val = &cur[strnlen(name,
sizeof(name))];
3409 rc = COMMAND_LINE_ERROR_MEMORY;
3411 else if (option_starts_with(fingerprints, cur))
3413 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3416 rc = COMMAND_LINE_ERROR_MEMORY;
3419 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3421 CommandLineParserFree(ptr);
3428 WINPR_ASSERT(settings);
3432 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3436 for (
size_t x = 1; x < count; x++)
3438 const char* cur = ptr[x];
3440 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3441 if (bval == PARSE_FAIL)
3442 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3445 const BOOL val = bval != PARSE_OFF;
3447 if (option_starts_with(
"relative", cur))
3450 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3452 else if (option_starts_with(
"grab", cur))
3455 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3463 CommandLineParserFree(ptr);
3470 WINPR_ASSERT(settings);
3474 UINT32 Floatbar = 0x0017;
3478 char* start = arg->Value;
3483 start = strchr(start,
',');
3492 if (option_starts_with(
"sticky:", cur))
3496 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3508 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3512 else if (option_starts_with(
"default:", cur))
3514 const char* val = cur + 8;
3517 if (option_equals(
"visible", val))
3519 else if (option_equals(
"hidden", val))
3522 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3525 else if (option_starts_with(
"show:", cur))
3527 const char* val = cur + 5;
3530 if (option_equals(
"always", val))
3532 else if (option_equals(
"fullscreen", val))
3534 else if (option_equals(
"window", val))
3537 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3540 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3544 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3550 WINPR_ASSERT(settings);
3553 BYTE* base64 = NULL;
3556 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3558 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3564 return COMMAND_LINE_ERROR;
3568 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3575static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3577 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3585 WINPR_ASSERT(settings);
3590 if (!value_to_int(arg->Value, &val, 100, 180))
3591 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3599 return COMMAND_LINE_ERROR;
3601 return COMMAND_LINE_ERROR;
3602 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3603 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3604 return fail_at(arg, COMMAND_LINE_ERROR);
3608 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3615 WINPR_ASSERT(settings);
3620 if (!value_to_int(arg->Value, &val, 100, 180))
3621 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3629 return COMMAND_LINE_ERROR;
3630 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3631 return fail_at(arg, COMMAND_LINE_ERROR);
3635 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3642 WINPR_ASSERT(settings);
3648 return COMMAND_LINE_ERROR;
3650 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3653 const CmdLineSubOptions opts[] = {
3654 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3655 setSmartcardEmulation },
3656 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3657 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING, NULL },
3658 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING, NULL },
3659 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING, NULL },
3660 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING, NULL },
3661 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING, NULL }
3664 for (
size_t x = 1; x < count; x++)
3666 const char* cur = ptr[x];
3667 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
3669 CommandLineParserFree(ptr);
3670 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3674 CommandLineParserFree(ptr);
3680 WINPR_ASSERT(settings);
3684 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
3686 return COMMAND_LINE_ERROR;
3687 for (
size_t x = 1; x < count; x++)
3689 const char* cur = ptr[x];
3690 char* sep = strchr(cur,
':');
3693 CommandLineParserFree(ptr);
3694 return COMMAND_LINE_ERROR;
3697 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
3699 CommandLineParserFree(ptr);
3700 return COMMAND_LINE_ERROR;
3704 CommandLineParserFree(ptr);
3708static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
3710 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
3711 FreeRDP_RemoteAppLanguageBarSupported,
3712 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
3713 FreeRDP_DisableFullWindowDrag };
3716 return COMMAND_LINE_ERROR_MEMORY;
3718 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
3721 return COMMAND_LINE_ERROR;
3723 return CHANNEL_RC_OK;
3728 WINPR_ASSERT(settings);
3731 int rc = CHANNEL_RC_OK;
3733 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3734 if (!ptr || (count == 0))
3735 rc = COMMAND_LINE_ERROR;
3742 int (*fkt)(rdpSettings* settings,
const char* value);
3744 const struct app_map amap[] = { {
"tenantid:", FreeRDP_GatewayAvdAadtenantid, NULL },
3745 {
"ad:", FreeRDP_GatewayAzureActiveDirectory, NULL },
3746 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat, NULL },
3747 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat, NULL },
3748 {
"avd-scope:", FreeRDP_GatewayAvdScope, NULL }
3751 for (
size_t x = 0; x < count; x++)
3753 BOOL handled = FALSE;
3754 const char* val = ptr[x];
3756 if (option_starts_with(
"use-tenantid", val))
3758 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3759 if (bval == PARSE_FAIL)
3761 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3769 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3775 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3777 const struct app_map* cur = &amap[y];
3778 if (option_starts_with(cur->name, val))
3780 const char* xval = &val[strlen(cur->name)];
3782 rc = cur->fkt(settings, xval);
3786 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3787 rc = COMMAND_LINE_ERROR_MEMORY;
3796 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3803 CommandLineParserFree(ptr);
3809 WINPR_ASSERT(settings);
3812 int rc = CHANNEL_RC_OK;
3814 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3815 if (!ptr || (count == 0))
3816 rc = COMMAND_LINE_ERROR;
3823 int (*fkt)(rdpSettings* settings,
const char* value);
3825 const struct app_map amap[] = { {
"program:", FreeRDP_RemoteApplicationProgram,
3826 parse_app_option_program },
3827 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir, NULL },
3828 {
"name:", FreeRDP_RemoteApplicationName, NULL },
3829 {
"icon:", FreeRDP_RemoteApplicationIcon, NULL },
3830 {
"cmd:", FreeRDP_RemoteApplicationCmdLine, NULL },
3831 {
"file:", FreeRDP_RemoteApplicationFile, NULL },
3832 {
"guid:", FreeRDP_RemoteApplicationGuid, NULL },
3833 {
"hidef:", FreeRDP_HiDefRemoteApp, NULL } };
3834 for (
size_t x = 0; x < count; x++)
3836 BOOL handled = FALSE;
3837 const char* val = ptr[x];
3839 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3841 const struct app_map* cur = &amap[y];
3842 if (option_starts_with(cur->name, val))
3844 const char* xval = &val[strlen(cur->name)];
3846 rc = cur->fkt(settings, xval);
3850 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3851 rc = COMMAND_LINE_ERROR_MEMORY;
3859#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3860 if (!handled && (count == 1))
3863 rc = parse_app_option_program(settings, val);
3868 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3875 CommandLineParserFree(ptr);
3881 WINPR_ASSERT(settings);
3884 int rc = CHANNEL_RC_OK;
3886 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3887 if (!ptr || (count == 0))
3888 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3890 for (
size_t x = 0; x < count; x++)
3892 const char* val = ptr[x];
3894 if (option_starts_with(
"codec:", val))
3897 rc = COMMAND_LINE_ERROR;
3898 else if (option_equals(arg->Value,
"rfx"))
3901 rc = COMMAND_LINE_ERROR;
3903 else if (option_equals(arg->Value,
"nsc"))
3906 rc = COMMAND_LINE_ERROR;
3909#if defined(WITH_JPEG)
3910 else if (option_equals(arg->Value,
"jpeg"))
3913 rc = COMMAND_LINE_ERROR;
3918 return COMMAND_LINE_ERROR;
3924 else if (option_starts_with(
"persist-file:", val))
3928 rc = COMMAND_LINE_ERROR_MEMORY;
3930 rc = COMMAND_LINE_ERROR;
3934 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3935 if (bval == PARSE_FAIL)
3936 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3939 if (option_starts_with(
"bitmap", val))
3943 rc = COMMAND_LINE_ERROR;
3945 else if (option_starts_with(
"glyph", val))
3948 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
3949 : GLYPH_SUPPORT_NONE))
3950 rc = COMMAND_LINE_ERROR;
3952 else if (option_starts_with(
"persist", val))
3956 rc = COMMAND_LINE_ERROR;
3958 else if (option_starts_with(
"offscreen", val))
3962 rc = COMMAND_LINE_ERROR;
3968 CommandLineParserFree(ptr);
3972static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
3974 WINPR_ASSERT(settings);
3979 if (!freerdp_parse_hostname(host, &name, &port))
3998static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
3999 FreeRDP_Settings_Keys_String what)
4001 WINPR_ASSERT(settings);
4002 WINPR_ASSERT(value);
4006 case FreeRDP_GatewayUsername:
4007 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4008 FreeRDP_GatewayDomain))
4020static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4024 WINPR_ASSERT(settings);
4025 WINPR_ASSERT(value);
4027 if (option_equals(value,
"rpc"))
4038 if (option_equals(value,
"http"))
4046 else if (option_equals(value,
"auto"))
4054 else if (option_equals(value,
"arm"))
4067static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4071 WINPR_ASSERT(settings);
4072 WINPR_ASSERT(value);
4074 if (option_equals(value,
"none"))
4075 type = TSC_PROXY_MODE_NONE_DIRECT;
4076 else if (option_equals(value,
"direct"))
4077 type = TSC_PROXY_MODE_DIRECT;
4078 else if (option_equals(value,
"detect"))
4079 type = TSC_PROXY_MODE_DETECT;
4080 else if (option_equals(value,
"default"))
4081 type = TSC_PROXY_MODE_DEFAULT;
4086 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4093static char* unescape(
const char* str)
4095 char* copy = _strdup(str);
4099 bool escaped =
false;
4101 while (*str !=
'\0')
4129 char* argval = NULL;
4132 WINPR_ASSERT(settings);
4136 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4145 BOOL allowHttpOpts = FALSE;
4146 for (
size_t x = 0; x < count; x++)
4148 BOOL validOption = FALSE;
4150 argval = unescape(ptr[x]);
4154 const char* gw = option_starts_with(
"g:", argval);
4157 if (!parse_gateway_host_option(settings, gw))
4160 allowHttpOpts = FALSE;
4163 const char* gu = option_starts_with(
"u:", argval);
4166 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4169 allowHttpOpts = FALSE;
4172 const char* gd = option_starts_with(
"d:", argval);
4175 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4178 allowHttpOpts = FALSE;
4181 const char* gp = option_starts_with(
"p:", argval);
4184 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4187 allowHttpOpts = FALSE;
4190 const char* gt = option_starts_with(
"type:", argval);
4193 if (!parse_gateway_type_option(settings, gt))
4199 const char* gat = option_starts_with(
"access-token:", argval);
4205 allowHttpOpts = FALSE;
4208 const char* bearer = option_starts_with(
"bearer:", argval);
4215 allowHttpOpts = FALSE;
4218 const char* gwurl = option_starts_with(
"url:", argval);
4226 allowHttpOpts = FALSE;
4229 const char* um = option_starts_with(
"usage-method:", argval);
4232 if (!parse_gateway_usage_option(settings, um))
4235 allowHttpOpts = FALSE;
4240 if (option_equals(argval,
"no-websockets"))
4247 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4264 CommandLineParserFree(ptr);
4271 WINPR_ASSERT(value);
4277 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4278 FillMemory(arg->Value, strlen(arg->Value),
'*');
4283 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4285 const char* cred = credential_args[x];
4286 fill_credential_string(args, cred);
4290 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4292 const char* gwcreds[] = {
"p:",
"access-token:" };
4293 char* saveptr = NULL;
4294 char* tok = strtok_s(arg->Value,
",", &saveptr);
4297 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4299 const char* opt = gwcreds[x];
4300 if (option_starts_with(opt, tok))
4302 char* val = &tok[strlen(opt)];
4303 FillMemory(val, strlen(val),
'*');
4306 tok = strtok_s(NULL,
",", &saveptr);
4311static int parse_command_line_option_uint32(rdpSettings* settings,
4313 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4318 if (!value_to_int(arg->Value, &val, min, max))
4319 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4322 return fail_at(arg, COMMAND_LINE_ERROR);
4326#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4331 WINPR_ASSERT(settings);
4334 BOOL enable = arg->Value ? TRUE : FALSE;
4335 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4337 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4339 return fail_at(arg, COMMAND_LINE_ERROR);
4344 return fail_at(arg, COMMAND_LINE_ERROR);
4348 return fail_at(arg, COMMAND_LINE_ERROR);
4350 CommandLineSwitchCase(arg,
"gfx-small-cache")
4352 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4354 return fail_at(arg, COMMAND_LINE_ERROR);
4358 return fail_at(arg, COMMAND_LINE_ERROR);
4360 CommandLineSwitchCase(arg,
"gfx-progressive")
4362 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4364 return fail_at(arg, COMMAND_LINE_ERROR);
4366 return fail_at(arg, COMMAND_LINE_ERROR);
4371 return fail_at(arg, COMMAND_LINE_ERROR);
4375 CommandLineSwitchCase(arg,
"gfx-h264")
4377 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4378 int rc = parse_gfx_options(settings, arg);
4380 return fail_at(arg, rc);
4383 CommandLineSwitchCase(arg,
"app-workdir")
4386 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4388 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4390 CommandLineSwitchCase(arg,
"app-name")
4392 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4394 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4396 CommandLineSwitchCase(arg,
"app-icon")
4398 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4400 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4402 CommandLineSwitchCase(arg,
"app-cmd")
4404 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4406 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4408 CommandLineSwitchCase(arg,
"app-file")
4410 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4412 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4414 CommandLineSwitchCase(arg,
"app-guid")
4416 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4418 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4420 CommandLineSwitchCase(arg,
"g")
4422 if (!parse_gateway_host_option(settings, arg->Value))
4423 return fail_at(arg, COMMAND_LINE_ERROR);
4425 CommandLineSwitchCase(arg,
"gu")
4427 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4428 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4430 CommandLineSwitchCase(arg,
"gd")
4432 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4433 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4435 CommandLineSwitchCase(arg,
"gp")
4437 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4438 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4440 CommandLineSwitchCase(arg,
"gt")
4442 if (!parse_gateway_type_option(settings, arg->Value))
4443 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4445 CommandLineSwitchCase(arg,
"gat")
4448 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4450 CommandLineSwitchCase(arg,
"gateway-usage-method")
4452 if (!parse_gateway_usage_option(settings, arg->Value))
4453 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4455 CommandLineSwitchCase(arg,
"kbd-remap")
4457 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4458 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4460 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4462 CommandLineSwitchCase(arg,
"kbd-lang")
4466 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4467 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4469 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4470 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4471 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4475 return fail_at(arg, COMMAND_LINE_ERROR);
4477 CommandLineSwitchCase(arg,
"kbd-type")
4479 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4481 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4483 return fail_at(arg, rc);
4485 CommandLineSwitchCase(arg,
"kbd-unicode")
4487 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4489 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4491 CommandLineSwitchCase(arg,
"kbd-subtype")
4493 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4495 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4497 return fail_at(arg, rc);
4499 CommandLineSwitchCase(arg,
"kbd-fn-key")
4501 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4502 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4505 return fail_at(arg, rc);
4507 CommandLineSwitchCase(arg,
"bitmap-cache")
4509 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4511 return fail_at(arg, COMMAND_LINE_ERROR);
4513 CommandLineSwitchCase(arg,
"persist-cache")
4515 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4517 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4519 CommandLineSwitchCase(arg,
"persist-cache-file")
4521 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4522 "/cache:persist-file:<filename> instead");
4524 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4527 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4529 CommandLineSwitchCase(arg,
"offscreen-cache")
4531 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4533 return fail_at(arg, COMMAND_LINE_ERROR);
4535 CommandLineSwitchCase(arg,
"glyph-cache")
4537 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4539 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4540 return fail_at(arg, COMMAND_LINE_ERROR);
4542 CommandLineSwitchCase(arg,
"codec-cache")
4544 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4545 const int rc = parse_codec_cache_options(settings, arg);
4547 return fail_at(arg, rc);
4549 CommandLineSwitchCase(arg,
"sec-rdp")
4551 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4553 return fail_at(arg, COMMAND_LINE_ERROR);
4555 CommandLineSwitchCase(arg,
"sec-tls")
4557 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4559 return fail_at(arg, COMMAND_LINE_ERROR);
4561 CommandLineSwitchCase(arg,
"sec-nla")
4563 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4565 return fail_at(arg, COMMAND_LINE_ERROR);
4567 CommandLineSwitchCase(arg,
"sec-ext")
4569 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4571 return fail_at(arg, COMMAND_LINE_ERROR);
4573 CommandLineSwitchCase(arg,
"tls-ciphers")
4575 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4576 "/tls:ciphers:<cipher list> instead");
4577 int rc = parse_tls_cipher_options(settings, arg);
4579 return fail_at(arg, rc);
4581 CommandLineSwitchCase(arg,
"tls-seclevel")
4583 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4584 int rc = parse_tls_cipher_options(settings, arg);
4586 return fail_at(arg, rc);
4588 CommandLineSwitchCase(arg,
"tls-secrets-file")
4590 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4591 "/tls:secrets-file:<filename> instead");
4592 int rc = parse_tls_cipher_options(settings, arg);
4594 return fail_at(arg, rc);
4596 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4598 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4599 int rc = parse_tls_cipher_options(settings, arg);
4601 return fail_at(arg, rc);
4603 CommandLineSwitchCase(arg,
"cert-name")
4605 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4607 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4609 CommandLineSwitchCase(arg,
"cert-ignore")
4611 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4613 return fail_at(arg, COMMAND_LINE_ERROR);
4615 CommandLineSwitchCase(arg,
"cert-tofu")
4617 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4619 return fail_at(arg, COMMAND_LINE_ERROR);
4621 CommandLineSwitchCase(arg,
"cert-deny")
4623 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4625 return fail_at(arg, COMMAND_LINE_ERROR);
4627 CommandLineSwitchDefault(arg)
4631 CommandLineSwitchEnd(arg);
4636static int parse_command_line_option_timezone(rdpSettings* settings,
4642 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = { 0 };
4643 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
4645 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
4646 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
4648 WINPR_ASSERT(arg->Value);
4649 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
4656 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4659 return fail_at(arg, COMMAND_LINE_ERROR);
4664 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4666 tz->Bias = info.Bias;
4667 tz->DaylightBias = info.DaylightBias;
4668 tz->DaylightDate = info.DaylightDate;
4669 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
4670 tz->StandardBias = info.StandardBias;
4671 tz->StandardDate = info.StandardDate;
4672 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
4677static int parse_command_line_option_window_pos(rdpSettings* settings,
4680 WINPR_ASSERT(settings);
4683 unsigned long x = 0;
4684 unsigned long y = 0;
4687 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4689 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
4691 WLog_ERR(TAG,
"invalid window-position argument");
4692 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4696 return fail_at(arg, COMMAND_LINE_ERROR);
4698 return fail_at(arg, COMMAND_LINE_ERROR);
4703 freerdp_command_line_handle_option_t handle_option,
4704 void* handle_userdata, BOOL* promptForPassword,
char** user)
4706 WINPR_ASSERT(promptForPassword);
4711 BOOL enable = arg->Value ? TRUE : FALSE;
4713 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
4716 CommandLineSwitchStart(arg)
4718 CommandLineSwitchCase(arg,
"v")
4720 const int rc = parse_host_options(settings, arg);
4722 return fail_at(arg, rc);
4724 CommandLineSwitchCase(arg,
"spn-class")
4728 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4730 CommandLineSwitchCase(arg,
"sspi-module")
4733 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4735 CommandLineSwitchCase(arg,
"winscard-module")
4738 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4740 CommandLineSwitchCase(arg,
"redirect-prefer")
4742 const int rc = parse_redirect_prefer_options(settings, arg);
4744 return fail_at(arg, rc);
4746 CommandLineSwitchCase(arg,
"credentials-delegation")
4749 return fail_at(arg, COMMAND_LINE_ERROR);
4751 CommandLineSwitchCase(arg,
"prevent-session-lock")
4753 const int rc = parse_prevent_session_lock_options(settings, arg);
4755 return fail_at(arg, rc);
4757 CommandLineSwitchCase(arg,
"vmconnect")
4759 const int rc = parse_vmconnect_options(settings, arg);
4761 return fail_at(arg, rc);
4763 CommandLineSwitchCase(arg,
"w")
4765 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
4768 return fail_at(arg, rc);
4770 CommandLineSwitchCase(arg,
"h")
4772 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
4775 return fail_at(arg, rc);
4777 CommandLineSwitchCase(arg,
"size")
4779 const int rc = parse_size_options(settings, arg);
4781 return fail_at(arg, rc);
4783 CommandLineSwitchCase(arg,
"f")
4786 return fail_at(arg, COMMAND_LINE_ERROR);
4788 CommandLineSwitchCase(arg,
"suppress-output")
4791 return fail_at(arg, COMMAND_LINE_ERROR);
4793 CommandLineSwitchCase(arg,
"multimon")
4796 return fail_at(arg, COMMAND_LINE_ERROR);
4798 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4800 if (option_equals(arg->Value, str_force))
4803 return fail_at(arg, COMMAND_LINE_ERROR);
4807 CommandLineSwitchCase(arg,
"span")
4810 return fail_at(arg, COMMAND_LINE_ERROR);
4812 CommandLineSwitchCase(arg,
"workarea")
4815 return fail_at(arg, COMMAND_LINE_ERROR);
4817 CommandLineSwitchCase(arg,
"monitors")
4819 const int rc = parse_monitors_options(settings, arg);
4821 return fail_at(arg, rc);
4823 CommandLineSwitchCase(arg,
"t")
4826 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4828 CommandLineSwitchCase(arg,
"decorations")
4831 return fail_at(arg, COMMAND_LINE_ERROR);
4833 CommandLineSwitchCase(arg,
"dynamic-resolution")
4835 const int rc = parse_dynamic_resolution_options(settings, arg);
4837 return fail_at(arg, rc);
4839 CommandLineSwitchCase(arg,
"smart-sizing")
4841 const int rc = parse_smart_sizing_options(settings, arg);
4843 return fail_at(arg, rc);
4845 CommandLineSwitchCase(arg,
"bpp")
4847 const int rc = parse_bpp_options(settings, arg);
4849 return fail_at(arg, rc);
4851 CommandLineSwitchCase(arg,
"admin")
4854 return fail_at(arg, COMMAND_LINE_ERROR);
4856 CommandLineSwitchCase(arg,
"relax-order-checks")
4860 return fail_at(arg, COMMAND_LINE_ERROR);
4862 CommandLineSwitchCase(arg,
"restricted-admin")
4865 return fail_at(arg, COMMAND_LINE_ERROR);
4867 return fail_at(arg, COMMAND_LINE_ERROR);
4869#ifdef CHANNEL_RDPEAR_CLIENT
4870 CommandLineSwitchCase(arg,
"remoteGuard")
4873 return fail_at(arg, COMMAND_LINE_ERROR);
4875 return fail_at(arg, COMMAND_LINE_ERROR);
4878 CommandLineSwitchCase(arg,
"pth")
4881 return fail_at(arg, COMMAND_LINE_ERROR);
4883 return fail_at(arg, COMMAND_LINE_ERROR);
4886 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4888 CommandLineSwitchCase(arg,
"client-hostname")
4891 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4893 CommandLineSwitchCase(arg,
"kbd")
4895 int rc = parse_kbd_options(settings, arg);
4897 return fail_at(arg, rc);
4900 CommandLineSwitchCase(arg,
"u")
4902 WINPR_ASSERT(arg->Value);
4905 CommandLineSwitchCase(arg,
"d")
4908 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4910 CommandLineSwitchCase(arg,
"p")
4913 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4915 CommandLineSwitchCase(arg,
"gateway")
4917 if (!parse_gateway_options(settings, arg))
4918 return fail_at(arg, COMMAND_LINE_ERROR);
4920 CommandLineSwitchCase(arg,
"proxy")
4922 const int rc = parse_proxy_options(settings, arg);
4924 return fail_at(arg, rc);
4927 CommandLineSwitchCase(arg,
"azure")
4929 int rc = parse_aad_options(settings, arg);
4931 return fail_at(arg, rc);
4933 CommandLineSwitchCase(arg,
"app")
4935 int rc = parse_app_options(settings, arg);
4937 return fail_at(arg, rc);
4939 CommandLineSwitchCase(arg,
"load-balance-info")
4941 WINPR_ASSERT(arg->Value);
4943 strlen(arg->Value)))
4944 return fail_at(arg, COMMAND_LINE_ERROR);
4947 CommandLineSwitchCase(arg,
"compression")
4950 return fail_at(arg, COMMAND_LINE_ERROR);
4952 CommandLineSwitchCase(arg,
"compression-level")
4954 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
4957 return fail_at(arg, rc);
4959 CommandLineSwitchCase(arg,
"drives")
4962 return fail_at(arg, COMMAND_LINE_ERROR);
4964 CommandLineSwitchCase(arg,
"dump")
4966 const int rc = parse_dump_options(settings, arg);
4968 return fail_at(arg, rc);
4970 CommandLineSwitchCase(arg,
"disable-output")
4973 return fail_at(arg, COMMAND_LINE_ERROR);
4975 CommandLineSwitchCase(arg,
"home-drive")
4978 return fail_at(arg, COMMAND_LINE_ERROR);
4980 CommandLineSwitchCase(arg,
"ipv4")
4982 if (arg->Value != NULL && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
4985 return fail_at(arg, COMMAND_LINE_ERROR);
4990 return fail_at(arg, COMMAND_LINE_ERROR);
4993 CommandLineSwitchCase(arg,
"ipv6")
4995 if (arg->Value != NULL && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
4998 return fail_at(arg, COMMAND_LINE_ERROR);
5003 return fail_at(arg, COMMAND_LINE_ERROR);
5006 CommandLineSwitchCase(arg,
"clipboard")
5008 const int rc = parse_clipboard_options(settings, arg);
5010 return fail_at(arg, rc);
5012 CommandLineSwitchCase(arg,
"server-name")
5015 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5017 CommandLineSwitchCase(arg,
"shell")
5020 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5022 CommandLineSwitchCase(arg,
"shell-dir")
5025 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5027 CommandLineSwitchCase(arg,
"audio-mode")
5029 const int rc = parse_audio_mode_options(settings, arg);
5031 return fail_at(arg, rc);
5033 CommandLineSwitchCase(arg,
"network")
5035 const int rc = parse_network_options(settings, arg);
5037 return fail_at(arg, rc);
5039 CommandLineSwitchCase(arg,
"fonts")
5042 return fail_at(arg, COMMAND_LINE_ERROR);
5044 CommandLineSwitchCase(arg,
"wallpaper")
5047 return fail_at(arg, COMMAND_LINE_ERROR);
5049 CommandLineSwitchCase(arg,
"window-drag")
5052 return fail_at(arg, COMMAND_LINE_ERROR);
5054 CommandLineSwitchCase(arg,
"window-position")
5056 const int rc = parse_command_line_option_window_pos(settings, arg);
5058 return fail_at(arg, rc);
5060 CommandLineSwitchCase(arg,
"menu-anims")
5063 return fail_at(arg, COMMAND_LINE_ERROR);
5065 CommandLineSwitchCase(arg,
"themes")
5068 return fail_at(arg, COMMAND_LINE_ERROR);
5070 CommandLineSwitchCase(arg,
"timeout")
5073 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5075 return fail_at(arg, rc);
5077 CommandLineSwitchCase(arg,
"timezone")
5079 const int rc = parse_command_line_option_timezone(settings, arg);
5081 return fail_at(arg, rc);
5083 CommandLineSwitchCase(arg,
"aero")
5086 return fail_at(arg, COMMAND_LINE_ERROR);
5088 CommandLineSwitchCase(arg,
"gdi")
5090 if (option_equals(arg->Value,
"sw"))
5093 return fail_at(arg, COMMAND_LINE_ERROR);
5095 else if (option_equals(arg->Value,
"hw"))
5098 return fail_at(arg, COMMAND_LINE_ERROR);
5101 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5103 CommandLineSwitchCase(arg,
"gfx")
5105 int rc = parse_gfx_options(settings, arg);
5107 return fail_at(arg, rc);
5110 CommandLineSwitchCase(arg,
"rfx")
5113 return fail_at(arg, COMMAND_LINE_ERROR);
5115 CommandLineSwitchCase(arg,
"rfx-mode")
5118 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5120 if (option_equals(arg->Value,
"video"))
5123 return fail_at(arg, COMMAND_LINE_ERROR);
5125 else if (option_equals(arg->Value,
"image"))
5128 return fail_at(arg, COMMAND_LINE_ERROR);
5130 return fail_at(arg, COMMAND_LINE_ERROR);
5133 CommandLineSwitchCase(arg,
"frame-ack")
5135 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5138 return fail_at(arg, rc);
5140 CommandLineSwitchCase(arg,
"nsc")
5143 return fail_at(arg, COMMAND_LINE_ERROR);
5145#if defined(WITH_JPEG)
5146 CommandLineSwitchCase(arg,
"jpeg")
5149 return fail_at(arg, COMMAND_LINE_ERROR);
5151 return fail_at(arg, COMMAND_LINE_ERROR);
5153 CommandLineSwitchCase(arg,
"jpeg-quality")
5157 if (!value_to_int(arg->Value, &val, 0, 100))
5158 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5161 return fail_at(arg, COMMAND_LINE_ERROR);
5164 CommandLineSwitchCase(arg,
"nego")
5167 return fail_at(arg, COMMAND_LINE_ERROR);
5169 CommandLineSwitchCase(arg,
"pcb")
5172 return fail_at(arg, COMMAND_LINE_ERROR);
5175 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5177 CommandLineSwitchCase(arg,
"pcid")
5179 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5182 return fail_at(arg, rc);
5184 return fail_at(arg, COMMAND_LINE_ERROR);
5187 CommandLineSwitchCase(arg,
"connect-child-session")
5201 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5204 CommandLineSwitchCase(arg,
"sec")
5206 const int rc = parse_sec_options(settings, arg);
5208 return fail_at(arg, rc);
5210 CommandLineSwitchCase(arg,
"encryption-methods")
5212 const int rc = parse_encryption_methods_options(settings, arg);
5214 return fail_at(arg, rc);
5216 CommandLineSwitchCase(arg,
"args-from")
5218 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5220 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5222 CommandLineSwitchCase(arg,
"from-stdin")
5225 return fail_at(arg, COMMAND_LINE_ERROR);
5227 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5230 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5231 *promptForPassword = (option_equals(arg->Value, str_force));
5233 if (!*promptForPassword)
5234 return fail_at(arg, COMMAND_LINE_ERROR);
5237 CommandLineSwitchCase(arg,
"log-level")
5239 wLog* root = WLog_GetRoot();
5241 if (!WLog_SetStringLogLevel(root, arg->Value))
5242 return fail_at(arg, COMMAND_LINE_ERROR);
5244 CommandLineSwitchCase(arg,
"log-filters")
5246 if (!WLog_AddStringLogFilters(arg->Value))
5247 return fail_at(arg, COMMAND_LINE_ERROR);
5249 CommandLineSwitchCase(arg,
"tls")
5251 int rc = parse_tls_options(settings, arg);
5253 return fail_at(arg, rc);
5255 CommandLineSwitchCase(arg,
"cert")
5257 const int rc = parse_cert_options(settings, arg);
5259 return fail_at(arg, rc);
5261 CommandLineSwitchCase(arg,
"authentication")
5264 return fail_at(arg, COMMAND_LINE_ERROR);
5266 CommandLineSwitchCase(arg,
"encryption")
5269 return fail_at(arg, COMMAND_LINE_ERROR);
5271 CommandLineSwitchCase(arg,
"grab-keyboard")
5274 return fail_at(arg, COMMAND_LINE_ERROR);
5276 CommandLineSwitchCase(arg,
"grab-mouse")
5279 return fail_at(arg, COMMAND_LINE_ERROR);
5281 CommandLineSwitchCase(arg,
"mouse-relative")
5284 return fail_at(arg, COMMAND_LINE_ERROR);
5286 CommandLineSwitchCase(arg,
"mouse")
5288 const int rc = parse_mouse_options(settings, arg);
5290 return fail_at(arg, rc);
5292 CommandLineSwitchCase(arg,
"unmap-buttons")
5295 return fail_at(arg, COMMAND_LINE_ERROR);
5297 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5300 return fail_at(arg, COMMAND_LINE_ERROR);
5302 CommandLineSwitchCase(arg,
"force-console-callbacks")
5305 return fail_at(arg, COMMAND_LINE_ERROR);
5307 CommandLineSwitchCase(arg,
"floatbar")
5309 const int rc = parse_floatbar_options(settings, arg);
5311 return fail_at(arg, rc);
5313 CommandLineSwitchCase(arg,
"mouse-motion")
5316 return fail_at(arg, COMMAND_LINE_ERROR);
5318 CommandLineSwitchCase(arg,
"parent-window")
5322 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5323 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5326 return fail_at(arg, COMMAND_LINE_ERROR);
5328 CommandLineSwitchCase(arg,
"client-build-number")
5331 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5333 return fail_at(arg, rc);
5335 CommandLineSwitchCase(arg,
"cache")
5337 int rc = parse_cache_options(settings, arg);
5339 return fail_at(arg, rc);
5342 CommandLineSwitchCase(arg,
"max-fast-path-size")
5344 const int rc = parse_command_line_option_uint32(
5345 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5347 return fail_at(arg, rc);
5349 CommandLineSwitchCase(arg,
"auto-request-control")
5353 return fail_at(arg, COMMAND_LINE_ERROR);
5355 CommandLineSwitchCase(arg,
"async-update")
5358 return fail_at(arg, COMMAND_LINE_ERROR);
5360 CommandLineSwitchCase(arg,
"async-channels")
5363 return fail_at(arg, COMMAND_LINE_ERROR);
5365 CommandLineSwitchCase(arg,
"wm-class")
5368 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5370 CommandLineSwitchCase(arg,
"play-rfx")
5373 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5376 return fail_at(arg, COMMAND_LINE_ERROR);
5378 CommandLineSwitchCase(arg,
"auth-only")
5381 return fail_at(arg, COMMAND_LINE_ERROR);
5383 CommandLineSwitchCase(arg,
"auth-pkg-list")
5387 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5389 CommandLineSwitchCase(arg,
"auto-reconnect")
5392 return fail_at(arg, COMMAND_LINE_ERROR);
5394 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5396 const int rc = parse_command_line_option_uint32(
5397 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5399 return fail_at(arg, rc);
5401 CommandLineSwitchCase(arg,
"reconnect-cookie")
5403 const int rc = parse_reconnect_cookie_options(settings, arg);
5405 return fail_at(arg, rc);
5407 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5410 return fail_at(arg, COMMAND_LINE_ERROR);
5412 CommandLineSwitchCase(arg,
"pwidth")
5414 const int rc = parse_command_line_option_uint32(
5415 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5417 return fail_at(arg, rc);
5419 CommandLineSwitchCase(arg,
"pheight")
5421 const int rc = parse_command_line_option_uint32(
5422 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5424 return fail_at(arg, rc);
5426 CommandLineSwitchCase(arg,
"orientation")
5430 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5431 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5434 return fail_at(arg, COMMAND_LINE_ERROR);
5435 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5436 return fail_at(arg, COMMAND_LINE_ERROR);
5438 CommandLineSwitchCase(arg,
"old-license")
5441 return fail_at(arg, COMMAND_LINE_ERROR);
5443 CommandLineSwitchCase(arg,
"scale")
5445 const int rc = parse_scale_options(settings, arg);
5447 return fail_at(arg, rc);
5449 CommandLineSwitchCase(arg,
"scale-desktop")
5451 const int rc = parse_command_line_option_uint32(settings, arg,
5452 FreeRDP_DesktopScaleFactor, 100, 500);
5454 return fail_at(arg, rc);
5455 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5456 return fail_at(arg, COMMAND_LINE_ERROR);
5458 CommandLineSwitchCase(arg,
"scale-device")
5460 const int rc = parse_scale_device_options(settings, arg);
5462 return fail_at(arg, rc);
5464 CommandLineSwitchCase(arg,
"action-script")
5467 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5469 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5472 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5474 CommandLineSwitchCase(arg,
"fipsmode")
5477 return fail_at(arg, COMMAND_LINE_ERROR);
5479 CommandLineSwitchCase(arg,
"smartcard-logon")
5481 const int rc = parse_smartcard_logon_options(settings, arg);
5483 return fail_at(arg, rc);
5485 CommandLineSwitchCase(arg,
"tune")
5487 const int rc = parse_tune_options(settings, arg);
5489 return fail_at(arg, rc);
5491 CommandLineSwitchDefault(arg)
5493#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5494 const int status = parse_deprecated_command_line(settings, arg);
5501 const int rc = handle_option(arg, handle_userdata);
5503 return fail_at(arg, rc);
5506 CommandLineSwitchEnd(arg)
5507 }
while ((arg = CommandLineFindNextArgumentA(arg)) != NULL);
5514 bool insecureArgFound =
false;
5515 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5517 const char* cred = credential_args[x];
5521 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5524 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5525 insecureArgFound =
true;
5528 if (insecureArgFound)
5530 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5532 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5533 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file or file descriptor");
5534 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5535 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5540static int freerdp_client_settings_parse_command_line_arguments_int(
5541 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5543 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata,
bool isArgsFrom)
5548 BOOL assist = FALSE;
5550 BOOL promptForPassword = FALSE;
5551 BOOL compatibility = FALSE;
5559 ext = option_is_rdp_file(argv[1]);
5560 assist = option_is_incident_file(argv[1]);
5563 if (!ext && !assist)
5564 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5566 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5577 WLog_WARN(TAG,
"Unsupported command line syntax!");
5578 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5579 freerdp_getApplicationDetailsString());
5584 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5588 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5589 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5594 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5595 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5598 CommandLineClearArgumentsA(largs);
5599 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5600 freerdp_client_command_line_pre_filter,
5601 freerdp_client_command_line_post_filter);
5606 prepare_default_settings(settings, largs, ext);
5608 warn_credential_args(largs);
5610 CommandLineFindArgumentA(largs,
"v");
5616 return COMMAND_LINE_ERROR_MEMORY;
5618 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
5626 return COMMAND_LINE_ERROR;
5629 return COMMAND_LINE_ERROR;
5631 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
5632 return COMMAND_LINE_ERROR;
5637 return COMMAND_LINE_ERROR;
5641 if (promptForPassword)
5646 char buffer[512 + 1] = { 0 };
5648 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
5649 ARRAYSIZE(buffer) - 1, 1))
5650 return COMMAND_LINE_ERROR;
5652 return COMMAND_LINE_ERROR;
5660 char buffer[512 + 1] = { 0 };
5662 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
5663 ARRAYSIZE(buffer) - 1, 1))
5664 return COMMAND_LINE_ERROR;
5666 return COMMAND_LINE_ERROR;
5671 freerdp_performance_flags_make(settings);
5678 return COMMAND_LINE_ERROR;
5680 return COMMAND_LINE_ERROR;
5683 arg = CommandLineFindArgumentA(largs,
"port");
5684 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
5687 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
5689 return fail_at(arg, rc);
5695 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5696 return fail_at(arg, COMMAND_LINE_ERROR);
5699 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
5702 fill_credential_strings(largs);
5707static void argv_free(
int* pargc,
char** pargv[])
5709 WINPR_ASSERT(pargc);
5710 WINPR_ASSERT(pargv);
5711 const int argc = *pargc;
5712 char** argv = *pargv;
5718 for (
int x = 0; x < argc; x++)
5723static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
5725 WINPR_ASSERT(pargc);
5726 WINPR_ASSERT(pargv);
5734 int nargc = *pargc + 1;
5735 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
5745static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
5749 copy = _strdup(what);
5751 const BOOL rc = argv_append(pargc, pargv, copy);
5757static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
5759 BOOL success = FALSE;
5761 WINPR_ASSERT(aargc);
5762 WINPR_ASSERT(aargv);
5767 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
5770 if (!argv_append_dup(aargc, aargv, cmd))
5776 INT64 rc = GetLine(&line, &size, fp);
5777 if ((rc < 0) || !line)
5787 const char cur = (line[rc - 1]);
5788 if ((cur ==
'\n') || (cur ==
'\r'))
5790 line[rc - 1] =
'\0';
5802 if (!argv_append(aargc, aargv, line))
5813 argv_free(aargc, aargv);
5817static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
5820 BOOL success = FALSE;
5823 WINPR_ASSERT(aargc);
5824 WINPR_ASSERT(aargv);
5829 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
5834 const DWORD size = GetEnvironmentVariableX(name, env, 0);
5837 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
5840 env = calloc(size + 1,
sizeof(
char));
5845 const DWORD rc = GetEnvironmentVariableX(name, env, size);
5850 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
5856 if (!argv_append_dup(aargc, aargv, cmd))
5860 char* context = NULL;
5861 char* tok = strtok_s(env,
"\n", &context);
5864 if (!argv_append_dup(aargc, aargv, tok))
5866 tok = strtok_s(NULL,
"\n", &context);
5874 argv_free(aargc, aargv);
5878int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
5879 char* oargv[], BOOL allowUnknown)
5881 return freerdp_client_settings_parse_command_line_arguments_ex(
5882 settings, oargc, oargv, allowUnknown, NULL, 0, NULL, NULL);
5885int freerdp_client_settings_parse_command_line_arguments_ex(
5886 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
5888 void* handle_userdata)
5891 char** argv = oargv;
5894 char** aargv = NULL;
5896 bool isArgsFrom =
false;
5897 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
5900 BOOL success = FALSE;
5901 const char* file = strchr(argv[1],
':') + 1;
5904 if (option_starts_with(
"fd:", file))
5906 ULONGLONG result = 0;
5907 const char* val = strchr(file,
':') + 1;
5908 if (!value_to_uint(val, &result, 0, INT_MAX))
5910 fp = fdopen((
int)result,
"r");
5911 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5913 else if (strncmp(file,
"env:", 4) == 0)
5915 const char* name = strchr(file,
':') + 1;
5916 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
5918 else if (strcmp(file,
"stdin") != 0)
5920 fp = winpr_fopen(file,
"r");
5921 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5924 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5932 WINPR_ASSERT(count <= SSIZE_MAX);
5938 res = freerdp_client_settings_parse_command_line_arguments_int(
5939 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata,
5943 argv_free(&aargc, &aargv);
5947static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
5948 const char* name,
void* data)
5950 PVIRTUALCHANNELENTRY entry = NULL;
5951 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
5952 name, NULL, NULL, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
5953 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
5956 entry = freerdp_load_channel_addin_entry(name, NULL, NULL, FREERDP_ADDIN_CHANNEL_STATIC);
5960 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
5962 WLog_DBG(TAG,
"loading channelEx %s", name);
5968 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
5970 WLog_DBG(TAG,
"loading channel %s", name);
5980 FreeRDP_Settings_Keys_Bool settingId;
5981 const char* channelName;
5985BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
5987 ChannelToLoad dynChannels[] = {
5988#if defined(CHANNEL_AINPUT_CLIENT)
5989 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME, NULL },
5991#ifdef CHANNEL_AUDIN_CLIENT
5992 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME, NULL },
5994#ifdef CHANNEL_RDPSND_CLIENT
5995 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME, NULL },
5997#ifdef CHANNEL_RDPEI_CLIENT
5998 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME, NULL },
6000#ifdef CHANNEL_RDPGFX_CLIENT
6001 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME, NULL },
6003#ifdef CHANNEL_ECHO_CLIENT
6004 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME, NULL },
6006#ifdef CHANNEL_SSHAGENT_CLIENT
6007 { FreeRDP_SupportSSHAgentChannel,
"sshagent", NULL },
6009#ifdef CHANNEL_DISP_CLIENT
6010 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME, NULL },
6012#ifdef CHANNEL_GEOMETRY_CLIENT
6013 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME, NULL },
6015#ifdef CHANNEL_VIDEO_CLIENT
6016 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME, NULL },
6018#ifdef CHANNEL_RDPEAR_CLIENT
6019 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME, NULL },
6023 ChannelToLoad staticChannels[] = {
6024#if defined(CHANNEL_RDPSND_CLIENT)
6025 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME, NULL },
6027#if defined(CHANNEL_CLIPRDR_CLIENT)
6028 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME, NULL },
6030#if defined(CHANNEL_ENCOMSP_CLIENT)
6031 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6033#if defined(CHANNEL_REMDESK_CLIENT)
6034 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6036#if defined(CHANNEL_RAIL_CLIENT)
6037 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6044 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6046 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6049 const char*
const p[] = { dynChannels[i].channelName };
6051 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6059 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6060 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6061#
if defined(CHANNEL_TSMF_CLIENT)
6062 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6072 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6088 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6098 char* context = NULL;
6100 value = _strdup(DrivesToRedirect);
6104 tok = strtok_s(value,
";", &context);
6107 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6124 const char* name = NULL;
6125 const char* drive = tok;
6126 char* subcontext = NULL;
6127 char* start = strtok_s(tok,
"(", &subcontext);
6128 char* end = strtok_s(NULL,
")", &subcontext);
6132 if (freerdp_path_valid(name, NULL) && freerdp_path_valid(drive, NULL))
6134 success = freerdp_client_add_drive(settings, name, NULL);
6136 success = freerdp_client_add_drive(settings, drive, NULL);
6139 success = freerdp_client_add_drive(settings, drive, name);
6147 tok = strtok_s(NULL,
";", &context);
6156 if (!freerdp_device_collection_find(settings,
"drive"))
6158 const char*
const params[] = {
"drive",
"media",
"*" };
6160 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6177 if (!freerdp_device_collection_find(settings,
"drive"))
6179 const char* params[] = {
"drive",
"home",
"%" };
6181 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6188 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6192 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6193 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6195 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6197 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6200 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6207 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6209 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0, NULL);
6214 if (!freerdp_device_collection_add(settings, smartcard))
6216 freerdp_device_free(smartcard);
6224 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6226 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0, NULL);
6231 if (!freerdp_device_collection_add(settings, printer))
6233 freerdp_device_free(printer);
6260 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6262 if ((staticChannels[i].settingId == 0) ||
6265 if (staticChannels[i].args)
6267 if (!freerdp_client_load_static_channel_addin(
6268 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6273 const char*
const p[] = { staticChannels[i].channelName };
6274 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6284 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6285 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6294 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6296 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6308 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6316void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6318 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6319 const DWORD log_level = WLOG_WARN;
6320 wLog* log = WLog_Get(TAG);
6323 if (!WLog_IsLevelActive(log, log_level))
6326 WLog_Print_unchecked(log, log_level,
"[unmaintained] %s client is currently unmaintained!",
6328 WLog_Print_unchecked(
6330 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6332 WLog_Print_unchecked(
6334 "Be prepared to fix issues yourself though as nobody is actively working on this.");
6335 WLog_Print_unchecked(
6337 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6338 "- don't hesitate to ask some questions. (replies might take some time depending "
6339 "on your timezone) - if you intend using this component write us a message");
6342void freerdp_client_warn_experimental(
int argc,
char* argv[])
6344 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6345 const DWORD log_level = WLOG_WARN;
6346 wLog* log = WLog_Get(TAG);
6349 if (!WLog_IsLevelActive(log, log_level))
6352 WLog_Print_unchecked(log, log_level,
"[experimental] %s client is currently experimental!",
6354 WLog_Print_unchecked(
6356 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6357 "known issues or create a new one!");
6358 WLog_Print_unchecked(
6360 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6361 "- don't hesitate to ask some questions. (replies might take some time depending "
6362 "on your timezone)");
6365void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6367 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6368 const DWORD log_level = WLOG_WARN;
6369 wLog* log = WLog_Get(TAG);
6372 if (!WLog_IsLevelActive(log, log_level))
6375 WLog_Print_unchecked(log, log_level,
"[deprecated] %s client has been deprecated", app);
6376 WLog_Print_unchecked(log, log_level,
"As replacement there is a SDL3 based client available.");
6377 WLog_Print_unchecked(
6379 "If you are interested in keeping %s alive get in touch with the developers", app);
6380 WLog_Print_unchecked(
6382 "The project is hosted at https://github.com/freerdp/freerdp and "
6383 " developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6384 "- don't hesitate to ask some questions. (replies might take some time depending "
6385 "on your timezone)");
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *param)
Sets a string settings value. The param is copied.
WINPR_ATTR_NODISCARD FREERDP_API char * freerdp_settings_get_string_writable(rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a string settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT16 freerdp_settings_get_uint16(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id)
Returns a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT64 freerdp_settings_get_uint64(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id)
Returns a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT16 freerdp_settings_get_int16(const rdpSettings *settings, FreeRDP_Settings_Keys_Int16 id)
Returns a INT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT64 freerdp_settings_get_int64(const rdpSettings *settings, FreeRDP_Settings_Keys_Int64 id)
Returns a INT64 settings value.
FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
FREERDP_API BOOL freerdp_settings_set_uint64(rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id, UINT64 param)
Sets a UINT64 settings value.
FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *param, size_t len)
Sets a string settings value. The param is copied.
FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 param)
Sets a UINT32 settings value.
FREERDP_API BOOL freerdp_settings_append_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *separator, const char *param)
appends a string to a settings value. The param is copied. If the initial value of the setting was no...
FREERDP_API BOOL freerdp_settings_set_uint16(rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id, UINT16 param)
Sets a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_name_for_key(SSIZE_T key)
Returns the type name for a key.
FREERDP_API BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL param)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.