Coverage Report

Created: 2026-02-26 06:54

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/FreeRDP/libfreerdp/utils/string.c
Line
Count
Source
1
/**
2
 * FreeRDP: A Remote Desktop Protocol Implementation
3
 *
4
 * String Utils - Helper functions converting something to string
5
 *
6
 * Copyright 2022 Armin Novak <armin.novak@thincast.com>
7
 * Copyright 2022 Thincast Technologies GmbH
8
 *
9
 * Licensed under the Apache License, Version 2.0 (the "License");
10
 * you may not use this file except in compliance with the License.
11
 * You may obtain a copy of the License at
12
 *
13
 *     http://www.apache.org/licenses/LICENSE-2.0
14
 *
15
 * Unless required by applicable law or agreed to in writing, software
16
 * distributed under the License is distributed on an "AS IS" BASIS,
17
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18
 * See the License for the specific language governing permissions and
19
 * limitations under the License.
20
 */
21
22
#include <errno.h>
23
24
#include <freerdp/utils/string.h>
25
#include <freerdp/settings.h>
26
27
#if defined(CHANNEL_RDPEI)
28
#include <freerdp/channels/rdpei.h>
29
#endif
30
31
const char* rdp_redirection_flags_to_string(UINT32 flags, char* buffer, size_t size)
32
649
{
33
649
  struct map_t
34
649
  {
35
649
    UINT32 flag;
36
649
    const char* name;
37
649
  };
38
649
  const struct map_t map[] = {
39
649
    { LB_TARGET_NET_ADDRESS, "LB_TARGET_NET_ADDRESS" },
40
649
    { LB_LOAD_BALANCE_INFO, "LB_LOAD_BALANCE_INFO" },
41
649
    { LB_USERNAME, "LB_USERNAME" },
42
649
    { LB_DOMAIN, "LB_DOMAIN" },
43
649
    { LB_PASSWORD, "LB_PASSWORD" },
44
649
    { LB_DONTSTOREUSERNAME, "LB_DONTSTOREUSERNAME" },
45
649
    { LB_SMARTCARD_LOGON, "LB_SMARTCARD_LOGON" },
46
649
    { LB_NOREDIRECT, "LB_NOREDIRECT" },
47
649
    { LB_TARGET_FQDN, "LB_TARGET_FQDN" },
48
649
    { LB_TARGET_NETBIOS_NAME, "LB_TARGET_NETBIOS_NAME" },
49
649
    { LB_TARGET_NET_ADDRESSES, "LB_TARGET_NET_ADDRESSES" },
50
649
    { LB_CLIENT_TSV_URL, "LB_CLIENT_TSV_URL" },
51
649
    { LB_SERVER_TSV_CAPABLE, "LB_SERVER_TSV_CAPABLE" },
52
649
    { LB_PASSWORD_IS_PK_ENCRYPTED, "LB_PASSWORD_IS_PK_ENCRYPTED" },
53
649
    { LB_REDIRECTION_GUID, "LB_REDIRECTION_GUID" },
54
649
    { LB_TARGET_CERTIFICATE, "LB_TARGET_CERTIFICATE" },
55
649
  };
56
57
11.0k
  for (size_t x = 0; x < ARRAYSIZE(map); x++)
58
10.3k
  {
59
10.3k
    const struct map_t* cur = &map[x];
60
10.3k
    if (flags & cur->flag)
61
1.65k
    {
62
1.65k
      if (!winpr_str_append(cur->name, buffer, size, "|"))
63
12
        return NULL;
64
1.65k
    }
65
10.3k
  }
66
637
  return buffer;
67
649
}
68
69
const char* rdp_cluster_info_flags_to_string(UINT32 flags, char* buffer, size_t size)
70
0
{
71
0
  const UINT32 version = (flags & ServerSessionRedirectionVersionMask) >> 2;
72
0
  if (flags & REDIRECTION_SUPPORTED)
73
0
    winpr_str_append("REDIRECTION_SUPPORTED", buffer, size, "|");
74
0
  if (flags & REDIRECTED_SESSIONID_FIELD_VALID)
75
0
    winpr_str_append("REDIRECTED_SESSIONID_FIELD_VALID", buffer, size, "|");
76
0
  if (flags & REDIRECTED_SMARTCARD)
77
0
    winpr_str_append("REDIRECTED_SMARTCARD", buffer, size, "|");
78
79
0
  const char* str = NULL;
80
0
  switch (version)
81
0
  {
82
0
    case REDIRECTION_VERSION1:
83
0
      str = "REDIRECTION_VERSION1";
84
0
      break;
85
0
    case REDIRECTION_VERSION2:
86
0
      str = "REDIRECTION_VERSION2";
87
0
      break;
88
0
    case REDIRECTION_VERSION3:
89
0
      str = "REDIRECTION_VERSION3";
90
0
      break;
91
0
    case REDIRECTION_VERSION4:
92
0
      str = "REDIRECTION_VERSION4";
93
0
      break;
94
0
    case REDIRECTION_VERSION5:
95
0
      str = "REDIRECTION_VERSION5";
96
0
      break;
97
0
    case REDIRECTION_VERSION6:
98
0
      str = "REDIRECTION_VERSION6";
99
0
      break;
100
0
    default:
101
0
      str = "REDIRECTION_VERSION_UNKNOWN";
102
0
      break;
103
0
  }
104
0
  winpr_str_append(str, buffer, size, "|");
105
0
  {
106
0
    char msg[32] = WINPR_C_ARRAY_INIT;
107
0
    (void)_snprintf(msg, sizeof(msg), "[0x%08" PRIx32 "]", flags);
108
0
    winpr_str_append(msg, buffer, size, "");
109
0
  }
110
0
  return buffer;
111
0
}
112
113
BOOL freerdp_extract_key_value(const char* str, UINT32* pkey, UINT32* pvalue)
114
0
{
115
0
  if (!str || !pkey || !pvalue)
116
0
    return FALSE;
117
118
0
  char* end1 = NULL;
119
0
  errno = 0;
120
0
  unsigned long key = strtoul(str, &end1, 0);
121
0
  if ((errno != 0) || !end1 || (*end1 != '=') || (key > UINT32_MAX))
122
0
    return FALSE;
123
124
0
  errno = 0;
125
0
  unsigned long val = strtoul(&end1[1], NULL, 0);
126
0
  if ((errno != 0) || (val > UINT32_MAX))
127
0
    return FALSE;
128
129
0
  *pkey = (UINT32)key;
130
0
  *pvalue = (UINT32)val;
131
0
  return TRUE;
132
0
}
133
134
const char* freerdp_desktop_rotation_flags_to_string(UINT32 flags)
135
0
{
136
0
#define ENTRY(x) \
137
0
  case x:      \
138
0
    return #x
139
140
0
  switch (flags)
141
0
  {
142
0
    ENTRY(ORIENTATION_LANDSCAPE);
143
0
    ENTRY(ORIENTATION_PORTRAIT);
144
0
    ENTRY(ORIENTATION_LANDSCAPE_FLIPPED);
145
0
    ENTRY(ORIENTATION_PORTRAIT_FLIPPED);
146
0
    default:
147
0
      return "ORIENTATION_UNKNOWN";
148
0
  }
149
0
#undef ENTRY
150
0
}
151
152
const char* freerdp_input_touch_state_string(DWORD flags)
153
0
{
154
0
#if defined(CHANNEL_RDPEI)
155
0
  if (flags & RDPINPUT_CONTACT_FLAG_DOWN)
156
0
    return "RDPINPUT_CONTACT_FLAG_DOWN";
157
0
  else if (flags & RDPINPUT_CONTACT_FLAG_UPDATE)
158
0
    return "RDPINPUT_CONTACT_FLAG_UPDATE";
159
0
  else if (flags & RDPINPUT_CONTACT_FLAG_UP)
160
0
    return "RDPINPUT_CONTACT_FLAG_UP";
161
0
  else if (flags & RDPINPUT_CONTACT_FLAG_INRANGE)
162
0
    return "RDPINPUT_CONTACT_FLAG_INRANGE";
163
0
  else if (flags & RDPINPUT_CONTACT_FLAG_INCONTACT)
164
0
    return "RDPINPUT_CONTACT_FLAG_INCONTACT";
165
0
  else if (flags & RDPINPUT_CONTACT_FLAG_CANCELED)
166
0
    return "RDPINPUT_CONTACT_FLAG_CANCELED";
167
0
  else
168
0
    return "RDPINPUT_CONTACT_FLAG_UNKNOWN";
169
#else
170
  return "CHANNEL_RDPEI not supported";
171
#endif
172
0
}
173
174
const char* freerdp_order_support_flags_string(UINT8 type)
175
0
{
176
0
#define ENTRY(x) \
177
0
  case x:      \
178
0
    return #x
179
180
0
  switch (type)
181
0
  {
182
0
    ENTRY(NEG_DSTBLT_INDEX);
183
0
    ENTRY(NEG_PATBLT_INDEX);
184
0
    ENTRY(NEG_SCRBLT_INDEX);
185
0
    ENTRY(NEG_MEMBLT_INDEX);
186
0
    ENTRY(NEG_MEM3BLT_INDEX);
187
0
    ENTRY(NEG_ATEXTOUT_INDEX);
188
0
    ENTRY(NEG_AEXTTEXTOUT_INDEX);
189
0
    ENTRY(NEG_DRAWNINEGRID_INDEX);
190
0
    ENTRY(NEG_LINETO_INDEX);
191
0
    ENTRY(NEG_MULTI_DRAWNINEGRID_INDEX);
192
0
    ENTRY(NEG_OPAQUE_RECT_INDEX);
193
0
    ENTRY(NEG_SAVEBITMAP_INDEX);
194
0
    ENTRY(NEG_WTEXTOUT_INDEX);
195
0
    ENTRY(NEG_MEMBLT_V2_INDEX);
196
0
    ENTRY(NEG_MEM3BLT_V2_INDEX);
197
0
    ENTRY(NEG_MULTIDSTBLT_INDEX);
198
0
    ENTRY(NEG_MULTIPATBLT_INDEX);
199
0
    ENTRY(NEG_MULTISCRBLT_INDEX);
200
0
    ENTRY(NEG_MULTIOPAQUERECT_INDEX);
201
0
    ENTRY(NEG_FAST_INDEX_INDEX);
202
0
    ENTRY(NEG_POLYGON_SC_INDEX);
203
0
    ENTRY(NEG_POLYGON_CB_INDEX);
204
0
    ENTRY(NEG_POLYLINE_INDEX);
205
0
    ENTRY(NEG_UNUSED23_INDEX);
206
0
    ENTRY(NEG_FAST_GLYPH_INDEX);
207
0
    ENTRY(NEG_ELLIPSE_SC_INDEX);
208
0
    ENTRY(NEG_ELLIPSE_CB_INDEX);
209
0
    ENTRY(NEG_GLYPH_INDEX_INDEX);
210
0
    ENTRY(NEG_GLYPH_WEXTTEXTOUT_INDEX);
211
0
    ENTRY(NEG_GLYPH_WLONGTEXTOUT_INDEX);
212
0
    ENTRY(NEG_GLYPH_WLONGEXTTEXTOUT_INDEX);
213
0
    ENTRY(NEG_UNUSED31_INDEX);
214
0
    default:
215
0
      return "UNKNOWN";
216
0
  }
217
0
#undef ENTRY
218
0
}