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 =
nullptr;
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] = WINPR_C_ARRAY_INIT;
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";
135 isSpecial = (option_equals(
"*", path) || option_equals(DynamicDrives, path) ||
136 option_equals(
"%", path));
138 isPath = winpr_PathFileExists(path);
141 *special = isSpecial;
143 return isSpecial || isPath;
146static BOOL freerdp_sanitize_drive_name(
char* name,
const char* invalid,
const char* replacement)
148 if (!name || !invalid || !replacement)
150 if (strlen(invalid) != strlen(replacement))
153 while (*invalid !=
'\0')
155 const char what = *invalid++;
156 const char with = *replacement++;
159 while ((cur = strchr(cur, what)) !=
nullptr)
165static char* name_from_path(
const char* path)
167 const char* name =
"nullptr";
170 if (option_equals(
"%", path))
172 else if (option_equals(
"*", path))
173 name =
"hotplug-all";
174 else if (option_equals(
"DynamicDrives", path))
179 return _strdup(name);
182static BOOL freerdp_client_add_drive(rdpSettings* settings,
const char* path,
const char* name)
184 char* dname =
nullptr;
203 if (!skip && winpr_PathFileExists(name))
205 if (!winpr_PathFileExists(path) || (!PathIsRelativeA(name) && PathIsRelativeA(path)))
207 const char* tmp = path;
215 dname = _strdup(name);
217 dname = name_from_path(path);
219 if (freerdp_sanitize_drive_name(dname,
"\\/",
"__"))
221 const char* args[] = { dname, path };
222 device = freerdp_device_new(RDPDR_DTYP_FILESYSTEM, ARRAYSIZE(args), args);
232 BOOL isSpecial = FALSE;
233 BOOL isPath = freerdp_path_valid(path, &isSpecial);
235 if (!isPath && !isSpecial)
237 WLog_WARN(TAG,
"Invalid drive to redirect: '%s' does not exist, skipping.", path);
238 freerdp_device_free(device);
240 else if (!freerdp_device_collection_add(settings, device))
247 freerdp_device_free(device);
251static BOOL value_to_int(
const char* value, LONGLONG* result, LONGLONG min, LONGLONG max)
255 if (!value || !result)
259 rc = _strtoi64(value,
nullptr, 0);
264 if ((rc < min) || (rc > max))
271static BOOL value_to_uint(
const char* value, ULONGLONG* result, ULONGLONG min, ULONGLONG max)
273 unsigned long long rc = 0;
275 if (!value || !result)
279 rc = _strtoui64(value,
nullptr, 0);
284 if ((rc < min) || (rc > max))
291BOOL freerdp_client_print_version(
void)
293 printf(
"This is FreeRDP version %s (%s)\n", FREERDP_VERSION_FULL, FREERDP_GIT_REVISION);
297BOOL freerdp_client_print_version_ex(
int argc,
char** argv)
299 WINPR_ASSERT(argc >= 0);
300 WINPR_ASSERT(argv || (argc == 0));
301 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
302 printf(
"This is FreeRDP version [%s] %s (%s)\n", name, FREERDP_VERSION_FULL,
303 FREERDP_GIT_REVISION);
307BOOL freerdp_client_print_buildconfig(
void)
309 printf(
"%s", freerdp_get_build_config());
313BOOL freerdp_client_print_buildconfig_ex(
int argc,
char** argv)
315 WINPR_ASSERT(argc >= 0);
316 WINPR_ASSERT(argv || (argc == 0));
317 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
318 printf(
"[%s] %s", name, freerdp_get_build_config());
322static void freerdp_client_print_scancodes(
void)
324 printf(
"RDP scancodes and their name for use with /kbd:remap\n");
326 for (UINT32 x = 0; x < UINT16_MAX; x++)
328 const char* name = freerdp_keyboard_scancode_name(x);
330 printf(
"0x%04" PRIx32
" --> %s\n", x, name);
334static BOOL is_delimiter(
char c,
const char* delimiters)
337 while ((d = *delimiters++) !=
'\0')
345static const char* get_last(
const char* start,
size_t len,
const char* delimiters)
347 const char* last =
nullptr;
348 for (
size_t x = 0; x < len; x++)
351 if (is_delimiter(c, delimiters))
357static SSIZE_T next_delimiter(
const char* text,
size_t len,
size_t max,
const char* delimiters)
362 const char* last = get_last(text, max, delimiters);
366 return (SSIZE_T)(last - text);
369static SSIZE_T forced_newline_at(
const char* text,
size_t len,
size_t limit,
370 const char* force_newline)
373 while ((d = *force_newline++) !=
'\0')
375 const char* tok = strchr(text, d);
378 const size_t offset = WINPR_ASSERTING_INT_CAST(
size_t, tok - text);
379 if ((offset > len) || (offset > limit))
381 return (SSIZE_T)(offset);
387static BOOL print_align(
size_t start_offset,
size_t* current)
389 WINPR_ASSERT(current);
390 if (*current < start_offset)
392 const int rc = printf(
"%*c", (
int)(start_offset - *current),
' ');
395 *current += (size_t)rc;
400static char* print_token(
char* text,
size_t start_offset,
size_t* current,
size_t limit,
401 const char* delimiters,
const char* force_newline)
404 const size_t tlen = strnlen(text, limit);
406 const SSIZE_T force_at = forced_newline_at(text, len, limit - *current, force_newline);
407 BOOL isForce = (force_at >= 0);
410 len = MIN(len, (
size_t)force_at);
412 if (!print_align(start_offset, current))
415 const SSIZE_T delim = next_delimiter(text, len, limit - *current, delimiters);
416 const BOOL isDelim = delim > 0;
419 len = MIN(len, (
size_t)delim + 1);
422 rc = printf(
"%.*s", (
int)len, text);
426 if (isForce || isDelim)
431 const size_t offset = len + ((isForce && (force_at == 0)) ? 1 : 0);
432 return &text[offset];
435 *current += (size_t)rc;
437 if (tlen == (
size_t)rc)
439 return &text[(size_t)rc];
442static size_t print_optionals(
const char* text,
size_t start_offset,
size_t current)
444 const size_t limit = 80;
445 char* str = _strdup(text);
450 cur = print_token(cur, start_offset + 1, ¤t, limit,
"[], ",
"\r\n");
451 }
while (cur !=
nullptr);
457static size_t print_description(
const char* text,
size_t start_offset,
size_t current)
459 const size_t limit = 80;
460 char* str = _strdup(text);
463 while (cur !=
nullptr)
464 cur = print_token(cur, start_offset, ¤t, limit,
" ",
"\r\n");
467 const int rc = printf(
"\n");
470 const size_t src = WINPR_ASSERTING_INT_CAST(
size_t, rc);
471 WINPR_ASSERT(SIZE_MAX - src > current);
477static int cmp_cmdline_args(
const void* pva,
const void* pvb)
482 if (!a->Name && !b->Name)
488 return strcmp(a->Name, b->Name);
503 const size_t description_offset = 30 + 8;
505 if (arg->Flags & (COMMAND_LINE_VALUE_BOOL | COMMAND_LINE_VALUE_FLAG))
507 if ((arg->Flags & (uint32_t)~COMMAND_LINE_VALUE_BOOL) == 0)
508 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
509 else if ((arg->Flags & COMMAND_LINE_VALUE_OPTIONAL) != 0)
510 rc = printf(
" [%s|/]%s", arg->Default ?
"-" :
"+", arg->Name);
513 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
517 rc = printf(
" /%s", arg->Name);
523 if ((arg->Flags & COMMAND_LINE_VALUE_REQUIRED) ||
524 (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL))
528 if (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL)
534 pos = print_optionals(arg->Format, pos, pos);
546 pos = print_optionals(arg->Format, pos, pos);
549 if (pos > description_offset)
557 rc = printf(
"%*c", (
int)(description_offset - pos),
' ');
562 if (arg->Flags & COMMAND_LINE_VALUE_BOOL)
564 rc = printf(
"%s ", arg->Default ?
"Disable" :
"Enable");
570 print_description(arg->Text, description_offset, pos);
571 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
574BOOL freerdp_client_print_command_line_help(
int argc,
char** argv)
576 return freerdp_client_print_command_line_help_ex(argc, argv,
nullptr);
580 SSIZE_T count,
size_t* pcount)
582 WINPR_ASSERT(pcount);
587 while (cur && cur->Name)
602 while (cur && cur->Name)
604 largs[lcount++] = *cur++;
607 cur = global_cmd_args;
608 while (cur && cur->Name)
610 largs[lcount++] = *cur++;
616static void freerdp_client_print_command_line_usage(
int argc,
char** argv)
618 WINPR_ASSERT(argv || (argc < 1));
620 const char* name = freerdp_getApplicationDetailsString();
624 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
625 printf(
"To show full command line help type\n");
626 printf(
"%s /?\n", name);
630BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
633 const char* name = freerdp_getApplicationDetailsString();
645 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
646 printf(
"See www.freerdp.com for more information\n");
648 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
651 printf(
" /flag (enables flag)\n");
652 printf(
" /option:<value> (specifies option with value)\n");
653 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
656 freerdp_client_print_command_line_args(largs, lcount);
660 printf(
"Examples:\n");
661 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
662 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
663 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
664 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
665 "/v:192.168.1.100\n",
667 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
668 printf(
"Use a generic pipe as transport:");
669 printf(
" %s /v:/path/to/pipe\n", name);
670 printf(
"Use a external socket:");
671 printf(
" %s /v:|:1234\n", name);
673 printf(
"Connect to a system with TLS security and open the greeter:");
674 printf(
"NOTE: Needs a server configured to not require NLA or it will fail!");
676 printf(
" %s /sec:tls /p /v:rdp.contoso.com\n", name);
678 printf(
"Disable clipboard redirection: -clipboard\n");
680 printf(
"Drive Redirection: /drive:home,/home/user\n");
681 printf(
"Smartcard Redirection: /smartcard:<device>\n");
682 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
684#if defined(CHANNEL_SERIAL_CLIENT)
685 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
686 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
688#if defined(CHANNEL_PARALLEL_CLIENT)
689 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
691 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
692 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
694 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
695 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
696 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
697 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
699 printf(
"Multimedia Redirection: /video\n");
700#ifdef CHANNEL_URBDRC_CLIENT
701 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
704 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
706 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
708 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
710 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
712 printf(
"More documentation is coming, in the meantime consult source files\n");
717static BOOL option_is_rdp_file(
const char* option)
719 WINPR_ASSERT(option);
721 if (option_ends_with(option,
".rdp"))
723 if (option_ends_with(option,
".rdpw"))
728static BOOL option_is_incident_file(
const char* option)
730 WINPR_ASSERT(option);
732 return (option_ends_with(option,
".msrcIncident"));
735static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
740 rdpSettings* settings =
nullptr;
745 length = strlen(argv[index]);
749 if (option_is_rdp_file(argv[index]))
751 settings = (rdpSettings*)context;
754 return COMMAND_LINE_ERROR_MEMORY;
762 if (option_is_incident_file(argv[index]))
764 settings = (rdpSettings*)context;
767 return COMMAND_LINE_ERROR_MEMORY;
777BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
778 const char*
const* params)
780 WINPR_ASSERT(settings);
781 WINPR_ASSERT(params);
782 WINPR_ASSERT(count > 0);
784 if (option_equals(params[0],
"drive"))
793 rc = freerdp_client_add_drive(settings, params[1],
nullptr);
795 rc = freerdp_client_add_drive(settings, params[2], params[1]);
799 else if (option_equals(params[0],
"printer"))
811 printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
815 if (!freerdp_device_collection_add(settings, printer))
817 freerdp_device_free(printer);
823 else if (option_equals(params[0],
"smartcard"))
835 smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
840 if (!freerdp_device_collection_add(settings, smartcard))
842 freerdp_device_free(smartcard);
848#if defined(CHANNEL_SERIAL_CLIENT)
849 else if (option_equals(params[0],
"serial"))
861 serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
866 if (!freerdp_device_collection_add(settings, serial))
868 freerdp_device_free(serial);
875 else if (option_equals(params[0],
"parallel"))
887 parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
892 if (!freerdp_device_collection_add(settings, parallel))
894 freerdp_device_free(parallel);
904BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
906 return freerdp_static_channel_collection_del(settings, name);
909BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
910 const char*
const* params)
914 if (!settings || !params || !params[0] || (count > INT_MAX))
917 if (freerdp_static_channel_collection_find(settings, params[0]))
920 _args = freerdp_addin_argv_new(count, params);
925 if (!freerdp_static_channel_collection_add(settings, _args))
930 freerdp_addin_argv_free(_args);
934BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
936 return freerdp_dynamic_channel_collection_del(settings, name);
939BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
940 const char*
const* params)
944 if (!settings || !params || !params[0] || (count > INT_MAX))
947 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
950 _args = freerdp_addin_argv_new(count, params);
955 if (!freerdp_dynamic_channel_collection_add(settings, _args))
961 freerdp_addin_argv_free(_args);
965static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
const char* file)
968 char* pem = crypto_read_pem(file, &length);
969 if (!pem || (length == 0))
983 CMDLINE_SUBOPTION_STRING,
984 CMDLINE_SUBOPTION_FILE,
985} CmdLineSubOptionType;
987typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
991 FreeRDP_Settings_Keys_String id;
992 CmdLineSubOptionType opttype;
993 WINPR_ATTR_NODISCARD CmdLineSubOptionCb cb;
996static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
1001 for (
size_t xx = 0; xx < count; xx++)
1003 const CmdLineSubOptions* opt = &opts[xx];
1005 if (option_starts_with(opt->optname, arg))
1007 const size_t optlen = strlen(opt->optname);
1008 const char* val = &arg[optlen];
1011 switch (opt->opttype)
1013 case CMDLINE_SUBOPTION_STRING:
1016 case CMDLINE_SUBOPTION_FILE:
1017 status = read_pem_file(settings, opt->id, val);
1020 WLog_ERR(TAG,
"invalid subOption type");
1027 if (opt->cb && !opt->cb(val, settings))
1036 WLog_ERR(TAG,
"option %s not handled", arg);
1041#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1048 const DWORD level = WLOG_ERROR;
1049 wLog* log = WLog_Get(TAG);
1050 if (WLog_IsLevelActive(log, level))
1051 WLog_PrintTextMessage(log, level, line, file, fkt,
1052 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name,
1059 rdpSettings* settings = (rdpSettings*)context;
1060 int status = CHANNEL_RC_OK;
1061 BOOL enable = (arg->Value !=
nullptr);
1063 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1066 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1068 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1069 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1071 status = COMMAND_LINE_ERROR;
1073 CommandLineParserFree(ptr);
1075 return fail_at(arg, status);
1077 CommandLineSwitchCase(arg,
"kerberos")
1081 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1084 const CmdLineSubOptions opts[] = {
1085 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING,
nullptr },
1086 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1087 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1088 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1089 CMDLINE_SUBOPTION_STRING,
nullptr },
1090 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING,
nullptr },
1091 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING,
nullptr },
1092 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1093 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1096 for (
size_t x = 1; x < count; x++)
1098 const char* cur = ptr[x];
1099 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1101 CommandLineParserFree(ptr);
1102 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1106 CommandLineParserFree(ptr);
1109 CommandLineSwitchCase(arg,
"vc")
1112 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1113 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1114 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1115 CommandLineParserFree(ptr);
1117 return fail_at(arg, status);
1119 CommandLineSwitchCase(arg,
"dvc")
1122 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1123 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1124 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1125 CommandLineParserFree(ptr);
1127 return fail_at(arg, status);
1129 CommandLineSwitchCase(arg,
"drive")
1132 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1133 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1134 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1135 CommandLineParserFree(ptr);
1137 return fail_at(arg, status);
1139#if defined(CHANNEL_SERIAL_CLIENT)
1140 CommandLineSwitchCase(arg,
"serial")
1143 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1144 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1145 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1146 CommandLineParserFree(ptr);
1148 return fail_at(arg, status);
1151#if defined(CHANNEL_PARALLEL_CLIENT)
1152 CommandLineSwitchCase(arg,
"parallel")
1155 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1156 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1157 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1158 CommandLineParserFree(ptr);
1160 return fail_at(arg, status);
1163 CommandLineSwitchCase(arg,
"smartcard")
1166 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1167 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1168 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1169 CommandLineParserFree(ptr);
1171 return fail_at(arg, status);
1173 CommandLineSwitchCase(arg,
"printer")
1176 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1177 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1178 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1179 CommandLineParserFree(ptr);
1181 return fail_at(arg, status);
1183 CommandLineSwitchCase(arg,
"usb")
1187 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1188 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1189 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1190 CommandLineParserFree(ptr);
1192 return fail_at(arg, status);
1194 CommandLineSwitchCase(arg,
"multitouch")
1197 return fail_at(arg, COMMAND_LINE_ERROR);
1199 CommandLineSwitchCase(arg,
"gestures")
1202 return fail_at(arg, COMMAND_LINE_ERROR);
1204 CommandLineSwitchCase(arg,
"echo")
1207 return fail_at(arg, COMMAND_LINE_ERROR);
1209 CommandLineSwitchCase(arg,
"ssh-agent")
1212 return fail_at(arg, COMMAND_LINE_ERROR);
1214 CommandLineSwitchCase(arg,
"disp")
1217 return fail_at(arg, COMMAND_LINE_ERROR);
1219 CommandLineSwitchCase(arg,
"geometry")
1222 return fail_at(arg, COMMAND_LINE_ERROR);
1224 CommandLineSwitchCase(arg,
"video")
1228 return fail_at(arg, COMMAND_LINE_ERROR);
1230 return fail_at(arg, COMMAND_LINE_ERROR);
1232 CommandLineSwitchCase(arg,
"sound")
1236 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1237 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1238 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1239 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1240 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1242 CommandLineParserFree(ptr);
1244 return fail_at(arg, status);
1246 CommandLineSwitchCase(arg,
"microphone")
1249 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1250 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1251 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1252 CommandLineParserFree(ptr);
1254 return fail_at(arg, status);
1256#if defined(CHANNEL_TSMF_CLIENT)
1257 CommandLineSwitchCase(arg,
"multimedia")
1260 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1261 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1262 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1263 CommandLineParserFree(ptr);
1265 return fail_at(arg, status);
1268 CommandLineSwitchCase(arg,
"heartbeat")
1271 return fail_at(arg, COMMAND_LINE_ERROR);
1273 CommandLineSwitchCase(arg,
"multitransport")
1276 return fail_at(arg, COMMAND_LINE_ERROR);
1281 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1284 return fail_at(arg, COMMAND_LINE_ERROR);
1286 CommandLineSwitchEnd(arg)
1293 int status = freerdp_client_command_line_post_filter_int(context, arg);
1294 return status == CHANNEL_RC_OK ? 1 : -1;
1297static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1298 const char** domain,
size_t* domainlen)
1301 WINPR_ASSERT(userlen);
1302 WINPR_ASSERT(domain);
1303 WINPR_ASSERT(domainlen);
1308 const char* p = strchr(username,
'\\');
1318 const size_t length = (size_t)(p - username);
1320 *userlen = strlen(*user);
1323 *domainlen = length;
1332 *userlen = strlen(username);
1338static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1339 FreeRDP_Settings_Keys_String userID,
1340 FreeRDP_Settings_Keys_String domainID)
1342 const char* user =
nullptr;
1343 const char* domain =
nullptr;
1345 size_t domainlen = 0;
1347 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1355BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1357 const char* user =
nullptr;
1358 const char* domain =
nullptr;
1360 size_t domainlen = 0;
1365 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1371 *puser = strndup(user, userlen);
1378 *pdomain = strndup(domain, domainlen);
1390BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1393 p = strrchr(hostname,
':');
1397 size_t length = (size_t)(p - hostname);
1400 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1403 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1408 CopyMemory(*host, hostname, length);
1409 (*host)[length] =
'\0';
1410 *port = (UINT16)val;
1414 *host = _strdup(hostname);
1425static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1427 struct network_settings
1429 FreeRDP_Settings_Keys_Bool id;
1432 const struct network_settings config[] = {
1433 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1434 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1435 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1436 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1437 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1438 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1443 case CONNECTION_TYPE_INVALID:
1446 case CONNECTION_TYPE_MODEM:
1447 case CONNECTION_TYPE_BROADBAND_LOW:
1448 case CONNECTION_TYPE_BROADBAND_HIGH:
1449 case CONNECTION_TYPE_SATELLITE:
1450 case CONNECTION_TYPE_WAN:
1451 case CONNECTION_TYPE_LAN:
1452 case CONNECTION_TYPE_AUTODETECT:
1455 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1459 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1461 const struct network_settings* cur = &config[x];
1468BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1476 case CONNECTION_TYPE_INVALID:
1477 case CONNECTION_TYPE_MODEM:
1478 case CONNECTION_TYPE_BROADBAND_LOW:
1479 case CONNECTION_TYPE_SATELLITE:
1480 case CONNECTION_TYPE_BROADBAND_HIGH:
1481 case CONNECTION_TYPE_WAN:
1482 case CONNECTION_TYPE_LAN:
1483 if (!freerdp_apply_connection_type(settings, type))
1486 case CONNECTION_TYPE_AUTODETECT:
1487 if (!freerdp_apply_connection_type(settings, type))
1501 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1508static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1513 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1515 if (!layouts || (count == 0))
1518 for (
size_t x = 0; x < count; x++)
1521 if (option_equals(layout->name, name))
1529 freerdp_keyboard_layouts_free(layouts, count);
1533static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1535 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1536 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1538 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1540 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1548static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1551 WINPR_UNUSED(context);
1558 length = strlen(argv[index]);
1562 if (option_is_rdp_file(argv[index]))
1570 if (option_is_incident_file(argv[index]))
1580static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1585 int detect_status = 0;
1588 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1590 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1591 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1595 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1600 CommandLineClearArgumentsA(largs);
1601 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1602 freerdp_detect_command_line_pre_filter,
nullptr);
1611 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1615 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1617 return detect_status;
1620static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1625 int detect_status = 0;
1628 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1630 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1631 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1632 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1636 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1641 CommandLineClearArgumentsA(largs);
1642 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1643 freerdp_detect_command_line_pre_filter,
nullptr);
1652 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1656 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1658 return detect_status;
1661static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1663 size_t posix_cli_count = 0;
1664 size_t windows_cli_count = 0;
1665 const BOOL ignoreUnknown = TRUE;
1666 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1667 argc, argv, &windows_cli_count, ignoreUnknown);
1668 const int posix_cli_status =
1669 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1672 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1673 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1674 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1676 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1680 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1681 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1683 windows_cli_count = 1;
1684 *flags = COMMAND_LINE_SEPARATOR_COLON;
1685 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1688 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1689 windows_cli_count, posix_cli_status, posix_cli_count);
1690 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1692 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1698int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1701 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv,
1705static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1709 layouts = freerdp_keyboard_get_layouts(type, &count);
1711 printf(
"\n%s\n", msg);
1713 for (
size_t x = 0; x < count; x++)
1716 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1719 freerdp_keyboard_layouts_free(layouts, count);
1722static void freerdp_client_print_keyboard_list(
void)
1724 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1725 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1726 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1727 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1728 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1731static void freerdp_client_print_timezone_list(
void)
1735 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1737 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
1739 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1740 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1741 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1745static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1749 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1757 case RDP_SETTINGS_TYPE_BOOL:
1758 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1763 case RDP_SETTINGS_TYPE_UINT16:
1764 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1767 case RDP_SETTINGS_TYPE_INT16:
1768 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1771 case RDP_SETTINGS_TYPE_UINT32:
1772 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1775 case RDP_SETTINGS_TYPE_INT32:
1776 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1779 case RDP_SETTINGS_TYPE_UINT64:
1780 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1783 case RDP_SETTINGS_TYPE_INT64:
1784 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1787 case RDP_SETTINGS_TYPE_STRING:
1788 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1793 case RDP_SETTINGS_TYPE_POINTER:
1794 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1806static int evaluate_result(
int argc,
char* argv[],
int rc, rdpSettings* settings,
1809 WINPR_ASSERT(settings);
1810 WINPR_ASSERT(largs);
1812 if (rc != COMMAND_LINE_STATUS_PRINT)
1814 freerdp_client_print_command_line_usage(argc, argv);
1821 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1823 if (option_equals(
"timezones", arg->Value))
1824 freerdp_client_print_timezone_list();
1825 else if (option_equals(
"tune", arg->Value))
1826 freerdp_client_print_tune_list(settings);
1827 else if (option_equals(
"kbd", arg->Value))
1828 freerdp_client_print_keyboard_list();
1829 else if (option_starts_with(
"kbd-lang", arg->Value))
1831 const char* val =
nullptr;
1832 if (option_starts_with(
"kbd-lang:", arg->Value))
1833 val = &arg->Value[9];
1834 else if (!option_equals(
"kbd-lang", arg->Value))
1835 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1837 if (val && strchr(val,
','))
1838 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1839 freerdp_client_print_codepages(val);
1841 else if (option_equals(
"kbd-scancode", arg->Value))
1842 freerdp_client_print_scancodes();
1843 else if (option_equals(
"monitor", arg->Value))
1846 return COMMAND_LINE_ERROR;
1848 else if (option_starts_with(
"smartcard", arg->Value))
1851 if (option_starts_with(
"smartcard:", arg->Value))
1853 else if (!option_equals(
"smartcard", arg->Value))
1854 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1858 const char* sub = strchr(arg->Value,
':') + 1;
1859 const CmdLineSubOptions options[] = {
1860 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1861 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1866 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1868 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1871 CommandLineParserFree(ptr);
1872 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1875 for (
size_t x = 1; x < count; x++)
1877 const char* cur = ptr[x];
1878 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1880 CommandLineParserFree(ptr);
1881 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1885 CommandLineParserFree(ptr);
1888 freerdp_smartcard_list(settings);
1892 freerdp_client_print_command_line_usage(argc, argv);
1893 return COMMAND_LINE_ERROR;
1896#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1897 arg = CommandLineFindArgumentA(largs,
"tune-list");
1900 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1902 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
1903 freerdp_client_print_tune_list(settings);
1906 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
1909 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1911 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
1912 freerdp_client_print_codepages(arg->Value);
1915 arg = CommandLineFindArgumentA(largs,
"kbd-list");
1918 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1920 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
1921 freerdp_client_print_keyboard_list();
1924 arg = CommandLineFindArgumentA(largs,
"monitor-list");
1927 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1929 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
1931 return COMMAND_LINE_ERROR;
1934 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
1937 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1939 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
1940 freerdp_smartcard_list(settings);
1943 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
1946 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1949 "Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
1950 freerdp_client_print_scancodes();
1951 return COMMAND_LINE_STATUS_PRINT;
1954 return COMMAND_LINE_STATUS_PRINT;
1957int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
1958 int argc,
char** argv,
1961 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
1963 freerdp_client_print_version();
1967 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
1969 freerdp_client_print_version_ex(argc, argv);
1970 freerdp_client_print_buildconfig_ex(argc, argv);
1973 else if (status == COMMAND_LINE_STATUS_PRINT)
1976 COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SIGIL_PLUS_MINUS | COMMAND_LINE_SIGIL_SLASH;
1978 size_t customcount = 0;
1981 while (cur && cur->Name)
1987 size_t globalcount = 0;
1990 while (cur && cur->Name)
2006 CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
nullptr,
nullptr);
2007 status = evaluate_result(argc, argv, rc, settings, largs);
2011 else if (status == COMMAND_LINE_STATUS_PRINT_HELP)
2013 freerdp_client_print_command_line_help_ex(argc, argv, custom);
2016 else if (status < 0)
2018 freerdp_client_print_command_line_usage(argc, argv);
2023 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
2036static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
2038 const char* xcharpos =
nullptr;
2039 char* endPtr =
nullptr;
2040 unsigned long v = 0;
2042 v = strtoul(input, &endPtr, 10);
2044 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2050 xcharpos = strchr(input,
'x');
2052 if (!xcharpos || xcharpos != endPtr)
2056 v = strtoul(xcharpos + 1, &endPtr, 10);
2058 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2061 if (*endPtr !=
'\0')
2073 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2074 WINPR_ASSERT(settings);
2080 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2082 const char* arg = arguments[x];
2084 if (p && (p->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
2088 return freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT);
2091static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2096const char* option_starts_with(
const char* what,
const char* val)
2100 const size_t wlen = strlen(what);
2102 if (_strnicmp(what, val, wlen) != 0)
2107BOOL option_ends_with(
const char* str,
const char* ext)
2111 const size_t strLen = strlen(str);
2112 const size_t extLen = strlen(ext);
2114 if (strLen < extLen)
2117 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2120BOOL option_equals(
const char* what,
const char* val)
2124 return _stricmp(what, val) == 0;
2133} PARSE_ON_OFF_RESULT;
2135static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2137 WINPR_ASSERT(value);
2138 const char* sep = strchr(value,
':');
2141 if (option_equals(
"on", &sep[1]))
2143 if (option_equals(
"off", &sep[1]))
2152 CLIP_DIR_PARSE_LOCAL,
2153 CLIP_DIR_PARSE_REMOTE,
2155} PARSE_CLIP_DIR_RESULT;
2157static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2159 WINPR_ASSERT(value);
2160 const char* sep = strchr(value,
':');
2162 return CLIP_DIR_PARSE_FAIL;
2163 if (option_equals(
"all", &sep[1]))
2164 return CLIP_DIR_PARSE_ALL;
2165 if (option_equals(
"off", &sep[1]))
2166 return CLIP_DIR_PARSE_OFF;
2167 if (option_equals(
"local", &sep[1]))
2168 return CLIP_DIR_PARSE_LOCAL;
2169 if (option_equals(
"remote", &sep[1]))
2170 return CLIP_DIR_PARSE_REMOTE;
2171 return CLIP_DIR_PARSE_FAIL;
2174static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2176 const char* ciphers =
nullptr;
2178 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2180 if (option_equals(Value,
"netmon"))
2182 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2184 else if (option_equals(Value,
"ma"))
2186 ciphers =
"AES128-SHA";
2194 return COMMAND_LINE_ERROR_MEMORY;
2198static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2202 if (!value_to_int(Value, &val, 0, 5))
2203 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2206 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2210static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2213 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2216 return COMMAND_LINE_ERROR_MEMORY;
2220static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2222 UINT16 version = TLS1_2_VERSION;
2231 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2232 {
"1.1", TLS1_1_VERSION },
2233 {
"1.2", TLS1_2_VERSION }
2234#if defined(TLS1_3_VERSION)
2236 {
"1.3", TLS1_3_VERSION }
2240 const struct map_t* found =
nullptr;
2241 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2243 const struct map_t* cur = &map[x];
2244 if (option_equals(cur->name, Value))
2252 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2253 version = found->version;
2258 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2264 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2265 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2267 if (option_starts_with(
"ciphers:", arg->Value))
2268 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2269 else if (option_starts_with(
"seclevel:", arg->Value))
2270 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2271 else if (option_starts_with(
"secrets-file:", arg->Value))
2272 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2273 else if (option_starts_with(
"enforce:", arg->Value))
2274 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2277#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2278 CommandLineSwitchCase(arg,
"tls-ciphers")
2280 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2281 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2283 CommandLineSwitchCase(arg,
"tls-seclevel")
2285 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2286 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2288 CommandLineSwitchCase(arg,
"tls-secrets-file")
2290 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2291 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2293 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2295 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2296 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2299 CommandLineSwitchDefault(arg)
2302 CommandLineSwitchEnd(arg)
2309 WINPR_ASSERT(settings);
2313 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2314 for (
size_t x = 0; x < count; x++)
2317 larg.Value = ptr[x];
2319 int rc = parse_tls_cipher_options(settings, &larg);
2322 CommandLineParserFree(ptr);
2326 CommandLineParserFree(ptr);
2332 WINPR_ASSERT(settings);
2336 return COMMAND_LINE_ERROR;
2340 int rc = CHANNEL_RC_OK;
2342 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2343 if (!ptr || (count == 0))
2344 rc = COMMAND_LINE_ERROR;
2347 BOOL GfxH264 = FALSE;
2348 BOOL GfxAVC444 = FALSE;
2349 BOOL RemoteFxCodec = FALSE;
2350 BOOL GfxProgressive = FALSE;
2351 BOOL codecSelected = FALSE;
2353 for (
size_t x = 0; x < count; x++)
2355 const char* val = ptr[x];
2357 if (option_starts_with(
"AVC444", val))
2359 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2360 if (bval == PARSE_FAIL)
2361 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2363 GfxAVC444 = bval != PARSE_OFF;
2364 codecSelected = TRUE;
2366 else if (option_starts_with(
"AVC420", val))
2368 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2369 if (bval == PARSE_FAIL)
2370 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2372 GfxH264 = bval != PARSE_OFF;
2373 codecSelected = TRUE;
2377 if (option_starts_with(
"RFX", val))
2379 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2380 if (bval == PARSE_FAIL)
2381 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2383 RemoteFxCodec = bval != PARSE_OFF;
2384 codecSelected = TRUE;
2386 else if (option_starts_with(
"progressive", val))
2388 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2389 if (bval == PARSE_FAIL)
2390 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2392 GfxProgressive = bval != PARSE_OFF;
2393 codecSelected = TRUE;
2395 else if (option_starts_with(
"mask:", val))
2398 const char* uv = &val[5];
2399 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2400 rc = COMMAND_LINE_ERROR;
2405 rc = COMMAND_LINE_ERROR;
2408 else if (option_starts_with(
"small-cache", val))
2410 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2411 if (bval == PARSE_FAIL)
2412 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2415 rc = COMMAND_LINE_ERROR;
2417 else if (option_starts_with(
"thin-client", val))
2419 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2420 if (bval == PARSE_FAIL)
2421 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2424 rc = COMMAND_LINE_ERROR;
2425 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2429 rc = COMMAND_LINE_ERROR;
2432 else if (option_starts_with(
"frame-ack", val))
2434 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2435 if (bval == PARSE_FAIL)
2436 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2439 rc = COMMAND_LINE_ERROR;
2441#if defined(WITH_GFX_AV1)
2442 else if (option_starts_with(
"AV1", val))
2444 uint32_t profile = 1;
2445 BOOL enabled = FALSE;
2446 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2447 if (bval == PARSE_FAIL)
2449 if (_stricmp(
"av1:i420", val) == 0)
2454 else if (_stricmp(
"av1:i444", val) == 0)
2460 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2463 enabled = bval == PARSE_ON;
2465 if (enabled || (bval != PARSE_FAIL))
2468 rc = COMMAND_LINE_ERROR;
2471 rc = COMMAND_LINE_ERROR;
2476 rc = COMMAND_LINE_ERROR;
2479 if ((rc == CHANNEL_RC_OK) && codecSelected)
2482 rc = COMMAND_LINE_ERROR;
2484 rc = COMMAND_LINE_ERROR;
2486 rc = COMMAND_LINE_ERROR;
2488 rc = COMMAND_LINE_ERROR;
2490 rc = COMMAND_LINE_ERROR;
2493 CommandLineParserFree(ptr);
2494 if (rc != CHANNEL_RC_OK)
2497 return CHANNEL_RC_OK;
2500static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2502 WINPR_ASSERT(settings);
2503 WINPR_ASSERT(value);
2507 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2510 ival = freerdp_map_keyboard_layout_name_to_id(value);
2514 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2515 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2516 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2523 rc = COMMAND_LINE_ERROR;
2528#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2531 WINPR_ASSERT(settings);
2535 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2537 return COMMAND_LINE_ERROR;
2539 if (option_equals(arg->Value,
"rfx"))
2542 return COMMAND_LINE_ERROR;
2544 else if (option_equals(arg->Value,
"nsc"))
2547 return COMMAND_LINE_ERROR;
2550#if defined(WITH_JPEG)
2551 else if (option_equals(arg->Value,
"jpeg"))
2554 return COMMAND_LINE_ERROR;
2559 return COMMAND_LINE_ERROR;
2568static BOOL check_kbd_remap_valid(
const char* token)
2573 WINPR_ASSERT(token);
2575 if (strlen(token) > 10)
2578 if (!freerdp_extract_key_value(token, &key, &value))
2580 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2588 WINPR_ASSERT(settings);
2592 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2594 return COMMAND_LINE_ERROR_MEMORY;
2595 char* p = strchr(arg->Value,
'[');
2600 const char scheme[] =
"://";
2601 const char* val = strstr(arg->Value, scheme);
2603 val += strnlen(scheme,
sizeof(scheme));
2606 p = strchr(val,
':');
2613 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2614 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2616 length = (size_t)(p - arg->Value);
2618 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2621 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2626 return COMMAND_LINE_ERROR_MEMORY;
2632 char* p2 = strchr(arg->Value,
']');
2636 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2638 length = (size_t)(p2 - p);
2640 return COMMAND_LINE_ERROR_MEMORY;
2642 if (*(p2 + 1) ==
':')
2646 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2647 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2650 return COMMAND_LINE_ERROR;
2653 printf(
"hostname %s port %" PRIu32
"\n",
2662 WINPR_ASSERT(settings);
2666 char* cur = arg->Value;
2668 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2670 return COMMAND_LINE_ERROR;
2676 char* next = strchr(cur,
',');
2684 if (option_equals(
"fqdn", cur))
2686 else if (option_equals(
"ip", cur))
2688 else if (option_equals(
"netbios", cur))
2691 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2694 mask = (mask & 0x07);
2695 value |= mask << (count * 3);
2697 }
while (cur !=
nullptr);
2700 return COMMAND_LINE_ERROR;
2703 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2707static int parse_prevent_session_lock_options(rdpSettings* settings,
2710 WINPR_ASSERT(settings);
2714 return COMMAND_LINE_ERROR_MEMORY;
2716 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2720 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2721 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2724 return COMMAND_LINE_ERROR_MEMORY;
2732 WINPR_ASSERT(settings);
2736 return COMMAND_LINE_ERROR;
2743 return COMMAND_LINE_ERROR;
2745 return COMMAND_LINE_ERROR;
2747 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2750 return COMMAND_LINE_ERROR;
2753 return COMMAND_LINE_ERROR_MEMORY;
2761 WINPR_ASSERT(settings);
2765 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2766 char* p = strchr(arg->Value,
'x');
2770 unsigned long w = 0;
2771 unsigned long h = 0;
2773 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2774 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2777 return COMMAND_LINE_ERROR;
2779 return COMMAND_LINE_ERROR;
2783 char* str = _strdup(arg->Value);
2785 return COMMAND_LINE_ERROR_MEMORY;
2787 p = strchr(str,
'%');
2791 BOOL partial = FALSE;
2793 status = COMMAND_LINE_ERROR;
2820 if (!value_to_int(str, &val, 0, 100))
2822 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2842 WINPR_ASSERT(settings);
2845 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2848 UINT32* MonitorIds =
nullptr;
2849 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2852 return COMMAND_LINE_ERROR_MEMORY;
2859 CommandLineParserFree(ptr);
2863 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
2864 for (UINT32 i = 0; i < count; i++)
2868 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
2869 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2871 MonitorIds[i] = (UINT32)val;
2874 CommandLineParserFree(ptr);
2880static int parse_dynamic_resolution_options(rdpSettings* settings,
2883 WINPR_ASSERT(settings);
2886 const BOOL val = arg->Value !=
nullptr;
2890 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2891 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2895 return COMMAND_LINE_ERROR;
2897 return COMMAND_LINE_ERROR;
2904 WINPR_ASSERT(settings);
2909 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2910 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2914 return COMMAND_LINE_ERROR;
2918 unsigned long w = 0;
2919 unsigned long h = 0;
2921 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2922 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2925 return COMMAND_LINE_ERROR;
2927 return COMMAND_LINE_ERROR;
2934 WINPR_ASSERT(settings);
2939 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
2940 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2950 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2954 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2961 WINPR_ASSERT(settings);
2964 int rc = CHANNEL_RC_OK;
2966 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2967 if (!ptr || (count == 0))
2968 rc = COMMAND_LINE_ERROR;
2971 for (
size_t x = 0; x < count; x++)
2973 const char* val = ptr[x];
2975 if (option_starts_with(
"remap:", val))
2978 char* now = _strdup(&val[6]);
2983 if (!check_kbd_remap_valid(now))
2984 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2987 const size_t olen = strlen(old);
2988 const size_t alen = strlen(now);
2989 const size_t tlen = olen + alen + 2;
2990 char* tmp = calloc(tlen,
sizeof(
char));
2992 rc = COMMAND_LINE_ERROR_MEMORY;
2994 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
3002 rc = COMMAND_LINE_ERROR;
3006 else if (option_starts_with(
"layout:", val))
3008 rc = parse_kbd_layout(settings, &val[7]);
3010 else if (option_starts_with(
"lang:", val))
3013 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3015 ival = freerdp_get_locale_id_from_string(&val[5]);
3018 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3021 rc = COMMAND_LINE_ERROR;
3023 else if (option_starts_with(
"type:", val))
3026 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3028 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3030 rc = COMMAND_LINE_ERROR;
3032 else if (option_starts_with(
"subtype:", val))
3035 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
3037 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3040 rc = COMMAND_LINE_ERROR;
3042 else if (option_starts_with(
"fn-key:", val))
3045 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
3047 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3050 rc = COMMAND_LINE_ERROR;
3052 else if (option_starts_with(
"unicode", val))
3054 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3055 if (bval == PARSE_FAIL)
3056 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3059 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3061 else if (option_starts_with(
"pipe:", val))
3064 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3066 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3068#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3069 else if (count == 1)
3072 rc = parse_kbd_layout(settings, val);
3076 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3082 CommandLineParserFree(ptr);
3088 WINPR_ASSERT(settings);
3093 return COMMAND_LINE_ERROR_MEMORY;
3095 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3097 const char* cur = arg->Value;
3100 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3102 if (!proxy_parse_uri(settings, cur))
3103 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3107 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3108 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3115 WINPR_ASSERT(settings);
3118 BOOL failed = FALSE;
3120 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3125 BOOL modernsyntax = FALSE;
3126 BOOL oldsyntax = FALSE;
3127 for (
size_t x = 0; (x < count) && !failed; x++)
3129 const char* carg = ptr[x];
3130 if (option_starts_with(
"file:", carg))
3132 const char* val = &carg[5];
3137 modernsyntax = TRUE;
3139 else if (option_equals(
"replay", carg))
3146 else if (option_equals(
"record", carg))
3153 else if (option_equals(
"nodelay", carg))
3160 modernsyntax = TRUE;
3175 if (oldsyntax && (count != 2))
3178 CommandLineParserFree(ptr);
3180 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3186 WINPR_ASSERT(settings);
3189 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3192 (arg->Value == BoolValueTrue)))
3193 return COMMAND_LINE_ERROR;
3199 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3200 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3202 const char* usesel =
"use-selection:";
3204 const char* cur = ptr[x];
3205 if (option_starts_with(usesel, cur))
3207 const char* val = &cur[strlen(usesel)];
3209 rc = COMMAND_LINE_ERROR_MEMORY;
3211 return COMMAND_LINE_ERROR;
3213 else if (option_starts_with(
"direction-to", cur))
3217 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3218 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3222 case CLIP_DIR_PARSE_ALL:
3223 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3225 case CLIP_DIR_PARSE_LOCAL:
3226 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3228 case CLIP_DIR_PARSE_REMOTE:
3229 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3231 case CLIP_DIR_PARSE_OFF:
3233 case CLIP_DIR_PARSE_FAIL:
3235 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3241 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3243 else if (option_starts_with(
"files-to", cur))
3247 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3248 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3249 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3253 case CLIP_DIR_PARSE_ALL:
3255 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3257 case CLIP_DIR_PARSE_LOCAL:
3258 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3260 case CLIP_DIR_PARSE_REMOTE:
3261 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3263 case CLIP_DIR_PARSE_OFF:
3265 case CLIP_DIR_PARSE_FAIL:
3267 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3273 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3276 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3278 CommandLineParserFree(ptr);
3288 WINPR_ASSERT(settings);
3293 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3294 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3298 case AUDIO_MODE_REDIRECT:
3300 return COMMAND_LINE_ERROR;
3303 case AUDIO_MODE_PLAY_ON_SERVER:
3305 return COMMAND_LINE_ERROR;
3308 case AUDIO_MODE_NONE:
3310 return COMMAND_LINE_ERROR;
3312 return COMMAND_LINE_ERROR;
3316 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3323 WINPR_ASSERT(settings);
3326 UINT32 type = CONNECTION_TYPE_INVALID;
3328 if (option_equals(arg->Value,
"invalid"))
3329 type = CONNECTION_TYPE_INVALID;
3330 else if (option_equals(arg->Value,
"modem"))
3331 type = CONNECTION_TYPE_MODEM;
3332 else if (option_equals(arg->Value,
"broadband"))
3333 type = CONNECTION_TYPE_BROADBAND_HIGH;
3334 else if (option_equals(arg->Value,
"broadband-low"))
3335 type = CONNECTION_TYPE_BROADBAND_LOW;
3336 else if (option_equals(arg->Value,
"broadband-high"))
3337 type = CONNECTION_TYPE_BROADBAND_HIGH;
3338 else if (option_equals(arg->Value,
"wan"))
3339 type = CONNECTION_TYPE_WAN;
3340 else if (option_equals(arg->Value,
"lan"))
3341 type = CONNECTION_TYPE_LAN;
3342 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3343 (option_equals(arg->Value,
"detect")))
3345 type = CONNECTION_TYPE_AUTODETECT;
3351 if (!value_to_int(arg->Value, &val, 0, 7))
3352 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3357 if (!freerdp_set_connection_type(settings, type))
3358 return COMMAND_LINE_ERROR;
3364 WINPR_ASSERT(settings);
3368 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3370 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3372 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3373 for (
size_t x = 0; x < count; x++)
3375 const char* cur = ptr[x];
3376 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3377 if (bval == PARSE_FAIL)
3379 CommandLineParserFree(ptr);
3380 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3383 const BOOL val = bval != PARSE_OFF;
3384 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3385 if (option_starts_with(
"rdp", cur))
3387 id = FreeRDP_RdpSecurity;
3389 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3391 else if (option_starts_with(
"tls", cur))
3392 id = FreeRDP_TlsSecurity;
3393 else if (option_starts_with(
"nla", cur))
3394 id = FreeRDP_NlaSecurity;
3395 else if (option_starts_with(
"ext", cur))
3396 id = FreeRDP_ExtSecurity;
3397 else if (option_equals(
"aad", cur))
3398 id = FreeRDP_AadSecurity;
3401 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3402 CommandLineParserFree(ptr);
3403 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3406 if ((bval == PARSE_NONE) && (count == 1))
3407 singleOptionWithoutOnOff = id;
3409 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3412 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3414 const FreeRDP_Settings_Keys_Bool options[] = { FreeRDP_AadSecurity,
3415 FreeRDP_UseRdpSecurityLayer,
3416 FreeRDP_RdpSecurity, FreeRDP_NlaSecurity,
3417 FreeRDP_TlsSecurity };
3419 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3422 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3426 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3427 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3430 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3433 CommandLineParserFree(ptr);
3437static int parse_encryption_methods_options(rdpSettings* settings,
3440 WINPR_ASSERT(settings);
3443 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3446 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3448 UINT32 EncryptionMethods = 0;
3449 for (UINT32 i = 0; i < count; i++)
3451 if (option_equals(ptr[i],
"40"))
3452 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3453 else if (option_equals(ptr[i],
"56"))
3454 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3455 else if (option_equals(ptr[i],
"128"))
3456 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3457 else if (option_equals(ptr[i],
"FIPS"))
3458 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3460 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3464 return COMMAND_LINE_ERROR;
3465 CommandLineParserFree(ptr);
3472 WINPR_ASSERT(settings);
3477 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3478 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3480 const char deny[] =
"deny";
3481 const char ignore[] =
"ignore";
3482 const char tofu[] =
"tofu";
3483 const char name[] =
"name:";
3484 const char fingerprints[] =
"fingerprint:";
3486 const char* cur = ptr[x];
3487 if (option_equals(deny, cur))
3490 return COMMAND_LINE_ERROR;
3492 else if (option_equals(ignore, cur))
3495 return COMMAND_LINE_ERROR;
3497 else if (option_equals(tofu, cur))
3500 return COMMAND_LINE_ERROR;
3502 else if (option_starts_with(name, cur))
3504 const char* val = &cur[strnlen(name,
sizeof(name))];
3506 rc = COMMAND_LINE_ERROR_MEMORY;
3508 else if (option_starts_with(fingerprints, cur))
3510 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3513 rc = COMMAND_LINE_ERROR_MEMORY;
3516 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3518 CommandLineParserFree(ptr);
3525 WINPR_ASSERT(settings);
3529 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3533 for (
size_t x = 1; x < count; x++)
3535 const char* cur = ptr[x];
3537 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3538 if (bval == PARSE_FAIL)
3539 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3542 const BOOL val = bval != PARSE_OFF;
3544 if (option_starts_with(
"relative", cur))
3547 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3549 else if (option_starts_with(
"grab", cur))
3552 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3560 CommandLineParserFree(ptr);
3567 WINPR_ASSERT(settings);
3571 UINT32 Floatbar = 0x0017;
3575 char* start = arg->Value;
3580 start = strchr(start,
',');
3589 if (option_starts_with(
"sticky:", cur))
3593 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3605 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3609 else if (option_starts_with(
"default:", cur))
3611 const char* val = cur + 8;
3614 if (option_equals(
"visible", val))
3616 else if (option_equals(
"hidden", val))
3619 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3622 else if (option_starts_with(
"show:", cur))
3624 const char* val = cur + 5;
3627 if (option_equals(
"always", val))
3629 else if (option_equals(
"fullscreen", val))
3631 else if (option_equals(
"window", val))
3634 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3637 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3641 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3647 WINPR_ASSERT(settings);
3650 BYTE* base64 =
nullptr;
3653 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3655 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3661 return COMMAND_LINE_ERROR;
3665 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3672static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3674 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3682 WINPR_ASSERT(settings);
3687 if (!value_to_int(arg->Value, &val, 100, 180))
3688 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3696 return COMMAND_LINE_ERROR;
3698 return COMMAND_LINE_ERROR;
3699 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3700 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3701 return fail_at(arg, COMMAND_LINE_ERROR);
3705 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3712 WINPR_ASSERT(settings);
3717 if (!value_to_int(arg->Value, &val, 100, 180))
3718 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3726 return COMMAND_LINE_ERROR;
3727 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3728 return fail_at(arg, COMMAND_LINE_ERROR);
3732 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3739 WINPR_ASSERT(settings);
3745 return COMMAND_LINE_ERROR;
3747 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3750 const CmdLineSubOptions opts[] = {
3751 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3752 setSmartcardEmulation },
3753 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3754 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING,
nullptr },
3755 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING,
nullptr },
3756 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING,
nullptr },
3757 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING,
nullptr },
3758 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING,
nullptr }
3761 for (
size_t x = 1; x < count; x++)
3763 const char* cur = ptr[x];
3764 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
3766 CommandLineParserFree(ptr);
3767 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3771 CommandLineParserFree(ptr);
3777 WINPR_ASSERT(settings);
3781 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
3783 return COMMAND_LINE_ERROR;
3784 for (
size_t x = 1; x < count; x++)
3786 const char* cur = ptr[x];
3787 char* sep = strchr(cur,
':');
3790 CommandLineParserFree(ptr);
3791 return COMMAND_LINE_ERROR;
3794 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
3796 CommandLineParserFree(ptr);
3797 return COMMAND_LINE_ERROR;
3801 CommandLineParserFree(ptr);
3805static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
3807 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
3808 FreeRDP_RemoteAppLanguageBarSupported,
3809 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
3810 FreeRDP_DisableFullWindowDrag };
3813 return COMMAND_LINE_ERROR_MEMORY;
3815 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
3818 return COMMAND_LINE_ERROR;
3820 return CHANNEL_RC_OK;
3825 WINPR_ASSERT(settings);
3828 int rc = CHANNEL_RC_OK;
3830 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3831 if (!ptr || (count == 0))
3832 rc = COMMAND_LINE_ERROR;
3839 int (*fkt)(rdpSettings* settings,
const char* value);
3841 const struct app_map amap[] = {
3842 {
"tenantid:", FreeRDP_GatewayAvdAadtenantid,
nullptr },
3843 {
"ad:", FreeRDP_GatewayAzureActiveDirectory,
nullptr },
3844 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat,
nullptr },
3845 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat,
nullptr },
3846 {
"avd-scope:", FreeRDP_GatewayAvdScope,
nullptr }
3849 for (
size_t x = 0; x < count; x++)
3851 BOOL handled = FALSE;
3852 const char* val = ptr[x];
3854 if (option_starts_with(
"use-tenantid", val))
3856 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3857 if (bval == PARSE_FAIL)
3859 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3867 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3873 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3875 const struct app_map* cur = &amap[y];
3876 if (option_starts_with(cur->name, val))
3878 const char* xval = &val[strlen(cur->name)];
3880 rc = cur->fkt(settings, xval);
3884 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3885 rc = COMMAND_LINE_ERROR_MEMORY;
3894 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3901 CommandLineParserFree(ptr);
3907 WINPR_ASSERT(settings);
3910 int rc = CHANNEL_RC_OK;
3912 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3913 if (!ptr || (count == 0))
3914 rc = COMMAND_LINE_ERROR;
3921 int (*fkt)(rdpSettings* settings,
const char* value);
3923 const struct app_map amap[] = {
3924 {
"program:", FreeRDP_RemoteApplicationProgram, parse_app_option_program },
3925 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir,
nullptr },
3926 {
"name:", FreeRDP_RemoteApplicationName,
nullptr },
3927 {
"icon:", FreeRDP_RemoteApplicationIcon,
nullptr },
3928 {
"cmd:", FreeRDP_RemoteApplicationCmdLine,
nullptr },
3929 {
"file:", FreeRDP_RemoteApplicationFile,
nullptr },
3930 {
"guid:", FreeRDP_RemoteApplicationGuid,
nullptr },
3931 {
"hidef:", FreeRDP_HiDefRemoteApp,
nullptr }
3933 for (
size_t x = 0; x < count; x++)
3935 BOOL handled = FALSE;
3936 const char* val = ptr[x];
3938 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3940 const struct app_map* cur = &amap[y];
3941 if (option_starts_with(cur->name, val))
3943 const char* xval = &val[strlen(cur->name)];
3945 rc = cur->fkt(settings, xval);
3949 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3950 rc = COMMAND_LINE_ERROR_MEMORY;
3958#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3959 if (!handled && (count == 1))
3962 rc = parse_app_option_program(settings, val);
3967 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3974 CommandLineParserFree(ptr);
3980 WINPR_ASSERT(settings);
3983 int rc = CHANNEL_RC_OK;
3985 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3986 if (!ptr || (count == 0))
3987 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3989 for (
size_t x = 0; x < count; x++)
3991 const char* val = ptr[x];
3993 if (option_starts_with(
"codec:", val))
3996 rc = COMMAND_LINE_ERROR;
3997 else if (option_equals(arg->Value,
"rfx"))
4000 rc = COMMAND_LINE_ERROR;
4002 else if (option_equals(arg->Value,
"nsc"))
4005 rc = COMMAND_LINE_ERROR;
4008#if defined(WITH_JPEG)
4009 else if (option_equals(arg->Value,
"jpeg"))
4012 rc = COMMAND_LINE_ERROR;
4017 return COMMAND_LINE_ERROR;
4023 else if (option_starts_with(
"persist-file:", val))
4027 rc = COMMAND_LINE_ERROR_MEMORY;
4029 rc = COMMAND_LINE_ERROR;
4033 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
4034 if (bval == PARSE_FAIL)
4035 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4038 if (option_starts_with(
"bitmap", val))
4042 rc = COMMAND_LINE_ERROR;
4044 else if (option_starts_with(
"glyph", val))
4047 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
4048 : GLYPH_SUPPORT_NONE))
4049 rc = COMMAND_LINE_ERROR;
4051 else if (option_starts_with(
"persist", val))
4055 rc = COMMAND_LINE_ERROR;
4057 else if (option_starts_with(
"offscreen", val))
4061 rc = COMMAND_LINE_ERROR;
4067 CommandLineParserFree(ptr);
4071static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
4073 WINPR_ASSERT(settings);
4076 char* name =
nullptr;
4078 if (!freerdp_parse_hostname(host, &name, &port))
4097static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
4098 FreeRDP_Settings_Keys_String what)
4100 WINPR_ASSERT(settings);
4101 WINPR_ASSERT(value);
4105 case FreeRDP_GatewayUsername:
4106 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4107 FreeRDP_GatewayDomain))
4119static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4123 WINPR_ASSERT(settings);
4124 WINPR_ASSERT(value);
4126 if (option_equals(value,
"rpc"))
4137 if (option_equals(value,
"http"))
4145 else if (option_equals(value,
"auto"))
4153 else if (option_equals(value,
"arm"))
4166static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4170 WINPR_ASSERT(settings);
4171 WINPR_ASSERT(value);
4173 if (option_equals(value,
"none"))
4174 type = TSC_PROXY_MODE_NONE_DIRECT;
4175 else if (option_equals(value,
"direct"))
4176 type = TSC_PROXY_MODE_DIRECT;
4177 else if (option_equals(value,
"detect"))
4178 type = TSC_PROXY_MODE_DETECT;
4179 else if (option_equals(value,
"default"))
4180 type = TSC_PROXY_MODE_DEFAULT;
4185 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4192static char* unescape(
const char* str)
4194 char* copy = _strdup(str);
4198 bool escaped =
false;
4200 while (*str !=
'\0')
4228 char* argval =
nullptr;
4231 WINPR_ASSERT(settings);
4235 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4244 BOOL allowHttpOpts = FALSE;
4245 for (
size_t x = 0; x < count; x++)
4247 BOOL validOption = FALSE;
4249 argval = unescape(ptr[x]);
4253 const char* gw = option_starts_with(
"g:", argval);
4256 if (!parse_gateway_host_option(settings, gw))
4259 allowHttpOpts = FALSE;
4262 const char* gu = option_starts_with(
"u:", argval);
4265 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4268 allowHttpOpts = FALSE;
4271 const char* gd = option_starts_with(
"d:", argval);
4274 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4277 allowHttpOpts = FALSE;
4280 const char* gp = option_starts_with(
"p:", argval);
4283 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4286 allowHttpOpts = FALSE;
4289 const char* gt = option_starts_with(
"type:", argval);
4292 if (!parse_gateway_type_option(settings, gt))
4298 const char* gat = option_starts_with(
"access-token:", argval);
4304 allowHttpOpts = FALSE;
4307 const char* bearer = option_starts_with(
"bearer:", argval);
4314 allowHttpOpts = FALSE;
4317 const char* gwurl = option_starts_with(
"url:", argval);
4325 allowHttpOpts = FALSE;
4328 const char* um = option_starts_with(
"usage-method:", argval);
4331 if (!parse_gateway_usage_option(settings, um))
4334 allowHttpOpts = FALSE;
4339 if (option_equals(argval,
"no-websockets"))
4346 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4363 CommandLineParserFree(ptr);
4370 WINPR_ASSERT(value);
4376 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4377 FillMemory(arg->Value, strlen(arg->Value),
'*');
4382 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4384 const char* cred = credential_args[x];
4385 fill_credential_string(args, cred);
4389 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4391 const char* gwcreds[] = {
"p:",
"access-token:" };
4392 char* saveptr =
nullptr;
4393 char* tok = strtok_s(arg->Value,
",", &saveptr);
4396 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4398 const char* opt = gwcreds[x];
4399 if (option_starts_with(opt, tok))
4401 char* val = &tok[strlen(opt)];
4402 FillMemory(val, strlen(val),
'*');
4405 tok = strtok_s(
nullptr,
",", &saveptr);
4410static int parse_command_line_option_uint32(rdpSettings* settings,
4412 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4417 if (!value_to_int(arg->Value, &val, min, max))
4418 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4421 return fail_at(arg, COMMAND_LINE_ERROR);
4425#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4430 WINPR_ASSERT(settings);
4433 BOOL enable = arg->Value ? TRUE : FALSE;
4434 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4436 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4438 return fail_at(arg, COMMAND_LINE_ERROR);
4443 return fail_at(arg, COMMAND_LINE_ERROR);
4447 return fail_at(arg, COMMAND_LINE_ERROR);
4449 CommandLineSwitchCase(arg,
"gfx-small-cache")
4451 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4453 return fail_at(arg, COMMAND_LINE_ERROR);
4457 return fail_at(arg, COMMAND_LINE_ERROR);
4459 CommandLineSwitchCase(arg,
"gfx-progressive")
4461 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4463 return fail_at(arg, COMMAND_LINE_ERROR);
4465 return fail_at(arg, COMMAND_LINE_ERROR);
4470 return fail_at(arg, COMMAND_LINE_ERROR);
4474 CommandLineSwitchCase(arg,
"gfx-h264")
4476 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4477 int rc = parse_gfx_options(settings, arg);
4479 return fail_at(arg, rc);
4482 CommandLineSwitchCase(arg,
"app-workdir")
4485 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4487 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4489 CommandLineSwitchCase(arg,
"app-name")
4491 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4493 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4495 CommandLineSwitchCase(arg,
"app-icon")
4497 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4499 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4501 CommandLineSwitchCase(arg,
"app-cmd")
4503 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4505 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4507 CommandLineSwitchCase(arg,
"app-file")
4509 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4511 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4513 CommandLineSwitchCase(arg,
"app-guid")
4515 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4517 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4519 CommandLineSwitchCase(arg,
"g")
4521 if (!parse_gateway_host_option(settings, arg->Value))
4522 return fail_at(arg, COMMAND_LINE_ERROR);
4524 CommandLineSwitchCase(arg,
"gu")
4526 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4527 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4529 CommandLineSwitchCase(arg,
"gd")
4531 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4532 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4534 CommandLineSwitchCase(arg,
"gp")
4536 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4537 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4539 CommandLineSwitchCase(arg,
"gt")
4541 if (!parse_gateway_type_option(settings, arg->Value))
4542 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4544 CommandLineSwitchCase(arg,
"gat")
4547 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4549 CommandLineSwitchCase(arg,
"gateway-usage-method")
4551 if (!parse_gateway_usage_option(settings, arg->Value))
4552 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4554 CommandLineSwitchCase(arg,
"kbd-remap")
4556 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4557 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4559 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4561 CommandLineSwitchCase(arg,
"kbd-lang")
4565 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4566 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4568 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4569 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4570 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4574 return fail_at(arg, COMMAND_LINE_ERROR);
4576 CommandLineSwitchCase(arg,
"kbd-type")
4578 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4580 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4582 return fail_at(arg, rc);
4584 CommandLineSwitchCase(arg,
"kbd-unicode")
4586 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4588 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4590 CommandLineSwitchCase(arg,
"kbd-subtype")
4592 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4594 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4596 return fail_at(arg, rc);
4598 CommandLineSwitchCase(arg,
"kbd-fn-key")
4600 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4601 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4604 return fail_at(arg, rc);
4606 CommandLineSwitchCase(arg,
"bitmap-cache")
4608 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4610 return fail_at(arg, COMMAND_LINE_ERROR);
4612 CommandLineSwitchCase(arg,
"persist-cache")
4614 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4616 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4618 CommandLineSwitchCase(arg,
"persist-cache-file")
4620 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4621 "/cache:persist-file:<filename> instead");
4623 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4626 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4628 CommandLineSwitchCase(arg,
"offscreen-cache")
4630 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4632 return fail_at(arg, COMMAND_LINE_ERROR);
4634 CommandLineSwitchCase(arg,
"glyph-cache")
4636 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4638 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4639 return fail_at(arg, COMMAND_LINE_ERROR);
4641 CommandLineSwitchCase(arg,
"codec-cache")
4643 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4644 const int rc = parse_codec_cache_options(settings, arg);
4646 return fail_at(arg, rc);
4648 CommandLineSwitchCase(arg,
"sec-rdp")
4650 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4652 return fail_at(arg, COMMAND_LINE_ERROR);
4654 CommandLineSwitchCase(arg,
"sec-tls")
4656 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4658 return fail_at(arg, COMMAND_LINE_ERROR);
4660 CommandLineSwitchCase(arg,
"sec-nla")
4662 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4664 return fail_at(arg, COMMAND_LINE_ERROR);
4666 CommandLineSwitchCase(arg,
"sec-ext")
4668 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4670 return fail_at(arg, COMMAND_LINE_ERROR);
4672 CommandLineSwitchCase(arg,
"tls-ciphers")
4674 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4675 "/tls:ciphers:<cipher list> instead");
4676 int rc = parse_tls_cipher_options(settings, arg);
4678 return fail_at(arg, rc);
4680 CommandLineSwitchCase(arg,
"tls-seclevel")
4682 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4683 int rc = parse_tls_cipher_options(settings, arg);
4685 return fail_at(arg, rc);
4687 CommandLineSwitchCase(arg,
"tls-secrets-file")
4689 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4690 "/tls:secrets-file:<filename> instead");
4691 int rc = parse_tls_cipher_options(settings, arg);
4693 return fail_at(arg, rc);
4695 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4697 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4698 int rc = parse_tls_cipher_options(settings, arg);
4700 return fail_at(arg, rc);
4702 CommandLineSwitchCase(arg,
"cert-name")
4704 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4706 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4708 CommandLineSwitchCase(arg,
"cert-ignore")
4710 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4712 return fail_at(arg, COMMAND_LINE_ERROR);
4714 CommandLineSwitchCase(arg,
"cert-tofu")
4716 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4718 return fail_at(arg, COMMAND_LINE_ERROR);
4720 CommandLineSwitchCase(arg,
"cert-deny")
4722 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4724 return fail_at(arg, COMMAND_LINE_ERROR);
4726 CommandLineSwitchDefault(arg)
4730 CommandLineSwitchEnd(arg);
4735static int parse_command_line_option_timezone(rdpSettings* settings,
4741 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
4742 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
4744 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
4745 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
4747 WINPR_ASSERT(arg->Value);
4748 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
4755 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4758 return fail_at(arg, COMMAND_LINE_ERROR);
4763 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4765 tz->Bias = info.Bias;
4766 tz->DaylightBias = info.DaylightBias;
4767 tz->DaylightDate = info.DaylightDate;
4768 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
4769 tz->StandardBias = info.StandardBias;
4770 tz->StandardDate = info.StandardDate;
4771 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
4776static int parse_command_line_option_window_pos(rdpSettings* settings,
4779 WINPR_ASSERT(settings);
4782 unsigned long x = 0;
4783 unsigned long y = 0;
4786 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4788 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
4790 WLog_ERR(TAG,
"invalid window-position argument");
4791 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4795 return fail_at(arg, COMMAND_LINE_ERROR);
4797 return fail_at(arg, COMMAND_LINE_ERROR);
4802 freerdp_command_line_handle_option_t handle_option,
4803 void* handle_userdata, BOOL* promptForPassword,
char** user)
4805 WINPR_ASSERT(promptForPassword);
4810 BOOL enable = (arg->Value !=
nullptr);
4812 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
4815 CommandLineSwitchStart(arg)
4817 CommandLineSwitchCase(arg,
"v")
4819 const int rc = parse_host_options(settings, arg);
4821 return fail_at(arg, rc);
4823 CommandLineSwitchCase(arg,
"spn-class")
4827 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4829 CommandLineSwitchCase(arg,
"sspi-module")
4832 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4834 CommandLineSwitchCase(arg,
"winscard-module")
4837 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4839 CommandLineSwitchCase(arg,
"redirect-prefer")
4841 const int rc = parse_redirect_prefer_options(settings, arg);
4843 return fail_at(arg, rc);
4845 CommandLineSwitchCase(arg,
"credentials-delegation")
4848 return fail_at(arg, COMMAND_LINE_ERROR);
4850 CommandLineSwitchCase(arg,
"prevent-session-lock")
4852 const int rc = parse_prevent_session_lock_options(settings, arg);
4854 return fail_at(arg, rc);
4856 CommandLineSwitchCase(arg,
"vmconnect")
4858 const int rc = parse_vmconnect_options(settings, arg);
4860 return fail_at(arg, rc);
4862 CommandLineSwitchCase(arg,
"w")
4864 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
4867 return fail_at(arg, rc);
4869 CommandLineSwitchCase(arg,
"h")
4871 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
4874 return fail_at(arg, rc);
4876 CommandLineSwitchCase(arg,
"size")
4878 const int rc = parse_size_options(settings, arg);
4880 return fail_at(arg, rc);
4882 CommandLineSwitchCase(arg,
"f")
4885 return fail_at(arg, COMMAND_LINE_ERROR);
4887 CommandLineSwitchCase(arg,
"suppress-output")
4890 return fail_at(arg, COMMAND_LINE_ERROR);
4892 CommandLineSwitchCase(arg,
"multimon")
4895 return fail_at(arg, COMMAND_LINE_ERROR);
4897 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4899 if (option_equals(arg->Value, str_force))
4902 return fail_at(arg, COMMAND_LINE_ERROR);
4906 CommandLineSwitchCase(arg,
"span")
4909 return fail_at(arg, COMMAND_LINE_ERROR);
4911 CommandLineSwitchCase(arg,
"workarea")
4914 return fail_at(arg, COMMAND_LINE_ERROR);
4916 CommandLineSwitchCase(arg,
"monitors")
4918 const int rc = parse_monitors_options(settings, arg);
4920 return fail_at(arg, rc);
4922 CommandLineSwitchCase(arg,
"t")
4925 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4927 CommandLineSwitchCase(arg,
"decorations")
4930 return fail_at(arg, COMMAND_LINE_ERROR);
4932 CommandLineSwitchCase(arg,
"dynamic-resolution")
4934 const int rc = parse_dynamic_resolution_options(settings, arg);
4936 return fail_at(arg, rc);
4938 CommandLineSwitchCase(arg,
"smart-sizing")
4940 const int rc = parse_smart_sizing_options(settings, arg);
4942 return fail_at(arg, rc);
4944 CommandLineSwitchCase(arg,
"bpp")
4946 const int rc = parse_bpp_options(settings, arg);
4948 return fail_at(arg, rc);
4950 CommandLineSwitchCase(arg,
"admin")
4953 return fail_at(arg, COMMAND_LINE_ERROR);
4955 CommandLineSwitchCase(arg,
"relax-order-checks")
4959 return fail_at(arg, COMMAND_LINE_ERROR);
4961 CommandLineSwitchCase(arg,
"restricted-admin")
4964 return fail_at(arg, COMMAND_LINE_ERROR);
4966 return fail_at(arg, COMMAND_LINE_ERROR);
4968#ifdef CHANNEL_RDPEAR_CLIENT
4969 CommandLineSwitchCase(arg,
"remoteGuard")
4972 return fail_at(arg, COMMAND_LINE_ERROR);
4974 return fail_at(arg, COMMAND_LINE_ERROR);
4977 CommandLineSwitchCase(arg,
"pth")
4980 return fail_at(arg, COMMAND_LINE_ERROR);
4982 return fail_at(arg, COMMAND_LINE_ERROR);
4985 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4987 CommandLineSwitchCase(arg,
"client-hostname")
4990 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4992 CommandLineSwitchCase(arg,
"kbd")
4994 int rc = parse_kbd_options(settings, arg);
4996 return fail_at(arg, rc);
4999 CommandLineSwitchCase(arg,
"u")
5001 WINPR_ASSERT(arg->Value);
5004 CommandLineSwitchCase(arg,
"d")
5007 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5009 CommandLineSwitchCase(arg,
"p")
5013 const char* val = arg->Value;
5018 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5020 CommandLineSwitchCase(arg,
"gateway")
5022 if (!parse_gateway_options(settings, arg))
5023 return fail_at(arg, COMMAND_LINE_ERROR);
5025 CommandLineSwitchCase(arg,
"proxy")
5027 const int rc = parse_proxy_options(settings, arg);
5029 return fail_at(arg, rc);
5032 CommandLineSwitchCase(arg,
"azure")
5034 int rc = parse_aad_options(settings, arg);
5036 return fail_at(arg, rc);
5038 CommandLineSwitchCase(arg,
"app")
5040 int rc = parse_app_options(settings, arg);
5042 return fail_at(arg, rc);
5044 CommandLineSwitchCase(arg,
"load-balance-info")
5046 WINPR_ASSERT(arg->Value);
5048 strlen(arg->Value)))
5049 return fail_at(arg, COMMAND_LINE_ERROR);
5052 CommandLineSwitchCase(arg,
"compression")
5055 return fail_at(arg, COMMAND_LINE_ERROR);
5057 CommandLineSwitchCase(arg,
"compression-level")
5059 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
5062 return fail_at(arg, rc);
5064 CommandLineSwitchCase(arg,
"drives")
5067 return fail_at(arg, COMMAND_LINE_ERROR);
5069 CommandLineSwitchCase(arg,
"dump")
5071 const int rc = parse_dump_options(settings, arg);
5073 return fail_at(arg, rc);
5075 CommandLineSwitchCase(arg,
"disable-output")
5078 return fail_at(arg, COMMAND_LINE_ERROR);
5080 CommandLineSwitchCase(arg,
"home-drive")
5083 return fail_at(arg, COMMAND_LINE_ERROR);
5085 CommandLineSwitchCase(arg,
"ipv4")
5087 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5090 return fail_at(arg, COMMAND_LINE_ERROR);
5095 return fail_at(arg, COMMAND_LINE_ERROR);
5098 CommandLineSwitchCase(arg,
"ipv6")
5100 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5103 return fail_at(arg, COMMAND_LINE_ERROR);
5108 return fail_at(arg, COMMAND_LINE_ERROR);
5111 CommandLineSwitchCase(arg,
"clipboard")
5113 const int rc = parse_clipboard_options(settings, arg);
5115 return fail_at(arg, rc);
5117 CommandLineSwitchCase(arg,
"server-name")
5120 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5122 CommandLineSwitchCase(arg,
"shell")
5125 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5127 CommandLineSwitchCase(arg,
"shell-dir")
5130 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5132 CommandLineSwitchCase(arg,
"audio-mode")
5134 const int rc = parse_audio_mode_options(settings, arg);
5136 return fail_at(arg, rc);
5138 CommandLineSwitchCase(arg,
"network")
5140 const int rc = parse_network_options(settings, arg);
5142 return fail_at(arg, rc);
5144 CommandLineSwitchCase(arg,
"fonts")
5147 return fail_at(arg, COMMAND_LINE_ERROR);
5149 CommandLineSwitchCase(arg,
"wallpaper")
5152 return fail_at(arg, COMMAND_LINE_ERROR);
5154 CommandLineSwitchCase(arg,
"window-drag")
5157 return fail_at(arg, COMMAND_LINE_ERROR);
5159 CommandLineSwitchCase(arg,
"window-position")
5161 const int rc = parse_command_line_option_window_pos(settings, arg);
5163 return fail_at(arg, rc);
5165 CommandLineSwitchCase(arg,
"menu-anims")
5168 return fail_at(arg, COMMAND_LINE_ERROR);
5170 CommandLineSwitchCase(arg,
"themes")
5173 return fail_at(arg, COMMAND_LINE_ERROR);
5175 CommandLineSwitchCase(arg,
"timeout")
5178 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5180 return fail_at(arg, rc);
5182 CommandLineSwitchCase(arg,
"timezone")
5184 const int rc = parse_command_line_option_timezone(settings, arg);
5186 return fail_at(arg, rc);
5188 CommandLineSwitchCase(arg,
"aero")
5191 return fail_at(arg, COMMAND_LINE_ERROR);
5193 CommandLineSwitchCase(arg,
"gdi")
5195 if (option_equals(arg->Value,
"sw"))
5198 return fail_at(arg, COMMAND_LINE_ERROR);
5200 else if (option_equals(arg->Value,
"hw"))
5203 return fail_at(arg, COMMAND_LINE_ERROR);
5206 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5208 CommandLineSwitchCase(arg,
"gfx")
5210 int rc = parse_gfx_options(settings, arg);
5212 return fail_at(arg, rc);
5215 CommandLineSwitchCase(arg,
"rfx")
5218 return fail_at(arg, COMMAND_LINE_ERROR);
5220 CommandLineSwitchCase(arg,
"rfx-mode")
5223 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5225 if (option_equals(arg->Value,
"video"))
5228 return fail_at(arg, COMMAND_LINE_ERROR);
5230 else if (option_equals(arg->Value,
"image"))
5233 return fail_at(arg, COMMAND_LINE_ERROR);
5235 return fail_at(arg, COMMAND_LINE_ERROR);
5238 CommandLineSwitchCase(arg,
"frame-ack")
5240 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5243 return fail_at(arg, rc);
5245 CommandLineSwitchCase(arg,
"nsc")
5248 return fail_at(arg, COMMAND_LINE_ERROR);
5250#if defined(WITH_JPEG)
5251 CommandLineSwitchCase(arg,
"jpeg")
5254 return fail_at(arg, COMMAND_LINE_ERROR);
5256 return fail_at(arg, COMMAND_LINE_ERROR);
5258 CommandLineSwitchCase(arg,
"jpeg-quality")
5262 if (!value_to_int(arg->Value, &val, 0, 100))
5263 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5266 return fail_at(arg, COMMAND_LINE_ERROR);
5269 CommandLineSwitchCase(arg,
"nego")
5272 return fail_at(arg, COMMAND_LINE_ERROR);
5274 CommandLineSwitchCase(arg,
"pcb")
5277 return fail_at(arg, COMMAND_LINE_ERROR);
5280 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5282 CommandLineSwitchCase(arg,
"pcid")
5284 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5287 return fail_at(arg, rc);
5289 return fail_at(arg, COMMAND_LINE_ERROR);
5292 CommandLineSwitchCase(arg,
"connect-child-session")
5306 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5309 CommandLineSwitchCase(arg,
"sec")
5311 const int rc = parse_sec_options(settings, arg);
5313 return fail_at(arg, rc);
5315 CommandLineSwitchCase(arg,
"encryption-methods")
5317 const int rc = parse_encryption_methods_options(settings, arg);
5319 return fail_at(arg, rc);
5321 CommandLineSwitchCase(arg,
"args-from")
5323 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5325 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5327 CommandLineSwitchCase(arg,
"from-stdin")
5330 return fail_at(arg, COMMAND_LINE_ERROR);
5332 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5335 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5336 *promptForPassword = (option_equals(arg->Value, str_force));
5338 if (!*promptForPassword)
5339 return fail_at(arg, COMMAND_LINE_ERROR);
5342 CommandLineSwitchCase(arg,
"log-level")
5344 wLog* root = WLog_GetRoot();
5346 if (!WLog_SetStringLogLevel(root, arg->Value))
5347 return fail_at(arg, COMMAND_LINE_ERROR);
5349 CommandLineSwitchCase(arg,
"log-filters")
5351 if (!WLog_AddStringLogFilters(arg->Value))
5352 return fail_at(arg, COMMAND_LINE_ERROR);
5354 CommandLineSwitchCase(arg,
"tls")
5356 int rc = parse_tls_options(settings, arg);
5358 return fail_at(arg, rc);
5360 CommandLineSwitchCase(arg,
"cert")
5362 const int rc = parse_cert_options(settings, arg);
5364 return fail_at(arg, rc);
5366 CommandLineSwitchCase(arg,
"authentication")
5369 return fail_at(arg, COMMAND_LINE_ERROR);
5371 CommandLineSwitchCase(arg,
"encryption")
5374 return fail_at(arg, COMMAND_LINE_ERROR);
5376 CommandLineSwitchCase(arg,
"grab-keyboard")
5379 return fail_at(arg, COMMAND_LINE_ERROR);
5381 CommandLineSwitchCase(arg,
"grab-mouse")
5384 return fail_at(arg, COMMAND_LINE_ERROR);
5386 CommandLineSwitchCase(arg,
"mouse-relative")
5389 return fail_at(arg, COMMAND_LINE_ERROR);
5391 CommandLineSwitchCase(arg,
"mouse")
5393 const int rc = parse_mouse_options(settings, arg);
5395 return fail_at(arg, rc);
5397 CommandLineSwitchCase(arg,
"unmap-buttons")
5400 return fail_at(arg, COMMAND_LINE_ERROR);
5402 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5405 return fail_at(arg, COMMAND_LINE_ERROR);
5407 CommandLineSwitchCase(arg,
"force-console-callbacks")
5410 return fail_at(arg, COMMAND_LINE_ERROR);
5412 CommandLineSwitchCase(arg,
"floatbar")
5414 const int rc = parse_floatbar_options(settings, arg);
5416 return fail_at(arg, rc);
5418 CommandLineSwitchCase(arg,
"mouse-motion")
5421 return fail_at(arg, COMMAND_LINE_ERROR);
5423 CommandLineSwitchCase(arg,
"parent-window")
5427 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5428 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5431 return fail_at(arg, COMMAND_LINE_ERROR);
5433 CommandLineSwitchCase(arg,
"client-build-number")
5436 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5438 return fail_at(arg, rc);
5440 CommandLineSwitchCase(arg,
"cache")
5442 int rc = parse_cache_options(settings, arg);
5444 return fail_at(arg, rc);
5447 CommandLineSwitchCase(arg,
"max-fast-path-size")
5449 const int rc = parse_command_line_option_uint32(
5450 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5452 return fail_at(arg, rc);
5454 CommandLineSwitchCase(arg,
"auto-request-control")
5458 return fail_at(arg, COMMAND_LINE_ERROR);
5460 CommandLineSwitchCase(arg,
"async-update")
5463 return fail_at(arg, COMMAND_LINE_ERROR);
5465 CommandLineSwitchCase(arg,
"async-channels")
5468 return fail_at(arg, COMMAND_LINE_ERROR);
5470 CommandLineSwitchCase(arg,
"wm-class")
5473 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5475 CommandLineSwitchCase(arg,
"play-rfx")
5478 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5481 return fail_at(arg, COMMAND_LINE_ERROR);
5483 CommandLineSwitchCase(arg,
"auth-only")
5486 return fail_at(arg, COMMAND_LINE_ERROR);
5488 CommandLineSwitchCase(arg,
"auth-pkg-list")
5492 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5494 CommandLineSwitchCase(arg,
"auto-reconnect")
5497 return fail_at(arg, COMMAND_LINE_ERROR);
5499 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5501 const int rc = parse_command_line_option_uint32(
5502 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5504 return fail_at(arg, rc);
5506 CommandLineSwitchCase(arg,
"reconnect-cookie")
5508 const int rc = parse_reconnect_cookie_options(settings, arg);
5510 return fail_at(arg, rc);
5512 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5515 return fail_at(arg, COMMAND_LINE_ERROR);
5517 CommandLineSwitchCase(arg,
"pwidth")
5519 const int rc = parse_command_line_option_uint32(
5520 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5522 return fail_at(arg, rc);
5524 CommandLineSwitchCase(arg,
"pheight")
5526 const int rc = parse_command_line_option_uint32(
5527 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5529 return fail_at(arg, rc);
5531 CommandLineSwitchCase(arg,
"orientation")
5535 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5536 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5539 return fail_at(arg, COMMAND_LINE_ERROR);
5540 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5541 return fail_at(arg, COMMAND_LINE_ERROR);
5543 CommandLineSwitchCase(arg,
"old-license")
5546 return fail_at(arg, COMMAND_LINE_ERROR);
5548 CommandLineSwitchCase(arg,
"scale")
5550 const int rc = parse_scale_options(settings, arg);
5552 return fail_at(arg, rc);
5554 CommandLineSwitchCase(arg,
"scale-desktop")
5556 const int rc = parse_command_line_option_uint32(settings, arg,
5557 FreeRDP_DesktopScaleFactor, 100, 500);
5559 return fail_at(arg, rc);
5560 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5561 return fail_at(arg, COMMAND_LINE_ERROR);
5563 CommandLineSwitchCase(arg,
"scale-device")
5565 const int rc = parse_scale_device_options(settings, arg);
5567 return fail_at(arg, rc);
5569 CommandLineSwitchCase(arg,
"action-script")
5572 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5574 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5577 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5579 CommandLineSwitchCase(arg,
"fipsmode")
5582 return fail_at(arg, COMMAND_LINE_ERROR);
5584 CommandLineSwitchCase(arg,
"smartcard-logon")
5586 const int rc = parse_smartcard_logon_options(settings, arg);
5588 return fail_at(arg, rc);
5590 CommandLineSwitchCase(arg,
"tune")
5592 const int rc = parse_tune_options(settings, arg);
5594 return fail_at(arg, rc);
5596 CommandLineSwitchDefault(arg)
5598#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5599 const int status = parse_deprecated_command_line(settings, arg);
5606 const int rc = handle_option(arg, handle_userdata);
5608 return fail_at(arg, rc);
5611 CommandLineSwitchEnd(arg)
5612 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
5619 bool insecureArgFound =
false;
5620 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5622 const char* cred = credential_args[x];
5626 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5629 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5630 insecureArgFound =
true;
5633 if (insecureArgFound)
5635 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5637 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5638 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file or file descriptor");
5639 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5640 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5645static int freerdp_client_settings_parse_command_line_arguments_int(
5646 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5648 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata,
bool isArgsFrom)
5650 char* user =
nullptr;
5653 BOOL assist = FALSE;
5655 BOOL promptForPassword = FALSE;
5656 BOOL compatibility = FALSE;
5664 ext = option_is_rdp_file(argv[1]);
5665 assist = option_is_incident_file(argv[1]);
5668 if (!ext && !assist)
5669 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5671 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5682 WLog_WARN(TAG,
"Unsupported command line syntax!");
5683 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5684 freerdp_getApplicationDetailsString());
5689 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5693 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5694 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5699 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5700 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5703 CommandLineClearArgumentsA(largs);
5704 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5705 freerdp_client_command_line_pre_filter,
5706 freerdp_client_command_line_post_filter);
5711 prepare_default_settings(settings, largs, ext);
5713 warn_credential_args(largs);
5720 return COMMAND_LINE_ERROR_MEMORY;
5722 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
5730 return COMMAND_LINE_ERROR;
5733 return COMMAND_LINE_ERROR;
5735 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
5736 return COMMAND_LINE_ERROR;
5741 return COMMAND_LINE_ERROR;
5745 if (promptForPassword)
5750 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5752 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
5753 ARRAYSIZE(buffer) - 1, 1))
5754 return COMMAND_LINE_ERROR;
5756 return COMMAND_LINE_ERROR;
5764 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5766 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
5767 ARRAYSIZE(buffer) - 1, 1))
5768 return COMMAND_LINE_ERROR;
5770 return COMMAND_LINE_ERROR;
5775 freerdp_performance_flags_make(settings);
5782 return COMMAND_LINE_ERROR;
5784 return COMMAND_LINE_ERROR;
5787 arg = CommandLineFindArgumentA(largs,
"port");
5788 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
5791 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
5793 return fail_at(arg, rc);
5799 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5800 return fail_at(arg, COMMAND_LINE_ERROR);
5803 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
5806 fill_credential_strings(largs);
5811static void argv_free(
int* pargc,
char** pargv[])
5813 WINPR_ASSERT(pargc);
5814 WINPR_ASSERT(pargv);
5815 const int argc = *pargc;
5816 char** argv = *pargv;
5822 for (
int x = 0; x < argc; x++)
5827static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
5829 WINPR_ASSERT(pargc);
5830 WINPR_ASSERT(pargv);
5838 int nargc = *pargc + 1;
5839 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
5849static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
5851 char* copy =
nullptr;
5853 copy = _strdup(what);
5855 const BOOL rc = argv_append(pargc, pargv, copy);
5861static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
5863 BOOL success = FALSE;
5865 WINPR_ASSERT(aargc);
5866 WINPR_ASSERT(aargv);
5871 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
5874 if (!argv_append_dup(aargc, aargv, cmd))
5878 char* line =
nullptr;
5880 INT64 rc = GetLine(&line, &size, fp);
5881 if ((rc < 0) || !line)
5891 const char cur = (line[rc - 1]);
5892 if ((cur ==
'\n') || (cur ==
'\r'))
5894 line[rc - 1] =
'\0';
5906 if (!argv_append(aargc, aargv, line))
5917 argv_free(aargc, aargv);
5921static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
5924 BOOL success = FALSE;
5925 char* env =
nullptr;
5927 WINPR_ASSERT(aargc);
5928 WINPR_ASSERT(aargv);
5933 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
5938 const DWORD size = GetEnvironmentVariableX(name, env, 0);
5941 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
5944 env = calloc(size + 1,
sizeof(
char));
5949 const DWORD rc = GetEnvironmentVariableX(name, env, size);
5954 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
5960 if (!argv_append_dup(aargc, aargv, cmd))
5964 char* context =
nullptr;
5965 char* tok = strtok_s(env,
"\n", &context);
5968 if (!argv_append_dup(aargc, aargv, tok))
5970 tok = strtok_s(
nullptr,
"\n", &context);
5978 argv_free(aargc, aargv);
5982int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
5983 char* oargv[], BOOL allowUnknown)
5985 return freerdp_client_settings_parse_command_line_arguments_ex(
5986 settings, oargc, oargv, allowUnknown,
nullptr, 0,
nullptr,
nullptr);
5989int freerdp_client_settings_parse_command_line_arguments_ex(
5990 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
5992 void* handle_userdata)
5995 char** argv = oargv;
5998 char** aargv =
nullptr;
6000 bool isArgsFrom =
false;
6001 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
6004 BOOL success = FALSE;
6005 const char* file = strchr(argv[1],
':') + 1;
6008 if (option_starts_with(
"fd:", file))
6010 ULONGLONG result = 0;
6011 const char* val = strchr(file,
':') + 1;
6012 if (!value_to_uint(val, &result, 0, INT_MAX))
6014 fp = fdopen((
int)result,
"r");
6015 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6017 else if (strncmp(file,
"env:", 4) == 0)
6019 const char* name = strchr(file,
':') + 1;
6020 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
6022 else if (strcmp(file,
"stdin") != 0)
6024 fp = winpr_fopen(file,
"r");
6025 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6028 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6036 WINPR_ASSERT(count <= SSIZE_MAX);
6042 res = freerdp_client_settings_parse_command_line_arguments_int(
6043 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata,
6047 argv_free(&aargc, &aargv);
6051static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
6052 const char* name,
void* data)
6054 PVIRTUALCHANNELENTRY entry =
nullptr;
6055 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
6056 name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
6057 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
6061 freerdp_load_channel_addin_entry(name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC);
6065 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
6067 WLog_DBG(TAG,
"loading channelEx %s", name);
6073 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
6075 WLog_DBG(TAG,
"loading channel %s", name);
6085 FreeRDP_Settings_Keys_Bool settingId;
6086 const char* channelName;
6090BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
6092 ChannelToLoad dynChannels[] = {
6093#if defined(CHANNEL_AINPUT_CLIENT)
6094 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME,
nullptr },
6096#ifdef CHANNEL_AUDIN_CLIENT
6097 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME,
nullptr },
6099#ifdef CHANNEL_RDPSND_CLIENT
6100 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6102#ifdef CHANNEL_RDPEI_CLIENT
6103 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME,
nullptr },
6105#ifdef CHANNEL_RDPGFX_CLIENT
6106 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME,
nullptr },
6108#ifdef CHANNEL_ECHO_CLIENT
6109 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME,
nullptr },
6111#ifdef CHANNEL_SSHAGENT_CLIENT
6112 { FreeRDP_SupportSSHAgentChannel,
"sshagent",
nullptr },
6114#ifdef CHANNEL_DISP_CLIENT
6115 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME,
nullptr },
6117#ifdef CHANNEL_GEOMETRY_CLIENT
6118 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME,
nullptr },
6120#ifdef CHANNEL_VIDEO_CLIENT
6121 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME,
nullptr },
6123#ifdef CHANNEL_RDPEAR_CLIENT
6124 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME,
nullptr },
6128 ChannelToLoad staticChannels[] = {
6129#if defined(CHANNEL_RDPSND_CLIENT)
6130 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6132#if defined(CHANNEL_CLIPRDR_CLIENT)
6133 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME,
nullptr },
6135#if defined(CHANNEL_ENCOMSP_CLIENT)
6136 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6138#if defined(CHANNEL_REMDESK_CLIENT)
6139 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6141#if defined(CHANNEL_RAIL_CLIENT)
6142 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6149 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6151 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6154 const char*
const p[] = { dynChannels[i].channelName };
6156 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6164 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6165 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6166#
if defined(CHANNEL_TSMF_CLIENT)
6167 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6177 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6193 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6201 char* value =
nullptr;
6202 char* tok =
nullptr;
6203 char* context =
nullptr;
6205 value = _strdup(DrivesToRedirect);
6209 tok = strtok_s(value,
";", &context);
6212 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6229 const char* name =
nullptr;
6230 const char* drive = tok;
6231 char* subcontext =
nullptr;
6232 char* start = strtok_s(tok,
"(", &subcontext);
6233 char* end = strtok_s(
nullptr,
")", &subcontext);
6237 if (freerdp_path_valid(name,
nullptr) && freerdp_path_valid(drive,
nullptr))
6239 success = freerdp_client_add_drive(settings, name,
nullptr);
6241 success = freerdp_client_add_drive(settings, drive,
nullptr);
6244 success = freerdp_client_add_drive(settings, drive, name);
6252 tok = strtok_s(
nullptr,
";", &context);
6261 if (!freerdp_device_collection_find(settings,
"drive"))
6263 const char*
const params[] = {
"drive",
"media",
"*" };
6265 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6282 if (!freerdp_device_collection_find(settings,
"drive"))
6284 const char* params[] = {
"drive",
"home",
"%" };
6286 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6293 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6297 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6298 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6300 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6302 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6305 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6312 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6314 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0,
nullptr);
6319 if (!freerdp_device_collection_add(settings, smartcard))
6321 freerdp_device_free(smartcard);
6329 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6331 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0,
nullptr);
6336 if (!freerdp_device_collection_add(settings, printer))
6338 freerdp_device_free(printer);
6365 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6367 if ((staticChannels[i].settingId == 0) ||
6370 if (staticChannels[i].args)
6372 if (!freerdp_client_load_static_channel_addin(
6373 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6378 const char*
const p[] = { staticChannels[i].channelName };
6379 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6389 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6390 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6399 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6401 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6413 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6421void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6423 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6424 const DWORD log_level = WLOG_WARN;
6425 wLog* log = WLog_Get(TAG);
6428 if (!WLog_IsLevelActive(log, log_level))
6431 WLog_Print_unchecked(log, log_level,
"[unmaintained] %s client is currently unmaintained!",
6433 WLog_Print_unchecked(
6435 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6437 WLog_Print_unchecked(
6439 "Be prepared to fix issues yourself though as nobody is actively working on this.");
6440 WLog_Print_unchecked(
6442 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6443 "- don't hesitate to ask some questions. (replies might take some time depending "
6444 "on your timezone) - if you intend using this component write us a message");
6447void freerdp_client_warn_experimental(
int argc,
char* argv[])
6449 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6450 const DWORD log_level = WLOG_WARN;
6451 wLog* log = WLog_Get(TAG);
6454 if (!WLog_IsLevelActive(log, log_level))
6457 WLog_Print_unchecked(log, log_level,
"[experimental] %s client is currently experimental!",
6459 WLog_Print_unchecked(
6461 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6462 "known issues or create a new one!");
6463 WLog_Print_unchecked(
6465 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6466 "- don't hesitate to ask some questions. (replies might take some time depending "
6467 "on your timezone)");
6470void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6472 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6473 const DWORD log_level = WLOG_WARN;
6474 wLog* log = WLog_Get(TAG);
6477 if (!WLog_IsLevelActive(log, log_level))
6480 WLog_Print_unchecked(log, log_level,
"[deprecated] %s client has been deprecated", app);
6481 WLog_Print_unchecked(log, log_level,
"As replacement there is a SDL3 based client available.");
6482 WLog_Print_unchecked(
6484 "If you are interested in keeping %s alive get in touch with the developers", app);
6485 WLog_Print_unchecked(
6487 "The project is hosted at https://github.com/freerdp/freerdp and "
6488 " developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6489 "- don't hesitate to ask some questions. (replies might take some time depending "
6490 "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.
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 BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL val)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val, size_t len)
Sets a string settings value. The val is copied.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
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 BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
WINPR_ATTR_NODISCARD 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 BOOL freerdp_settings_set_uint64(rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id, UINT64 val)
Sets a UINT64 settings value.
WINPR_ATTR_NODISCARD 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...
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.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint16(rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id, UINT16 val)
Sets a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val)
Sets a string settings value. The param is copied.
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.
WINPR_ATTR_NODISCARD FREERDP_API SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.