]> git.ipfire.org Git - thirdparty/cups.git/blob - cups/usersys.c
Update ipp documentation to reflect the behavior of configuring WiFi on IPP USB printers.
[thirdparty/cups.git] / cups / usersys.c
1 /*
2 * User, system, and password routines for CUPS.
3 *
4 * Copyright 2007-2019 by Apple Inc.
5 * Copyright 1997-2006 by Easy Software Products.
6 *
7 * Licensed under Apache License v2.0. See the file "LICENSE" for more
8 * information.
9 */
10
11 /*
12 * Include necessary headers...
13 */
14
15 #include "cups-private.h"
16 #include "debug-internal.h"
17 #include <stdlib.h>
18 #include <sys/stat.h>
19 #ifdef _WIN32
20 # include <windows.h>
21 #else
22 # include <pwd.h>
23 # include <termios.h>
24 # include <sys/utsname.h>
25 #endif /* _WIN32 */
26 #ifdef __APPLE__
27 # include <sys/sysctl.h>
28 #endif /* __APPLE__ */
29
30
31 /*
32 * Local constants...
33 */
34
35 #ifdef __APPLE__
36 # if TARGET_OS_OSX
37 # define kCUPSPrintingPrefs CFSTR("org.cups.PrintingPrefs")
38 # define kPREFIX ""
39 # else
40 # define kCUPSPrintingPrefs CFSTR(".GlobalPreferences")
41 # define kPREFIX "AirPrint"
42 # endif /* TARGET_OS_OSX */
43 # define kDigestOptionsKey CFSTR(kPREFIX "DigestOptions")
44 # define kUserKey CFSTR(kPREFIX "User")
45 # define kUserAgentTokensKey CFSTR(kPREFIX "UserAgentTokens")
46 # define kAllowAnyRootKey CFSTR(kPREFIX "AllowAnyRoot")
47 # define kAllowExpiredCertsKey CFSTR(kPREFIX "AllowExpiredCerts")
48 # define kEncryptionKey CFSTR(kPREFIX "Encryption")
49 # define kGSSServiceNameKey CFSTR(kPREFIX "GSSServiceName")
50 # define kSSLOptionsKey CFSTR(kPREFIX "SSLOptions")
51 # define kTrustOnFirstUseKey CFSTR(kPREFIX "TrustOnFirstUse")
52 # define kValidateCertsKey CFSTR(kPREFIX "ValidateCerts")
53 /* Deprecated */
54 # define kAllowRC4 CFSTR(kPREFIX "AllowRC4")
55 # define kAllowSSL3 CFSTR(kPREFIX "AllowSSL3")
56 # define kAllowDH CFSTR(kPREFIX "AllowDH")
57 #endif /* __APPLE__ */
58
59 #define _CUPS_PASSCHAR '*' /* Character that is echoed for password */
60
61
62 /*
63 * Local types...
64 */
65
66 typedef struct _cups_client_conf_s /**** client.conf config data ****/
67 {
68 _cups_digestoptions_t digestoptions; /* DigestOptions values */
69 _cups_uatokens_t uatokens; /* UserAgentTokens values */
70 #ifdef HAVE_SSL
71 int ssl_options, /* SSLOptions values */
72 ssl_min_version,/* Minimum SSL/TLS version */
73 ssl_max_version;/* Maximum SSL/TLS version */
74 #endif /* HAVE_SSL */
75 int trust_first, /* Trust on first use? */
76 any_root, /* Allow any (e.g., self-signed) root */
77 expired_certs, /* Allow expired certs */
78 validate_certs; /* Validate certificates */
79 http_encryption_t encryption; /* Encryption setting */
80 char user[65], /* User name */
81 server_name[256];
82 /* Server hostname */
83 #ifdef HAVE_GSSAPI
84 char gss_service_name[32];
85 /* Kerberos service name */
86 #endif /* HAVE_GSSAPI */
87 } _cups_client_conf_t;
88
89
90 /*
91 * Local functions...
92 */
93
94 #ifdef __APPLE__
95 static int cups_apple_get_boolean(CFStringRef key, int *value);
96 static int cups_apple_get_string(CFStringRef key, char *value, size_t valsize);
97 #endif /* __APPLE__ */
98 static int cups_boolean_value(const char *value);
99 static void cups_finalize_client_conf(_cups_client_conf_t *cc);
100 static void cups_init_client_conf(_cups_client_conf_t *cc);
101 static void cups_read_client_conf(cups_file_t *fp, _cups_client_conf_t *cc);
102 static void cups_set_default_ipp_port(_cups_globals_t *cg);
103 static void cups_set_digestoptions(_cups_client_conf_t *cc, const char *value);
104 static void cups_set_encryption(_cups_client_conf_t *cc, const char *value);
105 #ifdef HAVE_GSSAPI
106 static void cups_set_gss_service_name(_cups_client_conf_t *cc, const char *value);
107 #endif /* HAVE_GSSAPI */
108 static void cups_set_server_name(_cups_client_conf_t *cc, const char *value);
109 #ifdef HAVE_SSL
110 static void cups_set_ssl_options(_cups_client_conf_t *cc, const char *value);
111 #endif /* HAVE_SSL */
112 static void cups_set_uatokens(_cups_client_conf_t *cc, const char *value);
113 static void cups_set_user(_cups_client_conf_t *cc, const char *value);
114
115
116 /*
117 * 'cupsEncryption()' - Get the current encryption settings.
118 *
119 * The default encryption setting comes from the CUPS_ENCRYPTION
120 * environment variable, then the ~/.cups/client.conf file, and finally the
121 * /etc/cups/client.conf file. If not set, the default is
122 * @code HTTP_ENCRYPTION_IF_REQUESTED@.
123 *
124 * Note: The current encryption setting is tracked separately for each thread
125 * in a program. Multi-threaded programs that override the setting via the
126 * @link cupsSetEncryption@ function need to do so in each thread for the same
127 * setting to be used.
128 */
129
130 http_encryption_t /* O - Encryption settings */
131 cupsEncryption(void)
132 {
133 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
134
135
136 if (cg->encryption == (http_encryption_t)-1)
137 _cupsSetDefaults();
138
139 return (cg->encryption);
140 }
141
142
143 /*
144 * 'cupsGetPassword()' - Get a password from the user.
145 *
146 * Uses the current password callback function. Returns @code NULL@ if the
147 * user does not provide a password.
148 *
149 * Note: The current password callback function is tracked separately for each
150 * thread in a program. Multi-threaded programs that override the setting via
151 * the @link cupsSetPasswordCB@ or @link cupsSetPasswordCB2@ functions need to
152 * do so in each thread for the same function to be used.
153 *
154 * @exclude all@
155 */
156
157 const char * /* O - Password */
158 cupsGetPassword(const char *prompt) /* I - Prompt string */
159 {
160 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
161
162
163 return ((cg->password_cb)(prompt, NULL, NULL, NULL, cg->password_data));
164 }
165
166
167 /*
168 * 'cupsGetPassword2()' - Get a password from the user using the current
169 * password callback.
170 *
171 * Uses the current password callback function. Returns @code NULL@ if the
172 * user does not provide a password.
173 *
174 * Note: The current password callback function is tracked separately for each
175 * thread in a program. Multi-threaded programs that override the setting via
176 * the @link cupsSetPasswordCB2@ function need to do so in each thread for the
177 * same function to be used.
178 *
179 * @since CUPS 1.4/macOS 10.6@
180 */
181
182 const char * /* O - Password */
183 cupsGetPassword2(const char *prompt, /* I - Prompt string */
184 http_t *http, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
185 const char *method, /* I - Request method ("GET", "POST", "PUT") */
186 const char *resource) /* I - Resource path */
187 {
188 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
189
190
191 if (!http)
192 http = _cupsConnect();
193
194 return ((cg->password_cb)(prompt, http, method, resource, cg->password_data));
195 }
196
197
198 /*
199 * 'cupsServer()' - Return the hostname/address of the current server.
200 *
201 * The default server comes from the CUPS_SERVER environment variable, then the
202 * ~/.cups/client.conf file, and finally the /etc/cups/client.conf file. If not
203 * set, the default is the local system - either "localhost" or a domain socket
204 * path.
205 *
206 * The returned value can be a fully-qualified hostname, a numeric IPv4 or IPv6
207 * address, or a domain socket pathname.
208 *
209 * Note: The current server is tracked separately for each thread in a program.
210 * Multi-threaded programs that override the server via the
211 * @link cupsSetServer@ function need to do so in each thread for the same
212 * server to be used.
213 */
214
215 const char * /* O - Server name */
216 cupsServer(void)
217 {
218 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
219
220
221 if (!cg->server[0])
222 _cupsSetDefaults();
223
224 return (cg->server);
225 }
226
227
228 /*
229 * 'cupsSetClientCertCB()' - Set the client certificate callback.
230 *
231 * Pass @code NULL@ to restore the default callback.
232 *
233 * Note: The current certificate callback is tracked separately for each thread
234 * in a program. Multi-threaded programs that override the callback need to do
235 * so in each thread for the same callback to be used.
236 *
237 * @since CUPS 1.5/macOS 10.7@
238 */
239
240 void
241 cupsSetClientCertCB(
242 cups_client_cert_cb_t cb, /* I - Callback function */
243 void *user_data) /* I - User data pointer */
244 {
245 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
246
247
248 cg->client_cert_cb = cb;
249 cg->client_cert_data = user_data;
250 }
251
252
253 /*
254 * 'cupsSetCredentials()' - Set the default credentials to be used for SSL/TLS
255 * connections.
256 *
257 * Note: The default credentials are tracked separately for each thread in a
258 * program. Multi-threaded programs that override the setting need to do so in
259 * each thread for the same setting to be used.
260 *
261 * @since CUPS 1.5/macOS 10.7@
262 */
263
264 int /* O - Status of call (0 = success) */
265 cupsSetCredentials(
266 cups_array_t *credentials) /* I - Array of credentials */
267 {
268 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
269
270
271 if (cupsArrayCount(credentials) < 1)
272 return (-1);
273
274 #ifdef HAVE_SSL
275 _httpFreeCredentials(cg->tls_credentials);
276 cg->tls_credentials = _httpCreateCredentials(credentials);
277 #endif /* HAVE_SSL */
278
279 return (cg->tls_credentials ? 0 : -1);
280 }
281
282
283 /*
284 * 'cupsSetEncryption()' - Set the encryption preference.
285 *
286 * The default encryption setting comes from the CUPS_ENCRYPTION
287 * environment variable, then the ~/.cups/client.conf file, and finally the
288 * /etc/cups/client.conf file. If not set, the default is
289 * @code HTTP_ENCRYPTION_IF_REQUESTED@.
290 *
291 * Note: The current encryption setting is tracked separately for each thread
292 * in a program. Multi-threaded programs that override the setting need to do
293 * so in each thread for the same setting to be used.
294 */
295
296 void
297 cupsSetEncryption(http_encryption_t e) /* I - New encryption preference */
298 {
299 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
300
301
302 cg->encryption = e;
303
304 if (cg->http)
305 httpEncryption(cg->http, e);
306 }
307
308
309 /*
310 * 'cupsSetPasswordCB()' - Set the password callback for CUPS.
311 *
312 * Pass @code NULL@ to restore the default (console) password callback, which
313 * reads the password from the console. Programs should call either this
314 * function or @link cupsSetPasswordCB2@, as only one callback can be registered
315 * by a program per thread.
316 *
317 * Note: The current password callback is tracked separately for each thread
318 * in a program. Multi-threaded programs that override the callback need to do
319 * so in each thread for the same callback to be used.
320 *
321 * @exclude all@
322 */
323
324 void
325 cupsSetPasswordCB(cups_password_cb_t cb)/* I - Callback function */
326 {
327 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
328
329
330 if (cb == (cups_password_cb_t)0)
331 cg->password_cb = (cups_password_cb2_t)_cupsGetPassword;
332 else
333 cg->password_cb = (cups_password_cb2_t)cb;
334
335 cg->password_data = NULL;
336 }
337
338
339 /*
340 * 'cupsSetPasswordCB2()' - Set the advanced password callback for CUPS.
341 *
342 * Pass @code NULL@ to restore the default (console) password callback, which
343 * reads the password from the console. Programs should call either this
344 * function or @link cupsSetPasswordCB2@, as only one callback can be registered
345 * by a program per thread.
346 *
347 * Note: The current password callback is tracked separately for each thread
348 * in a program. Multi-threaded programs that override the callback need to do
349 * so in each thread for the same callback to be used.
350 *
351 * @since CUPS 1.4/macOS 10.6@
352 */
353
354 void
355 cupsSetPasswordCB2(
356 cups_password_cb2_t cb, /* I - Callback function */
357 void *user_data) /* I - User data pointer */
358 {
359 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
360
361
362 if (cb == (cups_password_cb2_t)0)
363 cg->password_cb = (cups_password_cb2_t)_cupsGetPassword;
364 else
365 cg->password_cb = cb;
366
367 cg->password_data = user_data;
368 }
369
370
371 /*
372 * 'cupsSetServer()' - Set the default server name and port.
373 *
374 * The "server" string can be a fully-qualified hostname, a numeric
375 * IPv4 or IPv6 address, or a domain socket pathname. Hostnames and numeric IP
376 * addresses can be optionally followed by a colon and port number to override
377 * the default port 631, e.g. "hostname:8631". Pass @code NULL@ to restore the
378 * default server name and port.
379 *
380 * Note: The current server is tracked separately for each thread in a program.
381 * Multi-threaded programs that override the server need to do so in each
382 * thread for the same server to be used.
383 */
384
385 void
386 cupsSetServer(const char *server) /* I - Server name */
387 {
388 char *options, /* Options */
389 *port; /* Pointer to port */
390 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
391
392
393 if (server)
394 {
395 strlcpy(cg->server, server, sizeof(cg->server));
396
397 if (cg->server[0] != '/' && (options = strrchr(cg->server, '/')) != NULL)
398 {
399 *options++ = '\0';
400
401 if (!strcmp(options, "version=1.0"))
402 cg->server_version = 10;
403 else if (!strcmp(options, "version=1.1"))
404 cg->server_version = 11;
405 else if (!strcmp(options, "version=2.0"))
406 cg->server_version = 20;
407 else if (!strcmp(options, "version=2.1"))
408 cg->server_version = 21;
409 else if (!strcmp(options, "version=2.2"))
410 cg->server_version = 22;
411 }
412 else
413 cg->server_version = 20;
414
415 if (cg->server[0] != '/' && (port = strrchr(cg->server, ':')) != NULL &&
416 !strchr(port, ']') && isdigit(port[1] & 255))
417 {
418 *port++ = '\0';
419
420 cg->ipp_port = atoi(port);
421 }
422
423 if (!cg->ipp_port)
424 cups_set_default_ipp_port(cg);
425
426 if (cg->server[0] == '/')
427 strlcpy(cg->servername, "localhost", sizeof(cg->servername));
428 else
429 strlcpy(cg->servername, cg->server, sizeof(cg->servername));
430 }
431 else
432 {
433 cg->server[0] = '\0';
434 cg->servername[0] = '\0';
435 cg->server_version = 20;
436 cg->ipp_port = 0;
437 }
438
439 if (cg->http)
440 {
441 httpClose(cg->http);
442 cg->http = NULL;
443 }
444 }
445
446
447 /*
448 * 'cupsSetServerCertCB()' - Set the server certificate callback.
449 *
450 * Pass @code NULL@ to restore the default callback.
451 *
452 * Note: The current credentials callback is tracked separately for each thread
453 * in a program. Multi-threaded programs that override the callback need to do
454 * so in each thread for the same callback to be used.
455 *
456 * @since CUPS 1.5/macOS 10.7@
457 */
458
459 void
460 cupsSetServerCertCB(
461 cups_server_cert_cb_t cb, /* I - Callback function */
462 void *user_data) /* I - User data pointer */
463 {
464 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
465
466
467 cg->server_cert_cb = cb;
468 cg->server_cert_data = user_data;
469 }
470
471
472 /*
473 * 'cupsSetUser()' - Set the default user name.
474 *
475 * Pass @code NULL@ to restore the default user name.
476 *
477 * Note: The current user name is tracked separately for each thread in a
478 * program. Multi-threaded programs that override the user name need to do so
479 * in each thread for the same user name to be used.
480 */
481
482 void
483 cupsSetUser(const char *user) /* I - User name */
484 {
485 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
486
487
488 if (user)
489 strlcpy(cg->user, user, sizeof(cg->user));
490 else
491 cg->user[0] = '\0';
492 }
493
494
495 /*
496 * 'cupsSetUserAgent()' - Set the default HTTP User-Agent string.
497 *
498 * Setting the string to NULL forces the default value containing the CUPS
499 * version, IPP version, and operating system version and architecture.
500 *
501 * @since CUPS 1.7/macOS 10.9@
502 */
503
504 void
505 cupsSetUserAgent(const char *user_agent)/* I - User-Agent string or @code NULL@ */
506 {
507 _cups_globals_t *cg = _cupsGlobals();
508 /* Thread globals */
509 #ifdef _WIN32
510 SYSTEM_INFO sysinfo; /* System information */
511 OSVERSIONINFOA version; /* OS version info */
512 const char *machine; /* Hardware/machine name */
513 #elif defined(__APPLE__)
514 struct utsname name; /* uname info */
515 char version[256]; /* macOS/iOS version */
516 size_t len; /* Length of value */
517 #else
518 struct utsname name; /* uname info */
519 #endif /* _WIN32 */
520
521
522 if (user_agent)
523 {
524 strlcpy(cg->user_agent, user_agent, sizeof(cg->user_agent));
525 return;
526 }
527
528 if (cg->uatokens < _CUPS_UATOKENS_OS)
529 {
530 switch (cg->uatokens)
531 {
532 default :
533 case _CUPS_UATOKENS_NONE :
534 cg->user_agent[0] = '\0';
535 break;
536 case _CUPS_UATOKENS_PRODUCT_ONLY :
537 strlcpy(cg->user_agent, "CUPS IPP", sizeof(cg->user_agent));
538 break;
539 case _CUPS_UATOKENS_MAJOR :
540 snprintf(cg->user_agent, sizeof(cg->user_agent), "CUPS/%d IPP/2", CUPS_VERSION_MAJOR);
541 break;
542 case _CUPS_UATOKENS_MINOR :
543 snprintf(cg->user_agent, sizeof(cg->user_agent), "CUPS/%d.%d IPP/2.1", CUPS_VERSION_MAJOR, CUPS_VERSION_MINOR);
544 break;
545 case _CUPS_UATOKENS_MINIMAL :
546 strlcpy(cg->user_agent, CUPS_MINIMAL " IPP/2.1", sizeof(cg->user_agent));
547 break;
548 }
549 }
550
551 #ifdef _WIN32
552 /*
553 * Gather Windows version information for the User-Agent string...
554 */
555
556 version.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
557 GetVersionExA(&version);
558 GetNativeSystemInfo(&sysinfo);
559
560 switch (sysinfo.wProcessorArchitecture)
561 {
562 case PROCESSOR_ARCHITECTURE_AMD64 :
563 machine = "amd64";
564 break;
565
566 case PROCESSOR_ARCHITECTURE_ARM :
567 machine = "arm";
568 break;
569
570 case PROCESSOR_ARCHITECTURE_IA64 :
571 machine = "ia64";
572 break;
573
574 case PROCESSOR_ARCHITECTURE_INTEL :
575 machine = "intel";
576 break;
577
578 default :
579 machine = "unknown";
580 break;
581 }
582
583 if (cg->uatokens == _CUPS_UATOKENS_OS)
584 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (Windows %d.%d) IPP/2.0", version.dwMajorVersion, version.dwMinorVersion);
585 else
586 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (Windows %d.%d; %s) IPP/2.0", version.dwMajorVersion, version.dwMinorVersion, machine);
587
588 #elif defined(__APPLE__)
589 /*
590 * Gather macOS/iOS version information for the User-Agent string...
591 */
592
593 uname(&name);
594
595 len = sizeof(version) - 1;
596 if (!sysctlbyname("kern.osproductversion", version, &len, NULL, 0))
597 version[len] = '\0';
598 else
599 strlcpy(version, "unknown", sizeof(version));
600
601 # if TARGET_OS_OSX
602 if (cg->uatokens == _CUPS_UATOKENS_OS)
603 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (macOS %s) IPP/2.0", version);
604 else
605 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (macOS %s; %s) IPP/2.0", version, name.machine);
606
607 # else
608 if (cg->uatokens == _CUPS_UATOKENS_OS)
609 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (iOS %s) IPP/2.0", version);
610 else
611 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (iOS %s; %s) IPP/2.0", version, name.machine);
612 # endif /* TARGET_OS_OSX */
613
614 #else
615 /*
616 * Gather generic UNIX version information for the User-Agent string...
617 */
618
619 uname(&name);
620
621 if (cg->uatokens == _CUPS_UATOKENS_OS)
622 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (%s %s) IPP/2.0", name.sysname, name.release);
623 else
624 snprintf(cg->user_agent, sizeof(cg->user_agent), CUPS_MINIMAL " (%s %s; %s) IPP/2.0", name.sysname, name.release, name.machine);
625 #endif /* _WIN32 */
626 }
627
628
629 /*
630 * 'cupsUser()' - Return the current user's name.
631 *
632 * Note: The current user name is tracked separately for each thread in a
633 * program. Multi-threaded programs that override the user name with the
634 * @link cupsSetUser@ function need to do so in each thread for the same user
635 * name to be used.
636 */
637
638 const char * /* O - User name */
639 cupsUser(void)
640 {
641 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
642
643
644 if (!cg->user[0])
645 _cupsSetDefaults();
646
647 return (cg->user);
648 }
649
650
651 /*
652 * 'cupsUserAgent()' - Return the default HTTP User-Agent string.
653 *
654 * @since CUPS 1.7/macOS 10.9@
655 */
656
657 const char * /* O - User-Agent string */
658 cupsUserAgent(void)
659 {
660 _cups_globals_t *cg = _cupsGlobals(); /* Thread globals */
661
662
663 if (!cg->user_agent[0])
664 cupsSetUserAgent(NULL);
665
666 return (cg->user_agent);
667 }
668
669
670 /*
671 * '_cupsGetPassword()' - Get a password from the user.
672 */
673
674 const char * /* O - Password or @code NULL@ if none */
675 _cupsGetPassword(const char *prompt) /* I - Prompt string */
676 {
677 #ifdef _WIN32
678 HANDLE tty; /* Console handle */
679 DWORD mode; /* Console mode */
680 char passch, /* Current key press */
681 *passptr, /* Pointer into password string */
682 *passend; /* End of password string */
683 DWORD passbytes; /* Bytes read */
684 _cups_globals_t *cg = _cupsGlobals();
685 /* Thread globals */
686
687
688 /*
689 * Disable input echo and set raw input...
690 */
691
692 if ((tty = GetStdHandle(STD_INPUT_HANDLE)) == INVALID_HANDLE_VALUE)
693 return (NULL);
694
695 if (!GetConsoleMode(tty, &mode))
696 return (NULL);
697
698 if (!SetConsoleMode(tty, 0))
699 return (NULL);
700
701 /*
702 * Display the prompt...
703 */
704
705 printf("%s ", prompt);
706 fflush(stdout);
707
708 /*
709 * Read the password string from /dev/tty until we get interrupted or get a
710 * carriage return or newline...
711 */
712
713 passptr = cg->password;
714 passend = cg->password + sizeof(cg->password) - 1;
715
716 while (ReadFile(tty, &passch, 1, &passbytes, NULL))
717 {
718 if (passch == 0x0A || passch == 0x0D)
719 {
720 /*
721 * Enter/return...
722 */
723
724 break;
725 }
726 else if (passch == 0x08 || passch == 0x7F)
727 {
728 /*
729 * Backspace/delete (erase character)...
730 */
731
732 if (passptr > cg->password)
733 {
734 passptr --;
735 fputs("\010 \010", stdout);
736 }
737 else
738 putchar(0x07);
739 }
740 else if (passch == 0x15)
741 {
742 /*
743 * CTRL+U (erase line)
744 */
745
746 if (passptr > cg->password)
747 {
748 while (passptr > cg->password)
749 {
750 passptr --;
751 fputs("\010 \010", stdout);
752 }
753 }
754 else
755 putchar(0x07);
756 }
757 else if (passch == 0x03)
758 {
759 /*
760 * CTRL+C...
761 */
762
763 passptr = cg->password;
764 break;
765 }
766 else if ((passch & 255) < 0x20 || passptr >= passend)
767 putchar(0x07);
768 else
769 {
770 *passptr++ = passch;
771 putchar(_CUPS_PASSCHAR);
772 }
773
774 fflush(stdout);
775 }
776
777 putchar('\n');
778 fflush(stdout);
779
780 /*
781 * Cleanup...
782 */
783
784 SetConsoleMode(tty, mode);
785
786 /*
787 * Return the proper value...
788 */
789
790 if (passbytes == 1 && passptr > cg->password)
791 {
792 *passptr = '\0';
793 return (cg->password);
794 }
795 else
796 {
797 memset(cg->password, 0, sizeof(cg->password));
798 return (NULL);
799 }
800
801 #else
802 int tty; /* /dev/tty - never read from stdin */
803 struct termios original, /* Original input mode */
804 noecho; /* No echo input mode */
805 char passch, /* Current key press */
806 *passptr, /* Pointer into password string */
807 *passend; /* End of password string */
808 ssize_t passbytes; /* Bytes read */
809 _cups_globals_t *cg = _cupsGlobals();
810 /* Thread globals */
811
812
813 /*
814 * Disable input echo and set raw input...
815 */
816
817 if ((tty = open("/dev/tty", O_RDONLY)) < 0)
818 return (NULL);
819
820 if (tcgetattr(tty, &original))
821 {
822 close(tty);
823 return (NULL);
824 }
825
826 noecho = original;
827 noecho.c_lflag &= (tcflag_t)~(ICANON | ECHO | ECHOE | ISIG);
828 noecho.c_cc[VMIN] = 1;
829 noecho.c_cc[VTIME] = 0;
830
831 if (tcsetattr(tty, TCSAFLUSH, &noecho))
832 {
833 close(tty);
834 return (NULL);
835 }
836
837 /*
838 * Display the prompt...
839 */
840
841 printf("%s ", prompt);
842 fflush(stdout);
843
844 /*
845 * Read the password string from /dev/tty until we get interrupted or get a
846 * carriage return or newline...
847 */
848
849 passptr = cg->password;
850 passend = cg->password + sizeof(cg->password) - 1;
851
852 while ((passbytes = read(tty, &passch, 1)) == 1)
853 {
854 if (passch == noecho.c_cc[VEOL] ||
855 # ifdef VEOL2
856 passch == noecho.c_cc[VEOL2] ||
857 # endif /* VEOL2 */
858 passch == 0x0A || passch == 0x0D)
859 {
860 /*
861 * Enter/return...
862 */
863
864 break;
865 }
866 else if (passch == noecho.c_cc[VERASE] ||
867 passch == 0x08 || passch == 0x7F)
868 {
869 /*
870 * Backspace/delete (erase character)...
871 */
872
873 if (passptr > cg->password)
874 {
875 passptr --;
876 fputs("\010 \010", stdout);
877 }
878 else
879 putchar(0x07);
880 }
881 else if (passch == noecho.c_cc[VKILL])
882 {
883 /*
884 * CTRL+U (erase line)
885 */
886
887 if (passptr > cg->password)
888 {
889 while (passptr > cg->password)
890 {
891 passptr --;
892 fputs("\010 \010", stdout);
893 }
894 }
895 else
896 putchar(0x07);
897 }
898 else if (passch == noecho.c_cc[VINTR] || passch == noecho.c_cc[VQUIT] ||
899 passch == noecho.c_cc[VEOF])
900 {
901 /*
902 * CTRL+C, CTRL+D, or CTRL+Z...
903 */
904
905 passptr = cg->password;
906 break;
907 }
908 else if ((passch & 255) < 0x20 || passptr >= passend)
909 putchar(0x07);
910 else
911 {
912 *passptr++ = passch;
913 putchar(_CUPS_PASSCHAR);
914 }
915
916 fflush(stdout);
917 }
918
919 putchar('\n');
920 fflush(stdout);
921
922 /*
923 * Cleanup...
924 */
925
926 tcsetattr(tty, TCSAFLUSH, &original);
927 close(tty);
928
929 /*
930 * Return the proper value...
931 */
932
933 if (passbytes == 1 && passptr > cg->password)
934 {
935 *passptr = '\0';
936 return (cg->password);
937 }
938 else
939 {
940 memset(cg->password, 0, sizeof(cg->password));
941 return (NULL);
942 }
943 #endif /* _WIN32 */
944 }
945
946
947 #ifdef HAVE_GSSAPI
948 /*
949 * '_cupsGSSServiceName()' - Get the GSS (Kerberos) service name.
950 */
951
952 const char *
953 _cupsGSSServiceName(void)
954 {
955 _cups_globals_t *cg = _cupsGlobals(); /* Thread globals */
956
957
958 if (!cg->gss_service_name[0])
959 _cupsSetDefaults();
960
961 return (cg->gss_service_name);
962 }
963 #endif /* HAVE_GSSAPI */
964
965
966 /*
967 * '_cupsSetDefaults()' - Set the default server, port, and encryption.
968 */
969
970 void
971 _cupsSetDefaults(void)
972 {
973 cups_file_t *fp; /* File */
974 char filename[1024]; /* Filename */
975 _cups_client_conf_t cc; /* client.conf values */
976 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
977
978
979 DEBUG_puts("_cupsSetDefaults()");
980
981 /*
982 * Load initial client.conf values...
983 */
984
985 cups_init_client_conf(&cc);
986
987 /*
988 * Read the /etc/cups/client.conf and ~/.cups/client.conf files, if
989 * present.
990 */
991
992 snprintf(filename, sizeof(filename), "%s/client.conf", cg->cups_serverroot);
993 if ((fp = cupsFileOpen(filename, "r")) != NULL)
994 {
995 cups_read_client_conf(fp, &cc);
996 cupsFileClose(fp);
997 }
998
999 if (cg->home)
1000 {
1001 /*
1002 * Look for ~/.cups/client.conf...
1003 */
1004
1005 snprintf(filename, sizeof(filename), "%s/.cups/client.conf", cg->home);
1006 if ((fp = cupsFileOpen(filename, "r")) != NULL)
1007 {
1008 cups_read_client_conf(fp, &cc);
1009 cupsFileClose(fp);
1010 }
1011 }
1012
1013 /*
1014 * Finalize things so every client.conf value is set...
1015 */
1016
1017 cups_finalize_client_conf(&cc);
1018
1019 cg->uatokens = cc.uatokens;
1020
1021 if (cg->encryption == (http_encryption_t)-1)
1022 cg->encryption = cc.encryption;
1023
1024 if (!cg->server[0] || !cg->ipp_port)
1025 cupsSetServer(cc.server_name);
1026
1027 if (!cg->ipp_port)
1028 cups_set_default_ipp_port(cg);
1029
1030 if (!cg->user[0])
1031 strlcpy(cg->user, cc.user, sizeof(cg->user));
1032
1033 #ifdef HAVE_GSSAPI
1034 if (!cg->gss_service_name[0])
1035 strlcpy(cg->gss_service_name, cc.gss_service_name, sizeof(cg->gss_service_name));
1036 #endif /* HAVE_GSSAPI */
1037
1038 if (cg->trust_first < 0)
1039 cg->trust_first = cc.trust_first;
1040
1041 if (cg->any_root < 0)
1042 cg->any_root = cc.any_root;
1043
1044 if (cg->expired_certs < 0)
1045 cg->expired_certs = cc.expired_certs;
1046
1047 if (cg->validate_certs < 0)
1048 cg->validate_certs = cc.validate_certs;
1049
1050 #ifdef HAVE_SSL
1051 _httpTLSSetOptions(cc.ssl_options | _HTTP_TLS_SET_DEFAULT, cc.ssl_min_version, cc.ssl_max_version);
1052 #endif /* HAVE_SSL */
1053 }
1054
1055
1056 #ifdef __APPLE__
1057 /*
1058 * 'cups_apple_get_boolean()' - Get a boolean setting from the CUPS preferences.
1059 */
1060
1061 static int /* O - 1 if set, 0 otherwise */
1062 cups_apple_get_boolean(
1063 CFStringRef key, /* I - Key (name) */
1064 int *value) /* O - Boolean value */
1065 {
1066 Boolean bval, /* Preference value */
1067 bval_set; /* Value is set? */
1068
1069
1070 bval = CFPreferencesGetAppBooleanValue(key, kCUPSPrintingPrefs, &bval_set);
1071
1072 if (bval_set)
1073 *value = (int)bval;
1074
1075 return ((int)bval_set);
1076 }
1077
1078
1079 /*
1080 * 'cups_apple_get_string()' - Get a string setting from the CUPS preferences.
1081 */
1082
1083 static int /* O - 1 if set, 0 otherwise */
1084 cups_apple_get_string(
1085 CFStringRef key, /* I - Key (name) */
1086 char *value, /* O - String value */
1087 size_t valsize) /* I - Size of value buffer */
1088 {
1089 CFStringRef sval; /* String value */
1090
1091
1092 if ((sval = CFPreferencesCopyAppValue(key, kCUPSPrintingPrefs)) != NULL)
1093 {
1094 Boolean result = CFStringGetCString(sval, value, (CFIndex)valsize, kCFStringEncodingUTF8);
1095
1096 CFRelease(sval);
1097
1098 if (result)
1099 return (1);
1100 }
1101
1102 return (0);
1103 }
1104 #endif /* __APPLE__ */
1105
1106
1107 /*
1108 * 'cups_boolean_value()' - Convert a string to a boolean value.
1109 */
1110
1111 static int /* O - Boolean value */
1112 cups_boolean_value(const char *value) /* I - String value */
1113 {
1114 return (!_cups_strcasecmp(value, "yes") || !_cups_strcasecmp(value, "on") || !_cups_strcasecmp(value, "true"));
1115 }
1116
1117
1118 /*
1119 * 'cups_finalize_client_conf()' - Finalize client.conf values.
1120 */
1121
1122 static void
1123 cups_finalize_client_conf(
1124 _cups_client_conf_t *cc) /* I - client.conf values */
1125 {
1126 const char *value; /* Environment variable */
1127
1128
1129 if ((value = getenv("CUPS_TRUSTFIRST")) != NULL)
1130 cc->trust_first = cups_boolean_value(value);
1131
1132 if ((value = getenv("CUPS_ANYROOT")) != NULL)
1133 cc->any_root = cups_boolean_value(value);
1134
1135 if ((value = getenv("CUPS_ENCRYPTION")) != NULL)
1136 cups_set_encryption(cc, value);
1137
1138 if ((value = getenv("CUPS_EXPIREDCERTS")) != NULL)
1139 cc->expired_certs = cups_boolean_value(value);
1140
1141 #ifdef HAVE_GSSAPI
1142 if ((value = getenv("CUPS_GSSSERVICENAME")) != NULL)
1143 cups_set_gss_service_name(cc, value);
1144 #endif /* HAVE_GSSAPI */
1145
1146 if ((value = getenv("CUPS_SERVER")) != NULL)
1147 cups_set_server_name(cc, value);
1148
1149 if ((value = getenv("CUPS_USER")) != NULL)
1150 cups_set_user(cc, value);
1151
1152 if ((value = getenv("CUPS_VALIDATECERTS")) != NULL)
1153 cc->validate_certs = cups_boolean_value(value);
1154
1155 /*
1156 * Then apply defaults for those values that haven't been set...
1157 */
1158
1159 if (cc->trust_first < 0)
1160 cc->trust_first = 1;
1161
1162 if (cc->any_root < 0)
1163 cc->any_root = 1;
1164
1165 if (cc->encryption == (http_encryption_t)-1)
1166 cc->encryption = HTTP_ENCRYPTION_IF_REQUESTED;
1167
1168 if (cc->expired_certs < 0)
1169 cc->expired_certs = 0;
1170
1171 #ifdef HAVE_GSSAPI
1172 if (!cc->gss_service_name[0])
1173 cups_set_gss_service_name(cc, CUPS_DEFAULT_GSSSERVICENAME);
1174 #endif /* HAVE_GSSAPI */
1175
1176 if (!cc->server_name[0])
1177 {
1178 /*
1179 * If we are compiled with domain socket support, only use the
1180 * domain socket if it exists and has the right permissions...
1181 */
1182
1183 #if defined(__APPLE__) && !TARGET_OS_OSX
1184 cups_set_server_name(cc, "/private/var/run/printd");
1185
1186 #else
1187 # ifdef CUPS_DEFAULT_DOMAINSOCKET
1188 if (!access(CUPS_DEFAULT_DOMAINSOCKET, R_OK))
1189 cups_set_server_name(cc, CUPS_DEFAULT_DOMAINSOCKET);
1190 else
1191 # endif /* CUPS_DEFAULT_DOMAINSOCKET */
1192 cups_set_server_name(cc, "localhost");
1193 #endif /* __APPLE__ && !TARGET_OS_OSX */
1194 }
1195
1196 if (!cc->user[0])
1197 {
1198 #ifdef _WIN32
1199 /*
1200 * Get the current user name from the OS...
1201 */
1202
1203 DWORD size; /* Size of string */
1204
1205 size = sizeof(cc->user);
1206 if (!GetUserNameA(cc->user, &size))
1207 #else
1208 /*
1209 * Try the USER environment variable as the default username...
1210 */
1211
1212 const char *envuser = getenv("USER");
1213 /* Default username */
1214 struct passwd *pw = NULL; /* Account information */
1215
1216 if (envuser)
1217 {
1218 /*
1219 * Validate USER matches the current UID, otherwise don't allow it to
1220 * override things... This makes sure that printing after doing su
1221 * or sudo records the correct username.
1222 */
1223
1224 if ((pw = getpwnam(envuser)) != NULL && pw->pw_uid != getuid())
1225 pw = NULL;
1226 }
1227
1228 if (!pw)
1229 pw = getpwuid(getuid());
1230
1231 if (pw)
1232 strlcpy(cc->user, pw->pw_name, sizeof(cc->user));
1233 else
1234 #endif /* _WIN32 */
1235 {
1236 /*
1237 * Use the default "unknown" user name...
1238 */
1239
1240 strlcpy(cc->user, "unknown", sizeof(cc->user));
1241 }
1242 }
1243
1244 if (cc->validate_certs < 0)
1245 cc->validate_certs = 0;
1246 }
1247
1248
1249 /*
1250 * 'cups_init_client_conf()' - Initialize client.conf values.
1251 */
1252
1253 static void
1254 cups_init_client_conf(
1255 _cups_client_conf_t *cc) /* I - client.conf values */
1256 {
1257 /*
1258 * Clear all values to "not set"...
1259 */
1260
1261 memset(cc, 0, sizeof(_cups_client_conf_t));
1262
1263 cc->uatokens = _CUPS_UATOKENS_MINIMAL;
1264
1265 #if defined(__APPLE__) && !TARGET_OS_OSX
1266 cups_set_user(cc, "mobile");
1267 #endif /* __APPLE__ && !TARGET_OS_OSX */
1268
1269 #ifdef HAVE_SSL
1270 cc->ssl_min_version = _HTTP_TLS_1_0;
1271 cc->ssl_max_version = _HTTP_TLS_MAX;
1272 #endif /* HAVE_SSL */
1273 cc->encryption = (http_encryption_t)-1;
1274 cc->trust_first = -1;
1275 cc->any_root = -1;
1276 cc->expired_certs = -1;
1277 cc->validate_certs = -1;
1278
1279 /*
1280 * Load settings from the org.cups.PrintingPrefs plist (which trump
1281 * everything...)
1282 */
1283
1284 #if defined(__APPLE__)
1285 char sval[1024]; /* String value */
1286 # ifdef HAVE_SSL
1287 int bval; /* Boolean value */
1288
1289 if (cups_apple_get_boolean(kAllowAnyRootKey, &bval))
1290 cc->any_root = bval;
1291
1292 if (cups_apple_get_boolean(kAllowExpiredCertsKey, &bval))
1293 cc->expired_certs = bval;
1294
1295 if (cups_apple_get_string(kEncryptionKey, sval, sizeof(sval)))
1296 cups_set_encryption(cc, sval);
1297
1298 if (cups_apple_get_string(kSSLOptionsKey, sval, sizeof(sval)))
1299 {
1300 cups_set_ssl_options(cc, sval);
1301 }
1302 else
1303 {
1304 sval[0] = '\0';
1305
1306 if (cups_apple_get_boolean(kAllowRC4, &bval) && bval)
1307 strlcat(sval, " AllowRC4", sizeof(sval));
1308 if (cups_apple_get_boolean(kAllowSSL3, &bval) && bval)
1309 strlcat(sval, " AllowSSL3", sizeof(sval));
1310 if (cups_apple_get_boolean(kAllowDH, &bval) && bval)
1311 strlcat(sval, " AllowDH", sizeof(sval));
1312
1313 if (sval[0])
1314 cups_set_ssl_options(cc, sval);
1315 }
1316
1317 if (cups_apple_get_boolean(kTrustOnFirstUseKey, &bval))
1318 cc->trust_first = bval;
1319
1320 if (cups_apple_get_boolean(kValidateCertsKey, &bval))
1321 cc->validate_certs = bval;
1322 # endif /* HAVE_SSL */
1323
1324 if (cups_apple_get_string(kDigestOptionsKey, sval, sizeof(sval)))
1325 cups_set_digestoptions(cc, sval);
1326
1327 if (cups_apple_get_string(kUserKey, sval, sizeof(sval)))
1328 strlcpy(cc->user, sval, sizeof(cc->user));
1329
1330 if (cups_apple_get_string(kUserAgentTokensKey, sval, sizeof(sval)))
1331 cups_set_uatokens(cc, sval);
1332 #endif /* __APPLE__ */
1333 }
1334
1335
1336 /*
1337 * 'cups_read_client_conf()' - Read a client.conf file.
1338 */
1339
1340 static void
1341 cups_read_client_conf(
1342 cups_file_t *fp, /* I - File to read */
1343 _cups_client_conf_t *cc) /* I - client.conf values */
1344 {
1345 int linenum; /* Current line number */
1346 char line[1024], /* Line from file */
1347 *value; /* Pointer into line */
1348
1349
1350 /*
1351 * Read from the file...
1352 */
1353
1354 linenum = 0;
1355 while (cupsFileGetConf(fp, line, sizeof(line), &value, &linenum))
1356 {
1357 if (!_cups_strcasecmp(line, "DigestOptions") && value)
1358 cups_set_digestoptions(cc, value);
1359 else if (!_cups_strcasecmp(line, "Encryption") && value)
1360 cups_set_encryption(cc, value);
1361 #ifndef __APPLE__
1362 /*
1363 * The ServerName directive is not supported on macOS due to app
1364 * sandboxing restrictions, i.e. not all apps request network access.
1365 */
1366 else if (!_cups_strcasecmp(line, "ServerName") && value)
1367 cups_set_server_name(cc, value);
1368 #endif /* !__APPLE__ */
1369 else if (!_cups_strcasecmp(line, "User") && value)
1370 cups_set_user(cc, value);
1371 else if (!_cups_strcasecmp(line, "UserAgentTokens") && value)
1372 cups_set_uatokens(cc, value);
1373 else if (!_cups_strcasecmp(line, "TrustOnFirstUse") && value)
1374 cc->trust_first = cups_boolean_value(value);
1375 else if (!_cups_strcasecmp(line, "AllowAnyRoot") && value)
1376 cc->any_root = cups_boolean_value(value);
1377 else if (!_cups_strcasecmp(line, "AllowExpiredCerts") &&
1378 value)
1379 cc->expired_certs = cups_boolean_value(value);
1380 else if (!_cups_strcasecmp(line, "ValidateCerts") && value)
1381 cc->validate_certs = cups_boolean_value(value);
1382 #ifdef HAVE_GSSAPI
1383 else if (!_cups_strcasecmp(line, "GSSServiceName") && value)
1384 cups_set_gss_service_name(cc, value);
1385 #endif /* HAVE_GSSAPI */
1386 #ifdef HAVE_SSL
1387 else if (!_cups_strcasecmp(line, "SSLOptions") && value)
1388 cups_set_ssl_options(cc, value);
1389 #endif /* HAVE_SSL */
1390 }
1391 }
1392
1393
1394 /*
1395 * 'cups_set_default_ipp_port()' - Set the default IPP port value.
1396 */
1397
1398 static void
1399 cups_set_default_ipp_port(
1400 _cups_globals_t *cg) /* I - Global data */
1401 {
1402 const char *ipp_port; /* IPP_PORT environment variable */
1403
1404
1405 if ((ipp_port = getenv("IPP_PORT")) != NULL)
1406 {
1407 if ((cg->ipp_port = atoi(ipp_port)) <= 0)
1408 cg->ipp_port = CUPS_DEFAULT_IPP_PORT;
1409 }
1410 else
1411 cg->ipp_port = CUPS_DEFAULT_IPP_PORT;
1412 }
1413
1414
1415 /*
1416 * 'cups_set_digestoptions()' - Set the DigestOptions value.
1417 */
1418
1419 static void
1420 cups_set_digestoptions(
1421 _cups_client_conf_t *cc, /* I - client.conf values */
1422 const char *value) /* I - Value */
1423 {
1424 if (!_cups_strcasecmp(value, "DenyMD5"))
1425 cc->digestoptions = _CUPS_DIGESTOPTIONS_DENYMD5;
1426 else if (!_cups_strcasecmp(value, "None"))
1427 cc->digestoptions = _CUPS_DIGESTOPTIONS_NONE;
1428 }
1429
1430
1431 /*
1432 * 'cups_set_encryption()' - Set the Encryption value.
1433 */
1434
1435 static void
1436 cups_set_encryption(
1437 _cups_client_conf_t *cc, /* I - client.conf values */
1438 const char *value) /* I - Value */
1439 {
1440 if (!_cups_strcasecmp(value, "never"))
1441 cc->encryption = HTTP_ENCRYPTION_NEVER;
1442 else if (!_cups_strcasecmp(value, "always"))
1443 cc->encryption = HTTP_ENCRYPTION_ALWAYS;
1444 else if (!_cups_strcasecmp(value, "required"))
1445 cc->encryption = HTTP_ENCRYPTION_REQUIRED;
1446 else
1447 cc->encryption = HTTP_ENCRYPTION_IF_REQUESTED;
1448 }
1449
1450
1451 /*
1452 * 'cups_set_gss_service_name()' - Set the GSSServiceName value.
1453 */
1454
1455 #ifdef HAVE_GSSAPI
1456 static void
1457 cups_set_gss_service_name(
1458 _cups_client_conf_t *cc, /* I - client.conf values */
1459 const char *value) /* I - Value */
1460 {
1461 strlcpy(cc->gss_service_name, value, sizeof(cc->gss_service_name));
1462 }
1463 #endif /* HAVE_GSSAPI */
1464
1465
1466 /*
1467 * 'cups_set_server_name()' - Set the ServerName value.
1468 */
1469
1470 static void
1471 cups_set_server_name(
1472 _cups_client_conf_t *cc, /* I - client.conf values */
1473 const char *value) /* I - Value */
1474 {
1475 strlcpy(cc->server_name, value, sizeof(cc->server_name));
1476 }
1477
1478
1479 /*
1480 * 'cups_set_ssl_options()' - Set the SSLOptions value.
1481 */
1482
1483 #ifdef HAVE_SSL
1484 static void
1485 cups_set_ssl_options(
1486 _cups_client_conf_t *cc, /* I - client.conf values */
1487 const char *value) /* I - Value */
1488 {
1489 /*
1490 * SSLOptions [AllowRC4] [AllowSSL3] [AllowDH] [DenyTLS1.0] [None]
1491 */
1492
1493 int options = _HTTP_TLS_NONE, /* SSL/TLS options */
1494 min_version = _HTTP_TLS_1_0, /* Minimum SSL/TLS version */
1495 max_version = _HTTP_TLS_MAX; /* Maximum SSL/TLS version */
1496 char temp[256], /* Copy of value */
1497 *start, /* Start of option */
1498 *end; /* End of option */
1499
1500
1501 strlcpy(temp, value, sizeof(temp));
1502
1503 for (start = temp; *start; start = end)
1504 {
1505 /*
1506 * Find end of keyword...
1507 */
1508
1509 end = start;
1510 while (*end && !_cups_isspace(*end))
1511 end ++;
1512
1513 if (*end)
1514 *end++ = '\0';
1515
1516 /*
1517 * Compare...
1518 */
1519
1520 if (!_cups_strcasecmp(start, "AllowRC4"))
1521 options |= _HTTP_TLS_ALLOW_RC4;
1522 else if (!_cups_strcasecmp(start, "AllowSSL3"))
1523 min_version = _HTTP_TLS_SSL3;
1524 else if (!_cups_strcasecmp(start, "AllowDH"))
1525 options |= _HTTP_TLS_ALLOW_DH;
1526 else if (!_cups_strcasecmp(start, "DenyCBC"))
1527 options |= _HTTP_TLS_DENY_CBC;
1528 else if (!_cups_strcasecmp(start, "DenyTLS1.0"))
1529 min_version = _HTTP_TLS_1_1;
1530 else if (!_cups_strcasecmp(start, "MaxTLS1.0"))
1531 max_version = _HTTP_TLS_1_0;
1532 else if (!_cups_strcasecmp(start, "MaxTLS1.1"))
1533 max_version = _HTTP_TLS_1_1;
1534 else if (!_cups_strcasecmp(start, "MaxTLS1.2"))
1535 max_version = _HTTP_TLS_1_2;
1536 else if (!_cups_strcasecmp(start, "MaxTLS1.3"))
1537 max_version = _HTTP_TLS_1_3;
1538 else if (!_cups_strcasecmp(start, "MinTLS1.0"))
1539 min_version = _HTTP_TLS_1_0;
1540 else if (!_cups_strcasecmp(start, "MinTLS1.1"))
1541 min_version = _HTTP_TLS_1_1;
1542 else if (!_cups_strcasecmp(start, "MinTLS1.2"))
1543 min_version = _HTTP_TLS_1_2;
1544 else if (!_cups_strcasecmp(start, "MinTLS1.3"))
1545 min_version = _HTTP_TLS_1_3;
1546 else if (!_cups_strcasecmp(start, "None"))
1547 options = _HTTP_TLS_NONE;
1548 }
1549
1550 cc->ssl_options = options;
1551 cc->ssl_max_version = max_version;
1552 cc->ssl_min_version = min_version;
1553
1554 DEBUG_printf(("4cups_set_ssl_options(cc=%p, value=\"%s\") options=%x, min_version=%d, max_version=%d", (void *)cc, value, options, min_version, max_version));
1555 }
1556 #endif /* HAVE_SSL */
1557
1558
1559 /*
1560 * 'cups_set_uatokens()' - Set the UserAgentTokens value.
1561 */
1562
1563 static void
1564 cups_set_uatokens(
1565 _cups_client_conf_t *cc, /* I - client.conf values */
1566 const char *value) /* I - Value */
1567 {
1568 int i; /* Looping var */
1569 static const char * const uatokens[] =/* UserAgentTokens values */
1570 {
1571 "NONE",
1572 "PRODUCTONLY",
1573 "MAJOR",
1574 "MINOR",
1575 "MINIMAL",
1576 "OS",
1577 "FULL"
1578 };
1579
1580 for (i = 0; i < (int)(sizeof(uatokens) / sizeof(uatokens[0])); i ++)
1581 {
1582 if (!_cups_strcasecmp(value, uatokens[i]))
1583 {
1584 cc->uatokens = (_cups_uatokens_t)i;
1585 return;
1586 }
1587 }
1588 }
1589
1590
1591 /*
1592 * 'cups_set_user()' - Set the User value.
1593 */
1594
1595 static void
1596 cups_set_user(
1597 _cups_client_conf_t *cc, /* I - client.conf values */
1598 const char *value) /* I - Value */
1599 {
1600 strlcpy(cc->user, value, sizeof(cc->user));
1601 }