| blob | 24442feb1d5187cbae589acc55c5d8f6d56a72bc |
1 /*
2 Samba Unix/Linux SMB client library
3 Distributed SMB/CIFS Server Management Utility
4 Copyright (C) 2004,2009 Guenther Deschner (gd@samba.org)
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
18 */
29 /* support itanium as well */
41 };
44 /**
45 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
46 * It is here for debugging purpose and should be removed later on.
47 **/
49 /****************************************************************************
50 Printer info level 3 display function.
51 ****************************************************************************/
54 {
59 }
72 }
78 }
81 {
83 DATA_BLOB blob;
96 }
98 text);
115 }
120 }
123 }
128 }
130 }
132 /**
133 * Copies ACLs, DOS-attributes and timestamps from one
134 * file or directory from one connected share to another connected share
135 *
136 * @param c A net_context structure
137 * @param mem_ctx A talloc-context
138 * @param cli_share_src A connected cli_state
139 * @param cli_share_dst A connected cli_state
140 * @param src_file The source file-name
141 * @param dst_file The destination file-name
142 * @param copy_acls Whether to copy acls
143 * @param copy_attrs Whether to copy DOS attributes
144 * @param copy_timestamps Whether to preserve timestamps
145 * @param is_file Whether this file is a file or a dir
146 *
147 * @return Normal NTSTATUS return.
148 **/
157 {
169 /* open file/dir on the originating server */
180 }
185 /* get the security descriptor */
192 }
196 }
201 /* get file attributes */
208 }
209 }
212 /* open the file/dir on the destination server */
214 if (!NT_STATUS_IS_OK(cli_ntcreate(cli_share_dst, dst_name, 0, WRITE_DAC_ACCESS | WRITE_OWNER_ACCESS, 0,
220 }
224 /* set timestamps */
230 }
231 }
234 NTSTATUS status;
236 /* set acls */
243 }
244 }
248 /* set attrs */
254 }
255 }
258 /* closing files */
266 }
274 }
279 out:
281 /* cleaning up */
289 }
291 /**
292 * Copy a file or directory from a connected share to another connected share
293 *
294 * @param c A net_context structure
295 * @param mem_ctx A talloc-context
296 * @param cli_share_src A connected cli_state
297 * @param cli_share_dst A connected cli_state
298 * @param src_file The source file-name
299 * @param dst_file The destination file-name
300 * @param copy_acls Whether to copy acls
301 * @param copy_attrs Whether to copy DOS attributes
302 * @param copy_timestamps Whether to preserve timestamps
303 * @param is_file Whether this file is a file or a dir
304 *
305 * @return Normal NTSTATUS return.
306 **/
315 {
331 /* open on the originating server */
336 else
345 }
350 /* open file on the destination server */
359 }
361 /* allocate memory */
364 read_size);
367 }
369 }
381 }
386 /* copying file */
389 read_size);
402 }
405 }
410 /* creating dir */
412 dst_name));
418 }
425 }
426 }
429 /* closing files */
436 }
444 }
446 /* possibly we have to copy some file-attributes / acls / sd */
456 out:
458 /* cleaning up */
468 }
470 /**
471 * Copy a driverfile from on connected share to another connected share
472 * This silently assumes that a driver-file is picked up from
473 *
474 * \\src_server\print$\{arch}\{version}\file
475 *
476 * and copied to
477 *
478 * \\dst_server\print$\{arch}\file
479 *
480 * to be added via setdriver-calls later.
481 * @param c A net_context structure
482 * @param mem_ctx A talloc-context
483 * @param cli_share_src A cli_state connected to source print$-share
484 * @param cli_share_dst A cli_state connected to destination print$-share
485 * @param file The file-name to be copied
486 * @param short_archi The name of the driver-architecture (short form)
487 *
488 * @return Normal NTSTATUS return.
489 **/
506 }
508 /* scroll through the file until we have the part
509 beyond archi_table.short_archi */
515 }
516 }
520 }
522 /* build source file name */
527 }
529 /* create destination file name */
533 }
536 /* finally copy the file */
539 }
541 /**
542 * Check for existing Architecture directory on a given server
543 *
544 * @param cli_share A cli_state connected to a print$-share
545 * @param short_archi The Architecture for the print-driver
546 *
547 * @return Normal NTSTATUS return.
548 **/
551 {
558 }
561 short_archi));
567 }
573 }
577 out:
580 }
582 /**
583 * Copy a print-driver (level 3) from one connected print$-share to another
584 * connected print$-share
585 *
586 * @param c A net_context structure
587 * @param mem_ctx A talloc-context
588 * @param cli_share_src A cli_state connected to a print$-share
589 * @param cli_share_dst A cli_state connected to a print$-share
590 * @param short_archi The Architecture for the print-driver
591 * @param i1 The DRIVER_INFO_3-struct
592 *
593 * @return Normal NTSTATUS return.
594 **/
602 {
608 }
642 }
643 }
646 }
648 /**
649 * net_spoolss-functions
650 * =====================
651 *
652 * the net_spoolss-functions aim to simplify spoolss-client-functions
653 * required during the migration-process wrt buffer-sizes, returned
654 * error-codes, etc.
655 *
656 * this greatly reduces the complexitiy of the migrate-functions.
657 *
658 **/
667 {
668 WERROR result;
670 /* enum printers */
673 flags,
674 name,
675 level,
677 num_printers,
678 info);
682 }
685 }
693 {
694 WERROR result;
695 fstring printername2;
704 /* open printer */
706 printername2,
707 access_required,
708 hnd);
710 /* be more verbose */
717 }
723 }
729 }
736 {
737 WERROR result;
739 /* getprinter call */
741 hnd,
742 level,
744 info);
748 }
751 }
758 {
760 WERROR result;
761 NTSTATUS status;
770 /* setprinter call */
815 #endif
818 }
821 hnd,
830 }
834 }
837 }
847 {
849 WERROR result;
850 NTSTATUS status;
852 /* setprinterdata call */
854 hnd,
855 value_name,
856 type,
857 data,
858 offered,
864 }
869 }
872 }
880 {
881 WERROR result;
883 /* enumprinterkey call */
889 }
892 }
901 {
902 WERROR result;
904 /* enumprinterdataex call */
906 hnd,
907 keyname,
909 count,
910 info);
915 }
918 }
926 {
928 WERROR result;
929 NTSTATUS status;
931 /* setprinterdataex call */
933 hnd,
934 keyname,
944 }
949 }
952 }
960 {
961 WERROR result;
963 /* enumforms call */
965 hnd,
966 level,
968 num_forms,
969 forms);
973 }
976 }
983 {
984 WERROR result;
986 /* enumprinterdrivers call */
989 env,
990 level,
992 count,
993 info);
1001 env);
1002 }
1003 }
1006 }
1013 {
1014 WERROR result;
1018 /* getprinterdriver call */
1020 hnd,
1021 env,
1022 level,
1024 version,
1026 info,
1036 }
1038 }
1041 }
1047 {
1049 WERROR result;
1050 NTSTATUS status;
1067 }
1069 /* addprinterdriver call */
1077 }
1078 /* be more verbose */
1082 }
1086 }
1089 }
1091 /**
1092 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1093 * for a single printer or for all printers depending on argc/argv
1094 **/
1103 {
1106 WERROR werr;
1108 /* no arguments given, enumerate all printers */
1117 }
1119 /* argument given, get a single printer by name */
1121 MAXIMUM_ALLOWED_ACCESS,
1129 }
1134 }
1140 out:
1145 }
1147 /**
1148 * List print-queues (including local printers that are not shared)
1149 *
1150 * All parameters are provided by the run_rpc_command function, except for
1151 * argc, argv which are passed through.
1152 *
1153 * @param c A net_context structure
1154 * @param domain_sid The domain sid aquired from the remote server
1155 * @param cli A cli_state connected to the server.
1156 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1157 * @param argc Standard main() style argc
1158 * @param argv Standard main() style argv. Initial components are already
1159 * stripped
1160 *
1161 * @return Normal NTSTATUS return.
1162 **/
1172 {
1186 /* do some initialization */
1193 }
1194 }
1197 }
1199 /**
1200 * List printer-drivers from a server
1201 *
1202 * All parameters are provided by the run_rpc_command function, except for
1203 * argc, argv which are passed through.
1204 *
1205 * @param c A net_context structure
1206 * @param domain_sid The domain sid aquired from the remote server
1207 * @param cli A cli_state connected to the server.
1208 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1209 * @param argc Standard main() style argc
1210 * @param argv Standard main() style argv. Initial components are already
1211 * stripped
1212 *
1213 * @return Normal NTSTATUS return.
1214 **/
1224 {
1237 /* enum remote drivers */
1243 }
1250 }
1256 /* do something for all drivers for architecture */
1259 }
1260 }
1264 done:
1267 }
1269 /**
1270 * Publish print-queues with args-wrapper
1271 *
1272 * @param cli A cli_state connected to the server.
1273 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1274 * @param argc Standard main() style argc
1275 * @param argv Standard main() style argv. Initial components are already
1276 * stripped
1277 * @param action
1278 *
1279 * @return Normal NTSTATUS return.
1280 **/
1287 {
1299 WERROR result;
1307 /* do some initialization */
1312 }
1314 /* open printer handle */
1319 /* check for existing dst printer */
1323 /* check action and set string */
1338 }
1359 }
1366 }
1369 }
1373 }
1377 done:
1380 }
1383 }
1393 {
1395 }
1405 {
1407 }
1417 {
1419 }
1421 /**
1422 * List print-queues w.r.t. their publishing state
1423 *
1424 * All parameters are provided by the run_rpc_command function, except for
1425 * argc, argv which are passed through.
1426 *
1427 * @param c A net_context structure
1428 * @param domain_sid The domain sid aquired from the remote server
1429 * @param cli A cli_state connected to the server.
1430 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1431 * @param argc Standard main() style argc
1432 * @param argv Standard main() style argv. Initial components are already
1433 * stripped
1434 *
1435 * @return Normal NTSTATUS return.
1436 **/
1446 {
1456 WERROR werr;
1463 /* do some initialization */
1469 }
1471 /* open printer handle */
1476 /* check for existing dst printer */
1482 }
1487 sharename);
1494 sharename);
1498 sharename);
1503 }
1504 }
1508 done:
1511 }
1514 }
1516 /**
1517 * Migrate Printer-ACLs from a source server to the destination server
1518 *
1519 * All parameters are provided by the run_rpc_command function, except for
1520 * argc, argv which are passed through.
1521 *
1522 * @param c A net_context structure
1523 * @param domain_sid The domain sid aquired from the remote server
1524 * @param cli A cli_state connected to the server.
1525 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1526 * @param argc Standard main() style argc
1527 * @param argv Standard main() style argv. Initial components are already
1528 * stripped
1529 *
1530 * @return Normal NTSTATUS return.
1531 **/
1541 {
1543 /* TODO: what now, info2 or info3 ?
1544 convince jerry that we should add clientside setacls level 3 at least
1545 */
1557 WERROR werr;
1561 /* connect destination PI_SPOOLSS */
1566 }
1569 /* enum source printers */
1573 }
1579 }
1581 /* do something for all printers */
1584 /* do some initialization */
1591 }
1593 /* we can reset NT_STATUS here because we do not
1594 get any real NT_STATUS-codes anymore from now on */
1600 /* according to msdn you have specify these access-rights
1601 to see the security descriptor
1602 - READ_CONTROL (DACL)
1603 - ACCESS_SYSTEM_SECURITY (SACL)
1604 */
1606 /* open src printer handle */
1611 /* open dst printer handle */
1616 /* check for existing dst printer */
1620 /* check for existing src printer */
1624 /* Copy Security Descriptor */
1626 /* copy secdesc (info level 2) */
1639 /* close printer handles here */
1642 }
1646 }
1648 }
1652 done:
1656 }
1660 }
1664 }
1666 }
1668 /**
1669 * Migrate printer-forms from a src server to the dst server
1670 *
1671 * All parameters are provided by the run_rpc_command function, except for
1672 * argc, argv which are passed through.
1673 *
1674 * @param c A net_context structure
1675 * @param domain_sid The domain sid aquired from the remote server
1676 * @param cli A cli_state connected to the server.
1677 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1678 * @param argc Standard main() style argc
1679 * @param argv Standard main() style argv. Initial components are already
1680 * stripped
1681 *
1682 * @return Normal NTSTATUS return.
1683 **/
1693 {
1696 WERROR result;
1712 /* connect destination PI_SPOOLSS */
1717 }
1720 /* enum src printers */
1724 }
1730 }
1732 /* do something for all printers */
1735 /* do some initialization */
1742 }
1743 /* we can reset NT_STATUS here because we do not
1744 get any real NT_STATUS-codes anymore from now on */
1751 /* open src printer handle */
1756 /* open dst printer handle */
1761 /* check for existing dst printer */
1765 /* finally migrate forms */
1775 NTSTATUS status;
1777 /* only migrate FORM_PRINTER types, according to jerry
1778 FORM_BUILTIN-types are hard-coded in samba */
1791 /* FIXME: there might be something wrong with samba's
1792 builtin-forms */
1796 info,
1802 }
1807 }
1811 }
1814 /* close printer handles here */
1817 }
1821 }
1822 }
1826 done:
1830 }
1834 }
1838 }
1840 }
1842 /**
1843 * Migrate printer-drivers from a src server to the dst server
1844 *
1845 * All parameters are provided by the run_rpc_command function, except for
1846 * argc, argv which are passed through.
1847 *
1848 * @param c A net_context structure
1849 * @param domain_sid The domain sid aquired from the remote server
1850 * @param cli A cli_state connected to the server.
1851 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1852 * @param argc Standard main() style argc
1853 * @param argv Standard main() style argv. Initial components are already
1854 * stripped
1855 *
1856 * @return Normal NTSTATUS return.
1857 **/
1867 {
1886 WERROR werr;
1894 }
1897 /* open print$-share on the src server */
1906 /* open print$-share on the dst server */
1915 /* enum src printers */
1919 }
1925 }
1928 /* do something for all printers */
1931 /* do some initialization */
1938 }
1940 /* we can reset NT_STATUS here because we do not
1941 get any real NT_STATUS-codes anymore from now on */
1947 /* open dst printer handle */
1952 /* check for existing dst printer */
1957 /* open src printer handle */
1959 MAXIMUM_ALLOWED_ACCESS,
1964 /* in a first step call getdriver for each shared printer (per arch)
1965 to get a list of all files that have to be copied */
1969 /* getdriver src */
1980 /* check arch dir */
1986 /* copy driver-files */
1994 /* adddriver dst */
1998 }
2003 }
2007 printername));
2009 }
2011 /* setdriver dst */
2017 }
2022 /* close dst */
2025 }
2027 /* close src */
2030 }
2031 }
2035 done:
2039 }
2041 /* close src */
2044 }
2048 }
2058 }
2060 /**
2061 * Migrate printer-queues from a src to the dst server
2062 * (requires a working "addprinter command" to be installed for the local smbd)
2063 *
2064 * All parameters are provided by the run_rpc_command function, except for
2065 * argc, argv which are passed through.
2066 *
2067 * @param c A net_context structure
2068 * @param domain_sid The domain sid aquired from the remote server
2069 * @param cli A cli_state connected to the server.
2070 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2071 * @param argc Standard main() style argc
2072 * @param argv Standard main() style argv. Initial components are already
2073 * stripped
2074 *
2075 * @return Normal NTSTATUS return.
2076 **/
2086 {
2088 WERROR result;
2103 /* connect destination PI_SPOOLSS */
2108 }
2111 /* enum printers */
2115 }
2121 }
2123 /* do something for all printers */
2128 /* do some initialization */
2135 }
2136 /* we can reset NT_STATUS here because we do not
2137 get any real NT_STATUS-codes anymore from now on */
2143 /* open dst printer handle */
2148 }
2150 /* check for existing dst printer */
2155 /* close printer handle here - dst only, not got src yet. */
2158 }
2160 }
2162 /* now get again src printer ctr via getprinter,
2163 we first need a handle for that */
2165 /* open src printer handle */
2170 /* getprinter on the src server */
2174 /* copy each src printer to a dst printer 1:1,
2175 maybe some values have to be changed though */
2183 mem_ctx,
2188 printername);
2191 printername);
2194 printername);
2196 }
2198 /* close printer handles here */
2201 }
2205 }
2206 }
2210 done:
2213 }
2217 }
2221 }
2223 }
2225 /**
2226 * Migrate Printer-Settings from a src server to the dst server
2227 * (for this to work, printers and drivers already have to be migrated earlier)
2228 *
2229 * All parameters are provided by the run_rpc_command function, except for
2230 * argc, argv which are passed through.
2231 *
2232 * @param c A net_context structure
2233 * @param domain_sid The domain sid aquired from the remote server
2234 * @param cli A cli_state connected to the server.
2235 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2236 * @param argc Standard main() style argc
2237 * @param argv Standard main() style argv. Initial components are already
2238 * stripped
2239 *
2240 * @return Normal NTSTATUS return.
2241 **/
2251 {
2254 /* FIXME: Here the nightmare begins */
2256 WERROR result;
2273 /* FIXME GD */
2278 /* connect destination PI_SPOOLSS */
2283 }
2286 /* enum src printers */
2290 }
2296 }
2299 /* needed for dns-strings in regkeys */
2304 }
2306 /* do something for all printers */
2315 /* do some initialization */
2322 }
2323 /* we can reset NT_STATUS here because we do not
2324 get any real NT_STATUS-codes anymore from now on */
2331 /* open src printer handle */
2336 /* open dst printer handle */
2341 /* check for existing dst printer */
2347 /* STEP 1: COPY DEVICE-MODE and other
2348 PRINTER_INFO_2-attributes
2349 */
2353 /* why is the port always disconnected when the printer
2354 is correctly installed (incl. driver ???) */
2357 /* check if printer is published */
2360 /* check for existing dst printer */
2366 /* ignore false from setprinter due to WERR_IO_PENDING */
2370 }
2374 /* copy devmode (info level 2) */
2377 /* do not copy security descriptor (we have another
2378 * command for that) */
2381 #if 0
2388 }
2389 #endif
2395 }
2397 /* STEP 2: COPY REGISTRY VALUES */
2399 /* please keep in mind that samba parse_spools gives horribly
2400 crippled results when used to rpccli_spoolss_enumprinterdataex
2401 a win2k3-server. (Bugzilla #1851)
2402 FIXME: IIRC I've seen it too on a win2k-server
2403 */
2405 /* enumerate data on src handle */
2408 p,
2409 value_name,
2410 value_offered,
2413 buffer,
2414 data_offered,
2423 /* loop for all printerdata of "PrinterDriverData" */
2428 p++,
2429 value_name,
2430 value_offered,
2433 buffer,
2434 data_offered,
2437 /* loop for all reg_keys */
2440 /* display_value */
2445 value_name,
2446 type,
2447 buffer,
2448 data_offered);
2452 }
2456 }
2458 /* set_value */
2465 value_name));
2466 }
2467 }
2469 /* STEP 3: COPY SUBKEY VALUES */
2471 /* here we need to enum all printer_keys and then work
2472 on the result with enum_printer_key_ex. nt4 does not
2473 respond to enumprinterkey, win2k does, so continue
2474 in case of an error */
2479 }
2482 /* work on a list of printer keys
2483 each key has to be enumerated to get all required
2484 information. information is then set via setprinterdataex-calls */
2495 /* enumerate all src subkeys */
2500 }
2505 DATA_BLOB blob;
2509 /* although samba replies with sane data in most cases we
2510 should try to avoid writing wrong registry data */
2520 /* although windows uses a multi-sz, we use a sz */
2522 }
2529 }
2531 }
2537 #if 0
2538 /* FIXME: should we really do that ??? */
2542 }
2545 #endif
2546 }
2551 }
2556 }
2560 REG_SZ,
2566 }
2571 /* here we have to set all subkeys on the dst server */
2574 {
2577 }
2592 }
2596 }
2598 /* here we have to set all subkeys on the dst server */
2602 }
2605 }
2610 }
2611 }
2615 /* close printer handles here */
2618 }
2622 }
2623 }
2627 done:
2634 }
2638 }
2642 }
2644 }