| blob | 0ab08efcc0a1981e575c3d4ea1aab684eb11f5ac |
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 */
33 /* support itanium as well */
45 };
48 /**
49 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
50 * It is here for debugging purpose and should be removed later on.
51 **/
53 /****************************************************************************
54 Printer info level 3 display function.
55 ****************************************************************************/
58 {
63 }
76 }
82 }
84 static void display_reg_value(const char *subkey, const char *name, struct registry_value *value)
85 {
95 name);
96 }
103 }
120 }
125 }
128 }
132 }
134 }
136 /**
137 * Copies ACLs, DOS-attributes and timestamps from one
138 * file or directory from one connected share to another connected share
139 *
140 * @param c A net_context structure
141 * @param mem_ctx A talloc-context
142 * @param cli_share_src A connected cli_state
143 * @param cli_share_dst A connected cli_state
144 * @param src_file The source file-name
145 * @param dst_file The destination file-name
146 * @param copy_acls Whether to copy acls
147 * @param copy_attrs Whether to copy DOS attributes
148 * @param copy_timestamps Whether to preserve timestamps
149 * @param is_file Whether this file is a file or a dir
150 *
151 * @return Normal NTSTATUS return.
152 **/
161 {
162 NTSTATUS nt_status;
172 /* open file/dir on the originating server */
185 }
188 /* get the security descriptor */
195 }
199 }
203 /* get file attributes */
210 }
211 }
213 /* open the file/dir on the destination server */
222 }
225 /* set timestamps */
231 }
232 }
235 /* set acls */
241 }
242 }
245 /* set attrs */
251 }
252 }
255 /* closing files */
262 }
270 }
275 out:
277 /* cleaning up */
285 }
287 /**
288 * Copy a file or directory from a connected share to another connected share
289 *
290 * @param c A net_context structure
291 * @param mem_ctx A talloc-context
292 * @param cli_share_src A connected cli_state
293 * @param cli_share_dst A connected cli_state
294 * @param src_file The source file-name
295 * @param dst_file The destination file-name
296 * @param copy_acls Whether to copy acls
297 * @param copy_attrs Whether to copy DOS attributes
298 * @param copy_timestamps Whether to preserve timestamps
299 * @param is_file Whether this file is a file or a dir
300 *
301 * @return Normal NTSTATUS return.
302 **/
311 {
327 /* open on the originating server */
332 else
341 }
346 /* open file on the destination server */
355 }
357 /* allocate memory */
360 read_size);
363 }
365 }
379 }
384 /* copying file */
396 }
411 }
414 }
419 /* creating dir */
421 dst_name));
428 }
437 }
438 }
441 /* closing files */
448 }
457 }
458 }
460 /* possibly we have to copy some file-attributes / acls / sd */
470 out:
472 /* cleaning up */
482 }
484 /**
485 * Copy a driverfile from on connected share to another connected share
486 * This silently assumes that a driver-file is picked up from
487 *
488 * \\src_server\print$\{arch}\{version}\file
489 *
490 * and copied to
491 *
492 * \\dst_server\print$\{arch}\file
493 *
494 * to be added via setdriver-calls later.
495 * @param c A net_context structure
496 * @param mem_ctx A talloc-context
497 * @param cli_share_src A cli_state connected to source print$-share
498 * @param cli_share_dst A cli_state connected to destination print$-share
499 * @param file The file-name to be copied
500 * @param short_archi The name of the driver-architecture (short form)
501 *
502 * @return Normal NTSTATUS return.
503 **/
520 }
522 /* scroll through the file until we have the part
523 beyond archi_table.short_archi */
529 }
530 }
534 }
536 /* build source file name */
541 }
543 /* create destination file name */
547 }
550 /* finally copy the file */
553 }
555 /**
556 * Check for existing Architecture directory on a given server
557 *
558 * @param cli_share A cli_state connected to a print$-share
559 * @param short_archi The Architecture for the print-driver
560 *
561 * @return Normal NTSTATUS return.
562 **/
565 {
572 }
575 short_archi));
581 }
588 }
592 out:
595 }
597 /**
598 * Copy a print-driver (level 3) from one connected print$-share to another
599 * connected print$-share
600 *
601 * @param c A net_context structure
602 * @param mem_ctx A talloc-context
603 * @param cli_share_src A cli_state connected to a print$-share
604 * @param cli_share_dst A cli_state connected to a print$-share
605 * @param short_archi The Architecture for the print-driver
606 * @param i1 The DRIVER_INFO_3-struct
607 *
608 * @return Normal NTSTATUS return.
609 **/
617 {
623 }
657 }
658 }
661 }
663 /**
664 * net_spoolss-functions
665 * =====================
666 *
667 * the net_spoolss-functions aim to simplify spoolss-client-functions
668 * required during the migration-process wrt buffer-sizes, returned
669 * error-codes, etc.
670 *
671 * this greatly reduces the complexitiy of the migrate-functions.
672 *
673 **/
682 {
683 WERROR result;
685 /* enum printers */
688 flags,
689 name,
690 level,
692 num_printers,
693 info);
697 }
700 }
708 {
709 WERROR result;
710 fstring printername2;
719 /* open printer */
721 printername2,
722 access_required,
723 hnd);
725 /* be more verbose */
732 }
738 }
744 }
751 {
752 WERROR result;
754 /* getprinter call */
756 hnd,
757 level,
759 info);
763 }
766 }
773 {
775 WERROR result;
776 NTSTATUS status;
785 /* setprinter call */
830 #endif
833 }
836 hnd,
845 }
849 }
852 }
862 {
864 WERROR result;
865 NTSTATUS status;
867 /* setprinterdata call */
869 hnd,
870 value_name,
871 type,
872 data,
873 offered,
879 }
884 }
887 }
895 {
896 WERROR result;
898 /* enumprinterkey call */
904 }
907 }
916 {
917 WERROR result;
919 /* enumprinterdataex call */
921 hnd,
922 keyname,
924 count,
925 info);
930 }
933 }
942 {
944 WERROR result;
945 NTSTATUS status;
947 /* setprinterdataex call */
949 hnd,
950 keyname,
951 name,
960 }
965 }
968 }
976 {
977 WERROR result;
979 /* enumforms call */
981 hnd,
982 level,
984 num_forms,
985 forms);
989 }
992 }
999 {
1000 WERROR result;
1002 /* enumprinterdrivers call */
1005 env,
1006 level,
1008 count,
1009 info);
1017 env);
1018 }
1019 }
1022 }
1029 {
1030 WERROR result;
1034 /* getprinterdriver call */
1036 hnd,
1037 env,
1038 level,
1040 version,
1042 info,
1052 }
1054 }
1057 }
1063 {
1065 WERROR result;
1066 NTSTATUS status;
1083 }
1085 /* addprinterdriver call */
1093 }
1094 /* be more verbose */
1098 }
1102 }
1105 }
1107 /**
1108 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1109 * for a single printer or for all printers depending on argc/argv
1110 **/
1119 {
1122 WERROR werr;
1124 /* no arguments given, enumerate all printers */
1133 }
1135 /* argument given, get a single printer by name */
1137 MAXIMUM_ALLOWED_ACCESS,
1145 }
1150 }
1156 out:
1161 }
1163 /**
1164 * List print-queues (including local printers that are not shared)
1165 *
1166 * All parameters are provided by the run_rpc_command function, except for
1167 * argc, argv which are passed through.
1168 *
1169 * @param c A net_context structure
1170 * @param domain_sid The domain sid aquired from the remote server
1171 * @param cli A cli_state connected to the server.
1172 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1173 * @param argc Standard main() style argc
1174 * @param argv Standard main() style argv. Initial components are already
1175 * stripped
1176 *
1177 * @return Normal NTSTATUS return.
1178 **/
1188 {
1202 /* do some initialization */
1209 }
1210 }
1213 }
1215 /**
1216 * List printer-drivers from a server
1217 *
1218 * All parameters are provided by the run_rpc_command function, except for
1219 * argc, argv which are passed through.
1220 *
1221 * @param c A net_context structure
1222 * @param domain_sid The domain sid aquired from the remote server
1223 * @param cli A cli_state connected to the server.
1224 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1225 * @param argc Standard main() style argc
1226 * @param argv Standard main() style argv. Initial components are already
1227 * stripped
1228 *
1229 * @return Normal NTSTATUS return.
1230 **/
1240 {
1253 /* enum remote drivers */
1259 }
1266 }
1272 /* do something for all drivers for architecture */
1275 }
1276 }
1280 done:
1283 }
1285 /**
1286 * Publish print-queues with args-wrapper
1287 *
1288 * @param cli A cli_state connected to the server.
1289 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1290 * @param argc Standard main() style argc
1291 * @param argv Standard main() style argv. Initial components are already
1292 * stripped
1293 * @param action
1294 *
1295 * @return Normal NTSTATUS return.
1296 **/
1303 {
1315 WERROR result;
1323 /* do some initialization */
1328 }
1330 /* open printer handle */
1335 /* check for existing dst printer */
1339 /* check action and set string */
1354 }
1375 }
1382 }
1385 }
1389 }
1393 done:
1396 }
1399 }
1409 {
1411 }
1421 {
1423 }
1433 {
1435 }
1437 /**
1438 * List print-queues w.r.t. their publishing state
1439 *
1440 * All parameters are provided by the run_rpc_command function, except for
1441 * argc, argv which are passed through.
1442 *
1443 * @param c A net_context structure
1444 * @param domain_sid The domain sid aquired from the remote server
1445 * @param cli A cli_state connected to the server.
1446 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1447 * @param argc Standard main() style argc
1448 * @param argv Standard main() style argv. Initial components are already
1449 * stripped
1450 *
1451 * @return Normal NTSTATUS return.
1452 **/
1462 {
1472 WERROR werr;
1479 /* do some initialization */
1485 }
1487 /* open printer handle */
1492 /* check for existing dst printer */
1498 }
1503 sharename);
1510 sharename);
1514 sharename);
1519 }
1520 }
1524 done:
1527 }
1530 }
1532 /**
1533 * Migrate Printer-ACLs from a source server to the destination server
1534 *
1535 * All parameters are provided by the run_rpc_command function, except for
1536 * argc, argv which are passed through.
1537 *
1538 * @param c A net_context structure
1539 * @param domain_sid The domain sid aquired from the remote server
1540 * @param cli A cli_state connected to the server.
1541 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1542 * @param argc Standard main() style argc
1543 * @param argv Standard main() style argv. Initial components are already
1544 * stripped
1545 *
1546 * @return Normal NTSTATUS return.
1547 **/
1557 {
1559 /* TODO: what now, info2 or info3 ?
1560 convince jerry that we should add clientside setacls level 3 at least
1561 */
1574 WERROR werr;
1578 /* connect destination PI_SPOOLSS */
1583 }
1586 /* enum source printers */
1590 }
1596 }
1598 /* do something for all printers */
1601 /* do some initialization */
1608 }
1610 /* we can reset NT_STATUS here because we do not
1611 get any real NT_STATUS-codes anymore from now on */
1617 /* according to msdn you have specify these access-rights
1618 to see the security descriptor
1619 - READ_CONTROL (DACL)
1620 - ACCESS_SYSTEM_SECURITY (SACL)
1621 */
1623 /* open src printer handle */
1628 /* open dst printer handle */
1633 /* check for existing dst printer */
1637 /* check for existing src printer */
1641 /* Copy Security Descriptor */
1643 /* copy secdesc (info level 2) */
1656 /* close printer handles here */
1659 }
1663 }
1665 }
1669 done:
1673 }
1677 }
1681 }
1683 }
1685 /**
1686 * Migrate printer-forms from a src server to the dst server
1687 *
1688 * All parameters are provided by the run_rpc_command function, except for
1689 * argc, argv which are passed through.
1690 *
1691 * @param c A net_context structure
1692 * @param domain_sid The domain sid aquired from the remote server
1693 * @param cli A cli_state connected to the server.
1694 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1695 * @param argc Standard main() style argc
1696 * @param argv Standard main() style argv. Initial components are already
1697 * stripped
1698 *
1699 * @return Normal NTSTATUS return.
1700 **/
1710 {
1713 WERROR result;
1730 /* connect destination PI_SPOOLSS */
1735 }
1738 /* enum src printers */
1742 }
1748 }
1750 /* do something for all printers */
1753 /* do some initialization */
1760 }
1761 /* we can reset NT_STATUS here because we do not
1762 get any real NT_STATUS-codes anymore from now on */
1769 /* open src printer handle */
1774 /* open dst printer handle */
1779 /* check for existing dst printer */
1783 /* finally migrate forms */
1793 NTSTATUS status;
1795 /* only migrate FORM_PRINTER types, according to jerry
1796 FORM_BUILTIN-types are hard-coded in samba */
1809 /* FIXME: there might be something wrong with samba's
1810 builtin-forms */
1814 info,
1820 }
1825 }
1829 }
1832 /* close printer handles here */
1835 }
1839 }
1840 }
1844 done:
1848 }
1852 }
1856 }
1858 }
1860 /**
1861 * Migrate printer-drivers from a src server to the dst server
1862 *
1863 * All parameters are provided by the run_rpc_command function, except for
1864 * argc, argv which are passed through.
1865 *
1866 * @param c A net_context structure
1867 * @param domain_sid The domain sid aquired from the remote server
1868 * @param cli A cli_state connected to the server.
1869 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1870 * @param argc Standard main() style argc
1871 * @param argv Standard main() style argv. Initial components are already
1872 * stripped
1873 *
1874 * @return Normal NTSTATUS return.
1875 **/
1885 {
1905 WERROR werr;
1913 }
1916 /* open print$-share on the src server */
1927 /* open print$-share on the dst server */
1938 /* enum src printers */
1942 }
1948 }
1951 /* do something for all printers */
1954 /* do some initialization */
1961 }
1963 /* we can reset NT_STATUS here because we do not
1964 get any real NT_STATUS-codes anymore from now on */
1970 /* open dst printer handle */
1975 /* check for existing dst printer */
1980 /* open src printer handle */
1982 MAXIMUM_ALLOWED_ACCESS,
1987 /* in a first step call getdriver for each shared printer (per arch)
1988 to get a list of all files that have to be copied */
1992 /* getdriver src */
2003 /* check arch dir */
2009 /* copy driver-files */
2017 /* adddriver dst */
2021 }
2026 }
2030 printername));
2032 }
2034 /* setdriver dst */
2040 }
2045 /* close dst */
2048 }
2050 /* close src */
2053 }
2054 }
2058 done:
2062 }
2064 /* close src */
2067 }
2071 }
2081 }
2083 /**
2084 * Migrate printer-queues from a src to the dst server
2085 * (requires a working "addprinter command" to be installed for the local smbd)
2086 *
2087 * All parameters are provided by the run_rpc_command function, except for
2088 * argc, argv which are passed through.
2089 *
2090 * @param c A net_context structure
2091 * @param domain_sid The domain sid aquired from the remote server
2092 * @param cli A cli_state connected to the server.
2093 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2094 * @param argc Standard main() style argc
2095 * @param argv Standard main() style argv. Initial components are already
2096 * stripped
2097 *
2098 * @return Normal NTSTATUS return.
2099 **/
2109 {
2111 WERROR result;
2127 /* connect destination PI_SPOOLSS */
2132 }
2135 /* enum printers */
2139 }
2145 }
2147 /* do something for all printers */
2152 /* do some initialization */
2159 }
2160 /* we can reset NT_STATUS here because we do not
2161 get any real NT_STATUS-codes anymore from now on */
2167 /* open dst printer handle */
2172 }
2174 /* check for existing dst printer */
2179 /* close printer handle here - dst only, not got src yet. */
2182 }
2184 }
2186 /* now get again src printer ctr via getprinter,
2187 we first need a handle for that */
2189 /* open src printer handle */
2194 /* getprinter on the src server */
2198 /* copy each src printer to a dst printer 1:1,
2199 maybe some values have to be changed though */
2207 mem_ctx,
2212 printername);
2215 printername);
2218 printername);
2220 }
2222 /* close printer handles here */
2225 }
2229 }
2230 }
2234 done:
2237 }
2241 }
2245 }
2247 }
2249 /**
2250 * Migrate Printer-Settings from a src server to the dst server
2251 * (for this to work, printers and drivers already have to be migrated earlier)
2252 *
2253 * All parameters are provided by the run_rpc_command function, except for
2254 * argc, argv which are passed through.
2255 *
2256 * @param c A net_context structure
2257 * @param domain_sid The domain sid aquired from the remote server
2258 * @param cli A cli_state connected to the server.
2259 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2260 * @param argc Standard main() style argc
2261 * @param argv Standard main() style argv. Initial components are already
2262 * stripped
2263 *
2264 * @return Normal NTSTATUS return.
2265 **/
2275 {
2278 /* FIXME: Here the nightmare begins */
2280 WERROR result;
2297 /* FIXME GD */
2302 /* connect destination PI_SPOOLSS */
2307 }
2310 /* enum src printers */
2314 }
2320 }
2323 /* needed for dns-strings in regkeys */
2328 }
2330 /* do something for all printers */
2338 /* do some initialization */
2345 }
2346 /* we can reset NT_STATUS here because we do not
2347 get any real NT_STATUS-codes anymore from now on */
2354 /* open src printer handle */
2359 /* open dst printer handle */
2364 /* check for existing dst printer */
2370 /* STEP 1: COPY DEVICE-MODE and other
2371 PRINTER_INFO_2-attributes
2372 */
2376 /* why is the port always disconnected when the printer
2377 is correctly installed (incl. driver ???) */
2380 /* check if printer is published */
2383 /* check for existing dst printer */
2389 /* ignore false from setprinter due to WERR_IO_PENDING */
2393 }
2397 /* copy devmode (info level 2) */
2400 /* do not copy security descriptor (we have another
2401 * command for that) */
2404 #if 0
2411 }
2412 #endif
2418 }
2420 /* STEP 2: COPY REGISTRY VALUES */
2422 /* please keep in mind that samba parse_spools gives horribly
2423 crippled results when used to rpccli_spoolss_enumprinterdataex
2424 a win2k3-server. (Bugzilla #1851)
2425 FIXME: IIRC I've seen it too on a win2k-server
2426 */
2438 /* enumerate data on src handle */
2446 /* loop for all printerdata of "PrinterDriverData" */
2453 /* loop for all reg_keys */
2456 /* display_value */
2465 }
2467 /* set_value */
2475 }
2476 }
2478 /* STEP 3: COPY SUBKEY VALUES */
2480 /* here we need to enum all printer_keys and then work
2481 on the result with enum_printer_key_ex. nt4 does not
2482 respond to enumprinterkey, win2k does, so continue
2483 in case of an error */
2488 }
2491 /* work on a list of printer keys
2492 each key has to be enumerated to get all required
2493 information. information is then set via setprinterdataex-calls */
2504 /* enumerate all src subkeys */
2509 }
2517 /* although samba replies with sane data in most cases we
2518 should try to avoid writing wrong registry data */
2521 /* although windows uses a multi-sz, we use a sz */
2523 }
2529 }
2532 }
2535 #if 0
2536 /* FIXME: should we really do that ??? */
2540 }
2543 #endif
2544 }
2547 }
2550 }
2554 }
2558 }
2560 /* here we have to set all subkeys on the dst server */
2563 {
2565 }
2570 }
2571 }
2575 /* close printer handles here */
2578 }
2582 }
2583 }
2587 done:
2590 }
2594 }
2598 }
2600 }