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#if defined(CHANNEL_AINPUT_CLIENT)
61#include <freerdp/channels/ainput.h>
64#include <freerdp/channels/audin.h>
65#include <freerdp/channels/echo.h>
67#include <freerdp/client/cmdline.h>
68#include <freerdp/version.h>
69#include <freerdp/client/utils/smartcard_cli.h>
71#include <openssl/tls1.h>
74#include <freerdp/log.h>
75#define TAG CLIENT_TAG("common.cmdline")
77static const char str_force[] =
"force";
79static const char* credential_args[] = {
"p",
"smartcard-logon",
80#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
83 "pth",
"reconnect-cookie",
86static const char* option_starts_with(
const char* what,
const char* val);
87static BOOL option_ends_with(
const char* str,
const char* ext);
88static BOOL option_equals(
const char* what,
const char* val);
90static BOOL freerdp_client_print_codepages(
const char* arg)
94 const char* filter =
nullptr;
99 filter = strchr(arg,
',');
105 pages = freerdp_keyboard_get_matching_codepages(column, filter, &count);
109 printf(
"%-10s %-8s %-60s %-36s %-48s\n",
"<id>",
"<locale>",
"<win langid>",
"<language>",
111 for (
size_t x = 0; x < count; x++)
114 char buffer[2048] = WINPR_C_ARRAY_INIT;
116 if (strnlen(page->subLanguageSymbol, ARRAYSIZE(page->subLanguageSymbol)) > 0)
117 (void)_snprintf(buffer,
sizeof(buffer),
"[%s|%s]", page->primaryLanguageSymbol,
118 page->subLanguageSymbol);
120 (
void)_snprintf(buffer,
sizeof(buffer),
"[%s]", page->primaryLanguageSymbol);
121 printf(
"id=0x%04" PRIx16
": [%-6s] %-60s %-36s %-48s\n", page->id, page->locale, buffer,
122 page->primaryLanguage, page->subLanguage);
124 freerdp_codepages_free(pages);
128static BOOL freerdp_path_valid(
const char* path, BOOL* special)
130 const char DynamicDrives[] =
"DynamicDrives";
136 isSpecial = (option_equals(
"*", path) || option_equals(DynamicDrives, path) ||
137 option_equals(
"%", path));
139 isPath = winpr_PathFileExists(path);
142 *special = isSpecial;
144 return isSpecial || isPath;
147static BOOL freerdp_sanitize_drive_name(
char* name,
const char* invalid,
const char* replacement)
149 if (!name || !invalid || !replacement)
151 if (strlen(invalid) != strlen(replacement))
154 while (*invalid !=
'\0')
156 const char what = *invalid++;
157 const char with = *replacement++;
160 while ((cur = strchr(cur, what)) !=
nullptr)
166static char* name_from_path(
const char* path)
168 const char* name =
"nullptr";
171 if (option_equals(
"%", path))
173 else if (option_equals(
"*", path))
174 name =
"hotplug-all";
175 else if (option_equals(
"DynamicDrives", path))
180 return _strdup(name);
183static BOOL freerdp_client_add_drive(rdpSettings* settings,
const char* path,
const char* name)
185 char* dname =
nullptr;
204 if (!skip && winpr_PathFileExists(name))
206 if (!winpr_PathFileExists(path) || (!PathIsRelativeA(name) && PathIsRelativeA(path)))
208 const char* tmp = path;
216 dname = _strdup(name);
218 dname = name_from_path(path);
220 if (freerdp_sanitize_drive_name(dname,
"\\/",
"__"))
222 const char* args[] = { dname, path };
223 device = freerdp_device_new(RDPDR_DTYP_FILESYSTEM, ARRAYSIZE(args), args);
233 BOOL isSpecial = FALSE;
234 BOOL isPath = freerdp_path_valid(path, &isSpecial);
236 if (!isPath && !isSpecial)
238 WLog_WARN(TAG,
"Invalid drive to redirect: '%s' does not exist, skipping.", path);
239 freerdp_device_free(device);
241 else if (!freerdp_device_collection_add(settings, device))
248 freerdp_device_free(device);
252static BOOL value_to_int(
const char* value, LONGLONG* result, LONGLONG min, LONGLONG max)
256 if (!value || !result)
260 rc = _strtoi64(value,
nullptr, 0);
265 if ((rc < min) || (rc > max))
272static BOOL value_to_uint(
const char* value, ULONGLONG* result, ULONGLONG min, ULONGLONG max)
274 unsigned long long rc = 0;
276 if (!value || !result)
280 rc = _strtoui64(value,
nullptr, 0);
285 if ((rc < min) || (rc > max))
292BOOL freerdp_client_print_version(
void)
294 printf(
"This is FreeRDP version %s (%s)\n", FREERDP_VERSION_FULL, FREERDP_GIT_REVISION);
298BOOL freerdp_client_print_version_ex(
int argc,
char** argv)
300 WINPR_ASSERT(argc >= 0);
301 WINPR_ASSERT(argv || (argc == 0));
302 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
303 printf(
"This is FreeRDP version [%s] %s (%s)\n", name, FREERDP_VERSION_FULL,
304 FREERDP_GIT_REVISION);
308BOOL freerdp_client_print_buildconfig(
void)
310 printf(
"%s", freerdp_get_build_config());
314BOOL freerdp_client_print_buildconfig_ex(
int argc,
char** argv)
316 WINPR_ASSERT(argc >= 0);
317 WINPR_ASSERT(argv || (argc == 0));
318 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
319 printf(
"[%s] %s", name, freerdp_get_build_config());
323static void freerdp_client_print_scancodes(
void)
325 printf(
"RDP scancodes and their name for use with /kbd:remap\n");
327 for (UINT32 x = 0; x < UINT16_MAX; x++)
329 const char* name = freerdp_keyboard_scancode_name(x);
331 printf(
"0x%04" PRIx32
" --> %s\n", x, name);
335static BOOL is_delimiter(
char c,
const char* delimiters)
338 while ((d = *delimiters++) !=
'\0')
346static const char* get_last(
const char* start,
size_t len,
const char* delimiters)
348 const char* last =
nullptr;
349 for (
size_t x = 0; x < len; x++)
352 if (is_delimiter(c, delimiters))
358static SSIZE_T next_delimiter(
const char* text,
size_t len,
size_t max,
const char* delimiters)
363 const char* last = get_last(text, max, delimiters);
367 return (SSIZE_T)(last - text);
370static SSIZE_T forced_newline_at(
const char* text,
size_t len,
size_t limit,
371 const char* force_newline)
374 while ((d = *force_newline++) !=
'\0')
376 const char* tok = strchr(text, d);
379 const size_t offset = WINPR_ASSERTING_INT_CAST(
size_t, tok - text);
380 if ((offset > len) || (offset > limit))
382 return (SSIZE_T)(offset);
388static BOOL print_align(
size_t start_offset,
size_t* current)
390 WINPR_ASSERT(current);
391 if (*current < start_offset)
393 const int rc = printf(
"%*c", (
int)(start_offset - *current),
' ');
396 *current += (size_t)rc;
401static char* print_token(
char* text,
size_t start_offset,
size_t* current,
size_t limit,
402 const char* delimiters,
const char* force_newline)
405 const size_t tlen = strnlen(text, limit);
407 const SSIZE_T force_at = forced_newline_at(text, len, limit - *current, force_newline);
408 BOOL isForce = (force_at >= 0);
411 len = MIN(len, (
size_t)force_at);
413 if (!print_align(start_offset, current))
416 const SSIZE_T delim = next_delimiter(text, len, limit - *current, delimiters);
417 const BOOL isDelim = delim > 0;
420 len = MIN(len, (
size_t)delim + 1);
423 rc = printf(
"%.*s", (
int)len, text);
427 if (isForce || isDelim)
432 const size_t offset = len + ((isForce && (force_at == 0)) ? 1 : 0);
433 return &text[offset];
436 *current += (size_t)rc;
438 if (tlen == (
size_t)rc)
440 return &text[(size_t)rc];
443static size_t print_optionals(
const char* text,
size_t start_offset,
size_t current)
445 const size_t limit = 80;
446 char* str = _strdup(text);
451 cur = print_token(cur, start_offset + 1, ¤t, limit,
"[], ",
"\r\n");
452 }
while (cur !=
nullptr);
458static size_t print_description(
const char* text,
size_t start_offset,
size_t current)
460 const size_t limit = 80;
461 char* str = _strdup(text);
464 while (cur !=
nullptr)
465 cur = print_token(cur, start_offset, ¤t, limit,
" ",
"\r\n");
468 const int rc = printf(
"\n");
471 const size_t src = WINPR_ASSERTING_INT_CAST(
size_t, rc);
472 WINPR_ASSERT(SIZE_MAX - src > current);
478static int cmp_cmdline_args(
const void* pva,
const void* pvb)
483 if (!a->Name && !b->Name)
489 return strcmp(a->Name, b->Name);
504 const size_t description_offset = 30 + 8;
506 if (arg->Flags & (COMMAND_LINE_VALUE_BOOL | COMMAND_LINE_VALUE_FLAG))
508 if ((arg->Flags & (uint32_t)~COMMAND_LINE_VALUE_BOOL) == 0)
509 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
510 else if ((arg->Flags & COMMAND_LINE_VALUE_OPTIONAL) != 0)
511 rc = printf(
" [%s|/]%s", arg->Default ?
"-" :
"+", arg->Name);
514 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
518 rc = printf(
" /%s", arg->Name);
524 if ((arg->Flags & COMMAND_LINE_VALUE_REQUIRED) ||
525 (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL))
529 if (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL)
535 pos = print_optionals(arg->Format, pos, pos);
547 pos = print_optionals(arg->Format, pos, pos);
550 if (pos > description_offset)
558 rc = printf(
"%*c", (
int)(description_offset - pos),
' ');
563 if (arg->Flags & COMMAND_LINE_VALUE_BOOL)
565 rc = printf(
"%s ", arg->Default ?
"Disable" :
"Enable");
571 print_description(arg->Text, description_offset, pos);
572 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
575BOOL freerdp_client_print_command_line_help(
int argc,
char** argv)
577 return freerdp_client_print_command_line_help_ex(argc, argv,
nullptr);
581 SSIZE_T count,
size_t* pcount)
583 WINPR_ASSERT(pcount);
588 while (cur && cur->Name)
603 while (cur && cur->Name)
605 largs[lcount++] = *cur++;
608 cur = global_cmd_args;
609 while (cur && cur->Name)
611 largs[lcount++] = *cur++;
617static void freerdp_client_print_command_line_usage(
int argc,
char** argv)
619 WINPR_ASSERT(argv || (argc < 1));
621 const char* name = freerdp_getApplicationDetailsString();
625 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
626 printf(
"To show full command line help type\n");
627 printf(
"%s /?\n", name);
631BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
634 const char* name = freerdp_getApplicationDetailsString();
646 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
647 printf(
"See www.freerdp.com for more information\n");
649 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
652 printf(
" /flag (enables flag)\n");
653 printf(
" /option:<value> (specifies option with value)\n");
654 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
657 freerdp_client_print_command_line_args(largs, lcount);
661 printf(
"Examples:\n");
662 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
663 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
664 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
665 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
666 "/v:192.168.1.100\n",
668 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
669 printf(
"Use a generic pipe as transport:");
670 printf(
" %s /v:/path/to/pipe\n", name);
671 printf(
"Use a external socket:");
672 printf(
" %s /v:|:1234\n", name);
674 printf(
"Connect to a system with TLS security and open the greeter:");
675 printf(
"NOTE: Needs a server configured to not require NLA or it will fail!");
677 printf(
" %s /sec:tls /p /v:rdp.contoso.com\n", name);
679 printf(
"Disable clipboard redirection: -clipboard\n");
681 printf(
"Drive Redirection: /drive:home,/home/user\n");
682 printf(
"Smartcard Redirection: /smartcard:<device>\n");
683 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
685#if defined(CHANNEL_SERIAL_CLIENT)
686 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
687 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
689#if defined(CHANNEL_PARALLEL_CLIENT)
690 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
692 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
693 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
695 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
696 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
697 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
698 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
700 printf(
"Multimedia Redirection: /video\n");
701#ifdef CHANNEL_URBDRC_CLIENT
702 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
705 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
707 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
709 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
711 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
713 printf(
"More documentation is coming, in the meantime consult source files\n");
718static BOOL option_is_rdp_file(
const char* option)
720 WINPR_ASSERT(option);
722 if (option_ends_with(option,
".rdp"))
724 if (option_ends_with(option,
".rdpw"))
729static BOOL option_is_incident_file(
const char* option)
731 WINPR_ASSERT(option);
733 return (option_ends_with(option,
".msrcIncident"));
736static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
741 rdpSettings* settings =
nullptr;
746 length = strlen(argv[index]);
750 if (option_is_rdp_file(argv[index]))
752 settings = (rdpSettings*)context;
755 return COMMAND_LINE_ERROR_MEMORY;
763 if (option_is_incident_file(argv[index]))
765 settings = (rdpSettings*)context;
768 return COMMAND_LINE_ERROR_MEMORY;
778BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
779 const char*
const* params)
781 WINPR_ASSERT(settings);
782 WINPR_ASSERT(params);
783 WINPR_ASSERT(count > 0);
785 if (option_equals(params[0],
"drive"))
794 rc = freerdp_client_add_drive(settings, params[1],
nullptr);
796 rc = freerdp_client_add_drive(settings, params[2], params[1]);
800 else if (option_equals(params[0],
"printer"))
812 printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
816 if (!freerdp_device_collection_add(settings, printer))
818 freerdp_device_free(printer);
824 else if (option_equals(params[0],
"smartcard"))
836 smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
841 if (!freerdp_device_collection_add(settings, smartcard))
843 freerdp_device_free(smartcard);
849#if defined(CHANNEL_SERIAL_CLIENT)
850 else if (option_equals(params[0],
"serial"))
862 serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
867 if (!freerdp_device_collection_add(settings, serial))
869 freerdp_device_free(serial);
876 else if (option_equals(params[0],
"parallel"))
888 parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
893 if (!freerdp_device_collection_add(settings, parallel))
895 freerdp_device_free(parallel);
905BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
907 return freerdp_static_channel_collection_del(settings, name);
910BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
911 const char*
const* params)
915 if (!settings || !params || !params[0] || (count > INT_MAX))
918 if (freerdp_static_channel_collection_find(settings, params[0]))
921 _args = freerdp_addin_argv_new(count, params);
926 if (!freerdp_static_channel_collection_add(settings, _args))
931 freerdp_addin_argv_free(_args);
935BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
937 return freerdp_dynamic_channel_collection_del(settings, name);
940BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
941 const char*
const* params)
945 if (!settings || !params || !params[0] || (count > INT_MAX))
948 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
951 _args = freerdp_addin_argv_new(count, params);
956 if (!freerdp_dynamic_channel_collection_add(settings, _args))
962 freerdp_addin_argv_free(_args);
966static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
const char* file)
969 char* pem = crypto_read_pem(file, &length);
970 if (!pem || (length == 0))
984 CMDLINE_SUBOPTION_STRING,
985 CMDLINE_SUBOPTION_FILE,
986} CmdLineSubOptionType;
988typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
992 FreeRDP_Settings_Keys_String id;
993 CmdLineSubOptionType opttype;
994 WINPR_ATTR_NODISCARD CmdLineSubOptionCb cb;
997static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
1002 for (
size_t xx = 0; xx < count; xx++)
1004 const CmdLineSubOptions* opt = &opts[xx];
1006 if (option_starts_with(opt->optname, arg))
1008 const size_t optlen = strlen(opt->optname);
1009 const char* val = &arg[optlen];
1012 switch (opt->opttype)
1014 case CMDLINE_SUBOPTION_STRING:
1017 case CMDLINE_SUBOPTION_FILE:
1018 status = read_pem_file(settings, opt->id, val);
1021 WLog_ERR(TAG,
"invalid subOption type");
1028 if (opt->cb && !opt->cb(val, settings))
1037 WLog_ERR(TAG,
"option %s not handled", arg);
1042#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1049 const DWORD level = WLOG_ERROR;
1050 wLog* log = WLog_Get(TAG);
1051 if (WLog_IsLevelActive(log, level))
1053 const char* val = arg->Value;
1054 if ((arg->Flags & COMMAND_LINE_VALUE_FLAG) != 0)
1055 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1056 if ((arg->Flags & COMMAND_LINE_VALUE_BOOL) != 0)
1057 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1059 WLog_PrintTextMessage(log, level, line, file, fkt,
1060 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name, val,
1068 rdpSettings* settings = (rdpSettings*)context;
1069 int status = CHANNEL_RC_OK;
1070 BOOL enable = (arg->Value !=
nullptr);
1072 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1075 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1077 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1078 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1080 status = COMMAND_LINE_ERROR;
1082 CommandLineParserFree(ptr);
1084 return fail_at(arg, status);
1086 CommandLineSwitchCase(arg,
"kerberos")
1090 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1093 const CmdLineSubOptions opts[] = {
1094 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING,
nullptr },
1095 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1096 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1097 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1098 CMDLINE_SUBOPTION_STRING,
nullptr },
1099 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING,
nullptr },
1100 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING,
nullptr },
1101 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1102 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1105 for (
size_t x = 1; x < count; x++)
1107 const char* cur = ptr[x];
1108 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1110 CommandLineParserFree(ptr);
1111 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1115 CommandLineParserFree(ptr);
1118 CommandLineSwitchCase(arg,
"vc")
1121 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1122 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1123 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1124 CommandLineParserFree(ptr);
1126 return fail_at(arg, status);
1128 CommandLineSwitchCase(arg,
"dvc")
1131 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1132 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1133 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1134 CommandLineParserFree(ptr);
1136 return fail_at(arg, status);
1138 CommandLineSwitchCase(arg,
"drive")
1141 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1142 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1143 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1144 CommandLineParserFree(ptr);
1146 return fail_at(arg, status);
1148#if defined(CHANNEL_SERIAL_CLIENT)
1149 CommandLineSwitchCase(arg,
"serial")
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#if defined(CHANNEL_PARALLEL_CLIENT)
1161 CommandLineSwitchCase(arg,
"parallel")
1164 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1165 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1166 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1167 CommandLineParserFree(ptr);
1169 return fail_at(arg, status);
1172 CommandLineSwitchCase(arg,
"smartcard")
1175 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1176 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1177 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1178 CommandLineParserFree(ptr);
1180 return fail_at(arg, status);
1182 CommandLineSwitchCase(arg,
"printer")
1185 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1186 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1187 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1188 CommandLineParserFree(ptr);
1190 return fail_at(arg, status);
1192 CommandLineSwitchCase(arg,
"usb")
1196 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1197 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1198 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1199 CommandLineParserFree(ptr);
1201 return fail_at(arg, status);
1203 CommandLineSwitchCase(arg,
"multitouch")
1206 return fail_at(arg, COMMAND_LINE_ERROR);
1208 CommandLineSwitchCase(arg,
"gestures")
1211 return fail_at(arg, COMMAND_LINE_ERROR);
1213 CommandLineSwitchCase(arg,
"echo")
1216 return fail_at(arg, COMMAND_LINE_ERROR);
1218 CommandLineSwitchCase(arg,
"ssh-agent")
1221 return fail_at(arg, COMMAND_LINE_ERROR);
1223 CommandLineSwitchCase(arg,
"disp")
1226 return fail_at(arg, COMMAND_LINE_ERROR);
1228 CommandLineSwitchCase(arg,
"geometry")
1231 return fail_at(arg, COMMAND_LINE_ERROR);
1233 CommandLineSwitchCase(arg,
"video")
1237 return fail_at(arg, COMMAND_LINE_ERROR);
1239 return fail_at(arg, COMMAND_LINE_ERROR);
1241 CommandLineSwitchCase(arg,
"sound")
1245 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1246 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1247 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1248 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1249 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1251 CommandLineParserFree(ptr);
1253 return fail_at(arg, status);
1255 CommandLineSwitchCase(arg,
"microphone")
1258 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1259 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1260 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1261 CommandLineParserFree(ptr);
1263 return fail_at(arg, status);
1265#if defined(CHANNEL_TSMF_CLIENT)
1266 CommandLineSwitchCase(arg,
"multimedia")
1269 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1270 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1271 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1272 CommandLineParserFree(ptr);
1274 return fail_at(arg, status);
1277 CommandLineSwitchCase(arg,
"heartbeat")
1280 return fail_at(arg, COMMAND_LINE_ERROR);
1282 CommandLineSwitchCase(arg,
"multitransport")
1285 return fail_at(arg, COMMAND_LINE_ERROR);
1290 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1293 return fail_at(arg, COMMAND_LINE_ERROR);
1295 CommandLineSwitchEnd(arg)
1302 int status = freerdp_client_command_line_post_filter_int(context, arg);
1303 return status == CHANNEL_RC_OK ? 1 : -1;
1306static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1307 const char** domain,
size_t* domainlen)
1310 WINPR_ASSERT(userlen);
1311 WINPR_ASSERT(domain);
1312 WINPR_ASSERT(domainlen);
1317 const char* p = strchr(username,
'\\');
1327 const size_t length = (size_t)(p - username);
1329 *userlen = strlen(*user);
1332 *domainlen = length;
1341 *userlen = strlen(username);
1347static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1348 FreeRDP_Settings_Keys_String userID,
1349 FreeRDP_Settings_Keys_String domainID)
1351 const char* user =
nullptr;
1352 const char* domain =
nullptr;
1354 size_t domainlen = 0;
1356 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1364BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1366 const char* user =
nullptr;
1367 const char* domain =
nullptr;
1369 size_t domainlen = 0;
1374 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1380 *puser = strndup(user, userlen);
1387 *pdomain = strndup(domain, domainlen);
1399BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1402 p = strrchr(hostname,
':');
1406 size_t length = (size_t)(p - hostname);
1409 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1412 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1417 CopyMemory(*host, hostname, length);
1418 (*host)[length] =
'\0';
1419 *port = (UINT16)val;
1423 *host = _strdup(hostname);
1434static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1436 struct network_settings
1438 FreeRDP_Settings_Keys_Bool id;
1441 const struct network_settings config[] = {
1442 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1443 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1444 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1445 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1446 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1447 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1452 case CONNECTION_TYPE_INVALID:
1455 case CONNECTION_TYPE_MODEM:
1456 case CONNECTION_TYPE_BROADBAND_LOW:
1457 case CONNECTION_TYPE_BROADBAND_HIGH:
1458 case CONNECTION_TYPE_SATELLITE:
1459 case CONNECTION_TYPE_WAN:
1460 case CONNECTION_TYPE_LAN:
1461 case CONNECTION_TYPE_AUTODETECT:
1464 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1468 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1470 const struct network_settings* cur = &config[x];
1477BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1485 case CONNECTION_TYPE_INVALID:
1486 case CONNECTION_TYPE_MODEM:
1487 case CONNECTION_TYPE_BROADBAND_LOW:
1488 case CONNECTION_TYPE_SATELLITE:
1489 case CONNECTION_TYPE_BROADBAND_HIGH:
1490 case CONNECTION_TYPE_WAN:
1491 case CONNECTION_TYPE_LAN:
1492 if (!freerdp_apply_connection_type(settings, type))
1495 case CONNECTION_TYPE_AUTODETECT:
1496 if (!freerdp_apply_connection_type(settings, type))
1510 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1517static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1522 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1524 if (!layouts || (count == 0))
1527 for (
size_t x = 0; x < count; x++)
1530 if (option_equals(layout->name, name))
1538 freerdp_keyboard_layouts_free(layouts, count);
1542static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1544 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1545 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1547 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1549 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1557static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1560 WINPR_UNUSED(context);
1567 length = strlen(argv[index]);
1571 if (option_is_rdp_file(argv[index]))
1579 if (option_is_incident_file(argv[index]))
1589static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1594 int detect_status = 0;
1597 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1599 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1600 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1604 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1609 CommandLineClearArgumentsA(largs);
1610 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1611 freerdp_detect_command_line_pre_filter,
nullptr);
1620 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1624 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1626 return detect_status;
1629static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1634 int detect_status = 0;
1637 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1639 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1640 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1641 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1645 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1650 CommandLineClearArgumentsA(largs);
1651 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1652 freerdp_detect_command_line_pre_filter,
nullptr);
1661 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1665 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1667 return detect_status;
1670static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1672 size_t posix_cli_count = 0;
1673 size_t windows_cli_count = 0;
1674 const BOOL ignoreUnknown = TRUE;
1675 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1676 argc, argv, &windows_cli_count, ignoreUnknown);
1677 const int posix_cli_status =
1678 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1681 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1682 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1683 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1685 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1689 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1690 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1692 windows_cli_count = 1;
1693 *flags = COMMAND_LINE_SEPARATOR_COLON;
1694 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1697 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1698 windows_cli_count, posix_cli_status, posix_cli_count);
1699 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1701 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1707int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1710 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv,
1714static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1718 layouts = freerdp_keyboard_get_layouts(type, &count);
1720 printf(
"\n%s\n", msg);
1722 for (
size_t x = 0; x < count; x++)
1725 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1728 freerdp_keyboard_layouts_free(layouts, count);
1731static void freerdp_client_print_keyboard_list(
void)
1733 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1734 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1735 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1736 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1737 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1740static void freerdp_client_print_timezone_list(
void)
1744 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1746 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
1748 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1749 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1750 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1754static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1758 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1766 case RDP_SETTINGS_TYPE_BOOL:
1767 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1772 case RDP_SETTINGS_TYPE_UINT16:
1773 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1776 case RDP_SETTINGS_TYPE_INT16:
1777 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1780 case RDP_SETTINGS_TYPE_UINT32:
1781 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1784 case RDP_SETTINGS_TYPE_INT32:
1785 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1788 case RDP_SETTINGS_TYPE_UINT64:
1789 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1792 case RDP_SETTINGS_TYPE_INT64:
1793 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1796 case RDP_SETTINGS_TYPE_STRING:
1797 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1802 case RDP_SETTINGS_TYPE_POINTER:
1803 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1815static int evaluate_result(
int argc,
char* argv[],
int rc, rdpSettings* settings,
1818 WINPR_ASSERT(settings);
1819 WINPR_ASSERT(largs);
1821 if (rc != COMMAND_LINE_STATUS_PRINT)
1823 freerdp_client_print_command_line_usage(argc, argv);
1830 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1832 if (option_equals(
"timezones", arg->Value))
1833 freerdp_client_print_timezone_list();
1834 else if (option_equals(
"tune", arg->Value))
1835 freerdp_client_print_tune_list(settings);
1836 else if (option_equals(
"kbd", arg->Value))
1837 freerdp_client_print_keyboard_list();
1838 else if (option_starts_with(
"kbd-lang", arg->Value))
1840 const char* val =
nullptr;
1841 if (option_starts_with(
"kbd-lang:", arg->Value))
1842 val = &arg->Value[9];
1843 else if (!option_equals(
"kbd-lang", arg->Value))
1844 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1846 if (val && strchr(val,
','))
1847 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1848 freerdp_client_print_codepages(val);
1850 else if (option_equals(
"kbd-scancode", arg->Value))
1851 freerdp_client_print_scancodes();
1852 else if (option_equals(
"monitor", arg->Value))
1855 return COMMAND_LINE_ERROR;
1857 else if (option_starts_with(
"smartcard", arg->Value))
1860 if (option_starts_with(
"smartcard:", arg->Value))
1862 else if (!option_equals(
"smartcard", arg->Value))
1863 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1867 const char* sub = strchr(arg->Value,
':') + 1;
1868 const CmdLineSubOptions options[] = {
1869 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1870 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1875 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1877 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1880 CommandLineParserFree(ptr);
1881 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1884 for (
size_t x = 1; x < count; x++)
1886 const char* cur = ptr[x];
1887 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1889 CommandLineParserFree(ptr);
1890 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1894 CommandLineParserFree(ptr);
1897 freerdp_smartcard_list(settings);
1901 freerdp_client_print_command_line_usage(argc, argv);
1902 return COMMAND_LINE_ERROR;
1905#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1906 arg = CommandLineFindArgumentA(largs,
"tune-list");
1909 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1911 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
1912 freerdp_client_print_tune_list(settings);
1915 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
1918 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1920 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
1921 freerdp_client_print_codepages(arg->Value);
1924 arg = CommandLineFindArgumentA(largs,
"kbd-list");
1927 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1929 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
1930 freerdp_client_print_keyboard_list();
1933 arg = CommandLineFindArgumentA(largs,
"monitor-list");
1936 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1938 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
1940 return COMMAND_LINE_ERROR;
1943 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
1946 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1948 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
1949 freerdp_smartcard_list(settings);
1952 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
1955 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
1957 WLog_WARN(TAG,
"Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
1958 freerdp_client_print_scancodes();
1959 return COMMAND_LINE_STATUS_PRINT;
1962 return COMMAND_LINE_STATUS_PRINT;
1965int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
1966 int argc,
char** argv,
1969 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
1971 freerdp_client_print_version();
1975 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
1977 freerdp_client_print_version_ex(argc, argv);
1978 freerdp_client_print_buildconfig_ex(argc, argv);
1981 else if (status == COMMAND_LINE_STATUS_PRINT)
1984 COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SIGIL_PLUS_MINUS | COMMAND_LINE_SIGIL_SLASH;
1986 size_t customcount = 0;
1989 while (cur && cur->Name)
1995 size_t globalcount = 0;
1998 while (cur && cur->Name)
2014 CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
nullptr,
nullptr);
2015 status = evaluate_result(argc, argv, rc, settings, largs);
2019 else if (status == COMMAND_LINE_STATUS_PRINT_HELP)
2021 freerdp_client_print_command_line_help_ex(argc, argv, custom);
2024 else if (status < 0)
2026 freerdp_client_print_command_line_usage(argc, argv);
2031 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
2044static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
2046 const char* xcharpos =
nullptr;
2047 char* endPtr =
nullptr;
2048 unsigned long v = 0;
2050 v = strtoul(input, &endPtr, 10);
2052 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2058 xcharpos = strchr(input,
'x');
2060 if (!xcharpos || xcharpos != endPtr)
2064 v = strtoul(xcharpos + 1, &endPtr, 10);
2066 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2069 if (*endPtr !=
'\0')
2081 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2082 WINPR_ASSERT(settings);
2088 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2090 const char* arg = arguments[x];
2092 if (p && (p->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
2096 return freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT);
2099static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2104const char* option_starts_with(
const char* what,
const char* val)
2108 const size_t wlen = strlen(what);
2110 if (_strnicmp(what, val, wlen) != 0)
2115BOOL option_ends_with(
const char* str,
const char* ext)
2119 const size_t strLen = strlen(str);
2120 const size_t extLen = strlen(ext);
2122 if (strLen < extLen)
2125 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2128BOOL option_equals(
const char* what,
const char* val)
2132 return _stricmp(what, val) == 0;
2141} PARSE_ON_OFF_RESULT;
2143static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2145 WINPR_ASSERT(value);
2146 const char* sep = strchr(value,
':');
2149 if (option_equals(
"on", &sep[1]))
2151 if (option_equals(
"off", &sep[1]))
2160 CLIP_DIR_PARSE_LOCAL,
2161 CLIP_DIR_PARSE_REMOTE,
2163} PARSE_CLIP_DIR_RESULT;
2165static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2167 WINPR_ASSERT(value);
2168 const char* sep = strchr(value,
':');
2170 return CLIP_DIR_PARSE_FAIL;
2171 if (option_equals(
"all", &sep[1]))
2172 return CLIP_DIR_PARSE_ALL;
2173 if (option_equals(
"off", &sep[1]))
2174 return CLIP_DIR_PARSE_OFF;
2175 if (option_equals(
"local", &sep[1]))
2176 return CLIP_DIR_PARSE_LOCAL;
2177 if (option_equals(
"remote", &sep[1]))
2178 return CLIP_DIR_PARSE_REMOTE;
2179 return CLIP_DIR_PARSE_FAIL;
2182static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2184 const char* ciphers =
nullptr;
2186 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2188 if (option_equals(Value,
"netmon"))
2190 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2192 else if (option_equals(Value,
"ma"))
2194 ciphers =
"AES128-SHA";
2202 return COMMAND_LINE_ERROR_MEMORY;
2206static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2210 if (!value_to_int(Value, &val, 0, 5))
2211 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2214 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2218static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2221 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2224 return COMMAND_LINE_ERROR_MEMORY;
2228static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2230 UINT16 version = TLS1_2_VERSION;
2239 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2240 {
"1.1", TLS1_1_VERSION },
2241 {
"1.2", TLS1_2_VERSION }
2242#if defined(TLS1_3_VERSION)
2244 {
"1.3", TLS1_3_VERSION }
2248 const struct map_t* found =
nullptr;
2249 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2251 const struct map_t* cur = &map[x];
2252 if (option_equals(cur->name, Value))
2260 version = found->version;
2264 const long v = strtol(Value,
nullptr, 0);
2266 if ((v < -1) || ((v == LONG_MAX) && (errno != 0)) || (v > UINT16_MAX))
2267 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2269 version = WINPR_ASSERTING_INT_CAST(UINT16, v);
2275 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2281 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2282 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2284 if (option_starts_with(
"ciphers:", arg->Value))
2285 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2286 else if (option_starts_with(
"seclevel:", arg->Value))
2287 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2288 else if (option_starts_with(
"secrets-file:", arg->Value))
2289 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2290 else if (option_starts_with(
"enforce:", arg->Value))
2291 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2294#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2295 CommandLineSwitchCase(arg,
"tls-ciphers")
2297 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2298 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2300 CommandLineSwitchCase(arg,
"tls-seclevel")
2302 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2303 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2305 CommandLineSwitchCase(arg,
"tls-secrets-file")
2307 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2308 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2310 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2312 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2313 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2316 CommandLineSwitchDefault(arg)
2319 CommandLineSwitchEnd(arg)
2326 WINPR_ASSERT(settings);
2330 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2331 for (
size_t x = 0; x < count; x++)
2334 larg.Value = ptr[x];
2336 int rc = parse_tls_cipher_options(settings, &larg);
2339 CommandLineParserFree(ptr);
2343 CommandLineParserFree(ptr);
2349 WINPR_ASSERT(settings);
2353 return COMMAND_LINE_ERROR;
2357 int rc = CHANNEL_RC_OK;
2359 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2360 if (!ptr || (count == 0))
2361 rc = COMMAND_LINE_ERROR;
2364 BOOL GfxH264 = FALSE;
2365 BOOL GfxAVC444 = FALSE;
2366 BOOL RemoteFxCodec = FALSE;
2367 BOOL GfxProgressive = FALSE;
2368 BOOL codecSelected = FALSE;
2370 for (
size_t x = 0; x < count; x++)
2372 const char* val = ptr[x];
2374 if (option_starts_with(
"AVC444", val))
2376 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2377 if (bval == PARSE_FAIL)
2378 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2380 GfxAVC444 = bval != PARSE_OFF;
2381 codecSelected = TRUE;
2383 else if (option_starts_with(
"AVC420", val))
2385 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2386 if (bval == PARSE_FAIL)
2387 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2389 GfxH264 = bval != PARSE_OFF;
2390 codecSelected = TRUE;
2394 if (option_starts_with(
"RFX", val))
2396 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2397 if (bval == PARSE_FAIL)
2398 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2400 RemoteFxCodec = bval != PARSE_OFF;
2401 codecSelected = TRUE;
2403 else if (option_starts_with(
"progressive", val))
2405 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2406 if (bval == PARSE_FAIL)
2407 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2409 GfxProgressive = bval != PARSE_OFF;
2410 codecSelected = TRUE;
2412 else if (option_starts_with(
"mask:", val))
2415 const char* uv = &val[5];
2416 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2417 rc = COMMAND_LINE_ERROR;
2422 rc = COMMAND_LINE_ERROR;
2425 else if (option_starts_with(
"small-cache", val))
2427 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2428 if (bval == PARSE_FAIL)
2429 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2432 rc = COMMAND_LINE_ERROR;
2434 else if (option_starts_with(
"thin-client", val))
2436 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2437 if (bval == PARSE_FAIL)
2438 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2441 rc = COMMAND_LINE_ERROR;
2442 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2446 rc = COMMAND_LINE_ERROR;
2449 else if (option_starts_with(
"frame-ack", val))
2451 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2452 if (bval == PARSE_FAIL)
2453 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2456 rc = COMMAND_LINE_ERROR;
2458#if defined(WITH_GFX_AV1)
2459 else if (option_starts_with(
"AV1", val))
2461 uint32_t profile = 1;
2462 BOOL enabled = FALSE;
2463 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2464 if (bval == PARSE_FAIL)
2466 if (_stricmp(
"av1:i420", val) == 0)
2471 else if (_stricmp(
"av1:i444", val) == 0)
2477 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2480 enabled = bval == PARSE_ON;
2482 if (enabled || (bval != PARSE_FAIL))
2485 rc = COMMAND_LINE_ERROR;
2488 rc = COMMAND_LINE_ERROR;
2493 rc = COMMAND_LINE_ERROR;
2496 if ((rc == CHANNEL_RC_OK) && codecSelected)
2499 rc = COMMAND_LINE_ERROR;
2501 rc = COMMAND_LINE_ERROR;
2503 rc = COMMAND_LINE_ERROR;
2505 rc = COMMAND_LINE_ERROR;
2507 rc = COMMAND_LINE_ERROR;
2510 CommandLineParserFree(ptr);
2511 if (rc != CHANNEL_RC_OK)
2514 return CHANNEL_RC_OK;
2517static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2519 WINPR_ASSERT(settings);
2520 WINPR_ASSERT(value);
2524 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2527 ival = freerdp_map_keyboard_layout_name_to_id(value);
2531 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2532 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2533 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2540 rc = COMMAND_LINE_ERROR;
2545#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2548 WINPR_ASSERT(settings);
2552 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2554 return COMMAND_LINE_ERROR;
2556 if (option_equals(arg->Value,
"rfx"))
2559 return COMMAND_LINE_ERROR;
2561 else if (option_equals(arg->Value,
"nsc"))
2564 return COMMAND_LINE_ERROR;
2567#if defined(WITH_JPEG)
2568 else if (option_equals(arg->Value,
"jpeg"))
2571 return COMMAND_LINE_ERROR;
2576 return COMMAND_LINE_ERROR;
2585static BOOL check_kbd_remap_valid(
const char* token)
2590 WINPR_ASSERT(token);
2592 if (strlen(token) > 10)
2595 if (!freerdp_extract_key_value(token, &key, &value))
2597 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2605 WINPR_ASSERT(settings);
2609 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2611 return COMMAND_LINE_ERROR_MEMORY;
2612 char* p = strchr(arg->Value,
'[');
2617 const char scheme[] =
"://";
2618 const char* val = strstr(arg->Value, scheme);
2620 val += strnlen(scheme,
sizeof(scheme));
2623 p = strchr(val,
':');
2630 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2631 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2633 length = (size_t)(p - arg->Value);
2635 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2638 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2643 return COMMAND_LINE_ERROR_MEMORY;
2649 char* p2 = strchr(arg->Value,
']');
2653 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2655 length = (size_t)(p2 - p);
2657 return COMMAND_LINE_ERROR_MEMORY;
2659 if (*(p2 + 1) ==
':')
2663 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2664 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2667 return COMMAND_LINE_ERROR;
2670 printf(
"hostname %s port %" PRIu32
"\n",
2679 WINPR_ASSERT(settings);
2683 char* cur = arg->Value;
2685 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2691 char* next = strchr(cur,
',');
2699 if (option_equals(
"fqdn", cur))
2701 else if (option_equals(
"ip", cur))
2703 else if (option_equals(
"netbios", cur))
2706 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2709 mask = (mask & 0x07);
2710 value |= mask << (count * 3);
2712 }
while (cur !=
nullptr);
2715 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2718 return COMMAND_LINE_ERROR;
2723static int parse_prevent_session_lock_options(rdpSettings* settings,
2726 WINPR_ASSERT(settings);
2730 return COMMAND_LINE_ERROR_MEMORY;
2732 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2736 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2737 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2740 return COMMAND_LINE_ERROR_MEMORY;
2748 WINPR_ASSERT(settings);
2752 return COMMAND_LINE_ERROR;
2759 return COMMAND_LINE_ERROR;
2761 return COMMAND_LINE_ERROR;
2763 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2766 return COMMAND_LINE_ERROR;
2769 return COMMAND_LINE_ERROR_MEMORY;
2777 WINPR_ASSERT(settings);
2781 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2782 char* p = strchr(arg->Value,
'x');
2786 unsigned long w = 0;
2787 unsigned long h = 0;
2789 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2790 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2793 return COMMAND_LINE_ERROR;
2795 return COMMAND_LINE_ERROR;
2799 char* str = _strdup(arg->Value);
2801 return COMMAND_LINE_ERROR_MEMORY;
2803 p = strchr(str,
'%');
2807 BOOL partial = FALSE;
2809 status = COMMAND_LINE_ERROR;
2836 if (!value_to_int(str, &val, 0, 100))
2838 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2858 WINPR_ASSERT(settings);
2861 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2864 UINT32* MonitorIds =
nullptr;
2865 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2868 return COMMAND_LINE_ERROR_MEMORY;
2875 CommandLineParserFree(ptr);
2876 return COMMAND_LINE_ERROR;
2879 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
2880 for (UINT32 i = 0; i < count; i++)
2884 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
2885 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2887 MonitorIds[i] = (UINT32)val;
2890 CommandLineParserFree(ptr);
2896static int parse_dynamic_resolution_options(rdpSettings* settings,
2899 WINPR_ASSERT(settings);
2902 const BOOL val = arg->Value !=
nullptr;
2906 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2907 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2911 return COMMAND_LINE_ERROR;
2913 return COMMAND_LINE_ERROR;
2920 WINPR_ASSERT(settings);
2925 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
2926 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2930 return COMMAND_LINE_ERROR;
2934 unsigned long w = 0;
2935 unsigned long h = 0;
2937 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2938 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2941 return COMMAND_LINE_ERROR;
2943 return COMMAND_LINE_ERROR;
2950 WINPR_ASSERT(settings);
2955 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
2956 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2966 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2970 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2977 WINPR_ASSERT(settings);
2980 int rc = CHANNEL_RC_OK;
2982 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2983 if (!ptr || (count == 0))
2984 rc = COMMAND_LINE_ERROR;
2987 for (
size_t x = 0; x < count; x++)
2989 const char* val = ptr[x];
2991 if (option_starts_with(
"remap:", val))
2994 char* now = _strdup(&val[6]);
2999 if (!check_kbd_remap_valid(now))
3000 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3003 const size_t olen = strlen(old);
3004 const size_t alen = strlen(now);
3005 const size_t tlen = olen + alen + 2;
3006 char* tmp = calloc(tlen,
sizeof(
char));
3008 rc = COMMAND_LINE_ERROR_MEMORY;
3010 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
3018 rc = COMMAND_LINE_ERROR;
3022 else if (option_starts_with(
"layout:", val))
3024 rc = parse_kbd_layout(settings, &val[7]);
3026 else if (option_starts_with(
"lang:", val))
3029 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3031 ival = freerdp_get_locale_id_from_string(&val[5]);
3034 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3037 rc = COMMAND_LINE_ERROR;
3039 else if (option_starts_with(
"type:", val))
3042 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3044 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3046 rc = COMMAND_LINE_ERROR;
3048 else if (option_starts_with(
"subtype:", val))
3051 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
3053 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3056 rc = COMMAND_LINE_ERROR;
3058 else if (option_starts_with(
"fn-key:", val))
3061 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
3063 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3066 rc = COMMAND_LINE_ERROR;
3068 else if (option_starts_with(
"unicode", val))
3070 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3071 if (bval == PARSE_FAIL)
3072 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3075 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3077 else if (option_starts_with(
"pipe:", val))
3080 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3082 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3084#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3085 else if (count == 1)
3088 rc = parse_kbd_layout(settings, val);
3092 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3098 CommandLineParserFree(ptr);
3104 WINPR_ASSERT(settings);
3109 return COMMAND_LINE_ERROR_MEMORY;
3111 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3113 const char* cur = arg->Value;
3116 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3118 if (!proxy_parse_uri(settings, cur))
3119 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3123 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3124 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3131 WINPR_ASSERT(settings);
3134 BOOL failed = FALSE;
3136 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3141 BOOL modernsyntax = FALSE;
3142 BOOL oldsyntax = FALSE;
3143 for (
size_t x = 0; (x < count) && !failed; x++)
3145 const char* carg = ptr[x];
3146 if (option_starts_with(
"file:", carg))
3148 const char* val = &carg[5];
3153 modernsyntax = TRUE;
3155 else if (option_equals(
"replay", carg))
3162 else if (option_equals(
"record", carg))
3169 else if (option_equals(
"nodelay", carg))
3176 modernsyntax = TRUE;
3191 if (oldsyntax && (count != 2))
3194 CommandLineParserFree(ptr);
3196 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3202 WINPR_ASSERT(settings);
3205 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3208 (arg->Value == BoolValueTrue)))
3209 return COMMAND_LINE_ERROR;
3215 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3216 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3218 const char* usesel =
"use-selection:";
3220 const char* cur = ptr[x];
3221 if (option_starts_with(usesel, cur))
3223 const char* val = &cur[strlen(usesel)];
3225 rc = COMMAND_LINE_ERROR_MEMORY;
3227 return COMMAND_LINE_ERROR;
3229 else if (option_starts_with(
"direction-to", cur))
3233 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3234 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3238 case CLIP_DIR_PARSE_ALL:
3239 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3241 case CLIP_DIR_PARSE_LOCAL:
3242 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3244 case CLIP_DIR_PARSE_REMOTE:
3245 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3247 case CLIP_DIR_PARSE_OFF:
3249 case CLIP_DIR_PARSE_FAIL:
3251 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3257 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3259 else if (option_starts_with(
"files-to", cur))
3263 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3264 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3265 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3269 case CLIP_DIR_PARSE_ALL:
3271 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3273 case CLIP_DIR_PARSE_LOCAL:
3274 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3276 case CLIP_DIR_PARSE_REMOTE:
3277 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3279 case CLIP_DIR_PARSE_OFF:
3281 case CLIP_DIR_PARSE_FAIL:
3283 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3289 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3292 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3294 CommandLineParserFree(ptr);
3304 WINPR_ASSERT(settings);
3309 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3311 if (strcmp(arg->Value,
"none") == 0)
3312 val = AUDIO_MODE_NONE;
3313 else if (strcmp(arg->Value,
"redirect") == 0)
3314 val = AUDIO_MODE_REDIRECT;
3315 else if (strcmp(arg->Value,
"server") == 0)
3316 val = AUDIO_MODE_PLAY_ON_SERVER;
3317 else if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3318 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3322 case AUDIO_MODE_REDIRECT:
3324 return COMMAND_LINE_ERROR;
3327 case AUDIO_MODE_PLAY_ON_SERVER:
3329 return COMMAND_LINE_ERROR;
3332 case AUDIO_MODE_NONE:
3334 return COMMAND_LINE_ERROR;
3336 return COMMAND_LINE_ERROR;
3340 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3347 WINPR_ASSERT(settings);
3350 UINT32 type = CONNECTION_TYPE_INVALID;
3352 if (option_equals(arg->Value,
"invalid"))
3353 type = CONNECTION_TYPE_INVALID;
3354 else if (option_equals(arg->Value,
"modem"))
3355 type = CONNECTION_TYPE_MODEM;
3356 else if (option_equals(arg->Value,
"broadband"))
3357 type = CONNECTION_TYPE_BROADBAND_HIGH;
3358 else if (option_equals(arg->Value,
"broadband-low"))
3359 type = CONNECTION_TYPE_BROADBAND_LOW;
3360 else if (option_equals(arg->Value,
"broadband-high"))
3361 type = CONNECTION_TYPE_BROADBAND_HIGH;
3362 else if (option_equals(arg->Value,
"wan"))
3363 type = CONNECTION_TYPE_WAN;
3364 else if (option_equals(arg->Value,
"lan"))
3365 type = CONNECTION_TYPE_LAN;
3366 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3367 (option_equals(arg->Value,
"detect")))
3369 type = CONNECTION_TYPE_AUTODETECT;
3375 if (!value_to_int(arg->Value, &val, 0, 7))
3376 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3381 if (!freerdp_set_connection_type(settings, type))
3382 return COMMAND_LINE_ERROR;
3388 WINPR_ASSERT(settings);
3392 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3394 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3396 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3397 for (
size_t x = 0; x < count; x++)
3399 const char* cur = ptr[x];
3400 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3401 if (bval == PARSE_FAIL)
3403 CommandLineParserFree(ptr);
3404 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3407 const BOOL val = bval != PARSE_OFF;
3408 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3409 if (option_starts_with(
"rdp", cur))
3411 id = FreeRDP_RdpSecurity;
3413 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3415 else if (option_starts_with(
"tls", cur))
3416 id = FreeRDP_TlsSecurity;
3417 else if (option_starts_with(
"nla", cur))
3418 id = FreeRDP_NlaSecurity;
3419 else if (option_starts_with(
"ext", cur))
3420 id = FreeRDP_ExtSecurity;
3421 else if (option_equals(
"aad", cur))
3422 id = FreeRDP_AadSecurity;
3425 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3426 CommandLineParserFree(ptr);
3427 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3430 if ((bval == PARSE_NONE) && (count == 1))
3431 singleOptionWithoutOnOff = id;
3433 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3436 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3438 const FreeRDP_Settings_Keys_Bool options[] = { FreeRDP_AadSecurity,
3439 FreeRDP_UseRdpSecurityLayer,
3440 FreeRDP_RdpSecurity, FreeRDP_NlaSecurity,
3441 FreeRDP_TlsSecurity };
3443 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3446 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3450 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3451 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3454 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3457 CommandLineParserFree(ptr);
3461static int parse_encryption_methods_options(rdpSettings* settings,
3464 WINPR_ASSERT(settings);
3467 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3470 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3472 UINT32 EncryptionMethods = 0;
3473 for (UINT32 i = 0; i < count; i++)
3475 if (option_equals(ptr[i],
"40"))
3476 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3477 else if (option_equals(ptr[i],
"56"))
3478 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3479 else if (option_equals(ptr[i],
"128"))
3480 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3481 else if (option_equals(ptr[i],
"FIPS"))
3482 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3484 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3488 return COMMAND_LINE_ERROR;
3489 CommandLineParserFree(ptr);
3496 WINPR_ASSERT(settings);
3501 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3502 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3504 const char deny[] =
"deny";
3505 const char ignore[] =
"ignore";
3506 const char tofu[] =
"tofu";
3507 const char name[] =
"name:";
3508 const char fingerprints[] =
"fingerprint:";
3510 const char* cur = ptr[x];
3511 if (option_equals(deny, cur))
3514 return COMMAND_LINE_ERROR;
3516 else if (option_equals(ignore, cur))
3519 return COMMAND_LINE_ERROR;
3521 else if (option_equals(tofu, cur))
3524 return COMMAND_LINE_ERROR;
3526 else if (option_starts_with(name, cur))
3528 const char* val = &cur[strnlen(name,
sizeof(name))];
3530 rc = COMMAND_LINE_ERROR_MEMORY;
3532 else if (option_starts_with(fingerprints, cur))
3534 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3537 rc = COMMAND_LINE_ERROR_MEMORY;
3540 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3542 CommandLineParserFree(ptr);
3549 WINPR_ASSERT(settings);
3553 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3557 for (
size_t x = 1; x < count; x++)
3559 const char* cur = ptr[x];
3561 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3562 if (bval == PARSE_FAIL)
3563 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3566 const BOOL val = bval != PARSE_OFF;
3568 if (option_starts_with(
"relative", cur))
3571 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3573 else if (option_starts_with(
"grab", cur))
3576 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3584 CommandLineParserFree(ptr);
3591 WINPR_ASSERT(settings);
3595 UINT32 Floatbar = 0x0017;
3599 char* start = arg->Value;
3604 start = strchr(start,
',');
3613 if (option_starts_with(
"sticky:", cur))
3617 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3629 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3633 else if (option_starts_with(
"default:", cur))
3635 const char* val = cur + 8;
3638 if (option_equals(
"visible", val))
3640 else if (option_equals(
"hidden", val))
3643 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3646 else if (option_starts_with(
"show:", cur))
3648 const char* val = cur + 5;
3651 if (option_equals(
"always", val))
3653 else if (option_equals(
"fullscreen", val))
3655 else if (option_equals(
"window", val))
3658 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3661 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3665 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3671 WINPR_ASSERT(settings);
3674 BYTE* base64 =
nullptr;
3677 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3679 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3685 return COMMAND_LINE_ERROR;
3689 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3696static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3698 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3706 WINPR_ASSERT(settings);
3711 if (!value_to_int(arg->Value, &val, 100, 180))
3712 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3720 return COMMAND_LINE_ERROR;
3722 return COMMAND_LINE_ERROR;
3723 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3724 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3725 return fail_at(arg, COMMAND_LINE_ERROR);
3729 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3736 WINPR_ASSERT(settings);
3741 if (!value_to_int(arg->Value, &val, 100, 180))
3742 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3750 return COMMAND_LINE_ERROR;
3751 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3752 return fail_at(arg, COMMAND_LINE_ERROR);
3756 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3763 WINPR_ASSERT(settings);
3769 return COMMAND_LINE_ERROR;
3771 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3774 const CmdLineSubOptions opts[] = {
3775 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3776 setSmartcardEmulation },
3777 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3778 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING,
nullptr },
3779 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING,
nullptr },
3780 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING,
nullptr },
3781 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING,
nullptr },
3782 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING,
nullptr }
3785 for (
size_t x = 1; x < count; x++)
3787 const char* cur = ptr[x];
3788 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
3790 CommandLineParserFree(ptr);
3791 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3795 CommandLineParserFree(ptr);
3801 WINPR_ASSERT(settings);
3805 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
3807 return COMMAND_LINE_ERROR;
3808 for (
size_t x = 1; x < count; x++)
3810 const char* cur = ptr[x];
3811 char* sep = strchr(cur,
':');
3814 CommandLineParserFree(ptr);
3815 return COMMAND_LINE_ERROR;
3818 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
3820 CommandLineParserFree(ptr);
3821 return COMMAND_LINE_ERROR;
3825 CommandLineParserFree(ptr);
3829static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
3831 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
3832 FreeRDP_RemoteAppLanguageBarSupported,
3833 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
3834 FreeRDP_DisableFullWindowDrag };
3837 return COMMAND_LINE_ERROR_MEMORY;
3839 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
3842 return COMMAND_LINE_ERROR;
3844 return CHANNEL_RC_OK;
3849 WINPR_ASSERT(settings);
3852 int rc = CHANNEL_RC_OK;
3854 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3855 if (!ptr || (count == 0))
3856 rc = COMMAND_LINE_ERROR;
3863 int (*fkt)(rdpSettings* settings,
const char* value);
3865 const struct app_map amap[] = {
3866 {
"tenantid:", FreeRDP_GatewayAvdAadtenantid,
nullptr },
3867 {
"ad:", FreeRDP_GatewayAzureActiveDirectory,
nullptr },
3868 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat,
nullptr },
3869 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat,
nullptr },
3870 {
"avd-scope:", FreeRDP_GatewayAvdScope,
nullptr }
3873 for (
size_t x = 0; x < count; x++)
3875 BOOL handled = FALSE;
3876 const char* val = ptr[x];
3878 if (option_starts_with(
"use-tenantid", val))
3880 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3881 if (bval == PARSE_FAIL)
3883 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3891 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3897 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3899 const struct app_map* cur = &amap[y];
3900 if (option_starts_with(cur->name, val))
3902 const char* xval = &val[strlen(cur->name)];
3904 rc = cur->fkt(settings, xval);
3908 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3909 rc = COMMAND_LINE_ERROR_MEMORY;
3918 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3925 CommandLineParserFree(ptr);
3931 WINPR_ASSERT(settings);
3934 int rc = CHANNEL_RC_OK;
3936 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3937 if (!ptr || (count == 0))
3938 rc = COMMAND_LINE_ERROR;
3945 int (*fkt)(rdpSettings* settings,
const char* value);
3947 const struct app_map amap[] = {
3948 {
"program:", FreeRDP_RemoteApplicationProgram, parse_app_option_program },
3949 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir,
nullptr },
3950 {
"name:", FreeRDP_RemoteApplicationName,
nullptr },
3951 {
"icon:", FreeRDP_RemoteApplicationIcon,
nullptr },
3952 {
"cmd:", FreeRDP_RemoteApplicationCmdLine,
nullptr },
3953 {
"file:", FreeRDP_RemoteApplicationFile,
nullptr },
3954 {
"guid:", FreeRDP_RemoteApplicationGuid,
nullptr },
3955 {
"hidef:", FreeRDP_HiDefRemoteApp,
nullptr }
3957 for (
size_t x = 0; x < count; x++)
3959 BOOL handled = FALSE;
3960 const char* val = ptr[x];
3962 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
3964 const struct app_map* cur = &amap[y];
3965 if (option_starts_with(cur->name, val))
3967 const char* xval = &val[strlen(cur->name)];
3969 rc = cur->fkt(settings, xval);
3973 if (!freerdp_settings_set_value_for_name(settings, name, xval))
3974 rc = COMMAND_LINE_ERROR_MEMORY;
3982#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3983 if (!handled && (count == 1))
3986 rc = parse_app_option_program(settings, val);
3991 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3998 CommandLineParserFree(ptr);
4004 WINPR_ASSERT(settings);
4007 int rc = CHANNEL_RC_OK;
4009 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4010 if (!ptr || (count == 0))
4011 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4013 for (
size_t x = 0; x < count; x++)
4015 const char* val = ptr[x];
4017 if (option_starts_with(
"codec:", val))
4020 rc = COMMAND_LINE_ERROR;
4021 else if (option_equals(arg->Value,
"rfx"))
4024 rc = COMMAND_LINE_ERROR;
4026 else if (option_equals(arg->Value,
"nsc"))
4029 rc = COMMAND_LINE_ERROR;
4032#if defined(WITH_JPEG)
4033 else if (option_equals(arg->Value,
"jpeg"))
4036 rc = COMMAND_LINE_ERROR;
4041 return COMMAND_LINE_ERROR;
4047 else if (option_starts_with(
"persist-file:", val))
4051 rc = COMMAND_LINE_ERROR_MEMORY;
4053 rc = COMMAND_LINE_ERROR;
4057 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
4058 if (bval == PARSE_FAIL)
4059 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4062 if (option_starts_with(
"bitmap", val))
4066 rc = COMMAND_LINE_ERROR;
4068 else if (option_starts_with(
"glyph", val))
4071 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
4072 : GLYPH_SUPPORT_NONE))
4073 rc = COMMAND_LINE_ERROR;
4075 else if (option_starts_with(
"persist", val))
4079 rc = COMMAND_LINE_ERROR;
4081 else if (option_starts_with(
"offscreen", val))
4085 rc = COMMAND_LINE_ERROR;
4091 CommandLineParserFree(ptr);
4095static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
4097 WINPR_ASSERT(settings);
4100 char* name =
nullptr;
4102 if (!freerdp_parse_hostname(host, &name, &port))
4121static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
4122 FreeRDP_Settings_Keys_String what)
4124 WINPR_ASSERT(settings);
4125 WINPR_ASSERT(value);
4129 case FreeRDP_GatewayUsername:
4130 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4131 FreeRDP_GatewayDomain))
4143static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4147 WINPR_ASSERT(settings);
4148 WINPR_ASSERT(value);
4150 if (option_equals(value,
"rpc"))
4161 if (option_equals(value,
"http"))
4169 else if (option_equals(value,
"auto"))
4177 else if (option_equals(value,
"arm"))
4190static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4194 WINPR_ASSERT(settings);
4195 WINPR_ASSERT(value);
4197 if (option_equals(value,
"none"))
4198 type = TSC_PROXY_MODE_NONE_DIRECT;
4199 else if (option_equals(value,
"direct"))
4200 type = TSC_PROXY_MODE_DIRECT;
4201 else if (option_equals(value,
"detect"))
4202 type = TSC_PROXY_MODE_DETECT;
4203 else if (option_equals(value,
"default"))
4204 type = TSC_PROXY_MODE_DEFAULT;
4209 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4211 type = WINPR_ASSERTING_INT_CAST(UINT32, val);
4217static char* unescape(
const char* str)
4219 char* copy = _strdup(str);
4223 bool escaped =
false;
4225 while (*str !=
'\0')
4253 char* argval =
nullptr;
4256 WINPR_ASSERT(settings);
4260 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4269 BOOL allowHttpOpts = FALSE;
4270 for (
size_t x = 0; x < count; x++)
4272 BOOL validOption = FALSE;
4274 argval = unescape(ptr[x]);
4278 const char* gw = option_starts_with(
"g:", argval);
4281 if (!parse_gateway_host_option(settings, gw))
4284 allowHttpOpts = FALSE;
4287 const char* gu = option_starts_with(
"u:", argval);
4290 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4293 allowHttpOpts = FALSE;
4296 const char* gd = option_starts_with(
"d:", argval);
4299 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4302 allowHttpOpts = FALSE;
4305 const char* gp = option_starts_with(
"p:", argval);
4308 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4311 allowHttpOpts = FALSE;
4314 const char* gt = option_starts_with(
"type:", argval);
4317 if (!parse_gateway_type_option(settings, gt))
4323 const char* gat = option_starts_with(
"access-token:", argval);
4329 allowHttpOpts = FALSE;
4332 const char* bearer = option_starts_with(
"bearer:", argval);
4339 allowHttpOpts = FALSE;
4342 const char* gwurl = option_starts_with(
"url:", argval);
4350 allowHttpOpts = FALSE;
4353 const char* um = option_starts_with(
"usage-method:", argval);
4356 if (!parse_gateway_usage_option(settings, um))
4359 allowHttpOpts = FALSE;
4364 if (option_equals(argval,
"no-websockets"))
4371 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4388 CommandLineParserFree(ptr);
4395 WINPR_ASSERT(value);
4401 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4402 FillMemory(arg->Value, strlen(arg->Value),
'*');
4407 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4409 const char* cred = credential_args[x];
4410 fill_credential_string(args, cred);
4414 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4416 const char* gwcreds[] = {
"p:",
"access-token:" };
4417 char* saveptr =
nullptr;
4418 char* tok = strtok_s(arg->Value,
",", &saveptr);
4421 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4423 const char* opt = gwcreds[x];
4424 if (option_starts_with(opt, tok))
4426 char* val = &tok[strlen(opt)];
4427 FillMemory(val, strlen(val),
'*');
4430 tok = strtok_s(
nullptr,
",", &saveptr);
4435static int parse_command_line_option_uint32(rdpSettings* settings,
4437 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4442 if (!value_to_int(arg->Value, &val, min, max))
4443 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4446 return fail_at(arg, COMMAND_LINE_ERROR);
4450#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4455 WINPR_ASSERT(settings);
4458 BOOL enable = arg->Value ? TRUE : FALSE;
4459 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4461 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4463 return fail_at(arg, COMMAND_LINE_ERROR);
4468 return fail_at(arg, COMMAND_LINE_ERROR);
4472 return fail_at(arg, COMMAND_LINE_ERROR);
4474 CommandLineSwitchCase(arg,
"gfx-small-cache")
4476 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4478 return fail_at(arg, COMMAND_LINE_ERROR);
4482 return fail_at(arg, COMMAND_LINE_ERROR);
4484 CommandLineSwitchCase(arg,
"gfx-progressive")
4486 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4488 return fail_at(arg, COMMAND_LINE_ERROR);
4490 return fail_at(arg, COMMAND_LINE_ERROR);
4495 return fail_at(arg, COMMAND_LINE_ERROR);
4499 CommandLineSwitchCase(arg,
"gfx-h264")
4501 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4502 int rc = parse_gfx_options(settings, arg);
4504 return fail_at(arg, rc);
4507 CommandLineSwitchCase(arg,
"app-workdir")
4510 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4512 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4514 CommandLineSwitchCase(arg,
"app-name")
4516 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4518 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4520 CommandLineSwitchCase(arg,
"app-icon")
4522 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4524 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4526 CommandLineSwitchCase(arg,
"app-cmd")
4528 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4530 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4532 CommandLineSwitchCase(arg,
"app-file")
4534 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4536 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4538 CommandLineSwitchCase(arg,
"app-guid")
4540 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4542 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4544 CommandLineSwitchCase(arg,
"g")
4546 if (!parse_gateway_host_option(settings, arg->Value))
4547 return fail_at(arg, COMMAND_LINE_ERROR);
4549 CommandLineSwitchCase(arg,
"gu")
4551 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4552 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4554 CommandLineSwitchCase(arg,
"gd")
4556 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4557 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4559 CommandLineSwitchCase(arg,
"gp")
4561 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4562 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4564 CommandLineSwitchCase(arg,
"gt")
4566 if (!parse_gateway_type_option(settings, arg->Value))
4567 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4569 CommandLineSwitchCase(arg,
"gat")
4572 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4574 CommandLineSwitchCase(arg,
"gateway-usage-method")
4576 if (!parse_gateway_usage_option(settings, arg->Value))
4577 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4579 CommandLineSwitchCase(arg,
"kbd-remap")
4581 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4582 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4584 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4586 CommandLineSwitchCase(arg,
"kbd-lang")
4590 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4591 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4593 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4594 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4595 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4599 return fail_at(arg, COMMAND_LINE_ERROR);
4601 CommandLineSwitchCase(arg,
"kbd-type")
4603 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4605 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4607 return fail_at(arg, rc);
4609 CommandLineSwitchCase(arg,
"kbd-unicode")
4611 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4613 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4615 CommandLineSwitchCase(arg,
"kbd-subtype")
4617 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4619 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4621 return fail_at(arg, rc);
4623 CommandLineSwitchCase(arg,
"kbd-fn-key")
4625 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4626 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4629 return fail_at(arg, rc);
4631 CommandLineSwitchCase(arg,
"bitmap-cache")
4633 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4635 return fail_at(arg, COMMAND_LINE_ERROR);
4637 CommandLineSwitchCase(arg,
"persist-cache")
4639 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4641 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4643 CommandLineSwitchCase(arg,
"persist-cache-file")
4645 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4646 "/cache:persist-file:<filename> instead");
4648 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4651 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4653 CommandLineSwitchCase(arg,
"offscreen-cache")
4655 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4657 return fail_at(arg, COMMAND_LINE_ERROR);
4659 CommandLineSwitchCase(arg,
"glyph-cache")
4661 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4663 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4664 return fail_at(arg, COMMAND_LINE_ERROR);
4666 CommandLineSwitchCase(arg,
"codec-cache")
4668 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4669 const int rc = parse_codec_cache_options(settings, arg);
4671 return fail_at(arg, rc);
4673 CommandLineSwitchCase(arg,
"sec-rdp")
4675 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4677 return fail_at(arg, COMMAND_LINE_ERROR);
4679 CommandLineSwitchCase(arg,
"sec-tls")
4681 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4683 return fail_at(arg, COMMAND_LINE_ERROR);
4685 CommandLineSwitchCase(arg,
"sec-nla")
4687 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4689 return fail_at(arg, COMMAND_LINE_ERROR);
4691 CommandLineSwitchCase(arg,
"sec-ext")
4693 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4695 return fail_at(arg, COMMAND_LINE_ERROR);
4697 CommandLineSwitchCase(arg,
"tls-ciphers")
4699 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4700 "/tls:ciphers:<cipher list> instead");
4701 int rc = parse_tls_cipher_options(settings, arg);
4703 return fail_at(arg, rc);
4705 CommandLineSwitchCase(arg,
"tls-seclevel")
4707 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4708 int rc = parse_tls_cipher_options(settings, arg);
4710 return fail_at(arg, rc);
4712 CommandLineSwitchCase(arg,
"tls-secrets-file")
4714 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4715 "/tls:secrets-file:<filename> instead");
4716 int rc = parse_tls_cipher_options(settings, arg);
4718 return fail_at(arg, rc);
4720 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4722 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4723 int rc = parse_tls_cipher_options(settings, arg);
4725 return fail_at(arg, rc);
4727 CommandLineSwitchCase(arg,
"cert-name")
4729 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4731 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4733 CommandLineSwitchCase(arg,
"cert-ignore")
4735 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4737 return fail_at(arg, COMMAND_LINE_ERROR);
4739 CommandLineSwitchCase(arg,
"cert-tofu")
4741 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4743 return fail_at(arg, COMMAND_LINE_ERROR);
4745 CommandLineSwitchCase(arg,
"cert-deny")
4747 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4749 return fail_at(arg, COMMAND_LINE_ERROR);
4751 CommandLineSwitchDefault(arg)
4755 CommandLineSwitchEnd(arg);
4760static int parse_command_line_option_timezone(rdpSettings* settings,
4766 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
4767 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
4769 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
4770 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
4772 WINPR_ASSERT(arg->Value);
4773 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
4780 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4783 return fail_at(arg, COMMAND_LINE_ERROR);
4788 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4790 tz->Bias = info.Bias;
4791 tz->DaylightBias = info.DaylightBias;
4792 tz->DaylightDate = info.DaylightDate;
4793 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
4794 tz->StandardBias = info.StandardBias;
4795 tz->StandardDate = info.StandardDate;
4796 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
4801static int parse_command_line_option_window_pos(rdpSettings* settings,
4804 WINPR_ASSERT(settings);
4807 unsigned long x = 0;
4808 unsigned long y = 0;
4811 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4813 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
4815 WLog_ERR(TAG,
"invalid window-position argument");
4816 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
4820 return fail_at(arg, COMMAND_LINE_ERROR);
4822 return fail_at(arg, COMMAND_LINE_ERROR);
4827 freerdp_command_line_handle_option_t handle_option,
4828 void* handle_userdata, BOOL* promptForPassword,
char** user)
4830 WINPR_ASSERT(promptForPassword);
4835 BOOL enable = (arg->Value !=
nullptr);
4837 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
4840 CommandLineSwitchStart(arg)
4842 CommandLineSwitchCase(arg,
"v")
4844 const int rc = parse_host_options(settings, arg);
4846 return fail_at(arg, rc);
4848 CommandLineSwitchCase(arg,
"spn-class")
4852 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4854 CommandLineSwitchCase(arg,
"sspi-module")
4857 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4859 CommandLineSwitchCase(arg,
"winscard-module")
4862 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4864 CommandLineSwitchCase(arg,
"redirect-prefer")
4866 const int rc = parse_redirect_prefer_options(settings, arg);
4868 return fail_at(arg, rc);
4870 CommandLineSwitchCase(arg,
"credentials-delegation")
4873 return fail_at(arg, COMMAND_LINE_ERROR);
4875 CommandLineSwitchCase(arg,
"prevent-session-lock")
4877 const int rc = parse_prevent_session_lock_options(settings, arg);
4879 return fail_at(arg, rc);
4881 CommandLineSwitchCase(arg,
"vmconnect")
4883 const int rc = parse_vmconnect_options(settings, arg);
4885 return fail_at(arg, rc);
4887 CommandLineSwitchCase(arg,
"w")
4889 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
4892 return fail_at(arg, rc);
4894 CommandLineSwitchCase(arg,
"h")
4896 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
4899 return fail_at(arg, rc);
4901 CommandLineSwitchCase(arg,
"size")
4903 const int rc = parse_size_options(settings, arg);
4905 return fail_at(arg, rc);
4907 CommandLineSwitchCase(arg,
"f")
4910 return fail_at(arg, COMMAND_LINE_ERROR);
4912 CommandLineSwitchCase(arg,
"suppress-output")
4915 return fail_at(arg, COMMAND_LINE_ERROR);
4917 CommandLineSwitchCase(arg,
"multimon")
4920 return fail_at(arg, COMMAND_LINE_ERROR);
4922 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4924 if (option_equals(arg->Value, str_force))
4927 return fail_at(arg, COMMAND_LINE_ERROR);
4931 CommandLineSwitchCase(arg,
"span")
4934 return fail_at(arg, COMMAND_LINE_ERROR);
4936 CommandLineSwitchCase(arg,
"workarea")
4939 return fail_at(arg, COMMAND_LINE_ERROR);
4941 CommandLineSwitchCase(arg,
"monitors")
4943 const int rc = parse_monitors_options(settings, arg);
4945 return fail_at(arg, rc);
4947 CommandLineSwitchCase(arg,
"t")
4950 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4952 CommandLineSwitchCase(arg,
"decorations")
4955 return fail_at(arg, COMMAND_LINE_ERROR);
4957 CommandLineSwitchCase(arg,
"dynamic-resolution")
4959 const int rc = parse_dynamic_resolution_options(settings, arg);
4961 return fail_at(arg, rc);
4963 CommandLineSwitchCase(arg,
"smart-sizing")
4965 const int rc = parse_smart_sizing_options(settings, arg);
4967 return fail_at(arg, rc);
4969 CommandLineSwitchCase(arg,
"bpp")
4971 const int rc = parse_bpp_options(settings, arg);
4973 return fail_at(arg, rc);
4975 CommandLineSwitchCase(arg,
"admin")
4978 return fail_at(arg, COMMAND_LINE_ERROR);
4980 CommandLineSwitchCase(arg,
"relax-order-checks")
4984 return fail_at(arg, COMMAND_LINE_ERROR);
4986 CommandLineSwitchCase(arg,
"restricted-admin")
4989 return fail_at(arg, COMMAND_LINE_ERROR);
4991 return fail_at(arg, COMMAND_LINE_ERROR);
4993#ifdef CHANNEL_RDPEAR_CLIENT
4994 CommandLineSwitchCase(arg,
"remoteGuard")
4997 return fail_at(arg, COMMAND_LINE_ERROR);
4999 return fail_at(arg, COMMAND_LINE_ERROR);
5002 CommandLineSwitchCase(arg,
"pth")
5005 return fail_at(arg, COMMAND_LINE_ERROR);
5007 return fail_at(arg, COMMAND_LINE_ERROR);
5010 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5012 CommandLineSwitchCase(arg,
"client-hostname")
5015 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5017 CommandLineSwitchCase(arg,
"kbd")
5019 int rc = parse_kbd_options(settings, arg);
5021 return fail_at(arg, rc);
5024 CommandLineSwitchCase(arg,
"u")
5026 WINPR_ASSERT(arg->Value);
5029 CommandLineSwitchCase(arg,
"d")
5032 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5034 CommandLineSwitchCase(arg,
"p")
5038 const char* val = arg->Value;
5043 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5045 CommandLineSwitchCase(arg,
"gateway")
5047 if (!parse_gateway_options(settings, arg))
5048 return fail_at(arg, COMMAND_LINE_ERROR);
5050 CommandLineSwitchCase(arg,
"proxy")
5052 const int rc = parse_proxy_options(settings, arg);
5054 return fail_at(arg, rc);
5057 CommandLineSwitchCase(arg,
"azure")
5059 int rc = parse_aad_options(settings, arg);
5061 return fail_at(arg, rc);
5063 CommandLineSwitchCase(arg,
"app")
5065 int rc = parse_app_options(settings, arg);
5067 return fail_at(arg, rc);
5069 CommandLineSwitchCase(arg,
"load-balance-info")
5071 WINPR_ASSERT(arg->Value);
5073 strlen(arg->Value)))
5074 return fail_at(arg, COMMAND_LINE_ERROR);
5077 CommandLineSwitchCase(arg,
"compression")
5080 return fail_at(arg, COMMAND_LINE_ERROR);
5082 CommandLineSwitchCase(arg,
"compression-level")
5084 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
5087 return fail_at(arg, rc);
5089 CommandLineSwitchCase(arg,
"drives")
5092 return fail_at(arg, COMMAND_LINE_ERROR);
5094 CommandLineSwitchCase(arg,
"dump")
5096 const int rc = parse_dump_options(settings, arg);
5098 return fail_at(arg, rc);
5100 CommandLineSwitchCase(arg,
"disable-output")
5103 return fail_at(arg, COMMAND_LINE_ERROR);
5105 CommandLineSwitchCase(arg,
"home-drive")
5108 return fail_at(arg, COMMAND_LINE_ERROR);
5110 CommandLineSwitchCase(arg,
"ipv4")
5112 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5115 return fail_at(arg, COMMAND_LINE_ERROR);
5120 return fail_at(arg, COMMAND_LINE_ERROR);
5123 CommandLineSwitchCase(arg,
"ipv6")
5125 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5128 return fail_at(arg, COMMAND_LINE_ERROR);
5133 return fail_at(arg, COMMAND_LINE_ERROR);
5136 CommandLineSwitchCase(arg,
"clipboard")
5138 const int rc = parse_clipboard_options(settings, arg);
5140 return fail_at(arg, rc);
5142 CommandLineSwitchCase(arg,
"server-name")
5145 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5147 CommandLineSwitchCase(arg,
"shell")
5150 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5152 CommandLineSwitchCase(arg,
"shell-dir")
5155 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5157 CommandLineSwitchCase(arg,
"audio-mode")
5159 const int rc = parse_audio_mode_options(settings, arg);
5161 return fail_at(arg, rc);
5163 CommandLineSwitchCase(arg,
"network")
5165 const int rc = parse_network_options(settings, arg);
5167 return fail_at(arg, rc);
5169 CommandLineSwitchCase(arg,
"fonts")
5172 return fail_at(arg, COMMAND_LINE_ERROR);
5174 CommandLineSwitchCase(arg,
"wallpaper")
5177 return fail_at(arg, COMMAND_LINE_ERROR);
5179 CommandLineSwitchCase(arg,
"window-drag")
5182 return fail_at(arg, COMMAND_LINE_ERROR);
5184 CommandLineSwitchCase(arg,
"window-position")
5186 const int rc = parse_command_line_option_window_pos(settings, arg);
5188 return fail_at(arg, rc);
5190 CommandLineSwitchCase(arg,
"menu-anims")
5193 return fail_at(arg, COMMAND_LINE_ERROR);
5195 CommandLineSwitchCase(arg,
"themes")
5198 return fail_at(arg, COMMAND_LINE_ERROR);
5200 CommandLineSwitchCase(arg,
"timeout")
5203 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5205 return fail_at(arg, rc);
5207 CommandLineSwitchCase(arg,
"timezone")
5209 const int rc = parse_command_line_option_timezone(settings, arg);
5211 return fail_at(arg, rc);
5213 CommandLineSwitchCase(arg,
"aero")
5216 return fail_at(arg, COMMAND_LINE_ERROR);
5218 CommandLineSwitchCase(arg,
"gdi")
5220 if (option_equals(arg->Value,
"sw"))
5223 return fail_at(arg, COMMAND_LINE_ERROR);
5225 else if (option_equals(arg->Value,
"hw"))
5228 return fail_at(arg, COMMAND_LINE_ERROR);
5231 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5233 CommandLineSwitchCase(arg,
"gfx")
5235 int rc = parse_gfx_options(settings, arg);
5237 return fail_at(arg, rc);
5240 CommandLineSwitchCase(arg,
"rfx")
5243 return fail_at(arg, COMMAND_LINE_ERROR);
5245 CommandLineSwitchCase(arg,
"rfx-mode")
5248 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5250 if (option_equals(arg->Value,
"video"))
5253 return fail_at(arg, COMMAND_LINE_ERROR);
5255 else if (option_equals(arg->Value,
"image"))
5258 return fail_at(arg, COMMAND_LINE_ERROR);
5260 return fail_at(arg, COMMAND_LINE_ERROR);
5263 CommandLineSwitchCase(arg,
"frame-ack")
5265 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5268 return fail_at(arg, rc);
5270 CommandLineSwitchCase(arg,
"nsc")
5273 return fail_at(arg, COMMAND_LINE_ERROR);
5275#if defined(WITH_JPEG)
5276 CommandLineSwitchCase(arg,
"jpeg")
5279 return fail_at(arg, COMMAND_LINE_ERROR);
5281 return fail_at(arg, COMMAND_LINE_ERROR);
5283 CommandLineSwitchCase(arg,
"jpeg-quality")
5287 if (!value_to_int(arg->Value, &val, 0, 100))
5288 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5291 return fail_at(arg, COMMAND_LINE_ERROR);
5294 CommandLineSwitchCase(arg,
"nego")
5297 return fail_at(arg, COMMAND_LINE_ERROR);
5299 CommandLineSwitchCase(arg,
"pcb")
5302 return fail_at(arg, COMMAND_LINE_ERROR);
5305 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5307 CommandLineSwitchCase(arg,
"pcid")
5309 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5312 return fail_at(arg, rc);
5314 return fail_at(arg, COMMAND_LINE_ERROR);
5317 CommandLineSwitchCase(arg,
"connect-child-session")
5331 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5334 CommandLineSwitchCase(arg,
"sec")
5336 const int rc = parse_sec_options(settings, arg);
5338 return fail_at(arg, rc);
5340 CommandLineSwitchCase(arg,
"encryption-methods")
5342 const int rc = parse_encryption_methods_options(settings, arg);
5344 return fail_at(arg, rc);
5346 CommandLineSwitchCase(arg,
"args-from")
5348 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5350 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5352 CommandLineSwitchCase(arg,
"from-stdin")
5355 return fail_at(arg, COMMAND_LINE_ERROR);
5357 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5360 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5361 *promptForPassword = (option_equals(arg->Value, str_force));
5363 if (!*promptForPassword)
5364 return fail_at(arg, COMMAND_LINE_ERROR);
5367 CommandLineSwitchCase(arg,
"log-level")
5369 wLog* root = WLog_GetRoot();
5371 if (!WLog_SetStringLogLevel(root, arg->Value))
5372 return fail_at(arg, COMMAND_LINE_ERROR);
5374 CommandLineSwitchCase(arg,
"log-filters")
5376 if (!WLog_AddStringLogFilters(arg->Value))
5377 return fail_at(arg, COMMAND_LINE_ERROR);
5379 CommandLineSwitchCase(arg,
"tls")
5381 int rc = parse_tls_options(settings, arg);
5383 return fail_at(arg, rc);
5385 CommandLineSwitchCase(arg,
"cert")
5387 const int rc = parse_cert_options(settings, arg);
5389 return fail_at(arg, rc);
5391 CommandLineSwitchCase(arg,
"authentication")
5394 return fail_at(arg, COMMAND_LINE_ERROR);
5396 CommandLineSwitchCase(arg,
"encryption")
5399 return fail_at(arg, COMMAND_LINE_ERROR);
5401 CommandLineSwitchCase(arg,
"grab-keyboard")
5404 return fail_at(arg, COMMAND_LINE_ERROR);
5406 CommandLineSwitchCase(arg,
"grab-mouse")
5409 return fail_at(arg, COMMAND_LINE_ERROR);
5411 CommandLineSwitchCase(arg,
"mouse-relative")
5414 return fail_at(arg, COMMAND_LINE_ERROR);
5416 CommandLineSwitchCase(arg,
"mouse")
5418 const int rc = parse_mouse_options(settings, arg);
5420 return fail_at(arg, rc);
5422 CommandLineSwitchCase(arg,
"unmap-buttons")
5425 return fail_at(arg, COMMAND_LINE_ERROR);
5427 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5430 return fail_at(arg, COMMAND_LINE_ERROR);
5432 CommandLineSwitchCase(arg,
"force-console-callbacks")
5435 return fail_at(arg, COMMAND_LINE_ERROR);
5437 CommandLineSwitchCase(arg,
"floatbar")
5439 const int rc = parse_floatbar_options(settings, arg);
5441 return fail_at(arg, rc);
5443 CommandLineSwitchCase(arg,
"mouse-motion")
5446 return fail_at(arg, COMMAND_LINE_ERROR);
5448 CommandLineSwitchCase(arg,
"parent-window")
5452 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5453 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5456 return fail_at(arg, COMMAND_LINE_ERROR);
5458 CommandLineSwitchCase(arg,
"client-build-number")
5461 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5463 return fail_at(arg, rc);
5465 CommandLineSwitchCase(arg,
"cache")
5467 int rc = parse_cache_options(settings, arg);
5469 return fail_at(arg, rc);
5472 CommandLineSwitchCase(arg,
"max-fast-path-size")
5474 const int rc = parse_command_line_option_uint32(
5475 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5477 return fail_at(arg, rc);
5479 CommandLineSwitchCase(arg,
"auto-request-control")
5483 return fail_at(arg, COMMAND_LINE_ERROR);
5485 CommandLineSwitchCase(arg,
"async-update")
5488 return fail_at(arg, COMMAND_LINE_ERROR);
5490 CommandLineSwitchCase(arg,
"async-channels")
5493 return fail_at(arg, COMMAND_LINE_ERROR);
5495 CommandLineSwitchCase(arg,
"wm-class")
5498 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5500 CommandLineSwitchCase(arg,
"play-rfx")
5503 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5506 return fail_at(arg, COMMAND_LINE_ERROR);
5508 CommandLineSwitchCase(arg,
"auth-only")
5511 return fail_at(arg, COMMAND_LINE_ERROR);
5513 CommandLineSwitchCase(arg,
"auth-pkg-list")
5517 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5519 CommandLineSwitchCase(arg,
"auto-reconnect")
5522 return fail_at(arg, COMMAND_LINE_ERROR);
5524 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5526 const int rc = parse_command_line_option_uint32(
5527 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5529 return fail_at(arg, rc);
5531 CommandLineSwitchCase(arg,
"reconnect-cookie")
5533 const int rc = parse_reconnect_cookie_options(settings, arg);
5535 return fail_at(arg, rc);
5537 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5540 return fail_at(arg, COMMAND_LINE_ERROR);
5542 CommandLineSwitchCase(arg,
"pwidth")
5544 const int rc = parse_command_line_option_uint32(
5545 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5547 return fail_at(arg, rc);
5549 CommandLineSwitchCase(arg,
"pheight")
5551 const int rc = parse_command_line_option_uint32(
5552 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5554 return fail_at(arg, rc);
5556 CommandLineSwitchCase(arg,
"orientation")
5560 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5561 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5564 return fail_at(arg, COMMAND_LINE_ERROR);
5565 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5566 return fail_at(arg, COMMAND_LINE_ERROR);
5568 CommandLineSwitchCase(arg,
"old-license")
5571 return fail_at(arg, COMMAND_LINE_ERROR);
5573 CommandLineSwitchCase(arg,
"scale")
5575 const int rc = parse_scale_options(settings, arg);
5577 return fail_at(arg, rc);
5579 CommandLineSwitchCase(arg,
"scale-desktop")
5581 const int rc = parse_command_line_option_uint32(settings, arg,
5582 FreeRDP_DesktopScaleFactor, 100, 500);
5584 return fail_at(arg, rc);
5585 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5586 return fail_at(arg, COMMAND_LINE_ERROR);
5588 CommandLineSwitchCase(arg,
"scale-device")
5590 const int rc = parse_scale_device_options(settings, arg);
5592 return fail_at(arg, rc);
5594 CommandLineSwitchCase(arg,
"action-script")
5597 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5599 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5602 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5604 CommandLineSwitchCase(arg,
"fipsmode")
5607 return fail_at(arg, COMMAND_LINE_ERROR);
5609 CommandLineSwitchCase(arg,
"smartcard-logon")
5611 const int rc = parse_smartcard_logon_options(settings, arg);
5613 return fail_at(arg, rc);
5615 CommandLineSwitchCase(arg,
"tune")
5617 const int rc = parse_tune_options(settings, arg);
5619 return fail_at(arg, rc);
5621 CommandLineSwitchDefault(arg)
5623#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5624 const int status = parse_deprecated_command_line(settings, arg);
5631 const int rc = handle_option(arg, handle_userdata);
5633 return fail_at(arg, rc);
5636 CommandLineSwitchEnd(arg)
5637 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
5644 bool insecureArgFound =
false;
5645 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5647 const char* cred = credential_args[x];
5651 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5654 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5655 insecureArgFound =
true;
5658 if (insecureArgFound)
5660 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5662 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5663 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file, file descriptor or "
5664 "environment variable");
5665 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5666 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5671static int freerdp_client_settings_parse_command_line_arguments_int(
5672 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5674 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata, UINT32 cmdflags)
5676 char* user =
nullptr;
5679 BOOL assist = FALSE;
5681 BOOL promptForPassword = FALSE;
5682 BOOL compatibility = FALSE;
5690 ext = option_is_rdp_file(argv[1]);
5691 assist = option_is_incident_file(argv[1]);
5694 if (!ext && !assist)
5695 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5697 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5708 WLog_WARN(TAG,
"Unsupported command line syntax!");
5709 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5710 freerdp_getApplicationDetailsString());
5715 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5719 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5720 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5725 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5726 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5729 CommandLineClearArgumentsA(largs);
5730 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5731 freerdp_client_command_line_pre_filter,
5732 freerdp_client_command_line_post_filter);
5737 prepare_default_settings(settings, largs, ext);
5738 if ((cmdflags & FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS) == 0)
5739 warn_credential_args(largs);
5746 return COMMAND_LINE_ERROR_MEMORY;
5748 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
5756 return COMMAND_LINE_ERROR;
5759 return COMMAND_LINE_ERROR;
5761 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
5762 return COMMAND_LINE_ERROR;
5767 return COMMAND_LINE_ERROR;
5771 if (promptForPassword)
5776 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5778 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
5779 ARRAYSIZE(buffer) - 1, 1))
5780 return COMMAND_LINE_ERROR;
5782 return COMMAND_LINE_ERROR;
5790 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
5792 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
5793 ARRAYSIZE(buffer) - 1, 1))
5794 return COMMAND_LINE_ERROR;
5796 return COMMAND_LINE_ERROR;
5801 freerdp_performance_flags_make(settings);
5808 return COMMAND_LINE_ERROR;
5810 return COMMAND_LINE_ERROR;
5813 arg = CommandLineFindArgumentA(largs,
"port");
5814 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
5817 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
5819 return fail_at(arg, rc);
5825 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5826 return fail_at(arg, COMMAND_LINE_ERROR);
5829 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
5832 fill_credential_strings(largs);
5837static void argv_free(
int* pargc,
char** pargv[])
5839 WINPR_ASSERT(pargc);
5840 WINPR_ASSERT(pargv);
5841 const int argc = *pargc;
5842 char** argv = *pargv;
5848 for (
int x = 0; x < argc; x++)
5853static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
5855 WINPR_ASSERT(pargc);
5856 WINPR_ASSERT(pargv);
5864 int nargc = *pargc + 1;
5865 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
5875static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
5877 char* copy =
nullptr;
5879 copy = _strdup(what);
5881 const BOOL rc = argv_append(pargc, pargv, copy);
5887static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
5889 BOOL success = FALSE;
5891 WINPR_ASSERT(aargc);
5892 WINPR_ASSERT(aargv);
5897 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
5900 if (!argv_append_dup(aargc, aargv, cmd))
5904 char* line =
nullptr;
5906 INT64 rc = GetLine(&line, &size, fp);
5907 if ((rc < 0) || !line)
5917 const char cur = (line[rc - 1]);
5918 if ((cur ==
'\n') || (cur ==
'\r'))
5920 line[rc - 1] =
'\0';
5932 if (!argv_append(aargc, aargv, line))
5943 argv_free(aargc, aargv);
5947static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
5950 BOOL success = FALSE;
5951 char* env =
nullptr;
5953 WINPR_ASSERT(aargc);
5954 WINPR_ASSERT(aargv);
5959 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
5964 const DWORD size = GetEnvironmentVariableX(name, env, 0);
5967 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
5970 env = calloc(size + 1,
sizeof(
char));
5975 const DWORD rc = GetEnvironmentVariableX(name, env, size);
5980 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
5986 if (!argv_append_dup(aargc, aargv, cmd))
5990 char* context =
nullptr;
5991 char* tok = strtok_s(env,
"\n", &context);
5994 if (!argv_append_dup(aargc, aargv, tok))
5996 tok = strtok_s(
nullptr,
"\n", &context);
6004 argv_free(aargc, aargv);
6008int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
6009 char* oargv[], BOOL allowUnknown)
6011 return freerdp_client_settings_parse_command_line_arguments_ex(
6012 settings, oargc, oargv, allowUnknown,
nullptr, 0,
nullptr,
nullptr);
6015int freerdp_client_settings_parse_command_line_arguments_ex(
6017 size_t count, freerdp_command_line_handle_option_t handle_option,
void* handle_userdata)
6019 return freerdp_client_settings_parse_command_line_arguments_with_flags(
6020 settings, argc, argv, allowUnknown, args, count, handle_option, handle_userdata, 0);
6023int freerdp_client_settings_parse_command_line_arguments_with_flags(
6024 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
6026 void* handle_userdata, UINT32 flags, ...)
6029 char** argv = oargv;
6032 char** aargv =
nullptr;
6034 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
6036 flags |= FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS;
6037 BOOL success = FALSE;
6038 const char* file = strchr(argv[1],
':') + 1;
6041 if (option_starts_with(
"fd:", file))
6043 ULONGLONG result = 0;
6044 const char* val = strchr(file,
':') + 1;
6045 if (!value_to_uint(val, &result, 0, INT_MAX))
6047 fp = fdopen((
int)result,
"r");
6048 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6050 else if (strncmp(file,
"env:", 4) == 0)
6052 const char* name = strchr(file,
':') + 1;
6053 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
6055 else if (strncmp(file,
"file:", 5) == 0)
6057 file = strchr(file,
':') + 1;
6058 fp = winpr_fopen(file,
"r");
6059 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6061#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
6062 else if (strcmp(file,
"stdin") != 0)
6064 fp = winpr_fopen(file,
"r");
6065 WLog_WARN(TAG,
"/args-from:%s is deprecated, use /args-from:file:%s instead", file,
6067 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6070 else if (strcmp(file,
"stdin") == 0)
6071 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6079 WINPR_ASSERT(count <= SSIZE_MAX);
6085 res = freerdp_client_settings_parse_command_line_arguments_int(
6086 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata, flags);
6089 argv_free(&aargc, &aargv);
6093static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
6094 const char* name,
void* data)
6096 PVIRTUALCHANNELENTRY entry =
nullptr;
6097 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
6098 name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
6099 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
6103 freerdp_load_channel_addin_entry(name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC);
6107 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
6109 WLog_DBG(TAG,
"loading channelEx %s", name);
6115 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
6117 WLog_DBG(TAG,
"loading channel %s", name);
6127 FreeRDP_Settings_Keys_Bool settingId;
6128 const char* channelName;
6132BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
6134 ChannelToLoad dynChannels[] = {
6135#if defined(CHANNEL_AINPUT_CLIENT)
6136 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME,
nullptr },
6138#ifdef CHANNEL_AUDIN_CLIENT
6139 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME,
nullptr },
6141#ifdef CHANNEL_RDPSND_CLIENT
6142 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6144#ifdef CHANNEL_RDPEI_CLIENT
6145 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME,
nullptr },
6147#ifdef CHANNEL_RDPGFX_CLIENT
6148 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME,
nullptr },
6150#ifdef CHANNEL_ECHO_CLIENT
6151 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME,
nullptr },
6153#ifdef CHANNEL_SSHAGENT_CLIENT
6154 { FreeRDP_SupportSSHAgentChannel,
"sshagent",
nullptr },
6156#ifdef CHANNEL_DISP_CLIENT
6157 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME,
nullptr },
6159#ifdef CHANNEL_GEOMETRY_CLIENT
6160 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME,
nullptr },
6162#ifdef CHANNEL_VIDEO_CLIENT
6163 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME,
nullptr },
6165#ifdef CHANNEL_RDPEAR_CLIENT
6166 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME,
nullptr },
6168#ifdef CHANNEL_RDPEWA_CLIENT
6169 { FreeRDP_RedirectWebAuthN, RDPEWA_CHANNEL_NAME,
nullptr },
6173 ChannelToLoad staticChannels[] = {
6174#if defined(CHANNEL_RDPSND_CLIENT)
6175 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6177#if defined(CHANNEL_CLIPRDR_CLIENT)
6178 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME,
nullptr },
6180#if defined(CHANNEL_ENCOMSP_CLIENT)
6181 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6183#if defined(CHANNEL_REMDESK_CLIENT)
6184 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6186#if defined(CHANNEL_RAIL_CLIENT)
6187 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6194 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6196 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6199 const char*
const p[] = { dynChannels[i].channelName };
6201 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6209 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6210 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6211#
if defined(CHANNEL_TSMF_CLIENT)
6212 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6222 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6238 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6246 char* value =
nullptr;
6247 char* tok =
nullptr;
6248 char* context =
nullptr;
6250 value = _strdup(DrivesToRedirect);
6254 tok = strtok_s(value,
";", &context);
6257 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6274 const char* name =
nullptr;
6275 const char* drive = tok;
6276 char* subcontext =
nullptr;
6277 char* start = strtok_s(tok,
"(", &subcontext);
6278 char* end = strtok_s(
nullptr,
")", &subcontext);
6282 if (freerdp_path_valid(name,
nullptr) && freerdp_path_valid(drive,
nullptr))
6284 success = freerdp_client_add_drive(settings, name,
nullptr);
6286 success = freerdp_client_add_drive(settings, drive,
nullptr);
6289 success = freerdp_client_add_drive(settings, drive, name);
6297 tok = strtok_s(
nullptr,
";", &context);
6306 if (!freerdp_device_collection_find(settings,
"drive"))
6308 const char*
const params[] = {
"drive",
"media",
"*" };
6310 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6327 if (!freerdp_device_collection_find(settings,
"drive"))
6329 const char* params[] = {
"drive",
"home",
"%" };
6331 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6338 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6342 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6343 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6345 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6347 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6350 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6357 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6359 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0,
nullptr);
6364 if (!freerdp_device_collection_add(settings, smartcard))
6366 freerdp_device_free(smartcard);
6374 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6376 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0,
nullptr);
6381 if (!freerdp_device_collection_add(settings, printer))
6383 freerdp_device_free(printer);
6410 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6412 if ((staticChannels[i].settingId == 0) ||
6415 if (staticChannels[i].args)
6417 if (!freerdp_client_load_static_channel_addin(
6418 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6423 const char*
const p[] = { staticChannels[i].channelName };
6424 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6434 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6435 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6444 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6446 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6458 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6466void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6468 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6469 const DWORD log_level = WLOG_WARN;
6470 wLog* log = WLog_Get(TAG);
6473 if (!WLog_IsLevelActive(log, log_level))
6476 WLog_Print_unchecked(log, log_level,
"[unmaintained] %s client is currently unmaintained!",
6478 WLog_Print_unchecked(
6480 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6482 WLog_Print_unchecked(
6484 "Be prepared to fix issues yourself though as nobody is actively working on this.");
6485 WLog_Print_unchecked(
6487 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6488 "- don't hesitate to ask some questions. (replies might take some time depending "
6489 "on your timezone) - if you intend using this component write us a message");
6492void freerdp_client_warn_experimental(
int argc,
char* argv[])
6494 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6495 const DWORD log_level = WLOG_WARN;
6496 wLog* log = WLog_Get(TAG);
6499 if (!WLog_IsLevelActive(log, log_level))
6502 WLog_Print_unchecked(log, log_level,
"[experimental] %s client is currently experimental!",
6504 WLog_Print_unchecked(
6506 " If problems occur please check https://github.com/FreeRDP/FreeRDP/issues for "
6507 "known issues or create a new one!");
6508 WLog_Print_unchecked(
6510 " Developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6511 "- don't hesitate to ask some questions. (replies might take some time depending "
6512 "on your timezone)");
6515void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6517 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6518 const DWORD log_level = WLOG_WARN;
6519 wLog* log = WLog_Get(TAG);
6522 if (!WLog_IsLevelActive(log, log_level))
6525 WLog_Print_unchecked(log, log_level,
"[deprecated] %s client has been deprecated", app);
6526 WLog_Print_unchecked(log, log_level,
"As replacement there is a SDL3 based client available.");
6527 WLog_Print_unchecked(
6529 "If you are interested in keeping %s alive get in touch with the developers", app);
6530 WLog_Print_unchecked(
6532 "The project is hosted at https://github.com/freerdp/freerdp and "
6533 " developers hang out in https://matrix.to/#/#FreeRDP:matrix.org?via=matrix.org "
6534 "- don't hesitate to ask some questions. (replies might take some time depending "
6535 "on your timezone)");
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API char * freerdp_settings_get_string_writable(rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a string settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL val)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val, size_t len)
Sets a string settings value. The val is copied.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT16 freerdp_settings_get_uint16(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id)
Returns a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT64 freerdp_settings_get_uint64(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id)
Returns a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint64(rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id, UINT64 val)
Sets a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_append_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *separator, const char *param)
appends a string to a settings value. The param is copied. If the initial value of the setting was no...
WINPR_ATTR_NODISCARD FREERDP_API INT16 freerdp_settings_get_int16(const rdpSettings *settings, FreeRDP_Settings_Keys_Int16 id)
Returns a INT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT64 freerdp_settings_get_int64(const rdpSettings *settings, FreeRDP_Settings_Keys_Int64 id)
Returns a INT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint16(rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id, UINT16 val)
Sets a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val)
Sets a string settings value. The param is copied.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_name_for_key(SSIZE_T key)
Returns the type name for a key.
WINPR_ATTR_NODISCARD FREERDP_API SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.