| blob | f5019af346039c735a58865ad5e28c0a33e0ef49 |
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 */
32 /* support itanium as well */
44 };
47 /**
48 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
49 * It is here for debugging purpose and should be removed later on.
50 **/
52 /****************************************************************************
53 Printer info level 3 display function.
54 ****************************************************************************/
57 {
62 }
75 }
81 }
84 {
86 DATA_BLOB blob;
99 }
101 text);
118 }
123 }
126 }
131 }
133 }
135 /**
136 * Copies ACLs, DOS-attributes and timestamps from one
137 * file or directory from one connected share to another connected share
138 *
139 * @param c A net_context structure
140 * @param mem_ctx A talloc-context
141 * @param cli_share_src A connected cli_state
142 * @param cli_share_dst A connected cli_state
143 * @param src_file The source file-name
144 * @param dst_file The destination file-name
145 * @param copy_acls Whether to copy acls
146 * @param copy_attrs Whether to copy DOS attributes
147 * @param copy_timestamps Whether to preserve timestamps
148 * @param is_file Whether this file is a file or a dir
149 *
150 * @return Normal NTSTATUS return.
151 **/
160 {
161 NTSTATUS nt_status;
171 /* open file/dir on the originating server */
184 }
187 /* get the security descriptor */
194 }
198 }
202 /* get file attributes */
209 }
210 }
212 /* open the file/dir on the destination server */
221 }
224 /* set timestamps */
230 }
231 }
234 /* set acls */
240 }
241 }
244 /* set attrs */
250 }
251 }
254 /* closing files */
261 }
269 }
274 out:
276 /* cleaning up */
284 }
286 /**
287 * Copy a file or directory from a connected share to another connected share
288 *
289 * @param c A net_context structure
290 * @param mem_ctx A talloc-context
291 * @param cli_share_src A connected cli_state
292 * @param cli_share_dst A connected cli_state
293 * @param src_file The source file-name
294 * @param dst_file The destination file-name
295 * @param copy_acls Whether to copy acls
296 * @param copy_attrs Whether to copy DOS attributes
297 * @param copy_timestamps Whether to preserve timestamps
298 * @param is_file Whether this file is a file or a dir
299 *
300 * @return Normal NTSTATUS return.
301 **/
310 {
326 /* open on the originating server */
331 else
340 }
345 /* open file on the destination server */
354 }
356 /* allocate memory */
359 read_size);
362 }
364 }
378 }
383 /* copying file */
395 }
410 }
413 }
418 /* creating dir */
420 dst_name));
427 }
436 }
437 }
440 /* closing files */
447 }
456 }
457 }
459 /* possibly we have to copy some file-attributes / acls / sd */
469 out:
471 /* cleaning up */
481 }
483 /**
484 * Copy a driverfile from on connected share to another connected share
485 * This silently assumes that a driver-file is picked up from
486 *
487 * \\src_server\print$\{arch}\{version}\file
488 *
489 * and copied to
490 *
491 * \\dst_server\print$\{arch}\file
492 *
493 * to be added via setdriver-calls later.
494 * @param c A net_context structure
495 * @param mem_ctx A talloc-context
496 * @param cli_share_src A cli_state connected to source print$-share
497 * @param cli_share_dst A cli_state connected to destination print$-share
498 * @param file The file-name to be copied
499 * @param short_archi The name of the driver-architecture (short form)
500 *
501 * @return Normal NTSTATUS return.
502 **/
519 }
521 /* scroll through the file until we have the part
522 beyond archi_table.short_archi */
528 }
529 }
533 }
535 /* build source file name */
540 }
542 /* create destination file name */
546 }
549 /* finally copy the file */
552 }
554 /**
555 * Check for existing Architecture directory on a given server
556 *
557 * @param cli_share A cli_state connected to a print$-share
558 * @param short_archi The Architecture for the print-driver
559 *
560 * @return Normal NTSTATUS return.
561 **/
564 {
571 }
574 short_archi));
580 }
587 }
591 out:
594 }
596 /**
597 * Copy a print-driver (level 3) from one connected print$-share to another
598 * connected print$-share
599 *
600 * @param c A net_context structure
601 * @param mem_ctx A talloc-context
602 * @param cli_share_src A cli_state connected to a print$-share
603 * @param cli_share_dst A cli_state connected to a print$-share
604 * @param short_archi The Architecture for the print-driver
605 * @param i1 The DRIVER_INFO_3-struct
606 *
607 * @return Normal NTSTATUS return.
608 **/
616 {
622 }
656 }
657 }
660 }
662 /**
663 * net_spoolss-functions
664 * =====================
665 *
666 * the net_spoolss-functions aim to simplify spoolss-client-functions
667 * required during the migration-process wrt buffer-sizes, returned
668 * error-codes, etc.
669 *
670 * this greatly reduces the complexitiy of the migrate-functions.
671 *
672 **/
681 {
682 WERROR result;
684 /* enum printers */
687 flags,
688 name,
689 level,
691 num_printers,
692 info);
696 }
699 }
707 {
708 WERROR result;
709 fstring printername2;
718 /* open printer */
720 printername2,
721 access_required,
722 hnd);
724 /* be more verbose */
731 }
737 }
743 }
750 {
751 WERROR result;
753 /* getprinter call */
755 hnd,
756 level,
758 info);
762 }
765 }
772 {
774 WERROR result;
775 NTSTATUS status;
784 /* setprinter call */
829 #endif
832 }
835 hnd,
844 }
848 }
851 }
861 {
863 WERROR result;
864 NTSTATUS status;
866 /* setprinterdata call */
868 hnd,
869 value_name,
870 type,
871 data,
872 offered,
878 }
883 }
886 }
894 {
895 WERROR result;
897 /* enumprinterkey call */
903 }
906 }
915 {
916 WERROR result;
918 /* enumprinterdataex call */
920 hnd,
921 keyname,
923 count,
924 info);
929 }
932 }
940 {
942 WERROR result;
943 NTSTATUS status;
945 /* setprinterdataex call */
947 hnd,
948 keyname,
958 }
963 }
966 }
974 {
975 WERROR result;
977 /* enumforms call */
979 hnd,
980 level,
982 num_forms,
983 forms);
987 }
990 }
997 {
998 WERROR result;
1000 /* enumprinterdrivers call */
1003 env,
1004 level,
1006 count,
1007 info);
1015 env);
1016 }
1017 }
1020 }
1027 {
1028 WERROR result;
1032 /* getprinterdriver call */
1034 hnd,
1035 env,
1036 level,
1038 version,
1040 info,
1050 }
1052 }
1055 }
1061 {
1063 WERROR result;
1064 NTSTATUS status;
1081 }
1083 /* addprinterdriver call */
1091 }
1092 /* be more verbose */
1096 }
1100 }
1103 }
1105 /**
1106 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1107 * for a single printer or for all printers depending on argc/argv
1108 **/
1117 {
1120 WERROR werr;
1122 /* no arguments given, enumerate all printers */
1131 }
1133 /* argument given, get a single printer by name */
1135 MAXIMUM_ALLOWED_ACCESS,
1143 }
1148 }
1154 out:
1159 }
1161 /**
1162 * List print-queues (including local printers that are not shared)
1163 *
1164 * All parameters are provided by the run_rpc_command function, except for
1165 * argc, argv which are passed through.
1166 *
1167 * @param c A net_context structure
1168 * @param domain_sid The domain sid aquired from the remote server
1169 * @param cli A cli_state connected to the server.
1170 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1171 * @param argc Standard main() style argc
1172 * @param argv Standard main() style argv. Initial components are already
1173 * stripped
1174 *
1175 * @return Normal NTSTATUS return.
1176 **/
1186 {
1200 /* do some initialization */
1207 }
1208 }
1211 }
1213 /**
1214 * List printer-drivers from a server
1215 *
1216 * All parameters are provided by the run_rpc_command function, except for
1217 * argc, argv which are passed through.
1218 *
1219 * @param c A net_context structure
1220 * @param domain_sid The domain sid aquired from the remote server
1221 * @param cli A cli_state connected to the server.
1222 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1223 * @param argc Standard main() style argc
1224 * @param argv Standard main() style argv. Initial components are already
1225 * stripped
1226 *
1227 * @return Normal NTSTATUS return.
1228 **/
1238 {
1251 /* enum remote drivers */
1257 }
1264 }
1270 /* do something for all drivers for architecture */
1273 }
1274 }
1278 done:
1281 }
1283 /**
1284 * Publish print-queues with args-wrapper
1285 *
1286 * @param cli A cli_state connected to the server.
1287 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1288 * @param argc Standard main() style argc
1289 * @param argv Standard main() style argv. Initial components are already
1290 * stripped
1291 * @param action
1292 *
1293 * @return Normal NTSTATUS return.
1294 **/
1301 {
1313 WERROR result;
1321 /* do some initialization */
1326 }
1328 /* open printer handle */
1333 /* check for existing dst printer */
1337 /* check action and set string */
1352 }
1373 }
1380 }
1383 }
1387 }
1391 done:
1394 }
1397 }
1407 {
1409 }
1419 {
1421 }
1431 {
1433 }
1435 /**
1436 * List print-queues w.r.t. their publishing state
1437 *
1438 * All parameters are provided by the run_rpc_command function, except for
1439 * argc, argv which are passed through.
1440 *
1441 * @param c A net_context structure
1442 * @param domain_sid The domain sid aquired from the remote server
1443 * @param cli A cli_state connected to the server.
1444 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1445 * @param argc Standard main() style argc
1446 * @param argv Standard main() style argv. Initial components are already
1447 * stripped
1448 *
1449 * @return Normal NTSTATUS return.
1450 **/
1460 {
1470 WERROR werr;
1477 /* do some initialization */
1483 }
1485 /* open printer handle */
1490 /* check for existing dst printer */
1496 }
1501 sharename);
1508 sharename);
1512 sharename);
1517 }
1518 }
1522 done:
1525 }
1528 }
1530 /**
1531 * Migrate Printer-ACLs from a source server to the destination server
1532 *
1533 * All parameters are provided by the run_rpc_command function, except for
1534 * argc, argv which are passed through.
1535 *
1536 * @param c A net_context structure
1537 * @param domain_sid The domain sid aquired from the remote server
1538 * @param cli A cli_state connected to the server.
1539 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1540 * @param argc Standard main() style argc
1541 * @param argv Standard main() style argv. Initial components are already
1542 * stripped
1543 *
1544 * @return Normal NTSTATUS return.
1545 **/
1555 {
1557 /* TODO: what now, info2 or info3 ?
1558 convince jerry that we should add clientside setacls level 3 at least
1559 */
1571 WERROR werr;
1575 /* connect destination PI_SPOOLSS */
1580 }
1583 /* enum source printers */
1587 }
1593 }
1595 /* do something for all printers */
1598 /* do some initialization */
1605 }
1607 /* we can reset NT_STATUS here because we do not
1608 get any real NT_STATUS-codes anymore from now on */
1614 /* according to msdn you have specify these access-rights
1615 to see the security descriptor
1616 - READ_CONTROL (DACL)
1617 - ACCESS_SYSTEM_SECURITY (SACL)
1618 */
1620 /* open src printer handle */
1625 /* open dst printer handle */
1630 /* check for existing dst printer */
1634 /* check for existing src printer */
1638 /* Copy Security Descriptor */
1640 /* copy secdesc (info level 2) */
1653 /* close printer handles here */
1656 }
1660 }
1662 }
1666 done:
1670 }
1674 }
1678 }
1680 }
1682 /**
1683 * Migrate printer-forms from a src server to the dst server
1684 *
1685 * All parameters are provided by the run_rpc_command function, except for
1686 * argc, argv which are passed through.
1687 *
1688 * @param c A net_context structure
1689 * @param domain_sid The domain sid aquired from the remote server
1690 * @param cli A cli_state connected to the server.
1691 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1692 * @param argc Standard main() style argc
1693 * @param argv Standard main() style argv. Initial components are already
1694 * stripped
1695 *
1696 * @return Normal NTSTATUS return.
1697 **/
1707 {
1710 WERROR result;
1726 /* connect destination PI_SPOOLSS */
1731 }
1734 /* enum src printers */
1738 }
1744 }
1746 /* do something for all printers */
1749 /* do some initialization */
1756 }
1757 /* we can reset NT_STATUS here because we do not
1758 get any real NT_STATUS-codes anymore from now on */
1765 /* open src printer handle */
1770 /* open dst printer handle */
1775 /* check for existing dst printer */
1779 /* finally migrate forms */
1789 NTSTATUS status;
1791 /* only migrate FORM_PRINTER types, according to jerry
1792 FORM_BUILTIN-types are hard-coded in samba */
1805 /* FIXME: there might be something wrong with samba's
1806 builtin-forms */
1810 info,
1816 }
1821 }
1825 }
1828 /* close printer handles here */
1831 }
1835 }
1836 }
1840 done:
1844 }
1848 }
1852 }
1854 }
1856 /**
1857 * Migrate printer-drivers from a src server to the dst server
1858 *
1859 * All parameters are provided by the run_rpc_command function, except for
1860 * argc, argv which are passed through.
1861 *
1862 * @param c A net_context structure
1863 * @param domain_sid The domain sid aquired from the remote server
1864 * @param cli A cli_state connected to the server.
1865 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1866 * @param argc Standard main() style argc
1867 * @param argv Standard main() style argv. Initial components are already
1868 * stripped
1869 *
1870 * @return Normal NTSTATUS return.
1871 **/
1881 {
1900 WERROR werr;
1908 }
1911 /* open print$-share on the src server */
1922 /* open print$-share on the dst server */
1933 /* enum src printers */
1937 }
1943 }
1946 /* do something for all printers */
1949 /* do some initialization */
1956 }
1958 /* we can reset NT_STATUS here because we do not
1959 get any real NT_STATUS-codes anymore from now on */
1965 /* open dst printer handle */
1970 /* check for existing dst printer */
1975 /* open src printer handle */
1977 MAXIMUM_ALLOWED_ACCESS,
1982 /* in a first step call getdriver for each shared printer (per arch)
1983 to get a list of all files that have to be copied */
1987 /* getdriver src */
1998 /* check arch dir */
2004 /* copy driver-files */
2012 /* adddriver dst */
2016 }
2021 }
2025 printername));
2027 }
2029 /* setdriver dst */
2035 }
2040 /* close dst */
2043 }
2045 /* close src */
2048 }
2049 }
2053 done:
2057 }
2059 /* close src */
2062 }
2066 }
2076 }
2078 /**
2079 * Migrate printer-queues from a src to the dst server
2080 * (requires a working "addprinter command" to be installed for the local smbd)
2081 *
2082 * All parameters are provided by the run_rpc_command function, except for
2083 * argc, argv which are passed through.
2084 *
2085 * @param c A net_context structure
2086 * @param domain_sid The domain sid aquired from the remote server
2087 * @param cli A cli_state connected to the server.
2088 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2089 * @param argc Standard main() style argc
2090 * @param argv Standard main() style argv. Initial components are already
2091 * stripped
2092 *
2093 * @return Normal NTSTATUS return.
2094 **/
2104 {
2106 WERROR result;
2121 /* connect destination PI_SPOOLSS */
2126 }
2129 /* enum printers */
2133 }
2139 }
2141 /* do something for all printers */
2146 /* do some initialization */
2153 }
2154 /* we can reset NT_STATUS here because we do not
2155 get any real NT_STATUS-codes anymore from now on */
2161 /* open dst printer handle */
2166 }
2168 /* check for existing dst printer */
2173 /* close printer handle here - dst only, not got src yet. */
2176 }
2178 }
2180 /* now get again src printer ctr via getprinter,
2181 we first need a handle for that */
2183 /* open src printer handle */
2188 /* getprinter on the src server */
2192 /* copy each src printer to a dst printer 1:1,
2193 maybe some values have to be changed though */
2201 mem_ctx,
2206 printername);
2209 printername);
2212 printername);
2214 }
2216 /* close printer handles here */
2219 }
2223 }
2224 }
2228 done:
2231 }
2235 }
2239 }
2241 }
2243 /**
2244 * Migrate Printer-Settings from a src server to the dst server
2245 * (for this to work, printers and drivers already have to be migrated earlier)
2246 *
2247 * All parameters are provided by the run_rpc_command function, except for
2248 * argc, argv which are passed through.
2249 *
2250 * @param c A net_context structure
2251 * @param domain_sid The domain sid aquired from the remote server
2252 * @param cli A cli_state connected to the server.
2253 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2254 * @param argc Standard main() style argc
2255 * @param argv Standard main() style argv. Initial components are already
2256 * stripped
2257 *
2258 * @return Normal NTSTATUS return.
2259 **/
2269 {
2272 /* FIXME: Here the nightmare begins */
2274 WERROR result;
2291 /* FIXME GD */
2296 /* connect destination PI_SPOOLSS */
2301 }
2304 /* enum src printers */
2308 }
2314 }
2317 /* needed for dns-strings in regkeys */
2322 }
2324 /* do something for all printers */
2332 /* do some initialization */
2339 }
2340 /* we can reset NT_STATUS here because we do not
2341 get any real NT_STATUS-codes anymore from now on */
2348 /* open src printer handle */
2353 /* open dst printer handle */
2358 /* check for existing dst printer */
2364 /* STEP 1: COPY DEVICE-MODE and other
2365 PRINTER_INFO_2-attributes
2366 */
2370 /* why is the port always disconnected when the printer
2371 is correctly installed (incl. driver ???) */
2374 /* check if printer is published */
2377 /* check for existing dst printer */
2383 /* ignore false from setprinter due to WERR_IO_PENDING */
2387 }
2391 /* copy devmode (info level 2) */
2394 /* do not copy security descriptor (we have another
2395 * command for that) */
2398 #if 0
2405 }
2406 #endif
2412 }
2414 /* STEP 2: COPY REGISTRY VALUES */
2416 /* please keep in mind that samba parse_spools gives horribly
2417 crippled results when used to rpccli_spoolss_enumprinterdataex
2418 a win2k3-server. (Bugzilla #1851)
2419 FIXME: IIRC I've seen it too on a win2k-server
2420 */
2432 /* enumerate data on src handle */
2440 /* loop for all printerdata of "PrinterDriverData" */
2447 /* loop for all reg_keys */
2450 /* display_value */
2462 }
2466 }
2468 /* set_value */
2476 }
2477 }
2479 /* STEP 3: COPY SUBKEY VALUES */
2481 /* here we need to enum all printer_keys and then work
2482 on the result with enum_printer_key_ex. nt4 does not
2483 respond to enumprinterkey, win2k does, so continue
2484 in case of an error */
2489 }
2492 /* work on a list of printer keys
2493 each key has to be enumerated to get all required
2494 information. information is then set via setprinterdataex-calls */
2505 /* enumerate all src subkeys */
2510 }
2515 DATA_BLOB blob;
2519 /* although samba replies with sane data in most cases we
2520 should try to avoid writing wrong registry data */
2530 /* although windows uses a multi-sz, we use a sz */
2532 }
2539 }
2541 }
2547 #if 0
2548 /* FIXME: should we really do that ??? */
2552 }
2555 #endif
2556 }
2561 }
2566 }
2570 REG_SZ,
2576 }
2581 /* here we have to set all subkeys on the dst server */
2584 {
2587 }
2602 }
2606 }
2608 /* here we have to set all subkeys on the dst server */
2612 }
2615 }
2620 }
2621 }
2625 /* close printer handles here */
2628 }
2632 }
2633 }
2637 done:
2644 }
2648 }
2652 }
2654 }