22#include <freerdp/config.h>
23#include <freerdp/utils/helpers.h>
28#include <winpr/assert.h>
29#include <winpr/string.h>
31#include <winpr/wlog.h>
32#include <winpr/path.h>
33#include <winpr/ncrypt.h>
34#include <winpr/environment.h>
35#include <winpr/timezone.h>
37#include <freerdp/freerdp.h>
38#include <freerdp/addin.h>
39#include <freerdp/settings.h>
40#include <freerdp/client.h>
41#include <freerdp/client/channels.h>
42#include <freerdp/channels/drdynvc.h>
43#include <freerdp/channels/cliprdr.h>
44#include <freerdp/channels/encomsp.h>
45#include <freerdp/channels/rdpear.h>
46#include <freerdp/channels/rdpewa.h>
47#include <freerdp/channels/rdp2tcp.h>
48#include <freerdp/channels/remdesk.h>
49#include <freerdp/channels/rdpsnd.h>
50#include <freerdp/channels/disp.h>
51#include <freerdp/crypto/crypto.h>
52#include <freerdp/locale/keyboard.h>
53#include <freerdp/utils/passphrase.h>
54#include <freerdp/utils/proxy_utils.h>
55#include <freerdp/utils/string.h>
56#include <freerdp/channels/urbdrc.h>
57#include <freerdp/channels/rdpdr.h>
58#include <freerdp/locale/locale.h>
60#include <freerdp/utils/warnings.h>
62#if defined(CHANNEL_AINPUT_CLIENT)
63#include <freerdp/channels/ainput.h>
66#include <freerdp/channels/audin.h>
67#include <freerdp/channels/echo.h>
69#include <freerdp/client/cmdline.h>
70#include <freerdp/version.h>
71#include <freerdp/client/utils/smartcard_cli.h>
73#include <openssl/tls1.h>
76#include <freerdp/log.h>
77#define TAG CLIENT_TAG("common.cmdline")
82 CMDLINE_SUBOPTION_STRING,
83 CMDLINE_SUBOPTION_FILE,
84} CmdLineSubOptionType;
86typedef BOOL (*CmdLineSubOptionCb)(
const char* value, rdpSettings* settings);
90 FreeRDP_Settings_Keys_String id;
91 CmdLineSubOptionType opttype;
92 WINPR_ATTR_NODISCARD CmdLineSubOptionCb cb;
97 FreeRDP_Settings_Keys_Bool settingId;
98 const char* channelName;
106 CLIP_DIR_PARSE_LOCAL,
107 CLIP_DIR_PARSE_REMOTE,
109} PARSE_CLIP_DIR_RESULT;
117} PARSE_ON_OFF_RESULT;
119static const char str_force[] =
"force";
121static const char* credential_args[] = {
"p",
"smartcard-logon",
122#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
125 "pth",
"reconnect-cookie",
138static const char* option_starts_with(
const char* what,
const char* val);
141static BOOL option_ends_with(
const char* str,
const char* ext);
144static BOOL option_equals(
const char* what,
const char* val);
146static BOOL freerdp_client_print_codepages(
const char* arg)
150 const char* filter =
nullptr;
155 filter = strchr(arg,
',');
161 pages = freerdp_keyboard_get_matching_codepages(column, filter, &count);
165 printf(
"%-10s %-8s %-60s %-36s %-48s\n",
"<id>",
"<locale>",
"<win langid>",
"<language>",
167 for (
size_t x = 0; x < count; x++)
170 char buffer[2048] = WINPR_C_ARRAY_INIT;
172 if (strnlen(page->subLanguageSymbol, ARRAYSIZE(page->subLanguageSymbol)) > 0)
173 (void)_snprintf(buffer,
sizeof(buffer),
"[%s|%s]", page->primaryLanguageSymbol,
174 page->subLanguageSymbol);
176 (
void)_snprintf(buffer,
sizeof(buffer),
"[%s]", page->primaryLanguageSymbol);
177 printf(
"id=0x%04" PRIx16
": [%-6s] %-60s %-36s %-48s\n", page->id, page->locale, buffer,
178 page->primaryLanguage, page->subLanguage);
180 freerdp_codepages_free(pages);
185static BOOL freerdp_path_valid(
const char* path, BOOL* special)
187 const char DynamicDrives[] =
"DynamicDrives";
193 isSpecial = (option_equals(
"*", path) || option_equals(DynamicDrives, path) ||
194 option_equals(
"%", path));
196 isPath = winpr_PathFileExists(path);
199 *special = isSpecial;
201 return isSpecial || isPath;
205static BOOL freerdp_sanitize_drive_name(
char* name,
const char* invalid,
const char* replacement)
207 if (!name || !invalid || !replacement)
209 if (strlen(invalid) != strlen(replacement))
212 while (*invalid !=
'\0')
214 const char what = *invalid++;
215 const char with = *replacement++;
218 while ((cur = strchr(cur, what)) !=
nullptr)
224WINPR_ATTR_MALLOC(free, 1)
225static
char* name_from_path(const
char* path)
227 const char* name =
"nullptr";
230 if (option_equals(
"%", path))
232 else if (option_equals(
"*", path))
233 name =
"hotplug-all";
234 else if (option_equals(
"DynamicDrives", path))
239 return _strdup(name);
243static BOOL freerdp_client_add_drive(rdpSettings* settings,
const char* path,
const char* name)
245 char* dname =
nullptr;
264 if (!skip && winpr_PathFileExists(name))
266 if (!winpr_PathFileExists(path) || (!PathIsRelativeA(name) && PathIsRelativeA(path)))
268 const char* tmp = path;
276 dname = _strdup(name);
278 dname = name_from_path(path);
280 if (freerdp_sanitize_drive_name(dname,
"\\/",
"__"))
282 const char* args[] = { dname, path };
283 device = freerdp_device_new(RDPDR_DTYP_FILESYSTEM, ARRAYSIZE(args), args);
293 BOOL isSpecial = FALSE;
294 BOOL isPath = freerdp_path_valid(path, &isSpecial);
296 if (!isPath && !isSpecial)
298 WLog_WARN(TAG,
"Invalid drive to redirect: '%s' does not exist, skipping.", path);
299 freerdp_device_free(device);
301 else if (!freerdp_device_collection_add(settings, device))
308 freerdp_device_free(device);
313static BOOL value_to_int(
const char* value, LONGLONG* result, LONGLONG min, LONGLONG max)
317 if (!value || !result)
321 rc = _strtoi64(value,
nullptr, 0);
326 if ((rc < min) || (rc > max))
334static BOOL value_to_uint(
const char* value, ULONGLONG* result, ULONGLONG min, ULONGLONG max)
336 unsigned long long rc = 0;
338 if (!value || !result)
342 rc = _strtoui64(value,
nullptr, 0);
347 if ((rc < min) || (rc > max))
354BOOL freerdp_client_print_version(
void)
356 printf(
"This is FreeRDP version %s (%s)\n", FREERDP_VERSION_FULL, FREERDP_GIT_REVISION);
360BOOL freerdp_client_print_version_ex(
int argc,
char** argv)
362 WINPR_ASSERT(argc >= 0);
363 WINPR_ASSERT(argv || (argc == 0));
364 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
365 printf(
"This is FreeRDP version [%s] %s (%s)\n", name, FREERDP_VERSION_FULL,
366 FREERDP_GIT_REVISION);
370BOOL freerdp_client_print_buildconfig(
void)
372 printf(
"%s", freerdp_get_build_config());
376BOOL freerdp_client_print_buildconfig_ex(
int argc,
char** argv)
378 WINPR_ASSERT(argc >= 0);
379 WINPR_ASSERT(argv || (argc == 0));
380 const char* name = (argc > 0) ? argv[0] :
"argc < 1";
381 printf(
"[%s] %s", name, freerdp_get_build_config());
385static void freerdp_client_print_scancodes(
void)
387 printf(
"RDP scancodes and their name for use with /kbd:remap\n");
389 for (UINT32 x = 0; x < UINT16_MAX; x++)
391 const char* name = freerdp_keyboard_scancode_name(x);
393 printf(
"0x%04" PRIx32
" --> %s\n", x, name);
398static BOOL is_delimiter(
char c,
const char* delimiters)
401 while ((d = *delimiters++) !=
'\0')
410static const char* get_last(
const char* start,
size_t len,
const char* delimiters)
412 const char* last =
nullptr;
413 for (
size_t x = 0; x < len; x++)
416 if (is_delimiter(c, delimiters))
423static SSIZE_T next_delimiter(
const char* text,
size_t len,
size_t max,
const char* delimiters)
428 const char* last = get_last(text, max, delimiters);
432 return (SSIZE_T)(last - text);
436static SSIZE_T forced_newline_at(
const char* text,
size_t len,
size_t limit,
437 const char* force_newline)
440 while ((d = *force_newline++) !=
'\0')
442 const char* tok = strchr(text, d);
445 const size_t offset = WINPR_ASSERTING_INT_CAST(
size_t, tok - text);
446 if ((offset > len) || (offset > limit))
448 return (SSIZE_T)(offset);
455static BOOL print_align(
size_t start_offset,
size_t* current)
457 WINPR_ASSERT(current);
458 if (*current < start_offset)
460 const int rc = printf(
"%*c", (
int)(start_offset - *current),
' ');
463 *current += (size_t)rc;
468WINPR_ATTR_MALLOC(free, 1)
469static
char* print_token(
char* text,
size_t start_offset,
size_t* current,
size_t limit,
470 const
char* delimiters, const
char* force_newline)
473 const size_t tlen = strnlen(text, limit);
475 const SSIZE_T force_at = forced_newline_at(text, len, limit - *current, force_newline);
476 BOOL isForce = (force_at >= 0);
479 len = MIN(len, (
size_t)force_at);
481 if (!print_align(start_offset, current))
484 const SSIZE_T delim = next_delimiter(text, len, limit - *current, delimiters);
485 const BOOL isDelim = delim > 0;
488 len = MIN(len, (
size_t)delim + 1);
491 rc = printf(
"%.*s", (
int)len, text);
495 if (isForce || isDelim)
500 const size_t offset = len + ((isForce && (force_at == 0)) ? 1 : 0);
501 return &text[offset];
504 *current += (size_t)rc;
506 if (tlen == (
size_t)rc)
508 return &text[(size_t)rc];
512static size_t print_optionals(
const char* text,
size_t start_offset,
size_t current)
514 const size_t limit = 80;
515 char* str = _strdup(text);
520 cur = print_token(cur, start_offset + 1, ¤t, limit,
"[], ",
"\r\n");
521 }
while (cur !=
nullptr);
527static size_t print_description(
const char* text,
size_t start_offset,
size_t current)
529 const size_t limit = 80;
530 char* str = _strdup(text);
533 while (cur !=
nullptr)
534 cur = print_token(cur, start_offset, ¤t, limit,
" ",
"\r\n");
537 const int rc = printf(
"\n");
540 const size_t src = WINPR_ASSERTING_INT_CAST(
size_t, rc);
541 WINPR_ASSERT(SIZE_MAX - src > current);
548static int cmp_cmdline_args(
const void* pva,
const void* pvb)
553 if (!a->Name && !b->Name)
559 return strcmp(a->Name, b->Name);
574 const size_t description_offset = 30 + 8;
576 if (arg->Flags & (COMMAND_LINE_VALUE_BOOL | COMMAND_LINE_VALUE_FLAG))
578 if ((arg->Flags & (uint32_t)~COMMAND_LINE_VALUE_BOOL) == 0)
579 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
580 else if ((arg->Flags & COMMAND_LINE_VALUE_OPTIONAL) != 0)
581 rc = printf(
" [%s|/]%s", arg->Default ?
"-" :
"+", arg->Name);
584 rc = printf(
" %s%s", arg->Default ?
"-" :
"+", arg->Name);
588 rc = printf(
" /%s", arg->Name);
594 if ((arg->Flags & COMMAND_LINE_VALUE_REQUIRED) ||
595 (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL))
599 if (arg->Flags & COMMAND_LINE_VALUE_OPTIONAL)
605 pos = print_optionals(arg->Format, pos, pos);
617 pos = print_optionals(arg->Format, pos, pos);
620 if (pos > description_offset)
628 rc = printf(
"%*c", (
int)(description_offset - pos),
' ');
633 if (arg->Flags & COMMAND_LINE_VALUE_BOOL)
635 rc = printf(
"%s ", arg->Default ?
"Disable" :
"Enable");
641 print_description(arg->Text, description_offset, pos);
642 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
645BOOL freerdp_client_print_command_line_help(
int argc,
char** argv)
647 return freerdp_client_print_command_line_help_ex(argc, argv,
nullptr);
650WINPR_ATTR_MALLOC(free, 1)
652 SSIZE_T count,
size_t* pcount)
654 WINPR_ASSERT(pcount);
659 while (cur && cur->Name)
674 while (cur && cur->Name)
676 largs[lcount++] = *cur++;
679 cur = global_cmd_args;
680 while (cur && cur->Name)
682 largs[lcount++] = *cur++;
688static void freerdp_client_print_command_line_usage(
int argc,
char** argv)
690 WINPR_ASSERT(argv || (argc < 1));
692 const char* name = freerdp_getApplicationDetailsString();
696 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
697 printf(
"To show full command line help type\n");
698 printf(
"%s /?\n", name);
702BOOL freerdp_client_print_command_line_help_ex(
int argc,
char** argv,
705 const char* name = freerdp_getApplicationDetailsString();
717 printf(
"%s - A Free Remote Desktop Protocol Implementation\n", name);
718 printf(
"See www.freerdp.com for more information\n");
720 printf(
"Usage: %s [file] [options] [/v:<server>[:port]]\n", argv[0]);
723 printf(
" /flag (enables flag)\n");
724 printf(
" /option:<value> (specifies option with value)\n");
725 printf(
" +toggle -toggle (enables or disables toggle, where '/' is a synonym of '+')\n");
728 freerdp_client_print_command_line_args(largs, lcount);
732 printf(
"Examples:\n");
733 printf(
" %s connection.rdp /p:Pwd123! /f\n", name);
734 printf(
" %s /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com\n", name);
735 printf(
" %s /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489\n", name);
736 printf(
" %s /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 "
737 "/v:192.168.1.100\n",
739 printf(
" %s /u:\\AzureAD\\user@corp.example /p:pwd /v:host\n", name);
740 printf(
"Use a generic pipe as transport:");
741 printf(
" %s /v:/path/to/pipe\n", name);
742 printf(
"Use a external socket:");
743 printf(
" %s /v:|:1234\n", name);
745 printf(
"Connect to a system with TLS security and open the greeter:");
746 printf(
"NOTE: Needs a server configured to not require NLA or it will fail!");
748 printf(
" %s /sec:tls /p /v:rdp.contoso.com\n", name);
750 printf(
"Disable clipboard redirection: -clipboard\n");
752 printf(
"Drive Redirection: /drive:home,/home/user\n");
753 printf(
"Smartcard Redirection: /smartcard:<device>\n");
754 printf(
"Smartcard logon with Kerberos authentication: /smartcard-logon /sec:nla\n");
756#if defined(CHANNEL_SERIAL_CLIENT)
757 printf(
"Serial Port Redirection: /serial:<name>,<device>,[SerCx2|SerCx|Serial],[permissive]\n");
758 printf(
"Serial Port Redirection: /serial:COM1,/dev/ttyS0\n");
760#if defined(CHANNEL_PARALLEL_CLIENT)
761 printf(
"Parallel Port Redirection: /parallel:<name>,<device>\n");
763 printf(
"Printer Redirection: /printer:<device>,<driver>,[default]\n");
764 printf(
"TCP redirection: /rdp2tcp:/usr/bin/rdp2tcp\n");
766 printf(
"Audio Output Redirection: /sound:sys:oss,dev:1,format:1\n");
767 printf(
"Audio Output Redirection: /sound:sys:alsa\n");
768 printf(
"Audio Input Redirection: /microphone:sys:oss,dev:1,format:1\n");
769 printf(
"Audio Input Redirection: /microphone:sys:alsa\n");
771#if defined(CHANNEL_RDPECAM_CLIENT)
772 printf(
"Camera Redirection: /dvc:rdpecam[,sys:<sys>]\n");
773 printf(
"Camera Redirection, playing a movie file as camera (requires FFmpeg):\n");
774 printf(
" /dvc:rdpecam,sys:movie,file:<path>[,name:<camera name>]\n");
775 printf(
"Camera Redirection, GStreamer pipeline as camera (requires GStreamer):\n");
776 printf(
" /dvc:rdpecam,sys:gst,pipeline:<pipeline>|pipeline-file:<path>|file:<path>"
777 "[,name:<camera name>][,loop:on|off]\n");
778 printf(
" /dvc:rdpecam,sys:gst,'\"pipeline:pipewiresrc ! video/x-raw,width=640\"'\n");
781 printf(
"Multimedia Redirection: /video\n");
782#ifdef CHANNEL_URBDRC_CLIENT
783 printf(
"USB Device Redirection: /usb:id:054c:0268#4669:6e6b,addr:04:0c\n");
786 printf(
"For Gateways, the https_proxy environment variable is respected:\n");
788 printf(
" set HTTPS_PROXY=http://proxy.contoso.com:3128/\n");
790 printf(
" export https_proxy=http://proxy.contoso.com:3128/\n");
792 printf(
" %s /gateway:g:rdp.contoso.com ...\n", name);
794 printf(
"More documentation is coming, in the meantime consult source files\n");
800static BOOL option_is_rdp_file(
const char* option)
802 WINPR_ASSERT(option);
804 if (option_ends_with(option,
".rdp"))
806 if (option_ends_with(option,
".rdpw"))
812static BOOL option_is_incident_file(
const char* option)
814 WINPR_ASSERT(option);
816 return (option_ends_with(option,
".msrcIncident"));
820static int freerdp_client_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
825 rdpSettings* settings =
nullptr;
830 length = strlen(argv[index]);
834 if (option_is_rdp_file(argv[index]))
836 settings = (rdpSettings*)context;
839 return COMMAND_LINE_ERROR_MEMORY;
847 if (option_is_incident_file(argv[index]))
849 settings = (rdpSettings*)context;
852 return COMMAND_LINE_ERROR_MEMORY;
862BOOL freerdp_client_add_device_channel(rdpSettings* settings,
size_t count,
863 const char*
const* params)
865 WINPR_ASSERT(settings);
868 WINPR_ASSERT(params);
869 WINPR_ASSERT(count > 0);
871 if (option_equals(params[0],
"drive"))
880 rc = freerdp_client_add_drive(settings, params[1],
nullptr);
882 rc = freerdp_client_add_drive(settings, params[2], params[1]);
886 else if (option_equals(params[0],
"printer"))
893 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, count - 1, ¶ms[1]);
897 if (!freerdp_device_collection_add(settings, printer))
899 freerdp_device_free(printer);
905 else if (option_equals(params[0],
"smartcard"))
912 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, count - 1, ¶ms[1]);
916 if (!freerdp_device_collection_add(settings, smartcard))
918 freerdp_device_free(smartcard);
924#if defined(CHANNEL_SERIAL_CLIENT)
925 else if (option_equals(params[0],
"serial"))
932 RDPDR_DEVICE* serial = freerdp_device_new(RDPDR_DTYP_SERIAL, count - 1, ¶ms[1]);
936 if (!freerdp_device_collection_add(settings, serial))
938 freerdp_device_free(serial);
945 else if (option_equals(params[0],
"parallel"))
952 RDPDR_DEVICE* parallel = freerdp_device_new(RDPDR_DTYP_PARALLEL, count - 1, ¶ms[1]);
957 if (!freerdp_device_collection_add(settings, parallel))
959 freerdp_device_free(parallel);
969BOOL freerdp_client_del_static_channel(rdpSettings* settings,
const char* name)
971 return freerdp_static_channel_collection_del(settings, name);
974BOOL freerdp_client_add_static_channel(rdpSettings* settings,
size_t count,
975 const char*
const* params)
980 if (!settings || !params || !params[0] || (count > INT_MAX))
983 if (freerdp_static_channel_collection_find(settings, params[0]))
986 ADDIN_ARGV* _args = freerdp_addin_argv_new(count, params);
990 if (!freerdp_static_channel_collection_add(settings, _args))
995 freerdp_addin_argv_free(_args);
999BOOL freerdp_client_del_dynamic_channel(rdpSettings* settings,
const char* name)
1001 return freerdp_dynamic_channel_collection_del(settings, name);
1004BOOL freerdp_client_add_dynamic_channel(rdpSettings* settings,
size_t count,
1005 const char*
const* params)
1009 if (!settings || !params || !params[0] || (count > INT_MAX))
1012 if (freerdp_dynamic_channel_collection_find(settings, params[0]))
1015 ADDIN_ARGV* _args = freerdp_addin_argv_new(count, params);
1019 if (!freerdp_dynamic_channel_collection_add(settings, _args))
1025 freerdp_addin_argv_free(_args);
1030static BOOL read_pem_file(rdpSettings* settings, FreeRDP_Settings_Keys_String
id,
1031 const char* b64OrFile)
1033 const size_t blen = strlen(b64OrFile);
1034 char* pem =
nullptr;
1036 crypto_base64url_decode(b64OrFile, blen, (BYTE**)&pem, &plen);
1039 pem = crypto_read_pem(b64OrFile, &plen);
1040 if (!pem || (plen == 0))
1053static BOOL parseSubOptions(rdpSettings* settings,
const CmdLineSubOptions* opts,
size_t count,
1058 for (
size_t xx = 0; xx < count; xx++)
1060 const CmdLineSubOptions* opt = &opts[xx];
1062 if (option_starts_with(opt->optname, arg))
1064 const size_t optlen = strlen(opt->optname);
1065 const char* val = &arg[optlen];
1068 switch (opt->opttype)
1070 case CMDLINE_SUBOPTION_STRING:
1073 case CMDLINE_SUBOPTION_FILE:
1074 status = read_pem_file(settings, opt->id, val);
1077 WLog_ERR(TAG,
"invalid subOption type");
1084 if (opt->cb && !opt->cb(val, settings))
1093 WLog_ERR(TAG,
"option %s not handled", arg);
1098#define fail_at(arg, rc) fail_at_((arg), (rc), __FILE__, __func__, __LINE__)
1106 const DWORD level = WLOG_ERROR;
1107 wLog* log = WLog_Get(TAG);
1108 if (WLog_IsLevelActive(log, level))
1110 const char* val = arg->Value;
1111 if ((arg->Flags & COMMAND_LINE_VALUE_FLAG) != 0)
1112 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1113 if ((arg->Flags & COMMAND_LINE_VALUE_BOOL) != 0)
1114 val = arg->Value ==
nullptr ?
"Disable" :
"Enable";
1116 WLog_PrintTextMessage(log, level, line, file, fkt,
1117 "Command line parsing failed at '%s' value '%s' [%d]", arg->Name, val,
1126 rdpSettings* settings = (rdpSettings*)context;
1127 int status = CHANNEL_RC_OK;
1128 BOOL enable = (arg->Value !=
nullptr);
1130 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"a")
1133 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1135 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1136 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1138 status = COMMAND_LINE_ERROR;
1140 CommandLineParserFree(ptr);
1142 return fail_at(arg, status);
1144 CommandLineSwitchCase(arg,
"kerberos")
1148 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"kerberos", arg->Value, &count);
1151 const CmdLineSubOptions opts[] = {
1152 {
"kdc-url:", FreeRDP_KerberosKdcUrl, CMDLINE_SUBOPTION_STRING,
nullptr },
1153 {
"start-time:", FreeRDP_KerberosStartTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1154 {
"lifetime:", FreeRDP_KerberosLifeTime, CMDLINE_SUBOPTION_STRING,
nullptr },
1155 {
"renewable-lifetime:", FreeRDP_KerberosRenewableLifeTime,
1156 CMDLINE_SUBOPTION_STRING,
nullptr },
1157 {
"cache:", FreeRDP_KerberosCache, CMDLINE_SUBOPTION_STRING,
nullptr },
1158 {
"armor:", FreeRDP_KerberosArmor, CMDLINE_SUBOPTION_STRING,
nullptr },
1159 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1160 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1163 for (
size_t x = 1; x < count; x++)
1165 const char* cur = ptr[x];
1166 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
1168 CommandLineParserFree(ptr);
1169 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1173 CommandLineParserFree(ptr);
1176 CommandLineSwitchCase(arg,
"vc")
1179 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1180 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1181 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1182 CommandLineParserFree(ptr);
1184 return fail_at(arg, status);
1186 CommandLineSwitchCase(arg,
"dvc")
1189 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
1190 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1191 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1192 CommandLineParserFree(ptr);
1194 return fail_at(arg, status);
1196 CommandLineSwitchCase(arg,
"drive")
1199 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1200 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1201 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1202 CommandLineParserFree(ptr);
1204 return fail_at(arg, status);
1206#if defined(CHANNEL_SERIAL_CLIENT)
1207 CommandLineSwitchCase(arg,
"serial")
1210 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1211 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1212 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1213 CommandLineParserFree(ptr);
1215 return fail_at(arg, status);
1218#if defined(CHANNEL_PARALLEL_CLIENT)
1219 CommandLineSwitchCase(arg,
"parallel")
1222 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1223 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1224 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1225 CommandLineParserFree(ptr);
1227 return fail_at(arg, status);
1230 CommandLineSwitchCase(arg,
"smartcard")
1233 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1234 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1235 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1236 CommandLineParserFree(ptr);
1238 return fail_at(arg, status);
1240 CommandLineSwitchCase(arg,
"printer")
1243 char** ptr = CommandLineParseCommaSeparatedValuesEx(arg->Name, arg->Value, &count);
1244 if (!freerdp_client_add_device_channel(settings, count, (
const char*
const*)ptr))
1245 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1246 CommandLineParserFree(ptr);
1248 return fail_at(arg, status);
1250 CommandLineSwitchCase(arg,
"usb")
1254 CommandLineParseCommaSeparatedValuesEx(URBDRC_CHANNEL_NAME, arg->Value, &count);
1255 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1256 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1257 CommandLineParserFree(ptr);
1259 return fail_at(arg, status);
1261 CommandLineSwitchCase(arg,
"multitouch")
1264 return fail_at(arg, COMMAND_LINE_ERROR);
1266 CommandLineSwitchCase(arg,
"gestures")
1269 return fail_at(arg, COMMAND_LINE_ERROR);
1271 CommandLineSwitchCase(arg,
"echo")
1274 return fail_at(arg, COMMAND_LINE_ERROR);
1276 CommandLineSwitchCase(arg,
"ssh-agent")
1279 return fail_at(arg, COMMAND_LINE_ERROR);
1281 CommandLineSwitchCase(arg,
"disp")
1284 return fail_at(arg, COMMAND_LINE_ERROR);
1286 CommandLineSwitchCase(arg,
"geometry")
1289 return fail_at(arg, COMMAND_LINE_ERROR);
1291 CommandLineSwitchCase(arg,
"video")
1295 return fail_at(arg, COMMAND_LINE_ERROR);
1297 return fail_at(arg, COMMAND_LINE_ERROR);
1299 CommandLineSwitchCase(arg,
"sound")
1303 CommandLineParseCommaSeparatedValuesEx(RDPSND_CHANNEL_NAME, arg->Value, &count);
1304 if (!freerdp_client_add_static_channel(settings, count, (
const char*
const*)ptr))
1305 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1306 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1307 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1309 CommandLineParserFree(ptr);
1311 return fail_at(arg, status);
1313 CommandLineSwitchCase(arg,
"microphone")
1316 char** ptr = CommandLineParseCommaSeparatedValuesEx(AUDIN_CHANNEL_NAME, arg->Value, &count);
1317 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1318 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1319 CommandLineParserFree(ptr);
1321 return fail_at(arg, status);
1323#if defined(CHANNEL_TSMF_CLIENT)
1324 CommandLineSwitchCase(arg,
"multimedia")
1327 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tsmf", arg->Value, &count);
1328 if (!freerdp_client_add_dynamic_channel(settings, count, (
const char*
const*)ptr))
1329 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1330 CommandLineParserFree(ptr);
1332 return fail_at(arg, status);
1335 CommandLineSwitchCase(arg,
"heartbeat")
1338 return fail_at(arg, COMMAND_LINE_ERROR);
1340 CommandLineSwitchCase(arg,
"multitransport")
1343 return fail_at(arg, COMMAND_LINE_ERROR);
1349 (TRANSPORT_TYPE_UDP_FECR | TRANSPORT_TYPE_UDP_FECL | TRANSPORT_TYPE_UDP_PREFERRED);
1351#if defined(WITH_RDPEUDP)
1355 BOOL preferred = FALSE;
1356 if ((arg->Value != BoolValueTrue) && (arg->Value != BoolValueFalse))
1358 if (option_equals(
"tcp-only", arg->Value))
1360 else if (option_equals(
"udp", arg->Value))
1362 else if (option_equals(
"udp-preferred", arg->Value))
1363 udp = preferred = TRUE;
1365 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
1367 else if (arg->Value == BoolValueTrue)
1375 flags = TRANSPORT_TYPE_UDP_FECR | SOFTSYNC_TCP_TO_UDP;
1377 flags |= TRANSPORT_TYPE_UDP_PREFERRED;
1381 return fail_at(arg, COMMAND_LINE_ERROR);
1383 return fail_at(arg, COMMAND_LINE_ERROR);
1385 CommandLineSwitchEnd(arg)
1393 int status = freerdp_client_command_line_post_filter_int(context, arg);
1394 return status == CHANNEL_RC_OK ? 1 : -1;
1398static BOOL freerdp_parse_username_ptr(
const char* username,
const char** user,
size_t* userlen,
1399 const char** domain,
size_t* domainlen)
1402 WINPR_ASSERT(userlen);
1403 WINPR_ASSERT(domain);
1404 WINPR_ASSERT(domainlen);
1409 const char* p = strchr(username,
'\\');
1419 const size_t length = (size_t)(p - username);
1421 *userlen = strlen(*user);
1424 *domainlen = length;
1433 *userlen = strlen(username);
1440static BOOL freerdp_parse_username_settings(
const char* username, rdpSettings* settings,
1441 FreeRDP_Settings_Keys_String userID,
1442 FreeRDP_Settings_Keys_String domainID)
1444 const char* user =
nullptr;
1445 const char* domain =
nullptr;
1447 size_t domainlen = 0;
1449 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1457BOOL freerdp_parse_username(
const char* username,
char** puser,
char** pdomain)
1459 const char* user =
nullptr;
1460 const char* domain =
nullptr;
1462 size_t domainlen = 0;
1467 const BOOL rc = freerdp_parse_username_ptr(username, &user, &userlen, &domain, &domainlen);
1473 *puser = strndup(user, userlen);
1480 *pdomain = strndup(domain, domainlen);
1492BOOL freerdp_parse_hostname(
const char* hostname,
char** host,
int* port)
1495 p = strrchr(hostname,
':');
1499 size_t length = (size_t)(p - hostname);
1502 if (!value_to_int(p + 1, &val, 1, UINT16_MAX))
1505 *host = (
char*)calloc(length + 1UL,
sizeof(
char));
1510 CopyMemory(*host, hostname, length);
1511 (*host)[length] =
'\0';
1512 *port = (UINT16)val;
1516 *host = _strdup(hostname);
1528static BOOL freerdp_apply_connection_type(rdpSettings* settings, UINT32 type)
1530 struct network_settings
1532 FreeRDP_Settings_Keys_Bool id;
1535 const struct network_settings config[] = {
1536 { FreeRDP_DisableWallpaper, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1537 { FreeRDP_AllowFontSmoothing, { FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE } },
1538 { FreeRDP_AllowDesktopComposition, { FALSE, FALSE, TRUE, TRUE, TRUE, TRUE, TRUE } },
1539 { FreeRDP_DisableFullWindowDrag, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1540 { FreeRDP_DisableMenuAnims, { TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE } },
1541 { FreeRDP_DisableThemes, { TRUE, FALSE, FALSE, FALSE, FALSE, FALSE, FALSE } }
1546 case CONNECTION_TYPE_INVALID:
1549 case CONNECTION_TYPE_MODEM:
1550 case CONNECTION_TYPE_BROADBAND_LOW:
1551 case CONNECTION_TYPE_BROADBAND_HIGH:
1552 case CONNECTION_TYPE_SATELLITE:
1553 case CONNECTION_TYPE_WAN:
1554 case CONNECTION_TYPE_LAN:
1555 case CONNECTION_TYPE_AUTODETECT:
1558 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1562 for (
size_t x = 0; x < ARRAYSIZE(config); x++)
1564 const struct network_settings* cur = &config[x];
1571BOOL freerdp_set_connection_type(rdpSettings* settings, UINT32 type)
1579 case CONNECTION_TYPE_INVALID:
1580 case CONNECTION_TYPE_MODEM:
1581 case CONNECTION_TYPE_BROADBAND_LOW:
1582 case CONNECTION_TYPE_SATELLITE:
1583 case CONNECTION_TYPE_BROADBAND_HIGH:
1584 case CONNECTION_TYPE_WAN:
1585 case CONNECTION_TYPE_LAN:
1586 if (!freerdp_apply_connection_type(settings, type))
1589 case CONNECTION_TYPE_AUTODETECT:
1590 if (!freerdp_apply_connection_type(settings, type))
1594 WLog_WARN(TAG,
"Unknown ConnectionType %" PRIu32
", aborting", type);
1602static UINT32 freerdp_get_keyboard_layout_for_type(
const char* name, WINPR_ATTR_UNUSED DWORD type)
1607 freerdp_keyboard_get_layouts(RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, &count);
1609 if (!layouts || (count == 0))
1612 for (
size_t x = 0; x < count; x++)
1615 if (option_equals(layout->name, name))
1623 freerdp_keyboard_layouts_free(layouts, count);
1628static UINT32 freerdp_map_keyboard_layout_name_to_id(
const char* name)
1630 const UINT32 variants[] = { RDP_KEYBOARD_LAYOUT_TYPE_STANDARD, RDP_KEYBOARD_LAYOUT_TYPE_VARIANT,
1631 RDP_KEYBOARD_LAYOUT_TYPE_IME };
1633 for (
size_t x = 0; x < ARRAYSIZE(variants); x++)
1635 UINT32 rc = freerdp_get_keyboard_layout_for_type(name, variants[x]);
1644static int freerdp_detect_command_line_pre_filter(
void* context,
int index,
int argc, LPSTR* argv)
1647 WINPR_UNUSED(context);
1654 length = strlen(argv[index]);
1658 if (option_is_rdp_file(argv[index]))
1666 if (option_is_incident_file(argv[index]))
1677static int freerdp_detect_windows_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1682 int detect_status = 0;
1685 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1687 flags = COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_SILENCE_PARSER;
1688 flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1692 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1697 CommandLineClearArgumentsA(largs);
1698 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1699 freerdp_detect_command_line_pre_filter,
nullptr);
1708 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1712 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1714 return detect_status;
1718static int freerdp_detect_posix_style_command_line_syntax(
int argc,
char** argv,
size_t* count,
1723 int detect_status = 0;
1726 memcpy(largs, global_cmd_args,
sizeof(global_cmd_args));
1728 flags = COMMAND_LINE_SEPARATOR_SPACE | COMMAND_LINE_SILENCE_PARSER;
1729 flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1730 flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1734 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
1739 CommandLineClearArgumentsA(largs);
1740 status = CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
1741 freerdp_detect_command_line_pre_filter,
nullptr);
1750 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
1754 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
1756 return detect_status;
1759static BOOL freerdp_client_detect_command_line(
int argc,
char** argv, DWORD* flags)
1761 size_t posix_cli_count = 0;
1762 size_t windows_cli_count = 0;
1763 const BOOL ignoreUnknown = TRUE;
1764 const int windows_cli_status = freerdp_detect_windows_style_command_line_syntax(
1765 argc, argv, &windows_cli_count, ignoreUnknown);
1766 const int posix_cli_status =
1767 freerdp_detect_posix_style_command_line_syntax(argc, argv, &posix_cli_count, ignoreUnknown);
1770 *flags = COMMAND_LINE_SEPARATOR_SPACE;
1771 *flags |= COMMAND_LINE_SIGIL_DASH | COMMAND_LINE_SIGIL_DOUBLE_DASH;
1772 *flags |= COMMAND_LINE_SIGIL_ENABLE_DISABLE;
1774 if (posix_cli_status <= COMMAND_LINE_STATUS_PRINT)
1778 if ((windows_cli_count && (windows_cli_count >= posix_cli_count)) ||
1779 (windows_cli_status <= COMMAND_LINE_STATUS_PRINT))
1781 windows_cli_count = 1;
1782 *flags = COMMAND_LINE_SEPARATOR_COLON;
1783 *flags |= COMMAND_LINE_SIGIL_SLASH | COMMAND_LINE_SIGIL_PLUS_MINUS;
1786 WLog_DBG(TAG,
"windows: %d/%" PRIuz
" posix: %d/%" PRIuz
"", windows_cli_status,
1787 windows_cli_count, posix_cli_status, posix_cli_count);
1788 if ((posix_cli_count == 0) && (windows_cli_count == 0))
1790 if ((posix_cli_status == COMMAND_LINE_ERROR) && (windows_cli_status == COMMAND_LINE_ERROR))
1796int freerdp_client_settings_command_line_status_print(rdpSettings* settings,
int status,
int argc,
1799 return freerdp_client_settings_command_line_status_print_ex(settings, status, argc, argv,
1803static void freerdp_client_print_keyboard_type_list(
const char* msg, DWORD type)
1807 layouts = freerdp_keyboard_get_layouts(type, &count);
1809 printf(
"\n%s\n", msg);
1811 for (
size_t x = 0; x < count; x++)
1814 printf(
"0x%08" PRIX32
"\t%s\n", layout->code, layout->name);
1817 freerdp_keyboard_layouts_free(layouts, count);
1820static void freerdp_client_print_keyboard_list(
void)
1822 freerdp_client_print_keyboard_type_list(
"Keyboard Layouts", RDP_KEYBOARD_LAYOUT_TYPE_STANDARD);
1823 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1824 RDP_KEYBOARD_LAYOUT_TYPE_VARIANT);
1825 freerdp_client_print_keyboard_type_list(
"Keyboard Layout Variants",
1826 RDP_KEYBOARD_LAYOUT_TYPE_IME);
1829static void freerdp_client_print_timezone_list(
void)
1833 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
1835 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
1837 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
1838 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
1839 printf(
"%" PRIu32
": '%s'\n", index, TimeZoneKeyName);
1843static void freerdp_client_print_tune_list(
const rdpSettings* settings)
1847 for (SSIZE_T x = 0; x < FreeRDP_Settings_StableAPI_MAX; x++)
1855 case RDP_SETTINGS_TYPE_BOOL:
1856 printf(
"%" PRIdz
"\t%50s\tBOOL\t%s\n", x, name,
1861 case RDP_SETTINGS_TYPE_UINT16:
1862 printf(
"%" PRIdz
"\t%50s\tUINT16\t%" PRIu16
"\n", x, name,
1865 case RDP_SETTINGS_TYPE_INT16:
1866 printf(
"%" PRIdz
"\t%50s\tINT16\t%" PRId16
"\n", x, name,
1869 case RDP_SETTINGS_TYPE_UINT32:
1870 printf(
"%" PRIdz
"\t%50s\tUINT32\t%" PRIu32
"\n", x, name,
1873 case RDP_SETTINGS_TYPE_INT32:
1874 printf(
"%" PRIdz
"\t%50s\tINT32\t%" PRId32
"\n", x, name,
1877 case RDP_SETTINGS_TYPE_UINT64:
1878 printf(
"%" PRIdz
"\t%50s\tUINT64\t%" PRIu64
"\n", x, name,
1881 case RDP_SETTINGS_TYPE_INT64:
1882 printf(
"%" PRIdz
"\t%50s\tINT64\t%" PRId64
"\n", x, name,
1885 case RDP_SETTINGS_TYPE_STRING:
1886 printf(
"%" PRIdz
"\t%50s\tSTRING\t%s"
1891 case RDP_SETTINGS_TYPE_POINTER:
1892 printf(
"%" PRIdz
"\t%50s\tPOINTER\t%p"
1905static int evaluate_result(
int argc,
char* argv[],
int rc, rdpSettings* settings,
1908 WINPR_ASSERT(settings);
1909 WINPR_ASSERT(largs);
1911 if (rc != COMMAND_LINE_STATUS_PRINT)
1913 freerdp_client_print_command_line_usage(argc, argv);
1920 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
1922 if (option_equals(
"timezones", arg->Value))
1923 freerdp_client_print_timezone_list();
1924 else if (option_equals(
"tune", arg->Value))
1925 freerdp_client_print_tune_list(settings);
1926 else if (option_equals(
"kbd", arg->Value))
1927 freerdp_client_print_keyboard_list();
1928 else if (option_starts_with(
"kbd-lang", arg->Value))
1930 const char* val =
nullptr;
1931 if (option_starts_with(
"kbd-lang:", arg->Value))
1932 val = &arg->Value[9];
1933 else if (!option_equals(
"kbd-lang", arg->Value))
1934 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1936 if (val && strchr(val,
','))
1937 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1938 freerdp_client_print_codepages(val);
1940 else if (option_equals(
"kbd-scancode", arg->Value))
1941 freerdp_client_print_scancodes();
1942 else if (option_equals(
"monitor", arg->Value))
1945 return COMMAND_LINE_ERROR;
1947 else if (option_starts_with(
"smartcard", arg->Value))
1950 if (option_starts_with(
"smartcard:", arg->Value))
1952 else if (!option_equals(
"smartcard", arg->Value))
1953 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1957 const char* sub = strchr(arg->Value,
':') + 1;
1958 const CmdLineSubOptions options[] = {
1959 {
"pkinit-anchors:", FreeRDP_PkinitAnchors, CMDLINE_SUBOPTION_STRING,
nullptr },
1960 {
"pkcs11-module:", FreeRDP_Pkcs11Module, CMDLINE_SUBOPTION_STRING,
nullptr }
1965 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard", sub, &count);
1967 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1970 CommandLineParserFree(ptr);
1971 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1974 for (
size_t x = 1; x < count; x++)
1976 const char* cur = ptr[x];
1977 if (!parseSubOptions(settings, options, ARRAYSIZE(options), cur))
1979 CommandLineParserFree(ptr);
1980 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
1984 CommandLineParserFree(ptr);
1987 freerdp_smartcard_list(settings);
1991 freerdp_client_print_command_line_usage(argc, argv);
1992 return COMMAND_LINE_ERROR;
1995#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
1996 arg = CommandLineFindArgumentA(largs,
"tune-list");
1999 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
2001 WLog_WARN(TAG,
"Option /tune-list is deprecated, use /list:tune instead");
2002 freerdp_client_print_tune_list(settings);
2005 arg = CommandLineFindArgumentA(largs,
"kbd-lang-list");
2008 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
2010 WLog_WARN(TAG,
"Option /kbd-lang-list is deprecated, use /list:kbd-lang instead");
2011 freerdp_client_print_codepages(arg->Value);
2014 arg = CommandLineFindArgumentA(largs,
"kbd-list");
2017 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2019 WLog_WARN(TAG,
"Option /kbd-list is deprecated, use /list:kbd instead");
2020 freerdp_client_print_keyboard_list();
2023 arg = CommandLineFindArgumentA(largs,
"monitor-list");
2026 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2028 WLog_WARN(TAG,
"Option /monitor-list is deprecated, use /list:monitor instead");
2030 return COMMAND_LINE_ERROR;
2033 arg = CommandLineFindArgumentA(largs,
"smartcard-list");
2036 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2038 WLog_WARN(TAG,
"Option /smartcard-list is deprecated, use /list:smartcard instead");
2039 freerdp_smartcard_list(settings);
2042 arg = CommandLineFindArgumentA(largs,
"kbd-scancode-list");
2045 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2047 WLog_WARN(TAG,
"Option /kbd-scancode-list is deprecated, use /list:kbd-scancode instead");
2048 freerdp_client_print_scancodes();
2049 return COMMAND_LINE_STATUS_PRINT;
2052 return COMMAND_LINE_STATUS_PRINT;
2055int freerdp_client_settings_command_line_status_print_ex(rdpSettings* settings,
int status,
2056 int argc,
char** argv,
2059 if (status == COMMAND_LINE_STATUS_PRINT_VERSION)
2061 freerdp_client_print_version();
2065 if (status == COMMAND_LINE_STATUS_PRINT_BUILDCONFIG)
2067 freerdp_client_print_version_ex(argc, argv);
2068 freerdp_client_print_buildconfig_ex(argc, argv);
2071 else if (status == COMMAND_LINE_STATUS_PRINT)
2074 freerdp_client_detect_command_line(argc, argv, &flags);
2076 size_t customcount = 0;
2079 while (cur && cur->Name)
2085 size_t globalcount = 0;
2088 while (cur && cur->Name)
2104 CommandLineParseArgumentsA(argc, argv, largs, flags,
nullptr,
nullptr,
nullptr);
2105 status = evaluate_result(argc, argv, rc, settings, largs);
2109 else if (status == COMMAND_LINE_STATUS_PRINT_HELP)
2111 freerdp_client_print_command_line_help_ex(argc, argv, custom);
2114 else if (status < 0)
2116 freerdp_client_print_command_line_usage(argc, argv);
2121 if (status <= COMMAND_LINE_STATUS_PRINT && status >= COMMAND_LINE_STATUS_PRINT_LAST)
2135static BOOL parseSizeValue(
const char* input,
unsigned long* v1,
unsigned long* v2)
2137 const char* xcharpos =
nullptr;
2138 char* endPtr =
nullptr;
2139 unsigned long v = 0;
2141 v = strtoul(input, &endPtr, 10);
2143 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2149 xcharpos = strchr(input,
'x');
2151 if (!xcharpos || xcharpos != endPtr)
2155 v = strtoul(xcharpos + 1, &endPtr, 10);
2157 if ((v == 0 || v == ULONG_MAX) && (errno != 0))
2160 if (*endPtr !=
'\0')
2172 const char* arguments[] = {
"network",
"gfx",
"rfx",
"bpp" };
2173 WINPR_ASSERT(settings);
2189 for (
size_t x = 0; x < ARRAYSIZE(arguments); x++)
2191 const char* arg = arguments[x];
2193 if (!p || ((p->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0))
2196 const BOOL enable = p->Value !=
nullptr;
2202 const int rc = parse_network_options(settings, p);
2204 return fail_at(p, rc);
2210 int rc = parse_gfx_options(settings, p);
2212 return fail_at(p, rc);
2219 return fail_at(p, COMMAND_LINE_ERROR);
2225 const int rc = parse_bpp_options(settings, p);
2227 return fail_at(p, rc);
2238 if (!freerdp_set_connection_type(settings, CONNECTION_TYPE_AUTODETECT))
2259static BOOL setSmartcardEmulation(WINPR_ATTR_UNUSED
const char* value, rdpSettings* settings)
2265const char* option_starts_with(
const char* what,
const char* val)
2269 const size_t wlen = strlen(what);
2271 if (_strnicmp(what, val, wlen) != 0)
2276BOOL option_ends_with(
const char* str,
const char* ext)
2280 const size_t strLen = strlen(str);
2281 const size_t extLen = strlen(ext);
2283 if (strLen < extLen)
2286 return _strnicmp(&str[strLen - extLen], ext, extLen) == 0;
2289BOOL option_equals(
const char* what,
const char* val)
2293 return _stricmp(what, val) == 0;
2297static PARSE_ON_OFF_RESULT parse_on_off_option(
const char* value)
2299 WINPR_ASSERT(value);
2300 const char* sep = strchr(value,
':');
2303 if (option_equals(
"on", &sep[1]))
2305 if (option_equals(
"off", &sep[1]))
2315 if (arg->Value == BoolValueTrue)
2317 if (arg->Value == BoolValueFalse)
2319 if (option_equals(
"on", arg->Value))
2321 if (option_equals(
"off", arg->Value))
2327static PARSE_CLIP_DIR_RESULT parse_clip_direciton_to_option(
const char* value)
2329 WINPR_ASSERT(value);
2330 const char* sep = strchr(value,
':');
2332 return CLIP_DIR_PARSE_FAIL;
2333 if (option_equals(
"all", &sep[1]))
2334 return CLIP_DIR_PARSE_ALL;
2335 if (option_equals(
"off", &sep[1]))
2336 return CLIP_DIR_PARSE_OFF;
2337 if (option_equals(
"local", &sep[1]))
2338 return CLIP_DIR_PARSE_LOCAL;
2339 if (option_equals(
"remote", &sep[1]))
2340 return CLIP_DIR_PARSE_REMOTE;
2341 return CLIP_DIR_PARSE_FAIL;
2345static int parse_tls_ciphers(rdpSettings* settings,
const char* Value)
2347 const char* ciphers =
nullptr;
2349 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2351 if (option_equals(Value,
"netmon"))
2353 ciphers =
"ALL:!ECDH:!ADH:!DHE";
2355 else if (option_equals(Value,
"ma"))
2357 ciphers =
"AES128-SHA";
2365 return COMMAND_LINE_ERROR_MEMORY;
2370static int parse_tls_seclevel(rdpSettings* settings,
const char* Value)
2374 if (!value_to_int(Value, &val, 0, 5))
2375 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2378 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2383static int parse_tls_secrets_file(rdpSettings* settings,
const char* Value)
2386 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2389 return COMMAND_LINE_ERROR_MEMORY;
2394static int parse_tls_enforce(rdpSettings* settings,
const char* Value)
2396 UINT16 version = TLS1_2_VERSION;
2405 const struct map_t map[] = { {
"1.0", TLS1_VERSION },
2406 {
"1.1", TLS1_1_VERSION },
2407 {
"1.2", TLS1_2_VERSION }
2408#if defined(TLS1_3_VERSION)
2410 {
"1.3", TLS1_3_VERSION }
2414 const struct map_t* found =
nullptr;
2415 for (
size_t x = 0; x < ARRAYSIZE(map); x++)
2417 const struct map_t* cur = &map[x];
2418 if (option_equals(cur->name, Value))
2426 version = found->version;
2430 const long v = strtol(Value,
nullptr, 0);
2432 if ((v < -1) || ((v == LONG_MAX) && (errno != 0)) || (v > UINT16_MAX))
2433 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2435 version = WINPR_ASSERTING_INT_CAST(UINT16, v);
2441 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2448 int rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2449 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"tls")
2451 if (option_starts_with(
"ciphers:", arg->Value))
2452 rc = fail_at(arg, parse_tls_ciphers(settings, &arg->Value[8]));
2453 else if (option_starts_with(
"seclevel:", arg->Value))
2454 rc = fail_at(arg, parse_tls_seclevel(settings, &arg->Value[9]));
2455 else if (option_starts_with(
"secrets-file:", arg->Value))
2456 rc = fail_at(arg, parse_tls_secrets_file(settings, &arg->Value[13]));
2457 else if (option_starts_with(
"enforce:", arg->Value))
2458 rc = fail_at(arg, parse_tls_enforce(settings, &arg->Value[8]));
2461#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2462 CommandLineSwitchCase(arg,
"tls-ciphers")
2464 WLog_WARN(TAG,
"Option /tls-ciphers is deprecated, use /tls:ciphers instead");
2465 rc = fail_at(arg, parse_tls_ciphers(settings, arg->Value));
2467 CommandLineSwitchCase(arg,
"tls-seclevel")
2469 WLog_WARN(TAG,
"Option /tls-seclevel is deprecated, use /tls:seclevel instead");
2470 rc = fail_at(arg, parse_tls_seclevel(settings, arg->Value));
2472 CommandLineSwitchCase(arg,
"tls-secrets-file")
2474 WLog_WARN(TAG,
"Option /tls-secrets-file is deprecated, use /tls:secrets-file instead");
2475 rc = fail_at(arg, parse_tls_secrets_file(settings, arg->Value));
2477 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
2479 WLog_WARN(TAG,
"Option /enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
2480 rc = fail_at(arg, parse_tls_enforce(settings,
"1.2"));
2483 CommandLineSwitchDefault(arg)
2486 CommandLineSwitchEnd(arg)
2494 WINPR_ASSERT(settings);
2498 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2499 for (
size_t x = 0; x < count; x++)
2502 larg.Value = ptr[x];
2504 int rc = parse_tls_cipher_options(settings, &larg);
2507 CommandLineParserFree(ptr);
2511 CommandLineParserFree(ptr);
2517 WINPR_ASSERT(settings);
2521 return COMMAND_LINE_ERROR;
2525 int rc = CHANNEL_RC_OK;
2527 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
2528 if (!ptr || (count == 0))
2529 rc = COMMAND_LINE_ERROR;
2532 BOOL GfxH264 = FALSE;
2533 BOOL GfxAVC444 = FALSE;
2534 BOOL RemoteFxCodec = FALSE;
2535 BOOL GfxProgressive = FALSE;
2536 BOOL codecSelected = FALSE;
2538 for (
size_t x = 0; x < count; x++)
2540 const char* val = ptr[x];
2542 if (option_starts_with(
"AVC444", val))
2544 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2545 if (bval == PARSE_FAIL)
2546 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2548 GfxAVC444 = bval != PARSE_OFF;
2549 codecSelected = TRUE;
2551 else if (option_starts_with(
"AVC420", val))
2553 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2554 if (bval == PARSE_FAIL)
2555 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2557 GfxH264 = bval != PARSE_OFF;
2558 codecSelected = TRUE;
2562 if (option_starts_with(
"RFX", val))
2564 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2565 if (bval == PARSE_FAIL)
2566 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2568 RemoteFxCodec = bval != PARSE_OFF;
2569 codecSelected = TRUE;
2571 else if (option_starts_with(
"progressive", val))
2573 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2574 if (bval == PARSE_FAIL)
2575 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2577 GfxProgressive = bval != PARSE_OFF;
2578 codecSelected = TRUE;
2580 else if (option_starts_with(
"mask:", val))
2583 const char* uv = &val[5];
2584 if (!value_to_uint(uv, &v, 0, UINT32_MAX))
2585 rc = COMMAND_LINE_ERROR;
2590 rc = COMMAND_LINE_ERROR;
2593 else if (option_starts_with(
"small-cache", val))
2595 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2596 if (bval == PARSE_FAIL)
2597 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2600 rc = COMMAND_LINE_ERROR;
2602 else if (option_starts_with(
"thin-client", val))
2604 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2605 if (bval == PARSE_FAIL)
2606 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2609 rc = COMMAND_LINE_ERROR;
2610 if ((rc == CHANNEL_RC_OK) && (bval > 0))
2614 rc = COMMAND_LINE_ERROR;
2617 else if (option_starts_with(
"frame-ack", val))
2619 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2620 if (bval == PARSE_FAIL)
2621 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2624 rc = COMMAND_LINE_ERROR;
2626#if defined(WITH_GFX_AV1)
2627 else if (option_starts_with(
"AV1", val))
2629 uint32_t profile = 1;
2630 BOOL enabled = FALSE;
2631 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
2632 if (bval == PARSE_FAIL)
2634 if (_stricmp(
"av1:i420", val) == 0)
2639 else if (_stricmp(
"av1:i444", val) == 0)
2645 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2648 enabled = bval != PARSE_OFF;
2650 if (enabled || (bval != PARSE_FAIL))
2653 rc = COMMAND_LINE_ERROR;
2656 rc = COMMAND_LINE_ERROR;
2661 rc = COMMAND_LINE_ERROR;
2664 if ((rc == CHANNEL_RC_OK) && codecSelected)
2667 rc = COMMAND_LINE_ERROR;
2669 rc = COMMAND_LINE_ERROR;
2671 rc = COMMAND_LINE_ERROR;
2673 rc = COMMAND_LINE_ERROR;
2675 rc = COMMAND_LINE_ERROR;
2678 CommandLineParserFree(ptr);
2679 if (rc != CHANNEL_RC_OK)
2682 return CHANNEL_RC_OK;
2686static int parse_kbd_layout(rdpSettings* settings,
const char* value)
2688 WINPR_ASSERT(settings);
2689 WINPR_ASSERT(value);
2693 const BOOL isInt = value_to_int(value, &ival, 1, UINT32_MAX);
2696 ival = freerdp_map_keyboard_layout_name_to_id(value);
2700 WLog_ERR(TAG,
"Could not identify keyboard layout: %s", value);
2701 WLog_ERR(TAG,
"Use /list:kbd to list available layouts");
2702 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2709 rc = COMMAND_LINE_ERROR;
2714#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
2717 WINPR_ASSERT(settings);
2721 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2723 return COMMAND_LINE_ERROR;
2725 if (option_equals(arg->Value,
"rfx"))
2728 return COMMAND_LINE_ERROR;
2730 else if (option_equals(arg->Value,
"nsc"))
2733 return COMMAND_LINE_ERROR;
2736#if defined(WITH_JPEG)
2737 else if (option_equals(arg->Value,
"jpeg"))
2740 return COMMAND_LINE_ERROR;
2745 return COMMAND_LINE_ERROR;
2755static BOOL check_kbd_remap_valid(
const char* token)
2760 WINPR_ASSERT(token);
2762 if (strlen(token) > 10)
2765 if (!freerdp_extract_key_value(token, &key, &value))
2767 WLog_WARN(TAG,
"/kbd:remap invalid entry '%s'", token);
2776 WINPR_ASSERT(settings);
2780 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2782 return COMMAND_LINE_ERROR_MEMORY;
2783 char* p = strchr(arg->Value,
'[');
2788 const char scheme[] =
"://";
2789 const char* val = strstr(arg->Value, scheme);
2791 val += strnlen(scheme,
sizeof(scheme));
2794 p = strchr(val,
':');
2801 if (!value_to_int(&p[1], &lval, 1, UINT16_MAX))
2802 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2804 length = (size_t)(p - arg->Value);
2806 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2809 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2814 return COMMAND_LINE_ERROR_MEMORY;
2820 char* p2 = strchr(arg->Value,
']');
2824 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2826 length = (size_t)(p2 - p);
2828 return COMMAND_LINE_ERROR_MEMORY;
2830 if (*(p2 + 1) ==
':')
2834 if (!value_to_int(&p2[2], &val, 0, UINT16_MAX))
2835 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2838 return COMMAND_LINE_ERROR;
2841 printf(
"hostname %s port %" PRIu32
"\n",
2851 WINPR_ASSERT(settings);
2855 char* cur = arg->Value;
2857 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2863 char* next = strchr(cur,
',');
2871 if (option_equals(
"fqdn", cur))
2873 else if (option_equals(
"ip", cur))
2875 else if (option_equals(
"netbios", cur))
2878 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2881 mask = (mask & 0x07);
2882 value |= mask << (count * 3);
2884 }
while (cur !=
nullptr);
2887 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2890 return COMMAND_LINE_ERROR;
2896static int parse_prevent_session_lock_options(rdpSettings* settings,
2899 WINPR_ASSERT(settings);
2903 return COMMAND_LINE_ERROR_MEMORY;
2905 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2909 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
2910 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2913 return COMMAND_LINE_ERROR_MEMORY;
2922 WINPR_ASSERT(settings);
2926 return COMMAND_LINE_ERROR;
2933 return COMMAND_LINE_ERROR;
2935 return COMMAND_LINE_ERROR;
2937 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
2940 return COMMAND_LINE_ERROR;
2943 return COMMAND_LINE_ERROR_MEMORY;
2952 WINPR_ASSERT(settings);
2956 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2957 char* p = strchr(arg->Value,
'x');
2961 unsigned long w = 0;
2962 unsigned long h = 0;
2964 if (!parseSizeValue(arg->Value, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
2965 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
2968 return COMMAND_LINE_ERROR;
2970 return COMMAND_LINE_ERROR;
2974 char* str = _strdup(arg->Value);
2976 return COMMAND_LINE_ERROR_MEMORY;
2978 p = strchr(str,
'%');
2982 BOOL partial = FALSE;
2984 status = COMMAND_LINE_ERROR;
3011 if (!value_to_int(str, &val, 0, 100))
3013 status = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3034 WINPR_ASSERT(settings);
3037 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3040 UINT32* MonitorIds =
nullptr;
3041 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3044 return COMMAND_LINE_ERROR_MEMORY;
3051 CommandLineParserFree(ptr);
3052 return COMMAND_LINE_ERROR;
3055 MonitorIds = freerdp_settings_get_pointer_array_writable(settings, FreeRDP_MonitorIds, 0);
3056 for (UINT32 i = 0; i < count; i++)
3060 if (!value_to_int(ptr[i], &val, 0, UINT16_MAX))
3061 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3063 MonitorIds[i] = (UINT32)val;
3066 CommandLineParserFree(ptr);
3073static int parse_dynamic_resolution_options(rdpSettings* settings,
3076 WINPR_ASSERT(settings);
3079 const BOOL val = arg->Value !=
nullptr;
3083 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
3084 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3088 return COMMAND_LINE_ERROR;
3090 return COMMAND_LINE_ERROR;
3098 WINPR_ASSERT(settings);
3102 const char* size =
nullptr;
3104 switch (parse_on_off_argument(arg))
3116 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3121 WLog_ERR(TAG,
"Smart sizing and dynamic resolution are mutually exclusive options");
3122 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3126 return COMMAND_LINE_ERROR;
3130 unsigned long w = 0;
3131 unsigned long h = 0;
3133 if (!parseSizeValue(size, &w, &h) || (w > UINT16_MAX) || (h > UINT16_MAX))
3134 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3137 return COMMAND_LINE_ERROR;
3139 return COMMAND_LINE_ERROR;
3146 WINPR_ASSERT(settings);
3151 if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3152 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3162 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3166 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3174 WINPR_ASSERT(settings);
3177 int rc = CHANNEL_RC_OK;
3179 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3180 if (!ptr || (count == 0))
3181 rc = COMMAND_LINE_ERROR;
3184 for (
size_t x = 0; x < count; x++)
3186 const char* val = ptr[x];
3188 if (option_starts_with(
"remap:", val))
3191 char* now = _strdup(&val[6]);
3196 if (!check_kbd_remap_valid(now))
3197 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3200 const size_t olen = strlen(old);
3201 const size_t alen = strlen(now);
3202 const size_t tlen = olen + alen + 2;
3203 char* tmp = calloc(tlen,
sizeof(
char));
3205 rc = COMMAND_LINE_ERROR_MEMORY;
3207 (
void)_snprintf(tmp, tlen,
"%s,%s", old, now);
3215 rc = COMMAND_LINE_ERROR;
3219 else if (option_starts_with(
"layout:", val))
3221 rc = parse_kbd_layout(settings, &val[7]);
3223 else if (option_starts_with(
"lang:", val))
3226 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3228 ival = freerdp_get_locale_id_from_string(&val[5]);
3231 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3234 rc = COMMAND_LINE_ERROR;
3236 else if (option_starts_with(
"type:", val))
3239 const BOOL isInt = value_to_int(&val[5], &ival, 1, UINT32_MAX);
3241 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3243 rc = COMMAND_LINE_ERROR;
3245 else if (option_starts_with(
"subtype:", val))
3248 const BOOL isInt = value_to_int(&val[8], &ival, 1, UINT32_MAX);
3250 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3253 rc = COMMAND_LINE_ERROR;
3255 else if (option_starts_with(
"fn-key:", val))
3258 const BOOL isInt = value_to_int(&val[7], &ival, 1, UINT32_MAX);
3260 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3263 rc = COMMAND_LINE_ERROR;
3265 else if (option_starts_with(
"unicode", val))
3267 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
3268 if (bval == PARSE_FAIL)
3269 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3272 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3274 else if (option_starts_with(
"pipe:", val))
3277 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3279 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3281#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
3282 else if (count == 1)
3285 rc = parse_kbd_layout(settings, val);
3289 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3295 CommandLineParserFree(ptr);
3302 WINPR_ASSERT(settings);
3307 return COMMAND_LINE_ERROR_MEMORY;
3309 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3311 const char* cur = arg->Value;
3314 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3316 if (!proxy_parse_uri(settings, cur))
3317 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3321 WLog_ERR(TAG,
"Option http-proxy needs argument.");
3322 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3330 WINPR_ASSERT(settings);
3333 BOOL failed = FALSE;
3335 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3340 BOOL modernsyntax = FALSE;
3341 BOOL oldsyntax = FALSE;
3342 for (
size_t x = 0; (x < count) && !failed; x++)
3344 const char* carg = ptr[x];
3345 if (option_starts_with(
"file:", carg))
3347 const char* val = &carg[5];
3352 modernsyntax = TRUE;
3354 else if (option_equals(
"replay", carg))
3361 else if (option_equals(
"record", carg))
3368 else if (option_equals(
"nodelay", carg))
3375 modernsyntax = TRUE;
3390 if (oldsyntax && (count != 2))
3393 CommandLineParserFree(ptr);
3395 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3402 WINPR_ASSERT(settings);
3405 if (arg->Value == BoolValueTrue || arg->Value == BoolValueFalse)
3408 (arg->Value == BoolValueTrue)))
3409 return COMMAND_LINE_ERROR;
3415 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3416 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3418 const char* usesel =
"use-selection:";
3420 const char* cur = ptr[x];
3421 if (option_starts_with(usesel, cur))
3423 const char* val = &cur[strlen(usesel)];
3425 rc = COMMAND_LINE_ERROR_MEMORY;
3427 return COMMAND_LINE_ERROR;
3429 else if (option_starts_with(
"direction-to", cur))
3433 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL);
3434 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3438 case CLIP_DIR_PARSE_ALL:
3439 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE | CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3441 case CLIP_DIR_PARSE_LOCAL:
3442 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL;
3444 case CLIP_DIR_PARSE_REMOTE:
3445 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE;
3447 case CLIP_DIR_PARSE_OFF:
3449 case CLIP_DIR_PARSE_FAIL:
3451 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3457 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3459 else if (option_starts_with(
"files-to", cur))
3463 (uint32_t)~(CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES |
3464 CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES);
3465 const PARSE_CLIP_DIR_RESULT bval = parse_clip_direciton_to_option(cur);
3469 case CLIP_DIR_PARSE_ALL:
3471 CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES | CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3473 case CLIP_DIR_PARSE_LOCAL:
3474 bflags |= CLIPRDR_FLAG_REMOTE_TO_LOCAL_FILES;
3476 case CLIP_DIR_PARSE_REMOTE:
3477 bflags |= CLIPRDR_FLAG_LOCAL_TO_REMOTE_FILES;
3479 case CLIP_DIR_PARSE_OFF:
3481 case CLIP_DIR_PARSE_FAIL:
3483 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3489 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3492 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3494 CommandLineParserFree(ptr);
3505 WINPR_ASSERT(settings);
3510 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3512 if (strcmp(arg->Value,
"none") == 0)
3513 val = AUDIO_MODE_NONE;
3514 else if (strcmp(arg->Value,
"redirect") == 0)
3515 val = AUDIO_MODE_REDIRECT;
3516 else if (strcmp(arg->Value,
"server") == 0)
3517 val = AUDIO_MODE_PLAY_ON_SERVER;
3518 else if (!value_to_int(arg->Value, &val, 0, UINT32_MAX))
3519 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3523 case AUDIO_MODE_REDIRECT:
3525 return COMMAND_LINE_ERROR;
3528 case AUDIO_MODE_PLAY_ON_SERVER:
3530 return COMMAND_LINE_ERROR;
3533 case AUDIO_MODE_NONE:
3535 return COMMAND_LINE_ERROR;
3537 return COMMAND_LINE_ERROR;
3541 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3548 WINPR_ASSERT(settings);
3551 UINT32 type = CONNECTION_TYPE_INVALID;
3553 if (option_equals(arg->Value,
"invalid"))
3554 type = CONNECTION_TYPE_INVALID;
3555 else if (option_equals(arg->Value,
"modem"))
3556 type = CONNECTION_TYPE_MODEM;
3557 else if (option_equals(arg->Value,
"broadband"))
3558 type = CONNECTION_TYPE_BROADBAND_HIGH;
3559 else if (option_equals(arg->Value,
"broadband-low"))
3560 type = CONNECTION_TYPE_BROADBAND_LOW;
3561 else if (option_equals(arg->Value,
"broadband-high"))
3562 type = CONNECTION_TYPE_BROADBAND_HIGH;
3563 else if (option_equals(arg->Value,
"wan"))
3564 type = CONNECTION_TYPE_WAN;
3565 else if (option_equals(arg->Value,
"lan"))
3566 type = CONNECTION_TYPE_LAN;
3567 else if ((option_equals(arg->Value,
"autodetect")) || (option_equals(arg->Value,
"auto")) ||
3568 (option_equals(arg->Value,
"detect")))
3570 type = CONNECTION_TYPE_AUTODETECT;
3576 if (!value_to_int(arg->Value, &val, 0, 7))
3577 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3582 if (!freerdp_set_connection_type(settings, type))
3583 return COMMAND_LINE_ERROR;
3590 WINPR_ASSERT(settings);
3594 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3596 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3598 FreeRDP_Settings_Keys_Bool singleOptionWithoutOnOff = FreeRDP_BOOL_UNUSED;
3599 for (
size_t x = 0; x < count; x++)
3601 const char* cur = ptr[x];
3602 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3603 if (bval == PARSE_FAIL)
3605 CommandLineParserFree(ptr);
3606 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3609 const BOOL val = bval != PARSE_OFF;
3610 FreeRDP_Settings_Keys_Bool
id = FreeRDP_BOOL_UNUSED;
3611 if (option_starts_with(
"rdp", cur))
3613 id = FreeRDP_RdpSecurity;
3615 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3617 else if (option_starts_with(
"tls", cur))
3618 id = FreeRDP_TlsSecurity;
3619 else if (option_starts_with(
"nla", cur))
3620 id = FreeRDP_NlaSecurity;
3621 else if (option_starts_with(
"ext", cur))
3622 id = FreeRDP_ExtSecurity;
3623 else if (option_equals(
"aad", cur))
3624 id = FreeRDP_AadSecurity;
3627 WLog_ERR(TAG,
"unknown protocol security: %s", arg->Value);
3628 CommandLineParserFree(ptr);
3629 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3632 if ((bval == PARSE_NONE) && (count == 1))
3633 singleOptionWithoutOnOff = id;
3635 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3638 if (singleOptionWithoutOnOff != FreeRDP_BOOL_UNUSED)
3640 const FreeRDP_Settings_Keys_Bool options[] = {
3641 FreeRDP_AadSecurity, FreeRDP_UseRdpSecurityLayer, FreeRDP_RdpSecurity,
3642 FreeRDP_NlaSecurity, FreeRDP_ExtSecurity, FreeRDP_TlsSecurity
3645 for (
size_t i = 0; i < ARRAYSIZE(options); i++)
3648 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3652 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3653 if (singleOptionWithoutOnOff == FreeRDP_RdpSecurity)
3656 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3659 CommandLineParserFree(ptr);
3664static int parse_encryption_methods_options(rdpSettings* settings,
3667 WINPR_ASSERT(settings);
3670 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
3673 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3675 UINT32 EncryptionMethods = 0;
3676 for (UINT32 i = 0; i < count; i++)
3678 if (option_equals(ptr[i],
"40"))
3679 EncryptionMethods |= ENCRYPTION_METHOD_40BIT;
3680 else if (option_equals(ptr[i],
"56"))
3681 EncryptionMethods |= ENCRYPTION_METHOD_56BIT;
3682 else if (option_equals(ptr[i],
"128"))
3683 EncryptionMethods |= ENCRYPTION_METHOD_128BIT;
3684 else if (option_equals(ptr[i],
"FIPS"))
3685 EncryptionMethods |= ENCRYPTION_METHOD_FIPS;
3687 WLog_ERR(TAG,
"unknown encryption method '%s'", ptr[i]);
3691 return COMMAND_LINE_ERROR;
3692 CommandLineParserFree(ptr);
3700 WINPR_ASSERT(settings);
3705 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
3706 for (
size_t x = 0; (x < count) && (rc == 0); x++)
3708 const char deny[] =
"deny";
3709 const char ignore[] =
"ignore";
3710 const char tofu[] =
"tofu";
3711 const char name[] =
"name:";
3712 const char fingerprints[] =
"fingerprint:";
3714 const char* cur = ptr[x];
3715 if (option_equals(deny, cur))
3718 return COMMAND_LINE_ERROR;
3720 else if (option_equals(ignore, cur))
3723 return COMMAND_LINE_ERROR;
3725 else if (option_equals(tofu, cur))
3728 return COMMAND_LINE_ERROR;
3730 else if (option_starts_with(name, cur))
3732 const char* val = &cur[strnlen(name,
sizeof(name))];
3734 rc = COMMAND_LINE_ERROR_MEMORY;
3736 else if (option_starts_with(fingerprints, cur))
3738 const char* val = &cur[strnlen(fingerprints,
sizeof(fingerprints))];
3741 rc = COMMAND_LINE_ERROR_MEMORY;
3744 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3746 CommandLineParserFree(ptr);
3754 WINPR_ASSERT(settings);
3758 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"mouse", arg->Value, &count);
3762 for (
size_t x = 1; x < count; x++)
3764 const char* cur = ptr[x];
3766 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3767 if (bval == PARSE_FAIL)
3768 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3771 const BOOL val = bval != PARSE_OFF;
3773 if (option_starts_with(
"relative", cur))
3776 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3778 else if (option_starts_with(
"grab", cur))
3781 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3789 CommandLineParserFree(ptr);
3797 WINPR_ASSERT(settings);
3801 UINT32 Floatbar = 0x0017;
3805 char* start = arg->Value;
3810 start = strchr(start,
',');
3819 if (option_starts_with(
"sticky:", cur))
3823 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(cur);
3835 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3839 else if (option_starts_with(
"default:", cur))
3841 const char* val = cur + 8;
3844 if (option_equals(
"visible", val))
3846 else if (option_equals(
"hidden", val))
3849 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3852 else if (option_starts_with(
"show:", cur))
3854 const char* val = cur + 5;
3857 if (option_equals(
"always", val))
3859 else if (option_equals(
"fullscreen", val))
3861 else if (option_equals(
"window", val))
3864 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3867 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3871 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3878 WINPR_ASSERT(settings);
3881 BYTE* base64 =
nullptr;
3884 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3886 crypto_base64_decode((
const char*)(arg->Value), strlen(arg->Value), &base64, &length);
3892 return COMMAND_LINE_ERROR;
3896 WLog_ERR(TAG,
"reconnect-cookie: invalid base64 '%s'", arg->Value);
3904static BOOL set_monitor_override(rdpSettings* settings, uint64_t flag)
3906 const FreeRDP_Settings_Keys_UInt64 key = FreeRDP_MonitorOverrideFlags;
3915 WINPR_ASSERT(settings);
3920 if (!value_to_int(arg->Value, &val, 100, 180))
3921 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3929 return COMMAND_LINE_ERROR;
3931 return COMMAND_LINE_ERROR;
3932 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE |
3933 FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3934 return fail_at(arg, COMMAND_LINE_ERROR);
3938 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3946 WINPR_ASSERT(settings);
3951 if (!value_to_int(arg->Value, &val, 100, 180))
3952 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3960 return COMMAND_LINE_ERROR;
3961 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DEVICE_SCALE))
3962 return fail_at(arg, COMMAND_LINE_ERROR);
3966 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
3974 WINPR_ASSERT(settings);
3980 return COMMAND_LINE_ERROR;
3982 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"smartcard-logon", arg->Value, &count);
3985 const CmdLineSubOptions opts[] = {
3986 {
"cert:", FreeRDP_SmartcardCertificate, CMDLINE_SUBOPTION_FILE,
3987 setSmartcardEmulation },
3988 {
"key:", FreeRDP_SmartcardPrivateKey, CMDLINE_SUBOPTION_FILE, setSmartcardEmulation },
3989 {
"pin:", FreeRDP_Password, CMDLINE_SUBOPTION_STRING,
nullptr },
3990 {
"csp:", FreeRDP_CspName, CMDLINE_SUBOPTION_STRING,
nullptr },
3991 {
"reader:", FreeRDP_ReaderName, CMDLINE_SUBOPTION_STRING,
nullptr },
3992 {
"card:", FreeRDP_CardName, CMDLINE_SUBOPTION_STRING,
nullptr },
3993 {
"container:", FreeRDP_ContainerName, CMDLINE_SUBOPTION_STRING,
nullptr }
3996 for (
size_t x = 1; x < count; x++)
3998 const char* cur = ptr[x];
3999 if (!parseSubOptions(settings, opts, ARRAYSIZE(opts), cur))
4001 CommandLineParserFree(ptr);
4002 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4006 CommandLineParserFree(ptr);
4013 WINPR_ASSERT(settings);
4017 char** ptr = CommandLineParseCommaSeparatedValuesEx(
"tune", arg->Value, &count);
4019 return COMMAND_LINE_ERROR;
4020 for (
size_t x = 1; x < count; x++)
4022 const char* cur = ptr[x];
4023 char* sep = strchr(cur,
':');
4026 CommandLineParserFree(ptr);
4027 return COMMAND_LINE_ERROR;
4030 if (!freerdp_settings_set_value_for_name(settings, cur, sep))
4032 CommandLineParserFree(ptr);
4033 return COMMAND_LINE_ERROR;
4037 CommandLineParserFree(ptr);
4042static int parse_app_option_program(rdpSettings* settings,
const char* cmd)
4044 const FreeRDP_Settings_Keys_Bool ids[] = { FreeRDP_RemoteApplicationMode,
4045 FreeRDP_RemoteAppLanguageBarSupported,
4046 FreeRDP_Workarea, FreeRDP_DisableWallpaper,
4047 FreeRDP_DisableFullWindowDrag };
4050 return COMMAND_LINE_ERROR_MEMORY;
4052 for (
size_t y = 0; y < ARRAYSIZE(ids); y++)
4055 return COMMAND_LINE_ERROR;
4057 return CHANNEL_RC_OK;
4063 WINPR_ASSERT(settings);
4066 int rc = CHANNEL_RC_OK;
4068 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4069 if (!ptr || (count == 0))
4070 rc = COMMAND_LINE_ERROR;
4077 int (*fkt)(rdpSettings* settings,
const char* value);
4079 const struct app_map amap[] = {
4080 {
"tenantid:", FreeRDP_GatewayAvdAadtenantid,
nullptr },
4081 {
"ad:", FreeRDP_GatewayAzureActiveDirectory,
nullptr },
4082 {
"avd-access:", FreeRDP_GatewayAvdAccessAadFormat,
nullptr },
4083 {
"avd-token:", FreeRDP_GatewayAvdAccessTokenFormat,
nullptr },
4084 {
"avd-scope:", FreeRDP_GatewayAvdScope,
nullptr },
4085 {
"auth-helper:", FreeRDP_AadAuthHelper,
nullptr },
4086 {
"user-agent:", FreeRDP_AadAuthUserAgent,
nullptr }
4088 for (
size_t x = 0; x < count; x++)
4090 BOOL handled = FALSE;
4091 const char* val = ptr[x];
4093 if (option_starts_with(
"use-tenantid", val))
4095 PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
4096 if (bval == PARSE_FAIL)
4098 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4106 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4112 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
4114 const struct app_map* cur = &amap[y];
4115 if (option_starts_with(cur->name, val))
4117 const char* xval = &val[strlen(cur->name)];
4119 rc = cur->fkt(settings, xval);
4123 if (!freerdp_settings_set_value_for_name(settings, name, xval))
4124 rc = COMMAND_LINE_ERROR_MEMORY;
4133 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4140 CommandLineParserFree(ptr);
4147 WINPR_ASSERT(settings);
4150 int rc = CHANNEL_RC_OK;
4152 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4153 if (!ptr || (count == 0))
4154 rc = COMMAND_LINE_ERROR;
4161 int (*fkt)(rdpSettings* settings,
const char* value);
4163 const struct app_map amap[] = {
4164 {
"program:", FreeRDP_RemoteApplicationProgram, parse_app_option_program },
4165 {
"workdir:", FreeRDP_RemoteApplicationWorkingDir,
nullptr },
4166 {
"name:", FreeRDP_RemoteApplicationName,
nullptr },
4167 {
"icon:", FreeRDP_RemoteApplicationIcon,
nullptr },
4168 {
"cmd:", FreeRDP_RemoteApplicationCmdLine,
nullptr },
4169 {
"file:", FreeRDP_RemoteApplicationFile,
nullptr },
4170 {
"guid:", FreeRDP_RemoteApplicationGuid,
nullptr },
4171 {
"hidef:", FreeRDP_HiDefRemoteApp,
nullptr }
4173 for (
size_t x = 0; x < count; x++)
4175 BOOL handled = FALSE;
4176 const char* val = ptr[x];
4178 for (
size_t y = 0; y < ARRAYSIZE(amap); y++)
4180 const struct app_map* cur = &amap[y];
4181 if (option_starts_with(cur->name, val))
4183 const char* xval = &val[strlen(cur->name)];
4185 rc = cur->fkt(settings, xval);
4189 if (!freerdp_settings_set_value_for_name(settings, name, xval))
4190 rc = COMMAND_LINE_ERROR_MEMORY;
4198#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4199 if (!handled && (count == 1))
4202 rc = parse_app_option_program(settings, val);
4207 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4214 CommandLineParserFree(ptr);
4221 WINPR_ASSERT(settings);
4224 int rc = CHANNEL_RC_OK;
4226 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4227 if (!ptr || (count == 0))
4228 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4230 for (
size_t x = 0; x < count; x++)
4232 const char* val = ptr[x];
4234 if (option_starts_with(
"codec:", val))
4237 rc = COMMAND_LINE_ERROR;
4238 else if (option_equals(arg->Value,
"rfx"))
4241 rc = COMMAND_LINE_ERROR;
4243 else if (option_equals(arg->Value,
"nsc"))
4246 rc = COMMAND_LINE_ERROR;
4249#if defined(WITH_JPEG)
4250 else if (option_equals(arg->Value,
"jpeg"))
4253 rc = COMMAND_LINE_ERROR;
4258 return COMMAND_LINE_ERROR;
4264 else if (option_starts_with(
"persist-file:", val))
4268 rc = COMMAND_LINE_ERROR_MEMORY;
4270 rc = COMMAND_LINE_ERROR;
4274 const PARSE_ON_OFF_RESULT bval = parse_on_off_option(val);
4275 if (bval == PARSE_FAIL)
4276 rc = COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
4279 if (option_starts_with(
"bitmap", val))
4283 rc = COMMAND_LINE_ERROR;
4285 else if (option_starts_with(
"glyph", val))
4288 bval != PARSE_OFF ? GLYPH_SUPPORT_FULL
4289 : GLYPH_SUPPORT_NONE))
4290 rc = COMMAND_LINE_ERROR;
4292 else if (option_starts_with(
"persist", val))
4296 rc = COMMAND_LINE_ERROR;
4298 else if (option_starts_with(
"offscreen", val))
4302 rc = COMMAND_LINE_ERROR;
4308 CommandLineParserFree(ptr);
4313static BOOL parse_gateway_host_option(rdpSettings* settings,
const char* host)
4315 WINPR_ASSERT(settings);
4318 char* name =
nullptr;
4320 if (!freerdp_parse_hostname(host, &name, &port))
4340static BOOL parse_gateway_cred_option(rdpSettings* settings,
const char* value,
4341 FreeRDP_Settings_Keys_String what)
4343 WINPR_ASSERT(settings);
4344 WINPR_ASSERT(value);
4348 case FreeRDP_GatewayUsername:
4349 if (!freerdp_parse_username_settings(value, settings, FreeRDP_GatewayUsername,
4350 FreeRDP_GatewayDomain))
4363static BOOL parse_gateway_type_option(rdpSettings* settings,
const char* value)
4367 WINPR_ASSERT(settings);
4368 WINPR_ASSERT(value);
4370 if (option_equals(value,
"rpc"))
4381 if (option_equals(value,
"http"))
4389 else if (option_equals(value,
"auto"))
4397 else if (option_equals(value,
"arm"))
4411static BOOL parse_gateway_usage_option(rdpSettings* settings,
const char* value)
4415 WINPR_ASSERT(settings);
4416 WINPR_ASSERT(value);
4418 if (option_equals(value,
"none"))
4419 type = TSC_PROXY_MODE_NONE_DIRECT;
4420 else if (option_equals(value,
"direct"))
4421 type = TSC_PROXY_MODE_DIRECT;
4422 else if (option_equals(value,
"detect"))
4423 type = TSC_PROXY_MODE_DETECT;
4424 else if (option_equals(value,
"default"))
4425 type = TSC_PROXY_MODE_DEFAULT;
4430 if (!value_to_int(value, &val, TSC_PROXY_MODE_NONE_DIRECT, TSC_PROXY_MODE_NONE_DETECT))
4432 type = WINPR_ASSERTING_INT_CAST(UINT32, val);
4438WINPR_ATTR_MALLOC(free, 1)
4439static
char* unescape(const
char* str)
4441 char* copy = _strdup(str);
4445 bool escaped =
false;
4447 while (*str !=
'\0')
4476 char* argval =
nullptr;
4479 WINPR_ASSERT(settings);
4483 char** ptr = CommandLineParseCommaSeparatedValues(arg->Value, &count);
4492 BOOL allowHttpOpts = FALSE;
4493 for (
size_t x = 0; x < count; x++)
4495 BOOL validOption = FALSE;
4497 argval = unescape(ptr[x]);
4501 const char* gw = option_starts_with(
"g:", argval);
4504 if (!parse_gateway_host_option(settings, gw))
4507 allowHttpOpts = FALSE;
4510 const char* gu = option_starts_with(
"u:", argval);
4513 if (!parse_gateway_cred_option(settings, gu, FreeRDP_GatewayUsername))
4516 allowHttpOpts = FALSE;
4519 const char* gd = option_starts_with(
"d:", argval);
4522 if (!parse_gateway_cred_option(settings, gd, FreeRDP_GatewayDomain))
4525 allowHttpOpts = FALSE;
4528 const char* gp = option_starts_with(
"p:", argval);
4531 if (!parse_gateway_cred_option(settings, gp, FreeRDP_GatewayPassword))
4534 allowHttpOpts = FALSE;
4537 const char* gt = option_starts_with(
"type:", argval);
4540 if (!parse_gateway_type_option(settings, gt))
4546 const char* gat = option_starts_with(
"access-token:", argval);
4552 allowHttpOpts = FALSE;
4555 const char* bearer = option_starts_with(
"bearer:", argval);
4562 allowHttpOpts = FALSE;
4565 const char* gwurl = option_starts_with(
"url:", argval);
4573 allowHttpOpts = FALSE;
4576 const char* um = option_starts_with(
"usage-method:", argval);
4579 if (!parse_gateway_usage_option(settings, um))
4582 allowHttpOpts = FALSE;
4585 const char* to = option_starts_with(
"timeout:", argval);
4589 if (!value_to_int(to, &val, 1, 600000))
4595 allowHttpOpts = FALSE;
4600 if (option_equals(argval,
"no-websockets"))
4607 else if (option_equals(argval,
"extauth-sspi-ntlm"))
4624 CommandLineParserFree(ptr);
4631 WINPR_ASSERT(value);
4637 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
4638 FillMemory(arg->Value, strlen(arg->Value),
'*');
4643 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
4645 const char* cred = credential_args[x];
4646 fill_credential_string(args, cred);
4650 if (arg && ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) != 0))
4652 const char* gwcreds[] = {
"p:",
"access-token:" };
4653 char* saveptr =
nullptr;
4654 char* tok = strtok_s(arg->Value,
",", &saveptr);
4657 for (
size_t x = 0; x < ARRAYSIZE(gwcreds); x++)
4659 const char* opt = gwcreds[x];
4660 if (option_starts_with(opt, tok))
4662 char* val = &tok[strlen(opt)];
4663 FillMemory(val, strlen(val),
'*');
4666 tok = strtok_s(
nullptr,
",", &saveptr);
4672static int parse_command_line_option_uint32(rdpSettings* settings,
4674 FreeRDP_Settings_Keys_UInt32 key, LONGLONG min,
4679 if (!value_to_int(arg->Value, &val, min, max))
4680 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4683 return fail_at(arg, COMMAND_LINE_ERROR);
4687#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
4692 WINPR_ASSERT(settings);
4695 BOOL enable = arg->Value ? TRUE : FALSE;
4696 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg,
"gfx-thin-client")
4698 WLog_WARN(TAG,
"/gfx-thin-client is deprecated, use /gfx:thin-client[:on|off] instead");
4700 return fail_at(arg, COMMAND_LINE_ERROR);
4705 return fail_at(arg, COMMAND_LINE_ERROR);
4709 return fail_at(arg, COMMAND_LINE_ERROR);
4711 CommandLineSwitchCase(arg,
"gfx-small-cache")
4713 WLog_WARN(TAG,
"/gfx-small-cache is deprecated, use /gfx:small-cache[:on|off] instead");
4715 return fail_at(arg, COMMAND_LINE_ERROR);
4719 return fail_at(arg, COMMAND_LINE_ERROR);
4721 CommandLineSwitchCase(arg,
"gfx-progressive")
4723 WLog_WARN(TAG,
"/gfx-progressive is deprecated, use /gfx:progressive[:on|off] instead");
4725 return fail_at(arg, COMMAND_LINE_ERROR);
4727 return fail_at(arg, COMMAND_LINE_ERROR);
4732 return fail_at(arg, COMMAND_LINE_ERROR);
4736 CommandLineSwitchCase(arg,
"gfx-h264")
4738 WLog_WARN(TAG,
"/gfx-h264 is deprecated, use /gfx:avc420 instead");
4739 int rc = parse_gfx_options(settings, arg);
4741 return fail_at(arg, rc);
4744 CommandLineSwitchCase(arg,
"app-workdir")
4747 "/app-workdir:<directory> is deprecated, use /app:workdir:<directory> instead");
4749 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4751 CommandLineSwitchCase(arg,
"app-name")
4753 WLog_WARN(TAG,
"/app-name:<directory> is deprecated, use /app:name:<name> instead");
4755 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4757 CommandLineSwitchCase(arg,
"app-icon")
4759 WLog_WARN(TAG,
"/app-icon:<filename> is deprecated, use /app:icon:<filename> instead");
4761 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4763 CommandLineSwitchCase(arg,
"app-cmd")
4765 WLog_WARN(TAG,
"/app-cmd:<command> is deprecated, use /app:cmd:<command> instead");
4767 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4769 CommandLineSwitchCase(arg,
"app-file")
4771 WLog_WARN(TAG,
"/app-file:<filename> is deprecated, use /app:file:<filename> instead");
4773 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4775 CommandLineSwitchCase(arg,
"app-guid")
4777 WLog_WARN(TAG,
"/app-guid:<guid> is deprecated, use /app:guid:<guid> instead");
4779 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4781 CommandLineSwitchCase(arg,
"g")
4783 if (!parse_gateway_host_option(settings, arg->Value))
4784 return fail_at(arg, COMMAND_LINE_ERROR);
4786 CommandLineSwitchCase(arg,
"gu")
4788 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayUsername))
4789 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4791 CommandLineSwitchCase(arg,
"gd")
4793 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayDomain))
4794 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4796 CommandLineSwitchCase(arg,
"gp")
4798 if (!parse_gateway_cred_option(settings, arg->Value, FreeRDP_GatewayPassword))
4799 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4801 CommandLineSwitchCase(arg,
"gt")
4803 if (!parse_gateway_type_option(settings, arg->Value))
4804 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4806 CommandLineSwitchCase(arg,
"gat")
4809 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4811 CommandLineSwitchCase(arg,
"gateway-usage-method")
4813 if (!parse_gateway_usage_option(settings, arg->Value))
4814 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4816 CommandLineSwitchCase(arg,
"kbd-remap")
4818 WLog_WARN(TAG,
"/kbd-remap:<key>=<value>,<key2>=<value2> is deprecated, use "
4819 "/kbd:remap:<key>=<value>,remap:<key2>=<value2>,... instead");
4821 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4823 CommandLineSwitchCase(arg,
"kbd-lang")
4827 WLog_WARN(TAG,
"/kbd-lang:<value> is deprecated, use /kbd:lang:<value> instead");
4828 if (!value_to_int(arg->Value, &val, 1, UINT32_MAX))
4830 WLog_ERR(TAG,
"Could not identify keyboard active language %s", arg->Value);
4831 WLog_ERR(TAG,
"Use /list:kbd-lang to list available layouts");
4832 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4836 return fail_at(arg, COMMAND_LINE_ERROR);
4838 CommandLineSwitchCase(arg,
"kbd-type")
4840 WLog_WARN(TAG,
"/kbd-type:<value> is deprecated, use /kbd:type:<value> instead");
4842 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardType, 0, UINT32_MAX);
4844 return fail_at(arg, rc);
4846 CommandLineSwitchCase(arg,
"kbd-unicode")
4848 WLog_WARN(TAG,
"/kbd-unicode is deprecated, use /kbd:unicode[:on|off] instead");
4850 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4852 CommandLineSwitchCase(arg,
"kbd-subtype")
4854 WLog_WARN(TAG,
"/kbd-subtype:<value> is deprecated, use /kbd:subtype:<value> instead");
4856 parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardSubType, 0, UINT32_MAX);
4858 return fail_at(arg, rc);
4860 CommandLineSwitchCase(arg,
"kbd-fn-key")
4862 WLog_WARN(TAG,
"/kbd-fn-key:<value> is deprecated, use /kbd:fn-key:<value> instead");
4863 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_KeyboardFunctionKey,
4866 return fail_at(arg, rc);
4868 CommandLineSwitchCase(arg,
"bitmap-cache")
4870 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4872 return fail_at(arg, COMMAND_LINE_ERROR);
4874 CommandLineSwitchCase(arg,
"persist-cache")
4876 WLog_WARN(TAG,
"/persist-cache is deprecated, use /cache:persist[:on|off] instead");
4878 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4880 CommandLineSwitchCase(arg,
"persist-cache-file")
4882 WLog_WARN(TAG,
"/persist-cache-file:<filename> is deprecated, use "
4883 "/cache:persist-file:<filename> instead");
4885 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4888 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
4890 CommandLineSwitchCase(arg,
"offscreen-cache")
4892 WLog_WARN(TAG,
"/bitmap-cache is deprecated, use /cache:bitmap[:on|off] instead");
4894 return fail_at(arg, COMMAND_LINE_ERROR);
4896 CommandLineSwitchCase(arg,
"glyph-cache")
4898 WLog_WARN(TAG,
"/glyph-cache is deprecated, use /cache:glyph[:on|off] instead");
4900 arg->Value ? GLYPH_SUPPORT_FULL : GLYPH_SUPPORT_NONE))
4901 return fail_at(arg, COMMAND_LINE_ERROR);
4903 CommandLineSwitchCase(arg,
"codec-cache")
4905 WLog_WARN(TAG,
"/codec-cache:<option> is deprecated, use /cache:codec:<option> instead");
4906 const int rc = parse_codec_cache_options(settings, arg);
4908 return fail_at(arg, rc);
4910 CommandLineSwitchCase(arg,
"sec-rdp")
4912 WLog_WARN(TAG,
"/sec-rdp is deprecated, use /sec:rdp[:on|off] instead");
4914 return fail_at(arg, COMMAND_LINE_ERROR);
4916 CommandLineSwitchCase(arg,
"sec-tls")
4918 WLog_WARN(TAG,
"/sec-tls is deprecated, use /sec:tls[:on|off] instead");
4920 return fail_at(arg, COMMAND_LINE_ERROR);
4922 CommandLineSwitchCase(arg,
"sec-nla")
4924 WLog_WARN(TAG,
"/sec-nla is deprecated, use /sec:nla[:on|off] instead");
4926 return fail_at(arg, COMMAND_LINE_ERROR);
4928 CommandLineSwitchCase(arg,
"sec-ext")
4930 WLog_WARN(TAG,
"/sec-ext is deprecated, use /sec:ext[:on|off] instead");
4932 return fail_at(arg, COMMAND_LINE_ERROR);
4934 CommandLineSwitchCase(arg,
"tls-ciphers")
4936 WLog_WARN(TAG,
"/tls-ciphers:<cipher list> is deprecated, use "
4937 "/tls:ciphers:<cipher list> instead");
4938 int rc = parse_tls_cipher_options(settings, arg);
4940 return fail_at(arg, rc);
4942 CommandLineSwitchCase(arg,
"tls-seclevel")
4944 WLog_WARN(TAG,
"/tls-seclevel:<level> is deprecated, use /tls:sec-level:<level> instead");
4945 int rc = parse_tls_cipher_options(settings, arg);
4947 return fail_at(arg, rc);
4949 CommandLineSwitchCase(arg,
"tls-secrets-file")
4951 WLog_WARN(TAG,
"/tls-secrets-file:<filename> is deprecated, use "
4952 "/tls:secrets-file:<filename> instead");
4953 int rc = parse_tls_cipher_options(settings, arg);
4955 return fail_at(arg, rc);
4957 CommandLineSwitchCase(arg,
"enforce-tlsv1_2")
4959 WLog_WARN(TAG,
"/enforce-tlsv1_2 is deprecated, use /tls:enforce:1.2 instead");
4960 int rc = parse_tls_cipher_options(settings, arg);
4962 return fail_at(arg, rc);
4964 CommandLineSwitchCase(arg,
"cert-name")
4966 WLog_WARN(TAG,
"/cert-name is deprecated, use /cert:name instead");
4968 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
4970 CommandLineSwitchCase(arg,
"cert-ignore")
4972 WLog_WARN(TAG,
"/cert-ignore is deprecated, use /cert:ignore instead");
4974 return fail_at(arg, COMMAND_LINE_ERROR);
4976 CommandLineSwitchCase(arg,
"cert-tofu")
4978 WLog_WARN(TAG,
"/cert-tofu is deprecated, use /cert:tofu instead");
4980 return fail_at(arg, COMMAND_LINE_ERROR);
4982 CommandLineSwitchCase(arg,
"cert-deny")
4984 WLog_WARN(TAG,
"/cert-deny is deprecated, use /cert:deny instead");
4986 return fail_at(arg, COMMAND_LINE_ERROR);
4988 CommandLineSwitchDefault(arg)
4992 CommandLineSwitchEnd(arg);
4998static int parse_command_line_option_timezone(rdpSettings* settings,
5004 char TimeZoneKeyName[ARRAYSIZE(info.TimeZoneKeyName) + 1] = WINPR_C_ARRAY_INIT;
5005 while (EnumDynamicTimeZoneInformation(index++, &info) != ERROR_NO_MORE_ITEMS)
5007 (void)ConvertWCharNToUtf8(info.TimeZoneKeyName, ARRAYSIZE(info.TimeZoneKeyName),
5008 TimeZoneKeyName, ARRAYSIZE(TimeZoneKeyName));
5010 WINPR_ASSERT(arg->Value);
5011 if (strncmp(TimeZoneKeyName, arg->Value, ARRAYSIZE(TimeZoneKeyName)) == 0)
5018 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5021 return fail_at(arg, COMMAND_LINE_ERROR);
5026 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5028 tz->Bias = info.Bias;
5029 tz->DaylightBias = info.DaylightBias;
5030 tz->DaylightDate = info.DaylightDate;
5031 memcpy(tz->DaylightName, info.DaylightName,
sizeof(tz->DaylightName));
5032 tz->StandardBias = info.StandardBias;
5033 tz->StandardDate = info.StandardDate;
5034 memcpy(tz->StandardName, info.StandardName,
sizeof(tz->StandardName));
5040static int parse_command_line_option_window_pos(rdpSettings* settings,
5043 WINPR_ASSERT(settings);
5046 unsigned long x = 0;
5047 unsigned long y = 0;
5050 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
5052 if (!parseSizeValue(arg->Value, &x, &y) || x > UINT16_MAX || y > UINT16_MAX)
5054 WLog_ERR(TAG,
"invalid window-position argument");
5055 return fail_at(arg, COMMAND_LINE_ERROR_MISSING_ARGUMENT);
5059 return fail_at(arg, COMMAND_LINE_ERROR);
5061 return fail_at(arg, COMMAND_LINE_ERROR);
5067 freerdp_command_line_handle_option_t handle_option,
5068 void* handle_userdata, BOOL* promptForPassword,
char** user)
5070 WINPR_ASSERT(promptForPassword);
5073 BOOL decorationsDefault = TRUE;
5076 BOOL enable = (arg->Value !=
nullptr);
5078 if (!(arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
5081 CommandLineSwitchStart(arg)
5083 CommandLineSwitchCase(arg,
"v")
5085 const int rc = parse_host_options(settings, arg);
5087 return fail_at(arg, rc);
5089 CommandLineSwitchCase(arg,
"spn-class")
5093 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5095 CommandLineSwitchCase(arg,
"sspi-module")
5098 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5100 CommandLineSwitchCase(arg,
"winscard-module")
5103 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5105 CommandLineSwitchCase(arg,
"redirect-prefer")
5107 const int rc = parse_redirect_prefer_options(settings, arg);
5109 return fail_at(arg, rc);
5111 CommandLineSwitchCase(arg,
"credentials-delegation")
5114 return fail_at(arg, COMMAND_LINE_ERROR);
5116 CommandLineSwitchCase(arg,
"prevent-session-lock")
5118 const int rc = parse_prevent_session_lock_options(settings, arg);
5120 return fail_at(arg, rc);
5122 CommandLineSwitchCase(arg,
"vmconnect")
5124 const int rc = parse_vmconnect_options(settings, arg);
5126 return fail_at(arg, rc);
5128 CommandLineSwitchCase(arg,
"w")
5130 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopWidth, -1,
5133 return fail_at(arg, rc);
5135 CommandLineSwitchCase(arg,
"h")
5137 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_DesktopHeight,
5140 return fail_at(arg, rc);
5142 CommandLineSwitchCase(arg,
"size")
5144 const int rc = parse_size_options(settings, arg);
5146 return fail_at(arg, rc);
5148 CommandLineSwitchCase(arg,
"f")
5151 return fail_at(arg, COMMAND_LINE_ERROR);
5153 CommandLineSwitchCase(arg,
"suppress-output")
5156 return fail_at(arg, COMMAND_LINE_ERROR);
5158 CommandLineSwitchCase(arg,
"multimon")
5160 switch (parse_on_off_argument(arg))
5164 return fail_at(arg, COMMAND_LINE_ERROR);
5168 return fail_at(arg, COMMAND_LINE_ERROR);
5170 return fail_at(arg, COMMAND_LINE_ERROR);
5173 if (!option_equals(arg->Value, str_force))
5174 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5176 return fail_at(arg, COMMAND_LINE_ERROR);
5178 return fail_at(arg, COMMAND_LINE_ERROR);
5182 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5185 CommandLineSwitchCase(arg,
"span")
5188 return fail_at(arg, COMMAND_LINE_ERROR);
5190 CommandLineSwitchCase(arg,
"workarea")
5193 return fail_at(arg, COMMAND_LINE_ERROR);
5195 CommandLineSwitchCase(arg,
"monitors")
5197 const int rc = parse_monitors_options(settings, arg);
5199 return fail_at(arg, rc);
5201 CommandLineSwitchCase(arg,
"t")
5204 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5206 CommandLineSwitchCase(arg,
"decorations")
5208 decorationsDefault = enable;
5210 CommandLineSwitchCase(arg,
"dynamic-resolution")
5212 const int rc = parse_dynamic_resolution_options(settings, arg);
5214 return fail_at(arg, rc);
5216 CommandLineSwitchCase(arg,
"smart-sizing")
5218 const int rc = parse_smart_sizing_options(settings, arg);
5220 return fail_at(arg, rc);
5222 CommandLineSwitchCase(arg,
"bpp")
5226 CommandLineSwitchCase(arg,
"admin")
5229 return fail_at(arg, COMMAND_LINE_ERROR);
5231 CommandLineSwitchCase(arg,
"relax-order-checks")
5235 return fail_at(arg, COMMAND_LINE_ERROR);
5237 CommandLineSwitchCase(arg,
"restricted-admin")
5240 return fail_at(arg, COMMAND_LINE_ERROR);
5242 return fail_at(arg, COMMAND_LINE_ERROR);
5244#ifdef CHANNEL_RDPEAR_CLIENT
5245 CommandLineSwitchCase(arg,
"remoteGuard")
5248 return fail_at(arg, COMMAND_LINE_ERROR);
5250 return fail_at(arg, COMMAND_LINE_ERROR);
5253 CommandLineSwitchCase(arg,
"pth")
5256 return fail_at(arg, COMMAND_LINE_ERROR);
5258 return fail_at(arg, COMMAND_LINE_ERROR);
5261 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5263 CommandLineSwitchCase(arg,
"client-hostname")
5266 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5268 CommandLineSwitchCase(arg,
"kbd")
5270 int rc = parse_kbd_options(settings, arg);
5272 return fail_at(arg, rc);
5275 CommandLineSwitchCase(arg,
"u")
5277 WINPR_ASSERT(arg->Value);
5280 CommandLineSwitchCase(arg,
"d")
5283 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5285 CommandLineSwitchCase(arg,
"p")
5289 const char* val = arg->Value;
5294 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5296 CommandLineSwitchCase(arg,
"gateway")
5298 if (!parse_gateway_options(settings, arg))
5299 return fail_at(arg, COMMAND_LINE_ERROR);
5301 CommandLineSwitchCase(arg,
"proxy")
5303 const int rc = parse_proxy_options(settings, arg);
5305 return fail_at(arg, rc);
5308 CommandLineSwitchCase(arg,
"azure")
5310 int rc = parse_aad_options(settings, arg);
5312 return fail_at(arg, rc);
5314 CommandLineSwitchCase(arg,
"app")
5316 decorationsDefault = FALSE;
5317 int rc = parse_app_options(settings, arg);
5319 return fail_at(arg, rc);
5321 CommandLineSwitchCase(arg,
"load-balance-info")
5323 WINPR_ASSERT(arg->Value);
5325 strlen(arg->Value)))
5326 return fail_at(arg, COMMAND_LINE_ERROR);
5329 CommandLineSwitchCase(arg,
"compression")
5332 return fail_at(arg, COMMAND_LINE_ERROR);
5334 CommandLineSwitchCase(arg,
"compression-level")
5336 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_CompressionLevel,
5339 return fail_at(arg, rc);
5341 CommandLineSwitchCase(arg,
"drives")
5344 return fail_at(arg, COMMAND_LINE_ERROR);
5346 CommandLineSwitchCase(arg,
"dump")
5348 const int rc = parse_dump_options(settings, arg);
5350 return fail_at(arg, rc);
5352 CommandLineSwitchCase(arg,
"disable-output")
5355 return fail_at(arg, COMMAND_LINE_ERROR);
5357 CommandLineSwitchCase(arg,
"home-drive")
5360 return fail_at(arg, COMMAND_LINE_ERROR);
5362 CommandLineSwitchCase(arg,
"ipv4")
5364 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5367 return fail_at(arg, COMMAND_LINE_ERROR);
5372 return fail_at(arg, COMMAND_LINE_ERROR);
5375 CommandLineSwitchCase(arg,
"ipv6")
5377 if (arg->Value !=
nullptr && strncmp(arg->Value, str_force, ARRAYSIZE(str_force)) == 0)
5380 return fail_at(arg, COMMAND_LINE_ERROR);
5385 return fail_at(arg, COMMAND_LINE_ERROR);
5388 CommandLineSwitchCase(arg,
"clipboard")
5390 const int rc = parse_clipboard_options(settings, arg);
5392 return fail_at(arg, rc);
5394 CommandLineSwitchCase(arg,
"server-name")
5397 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5399 CommandLineSwitchCase(arg,
"shell")
5402 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5404 CommandLineSwitchCase(arg,
"shell-dir")
5407 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5409 CommandLineSwitchCase(arg,
"audio-mode")
5411 const int rc = parse_audio_mode_options(settings, arg);
5413 return fail_at(arg, rc);
5415 CommandLineSwitchCase(arg,
"network")
5419 CommandLineSwitchCase(arg,
"fonts")
5422 return fail_at(arg, COMMAND_LINE_ERROR);
5424 CommandLineSwitchCase(arg,
"wallpaper")
5427 return fail_at(arg, COMMAND_LINE_ERROR);
5429 CommandLineSwitchCase(arg,
"window-drag")
5432 return fail_at(arg, COMMAND_LINE_ERROR);
5434 CommandLineSwitchCase(arg,
"window-position")
5436 const int rc = parse_command_line_option_window_pos(settings, arg);
5438 return fail_at(arg, rc);
5440 CommandLineSwitchCase(arg,
"menu-anims")
5443 return fail_at(arg, COMMAND_LINE_ERROR);
5445 CommandLineSwitchCase(arg,
"themes")
5448 return fail_at(arg, COMMAND_LINE_ERROR);
5450 CommandLineSwitchCase(arg,
"timeout")
5453 parse_command_line_option_uint32(settings, arg, FreeRDP_TcpAckTimeout, 0, 600000);
5455 return fail_at(arg, rc);
5456 const int rc2 = parse_command_line_option_uint32(settings, arg,
5457 FreeRDP_TcpConnectTimeout, 0, 600000);
5459 return fail_at(arg, rc2);
5461 CommandLineSwitchCase(arg,
"timezone")
5463 const int rc = parse_command_line_option_timezone(settings, arg);
5465 return fail_at(arg, rc);
5467 CommandLineSwitchCase(arg,
"aero")
5470 return fail_at(arg, COMMAND_LINE_ERROR);
5472 CommandLineSwitchCase(arg,
"gdi")
5474 if (option_equals(arg->Value,
"sw"))
5477 return fail_at(arg, COMMAND_LINE_ERROR);
5479 else if (option_equals(arg->Value,
"hw"))
5482 return fail_at(arg, COMMAND_LINE_ERROR);
5485 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5487 CommandLineSwitchCase(arg,
"gfx")
5492 CommandLineSwitchCase(arg,
"rfx")
5496 CommandLineSwitchCase(arg,
"rfx-mode")
5499 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5501 if (option_equals(arg->Value,
"video"))
5504 return fail_at(arg, COMMAND_LINE_ERROR);
5506 else if (option_equals(arg->Value,
"image"))
5509 return fail_at(arg, COMMAND_LINE_ERROR);
5511 return fail_at(arg, COMMAND_LINE_ERROR);
5514 CommandLineSwitchCase(arg,
"frame-ack")
5516 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_FrameAcknowledge,
5519 return fail_at(arg, rc);
5521 CommandLineSwitchCase(arg,
"nsc")
5524 return fail_at(arg, COMMAND_LINE_ERROR);
5526#if defined(WITH_JPEG)
5527 CommandLineSwitchCase(arg,
"jpeg")
5530 return fail_at(arg, COMMAND_LINE_ERROR);
5532 return fail_at(arg, COMMAND_LINE_ERROR);
5534 CommandLineSwitchCase(arg,
"jpeg-quality")
5538 if (!value_to_int(arg->Value, &val, 0, 100))
5539 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5542 return fail_at(arg, COMMAND_LINE_ERROR);
5545 CommandLineSwitchCase(arg,
"nego")
5548 return fail_at(arg, COMMAND_LINE_ERROR);
5550 CommandLineSwitchCase(arg,
"endpointfedauth")
5553 return fail_at(arg, COMMAND_LINE_ERROR);
5555 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5557 CommandLineSwitchCase(arg,
"pcb")
5560 return fail_at(arg, COMMAND_LINE_ERROR);
5563 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5565 CommandLineSwitchCase(arg,
"pcid")
5567 const int rc = parse_command_line_option_uint32(settings, arg, FreeRDP_PreconnectionId,
5570 return fail_at(arg, rc);
5572 return fail_at(arg, COMMAND_LINE_ERROR);
5575 CommandLineSwitchCase(arg,
"connect-child-session")
5589 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5592 CommandLineSwitchCase(arg,
"sec")
5594 const int rc = parse_sec_options(settings, arg);
5596 return fail_at(arg, rc);
5598 CommandLineSwitchCase(arg,
"encryption-methods")
5600 const int rc = parse_encryption_methods_options(settings, arg);
5602 return fail_at(arg, rc);
5604 CommandLineSwitchCase(arg,
"args-from")
5606 WLog_ERR(TAG,
"/args-from:%s can not be used in combination with other arguments!",
5608 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5610 CommandLineSwitchCase(arg,
"from-stdin")
5613 return fail_at(arg, COMMAND_LINE_ERROR);
5615 if (arg->Flags & COMMAND_LINE_VALUE_PRESENT)
5618 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5619 *promptForPassword = (option_equals(arg->Value, str_force));
5621 if (!*promptForPassword)
5622 return fail_at(arg, COMMAND_LINE_ERROR);
5625 CommandLineSwitchCase(arg,
"log-level")
5627 wLog* root = WLog_GetRoot();
5629 if (!WLog_SetStringLogLevel(root, arg->Value))
5630 return fail_at(arg, COMMAND_LINE_ERROR);
5632 CommandLineSwitchCase(arg,
"log-filters")
5634 if (!WLog_AddStringLogFilters(arg->Value))
5635 return fail_at(arg, COMMAND_LINE_ERROR);
5637 CommandLineSwitchCase(arg,
"tls")
5639 int rc = parse_tls_options(settings, arg);
5641 return fail_at(arg, rc);
5643 CommandLineSwitchCase(arg,
"cert")
5645 const int rc = parse_cert_options(settings, arg);
5647 return fail_at(arg, rc);
5649 CommandLineSwitchCase(arg,
"authentication")
5652 return fail_at(arg, COMMAND_LINE_ERROR);
5654 CommandLineSwitchCase(arg,
"encryption")
5657 return fail_at(arg, COMMAND_LINE_ERROR);
5659 CommandLineSwitchCase(arg,
"grab-keyboard")
5662 return fail_at(arg, COMMAND_LINE_ERROR);
5664 CommandLineSwitchCase(arg,
"grab-mouse")
5667 return fail_at(arg, COMMAND_LINE_ERROR);
5669 CommandLineSwitchCase(arg,
"mouse-relative")
5672 return fail_at(arg, COMMAND_LINE_ERROR);
5674 CommandLineSwitchCase(arg,
"mouse")
5676 const int rc = parse_mouse_options(settings, arg);
5678 return fail_at(arg, rc);
5680 CommandLineSwitchCase(arg,
"unmap-buttons")
5683 return fail_at(arg, COMMAND_LINE_ERROR);
5685 CommandLineSwitchCase(arg,
"toggle-fullscreen")
5688 return fail_at(arg, COMMAND_LINE_ERROR);
5690 CommandLineSwitchCase(arg,
"force-console-callbacks")
5693 return fail_at(arg, COMMAND_LINE_ERROR);
5695 CommandLineSwitchCase(arg,
"floatbar")
5697 const int rc = parse_floatbar_options(settings, arg);
5699 return fail_at(arg, rc);
5701 CommandLineSwitchCase(arg,
"mouse-motion")
5704 return fail_at(arg, COMMAND_LINE_ERROR);
5706 CommandLineSwitchCase(arg,
"parent-window")
5710 if (!value_to_uint(arg->Value, &val, 0, UINT64_MAX))
5711 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5714 return fail_at(arg, COMMAND_LINE_ERROR);
5716 CommandLineSwitchCase(arg,
"client-build-number")
5719 parse_command_line_option_uint32(settings, arg, FreeRDP_ClientBuild, 0, UINT32_MAX);
5721 return fail_at(arg, rc);
5723 CommandLineSwitchCase(arg,
"cache")
5725 int rc = parse_cache_options(settings, arg);
5727 return fail_at(arg, rc);
5730 CommandLineSwitchCase(arg,
"max-fast-path-size")
5732 const int rc = parse_command_line_option_uint32(
5733 settings, arg, FreeRDP_MultifragMaxRequestSize, 0, UINT32_MAX);
5735 return fail_at(arg, rc);
5737 CommandLineSwitchCase(arg,
"auto-request-control")
5741 return fail_at(arg, COMMAND_LINE_ERROR);
5743 CommandLineSwitchCase(arg,
"async-update")
5746 return fail_at(arg, COMMAND_LINE_ERROR);
5748 CommandLineSwitchCase(arg,
"async-channels")
5751 return fail_at(arg, COMMAND_LINE_ERROR);
5753 CommandLineSwitchCase(arg,
"wm-class")
5756 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5758 CommandLineSwitchCase(arg,
"play-rfx")
5761 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5764 return fail_at(arg, COMMAND_LINE_ERROR);
5766 CommandLineSwitchCase(arg,
"auth-only")
5769 return fail_at(arg, COMMAND_LINE_ERROR);
5771 CommandLineSwitchCase(arg,
"auth-pkg-list")
5775 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5777 CommandLineSwitchCase(arg,
"auto-reconnect")
5780 return fail_at(arg, COMMAND_LINE_ERROR);
5782 CommandLineSwitchCase(arg,
"auto-reconnect-max-retries")
5784 const int rc = parse_command_line_option_uint32(
5785 settings, arg, FreeRDP_AutoReconnectMaxRetries, 0, 1000);
5787 return fail_at(arg, rc);
5789 CommandLineSwitchCase(arg,
"reconnect-cookie")
5791 const int rc = parse_reconnect_cookie_options(settings, arg);
5793 return fail_at(arg, rc);
5795 CommandLineSwitchCase(arg,
"print-reconnect-cookie")
5798 return fail_at(arg, COMMAND_LINE_ERROR);
5800 CommandLineSwitchCase(arg,
"pwidth")
5802 const int rc = parse_command_line_option_uint32(
5803 settings, arg, FreeRDP_DesktopPhysicalWidth, 0, UINT32_MAX);
5805 return fail_at(arg, rc);
5807 CommandLineSwitchCase(arg,
"pheight")
5809 const int rc = parse_command_line_option_uint32(
5810 settings, arg, FreeRDP_DesktopPhysicalHeight, 0, UINT32_MAX);
5812 return fail_at(arg, rc);
5814 CommandLineSwitchCase(arg,
"orientation")
5818 if (!value_to_int(arg->Value, &val, 0, UINT16_MAX))
5819 return fail_at(arg, COMMAND_LINE_ERROR_UNEXPECTED_VALUE);
5822 return fail_at(arg, COMMAND_LINE_ERROR);
5823 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_ORIENTATION))
5824 return fail_at(arg, COMMAND_LINE_ERROR);
5826 CommandLineSwitchCase(arg,
"old-license")
5829 return fail_at(arg, COMMAND_LINE_ERROR);
5831 CommandLineSwitchCase(arg,
"scale")
5833 const int rc = parse_scale_options(settings, arg);
5835 return fail_at(arg, rc);
5837 CommandLineSwitchCase(arg,
"scale-desktop")
5839 const int rc = parse_command_line_option_uint32(settings, arg,
5840 FreeRDP_DesktopScaleFactor, 100, 500);
5842 return fail_at(arg, rc);
5843 if (!set_monitor_override(settings, FREERDP_MONITOR_OVERRIDE_DESKTOP_SCALE))
5844 return fail_at(arg, COMMAND_LINE_ERROR);
5846 CommandLineSwitchCase(arg,
"scale-device")
5848 const int rc = parse_scale_device_options(settings, arg);
5850 return fail_at(arg, rc);
5852 CommandLineSwitchCase(arg,
"action-script")
5855 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5857#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
5858 CommandLineSwitchCase(arg, RDP2TCP_DVC_CHANNEL_NAME)
5861 return fail_at(arg, COMMAND_LINE_ERROR_MEMORY);
5864 CommandLineSwitchCase(arg,
"fipsmode")
5867 return fail_at(arg, COMMAND_LINE_ERROR);
5869 CommandLineSwitchCase(arg,
"smartcard-logon")
5871 const int rc = parse_smartcard_logon_options(settings, arg);
5873 return fail_at(arg, rc);
5875 CommandLineSwitchCase(arg,
"tune")
5877 const int rc = parse_tune_options(settings, arg);
5879 return fail_at(arg, rc);
5881 CommandLineSwitchDefault(arg)
5883#if defined(WITH_FREERDP_DEPRECATED_COMMANDLINE)
5884 const int status = parse_deprecated_command_line(settings, arg);
5891 const int rc = handle_option(arg, handle_userdata);
5893 return fail_at(arg, rc);
5896 CommandLineSwitchEnd(arg)
5897 }
while ((arg = CommandLineFindNextArgumentA(arg)) !=
nullptr);
5900 return fail_at(arg, COMMAND_LINE_ERROR);
5908 bool insecureArgFound =
false;
5909 for (
size_t x = 0; x < ARRAYSIZE(credential_args); x++)
5911 const char* cred = credential_args[x];
5915 if ((arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT) == 0)
5918 WLog_WARN(TAG,
"Using /%s is insecure", arg->Name);
5919 insecureArgFound =
true;
5922 if (insecureArgFound)
5924 WLog_WARN(TAG,
"Passing credentials or secrets via command line might expose these in the "
5926 WLog_WARN(TAG,
"Consider using one of the following (more secure) alternatives:");
5927 WLog_WARN(TAG,
" - /args-from: pipe in arguments from stdin, file, file descriptor or "
5928 "environment variable");
5929 WLog_WARN(TAG,
" - /from-stdin pass the credential via stdin");
5930 WLog_WARN(TAG,
" - set environment variable FREERDP_ASKPASS to have a gui tool query for "
5936static int freerdp_client_settings_parse_command_line_arguments_int(
5937 rdpSettings* settings,
int argc,
char* argv[], BOOL allowUnknown,
5939 freerdp_command_line_handle_option_t handle_option,
void* handle_userdata, UINT32 cmdflags)
5941 char* user =
nullptr;
5944 BOOL assist = FALSE;
5946 BOOL promptForPassword = FALSE;
5947 BOOL compatibility = FALSE;
5955 ext = option_is_rdp_file(argv[1]);
5956 assist = option_is_incident_file(argv[1]);
5959 if (!ext && !assist)
5960 compatibility = freerdp_client_detect_command_line(argc, argv, &flags);
5962 compatibility = freerdp_client_detect_command_line(argc - 1, &argv[1], &flags);
5973 WLog_WARN(TAG,
"Unsupported command line syntax!");
5974 WLog_WARN(TAG,
"%s 1.0 style syntax was dropped with version 3!",
5975 freerdp_getApplicationDetailsString());
5980 flags |= COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
5984 if (freerdp_client_settings_parse_connection_file(settings, argv[1]))
5985 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5990 if (freerdp_client_settings_parse_assistance_file(settings, argc, argv) < 0)
5991 return COMMAND_LINE_ERROR_UNEXPECTED_VALUE;
5994 CommandLineClearArgumentsA(largs);
5995 status = CommandLineParseArgumentsA(argc, argv, largs, flags, settings,
5996 freerdp_client_command_line_pre_filter,
5997 freerdp_client_command_line_post_filter);
6002 status = prepare_default_settings(settings, largs);
6006 if ((cmdflags & FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS) == 0)
6007 warn_credential_args(largs);
6014 return COMMAND_LINE_ERROR_MEMORY;
6016 status = parse_command_line(settings, arg, handle_option, handle_userdata, &promptForPassword,
6024 return COMMAND_LINE_ERROR;
6027 return COMMAND_LINE_ERROR;
6029 if (!freerdp_parse_username_settings(user, settings, FreeRDP_Username, FreeRDP_Domain))
6030 return COMMAND_LINE_ERROR;
6035 return COMMAND_LINE_ERROR;
6039 if (promptForPassword)
6044 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
6046 if (!freerdp_passphrase_read(instance->context,
"Password: ", buffer,
6047 ARRAYSIZE(buffer) - 1, 1))
6048 return COMMAND_LINE_ERROR;
6050 return COMMAND_LINE_ERROR;
6058 char buffer[512 + 1] = WINPR_C_ARRAY_INIT;
6060 if (!freerdp_passphrase_read(instance->context,
"Gateway Password: ", buffer,
6061 ARRAYSIZE(buffer) - 1, 1))
6062 return COMMAND_LINE_ERROR;
6064 return COMMAND_LINE_ERROR;
6069 freerdp_performance_flags_make(settings);
6076 return COMMAND_LINE_ERROR;
6078 return COMMAND_LINE_ERROR;
6081 arg = CommandLineFindArgumentA(largs,
"port");
6082 if (arg->Flags & COMMAND_LINE_ARGUMENT_PRESENT)
6085 parse_command_line_option_uint32(settings, arg, FreeRDP_ServerPort, 0, UINT16_MAX);
6087 return fail_at(arg, rc);
6093 if (nego && (nego->Flags & COMMAND_LINE_ARGUMENT_PRESENT))
6094 return fail_at(arg, COMMAND_LINE_ERROR);
6097 WLog_INFO(TAG,
"/vmconnect uses custom port %" PRIu32, port);
6100 fill_credential_strings(largs);
6105static void argv_free(
int* pargc,
char** pargv[])
6107 WINPR_ASSERT(pargc);
6108 WINPR_ASSERT(pargv);
6109 const int argc = *pargc;
6110 char** argv = *pargv;
6116 for (
int x = 0; x < argc; x++)
6122static BOOL argv_append(
int* pargc,
char** pargv[],
char* what)
6124 WINPR_ASSERT(pargc);
6125 WINPR_ASSERT(pargv);
6133 int nargc = *pargc + 1;
6134 char** tmp = (
char**)realloc((
void*)*pargv, (size_t)nargc *
sizeof(
char*));
6145static BOOL argv_append_dup(
int* pargc,
char** pargv[],
const char* what)
6147 char* copy =
nullptr;
6149 copy = _strdup(what);
6151 const BOOL rc = argv_append(pargc, pargv, copy);
6158static BOOL args_from_fp(FILE* fp,
int* aargc,
char** aargv[],
const char* file,
const char* cmd)
6160 BOOL success = FALSE;
6162 WINPR_ASSERT(aargc);
6163 WINPR_ASSERT(aargv);
6168 WLog_ERR(TAG,
"Failed to read command line options from file '%s'", file);
6171 if (!argv_append_dup(aargc, aargv, cmd))
6175 char* line =
nullptr;
6177 INT64 rc = GetLine(&line, &size, fp);
6178 if ((rc < 0) || !line)
6188 const char cur = (line[rc - 1]);
6189 if ((cur ==
'\n') || (cur ==
'\r'))
6191 line[rc - 1] =
'\0';
6203 if (!argv_append(aargc, aargv, line))
6214 argv_free(aargc, aargv);
6219static BOOL args_from_env(
const char* name,
int* aargc,
char** aargv[],
const char* arg,
6222 BOOL success = FALSE;
6223 char* env =
nullptr;
6225 WINPR_ASSERT(aargc);
6226 WINPR_ASSERT(aargv);
6231 WLog_ERR(TAG,
"%s - environment variable name empty", arg);
6236 const DWORD size = GetEnvironmentVariableX(name, env, 0);
6239 WLog_ERR(TAG,
"%s - no environment variable '%s'", arg, name);
6242 env = calloc(size + 1,
sizeof(
char));
6247 const DWORD rc = GetEnvironmentVariableX(name, env, size);
6252 WLog_ERR(TAG,
"environment variable '%s' is empty", arg);
6258 if (!argv_append_dup(aargc, aargv, cmd))
6262 char* context =
nullptr;
6263 char* tok = strtok_s(env,
"\n", &context);
6266 if (!argv_append_dup(aargc, aargv, tok))
6268 tok = strtok_s(
nullptr,
"\n", &context);
6276 argv_free(aargc, aargv);
6280int freerdp_client_settings_parse_command_line_arguments(rdpSettings* settings,
int oargc,
6281 char* oargv[], BOOL allowUnknown)
6283 return freerdp_client_settings_parse_command_line_arguments_ex(
6284 settings, oargc, oargv, allowUnknown,
nullptr, 0,
nullptr,
nullptr);
6287int freerdp_client_settings_parse_command_line_arguments_ex(
6289 size_t count, freerdp_command_line_handle_option_t handle_option,
void* handle_userdata)
6291 return freerdp_client_settings_parse_command_line_arguments_with_flags(
6292 settings, argc, argv, allowUnknown, args, count, handle_option, handle_userdata, 0);
6295int freerdp_client_settings_parse_command_line_arguments_with_flags(
6296 rdpSettings* settings,
int oargc,
char** oargv, BOOL allowUnknown,
6298 void* handle_userdata, UINT32 flags, ...)
6301 char** argv = oargv;
6304 char** aargv =
nullptr;
6306 if ((argc == 2) && option_starts_with(
"/args-from:", argv[1]))
6308 flags |= FREERDP_SETTINGS_CMD_PARSE_SUPPRESS_WARNINGS;
6309 BOOL success = FALSE;
6310 const char* file = strchr(argv[1],
':') + 1;
6313 if (option_starts_with(
"fd:", file))
6315 ULONGLONG result = 0;
6316 const char* val = strchr(file,
':') + 1;
6319 if (!value_to_uint(val, &result, 0, INT_MAX))
6321 fp = fdopen((
int)result,
"r");
6322 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6324 else if (strncmp(file,
"env:", 4) == 0)
6326 const char* name = strchr(file,
':') + 1;
6329 success = args_from_env(name, &aargc, &aargv, oargv[1], oargv[0]);
6331 else if (strncmp(file,
"file:", 5) == 0)
6333 file = strchr(file,
':') + 1;
6336 fp = winpr_fopen(file,
"r");
6337 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6339#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
6340 else if (strcmp(file,
"stdin") != 0)
6342 fp = winpr_fopen(file,
"r");
6343 WLog_WARN(TAG,
"/args-from:%s is deprecated, use /args-from:file:%s instead", file,
6345 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6348 else if (strcmp(file,
"stdin") == 0)
6349 success = args_from_fp(fp, &aargc, &aargv, file, oargv[0]);
6357 WINPR_ASSERT(count <= SSIZE_MAX);
6363 res = freerdp_client_settings_parse_command_line_arguments_int(
6364 settings, argc, argv, allowUnknown, largs, lcount, handle_option, handle_userdata, flags);
6367 argv_free(&aargc, &aargv);
6372static BOOL freerdp_client_load_static_channel_addin(rdpChannels* channels, rdpSettings* settings,
6373 const char* name,
void* data)
6375 PVIRTUALCHANNELENTRY entry =
nullptr;
6376 PVIRTUALCHANNELENTRY pvce = freerdp_load_channel_addin_entry(
6377 name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC | FREERDP_ADDIN_CHANNEL_ENTRYEX);
6378 PVIRTUALCHANNELENTRYEX pvceex = WINPR_FUNC_PTR_CAST(pvce, PVIRTUALCHANNELENTRYEX);
6382 freerdp_load_channel_addin_entry(name,
nullptr,
nullptr, FREERDP_ADDIN_CHANNEL_STATIC);
6386 if (freerdp_channels_client_load_ex(channels, settings, pvceex, data) == 0)
6388 WLog_DBG(TAG,
"loading channelEx %s", name);
6394 if (freerdp_channels_client_load(channels, settings, entry, data) == 0)
6396 WLog_DBG(TAG,
"loading channel %s", name);
6404BOOL freerdp_client_load_addins(rdpChannels* channels, rdpSettings* settings)
6406 ChannelToLoad dynChannels[] = {
6407#if defined(CHANNEL_AINPUT_CLIENT)
6408 { FreeRDP_BOOL_UNUSED, AINPUT_CHANNEL_NAME,
nullptr },
6410#ifdef CHANNEL_AUDIN_CLIENT
6411 { FreeRDP_AudioCapture, AUDIN_CHANNEL_NAME,
nullptr },
6413#ifdef CHANNEL_RDPSND_CLIENT
6414 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6416#ifdef CHANNEL_RDPEI_CLIENT
6417 { FreeRDP_MultiTouchInput, RDPEI_CHANNEL_NAME,
nullptr },
6419#ifdef CHANNEL_RDPGFX_CLIENT
6420 { FreeRDP_SupportGraphicsPipeline, RDPGFX_CHANNEL_NAME,
nullptr },
6422#ifdef CHANNEL_ECHO_CLIENT
6423 { FreeRDP_SupportEchoChannel, ECHO_CHANNEL_NAME,
nullptr },
6425#ifdef CHANNEL_SSHAGENT_CLIENT
6426 { FreeRDP_SupportSSHAgentChannel,
"sshagent",
nullptr },
6428#ifdef CHANNEL_DISP_CLIENT
6429 { FreeRDP_SupportDisplayControl, DISP_CHANNEL_NAME,
nullptr },
6431#ifdef CHANNEL_GEOMETRY_CLIENT
6432 { FreeRDP_SupportGeometryTracking, GEOMETRY_CHANNEL_NAME,
nullptr },
6434#ifdef CHANNEL_VIDEO_CLIENT
6435 { FreeRDP_SupportVideoOptimized, VIDEO_CHANNEL_NAME,
nullptr },
6437#ifdef CHANNEL_RDPEAR_CLIENT
6438 { FreeRDP_RemoteCredentialGuard, RDPEAR_CHANNEL_NAME,
nullptr },
6440#ifdef CHANNEL_RDPEWA_CLIENT
6441 { FreeRDP_RedirectWebAuthN, RDPEWA_CHANNEL_NAME,
nullptr },
6445 ChannelToLoad staticChannels[] = {
6446#if defined(CHANNEL_RDPSND_CLIENT)
6447 { FreeRDP_AudioPlayback, RDPSND_CHANNEL_NAME,
nullptr },
6449#if defined(CHANNEL_CLIPRDR_CLIENT)
6450 { FreeRDP_RedirectClipboard, CLIPRDR_SVC_CHANNEL_NAME,
nullptr },
6452#if defined(CHANNEL_ENCOMSP_CLIENT)
6453 { FreeRDP_EncomspVirtualChannel, ENCOMSP_SVC_CHANNEL_NAME, settings },
6455#if defined(CHANNEL_REMDESK_CLIENT)
6456 { FreeRDP_RemdeskVirtualChannel, REMDESK_SVC_CHANNEL_NAME, settings },
6458#if defined(CHANNEL_RAIL_CLIENT)
6459 { FreeRDP_RemoteApplicationMode, RAIL_SVC_CHANNEL_NAME, settings }
6466 for (
size_t i = 0; i < ARRAYSIZE(dynChannels); i++)
6468 if ((dynChannels[i].settingId == FreeRDP_BOOL_UNUSED) ||
6471 const char*
const p[] = { dynChannels[i].channelName };
6473 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(p), p))
6481 if ((freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME)) ||
6482 (freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6483#
if defined(CHANNEL_TSMF_CLIENT)
6484 || (freerdp_dynamic_channel_collection_find(settings,
"tsmf"))
6494 if (freerdp_dynamic_channel_collection_find(settings, AUDIN_CHANNEL_NAME))
6510 if (DrivesToRedirect && (strlen(DrivesToRedirect) != 0))
6518 char* value =
nullptr;
6519 char* tok =
nullptr;
6520 char* context =
nullptr;
6522 value = _strdup(DrivesToRedirect);
6526 tok = strtok_s(value,
";", &context);
6529 WLog_ERR(TAG,
"DrivesToRedirect contains invalid data: '%s'", DrivesToRedirect);
6546 const char* name =
nullptr;
6547 const char* drive = tok;
6548 char* subcontext =
nullptr;
6549 char* start = strtok_s(tok,
"(", &subcontext);
6550 char* end = strtok_s(
nullptr,
")", &subcontext);
6554 if (freerdp_path_valid(name,
nullptr) && freerdp_path_valid(drive,
nullptr))
6556 success = freerdp_client_add_drive(settings, name,
nullptr);
6558 success = freerdp_client_add_drive(settings, drive,
nullptr);
6561 success = freerdp_client_add_drive(settings, drive, name);
6569 tok = strtok_s(
nullptr,
";", &context);
6578 if (!freerdp_device_collection_find(settings,
"drive"))
6580 const char*
const params[] = {
"drive",
"media",
"*" };
6582 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6599 if (!freerdp_device_collection_find(settings,
"drive"))
6601 const char* params[] = {
"drive",
"home",
"%" };
6603 if (!freerdp_client_add_device_channel(settings, ARRAYSIZE(params), params))
6610 if (!freerdp_client_load_static_channel_addin(channels, settings, RDPDR_SVC_CHANNEL_NAME,
6614 if (!freerdp_static_channel_collection_find(settings, RDPSND_CHANNEL_NAME) &&
6615 !freerdp_dynamic_channel_collection_find(settings, RDPSND_CHANNEL_NAME))
6617 const char*
const params[] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
6619 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(params), params))
6622 if (!freerdp_client_add_dynamic_channel(settings, ARRAYSIZE(params), params))
6629 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_SMARTCARD))
6631 RDPDR_DEVICE* smartcard = freerdp_device_new(RDPDR_DTYP_SMARTCARD, 0,
nullptr);
6636 if (!freerdp_device_collection_add(settings, smartcard))
6638 freerdp_device_free(smartcard);
6646 if (!freerdp_device_collection_find_type(settings, RDPDR_DTYP_PRINT))
6648 RDPDR_DEVICE* printer = freerdp_device_new(RDPDR_DTYP_PRINT, 0,
nullptr);
6653 if (!freerdp_device_collection_add(settings, printer))
6655 freerdp_device_free(printer);
6682 for (
size_t i = 0; i < ARRAYSIZE(staticChannels); i++)
6684 if ((staticChannels[i].settingId == 0) ||
6687 if (staticChannels[i].args)
6689 if (!freerdp_client_load_static_channel_addin(
6690 channels, settings, staticChannels[i].channelName, staticChannels[i].args))
6695 const char*
const p[] = { staticChannels[i].channelName };
6696 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6702#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
6707 const char*
const p[] = { RDP2TCP_DVC_CHANNEL_NAME, RDP2TCPArgs };
6708 if (!freerdp_client_add_static_channel(settings, ARRAYSIZE(p), p))
6718 freerdp_settings_get_pointer_array_writable(settings, FreeRDP_StaticChannelArray, i);
6720 if (!freerdp_client_load_static_channel_addin(channels, settings, _args->argv[0], _args))
6732 if (!freerdp_client_load_static_channel_addin(channels, settings, DRDYNVC_SVC_CHANNEL_NAME,
6740void freerdp_client_warn_unmaintained(
int argc,
char* argv[])
6742 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6743 wLog* log = WLog_Get(TAG);
6746 freerdp_warn_unmaintained(log,
"%s client", app);
6749void freerdp_client_warn_experimental(
int argc,
char* argv[])
6751 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6752 wLog* log = WLog_Get(TAG);
6755 freerdp_warn_experimental(log,
"%s client", app);
6758void freerdp_client_warn_deprecated(
int argc,
char* argv[])
6760 const char* app = (argc > 0) ? argv[0] :
"INVALID_ARGV";
6761 wLog* log = WLog_Get(TAG);
6764 freerdp_warn_deprecated(log,
"%s client",
6765 "As replacement there is a SDL3 based client available.", app);
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API char * freerdp_settings_get_string_writable(rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a string settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL val)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string_len(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val, size_t len)
Sets a string settings value. The val is copied.
WINPR_ATTR_NODISCARD FREERDP_API INT32 freerdp_settings_get_int32(const rdpSettings *settings, FreeRDP_Settings_Keys_Int32 id)
Returns a INT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT16 freerdp_settings_get_uint16(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id)
Returns a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT64 freerdp_settings_get_uint64(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id)
Returns a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint64(rdpSettings *settings, FreeRDP_Settings_Keys_UInt64 id, UINT64 val)
Sets a UINT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_append_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *separator, const char *param)
appends a string to a settings value. The param is copied. If the initial value of the setting was no...
WINPR_ATTR_NODISCARD FREERDP_API INT16 freerdp_settings_get_int16(const rdpSettings *settings, FreeRDP_Settings_Keys_Int16 id)
Returns a INT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API INT64 freerdp_settings_get_int64(const rdpSettings *settings, FreeRDP_Settings_Keys_Int64 id)
Returns a INT64 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint16(rdpSettings *settings, FreeRDP_Settings_Keys_UInt16 id, UINT16 val)
Sets a UINT16 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_set_gateway_usage_method(rdpSettings *settings, UINT32 GatewayUsageMethod)
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val)
Sets a string settings value. The param is copied.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_name_for_key(SSIZE_T key)
Returns the type name for a key.
WINPR_ATTR_NODISCARD FREERDP_API SSIZE_T freerdp_settings_get_type_for_key(SSIZE_T key)
Get a key type for the key index.