| blob | 242235bd314eb6540032d8b18a74a42c70436c0e |
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 */
35 /* support itanium as well */
47 };
50 /**
51 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
52 * It is here for debugging purpose and should be removed later on.
53 **/
55 /****************************************************************************
56 Printer info level 3 display function.
57 ****************************************************************************/
60 {
65 }
78 }
84 }
86 static void display_reg_value(const char *subkey, const char *name, struct registry_value *value)
87 {
97 name);
98 }
105 }
122 }
127 }
130 }
134 }
136 }
138 /**
139 * Copies ACLs, DOS-attributes and timestamps from one
140 * file or directory from one connected share to another connected share
141 *
142 * @param c A net_context structure
143 * @param mem_ctx A talloc-context
144 * @param cli_share_src A connected cli_state
145 * @param cli_share_dst A connected cli_state
146 * @param src_file The source file-name
147 * @param dst_file The destination file-name
148 * @param copy_acls Whether to copy acls
149 * @param copy_attrs Whether to copy DOS attributes
150 * @param copy_timestamps Whether to preserve timestamps
151 * @param is_file Whether this file is a file or a dir
152 *
153 * @return Normal NTSTATUS return.
154 **/
163 {
164 NTSTATUS nt_status;
174 /* open file/dir on the originating server */
187 }
190 /* get the security descriptor */
197 }
201 }
205 /* get file attributes */
212 }
213 }
215 /* open the file/dir on the destination server */
224 }
227 /* set timestamps */
233 }
234 }
237 /* set acls */
243 }
244 }
247 /* set attrs */
253 }
254 }
257 /* closing files */
264 }
272 }
277 out:
279 /* cleaning up */
287 }
289 /**
290 * Copy a file or directory from a connected share to another connected share
291 *
292 * @param c A net_context structure
293 * @param mem_ctx A talloc-context
294 * @param cli_share_src A connected cli_state
295 * @param cli_share_dst A connected cli_state
296 * @param src_file The source file-name
297 * @param dst_file The destination file-name
298 * @param copy_acls Whether to copy acls
299 * @param copy_attrs Whether to copy DOS attributes
300 * @param copy_timestamps Whether to preserve timestamps
301 * @param is_file Whether this file is a file or a dir
302 *
303 * @return Normal NTSTATUS return.
304 **/
313 {
329 /* open on the originating server */
334 else
344 }
349 /* open file on the destination server */
358 }
360 /* allocate memory */
363 read_size);
366 }
368 }
382 }
387 /* copying file */
399 }
414 }
417 }
422 /* creating dir */
424 dst_name));
431 }
440 }
441 }
444 /* closing files */
451 }
460 }
461 }
463 /* possibly we have to copy some file-attributes / acls / sd */
473 out:
475 /* cleaning up */
485 }
487 /**
488 * Copy a driverfile from on connected share to another connected share
489 * This silently assumes that a driver-file is picked up from
490 *
491 * \\src_server\print$\{arch}\{version}\file
492 *
493 * and copied to
494 *
495 * \\dst_server\print$\{arch}\file
496 *
497 * to be added via setdriver-calls later.
498 * @param c A net_context structure
499 * @param mem_ctx A talloc-context
500 * @param cli_share_src A cli_state connected to source print$-share
501 * @param cli_share_dst A cli_state connected to destination print$-share
502 * @param file The file-name to be copied
503 * @param short_archi The name of the driver-architecture (short form)
504 *
505 * @return Normal NTSTATUS return.
506 **/
523 }
525 /* scroll through the file until we have the part
526 beyond archi_table.short_archi */
532 }
533 }
537 }
539 /* build source file name */
544 }
546 /* create destination file name */
550 }
553 /* finally copy the file */
556 }
558 /**
559 * Check for existing Architecture directory on a given server
560 *
561 * @param cli_share A cli_state connected to a print$-share
562 * @param short_archi The Architecture for the print-driver
563 *
564 * @return Normal NTSTATUS return.
565 **/
568 {
575 }
578 short_archi));
584 }
591 }
595 out:
598 }
600 /**
601 * Copy a print-driver (level 3) from one connected print$-share to another
602 * connected print$-share
603 *
604 * @param c A net_context structure
605 * @param mem_ctx A talloc-context
606 * @param cli_share_src A cli_state connected to a print$-share
607 * @param cli_share_dst A cli_state connected to a print$-share
608 * @param short_archi The Architecture for the print-driver
609 * @param i1 The DRIVER_INFO_3-struct
610 *
611 * @return Normal NTSTATUS return.
612 **/
620 {
626 }
660 }
661 }
664 }
666 /**
667 * net_spoolss-functions
668 * =====================
669 *
670 * the net_spoolss-functions aim to simplify spoolss-client-functions
671 * required during the migration-process wrt buffer-sizes, returned
672 * error-codes, etc.
673 *
674 * this greatly reduces the complexitiy of the migrate-functions.
675 *
676 **/
685 {
686 WERROR result;
688 /* enum printers */
691 flags,
692 name,
693 level,
695 num_printers,
696 info);
700 }
703 }
710 {
713 WERROR result;
714 fstring printername2;
723 /* open printer */
725 printername2,
726 access_required,
727 hnd);
729 /* be more verbose */
736 }
742 }
748 }
755 {
756 WERROR result;
758 /* getprinter call */
760 hnd,
761 level,
763 info);
767 }
770 }
777 {
779 WERROR result;
780 NTSTATUS status;
789 /* setprinter call */
834 #endif
837 }
840 hnd,
849 }
853 }
856 }
866 {
868 WERROR result;
869 NTSTATUS status;
871 /* setprinterdata call */
873 hnd,
874 value_name,
875 type,
876 data,
877 offered,
883 }
888 }
891 }
899 {
900 WERROR result;
902 /* enumprinterkey call */
908 }
911 }
920 {
921 WERROR result;
923 /* enumprinterdataex call */
925 hnd,
926 keyname,
928 count,
929 info);
934 }
937 }
946 {
948 WERROR result;
949 NTSTATUS status;
951 /* setprinterdataex call */
953 hnd,
954 keyname,
955 name,
964 }
969 }
972 }
980 {
981 WERROR result;
983 /* enumforms call */
985 hnd,
986 level,
988 num_forms,
989 forms);
993 }
996 }
1003 {
1004 WERROR result;
1006 /* enumprinterdrivers call */
1009 env,
1010 level,
1012 count,
1013 info);
1021 env);
1022 }
1023 }
1026 }
1033 {
1034 WERROR result;
1038 /* getprinterdriver call */
1040 hnd,
1041 env,
1042 level,
1044 version,
1046 info,
1056 }
1058 }
1061 }
1067 {
1069 WERROR result;
1070 NTSTATUS status;
1087 }
1089 /* addprinterdriver call */
1097 }
1098 /* be more verbose */
1102 }
1106 }
1109 }
1111 /**
1112 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1113 * for a single printer or for all printers depending on argc/argv
1114 **/
1123 {
1126 WERROR werr;
1128 /* no arguments given, enumerate all printers */
1137 }
1139 /* argument given, get a single printer by name */
1141 MAXIMUM_ALLOWED_ACCESS,
1148 }
1153 }
1159 out:
1164 }
1166 /**
1167 * List print-queues (including local printers that are not shared)
1168 *
1169 * All parameters are provided by the run_rpc_command function, except for
1170 * argc, argv which are passed through.
1171 *
1172 * @param c A net_context structure
1173 * @param domain_sid The domain sid aquired from the remote server
1174 * @param cli A cli_state connected to the server.
1175 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1176 * @param argc Standard main() style argc
1177 * @param argv Standard main() style argv. Initial components are already
1178 * stripped
1179 *
1180 * @return Normal NTSTATUS return.
1181 **/
1191 {
1205 /* do some initialization */
1212 }
1213 }
1216 }
1218 /**
1219 * List printer-drivers from a server
1220 *
1221 * All parameters are provided by the run_rpc_command function, except for
1222 * argc, argv which are passed through.
1223 *
1224 * @param c A net_context structure
1225 * @param domain_sid The domain sid aquired from the remote server
1226 * @param cli A cli_state connected to the server.
1227 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1228 * @param argc Standard main() style argc
1229 * @param argv Standard main() style argv. Initial components are already
1230 * stripped
1231 *
1232 * @return Normal NTSTATUS return.
1233 **/
1243 {
1256 /* enum remote drivers */
1262 }
1269 }
1275 /* do something for all drivers for architecture */
1278 }
1279 }
1283 done:
1286 }
1288 /**
1289 * Publish print-queues with args-wrapper
1290 *
1291 * @param cli A cli_state connected to the server.
1292 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1293 * @param argc Standard main() style argc
1294 * @param argv Standard main() style argv. Initial components are already
1295 * stripped
1296 * @param action
1297 *
1298 * @return Normal NTSTATUS return.
1299 **/
1306 {
1318 WERROR result;
1326 /* do some initialization */
1331 }
1333 /* open printer handle */
1338 /* check for existing dst printer */
1342 /* check action and set string */
1357 }
1378 }
1385 }
1388 }
1392 }
1396 done:
1399 }
1402 }
1412 {
1414 }
1424 {
1426 }
1436 {
1438 }
1440 /**
1441 * List print-queues w.r.t. their publishing state
1442 *
1443 * All parameters are provided by the run_rpc_command function, except for
1444 * argc, argv which are passed through.
1445 *
1446 * @param c A net_context structure
1447 * @param domain_sid The domain sid aquired from the remote server
1448 * @param cli A cli_state connected to the server.
1449 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1450 * @param argc Standard main() style argc
1451 * @param argv Standard main() style argv. Initial components are already
1452 * stripped
1453 *
1454 * @return Normal NTSTATUS return.
1455 **/
1465 {
1475 WERROR werr;
1482 /* do some initialization */
1488 }
1490 /* open printer handle */
1495 /* check for existing dst printer */
1501 }
1506 sharename);
1513 sharename);
1517 sharename);
1522 }
1523 }
1527 done:
1530 }
1533 }
1535 /**
1536 * Migrate Printer-ACLs from a source server to the destination server
1537 *
1538 * All parameters are provided by the run_rpc_command function, except for
1539 * argc, argv which are passed through.
1540 *
1541 * @param c A net_context structure
1542 * @param domain_sid The domain sid aquired from the remote server
1543 * @param cli A cli_state connected to the server.
1544 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1545 * @param argc Standard main() style argc
1546 * @param argv Standard main() style argv. Initial components are already
1547 * stripped
1548 *
1549 * @return Normal NTSTATUS return.
1550 **/
1560 {
1562 /* TODO: what now, info2 or info3 ?
1563 convince jerry that we should add clientside setacls level 3 at least
1564 */
1577 WERROR werr;
1581 /* connect destination PI_SPOOLSS */
1586 }
1589 /* enum source printers */
1593 }
1599 }
1601 /* do something for all printers */
1604 /* do some initialization */
1611 }
1613 /* we can reset NT_STATUS here because we do not
1614 get any real NT_STATUS-codes anymore from now on */
1620 /* according to msdn you have specify these access-rights
1621 to see the security descriptor
1622 - READ_CONTROL (DACL)
1623 - ACCESS_SYSTEM_SECURITY (SACL)
1624 */
1626 /* open src printer handle */
1631 /* open dst printer handle */
1636 /* check for existing dst printer */
1640 /* check for existing src printer */
1644 /* Copy Security Descriptor */
1646 /* copy secdesc (info level 2) */
1657 }
1658 }
1669 /* close printer handles here */
1672 }
1676 }
1678 }
1682 done:
1686 }
1690 }
1694 }
1696 }
1698 /**
1699 * Migrate printer-forms from a src server to the dst server
1700 *
1701 * All parameters are provided by the run_rpc_command function, except for
1702 * argc, argv which are passed through.
1703 *
1704 * @param c A net_context structure
1705 * @param domain_sid The domain sid aquired from the remote server
1706 * @param cli A cli_state connected to the server.
1707 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1708 * @param argc Standard main() style argc
1709 * @param argv Standard main() style argv. Initial components are already
1710 * stripped
1711 *
1712 * @return Normal NTSTATUS return.
1713 **/
1723 {
1726 WERROR result;
1743 /* connect destination PI_SPOOLSS */
1748 }
1751 /* enum src printers */
1755 }
1761 }
1763 /* do something for all printers */
1766 /* do some initialization */
1773 }
1774 /* we can reset NT_STATUS here because we do not
1775 get any real NT_STATUS-codes anymore from now on */
1782 /* open src printer handle */
1787 /* open dst printer handle */
1792 /* check for existing dst printer */
1796 /* finally migrate forms */
1806 NTSTATUS status;
1808 /* only migrate FORM_PRINTER types, according to jerry
1809 FORM_BUILTIN-types are hard-coded in samba */
1822 /* FIXME: there might be something wrong with samba's
1823 builtin-forms */
1832 }
1837 }
1841 }
1844 /* close printer handles here */
1847 }
1851 }
1852 }
1856 done:
1860 }
1864 }
1868 }
1870 }
1872 /**
1873 * Migrate printer-drivers from a src server to the dst server
1874 *
1875 * All parameters are provided by the run_rpc_command function, except for
1876 * argc, argv which are passed through.
1877 *
1878 * @param c A net_context structure
1879 * @param domain_sid The domain sid aquired from the remote server
1880 * @param cli A cli_state connected to the server.
1881 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1882 * @param argc Standard main() style argc
1883 * @param argv Standard main() style argv. Initial components are already
1884 * stripped
1885 *
1886 * @return Normal NTSTATUS return.
1887 **/
1897 {
1917 WERROR werr;
1925 }
1928 /* open print$-share on the src server */
1939 /* open print$-share on the dst server */
1950 /* enum src printers */
1954 }
1960 }
1963 /* do something for all printers */
1966 /* do some initialization */
1973 }
1975 /* we can reset NT_STATUS here because we do not
1976 get any real NT_STATUS-codes anymore from now on */
1982 /* open dst printer handle */
1987 /* check for existing dst printer */
1992 /* open src printer handle */
1994 MAXIMUM_ALLOWED_ACCESS,
1998 /* in a first step call getdriver for each shared printer (per arch)
1999 to get a list of all files that have to be copied */
2003 /* getdriver src */
2014 /* check arch dir */
2020 /* copy driver-files */
2028 /* adddriver dst */
2032 }
2037 }
2041 printername));
2043 }
2045 /* setdriver dst */
2051 }
2056 /* close dst */
2059 }
2061 /* close src */
2064 }
2065 }
2069 done:
2073 }
2075 /* close src */
2078 }
2082 }
2092 }
2094 /**
2095 * Migrate printer-queues from a src to the dst server
2096 * (requires a working "addprinter command" to be installed for the local smbd)
2097 *
2098 * All parameters are provided by the run_rpc_command function, except for
2099 * argc, argv which are passed through.
2100 *
2101 * @param c A net_context structure
2102 * @param domain_sid The domain sid aquired from the remote server
2103 * @param cli A cli_state connected to the server.
2104 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2105 * @param argc Standard main() style argc
2106 * @param argv Standard main() style argv. Initial components are already
2107 * stripped
2108 *
2109 * @return Normal NTSTATUS return.
2110 **/
2120 {
2122 WERROR result;
2138 /* connect destination PI_SPOOLSS */
2143 }
2146 /* enum printers */
2150 }
2156 }
2158 /* do something for all printers */
2163 /* do some initialization */
2170 }
2171 /* we can reset NT_STATUS here because we do not
2172 get any real NT_STATUS-codes anymore from now on */
2178 /* open dst printer handle */
2183 }
2185 /* check for existing dst printer */
2190 /* close printer handle here - dst only, not got src yet. */
2193 }
2195 }
2197 /* now get again src printer ctr via getprinter,
2198 we first need a handle for that */
2200 /* open src printer handle */
2205 /* getprinter on the src server */
2209 /* copy each src printer to a dst printer 1:1,
2210 maybe some values have to be changed though */
2218 mem_ctx,
2223 printername);
2226 printername);
2229 printername);
2231 }
2233 /* close printer handles here */
2236 }
2240 }
2241 }
2245 done:
2248 }
2252 }
2256 }
2258 }
2260 /**
2261 * Migrate Printer-Settings from a src server to the dst server
2262 * (for this to work, printers and drivers already have to be migrated earlier)
2263 *
2264 * All parameters are provided by the run_rpc_command function, except for
2265 * argc, argv which are passed through.
2266 *
2267 * @param c A net_context structure
2268 * @param domain_sid The domain sid aquired from the remote server
2269 * @param cli A cli_state connected to the server.
2270 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2271 * @param argc Standard main() style argc
2272 * @param argv Standard main() style argv. Initial components are already
2273 * stripped
2274 *
2275 * @return Normal NTSTATUS return.
2276 **/
2286 {
2289 /* FIXME: Here the nightmare begins */
2291 WERROR result;
2308 /* FIXME GD */
2313 /* connect destination PI_SPOOLSS */
2318 }
2321 /* enum src printers */
2325 }
2331 }
2334 /* needed for dns-strings in regkeys */
2339 }
2341 /* do something for all printers */
2349 /* do some initialization */
2356 }
2357 /* we can reset NT_STATUS here because we do not
2358 get any real NT_STATUS-codes anymore from now on */
2365 /* open src printer handle */
2370 /* open dst printer handle */
2375 /* check for existing dst printer */
2381 /* STEP 1: COPY DEVICE-MODE and other
2382 PRINTER_INFO_2-attributes
2383 */
2387 /* why is the port always disconnected when the printer
2388 is correctly installed (incl. driver ???) */
2391 /* check if printer is published */
2394 /* check for existing dst printer */
2400 /* ignore false from setprinter due to WERR_IO_PENDING */
2404 }
2408 /* copy devmode (info level 2) */
2411 /* do not copy security descriptor (we have another
2412 * command for that) */
2415 #if 0
2422 }
2423 #endif
2429 }
2431 /* STEP 2: COPY REGISTRY VALUES */
2433 /* please keep in mind that samba parse_spools gives horribly
2434 crippled results when used to rpccli_spoolss_enumprinterdataex
2435 a win2k3-server. (Bugzilla #1851)
2436 FIXME: IIRC I've seen it too on a win2k-server
2437 */
2449 /* enumerate data on src handle */
2457 /* loop for all printerdata of "PrinterDriverData" */
2464 /* loop for all reg_keys */
2467 /* display_value */
2476 }
2478 /* set_value */
2486 }
2487 }
2489 /* STEP 3: COPY SUBKEY VALUES */
2491 /* here we need to enum all printer_keys and then work
2492 on the result with enum_printer_key_ex. nt4 does not
2493 respond to enumprinterkey, win2k does, so continue
2494 in case of an error */
2499 }
2502 /* work on a list of printer keys
2503 each key has to be enumerated to get all required
2504 information. information is then set via setprinterdataex-calls */
2515 /* enumerate all src subkeys */
2520 }
2530 /* although samba replies with sane data in most cases we
2531 should try to avoid writing wrong registry data */
2534 /* although windows uses a multi-sz, we use a sz */
2539 }
2540 }
2546 }
2551 }
2553 }
2556 #if 0
2557 /* FIXME: should we really do that ??? */
2561 }
2564 #endif
2565 }
2571 }
2572 }
2578 }
2579 }
2583 }
2587 }
2589 /* here we have to set all subkeys on the dst server */
2592 {
2594 }
2599 }
2600 }
2604 /* close printer handles here */
2607 }
2611 }
2612 }
2616 done:
2619 }
2623 }
2627 }
2629 }