| blob | 7ff838675ed03b80fcc8182e336c4d0993f794cb |
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 */
1819 }
1824 }
1828 }
1831 /* close printer handles here */
1834 }
1838 }
1839 }
1843 done:
1847 }
1851 }
1855 }
1857 }
1859 /**
1860 * Migrate printer-drivers from a src server to the dst server
1861 *
1862 * All parameters are provided by the run_rpc_command function, except for
1863 * argc, argv which are passed through.
1864 *
1865 * @param c A net_context structure
1866 * @param domain_sid The domain sid aquired from the remote server
1867 * @param cli A cli_state connected to the server.
1868 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1869 * @param argc Standard main() style argc
1870 * @param argv Standard main() style argv. Initial components are already
1871 * stripped
1872 *
1873 * @return Normal NTSTATUS return.
1874 **/
1884 {
1904 WERROR werr;
1912 }
1915 /* open print$-share on the src server */
1926 /* open print$-share on the dst server */
1937 /* enum src printers */
1941 }
1947 }
1950 /* do something for all printers */
1953 /* do some initialization */
1960 }
1962 /* we can reset NT_STATUS here because we do not
1963 get any real NT_STATUS-codes anymore from now on */
1969 /* open dst printer handle */
1974 /* check for existing dst printer */
1979 /* open src printer handle */
1981 MAXIMUM_ALLOWED_ACCESS,
1986 /* in a first step call getdriver for each shared printer (per arch)
1987 to get a list of all files that have to be copied */
1991 /* getdriver src */
2002 /* check arch dir */
2008 /* copy driver-files */
2016 /* adddriver dst */
2020 }
2025 }
2029 printername));
2031 }
2033 /* setdriver dst */
2039 }
2044 /* close dst */
2047 }
2049 /* close src */
2052 }
2053 }
2057 done:
2061 }
2063 /* close src */
2066 }
2070 }
2080 }
2082 /**
2083 * Migrate printer-queues from a src to the dst server
2084 * (requires a working "addprinter command" to be installed for the local smbd)
2085 *
2086 * All parameters are provided by the run_rpc_command function, except for
2087 * argc, argv which are passed through.
2088 *
2089 * @param c A net_context structure
2090 * @param domain_sid The domain sid aquired from the remote server
2091 * @param cli A cli_state connected to the server.
2092 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2093 * @param argc Standard main() style argc
2094 * @param argv Standard main() style argv. Initial components are already
2095 * stripped
2096 *
2097 * @return Normal NTSTATUS return.
2098 **/
2108 {
2110 WERROR result;
2126 /* connect destination PI_SPOOLSS */
2131 }
2134 /* enum printers */
2138 }
2144 }
2146 /* do something for all printers */
2151 /* do some initialization */
2158 }
2159 /* we can reset NT_STATUS here because we do not
2160 get any real NT_STATUS-codes anymore from now on */
2166 /* open dst printer handle */
2171 }
2173 /* check for existing dst printer */
2178 /* close printer handle here - dst only, not got src yet. */
2181 }
2183 }
2185 /* now get again src printer ctr via getprinter,
2186 we first need a handle for that */
2188 /* open src printer handle */
2193 /* getprinter on the src server */
2197 /* copy each src printer to a dst printer 1:1,
2198 maybe some values have to be changed though */
2206 mem_ctx,
2211 printername);
2214 printername);
2217 printername);
2219 }
2221 /* close printer handles here */
2224 }
2228 }
2229 }
2233 done:
2236 }
2240 }
2244 }
2246 }
2248 /**
2249 * Migrate Printer-Settings from a src server to the dst server
2250 * (for this to work, printers and drivers already have to be migrated earlier)
2251 *
2252 * All parameters are provided by the run_rpc_command function, except for
2253 * argc, argv which are passed through.
2254 *
2255 * @param c A net_context structure
2256 * @param domain_sid The domain sid aquired from the remote server
2257 * @param cli A cli_state connected to the server.
2258 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2259 * @param argc Standard main() style argc
2260 * @param argv Standard main() style argv. Initial components are already
2261 * stripped
2262 *
2263 * @return Normal NTSTATUS return.
2264 **/
2274 {
2277 /* FIXME: Here the nightmare begins */
2279 WERROR result;
2296 /* FIXME GD */
2301 /* connect destination PI_SPOOLSS */
2306 }
2309 /* enum src printers */
2313 }
2319 }
2322 /* needed for dns-strings in regkeys */
2327 }
2329 /* do something for all printers */
2337 /* do some initialization */
2344 }
2345 /* we can reset NT_STATUS here because we do not
2346 get any real NT_STATUS-codes anymore from now on */
2353 /* open src printer handle */
2358 /* open dst printer handle */
2363 /* check for existing dst printer */
2369 /* STEP 1: COPY DEVICE-MODE and other
2370 PRINTER_INFO_2-attributes
2371 */
2375 /* why is the port always disconnected when the printer
2376 is correctly installed (incl. driver ???) */
2379 /* check if printer is published */
2382 /* check for existing dst printer */
2388 /* ignore false from setprinter due to WERR_IO_PENDING */
2392 }
2396 /* copy devmode (info level 2) */
2399 /* do not copy security descriptor (we have another
2400 * command for that) */
2403 #if 0
2410 }
2411 #endif
2417 }
2419 /* STEP 2: COPY REGISTRY VALUES */
2421 /* please keep in mind that samba parse_spools gives horribly
2422 crippled results when used to rpccli_spoolss_enumprinterdataex
2423 a win2k3-server. (Bugzilla #1851)
2424 FIXME: IIRC I've seen it too on a win2k-server
2425 */
2437 /* enumerate data on src handle */
2445 /* loop for all printerdata of "PrinterDriverData" */
2452 /* loop for all reg_keys */
2455 /* display_value */
2464 }
2466 /* set_value */
2474 }
2475 }
2477 /* STEP 3: COPY SUBKEY VALUES */
2479 /* here we need to enum all printer_keys and then work
2480 on the result with enum_printer_key_ex. nt4 does not
2481 respond to enumprinterkey, win2k does, so continue
2482 in case of an error */
2487 }
2490 /* work on a list of printer keys
2491 each key has to be enumerated to get all required
2492 information. information is then set via setprinterdataex-calls */
2503 /* enumerate all src subkeys */
2508 }
2518 /* although samba replies with sane data in most cases we
2519 should try to avoid writing wrong registry data */
2522 /* although windows uses a multi-sz, we use a sz */
2527 }
2528 }
2534 }
2539 }
2541 }
2544 #if 0
2545 /* FIXME: should we really do that ??? */
2549 }
2552 #endif
2553 }
2559 }
2560 }
2566 }
2567 }
2571 }
2575 }
2577 /* here we have to set all subkeys on the dst server */
2580 {
2582 }
2587 }
2588 }
2592 /* close printer handles here */
2595 }
2599 }
2600 }
2604 done:
2607 }
2611 }
2615 }
2617 }