s4:dsdb:tests: Also pass tests if asserted identity is present
[Samba.git] / source3 / client / smbspool.c
blob16a8d44c069a115eb4e1adbfee15c5a462a62e92
1 /*
2 Unix SMB/CIFS implementation.
3 SMB backend for the Common UNIX Printing System ("CUPS")
5 Copyright (C) Michael R Sweet 1999
6 Copyright (C) Andrew Tridgell 1994-1998
7 Copyright (C) Andrew Bartlett 2002
8 Copyright (C) Rodrigo Fernandez-Vizarra 2005
9 Copyright (C) James Peach 2008
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include "includes.h"
26 #include "system/filesys.h"
27 #include "system/passwd.h"
28 #include "system/kerberos.h"
29 #include "libsmb/libsmb.h"
30 #include "lib/param/param.h"
31 #include "lib/krb5_wrap/krb5_samba.h"
34 * Starting with CUPS 1.3, Kerberos support is provided by cupsd including
35 * the forwarding of user credentials via the authenticated session between
36 * user and server and the KRB5CCNAME environment variable which will point
37 * to a temporary file or an in-memory representation depending on the version
38 * of Kerberos you use. As a result, all of the ticket code that used to
39 * live here has been removed, and we depend on the user session (if you
40 * run smbspool by hand) or cupsd to provide the necessary Kerberos info.
42 * Also, the AUTH_USERNAME and AUTH_PASSWORD environment variables provide
43 * for per-job authentication for non-Kerberized printing. We use those
44 * if there is no username and password specified in the device URI.
46 * Finally, if we have an authentication failure we return exit code 2
47 * which tells CUPS to hold the job for authentication and bug the user
48 * to get the necessary credentials.
51 #define MAX_RETRY_CONNECT 3
55 * Globals...
61 * Local functions...
64 static int get_exit_code(NTSTATUS nt_status);
65 static void list_devices(void);
66 static NTSTATUS
67 smb_connect(struct cli_state **output_cli,
68 const char *workgroup,
69 const char *server,
70 const int port,
71 const char *share,
72 const char *username,
73 const char *password,
74 const char *jobusername);
75 static int smb_print(struct cli_state *, const char *, FILE *);
76 static char *uri_unescape_alloc(const char *);
77 #if 0
78 static bool smb_encrypt;
79 #endif
81 static const char *auth_info_required;
84 * 'main()' - Main entry for SMB backend.
87 int /* O - Exit status */
88 main(int argc, /* I - Number of command-line arguments */
89 char *argv[])
90 { /* I - Command-line arguments */
91 int i; /* Looping var */
92 int copies; /* Number of copies */
93 int port; /* Port number */
94 char uri[1024], /* URI */
95 *sep, /* Pointer to separator */
96 *tmp, *tmp2; /* Temp pointers to do escaping */
97 const char *password = NULL; /* Password */
98 const char *username = NULL; /* Username */
99 char *server, /* Server name */
100 *printer;/* Printer name */
101 const char *workgroup; /* Workgroup */
102 FILE *fp; /* File to print */
103 int status = 1; /* Status of LPD job */
104 NTSTATUS nt_status = NT_STATUS_UNSUCCESSFUL;
105 struct cli_state *cli = NULL; /* SMB interface */
106 int tries = 0;
107 const char *dev_uri = NULL;
108 const char *env = NULL;
109 const char *config_file = NULL;
110 TALLOC_CTX *frame = talloc_stackframe();
111 const char *print_user = NULL;
112 const char *print_title = NULL;
113 const char *print_file = NULL;
114 const char *print_copies = NULL;
115 int cmp;
116 int len;
118 if (argc == 1) {
120 * NEW! In CUPS 1.1 the backends are run with no arguments
121 * to list the available devices. These can be devices
122 * served by this backend or any other backends (i.e. you
123 * can have an SNMP backend that is only used to enumerate
124 * the available network printers... :)
127 list_devices();
128 status = 0;
129 goto done;
133 * We need at least 5 options if the DEVICE_URI is passed via an env
134 * variable and printing data comes via stdin.
135 * We don't accept more than 7 options in total, including optional.
137 if (argc < 5 || argc > 8) {
138 fprintf(stderr,
139 "Usage: %s [DEVICE_URI] job-id user title copies options [file]\n"
140 " The DEVICE_URI environment variable can also contain the\n"
141 " destination printer:\n"
142 "\n"
143 " smb://[username:password@][workgroup/]server[:port]/printer\n",
144 argv[0]);
145 goto done;
149 * Find out if we have the device_uri in the command line.
151 * If we are started as a CUPS backend argv[0] is normally the
152 * device_uri!
154 if (argc == 8) {
156 * smbspool <uri> <job> <user> <title> <copies> <options> <file>
157 * 0 1 2 3 4 5 6 7
160 dev_uri = argv[1];
162 print_user = argv[3];
163 print_title = argv[4];
164 print_copies = argv[5];
165 print_file = argv[7];
166 } else if (argc == 7) {
167 int cmp1;
168 int cmp2;
171 * <uri> <job> <user> <title> <copies> <options> <file>
172 * smbspool <uri> <job> <user> <title> <copies> <options>
173 * smbspool <job> <user> <title> <copies> <options> <file> | DEVICE_URI
175 cmp1 = strncmp(argv[0], "smb://", 6);
176 cmp2 = strncmp(argv[1], "smb://", 6);
178 if (cmp1 == 0) {
180 * <uri> <job> <user> <title> <copies> <options> <file>
181 * 0 1 2 3 4 5 6
183 dev_uri = argv[0];
185 print_user = argv[2];
186 print_title = argv[3];
187 print_copies = argv[4];
188 print_file = argv[6];
189 } else if (cmp2 == 0) {
191 * smbspool <uri> <job> <user> <title> <copies> <options>
192 * 0 1 2 3 4 5 6
194 dev_uri = argv[1];
196 print_user = argv[3];
197 print_title = argv[4];
198 print_copies = argv[5];
199 print_file = NULL;
200 } else {
202 * smbspool <job> <user> <title> <copies> <options> <file> | DEVICE_URI
203 * 0 1 2 3 4 5 6
205 print_user = argv[2];
206 print_title = argv[3];
207 print_copies = argv[4];
208 print_file = argv[6];
210 } else if (argc == 6) {
212 * <uri> <job> <user> <title> <copies> <options>
213 * smbspool <job> <user> <title> <copies> <options> | DEVICE_URI
214 * 0 1 2 3 4 5
216 cmp = strncmp(argv[0], "smb://", 6);
217 if (cmp == 0) {
218 dev_uri = argv[0];
221 print_user = argv[2];
222 print_title = argv[3];
223 print_copies = argv[4];
226 if (print_file != NULL) {
227 char *endp;
229 fp = fopen(print_file, "rb");
230 if (fp == NULL) {
231 fprintf(stderr,
232 "ERROR: Unable to open print file: %s",
233 print_file);
234 goto done;
237 copies = strtol(print_copies, &endp, 10);
238 if (print_copies == endp) {
239 perror("ERROR: Unable to determine number of copies");
240 goto done;
242 } else {
243 fp = stdin;
244 copies = 1;
248 * Find the URI ...
250 * The URI in argv[0] is sanitized to remove username/password, so
251 * use DEVICE_URI if available. Otherwise keep the URI already
252 * discovered in argv.
254 env = getenv("DEVICE_URI");
255 if (env != NULL && env[0] != '\0') {
256 dev_uri = env;
259 if (dev_uri == NULL) {
260 fprintf(stderr,
261 "ERROR: No valid device URI has been specified\n");
262 goto done;
265 cmp = strncmp(dev_uri, "smb://", 6);
266 if (cmp != 0) {
267 fprintf(stderr,
268 "ERROR: No valid device URI has been specified\n");
269 goto done;
271 len = snprintf(uri, sizeof(uri), "%s", dev_uri);
272 if (len >= sizeof(uri)) {
273 fprintf(stderr,
274 "ERROR: The URI is too long.\n");
275 goto done;
278 auth_info_required = getenv("AUTH_INFO_REQUIRED");
279 if (auth_info_required == NULL) {
280 auth_info_required = "samba";
284 * Extract the destination from the URI...
287 if ((sep = strrchr_m(uri, '@')) != NULL) {
288 tmp = uri + 6;
289 *sep++ = '\0';
291 /* username is in tmp */
293 server = sep;
296 * Extract password as needed...
299 if ((tmp2 = strchr_m(tmp, ':')) != NULL) {
300 *tmp2++ = '\0';
301 password = uri_unescape_alloc(tmp2);
303 username = uri_unescape_alloc(tmp);
304 } else {
305 env = getenv("AUTH_USERNAME");
306 if (env != NULL && strlen(env) > 0) {
307 username = env;
310 env = getenv("AUTH_PASSWORD");
311 if (env != NULL && strlen(env) > 0) {
312 password = env;
315 server = uri + 6;
318 if (password != NULL) {
319 auth_info_required = "username,password";
322 tmp = server;
324 if ((sep = strchr_m(tmp, '/')) == NULL) {
325 fputs("ERROR: Bad URI - need printer name!\n", stderr);
326 goto done;
329 *sep++ = '\0';
330 tmp2 = sep;
332 if ((sep = strchr_m(tmp2, '/')) != NULL) {
334 * Convert to smb://[username:password@]workgroup/server/printer...
337 *sep++ = '\0';
339 workgroup = uri_unescape_alloc(tmp);
340 server = uri_unescape_alloc(tmp2);
341 printer = uri_unescape_alloc(sep);
342 } else {
343 workgroup = NULL;
344 server = uri_unescape_alloc(tmp);
345 printer = uri_unescape_alloc(tmp2);
348 if ((sep = strrchr_m(server, ':')) != NULL) {
349 *sep++ = '\0';
351 port = atoi(sep);
352 } else {
353 port = 0;
357 * Setup the SAMBA server state...
360 setup_logging("smbspool", DEBUG_STDERR);
362 smb_init_locale();
364 config_file = lp_default_path();
365 if (!lp_load_client(config_file)) {
366 fprintf(stderr,
367 "ERROR: Can't load %s - run testparm to debug it\n",
368 config_file);
369 goto done;
372 if (workgroup == NULL) {
373 workgroup = lp_workgroup();
376 load_interfaces();
378 do {
379 nt_status = smb_connect(&cli,
380 workgroup,
381 server,
382 port,
383 printer,
384 username,
385 password,
386 print_user);
387 if (!NT_STATUS_IS_OK(nt_status)) {
388 status = get_exit_code(nt_status);
389 if (status == 2) {
390 fprintf(stderr,
391 "DEBUG: Unable to connect to CIFS "
392 "host: %s",
393 nt_errstr(nt_status));
394 goto done;
395 } else if (getenv("CLASS") == NULL) {
396 fprintf(stderr,
397 "ERROR: Unable to connect to CIFS "
398 "host: %s. Will retry in 60 "
399 "seconds...\n",
400 nt_errstr(nt_status));
401 sleep(60);
402 tries++;
403 } else {
404 fprintf(stderr,
405 "ERROR: Unable to connect to CIFS "
406 "host: %s. Trying next printer...\n",
407 nt_errstr(nt_status));
408 goto done;
411 } while (!NT_STATUS_IS_OK(nt_status) && (tries < MAX_RETRY_CONNECT));
413 if (cli == NULL) {
414 fprintf(stderr, "ERROR: Unable to connect to CIFS host after (tried %d times)\n", tries);
415 goto done;
419 * Now that we are connected to the server, ignore SIGTERM so that we
420 * can finish out any page data the driver sends (e.g. to eject the
421 * current page... Only ignore SIGTERM if we are printing data from
422 * stdin (otherwise you can't cancel raw jobs...)
425 if (argc < 7) {
426 CatchSignal(SIGTERM, SIG_IGN);
430 * Queue the job...
433 for (i = 0; i < copies; i++) {
434 status = smb_print(cli, print_title, fp);
435 if (status != 0) {
436 break;
440 cli_shutdown(cli);
443 * Return the queue status...
446 done:
448 TALLOC_FREE(frame);
449 return (status);
454 * 'get_exit_code()' - Get the backend exit code based on the current error.
457 static int
458 get_exit_code(NTSTATUS nt_status)
460 size_t i;
462 /* List of NTSTATUS errors that are considered
463 * authentication errors
465 static const NTSTATUS auth_errors[] =
467 NT_STATUS_ACCESS_DENIED,
468 NT_STATUS_ACCESS_VIOLATION,
469 NT_STATUS_ACCOUNT_DISABLED,
470 NT_STATUS_ACCOUNT_LOCKED_OUT,
471 NT_STATUS_ACCOUNT_RESTRICTION,
472 NT_STATUS_DOMAIN_CONTROLLER_NOT_FOUND,
473 NT_STATUS_INVALID_ACCOUNT_NAME,
474 NT_STATUS_INVALID_COMPUTER_NAME,
475 NT_STATUS_INVALID_LOGON_HOURS,
476 NT_STATUS_INVALID_WORKSTATION,
477 NT_STATUS_LOGON_FAILURE,
478 NT_STATUS_NO_SUCH_USER,
479 NT_STATUS_NO_SUCH_DOMAIN,
480 NT_STATUS_NO_LOGON_SERVERS,
481 NT_STATUS_PASSWORD_EXPIRED,
482 NT_STATUS_PRIVILEGE_NOT_HELD,
483 NT_STATUS_SHARING_VIOLATION,
484 NT_STATUS_WRONG_PASSWORD,
488 fprintf(stderr,
489 "DEBUG: get_exit_code(nt_status=%s [%x])\n",
490 nt_errstr(nt_status), NT_STATUS_V(nt_status));
492 for (i = 0; i < ARRAY_SIZE(auth_errors); i++) {
493 if (!NT_STATUS_EQUAL(nt_status, auth_errors[i])) {
494 continue;
497 fprintf(stderr, "ATTR: auth-info-required=%s\n", auth_info_required);
500 * 2 = authentication required...
503 return (2);
508 * 1 = fail
511 return (1);
516 * 'list_devices()' - List the available printers seen on the network...
519 static void
520 list_devices(void)
523 * Eventually, search the local workgroup for available hosts and printers.
526 puts("network smb \"Unknown\" \"Windows Printer via SAMBA\"");
530 static NTSTATUS
531 smb_complete_connection(struct cli_state **output_cli,
532 const char *myname,
533 const char *server,
534 int port,
535 const char *username,
536 const char *password,
537 const char *workgroup,
538 const char *share,
539 bool use_kerberos,
540 bool fallback_after_kerberos)
542 struct cli_state *cli; /* New connection */
543 NTSTATUS nt_status;
544 struct cli_credentials *creds = NULL;
546 /* Start the SMB connection */
547 nt_status = cli_start_connection(&cli, myname, server, NULL, port,
548 SMB_SIGNING_DEFAULT, 0);
549 if (!NT_STATUS_IS_OK(nt_status)) {
550 fprintf(stderr, "ERROR: Connection failed: %s\n", nt_errstr(nt_status));
551 return nt_status;
554 creds = cli_session_creds_init(cli,
555 username,
556 workgroup,
557 NULL, /* realm */
558 password,
559 use_kerberos,
560 fallback_after_kerberos,
561 false, /* use_ccache */
562 false); /* password_is_nt_hash */
563 if (creds == NULL) {
564 fprintf(stderr, "ERROR: cli_session_creds_init failed\n");
565 cli_shutdown(cli);
566 return NT_STATUS_NO_MEMORY;
569 nt_status = cli_session_setup_creds(cli, creds);
570 if (!NT_STATUS_IS_OK(nt_status)) {
571 fprintf(stderr, "ERROR: Session setup failed: %s\n", nt_errstr(nt_status));
573 cli_shutdown(cli);
575 return nt_status;
578 nt_status = cli_tree_connect_creds(cli, share, "?????", creds);
579 if (!NT_STATUS_IS_OK(nt_status)) {
580 fprintf(stderr, "ERROR: Tree connect failed (%s)\n",
581 nt_errstr(nt_status));
583 cli_shutdown(cli);
585 return nt_status;
588 *output_cli = cli;
589 return NT_STATUS_OK;
592 static bool kerberos_ccache_is_valid(void) {
593 krb5_context ctx;
594 const char *ccache_name = NULL;
595 krb5_ccache ccache = NULL;
596 krb5_error_code code;
598 code = smb_krb5_init_context_common(&ctx);
599 if (code != 0) {
600 DBG_ERR("kerberos init context failed (%s)\n",
601 error_message(code));
602 return false;
605 ccache_name = krb5_cc_default_name(ctx);
606 if (ccache_name == NULL) {
607 DBG_ERR("Failed to get default ccache name\n");
608 krb5_free_context(ctx);
609 return false;
612 code = krb5_cc_resolve(ctx, ccache_name, &ccache);
613 if (code != 0) {
614 DBG_ERR("Failed to resolve ccache name: %s\n",
615 ccache_name);
616 krb5_free_context(ctx);
617 return false;
618 } else {
619 krb5_principal default_princ = NULL;
620 char *princ_name = NULL;
622 code = krb5_cc_get_principal(ctx,
623 ccache,
624 &default_princ);
625 if (code != 0) {
626 DBG_ERR("Failed to get default principal from "
627 "ccache: %s\n",
628 ccache_name);
629 krb5_cc_close(ctx, ccache);
630 krb5_free_context(ctx);
631 return false;
634 code = krb5_unparse_name(ctx,
635 default_princ,
636 &princ_name);
637 if (code == 0) {
638 fprintf(stderr,
639 "DEBUG: Try to authenticate as %s\n",
640 princ_name);
641 krb5_free_unparsed_name(ctx, princ_name);
643 krb5_free_principal(ctx, default_princ);
645 krb5_cc_close(ctx, ccache);
646 krb5_free_context(ctx);
648 return true;
652 * 'smb_connect()' - Return a connection to a server.
655 static NTSTATUS
656 smb_connect(struct cli_state **output_cli,
657 const char *workgroup, /* I - Workgroup */
658 const char *server, /* I - Server */
659 const int port, /* I - Port */
660 const char *share, /* I - Printer */
661 const char *username, /* I - Username */
662 const char *password, /* I - Password */
663 const char *jobusername) /* I - User who issued the print job */
665 struct cli_state *cli = NULL; /* New connection */
666 char *myname = NULL; /* Client name */
667 struct passwd *pwd;
668 bool use_kerberos = false;
669 bool fallback_after_kerberos = false;
670 const char *user = username;
671 NTSTATUS nt_status;
674 * Get the names and addresses of the client and server...
676 myname = get_myname(talloc_tos());
677 if (!myname) {
678 return NT_STATUS_NO_MEMORY;
682 if (strcmp(auth_info_required, "negotiate") == 0) {
683 if (!kerberos_ccache_is_valid()) {
684 fprintf(stderr,
685 "ERROR: No valid Kerberos credential cache found! "
686 "Using smbspool_krb5_wrapper may help.\n");
687 return NT_STATUS_LOGON_FAILURE;
689 user = jobusername;
691 use_kerberos = true;
692 fprintf(stderr,
693 "DEBUG: Try to connect using Kerberos ...\n");
694 } else if (strcmp(auth_info_required, "username,password") == 0) {
695 if (username == NULL) {
696 return NT_STATUS_INVALID_ACCOUNT_NAME;
699 /* Fallback to NTLM */
700 fallback_after_kerberos = true;
702 fprintf(stderr,
703 "DEBUG: Try to connect using username/password ...\n");
704 } else if (strcmp(auth_info_required, "none") == 0) {
705 goto anonymous;
706 } else if (strcmp(auth_info_required, "samba") == 0) {
707 if (username != NULL) {
708 fallback_after_kerberos = true;
709 } else if (kerberos_ccache_is_valid()) {
710 auth_info_required = "negotiate";
712 user = jobusername;
713 use_kerberos = true;
714 } else {
715 fprintf(stderr,
716 "DEBUG: This backend requires credentials!\n");
717 return NT_STATUS_ACCESS_DENIED;
719 } else {
720 return NT_STATUS_ACCESS_DENIED;
723 nt_status = smb_complete_connection(&cli,
724 myname,
725 server,
726 port,
727 user,
728 password,
729 workgroup,
730 share,
731 true, /* try kerberos */
732 fallback_after_kerberos);
733 if (NT_STATUS_IS_OK(nt_status)) {
734 fprintf(stderr, "DEBUG: SMB connection established.\n");
736 *output_cli = cli;
737 return NT_STATUS_OK;
740 if (!use_kerberos) {
741 fprintf(stderr, "ERROR: SMB connection failed!\n");
742 return nt_status;
745 /* give a chance for a passwordless NTLMSSP session setup */
746 pwd = getpwuid(geteuid());
747 if (pwd == NULL) {
748 return NT_STATUS_ACCESS_DENIED;
751 nt_status = smb_complete_connection(&cli,
752 myname,
753 server,
754 port,
755 pwd->pw_name,
757 workgroup,
758 share,
759 false, false);
760 if (NT_STATUS_IS_OK(nt_status)) {
761 fputs("DEBUG: Connected with NTLMSSP...\n", stderr);
763 *output_cli = cli;
764 return NT_STATUS_OK;
768 * last try. Use anonymous authentication
771 anonymous:
772 nt_status = smb_complete_connection(&cli,
773 myname,
774 server,
775 port,
778 workgroup,
779 share,
780 false, false);
781 if (NT_STATUS_IS_OK(nt_status)) {
782 *output_cli = cli;
783 return NT_STATUS_OK;
786 return nt_status;
791 * 'smb_print()' - Queue a job for printing using the SMB protocol.
794 static int /* O - 0 = success, non-0 = failure */
795 smb_print(struct cli_state * cli, /* I - SMB connection */
796 const char *print_title, /* I - Title/job name */
797 FILE * fp)
798 { /* I - File to print */
799 uint16_t fnum; /* File number */
800 int nbytes, /* Number of bytes read */
801 tbytes; /* Total bytes read */
802 char buffer[8192], /* Buffer for copy */
803 *ptr; /* Pointer into title */
804 char title[1024] = {0};
805 int len;
806 NTSTATUS nt_status;
810 * Sanitize the title...
812 len = snprintf(title, sizeof(title), "%s", print_title);
813 if (len != strlen(print_title)) {
814 return 2;
817 for (ptr = title; *ptr; ptr++) {
818 if (!isalnum((int) *ptr) && !isspace((int) *ptr)) {
819 *ptr = '_';
824 * Open the printer device...
827 nt_status = cli_open(cli, title, O_RDWR | O_CREAT | O_TRUNC, DENY_NONE,
828 &fnum);
829 if (!NT_STATUS_IS_OK(nt_status)) {
830 fprintf(stderr, "ERROR: %s opening remote spool %s\n",
831 nt_errstr(nt_status), title);
832 return get_exit_code(nt_status);
836 * Copy the file to the printer...
839 if (fp != stdin)
840 rewind(fp);
842 tbytes = 0;
844 while ((nbytes = fread(buffer, 1, sizeof(buffer), fp)) > 0) {
845 NTSTATUS status;
847 status = cli_writeall(cli, fnum, 0, (uint8_t *)buffer,
848 tbytes, nbytes, NULL);
849 if (!NT_STATUS_IS_OK(status)) {
850 int ret = get_exit_code(status);
851 fprintf(stderr, "ERROR: Error writing spool: %s\n",
852 nt_errstr(status));
853 fprintf(stderr, "DEBUG: Returning status %d...\n",
854 ret);
855 cli_close(cli, fnum);
857 return (ret);
859 tbytes += nbytes;
862 nt_status = cli_close(cli, fnum);
863 if (!NT_STATUS_IS_OK(nt_status)) {
864 fprintf(stderr, "ERROR: %s closing remote spool %s\n",
865 nt_errstr(nt_status), title);
866 return get_exit_code(nt_status);
867 } else {
868 return (0);
872 static char *
873 uri_unescape_alloc(const char *uritok)
875 char *ret;
876 char *end;
877 ret = (char *) SMB_STRDUP(uritok);
878 if (!ret) {
879 return NULL;
882 end = rfc1738_unescape(ret);
883 if (end == NULL) {
884 free(ret);
885 return NULL;
887 return ret;