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/rdpewa.h>
47#include <freerdp/channels/rdp2tcp.h>
48#include <freerdp/channels/remdesk.h>
49#include <freerdp/channels/rdpsnd.h>
50#include <freerdp/channels/disp.h>
51#include <freerdp/crypto/crypto.h>
52#include <freerdp/locale/keyboard.h>
53#include <freerdp/utils/passphrase.h>
54#include <freerdp/utils/proxy_utils.h>
55#include <freerdp/utils/string.h>
56#include <freerdp/channels/urbdrc.h>
57#include <freerdp/channels/rdpdr.h>
58#include <freerdp/locale/locale.h>
60#include <freerdp/utils/warnings.h>
62#if defined(CHANNEL_AINPUT_CLIENT)
63#include <freerdp/channels/ainput.h>
66#include <freerdp/channels/audin.h>
67#include <freerdp/channels/echo.h>
69#include <freerdp/client/cmdline.h>
70#include <freerdp/version.h>
71#include <freerdp/client/utils/smartcard_cli.h>
73#include <openssl/tls1.h>
76#include <freerdp/log.h>
77#define TAG CLIENT_TAG("common.cmdline")
79static const char str_force[] =
"force";
81static const char* credential_args[] = {
"p",
"smartcard-logon",
82#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
85 "pth",
"reconnect-cookie",
88static const char* option_starts_with(
const char* what,
const char* val);
89static BOOL option_ends_with(
const char* str,
const char* ext);
90static BOOL option_equals(
const char* what,
const char* val);
92static BOOL freerdp_client_print_codepages(
const char* arg)
96 const char* filter =
nullptr;
101 filter = strchr(arg,
',');
107 pages = freerdp_keyboard_get_matching_codepages(column, filter, &count);
111 printf(
"%-10s %-8s %-60s %-36s %-48s\n",
"<id>",
"<locale>",
"<win langid>",
"<language>",
113 for (
size_t x = 0; x < count; x++)
116 char buffer[2048] = WINPR_C_ARRAY_INIT;
118 if (strnlen(page->subLanguageSymbol, ARRAYSIZE(page->subLanguageSymbol)) > 0)
119 (void)_snprintf(buffer,
sizeof(buffer),
"[%s|%s]", page->primaryLanguageSymbol,
120 page->subLanguageSymbol);
122 (
void)_snprintf(buffer,
sizeof(buffer),
"[%s]", page->primaryLanguageSymbol);
123 printf(
"id=0x%04" PRIx16
": [%-6s] %-60s %-36s %-48s\n", page->id, page->locale, buffer,
124 page->primaryLanguage, page->subLanguage);
126 freerdp_codepages_free(pages);
130static BOOL freerdp_path_valid(
const char* path, BOOL* special)
132 const char DynamicDrives[] =
"DynamicDrives";
138 isSpecial = (option_equals(
"*", path) || option_equals(DynamicDrives, path) ||
139 option_equals(
"%", path));
141 isPath = winpr_PathFileExists(path);
144 *special = isSpecial;
146 return isSpecial || isPath;
149static BOOL freerdp_sanitize_drive_name(
char* name,
const char* invalid,
const char* replacement)
151 if (!name || !invalid || !replacement)
153 if (strlen(invalid) != strlen(replacement))
156 while (*invalid !=
'\0')
158 const char what = *invalid++;
159 const char with = *replacement++;
162 while ((cur = strchr(cur, what)) !=
nullptr)
168static char* name_from_path(
const char* path)
170 const char* name =
"nullptr";
173 if (option_equals(
"%", path))
175 else if (option_equals(
"*", path))
176 name =
"hotplug-all";
177 else if (option_equals(
"DynamicDrives", path))
182 return _strdup(name);
185static BOOL freerdp_client_add_drive(rdpSettings* settings,
const char* path,
const char* name)
187 char* dname =
nullptr;
206 if (!skip && winpr_PathFileExists(name))
208 if (!winpr_PathFileExists(path) || (!PathIsRelativeA(name) && PathIsRelativeA(path)))
210 const char* tmp = path;
218 dname = _strdup(name);
220 dname = name_from_path(path);
222 if (freerdp_sanitize_drive_name(dname,
"\\/",
"__"))
224 const char* args[] = { dname, path };
225 device = freerdp_device_new(RDPDR_DTYP_FILESYSTEM, ARRAYSIZE(args), args);
235 BOOL isSpecial = FALSE;
236 BOOL isPath = freerdp_path_valid(path, &isSpecial);
238 if (!isPath && !isSpecial)
240 WLog_WARN(TAG,
"Invalid drive to redirect: '%s' does not exist, skipping.", path);
241 freerdp_device_free(device);
243 else if (!freerdp_device_collection_add(settings, device))
250 freerdp_device_free(device);
254static BOOL value_to_int(
const char* value, LONGLONG* result, LONGLONG min, LONGLONG max)
258 if (!value || !result)
262 rc = _strtoi64(value,
nullptr, 0);
267 if ((rc < min) || (rc > max))
274static BOOL value_to_uint(
const char* value, ULONGLONG* result, ULONGLONG min, ULONGLONG max)
276 unsigned long long rc = 0;
278 if (!value || !result)
282 rc = _strtoui64(value,
nullptr, 0);
287 if ((rc < min) || (rc > max))
294BOOL freerdp_client_print_version(
void)
296 printf(
"This is FreeRDP version %s (%s)\n", FREERDP_VERSION_FULL, FREERDP_GIT_REVISION);
300BOOL freerdp_client_print_version_ex(
int argc,
char** argv)
302 WINPR_ASSERT(argc >= 0);
303 WINPR_ASSERT(argv || (argc == 0));
304 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
305 printf(
"This is FreeRDP version [%s] %s (%s)\n", name, FREERDP_VERSION_FULL,
306 FREERDP_GIT_REVISION);
310BOOL freerdp_client_print_buildconfig(
void)
312 printf(
"%s", freerdp_get_build_config());
316BOOL freerdp_client_print_buildconfig_ex(
int argc,
char** argv)
318 WINPR_ASSERT(argc >= 0);
319 WINPR_ASSERT(argv || (argc == 0));
320 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
321 printf(
"[%s] %s", name, freerdp_get_build_config());
325static void freerdp_client_print_scancodes(
void)
327 printf(
"RDP scancodes and their name for use with /kbd:remap\n");
329 for (UINT32 x = 0; x < UINT16_MAX; x++)
331 const char* name = freerdp_keyboard_scancode_name(x);
333 printf(
"0x%04" PRIx32
" --> %s\n", x, name);
337static BOOL is_delimiter(
char c,
const char* delimiters)
340 while ((d = *delimiters++) !=
'\0')
348static const char* get_last(
const char* start,
size_t len,
const char* delimiters)
350 const char* last =
nullptr;
351 for (
size_t x = 0; x < len; x++)
354 if (is_delimiter(c, delimiters))
360static SSIZE_T next_delimiter(
const char* text,
size_t len,
size_t max,
const char* delimiters)
365 const char* last = get_last(text, max, delimiters);
369 return (SSIZE_T)(last - text);
372static SSIZE_T forced_newline_at(
const char* text,
size_t len,
size_t limit,
373 const char* force_newline)
376 while ((d = *force_newline++) !=
'\0')
378 const char* tok = strchr(text, d);
381 const size_t offset = WINPR_ASSERTING_INT_CAST(
size_t, tok - text);
382 if ((offset > len) || (offset > limit))
384 return (SSIZE_T)(offset);
390static BOOL print_align(
size_t start_offset,
size_t* current)
392 WINPR_ASSERT(current);
393 if (*current < start_offset)
395 const int rc = printf(
"%*c", (
int)(start_offset - *current),
' ');
398 *current += (size_t)rc;
403static char* print_token(
char* text,
size_t start_offset,
size_t* current,
size_t limit,
404 const char* delimiters,
const char* force_newline)
407 const size_t tlen = strnlen(text, limit);
409 const SSIZE_T force_at = forced_newline_at(text, len, limit - *current, force_newline);
410 BOOL isForce = (force_at >= 0);
413 len = MIN(len, (
size_t)force_at);
415 if (!print_align(start_offset, current))
418 const SSIZE_T delim = next_delimiter(text, len, limit - *current, delimiters);
419 const BOOL isDelim = delim > 0;
422 len = MIN(len, (
size_t)delim + 1);
425 rc = printf(
"%.*s", (
int)len, text);
429 if (isForce || isDelim)
434 const size_t offset = len + ((isForce && (force_at == 0)) ? 1 : 0);
435 return &text[offset];
438 *current += (size_t)rc;
440 if (tlen == (
size_t)rc)
442 return &text[(size_t)rc];
445static size_t print_optionals(
const char* text,
size_t start_offset,
size_t current)
447 const size_t limit = 80;
448 char* str = _strdup(text);
453 cur = print_token(cur, start_offset + 1, ¤t, limit,
"[], ",
"\r\n");
454 }
while (cur !=
nullptr);
460static size_t print_description(
const char* text,
size_t start_offset,
size_t current)
462 const size_t limit = 80;
463 char* str = _strdup(text);
466 while (cur !=
nullptr)
467 cur = print_token(cur, start_offset, ¤t, limit,
" ",
"\r\n");
470 const int rc = printf(
"\n");
473 const size_t src = WINPR_ASSERTING_INT_CAST(
size_t, rc);
474 WINPR_ASSERT(SIZE_MAX - src > current);
480static int cmp_cmdline_args(
const void* pva,
const void* pvb)
485 if (!a->Name && !b->Name)
491 return strcmp(a->Name, b->Name);
506 const size_t description_offset = 30 + 8;
508 if (arg->Flags & (COMMAND_LINE_VALUE_BOOL | COMMAND_LINE_VALUE_FLAG))
510 if ((arg->Flags & (uint32_t)~COMMAND_LINE_VALUE_BOOL) == 0)
511 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
512 else if ((arg->Flags & COMMAND_LINE_VALUE_OPTIONAL) != 0)
513 rc = printf(
" [%s|/]%s", arg->Default ?
"-" :
"+", arg->Name);
516 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
520 rc = printf(
" /%s", arg->Name);
526 if ((arg->Flags & COMMAND_LINE_VALUE_REQUIRED) ||
527 (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL))
531 if (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL)
537 pos = print_optionals(arg->Format, pos, pos);
549 pos = print_optionals(arg->Format, pos, pos);
552 if (pos > description_offset)
560 rc = printf(
"%*c", (
int)(description_offset - pos),
' ');
565 if (arg->Flags & COMMAND_LINE_VALUE_BOOL)
567 rc = printf(
"%s ", arg->Default ?
"Disable" :
"Enable");
573 print_description(arg->Text, description_offset, pos);
574 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
577BOOL freerdp_client_print_command_line_help(
int argc,
char** argv)
579 return freerdp_client_print_command_line_help_ex(argc, argv,
nullptr);
583 SSIZE_T count,
size_t* pcount)
585 WINPR_ASSERT(pcount);
590 while (cur && cur->Name)
605 while (cur && cur->Name)
607 largs[lcount++] = *cur++;
610 cur = global_cmd_args;
611 while (cur && cur->Name)
613 largs[lcount++] = *cur++;
619static void freerdp_client_print_command_line_usage(
int argc,
char** argv)
621 WINPR_ASSERT(argv || (argc < 1));
623 const char* name = freerdp_getApplicationDetailsString();
627 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
628 printf(
"To show full command line help type\n");
629 printf(
"%s /?\n", name);
633BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
636 const char* name = freerdp_getApplicationDetailsString();
648 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
649 printf(
"See www.freerdp.com for more information\n");
651 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
654 printf(
" /flag (enables flag)\n");
655 printf(
" /option:<value> (specifies option with value)\n");
656 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
659 freerdp_client_print_command_line_args(largs, lcount);
663 printf(
"Examples:\n");
664 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
665 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
666 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
667 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
668 "/v:192.168.1.100\n",
670 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
671 printf(
"Use a generic pipe as transport:");
672 printf(
" %s /v:/path/to/pipe\n", name);
673 printf(
"Use a external socket:");
674 printf(
" %s /v:|:1234\n", name);
676 printf(
"Connect to a system with TLS security and open the greeter:");
677 printf(
"NOTE: Needs a server configured to not require NLA or it will fail!");
679 printf(
" %s /sec:tls /p /v:rdp.contoso.com\n", name);
681 printf(
"Disable clipboard redirection: -clipboard\n");
683 printf(
"Drive Redirection: /drive:home,/home/user\n");
684 printf(
"Smartcard Redirection: /smartcard:<device>\n");
685 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
687#if defined(CHANNEL_SERIAL_CLIENT)
688 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
689 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
691#if defined(CHANNEL_PARALLEL_CLIENT)
692 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
694 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
695 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
697 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
698 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
699 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
700 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
702 printf(
"Multimedia Redirection: /video\n");
703#ifdef CHANNEL_URBDRC_CLIENT
704 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
707 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
709 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
711 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
713 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
715 printf(
"More documentation is coming, in the meantime consult source files\n");
720static BOOL option_is_rdp_file(
const char* option)
722 WINPR_ASSERT(option);
724 if (option_ends_with(option,
".rdp"))
726 if (option_ends_with(option,
".rdpw"))
731static BOOL option_is_incident_file(
const char* option)
733 WINPR_ASSERT(option);
735 return (option_ends_with(option,
".msrcIncident"));
738static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
743 rdpSettings* settings =
nullptr;
748 length = strlen(argv[index]);
752 if (option_is_rdp_file(argv[index]))
754 settings = (rdpSettings*)context;
757 return COMMAND_LINE_ERROR_MEMORY;
765 if (option_is_incident_file(argv[index]))
767 settings = (rdpSettings*)context;
770 return COMMAND_LINE_ERROR_MEMORY;
780BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
781 const char*
const* params)
783 WINPR_ASSERT(settings);
786 WINPR_ASSERT(params);
787 WINPR_ASSERT(count > 0);
789 if (option_equals(params[0],
"drive"))
798 rc = freerdp_client_add_drive(settings, params[1],
nullptr);
800 rc = freerdp_client_add_drive(settings, params[2], params[1]);
804 else if (option_equals(params[0],
"printer"))
811 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
815 if (!freerdp_device_collection_add(settings, printer))
817 freerdp_device_free(printer);
823 else if (option_equals(params[0],
"smartcard"))
830 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
834 if (!freerdp_device_collection_add(settings, smartcard))
836 freerdp_device_free(smartcard);
842#if defined(CHANNEL_SERIAL_CLIENT)
843 else if (option_equals(params[0],
"serial"))
850 RDPDR_DEVICE* serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
854 if (!freerdp_device_collection_add(settings, serial))
856 freerdp_device_free(serial);
863 else if (option_equals(params[0],
"parallel"))
870 RDPDR_DEVICE* parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
875 if (!freerdp_device_collection_add(settings, parallel))
877 freerdp_device_free(parallel);
887BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
889 return freerdp_static_channel_collection_del(settings, name);
892BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
893 const char*
const* params)
898 if (!settings || !params || !params[0] || (count > INT_MAX))
901 if (freerdp_static_channel_collection_find(settings, params[0]))
904 ADDIN_ARGV* _args = freerdp_addin_argv_new(count, params);
908 if (!freerdp_static_channel_collection_add(settings, _args))
913 freerdp_addin_argv_free(_args);
917BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
919 return freerdp_dynamic_channel_collection_del(settings, name);
922BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
923 const char*
const* params)
927 if (!settings || !params || !params[0] || (count > INT_MAX))
930 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
933 ADDIN_ARGV* _args = freerdp_addin_argv_new(count, params);
937 if (!freerdp_dynamic_channel_collection_add(settings, _args))
943 freerdp_addin_argv_free(_args);
947static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
948 const char* b64OrFile)
950 const size_t blen = strlen(b64OrFile);
953 crypto_base64url_decode(b64OrFile, blen, (BYTE**)&pem, &plen);
956 pem = crypto_read_pem(b64OrFile, &plen);
957 if (!pem || (plen == 0))
972 CMDLINE_SUBOPTION_STRING,
973 CMDLINE_SUBOPTION_FILE,
974} CmdLineSubOptionType;
976typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
980 FreeRDP_Settings_Keys_String id;
981 CmdLineSubOptionType opttype;
982 WINPR_ATTR_NODISCARD CmdLineSubOptionCb cb;
985static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
990 for (
size_t xx = 0; xx < count; xx++)
992 const CmdLineSubOptions* opt = &opts[xx];
994 if (option_starts_with(opt->optname, arg))
996 const size_t optlen = strlen(opt->optname);
997 const char* val = &arg[optlen];
1000 switch (opt->opttype)
1002 case CMDLINE_SUBOPTION_STRING:
1005 case CMDLINE_SUBOPTION_FILE:
1006 status = read_pem_file(settings, opt->id, val);
1009 WLog_ERR(TAG,
"invalid subOption type");
1016 if (opt->cb && !opt->cb(val, settings))
1025 WLog_ERR(TAG,
"option %s not handled", arg);
1030#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1037 const DWORD level = WLOG_ERROR;
1038 wLog* log = WLog_Get(TAG);
1039 if (WLog_IsLevelActive(log, level))
1041 const char* val = arg->Value;
1042 if ((arg->Flags & COMMAND_LINE_VALUE_FLAG) != 0)
1043 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1044 if ((arg->Flags & COMMAND_LINE_VALUE_BOOL) != 0)
1045 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1047 WLog_PrintTextMessage(log, level, line, file, fkt,
1048 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name, val,
1056 rdpSettings* settings = (rdpSettings*)context;
1057 int status = CHANNEL_RC_OK;
1058 BOOL enable = (arg->Value !=
nullptr);
1060 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1063 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1065 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1066 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1068 status = COMMAND_LINE_ERROR;
1070 CommandLineParserFree(ptr);
1072 return fail_at(arg, status);
1074 CommandLineSwitchCase(arg,
"kerberos")
1078 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1081 const CmdLineSubOptions opts[] = {
1082 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING,
nullptr },
1083 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1084 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1085 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1086 CMDLINE_SUBOPTION_STRING,
nullptr },
1087 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING,
nullptr },
1088 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING,
nullptr },
1089 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1090 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1093 for (
size_t x = 1; x < count; x++)
1095 const char* cur = ptr[x];
1096 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1098 CommandLineParserFree(ptr);
1099 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1103 CommandLineParserFree(ptr);
1106 CommandLineSwitchCase(arg,
"vc")
1109 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1110 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1111 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1112 CommandLineParserFree(ptr);
1114 return fail_at(arg, status);
1116 CommandLineSwitchCase(arg,
"dvc")
1119 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1120 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1121 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1122 CommandLineParserFree(ptr);
1124 return fail_at(arg, status);
1126 CommandLineSwitchCase(arg,
"drive")
1129 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1130 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1131 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1132 CommandLineParserFree(ptr);
1134 return fail_at(arg, status);
1136#if defined(CHANNEL_SERIAL_CLIENT)
1137 CommandLineSwitchCase(arg,
"serial")
1140 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1141 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1142 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1143 CommandLineParserFree(ptr);
1145 return fail_at(arg, status);
1148#if defined(CHANNEL_PARALLEL_CLIENT)
1149 CommandLineSwitchCase(arg,
"parallel")
1152 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1153 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1154 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1155 CommandLineParserFree(ptr);
1157 return fail_at(arg, status);
1160 CommandLineSwitchCase(arg,
"smartcard")
1163 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1164 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1165 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1166 CommandLineParserFree(ptr);
1168 return fail_at(arg, status);
1170 CommandLineSwitchCase(arg,
"printer")
1173 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1174 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1175 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1176 CommandLineParserFree(ptr);
1178 return fail_at(arg, status);
1180 CommandLineSwitchCase(arg,
"usb")
1184 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1185 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1186 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1187 CommandLineParserFree(ptr);
1189 return fail_at(arg, status);
1191 CommandLineSwitchCase(arg,
"multitouch")
1194 return fail_at(arg, COMMAND_LINE_ERROR);
1196 CommandLineSwitchCase(arg,
"gestures")
1199 return fail_at(arg, COMMAND_LINE_ERROR);
1201 CommandLineSwitchCase(arg,
"echo")
1204 return fail_at(arg, COMMAND_LINE_ERROR);
1206 CommandLineSwitchCase(arg,
"ssh-agent")
1209 return fail_at(arg, COMMAND_LINE_ERROR);
1211 CommandLineSwitchCase(arg,
"disp")
1214 return fail_at(arg, COMMAND_LINE_ERROR);
1216 CommandLineSwitchCase(arg,
"geometry")
1219 return fail_at(arg, COMMAND_LINE_ERROR);
1221 CommandLineSwitchCase(arg,
"video")
1225 return fail_at(arg, COMMAND_LINE_ERROR);
1227 return fail_at(arg, COMMAND_LINE_ERROR);
1229 CommandLineSwitchCase(arg,
"sound")
1233 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1234 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1235 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1236 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1237 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1239 CommandLineParserFree(ptr);
1241 return fail_at(arg, status);
1243 CommandLineSwitchCase(arg,
"microphone")
1246 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1247 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1248 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1249 CommandLineParserFree(ptr);
1251 return fail_at(arg, status);
1253#if defined(CHANNEL_TSMF_CLIENT)
1254 CommandLineSwitchCase(arg,
"multimedia")
1257 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1258 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1259 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1260 CommandLineParserFree(ptr);
1262 return fail_at(arg, status);
1265 CommandLineSwitchCase(arg,
"heartbeat")
1268 return fail_at(arg, COMMAND_LINE_ERROR);
1270 CommandLineSwitchCase(arg,
"multitransport")
1273 return fail_at(arg, COMMAND_LINE_ERROR);
1278 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1281 return fail_at(arg, COMMAND_LINE_ERROR);
1283 CommandLineSwitchEnd(arg)
1290 int status = freerdp_client_command_line_post_filter_int(context, arg);
1291 return status == CHANNEL_RC_OK ? 1 : -1;
1294static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1295 const char** domain,
size_t* domainlen)
1298 WINPR_ASSERT(userlen);
1299 WINPR_ASSERT(domain);
1300 WINPR_ASSERT(domainlen);
1305 const char* p = strchr(username,
'\\');
1315 const size_t length = (size_t)(p - username);
1317 *userlen = strlen(*user);
1320 *domainlen = length;
1329 *userlen = strlen(username);
1335static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1336 FreeRDP_Settings_Keys_String userID,
1337 FreeRDP_Settings_Keys_String domainID)
1339 const char* user =
nullptr;
1340 const char* domain =
nullptr;
1342 size_t domainlen = 0;
1344 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1352BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1354 const char* user =
nullptr;
1355 const char* domain =
nullptr;
1357 size_t domainlen = 0;
1362 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1368 *puser = strndup(user, userlen);
1375 *pdomain = strndup(domain, domainlen);
1387BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1390 p = strrchr(hostname,
':');
1394 size_t length = (size_t)(p - hostname);
1397 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1400 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1405 CopyMemory(*host, hostname, length);
1406 (*host)[length] =
'\0';
1407 *port = (UINT16)val;
1411 *host = _strdup(hostname);
1422static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1424 struct network_settings
1426 FreeRDP_Settings_Keys_Bool id;
1429 const struct network_settings config[] = {
1430 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1431 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1432 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1433 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1434 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1435 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1440 case CONNECTION_TYPE_INVALID:
1443 case CONNECTION_TYPE_MODEM:
1444 case CONNECTION_TYPE_BROADBAND_LOW:
1445 case CONNECTION_TYPE_BROADBAND_HIGH:
1446 case CONNECTION_TYPE_SATELLITE:
1447 case CONNECTION_TYPE_WAN:
1448 case CONNECTION_TYPE_LAN:
1449 case CONNECTION_TYPE_AUTODETECT:
1452 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1456 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1458 const struct network_settings* cur = &config[x];
1465BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1473 case CONNECTION_TYPE_INVALID:
1474 case CONNECTION_TYPE_MODEM:
1475 case CONNECTION_TYPE_BROADBAND_LOW:
1476 case CONNECTION_TYPE_SATELLITE:
1477 case CONNECTION_TYPE_BROADBAND_HIGH:
1478 case CONNECTION_TYPE_WAN:
1479 case CONNECTION_TYPE_LAN:
1480 if (!freerdp_apply_connection_type(settings, type))
1483 case CONNECTION_TYPE_AUTODETECT:
1484 if (!freerdp_apply_connection_type(settings, type))
1498 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1505static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1510 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1512 if (!layouts || (count == 0))
1515 for (
size_t x = 0; x < count; x++)
1518 if (option_equals(layout->name, name))
1526 freerdp_keyboard_layouts_free(layouts, count);
1530static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1532 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1533 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1535 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1537 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1545static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1548 WINPR_UNUSED(context);
1555 length = strlen(argv[index]);
1559 if (option_is_rdp_file(argv[index]))
1567 if (option_is_incident_file(argv[index]))
1577static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1582 int detect_status = 0;
1585 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1587 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1588 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1592 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1597 CommandLineClearArgumentsA(largs);
1598 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1599 freerdp_detect_command_line_pre_filter,
nullptr);
1608 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1612 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1614 return detect_status;
1617static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1622 int detect_status = 0;
1625 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1627 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1628 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1629 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1633 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1638 CommandLineClearArgumentsA(largs);
1639 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1640 freerdp_detect_command_line_pre_filter,
nullptr);
1649 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1653 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1655 return detect_status;
1658static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1660 size_t posix_cli_count = 0;
1661 size_t windows_cli_count = 0;
1662 const BOOL ignoreUnknown = TRUE;
1663 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1664 argc, argv, &windows_cli_count, ignoreUnknown);
1665 const int posix_cli_status =
1666 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1669 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1670 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1671 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1673 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1677 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1678 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1680 windows_cli_count = 1;
1681 *flags = COMMAND_LINE_SEPARATOR_COLON;
1682 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1685 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1686 windows_cli_count, posix_cli_status, posix_cli_count);
1687 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1689 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1695int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1698 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv,
1702static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1706 layouts = freerdp_keyboard_get_layouts(type, &count);
1708 printf(
"\n%s\n", msg);
1710 for (
size_t x = 0; x < count; x++)
1713 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1716 freerdp_keyboard_layouts_free(layouts, count);
1719static void freerdp_client_print_keyboard_list(
void)
1721 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1722 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1723 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1724 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1725 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1728static void freerdp_client_print_timezone_list(
void)
1732 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1734 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
1736 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1737 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1738 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1742static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1746 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1754 case RDP_SETTINGS_TYPE_BOOL:
1755 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1760 case RDP_SETTINGS_TYPE_UINT16:
1761 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1764 case RDP_SETTINGS_TYPE_INT16:
1765 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1768 case RDP_SETTINGS_TYPE_UINT32:
1769 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1772 case RDP_SETTINGS_TYPE_INT32:
1773 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1776 case RDP_SETTINGS_TYPE_UINT64:
1777 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1780 case RDP_SETTINGS_TYPE_INT64:
1781 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1784 case RDP_SETTINGS_TYPE_STRING:
1785 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1790 case RDP_SETTINGS_TYPE_POINTER:
1791 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1803static int evaluate_result(
int argc,
char* argv[],
int rc, rdpSettings* settings,
1806 WINPR_ASSERT(settings);
1807 WINPR_ASSERT(largs);
1809 if (rc != COMMAND_LINE_STATUS_PRINT)
1811 freerdp_client_print_command_line_usage(argc, argv);
1818 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1820 if (option_equals(
"timezones", arg->Value))
1821 freerdp_client_print_timezone_list();
1822 else if (option_equals(
"tune", arg->Value))
1823 freerdp_client_print_tune_list(settings);
1824 else if (option_equals(
"kbd", arg->Value))
1825 freerdp_client_print_keyboard_list();
1826 else if (option_starts_with(
"kbd-lang", arg->Value))
1828 const char* val =
nullptr;
1829 if (option_starts_with(
"kbd-lang:", arg->Value))
1830 val = &arg->Value[9];
1831 else if (!option_equals(
"kbd-lang", arg->Value))
1832 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1834 if (val && strchr(val,
','))
1835 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1836 freerdp_client_print_codepages(val);
1838 else if (option_equals(
"kbd-scancode", arg->Value))
1839 freerdp_client_print_scancodes();
1840 else if (option_equals(
"monitor", arg->Value))
1843 return COMMAND_LINE_ERROR;
1845 else if (option_starts_with(
"smartcard", arg->Value))
1848 if (option_starts_with(
"smartcard:", arg->Value))
1850 else if (!option_equals(
"smartcard", arg->Value))
1851 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1855 const char* sub = strchr(arg->Value,
':') + 1;
1856 const CmdLineSubOptions options[] = {
1857 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1858 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1863 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1865 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1868 CommandLineParserFree(ptr);
1869 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1872 for (
size_t x = 1; x < count; x++)
1874 const char* cur = ptr[x];
1875 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1877 CommandLineParserFree(ptr);
1878 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1882 CommandLineParserFree(ptr);
1885 freerdp_smartcard_list(settings);
1889 freerdp_client_print_command_line_usage(argc, argv);
1890 return COMMAND_LINE_ERROR;
1893#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1894 arg = CommandLineFindArgumentA(largs,
"tune-list");
1897 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1899 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
1900 freerdp_client_print_tune_list(settings);
1903 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
1906 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1908 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
1909 freerdp_client_print_codepages(arg->Value);
1912 arg = CommandLineFindArgumentA(largs,
"kbd-list");
1915 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1917 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
1918 freerdp_client_print_keyboard_list();
1921 arg = CommandLineFindArgumentA(largs,
"monitor-list");
1924 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1926 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
1928 return COMMAND_LINE_ERROR;
1931 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
1934 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1936 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
1937 freerdp_smartcard_list(settings);
1940 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
1943 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1945 WLog_WARN(TAG,
"Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
1946 freerdp_client_print_scancodes();
1947 return COMMAND_LINE_STATUS_PRINT;
1950 return COMMAND_LINE_STATUS_PRINT;
1953int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
1954 int argc,
char** argv,
1957 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
1959 freerdp_client_print_version();
1963 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
1965 freerdp_client_print_version_ex(argc, argv);
1966 freerdp_client_print_buildconfig_ex(argc, argv);
1969 else if (status == COMMAND_LINE_STATUS_PRINT)
1972 COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SIGIL_PLUS_MINUS | COMMAND_LINE_SIGIL_SLASH;
1974 size_t customcount = 0;
1977 while (cur && cur->Name)
1983 size_t globalcount = 0;
1986 while (cur && cur->Name)
2002 CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
nullptr,
nullptr);
2003 status = evaluate_result(argc, argv, rc, settings, largs);
2007 else if (status == COMMAND_LINE_STATUS_PRINT_HELP)
2009 freerdp_client_print_command_line_help_ex(argc, argv, custom);
2012 else if (status < 0)
2014 freerdp_client_print_command_line_usage(argc, argv);
2019 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
2032static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
2034 const char* xcharpos =
nullptr;
2035 char* endPtr =
nullptr;
2036 unsigned long v = 0;
2038 v = strtoul(input, &endPtr, 10);
2040 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2046 xcharpos = strchr(input,
'x');
2048 if (!xcharpos || xcharpos != endPtr)
2052 v = strtoul(xcharpos + 1, &endPtr, 10);
2054 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2057 if (*endPtr !=
'\0')
2069 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2070 WINPR_ASSERT(settings);
2076 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2078 const char* arg = arguments[x];
2080 if (p && (p->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
2084 return freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT);
2087static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2092const char* option_starts_with(
const char* what,
const char* val)
2096 const size_t wlen = strlen(what);
2098 if (_strnicmp(what, val, wlen) != 0)
2103BOOL option_ends_with(
const char* str,
const char* ext)
2107 const size_t strLen = strlen(str);
2108 const size_t extLen = strlen(ext);
2110 if (strLen < extLen)
2113 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2116BOOL option_equals(
const char* what,
const char* val)
2120 return _stricmp(what, val) == 0;
2129} PARSE_ON_OFF_RESULT;
2131static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2133 WINPR_ASSERT(value);
2134 const char* sep = strchr(value,
':');
2137 if (option_equals(
"on", &sep[1]))
2139 if (option_equals(
"off", &sep[1]))
2149 if (arg->Value == BoolValueTrue)
2151 if (arg->Value == BoolValueFalse)
2153 if (option_equals(
"on", arg->Value))
2155 if (option_equals(
"off", arg->Value))
2164 CLIP_DIR_PARSE_LOCAL,
2165 CLIP_DIR_PARSE_REMOTE,
2167} PARSE_CLIP_DIR_RESULT;
2169static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2171 WINPR_ASSERT(value);
2172 const char* sep = strchr(value,
':');
2174 return CLIP_DIR_PARSE_FAIL;
2175 if (option_equals(
"all", &sep[1]))
2176 return CLIP_DIR_PARSE_ALL;
2177 if (option_equals(
"off", &sep[1]))
2178 return CLIP_DIR_PARSE_OFF;
2179 if (option_equals(
"local", &sep[1]))
2180 return CLIP_DIR_PARSE_LOCAL;
2181 if (option_equals(
"remote", &sep[1]))
2182 return CLIP_DIR_PARSE_REMOTE;
2183 return CLIP_DIR_PARSE_FAIL;
2186static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2188 const char* ciphers =
nullptr;
2190 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2192 if (option_equals(Value,
"netmon"))
2194 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2196 else if (option_equals(Value,
"ma"))
2198 ciphers =
"AES128-SHA";
2206 return COMMAND_LINE_ERROR_MEMORY;
2210static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2214 if (!value_to_int(Value, &val, 0, 5))
2215 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2218 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2222static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2225 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2228 return COMMAND_LINE_ERROR_MEMORY;
2232static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2234 UINT16 version = TLS1_2_VERSION;
2243 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2244 {
"1.1", TLS1_1_VERSION },
2245 {
"1.2", TLS1_2_VERSION }
2246#if defined(TLS1_3_VERSION)
2248 {
"1.3", TLS1_3_VERSION }
2252 const struct map_t* found =
nullptr;
2253 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2255 const struct map_t* cur = &map[x];
2256 if (option_equals(cur->name, Value))
2264 version = found->version;
2268 const long v = strtol(Value,
nullptr, 0);
2270 if ((v < -1) || ((v == LONG_MAX) && (errno != 0)) || (v > UINT16_MAX))
2271 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2273 version = WINPR_ASSERTING_INT_CAST(UINT16, v);
2279 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2285 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2286 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2288 if (option_starts_with(
"ciphers:", arg->Value))
2289 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2290 else if (option_starts_with(
"seclevel:", arg->Value))
2291 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2292 else if (option_starts_with(
"secrets-file:", arg->Value))
2293 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2294 else if (option_starts_with(
"enforce:", arg->Value))
2295 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2298#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2299 CommandLineSwitchCase(arg,
"tls-ciphers")
2301 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2302 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2304 CommandLineSwitchCase(arg,
"tls-seclevel")
2306 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2307 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2309 CommandLineSwitchCase(arg,
"tls-secrets-file")
2311 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2312 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2314 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2316 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2317 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2320 CommandLineSwitchDefault(arg)
2323 CommandLineSwitchEnd(arg)
2330 WINPR_ASSERT(settings);
2334 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2335 for (
size_t x = 0; x < count; x++)
2338 larg.Value = ptr[x];
2340 int rc = parse_tls_cipher_options(settings, &larg);
2343 CommandLineParserFree(ptr);
2347 CommandLineParserFree(ptr);
2353 WINPR_ASSERT(settings);
2357 return COMMAND_LINE_ERROR;
2361 int rc = CHANNEL_RC_OK;
2363 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2364 if (!ptr || (count == 0))
2365 rc = COMMAND_LINE_ERROR;
2368 BOOL GfxH264 = FALSE;
2369 BOOL GfxAVC444 = FALSE;
2370 BOOL RemoteFxCodec = FALSE;
2371 BOOL GfxProgressive = FALSE;
2372 BOOL codecSelected = FALSE;
2374 for (
size_t x = 0; x < count; x++)
2376 const char* val = ptr[x];
2378 if (option_starts_with(
"AVC444", val))
2380 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2381 if (bval == PARSE_FAIL)
2382 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2384 GfxAVC444 = bval != PARSE_OFF;
2385 codecSelected = TRUE;
2387 else if (option_starts_with(
"AVC420", val))
2389 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2390 if (bval == PARSE_FAIL)
2391 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2393 GfxH264 = bval != PARSE_OFF;
2394 codecSelected = TRUE;
2398 if (option_starts_with(
"RFX", val))
2400 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2401 if (bval == PARSE_FAIL)
2402 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2404 RemoteFxCodec = bval != PARSE_OFF;
2405 codecSelected = TRUE;
2407 else if (option_starts_with(
"progressive", val))
2409 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2410 if (bval == PARSE_FAIL)
2411 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2413 GfxProgressive = bval != PARSE_OFF;
2414 codecSelected = TRUE;
2416 else if (option_starts_with(
"mask:", val))
2419 const char* uv = &val[5];
2420 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2421 rc = COMMAND_LINE_ERROR;
2426 rc = COMMAND_LINE_ERROR;
2429 else if (option_starts_with(
"small-cache", val))
2431 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2432 if (bval == PARSE_FAIL)
2433 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2436 rc = COMMAND_LINE_ERROR;
2438 else if (option_starts_with(
"thin-client", val))
2440 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2441 if (bval == PARSE_FAIL)
2442 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2445 rc = COMMAND_LINE_ERROR;
2446 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2450 rc = COMMAND_LINE_ERROR;
2453 else if (option_starts_with(
"frame-ack", val))
2455 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2456 if (bval == PARSE_FAIL)
2457 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2460 rc = COMMAND_LINE_ERROR;
2462#if defined(WITH_GFX_AV1)
2463 else if (option_starts_with(
"AV1", val))
2465 uint32_t profile = 1;
2466 BOOL enabled = FALSE;
2467 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2468 if (bval == PARSE_FAIL)
2470 if (_stricmp(
"av1:i420", val) == 0)
2475 else if (_stricmp(
"av1:i444", val) == 0)
2481 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2484 enabled = bval == PARSE_ON;
2486 if (enabled || (bval != PARSE_FAIL))
2489 rc = COMMAND_LINE_ERROR;
2492 rc = COMMAND_LINE_ERROR;
2497 rc = COMMAND_LINE_ERROR;
2500 if ((rc == CHANNEL_RC_OK) && codecSelected)
2503 rc = COMMAND_LINE_ERROR;
2505 rc = COMMAND_LINE_ERROR;
2507 rc = COMMAND_LINE_ERROR;
2509 rc = COMMAND_LINE_ERROR;
2511 rc = COMMAND_LINE_ERROR;
2514 CommandLineParserFree(ptr);
2515 if (rc != CHANNEL_RC_OK)
2518 return CHANNEL_RC_OK;
2521static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2523 WINPR_ASSERT(settings);
2524 WINPR_ASSERT(value);
2528 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2531 ival = freerdp_map_keyboard_layout_name_to_id(value);
2535 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2536 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2537 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2544 rc = COMMAND_LINE_ERROR;
2549#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2552 WINPR_ASSERT(settings);
2556 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2558 return COMMAND_LINE_ERROR;
2560 if (option_equals(arg->Value,
"rfx"))
2563 return COMMAND_LINE_ERROR;
2565 else if (option_equals(arg->Value,
"nsc"))
2568 return COMMAND_LINE_ERROR;
2571#if defined(WITH_JPEG)
2572 else if (option_equals(arg->Value,
"jpeg"))
2575 return COMMAND_LINE_ERROR;
2580 return COMMAND_LINE_ERROR;
2589static BOOL check_kbd_remap_valid(
const char* token)
2594 WINPR_ASSERT(token);
2596 if (strlen(token) > 10)
2599 if (!freerdp_extract_key_value(token, &key, &value))
2601 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2609 WINPR_ASSERT(settings);
2613 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2615 return COMMAND_LINE_ERROR_MEMORY;
2616 char* p = strchr(arg->Value,
'[');
2621 const char scheme[] =
"://";
2622 const char* val = strstr(arg->Value, scheme);
2624 val += strnlen(scheme,
sizeof(scheme));
2627 p = strchr(val,
':');
2634 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2635 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2637 length = (size_t)(p - arg->Value);
2639 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2642 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2647 return COMMAND_LINE_ERROR_MEMORY;
2653 char* p2 = strchr(arg->Value,
']');
2657 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2659 length = (size_t)(p2 - p);
2661 return COMMAND_LINE_ERROR_MEMORY;
2663 if (*(p2 + 1) ==
':')
2667 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2668 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2671 return COMMAND_LINE_ERROR;
2674 printf(
"hostname %s port %" PRIu32
"\n",
2683 WINPR_ASSERT(settings);
2687 char* cur = arg->Value;
2689 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2695 char* next = strchr(cur,
',');
2703 if (option_equals(
"fqdn", cur))
2705 else if (option_equals(
"ip", cur))
2707 else if (option_equals(
"netbios", cur))
2710 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2713 mask = (mask & 0x07);
2714 value |= mask << (count * 3);
2716 }
while (cur !=
nullptr);
2719 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2722 return COMMAND_LINE_ERROR;
2727static int parse_prevent_session_lock_options(rdpSettings* settings,
2730 WINPR_ASSERT(settings);
2734 return COMMAND_LINE_ERROR_MEMORY;
2736 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2740 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2741 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2744 return COMMAND_LINE_ERROR_MEMORY;
2752 WINPR_ASSERT(settings);
2756 return COMMAND_LINE_ERROR;
2763 return COMMAND_LINE_ERROR;
2765 return COMMAND_LINE_ERROR;
2767 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2770 return COMMAND_LINE_ERROR;
2773 return COMMAND_LINE_ERROR_MEMORY;
2781 WINPR_ASSERT(settings);
2785 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2786 char* p = strchr(arg->Value,
'x');
2790 unsigned long w = 0;
2791 unsigned long h = 0;
2793 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2794 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2797 return COMMAND_LINE_ERROR;
2799 return COMMAND_LINE_ERROR;
2803 char* str = _strdup(arg->Value);
2805 return COMMAND_LINE_ERROR_MEMORY;
2807 p = strchr(str,
'%');
2811 BOOL partial = FALSE;
2813 status = COMMAND_LINE_ERROR;
2840 if (!value_to_int(str, &val, 0, 100))
2842 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2862 WINPR_ASSERT(settings);
2865 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2868 UINT32* MonitorIds =
nullptr;
2869 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2872 return COMMAND_LINE_ERROR_MEMORY;
2879 CommandLineParserFree(ptr);
2880 return COMMAND_LINE_ERROR;
2883 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
2884 for (UINT32 i = 0; i < count; i++)
2888 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
2889 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2891 MonitorIds[i] = (UINT32)val;
2894 CommandLineParserFree(ptr);
2900static int parse_dynamic_resolution_options(rdpSettings* settings,
2903 WINPR_ASSERT(settings);
2906 const BOOL val = arg->Value !=
nullptr;
2910 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2911 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2915 return COMMAND_LINE_ERROR;
2917 return COMMAND_LINE_ERROR;
2924 WINPR_ASSERT(settings);
2928 const char* size =
nullptr;
2930 switch (parse_on_off_argument(arg))
2942 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2947 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2948 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2952 return COMMAND_LINE_ERROR;
2956 unsigned long w = 0;
2957 unsigned long h = 0;
2959 if (!parseSizeValue(size, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2960 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2963 return COMMAND_LINE_ERROR;
2965 return COMMAND_LINE_ERROR;
2972 WINPR_ASSERT(settings);
2977 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
2978 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2988 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2992 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2999 WINPR_ASSERT(settings);
3002 int rc = CHANNEL_RC_OK;
3004 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3005 if (!ptr || (count == 0))
3006 rc = COMMAND_LINE_ERROR;
3009 for (
size_t x = 0; x < count; x++)
3011 const char* val = ptr[x];
3013 if (option_starts_with(
"remap:", val))
3016 char* now = _strdup(&val[6]);
3021 if (!check_kbd_remap_valid(now))
3022 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3025 const size_t olen = strlen(old);
3026 const size_t alen = strlen(now);
3027 const size_t tlen = olen + alen + 2;
3028 char* tmp = calloc(tlen,
sizeof(
char));
3030 rc = COMMAND_LINE_ERROR_MEMORY;
3032 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
3040 rc = COMMAND_LINE_ERROR;
3044 else if (option_starts_with(
"layout:", val))
3046 rc = parse_kbd_layout(settings, &val[7]);
3048 else if (option_starts_with(
"lang:", val))
3051 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3053 ival = freerdp_get_locale_id_from_string(&val[5]);
3056 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3059 rc = COMMAND_LINE_ERROR;
3061 else if (option_starts_with(
"type:", val))
3064 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3066 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3068 rc = COMMAND_LINE_ERROR;
3070 else if (option_starts_with(
"subtype:", val))
3073 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
3075 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3078 rc = COMMAND_LINE_ERROR;
3080 else if (option_starts_with(
"fn-key:", val))
3083 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
3085 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3088 rc = COMMAND_LINE_ERROR;
3090 else if (option_starts_with(
"unicode", val))
3092 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3093 if (bval == PARSE_FAIL)
3094 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3097 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3099 else if (option_starts_with(
"pipe:", val))
3102 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3104 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3106#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3107 else if (count == 1)
3110 rc = parse_kbd_layout(settings, val);
3114 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3120 CommandLineParserFree(ptr);
3126 WINPR_ASSERT(settings);
3131 return COMMAND_LINE_ERROR_MEMORY;
3133 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3135 const char* cur = arg->Value;
3138 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3140 if (!proxy_parse_uri(settings, cur))
3141 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3145 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3146 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3153 WINPR_ASSERT(settings);
3156 BOOL failed = FALSE;
3158 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3163 BOOL modernsyntax = FALSE;
3164 BOOL oldsyntax = FALSE;
3165 for (
size_t x = 0; (x < count) && !failed; x++)
3167 const char* carg = ptr[x];
3168 if (option_starts_with(
"file:", carg))
3170 const char* val = &carg[5];
3175 modernsyntax = TRUE;
3177 else if (option_equals(
"replay", carg))
3184 else if (option_equals(
"record", carg))
3191 else if (option_equals(
"nodelay", carg))
3198 modernsyntax = TRUE;
3213 if (oldsyntax && (count != 2))
3216 CommandLineParserFree(ptr);
3218 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3224 WINPR_ASSERT(settings);
3227 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3230 (arg->Value == BoolValueTrue)))
3231 return COMMAND_LINE_ERROR;
3237 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3238 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3240 const char* usesel =
"use-selection:";
3242 const char* cur = ptr[x];
3243 if (option_starts_with(usesel, cur))
3245 const char* val = &cur[strlen(usesel)];
3247 rc = COMMAND_LINE_ERROR_MEMORY;
3249 return COMMAND_LINE_ERROR;
3251 else if (option_starts_with(
"direction-to", cur))
3255 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3256 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3260 case CLIP_DIR_PARSE_ALL:
3261 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3263 case CLIP_DIR_PARSE_LOCAL:
3264 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3266 case CLIP_DIR_PARSE_REMOTE:
3267 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3269 case CLIP_DIR_PARSE_OFF:
3271 case CLIP_DIR_PARSE_FAIL:
3273 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3279 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3281 else if (option_starts_with(
"files-to", cur))
3285 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3286 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3287 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3291 case CLIP_DIR_PARSE_ALL:
3293 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3295 case CLIP_DIR_PARSE_LOCAL:
3296 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3298 case CLIP_DIR_PARSE_REMOTE:
3299 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3301 case CLIP_DIR_PARSE_OFF:
3303 case CLIP_DIR_PARSE_FAIL:
3305 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3311 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3314 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3316 CommandLineParserFree(ptr);
3326 WINPR_ASSERT(settings);
3331 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3333 if (strcmp(arg->Value,
"none") == 0)
3334 val = AUDIO_MODE_NONE;
3335 else if (strcmp(arg->Value,
"redirect") == 0)
3336 val = AUDIO_MODE_REDIRECT;
3337 else if (strcmp(arg->Value,
"server") == 0)
3338 val = AUDIO_MODE_PLAY_ON_SERVER;
3339 else if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3340 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3344 case AUDIO_MODE_REDIRECT:
3346 return COMMAND_LINE_ERROR;
3349 case AUDIO_MODE_PLAY_ON_SERVER:
3351 return COMMAND_LINE_ERROR;
3354 case AUDIO_MODE_NONE:
3356 return COMMAND_LINE_ERROR;
3358 return COMMAND_LINE_ERROR;
3362 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3369 WINPR_ASSERT(settings);
3372 UINT32 type = CONNECTION_TYPE_INVALID;
3374 if (option_equals(arg->Value,
"invalid"))
3375 type = CONNECTION_TYPE_INVALID;
3376 else if (option_equals(arg->Value,
"modem"))
3377 type = CONNECTION_TYPE_MODEM;
3378 else if (option_equals(arg->Value,
"broadband"))
3379 type = CONNECTION_TYPE_BROADBAND_HIGH;
3380 else if (option_equals(arg->Value,
"broadband-low"))
3381 type = CONNECTION_TYPE_BROADBAND_LOW;
3382 else if (option_equals(arg->Value,
"broadband-high"))
3383 type = CONNECTION_TYPE_BROADBAND_HIGH;
3384 else if (option_equals(arg->Value,
"wan"))
3385 type = CONNECTION_TYPE_WAN;
3386 else if (option_equals(arg->Value,
"lan"))
3387 type = CONNECTION_TYPE_LAN;
3388 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3389 (option_equals(arg->Value,
"detect")))
3391 type = CONNECTION_TYPE_AUTODETECT;
3397 if (!value_to_int(arg->Value, &val, 0, 7))
3398 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3403 if (!freerdp_set_connection_type(settings, type))
3404 return COMMAND_LINE_ERROR;
3410 WINPR_ASSERT(settings);
3414 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3416 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3418 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3419 for (
size_t x = 0; x < count; x++)
3421 const char* cur = ptr[x];
3422 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3423 if (bval == PARSE_FAIL)
3425 CommandLineParserFree(ptr);
3426 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3429 const BOOL val = bval != PARSE_OFF;
3430 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3431 if (option_starts_with(
"rdp", cur))
3433 id = FreeRDP_RdpSecurity;
3435 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3437 else if (option_starts_with(
"tls", cur))
3438 id = FreeRDP_TlsSecurity;
3439 else if (option_starts_with(
"nla", cur))
3440 id = FreeRDP_NlaSecurity;
3441 else if (option_starts_with(
"ext", cur))
3442 id = FreeRDP_ExtSecurity;
3443 else if (option_equals(
"aad", cur))
3444 id = FreeRDP_AadSecurity;
3447 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3448 CommandLineParserFree(ptr);
3449 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3452 if ((bval == PARSE_NONE) && (count == 1))
3453 singleOptionWithoutOnOff = id;
3455 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3458 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3460 const FreeRDP_Settings_Keys_Bool options[] = { FreeRDP_AadSecurity,
3461 FreeRDP_UseRdpSecurityLayer,
3462 FreeRDP_RdpSecurity, FreeRDP_NlaSecurity,
3463 FreeRDP_TlsSecurity };
3465 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3468 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3472 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3473 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3476 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3479 CommandLineParserFree(ptr);
3483static int parse_encryption_methods_options(rdpSettings* settings,
3486 WINPR_ASSERT(settings);
3489 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3492 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3494 UINT32 EncryptionMethods = 0;
3495 for (UINT32 i = 0; i < count; i++)
3497 if (option_equals(ptr[i],
"40"))
3498 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3499 else if (option_equals(ptr[i],
"56"))
3500 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3501 else if (option_equals(ptr[i],
"128"))
3502 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3503 else if (option_equals(ptr[i],
"FIPS"))
3504 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3506 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3510 return COMMAND_LINE_ERROR;
3511 CommandLineParserFree(ptr);
3518 WINPR_ASSERT(settings);
3523 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3524 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3526 const char deny[] =
"deny";
3527 const char ignore[] =
"ignore";
3528 const char tofu[] =
"tofu";
3529 const char name[] =
"name:";
3530 const char fingerprints[] =
"fingerprint:";
3532 const char* cur = ptr[x];
3533 if (option_equals(deny, cur))
3536 return COMMAND_LINE_ERROR;
3538 else if (option_equals(ignore, cur))
3541 return COMMAND_LINE_ERROR;
3543 else if (option_equals(tofu, cur))
3546 return COMMAND_LINE_ERROR;
3548 else if (option_starts_with(name, cur))
3550 const char* val = &cur[strnlen(name,
sizeof(name))];
3552 rc = COMMAND_LINE_ERROR_MEMORY;
3554 else if (option_starts_with(fingerprints, cur))
3556 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3559 rc = COMMAND_LINE_ERROR_MEMORY;
3562 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3564 CommandLineParserFree(ptr);
3571 WINPR_ASSERT(settings);
3575 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3579 for (
size_t x = 1; x < count; x++)
3581 const char* cur = ptr[x];
3583 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3584 if (bval == PARSE_FAIL)
3585 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3588 const BOOL val = bval != PARSE_OFF;
3590 if (option_starts_with(
"relative", cur))
3593 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3595 else if (option_starts_with(
"grab", cur))
3598 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3606 CommandLineParserFree(ptr);
3613 WINPR_ASSERT(settings);
3617 UINT32 Floatbar = 0x0017;
3621 char* start = arg->Value;
3626 start = strchr(start,
',');
3635 if (option_starts_with(
"sticky:", cur))
3639 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3651 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3655 else if (option_starts_with(
"default:", cur))
3657 const char* val = cur + 8;
3660 if (option_equals(
"visible", val))
3662 else if (option_equals(
"hidden", val))
3665 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3668 else if (option_starts_with(
"show:", cur))
3670 const char* val = cur + 5;
3673 if (option_equals(
"always", val))
3675 else if (option_equals(
"fullscreen", val))
3677 else if (option_equals(
"window", val))
3680 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3683 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3687 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3693 WINPR_ASSERT(settings);
3696 BYTE* base64 =
nullptr;
3699 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3701 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3707 return COMMAND_LINE_ERROR;
3711 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3718static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3720 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3728 WINPR_ASSERT(settings);
3733 if (!value_to_int(arg->Value, &val, 100, 180))
3734 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3742 return COMMAND_LINE_ERROR;
3744 return COMMAND_LINE_ERROR;
3745 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3746 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3747 return fail_at(arg, COMMAND_LINE_ERROR);
3751 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3758 WINPR_ASSERT(settings);
3763 if (!value_to_int(arg->Value, &val, 100, 180))
3764 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3772 return COMMAND_LINE_ERROR;
3773 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3774 return fail_at(arg, COMMAND_LINE_ERROR);
3778 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3785 WINPR_ASSERT(settings);
3791 return COMMAND_LINE_ERROR;
3793 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3796 const CmdLineSubOptions opts[] = {
3797 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3798 setSmartcardEmulation },
3799 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3800 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING,
nullptr },
3801 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING,
nullptr },
3802 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING,
nullptr },
3803 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING,
nullptr },
3804 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING,
nullptr }
3807 for (
size_t x = 1; x < count; x++)
3809 const char* cur = ptr[x];
3810 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
3812 CommandLineParserFree(ptr);
3813 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3817 CommandLineParserFree(ptr);
3823 WINPR_ASSERT(settings);
3827 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
3829 return COMMAND_LINE_ERROR;
3830 for (
size_t x = 1; x < count; x++)
3832 const char* cur = ptr[x];
3833 char* sep = strchr(cur,
':');
3836 CommandLineParserFree(ptr);
3837 return COMMAND_LINE_ERROR;
3840 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
3842 CommandLineParserFree(ptr);
3843 return COMMAND_LINE_ERROR;
3847 CommandLineParserFree(ptr);
3851static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
3853 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
3854 FreeRDP_RemoteAppLanguageBarSupported,
3855 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
3856 FreeRDP_DisableFullWindowDrag };
3859 return COMMAND_LINE_ERROR_MEMORY;
3861 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
3864 return COMMAND_LINE_ERROR;
3866 return CHANNEL_RC_OK;
3871 WINPR_ASSERT(settings);
3874 int rc = CHANNEL_RC_OK;
3876 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3877 if (!ptr || (count == 0))
3878 rc = COMMAND_LINE_ERROR;
3885 int (*fkt)(rdpSettings* settings,
const char* value);
3887 const struct app_map amap[] = {
3888 {
"tenantid:", FreeRDP_GatewayAvdAadtenantid,
nullptr },
3889 {
"ad:", FreeRDP_GatewayAzureActiveDirectory,
nullptr },
3890 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat,
nullptr },
3891 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat,
nullptr },
3892 {
"avd-scope:", FreeRDP_GatewayAvdScope,
nullptr }
3895 for (
size_t x = 0; x < count; x++)
3897 BOOL handled = FALSE;
3898 const char* val = ptr[x];
3900 if (option_starts_with(
"use-tenantid", val))
3902 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3903 if (bval == PARSE_FAIL)
3905 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3913 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3919 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3921 const struct app_map* cur = &amap[y];
3922 if (option_starts_with(cur->name, val))
3924 const char* xval = &val[strlen(cur->name)];
3926 rc = cur->fkt(settings, xval);
3930 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3931 rc = COMMAND_LINE_ERROR_MEMORY;
3940 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3947 CommandLineParserFree(ptr);
3953 WINPR_ASSERT(settings);
3956 int rc = CHANNEL_RC_OK;
3958 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3959 if (!ptr || (count == 0))
3960 rc = COMMAND_LINE_ERROR;
3967 int (*fkt)(rdpSettings* settings,
const char* value);
3969 const struct app_map amap[] = {
3970 {
"program:", FreeRDP_RemoteApplicationProgram, parse_app_option_program },
3971 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir,
nullptr },
3972 {
"name:", FreeRDP_RemoteApplicationName,
nullptr },
3973 {
"icon:", FreeRDP_RemoteApplicationIcon,
nullptr },
3974 {
"cmd:", FreeRDP_RemoteApplicationCmdLine,
nullptr },
3975 {
"file:", FreeRDP_RemoteApplicationFile,
nullptr },
3976 {
"guid:", FreeRDP_RemoteApplicationGuid,
nullptr },
3977 {
"hidef:", FreeRDP_HiDefRemoteApp,
nullptr }
3979 for (
size_t x = 0; x < count; x++)
3981 BOOL handled = FALSE;
3982 const char* val = ptr[x];
3984 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3986 const struct app_map* cur = &amap[y];
3987 if (option_starts_with(cur->name, val))
3989 const char* xval = &val[strlen(cur->name)];
3991 rc = cur->fkt(settings, xval);
3995 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3996 rc = COMMAND_LINE_ERROR_MEMORY;
4004#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4005 if (!handled && (count == 1))
4008 rc = parse_app_option_program(settings, val);
4013 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4020 CommandLineParserFree(ptr);
4026 WINPR_ASSERT(settings);
4029 int rc = CHANNEL_RC_OK;
4031 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4032 if (!ptr || (count == 0))
4033 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4035 for (
size_t x = 0; x < count; x++)
4037 const char* val = ptr[x];
4039 if (option_starts_with(
"codec:", val))
4042 rc = COMMAND_LINE_ERROR;
4043 else if (option_equals(arg->Value,
"rfx"))
4046 rc = COMMAND_LINE_ERROR;
4048 else if (option_equals(arg->Value,
"nsc"))
4051 rc = COMMAND_LINE_ERROR;
4054#if defined(WITH_JPEG)
4055 else if (option_equals(arg->Value,
"jpeg"))
4058 rc = COMMAND_LINE_ERROR;
4063 return COMMAND_LINE_ERROR;
4069 else if (option_starts_with(
"persist-file:", val))
4073 rc = COMMAND_LINE_ERROR_MEMORY;
4075 rc = COMMAND_LINE_ERROR;
4079 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
4080 if (bval == PARSE_FAIL)
4081 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4084 if (option_starts_with(
"bitmap", val))
4088 rc = COMMAND_LINE_ERROR;
4090 else if (option_starts_with(
"glyph", val))
4093 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
4094 : GLYPH_SUPPORT_NONE))
4095 rc = COMMAND_LINE_ERROR;
4097 else if (option_starts_with(
"persist", val))
4101 rc = COMMAND_LINE_ERROR;
4103 else if (option_starts_with(
"offscreen", val))
4107 rc = COMMAND_LINE_ERROR;
4113 CommandLineParserFree(ptr);
4117static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
4119 WINPR_ASSERT(settings);
4122 char* name =
nullptr;
4124 if (!freerdp_parse_hostname(host, &name, &port))
4143static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
4144 FreeRDP_Settings_Keys_String what)
4146 WINPR_ASSERT(settings);
4147 WINPR_ASSERT(value);
4151 case FreeRDP_GatewayUsername:
4152 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4153 FreeRDP_GatewayDomain))
4165static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4169 WINPR_ASSERT(settings);
4170 WINPR_ASSERT(value);
4172 if (option_equals(value,
"rpc"))
4183 if (option_equals(value,
"http"))
4191 else if (option_equals(value,
"auto"))
4199 else if (option_equals(value,
"arm"))
4212static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4216 WINPR_ASSERT(settings);
4217 WINPR_ASSERT(value);
4219 if (option_equals(value,
"none"))
4220 type = TSC_PROXY_MODE_NONE_DIRECT;
4221 else if (option_equals(value,
"direct"))
4222 type = TSC_PROXY_MODE_DIRECT;
4223 else if (option_equals(value,
"detect"))
4224 type = TSC_PROXY_MODE_DETECT;
4225 else if (option_equals(value,
"default"))
4226 type = TSC_PROXY_MODE_DEFAULT;
4231 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4233 type = WINPR_ASSERTING_INT_CAST(UINT32, val);
4239static char* unescape(
const char* str)
4241 char* copy = _strdup(str);
4245 bool escaped =
false;
4247 while (*str !=
'\0')
4275 char* argval =
nullptr;
4278 WINPR_ASSERT(settings);
4282 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4291 BOOL allowHttpOpts = FALSE;
4292 for (
size_t x = 0; x < count; x++)
4294 BOOL validOption = FALSE;
4296 argval = unescape(ptr[x]);
4300 const char* gw = option_starts_with(
"g:", argval);
4303 if (!parse_gateway_host_option(settings, gw))
4306 allowHttpOpts = FALSE;
4309 const char* gu = option_starts_with(
"u:", argval);
4312 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4315 allowHttpOpts = FALSE;
4318 const char* gd = option_starts_with(
"d:", argval);
4321 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4324 allowHttpOpts = FALSE;
4327 const char* gp = option_starts_with(
"p:", argval);
4330 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4333 allowHttpOpts = FALSE;
4336 const char* gt = option_starts_with(
"type:", argval);
4339 if (!parse_gateway_type_option(settings, gt))
4345 const char* gat = option_starts_with(
"access-token:", argval);
4351 allowHttpOpts = FALSE;
4354 const char* bearer = option_starts_with(
"bearer:", argval);
4361 allowHttpOpts = FALSE;
4364 const char* gwurl = option_starts_with(
"url:", argval);
4372 allowHttpOpts = FALSE;
4375 const char* um = option_starts_with(
"usage-method:", argval);
4378 if (!parse_gateway_usage_option(settings, um))
4381 allowHttpOpts = FALSE;
4384 const char* to = option_starts_with(
"timeout:", argval);
4388 if (!value_to_int(to, &val, 1, 600000))
4394 allowHttpOpts = FALSE;
4399 if (option_equals(argval,
"no-websockets"))
4406 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4423 CommandLineParserFree(ptr);
4430 WINPR_ASSERT(value);
4436 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4437 FillMemory(arg->Value, strlen(arg->Value),
'*');
4442 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4444 const char* cred = credential_args[x];
4445 fill_credential_string(args, cred);
4449 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4451 const char* gwcreds[] = {
"p:",
"access-token:" };
4452 char* saveptr =
nullptr;
4453 char* tok = strtok_s(arg->Value,
",", &saveptr);
4456 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4458 const char* opt = gwcreds[x];
4459 if (option_starts_with(opt, tok))
4461 char* val = &tok[strlen(opt)];
4462 FillMemory(val, strlen(val),
'*');
4465 tok = strtok_s(
nullptr,
",", &saveptr);
4470static int parse_command_line_option_uint32(rdpSettings* settings,
4472 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4477 if (!value_to_int(arg->Value, &val, min, max))
4478 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4481 return fail_at(arg, COMMAND_LINE_ERROR);
4485#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4490 WINPR_ASSERT(settings);
4493 BOOL enable = arg->Value ? TRUE : FALSE;
4494 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4496 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4498 return fail_at(arg, COMMAND_LINE_ERROR);
4503 return fail_at(arg, COMMAND_LINE_ERROR);
4507 return fail_at(arg, COMMAND_LINE_ERROR);
4509 CommandLineSwitchCase(arg,
"gfx-small-cache")
4511 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4513 return fail_at(arg, COMMAND_LINE_ERROR);
4517 return fail_at(arg, COMMAND_LINE_ERROR);
4519 CommandLineSwitchCase(arg,
"gfx-progressive")
4521 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4523 return fail_at(arg, COMMAND_LINE_ERROR);
4525 return fail_at(arg, COMMAND_LINE_ERROR);
4530 return fail_at(arg, COMMAND_LINE_ERROR);
4534 CommandLineSwitchCase(arg,
"gfx-h264")
4536 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4537 int rc = parse_gfx_options(settings, arg);
4539 return fail_at(arg, rc);
4542 CommandLineSwitchCase(arg,
"app-workdir")
4545 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4547 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4549 CommandLineSwitchCase(arg,
"app-name")
4551 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4553 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4555 CommandLineSwitchCase(arg,
"app-icon")
4557 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4559 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4561 CommandLineSwitchCase(arg,
"app-cmd")
4563 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4565 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4567 CommandLineSwitchCase(arg,
"app-file")
4569 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4571 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4573 CommandLineSwitchCase(arg,
"app-guid")
4575 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4577 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4579 CommandLineSwitchCase(arg,
"g")
4581 if (!parse_gateway_host_option(settings, arg->Value))
4582 return fail_at(arg, COMMAND_LINE_ERROR);
4584 CommandLineSwitchCase(arg,
"gu")
4586 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4587 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4589 CommandLineSwitchCase(arg,
"gd")
4591 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4592 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4594 CommandLineSwitchCase(arg,
"gp")
4596 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4597 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4599 CommandLineSwitchCase(arg,
"gt")
4601 if (!parse_gateway_type_option(settings, arg->Value))
4602 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4604 CommandLineSwitchCase(arg,
"gat")
4607 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4609 CommandLineSwitchCase(arg,
"gateway-usage-method")
4611 if (!parse_gateway_usage_option(settings, arg->Value))
4612 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4614 CommandLineSwitchCase(arg,
"kbd-remap")
4616 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4617 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4619 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4621 CommandLineSwitchCase(arg,
"kbd-lang")
4625 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4626 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4628 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4629 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4630 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4634 return fail_at(arg, COMMAND_LINE_ERROR);
4636 CommandLineSwitchCase(arg,
"kbd-type")
4638 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4640 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4642 return fail_at(arg, rc);
4644 CommandLineSwitchCase(arg,
"kbd-unicode")
4646 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4648 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4650 CommandLineSwitchCase(arg,
"kbd-subtype")
4652 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4654 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4656 return fail_at(arg, rc);
4658 CommandLineSwitchCase(arg,
"kbd-fn-key")
4660 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4661 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4664 return fail_at(arg, rc);
4666 CommandLineSwitchCase(arg,
"bitmap-cache")
4668 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4670 return fail_at(arg, COMMAND_LINE_ERROR);
4672 CommandLineSwitchCase(arg,
"persist-cache")
4674 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4676 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4678 CommandLineSwitchCase(arg,
"persist-cache-file")
4680 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4681 "/cache:persist-file:<filename> instead");
4683 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4686 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4688 CommandLineSwitchCase(arg,
"offscreen-cache")
4690 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4692 return fail_at(arg, COMMAND_LINE_ERROR);
4694 CommandLineSwitchCase(arg,
"glyph-cache")
4696 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4698 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4699 return fail_at(arg, COMMAND_LINE_ERROR);
4701 CommandLineSwitchCase(arg,
"codec-cache")
4703 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4704 const int rc = parse_codec_cache_options(settings, arg);
4706 return fail_at(arg, rc);
4708 CommandLineSwitchCase(arg,
"sec-rdp")
4710 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4712 return fail_at(arg, COMMAND_LINE_ERROR);
4714 CommandLineSwitchCase(arg,
"sec-tls")
4716 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4718 return fail_at(arg, COMMAND_LINE_ERROR);
4720 CommandLineSwitchCase(arg,
"sec-nla")
4722 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4724 return fail_at(arg, COMMAND_LINE_ERROR);
4726 CommandLineSwitchCase(arg,
"sec-ext")
4728 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4730 return fail_at(arg, COMMAND_LINE_ERROR);
4732 CommandLineSwitchCase(arg,
"tls-ciphers")
4734 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4735 "/tls:ciphers:<cipher list> instead");
4736 int rc = parse_tls_cipher_options(settings, arg);
4738 return fail_at(arg, rc);
4740 CommandLineSwitchCase(arg,
"tls-seclevel")
4742 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4743 int rc = parse_tls_cipher_options(settings, arg);
4745 return fail_at(arg, rc);
4747 CommandLineSwitchCase(arg,
"tls-secrets-file")
4749 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4750 "/tls:secrets-file:<filename> instead");
4751 int rc = parse_tls_cipher_options(settings, arg);
4753 return fail_at(arg, rc);
4755 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4757 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4758 int rc = parse_tls_cipher_options(settings, arg);
4760 return fail_at(arg, rc);
4762 CommandLineSwitchCase(arg,
"cert-name")
4764 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4766 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4768 CommandLineSwitchCase(arg,
"cert-ignore")
4770 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4772 return fail_at(arg, COMMAND_LINE_ERROR);
4774 CommandLineSwitchCase(arg,
"cert-tofu")
4776 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4778 return fail_at(arg, COMMAND_LINE_ERROR);
4780 CommandLineSwitchCase(arg,
"cert-deny")
4782 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4784 return fail_at(arg, COMMAND_LINE_ERROR);
4786 CommandLineSwitchDefault(arg)
4790 CommandLineSwitchEnd(arg);
4795static int parse_command_line_option_timezone(rdpSettings* settings,
4801 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
4802 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
4804 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
4805 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
4807 WINPR_ASSERT(arg->Value);
4808 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
4815 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4818 return fail_at(arg, COMMAND_LINE_ERROR);
4823 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4825 tz->Bias = info.Bias;
4826 tz->DaylightBias = info.DaylightBias;
4827 tz->DaylightDate = info.DaylightDate;
4828 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
4829 tz->StandardBias = info.StandardBias;
4830 tz->StandardDate = info.StandardDate;
4831 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
4836static int parse_command_line_option_window_pos(rdpSettings* settings,
4839 WINPR_ASSERT(settings);
4842 unsigned long x = 0;
4843 unsigned long y = 0;
4846 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4848 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
4850 WLog_ERR(TAG,
"invalid window-position argument");
4851 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4855 return fail_at(arg, COMMAND_LINE_ERROR);
4857 return fail_at(arg, COMMAND_LINE_ERROR);
4862 freerdp_command_line_handle_option_t handle_option,
4863 void* handle_userdata, BOOL* promptForPassword,
char** user)
4865 WINPR_ASSERT(promptForPassword);
4870 BOOL enable = (arg->Value !=
nullptr);
4872 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
4875 CommandLineSwitchStart(arg)
4877 CommandLineSwitchCase(arg,
"v")
4879 const int rc = parse_host_options(settings, arg);
4881 return fail_at(arg, rc);
4883 CommandLineSwitchCase(arg,
"spn-class")
4887 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4889 CommandLineSwitchCase(arg,
"sspi-module")
4892 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4894 CommandLineSwitchCase(arg,
"winscard-module")
4897 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4899 CommandLineSwitchCase(arg,
"redirect-prefer")
4901 const int rc = parse_redirect_prefer_options(settings, arg);
4903 return fail_at(arg, rc);
4905 CommandLineSwitchCase(arg,
"credentials-delegation")
4908 return fail_at(arg, COMMAND_LINE_ERROR);
4910 CommandLineSwitchCase(arg,
"prevent-session-lock")
4912 const int rc = parse_prevent_session_lock_options(settings, arg);
4914 return fail_at(arg, rc);
4916 CommandLineSwitchCase(arg,
"vmconnect")
4918 const int rc = parse_vmconnect_options(settings, arg);
4920 return fail_at(arg, rc);
4922 CommandLineSwitchCase(arg,
"w")
4924 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
4927 return fail_at(arg, rc);
4929 CommandLineSwitchCase(arg,
"h")
4931 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
4934 return fail_at(arg, rc);
4936 CommandLineSwitchCase(arg,
"size")
4938 const int rc = parse_size_options(settings, arg);
4940 return fail_at(arg, rc);
4942 CommandLineSwitchCase(arg,
"f")
4945 return fail_at(arg, COMMAND_LINE_ERROR);
4947 CommandLineSwitchCase(arg,
"suppress-output")
4950 return fail_at(arg, COMMAND_LINE_ERROR);
4952 CommandLineSwitchCase(arg,
"multimon")
4954 switch (parse_on_off_argument(arg))
4958 return fail_at(arg, COMMAND_LINE_ERROR);
4962 return fail_at(arg, COMMAND_LINE_ERROR);
4964 return fail_at(arg, COMMAND_LINE_ERROR);
4967 if (!option_equals(arg->Value, str_force))
4968 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4970 return fail_at(arg, COMMAND_LINE_ERROR);
4972 return fail_at(arg, COMMAND_LINE_ERROR);
4976 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4979 CommandLineSwitchCase(arg,
"span")
4982 return fail_at(arg, COMMAND_LINE_ERROR);
4984 CommandLineSwitchCase(arg,
"workarea")
4987 return fail_at(arg, COMMAND_LINE_ERROR);
4989 CommandLineSwitchCase(arg,
"monitors")
4991 const int rc = parse_monitors_options(settings, arg);
4993 return fail_at(arg, rc);
4995 CommandLineSwitchCase(arg,
"t")
4998 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5000 CommandLineSwitchCase(arg,
"decorations")
5003 return fail_at(arg, COMMAND_LINE_ERROR);
5005 CommandLineSwitchCase(arg,
"dynamic-resolution")
5007 const int rc = parse_dynamic_resolution_options(settings, arg);
5009 return fail_at(arg, rc);
5011 CommandLineSwitchCase(arg,
"smart-sizing")
5013 const int rc = parse_smart_sizing_options(settings, arg);
5015 return fail_at(arg, rc);
5017 CommandLineSwitchCase(arg,
"bpp")
5019 const int rc = parse_bpp_options(settings, arg);
5021 return fail_at(arg, rc);
5023 CommandLineSwitchCase(arg,
"admin")
5026 return fail_at(arg, COMMAND_LINE_ERROR);
5028 CommandLineSwitchCase(arg,
"relax-order-checks")
5032 return fail_at(arg, COMMAND_LINE_ERROR);
5034 CommandLineSwitchCase(arg,
"restricted-admin")
5037 return fail_at(arg, COMMAND_LINE_ERROR);
5039 return fail_at(arg, COMMAND_LINE_ERROR);
5041#ifdef CHANNEL_RDPEAR_CLIENT
5042 CommandLineSwitchCase(arg,
"remoteGuard")
5045 return fail_at(arg, COMMAND_LINE_ERROR);
5047 return fail_at(arg, COMMAND_LINE_ERROR);
5050 CommandLineSwitchCase(arg,
"pth")
5053 return fail_at(arg, COMMAND_LINE_ERROR);
5055 return fail_at(arg, COMMAND_LINE_ERROR);
5058 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5060 CommandLineSwitchCase(arg,
"client-hostname")
5063 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5065 CommandLineSwitchCase(arg,
"kbd")
5067 int rc = parse_kbd_options(settings, arg);
5069 return fail_at(arg, rc);
5072 CommandLineSwitchCase(arg,
"u")
5074 WINPR_ASSERT(arg->Value);
5077 CommandLineSwitchCase(arg,
"d")
5080 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5082 CommandLineSwitchCase(arg,
"p")
5086 const char* val = arg->Value;
5091 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5093 CommandLineSwitchCase(arg,
"gateway")
5095 if (!parse_gateway_options(settings, arg))
5096 return fail_at(arg, COMMAND_LINE_ERROR);
5098 CommandLineSwitchCase(arg,
"proxy")
5100 const int rc = parse_proxy_options(settings, arg);
5102 return fail_at(arg, rc);
5105 CommandLineSwitchCase(arg,
"azure")
5107 int rc = parse_aad_options(settings, arg);
5109 return fail_at(arg, rc);
5111 CommandLineSwitchCase(arg,
"app")
5113 int rc = parse_app_options(settings, arg);
5115 return fail_at(arg, rc);
5117 CommandLineSwitchCase(arg,
"load-balance-info")
5119 WINPR_ASSERT(arg->Value);
5121 strlen(arg->Value)))
5122 return fail_at(arg, COMMAND_LINE_ERROR);
5125 CommandLineSwitchCase(arg,
"compression")
5128 return fail_at(arg, COMMAND_LINE_ERROR);
5130 CommandLineSwitchCase(arg,
"compression-level")
5132 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
5135 return fail_at(arg, rc);
5137 CommandLineSwitchCase(arg,
"drives")
5140 return fail_at(arg, COMMAND_LINE_ERROR);
5142 CommandLineSwitchCase(arg,
"dump")
5144 const int rc = parse_dump_options(settings, arg);
5146 return fail_at(arg, rc);
5148 CommandLineSwitchCase(arg,
"disable-output")
5151 return fail_at(arg, COMMAND_LINE_ERROR);
5153 CommandLineSwitchCase(arg,
"home-drive")
5156 return fail_at(arg, COMMAND_LINE_ERROR);
5158 CommandLineSwitchCase(arg,
"ipv4")
5160 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5163 return fail_at(arg, COMMAND_LINE_ERROR);
5168 return fail_at(arg, COMMAND_LINE_ERROR);
5171 CommandLineSwitchCase(arg,
"ipv6")
5173 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5176 return fail_at(arg, COMMAND_LINE_ERROR);
5181 return fail_at(arg, COMMAND_LINE_ERROR);
5184 CommandLineSwitchCase(arg,
"clipboard")
5186 const int rc = parse_clipboard_options(settings, arg);
5188 return fail_at(arg, rc);
5190 CommandLineSwitchCase(arg,
"server-name")
5193 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5195 CommandLineSwitchCase(arg,
"shell")
5198 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5200 CommandLineSwitchCase(arg,
"shell-dir")
5203 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5205 CommandLineSwitchCase(arg,
"audio-mode")
5207 const int rc = parse_audio_mode_options(settings, arg);
5209 return fail_at(arg, rc);
5211 CommandLineSwitchCase(arg,
"network")
5213 const int rc = parse_network_options(settings, arg);
5215 return fail_at(arg, rc);
5217 CommandLineSwitchCase(arg,
"fonts")
5220 return fail_at(arg, COMMAND_LINE_ERROR);
5222 CommandLineSwitchCase(arg,
"wallpaper")
5225 return fail_at(arg, COMMAND_LINE_ERROR);
5227 CommandLineSwitchCase(arg,
"window-drag")
5230 return fail_at(arg, COMMAND_LINE_ERROR);
5232 CommandLineSwitchCase(arg,
"window-position")
5234 const int rc = parse_command_line_option_window_pos(settings, arg);
5236 return fail_at(arg, rc);
5238 CommandLineSwitchCase(arg,
"menu-anims")
5241 return fail_at(arg, COMMAND_LINE_ERROR);
5243 CommandLineSwitchCase(arg,
"themes")
5246 return fail_at(arg, COMMAND_LINE_ERROR);
5248 CommandLineSwitchCase(arg,
"timeout")
5251 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5253 return fail_at(arg, rc);
5254 const int rc2 = parse_command_line_option_uint32(settings, arg,
5255 FreeRDP_TcpConnectTimeout, 0, 600000);
5257 return fail_at(arg, rc2);
5259 CommandLineSwitchCase(arg,
"timezone")
5261 const int rc = parse_command_line_option_timezone(settings, arg);
5263 return fail_at(arg, rc);
5265 CommandLineSwitchCase(arg,
"aero")
5268 return fail_at(arg, COMMAND_LINE_ERROR);
5270 CommandLineSwitchCase(arg,
"gdi")
5272 if (option_equals(arg->Value,
"sw"))
5275 return fail_at(arg, COMMAND_LINE_ERROR);
5277 else if (option_equals(arg->Value,
"hw"))
5280 return fail_at(arg, COMMAND_LINE_ERROR);
5283 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5285 CommandLineSwitchCase(arg,
"gfx")
5287 int rc = parse_gfx_options(settings, arg);
5289 return fail_at(arg, rc);
5292 CommandLineSwitchCase(arg,
"rfx")
5295 return fail_at(arg, COMMAND_LINE_ERROR);
5297 CommandLineSwitchCase(arg,
"rfx-mode")
5300 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5302 if (option_equals(arg->Value,
"video"))
5305 return fail_at(arg, COMMAND_LINE_ERROR);
5307 else if (option_equals(arg->Value,
"image"))
5310 return fail_at(arg, COMMAND_LINE_ERROR);
5312 return fail_at(arg, COMMAND_LINE_ERROR);
5315 CommandLineSwitchCase(arg,
"frame-ack")
5317 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5320 return fail_at(arg, rc);
5322 CommandLineSwitchCase(arg,
"nsc")
5325 return fail_at(arg, COMMAND_LINE_ERROR);
5327#if defined(WITH_JPEG)
5328 CommandLineSwitchCase(arg,
"jpeg")
5331 return fail_at(arg, COMMAND_LINE_ERROR);
5333 return fail_at(arg, COMMAND_LINE_ERROR);
5335 CommandLineSwitchCase(arg,
"jpeg-quality")
5339 if (!value_to_int(arg->Value, &val, 0, 100))
5340 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5343 return fail_at(arg, COMMAND_LINE_ERROR);
5346 CommandLineSwitchCase(arg,
"nego")
5349 return fail_at(arg, COMMAND_LINE_ERROR);
5351 CommandLineSwitchCase(arg,
"endpointfedauth")
5354 return fail_at(arg, COMMAND_LINE_ERROR);
5356 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5358 CommandLineSwitchCase(arg,
"pcb")
5361 return fail_at(arg, COMMAND_LINE_ERROR);
5364 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5366 CommandLineSwitchCase(arg,
"pcid")
5368 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5371 return fail_at(arg, rc);
5373 return fail_at(arg, COMMAND_LINE_ERROR);
5376 CommandLineSwitchCase(arg,
"connect-child-session")
5390 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5393 CommandLineSwitchCase(arg,
"sec")
5395 const int rc = parse_sec_options(settings, arg);
5397 return fail_at(arg, rc);
5399 CommandLineSwitchCase(arg,
"encryption-methods")
5401 const int rc = parse_encryption_methods_options(settings, arg);
5403 return fail_at(arg, rc);
5405 CommandLineSwitchCase(arg,
"args-from")
5407 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5409 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5411 CommandLineSwitchCase(arg,
"from-stdin")
5414 return fail_at(arg, COMMAND_LINE_ERROR);
5416 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5419 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5420 *promptForPassword = (option_equals(arg->Value, str_force));
5422 if (!*promptForPassword)
5423 return fail_at(arg, COMMAND_LINE_ERROR);
5426 CommandLineSwitchCase(arg,
"log-level")
5428 wLog* root = WLog_GetRoot();
5430 if (!WLog_SetStringLogLevel(root, arg->Value))
5431 return fail_at(arg, COMMAND_LINE_ERROR);
5433 CommandLineSwitchCase(arg,
"log-filters")
5435 if (!WLog_AddStringLogFilters(arg->Value))
5436 return fail_at(arg, COMMAND_LINE_ERROR);
5438 CommandLineSwitchCase(arg,
"tls")
5440 int rc = parse_tls_options(settings, arg);
5442 return fail_at(arg, rc);
5444 CommandLineSwitchCase(arg,
"cert")
5446 const int rc = parse_cert_options(settings, arg);
5448 return fail_at(arg, rc);
5450 CommandLineSwitchCase(arg,
"authentication")
5453 return fail_at(arg, COMMAND_LINE_ERROR);
5455 CommandLineSwitchCase(arg,
"encryption")
5458 return fail_at(arg, COMMAND_LINE_ERROR);
5460 CommandLineSwitchCase(arg,
"grab-keyboard")
5463 return fail_at(arg, COMMAND_LINE_ERROR);
5465 CommandLineSwitchCase(arg,
"grab-mouse")
5468 return fail_at(arg, COMMAND_LINE_ERROR);
5470 CommandLineSwitchCase(arg,
"mouse-relative")
5473 return fail_at(arg, COMMAND_LINE_ERROR);
5475 CommandLineSwitchCase(arg,
"mouse")
5477 const int rc = parse_mouse_options(settings, arg);
5479 return fail_at(arg, rc);
5481 CommandLineSwitchCase(arg,
"unmap-buttons")
5484 return fail_at(arg, COMMAND_LINE_ERROR);
5486 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5489 return fail_at(arg, COMMAND_LINE_ERROR);
5491 CommandLineSwitchCase(arg,
"force-console-callbacks")
5494 return fail_at(arg, COMMAND_LINE_ERROR);
5496 CommandLineSwitchCase(arg,
"floatbar")
5498 const int rc = parse_floatbar_options(settings, arg);
5500 return fail_at(arg, rc);
5502 CommandLineSwitchCase(arg,
"mouse-motion")
5505 return fail_at(arg, COMMAND_LINE_ERROR);
5507 CommandLineSwitchCase(arg,
"parent-window")
5511 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5512 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5515 return fail_at(arg, COMMAND_LINE_ERROR);
5517 CommandLineSwitchCase(arg,
"client-build-number")
5520 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5522 return fail_at(arg, rc);
5524 CommandLineSwitchCase(arg,
"cache")
5526 int rc = parse_cache_options(settings, arg);
5528 return fail_at(arg, rc);
5531 CommandLineSwitchCase(arg,
"max-fast-path-size")
5533 const int rc = parse_command_line_option_uint32(
5534 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5536 return fail_at(arg, rc);
5538 CommandLineSwitchCase(arg,
"auto-request-control")
5542 return fail_at(arg, COMMAND_LINE_ERROR);
5544 CommandLineSwitchCase(arg,
"async-update")
5547 return fail_at(arg, COMMAND_LINE_ERROR);
5549 CommandLineSwitchCase(arg,
"async-channels")
5552 return fail_at(arg, COMMAND_LINE_ERROR);
5554 CommandLineSwitchCase(arg,
"wm-class")
5557 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5559 CommandLineSwitchCase(arg,
"play-rfx")
5562 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5565 return fail_at(arg, COMMAND_LINE_ERROR);
5567 CommandLineSwitchCase(arg,
"auth-only")
5570 return fail_at(arg, COMMAND_LINE_ERROR);
5572 CommandLineSwitchCase(arg,
"auth-pkg-list")
5576 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5578 CommandLineSwitchCase(arg,
"auto-reconnect")
5581 return fail_at(arg, COMMAND_LINE_ERROR);
5583 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5585 const int rc = parse_command_line_option_uint32(
5586 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5588 return fail_at(arg, rc);
5590 CommandLineSwitchCase(arg,
"reconnect-cookie")
5592 const int rc = parse_reconnect_cookie_options(settings, arg);
5594 return fail_at(arg, rc);
5596 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5599 return fail_at(arg, COMMAND_LINE_ERROR);
5601 CommandLineSwitchCase(arg,
"pwidth")
5603 const int rc = parse_command_line_option_uint32(
5604 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5606 return fail_at(arg, rc);
5608 CommandLineSwitchCase(arg,
"pheight")
5610 const int rc = parse_command_line_option_uint32(
5611 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5613 return fail_at(arg, rc);
5615 CommandLineSwitchCase(arg,
"orientation")
5619 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5620 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5623 return fail_at(arg, COMMAND_LINE_ERROR);
5624 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5625 return fail_at(arg, COMMAND_LINE_ERROR);
5627 CommandLineSwitchCase(arg,
"old-license")
5630 return fail_at(arg, COMMAND_LINE_ERROR);
5632 CommandLineSwitchCase(arg,
"scale")
5634 const int rc = parse_scale_options(settings, arg);
5636 return fail_at(arg, rc);
5638 CommandLineSwitchCase(arg,
"scale-desktop")
5640 const int rc = parse_command_line_option_uint32(settings, arg,
5641 FreeRDP_DesktopScaleFactor, 100, 500);
5643 return fail_at(arg, rc);
5644 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5645 return fail_at(arg, COMMAND_LINE_ERROR);
5647 CommandLineSwitchCase(arg,
"scale-device")
5649 const int rc = parse_scale_device_options(settings, arg);
5651 return fail_at(arg, rc);
5653 CommandLineSwitchCase(arg,
"action-script")
5656 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5658#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
5659 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5662 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5665 CommandLineSwitchCase(arg,
"fipsmode")
5668 return fail_at(arg, COMMAND_LINE_ERROR);
5670 CommandLineSwitchCase(arg,
"smartcard-logon")
5672 const int rc = parse_smartcard_logon_options(settings, arg);
5674 return fail_at(arg, rc);
5676 CommandLineSwitchCase(arg,
"tune")
5678 const int rc = parse_tune_options(settings, arg);
5680 return fail_at(arg, rc);
5682 CommandLineSwitchDefault(arg)
5684#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5685 const int status = parse_deprecated_command_line(settings, arg);
5692 const int rc = handle_option(arg, handle_userdata);
5694 return fail_at(arg, rc);
5697 CommandLineSwitchEnd(arg)
5698 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
5705 bool insecureArgFound =
false;
5706 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5708 const char* cred = credential_args[x];
5712 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5715 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5716 insecureArgFound =
true;
5719 if (insecureArgFound)
5721 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5723 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5724 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file, file descriptor or "
5725 "environment variable");
5726 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5727 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5732static int freerdp_client_settings_parse_command_line_arguments_int(
5733 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5735 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata, UINT32 cmdflags)
5737 char* user =
nullptr;
5740 BOOL assist = FALSE;
5742 BOOL promptForPassword = FALSE;
5743 BOOL compatibility = FALSE;
5751 ext = option_is_rdp_file(argv[1]);
5752 assist = option_is_incident_file(argv[1]);
5755 if (!ext && !assist)
5756 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5758 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5769 WLog_WARN(TAG,
"Unsupported command line syntax!");
5770 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5771 freerdp_getApplicationDetailsString());
5776 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5780 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5781 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5786 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5787 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5790 CommandLineClearArgumentsA(largs);
5791 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5792 freerdp_client_command_line_pre_filter,
5793 freerdp_client_command_line_post_filter);
5798 prepare_default_settings(settings, largs, ext);
5799 if ((cmdflags & FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS) == 0)
5800 warn_credential_args(largs);
5807 return COMMAND_LINE_ERROR_MEMORY;
5809 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
5817 return COMMAND_LINE_ERROR;
5820 return COMMAND_LINE_ERROR;
5822 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
5823 return COMMAND_LINE_ERROR;
5828 return COMMAND_LINE_ERROR;
5832 if (promptForPassword)
5837 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5839 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
5840 ARRAYSIZE(buffer) - 1, 1))
5841 return COMMAND_LINE_ERROR;
5843 return COMMAND_LINE_ERROR;
5851 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5853 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
5854 ARRAYSIZE(buffer) - 1, 1))
5855 return COMMAND_LINE_ERROR;
5857 return COMMAND_LINE_ERROR;
5862 freerdp_performance_flags_make(settings);
5869 return COMMAND_LINE_ERROR;
5871 return COMMAND_LINE_ERROR;
5874 arg = CommandLineFindArgumentA(largs,
"port");
5875 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
5878 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
5880 return fail_at(arg, rc);
5886 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5887 return fail_at(arg, COMMAND_LINE_ERROR);
5890 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
5893 fill_credential_strings(largs);
5898static void argv_free(
int* pargc,
char** pargv[])
5900 WINPR_ASSERT(pargc);
5901 WINPR_ASSERT(pargv);
5902 const int argc = *pargc;
5903 char** argv = *pargv;
5909 for (
int x = 0; x < argc; x++)
5914static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
5916 WINPR_ASSERT(pargc);
5917 WINPR_ASSERT(pargv);
5925 int nargc = *pargc + 1;
5926 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
5936static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
5938 char* copy =
nullptr;
5940 copy = _strdup(what);
5942 const BOOL rc = argv_append(pargc, pargv, copy);
5948static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
5950 BOOL success = FALSE;
5952 WINPR_ASSERT(aargc);
5953 WINPR_ASSERT(aargv);
5958 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
5961 if (!argv_append_dup(aargc, aargv, cmd))
5965 char* line =
nullptr;
5967 INT64 rc = GetLine(&line, &size, fp);
5968 if ((rc < 0) || !line)
5978 const char cur = (line[rc - 1]);
5979 if ((cur ==
'\n') || (cur ==
'\r'))
5981 line[rc - 1] =
'\0';
5993 if (!argv_append(aargc, aargv, line))
6004 argv_free(aargc, aargv);
6008static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
6011 BOOL success = FALSE;
6012 char* env =
nullptr;
6014 WINPR_ASSERT(aargc);
6015 WINPR_ASSERT(aargv);
6020 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
6025 const DWORD size = GetEnvironmentVariableX(name, env, 0);
6028 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
6031 env = calloc(size + 1,
sizeof(
char));
6036 const DWORD rc = GetEnvironmentVariableX(name, env, size);
6041 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
6047 if (!argv_append_dup(aargc, aargv, cmd))
6051 char* context =
nullptr;
6052 char* tok = strtok_s(env,
"\n", &context);
6055 if (!argv_append_dup(aargc, aargv, tok))
6057 tok = strtok_s(
nullptr,
"\n", &context);
6065 argv_free(aargc, aargv);
6069int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
6070 char* oargv[], BOOL allowUnknown)
6072 return freerdp_client_settings_parse_command_line_arguments_ex(
6073 settings, oargc, oargv, allowUnknown,
nullptr, 0,
nullptr,
nullptr);
6076int freerdp_client_settings_parse_command_line_arguments_ex(
6078 size_t count, freerdp_command_line_handle_option_t handle_option,
void* handle_userdata)
6080 return freerdp_client_settings_parse_command_line_arguments_with_flags(
6081 settings, argc, argv, allowUnknown, args, count, handle_option, handle_userdata, 0);
6084int freerdp_client_settings_parse_command_line_arguments_with_flags(
6085 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
6087 void* handle_userdata, UINT32 flags, ...)
6090 char** argv = oargv;
6093 char** aargv =
nullptr;
6095 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
6097 flags |= FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS;
6098 BOOL success = FALSE;
6099 const char* file = strchr(argv[1],
':') + 1;
6102 if (option_starts_with(
"fd:", file))
6104 ULONGLONG result = 0;
6105 const char* val = strchr(file,
':') + 1;
6106 if (!value_to_uint(val, &result, 0, INT_MAX))
6108 fp = fdopen((
int)result,
"r");
6109 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6111 else if (strncmp(file,
"env:", 4) == 0)
6113 const char* name = strchr(file,
':') + 1;
6114 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
6116 else if (strncmp(file,
"file:", 5) == 0)
6118 file = strchr(file,
':') + 1;
6119 fp = winpr_fopen(file,
"r");
6120 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6122#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
6123 else if (strcmp(file,
"stdin") != 0)
6125 fp = winpr_fopen(file,
"r");
6126 WLog_WARN(TAG,
"/args-from:%s is deprecated, use /args-from:file:%s instead", file,
6128 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6131 else if (strcmp(file,
"stdin") == 0)
6132 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6140 WINPR_ASSERT(count <= SSIZE_MAX);
6146 res = freerdp_client_settings_parse_command_line_arguments_int(
6147 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata, flags);
6150 argv_free(&aargc, &aargv);
6154static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
6155 const char* name,
void* data)
6157 PVIRTUALCHANNELENTRY entry =
nullptr;
6158 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
6159 name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
6160 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
6164 freerdp_load_channel_addin_entry(name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC);
6168 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
6170 WLog_DBG(TAG,
"loading channelEx %s", name);
6176 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
6178 WLog_DBG(TAG,
"loading channel %s", name);
6188 FreeRDP_Settings_Keys_Bool settingId;
6189 const char* channelName;
6193BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
6195 ChannelToLoad dynChannels[] = {
6196#if defined(CHANNEL_AINPUT_CLIENT)
6197 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME,
nullptr },
6199#ifdef CHANNEL_AUDIN_CLIENT
6200 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME,
nullptr },
6202#ifdef CHANNEL_RDPSND_CLIENT
6203 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6205#ifdef CHANNEL_RDPEI_CLIENT
6206 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME,
nullptr },
6208#ifdef CHANNEL_RDPGFX_CLIENT
6209 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME,
nullptr },
6211#ifdef CHANNEL_ECHO_CLIENT
6212 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME,
nullptr },
6214#ifdef CHANNEL_SSHAGENT_CLIENT
6215 { FreeRDP_SupportSSHAgentChannel,
"sshagent",
nullptr },
6217#ifdef CHANNEL_DISP_CLIENT
6218 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME,
nullptr },
6220#ifdef CHANNEL_GEOMETRY_CLIENT
6221 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME,
nullptr },
6223#ifdef CHANNEL_VIDEO_CLIENT
6224 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME,
nullptr },
6226#ifdef CHANNEL_RDPEAR_CLIENT
6227 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME,
nullptr },
6229#ifdef CHANNEL_RDPEWA_CLIENT
6230 { FreeRDP_RedirectWebAuthN, RDPEWA_CHANNEL_NAME,
nullptr },
6234 ChannelToLoad staticChannels[] = {
6235#if defined(CHANNEL_RDPSND_CLIENT)
6236 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6238#if defined(CHANNEL_CLIPRDR_CLIENT)
6239 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME,
nullptr },
6241#if defined(CHANNEL_ENCOMSP_CLIENT)
6242 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6244#if defined(CHANNEL_REMDESK_CLIENT)
6245 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6247#if defined(CHANNEL_RAIL_CLIENT)
6248 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6255 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6257 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6260 const char*
const p[] = { dynChannels[i].channelName };
6262 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6270 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6271 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6272#
if defined(CHANNEL_TSMF_CLIENT)
6273 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6283 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6299 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6307 char* value =
nullptr;
6308 char* tok =
nullptr;
6309 char* context =
nullptr;
6311 value = _strdup(DrivesToRedirect);
6315 tok = strtok_s(value,
";", &context);
6318 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6335 const char* name =
nullptr;
6336 const char* drive = tok;
6337 char* subcontext =
nullptr;
6338 char* start = strtok_s(tok,
"(", &subcontext);
6339 char* end = strtok_s(
nullptr,
")", &subcontext);
6343 if (freerdp_path_valid(name,
nullptr) && freerdp_path_valid(drive,
nullptr))
6345 success = freerdp_client_add_drive(settings, name,
nullptr);
6347 success = freerdp_client_add_drive(settings, drive,
nullptr);
6350 success = freerdp_client_add_drive(settings, drive, name);
6358 tok = strtok_s(
nullptr,
";", &context);
6367 if (!freerdp_device_collection_find(settings,
"drive"))
6369 const char*
const params[] = {
"drive",
"media",
"*" };
6371 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6388 if (!freerdp_device_collection_find(settings,
"drive"))
6390 const char* params[] = {
"drive",
"home",
"%" };
6392 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6399 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6403 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6404 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6406 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6408 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6411 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6418 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6420 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0,
nullptr);
6425 if (!freerdp_device_collection_add(settings, smartcard))
6427 freerdp_device_free(smartcard);
6435 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6437 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0,
nullptr);
6442 if (!freerdp_device_collection_add(settings, printer))
6444 freerdp_device_free(printer);
6471 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6473 if ((staticChannels[i].settingId == 0) ||
6476 if (staticChannels[i].args)
6478 if (!freerdp_client_load_static_channel_addin(
6479 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6484 const char*
const p[] = { staticChannels[i].channelName };
6485 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6491#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
6496 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6497 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6507 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6509 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6521 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6529void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6531 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6532 wLog* log = WLog_Get(TAG);
6535 freerdp_warn_unmaintained(log,
"%s client", app);
6538void freerdp_client_warn_experimental(
int argc,
char* argv[])
6540 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6541 wLog* log = WLog_Get(TAG);
6544 freerdp_warn_experimental(log,
"%s client", app);
6547void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6549 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6550 wLog* log = WLog_Get(TAG);
6553 freerdp_warn_deprecated(log,
"%s client",
6554 "As replacement there is a SDL3 based client available.", app);
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API char * freerdp_settings_get_string_writable(rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a string settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL val)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val, size_t len)
Sets a string settings value. The val is copied.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT16 freerdp_settings_get_uint16(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id)
Returns a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT64 freerdp_settings_get_uint64(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id)
Returns a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint64(rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id, UINT64 val)
Sets a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_append_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *separator, const char *param)
appends a string to a settings value. The param is copied. If the initial value of the setting was no...
WINPR_ATTR_NODISCARD FREERDP_API INT16 freerdp_settings_get_int16(const rdpSettings *settings, FreeRDP_Settings_Keys_Int16 id)
Returns a INT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT64 freerdp_settings_get_int64(const rdpSettings *settings, FreeRDP_Settings_Keys_Int64 id)
Returns a INT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint16(rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id, UINT16 val)
Sets a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val)
Sets a string settings value. The param is copied.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_name_for_key(SSIZE_T key)
Returns the type name for a key.
WINPR_ATTR_NODISCARD FREERDP_API SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.