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++;
616BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
619 const char* name = freerdp_getApplicationDetailsString();
631 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
632 printf(
"See www.freerdp.com for more information\n");
634 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
637 printf(
" /flag (enables flag)\n");
638 printf(
" /option:<value> (specifies option with value)\n");
639 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
642 freerdp_client_print_command_line_args(largs, lcount);
646 printf(
"Examples:\n");
647 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
648 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
649 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
650 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
651 "/v:192.168.1.100\n",
653 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
654 printf(
"Use a generic pipe as transport:");
655 printf(
" %s /v:/path/to/pipe\n", name);
656 printf(
"Use a external socket:");
657 printf(
" %s /v:|:1234\n", name);
659 printf(
"Clipboard Redirection: +clipboard\n");
661 printf(
"Drive Redirection: /drive:home,/home/user\n");
662 printf(
"Smartcard Redirection: /smartcard:<device>\n");
663 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
665#if defined(CHANNEL_SERIAL_CLIENT)
666 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
667 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
669#if defined(CHANNEL_PARALLEL_CLIENT)
670 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
672 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
673 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
675 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
676 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
677 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
678 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
680 printf(
"Multimedia Redirection: /video\n");
681#ifdef CHANNEL_URBDRC_CLIENT
682 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
685 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
687 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
689 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
691 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
693 printf(
"More documentation is coming, in the meantime consult source files\n");
698static BOOL option_is_rdp_file(
const char* option)
700 WINPR_ASSERT(option);
702 if (option_ends_with(option,
".rdp"))
704 if (option_ends_with(option,
".rdpw"))
709static BOOL option_is_incident_file(
const char* option)
711 WINPR_ASSERT(option);
713 return (option_ends_with(option,
".msrcIncident"));
716static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
721 rdpSettings* settings =
nullptr;
726 length = strlen(argv[index]);
730 if (option_is_rdp_file(argv[index]))
732 settings = (rdpSettings*)context;
735 return COMMAND_LINE_ERROR_MEMORY;
743 if (option_is_incident_file(argv[index]))
745 settings = (rdpSettings*)context;
748 return COMMAND_LINE_ERROR_MEMORY;
758BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
759 const char*
const* params)
761 WINPR_ASSERT(settings);
762 WINPR_ASSERT(params);
763 WINPR_ASSERT(count > 0);
765 if (option_equals(params[0],
"drive"))
774 rc = freerdp_client_add_drive(settings, params[1],
nullptr);
776 rc = freerdp_client_add_drive(settings, params[2], params[1]);
780 else if (option_equals(params[0],
"printer"))
792 printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
796 if (!freerdp_device_collection_add(settings, printer))
798 freerdp_device_free(printer);
804 else if (option_equals(params[0],
"smartcard"))
816 smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
821 if (!freerdp_device_collection_add(settings, smartcard))
823 freerdp_device_free(smartcard);
829#if defined(CHANNEL_SERIAL_CLIENT)
830 else if (option_equals(params[0],
"serial"))
842 serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
847 if (!freerdp_device_collection_add(settings, serial))
849 freerdp_device_free(serial);
856 else if (option_equals(params[0],
"parallel"))
868 parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
873 if (!freerdp_device_collection_add(settings, parallel))
875 freerdp_device_free(parallel);
885BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
887 return freerdp_static_channel_collection_del(settings, name);
890BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
891 const char*
const* params)
895 if (!settings || !params || !params[0] || (count > INT_MAX))
898 if (freerdp_static_channel_collection_find(settings, params[0]))
901 _args = freerdp_addin_argv_new(count, params);
906 if (!freerdp_static_channel_collection_add(settings, _args))
911 freerdp_addin_argv_free(_args);
915BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
917 return freerdp_dynamic_channel_collection_del(settings, name);
920BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
921 const char*
const* params)
925 if (!settings || !params || !params[0] || (count > INT_MAX))
928 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
931 _args = freerdp_addin_argv_new(count, params);
936 if (!freerdp_dynamic_channel_collection_add(settings, _args))
942 freerdp_addin_argv_free(_args);
946static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
const char* file)
949 char* pem = crypto_read_pem(file, &length);
950 if (!pem || (length == 0))
964 CMDLINE_SUBOPTION_STRING,
965 CMDLINE_SUBOPTION_FILE,
966} CmdLineSubOptionType;
968typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
972 FreeRDP_Settings_Keys_String id;
973 CmdLineSubOptionType opttype;
974 WINPR_ATTR_NODISCARD CmdLineSubOptionCb cb;
977static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
982 for (
size_t xx = 0; xx < count; xx++)
984 const CmdLineSubOptions* opt = &opts[xx];
986 if (option_starts_with(opt->optname, arg))
988 const size_t optlen = strlen(opt->optname);
989 const char* val = &arg[optlen];
992 switch (opt->opttype)
994 case CMDLINE_SUBOPTION_STRING:
997 case CMDLINE_SUBOPTION_FILE:
998 status = read_pem_file(settings, opt->id, val);
1001 WLog_ERR(TAG,
"invalid subOption type");
1008 if (opt->cb && !opt->cb(val, settings))
1017 WLog_ERR(TAG,
"option %s not handled", arg);
1022#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1029 const DWORD level = WLOG_ERROR;
1030 wLog* log = WLog_Get(TAG);
1031 if (WLog_IsLevelActive(log, level))
1032 WLog_PrintTextMessage(log, level, line, file, fkt,
1033 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name,
1040 rdpSettings* settings = (rdpSettings*)context;
1041 int status = CHANNEL_RC_OK;
1042 BOOL enable = (arg->Value !=
nullptr);
1044 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1047 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1049 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1050 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1052 status = COMMAND_LINE_ERROR;
1054 CommandLineParserFree(ptr);
1056 return fail_at(arg, status);
1058 CommandLineSwitchCase(arg,
"kerberos")
1062 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1065 const CmdLineSubOptions opts[] = {
1066 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING,
nullptr },
1067 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1068 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1069 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1070 CMDLINE_SUBOPTION_STRING,
nullptr },
1071 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING,
nullptr },
1072 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING,
nullptr },
1073 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1074 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1077 for (
size_t x = 1; x < count; x++)
1079 const char* cur = ptr[x];
1080 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1082 CommandLineParserFree(ptr);
1083 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1087 CommandLineParserFree(ptr);
1090 CommandLineSwitchCase(arg,
"vc")
1093 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1094 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1095 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1096 CommandLineParserFree(ptr);
1098 return fail_at(arg, status);
1100 CommandLineSwitchCase(arg,
"dvc")
1103 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1104 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1105 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1106 CommandLineParserFree(ptr);
1108 return fail_at(arg, status);
1110 CommandLineSwitchCase(arg,
"drive")
1113 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1114 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1115 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1116 CommandLineParserFree(ptr);
1118 return fail_at(arg, status);
1120#if defined(CHANNEL_SERIAL_CLIENT)
1121 CommandLineSwitchCase(arg,
"serial")
1124 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1125 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1126 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1127 CommandLineParserFree(ptr);
1129 return fail_at(arg, status);
1132#if defined(CHANNEL_PARALLEL_CLIENT)
1133 CommandLineSwitchCase(arg,
"parallel")
1136 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1137 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1138 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1139 CommandLineParserFree(ptr);
1141 return fail_at(arg, status);
1144 CommandLineSwitchCase(arg,
"smartcard")
1147 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1148 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1149 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1150 CommandLineParserFree(ptr);
1152 return fail_at(arg, status);
1154 CommandLineSwitchCase(arg,
"printer")
1157 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1158 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1159 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1160 CommandLineParserFree(ptr);
1162 return fail_at(arg, status);
1164 CommandLineSwitchCase(arg,
"usb")
1168 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1169 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1170 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1171 CommandLineParserFree(ptr);
1173 return fail_at(arg, status);
1175 CommandLineSwitchCase(arg,
"multitouch")
1178 return fail_at(arg, COMMAND_LINE_ERROR);
1180 CommandLineSwitchCase(arg,
"gestures")
1183 return fail_at(arg, COMMAND_LINE_ERROR);
1185 CommandLineSwitchCase(arg,
"echo")
1188 return fail_at(arg, COMMAND_LINE_ERROR);
1190 CommandLineSwitchCase(arg,
"ssh-agent")
1193 return fail_at(arg, COMMAND_LINE_ERROR);
1195 CommandLineSwitchCase(arg,
"disp")
1198 return fail_at(arg, COMMAND_LINE_ERROR);
1200 CommandLineSwitchCase(arg,
"geometry")
1203 return fail_at(arg, COMMAND_LINE_ERROR);
1205 CommandLineSwitchCase(arg,
"video")
1209 return fail_at(arg, COMMAND_LINE_ERROR);
1211 return fail_at(arg, COMMAND_LINE_ERROR);
1213 CommandLineSwitchCase(arg,
"sound")
1217 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1218 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1219 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1220 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1221 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1223 CommandLineParserFree(ptr);
1225 return fail_at(arg, status);
1227 CommandLineSwitchCase(arg,
"microphone")
1230 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1231 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1232 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1233 CommandLineParserFree(ptr);
1235 return fail_at(arg, status);
1237#if defined(CHANNEL_TSMF_CLIENT)
1238 CommandLineSwitchCase(arg,
"multimedia")
1241 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1242 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1243 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1244 CommandLineParserFree(ptr);
1246 return fail_at(arg, status);
1249 CommandLineSwitchCase(arg,
"heartbeat")
1252 return fail_at(arg, COMMAND_LINE_ERROR);
1254 CommandLineSwitchCase(arg,
"multitransport")
1257 return fail_at(arg, COMMAND_LINE_ERROR);
1262 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1265 return fail_at(arg, COMMAND_LINE_ERROR);
1267 CommandLineSwitchEnd(arg)
1274 int status = freerdp_client_command_line_post_filter_int(context, arg);
1275 return status == CHANNEL_RC_OK ? 1 : -1;
1278static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1279 const char** domain,
size_t* domainlen)
1282 WINPR_ASSERT(userlen);
1283 WINPR_ASSERT(domain);
1284 WINPR_ASSERT(domainlen);
1289 const char* p = strchr(username,
'\\');
1299 const size_t length = (size_t)(p - username);
1301 *userlen = strlen(*user);
1304 *domainlen = length;
1313 *userlen = strlen(username);
1319static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1320 FreeRDP_Settings_Keys_String userID,
1321 FreeRDP_Settings_Keys_String domainID)
1323 const char* user =
nullptr;
1324 const char* domain =
nullptr;
1326 size_t domainlen = 0;
1328 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1336BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1338 const char* user =
nullptr;
1339 const char* domain =
nullptr;
1341 size_t domainlen = 0;
1346 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1352 *puser = strndup(user, userlen);
1359 *pdomain = strndup(domain, domainlen);
1371BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1374 p = strrchr(hostname,
':');
1378 size_t length = (size_t)(p - hostname);
1381 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1384 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1389 CopyMemory(*host, hostname, length);
1390 (*host)[length] =
'\0';
1391 *port = (UINT16)val;
1395 *host = _strdup(hostname);
1406static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1408 struct network_settings
1410 FreeRDP_Settings_Keys_Bool id;
1413 const struct network_settings config[] = {
1414 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1415 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1416 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1417 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1418 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1419 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1424 case CONNECTION_TYPE_INVALID:
1427 case CONNECTION_TYPE_MODEM:
1428 case CONNECTION_TYPE_BROADBAND_LOW:
1429 case CONNECTION_TYPE_BROADBAND_HIGH:
1430 case CONNECTION_TYPE_SATELLITE:
1431 case CONNECTION_TYPE_WAN:
1432 case CONNECTION_TYPE_LAN:
1433 case CONNECTION_TYPE_AUTODETECT:
1436 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1440 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1442 const struct network_settings* cur = &config[x];
1449BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1457 case CONNECTION_TYPE_INVALID:
1458 case CONNECTION_TYPE_MODEM:
1459 case CONNECTION_TYPE_BROADBAND_LOW:
1460 case CONNECTION_TYPE_SATELLITE:
1461 case CONNECTION_TYPE_BROADBAND_HIGH:
1462 case CONNECTION_TYPE_WAN:
1463 case CONNECTION_TYPE_LAN:
1464 if (!freerdp_apply_connection_type(settings, type))
1467 case CONNECTION_TYPE_AUTODETECT:
1468 if (!freerdp_apply_connection_type(settings, type))
1482 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1489static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1494 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1496 if (!layouts || (count == 0))
1499 for (
size_t x = 0; x < count; x++)
1502 if (option_equals(layout->name, name))
1510 freerdp_keyboard_layouts_free(layouts, count);
1514static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1516 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1517 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1519 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1521 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1529static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1532 WINPR_UNUSED(context);
1539 length = strlen(argv[index]);
1543 if (option_is_rdp_file(argv[index]))
1551 if (option_is_incident_file(argv[index]))
1561static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1566 int detect_status = 0;
1569 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1571 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1572 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1576 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1581 CommandLineClearArgumentsA(largs);
1582 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1583 freerdp_detect_command_line_pre_filter,
nullptr);
1592 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1596 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1598 return detect_status;
1601static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1606 int detect_status = 0;
1609 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1611 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1612 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1613 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1617 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1622 CommandLineClearArgumentsA(largs);
1623 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1624 freerdp_detect_command_line_pre_filter,
nullptr);
1633 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1637 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1639 return detect_status;
1642static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1644 size_t posix_cli_count = 0;
1645 size_t windows_cli_count = 0;
1646 const BOOL ignoreUnknown = TRUE;
1647 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1648 argc, argv, &windows_cli_count, ignoreUnknown);
1649 const int posix_cli_status =
1650 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1653 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1654 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1655 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1657 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1661 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1662 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1664 windows_cli_count = 1;
1665 *flags = COMMAND_LINE_SEPARATOR_COLON;
1666 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1669 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1670 windows_cli_count, posix_cli_status, posix_cli_count);
1671 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1673 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1679int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1682 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv,
1686static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1690 layouts = freerdp_keyboard_get_layouts(type, &count);
1692 printf(
"\n%s\n", msg);
1694 for (
size_t x = 0; x < count; x++)
1697 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1700 freerdp_keyboard_layouts_free(layouts, count);
1703static void freerdp_client_print_keyboard_list(
void)
1705 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1706 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1707 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1708 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1709 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1712static void freerdp_client_print_timezone_list(
void)
1716 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1718 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
1720 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1721 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1722 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1726static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1730 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1738 case RDP_SETTINGS_TYPE_BOOL:
1739 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1744 case RDP_SETTINGS_TYPE_UINT16:
1745 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1748 case RDP_SETTINGS_TYPE_INT16:
1749 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1752 case RDP_SETTINGS_TYPE_UINT32:
1753 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1756 case RDP_SETTINGS_TYPE_INT32:
1757 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1760 case RDP_SETTINGS_TYPE_UINT64:
1761 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1764 case RDP_SETTINGS_TYPE_INT64:
1765 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1768 case RDP_SETTINGS_TYPE_STRING:
1769 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1774 case RDP_SETTINGS_TYPE_POINTER:
1775 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1787int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
1788 int argc,
char** argv,
1793 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1795 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
1797 freerdp_client_print_version();
1801 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
1803 freerdp_client_print_version_ex(argc, argv);
1804 freerdp_client_print_buildconfig_ex(argc, argv);
1807 else if (status == COMMAND_LINE_STATUS_PRINT)
1809 (void)CommandLineParseArgumentsA(argc, argv, largs, 0x112,
nullptr,
nullptr,
nullptr);
1811 arg = CommandLineFindArgumentA(largs,
"list");
1814 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1816 if (option_equals(
"timezones", arg->Value))
1817 freerdp_client_print_timezone_list();
1818 else if (option_equals(
"tune", arg->Value))
1819 freerdp_client_print_tune_list(settings);
1820 else if (option_equals(
"kbd", arg->Value))
1821 freerdp_client_print_keyboard_list();
1822 else if (option_starts_with(
"kbd-lang", arg->Value))
1824 const char* val =
nullptr;
1825 if (option_starts_with(
"kbd-lang:", arg->Value))
1826 val = &arg->Value[9];
1827 else if (!option_equals(
"kbd-lang", arg->Value))
1828 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1830 if (val && strchr(val,
','))
1831 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1832 freerdp_client_print_codepages(val);
1834 else if (option_equals(
"kbd-scancode", arg->Value))
1835 freerdp_client_print_scancodes();
1836 else if (option_equals(
"monitor", arg->Value))
1839 return COMMAND_LINE_ERROR;
1841 else if (option_starts_with(
"smartcard", arg->Value))
1844 if (option_starts_with(
"smartcard:", arg->Value))
1846 else if (!option_equals(
"smartcard", arg->Value))
1847 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1851 const char* sub = strchr(arg->Value,
':') + 1;
1852 const CmdLineSubOptions options[] = { {
"pkinit-anchors:",
1853 FreeRDP_PkinitAnchors,
1854 CMDLINE_SUBOPTION_STRING,
nullptr },
1855 {
"pkcs11-module:", FreeRDP_Pkcs11Module,
1856 CMDLINE_SUBOPTION_STRING,
nullptr } };
1860 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1862 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1865 CommandLineParserFree(ptr);
1866 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1869 for (
size_t x = 1; x < count; x++)
1871 const char* cur = ptr[x];
1872 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1874 CommandLineParserFree(ptr);
1875 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1879 CommandLineParserFree(ptr);
1882 freerdp_smartcard_list(settings);
1886 freerdp_client_print_command_line_help_ex(argc, argv, custom);
1887 return COMMAND_LINE_ERROR;
1890#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1891 arg = CommandLineFindArgumentA(largs,
"tune-list");
1894 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1896 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
1897 freerdp_client_print_tune_list(settings);
1900 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
1903 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1905 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
1906 freerdp_client_print_codepages(arg->Value);
1909 arg = CommandLineFindArgumentA(largs,
"kbd-list");
1912 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1914 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
1915 freerdp_client_print_keyboard_list();
1918 arg = CommandLineFindArgumentA(largs,
"monitor-list");
1921 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1923 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
1925 return COMMAND_LINE_ERROR;
1928 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
1931 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1933 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
1934 freerdp_smartcard_list(settings);
1937 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
1940 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1943 "Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
1944 freerdp_client_print_scancodes();
1950 else if (status < 0)
1952 freerdp_client_print_command_line_help_ex(argc, argv, custom);
1957 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
1970static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
1972 const char* xcharpos =
nullptr;
1973 char* endPtr =
nullptr;
1974 unsigned long v = 0;
1976 v = strtoul(input, &endPtr, 10);
1978 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
1984 xcharpos = strchr(input,
'x');
1986 if (!xcharpos || xcharpos != endPtr)
1990 v = strtoul(xcharpos + 1, &endPtr, 10);
1992 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
1995 if (*endPtr !=
'\0')
2007 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2008 WINPR_ASSERT(settings);
2014 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2016 const char* arg = arguments[x];
2018 if (p && (p->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
2022 return freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT);
2025static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2030const char* option_starts_with(
const char* what,
const char* val)
2034 const size_t wlen = strlen(what);
2036 if (_strnicmp(what, val, wlen) != 0)
2041BOOL option_ends_with(
const char* str,
const char* ext)
2045 const size_t strLen = strlen(str);
2046 const size_t extLen = strlen(ext);
2048 if (strLen < extLen)
2051 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2054BOOL option_equals(
const char* what,
const char* val)
2058 return _stricmp(what, val) == 0;
2067} PARSE_ON_OFF_RESULT;
2069static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2071 WINPR_ASSERT(value);
2072 const char* sep = strchr(value,
':');
2075 if (option_equals(
"on", &sep[1]))
2077 if (option_equals(
"off", &sep[1]))
2086 CLIP_DIR_PARSE_LOCAL,
2087 CLIP_DIR_PARSE_REMOTE,
2089} PARSE_CLIP_DIR_RESULT;
2091static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2093 WINPR_ASSERT(value);
2094 const char* sep = strchr(value,
':');
2096 return CLIP_DIR_PARSE_FAIL;
2097 if (option_equals(
"all", &sep[1]))
2098 return CLIP_DIR_PARSE_ALL;
2099 if (option_equals(
"off", &sep[1]))
2100 return CLIP_DIR_PARSE_OFF;
2101 if (option_equals(
"local", &sep[1]))
2102 return CLIP_DIR_PARSE_LOCAL;
2103 if (option_equals(
"remote", &sep[1]))
2104 return CLIP_DIR_PARSE_REMOTE;
2105 return CLIP_DIR_PARSE_FAIL;
2108static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2110 const char* ciphers =
nullptr;
2112 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2114 if (option_equals(Value,
"netmon"))
2116 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2118 else if (option_equals(Value,
"ma"))
2120 ciphers =
"AES128-SHA";
2128 return COMMAND_LINE_ERROR_MEMORY;
2132static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2136 if (!value_to_int(Value, &val, 0, 5))
2137 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2140 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2144static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2147 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2150 return COMMAND_LINE_ERROR_MEMORY;
2154static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2156 UINT16 version = TLS1_2_VERSION;
2165 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2166 {
"1.1", TLS1_1_VERSION },
2167 {
"1.2", TLS1_2_VERSION }
2168#if defined(TLS1_3_VERSION)
2170 {
"1.3", TLS1_3_VERSION }
2174 const struct map_t* found =
nullptr;
2175 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2177 const struct map_t* cur = &map[x];
2178 if (option_equals(cur->name, Value))
2186 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2187 version = found->version;
2192 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2198 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2199 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2201 if (option_starts_with(
"ciphers:", arg->Value))
2202 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2203 else if (option_starts_with(
"seclevel:", arg->Value))
2204 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2205 else if (option_starts_with(
"secrets-file:", arg->Value))
2206 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2207 else if (option_starts_with(
"enforce:", arg->Value))
2208 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2211#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2212 CommandLineSwitchCase(arg,
"tls-ciphers")
2214 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2215 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2217 CommandLineSwitchCase(arg,
"tls-seclevel")
2219 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2220 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2222 CommandLineSwitchCase(arg,
"tls-secrets-file")
2224 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2225 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2227 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2229 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2230 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2233 CommandLineSwitchDefault(arg)
2236 CommandLineSwitchEnd(arg)
2243 WINPR_ASSERT(settings);
2247 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2248 for (
size_t x = 0; x < count; x++)
2251 larg.Value = ptr[x];
2253 int rc = parse_tls_cipher_options(settings, &larg);
2256 CommandLineParserFree(ptr);
2260 CommandLineParserFree(ptr);
2266 WINPR_ASSERT(settings);
2270 return COMMAND_LINE_ERROR;
2274 int rc = CHANNEL_RC_OK;
2276 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2277 if (!ptr || (count == 0))
2278 rc = COMMAND_LINE_ERROR;
2281 BOOL GfxH264 = FALSE;
2282 BOOL GfxAVC444 = FALSE;
2283 BOOL RemoteFxCodec = FALSE;
2284 BOOL GfxProgressive = FALSE;
2285 BOOL codecSelected = FALSE;
2287 for (
size_t x = 0; x < count; x++)
2289 const char* val = ptr[x];
2291 if (option_starts_with(
"AVC444", val))
2293 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2294 if (bval == PARSE_FAIL)
2295 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2297 GfxAVC444 = bval != PARSE_OFF;
2298 codecSelected = TRUE;
2300 else if (option_starts_with(
"AVC420", val))
2302 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2303 if (bval == PARSE_FAIL)
2304 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2306 GfxH264 = bval != PARSE_OFF;
2307 codecSelected = TRUE;
2311 if (option_starts_with(
"RFX", val))
2313 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2314 if (bval == PARSE_FAIL)
2315 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2317 RemoteFxCodec = bval != PARSE_OFF;
2318 codecSelected = TRUE;
2320 else if (option_starts_with(
"progressive", val))
2322 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2323 if (bval == PARSE_FAIL)
2324 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2326 GfxProgressive = bval != PARSE_OFF;
2327 codecSelected = TRUE;
2329 else if (option_starts_with(
"mask:", val))
2332 const char* uv = &val[5];
2333 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2334 rc = COMMAND_LINE_ERROR;
2339 rc = COMMAND_LINE_ERROR;
2342 else if (option_starts_with(
"small-cache", val))
2344 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2345 if (bval == PARSE_FAIL)
2346 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2349 rc = COMMAND_LINE_ERROR;
2351 else if (option_starts_with(
"thin-client", val))
2353 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2354 if (bval == PARSE_FAIL)
2355 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2358 rc = COMMAND_LINE_ERROR;
2359 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2363 rc = COMMAND_LINE_ERROR;
2366 else if (option_starts_with(
"frame-ack", 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;
2373 rc = COMMAND_LINE_ERROR;
2376 rc = COMMAND_LINE_ERROR;
2379 if ((rc == CHANNEL_RC_OK) && codecSelected)
2382 rc = COMMAND_LINE_ERROR;
2384 rc = COMMAND_LINE_ERROR;
2386 rc = COMMAND_LINE_ERROR;
2388 rc = COMMAND_LINE_ERROR;
2390 rc = COMMAND_LINE_ERROR;
2393 CommandLineParserFree(ptr);
2394 if (rc != CHANNEL_RC_OK)
2397 return CHANNEL_RC_OK;
2400static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2402 WINPR_ASSERT(settings);
2403 WINPR_ASSERT(value);
2407 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2410 ival = freerdp_map_keyboard_layout_name_to_id(value);
2414 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2415 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2416 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2423 rc = COMMAND_LINE_ERROR;
2428#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2431 WINPR_ASSERT(settings);
2435 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2437 return COMMAND_LINE_ERROR;
2439 if (option_equals(arg->Value,
"rfx"))
2442 return COMMAND_LINE_ERROR;
2444 else if (option_equals(arg->Value,
"nsc"))
2447 return COMMAND_LINE_ERROR;
2450#if defined(WITH_JPEG)
2451 else if (option_equals(arg->Value,
"jpeg"))
2454 return COMMAND_LINE_ERROR;
2459 return COMMAND_LINE_ERROR;
2468static BOOL check_kbd_remap_valid(
const char* token)
2473 WINPR_ASSERT(token);
2475 if (strlen(token) > 10)
2478 if (!freerdp_extract_key_value(token, &key, &value))
2480 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2488 WINPR_ASSERT(settings);
2492 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2494 return COMMAND_LINE_ERROR_MEMORY;
2495 char* p = strchr(arg->Value,
'[');
2500 const char scheme[] =
"://";
2501 const char* val = strstr(arg->Value, scheme);
2503 val += strnlen(scheme,
sizeof(scheme));
2506 p = strchr(val,
':');
2513 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2514 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2516 length = (size_t)(p - arg->Value);
2518 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2521 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2526 return COMMAND_LINE_ERROR_MEMORY;
2532 char* p2 = strchr(arg->Value,
']');
2536 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2538 length = (size_t)(p2 - p);
2540 return COMMAND_LINE_ERROR_MEMORY;
2542 if (*(p2 + 1) ==
':')
2546 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2547 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2550 return COMMAND_LINE_ERROR;
2553 printf(
"hostname %s port %" PRIu32
"\n",
2562 WINPR_ASSERT(settings);
2566 char* cur = arg->Value;
2568 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2570 return COMMAND_LINE_ERROR;
2576 char* next = strchr(cur,
',');
2584 if (option_equals(
"fqdn", cur))
2586 else if (option_equals(
"ip", cur))
2588 else if (option_equals(
"netbios", cur))
2591 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2594 mask = (mask & 0x07);
2595 value |= mask << (count * 3);
2597 }
while (cur !=
nullptr);
2600 return COMMAND_LINE_ERROR;
2603 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2607static int parse_prevent_session_lock_options(rdpSettings* settings,
2610 WINPR_ASSERT(settings);
2614 return COMMAND_LINE_ERROR_MEMORY;
2616 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2620 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2621 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2624 return COMMAND_LINE_ERROR_MEMORY;
2632 WINPR_ASSERT(settings);
2636 return COMMAND_LINE_ERROR;
2643 return COMMAND_LINE_ERROR;
2645 return COMMAND_LINE_ERROR;
2647 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2650 return COMMAND_LINE_ERROR;
2653 return COMMAND_LINE_ERROR_MEMORY;
2661 WINPR_ASSERT(settings);
2665 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2666 char* p = strchr(arg->Value,
'x');
2670 unsigned long w = 0;
2671 unsigned long h = 0;
2673 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2674 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2677 return COMMAND_LINE_ERROR;
2679 return COMMAND_LINE_ERROR;
2683 char* str = _strdup(arg->Value);
2685 return COMMAND_LINE_ERROR_MEMORY;
2687 p = strchr(str,
'%');
2691 BOOL partial = FALSE;
2693 status = COMMAND_LINE_ERROR;
2720 if (!value_to_int(str, &val, 0, 100))
2722 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2742 WINPR_ASSERT(settings);
2745 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2748 UINT32* MonitorIds =
nullptr;
2749 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2752 return COMMAND_LINE_ERROR_MEMORY;
2759 CommandLineParserFree(ptr);
2763 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
2764 for (UINT32 i = 0; i < count; i++)
2768 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
2769 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2771 MonitorIds[i] = (UINT32)val;
2774 CommandLineParserFree(ptr);
2780static int parse_dynamic_resolution_options(rdpSettings* settings,
2783 WINPR_ASSERT(settings);
2786 const BOOL val = arg->Value !=
nullptr;
2790 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2791 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2795 return COMMAND_LINE_ERROR;
2797 return COMMAND_LINE_ERROR;
2804 WINPR_ASSERT(settings);
2809 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2810 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2814 return COMMAND_LINE_ERROR;
2818 unsigned long w = 0;
2819 unsigned long h = 0;
2821 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2822 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2825 return COMMAND_LINE_ERROR;
2827 return COMMAND_LINE_ERROR;
2834 WINPR_ASSERT(settings);
2839 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
2840 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2850 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2854 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2861 WINPR_ASSERT(settings);
2864 int rc = CHANNEL_RC_OK;
2866 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2867 if (!ptr || (count == 0))
2868 rc = COMMAND_LINE_ERROR;
2871 for (
size_t x = 0; x < count; x++)
2873 const char* val = ptr[x];
2875 if (option_starts_with(
"remap:", val))
2878 char* now = _strdup(&val[6]);
2883 if (!check_kbd_remap_valid(now))
2884 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2887 const size_t olen = strlen(old);
2888 const size_t alen = strlen(now);
2889 const size_t tlen = olen + alen + 2;
2890 char* tmp = calloc(tlen,
sizeof(
char));
2892 rc = COMMAND_LINE_ERROR_MEMORY;
2894 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
2902 rc = COMMAND_LINE_ERROR;
2906 else if (option_starts_with(
"layout:", val))
2908 rc = parse_kbd_layout(settings, &val[7]);
2910 else if (option_starts_with(
"lang:", val))
2913 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
2915 ival = freerdp_get_locale_id_from_string(&val[5]);
2918 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2921 rc = COMMAND_LINE_ERROR;
2923 else if (option_starts_with(
"type:", val))
2926 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
2928 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2930 rc = COMMAND_LINE_ERROR;
2932 else if (option_starts_with(
"subtype:", val))
2935 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
2937 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2940 rc = COMMAND_LINE_ERROR;
2942 else if (option_starts_with(
"fn-key:", val))
2945 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
2947 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2950 rc = COMMAND_LINE_ERROR;
2952 else if (option_starts_with(
"unicode", val))
2954 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2955 if (bval == PARSE_FAIL)
2956 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2959 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2961 else if (option_starts_with(
"pipe:", val))
2964 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2966 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2968#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2969 else if (count == 1)
2972 rc = parse_kbd_layout(settings, val);
2976 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2982 CommandLineParserFree(ptr);
2988 WINPR_ASSERT(settings);
2993 return COMMAND_LINE_ERROR_MEMORY;
2995 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2997 const char* cur = arg->Value;
3000 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3002 if (!proxy_parse_uri(settings, cur))
3003 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3007 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3008 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3015 WINPR_ASSERT(settings);
3018 BOOL failed = FALSE;
3020 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3025 BOOL modernsyntax = FALSE;
3026 BOOL oldsyntax = FALSE;
3027 for (
size_t x = 0; (x < count) && !failed; x++)
3029 const char* carg = ptr[x];
3030 if (option_starts_with(
"file:", carg))
3032 const char* val = &carg[5];
3037 modernsyntax = TRUE;
3039 else if (option_equals(
"replay", carg))
3046 else if (option_equals(
"record", carg))
3053 else if (option_equals(
"nodelay", carg))
3060 modernsyntax = TRUE;
3075 if (oldsyntax && (count != 2))
3078 CommandLineParserFree(ptr);
3080 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3086 WINPR_ASSERT(settings);
3089 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3092 (arg->Value == BoolValueTrue)))
3093 return COMMAND_LINE_ERROR;
3099 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3100 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3102 const char* usesel =
"use-selection:";
3104 const char* cur = ptr[x];
3105 if (option_starts_with(usesel, cur))
3107 const char* val = &cur[strlen(usesel)];
3109 rc = COMMAND_LINE_ERROR_MEMORY;
3111 return COMMAND_LINE_ERROR;
3113 else if (option_starts_with(
"direction-to", cur))
3117 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3118 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3122 case CLIP_DIR_PARSE_ALL:
3123 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3125 case CLIP_DIR_PARSE_LOCAL:
3126 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3128 case CLIP_DIR_PARSE_REMOTE:
3129 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3131 case CLIP_DIR_PARSE_OFF:
3133 case CLIP_DIR_PARSE_FAIL:
3135 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3141 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3143 else if (option_starts_with(
"files-to", cur))
3147 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3148 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3149 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3153 case CLIP_DIR_PARSE_ALL:
3155 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3157 case CLIP_DIR_PARSE_LOCAL:
3158 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3160 case CLIP_DIR_PARSE_REMOTE:
3161 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3163 case CLIP_DIR_PARSE_OFF:
3165 case CLIP_DIR_PARSE_FAIL:
3167 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3173 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3176 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3178 CommandLineParserFree(ptr);
3188 WINPR_ASSERT(settings);
3193 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3194 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3198 case AUDIO_MODE_REDIRECT:
3200 return COMMAND_LINE_ERROR;
3203 case AUDIO_MODE_PLAY_ON_SERVER:
3205 return COMMAND_LINE_ERROR;
3208 case AUDIO_MODE_NONE:
3210 return COMMAND_LINE_ERROR;
3212 return COMMAND_LINE_ERROR;
3216 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3223 WINPR_ASSERT(settings);
3226 UINT32 type = CONNECTION_TYPE_INVALID;
3228 if (option_equals(arg->Value,
"invalid"))
3229 type = CONNECTION_TYPE_INVALID;
3230 else if (option_equals(arg->Value,
"modem"))
3231 type = CONNECTION_TYPE_MODEM;
3232 else if (option_equals(arg->Value,
"broadband"))
3233 type = CONNECTION_TYPE_BROADBAND_HIGH;
3234 else if (option_equals(arg->Value,
"broadband-low"))
3235 type = CONNECTION_TYPE_BROADBAND_LOW;
3236 else if (option_equals(arg->Value,
"broadband-high"))
3237 type = CONNECTION_TYPE_BROADBAND_HIGH;
3238 else if (option_equals(arg->Value,
"wan"))
3239 type = CONNECTION_TYPE_WAN;
3240 else if (option_equals(arg->Value,
"lan"))
3241 type = CONNECTION_TYPE_LAN;
3242 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3243 (option_equals(arg->Value,
"detect")))
3245 type = CONNECTION_TYPE_AUTODETECT;
3251 if (!value_to_int(arg->Value, &val, 0, 7))
3252 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3257 if (!freerdp_set_connection_type(settings, type))
3258 return COMMAND_LINE_ERROR;
3264 WINPR_ASSERT(settings);
3268 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3270 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3272 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3273 for (
size_t x = 0; x < count; x++)
3275 const char* cur = ptr[x];
3276 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3277 if (bval == PARSE_FAIL)
3279 CommandLineParserFree(ptr);
3280 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3283 const BOOL val = bval != PARSE_OFF;
3284 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3285 if (option_starts_with(
"rdp", cur))
3287 id = FreeRDP_RdpSecurity;
3289 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3291 else if (option_starts_with(
"tls", cur))
3292 id = FreeRDP_TlsSecurity;
3293 else if (option_starts_with(
"nla", cur))
3294 id = FreeRDP_NlaSecurity;
3295 else if (option_starts_with(
"ext", cur))
3296 id = FreeRDP_ExtSecurity;
3297 else if (option_equals(
"aad", cur))
3298 id = FreeRDP_AadSecurity;
3301 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3302 CommandLineParserFree(ptr);
3303 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3306 if ((bval == PARSE_NONE) && (count == 1))
3307 singleOptionWithoutOnOff = id;
3309 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3312 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3314 const FreeRDP_Settings_Keys_Bool options[] = { FreeRDP_AadSecurity,
3315 FreeRDP_UseRdpSecurityLayer,
3316 FreeRDP_RdpSecurity, FreeRDP_NlaSecurity,
3317 FreeRDP_TlsSecurity };
3319 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3322 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3326 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3327 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3330 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3333 CommandLineParserFree(ptr);
3337static int parse_encryption_methods_options(rdpSettings* settings,
3340 WINPR_ASSERT(settings);
3343 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3346 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3348 UINT32 EncryptionMethods = 0;
3349 for (UINT32 i = 0; i < count; i++)
3351 if (option_equals(ptr[i],
"40"))
3352 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3353 else if (option_equals(ptr[i],
"56"))
3354 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3355 else if (option_equals(ptr[i],
"128"))
3356 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3357 else if (option_equals(ptr[i],
"FIPS"))
3358 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3360 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3364 return COMMAND_LINE_ERROR;
3365 CommandLineParserFree(ptr);
3372 WINPR_ASSERT(settings);
3377 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3378 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3380 const char deny[] =
"deny";
3381 const char ignore[] =
"ignore";
3382 const char tofu[] =
"tofu";
3383 const char name[] =
"name:";
3384 const char fingerprints[] =
"fingerprint:";
3386 const char* cur = ptr[x];
3387 if (option_equals(deny, cur))
3390 return COMMAND_LINE_ERROR;
3392 else if (option_equals(ignore, cur))
3395 return COMMAND_LINE_ERROR;
3397 else if (option_equals(tofu, cur))
3400 return COMMAND_LINE_ERROR;
3402 else if (option_starts_with(name, cur))
3404 const char* val = &cur[strnlen(name,
sizeof(name))];
3406 rc = COMMAND_LINE_ERROR_MEMORY;
3408 else if (option_starts_with(fingerprints, cur))
3410 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3413 rc = COMMAND_LINE_ERROR_MEMORY;
3416 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3418 CommandLineParserFree(ptr);
3425 WINPR_ASSERT(settings);
3429 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3433 for (
size_t x = 1; x < count; x++)
3435 const char* cur = ptr[x];
3437 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3438 if (bval == PARSE_FAIL)
3439 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3442 const BOOL val = bval != PARSE_OFF;
3444 if (option_starts_with(
"relative", cur))
3447 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3449 else if (option_starts_with(
"grab", cur))
3452 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3460 CommandLineParserFree(ptr);
3467 WINPR_ASSERT(settings);
3471 UINT32 Floatbar = 0x0017;
3475 char* start = arg->Value;
3480 start = strchr(start,
',');
3489 if (option_starts_with(
"sticky:", cur))
3493 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3505 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3509 else if (option_starts_with(
"default:", cur))
3511 const char* val = cur + 8;
3514 if (option_equals(
"visible", val))
3516 else if (option_equals(
"hidden", val))
3519 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3522 else if (option_starts_with(
"show:", cur))
3524 const char* val = cur + 5;
3527 if (option_equals(
"always", val))
3529 else if (option_equals(
"fullscreen", val))
3531 else if (option_equals(
"window", val))
3534 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3537 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3541 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3547 WINPR_ASSERT(settings);
3550 BYTE* base64 =
nullptr;
3553 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3555 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3561 return COMMAND_LINE_ERROR;
3565 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3572static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3574 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3582 WINPR_ASSERT(settings);
3587 if (!value_to_int(arg->Value, &val, 100, 180))
3588 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3596 return COMMAND_LINE_ERROR;
3598 return COMMAND_LINE_ERROR;
3599 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3600 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3601 return fail_at(arg, COMMAND_LINE_ERROR);
3605 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3612 WINPR_ASSERT(settings);
3617 if (!value_to_int(arg->Value, &val, 100, 180))
3618 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3626 return COMMAND_LINE_ERROR;
3627 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3628 return fail_at(arg, COMMAND_LINE_ERROR);
3632 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3639 WINPR_ASSERT(settings);
3645 return COMMAND_LINE_ERROR;
3647 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3650 const CmdLineSubOptions opts[] = {
3651 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3652 setSmartcardEmulation },
3653 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3654 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING,
nullptr },
3655 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING,
nullptr },
3656 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING,
nullptr },
3657 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING,
nullptr },
3658 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING,
nullptr }
3661 for (
size_t x = 1; x < count; x++)
3663 const char* cur = ptr[x];
3664 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
3666 CommandLineParserFree(ptr);
3667 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3671 CommandLineParserFree(ptr);
3677 WINPR_ASSERT(settings);
3681 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
3683 return COMMAND_LINE_ERROR;
3684 for (
size_t x = 1; x < count; x++)
3686 const char* cur = ptr[x];
3687 char* sep = strchr(cur,
':');
3690 CommandLineParserFree(ptr);
3691 return COMMAND_LINE_ERROR;
3694 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
3696 CommandLineParserFree(ptr);
3697 return COMMAND_LINE_ERROR;
3701 CommandLineParserFree(ptr);
3705static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
3707 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
3708 FreeRDP_RemoteAppLanguageBarSupported,
3709 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
3710 FreeRDP_DisableFullWindowDrag };
3713 return COMMAND_LINE_ERROR_MEMORY;
3715 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
3718 return COMMAND_LINE_ERROR;
3720 return CHANNEL_RC_OK;
3725 WINPR_ASSERT(settings);
3728 int rc = CHANNEL_RC_OK;
3730 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3731 if (!ptr || (count == 0))
3732 rc = COMMAND_LINE_ERROR;
3739 int (*fkt)(rdpSettings* settings,
const char* value);
3741 const struct app_map amap[] = {
3742 {
"tenantid:", FreeRDP_GatewayAvdAadtenantid,
nullptr },
3743 {
"ad:", FreeRDP_GatewayAzureActiveDirectory,
nullptr },
3744 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat,
nullptr },
3745 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat,
nullptr },
3746 {
"avd-scope:", FreeRDP_GatewayAvdScope,
nullptr }
3749 for (
size_t x = 0; x < count; x++)
3751 BOOL handled = FALSE;
3752 const char* val = ptr[x];
3754 if (option_starts_with(
"use-tenantid", val))
3756 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3757 if (bval == PARSE_FAIL)
3759 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3767 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3773 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3775 const struct app_map* cur = &amap[y];
3776 if (option_starts_with(cur->name, val))
3778 const char* xval = &val[strlen(cur->name)];
3780 rc = cur->fkt(settings, xval);
3784 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3785 rc = COMMAND_LINE_ERROR_MEMORY;
3794 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3801 CommandLineParserFree(ptr);
3807 WINPR_ASSERT(settings);
3810 int rc = CHANNEL_RC_OK;
3812 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3813 if (!ptr || (count == 0))
3814 rc = COMMAND_LINE_ERROR;
3821 int (*fkt)(rdpSettings* settings,
const char* value);
3823 const struct app_map amap[] = {
3824 {
"program:", FreeRDP_RemoteApplicationProgram, parse_app_option_program },
3825 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir,
nullptr },
3826 {
"name:", FreeRDP_RemoteApplicationName,
nullptr },
3827 {
"icon:", FreeRDP_RemoteApplicationIcon,
nullptr },
3828 {
"cmd:", FreeRDP_RemoteApplicationCmdLine,
nullptr },
3829 {
"file:", FreeRDP_RemoteApplicationFile,
nullptr },
3830 {
"guid:", FreeRDP_RemoteApplicationGuid,
nullptr },
3831 {
"hidef:", FreeRDP_HiDefRemoteApp,
nullptr }
3833 for (
size_t x = 0; x < count; x++)
3835 BOOL handled = FALSE;
3836 const char* val = ptr[x];
3838 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3840 const struct app_map* cur = &amap[y];
3841 if (option_starts_with(cur->name, val))
3843 const char* xval = &val[strlen(cur->name)];
3845 rc = cur->fkt(settings, xval);
3849 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3850 rc = COMMAND_LINE_ERROR_MEMORY;
3858#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3859 if (!handled && (count == 1))
3862 rc = parse_app_option_program(settings, val);
3867 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3874 CommandLineParserFree(ptr);
3880 WINPR_ASSERT(settings);
3883 int rc = CHANNEL_RC_OK;
3885 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3886 if (!ptr || (count == 0))
3887 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3889 for (
size_t x = 0; x < count; x++)
3891 const char* val = ptr[x];
3893 if (option_starts_with(
"codec:", val))
3896 rc = COMMAND_LINE_ERROR;
3897 else if (option_equals(arg->Value,
"rfx"))
3900 rc = COMMAND_LINE_ERROR;
3902 else if (option_equals(arg->Value,
"nsc"))
3905 rc = COMMAND_LINE_ERROR;
3908#if defined(WITH_JPEG)
3909 else if (option_equals(arg->Value,
"jpeg"))
3912 rc = COMMAND_LINE_ERROR;
3917 return COMMAND_LINE_ERROR;
3923 else if (option_starts_with(
"persist-file:", val))
3927 rc = COMMAND_LINE_ERROR_MEMORY;
3929 rc = COMMAND_LINE_ERROR;
3933 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3934 if (bval == PARSE_FAIL)
3935 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3938 if (option_starts_with(
"bitmap", val))
3942 rc = COMMAND_LINE_ERROR;
3944 else if (option_starts_with(
"glyph", val))
3947 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
3948 : GLYPH_SUPPORT_NONE))
3949 rc = COMMAND_LINE_ERROR;
3951 else if (option_starts_with(
"persist", val))
3955 rc = COMMAND_LINE_ERROR;
3957 else if (option_starts_with(
"offscreen", val))
3961 rc = COMMAND_LINE_ERROR;
3967 CommandLineParserFree(ptr);
3971static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
3973 WINPR_ASSERT(settings);
3976 char* name =
nullptr;
3978 if (!freerdp_parse_hostname(host, &name, &port))
3997static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
3998 FreeRDP_Settings_Keys_String what)
4000 WINPR_ASSERT(settings);
4001 WINPR_ASSERT(value);
4005 case FreeRDP_GatewayUsername:
4006 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4007 FreeRDP_GatewayDomain))
4019static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4023 WINPR_ASSERT(settings);
4024 WINPR_ASSERT(value);
4026 if (option_equals(value,
"rpc"))
4037 if (option_equals(value,
"http"))
4045 else if (option_equals(value,
"auto"))
4053 else if (option_equals(value,
"arm"))
4066static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4070 WINPR_ASSERT(settings);
4071 WINPR_ASSERT(value);
4073 if (option_equals(value,
"none"))
4074 type = TSC_PROXY_MODE_NONE_DIRECT;
4075 else if (option_equals(value,
"direct"))
4076 type = TSC_PROXY_MODE_DIRECT;
4077 else if (option_equals(value,
"detect"))
4078 type = TSC_PROXY_MODE_DETECT;
4079 else if (option_equals(value,
"default"))
4080 type = TSC_PROXY_MODE_DEFAULT;
4085 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4092static char* unescape(
const char* str)
4094 char* copy = _strdup(str);
4098 bool escaped =
false;
4100 while (*str !=
'\0')
4128 char* argval =
nullptr;
4131 WINPR_ASSERT(settings);
4135 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4144 BOOL allowHttpOpts = FALSE;
4145 for (
size_t x = 0; x < count; x++)
4147 BOOL validOption = FALSE;
4149 argval = unescape(ptr[x]);
4153 const char* gw = option_starts_with(
"g:", argval);
4156 if (!parse_gateway_host_option(settings, gw))
4159 allowHttpOpts = FALSE;
4162 const char* gu = option_starts_with(
"u:", argval);
4165 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4168 allowHttpOpts = FALSE;
4171 const char* gd = option_starts_with(
"d:", argval);
4174 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4177 allowHttpOpts = FALSE;
4180 const char* gp = option_starts_with(
"p:", argval);
4183 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4186 allowHttpOpts = FALSE;
4189 const char* gt = option_starts_with(
"type:", argval);
4192 if (!parse_gateway_type_option(settings, gt))
4198 const char* gat = option_starts_with(
"access-token:", argval);
4204 allowHttpOpts = FALSE;
4207 const char* bearer = option_starts_with(
"bearer:", argval);
4214 allowHttpOpts = FALSE;
4217 const char* gwurl = option_starts_with(
"url:", argval);
4225 allowHttpOpts = FALSE;
4228 const char* um = option_starts_with(
"usage-method:", argval);
4231 if (!parse_gateway_usage_option(settings, um))
4234 allowHttpOpts = FALSE;
4239 if (option_equals(argval,
"no-websockets"))
4246 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4263 CommandLineParserFree(ptr);
4270 WINPR_ASSERT(value);
4276 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4277 FillMemory(arg->Value, strlen(arg->Value),
'*');
4282 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4284 const char* cred = credential_args[x];
4285 fill_credential_string(args, cred);
4289 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4291 const char* gwcreds[] = {
"p:",
"access-token:" };
4292 char* saveptr =
nullptr;
4293 char* tok = strtok_s(arg->Value,
",", &saveptr);
4296 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4298 const char* opt = gwcreds[x];
4299 if (option_starts_with(opt, tok))
4301 char* val = &tok[strlen(opt)];
4302 FillMemory(val, strlen(val),
'*');
4305 tok = strtok_s(
nullptr,
",", &saveptr);
4310static int parse_command_line_option_uint32(rdpSettings* settings,
4312 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4317 if (!value_to_int(arg->Value, &val, min, max))
4318 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4321 return fail_at(arg, COMMAND_LINE_ERROR);
4325#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4330 WINPR_ASSERT(settings);
4333 BOOL enable = arg->Value ? TRUE : FALSE;
4334 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4336 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4338 return fail_at(arg, COMMAND_LINE_ERROR);
4343 return fail_at(arg, COMMAND_LINE_ERROR);
4347 return fail_at(arg, COMMAND_LINE_ERROR);
4349 CommandLineSwitchCase(arg,
"gfx-small-cache")
4351 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4353 return fail_at(arg, COMMAND_LINE_ERROR);
4357 return fail_at(arg, COMMAND_LINE_ERROR);
4359 CommandLineSwitchCase(arg,
"gfx-progressive")
4361 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4363 return fail_at(arg, COMMAND_LINE_ERROR);
4365 return fail_at(arg, COMMAND_LINE_ERROR);
4370 return fail_at(arg, COMMAND_LINE_ERROR);
4374 CommandLineSwitchCase(arg,
"gfx-h264")
4376 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4377 int rc = parse_gfx_options(settings, arg);
4379 return fail_at(arg, rc);
4382 CommandLineSwitchCase(arg,
"app-workdir")
4385 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4387 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4389 CommandLineSwitchCase(arg,
"app-name")
4391 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4393 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4395 CommandLineSwitchCase(arg,
"app-icon")
4397 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4399 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4401 CommandLineSwitchCase(arg,
"app-cmd")
4403 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4405 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4407 CommandLineSwitchCase(arg,
"app-file")
4409 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4411 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4413 CommandLineSwitchCase(arg,
"app-guid")
4415 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4417 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4419 CommandLineSwitchCase(arg,
"g")
4421 if (!parse_gateway_host_option(settings, arg->Value))
4422 return fail_at(arg, COMMAND_LINE_ERROR);
4424 CommandLineSwitchCase(arg,
"gu")
4426 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4427 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4429 CommandLineSwitchCase(arg,
"gd")
4431 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4432 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4434 CommandLineSwitchCase(arg,
"gp")
4436 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4437 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4439 CommandLineSwitchCase(arg,
"gt")
4441 if (!parse_gateway_type_option(settings, arg->Value))
4442 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4444 CommandLineSwitchCase(arg,
"gat")
4447 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4449 CommandLineSwitchCase(arg,
"gateway-usage-method")
4451 if (!parse_gateway_usage_option(settings, arg->Value))
4452 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4454 CommandLineSwitchCase(arg,
"kbd-remap")
4456 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4457 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4459 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4461 CommandLineSwitchCase(arg,
"kbd-lang")
4465 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4466 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4468 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4469 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4470 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4474 return fail_at(arg, COMMAND_LINE_ERROR);
4476 CommandLineSwitchCase(arg,
"kbd-type")
4478 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4480 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4482 return fail_at(arg, rc);
4484 CommandLineSwitchCase(arg,
"kbd-unicode")
4486 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4488 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4490 CommandLineSwitchCase(arg,
"kbd-subtype")
4492 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4494 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4496 return fail_at(arg, rc);
4498 CommandLineSwitchCase(arg,
"kbd-fn-key")
4500 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4501 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4504 return fail_at(arg, rc);
4506 CommandLineSwitchCase(arg,
"bitmap-cache")
4508 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4510 return fail_at(arg, COMMAND_LINE_ERROR);
4512 CommandLineSwitchCase(arg,
"persist-cache")
4514 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4516 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4518 CommandLineSwitchCase(arg,
"persist-cache-file")
4520 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4521 "/cache:persist-file:<filename> instead");
4523 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4526 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4528 CommandLineSwitchCase(arg,
"offscreen-cache")
4530 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4532 return fail_at(arg, COMMAND_LINE_ERROR);
4534 CommandLineSwitchCase(arg,
"glyph-cache")
4536 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4538 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4539 return fail_at(arg, COMMAND_LINE_ERROR);
4541 CommandLineSwitchCase(arg,
"codec-cache")
4543 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4544 const int rc = parse_codec_cache_options(settings, arg);
4546 return fail_at(arg, rc);
4548 CommandLineSwitchCase(arg,
"sec-rdp")
4550 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4552 return fail_at(arg, COMMAND_LINE_ERROR);
4554 CommandLineSwitchCase(arg,
"sec-tls")
4556 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4558 return fail_at(arg, COMMAND_LINE_ERROR);
4560 CommandLineSwitchCase(arg,
"sec-nla")
4562 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4564 return fail_at(arg, COMMAND_LINE_ERROR);
4566 CommandLineSwitchCase(arg,
"sec-ext")
4568 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4570 return fail_at(arg, COMMAND_LINE_ERROR);
4572 CommandLineSwitchCase(arg,
"tls-ciphers")
4574 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4575 "/tls:ciphers:<cipher list> instead");
4576 int rc = parse_tls_cipher_options(settings, arg);
4578 return fail_at(arg, rc);
4580 CommandLineSwitchCase(arg,
"tls-seclevel")
4582 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4583 int rc = parse_tls_cipher_options(settings, arg);
4585 return fail_at(arg, rc);
4587 CommandLineSwitchCase(arg,
"tls-secrets-file")
4589 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4590 "/tls:secrets-file:<filename> instead");
4591 int rc = parse_tls_cipher_options(settings, arg);
4593 return fail_at(arg, rc);
4595 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4597 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4598 int rc = parse_tls_cipher_options(settings, arg);
4600 return fail_at(arg, rc);
4602 CommandLineSwitchCase(arg,
"cert-name")
4604 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4606 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4608 CommandLineSwitchCase(arg,
"cert-ignore")
4610 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4612 return fail_at(arg, COMMAND_LINE_ERROR);
4614 CommandLineSwitchCase(arg,
"cert-tofu")
4616 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4618 return fail_at(arg, COMMAND_LINE_ERROR);
4620 CommandLineSwitchCase(arg,
"cert-deny")
4622 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4624 return fail_at(arg, COMMAND_LINE_ERROR);
4626 CommandLineSwitchDefault(arg)
4630 CommandLineSwitchEnd(arg);
4635static int parse_command_line_option_timezone(rdpSettings* settings,
4641 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
4642 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
4644 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
4645 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
4647 WINPR_ASSERT(arg->Value);
4648 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
4655 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4658 return fail_at(arg, COMMAND_LINE_ERROR);
4663 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4665 tz->Bias = info.Bias;
4666 tz->DaylightBias = info.DaylightBias;
4667 tz->DaylightDate = info.DaylightDate;
4668 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
4669 tz->StandardBias = info.StandardBias;
4670 tz->StandardDate = info.StandardDate;
4671 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
4676static int parse_command_line_option_window_pos(rdpSettings* settings,
4679 WINPR_ASSERT(settings);
4682 unsigned long x = 0;
4683 unsigned long y = 0;
4686 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4688 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
4690 WLog_ERR(TAG,
"invalid window-position argument");
4691 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4695 return fail_at(arg, COMMAND_LINE_ERROR);
4697 return fail_at(arg, COMMAND_LINE_ERROR);
4702 freerdp_command_line_handle_option_t handle_option,
4703 void* handle_userdata, BOOL* promptForPassword,
char** user)
4705 WINPR_ASSERT(promptForPassword);
4710 BOOL enable = (arg->Value !=
nullptr);
4712 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
4715 CommandLineSwitchStart(arg)
4717 CommandLineSwitchCase(arg,
"v")
4719 const int rc = parse_host_options(settings, arg);
4721 return fail_at(arg, rc);
4723 CommandLineSwitchCase(arg,
"spn-class")
4727 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4729 CommandLineSwitchCase(arg,
"sspi-module")
4732 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4734 CommandLineSwitchCase(arg,
"winscard-module")
4737 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4739 CommandLineSwitchCase(arg,
"redirect-prefer")
4741 const int rc = parse_redirect_prefer_options(settings, arg);
4743 return fail_at(arg, rc);
4745 CommandLineSwitchCase(arg,
"credentials-delegation")
4748 return fail_at(arg, COMMAND_LINE_ERROR);
4750 CommandLineSwitchCase(arg,
"prevent-session-lock")
4752 const int rc = parse_prevent_session_lock_options(settings, arg);
4754 return fail_at(arg, rc);
4756 CommandLineSwitchCase(arg,
"vmconnect")
4758 const int rc = parse_vmconnect_options(settings, arg);
4760 return fail_at(arg, rc);
4762 CommandLineSwitchCase(arg,
"w")
4764 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
4767 return fail_at(arg, rc);
4769 CommandLineSwitchCase(arg,
"h")
4771 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
4774 return fail_at(arg, rc);
4776 CommandLineSwitchCase(arg,
"size")
4778 const int rc = parse_size_options(settings, arg);
4780 return fail_at(arg, rc);
4782 CommandLineSwitchCase(arg,
"f")
4785 return fail_at(arg, COMMAND_LINE_ERROR);
4787 CommandLineSwitchCase(arg,
"suppress-output")
4790 return fail_at(arg, COMMAND_LINE_ERROR);
4792 CommandLineSwitchCase(arg,
"multimon")
4795 return fail_at(arg, COMMAND_LINE_ERROR);
4797 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4799 if (option_equals(arg->Value, str_force))
4802 return fail_at(arg, COMMAND_LINE_ERROR);
4806 CommandLineSwitchCase(arg,
"span")
4809 return fail_at(arg, COMMAND_LINE_ERROR);
4811 CommandLineSwitchCase(arg,
"workarea")
4814 return fail_at(arg, COMMAND_LINE_ERROR);
4816 CommandLineSwitchCase(arg,
"monitors")
4818 const int rc = parse_monitors_options(settings, arg);
4820 return fail_at(arg, rc);
4822 CommandLineSwitchCase(arg,
"t")
4825 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4827 CommandLineSwitchCase(arg,
"decorations")
4830 return fail_at(arg, COMMAND_LINE_ERROR);
4832 CommandLineSwitchCase(arg,
"dynamic-resolution")
4834 const int rc = parse_dynamic_resolution_options(settings, arg);
4836 return fail_at(arg, rc);
4838 CommandLineSwitchCase(arg,
"smart-sizing")
4840 const int rc = parse_smart_sizing_options(settings, arg);
4842 return fail_at(arg, rc);
4844 CommandLineSwitchCase(arg,
"bpp")
4846 const int rc = parse_bpp_options(settings, arg);
4848 return fail_at(arg, rc);
4850 CommandLineSwitchCase(arg,
"admin")
4853 return fail_at(arg, COMMAND_LINE_ERROR);
4855 CommandLineSwitchCase(arg,
"relax-order-checks")
4859 return fail_at(arg, COMMAND_LINE_ERROR);
4861 CommandLineSwitchCase(arg,
"restricted-admin")
4864 return fail_at(arg, COMMAND_LINE_ERROR);
4866 return fail_at(arg, COMMAND_LINE_ERROR);
4868#ifdef CHANNEL_RDPEAR_CLIENT
4869 CommandLineSwitchCase(arg,
"remoteGuard")
4872 return fail_at(arg, COMMAND_LINE_ERROR);
4874 return fail_at(arg, COMMAND_LINE_ERROR);
4877 CommandLineSwitchCase(arg,
"pth")
4880 return fail_at(arg, COMMAND_LINE_ERROR);
4882 return fail_at(arg, COMMAND_LINE_ERROR);
4885 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4887 CommandLineSwitchCase(arg,
"client-hostname")
4890 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4892 CommandLineSwitchCase(arg,
"kbd")
4894 int rc = parse_kbd_options(settings, arg);
4896 return fail_at(arg, rc);
4899 CommandLineSwitchCase(arg,
"u")
4901 WINPR_ASSERT(arg->Value);
4904 CommandLineSwitchCase(arg,
"d")
4907 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4909 CommandLineSwitchCase(arg,
"p")
4912 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4914 CommandLineSwitchCase(arg,
"gateway")
4916 if (!parse_gateway_options(settings, arg))
4917 return fail_at(arg, COMMAND_LINE_ERROR);
4919 CommandLineSwitchCase(arg,
"proxy")
4921 const int rc = parse_proxy_options(settings, arg);
4923 return fail_at(arg, rc);
4926 CommandLineSwitchCase(arg,
"azure")
4928 int rc = parse_aad_options(settings, arg);
4930 return fail_at(arg, rc);
4932 CommandLineSwitchCase(arg,
"app")
4934 int rc = parse_app_options(settings, arg);
4936 return fail_at(arg, rc);
4938 CommandLineSwitchCase(arg,
"load-balance-info")
4940 WINPR_ASSERT(arg->Value);
4942 strlen(arg->Value)))
4943 return fail_at(arg, COMMAND_LINE_ERROR);
4946 CommandLineSwitchCase(arg,
"compression")
4949 return fail_at(arg, COMMAND_LINE_ERROR);
4951 CommandLineSwitchCase(arg,
"compression-level")
4953 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
4956 return fail_at(arg, rc);
4958 CommandLineSwitchCase(arg,
"drives")
4961 return fail_at(arg, COMMAND_LINE_ERROR);
4963 CommandLineSwitchCase(arg,
"dump")
4965 const int rc = parse_dump_options(settings, arg);
4967 return fail_at(arg, rc);
4969 CommandLineSwitchCase(arg,
"disable-output")
4972 return fail_at(arg, COMMAND_LINE_ERROR);
4974 CommandLineSwitchCase(arg,
"home-drive")
4977 return fail_at(arg, COMMAND_LINE_ERROR);
4979 CommandLineSwitchCase(arg,
"ipv4")
4981 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
4984 return fail_at(arg, COMMAND_LINE_ERROR);
4989 return fail_at(arg, COMMAND_LINE_ERROR);
4992 CommandLineSwitchCase(arg,
"ipv6")
4994 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
4997 return fail_at(arg, COMMAND_LINE_ERROR);
5002 return fail_at(arg, COMMAND_LINE_ERROR);
5005 CommandLineSwitchCase(arg,
"clipboard")
5007 const int rc = parse_clipboard_options(settings, arg);
5009 return fail_at(arg, rc);
5011 CommandLineSwitchCase(arg,
"server-name")
5014 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5016 CommandLineSwitchCase(arg,
"shell")
5019 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5021 CommandLineSwitchCase(arg,
"shell-dir")
5024 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5026 CommandLineSwitchCase(arg,
"audio-mode")
5028 const int rc = parse_audio_mode_options(settings, arg);
5030 return fail_at(arg, rc);
5032 CommandLineSwitchCase(arg,
"network")
5034 const int rc = parse_network_options(settings, arg);
5036 return fail_at(arg, rc);
5038 CommandLineSwitchCase(arg,
"fonts")
5041 return fail_at(arg, COMMAND_LINE_ERROR);
5043 CommandLineSwitchCase(arg,
"wallpaper")
5046 return fail_at(arg, COMMAND_LINE_ERROR);
5048 CommandLineSwitchCase(arg,
"window-drag")
5051 return fail_at(arg, COMMAND_LINE_ERROR);
5053 CommandLineSwitchCase(arg,
"window-position")
5055 const int rc = parse_command_line_option_window_pos(settings, arg);
5057 return fail_at(arg, rc);
5059 CommandLineSwitchCase(arg,
"menu-anims")
5062 return fail_at(arg, COMMAND_LINE_ERROR);
5064 CommandLineSwitchCase(arg,
"themes")
5067 return fail_at(arg, COMMAND_LINE_ERROR);
5069 CommandLineSwitchCase(arg,
"timeout")
5072 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5074 return fail_at(arg, rc);
5076 CommandLineSwitchCase(arg,
"timezone")
5078 const int rc = parse_command_line_option_timezone(settings, arg);
5080 return fail_at(arg, rc);
5082 CommandLineSwitchCase(arg,
"aero")
5085 return fail_at(arg, COMMAND_LINE_ERROR);
5087 CommandLineSwitchCase(arg,
"gdi")
5089 if (option_equals(arg->Value,
"sw"))
5092 return fail_at(arg, COMMAND_LINE_ERROR);
5094 else if (option_equals(arg->Value,
"hw"))
5097 return fail_at(arg, COMMAND_LINE_ERROR);
5100 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5102 CommandLineSwitchCase(arg,
"gfx")
5104 int rc = parse_gfx_options(settings, arg);
5106 return fail_at(arg, rc);
5109 CommandLineSwitchCase(arg,
"rfx")
5112 return fail_at(arg, COMMAND_LINE_ERROR);
5114 CommandLineSwitchCase(arg,
"rfx-mode")
5117 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5119 if (option_equals(arg->Value,
"video"))
5122 return fail_at(arg, COMMAND_LINE_ERROR);
5124 else if (option_equals(arg->Value,
"image"))
5127 return fail_at(arg, COMMAND_LINE_ERROR);
5129 return fail_at(arg, COMMAND_LINE_ERROR);
5132 CommandLineSwitchCase(arg,
"frame-ack")
5134 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5137 return fail_at(arg, rc);
5139 CommandLineSwitchCase(arg,
"nsc")
5142 return fail_at(arg, COMMAND_LINE_ERROR);
5144#if defined(WITH_JPEG)
5145 CommandLineSwitchCase(arg,
"jpeg")
5148 return fail_at(arg, COMMAND_LINE_ERROR);
5150 return fail_at(arg, COMMAND_LINE_ERROR);
5152 CommandLineSwitchCase(arg,
"jpeg-quality")
5156 if (!value_to_int(arg->Value, &val, 0, 100))
5157 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5160 return fail_at(arg, COMMAND_LINE_ERROR);
5163 CommandLineSwitchCase(arg,
"nego")
5166 return fail_at(arg, COMMAND_LINE_ERROR);
5168 CommandLineSwitchCase(arg,
"pcb")
5171 return fail_at(arg, COMMAND_LINE_ERROR);
5174 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5176 CommandLineSwitchCase(arg,
"pcid")
5178 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5181 return fail_at(arg, rc);
5183 return fail_at(arg, COMMAND_LINE_ERROR);
5186 CommandLineSwitchCase(arg,
"connect-child-session")
5200 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5203 CommandLineSwitchCase(arg,
"sec")
5205 const int rc = parse_sec_options(settings, arg);
5207 return fail_at(arg, rc);
5209 CommandLineSwitchCase(arg,
"encryption-methods")
5211 const int rc = parse_encryption_methods_options(settings, arg);
5213 return fail_at(arg, rc);
5215 CommandLineSwitchCase(arg,
"args-from")
5217 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5219 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5221 CommandLineSwitchCase(arg,
"from-stdin")
5224 return fail_at(arg, COMMAND_LINE_ERROR);
5226 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5229 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5230 *promptForPassword = (option_equals(arg->Value, str_force));
5232 if (!*promptForPassword)
5233 return fail_at(arg, COMMAND_LINE_ERROR);
5236 CommandLineSwitchCase(arg,
"log-level")
5238 wLog* root = WLog_GetRoot();
5240 if (!WLog_SetStringLogLevel(root, arg->Value))
5241 return fail_at(arg, COMMAND_LINE_ERROR);
5243 CommandLineSwitchCase(arg,
"log-filters")
5245 if (!WLog_AddStringLogFilters(arg->Value))
5246 return fail_at(arg, COMMAND_LINE_ERROR);
5248 CommandLineSwitchCase(arg,
"tls")
5250 int rc = parse_tls_options(settings, arg);
5252 return fail_at(arg, rc);
5254 CommandLineSwitchCase(arg,
"cert")
5256 const int rc = parse_cert_options(settings, arg);
5258 return fail_at(arg, rc);
5260 CommandLineSwitchCase(arg,
"authentication")
5263 return fail_at(arg, COMMAND_LINE_ERROR);
5265 CommandLineSwitchCase(arg,
"encryption")
5268 return fail_at(arg, COMMAND_LINE_ERROR);
5270 CommandLineSwitchCase(arg,
"grab-keyboard")
5273 return fail_at(arg, COMMAND_LINE_ERROR);
5275 CommandLineSwitchCase(arg,
"grab-mouse")
5278 return fail_at(arg, COMMAND_LINE_ERROR);
5280 CommandLineSwitchCase(arg,
"mouse-relative")
5283 return fail_at(arg, COMMAND_LINE_ERROR);
5285 CommandLineSwitchCase(arg,
"mouse")
5287 const int rc = parse_mouse_options(settings, arg);
5289 return fail_at(arg, rc);
5291 CommandLineSwitchCase(arg,
"unmap-buttons")
5294 return fail_at(arg, COMMAND_LINE_ERROR);
5296 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5299 return fail_at(arg, COMMAND_LINE_ERROR);
5301 CommandLineSwitchCase(arg,
"force-console-callbacks")
5304 return fail_at(arg, COMMAND_LINE_ERROR);
5306 CommandLineSwitchCase(arg,
"floatbar")
5308 const int rc = parse_floatbar_options(settings, arg);
5310 return fail_at(arg, rc);
5312 CommandLineSwitchCase(arg,
"mouse-motion")
5315 return fail_at(arg, COMMAND_LINE_ERROR);
5317 CommandLineSwitchCase(arg,
"parent-window")
5321 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5322 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5325 return fail_at(arg, COMMAND_LINE_ERROR);
5327 CommandLineSwitchCase(arg,
"client-build-number")
5330 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5332 return fail_at(arg, rc);
5334 CommandLineSwitchCase(arg,
"cache")
5336 int rc = parse_cache_options(settings, arg);
5338 return fail_at(arg, rc);
5341 CommandLineSwitchCase(arg,
"max-fast-path-size")
5343 const int rc = parse_command_line_option_uint32(
5344 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5346 return fail_at(arg, rc);
5348 CommandLineSwitchCase(arg,
"auto-request-control")
5352 return fail_at(arg, COMMAND_LINE_ERROR);
5354 CommandLineSwitchCase(arg,
"async-update")
5357 return fail_at(arg, COMMAND_LINE_ERROR);
5359 CommandLineSwitchCase(arg,
"async-channels")
5362 return fail_at(arg, COMMAND_LINE_ERROR);
5364 CommandLineSwitchCase(arg,
"wm-class")
5367 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5369 CommandLineSwitchCase(arg,
"play-rfx")
5372 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5375 return fail_at(arg, COMMAND_LINE_ERROR);
5377 CommandLineSwitchCase(arg,
"auth-only")
5380 return fail_at(arg, COMMAND_LINE_ERROR);
5382 CommandLineSwitchCase(arg,
"auth-pkg-list")
5386 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5388 CommandLineSwitchCase(arg,
"auto-reconnect")
5391 return fail_at(arg, COMMAND_LINE_ERROR);
5393 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5395 const int rc = parse_command_line_option_uint32(
5396 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5398 return fail_at(arg, rc);
5400 CommandLineSwitchCase(arg,
"reconnect-cookie")
5402 const int rc = parse_reconnect_cookie_options(settings, arg);
5404 return fail_at(arg, rc);
5406 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5409 return fail_at(arg, COMMAND_LINE_ERROR);
5411 CommandLineSwitchCase(arg,
"pwidth")
5413 const int rc = parse_command_line_option_uint32(
5414 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5416 return fail_at(arg, rc);
5418 CommandLineSwitchCase(arg,
"pheight")
5420 const int rc = parse_command_line_option_uint32(
5421 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5423 return fail_at(arg, rc);
5425 CommandLineSwitchCase(arg,
"orientation")
5429 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5430 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5433 return fail_at(arg, COMMAND_LINE_ERROR);
5434 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5435 return fail_at(arg, COMMAND_LINE_ERROR);
5437 CommandLineSwitchCase(arg,
"old-license")
5440 return fail_at(arg, COMMAND_LINE_ERROR);
5442 CommandLineSwitchCase(arg,
"scale")
5444 const int rc = parse_scale_options(settings, arg);
5446 return fail_at(arg, rc);
5448 CommandLineSwitchCase(arg,
"scale-desktop")
5450 const int rc = parse_command_line_option_uint32(settings, arg,
5451 FreeRDP_DesktopScaleFactor, 100, 500);
5453 return fail_at(arg, rc);
5454 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5455 return fail_at(arg, COMMAND_LINE_ERROR);
5457 CommandLineSwitchCase(arg,
"scale-device")
5459 const int rc = parse_scale_device_options(settings, arg);
5461 return fail_at(arg, rc);
5463 CommandLineSwitchCase(arg,
"action-script")
5466 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5468 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5471 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5473 CommandLineSwitchCase(arg,
"fipsmode")
5476 return fail_at(arg, COMMAND_LINE_ERROR);
5478 CommandLineSwitchCase(arg,
"smartcard-logon")
5480 const int rc = parse_smartcard_logon_options(settings, arg);
5482 return fail_at(arg, rc);
5484 CommandLineSwitchCase(arg,
"tune")
5486 const int rc = parse_tune_options(settings, arg);
5488 return fail_at(arg, rc);
5490 CommandLineSwitchDefault(arg)
5492#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5493 const int status = parse_deprecated_command_line(settings, arg);
5500 const int rc = handle_option(arg, handle_userdata);
5502 return fail_at(arg, rc);
5505 CommandLineSwitchEnd(arg)
5506 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
5513 bool insecureArgFound =
false;
5514 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5516 const char* cred = credential_args[x];
5520 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5523 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5524 insecureArgFound =
true;
5527 if (insecureArgFound)
5529 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5531 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5532 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file or file descriptor");
5533 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5534 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5539static int freerdp_client_settings_parse_command_line_arguments_int(
5540 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5542 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata,
bool isArgsFrom)
5544 char* user =
nullptr;
5547 BOOL assist = FALSE;
5549 BOOL promptForPassword = FALSE;
5550 BOOL compatibility = FALSE;
5558 ext = option_is_rdp_file(argv[1]);
5559 assist = option_is_incident_file(argv[1]);
5562 if (!ext && !assist)
5563 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5565 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5576 WLog_WARN(TAG,
"Unsupported command line syntax!");
5577 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5578 freerdp_getApplicationDetailsString());
5583 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5587 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5588 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5593 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5594 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5597 CommandLineClearArgumentsA(largs);
5598 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5599 freerdp_client_command_line_pre_filter,
5600 freerdp_client_command_line_post_filter);
5605 prepare_default_settings(settings, largs, ext);
5607 warn_credential_args(largs);
5609 CommandLineFindArgumentA(largs,
"v");
5615 return COMMAND_LINE_ERROR_MEMORY;
5617 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
5625 return COMMAND_LINE_ERROR;
5628 return COMMAND_LINE_ERROR;
5630 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
5631 return COMMAND_LINE_ERROR;
5636 return COMMAND_LINE_ERROR;
5640 if (promptForPassword)
5645 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5647 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
5648 ARRAYSIZE(buffer) - 1, 1))
5649 return COMMAND_LINE_ERROR;
5651 return COMMAND_LINE_ERROR;
5659 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5661 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
5662 ARRAYSIZE(buffer) - 1, 1))
5663 return COMMAND_LINE_ERROR;
5665 return COMMAND_LINE_ERROR;
5670 freerdp_performance_flags_make(settings);
5677 return COMMAND_LINE_ERROR;
5679 return COMMAND_LINE_ERROR;
5682 arg = CommandLineFindArgumentA(largs,
"port");
5683 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
5686 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
5688 return fail_at(arg, rc);
5694 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5695 return fail_at(arg, COMMAND_LINE_ERROR);
5698 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
5701 fill_credential_strings(largs);
5706static void argv_free(
int* pargc,
char** pargv[])
5708 WINPR_ASSERT(pargc);
5709 WINPR_ASSERT(pargv);
5710 const int argc = *pargc;
5711 char** argv = *pargv;
5717 for (
int x = 0; x < argc; x++)
5722static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
5724 WINPR_ASSERT(pargc);
5725 WINPR_ASSERT(pargv);
5733 int nargc = *pargc + 1;
5734 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
5744static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
5746 char* copy =
nullptr;
5748 copy = _strdup(what);
5750 const BOOL rc = argv_append(pargc, pargv, copy);
5756static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
5758 BOOL success = FALSE;
5760 WINPR_ASSERT(aargc);
5761 WINPR_ASSERT(aargv);
5766 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
5769 if (!argv_append_dup(aargc, aargv, cmd))
5773 char* line =
nullptr;
5775 INT64 rc = GetLine(&line, &size, fp);
5776 if ((rc < 0) || !line)
5786 const char cur = (line[rc - 1]);
5787 if ((cur ==
'\n') || (cur ==
'\r'))
5789 line[rc - 1] =
'\0';
5801 if (!argv_append(aargc, aargv, line))
5812 argv_free(aargc, aargv);
5816static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
5819 BOOL success = FALSE;
5820 char* env =
nullptr;
5822 WINPR_ASSERT(aargc);
5823 WINPR_ASSERT(aargv);
5828 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
5833 const DWORD size = GetEnvironmentVariableX(name, env, 0);
5836 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
5839 env = calloc(size + 1,
sizeof(
char));
5844 const DWORD rc = GetEnvironmentVariableX(name, env, size);
5849 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
5855 if (!argv_append_dup(aargc, aargv, cmd))
5859 char* context =
nullptr;
5860 char* tok = strtok_s(env,
"\n", &context);
5863 if (!argv_append_dup(aargc, aargv, tok))
5865 tok = strtok_s(
nullptr,
"\n", &context);
5873 argv_free(aargc, aargv);
5877int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
5878 char* oargv[], BOOL allowUnknown)
5880 return freerdp_client_settings_parse_command_line_arguments_ex(
5881 settings, oargc, oargv, allowUnknown,
nullptr, 0,
nullptr,
nullptr);
5884int freerdp_client_settings_parse_command_line_arguments_ex(
5885 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
5887 void* handle_userdata)
5890 char** argv = oargv;
5893 char** aargv =
nullptr;
5895 bool isArgsFrom =
false;
5896 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
5899 BOOL success = FALSE;
5900 const char* file = strchr(argv[1],
':') + 1;
5903 if (option_starts_with(
"fd:", file))
5905 ULONGLONG result = 0;
5906 const char* val = strchr(file,
':') + 1;
5907 if (!value_to_uint(val, &result, 0, INT_MAX))
5909 fp = fdopen((
int)result,
"r");
5910 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5912 else if (strncmp(file,
"env:", 4) == 0)
5914 const char* name = strchr(file,
':') + 1;
5915 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
5917 else if (strcmp(file,
"stdin") != 0)
5919 fp = winpr_fopen(file,
"r");
5920 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5923 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
5931 WINPR_ASSERT(count <= SSIZE_MAX);
5937 res = freerdp_client_settings_parse_command_line_arguments_int(
5938 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata,
5942 argv_free(&aargc, &aargv);
5946static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
5947 const char* name,
void* data)
5949 PVIRTUALCHANNELENTRY entry =
nullptr;
5950 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
5951 name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
5952 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
5956 freerdp_load_channel_addin_entry(name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC);
5960 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
5962 WLog_DBG(TAG,
"loading channelEx %s", name);
5968 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
5970 WLog_DBG(TAG,
"loading channel %s", name);
5980 FreeRDP_Settings_Keys_Bool settingId;
5981 const char* channelName;
5985BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
5987 ChannelToLoad dynChannels[] = {
5988#if defined(CHANNEL_AINPUT_CLIENT)
5989 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME,
nullptr },
5991#ifdef CHANNEL_AUDIN_CLIENT
5992 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME,
nullptr },
5994#ifdef CHANNEL_RDPSND_CLIENT
5995 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
5997#ifdef CHANNEL_RDPEI_CLIENT
5998 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME,
nullptr },
6000#ifdef CHANNEL_RDPGFX_CLIENT
6001 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME,
nullptr },
6003#ifdef CHANNEL_ECHO_CLIENT
6004 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME,
nullptr },
6006#ifdef CHANNEL_SSHAGENT_CLIENT
6007 { FreeRDP_SupportSSHAgentChannel,
"sshagent",
nullptr },
6009#ifdef CHANNEL_DISP_CLIENT
6010 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME,
nullptr },
6012#ifdef CHANNEL_GEOMETRY_CLIENT
6013 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME,
nullptr },
6015#ifdef CHANNEL_VIDEO_CLIENT
6016 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME,
nullptr },
6018#ifdef CHANNEL_RDPEAR_CLIENT
6019 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME,
nullptr },
6023 ChannelToLoad staticChannels[] = {
6024#if defined(CHANNEL_RDPSND_CLIENT)
6025 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6027#if defined(CHANNEL_CLIPRDR_CLIENT)
6028 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME,
nullptr },
6030#if defined(CHANNEL_ENCOMSP_CLIENT)
6031 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6033#if defined(CHANNEL_REMDESK_CLIENT)
6034 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6036#if defined(CHANNEL_RAIL_CLIENT)
6037 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6044 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6046 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6049 const char*
const p[] = { dynChannels[i].channelName };
6051 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6059 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6060 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6061#
if defined(CHANNEL_TSMF_CLIENT)
6062 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6072 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6088 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6096 char* value =
nullptr;
6097 char* tok =
nullptr;
6098 char* context =
nullptr;
6100 value = _strdup(DrivesToRedirect);
6104 tok = strtok_s(value,
";", &context);
6107 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6124 const char* name =
nullptr;
6125 const char* drive = tok;
6126 char* subcontext =
nullptr;
6127 char* start = strtok_s(tok,
"(", &subcontext);
6128 char* end = strtok_s(
nullptr,
")", &subcontext);
6132 if (freerdp_path_valid(name,
nullptr) && freerdp_path_valid(drive,
nullptr))
6134 success = freerdp_client_add_drive(settings, name,
nullptr);
6136 success = freerdp_client_add_drive(settings, drive,
nullptr);
6139 success = freerdp_client_add_drive(settings, drive, name);
6147 tok = strtok_s(
nullptr,
";", &context);
6156 if (!freerdp_device_collection_find(settings,
"drive"))
6158 const char*
const params[] = {
"drive",
"media",
"*" };
6160 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6177 if (!freerdp_device_collection_find(settings,
"drive"))
6179 const char* params[] = {
"drive",
"home",
"%" };
6181 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6188 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6192 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6193 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6195 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6197 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6200 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6207 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6209 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0,
nullptr);
6214 if (!freerdp_device_collection_add(settings, smartcard))
6216 freerdp_device_free(smartcard);
6224 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6226 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0,
nullptr);
6231 if (!freerdp_device_collection_add(settings, printer))
6233 freerdp_device_free(printer);
6260 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6262 if ((staticChannels[i].settingId == 0) ||
6265 if (staticChannels[i].args)
6267 if (!freerdp_client_load_static_channel_addin(
6268 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6273 const char*
const p[] = { staticChannels[i].channelName };
6274 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6284 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6285 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6294 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6296 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6308 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6316void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6318 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6319 const DWORD log_level = WLOG_WARN;
6320 wLog* log = WLog_Get(TAG);
6323 if (!WLog_IsLevelActive(log, log_level))
6326 WLog_Print_unchecked(log, log_level,
"[unmaintained] %s client is currently unmaintained!",
6328 WLog_Print_unchecked(
6330 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6332 WLog_Print_unchecked(
6334 "Be prepared to fix issues yourself though as nobody is actively working on this.");
6335 WLog_Print_unchecked(
6337 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6338 "- don't hesitate to ask some questions. (replies might take some time depending "
6339 "on your timezone) - if you intend using this component write us a message");
6342void freerdp_client_warn_experimental(
int argc,
char* argv[])
6344 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6345 const DWORD log_level = WLOG_WARN;
6346 wLog* log = WLog_Get(TAG);
6349 if (!WLog_IsLevelActive(log, log_level))
6352 WLog_Print_unchecked(log, log_level,
"[experimental] %s client is currently experimental!",
6354 WLog_Print_unchecked(
6356 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6357 "known issues or create a new one!");
6358 WLog_Print_unchecked(
6360 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6361 "- don't hesitate to ask some questions. (replies might take some time depending "
6362 "on your timezone)");
6365void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6367 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6368 const DWORD log_level = WLOG_WARN;
6369 wLog* log = WLog_Get(TAG);
6372 if (!WLog_IsLevelActive(log, log_level))
6375 WLog_Print_unchecked(log, log_level,
"[deprecated] %s client has been deprecated", app);
6376 WLog_Print_unchecked(log, log_level,
"As replacement there is a SDL3 based client available.");
6377 WLog_Print_unchecked(
6379 "If you are interested in keeping %s alive get in touch with the developers", app);
6380 WLog_Print_unchecked(
6382 "The project is hosted at https://github.com/freerdp/freerdp and "
6383 " developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6384 "- don't hesitate to ask some questions. (replies might take some time depending "
6385 "on your timezone)");
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
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 char * freerdp_settings_get_string_writable(rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a string settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT16 freerdp_settings_get_uint16(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id)
Returns a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT64 freerdp_settings_get_uint64(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id)
Returns a UINT64 settings value.
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.
FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
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_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_name_for_key(SSIZE_T key)
Returns the type name for a key.
FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val, size_t len)
Sets a string settings value. The val is copied.
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 SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.