| blob | 8be4fb145c249651c228bdf3cc0f61bc4f9902fc |
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 */
28 /* support itanium as well */
40 };
43 /**
44 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
45 * It is here for debugging purpose and should be removed later on.
46 **/
48 /****************************************************************************
49 Printer info level 3 display function.
50 ****************************************************************************/
53 {
58 }
71 }
77 }
80 {
82 DATA_BLOB blob;
95 }
97 text);
114 }
119 }
122 }
127 }
129 }
131 /**
132 * Copies ACLs, DOS-attributes and timestamps from one
133 * file or directory from one connected share to another connected share
134 *
135 * @param c A net_context structure
136 * @param mem_ctx A talloc-context
137 * @param cli_share_src A connected cli_state
138 * @param cli_share_dst A connected cli_state
139 * @param src_file The source file-name
140 * @param dst_file The destination file-name
141 * @param copy_acls Whether to copy acls
142 * @param copy_attrs Whether to copy DOS attributes
143 * @param copy_timestamps Whether to preserve timestamps
144 * @param is_file Whether this file is a file or a dir
145 *
146 * @return Normal NTSTATUS return.
147 **/
156 {
168 /* open file/dir on the originating server */
179 }
184 /* get the security descriptor */
191 }
195 }
200 /* get file attributes */
207 }
208 }
211 /* open the file/dir on the destination server */
213 if (!NT_STATUS_IS_OK(cli_ntcreate(cli_share_dst, dst_name, 0, WRITE_DAC_ACCESS | WRITE_OWNER_ACCESS, 0,
219 }
223 /* set timestamps */
229 }
230 }
233 NTSTATUS status;
235 /* set acls */
242 }
243 }
247 /* set attrs */
253 }
254 }
257 /* closing files */
265 }
273 }
278 out:
280 /* cleaning up */
288 }
290 /**
291 * Copy a file or directory from a connected share to another connected share
292 *
293 * @param c A net_context structure
294 * @param mem_ctx A talloc-context
295 * @param cli_share_src A connected cli_state
296 * @param cli_share_dst A connected cli_state
297 * @param src_file The source file-name
298 * @param dst_file The destination file-name
299 * @param copy_acls Whether to copy acls
300 * @param copy_attrs Whether to copy DOS attributes
301 * @param copy_timestamps Whether to preserve timestamps
302 * @param is_file Whether this file is a file or a dir
303 *
304 * @return Normal NTSTATUS return.
305 **/
314 {
330 /* open on the originating server */
335 else
344 }
349 /* open file on the destination server */
358 }
360 /* allocate memory */
363 read_size);
366 }
368 }
380 }
385 /* copying file */
388 read_size);
401 }
404 }
409 /* creating dir */
411 dst_name));
417 }
424 }
425 }
428 /* closing files */
435 }
443 }
445 /* possibly we have to copy some file-attributes / acls / sd */
455 out:
457 /* cleaning up */
467 }
469 /**
470 * Copy a driverfile from on connected share to another connected share
471 * This silently assumes that a driver-file is picked up from
472 *
473 * \\src_server\print$\{arch}\{version}\file
474 *
475 * and copied to
476 *
477 * \\dst_server\print$\{arch}\file
478 *
479 * to be added via setdriver-calls later.
480 * @param c A net_context structure
481 * @param mem_ctx A talloc-context
482 * @param cli_share_src A cli_state connected to source print$-share
483 * @param cli_share_dst A cli_state connected to destination print$-share
484 * @param file The file-name to be copied
485 * @param short_archi The name of the driver-architecture (short form)
486 *
487 * @return Normal NTSTATUS return.
488 **/
505 }
507 /* scroll through the file until we have the part
508 beyond archi_table.short_archi */
514 }
515 }
519 }
521 /* build source file name */
526 }
528 /* create destination file name */
532 }
535 /* finally copy the file */
538 }
540 /**
541 * Check for existing Architecture directory on a given server
542 *
543 * @param cli_share A cli_state connected to a print$-share
544 * @param short_archi The Architecture for the print-driver
545 *
546 * @return Normal NTSTATUS return.
547 **/
550 {
557 }
560 short_archi));
566 }
572 }
576 out:
579 }
581 /**
582 * Copy a print-driver (level 3) from one connected print$-share to another
583 * connected print$-share
584 *
585 * @param c A net_context structure
586 * @param mem_ctx A talloc-context
587 * @param cli_share_src A cli_state connected to a print$-share
588 * @param cli_share_dst A cli_state connected to a print$-share
589 * @param short_archi The Architecture for the print-driver
590 * @param i1 The DRIVER_INFO_3-struct
591 *
592 * @return Normal NTSTATUS return.
593 **/
601 {
607 }
641 }
642 }
645 }
647 /**
648 * net_spoolss-functions
649 * =====================
650 *
651 * the net_spoolss-functions aim to simplify spoolss-client-functions
652 * required during the migration-process wrt buffer-sizes, returned
653 * error-codes, etc.
654 *
655 * this greatly reduces the complexitiy of the migrate-functions.
656 *
657 **/
666 {
667 WERROR result;
669 /* enum printers */
672 flags,
673 name,
674 level,
676 num_printers,
677 info);
681 }
684 }
692 {
693 WERROR result;
694 fstring printername2;
703 /* open printer */
705 printername2,
706 access_required,
707 hnd);
709 /* be more verbose */
716 }
722 }
728 }
735 {
736 WERROR result;
738 /* getprinter call */
740 hnd,
741 level,
743 info);
747 }
750 }
757 {
759 WERROR result;
760 NTSTATUS status;
769 /* setprinter call */
814 #endif
817 }
820 hnd,
829 }
833 }
836 }
846 {
848 WERROR result;
849 NTSTATUS status;
851 /* setprinterdata call */
853 hnd,
854 value_name,
855 type,
856 data,
857 offered,
863 }
868 }
871 }
879 {
880 WERROR result;
882 /* enumprinterkey call */
888 }
891 }
900 {
901 WERROR result;
903 /* enumprinterdataex call */
905 hnd,
906 keyname,
908 count,
909 info);
914 }
917 }
925 {
927 WERROR result;
928 NTSTATUS status;
930 /* setprinterdataex call */
932 hnd,
933 keyname,
943 }
948 }
951 }
959 {
960 WERROR result;
962 /* enumforms call */
964 hnd,
965 level,
967 num_forms,
968 forms);
972 }
975 }
982 {
983 WERROR result;
985 /* enumprinterdrivers call */
988 env,
989 level,
991 count,
992 info);
1000 env);
1001 }
1002 }
1005 }
1012 {
1013 WERROR result;
1017 /* getprinterdriver call */
1019 hnd,
1020 env,
1021 level,
1023 version,
1025 info,
1035 }
1037 }
1040 }
1046 {
1048 WERROR result;
1049 NTSTATUS status;
1066 }
1068 /* addprinterdriver call */
1076 }
1077 /* be more verbose */
1081 }
1085 }
1088 }
1090 /**
1091 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1092 * for a single printer or for all printers depending on argc/argv
1093 **/
1102 {
1105 WERROR werr;
1107 /* no arguments given, enumerate all printers */
1116 }
1118 /* argument given, get a single printer by name */
1120 MAXIMUM_ALLOWED_ACCESS,
1128 }
1133 }
1139 out:
1144 }
1146 /**
1147 * List print-queues (including local printers that are not shared)
1148 *
1149 * All parameters are provided by the run_rpc_command function, except for
1150 * argc, argv which are passed through.
1151 *
1152 * @param c A net_context structure
1153 * @param domain_sid The domain sid aquired from the remote server
1154 * @param cli A cli_state connected to the server.
1155 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1156 * @param argc Standard main() style argc
1157 * @param argv Standard main() style argv. Initial components are already
1158 * stripped
1159 *
1160 * @return Normal NTSTATUS return.
1161 **/
1171 {
1185 /* do some initialization */
1192 }
1193 }
1196 }
1198 /**
1199 * List printer-drivers from a server
1200 *
1201 * All parameters are provided by the run_rpc_command function, except for
1202 * argc, argv which are passed through.
1203 *
1204 * @param c A net_context structure
1205 * @param domain_sid The domain sid aquired from the remote server
1206 * @param cli A cli_state connected to the server.
1207 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1208 * @param argc Standard main() style argc
1209 * @param argv Standard main() style argv. Initial components are already
1210 * stripped
1211 *
1212 * @return Normal NTSTATUS return.
1213 **/
1223 {
1236 /* enum remote drivers */
1242 }
1249 }
1255 /* do something for all drivers for architecture */
1258 }
1259 }
1263 done:
1266 }
1268 /**
1269 * Publish print-queues with args-wrapper
1270 *
1271 * @param cli A cli_state connected to the server.
1272 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1273 * @param argc Standard main() style argc
1274 * @param argv Standard main() style argv. Initial components are already
1275 * stripped
1276 * @param action
1277 *
1278 * @return Normal NTSTATUS return.
1279 **/
1286 {
1298 WERROR result;
1306 /* do some initialization */
1311 }
1313 /* open printer handle */
1318 /* check for existing dst printer */
1322 /* check action and set string */
1337 }
1358 }
1365 }
1368 }
1372 }
1376 done:
1379 }
1382 }
1392 {
1394 }
1404 {
1406 }
1416 {
1418 }
1420 /**
1421 * List print-queues w.r.t. their publishing state
1422 *
1423 * All parameters are provided by the run_rpc_command function, except for
1424 * argc, argv which are passed through.
1425 *
1426 * @param c A net_context structure
1427 * @param domain_sid The domain sid aquired from the remote server
1428 * @param cli A cli_state connected to the server.
1429 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1430 * @param argc Standard main() style argc
1431 * @param argv Standard main() style argv. Initial components are already
1432 * stripped
1433 *
1434 * @return Normal NTSTATUS return.
1435 **/
1445 {
1455 WERROR werr;
1462 /* do some initialization */
1468 }
1470 /* open printer handle */
1475 /* check for existing dst printer */
1481 }
1486 sharename);
1493 sharename);
1497 sharename);
1502 }
1503 }
1507 done:
1510 }
1513 }
1515 /**
1516 * Migrate Printer-ACLs from a source server to the destination server
1517 *
1518 * All parameters are provided by the run_rpc_command function, except for
1519 * argc, argv which are passed through.
1520 *
1521 * @param c A net_context structure
1522 * @param domain_sid The domain sid aquired from the remote server
1523 * @param cli A cli_state connected to the server.
1524 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1525 * @param argc Standard main() style argc
1526 * @param argv Standard main() style argv. Initial components are already
1527 * stripped
1528 *
1529 * @return Normal NTSTATUS return.
1530 **/
1540 {
1542 /* TODO: what now, info2 or info3 ?
1543 convince jerry that we should add clientside setacls level 3 at least
1544 */
1556 WERROR werr;
1560 /* connect destination PI_SPOOLSS */
1565 }
1568 /* enum source printers */
1572 }
1578 }
1580 /* do something for all printers */
1583 /* do some initialization */
1590 }
1592 /* we can reset NT_STATUS here because we do not
1593 get any real NT_STATUS-codes anymore from now on */
1599 /* according to msdn you have specify these access-rights
1600 to see the security descriptor
1601 - READ_CONTROL (DACL)
1602 - ACCESS_SYSTEM_SECURITY (SACL)
1603 */
1605 /* open src printer handle */
1610 /* open dst printer handle */
1615 /* check for existing dst printer */
1619 /* check for existing src printer */
1623 /* Copy Security Descriptor */
1625 /* copy secdesc (info level 2) */
1638 /* close printer handles here */
1641 }
1645 }
1647 }
1651 done:
1655 }
1659 }
1663 }
1665 }
1667 /**
1668 * Migrate printer-forms from a src server to the dst server
1669 *
1670 * All parameters are provided by the run_rpc_command function, except for
1671 * argc, argv which are passed through.
1672 *
1673 * @param c A net_context structure
1674 * @param domain_sid The domain sid aquired from the remote server
1675 * @param cli A cli_state connected to the server.
1676 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1677 * @param argc Standard main() style argc
1678 * @param argv Standard main() style argv. Initial components are already
1679 * stripped
1680 *
1681 * @return Normal NTSTATUS return.
1682 **/
1692 {
1695 WERROR result;
1711 /* connect destination PI_SPOOLSS */
1716 }
1719 /* enum src printers */
1723 }
1729 }
1731 /* do something for all printers */
1734 /* do some initialization */
1741 }
1742 /* we can reset NT_STATUS here because we do not
1743 get any real NT_STATUS-codes anymore from now on */
1750 /* open src printer handle */
1755 /* open dst printer handle */
1760 /* check for existing dst printer */
1764 /* finally migrate forms */
1774 NTSTATUS status;
1776 /* only migrate FORM_PRINTER types, according to jerry
1777 FORM_BUILTIN-types are hard-coded in samba */
1790 /* FIXME: there might be something wrong with samba's
1791 builtin-forms */
1795 info,
1801 }
1806 }
1810 }
1813 /* close printer handles here */
1816 }
1820 }
1821 }
1825 done:
1829 }
1833 }
1837 }
1839 }
1841 /**
1842 * Migrate printer-drivers from a src server to the dst server
1843 *
1844 * All parameters are provided by the run_rpc_command function, except for
1845 * argc, argv which are passed through.
1846 *
1847 * @param c A net_context structure
1848 * @param domain_sid The domain sid aquired from the remote server
1849 * @param cli A cli_state connected to the server.
1850 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1851 * @param argc Standard main() style argc
1852 * @param argv Standard main() style argv. Initial components are already
1853 * stripped
1854 *
1855 * @return Normal NTSTATUS return.
1856 **/
1866 {
1885 WERROR werr;
1893 }
1896 /* open print$-share on the src server */
1905 /* open print$-share on the dst server */
1914 /* enum src printers */
1918 }
1924 }
1927 /* do something for all printers */
1930 /* do some initialization */
1937 }
1939 /* we can reset NT_STATUS here because we do not
1940 get any real NT_STATUS-codes anymore from now on */
1946 /* open dst printer handle */
1951 /* check for existing dst printer */
1956 /* open src printer handle */
1958 MAXIMUM_ALLOWED_ACCESS,
1963 /* in a first step call getdriver for each shared printer (per arch)
1964 to get a list of all files that have to be copied */
1968 /* getdriver src */
1979 /* check arch dir */
1985 /* copy driver-files */
1993 /* adddriver dst */
1997 }
2002 }
2006 printername));
2008 }
2010 /* setdriver dst */
2016 }
2021 /* close dst */
2024 }
2026 /* close src */
2029 }
2030 }
2034 done:
2038 }
2040 /* close src */
2043 }
2047 }
2057 }
2059 /**
2060 * Migrate printer-queues from a src to the dst server
2061 * (requires a working "addprinter command" to be installed for the local smbd)
2062 *
2063 * All parameters are provided by the run_rpc_command function, except for
2064 * argc, argv which are passed through.
2065 *
2066 * @param c A net_context structure
2067 * @param domain_sid The domain sid aquired from the remote server
2068 * @param cli A cli_state connected to the server.
2069 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2070 * @param argc Standard main() style argc
2071 * @param argv Standard main() style argv. Initial components are already
2072 * stripped
2073 *
2074 * @return Normal NTSTATUS return.
2075 **/
2085 {
2087 WERROR result;
2102 /* connect destination PI_SPOOLSS */
2107 }
2110 /* enum printers */
2114 }
2120 }
2122 /* do something for all printers */
2127 /* do some initialization */
2134 }
2135 /* we can reset NT_STATUS here because we do not
2136 get any real NT_STATUS-codes anymore from now on */
2142 /* open dst printer handle */
2147 }
2149 /* check for existing dst printer */
2154 /* close printer handle here - dst only, not got src yet. */
2157 }
2159 }
2161 /* now get again src printer ctr via getprinter,
2162 we first need a handle for that */
2164 /* open src printer handle */
2169 /* getprinter on the src server */
2173 /* copy each src printer to a dst printer 1:1,
2174 maybe some values have to be changed though */
2182 mem_ctx,
2187 printername);
2190 printername);
2193 printername);
2195 }
2197 /* close printer handles here */
2200 }
2204 }
2205 }
2209 done:
2212 }
2216 }
2220 }
2222 }
2224 /**
2225 * Migrate Printer-Settings from a src server to the dst server
2226 * (for this to work, printers and drivers already have to be migrated earlier)
2227 *
2228 * All parameters are provided by the run_rpc_command function, except for
2229 * argc, argv which are passed through.
2230 *
2231 * @param c A net_context structure
2232 * @param domain_sid The domain sid aquired from the remote server
2233 * @param cli A cli_state connected to the server.
2234 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2235 * @param argc Standard main() style argc
2236 * @param argv Standard main() style argv. Initial components are already
2237 * stripped
2238 *
2239 * @return Normal NTSTATUS return.
2240 **/
2250 {
2253 /* FIXME: Here the nightmare begins */
2255 WERROR result;
2272 /* FIXME GD */
2277 /* connect destination PI_SPOOLSS */
2282 }
2285 /* enum src printers */
2289 }
2295 }
2298 /* needed for dns-strings in regkeys */
2303 }
2305 /* do something for all printers */
2313 /* do some initialization */
2320 }
2321 /* we can reset NT_STATUS here because we do not
2322 get any real NT_STATUS-codes anymore from now on */
2329 /* open src printer handle */
2334 /* open dst printer handle */
2339 /* check for existing dst printer */
2345 /* STEP 1: COPY DEVICE-MODE and other
2346 PRINTER_INFO_2-attributes
2347 */
2351 /* why is the port always disconnected when the printer
2352 is correctly installed (incl. driver ???) */
2355 /* check if printer is published */
2358 /* check for existing dst printer */
2364 /* ignore false from setprinter due to WERR_IO_PENDING */
2368 }
2372 /* copy devmode (info level 2) */
2375 /* do not copy security descriptor (we have another
2376 * command for that) */
2379 #if 0
2386 }
2387 #endif
2393 }
2395 /* STEP 2: COPY REGISTRY VALUES */
2397 /* please keep in mind that samba parse_spools gives horribly
2398 crippled results when used to rpccli_spoolss_enumprinterdataex
2399 a win2k3-server. (Bugzilla #1851)
2400 FIXME: IIRC I've seen it too on a win2k-server
2401 */
2413 /* enumerate data on src handle */
2421 /* loop for all printerdata of "PrinterDriverData" */
2428 /* loop for all reg_keys */
2431 /* display_value */
2443 }
2447 }
2449 /* set_value */
2457 }
2458 }
2460 /* STEP 3: COPY SUBKEY VALUES */
2462 /* here we need to enum all printer_keys and then work
2463 on the result with enum_printer_key_ex. nt4 does not
2464 respond to enumprinterkey, win2k does, so continue
2465 in case of an error */
2470 }
2473 /* work on a list of printer keys
2474 each key has to be enumerated to get all required
2475 information. information is then set via setprinterdataex-calls */
2486 /* enumerate all src subkeys */
2491 }
2496 DATA_BLOB blob;
2500 /* although samba replies with sane data in most cases we
2501 should try to avoid writing wrong registry data */
2511 /* although windows uses a multi-sz, we use a sz */
2513 }
2520 }
2522 }
2528 #if 0
2529 /* FIXME: should we really do that ??? */
2533 }
2536 #endif
2537 }
2542 }
2547 }
2551 REG_SZ,
2557 }
2562 /* here we have to set all subkeys on the dst server */
2565 {
2568 }
2583 }
2587 }
2589 /* here we have to set all subkeys on the dst server */
2593 }
2596 }
2601 }
2602 }
2606 /* close printer handles here */
2609 }
2613 }
2614 }
2618 done:
2625 }
2629 }
2633 }
2635 }